feat(cli): add vp toolchain command

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

@@ -57,6 +57,7 @@ runs:
           packages/cli/binding/index.d.ts
           packages/cli/binding/index.cjs
           packages/cli/binding/index.d.cts
+          packages/cli/binding/vite-plus.build-time
           ${{ steps.rust-target.outputs.dir }}/${{ inputs.target }}/release/vp
           ${{ steps.rust-target.outputs.dir }}/${{ inputs.target }}/release/vp.exe
           ${{ steps.rust-target.outputs.dir }}/${{ inputs.target }}/release/vp-shim.exe
@@ -197,6 +198,7 @@ runs:
           packages/cli/binding/index.d.ts
           packages/cli/binding/index.cjs
           packages/cli/binding/index.d.cts
+          packages/cli/binding/vite-plus.build-time
           ${{ steps.rust-target.outputs.dir }}/${{ inputs.target }}/release/vp
           ${{ steps.rust-target.outputs.dir }}/${{ inputs.target }}/release/vp.exe
           ${{ steps.rust-target.outputs.dir }}/${{ inputs.target }}/release/vp-shim.exe

.github/actions/build-windows-cli/action.yml

@@ -40,6 +40,7 @@ runs:
         {
           echo 'paths<<EOF'
           echo 'packages/cli/binding/*.node'
+          echo 'packages/cli/binding/vite-plus.build-time'
           echo 'target/x86_64-pc-windows-msvc/release/vp.exe'
           echo 'target/x86_64-pc-windows-msvc/release/vp-shim.exe'
           echo 'target/x86_64-pc-windows-msvc/release/vp-setup.exe'

Cargo.toml

@@ -8,10 +8,10 @@
   "css-module-lexer",
   "html5gum",
   "prettyplease",
   "proc-macro2",
   "quote",
   "string_cache",
   "syn",
 ]
 
 [workspace.package]
@@ -298,6 +298,7 @@
 vp_setup = { path = "crates/vp_setup" }
 vp_shared = { path = "crates/vp_shared" }
 vp_static_config = { path = "crates/vp_static_config" }
+vp_toolchain = { path = "crates/vp_toolchain" }
 vt = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "ebe583739b0b1e7828199b9ee9dd52273fa2fd20" }
 vt_path = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "ebe583739b0b1e7828199b9ee9dd52273fa2fd20" }
 vt_powershell = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "ebe583739b0b1e7828199b9ee9dd52273fa2fd20" }

README.md

