feat(vp): refactor global cli to rust entry point (#514)

The binary can now be used as a drop-in replacement for the Node.js
global CLI for package manager operations.

Verification Tests

- [x] [install.sh](http://install.sh)
- [x] install.ps1
- [x] e2e

Author: fengmk2

.claude/skills/add-ecosystem-ci/SKILL.md

@@ -41,7 +41,7 @@ Look for common patterns in workflow files:
 
 - `pnpm run <command>` / `npm run <command>` / `yarn <command>`
 - Commands like: `lint`, `build`, `test`, `type-check`, `typecheck`, `format`, `format:check`
-- Map detected commands to vite equivalents: `vite run lint`, `vite run build`, etc.
+- Map detected commands to `vp` equivalents: `vp run lint`, `vp run build`, etc.
 
 ### 2.3 Ask User to Confirm
 
@@ -73,8 +73,8 @@ Present the auto-detected configuration and ask user to confirm or modify:
      node-version: 24
      directory: web # only if subdirectory is needed
      command: |
-       vite run lint
-       vite run build
+       vp run lint
+       vp run build
    ```
 
 ## Step 4: Verify
@@ -109,5 +109,5 @@ node ecosystem-ci/clone.ts project-name
 
 - The `directory` field is optional - only add it if the package.json is not in the project root
 - If `directory` is specified in repo.json, it must also be specified in the workflow matrix
-- `patch-project.ts` automatically handles running `vite migrate` in the correct directory
+- `patch-project.ts` automatically handles running `vp migrate` in the correct directory
 - OS exclusions are added to the existing `exclude` section in the workflow matrix

.github/actions/build-upstream/action.yml

@@ -4,9 +4,6 @@ inputs:
   target:
     description: 'The target platform'
     required: true
-  print-after-build:
-    description: 'Print the output after the build'
-    required: false
 
 runs:
   using: 'composite'
@@ -24,9 +21,9 @@ runs:
       id: cache-key
       shell: bash
       run: |
-        echo "key=napi-binding-v1-${{ inputs.target }}-${{ env.RELEASE_BUILD }}-${{ env.DEBUG }}-${{ env.VERSION }}-${{ hashFiles('packages/tools/.upstream-versions.json', 'Cargo.lock', 'crates/**/*.rs', 'crates/*/Cargo.toml', 'packages/*/binding/**/*.rs', 'packages/*/binding/Cargo.toml', 'Cargo.toml', '.cargo/config.toml', 'packages/cli/package.json', 'packages/cli/build.ts', 'packages/global/package.json', 'packages/global/build.ts') }}" >> $GITHUB_OUTPUT
+        echo "key=napi-binding-v2-${{ inputs.target }}-${{ env.RELEASE_BUILD }}-${{ env.DEBUG }}-${{ env.VERSION }}-${{ env.NPM_TAG }}-${{ hashFiles('packages/tools/.upstream-versions.json', 'Cargo.lock', 'crates/**/*.rs', 'crates/*/Cargo.toml', 'packages/*/binding/**/*.rs', 'packages/*/binding/Cargo.toml', 'Cargo.toml', '.cargo/config.toml', 'packages/cli/package.json', 'packages/cli/build.ts', 'packages/global/package.json', 'packages/global/build.ts') }}" >> $GITHUB_OUTPUT
 
-    # Cache only NAPI bindings (the slow part, especially on Windows)
+    # Cache NAPI bindings and Rust CLI binary (the slow parts, especially on Windows)
     - name: Restore NAPI binding cache
       id: cache-restore
       uses: actions/cache/restore@94b89442628ad1d101e352b7ee38f30e1bef108e # v5
@@ -40,6 +37,8 @@ runs:
           packages/global/binding/*.node
           packages/global/binding/index.js
           packages/global/binding/index.d.ts
+          target/${{ inputs.target }}/release/vp
+          target/${{ inputs.target }}/release/vp.exe
         key: ${{ steps.cache-key.outputs.key }}
 
     # Build upstream TypeScript packages first (don't depend on native bindings)
@@ -56,7 +55,7 @@ runs:
 
     # NAPI builds - only run on cache miss (slow, especially on Windows)
     # Must run before vite-plus/vite-plus-cli TypeScript builds which depend on the bindings
-    - name: Build NAPI bindings
+    - name: Build NAPI bindings (x86_64-linux)
       shell: bash
       if: steps.cache-restore.outputs.cache-hit != 'true' && inputs.target == 'x86_64-unknown-linux-gnu'
       run: |
@@ -66,17 +65,18 @@ runs:
         TARGET_CC: clang
         DEBUG: napi:*
 
-    - name: Build NAPI bindings
+    - name: Build NAPI bindings (aarch64-linux)
       shell: bash
       if: steps.cache-restore.outputs.cache-hit != 'true' && inputs.target == 'aarch64-unknown-linux-gnu'
       run: |
-        TARGET_CFLAGS="-D_BSD_SOURCE" pnpm --filter=vite-plus build-native --target ${{ inputs.target }} --use-napi-cross
-        TARGET_CFLAGS="-D_BSD_SOURCE" pnpm --filter=vite-plus-cli build-native --target ${{ inputs.target }} --use-napi-cross
+        pnpm --filter=vite-plus build-native --target ${{ inputs.target }} --use-napi-cross
+        pnpm --filter=vite-plus-cli build-native --target ${{ inputs.target }} --use-napi-cross
       env:
         TARGET_CC: clang
+        TARGET_CFLAGS: '-D_BSD_SOURCE'
         DEBUG: napi:*
 
-    - name: Build NAPI bindings
+    - name: Build NAPI bindings (non-Linux targets)
       shell: bash
       if: steps.cache-restore.outputs.cache-hit != 'true' && !contains(inputs.target, 'linux')
       run: |
@@ -85,16 +85,29 @@ runs:
       env:
         DEBUG: napi:*
 
-    - name: Print output after build
+    - name: Build Rust CLI binary (x86_64-linux)
+      if: steps.cache-restore.outputs.cache-hit != 'true' && inputs.target == 'x86_64-unknown-linux-gnu'
       shell: bash
-      if: inputs.print-after-build == 'true'
       run: |
-        pnpm vite -h
-        pnpm vite run -h
-        pnpm vite lint -h
-        pnpm vite test -h
-        pnpm vite build -h
-        pnpm vite fmt -h
+        pnpm exec napi build --use-napi-cross --target ${{ inputs.target }} --release -p vite_global_cli
+      env:
+        TARGET_CC: clang
+        DEBUG: napi:*
+
+    - name: Build Rust CLI binary (aarch64-linux)
+      if: steps.cache-restore.outputs.cache-hit != 'true' && inputs.target == 'aarch64-unknown-linux-gnu'
+      shell: bash
+      run: |
+        pnpm exec napi build --use-napi-cross --target ${{ inputs.target }} --release -p vite_global_cli
+      env:
+        TARGET_CC: clang
+        TARGET_CFLAGS: '-D_BSD_SOURCE'
+        DEBUG: napi:*
+
+    - name: Build Rust CLI binary (non-Linux targets)
+      if: steps.cache-restore.outputs.cache-hit != 'true' && !contains(inputs.target, 'linux')
+      shell: bash
+      run: cargo build --release --target ${{ inputs.target }} -p vite_global_cli
 
     - name: Save NAPI binding cache
       if: steps.cache-restore.outputs.cache-hit != 'true'
@@ -109,4 +122,34 @@ runs:
           packages/global/binding/*.node
           packages/global/binding/index.js
           packages/global/binding/index.d.ts
+          target/${{ inputs.target }}/release/vp
+          target/${{ inputs.target }}/release/vp.exe
         key: ${{ steps.cache-key.outputs.key }}
+
+    # Copy Rust CLI binary to packages/global/bin/ (runs on both cache hit and miss)
+    - name: Copy Rust CLI binary
+      shell: bash
+      run: |
+        if [[ "${{ inputs.target }}" == *"windows"* ]]; then
+          cp target/${{ inputs.target }}/release/vp.exe packages/global/bin/vp.exe
+        else
+          cp target/${{ inputs.target }}/release/vp packages/global/bin/vp
+        fi
+
+    # Build vite-plus TypeScript after native bindings are ready
+    - name: Build vite-plus TypeScript packages
+      shell: bash
+      run: |
+        pnpm --filter=vite-plus build-ts
+        pnpm --filter=vite-plus-cli build-ts
+
+    - name: Print output after build
+      shell: bash
+      if: inputs.print-after-build == 'true'
+      run: |
+        pnpm vite -h
+        pnpm vite run -h
+        pnpm vite lint -h
+        pnpm vite test -h
+        pnpm vite build -h
+        pnpm vite fmt -h

.github/workflows/ci.yml

@@ -67,7 +67,8 @@ jobs:
         env:
           RUSTFLAGS: '-D warnings --cfg tokio_unstable' # also update .cargo/config.toml
 
-      - run: cargo test -p vite_command -p vite_install -p vite_migration
+      # Test all crates/* packages. New crates are automatically included.
+      - run: cargo test $(for d in crates/*/; do echo -n "-p $(basename $d) "; done)
 
   lint:
     name: Lint
@@ -136,13 +137,13 @@ jobs:
 
       - name: Print help for built-in commands
         run: |
-          which vite
-          vite -h
-          vite run -h
-          vite lint -h
-          vite test -h
-          vite build -h
-          vite fmt -h
+          which vp
+          vp -h
+          vp run -h
+          vp lint -h
+          vp test -h
+          vp build -h
+          vp fmt -h
 
   cli-e2e-test:
     name: CLI E2E test
@@ -194,31 +195,33 @@ jobs:
       - name: Build CLI
         run: |
           pnpm bootstrap-cli:ci
-          which vite
-          vite --version
-          vite -h
+          which vp
+          vp --version
+          vp -h
+
+      - name: Check CLI JS execution on Windows rust binary
+        if: ${{ matrix.os == 'windows-latest' }}
+        run: |
+          ls -al packages/global/bin
+          VITE_LOG=trace ./packages/global/bin/vp.exe -V
+          VITE_LOG=trace ./packages/global/bin/vp.exe pm cache dir
 
       - name: Run CLI fmt
-        run: vite fmt --check
+        run: vp fmt --check
 
       - name: Run CLI lint
-        run: vite run lint
+        run: vp run lint
 
       - name: Install Playwright browsers
         run: pnpx playwright install chromium
 
-      - name: Create vite.cmd shim file for Windows
-        if: ${{ matrix.os == 'windows-latest' }}
-        run: |
-          printf '@echo off\nnode "%%~dp0vite" %%*\n' > packages/global/bin/vite.cmd
-
       - name: Run CLI snapshot tests
         run: |
           RUST_BACKTRACE=1 pnpm test
           git diff --exit-code
 
   install-e2e-test:
-    name: vite install E2E test
+    name: Local CLI `vite install` E2E test
     needs:
       - download-previous-rolldown-binaries
     runs-on: ubuntu-latest
@@ -254,7 +257,7 @@ jobs:
       - name: Build CLI
         run: pnpm bootstrap-cli:ci
 
-      - name: Run local CLI vite install
+      - name: Run local CLI `vite install`
         run: |
           export PATH=$PWD/node_modules/.bin:$PATH
           vite -h