Merge branch 'main' into docs/fix-migration-doc-anchors

Author: fengmk2

packages/cli/install.ps1

@@ -316,13 +316,23 @@ function Main {
     } | ConvertTo-Json -Depth 10
     Set-Content -Path (Join-Path $VersionDir "package.json") -Value $wrapperJson
 
+    # Isolate from user's global package manager config that may block
+    # installing recently-published packages (e.g. pnpm's minimumReleaseAge,
+    # npm's min-release-age) by creating a local .npmrc in the version directory.
+    Set-Content -Path (Join-Path $VersionDir ".npmrc") -Value "minimum-release-age=0`nmin-release-age=0"
+
     # Install production dependencies (skip if VITE_PLUS_SKIP_DEPS_INSTALL is set,
     # e.g. during local dev where install-global-cli.ts handles deps separately)
     if (-not $env:VITE_PLUS_SKIP_DEPS_INSTALL) {
+        $installLog = Join-Path $VersionDir "install.log"
         Push-Location $VersionDir
         try {
             $env:CI = "true"
-            & "$BinDir\vp.exe" install --silent
+            & "$BinDir\vp.exe" install --silent *> $installLog
+            if ($LASTEXITCODE -ne 0) {
+                Write-Host "error: Failed to install dependencies. See log for details: $installLog" -ForegroundColor Red
+                exit 1
+            }
         } finally {
             Pop-Location
         }

packages/cli/install.sh

@@ -141,22 +141,40 @@ curl_with_error_handling() {
 
 # Detect libc type on Linux (gnu or musl)
 detect_libc() {
-  # Check for musl dynamic linker (most reliable method)
-  if [ -e /lib/ld-musl-x86_64.so.1 ] || [ -e /lib/ld-musl-aarch64.so.1 ]; then
-    echo "musl"
-    return
+  # Prefer positive glibc detection first.
+  # This avoids false musl detection on systems where musl is installed
+  # but the distro itself is glibc-based (common on WSL/Ubuntu).
+  if command -v getconf &> /dev/null; then
+    if getconf GNU_LIBC_VERSION > /dev/null 2>&1; then
+      echo "gnu"
+      return
+    fi
   fi
 
-  # Check if ldd exists and is musl-based
+  # Check ldd output for musl/glibc
   if command -v ldd &> /dev/null; then
-    if ldd --version 2>&1 | grep -qi musl; then
+    ldd_out="$(ldd --version 2>&1 || true)"
+    if echo "$ldd_out" | grep -qi musl; then
       echo "musl"
       return
     fi
+    if echo "$ldd_out" | grep -qi 'gnu libc'; then
+      echo "gnu"
+      return
+    fi
+    if echo "$ldd_out" | grep -qi 'glibc'; then
+      echo "gnu"
+      return
+    fi
   fi
 
-  # Default to gnu (glibc)
-  echo "gnu"
+  # Final fallback: musl loader present usually indicates musl-based distro,
+  # but only check this after glibc detection to avoid false positives.
+  if [ -e /lib/ld-musl-x86_64.so.1 ] || [ -e /lib/ld-musl-aarch64.so.1 ]; then
+    echo "musl"
+  else
+    echo "gnu"
+  fi
 }
 
 # Detect platform
@@ -574,10 +592,22 @@ main() {
 }
 WRAPPER_EOF
 
+  # Isolate from user's global package manager config that may block
+  # installing recently-published packages (e.g. pnpm's minimumReleaseAge,
+  # npm's min-release-age) by creating a local .npmrc in the version directory.
+  cat > "$VERSION_DIR/.npmrc" <<NPMRC_EOF
+minimum-release-age=0
+min-release-age=0
+NPMRC_EOF
+
   # Install production dependencies (skip if VITE_PLUS_SKIP_DEPS_INSTALL is set,
   # e.g. during local dev where install-global-cli.ts handles deps separately)
   if [ -z "${VITE_PLUS_SKIP_DEPS_INSTALL:-}" ]; then
-    (cd "$VERSION_DIR" && CI=true "$BIN_DIR/vp" install --silent)
+    local install_log="$VERSION_DIR/install.log"
+    if ! (cd "$VERSION_DIR" && CI=true "$BIN_DIR/vp" install --silent > "$install_log" 2>&1); then
+      error "Failed to install dependencies. See log for details: $install_log"
+      exit 1
+    fi
   fi
 
   # Create/update current symlink (use relative path for portability)