@@ -23,6 +23,7 @@ Vite+ is the unified entry point for local web development. It combines [Vite](h
 - **`vp build`:** Build applications for production with Vite + Rolldown
 - **`vp run`:** Run `package.json` scripts and monorepo tasks with caching and dependency-aware scheduling
 - **`vp pack`:** Build libraries for npm publishing or standalone app binaries
+- **`vp toolchain`:** Show the versions of Vite+, Vite, Rolldown, Oxc, and other tools
 - **`vp create` / `vp migrate`:** Scaffold new projects and migrate existing ones
 
 All of this is configured from your project root and works across Vite's framework ecosystem.
@@ -145,6 +146,7 @@ Vite+ automatically wraps your package manager (pnpm, npm, Yarn, or Bun) based o
 
 #### Maintain
 
+- **toolchain** - Show Vite+ tool versions and their relationships
 - **upgrade** - Update `vp` itself to the latest version
 - **implode** - Remove `vp` and all related data
 
@@ -195,7 +197,7 @@ If you are manually migrating a project to Vite+, install these dev dependencies
 npm install -D vite-plus @voidzero-dev/vite-plus-core@latest
 ```
 
-You need to add overrides to your package manager so that other packages resolve the Vite+ versions: alias `vite` to `@voidzero-dev/vite-plus-core`, and pin `vitest` to the version Vite+ bundles (run `vp --version`) so the whole project shares a single Vitest copy with `vp test`. Without the `vitest` pin, a dependency or workspace package can pull a different Vitest than the bundled runner, splitting Vitest's internals (mocks, `expect`, runner state):
+Add package-manager overrides so that other packages use the Vite+ versions. Alias `vite` to `@voidzero-dev/vite-plus-core`. Pin `vitest` to the version from `vp toolchain vitest`. The project and `vp test` then use the same Vitest copy. Without the pin, a dependency or workspace package can install a different Vitest version. The two versions can use separate mocks, `expect` functions, and runner states:
 
 ```json
 "overrides": {

crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/cli_helper_message/snapshots/cli_helper_message.md

@@ -50,6 +50,9 @@ Manage Dependencies:
   rebuild                    Rebuild native modules
   pm                         Forward a command to the package manager
 
+Inspect:
+  toolchain  Show active Vite+ tools, versions, and relationships
+
 Maintain:
   upgrade  Update vp itself to the latest version
   implode  Remove vp and all related data

crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/cli_helper_message/snapshots/cli_helper_message_local.md

@@ -25,6 +25,7 @@ Core Commands:
   cache          Manage the task cache
   config         Configure hooks and agent integration
   staged         Run linters on staged files
+  toolchain      Show Vite+ tool versions and relationships
 
 Package Manager Commands:
   install    Install all dependencies, or add packages if package names are provided

crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_helper/snapshots/command_helper.md

@@ -25,6 +25,7 @@ Core Commands:
   cache          Manage the task cache
   config         Configure hooks and agent integration
   staged         Run linters on staged files
+  toolchain      Show Vite+ tool versions and relationships
 
 Package Manager Commands:
   install    Install all dependencies, or add packages if package names are provided

crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_toolchain/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "command-toolchain",
+  "version": "1.0.0",
+  "private": true,
+  "packageManager": "pnpm@11.0.6"
+}

crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_toolchain/snapshots.toml

@@ -0,0 +1,61 @@
+[[case]]
+name = "toolchain_full_local"
+vp = "local"
+comment = "The local CLI reads the manifest shipped in its vite-plus package."
+steps = [["vp", "toolchain"]]
+
+[[case]]
+name = "toolchain_full_global"
+vp = "global"
+comment = "The global flag reads the manifest paired with the global binary."
+steps = [["vp", "toolchain", "--global"]]
+
+[[case]]
+name = "toolchain_filters"
+vp = "local"
+steps = [
+  { argv = ["vp", "toolchain", "vite"], comment = "a tool filter keeps its ownership and engine chain" },
+  { argv = ["vp", "toolchain", "vite", "vitest"], comment = "multiple filters return a stable union" },
+  { argv = ["vp", "toolchain", "vite-plus-core", "tsgolint", "vite-task"], comment = "stable IDs and declared aliases resolve" },
+]
+
+[[case]]
+name = "toolchain_json"
+vp = "global"
+steps = [
+  { argv = ["vp", "toolchain", "vite", "--json", "--global"], tty = false, comment = "JSON contains one node per ID and no CLI header" },
+]
+
+[[case]]
+name = "toolchain_unknown"
+vp = "local"
+steps = [
+  { argv = ["vp", "toolchain", "rollup"], comment = "readable output points to the package graph", continue-on-failure = true },
+  { argv = ["vp", "toolchain", "rollup", "--json"], tty = false, comment = "JSON output does not include the readable hint", continue-on-failure = true },
+]
+
+[[case]]
+name = "toolchain_global_from_local_cli"
+vp = "local"
+steps = [
+  { argv = ["vp", "toolchain", "--global"], comment = "the local package leaves global selection to the global vp binary", continue-on-failure = true },
+]
+
+[[case]]
+name = "toolchain_old_local_routing"
+vp = "global"
+steps = [
+  { argv = ["vpt", "mkdir", "-p", "node_modules/vite-plus/dist"], snapshot = false },
+  { argv = ["vpt", "write-file", "node_modules/vite-plus/package.json", "{\"name\":\"vite-plus\",\"version\":\"0.1.0\"}\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "node_modules/vite-plus/dist/bin.js", "console.error(\"error: Command 'toolchain' not found\");\nprocess.exitCode = 2;\n"], snapshot = false },
+  { argv = ["vp", "toolchain"], timeout = 120000, comment = "the global binary delegates and lets an old local CLI reject the command", continue-on-failure = true },
+  { argv = ["vp", "toolchain", "--global"], comment = "--global skips the old local package" },
+]
+
+[[case]]
+name = "toolchain_why_hint"
+vp = ["local", "global"]
+steps = [
+  { argv = ["vp", "why", "vite"], timeout = 120000, comment = "readable vp why output shows the toolchain hint" },
+  { argv = ["vp", "why", "vite", "--json"], tty = false, timeout = 120000, comment = "JSON package output does not include the hint" },
+]

crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_toolchain/snapshots/toolchain_filters.md

@@ -0,0 +1,45 @@
+# toolchain_filters
+
+## `vp toolchain vite`
+
+a tool filter keeps its ownership and engine chain
+
+```
+Vite+ toolchain (local)
+
+vite-plus@0.2.8
+`-- depends on @voidzero-dev/vite-plus-core@<version>
+    `-- bundles vite@8.2.0
+        `-- uses rolldown@1.2.2
+            |-- compiles oxc@0.142.0
+            `-- compiles oxc-resolver@11.24.2
+```
+
+## `vp toolchain vite vitest`
+
+multiple filters return a stable union
+
+```
+Vite+ toolchain (local)
+
+vite-plus@0.2.8
+|-- depends on @voidzero-dev/vite-plus-core@<version>
+|   `-- bundles vite@8.2.0
+|       `-- uses rolldown@1.2.2
+|           |-- compiles oxc@0.142.0
+|           `-- compiles oxc-resolver@11.24.2
+`-- depends on vitest@4.1.10
+```
+
+## `vp toolchain vite-plus-core tsgolint vite-task`
+
+stable IDs and declared aliases resolve
+
+```
+Vite+ toolchain (local)
+
+vite-plus@0.2.8
+|-- depends on @voidzero-dev/vite-plus-core@<version>
+|-- depends on oxlint-tsgolint@7.0.2001
+`-- compiles vite-task (built <build-time>, revision ebe583739b0b1e7828199b9ee9dd52273fa2fd20)
+```

crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_toolchain/snapshots/toolchain_full_global.md

@@ -0,0 +1,25 @@
+# toolchain_full_global
+
+The global flag reads the manifest paired with the global binary.
+
+## `vp toolchain --global`
+
+```
+Vite+ toolchain (global)
+
+vite-plus@0.2.8
+|-- depends on @voidzero-dev/vite-plus-core@<version>
+|   |-- bundles vite@8.2.0
+|   |   `-- uses rolldown@1.2.2
+|   |       |-- compiles oxc@0.142.0
+|   |       `-- compiles oxc-resolver@11.24.2
+|   |-- bundles rolldown@1.2.2
+|   |   |-- compiles oxc@0.142.0
+|   |   `-- compiles oxc-resolver@11.24.2
+|   `-- bundles tsdown@0.22.14
+|-- depends on vitest@4.1.10
+|-- depends on oxlint@1.76.0
+|-- depends on oxlint-tsgolint@7.0.2001
+|-- depends on oxfmt@0.61.0
+`-- compiles vite-task (built <build-time>, revision ebe583739b0b1e7828199b9ee9dd52273fa2fd20)
+```

crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_toolchain/snapshots/toolchain_full_local.md

@@ -0,0 +1,25 @@
+# toolchain_full_local
+
+The local CLI reads the manifest shipped in its vite-plus package.
+
+## `vp toolchain`
+
+```
+Vite+ toolchain (local)
+
+vite-plus@0.2.8
+|-- depends on @voidzero-dev/vite-plus-core@<version>
+|   |-- bundles vite@8.2.0
+|   |   `-- uses rolldown@1.2.2
+|   |       |-- compiles oxc@0.142.0
+|   |       `-- compiles oxc-resolver@11.24.2
+|   |-- bundles rolldown@1.2.2
+|   |   |-- compiles oxc@0.142.0
+|   |   `-- compiles oxc-resolver@11.24.2
+|   `-- bundles tsdown@0.22.14
+|-- depends on vitest@4.1.10
+|-- depends on oxlint@1.76.0
+|-- depends on oxlint-tsgolint@7.0.2001
+|-- depends on oxfmt@0.61.0
+`-- compiles vite-task (built <build-time>, revision ebe583739b0b1e7828199b9ee9dd52273fa2fd20)
+```

crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_toolchain/snapshots/toolchain_global_from_local_cli.md

@@ -0,0 +1,11 @@
+# toolchain_global_from_local_cli
+
+## `vp toolchain --global`
+
+the local package leaves global selection to the global vp binary
+
+**Exit code:** 1
+
+```
+error: The `--global` option requires the global `vp` CLI
+```