test(snapshots): migrate the last blocked snap tests to the PTY suite (#2143)

Migrates the final 10 legacy snap tests, emptying both legacy trees (`packages/cli/snap-tests`, `packages/cli/snap-tests-global`).

Runner additions that unblock them:

- Step env values expand `${NAME}`: `${workspace}` resolves to the step's working directory, any other name to the case env. This expresses the shell forms `VP_HOME="$(pwd)/home"` and `PATH="$(pwd)/bin:$PATH"` used by `command-env-setup-external-vp`, `npm-global-install-custom-prefix-on-path`, and `shim-corepack-enable-install-directory`.
- Programs a case creates under its own root (shims from an isolated `vp env setup`) count as case-owned for resolution, and a per-case `link-node-modules = true` exposes the run-root `node_modules` as the workspace parent-dir `node_modules` like the legacy layout, so `bin-oxlint-wrapper`/`bin-oxfmt-wrapper` address `../node_modules/vite-plus/bin/*` verbatim.
- The `./`-prefix program join no longer leaks a `/./` component into recorded shim targets, and an empty step cwd no longer leaks a trailing separator into `${workspace}`.

Hermeticity fixes over the legacy versions: `shim-npm-downloads-uncached-package-manager-version` sets `seed-runtime = false` (its `rm` of a pinned runtime must not reach the shared seed through the symlink) and pins `.node-version 22.11.0` instead of inheriting the environment default; `command-env-setup-external-vp` drops `VP_BYPASS` (the hermetic PATH has no system node); the custom-prefix case asserts the npm bin as a symlink, which the legacy `test -f` followed silently.

`fingerprint-ignore-test` and `vitest-browser-mode` stay disabled on every platform as in the legacy suite; their fixtures carry the converted steps and record no snapshot until re-enabled.

The legacy CI jobs (`cli-snap-test` matrix, retry script, Renovate ignorePaths for the trees) are removed here too, and the legacy runner exits cleanly when a tree is absent from a fresh checkout, so local `pnpm test` keeps working. Deleting the legacy runner and migrator tooling under `packages/tools` can follow separately.

Closes #2116.

Author: fengmk2

.github/renovate.json

@@ -4,14 +4,7 @@
   "description": "Skip lockfile artifact updates (npm and cargo): they fail in Renovate's clone because vite/ and rolldown/ are gitignored. The renovate-lockfiles workflow regenerates lockfiles on renovate/** pushes; gitIgnoredAuthors keeps Renovate managing branches with its commits.",
   "gitIgnoredAuthors": ["278573678+voidzero-guard[bot]@users.noreply.github.com"],
   "skipArtifactsUpdate": true,
-  "ignorePaths": [
-    "packages/cli/snap-tests/**",
-    "packages/cli/snap-tests-global/**",
-    "packages/cli/snap-tests-todo/**",
-    "bench/fixtures/**",
-    "rolldown/**",
-    "vite/**"
-  ],
+  "ignorePaths": ["bench/fixtures/**", "rolldown/**", "vite/**"],
   "packageRules": [
     {
       "description": "Ignore upstream toolchain npm packages (vendored via sync-remote or bumped by the proactive catalog workflow); everything else stays enabled so security alerts get fixed.",

.github/scripts/retry-failed-snap-tests.sh

@@ -343,7 +343,7 @@ jobs:
   # Cross-compiles the Windows release NAPI binding (vite-plus .node) and CLI
   # binaries (vp.exe, vp-shim.exe, vp-setup.exe) on a fast Linux runner with
   # cargo-xwin, then publishes them as the windows-cli-binaries artifact. The
-  # Windows entries of cli-e2e-test, cli-snap-test, and install-e2e-test-sfw
+  # Windows entries of cli-e2e-test and install-e2e-test-sfw
   # download that artifact instead of each spending ~24 minutes rebuilding the
   # same binaries on slow windows-latest runners whenever build-upstream's
   # NAPI binding cache misses. Release builds are unaffected: they keep
@@ -899,139 +899,6 @@ jobs:
           pnpm bootstrap-cli:ci
           vp --version
 
-  cli-snap-test:
-    name: CLI snap test (${{ matrix.target }}, ${{ matrix.shard }}/${{ matrix.shardTotal }})
-    needs:
-      - download-previous-rolldown-binaries
-      - build-windows-cli
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - os: namespace-profile-linux-x64-default
-            target: x86_64-unknown-linux-gnu
-            shard: 1
-            shardTotal: 3
-          - os: namespace-profile-linux-x64-default
-            target: x86_64-unknown-linux-gnu
-            shard: 2
-            shardTotal: 3
-          - os: namespace-profile-linux-x64-default
-            target: x86_64-unknown-linux-gnu
-            shard: 3
-            shardTotal: 3
-          - os: namespace-profile-mac-default
-            target: aarch64-apple-darwin
-            shard: 1
-            shardTotal: 3
-          - os: namespace-profile-mac-default
-            target: aarch64-apple-darwin
-            shard: 2
-            shardTotal: 3
-          - os: namespace-profile-mac-default
-            target: aarch64-apple-darwin
-            shard: 3
-            shardTotal: 3
-          - os: namespace-profile-windows-4c-8g
-            target: x86_64-pc-windows-msvc
-            shard: 1
-            shardTotal: 3
-          - os: namespace-profile-windows-4c-8g
-            target: x86_64-pc-windows-msvc
-            shard: 2
-            shardTotal: 3
-          - os: namespace-profile-windows-4c-8g
-            target: x86_64-pc-windows-msvc
-            shard: 3
-            shardTotal: 3
-    runs-on: ${{ matrix.os }}
-    steps:
-      - uses: taiki-e/checkout-action@7d1e50e93dc4fb3bba58f85018fadf77898aee8b # v1.4.2
-      - uses: ./.github/actions/clone
-
-      # Dev Drive works on the Namespace Windows runner: setup-dev-drive v4
-      # creates and mounts its ReFS VHD on namespace-profile-windows-4c-8g, and
-      # all three Windows shards pass with this step succeeding (nested
-      # virtualization is available there). Only cli-snapshot-test-windows moved
-      # off Namespace, and for an unrelated reason (Session-0 ConPTY, see there).
-      - name: Setup Dev Drive
-        if: runner.os == 'Windows'
-        uses: samypr100/setup-dev-drive@30f0f98ae5636b2b6501e181dfb3631b9974818d # v4.0.0
-        with:
-          drive-size: 12GB
-          drive-format: ReFS
-          # Route TEMP/TMP onto the Dev Drive (ReFS) so `tmpdir()` from
-          # `packages/tools/src/snap-test.ts` lives on a filesystem that
-          # cleanly resolves pnpm's junction reparse points. NTFS-on-C:
-          # preserves the junction-target backslashes during resolution,
-          # which produces mixed `\` / `/` paths that break Node's ESM
-          # subpath-import walk-up (`#module-sync-enabled` inside
-          # `@voidzero-dev/vite-plus-core` → `ERR_PACKAGE_IMPORT_NOT_DEFINED`
-          # during `vp fmt --write` in the
-          # `new-create-vite-migrates-eslint-prettier` snap test).
-          env-mapping: |
-            TEMP,{{ DEV_DRIVE }}/Temp
-            TMP,{{ DEV_DRIVE }}/Temp
-
-      - name: Create TEMP/TMP on Dev Drive
-        if: runner.os == 'Windows'
-        # `setup-dev-drive` only mounts the drive; it doesn't create the
-        # dir we point TEMP/TMP at. Anything that calls `os.tmpdir()` /
-        # `lstat($TEMP)` before this dir exists fails (e.g. the bootstrap
-        # CLI installer's `lstat 'E:\Temp'` ENOENT).
-        shell: bash
-        run: mkdir -p "$TEMP" "$TMP"
-
-      # Windows runs against the prebuilt binaries from build-windows-cli,
-      # so it needs no Rust toolchain here (the Dev Drive above stays for
-      # the TEMP/TMP routing).
-      - uses: oxc-project/setup-rust@68c3199c5339f965e6e163924c3c450773eba42b # main (pending v1.0.17 — Swatinem/rust-cache v2.9.1 for node24)
-        if: runner.os != 'Windows'
-        with:
-          save-cache: ${{ github.ref_name == 'main' }}
-          cache-key: cli-snap-test-${{ matrix.target }}
-
-      - uses: oxc-project/setup-node@4c588e9266bd930b6ddc34307df0659ed511d187 # v1.3.1
-
-      - name: Install docs dependencies
-        run: pnpm -C docs install --frozen-lockfile
-
-      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
-        with:
-          name: rolldown-binaries
-          path: ./rolldown/packages/rolldown/src
-          merge-multiple: true
-
-      # See the cli-e2e-test job for details on the prebuilt binaries.
-      - name: Download prebuilt Windows binaries
-        if: runner.os == 'Windows'
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
-        with:
-          name: windows-cli-binaries
-
-      - name: Build with upstream
-        uses: ./.github/actions/build-upstream
-        with:
-          target: ${{ matrix.target }}
-          skip-native: ${{ runner.os == 'Windows' }}
-
-      - name: Install Global CLI vp
-        run: |
-          pnpm bootstrap-cli:ci
-          if [[ "$RUNNER_OS" == "Windows" ]]; then
-            echo "$USERPROFILE\.vite-plus\bin" >> $GITHUB_PATH
-          else
-            echo "$HOME/.vite-plus/bin" >> $GITHUB_PATH
-          fi
-
-      - name: Run CLI snapshot tests (shard ${{ matrix.shard }}/${{ matrix.shardTotal }})
-        run: |
-          RUST_BACKTRACE=1 pnpm -F ./packages/cli snap-test-local --shard=${{ matrix.shard }}/${{ matrix.shardTotal }}
-          RUST_BACKTRACE=1 pnpm -F ./packages/cli snap-test-global --shard=${{ matrix.shard }}/${{ matrix.shardTotal }}
-          bash .github/scripts/retry-failed-snap-tests.sh
-        env:
-          RUST_MIN_STACK: 8388608
-
   # Runs the PTY snapshot suite (crates/vite_cli_snapshots) with BOTH vp
   # flavors on Linux and macOS: the local flavor uses the packages/cli build
   # from this job, the global flavor reuses the installed release binary via
@@ -1115,9 +982,12 @@ jobs:
       - uses: taiki-e/checkout-action@7d1e50e93dc4fb3bba58f85018fadf77898aee8b # v1.4.2
       - uses: ./.github/actions/clone
 
-      # Same Dev Drive TEMP routing as cli-snap-test: staged fixture
-      # workspaces live under os.tmpdir() and must resolve pnpm junction
-      # reparse points cleanly (see that job for the full story).
+      # Route TEMP/TMP onto a Dev Drive (ReFS): staged fixture workspaces
+      # live under os.tmpdir() and must resolve pnpm junction reparse points
+      # cleanly. NTFS-on-C: preserves the junction-target backslashes during
+      # resolution, which produces mixed `\` / `/` paths that break Node's
+      # ESM subpath-import walk-up (`#module-sync-enabled` inside
+      # `@voidzero-dev/vite-plus-core` -> `ERR_PACKAGE_IMPORT_NOT_DEFINED`).
       - name: Setup Dev Drive
         uses: samypr100/setup-dev-drive@30f0f98ae5636b2b6501e181dfb3631b9974818d # v4.0.0
         with:
@@ -1267,7 +1137,6 @@ jobs:
 
               git config --global --add safe.directory /workspace
               RUST_BACKTRACE=1 pnpm test
-              bash .github/scripts/retry-failed-snap-tests.sh
             "
 
   install-e2e-test:
@@ -1485,7 +1354,6 @@ jobs:
       - lint
       - cli-e2e-test
       - cli-e2e-test-musl
-      - cli-snap-test
       - cli-snapshot-test
       - cli-snapshot-test-windows
       # Skipped on unlabeled PRs; counted on push-to-main and labeled PRs.

.github/workflows/ci.yml

@@ -145,12 +145,11 @@ jobs:
             ### Final validation (this step is complete ONLY when all pass)
             1. `just build` exits 0.
             2. `pnpm bootstrap-cli:ci && pnpm test` exits 0.
-            3. `git diff` on `packages/cli/snap-tests/**/snap.txt` and
-               `packages/cli/snap-tests-global/**/snap.txt` contains no real regressions.
-               IMPORTANT: `pnpm test` always exits 0 even when snap outputs differ, so you
-               MUST inspect the diff yourself. Cosmetic drift from the upgrade (e.g. a
-               bumped version string in help output) is acceptable; unexpected stack
-               traces, missing output, or diverging CLI behavior are regressions to fix.
+            3. `just snapshot-test` exits 0. Snapshot mismatches fail the run with a
+               unified diff. Re-record with `UPDATE_SNAPSHOTS=1` only for cosmetic
+               drift from the upgrade (e.g. a bumped version string in help output);
+               unexpected stack traces, missing output, or diverging CLI behavior are
+               regressions to fix.
             4. `git status --short` and `git diff --stat` have been inspected, and
                every changed file is intentional for the upgrade PR. Pay special
                attention to generated NAPI binding files, because later CI runs fail

.github/workflows/upgrade-deps.yml

@@ -77,6 +77,9 @@ cwd = "packages/app"          # optional, relative to the fixture root
 skip-platforms = ["windows"]  # or { os = "linux", libc = "musl" }
 ignore = false                # true: only runs with `-- --ignored`
 seed-runtime = true           # false: start from an empty VP_HOME
+link-node-modules = false     # true: expose the run-root node_modules as
+                              #   the workspace's parent-dir node_modules,
+                              #   for `../node_modules/vite-plus/...` paths
 env = { MY_VAR = "1" }        # case-wide env additions
 unset-env = ["SOME_VAR"]      # remove baseline env entries
 steps = [ ... ]
@@ -99,7 +102,11 @@ A step is a bare argv array or a table:
 { argv = ["vp", "create"],
   cwd = "sub",                # per-step working dir
   comment = "...",            # rendered under the step heading
-  envs = [["K", "V"]],        # per-step env
+  envs = [["K", "V"]],        # per-step env; values expand `${NAME}`:
+                              #   `${workspace}` is the step's working dir,
+                              #   any other name resolves from the case env
+                              #   (`PATH = "${workspace}/bin:${PATH}"` is
+                              #   the shell's `PATH="$(pwd)/bin:$PATH"`)
   timeout = 120000,           # ms, default 50s
   snapshot = false,           # omit the screen while the step succeeds
                               #   (failures always keep their output)

crates/vite_cli_snapshots/tests/cli_snapshots/README.md

@@ -0,0 +1,12 @@
+[[case]]
+name = "bin_oxfmt_wrapper"
+vp = "local"
+# The wrapper is addressed by path through the workspace parent, the legacy
+# runner's layout.
+link-node-modules = true
+steps = [
+  { argv = ["node", "../node_modules/vite-plus/bin/oxfmt"], comment = "should reject non-LSP usage", continue-on-failure = true },
+  { argv = ["node", "../node_modules/vite-plus/bin/oxfmt", "--help"], comment = "should reject non-LSP usage", continue-on-failure = true },
+  { argv = ["node", "../node_modules/vite-plus/bin/oxfmt", "--lsp", "--help"], comment = "should allow LSP mode" },
+  { argv = ["node", "../node_modules/vite-plus/bin/oxfmt", "--stdin-filepath=a.ts", "--help"], comment = "should allow Stdin mode" },
+]

…nap-tests/bin-oxfmt-wrapper/package.json …/fixtures/bin_oxfmt_wrapper/package.jsonpackages/cli/snap-tests/bin-oxfmt-wrapper/package.json renamed to crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/bin_oxfmt_wrapper/package.json packages/cli/snap-tests/bin-oxfmt-wrapper/package.json renamed to crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/bin_oxfmt_wrapper/package.json

@@ -1,12 +1,32 @@
-[1]> node ../node_modules/vite-plus/bin/oxfmt # should reject non-LSP usage
+# bin_oxfmt_wrapper
+
+## `node ../node_modules/vite-plus/bin/oxfmt`
+
+should reject non-LSP usage
+
+**Exit code:** 1
+
+```
 This oxfmt wrapper is for IDE extension use only (lsp or stdin mode).
 To format your code, run: vp fmt
+```
+
+## `node ../node_modules/vite-plus/bin/oxfmt --help`
+
+should reject non-LSP usage
 
-[1]> node ../node_modules/vite-plus/bin/oxfmt --help # should reject non-LSP usage
+**Exit code:** 1
+
+```
 This oxfmt wrapper is for IDE extension use only (lsp or stdin mode).
 To format your code, run: vp fmt
+```
+
+## `node ../node_modules/vite-plus/bin/oxfmt --lsp --help`
+
+should allow LSP mode
 
-> node ../node_modules/vite-plus/bin/oxfmt --lsp --help # should allow LSP mode
+```
 Usage: [-c=PATH] [PATH]...
 
 Mode Options:
@@ -45,9 +65,13 @@ Available positional items:
 Available options:
     -h, --help               Prints help information
     -V, --version            Prints version information
+```
 
+## `node ../node_modules/vite-plus/bin/oxfmt --stdin-filepath=a.ts --help`
 
-> node ../node_modules/vite-plus/bin/oxfmt --stdin-filepath=a.ts --help # should allow Stdin mode
+should allow Stdin mode
+
+```
 Usage: [-c=PATH] [PATH]...
 
 Mode Options:
@@ -86,4 +110,4 @@ Available positional items:
 Available options:
     -h, --help               Prints help information
     -V, --version            Prints version information
-
+```

crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/bin_oxfmt_wrapper/snapshots.toml

@@ -0,0 +1,11 @@
+[[case]]
+name = "bin_oxlint_wrapper"
+vp = "local"
+# The wrapper is addressed by path through the workspace parent, the legacy
+# runner's layout.
+link-node-modules = true
+steps = [
+  { argv = ["node", "../node_modules/vite-plus/bin/oxlint"], comment = "should reject non-LSP usage", continue-on-failure = true },
+  { argv = ["node", "../node_modules/vite-plus/bin/oxlint", "--help"], comment = "should reject non-LSP usage", continue-on-failure = true },
+  { argv = ["node", "../node_modules/vite-plus/bin/oxlint", "--lsp", "--help"], comment = "should exercise import path" },
+]