diff --git a/.claude/skills/release-manager/SKILL.md b/.claude/skills/release-manager/SKILL.md
index 56adb95b50..80898a016f 100644
--- a/.claude/skills/release-manager/SKILL.md
+++ b/.claude/skills/release-manager/SKILL.md
@@ -19,6 +19,7 @@ Run a standard vite-plus release from version bump to published announcement. An
 When given a release PR (URL or number), do not start from step 1. First audit the release's current state, then continue from the earliest unfinished step:
 
 - Is the binding version synced? (step 2: `grep -c "'<prev>'" packages/cli/binding/index.cjs` on the release branch)
+- Do the release version examples in `docs/guide/migrate.md`, including its Copy Prompt, match `packages/cli/package.json`? (step 2)
 - Is the PR description still the `prepare_release` boilerplate, or already a categorized changelog? (step 3)
 - Is a preview build present and for the current head? (step 4)
 - Does `main` have commits the release branch lacks? (`git log origin/release/vX.Y.Z..origin/main`, step 5)
@@ -32,7 +33,7 @@ Before post-release work, fetch `origin/main` and read its copy of this skill (`
 ## Pipeline overview
 
 1. `Prepare Release` workflow bumps versions and opens the release PR (`release/vX.Y.Z` -> `main`).
-2. Release manager: sync `binding/index.cjs`, write the changelog PR description, offer the preview-build smoke test (recommend it when the release has more than 10 commits since the previous tag), get CI green.
+2. Release manager: sync `binding/index.cjs` and the migration guide's release version, write the changelog PR description, offer the preview-build smoke test (recommend it when the release has more than 10 commits since the previous tag), get CI green.
 3. Merging the PR pushes a `packages/cli/package.json` change to `main`, which triggers `release.yml`: build, manual approval gate, npm publish, GitHub release, Docker image, Discord notification.
 4. Release manager: polish the GitHub release notes, verify installs, announce.
 
@@ -46,7 +47,9 @@ gh workflow run prepare_release.yml --repo voidzero-dev/vite-plus -f version=X.Y
 
 The workflow bumps `packages/cli/package.json`, `packages/core/package.json`, `packages/cli/binding/Cargo.toml`, and `crates/vp_global_cli/Cargo.toml`, refreshes `Cargo.lock`, and opens a PR titled `release: vX.Y.Z` from branch `release/vX.Y.Z`. The PR body ends with `Merging this PR will trigger the release workflow.` and that line must survive every later edit.
 
-## 2. Sync the NAPI binding version (required every release)
+## 2. Sync release versions (required every release)
+
+### NAPI binding
 
 NAPI bakes the package version into version checks in `packages/cli/binding/index.cjs` (26+ sites). `prepare_release` bumps `package.json` but does not regenerate this file, so CI's `Ensure no unexpected file changes after build` step in the `CLI E2E test` job fails until it is synced. Do this immediately; do not wait for CI to fail.
 
@@ -79,7 +82,15 @@ regenerate this file, so the CI build's regeneration step produces a
 diff that the post-build no-unexpected-changes guard rejects.
 ```
 
-This is the only kind of commit that goes directly on the release branch. Everything else goes through `main` (see step 5).
+### Migration guide
+
+Use the version in the release branch's `packages/cli/package.json` as the target release version in `docs/guide/migrate.md`. Update the `--package=vite-plus@<curr>` pins in the pnpm and npm command examples, the `upgradePrompt` text used by Copy Prompt, and the surrounding prose that names that exact release. Keep an exact version; do not replace it with a major range or `latest`.
+
+Preserve historical versions such as the migration's source version and the release that introduced a breaking change. Leave Node.js requirements, bundled tool versions, and preview-registry instructions unchanged unless their requirements change.
+
+Commit the guide update on the release branch with the binding sync or in a separate release-version sync commit. Recheck both files after a target-version change or a merge from `main`. Before merging, confirm that the guide and Copy Prompt use the target release in both package-manager commands and their matching prose, then run `git diff --check`.
+
+Only these release-version sync commits go directly on the release branch. Everything else goes through `main` (see step 5).
 
 ## 3. Write the release PR description
 
@@ -326,7 +337,7 @@ Two fork-CI blockers are worth fixing rather than reporting, both on the **test
 
 Match checks to the current PR head and the latest applicable workflow runs. Superseded canceled runs can leave failed aggregate checks in the PR rollup. Check required statuses with `gh pr checks <PR#> --required`, and report required reviewer approval separately from technical CI readiness.
 
-Fixes for CI failures go through a **separate PR to `main`**, never as commits on the release branch (the binding sync in step 2 is the sole exception). After the fix PR merges:
+Fixes for CI failures go through a **separate PR to `main`**, never as commits on the release branch (the release-version syncs in step 2 are the exceptions). After the fix PR merges:
 
 ```bash
 git checkout release/vX.Y.Z && git merge origin/main --no-edit && git push origin release/vX.Y.Z
@@ -341,7 +352,7 @@ Known release-branch-only failure modes:
 
 ## 6. Merge
 
-Merging the release PR is the release trigger. Before merging confirm: CI green, changelog validated, binding synced, and (if used) the preview build verified.
+Merging the release PR is the release trigger. Before merging confirm: CI green, changelog validated, binding and migration guide versions synced, and (if used) the preview build verified.
 
 Auto-merge being enabled is not a completed merge. Confirm `mergedAt` and the merge commit, then follow the Release run for that commit; older successful runs can have skipped publishing because the version did not change.
 
@@ -492,6 +503,7 @@ After the release ships and announcements are approved or confirmed complete, re
 
 - [ ] `prepare_release` run for the target version; release PR open
 - [ ] `binding/index.cjs` synced on the release branch (step 2 commit message shape)
+- [ ] `docs/guide/migrate.md` command examples, Copy Prompt, and matching release prose use the exact target version from `packages/cli/package.json`
 - [ ] PR description written from the head branch data; every PR exactly once except documented omissions; breaking changes in their own section above Highlights; no em/en dashes; closing boilerplate intact
 - [ ] Dependency-upgrade PRs consolidated; vite-task bump expanded with upstream credits; security advisories linked
 - [ ] Smoke test offered to the release manager at both levels (local sweep and fork-PR CI), with the commit count stated and a recommendation to run it when that count is above 10; if accepted, forks synced to upstream first, preview build published, and the full ecosystem-ci catalog verified via `test-pkg-pr-new-migrate` (following TESTING.md), with every failure triaged and regressions ruled out against the previous release
diff --git a/.github/actions/clone/action.yml b/.github/actions/clone/action.yml
index ac291fc82a..6db8238f68 100644
--- a/.github/actions/clone/action.yml
+++ b/.github/actions/clone/action.yml
@@ -47,6 +47,13 @@ runs:
         ref: ${{ steps.upstream-versions.outputs.ROLLDOWN_VITE_HASH }}
         persist-credentials: false
 
+    # Match the manifests used by sync-remote when it generated the root lockfile.
+    # setup-node installs with --frozen-lockfile, so this must run before it.
+    # The runner's preinstalled Node may not support direct TypeScript execution.
+    - name: Align vendored Vite's Vitest dependencies
+      shell: bash
+      run: npx tsx packages/tools/src/vendored-vitest.ts
+
     # Disable autocrlf to preserve LF line endings on Windows
     # This prevents prettier/eslint from failing with "Delete ␍" errors
     - name: Configure git for LF line endings
diff --git a/.github/scripts/__tests__/docs-fork-preview.mjs b/.github/scripts/__tests__/docs-fork-preview.mjs
index 51711c6d86..59b2263b84 100644
--- a/.github/scripts/__tests__/docs-fork-preview.mjs
+++ b/.github/scripts/__tests__/docs-fork-preview.mjs
@@ -6,6 +6,7 @@ import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { test } from 'node:test';
 
+import { resolveDocsSiteOrigin } from '../../../docs/.vitepress/site-origin.ts';
 import {
   authorizePreview,
   commentPreview,
@@ -241,12 +242,75 @@ await test('reuses the PR origin across commits, builds, and reruns while pinnin
   assert.match(deploy, /--preview-alias "\$PREVIEW_ALIAS"/);
 });
 
-await test('uses each PR origin for shell and PowerShell installer links', async (t) => {
+await test('resolves Workers branch origins without an explicit docs origin', () => {
+  for (const branch of ['rfc/vitest-v5-upgrade', '--RFC//Vitest_V5-Upgrade--']) {
+    assert.equal(
+      resolveDocsSiteOrigin({ WORKERS_CI: '1', WORKERS_CI_BRANCH: branch }),
+      'https://rfc-vitest-v5-upgrade-viteplus-dev.voidzero-docs.workers.dev',
+    );
+  }
+});
+
+await test('preserves explicit origins and production defaults', () => {
+  assert.equal(
+    resolveDocsSiteOrigin({
+      DOCS_SITE_ORIGIN: 'https://viteplus-staging.void.app/',
+      WORKERS_CI: '1',
+      WORKERS_CI_BRANCH: 'rfc/vitest-v5-upgrade',
+    }),
+    'https://viteplus-staging.void.app',
+  );
+  for (const env of [
+    {},
+    { DOCS_SITE_ORIGIN: '' },
+    { WORKERS_CI_BRANCH: 'rfc/vitest-v5-upgrade' },
+    { WORKERS_CI: '1' },
+    { WORKERS_CI: '1', WORKERS_CI_BRANCH: 'main' },
+  ]) {
+    assert.equal(resolveDocsSiteOrigin(env), undefined);
+  }
+});
+
+await test('matches Wrangler long-branch aliases without collisions after truncation', () => {
+  for (const [branch, hash] of [
+    [`feature/${'a'.repeat(80)}`, '288d'],
+    [`feature/${'a'.repeat(79)}b`, 'ee30'],
+  ]) {
+    const origin = resolveDocsSiteOrigin({ WORKERS_CI: '1', WORKERS_CI_BRANCH: branch });
+    assert.equal(
+      origin,
+      `https://feature-${'a'.repeat(37)}-${hash}-viteplus-dev.voidzero-docs.workers.dev`,
+    );
+    assert.equal(new URL(origin).hostname.split('.')[0].length, 63);
+  }
+});
+
+await test('requires an explicit origin when Wrangler cannot create a branch alias', () => {
+  for (const branch of ['123-fix', '___']) {
+    const env = { WORKERS_CI: '1', WORKERS_CI_BRANCH: branch };
+    assert.throws(() => resolveDocsSiteOrigin(env), /Set DOCS_SITE_ORIGIN/);
+    assert.equal(
+      resolveDocsSiteOrigin({ ...env, DOCS_SITE_ORIGIN: previewUrl(2684) }),
+      previewUrl(2684),
+    );
+  }
+});
+
+await test('uses each deploy origin for shell and PowerShell installer links', async (t) => {
   const directory = await mkdtemp(join(tmpdir(), 'docs-preview-installers-'));
   t.after(() => rm(directory, { recursive: true, force: true }));
   const snapshots = [];
-  for (const number of [2684, 2685]) {
-    const root = join(directory, String(number));
+  const cases = [
+    { env: { DOCS_SITE_ORIGIN: previewUrl(2684) }, origin: previewUrl(2684) },
+    { env: { DOCS_SITE_ORIGIN: previewUrl(2685) }, origin: previewUrl(2685) },
+    {
+      env: { WORKERS_CI: '1', WORKERS_CI_BRANCH: 'rfc/vitest-v5-upgrade' },
+      origin: 'https://rfc-vitest-v5-upgrade-viteplus-dev.voidzero-docs.workers.dev',
+    },
+    { env: {}, origin: 'https://viteplus.dev' },
+  ];
+  for (const [index, { env, origin }] of cases.entries()) {
+    const root = join(directory, String(index));
     const scripts = join(root, 'docs', '.vitepress', 'scripts');
     const output = join(root, 'docs', 'public');
     const installers = join(root, 'packages', 'cli');
@@ -258,21 +322,32 @@ await test('uses each PR origin for shell and PowerShell installer links', async
       new URL('../../../docs/.vitepress/scripts/copy-installers.mjs', import.meta.url),
       script,
     );
+    await copyFile(
+      new URL('../../../docs/.vitepress/site-origin.ts', import.meta.url),
+      join(scripts, '..', 'site-origin.ts'),
+    );
     for (const name of ['install.sh', 'install.ps1', 'install-legacy.sh', 'install-legacy.ps1']) {
       await copyFile(
         new URL(`../../../packages/cli/${name}`, import.meta.url),
         join(installers, name),
       );
     }
-    const origin = previewUrl(number);
-    execFileSync(process.execPath, [script], { env: { ...process.env, DOCS_SITE_ORIGIN: origin } });
+    execFileSync(process.execPath, [script], {
+      env: {
+        ...process.env,
+        DOCS_SITE_ORIGIN: '',
+        WORKERS_CI: '',
+        WORKERS_CI_BRANCH: '',
+        ...env,
+      },
+    });
     const shell = await readFile(join(output, 'install.sh'), 'utf8');
     const powershell = await readFile(join(output, 'install.ps1'), 'utf8');
     assert.ok(shell.includes(`${origin}/install-legacy.sh`));
     assert.ok(powershell.includes(`${origin}/install-legacy.ps1`));
     snapshots.push({ origin, shell, powershell });
   }
-  assert.equal(new Set(snapshots.map((snapshot) => snapshot.origin)).size, 2);
+  assert.equal(new Set(snapshots.map((snapshot) => snapshot.origin)).size, cases.length);
   for (const snapshot of snapshots) {
     for (const other of snapshots) {
       if (other.origin !== snapshot.origin) {
diff --git a/.github/scripts/__tests__/upgrade-deps-utils.spec.ts b/.github/scripts/__tests__/upgrade-deps-utils.spec.ts
index b8b6b1f4a8..671ff1d069 100644
--- a/.github/scripts/__tests__/upgrade-deps-utils.spec.ts
+++ b/.github/scripts/__tests__/upgrade-deps-utils.spec.ts
@@ -16,3 +16,9 @@ test('selects the highest stable version from the supported major', () => {
 test('returns undefined when the supported major has no stable release', () => {
   expect(findLatestStableVersionForMajor(['4.2.0-beta.1', '5.0.0'], 4)).toBeUndefined();
 });
+
+test('keeps Vitest upgrades on v5 after the migration', () => {
+  expect(
+    findLatestStableVersionForMajor(['4.1.11', '5.0.0', '5.1.0', '5.2.0-beta.1', '6.0.0'], 5),
+  ).toBe('5.1.0');
+});
diff --git a/.github/scripts/upgrade-deps.ts b/.github/scripts/upgrade-deps.ts
index acc5a6e633..b895b6f2d0 100644
--- a/.github/scripts/upgrade-deps.ts
+++ b/.github/scripts/upgrade-deps.ts
@@ -72,7 +72,7 @@ type PnpmWorkspaceEntry = {
 const STABLE_SEMVER_TAG_RE = /^v?\d+\.\d+\.\d+$/;
 // Vitest major upgrades can change the bundled API, export shims, and CLI
 // behavior. Advance this only after Vite+ has adapted to the new major.
-const SUPPORTED_VITEST_MAJOR = 4;
+const SUPPORTED_VITEST_MAJOR = 5;
 
 const isFullSha = (s: string): boolean => /^[0-9a-f]{40}$/.test(s);
 
@@ -211,18 +211,15 @@ async function updatePnpmWorkspace(versions: PnpmWorkspaceVersions): Promise<voi
   let content = fs.readFileSync(filePath, 'utf8');
 
   // oxlint's trailing \n in the pattern disambiguates from oxlint-tsgolint.
-  // All @vitest/* catalog entries (browser + core direct deps) must stay pinned
+  // Official @vitest/* catalog entries (browser + core direct deps) stay pinned
   // to the same exact version as `vitest` itself, otherwise the catalog drifts
   // from VITEST_VERSION.
   const vitestExactVersionPackages = [
     '@vitest/browser',
     '@vitest/browser-playwright',
     '@vitest/browser-preview',
-    '@vitest/browser-webdriverio',
-    '@vitest/expect',
     '@vitest/mocker',
     '@vitest/pretty-format',
-    '@vitest/runner',
     '@vitest/snapshot',
     '@vitest/spy',
     '@vitest/utils',
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index f4dcaf4fba..e424a3073b 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -375,10 +375,13 @@ jobs:
         include:
           - os: namespace-profile-linux-x64-default
             target: x86_64-unknown-linux-gnu
+            test-node: 22.18.0
           - os: namespace-profile-mac-default
             target: aarch64-apple-darwin
+            test-node: 24.11.0
           - os: namespace-profile-windows-4c-8g
             target: x86_64-pc-windows-msvc
+            test-node: 26.0.0
     runs-on: ${{ matrix.os }}
     steps:
       - uses: taiki-e/checkout-action@7d1e50e93dc4fb3bba58f85018fadf77898aee8b # v1.4.2
@@ -456,8 +459,9 @@ jobs:
         run: vp check
 
       - name: Run unit tests
-        run: RUST_BACKTRACE=1 pnpm test:unit
+        run: vp env exec --node ${{ matrix.test-node }} node packages/cli/dist/bin.js test run
         env:
+          RUST_BACKTRACE: '1'
           RUST_MIN_STACK: 8388608
 
       - name: Test global package install (powershell)
diff --git a/.github/workflows/e2e-test.yml b/.github/workflows/e2e-test.yml
index 56661361d4..f103aa0ef2 100644
--- a/.github/workflows/e2e-test.yml
+++ b/.github/workflows/e2e-test.yml
@@ -344,7 +344,7 @@ jobs:
           - name: yaak
             node-version: 24
             command: |
-              vp fmt --ignore-path .oxfmtignore
+              vp fmt
               # FIXME: type-aware lint fails with "Invalid tsconfig" without full Rust/wasm bootstrap
               vp lint || true
               vp test
@@ -358,6 +358,16 @@ jobs:
               vp run test:types
               vp test --project nuxt
               vp test --project unit
+          - name: codiff
+            node-version: 24
+            timeout: 20
+            command: |
+              # Migration skips install scripts. node-pty has no Linux prebuild,
+              # so build its approved native addon before running the tests.
+              vp pm rebuild node-pty
+              vp run build
+              # The separate Workers integration suite still requires Vitest 4.
+              vp test run
           - name: vite-plus-jest-dom-repro
             node-version: 24
             command: |
@@ -418,6 +428,19 @@ jobs:
               vp run build && vp run build:demos
               vp run lint
               vp run test:unit
+          - name: 10ten-ja-reader
+            # Match upstream's pin for its locked WebDriverIO/Undici versions.
+            node-version: 24.15.0
+            command: |
+              vp test run --project browser --browser.name=chrome
+          - name: sqlocal
+            node-version: 24
+            command: |
+              vp test run --browser.name=chrome
+          - name: brazilian-utils
+            node-version: 24
+            command: |
+              vp test run --browser.enabled --browser.name=chrome --browser.headless
           - name: solid-vite-plugin
             node-version: 24
             # The next branch's Vite 8 example uses Solid 2 and @solidjs/vite-plugin.
@@ -452,10 +475,24 @@ jobs:
           - os: namespace-profile-windows-4c-8g
             project:
               name: varlet
+          # Codiff's upstream test job is Ubuntu-only and needs native-keymap system libraries.
+          - os: namespace-profile-windows-4c-8g
+            project:
+              name: codiff
           # tiptap upstream CI is ubuntu-only
           - os: namespace-profile-windows-4c-8g
             project:
               name: tiptap
+          # Match upstream's Linux Chrome jobs for these WebDriverIO suites.
+          - os: namespace-profile-windows-4c-8g
+            project:
+              name: 10ten-ja-reader
+          - os: namespace-profile-windows-4c-8g
+            project:
+              name: sqlocal
+          - os: namespace-profile-windows-4c-8g
+            project:
+              name: brazilian-utils
 
     steps:
       - uses: taiki-e/checkout-action@7d1e50e93dc4fb3bba58f85018fadf77898aee8b # v1.4.2
@@ -481,6 +518,12 @@ jobs:
           name: vite-plus-packages-${{ matrix.os }}
           path: tmp/tgz
 
+      - name: Install Codiff native-keymap dependencies
+        if: matrix.project.name == 'codiff'
+        run: |
+          sudo apt-get update
+          sudo apt-get install --yes libx11-dev libxkbfile-dev
+
       - name: Install vp CLI
         shell: bash
         run: |
diff --git a/.github/workflows/upgrade-deps.yml b/.github/workflows/upgrade-deps.yml
index 3cddf30d54..03dc937b67 100644
--- a/.github/workflows/upgrade-deps.yml
+++ b/.github/workflows/upgrade-deps.yml
@@ -113,8 +113,9 @@ jobs:
 
             ### Background
             - Upgrade script: `./.github/scripts/upgrade-deps.ts`
-            - Vitest is intentionally capped at the latest stable `4.x` release until
-              Vite+ adapts to a newer major. Do not remove or bypass that cap.
+            - Vitest is capped at the latest stable `5.x` release. Keep the exact
+              version selected by the upgrade script when merging upstream catalogs.
+              Official Vitest packages must use that version. Do not bypass the cap.
             - Sync-remote tool: `pnpm tool sync-remote` (source in
               `packages/tools/src/sync-remote-deps.ts`) — clones rolldown/vite into the
               working tree, merges their pnpm-workspace catalogs into the root
@@ -135,7 +136,7 @@ jobs:
                cross-major semver conflict in the merged catalog, e.g.
                `Incompatible semver ranges for <pkg>: ^X vs ^Y`. The merger refuses to
                auto-resolve cross-major conflicts for packages outside its synced list
-               (oxc-*, vitest deps). For passthrough deps that vp does NOT import
+               (oxc-* and tinybench). For passthrough deps that vp does NOT import
                directly (e.g. `diff`, `acorn`, `astring`, anything only present in
                `rolldown/scripts/package.json` or vite's internals), bump vp's
                `pnpm-workspace.yaml` catalog entry to match the rolldown/vite version,
diff --git a/.typos.toml b/.typos.toml
index 0c6c885186..ae1189d497 100644
--- a/.typos.toml
+++ b/.typos.toml
@@ -1,3 +1,7 @@
+[default]
+# Vitest v4 used this misspelled directory; the migrator must recognize it.
+extend-ignore-re = ['\.vitest-attachements\b']
+
 [default.extend-words]
 ratatui = "ratatui"
 PUNICODE = "PUNICODE"
diff --git a/Cargo.lock b/Cargo.lock
index 8606770648..ec2dd9596f 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -8841,6 +8841,7 @@ dependencies = [
  "ast-grep-language",
  "brush-parser 0.3.0",
  "ignore",
+ "oxc",
  "rayon",
  "regex",
  "serde_json",
diff --git a/Cargo.toml b/Cargo.toml
index 6482bd0ece..75faf12b65 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -256,7 +256,7 @@ reqwest = { version = "0.13", default-features = false }
 rolldown-notify = "10.2.0"
 rolldown-notify-debouncer-full = "0.7.5"
 rustc-hash = "2.1.1"
-rustls = { version = "0.23", default-features = false, features = ["ring", "std", "tls12"] }
+rustls = { version = "0.23.45", default-features = false, features = ["ring", "std", "tls12"] }
 same-file = "1.0.6"
 schemars = "1.0.0"
 self_cell = "1.2.0"
diff --git a/README.md b/README.md
index c18ccaa745..139fdf4d08 100644
--- a/README.md
+++ b/README.md
@@ -207,7 +207,7 @@ Add package-manager overrides so that other packages use the Vite+ versions. Ali
 ```json
 "overrides": {
   "vite": "npm:@voidzero-dev/vite-plus-core@latest",
-  "vitest": "4.1.11"
+  "vitest": "5.0.1"
 }
 ```
 
@@ -216,7 +216,7 @@ If you are using `pnpm`, add this to your `pnpm-workspace.yaml`:
 ```yaml
 overrides:
   vite: npm:@voidzero-dev/vite-plus-core@latest
-  vitest: 4.1.11
+  vitest: 5.0.1
 ```
 
 Or, if you are using Yarn:
@@ -224,7 +224,7 @@ Or, if you are using Yarn:
 ```json
 "resolutions": {
   "vite": "npm:@voidzero-dev/vite-plus-core@latest",
-  "vitest": "4.1.11"
+  "vitest": "5.0.1"
 }
 ```
 
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_add_yarn4/snapshots/command_add_yarn4.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_add_yarn4/snapshots/command_add_yarn4.md
index 5a6b3afdcf..fd5c4245e0 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_add_yarn4/snapshots/command_add_yarn4.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_add_yarn4/snapshots/command_add_yarn4.md
@@ -50,7 +50,7 @@ should add package as dev dependencies
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json`
@@ -81,7 +81,7 @@ warn: yarn does not support --allow-build.
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json`
@@ -114,7 +114,7 @@ VITE+ - The Unified Toolchain for the Web
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json`
@@ -150,7 +150,7 @@ should add package as optional dependencies
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json`
@@ -187,7 +187,7 @@ support pass through arguments
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_add_yarn4_with_workspace/snapshots/command_add_yarn4_with_workspace.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_add_yarn4_with_workspace/snapshots/command_add_yarn4_with_workspace.md
index c2fb74cbb6..5a5b3fc5ff 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_add_yarn4_with_workspace/snapshots/command_add_yarn4_with_workspace.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_add_yarn4_with_workspace/snapshots/command_add_yarn4_with_workspace.md
@@ -15,7 +15,7 @@ warn: yarn >=2 does not support --workspace-root.
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json packages/app/package.json packages/utils/package.json`
@@ -56,7 +56,7 @@ warn: yarn does not support --workspace.
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json packages/app/package.json packages/utils/package.json`
@@ -101,10 +101,10 @@ should add packages to packages/app
 [app]: ➤ YN0000: └ Completed
 [app]: ➤ YN0000: ┌ Link step
 [app]: ➤ YN0000: └ Completed
-[app]: ➤ YN0000: · Done in <duration> <duration>
-[app]: Process exited (exit code 0), completed in <duration> <duration>
+[app]: ➤ YN0000: · Done in <duration>
+[app]: Process exited (exit code 0), completed in <duration>
 
-Done in <duration> <duration>
+Done in <duration>
 ```
 
 ## `vpt print-file package.json packages/app/package.json packages/utils/package.json`
@@ -152,10 +152,10 @@ warn: yarn does not support --workspace.
 [app]: ➤ YN0000: └ Completed
 [app]: ➤ YN0000: ┌ Link step
 [app]: ➤ YN0000: └ Completed
-[app]: ➤ YN0000: · Done in <duration> <duration>
-[app]: Process exited (exit code 0), completed in <duration> <duration>
+[app]: ➤ YN0000: · Done in <duration>
+[app]: Process exited (exit code 0), completed in <duration>
 
-Done in <duration> <duration>
+Done in <duration>
 ```
 
 ## `vpt print-file package.json packages/app/package.json packages/utils/package.json`
@@ -203,8 +203,8 @@ should add testnpm2 test-vite-plus-install to all packages and workspace root
 [command-add-yarn4-with-workspace]: ➤ YN0000: └ Completed
 [command-add-yarn4-with-workspace]: ➤ YN0000: ┌ Link step
 [command-add-yarn4-with-workspace]: ➤ YN0000: └ Completed
-[command-add-yarn4-with-workspace]: ➤ YN0000: · Done in <duration> <duration>
-[command-add-yarn4-with-workspace]: Process exited (exit code 0), completed in <duration> <duration>
+[command-add-yarn4-with-workspace]: ➤ YN0000: · Done in <duration>
+[command-add-yarn4-with-workspace]: Process exited (exit code 0), completed in <duration>
 
 [admin]: Process started
 [admin]: ➤ YN0000: · Yarn <version>
@@ -214,8 +214,8 @@ should add testnpm2 test-vite-plus-install to all packages and workspace root
 [admin]: ➤ YN0000: └ Completed
 [admin]: ➤ YN0000: ┌ Link step
 [admin]: ➤ YN0000: └ Completed
-[admin]: ➤ YN0000: · Done in <duration> <duration>
-[admin]: Process exited (exit code 0), completed in <duration> <duration>
+[admin]: ➤ YN0000: · Done in <duration>
+[admin]: Process exited (exit code 0), completed in <duration>
 
 [app]: Process started
 [app]: ➤ YN0000: · Yarn <version>
@@ -225,8 +225,8 @@ should add testnpm2 test-vite-plus-install to all packages and workspace root
 [app]: ➤ YN0000: └ Completed
 [app]: ➤ YN0000: ┌ Link step
 [app]: ➤ YN0000: └ Completed
-[app]: ➤ YN0000: · Done in <duration> <duration>
-[app]: Process exited (exit code 0), completed in <duration> <duration>
+[app]: ➤ YN0000: · Done in <duration>
+[app]: Process exited (exit code 0), completed in <duration>
 
 [@vite-plus-test/utils]: Process started
 [@vite-plus-test/utils]: ➤ YN0000: · Yarn <version>
@@ -236,10 +236,10 @@ should add testnpm2 test-vite-plus-install to all packages and workspace root
 [@vite-plus-test/utils]: ➤ YN0000: └ Completed
 [@vite-plus-test/utils]: ➤ YN0000: ┌ Link step
 [@vite-plus-test/utils]: ➤ YN0000: └ Completed
-[@vite-plus-test/utils]: ➤ YN0000: · Done in <duration> <duration>
-[@vite-plus-test/utils]: Process exited (exit code 0), completed in <duration> <duration>
+[@vite-plus-test/utils]: ➤ YN0000: · Done in <duration>
+[@vite-plus-test/utils]: Process exited (exit code 0), completed in <duration>
 
-Done in <duration> <duration>
+Done in <duration>
 ```
 
 ## `vpt print-file package.json packages/app/package.json packages/admin/package.json packages/utils/package.json`
@@ -303,8 +303,8 @@ VITE+ - The Unified Toolchain for the Web
 [command-add-yarn4-with-workspace]: ➤ YN0000: └ Completed
 [command-add-yarn4-with-workspace]: ➤ YN0000: ┌ Link step
 [command-add-yarn4-with-workspace]: ➤ YN0000: └ Completed
-[command-add-yarn4-with-workspace]: ➤ YN0000: · Done in <duration> <duration>
-[command-add-yarn4-with-workspace]: Process exited (exit code 0), completed in <duration> <duration>
+[command-add-yarn4-with-workspace]: ➤ YN0000: · Done in <duration>
+[command-add-yarn4-with-workspace]: Process exited (exit code 0), completed in <duration>
 
 [admin]: Process started
 [admin]: ➤ YN0000: · Yarn <version>
@@ -314,8 +314,8 @@ VITE+ - The Unified Toolchain for the Web
 [admin]: ➤ YN0000: └ Completed
 [admin]: ➤ YN0000: ┌ Link step
 [admin]: ➤ YN0000: └ Completed
-[admin]: ➤ YN0000: · Done in <duration> <duration>
-[admin]: Process exited (exit code 0), completed in <duration> <duration>
+[admin]: ➤ YN0000: · Done in <duration>
+[admin]: Process exited (exit code 0), completed in <duration>
 
 [app]: Process started
 [app]: ➤ YN0000: · Yarn <version>
@@ -325,10 +325,10 @@ VITE+ - The Unified Toolchain for the Web
 [app]: ➤ YN0000: └ Completed
 [app]: ➤ YN0000: ┌ Link step
 [app]: ➤ YN0000: └ Completed
-[app]: ➤ YN0000: · Done in <duration> <duration>
-[app]: Process exited (exit code 0), completed in <duration> <duration>
+[app]: ➤ YN0000: · Done in <duration>
+[app]: Process exited (exit code 0), completed in <duration>
 
-Done in <duration> <duration>
+Done in <duration>
 ```
 
 ## `vpt print-file package.json packages/app/package.json packages/admin/package.json packages/utils/package.json`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_dedupe_yarn4/snapshots/command_dedupe_yarn4.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_dedupe_yarn4/snapshots/command_dedupe_yarn4.md
index 24cc7616fc..217c332fed 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_dedupe_yarn4/snapshots/command_dedupe_yarn4.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_dedupe_yarn4/snapshots/command_dedupe_yarn4.md
@@ -17,7 +17,7 @@ should dedupe dependencies
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_link_yarn4/snapshots/command_link_yarn4.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_link_yarn4/snapshots/command_link_yarn4.md
index b80751d968..1ab706215b 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_link_yarn4/snapshots/command_link_yarn4.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_link_yarn4/snapshots/command_link_yarn4.md
@@ -25,7 +25,7 @@ should link local directory
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json`
@@ -53,7 +53,7 @@ should work with ln alias
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json`
@@ -81,7 +81,7 @@ cleanup temp states
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_pack_yarn4/snapshots/command_pack_yarn4.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_pack_yarn4/snapshots/command_pack_yarn4.md
index 0f03fe7b74..6eaa9537aa 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_pack_yarn4/snapshots/command_pack_yarn4.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_pack_yarn4/snapshots/command_pack_yarn4.md
@@ -7,7 +7,7 @@ should pack current package
 ```
 ➤ YN0000: package.json
 ➤ YN0000: Package archive generated in <workspace>/package.tgz
-➤ YN0000: Done in <duration> <duration>
+➤ YN0000: Done in <duration>
 ```
 
 ## `vp pm pack --out ./dist/package.tgz`
@@ -17,7 +17,7 @@ should pack with output file
 ```
 ➤ YN0000: package.json
 ➤ YN0000: Package archive generated in <workspace>/dist/package.tgz
-➤ YN0000: Done in <duration> <duration>
+➤ YN0000: Done in <duration>
 ```
 
 ## `vp pm pack --json`
@@ -38,5 +38,5 @@ should support pass through arguments
 ```
 ➤ YN0000: dist/package.tgz
 ➤ YN0000: package.json
-➤ YN0000: Done in <duration> <duration>
+➤ YN0000: Done in <duration>
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_pack_yarn4_with_workspace/snapshots/command_pack_yarn4_with_workspace.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_pack_yarn4_with_workspace/snapshots/command_pack_yarn4_with_workspace.md
index 9f43a23b24..fc748b3431 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_pack_yarn4_with_workspace/snapshots/command_pack_yarn4_with_workspace.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_pack_yarn4_with_workspace/snapshots/command_pack_yarn4_with_workspace.md
@@ -15,7 +15,7 @@ VITE+ - The Unified Toolchain for the Web
 ➤ YN0000: ┌ Link step
 ➤ YN0073: │ Skipped due to mode=update-lockfile
 ➤ YN0000: └ Completed
-➤ YN0000: · Done with warnings in <duration> <duration>
+➤ YN0000: · Done with warnings in <duration>
 ```
 
 ## `vp pm pack`
@@ -25,7 +25,7 @@ should pack current workspace root
 ```
 ➤ YN0000: package.json
 ➤ YN0000: Package archive generated in <workspace>/package.tgz
-➤ YN0000: Done in <duration> <duration>
+➤ YN0000: Done in <duration>
 ```
 
 ## `vp pm pack --recursive`
@@ -36,22 +36,22 @@ should pack all packages in workspace (uses workspaces foreach --all pack)
 [command-pack-yarn4-with-workspace]: Process started
 [command-pack-yarn4-with-workspace]: ➤ YN0000: package.json
 [command-pack-yarn4-with-workspace]: ➤ YN0000: Package archive generated in <workspace>/package.tgz
-[command-pack-yarn4-with-workspace]: ➤ YN0000: Done in <duration> <duration>
-[command-pack-yarn4-with-workspace]: Process exited (exit code 0), completed in <duration> <duration>
+[command-pack-yarn4-with-workspace]: ➤ YN0000: Done in <duration>
+[command-pack-yarn4-with-workspace]: Process exited (exit code 0), completed in <duration>
 
 [app]: Process started
 [app]: ➤ YN0000: package.json
 [app]: ➤ YN0000: Package archive generated in <workspace>/packages/app/package.tgz
-[app]: ➤ YN0000: Done in <duration> <duration>
-[app]: Process exited (exit code 0), completed in <duration> <duration>
+[app]: ➤ YN0000: Done in <duration>
+[app]: Process exited (exit code 0), completed in <duration>
 
 [@vite-plus-test/utils]: Process started
 [@vite-plus-test/utils]: ➤ YN0000: package.json
 [@vite-plus-test/utils]: ➤ YN0000: Package archive generated in <workspace>/packages/utils/package.tgz
-[@vite-plus-test/utils]: ➤ YN0000: Done in <duration> <duration>
-[@vite-plus-test/utils]: Process exited (exit code 0), completed in <duration> <duration>
+[@vite-plus-test/utils]: ➤ YN0000: Done in <duration>
+[@vite-plus-test/utils]: Process exited (exit code 0), completed in <duration>
 
-Done in <duration> <duration>
+Done in <duration>
 ```
 
 ## `vp pm pack --filter app`
@@ -62,10 +62,10 @@ should pack specific package (uses workspaces foreach --all --include app pack)
 [app]: Process started
 [app]: ➤ YN0000: package.json
 [app]: ➤ YN0000: Package archive generated in <workspace>/packages/app/package.tgz
-[app]: ➤ YN0000: Done in <duration> <duration>
-[app]: Process exited (exit code 0), completed in <duration> <duration>
+[app]: ➤ YN0000: Done in <duration>
+[app]: Process exited (exit code 0), completed in <duration>
 
-Done in <duration> <duration>
+Done in <duration>
 ```
 
 ## `vp pm pack --filter app --filter @vite-plus-test/utils`
@@ -76,16 +76,16 @@ should pack multiple packages
 [app]: Process started
 [app]: ➤ YN0000: package.json
 [app]: ➤ YN0000: Package archive generated in <workspace>/packages/app/package.tgz
-[app]: ➤ YN0000: Done in <duration> <duration>
-[app]: Process exited (exit code 0), completed in <duration> <duration>
+[app]: ➤ YN0000: Done in <duration>
+[app]: Process exited (exit code 0), completed in <duration>
 
 [@vite-plus-test/utils]: Process started
 [@vite-plus-test/utils]: ➤ YN0000: package.json
 [@vite-plus-test/utils]: ➤ YN0000: Package archive generated in <workspace>/packages/utils/package.tgz
-[@vite-plus-test/utils]: ➤ YN0000: Done in <duration> <duration>
-[@vite-plus-test/utils]: Process exited (exit code 0), completed in <duration> <duration>
+[@vite-plus-test/utils]: ➤ YN0000: Done in <duration>
+[@vite-plus-test/utils]: Process exited (exit code 0), completed in <duration>
 
-Done in <duration> <duration>
+Done in <duration>
 ```
 
 ## `vp pm pack --out ./dist/package.tgz`
@@ -95,7 +95,7 @@ should pack with output file
 ```
 ➤ YN0000: package.json
 ➤ YN0000: Package archive generated in <workspace>/dist/package.tgz
-➤ YN0000: Done in <duration> <duration>
+➤ YN0000: Done in <duration>
 ```
 
 ## `vp pm pack --json`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_remove_yarn4/snapshots/command_remove_yarn4.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_remove_yarn4/snapshots/command_remove_yarn4.md
index 36812df7d0..e50ab482ec 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_remove_yarn4/snapshots/command_remove_yarn4.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_remove_yarn4/snapshots/command_remove_yarn4.md
@@ -28,7 +28,7 @@ should add packages to dependencies
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vp add -D test-vite-plus-install`
@@ -43,7 +43,7 @@ should add packages to dependencies
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vp add -O test-vite-plus-package-optional`
@@ -58,7 +58,7 @@ should add packages to dependencies
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json`
@@ -93,7 +93,7 @@ should remove packages from dependencies
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json`
@@ -122,7 +122,7 @@ support ignore -O flag and remove package from optional dependencies
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_remove_yarn4_with_workspace/snapshots/command_remove_yarn4_with_workspace.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_remove_yarn4_with_workspace/snapshots/command_remove_yarn4_with_workspace.md
index df6ae81533..18fe450c40 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_remove_yarn4_with_workspace/snapshots/command_remove_yarn4_with_workspace.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_remove_yarn4_with_workspace/snapshots/command_remove_yarn4_with_workspace.md
@@ -89,8 +89,8 @@ warn: yarn does not support --workspace-root.
 [app]: ➤ YN0000: └ Completed
 [app]: ➤ YN0000: ┌ Link step
 [app]: ➤ YN0000: └ Completed
-[app]: ➤ YN0000: · Done in <duration> <duration>
-[app]: Process exited (exit code 0), completed in <duration> <duration>
+[app]: ➤ YN0000: · Done in <duration>
+[app]: Process exited (exit code 0), completed in <duration>
 
 [@vite-plus-test/utils]: Process started
 [@vite-plus-test/utils]: ➤ YN0000: · Yarn <version>
@@ -100,10 +100,10 @@ warn: yarn does not support --workspace-root.
 [@vite-plus-test/utils]: ➤ YN0000: └ Completed
 [@vite-plus-test/utils]: ➤ YN0000: ┌ Link step
 [@vite-plus-test/utils]: ➤ YN0000: └ Completed
-[@vite-plus-test/utils]: ➤ YN0000: · Done in <duration> <duration>
-[@vite-plus-test/utils]: Process exited (exit code 0), completed in <duration> <duration>
+[@vite-plus-test/utils]: ➤ YN0000: · Done in <duration>
+[@vite-plus-test/utils]: Process exited (exit code 0), completed in <duration>
 
-Done in <duration> <duration>
+Done in <duration>
 ```
 
 ## `vpt print-file package.json packages/app/package.json packages/admin/package.json packages/utils/package.json`
@@ -174,7 +174,7 @@ should remove package from all workspaces and root
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json packages/app/package.json packages/admin/package.json packages/utils/package.json`
@@ -237,7 +237,7 @@ should remove optional package from all workspaces
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json packages/app/package.json packages/admin/package.json packages/utils/package.json`
@@ -288,10 +288,10 @@ recursive remove affects only app
 [app]: ➤ YN0000: └ Completed
 [app]: ➤ YN0000: ┌ Link step
 [app]: ➤ YN0000: └ Completed
-[app]: ➤ YN0000: · Done in <duration> <duration>
-[app]: Process exited (exit code 0), completed in <duration> <duration>
+[app]: ➤ YN0000: · Done in <duration>
+[app]: Process exited (exit code 0), completed in <duration>
 
-Done in <duration> <duration>
+Done in <duration>
 ```
 
 ## `vpt print-file package.json packages/app/package.json packages/admin/package.json packages/utils/package.json`
@@ -339,10 +339,10 @@ should remove package by filter=*
 [app]: ➤ YN0000: └ Completed
 [app]: ➤ YN0000: ┌ Link step
 [app]: ➤ YN0000: └ Completed
-[app]: ➤ YN0000: · Done in <duration> <duration>
-[app]: Process exited (exit code 0), completed in <duration> <duration>
+[app]: ➤ YN0000: · Done in <duration>
+[app]: Process exited (exit code 0), completed in <duration>
 
-Done in <duration> <duration>
+Done in <duration>
 ```
 
 ## `vp remove test-vite-plus-install --filter=*`
@@ -356,8 +356,8 @@ Done in <duration> <duration>
 [command-remove-yarn4-with-workspace]: ➤ YN0000: └ Completed
 [command-remove-yarn4-with-workspace]: ➤ YN0000: ┌ Link step
 [command-remove-yarn4-with-workspace]: ➤ YN0000: └ Completed
-[command-remove-yarn4-with-workspace]: ➤ YN0000: · Done in <duration> <duration>
-[command-remove-yarn4-with-workspace]: Process exited (exit code 0), completed in <duration> <duration>
+[command-remove-yarn4-with-workspace]: ➤ YN0000: · Done in <duration>
+[command-remove-yarn4-with-workspace]: Process exited (exit code 0), completed in <duration>
 
 [admin]: Process started
 [admin]: ➤ YN0000: · Yarn <version>
@@ -367,8 +367,8 @@ Done in <duration> <duration>
 [admin]: ➤ YN0000: └ Completed
 [admin]: ➤ YN0000: ┌ Link step
 [admin]: ➤ YN0000: └ Completed
-[admin]: ➤ YN0000: · Done in <duration> <duration>
-[admin]: Process exited (exit code 0), completed in <duration> <duration>
+[admin]: ➤ YN0000: · Done in <duration>
+[admin]: Process exited (exit code 0), completed in <duration>
 
 [app]: Process started
 [app]: ➤ YN0000: · Yarn <version>
@@ -378,10 +378,10 @@ Done in <duration> <duration>
 [app]: ➤ YN0000: └ Completed
 [app]: ➤ YN0000: ┌ Link step
 [app]: ➤ YN0000: └ Completed
-[app]: ➤ YN0000: · Done in <duration> <duration>
-[app]: Process exited (exit code 0), completed in <duration> <duration>
+[app]: ➤ YN0000: · Done in <duration>
+[app]: Process exited (exit code 0), completed in <duration>
 
-Done in <duration> <duration>
+Done in <duration>
 ```
 
 ## `vpt print-file package.json packages/app/package.json packages/admin/package.json packages/utils/package.json`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_tool_help/snapshots/command_tool_deep_help_delegation.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_tool_help/snapshots/command_tool_deep_help_delegation.md
index 327af269cb..11c6db2967 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_tool_help/snapshots/command_tool_deep_help_delegation.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_tool_help/snapshots/command_tool_deep_help_delegation.md
@@ -5,7 +5,7 @@ Help requests with additional arguments delegate to the underlying tool.
 ## `vp test --help --coverage`
 
 ```
-vitest/4.1.11
+vitest/<version>
 
 Usage:
   $ vitest [...filters]
@@ -17,6 +17,7 @@ Commands:
   dev [...filters]
   bench [...filters]
   init <project>
+  doctor [...filters]
   list [...filters]
   [...filters]
   complete [shell]
@@ -28,6 +29,7 @@ For more info, run any command with the `--help` flag:
   $ vitest dev --help
   $ vitest bench --help
   $ vitest init --help
+  $ vitest doctor --help
   $ vitest list --help
   $ vitest --help
   $ vitest complete --help
@@ -47,7 +49,7 @@ Options:
   --coverage.allowExternal                                   Collect coverage of files outside the project root (default: false)
   --coverage.skipFull                                        Do not show files with 100% statement, branch, and function coverage (default: false)
   --coverage.thresholds.100                                  Shortcut to set all coverage thresholds to 100 (default: false)
-  --coverage.thresholds.perFile                              Check thresholds per file. See --coverage.thresholds.lines, --coverage.thresholds.functions, --coverage.thresholds.branches and --coverage.thresholds.statements for the actual thresholds (default: false)
+  --coverage.thresholds.perFile <boolean>                    Check thresholds per file. See --coverage.thresholds.lines, --coverage.thresholds.functions, --coverage.thresholds.branches and --coverage.thresholds.statements for the actual thresholds (default: false). Object form is available in config files only.
   --coverage.thresholds.autoUpdate <boolean|function>        Update threshold values: "lines", "functions", "branches" and "statements" to configuration file when current coverage is above the configured thresholds (default: false)
   --coverage.thresholds.lines <number>                       Threshold for lines. Visit https://github.com/istanbuljs/nyc#coverage-thresholds for more information. This option is not available for custom providers
   --coverage.thresholds.functions <number>                   Threshold for functions. Visit https://github.com/istanbuljs/nyc#coverage-thresholds for more information. This option is not available for custom providers
@@ -63,4 +65,5 @@ Options:
   --coverage.changed <commit/branch>                         Collect coverage only for files changed since a specified commit or branch (e.g., origin/main or HEAD~1). Inherits value from --changed by default.
   --coverage.excludeAfterRemap                               Apply exclusions again after coverage has been remapped to original sources. (default: false)
   --coverage.htmlDir <path>                                  Directory of HTML coverage output to be served in UI mode and HTML reporter.
+  --coverage.autoAttachSubprocess                            Track coverage of the node:child_process and node:worker_threads spawned during test run. Supported only by v8 provider. (default: false)
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_unlink_yarn4/snapshots/command_unlink_yarn4.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_unlink_yarn4/snapshots/command_unlink_yarn4.md
index 53e3073c3b..5db048eb19 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_unlink_yarn4/snapshots/command_unlink_yarn4.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_unlink_yarn4/snapshots/command_unlink_yarn4.md
@@ -25,7 +25,7 @@ link the library first
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json`
@@ -53,7 +53,7 @@ should unlink the package
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json`
@@ -78,7 +78,7 @@ link again
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json`
@@ -106,7 +106,7 @@ should unlink all with --all flag
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json`
@@ -131,7 +131,7 @@ should work with -r short form
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_update_yarn4/snapshots/command_update_yarn4.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_update_yarn4/snapshots/command_update_yarn4.md
index f2720d8611..b8e1dd9e1f 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_update_yarn4/snapshots/command_update_yarn4.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_update_yarn4/snapshots/command_update_yarn4.md
@@ -14,7 +14,7 @@ should update package within semver range
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json`
@@ -49,7 +49,7 @@ should to absolute latest version
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vp add testnpm2@1.0.0 -D`
@@ -64,7 +64,7 @@ should to absolute latest version
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vp update testnpm2 --latest`
@@ -79,7 +79,7 @@ should to absolute latest version
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json`
@@ -111,7 +111,7 @@ should update and ignore -D options
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json`
@@ -143,7 +143,7 @@ should update all packages but won't change the package.json
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_update_yarn4_with_workspace/snapshots/command_update_yarn4_with_workspace.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_update_yarn4_with_workspace/snapshots/command_update_yarn4_with_workspace.md
index ddecffc904..1e1e80d716 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_update_yarn4_with_workspace/snapshots/command_update_yarn4_with_workspace.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_update_yarn4_with_workspace/snapshots/command_update_yarn4_with_workspace.md
@@ -118,7 +118,7 @@ unfiltered update still updates all testnpm2 versions
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json packages/app/package.json packages/utils/package.json`
@@ -167,7 +167,7 @@ unfiltered recursive update remains supported
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt print-file package.json packages/app/package.json`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_why_yarn4/snapshots/command_why_yarn4.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_why_yarn4/snapshots/command_why_yarn4.md
index 3f2ef70f63..11a36d36c7 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_why_yarn4/snapshots/command_why_yarn4.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_why_yarn4/snapshots/command_why_yarn4.md
@@ -17,7 +17,7 @@ VITE+ - The Unified Toolchain for the Web
 ➤ YN0000: ┌ Link step
 ➤ YN0073: │ Skipped due to mode=update-lockfile
 ➤ YN0000: └ Completed
-➤ YN0000: · Done with warnings in <duration> <duration>
+➤ YN0000: · Done with warnings in <duration>
 ```
 
 ## `vp why testnpm2`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/core_module_identity/check-npm-layout.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/core_module_identity/check-npm-layout.mjs
index db39f0147f..7d71f37cc7 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/core_module_identity/check-npm-layout.mjs
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/core_module_identity/check-npm-layout.mjs
@@ -7,10 +7,23 @@ const vitestRequire = createRequire(cliRequire.resolve('vitest/package.json'));
 const project = require('./package.json');
 assert.equal(project.overrides, undefined);
 assert.equal(cliRequire('vite/package.json').name, '@voidzero-dev/vite-plus-core');
-assert.equal(vitestRequire('vite/package.json').name, 'vite');
-assert.notEqual(cliRequire.resolve('vite/package.json'), vitestRequire.resolve('vite/package.json'));
-if (!project.devDependencies.vite) {
+if (project.devDependencies.vite) {
+  assert.equal(
+    project.devDependencies.vite,
+    `npm:@voidzero-dev/vite-plus-core@${cliRequire('vite-plus/package.json').version}`,
+  );
+  assert.equal(require.resolve('vite/package.json'), cliRequire.resolve('vite/package.json'));
+  assert.equal(vitestRequire.resolve('vite/package.json'), cliRequire.resolve('vite/package.json'));
+  console.log(
+    'npm shares the exact core alias between the project, CLI, and Vitest without overrides',
+  );
+} else {
   assert.deepEqual(Object.keys(project.devDependencies), ['vite-plus']);
   assert.equal(require('vite/package.json').name, 'vite');
+  assert.equal(vitestRequire('vite/package.json').name, 'vite');
+  assert.notEqual(
+    cliRequire.resolve('vite/package.json'),
+    vitestRequire.resolve('vite/package.json'),
+  );
+  console.log('npm installed separate CLI core and upstream Vitest peer without overrides');
 }
-console.log('npm installed separate CLI core and upstream Vitest peer without overrides');
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/core_module_identity/check-tagged-alias.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/core_module_identity/check-tagged-alias.mjs
new file mode 100644
index 0000000000..40e971754c
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/core_module_identity/check-tagged-alias.mjs
@@ -0,0 +1,24 @@
+import assert from 'node:assert/strict';
+import { spawnSync } from 'node:child_process';
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+const cliRequire = createRequire(require.resolve('vite-plus/package.json'));
+const project = require('./package.json');
+assert.equal(project.overrides, undefined);
+assert.equal(project.devDependencies.vite, 'npm:@voidzero-dev/vite-plus-core@latest');
+// npm 11.11 accepts a peer's upstream Vite as satisfying the tagged alias.
+assert.equal(require('vite/package.json').name, 'vite');
+assert.equal(cliRequire('vite/package.json').name, '@voidzero-dev/vite-plus-core');
+assert.notEqual(require.resolve('vite/package.json'), cliRequire.resolve('vite/package.json'));
+
+for (const args of [['dev'], ['pack', 'entry.js']]) {
+  const result = spawnSync('vp', args, { encoding: 'utf8', timeout: 30_000 });
+  assert.ifError(result.error);
+  const output = result.stdout + result.stderr;
+  assert.equal(result.status, 1, output);
+  assert.match(output, /Expected @voidzero-dev\/vite-plus-core@/);
+  assert.match(output, /but found vite@/);
+  assert.match(output, /Run `vp migrate` to align the Vite alias, then run `vp install`\./);
+  console.log(`vp ${args[0]} rejects the replaced npm alias and reports the repair command`);
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/core_module_identity/pin-core-alias.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/core_module_identity/pin-core-alias.mjs
new file mode 100644
index 0000000000..b1e29e051d
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/core_module_identity/pin-core-alias.mjs
@@ -0,0 +1,10 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+
+// Before installation, resolve the checkout exposed by the snapshot runner.
+// CI can stamp its version, so do not hard-code the committed package version.
+const require = createRequire(import.meta.url);
+const { version } = require('vite-plus/package.json');
+const project = JSON.parse(readFileSync('package.json', 'utf8'));
+project.devDependencies.vite = `npm:@voidzero-dev/vite-plus-core@${version}`;
+writeFileSync('package.json', `${JSON.stringify(project, null, 2)}\n`);
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/core_module_identity/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/core_module_identity/snapshots.toml
index d7371dfb43..9b5cd5a383 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/core_module_identity/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/core_module_identity/snapshots.toml
@@ -139,14 +139,26 @@ vp = "global"
 local-registry = true
 steps = [
   { argv = ["vpt", "write-file", "package.json", "{\"name\":\"core-module-identity\",\"private\":true,\"type\":\"module\",\"packageManager\":\"npm@11.11.0\",\"devDependencies\":{\"vite-plus\":\"latest\",\"vite\":\"npm:@voidzero-dev/vite-plus-core@latest\"}}\n"], snapshot = false },
+  { argv = ["node", "pin-core-alias.mjs"], snapshot = false },
   { argv = ["vp", "install", "--ignore-scripts"], timeout = 120000, snapshot = false },
   { argv = ["node", "check-npm-layout.mjs"] },
   { argv = ["node", "check-api.mjs"] },
   { argv = ["vp", "dev"] },
   { argv = ["vp", "build"] },
+  { argv = ["vp", "test", "run"], snapshot = false },
   { argv = ["vp", "pack", "entry.js"] },
   { argv = ["vpt", "write-file", "typecheck/package.json", "{\"name\":\"typecheck-tools\",\"private\":true,\"dependencies\":{\"typescript\":\"6.0.3\"},\"packageManager\":\"npm@11.11.0\"}\n"], snapshot = false },
   { argv = ["vp", "install", "--ignore-scripts"], cwd = "typecheck", snapshot = false },
   { argv = ["vpt", "cp", "check-config.mts", "check-config.cts"], snapshot = false },
   { argv = ["node", "typecheck/node_modules/typescript/bin/tsc", "--noEmit", "--skipLibCheck", "--module", "NodeNext", "--target", "ESNext", "check-config.mts", "check-config.cts"] },
 ]
+
+[[case]]
+name = "core_module_identity_npm_tagged_alias_rejected"
+vp = "global"
+local-registry = true
+steps = [
+  { argv = ["vpt", "write-file", "package.json", "{\"name\":\"core-module-identity\",\"private\":true,\"type\":\"module\",\"packageManager\":\"npm@11.11.0\",\"devDependencies\":{\"vite-plus\":\"latest\",\"vite\":\"npm:@voidzero-dev/vite-plus-core@latest\"}}\n"], snapshot = false },
+  { argv = ["vp", "install", "--ignore-scripts"], timeout = 120000, snapshot = false },
+  ["node", "check-tagged-alias.mjs"],
+]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/core_module_identity/snapshots/core_module_identity_npm_matching_alias_no_override.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/core_module_identity/snapshots/core_module_identity_npm_matching_alias_no_override.md
index ad57acf182..572998d838 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/core_module_identity/snapshots/core_module_identity_npm_matching_alias_no_override.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/core_module_identity/snapshots/core_module_identity_npm_matching_alias_no_override.md
@@ -4,13 +4,16 @@
 '`
 
 
+## `node pin-core-alias.mjs`
+
+
 ## `vp install --ignore-scripts`
 
 
 ## `node check-npm-layout.mjs`
 
 ```
-npm installed separate CLI core and upstream Vitest peer without overrides
+npm shares the exact core alias between the project, CLI, and Vitest without overrides
 ```
 
 ## `node check-api.mjs`
@@ -43,6 +46,9 @@ dist/assets/index-<hash>.js  <size> kB │ gzip: <size> kB
 ✓ built in <duration>
 ```
 
+## `vp test run`
+
+
 ## `vp pack entry.js`
 
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/core_module_identity/snapshots/core_module_identity_npm_tagged_alias_rejected.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/core_module_identity/snapshots/core_module_identity_npm_tagged_alias_rejected.md
new file mode 100644
index 0000000000..8f3b5c664c
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/core_module_identity/snapshots/core_module_identity_npm_tagged_alias_rejected.md
@@ -0,0 +1,15 @@
+# core_module_identity_npm_tagged_alias_rejected
+
+## `vpt write-file package.json '{"name":"core-module-identity","private":true,"type":"module","packageManager":"npm@11.11.0","devDependencies":{"vite-plus":"latest","vite":"npm:@voidzero-dev/vite-plus-core@latest"}}
+'`
+
+
+## `vp install --ignore-scripts`
+
+
+## `node check-tagged-alias.mjs`
+
+```
+vp dev rejects the replaced npm alias and reports the repair command
+vp pack rejects the replaced npm alias and reports the repair command
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/core_module_identity/snapshots/core_module_identity_without_project_alias.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/core_module_identity/snapshots/core_module_identity_without_project_alias.md
index 121227e830..e6e7a495b4 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/core_module_identity/snapshots/core_module_identity_without_project_alias.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/core_module_identity/snapshots/core_module_identity_without_project_alias.md
@@ -60,7 +60,7 @@ VITE+ - The Unified Toolchain for the Web
  Test Files  1 passed (1)
       Tests  1 passed (1)
    Start at  <time>
-   Duration  <duration> (transform <duration>, setup <duration>, import <duration>, tests <duration>, environment <duration>)
+   Duration  <duration> (<timing>)
 ```
 
 ## `vp pack entry.js`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/install_yarn_corepack_hash/snapshots/install_yarn_corepack_hash.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/install_yarn_corepack_hash/snapshots/install_yarn_corepack_hash.md
index a54c1b3bc6..234c1708aa 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/install_yarn_corepack_hash/snapshots/install_yarn_corepack_hash.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/install_yarn_corepack_hash/snapshots/install_yarn_corepack_hash.md
@@ -27,7 +27,7 @@ VITE+ - The Unified Toolchain for the Web
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vpt stat-file $VP_HOME/package_manager/yarn/4.17.1/yarn/bin/yarn.js --assert file`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_agent_claude/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_agent_claude/package.json
index abe4023cd1..9e1c18d988 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_agent_claude/package.json
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_agent_claude/package.json
@@ -1,6 +1,6 @@
 {
   "name": "migration-agent-claude",
   "dependencies": {
-    "vitest": "^3.0.0"
+    "vitest": "^4.1.0"
   }
 }
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_from_vitest_config/snapshots/migration_from_vitest_config.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_from_vitest_config/snapshots/migration_from_vitest_config.md
index ca978ebabc..5710ade2d3 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_from_vitest_config/snapshots/migration_from_vitest_config.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_from_vitest_config/snapshots/migration_from_vitest_config.md
@@ -10,6 +10,12 @@ VITE+ - The Unified Toolchain for the Web
 ◇ Migrated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • 2 config updates applied, 1 file had imports rewritten
+! Warnings:
+  - Vitest v5: 1 review item
+
+vitest.config.ts
+  18:10 REVIEW [global-api-ownership] Resolve test.dir before migrating global APIs. The test discovery directory is not statically known.
+    Docs: https://viteplus.dev/guide/vitest-v5#resolve-migration-findings
 ```
 
 ## `vpt print-file vitest.config.ts`
@@ -23,15 +29,25 @@ import { foo } from '@foo/vite-plugin-foo';
 import { playwright } from 'vite-plus/test/browser-playwright';
 import { server } from 'vite-plus/test/browser/context';
 import { preview } from 'vite-plus/test/browser-preview';
-import { webdriverio } from 'vite-plus/test/browser-webdriverio';
+import { webdriverio } from '@vitest/browser-webdriverio';
 import { userEvent } from 'vite-plus/test/browser/context';
 import { defineConfig } from 'vite-plus';
 
 export default defineConfig({
   plugins: [foo()],
   test: {
+    // Vitest v4 compatibility: preserve mock call history.
+    // Remove after tests no longer rely on calls from setup or earlier tests.
+    // https://vitest.dev/guide/migration/#clearmocks-is-enabled-by-default
+    clearMocks: false,
     dir: join(import.meta.dirname, 'test'),
     browser: {
+      locators: {
+        // Vitest v4 compatibility: keep partial, case-insensitive locator matching.
+        // Remove after updating locators for full, case-sensitive matches.
+        // https://vitest.dev/guide/migration/#locators-are-strict-by-default
+        exact: false
+      },
       enabled: true,
       provider: playwright(),
       headless: true,
@@ -62,7 +78,7 @@ check package.json
     "@vitest/coverage-v8": "catalog:",
     "vite": "catalog:",
     "vitest": "catalog:",
-    "@vitest/browser-webdriverio": "catalog:",
+    "@vitest/browser-webdriverio": "^5.0.0",
     "webdriverio": "*",
     "playwright": "*",
     "vite-plus": "catalog:"
@@ -86,7 +102,6 @@ catalog:
   vite: npm:@voidzero-dev/vite-plus-core@<version>
   vitest: <version>
   vite-plus: <version>
-  '@vitest/browser-webdriverio': <version>
   '@vitest/browser-playwright': <version>
   '@vitest/coverage-v8': <version>
 allowBuilds:
@@ -95,6 +110,7 @@ allowBuilds:
 overrides:
   vite@*: 'catalog:'
   vitest@*: 'catalog:'
+  '@vitest/browser@*': 5.0.1
 peerDependencyRules:
   allowAny:
     - vite
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_merge_vite_config_ts/snapshots/migration_merge_vite_config_ts.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_merge_vite_config_ts/snapshots/migration_merge_vite_config_ts.md
index 93c54c83f6..1b5dbd0e67 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_merge_vite_config_ts/snapshots/migration_merge_vite_config_ts.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_merge_vite_config_ts/snapshots/migration_merge_vite_config_ts.md
@@ -11,6 +11,12 @@ VITE+ - The Unified Toolchain for the Web
 • Node <version>  pnpm <version>
 • 4 config updates applied, 1 file had imports rewritten
 • Inline Vite plugins wrapped with lazyPlugins for check/lint/fmt
+! Warnings:
+  - Vitest v5: 1 review item
+
+vite.config.ts
+  37:10 REVIEW [global-api-ownership] Resolve test.dir before migrating global APIs. The test discovery directory is not statically known.
+    Docs: https://viteplus.dev/guide/vitest-v5#resolve-migration-findings
 ```
 
 ## `vpt print-file vite.config.ts`
@@ -53,8 +59,18 @@ export default defineConfig({
   },
   plugins: lazyPlugins(() => [react()]),
   test: {
+    // Vitest v4 compatibility: preserve mock call history.
+    // Remove after tests no longer rely on calls from setup or earlier tests.
+    // https://vitest.dev/guide/migration/#clearmocks-is-enabled-by-default
+    clearMocks: false,
     dir: join(import.meta.dirname, 'test'),
     browser: {
+      locators: {
+        // Vitest v4 compatibility: keep partial, case-insensitive locator matching.
+        // Remove after updating locators for full, case-sensitive matches.
+        // https://vitest.dev/guide/migration/#locators-are-strict-by-default
+        exact: false
+      },
       enabled: true,
       provider: playwright(),
       headless: true,
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_bun/snapshots/migration_monorepo_bun.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_bun/snapshots/migration_monorepo_bun.md
index 7a02ce2eb8..fa6245c432 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_bun/snapshots/migration_monorepo_bun.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_bun/snapshots/migration_monorepo_bun.md
@@ -43,6 +43,12 @@ export default defineConfig({
       }
     ]
   },
+  test: {
+    // Vitest v4 compatibility: preserve mock call history.
+    // Remove after tests no longer rely on calls from setup or earlier tests.
+    // https://vitest.dev/guide/migration/#clearmocks-is-enabled-by-default
+    clearMocks: false
+  },
   plugins: lazyPlugins(() => [react()]),
 });
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_pnpm/snapshots/migration_monorepo_pnpm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_pnpm/snapshots/migration_monorepo_pnpm.md
index ffbf239a39..16e847a525 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_pnpm/snapshots/migration_monorepo_pnpm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_pnpm/snapshots/migration_monorepo_pnpm.md
@@ -51,6 +51,12 @@ export default defineConfig({
       }
     ]
   },
+  test: {
+    // Vitest v4 compatibility: preserve mock call history.
+    // Remove after tests no longer rely on calls from setup or earlier tests.
+    // https://vitest.dev/guide/migration/#clearmocks-is-enabled-by-default
+    clearMocks: false
+  },
   plugins: lazyPlugins(() => [react()]),
 });
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_root_vitest_adjacent/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_root_vitest_adjacent/snapshots.toml
index 6277bbdcf3..ef55410659 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_root_vitest_adjacent/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_root_vitest_adjacent/snapshots.toml
@@ -2,6 +2,7 @@
 name = "migration_monorepo_root_vitest_adjacent"
 vp = "global"
 steps = [
+  { argv = ["vpt", "write-file", "node_modules/vitest/package.json", "{\"name\":\"vitest\",\"version\":\"4.1.11\"}"], comment = "record the original runner version without adding a direct dependency", snapshot = false },
   { argv = ["vp", "migrate", "--no-interactive"], comment = "root with a vitest-adjacent dep but no direct vitest still gets a direct vitest pin", continue-on-failure = true },
   { argv = ["vpt", "print-file", "package.json"], comment = "vitest pinned at the root even though vite-plus is injected first", continue-on-failure = true },
 ]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_root_vitest_adjacent/snapshots/migration_monorepo_root_vitest_adjacent.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_root_vitest_adjacent/snapshots/migration_monorepo_root_vitest_adjacent.md
index 568c949547..1852986697 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_root_vitest_adjacent/snapshots/migration_monorepo_root_vitest_adjacent.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_root_vitest_adjacent/snapshots/migration_monorepo_root_vitest_adjacent.md
@@ -1,5 +1,10 @@
 # migration_monorepo_root_vitest_adjacent
 
+## `vpt write-file node_modules/vitest/package.json '{"name":"vitest","version":"4.1.11"}'`
+
+record the original runner version without adding a direct dependency
+
+
 ## `vp migrate --no-interactive`
 
 root with a vitest-adjacent dep but no direct vitest still gets a direct vitest pin
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_skip_vite_peer_dependency/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_skip_vite_peer_dependency/snapshots.toml
index 3551495224..ad2c569fca 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_skip_vite_peer_dependency/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_skip_vite_peer_dependency/snapshots.toml
@@ -2,6 +2,7 @@
 name = "migration_monorepo_skip_vite_peer_dependency"
 vp = "global"
 steps = [
+  { argv = ["vpt", "write-file", "node_modules/vitest/package.json", "{\"name\":\"vitest\",\"version\":\"4.1.11\"}"], comment = "record the original runner version without adding a direct dependency", snapshot = false },
   { argv = ["vp", "migrate", "--no-interactive"], comment = "migration should preserve vite peer contracts in workspace packages", continue-on-failure = true },
   { argv = ["vpt", "print-file", "packages/vite-plugin/src/index.ts"], comment = "vite-plugin has vite in peerDeps: vite imports stay public, vitest rewrites", continue-on-failure = true },
   { argv = ["vpt", "print-file", "package.json"], comment = "check root package.json (no peerDependencies)", continue-on-failure = true },
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_skip_vite_peer_dependency/snapshots/migration_monorepo_skip_vite_peer_dependency.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_skip_vite_peer_dependency/snapshots/migration_monorepo_skip_vite_peer_dependency.md
index aa2b4ee2d9..36cdecafd8 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_skip_vite_peer_dependency/snapshots/migration_monorepo_skip_vite_peer_dependency.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_skip_vite_peer_dependency/snapshots/migration_monorepo_skip_vite_peer_dependency.md
@@ -1,5 +1,10 @@
 # migration_monorepo_skip_vite_peer_dependency
 
+## `vpt write-file node_modules/vitest/package.json '{"name":"vitest","version":"4.1.11"}'`
+
+record the original runner version without adding a direct dependency
+
+
 ## `vp migrate --no-interactive`
 
 migration should preserve vite peer contracts in workspace packages
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_yarn4/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_yarn4/snapshots.toml
index b24d023fbc..024fe3aebb 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_yarn4/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_yarn4/snapshots.toml
@@ -2,6 +2,7 @@
 name = "migration_monorepo_yarn4"
 vp = "global"
 steps = [
+  { argv = ["vpt", "write-file", "node_modules/vitest/package.json", "{\"name\":\"vitest\",\"version\":\"4.1.11\"}"], comment = "record the original runner version without adding a direct dependency", snapshot = false },
   { argv = ["vp", "migrate", "--no-interactive"], comment = "migration should merge vite.config.ts and remove oxlintrc", continue-on-failure = true },
   { argv = ["vpt", "print-file", "vite.config.ts"], comment = "check vite.config.ts", continue-on-failure = true },
   { argv = ["vpt", "stat-file", ".oxlintrc.json", "--assert-not", "file"], comment = "check .oxlintrc.json is removed", continue-on-failure = true },
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_yarn4/snapshots/migration_monorepo_yarn4.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_yarn4/snapshots/migration_monorepo_yarn4.md
index 2427b17e57..7147961c64 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_yarn4/snapshots/migration_monorepo_yarn4.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_yarn4/snapshots/migration_monorepo_yarn4.md
@@ -1,5 +1,10 @@
 # migration_monorepo_yarn4
 
+## `vpt write-file node_modules/vitest/package.json '{"name":"vitest","version":"4.1.11"}'`
+
+record the original runner version without adding a direct dependency
+
+
 ## `vp migrate --no-interactive`
 
 migration should merge vite.config.ts and remove oxlintrc
@@ -48,6 +53,12 @@ export default defineConfig({
       }
     ]
   },
+  test: {
+    // Vitest v4 compatibility: preserve mock call history.
+    // Remove after tests no longer rely on calls from setup or earlier tests.
+    // https://vitest.dev/guide/migration/#clearmocks-is-enabled-by-default
+    clearMocks: false
+  },
   plugins: lazyPlugins(() => [react()]),
 });
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_no_agent/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_no_agent/package.json
index 58151f5f0a..a810147949 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_no_agent/package.json
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_no_agent/package.json
@@ -1,6 +1,6 @@
 {
   "name": "migration-no-agent",
   "dependencies": {
-    "vitest": "^3.0.0"
+    "vitest": "^4.1.0"
   }
 }
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_not_supported_vitest3/snapshots/migration_not_supported_vitest3.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_not_supported_vitest3/snapshots/migration_not_supported_vitest3.md
index 13e484183e..f6293ac062 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_not_supported_vitest3/snapshots/migration_not_supported_vitest3.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_not_supported_vitest3/snapshots/migration_not_supported_vitest3.md
@@ -14,10 +14,12 @@ migration should fail because vitest version is not supported
 ```
 VITE+ - The Unified Toolchain for the Web
 
-✘ vitest@3.2.4 in package.json is not supported by auto migration
+Vitest v5: 1 review item (1 block dependency updates)
 
-Please upgrade vitest to version >=4.0.0 first
-Vite+ cannot automatically migrate this project yet.
+package.json
+  1:1 BLOCK [source-version] Upgrade the original project to Vitest 4 before running this migration.
+    Docs: https://viteplus.dev/guide/vitest-v5#before-you-migrate
+Resolve the blocking Vitest v5 findings, then re-run `vp migrate`. No project files were changed.
 ```
 
 ## `vpt print-file package.json`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc/.nvmrc b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc/.nvmrc
index d7fd7cd552..c519bf5baa 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc/.nvmrc
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc/.nvmrc
@@ -1 +1 @@
-v25.8.2
+v24.11.0
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc/snapshots/migration_nvmrc.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc/snapshots/migration_nvmrc.md
index 52016a7ea3..a45814eb79 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc/snapshots/migration_nvmrc.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc/snapshots/migration_nvmrc.md
@@ -18,7 +18,7 @@ VITE+ - The Unified Toolchain for the Web
 check .node-version is created with v prefix stripped
 
 ```
-25.8.2
+24.11.0
 ```
 
 ## `vpt stat-file .nvmrc --assert-not file`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc_lts/snapshots/migration_nvmrc_lts.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc_lts/snapshots/migration_nvmrc_lts.md
index 980c299d10..c76ae3d7fb 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc_lts/snapshots/migration_nvmrc_lts.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc_lts/snapshots/migration_nvmrc_lts.md
@@ -11,6 +11,12 @@ VITE+ - The Unified Toolchain for the Web
 • Node <version>  pnpm <version>
 • 2 config updates applied
 • Node version manager file migrated to .node-version
+! Warnings:
+  - Vitest v5: 1 review item
+
+.node-version
+  1:1 REVIEW [node-runtime] Resolve .node-version (lts/iron) and select Node ^22.18.0 || ^24.11.0 || >=26.0.0.
+    Docs: https://viteplus.dev/guide/vitest-v5#node-runtime
 ```
 
 ## `vpt print-file .node-version`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_preserve_below_policy_node_pins/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_preserve_below_policy_node_pins/snapshots.toml
index 697fa1ae73..03ef6cdb31 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_preserve_below_policy_node_pins/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_preserve_below_policy_node_pins/snapshots.toml
@@ -2,8 +2,9 @@
 name = "migration_preserve_below_policy_node_pins"
 vp = "global"
 steps = [
-  { argv = ["vp", "migrate", "--no-interactive"], comment = "existing Vite+ project: a Node pin below the supported range is preserved, not raised (native binding supports Node >=20)", continue-on-failure = true },
-  { argv = ["vpt", "print-file", ".node-version"], comment = "stays 24.3.0", continue-on-failure = true },
+  { argv = ["vp", "migrate", "--no-interactive"], comment = "upgrade the incompatible runtime pin without changing the public engine contract" },
+  { argv = ["vpt", "print-file", ".node-version"], comment = "upgraded from 24.3.0 to 24.11.0" },
   { argv = ["vpt", "print-file", "package.json"], comment = "engines.node stays 24.x and devEngines.runtime node stays ^24 (preserved, not raised)", continue-on-failure = true },
-  { argv = ["vpt", "print-file", "pnpm-workspace.yaml"], comment = "vite-stack catalog updated to the migration target", continue-on-failure = true },
+  { argv = ["vpt", "print-file", "pnpm-workspace.yaml"], comment = "catalog is migrated" },
+  { argv = ["vp", "migrate", "--no-interactive"], comment = "rerun preserves the upgraded runtime and public engine contract" },
 ]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_preserve_below_policy_node_pins/snapshots/migration_preserve_below_policy_node_pins.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_preserve_below_policy_node_pins/snapshots/migration_preserve_below_policy_node_pins.md
index 12d3b03dcb..2ad8880f7e 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_preserve_below_policy_node_pins/snapshots/migration_preserve_below_policy_node_pins.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_preserve_below_policy_node_pins/snapshots/migration_preserve_below_policy_node_pins.md
@@ -2,7 +2,7 @@
 
 ## `vp migrate --no-interactive`
 
-existing Vite+ project: a Node pin below the supported range is preserved, not raised (native binding supports Node >=20)
+upgrade the incompatible runtime pin without changing the public engine contract
 
 ```
 VITE+ - The Unified Toolchain for the Web
@@ -17,10 +17,10 @@ VITE+ - The Unified Toolchain for the Web
 
 ## `vpt print-file .node-version`
 
-stays 24.3.0
+upgraded from 24.3.0 to 24.11.0
 
 ```
-24.3.0
+24.11.0
 ```
 
 ## `vpt print-file package.json`
@@ -55,7 +55,7 @@ engines.node stays 24.x and devEngines.runtime node stays ^24 (preserved, not ra
 
 ## `vpt print-file pnpm-workspace.yaml`
 
-vite-stack catalog updated to the migration target
+catalog is migrated
 
 ```
 packages:
@@ -73,3 +73,13 @@ peerDependencyRules:
   allowedVersions:
     vite: '*'
 ```
+
+## `vp migrate --no-interactive`
+
+rerun preserves the upgraded runtime and public engine contract
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_declare_module/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_declare_module/snapshots.toml
index 6925688aca..702fe11fcd 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_declare_module/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_declare_module/snapshots.toml
@@ -2,6 +2,7 @@
 name = "migration_rewrite_declare_module"
 vp = "global"
 steps = [
+  { argv = ["vpt", "write-file", "node_modules/vitest/package.json", "{\"name\":\"vitest\",\"version\":\"4.1.11\"}"], comment = "record the original runner version without adding a direct dependency", snapshot = false },
   { argv = ["vp", "migrate", "--no-interactive"], comment = "retained vitest augmentations should keep a package-local vitest", continue-on-failure = true },
   { argv = ["vpt", "print-file", "src/index.ts"], comment = "declare module 'vite'/'vitest' outside config files are preserved: through the core alias a 'vite' augmentation reaches the UserConfig that types vite-plus defineConfig, while vite-plus exports no UserConfig symbol to merge a rewritten augmentation with", continue-on-failure = true },
   { argv = ["vpt", "print-file", "package.json"], comment = "check package.json", continue-on-failure = true },
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_declare_module/snapshots/migration_rewrite_declare_module.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_declare_module/snapshots/migration_rewrite_declare_module.md
index f3c4113b66..9a883aeb93 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_declare_module/snapshots/migration_rewrite_declare_module.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_declare_module/snapshots/migration_rewrite_declare_module.md
@@ -1,5 +1,10 @@
 # migration_rewrite_declare_module
 
+## `vpt write-file node_modules/vitest/package.json '{"name":"vitest","version":"4.1.11"}'`
+
+record the original runner version without adding a direct dependency
+
+
 ## `vp migrate --no-interactive`
 
 retained vitest augmentations should keep a package-local vitest
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_reference_types/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_reference_types/package.json
index bacbc28e4e..5f6c39340a 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_reference_types/package.json
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_reference_types/package.json
@@ -2,6 +2,6 @@
   "name": "migration-rewrite-reference-types",
   "devDependencies": {
     "vite": "^6.0.0",
-    "vitest": "^3.0.0"
+    "vitest": "^4.1.0"
   }
 }
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_dependency/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_dependency/snapshots.toml
index 57e698ea19..ff9c166fb5 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_dependency/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_dependency/snapshots.toml
@@ -2,6 +2,7 @@
 name = "migration_skip_vite_dependency"
 vp = "global"
 steps = [
+  { argv = ["vpt", "write-file", "node_modules/vitest/package.json", "{\"name\":\"vitest\",\"version\":\"4.1.11\"}"], comment = "record the original runner version without adding a direct dependency", snapshot = false },
   { argv = ["vp", "migrate", "--no-interactive"], comment = "migration should skip rewriting vite imports when vite is in dependencies", continue-on-failure = true },
   { argv = ["vpt", "print-file", "src/index.ts"], comment = "vite imports should NOT be rewritten, vitest imports SHOULD be rewritten", continue-on-failure = true },
   { argv = ["vpt", "print-file", "package.json"], comment = "check package.json", continue-on-failure = true },
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_dependency/snapshots/migration_skip_vite_dependency.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_dependency/snapshots/migration_skip_vite_dependency.md
index 9663a94770..ef7df6b375 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_dependency/snapshots/migration_skip_vite_dependency.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_dependency/snapshots/migration_skip_vite_dependency.md
@@ -1,5 +1,10 @@
 # migration_skip_vite_dependency
 
+## `vpt write-file node_modules/vitest/package.json '{"name":"vitest","version":"4.1.11"}'`
+
+record the original runner version without adding a direct dependency
+
+
 ## `vp migrate --no-interactive`
 
 migration should skip rewriting vite imports when vite is in dependencies
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_peer_dependency/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_peer_dependency/snapshots.toml
index 45f4bd7dda..a8d3af4afc 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_peer_dependency/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_peer_dependency/snapshots.toml
@@ -2,6 +2,7 @@
 name = "migration_skip_vite_peer_dependency"
 vp = "global"
 steps = [
+  { argv = ["vpt", "write-file", "node_modules/vitest/package.json", "{\"name\":\"vitest\",\"version\":\"4.1.11\"}"], comment = "record the original runner version without adding a direct dependency", snapshot = false },
   { argv = ["vp", "migrate", "--no-interactive"], comment = "migration should preserve vite peer contracts", continue-on-failure = true },
   { argv = ["vpt", "print-file", "src/index.ts"], comment = "vite imports stay public, vitest imports rewrite", continue-on-failure = true },
   { argv = ["vpt", "print-file", "package.json"], comment = "vite peer range is preserved", continue-on-failure = true },
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_peer_dependency/snapshots/migration_skip_vite_peer_dependency.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_peer_dependency/snapshots/migration_skip_vite_peer_dependency.md
index 8ace240699..f1797f5aeb 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_peer_dependency/snapshots/migration_skip_vite_peer_dependency.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_peer_dependency/snapshots/migration_skip_vite_peer_dependency.md
@@ -1,5 +1,10 @@
 # migration_skip_vite_peer_dependency
 
+## `vpt write-file node_modules/vitest/package.json '{"name":"vitest","version":"4.1.11"}'`
+
+record the original runner version without adding a direct dependency
+
+
 ## `vp migrate --no-interactive`
 
 migration should preserve vite peer contracts
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_source_only_pnpm/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_source_only_pnpm/snapshots.toml
index 5fcc933381..a5b5034a56 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_source_only_pnpm/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_source_only_pnpm/snapshots.toml
@@ -2,6 +2,7 @@
 name = "migration_upgrade_browser_source_only_pnpm"
 vp = "global"
 steps = [
+  { argv = ["vpt", "write-file", "node_modules/vitest/package.json", "{\"name\":\"vitest\",\"version\":\"4.1.11\"}"], comment = "record the original runner version without adding a direct dependency", snapshot = false },
   { argv = ["vp", "migrate", "--no-interactive"], comment = "source-only browser provider should be restored", continue-on-failure = true },
   { argv = ["vpt", "print-file", "package.json"], comment = "provider, framework peer, and local vitest should be present", continue-on-failure = true },
   { argv = ["vpt", "print-file", "pnpm-workspace.yaml"], comment = "shared vitest catalog and override should be present", continue-on-failure = true },
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_source_only_pnpm/snapshots/migration_upgrade_browser_source_only_pnpm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_source_only_pnpm/snapshots/migration_upgrade_browser_source_only_pnpm.md
index 9f857f2cc1..cde2d633da 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_source_only_pnpm/snapshots/migration_upgrade_browser_source_only_pnpm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_source_only_pnpm/snapshots/migration_upgrade_browser_source_only_pnpm.md
@@ -1,5 +1,10 @@
 # migration_upgrade_browser_source_only_pnpm
 
+## `vpt write-file node_modules/vitest/package.json '{"name":"vitest","version":"4.1.11"}'`
+
+record the original runner version without adding a direct dependency
+
+
 ## `vp migrate --no-interactive`
 
 source-only browser provider should be restored
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_webdriverio_pnpm/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_webdriverio_pnpm/snapshots.toml
index ae1ea23cc3..14463021af 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_webdriverio_pnpm/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_webdriverio_pnpm/snapshots.toml
@@ -2,7 +2,48 @@
 name = "migration_upgrade_browser_webdriverio_pnpm"
 vp = "global"
 steps = [
-  { argv = ["vp", "migrate", "--no-interactive"], comment = "source-only WebdriverIO provider should be restored", continue-on-failure = true },
-  { argv = ["vpt", "print-file", "package.json"], comment = "provider, webdriverio, and local vitest should be present", continue-on-failure = true },
+  { argv = ["vpt", "write-file", "node_modules/vitest/package.json", "{\"name\":\"vitest\",\"version\":\"4.1.11\"}"], comment = "record the original runner version without adding a direct dependency", snapshot = false },
+  { argv = ["vp", "migrate", "--no-interactive"], comment = "restore the community import and install a v5 provider", continue-on-failure = true },
+  { argv = ["vpt", "print-file", "package.json"], comment = "ensure the provider and its framework peer are declared", continue-on-failure = true },
+  { argv = ["vpt", "print-file", "vite.config.ts"], comment = "legacy Vite+ provider import points to the community package", continue-on-failure = true },
   { argv = ["vpt", "print-file", "pnpm-workspace.yaml"], comment = "driver builds and shared vitest should be enabled", continue-on-failure = true },
 ]
+
+[[case]]
+name = "preserve_community_provider_version"
+vp = "global"
+steps = [
+  { argv = ["vpt", "write-file", "node_modules/vitest/package.json", "{\"name\":\"vitest\",\"version\":\"4.1.11\"}"], snapshot = false },
+  { argv = ["vpt", "json-edit", "package.json", "devDependencies.@vitest/browser-webdriverio", "^5.0.0"], snapshot = false },
+  ["vp", "migrate", "--no-interactive"],
+  ["vpt", "print-file", "package.json"],
+  ["vpt", "print-file", "vite.config.ts"],
+  ["vp", "migrate", "--no-interactive"],
+]
+
+[[case]]
+name = "upgrade_community_provider_catalog"
+vp = "global"
+steps = [
+  { argv = ["vpt", "write-file", "node_modules/vitest/package.json", "{\"name\":\"vitest\",\"version\":\"4.1.11\"}"], snapshot = false },
+  { argv = ["vpt", "json-edit", "package.json", "devDependencies.@vitest/browser-webdriverio", "catalog:browser"], snapshot = false },
+  { argv = ["vpt", "json-edit", "package.json", "devDependencies.webdriverio", "^9.20.0"], snapshot = false },
+  { argv = ["vpt", "write-file", "pnpm-workspace.yaml", "catalog:\n  vite: npm:@voidzero-dev/vite-plus-core@latest\n  vite-plus: latest\ncatalogs:\n  browser:\n    '@vitest/browser-webdriverio': ^4.1.11\noverrides:\n  vite: 'catalog:'\n  '@vitest/browser-webdriverio': 4.1.11\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive"],
+  ["vpt", "print-file", "package.json"],
+  ["vpt", "print-file", "pnpm-workspace.yaml"],
+  ["vp", "migrate", "--no-interactive"],
+]
+
+[[case]]
+name = "migrate_vitest4_community_provider"
+vp = "global"
+steps = [
+  { argv = ["vpt", "write-file", "package.json", "{\"name\":\"vitest4-browser\",\"private\":true,\"type\":\"module\",\"packageManager\":\"pnpm@10.33.0\",\"devDependencies\":{\"vitest\":\"4.1.11\",\"@vitest/browser-webdriverio\":\"4.1.11\",\"webdriverio\":\"^9.20.0\"}}"], snapshot = false },
+  { argv = ["vpt", "write-file", "vite.config.ts", "import { defineConfig } from 'vitest/config';\nimport { webdriverio } from '@vitest/browser-webdriverio';\nexport default defineConfig({ test: { browser: { enabled: true, provider: webdriverio(), instances: [{ browser: 'chrome' }] } } });\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "package.json"],
+  ["vpt", "print-file", "vite.config.ts"],
+  { argv = ["vpt", "write-file", "node_modules/vitest/package.json", "{\"name\":\"vitest\",\"version\":\"5.0.1\"}"], comment = "simulate the upgraded runner because snapshot fixtures skip install", snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_webdriverio_pnpm/snapshots/migrate_vitest4_community_provider.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_webdriverio_pnpm/snapshots/migrate_vitest4_community_provider.md
new file mode 100644
index 0000000000..0f33615937
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_webdriverio_pnpm/snapshots/migrate_vitest4_community_provider.md
@@ -0,0 +1,63 @@
+# migrate_vitest4_community_provider
+
+## `vpt write-file package.json '{"name":"vitest4-browser","private":true,"type":"module","packageManager":"pnpm@10.33.0","devDependencies":{"vitest":"4.1.11","@vitest/browser-webdriverio":"4.1.11","webdriverio":"^9.20.0"}}'`
+
+
+## `vpt write-file vite.config.ts 'import { defineConfig } from '\''vitest/config'\'';
+import { webdriverio } from '\''@vitest/browser-webdriverio'\'';
+export default defineConfig({ test: { browser: { enabled: true, provider: webdriverio(), instances: [{ browser: '\''chrome'\'' }] } } });
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 1 file had imports rewritten
+```
+
+## `vpt print-file package.json`
+
+```
+{"name":"vitest4-browser","private":true,"type":"module","packageManager":"pnpm@10.33.0","devDependencies":{"vite":"catalog:","vitest":"catalog:","@vitest/browser-webdriverio":"^5.0.0","webdriverio":"^9.20.0","vite-plus":"catalog:"}}
+```
+
+## `vpt print-file vite.config.ts`
+
+```
+import { defineConfig } from 'vite-plus';
+import { webdriverio } from '@vitest/browser-webdriverio';
+export default defineConfig({
+  fmt: {},
+  lint: {"jsPlugins":[{"name":"vite-plus","specifier":"vite-plus/oxlint-plugin"}],"rules":{"vite-plus/prefer-vite-plus-imports":"error"},"options":{"typeAware":true,"typeCheck":true}},
+  test: {
+      // Vitest v4 compatibility: preserve mock call history.
+      // Remove after tests no longer rely on calls from setup or earlier tests.
+      // https://vitest.dev/guide/migration/#clearmocks-is-enabled-by-default
+      clearMocks: false,
+      browser: {
+        locators: {
+          // Vitest v4 compatibility: keep partial, case-insensitive locator matching.
+          // Remove after updating locators for full, case-sensitive matches.
+          // https://vitest.dev/guide/migration/#locators-are-strict-by-default
+          exact: false
+        },
+        enabled: true, provider: webdriverio(), instances: [{ browser: 'chrome' }] } }
+});
+```
+
+## `vpt write-file node_modules/vitest/package.json '{"name":"vitest","version":"5.0.1"}'`
+
+simulate the upgraded runner because snapshot fixtures skip install
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_webdriverio_pnpm/snapshots/migration_upgrade_browser_webdriverio_pnpm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_webdriverio_pnpm/snapshots/migration_upgrade_browser_webdriverio_pnpm.md
index fdf43408bc..9e5e9131a1 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_webdriverio_pnpm/snapshots/migration_upgrade_browser_webdriverio_pnpm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_webdriverio_pnpm/snapshots/migration_upgrade_browser_webdriverio_pnpm.md
@@ -1,8 +1,13 @@
 # migration_upgrade_browser_webdriverio_pnpm
 
+## `vpt write-file node_modules/vitest/package.json '{"name":"vitest","version":"4.1.11"}'`
+
+record the original runner version without adding a direct dependency
+
+
 ## `vp migrate --no-interactive`
 
-source-only WebdriverIO provider should be restored
+restore the community import and install a v5 provider
 
 ```
 VITE+ - The Unified Toolchain for the Web
@@ -12,12 +17,13 @@ VITE+ - The Unified Toolchain for the Web
 • Dependencies:
     vite-plus  latest → <version>
     vite              → <version>
+• 1 file had imports rewritten
 • Package manager settings configured
 ```
 
 ## `vpt print-file package.json`
 
-provider, webdriverio, and local vitest should be present
+ensure the provider and its framework peer are declared
 
 ```
 {
@@ -25,9 +31,9 @@ provider, webdriverio, and local vitest should be present
   "devDependencies": {
     "vite": "catalog:",
     "vite-plus": "catalog:",
-    "@vitest/browser-webdriverio": "catalog:",
-    "webdriverio": "*",
-    "vitest": "catalog:"
+    "vitest": "catalog:",
+    "@vitest/browser-webdriverio": "^5.0.0",
+    "webdriverio": "*"
   },
   "devEngines": {
     "packageManager": {
@@ -39,6 +45,24 @@ provider, webdriverio, and local vitest should be present
 }
 ```
 
+## `vpt print-file vite.config.ts`
+
+legacy Vite+ provider import points to the community package
+
+```
+import { defineConfig } from 'vite-plus';
+import { webdriverio } from '@vitest/browser-webdriverio';
+
+export default defineConfig({
+  test: {
+    browser: {
+      enabled: true,
+      provider: webdriverio(),
+    },
+  },
+});
+```
+
 ## `vpt print-file pnpm-workspace.yaml`
 
 driver builds and shared vitest should be enabled
@@ -48,10 +72,10 @@ catalog:
   vite: npm:@voidzero-dev/vite-plus-core@<version>
   vite-plus: <version>
   vitest: <version>
-  '@vitest/browser-webdriverio': <version>
 overrides:
   vite@*: 'catalog:'
   vitest@*: 'catalog:'
+  '@vitest/browser@*': 5.0.1
 peerDependencyRules:
   allowAny:
     - vite
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_webdriverio_pnpm/snapshots/preserve_community_provider_version.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_webdriverio_pnpm/snapshots/preserve_community_provider_version.md
new file mode 100644
index 0000000000..4054277a36
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_webdriverio_pnpm/snapshots/preserve_community_provider_version.md
@@ -0,0 +1,67 @@
+# preserve_community_provider_version
+
+## `vpt write-file node_modules/vitest/package.json '{"name":"vitest","version":"4.1.11"}'`
+
+
+## `vpt json-edit package.json devDependencies.@vitest/browser-webdriverio ^5.0.0`
+
+
+## `vp migrate --no-interactive`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Updated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• Dependencies:
+    vite-plus  latest → <version>
+    vite              → <version>
+• 1 file had imports rewritten
+• Package manager settings configured
+```
+
+## `vpt print-file package.json`
+
+```
+{
+  "devDependencies": {
+    "@vitest/browser-webdriverio": "^5.0.0",
+    "vite": "catalog:",
+    "vite-plus": "catalog:",
+    "vitest": "catalog:",
+    "webdriverio": "*"
+  },
+  "devEngines": {
+    "packageManager": {
+      "name": "pnpm",
+      "onFail": "download",
+      "version": "10.33.0"
+    }
+  },
+  "name": "migration-upgrade-browser-webdriverio-pnpm"
+}
+```
+
+## `vpt print-file vite.config.ts`
+
+```
+import { defineConfig } from 'vite-plus';
+import { webdriverio } from '@vitest/browser-webdriverio';
+
+export default defineConfig({
+  test: {
+    browser: {
+      enabled: true,
+      provider: webdriverio(),
+    },
+  },
+});
+```
+
+## `vp migrate --no-interactive`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_webdriverio_pnpm/snapshots/upgrade_community_provider_catalog.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_webdriverio_pnpm/snapshots/upgrade_community_provider_catalog.md
new file mode 100644
index 0000000000..0e41732c02
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_webdriverio_pnpm/snapshots/upgrade_community_provider_catalog.md
@@ -0,0 +1,92 @@
+# upgrade_community_provider_catalog
+
+## `vpt write-file node_modules/vitest/package.json '{"name":"vitest","version":"4.1.11"}'`
+
+
+## `vpt json-edit package.json devDependencies.@vitest/browser-webdriverio catalog:browser`
+
+
+## `vpt json-edit package.json devDependencies.webdriverio ^9.20.0`
+
+
+## `vpt write-file pnpm-workspace.yaml 'catalog:
+  vite: npm:@voidzero-dev/vite-plus-core@latest
+  vite-plus: latest
+catalogs:
+  browser:
+    '\''@vitest/browser-webdriverio'\'': ^4.1.11
+overrides:
+  vite: '\''catalog:'\''
+  '\''@vitest/browser-webdriverio'\'': 4.1.11
+'`
+
+
+## `vp migrate --no-interactive`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Updated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• Dependencies:
+    vite-plus  latest → <version>
+    vite              → <version>
+• 1 file had imports rewritten
+• Package manager settings configured
+```
+
+## `vpt print-file package.json`
+
+```
+{
+  "devDependencies": {
+    "@vitest/browser-webdriverio": "catalog:browser",
+    "vite": "catalog:",
+    "vite-plus": "catalog:",
+    "webdriverio": "^9.20.0",
+    "vitest": "catalog:"
+  },
+  "devEngines": {
+    "packageManager": {
+      "name": "pnpm",
+      "onFail": "download",
+      "version": "10.33.0"
+    }
+  },
+  "name": "migration-upgrade-browser-webdriverio-pnpm"
+}
+```
+
+## `vpt print-file pnpm-workspace.yaml`
+
+```
+catalog:
+  vite: npm:@voidzero-dev/vite-plus-core@<version>
+  vite-plus: <version>
+  vitest: <version>
+catalogs:
+  browser:
+    '@vitest/browser-webdriverio': ^5.0.0
+overrides:
+  vite@*: 'catalog:'
+  vitest@*: 'catalog:'
+  '@vitest/browser@*': 5.0.1
+allowBuilds:
+  edgedriver: true
+  geckodriver: true
+peerDependencyRules:
+  allowAny:
+    - vite
+    - vitest
+  allowedVersions:
+    vite: '*'
+    vitest: '*'
+```
+
+## `vp migrate --no-interactive`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_hooks_flag_pnpm/.nvmrc b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_hooks_flag_pnpm/.nvmrc
index 5bd6811705..0a492611a0 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_hooks_flag_pnpm/.nvmrc
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_hooks_flag_pnpm/.nvmrc
@@ -1 +1 @@
-20.19.0
+24.11.0
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pkg_pr_new_npm/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pkg_pr_new_npm/snapshots.toml
index 2cac60d5fb..bcbbc6553f 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pkg_pr_new_npm/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pkg_pr_new_npm/snapshots.toml
@@ -1,7 +1,7 @@
 [[case]]
 name = "migration_upgrade_pkg_pr_new_npm"
 vp = "global"
-env = { VP_OVERRIDE_PACKAGES = "{\"vite\":\"npm:@voidzero-dev/vite-plus-core@0.0.0-commit.0c515e3fbf5c140db35280d700df0bd600838617\",\"vitest\":\"4.1.10\"}", VP_VERSION = "0.0.0-commit.0c515e3fbf5c140db35280d700df0bd600838617" }
+env = { VP_OVERRIDE_PACKAGES = "{\"vite\":\"npm:@voidzero-dev/vite-plus-core@0.0.0-commit.0c515e3fbf5c140db35280d700df0bd600838617\",\"vitest\":\"5.0.0\"}", VP_VERSION = "0.0.0-commit.0c515e3fbf5c140db35280d700df0bd600838617" }
 steps = [
   { argv = ["vp", "migrate", "--no-interactive"], comment = "bridge commit builds replace every stale managed spec", continue-on-failure = true },
   { argv = ["vpt", "print-file", "package.json"], comment = "direct dependencies and npm overrides use the same immutable commit version", continue-on-failure = true },
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pkg_pr_new_pnpm/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pkg_pr_new_pnpm/snapshots.toml
index 195da5bf86..9c44fb93df 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pkg_pr_new_pnpm/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pkg_pr_new_pnpm/snapshots.toml
@@ -1,7 +1,7 @@
 [[case]]
 name = "migration_upgrade_pkg_pr_new_pnpm"
 vp = "global"
-env = { VP_OVERRIDE_PACKAGES = "{\"vite\":\"npm:@voidzero-dev/vite-plus-core@0.0.0-commit.0c515e3fbf5c140db35280d700df0bd600838617\",\"vitest\":\"4.1.10\"}", VP_VERSION = "0.0.0-commit.0c515e3fbf5c140db35280d700df0bd600838617" }
+env = { VP_OVERRIDE_PACKAGES = "{\"vite\":\"npm:@voidzero-dev/vite-plus-core@0.0.0-commit.0c515e3fbf5c140db35280d700df0bd600838617\",\"vitest\":\"5.0.0\"}", VP_VERSION = "0.0.0-commit.0c515e3fbf5c140db35280d700df0bd600838617" }
 steps = [
   { argv = ["vp", "migrate", "--no-interactive"], comment = "bridge commit builds upgrade like an ordinary npm version", continue-on-failure = true },
   { argv = ["vpt", "print-file", "package.json"], comment = "direct dependencies use catalogs aligned to the bridge build", continue-on-failure = true },
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pnpm9_overrides/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pnpm9_overrides/snapshots.toml
index 2dd891519b..f936f856c5 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pnpm9_overrides/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pnpm9_overrides/snapshots.toml
@@ -1,7 +1,7 @@
 [[case]]
 name = "migration_upgrade_pnpm9_overrides"
 vp = "global"
-env = { VP_OVERRIDE_PACKAGES = "{\"vite\":\"npm:@voidzero-dev/vite-plus-core@0.0.0-commit.0c515e3fbf5c140db35280d700df0bd600838617\",\"vitest\":\"4.1.10\"}", VP_VERSION = "0.0.0-commit.0c515e3fbf5c140db35280d700df0bd600838617" }
+env = { VP_OVERRIDE_PACKAGES = "{\"vite\":\"npm:@voidzero-dev/vite-plus-core@0.0.0-commit.0c515e3fbf5c140db35280d700df0bd600838617\",\"vitest\":\"5.0.0\"}", VP_VERSION = "0.0.0-commit.0c515e3fbf5c140db35280d700df0bd600838617" }
 steps = [
   { argv = ["vp", "migrate", "--no-interactive"], comment = "pnpm 9.5-10.6.1: settings stay in package.json, catalog is still rewritten off the wrappers", continue-on-failure = true },
   { argv = ["vpt", "print-file", "package.json"], comment = "pnpm.overrides stay catalog: (not inlined to a version)", continue-on-failure = true },
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_full_pnpm/.nvmrc b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_full_pnpm/.nvmrc
index 5bd6811705..0a492611a0 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_full_pnpm/.nvmrc
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_full_pnpm/.nvmrc
@@ -1 +1 @@
-20.19.0
+24.11.0
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_full_pnpm/snapshots/migration_upgrade_setup_full_pnpm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_full_pnpm/snapshots/migration_upgrade_setup_full_pnpm.md
index 1ff640f201..363d248140 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_full_pnpm/snapshots/migration_upgrade_setup_full_pnpm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_full_pnpm/snapshots/migration_upgrade_setup_full_pnpm.md
@@ -53,7 +53,7 @@ vite-plus version upgrade is applied
 .nvmrc is migrated to .node-version by the full setup
 
 ```
-20.19.0
+24.11.0
 ```
 
 ## `vpt stat-file .nvmrc --assert-not file`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_skipped_default_pnpm/.nvmrc b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_skipped_default_pnpm/.nvmrc
index 5bd6811705..0a492611a0 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_skipped_default_pnpm/.nvmrc
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_skipped_default_pnpm/.nvmrc
@@ -1 +1 @@
-20.19.0
+24.11.0
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_version_table_pnpm/pnpm-workspace.yaml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_version_table_pnpm/pnpm-workspace.yaml
index 9e76cdd806..ce4cfd2128 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_version_table_pnpm/pnpm-workspace.yaml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_version_table_pnpm/pnpm-workspace.yaml
@@ -4,5 +4,5 @@ packages:
 catalog:
   vite-plus: 0.1.21
   vite: npm:@voidzero-dev/vite-plus-core@0.1.21
-  vitest: 3.2.4
-  '@vitest/coverage-v8': 3.2.4
+  vitest: 4.1.8
+  '@vitest/coverage-v8': 4.1.8
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_version_table_pnpm/snapshots/migration_upgrade_version_table_pnpm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_version_table_pnpm/snapshots/migration_upgrade_version_table_pnpm.md
index 6f4a2ff727..be3f6c5f5a 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_version_table_pnpm/snapshots/migration_upgrade_version_table_pnpm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_version_table_pnpm/snapshots/migration_upgrade_version_table_pnpm.md
@@ -17,7 +17,7 @@ VITE+ - The Unified Toolchain for the Web
 • Dependencies:
     vite-plus            0.1.21 → <version>
     vite                 8.0.0  → <version>
-    vitest               3.2.4  → <version>
-    @vitest/coverage-v8  3.2.4  → <version>
+    vitest               4.1.8  → <version>
+    @vitest/coverage-v8  4.1.8  → <version>
 • Package manager settings configured
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_vitest_non_runtime_only_npm/snapshots/migration_upgrade_vitest_non_runtime_only_npm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_vitest_non_runtime_only_npm/snapshots/migration_upgrade_vitest_non_runtime_only_npm.md
index 77366f0439..99fb08e553 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_vitest_non_runtime_only_npm/snapshots/migration_upgrade_vitest_non_runtime_only_npm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_vitest_non_runtime_only_npm/snapshots/migration_upgrade_vitest_non_runtime_only_npm.md
@@ -10,10 +10,9 @@ VITE+ - The Unified Toolchain for the Web
 ◇ Updated . to Vite+ <version>
 • Node <version>  npm <version>
 • Dependencies:
-    vite-plus          latest → <version>
-    vite                      → <version>
-    @vitest/utils      4.1.8  → <version>
-    @vitest/ws-client  4.1.8  → <version>
+    vite-plus      latest → <version>
+    vite                  → <version>
+    @vitest/utils  4.1.8  → <version>
 • Package manager settings configured
 ```
 
@@ -27,7 +26,7 @@ internal packages align, eslint plugin stays independent, vitest is removed
   "devDependencies": {
     "@vitest/eslint-plugin": "^1.6.0",
     "@vitest/utils": "<version>",
-    "@vitest/ws-client": "<version>",
+    "@vitest/ws-client": "^4.1.8",
     "vite-plus": "<version>"
   },
   "overrides": {
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_peer_dep/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_peer_dep/snapshots.toml
index 4b4ca5ffeb..16de4053ab 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_peer_dep/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_peer_dep/snapshots.toml
@@ -2,6 +2,7 @@
 name = "migration_vitest_peer_dep"
 vp = "global"
 steps = [
+  { argv = ["vpt", "write-file", "node_modules/vitest/package.json", "{\"name\":\"vitest\",\"version\":\"4.1.11\"}"], comment = "record the original runner version without adding a direct dependency", snapshot = false },
   { argv = ["vp", "migrate", "--no-interactive"], comment = "vitest should be added to devDeps when vitest-browser-svelte is present", continue-on-failure = true },
   { argv = ["vpt", "print-file", "package.json"], comment = "vitest should be in devDependencies", continue-on-failure = true },
   { argv = ["vpt", "print-file", "pnpm-workspace.yaml"], continue-on-failure = true },
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_peer_dep/snapshots/migration_vitest_peer_dep.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_peer_dep/snapshots/migration_vitest_peer_dep.md
index 17f735d8f0..8c7884e157 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_peer_dep/snapshots/migration_vitest_peer_dep.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_peer_dep/snapshots/migration_vitest_peer_dep.md
@@ -1,5 +1,10 @@
 # migration_vitest_peer_dep
 
+## `vpt write-file node_modules/vitest/package.json '{"name":"vitest","version":"4.1.11"}'`
+
+record the original runner version without adding a direct dependency
+
+
 ## `vp migrate --no-interactive`
 
 vitest should be added to devDeps when vitest-browser-svelte is present
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_unmanaged_override/snapshots/migration_vitest_unmanaged_override.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_unmanaged_override/snapshots/migration_vitest_unmanaged_override.md
index 8278e5fb88..559a60c3a0 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_unmanaged_override/snapshots/migration_vitest_unmanaged_override.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_unmanaged_override/snapshots/migration_vitest_unmanaged_override.md
@@ -63,5 +63,10 @@ unmanaged Vitest ecosystem versions remain stable on rerun
 ```
 VITE+ - The Unified Toolchain for the Web
 
-This project is already using Vite+! Happy coding!
+◇ Updated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• Dependencies:
+    vite               → <version>
+    vitest      4.0.13 → <version>
+    @vitest/ui  4.0.13 → <version>
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/example.test.ts b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/example.test.ts
new file mode 100644
index 0000000000..853beb85e1
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/example.test.ts
@@ -0,0 +1,6 @@
+import { expect, test } from 'vitest';
+
+test.sequential('compatibility', () => {
+  expect(Promise.resolve(42)).resolves.toBe(42);
+  expect(() => { throw new Error(''); }).toThrow('');
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/package.json
new file mode 100644
index 0000000000..59c0e1da8b
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/package.json
@@ -0,0 +1,13 @@
+{
+  "name": "migration-vitest-v5",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@11.24.0",
+  "scripts": {
+    "test": "vitest list"
+  },
+  "devDependencies": {
+    "vite": "^8.0.0",
+    "vitest": "4.1.11"
+  }
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots.toml
new file mode 100644
index 0000000000..91c02de0c7
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots.toml
@@ -0,0 +1,520 @@
+[[case]]
+name = "compatibility"
+vp = "global"
+steps = [
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "vite.config.ts"],
+  ["vpt", "print-file", "example.test.ts"],
+  ["vpt", "print-file", "package.json"],
+  ["vpt", "stat-file", ".vite-plus/migrations.json", "--assert", "missing"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "stat-file", ".vite-plus/migrations.json", "--assert", "missing"],
+]
+
+[[case]]
+name = "review_only_rerun"
+vp = "global"
+comment = "Show a non-blocking review once in the final summary, and retain it on a no-op rerun without reconciling dependencies."
+steps = [
+  { argv = ["vpt", "write-file", "example.test.ts", "import { test } from 'vitest';\ntest('ui', () => { const url = 'http://localhost:51204/__vitest__/'; void url; });\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "v4_reviews_do_not_repeat"
+vp = "global"
+comment = "Show execution-related v4 reviews in the first final summary, but not after upgrading to v5."
+steps = [
+  { argv = ["vpt", "write-file", "example.test.ts", "import { expect, test } from 'vitest';\ntest('poll', async () => { await expect.poll(() => 42).toBe(42); });\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "output_only_changes"
+vp = "global"
+comment = "Keep parameterized titles and reporter options without cosmetic compatibility edits or review prompts."
+steps = [
+  { argv = ["vpt", "write-file", "example.test.ts", "import { expect, it } from 'vitest';\nit.each(['system', 'light', 'dark'])('accepts %s', value => { expect(value).toBe(value); });\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "vite.config.ts", "export default { test: { reporters: ['json', ['junit', {}], ['html', { outputFile: 'reports/index.html' }]] } };\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "vite.config.ts", "example.test.ts"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "v5_without_compatibility_reviews"
+vp = "global"
+comment = "Migrate an original Vitest v5 project without v4 default edits or behavior reviews."
+steps = [
+  { argv = ["vpt", "json-edit", "package.json", "devDependencies.vitest", "5.0.1"], snapshot = false },
+  { argv = ["vpt", "write-file", "example.test.ts", "import { expect, it, test } from 'vitest';\nit.each(['system', 'light', 'dark'])('accepts %s', value => { expect(value).toBe(value); });\ntest('poll', async () => { await expect.poll(() => 42).toBe(42); });\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "vite.config.ts", "example.test.ts", "package.json"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "configless_defaults"
+vp = "global"
+comment = "Migrate a configless workspace member's source APIs without a review or a new compatibility config."
+steps = [
+  { argv = ["vpt", "write-file", "pnpm-workspace.yaml", "packages:\n  - packages/*\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "packages/unit/package.json", "{\"name\":\"unit\",\"private\":true,\"type\":\"module\",\"devDependencies\":{\"vitest\":\"4.1.11\"}}\n"], snapshot = false },
+  { argv = ["vpt", "cp", "example.test.ts", "packages/unit/example.test.ts"], snapshot = false },
+  { argv = ["vpt", "rm", "example.test.ts"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "stat-file", "packages/unit/vite.config.ts", "--assert", "missing"],
+  ["vpt", "stat-file", "packages/unit/.gitignore", "--assert", "missing"],
+  ["vpt", "print-file", ".gitignore"],
+  ["vpt", "print-file", "packages/unit/example.test.ts"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "workspace_gitignore"
+vp = "global"
+comment = "Reuse the root .vitest/ rule without creating or changing workspace package ignore files."
+steps = [
+  { argv = ["vpt", "write-file", "pnpm-workspace.yaml", "packages:\n  - packages/*\n"], snapshot = false },
+  { argv = ["vpt", "write-file", ".gitignore", "node_modules/\n.vitest/\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "packages/a/package.json", "{\"name\":\"a\",\"private\":true,\"devDependencies\":{\"vitest\":\"4.1.11\"}}\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "packages/b/package.json", "{\"name\":\"b\",\"private\":true,\"devDependencies\":{\"vitest\":\"4.1.11\"}}\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "packages/b/.gitignore", "dist/\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", ".gitignore", "packages/b/.gitignore"],
+  ["vpt", "stat-file", "packages/a/.gitignore", "--assert", "missing"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", ".gitignore", "packages/b/.gitignore"],
+  ["vpt", "stat-file", "packages/a/.gitignore", "--assert", "missing"],
+]
+
+[[case]]
+name = "configless_interactive"
+vp = "global"
+comment = "Complete interactive migration without prompting to create a Vitest compatibility config in a configless workspace member."
+steps = [
+  { argv = ["vpt", "write-file", "pnpm-workspace.yaml", "packages:\n  - packages/*\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "packages/unit/package.json", "{\"name\":\"unit\",\"private\":true,\"type\":\"module\",\"devDependencies\":{\"vitest\":\"4.1.11\"}}\n"], snapshot = false },
+  { argv = ["vpt", "cp", "example.test.ts", "packages/unit/example.test.ts"], snapshot = false },
+  { argv = ["vpt", "rm", "example.test.ts"], snapshot = false },
+  { argv = ["vp", "pm", "config", "get", "registry"], snapshot = false },
+  ["vp", "migrate", "--interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "stat-file", "packages/unit/vite.config.ts", "--assert", "missing"],
+  ["vpt", "print-file", "packages/unit/example.test.ts"],
+]
+
+[[case]]
+name = "stateless_rerun"
+vp = "global"
+comment = "After upgrading, preserve new v5 choices on reruns without migration metadata. Ignore a legacy preview state file without overwriting it."
+steps = [
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "stat-file", ".vite-plus/migrations.json", "--assert", "missing"],
+  { argv = ["vpt", "write-file", "vite.config.ts", "export default { test: {} };\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "example.test.ts", "import { expect, test } from 'vite-plus/test';\ntest('v5 assertion', () => { expect(() => { throw new Error('boom'); }).toThrow(''); });\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "vite.config.ts", "example.test.ts"],
+  ["vpt", "stat-file", ".vite-plus/migrations.json", "--assert", "missing"],
+  { argv = ["vpt", "write-file", ".vite-plus/migrations.json", "legacy preview state: invalid JSON\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", ".vite-plus/migrations.json"],
+]
+
+[[case]]
+name = "supported_engine_minimum"
+vp = "global"
+comment = "Keep a public engine range with a supported minimum without a Node review across repeated migration."
+steps = [
+  { argv = ["vpt", "json-edit", "package.json", "engines.node", ">= 22.19.0"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "package.json"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "node_preflight"
+vp = "global"
+comment = "Upgrade the unsupported runtime pin before installation, then keep it on rerun."
+steps = [
+  { argv = ["vpt", "write-file", ".node-version", "20.19.0\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", ".node-version"],
+  ["vpt", "print-file", "package.json"],
+  ["vpt", "print-file", "example.test.ts"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", ".node-version"],
+]
+
+[[case]]
+name = "volta_runtime_upgrade"
+vp = "global"
+comment = "Upgrade the Volta pin before converting it to .node-version, including the cached setup decision."
+steps = [
+  { argv = ["vpt", "json-edit", "package.json", "volta.node", "20.19.0"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", ".node-version", "package.json"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "external_project_inheritance"
+vp = "global"
+comment = "Preserve external clearMocks and locator settings, and include the unresolved inheritance review in the first migration's final report."
+steps = [
+  { argv = ["vpt", "write-file", "base.mjs", "export default { test: { clearMocks: true, browser: { enabled: false, locators: { exact: true } } } };\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "vite.config.ts", "export default { test: { projects: [{ extends: './base.mjs', test: { name: 'unit', browser: { enabled: false } } }] } };\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "vite.config.ts"],
+  ["vpt", "print-file", "base.mjs"],
+  ["node", "verify-review.mjs", "--inheritance"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "global_ownership_and_sequential_timeouts"
+vp = "global"
+comment = "Migrate only the Vitest globals and preserve numeric sequential timeouts in runtime collection. Leave the separate Jest suite unchanged."
+steps = [
+  { argv = ["vpt", "write-file", "vite.config.ts", "export default { test: { globals: true, include: ['unit/**/*.test.js'] } };\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "jest.config.cjs", "module.exports = { testMatch: ['<rootDir>/integration/**/*.test.js'] };\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "unit/slow.test.js", "test.sequential('slow test', async () => {}, 15000);\nit.sequential('slow it', async () => {}, 12000);\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "integration/other.test.js", "test('throws', () => { expect(() => { throw new Error('boom'); }).toThrow(''); });\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "unit/slow.test.js"],
+  ["vpt", "print-file", "integration/other.test.js"],
+  ["node", "verify-review.mjs"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "version_gate_preserves_sources"
+vp = "global"
+comment = "A version check after initial setup must abort before Vitest compatibility edits."
+steps = [
+  { argv = ["vpt", "write-file", "node_modules/vite/package.json", "{\"name\":\"vite\",\"version\":\"6.4.0\"}\n"], snapshot = false },
+  { argv = ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"], continue-on-failure = true },
+  ["vpt", "print-file", "vite.config.ts"],
+  ["vpt", "print-file", "example.test.ts"],
+  ["vpt", "print-file", "package.json"],
+  ["vpt", "stat-file", ".vite-plus/migrations.json", "--assert", "missing"],
+]
+
+[[case]]
+name = "selected_config_and_setup_globals"
+vp = "global"
+comment = "An inactive Vite config must not suppress Vitest globals. Migrate the selected test and its globals-only setup hook."
+steps = [
+  { argv = ["vpt", "write-file", "vite.config.ts", "export default {};\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "vitest.config.mjs", "export default { test: { globals: true, include: ['unit/*.test.js'], setupFiles: './setup.js' } };\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "setup.js", "beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "unit/right.test.js", "test.sequential('works', () => { expect(() => { throw new Error(''); }).toThrow(''); });\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "unit/right.test.js"],
+  ["vpt", "print-file", "setup.js"],
+  ["node", "verify-review.mjs", "--scopes"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "test_root_override"
+vp = "global"
+comment = "test.root overrides the Vite root. Migrate only that test and setup scope, leaving the similarly named unrelated suite unchanged."
+steps = [
+  { argv = ["vpt", "write-file", "vite.config.ts", "export default { root: './app', test: { root: './unit', globals: true, setupFiles: './setup.js' } };\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "unit/setup.js", "beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "unit/right.test.js", "test.sequential('works', () => {});\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "app/unit/wrong.test.js", "test('other runner', () => { expect(() => { throw new Error('boom'); }).toThrow(''); });\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "unit/right.test.js"],
+  ["vpt", "print-file", "unit/setup.js"],
+  ["vpt", "print-file", "app/unit/wrong.test.js"],
+  ["node", "verify-review.mjs", "--scopes", "--root"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "test_discovery_dir"
+vp = "global"
+comment = "Match includes and excludes under test.dir, keep setup resolution relative to root, and preserve files outside the discovery directory."
+steps = [
+  { argv = ["vpt", "write-file", "vite.config.ts", "export default { root: './app', test: { globals: true, dir: './unit', include: ['*.test.js'], exclude: ['excluded.test.js'], setupFiles: '../setup.js' } };\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "setup.js", "beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "unit/right.test.js", "test.sequential('works', () => {});\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "wrong.test.js", "test('other runner', () => { expect(() => { throw Error('boom'); }).toThrow(''); });\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "unit/excluded.test.js", "test.sequential('excluded', () => {});\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "app/unit/wrong.test.js", "test.sequential('wrong root', () => {});\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "unit/right.test.js", "setup.js", "wrong.test.js", "unit/excluded.test.js", "app/unit/wrong.test.js"],
+  ["node", "verify-review.mjs", "--scopes"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "cli_discovery_dir"
+vp = "global"
+comment = "A literal --dir overrides config discovery without changing setup-file ownership."
+steps = [
+  { argv = ["vpt", "json-edit", "package.json", "scripts.test", "vitest run --dir ./unit"], snapshot = false },
+  { argv = ["vpt", "write-file", "vite.config.ts", "export default { test: { globals: true, dir: './ignored', include: ['*.test.js'], setupFiles: './setup.js' } };\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "setup.js", "beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "unit/right.test.js", "test.sequential('works', () => {});\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "wrong.test.js", "expect(() => { throw Error('boom'); }).toThrow('');\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "ignored/wrong.test.js", "test.sequential('ignored', () => {});\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "unit/right.test.js", "setup.js", "wrong.test.js", "ignored/wrong.test.js"],
+  ["node", "verify-review.mjs", "--scopes", "--dir", "./unit"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "directory_setup_globals"
+vp = "global"
+comment = "An extensionless setup directory resolves its index file and migrates its globals-only hook."
+steps = [
+  { argv = ["vpt", "write-file", "vite.config.ts", "export default { test: { globals: true, setupFiles: ['./setup'], include: ['unit.test.js'] } };\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "setup/index.js", "beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "unit.test.js", "test('works', () => {});\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "setup/index.js"],
+  ["node", "verify-review.mjs", "--scopes"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "setup_extension_precedence"
+vp = "global"
+comment = "Prefer setup.mjs over setup.js, and leave the inactive JavaScript file unchanged."
+steps = [
+  { argv = ["vpt", "write-file", "vite.config.ts", "export default { test: { globals: true, setupFiles: ['./setup'], include: ['unit.test.js'] } };\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "setup.mjs", "beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "setup.js", "expect(() => { throw Error('boom'); }).toThrow('');\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "unit.test.js", "test('works', () => {});\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "setup.mjs", "setup.js"],
+  ["node", "verify-review.mjs", "--scopes"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "vue_style_global_scopes"
+vp = "global"
+comment = "Resolve inherited globals through callbacks, imported config defaults, conditional projects, literal command lists, and root-relative setup paths. Preserve unrelated suites."
+steps = [
+  { argv = ["vpt", "json-edit", "package.json", "scripts.test", "node build.js && MODE=unit vitest run --project unit*"], snapshot = false },
+  { argv = ["vpt", "write-file", "vite.config.ts", "import { configDefaults, defineConfig } from 'vite-plus';\nexport default defineConfig({ test: { globals: true, setupFiles: 'scripts/setup.ts', onConsoleLog(log) { return !log.includes('quiet'); }, projects: [\n  { extends: true, test: { name: 'unit', include: ['unit/*.test.ts'], exclude: [...configDefaults.exclude] } },\n  ...(process.env.EXTRA ? [{ extends: true, test: { name: 'extra', include: ['extra/*.test.ts'] } }] : []),\n] } });\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "scripts/setup.ts", "beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "unit/right.test.ts", "test.sequential('works', () => { expect(1).toBe(1); });\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "other/wrong.test.ts", "test('other runner', () => { expect(() => { throw Error('boom'); }).toThrow(''); });\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "unit/right.test.ts", "scripts/setup.ts", "other/wrong.test.ts"],
+  ["node", "verify-review.mjs", "--scopes"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "conflicting_setup_globals"
+vp = "global"
+comment = "Preserve a setup file shared by projects with conflicting globals settings and retain its ownership review on repeated migration."
+steps = [
+  { argv = ["vpt", "write-file", "vite.config.ts", "export default { test: { projects: [{ test: { globals: true, setupFiles: './setup.js' } }, { test: { globals: false, setupFiles: './setup.js' } }] } };\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "setup.js", "beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "ordinary.test.js", "test('works', () => { expect(1).toBe(1); expect(2).toBe(2); });\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "setup.js"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "mixed_project_assertions"
+vp = "global"
+comment = "Keep Node DOM matchers, migrate browser matchers, and report shared inputs during the v4 migration. Do not infer v4 matcher intent on a later v5 run."
+steps = [
+  { argv = ["vpt", "write-file", "vite.config.ts", "export default { test: { projects: [{ test: { name: 'node', include: ['node.test.ts', 'shared.test.ts'] } }, { test: { name: 'browser', browser: { enabled: true }, include: ['browser.test.ts', 'shared.test.ts'] } }] } };\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "node.test.ts", "import { expect } from 'vitest';\nexpect(element).toHaveTextContent('partial');\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "browser.test.ts", "import { expect } from 'vitest';\nawait expect.element(element)['toHaveTextContent']('partial');\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "shared.test.ts", "import { expect } from 'vitest';\nexpect(element).toHaveTextContent('partial');\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "node.test.ts"],
+  ["vpt", "print-file", "browser.test.ts"],
+  ["vpt", "print-file", "shared.test.ts"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "plugin_projects_and_dom_types"
+vp = "global"
+comment = "Do not scan plugin project paths as Vitest configs; report the Jest-only DOM type entry without changing a mixed test contract."
+steps = [
+  { argv = ["vpt", "write-file", "vite.config.ts", "import { defineConfig } from 'vitest/config';\nconst config = defineConfig({ plugins: [{ name: 'paths', projects: ['./tsconfig.json', './plugin-options.ts'] }], test: {} });\nexport default config;\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "tsconfig.json", "{\"compilerOptions\":{\"types\":[\"@testing-library/jest-dom\",\"vitest/globals\"]}}\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "plugin-options.ts", "export default { test: {} };\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "plugin-options.ts"],
+  ["vpt", "print-file", "tsconfig.json"],
+]
+
+[[case]]
+name = "removed_api_preflight"
+vp = "global"
+comment = "Show blockers and accompanying reviews once before stopping without dependency changes."
+steps = [
+  { argv = ["vpt", "write-file", "custom-runner.ts", "import { startTests } from '@vitest/runner';\nstartTests([]);\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "review.test.ts", "import { expect } from 'vitest';\nawait expect.poll(() => 42).toBe(42);\n"], snapshot = false },
+  { argv = ["vp", "migrate", "--no-interactive"], continue-on-failure = true },
+  ["vpt", "print-file", "package.json"],
+]
+
+[[case]]
+name = "api_conflict_preflight"
+vp = "global"
+steps = [
+  { argv = ["vpt", "write-file", "vite.config.ts", "export default { test: { api: { port: 1 }, browser: { api: { port: 2 } } } };\n"], snapshot = false },
+  { argv = ["vp", "migrate", "--no-interactive"], continue-on-failure = true },
+  ["vpt", "print-file", "package.json"],
+]
+
+[[case]]
+name = "api_equivalent_migration"
+vp = "global"
+comment = "Deduplicate equal static API settings despite different property order and spelling, retaining restricted access."
+steps = [
+  { argv = ["vpt", "write-file", "vite.config.ts", "export default { test: { api: { port: 51204, host: 'localhost', allowExec: false }, browser: { enabled: false, api: { allowExec: false, 'host': 'localhost', 'port': 51204 } } } };\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "vite.config.ts"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "benchmark_output_migration"
+vp = "global"
+comment = "Migrate dynamic names, local workloads, built-in reporters, and config/CLI JSON paths. Run both CLI forms and verify the new report data."
+steps = [
+  { argv = ["vpt", "write-file", "vite.config.ts", "export default { test: { include: ['unused.test.js'], benchmark: { include: ['example.bench.ts'], reporters: 'verbose', outputJson: 'reports/config.json' } } };\n"], snapshot = false },
+  { argv = ["vpt", "json-edit", "package.json", "scripts.bench", "vitest bench --run --outputJson='reports/cli bench.json'"], snapshot = false },
+  { argv = ["vpt", "write-file", "example.bench.ts", "import { bench, describe } from 'vitest';\ndescribe('utilities', () => {\n  let calls = 0;\n  const name = () => { if (++calls !== 1) throw new Error('name evaluated twice'); return 'parse'; };\n  const json = '{\"value\":42}';\n  function workload() { if (JSON.parse(json).value !== 42) throw new Error('scope lost'); }\n  bench(name(), workload);\n});\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "example.bench.ts", "vite.config.ts", "package.json"],
+  { argv = ["vp", "test", "bench", "--run"], snapshot = false },
+  { argv = ["vp", "run", "bench"], snapshot = false },
+  ["node", "verify-benchmark-output.mjs", "reports/config.json", "reports/cli bench.json"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "benchmark_preflight"
+vp = "global"
+steps = [
+  { argv = ["vpt", "write-file", "example.bench.ts", "import { bench } from 'vitest';\nbench('old benchmark', () => 20 + 22, { time: 10 });\n"], snapshot = false },
+  { argv = ["vp", "migrate", "--no-interactive"], continue-on-failure = true },
+  ["vpt", "print-file", "package.json"],
+  ["vpt", "print-file", "example.bench.ts"],
+]
+
+[[case]]
+name = "benchmark_global_default_scope"
+vp = "global"
+comment = "Migrate globals in default benchmark paths independently of test patterns, preserve an unrelated runner's file, and execute the parenthesized workload."
+steps = [
+  { argv = ["vpt", "write-file", "vite.config.ts", "export default { test: { globals: true } };\n"], snapshot = false },
+  { argv = ["vpt", "json-edit", "package.json", "scripts.bench", "vitest bench --run"], snapshot = false },
+  { argv = ["vpt", "write-file", "example.bench.js", "bench('work', (() => { for (let i = 0; i < 100; i++) JSON.parse('{\"value\":42}'); }));\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "unrelated.js", "bench('other runner', () => { expect(() => {}).toThrow(''); });\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "example.bench.js", "unrelated.js"],
+  { argv = ["vp", "test", "bench", "--run", "--reporter=json", "--outputFile=benchmark.json"], snapshot = false },
+  ["node", "verify-benchmark-regressions.mjs", "example.bench.js", "work"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "benchmark_global_custom_scope"
+vp = "global"
+comment = "Use benchmark include/exclude independently of test exclusions. Preserve excluded and out-of-scope files, including the overridden default benchmark path."
+steps = [
+  { argv = ["vpt", "write-file", "vite.config.ts", "export default { test: { globals: true, exclude: ['perf/**'], benchmark: { include: ['perf/*.js'], exclude: ['perf/excluded.js'] } } };\n"], snapshot = false },
+  { argv = ["vpt", "json-edit", "package.json", "scripts.bench", "vitest bench --run"], snapshot = false },
+  { argv = ["vpt", "write-file", "perf/work.js", "bench('work', () => { for (let i = 0; i < 100; i++) JSON.parse('{\"value\":42}'); });\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "perf/excluded.js", "bench('excluded', () => { expect(() => {}).toThrow(''); });\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "example.bench.js", "bench('other runner', () => { expect(() => {}).toThrow(''); });\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "perf/work.js", "perf/excluded.js", "example.bench.js"],
+  { argv = ["vp", "test", "bench", "--run", "--reporter=json", "--outputFile=benchmark.json"], snapshot = false },
+  ["node", "verify-benchmark-regressions.mjs", "perf/work.js", "work"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "benchmark_in_source"
+vp = "global"
+comment = "Migrate destructured and direct import.meta.vitest benchmarks with default globals. Execute the migrated benchmarks and import the production module without Vitest."
+steps = [
+  { argv = ["vpt", "write-file", "vite.config.ts", "export default { test: { benchmark: { include: [], includeSource: ['perf/*.js'] } } };\n"], snapshot = false },
+  { argv = ["vpt", "json-edit", "package.json", "scripts.bench", "vitest bench --run"], snapshot = false },
+  { argv = ["vpt", "write-file", "perf/work.js", "export function work() { for (let i = 0; i < 100; i++) JSON.parse('{\"value\":42}'); return 42; }\nif (import.meta.vitest) {\n  const { bench } = import.meta.vitest;\n  bench('destructured', () => work());\n  import.meta.vitest.bench('member', (() => work()));\n}\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "perf/work.js"],
+  { argv = ["vp", "test", "bench", "--run", "--reporter=json", "--outputFile=benchmark.json"], snapshot = false },
+  ["node", "verify-benchmark-regressions.mjs", "perf/work.js", "destructured", "member"],
+  ["node", "--input-type=module", "-e", "import assert from 'node:assert/strict'; import { work } from './perf/work.js'; assert.equal(work(), 42); console.log('Production import works without Vitest');"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "benchmark_in_source_globals"
+vp = "global"
+comment = "Recognize local in-source API bindings independently of globals: true, without removing the production guard."
+steps = [
+  { argv = ["vpt", "write-file", "vite.config.ts", "export default { test: { globals: true, benchmark: { include: [], includeSource: ['perf/*.js'] } } };\n"], snapshot = false },
+  { argv = ["vpt", "json-edit", "package.json", "scripts.bench", "vitest bench --run"], snapshot = false },
+  { argv = ["vpt", "write-file", "perf/work.js", "export function work() { for (let i = 0; i < 100; i++) JSON.parse('{\"value\":42}'); return 42; }\nif (import.meta.vitest) {\n  const { bench: measure } = import.meta.vitest;\n  measure('destructured', () => work());\n  import.meta.vitest.bench('member', (() => work()));\n}\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "perf/work.js"],
+  { argv = ["vp", "test", "bench", "--run", "--reporter=json", "--outputFile=benchmark.json"], snapshot = false },
+  ["node", "verify-benchmark-regressions.mjs", "perf/work.js", "destructured", "member"],
+  ["node", "--input-type=module", "-e", "import assert from 'node:assert/strict'; import { work } from './perf/work.js'; assert.equal(work(), 42); console.log('Production import works without Vitest');"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "benchmark_in_source_preflight"
+vp = "global"
+comment = "Block unsupported in-source benchmark options before dependency changes and retain the guarded source."
+steps = [
+  { argv = ["vpt", "write-file", "vite.config.ts", "export default { test: { benchmark: { include: [], includeSource: ['perf/*.js'] } } };\n"], snapshot = false },
+  { argv = ["vpt", "json-edit", "package.json", "scripts.bench", "vitest bench --run"], snapshot = false },
+  { argv = ["vpt", "write-file", "perf/work.js", "if (import.meta.vitest) {\n  const { bench } = import.meta.vitest;\n  bench('work', () => 42, { time: 1 });\n}\n"], snapshot = false },
+  { argv = ["vp", "migrate", "--no-interactive"], continue-on-failure = true },
+  ["vpt", "print-file", "package.json", "perf/work.js"],
+]
+
+[[case]]
+name = "benchmark_parenthesized_workloads"
+vp = "global"
+comment = "Migrate and run parenthesized arrows, function expressions, and local callbacks without losing parentheses, comments, or trailing commas."
+steps = [
+  { argv = ["vpt", "write-file", "vite.config.ts", "export default { test: {} };\n"], snapshot = false },
+  { argv = ["vpt", "json-edit", "package.json", "scripts.bench", "vitest bench --run"], snapshot = false },
+  { argv = ["vpt", "write-file", "example.bench.js", "import { bench } from 'vitest';\nconst workload = () => { for (let i = 0; i < 100; i++) JSON.parse('{\"value\":42}'); };\nbench('arrow', (() => workload()));\nbench('nested', ((() => workload())));\nbench('function', (function () { workload(); }));\nbench('local', (workload));\nbench('comments', (/* before */ (() => workload()) /* after */), /* trailing */);\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "example.bench.js"],
+  { argv = ["vp", "test", "bench", "--run", "--reporter=json", "--outputFile=benchmark.json"], snapshot = false },
+  ["node", "verify-benchmark-regressions.mjs", "example.bench.js", "arrow", "nested", "function", "local", "comments"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "benchmark_migration"
+vp = "global"
+comment = "Migrate direct benchmarks, preserve suite closures and modifiers, and execute the migrated workloads with Vitest 5. Keep the supported bench command."
+steps = [
+  { argv = ["vpt", "write-file", "vite.config.ts", "export default { test: { include: ['unused.test.js'], benchmark: { include: ['example.bench.ts'] } } };\n"], snapshot = false },
+  { argv = ["vpt", "json-edit", "package.json", "scripts.bench", "vitest bench --run"], snapshot = false },
+  { argv = ["vpt", "write-file", "example.bench.ts", "import { bench, describe } from 'vitest';\ndescribe('utilities', () => {\n  const json = '{\"value\":42}';\n  bench('parse', () => { if (JSON.parse(json).value !== 42) throw new Error('scope lost'); });\n  bench('async', async () => { if (await Promise.resolve(json) !== json) throw new Error('scope lost'); });\n  bench.skip('skipped', () => { throw new Error('must not run'); });\n  bench.todo('later');\n});\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "example.bench.ts"],
+  ["vpt", "print-file", "package.json"],
+  ["node", "verify-benchmarks.mjs"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/api_conflict_preflight.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/api_conflict_preflight.md
new file mode 100644
index 0000000000..c4c1667973
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/api_conflict_preflight.md
@@ -0,0 +1,38 @@
+# api_conflict_preflight
+
+## `vpt write-file vite.config.ts 'export default { test: { api: { port: 1 }, browser: { api: { port: 2 } } } };
+'`
+
+
+## `vp migrate --no-interactive`
+
+**Exit code:** 1
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Vitest v5: 1 review item (1 block dependency updates)
+
+vite.config.ts
+  1:55 BLOCK [api-conflict] Resolve conflicting test.api and test.browser.api values before upgrading.
+    Docs: https://vitest.dev/guide/migration/#browser-api-is-replaced-by-the-top-level-api
+Resolve the blocking Vitest v5 findings, then re-run `vp migrate`. No project files were changed.
+```
+
+## `vpt print-file package.json`
+
+```
+{
+  "name": "migration-vitest-v5",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@11.24.0",
+  "scripts": {
+    "test": "vitest list"
+  },
+  "devDependencies": {
+    "vite": "^8.0.0",
+    "vitest": "<version>"
+  }
+}
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/api_equivalent_migration.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/api_equivalent_migration.md
new file mode 100644
index 0000000000..1f8181a3dd
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/api_equivalent_migration.md
@@ -0,0 +1,47 @@
+# api_equivalent_migration
+
+Deduplicate equal static API settings despite different property order and spelling, retaining restricted access.
+
+## `vpt write-file vite.config.ts 'export default { test: { api: { port: 51204, host: '\''localhost'\'', allowExec: false }, browser: { enabled: false, api: { allowExec: false, '\''host'\'': '\''localhost'\'', '\''port'\'': 51204 } } } };
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 1 file had imports rewritten
+```
+
+## `vpt print-file vite.config.ts`
+
+```
+export default {
+  fmt: {},
+  lint: {"jsPlugins":[{"name":"vite-plus","specifier":"vite-plus/oxlint-plugin"}],"rules":{"vite-plus/prefer-vite-plus-imports":"error"},"options":{"typeAware":true,"typeCheck":true}},
+  test: {
+      // Vitest v4 compatibility: preserve mock call history.
+      // Remove after tests no longer rely on calls from setup or earlier tests.
+      // https://vitest.dev/guide/migration/#clearmocks-is-enabled-by-default
+      clearMocks: false,
+      api: { port: 51204, host: 'localhost', allowExec: false }, browser: {
+        locators: {
+          // Vitest v4 compatibility: keep partial, case-insensitive locator matching.
+          // Remove after updating locators for full, case-sensitive matches.
+          // https://vitest.dev/guide/migration/#locators-are-strict-by-default
+          exact: false
+        },
+        enabled: false  } }
+}
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_global_custom_scope.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_global_custom_scope.md
new file mode 100644
index 0000000000..879dc32cfb
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_global_custom_scope.md
@@ -0,0 +1,57 @@
+# benchmark_global_custom_scope
+
+Use benchmark include/exclude independently of test exclusions. Preserve excluded and out-of-scope files, including the overridden default benchmark path.
+
+## `vpt write-file vite.config.ts 'export default { test: { globals: true, exclude: ['\''perf/**'\''], benchmark: { include: ['\''perf/*.js'\''], exclude: ['\''perf/excluded.js'\''] } } };
+'`
+
+
+## `vpt json-edit package.json scripts.bench 'vitest bench --run'`
+
+
+## `vpt write-file perf/work.js 'bench('\''work'\'', () => { for (let i = 0; i < 100; i++) JSON.parse('\''{"value":42}'\''); });
+'`
+
+
+## `vpt write-file perf/excluded.js 'bench('\''excluded'\'', () => { expect(() => {}).toThrow('\'''\''); });
+'`
+
+
+## `vpt write-file example.bench.js 'bench('\''other runner'\'', () => { expect(() => {}).toThrow('\'''\''); });
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 1 file had imports rewritten
+```
+
+## `vpt print-file perf/work.js perf/excluded.js example.bench.js`
+
+```
+globalThis.test('work', async ({ bench }) => { await bench('work', () => { for (let i = 0; i < 100; i++) JSON.parse('{"value":42}'); }).run(); });
+bench('excluded', () => { expect(() => {}).toThrow(''); });
+bench('other runner', () => { expect(() => {}).toThrow(''); });
+```
+
+## `vp test bench --run --reporter=json --outputFile=benchmark.json`
+
+
+## `node verify-benchmark-regressions.mjs perf/work.js work`
+
+```
+Vitest 5 executed 1 migrated benchmarks in perf/work.js
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_global_default_scope.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_global_default_scope.md
new file mode 100644
index 0000000000..3f9acb3525
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_global_default_scope.md
@@ -0,0 +1,52 @@
+# benchmark_global_default_scope
+
+Migrate globals in default benchmark paths independently of test patterns, preserve an unrelated runner's file, and execute the parenthesized workload.
+
+## `vpt write-file vite.config.ts 'export default { test: { globals: true } };
+'`
+
+
+## `vpt json-edit package.json scripts.bench 'vitest bench --run'`
+
+
+## `vpt write-file example.bench.js 'bench('\''work'\'', (() => { for (let i = 0; i < 100; i++) JSON.parse('\''{"value":42}'\''); }));
+'`
+
+
+## `vpt write-file unrelated.js 'bench('\''other runner'\'', () => { expect(() => {}).toThrow('\'''\''); });
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 1 file had imports rewritten
+```
+
+## `vpt print-file example.bench.js unrelated.js`
+
+```
+globalThis.test('work', (async ({ bench }) => { await bench('work', () => { for (let i = 0; i < 100; i++) JSON.parse('{"value":42}'); }).run(); }));
+bench('other runner', () => { expect(() => {}).toThrow(''); });
+```
+
+## `vp test bench --run --reporter=json --outputFile=benchmark.json`
+
+
+## `node verify-benchmark-regressions.mjs example.bench.js work`
+
+```
+Vitest 5 executed 1 migrated benchmarks in example.bench.js
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_in_source.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_in_source.md
new file mode 100644
index 0000000000..6d958d4709
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_in_source.md
@@ -0,0 +1,63 @@
+# benchmark_in_source
+
+Migrate destructured and direct import.meta.vitest benchmarks with default globals. Execute the migrated benchmarks and import the production module without Vitest.
+
+## `vpt write-file vite.config.ts 'export default { test: { benchmark: { include: [], includeSource: ['\''perf/*.js'\''] } } };
+'`
+
+
+## `vpt json-edit package.json scripts.bench 'vitest bench --run'`
+
+
+## `vpt write-file perf/work.js 'export function work() { for (let i = 0; i < 100; i++) JSON.parse('\''{"value":42}'\''); return 42; }
+if (import.meta.vitest) {
+  const { bench } = import.meta.vitest;
+  bench('\''destructured'\'', () => work());
+  import.meta.vitest.bench('\''member'\'', (() => work()));
+}
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 1 file had imports rewritten
+```
+
+## `vpt print-file perf/work.js`
+
+```
+export function work() { for (let i = 0; i < 100; i++) JSON.parse('{"value":42}'); return 42; }
+if (import.meta.vitest) {
+  const { test } = import.meta.vitest;
+  test('destructured', async ({ bench }) => { await bench('destructured', () => work()).run(); });
+  import.meta.vitest.test('member', (async ({ bench }) => { await bench('member', () => work()).run(); }));
+}
+```
+
+## `vp test bench --run --reporter=json --outputFile=benchmark.json`
+
+
+## `node verify-benchmark-regressions.mjs perf/work.js destructured member`
+
+```
+Vitest 5 executed 2 migrated benchmarks in perf/work.js
+```
+
+## `node --input-type=module -e 'import assert from '\''node:assert/strict'\''; import { work } from '\''./perf/work.js'\''; assert.equal(work(), 42); console.log('\''Production import works without Vitest'\'');'`
+
+```
+Production import works without Vitest
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_in_source_globals.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_in_source_globals.md
new file mode 100644
index 0000000000..b4200dcb79
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_in_source_globals.md
@@ -0,0 +1,63 @@
+# benchmark_in_source_globals
+
+Recognize local in-source API bindings independently of globals: true, without removing the production guard.
+
+## `vpt write-file vite.config.ts 'export default { test: { globals: true, benchmark: { include: [], includeSource: ['\''perf/*.js'\''] } } };
+'`
+
+
+## `vpt json-edit package.json scripts.bench 'vitest bench --run'`
+
+
+## `vpt write-file perf/work.js 'export function work() { for (let i = 0; i < 100; i++) JSON.parse('\''{"value":42}'\''); return 42; }
+if (import.meta.vitest) {
+  const { bench: measure } = import.meta.vitest;
+  measure('\''destructured'\'', () => work());
+  import.meta.vitest.bench('\''member'\'', (() => work()));
+}
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 1 file had imports rewritten
+```
+
+## `vpt print-file perf/work.js`
+
+```
+export function work() { for (let i = 0; i < 100; i++) JSON.parse('{"value":42}'); return 42; }
+if (import.meta.vitest) {
+  const { test } = import.meta.vitest;
+  test('destructured', async ({ bench }) => { await bench('destructured', () => work()).run(); });
+  import.meta.vitest.test('member', (async ({ bench }) => { await bench('member', () => work()).run(); }));
+}
+```
+
+## `vp test bench --run --reporter=json --outputFile=benchmark.json`
+
+
+## `node verify-benchmark-regressions.mjs perf/work.js destructured member`
+
+```
+Vitest 5 executed 2 migrated benchmarks in perf/work.js
+```
+
+## `node --input-type=module -e 'import assert from '\''node:assert/strict'\''; import { work } from '\''./perf/work.js'\''; assert.equal(work(), 42); console.log('\''Production import works without Vitest'\'');'`
+
+```
+Production import works without Vitest
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_in_source_preflight.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_in_source_preflight.md
new file mode 100644
index 0000000000..52102e8ee6
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_in_source_preflight.md
@@ -0,0 +1,55 @@
+# benchmark_in_source_preflight
+
+Block unsupported in-source benchmark options before dependency changes and retain the guarded source.
+
+## `vpt write-file vite.config.ts 'export default { test: { benchmark: { include: [], includeSource: ['\''perf/*.js'\''] } } };
+'`
+
+
+## `vpt json-edit package.json scripts.bench 'vitest bench --run'`
+
+
+## `vpt write-file perf/work.js 'if (import.meta.vitest) {
+  const { bench } = import.meta.vitest;
+  bench('\''work'\'', () => 42, { time: 1 });
+}
+'`
+
+
+## `vp migrate --no-interactive`
+
+**Exit code:** 1
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Vitest v5: 1 review item (1 block dependency updates)
+
+perf/work.js
+  2:11 BLOCK [benchmark-api] Migrate this import.meta.vitest bench reference manually: automatic migration requires direct calls with locally resolved zero-argument callbacks and no benchmark options or escaped references. Keep the import.meta.vitest guard.
+    Docs: https://vitest.dev/guide/migration/#benchmarking-api-rewrite
+Resolve the blocking Vitest v5 findings, then re-run `vp migrate`. No project files were changed.
+```
+
+## `vpt print-file package.json perf/work.js`
+
+```
+{
+  "devDependencies": {
+    "vite": "^8.0.0",
+    "vitest": "<version>"
+  },
+  "name": "migration-vitest-v5",
+  "packageManager": "pnpm@11.24.0",
+  "private": true,
+  "scripts": {
+    "bench": "vitest bench --run",
+    "test": "vitest list"
+  },
+  "type": "module"
+}
+if (import.meta.vitest) {
+  const { bench } = import.meta.vitest;
+  bench('work', () => 42, { time: 1 });
+}
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_migration.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_migration.md
new file mode 100644
index 0000000000..47ed8dd49c
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_migration.md
@@ -0,0 +1,77 @@
+# benchmark_migration
+
+Migrate direct benchmarks, preserve suite closures and modifiers, and execute the migrated workloads with Vitest 5. Keep the supported bench command.
+
+## `vpt write-file vite.config.ts 'export default { test: { include: ['\''unused.test.js'\''], benchmark: { include: ['\''example.bench.ts'\''] } } };
+'`
+
+
+## `vpt json-edit package.json scripts.bench 'vitest bench --run'`
+
+
+## `vpt write-file example.bench.ts 'import { bench, describe } from '\''vitest'\'';
+describe('\''utilities'\'', () => {
+  const json = '\''{"value":42}'\'';
+  bench('\''parse'\'', () => { if (JSON.parse(json).value '\!'== 42) throw new Error('\''scope lost'\''); });
+  bench('\''async'\'', async () => { if (await Promise.resolve(json) '\!'== json) throw new Error('\''scope lost'\''); });
+  bench.skip('\''skipped'\'', () => { throw new Error('\''must not run'\''); });
+  bench.todo('\''later'\'');
+});
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 2 files had imports rewritten
+```
+
+## `vpt print-file example.bench.ts`
+
+```
+import { test, describe } from 'vite-plus/test';
+describe('utilities', () => {
+  const json = '{"value":42}';
+  test('parse', async ({ bench }) => { await bench('parse', () => { if (JSON.parse(json).value !== 42) throw new Error('scope lost'); }).run(); });
+  test('async', async ({ bench }) => { await bench('async', async () => { if (await Promise.resolve(json) !== json) throw new Error('scope lost'); }).run(); });
+  test.skip('skipped', async ({ bench }) => { await bench('skipped', () => { throw new Error('must not run'); }).run(); });
+  test.todo('later');
+});
+```
+
+## `vpt print-file package.json`
+
+```
+{
+  "devDependencies": {
+    "vite": "catalog:",
+    "vite-plus": "catalog:"
+  },
+  "name": "migration-vitest-v5",
+  "packageManager": "pnpm@11.24.0",
+  "private": true,
+  "scripts": {
+    "bench": "vp test bench --run",
+    "test": "vp test list --no-static-parse"
+  },
+  "type": "module"
+}
+```
+
+## `node verify-benchmarks.mjs`
+
+```
+Vitest 5 executed both migrated benchmarks and preserved skip/todo modifiers
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_output_migration.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_output_migration.md
new file mode 100644
index 0000000000..f0a974a119
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_output_migration.md
@@ -0,0 +1,89 @@
+# benchmark_output_migration
+
+Migrate dynamic names, local workloads, built-in reporters, and config/CLI JSON paths. Run both CLI forms and verify the new report data.
+
+## `vpt write-file vite.config.ts 'export default { test: { include: ['\''unused.test.js'\''], benchmark: { include: ['\''example.bench.ts'\''], reporters: '\''verbose'\'', outputJson: '\''reports/config.json'\'' } } };
+'`
+
+
+## `vpt json-edit package.json scripts.bench 'vitest bench --run --outputJson='\''reports/cli bench.json'\'''`
+
+
+## `vpt write-file example.bench.ts 'import { bench, describe } from '\''vitest'\'';
+describe('\''utilities'\'', () => {
+  let calls = 0;
+  const name = () => { if (++calls '\!'== 1) throw new Error('\''name evaluated twice'\''); return '\''parse'\''; };
+  const json = '\''{"value":42}'\'';
+  function workload() { if (JSON.parse(json).value '\!'== 42) throw new Error('\''scope lost'\''); }
+  bench(name(), workload);
+});
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 2 files had imports rewritten
+```
+
+## `vpt print-file example.bench.ts vite.config.ts package.json`
+
+```
+import { test, describe } from 'vite-plus/test';
+describe('utilities', () => {
+  let calls = 0;
+  const name = () => { if (++calls !== 1) throw new Error('name evaluated twice'); return 'parse'; };
+  const json = '{"value":42}';
+  function workload() { if (JSON.parse(json).value !== 42) throw new Error('scope lost'); }
+  { const _benchName = (name()); const _benchFn = workload; test(_benchName, async ({ bench }) => { await bench(_benchName, _benchFn).run(); }); }
+});
+export default {
+  fmt: {},
+  lint: {"jsPlugins":[{"name":"vite-plus","specifier":"vite-plus/oxlint-plugin"}],"rules":{"vite-plus/prefer-vite-plus-imports":"error"},"options":{"typeAware":true,"typeCheck":true}},
+  test: {
+      // Vitest v4 compatibility: preserve mock call history.
+      // Remove after tests no longer rely on calls from setup or earlier tests.
+      // https://vitest.dev/guide/migration/#clearmocks-is-enabled-by-default
+      clearMocks: false,
+      reporters: ["verbose","json"], outputFile: { json: "reports/config.json" },  include: ['unused.test.js'], benchmark: { include: ['example.bench.ts'],   } }
+}
+{
+  "devDependencies": {
+    "vite": "catalog:",
+    "vite-plus": "catalog:"
+  },
+  "name": "migration-vitest-v5",
+  "packageManager": "pnpm@11.24.0",
+  "private": true,
+  "scripts": {
+    "bench": "vp test bench --run --reporter=default --reporter=json --outputFile='reports/cli bench.json'",
+    "test": "vp test list --no-static-parse"
+  },
+  "type": "module"
+}
+```
+
+## `vp test bench --run`
+
+
+## `vp run bench`
+
+
+## `node verify-benchmark-output.mjs reports/config.json 'reports/cli bench.json'`
+
+```
+reports/config.json: migrated benchmark passed and JSON includes its result
+reports/cli bench.json: migrated benchmark passed and JSON includes its result
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_parenthesized_workloads.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_parenthesized_workloads.md
new file mode 100644
index 0000000000..79bf40738f
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_parenthesized_workloads.md
@@ -0,0 +1,59 @@
+# benchmark_parenthesized_workloads
+
+Migrate and run parenthesized arrows, function expressions, and local callbacks without losing parentheses, comments, or trailing commas.
+
+## `vpt write-file vite.config.ts 'export default { test: {} };
+'`
+
+
+## `vpt json-edit package.json scripts.bench 'vitest bench --run'`
+
+
+## `vpt write-file example.bench.js 'import { bench } from '\''vitest'\'';
+const workload = () => { for (let i = 0; i < 100; i++) JSON.parse('\''{"value":42}'\''); };
+bench('\''arrow'\'', (() => workload()));
+bench('\''nested'\'', ((() => workload())));
+bench('\''function'\'', (function () { workload(); }));
+bench('\''local'\'', (workload));
+bench('\''comments'\'', (/* before */ (() => workload()) /* after */), /* trailing */);
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 2 files had imports rewritten
+```
+
+## `vpt print-file example.bench.js`
+
+```
+import { test } from 'vite-plus/test';
+const workload = () => { for (let i = 0; i < 100; i++) JSON.parse('{"value":42}'); };
+test('arrow', (async ({ bench }) => { await bench('arrow', () => workload()).run(); }));
+test('nested', ((async ({ bench }) => { await bench('nested', () => workload()).run(); })));
+test('function', (async ({ bench }) => { await bench('function', function () { workload(); }).run(); }));
+{ const _benchFn = workload; test('local', (async ({ bench }) => { await bench('local', _benchFn).run(); })); }
+test('comments', (/* before */ (async ({ bench }) => { await bench('comments', () => workload()).run(); }) /* after */), /* trailing */);
+```
+
+## `vp test bench --run --reporter=json --outputFile=benchmark.json`
+
+
+## `node verify-benchmark-regressions.mjs example.bench.js arrow nested function local comments`
+
+```
+Vitest 5 executed 5 migrated benchmarks in example.bench.js
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_preflight.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_preflight.md
new file mode 100644
index 0000000000..7399384be3
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_preflight.md
@@ -0,0 +1,46 @@
+# benchmark_preflight
+
+## `vpt write-file example.bench.ts 'import { bench } from '\''vitest'\'';
+bench('\''old benchmark'\'', () => 20 + 22, { time: 10 });
+'`
+
+
+## `vp migrate --no-interactive`
+
+**Exit code:** 1
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Vitest v5: 1 review item (1 block dependency updates)
+
+example.bench.ts
+  1:10 BLOCK [benchmark-api] Migrate these bench references manually: automatic migration requires direct calls with inline or locally resolved zero-argument callbacks and no benchmark options. Review wrappers, comparison groups, and escaped references.
+    Docs: https://vitest.dev/guide/migration/#benchmarking-api-rewrite
+Resolve the blocking Vitest v5 findings, then re-run `vp migrate`. No project files were changed.
+```
+
+## `vpt print-file package.json`
+
+```
+{
+  "name": "migration-vitest-v5",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@11.24.0",
+  "scripts": {
+    "test": "vitest list"
+  },
+  "devDependencies": {
+    "vite": "^8.0.0",
+    "vitest": "<version>"
+  }
+}
+```
+
+## `vpt print-file example.bench.ts`
+
+```
+import { bench } from 'vitest';
+bench('old benchmark', () => 20 + 22, { time: 10 });
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/cli_discovery_dir.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/cli_discovery_dir.md
new file mode 100644
index 0000000000..5281478e78
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/cli_discovery_dir.md
@@ -0,0 +1,59 @@
+# cli_discovery_dir
+
+A literal --dir overrides config discovery without changing setup-file ownership.
+
+## `vpt json-edit package.json scripts.test 'vitest run --dir ./unit'`
+
+
+## `vpt write-file vite.config.ts 'export default { test: { globals: true, dir: '\''./ignored'\'', include: ['\''*.test.js'\''], setupFiles: '\''./setup.js'\'' } };
+'`
+
+
+## `vpt write-file setup.js 'beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });
+'`
+
+
+## `vpt write-file unit/right.test.js 'test.sequential('\''works'\'', () => {});
+'`
+
+
+## `vpt write-file wrong.test.js 'expect(() => { throw Error('\''boom'\''); }).toThrow('\'''\'');
+'`
+
+
+## `vpt write-file ignored/wrong.test.js 'test.sequential('\''ignored'\'', () => {});
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 1 file had imports rewritten
+```
+
+## `vpt print-file unit/right.test.js setup.js wrong.test.js ignored/wrong.test.js`
+
+```
+test('works', { concurrent: false }, () => {});
+beforeEach(async () => { await expect(Promise.resolve(1)).resolves.toBe(1); });
+expect(() => { throw Error('boom'); }).toThrow('');
+test.sequential('ignored', () => {});
+```
+
+## `node verify-review.mjs --scopes --dir ./unit`
+
+```
+Vitest 5 passed the migrated globals-only test and setup hook in the selected scope
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/compatibility.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/compatibility.md
new file mode 100644
index 0000000000..9ac8daf96f
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/compatibility.md
@@ -0,0 +1,93 @@
+# compatibility
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 2 files had imports rewritten
+```
+
+## `vpt print-file vite.config.ts`
+
+```
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({
+  fmt: {},
+  lint: {"jsPlugins":[{"name":"vite-plus","specifier":"vite-plus/oxlint-plugin"}],"rules":{"vite-plus/prefer-vite-plus-imports":"error"},"options":{"typeAware":true,"typeCheck":true}},
+  test: {
+    // Vitest v4 compatibility: preserve mock call history.
+    // Remove after tests no longer rely on calls from setup or earlier tests.
+    // https://vitest.dev/guide/migration/#clearmocks-is-enabled-by-default
+    clearMocks: false,
+    // Vitest v4 compatibility: keep separate Vite servers for inline projects.
+    // Remove when plugins and config hooks can run once for shared projects.
+    // https://vitest.dev/guide/migration/#inline-projects-share-the-vite-server-by-default
+    sharedViteServer: false,
+    reporters: ['json', ['junit', {}]],
+    projects: [{
+      // Vitest v4 compatibility: keep this inline project independent of the root config.
+      // Remove to inherit root options, including plugins and setup files.
+      // https://vitest.dev/guide/migration/#inline-projects-inherit-the-root-config-by-default
+      extends: false,
+      test: {
+        // Vitest v4 compatibility: preserve mock call history.
+        // Remove after tests no longer rely on calls from setup or earlier tests.
+        // https://vitest.dev/guide/migration/#clearmocks-is-enabled-by-default
+        clearMocks: false,
+        name: 'unit' } }, { extends: true, test: { name: 'inherited' } }],
+  },
+});
+```
+
+## `vpt print-file example.test.ts`
+
+```
+import { expect, test } from 'vite-plus/test';
+
+test('compatibility', { concurrent: false }, async () => {
+  await expect(Promise.resolve(42)).resolves.toBe(42);
+  expect(() => { throw new Error(''); }).toThrow(/^$/);
+});
+```
+
+## `vpt print-file package.json`
+
+```
+{
+  "name": "migration-vitest-v5",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@11.24.0",
+  "scripts": {
+    "test": "vp test list --no-static-parse"
+  },
+  "devDependencies": {
+    "vite": "catalog:",
+    "vite-plus": "catalog:"
+  }
+}
+```
+
+## `vpt stat-file .vite-plus/migrations.json --assert missing`
+
+```
+.vite-plus/migrations.json: missing
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
+
+## `vpt stat-file .vite-plus/migrations.json --assert missing`
+
+```
+.vite-plus/migrations.json: missing
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/configless_defaults.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/configless_defaults.md
new file mode 100644
index 0000000000..2a9b3da946
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/configless_defaults.md
@@ -0,0 +1,65 @@
+# configless_defaults
+
+Migrate a configless workspace member's source APIs without a review or a new compatibility config.
+
+## `vpt write-file pnpm-workspace.yaml 'packages:
+  - packages/*
+'`
+
+
+## `vpt write-file packages/unit/package.json '{"name":"unit","private":true,"type":"module","devDependencies":{"vitest":"4.1.11"}}
+'`
+
+
+## `vpt cp example.test.ts packages/unit/example.test.ts`
+
+
+## `vpt rm example.test.ts`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 2 files had imports rewritten
+```
+
+## `vpt stat-file packages/unit/vite.config.ts --assert missing`
+
+```
+packages/unit/vite.config.ts: missing
+```
+
+## `vpt stat-file packages/unit/.gitignore --assert missing`
+
+```
+packages/unit/.gitignore: missing
+```
+
+## `vpt print-file .gitignore`
+
+```
+.vitest/
+```
+
+## `vpt print-file packages/unit/example.test.ts`
+
+```
+import { expect, test } from 'vite-plus/test';
+
+test('compatibility', { concurrent: false }, async () => {
+  await expect(Promise.resolve(42)).resolves.toBe(42);
+  expect(() => { throw new Error(''); }).toThrow(/^$/);
+});
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/configless_interactive.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/configless_interactive.md
new file mode 100644
index 0000000000..c4fbc15cdf
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/configless_interactive.md
@@ -0,0 +1,48 @@
+# configless_interactive
+
+Complete interactive migration without prompting to create a Vitest compatibility config in a configless workspace member.
+
+## `vpt write-file pnpm-workspace.yaml 'packages:
+  - packages/*
+'`
+
+
+## `vpt write-file packages/unit/package.json '{"name":"unit","private":true,"type":"module","devDependencies":{"vitest":"4.1.11"}}
+'`
+
+
+## `vpt cp example.test.ts packages/unit/example.test.ts`
+
+
+## `vpt rm example.test.ts`
+
+
+## `vp pm config get registry`
+
+
+## `vp migrate --interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 2 files had imports rewritten
+```
+
+## `vpt stat-file packages/unit/vite.config.ts --assert missing`
+
+```
+packages/unit/vite.config.ts: missing
+```
+
+## `vpt print-file packages/unit/example.test.ts`
+
+```
+import { expect, test } from 'vite-plus/test';
+
+test('compatibility', { concurrent: false }, async () => {
+  await expect(Promise.resolve(42)).resolves.toBe(42);
+  expect(() => { throw new Error(''); }).toThrow(/^$/);
+});
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/conflicting_setup_globals.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/conflicting_setup_globals.md
new file mode 100644
index 0000000000..3c02d05630
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/conflicting_setup_globals.md
@@ -0,0 +1,50 @@
+# conflicting_setup_globals
+
+Preserve a setup file shared by projects with conflicting globals settings and retain its ownership review on repeated migration.
+
+## `vpt write-file vite.config.ts 'export default { test: { projects: [{ test: { globals: true, setupFiles: '\''./setup.js'\'' } }, { test: { globals: false, setupFiles: '\''./setup.js'\'' } }] } };
+'`
+
+
+## `vpt write-file setup.js 'beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });
+'`
+
+
+## `vpt write-file ordinary.test.js 'test('\''works'\'', () => { expect(1).toBe(1); expect(2).toBe(2); });
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 1 file had imports rewritten
+! Warnings:
+  - Vitest v5: 1 review item
+
+setup.js
+  1:1 REVIEW [global-api-ownership] Resolve the Vitest project ownership of this file before migrating its affected global APIs. Global API edits were not applied because config selection, file scope, or globals settings are unresolved or conflicting.
+    Docs: https://viteplus.dev/guide/vitest-v5#resolve-migration-findings
+```
+
+## `vpt print-file setup.js`
+
+```
+beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Vitest v5: 1 review item
+
+setup.js
+  1:1 REVIEW [global-api-ownership] Resolve the Vitest project ownership of this file before migrating its affected global APIs. Global API edits were not applied because config selection, file scope, or globals settings are unresolved or conflicting.
+    Docs: https://viteplus.dev/guide/vitest-v5#resolve-migration-findings
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/directory_setup_globals.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/directory_setup_globals.md
new file mode 100644
index 0000000000..d87eec5dbc
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/directory_setup_globals.md
@@ -0,0 +1,45 @@
+# directory_setup_globals
+
+An extensionless setup directory resolves its index file and migrates its globals-only hook.
+
+## `vpt write-file vite.config.ts 'export default { test: { globals: true, setupFiles: ['\''./setup'\''], include: ['\''unit.test.js'\''] } };
+'`
+
+
+## `vpt write-file setup/index.js 'beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });
+'`
+
+
+## `vpt write-file unit.test.js 'test('\''works'\'', () => {});
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 1 file had imports rewritten
+```
+
+## `vpt print-file setup/index.js`
+
+```
+beforeEach(async () => { await expect(Promise.resolve(1)).resolves.toBe(1); });
+```
+
+## `node verify-review.mjs --scopes`
+
+```
+Vitest 5 passed the migrated globals-only test and setup hook in the selected scope
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/external_project_inheritance.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/external_project_inheritance.md
new file mode 100644
index 0000000000..6338822c4e
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/external_project_inheritance.md
@@ -0,0 +1,66 @@
+# external_project_inheritance
+
+Preserve external clearMocks and locator settings, and include the unresolved inheritance review in the first migration's final report.
+
+## `vpt write-file base.mjs 'export default { test: { clearMocks: true, browser: { enabled: false, locators: { exact: true } } } };
+'`
+
+
+## `vpt write-file vite.config.ts 'export default { test: { projects: [{ extends: '\''./base.mjs'\'', test: { name: '\''unit'\'', browser: { enabled: false } } }] } };
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 1 file had imports rewritten
+! Warnings:
+  - Vitest v5: 1 review item
+
+vite.config.ts
+  13:20 REVIEW [project-inheritance] Review this external or dynamic project base before adding v4 compatibility defaults. Inherited project settings were left unchanged.
+    Docs: https://vitest.dev/guide/migration/#inline-projects-inherit-the-root-config-by-default
+```
+
+## `vpt print-file vite.config.ts`
+
+```
+export default {
+  fmt: {},
+  lint: {"jsPlugins":[{"name":"vite-plus","specifier":"vite-plus/oxlint-plugin"}],"rules":{"vite-plus/prefer-vite-plus-imports":"error"},"options":{"typeAware":true,"typeCheck":true}},
+  test: {
+      // Vitest v4 compatibility: preserve mock call history.
+      // Remove after tests no longer rely on calls from setup or earlier tests.
+      // https://vitest.dev/guide/migration/#clearmocks-is-enabled-by-default
+      clearMocks: false,
+      // Vitest v4 compatibility: keep separate Vite servers for inline projects.
+      // Remove when plugins and config hooks can run once for shared projects.
+      // https://vitest.dev/guide/migration/#inline-projects-share-the-vite-server-by-default
+      sharedViteServer: false,
+      projects: [{ extends: './base.mjs', test: { name: 'unit', browser: { enabled: false } } }] }
+}
+```
+
+## `vpt print-file base.mjs`
+
+```
+export default { test: { clearMocks: true, browser: { enabled: false, locators: { exact: true } } } };
+```
+
+## `node verify-review.mjs --inheritance`
+
+```
+External base settings preserved: clearMocks=true, browser.locators.exact=true
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/global_ownership_and_sequential_timeouts.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/global_ownership_and_sequential_timeouts.md
new file mode 100644
index 0000000000..599378454e
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/global_ownership_and_sequential_timeouts.md
@@ -0,0 +1,57 @@
+# global_ownership_and_sequential_timeouts
+
+Migrate only the Vitest globals and preserve numeric sequential timeouts in runtime collection. Leave the separate Jest suite unchanged.
+
+## `vpt write-file vite.config.ts 'export default { test: { globals: true, include: ['\''unit/**/*.test.js'\''] } };
+'`
+
+
+## `vpt write-file jest.config.cjs 'module.exports = { testMatch: ['\''<rootDir>/integration/**/*.test.js'\''] };
+'`
+
+
+## `vpt write-file unit/slow.test.js 'test.sequential('\''slow test'\'', async () => {}, 15000);
+it.sequential('\''slow it'\'', async () => {}, 12000);
+'`
+
+
+## `vpt write-file integration/other.test.js 'test('\''throws'\'', () => { expect(() => { throw new Error('\''boom'\''); }).toThrow('\'''\''); });
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 1 file had imports rewritten
+```
+
+## `vpt print-file unit/slow.test.js`
+
+```
+test('slow test', { concurrent: false, timeout: 15000 }, async () => {});
+it('slow it', { concurrent: false, timeout: 12000 }, async () => {});
+```
+
+## `vpt print-file integration/other.test.js`
+
+```
+test('throws', () => { expect(() => { throw new Error('boom'); }).toThrow(''); });
+```
+
+## `node verify-review.mjs`
+
+```
+Runtime collection preserved sequential timeouts: test=15000, it=12000
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/mixed_project_assertions.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/mixed_project_assertions.md
new file mode 100644
index 0000000000..6dac312dfd
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/mixed_project_assertions.md
@@ -0,0 +1,67 @@
+# mixed_project_assertions
+
+Keep Node DOM matchers, migrate browser matchers, and report shared inputs during the v4 migration. Do not infer v4 matcher intent on a later v5 run.
+
+## `vpt write-file vite.config.ts 'export default { test: { projects: [{ test: { name: '\''node'\'', include: ['\''node.test.ts'\'', '\''shared.test.ts'\''] } }, { test: { name: '\''browser'\'', browser: { enabled: true }, include: ['\''browser.test.ts'\'', '\''shared.test.ts'\''] } }] } };
+'`
+
+
+## `vpt write-file node.test.ts 'import { expect } from '\''vitest'\'';
+expect(element).toHaveTextContent('\''partial'\'');
+'`
+
+
+## `vpt write-file browser.test.ts 'import { expect } from '\''vitest'\'';
+await expect.element(element)['\''toHaveTextContent'\'']('\''partial'\'');
+'`
+
+
+## `vpt write-file shared.test.ts 'import { expect } from '\''vitest'\'';
+expect(element).toHaveTextContent('\''partial'\'');
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 4 files had imports rewritten
+! Warnings:
+  - Vitest v5: 1 review item
+
+shared.test.ts
+  2:1 REVIEW [text-content-project] Resolve this assertion's test project: browser assertions need toMatchTextContent for v4 partial matching; keep Node jest-dom assertions unchanged.
+    Docs: https://vitest.dev/guide/migration/#tohavetextcontent-now-performs-strict-equality
+```
+
+## `vpt print-file node.test.ts`
+
+```
+import { expect } from 'vite-plus/test';
+expect(element).toHaveTextContent('partial');
+```
+
+## `vpt print-file browser.test.ts`
+
+```
+import { expect } from 'vite-plus/test';
+await expect.element(element)["toMatchTextContent"]('partial');
+```
+
+## `vpt print-file shared.test.ts`
+
+```
+import { expect } from 'vite-plus/test';
+expect(element).toHaveTextContent('partial');
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/node_preflight.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/node_preflight.md
new file mode 100644
index 0000000000..70356f2bb2
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/node_preflight.md
@@ -0,0 +1,66 @@
+# node_preflight
+
+Upgrade the unsupported runtime pin before installation, then keep it on rerun.
+
+## `vpt write-file .node-version '20.19.0
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 2 files had imports rewritten
+```
+
+## `vpt print-file .node-version`
+
+```
+22.18.0
+```
+
+## `vpt print-file package.json`
+
+```
+{
+  "name": "migration-vitest-v5",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@11.24.0",
+  "scripts": {
+    "test": "vp test list --no-static-parse"
+  },
+  "devDependencies": {
+    "vite": "catalog:",
+    "vite-plus": "catalog:"
+  }
+}
+```
+
+## `vpt print-file example.test.ts`
+
+```
+import { expect, test } from 'vite-plus/test';
+
+test('compatibility', { concurrent: false }, async () => {
+  await expect(Promise.resolve(42)).resolves.toBe(42);
+  expect(() => { throw new Error(''); }).toThrow(/^$/);
+});
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
+
+## `vpt print-file .node-version`
+
+```
+22.18.0
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/output_only_changes.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/output_only_changes.md
new file mode 100644
index 0000000000..a881b0492f
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/output_only_changes.md
@@ -0,0 +1,47 @@
+# output_only_changes
+
+Keep parameterized titles and reporter options without cosmetic compatibility edits or review prompts.
+
+## `vpt write-file example.test.ts 'import { expect, it } from '\''vitest'\'';
+it.each(['\''system'\'', '\''light'\'', '\''dark'\''])('\''accepts %s'\'', value => { expect(value).toBe(value); });
+'`
+
+
+## `vpt write-file vite.config.ts 'export default { test: { reporters: ['\''json'\'', ['\''junit'\'', {}], ['\''html'\'', { outputFile: '\''reports/index.html'\'' }]] } };
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 1 file had imports rewritten
+```
+
+## `vpt print-file vite.config.ts example.test.ts`
+
+```
+export default {
+  fmt: {},
+  lint: {"jsPlugins":[{"name":"vite-plus","specifier":"vite-plus/oxlint-plugin"}],"rules":{"vite-plus/prefer-vite-plus-imports":"error"},"options":{"typeAware":true,"typeCheck":true}},
+  test: {
+      // Vitest v4 compatibility: preserve mock call history.
+      // Remove after tests no longer rely on calls from setup or earlier tests.
+      // https://vitest.dev/guide/migration/#clearmocks-is-enabled-by-default
+      clearMocks: false,
+      reporters: ['json', ['junit', {}], ['html', { outputFile: 'reports/index.html' }]] }
+}
+import { expect, it } from 'vite-plus/test';
+it.each(['system', 'light', 'dark'])('accepts %s', value => { expect(value).toBe(value); });
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/plugin_projects_and_dom_types.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/plugin_projects_and_dom_types.md
new file mode 100644
index 0000000000..76d70d03af
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/plugin_projects_and_dom_types.md
@@ -0,0 +1,50 @@
+# plugin_projects_and_dom_types
+
+Do not scan plugin project paths as Vitest configs; report the Jest-only DOM type entry without changing a mixed test contract.
+
+## `vpt write-file vite.config.ts 'import { defineConfig } from '\''vitest/config'\'';
+const config = defineConfig({ plugins: [{ name: '\''paths'\'', projects: ['\''./tsconfig.json'\'', '\''./plugin-options.ts'\''] }], test: {} });
+export default config;
+'`
+
+
+## `vpt write-file tsconfig.json '{"compilerOptions":{"types":["@testing-library/jest-dom","vitest/globals"]}}
+'`
+
+
+## `vpt write-file plugin-options.ts 'export default { test: {} };
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 1 config update applied, 2 files had imports rewritten
+• Inline Vite plugins wrapped with lazyPlugins for check/lint/fmt
+! Warnings:
+  - Vitest v5: 2 review items
+
+tsconfig.json
+  1:1 REVIEW [jest-dom-types] If this config checks Vitest tests, load @testing-library/jest-dom/vitest in compilerOptions.types or an included TypeScript setup file. The root jest-dom type entry augments Jest, not Vitest v5.
+    Docs: https://viteplus.dev/guide/vitest-v5#review-checklist
+
+vite.config.ts
+  12:1 REVIEW [dynamic-config] Review the effective exported test config and its v4 defaults.
+    Docs: https://viteplus.dev/guide/vitest-v5#resolve-migration-findings
+```
+
+## `vpt print-file plugin-options.ts`
+
+```
+export default { test: {} };
+```
+
+## `vpt print-file tsconfig.json`
+
+```
+{"compilerOptions":{"types":["@testing-library/jest-dom","vitest/globals"]}}
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/removed_api_preflight.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/removed_api_preflight.md
new file mode 100644
index 0000000000..cc0be36ec7
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/removed_api_preflight.md
@@ -0,0 +1,50 @@
+# removed_api_preflight
+
+Show blockers and accompanying reviews once before stopping without dependency changes.
+
+## `vpt write-file custom-runner.ts 'import { startTests } from '\''@vitest/runner'\'';
+startTests([]);
+'`
+
+
+## `vpt write-file review.test.ts 'import { expect } from '\''vitest'\'';
+await expect.poll(() => 42).toBe(42);
+'`
+
+
+## `vp migrate --no-interactive`
+
+**Exit code:** 1
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Vitest v5: 2 review items (1 block dependency updates)
+
+custom-runner.ts
+  1:10 BLOCK [removed-api] Migrate startTests from @vitest/runner manually; no reviewed root v5 replacement exists.
+    Docs: https://vitest.dev/guide/migration/#removed-deprecated-entrypoints
+
+review.test.ts
+  2:7 REVIEW [poll-timeout] Review the configured expect.poll timeout; v5 rejects assertions that finish after it.
+    Docs: https://vitest.dev/guide/migration/#expect-poll-fails-when-it-times-out
+Resolve the blocking Vitest v5 findings, then re-run `vp migrate`. No project files were changed.
+```
+
+## `vpt print-file package.json`
+
+```
+{
+  "name": "migration-vitest-v5",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@11.24.0",
+  "scripts": {
+    "test": "vitest list"
+  },
+  "devDependencies": {
+    "vite": "^8.0.0",
+    "vitest": "<version>"
+  }
+}
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/review_only_rerun.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/review_only_rerun.md
new file mode 100644
index 0000000000..d9d3005f86
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/review_only_rerun.md
@@ -0,0 +1,37 @@
+# review_only_rerun
+
+Show a non-blocking review once in the final summary, and retain it on a no-op rerun without reconciling dependencies.
+
+## `vpt write-file example.test.ts 'import { test } from '\''vitest'\'';
+test('\''ui'\'', () => { const url = '\''http://localhost:51204/__vitest__/'\''; void url; });
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 2 files had imports rewritten
+! Warnings:
+  - Vitest v5: 1 review item
+
+example.test.ts
+  2:32 REVIEW [ui-token] Use the authenticated UI URL printed by Vitest, including its token.
+    Docs: https://vitest.dev/guide/migration/#vitest-ui-requires-an-authenticated-url
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Vitest v5: 1 review item
+
+example.test.ts
+  2:32 REVIEW [ui-token] Use the authenticated UI URL printed by Vitest, including its token.
+    Docs: https://vitest.dev/guide/migration/#vitest-ui-requires-an-authenticated-url
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/selected_config_and_setup_globals.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/selected_config_and_setup_globals.md
new file mode 100644
index 0000000000..b58024126e
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/selected_config_and_setup_globals.md
@@ -0,0 +1,55 @@
+# selected_config_and_setup_globals
+
+An inactive Vite config must not suppress Vitest globals. Migrate the selected test and its globals-only setup hook.
+
+## `vpt write-file vite.config.ts 'export default {};
+'`
+
+
+## `vpt write-file vitest.config.mjs 'export default { test: { globals: true, include: ['\''unit/*.test.js'\''], setupFiles: '\''./setup.js'\'' } };
+'`
+
+
+## `vpt write-file setup.js 'beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });
+'`
+
+
+## `vpt write-file unit/right.test.js 'test.sequential('\''works'\'', () => { expect(() => { throw new Error('\'''\''); }).toThrow('\'''\''); });
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 1 file had imports rewritten
+```
+
+## `vpt print-file unit/right.test.js`
+
+```
+test('works', { concurrent: false }, () => { expect(() => { throw new Error(''); }).toThrow(/^$/); });
+```
+
+## `vpt print-file setup.js`
+
+```
+beforeEach(async () => { await expect(Promise.resolve(1)).resolves.toBe(1); });
+```
+
+## `node verify-review.mjs --scopes`
+
+```
+Vitest 5 passed the migrated globals-only test and setup hook in the selected scope
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/setup_extension_precedence.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/setup_extension_precedence.md
new file mode 100644
index 0000000000..e373ba8a5f
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/setup_extension_precedence.md
@@ -0,0 +1,50 @@
+# setup_extension_precedence
+
+Prefer setup.mjs over setup.js, and leave the inactive JavaScript file unchanged.
+
+## `vpt write-file vite.config.ts 'export default { test: { globals: true, setupFiles: ['\''./setup'\''], include: ['\''unit.test.js'\''] } };
+'`
+
+
+## `vpt write-file setup.mjs 'beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });
+'`
+
+
+## `vpt write-file setup.js 'expect(() => { throw Error('\''boom'\''); }).toThrow('\'''\'');
+'`
+
+
+## `vpt write-file unit.test.js 'test('\''works'\'', () => {});
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 1 file had imports rewritten
+```
+
+## `vpt print-file setup.mjs setup.js`
+
+```
+beforeEach(async () => { await expect(Promise.resolve(1)).resolves.toBe(1); });
+expect(() => { throw Error('boom'); }).toThrow('');
+```
+
+## `node verify-review.mjs --scopes`
+
+```
+Vitest 5 passed the migrated globals-only test and setup hook in the selected scope
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/stateless_rerun.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/stateless_rerun.md
new file mode 100644
index 0000000000..d03f683577
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/stateless_rerun.md
@@ -0,0 +1,68 @@
+# stateless_rerun
+
+After upgrading, preserve new v5 choices on reruns without migration metadata. Ignore a legacy preview state file without overwriting it.
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 2 files had imports rewritten
+```
+
+## `vpt stat-file .vite-plus/migrations.json --assert missing`
+
+```
+.vite-plus/migrations.json: missing
+```
+
+## `vpt write-file vite.config.ts 'export default { test: {} };
+'`
+
+
+## `vpt write-file example.test.ts 'import { expect, test } from '\''vite-plus/test'\'';
+test('\''v5 assertion'\'', () => { expect(() => { throw new Error('\''boom'\''); }).toThrow('\'''\''); });
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
+
+## `vpt print-file vite.config.ts example.test.ts`
+
+```
+export default { test: {} };
+import { expect, test } from 'vite-plus/test';
+test('v5 assertion', () => { expect(() => { throw new Error('boom'); }).toThrow(''); });
+```
+
+## `vpt stat-file .vite-plus/migrations.json --assert missing`
+
+```
+.vite-plus/migrations.json: missing
+```
+
+## `vpt write-file .vite-plus/migrations.json 'legacy preview state: invalid JSON
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
+
+## `vpt print-file .vite-plus/migrations.json`
+
+```
+legacy preview state: invalid JSON
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/supported_engine_minimum.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/supported_engine_minimum.md
new file mode 100644
index 0000000000..77fa49699a
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/supported_engine_minimum.md
@@ -0,0 +1,45 @@
+# supported_engine_minimum
+
+Keep a public engine range with a supported minimum without a Node review across repeated migration.
+
+## `vpt json-edit package.json engines.node '>= 22.19.0'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 2 files had imports rewritten
+```
+
+## `vpt print-file package.json`
+
+```
+{
+  "devDependencies": {
+    "vite": "catalog:",
+    "vite-plus": "catalog:"
+  },
+  "engines": {
+    "node": ">= 22.19.0"
+  },
+  "name": "migration-vitest-v5",
+  "packageManager": "pnpm@11.24.0",
+  "private": true,
+  "scripts": {
+    "test": "vp test list --no-static-parse"
+  },
+  "type": "module"
+}
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/test_discovery_dir.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/test_discovery_dir.md
new file mode 100644
index 0000000000..fb411fa77c
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/test_discovery_dir.md
@@ -0,0 +1,61 @@
+# test_discovery_dir
+
+Match includes and excludes under test.dir, keep setup resolution relative to root, and preserve files outside the discovery directory.
+
+## `vpt write-file vite.config.ts 'export default { root: '\''./app'\'', test: { globals: true, dir: '\''./unit'\'', include: ['\''*.test.js'\''], exclude: ['\''excluded.test.js'\''], setupFiles: '\''../setup.js'\'' } };
+'`
+
+
+## `vpt write-file setup.js 'beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });
+'`
+
+
+## `vpt write-file unit/right.test.js 'test.sequential('\''works'\'', () => {});
+'`
+
+
+## `vpt write-file wrong.test.js 'test('\''other runner'\'', () => { expect(() => { throw Error('\''boom'\''); }).toThrow('\'''\''); });
+'`
+
+
+## `vpt write-file unit/excluded.test.js 'test.sequential('\''excluded'\'', () => {});
+'`
+
+
+## `vpt write-file app/unit/wrong.test.js 'test.sequential('\''wrong root'\'', () => {});
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 1 file had imports rewritten
+```
+
+## `vpt print-file unit/right.test.js setup.js wrong.test.js unit/excluded.test.js app/unit/wrong.test.js`
+
+```
+test('works', { concurrent: false }, () => {});
+beforeEach(async () => { await expect(Promise.resolve(1)).resolves.toBe(1); });
+test('other runner', () => { expect(() => { throw Error('boom'); }).toThrow(''); });
+test.sequential('excluded', () => {});
+test.sequential('wrong root', () => {});
+```
+
+## `node verify-review.mjs --scopes`
+
+```
+Vitest 5 passed the migrated globals-only test and setup hook in the selected scope
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/test_root_override.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/test_root_override.md
new file mode 100644
index 0000000000..39643c49d0
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/test_root_override.md
@@ -0,0 +1,61 @@
+# test_root_override
+
+test.root overrides the Vite root. Migrate only that test and setup scope, leaving the similarly named unrelated suite unchanged.
+
+## `vpt write-file vite.config.ts 'export default { root: '\''./app'\'', test: { root: '\''./unit'\'', globals: true, setupFiles: '\''./setup.js'\'' } };
+'`
+
+
+## `vpt write-file unit/setup.js 'beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });
+'`
+
+
+## `vpt write-file unit/right.test.js 'test.sequential('\''works'\'', () => {});
+'`
+
+
+## `vpt write-file app/unit/wrong.test.js 'test('\''other runner'\'', () => { expect(() => { throw new Error('\''boom'\''); }).toThrow('\'''\''); });
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 1 file had imports rewritten
+```
+
+## `vpt print-file unit/right.test.js`
+
+```
+test('works', { concurrent: false }, () => {});
+```
+
+## `vpt print-file unit/setup.js`
+
+```
+beforeEach(async () => { await expect(Promise.resolve(1)).resolves.toBe(1); });
+```
+
+## `vpt print-file app/unit/wrong.test.js`
+
+```
+test('other runner', () => { expect(() => { throw new Error('boom'); }).toThrow(''); });
+```
+
+## `node verify-review.mjs --scopes --root`
+
+```
+Vitest 5 passed the migrated globals-only test and setup hook in the selected scope
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/v4_reviews_do_not_repeat.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/v4_reviews_do_not_repeat.md
new file mode 100644
index 0000000000..21a99b497e
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/v4_reviews_do_not_repeat.md
@@ -0,0 +1,32 @@
+# v4_reviews_do_not_repeat
+
+Show execution-related v4 reviews in the first final summary, but not after upgrading to v5.
+
+## `vpt write-file example.test.ts 'import { expect, test } from '\''vitest'\'';
+test('\''poll'\'', async () => { await expect.poll(() => 42).toBe(42); });
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 2 files had imports rewritten
+! Warnings:
+  - Vitest v5: 1 review item
+
+example.test.ts
+  2:34 REVIEW [poll-timeout] Review the configured expect.poll timeout; v5 rejects assertions that finish after it.
+    Docs: https://vitest.dev/guide/migration/#expect-poll-fails-when-it-times-out
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/v5_without_compatibility_reviews.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/v5_without_compatibility_reviews.md
new file mode 100644
index 0000000000..1f4863add9
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/v5_without_compatibility_reviews.md
@@ -0,0 +1,61 @@
+# v5_without_compatibility_reviews
+
+Migrate an original Vitest v5 project without v4 default edits or behavior reviews.
+
+## `vpt json-edit package.json devDependencies.vitest 5.0.1`
+
+
+## `vpt write-file example.test.ts 'import { expect, it, test } from '\''vitest'\'';
+it.each(['\''system'\'', '\''light'\'', '\''dark'\''])('\''accepts %s'\'', value => { expect(value).toBe(value); });
+test('\''poll'\'', async () => { await expect.poll(() => 42).toBe(42); });
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 2 files had imports rewritten
+```
+
+## `vpt print-file vite.config.ts example.test.ts package.json`
+
+```
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({
+  fmt: {},
+  lint: {"jsPlugins":[{"name":"vite-plus","specifier":"vite-plus/oxlint-plugin"}],"rules":{"vite-plus/prefer-vite-plus-imports":"error"},"options":{"typeAware":true,"typeCheck":true}},
+  test: {
+    reporters: ['json', ['junit', {}]],
+    projects: [{ test: { name: 'unit' } }, { extends: true, test: { name: 'inherited' } }],
+  },
+});
+import { expect, it, test } from 'vite-plus/test';
+it.each(['system', 'light', 'dark'])('accepts %s', value => { expect(value).toBe(value); });
+test('poll', async () => { await expect.poll(() => 42).toBe(42); });
+{
+  "devDependencies": {
+    "vite": "catalog:",
+    "vite-plus": "catalog:"
+  },
+  "name": "migration-vitest-v5",
+  "packageManager": "pnpm@11.24.0",
+  "private": true,
+  "scripts": {
+    "test": "vp test list"
+  },
+  "type": "module"
+}
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/version_gate_preserves_sources.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/version_gate_preserves_sources.md
new file mode 100644
index 0000000000..4eee434d09
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/version_gate_preserves_sources.md
@@ -0,0 +1,68 @@
+# version_gate_preserves_sources
+
+A version check after initial setup must abort before Vitest compatibility edits.
+
+## `vpt write-file node_modules/vite/package.json '{"name":"vite","version":"6.4.0"}
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+**Exit code:** 1
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+✘ vite@6.4.0 in package.json is not supported by auto migration
+
+Please upgrade vite to version >=7.0.0 first
+Vite+ cannot automatically migrate this project yet.
+```
+
+## `vpt print-file vite.config.ts`
+
+```
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    reporters: ['json', ['junit', {}]],
+    projects: [{ test: { name: 'unit' } }, { extends: true, test: { name: 'inherited' } }],
+  },
+});
+```
+
+## `vpt print-file example.test.ts`
+
+```
+import { expect, test } from 'vitest';
+
+test.sequential('compatibility', () => {
+  expect(Promise.resolve(42)).resolves.toBe(42);
+  expect(() => { throw new Error(''); }).toThrow('');
+});
+```
+
+## `vpt print-file package.json`
+
+```
+{
+  "name": "migration-vitest-v5",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@11.24.0",
+  "scripts": {
+    "test": "vitest list"
+  },
+  "devDependencies": {
+    "vite": "^8.0.0",
+    "vitest": "<version>"
+  }
+}
+```
+
+## `vpt stat-file .vite-plus/migrations.json --assert missing`
+
+```
+.vite-plus/migrations.json: missing
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/volta_runtime_upgrade.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/volta_runtime_upgrade.md
new file mode 100644
index 0000000000..4d577b02c7
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/volta_runtime_upgrade.md
@@ -0,0 +1,49 @@
+# volta_runtime_upgrade
+
+Upgrade the Volta pin before converting it to .node-version, including the cached setup decision.
+
+## `vpt json-edit package.json volta.node 20.19.0`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 2 files had imports rewritten
+• Node version manager file migrated to .node-version
+→ Manual follow-up:
+  - Remove the "volta" field from package.json
+```
+
+## `vpt print-file .node-version package.json`
+
+```
+22.18.0
+{
+  "devDependencies": {
+    "vite": "catalog:",
+    "vite-plus": "catalog:"
+  },
+  "name": "migration-vitest-v5",
+  "packageManager": "pnpm@11.24.0",
+  "private": true,
+  "scripts": {
+    "test": "vp test list --no-static-parse"
+  },
+  "type": "module",
+  "volta": {
+    "node": "22.18.0"
+  }
+}
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/vue_style_global_scopes.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/vue_style_global_scopes.md
new file mode 100644
index 0000000000..640351f9e6
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/vue_style_global_scopes.md
@@ -0,0 +1,58 @@
+# vue_style_global_scopes
+
+Resolve inherited globals through callbacks, imported config defaults, conditional projects, literal command lists, and root-relative setup paths. Preserve unrelated suites.
+
+## `vpt json-edit package.json scripts.test 'node build.js && MODE=unit vitest run --project unit*'`
+
+
+## `vpt write-file vite.config.ts 'import { configDefaults, defineConfig } from '\''vite-plus'\'';
+export default defineConfig({ test: { globals: true, setupFiles: '\''scripts/setup.ts'\'', onConsoleLog(log) { return '\!'log.includes('\''quiet'\''); }, projects: [
+  { extends: true, test: { name: '\''unit'\'', include: ['\''unit/*.test.ts'\''], exclude: [...configDefaults.exclude] } },
+  ...(process.env.EXTRA ? [{ extends: true, test: { name: '\''extra'\'', include: ['\''extra/*.test.ts'\''] } }] : []),
+] } });
+'`
+
+
+## `vpt write-file scripts/setup.ts 'beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });
+'`
+
+
+## `vpt write-file unit/right.test.ts 'test.sequential('\''works'\'', () => { expect(1).toBe(1); });
+'`
+
+
+## `vpt write-file other/wrong.test.ts 'test('\''other runner'\'', () => { expect(() => { throw Error('\''boom'\''); }).toThrow('\'''\''); });
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 1 file had imports rewritten
+```
+
+## `vpt print-file unit/right.test.ts scripts/setup.ts other/wrong.test.ts`
+
+```
+test('works', { concurrent: false }, () => { expect(1).toBe(1); });
+beforeEach(async () => { await expect(Promise.resolve(1)).resolves.toBe(1); });
+test('other runner', () => { expect(() => { throw Error('boom'); }).toThrow(''); });
+```
+
+## `node verify-review.mjs --scopes`
+
+```
+Vitest 5 passed the migrated globals-only test and setup hook in the selected scope
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/workspace_gitignore.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/workspace_gitignore.md
new file mode 100644
index 0000000000..045274e0a2
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/workspace_gitignore.md
@@ -0,0 +1,71 @@
+# workspace_gitignore
+
+Reuse the root .vitest/ rule without creating or changing workspace package ignore files.
+
+## `vpt write-file pnpm-workspace.yaml 'packages:
+  - packages/*
+'`
+
+
+## `vpt write-file .gitignore 'node_modules/
+.vitest/
+'`
+
+
+## `vpt write-file packages/a/package.json '{"name":"a","private":true,"devDependencies":{"vitest":"4.1.11"}}
+'`
+
+
+## `vpt write-file packages/b/package.json '{"name":"b","private":true,"devDependencies":{"vitest":"4.1.11"}}
+'`
+
+
+## `vpt write-file packages/b/.gitignore 'dist/
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 2 files had imports rewritten
+```
+
+## `vpt print-file .gitignore packages/b/.gitignore`
+
+```
+node_modules/
+.vitest/
+dist/
+```
+
+## `vpt stat-file packages/a/.gitignore --assert missing`
+
+```
+packages/a/.gitignore: missing
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
+
+## `vpt print-file .gitignore packages/b/.gitignore`
+
+```
+node_modules/
+.vitest/
+dist/
+```
+
+## `vpt stat-file packages/a/.gitignore --assert missing`
+
+```
+packages/a/.gitignore: missing
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/verify-benchmark-output.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/verify-benchmark-output.mjs
new file mode 100644
index 0000000000..6abe1b99da
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/verify-benchmark-output.mjs
@@ -0,0 +1,19 @@
+import assert from 'node:assert/strict';
+import { readFileSync } from 'node:fs';
+
+for (const file of process.argv.slice(2)) {
+  const report = JSON.parse(readFileSync(file, 'utf8'));
+  assert.equal(report.success, true);
+  assert.equal(report.numPassedTests, 1);
+  assert.equal(report.testResults.length, 1);
+  const [test] = report.testResults[0].assertionResults;
+  assert.equal(test.title, 'parse');
+  assert.equal(test.status, 'passed');
+  assert.equal(test.benchmarks.length, 1);
+  const [benchmark] = test.benchmarks;
+  assert.equal(benchmark.name, 'utilities > parse');
+  assert.equal(benchmark.tasks.length, 1);
+  assert.equal(benchmark.tasks[0].name, 'parse');
+  assert.ok(benchmark.tasks[0].totalTime > 0);
+  console.log(`${file}: migrated benchmark passed and JSON includes its result`);
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/verify-benchmark-regressions.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/verify-benchmark-regressions.mjs
new file mode 100644
index 0000000000..992e29d30c
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/verify-benchmark-regressions.mjs
@@ -0,0 +1,20 @@
+import assert from 'node:assert/strict';
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+
+const [file, ...names] = process.argv.slice(2);
+const report = JSON.parse(readFileSync('benchmark.json', 'utf8'));
+assert.equal(report.success, true);
+assert.equal(report.numPassedTests, names.length);
+assert.equal(report.testResults.length, 1);
+const [result] = report.testResults;
+assert.equal(path.normalize(result.name), path.resolve(file));
+assert.deepEqual(result.assertionResults.map(test => test.title), names);
+for (const test of result.assertionResults) {
+  assert.equal(test.status, 'passed');
+  assert.equal(test.benchmarks.length, 1);
+  assert.equal(test.benchmarks[0].tasks.length, 1);
+  assert.equal(test.benchmarks[0].tasks[0].name, test.title);
+  assert.ok(test.benchmarks[0].tasks[0].totalTime > 0);
+}
+console.log(`Vitest 5 executed ${names.length} migrated benchmarks in ${file}`);
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/verify-benchmarks.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/verify-benchmarks.mjs
new file mode 100644
index 0000000000..bfe48cc110
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/verify-benchmarks.mjs
@@ -0,0 +1,23 @@
+import assert from 'node:assert/strict';
+import { createVitest } from 'vite-plus/test/node';
+
+const runner = await createVitest({ watch: false, reporters: [], benchmark: { enabled: true } });
+try {
+  const result = await runner.start();
+  assert.equal(result.unhandledErrors.length, 0, JSON.stringify(result.unhandledErrors));
+  const files = runner.state.getFiles();
+  assert.equal(files.length, 1);
+  assert.equal(files[0].result.state, 'pass', JSON.stringify(files[0].result));
+  const tests = files[0].tasks[0].tasks;
+  assert.deepEqual(tests.map(({ name, mode, result }) => [name, result?.state ?? mode]), [
+    ['parse', 'pass'],
+    ['async', 'pass'],
+    ['skipped', 'skip'],
+    ['later', 'todo'],
+  ]);
+  assert.equal(tests[0].benchmarks.length, 1);
+  assert.equal(tests[1].benchmarks.length, 1);
+  console.log('Vitest 5 executed both migrated benchmarks and preserved skip/todo modifiers');
+} finally {
+  await runner.close();
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/verify-review.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/verify-review.mjs
new file mode 100644
index 0000000000..895953ca77
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/verify-review.mjs
@@ -0,0 +1,41 @@
+import assert from 'node:assert/strict';
+import path from 'node:path';
+import { createVitest } from 'vite-plus/test/node';
+
+const scopeCheck = process.argv.includes('--scopes');
+const dirIndex = process.argv.indexOf('--dir');
+const runner = await createVitest({ config: scopeCheck ? undefined : './vite.config.ts', ...(dirIndex >= 0 ? { dir: process.argv[dirIndex + 1] } : {}), watch: false, reporters: [] });
+try {
+  if (scopeCheck) {
+    assert.equal(runner.projects.length, 1);
+    assert.equal(runner.projects[0].config.globals, true);
+    if (process.argv.includes('--root')) {
+      // Vitest uses forward slashes even on Windows; compare native paths.
+      assert.equal(path.normalize(runner.projects[0].config.root), path.join(process.cwd(), 'unit'));
+    }
+    const result = await runner.start();
+    assert.equal(result.unhandledErrors.length, 0, JSON.stringify(result.unhandledErrors));
+    assert.equal(runner.state.getCountOfFailedTests(), 0, JSON.stringify(runner.state.getFiles().map(file => file.result)));
+    assert.equal(runner.state.getFiles().length, 1);
+    assert.equal(runner.state.getFiles()[0].tasks.length, 1);
+    console.log('Vitest 5 passed the migrated globals-only test and setup hook in the selected scope');
+  } else if (process.argv.includes('--inheritance')) {
+    const project = runner.getProjectByName('unit');
+    assert.equal(project.config.clearMocks, true);
+    assert.equal(project.config.browser.locators.exact, true);
+    console.log('External base settings preserved: clearMocks=true, browser.locators.exact=true');
+  } else {
+    const result = await runner.collect([], { staticParse: false });
+    assert.equal(result.unhandledErrors.length, 0, JSON.stringify(result.unhandledErrors));
+    const tasks = runner.state.getFiles().flatMap((file) => file.tasks);
+    assert.equal(tasks.length, 2);
+    // The collector leaves concurrent undefined for sequential tasks.
+    assert.deepEqual(tasks.map(({ name, timeout, concurrent }) => ({ name, timeout, concurrent: !!concurrent })), [
+      { name: 'slow test', timeout: 15000, concurrent: false },
+      { name: 'slow it', timeout: 12000, concurrent: false },
+    ]);
+    console.log('Runtime collection preserved sequential timeouts: test=15000, it=12000');
+  }
+} finally {
+  await runner.close();
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/vite.config.ts b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/vite.config.ts
new file mode 100644
index 0000000000..0c35ccb6e7
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/vite.config.ts
@@ -0,0 +1,8 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    reporters: ['json', ['junit', {}]],
+    projects: [{ test: { name: 'unit' } }, { extends: true, test: { name: 'inherited' } }],
+  },
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_entry_points/entries.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_entry_points/entries.mjs
new file mode 100644
index 0000000000..68d10c9435
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_entry_points/entries.mjs
@@ -0,0 +1,8 @@
+import { BaseCoverageProvider } from 'vite-plus/test/coverage';
+export { DefaultReporter } from 'vite-plus/test/reporters';
+export * as environments from 'vite-plus/test/environments';
+export { VitestSnapshotEnvironment } from 'vite-plus/test/snapshot';
+export * as mocker from 'vite-plus/test/mocker';
+
+export { BaseCoverageProvider };
+export const loadEnvironment = () => import('vite-plus/test/environments');
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_entry_points/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_entry_points/package.json
new file mode 100644
index 0000000000..899241839d
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_entry_points/package.json
@@ -0,0 +1,9 @@
+{
+  "name": "migration-vitest-v5-entry-points",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@11.24.0",
+  "devDependencies": {
+    "vitest": "4.1.11"
+  }
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_entry_points/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_entry_points/snapshots.toml
new file mode 100644
index 0000000000..afaafce2df
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_entry_points/snapshots.toml
@@ -0,0 +1,15 @@
+[[case]]
+name = "legacy_test_entry_points"
+vp = "global"
+comment = "Migrate legacy test aliases on fresh and existing Vite+ projects. Check runtime exports and a no-op rerun."
+steps = [
+  { argv = ["vpt", "cp", "entries.mjs", "entries.before"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "entries.mjs"],
+  ["node", "verify.mjs"],
+  { argv = ["vpt", "cp", "entries.before", "entries.mjs"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "entries.mjs"],
+  ["node", "verify.mjs"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_entry_points/snapshots/legacy_test_entry_points.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_entry_points/snapshots/legacy_test_entry_points.md
new file mode 100644
index 0000000000..a0651af50b
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_entry_points/snapshots/legacy_test_entry_points.md
@@ -0,0 +1,77 @@
+# legacy_test_entry_points
+
+Migrate legacy test aliases on fresh and existing Vite+ projects. Check runtime exports and a no-op rerun.
+
+## `vpt cp entries.mjs entries.before`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 1 config update applied, 1 file had imports rewritten
+```
+
+## `vpt print-file entries.mjs`
+
+```
+import { BaseCoverageProvider } from "vite-plus/test/node";
+export { DefaultReporter } from "vite-plus/test/node";
+export * as environments from 'vite-plus/test/runtime';
+export { VitestSnapshotEnvironment } from "vite-plus/test/runtime";
+export * as mocker from 'vite-plus/test/mocker';
+
+export { BaseCoverageProvider };
+export const loadEnvironment = () => import('vite-plus/test/runtime');
+```
+
+## `node verify.mjs`
+
+```
+Canonical entry points load; legacy aliases are absent; mocker remains available.
+```
+
+## `vpt cp entries.before entries.mjs`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Updated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• Dependencies:
+    vite   → <version>
+• 1 file had imports rewritten
+```
+
+## `vpt print-file entries.mjs`
+
+```
+import { BaseCoverageProvider } from 'vite-plus/test/node';
+export { DefaultReporter } from 'vite-plus/test/node';
+export * as environments from 'vite-plus/test/runtime';
+export { VitestSnapshotEnvironment } from 'vite-plus/test/runtime';
+export * as mocker from 'vite-plus/test/mocker';
+
+export { BaseCoverageProvider };
+export const loadEnvironment = () => import('vite-plus/test/runtime');
+```
+
+## `node verify.mjs`
+
+```
+Canonical entry points load; legacy aliases are absent; mocker remains available.
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_entry_points/verify.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_entry_points/verify.mjs
new file mode 100644
index 0000000000..6426de7ef2
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_entry_points/verify.mjs
@@ -0,0 +1,21 @@
+import assert from 'node:assert/strict';
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+
+import * as entries from './entries.mjs';
+
+assert.equal(typeof entries.BaseCoverageProvider, 'function');
+assert.equal(typeof entries.DefaultReporter, 'function');
+assert.equal(typeof entries.environments.populateGlobal, 'function');
+assert.equal(typeof entries.VitestSnapshotEnvironment, 'function');
+assert.ok(Object.keys(entries.mocker).length > 0);
+assert.equal((await entries.loadEnvironment()).populateGlobal, entries.environments.populateGlobal);
+
+const require = createRequire(import.meta.url);
+const source = readFileSync(new URL('./entries.mjs', import.meta.url), 'utf8');
+for (const name of ['coverage', 'reporters', 'environments', 'snapshot']) {
+  const specifier = `vite-plus/test/${name}`;
+  assert.ok(!source.includes(specifier), `Unmigrated import: ${specifier}`);
+  assert.throws(() => require.resolve(specifier), { code: 'ERR_PACKAGE_PATH_NOT_EXPORTED' });
+}
+console.log('Canonical entry points load; legacy aliases are absent; mocker remains available.');
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_workspace_usage/examples/vite-8/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_workspace_usage/examples/vite-8/package.json
new file mode 100644
index 0000000000..750af349dc
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_workspace_usage/examples/vite-8/package.json
@@ -0,0 +1,11 @@
+{
+  "name": "example",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.11"
+  }
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_workspace_usage/examples/vite-8/unit.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_workspace_usage/examples/vite-8/unit.test.js
new file mode 100644
index 0000000000..e7df2e8cf6
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_workspace_usage/examples/vite-8/unit.test.js
@@ -0,0 +1,5 @@
+import { expect, test } from 'vitest';
+
+test.sequential('works', () => {
+  expect(() => { throw new Error(''); }).toThrow('');
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_workspace_usage/examples/vite-8/vitest.config.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_workspace_usage/examples/vite-8/vitest.config.mjs
new file mode 100644
index 0000000000..9733eb62fc
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_workspace_usage/examples/vite-8/vitest.config.mjs
@@ -0,0 +1 @@
+export default { test: { globals: true } };
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_workspace_usage/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_workspace_usage/package.json
new file mode 100644
index 0000000000..677dbfb34c
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_workspace_usage/package.json
@@ -0,0 +1,9 @@
+{
+  "name": "plugin-workspace",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@11.24.0",
+  "devDependencies": {
+    "vite": "^8.0.0"
+  }
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_workspace_usage/pnpm-workspace.yaml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_workspace_usage/pnpm-workspace.yaml
new file mode 100644
index 0000000000..fe455acd71
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_workspace_usage/pnpm-workspace.yaml
@@ -0,0 +1,2 @@
+packages:
+  - examples/*
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_workspace_usage/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_workspace_usage/snapshots.toml
new file mode 100644
index 0000000000..52e674090e
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_workspace_usage/snapshots.toml
@@ -0,0 +1,12 @@
+[[case]]
+name = "migrate_only_the_vitest_member"
+vp = "global"
+comment = "A Vitest package-name string in the root plugin must not block migration of its Vitest v4 example. Repeated migration does not create a state file."
+steps = [
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "src/index.ts", "examples/vite-8/unit.test.js"],
+  ["vpt", "stat-file", ".vite-plus/migrations.json", "--assert", "missing"],
+  { argv = ["vp", "test", "run"], cwd = "examples/vite-8" },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "stat-file", ".vite-plus/migrations.json", "--assert", "missing"],
+]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_workspace_usage/snapshots/migrate_only_the_vitest_member.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_workspace_usage/snapshots/migrate_only_the_vitest_member.md
new file mode 100644
index 0000000000..4b55c53b83
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_workspace_usage/snapshots/migrate_only_the_vitest_member.md
@@ -0,0 +1,63 @@
+# migrate_only_the_vitest_member
+
+A Vitest package-name string in the root plugin must not block migration of its Vitest v4 example. Repeated migration does not create a state file.
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 1 config update applied, 1 file had imports rewritten
+```
+
+## `vpt print-file src/index.ts examples/vite-8/unit.test.js`
+
+```
+// Tool names are not imports or evidence that this package runs Vitest.
+export const NON_RUNTIME_PKGS = ['vite', 'vitest'];
+import { expect, test } from 'vite-plus/test';
+
+test('works', { concurrent: false }, () => {
+  expect(() => { throw new Error(''); }).toThrow(/^$/);
+});
+```
+
+## `vpt stat-file .vite-plus/migrations.json --assert missing`
+
+```
+.vite-plus/migrations.json: missing
+```
+
+## `cd examples/vite-8 && vp test run`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+note: You are running `vp test` as a Vite+ built-in command. If you meant to run the test npm script, use `vpr test` instead.
+
+ RUN  <version> <workspace>/examples/vite-8
+
+ ✓ unit.test.js (1 test) <duration>
+   ✓ works <duration>
+
+ Test Files  1 passed (1)
+      Tests  1 passed (1)
+   Start at  <time>
+   Duration  <duration> (<timing>)
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
+
+## `vpt stat-file .vite-plus/migrations.json --assert missing`
+
+```
+.vite-plus/migrations.json: missing
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_workspace_usage/src/index.ts b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_workspace_usage/src/index.ts
new file mode 100644
index 0000000000..fa0558c773
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5_workspace_usage/src/index.ts
@@ -0,0 +1,2 @@
+// Tool names are not imports or evidence that this package runs Vitest.
+export const NON_RUNTIME_PKGS = ['vite', 'vitest'];
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta/package.json
index 2b9893f340..05a285f697 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta/package.json
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta/package.json
@@ -4,7 +4,7 @@
     "vite": "^7.0.0"
   },
   "volta": {
-    "node": "20.19.0",
+    "node": "24.11.0",
     "npm": "10.2.5"
   }
 }
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta/snapshots/migration_volta.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta/snapshots/migration_volta.md
index 2b17219a50..85227f734c 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta/snapshots/migration_volta.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta/snapshots/migration_volta.md
@@ -20,7 +20,7 @@ VITE+ - The Unified Toolchain for the Web
 check .node-version is created from volta.node
 
 ```
-20.19.0
+24.11.0
 ```
 
 ## `vpt print-file package.json`
@@ -35,7 +35,7 @@ volta field is preserved in package.json (not removed)
     "vite-plus": "catalog:"
   },
   "volta": {
-    "node": "20.19.0",
+    "node": "24.11.0",
     "npm": "10.2.5"
   },
   "devEngines": {
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta_with_nvmrc/.nvmrc b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta_with_nvmrc/.nvmrc
index 5f53e875de..c519bf5baa 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta_with_nvmrc/.nvmrc
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta_with_nvmrc/.nvmrc
@@ -1 +1 @@
-v20.19.0
+v24.11.0
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta_with_nvmrc/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta_with_nvmrc/snapshots.toml
index e2a1e969b6..4c41cf96b4 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta_with_nvmrc/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta_with_nvmrc/snapshots.toml
@@ -3,7 +3,7 @@ name = "migration_volta_with_nvmrc"
 vp = "global"
 steps = [
   { argv = ["vp", "migrate", "--no-interactive"], comment = ".nvmrc should take priority over volta.node", continue-on-failure = true },
-  { argv = ["vpt", "print-file", ".node-version"], comment = "check .node-version comes from .nvmrc (v20.19.0), not volta.node (18.0.0)", continue-on-failure = true },
+  { argv = ["vpt", "print-file", ".node-version"], comment = "check .node-version comes from .nvmrc (v24.11.0), not volta.node (18.0.0)", continue-on-failure = true },
   { argv = ["vpt", "stat-file", ".nvmrc", "--assert-not", "file"], comment = "check .nvmrc is removed", continue-on-failure = true },
   { argv = ["vpt", "print-file", "package.json"], comment = "volta field must remain intact", continue-on-failure = true },
 ]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta_with_nvmrc/snapshots/migration_volta_with_nvmrc.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta_with_nvmrc/snapshots/migration_volta_with_nvmrc.md
index 9cb0ddf50f..cb3c2e856c 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta_with_nvmrc/snapshots/migration_volta_with_nvmrc.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta_with_nvmrc/snapshots/migration_volta_with_nvmrc.md
@@ -17,10 +17,10 @@ VITE+ - The Unified Toolchain for the Web
 
 ## `vpt print-file .node-version`
 
-check .node-version comes from .nvmrc (v20.19.0), not volta.node (18.0.0)
+check .node-version comes from .nvmrc (v24.11.0), not volta.node (18.0.0)
 
 ```
-20.19.0
+24.11.0
 ```
 
 ## `vpt stat-file .nvmrc --assert-not file`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/pm_version/snapshots/pm_version_yarn_berry.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/pm_version/snapshots/pm_version_yarn_berry.md
index 01aecb2e15..5c1800048f 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/pm_version/snapshots/pm_version_yarn_berry.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/pm_version/snapshots/pm_version_yarn_berry.md
@@ -7,7 +7,7 @@ Yarn Berry bumps the package version
 ```
 ➤ YN0000: pm-version-yarn-berry@workspace:.: Bumped to 1.0.1
 
-➤ YN0000: Done in <duration> <duration>
+➤ YN0000: Done in <duration>
 ➤ YN0000: · Yarn <version>
 ➤ YN0000: ┌ Resolution step
 ➤ YN0000: └ Completed
@@ -15,7 +15,7 @@ Yarn Berry bumps the package version
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
 
 ## `vp pm version 2.0.0 --json`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_inline_snapshot_indent/snapshots/test_inline_snapshot_indent.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_inline_snapshot_indent/snapshots/test_inline_snapshot_indent.md
index 871bcffef7..f5be99adbd 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_inline_snapshot_indent/snapshots/test_inline_snapshot_indent.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_inline_snapshot_indent/snapshots/test_inline_snapshot_indent.md
@@ -16,7 +16,7 @@ write inline snapshot via --update (regression test for #1553)
  Test Files  1 passed (1)
       Tests  1 passed (1)
    Start at  <time>
-   Duration  <duration> (transform <duration>, setup <duration>, import <duration>, tests <duration>, environment <duration>)
+   Duration  <duration> (<timing>)
 ```
 
 ## `vpt print-file src/inline-snapshot.test.ts`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_managed_package_manager_path/snapshots/test_managed_package_manager_path.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_managed_package_manager_path/snapshots/test_managed_package_manager_path.md
index a6794df8b2..2a4fb2e166 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_managed_package_manager_path/snapshots/test_managed_package_manager_path.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_managed_package_manager_path/snapshots/test_managed_package_manager_path.md
@@ -25,5 +25,5 @@ VITE+ - The Unified Toolchain for the Web
  Test Files  1 passed (1)
       Tests  1 passed (1)
    Start at  <time>
-   Duration  <duration> (transform <duration>, setup <duration>, import <duration>, tests <duration>, environment <duration>)
+   Duration  <duration> (<timing>)
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/config.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/config.mjs
new file mode 100644
index 0000000000..6ce5bd8860
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/config.mjs
@@ -0,0 +1,94 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { defineConfig, defineProject } from 'vite-plus';
+import { playwright } from 'vite-plus/test/browser-playwright';
+
+const require = createRequire(import.meta.resolve('vite-plus/package.json'));
+const executablePath = existsSync('chromium-path.json')
+  ? JSON.parse(readFileSync('chromium-path.json', 'utf8'))
+  : require('playwright').chromium.executablePath();
+
+export function project(name, browser = true) {
+  return {
+    define: {
+      __VP_STRING_DEFINE__: JSON.stringify('/messages?locale="en"'),
+      __VP_FALSE_DEFINE__: 'false',
+      __VP_TRUE_DEFINE__: 'true',
+      __VP_NUMBER_DEFINE__: '0',
+      __VP_OBJECT_DEFINE__: JSON.stringify({ url: '/messages', enabled: false }),
+      __VP_EXPRESSION_DEFINE__: '1 + 2',
+      'globalThis.__VP_DOTTED_DEFINE__': JSON.stringify('dotted'),
+    },
+    test: {
+      name,
+      slowTestThreshold: 60000,
+      include: ['defines.test.js'],
+      ...(browser ? {
+        browser: {
+          enabled: true,
+          headless: true,
+          provider: playwright({ launchOptions: { executablePath } }),
+          instances: [{ browser: 'chromium' }],
+        },
+      } : {}),
+    },
+  };
+}
+
+export function configFor(name) {
+  switch (name) {
+    case 'injected-hook': {
+      const config = project('root');
+      config.plugins = [{
+        name: 'inject-browser-project',
+        configureVitest: {
+          order: 'pre',
+          async handler({ injectTestProjects }) {
+            await injectTestProjects({ extends: false, ...project('hook-injected') });
+          },
+        },
+      }];
+      return config;
+    }
+    case 'injected': return project('root');
+    case 'raw': return project('raw');
+    case 'helper': return defineConfig(project('helper'));
+    case 'shared': {
+      const config = project('shared');
+      config.test.browser.instances = [
+        { name: 'first-instance', browser: 'chromium' },
+        { name: 'second-instance', browser: 'chromium' },
+      ];
+      return config;
+    }
+    case 'shared-node': {
+      const config = project('root', false);
+      config.test.projects = [{ test: { name: 'first' } }, { test: { name: 'second' } }];
+      return config;
+    }
+    case 'inherited': {
+      const config = project('root');
+      config.test.projects = [
+        { test: project('shared').test },
+        { extends: true, test: project('inherited').test },
+      ];
+      return config;
+    }
+    case 'separate': {
+      const config = project('root');
+      config.test.sharedViteServer = false;
+      config.test.projects = [{ test: project('first').test }, { test: project('second').test }];
+      return config;
+    }
+    case 'independent': return {
+      test: { projects: [
+        { extends: false, ...project('raw-independent') },
+        defineProject({ extends: false, ...project('helper-independent') }),
+        { extends: false, ...project('node', false) },
+      ] },
+    };
+    case 'referenced': return { test: { projects: ['./vitest.raw.config.mjs', './vitest.helper.config.mjs'] } };
+    case 'nested': return { test: { projects: ['./vitest.nested.config.mjs'] } };
+    default: throw new Error(`Unknown config ${name}`);
+  }
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/defines.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/defines.test.js
new file mode 100644
index 0000000000..b1e5cb7158
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/defines.test.js
@@ -0,0 +1,24 @@
+import { expect, test } from 'vite-plus/test';
+
+test('string defines preserve quotes inside the value', () => {
+  expect(globalThis['__VP_STRING_DEFINE__']).toBe('/messages?locale="en"');
+  expect(__VP_STRING_DEFINE__).toBe('/messages?locale="en"');
+});
+
+test('boolean defines retain their values and truthiness', () => {
+  expect(globalThis['__VP_FALSE_DEFINE__']).toBe(false);
+  expect(Boolean(globalThis['__VP_FALSE_DEFINE__'])).toBe(false);
+  expect(__VP_FALSE_DEFINE__).toBe(false);
+  expect(globalThis['__VP_TRUE_DEFINE__']).toBe(true);
+  expect(__VP_TRUE_DEFINE__).toBe(true);
+});
+
+test('number, object, expression, and dotted defines retain Vite semantics', () => {
+  expect(globalThis['__VP_NUMBER_DEFINE__']).toBe(0);
+  expect(__VP_NUMBER_DEFINE__).toBe(0);
+  expect(globalThis['__VP_OBJECT_DEFINE__']).toEqual({ url: '/messages', enabled: false });
+  expect(__VP_OBJECT_DEFINE__).toEqual({ url: '/messages', enabled: false });
+  expect(globalThis['__VP_EXPRESSION_DEFINE__']).toBe(3);
+  expect(__VP_EXPRESSION_DEFINE__).toBe(3);
+  expect(globalThis['__VP_DOTTED_DEFINE__']).toBe('dotted');
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/package.json
new file mode 100644
index 0000000000..4c300936d8
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/package.json
@@ -0,0 +1,5 @@
+{
+  "name": "test-v5-browser-defines",
+  "private": true,
+  "type": "module"
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/prepare-local.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/prepare-local.mjs
new file mode 100644
index 0000000000..ec56b0f8c9
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/prepare-local.mjs
@@ -0,0 +1,9 @@
+import { mkdirSync, symlinkSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, resolve } from 'node:path';
+
+// Raw configs use upstream resolution, so expose their direct runner dependency
+// in the staged fixture, as the packed case does through its package manager.
+const require = createRequire(import.meta.resolve('vite-plus/package.json'));
+mkdirSync('node_modules', { recursive: true });
+symlinkSync(dirname(require.resolve('vitest/package.json')), resolve('node_modules/vitest'), 'junction');
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/prepare-packed.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/prepare-packed.mjs
new file mode 100644
index 0000000000..a1c7d48a4a
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/prepare-packed.mjs
@@ -0,0 +1,23 @@
+import assert from 'node:assert/strict';
+import { existsSync, writeFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+
+// Reuse the checkout's browser binary, but install all JS packages from tarballs.
+const require = createRequire(import.meta.resolve('vite-plus/package.json'));
+const executable = require('playwright').chromium.executablePath();
+assert.ok(existsSync(executable), `Chromium is not installed at ${executable}`);
+writeFileSync('chromium-path.json', JSON.stringify(executable));
+
+// Follow the selected runner across Vitest upgrades without installing a second copy.
+const version = require('vitest/package.json').version;
+writeFileSync('package.json', JSON.stringify({
+  name: 'test-v5-browser-defines',
+  private: true,
+  type: 'module',
+  packageManager: 'pnpm@11.24.0',
+  devDependencies: {
+    'vite-plus': 'latest',
+    vitest: version,
+    '@vitest/browser-playwright': version,
+  },
+}, null, 2));
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/snapshots.toml
new file mode 100644
index 0000000000..5f049d0e93
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/snapshots.toml
@@ -0,0 +1,28 @@
+[[case]]
+name = "browser_defines"
+vp = "local"
+# The multi-project matrix launches many browsers. Keep other snapshot cases
+# from competing with browser startup; retain the matrix's own parallel projects.
+serial = true
+env = { PLAYWRIGHT_BROWSERS_PATH = "0" }
+comment = "Regression for Vitest #11198, fixed upstream in 5.0.1. Raw configs, project inheritance, programmatic APIs, and the CLI must preserve define values without a Vite+ backport."
+steps = [
+  { argv = ["node", "prepare-local.mjs"], snapshot = false },
+  { argv = ["node", "verify.mjs"], timeout = 180000 },
+  { argv = ["vp", "test", "--config", "vite.config.mjs"], timeout = 120000 },
+]
+
+[[case]]
+name = "packed_browser_defines"
+vp = "global"
+# Use the same isolation as the local matrix, including under Windows nextest.
+serial = true
+local-registry = true
+env = { PLAYWRIGHT_BROWSERS_PATH = "0" }
+comment = "The define regression must also pass with published-package layouts and install scripts disabled."
+steps = [
+  { argv = ["node", "prepare-packed.mjs"], snapshot = false },
+  { argv = ["vp", "install", "--ignore-scripts"], timeout = 180000, snapshot = false },
+  { argv = ["node", "verify.mjs", "--packed"], timeout = 180000 },
+  { argv = ["vp", "test", "--config", "vite.config.mjs"], timeout = 120000 },
+]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/snapshots/browser_defines.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/snapshots/browser_defines.md
new file mode 100644
index 0000000000..7336ea3834
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/snapshots/browser_defines.md
@@ -0,0 +1,60 @@
+# browser_defines
+
+Regression for Vitest #11198, fixed upstream in 5.0.1. Raw configs, project inheritance, programmatic APIs, and the CLI must preserve define values without a Vite+ backport.
+
+## `node prepare-local.mjs`
+
+
+## `node verify.mjs`
+
+```
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+raw: 1 projects; string, boolean, number, object, expression, and dotted defines passed
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+helper: 1 projects; string, boolean, number, object, expression, and dotted defines passed
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+shared: 2 projects; string, boolean, number, object, expression, and dotted defines passed
+shared-node: 2 projects; string, boolean, number, object, expression, and dotted defines passed
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+inherited: 2 projects; string, boolean, number, object, expression, and dotted defines passed
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+separate: 2 projects; string, boolean, number, object, expression, and dotted defines passed
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+independent: 3 projects; string, boolean, number, object, expression, and dotted defines passed
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+referenced: 2 projects; string, boolean, number, object, expression, and dotted defines passed
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+nested: 2 projects; string, boolean, number, object, expression, and dotted defines passed
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+injected: 3 projects; string, boolean, number, object, expression, and dotted defines passed
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+injected-hook: 2 projects; string, boolean, number, object, expression, and dotted defines passed
+```
+
+## `vp test --config vite.config.mjs`
+
+```
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+
+ RUN  <version> <workspace>
+      API started at http://localhost:<port>/
+
+ ✓  raw (chromium)  defines.test.js (3 tests) <duration>
+   ✓ string defines preserve quotes inside the value <duration>
+   ✓ boolean defines retain their values and truthiness <duration>
+   ✓ number, object, expression, and dotted defines retain Vite semantics <duration>
+
+ Test Files  1 passed (1)
+      Tests  3 passed (3)
+   Start at  <time>
+   Duration  <duration> (<timing>)
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/snapshots/packed_browser_defines.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/snapshots/packed_browser_defines.md
new file mode 100644
index 0000000000..c21ee19795
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/snapshots/packed_browser_defines.md
@@ -0,0 +1,65 @@
+# packed_browser_defines
+
+The define regression must also pass with published-package layouts and install scripts disabled.
+
+## `node prepare-packed.mjs`
+
+
+## `vp install --ignore-scripts`
+
+
+## `node verify.mjs --packed`
+
+```
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+raw: 1 projects; string, boolean, number, object, expression, and dotted defines passed
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+helper: 1 projects; string, boolean, number, object, expression, and dotted defines passed
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+shared: 2 projects; string, boolean, number, object, expression, and dotted defines passed
+shared-node: 2 projects; string, boolean, number, object, expression, and dotted defines passed
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+inherited: 2 projects; string, boolean, number, object, expression, and dotted defines passed
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+separate: 2 projects; string, boolean, number, object, expression, and dotted defines passed
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+independent: 3 projects; string, boolean, number, object, expression, and dotted defines passed
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+referenced: 2 projects; string, boolean, number, object, expression, and dotted defines passed
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+nested: 2 projects; string, boolean, number, object, expression, and dotted defines passed
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+injected: 3 projects; string, boolean, number, object, expression, and dotted defines passed
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+injected-hook: 2 projects; string, boolean, number, object, expression, and dotted defines passed
+```
+
+## `vp test --config vite.config.mjs`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+
+ RUN  <version> <workspace>
+      API started at http://localhost:<port>/
+
+ ✓  raw (chromium)  defines.test.js (3 tests) <duration>
+   ✓ string defines preserve quotes inside the value <duration>
+   ✓ boolean defines retain their values and truthiness <duration>
+   ✓ number, object, expression, and dotted defines retain Vite semantics <duration>
+
+ Test Files  1 passed (1)
+      Tests  3 passed (3)
+   Start at  <time>
+   Duration  <duration> (<timing>)
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/verify.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/verify.mjs
new file mode 100644
index 0000000000..c80182527d
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/verify.mjs
@@ -0,0 +1,43 @@
+import assert from 'node:assert/strict';
+import { realpathSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { isAbsolute, relative } from 'node:path';
+import { inspect } from 'node:util';
+import { createVitest } from 'vite-plus/test/node';
+import { configFor, project } from './config.mjs';
+
+if (process.argv.includes('--packed')) {
+  const require = createRequire(import.meta.resolve('vite-plus/package.json'));
+  for (const name of ['vite-plus', 'vite', 'vitest', '@vitest/browser-playwright']) {
+    const installed = relative(realpathSync(process.cwd()), realpathSync(require.resolve(`${name}/package.json`)));
+    assert.ok(!isAbsolute(installed) && !installed.startsWith('..'), `${name} must come from the packed installation: ${installed}`);
+  }
+}
+
+for (const [name, count] of [['raw', 1], ['helper', 1], ['shared', 2], ['shared-node', 2], ['inherited', 2], ['separate', 2], ['independent', 3], ['referenced', 2], ['nested', 2], ['injected', 3], ['injected-hook', 2]]) {
+  const runner = await createVitest({ config: false, watch: false, reporters: [] }, configFor(name));
+  try {
+    if (name === 'injected') {
+      await runner.injectTestProject([
+        { extends: false, ...project('injected-browser') },
+        { extends: false, ...project('injected-node', false) },
+      ]);
+    }
+    assert.equal(runner.projects.length, count, name);
+    const servers = new Set(runner.projects.map((project) => project.vite));
+    if (name === 'shared' || name === 'shared-node') assert.equal(servers.size, 1);
+    if (name === 'separate') assert.equal(servers.size, 2);
+    const result = await runner.start();
+    assert.equal(result.unhandledErrors.length, 0, inspect(result.unhandledErrors));
+    const files = runner.state.getFiles();
+    assert.equal(files.length, count, name);
+    for (const file of files) {
+      assert.equal(file.tasks.length, 3);
+      assert.equal(file.result.state, 'pass', inspect(file.tasks.map((task) => task.result), { depth: 5 }));
+      for (const task of file.tasks) assert.equal(task.result.state, 'pass', inspect(task.result));
+    }
+    console.log(`${name}: ${count} projects; string, boolean, number, object, expression, and dotted defines passed`);
+  } finally {
+    await runner.close();
+  }
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/vite.config.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/vite.config.mjs
new file mode 100644
index 0000000000..534b40f292
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/vite.config.mjs
@@ -0,0 +1,4 @@
+import { configFor } from './config.mjs';
+
+// Raw configs must preserve define values without Vite+ config helpers.
+export default configFor('raw');
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/vitest.helper.config.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/vitest.helper.config.mjs
new file mode 100644
index 0000000000..353d189e6c
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/vitest.helper.config.mjs
@@ -0,0 +1,4 @@
+import { defineProject } from 'vite-plus';
+import { project } from './config.mjs';
+
+export default defineProject(project('helper-reference'));
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/vitest.nested.config.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/vitest.nested.config.mjs
new file mode 100644
index 0000000000..2d16de4552
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/vitest.nested.config.mjs
@@ -0,0 +1,11 @@
+import { project } from './config.mjs';
+
+export default {
+  test: {
+    name: 'nested',
+    projects: [
+      './vitest.raw.config.mjs',
+      { extends: false, ...project('independent') },
+    ],
+  },
+};
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/vitest.raw.config.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/vitest.raw.config.mjs
new file mode 100644
index 0000000000..51951cf917
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_defines/vitest.raw.config.mjs
@@ -0,0 +1,3 @@
+import { project } from './config.mjs';
+
+export default project('raw-reference');
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_types/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_types/package.json
new file mode 100644
index 0000000000..599a76aae2
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_types/package.json
@@ -0,0 +1,12 @@
+{
+  "name": "test-v5-browser-types",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@11.24.0",
+  "devDependencies": {
+    "vite-plus": "latest",
+    "@vitest/browser-playwright": "5.0.1",
+    "playwright": "1.57.0",
+    "typescript": "7.0.2"
+  }
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_types/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_types/snapshots.toml
new file mode 100644
index 0000000000..1d3ce1fa5e
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_types/snapshots.toml
@@ -0,0 +1,9 @@
+[[case]]
+name = "packed_browser_declarations"
+vp = "global"
+local-registry = true
+comment = "Packed browser declarations must preserve DOM matchers, provider augmentations, and role types without importing all aliases together."
+steps = [
+  { argv = ["vp", "install", "--ignore-scripts"], snapshot = false, timeout = 180000 },
+  { argv = ["node", "verify.mjs"], timeout = 120000 },
+]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_types/snapshots/packed_browser_declarations.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_types/snapshots/packed_browser_declarations.md
new file mode 100644
index 0000000000..4b398d4a93
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_types/snapshots/packed_browser_declarations.md
@@ -0,0 +1,20 @@
+# packed_browser_declarations
+
+Packed browser declarations must preserve DOM matchers, provider augmentations, and role types without importing all aliases together.
+
+## `vp install --ignore-scripts`
+
+
+## `node verify.mjs`
+
+```
+Standalone browser matcher declarations compile
+browser: provider augmentations and role types preserved
+context: provider augmentations and role types preserved
+browser/context: provider augmentations and role types preserved
+plugins/browser-context: provider augmentations and role types preserved
+browser-playwright/context: provider augmentations and role types preserved
+browser-preview/context: provider augmentations and role types preserved
+browser/providers/playwright/context: provider augmentations and role types preserved
+browser/providers/preview/context: provider augmentations and role types preserved
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_types/tsconfig.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_types/tsconfig.json
new file mode 100644
index 0000000000..42caae54f2
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_types/tsconfig.json
@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "noEmit": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "types": [],
+    "target": "esnext",
+    "module": "nodenext"
+  },
+  "files": ["browser-type-probe.mts"]
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_types/verify.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_types/verify.mjs
new file mode 100644
index 0000000000..92ba6182da
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_browser_types/verify.mjs
@@ -0,0 +1,54 @@
+import assert from 'node:assert/strict';
+import { execFileSync } from 'node:child_process';
+import { realpathSync, writeFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+
+const require = createRequire(import.meta.url);
+const packageFile = require.resolve('vite-plus/package.json');
+assert.equal(realpathSync(packageFile), realpathSync('node_modules/vite-plus/package.json'));
+const compiler = path.join(path.dirname(require.resolve('typescript/package.json')), 'bin/tsc');
+
+function check(source) {
+  writeFileSync('browser-type-probe.mts', source);
+  // TypeScript 7 no longer exposes the legacy JavaScript compiler API. Run
+  // each probe through its CLI so declarations cannot leak between programs.
+  execFileSync(process.execPath, [compiler, '--project', 'tsconfig.json'], { encoding: 'utf8' });
+}
+
+// Compile this separately: a context import can load the upstream matcher
+// declarations and hide a broken vite-plus/test/matchers export.
+check(`
+import 'vite-plus/test/matchers';
+import { expect } from 'vite-plus/test';
+expect(document.body).toBeInTheDocument();
+expect(document.body).toHaveFocus();
+expect(document.body).toHaveAttribute('id', 'app');
+// @ts-expect-error Attribute names must be strings.
+expect(document.body).toHaveAttribute(123);
+`);
+console.log('Standalone browser matcher declarations compile');
+
+for (const alias of [
+  'browser',
+  'context',
+  'browser/context',
+  'plugins/browser-context',
+  'browser-playwright/context',
+  'browser-preview/context',
+  'browser/providers/playwright/context',
+  'browser/providers/preview/context',
+]) {
+  check(`
+import 'vite-plus/test/browser-playwright';
+import { page, type UserEventClickOptions } from 'vite-plus/test/${alias}';
+declare const click: UserEventClickOptions;
+const force: boolean | undefined = click.force;
+await page.getByRole('button').screenshot({ caret: 'hide' });
+// @ts-expect-error Roles accept strings, not numbers.
+page.getByRole(123);
+// @ts-expect-error Playwright's force option must remain a boolean.
+const invalidClick: UserEventClickOptions = { force: 'yes' };
+`);
+  console.log(`${alias}: provider augmentations and role types preserved`);
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/coverage.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/coverage.test.js
new file mode 100644
index 0000000000..3333839212
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/coverage.test.js
@@ -0,0 +1,8 @@
+import { expect, test } from 'vitest';
+import { expect as bundledExpect, test as bundledTest } from 'vite-plus/test';
+import { sum } from './src/covered.js';
+test('covered sum', () => {
+  expect(expect).toBe(bundledExpect);
+  expect(test).toBe(bundledTest);
+  expect(sum(20, 22)).toBe(42);
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/legacy/coverage.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/legacy/coverage.test.js
new file mode 100644
index 0000000000..a6a76fb757
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/legacy/coverage.test.js
@@ -0,0 +1,3 @@
+import { expect, test } from 'vitest';
+import { sum } from './src/covered.js';
+test('covered sum', () => { expect(sum(20, 22)).toBe(42); });
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/legacy/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/legacy/package.json
new file mode 100644
index 0000000000..25c5d92a41
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/legacy/package.json
@@ -0,0 +1,6 @@
+{
+  "name": "coverage-v4-reference",
+  "private": true,
+  "type": "module",
+  "devDependencies": { "vitest": "4.1.11", "@vitest/coverage-v8": "4.1.11" }
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/legacy/vitest.config.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/legacy/vitest.config.mjs
new file mode 100644
index 0000000000..6db30b38cb
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/legacy/vitest.config.mjs
@@ -0,0 +1,12 @@
+export default {
+  test: {
+    include: ['coverage.test.js'],
+    coverage: {
+      enabled: true,
+      provider: 'v8',
+      include: ['src/**'],
+      exclude: ['src/ignored.js'],
+      reporter: ['json'],
+    },
+  },
+};
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/package.json
new file mode 100644
index 0000000000..31cc2fd37f
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/package.json
@@ -0,0 +1,10 @@
+{
+  "name": "test-v5-coverage",
+  "private": true,
+  "type": "module",
+  "devDependencies": {
+    "vite-plus": "latest",
+    "@vitest/coverage-v8": "5.0.1",
+    "@vitest/coverage-istanbul": "5.0.1"
+  }
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/snapshots.toml
new file mode 100644
index 0000000000..f0c7259fbb
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/snapshots.toml
@@ -0,0 +1,11 @@
+[[case]]
+name = "coverage_providers_and_v4_file_set"
+vp = "global"
+local-registry = true
+comment = "Install the packed CLI and project-owned providers together; checkout symlinks cannot test native provider resolution."
+steps = [
+  { argv = ["npm", "install", "--ignore-scripts", "--no-audit", "--no-fund"], snapshot = false, timeout = 120000 },
+  { argv = ["npm", "install", "--prefix", "legacy", "--ignore-scripts", "--no-audit", "--no-fund"], snapshot = false, timeout = 120000 },
+  { argv = ["vpt", "cp", "-r", "src", "legacy"], snapshot = false },
+  { argv = ["node", "verify.mjs"], timeout = 120000 },
+]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/snapshots/coverage_providers_and_v4_file_set.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/snapshots/coverage_providers_and_v4_file_set.md
new file mode 100644
index 0000000000..d6c3fa41c3
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/snapshots/coverage_providers_and_v4_file_set.md
@@ -0,0 +1,24 @@
+# coverage_providers_and_v4_file_set
+
+Install the packed CLI and project-owned providers together; checkout symlinks cannot test native provider resolution.
+
+## `npm install --ignore-scripts --no-audit --no-fund`
+
+
+## `npm install --prefix legacy --ignore-scripts --no-audit --no-fund`
+
+
+## `vpt cp -r src legacy`
+
+
+## `node verify.mjs`
+
+```
+v8: matching provider, shared runner, covered/untested files, and exclusion passed
+v8: aggregate glob threshold passes; perFile rejects the untested file
+istanbul: matching provider, shared runner, covered/untested files, and exclusion passed
+istanbul: aggregate glob threshold passes; perFile rejects the untested file
+Vitest v4/v5 coverage file sets match: src/covered.js, src/untested.js
+Istanbul provider uses the final @vitest/istanbul-lib-* graph
+Mismatched provider rejected before tests run
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/src/covered.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/src/covered.js
new file mode 100644
index 0000000000..86bc41cc44
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/src/covered.js
@@ -0,0 +1 @@
+export function sum(a, b) { return a + b; }
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/src/ignored.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/src/ignored.js
new file mode 100644
index 0000000000..d7b0b4498d
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/src/ignored.js
@@ -0,0 +1 @@
+export function ignored() { return 'excluded'; }
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/src/untested.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/src/untested.js
new file mode 100644
index 0000000000..b78823d289
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/src/untested.js
@@ -0,0 +1 @@
+export function untested() { return 'not called'; }
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/threshold.config.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/threshold.config.js
new file mode 100644
index 0000000000..0daddd907f
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/threshold.config.js
@@ -0,0 +1,13 @@
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({ test: {
+  include: ['coverage.test.js'],
+  coverage: {
+    enabled: true,
+    provider: process.env.COVERAGE_PROVIDER,
+    reporter: [],
+    include: ['src/**'],
+    exclude: ['src/ignored.js'],
+    thresholds: { 'src/**': { perFile: process.env.PER_FILE === 'true', lines: 50 } },
+  },
+} });
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/verify.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/verify.mjs
new file mode 100644
index 0000000000..e3605710f3
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/verify.mjs
@@ -0,0 +1,77 @@
+import assert from 'node:assert/strict';
+import { spawnSync } from 'node:child_process';
+import { readFileSync, writeFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { relative, resolve } from 'node:path';
+import { defineConfig } from 'vite-plus';
+import { createVitest } from 'vite-plus/test/node';
+
+const readJson = (file) => JSON.parse(readFileSync(file, 'utf8'));
+const expectedFiles = ['src/covered.js', 'src/untested.js'];
+const files = (map, root = process.cwd()) => Object.keys(map).map((file) => relative(root, file).replaceAll('\\', '/')).sort();
+const config = (provider) => defineConfig({ test: {
+  include: ['coverage.test.js'],
+  coverage: {
+    enabled: true, provider, reporter: ['json'],
+    include: ['src/**'], exclude: ['src/ignored.js'],
+    reportsDirectory: `output/${provider}`,
+    thresholds: { perFile: true, 'src/**': { perFile: true, lines: 0 } },
+  },
+} });
+for (const provider of ['v8', 'istanbul']) {
+  const runner = await createVitest({ config: false, watch: false, reporters: [] }, config(provider));
+  try {
+    assert.equal(runner.config.coverage.thresholds['src/**'].perFile, true);
+    const result = await runner.start();
+    assert.equal(result.unhandledErrors.length, 0, JSON.stringify(result.unhandledErrors));
+    assert.equal(runner.state.getCountOfFailedTests(), 0);
+    // Istanbul may emit slash-normalized keys on Windows; resolve both
+    // providers' keys before looking up native absolute paths below.
+    const map = Object.fromEntries(Object.entries(readJson(`output/${provider}/coverage-final.json`))
+      .map(([file, coverage]) => [resolve(file), coverage]));
+    assert.deepEqual(files(map), expectedFiles);
+    assert.ok(Object.values(map[resolve('src/covered.js')].s).some((hits) => hits > 0));
+    assert.ok(Object.values(map[resolve('src/untested.js')].s).every((hits) => hits === 0));
+    console.log(`${provider}: matching provider, shared runner, covered/untested files, and exclusion passed`);
+  } finally { await runner.close(); }
+
+  for (const perFile of [false, true]) {
+    const threshold = spawnSync(process.execPath, ['node_modules/vite-plus/dist/bin.js', 'test', 'run', '--config', 'threshold.config.js'], {
+      encoding: 'utf8', env: { ...process.env, COVERAGE_PROVIDER: provider, PER_FILE: String(perFile) },
+    });
+    assert.equal(threshold.status, perFile ? 1 : 0, `${threshold.stdout}\n${threshold.stderr}`);
+    if (perFile) {
+      assert.match(`${threshold.stdout}\n${threshold.stderr}`, /untested\.js/);
+      assert.match(`${threshold.stdout}\n${threshold.stderr}`, /threshold/);
+    }
+  }
+  console.log(`${provider}: aggregate glob threshold passes; perFile rejects the untested file`);
+}
+
+const legacy = spawnSync(process.execPath, ['node_modules/vitest/vitest.mjs', 'run'], {
+  cwd: 'legacy', encoding: 'utf8', env: process.env,
+});
+assert.equal(legacy.status, 0, `${legacy.stdout}\n${legacy.stderr}`);
+const legacyFiles = files(readJson('legacy/coverage/coverage-final.json'), resolve('legacy'));
+assert.deepEqual(legacyFiles, expectedFiles);
+console.log('Vitest v4/v5 coverage file sets match: src/covered.js, src/untested.js');
+
+const require = createRequire(import.meta.url);
+const istanbul = readJson(require.resolve('@vitest/coverage-istanbul/package.json'));
+for (const name of ['coverage', 'instrument', 'report', 'source-maps']) {
+  assert.ok(istanbul.dependencies[`@vitest/istanbul-lib-${name}`]);
+}
+console.log('Istanbul provider uses the final @vitest/istanbul-lib-* graph');
+
+// Corrupt only this disposable install's provider metadata. The runner must
+// reject the mismatch before loading or executing the provider.
+const manifest = require.resolve('@vitest/coverage-v8/package.json');
+const before = readFileSync(manifest, 'utf8');
+try {
+  writeFileSync(manifest, JSON.stringify({ ...JSON.parse(before), version: '4.1.11' }));
+  await assert.rejects(
+    () => createVitest({ config: false, watch: false, reporters: [] }, config('v8')),
+    /coverage provider must match the test runner version/,
+  );
+  console.log('Mismatched provider rejected before tests run');
+} finally { writeFileSync(manifest, before); }
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/identity.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/identity.test.js
new file mode 100644
index 0000000000..c9a2a3e61b
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/identity.test.js
@@ -0,0 +1,12 @@
+import { expect, test, vi } from 'vite-plus/test';
+import { expect as rawExpect, vi as rawVi } from 'vitest';
+
+expect.extend({ toBeAnswer(received) { return { pass: received === 42, message: () => 'Expected 42' }; } });
+test('installed runner shares custom matchers and mock state', () => {
+  expect(rawExpect).toBe(expect);
+  expect(rawVi).toBe(vi);
+  rawExpect(42).toBeAnswer();
+  const mock = vi.fn();
+  mock();
+  rawExpect(mock).toHaveBeenCalledOnce();
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/package.json
new file mode 100644
index 0000000000..033b26df32
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/package.json
@@ -0,0 +1,6 @@
+{
+  "name": "test-v5-install-managers",
+  "private": true,
+  "type": "module",
+  "devDependencies": { "vite-plus": "latest", "vitest": "5.0.1" }
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots.toml
new file mode 100644
index 0000000000..04e7c902b8
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots.toml
@@ -0,0 +1,64 @@
+[[case]]
+name = "npm_install_and_runtime"
+vp = "global"
+local-registry = true
+steps = [
+  { argv = ["vpt", "json-edit", "package.json", "packageManager", "npm@10.9.4"], snapshot = false },
+  # Match the bundled runner throughout npm's peer graph. Otherwise newer
+  # Vitest patches reached through optional peers can crash npm 10's resolver.
+  { argv = ["vpt", "json-edit", "package.json", "overrides.vitest", "5.0.1"], snapshot = false },
+  { argv = ["vpt", "json-edit", "package.json", "overrides.@vitest/browser", "5.0.1"], snapshot = false },
+  { argv = ["vp", "install", "--ignore-scripts", "--", "--no-audit", "--no-fund"], snapshot = false, timeout = 180000 },
+  ["vp", "test", "run"],
+]
+
+[[case]]
+name = "pnpm_install_and_runtime"
+vp = "global"
+local-registry = true
+steps = [
+  { argv = ["vpt", "json-edit", "package.json", "packageManager", "pnpm@11.24.0"], snapshot = false },
+  { argv = ["vp", "install", "--ignore-scripts"], snapshot = false, timeout = 180000 },
+  ["vp", "test", "run"],
+]
+
+[[case]]
+name = "bun_install_and_runtime"
+vp = "global"
+local-registry = true
+steps = [
+  { argv = ["vpt", "json-edit", "package.json", "packageManager", "bun@1.3.11"], snapshot = false },
+  { argv = ["vp", "install", "--ignore-scripts"], snapshot = false, timeout = 180000 },
+  ["vp", "test", "run"],
+]
+
+[[case]]
+name = "yarn_without_project_vite_or_vitest"
+vp = "global"
+local-registry = true
+env = { YARN_ENABLE_SCRIPTS = "0" }
+comment = "Install only vite-plus: its dependency graph must provide Vitest's Vite peer without a project Vite or Vitest dependency."
+steps = [
+  { argv = ["vpt", "write-file", "package.json", "{\"name\":\"test-v5-yarn-peer\",\"private\":true,\"type\":\"module\",\"packageManager\":\"yarn@4.12.0\",\"devDependencies\":{\"vite-plus\":\"latest\"}}\n"], snapshot = false },
+  { argv = ["vpt", "write-file", ".yarnrc.yml", "nodeLinker: node-modules\n"], snapshot = false },
+  { argv = ["vp", "install"], snapshot = false, timeout = 180000 },
+  ["node", "--input-type=module", "-e", "import assert from 'node:assert/strict'; import { createRequire } from 'node:module'; import { defineConfig } from 'vite-plus/test/config'; const require = createRequire(import.meta.resolve('vite-plus/package.json')); assert.equal(require('vite/package.json').name, '@voidzero-dev/vite-plus-core'); assert.equal(require('vite/package.json').version, require('@voidzero-dev/vite-plus-core/package.json').version); assert.equal(typeof defineConfig, 'function'); console.log('Vitest Vite peer uses the bundled core');"],
+  ["vp", "test", "run"],
+]
+
+[[case]]
+name = "yarn_pnp_conversion_and_runtime"
+vp = "global"
+local-registry = true
+unset-env = ["VP_SKIP_INSTALL"]
+env = { YARN_ENABLE_SCRIPTS = "0" }
+comment = "Vite+ does not support PnP; validate the documented conversion to node-modules before executing the v5 runner."
+steps = [
+  { argv = ["vpt", "json-edit", "package.json", "packageManager", "yarn@4.12.0"], snapshot = false },
+  { argv = ["vpt", "write-file", ".yarnrc.yml", "nodeLinker: pnp\n"], snapshot = false },
+  { argv = ["vp", "install"], snapshot = false, timeout = 180000 },
+  ["vpt", "stat-file", ".pnp.cjs", "--assert", "file"],
+  { argv = ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"], timeout = 180000 },
+  ["vpt", "print-file", ".yarnrc.yml"],
+  ["vp", "test", "run"],
+]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/bun_install_and_runtime.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/bun_install_and_runtime.md
new file mode 100644
index 0000000000..b5d5a67281
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/bun_install_and_runtime.md
@@ -0,0 +1,23 @@
+# bun_install_and_runtime
+
+## `vpt json-edit package.json packageManager bun@1.3.11`
+
+
+## `vp install --ignore-scripts`
+
+
+## `vp test run`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+ RUN  <version> <workspace>
+
+ ✓ identity.test.js (1 test) <duration>
+   ✓ installed runner shares custom matchers and mock state <duration>
+
+ Test Files  1 passed (1)
+      Tests  1 passed (1)
+   Start at  <time>
+   Duration  <duration> (<timing>)
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/npm_install_and_runtime.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/npm_install_and_runtime.md
new file mode 100644
index 0000000000..36fd5a66d2
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/npm_install_and_runtime.md
@@ -0,0 +1,29 @@
+# npm_install_and_runtime
+
+## `vpt json-edit package.json packageManager npm@10.9.4`
+
+
+## `vpt json-edit package.json overrides.vitest 5.0.1`
+
+
+## `vpt json-edit package.json overrides.@vitest/browser 5.0.1`
+
+
+## `vp install --ignore-scripts -- --no-audit --no-fund`
+
+
+## `vp test run`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+ RUN  <version> <workspace>
+
+ ✓ identity.test.js (1 test) <duration>
+   ✓ installed runner shares custom matchers and mock state <duration>
+
+ Test Files  1 passed (1)
+      Tests  1 passed (1)
+   Start at  <time>
+   Duration  <duration> (<timing>)
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/pnpm_install_and_runtime.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/pnpm_install_and_runtime.md
new file mode 100644
index 0000000000..7fd00770cf
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/pnpm_install_and_runtime.md
@@ -0,0 +1,23 @@
+# pnpm_install_and_runtime
+
+## `vpt json-edit package.json packageManager pnpm@11.24.0`
+
+
+## `vp install --ignore-scripts`
+
+
+## `vp test run`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+ RUN  <version> <workspace>
+
+ ✓ identity.test.js (1 test) <duration>
+   ✓ installed runner shares custom matchers and mock state <duration>
+
+ Test Files  1 passed (1)
+      Tests  1 passed (1)
+   Start at  <time>
+   Duration  <duration> (<timing>)
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/yarn_pnp_conversion_and_runtime.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/yarn_pnp_conversion_and_runtime.md
new file mode 100644
index 0000000000..f69e733d57
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/yarn_pnp_conversion_and_runtime.md
@@ -0,0 +1,69 @@
+# yarn_pnp_conversion_and_runtime
+
+Vite+ does not support PnP; validate the documented conversion to node-modules before executing the v5 runner.
+
+## `vpt json-edit package.json packageManager yarn@4.12.0`
+
+
+## `vpt write-file .yarnrc.yml 'nodeLinker: pnp
+'`
+
+
+## `vp install`
+
+
+## `vpt stat-file .pnp.cjs --assert file`
+
+```
+.pnp.cjs: file
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+⚠ Vite+ does not currently support Yarn Plug'n'Play (PnP).
+
+✔ Switched Yarn to node-modules mode
+
+Formatting code...
+
+Code formatted
+◇ Updated . to Vite+ <version>
+• Node <version>  yarn <version>
+• Dependencies:
+    vite-plus  latest → <version>
+    vite              → <version>
+✓ Dependencies installed in <duration>
+• 1 file had imports rewritten
+• Package manager settings configured
+```
+
+## `vpt print-file .yarnrc.yml`
+
+```
+nodeLinker: node-modules
+npmPreapprovedPackages:
+  - vitest
+  - "@vitest/*"
+catalog:
+  vite: npm:@voidzero-dev/vite-plus-core@<version>
+  vite-plus: <version>
+```
+
+## `vp test run`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+ RUN  <version> <workspace>
+
+ ✓ identity.test.js (1 test) <duration>
+   ✓ installed runner shares custom matchers and mock state <duration>
+
+ Test Files  1 passed (1)
+      Tests  1 passed (1)
+   Start at  <time>
+   Duration  <duration> (<timing>)
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/yarn_without_project_vite_or_vitest.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/yarn_without_project_vite_or_vitest.md
new file mode 100644
index 0000000000..453a208fa5
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/yarn_without_project_vite_or_vitest.md
@@ -0,0 +1,36 @@
+# yarn_without_project_vite_or_vitest
+
+Install only vite-plus: its dependency graph must provide Vitest's Vite peer without a project Vite or Vitest dependency.
+
+## `vpt write-file package.json '{"name":"test-v5-yarn-peer","private":true,"type":"module","packageManager":"yarn@4.12.0","devDependencies":{"vite-plus":"latest"}}
+'`
+
+
+## `vpt write-file .yarnrc.yml 'nodeLinker: node-modules
+'`
+
+
+## `vp install`
+
+
+## `node --input-type=module -e 'import assert from '\''node:assert/strict'\''; import { createRequire } from '\''node:module'\''; import { defineConfig } from '\''vite-plus/test/config'\''; const require = createRequire(import.meta.resolve('\''vite-plus/package.json'\'')); assert.equal(require('\''vite/package.json'\'').name, '\''@voidzero-dev/vite-plus-core'\''); assert.equal(require('\''vite/package.json'\'').version, require('\''@voidzero-dev/vite-plus-core/package.json'\'').version); assert.equal(typeof defineConfig, '\''function'\''); console.log('\''Vitest Vite peer uses the bundled core'\'');'`
+
+```
+Vitest Vite peer uses the bundled core
+```
+
+## `vp test run`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+ RUN  <version> <workspace>
+
+ ✓ identity.test.js (1 test) <duration>
+   ✓ installed runner shares custom matchers and mock state <duration>
+
+ Test Files  1 passed (1)
+      Tests  1 passed (1)
+   Start at  <time>
+   Duration  <duration> (<timing>)
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/vite.config.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/vite.config.js
new file mode 100644
index 0000000000..80b08a60e0
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/vite.config.js
@@ -0,0 +1,2 @@
+import { defineConfig } from 'vite-plus';
+export default defineConfig({ test: { include: ['identity.test.js'] } });
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/benchmark.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/benchmark.test.js
new file mode 100644
index 0000000000..5902b5035e
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/benchmark.test.js
@@ -0,0 +1,10 @@
+import { expect, test } from 'vite-plus/test';
+
+test('bench is a test-context fixture', async ({ bench }) => {
+  let calls = 0;
+  const result = await bench('sum', () => { calls++; return 20 + 22; }).run({
+    iterations: 1, time: 1, warmup: false,
+  });
+  expect(calls).toBeGreaterThan(0);
+  expect(result.name).toBe('sum');
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/dynamic.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/dynamic.test.js
new file mode 100644
index 0000000000..1ada27dbf7
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/dynamic.test.js
@@ -0,0 +1,6 @@
+import { writeFileSync } from 'node:fs';
+import { test, expect } from 'vite-plus/test';
+
+writeFileSync('collection-ran.txt', 'collected');
+const register = (name) => test(name, () => expect(true).toBe(true));
+register('generated at collection time');
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/package.json
new file mode 100644
index 0000000000..ffed0dd235
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/package.json
@@ -0,0 +1,5 @@
+{
+  "name": "test-v5-node-apis",
+  "private": true,
+  "type": "module"
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/runtime.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/runtime.test.js
new file mode 100644
index 0000000000..2f5dbed6e6
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/runtime.test.js
@@ -0,0 +1,24 @@
+import { test, expect, vi, recordArtifact } from 'vite-plus/test';
+import { writeFileSync } from 'node:fs';
+
+test('one-based worker identifiers', () => {
+  expect(Number(process.env.VITEST_POOL_ID)).toBeGreaterThanOrEqual(1);
+  expect(Number(process.env.VITEST_WORKER_ID)).toBeGreaterThanOrEqual(1);
+});
+
+test('class mocks preserve their implementation prototype', () => {
+  class Service { value() { return 42; } }
+  const MockService = vi.fn(Service);
+  const instance = new MockService();
+  expect(instance).toBeInstanceOf(Service);
+  expect(instance.value()).toBe(42);
+});
+
+test('annotations and custom artifacts', async ({ annotate, task }) => {
+  writeFileSync('attachment.txt', 'v5 attachment content');
+  await annotate('plain-text attachment', {
+    path: 'attachment.txt',
+    contentType: 'text/plain',
+  });
+  await recordArtifact(task, { type: 'fixture:identity', value: 42 });
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/snapshots.toml
new file mode 100644
index 0000000000..fa50158377
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/snapshots.toml
@@ -0,0 +1,14 @@
+[[case]]
+name = "node_api_and_reports"
+vp = "local"
+steps = [{ argv = ["node", "verify.mjs"], timeout = 120000 }]
+
+[[case]]
+name = "list_static_and_runtime_collection"
+vp = "local"
+steps = [
+  ["vp", "test", "list", "dynamic.test.js", "--json"],
+  ["vpt", "stat-file", "collection-ran.txt", "--assert", "missing"],
+  ["vp", "test", "list", "dynamic.test.js", "--no-static-parse", "--json"],
+  ["vpt", "stat-file", "collection-ran.txt", "--assert", "file"],
+]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/snapshots/list_static_and_runtime_collection.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/snapshots/list_static_and_runtime_collection.md
new file mode 100644
index 0000000000..1c0ba7fe1f
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/snapshots/list_static_and_runtime_collection.md
@@ -0,0 +1,39 @@
+# list_static_and_runtime_collection
+
+## `vp test list dynamic.test.js --json`
+
+```
+[
+  {
+    "name": "name",
+    "file": "<workspace>/dynamic.test.js",
+    "location": {
+      "line": 5,
+      "column": 28
+    }
+  }
+]
+```
+
+## `vpt stat-file collection-ran.txt --assert missing`
+
+```
+collection-ran.txt: missing
+```
+
+## `vp test list dynamic.test.js --no-static-parse --json`
+
+```
+[
+  {
+    "name": "generated at collection time",
+    "file": "<workspace>/dynamic.test.js"
+  }
+]
+```
+
+## `vpt stat-file collection-ran.txt --assert file`
+
+```
+collection-ran.txt: file
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/snapshots/node_api_and_reports.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/snapshots/node_api_and_reports.md
new file mode 100644
index 0000000000..b5daa7b25d
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/snapshots/node_api_and_reports.md
@@ -0,0 +1,15 @@
+# node_api_and_reports
+
+## `node verify.mjs`
+
+```
+resolveConfig returns Vite config with .test and integration plugins
+collect staticParse=true: collection side effects skipped
+collect staticParse=false: collection side effects executed
+JSON report written to <workspace>/.vitest/json/output.json
+blob report written to <workspace>/.vitest/blob/blob.json
+JUNIT report written to <workspace>/.vitest/junit/output.xml
+JSON, JUnit, blob, attachments, artifacts, worker IDs, class mock prototypes, and the bench fixture passed
+JSON report written to <workspace>/merged.json
+blob merge preserved all four test results
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/verify.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/verify.mjs
new file mode 100644
index 0000000000..c824be79cd
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/verify.mjs
@@ -0,0 +1,65 @@
+import assert from 'node:assert/strict';
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { defineConfig } from 'vite-plus';
+import { createVitest, resolveConfig } from 'vite-plus/test/node';
+
+const base = { config: false, watch: false, reporters: [] };
+const resolved = await resolveConfig(base, defineConfig({ test: { clearMocks: false } }));
+assert.equal(resolved.test.clearMocks, false);
+assert.ok(resolved.plugins.some(({ name }) => name === 'vite-plus:vitest-resolver'));
+console.log('resolveConfig returns Vite config with .test and integration plugins');
+
+for (const staticParse of [true, false]) {
+  const runner = await createVitest({ ...base, include: ['dynamic.test.js'] }, defineConfig({}));
+  try {
+    const result = await runner.collect([], { staticParse });
+    assert.equal(result.unhandledErrors.length, 0);
+    assert.equal(existsSync('collection-ran.txt'), !staticParse);
+    const tasks = runner.state.getFiles().flatMap((file) => file.tasks);
+    if (!staticParse) assert.deepEqual(tasks.map(({ name }) => name), ['generated at collection time']);
+    console.log(`collect staticParse=${staticParse}: collection side effects ${staticParse ? 'skipped' : 'executed'}`);
+  } finally {
+    await runner.close();
+  }
+}
+
+const runner = await createVitest({
+  ...base,
+  include: ['runtime.test.js'],
+  benchmark: { enabled: true, include: ['benchmark.test.js'] },
+  reporters: ['json', 'junit', 'blob'],
+}, defineConfig({}));
+try {
+  const result = await runner.start();
+  assert.equal(result.unhandledErrors.length, 0, JSON.stringify(result.unhandledErrors));
+  assert.equal(runner.state.getCountOfFailedTests(), 0, JSON.stringify(runner.state.getFiles().flatMap((file) => [file.result, ...file.tasks.map((task) => ({ name: task.name, result: task.result }))])));
+  const tasks = runner.state.getFiles().flatMap((file) => file.tasks);
+  assert.equal(tasks.length, 4);
+  assert.equal(runner.mode, 'test');
+  const artifacts = tasks.flatMap((task) => task.artifacts ?? []);
+  assert.ok(artifacts.some(({ type }) => type === 'fixture:identity'));
+  const attachment = tasks.flatMap((task) => task.annotations).find(({ attachment }) => attachment)?.attachment;
+  assert.ok(attachment?.path.includes('.vitest/attachments/'));
+  assert.equal(readFileSync(attachment.path, 'utf8'), 'v5 attachment content');
+} finally {
+  await runner.close();
+}
+
+const reports = '.vitest';
+const json = JSON.parse(readFileSync(join(reports, 'json/output.json'), 'utf8'));
+assert.equal(json.numPassedTests, 4);
+assert.equal(json.numFailedTests, 0);
+assert.match(readFileSync(join(reports, 'junit/output.xml'), 'utf8'), /tests="4"/);
+assert.equal(readdirSync(join(reports, 'blob')).filter((file) => file.endsWith('.json')).length, 1);
+console.log('JSON, JUnit, blob, attachments, artifacts, worker IDs, class mock prototypes, and the bench fixture passed');
+
+const merged = await createVitest({ ...base, reporters: [['json', { outputFile: 'merged.json' }]] }, defineConfig({}));
+try {
+  const result = await merged.mergeReports(join(reports, 'blob'));
+  assert.equal(result.unhandledErrors.length, 0);
+  assert.equal(JSON.parse(readFileSync('merged.json', 'utf8')).numPassedTests, 4);
+  console.log('blob merge preserved all four test results');
+} finally {
+  await merged.close();
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/custom-environment.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/custom-environment.js
new file mode 100644
index 0000000000..092dd4d66b
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/custom-environment.js
@@ -0,0 +1,19 @@
+import assert from 'node:assert/strict';
+import { populateGlobal } from 'vite-plus/test/runtime';
+
+export default {
+  name: 'descriptor-environment',
+  viteEnvironment: 'ssr',
+  setup(global) {
+    const target = {};
+    const getter = () => { throw new Error('The original getter must not run'); };
+    Object.defineProperty(target, 'probe', { get: getter, configurable: true });
+    const { originals } = populateGlobal(target, { probe: 42 }, { additionalKeys: ['probe'] });
+    assert.equal(target.probe, 42);
+    assert.equal(originals.get('probe').get, getter);
+    Object.defineProperty(target, 'probe', originals.get('probe'));
+    assert.equal(Object.getOwnPropertyDescriptor(target, 'probe').get, getter);
+    global.__descriptorCheck = true;
+    return { teardown() { delete global.__descriptorCheck; } };
+  },
+};
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/custom.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/custom.test.js
new file mode 100644
index 0000000000..4d9226371a
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/custom.test.js
@@ -0,0 +1,4 @@
+import { expect, test } from 'vite-plus/test';
+test('custom environment restores property descriptors without invoking getters', () => {
+  expect(globalThis.__descriptorCheck).toBe(true);
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/happy-dom.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/happy-dom.test.js
new file mode 100644
index 0000000000..c83cc8aef7
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/happy-dom.test.js
@@ -0,0 +1,8 @@
+import { expect, test } from 'vite-plus/test';
+
+test('DOM assignment affects happy-dom matchMedia', () => {
+  globalThis.innerWidth = 412;
+  expect(matchMedia('(max-width: 500px)').matches).toBe(true);
+  globalThis.innerWidth = 812;
+  expect(matchMedia('(max-width: 500px)').matches).toBe(false);
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/jsdom.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/jsdom.test.js
new file mode 100644
index 0000000000..83b481d111
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/jsdom.test.js
@@ -0,0 +1,10 @@
+import { expect, test } from 'vite-plus/test';
+import { expect as rawExpect } from 'vitest';
+
+test('DOM assignment reaches the jsdom window and shares assertion state', () => {
+  expect(expect).toBe(rawExpect);
+  globalThis.innerWidth = 412;
+  expect(jsdom.window.innerWidth).toBe(412);
+  document.body.innerHTML = '<p>jsdom</p>';
+  expect(document.querySelector('p').textContent).toBe('jsdom');
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/package.json
new file mode 100644
index 0000000000..3b215e99e6
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/package.json
@@ -0,0 +1,12 @@
+{
+  "name": "test-v5-optional-packages",
+  "private": true,
+  "type": "module",
+  "devDependencies": {
+    "vite-plus": "latest",
+    "@vitest/ui": "5.0.1",
+    "jsdom": "27.2.0",
+    "happy-dom": "20.0.10",
+    "temporal-polyfill": "1.0.4"
+  }
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/snapshots.toml
new file mode 100644
index 0000000000..1b78132f11
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/snapshots.toml
@@ -0,0 +1,11 @@
+[[case]]
+name = "environments_temporal_html_and_worker_startup"
+vp = "global"
+local-registry = true
+steps = [
+  { argv = ["npm", "install", "--ignore-scripts", "--no-audit", "--no-fund"], snapshot = false, timeout = 120000 },
+  { argv = ["vp", "test", "run", "--reporter=default", "--reporter=html", "--maxWorkers=1"], timeout = 120000 },
+  { argv = ["vpt", "stat-file", ".vitest/index.html", "--assert", "file"] },
+  { argv = ["node", "verify-ui.mjs"], timeout = 120000 },
+  { argv = ["node", "verify-worker.mjs"], timeout = 120000, comment = "A failed worker must produce a controlled diagnostic and a nonzero exit status." },
+]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/snapshots/environments_temporal_html_and_worker_startup.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/snapshots/environments_temporal_html_and_worker_startup.md
new file mode 100644
index 0000000000..5c4d285f13
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/snapshots/environments_temporal_html_and_worker_startup.md
@@ -0,0 +1,48 @@
+# environments_temporal_html_and_worker_startup
+
+## `npm install --ignore-scripts --no-audit --no-fund`
+
+
+## `vp test run --reporter=default --reporter=html --maxWorkers=1`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+ RUN  <version> <workspace>
+
+ ✓  custom  custom.test.js (1 test) <duration>
+ ✓  happy-dom  happy-dom.test.js (1 test) <duration>
+ ✓  jsdom  jsdom.test.js (1 test) <duration>
+ ✓  temporal  temporal.test.js (3 tests) <duration>
+
+ Test Files  4 passed (4)
+      Tests  6 passed (6)
+   Start at  <time>
+   Duration  <duration> (<timing>)
+
+ HTML  Report is generated
+       You can run npx vite preview --outDir .vitest to see the test results.
+```
+
+## `vpt stat-file .vitest/index.html --assert file`
+
+```
+.vitest/index.html: file
+```
+
+## `node verify-ui.mjs`
+
+```
+UI rejects a bare URL, accepts its token, and serves the clean URL with an authenticated cookie
+```
+
+## `node verify-worker.mjs`
+
+A failed worker must produce a controlled diagnostic and a nonzero exit status.
+
+**Exit code:** 1
+
+```
+Vitest caught 1 unhandled error during the test run.
+Worker exited unexpectedly with exit code 9 during starting state
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/temporal.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/temporal.test.js
new file mode 100644
index 0000000000..0a391c4928
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/temporal.test.js
@@ -0,0 +1,26 @@
+import { afterEach, expect, test, vi } from 'vite-plus/test';
+
+afterEach(() => vi.useRealTimers());
+
+test('new defaults mock Temporal with fake timers', () => {
+  const now = Temporal.Now.instant;
+  vi.useFakeTimers();
+  vi.setSystemTime(1234);
+  expect(Temporal.Now.instant).not.toBe(now);
+  expect(Temporal.Now.instant().epochMilliseconds).toBe(1234);
+});
+
+test('migrated toNotFake preserves Temporal while fake timers run', () => {
+  const now = Temporal.Now.instant;
+  vi.useFakeTimers({ toNotFake: ['Temporal'] });
+  vi.setSystemTime(1234);
+  expect(Temporal.Now.instant).toBe(now);
+  // The polyfill can still read mocked Date internally; toNotFake preserves
+  // its implementation, not every transitive source of wall-clock time.
+});
+
+test('setSystemTime also mocks Temporal without fake timers', () => {
+  vi.setSystemTime(2345);
+  expect(vi.isFakeTimers()).toBe(false);
+  expect(Temporal.Now.instant().epochMilliseconds).toBe(2345);
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/verify-ui.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/verify-ui.mjs
new file mode 100644
index 0000000000..27ac337d1e
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/verify-ui.mjs
@@ -0,0 +1,26 @@
+import assert from 'node:assert/strict';
+import { defineConfig } from 'vite-plus';
+import { createVitest } from 'vite-plus/test/node';
+
+const runner = await createVitest({
+  config: false, watch: false, reporters: [], ui: true, open: false,
+  api: { host: '127.0.0.1', port: 0 },
+}, defineConfig({}));
+try {
+  if (!runner.vite.httpServer.listening) await runner.vite.listen(0);
+  const base = `http://127.0.0.1:${runner.vite.httpServer.address().port}`;
+  const ui = new URL(runner.config.uiBase, base);
+  assert.equal((await fetch(ui)).status, 403);
+  ui.searchParams.set('token', runner.config.api.token);
+  const authenticated = await fetch(ui, { redirect: 'manual' });
+  assert.equal(authenticated.status, 302);
+  const cookie = authenticated.headers.get('set-cookie');
+  assert.match(cookie, /HttpOnly/);
+  assert.match(cookie, /SameSite=Strict/i);
+  const clean = new URL(authenticated.headers.get('location'), base);
+  assert.equal(clean.search, '');
+  const page = await fetch(clean, { headers: { cookie } });
+  assert.equal(page.status, 200);
+  assert.ok((await page.text()).includes(JSON.stringify(runner.config.api.token)));
+  console.log('UI rejects a bare URL, accepts its token, and serves the clean URL with an authenticated cookie');
+} finally { await runner.close(); }
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/verify-worker.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/verify-worker.mjs
new file mode 100644
index 0000000000..432a692da7
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/verify-worker.mjs
@@ -0,0 +1,15 @@
+import assert from 'node:assert/strict';
+import { spawnSync } from 'node:child_process';
+
+const result = spawnSync(process.execPath, ['node_modules/vite-plus/dist/bin.js', 'test', 'run', '--config', 'worker-failure.config.js'], {
+  encoding: 'utf8', env: process.env,
+});
+assert.equal(result.status, 1, `${result.stdout}\n${result.stderr}`);
+const output = `${result.stdout}\n${result.stderr}`;
+assert.match(output, /bad option: --vitest-invalid-worker-option/);
+assert.match(output, /Worker exited unexpectedly with exit code 9 during starting state/);
+assert.match(output, /Vitest caught 1 unhandled error/);
+// Keep the actual diagnostic and status; omit OS-specific Node paths and stacks.
+console.log('Vitest caught 1 unhandled error during the test run.');
+console.log(output.match(/Worker exited unexpectedly with exit code 9 during starting state/)[0]);
+process.exitCode = result.status;
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/vite.config.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/vite.config.js
new file mode 100644
index 0000000000..47f6de7690
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/vite.config.js
@@ -0,0 +1,10 @@
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({ test: {
+  projects: [
+    { test: { name: 'jsdom', environment: 'jsdom', include: ['jsdom.test.js'] } },
+    { test: { name: 'happy-dom', environment: 'happy-dom', include: ['happy-dom.test.js'] } },
+    { test: { name: 'temporal', setupFiles: ['temporal-polyfill/global'], include: ['temporal.test.js'] } },
+    { test: { name: 'custom', environment: './custom-environment.js', include: ['custom.test.js'] } },
+  ],
+} });
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/worker-failure.config.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/worker-failure.config.js
new file mode 100644
index 0000000000..198d46d385
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/worker-failure.config.js
@@ -0,0 +1,6 @@
+import { defineConfig } from 'vite-plus';
+export default defineConfig({ test: {
+  pool: 'forks',
+  execArgv: ['--vitest-invalid-worker-option'],
+  include: ['custom.test.js'],
+} });
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/package.json
new file mode 100644
index 0000000000..42e24bd2ff
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/package.json
@@ -0,0 +1,5 @@
+{
+  "name": "test-v5-parent-config",
+  "private": true,
+  "type": "module"
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/snapshots.toml
new file mode 100644
index 0000000000..4b33624b19
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/snapshots.toml
@@ -0,0 +1,11 @@
+[[case]]
+name = "directory_local_config"
+vp = ["local", "global"]
+cwd = "sub"
+steps = [["vp", "test", "run"]]
+
+[[case]]
+name = "explicit_config"
+vp = "local"
+cwd = "sub"
+steps = [["vp", "test", "run", "--config", "../vite.config.ts", "--dir", "."]]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/snapshots/directory_local_config.global.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/snapshots/directory_local_config.global.md
new file mode 100644
index 0000000000..29ff3a6e46
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/snapshots/directory_local_config.global.md
@@ -0,0 +1,17 @@
+# directory_local_config
+
+## `vp test run`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+ RUN  <version> <workspace>/sub
+
+ ✓ example.test.ts (1 test) <duration>
+   ✓ runs in the selected directory <duration>
+
+ Test Files  1 passed (1)
+      Tests  1 passed (1)
+   Start at  <time>
+   Duration  <duration> (<timing>)
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/snapshots/directory_local_config.local.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/snapshots/directory_local_config.local.md
new file mode 100644
index 0000000000..b2f03f07de
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/snapshots/directory_local_config.local.md
@@ -0,0 +1,16 @@
+# directory_local_config
+
+## `vp test run`
+
+```
+
+ RUN  <version> <workspace>/sub
+
+ ✓ example.test.ts (1 test) <duration>
+   ✓ runs in the selected directory <duration>
+
+ Test Files  1 passed (1)
+      Tests  1 passed (1)
+   Start at  <time>
+   Duration  <duration> (<timing>)
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/snapshots/explicit_config.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/snapshots/explicit_config.md
new file mode 100644
index 0000000000..72bec25bd4
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/snapshots/explicit_config.md
@@ -0,0 +1,16 @@
+# explicit_config
+
+## `vp test run --config ../vite.config.ts --dir .`
+
+```
+
+ RUN  <version> <workspace>/sub
+
+ ✓  parent  example.test.ts (1 test) <duration>
+   ✓ runs in the selected directory <duration>
+
+ Test Files  1 passed (1)
+      Tests  1 passed (1)
+   Start at  <time>
+   Duration  <duration> (<timing>)
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/sub/example.test.ts b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/sub/example.test.ts
new file mode 100644
index 0000000000..46103006bf
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/sub/example.test.ts
@@ -0,0 +1,5 @@
+import { expect, test } from 'vite-plus/test';
+
+test('runs in the selected directory', () => {
+  expect(2 + 2).toBe(4);
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/vite.config.ts b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/vite.config.ts
new file mode 100644
index 0000000000..f06c3d680c
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/vite.config.ts
@@ -0,0 +1,3 @@
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({ test: { name: 'parent' } });
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/browser.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/browser.test.js
new file mode 100644
index 0000000000..041fed7fab
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/browser.test.js
@@ -0,0 +1,28 @@
+import { expect, test, vi } from 'vite-plus/test';
+import { expect as upstreamExpect } from 'vitest';
+import { page } from 'vite-plus/test/browser';
+import { page as compatibilityPage } from 'vite-plus/test/browser/context';
+import { page as providerPage } from 'vite-plus/test/browser-preview/context';
+import { page as bareContextPage } from 'vite-plus/test/context';
+import { page as pluginPage } from 'vite-plus/test/plugins/browser-context';
+import { page as providerAliasPage } from 'vite-plus/test/browser/providers/preview/context';
+
+test('Preview shares runtime and browser context across public entry points', async () => {
+  expect(expect).toBe(upstreamExpect);
+  expect(page).toBe(compatibilityPage);
+  expect(page).toBe(providerPage);
+  expect(page).toBe(bareContextPage);
+  expect(page).toBe(pluginPage);
+  expect(page).toBe(providerAliasPage);
+  document.body.innerHTML = '<button type="button">Increment</button><output>0</output>';
+  document.querySelector('button').addEventListener('click', () => { document.querySelector('output').textContent = '1'; });
+  // Upstream #9891 regressed Preview real timers in 4.1.1, also affecting 5.0.1.
+  // The separate upstream_real_timers case records this pre-existing failure.
+  vi.useFakeTimers({ toFake: ['setTimeout', 'clearTimeout'] });
+  try {
+    await page.getByRole('button', { name: 'Increment' }).click();
+  } finally {
+    vi.useRealTimers();
+  }
+  await expect.element(page.getByRole('status')).toHaveTextContent('1');
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/defines.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/defines.test.js
new file mode 100644
index 0000000000..15a0c848aa
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/defines.test.js
@@ -0,0 +1,9 @@
+import { expect, test } from 'vite-plus/test';
+
+test('browser global string define', () => {
+  expect(globalThis['__VP_STRING_DEFINE__']).toBe('/messages');
+});
+
+test('browser global boolean define', () => {
+  expect(globalThis['__VP_BOOL_DEFINE__']).toBe(false);
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/package.json
new file mode 100644
index 0000000000..2c54206a43
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/package.json
@@ -0,0 +1 @@
+{"name":"vitest-v5-preview","private":true,"type":"module"}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/snapshots.toml
new file mode 100644
index 0000000000..3768df0382
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/snapshots.toml
@@ -0,0 +1,19 @@
+[[case]]
+name = "preview_runtime"
+vp = "local"
+env = { PLAYWRIGHT_BROWSERS_PATH = "0" }
+steps = [{ argv = ["node", "verify.mjs"], timeout = 120000 }]
+
+[[case]]
+name = "upstream_real_timers"
+vp = "local"
+env = { PLAYWRIGHT_BROWSERS_PATH = "0" }
+comment = "Known upstream regression introduced in Vitest 4.1.1 and still present in 5.0.1, not a new v5 release blocker: Preview locator clicks advance fake timers while using real timers. Require success when upstream fixes it."
+steps = [{ argv = ["node", "verify.mjs", "--real-timers"], timeout = 120000 }]
+
+[[case]]
+name = "upstream_browser_defines"
+vp = "local"
+env = { PLAYWRIGHT_BROWSERS_PATH = "0" }
+comment = "Regression for upstream #11198, fixed in 5.0.1: Preview must preserve string and boolean define values without a Vite+ backport."
+steps = [{ argv = ["node", "verify.mjs", "--browser-defines"], timeout = 120000 }]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/snapshots/preview_runtime.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/snapshots/preview_runtime.md
new file mode 100644
index 0000000000..c6a317d25c
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/snapshots/preview_runtime.md
@@ -0,0 +1,10 @@
+# preview_runtime
+
+## `node verify.mjs`
+
+```
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Browser runner started at http://localhost:<port>/__vitest_test__/?sessionId=<uuid>
+
+Preview: runtime identity, browser export aliases, fake-timer locator clicks, and async assertions passed
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/snapshots/upstream_browser_defines.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/snapshots/upstream_browser_defines.md
new file mode 100644
index 0000000000..a0fdfe4b10
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/snapshots/upstream_browser_defines.md
@@ -0,0 +1,12 @@
+# upstream_browser_defines
+
+Regression for upstream #11198, fixed in 5.0.1: Preview must preserve string and boolean define values without a Vite+ backport.
+
+## `node verify.mjs --browser-defines`
+
+```
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Browser runner started at http://localhost:<port>/__vitest_test__/?sessionId=<uuid>
+
+Preview: browser string and boolean define values passed
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/snapshots/upstream_real_timers.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/snapshots/upstream_real_timers.md
new file mode 100644
index 0000000000..0e50050f93
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/snapshots/upstream_real_timers.md
@@ -0,0 +1,12 @@
+# upstream_real_timers
+
+Known upstream regression introduced in Vitest 4.1.1 and still present in 5.0.1, not a new v5 release blocker: Preview locator clicks advance fake timers while using real timers. Require success when upstream fixes it.
+
+## `node verify.mjs --real-timers`
+
+```
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Browser runner started at http://localhost:<port>/__vitest_test__/?sessionId=<uuid>
+
+Known upstream regression since Vitest 4.1.1: Preview locator clicks fail with real timers in 5.0.1
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/upstream.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/upstream.test.js
new file mode 100644
index 0000000000..0550606c77
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/upstream.test.js
@@ -0,0 +1,8 @@
+import { expect, test, vi } from 'vitest';
+import { page } from 'vitest/browser';
+
+test('Preview locator clicks with real timers', async () => {
+  expect(vi.isFakeTimers()).toBe(false);
+  document.body.innerHTML = '<button>Click</button>';
+  await page.getByRole('button', { name: 'Click' }).click();
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/verify.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/verify.mjs
new file mode 100644
index 0000000000..c8034be788
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/verify.mjs
@@ -0,0 +1,62 @@
+import assert from 'node:assert/strict';
+import { createRequire } from 'node:module';
+import { defineConfig } from 'vite-plus';
+import { createVitest } from 'vite-plus/test/node';
+import { preview } from 'vite-plus/test/browser-preview';
+
+// Automate Preview's normal manually opened page, without replacing its
+// locator implementation or opening the developer's default browser.
+const require = createRequire(import.meta.resolve('vite-plus/package.json'));
+const { chromium } = require('playwright');
+const browser = await chromium.launch({ headless: true });
+const tab = await browser.newPage();
+const provider = preview();
+const realTimers = process.argv.includes('--real-timers');
+const browserDefines = process.argv.includes('--browser-defines');
+const createProvider = provider.providerFactory;
+provider.providerFactory = (project) => {
+  const instance = createProvider(project);
+  const openPage = instance.openPage.bind(instance);
+  instance.openPage = async (session, url) => {
+    project.browser.vite.openBrowser = () => {};
+    await openPage(session, url);
+    await tab.goto(url);
+  };
+  return instance;
+};
+let runner;
+try {
+  runner = await createVitest({ config: false, watch: false, reporters: [] }, defineConfig({
+    ...(browserDefines ? { define: { __VP_STRING_DEFINE__: JSON.stringify('/messages'), __VP_BOOL_DEFINE__: 'false' } } : {}),
+    test: {
+      include: [browserDefines ? 'defines.test.js' : realTimers ? 'upstream.test.js' : 'browser.test.js'],
+      browser: { enabled: true, provider, headless: false, instances: [{ browser: 'chromium' }] },
+    },
+  }));
+  const result = await runner.start();
+  assert.equal(result.unhandledErrors.length, 0, JSON.stringify(result.unhandledErrors));
+  assert.equal(runner.state.getFiles().length, 1);
+  if (browserDefines) {
+    const tasks = runner.state.getFiles().flatMap((file) => file.tasks);
+    assert.equal(tasks.length, 2);
+    for (const task of tasks) {
+      assert.equal(task.result.state, 'pass', JSON.stringify(task.result));
+    }
+    console.log('Preview: browser string and boolean define values passed');
+  } else if (realTimers) {
+    const tasks = runner.state.getFiles().flatMap((file) => file.tasks);
+    assert.equal(tasks.length, 1);
+    assert.equal(tasks[0].result.state, 'fail');
+    assert.match(tasks[0].result.errors[0].message, /timers APIs are not mocked/);
+    console.log(`Known upstream regression since Vitest 4.1.1: Preview locator clicks fail with real timers in ${runner.version}`);
+    // This verifies a pre-existing upstream regression, not a new v5 release
+    // blocker or evidence that real-timer locator clicks work.
+    process.exitCode = 0;
+  } else {
+    assert.equal(runner.state.getCountOfFailedTests(), 0, JSON.stringify(runner.state.getFiles().flatMap((file) => [file.result, ...file.tasks.map((task) => task.result)])));
+    console.log('Preview: runtime identity, browser export aliases, fake-timer locator clicks, and async assertions passed');
+  }
+} finally {
+  await runner?.close();
+  await browser.close();
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/identity.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/identity.test.js
new file mode 100644
index 0000000000..d2be81cc76
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/identity.test.js
@@ -0,0 +1,11 @@
+import { expect, inject, test, vi } from 'vite-plus/test';
+import { expect as upstreamExpect, vi as upstreamVi } from 'vitest';
+import { matcherExpect } from 'jest-extended';
+
+test('runner, public imports, and external matchers share assertion state', () => {
+  expect(upstreamExpect).toBe(expect);
+  expect(matcherExpect).toBe(expect);
+  expect(upstreamVi).toBe(vi);
+  expect(inject('value')).toEqual(expect.any(String));
+  expect('shared').toHaveSharedState();
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/package.json
new file mode 100644
index 0000000000..e8593b9e8f
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/package.json
@@ -0,0 +1,5 @@
+{
+  "name": "vitest-v5-projects",
+  "private": true,
+  "type": "module"
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/snapshots.toml
new file mode 100644
index 0000000000..aa6b615964
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/snapshots.toml
@@ -0,0 +1,9 @@
+[[case]]
+name = "project_runtime_matrix"
+vp = "local"
+steps = [
+  { argv = ["vpt", "mkdir", "-p", "node_modules"], snapshot = false },
+  { argv = ["vpt", "cp", "-r", "vendor/jest-extended", "node_modules"], snapshot = false },
+  { argv = ["vpt", "cp", "-r", "vendor/vitest", "node_modules"], snapshot = false },
+  { argv = ["node", "verify.mjs"], timeout = 120000 },
+]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/snapshots/project_runtime_matrix.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/snapshots/project_runtime_matrix.md
new file mode 100644
index 0000000000..656d43fff9
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/snapshots/project_runtime_matrix.md
@@ -0,0 +1,21 @@
+# project_runtime_matrix
+
+## `vpt mkdir -p node_modules`
+
+
+## `vpt cp -r vendor/jest-extended node_modules`
+
+
+## `vpt cp -r vendor/vitest node_modules`
+
+
+## `node verify.mjs`
+
+```
+single: 1 projects, 1 servers; imports, hooks, and assertions passed
+shared: 3 projects, 2 servers; imports, hooks, and assertions passed
+separate: 2 projects, 2 servers; imports, hooks, and assertions passed
+composed: 1 projects, 1 servers; imports, hooks, and assertions passed
+referenced: 1 projects, 1 servers; imports, hooks, and assertions passed
+nested: 1 projects, 1 servers; imports, hooks, and assertions passed
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vendor/jest-extended/index.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vendor/jest-extended/index.js
new file mode 100644
index 0000000000..183f86e07d
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vendor/jest-extended/index.js
@@ -0,0 +1,7 @@
+import { expect } from 'vitest';
+export const matcherExpect = expect;
+expect.extend({
+  toHaveSharedState(actual) {
+    return { pass: actual === 'shared', message: () => 'expected shared assertion state' };
+  },
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vendor/jest-extended/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vendor/jest-extended/package.json
new file mode 100644
index 0000000000..7f87668e69
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vendor/jest-extended/package.json
@@ -0,0 +1 @@
+{"name":"jest-extended","version":"0.0.0","type":"module","exports":"./index.js"}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vendor/vitest/index.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vendor/vitest/index.js
new file mode 100644
index 0000000000..905194c725
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vendor/vitest/index.js
@@ -0,0 +1 @@
+throw new Error('The project runner must not replace the bundled Vitest runner.');
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vendor/vitest/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vendor/vitest/package.json
new file mode 100644
index 0000000000..3f04eb136b
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vendor/vitest/package.json
@@ -0,0 +1 @@
+{"name":"vitest","version":"4.1.11","type":"module","exports":"./index.js"}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/verify.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/verify.mjs
new file mode 100644
index 0000000000..415e709e3e
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/verify.mjs
@@ -0,0 +1,42 @@
+import assert from 'node:assert/strict';
+import { createVitest } from 'vite-plus/test/node';
+
+const integrationPlugins = [
+  'vite-plus:vitest-resolver',
+  'vite-plus:auto-inline-matcher-deps',
+  'vite-plus:coverage-version-guard',
+];
+for (const name of ['single', 'shared', 'separate', 'composed', 'referenced', 'nested']) {
+  process.env.VP_TEST_PROJECT_CASE = name;
+  globalThis.__vpHookServers = [];
+  globalThis.__vpHookProjects = [];
+  const runner = await createVitest({ config: './vite.config.mjs', watch: false, reporters: [] });
+  try {
+    for (const active of runner.projects) {
+      for (const pluginName of integrationPlugins) {
+        assert.equal(active.viteConfig.plugins.filter((plugin) => plugin.name === pluginName).length, 1, `${name}/${active.name}/${pluginName}`);
+      }
+    }
+    const servers = new Set(runner.projects.map((active) => active.vite));
+    assert.equal(globalThis.__vpHookServers.length, new Set(globalThis.__vpHookServers).size);
+    assert.deepEqual(globalThis.__vpHookProjects.toSorted(), runner.projects.filter((project) => project.viteConfig.plugins.some((plugin) => plugin.name === 'test-root-hook')).map((project) => project.name).toSorted());
+    if (name === 'shared') {
+      assert.equal(servers.size, 2);
+      assert.equal(runner.getProjectByName('default').vite, runner.getProjectByName('inherited').vite);
+      assert.notEqual(runner.getProjectByName('default').vite, runner.getProjectByName('independent').vite);
+      assert.equal(runner.getProjectByName('independent').viteConfig.plugins.some((plugin) => plugin.name === 'test-root-hook'), false);
+    }
+    if (name === 'separate') {
+      assert.equal(servers.size, 2);
+      assert.notEqual(runner.projects[0].vite, runner.projects[1].vite);
+      assert.equal(runner.getProjectByName('independent').viteConfig.plugins.some((plugin) => plugin.name === 'test-root-hook'), false);
+    }
+    const result = await runner.start();
+    assert.equal(result.unhandledErrors.length, 0, JSON.stringify(result.unhandledErrors));
+    assert.equal(runner.state.getCountOfFailedTests(), 0, JSON.stringify(runner.state.getFiles().map((file) => ({ project: file.projectName, errors: file.result?.errors, tests: file.tasks.map((task) => task.result?.errors) }))));
+    assert.equal(runner.state.getFiles().length, runner.projects.length);
+    console.log(`${name}: ${runner.projects.length} projects, ${servers.size} servers; imports, hooks, and assertions passed`);
+  } finally {
+    await runner.close();
+  }
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vite.config.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vite.config.mjs
new file mode 100644
index 0000000000..88ccadc1c2
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vite.config.mjs
@@ -0,0 +1,27 @@
+import { defineConfig, defineProject } from 'vite-plus';
+
+const project = (name, extra = {}) => ({
+  ...extra,
+  test: { name, include: ['identity.test.js'], provide: { value: name } },
+});
+const options = {
+  single: {},
+  shared: { projects: [project('default'), project('inherited', { extends: true }), project('independent', { extends: false })] },
+  separate: { sharedViteServer: false, projects: [project('default'), project('independent', { extends: false })] },
+  composed: { projects: [defineProject(project('composed'))] },
+  referenced: { projects: ['./vitest.referenced.config.js'] },
+  nested: { projects: ['./vitest.nested.config.js'] },
+};
+
+export default defineConfig({
+  plugins: [{
+    name: 'test-root-hook',
+    configureServer(server) { globalThis.__vpHookServers.push(server); },
+    configureVitest({ project }) { globalThis.__vpHookProjects.push(project.name); },
+  }],
+  test: {
+    include: ['identity.test.js'],
+    provide: { value: 'root' },
+    ...options[process.env.VP_TEST_PROJECT_CASE],
+  },
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vitest.nested.config.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vitest.nested.config.js
new file mode 100644
index 0000000000..7d6f8ed1a0
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vitest.nested.config.js
@@ -0,0 +1,8 @@
+import { defineProject } from 'vite-plus';
+export default defineProject({
+  test: {
+    name: 'nested-parent',
+    provide: { value: 'nested' },
+    projects: [{ test: { name: 'nested-child', include: ['identity.test.js'] } }],
+  },
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vitest.referenced.config.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vitest.referenced.config.js
new file mode 100644
index 0000000000..7e1ae230b7
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vitest.referenced.config.js
@@ -0,0 +1,8 @@
+import { defineProject } from 'vite-plus';
+export default defineProject({
+  test: {
+    name: 'referenced',
+    include: ['identity.test.js'],
+    provide: { value: 'referenced' },
+  },
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/browser.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/browser.test.js
new file mode 100644
index 0000000000..38afd04180
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/browser.test.js
@@ -0,0 +1,10 @@
+import { expect, test } from 'vite-plus/test';
+import { page } from 'vite-plus/test/browser-playwright/context';
+
+test('fixed viewport and reference image', async () => {
+  document.body.style.margin = '0';
+  document.body.innerHTML = '<div data-testid="box" style="width:100px;height:40px;background:blue"></div>';
+  expect([window.innerWidth, window.innerHeight]).toEqual([800, 600]);
+  await expect(page.getByTestId('box')).toMatchScreenshot('box');
+  await page.screenshot({ name: 'viewport' });
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/failure.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/failure.test.js
new file mode 100644
index 0000000000..8ed87b51d9
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/failure.test.js
@@ -0,0 +1,6 @@
+import { expect, test } from 'vite-plus/test';
+
+test('intentional failure screenshot', () => {
+  document.body.innerHTML = '<div style="height:40px;background:red"></div>';
+  expect(true, 'fixture deliberately fails to capture its attachment').toBe(false);
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/package.json
new file mode 100644
index 0000000000..a05f3ca57b
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/package.json
@@ -0,0 +1 @@
+{ "name": "test-v5-screenshots", "private": true, "type": "module" }
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/snapshots.toml
new file mode 100644
index 0000000000..f191a4074b
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/snapshots.toml
@@ -0,0 +1,13 @@
+[[case]]
+name = "headless_paths_and_dimensions"
+vp = "local"
+env = { PLAYWRIGHT_BROWSERS_PATH = "0" }
+steps = [{ argv = ["node", "verify.mjs"], timeout = 120000 }]
+
+[[case]]
+name = "headed_paths_and_dimensions"
+vp = "local"
+skip-platforms = ["linux", "windows"]
+env = { PLAYWRIGHT_BROWSERS_PATH = "0" }
+comment = "Headed coverage runs on macOS; the Linux and Windows snapshot workers have no desktop display. All platforms run the headless case."
+steps = [{ argv = ["node", "verify.mjs", "--headed"], timeout = 120000 }]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/snapshots/headed_paths_and_dimensions.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/snapshots/headed_paths_and_dimensions.md
new file mode 100644
index 0000000000..8f29ee3935
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/snapshots/headed_paths_and_dimensions.md
@@ -0,0 +1,14 @@
+# headed_paths_and_dimensions
+
+Headed coverage runs on macOS; the Linux and Windows snapshot workers have no desktop display. All platforms run the headless case.
+
+## `node verify.mjs --headed`
+
+```
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Headed record: custom reference path, 100 x 40 element, 800 x 600 viewport
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Headed compare: custom reference path, 100 x 40 element, 800 x 600 viewport
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Failure screenshot: .vitest/attachments/failure-screenshots, 800 x 600
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/snapshots/headless_paths_and_dimensions.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/snapshots/headless_paths_and_dimensions.md
new file mode 100644
index 0000000000..7d7449913d
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/snapshots/headless_paths_and_dimensions.md
@@ -0,0 +1,12 @@
+# headless_paths_and_dimensions
+
+## `node verify.mjs`
+
+```
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Headless record: custom reference path, 100 x 40 element, 800 x 600 viewport
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Headless compare: custom reference path, 100 x 40 element, 800 x 600 viewport
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
+Failure screenshot: .vitest/attachments/failure-screenshots, 800 x 600
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/verify.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/verify.mjs
new file mode 100644
index 0000000000..6825a3dbb9
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/verify.mjs
@@ -0,0 +1,57 @@
+import assert from 'node:assert/strict';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { defineConfig } from 'vite-plus';
+import { createVitest } from 'vite-plus/test/node';
+import { playwright } from 'vite-plus/test/browser-playwright';
+
+const headed = process.argv.includes('--headed');
+const pngs = (directory) => readdirSync(directory, { recursive: true }).filter((name) => name.endsWith('.png')).map((name) => join(directory, name));
+const dimensions = (file) => {
+  const buffer = readFileSync(file);
+  assert.equal(buffer.subarray(1, 4).toString(), 'PNG');
+  return [buffer.readUInt32BE(16), buffer.readUInt32BE(20)];
+};
+for (const phase of ['record', 'compare', 'failure']) {
+  const runner = await createVitest({
+    config: false, watch: false, reporters: [], update: phase === 'record',
+  }, defineConfig({ test: {
+    include: [phase === 'failure' ? 'failure.test.js' : 'browser.test.js'],
+    browser: {
+      enabled: true, provider: playwright(), headless: !headed, ui: false,
+      instances: [{ browser: 'chromium' }], viewport: { width: 800, height: 600 },
+      screenshotFailures: true, screenshotDirectory: 'manual-images',
+      expect: { toMatchScreenshot: { screenshotDirectory: 'reference-images' } },
+    },
+  } }));
+  try {
+    const result = await runner.start();
+    assert.equal(result.unhandledErrors.length, 0, JSON.stringify(result.unhandledErrors));
+    assert.equal(runner.state.getFiles().length, 1);
+    if (phase === 'failure') {
+      assert.equal(runner.state.getFiles()[0].tasks.length, 1);
+      const task = runner.state.getFiles()[0].tasks[0];
+      assert.equal(task.result.state, 'fail');
+      assert.equal(task.result.errors.length, 1);
+      assert.match(task.result.errors[0].message, /fixture deliberately fails/);
+      const images = pngs('.vitest/attachments/failure-screenshots');
+      assert.equal(images.length, 1);
+      assert.deepEqual(dimensions(images[0]), [800, 600]);
+      console.log('Failure screenshot: .vitest/attachments/failure-screenshots, 800 x 600');
+    } else {
+      assert.equal(runner.state.getCountOfFailedTests(), 0,
+        JSON.stringify(runner.state.getFiles().flatMap((file) => file.tasks.map((task) => task.result))));
+      const references = pngs('reference-images');
+      assert.equal(references.length, 1, `reference images: ${JSON.stringify(references)}`);
+      assert.deepEqual(dimensions(references[0]), [100, 40]);
+      const manual = pngs('manual-images').filter((file) => file.includes('viewport'));
+      assert.equal(manual.length, 1, `manual images: ${JSON.stringify(pngs('manual-images'))}`);
+      assert.deepEqual(dimensions(manual[0]), [800, 600]);
+      assert.equal(existsSync('__screenshots__'), false);
+      console.log(`${headed ? 'Headed' : 'Headless'} ${phase}: custom reference path, 100 x 40 element, 800 x 600 viewport`);
+    }
+  } finally { await runner.close(); }
+}
+// All assertions above must succeed, including the deliberate failure's error
+// and attachment. No unexpected browser failure can turn this case green.
+process.exitCode = 0;
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/package.json
new file mode 100644
index 0000000000..87ff64ed27
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/package.json
@@ -0,0 +1,12 @@
+{
+  "name": "test-v5-upstream-types",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@11.24.0",
+  "devDependencies": {
+    "vitest": "5.0.1",
+    "@vitest/browser-preview": "5.0.1",
+    "@testing-library/jest-dom": "6.9.1",
+    "typescript": "6.0.3"
+  }
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/snapshots.toml
new file mode 100644
index 0000000000..bcad2d1ee4
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/snapshots.toml
@@ -0,0 +1,21 @@
+[[case]]
+name = "jest_dom_browser_type_order"
+vp = "global"
+local-registry = true
+comment = "Known upstream type conflict: browser-first declarations reject valid Node jest-dom assertions. Check upstream imports without Vite+ installed, plus the opposite-order control; this is not a passed release gate."
+steps = [
+  { argv = ["vp", "install", "--ignore-scripts"], snapshot = false, timeout = 180000 },
+  ["node", "verify.mjs"],
+]
+
+[[case]]
+name = "jest_dom_v7_browser_type_order"
+vp = "global"
+local-registry = true
+comment = "Check whether the current jest-dom release resolves the upstream declaration-order conflict."
+steps = [
+  { argv = ["vpt", "json-edit", "package.json", "devDependencies.@testing-library/jest-dom", "7.0.1"], snapshot = false },
+  { argv = ["vpt", "json-edit", "package.json", "devDependencies.@testing-library/dom", "10.4.1"], snapshot = false },
+  { argv = ["vp", "install", "--ignore-scripts"], snapshot = false, timeout = 180000 },
+  ["node", "verify.mjs"],
+]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/snapshots/jest_dom_browser_type_order.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/snapshots/jest_dom_browser_type_order.md
new file mode 100644
index 0000000000..9818119561
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/snapshots/jest_dom_browser_type_order.md
@@ -0,0 +1,14 @@
+# jest_dom_browser_type_order
+
+Known upstream type conflict: browser-first declarations reject valid Node jest-dom assertions. Check upstream imports without Vite+ installed, plus the opposite-order control; this is not a passed release gate.
+
+## `vp install --ignore-scripts`
+
+
+## `node verify.mjs`
+
+```
+vitest: browser-first=true, Node jest-dom type errors=2
+vitest: browser-first=false, Node jest-dom type errors=0
+Release blocker reproduced: browser and jest-dom declaration order changes Node matcher types
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/snapshots/jest_dom_v7_browser_type_order.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/snapshots/jest_dom_v7_browser_type_order.md
new file mode 100644
index 0000000000..56ed974d89
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/snapshots/jest_dom_v7_browser_type_order.md
@@ -0,0 +1,20 @@
+# jest_dom_v7_browser_type_order
+
+Check whether the current jest-dom release resolves the upstream declaration-order conflict.
+
+## `vpt json-edit package.json devDependencies.@testing-library/jest-dom 7.0.1`
+
+
+## `vpt json-edit package.json devDependencies.@testing-library/dom 10.4.1`
+
+
+## `vp install --ignore-scripts`
+
+
+## `node verify.mjs`
+
+```
+vitest: browser-first=true, Node jest-dom type errors=2
+vitest: browser-first=false, Node jest-dom type errors=0
+Release blocker reproduced: browser and jest-dom declaration order changes Node matcher types
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/verify.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/verify.mjs
new file mode 100644
index 0000000000..a07394894b
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/verify.mjs
@@ -0,0 +1,45 @@
+import assert from 'node:assert/strict';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import ts from 'typescript';
+
+const file = path.resolve('virtual-jest-dom-type-probe.ts');
+assert.equal(existsSync('node_modules/vite-plus'), false);
+const options = {
+  target: ts.ScriptTarget.ESNext,
+  module: ts.ModuleKind.Preserve,
+  moduleResolution: ts.ModuleResolutionKind.Bundler,
+  strict: true,
+  skipLibCheck: true,
+  noEmit: true,
+  types: [],
+};
+for (const browserFirst of [true, false]) {
+  const imports = ['vitest/browser', '@testing-library/jest-dom/vitest'];
+  if (!browserFirst) imports.reverse();
+  const source = imports.map((name) => `import '${name}';`).join('\n') + `
+    import { expect } from 'vitest';
+    import { page } from 'vitest/browser';
+    page.getByRole('button');
+    expect(document.body).toHaveTextContent(/text/);
+    expect(document.body).toHaveStyle({ '--custom': '1px' });
+  `;
+  const host = ts.createCompilerHost(options);
+  const getSourceFile = host.getSourceFile.bind(host);
+  host.getSourceFile = (name, language, ...rest) =>
+    name.replaceAll('\\', '/') === file.replaceAll('\\', '/')
+      ? ts.createSourceFile(name, source, language, true)
+      : getSourceFile(name, language, ...rest);
+  const program = ts.createProgram([file], options, host);
+  assert.ok(program.getSourceFiles().some(({ fileName }) =>
+    /@vitest\/browser\/matchers\.d\.ts$/.test(fileName.replaceAll('\\', '/')),
+  ));
+  const diagnostics = ts.getPreEmitDiagnostics(program);
+  assert.deepEqual(diagnostics.map(({ code }) => code), browserFirst ? [2345, 2353] : []);
+  if (browserFirst) {
+    assert.match(ts.flattenDiagnosticMessageText(diagnostics[0].messageText, ' '), /RegExp/);
+    assert.match(ts.flattenDiagnosticMessageText(diagnostics[1].messageText, ' '), /CSSStyleDeclaration/);
+  }
+  console.log(`vitest: browser-first=${browserFirst}, Node jest-dom type errors=${diagnostics.length}`);
+}
+console.log('Release blocker reproduced: browser and jest-dom declaration order changes Node matcher types');
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/browser.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/browser.test.js
new file mode 100644
index 0000000000..3326e27872
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/browser.test.js
@@ -0,0 +1,18 @@
+import { expect, test } from 'vite-plus/test';
+import { expect as rawExpect } from 'vitest';
+import { commands, page } from 'vite-plus/test/browser';
+import { page as contextPage } from 'vite-plus/test/browser/context';
+
+test('community provider shares runner state and serialized locators', async () => {
+  expect(expect).toBe(rawExpect);
+  expect(page).toBe(contextPage);
+  document.body.innerHTML = '<button>Increment</button><output>0</output>';
+  document.querySelector('button').onclick = () => { document.querySelector('output').textContent = '1'; };
+  const button = page.getByRole('button', { name: 'Increment' });
+  const serialized = await commands.inspectLocator(button);
+  expect(serialized.selector).toBeTypeOf('string');
+  expect(serialized.locator).toBeTypeOf('string');
+  expect(serialized.session).toBe(true);
+  await button.click();
+  await expect.element(page.getByRole('status')).toHaveTextContent('1');
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/chromium.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/chromium.mjs
new file mode 100644
index 0000000000..46e6d1aadc
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/chromium.mjs
@@ -0,0 +1,19 @@
+import assert from 'node:assert/strict';
+import { createRequire } from 'node:module';
+
+export async function installedChromium() {
+  const require = createRequire(import.meta.resolve('vite-plus/package.json'));
+  const { chromium } = require('playwright');
+  const executablePath = chromium.executablePath();
+  // WebDriverIO's Windows detection expects version-named directories beside
+  // chrome.exe, which Playwright does not provide. Read the actual browser
+  // version so driver selection cannot fall back to an unrelated system Chrome.
+  const browser = await chromium.launch({ executablePath, args: ['--no-sandbox'] });
+  try {
+    const browserVersion = browser.version();
+    assert.match(browserVersion, /^\d+\.\d+\.\d+\.\d+$/);
+    return { executablePath, browserVersion };
+  } finally {
+    await browser.close();
+  }
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/package.json
new file mode 100644
index 0000000000..70fbd2ebd1
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/package.json
@@ -0,0 +1 @@
+{ "name": "test-v5-webdriverio", "private": true, "type": "module" }
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/pnpm-workspace.yaml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/pnpm-workspace.yaml
new file mode 100644
index 0000000000..3add64eb5f
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/pnpm-workspace.yaml
@@ -0,0 +1,5 @@
+# The community provider accepts newer @vitest/browser patches. Keep this
+# fixture on the bundled runner's version when testing the packed package.
+overrides:
+  '@vitest/browser': 5.0.1
+  vitest: 5.0.1
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/prepare-packed.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/prepare-packed.mjs
new file mode 100644
index 0000000000..9248437a26
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/prepare-packed.mjs
@@ -0,0 +1,5 @@
+import { writeFileSync } from 'node:fs';
+import { installedChromium } from './chromium.mjs';
+
+// Reuse the browser provisioned for the checkout before installing project peers.
+writeFileSync('chromium.json', JSON.stringify(await installedChromium()));
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/snapshots.toml
new file mode 100644
index 0000000000..243397eb03
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/snapshots.toml
@@ -0,0 +1,24 @@
+[[case]]
+name = "community_provider_and_browser_protocol"
+vp = "local"
+env = { PLAYWRIGHT_BROWSERS_PATH = "0" }
+# Native Chrome logs vary on Windows even when all protocol assertions pass.
+# Assert success through the exit status; the runner keeps full output on failure.
+steps = [
+  { argv = ["node", "verify.mjs"], timeout = 180000, snapshot = false },
+  ["vpt", "print", "WebDriverIO browser protocol assertions passed"],
+]
+
+[[case]]
+name = "packed_community_provider_and_browser_protocol"
+vp = "global"
+local-registry = true
+env = { PLAYWRIGHT_BROWSERS_PATH = "0" }
+steps = [
+  { argv = ["node", "prepare-packed.mjs"], snapshot = false },
+  { argv = ["vpt", "write-file", "package.json", "{\"name\":\"test-v5-webdriverio\",\"private\":true,\"type\":\"module\",\"packageManager\":\"pnpm@11.24.0\",\"devDependencies\":{\"vite-plus\":\"latest\",\"@vitest/browser-webdriverio\":\"5.0.0\",\"webdriverio\":\"9.20.1\"}}\n"], snapshot = false },
+  { argv = ["vp", "install", "--ignore-scripts"], timeout = 180000, snapshot = false },
+  # Keep assertion failures visible without snapshotting native Chrome logs.
+  { argv = ["node", "verify.mjs", "--packed"], timeout = 180000, snapshot = false },
+  ["vpt", "print", "Packed WebDriverIO browser protocol assertions passed"],
+]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/snapshots/community_provider_and_browser_protocol.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/snapshots/community_provider_and_browser_protocol.md
new file mode 100644
index 0000000000..a308528fa4
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/snapshots/community_provider_and_browser_protocol.md
@@ -0,0 +1,10 @@
+# community_provider_and_browser_protocol
+
+## `node verify.mjs`
+
+
+## `vpt print 'WebDriverIO browser protocol assertions passed'`
+
+```
+WebDriverIO browser protocol assertions passed
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/snapshots/packed_community_provider_and_browser_protocol.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/snapshots/packed_community_provider_and_browser_protocol.md
new file mode 100644
index 0000000000..a5c7f6e329
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/snapshots/packed_community_provider_and_browser_protocol.md
@@ -0,0 +1,20 @@
+# packed_community_provider_and_browser_protocol
+
+## `node prepare-packed.mjs`
+
+
+## `vpt write-file package.json '{"name":"test-v5-webdriverio","private":true,"type":"module","packageManager":"pnpm@11.24.0","devDependencies":{"vite-plus":"latest","@vitest/browser-webdriverio":"5.0.0","webdriverio":"9.20.1"}}
+'`
+
+
+## `vp install --ignore-scripts`
+
+
+## `node verify.mjs --packed`
+
+
+## `vpt print 'Packed WebDriverIO browser protocol assertions passed'`
+
+```
+Packed WebDriverIO browser protocol assertions passed
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/verify.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/verify.mjs
new file mode 100644
index 0000000000..136e7c38d4
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/verify.mjs
@@ -0,0 +1,68 @@
+import assert from 'node:assert/strict';
+import { readFileSync, realpathSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { isAbsolute, relative } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { inspect } from 'node:util';
+import { defineConfig } from 'vite-plus';
+import { createVitest } from 'vite-plus/test/node';
+import { installedChromium } from './chromium.mjs';
+
+const packed = process.argv.includes('--packed');
+// Unpacked cases only link vite-plus. Packed cases use the project's own
+// community-provider dependency, without a Vite+ shim or resolver redirect.
+const require = createRequire(packed ? import.meta.url : import.meta.resolve('vite-plus/package.json'));
+const { webdriverio } = await import(packed
+  ? '@vitest/browser-webdriverio'
+  : pathToFileURL(require.resolve('@vitest/browser-webdriverio')).href);
+const vitestRequire = createRequire(import.meta.resolve('vite-plus/package.json'));
+if (packed) {
+  for (const file of [fileURLToPath(import.meta.resolve('vite-plus/package.json')), require.resolve('@vitest/browser-webdriverio/package.json')]) {
+    const installed = relative(realpathSync(process.cwd()), realpathSync(file));
+    assert.ok(!isAbsolute(installed) && !installed.startsWith('..'), `Expected an installed package in the fixture, got ${installed}`);
+  }
+}
+const { executablePath, browserVersion } = packed
+  ? JSON.parse(readFileSync('chromium.json', 'utf8'))
+  : await installedChromium();
+assert.equal(require('@vitest/browser-webdriverio/package.json').version, '5.0.0');
+const providerRequire = createRequire(require.resolve('@vitest/browser-webdriverio/package.json'));
+assert.equal(providerRequire('@vitest/browser/package.json').version, vitestRequire('vitest/package.json').version);
+const provider = webdriverio({ capabilities: {
+  browserVersion,
+  'goog:chromeOptions': {
+    binary: executablePath,
+    args: ['--no-sandbox'],
+  },
+} });
+let sessionOpened = false;
+const createProvider = provider.providerFactory;
+provider.providerFactory = (project) => {
+  const instance = createProvider(project);
+  const openPage = instance.openPage.bind(instance);
+  instance.openPage = async (session, url) => {
+    assert.equal(new URL(url).searchParams.get('sessionId'), session);
+    sessionOpened = true;
+    return openPage(session, url);
+  };
+  return instance;
+};
+const runner = await createVitest({ config: false, watch: false, reporters: [] }, defineConfig({ test: {
+  include: ['browser.test.js'],
+  browser: {
+    enabled: true, headless: true, provider, instances: [{ browser: 'chrome' }],
+    viewport: { width: 800, height: 600 },
+    commands: { inspectLocator(context, locator) {
+      assert.equal(typeof locator, 'object');
+      return { ...locator, session: typeof context.sessionId === 'string' && context.sessionId.length > 0 };
+    } },
+  },
+} }));
+try {
+  const result = await runner.start();
+  assert.equal(result.unhandledErrors.length, 0, inspect(result.unhandledErrors));
+  assert.equal(runner.state.getCountOfFailedTests(), 0, JSON.stringify(runner.state.getFiles().flatMap((file) => [file.result, ...file.tasks.map((task) => task.result)])));
+  assert.equal(runner.state.getFiles().length, 1);
+  assert.ok(sessionOpened);
+  console.log('WebDriverIO 5.0.0 with Vitest 5.0.1: runner/context identity, real-timer clicks, session URLs, and serialized custom-command locators passed');
+} finally { await runner.close(); }
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_vi_mock_hoist/snapshots/test_vi_mock_hoist.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_vi_mock_hoist/snapshots/test_vi_mock_hoist.md
index 11c3827035..265e7e7e11 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_vi_mock_hoist/snapshots/test_vi_mock_hoist.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_vi_mock_hoist/snapshots/test_vi_mock_hoist.md
@@ -14,5 +14,5 @@ vi.mock() from 'vite-plus/test' must hoist via upstream mocker (no vite-plus pat
  Test Files  1 passed (1)
       Tests  1 passed (1)
    Start at  <time>
-   Duration  <duration> (transform <duration>, setup <duration>, import <duration>, tests <duration>, environment <duration>)
+   Duration  <duration> (<timing>)
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/package.json
new file mode 100644
index 0000000000..1fcc5640c5
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/package.json
@@ -0,0 +1,10 @@
+{
+  "name": "test-workspace-api-identity",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@11.24.0",
+  "devDependencies": {
+    "@types/node": "24.10.3",
+    "vite-plus": "latest"
+  }
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/packages/child/identity.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/packages/child/identity.test.js
new file mode 100644
index 0000000000..a653330ca2
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/packages/child/identity.test.js
@@ -0,0 +1,17 @@
+import { beforeEach, describe, expect, it, vi } from 'vite-plus/test';
+import { expect as runnerExpect, vi as runnerVi } from 'vitest';
+import { value } from './value.js';
+
+vi.mock('./value.js', () => ({ value: 'mocked' }));
+const hook = vi.fn();
+beforeEach(hook);
+
+describe('workspace test API', () => {
+  it('shares collection, assertions, and mocks with the active runner', () => {
+    expect(expect).toBe(runnerExpect);
+    expect(vi).toBe(runnerVi);
+    expect(value).toBe('mocked');
+    expect(hook).toHaveBeenCalledOnce();
+    expect(vi.fn()()).toBeUndefined();
+  });
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/packages/child/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/packages/child/package.json
new file mode 100644
index 0000000000..e05de0c651
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/packages/child/package.json
@@ -0,0 +1,9 @@
+{
+  "name": "identity-child",
+  "private": true,
+  "type": "module",
+  "devDependencies": {
+    "@types/node": "22.18.0",
+    "vite-plus": "latest"
+  }
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/packages/child/value.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/packages/child/value.js
new file mode 100644
index 0000000000..08d6f5ffa8
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/packages/child/value.js
@@ -0,0 +1 @@
+export const value = 'original';
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/packages/child/vite.config.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/packages/child/vite.config.js
new file mode 100644
index 0000000000..54683dc496
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/packages/child/vite.config.js
@@ -0,0 +1,6 @@
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({
+  root: import.meta.dirname,
+  test: { name: 'child', include: ['identity.test.js'] },
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/pnpm-workspace.yaml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/pnpm-workspace.yaml
new file mode 100644
index 0000000000..924b55f42e
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/pnpm-workspace.yaml
@@ -0,0 +1,2 @@
+packages:
+  - packages/*
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/snapshots.toml
new file mode 100644
index 0000000000..c3533d9207
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/snapshots.toml
@@ -0,0 +1,13 @@
+[[case]]
+name = "workspace_test_api_identity"
+vp = "global"
+local-registry = true
+comment = "Workspace test imports must use the active Vitest runner, even when pnpm installs separate root and child peer instances."
+steps = [
+  { argv = ["vp", "install", "--ignore-scripts"], snapshot = false, timeout = 180000 },
+  { argv = ["node", "verify.mjs"], timeout = 120000 },
+  { argv = ["vp", "test", "run"], timeout = 120000 },
+  { argv = ["vp", "test", "run"], envs = [["IDENTITY_MODE", "shared"]], timeout = 120000 },
+  { argv = ["vp", "test", "run"], envs = [["IDENTITY_MODE", "separate"]], timeout = 120000 },
+  { argv = ["vp", "test", "run"], cwd = "packages/child", timeout = 120000 },
+]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/snapshots/workspace_test_api_identity.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/snapshots/workspace_test_api_identity.md
new file mode 100644
index 0000000000..7a35db156c
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/snapshots/workspace_test_api_identity.md
@@ -0,0 +1,83 @@
+# workspace_test_api_identity
+
+Workspace test imports must use the active Vitest runner, even when pnpm installs separate root and child peer instances.
+
+## `vp install --ignore-scripts`
+
+
+## `node verify.mjs`
+
+```
+Root and child have distinct Vite+ and Vitest peer instances
+single: collection, hooks, assertions, and mocks passed
+shared: collection, hooks, assertions, and mocks passed
+separate: collection, hooks, assertions, and mocks passed
+```
+
+## `vp test run`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+ RUN  <version> <workspace>
+
+ ✓ packages/child/identity.test.js (1 test) <duration>
+   ✓ workspace test API (1)
+     ✓ shares collection, assertions, and mocks with the active runner <duration>
+
+ Test Files  1 passed (1)
+      Tests  1 passed (1)
+   Start at  <time>
+   Duration  <duration> (<timing>)
+```
+
+## `IDENTITY_MODE=shared vp test run`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+ RUN  <version> <workspace>
+
+ ✓  child  packages/child/identity.test.js (1 test) <duration>
+   ✓ workspace test API (1)
+     ✓ shares collection, assertions, and mocks with the active runner <duration>
+
+ Test Files  1 passed (1)
+      Tests  1 passed (1)
+   Start at  <time>
+   Duration  <duration> (<timing>)
+```
+
+## `IDENTITY_MODE=separate vp test run`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+ RUN  <version> <workspace>
+
+ ✓  child  identity.test.js (1 test) <duration>
+   ✓ workspace test API (1)
+     ✓ shares collection, assertions, and mocks with the active runner <duration>
+
+ Test Files  1 passed (1)
+      Tests  1 passed (1)
+   Start at  <time>
+   Duration  <duration> (<timing>)
+```
+
+## `cd packages/child && vp test run`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+ RUN  <version> <workspace>/packages/child
+
+ ✓  child  identity.test.js (1 test) <duration>
+   ✓ workspace test API (1)
+     ✓ shares collection, assertions, and mocks with the active runner <duration>
+
+ Test Files  1 passed (1)
+      Tests  1 passed (1)
+   Start at  <time>
+   Duration  <duration> (<timing>)
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/verify.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/verify.mjs
new file mode 100644
index 0000000000..53f4de038f
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/verify.mjs
@@ -0,0 +1,30 @@
+import assert from 'node:assert/strict';
+import { realpathSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { createVitest } from 'vite-plus/test/node';
+
+const root = createRequire(import.meta.url);
+const child = createRequire(new URL('./packages/child/package.json', import.meta.url));
+const vitePlus = (require) => realpathSync(require.resolve('vite-plus/package.json'));
+const vitest = (require) => realpathSync(createRequire(vitePlus(require)).resolve('vitest/package.json'));
+assert.notEqual(vitePlus(root), vitePlus(child));
+assert.notEqual(vitest(root), vitest(child));
+console.log('Root and child have distinct Vite+ and Vitest peer instances');
+
+// Check programmatic runners too: selecting an instance must not depend on
+// environment variables set only by the vp CLI.
+for (const mode of ['single', 'shared', 'separate']) {
+  process.env.IDENTITY_MODE = mode;
+  const runner = await createVitest({ watch: false, reporters: [] });
+  try {
+    const project = runner.projects[0];
+    assert.equal(project.sharedViteServer, mode === 'shared');
+    const result = await runner.start();
+    assert.equal(result.unhandledErrors.length, 0, JSON.stringify(result.unhandledErrors));
+    assert.equal(runner.state.getCountOfFailedTests(), 0, JSON.stringify(runner.state.getFiles().map(file => file.result?.errors)));
+    assert.equal(runner.state.getFiles().length, 1);
+    console.log(`${mode}: collection, hooks, assertions, and mocks passed`);
+  } finally {
+    await runner.close();
+  }
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/vite.config.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/vite.config.js
new file mode 100644
index 0000000000..83916fc876
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_workspace_api_identity/vite.config.js
@@ -0,0 +1,12 @@
+import { defineConfig } from 'vite-plus';
+
+const mode = process.env.IDENTITY_MODE ?? 'single';
+const include = ['packages/child/identity.test.js'];
+const configurations = {
+  single: { include },
+  shared: { projects: [{ test: { name: 'child', include } }] },
+  separate: { sharedViteServer: false, projects: ['packages/child'] },
+};
+export default defineConfig({
+  test: configurations[mode],
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vite_plugins_async_test/snapshots/vite_plugins_async_test.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vite_plugins_async_test/snapshots/vite_plugins_async_test.md
index 34969de666..380067c8ca 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vite_plugins_async_test/snapshots/vite_plugins_async_test.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vite_plugins_async_test/snapshots/vite_plugins_async_test.md
@@ -14,5 +14,5 @@ async plugins factory should load vitest plugin with configureVitest hook
  Test Files  1 passed (1)
       Tests  1 passed (1)
    Start at  <time>
-   Duration  <duration> (transform <duration>, setup <duration>, import <duration>, tests <duration>, environment <duration>)
+   Duration  <duration> (<timing>)
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vite_task_path_env_include_pm/snapshots/vite_task_path_env_include_pm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vite_task_path_env_include_pm/snapshots/vite_task_path_env_include_pm.md
index 868dda08ec..c7743bef9b 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vite_task_path_env_include_pm/snapshots/vite_task_path_env_include_pm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vite_task_path_env_include_pm/snapshots/vite_task_path_env_include_pm.md
@@ -11,7 +11,7 @@
 ➤ YN0000: ┌ Link step
 ➤ YN0000: │ ESM support for PnP uses the experimental loader API and is therefore experimental
 ➤ YN0000: └ Completed
-➤ YN0000: · Done with warnings in <duration> <duration>
+➤ YN0000: · Done with warnings in <duration>
 ```
 
 ## `vp run check-yarn-version`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vitest_browser_mode/snapshots/vitest_browser_mode.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vitest_browser_mode/snapshots/vitest_browser_mode.md
index 86f0e13eaf..c7102da006 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vitest_browser_mode/snapshots/vitest_browser_mode.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vitest_browser_mode/snapshots/vitest_browser_mode.md
@@ -4,15 +4,17 @@
 
 ```
 $ vp test
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
 
  RUN  <version> <workspace>
+      API started at http://localhost:<port>/
 
  ✓  chromium  src/foo.test.js (1 test) <duration>
 
  Test Files  1 passed (1)
       Tests  1 passed (1)
    Start at  <time>
-   Duration  <duration> (transform <duration>, setup <duration>, import <duration>, tests <duration>, environment <duration>)
+   Duration  <duration> (<timing>)
 ```
 
 ## `vpt write-file src/foo.js 'export default '\''foo'\'';
@@ -24,15 +26,17 @@ $ vp test
 
 ```
 $ vp test ○ cache miss: 'src/foo.js' modified, executing
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
 
  RUN  <version> <workspace>
+      API started at http://localhost:<port>/
 
  ✓  chromium  src/foo.test.js (1 test) <duration>
 
  Test Files  1 passed (1)
       Tests  1 passed (1)
    Start at  <time>
-   Duration  <duration> (transform <duration>, setup <duration>, import <duration>, tests <duration>, environment <duration>)
+   Duration  <duration> (<timing>)
 ```
 
 ## `vpt write-file src/bar.js 'export default '\''bar'\'';
@@ -44,15 +48,17 @@ $ vp test ○ cache miss: 'src/foo.js' modified, executing
 
 ```
 $ vp test ◉ cache hit, replaying
+Plugin "vitest:mocks:interceptor" defines Vite-specific hooks (configureServer) in a plugin returned from applyToEnvironment. These hooks will be ignored.
 
  RUN  <version> <workspace>
+      API started at http://localhost:<port>/
 
  ✓  chromium  src/foo.test.js (1 test) <duration>
 
  Test Files  1 passed (1)
       Tests  1 passed (1)
    Start at  <time>
-   Duration  <duration> (transform <duration>, setup <duration>, import <duration>, tests <duration>, environment <duration>)
+   Duration  <duration> (<timing>)
 
 ---
 vp run: cache hit, <duration> saved.
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vitest_browser_mode/vitest.config.ts b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vitest_browser_mode/vitest.config.ts
index 22c1dc03b6..00dd92e6b7 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vitest_browser_mode/vitest.config.ts
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vitest_browser_mode/vitest.config.ts
@@ -1,7 +1,7 @@
-// import { defineProject } from 'vitest/config';
+import { defineConfig } from 'vite-plus';
 import { playwright } from 'vite-plus/test/browser-playwright';
 
-export default {
+export default defineConfig({
   plugins: [
     {
       name: 'vitest-browser-mode-suppress-known-vite-logs',
@@ -35,4 +35,4 @@ export default {
       ],
     },
   },
-};
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/yarn_update_notifier/snapshots/yarn2_update_notifier_compatibility.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/yarn_update_notifier/snapshots/yarn2_update_notifier_compatibility.md
index 493b6605ea..e1d3707252 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/yarn_update_notifier/snapshots/yarn2_update_notifier_compatibility.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/yarn_update_notifier/snapshots/yarn2_update_notifier_compatibility.md
@@ -22,5 +22,5 @@ VITE+ - The Unified Toolchain for the Web
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: Done in <duration> <duration>
+➤ YN0000: Done in <duration>
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/yarn_update_notifier/snapshots/yarn3_update_notifier_compatibility.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/yarn_update_notifier/snapshots/yarn3_update_notifier_compatibility.md
index a49330fbc9..2d078478f1 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/yarn_update_notifier/snapshots/yarn3_update_notifier_compatibility.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/yarn_update_notifier/snapshots/yarn3_update_notifier_compatibility.md
@@ -22,5 +22,5 @@ VITE+ - The Unified Toolchain for the Web
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: Done in <duration> <duration>
+➤ YN0000: Done in <duration>
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/yarn_update_notifier/snapshots/yarn4_update_notifier.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/yarn_update_notifier/snapshots/yarn4_update_notifier.md
index 4054b53fd9..f773fce6b2 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/yarn_update_notifier/snapshots/yarn4_update_notifier.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/yarn_update_notifier/snapshots/yarn4_update_notifier.md
@@ -34,5 +34,5 @@ VITE+ - The Unified Toolchain for the Web
 ➤ YN0000: └ Completed
 ➤ YN0000: ┌ Link step
 ➤ YN0000: └ Completed
-➤ YN0000: · Done in <duration> <duration>
+➤ YN0000: · Done in <duration>
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/redact.rs b/crates/vp_cli_snapshots/tests/cli_snapshots/redact.rs
index 5cc9576271..d6830c37f4 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/redact.rs
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/redact.rs
@@ -14,6 +14,23 @@ static UUID_RE: LazyLock<regex::Regex> = LazyLock::new(|| {
 });
 static DURATION_RE: LazyLock<regex::Regex> =
     LazyLock::new(|| regex::Regex::new(r"\b\d+(\.\d+)?(ns|µs|ms|s)\b").unwrap());
+// Yarn prints elapsed times as one or several units (999ms vs 1s 0ms).
+// Match the entire elapsed field, not adjacent values in timing tables.
+static YARN_ELAPSED_RE: LazyLock<regex::Regex> = LazyLock::new(|| {
+    regex::Regex::new(
+        r"(\b(?:Done(?: with (?:warnings|errors))?|[Cc]ompleted) in )\d+(?:\.\d+)?(?:ms|s|m|h)\b(?:[ \t]+\d+(?:\.\d+)?(?:ms|s|m|h)\b)*",
+    )
+    .unwrap()
+});
+// Yarn omits the step timer entirely for fast steps. Keep the completion
+// marker while removing its optional, already normalized elapsed field.
+static YARN_STEP_TIMING_RE: LazyLock<regex::Regex> =
+    LazyLock::new(|| regex::Regex::new(r"(➤ YN0000: └ Completed) in <duration>").unwrap());
+// Vitest v5 prints the timing breakdown as percentages. Its order and omitted
+// zero-cost phases vary between runs, so redact the complete timing detail.
+static VITEST_TIMING_RE: LazyLock<regex::Regex> = LazyLock::new(|| {
+    regex::Regex::new(r"(?m)(Duration\s+<duration>) \((?:[a-z]+ \d+%(?:, )?)+\)").unwrap()
+});
 // Only v-prefixed versions are masked: tool and runtime banners all print
 // that form (`vite v7.3.2`, `vp v0.2.2`, `Node.js v24.18.0`) and churn on
 // every dep bump, while bare semver literals (`app-1.0.0.tgz`,
@@ -22,6 +39,12 @@ static DURATION_RE: LazyLock<regex::Regex> =
 static VERSION_RE: LazyLock<regex::Regex> = LazyLock::new(|| {
     regex::Regex::new(r"\bv\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?\b").unwrap()
 });
+// Vitest's delegated help prints a bare `vitest/5.0.1` banner. Match the
+// complete line so paths, dependency pins, and other fixture values stay intact.
+static VITEST_HELP_VERSION_RE: LazyLock<regex::Regex> = LazyLock::new(|| {
+    regex::Regex::new(r"(?m)^vitest/\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$")
+        .unwrap()
+});
 static TOOLCHAIN_VERSION_RE: LazyLock<regex::Regex> = LazyLock::new(|| {
     regex::Regex::new(r"\b\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?\b").unwrap()
 });
@@ -188,6 +211,10 @@ static ASSET_HASH_RE: LazyLock<regex::Regex> =
 // verbatim.
 static LOCAL_REGISTRY_URL_RE: LazyLock<regex::Regex> =
     LazyLock::new(|| regex::Regex::new(r"http://127\.0\.0\.1:\d+").unwrap());
+static VITEST_API_PORT_RE: LazyLock<regex::Regex> = LazyLock::new(|| {
+    regex::Regex::new(r"((?:API|Browser runner) started at http://(?:localhost|127\.0\.0\.1):)\d+")
+        .unwrap()
+});
 // npm names its debug log after the wall-clock start of the failing run.
 static NPM_LOG_NAME_RE: LazyLock<regex::Regex> = LazyLock::new(|| {
     regex::Regex::new(r"\d{4}-\d{2}-\d{2}T\d{2}_\d{2}_\d{2}_\d{3}Z(-debug-\d+\.log)").unwrap()
@@ -464,10 +491,13 @@ pub fn redact_output(
 
     // Redact durations like "0ns", "123ms" or "1.23s" to "<duration>".
     // Runs before version redaction so "1.23s" never half-matches as a version.
+    output = YARN_ELAPSED_RE.replace_all(&output, "${1}<duration>").into_owned();
     output = DURATION_RE.replace_all(&output, "<duration>").into_owned();
+    output = VITEST_TIMING_RE.replace_all(&output, "$1 (<timing>)").into_owned();
 
     // Redact semver-shaped versions (bundled tool versions, Node versions).
     output = VERSION_RE.replace_all(&output, "<version>").into_owned();
+    output = VITEST_HELP_VERSION_RE.replace_all(&output, "vitest/<version>").into_owned();
 
     // Toolchain output is generated from the bundled manifest, so every
     // version and compiled revision changes when that manifest is refreshed.
@@ -565,17 +595,7 @@ pub fn redact_output(
         })
         .into_owned();
 
-    // Normalize yarn's timing-dependent completion text: yarn appends
-    // "in Xs Ys" only when the step was slow enough to time, a race;
-    // DURATION_RE has already masked the numbers.
-    {
-        use cow_utils::CowUtils as _;
-        if let Cow::Owned(replaced) =
-            output.as_str().cow_replace("Completed in <duration> <duration>", "Completed")
-        {
-            output = replaced;
-        }
-    }
+    output = YARN_STEP_TIMING_RE.replace_all(&output, "${1}").into_owned();
 
     // Mask the racy completed-count in the global-install spinner row
     output = INSTALL_PROGRESS_COUNT_RE.replace_all(&output, "${1}<n>/${2}").into_owned();
@@ -596,6 +616,7 @@ pub fn redact_output(
     // Mask the local-registry proxy's ephemeral port, npm's timestamped debug
     // log name, live spinner frames, and pnpm's nondeterministic progress lines
     output = LOCAL_REGISTRY_URL_RE.replace_all(&output, "http://127.0.0.1:<port>").into_owned();
+    output = VITEST_API_PORT_RE.replace_all(&output, "${1}<port>").into_owned();
     output = NPM_LOG_NAME_RE.replace_all(&output, "<timestamp>${1}").into_owned();
     output = SPINNER_FRAME_RE.replace_all(&output, "\u{283F}").into_owned();
     output = PNPM_PROGRESS_RE.replace_all(&output, "").into_owned();
diff --git a/crates/vp_cli_snapshots/tests/redact_unit.rs b/crates/vp_cli_snapshots/tests/redact_unit.rs
index 71a80ff3ad..48b87b0221 100644
--- a/crates/vp_cli_snapshots/tests/redact_unit.rs
+++ b/crates/vp_cli_snapshots/tests/redact_unit.rs
@@ -11,6 +11,80 @@ mod redact;
 
 use redact::{redact_output, redact_version_probe_output};
 
+#[test]
+fn masks_yarn_compound_elapsed_times_as_one_duration() {
+    for elapsed in ["999ms", "1s", "1s 0ms", "1m 2s", "1h 2m 3s 4ms"] {
+        let input = format!(
+            "➤ YN0000: Done in {elapsed}\n\
+             ➤ YN0000: · Done with warnings in {elapsed}\n\
+             ➤ YN0000: · Done with errors in {elapsed}\n\
+             [app]: Process exited (exit code 0), completed in {elapsed}\n"
+        );
+        assert_eq!(
+            redact_output(input, &[], true),
+            "➤ YN0000: Done in <duration>\n\
+             ➤ YN0000: · Done with warnings in <duration>\n\
+             ➤ YN0000: · Done with errors in <duration>\n\
+             [app]: Process exited (exit code 0), completed in <duration>\n"
+        );
+    }
+    assert_eq!(
+        redact_output("timings: 1s 200ms\ntransform 1s, tests 200ms\n".to_owned(), &[], true),
+        "timings: <duration> <duration>\ntransform <duration>, tests <duration>\n"
+    );
+}
+
+#[test]
+fn omits_optional_yarn_step_timing_without_hiding_completion_text() {
+    for suffix in ["", " in 999ms", " in 1s", " in 1s 0ms", " in 1m 2s"] {
+        assert_eq!(
+            redact_output(format!("➤ YN0000: └ Completed{suffix}\n"), &[], true),
+            "➤ YN0000: └ Completed\n"
+        );
+    }
+    assert_eq!(
+        redact_output("Completed in 1s 2ms\n".to_owned(), &[], true),
+        "Completed in <duration>\n"
+    );
+}
+
+#[test]
+fn masks_only_the_vitest_help_version_banner() {
+    for version in ["4.1.11", "5.0.1", "5.1.0-rc.1+build.2"] {
+        let input = format!("vitest/{version}\n\nUsage:\n  $ vitest [...filters]\n");
+        assert_eq!(
+            redact_output(input, &[], true),
+            "vitest/<version>\n\nUsage:\n  $ vitest [...filters]\n"
+        );
+    }
+    let input = concat!(
+        "fixture: vitest/5.0.1\n",
+        "vitest/5.0.1/config.js\n",
+        "https://example.com/vitest/5.0.1\n",
+        "installed vitest@5.0.1\n",
+        "5.0.1\n",
+    );
+    assert_eq!(redact_output(input.to_owned(), &[], true), input);
+}
+
+#[test]
+fn masks_vitest_v5_timing_but_preserves_coverage_percentages() {
+    let input = " Duration  112ms (transform 57%, import 28%, worker 8%, tests 6%)\nCoverage 90%\n";
+    assert_eq!(
+        redact_output(input.to_owned(), &[], true),
+        " Duration  <duration> (<timing>)\nCoverage 90%\n"
+    );
+}
+
+#[test]
+fn masks_vitest_api_port_but_preserves_other_localhost_urls() {
+    let input = "API started at http://localhost:63316/\nBrowser runner started at http://localhost:63317/__vitest_test__/?sessionId=keep-session\nhttp://localhost:9229/\n";
+    assert_eq!(
+        redact_output(input.to_owned(), &[], true),
+        "API started at http://localhost:<port>/\nBrowser runner started at http://localhost:<port>/__vitest_test__/?sessionId=keep-session\nhttp://localhost:9229/\n"
+    );
+}
+
 #[test]
 fn masks_bare_version_block_only_for_version_probe_steps() {
     // `npm --version` / `npx --version` print a bare semver alone in the
diff --git a/crates/vp_global_cli/src/js_executor.rs b/crates/vp_global_cli/src/js_executor.rs
index 245dcbd900..6f823eb596 100644
--- a/crates/vp_global_cli/src/js_executor.rs
+++ b/crates/vp_global_cli/src/js_executor.rs
@@ -615,6 +615,42 @@ mod tests {
         assert_eq!(cmd.as_std().get_program(), OsStr::new(expected_program));
     }
 
+    #[test]
+    fn test_prepare_test_command_does_not_probe_node() {
+        use std::ffi::OsStr;
+
+        let project = tempfile::TempDir::new().unwrap();
+        let project_path = AbsolutePathBuf::new(project.path().to_path_buf()).unwrap();
+        let scripts_dir = project_path.join("dist");
+        std::fs::create_dir(scripts_dir.as_path()).unwrap();
+        std::fs::write(
+            project_path.join("package.json").as_path(),
+            r#"{"engines":{"node":">=99.0.0"}}"#,
+        )
+        .unwrap();
+
+        // A nonexistent binary makes any attempt to probe Node fail.
+        let bin_prefix = project_path.join("runtime");
+        let node_binary = bin_prefix.join(if cfg!(windows) { "node.exe" } else { "node" });
+        let entry_point = scripts_dir.join("bin.js");
+        let executor = JsExecutor::new(Some(scripts_dir)).without_missing_local_cli_warning();
+        let cmd = executor
+            .prepare_js_entry(
+                &project_path,
+                &node_binary,
+                &bin_prefix,
+                &["test".into(), "run".into()],
+            )
+            .unwrap();
+
+        assert_eq!(cmd.as_std().get_program(), node_binary.as_path().as_os_str());
+        assert_eq!(
+            cmd.as_std().get_args().collect::<Vec<_>>(),
+            [entry_point.as_path().as_os_str(), OsStr::new("test"), OsStr::new("run")]
+        );
+        assert_eq!(cmd.as_std().get_current_dir(), Some(project_path.as_path()));
+    }
+
     #[tokio::test]
     async fn test_delegate_to_local_cli_prints_node_version() {
         let vp_home = shared_vp_home();
diff --git a/crates/vp_migration/Cargo.toml b/crates/vp_migration/Cargo.toml
index 764a64b221..22ad5b7f91 100644
--- a/crates/vp_migration/Cargo.toml
+++ b/crates/vp_migration/Cargo.toml
@@ -13,6 +13,7 @@ ast-grep-core = { workspace = true }
 ast-grep-language = { workspace = true }
 brush-parser = { workspace = true }
 ignore = { workspace = true }
+oxc = { workspace = true }
 rayon = { workspace = true }
 regex = { workspace = true }
 serde_json = { workspace = true, features = ["preserve_order"] }
diff --git a/crates/vp_migration/src/file_walker.rs b/crates/vp_migration/src/file_walker.rs
index fe847ffc45..91585964f9 100644
--- a/crates/vp_migration/src/file_walker.rs
+++ b/crates/vp_migration/src/file_walker.rs
@@ -1,6 +1,6 @@
 use std::path::{Path, PathBuf};
 
-use ignore::WalkBuilder;
+use ignore::{WalkBuilder, gitignore::GitignoreBuilder};
 use vp_error::Error;
 
 /// File extensions to process for import rewriting.
@@ -17,6 +17,39 @@ pub struct WalkResult {
     pub files: Vec<PathBuf>,
 }
 
+/// Check a possibly nonexistent directory against repository-owned `.gitignore`
+/// files from `root` down to its parent. Do not use machine-local Git excludes:
+/// migration must produce ignore rules that also work for other contributors.
+pub fn is_directory_gitignored(root: &Path, directory: &Path) -> Result<bool, Error> {
+    let relative = directory
+        .strip_prefix(root)
+        .map_err(|_| Error::InvalidArgument("Ignore target must be inside the root".into()))?;
+    let mut current = root.to_path_buf();
+    let mut matchers = Vec::new();
+    for component in relative.components() {
+        let ignore_file = current.join(".gitignore");
+        if ignore_file.is_file() {
+            let mut builder = GitignoreBuilder::new(&current);
+            if let Some(error) = builder.add(&ignore_file) {
+                return Err(error.into());
+            }
+            matchers.push(builder.build()?);
+        }
+        current.push(component);
+        // Deeper ignore files take precedence. Check each directory before
+        // descending: a negation cannot re-include an ignored parent directory.
+        let matched = matchers
+            .iter()
+            .rev()
+            .map(|matcher| matcher.matched(&current, true))
+            .find(|matched| !matched.is_none());
+        if matched.is_some_and(|matched| matched.is_ignore()) {
+            return Ok(true);
+        }
+    }
+    Ok(false)
+}
+
 /// Find all TypeScript/JavaScript files in a directory, respecting gitignore
 ///
 /// This function walks the directory tree starting from `root` and finds all files
@@ -87,6 +120,47 @@ mod tests {
 
     use super::*;
 
+    #[test]
+    fn test_inherited_directory_gitignore() {
+        for (root_rules, package_rules, expected) in [
+            (".vitest/\n", "", true),
+            (".vitest\n", "", true),
+            ("**/.vitest/\n", "", true),
+            ("/.vitest/\n", "", false),
+            ("/packages/unit/.vitest/\n", "", true),
+            (".vitest-reports/\n", "", false),
+            ("# .vitest/\n", "", false),
+            ("\\!.vitest/\n", "", false),
+            (".vitest/\n!/packages/unit/.vitest/\n", "", false),
+            (".vitest/\n", "!/.vitest/\n", false),
+            ("!**/.vitest/\n", "/.vitest/\n", true),
+            ("packages/\n", "!/.vitest/\n", true),
+            ("packages/*\n!packages/unit/\n", "", false),
+        ] {
+            let temp = tempdir().unwrap();
+            let package = temp.path().join("packages/unit");
+            fs::create_dir_all(&package).unwrap();
+            fs::write(temp.path().join(".gitignore"), root_rules).unwrap();
+            fs::write(package.join(".gitignore"), package_rules).unwrap();
+            // Neither a Git repository nor the target directory needs to exist.
+            assert_eq!(
+                is_directory_gitignored(temp.path(), &package.join(".vitest")).unwrap(),
+                expected,
+                "root: {root_rules:?}, package: {package_rules:?}"
+            );
+        }
+    }
+
+    #[test]
+    fn test_directory_gitignore_boundary() {
+        let temp = tempdir().unwrap();
+        let package = temp.path().join("packages/unit");
+        fs::create_dir_all(&package).unwrap();
+        fs::write(temp.path().join(".gitignore"), ".vitest/\n").unwrap();
+        assert!(!is_directory_gitignored(&package, &package.join(".vitest")).unwrap());
+        assert!(is_directory_gitignored(&package, &temp.path().join(".vitest")).is_err());
+    }
+
     #[test]
     fn test_find_ts_files_basic() {
         let temp = tempdir().unwrap();
diff --git a/crates/vp_migration/src/import_rewriter.rs b/crates/vp_migration/src/import_rewriter.rs
index 7115bcd5b0..9094127fc1 100644
--- a/crates/vp_migration/src/import_rewriter.rs
+++ b/crates/vp_migration/src/import_rewriter.rs
@@ -1075,228 +1075,6 @@ transform:
       by: "vite-plus/test/browser/providers/preview"
 fix: $NEW_IMPORT
 ---
-id: rewrite-vitest-browser-webdriverio-import
-language: TypeScript
-rule:
-  pattern: $STR
-  kind: string
-  regex: ^['"]@vitest/browser-webdriverio['"]$
-  inside:
-    kind: import_statement
-transform:
-  NEW_IMPORT:
-    replace:
-      source: $STR
-      replace: "@vitest/browser-webdriverio"
-      by: "vite-plus/test/browser-webdriverio"
-fix: $NEW_IMPORT
----
-id: rewrite-vitest-browser-webdriverio-export
-language: TypeScript
-rule:
-  pattern: $STR
-  kind: string
-  regex: ^['"]@vitest/browser-webdriverio['"]$
-  inside:
-    kind: export_statement
-transform:
-  NEW_IMPORT:
-    replace:
-      source: $STR
-      replace: "@vitest/browser-webdriverio"
-      by: "vite-plus/test/browser-webdriverio"
-fix: $NEW_IMPORT
----
-id: rewrite-vitest-browser-webdriverio-require
-language: TypeScript
-rule:
-  pattern: $STR
-  kind: string
-  regex: ^['"]@vitest/browser-webdriverio['"]$
-  inside:
-    kind: arguments
-    inside:
-      kind: call_expression
-      has:
-        field: function
-        regex: ^require$
-transform:
-  NEW_IMPORT:
-    replace:
-      source: $STR
-      replace: "@vitest/browser-webdriverio"
-      by: "vite-plus/test/browser-webdriverio"
-fix: $NEW_IMPORT
----
-id: rewrite-vitest-browser-webdriverio-dynamic-import
-language: TypeScript
-rule:
-  pattern: $STR
-  kind: string
-  regex: ^['"]@vitest/browser-webdriverio['"]$
-  inside:
-    kind: arguments
-    inside:
-      kind: call_expression
-      has:
-        field: function
-        kind: import
-transform:
-  NEW_IMPORT:
-    replace:
-      source: $STR
-      replace: "@vitest/browser-webdriverio"
-      by: "vite-plus/test/browser-webdriverio"
-fix: $NEW_IMPORT
----
-id: rewrite-vitest-browser-webdriverio-context-import
-language: TypeScript
-rule:
-  pattern: $STR
-  kind: string
-  regex: ^['"]@vitest/browser-webdriverio/context['"]$
-  inside:
-    kind: import_statement
-transform:
-  NEW_IMPORT:
-    replace:
-      source: $STR
-      replace: "@vitest/browser-webdriverio/context"
-      by: "vite-plus/test/browser/context"
-fix: $NEW_IMPORT
----
-id: rewrite-vitest-browser-webdriverio-context-export
-language: TypeScript
-rule:
-  pattern: $STR
-  kind: string
-  regex: ^['"]@vitest/browser-webdriverio/context['"]$
-  inside:
-    kind: export_statement
-transform:
-  NEW_IMPORT:
-    replace:
-      source: $STR
-      replace: "@vitest/browser-webdriverio/context"
-      by: "vite-plus/test/browser/context"
-fix: $NEW_IMPORT
----
-id: rewrite-vitest-browser-webdriverio-context-require
-language: TypeScript
-rule:
-  pattern: $STR
-  kind: string
-  regex: ^['"]@vitest/browser-webdriverio/context['"]$
-  inside:
-    kind: arguments
-    inside:
-      kind: call_expression
-      has:
-        field: function
-        regex: ^require$
-transform:
-  NEW_IMPORT:
-    replace:
-      source: $STR
-      replace: "@vitest/browser-webdriverio/context"
-      by: "vite-plus/test/browser/context"
-fix: $NEW_IMPORT
----
-id: rewrite-vitest-browser-webdriverio-context-dynamic-import
-language: TypeScript
-rule:
-  pattern: $STR
-  kind: string
-  regex: ^['"]@vitest/browser-webdriverio/context['"]$
-  inside:
-    kind: arguments
-    inside:
-      kind: call_expression
-      has:
-        field: function
-        kind: import
-transform:
-  NEW_IMPORT:
-    replace:
-      source: $STR
-      replace: "@vitest/browser-webdriverio/context"
-      by: "vite-plus/test/browser/context"
-fix: $NEW_IMPORT
----
-id: rewrite-vitest-browser-webdriverio-provider-import
-language: TypeScript
-rule:
-  pattern: $STR
-  kind: string
-  regex: ^['"]@vitest/browser-webdriverio/provider['"]$
-  inside:
-    kind: import_statement
-transform:
-  NEW_IMPORT:
-    replace:
-      source: $STR
-      replace: "@vitest/browser-webdriverio/provider"
-      by: "vite-plus/test/browser/providers/webdriverio"
-fix: $NEW_IMPORT
----
-id: rewrite-vitest-browser-webdriverio-provider-export
-language: TypeScript
-rule:
-  pattern: $STR
-  kind: string
-  regex: ^['"]@vitest/browser-webdriverio/provider['"]$
-  inside:
-    kind: export_statement
-transform:
-  NEW_IMPORT:
-    replace:
-      source: $STR
-      replace: "@vitest/browser-webdriverio/provider"
-      by: "vite-plus/test/browser/providers/webdriverio"
-fix: $NEW_IMPORT
----
-id: rewrite-vitest-browser-webdriverio-provider-require
-language: TypeScript
-rule:
-  pattern: $STR
-  kind: string
-  regex: ^['"]@vitest/browser-webdriverio/provider['"]$
-  inside:
-    kind: arguments
-    inside:
-      kind: call_expression
-      has:
-        field: function
-        regex: ^require$
-transform:
-  NEW_IMPORT:
-    replace:
-      source: $STR
-      replace: "@vitest/browser-webdriverio/provider"
-      by: "vite-plus/test/browser/providers/webdriverio"
-fix: $NEW_IMPORT
----
-id: rewrite-vitest-browser-webdriverio-provider-dynamic-import
-language: TypeScript
-rule:
-  pattern: $STR
-  kind: string
-  regex: ^['"]@vitest/browser-webdriverio/provider['"]$
-  inside:
-    kind: arguments
-    inside:
-      kind: call_expression
-      has:
-        field: function
-        kind: import
-transform:
-  NEW_IMPORT:
-    replace:
-      source: $STR
-      replace: "@vitest/browser-webdriverio/provider"
-      by: "vite-plus/test/browser/providers/webdriverio"
-fix: $NEW_IMPORT
----
 id: rewrite-vitest-subpath-import
 language: TypeScript
 rule:
@@ -1764,9 +1542,74 @@ static PARSED_VITE_RULES: LazyLock<Vec<RuleConfig<SupportLang>>> = LazyLock::new
 });
 
 static PARSED_VITEST_RULES: LazyLock<Vec<RuleConfig<SupportLang>>> = LazyLock::new(|| {
-    ast_grep::load_rules(REWRITE_VITEST_RULES).expect("failed to parse vitest rewrite rules")
+    ast_grep::load_rules(&vitest_rewrite_rules()).expect("failed to parse vitest rewrite rules")
+});
+
+static VITEST_V5_ENTRY_POINTS: LazyLock<HashMap<String, String>> = LazyLock::new(|| {
+    serde_json::from_str(include_str!("../../../packages/cli/src/vitest-v5-entry-points.json"))
+        .expect("invalid Vitest entry-point map")
 });
 
+static VITE_PLUS_TEST_SUBPATHS: LazyLock<Vec<String>> = LazyLock::new(|| {
+    let pkg: serde_json::Value =
+        serde_json::from_str(include_str!("../../../packages/cli/package.json"))
+            .expect("invalid vite-plus manifest");
+    pkg["exports"]
+        .as_object()
+        .expect("missing vite-plus exports")
+        .keys()
+        .filter_map(|key| key.strip_prefix("./test/").map(str::to_owned))
+        .collect()
+});
+
+fn vitest_rewrite_rules() -> String {
+    let allowed = VITE_PLUS_TEST_SUBPATHS
+        .iter()
+        .map(|name| regex::escape(name))
+        .collect::<Vec<_>>()
+        .join("|");
+    let generic = REWRITE_VITEST_RULES.replace(
+        r#"regex: ^['"]vitest/.+['"]$"#,
+        &format!(r#"regex: ^['"]vitest/({allowed})['"]$"#),
+    );
+    // Exact public replacements run before the generic subpath rules. Each
+    // generated rule retains the same AST context and Nuxt skip classification.
+    let template = REWRITE_VITEST_RULES
+        .split("---\nid: rewrite-vitest-subpath-import")
+        .nth(1)
+        .expect("missing subpath rule template");
+    let template = format!("---\nid: rewrite-vitest-subpath-import{template}");
+    let mut rules = String::new();
+    let mut entries = VITEST_V5_ENTRY_POINTS.iter().collect::<Vec<_>>();
+    entries.sort_by_key(|(source, _)| *source);
+    for (source, target) in entries {
+        rules.push_str(
+            &template
+                .replace(
+                    "rewrite-vitest-subpath-",
+                    &format!(
+                        "{}{}-",
+                        if source.starts_with("vitest/") {
+                            "rewrite-vitest-subpath-"
+                        } else {
+                            "rewrite-legacy-test-entry-"
+                        },
+                        source.replace('/', "-")
+                    ),
+                )
+                .replace(
+                    r#"regex: ^['"]vitest/.+['"]$"#,
+                    &format!(r#"regex: ^['"]{}['"]$"#, regex::escape(source)),
+                )
+                .replace("replace: vitest/", &format!("replace: \"{source}\""))
+                .replace("by: \"vite-plus/test/\"", &format!("by: \"{target}\"")),
+        );
+        rules.push('\n');
+    }
+    rules.push_str(&generic);
+    rules
+}
+
 const BARE_VITEST_RULE_IDS: [&str; 4] = [
     "rewrite-vitest-import",
     "rewrite-vitest-export",
@@ -1785,7 +1628,7 @@ fn is_unscoped_vitest_rule(rule: &RuleConfig<SupportLang>) -> bool {
 }
 
 static PARSED_UNSCOPED_VITEST_RULES: LazyLock<Vec<RuleConfig<SupportLang>>> = LazyLock::new(|| {
-    ast_grep::load_rules(REWRITE_VITEST_RULES)
+    ast_grep::load_rules(&vitest_rewrite_rules())
         .expect("failed to parse vitest rewrite rules")
         .into_iter()
         .filter(is_unscoped_vitest_rule)
@@ -1794,7 +1637,7 @@ static PARSED_UNSCOPED_VITEST_RULES: LazyLock<Vec<RuleConfig<SupportLang>>> = La
 
 static PARSED_VITEST_RULES_WITHOUT_UNSCOPED: LazyLock<Vec<RuleConfig<SupportLang>>> =
     LazyLock::new(|| {
-        ast_grep::load_rules(REWRITE_VITEST_RULES)
+        ast_grep::load_rules(&vitest_rewrite_rules())
             .expect("failed to parse vitest rewrite rules")
             .into_iter()
             .filter(|rule| !is_unscoped_vitest_rule(rule))
@@ -1828,6 +1671,11 @@ static RE_REF_VITEST_SUBPATH: LazyLock<Regex> = LazyLock::new(|| {
     Regex::new(r#"^(\s*///\s*<reference\s+types\s*=\s*["'])vitest/(.+?)(["']\s*/>)"#).unwrap()
 });
 
+// Exact legacy entry points also include removed Vite+ provider exports.
+static RE_REF_TEST_ENTRY: LazyLock<Regex> = LazyLock::new(|| {
+    Regex::new(r#"^(\s*///\s*<reference\s+types\s*=\s*["'])([^"']+)(["']\s*/>)"#).unwrap()
+});
+
 /// `@vitest/browser[/{subpath}]` references that map onto the *nested*
 /// `vite-plus/test/browser[/{subpath}]` surface (a plain `@vitest/` → `vite-plus/test/`
 /// swap is correct here):
@@ -1855,7 +1703,7 @@ static RE_REF_VITEST_SCOPED_BROWSER_FLAT: LazyLock<Regex> = LazyLock::new(|| {
 /// `vite-plus/test/browser-{provider}` — a plain `@vitest/` → `vite-plus/test/` swap.
 static RE_REF_VITEST_SCOPED_PROVIDER: LazyLock<Regex> = LazyLock::new(|| {
     Regex::new(
-        r#"^(\s*///\s*<reference\s+types\s*=\s*["'])@vitest/(browser-playwright|browser-preview|browser-webdriverio)(["']\s*/>)"#,
+        r#"^(\s*///\s*<reference\s+types\s*=\s*["'])@vitest/(browser-playwright|browser-preview)(["']\s*/>)"#,
     )
     .unwrap()
 });
@@ -1865,7 +1713,7 @@ static RE_REF_VITEST_SCOPED_PROVIDER: LazyLock<Regex> = LazyLock::new(|| {
 /// provider segment is dropped: → `vite-plus/test/browser/context`.
 static RE_REF_VITEST_SCOPED_PROVIDER_CONTEXT: LazyLock<Regex> = LazyLock::new(|| {
     Regex::new(
-        r#"^(\s*///\s*<reference\s+types\s*=\s*["'])@vitest/browser-(playwright|preview|webdriverio)/context(["']\s*/>)"#,
+        r#"^(\s*///\s*<reference\s+types\s*=\s*["'])@vitest/browser-(playwright|preview)/context(["']\s*/>)"#,
     )
     .unwrap()
 });
@@ -1875,7 +1723,7 @@ static RE_REF_VITEST_SCOPED_PROVIDER_CONTEXT: LazyLock<Regex> = LazyLock::new(||
 /// rewritten accordingly: → `vite-plus/test/browser/providers/{provider}`.
 static RE_REF_VITEST_SCOPED_PROVIDER_ENTRY: LazyLock<Regex> = LazyLock::new(|| {
     Regex::new(
-        r#"^(\s*///\s*<reference\s+types\s*=\s*["'])@vitest/browser-(playwright|preview|webdriverio)/provider(["']\s*/>)"#,
+        r#"^(\s*///\s*<reference\s+types\s*=\s*["'])@vitest/browser-(playwright|preview)/provider(["']\s*/>)"#,
     )
     .unwrap()
 });
@@ -2050,6 +1898,19 @@ fn rewrite_reference_types(
                 *preserved_vitest = true;
                 continue;
             }
+            if let Some(captures) = RE_REF_TEST_ENTRY.captures(line)
+                && let Some(target) = VITEST_V5_ENTRY_POINTS.get(&captures[2])
+            {
+                *line = format!(
+                    "{}{}{}{}",
+                    &captures[1],
+                    target,
+                    &captures[3],
+                    &line[captures[0].len()..]
+                );
+                changed = true;
+                continue;
+            }
             if apply_regex_replace(line, &RE_REF_VITEST_CONFIG, "${1}vite-plus${2}") {
                 changed = true;
                 continue;
@@ -2098,8 +1959,25 @@ fn rewrite_reference_types(
                 changed = true;
                 continue;
             }
-            if apply_regex_replace(line, &RE_REF_VITEST_SUBPATH, "${1}vite-plus/test/${2}${3}") {
-                changed = true;
+            if let Some(captures) = RE_REF_VITEST_SUBPATH.captures(line) {
+                let subpath = &captures[2];
+                let original = format!("vitest/{subpath}");
+                let target = VITEST_V5_ENTRY_POINTS.get(&original).cloned().or_else(|| {
+                    VITE_PLUS_TEST_SUBPATHS
+                        .iter()
+                        .any(|name| name == subpath)
+                        .then(|| format!("vite-plus/test/{subpath}"))
+                });
+                if let Some(target) = target {
+                    *line = format!(
+                        "{}{}{}{}",
+                        &captures[1],
+                        target,
+                        &captures[3],
+                        &line[captures[0].len()..]
+                    );
+                    changed = true;
+                }
                 continue;
             }
             if apply_regex_replace(line, &RE_REF_VITEST, "${1}vite-plus/test${2}") {
@@ -3050,6 +2928,29 @@ export default preview;"#
         );
     }
 
+    #[test]
+    fn test_restore_legacy_webdriverio_entries() {
+        for (source, target) in
+            VITEST_V5_ENTRY_POINTS.iter().filter(|(source, _)| source.contains("webdriverio"))
+        {
+            for template in [
+                "import { webdriverio } from 'ENTRY';",
+                "export { webdriverio } from 'ENTRY';",
+                "export * from 'ENTRY';",
+                "const provider = require('ENTRY');",
+                "const provider = await import('ENTRY');",
+                "/// <reference types='ENTRY' />",
+            ] {
+                let content = template.replace("ENTRY", source);
+                let result = rewrite_import_content(&content, &SkipPackages::default()).unwrap();
+                assert_eq!(result.content, template.replace("ENTRY", target), "{source}");
+                let repeated =
+                    rewrite_import_content(&result.content, &SkipPackages::default()).unwrap();
+                assert!(!repeated.updated, "{target}");
+            }
+        }
+    }
+
     #[test]
     fn test_rewrite_import_content_vitest_browser_webdriverio() {
         let vite_config = r#"import { webdriverio } from '@vitest/browser-webdriverio';
@@ -3057,13 +2958,8 @@ export default preview;"#
 export default webdriverio;"#;
 
         let result = rewrite_import_content(vite_config, &SkipPackages::default()).unwrap();
-        assert!(result.updated);
-        assert_eq!(
-            result.content,
-            r#"import { webdriverio } from 'vite-plus/test/browser-webdriverio';
-
-export default webdriverio;"#
-        );
+        assert!(!result.updated);
+        assert_eq!(result.content, vite_config);
     }
 
     #[test]
@@ -3073,13 +2969,8 @@ export default webdriverio;"#
 export default something;"#;
 
         let result = rewrite_import_content(vite_config, &SkipPackages::default()).unwrap();
-        assert!(result.updated);
-        assert_eq!(
-            result.content,
-            r#"import { something } from "vite-plus/test/browser/context";
-
-export default something;"#
-        );
+        assert!(!result.updated);
+        assert_eq!(result.content, vite_config);
     }
 
     #[test]
@@ -3089,13 +2980,8 @@ export default something;"#
 export default webdriverio;"#;
 
         let result = rewrite_import_content(vite_config, &SkipPackages::default()).unwrap();
-        assert!(result.updated);
-        assert_eq!(
-            result.content,
-            r#"import { webdriverio } from 'vite-plus/test/browser/providers/webdriverio';
-
-export default webdriverio;"#
-        );
+        assert!(!result.updated);
+        assert_eq!(result.content, vite_config);
     }
 
     #[test]
@@ -3180,19 +3066,14 @@ export default startVitest;"#;
 export default startVitest;"#
         );
 
-        // Test vitest/plugins/runner subpath
+        // Removed and unknown subpaths must not produce unpublished Vite+ paths.
         let vite_config = r#"import { somePlugin } from 'vitest/plugins/runner';
 
 export default somePlugin;"#;
 
         let result = rewrite_import_content(vite_config, &SkipPackages::default()).unwrap();
-        assert!(result.updated);
-        assert_eq!(
-            result.content,
-            r#"import { somePlugin } from 'vite-plus/test/plugins/runner';
-
-export default somePlugin;"#
-        );
+        assert!(!result.updated);
+        assert_eq!(result.content, vite_config);
     }
 
     #[test]
@@ -5296,27 +5177,24 @@ export default defineConfig({});"#
     fn test_rewrite_require_vitest_browser_webdriverio() {
         let content = r#"const x = require('@vitest/browser-webdriverio');"#;
         let result = rewrite_import_content(content, &SkipPackages::default()).unwrap();
-        assert!(result.updated);
-        assert_eq!(result.content, r#"const x = require('vite-plus/test/browser-webdriverio');"#);
+        assert!(!result.updated);
+        assert_eq!(result.content, content);
     }
 
     #[test]
     fn test_rewrite_require_vitest_browser_webdriverio_context() {
         let content = r#"const x = require('@vitest/browser-webdriverio/context');"#;
         let result = rewrite_import_content(content, &SkipPackages::default()).unwrap();
-        assert!(result.updated);
-        assert_eq!(result.content, r#"const x = require('vite-plus/test/browser/context');"#);
+        assert!(!result.updated);
+        assert_eq!(result.content, content);
     }
 
     #[test]
     fn test_rewrite_require_vitest_browser_webdriverio_provider() {
         let content = r#"const x = require('@vitest/browser-webdriverio/provider');"#;
         let result = rewrite_import_content(content, &SkipPackages::default()).unwrap();
-        assert!(result.updated);
-        assert_eq!(
-            result.content,
-            r#"const x = require('vite-plus/test/browser/providers/webdriverio');"#
-        );
+        assert!(!result.updated);
+        assert_eq!(result.content, content);
     }
 
     #[test]
@@ -5529,17 +5407,14 @@ const { defineConfig } = require('vite-plus');"#
         let content = r#"/// <reference types="@vitest/browser/providers/webdriverio" />"#;
         let result = rewrite_import_content(content, &SkipPackages::default()).unwrap();
         assert!(result.updated);
-        assert_eq!(
-            result.content,
-            r#"/// <reference types="vite-plus/test/browser/providers/webdriverio" />"#
-        );
+        assert_eq!(result.content, r#"/// <reference types="@vitest/browser-webdriverio" />"#);
     }
 
     #[test]
     fn test_rewrite_reference_types_vitest_scoped_provider_context() {
         // `@vitest/browser-{provider}/context` references map onto the shared
         // `vite-plus/test/browser/context` export (the provider segment is dropped).
-        for provider in ["playwright", "preview", "webdriverio"] {
+        for provider in ["playwright", "preview"] {
             let content =
                 format!(r#"/// <reference types="@vitest/browser-{provider}/context" />"#);
             let result = rewrite_import_content(&content, &SkipPackages::default()).unwrap();
@@ -5555,7 +5430,7 @@ const { defineConfig } = require('vite-plus');"#
     fn test_rewrite_reference_types_vitest_scoped_provider_entry() {
         // `@vitest/browser-{provider}/provider` references map to the provider
         // entry point under `vite-plus/test/browser/providers/{provider}`.
-        for provider in ["playwright", "preview", "webdriverio"] {
+        for provider in ["playwright", "preview"] {
             let content =
                 format!(r#"/// <reference types="@vitest/browser-{provider}/provider" />"#);
             let result = rewrite_import_content(&content, &SkipPackages::default()).unwrap();
@@ -6029,11 +5904,8 @@ export default defineConfig({});"#
         // `vite-plus/test/browser/providers/{provider}` entry point.
         let content = r#"export * from '@vitest/browser-webdriverio/provider';"#;
         let result = rewrite_import_content(content, &SkipPackages::default()).unwrap();
-        assert!(result.updated);
-        assert_eq!(
-            result.content,
-            r#"export * from 'vite-plus/test/browser/providers/webdriverio';"#
-        );
+        assert!(!result.updated);
+        assert_eq!(result.content, content);
     }
 
     #[test]
@@ -6181,11 +6053,8 @@ export default defineConfig({});"#
     fn test_rewrite_dynamic_import_vitest_browser_webdriverio_provider() {
         let content = r#"const p = await import('@vitest/browser-webdriverio/provider');"#;
         let result = rewrite_import_content(content, &SkipPackages::default()).unwrap();
-        assert!(result.updated);
-        assert_eq!(
-            result.content,
-            r#"const p = await import('vite-plus/test/browser/providers/webdriverio');"#
-        );
+        assert!(!result.updated);
+        assert_eq!(result.content, content);
     }
 
     #[test]
@@ -6342,21 +6211,17 @@ console.log(pkg.version);"#;
     }
 
     #[test]
-    fn test_rewrite_import_content_vitest_package_json_like_suffix_still_rewritten() {
-        // Sanity check: only the exact `vitest/package.json` subpath is
-        // skipped. A subpath that merely starts with `package.json` (e.g.,
-        // `package.json.js`) MUST still be rewritten by the catch-all rule.
+    fn test_rewrite_import_content_vitest_unknown_package_json_suffix_is_preserved() {
         let content = r#"import 'vitest/package.json.js';"#;
         let result = rewrite_import_content(content, &SkipPackages::default()).unwrap();
-        assert!(result.updated);
-        assert_eq!(result.content, r#"import 'vite-plus/test/package.json.js';"#);
+        assert!(!result.updated);
+        assert_eq!(result.content, content);
     }
 
     // The `rewrite-vitest-subpath-*` rules now explicitly exclude `vitest/config`
     // via `not: regex: ^['"]vitest/(package\.json|config)['"]$` to make the intent
     // robust against rule-reordering or ast-grep conflict-resolution changes.
-    // These tests verify the exclusion holds for all 4 import shapes and that
-    // a similar-but-distinct path like `vitest/config-extra` is NOT excluded.
+    // Unknown paths such as `vitest/config-extra` must remain untouched too.
 
     #[test]
     fn test_rewrite_import_content_vitest_config_export_not_subpath_rewritten() {
@@ -6391,13 +6256,10 @@ console.log(pkg.version);"#;
 
     #[test]
     fn test_rewrite_import_content_vitest_config_extra_subpath_static_import() {
-        // `vitest/config-extra` is NOT `vitest/config` — the subpath exclusion
-        // must not be too broad. It should still be rewritten by the catch-all
-        // subpath rule to `vite-plus/test/config-extra`.
         let content = r#"import { something } from 'vitest/config-extra';"#;
         let result = rewrite_import_content(content, &SkipPackages::default()).unwrap();
-        assert!(result.updated);
-        assert_eq!(result.content, r#"import { something } from 'vite-plus/test/config-extra';"#);
+        assert!(!result.updated);
+        assert_eq!(result.content, content);
     }
 
     #[test]
@@ -6405,8 +6267,8 @@ console.log(pkg.version);"#;
         // Same sanity check for export_statement shape.
         let content = r#"export { something } from 'vitest/config-extra';"#;
         let result = rewrite_import_content(content, &SkipPackages::default()).unwrap();
-        assert!(result.updated);
-        assert_eq!(result.content, r#"export { something } from 'vite-plus/test/config-extra';"#);
+        assert!(!result.updated);
+        assert_eq!(result.content, content);
     }
 
     #[test]
@@ -6414,8 +6276,8 @@ console.log(pkg.version);"#;
         // Same sanity check for require() shape.
         let content = r#"const m = require('vitest/config-extra');"#;
         let result = rewrite_import_content(content, &SkipPackages::default()).unwrap();
-        assert!(result.updated);
-        assert_eq!(result.content, r#"const m = require('vite-plus/test/config-extra');"#);
+        assert!(!result.updated);
+        assert_eq!(result.content, content);
     }
 
     #[test]
@@ -6423,7 +6285,47 @@ console.log(pkg.version);"#;
         // Same sanity check for dynamic import() shape.
         let content = r#"const m = await import('vitest/config-extra');"#;
         let result = rewrite_import_content(content, &SkipPackages::default()).unwrap();
-        assert!(result.updated);
-        assert_eq!(result.content, r#"const m = await import('vite-plus/test/config-extra');"#);
+        assert!(!result.updated);
+        assert_eq!(result.content, content);
+    }
+
+    #[test]
+    fn test_vitest_v5_canonical_entry_points() {
+        for (source, target) in VITEST_V5_ENTRY_POINTS.iter() {
+            for template in [
+                "import { value } from 'SOURCE';",
+                "import * as values from 'SOURCE';",
+                "export { value } from 'SOURCE';",
+                "export * from 'SOURCE';",
+                "const value = require('SOURCE');",
+                "const value = import('SOURCE');",
+                "type Value = typeof import('SOURCE');",
+                "/// <reference types=\"SOURCE\" /> // retain comment",
+            ] {
+                let content = template.replace("SOURCE", source);
+                let result = rewrite_import_content(&content, &SkipPackages::default()).unwrap();
+                assert_eq!(result.content, template.replace("SOURCE", target), "{content}");
+                let repeated =
+                    rewrite_import_content(&result.content, &SkipPackages::default()).unwrap();
+                assert!(!repeated.updated, "{content}");
+                assert_eq!(repeated.content, result.content, "{content}");
+            }
+        }
+    }
+
+    #[test]
+    fn test_vitest_v5_removed_entry_points_are_preserved() {
+        for source in [
+            "vitest/runners",
+            "vitest/suite",
+            "vitest/internal/module-runner",
+            "vitest/plugins/expect",
+            "vitest/unknown",
+        ] {
+            let content = format!("import {{ value }} from '{source}';");
+            let result = rewrite_import_content(&content, &SkipPackages::default()).unwrap();
+            assert!(!result.updated, "{source}");
+            assert_eq!(result.content, content);
+        }
     }
 }
diff --git a/crates/vp_migration/src/lib.rs b/crates/vp_migration/src/lib.rs
index f77a04b9d5..69813c5175 100644
--- a/crates/vp_migration/src/lib.rs
+++ b/crates/vp_migration/src/lib.rs
@@ -14,14 +14,16 @@ mod pack_config;
 mod package;
 mod prettier;
 mod script_rewrite;
+mod source_analysis;
 mod vite_config;
 
-pub use file_walker::{WalkResult, find_ts_files};
+pub use file_walker::{WalkResult, find_ts_files, is_directory_gitignored};
 pub use import_rewriter::{
     BatchRewriteResult, RewriteImportsOptions, rewrite_imports_in_directory,
     rewrite_imports_in_directory_with_options,
 };
 pub use package::{rewrite_eslint, rewrite_prettier, rewrite_scripts};
+pub use source_analysis::analyze_migration_source;
 pub use vite_config::{
     MergeResult, has_config_key, merge_json_config, merge_tsdown_config, remove_config_key,
     upsert_json_config, wrap_lazy_plugins,
diff --git a/crates/vp_migration/src/source_analysis.rs b/crates/vp_migration/src/source_analysis.rs
new file mode 100644
index 0000000000..2ce9759179
--- /dev/null
+++ b/crates/vp_migration/src/source_analysis.rs
@@ -0,0 +1,164 @@
+use std::collections::HashMap;
+
+use oxc::{
+    allocator::Allocator,
+    ast::AstKind,
+    ast_visit::utf8_to_utf16::Utf8ToUtf16,
+    parser::{ParseOptions, Parser},
+    semantic::SemanticBuilder,
+    span::{GetSpan, SourceType},
+};
+use serde_json::{Value, json};
+
+/// Parse migration input and resolve bindings with the Oxc already shipped by Rolldown.
+/// Keep transformation rules in TypeScript; export only the semantic facts they need,
+/// rather than duplicating JavaScript scope analysis or bundling another parser.
+pub fn analyze_migration_source(filename: &str, source: &str) -> Result<String, String> {
+    let allocator = Allocator::default();
+    let source_type =
+        SourceType::from_path(filename).map_err(|error| error.to_string())?.with_unambiguous(true);
+    // JavaScript migration input can contain JSX. For TypeScript, retain the
+    // extension's TS/TSX mode so `<T>(value: T) => value` is not parsed as JSX.
+    let source_type = source_type.with_jsx(source_type.is_javascript() || source_type.is_jsx());
+    let parsed = Parser::new(&allocator, source, source_type)
+        .with_options(ParseOptions { preserve_parens: false, ..ParseOptions::default() })
+        .parse();
+    if let Some(error) = parsed.diagnostics.first() {
+        return Err(error.to_string());
+    }
+    let mut program = parsed.program;
+    let analyzed = SemanticBuilder::new_compiler().with_build_nodes(true).build(&program);
+    if let Some(error) = analyzed.diagnostics.first() {
+        return Err(error.to_string());
+    }
+
+    // JavaScript slices and diagnostic columns use UTF-16, whereas Rust spans use
+    // UTF-8 bytes. Convert both semantic offsets and AST/comment spans together.
+    let spans = Utf8ToUtf16::new(source);
+    let mut converter = spans.converter();
+    let mut offset = |mut value| {
+        if let Some(converter) = converter.as_mut() {
+            converter.convert_offset(&mut value);
+        }
+        value
+    };
+    let semantic = analyzed.semantic;
+    let scoping = semantic.scoping();
+    // Oxc keeps type and value references separate. An invalid runtime use of
+    // a type-only import is unresolved, but must not be mistaken for a Vitest
+    // global by migration rules. Preserve its lexical import binding too.
+    let mut type_import_uses = HashMap::<_, Vec<u32>>::new();
+    for node in semantic.nodes().iter() {
+        if let AstKind::IdentifierReference(identifier) = node.kind()
+            && !scoping.has_binding(identifier.reference_id.get().unwrap())
+            && let Some(symbol) = scoping.find_binding(node.scope_id(), identifier.name)
+            && scoping.symbol_flags(symbol).is_type_import()
+        {
+            type_import_uses.entry(symbol).or_default().push(offset(identifier.span.start));
+        }
+    }
+    let bindings: Vec<Value> = scoping
+        .symbol_ids()
+        .map(|symbol| {
+            let mut references: Vec<u32> = scoping
+                .get_resolved_references(symbol)
+                .map(|reference| offset(semantic.nodes().kind(reference.node_id()).span().start))
+                .collect();
+            references.extend(type_import_uses.remove(&symbol).unwrap_or_default());
+            // Do not follow reassigned or redeclared aliases, including invalid
+            // writes to const bindings. `symbol_is_mutated` alone ignores those.
+            let constant = scoping.symbol_redeclarations(symbol).is_empty()
+                && !scoping.get_resolved_references(symbol).any(|reference| reference.is_write());
+            json!({
+                "start": offset(scoping.symbol_span(symbol).start),
+                "references": references,
+                "constant": constant,
+            })
+        })
+        .collect();
+    drop(semantic);
+    spans.convert_program_and_comments(&mut program);
+    let comments: Vec<Value> = program
+        .comments
+        .iter()
+        .map(|comment| json!({ "start": comment.span.start, "end": comment.span.end }))
+        .collect();
+
+    // Reuse the serializer already instantiated by oxc_parser_napi. Pass its
+    // JSON directly to JavaScript: serde_json::Value rejects valid JS strings
+    // with unpaired surrogates and imposes a recursion limit on deep ASTs.
+    // Only serialize our shallow metadata with serde_json, not the AST.
+    let ast = program.to_estree_json_with_fixes(true, false);
+    let bindings = serde_json::to_string(&bindings).map_err(|error| error.to_string())?;
+    let comments = serde_json::to_string(&comments).map_err(|error| error.to_string())?;
+    Ok(format!(r#"{{"ast":{ast},"bindings":{bindings},"comments":{comments}}}"#))
+}
+
+#[cfg(test)]
+mod tests {
+    use serde_json::Value;
+
+    use super::analyze_migration_source;
+
+    #[test]
+    fn rejects_flow_and_invalid_syntax() {
+        for source in ["// @flow\nconst x: string = 'x';", "const = ;"] {
+            assert!(analyze_migration_source("test.js", source).is_err());
+        }
+    }
+
+    #[test]
+    fn preserves_unpaired_surrogates_in_strings_and_templates() {
+        for source in [
+            r#"const value = '\ud800';"#,
+            r#"const value = '\udc00';"#,
+            r#"const value = `\ud800`;"#,
+        ] {
+            assert!(analyze_migration_source("test.ts", source).is_ok());
+        }
+    }
+
+    #[test]
+    fn preserves_asts_deeper_than_the_serde_recursion_limit() {
+        let expression = vec!["1"; 160].join(" + ");
+        let source = format!("const value = {expression};");
+        assert!(analyze_migration_source("test.ts", &source).is_ok());
+    }
+
+    #[test]
+    fn preserves_type_imports_for_unresolved_value_uses() {
+        for source in [
+            "import type { expect } from 'vitest'; expect();",
+            "import { type expect } from 'vitest'; expect();",
+            "import type * as expect from 'vitest'; expect();",
+        ] {
+            let result: Value =
+                serde_json::from_str(&analyze_migration_source("test.ts", source).unwrap())
+                    .unwrap();
+            assert_eq!(
+                result["bindings"][0]["references"],
+                serde_json::json!([source.rfind("expect").unwrap()])
+            );
+        }
+    }
+
+    #[test]
+    fn resolves_shadowing_and_mutated_aliases_with_utf16_offsets() {
+        let source = "// 😀\nimport { vi } from 'vitest'; vi.fn(); function f(vi) { vi.fn(); } let alias = vi; alias = other; alias.fn();";
+        let result: Value =
+            serde_json::from_str(&analyze_migration_source("test.ts", source).unwrap()).unwrap();
+        let bindings = result["bindings"].as_array().unwrap();
+        let utf16 = |text: &str| source[..source.find(text).unwrap()].encode_utf16().count();
+        let imported = bindings.iter().find(|binding| binding["start"] == utf16("vi }")).unwrap();
+        assert_eq!(
+            imported["references"],
+            serde_json::json!([utf16("vi.fn()"), utf16("vi; alias")])
+        );
+        assert_eq!(imported["constant"], true);
+        let alias =
+            bindings.iter().find(|binding| binding["start"] == utf16("alias = vi")).unwrap();
+        assert_eq!(alias["constant"], false);
+        assert_eq!(result["ast"]["node"]["body"][0]["start"], utf16("import"));
+        assert_eq!(result["comments"][0]["end"], "// 😀".encode_utf16().count());
+    }
+}
diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
index 9ae1d27eff..afa1fd83bf 100644
--- a/docs/.vitepress/config.mts
+++ b/docs/.vitepress/config.mts
@@ -7,13 +7,15 @@ import { groupIconMdPlugin, groupIconVitePlugin } from 'vitepress-plugin-group-i
 import llmstxt from 'vitepress-plugin-llms';
 import { withMermaid } from 'vitepress-plugin-mermaid';
 
+import { resolveDocsSiteOrigin } from './site-origin.ts';
+
 // Non-production deploys (the main preview, PR staging) serve their own
 // copies of the install scripts and llms dumps, so the https://vite.plus
 // installer shortcuts and absolute site URLs must point at the deploy's
 // origin instead of production. The deploy workflows set DOCS_SITE_ORIGIN via
 // the deploy-docs composite action; markdown content is rewritten through
 // markdown-it below, and Vue components read the __DOCS_*__ define constants.
-const siteOrigin = process.env.DOCS_SITE_ORIGIN;
+const siteOrigin = resolveDocsSiteOrigin();
 const docsOrigin = siteOrigin || 'https://viteplus.dev';
 const installShUrl = siteOrigin ? `${siteOrigin}/install.sh` : 'https://vite.plus';
 const installPs1Url = siteOrigin ? `${siteOrigin}/install.ps1` : 'https://vite.plus/ps1';
@@ -44,7 +46,10 @@ const guideSidebar = [
       {
         text: 'Migrate to Vite+',
         link: '/guide/migrate',
-        items: [{ text: 'Migration Rules', link: '/guide/migrate-rules' }],
+        items: [
+          { text: 'Migration Rules', link: '/guide/migrate-rules' },
+          { text: 'Upgrade to Vitest 5', link: '/guide/vitest-v5' },
+        ],
       },
       { text: 'Update Vite+', link: '/guide/upgrade-project' },
       { text: 'Package Management', link: '/guide/install' },
diff --git a/docs/.vitepress/scripts/copy-installers.mjs b/docs/.vitepress/scripts/copy-installers.mjs
index aa390e5a5f..ffffefcd5a 100644
--- a/docs/.vitepress/scripts/copy-installers.mjs
+++ b/docs/.vitepress/scripts/copy-installers.mjs
@@ -1,7 +1,9 @@
 import { readFile, writeFile } from 'node:fs/promises';
 
+import { resolveDocsSiteOrigin } from '../site-origin.ts';
+
 // Piped installers must fetch legacy from the same production or preview deploy.
-const origin = (process.env.DOCS_SITE_ORIGIN || 'https://viteplus.dev').replace(/\/$/, '');
+const origin = resolveDocsSiteOrigin() || 'https://viteplus.dev';
 for (const name of ['install.sh', 'install.ps1', 'install-legacy.sh', 'install-legacy.ps1']) {
   const source = new URL(`../../../packages/cli/${name}`, import.meta.url);
   const destination = new URL(`../../public/${name}`, import.meta.url);
diff --git a/docs/.vitepress/site-origin.ts b/docs/.vitepress/site-origin.ts
new file mode 100644
index 0000000000..a0ea83de22
--- /dev/null
+++ b/docs/.vitepress/site-origin.ts
@@ -0,0 +1,34 @@
+import { createHash } from 'node:crypto';
+
+// Keep this host aligned with docs/wrangler.jsonc and the Workers subdomain.
+const workersHost = 'viteplus-dev.voidzero-docs.workers.dev';
+
+export function resolveDocsSiteOrigin(env: NodeJS.ProcessEnv = process.env): string | undefined {
+  if (env.DOCS_SITE_ORIGIN) {
+    return env.DOCS_SITE_ORIGIN.replace(/\/+$/, '');
+  }
+
+  const branch = env.WORKERS_CI_BRANCH;
+  // GitHub deploys supply DOCS_SITE_ORIGIN. Workers Builds needs its own
+  // branch origin; main and local builds retain the production fallback.
+  if (env.WORKERS_CI !== '1' || !branch || branch === 'main') {
+    return undefined;
+  }
+
+  // Match Wrangler's generatePreviewAlias, including its long-branch hash:
+  // https://developers.cloudflare.com/workers/versions-and-deployments/preview-urls/
+  let alias = branch
+    .replace(/[^a-zA-Z0-9-]/g, '-')
+    .replace(/-+/g, '-')
+    .replace(/^-+|-+$/g, '')
+    .toLowerCase();
+  if (!/^[a-z](?:[a-z0-9-]*[a-z0-9])?$/.test(alias)) {
+    throw new Error('Set DOCS_SITE_ORIGIN: this branch has no valid Workers preview alias.');
+  }
+  const maxAliasLength = 63 - workersHost.split('.')[0].length - 1;
+  if (alias.length > maxAliasLength) {
+    const hash = createHash('sha256').update(branch).digest('hex').slice(0, 4);
+    alias = `${alias.slice(0, maxAliasLength - hash.length - 1)}-${hash}`;
+  }
+  return `https://${alias}-${workersHost}`;
+}
diff --git a/docs/guide/local-cli.md b/docs/guide/local-cli.md
index 6a7042523b..ee99393626 100644
--- a/docs/guide/local-cli.md
+++ b/docs/guide/local-cli.md
@@ -52,20 +52,20 @@ You need to add overrides to your package manager so that other packages resolve
 ```yaml [pnpm-workspace.yaml]
 overrides:
   vite: npm:@voidzero-dev/vite-plus-core@latest
-  vitest: 4.1.11
+  vitest: 5.0.1
 ```
 
 ```json [npm / Bun package.json]
 "overrides": {
   "vite": "npm:@voidzero-dev/vite-plus-core@latest",
-  "vitest": "4.1.11"
+  "vitest": "5.0.1"
 }
 ```
 
 ```json [Yarn package.json]
 "resolutions": {
   "vite": "npm:@voidzero-dev/vite-plus-core@latest",
-  "vitest": "4.1.11"
+  "vitest": "5.0.1"
 }
 ```
 
diff --git a/docs/guide/migrate-rules.md b/docs/guide/migrate-rules.md
index 9cbaf93988..263471247b 100644
--- a/docs/guide/migrate-rules.md
+++ b/docs/guide/migrate-rules.md
@@ -114,9 +114,11 @@ Packages that are **not** aligned:
 - `@vitest/coverage-c8` stopped at an older release and has no Vitest 4 version; and
 - third-party `vitest-*` integrations keep their own compatible versions, though their required Vitest peer may still trigger [direct provisioning](#when-vitest-is-directly-required).
 
-For browser mode, the base `@vitest/browser` runtime and `@vitest/browser-preview` are bundled by Vite+ and are removed as direct dependencies. The Playwright and WebdriverIO providers stay opt-in: a kept or injected provider is referenced through the preferred toolchain catalog at the bundled Vitest version (or written concretely when catalogs are unsupported), and its `playwright` or `webdriverio` peer is installed alongside.
+For browser mode, Vite+ bundles the base `@vitest/browser` runtime and `@vitest/browser-preview`; migration removes their direct dependency entries. The Playwright provider stays opt-in. Migration uses the bundled Vitest version for `@vitest/browser-playwright`, through the preferred toolchain catalog or the dependency entry, and installs its `playwright` peer alongside.
 
-Providers are detected before imports are rewritten. This covers legacy projects that aliased `vitest` to `@voidzero-dev/vite-plus-test` and import from `vitest/browser-<provider>`, `vitest/browser/providers/<provider>`, or `vitest/plugins/browser-<provider>`: those imports still install the corresponding `@vitest/browser-playwright` or `@vitest/browser-webdriverio` dependency and its framework peer.
+Migration detects Playwright usage before it rewrites imports, including legacy `vitest/browser-playwright`, `vitest/browser/providers/playwright`, and `vitest/plugins/browser-playwright` aliases.
+
+`vp migrate` restores removed Vite+ WebDriverIO aliases to `@vitest/browser-webdriverio` and adds `^5.0.0` if the provider is missing. It upgrades older versions, narrows ranges that allow versions below `5.0.0`, updates referenced catalog entries, and removes overrides that force an older provider. Versions and ranges that meet the minimum stay unchanged. Migration ensures the required `webdriverio` peer and adds an `@vitest/browser` override matching bundled Vitest (`resolutions` for Yarn). You manage later community provider upgrades. See [Community WebDriverIO provider](./vitest-v5.md#community-webdriverio-provider).
 
 Object-valued nested npm and Bun overrides are preserved: they are user-defined scopes rather than scalar version pins.
 
diff --git a/docs/guide/migrate.md b/docs/guide/migrate.md
index 7c7b3f5314..795c4c2190 100644
--- a/docs/guide/migrate.md
+++ b/docs/guide/migrate.md
@@ -1,3 +1,28 @@
+<script setup lang="ts">
+const upgradePrompt = `Upgrade this project from Vite+ 0.3.x to Vite+ 1.0 while preserving its test behavior.
+
+Read these guides before making changes:
+
+- ${__DOCS_ORIGIN__}/guide/migrate
+- ${__DOCS_ORIGIN__}/guide/vitest-v5
+- https://vitest.dev/guide/migration/
+
+Inspect the worktree and preserve unrelated changes. Keep the original manifests, lockfile, and installed packages available so migration can identify the original Vitest version. Do not update the project's vite-plus or Vitest dependencies before running migration.
+
+Use the CLI from the target Vite+ 1.0 release or its preview build. A global installation is optional. Use a supported Node.js runtime from the Vite+ compatibility guide.
+
+- With a global vp installation, follow ${__DOCS_ORIGIN__}/guide/upgrade to upgrade it and check \`vp toolchain --global\`. Run \`vp help migrate\`, then \`vp migrate --no-interactive\` from the workspace root.
+- Without a global installation, run the target CLI through the package manager from the workspace root. For the 1.0.0 release, use \`pnpm dlx --package=vite-plus@1.0.0 vp migrate --no-interactive\` or \`npx --package=vite-plus@1.0.0 vp migrate --no-interactive\`. First run the same command with \`help migrate\` instead of \`migrate --no-interactive\` to read its help. These commands fetch the target CLI without replacing the old project dependencies first.
+
+Replace 1.0.0 with the intended release version. For a preview, use the version from its PR and pass \`--registry=https://registry-bridge.viteplus.dev\` to pnpm or npx before the vp command. Do not run migration with the old project's node_modules/.bin/vp. Keep the existing project setup; do not use --full unless I request it.
+
+Resolve BLOCK findings and rerun migration. Review each REVIEW finding using its documentation link, even if migration exits with success. Preserve test intent and keep the generated v4 compatibility settings and comments until the affected tests support the v5 behavior.
+
+Check workspace manifests, catalogs, overrides, and import changes against the Vite+ guide. Keep test APIs on supported vite-plus/test entries; use @vitest/browser-webdriverio for the community WebDriverIO provider.
+
+Run \`vp install\`, \`vp check\`, and \`vp test\`, plus the project's browser, coverage, and benchmark suites where configured. Run \`vp build\` or \`vp pack\` as appropriate. Without a global CLI, finish installation with the project's package manager, then invoke the updated local CLI through it, such as \`pnpm exec vp check\` or \`npm exec -- vp check\`. Fix migration failures without weakening assertions or dropping test coverage. Report the changes, validation results, and unresolved findings. Do not commit or push unless I ask.`;
+</script>
+
 # Migrate to Vite+
 
 `vp migrate` helps move existing projects onto Vite+.
@@ -55,11 +80,13 @@ See [Migration Rules](./migrate-rules.md) for the exact dependency, source rewri
 
 Most projects will require further manual adjustments after running `vp migrate`.
 
+For the Vitest v5 upgrade, read the [compatibility settings and review checklist](./vitest-v5.md) and the [upstream Vitest migration guide](https://vitest.dev/guide/migration/). The preflight checks your original runner version and Node runtime before dependency updates. Keep the original lockfile available and resolve blocking findings before retrying.
+
 ## Recommended Workflow
 
 Before running the migration:
 
-- Upgrade to Vite 8+ and Vitest 4.1+ first
+- For projects that do not use Vite+ yet, upgrade to Vite 8+ and Vitest 4.1+ first
 - Make sure you understand any existing lint, format, or test setup that should be preserved
 
 After running the migration:
@@ -79,7 +106,7 @@ Migrate this project to Vite+. Vite+ replaces the current split tooling around r
 After the migration:
 
 - Confirm `vite` imports were rewritten to `vite-plus` where needed
-- Confirm `vitest` imports were rewritten to `vite-plus/test` (and `@vitest/browser*` to `vite-plus/test/browser*`) where needed
+- Confirm Vitest and browser imports use supported `vite-plus/test*` entries; keep community WebDriverIO provider imports on `@vitest/browser-webdriverio`
 - On pnpm, keep the `vite`, `vitest` dependency entries configured by `vp migrate` so the workspace aliases and overrides stay effective; with other package managers, you can remove them once those rewrites are confirmed
 - Move remaining tool-specific config into the appropriate blocks in `vite.config.ts`
 
@@ -96,13 +123,77 @@ Finally, verify the migration by running: `vp install`, `vp check`, `vp test`, a
 Summarize the migration at the end and report any manual follow-up still required.
 ```
 
+## Upgrade from Vite+ 0.3 to 1.0
+
+Vite+ 1.0 includes the breaking changes in Vitest 5. Read the [Vite+ compatibility guide](./vitest-v5.md) alongside the [upstream migration guide](https://vitest.dev/guide/migration/).
+
+Keep your project's original dependencies and lockfile until migration identifies the old runner. Updating the project dependencies first can prevent the migration from preserving v4 behavior. Use one of the following paths from the workspace root.
+
+### With the Global CLI
+
+Upgrade the [global CLI](./upgrade.md#global-vp) to your target 1.0 release, then run `vp migrate --no-interactive`. For a preview, follow the [preview installation instructions](./upgrade.md#global-vp-preview).
+
+### Without the Global CLI
+
+Use an existing Node.js runtime that satisfies `^22.18.0 || ^24.11.0 || >=26.0.0`. Run the target migrator through your package manager without adding it to the project first. For the `1.0.0` release:
+
+::: code-group
+
+```bash [pnpm]
+pnpm dlx --package=vite-plus@1.0.0 vp migrate --no-interactive
+```
+
+```bash [npm]
+npx --package=vite-plus@1.0.0 vp migrate --no-interactive
+```
+
+:::
+
+Replace `1.0.0` with your target release. For a preview, use the version from the PR and pass `--registry=https://registry-bridge.viteplus.dev` to `pnpm` or `npx` before the `vp` command. Keep the version in `--package` explicit so you run the target migrator rather than the old local CLI.
+
+After migration, finish dependency installation and validate with the updated local CLI:
+
+::: code-group
+
+```bash [pnpm]
+pnpm install
+pnpm exec vp check
+pnpm exec vp test
+pnpm exec vp build
+```
+
+```bash [npm]
+npm install
+npm exec -- vp check
+npm exec -- vp test
+npm exec -- vp build
+```
+
+:::
+
+Use `vp pack` in place of `vp build` for a library that uses the pack command. Run configured browser, coverage, and benchmark suites as well.
+
+### Review the Upgrade
+
+On an existing Vite+ project, use the default upgrade flow. Add `--full` if you also want to repeat project setup. Resolve blockers and review the file-specific report before committing. See [Upgrade vs. Full Setup](./migrate-rules.md#upgrade-vs-full-setup) for the scope of each mode.
+
+### Copy Prompt
+
+View and copy this prompt into your coding agent to upgrade an existing Vite+ 0.3 project:
+
+<CopyPrompt :prompt="upgradePrompt" label="View Upgrade Prompt" />
+
 ## Tool-Specific Migrations
 
 ### Vitest
 
-Vitest is automatically migrated through `vp migrate`. `vite-plus` re-exports upstream `vitest@4.x` under `vite-plus/test*`, so for node-mode tests a single `vite-plus` install is enough — you no longer need to install `vitest` directly.
+Vitest is automatically migrated through `vp migrate`. `vite-plus` re-exports upstream `vitest@5.0.1` under `vite-plus/test*`, so for node-mode tests a single `vite-plus` install is enough — you no longer need to install `vitest` directly.
+
+For browser mode, you can use the base browser runtime (`@vitest/browser`) and Preview provider (`@vitest/browser-preview`) included in `vite-plus`. To use Playwright or WebDriverIO, you also need the opt-in provider (`@vitest/browser-playwright` or `@vitest/browser-webdriverio`) and its framework peer (`playwright` or `webdriverio`).
+
+`vp migrate` adds the Playwright provider at the bundled Vitest version and ensures its framework peer. You can import it from `vite-plus/test/browser-playwright`.
 
-Browser mode is more nuanced. `vite-plus` bundles the base browser runtime (`@vitest/browser`) and the preview provider (`@vitest/browser-preview`), but the **Playwright** and **WebdriverIO** providers stay opt-in: `@vitest/browser-playwright` (with its `playwright` peer) and `@vitest/browser-webdriverio` (with its `webdriverio` peer) are **not** shipped with `vite-plus`, so non-browser projects never pull them in. `vp migrate` detects the provider you actually use and adds it — pinned to the bundled vitest version — together with its framework. If you migrate manually and use one of these providers, install the provider package and its framework yourself so `vite-plus/test/browser-playwright` / `vite-plus/test/browser-webdriverio` can resolve.
+For WebDriverIO, import from the community-maintained `@vitest/browser-webdriverio`. Migration restores legacy Vite+ provider imports, ensures a provider version of at least `5.0.0`, and adds an `@vitest/browser` override that matches the bundled runner. Manage later provider upgrades and framework peers yourself. See [Community WebDriverIO provider](./vitest-v5.md#community-webdriverio-provider).
 
 If you are migrating manually, update all the imports to `vite-plus/test*` instead:
 
diff --git a/docs/guide/test.md b/docs/guide/test.md
index 3ab3aa3c81..3cd781600f 100644
--- a/docs/guide/test.md
+++ b/docs/guide/test.md
@@ -2,6 +2,8 @@
 
 `vp test` runs tests with [Vitest](https://vitest.dev).
 
+The bundled runner uses Vitest `5.0.1` and requires Node `^22.18.0 || ^24.11.0 || >=26.0.0`. For existing projects, follow [Upgrade to Vitest 5](./vitest-v5.md) before updating dependencies.
+
 ## Overview
 
 `vp test` is built on [Vitest](https://vitest.dev/), so you get a Vite-native test runner that reuses your Vite config and plugins, supports Jest-style expectations, snapshots, and coverage, and handles modern ESM, TypeScript, and JSX projects cleanly.
diff --git a/docs/guide/vitest-v5.md b/docs/guide/vitest-v5.md
new file mode 100644
index 0000000000..b59e087248
--- /dev/null
+++ b/docs/guide/vitest-v5.md
@@ -0,0 +1,204 @@
+# Upgrade to Vitest 5
+
+Vite+ bundles Vitest `5.0.1`. Use Node `^22.18.0 || ^24.11.0 || >=26.0.0` for the CLI and tests.
+
+## Before you migrate
+
+Run `vp migrate` from the workspace root before updating dependencies by hand. Keep the original lockfile and installed packages available so the migration can identify the source Vitest version, including the runner inside an older `vite-plus` installation.
+
+Upgrade projects older than Vitest 4 to v4 before running this migration. If the original version cannot be determined, restore and install the original lockfile, then rerun `vp migrate`.
+
+```bash
+vp migrate
+vp install
+vp check
+vp test
+```
+
+Read the file-specific review report before committing the result. The migration stops before dependency updates for conflicting `test.api` and `test.browser.api` settings or removed runtime APIs without a supported replacement. Resolve these blockers and run the command again. You can finish safe edits with a successful exit status while review items remain.
+
+You can keep equivalent static `test.api` and `test.browser.api` values, including objects with different property order or quote styles. The migration removes the redundant `browser.api`. Choose one configuration for conflicting values or expressions that need evaluation; v5 uses one API server.
+
+## Node runtime
+
+The migration upgrades incompatible runtime pins to the nearest supported minimum before installing dependencies. For example, `20.19.0` becomes `22.18.0`, `24.10.0` becomes `24.11.0`, and `25.9.0` becomes `26.0.0`. Supported pins stay unchanged. Unresolved selectors still need review.
+
+Keep your library's public `engines.node` contract separate from its test runtime. The migration does not change that contract. You do not need to review an engine range with a supported minimum, such as `>=22.19.0`, or a whole supported major, such as `24.x`. Use a concrete runtime pin at or above the supported minimum for that major.
+
+The Node compatibility checks cover `.node-version`, `.nvmrc`, and the `engines.node`, `devEngines.runtime`, and `volta.node` declarations in `package.json`. Node versions in CI workflows, containers, and other files are outside the scope of these checks.
+
+## Preserve existing behavior
+
+For v4 configs, the migration adds compatibility settings where you omitted the corresponding option. Explicit settings take precedence. Beside each added setting, you get a comment with the reason, guidance for adopting v5 behavior, and a link to the Vitest migration guide:
+
+```ts
+test: {
+  // Vitest v4 compatibility: preserve mock call history.
+  // Remove after tests no longer rely on calls from setup or earlier tests.
+  // https://vitest.dev/guide/migration/#clearmocks-is-enabled-by-default
+  clearMocks: false,
+}
+```
+
+| Added setting                                                                                                               | Behavior to check before removing it                                                                                                    |
+| --------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
+| [`test.clearMocks: false`](https://vitest.dev/guide/migration/#clearmocks-is-enabled-by-default)                            | Check assertions that depend on mock calls from setup, `beforeAll`, or earlier tests. V5 clears that history before each test.          |
+| [`test.sharedViteServer: false`](https://vitest.dev/guide/migration/#inline-projects-share-the-vite-server-by-default)      | Check plugins and config hooks with a shared server. V5 initializes them once for eligible inline projects.                             |
+| [Inline `extends: false`](https://vitest.dev/guide/migration/#inline-projects-inherit-the-root-config-by-default)           | Check inherited root options, plugins, and setup files. V5 merges arrays, so avoid duplicate setup.                                     |
+| [`browser.locators.exact: false`](https://vitest.dev/guide/migration/#locators-are-strict-by-default)                       | Update locators for full, case-sensitive matches, or opt out on individual locators.                                                    |
+| [Glob threshold `perFile: true`](https://vitest.dev/guide/migration/#glob-coverage-thresholds-no-longer-inherit-perfile)    | Keep for per-file coverage enforcement. Remove to check matching files as a group.                                                      |
+| [`fakeTimers.toNotFake: ['Temporal']`](https://vitest.dev/guide/migration/#fake-timers-and-setsystemtime-now-mock-temporal) | Check tests that use the global Temporal polyfill with fake timers. Remove only `Temporal` to use mocked time; retain other exclusions. |
+
+New projects use v5 defaults. To adopt those defaults in an existing project, change one setting at a time and run the affected tests. Check CI and report consumers for output changes. Remove the accompanying comment after you accept the new behavior, or replace it with your project's reason for keeping the setting. These options remain supported in v5; you do not need to remove them all.
+
+The migration leaves your existing settings and comments untouched. It does not add comments to settings from an earlier migration, since it cannot distinguish those settings from your own choices. Repeated runs do not duplicate comments or restore comments you removed.
+
+If your project has no test config, you can use the v5 defaults without a review prompt or a new compatibility config. Other migration steps, such as merging lint configuration, can create `vite.config.ts`; the v4 compatibility settings apply to that new config during the same migration.
+
+After upgrading to v5, you can rerun `vp migrate` without reapplying v4 compatibility defaults, including in projects without a config. Finish the dependency installation before rerunning migration.
+
+Resolve or save the first run's review report before discarding the original dependencies. Later runs use the current Vitest version and files, so they might not repeat reviews that depended on the original v4 behavior.
+
+## Source changes
+
+The migration uses syntax and import bindings for targeted edits. You get a review item for dynamic options, ambiguous wrappers, or a callback whose contract cannot accept `async`.
+
+```ts
+// Before
+test.sequential('result', () => {
+  expect(result).resolves.toBe(42);
+});
+
+// After
+test('result', { concurrent: false }, async () => {
+  await expect(result).resolves.toBe(42);
+});
+```
+
+In browser tests, use `toMatchTextContent` for v4 string and regular-expression assertions. The v4 string matcher accepted partial text, so identical text in a fixture does not prove that you intended v5's exact match. Choose `toHaveTextContent` yourself if you want the new semantics.
+
+Keep Node `@testing-library/jest-dom` assertions unchanged. In a mixed Node/browser package, the migration checks static project membership before renaming a matcher. You must review shared files, dynamic configs, and command-line browser overrides. Calls through `expect.element()` identify browser assertions without that ambiguity.
+
+Await `render` from `vitest-browser-vue` and `vitest-browser-svelte` before querying its result. Replace `toThrow('')` and `toThrowError('')` with `/^$/` to keep assertions for an empty message.
+
+For programmatic config loading, replace `{ viteConfig, vitestConfig }` destructuring with the return value from `resolveConfig()` and its `.test` property. Direct migrated `vitest list` commands get `--no-static-parse`; supported `Vitest.collect(filters, options)` calls get `{ staticParse: false }`. Keep an explicit static-parse choice if you want v5's static collection.
+
+## Benchmarks
+
+Use direct `bench` calls with inline, zero-argument callbacks or references to unchanged local functions. You can use dynamic names; the migration captures them once during registration. It preserves the workload callback and runs it through the v5 `bench` fixture inside a test. Simple `bench.skip`, `bench.only`, and `bench.todo` calls become the corresponding test modifiers. Calls inside ordinary `describe` and `suite` callbacks retain their surrounding scopes.
+
+```ts
+// Before
+import { bench } from 'vitest';
+bench('parse', () => JSON.parse('{"value":1}'));
+
+// After
+import { test } from 'vitest';
+test('parse', async ({ bench }) => {
+  await bench('parse', () => JSON.parse('{"value":1}')).run();
+});
+```
+
+Keep benchmark files matched by `benchmark.include`. The `vitest bench` and `vp test bench` commands remain supported. The migration does not remove them.
+
+You can migrate built-in `benchmark.reporters` settings (`default` and `verbose`) and literal `benchmark.outputFile` or `benchmark.outputJson` paths to top-level reporters. Existing reporter destinations take precedence over a proposed move: resolve conflicting paths, terminal reporter choices, and JSON stdout consumers by hand. Project-specific settings, config merges, and custom or dynamic reporters also need review. In v5, regular tests and benchmarks share reporters.
+
+For a literal command such as `vitest bench --outputJson=bench.json`, the migration selects the JSON reporter and keeps the file path. The v5 JSON report contains test results with per-test benchmarks. If you consume these reports outside Vitest, update readers that expect the v4 format.
+
+Review calls with benchmark options, imported or reassigned callbacks, callback parameters, or wrappers. Baseline `compare` settings and `--compare` flags remain blockers. Set up per-benchmark result storage and an explicit comparison inside a test. See the [Vitest benchmark migration guide](https://vitest.dev/guide/migration/#benchmarking-api-rewrite) and [benchmarking guide](https://vitest.dev/guide/benchmarking) for replacements. Use `bench.compare()` if you need a comparison table across several workloads.
+
+## Entry points and packages
+
+Use `vite-plus/test` for assertions and supported runner APIs. Keep coverage providers and `@vitest/ui` at the bundled runner's exact version, `5.0.1`. Keep `@vitest/web-worker` aligned when your project uses it.
+
+| v4 import                                | v5 import or action                                                         |
+| ---------------------------------------- | --------------------------------------------------------------------------- |
+| `vitest/coverage`, `vitest/reporters`    | `vite-plus/test/node`                                                       |
+| `vitest/environments`, `vitest/snapshot` | `vite-plus/test/runtime`                                                    |
+| `vitest/mocker`                          | `vite-plus/test/mocker`                                                     |
+| `vitest/runners`, `vitest/suite`         | Review `TestRunner` and its static methods from `vite-plus/test`.           |
+| Root-compatible `@vitest/expect` symbols | `vite-plus/test`; review unsupported helpers.                               |
+| `@vitest/runner`                         | Migrate supported symbols to the root API and review the remaining imports. |
+| `vitest/internal/module-runner`          | Redesign the integration; no public replacement exists.                     |
+| `@vitest/ws-client`                      | Retain if needed; upstream no longer adds v5 features.                      |
+
+Vite+ 1.0 removes `vite-plus/test/coverage`, `/reporters`, `/environments`, and `/snapshot`. Run `vp migrate` to rewrite these existing Vite+ imports to the same `node` or `runtime` entries shown above. Vite+ retains `vite-plus/test/mocker` for the standalone `@vitest/mocker` API. It does not provide partial runner or expect plugin shims.
+
+## Community WebDriverIO provider
+
+Vite+ 1.0 removes the `vite-plus/test/browser-webdriverio` exports. Use `@vitest/browser-webdriverio` and choose a provider version and framework peers that support your tests. The community maintains this package on its own release schedule.
+
+`vp migrate` changes legacy provider imports to `@vitest/browser-webdriverio` and ensures a provider version of at least `5.0.0`. It adds `^5.0.0` when the provider is missing, upgrades older versions, and narrows ranges that still allow v4. It also updates referenced catalog entries and removes overrides that force an older provider. Versions and ranges already above this minimum stay unchanged. The migration ensures the required `webdriverio` peer is installed without upgrading an existing framework version.
+
+For projects that use this provider, `vp migrate` adds an `@vitest/browser` override that matches the bundled Vitest version. Yarn uses `resolutions`. This prevents the provider's version range from retaining an older browser package in the lockfile.
+
+You manage provider upgrades after this migration; Vite+ does not synchronize community releases with Vitest. Existing imports from the community package stay unchanged. For custom dependencies that the migrator cannot verify, resolve the diagnostic before retrying migration. See the [upstream package migration guide](https://vitest.dev/guide/migration/#package-migration).
+
+Legacy Vite+ WebDriverIO `/context` imports move to `vite-plus/test/browser/context`. Keep runtime browser APIs on this shared entry; the community provider's `/context` entry contains types only.
+
+The optional peer declaration still follows Vitest's dependency metadata. It does not provide a Vite+ export or synchronize provider releases.
+
+## Reports and screenshots
+
+The migration does not edit or report changes that affect only title formatting, report output, artifact paths, or dependency deprecation. It leaves regular reporter settings unchanged and does not add `stdout: true`. Removed benchmark APIs and flags still need migration so commands can run.
+
+If you consume generated reports or artifacts outside Vitest, check these paths. Keep old ignore entries while files remain in those directories. The migration adds `.vitest/` to `.gitignore` without deleting old entries.
+
+| Output              | v4 default                    | v5 default                                 |
+| ------------------- | ----------------------------- | ------------------------------------------ |
+| Attachments         | `.vitest-attachements/`       | `.vitest/attachments/`                     |
+| Failure screenshots | `__screenshots__/`            | `.vitest/attachments/failure-screenshots/` |
+| Blob reports        | `.vitest-reports/blob-*.json` | `.vitest/blob/blob-*.json`                 |
+| HTML                | `html/index.html`             | `.vitest/index.html`                       |
+| JSON                | stdout                        | `.vitest/json/output.json`                 |
+| JUnit               | stdout                        | `.vitest/junit/output.xml`                 |
+
+HTML reporter options now use `outputDir` instead of the file-valued `outputFile`. Set `outputDir` yourself if you need a custom destination. Other reporters retain `outputFile` support. See the [upstream report changes](https://vitest.dev/guide/migration/#generated-reports-and-artifacts-use-the-vitest-directory).
+
+Copy a custom `browser.screenshotDirectory` to `browser.expect.toMatchScreenshot.screenshotDirectory`. Review reference images before moving or regenerating them; v4 could save them in an unintended location. The default reference screenshot directory remains `__screenshots__`.
+
+## Resolve migration findings
+
+Each Vitest v5 `BLOCK` or `REVIEW` item includes a `Docs` link. Follow the link for the relevant API change or migration rule. A blocker stops dependency updates; a review item requires you to check the result but does not stop safe edits.
+
+For dynamic configs or shared files, determine the effective Vitest project settings before editing. Resolve config functions, spreads, and external inheritance, or make the compatibility changes by hand. Confirm which runner owns unimported globals in a mixed-runner project.
+
+For parser failures or overlapping edits, keep the original file and apply the documented change by hand. Run `vp migrate` again after resolving the issue. A successful exit can still include review items; keep that report until you finish the manual changes.
+
+## Review checklist
+
+Use the file locations in the migration report to review these changes. Run browser and coverage suites as well as Node tests.
+
+For jest-dom matcher types, load `@testing-library/jest-dom/vitest` in `compilerOptions.types` or import it from a TypeScript setup file that your `tsconfig.json` includes. The root `@testing-library/jest-dom` type entry augments Jest. A JavaScript setup file excluded by `allowJs: false` does not load the Vitest augmentation for type checking. Review shared Jest/Vitest configs before changing their type entries.
+
+With `vitest@5.0.1`, loading browser declarations first can also make TypeScript reject valid Node jest-dom assertions: `toHaveTextContent(/pattern/)` and CSS custom properties in `toHaveStyle()`. We reproduced this conflict with upstream imports and with Vite+ imports. Both `@testing-library/jest-dom@6.9.1` and `7.0.1` reproduce it. Check the declarations loaded by each test `tsconfig.json`; adding the jest-dom type entry alone might not resolve the conflict. Keep the affected project on the v4-based release until its Node and browser matcher types pass separate checks.
+
+| Area                  | Required review                                                                                                                                                                            |
+| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| Test selection        | Full names use `>` separators. Check name filters that span suite boundaries; plain single-segment filters do not need review.                                                             |
+| Hoisted mocks         | Move nested `vi.mock`, `vi.unmock`, and `vi.hoisted` calls to the top level after checking captured variables.                                                                             |
+| Browser automocks     | Factory-free mocks retain mock defaults. Choose `{ spy: true }` if you need real implementations.                                                                                          |
+| Constructor mocks     | Check prototypes, methods, and `instanceof` for `vi.fn`, `vi.spyOn`, and `mockImplementation`.                                                                                             |
+| Benchmarks            | Review benchmark calls that the migration could not convert, comparison groups, and removed reporting options. Keep supported options such as `benchmark.enabled` and `benchmark.include`. |
+| Async assertions      | Await or return `resolves`, `rejects`, file snapshots, polls, and browser assertions. Review `expect.poll` timeouts without increasing them to hide failures.                              |
+| Matcher types         | Update old `Assertion<T>`, `Matchers<T>`, and `jest.Matchers` declarations for return and received type parameters.                                                                        |
+| Browser commands      | Accept `SerializedLocator` objects instead of selector strings.                                                                                                                            |
+| Browser UI            | Use Vitest's printed URLs, including UI tokens and orchestrator `sessionId`. Check headed/headless screenshots at fixed viewports.                                                         |
+| Project configuration | Check dynamic projects, root-config merges, nested projects, and hooks that assume one server or config execution per project.                                                             |
+| Test collection       | Review dynamic command wrappers and programmatic `collect()` calls whose static-parse options need manual edits.                                                                           |
+| Coverage              | Compare v4/v5 resolved file sets for configured `coverage.include` and `coverage.exclude`. Relative-path matching can change the measured set.                                             |
+| Worker IDs            | Review arithmetic and indexing based on `VITEST_POOL_ID` or `VITEST_WORKER_ID`; IDs start at 1.                                                                                            |
+| Custom environments   | Restore `populateGlobal().originals` entries with `Object.defineProperty`; the map contains descriptors.                                                                                   |
+| DOM globals           | Check assignments in jsdom/happy-dom tests; global assignments also update the window.                                                                                                     |
+| Temporal              | Review scopes that use Temporal and `vi.setSystemTime()`. `toNotFake` does not preserve behavior without fake timers.                                                                      |
+| Removed APIs          | Replace unsupported runner and internal imports before updating packages. Type-only references still require review and type checks.                                                       |
+
+## Run below a config directory
+
+Vitest v5 no longer searches parent directories for a config. From a subdirectory, pass both the parent config and the intended test directory:
+
+```bash
+vp test --config ../vite.config.ts --dir .
+```
+
+See the [upstream Vitest 5 migration guide](https://vitest.dev/guide/migration/) for API examples and the new benchmark design.
diff --git a/docs/vite.config.ts b/docs/vite.config.ts
index 6cbc6a0c37..365e29530a 100644
--- a/docs/vite.config.ts
+++ b/docs/vite.config.ts
@@ -3,9 +3,9 @@ export default {
     tasks: {
       'build:site': {
         command: 'vitepress build',
-        // The install-URL rewrite in .vitepress/config.mts depends on this
-        // variable, so different deploy targets must not share cached output.
-        env: ['DOCS_SITE_ORIGIN'],
+        // The docs and installer URLs depend on the explicit origin or Workers
+        // branch, so different deploy targets must not share cached output.
+        env: ['DOCS_SITE_ORIGIN', 'WORKERS_CI', 'WORKERS_CI_BRANCH'],
         input: [
           { auto: true },
           '!.vitepress/.temp/**',
diff --git a/ecosystem-ci/patch-project.ts b/ecosystem-ci/patch-project.ts
index df86e933fd..1c9fae7cef 100644
--- a/ecosystem-ci/patch-project.ts
+++ b/ecosystem-ci/patch-project.ts
@@ -7,6 +7,7 @@ import { VITEST_VERSION } from '../packages/cli/src/utils/constants.ts';
 import vitePlusCorePkg from '../packages/core/package.json' with { type: 'json' };
 import { ecosystemCiDir, tgzDir, vitePlusTgzVersion } from './paths.ts';
 import repos from './repo.json' with { type: 'json' };
+import { prepareWebdriverioProject } from './webdriverio.ts';
 
 const projects = Object.keys(repos);
 
@@ -84,6 +85,8 @@ if (process.env.GITHUB_ENV) {
   process.on('exit', () => registryServer.kill());
 }
 
+await prepareWebdriverioProject(project, repoRoot, cli);
+
 if (project === 'rollipop') {
   const oxfmtrc = await readFile(join(repoRoot, '.oxfmtrc.json'), 'utf-8');
   await writeFile(
@@ -248,14 +251,14 @@ if (project === 'nuxt-devtools') {
 // vp migrate runs full dependency rewriting instead of skipping.
 const forceFreshMigration = 'forceFreshMigration' in repoConfig && repoConfig.forceFreshMigration;
 
-// Mirror VITE_PLUS_OVERRIDE_PACKAGES: pin `vitest` only. The `@vitest/*` family
-// are exact deps of `vitest`, so a single `vitest` override cascades them.
+// Mirror VITE_PLUS_OVERRIDE_PACKAGES: pin `vitest` only. Vitest pins its
+// internal dependencies; the migration aligns first-party browser providers.
 //
 // Coverage providers are intentionally NOT in the shipped override map (the
 // product leaves them user-owned; the runtime guard fail-fasts on a skew). But
 // this rig FORCE-INSTALLS the locally built vitest, and many ecosystem projects
 // pin an older `@vitest/coverage-*` in their lockfile. Without alignment, the
-// forced runner (4.1.9) skews from the project's pinned provider and the guard
+// forced runner skews from the project's pinned provider and the guard
 // aborts `vp test --coverage` — testing an incoherent combo no real install has.
 // Pin the providers here so the E2E coverage step runs against a consistent
 // runner+provider pair, exactly as a user who followed the guard's advice would.
@@ -308,6 +311,110 @@ execSync(`${cli} migrate --no-agent --no-interactive`, {
   env: migrateEnv,
 });
 
+if (project === 'vue-mini') {
+  // Apply the assertion-types review item without changing matcher behavior.
+  // Remove when the pinned setup declares both Vitest 5 type parameters.
+  // https://vitest.dev/guide/migration/#assertion-types-expose-return-and-received-types
+  const setupPath = join(repoRoot, 'vitest.setup.ts');
+  const setup = await readFile(setupPath, 'utf-8');
+  const legacyAssertion = 'interface Assertion<T = any> extends CustomMatchers<T> {}';
+  if (setup.split(legacyAssertion).length !== 2) {
+    throw new Error('vue-mini patch: expected the pinned custom matcher declaration');
+  }
+  await writeFile(
+    setupPath,
+    setup.replace(legacyAssertion, 'interface Assertion<R, T> extends CustomMatchers<R> {}'),
+    'utf-8',
+  );
+}
+
+if (project === 'dify') {
+  // The happy-dom setup registers jest-dom matchers, but omits their Vitest
+  // types. Its jest-dom 6 adapter still augments the old Assertion<T> interface;
+  // use the v5 extension point so browser declarations cannot take precedence.
+  // Remove when the pinned project provides a v5-compatible matcher augmentation.
+  // https://vitest.dev/guide/migration/#assertion-types-expose-return-and-received-types
+  const setupPath = join(repoRoot, 'web', 'vitest.setup.ts');
+  const setup = await readFile(setupPath, 'utf-8');
+  const registration = "if (typeof expect.extend === 'function') {";
+  if (
+    setup.split(registration).length !== 2 ||
+    setup.includes('interface Matchers<') ||
+    !setup.includes('expect.extend(jestDomMatchers)')
+  ) {
+    throw new Error('dify patch: expected the pinned Jest DOM setup');
+  }
+  await writeFile(
+    setupPath,
+    setup.replace(
+      registration,
+      `// Match the jest-dom implementations registered below, not browser-mode matchers.
+declare module 'vite-plus/test' {
+  interface Matchers<R, T> extends jestDomMatchers.TestingLibraryMatchers<T, R> {}
+}
+
+${registration}`,
+    ),
+    'utf-8',
+  );
+}
+
+if (project === 'npmx.dev') {
+  // Vitest 5 adds browser optimizer dependencies after Nuxt's config hook has
+  // filtered its exclusions. Reapply that filter only in the Nuxt test project.
+  // Remove when an upstream fix preserves those exclusions after the merge.
+  // https://github.com/why-reproductions-are-required/vitest-browser-optimizer-config-order
+  const viteConfigPath = join(repoRoot, 'vite.config.ts');
+  const viteConfig = await readFile(viteConfigPath, 'utf-8');
+  const nuxtProject = /defineVitestProject\(\{\s*test:\s*\{/g;
+  if ([...viteConfig.matchAll(nuxtProject)].length !== 1) {
+    throw new Error('npmx.dev patch: expected the pinned Nuxt test project configuration');
+  }
+  await writeFile(
+    viteConfigPath,
+    viteConfig.replace(
+      nuxtProject,
+      `defineVitestProject({
+          plugins: [{
+            // Temporary Vitest 5 workaround: preserve Nuxt's optimizer exclusions.
+            // https://github.com/why-reproductions-are-required/vitest-browser-optimizer-config-order
+            name: 'npmx:test:preserve-optimizer-exclusions',
+            configureServer(server) {
+              for (const options of [
+                server.config.optimizeDeps,
+                server.environments.client.config.optimizeDeps,
+              ]) {
+                const excluded = new Set(options.exclude ?? [])
+                options.include = options.include?.filter(dep => !excluded.has(dep))
+              }
+            },
+          }],
+          test: {`,
+    ),
+    'utf-8',
+  );
+}
+
+if (project === 'bun-vite-template') {
+  // The pinned template runs Vitest only. Its JS setup file loads jest-dom's
+  // Vitest runtime, but allowJs: false excludes that file from type checking.
+  // Apply the migration report's manual type-entry repair for this fixture.
+  const tsconfigPath = join(repoRoot, 'tsconfig.json');
+  const tsconfig = JSON.parse(await readFile(tsconfigPath, 'utf-8'));
+  const types = tsconfig.compilerOptions?.types;
+  if (
+    !Array.isArray(types) ||
+    !types.includes('vitest/globals') ||
+    !types.includes('@testing-library/jest-dom')
+  ) {
+    throw new Error('bun-vite-template patch: expected the pinned Jest DOM type configuration');
+  }
+  tsconfig.compilerOptions.types = types.map((type) =>
+    type === '@testing-library/jest-dom' ? '@testing-library/jest-dom/vitest' : type,
+  );
+  await writeFile(tsconfigPath, `${JSON.stringify(tsconfig, null, 2)}\n`);
+}
+
 if (project === 'tiptap') {
   // Keep Tiptap's upstream lint semantics. Migration enables type-aware type
   // checking, which reports TypeScript diagnostics that upstream CI does not check.
@@ -326,7 +433,7 @@ if (project === 'tiptap') {
 
 // Install through the local registry. `vp migrate` already pinned
 // `vite-plus@<version>` in package.json exactly like a real migration, so no
-// manual package.json rewrite is needed.
+// manual rewrite of the Vite+ version is needed.
 execSync(`${cli} install --no-frozen-lockfile`, {
   cwd: repoRoot,
   stdio: 'inherit',
diff --git a/ecosystem-ci/repo.json b/ecosystem-ci/repo.json
index 1d62312e9f..8238ae3cc8 100644
--- a/ecosystem-ci/repo.json
+++ b/ecosystem-ci/repo.json
@@ -30,7 +30,7 @@
   "vue-mini": {
     "repository": "https://github.com/vue-mini/vue-mini.git",
     "branch": "master",
-    "hash": "333c5957bf99a68991c9f91019670c56b65bd896"
+    "hash": "d8ba920b64922c959314226ffcf70af52b27e344"
   },
   "vite-plugin-react": {
     "repository": "https://github.com/vitejs/vite-plugin-react.git",
@@ -98,7 +98,7 @@
   "yaak": {
     "repository": "https://github.com/mountain-loop/yaak.git",
     "branch": "main",
-    "hash": "b4a1c418bb3f923858dd55729f585e189327a038",
+    "hash": "c6e09a5af3b20fc43cb6000af7b420af24ff510a",
     "forceFreshMigration": true
   },
   "npmx.dev": {
@@ -108,6 +108,12 @@
     "forceFreshMigration": true,
     "playwright": true
   },
+  "codiff": {
+    "repository": "https://github.com/nkzw-tech/codiff.git",
+    "branch": "main",
+    "hash": "1bfbe4506f5321bd419d56f40d8b02a5f6fc82c7",
+    "forceFreshMigration": true
+  },
   "vite-plus-jest-dom-repro": {
     "repository": "https://github.com/why-reproductions-are-required/vite-plus-jest-dom-repro.git",
     "branch": "master",
@@ -160,6 +166,22 @@
     "hash": "f434577e6bb2010b321653cb132a57bda18764fa",
     "forceFreshMigration": true
   },
+  "10ten-ja-reader": {
+    "repository": "https://github.com/birchill/10ten-ja-reader.git",
+    "branch": "main",
+    "hash": "7eabad2d5075ce278c580a59c4deb6b2d794383f"
+  },
+  "sqlocal": {
+    "repository": "https://github.com/DallasHoff/sqlocal.git",
+    "branch": "main",
+    "hash": "ef38d4d76d7e09da5ffc3b3ab0ba98ea78c18000"
+  },
+  "brazilian-utils": {
+    "repository": "https://github.com/brazilian-utils/javascript.git",
+    "branch": "main",
+    "hash": "2b2c73518fbfdad820e4760b19fee99c4d836c94",
+    "forceFreshMigration": true
+  },
   "solid-vite-plugin": {
     "repository": "https://github.com/solidjs/solid-vite-plugin.git",
     "branch": "next",
diff --git a/ecosystem-ci/webdriverio.ts b/ecosystem-ci/webdriverio.ts
new file mode 100644
index 0000000000..c6fd980671
--- /dev/null
+++ b/ecosystem-ci/webdriverio.ts
@@ -0,0 +1,132 @@
+import { execSync } from 'node:child_process';
+import { readFile, rename, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+
+async function replaceOnce(file: string, original: string, replacement: string): Promise<void> {
+  const source = await readFile(file, 'utf8');
+  if (source.split(original).length !== 2) {
+    throw new Error(`WebDriverIO fixture patch: expected one occurrence of ${original} in ${file}`);
+  }
+  await writeFile(file, source.replace(original, replacement));
+}
+
+export async function prepareWebdriverioProject(
+  project: string,
+  root: string,
+  cli: string,
+): Promise<void> {
+  if (project === '10ten-ja-reader') {
+    // Match upstream CI's Node pin for its locked WebDriverIO/Undici versions.
+    // https://github.com/birchill/10ten-ja-reader/blob/7eabad2d5075ce278c580a59c4deb6b2d794383f/.github/workflows/ci.yml
+    await writeFile(join(root, '.node-version'), '24.15.0\n');
+
+    // Give formatter migration an existing, loadable Vite config. The app uses
+    // Rspack; moving this test config does not change the browser project.
+    await rename(join(root, 'vitest.config.ts'), join(root, 'vite.config.ts'));
+    // Oxfmt does not support this Prettier plugin option, and its $DEFAULT
+    // token is interpreted as an ast-grep variable when merging the config.
+    // Remove this workaround when formatter migration drops unsupported options.
+    const prettierPath = join(root, '.prettierrc.json');
+    const prettier = JSON.parse(await readFile(prettierPath, 'utf8'));
+    if (!prettier.attributeGroups?.includes('$DEFAULT')) {
+      throw new Error('10ten-ja-reader patch: expected the pinned attributeGroups option');
+    }
+    delete prettier.attributeGroups;
+    await writeFile(prettierPath, `${JSON.stringify(prettier, null, 2)}\n`);
+  }
+
+  if (project === 'sqlocal') {
+    // Vitest 5's browser server does not run the SQLocal plugin's middleware.
+    // Keep the same isolation headers explicitly; OPFS tests assert isolation.
+    // Remove when the upstream plugin supports the separate browser server.
+    await replaceOnce(
+      join(root, 'vite.config.ts'),
+      'export default defineConfig({',
+      `export default defineConfig({
+  server: {
+    headers: {
+      'Cross-Origin-Embedder-Policy': 'require-corp',
+      'Cross-Origin-Opener-Policy': 'same-origin',
+    },
+  },`,
+    );
+
+    // The migrator conservatively leaves benchmarks inside describe.each for
+    // manual review. Preserve the callbacks and use the v5 context fixture.
+    // Remove these patches when SQLocal adopts the new benchmark API.
+    // https://vitest.dev/guide/migration/#benchmarking-api-rewrite
+    for (const [file, title] of [
+      ['batch.bench.ts', 'batch large replace'],
+      ['reactive-bulk-write.bench.ts', 'query after bulk write with reactive queries enabled'],
+    ]) {
+      const filePath = join(root, 'test', 'benchmarks', file);
+      await replaceOnce(
+        filePath,
+        "import { bench, describe } from 'vitest';",
+        "import { test, describe } from 'vitest';",
+      );
+      await replaceOnce(
+        filePath,
+        `bench('${title}', async () => {`,
+        `test('${title}', async ({ bench }) => {\n\t\t\tawait bench('${title}', async () => {`,
+      );
+      await replaceOnce(filePath, '\n\t\t});\n\t}\n);', '\n\t\t\t}).run();\n\t\t});\n\t}\n);');
+    }
+  }
+
+  if (project === 'brazilian-utils') {
+    // npm's lockfile does not establish the bundled runner version by itself.
+    // Install the original graph so preflight can identify Vite+ 0.x's Vitest.
+    // This runs before changing any manifest and outside the local registry.
+    execSync(`${cli} install --frozen-lockfile --ignore-scripts`, {
+      cwd: root,
+      stdio: 'inherit',
+    });
+
+    // This multi-runner adapter escapes the old bench API, so migration cannot
+    // rewrite it automatically. Keep benchmarks as todo tests in normal mode.
+    // Remove when upstream adopts the v5 fixture-based benchmark API.
+    // https://vitest.dev/guide/migration/#benchmarking-api-rewrite
+    const runtimePath = join(root, 'src', '_internals', 'test', 'runtime-vitest.ts');
+    await replaceOnce(
+      runtimePath,
+      'import { bench as vitestBench, test } from "vite-plus/test";\n\nimport { bench as noopBench } from "./noop";',
+      'import { test } from "vite-plus/test";',
+    );
+    await replaceOnce(
+      runtimePath,
+      `/**
+ * In benchmark mode (\`npm run bench\`) this is vitest's own \`bench\`. In test mode every benchmark
+ * is registered as a todo test instead, so a \`describe("<name> benchmarks")\` block is never an
+ * empty suite (which vitest reports as a failure) and shows up in the run as todo.
+ */
+export const bench: typeof vitestBench = isBenchmarkMode()
+\t? vitestBench
+\t: Object.assign((name: string): void => {
+\t\t\ttest.todo(name);
+\t\t}, noopBench);`,
+      `// Vitest 5 uses a test-context fixture; retain upstream's todo behavior in test mode.
+export const bench = (name: string, callback: () => void | Promise<void>): void => {
+  if (!isBenchmarkMode()) {
+    test.todo(name);
+    return;
+  }
+  test(name, async ({ bench }) => {
+    await bench(name, callback).run();
+  });
+};`,
+    );
+    for (const file of ['runtime.ts', 'noop.ts']) {
+      await replaceOnce(
+        join(root, 'src', '_internals', 'test', file),
+        'import { type bench as vitestBench, type expectTypeOf as vitestExpectTypeOf } from "vite-plus/test";',
+        'import { type expectTypeOf as vitestExpectTypeOf } from "vite-plus/test";\nimport type { bench as vitestBench } from "./runtime-vitest";',
+      );
+    }
+    await replaceOnce(
+      join(root, 'package.json'),
+      '"bench": "vp test bench --run"',
+      '"bench": "vp test run --mode benchmark"',
+    );
+  }
+}
diff --git a/packages/cli/BUNDLING.md b/packages/cli/BUNDLING.md
index 87c16a5564..8b561c9472 100644
--- a/packages/cli/BUNDLING.md
+++ b/packages/cli/BUNDLING.md
@@ -27,6 +27,13 @@ target project. An incidental hoisted peer does not trigger project validation.
 These checks run before Vite or packaging commands start. Keep the canonical
 name in release metadata and alias targets to identify the published package.
 
+For npm projects without overrides, pin a declared `vite` alias to the exact
+installed `vite-plus` version. npm can replace a tagged alias such as
+`npm:@voidzero-dev/vite-plus-core@latest` with upstream Vite to satisfy Vitest's
+peer range. The CLI rejects that mismatch and directs users to `vp migrate`,
+which writes an exact alias and the package-manager overrides. The npm fixtures
+check shared core identity with an exact alias and rejection of the tagged layout.
+
 ## Build Steps
 
 ### Step 1: tsdown Build (`buildWithTsdown`)
@@ -104,7 +111,43 @@ export type * from 'vite/types/importMeta.d.ts';
 
 ### Step 4: Test Package Export Sync (`syncTestPackageExports`)
 
-Reads vitest's exports plus the three `@vitest/browser-*` provider packages and creates shim files that re-export everything under `./test/*`:
+Reads Vitest's exports plus the Playwright and Preview provider packages and creates re-export shims under `./test/*`.
+
+Ship `vite` as a dependency alias for the same `@voidzero-dev/vite-plus-core` version. Vitest v5 requires a `vite` peer. Yarn users must be able to install `vite-plus` without adding `vite` or `vitest` to their project. Keep the alias in `dependencies`, not `devDependencies`.
+
+The main surface mirrors Vitest `5.0.1`, except for package metadata and wildcard
+exports. Export tests snapshot the final keys. Vite+ 1.0 removes the legacy
+`coverage`, `reporters`, `environments`, and `snapshot` aliases under
+`vite-plus/test/`. Run `vp migrate` to replace imports from either `vitest/*`
+or `vite-plus/test/*` with the `node` or `runtime` entry:
+
+| Removed path suffix        | Replacement              |
+| -------------------------- | ------------------------ |
+| `coverage`, `reporters`    | `vite-plus/test/node`    |
+| `environments`, `snapshot` | `vite-plus/test/runtime` |
+
+The `vite-plus/test/mocker` shim re-exports `@vitest/mocker`; migration still
+uses this path because Vitest v5 has no corresponding entry.
+
+Playwright and Preview provider paths and `browser/providers/*` aliases remain
+available. WebDriverIO has no Vite+ shims. Migration restores its legacy aliases
+to the community-maintained `@vitest/browser-webdriverio` package. Keep the
+optional peer declaration synchronized with Vitest's dependency metadata.
+The `plugins/*` compatibility paths mirror public exports of their named
+standalone packages and retain upstream type declarations.
+
+Removed runner, suite, expect-plugin, and internal module-runner paths have no
+partial shim. Use `TestRunner` and `expect` from `vite-plus/test` where the root
+API supports the old symbol. The migration reports uses without a replacement.
+The resolver uses an explicit package allowlist, so standalone `@vitest/expect`,
+deprecated `@vitest/ws-client`, and `@vitest/istanbul-lib-*` dependencies keep
+their own project resolution.
+
+Inline projects inherit the declaring config's Vite+ plugins. Independent
+projects (`extends: false` or an external base) receive their own plugins.
+Referenced configs that use `defineConfig` or `defineProject` receive the same
+integration, including nested projects. Raw referenced configs retain upstream
+resolution and its soft coverage-version warning when no Vite+ hook runs.
 
 ```typescript
 // For each vitest export like "./node"
@@ -366,27 +409,30 @@ Instead of copying vitest's dist files, we create thin shim files that re-export
 
 Every entry under vitest's own `exports` is shimmed under `./test/*` (wildcard exports and `./package.json` are skipped). The shim is purely a re-export — `vite-plus/test` and friends are aliases for the matching subpath of upstream `vitest`. Examples:
 
-| Vitest Export      | CLI Package Export         |
-| ------------------ | -------------------------- |
-| `vitest`           | `vite-plus/test`           |
-| `vitest/browser`   | `vite-plus/test/browser`   |
-| `vitest/node`      | `vite-plus/test/node`      |
-| `vitest/config`    | `vite-plus/test/config`    |
-| `vitest/reporters` | `vite-plus/test/reporters` |
+| Vitest Export    | CLI Package Export       |
+| ---------------- | ------------------------ |
+| `vitest`         | `vite-plus/test`         |
+| `vitest/browser` | `vite-plus/test/browser` |
+| `vitest/node`    | `vite-plus/test/node`    |
+| `vitest/config`  | `vite-plus/test/config`  |
+| `vitest/runtime` | `vite-plus/test/runtime` |
 
 The full set is regenerated on every build from the upstream vitest `package.json`, so the exact list tracks vitest itself.
 
-In addition to vitest's own exports, the three `@vitest/browser-*` provider packages are projected under two parallel surfaces so existing user code keeps resolving after the deleted `@voidzero-dev/vite-plus-test` wrapper:
+In addition to vitest's own exports, the official browser providers have these aliases:
 
-| Provider Package              | CLI Package Exports                                                                  |
-| ----------------------------- | ------------------------------------------------------------------------------------ |
-| `@vitest/browser-playwright`  | `vite-plus/test/browser-playwright`, `vite-plus/test/browser/providers/playwright`   |
-| `@vitest/browser-preview`     | `vite-plus/test/browser-preview`, `vite-plus/test/browser/providers/preview`         |
-| `@vitest/browser-webdriverio` | `vite-plus/test/browser-webdriverio`, `vite-plus/test/browser/providers/webdriverio` |
+| Provider Package             | CLI Package Exports                                                                |
+| ---------------------------- | ---------------------------------------------------------------------------------- |
+| `@vitest/browser-playwright` | `vite-plus/test/browser-playwright`, `vite-plus/test/browser/providers/playwright` |
+| `@vitest/browser-preview`    | `vite-plus/test/browser-preview`, `vite-plus/test/browser/providers/preview`       |
 
 Each provider's own subpaths (e.g. `./context`) are mirrored under both alias prefixes.
 
-> **Note — webdriverio and playwright are opt-in.** `@vitest/browser` (base) and `@vitest/browser-preview` stay bundled **runtime dependencies** of `vite-plus` (and are stripped from users' manifests during migration) because neither carries a heavy non-optional peer. `@vitest/browser-webdriverio` and `@vitest/browser-playwright` are now vite-plus **devDependencies + optional peerDependencies** — each is kept as a devDependency so build-time shim generation can still emit the `./test/browser-webdriverio*` / `./test/browser-playwright*` exports (the export/shim surfaces above are unchanged), but neither is a bundled runtime dep. They are optional peers because each drags a non-optional framework peer (`webdriverio` / `playwright`) that non-browser consumers must not be forced to install. Users targeting a provider instead **keep** it in their **own** dependencies via `vp migrate` (pinned to the bundled vitest version, with its framework peer ensured), so their rewritten `vite-plus/test/browser-webdriverio` / `vite-plus/test/browser-playwright` imports resolve.
+Browser-context runtime aliases re-export `vitest/browser`, the virtual entry used by Vitest v5. This applies to provider `/context` paths, `./test/browser/context`, `./test/context`, and `./test/plugins/browser-context`. Their declarations retain the upstream browser-context types and module augmentations. The upstream `@vitest/browser/context` JavaScript file is now an error stub, not the browser runtime.
+
+`@vitest/browser` and `@vitest/browser-preview` are bundled runtime dependencies. Playwright stays an optional peer and a development dependency for shim generation. Migration keeps the Playwright provider in the user's dependencies, aligns it with bundled Vitest, and ensures its framework peer.
+
+Vite+ 1.0 has no WebDriverIO exports or shims. Users import from the community-maintained `@vitest/browser-webdriverio` and manage its versions and peers. The optional peer declaration remains synchronized with Vitest's dependency metadata; the development dependency supports compatibility tests only. Migration restores legacy provider aliases to the community package and moves legacy runtime `/context` aliases to the shared `vite-plus/test/browser/context` entry.
 
 #### Why provider d.ts shims are inlined
 
diff --git a/packages/cli/README.md b/packages/cli/README.md
index 2a40f6bbf1..18b488b07d 100644
--- a/packages/cli/README.md
+++ b/packages/cli/README.md
@@ -201,7 +201,7 @@ Add package-manager overrides so that other packages use the Vite+ versions. Ali
 ```json
 "overrides": {
   "vite": "npm:@voidzero-dev/vite-plus-core@latest",
-  "vitest": "4.1.11"
+  "vitest": "5.0.1"
 }
 ```
 
@@ -210,7 +210,7 @@ If you are using `pnpm`, add this to your `pnpm-workspace.yaml`:
 ```yaml
 overrides:
   vite: npm:@voidzero-dev/vite-plus-core@latest
-  vitest: 4.1.11
+  vitest: 5.0.1
 ```
 
 Or, if you are using Yarn:
@@ -218,7 +218,7 @@ Or, if you are using Yarn:
 ```json
 "resolutions": {
   "vite": "npm:@voidzero-dev/vite-plus-core@latest",
-  "vitest": "4.1.11"
+  "vitest": "5.0.1"
 }
 ```
 
diff --git a/packages/cli/binding/index.cjs b/packages/cli/binding/index.cjs
index dd54ebadc8..6172aba1d5 100644
--- a/packages/cli/binding/index.cjs
+++ b/packages/cli/binding/index.cjs
@@ -1042,11 +1042,13 @@ module.exports.resetNativeMemoryStats = nativeBinding.resetNativeMemoryStats;
 module.exports.resolveTsconfig = nativeBinding.resolveTsconfig;
 module.exports.shutdownAsyncRuntime = nativeBinding.shutdownAsyncRuntime;
 module.exports.startAsyncRuntime = nativeBinding.startAsyncRuntime;
+module.exports.analyzeMigrationSource = nativeBinding.analyzeMigrationSource;
 module.exports.detectWorkspace = nativeBinding.detectWorkspace;
 module.exports.downloadPackageManager = nativeBinding.downloadPackageManager;
 module.exports.ensureBlockingStdio = nativeBinding.ensureBlockingStdio;
 module.exports.getVpDirs = nativeBinding.getVpDirs;
 module.exports.hasConfigKey = nativeBinding.hasConfigKey;
+module.exports.isDirectoryGitignored = nativeBinding.isDirectoryGitignored;
 module.exports.mergeJsonConfig = nativeBinding.mergeJsonConfig;
 module.exports.mergeTsdownConfig = nativeBinding.mergeTsdownConfig;
 module.exports.parseConfigArgs = nativeBinding.parseConfigArgs;
diff --git a/packages/cli/binding/index.d.cts b/packages/cli/binding/index.d.cts
index 7f299cbfce..97416fff3f 100644
--- a/packages/cli/binding/index.d.cts
+++ b/packages/cli/binding/index.d.cts
@@ -3477,6 +3477,9 @@ export interface ViteImportGlobMeta {
   isSubImportsPattern?: boolean;
 }
 
+/** Parse source and resolve lexical bindings for the TypeScript migration rules. */
+export declare function analyzeMigrationSource(filename: string, source: string): string;
+
 /** Error from batch import rewriting */
 export interface BatchRewriteError {
   /** The file path that had an error */
@@ -3657,6 +3660,9 @@ export interface HooksArgs {
   hooksDir?: string;
 }
 
+/** Check inherited `.gitignore` rules without requiring the directory to exist. */
+export declare function isDirectoryGitignored(root: string, directory: string): boolean;
+
 /** Execution context after command dispatch selects the working directory. */
 export interface JsCommandContext {
   cwd: string;
diff --git a/packages/cli/binding/src/migration.rs b/packages/cli/binding/src/migration.rs
index 6c1be38630..25ad469086 100644
--- a/packages/cli/binding/src/migration.rs
+++ b/packages/cli/binding/src/migration.rs
@@ -3,6 +3,19 @@ use std::path::Path;
 use napi::{anyhow, bindgen_prelude::*};
 use napi_derive::napi;
 
+/// Parse source and resolve lexical bindings for the TypeScript migration rules.
+#[napi]
+pub fn analyze_migration_source(filename: String, source: String) -> Result<String> {
+    vp_migration::analyze_migration_source(&filename, &source).map_err(Error::from_reason)
+}
+
+/// Check inherited `.gitignore` rules without requiring the directory to exist.
+#[napi]
+pub fn is_directory_gitignored(root: String, directory: String) -> Result<bool> {
+    Ok(vp_migration::is_directory_gitignored(Path::new(&root), Path::new(&directory))
+        .map_err(anyhow::Error::from)?)
+}
+
 /// Rewrite scripts json content using rules from rules_yaml
 ///
 /// # Arguments
diff --git a/packages/cli/build.ts b/packages/cli/build.ts
index 2b191848c1..299c4af950 100644
--- a/packages/cli/build.ts
+++ b/packages/cli/build.ts
@@ -31,6 +31,7 @@ import { format } from 'oxfmt';
 
 import { generateLicenseFile } from '../../scripts/generate-license.js';
 import corePkg from '../core/package.json' with { type: 'json' };
+import { VITEST_VERSION } from './src/utils/constants.ts';
 
 const projectDir = dirname(fileURLToPath(import.meta.url));
 const TEST_PACKAGE_NAME = 'vitest';
@@ -46,16 +47,12 @@ const UTC_BUILD_TIME_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$/;
 const BROWSER_PROVIDER_PACKAGES: ReadonlyArray<{ pkg: string; short: string }> = [
   { pkg: '@vitest/browser-playwright', short: 'playwright' },
   { pkg: '@vitest/browser-preview', short: 'preview' },
-  { pkg: '@vitest/browser-webdriverio', short: 'webdriverio' },
 ];
 
 // Plugin shim entries: each `@vitest/*` package/subpath projected under
 // `./test/plugins/<name>` to restore the surface that the removed
 // `@voidzero-dev/vite-plus-test` wrapper previously exposed.
 const PLUGIN_SHIM_ENTRIES: ReadonlyArray<readonly [importSpecifier: string, pluginName: string]> = [
-  ['@vitest/runner', 'runner'],
-  ['@vitest/runner/utils', 'runner-utils'],
-  ['@vitest/runner/types', 'runner-types'],
   ['@vitest/utils', 'utils'],
   ['@vitest/utils/source-map', 'utils-source-map'],
   ['@vitest/utils/source-map/node', 'utils-source-map-node'],
@@ -69,7 +66,6 @@ const PLUGIN_SHIM_ENTRIES: ReadonlyArray<readonly [importSpecifier: string, plug
   ['@vitest/utils/constants', 'utils-constants'],
   ['@vitest/utils/diff', 'utils-diff'],
   ['@vitest/spy', 'spy'],
-  ['@vitest/expect', 'expect'],
   ['@vitest/snapshot', 'snapshot'],
   ['@vitest/snapshot/environment', 'snapshot-environment'],
   ['@vitest/snapshot/manager', 'snapshot-manager'],
@@ -86,7 +82,6 @@ const PLUGIN_SHIM_ENTRIES: ReadonlyArray<readonly [importSpecifier: string, plug
   ['@vitest/browser/client', 'browser-client'],
   ['@vitest/browser/locators', 'browser-locators'],
   ['@vitest/browser-playwright', 'browser-playwright'],
-  ['@vitest/browser-webdriverio', 'browser-webdriverio'],
   ['@vitest/browser-preview', 'browser-preview'],
 ];
 
@@ -362,6 +357,9 @@ async function syncTestPackageExports() {
 
   // Read test package.json
   const testPkg = JSON.parse(await readFile(testPkgPath, 'utf-8'));
+  if (testPkg.version !== VITEST_VERSION) {
+    throw new Error(`Expected vitest@${VITEST_VERSION}, found ${testPkg.version}`);
+  }
   const testExports = testPkg.exports as Record<string, unknown>;
 
   // Clean up previous build
@@ -395,6 +393,15 @@ async function syncTestPackageExports() {
     }
   }
 
+  // Vitest v5 no longer re-exports the standalone mocker package. Keep this
+  // public migration target; the other removed entry points use node/runtime.
+  generatedExports['./test/mocker'] = await createShimForExport(
+    'mocker',
+    { types: './index.d.ts', default: './index.js' },
+    '@vitest/mocker',
+    testDistDir,
+  );
+
   // Private shims for `@vitest/browser` and `@vitest/browser/context`. These
   // are referenced as relative paths from the inlined browser-provider d.ts
   // shims so that `@vitest/browser` resolves through vite-plus's own pnpm-edge
@@ -494,9 +501,18 @@ async function syncTestPackageExports() {
   console.log('  Created ./test/browser-compat');
 
   for (const [importSpecifier, pluginName] of PLUGIN_SHIM_ENTRIES) {
+    const [scope, name, ...subpath] = importSpecifier.split('/');
+    const packageName = `${scope}/${name}`;
+    const packagePath = require.resolve(`${packageName}/package.json`, { paths: [projectDir] });
+    const packageJson = JSON.parse(await readFile(packagePath, 'utf8'));
+    const exportKey = subpath.length ? `./${subpath.join('/')}` : '.';
+    const exportValue = packageJson.exports?.[exportKey];
+    if (!exportValue) {
+      throw new Error(`Missing public export ${importSpecifier} for ./test/plugins/${pluginName}`);
+    }
     const shimExport = await createShimForExport(
       `plugins/${pluginName}`,
-      `${pluginName}.js`,
+      exportValue,
       importSpecifier,
       testDistDir,
     );
@@ -541,9 +557,12 @@ async function createBareBrowserShims(
     return result;
   }
   const browserPkg = JSON.parse(await readFile(browserPkgPath, 'utf-8'));
-  const browserPkgRoot = dirname(browserPkgPath);
   const browserExports = (browserPkg.exports ?? {}) as Record<string, unknown>;
 
+  // The base browser package already resolves through vite-plus's own dependency
+  // edge. Forward its declarations instead of copying them: relative helpers
+  // stay resolvable, and context aliases share the provider-augmented types.
+  // Keep declaration inlining scoped to provider packages.
   const bareSubpaths = ['./client', './context', './locators', './matchers', './utils'] as const;
   for (const sub of bareSubpaths) {
     const exportValue = browserExports[sub];
@@ -559,7 +578,6 @@ async function createBareBrowserShims(
       exportValue,
       importSpecifier,
       testDistDir,
-      { providerPkgRoot: browserPkgRoot },
     );
     if (shimExport) {
       result[cliPath] = shimExport;
@@ -1010,8 +1028,8 @@ async function writePrivateAtVitestBrowserShims(testDistDir: string): Promise<vo
  * migration rewrites `@vitest/browser-<provider>/context` →
  * `vite-plus/test/browser-<provider>/context`, Node ESM resolution fails with
  * ERR_PACKAGE_PATH_NOT_EXPORTED unless the export entry has a `default`/`import`
- * target. We re-export from `@vitest/browser/context` so the bundled
- * `@vitest/browser` (vite-plus's own pnpm-edge) is reached at runtime.
+ * target. Re-export from `vitest/browser`, the v5 virtual runtime entry.
+ * `@vitest/browser/context` now contains a context-error stub even in a browser.
  */
 async function ensureContextRuntimeShim(
   shimBaseName: string,
@@ -1028,7 +1046,7 @@ async function ensureContextRuntimeShim(
   const jsRelPath = `./dist/test/${shimBaseName}.js`;
   const jsAbsPath = join(testDistDir, `${shimBaseName}.js`);
   await mkdir(dirname(jsAbsPath), { recursive: true });
-  await writeFile(jsAbsPath, `export * from '@vitest/browser/context';\n`);
+  await writeFile(jsAbsPath, `export * from 'vitest/browser';\n`);
   entry.default = jsRelPath;
 }
 
@@ -1038,12 +1056,13 @@ async function ensureContextRuntimeShim(
  * Vitest's package.json only exposes `./browser` (mapped to `./test/browser`).
  * The migration rewrites `@vitest/browser/context` →
  * `vite-plus/test/browser/context`, so we add this path with both runtime and
- * type targets that re-export from `@vitest/browser/context`.
+ * type targets. Runtime imports use the v5 `vitest/browser` virtual module;
+ * types retain the upstream browser-context declarations and augmentations.
  */
 async function createBrowserContextExport(testDistDir: string): Promise<ExportValue> {
   const dir = join(testDistDir, 'browser');
   await mkdir(dir, { recursive: true });
-  await writeFile(join(dir, 'context.js'), `export * from '@vitest/browser/context';\n`);
+  await writeFile(join(dir, 'context.js'), `export * from 'vitest/browser';\n`);
   await writeFile(
     join(dir, 'context.d.ts'),
     `import '@vitest/browser/context';\nexport * from '@vitest/browser/context';\n`,
@@ -1169,6 +1188,10 @@ async function createShimForExport(
 
   const baseFileName = shimBaseName.includes('/') ? shimBaseName.split('/').pop()! : shimBaseName;
   const shimDirForFile = shimBaseName.includes('/') ? shimDir : distDir;
+  // Preserve the Vite+ browser-context aliases after v5 moved the virtual
+  // module. Keep the original type specifier for module augmentations.
+  const runtimeSpecifier =
+    testImportSpecifier === '@vitest/browser/context' ? 'vitest/browser' : testImportSpecifier;
 
   // Handle different export value formats
   if (typeof exportValue === 'string') {
@@ -1184,7 +1207,7 @@ async function createShimForExport(
     }
 
     const jsPath = join(shimDirForFile, `${baseFileName}.js`);
-    await writeFile(jsPath, `export * from '${testImportSpecifier}';\n`);
+    await writeFile(jsPath, `export * from '${runtimeSpecifier}';\n`);
     return { default: `./dist/test/${shimBaseName}.js` };
   }
 
@@ -1218,7 +1241,7 @@ async function createShimForExport(
 
     if (value.default && typeof value.default === 'string') {
       const jsPath = join(shimDirForFile, `${baseFileName}.js`);
-      await writeFile(jsPath, `export * from '${testImportSpecifier}';\n`);
+      await writeFile(jsPath, `export * from '${runtimeSpecifier}';\n`);
       (result as Record<string, string>).default = `./dist/test/${shimBaseName}.js`;
     }
 
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 1858179587..88d3e073ec 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -141,35 +141,14 @@
       "types": "./dist/test/internal/browser.d.ts",
       "default": "./dist/test/internal/browser.js"
     },
-    "./test/runners": {
-      "types": "./dist/test/runners.d.ts",
-      "default": "./dist/test/runners.js"
-    },
-    "./test/suite": {
-      "types": "./dist/test/suite.d.ts",
-      "default": "./dist/test/suite.js"
-    },
-    "./test/environments": {
-      "types": "./dist/test/environments.d.ts",
-      "default": "./dist/test/environments.js"
+    "./test/internal/traces": {
+      "default": "./dist/test/internal/traces.js"
     },
     "./test/config": {
       "types": "./dist/test/config.d.ts",
       "require": "./dist/test/config.cjs",
       "default": "./dist/test/config.js"
     },
-    "./test/coverage": {
-      "types": "./dist/test/coverage.d.ts",
-      "default": "./dist/test/coverage.js"
-    },
-    "./test/reporters": {
-      "types": "./dist/test/reporters.d.ts",
-      "default": "./dist/test/reporters.js"
-    },
-    "./test/snapshot": {
-      "types": "./dist/test/snapshot.d.ts",
-      "default": "./dist/test/snapshot.js"
-    },
     "./test/runtime": {
       "types": "./dist/test/runtime.d.ts",
       "default": "./dist/test/runtime.js"
@@ -178,6 +157,10 @@
       "types": "./dist/test/worker.d.ts",
       "default": "./dist/test/worker.js"
     },
+    "./test/mocker": {
+      "types": "./dist/test/mocker.d.ts",
+      "default": "./dist/test/mocker.js"
+    },
     "./test/browser-playwright": {
       "types": "./dist/test/browser-playwright.d.ts",
       "default": "./dist/test/browser-playwright.js"
@@ -210,22 +193,6 @@
       "types": "./dist/test/browser/providers/preview/context.d.ts",
       "default": "./dist/test/browser/providers/preview/context.js"
     },
-    "./test/browser-webdriverio": {
-      "types": "./dist/test/browser-webdriverio.d.ts",
-      "default": "./dist/test/browser-webdriverio.js"
-    },
-    "./test/browser/providers/webdriverio": {
-      "types": "./dist/test/browser/providers/webdriverio.d.ts",
-      "default": "./dist/test/browser/providers/webdriverio.js"
-    },
-    "./test/browser-webdriverio/context": {
-      "types": "./dist/test/browser-webdriverio/context.d.ts",
-      "default": "./dist/test/browser-webdriverio/context.js"
-    },
-    "./test/browser/providers/webdriverio/context": {
-      "types": "./dist/test/browser/providers/webdriverio/context.d.ts",
-      "default": "./dist/test/browser/providers/webdriverio/context.js"
-    },
     "./test/browser/context": {
       "types": "./dist/test/browser/context.d.ts",
       "default": "./dist/test/browser/context.js"
@@ -252,109 +219,123 @@
       "types": "./dist/test/browser-compat.d.ts",
       "default": "./dist/test/browser-compat.js"
     },
-    "./test/plugins/runner": {
-      "default": "./dist/test/plugins/runner.js"
-    },
-    "./test/plugins/runner-utils": {
-      "default": "./dist/test/plugins/runner-utils.js"
-    },
-    "./test/plugins/runner-types": {
-      "default": "./dist/test/plugins/runner-types.js"
-    },
     "./test/plugins/utils": {
+      "types": "./dist/test/plugins/utils.d.ts",
       "default": "./dist/test/plugins/utils.js"
     },
     "./test/plugins/utils-source-map": {
+      "types": "./dist/test/plugins/utils-source-map.d.ts",
       "default": "./dist/test/plugins/utils-source-map.js"
     },
     "./test/plugins/utils-source-map-node": {
+      "types": "./dist/test/plugins/utils-source-map-node.d.ts",
       "default": "./dist/test/plugins/utils-source-map-node.js"
     },
     "./test/plugins/utils-error": {
+      "types": "./dist/test/plugins/utils-error.d.ts",
       "default": "./dist/test/plugins/utils-error.js"
     },
     "./test/plugins/utils-helpers": {
+      "types": "./dist/test/plugins/utils-helpers.d.ts",
       "default": "./dist/test/plugins/utils-helpers.js"
     },
     "./test/plugins/utils-display": {
+      "types": "./dist/test/plugins/utils-display.d.ts",
       "default": "./dist/test/plugins/utils-display.js"
     },
     "./test/plugins/utils-timers": {
+      "types": "./dist/test/plugins/utils-timers.d.ts",
       "default": "./dist/test/plugins/utils-timers.js"
     },
     "./test/plugins/utils-offset": {
+      "types": "./dist/test/plugins/utils-offset.d.ts",
       "default": "./dist/test/plugins/utils-offset.js"
     },
     "./test/plugins/utils-resolver": {
+      "types": "./dist/test/plugins/utils-resolver.d.ts",
       "default": "./dist/test/plugins/utils-resolver.js"
     },
     "./test/plugins/utils-serialize": {
+      "types": "./dist/test/plugins/utils-serialize.d.ts",
       "default": "./dist/test/plugins/utils-serialize.js"
     },
     "./test/plugins/utils-constants": {
+      "types": "./dist/test/plugins/utils-constants.d.ts",
       "default": "./dist/test/plugins/utils-constants.js"
     },
     "./test/plugins/utils-diff": {
+      "types": "./dist/test/plugins/utils-diff.d.ts",
       "default": "./dist/test/plugins/utils-diff.js"
     },
     "./test/plugins/spy": {
+      "types": "./dist/test/plugins/spy.d.ts",
       "default": "./dist/test/plugins/spy.js"
     },
-    "./test/plugins/expect": {
-      "default": "./dist/test/plugins/expect.js"
-    },
     "./test/plugins/snapshot": {
+      "types": "./dist/test/plugins/snapshot.d.ts",
       "default": "./dist/test/plugins/snapshot.js"
     },
     "./test/plugins/snapshot-environment": {
+      "types": "./dist/test/plugins/snapshot-environment.d.ts",
       "default": "./dist/test/plugins/snapshot-environment.js"
     },
     "./test/plugins/snapshot-manager": {
+      "types": "./dist/test/plugins/snapshot-manager.d.ts",
       "default": "./dist/test/plugins/snapshot-manager.js"
     },
     "./test/plugins/mocker": {
+      "types": "./dist/test/plugins/mocker.d.ts",
       "default": "./dist/test/plugins/mocker.js"
     },
     "./test/plugins/mocker-node": {
+      "types": "./dist/test/plugins/mocker-node.d.ts",
       "default": "./dist/test/plugins/mocker-node.js"
     },
     "./test/plugins/mocker-browser": {
+      "types": "./dist/test/plugins/mocker-browser.d.ts",
       "default": "./dist/test/plugins/mocker-browser.js"
     },
     "./test/plugins/mocker-redirect": {
+      "types": "./dist/test/plugins/mocker-redirect.d.ts",
       "default": "./dist/test/plugins/mocker-redirect.js"
     },
     "./test/plugins/mocker-transforms": {
+      "types": "./dist/test/plugins/mocker-transforms.d.ts",
       "default": "./dist/test/plugins/mocker-transforms.js"
     },
     "./test/plugins/mocker-automock": {
+      "types": "./dist/test/plugins/mocker-automock.d.ts",
       "default": "./dist/test/plugins/mocker-automock.js"
     },
     "./test/plugins/mocker-register": {
+      "types": "./dist/test/plugins/mocker-register.d.ts",
       "default": "./dist/test/plugins/mocker-register.js"
     },
     "./test/plugins/pretty-format": {
+      "types": "./dist/test/plugins/pretty-format.d.ts",
       "default": "./dist/test/plugins/pretty-format.js"
     },
     "./test/plugins/browser": {
+      "types": "./dist/test/plugins/browser.d.ts",
       "default": "./dist/test/plugins/browser.js"
     },
     "./test/plugins/browser-context": {
+      "types": "./dist/test/plugins/browser-context.d.ts",
       "default": "./dist/test/plugins/browser-context.js"
     },
     "./test/plugins/browser-client": {
       "default": "./dist/test/plugins/browser-client.js"
     },
     "./test/plugins/browser-locators": {
+      "types": "./dist/test/plugins/browser-locators.d.ts",
       "default": "./dist/test/plugins/browser-locators.js"
     },
     "./test/plugins/browser-playwright": {
+      "types": "./dist/test/plugins/browser-playwright.d.ts",
       "default": "./dist/test/plugins/browser-playwright.js"
     },
-    "./test/plugins/browser-webdriverio": {
-      "default": "./dist/test/plugins/browser-webdriverio.js"
-    },
     "./test/plugins/browser-preview": {
+      "types": "./dist/test/plugins/browser-preview.d.ts",
       "default": "./dist/test/plugins/browser-preview.js"
     }
   },
@@ -370,10 +351,8 @@
     "@oxlint/plugins": "catalog:",
     "@vitest/browser": "catalog:",
     "@vitest/browser-preview": "catalog:",
-    "@vitest/expect": "catalog:",
     "@vitest/mocker": "catalog:",
     "@vitest/pretty-format": "catalog:",
-    "@vitest/runner": "catalog:",
     "@vitest/snapshot": "catalog:",
     "@vitest/spy": "catalog:",
     "@vitest/utils": "catalog:",
@@ -413,7 +392,7 @@
   },
   "peerDependencies": {
     "@vitest/browser-playwright": "catalog:",
-    "@vitest/browser-webdriverio": "catalog:"
+    "@vitest/browser-webdriverio": "^5.0.0-beta.5 || >=5.0.0"
   },
   "peerDependenciesMeta": {
     "@vitest/browser-playwright": {
@@ -438,6 +417,6 @@
     ]
   },
   "engines": {
-    "node": "^20.19.0 || ^22.18.0 || >=24.11.0"
+    "node": "^22.18.0 || ^24.11.0 || >=26.0.0"
   }
 }
diff --git a/packages/cli/src/__tests__/__snapshots__/exports-map.spec.ts.snap b/packages/cli/src/__tests__/__snapshots__/exports-map.spec.ts.snap
new file mode 100644
index 0000000000..dbfa15c7bc
--- /dev/null
+++ b/packages/cli/src/__tests__/__snapshots__/exports-map.spec.ts.snap
@@ -0,0 +1,66 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`package.json exports map > keeps the reviewed Vitest v5 export surface 1`] = `
+[
+  "./test",
+  "./test/browser",
+  "./test/browser-compat",
+  "./test/browser-playwright",
+  "./test/browser-playwright/context",
+  "./test/browser-preview",
+  "./test/browser-preview/context",
+  "./test/browser/context",
+  "./test/browser/providers/playwright",
+  "./test/browser/providers/playwright/context",
+  "./test/browser/providers/preview",
+  "./test/browser/providers/preview/context",
+  "./test/client",
+  "./test/config",
+  "./test/context",
+  "./test/globals",
+  "./test/import-meta",
+  "./test/importMeta",
+  "./test/internal/browser",
+  "./test/internal/traces",
+  "./test/jsdom",
+  "./test/locators",
+  "./test/matchers",
+  "./test/mocker",
+  "./test/node",
+  "./test/optional-runtime-types.js",
+  "./test/optional-types.js",
+  "./test/plugins/browser",
+  "./test/plugins/browser-client",
+  "./test/plugins/browser-context",
+  "./test/plugins/browser-locators",
+  "./test/plugins/browser-playwright",
+  "./test/plugins/browser-preview",
+  "./test/plugins/mocker",
+  "./test/plugins/mocker-automock",
+  "./test/plugins/mocker-browser",
+  "./test/plugins/mocker-node",
+  "./test/plugins/mocker-redirect",
+  "./test/plugins/mocker-register",
+  "./test/plugins/mocker-transforms",
+  "./test/plugins/pretty-format",
+  "./test/plugins/snapshot",
+  "./test/plugins/snapshot-environment",
+  "./test/plugins/snapshot-manager",
+  "./test/plugins/spy",
+  "./test/plugins/utils",
+  "./test/plugins/utils-constants",
+  "./test/plugins/utils-diff",
+  "./test/plugins/utils-display",
+  "./test/plugins/utils-error",
+  "./test/plugins/utils-helpers",
+  "./test/plugins/utils-offset",
+  "./test/plugins/utils-resolver",
+  "./test/plugins/utils-serialize",
+  "./test/plugins/utils-source-map",
+  "./test/plugins/utils-source-map-node",
+  "./test/plugins/utils-timers",
+  "./test/runtime",
+  "./test/utils",
+  "./test/worker",
+]
+`;
diff --git a/packages/cli/src/__tests__/define-config-plugins.spec.ts b/packages/cli/src/__tests__/define-config-plugins.spec.ts
index b9b10b70b3..0967e04fc7 100644
--- a/packages/cli/src/__tests__/define-config-plugins.spec.ts
+++ b/packages/cli/src/__tests__/define-config-plugins.spec.ts
@@ -7,6 +7,7 @@ import {
   checkCoverageProviderVersion,
   computeAutoInlineList,
   defineConfig,
+  defineProject,
   resolveCoverageProviderToCheck,
 } from '../define-config.ts';
 import { VITEST_VERSION } from '../utils/constants.ts';
@@ -38,6 +39,7 @@ describe('defineConfig project plugin injection', () => {
       test: {
         projects: [
           {
+            extends: false,
             plugins: [existing],
             test: { name: 'unit', include: ['test/unit/**/*.spec.ts'], environment: 'node' },
           },
@@ -58,6 +60,7 @@ describe('defineConfig project plugin injection', () => {
   it('injects plugins into the return value of a function-shaped project entry', () => {
     const existing: Plugin = { name: 'user-fn-project-plugin' };
     const projectFn = () => ({
+      extends: false,
       plugins: [existing],
       test: { name: 'nuxt', environment: 'happy-dom' as const },
     });
@@ -93,6 +96,7 @@ describe('defineConfig project plugin injection', () => {
       test: {
         projects: [
           {
+            extends: false,
             test: { name: 'no-plugins', environment: 'node' },
           },
         ],
@@ -106,6 +110,60 @@ describe('defineConfig project plugin injection', () => {
     expect(pluginName(project.plugins[1])).toBe(AUTO_INLINE_PLUGIN_NAME);
     expect(pluginName(project.plugins[2])).toBe(COVERAGE_GUARD_PLUGIN_NAME);
   });
+
+  it.each([undefined, true])('inherits root plugins with extends %s', (extendsRoot) => {
+    const userPlugin = { name: 'user-project' };
+    const project = { extends: extendsRoot, plugins: [userPlugin], test: { name: 'unit' } };
+    const config = defineConfig({ test: { projects: [project] } });
+    expect(config.test?.projects?.[0]).toBe(project);
+    expect(project.plugins).toEqual([userPlugin]);
+  });
+
+  it('resolves inheritance for async functions and promise projects', async () => {
+    const inherited = { test: { name: 'inherited' } };
+    const config = defineConfig({
+      test: {
+        projects: [
+          async () => inherited,
+          Promise.resolve({ extends: false, test: { name: 'independent' } }),
+        ],
+      },
+    });
+    const [fn, promise] = config.test!.projects!;
+    expect(typeof fn).toBe('function');
+    if (typeof fn !== 'function') {
+      throw new Error('Expected project function');
+    }
+    expect(await fn({ command: 'serve', mode: 'test' })).toBe(inherited);
+    const resolved = (await promise) as { plugins: unknown[] };
+    expect(resolved.plugins.map(pluginName)).toEqual([
+      RESOLVER_PLUGIN_NAME,
+      AUTO_INLINE_PLUGIN_NAME,
+      COVERAGE_GUARD_PLUGIN_NAME,
+    ]);
+  });
+
+  it('does not duplicate injected plugins when helpers are composed', () => {
+    const config = defineConfig(defineConfig({ plugins: [{ name: 'user' }] }));
+    expect(config.plugins!.map(pluginName)).toEqual([
+      RESOLVER_PLUGIN_NAME,
+      AUTO_INLINE_PLUGIN_NAME,
+      COVERAGE_GUARD_PLUGIN_NAME,
+      'user',
+    ]);
+  });
+
+  it('injects nested independent projects in referenced defineProject configs', () => {
+    const config = defineProject({
+      test: {
+        projects: [{ extends: false, test: { name: 'child' } }, { test: { name: 'inherited' } }],
+      },
+    });
+    expect(config.plugins).toHaveLength(3);
+    const [independent, inherited] = config.test!.projects! as { plugins?: unknown[] }[];
+    expect(independent.plugins).toHaveLength(3);
+    expect(inherited.plugins).toBeUndefined();
+  });
 });
 
 const AUTO_INLINE_PLUGIN_NAME = 'vite-plus:auto-inline-matcher-deps';
diff --git a/packages/cli/src/__tests__/define-config-runtime-cache.spec.ts b/packages/cli/src/__tests__/define-config-runtime-cache.spec.ts
new file mode 100644
index 0000000000..44350efcd4
--- /dev/null
+++ b/packages/cli/src/__tests__/define-config-runtime-cache.spec.ts
@@ -0,0 +1,171 @@
+import { mkdirSync, mkdtempSync, readFileSync, realpathSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { resolveConfig, type UserConfig } from 'vite';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { AUTO_INLINE_DEPS, defineConfig } from '../define-config.ts';
+
+const probes = vi.hoisted(() => [] as { from: string; id: string }[]);
+
+vi.mock('node:module', async (importOriginal) => {
+  const actual = await importOriginal<typeof import('node:module')>();
+  return Object.assign({}, actual, {
+    createRequire(from: string | URL) {
+      const require = actual.createRequire(from);
+      const resolve = require.resolve;
+      require.resolve = Object.assign(
+        (id: string, options?: { paths?: string[] }) => {
+          probes.push({ from: String(from), id });
+          return resolve(id, options);
+        },
+        { paths: (id: string) => resolve.paths(id) },
+      );
+      return require;
+    },
+  });
+});
+
+vi.mock('node:fs', async (importOriginal) => {
+  const actual = await importOriginal<typeof import('node:fs')>();
+  return { ...actual, readFileSync: vi.fn(actual.readFileSync) };
+});
+
+function loadVitestConfig(root: string) {
+  return resolveConfig(
+    {
+      ...defineConfig({ root, environments: { __vitest__: {} } }),
+      configFile: false,
+    },
+    'serve',
+  );
+}
+
+describe('Vitest config runtime caches', () => {
+  let root: string;
+
+  beforeEach(() => {
+    root = realpathSync(mkdtempSync(join(tmpdir(), 'vp-config-cache-')));
+    probes.length = 0;
+  });
+
+  afterEach(() => rmSync(root, { recursive: true, force: true }));
+
+  function installMatcher(name: string) {
+    const directory = join(root, 'node_modules', name);
+    mkdirSync(directory, { recursive: true });
+    writeFileSync(join(directory, 'package.json'), JSON.stringify({ name, main: 'index.js' }));
+    writeFileSync(join(directory, 'index.js'), '');
+  }
+
+  function matcherProbes() {
+    return probes.filter(
+      ({ from, id }) => from === `${root}/package.json` && AUTO_INLINE_DEPS.includes(id),
+    );
+  }
+
+  it.each(['serve', 'build'] as const)(
+    'skips matcher detection in application %s configs even in test mode',
+    async (command) => {
+      installMatcher('jest-extended');
+      const config = await resolveConfig(
+        {
+          ...defineConfig({
+            root,
+            mode: 'test',
+            resolve: { noExternal: ['app-dependency'] },
+            test: { browser: { enabled: true } },
+          }),
+          configFile: false,
+        },
+        command,
+      );
+      expect(matcherProbes()).toEqual([]);
+      expect(config).not.toHaveProperty('test.server');
+      for (const environment of Object.values(config.environments)) {
+        expect(environment.resolve.noExternal).toEqual(['app-dependency']);
+      }
+    },
+  );
+
+  it('skips matcher detection in builds with a Vitest environment', async () => {
+    installMatcher('jest-extended');
+    const config = await resolveConfig(
+      {
+        ...defineConfig({ root, environments: { __vitest__: {} } }),
+        configFile: false,
+      },
+      'build',
+    );
+    expect(matcherProbes()).toEqual([]);
+    expect(config).not.toHaveProperty('test');
+  });
+
+  it('shares installed and missing package lookups across environment and resolved-config hooks', async () => {
+    installMatcher('jest-extended');
+    const config = await loadVitestConfig(root);
+    expect(matcherProbes().map(({ id }) => id)).toEqual(AUTO_INLINE_DEPS);
+    expect(config).toHaveProperty('test.server.deps.inline', ['jest-extended']);
+    for (const environment of Object.values(config.environments)) {
+      expect(environment.resolve.noExternal).toEqual(['jest-extended']);
+    }
+  });
+
+  it('refreshes missing package lookups when the same plugins reload the config', async () => {
+    const plugins = defineConfig({}).plugins;
+    const load = () =>
+      resolveConfig(
+        { root, plugins, configFile: false, environments: { __vitest__: {} } },
+        'serve',
+      );
+    const first = await load();
+    expect(first).not.toHaveProperty('test');
+    installMatcher('jest-extended');
+    const second = await load();
+    expect(second).toHaveProperty('test.server.deps.inline', ['jest-extended']);
+    expect(matcherProbes().map(({ id }) => id)).toEqual([...AUTO_INLINE_DEPS, ...AUTO_INLINE_DEPS]);
+  });
+
+  it('does not reuse installed packages for another project root', async () => {
+    installMatcher('jest-extended');
+    // Resolve the second project outside the first project's node_modules ancestry.
+    const secondRoot = realpathSync(mkdtempSync(join(tmpdir(), 'vp-config-other-')));
+    try {
+      const first = await loadVitestConfig(root);
+      const second = await loadVitestConfig(secondRoot);
+      expect(first).toHaveProperty('test.server.deps.inline', ['jest-extended']);
+      expect(second).not.toHaveProperty('test');
+      expect(
+        probes.filter(
+          ({ from, id }) => from === `${secondRoot}/package.json` && AUTO_INLINE_DEPS.includes(id),
+        ),
+      ).toHaveLength(3);
+    } finally {
+      rmSync(secondRoot, { recursive: true, force: true });
+    }
+  });
+
+  it('reads browser export metadata once across entry points and project configs', async () => {
+    const manifest = fileURLToPath(import.meta.resolve('vitest/package.json'));
+    vi.mocked(readFileSync).mockClear();
+    for (let index = 0; index < 2; index++) {
+      const config: UserConfig = {
+        root,
+        environments: { __vitest__: {} },
+        test: { browser: { enabled: true } },
+      };
+      const resolved = await resolveConfig({ ...defineConfig(config), configFile: false }, 'serve');
+      for (const id of ['vitest', 'vitest/internal/browser', 'vitest/internal/traces']) {
+        expect(resolved.resolve.alias).toContainEqual({
+          find: new RegExp(`^${id}$`),
+          replacement: fileURLToPath(import.meta.resolve(id)),
+        });
+      }
+    }
+    expect(vi.mocked(readFileSync).mock.calls.filter(([file]) => file === manifest)).toHaveLength(
+      1,
+    );
+  });
+});
diff --git a/packages/cli/src/__tests__/define-config-vitest-resolver.spec.ts b/packages/cli/src/__tests__/define-config-vitest-resolver.spec.ts
index 148f8e5604..1186a57e3c 100644
--- a/packages/cli/src/__tests__/define-config-vitest-resolver.spec.ts
+++ b/packages/cli/src/__tests__/define-config-vitest-resolver.spec.ts
@@ -1,6 +1,7 @@
 import { fileURLToPath } from 'node:url';
 
-import type { Plugin } from 'vite';
+import { preview } from '@vitest/browser-preview';
+import { resolveConfig, type Alias, type ConfigEnv, type Plugin, type UserConfig } from 'vite';
 import { describe, expect, it } from 'vitest';
 
 import { defineConfig, defineProject, isVitestFamilySpecifier } from '../define-config.ts';
@@ -42,8 +43,17 @@ describe('isVitestFamilySpecifier', () => {
     expect(isVitestFamilySpecifier('@vitest/browser/context')).toBe(true);
   });
 
-  it('matches `@vitest/expect`', () => {
-    expect(isVitestFamilySpecifier('@vitest/expect')).toBe(true);
+  it.each([
+    '@vitest/expect',
+    '@vitest/runner',
+    '@vitest/ws-client',
+    '@vitest/istanbul-lib-coverage',
+    '@vitest/istanbul-lib-instrument',
+    '@vitest/future-package',
+    '@vitest/browser-webdriverio',
+    '@vitest/browser-webdriverio/context',
+  ])('leaves %s on the project dependency edge', (name) => {
+    expect(isVitestFamilySpecifier(name)).toBe(false);
   });
 
   it('matches a queried subpath (query stripped before matching)', () => {
@@ -76,6 +86,113 @@ describe('isVitestFamilySpecifier', () => {
 });
 
 describe('vitePlusVitestResolverPlugin', () => {
+  it.each(['serve', 'build'] as const)(
+    'leaves application dependencies unchanged during %s with browser tests configured',
+    async (command) => {
+      const config = await resolveConfig(
+        {
+          ...defineConfig({
+            mode: 'test',
+            logLevel: 'silent',
+            resolve: { alias: { 'app-alias': '/custom/app' } },
+            test: { browser: { enabled: true, provider: preview() } },
+          }),
+          configFile: false,
+        },
+        command,
+      );
+      // The test process has VITEST set. Neither that variable nor mode=test
+      // makes this application's Vite config a Vitest-owned server.
+      for (const id of ['magic-string', 'chai', 'vitest', '@testing-library/dom']) {
+        expect(
+          config.resolve.alias.some(({ find }) =>
+            typeof find === 'string' ? find === id : find.test(id),
+          ),
+        ).toBe(false);
+      }
+      expect(config.resolve.alias).toContainEqual({
+        find: 'app-alias',
+        replacement: '/custom/app',
+      });
+    },
+  );
+
+  it('does not add browser aliases to builds even with a Vitest environment', () => {
+    const plugin = findPlugin(defineConfig({}).plugins, RESOLVER_PLUGIN_NAME)!;
+    const hook = (plugin.config as { handler: (config: UserConfig, env: ConfigEnv) => void })
+      .handler;
+    const config: UserConfig = {
+      environments: { __vitest__: {} },
+      test: { browser: { enabled: true } },
+    };
+    hook(config, { command: 'build', mode: 'test' });
+    expect(config.resolve).toBeUndefined();
+  });
+
+  it('anchors Preview optimizer dependencies without changing other providers', () => {
+    const plugin = findPlugin(defineConfig({}).plugins, RESOLVER_PLUGIN_NAME)!;
+    const hook = (plugin.config as { handler: (config: UserConfig, env: ConfigEnv) => void })
+      .handler;
+    const config: UserConfig = {
+      environments: { __vitest__: {} },
+      test: {
+        browser: {
+          enabled: true,
+          provider: preview(),
+        },
+      },
+    };
+    hook(config, { command: 'serve', mode: 'test' });
+    const aliases = config.resolve!.alias as Alias[];
+    expect(aliases).toHaveLength(9);
+    for (const id of ['@testing-library/user-event', '@testing-library/dom']) {
+      const replacement = aliases.find(({ find }) => (find as RegExp).test(id))?.replacement;
+      expect(replacement?.replaceAll('\\', '/')).toContain(id);
+    }
+    hook(config, { command: 'serve', mode: 'test' });
+    expect(config.resolve!.alias).toHaveLength(9);
+  });
+
+  it('anchors browser optimizer entries to the bundled ESM runtime', () => {
+    const plugin = findPlugin(defineConfig({}).plugins, RESOLVER_PLUGIN_NAME)!;
+    const hook = (plugin.config as { handler: (config: UserConfig, env: ConfigEnv) => void })
+      .handler;
+    const config: UserConfig = {
+      environments: { __vitest__: {} },
+      test: { browser: { enabled: true } },
+    };
+    hook(config, { command: 'serve', mode: 'test' });
+    const aliases = config.resolve!.alias as Alias[];
+    expect(aliases).toHaveLength(7);
+    for (const id of ['vitest', 'vitest/internal/browser', 'vitest/internal/traces']) {
+      expect(aliases.find(({ find }) => (find as RegExp).test(id))?.replacement).toBe(
+        fileURLToPath(import.meta.resolve(id)),
+      );
+    }
+    hook(config, { command: 'serve', mode: 'test' });
+    expect(config.resolve!.alias).toHaveLength(7);
+  });
+
+  it('preserves explicit browser aliases and leaves Node-only configs unchanged', () => {
+    const plugin = findPlugin(defineConfig({}).plugins, RESOLVER_PLUGIN_NAME)!;
+    const hook = (plugin.config as { handler: (config: UserConfig, env: ConfigEnv) => void })
+      .handler;
+    const config: UserConfig = {
+      environments: { __vitest__: {} },
+      resolve: { alias: { vitest: '/custom/vitest' } },
+      test: { browser: { enabled: true } },
+    };
+    hook(config, { command: 'serve', mode: 'test' });
+    expect((config.resolve!.alias as Alias[])[0]).toEqual({
+      find: 'vitest',
+      replacement: '/custom/vitest',
+    });
+    expect(config.resolve!.alias).toHaveLength(5);
+    const nodeOnly: UserConfig = { environments: { __vitest__: {} }, test: {} };
+    hook(nodeOnly, { command: 'serve', mode: 'test' });
+    expect(nodeOnly).toEqual({ environments: { __vitest__: {} }, test: {} });
+  });
+
   it('is injected into the root plugins array as an enforce:pre plugin with resolveId', () => {
     const result = defineConfig({}) as { plugins: unknown[] };
     const plugin = findPlugin(result.plugins, RESOLVER_PLUGIN_NAME);
@@ -86,13 +203,17 @@ describe('vitePlusVitestResolverPlugin', () => {
     expect(typeof plugin?.resolveId).toBe('function');
   });
 
-  it('is injected into each `test.projects` entry (before user plugins)', () => {
+  it('is injected into independent `test.projects` entries', () => {
     const existing: Plugin = { name: 'user-project-plugin' };
     const result = defineConfig({
       test: {
         projects: [
-          { test: { name: 'unit', environment: 'node' } },
-          { plugins: [existing], test: { name: 'browser', environment: 'jsdom' } },
+          { extends: false, test: { name: 'unit', environment: 'node' } },
+          {
+            extends: './base.config.ts',
+            plugins: [existing],
+            test: { name: 'browser', environment: 'jsdom' },
+          },
         ],
       },
     }) as { test: { projects: unknown[] } };
@@ -167,6 +288,50 @@ function makeCtx(resolveFor: (call: ResolveCall) => ResolveResult): {
   return { ctx, calls };
 }
 
+describe('workspace test API identity', () => {
+  function resolver(command: 'serve' | 'build', vitestServer: boolean): ResolveId {
+    const plugin = findPlugin(defineConfig({}).plugins, RESOLVER_PLUGIN_NAME)!;
+    const hook = (plugin.config as { handler: (config: UserConfig, env: ConfigEnv) => void })
+      .handler;
+    hook(vitestServer ? { environments: { __vitest__: {} } } : {}, { command, mode: 'test' });
+    return plugin.resolveId as ResolveId;
+  }
+
+  it('routes the wrapper through Vitest rather than the child package dependency tree', async () => {
+    const resolveId = resolver('serve', true);
+    const runnerApi = '/workspace/root-vitest/dist/index.js';
+    const { ctx, calls } = makeCtx(({ id, fromProject }) =>
+      id === 'vitest' && fromProject ? { id: runnerApi } : null,
+    );
+    expect(idOf(await resolveId.call(ctx, 'vite-plus/test', PROJECT_IMPORTER, {}))).toBe(runnerApi);
+    expect(calls).toEqual([{ id: 'vitest', importer: PROJECT_IMPORTER, fromProject: true }]);
+  });
+
+  it.each([
+    ['serve', false],
+    ['build', false],
+    ['build', true],
+  ] as const)(
+    'does not redirect application imports during %s (Vitest: %s)',
+    async (command, active) => {
+      const resolveId = resolver(command, active);
+      const { ctx, calls } = makeCtx(() => ({ id: '/should/not/be/used' }));
+      expect(await resolveId.call(ctx, 'vite-plus/test', PROJECT_IMPORTER, {})).toBeNull();
+      expect(calls).toEqual([]);
+    },
+  );
+
+  it.each(['vite-plus', 'vite-plus/testing', 'vite-plus/test?raw', 'vite-plus/test/browser'])(
+    'leaves %s on its existing resolution path',
+    async (id) => {
+      const resolveId = resolver('serve', true);
+      const { ctx, calls } = makeCtx(() => ({ id: '/should/not/be/used' }));
+      expect(await resolveId.call(ctx, id, PROJECT_IMPORTER, {})).toBeNull();
+      expect(calls).toEqual([]);
+    },
+  );
+});
+
 describe('vitePlusVitestResolverPlugin resolveId (bundle-first)', () => {
   // The runner `vp test` spawns is the Vitest bundled with vite-plus (see
   // resolve-test.ts). For the run to use a SINGLE physical Vitest, every
@@ -189,19 +354,19 @@ describe('vitePlusVitestResolverPlugin resolveId (bundle-first)', () => {
 
   it('tries the vite-plus anchor then the vitest anchor for the nested @vitest/* family', async () => {
     const resolveId = getResolveId();
-    const VITEST_ANCHORED = '/bundled/.pnpm/vitest/node_modules/@vitest/expect/dist/index.js';
+    const VITEST_ANCHORED = '/bundled/.pnpm/vitest/node_modules/@vitest/mocker/dist/index.js';
     let anchorProbes = 0;
     const { ctx, calls } = makeCtx(({ fromProject }) => {
       if (fromProject) {
-        return { id: '/fake/project/node_modules/@vitest/expect/dist/index.js' };
+        return { id: '/fake/project/node_modules/@vitest/mocker/dist/index.js' };
       }
       anchorProbes += 1;
-      // vite-plus anchor misses (@vitest/expect is a dep of vitest, not vite-plus);
+      // Simulate a layout in which only the second bundled anchor resolves it;
       // the second (vitest) anchor resolves it.
       return anchorProbes >= 2 ? { id: VITEST_ANCHORED } : null;
     });
 
-    const id = idOf(await resolveId.call(ctx, '@vitest/expect', PROJECT_IMPORTER, {}));
+    const id = idOf(await resolveId.call(ctx, '@vitest/mocker', PROJECT_IMPORTER, {}));
 
     expect(id).toBe(VITEST_ANCHORED);
     expect(anchorProbes).toBe(2);
diff --git a/packages/cli/src/__tests__/exports-map.spec.ts b/packages/cli/src/__tests__/exports-map.spec.ts
index 5c1d76510c..520dd7198e 100644
--- a/packages/cli/src/__tests__/exports-map.spec.ts
+++ b/packages/cli/src/__tests__/exports-map.spec.ts
@@ -16,6 +16,7 @@ import { createRequire } from 'node:module';
 import path from 'node:path';
 import url from 'node:url';
 
+import ts from 'typescript';
 import { describe, expect, it } from 'vitest';
 
 const cliPkgDir = path.resolve(path.dirname(url.fileURLToPath(import.meta.url)), '../..');
@@ -34,7 +35,165 @@ function namedValueExports(mod: Record<string, unknown>): string[] {
   return Object.keys(mod).filter((key) => key !== 'default');
 }
 
+function typeDiagnostics(source: string, separator: string = path.sep): string[] {
+  const filename = path.join(cliPkgDir, '__test_exports__.mts').replaceAll(/[\\/]/g, separator);
+  const options: ts.CompilerOptions = {
+    noEmit: true,
+    strict: true,
+    skipLibCheck: true,
+    types: [],
+    module: ts.ModuleKind.NodeNext,
+    target: ts.ScriptTarget.ESNext,
+  };
+  const host = ts.createCompilerHost(options);
+  const getSourceFile = host.getSourceFile.bind(host);
+  host.getSourceFile = (file, ...args) =>
+    file.replaceAll('\\', '/') === filename.replaceAll('\\', '/')
+      ? ts.createSourceFile(file, source, ts.ScriptTarget.ESNext, true)
+      : getSourceFile(file, ...args);
+  const program = ts.createProgram([filename], options, host);
+  return ts
+    .getPreEmitDiagnostics(program)
+    .map((d) => ts.flattenDiagnosticMessageText(d.messageText, '\n'));
+}
+
 describe('package.json exports map', () => {
+  it('provides the bundled Vitest Vite peer without relying on project dependencies', () => {
+    const pkg = JSON.parse(fs.readFileSync(cliPkgJsonPath, 'utf8'));
+    expect(pkg.dependencies.vite).toBe('workspace:@voidzero-dev/vite-plus-core@*');
+    expect(pkg.devDependencies.vite).toBeUndefined();
+  });
+
+  it('keeps the reviewed Vitest v5 export surface', () => {
+    const pkg = JSON.parse(fs.readFileSync(cliPkgJsonPath, 'utf8'));
+    expect(
+      Object.keys(pkg.exports)
+        .filter((key) => key === './test' || key.startsWith('./test/'))
+        .toSorted(),
+    ).toMatchSnapshot();
+  });
+
+  it('resolves every runtime test export under Node ESM conditions', () => {
+    const pkg = JSON.parse(fs.readFileSync(cliPkgJsonPath, 'utf8'));
+    for (const [key, value] of Object.entries(pkg.exports as Record<string, ExportConditions>)) {
+      if (!(key === './test' || key.startsWith('./test/')) || (!value.default && !value.import)) {
+        continue;
+      }
+      const resolved = import.meta.resolve(`vite-plus${key.slice(1)}`);
+      expect(fs.existsSync(url.fileURLToPath(resolved)), key).toBe(true);
+    }
+  });
+
+  it.each(['/', '\\'])('compiles all typed test exports with %s path separators', (separator) => {
+    const pkg = JSON.parse(fs.readFileSync(cliPkgJsonPath, 'utf8'));
+    const entries = Object.entries(pkg.exports as Record<string, ExportConditions>).filter(
+      ([key, entry]) =>
+        (key === './test' || key.startsWith('./test/')) &&
+        (entry.types || (isConditionObject(entry.import) && entry.import.types)),
+    );
+    const source =
+      entries
+        .map(([key], index) => `import type * as E${index} from 'vite-plus${key.slice(1)}';`)
+        .join('\n') +
+      `
+import { expect } from 'vite-plus/test';
+declare module 'vite-plus/test' {
+  interface Matchers<R extends void | Promise<void> = void | Promise<void>, T = unknown> {
+    toMatchReceived(expected: T): R;
+  }
+}
+const synchronous: void = expect(42).toMatchReceived(42);
+const asynchronous: Promise<void> = expect(Promise.resolve(42)).resolves.toMatchReceived(42);
+// @ts-expect-error The received type is number, not string.
+expect(42).toMatchReceived('42');
+// @ts-expect-error An asynchronous matcher does not return void.
+const invalidReturn: void = expect(Promise.resolve(42)).resolves.toMatchReceived(42);
+`;
+    expect(typeDiagnostics(source, separator)).toEqual([]);
+  });
+
+  it('loads browser matchers without another browser entry masking missing declarations', () => {
+    expect(
+      typeDiagnostics(`
+import 'vite-plus/test/matchers';
+import { expect } from 'vite-plus/test';
+expect(document.body).toBeInTheDocument();
+expect(document.body).toHaveFocus();
+expect(document.body).toHaveAttribute('id', 'app');
+// @ts-expect-error Attribute names must be strings.
+expect(document.body).toHaveAttribute(123);
+`),
+    ).toEqual([]);
+  });
+
+  it.each([
+    'browser',
+    'context',
+    'browser/context',
+    'plugins/browser-context',
+    'browser-playwright/context',
+    'browser-preview/context',
+    'browser/providers/playwright/context',
+    'browser/providers/preview/context',
+  ])('preserves provider augmentations and role types through %s independently', (name) => {
+    // Do not import the other aliases here: their augmentations can hide a
+    // broken declaration. Provider options and roles must retain their types.
+    expect(
+      typeDiagnostics(`
+import 'vite-plus/test/browser-playwright';
+import { page, type UserEventClickOptions } from 'vite-plus/test/${name}';
+declare const click: UserEventClickOptions;
+const force: boolean | undefined = click.force;
+await page.getByRole('button').screenshot({ caret: 'hide' });
+// @ts-expect-error Roles accept strings, not numbers.
+page.getByRole(123);
+// @ts-expect-error Playwright's force option must remain a boolean.
+const invalidClick: UserEventClickOptions = { force: 'yes' };
+`),
+    ).toEqual([]);
+  });
+
+  it('resolves every relative import in generated test declarations', () => {
+    const directory = path.join(cliPkgDir, 'dist/test');
+    const options = { module: ts.ModuleKind.NodeNext };
+    for (const name of fs.readdirSync(directory, { recursive: true, encoding: 'utf8' })) {
+      if (!/\.d\.(?:ts|mts|cts)$/.test(name)) {
+        continue;
+      }
+      const file = path.join(directory, name);
+      const source = fs.readFileSync(file, 'utf8');
+      for (const { fileName: specifier } of ts.preProcessFile(source).importedFiles) {
+        if (specifier.startsWith('.')) {
+          expect(
+            ts.resolveModuleName(specifier, file, options, ts.sys).resolvedModule,
+            `${name}: ${specifier}`,
+          ).toBeDefined();
+        }
+      }
+    }
+  });
+
+  it.each(['coverage', 'reporters', 'environments', 'snapshot'])(
+    'does not publish the removed %s alias',
+    (name) => {
+      const pkg = JSON.parse(fs.readFileSync(cliPkgJsonPath, 'utf8'));
+      expect(pkg.exports).not.toHaveProperty(`./test/${name}`);
+      expect(() => requireFromHere.resolve(`vite-plus/test/${name}`)).toThrow(
+        expect.objectContaining({ code: 'ERR_PACKAGE_PATH_NOT_EXPORTED' }),
+      );
+      for (const extension of ['js', 'd.ts']) {
+        expect(fs.existsSync(path.join(cliPkgDir, 'dist/test', `${name}.${extension}`))).toBe(
+          false,
+        );
+      }
+    },
+  );
+
+  it('keeps the standalone mocker migration target', () => {
+    const source = fs.readFileSync(path.join(cliPkgDir, 'dist/test/mocker.js'), 'utf8');
+    expect(source).toBe("export * from '@vitest/mocker';\n");
+  });
+
   it('every dual-condition entry emits `require` before `default`', () => {
     const pkg = JSON.parse(fs.readFileSync(cliPkgJsonPath, 'utf-8'));
     const exports = pkg.exports as Record<string, unknown>;
@@ -63,6 +222,27 @@ describe('package.json exports map', () => {
     expect(offenders, 'entries with require ordered after default').toEqual([]);
   });
 
+  it.each([
+    'browser/context',
+    'context',
+    'plugins/browser-context',
+    'browser-preview/context',
+    'browser-playwright/context',
+  ])('routes the %s runtime alias to the v5 browser virtual module', (name) => {
+    expect(fs.readFileSync(path.join(cliPkgDir, 'dist/test', `${name}.js`), 'utf8')).toBe(
+      "export * from 'vitest/browser';\n",
+    );
+  });
+
+  it('retains the upstream optional WebDriverIO peer without public shims', () => {
+    const pkg = JSON.parse(fs.readFileSync(cliPkgJsonPath, 'utf8'));
+    expect(pkg.peerDependencies['@vitest/browser-webdriverio']).toBe(
+      requireFromHere('vitest/package.json').peerDependencies['@vitest/browser-webdriverio'],
+    );
+    expect(pkg.peerDependenciesMeta['@vitest/browser-webdriverio']).toEqual({ optional: true });
+    expect(Object.keys(pkg.exports).filter((name) => name.includes('webdriverio'))).toEqual([]);
+  });
+
   it('./test/config has both `require` and `default`, with `require` first', () => {
     const pkg = JSON.parse(fs.readFileSync(cliPkgJsonPath, 'utf-8'));
     const entry = (pkg.exports as Record<string, unknown>)['./test/config'];
diff --git a/packages/cli/src/__tests__/oxlint-plugin.spec.ts b/packages/cli/src/__tests__/oxlint-plugin.spec.ts
index 4a116a6730..daf47d4438 100644
--- a/packages/cli/src/__tests__/oxlint-plugin.spec.ts
+++ b/packages/cli/src/__tests__/oxlint-plugin.spec.ts
@@ -81,6 +81,18 @@ describe('oxlint plugin config defaults', () => {
 });
 
 describe('rewriteVitePlusImportSpecifier', () => {
+  it.each([
+    ['coverage', 'node'],
+    ['reporters', 'node'],
+    ['environments', 'runtime'],
+    ['snapshot', 'runtime'],
+  ])('migrates the legacy Vite+ %s alias to %s', (from, to) => {
+    const target = `vite-plus/test/${to}`;
+    expect(rewriteVitePlusImportSpecifier(`vite-plus/test/${from}`)).toBe(target);
+    expect(rewriteVitePlusImportSpecifier(target)).toBeNull();
+    expect(rewriteVitePlusImportSpecifier('vite-plus/test/mocker')).toBeNull();
+  });
+
   it('rewrites supported vite and vitest specifiers', () => {
     expect(rewriteVitePlusImportSpecifier('vite')).toBe('vite-plus');
     expect(rewriteVitePlusImportSpecifier('vite/client')).toBe('vite-plus/client');
@@ -107,8 +119,19 @@ describe('rewriteVitePlusImportSpecifier', () => {
     expect(rewriteVitePlusImportSpecifier('@vitest/browser-preview/provider')).toBe(
       'vite-plus/test/browser/providers/preview',
     );
-    expect(rewriteVitePlusImportSpecifier('@vitest/browser-webdriverio/provider')).toBe(
+    for (const suffix of ['', '/provider', '/context', '/future']) {
+      expect(rewriteVitePlusImportSpecifier(`@vitest/browser-webdriverio${suffix}`)).toBeNull();
+    }
+    for (const source of [
+      'vite-plus/test/browser-webdriverio',
       'vite-plus/test/browser/providers/webdriverio',
+      'vite-plus/test/plugins/browser-webdriverio',
+      'vitest/browser-webdriverio',
+    ]) {
+      expect(rewriteVitePlusImportSpecifier(source)).toBe('@vitest/browser-webdriverio');
+    }
+    expect(rewriteVitePlusImportSpecifier('vite-plus/test/browser-webdriverio/context')).toBe(
+      'vite-plus/test/browser/context',
     );
     expect(rewriteVitePlusImportSpecifier('@vitest/browser-playwright/locators')).toBeNull();
     // `vitest/package.json` must NOT be rewritten — `vite-plus` does not export
@@ -117,6 +140,20 @@ describe('rewriteVitePlusImportSpecifier', () => {
     expect(rewriteVitePlusImportSpecifier('vitest/package.json')).toBeNull();
     // ...but other `vitest/<sub>` specifiers still rewrite normally.
     expect(rewriteVitePlusImportSpecifier('vitest/node')).toBe('vite-plus/test/node');
+    expect(rewriteVitePlusImportSpecifier('vitest/coverage')).toBe('vite-plus/test/node');
+    expect(rewriteVitePlusImportSpecifier('vitest/reporters')).toBe('vite-plus/test/node');
+    expect(rewriteVitePlusImportSpecifier('vitest/environments')).toBe('vite-plus/test/runtime');
+    expect(rewriteVitePlusImportSpecifier('vitest/snapshot')).toBe('vite-plus/test/runtime');
+    expect(rewriteVitePlusImportSpecifier('vitest/mocker')).toBe('vite-plus/test/mocker');
+    for (const subpath of [
+      'runners',
+      'suite',
+      'internal/module-runner',
+      'plugins/expect',
+      'unknown',
+    ]) {
+      expect(rewriteVitePlusImportSpecifier(`vitest/${subpath}`)).toBeNull();
+    }
     expect(rewriteVitePlusImportSpecifier('tsx')).toBeNull();
   });
 
diff --git a/packages/cli/src/define-config.ts b/packages/cli/src/define-config.ts
index 0e78fb0347..6bc1a10a16 100644
--- a/packages/cli/src/define-config.ts
+++ b/packages/cli/src/define-config.ts
@@ -1,10 +1,11 @@
 import { readFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
+import { resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 import type { OxfmtConfig } from 'oxfmt';
 import type { OxlintConfig } from 'oxlint';
-import type { PluginOption, UserConfig } from 'vite';
+import type { Alias, Plugin, PluginOption, UserConfig } from 'vite';
 import {
   defineConfig as viteDefineConfig,
   defineProject as viteDefineProject,
@@ -21,6 +22,7 @@ import type { PackUserConfig } from './pack.ts';
 import type { RunConfig } from './run-config.ts';
 import type { StagedConfig } from './staged-config.ts';
 import { CONFIG_METADATA_ENV, VITEST_VERSION } from './utils/constants.ts';
+import { VITEST_RESOLVER_PACKAGES } from './utils/vitest-ecosystem.ts';
 
 declare module 'vite' {
   interface UserConfig {
@@ -148,10 +150,9 @@ const vitePlusModuleFile = fileURLToPath(import.meta.url);
 
 /**
  * Absolute path to the bundled `vitest` package's `package.json`, used as a
- * second `this.resolve` importer. The nested `@vitest/*` family (`@vitest/expect`,
- * `@vitest/runner`, `@vitest/snapshot`, …) are dependencies of `vitest` itself —
- * not direct deps of `vite-plus` — so under pnpm's isolated layout they are
- * reachable from `vitest`'s location but not from [[vitePlusModuleFile]].
+ * second `this.resolve` importer. Supported transitive packages can be
+ * reachable from `vitest`'s location but not from [[vitePlusModuleFile]]
+ * under pnpm's isolated layout.
  * Resolving `package.json` is condition-agnostic, so this is safe with
  * `require.resolve`. Cached; `null` once an attempt has failed so we never retry.
  */
@@ -168,6 +169,30 @@ function getVitestAnchor(): string | null {
   return vitestAnchor;
 }
 
+// The bundled manifest is fixed for this module's lifetime. Share it across
+// browser entry points and project configs, just like the cached package path.
+let vitestExports: Record<string, unknown> | undefined;
+function getVitestImportTarget(id: string): string {
+  const anchor = getVitestAnchor();
+  if (!anchor) {
+    throw new Error('Cannot resolve the bundled Vitest package. Reinstall vite-plus.');
+  }
+  vitestExports ??= (
+    JSON.parse(readFileSync(anchor, 'utf8')) as {
+      exports: Record<string, unknown>;
+    }
+  ).exports;
+  let target = vitestExports[id === 'vitest' ? '.' : `.${id.slice('vitest'.length)}`];
+  while (target && typeof target === 'object') {
+    const conditions = target as Record<string, unknown>;
+    target = conditions.import ?? conditions.default;
+  }
+  if (typeof target !== 'string' || !target.startsWith('./')) {
+    throw new Error(`The bundled Vitest has no ESM export for ${id}.`);
+  }
+  return resolve(anchor, '..', target);
+}
+
 /**
  * Match the `vitest` / `@vitest/*` family of bare specifiers — the imports a
  * browser-mode Vite dev server must resolve. Any query string is stripped
@@ -180,12 +205,9 @@ export function isVitestFamilySpecifier(id: string): boolean {
   if (bare.startsWith('.') || bare.startsWith('/') || bare.startsWith('\0')) {
     return false;
   }
-  return (
-    bare === 'vitest' ||
-    bare.startsWith('vitest/') ||
-    bare === '@vitest/browser' ||
-    bare.startsWith('@vitest/')
-  );
+  const segments = bare.split('/');
+  const packageName = bare.startsWith('@') ? segments.slice(0, 2).join('/') : segments[0];
+  return VITEST_RESOLVER_PACKAGES.has(packageName);
 }
 
 /**
@@ -195,10 +217,10 @@ export function isVitestFamilySpecifier(id: string): boolean {
  * and `@vitest/browser` are transitive deps. pnpm's isolated layout only
  * exposes a package's *direct* deps, so the browser-mode Vite dev server
  * (rooted at the consumer project) cannot resolve `vitest/internal/browser`,
- * `@vitest/expect`, etc. Non-browser tests are unaffected — vitest's own
+ * `@vitest/mocker`, etc. Non-browser tests are unaffected — vitest's own
  * module runner handles resolution there.
  *
- * This plugin re-resolves the `vitest` / `@vitest/*` family through Vite's OWN
+ * This plugin re-resolves the explicit Vitest runtime allowlist through Vite's OWN
  * resolver, but ROOTED at `vite-plus`'s location ([[vitePlusModuleFile]]) and
  * then the bundled `vitest`'s location ([[getVitestAnchor]]) BEFORE the
  * project. So every such import binds to the same physical (pinned) Vitest that
@@ -239,10 +261,96 @@ export function isVitestFamilySpecifier(id: string): boolean {
  *     [[vitePlusCoverageVersionGuardPlugin]] fails fast on a mismatch instead.
  */
 function vitePlusVitestResolverPlugin(): PluginOption {
+  let isVitestServer = false;
   return {
     name: 'vite-plus:vitest-resolver',
     enforce: 'pre',
+    config: {
+      order: 'post',
+      handler(config, { command }) {
+        // Vitest adds this environment before post config hooks, including for
+        // programmatic runners and child projects. A browser test config alone
+        // must not redirect application dependencies during `vp dev` or `vp build`.
+        isVitestServer = command === 'serve' && !!config.environments?.['__vitest__'];
+        if (!isVitestServer || !config.test?.browser?.enabled) {
+          return;
+        }
+        // The browser optimizer resolves forced includes with an alias-only
+        // resolver, without user resolveId hooks. Keep its runtime entry points
+        // on the same graph as the browser runner in isolated installs.
+        const aliases = config.resolve?.alias;
+        const entries: Alias[] = Array.isArray(aliases)
+          ? [...aliases]
+          : Object.entries(aliases ?? {}).map(([find, replacement]) => ({ find, replacement }));
+        const runtimeRequire = createRequire(getVitestAnchor()!);
+        const targets = new Map(
+          [
+            'vitest',
+            'vitest/internal/browser',
+            'vitest/internal/traces',
+            'expect-type',
+            'magic-string',
+            'chai',
+            'vite/module-runner',
+          ].map((id) => [
+            id,
+            id.startsWith('vitest') ? getVitestImportTarget(id) : runtimeRequire.resolve(id),
+          ]),
+        );
+        if (config.test.browser.provider?.name === 'preview') {
+          const previewRequire = createRequire(vitePlusRequire.resolve('@vitest/browser-preview'));
+          // Preview's forced includes need the same isolated-layout fallback.
+          // These entries may be CommonJS; the browser optimizer converts them.
+          for (const id of ['@testing-library/user-event', '@testing-library/dom']) {
+            targets.set(id, previewRequire.resolve(id));
+          }
+        }
+        for (const [id, replacement] of targets) {
+          if (
+            entries.some(({ find }) =>
+              typeof find === 'string'
+                ? id === find || id.startsWith(`${find}/`)
+                : new RegExp(find).test(id),
+            )
+          ) {
+            continue;
+          }
+          entries.push({
+            find: new RegExp(`^${id}$`),
+            replacement,
+          });
+        }
+        config.resolve ??= {};
+        config.resolve.alias = entries;
+      },
+    },
+    configResolved(config) {
+      // Vite merges plugin arrays from inherited and referenced configs. Remove
+      // duplicate Vite+ hooks before it creates the server's plugin container.
+      const seen = new Set<string>();
+      const plugins = config.plugins as Plugin[];
+      const unique = plugins.filter((plugin) => {
+        if (!VITE_PLUS_TEST_PLUGIN_NAMES.has(plugin.name)) {
+          return true;
+        }
+        if (seen.has(plugin.name)) {
+          return false;
+        }
+        seen.add(plugin.name);
+        return true;
+      });
+      plugins.splice(0, plugins.length, ...unique);
+    },
     async resolveId(id, importer, options) {
+      if (isVitestServer && id === 'vite-plus/test') {
+        // pnpm can install separate vite-plus/Vitest peer instances for a
+        // workspace's root and children. Externalizing the child wrapper lets
+        // Node load its uninitialized runner state, bypassing Vite's hooks.
+        // Resolve the API before externalization through Vitest's own resolver:
+        // it selects the active runner (or the browser's optimized instance),
+        // not the Vitest copy next to this config's vite-plus installation.
+        return this.resolve('vitest', importer, { ...options, skipSelf: true });
+      }
       if (!isVitestFamilySpecifier(id)) {
         return null;
       }
@@ -284,10 +392,9 @@ function vitePlusVitestResolverPlugin(): PluginOption {
  * Absent packages are silently skipped so the server-deps optimizer never
  * tries to resolve a name that does not exist in the project's node_modules.
  *
- * The check is deferred to a `configResolved` plugin hook so that
- * `resolvedConfig.root` points at the actual project root (the value vite has
- * already normalised), rather than relying on `process.cwd()` at config-load
- * time (which can differ in workspace / monorepo setups).
+ * The environment hook adds installed packages to the module-runner options
+ * inherited by shared-server projects. The resolved-config hook also handles
+ * independent project servers, using each project's resolved root.
  *
  * Exported for unit testing.
  */
@@ -307,11 +414,13 @@ export const AUTO_INLINE_DEPS: ReadonlyArray<string> = [
  *
  * Exported for unit testing. The `_createRequire` parameter lets tests inject
  * a controlled resolver without needing to spy on Node's ESM module namespace.
+ * Callers may share installation results for the same root within one config load.
  */
 export function computeAutoInlineList(
   existingInline: (string | RegExp)[] | true | undefined,
   projectRoot: string,
   _createRequire: (from: string) => { resolve: (id: string) => string } = createRequire,
+  installedPackages = new Map<string, boolean>(),
 ): (string | RegExp)[] | null {
   // User opted into "inline everything" — don't touch.
   if (existingInline === true) {
@@ -319,7 +428,7 @@ export function computeAutoInlineList(
   }
   // Build a require resolver anchored at the project root so we only
   // inline packages that are actually installed there.
-  const projectRequire = _createRequire(`${projectRoot}/package.json`);
+  let projectRequire: ReturnType<typeof _createRequire> | undefined;
   // Start from a copy of the user-supplied array (or a fresh array when
   // none was provided) so the originating user-config object is not mutated.
   const merged: (string | RegExp)[] = Array.isArray(existingInline) ? [...existingInline] : [];
@@ -328,10 +437,18 @@ export function computeAutoInlineList(
     if (merged.some((entry) => entry === pkg || (entry instanceof RegExp && entry.test(pkg)))) {
       continue;
     }
-    try {
-      projectRequire.resolve(pkg);
-    } catch {
-      // Package not installed in the project — skip silently.
+    let installed = installedPackages.get(pkg);
+    if (installed === undefined) {
+      projectRequire ??= _createRequire(`${projectRoot}/package.json`);
+      try {
+        projectRequire.resolve(pkg);
+        installed = true;
+      } catch {
+        installed = false;
+      }
+      installedPackages.set(pkg, installed);
+    }
+    if (!installed) {
       continue;
     }
     merged.push(pkg);
@@ -345,33 +462,57 @@ export function computeAutoInlineList(
 }
 
 function vitePlusAutoInlineMatcherPlugin(): PluginOption {
+  let projectRoot = '';
+  let isVitestServer = false;
+  const installedByRoot = new Map<string, Map<string, boolean>>();
+  type TestConfig = Pick<VitestInlineConfig, 'server'>;
+  function inlineList(existing: (string | RegExp)[] | true | undefined, root: string) {
+    root = resolve(root);
+    let installed = installedByRoot.get(root);
+    if (!installed) {
+      installed = new Map();
+      installedByRoot.set(root, installed);
+    }
+    return computeAutoInlineList(existing, root, createRequire, installed);
+  }
   return {
     name: 'vite-plus:auto-inline-matcher-deps',
     enforce: 'pre',
+    config: {
+      order: 'post',
+      handler(config, { command }) {
+        isVitestServer = command === 'serve' && !!config.environments?.['__vitest__'];
+        projectRoot = resolve(config.root ?? '.');
+        // Reuse positive and negative lookups across environments and the
+        // resolved-config hook, but refresh them when Vite reloads the config.
+        installedByRoot.clear();
+      },
+    },
+    configEnvironment(_name, config) {
+      if (!isVitestServer) {
+        return;
+      }
+      const existing = config.resolve?.noExternal;
+      const merged = inlineList(
+        typeof existing === 'string' || existing instanceof RegExp ? [existing] : existing,
+        projectRoot,
+      );
+      if (merged !== null) {
+        config.resolve ??= {};
+        config.resolve.noExternal = merged;
+      }
+    },
     configResolved(resolvedConfig) {
-      // Access the vitest test config via the augmented field. Vitest augments
-      // vite's `UserConfig` but not `ResolvedConfig`, so we use `any` here.
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      const testConfig = (resolvedConfig as any).test as
-        | { server?: { deps?: { inline?: (string | RegExp)[] | true } } }
-        | undefined;
-      const merged = computeAutoInlineList(testConfig?.server?.deps?.inline, resolvedConfig.root);
-      if (merged === null) {
+      if (!isVitestServer) {
         return;
       }
-      // Mutate the resolved config so the finalised inline list is visible
-      // to vitest when it reads test.server.deps.inline.
-      if (!testConfig) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        (resolvedConfig as any).test = { server: { deps: { inline: merged } } };
-      } else {
-        if (!testConfig.server) {
-          testConfig.server = {};
-        }
-        if (!testConfig.server.deps) {
-          testConfig.server.deps = {};
-        }
-        testConfig.server.deps.inline = merged;
+      const config = resolvedConfig as { root: string; test?: TestConfig };
+      const merged = inlineList(config.test?.server?.deps?.inline, config.root);
+      if (merged !== null) {
+        config.test ??= {};
+        config.test.server ??= {};
+        config.test.server.deps ??= {};
+        config.test.server.deps.inline = merged;
       }
     },
   };
@@ -605,6 +746,26 @@ function vitePlusCoverageVersionGuardPlugin(): PluginOption {
  * an optional `test.server.deps.inline`), so a shared helper keeps the
  * wiring consistent.
  */
+const VITE_PLUS_TEST_PLUGIN_NAMES: ReadonlySet<string> = new Set([
+  'vite-plus:vitest-resolver',
+  'vite-plus:auto-inline-matcher-deps',
+  'vite-plus:coverage-version-guard',
+]);
+
+function withoutVitePlusTestPlugins(plugin: PluginOption): PluginOption {
+  if (Array.isArray(plugin)) {
+    return plugin.filter(keepUserPlugin).map(withoutVitePlusTestPlugins);
+  }
+  if (plugin instanceof Promise) {
+    return plugin.then(withoutVitePlusTestPlugins);
+  }
+  return plugin && VITE_PLUS_TEST_PLUGIN_NAMES.has(plugin.name) ? false : plugin;
+}
+
+function keepUserPlugin(plugin: PluginOption): boolean {
+  return !plugin || !('name' in plugin) || !VITE_PLUS_TEST_PLUGIN_NAMES.has(plugin.name);
+}
+
 function injectPluginIntoInlineConfig<
   T extends {
     plugins?: UserConfig['plugins'];
@@ -617,16 +778,14 @@ function injectPluginIntoInlineConfig<
       vitePlusVitestResolverPlugin(),
       vitePlusAutoInlineMatcherPlugin(),
       vitePlusCoverageVersionGuardPlugin(),
-      ...(config.plugins ?? []),
+      ...(config.plugins ?? []).filter(keepUserPlugin).map(withoutVitePlusTestPlugins),
     ],
   };
 }
 
 /**
- * Walk `config.test?.projects` and inject the vite-plus plugins into each
- * project entry. Vitest spins up an independent Vite pipeline per project, so
- * root-level plugins do NOT propagate — without this, files matched by a
- * project's `include` glob never get the vitest resolver / auto-inline plugins.
+ * Inline projects inherit root plugins by default in Vitest v5. Only projects
+ * with inheritance disabled or an external base need their own injection.
  *
  * Entry shapes (from `TestProjectConfiguration`):
  *   - string  (glob path like `'./packages/*'`)  → passed through unchanged.
@@ -651,22 +810,30 @@ function injectPluginIntoProject(project: TestProjectConfiguration): TestProject
     const wrapped: UserProjectConfigFn = (env: ConfigEnv) => {
       const result = project(env);
       if (result instanceof Promise) {
-        return result.then(injectPluginIntoInlineConfig);
+        return result.then(injectIndependentProject);
       }
-      return injectPluginIntoInlineConfig(result);
+      return injectIndependentProject(result);
     };
     return wrapped;
   }
   if (project instanceof Promise) {
-    return project.then(injectPluginIntoInlineConfig);
+    return project.then(injectIndependentProject);
   }
   if (typeof project === 'object' && project !== null) {
-    return injectPluginIntoInlineConfig(project);
+    return injectIndependentProject(project);
   }
   return project;
 }
 
-function injectPlugin(config: UserConfig): UserConfig {
+function injectIndependentProject(
+  config: UserWorkspaceConfig & { extends?: string | boolean },
+): UserWorkspaceConfig {
+  return config.extends === false || typeof config.extends === 'string'
+    ? injectPlugin(config)
+    : config;
+}
+
+function injectPlugin<T extends UserConfig>(config: T): T {
   const injected = injectPluginIntoInlineConfig(config);
   const projects = injected.test?.projects;
   if (!projects || projects.length === 0) {
@@ -709,23 +876,21 @@ export function defineConfig(config: ViteUserConfigExport): ViteUserConfigExport
 
 /**
  * Inject the vite-plus plugins into a `defineProject` export. A project config
- * (`UserWorkspaceConfig`) cannot itself nest `test.projects`, so this only
- * touches the top-level `plugins` array (no project recursion like
- * [[injectPluginIntoConfig]] does).
+ * (`UserWorkspaceConfig`) can itself declare nested projects in v5. Referenced
+ * configs own a Vite server, so inject at their root and apply inheritance rules
+ * to their inline children.
  */
 function injectPluginIntoProjectExport(config: UserProjectConfigExport): UserProjectConfigExport {
   if (typeof config === 'function') {
     return (env: ConfigEnv) => {
       const result = config(env);
-      return result instanceof Promise
-        ? result.then(injectPluginIntoInlineConfig)
-        : injectPluginIntoInlineConfig(result);
+      return result instanceof Promise ? result.then(injectPlugin) : injectPlugin(result);
     };
   }
   if (config instanceof Promise) {
-    return config.then(injectPluginIntoInlineConfig);
+    return config.then(injectPlugin);
   }
-  return injectPluginIntoInlineConfig(config);
+  return injectPlugin(config);
 }
 
 /**
diff --git a/packages/cli/src/migration/__tests__/install-failure-guard.spec.ts b/packages/cli/src/migration/__tests__/install-failure-guard.spec.ts
index 6304c1f2fa..553c8a5a04 100644
--- a/packages/cli/src/migration/__tests__/install-failure-guard.spec.ts
+++ b/packages/cli/src/migration/__tests__/install-failure-guard.spec.ts
@@ -50,6 +50,25 @@ describe('migration install failure handling', () => {
   });
 
   describe('full migration path (executeMigrationPlan)', () => {
+    it('defers Vitest compatibility writes until all tool migration abort gates pass', () => {
+      const full = binSource.slice(
+        binSource.indexOf('async function executeMigrationPlan('),
+        binSource.indexOf('async function main('),
+      );
+      const existing = binSource.slice(binSource.indexOf('async function main('));
+      for (const branch of [full, existing]) {
+        expect(branch).not.toContain('applyVitestV5Migration(vitestV5Plan)');
+        const apply = branch.indexOf(
+          'vitestV5Plan = applyRefreshedVitestV5Migration(vitestV5Plan)',
+        );
+        expect(apply).toBeGreaterThan(branch.indexOf('ESLint migration failed.'));
+        expect(apply).toBeGreaterThan(branch.indexOf('Prettier migration failed.'));
+        expect(apply).toBeGreaterThan(branch.indexOf('Complete the tsup migration manually'));
+      }
+      expect(full.indexOf('applyRefreshedVitestV5Migration(vitestV5Plan)')).toBeGreaterThan(
+        full.indexOf('checkVitestVersion(workspaceInfo.rootDir)'),
+      );
+    });
     it('reconciles `finalInstallSummary` through `handleInstallResult`', () => {
       // The full-path final reinstall must run through the helper so a failed
       // install after manifest/source rewrites does not silently report a
diff --git a/packages/cli/src/migration/__tests__/migrator.spec.ts b/packages/cli/src/migration/__tests__/migrator.spec.ts
index 8ebde07548..60717febb9 100644
--- a/packages/cli/src/migration/__tests__/migrator.spec.ts
+++ b/packages/cli/src/migration/__tests__/migrator.spec.ts
@@ -724,12 +724,7 @@ describe('rewritePackageJson', () => {
     expect(pkg.devDependencies).toHaveProperty('vite', VITE_PLUS_OVERRIDE_PACKAGES.vite);
   });
 
-  it('keeps and normalizes @vitest/browser-webdriverio and ensures the webdriverio peer', async () => {
-    // Webdriverio is opt-in: vite-plus no longer bundles the provider, so the
-    // migration KEEPS the user's declared `@vitest/browser-webdriverio`
-    // (version-normalized to the bundled vitest version) and ensures its
-    // runtime framework peer `webdriverio`. `@vitest/browser` stays in
-    // REMOVE_PACKAGES and is still stripped.
+  it('preserves the community provider version without injecting its framework peer', async () => {
     const pkg = {
       devDependencies: {
         '@vitest/browser': '^4.0.0',
@@ -738,9 +733,8 @@ describe('rewritePackageJson', () => {
       },
     };
     rewritePackageJson(pkg, PackageManager.pnpm);
-    // Standalone (supportCatalog=false) → concrete pinned spec.
-    expect(pkg.devDependencies).toHaveProperty('@vitest/browser-webdriverio', VITEST_VERSION);
-    expect(pkg.devDependencies).toHaveProperty('webdriverio', '*');
+    expect(pkg.devDependencies).toHaveProperty('@vitest/browser-webdriverio', '^4.0.0');
+    expect(pkg.devDependencies).not.toHaveProperty('webdriverio');
     expect(pkg.devDependencies).not.toHaveProperty('@vitest/browser');
   });
 
@@ -1844,6 +1838,121 @@ function readYamlObject(filePath: string): Record<string, unknown> {
   return parseYaml(readYaml(filePath)) as Record<string, unknown>;
 }
 
+describe('WebDriverIO browser overrides', () => {
+  let tmpDir: string;
+  const provider = '@vitest/browser-webdriverio';
+  const browser = '@vitest/browser';
+  const managers = [
+    [PackageManager.pnpm, '10.33.0'],
+    [PackageManager.pnpm, '10.5.0'],
+    [PackageManager.pnpm, '9.4.0'],
+    [PackageManager.npm, '11.0.0'],
+    [PackageManager.yarn, '4.11.0'],
+    [PackageManager.bun, '1.3.11'],
+  ] as const;
+
+  beforeEach(() => {
+    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'vp-browser-override-'));
+  });
+  afterEach(() => {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+  });
+
+  function overrideFile(manager: PackageManager, version: string) {
+    return manager === PackageManager.pnpm && pnpmSupportsWorkspaceSettings(version)
+      ? 'pnpm-workspace.yaml'
+      : 'package.json';
+  }
+  function overrideMap(pkg: Record<string, unknown>, manager: PackageManager, version: string) {
+    if (manager === PackageManager.pnpm && !pnpmSupportsWorkspaceSettings(version)) {
+      return (pkg.pnpm as { overrides: Record<string, string> }).overrides;
+    }
+    return pkg[manager === PackageManager.yarn ? 'resolutions' : 'overrides'] as Record<
+      string,
+      string
+    >;
+  }
+  function readOverrides(manager: PackageManager, version: string) {
+    const file = overrideFile(manager, version);
+    const pkg = file.endsWith('.yaml')
+      ? readYamlObject(path.join(tmpDir, file))
+      : readJson(path.join(tmpDir, file));
+    return overrideMap(pkg, manager, version);
+  }
+
+  it.each(managers)('adds and repairs the override on %s %s', (manager, version) => {
+    fs.writeFileSync(
+      path.join(tmpDir, 'package.json'),
+      JSON.stringify({
+        name: 'test',
+        devDependencies: { [provider]: '^5.2.0', [browser]: '5.0.0' },
+      }),
+    );
+    const workspace = makeWorkspaceInfo(tmpDir, manager, version);
+    rewriteStandaloneProject(tmpDir, workspace, true, true);
+    const key = manager === PackageManager.pnpm ? pnpmOverrideKey(browser) : browser;
+    expect(readOverrides(manager, version)[key]).toBe(VITEST_VERSION);
+    expect(
+      (readJson(path.join(tmpDir, 'package.json')).devDependencies as Record<string, string>)[
+        provider
+      ],
+    ).toBe('^5.2.0');
+    expect(detectVitePlusBootstrapPending(tmpDir, manager, [], version)).toBe(false);
+
+    // Only this override is stale: it must trigger existing-Vite+ reconciliation.
+    const file = path.join(tmpDir, overrideFile(manager, version));
+    const pkg = file.endsWith('.yaml') ? readYamlObject(file) : readJson(file);
+    overrideMap(pkg, manager, version)[key] = '5.0.0';
+    fs.writeFileSync(file, JSON.stringify(pkg));
+    expect(detectVitePlusBootstrapPending(tmpDir, manager, [], version)).toBe(true);
+    expect(ensureVitePlusBootstrap(workspace).changed).toBe(true);
+    expect(readOverrides(manager, version)[key]).toBe(VITEST_VERSION);
+    expect(detectVitePlusBootstrapPending(tmpDir, manager, [], version)).toBe(false);
+    expect(ensureVitePlusBootstrap(workspace).changed).toBe(false);
+  });
+
+  it.each(managers)('detects the provider in a workspace member on %s %s', (manager, version) => {
+    fs.mkdirSync(path.join(tmpDir, 'packages/browser'), { recursive: true });
+    fs.writeFileSync(
+      path.join(tmpDir, 'package.json'),
+      JSON.stringify({ name: 'root', workspaces: ['packages/*'] }),
+    );
+    fs.writeFileSync(
+      path.join(tmpDir, 'packages/browser/package.json'),
+      JSON.stringify({ name: 'browser', devDependencies: { [provider]: '5.0.0' } }),
+    );
+    const workspace = {
+      ...makeWorkspaceInfo(tmpDir, manager, version),
+      isMonorepo: true,
+      workspacePatterns: ['packages/*'],
+      packages: [{ name: 'browser', path: 'packages/browser' }],
+    };
+    rewriteMonorepo(workspace, true, true);
+    const key = manager === PackageManager.pnpm ? pnpmOverrideKey(browser) : browser;
+    expect(readOverrides(manager, version)[key]).toBe(VITEST_VERSION);
+    // Reconcile workspace package-manager fields, then check repeat-run stability.
+    ensureVitePlusBootstrap(workspace);
+    expect(readOverrides(manager, version)[key]).toBe(VITEST_VERSION);
+    expect(detectVitePlusBootstrapPending(tmpDir, manager, workspace.packages, version)).toBe(
+      false,
+    );
+    expect(ensureVitePlusBootstrap(workspace).changed).toBe(false);
+  });
+
+  it.each(managers)(
+    'does not add the override for standalone webdriverio on %s %s',
+    (manager, version) => {
+      fs.writeFileSync(
+        path.join(tmpDir, 'package.json'),
+        JSON.stringify({ name: 'test', devDependencies: { webdriverio: '^9' } }),
+      );
+      rewriteStandaloneProject(tmpDir, makeWorkspaceInfo(tmpDir, manager, version), true, true);
+      expect(readOverrides(manager, version)).not.toHaveProperty(browser);
+      expect(readOverrides(manager, version)).not.toHaveProperty(pnpmOverrideKey(browser));
+    },
+  );
+});
+
 describe('ensureVitePlusBootstrap', () => {
   let tmpDir: string;
 
@@ -5851,12 +5960,8 @@ describe('rewriteStandaloneProject pnpm workspace yaml', () => {
     // A provider-as-TARGET selector scoped under a SPECIFIC non-vite-plus parent
     // only constrains that parent's subtree, so it is PRESERVED.
     expect(yaml.overrides['some-app>@vitest/browser-playwright']).toBe('4.0.0');
-    // Webdriverio is opt-in: vite-plus keeps it in the user's deps pinned to the
-    // bundled vitest version, but a stale override pinning an old version would
-    // win over that direct dep and misalign the provider against bundled vitest —
-    // so the stale override is dropped too (the dep stays installed, the pin
-    // does not).
-    expect(yaml.overrides).not.toHaveProperty('@vitest/browser-webdriverio');
+    // Community provider overrides remain user-owned.
+    expect(yaml.overrides['@vitest/browser-webdriverio']).toBe('4.0.0');
     expect(yaml.overrides['some-other-pkg']).toBe('1.0.0');
     expect(yaml.overrides['unrelated>some-other-pkg']).toBe('1.0.0');
   });
@@ -5995,46 +6100,37 @@ describe('rewriteStandaloneProject pnpm workspace yaml', () => {
     });
   }
 
-  it('injects the webdriverio provider + peer from a source-only vitest config and allows driver builds', () => {
-    // Opt-in provider: vite-plus no longer bundles `@vitest/browser-webdriverio`.
-    // A project that imports it in source with NO declared dep must have the
-    // provider injected into its own deps (pinned to the bundled vitest version)
-    // plus the `webdriverio` framework peer, and the edgedriver/geckodriver
-    // postinstalls allowed.
+  it.each([
+    '@vitest/browser-webdriverio',
+    'vite-plus/test/browser-webdriverio',
+    'vite-plus/test/browser/providers/webdriverio',
+    'vite-plus/test/plugins/browser-webdriverio',
+    'vitest/browser-webdriverio',
+    'vitest/browser/providers/webdriverio',
+    'vitest/plugins/browser-webdriverio',
+  ])('restores %s without selecting a community provider version', (specifier) => {
     fs.writeFileSync(
       path.join(tmpDir, 'package.json'),
-      JSON.stringify({ name: 'test', devDependencies: { vite: '^7.0.0' } }),
+      JSON.stringify({
+        name: 'test',
+        devDependencies: { vite: '^7.0.0' },
+      }),
     );
     fs.writeFileSync(
-      path.join(tmpDir, 'vitest.config.ts'),
-      [
-        "import { webdriverio } from '@vitest/browser-webdriverio';",
-        "import { defineConfig } from 'vite-plus';",
-        'export default defineConfig({',
-        '  test: { browser: { enabled: true, provider: webdriverio() } },',
-        '});',
-        '',
-      ].join('\n'),
+      path.join(tmpDir, 'vite.config.ts'),
+      "import { webdriverio } from '" + specifier + "';\nexport default {};\n",
     );
     rewriteStandaloneProject(tmpDir, makeWorkspaceInfo(tmpDir, PackageManager.pnpm), true, true);
-
-    const devDeps = readJson(path.join(tmpDir, 'package.json')).devDependencies as Record<
-      string,
-      string
-    >;
-    // The injected provider follows the same catalog as the managed Vitest
-    // dependency, and the catalog owns its concrete bundled version.
-    expect(devDeps).toHaveProperty('@vitest/browser-webdriverio', 'catalog:');
-    expect(devDeps.webdriverio).toBe('*');
-    expect(devDeps.vitest).toBe('catalog:');
-
-    const yaml = readYamlObject(path.join(tmpDir, 'pnpm-workspace.yaml')) as {
-      allowBuilds: Record<string, boolean>;
+    const pkg = readJson(path.join(tmpDir, 'package.json'));
+    expect(pkg.devDependencies).not.toHaveProperty('@vitest/browser-webdriverio');
+    expect(pkg.devDependencies).not.toHaveProperty('webdriverio');
+    expect(fs.readFileSync(path.join(tmpDir, 'vite.config.ts'), 'utf8')).toContain(
+      "from '@vitest/browser-webdriverio'",
+    );
+    const workspace = readYamlObject(path.join(tmpDir, 'pnpm-workspace.yaml')) as {
       catalog: Record<string, string>;
     };
-    expect(yaml.catalog['@vitest/browser-webdriverio']).toBe(VITEST_VERSION);
-    expect(yaml.allowBuilds.edgedriver).toBe(true);
-    expect(yaml.allowBuilds.geckodriver).toBe(true);
+    expect(workspace.catalog).not.toHaveProperty('@vitest/browser-webdriverio');
   });
 
   it('injects the playwright provider + peer from a source-only vitest config', () => {
@@ -6077,9 +6173,6 @@ describe('rewriteStandaloneProject pnpm workspace yaml', () => {
     ['playwright', 'browser-playwright'],
     ['playwright', 'browser/providers/playwright'],
     ['playwright', 'plugins/browser-playwright'],
-    ['webdriverio', 'browser-webdriverio'],
-    ['webdriverio', 'browser/providers/webdriverio'],
-    ['webdriverio', 'plugins/browser-webdriverio'],
   ] as const)(
     'injects the %s provider before rewriting the legacy vitest/%s import',
     (provider, subpath) => {
@@ -6215,90 +6308,7 @@ describe('rewriteStandaloneProject pnpm workspace yaml', () => {
     expect(workspace.catalog['@vitest/browser-playwright']).toBe(VITEST_VERSION);
   });
 
-  it('injects the webdriverio provider on a re-run from the migrated provider-subpath import', () => {
-    // Re-running migration on an ALREADY-migrated project: the import rewriter
-    // maps `@vitest/browser-webdriverio/provider` to
-    // `vite-plus/test/browser/providers/webdriverio`, so an already-migrated
-    // source can contain that subpath form (not just `vite-plus/test/browser-
-    // webdriverio`). The webdriverio source scan must recognize it, or the re-run
-    // would skip injecting the (no-longer-bundled) provider and the import would
-    // break under pnpm strict / Yarn PnP.
-    fs.writeFileSync(
-      path.join(tmpDir, 'package.json'),
-      JSON.stringify({ name: 'test', devDependencies: { vite: '^7.0.0' } }),
-    );
-    fs.writeFileSync(
-      path.join(tmpDir, 'vitest.config.ts'),
-      [
-        "import { webdriverio } from 'vite-plus/test/browser/providers/webdriverio';",
-        "import { defineConfig } from 'vite-plus';",
-        'export default defineConfig({',
-        '  test: { browser: { enabled: true, provider: webdriverio() } },',
-        '});',
-        '',
-      ].join('\n'),
-    );
-    rewriteStandaloneProject(tmpDir, makeWorkspaceInfo(tmpDir, PackageManager.pnpm), true, true);
-
-    const devDeps = readJson(path.join(tmpDir, 'package.json')).devDependencies as Record<
-      string,
-      string
-    >;
-    expect(devDeps).toHaveProperty('@vitest/browser-webdriverio', 'catalog:');
-    expect(devDeps.webdriverio).toBe('*');
-    const yaml = readYamlObject(path.join(tmpDir, 'pnpm-workspace.yaml')) as {
-      allowBuilds: Record<string, boolean>;
-      catalog: Record<string, string>;
-    };
-    expect(yaml.catalog['@vitest/browser-webdriverio']).toBe(VITEST_VERSION);
-    expect(yaml.allowBuilds.edgedriver).toBe(true);
-    expect(yaml.allowBuilds.geckodriver).toBe(true);
-  });
-
-  it('injects the webdriverio provider from a source-only import of the plugin shim', () => {
-    // `vite-plus/test/plugins/browser-webdriverio` is a generated shim that
-    // re-exports `@vitest/browser-webdriverio` wholesale, so importing it uses
-    // the (now opt-in, no-longer-bundled) provider. A source-only import of it
-    // must still trigger provider+peer injection and driver-build allowance.
-    fs.writeFileSync(
-      path.join(tmpDir, 'package.json'),
-      JSON.stringify({ name: 'test', devDependencies: { vite: '^7.0.0' } }),
-    );
-    fs.writeFileSync(
-      path.join(tmpDir, 'vitest.config.ts'),
-      [
-        "import { webdriverio } from 'vite-plus/test/plugins/browser-webdriverio';",
-        "import { defineConfig } from 'vite-plus';",
-        'export default defineConfig({',
-        '  test: { browser: { enabled: true, provider: webdriverio() } },',
-        '});',
-        '',
-      ].join('\n'),
-    );
-    rewriteStandaloneProject(tmpDir, makeWorkspaceInfo(tmpDir, PackageManager.pnpm), true, true);
-
-    const devDeps = readJson(path.join(tmpDir, 'package.json')).devDependencies as Record<
-      string,
-      string
-    >;
-    expect(devDeps).toHaveProperty('@vitest/browser-webdriverio', 'catalog:');
-    expect(devDeps.webdriverio).toBe('*');
-    const yaml = readYamlObject(path.join(tmpDir, 'pnpm-workspace.yaml')) as {
-      allowBuilds: Record<string, boolean>;
-      catalog: Record<string, string>;
-    };
-    expect(yaml.catalog['@vitest/browser-webdriverio']).toBe(VITEST_VERSION);
-    expect(yaml.allowBuilds.edgedriver).toBe(true);
-    expect(yaml.allowBuilds.geckodriver).toBe(true);
-  });
-
   it('keeps a peer-only catalog webdriverio provider resolvable (no dangling catalog reference)', () => {
-    // A package declares the provider ONLY as a `peerDependencies` `catalog:`
-    // entry. The migration installs the provider into the user's own deps so the
-    // rewritten import resolves, but it must NOT delete the catalog entry the
-    // surviving peer still references — deleting it would dangle the `catalog:`
-    // spec and break the next install. (Catalog deletion uses REMOVE_PACKAGES,
-    // not the override-drop set, precisely so webdriverio entries are preserved.)
     fs.writeFileSync(
       path.join(tmpDir, 'package.json'),
       JSON.stringify({
@@ -6321,12 +6331,8 @@ describe('rewriteStandaloneProject pnpm workspace yaml', () => {
 
     const pkg = readJson(path.join(tmpDir, 'package.json'));
     const devDeps = pkg.devDependencies as Record<string, string>;
-    // Provider installed through the same catalog used by the managed Vitest
-    // dependency.
-    expect(devDeps).toHaveProperty('@vitest/browser-webdriverio', 'catalog:');
-    expect(devDeps.webdriverio).toBe('*');
-    // Peer-only declaration is left intact and its `catalog:` reference still
-    // resolves because the catalog entry is preserved (NOT deleted).
+    expect(devDeps).not.toHaveProperty('@vitest/browser-webdriverio');
+    expect(devDeps).not.toHaveProperty('webdriverio');
     expect((pkg.peerDependencies as Record<string, string>)['@vitest/browser-webdriverio']).toBe(
       'catalog:',
     );
@@ -6334,17 +6340,13 @@ describe('rewriteStandaloneProject pnpm workspace yaml', () => {
       catalog: Record<string, string>;
       allowBuilds: Record<string, boolean>;
     };
-    expect(yaml.catalog['@vitest/browser-webdriverio']).toBe(VITEST_VERSION);
+    expect(yaml.catalog['@vitest/browser-webdriverio']).toBe('4.0.0');
     expect(yaml.catalog.vitest).toBe(VITEST_VERSION);
     expect(yaml.allowBuilds.edgedriver).toBe(true);
     expect(yaml.allowBuilds.geckodriver).toBe(true);
   });
 
-  it('drops a stale npm @vitest/browser-webdriverio override that would conflict with the injected provider', () => {
-    // npm hard-fails with EOVERRIDE when an override pins the provider to a
-    // version different from the migrated direct dep. Because webdriverio is now
-    // KEPT/injected as a direct dep (not stripped), the migration must prune the
-    // stale `overrides` entry before injecting the bundled provider version.
+  it('preserves community WebDriverIO dependency versions and overrides', () => {
     fs.writeFileSync(
       path.join(tmpDir, 'package.json'),
       JSON.stringify({
@@ -6357,18 +6359,15 @@ describe('rewriteStandaloneProject pnpm workspace yaml', () => {
 
     const pkg = readJson(path.join(tmpDir, 'package.json'));
     const overrides = pkg.overrides as Record<string, string>;
-    // Stale provider override dropped (it would EOVERRIDE-conflict with the dep).
-    expect(overrides).not.toHaveProperty('@vitest/browser-webdriverio');
-    // Unrelated overrides preserved.
+    expect(overrides['@vitest/browser-webdriverio']).toBe('4.0.0');
     expect(overrides['some-other-pkg']).toBe('1.0.0');
-    // Provider normalized to the bundled vitest version, peer ensured.
     const devDeps = pkg.devDependencies as Record<string, string>;
-    expect(devDeps['@vitest/browser-webdriverio']).toBe(VITEST_VERSION);
-    expect(devDeps.webdriverio).toBe('*');
+    expect(devDeps['@vitest/browser-webdriverio']).toBe('^4.0.0');
+    expect(devDeps).not.toHaveProperty('webdriverio');
   });
 
   it('drops a stale npm @vitest/browser-playwright override that would conflict with the kept provider', () => {
-    // Same hazard as webdriverio: playwright is now opt-in and KEPT as a direct
+    // Playwright is opt-in and KEPT as a direct
     // dep (not stripped), so a stale `overrides` pin to a different version would
     // EOVERRIDE-conflict with the migrated bundled provider version. The
     // migration must prune it before normalizing the provider dep.
@@ -6391,7 +6390,7 @@ describe('rewriteStandaloneProject pnpm workspace yaml', () => {
     expect(devDeps.playwright).toBe('*');
   });
 
-  it('drops a stale @vitest/browser-webdriverio override pinned with a COMPARATOR range', () => {
+  it('drops a stale @vitest/browser-playwright override pinned with a COMPARATOR range', () => {
     // A `name@range` override key may use a semver comparator (`@>=4`, `@>4`,
     // `@<5`). The `>` MUST NOT be mistaken for a pnpm `parent>child` selector
     // (pnpm's own delimiter rule excludes a `>` preceded by `@`), or the key's
@@ -6402,9 +6401,9 @@ describe('rewriteStandaloneProject pnpm workspace yaml', () => {
       path.join(tmpDir, 'package.json'),
       JSON.stringify({
         name: 'test',
-        devDependencies: { vite: '^7.0.0', '@vitest/browser-webdriverio': '^4.0.0' },
+        devDependencies: { vite: '^7.0.0', '@vitest/browser-playwright': '^4.0.0' },
         overrides: {
-          '@vitest/browser-webdriverio@>=4': '4.0.0',
+          '@vitest/browser-playwright@>=4': '4.0.0',
           'some-other-pkg@>=1': '1.0.0',
         },
       }),
@@ -6413,42 +6412,42 @@ describe('rewriteStandaloneProject pnpm workspace yaml', () => {
 
     const pkg = readJson(path.join(tmpDir, 'package.json'));
     const overrides = pkg.overrides as Record<string, string>;
-    expect(overrides).not.toHaveProperty('@vitest/browser-webdriverio@>=4');
+    expect(overrides).not.toHaveProperty('@vitest/browser-playwright@>=4');
     // Unrelated comparator-range override preserved.
     expect(overrides['some-other-pkg@>=1']).toBe('1.0.0');
     const devDeps = pkg.devDependencies as Record<string, string>;
-    expect(devDeps['@vitest/browser-webdriverio']).toBe(VITEST_VERSION);
-    expect(devDeps.webdriverio).toBe('*');
+    expect(devDeps['@vitest/browser-playwright']).toBe(VITEST_VERSION);
+    expect(devDeps.playwright).toBe('*');
   });
 
-  it('drops a stale yarn @vitest/browser-webdriverio resolution that would force the wrong provider version', () => {
+  it('drops a stale yarn @vitest/browser-playwright resolution that would force the wrong provider version', () => {
     // Same hazard as npm, via yarn `resolutions`: a leftover pin would force the
     // stale provider over the migrated, bundled-vitest-aligned dep.
     fs.writeFileSync(
       path.join(tmpDir, 'package.json'),
       JSON.stringify({
         name: 'test',
-        devDependencies: { vite: '^7.0.0', '@vitest/browser-webdriverio': '^4.0.0' },
-        resolutions: { '@vitest/browser-webdriverio': '4.0.0', 'some-other-pkg': '1.0.0' },
+        devDependencies: { vite: '^7.0.0', '@vitest/browser-playwright': '^4.0.0' },
+        resolutions: { '@vitest/browser-playwright': '4.0.0', 'some-other-pkg': '1.0.0' },
       }),
     );
     rewriteStandaloneProject(tmpDir, makeWorkspaceInfo(tmpDir, PackageManager.yarn), true, true);
 
     const pkg = readJson(path.join(tmpDir, 'package.json'));
     const resolutions = pkg.resolutions as Record<string, string>;
-    expect(resolutions).not.toHaveProperty('@vitest/browser-webdriverio');
+    expect(resolutions).not.toHaveProperty('@vitest/browser-playwright');
     expect(resolutions['some-other-pkg']).toBe('1.0.0');
     const devDeps = pkg.devDependencies as Record<string, string>;
-    expect(devDeps['@vitest/browser-webdriverio']).toBe('catalog:');
-    expect(devDeps.webdriverio).toBe('*');
+    expect(devDeps['@vitest/browser-playwright']).toBe('catalog:');
+    expect(devDeps.playwright).toBe('*');
     // #2005: the catalog: ref is backed by a .yarnrc.yml catalog entry (not dangling).
     const yarnrc = readYamlObject(path.join(tmpDir, '.yarnrc.yml')) as {
       catalog?: Record<string, string>;
     };
-    expect(yarnrc.catalog?.['@vitest/browser-webdriverio']).toBe(VITEST_VERSION);
+    expect(yarnrc.catalog?.['@vitest/browser-playwright']).toBe(VITEST_VERSION);
   });
 
-  it('drops only global/glob/vite-plus-parent yarn SELECTOR-shaped @vitest/browser-webdriverio resolutions', () => {
+  it('drops only global/glob/vite-plus-parent yarn SELECTOR-shaped @vitest/browser-playwright resolutions', () => {
     // Yarn resolutions commonly use selector shapes (glob `**/pkg`, nested
     // `parent/pkg`). A pin is pruned only when it would reach vite-plus's OWN
     // direct provider dep — i.e. a versioned global pin, a NAME glob that matches
@@ -6462,19 +6461,19 @@ describe('rewriteStandaloneProject pnpm workspace yaml', () => {
       path.join(tmpDir, 'package.json'),
       JSON.stringify({
         name: 'test',
-        devDependencies: { vite: '^7.0.0', '@vitest/browser-webdriverio': '^4.0.0' },
+        devDependencies: { vite: '^7.0.0', '@vitest/browser-playwright': '^4.0.0' },
         resolutions: {
-          '**/@vitest/browser-webdriverio': '4.0.0',
-          'vite-*/@vitest/browser-webdriverio': '4.0.0',
-          'vite-plus/@vitest/browser-webdriverio': '4.0.0',
-          '**/vite-plus/@vitest/browser-webdriverio': '4.0.0',
-          'some-parent/@vitest/browser-webdriverio': '4.0.0',
-          'react-*/@vitest/browser-webdriverio': '4.0.0',
-          'parent@*/@vitest/browser-webdriverio': '4.0.0',
-          'parent@workspace:*/@vitest/browser-webdriverio': '4.0.0',
-          'some-parent/**/@vitest/browser-webdriverio': '4.0.0',
-          'some-parent/vite-*/@vitest/browser-webdriverio': '4.0.0',
-          '@vitest/browser-webdriverio@4': '4.0.0',
+          '**/@vitest/browser-playwright': '4.0.0',
+          'vite-*/@vitest/browser-playwright': '4.0.0',
+          'vite-plus/@vitest/browser-playwright': '4.0.0',
+          '**/vite-plus/@vitest/browser-playwright': '4.0.0',
+          'some-parent/@vitest/browser-playwright': '4.0.0',
+          'react-*/@vitest/browser-playwright': '4.0.0',
+          'parent@*/@vitest/browser-playwright': '4.0.0',
+          'parent@workspace:*/@vitest/browser-playwright': '4.0.0',
+          'some-parent/**/@vitest/browser-playwright': '4.0.0',
+          'some-parent/vite-*/@vitest/browser-playwright': '4.0.0',
+          '@vitest/browser-playwright@4': '4.0.0',
           '**/some-other-pkg': '1.0.0',
         },
       }),
@@ -6484,41 +6483,41 @@ describe('rewriteStandaloneProject pnpm workspace yaml', () => {
     const pkg = readJson(path.join(tmpDir, 'package.json'));
     const resolutions = pkg.resolutions as Record<string, string>;
     // Glob parent matches all parents (incl. vite-plus) — dropped.
-    expect(resolutions).not.toHaveProperty('**/@vitest/browser-webdriverio');
+    expect(resolutions).not.toHaveProperty('**/@vitest/browser-playwright');
     // Name glob that matches vite-plus — dropped.
-    expect(resolutions).not.toHaveProperty('vite-*/@vitest/browser-webdriverio');
+    expect(resolutions).not.toHaveProperty('vite-*/@vitest/browser-playwright');
     // Parent is literally vite-plus — dropped.
-    expect(resolutions).not.toHaveProperty('vite-plus/@vitest/browser-webdriverio');
+    expect(resolutions).not.toHaveProperty('vite-plus/@vitest/browser-playwright');
     // `**`-padded vite-plus reaches the root vite-plus edge — dropped.
-    expect(resolutions).not.toHaveProperty('**/vite-plus/@vitest/browser-webdriverio');
+    expect(resolutions).not.toHaveProperty('**/vite-plus/@vitest/browser-playwright');
     // Versioned global pin — dropped.
-    expect(resolutions).not.toHaveProperty('@vitest/browser-webdriverio@4');
+    expect(resolutions).not.toHaveProperty('@vitest/browser-playwright@4');
     // Scoped under a SPECIFIC non-vite-plus parent — PRESERVED (does not affect
     // vite-plus's own provider dep).
-    expect(resolutions['some-parent/@vitest/browser-webdriverio']).toBe('4.0.0');
+    expect(resolutions['some-parent/@vitest/browser-playwright']).toBe('4.0.0');
     // A name glob that does NOT match vite-plus — PRESERVED.
-    expect(resolutions['react-*/@vitest/browser-webdriverio']).toBe('4.0.0');
+    expect(resolutions['react-*/@vitest/browser-playwright']).toBe('4.0.0');
     // A wildcard RANGE on a specific parent is not a glob parent — PRESERVED.
-    expect(resolutions['parent@*/@vitest/browser-webdriverio']).toBe('4.0.0');
-    expect(resolutions['parent@workspace:*/@vitest/browser-webdriverio']).toBe('4.0.0');
+    expect(resolutions['parent@*/@vitest/browser-playwright']).toBe('4.0.0');
+    expect(resolutions['parent@workspace:*/@vitest/browser-playwright']).toBe('4.0.0');
     // A nested glob gated by a SPECIFIC non-vite-plus ancestor only constrains
     // that ancestor's subtree, NOT the root vite-plus edge — PRESERVED.
-    expect(resolutions['some-parent/**/@vitest/browser-webdriverio']).toBe('4.0.0');
-    expect(resolutions['some-parent/vite-*/@vitest/browser-webdriverio']).toBe('4.0.0');
+    expect(resolutions['some-parent/**/@vitest/browser-playwright']).toBe('4.0.0');
+    expect(resolutions['some-parent/vite-*/@vitest/browser-playwright']).toBe('4.0.0');
     // Unrelated selector resolutions survive.
     expect(resolutions['**/some-other-pkg']).toBe('1.0.0');
     const devDeps = pkg.devDependencies as Record<string, string>;
-    expect(devDeps['@vitest/browser-webdriverio']).toBe('catalog:');
-    expect(devDeps.webdriverio).toBe('*');
+    expect(devDeps['@vitest/browser-playwright']).toBe('catalog:');
+    expect(devDeps.playwright).toBe('*');
   });
 
   it('preserves yarn from/target resolutions that do NOT target the provider (yarn-grammar faithful)', () => {
     // A yarn `from/target` resolution key forces the TRAILING descriptor, not
     // the parent. Verified against @yarnpkg/parsers parseResolution:
-    //   `@vitest/browser-webdriverio@4/some-transitive-dep`
-    //       -> from=@vitest/browser-webdriverio@4, descriptor=some-transitive-dep
-    //   `@vitest/browser-webdriverio@npm:@other/fork@1.2.3`
-    //       -> from=@vitest/browser-webdriverio@npm:@other, descriptor=fork@1.2.3
+    //   `@vitest/browser-playwright@4/some-transitive-dep`
+    //       -> from=@vitest/browser-playwright@4, descriptor=some-transitive-dep
+    //   `@vitest/browser-playwright@npm:@other/fork@1.2.3`
+    //       -> from=@vitest/browser-playwright@npm:@other, descriptor=fork@1.2.3
     // Neither targets the provider, so neither may be pruned — dropping them
     // would silently delete an unrelated user resolution. (Yarn rejects keys
     // whose range embeds a `/`, e.g. `pkg@patch:…/…` or git/URL ranges, so those
@@ -6528,11 +6527,11 @@ describe('rewriteStandaloneProject pnpm workspace yaml', () => {
       path.join(tmpDir, 'package.json'),
       JSON.stringify({
         name: 'test',
-        devDependencies: { vite: '^7.0.0', '@vitest/browser-webdriverio': '^4.0.0' },
+        devDependencies: { vite: '^7.0.0', '@vitest/browser-playwright': '^4.0.0' },
         resolutions: {
-          '@vitest/browser-webdriverio@4/some-transitive-dep': '1.0.0',
-          '@vitest/browser-webdriverio@npm:@other/fork@1.2.3': '2.0.0',
-          '@vitest/browser-webdriverio': '4.0.0',
+          '@vitest/browser-playwright@4/some-transitive-dep': '1.0.0',
+          '@vitest/browser-playwright@npm:@other/fork@1.2.3': '2.0.0',
+          '@vitest/browser-playwright': '4.0.0',
         },
       }),
     );
@@ -6541,15 +6540,15 @@ describe('rewriteStandaloneProject pnpm workspace yaml', () => {
     const pkg = readJson(path.join(tmpDir, 'package.json'));
     const resolutions = pkg.resolutions as Record<string, string>;
     // Parent-through-provider key targets some-transitive-dep — preserved.
-    expect(resolutions['@vitest/browser-webdriverio@4/some-transitive-dep']).toBe('1.0.0');
+    expect(resolutions['@vitest/browser-playwright@4/some-transitive-dep']).toBe('1.0.0');
     // npm-alias key targets `fork` (the aliased descriptor), not the provider — preserved.
-    expect(resolutions['@vitest/browser-webdriverio@npm:@other/fork@1.2.3']).toBe('2.0.0');
+    expect(resolutions['@vitest/browser-playwright@npm:@other/fork@1.2.3']).toBe('2.0.0');
     // The bare key DOES target the provider — pruned so it can't force the
     // stale provider over the migrated bundled-version dep.
-    expect(resolutions).not.toHaveProperty('@vitest/browser-webdriverio');
+    expect(resolutions).not.toHaveProperty('@vitest/browser-playwright');
     const devDeps = pkg.devDependencies as Record<string, string>;
-    expect(devDeps['@vitest/browser-webdriverio']).toBe('catalog:');
-    expect(devDeps.webdriverio).toBe('*');
+    expect(devDeps['@vitest/browser-playwright']).toBe('catalog:');
+    expect(devDeps.playwright).toBe('*');
   });
 
   it('does not add vitest for a package without browser mode', () => {
diff --git a/packages/cli/src/migration/__tests__/vitest-v5-ast.spec.ts b/packages/cli/src/migration/__tests__/vitest-v5-ast.spec.ts
new file mode 100644
index 0000000000..a416bf891e
--- /dev/null
+++ b/packages/cli/src/migration/__tests__/vitest-v5-ast.spec.ts
@@ -0,0 +1,199 @@
+import { describe, expect, it } from 'vitest';
+
+import { SourceEditor, parseSource } from '../vitest-v5/ast.ts';
+import { migrateVitestV5Config } from '../vitest-v5/config.ts';
+import { migrateVitestV5Source } from '../vitest-v5/source.ts';
+
+const options = { preserveV4: true, browser: true, globals: true };
+
+describe('Oxc migration analysis', () => {
+  it.each([
+    ['test.js', 'const element = <div />;'],
+    ['test.jsx', 'export const element = <div />;'],
+    ['test.ts', 'const identity = <T>(value: T): T => value;'],
+    ['test.tsx', 'const element = <div />; interface Props { value: string }'],
+    ['test.mts', 'export const value: number = 1;'],
+    ['test.cts', 'const value: number = 1; module.exports = value;'],
+    ['test.js', '@decorate class Example { method() {} }'],
+    ['test.ts', 'const value = 123n; const expression = /partial/v;'],
+  ])('parses %s syntax without another parser dependency', (file, content) => {
+    expect(parseSource(file, content).program.type).toBe('Program');
+  });
+
+  it('rejects Flow and malformed syntax instead of returning a partial AST', () => {
+    expect(() => parseSource('test.js', '// @flow\nconst value: string = "x";')).toThrow(
+      'Flow is not supported',
+    );
+    expect(() => parseSource('test.ts', 'const = ;')).toThrow();
+  });
+
+  it.each([
+    [String.raw`'\ud800'`, '\ud800'],
+    [String.raw`'\udc00'`, '\udc00'],
+    [String.raw`'\ud800x'`, '\ud800x'],
+    [String.raw`'\u{d800}'`, '\ud800'],
+    [String.raw`'\ud800\udc00'`, '\ud800\udc00'],
+  ])('preserves the value and source spelling of %s', (literal, value) => {
+    const declaration = `const value = ${literal};`;
+    expect(parseSource('test.ts', declaration).program.body[0]).toMatchObject({
+      declarations: [{ init: { type: 'Literal', value } }],
+    });
+    const input = `${declaration}\nexpect(() => {}).toThrow('');`;
+    expect(migrateVitestV5Source('test.ts', input, options)).toEqual({
+      content: `${declaration}\nexpect(() => {}).toThrow(/^$/);`,
+      findings: [],
+    });
+  });
+
+  it('preserves unpaired surrogates in template values', () => {
+    const declaration = 'const value = `\\ud800`;';
+    expect(parseSource('test.ts', declaration).program.body[0]).toMatchObject({
+      declarations: [{ init: { quasis: [{ value: { cooked: '\ud800' } }] } }],
+    });
+    const input = `${declaration}\nexpect(() => {}).toThrow('');`;
+    expect(migrateVitestV5Source('test.ts', input, options)).toEqual({
+      content: `${declaration}\nexpect(() => {}).toThrow(/^$/);`,
+      findings: [],
+    });
+  });
+
+  it('migrates ASTs deeper than the Rust JSON recursion limit', () => {
+    const declaration = `const value = ${Array(160).fill('1').join(' + ')};`;
+    const input = `${declaration}\nexpect(() => {}).toThrow('');`;
+    expect(migrateVitestV5Source('test.ts', input, options)).toEqual({
+      content: `${declaration}\nexpect(() => {}).toThrow(/^$/);`,
+      findings: [],
+    });
+  });
+
+  it('preserves shadowed globals in destructuring, catch clauses, and hoisted declarations', () => {
+    const shadowed = `function parameter({ expect }) { expect(() => {}).toThrow(''); }
+try {} catch (expect) { expect(() => {}).toThrow(''); }
+function hoisted() { expect(() => {}).toThrow(''); var expect; }
+{ expect(() => {}).toThrow(''); let expect; }`;
+    const input = `${shadowed}\nexpect(() => {}).toThrow('');`;
+    const result = migrateVitestV5Source('test.ts', input, options);
+    expect(result.content).toBe(`${shadowed}\nexpect(() => {}).toThrow(/^$/);`);
+    expect(result.findings).toEqual([]);
+  });
+
+  it('does not follow reassigned runner aliases', () => {
+    const input = `import { createVitest } from 'vitest/node';
+let runner = await createVitest('test', {});
+runner = other;
+runner.collect();`;
+    const result = migrateVitestV5Source('test.ts', input, options);
+    expect(result.content).toBe(input);
+    expect(result.findings).toEqual([expect.objectContaining({ code: 'static-collect' })]);
+  });
+
+  it('resolves constructor references before and after their declaration', () => {
+    const input = `import { vi } from 'vitest';
+new mock(); const mock = vi.fn(); new mock();`;
+    const result = migrateVitestV5Source('test.ts', input, options);
+    expect(result.findings).toEqual([expect.objectContaining({ code: 'class-mock' })]);
+  });
+
+  it('reserves generated names across bindings, unresolved references, and earlier edits', () => {
+    const input = `import { getFn } from '@vitest/runner';
+import { getHooks } from 'vitest/suite';
+const _VitestTestRunner = 1; use(_VitestTestRunner2);`;
+    const result = migrateVitestV5Source('test.ts', input, options);
+    expect(result.content).toContain('TestRunner as _VitestTestRunner3');
+    expect(result.content).toContain('TestRunner as _VitestTestRunner4');
+    expect(result.findings).toEqual([]);
+    expect(parseSource('test.ts', result.content).program.type).toBe('Program');
+  });
+
+  it.each([
+    `import type * as v from 'vitest'; v.expect(() => {}).toThrow('');`,
+    `import type * as expect from 'vitest'; expect(() => {}).toThrow('');`,
+    `import type { expect } from 'vitest'; expect(() => {}).toThrow('');`,
+    `import { type expect } from 'vitest'; expect(() => {}).toThrow('');`,
+  ])('does not mistake a type-only import for a runtime API or global: %s', (input) => {
+    expect(migrateVitestV5Source('test.ts', input, options).content).toBe(input);
+  });
+
+  it.each([
+    `import { expect } from 'vitest'; expect?.(() => {}).toThrow('');`,
+    `import { expect } from 'vitest'; expect(() => {})?.toThrow('');`,
+    `import * as v from 'vitest'; v?.expect(() => {}).toThrow('');`,
+  ])('preserves optional API calls: %s', (input) => {
+    expect(migrateVitestV5Source('test.ts', input, options).content).toBe(input);
+  });
+
+  it('retains dynamic imports, CommonJS imports, and TS import-type diagnostics', () => {
+    const input = `const runner = await import('@vitest/runner');
+const other = require('vitest/runners');
+type Runner = import('vitest/internal/module-runner').ModuleRunner;
+function local(require) { return require('vitest/runners'); }`;
+    const result = migrateVitestV5Source('test.ts', input, options);
+    expect(result.content).toBe(input);
+    expect(result.findings.map(({ code, severity }) => [code, severity])).toEqual([
+      ['removed-api', 'block'],
+      ['removed-api', 'block'],
+      ['removed-api', 'review'],
+    ]);
+  });
+
+  it('preserves non-ASCII text and reports UTF-16 columns with CRLF line endings', () => {
+    const input = `// 中文 😀\r\nimport { expect } from 'vitest';\r\nconst label = '😀'; expect.poll(() => label).toBe('x');`;
+    const result = migrateVitestV5Source('test.ts', input, options);
+    expect(result.content).toBe(input);
+    expect(result.findings).toContainEqual(
+      expect.objectContaining({
+        code: 'poll-timeout',
+        line: 3,
+        column: "const label = '😀'; ".length + 1,
+      }),
+    );
+    const edited = migrateVitestV5Source(
+      'test.ts',
+      `${input}\r\nexpect(() => {}).toThrow('');`,
+      options,
+    );
+    expect(edited.content).toBe(`${input}\r\nexpect(() => {}).toThrow(/^$/);`);
+  });
+
+  it.each([
+    'api: { port: 1 } /* keep , 😀 */, enabled: true',
+    'enabled: true, /* keep , 😀 */ api: { port: 1 }',
+    "enabled: true, api: { port: 1 }, /* keep , 😀 */ name: 'browser'",
+    'api: { port: 1 } /* keep , 😀 */,',
+    'api: { port: 1 } // keep , 😀\n, enabled: true',
+  ])('removes property punctuation without consuming comments: %s', (properties) => {
+    const input = `// 😀\nexport default { test: { browser: { ${properties} } } };`;
+    const result = migrateVitestV5Config('vite.config.ts', input, { preserveV4: false });
+    expect(result.findings).toEqual([]);
+    expect(result.content).toContain('keep , 😀');
+    expect(result.content.match(/api:/g)).toHaveLength(1);
+    expect(parseSource('vite.config.ts', result.content).program.type).toBe('Program');
+    expect(
+      migrateVitestV5Config('vite.config.ts', result.content, { preserveV4: false }).content,
+    ).toBe(result.content);
+  });
+
+  it('does not treat methods or getters as static config properties', () => {
+    const input = 'export default { test: { get browser() { return settings; } } };';
+    expect(migrateVitestV5Config('vite.config.ts', input, options).content).toBe(input);
+  });
+
+  it('returns the original source when an edit would produce invalid syntax', () => {
+    const editor = new SourceEditor('test.ts', 'const value = 1;');
+    editor.edit(0, 5, 'const =');
+    expect(editor.finish()).toEqual({
+      content: 'const value = 1;',
+      findings: [expect.objectContaining({ code: 'unsafe-syntax' })],
+    });
+  });
+
+  it('returns the whole original file when edits overlap', () => {
+    const editor = new SourceEditor('test.ts', 'const value = 1;');
+    editor.edit(6, 11, 'renamed');
+    editor.edit(6, 15, 'other = 2;');
+    expect(editor.finish()).toEqual({
+      content: 'const value = 1;',
+      findings: [expect.objectContaining({ code: 'overlapping-edits' })],
+    });
+  });
+});
diff --git a/packages/cli/src/migration/__tests__/vitest-v5-benchmark-output.spec.ts b/packages/cli/src/migration/__tests__/vitest-v5-benchmark-output.spec.ts
new file mode 100644
index 0000000000..26535e36f5
--- /dev/null
+++ b/packages/cli/src/migration/__tests__/vitest-v5-benchmark-output.spec.ts
@@ -0,0 +1,235 @@
+import { runInNewContext } from 'node:vm';
+
+import { describe, expect, it } from 'vitest';
+
+import { migrateVitestV5Command } from '../vitest-v5/commands.ts';
+import { migrateVitestV5Config } from '../vitest-v5/config.ts';
+
+const config = (test: string) =>
+  migrateVitestV5Config('vitest.config.js', `export default { test: { ${test} } };`, {
+    preserveV4: true,
+  });
+
+function resolved(content: string): Record<string, unknown> {
+  return runInNewContext(content.replace('export default', 'result ='), {}).test;
+}
+
+describe('Vitest v5 benchmark output config migration', () => {
+  it.each(['outputFile', 'outputJson'])(
+    'moves benchmark.%s to the JSON reporter without enabling stdout',
+    (key) => {
+      const result = config(`benchmark: { ${key}: 'reports/bench.json', include: ['*.bench.js'] }`);
+      expect(resolved(result.content)).toEqual({
+        clearMocks: false,
+        reporters: ['default', 'json'],
+        outputFile: { json: 'reports/bench.json' },
+        benchmark: { include: ['*.bench.js'] },
+      });
+      expect(result.findings).toEqual([]);
+      expect(
+        migrateVitestV5Config('vitest.config.js', result.content, { preserveV4: true }),
+      ).toEqual({ content: result.content, findings: [] });
+    },
+  );
+
+  it.each(['default', 'verbose'])(
+    'moves the built-in %s reporter without duplicate output',
+    (name) => {
+      const result = config(`benchmark: { reporters: '${name}' }`);
+      expect(resolved(result.content)).toEqual({
+        clearMocks: false,
+        reporters: [name],
+        benchmark: {},
+      });
+      expect(result.findings).toEqual([]);
+    },
+  );
+
+  it('retains explicit reporters and unrelated output destinations', () => {
+    const result = config(`reporters: ['verbose', 'junit'],
+      outputFile: { junit: 'tests.xml' },
+      benchmark: { outputJson: 'bench.json' }`);
+    expect(resolved(result.content)).toEqual({
+      clearMocks: false,
+      reporters: ['verbose', 'junit', 'json'],
+      outputFile: { junit: 'tests.xml', json: 'bench.json' },
+      benchmark: {},
+    });
+  });
+
+  it('reuses a JSON reporter without preserving its old stdout default', () => {
+    const result = config(`reporters: ['json'], benchmark: { outputJson: 'bench.json' }`);
+    expect(resolved(result.content)).toEqual({
+      clearMocks: false,
+      reporters: ['json', 'default'],
+      outputFile: { json: 'bench.json' },
+      benchmark: {},
+    });
+    expect(result.findings).toEqual([]);
+  });
+
+  it.each([`'bench.json'`, `{ json: 'bench.json' }`])(
+    'reuses an equivalent destination: %s',
+    (output) => {
+      const result = config(`reporters: ['default', 'json'], outputFile: ${output},
+      benchmark: { reporters: ['default'], outputFile: 'bench.json', outputJson: 'bench.json' }`);
+      expect(resolved(result.content).reporters).toEqual(['default', 'json']);
+      expect(resolved(result.content).benchmark).toEqual({});
+      expect(result.content).not.toContain('stdout');
+      expect(result.findings).toEqual([]);
+    },
+  );
+
+  it('keeps comments around removed properties', () => {
+    const result = config(`benchmark: { /* before */ reporters: 'default',
+      /* between */ outputJson: 'bench.json', /* after */ include: ['*.bench.js'] }`);
+    for (const comment of ['/* before */', '/* between */', '/* after */']) {
+      expect(result.content).toContain(comment);
+    }
+    expect(resolved(result.content).benchmark).toEqual({ include: ['*.bench.js'] });
+    expect(result.findings.some(({ severity }) => severity === 'block')).toBe(false);
+  });
+
+  it.each([
+    `benchmark: { reporters: './custom.js' }`,
+    `benchmark: { reporters: 'json' }`,
+    `benchmark: { reporters: [] }`,
+    `benchmark: { reporters: [['default', {}]] }`,
+    `benchmark: { outputJson: destination }`,
+    `benchmark: { outputFile: { default: 'bench.json' } }`,
+    `benchmark: { outputFile: 'one.json', outputJson: 'two.json' }`,
+    `reporters: ['default'], benchmark: { reporters: 'verbose' }`,
+    `reporters: [['json', { stdout: true }]], benchmark: { outputJson: 'bench.json' }`,
+    `reporters: ['default', /* keep */ 'junit'], benchmark: { outputJson: 'bench.json' }`,
+    `outputFile: 'tests.json', benchmark: { outputJson: 'bench.json' }`,
+    `outputFile: { json: 'tests.json' }, benchmark: { outputJson: 'bench.json' }`,
+    `outputFile: output, benchmark: { outputJson: 'bench.json' }`,
+  ])('retains ambiguous or conflicting output settings: %s', (input) => {
+    const result = config(input);
+    expect(result.findings).toContainEqual(
+      expect.objectContaining({ code: 'benchmark-api', severity: 'block' }),
+    );
+    expect(result.content).toContain('benchmark: {');
+  });
+
+  it('does not move a project reporter into a runner-wide setting', () => {
+    const result = config(`projects: [{ test: { benchmark: { outputJson: 'bench.json' } } }]`);
+    expect(result.content).toContain("outputJson: 'bench.json'");
+    expect(result.findings).toContainEqual(
+      expect.objectContaining({ code: 'benchmark-api', severity: 'block' }),
+    );
+  });
+
+  it('keeps output settings in an exported defineProject blocked', () => {
+    const result = migrateVitestV5Config(
+      'project.config.ts',
+      `import { defineProject } from 'vitest/config';
+      export default defineProject({ test: { benchmark: { outputJson: 'bench.json' } } });`,
+      { preserveV4: true },
+    );
+    expect(result.content).toContain("outputJson: 'bench.json'");
+    expect(result.findings).toContainEqual(
+      expect.objectContaining({ code: 'benchmark-api', severity: 'block' }),
+    );
+  });
+
+  it('does not move output from a merged config fragment', () => {
+    const input = `export default { test: { benchmark: { outputJson: 'bench.json' } } };`;
+    const result = migrateVitestV5Config('vitest.config.js', input, { preserveV4: true }, true);
+    expect(result.content).toContain("outputJson: 'bench.json'");
+    expect(result.findings).toContainEqual(
+      expect.objectContaining({ code: 'benchmark-api', severity: 'block' }),
+    );
+  });
+
+  it('still blocks baseline comparisons after planning a supported output move', () => {
+    const result = config(`benchmark: { compare: 'baseline.json', outputJson: 'new.json' }`);
+    expect(result.findings).toContainEqual(
+      expect.objectContaining({
+        code: 'benchmark-api',
+        severity: 'block',
+        message: expect.stringContaining('benchmark.compare'),
+      }),
+    );
+  });
+});
+
+describe('Vitest v5 benchmark JSON command migration', () => {
+  it.each(['vitest', 'vp test', 'pnpm exec vitest', 'npm exec -- vitest', 'npx vitest'])(
+    'moves literal JSON output in %s',
+    (runner) => {
+      const result = migrateVitestV5Command(
+        'package.json',
+        `${runner} bench --run --outputJson=bench.json`,
+        true,
+      );
+      expect(result.content).toBe(
+        `${runner} bench --run --reporter=default --reporter=json --outputFile=bench.json`,
+      );
+      expect(result.findings).toEqual([]);
+      expect(migrateVitestV5Command('package.json', result.content, true)).toEqual({
+        content: result.content,
+        findings: [],
+      });
+    },
+  );
+
+  it.each([
+    [
+      `vitest bench --reporters verbose --outputJson=bench.json`,
+      `vitest bench --reporters verbose --reporter=json --outputFile=bench.json`,
+    ],
+    [
+      `vitest bench --outputJson 'reports/bench results.json' --run`,
+      `vitest bench --reporter=default --reporter=json --outputFile='reports/bench results.json' --run`,
+    ],
+    [
+      `vitest bench --outputJson="bench results.json" --reporter verbose`,
+      `vitest bench --reporter=json --outputFile="bench results.json" --reporter verbose`,
+    ],
+    [
+      `vitest bench --reporter=json --outputJson=bench.json`,
+      `vitest bench --reporter=json --outputFile=bench.json`,
+    ],
+    [
+      `vitest bench --outputFile=bench.json --outputJson bench.json`,
+      `vitest bench --outputFile=bench.json --reporter=default --reporter=json`,
+    ],
+  ])('preserves quoting and explicit destinations in %s', (input, output) => {
+    const result = migrateVitestV5Command('package.json', input, true);
+    expect(result.content).toBe(output);
+    expect(result.findings).toEqual([]);
+  });
+
+  it.each([
+    'vitest bench --outputJson=$OUTPUT',
+    'vitest bench --outputJson *.json',
+    'vitest bench --outputJson=bench.json && echo done',
+    'vitest bench --outputJson=one.json --outputJson=two.json',
+    'vitest bench --outputJson=bench.json --outputFile=tests.json',
+    'vitest bench --outputJson=bench.json --outputFile.json=tests.json',
+    'vitest bench --outputJson',
+    'vitest bench --outputJson --run',
+    'vitest bench --outputJson=bench.json --reporter',
+    'vitest bench --outputJson=bench.json --reporter=junit',
+    'vitest bench --outputJson=bench.json --reporter=./custom.js',
+    'vitest bench --outputJson=bench.json --reporters=junit',
+    'vitest bench --testNamePattern "--outputJson=bench.json"',
+    'vitest bench -t "--outputJson=bench.json"',
+    'vitest bench --compare=baseline.json',
+  ])('keeps unresolved output or comparison flags blocked: %s', (input) => {
+    const result = migrateVitestV5Command('package.json', input, true);
+    expect(result.content).toBe(input);
+    expect(result.findings).toContainEqual(
+      expect.objectContaining({ code: 'benchmark-api', severity: 'block' }),
+    );
+  });
+
+  it('does not interpret file filters after -- as removed flags', () => {
+    const input = 'vitest bench -- --outputJson=example --compare';
+    expect(migrateVitestV5Command('package.json', input, true)).toEqual({
+      content: input,
+      findings: [],
+    });
+  });
+});
diff --git a/packages/cli/src/migration/__tests__/vitest-v5-benchmark-plans.spec.ts b/packages/cli/src/migration/__tests__/vitest-v5-benchmark-plans.spec.ts
new file mode 100644
index 0000000000..568e779cd2
--- /dev/null
+++ b/packages/cli/src/migration/__tests__/vitest-v5-benchmark-plans.spec.ts
@@ -0,0 +1,323 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+import { afterEach, describe, expect, it, vi } from 'vitest';
+
+import { PackageManager } from '../../types/index.ts';
+import {
+  applyVitestV5Migration,
+  applyVitestV5NodeMigration,
+  finishVitestV5Migration,
+  planVitestV5Migration,
+} from '../migrator.ts';
+import { SourceEditor } from '../vitest-v5/ast.ts';
+
+const directories: string[] = [];
+afterEach(() => {
+  vi.restoreAllMocks();
+  for (const directory of directories.splice(0)) {
+    fs.rmSync(directory, { recursive: true, force: true });
+  }
+});
+
+function project(files: Record<string, string>) {
+  const rootDir = fs.mkdtempSync(path.join(os.tmpdir(), 'vp-benchmark-plan-'));
+  directories.push(rootDir);
+  for (const [name, source] of Object.entries({
+    'package.json': JSON.stringify({
+      devDependencies: { vitest: '4.1.11' },
+      scripts: { bench: 'vitest bench --run' },
+    }),
+    ...files,
+  })) {
+    const file = path.join(rootDir, name);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, source);
+  }
+  return { rootDir, packageManager: PackageManager.pnpm };
+}
+
+describe('Vitest v5 benchmark migration plans', () => {
+  it.each([
+    ['{ globals: true }', 'example.bench.js'],
+    ['{ globals: true }', 'example.benchmark.ts'],
+    [
+      `{ globals: true, include: ['unit/*.test.js'], exclude: ['perf/**'], benchmark: { include: ['perf/*.js'], exclude: ['**/unrelated.js'] } }`,
+      'perf/work.js',
+    ],
+    [
+      `{ globals: true, root: './app', dir: './perf', benchmark: { include: ['*.js'], exclude: ['unrelated.js'] } }`,
+      'perf/work.js',
+    ],
+    [
+      `{ projects: [{ test: { root: './perf', globals: true, benchmark: { include: ['*.js'], exclude: ['unrelated.js'] } } }] }`,
+      'perf/work.js',
+    ],
+    [
+      `{ globals: true, projects: [{ extends: true, test: { benchmark: { include: ['perf/*.js'], exclude: ['**/unrelated.js'] } } }] }`,
+      'perf/work.js',
+    ],
+  ])('resolves benchmark ownership from %s', (test, selected) => {
+    const unrelated = `bench('other runner', () => { expect(() => {}).toThrow(''); });`;
+    const workspace = project({
+      'vitest.config.mjs': `export default { test: ${test} };`,
+      [selected]: `bench('work', (() => 42));`,
+      'perf/unrelated.js': unrelated,
+      'unrelated.js': unrelated,
+    });
+    const plan = planVitestV5Migration(workspace);
+    expect(plan.findings).toEqual([]);
+    const changed = plan.changes.find(
+      ({ file }) => file === path.join(workspace.rootDir, selected),
+    );
+    expect(changed?.after).toContain(`globalThis.test('work'`);
+    expect(changed?.after).toContain('async ({ bench })');
+    applyVitestV5Migration(plan);
+    expect(finishVitestV5Migration(plan)).toEqual([]);
+    for (const file of ['perf/unrelated.js', 'unrelated.js']) {
+      expect(fs.readFileSync(path.join(workspace.rootDir, file), 'utf8')).toBe(unrelated);
+    }
+    expect(planVitestV5Migration(workspace).changes).toEqual([]);
+  });
+
+  it('merges explicit inherited benchmark patterns without inheriting implicit defaults', () => {
+    const workspace = project({
+      'vitest.config.mjs': `export default { test: { globals: true, benchmark: { include: ['base/*.js'], exclude: ['**/excluded.js'] }, projects: [{ extends: true, test: { benchmark: { include: ['perf/*.js'], exclude: ['**/other.js'] } } }] } };`,
+      'base/work.js': `bench('base', () => 42);`,
+      'perf/work.js': `bench('child', () => 42);`,
+      'base/excluded.js': `bench('excluded', () => 42);`,
+      'perf/other.js': `bench('other', () => 42);`,
+      'unused.bench.js': `bench('default pattern is overridden', () => 42);`,
+    });
+    const plan = planVitestV5Migration(workspace);
+    expect(plan.findings).toEqual([]);
+    expect(plan.changes.map(({ file }) => path.relative(workspace.rootDir, file))).toEqual([
+      path.join('base', 'work.js'),
+      path.join('perf', 'work.js'),
+      'vitest.config.mjs',
+    ]);
+    applyVitestV5Migration(plan);
+    expect(finishVitestV5Migration(plan)).toEqual([]);
+  });
+
+  it('uses benchmark settings from referenced projects and their roots', () => {
+    const workspace = project({
+      'vitest.config.mjs': `export default { test: { projects: ['./perf/vitest.config.mjs'] } };`,
+      'perf/vitest.config.mjs': `export default { test: { globals: true, benchmark: { include: ['*.js'], exclude: ['unrelated.js'] } } };`,
+      'perf/work.js': `bench('work', () => 42);`,
+      'perf/unrelated.js': `bench('unrelated', () => 42);`,
+      'work.js': `bench('wrong root', () => 42);`,
+    });
+    const plan = planVitestV5Migration(workspace);
+    expect(plan.findings).toEqual([]);
+    expect(plan.changes.filter(({ file }) => file.endsWith('.js')).map(({ file }) => file)).toEqual(
+      [path.join(workspace.rootDir, 'perf/work.js')],
+    );
+    applyVitestV5Migration(plan);
+    expect(finishVitestV5Migration(plan)).toEqual([]);
+  });
+
+  it('does not merge implicit parent benchmark defaults into an inline project', () => {
+    const workspace = project({
+      'vitest.config.mjs': `export default { test: { globals: true, projects: [{ extends: true, test: { benchmark: { include: ['perf/*.js'] } } }] } };`,
+      'perf/work.js': `bench('work', () => 42);`,
+      'unused.bench.js': `bench('other runner', () => 42);`,
+    });
+    const plan = planVitestV5Migration(workspace);
+    expect(plan.findings).toEqual([]);
+    expect(plan.changes.filter(({ file }) => file.endsWith('.js')).map(({ file }) => file)).toEqual(
+      [path.join(workspace.rootDir, 'perf/work.js')],
+    );
+  });
+
+  it('includes in-source benchmarks only when the file contains import.meta.vitest', () => {
+    const workspace = project({
+      'vitest.config.mjs': `export default { test: { globals: true, benchmark: { include: [], includeSource: ['perf/*.js'] } } };`,
+      'perf/work.js': `if (import.meta.vitest) { bench('work', () => 42); }`,
+      'perf/other.js': `bench('other runner', () => 42);`,
+    });
+    const plan = planVitestV5Migration(workspace);
+    expect(plan.findings).toEqual([]);
+    expect(plan.changes.filter(({ file }) => file.endsWith('.js')).map(({ file }) => file)).toEqual(
+      [path.join(workspace.rootDir, 'perf/work.js')],
+    );
+  });
+
+  it('reviews CLI benchmark pattern overrides instead of using the config patterns', () => {
+    const workspace = project({
+      'package.json': JSON.stringify({
+        devDependencies: { vitest: '4.1.11' },
+        scripts: { bench: 'vitest bench --benchmark.include=perf/*.js' },
+      }),
+      'vitest.config.mjs': `export default { test: { globals: true } };`,
+      'perf/work.js': `bench('work', () => 42);`,
+      'unused.bench.js': `bench('other runner', () => 42);`,
+    });
+    const plan = planVitestV5Migration(workspace);
+    for (const file of ['perf/work.js', 'unused.bench.js']) {
+      expect(plan.findings).toContainEqual(
+        expect.objectContaining({
+          file: path.join(workspace.rootDir, file),
+          code: 'global-api-ownership',
+        }),
+      );
+    }
+    expect(plan.changes.some(({ file }) => file.endsWith('.js'))).toBe(false);
+  });
+
+  describe.each([false, true])('in-source plans with globals: %s', (globals) => {
+    it.each([
+      `const { bench } = import.meta.vitest; bench('work', () => work());`,
+      `import.meta.vitest.bench('work', () => work());`,
+    ])('scans, applies, and finalizes %s', (body) => {
+      const workspace = project({
+        'vitest.config.mjs': `export default { test: { globals: ${globals}, benchmark: { include: [], includeSource: ['perf/*.js'] } } };`,
+        'perf/work.js': `export const work = () => 42; if (import.meta.vitest) { ${body} }`,
+        'perf/other.js': `bench('other runner', () => 42);`,
+      });
+      const plan = planVitestV5Migration(workspace);
+      expect(plan.findings).toEqual([]);
+      const content = plan.changes.find(({ file }) => file.endsWith('work.js'))?.after;
+      expect(content).toContain('export const work = () => 42; if (import.meta.vitest)');
+      expect(content).toContain(`test('work', async ({ bench })`);
+      expect(content).not.toMatch(/\bimport\s*[{*]/);
+      applyVitestV5Migration(plan);
+      expect(finishVitestV5Migration(plan)).toEqual([]);
+      expect(fs.readFileSync(path.join(workspace.rootDir, 'perf/other.js'), 'utf8')).toBe(
+        `bench('other runner', () => 42);`,
+      );
+      expect(planVitestV5Migration(workspace).changes).toEqual([]);
+    });
+
+    it.each([
+      `const { bench } = import.meta.vitest; bench('work', () => 42, { time: 1 });`,
+      `import.meta.vitest.bench('work', () => 42, { time: 1 });`,
+      `const { bench } = import.meta.vitest; register(bench);`,
+    ])('blocks dependency changes for retained APIs: %s', (body) => {
+      const original = `if (import.meta.vitest) { ${body} }`;
+      const workspace = project({
+        'vitest.config.mjs': `export default { test: { globals: ${globals}, benchmark: { include: [], includeSource: ['perf/*.js'] } } };`,
+        'perf/work.js': original,
+      });
+      const manifest = fs.readFileSync(path.join(workspace.rootDir, 'package.json'), 'utf8');
+      const plan = planVitestV5Migration(workspace);
+      expect(plan.findings).toContainEqual(
+        expect.objectContaining({ code: 'benchmark-api', severity: 'block' }),
+      );
+      expect(() => applyVitestV5Migration(plan)).toThrow('blocking');
+      expect(fs.readFileSync(path.join(workspace.rootDir, 'package.json'), 'utf8')).toBe(manifest);
+      expect(fs.readFileSync(path.join(workspace.rootDir, 'perf/work.js'), 'utf8')).toBe(original);
+      expect(finishVitestV5Migration(plan)).toContainEqual(
+        expect.objectContaining({ code: 'benchmark-api', severity: 'block' }),
+      );
+    });
+  });
+
+  it.each([
+    'runtimeOptions',
+    '{ include: runtimePatterns }',
+    '{ exclude: runtimePatterns }',
+    `{ includeSource: runtimePatterns }`,
+  ])('reviews unresolved benchmark membership: %s', (benchmark) => {
+    const original = `bench('work', () => 42);`;
+    const workspace = project({
+      'vitest.config.mjs': `export default { test: { globals: true, benchmark: ${benchmark} } };`,
+      'example.bench.js': original,
+    });
+    const plan = planVitestV5Migration(workspace);
+    expect(plan.findings).toContainEqual(
+      expect.objectContaining({
+        file: path.join(workspace.rootDir, 'example.bench.js'),
+        code: 'global-api-ownership',
+      }),
+    );
+    expect(plan.changes.some(({ file }) => file.endsWith('example.bench.js'))).toBe(false);
+    applyVitestV5Migration(plan);
+    expect(finishVitestV5Migration(plan)).toContainEqual(
+      expect.objectContaining({ code: 'global-api-ownership' }),
+    );
+    expect(fs.readFileSync(path.join(workspace.rootDir, 'example.bench.js'), 'utf8')).toBe(
+      original,
+    );
+  });
+
+  it('reviews conflicting benchmark globals across projects', () => {
+    const workspace = project({
+      'vitest.config.mjs': `export default { test: { projects: [{ test: { globals: true } }, { test: { globals: false } }] } };`,
+      'example.bench.js': `bench('shared', () => 42);`,
+    });
+    const plan = planVitestV5Migration(workspace);
+    expect(plan.findings).toContainEqual(expect.objectContaining({ code: 'global-api-ownership' }));
+    expect(plan.changes.some(({ file }) => file.endsWith('example.bench.js'))).toBe(false);
+  });
+
+  it.each(['(() => 42)', '((() => 42))', '(function () { return 42; })', '(workload)'])(
+    'applies and finalizes a parenthesized imported benchmark: %s',
+    (callback) => {
+      const workspace = project({
+        'vitest.config.mjs': 'export default { test: {} };',
+        'example.bench.js': `import { bench } from 'vitest'; const workload = () => 42; bench('work', ${callback});`,
+      });
+      const plan = planVitestV5Migration(workspace);
+      expect(plan.findings).toEqual([]);
+      expect(plan.changes.find(({ file }) => file.endsWith('example.bench.js'))?.after).toContain(
+        "test('work'",
+      );
+      applyVitestV5Migration(plan);
+      expect(finishVitestV5Migration(plan)).toEqual([]);
+      expect(planVitestV5Migration(workspace).changes).toEqual([]);
+    },
+  );
+
+  describe.each(['unsafe-syntax', 'overlapping-edits'])('rollback after %s', (code) => {
+    it.each([
+      `import { bench } from 'vitest'; bench('work', () => 42);`,
+      `import * as v from 'vitest'; v.bench('work', () => 42);`,
+      `bench('work', () => 42);`,
+      `import { bench } from 'vitest';`,
+      `if (import.meta.vitest) { const { bench } = import.meta.vitest; bench('work', () => 42); }`,
+      `if (import.meta.vitest) { import.meta.vitest.bench('work', () => 42); }`,
+      `if (import.meta.vitest) { const { bench } = import.meta.vitest; }`,
+    ])('blocks the plan while the legacy API remains: %s', (original) => {
+      const workspace = project({
+        '.node-version': '20.19.0\n',
+        'vitest.config.mjs': 'export default { test: { globals: true } };',
+        'example.bench.js': original,
+      });
+      // oxlint-disable-next-line typescript/unbound-method -- Invoked below with the current editor as this.
+      const finish = SourceEditor.prototype.finish;
+      // Exercise the real validation and rollback paths independently of the
+      // particular transform bug that caused a rejected edit.
+      vi.spyOn(SourceEditor.prototype, 'finish').mockImplementation(function (this: SourceEditor) {
+        if (this.file.endsWith('example.bench.js')) {
+          if (code === 'unsafe-syntax') {
+            this.edit(this.source.length, this.source.length, '\nconst =;');
+          } else {
+            this.edit(0, this.source.length, '');
+          }
+        }
+        return finish.call(this);
+      });
+      const manifest = fs.readFileSync(path.join(workspace.rootDir, 'package.json'), 'utf8');
+      const plan = planVitestV5Migration(workspace);
+      expect(plan.findings).toContainEqual(expect.objectContaining({ code }));
+      expect(plan.findings).toContainEqual(
+        expect.objectContaining({ code: 'benchmark-api', severity: 'block' }),
+      );
+      expect(plan.changes.some(({ file }) => file.endsWith('example.bench.js'))).toBe(false);
+      expect(() => applyVitestV5Migration(plan)).toThrow('blocking');
+      expect(() => applyVitestV5NodeMigration(plan)).toThrow('blocking');
+      expect(fs.readFileSync(path.join(workspace.rootDir, 'example.bench.js'), 'utf8')).toBe(
+        original,
+      );
+      expect(fs.readFileSync(path.join(workspace.rootDir, 'package.json'), 'utf8')).toBe(manifest);
+      expect(fs.readFileSync(path.join(workspace.rootDir, '.node-version'), 'utf8')).toBe(
+        '20.19.0\n',
+      );
+      expect(finishVitestV5Migration(plan)).toContainEqual(
+        expect.objectContaining({ code: 'benchmark-api', severity: 'block' }),
+      );
+    });
+  });
+});
diff --git a/packages/cli/src/migration/__tests__/vitest-v5-benchmarks.spec.ts b/packages/cli/src/migration/__tests__/vitest-v5-benchmarks.spec.ts
new file mode 100644
index 0000000000..bc4978038a
--- /dev/null
+++ b/packages/cli/src/migration/__tests__/vitest-v5-benchmarks.spec.ts
@@ -0,0 +1,451 @@
+import { runInNewContext } from 'node:vm';
+
+import { describe, expect, it } from 'vitest';
+
+import { migrateVitestV5Command } from '../vitest-v5/commands.ts';
+import { migrateVitestV5Source } from '../vitest-v5/source.ts';
+
+const migrate = (source: string, globals = false) =>
+  migrateVitestV5Source('example.bench.ts', source, { preserveV4: true, globals });
+
+describe('Vitest v5 benchmark migration', () => {
+  describe.each([false, true])('in-source benchmarks with globals: %s', (globals) => {
+    it.each([
+      `const { bench } = import.meta.vitest; bench('work', () => work());`,
+      `const { bench: measure } = import.meta.vitest; measure('work', (() => work()));`,
+      `import.meta.vitest.bench('work', () => work());`,
+      `import.meta.vitest['bench']('work', () => work());`,
+      `const { bench, describe } = import.meta.vitest; describe('suite', () => { bench('work', () => work()); });`,
+      `const { bench } = import.meta.vitest; const test = 1; bench('work', () => work());`,
+    ])('preserves the guard and workload for %s', async (body) => {
+      const result = migrate(`if (import.meta.vitest) { ${body} }`, globals);
+      expect(result.findings).toEqual([]);
+      expect(result.content).toMatch(/^if \(import\.meta\.vitest\) \{/);
+      expect(result.content).not.toMatch(/from ['"](?:vitest|vite-plus)/);
+      expect(migrate(result.content, globals)).toEqual({ content: result.content, findings: [] });
+
+      const tests: Array<(context: unknown) => Promise<void>> = [];
+      let executions = 0;
+      const work = () => {
+        executions++;
+        return 42;
+      };
+      const script = result.content.replaceAll('import.meta.vitest', '__vitest');
+      // Production evaluation must not import or register any test APIs.
+      expect(() => runInNewContext(script, { __vitest: undefined, work })).not.toThrow();
+      runInNewContext(script, {
+        work,
+        __vitest: {
+          test: (_name: string, fn: (context: unknown) => Promise<void>) => tests.push(fn),
+          describe: (_name: string, fn: () => void) => fn(),
+        },
+      });
+      expect(tests).toHaveLength(1);
+      expect(executions).toBe(0);
+      await tests[0]({
+        bench: (name: string, workload: () => number) => ({
+          run: () => {
+            expect(name).toBe('work');
+            expect(workload()).toBe(42);
+          },
+        }),
+      });
+      expect(executions).toBe(1);
+    });
+
+    it.each([
+      `const { bench } = import.meta.vitest; bench('work', () => 42, { time: 1 });`,
+      `const { bench } = import.meta.vitest; register(bench);`,
+      `const { bench = fallback } = import.meta.vitest; bench('work', () => 42);`,
+      `const { bench }: { bench: Function } = import.meta.vitest; bench('work', () => 42);`,
+      `const { bench, ...rest } = import.meta.vitest; bench('work', () => 42);`,
+      `let { bench } = import.meta.vitest; bench = other; bench('work', () => 42);`,
+      `import.meta.vitest.bench('work', () => 42, { time: 1 });`,
+      `import.meta.vitest.bench?.('work', () => 42);`,
+      `import.meta.vitest?.bench('work', () => 42);`,
+      `register(import.meta.vitest.bench);`,
+    ])('blocks unsupported references: %s', (body) => {
+      const input = `if (import.meta.vitest) { ${body} }`;
+      const result = migrate(input, globals);
+      expect(result.content).toBe(input);
+      expect(result.findings).toContainEqual(
+        expect.objectContaining({ code: 'benchmark-api', severity: 'block' }),
+      );
+    });
+
+    it('does not treat a shadowed bench or a test-context fixture as the legacy API', () => {
+      const input = `if (import.meta.vitest) {
+  const { bench } = otherRunner;
+  bench('other', () => 42);
+  const { test } = import.meta.vitest;
+  test('new', async ({ bench }) => { await bench('new', () => 42).run(); });
+}`;
+      expect(migrate(input, globals)).toEqual({ content: input, findings: [] });
+    });
+  });
+
+  it.each(['vitest', 'vite-plus/test'])(
+    'migrates direct calls imported from %s and preserves workload scopes',
+    (module) => {
+      const input = `import { bench as measure, describe } from '${module}';
+describe('utilities', () => {
+  const input = '{"a":1}';
+  measure('parse', () => { JSON.parse(input); });
+  measure('async', async () => { await Promise.resolve(input); });
+});`;
+      const result = migrate(input);
+      expect(result.findings).toEqual([]);
+      expect(result.content).toContain('import { test, describe }');
+      expect(result.content).toContain(
+        `test('parse', async ({ bench }) => { await bench('parse', () => { JSON.parse(input); }).run(); });`,
+      );
+      expect(result.content).toContain(
+        `await bench('async', async () => { await Promise.resolve(input); }).run();`,
+      );
+      expect(migrate(result.content)).toEqual({ content: result.content, findings: [] });
+    },
+  );
+
+  it.each(['skip', 'only', 'todo'])('moves bench.%s to the enclosing test', (modifier) => {
+    const result = migrate(
+      `import { bench } from 'vitest'; bench.${modifier}('case', () => work());`,
+    );
+    expect(result.findings).toEqual([]);
+    expect(result.content).toContain(`test.${modifier}('case', async ({ bench })`);
+    expect(result.content).toContain(`await bench('case', () => work()).run();`);
+  });
+
+  it('migrates a todo with no workload', () => {
+    const result = migrate(`import { bench } from 'vitest'; bench.todo('later');`);
+    expect(result.findings).toEqual([]);
+    expect(result.content).toContain(`test.todo('later');`);
+    expect(result.content).not.toContain('.run()');
+  });
+
+  it('migrates namespace imports and preserves an existing fixture', () => {
+    const result = migrate(`import * as v from 'vitest';
+v.bench('old', () => work());
+v.test('new', async ({ bench }) => { await bench('new', () => work()).run(); });`);
+    expect(result.findings).toEqual([]);
+    expect(result.content).toContain(`v.test('old', async ({ bench })`);
+    expect(result.content).toContain(
+      `v.test('new', async ({ bench }) => { await bench('new', () => work()).run(); });`,
+    );
+    expect(migrate(result.content).content).toBe(result.content);
+  });
+
+  it('avoids collisions with existing test and bench identifiers', () => {
+    const result = migrate(`import { bench as measure, test } from 'vitest';
+const _test = 1, _bench = 2, bench = 3;
+measure('scope', function () { consume(_test, _bench, test, bench); });`);
+    expect(result.findings).toEqual([]);
+    expect(result.content).toContain('test as _test2');
+    expect(result.content).toContain('bench: _bench2');
+    expect(result.content).toContain('function () { consume(_test, _bench, test, bench); }');
+  });
+
+  it('avoids a test binding inside the registration scope', () => {
+    const result = migrate(`import { bench, describe } from 'vitest';
+describe('group', () => {
+  const test = () => 42;
+  bench('scope', () => test());
+});`);
+    expect(result.findings).toEqual([]);
+    expect(result.content).toContain('import { test as _test, describe }');
+    expect(result.content).toContain(`_test('scope', async ({ bench })`);
+    expect(result.content).toContain(`await bench('scope', () => test()).run()`);
+    expect(migrate(result.content)).toEqual({ content: result.content, findings: [] });
+  });
+
+  it('reserves generated test imports across separate benchmark imports', () => {
+    const result = migrate(`import { bench as first } from 'vitest';
+import { bench as second } from 'vite-plus/test';
+first('first', () => work());
+second('second', () => work());`);
+    expect(result.findings).toEqual([]);
+    expect(result.content).toContain(`import { test } from 'vitest';`);
+    expect(result.content).toContain(`import { test as _test } from 'vite-plus/test';`);
+    expect(result.content).toContain(`test('first', async ({ bench })`);
+    expect(result.content).toContain(`_test('second', async ({ bench })`);
+    expect(migrate(result.content)).toEqual({ content: result.content, findings: [] });
+  });
+
+  it('uses a plain fixture for a named workload that closes over bench', () => {
+    const result = migrate(`import { bench as measure } from 'vitest';
+const bench = 42;
+function workload() { consume(bench); }
+measure('scope', workload);`);
+    expect(result.findings).toEqual([]);
+    expect(result.content).toContain(`import { test } from 'vitest';`);
+    expect(result.content).toContain('function workload() { consume(bench); }');
+    expect(result.content).toContain('const _benchFn = workload;');
+    expect(result.content).toContain(`test('scope', async ({ bench })`);
+    expect(result.content).toContain(`await bench('scope', _benchFn).run()`);
+    expect(migrate(result.content)).toEqual({ content: result.content, findings: [] });
+  });
+
+  it.each(['const bench = 42;', ''])(
+    'preserves bound and unbound workload references when adding aliases: %s',
+    async (declaration) => {
+      const result = migrate(`import { bench as measure } from 'vitest';
+${declaration}
+measure('scope', () => results.push([test, bench]));
+measure('plain', () => results.push('plain'));`);
+      expect(result.findings).toEqual([]);
+      expect(result.content).toContain(`import { test as _test } from 'vitest';`);
+      expect(result.content).toContain(`_test('scope', async ({ bench: _bench })`);
+      expect(result.content).toContain(`_test('plain', async ({ bench })`);
+      const results: unknown[] = [];
+      const tests: Array<(context: unknown) => Promise<void>> = [];
+      runInNewContext(result.content.replace(/^import[^\n]+\n/, ''), {
+        results,
+        test: 'original test',
+        bench: 42,
+        _test: (_name: string, fn: (context: unknown) => Promise<void>) => tests.push(fn),
+      });
+      expect(results).toEqual([]);
+      for (const fn of tests) {
+        await fn({ bench: (_name: string, workload: () => void) => ({ run: workload }) });
+      }
+      expect(results).toEqual([['original test', 42], 'plain']);
+      expect(migrate(result.content)).toEqual({ content: result.content, findings: [] });
+    },
+  );
+
+  it('preserves comments and trailing commas', () => {
+    const result = migrate(`import { bench } from 'vitest';
+bench('comments', /* workload */ () => { /* inside */ work(); }, /* trailing */);`);
+    expect(result.findings).toEqual([]);
+    expect(result.content).toContain('/* workload */');
+    expect(result.content).toContain('/* inside */');
+    expect(result.content).toContain('/* trailing */');
+    expect(migrate(result.content).content).toBe(result.content);
+  });
+
+  it.each([
+    '(() => 42)',
+    '((() => 42))',
+    '(function () { return 42; })',
+    '(workload)',
+    '((workload))',
+    '(/* before */ (() => 42) /* after */), /* trailing */',
+    '(() => 42 // trailing line comment\n)',
+  ])('preserves parenthesized workload arguments: %s', async (callback) => {
+    const result = migrate(`const workload = () => 42; bench('work', ${callback});`, true);
+    expect(result.findings).toEqual([]);
+    const tests: Array<(context: unknown) => Promise<void>> = [];
+    runInNewContext(result.content, {
+      test: (_name: string, fn: (context: unknown) => Promise<void>) => tests.push(fn),
+    });
+    expect(tests).toHaveLength(1);
+    let executions = 0;
+    await tests[0]({
+      bench: (name: string, fn: () => number) => ({
+        run: () => {
+          expect(name).toBe('work');
+          expect(fn()).toBe(42);
+          executions++;
+        },
+      }),
+    });
+    expect(executions).toBe(1);
+    expect(migrate(result.content, true)).toEqual({ content: result.content, findings: [] });
+  });
+
+  it.each([
+    `function workload() { return 42; }`,
+    `const workload = () => 42;`,
+    `const workload = async function () { return 42; };`,
+    `const original = () => 42; const workload = original;`,
+  ])('resolves a local zero-argument workload: %s', (declaration) => {
+    const result = migrate(
+      `import { bench } from 'vitest'; ${declaration} bench('local', workload);`,
+    );
+    expect(result.findings).toEqual([]);
+    expect(result.content).toContain('const _benchFn = workload;');
+    expect(result.content).toContain(`await bench('local', _benchFn).run()`);
+    expect(migrate(result.content)).toEqual({ content: result.content, findings: [] });
+  });
+
+  it.each([
+    `let workload = () => 1; bench('mutable', workload); workload = () => 2;`,
+    `const workload = (task) => task; bench('context', workload);`,
+    `function* workload() { yield 1; } bench('generator', workload);`,
+    `const a = b; const b = a; bench('cycle', a);`,
+    `import { workload } from './workload.js'; bench('import', workload);`,
+    `declare function workload(): void; bench('declared', workload);`,
+  ])('does not guess callback semantics: %s', (body) => {
+    const input = `import { bench } from 'vitest'; ${body}`;
+    const result = migrate(input);
+    expect(result.content).toBe(input);
+    expect(result.findings).toContainEqual(
+      expect.objectContaining({ code: 'benchmark-api', severity: 'block' }),
+    );
+  });
+
+  it.each([
+    `bench(getName(), workload);`,
+    `(bench(getName(), workload));`,
+    `bench((getName(), 'dynamic'), workload);`,
+    `if (true) bench(getName(), workload); else throw Error('unreachable');`,
+    `for (let i = 0; i < 1; i++) bench(getName(), workload);`,
+    `label: bench(getName(), workload);`,
+  ])(
+    'captures dynamic names once at registration and preserves callback identity: %s',
+    async (call) => {
+      const result = migrate(
+        `function workload() { events.push('work'); }
+      ${call}
+      events.push('registered');`,
+        true,
+      );
+      expect(result.findings).toEqual([]);
+      const events: string[] = [];
+      const tests: Array<{ name: string; fn: (context: unknown) => Promise<void> }> = [];
+      const context = {
+        events,
+        getName: () => {
+          events.push('name');
+          return 'dynamic';
+        },
+        test: (name: string, fn: (context: unknown) => Promise<void>) => tests.push({ name, fn }),
+      };
+      runInNewContext(result.content, context);
+      const original = runInNewContext('workload', context);
+      expect(events).toEqual(['name', 'registered']);
+      expect(tests.map(({ name }) => name)).toEqual(['dynamic']);
+      await tests[0].fn({
+        bench: (name: string, fn: () => void) => {
+          expect(name).toBe('dynamic');
+          expect(fn).toBe(original);
+          return {
+            run: async () => {
+              fn();
+              fn();
+            },
+          };
+        },
+      });
+      expect(events).toEqual(['name', 'registered', 'work', 'work']);
+      expect(migrate(result.content, true)).toEqual({ content: result.content, findings: [] });
+    },
+  );
+
+  it('retains argument evaluation order and temporal dead zones', () => {
+    const result = migrate(`bench(getName(), workload); const workload = () => {};`, true);
+    expect(result.findings).toEqual([]);
+    const events: string[] = [];
+    expect(() =>
+      runInNewContext(result.content, {
+        getName: () => {
+          events.push('name');
+          return 'case';
+        },
+        test: () => {
+          events.push('test');
+        },
+      }),
+    ).toThrow(/before initialization/);
+    expect(events).toEqual(['name']);
+  });
+
+  it('captures a changing name for an inline workload and preserves lexical this', async () => {
+    const result = migrate(
+      `let name = 'before';
+      bench(name, () => this.value);
+      name = 'after';`,
+      true,
+    );
+    expect(result.findings).toEqual([]);
+    const tests: Array<{ name: string; fn: (context: unknown) => Promise<void> }> = [];
+    runInNewContext(result.content, {
+      value: 42,
+      test: (name: string, fn: (context: unknown) => Promise<void>) => tests.push({ name, fn }),
+    });
+    expect(tests[0].name).toBe('before');
+    await tests[0].fn({
+      bench: (name: string, fn: () => number) => ({
+        run: async () => {
+          expect(name).toBe('before');
+          expect(fn()).toBe(42);
+        },
+      }),
+    });
+  });
+
+  it.each([
+    `bench('options', () => work(), { time: 10 });`,
+    `bench('callback', workload);`,
+    `bench('context', (task) => work(task));`,
+    `bench('generator', function* () { yield 1; });`,
+    `bench.each(cases)('case', () => work());`,
+    `bench.skipIf(condition)('case', () => work());`,
+    `const alias = bench; alias('case', () => work());`,
+    `register(bench);`,
+    `export { bench };`,
+    `const result = bench('value', () => work());`,
+    `function helper() { bench('helper', () => work()); }`,
+    `bench('outer', () => { bench('inner', () => work()); });`,
+    `bench?.('optional', () => work());`,
+  ])('retains unsupported references without retargeting their import: %s', (call) => {
+    const input = `import { bench } from 'vitest'; ${call}`;
+    const result = migrate(input);
+    expect(result.content).toBe(input);
+    expect(result.findings).toContainEqual(
+      expect.objectContaining({ code: 'benchmark-api', severity: 'block' }),
+    );
+  });
+
+  it('does not partly migrate an import shared by direct and escaped references', () => {
+    const input = `import { bench } from 'vitest'; bench('direct', () => work()); register(bench);`;
+    expect(migrate(input).content).toBe(input);
+  });
+
+  it('leaves another library and shadowed bench parameters untouched', () => {
+    const input = `import { bench } from 'another-library';
+bench('other', () => work());
+function helper(bench) { bench('local', () => work()); }`;
+    expect(migrate(input, true)).toEqual({ content: input, findings: [] });
+  });
+
+  it('registers globals without running workloads and awaits benchmark execution', async () => {
+    const input = `describe('group', () => {
+  const value = 42;
+  bench('workload', async () => { await Promise.resolve(); results.push(value); });
+});`;
+    const result = migrate(input, true);
+    expect(result.findings).toEqual([]);
+    const results: number[] = [];
+    const tests: Array<{ name: string; fn: (context: unknown) => Promise<void> }> = [];
+    runInNewContext(result.content, {
+      results,
+      describe: (_name: string, fn: () => void) => fn(),
+      test: (name: string, fn: (context: unknown) => Promise<void>) => tests.push({ name, fn }),
+    });
+    expect(results).toEqual([]);
+    expect(tests.map(({ name }) => name)).toEqual(['workload']);
+    await tests[0].fn({
+      bench: (name: string, fn: () => Promise<void>) => ({
+        run: async () => {
+          expect(name).toBe('workload');
+          await fn();
+          await fn();
+        },
+      }),
+    });
+    expect(results).toEqual([42, 42]);
+  });
+
+  it.each([
+    'vitest bench',
+    'vitest bench --run',
+    'vp test bench',
+    'pnpm exec vitest bench',
+    'vitest bench && echo done',
+  ])('keeps the supported command %s', (command) => {
+    expect(migrateVitestV5Command('package.json', command, true)).toEqual({
+      content: command,
+      findings: [],
+    });
+  });
+});
diff --git a/packages/cli/src/migration/__tests__/vitest-v5-compatibility.spec.ts b/packages/cli/src/migration/__tests__/vitest-v5-compatibility.spec.ts
new file mode 100644
index 0000000000..62244bc4ec
--- /dev/null
+++ b/packages/cli/src/migration/__tests__/vitest-v5-compatibility.spec.ts
@@ -0,0 +1,184 @@
+import fs from 'node:fs';
+import { runInNewContext } from 'node:vm';
+
+import { describe, expect, it } from 'vitest';
+
+import { parseSource, SourceEditor } from '../vitest-v5/ast.ts';
+import { migrateVitestV5Config } from '../vitest-v5/config.ts';
+
+const options = { preserveV4: true, temporalPolyfill: true };
+const migrate = (source: string) => migrateVitestV5Config('vitest.config.mjs', source, options);
+const evaluate = (source: string) => runInNewContext(source.replace('export default', ''));
+
+describe('Vitest v4 compatibility comments', () => {
+  it.each([
+    ['export default {}', 'clearMocks: false', 'clearmocks-is-enabled-by-default'],
+    ['export default { test: {} }', 'clearMocks: false', 'clearmocks-is-enabled-by-default'],
+    [
+      'export default { test: { projects: [{ test: {} }] } }',
+      'sharedViteServer: false',
+      'inline-projects-share-the-vite-server-by-default',
+    ],
+    [
+      'export default { test: { projects: [{}] } }',
+      'extends: false',
+      'inline-projects-inherit-the-root-config-by-default',
+    ],
+    ['export default { test: { browser: {} } }', 'exact: false', 'locators-are-strict-by-default'],
+    [
+      'export default { test: { browser: { locators: {} } } }',
+      'exact: false',
+      'locators-are-strict-by-default',
+    ],
+    [
+      "export default { test: { coverage: { thresholds: { perFile: true, 'src/**': { lines: 90 } } } } }",
+      'perFile: true',
+      'glob-coverage-thresholds-no-longer-inherit-perfile',
+    ],
+    ...[
+      'export default {}',
+      'export default { test: {} }',
+      'export default { test: { fakeTimers: {} } }',
+    ].map((source) => [
+      source,
+      "toNotFake: ['Temporal']",
+      'fake-timers-and-setsystemtime-now-mock-temporal',
+    ]),
+  ])('documents a newly inserted %s setting: %s', (source, setting, section) => {
+    const result = migrate(source);
+    expect(result.findings).toEqual([]);
+    const comments = parseSource('vitest.config.mjs', result.content).comments;
+    const link = `// https://vitest.dev/guide/migration/#${section}`;
+    const index = comments.findIndex((span) => result.content.slice(span.start, span.end) === link);
+    expect(index).toBeGreaterThanOrEqual(2);
+    expect(result.content.slice(comments[index - 2].start, comments[index - 2].end)).toMatch(
+      /^\/\/ Vitest v4 compatibility: .+\.$/,
+    );
+    expect(result.content.slice(comments[index - 1].start, comments[index - 1].end)).toMatch(
+      /^\/\/ (Remove|Keep) .+\.$/,
+    );
+    expect(result.content.slice(comments[index].end).trimStart().startsWith(setting)).toBe(true);
+    expect(migrate(result.content)).toEqual(result);
+    expect(
+      migrateVitestV5Config('vitest.config.mjs', result.content, { preserveV4: false }),
+    ).toEqual(result);
+    const withoutComments = result.content.replace(/^[\t ]*\/\/.*(?:\r?\n|$)/gm, '');
+    expect(migrate(withoutComments)).toEqual({ content: withoutComments, findings: [] });
+    const guide = fs.readFileSync(
+      new URL('../../../../../docs/guide/vitest-v5.md', import.meta.url),
+      'utf8',
+    );
+    expect(guide).toContain(link.slice(3));
+  });
+
+  it.each([
+    "['json' /* Report consumer. */]",
+    "['json', /* Report consumer. */]",
+    "['json' // Report consumer.\n]",
+  ])('retains comments in a reporter tuple: %s', (reporter) => {
+    const input = `export default ({ test: { reporters: [${reporter}] } });`;
+    const result = migrate(input);
+    expect(result.findings).toEqual([]);
+    expect(result.content).toContain('Report consumer.');
+    expect(result.content).toContain(`reporters: [${reporter}]`);
+    expect(result.content).not.toContain('stdout');
+    expect(evaluate(result.content).test.reporters).toEqual([['json']]);
+    expect(migrate(result.content)).toEqual(result);
+  });
+
+  it.each(['\n', '\r\n'])(
+    'preserves settings and line endings through nested insertion (%j)',
+    (newline) => {
+      const input = `export default ({
+  test: {
+    // Keep this project comment.
+    projects: [{}],
+    browser: {},
+    reporters: ['json', ['junit', {}]],
+    coverage: { thresholds: { perFile: true, 'src/**': { lines: 90 } } },
+  },
+});`.replaceAll('\n', newline);
+      const result = migrate(input);
+      expect(result.findings).toEqual([]);
+      expect(result.content).toContain('// Keep this project comment.');
+      if (newline === '\r\n') {
+        expect(result.content.replaceAll('\r\n', '')).not.toContain('\n');
+      }
+      expect(evaluate(result.content)).toEqual({
+        test: {
+          clearMocks: false,
+          sharedViteServer: false,
+          fakeTimers: { toNotFake: ['Temporal'] },
+          projects: [
+            {
+              extends: false,
+              test: { clearMocks: false, fakeTimers: { toNotFake: ['Temporal'] } },
+            },
+          ],
+          browser: { locators: { exact: false } },
+          reporters: ['json', ['junit', {}]],
+          coverage: { thresholds: { perFile: true, 'src/**': { perFile: true, lines: 90 } } },
+        },
+      });
+      expect(migrate(result.content)).toEqual(result);
+    },
+  );
+
+  it.each(['true', 'false'])(
+    'leaves explicit settings and their comments untouched (%s)',
+    (value) => {
+      const input = `export default {
+  test: {
+    // Our mock policy.
+    clearMocks: ${value},
+    sharedViteServer: ${value},
+    projects: [{ extends: ${value}, test: { clearMocks: ${value}, fakeTimers: { toNotFake: [] } } }],
+    browser: { locators: { exact: ${value} } },
+    reporters: [['json', { stdout: ${value} }]],
+    coverage: { thresholds: { perFile: true, 'src/**': { perFile: ${value}, lines: 90 } } },
+    fakeTimers: { toNotFake: ['Date'] },
+  },
+};`;
+      expect(migrate(input)).toEqual({ content: input, findings: [] });
+    },
+  );
+
+  it('indents generated comments inside compact inline projects', () => {
+    const input = `export default {
+  test: {
+    projects: [{ test: { name: 'unit' } }],
+  },
+};`;
+    const result = migrate(input);
+    expect(result.findings).toEqual([]);
+    expect(result.content).toContain(
+      '\n      extends: false,\n      test: {\n        // Vitest v4 compatibility: preserve mock call history.',
+    );
+    expect(result.content).toContain("\n        name: 'unit'");
+    expect(migrate(result.content)).toEqual(result);
+  });
+
+  it('does not annotate permanent API moves or v5 configs', () => {
+    const input = 'export default { test: { browser: { api: { port: 1234 } }, projects: [{}] } };';
+    const result = migrateVitestV5Config('vitest.config.mjs', input, { preserveV4: false });
+    expect(result.findings).toEqual([]);
+    expect(result.content).toContain('api: { port: 1234 }');
+    expect(result.content).not.toContain('Vitest v4 compatibility');
+  });
+
+  it('does not reindent copied multiline expressions when adding comments', () => {
+    const input = 'export default ({ test: { value: `first\n  second` } });';
+    const result = migrate(input);
+    expect(result.findings).toEqual([]);
+    expect(evaluate(result.content).test.value).toBe('first\n  second');
+    const editor = new SourceEditor('vitest.config.mjs', 'export default ({});');
+    editor.visit({
+      ObjectExpression(node) {
+        editor.add(node, 'copied', '`first\n  second`', '// Preserve this expression.');
+      },
+    });
+    const added = editor.finish();
+    expect(added.findings).toEqual([]);
+    expect(evaluate(added.content).copied).toBe('first\n  second');
+  });
+});
diff --git a/packages/cli/src/migration/__tests__/vitest-v5-documentation.spec.ts b/packages/cli/src/migration/__tests__/vitest-v5-documentation.spec.ts
new file mode 100644
index 0000000000..e1988a59dc
--- /dev/null
+++ b/packages/cli/src/migration/__tests__/vitest-v5-documentation.spec.ts
@@ -0,0 +1,65 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+import { expect, it } from 'vitest';
+
+import { formatVitestV5Findings } from '../migrator.ts';
+import { vitestV5Documentation } from '../vitest-v5/documentation.ts';
+
+it.each([
+  ['benchmark-api', 'https://vitest.dev/guide/migration/#benchmarking-api-rewrite'],
+  ['node-runtime', 'https://viteplus.dev/guide/vitest-v5#node-runtime'],
+  ['source-version', 'https://viteplus.dev/guide/vitest-v5#before-you-migrate'],
+  ['global-api-ownership', 'https://viteplus.dev/guide/vitest-v5#resolve-migration-findings'],
+  [
+    'unawaited-assertion',
+    'https://vitest.dev/guide/migration/#unawaited-asynchronous-assertions-fail-the-test',
+  ],
+  ['future-finding', 'https://viteplus.dev/guide/vitest-v5#resolve-migration-findings'],
+])('links %s to its documentation', (code, url) => {
+  expect(vitestV5Documentation(code)).toBe(url);
+});
+
+it('links every block and review, retaining locations and deduplication', () => {
+  const rootDir = process.cwd();
+  const block = {
+    file: path.join(rootDir, 'example.bench.ts'),
+    line: 3,
+    column: 5,
+    code: 'benchmark-api',
+    severity: 'block' as const,
+    message: 'Review the benchmark.',
+  };
+  const review = {
+    ...block,
+    line: 7,
+    code: 'future-finding',
+    severity: 'review' as const,
+    message: 'Review the configuration.',
+  };
+  const report = formatVitestV5Findings({ rootDir, findings: [block, review, block] });
+  expect(report).toContain('Vitest v5: 2 review items (1 block dependency updates)');
+  expect(report).toContain(
+    `3:5 BLOCK [benchmark-api] Review the benchmark.\n    Docs: ${vitestV5Documentation('benchmark-api')}`,
+  );
+  expect(report).toContain(
+    `7:5 REVIEW [future-finding] Review the configuration.\n    Docs: ${vitestV5Documentation('future-finding')}`,
+  );
+  expect(report.match(/Docs:/g)).toHaveLength(2);
+  expect(formatVitestV5Findings({ rootDir, findings: [] })).toBe('');
+});
+
+it('keeps local documentation anchors valid', () => {
+  const source = fs.readFileSync(new URL('../vitest-v5/documentation.ts', import.meta.url), 'utf8');
+  const guide = fs.readFileSync(
+    new URL('../../../../../docs/guide/vitest-v5.md', import.meta.url),
+    'utf8',
+  );
+  const localSections = source.slice(source.indexOf('const localSections'));
+  const headings = [...guide.matchAll(/^## (.+)$/gm)].map((match) =>
+    match[1].toLowerCase().replaceAll(' ', '-'),
+  );
+  for (const match of localSections.matchAll(/'[^']+': '([^']+)'/g)) {
+    expect(headings).toContain(match[1]);
+  }
+});
diff --git a/packages/cli/src/migration/__tests__/vitest-v5-lockfile.spec.ts b/packages/cli/src/migration/__tests__/vitest-v5-lockfile.spec.ts
new file mode 100644
index 0000000000..8ce6932299
--- /dev/null
+++ b/packages/cli/src/migration/__tests__/vitest-v5-lockfile.spec.ts
@@ -0,0 +1,146 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+import { afterEach, describe, expect, it } from 'vitest';
+
+import { PackageManager } from '../../types/index.ts';
+import { applyVitestV5Migration, planVitestV5Migration } from '../migrator.ts';
+
+const directories: string[] = [];
+afterEach(() => {
+  for (const directory of directories.splice(0)) {
+    fs.rmSync(directory, { recursive: true, force: true });
+  }
+});
+
+const formats = ['npm', 'yarn', 'yarn-classic', 'bun'] as const;
+function project(
+  format: (typeof formats)[number],
+  spec = '^4 || ^5',
+  version = '4.1.11',
+  lockedSpec = spec,
+) {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'vp-vitest-lock-'));
+  directories.push(root);
+  fs.writeFileSync(
+    path.join(root, 'package.json'),
+    JSON.stringify({ devDependencies: { vitest: spec } }),
+  );
+  fs.writeFileSync(path.join(root, 'vite.config.ts'), 'export default { test: {} };');
+  const manifest = { devDependencies: { vitest: lockedSpec } };
+  let filename: string;
+  let content: string;
+  if (format === 'npm') {
+    filename = 'package-lock.json';
+    content = JSON.stringify({
+      lockfileVersion: 3,
+      packages: { '': manifest, 'node_modules/vitest': { version } },
+    });
+  } else if (format === 'bun') {
+    filename = 'bun.lock';
+    content = JSON.stringify({
+      lockfileVersion: 1,
+      workspaces: { '': manifest },
+      packages: { vitest: [`vitest@${version}`, '', {}, 'sha512-test'] },
+    });
+  } else if (format === 'yarn') {
+    filename = 'yarn.lock';
+    content = `__metadata:\n  version: 8\n${JSON.stringify(`vitest@npm:${lockedSpec}`)}:\n  version: ${version}\n  resolution: "vitest@npm:${version}"\n`;
+  } else {
+    filename = 'yarn.lock';
+    content = `# yarn lockfile v1\n\n${JSON.stringify(`vitest@${lockedSpec}`)}:\n  version "${version}"\n  resolved "https://registry.npmjs.org/vitest/-/vitest-${version}.tgz"\n`;
+  }
+  fs.writeFileSync(path.join(root, filename), content);
+  const manager = format === 'yarn-classic' ? PackageManager.yarn : PackageManager[format];
+  return {
+    root,
+    file: path.join(root, filename),
+    plan: () => planVitestV5Migration({ rootDir: root, packageManager: manager }),
+  };
+}
+
+describe('Vitest source versions from non-pnpm lockfiles', () => {
+  it.each(
+    formats.flatMap((format) => ['4.1.11', '5.0.0'].map((version) => [format, version] as const)),
+  )('uses the original %s lockfile runner %s without node_modules', (format, version) => {
+    const fixture = project(format, '^4 || ^5', version);
+    const plan = fixture.plan();
+    expect(plan.projects[0].sourceVersion).toBe(version);
+    expect(plan.projects[0].options.preserveV4).toBe(version.startsWith('4'));
+    expect(plan.findings).toEqual([]);
+    fs.appendFileSync(fixture.file, '\n');
+    expect(() => applyVitestV5Migration(plan)).toThrow('Migration input changed');
+  });
+
+  it.each(formats.flatMap((format) => ['latest', '*'].map((spec) => [format, spec] as const)))(
+    'resolves %s lockfile dist-tags and broad ranges: %s',
+    (format, spec) => {
+      expect(project(format, spec).plan().projects[0].sourceVersion).toBe('4.1.11');
+    },
+  );
+
+  it.each(formats)('rejects stale %s importer/descriptor edges', (format) => {
+    const plan = project(format, '^4 || ^5', '4.1.11', '^4.0.0').plan();
+    expect(plan.findings).toContainEqual(
+      expect.objectContaining({ code: 'source-version', severity: 'block' }),
+    );
+  });
+
+  it.each(formats)('rejects malformed %s locks', (format) => {
+    const fixture = project(format);
+    fs.writeFileSync(fixture.file, '{ invalid');
+    expect(fixture.plan().projects[0].sourceVersion).toBeUndefined();
+  });
+
+  it('resolves a workspace npm edge before an unrelated root runner', () => {
+    const fixture = project('npm');
+    const pkg = { devDependencies: { vitest: '^4 || ^5' } };
+    fs.mkdirSync(path.join(fixture.root, 'packages/unit'), { recursive: true });
+    fs.writeFileSync(path.join(fixture.root, 'packages/unit/package.json'), JSON.stringify(pkg));
+    fs.writeFileSync(
+      fixture.file,
+      JSON.stringify({
+        lockfileVersion: 3,
+        packages: {
+          '': pkg,
+          'packages/unit': pkg,
+          'node_modules/vitest': { version: '5.0.0' },
+          'packages/unit/node_modules/vitest': { version: '4.1.11' },
+        },
+      }),
+    );
+    const plan = planVitestV5Migration({
+      rootDir: fixture.root,
+      packageManager: PackageManager.npm,
+      packages: [{ name: 'unit', path: 'packages/unit' }],
+    });
+    expect(plan.projects.map(({ sourceVersion }) => sourceVersion)).toEqual(['5.0.0', '4.1.11']);
+  });
+
+  it('handles grouped Yarn classic descriptors', () => {
+    const fixture = project('yarn-classic');
+    fs.writeFileSync(
+      fixture.file,
+      `# yarn lockfile v1\n\n"vitest@^4 || ^5", vitest@^4.1.0:\n  version "4.1.11"\n`,
+    );
+    expect(fixture.plan().projects[0].sourceVersion).toBe('4.1.11');
+  });
+
+  it('rejects ambiguous Bun layouts instead of choosing a transitive version', () => {
+    const fixture = project('bun');
+    const lock = JSON.parse(fs.readFileSync(fixture.file, 'utf8'));
+    lock.packages['other/vitest'] = ['vitest@5.0.0', '', {}, 'sha512-test'];
+    fs.writeFileSync(fixture.file, JSON.stringify(lock));
+    expect(fixture.plan().projects[0].sourceVersion).toBeUndefined();
+  });
+
+  it('does not use an unrelated nested Bun runner as the direct dependency', () => {
+    const fixture = project('bun');
+    const lock = JSON.parse(fs.readFileSync(fixture.file, 'utf8'));
+    lock.packages['other/vitest'] = lock.packages.vitest;
+    delete lock.packages.vitest;
+    fs.writeFileSync(fixture.file, JSON.stringify(lock));
+    expect(fixture.plan().projects[0].sourceVersion).toBeUndefined();
+  });
+});
diff --git a/packages/cli/src/migration/__tests__/vitest-v5-webdriverio.spec.ts b/packages/cli/src/migration/__tests__/vitest-v5-webdriverio.spec.ts
new file mode 100644
index 0000000000..888d232e76
--- /dev/null
+++ b/packages/cli/src/migration/__tests__/vitest-v5-webdriverio.spec.ts
@@ -0,0 +1,324 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+import semver from 'semver';
+import { afterEach, describe, expect, it } from 'vitest';
+import { parse as yaml } from 'yaml';
+
+import { PackageManager } from '../../types/index.ts';
+import {
+  applyVitestV5Migration,
+  finishVitestV5Migration,
+  planVitestV5Migration,
+  vitestV5NeedsMigration,
+} from '../migrator.ts';
+import { webdriverioMigrationSpec } from '../vitest-v5/webdriverio.ts';
+
+const provider = '@vitest/browser-webdriverio';
+const directories: string[] = [];
+afterEach(() => {
+  for (const dir of directories.splice(0)) {
+    fs.rmSync(dir, { recursive: true, force: true });
+  }
+});
+function project(pkg: Record<string, unknown>, files: Record<string, string> = {}) {
+  const rootDir = fs.mkdtempSync(path.join(os.tmpdir(), 'vp-webdriverio-migrate-'));
+  directories.push(rootDir);
+  for (const [file, text] of Object.entries({
+    'package.json': JSON.stringify({ name: 'app', ...pkg }),
+    'node_modules/vitest/package.json': JSON.stringify({ name: 'vitest', version: '4.1.11' }),
+    ...files,
+  })) {
+    fs.mkdirSync(path.dirname(path.join(rootDir, file)), { recursive: true });
+    fs.writeFileSync(path.join(rootDir, file), text);
+  }
+  return rootDir;
+}
+function read(root: string, file = 'package.json') {
+  const text = fs.readFileSync(path.join(root, file), 'utf8');
+  return file.endsWith('.json') ? JSON.parse(text) : yaml(text);
+}
+function migrate(
+  rootDir: string,
+  packageManager: PackageManager = PackageManager.pnpm,
+  packages?: { name: string; path: string }[],
+) {
+  const workspace = { rootDir, packageManager, packages };
+  const plan = planVitestV5Migration(workspace);
+  expect(plan.findings).toEqual([]);
+  applyVitestV5Migration(plan);
+  expect(finishVitestV5Migration(plan)).toEqual([]);
+  expect(planVitestV5Migration(workspace).changes).toEqual([]);
+  return plan;
+}
+
+describe('WebDriverIO migration floor', () => {
+  it.each(['4.1.11', '^4.1.11', '~4.0.0', '5.0.0-beta.5'])('upgrades %s', (spec) => {
+    expect(webdriverioMigrationSpec(spec)).toBe('^5.0.0');
+  });
+  it.each(['5.0.0', '^5.2.0', '~5.1.1', '^6.0.0', '>=5', '5 || 6'])('preserves %s', (spec) => {
+    expect(webdriverioMigrationSpec(spec)).toBe(spec);
+  });
+  it.each(['*', '>=4', '^4 || ^5.2', '4.1.11 || 6.1.0', '^5.0.0-beta.5'])(
+    'narrows %s without allowing v4',
+    (spec) => {
+      const result = webdriverioMigrationSpec(spec)!;
+      expect(semver.subset(result, '>=5.0.0')).toBe(true);
+      for (const version of ['5.0.0', '5.2.0', '6.1.0', '7.0.0']) {
+        expect(semver.satisfies(version, result)).toBe(semver.satisfies(version, spec));
+      }
+      expect(webdriverioMigrationSpec(result)).toBe(result);
+    },
+  );
+  it('preserves registry alias identity', () => {
+    expect(webdriverioMigrationSpec(`npm:${provider}@^4.1.11`)).toBe(`npm:${provider}@^5.0.0`);
+  });
+
+  it.each([PackageManager.npm, PackageManager.pnpm, PackageManager.yarn, PackageManager.bun])(
+    'upgrades v4 on %s and composes manifest runtime edits',
+    (manager) => {
+      const root = project({
+        devDependencies: { vitest: '4.1.11', [provider]: '^4.1.11', webdriverio: '^9.0.0' },
+        devEngines: { runtime: { name: 'node', version: '20.19.0' } },
+        scripts: { bench: 'vitest bench --run' },
+      });
+      migrate(root, manager);
+      const pkg = read(root);
+      expect(pkg.devDependencies[provider]).toBe('^5.0.0');
+      expect(pkg.devDependencies.webdriverio).toBe('^9.0.0');
+      expect(pkg.devEngines.runtime.version).not.toBe('20.19.0');
+      expect(pkg.scripts.bench).toBe('vitest bench --run');
+    },
+  );
+  it.each(['dependencies', 'devDependencies', 'optionalDependencies'])(
+    'updates %s in place',
+    (field) => {
+      const root = project({ [field]: { [provider]: '4.1.11', webdriverio: '^9.0.0' } });
+      migrate(root);
+      expect(read(root)[field][provider]).toBe('^5.0.0');
+    },
+  );
+  it('migrates a Vite+ 0.x source-only import and reuses a WebDriverIO sibling version', () => {
+    const root = project(
+      { devDependencies: { 'vite-plus': '0.3.2', '@wdio/cli': '^9.20.0' } },
+      {
+        'vite.config.ts':
+          "import { webdriverio } from 'vite-plus/test/browser-webdriverio'; export default {};",
+      },
+    );
+    const plan = migrate(root);
+    expect(vitestV5NeedsMigration(plan)).toBe(true);
+    expect(read(root).devDependencies).toMatchObject({
+      [provider]: '^5.0.0',
+      webdriverio: '^9.20.0',
+    });
+    expect(fs.readFileSync(path.join(root, 'vite.config.ts'), 'utf8')).toContain(
+      `from "${provider}"`,
+    );
+  });
+  it('preserves newer provider and framework declarations', () => {
+    const root = project({
+      devDependencies: { vitest: '5.0.1', [provider]: '^6.0.0', webdriverio: '^10.0.0' },
+    });
+    const plan = migrate(root);
+    expect(plan.changes).toEqual([]);
+    expect(vitestV5NeedsMigration(plan)).toBe(false);
+  });
+  it('adds a dev dependency without narrowing a public peer range', () => {
+    const root = project({
+      peerDependencies: { [provider]: '^4 || ^5' },
+      devDependencies: { webdriverio: '^9' },
+    });
+    migrate(root);
+    expect(read(root).peerDependencies[provider]).toBe('^4 || ^5');
+    expect(semver.subset(read(root).devDependencies[provider], '>=5.0.0')).toBe(true);
+  });
+  it('reuses a newer peer-only provider without downgrading it', () => {
+    const root = project({
+      peerDependencies: { [provider]: '^6.2.0' },
+      devDependencies: { webdriverio: '^9' },
+    });
+    migrate(root);
+    expect(read(root).devDependencies[provider]).toBe('^6.2.0');
+  });
+  it('reuses a root provider catalog for a source-only workspace member', () => {
+    const root = project(
+      { devDependencies: { [provider]: 'catalog:browser', webdriverio: '^9' } },
+      {
+        'pnpm-workspace.yaml': JSON.stringify({ catalogs: { browser: { [provider]: '^6.2.0' } } }),
+        'packages/app/package.json': JSON.stringify({
+          name: 'child',
+          devDependencies: { vitest: '4.1.11', webdriverio: '^9' },
+        }),
+        'packages/app/vitest.config.ts': `import { webdriverio } from '${provider}'; export default {};`,
+      },
+    );
+    migrate(root, PackageManager.pnpm, [{ name: 'child', path: 'packages/app' }]);
+    expect(read(root, 'packages/app/package.json').devDependencies[provider]).toBe(
+      'catalog:browser',
+    );
+    expect(read(root, 'pnpm-workspace.yaml').catalogs.browser[provider]).toBe('^6.2.0');
+  });
+  it('keeps a compatible npm override unchanged', () => {
+    const root = project({
+      devDependencies: { [provider]: '5.2.0', webdriverio: '^9' },
+      overrides: { [provider]: '5.2.0' },
+    });
+    const plan = migrate(root, PackageManager.npm);
+    expect(read(root).overrides[provider]).toBe('5.2.0');
+    expect(plan.findings).toEqual([]);
+  });
+  it('updates npm long-form pins without changing unrelated children', () => {
+    const root = project({
+      devDependencies: { [provider]: '4.1.11', webdriverio: '^9' },
+      overrides: { [provider]: { '.': '4.1.11', other: '1.0.0' } },
+    });
+    migrate(root, PackageManager.npm);
+    expect(read(root).overrides[provider]).toEqual({ other: '1.0.0' });
+  });
+  it.each([PackageManager.pnpm, PackageManager.yarn, PackageManager.bun])(
+    'updates referenced catalogs on %s',
+    (manager) => {
+      const catalogs = {
+        catalog: { [provider]: '4.1.11' },
+        catalogs: { browser: { [provider]: '^4.1.11' }, unused: { [provider]: '4.0.0' } },
+      };
+      const configFile = manager === PackageManager.yarn ? '.yarnrc.yml' : 'pnpm-workspace.yaml';
+      const root = project(
+        {
+          devDependencies: { [provider]: 'catalog:', webdriverio: '^9' },
+          ...(manager === PackageManager.bun
+            ? { workspaces: { packages: ['packages/*'], ...catalogs } }
+            : {}),
+        },
+        {
+          ...(manager === PackageManager.bun ? {} : { [configFile]: JSON.stringify(catalogs) }),
+          'packages/browser/package.json': JSON.stringify({
+            name: 'browser',
+            devDependencies: { [provider]: 'catalog:browser', webdriverio: '^9' },
+          }),
+        },
+      );
+      migrate(root, manager, [{ name: 'browser', path: 'packages/browser' }]);
+      const output =
+        manager === PackageManager.bun ? read(root).workspaces : read(root, configFile);
+      expect(output.catalog[provider]).toBe('^5.0.0');
+      expect(output.catalogs.browser[provider]).toBe('^5.0.0');
+      expect(output.catalogs.unused[provider]).toBe('4.0.0');
+      expect(read(root).devDependencies[provider]).toBe('catalog:');
+      expect(read(root, 'packages/browser/package.json').devDependencies[provider]).toBe(
+        'catalog:browser',
+      );
+    },
+  );
+  it.each([PackageManager.npm, PackageManager.pnpm, PackageManager.yarn, PackageManager.bun])(
+    'updates applicable override pins on %s only',
+    (manager) => {
+      const overrides = {
+        [provider]: '4.1.11',
+        [`app>${provider}`]: '^4',
+        [`unrelated>${provider}`]: '4.0.0',
+        unrelated: { [provider]: '4.0.0' },
+      };
+      const field = manager === PackageManager.yarn ? 'resolutions' : 'overrides';
+      const root = project({
+        devDependencies: { [provider]: '^5.2.0', webdriverio: '^9' },
+        [field]: overrides,
+      });
+      migrate(root, manager);
+      const output = read(root)[field];
+      expect(output[provider]).toBeUndefined();
+      expect(output[`app>${provider}`]).toBeUndefined();
+      expect(output[`unrelated>${provider}`]).toBe('4.0.0');
+      expect(output.unrelated[provider]).toBe('4.0.0');
+      expect(read(root).devDependencies[provider]).toBe('^5.2.0');
+    },
+  );
+  it.each([PackageManager.npm, PackageManager.pnpm])(
+    'removes an old alias override without downgrading a newer provider on %s',
+    (manager) => {
+      const root = project({
+        devDependencies: { [provider]: '^6', webdriverio: '^9' },
+        overrides: { [provider]: `npm:${provider}@4.1.11` },
+      });
+      migrate(root, manager);
+      expect(read(root).overrides[provider]).toBeUndefined();
+      expect(read(root).devDependencies[provider]).toBe('^6');
+    },
+  );
+  it('removes scoped pnpm catalog overrides without downgrading a newer provider', () => {
+    const root = project(
+      { devDependencies: { [provider]: '^6', webdriverio: '^9' } },
+      {
+        'pnpm-workspace.yaml': JSON.stringify({
+          catalogs: { old: { [provider]: '4.1.11' } },
+          overrides: {
+            [`app>${provider}`]: 'catalog:old',
+            [`unrelated>${provider}`]: '4.0.0',
+          },
+        }),
+      },
+    );
+    migrate(root);
+    expect(read(root, 'pnpm-workspace.yaml').catalogs.old[provider]).toBe('4.1.11');
+    expect(read(root, 'pnpm-workspace.yaml').overrides[`app>${provider}`]).toBeUndefined();
+    expect(read(root, 'pnpm-workspace.yaml').overrides[`unrelated>${provider}`]).toBe('4.0.0');
+    expect(read(root).devDependencies[provider]).toBe('^6');
+  });
+  it('retains an override that shares the upgraded dependency catalog', () => {
+    const root = project(
+      { devDependencies: { [provider]: 'catalog:browser', webdriverio: '^9' } },
+      {
+        'pnpm-workspace.yaml': JSON.stringify({
+          catalogs: { browser: { [provider]: '4.1.11' } },
+          overrides: { [provider]: 'catalog:browser' },
+        }),
+      },
+    );
+    migrate(root);
+    expect(read(root, 'pnpm-workspace.yaml').catalogs.browser[provider]).toBe('^5.0.0');
+    expect(read(root, 'pnpm-workspace.yaml').overrides[provider]).toBe('catalog:browser');
+  });
+  it.each(['latest', 'git+https://example.com/provider.git', 'catalog:missing', 'file:./missing'])(
+    'blocks unverified %s before any writes',
+    (spec) => {
+      const root = project({ devDependencies: { vitest: '4.1.11', [provider]: spec } });
+      const before = fs.readFileSync(path.join(root, 'package.json'), 'utf8');
+      const plan = planVitestV5Migration({ rootDir: root, packageManager: PackageManager.pnpm });
+      expect(plan.findings).toContainEqual(
+        expect.objectContaining({ code: 'browser-provider', severity: 'block' }),
+      );
+      expect(() => applyVitestV5Migration(plan)).toThrow('blocking');
+      expect(fs.readFileSync(path.join(root, 'package.json'), 'utf8')).toBe(before);
+    },
+  );
+  it('checks local provider metadata and guards it against edits after preflight', () => {
+    const root = project(
+      { devDependencies: { [provider]: 'file:./provider', webdriverio: '^9' } },
+      {
+        'provider/package.json': JSON.stringify({ name: provider, version: '5.2.0' }),
+      },
+    );
+    const plan = planVitestV5Migration({ rootDir: root });
+    expect(plan.findings).toEqual([]);
+    fs.writeFileSync(
+      path.join(root, 'provider/package.json'),
+      JSON.stringify({ name: provider, version: '4.1.11' }),
+    );
+    expect(() => applyVitestV5Migration(plan)).toThrow('Migration input changed');
+  });
+  it('does not infer browser usage from generated Yarn PnP files', () => {
+    const root = project(
+      { devDependencies: { vitest: '5.0.1' } },
+      {
+        '.pnp.cjs': `module.exports = { optionalPeer: '${provider}' };`,
+        '.pnp.loader.mjs': `export const peer = '${provider}';`,
+        '.yarn/releases/yarn.cjs': `module.exports = '${provider}';`,
+      },
+    );
+    const plan = migrate(root);
+    expect(plan.changes).toEqual([]);
+    expect(read(root).devDependencies[provider]).toBeUndefined();
+  });
+});
diff --git a/packages/cli/src/migration/__tests__/vitest-v5.spec.ts b/packages/cli/src/migration/__tests__/vitest-v5.spec.ts
new file mode 100644
index 0000000000..400b74a333
--- /dev/null
+++ b/packages/cli/src/migration/__tests__/vitest-v5.spec.ts
@@ -0,0 +1,3151 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { runInNewContext } from 'node:vm';
+
+import { afterEach, describe, expect, it } from 'vitest';
+
+import { PackageManager } from '../../types/index.ts';
+import {
+  applyVitestV5Migration,
+  applyVitestV5NodeMigration,
+  finishVitestV5Migration,
+  formatVitestV5Findings,
+  planVitestV5Migration,
+  refreshVitestV5Migration,
+  vitestV5NeedsMigration,
+} from '../migrator.ts';
+import { parseSource } from '../vitest-v5/ast.ts';
+import { literalTestCommands, migrateVitestV5Command } from '../vitest-v5/commands.ts';
+import { migrateVitestV5Config } from '../vitest-v5/config.ts';
+import { migrateVitestV5Source } from '../vitest-v5/source.ts';
+
+const v4 = { preserveV4: true, browser: true };
+const directories: string[] = [];
+afterEach(() => {
+  for (const directory of directories.splice(0)) {
+    fs.rmSync(directory, { recursive: true, force: true });
+  }
+});
+function project(files: Record<string, string> = {}) {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'vp-vitest-v5-'));
+  directories.push(root);
+  const all = {
+    'package.json': JSON.stringify({ devDependencies: { vitest: '^4.1.0' } }),
+    ...files,
+  };
+  for (const [name, content] of Object.entries(all)) {
+    const file = path.join(root, name);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, content);
+  }
+  return root;
+}
+const planProject = (rootDir: string) =>
+  planVitestV5Migration({ rootDir, packageManager: PackageManager.pnpm });
+function config(source: string, preserveV4 = true) {
+  const result = migrateVitestV5Config('vite.config.ts', source, { preserveV4 });
+  parseSource('vite.config.ts', result.content);
+  return result;
+}
+function source(input: string, options = v4) {
+  const result = migrateVitestV5Source('example.test.ts', input, options);
+  parseSource('example.test.ts', result.content);
+  return result;
+}
+
+describe('Vitest v5 diagnostic scope', () => {
+  it.each(['export default { plugins: [] };', 'export default { test: { clearMocks: false } };'])(
+    'resolves Vue-style globals with base %s',
+    (baseConfig) => {
+      const root = project({
+        'package.json': JSON.stringify({
+          devDependencies: { vitest: '4.1.11' },
+          scripts: {
+            test: 'vp test',
+            unit: 'vp test --project unit*',
+            browser: 'node build.js && VAPOR_E2E=1 vp test --project browser',
+          },
+        }),
+        'vite.config.ts': `import { configDefaults, defineConfig } from 'vite-plus';
+export default defineConfig({ test: {
+  globals: true,
+  setupFiles: 'scripts/setup.ts',
+  onConsoleLog(log) { return !log.includes('quiet'); },
+  projects: [
+    { extends: true, test: { name: 'unit', include: ['unit/*.test.ts'], exclude: [...configDefaults.exclude] } },
+    ...(process.env.VAPOR_E2E ? [{ extends: './browser/vite.config.ts', root: './browser', test: { name: 'browser', globals: true } }] : []),
+  ],
+} });`,
+        'browser/vite.config.ts': baseConfig,
+        'unit/works.test.ts': `test.sequential('works', () => {});`,
+        'scripts/setup.ts': `beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });`,
+        'other/runner.test.ts': `expect(() => {}).toThrow('');`,
+      });
+      const plan = planProject(root);
+      expect(plan.findings.filter(({ code }) => code === 'global-api-ownership')).toEqual([]);
+      applyVitestV5Migration(plan);
+      expect(fs.readFileSync(path.join(root, 'unit/works.test.ts'), 'utf8')).toContain(
+        'concurrent: false',
+      );
+      expect(fs.readFileSync(path.join(root, 'scripts/setup.ts'), 'utf8')).toContain(
+        'beforeEach(async () => { await expect',
+      );
+      expect(fs.readFileSync(path.join(root, 'other/runner.test.ts'), 'utf8')).toBe(
+        `expect(() => {}).toThrow('');`,
+      );
+      expect(fs.readFileSync(path.join(root, 'vite.config.ts'), 'utf8')).toContain(
+        'clearMocks: false',
+      );
+      expect(
+        finishVitestV5Migration(plan).filter(({ code }) => code === 'global-api-ownership'),
+      ).toEqual([]);
+    },
+  );
+
+  it('does not inherit implicit include patterns into an explicit project include', () => {
+    const input = `expect(() => {}).toThrow('');`;
+    const root = project({
+      'vitest.config.mjs': `export default { test: { globals: true, projects: [{ extends: true, test: { include: ['unit/*.test.js'] } }] } };`,
+      'unit/right.test.js': input,
+      'other/wrong.test.js': input,
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toEqual([]);
+    expect(plan.changes.find(({ file }) => file.endsWith('right.test.js'))?.after).toContain(
+      'toThrow(/^$/)',
+    );
+    expect(plan.changes.some(({ file }) => file.endsWith('wrong.test.js'))).toBe(false);
+  });
+
+  it('reports unresolved ownership only when it prevents a source migration', () => {
+    const ordinary = `test('works', () => { expect(1).toBe(1); });`;
+    const root = project({
+      'vitest.config.mjs': 'export default configAtRuntime;',
+      'ordinary.test.js': ordinary,
+      'affected.test.js': `test.sequential('one', () => {}); test.sequential('two', () => {});`,
+      'imported.test.js': `import { test } from 'vitest'; test.sequential('works', () => {});`,
+    });
+    const plan = planProject(root);
+    expect(plan.findings.filter(({ code }) => code === 'global-api-ownership')).toEqual([
+      expect.objectContaining({ file: path.join(root, 'affected.test.js') }),
+    ]);
+    expect(
+      plan.changes.some(
+        ({ file }) => file.endsWith('ordinary.test.js') || file.endsWith('affected.test.js'),
+      ),
+    ).toBe(false);
+    expect(plan.changes.find(({ file }) => file.endsWith('imported.test.js'))?.after).toContain(
+      'concurrent: false',
+    );
+  });
+
+  it('limits project-filtered ownership to the selected projects', () => {
+    const input = `test.sequential('works', () => {});`;
+    const root = project({
+      'package.json': JSON.stringify({
+        devDependencies: { vitest: '4.1.11' },
+        scripts: { test: 'vp test --project UNIT* --project=!unit-skip' },
+      }),
+      'vitest.config.mjs': `export default { test: { globals: true, projects: [
+        { extends: true, test: { name: 'unit', include: ['unit/*.test.js'] } },
+        { extends: true, test: { name: 'unit-skip', include: ['skip/*.test.js'] } },
+        { extends: false, test: { name: 'other', globals: false, include: ['unit/*.test.js', 'other/*.test.js'] } },
+      ] } };`,
+      'unit/right.test.js': input,
+      'skip/wrong.test.js': input,
+      'other/wrong.test.js': input,
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toEqual([]);
+    expect(plan.changes.find(({ file }) => file.endsWith('right.test.js'))?.after).toContain(
+      'concurrent: false',
+    );
+    expect(plan.changes.some(({ file }) => file.endsWith('wrong.test.js'))).toBe(false);
+  });
+
+  it.each([
+    'cd child && vitest',
+    'source env.sh && vitest',
+    'export MODE=unit; vitest',
+    'vitest --config "$CONFIG"',
+    'MODE=$(node env.js) vitest',
+    'vitest | tee result.txt',
+    'echo done # comment && vitest',
+  ])('keeps stateful or dynamic shell commands unresolved: %s', (command) => {
+    expect(literalTestCommands(command)).toBeUndefined();
+  });
+
+  it('reads literal command lists without treating quoted operators as separators', () => {
+    expect(
+      literalTestCommands(
+        `node build.js && MODE='unit && extra' pnpm exec vitest --project 'unit*'; vp test --project other`,
+      ),
+    ).toEqual([
+      ['node', 'build.js'],
+      ['pnpm', 'exec', 'vitest', '--project', 'unit*'],
+      ['vp', 'test', '--project', 'other'],
+    ]);
+  });
+
+  it.each([
+    [`import { configDefaults as defaults } from 'vitest/config';`, 'defaults'],
+    [`import * as config from 'vite-plus';`, 'config.configDefaults'],
+  ])('recognizes imported config defaults: %s', (imports, defaults) => {
+    const root = project({
+      'vitest.config.mjs': `${imports} export default { test: { globals: true, include: ${defaults}.include, exclude: [...${defaults}.exclude] } };`,
+      'unit.test.js': `test.sequential('works', () => {});`,
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toEqual([]);
+    expect(plan.changes.find(({ file }) => file.endsWith('unit.test.js'))?.after).toContain(
+      'concurrent: false',
+    );
+  });
+
+  it('does not treat a local configDefaults lookalike as imported defaults', () => {
+    const root = project({
+      'vitest.config.mjs': `const configDefaults = getConfig(); export default { test: { globals: true, exclude: [...configDefaults.exclude] } };`,
+      'unit.test.js': `test.sequential('works', () => {});`,
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toContainEqual(
+      expect.objectContaining({
+        file: path.join(root, 'unit.test.js'),
+        code: 'global-api-ownership',
+      }),
+    );
+    expect(plan.changes.some(({ file }) => file.endsWith('unit.test.js'))).toBe(false);
+  });
+
+  it.each([`get globals() { return true; }`, `...runtimeOptions`])(
+    'does not evaluate dynamic test properties: %s',
+    (property) => {
+      const root = project({
+        'vitest.config.mjs': `export default { test: { ${property} } };`,
+        'unit.test.js': `test.sequential('works', () => {});`,
+      });
+      const plan = planProject(root);
+      expect(plan.findings).toContainEqual(
+        expect.objectContaining({
+          file: path.join(root, 'unit.test.js'),
+          code: 'global-api-ownership',
+        }),
+      );
+      expect(plan.changes.some(({ file }) => file.endsWith('unit.test.js'))).toBe(false);
+    },
+  );
+
+  it('preserves conflicts between both branches of a conditional project list', () => {
+    const root = project({
+      'vitest.config.mjs': `export default { test: { projects: [...(process.env.UNIT ? [{ test: { globals: true } }] : [{ test: { globals: false } }])] } };`,
+      'unit.test.js': `test.sequential('works', () => {});`,
+    });
+    const plan = planProject(root);
+    expect(plan.findings.filter(({ code }) => code === 'global-api-ownership')).toEqual([
+      expect.objectContaining({ file: path.join(root, 'unit.test.js') }),
+    ]);
+    expect(plan.changes.some(({ file }) => file.endsWith('unit.test.js'))).toBe(false);
+  });
+
+  it('retains review for external inheritance that can reach outside the inline root', () => {
+    const root = project({
+      'vitest.config.mjs': `export default { test: { projects: [
+        { test: { globals: true, setupFiles: './setup.js' } },
+        { extends: './base.mjs', root: './browser', test: { name: 'browser' } },
+      ] } };`,
+      'base.mjs': `export default { test: { globals: false, setupFiles: '../setup.js' } };`,
+      'setup.js': `beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });`,
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toContainEqual(
+      expect.objectContaining({ file: path.join(root, 'setup.js'), code: 'global-api-ownership' }),
+    );
+    expect(plan.changes.some(({ file }) => file.endsWith('setup.js'))).toBe(false);
+  });
+
+  it('does not silently skip selection by a browser instance name', () => {
+    const root = project({
+      'package.json': JSON.stringify({
+        devDependencies: { vitest: '4.1.11' },
+        scripts: { test: 'vitest --project "browser (chromium)"' },
+      }),
+      'vitest.config.mjs': `export default { test: { projects: [{ test: { name: 'browser', globals: true, browser: { enabled: true, instances: [{ browser: 'chromium' }] } } }] } };`,
+      'unit.test.js': `test.sequential('works', () => {});`,
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toContainEqual(
+      expect.objectContaining({
+        file: path.join(root, 'unit.test.js'),
+        code: 'global-api-ownership',
+      }),
+    );
+    expect(plan.changes.some(({ file }) => file.endsWith('unit.test.js'))).toBe(false);
+  });
+
+  it.each([
+    ['scripts/setup.js', { scripts: '^1.0.0' }],
+    ['scripts/setup', {}],
+  ])('does not guess a local setup path for %s', (setup, dependencies) => {
+    const root = project({
+      'package.json': JSON.stringify({ devDependencies: { vitest: '4.1.11', ...dependencies } }),
+      'vitest.config.mjs': `export default { test: { globals: true, setupFiles: '${setup}' } };`,
+      'scripts/setup.js': `beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });`,
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toContainEqual(
+      expect.objectContaining({
+        file: path.join(root, 'vitest.config.mjs'),
+        code: 'global-api-ownership',
+      }),
+    );
+    expect(plan.changes.some(({ file }) => file.endsWith('setup.js'))).toBe(false);
+  });
+
+  it.each(['4.1.11', '5.0.1'])('migrates legacy Vite+ entry points from %s', (version) => {
+    const input = `import { BaseCoverageProvider } from 'vite-plus/test/coverage';
+export { DefaultReporter } from 'vite-plus/test/reporters';
+import { populateGlobal } from 'vite-plus/test/environments';
+export { VitestSnapshotEnvironment } from 'vite-plus/test/snapshot';
+import * as mocker from 'vite-plus/test/mocker';`;
+    const expected = input
+      .replace("'vite-plus/test/coverage'", '"vite-plus/test/node"')
+      .replace("'vite-plus/test/reporters'", '"vite-plus/test/node"')
+      .replace("'vite-plus/test/environments'", '"vite-plus/test/runtime"')
+      .replace("'vite-plus/test/snapshot'", '"vite-plus/test/runtime"');
+    const root = project({
+      'package.json': JSON.stringify({ devDependencies: { vitest: version } }),
+      'support.ts': input,
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toEqual([]);
+    expect(plan.changes).toContainEqual(
+      expect.objectContaining({ file: path.join(root, 'support.ts'), after: expected }),
+    );
+    applyVitestV5Migration(plan);
+    expect(fs.readFileSync(path.join(root, 'support.ts'), 'utf8')).toBe(expected);
+    expect(finishVitestV5Migration(plan)).toEqual([]);
+    expect(planProject(root).changes).toEqual([]);
+  });
+
+  it.each(['4.1.11', '5.0.1'])('restores a legacy WebDriverIO import from %s', (version) => {
+    const root = project({
+      'package.json': JSON.stringify({ devDependencies: { vitest: version } }),
+      'vite.config.ts':
+        "import { webdriverio } from 'vite-plus/test/browser-webdriverio';\nexport default {};",
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toEqual([]);
+    applyVitestV5Migration(plan);
+    expect(fs.readFileSync(path.join(root, 'vite.config.ts'), 'utf8')).toContain(
+      'from "@vitest/browser-webdriverio"',
+    );
+    expect(finishVitestV5Migration(plan)).toEqual([]);
+    fs.writeFileSync(
+      path.join(root, 'package.json'),
+      JSON.stringify({
+        devDependencies: { vitest: version, '@vitest/browser-webdriverio': '^6.0.0' },
+      }),
+    );
+    expect(planProject(root).findings).toEqual([]);
+  });
+
+  it.each(['4.1.11', '5.0.1'])(
+    'ignores output-only changes and dependency advisories from %s',
+    (version) => {
+      const input = `import { expect, it, test } from 'vitest';
+import '@vitest/ws-client';
+it.each(['system', 'light', 'dark'])('accepts %s', value => { expect(value).toBe(value); });
+test.for([{ value: 'system' }])('accepts $value', ({ value }) => { expect(value).toBe(value); });
+const artifacts = ['__screenshots__', '.vitest-attachements', '.vitest-reports', 'html/index.html'];`;
+      const settings = `export default { test: { clearMocks: false,
+      reporters: ['json', ['junit', {}], ['html', { outputFile: 'reports/index.html' }]],
+    } };`;
+      const root = project({
+        'package.json': JSON.stringify({
+          devDependencies: {
+            vitest: version,
+            '@vitest/ws-client': version,
+            '@vitest/runner': version,
+            '@vitest/expect': version,
+          },
+          scripts: {
+            test: 'vitest --reporter=json | jq',
+            artifacts: 'vitest && cp -r .vitest-attachements artifacts',
+          },
+        }),
+        'vitest.config.mjs': settings,
+        'example.test.ts': input,
+        '.github/workflows/test.yml':
+          'steps:\n  - uses: actions/upload-artifact@v4\n    with:\n      path: .vitest-reports/\n',
+      });
+      const plan = planProject(root);
+      expect(plan.findings).toEqual([]);
+      expect(plan.changes).toEqual([]);
+      applyVitestV5Migration(plan);
+      expect(finishVitestV5Migration(plan)).toEqual([]);
+      expect(fs.readFileSync(path.join(root, 'example.test.ts'), 'utf8')).toBe(input);
+      expect(fs.readFileSync(path.join(root, 'vitest.config.mjs'), 'utf8')).toBe(settings);
+    },
+  );
+
+  it('retains v4 execution reviews during finalization but not after upgrading to v5', () => {
+    const root = project({
+      'package.json': JSON.stringify({
+        devDependencies: { vitest: '4.1.11' },
+        scripts: { test: 'vitest -t "suite test"' },
+      }),
+      'vitest.config.mjs': `export default { test: { coverage: { include: ['src/**'] } } };`,
+      'example.test.ts': `import { expect, test } from 'vitest'; test('poll', async () => { await expect.poll(() => 42).toBe(42); });`,
+    });
+    const plan = planProject(root);
+    const codes = ['coverage-patterns', 'poll-timeout', 'test-name-pattern'];
+    expect(plan.findings.map(({ code }) => code).toSorted()).toEqual(codes);
+    applyVitestV5Migration(plan);
+    const manifest = path.join(root, 'package.json');
+    fs.writeFileSync(manifest, fs.readFileSync(manifest, 'utf8').replace('4.1.11', '5.0.1'));
+    const findings = finishVitestV5Migration(plan);
+    expect([...new Set(findings.map(({ code }) => code))].toSorted()).toEqual(codes);
+    expect(formatVitestV5Findings({ rootDir: root, findings })).toContain(
+      'Vitest v5: 3 review items',
+    );
+    expect(planProject(root).findings).toEqual([]);
+    expect(planProject(root).changes).toEqual([]);
+  });
+
+  it.each(["'json'", "['json']", "[['junit']]", 'reporters', "[['json', options]]"])(
+    'leaves static or dynamic reporters unchanged without a review: %s',
+    (reporters) => {
+      const input = `export default { test: { clearMocks: false, reporters: ${reporters} } };`;
+      expect(config(input)).toEqual({ content: input, findings: [] });
+      expect(config(input, false)).toEqual({ content: input, findings: [] });
+    },
+  );
+
+  it('does not review existing v5 behavior in source or dynamic configs', () => {
+    const input = `import { expect, vi, test } from 'vitest';
+vi.mock('./module'); vi.fn(class {}); vi.setSystemTime(Temporal.Now.instant());
+process.env.VITEST_POOL_ID; const { VITEST_WORKER_ID } = process.env;
+globalThis.navigator = value; globalThis.foo = originals.get('foo');
+interface Assertion<T> {}
+other.collect(options);
+test('poll', async () => { await expect.poll(() => 42).toBe(42); });`;
+    expect(source(input, { preserveV4: false, browser: true })).toEqual({
+      content: input,
+      findings: [],
+    });
+    const dynamic = 'export default () => ({ test: options });';
+    expect(config(dynamic, false)).toEqual({ content: dynamic, findings: [] });
+    expect(config(dynamic).findings).toContainEqual(
+      expect.objectContaining({ code: 'dynamic-config' }),
+    );
+  });
+
+  it('still blocks removed APIs and fixes unawaited assertions in v5 projects', () => {
+    const root = project({
+      'package.json': JSON.stringify({ devDependencies: { vitest: '5.0.1' } }),
+      'example.test.ts': `import { expect, test } from 'vitest';
+test('async', () => { expect(Promise.resolve(1)).resolves.toBe(1); });`,
+    });
+    // An unresolved benchmark cannot use the removed top-level API, even on v5.
+    fs.writeFileSync(
+      path.join(root, 'example.bench.ts'),
+      `import { bench } from 'vitest'; export { bench };`,
+    );
+    const plan = planProject(root);
+    expect(plan.findings).toContainEqual(
+      expect.objectContaining({ code: 'benchmark-api', severity: 'block' }),
+    );
+    expect(plan.changes.find(({ file }) => file.endsWith('example.test.ts'))?.after).toContain(
+      'await expect(',
+    );
+    expect(() => applyVitestV5Migration(plan)).toThrow();
+  });
+});
+
+describe('Vitest v5 config compatibility', () => {
+  it('migrates removed benchmark output options without consumer reviews or repeat edits', () => {
+    const root = project({
+      'package.json': JSON.stringify({
+        devDependencies: { vitest: '4.1.11' },
+        scripts: { bench: 'vitest bench --outputJson=cli.json' },
+      }),
+      'vitest.config.mjs': `export default { test: { benchmark: { outputJson: 'config.json' } } };`,
+      'example.bench.js': `import { bench } from 'vitest'; const work = () => 42; bench('work', work);`,
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toEqual([]);
+    applyVitestV5Migration(plan);
+    const findings = finishVitestV5Migration(plan);
+    expect(findings).toEqual([]);
+    expect(fs.readFileSync(path.join(root, 'package.json'), 'utf8')).toContain(
+      '--outputFile=cli.json',
+    );
+    expect(fs.readFileSync(path.join(root, 'vitest.config.mjs'), 'utf8')).toContain(
+      'json: "config.json"',
+    );
+    expect(planProject(root).changes).toEqual([]);
+    expect(planProject(root).findings).toEqual([]);
+  });
+
+  it.each(['mjs', 'ts'])('selects vitest.config.%s over an inactive Vite config', (extension) => {
+    const root = project({
+      'vite.config.ts': 'export default {};',
+      [`vitest.config.${extension}`]: 'export default { test: { globals: true } };',
+      'unit.test.js': `test.sequential('works', () => { expect(() => {}).toThrow(''); });`,
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toEqual([]);
+    applyVitestV5Migration(plan);
+    finishVitestV5Migration(plan);
+    const migrated = fs.readFileSync(path.join(root, 'unit.test.js'), 'utf8');
+    expect(migrated).toContain("test('works', { concurrent: false }");
+    expect(migrated).toContain('toThrow(/^$/)');
+    expect(planProject(root).changes).toEqual([]);
+  });
+
+  it('migrates global benchmarks despite an inactive Vite config', () => {
+    const root = project({
+      'vite.config.mjs': 'export default {};',
+      'vitest.config.mjs': 'export default { test: { globals: true } };',
+      'unit.test.js': `bench('old', () => {});`,
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toEqual([]);
+    expect(plan.changes.find(({ file }) => file.endsWith('unit.test.js'))?.after).toContain(
+      'globalThis.test',
+    );
+  });
+
+  it('resolves an inline test.root relative to the declaring project root', () => {
+    const root = project({
+      'vitest.config.mjs': `export default { root: './parent', test: { projects: [{ extends: false, root: './app', test: { root: './unit', globals: true } }] } };`,
+      'parent/unit/right.test.js': `test.sequential('works', () => {});`,
+      'parent/app/unit/wrong.test.js': `expect(() => {}).toThrow('');`,
+      'unit/wrong.test.js': `expect(() => {}).toThrow('');`,
+    });
+    const plan = planProject(root);
+    expect(
+      plan.changes.find(({ file }) => file === path.join(root, 'parent/unit/right.test.js'))?.after,
+    ).toContain('concurrent: false');
+    expect(plan.changes.filter(({ file }) => file.endsWith('wrong.test.js'))).toEqual([]);
+  });
+
+  it('uses an explicit config path relative to the script root, not its own directory', () => {
+    const root = project({
+      'package.json': JSON.stringify({
+        devDependencies: { vitest: '4.1.11' },
+        scripts: { test: 'vitest --config configs/custom.mjs' },
+      }),
+      'configs/custom.mjs': `export default { root: './app', test: { root: './unit', globals: true, setupFiles: './setup.js' } };`,
+      'unit/right.test.js': `test.sequential('works', () => {});`,
+      'unit/setup.js': 'beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });',
+      'configs/unit/wrong.test.js': `expect(() => {}).toThrow('');`,
+    });
+    const plan = planProject(root);
+    expect(
+      plan.changes.find(({ file }) => file === path.join(root, 'unit/right.test.js'))?.after,
+    ).toContain('concurrent: false');
+    expect(
+      plan.changes.find(({ file }) => file === path.join(root, 'unit/setup.js'))?.after,
+    ).toContain('beforeEach(async');
+    expect(plan.changes.some(({ file }) => file.endsWith('wrong.test.js'))).toBe(false);
+  });
+
+  it('does not apply a CLI root again to inline project roots', () => {
+    const root = project({
+      'package.json': JSON.stringify({
+        devDependencies: { vitest: '4.1.11' },
+        scripts: { test: 'vitest --root parent' },
+      }),
+      'parent/vitest.config.mjs': `export default { test: { projects: [{ test: { root: './unit', globals: true } }] } };`,
+      'parent/unit/right.test.js': `test.sequential('works', () => {});`,
+      'parent/wrong.test.js': `expect(() => {}).toThrow('');`,
+    });
+    const plan = planProject(root);
+    expect(
+      plan.changes.find(({ file }) => file === path.join(root, 'parent/unit/right.test.js'))?.after,
+    ).toContain('concurrent: false');
+    expect(plan.changes.some(({ file }) => file.endsWith('wrong.test.js'))).toBe(false);
+  });
+
+  it.each([
+    'vitest --config custom.mjs',
+    'vitest -c custom.mjs',
+    'vp test --config=custom.mjs',
+    'pnpm exec vitest run --config "custom.mjs"',
+  ])('respects explicit config selection: %s', (command) => {
+    const root = project({
+      'package.json': JSON.stringify({
+        devDependencies: { vitest: '4.1.11' },
+        scripts: { test: command },
+      }),
+      'vitest.config.mjs': 'export default { test: { globals: false } };',
+      'custom.mjs': 'export default { test: { globals: true } };',
+      'unit.test.js': `test.sequential('works', () => {});`,
+    });
+    const plan = planProject(root);
+    expect(plan.projects[0].configFiles).toContain(path.join(root, 'custom.mjs'));
+    expect(
+      plan.changes.find(({ file }) => file === path.join(root, 'unit.test.js'))?.after,
+    ).toContain('concurrent: false');
+    expect(plan.findings).toEqual([]);
+    applyVitestV5Migration(plan);
+    finishVitestV5Migration(plan);
+    expect(planProject(root).changes).toEqual([]);
+  });
+
+  it.each([
+    `export default { root: './app', test: { root: './unit', globals: true } };`,
+    `export default { root: rootAtRuntime, test: { root: './unit', globals: true } };`,
+    `export default { test: { projects: [{ root: './app', test: { root: './unit', globals: true } }] } };`,
+    `export default { test: { globals: true, projects: [{ extends: true, root: './app', test: { root: './unit' } }] } };`,
+  ])('uses test.root instead of concatenating roots: %s', (configSource) => {
+    const unrelated = `expect(() => { throw new Error('boom'); }).toThrow('');`;
+    const root = project({
+      'vitest.config.mjs': configSource,
+      'unit/right.test.js': `test.sequential('works', () => {});`,
+      'app/unit/wrong.test.js': unrelated,
+    });
+    const plan = planProject(root);
+    applyVitestV5Migration(plan);
+    expect(fs.readFileSync(path.join(root, 'unit/right.test.js'), 'utf8')).toContain(
+      'concurrent: false',
+    );
+    expect(fs.readFileSync(path.join(root, 'app/unit/wrong.test.js'), 'utf8')).toBe(unrelated);
+    expect(plan.findings).toEqual([]);
+  });
+
+  it.each([
+    `export default { test: { globals: true, dir: './unit', include: ['*.test.js'], exclude: ['excluded.test.js'], setupFiles: './setup.js' } };`,
+    `export default { root: './app', test: { globals: true, dir: './unit', include: ['*.test.js'], exclude: ['excluded.test.js'], setupFiles: '../setup.js' } };`,
+    `export default { test: { projects: [{ extends: false, test: { globals: true, dir: './unit', include: ['*.test.js'], exclude: ['excluded.test.js'], setupFiles: './setup.js' } }] } };`,
+    `export default { test: { globals: true, dir: './unit', include: ['*.test.js'], exclude: ['excluded.test.js'], setupFiles: './setup.js', projects: [{ extends: true, test: {} }] } };`,
+  ])('uses test.dir for discovery without changing setup resolution: %s', (configSource) => {
+    const unrelated = `expect(() => { throw new Error('boom'); }).toThrow('');`;
+    const root = project({
+      'vitest.config.mjs': configSource,
+      'unit/right.test.js': `test.sequential('works', () => {});`,
+      'wrong.test.js': unrelated,
+      'unit/excluded.test.js': unrelated,
+      'app/unit/wrong.test.js': unrelated,
+      'setup.js': 'beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });',
+      'unit/setup.js': unrelated,
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toEqual([]);
+    applyVitestV5Migration(plan);
+    expect(fs.readFileSync(path.join(root, 'unit/right.test.js'), 'utf8')).toContain(
+      'concurrent: false',
+    );
+    expect(fs.readFileSync(path.join(root, 'setup.js'), 'utf8')).toContain(
+      'beforeEach(async () => { await expect',
+    );
+    for (const file of [
+      'wrong.test.js',
+      'unit/excluded.test.js',
+      'app/unit/wrong.test.js',
+      'unit/setup.js',
+    ]) {
+      expect(fs.readFileSync(path.join(root, file), 'utf8')).toBe(unrelated);
+    }
+    finishVitestV5Migration(plan);
+    expect(planProject(root).findings).toEqual([]);
+    expect(planProject(root).changes).toEqual([]);
+  });
+
+  it.each(['vitest run --dir ./unit', 'vitest --dir=./unit', 'vp test --dir ./unit'])(
+    'honors a literal discovery directory override: %s',
+    (command) => {
+      const unrelated = `expect(() => {}).toThrow('');`;
+      const root = project({
+        'package.json': JSON.stringify({
+          devDependencies: { vitest: '4.1.11' },
+          scripts: { test: command },
+        }),
+        'vitest.config.mjs': `export default { test: { globals: true, dir: './ignored', include: ['*.test.js'] } };`,
+        'unit/right.test.js': `test.sequential('works', () => {});`,
+        'wrong.test.js': unrelated,
+        'ignored/wrong.test.js': unrelated,
+      });
+      const plan = planProject(root);
+      expect(plan.findings).toEqual([]);
+      applyVitestV5Migration(plan);
+      expect(fs.readFileSync(path.join(root, 'unit/right.test.js'), 'utf8')).toContain(
+        'concurrent: false',
+      );
+      for (const file of ['wrong.test.js', 'ignored/wrong.test.js']) {
+        expect(fs.readFileSync(path.join(root, file), 'utf8')).toBe(unrelated);
+      }
+    },
+  );
+
+  it.each<{ projects: string; files: Record<string, string> }>([
+    { projects: `[{ extends: true, test: {} }]`, files: {} },
+    {
+      projects: `['./configs/project.mjs']`,
+      files: {
+        'configs/project.mjs': `export default { test: { globals: true, dir: './unit', include: ['*.test.js'] } };`,
+      },
+    },
+  ])('does not forward --dir to declared projects: $projects', ({ projects, files }) => {
+    const unrelated = `expect(() => {}).toThrow('');`;
+    const root = project({
+      'package.json': JSON.stringify({
+        devDependencies: { vitest: '4.1.11' },
+        scripts: { test: 'vitest --dir ./ignored' },
+      }),
+      'vitest.config.mjs': `export default { test: { globals: true, dir: './unit', include: ['*.test.js'], projects: ${projects} } };`,
+      'unit/right.test.js': `test.sequential('works', () => {});`,
+      'ignored/wrong.test.js': unrelated,
+      'configs/unit/wrong.test.js': unrelated,
+      ...files,
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toEqual([]);
+    applyVitestV5Migration(plan);
+    expect(fs.readFileSync(path.join(root, 'unit/right.test.js'), 'utf8')).toContain(
+      'concurrent: false',
+    );
+    expect(fs.readFileSync(path.join(root, 'ignored/wrong.test.js'), 'utf8')).toBe(unrelated);
+    expect(fs.readFileSync(path.join(root, 'configs/unit/wrong.test.js'), 'utf8')).toBe(unrelated);
+  });
+
+  it('reviews an unresolved discovery directory while migrating known setup files', () => {
+    const input = `test.sequential('works', () => {});`;
+    const root = project({
+      'vitest.config.mjs': `export default { test: { globals: true, dir: directoryAtRuntime, setupFiles: './setup.js' } };`,
+      'unit/right.test.js': input,
+      'wrong.test.js': input,
+      'setup.js': 'beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });',
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toContainEqual(
+      expect.objectContaining({
+        file: path.join(root, 'vitest.config.mjs'),
+        code: 'global-api-ownership',
+      }),
+    );
+    applyVitestV5Migration(plan);
+    expect(fs.readFileSync(path.join(root, 'unit/right.test.js'), 'utf8')).toBe(input);
+    expect(fs.readFileSync(path.join(root, 'wrong.test.js'), 'utf8')).toBe(input);
+    expect(fs.readFileSync(path.join(root, 'setup.js'), 'utf8')).toContain(
+      'beforeEach(async () => { await expect',
+    );
+    finishVitestV5Migration(plan);
+    expect(planProject(root).findings).toContainEqual(
+      expect.objectContaining({ code: 'global-api-ownership' }),
+    );
+  });
+
+  it.each([
+    ['setup.mjs', 'setup.cjs', 'setup.js'],
+    ['setup.cjs', 'setup.js'],
+    ['setup.js', 'setup/index.mjs'],
+    ['setup/index.mjs', 'setup/index.cjs', 'setup/index.js'],
+    ['setup/index.cjs', 'setup/index.js'],
+    ['setup/index.js'],
+  ])('uses Vitest setup resolution precedence: %j', (...files) => {
+    const input = 'beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });';
+    const unrelated = `expect(() => { throw new Error('boom'); }).toThrow('');`;
+    const root = project({
+      'vitest.config.mjs': `export default { test: { globals: true, setupFiles: ['./setup'] } };`,
+      'unit.test.js': `test('works', () => {});`,
+      ...Object.fromEntries(files.map((file, index) => [file, index === 0 ? input : unrelated])),
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toEqual([]);
+    applyVitestV5Migration(plan);
+    expect(fs.readFileSync(path.join(root, files[0]), 'utf8')).toContain(
+      'beforeEach(async () => { await expect',
+    );
+    for (const file of files.slice(1)) {
+      expect(fs.readFileSync(path.join(root, file), 'utf8')).toBe(unrelated);
+    }
+    finishVitestV5Migration(plan);
+    expect(planProject(root).findings).toEqual([]);
+    expect(planProject(root).changes).toEqual([]);
+  });
+
+  it('keeps a trailing-slash setup directory distinct from a sibling module', () => {
+    const unrelated = `expect(() => {}).toThrow('');`;
+    const root = project({
+      'vitest.config.mjs': `export default { test: { globals: true, setupFiles: ['./setup/'] } };`,
+      'setup.mjs': unrelated,
+      'setup/index.js': 'beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });',
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toEqual([]);
+    applyVitestV5Migration(plan);
+    expect(fs.readFileSync(path.join(root, 'setup.mjs'), 'utf8')).toBe(unrelated);
+    expect(fs.readFileSync(path.join(root, 'setup/index.js'), 'utf8')).toContain(
+      'beforeEach(async () => { await expect',
+    );
+  });
+
+  it.each(['./missing', './setup', 'setup-package'])(
+    'reviews unresolved setup entry %s even without global calls',
+    (setup) => {
+      const root = project({
+        'vitest.config.mjs': `export default { test: { globals: true, setupFiles: ['${setup}'] } };`,
+        'unit.test.js': `import { test } from 'vitest'; test('works', () => {});`,
+        'setup.ts': `export const unrelated = true;`,
+      });
+      const plan = planProject(root);
+      expect(plan.findings).toContainEqual(
+        expect.objectContaining({
+          file: path.join(root, 'vitest.config.mjs'),
+          code: 'global-api-ownership',
+        }),
+      );
+      applyVitestV5Migration(plan);
+      finishVitestV5Migration(plan);
+      expect(planProject(root).findings).toContainEqual(
+        expect.objectContaining({ code: 'global-api-ownership' }),
+      );
+    },
+  );
+
+  it.each([
+    `export default { test: { globals: true, setupFiles: './setup.js', include: ['unit.test.js'], exclude: ['setup.js'] } };`,
+    `export default { test: { globals: true, setupFiles: ['./setup.js'] } };`,
+    `export default { test: { globals: true, setupFiles: ['./setup.js'], projects: [{ extends: true, test: {} }] } };`,
+    `export default { test: { projects: [{ test: { globals: true, setupFiles: ['./setup.js'] } }] } };`,
+  ])('migrates globals in declared setup files: %s', (configSource) => {
+    const root = project({
+      'vitest.config.mjs': configSource,
+      'setup.js': 'beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });',
+      'unit.test.js': `test('works', () => {});`,
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toEqual([]);
+    applyVitestV5Migration(plan);
+    finishVitestV5Migration(plan);
+    expect(fs.readFileSync(path.join(root, 'setup.js'), 'utf8')).toBe(
+      'beforeEach(async () => { await expect(Promise.resolve(1)).resolves.toBe(1); });',
+    );
+    expect(planProject(root).changes).toEqual([]);
+  });
+
+  it('applies project directory precedence and setup ownership to referenced configs', () => {
+    const root = project({
+      'vitest.config.mjs': `export default { test: { projects: ['./unit'] } };`,
+      'unit/vite.config.ts': 'export default {};',
+      'unit/vitest.config.mjs': `export default { test: { globals: true, setupFiles: '../shared/setup.js' } };`,
+      'unit/right.test.js': `test.sequential('works', () => {});`,
+      'shared/setup.js': 'beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });',
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toEqual([]);
+    expect(
+      plan.changes.find(({ file }) => file === path.join(root, 'unit/right.test.js'))?.after,
+    ).toContain('concurrent: false');
+    expect(
+      plan.changes.find(({ file }) => file === path.join(root, 'shared/setup.js'))?.after,
+    ).toContain('beforeEach(async () => { await expect');
+  });
+
+  it.each([
+    `export default { test: { projects: [{ test: { globals: true, setupFiles: './setup.js' } }, { test: { globals: false, setupFiles: './setup.js' } }] } };`,
+    `export default { test: { globals: true, setupFiles: filesAtRuntime } };`,
+    `export default () => ({ test: { globals: true, setupFiles: './setup.js' } });`,
+  ])('reports unresolved global ownership without rewriting calls: %s', (configSource) => {
+    const input = 'beforeEach(() => { expect(Promise.resolve(1)).resolves.toBe(1); });';
+    const root = project({
+      'vitest.config.mjs': configSource,
+      'setup.js': input,
+      'imported.js': `import { expect } from 'vitest'; expect(() => {}).toThrow('');`,
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toContainEqual(
+      expect.objectContaining({ code: 'global-api-ownership', file: path.join(root, 'setup.js') }),
+    );
+    applyVitestV5Migration(plan);
+    finishVitestV5Migration(plan);
+    expect(fs.readFileSync(path.join(root, 'setup.js'), 'utf8')).toBe(input);
+    expect(fs.readFileSync(path.join(root, 'imported.js'), 'utf8')).toContain('toThrow(/^$/)');
+    expect(planProject(root).findings).toContainEqual(
+      expect.objectContaining({ code: 'global-api-ownership' }),
+    );
+  });
+
+  it.each([
+    'vitest --config "$CONFIG"',
+    'cd unit && vitest',
+    'vitest --config missing.mjs',
+    'vitest --dir "$TEST_DIR"',
+    'vitest --dir=$TEST_DIR',
+    'vitest --dir',
+  ])('reports unresolved script selections: %s', (command) => {
+    const root = project({
+      'package.json': JSON.stringify({
+        devDependencies: { vitest: '4.1.11' },
+        scripts: { test: command },
+      }),
+      'vitest.config.mjs': 'export default { test: { globals: true } };',
+      'unit.test.js': `test.sequential('works', () => {});`,
+    });
+    const plan = planProject(root);
+    expect(plan.changes.some(({ file }) => file === path.join(root, 'unit.test.js'))).toBe(false);
+    expect(plan.findings).toContainEqual(expect.objectContaining({ code: 'global-api-ownership' }));
+  });
+
+  it.each([`{ name: 'unit' }`, `{ name: 'unit', browser: { enabled: true } }`])(
+    'preserves defaults inherited from an external base: %s',
+    (testOptions) => {
+      const child = `{ extends: './base.mjs', test: ${testOptions} }`;
+      const base = `export default { test: { clearMocks: true, browser: { locators: { exact: true } } } };`;
+      const root = project({
+        'base.mjs': base,
+        'vitest.config.mjs': `export default { test: { projects: [${child}] } };`,
+      });
+      const plan = planProject(root);
+      expect(plan.findings).toContainEqual(
+        expect.objectContaining({ code: 'project-inheritance', severity: 'review' }),
+      );
+      applyVitestV5Migration(plan);
+      finishVitestV5Migration(plan);
+      expect(fs.readFileSync(path.join(root, 'base.mjs'), 'utf8')).toBe(base);
+      expect(fs.readFileSync(path.join(root, 'vitest.config.mjs'), 'utf8')).toContain(child);
+      // Without upgrading the runner, the v4 inheritance review still applies.
+      const repeated = planProject(root);
+      expect(repeated.changes).toEqual([]);
+      expect(repeated.findings).toContainEqual(
+        expect.objectContaining({ code: 'project-inheritance' }),
+      );
+      fs.writeFileSync(
+        path.join(root, 'package.json'),
+        JSON.stringify({ devDependencies: { vitest: '5.0.1' } }),
+      );
+      const upgraded = planProject(root);
+      expect(upgraded.changes).toEqual([]);
+      expect(upgraded.findings.some(({ code }) => code === 'project-inheritance')).toBe(false);
+    },
+  );
+
+  it.each([`'./missing.mjs'`, `baseConfig`])(
+    'preserves unresolved project inheritance: %s',
+    (base) => {
+      const child = `{ extends: ${base} }`;
+      const result = config(`export default { test: { projects: [${child}] } };`);
+      expect(result.content).toContain(child);
+      expect(result.findings).toContainEqual(
+        expect.objectContaining({ code: 'project-inheritance' }),
+      );
+    },
+  );
+
+  it('limits Vitest globals to included files in a mixed Jest/Vitest package', () => {
+    const input = `test('throws', () => { expect(() => { throw new Error('boom'); }).toThrow(''); });`;
+    const root = project({
+      'package.json': JSON.stringify({ devDependencies: { vitest: '4.1.11', jest: '29.7.0' } }),
+      'vitest.config.mjs': `export default { test: { globals: true, include: ['unit/**/*.test.ts', 'unit/custom.ts'], exclude: ['unit/excluded.test.ts'] } };`,
+      'jest.config.cjs': `module.exports = { testMatch: ['<rootDir>/integration/**/*.test.ts'] };`,
+      'unit/example.test.ts': input,
+      'unit/custom.ts': input,
+      'unit/excluded.test.ts': input,
+      'integration/other.test.ts': input,
+      'helpers/imported.test.ts': `import { test, expect } from 'vitest';\n${input}`,
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toEqual([]);
+    applyVitestV5Migration(plan);
+    finishVitestV5Migration(plan);
+    for (const name of ['unit/example.test.ts', 'unit/custom.ts', 'helpers/imported.test.ts']) {
+      expect(fs.readFileSync(path.join(root, name), 'utf8')).toContain('toThrow(/^$/)');
+    }
+    for (const name of ['unit/excluded.test.ts', 'integration/other.test.ts']) {
+      expect(fs.readFileSync(path.join(root, name), 'utf8')).toBe(input);
+    }
+    expect(planProject(root).changes).toEqual([]);
+  });
+
+  it.each([
+    `import { defineConfig } from 'vitest/config'; const unused = defineConfig({ test: { globals: true } }); export default { test: { include: ['other.test.ts'] } };`,
+    `export default { test: { include: ['unit.test.ts'] } }; // globals: true`,
+    `export default { test: { globals: enabledAtRuntime } };`,
+    `export default { test: { globals: true, include: patterns } };`,
+    `export default { test: { globals: true, exclude: patterns } };`,
+    `export default () => ({ test: { globals: true } });`,
+    `export default { test: { globals: true, projects: [{ test: { include: ['unit.test.ts'] } }] } };`,
+    `export default { test: { projects: [{ test: { globals: true } }, { test: { globals: false } }] } };`,
+  ])('preserves unbound APIs without certain Vitest global ownership: %s', (configSource) => {
+    const input = `test.sequential('x', () => expect(() => {}).toThrow(''));`;
+    const root = project({ 'vitest.config.mjs': configSource, 'unit.test.ts': input });
+    expect(
+      planProject(root).changes.some(({ file }) => file === path.join(root, 'unit.test.ts')),
+    ).toBe(false);
+  });
+
+  it.each([
+    `import { defineConfig } from 'vitest/config'; export default defineConfig({ test: { globals: true, include: ['unit/**/*.test.ts'] } });`,
+    `import { defineConfig } from 'vitest/config'; const config = defineConfig({ test: { globals: true, include: ['unit/**/*.test.ts'] } }); export default config;`,
+    `import { defineConfig } from 'vitest/config'; module.exports = defineConfig({ test: { globals: true, include: ['unit/**/*.test.ts'] } });`,
+    `export default { test: { projects: [{ test: { globals: true, include: ['unit/**/*.test.ts'] } }, { test: { globals: false, include: ['integration/**/*.test.ts'] } }] } };`,
+    `export default { test: { globals: true, include: ['unit/**/*.test.ts'], projects: [{ extends: true, test: {} }, { extends: false, test: { include: ['integration/**/*.test.ts'] } }] } };`,
+    `export default { root: './unit', test: { globals: true } };`,
+  ])('resolves global ownership from inline projects and roots: %s', (configSource) => {
+    const input = `expect(() => {}).toThrow('');`;
+    const root = project({
+      'vitest.config.mjs': configSource,
+      'unit/example.test.ts': input,
+      'integration/other.test.ts': input,
+    });
+    const plan = planProject(root);
+    expect(
+      plan.changes.find(({ file }) => file === path.join(root, 'unit/example.test.ts'))?.after,
+    ).toContain('toThrow(/^$/)');
+    expect(
+      plan.changes.some(({ file }) => file === path.join(root, 'integration/other.test.ts')),
+    ).toBe(false);
+  });
+
+  it('resolves global ownership from a referenced project config', () => {
+    const input = `expect(() => {}).toThrow('');`;
+    const root = project({
+      'vitest.config.mjs': `export default { test: { projects: ['./unit/project.mjs'] } };`,
+      'unit/project.mjs': `export default { test: { globals: true } };`,
+      'unit/example.test.ts': input,
+      'integration/other.test.ts': input,
+    });
+    const plan = planProject(root);
+    expect(
+      plan.changes.find(({ file }) => file === path.join(root, 'unit/example.test.ts'))?.after,
+    ).toContain('toThrow(/^$/)');
+    expect(
+      plan.changes.some(({ file }) => file === path.join(root, 'integration/other.test.ts')),
+    ).toBe(false);
+  });
+
+  it.each(['vite', 'vite-plus'])(
+    'discovers custom test configs that import helpers from %s',
+    (module) => {
+      const root = project({
+        'package.json': JSON.stringify({
+          devDependencies: { vitest: '^4.1.0' },
+          scripts: { test: 'vitest --config custom.ts' },
+        }),
+        'custom.ts': `import { defineConfig } from '${module}'; export default defineConfig({ test: { browser: { enabled: true } } });`,
+      });
+      const plan = planProject(root);
+      expect(plan.projects[0].configFiles).toContain(path.join(root, 'custom.ts'));
+      expect(
+        plan.changes.find(({ file }) => file === path.join(root, 'custom.ts'))?.after,
+      ).toContain('exact: false');
+      expect(plan.findings).toEqual([]);
+    },
+  );
+
+  it.each(['vite', 'vite-plus'])(
+    'does not treat a source example using %s helpers as a test config',
+    (module) => {
+      const input = `import { defineConfig, type Plugin } from '${module}';
+import { describe, it, expect } from 'vitest';
+const unrelated = { test: {} };
+function plugin(): Plugin { return { name: 'example', configResolved() {} }; }
+describe('plugin', () => { it('works', () => { expect(plugin()).toBeDefined(); }); });
+export default defineConfig({ plugins: [plugin()] });`;
+      const root = project({ 'src/index.ts': input });
+      const plan = planProject(root);
+      expect(plan.projects[0].configFiles.size).toBe(0);
+      expect(plan.changes).toEqual([]);
+      expect(plan.findings).toEqual([]);
+      applyVitestV5Migration(plan);
+      finishVitestV5Migration(plan);
+      expect(fs.readFileSync(path.join(root, 'src/index.ts'), 'utf8')).toBe(input);
+      expect(planProject(root).projects[0].configFiles.size).toBe(0);
+    },
+  );
+
+  it.each(['vite', 'vite-plus'])(
+    'preserves defaults in named and referenced %s configs without test options',
+    (module) => {
+      const root = project({
+        'vite.config.ts': `import { defineConfig } from '${module}'; export default defineConfig({});`,
+        'vitest.config.ts': `export default { test: { projects: ['./custom.ts'] } };`,
+        'custom.ts': `import { defineConfig } from '${module}'; export default defineConfig({});`,
+      });
+      const plan = planProject(root);
+      expect(plan.projects[0].configFiles.size).toBe(3);
+      for (const name of ['vite.config.ts', 'custom.ts']) {
+        expect(plan.changes.find(({ file }) => file === path.join(root, name))?.after).toContain(
+          'clearMocks: false',
+        );
+      }
+    },
+  );
+
+  it.each([
+    `export default wrapper(defineConfig({ test: { browser: { enabled: true } } }));`,
+    `module.exports = wrapper(defineConfig({ test: { browser: { enabled: true } } }));`,
+    `const fragment = defineConfig({ test: {} }); export default wrapper(fragment);`,
+  ])('leaves wrapped config defaults unchanged: %s', (declaration) => {
+    const input = `import { defineConfig } from 'vitest/config'; ${declaration}`;
+    const result = config(input);
+    expect(result.content).toBe(input);
+    expect(result.findings).toContainEqual(expect.objectContaining({ code: 'dynamic-config' }));
+    const root = project({ 'vite.config.ts': input });
+    const plan = planProject(root);
+    applyVitestV5Migration(plan);
+    finishVitestV5Migration(plan);
+    expect(fs.readFileSync(path.join(root, 'vite.config.ts'), 'utf8')).toBe(input);
+  });
+
+  it('does not add defaults to a dynamic inline defineProject fragment', () => {
+    const fragment = 'defineProject({ test: { browser: { enabled: true } } })';
+    const result = config(
+      `import { defineConfig, defineProject } from 'vitest/config'; export default defineConfig({ test: { projects: [${fragment}] } });`,
+    );
+    expect(result.content).toContain(fragment);
+    expect(result.findings).toContainEqual(expect.objectContaining({ code: 'dynamic-project' }));
+  });
+
+  it.each([`'html'`, `['html', {}]`, `['html', { outputDir: 'reports' }]`])(
+    'preserves top-level HTML outputFile with reporter %s without a review',
+    (reporter) => {
+      const input = `export default { test: { clearMocks: false, reporters: [${reporter}], outputFile: 'old/index.html' } };`;
+      expect(config(input)).toEqual({ content: input, findings: [] });
+    },
+  );
+  it('keeps Node jest-dom matchers separate from browser matchers in one package', () => {
+    const nodeTest = `import { expect } from 'vitest';\nexpect(element).toHaveTextContent('partial');`;
+    const root = project({
+      'vite.config.ts': `export default { test: { projects: [
+        { test: { environment: 'jsdom', include: ['node.test.ts'] } },
+        { test: { browser: { enabled: true }, include: ['browser.test.ts'] } },
+      ] } };`,
+      'node.test.ts': nodeTest,
+      'browser.test.ts': nodeTest,
+    });
+    const plan = planProject(root);
+    expect(plan.changes.some(({ file }) => file === path.join(root, 'node.test.ts'))).toBe(false);
+    expect(
+      plan.changes.find(({ file }) => file === path.join(root, 'browser.test.ts'))?.after,
+    ).toContain("expect(element).toMatchTextContent('partial')");
+    expect(plan.findings.some(({ code }) => code === 'text-content-project')).toBe(false);
+  });
+
+  it.each([
+    `export default { test: { projects: [
+      { test: { include: ['shared.test.ts'] } },
+      { test: { browser: { enabled: true }, include: ['shared.test.ts'] } },
+    ] } };`,
+    `export default () => ({ test: { browser: { enabled: true } } });`,
+    `import { defineConfig } from 'vitest/config';
+export default wrapper(defineConfig({ test: { browser: { enabled: true } } }));`,
+    `export default { test: { projects: ['unknown-config.ts',
+      { test: { browser: { enabled: true } } },
+    ] } };`,
+    `export default { test: { browser: { enabled: enabledAtRuntime },
+      projects: [{ extends: true, test: {} }],
+    } };`,
+    `export default { test: { browser: { enabled: true },
+      include: ['**/*.test.ts', '!shared.test.ts'],
+    } };`,
+    `import { defineConfig } from 'vitest/config';
+module.exports = wrapper(defineConfig({ test: { browser: { enabled: true } } }));`,
+  ])(
+    'reports ambiguous browser ownership without changing a Node-compatible matcher: %s',
+    (configuration) => {
+      const root = project({
+        'vite.config.ts': configuration,
+        'shared.test.ts': `import { expect } from 'vitest';\nexpect(element).toHaveTextContent('partial');`,
+      });
+      const plan = planProject(root);
+      expect(plan.changes.some(({ file }) => file === path.join(root, 'shared.test.ts'))).toBe(
+        false,
+      );
+      expect(plan.findings).toContainEqual(
+        expect.objectContaining({ code: 'text-content-project', severity: 'review' }),
+      );
+    },
+  );
+
+  it('renames expect.element matchers even when project ownership is dynamic', () => {
+    const root = project({
+      'vite.config.ts': `export default () => ({ test: { browser: { enabled: true } } });`,
+      'browser.test.ts': `import { expect } from 'vitest';\nawait expect.element(element).toHaveTextContent('partial');`,
+    });
+    const plan = planProject(root);
+    expect(
+      plan.changes.find(({ file }) => file === path.join(root, 'browser.test.ts'))?.after,
+    ).toContain("expect.element(element).toMatchTextContent('partial')");
+  });
+
+  it('resolves a named config helper and referenced raw project configs', () => {
+    const input = `import { expect } from 'vitest';\nexpect(element).toHaveTextContent('partial');`;
+    const root = project({
+      'vite.config.ts': `import { defineConfig } from 'vitest/config';
+const config = defineConfig({ test: { projects: ['./node-project.ts', './browser-project.ts'] } });
+export default config;`,
+      'node-project.ts': `export default { test: { include: ['node.test.ts'] } };`,
+      'browser-project.ts': `export default { test: { browser: { enabled: true }, include: ['browser.test.ts'] } };`,
+      'node.test.ts': input,
+      'browser.test.ts': input,
+    });
+    const plan = planProject(root);
+    expect(plan.changes.some(({ file }) => file === path.join(root, 'node.test.ts'))).toBe(false);
+    expect(
+      plan.changes.find(({ file }) => file === path.join(root, 'browser.test.ts'))?.after,
+    ).toContain('toMatchTextContent');
+  });
+
+  it('does not infer helper-module ownership from default test globs', () => {
+    const root = project({
+      'vite.config.ts': 'export default { test: { browser: { enabled: true } } };',
+      'assertions.ts': `import { expect } from 'vitest';\nexport function check(element) { expect(element).toHaveTextContent('partial'); }`,
+    });
+    const plan = planProject(root);
+    expect(plan.changes.some(({ file }) => file === path.join(root, 'assertions.ts'))).toBe(false);
+    expect(plan.findings).toContainEqual(
+      expect.objectContaining({ code: 'text-content-project', severity: 'review' }),
+    );
+    applyVitestV5Migration(plan);
+    expect(finishVitestV5Migration(plan)).toContainEqual(
+      expect.objectContaining({ code: 'text-content-project', severity: 'review' }),
+    );
+    expect(planProject(root).findings).toContainEqual(
+      expect.objectContaining({ code: 'text-content-project', severity: 'review' }),
+    );
+  });
+
+  it('does not infer a Node-only assertion when scripts override browser mode', () => {
+    const root = project({
+      'package.json': JSON.stringify({
+        devDependencies: { vitest: '4.1.11' },
+        scripts: { test: 'vitest', 'test:browser': 'vitest --browser' },
+      }),
+      'vite.config.ts': 'export default { test: {} };',
+      'shared.test.ts': `import { expect } from 'vitest';\nexpect(element).toHaveTextContent('partial');`,
+    });
+    const plan = planProject(root);
+    expect(plan.changes.some(({ file }) => file === path.join(root, 'shared.test.ts'))).toBe(false);
+    expect(plan.findings).toContainEqual(
+      expect.objectContaining({ code: 'text-content-project', severity: 'review' }),
+    );
+  });
+
+  it('retains multiline indentation and comments when adding defaults', () => {
+    const result = config(
+      'export default {\r\n  test: {\r\n    // Keep this comment.\r\n    globals: true,\r\n  },\r\n};',
+    );
+    expect(result.content).toBe(
+      [
+        'export default {',
+        '  test: {',
+        '    // Vitest v4 compatibility: preserve mock call history.',
+        '    // Remove after tests no longer rely on calls from setup or earlier tests.',
+        '    // https://vitest.dev/guide/migration/#clearmocks-is-enabled-by-default',
+        '    clearMocks: false,',
+        '    // Keep this comment.',
+        '    globals: true,',
+        '  },',
+        '};',
+      ].join('\r\n'),
+    );
+    expect(config(result.content).content).toBe(result.content);
+  });
+  it('preserves raw CommonJS config defaults', () => {
+    const result = migrateVitestV5Config('vitest.config.cjs', 'module.exports = { test: {} };', v4);
+    expect(result.content).toContain('clearMocks: false');
+    expect(result.findings).toEqual([]);
+  });
+  it('preserves root and non-inheriting project defaults without overriding explicit choices', () => {
+    const result = config(`import { defineConfig } from 'vite-plus';
+export default defineConfig({ test: { projects: [
+  { test: { browser: { enabled: true } } },
+  { extends: true, test: {} },
+  { extends: './base.ts', test: { clearMocks: true, browser: { locators: { exact: true } } } },
+] } });`);
+    expect(result.content).toContain('sharedViteServer: false');
+    expect(result.content.match(/clearMocks: false/g)).toHaveLength(2);
+    expect(result.content).toContain('clearMocks: true');
+    expect(result.content).toContain('exact: false');
+    expect(result.content).toContain('exact: true');
+    expect(result.content.match(/extends: false/g)).toHaveLength(1);
+    expect(config(result.content).content).toBe(result.content);
+  });
+
+  it('does not apply v4 defaults to v5 configs', () => {
+    const input = `export default { test: { projects: [{ test: {} }] } };`;
+    expect(config(input, false).content).toBe(input);
+  });
+
+  it.each([
+    `export default mergeConfig(
+      defineConfig({ test: { clearMocks: true } }),
+      defineConfig({ test: { environment: 'jsdom' } }),
+    );`,
+    `const base = defineConfig({ test: { clearMocks: true } });
+const overrides = defineConfig({ test: { environment: 'jsdom' } });
+export default mergeConfig(base, overrides);`,
+    `export default defineConfig(mergeConfig(
+      { test: { clearMocks: true } },
+      defineProject({ test: { environment: 'jsdom' } }),
+    ));`,
+  ])('does not insert defaults into merged config fragments: %s', (body) => {
+    const input = `import { defineConfig, defineProject, mergeConfig } from 'vitest/config';\n${body}`;
+    const result = config(input);
+    expect(result.content).toBe(input);
+    expect(result.findings).toContainEqual(
+      expect.objectContaining({ code: 'merged-config-defaults', severity: 'review' }),
+    );
+  });
+
+  it('leaves defaults in imported merge fragments for review across migration runs', () => {
+    const base = `import { defineConfig } from 'vitest/config';
+export default defineConfig({ test: { clearMocks: true, browser: { locators: { exact: true } } } });`;
+    const overrides = `import { defineConfig } from 'vitest/config';
+export default defineConfig({ test: { browser: { enabled: true } } });`;
+    const root = project({
+      'vitest.config.ts': `import { mergeConfig } from 'vitest/config';
+import base from './base';
+import overrides from './overrides';
+export default mergeConfig(base, overrides);`,
+      'base.ts': base,
+      'overrides.ts': overrides,
+    });
+    const plan = planProject(root);
+    expect(plan.changes).toEqual([]);
+    expect(plan.findings).toContainEqual(
+      expect.objectContaining({
+        file: path.join(root, 'overrides.ts'),
+        code: 'merged-config-defaults',
+      }),
+    );
+    applyVitestV5Migration(plan);
+    const findings = finishVitestV5Migration(plan);
+    expect(fs.readFileSync(path.join(root, 'base.ts'), 'utf8')).toBe(base);
+    expect(fs.readFileSync(path.join(root, 'overrides.ts'), 'utf8')).toBe(overrides);
+    expect(findings.some(({ code }) => code === 'merged-config-defaults')).toBe(true);
+    expect(planProject(root).changes).toEqual([]);
+  });
+
+  it.each(['true', 'false'])(
+    'preserves inherited locators.exact: %s without a child override',
+    (exact) => {
+      const result = config(`export default { test: {
+  browser: { enabled: true, locators: { exact: ${exact} } },
+  projects: [{ extends: true, test: { browser: { enabled: true } } }],
+} };`);
+      expect(result.content.match(/locators:/g)).toHaveLength(1);
+      expect(result.content).toContain(`locators: { exact: ${exact} }`);
+      expect(result.findings).toEqual([]);
+      expect(config(result.content).content).toBe(result.content);
+    },
+  );
+
+  it('adds locator defaults to an inheriting child when its parent has no browser options', () => {
+    const result = config(`export default { test: {
+  projects: [{ extends: true, test: { browser: { enabled: true } } }],
+} };`);
+    expect(result.content).toMatch(/locators: \{\s*(?:\/\/[^\n]*\n\s*)+exact: false/);
+    expect(result.findings).toEqual([]);
+  });
+
+  it('adds the locator default only to the parent browser config', () => {
+    const result = config(`export default { test: {
+  browser: { enabled: true },
+  projects: [{ extends: true, test: { browser: { enabled: true } } }],
+} };`);
+    expect(result.content.match(/locators:/g)).toHaveLength(1);
+    expect(result.content).toMatch(/locators: \{\s*(?:\/\/[^\n]*\n\s*)+exact: false/);
+  });
+
+  it('does not override dynamic inherited browser settings', () => {
+    const result = config(`export default { test: {
+  browser: sharedBrowser,
+  projects: [{ extends: true, test: { browser: { enabled: true } } }],
+} };`);
+    expect(result.content).not.toContain('exact: false');
+    expect(result.findings).toContainEqual(
+      expect.objectContaining({ code: 'dynamic-project', severity: 'review' }),
+    );
+  });
+
+  it('does not guess dynamic projects or spread options', () => {
+    const result = config(`export default { test: { ...shared, projects: [() => project] } };`);
+    expect(result.content).not.toContain('clearMocks');
+    expect(result.findings.map((finding) => finding.code)).toContain('dynamic-config');
+    const dynamic = config(
+      `export default { test: { projects: [() => project, Promise.resolve(project), project] } };`,
+    );
+    expect(dynamic.findings.filter((finding) => finding.code === 'dynamic-project')).toHaveLength(
+      3,
+    );
+  });
+
+  it('moves browser.api without removing adjacent comments or properties', () => {
+    for (const props of [
+      'api: { port: 4444 }, /* keep, this */ enabled: true',
+      'enabled: true, /* keep, this */ api: { port: 4444 }',
+      '/* keep, this */ api: { port: 4444 },',
+    ]) {
+      const result = config(`export default { test: { browser: { ${props} } } };`);
+      expect(result.content).toContain('api: { port: 4444 }');
+      expect(result.content.match(/api:/g)).toHaveLength(1);
+      expect(result.content).toContain('/* keep, this */');
+      expect(result.findings).toEqual([]);
+    }
+  });
+
+  it('blocks conflicting API settings', () => {
+    const result = config(
+      `export default { test: { api: { port: 1 }, browser: { api: { port: 2 } } } };`,
+    );
+    expect(result.findings).toContainEqual(
+      expect.objectContaining({ code: 'api-conflict', severity: 'block' }),
+    );
+  });
+
+  it.each([
+    ['true', 'true'],
+    ['false', 'false'],
+    ['51204', '0xc804'],
+    [`{ host: 'localhost', port: 51204 }`, `{ "port": 51204, 'host': "localhost" }`],
+    [
+      `{ port: 51204, allowWrite: false, allowExec: false }`,
+      `{ allowExec: false, allowWrite: false, port: 51204 }`,
+    ],
+  ])('deduplicates equivalent static API values: %s and %s', (api, browserApi) => {
+    const result = config(
+      `export default { test: { api: ${api}, browser: { api: ${browserApi}, enabled: false } } };`,
+    );
+    expect(result.findings).toEqual([]);
+    expect(result.content.match(/\bapi:/g)).toHaveLength(1);
+    expect(result.content).toContain(`api: ${api}`);
+    expect(config(result.content).content).toBe(result.content);
+  });
+
+  it.each([
+    ['options', 'options'],
+    ['getApi()', 'getApi()'],
+    [`{ port: 1, ...options }`, `{ port: 1, ...options }`],
+    [`{ get port() { return 1 } }`, `{ get port() { return 1 } }`],
+    [`{ port: 1, port: 2 }`, `{ port: 1, port: 2 }`],
+    [`{ port: 1 }`, `{ port: 1, host: '0.0.0.0' }`],
+    [`{ allowExec: false }`, `{ allowExec: true }`],
+  ])(
+    'does not choose between unresolved or conflicting API values: %s and %s',
+    (api, browserApi) => {
+      const result = config(
+        `export default { test: { api: ${api}, browser: { api: ${browserApi} } } };`,
+      );
+      expect(result.findings).toContainEqual(
+        expect.objectContaining({ code: 'api-conflict', severity: 'block' }),
+      );
+      expect(result.content.match(/\bapi:/g)).toHaveLength(2);
+    },
+  );
+
+  it('copies screenshot and glob perFile settings without changing report formatting', () => {
+    const result = config(`export default { test: {
+browser: { screenshotDirectory: 'screens', expect: { toMatchScreenshot: { threshold: 0.1 } } },
+coverage: { include: ['src'], thresholds: { perFile: true, 'src/**': { lines: 90 }, 'lib/**': { perFile: false } } },
+reporters: ['default', 'json', ['junit', {}], ['html', { outputFile: 'reports/index.html' }]],
+} };`);
+    expect(result.content.match(/screenshotDirectory: 'screens'/g)).toHaveLength(2);
+    expect(result.content.match(/perFile: true/g)).toHaveLength(2);
+    expect(result.content).toContain('perFile: false');
+    expect(result.content).not.toContain('stdout');
+    expect(result.content).toContain(
+      "reporters: ['default', 'json', ['junit', {}], ['html', { outputFile: 'reports/index.html' }]]",
+    );
+    expect(result.findings.map((finding) => finding.code)).toEqual(['coverage-patterns']);
+    expect(config(result.content).content).toBe(result.content);
+  });
+
+  it('keeps explicit report destinations without reviewing non-index HTML files', () => {
+    const result = config(
+      `export default { test: { outputFile: { json: 'report.json' }, reporters: ['json', ['junit', { stdout: false }], ['html', { outputFile: 'custom.html' }]] } };`,
+    );
+    expect(result.content).not.toContain('stdout: true');
+    expect(result.content).toContain('stdout: false');
+    expect(result.content).toContain("outputFile: 'custom.html'");
+    expect(result.findings).toEqual([]);
+  });
+
+  it.each([true, false])('retains supported benchmark options (preserveV4=%s)', (preserveV4) => {
+    const input = `export default { test: { clearMocks: false, benchmark: {
+      enabled: true, include: ['**/*.bench.ts'], exclude: [], retainSamples: true,
+    } } };`;
+    expect(config(input, preserveV4)).toEqual({ content: input, findings: [] });
+  });
+
+  it.each(['reporters', 'compare'])('blocks the removed benchmark.%s option', (key) => {
+    const result = config(`export default { test: { benchmark: { ${key}: 'old' } } };`);
+    expect(result.findings).toEqual([
+      expect.objectContaining({ code: 'benchmark-api', severity: 'block' }),
+    ]);
+    expect(result.findings[0].message).toContain(`benchmark.${key}`);
+  });
+
+  it('reports dynamic benchmark options for review', () => {
+    expect(config('export default { test: { benchmark: options } };').findings).toEqual([
+      expect.objectContaining({ code: 'benchmark-api', severity: 'review' }),
+    ]);
+  });
+
+  it('preserves an installed Temporal polyfill only when toNotFake was omitted', () => {
+    const result = migrateVitestV5Config('vite.config.ts', 'export default { test: {} };', {
+      preserveV4: true,
+      temporalPolyfill: true,
+    });
+    expect(result.content).toContain("toNotFake: ['Temporal']");
+    const explicit = migrateVitestV5Config(
+      'vite.config.ts',
+      'export default { test: { fakeTimers: { toNotFake: [] } } };',
+      { preserveV4: true, temporalPolyfill: true },
+    );
+    expect(explicit.content).toContain('toNotFake: []');
+  });
+});
+
+describe('Vitest v5 source migration', () => {
+  it('initializes runner aliases before executable code and retains directives', () => {
+    const result = source(
+      `'use strict';\nconst fn = getFn({});\nimport { getFn } from '@vitest/runner';`,
+    );
+    expect(result.findings).toEqual([]);
+    expect(result.content.startsWith("'use strict';")).toBe(true);
+    expect(result.content.indexOf('const getFn =')).toBeLessThan(
+      result.content.indexOf('const fn ='),
+    );
+    const executable = result.content.replace(/import \{[^}]+\} from 'vite-plus\/test';/, '');
+    expect(
+      runInNewContext(`${executable}\nfn;`, { _VitestTestRunner: { getTestFn: () => 42 } }),
+    ).toBe(42);
+    expect(source(result.content).content).toBe(result.content);
+  });
+
+  it.each([
+    `import runner, { getFn } from '@vitest/runner';`,
+    `import runner from '@vitest/runner';`,
+    `import * as runner from '@vitest/runner';`,
+  ])('retains blocked default and namespace import syntax: %s', (input) => {
+    const result = source(input);
+    expect(result.content).toBe(input);
+    expect(result.findings).toContainEqual(
+      expect.objectContaining({ code: 'removed-api', severity: 'block' }),
+    );
+  });
+
+  it('migrates a sequential modifier and its redundant option together', () => {
+    const result = source(
+      `import { test } from 'vitest'; test.sequential('x', { sequential: true }, () => {});`,
+    );
+    expect(result.content).toBe(
+      `import { test } from 'vitest'; test('x', { concurrent: false }, () => {});`,
+    );
+    expect(result.findings).toEqual([]);
+    expect(source(result.content).content).toBe(result.content);
+  });
+
+  it.each(['test', 'it'])('preserves the numeric timeout of %s.sequential', (api) => {
+    for (const callback of ['async () => {}', 'function () {}']) {
+      const input = `import { ${api} } from 'vitest'; ${api}.sequential('slow', ${callback}, 15_000);`;
+      const result = source(input);
+      expect(result.content).toBe(
+        `import { ${api} } from 'vitest'; ${api}('slow', { concurrent: false, timeout: 15_000 }, ${callback});`,
+      );
+      expect(result.findings).toEqual([]);
+      expect(source(result.content).content).toBe(result.content);
+      const calls: unknown[][] = [];
+      runInNewContext(result.content.replace(/^import[^;]+;/, ''), {
+        [api]: (...args: unknown[]) => calls.push(args),
+      });
+      expect(calls[0]).toHaveLength(3);
+      expect(calls[0][1]).toEqual({ concurrent: false, timeout: 15000 });
+    }
+  });
+
+  it.each([
+    `test.sequential('slow', async () => {}, timeout);`,
+    `it.sequential('slow', async () => {}, { timeout: 15000 });`,
+    `test.sequential('slow', async () => {}, ...options);`,
+    `it.sequential('slow', async () => {}, 15000, extra);`,
+    `test.sequential('slow', async () => {}, /* keep timeout comment */ 15000);`,
+  ])('preserves sequential calls with unresolved trailing arguments: %s', (call) => {
+    const input = `import { test, it } from 'vitest'; ${call}`;
+    const result = source(input);
+    expect(result.content).toBe(input);
+    expect(result.findings).toContainEqual(expect.objectContaining({ code: 'sequential-api' }));
+  });
+
+  it.each([
+    `test.sequential('x', { sequential: false }, () => {});`,
+    `test.sequential('x', { sequential: true, concurrent: true }, () => {});`,
+    `test.sequential.each([1])('x', { sequential: true }, () => {});`,
+  ])('leaves unresolved sequential calls intact: %s', (call) => {
+    const input = `import { test } from 'vitest'; ${call}`;
+    const result = source(input);
+    expect(result.content).toBe(input);
+    expect(result.findings).toContainEqual(expect.objectContaining({ code: 'sequential-api' }));
+  });
+
+  it('reports actual DOM globals but ignores locally shadowed identifiers and objects', () => {
+    const result = source(
+      `function f(navigator, window, globalThis, global) { navigator = {}; window.navigator = {}; globalThis.navigator = {}; global.navigator = {}; }\nnavigator = {}; window.navigator = {};`,
+    );
+    expect(result.findings.filter(({ code }) => code === 'dom-global')).toHaveLength(2);
+    expect(result.findings.every(({ line }) => line === 2)).toBe(true);
+  });
+  it.each(['./runners', '../runners', 'custom/runners'])(
+    'leaves unrelated %s modules unchanged',
+    (specifier) => {
+      const input = `export { helper } from '${specifier}';
+export * from '${specifier}';
+const dynamic = await import('${specifier}');
+const commonjs = require('${specifier}');
+type Runner = import('${specifier}').Runner;`;
+      expect(source(input)).toEqual({ content: input, findings: [] });
+    },
+  );
+
+  it.each(['vitest/runners', 'vite-plus/test/runners'])(
+    'still reports removed %s re-exports and indirect imports',
+    (specifier) => {
+      const result = source(`export { VitestTestRunner } from '${specifier}';
+export * from '${specifier}';
+const dynamic = await import('${specifier}');
+const commonjs = require('${specifier}');
+type Runner = import('${specifier}').VitestTestRunner;`);
+      expect(result.findings.filter(({ severity }) => severity === 'block')).toHaveLength(4);
+      expect(result.findings.filter(({ severity }) => severity === 'review')).toHaveLength(1);
+      expect(result.findings.every(({ code }) => code === 'removed-api')).toBe(true);
+    },
+  );
+
+  it('preserves computed matcher keys and remains idempotent', () => {
+    const result = source(`import { test, expect } from 'vitest';
+test('text', async () => {
+  await expect.element(el)['toHaveTextContent']('partial');
+  await expect.element(el)["toHaveTextContent"](/partial/);
+});`);
+    expect(result.content).toContain('["toMatchTextContent"](\'partial\')');
+    expect(result.content).toContain('["toMatchTextContent"](/partial/)');
+    expect(result.findings).toEqual([]);
+    expect(source(result.content).content).toBe(result.content);
+  });
+
+  it('does not report matcher declarations that already use both v5 parameters', () => {
+    const input = `declare module 'vite-plus/test' {
+  interface Matchers<R extends void | Promise<void> = void | Promise<void>, T = unknown> {
+    toEqualReceived(value: T): R;
+  }
+}`;
+    expect(source(input, { preserveV4: false, browser: false })).toEqual({
+      content: input,
+      findings: [],
+    });
+    expect(source('interface Assertion<T> {}').findings).toEqual([
+      expect.objectContaining({ code: 'assertion-types', severity: 'review' }),
+    ]);
+  });
+
+  it('handles namespace imports without touching a shadowed namespace', () => {
+    const result = source(`import * as v from 'vitest';
+v.test.sequential('works', () => { v.expect(Promise.resolve(1)).resolves.toBe(1); });
+v.test('mock', () => v.vi.mock('./a'));
+function helper(v) { v.test.sequential('local', () => {}); }`);
+    expect(result.content).toContain("v.test('works', { concurrent: false }, async () =>");
+    expect(result.content).toContain('await v.expect(Promise.resolve(1)).resolves.toBe(1)');
+    expect(result.content).toContain("v.test.sequential('local', () => {})");
+    expect(result.findings.map((finding) => finding.code)).toContain('nested-hoisted-mock');
+  });
+
+  it('reports type imports without blocking runtime migration', () => {
+    const result = source(`type Runner = import('vitest/internal/module-runner').ModuleRunner;`);
+    expect(result.findings).toEqual([
+      expect.objectContaining({ severity: 'review', code: 'removed-api' }),
+    ]);
+  });
+
+  it('does not add constructor warnings for ordinary function mocks', () => {
+    expect(
+      source(`import { vi } from 'vitest'; const fn = vi.fn(() => 1); vi.spyOn(console, 'log');`)
+        .findings,
+    ).toEqual([]);
+  });
+  it('rewrites safe sequential calls and assertions together', () => {
+    const result = source(`import { test as check, expect } from 'vitest';
+check.sequential('works', () => { expect(Promise.resolve(1)).resolves.toBe(1); });
+check('options', { sequential: true }, () => {});
+expect(() => {}).toThrow('');
+expect.element(el).toHaveTextContent('partial');
+expect.element(el).toHaveTextContent(/partial/);`);
+    expect(result.content).toContain("check('works', { concurrent: false }, async () =>");
+    expect(result.content).toContain('await expect(Promise.resolve(1)).resolves.toBe(1)');
+    expect(result.content).toContain('toThrow(/^$/)');
+    expect(result.content.match(/toMatchTextContent/g)).toHaveLength(2);
+    expect(source(result.content).content).toBe(result.content);
+  });
+
+  it('respects local aliases and shadowed bindings', () => {
+    const input = `import { test, expect as assert } from 'vitest';
+function helper(test, assert) { test.sequential('x', () => {}); assert(() => {}).toThrow(''); }
+test('x', () => assert(() => {}).toThrow(''));`;
+    const result = source(input);
+    expect(result.content).toContain("test.sequential('x', () => {})");
+    expect(result.content).toContain("assert(() => {}).toThrow('')");
+    expect(result.content).toContain('toThrow(/^$/)');
+  });
+
+  it.each(['@vitest/expect', 'vite-plus/test/plugins/expect'])(
+    'migrates assertions from %s in the same pass as their imports',
+    (specifier) => {
+      const result = source(`import { expect as check } from '${specifier}';
+import { test } from 'vitest';
+function helper(check) { check(() => {}).toThrow(''); }
+test('works', () => {
+  check(() => { throw new Error('boom'); }).not.toThrow('');
+  check(Promise.resolve(1)).resolves.toBe(1);
+  check.element(el).toHaveTextContent('partial');
+});`);
+      expect(result.content).toContain("import { expect as check } from 'vite-plus/test'");
+      expect(result.content).toContain("function helper(check) { check(() => {}).toThrow(''); }");
+      expect(result.content).toContain('.not.toThrow(/^$/)');
+      expect(result.content).toContain("test('works', async () =>");
+      expect(result.content).toContain('await check(Promise.resolve(1)).resolves.toBe(1)');
+      expect(result.content).toContain("await check.element(el).toMatchTextContent('partial')");
+      expect(result.findings).toEqual([]);
+      expect(source(result.content).content).toBe(result.content);
+    },
+  );
+
+  it('only makes async-compatible callbacks async', () => {
+    const result = source(`import { test, describe, expect } from 'vitest';
+import { render as mount } from 'vitest-browser-vue';
+test('component', () => { const screen = mount(Component); expect(Promise.resolve(1)).resolves.toBe(1); });
+describe('suite', () => { mount(Component); });
+function publicSync() { return { screen: mount(Component) }; }`);
+    expect(result.content).toContain("test('component', async () =>");
+    expect(result.content).toContain('(await mount(Component))');
+    expect(result.content).toContain("describe('suite', () => { mount(Component); })");
+    expect(result.findings.filter((finding) => finding.code === 'async-render')).toHaveLength(2);
+  });
+
+  it('migrates runner aliases and preserves unsupported type-only imports for review', () => {
+    const result =
+      source(`import { test as check, getFn as lookup, type File as MyFile, type SuiteHooks } from '@vitest/runner';
+import { createExpect as makeExpect } from '@vitest/expect';
+lookup(task);`);
+    expect(result.content).toContain('test as check');
+    expect(result.content).toContain('type RunnerTestFile as MyFile');
+    expect(result.content).toContain('const lookup = _VitestTestRunner.getTestFn');
+    expect(result.content).toContain('createExpect as makeExpect');
+    expect(result.findings).toContainEqual(
+      expect.objectContaining({ severity: 'review', code: 'removed-api' }),
+    );
+    expect(result.findings.some((finding) => finding.severity === 'block')).toBe(false);
+  });
+
+  it('blocks unsupported active internals while migrating direct benchmarks', () => {
+    const result = source(`import { startTests } from '@vitest/runner';
+import * as internals from 'vitest/internal/module-runner';
+import { bench } from 'vitest';
+bench('old', () => {});`);
+    expect(result.findings.filter((finding) => finding.severity === 'block')).toHaveLength(2);
+  });
+
+  it('migrates global benchmarks but preserves the new test-context fixture', () => {
+    const result = migrateVitestV5Source(
+      'example.test.ts',
+      `bench('old', () => {});
+test('new', ({ bench }) => { bench('new', () => {}); });`,
+      { ...v4, globals: true },
+    );
+    expect(result.findings).toEqual([]);
+    expect(result.content).toContain(`globalThis.test('old'`);
+    expect(result.content).toContain(`test('new', ({ bench }) => { bench('new', () => {}); });`);
+  });
+
+  it('rewrites resolveConfig destructuring with aliases and collect options', () => {
+    const result = source(`import { resolveConfig as resolve, createVitest } from 'vitest/node';
+const { viteConfig: vite, vitestConfig: test } = await resolve();
+const runner = await createVitest('test', {});
+await runner.collect();
+await runner.collect(['unit'], {});
+await runner.collect([], { staticParse: true });
+other.collect(options);`);
+    expect(result.content).toContain('const vite = await resolve(), test = vite.test');
+    expect(result.content).toContain('runner.collect(undefined, { staticParse: false })');
+    expect(result.content).toContain("runner.collect(['unit'], { staticParse: false })");
+    expect(result.content).toContain('staticParse: true');
+    expect(result.findings.map((finding) => finding.code)).toEqual(['static-collect']);
+    expect(source(result.content).content).toBe(result.content);
+  });
+
+  it('reports manual migration risks with line locations', () => {
+    const result = source(`import { vi, test, expect } from 'vitest';
+import '@vitest/ws-client';
+test('mock', () => { vi.mock('./a'); vi.fn(class {}); });
+process.env.VITEST_POOL_ID;
+globalThis.navigator = value;
+globalThis.foo = originals.get('foo');
+Temporal.Now.instant(); vi.setSystemTime(0);
+const ui = 'http://localhost:51204/__vitest__/';
+const browser = 'http://localhost:63315/__vitest_test__/';
+interface Assertion<T> {}
+expect.poll(() => 1).toBe(1);`);
+    expect(result.findings.map((finding) => finding.code)).toEqual(
+      expect.arrayContaining([
+        'nested-hoisted-mock',
+        'browser-automock',
+        'class-mock',
+        'worker-id',
+        'dom-global',
+        'global-descriptors',
+        'temporal-system-time',
+        'ui-token',
+        'browser-session',
+        'assertion-types',
+        'poll-timeout',
+        'unawaited-assertion',
+      ]),
+    );
+    expect(result.findings.every((finding) => finding.line > 1)).toBe(true);
+  });
+});
+
+describe('Vitest v5 command migration', () => {
+  it.each([
+    'vitest run -t adds',
+    'vitest run --testNamePattern=adds_numbers',
+    'vitest run -- -t',
+    'vitest --reporter=json | jq',
+    'vitest && cp -r .vitest-attachements artifacts',
+  ])('leaves output settings and simple name filters alone: %s', (command) => {
+    expect(migrateVitestV5Command('package.json', command, true)).toEqual({
+      content: command,
+      findings: [],
+    });
+  });
+
+  it.each(['vitest run -t "suite test"', '(vitest list)'])(
+    'does not review an existing v5 command: %s',
+    (command) => {
+      expect(migrateVitestV5Command('package.json', command, false)).toEqual({
+        content: command,
+        findings: [],
+      });
+      expect(migrateVitestV5Command('package.json', command, false, 1, true).findings).toHaveLength(
+        1,
+      );
+    },
+  );
+
+  it.each([
+    ['vitest run -t "suite test"', 'test-name-pattern', 'review'],
+    ['vitest run -t suite.test', 'test-name-pattern', 'review'],
+    ['vitest --compare=baseline.json', 'benchmark-api', 'block'],
+    ['vitest --outputJson=$BASELINE', 'benchmark-api', 'block'],
+  ])('reports %s without changing it', (command, code, severity) => {
+    const result = migrateVitestV5Command('package.json', command, true, 7);
+    expect(result.content).toBe(command);
+    expect(result.findings).toContainEqual(expect.objectContaining({ code, severity, line: 7 }));
+  });
+
+  it('does not preserve v4 collection defaults for a v5 project', () => {
+    expect(migrateVitestV5Command('package.json', 'vitest list', false)).toEqual({
+      content: 'vitest list',
+      findings: [],
+    });
+  });
+  it.each([
+    'vitest list',
+    'pnpm exec vitest list',
+    'npm exec -- vitest list',
+    'npx vitest list',
+    'vp test list',
+  ])('preserves runtime collection for %s', (command) => {
+    const result = migrateVitestV5Command('package.json', `${command} 'unit tests'`, true);
+    expect(result.content).toBe(`${command} --no-static-parse 'unit tests'`);
+    expect(migrateVitestV5Command('package.json', result.content, true).content).toBe(
+      result.content,
+    );
+  });
+  it.each([
+    'vitest list --static-parse',
+    'vitest list --no-static-parse',
+    'vitest list --static-parse=false',
+  ])('keeps explicit flags: %s', (command) => {
+    expect(migrateVitestV5Command('package.json', command, true).content).toBe(command);
+  });
+  it.each([
+    'vitest list | jq .',
+    'NODE_ENV=test vitest list',
+    'vitest list "$FILTER"',
+    'wrapper vitest list',
+    'vitest list && echo done',
+  ])('reports uncertain commands: %s', (command) => {
+    const result = migrateVitestV5Command('ci.yml', command, true);
+    expect(result.content).toBe(command);
+    expect(result.findings).toContainEqual(expect.objectContaining({ code: 'static-list' }));
+  });
+  it('does not interpret filter arguments after -- as options', () => {
+    expect(
+      migrateVitestV5Command('package.json', 'vitest list -- --static-parse', true).content,
+    ).toBe('vitest list --no-static-parse -- --static-parse');
+  });
+});
+
+describe('Vitest v5 versioned preflight', () => {
+  it.each(['catalog:', 'catalog:testing'])(
+    'resolves the installed runner of a linked Vite+ build with %s',
+    (specifier) => {
+      const root = project({
+        'package.json': JSON.stringify({ devDependencies: { 'vite-plus': 'latest' } }),
+        'vite.config.ts': 'export default { test: {} };',
+        'node_modules/vite-plus/package.json': JSON.stringify({
+          name: 'vite-plus',
+          version: '0.0.0',
+          dependencies: { vitest: specifier },
+        }),
+        'node_modules/vite-plus/node_modules/vitest/package.json': JSON.stringify({
+          name: 'vitest',
+          version: '5.0.1',
+        }),
+        // The project catalog does not describe the linked toolchain's runner.
+        'pnpm-workspace.yaml': 'catalog:\n  vitest: 4.1.11\n',
+      });
+      const plan = planProject(root);
+      expect(plan.projects[0].sourceVersion).toBe('5.0.1');
+      expect(plan.changes).toEqual([]);
+      expect(plan.findings).toEqual([]);
+      expect(vitestV5NeedsMigration(plan)).toBe(false);
+      expect(fs.existsSync(path.join(root, '.vite-plus/migrations.json'))).toBe(false);
+    },
+  );
+
+  it('retains original activity after bootstrap removes a redundant direct runner', () => {
+    const root = project();
+    const original = planProject(root);
+    fs.writeFileSync(path.join(root, 'package.json'), '{}');
+    const refreshed = refreshVitestV5Migration(original);
+    expect(refreshed.projects[0]).toMatchObject({
+      active: true,
+      sourceVersion: '4.1.0',
+      options: { preserveV4: true },
+    });
+    expect(refreshed.findings).toEqual([]);
+    applyVitestV5Migration(refreshed);
+    expect(finishVitestV5Migration(refreshed)).toEqual([]);
+    expect(planProject(root).projects[0].sourceVersion).toBeUndefined();
+  });
+
+  it.each(['4.1.11', '5.0.0'])(
+    'does not infer original test usage from a newly added peer runner %s',
+    (version) => {
+      const root = project({ 'package.json': '{}' });
+      const original = planProject(root);
+      expect(original.projects[0].active).toBe(false);
+      fs.writeFileSync(
+        path.join(root, 'package.json'),
+        JSON.stringify({ devDependencies: { vitest: version } }),
+      );
+      const refreshed = refreshVitestV5Migration(original);
+      expect(refreshed.projects[0]).toMatchObject({
+        active: false,
+        sourceVersion: undefined,
+        options: { preserveV4: false },
+      });
+      expect(refreshed.findings).toEqual([]);
+      expect(refreshed.changes).toEqual([]);
+    },
+  );
+  it.each(['', '\uFEFF'])(
+    'preserves manifest formatting and BOM %j when changing a script',
+    (bom) => {
+      const before = `${bom}{\r\n\t"name": "test",\r\n\t"scripts": { "test": "vitest list", "filter": "vitest -t suite.test" },\r\n\t"devDependencies": {"vitest":"^4.1.0"}\r\n}`;
+      const root = project({ 'package.json': before });
+      const plan = planProject(root);
+      expect(plan.changes.find(({ file }) => file === path.join(root, 'package.json'))?.after).toBe(
+        before.replace('vitest list', 'vitest list --no-static-parse'),
+      );
+      expect(plan.findings).toContainEqual(
+        expect.objectContaining({ code: 'test-name-pattern', line: 3 }),
+      );
+      applyVitestV5Migration(plan);
+      expect(planProject(root).changes).toEqual([]);
+    },
+  );
+
+  it.each(['vitest list', ['vitest list'], null])(
+    'ignores malformed scripts containers: %j',
+    (scripts) => {
+      const root = project({
+        'package.json': JSON.stringify({ scripts, devDependencies: { vitest: '^4.1.0' } }),
+      });
+      expect(planProject(root).changes).toEqual([]);
+    },
+  );
+
+  it.each(['4.1.11', '5.0.0'])(
+    'refreshes changed setup inputs without losing original Vitest %s',
+    (version) => {
+      const before = JSON.stringify({
+        devDependencies: { vitest: version },
+        scripts: { test: 'vitest list' },
+      });
+      const root = project({
+        'package.json': before,
+        'vite.config.ts': 'export default { test: {} };',
+      });
+      const original = planProject(root);
+      expect(fs.readFileSync(path.join(root, 'package.json'), 'utf8')).toBe(before);
+      // Model an earlier install/tool migration changing a manifest and config.
+      fs.writeFileSync(
+        path.join(root, 'package.json'),
+        JSON.stringify({
+          devDependencies: { vitest: '5.0.0' },
+          scripts: { test: 'vitest list', lint: 'oxlint' },
+        }),
+      );
+      fs.writeFileSync(
+        path.join(root, 'vite.config.ts'),
+        'export default { test: { name: "keep" } };',
+      );
+      const refreshed = refreshVitestV5Migration(original);
+      expect(refreshed.projects[0].sourceVersion).toBe(version);
+      applyVitestV5Migration(refreshed);
+      const manifest = fs.readFileSync(path.join(root, 'package.json'), 'utf8');
+      expect(manifest).toContain('oxlint');
+      expect(manifest.includes('--no-static-parse')).toBe(version.startsWith('4'));
+      expect(fs.readFileSync(path.join(root, 'vite.config.ts'), 'utf8')).toContain('name: "keep"');
+      expect(fs.existsSync(path.join(root, '.vite-plus/migrations.json'))).toBe(false);
+      fs.writeFileSync(path.join(root, 'vite.config.ts'), 'export default {};');
+      expect(() => applyVitestV5Migration(refreshed)).toThrow('Migration input changed');
+    },
+  );
+  it.each([
+    ['an unpaired surrogate', String.raw`'\ud800'`],
+    ['a deep expression', Array(160).fill('1').join(' + ')],
+  ])('migrates removed APIs in a file with %s without blocking preflight', (_name, expression) => {
+    const declaration = `const value = ${expression};`;
+    const root = project({
+      'example.test.ts': `import { getFn } from '@vitest/runner';\n${declaration}`,
+    });
+    const plan = planProject(root);
+    expect(plan.findings.some(({ code }) => code === 'source-parse')).toBe(false);
+    expect(plan.findings.some(({ severity }) => severity === 'block')).toBe(false);
+    const change = plan.changes.find(({ file }) => file === path.join(root, 'example.test.ts'));
+    expect(change?.after).toContain('const getFn = _VitestTestRunner.getTestFn;');
+    expect(change?.after).toContain(declaration);
+  });
+
+  it('keeps Flow files unchanged and reports unsupported syntax before migration', () => {
+    const input = `// @flow\nimport { expect } from 'vitest';\nconst value: string = '';\nexpect(() => {}).toThrow('');`;
+    const root = project({ 'flow.test.js': input });
+    const file = path.join(root, 'flow.test.js');
+    const plan = planProject(root);
+    expect(plan.changes.some((change) => change.file === file)).toBe(false);
+    expect(plan.findings).toContainEqual(
+      expect.objectContaining({
+        file,
+        code: 'source-parse',
+        message: expect.stringContaining('Flow is not supported'),
+      }),
+    );
+    expect(fs.readFileSync(file, 'utf8')).toBe(input);
+  });
+
+  it.each([
+    `import { defineConfig } from 'vitest/config';
+export default defineConfig(CONFIG);`,
+    `const config = CONFIG; export default config;`,
+    `module.exports = CONFIG;`,
+  ])('does not treat plugin projects or extends as Vitest config references: %s', (wrapper) => {
+    const root = project({
+      'vite.config.ts': wrapper.replace(
+        'CONFIG',
+        `{
+        plugins: [paths({ projects: ['./tsconfig.json', './plugin-options.ts'], extends: './plugin-base.ts' })],
+        test: { projects: [{ extends: './test-base.ts', test: { projects: ['./checks.ts'] } }] },
+      }`,
+      ),
+      'tsconfig.json': '{ "compilerOptions": {} }',
+      'plugin-options.ts': 'export default { test: {} };',
+      'plugin-base.ts': 'export default { test: {} };',
+      'test-base.ts': 'export default { test: {} };',
+      'checks.ts': 'export default { test: {} };',
+    });
+    const plan = planProject(root);
+    expect([...plan.projects[0].configFiles].map((file) => path.basename(file)).toSorted()).toEqual(
+      ['checks.ts', 'test-base.ts', 'vite.config.ts'],
+    );
+    expect(plan.findings.some(({ code }) => code === 'source-parse')).toBe(false);
+    expect(plan.changes.some(({ file }) => /plugin-(?:options|base)\.ts$/.test(file))).toBe(false);
+  });
+
+  it('reports the Jest-only DOM type entry without guessing mixed test configuration', () => {
+    const root = project({
+      'vite.config.ts': 'export default { test: {} };',
+      'tsconfig.json':
+        '{ // inherited setup files need review\n"compilerOptions": { "types": ["@testing-library/jest-dom", "vitest/globals"] } }',
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toContainEqual(
+      expect.objectContaining({ code: 'jest-dom-types', severity: 'review' }),
+    );
+    expect(plan.changes.some(({ file }) => file === path.join(root, 'tsconfig.json'))).toBe(false);
+    fs.writeFileSync(
+      path.join(root, 'tsconfig.json'),
+      JSON.stringify({
+        compilerOptions: {
+          types: [
+            '@testing-library/jest-dom',
+            '@testing-library/jest-dom/vitest',
+            'vitest/globals',
+          ],
+        },
+      }),
+    );
+    expect(planProject(root).findings.some(({ code }) => code === 'jest-dom-types')).toBe(false);
+  });
+
+  it('does not mistake ambient config declarations or type imports for a config', () => {
+    const root = project({
+      'types.ts':
+        "import type { UserConfig } from 'vitest/config';\ndeclare module 'vitest/config' { const config: UserConfig; export default config; }",
+    });
+    const plan = planProject(root);
+    expect(plan.projects[0].configFiles.size).toBe(0);
+    expect(plan.findings).toEqual([]);
+  });
+
+  it('retains the Yarn catalog resolver when scanning after dependency updates', () => {
+    const root = project({
+      'package.json': JSON.stringify({ devDependencies: { '@vitest/ui': '^4.1.11' } }),
+      '.yarnrc.yml': 'catalog:\n  vitest: 5.0.0\n',
+    });
+    const plan = planVitestV5Migration({ rootDir: root, packageManager: PackageManager.yarn });
+    expect(plan.projects[0].active).toBe(false);
+    applyVitestV5Migration(plan);
+    fs.writeFileSync(
+      path.join(root, 'package.json'),
+      JSON.stringify({ devDependencies: { vitest: 'catalog:' } }),
+    );
+    expect(finishVitestV5Migration(plan)).toEqual([]);
+  });
+  it('migrates raw referenced configs with custom filenames and nested references', () => {
+    const root = project({
+      'vitest.config.ts': "export default { test: { projects: ['./node-tests.ts'] } };",
+      'node-tests.ts': "export default { test: { projects: ['./browser-tests.ts'] } };",
+      'browser-tests.ts': 'export default { test: { browser: { enabled: true } } };',
+    });
+    const plan = planProject(root);
+    expect(plan.projects[0].configFiles.size).toBe(3);
+    applyVitestV5Migration(plan);
+    expect(fs.readFileSync(path.join(root, 'node-tests.ts'), 'utf8')).toContain(
+      'clearMocks: false',
+    );
+    expect(fs.readFileSync(path.join(root, 'browser-tests.ts'), 'utf8')).toContain('exact: false');
+  });
+
+  it('follows project globs across workspace package boundaries', () => {
+    const root = project({
+      'vitest.config.ts': "export default { test: { projects: ['./packages/*/checks.ts'] } };",
+      'packages/unit/package.json': '{}',
+      'packages/unit/checks.ts': 'export default { test: {} };',
+    });
+    const plan = planVitestV5Migration({
+      rootDir: root,
+      packageManager: PackageManager.pnpm,
+      packages: [{ name: 'unit', path: 'packages/unit' }],
+    });
+    expect(plan.projects[1].configFiles.size).toBe(1);
+    applyVitestV5Migration(plan);
+    finishVitestV5Migration(plan);
+    expect(fs.readFileSync(path.join(root, 'packages/unit/checks.ts'), 'utf8')).toContain(
+      'clearMocks: false',
+    );
+    expect(fs.existsSync(path.join(root, '.vite-plus/migrations.json'))).toBe(false);
+  });
+
+  it('rejects runtime input changes between preflight and application', () => {
+    const root = project({
+      '.node-version': '22.18.0',
+      'vite.config.ts': 'export default { test: {} };',
+    });
+    const plan = planProject(root);
+    fs.writeFileSync(path.join(root, '.node-version'), '20.19.0');
+    expect(() => applyVitestV5Migration(plan)).toThrow('Migration input changed');
+    expect(fs.readFileSync(path.join(root, 'vite.config.ts'), 'utf8')).not.toContain('clearMocks');
+  });
+
+  it('does not require a Vitest source version for a Vite+-only build project', () => {
+    const root = project({
+      'package.json': JSON.stringify({ devDependencies: { 'vite-plus': '0.2.0' } }),
+      'vite.config.ts':
+        "import { defineConfig } from 'vite-plus'; export default defineConfig({});",
+    });
+    expect(planProject(root).findings).toEqual([]);
+    expect(planProject(root).projects[0].active).toBe(false);
+  });
+
+  it('does not mistake a parameter named test for Vitest usage', () => {
+    const root = project({
+      'package.json': '{}',
+      'business.ts': 'export function run(test: string) { return test; }',
+    });
+    expect(planProject(root).findings).toEqual([]);
+    expect(planProject(root).projects[0].active).toBe(false);
+  });
+
+  it('does not rewrite new v5 assertions in a migrated configless project without state', () => {
+    const root = project();
+    const plan = planProject(root);
+    applyVitestV5Migration(plan);
+    finishVitestV5Migration(plan);
+    fs.writeFileSync(
+      path.join(root, 'package.json'),
+      JSON.stringify({ devDependencies: { vitest: '5.0.1' } }),
+    );
+    fs.writeFileSync(
+      path.join(root, 'new.test.ts'),
+      "import { expect } from 'vite-plus/test'; expect(() => {}).toThrow('');",
+    );
+    expect(planProject(root).changes).toEqual([]);
+  });
+
+  it('still migrates source APIs and blocks unsupported APIs without a config', () => {
+    const root = project({
+      'example.test.ts': "import { test } from 'vitest'; test.sequential('works', () => {});",
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toEqual([]);
+    expect(plan.changes[0].after).toContain("test('works', { concurrent: false }");
+    applyVitestV5Migration(plan);
+    expect(finishVitestV5Migration(plan)).toEqual([]);
+    expect(fs.existsSync(path.join(root, 'vite.config.ts'))).toBe(false);
+    fs.writeFileSync(
+      path.join(root, 'example.bench.ts'),
+      "import { bench } from 'vitest'; bench('work', () => 42, { time: 1 });",
+    );
+    const blocked = planProject(root);
+    expect(blocked.findings).toEqual([
+      expect.objectContaining({ code: 'benchmark-api', severity: 'block' }),
+    ]);
+    expect(() => applyVitestV5Migration(blocked)).toThrow('blocking');
+  });
+  it('does not treat stale overrides or transitive lockfile packages as active tests', () => {
+    const root = project({
+      'package.json': JSON.stringify({
+        devDependencies: { 'vite-plus': 'latest' },
+        overrides: { vitest: 'npm:@voidzero-dev/vite-plus-test@latest' },
+      }),
+      'pnpm-lock.yaml': "packages:\n  '@vitest/spy@4.1.11': {}\n",
+    });
+    expect(planProject(root).findings).toEqual([]);
+    expect(planProject(root).projects[0].active).toBe(false);
+  });
+
+  it.each([
+    "export const tools = ['vite', 'vitest', '@vitest/runner', 'vite-plus/test'];",
+    "export const tool = { name: 'vitest' };",
+    "// import { test } from 'vitest';\nexport const value = 1;",
+    "/* export * from 'vitest'; vitest run */\nexport const value = 1;",
+    'export const example = "import { test } from \'vitest\';";',
+    'export const help = `Run vitest run or vp test`;',
+    "console.log('vitest run');",
+    "const execSync = (command) => command; execSync('vitest run');",
+    "const { execSync } = require('./logger'); execSync('vitest run');",
+    'const docs = `\n/// <reference types="vitest/globals" />\n`;',
+    '/*\n/// <reference types="vitest/globals" />\n*/',
+    "function require(name) { return name; } require('vitest');",
+    "const loader = { require(name) { return name; } }; loader.require('vitest');",
+    "import { expect } from 'vitest-like';",
+    "export * from 'vite-plus/testing';",
+  ])('does not require a runner version for incidental source text: %s', (input) => {
+    const root = project({ 'package.json': '{}', 'src/plugin.ts': input });
+    const plan = planProject(root);
+    expect(plan.projects[0].active).toBe(false);
+    expect(plan.findings).toEqual([]);
+    expect(plan.changes).toEqual([]);
+  });
+
+  it.each([
+    "import { test } from 'vitest';",
+    "import 'vitest';",
+    "import type { TestAPI } from 'vitest';",
+    "export { test } from 'vite-plus/test';",
+    "export * from '@vitest/runner';",
+    "const runner = await import('vitest/node');",
+    "const runner = require('vitest');",
+    "import runner = require('vitest');",
+    "type Runner = import('vitest/node').Vitest;",
+    "declare module 'vitest' { interface ProvidedContext { port: number } }",
+    '/// <reference types="vitest/globals" />',
+    "import { execSync as run } from 'node:child_process'; run('pnpm exec vitest run');",
+    "import * as cp from 'child_process'; cp.spawn('vitest', ['run']);",
+    "import cp from 'node:child_process'; cp.execSync('vp test');",
+    "import { spawnSync } from 'node:child_process'; spawnSync('pnpm', ['exec', 'vitest', 'run']);",
+    "import { execFileSync } from 'child_process'; execFileSync('vp', ['test']);",
+    "const { execSync: run } = require('node:child_process'); run('vitest run');",
+    "const cp = require('child_process'); cp.spawn('vitest', ['run']);",
+    "require('node:child_process').execSync('vp test');",
+  ])('still requires a runner version for actual source usage: %s', (input) => {
+    const root = project({ 'package.json': '{}', 'runner.ts': input });
+    const plan = planProject(root);
+    expect(plan.projects[0].active).toBe(true);
+    expect(plan.findings).toContainEqual(
+      expect.objectContaining({ code: 'source-version', severity: 'block' }),
+    );
+    expect(plan.changes).toEqual([]);
+  });
+
+  it('keeps the version check when source usage cannot be parsed', () => {
+    const root = project({
+      'package.json': '{}',
+      'runner.ts': "import { test } from 'vitest'; const broken = ;",
+    });
+    const plan = planProject(root);
+    expect(plan.projects[0].active).toBe(true);
+    expect(plan.findings).toContainEqual(
+      expect.objectContaining({ code: 'source-version', severity: 'block' }),
+    );
+  });
+
+  it('migrates Vitest workspace members without activating their plugin package', () => {
+    const plugin = "export const NON_RUNTIME_PKGS = ['vite', 'vitest'];";
+    const root = project({
+      'package.json': JSON.stringify({
+        name: 'plugin',
+        scripts: { test: 'node test-examples.js' },
+      }),
+      'src/index.ts': plugin,
+      'examples/vite-8/package.json': JSON.stringify({ devDependencies: { vitest: '^4.1.11' } }),
+      'examples/vite-8/vitest.config.ts': 'export default { test: { globals: true } };',
+      'examples/vite-8/unit.test.js': "test.sequential('works', () => {});",
+    });
+    const workspace = {
+      rootDir: root,
+      packageManager: PackageManager.pnpm,
+      packages: [{ name: 'example', path: 'examples/vite-8' }],
+    };
+    const plan = planVitestV5Migration(workspace);
+    expect(plan.projects.map(({ active, sourceVersion }) => ({ active, sourceVersion }))).toEqual([
+      { active: false, sourceVersion: undefined },
+      { active: true, sourceVersion: '4.1.11' },
+    ]);
+    expect(plan.findings).toEqual([]);
+    applyVitestV5Migration(plan);
+    expect(finishVitestV5Migration(plan)).toEqual([]);
+    expect(fs.readFileSync(path.join(root, 'src/index.ts'), 'utf8')).toBe(plugin);
+    expect(fs.readFileSync(path.join(root, 'examples/vite-8/unit.test.js'), 'utf8')).toContain(
+      "test('works', { concurrent: false }",
+    );
+    const repeated = planVitestV5Migration(workspace);
+    expect(repeated.projects[0].active).toBe(false);
+    expect(repeated.findings).toEqual([]);
+    expect(repeated.changes).toEqual([]);
+    expect(fs.existsSync(path.join(root, '.vite-plus/migrations.json'))).toBe(false);
+  });
+
+  it.each([
+    ['vitest', '4.1.11', '4.1.11', {}],
+    [
+      'vitest',
+      'npm:@voidzero-dev/vite-plus-test@latest',
+      '@voidzero-dev/vite-plus-test@0.1.14',
+      {},
+    ],
+    [
+      'vite-plus',
+      '^0.1.11',
+      '0.1.14(peer@1.0.0)',
+      {
+        'vite-plus@0.1.14(peer@1.0.0)': {
+          dependencies: { '@voidzero-dev/vite-plus-test': '0.1.14' },
+        },
+      },
+    ],
+    [
+      'vite-plus',
+      '^0.2.0',
+      '0.2.0',
+      {
+        'vite-plus@0.2.0': { dependencies: { vitest: '4.1.11' } },
+      },
+    ],
+  ])(
+    'reads the original %s runner through pnpm lockfile edges (%s)',
+    (name, spec, version, snapshots) => {
+      const root = project({
+        'package.json': JSON.stringify({
+          scripts: { test: 'vp test' },
+          devDependencies: { [name]: spec },
+        }),
+        // JSON is YAML: retain exact peer-suffixed snapshot keys in this fixture.
+        'pnpm-lock.yaml': JSON.stringify({
+          lockfileVersion: '9.0',
+          importers: { '.': { devDependencies: { [name]: { specifier: spec, version } } } },
+          packages: {
+            '@voidzero-dev/vite-plus-test@0.1.14': { peerDependencies: { '@vitest/ui': '4.1.11' } },
+            'vitest@5.0.0': {},
+          },
+          snapshots: { 'vitest@5.0.0': {}, ...snapshots },
+        }),
+      });
+      expect(planProject(root).projects[0].sourceVersion).toBe('4.1.11');
+      expect(planProject(root).findings.some(({ severity }) => severity === 'block')).toBe(false);
+    },
+  );
+
+  it('does not infer a source runner from stale or unrelated lockfile entries', () => {
+    const root = project({
+      'package.json': JSON.stringify({
+        scripts: { test: 'vp test' },
+        devDependencies: { 'vite-plus': '^0.2.0' },
+      }),
+      'pnpm-lock.yaml': JSON.stringify({
+        importers: {
+          '.': { devDependencies: { 'vite-plus': { specifier: '^0.1.0', version: '0.1.0' } } },
+        },
+        snapshots: {
+          'vite-plus@0.1.0': { dependencies: { vitest: '4.1.11' } },
+          'vitest@5.0.0': {},
+        },
+      }),
+    });
+    expect(planProject(root).projects[0].sourceVersion).toBeUndefined();
+    expect(planProject(root).findings).toContainEqual(
+      expect.objectContaining({ code: 'source-version', severity: 'block' }),
+    );
+  });
+
+  it.each(['^4.1.0 || ^5.0.0', '>=4', '*', '4 || 5.0.0-beta.1'])(
+    'requires installed or locked evidence for the ambiguous runner range %s',
+    (range) => {
+      const root = project({
+        'package.json': JSON.stringify({ devDependencies: { vitest: range } }),
+        'vite.config.ts': 'export default { test: {} };',
+      });
+      const plan = planProject(root);
+      expect(plan.projects[0].sourceVersion).toBeUndefined();
+      expect(plan.projects[0].options.preserveV4).toBe(false);
+      expect(plan.changes).toEqual([]);
+      expect(plan.findings).toContainEqual(
+        expect.objectContaining({ code: 'source-version', severity: 'block' }),
+      );
+    },
+  );
+
+  it.each(['4.1.11', '5.0.0'])(
+    'uses installed runner %s to disambiguate a cross-major range',
+    (version) => {
+      const root = project({
+        'package.json': JSON.stringify({ devDependencies: { vitest: '^4.1.0 || ^5.0.0' } }),
+        'node_modules/vitest/package.json': JSON.stringify({ name: 'vitest', version }),
+      });
+      const plan = planProject(root);
+      expect(plan.projects[0].sourceVersion).toBe(version);
+      expect(plan.projects[0].options.preserveV4).toBe(version.startsWith('4.'));
+      expect(plan.findings.some(({ severity }) => severity === 'block')).toBe(false);
+    },
+  );
+
+  it('uses the installed bundled runner before an ambiguous Vite+ dependency range', () => {
+    const root = project({
+      'package.json': JSON.stringify({
+        devDependencies: { 'vite-plus': '0.2.0' },
+        scripts: { test: 'vp test' },
+      }),
+      'node_modules/vite-plus/package.json': JSON.stringify({
+        name: 'vite-plus',
+        version: '0.2.0',
+        dependencies: { vitest: '^4.1.0 || ^5.0.0' },
+      }),
+      'node_modules/vite-plus/node_modules/vitest/package.json': JSON.stringify({
+        name: 'vitest',
+        version: '5.0.0',
+      }),
+    });
+    const plan = planProject(root);
+    expect(plan.projects[0].sourceVersion).toBe('5.0.0');
+    expect(plan.projects[0].options.preserveV4).toBe(false);
+    expect(plan.findings.some(({ severity }) => severity === 'block')).toBe(false);
+  });
+
+  it.each(
+    ['installed', 'locked'].flatMap((evidence) =>
+      ['0.1.24', '3.2.4', '5.0.0'].map((version) => [evidence, version]),
+    ),
+  )(
+    'ignores %s metadata for a legacy runner alias with an unrelated %s version',
+    (evidence, version) => {
+      const root = project({
+        'package.json': JSON.stringify({ devDependencies: { vitest: 'catalog:' } }),
+        'pnpm-workspace.yaml': JSON.stringify({
+          catalog: { vitest: 'npm:@voidzero-dev/vite-plus-test@0.1.24' },
+        }),
+        'vite.config.ts': 'export default { test: {} };',
+        ...(evidence === 'installed'
+          ? {
+              'node_modules/vitest/package.json': JSON.stringify({ name: 'vitest', version }),
+            }
+          : {
+              'pnpm-lock.yaml': JSON.stringify({
+                importers: {
+                  '.': { devDependencies: { vitest: { specifier: 'catalog:', version } } },
+                },
+              }),
+            }),
+      });
+      const plan = planProject(root);
+      expect(plan.projects[0].sourceVersion).toBe('4.0.0');
+      expect(plan.projects[0].options.preserveV4).toBe(true);
+      expect(plan.findings.some(({ severity }) => severity === 'block')).toBe(false);
+      expect(plan.changes.find(({ file }) => file.endsWith('vite.config.ts'))?.after).toContain(
+        'clearMocks: false',
+      );
+    },
+  );
+
+  it('reads the upstream version from an installed legacy alias UI peer', () => {
+    const root = project({
+      'package.json': JSON.stringify({
+        devDependencies: { vitest: 'npm:@voidzero-dev/vite-plus-test@0.1.24' },
+      }),
+      'node_modules/vitest/package.json': JSON.stringify({
+        name: '@voidzero-dev/vite-plus-test',
+        version: '0.1.24',
+        peerDependencies: { '@vitest/ui': '4.1.11' },
+      }),
+    });
+    expect(planProject(root).projects[0].sourceVersion).toBe('4.1.11');
+  });
+
+  it('reads the upstream version from an installed legacy wrapper UI peer', () => {
+    const root = project({
+      'package.json': JSON.stringify({
+        devDependencies: { 'vite-plus': '0.1.14' },
+        scripts: { test: 'vp test' },
+      }),
+      'node_modules/vite-plus/package.json': JSON.stringify({
+        name: 'vite-plus',
+        version: '0.1.14',
+        dependencies: { '@voidzero-dev/vite-plus-test': '0.1.14' },
+      }),
+      'node_modules/@voidzero-dev/vite-plus-test/package.json': JSON.stringify({
+        name: '@voidzero-dev/vite-plus-test',
+        version: '0.1.14',
+        peerDependencies: { '@vitest/ui': '4.1.11' },
+      }),
+    });
+    expect(planProject(root).projects[0].sourceVersion).toBe('4.1.11');
+  });
+  it('uses an installed Vite+ runner version before an unrelated hoisted runner', () => {
+    const root = project({
+      'package.json': JSON.stringify({ devDependencies: { 'vite-plus': '0.2.0' } }),
+      'node_modules/vite-plus/package.json': JSON.stringify({
+        name: 'vite-plus',
+        version: '0.2.0',
+        dependencies: { vitest: '4.1.11' },
+      }),
+      'node_modules/vitest/package.json': JSON.stringify({ name: 'vitest', version: '5.0.0' }),
+    });
+    expect(planProject(root).projects[0].sourceVersion).toBe('4.1.11');
+  });
+
+  it('does not treat a retained v4 peer range as the installed Vite+ runner', () => {
+    const root = project({
+      'package.json': JSON.stringify({
+        devDependencies: { 'vite-plus': '0.3.2' },
+        peerDependencies: { vitest: '^4.0.0' },
+        scripts: { test: 'vp test' },
+      }),
+      'node_modules/vite-plus/package.json': JSON.stringify({
+        name: 'vite-plus',
+        version: '0.3.2',
+        dependencies: { vitest: '5.0.1' },
+      }),
+      'node_modules/vitest/package.json': JSON.stringify({ name: 'vitest', version: '4.1.11' }),
+      'vite.config.ts': 'export default { test: {} };',
+      'unit.test.js': "import { expect } from 'vite-plus/test'; expect(() => {}).toThrow('');",
+    });
+    const plan = planProject(root);
+    expect(plan.projects[0].sourceVersion).toBe('5.0.1');
+    expect(plan.findings).toEqual([]);
+    expect(plan.changes).toEqual([]);
+    expect(vitestV5NeedsMigration(plan)).toBe(false);
+  });
+  it('is read-only and blocks the entire plan before applying any safe edit', () => {
+    const root = project({
+      '.node-version': '20.19.0\n',
+      'vite.config.ts': 'export default { test: {} };',
+      'old.test.ts': "import { startTests } from '@vitest/runner'; startTests([]);",
+    });
+    const plan = planProject(root);
+    expect(
+      plan.findings
+        .filter((finding) => finding.severity === 'block')
+        .map((finding) => finding.code),
+    ).toEqual(['removed-api']);
+    expect(plan.changes.length).toBeGreaterThan(0);
+    expect(() => applyVitestV5Migration(plan)).toThrow('blocking');
+    expect(() => applyVitestV5NodeMigration(plan)).toThrow('blocking');
+    expect(fs.readFileSync(path.join(root, '.node-version'), 'utf8')).toBe('20.19.0\n');
+    expect(fs.readFileSync(path.join(root, 'vite.config.ts'), 'utf8')).toBe(
+      'export default { test: {} };',
+    );
+    expect(fs.existsSync(path.join(root, '.vite-plus'))).toBe(false);
+  });
+
+  it('upgrades nvmrc and package runtimes without changing public engines', () => {
+    const root = project({
+      '.nvmrc': '25',
+      'package.json': JSON.stringify({
+        devDependencies: { vitest: '4.1.11' },
+        engines: { node: '>=18' },
+        devEngines: { runtime: { name: 'node', version: '22.12.0' } },
+      }),
+    });
+    const plan = planProject(root);
+    const findings = plan.findings.filter((finding) => finding.code === 'node-runtime');
+    expect(findings).toHaveLength(1);
+    expect(findings).toContainEqual(
+      expect.objectContaining({
+        severity: 'review',
+        message: expect.stringContaining('public engine contract'),
+      }),
+    );
+    applyVitestV5Migration(plan);
+    expect(fs.readFileSync(path.join(root, '.nvmrc'), 'utf8')).toBe('26.0.0');
+    expect(JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8'))).toMatchObject({
+      engines: { node: '>=18' },
+      devEngines: { runtime: { name: 'node', version: '22.18.0' } },
+    });
+  });
+
+  it.each([
+    ['20.19.0\n', '22.18.0\n'],
+    ['22.12.0', '22.18.0'],
+    ['24.10.0', '24.11.0'],
+    ['25', '26.0.0'],
+    ['  v20.19.0\r\n', '  v22.18.0\r\n'],
+    ['22.19.0', '22.19.0'],
+    ['24.11.0', '24.11.0'],
+    ['26.1.0', '26.1.0'],
+  ])('migrates the runtime pin %j to %j', (before, after) => {
+    const root = project({
+      '.node-version': before,
+      'vite.config.ts': 'export default { test: {} };',
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toEqual([]);
+    applyVitestV5Migration(plan);
+    expect(fs.readFileSync(path.join(root, '.node-version'), 'utf8')).toBe(after);
+    expect(planProject(root).changes).toEqual([]);
+  });
+
+  it('upgrades runtime pins before install without applying source or script edits', () => {
+    const manifest =
+      '\uFEFF{\r\n  "devDependencies": { "vitest": "4.1.11" },\r\n  "devEngines": { "runtime": { "name": "node", "version": "20.19.0" } },\r\n  "scripts": { "list": "vitest list" }\r\n}\r\n';
+    const original = 'export default { test: {} };';
+    const root = project({
+      'package.json': manifest,
+      'vite.config.ts': original,
+      '.node-version': '20.19.0\n',
+    });
+    const plan = planProject(root);
+    expect(applyVitestV5NodeMigration(plan)).toBe(2);
+    expect(fs.readFileSync(path.join(root, 'vite.config.ts'), 'utf8')).toBe(original);
+    expect(fs.readFileSync(path.join(root, 'package.json'), 'utf8')).toBe(
+      manifest.replace('20.19.0', '22.18.0'),
+    );
+    const refreshed = refreshVitestV5Migration(plan);
+    applyVitestV5Migration(refreshed);
+    expect(fs.readFileSync(path.join(root, 'package.json'), 'utf8')).toBe(
+      manifest
+        .replace('20.19.0', '22.18.0')
+        .replace('vitest list', 'vitest list --no-static-parse'),
+    );
+    expect(fs.readFileSync(path.join(root, 'vite.config.ts'), 'utf8')).toContain(
+      'clearMocks: false',
+    );
+  });
+
+  it('refuses stale runtime declarations before any early upgrade', () => {
+    const root = project({ '.node-version': '20.19.0' });
+    const plan = planProject(root);
+    fs.writeFileSync(path.join(root, '.node-version'), '24.11.0');
+    expect(() => applyVitestV5NodeMigration(plan)).toThrow('Migration input changed');
+    expect(fs.readFileSync(path.join(root, '.node-version'), 'utf8')).toBe('24.11.0');
+  });
+
+  it('ignores Node declarations outside the supported project files', () => {
+    const root = project({
+      'vite.config.ts': 'export default { test: {} };',
+      '.github/workflows/test.yml':
+        'jobs:\n  test:\n    strategy:\n      matrix:\n        node: [20, 25]\n    steps:\n      - uses: actions/setup-node@v6\n        with:\n          node-version: ${{ matrix.node }}\n',
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toEqual([]);
+    expect(plan.changes.some(({ file }) => file.endsWith('test.yml'))).toBe(false);
+    applyVitestV5Migration(plan);
+    expect(finishVitestV5Migration(plan)).toEqual([]);
+  });
+
+  it.each([
+    ['.nvmrc', 'node'],
+    ['.nvmrc', 'stable'],
+    ['.nvmrc', 'lts/*'],
+    ['.node-version', 'lts/*'],
+    ['.node-version', 'latest'],
+    ['.node-version', 'current'],
+    [
+      'package.json',
+      JSON.stringify({ devEngines: { runtime: { name: 'node', version: 'latest' } } }),
+    ],
+    ['package.json', JSON.stringify({ volta: { node: 'lts' } })],
+  ])('accepts a moving runtime alias in %s: %s', (file, content) => {
+    expect(
+      planProject(project({ [file]: content })).findings.filter(
+        ({ code }) => code === 'node-runtime',
+      ),
+    ).toEqual([]);
+  });
+
+  it.each(['lts/iron', 'lts/-2', '${{ matrix.node }}', 'custom-node', '*'])(
+    'keeps the runtime review for unresolved or broad selector %s',
+    (alias) => {
+      const findings = planProject(project({ '.node-version': alias })).findings.filter(
+        ({ code }) => code === 'node-runtime',
+      );
+      expect(findings).toEqual([expect.objectContaining({ severity: 'review' })]);
+    },
+  );
+
+  it.each([
+    {
+      runtime: { name: 'node', version: '20.19.0' },
+      expected: { name: 'node', version: '22.18.0' },
+    },
+    {
+      runtime: [
+        { name: 'bun', version: '1.3.0' },
+        { name: 'node', version: '25.9.0' },
+      ],
+      expected: [
+        { name: 'bun', version: '1.3.0' },
+        { name: 'node', version: '26.0.0' },
+      ],
+    },
+  ])('upgrades Node versions in package.json devEngines.runtime: %j', ({ runtime, expected }) => {
+    const root = project({ 'package.json': JSON.stringify({ devEngines: { runtime } }) });
+    const plan = planProject(root);
+    expect(plan.findings).toEqual([]);
+    applyVitestV5Migration(plan);
+    expect(
+      JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8')).devEngines.runtime,
+    ).toEqual(expected);
+    expect(planProject(root).changes).toEqual([]);
+  });
+
+  it.each([
+    '>= 22.19.0',
+    '>=22.18.0',
+    '>=24.11.0',
+    '>=26.0.0',
+    '^22.19.0 || >=24.11.0',
+    '22',
+    '22.x',
+    '^22',
+    '24',
+    '24.x',
+    '24.*',
+    '~24',
+    '^24.0.0',
+    '>=24',
+    '22.x || 24.x',
+    '24.x || >=26',
+  ])('accepts public engines.node %s with a supported minimum or whole major', (node) => {
+    const manifest = JSON.stringify({
+      devDependencies: { vitest: '4.1.11' },
+      engines: { node },
+    });
+    const root = project({
+      'package.json': manifest,
+      'vite.config.ts': 'export default { test: {} };',
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toEqual([]);
+    applyVitestV5Migration(plan);
+    expect(finishVitestV5Migration(plan)).toEqual([]);
+    expect(fs.readFileSync(path.join(root, 'package.json'), 'utf8')).toBe(manifest);
+    expect(planProject(root).findings).toEqual([]);
+  });
+
+  it.each([
+    'lts/*',
+    'latest',
+    '*',
+    '>=18',
+    '>=22.17.0',
+    '>=24.10.0',
+    '>=25',
+    '20 || >=22.19',
+    '20.x',
+    '23.x',
+    '25.x',
+    '24.0.x',
+    '24.3.0',
+    '^24.10.0',
+  ])('reviews public engines.node %s without a supported minimum', (node) => {
+    const root = project({ 'package.json': JSON.stringify({ engines: { node } }) });
+    expect(planProject(root).findings.filter(({ code }) => code === 'node-runtime')).toEqual([
+      expect.objectContaining({ severity: 'review' }),
+    ]);
+  });
+
+  it('keeps a library public engine contract separate from its test runtime pin', () => {
+    const root = project({
+      'package.json': JSON.stringify({
+        devDependencies: { vitest: '4.1.11' },
+        engines: { node: '>=22.19.0' },
+      }),
+      '.node-version': '25.9.0',
+    });
+    const plan = planProject(root);
+    expect(plan.findings.filter(({ code }) => code === 'node-runtime')).toEqual([]);
+    applyVitestV5Migration(plan);
+    expect(fs.readFileSync(path.join(root, '.node-version'), 'utf8')).toBe('26.0.0');
+    expect(JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8')).engines.node).toBe(
+      '>=22.19.0',
+    );
+  });
+
+  it('upgrades Volta before its pin is migrated, but respects a higher-priority pin file', () => {
+    const root = project({
+      'package.json': JSON.stringify({
+        devDependencies: { vitest: '4.1.11' },
+        volta: { node: '20.19.0' },
+      }),
+    });
+    const plan = planProject(root);
+    expect(plan.findings.filter(({ code }) => code === 'node-runtime')).toEqual([]);
+    expect(plan.changes.find(({ file }) => file.endsWith('package.json'))?.after).toContain(
+      '22.18.0',
+    );
+    fs.writeFileSync(path.join(root, '.nvmrc'), '24.11.0');
+    expect(planProject(root).changes).toEqual([]);
+  });
+
+  it.each(['vitest run', 'vitest run --browser'])(
+    'keeps configless %s projects without a review',
+    (command) => {
+      const root = project({
+        'package.json': JSON.stringify({
+          devDependencies: { vitest: '4.1.11' },
+          scripts: { test: command },
+        }),
+        '.gitignore': '.vitest-reports/\n__screenshots__/\n',
+      });
+      const plan = planProject(root);
+      expect(plan.findings).toEqual([]);
+      expect(plan.projects[0].configFiles.size).toBe(0);
+      expect(plan.changes).toEqual([]);
+      applyVitestV5Migration(plan);
+      expect(vitestV5NeedsMigration(plan)).toBe(true);
+      expect(finishVitestV5Migration(plan)).toEqual([]);
+      expect(fs.existsSync(path.join(root, 'vite.config.ts'))).toBe(false);
+      expect(fs.readFileSync(path.join(root, '.gitignore'), 'utf8')).toBe(
+        '.vitest-reports/\n__screenshots__/\n.vitest/\n',
+      );
+      expect(fs.existsSync(path.join(root, '.vite-plus'))).toBe(false);
+      fs.writeFileSync(
+        path.join(root, 'package.json'),
+        JSON.stringify({ devDependencies: { vitest: '5.0.1' } }),
+      );
+      const repeated = planProject(root);
+      expect(repeated.findings).toEqual([]);
+      expect(vitestV5NeedsMigration(repeated)).toBe(false);
+      expect(repeated.projects[0].configFiles.size).toBe(0);
+      expect(fs.existsSync(path.join(root, 'vite.config.ts'))).toBe(false);
+    },
+  );
+
+  it.each(['.vitest/\n', '**/.vitest/\n', '/packages/*/.vitest/\n'])(
+    'reuses the workspace ignore rule %j without changing package ignore files',
+    (ignore) => {
+      const root = project({
+        'package.json': '{}',
+        '.gitignore': ignore,
+        'packages/a/package.json': JSON.stringify({ devDependencies: { vitest: '4.1.11' } }),
+        'packages/b/package.json': JSON.stringify({ devDependencies: { vitest: '4.1.11' } }),
+        'packages/b/.gitignore': 'dist/\n',
+      });
+      const plan = planVitestV5Migration({
+        rootDir: root,
+        packageManager: PackageManager.pnpm,
+        packages: ['a', 'b'].map((name) => ({ name, path: `packages/${name}` })),
+      });
+      applyVitestV5Migration(plan);
+      for (let run = 0; run < 2; run++) {
+        expect(finishVitestV5Migration(plan)).toEqual([]);
+        expect(fs.readFileSync(path.join(root, '.gitignore'), 'utf8')).toBe(ignore);
+        expect(fs.existsSync(path.join(root, 'packages/a/.gitignore'))).toBe(false);
+        expect(fs.readFileSync(path.join(root, 'packages/b/.gitignore'), 'utf8')).toBe('dist/\n');
+      }
+    },
+  );
+
+  it('reuses an ignore rule added to the root during the same migration', () => {
+    const root = project({
+      'packages/unit/package.json': JSON.stringify({ devDependencies: { vitest: '4.1.11' } }),
+    });
+    const plan = planVitestV5Migration({
+      rootDir: root,
+      packageManager: PackageManager.pnpm,
+      packages: [{ name: 'unit', path: 'packages/unit' }],
+    });
+    applyVitestV5Migration(plan);
+    expect(finishVitestV5Migration(plan)).toEqual([]);
+    expect(fs.readFileSync(path.join(root, '.gitignore'), 'utf8')).toBe('.vitest/\n');
+    expect(fs.existsSync(path.join(root, 'packages/unit/.gitignore'))).toBe(false);
+  });
+
+  it.each(['/.vitest/\n', '.vitest/\n!packages/unit/.vitest/\n'])(
+    'adds a package ignore when the root rule %j does not cover it',
+    (ignore) => {
+      const root = project({
+        'package.json': '{}',
+        '.gitignore': ignore,
+        'packages/unit/package.json': JSON.stringify({ devDependencies: { vitest: '4.1.11' } }),
+        'packages/unit/.gitignore': 'dist/',
+      });
+      const plan = planVitestV5Migration({
+        rootDir: root,
+        packageManager: PackageManager.pnpm,
+        packages: [{ name: 'unit', path: 'packages/unit' }],
+      });
+      applyVitestV5Migration(plan);
+      expect(finishVitestV5Migration(plan)).toEqual([]);
+      expect(fs.readFileSync(path.join(root, '.gitignore'), 'utf8')).toBe(ignore);
+      expect(fs.readFileSync(path.join(root, 'packages/unit/.gitignore'), 'utf8')).toBe(
+        'dist/\n.vitest/\n',
+      );
+    },
+  );
+
+  it.each([false, true])('respects repository boundaries (nested repository: %s)', (nested) => {
+    const root = project({
+      'package.json': '{}',
+      '.git': 'gitdir: external',
+      '.gitignore': '.vitest/\n',
+      'packages/unit/package.json': JSON.stringify({ devDependencies: { vitest: '4.1.11' } }),
+      ...(nested ? { 'packages/unit/.git': 'gitdir: nested' } : {}),
+    });
+    const directory = path.join(root, 'packages/unit');
+    const plan = planProject(directory);
+    applyVitestV5Migration(plan);
+    expect(finishVitestV5Migration(plan)).toEqual([]);
+    expect(fs.existsSync(path.join(directory, '.gitignore'))).toBe(nested);
+    if (nested) {
+      expect(fs.readFileSync(path.join(directory, '.gitignore'), 'utf8')).toBe('.vitest/\n');
+    }
+  });
+
+  it('preserves defaults in a config created by another migration step', () => {
+    const root = project();
+    const plan = planProject(root);
+    applyVitestV5Migration(plan);
+    fs.writeFileSync(
+      path.join(root, 'vite.config.ts'),
+      "import { defineConfig } from 'vite-plus'; export default defineConfig({});",
+    );
+    finishVitestV5Migration(plan);
+    expect(fs.readFileSync(path.join(root, 'vite.config.ts'), 'utf8')).toContain(
+      'clearMocks: false',
+    );
+  });
+
+  it('does not reapply compatibility defaults after the user adopts v5 defaults', () => {
+    const root = project({ 'vite.config.ts': 'export default { test: {} };' });
+    const plan = planProject(root);
+    applyVitestV5Migration(plan);
+    finishVitestV5Migration(plan);
+    fs.writeFileSync(path.join(root, 'vite.config.ts'), 'export default { test: {} };');
+    fs.writeFileSync(
+      path.join(root, 'package.json'),
+      JSON.stringify({ devDependencies: { vitest: '5.0.0' } }),
+    );
+    const next = planProject(root);
+    expect(next.projects[0].options.preserveV4).toBe(false);
+    expect(vitestV5NeedsMigration(next)).toBe(false);
+    applyVitestV5Migration(next);
+    finishVitestV5Migration(next);
+    expect(fs.readFileSync(path.join(root, 'vite.config.ts'), 'utf8')).toBe(
+      'export default { test: {} };',
+    );
+    expect(fs.existsSync(path.join(root, '.vite-plus'))).toBe(false);
+  });
+
+  it.each([
+    'not valid JSON',
+    JSON.stringify({ version: 1, vitest5: { '.': { sourceVersion: '4.1.11', configless: true } } }),
+    JSON.stringify({ version: 99 }),
+  ])('ignores a legacy migration file without changing it: %s', (legacy) => {
+    const root = project({
+      'package.json': JSON.stringify({ devDependencies: { vitest: '5.0.1' } }),
+      'vite.config.ts': 'export default { test: {} };',
+      '.vite-plus/migrations.json': legacy,
+    });
+    const plan = planProject(root);
+    expect(plan.projects[0].sourceVersion).toBe('5.0.1');
+    expect(plan.findings).toEqual([]);
+    expect(plan.changes).toEqual([]);
+    expect(vitestV5NeedsMigration(plan)).toBe(false);
+    expect(plan.inputs.has(path.join(root, '.vite-plus/migrations.json'))).toBe(false);
+    applyVitestV5Migration(plan);
+    expect(finishVitestV5Migration(plan)).toEqual([]);
+    expect(fs.readFileSync(path.join(root, '.vite-plus/migrations.json'), 'utf8')).toBe(legacy);
+  });
+
+  it('does not let a legacy completion record skip a resolved v4 migration', () => {
+    const root = project({
+      'vite.config.ts': 'export default { test: {} };',
+      '.vite-plus/migrations.json': JSON.stringify({
+        version: 1,
+        vitest5: { '.': { sourceVersion: '5.0.1', configless: false } },
+      }),
+    });
+    const plan = planProject(root);
+    expect(plan.projects[0].options.preserveV4).toBe(true);
+    expect(plan.changes[0].after).toContain('clearMocks: false');
+    expect(vitestV5NeedsMigration(plan)).toBe(true);
+  });
+
+  it('still blocks unresolved runner versions instead of trusting a legacy record', () => {
+    const root = project({
+      'package.json': '{}',
+      'unit.test.ts': "import { test } from 'vite-plus/test'; test('works', () => {});",
+      '.vite-plus/migrations.json': JSON.stringify({
+        version: 1,
+        vitest5: { '.': { sourceVersion: '4.1.11', configless: false } },
+      }),
+    });
+    expect(planProject(root).findings).toContainEqual(
+      expect.objectContaining({ code: 'source-version', severity: 'block' }),
+    );
+  });
+
+  it('resolves v4 catalogs and leaves already-v5 projects on new defaults', () => {
+    const root = project({
+      'package.json': JSON.stringify({ devDependencies: { vitest: 'catalog:testing' } }),
+      'pnpm-workspace.yaml': 'catalogs:\n  testing:\n    vitest: ^4.1.11\n',
+      'vite.config.ts': 'export default { test: {} };',
+    });
+    expect(planProject(root).projects[0].sourceVersion).toBe('4.1.11');
+    const v5root = project({
+      'package.json': JSON.stringify({ devDependencies: { vitest: '5.0.0' } }),
+      'vite.config.ts': 'export default { test: {} };',
+    });
+    expect(planProject(v5root).changes).toEqual([]);
+  });
+
+  it('retains unresolved findings on later scans and groups them by file', () => {
+    const root = project({
+      'mock.test.ts': "import { test, vi } from 'vitest'; test('mock', () => vi.mock('./a'));",
+    });
+    const plan = planProject(root);
+    applyVitestV5Migration(plan);
+    const after = finishVitestV5Migration(plan);
+    expect(after.some((finding) => finding.code === 'nested-hoisted-mock')).toBe(true);
+    fs.writeFileSync(
+      path.join(root, 'package.json'),
+      JSON.stringify({ devDependencies: { vitest: '5.0.1' } }),
+    );
+    expect(
+      planProject(root).findings.some((finding) => finding.code === 'nested-hoisted-mock'),
+    ).toBe(true);
+    const report = formatVitestV5Findings(plan);
+    expect(report).toContain('Vitest v5:');
+    expect(report).toContain('mock.test.ts\n  1:');
+  });
+
+  it('retains deferred reviews in the final report without storing them for later v5 runs', () => {
+    const input = `import { resolveConfig } from 'vitest/node';
+const pair = await resolveConfig();
+export const config = pair.viteConfig;`;
+    const root = project({ 'runner.ts': input });
+    const plan = planProject(root);
+    expect(plan.findings).toContainEqual(expect.objectContaining({ code: 'resolve-config' }));
+    applyVitestV5Migration(plan);
+    fs.writeFileSync(
+      path.join(root, 'package.json'),
+      JSON.stringify({ devDependencies: { vitest: '5.0.1' } }),
+    );
+    expect(finishVitestV5Migration(plan)).toContainEqual(
+      expect.objectContaining({ code: 'resolve-config' }),
+    );
+    const repeated = planProject(root);
+    expect(repeated.findings.some(({ code }) => code === 'resolve-config')).toBe(false);
+    expect(repeated.changes).toEqual([]);
+    expect(fs.readFileSync(path.join(root, 'runner.ts'), 'utf8')).toBe(input);
+    expect(fs.existsSync(path.join(root, '.vite-plus/migrations.json'))).toBe(false);
+    fs.writeFileSync(path.join(root, 'runner.ts'), 'export const config = {};');
+    expect(planProject(root).findings.some(({ code }) => code === 'resolve-config')).toBe(false);
+  });
+
+  it('does not retain a resolveConfig warning for a successful automatic rewrite', () => {
+    const root = project({
+      'runner.ts': `import { resolveConfig } from 'vitest/node';\nconst { viteConfig } = await resolveConfig();`,
+    });
+    const plan = planProject(root);
+    applyVitestV5Migration(plan);
+    expect(finishVitestV5Migration(plan).some(({ code }) => code === 'resolve-config')).toBe(false);
+    fs.writeFileSync(
+      path.join(root, 'package.json'),
+      JSON.stringify({ devDependencies: { vitest: '5.0.1' } }),
+    );
+    expect(planProject(root).findings.some(({ code }) => code === 'resolve-config')).toBe(false);
+  });
+
+  it('resolves each workspace package independently on a rerun without state', () => {
+    const root = project({
+      'packages/a/package.json': JSON.stringify({ devDependencies: { vitest: '4.1.11' } }),
+      'packages/a/vite.config.ts': 'export default { test: {} };',
+    });
+    const workspace = {
+      rootDir: root,
+      packageManager: PackageManager.pnpm,
+      packages: [{ name: 'a', path: 'packages/a' }],
+    };
+    const plan = planVitestV5Migration(workspace);
+    applyVitestV5Migration(plan);
+    finishVitestV5Migration(plan);
+    fs.writeFileSync(
+      path.join(root, 'package.json'),
+      JSON.stringify({ devDependencies: { vitest: '5.0.1' } }),
+    );
+    const repeated = planVitestV5Migration(workspace);
+    expect(repeated.projects.map(({ options }) => options.preserveV4)).toEqual([false, true]);
+    fs.writeFileSync(
+      path.join(root, 'packages/a/package.json'),
+      JSON.stringify({ devDependencies: { vitest: '5.0.1' } }),
+    );
+    const upgraded = planVitestV5Migration(workspace);
+    expect(upgraded.projects.map(({ options }) => options.preserveV4)).toEqual([false, false]);
+    expect(vitestV5NeedsMigration(upgraded)).toBe(false);
+    expect(fs.existsSync(path.join(root, '.vite-plus/migrations.json'))).toBe(false);
+  });
+
+  it('refuses to overwrite files changed since preflight', () => {
+    const root = project({ 'vite.config.ts': 'export default { test: {} };' });
+    const plan = planProject(root);
+    fs.writeFileSync(path.join(root, 'vite.config.ts'), '// changed by editor\nexport default {};');
+    expect(() => applyVitestV5Migration(plan)).toThrow('Migration input changed');
+  });
+
+  it('does not follow symlinks or edit fixtures under nested package boundaries', () => {
+    const root = project({
+      'nested/package.json': '{}',
+      'nested/vite.config.ts': 'export default { test: {} };',
+      'node_modules/ignored/vite.config.ts': 'export default { test: {} };',
+    });
+    expect(planProject(root).changes).toEqual([]);
+  });
+});
diff --git a/packages/cli/src/migration/bin.ts b/packages/cli/src/migration/bin.ts
index 53f0a72c35..00b0e5113f 100644
--- a/packages/cli/src/migration/bin.ts
+++ b/packages/cli/src/migration/bin.ts
@@ -38,6 +38,8 @@ import { checkRolldownCompatibility } from './compat/runner.ts';
 import { canFormatWithOxfmt, collectChangedFormatPaths, formatMigratedProject } from './format.ts';
 import {
   addFrameworkShim,
+  applyVitestV5Migration,
+  applyVitestV5NodeMigration,
   checkVitestVersion,
   checkViteVersion,
   collectToolchainVersionChanges,
@@ -52,6 +54,8 @@ import {
   detectYarnPnpMode,
   ensureVitePlusBootstrap,
   finalizeCoreMigrationForExistingVitePlus,
+  finishVitestV5Migration,
+  formatVitestV5Findings,
   hasFrameworkShim,
   detectLegacyGitHooksMigrationCandidate,
   injectLintTypeCheckDefaults,
@@ -66,10 +70,14 @@ import {
   configureYarnNodeModulesMode,
   rewriteMonorepo,
   rewriteStandaloneProject,
+  planVitestV5Migration,
+  refreshVitestV5Migration,
   shouldSkipStagedMigrationForHooks,
   warnPackageLevelPrettier,
+  vitestV5NeedsMigration,
   type Framework,
   type NodeVersionManagerDetection,
+  type VitestV5MigrationPlan,
 } from './migrator.ts';
 import { prepareNpmViteAliasReinstall } from './npm-reinstall.ts';
 import type { MigrationOptions } from './options.ts';
@@ -687,10 +695,33 @@ async function downloadSupportedPackageManager(options: {
   return downloadResult;
 }
 
+function completeVitestV5Migration(plan: VitestV5MigrationPlan, report: MigrationReport) {
+  const findings = finishVitestV5Migration(plan);
+  report.warnings = report.warnings.filter((warning) => !warning.startsWith('Vitest v5:'));
+  const summary = formatVitestV5Findings({ rootDir: plan.rootDir, findings });
+  if (summary) {
+    addMigrationWarning(report, summary);
+  }
+}
+
+function applyRefreshedVitestV5Migration(plan: VitestV5MigrationPlan): VitestV5MigrationPlan {
+  const refreshed = refreshVitestV5Migration(plan);
+  if (refreshed.findings.some((finding) => finding.severity === 'block')) {
+    prompts.log.warn(formatVitestV5Findings(refreshed));
+    cancelAndExit(
+      'Resolve the blocking Vitest v5 findings, then re-run `vp migrate`. Earlier setup steps may have changed project files; Vitest v5 edits were not applied.',
+      1,
+    );
+  }
+  applyVitestV5Migration(refreshed);
+  return refreshed;
+}
+
 async function executeMigrationPlan(
   workspaceInfoOptional: WorkspaceInfoOptional,
   plan: MigrationPlan,
   interactive: boolean,
+  vitestV5Plan: VitestV5MigrationPlan,
   preExistingChangedPaths?: ReadonlySet<string>,
 ): Promise<{
   installDurationMs: number;
@@ -725,6 +756,9 @@ async function executeMigrationPlan(
     }
   };
 
+  // Runtime pins must be usable before package-manager or tool migration commands.
+  applyVitestV5NodeMigration(vitestV5Plan);
+
   // 1. Download package manager + version validation
   const downloadResult = await downloadSupportedPackageManager({
     rootDir: workspaceInfoOptional.rootDir,
@@ -751,7 +785,11 @@ async function executeMigrationPlan(
   // 3. Migrate node version manager file → .node-version (independent of vite version)
   if (plan.migrateNodeVersionFile && plan.nodeVersionDetection) {
     updateMigrationProgress('Migrating node version file');
-    migrateNodeVersionManagerFile(workspaceInfo.rootDir, plan.nodeVersionDetection, report);
+    // The compatibility pass may have upgraded the selected Volta pin.
+    const detection = detectNodeVersionManagerFile(workspaceInfo.rootDir);
+    if (detection) {
+      migrateNodeVersionManagerFile(workspaceInfo.rootDir, detection, report);
+    }
   }
 
   updateMigrationProgress('Updating setup-vp workflows');
@@ -833,6 +871,10 @@ async function executeMigrationPlan(
     }
   }
 
+  // Earlier setup and tool migrations can abort or change the preflight inputs.
+  // Only now apply Vitest compatibility edits, using the original runner version.
+  vitestV5Plan = applyRefreshedVitestV5Migration(vitestV5Plan);
+
   // Preserve lint-staged whenever hook setup is disabled/unsafe or existing
   // project-owned hooks remain authoritative.
   const skipStagedMigration = shouldSkipStagedMigrationForHooks(
@@ -856,6 +898,9 @@ async function executeMigrationPlan(
     );
   }
 
+  clearMigrationProgress();
+  completeVitestV5Migration(vitestV5Plan, report);
+
   // 8. Install git hooks
   if (plan.shouldSetupHooks) {
     updateMigrationProgress('Configuring git hooks');
@@ -978,6 +1023,15 @@ async function main() {
   const initialChangedPaths = await collectChangedFormatPaths(workspaceInfoOptional.rootDir);
   const preExistingChangedPaths = initialChangedPaths ? new Set(initialChangedPaths) : undefined;
   const resolvedPackageManager = workspaceInfoOptional.packageManager ?? 'unknown';
+  let vitestV5Plan = planVitestV5Migration(workspaceInfoOptional);
+  const vitestV5Preflight = formatVitestV5Findings(vitestV5Plan);
+  if (vitestV5Plan.findings.some((finding) => finding.severity === 'block')) {
+    prompts.log.warn(vitestV5Preflight);
+    cancelAndExit(
+      'Resolve the blocking Vitest v5 findings, then re-run `vp migrate`. No project files were changed.',
+      1,
+    );
+  }
 
   // Early return if already using Vite+ (only finalization/setup migrations may be needed)
   // In force-override mode (file: tgz overrides), skip this check and run full migration
@@ -995,11 +1049,15 @@ async function main() {
       workspaceInfoOptional.packageManagerVersion,
       options.interactive,
     );
-    let didMigrate = false;
+    let didMigrate = vitestV5NeedsMigration(vitestV5Plan);
+    const nodeUpgrades = applyVitestV5NodeMigration(vitestV5Plan);
     let installDurationMs = 0;
     let finalInstallOk = true;
     let canFormatMigratedProject = !process.env.VP_SKIP_INSTALL;
     const report = createMigrationReport();
+    // Report reviews at the end with updated locations. Keep them out of the
+    // report until then so review-only items do not force an up-to-date project
+    // through dependency reconciliation on every run.
     const migrationProgress = options.interactive
       ? prompts.spinner({ indicator: 'timer' })
       : undefined;
@@ -1150,6 +1208,9 @@ async function main() {
         ? hasExistingVitePlusMigrationCandidates(workspaceInfoOptional, options)
         : hasExplicitExistingVitePlusSetupRequest(options))
     ) {
+      if (vitestV5Preflight) {
+        prompts.log.warn(vitestV5Preflight);
+      }
       if (skippedSetupCandidates) {
         log(FULL_MIGRATION_HINT);
       }
@@ -1173,7 +1234,8 @@ async function main() {
         )
       : undefined;
 
-    let needsInstall = coreMigrationResult.dependencies;
+    // Runtime metadata can participate in the package manager's lockfile.
+    let needsInstall = coreMigrationResult.dependencies || nodeUpgrades > 0;
     if (vitePlusBootstrapPending) {
       const downloadResult = await ensureExistingPackageManager();
       if (downloadResult && packageManager) {
@@ -1350,6 +1412,14 @@ async function main() {
       didMigrate = true;
     }
 
+    // As in the full migration, defer Vitest writes until tool migration gates pass.
+    vitestV5Plan = applyRefreshedVitestV5Migration(vitestV5Plan);
+    // A versioned dependency migration can be needed even when the generic
+    // Vite+ bootstrap is already satisfied (for example a v4 community provider).
+    needsInstall ||= vitestV5Plan.changes.some(({ file }) =>
+      ['package.json', 'pnpm-workspace.yaml', '.yarnrc.yml'].includes(path.basename(file)),
+    );
+
     // Merge configs and reinstall once if any tool or bootstrap migration happened
     if (eslintMigrated || prettierMigrated || tsupMigrated) {
       updateMigrationProgress('Rewriting configs');
@@ -1390,6 +1460,8 @@ async function main() {
     }
 
     if (needsInstall) {
+      clearMigrationProgress();
+      completeVitestV5Migration(vitestV5Plan, report);
       const resolved = await ensureExistingPackageManager();
       updateMigrationProgress('Installing dependencies');
       const resolvedVersion = resolved?.version ?? packageManagerVersion;
@@ -1463,6 +1535,10 @@ async function main() {
     }
 
     // Check for Rolldown-incompatible config patterns (root + workspace packages)
+    if (!needsInstall) {
+      clearMigrationProgress();
+      completeVitestV5Migration(vitestV5Plan, report);
+    }
     await checkWorkspaceRolldownCompatibility(
       workspaceInfoOptional,
       report,
@@ -1523,6 +1599,7 @@ async function main() {
     workspaceInfoOptional,
     plan,
     options.interactive,
+    vitestV5Plan,
     preExistingChangedPaths,
   );
   showMigrationSummary({
diff --git a/packages/cli/src/migration/migrator.ts b/packages/cli/src/migration/migrator.ts
index d5d5f122b7..1c745797e0 100644
--- a/packages/cli/src/migration/migrator.ts
+++ b/packages/cli/src/migration/migrator.ts
@@ -5,6 +5,7 @@ export * from './migrator/tsup.ts';
 export * from './migrator/tsconfig.ts';
 export * from './migrator/framework-shim.ts';
 export * from './migrator/vitest-ecosystem.ts';
+export * from './migrator/vitest-v5.ts';
 export * from './migrator/catalog.ts';
 export * from './migrator/yarn.ts';
 export * from './migrator/source-scan.ts';
diff --git a/packages/cli/src/migration/migrator/README.md b/packages/cli/src/migration/migrator/README.md
index c7bd615944..7b7abf5855 100644
--- a/packages/cli/src/migration/migrator/README.md
+++ b/packages/cli/src/migration/migrator/README.md
@@ -26,6 +26,7 @@ Pick the file by what a function _does_, not by where it happens to be called.
 | `vite-plus-bootstrap.ts` | "Already on Vite+" detection and the bootstrap/reconcile path: `detectVitePlusBootstrapPending`, `ensureVitePlusBootstrap`, `reconcileVitePlusBootstrapPackage`, the `ensure*`/`*Pending`/`*SatisfiesVitePlus` helpers. |
 | `catalog.ts`             | `pnpm-workspace.yaml` / catalog / overrides / build-allowance writers and catalog-dependency resolvers; bun catalog; `rewriteRootWorkspacePackageJson`; pnpm workspace-settings migration.                              |
 | `vitest-ecosystem.ts`    | Detecting direct vitest usage, the override-key ("dependency selector") parsing/dropping logic, managed-override sets, ecosystem alignment, legacy `vite-plus-test` wrapper-alias pruning.                              |
+| `vitest-v5.ts`           | Versioned Vitest v5 preflight, compatibility edits, and review findings. Pure AST and command transforms live under `../vitest-v5/`.                                                                                    |
 | `yarn.ts`                | `.yarnrc.yml`, Yarn PnP detection, workspace-hoisting fix, webdriverio detection.                                                                                                                                       |
 | `source-scan.ts`         | Scanning a project's source tree for signals (browser-mode, opt-in providers, `@nuxt/test-utils`, retained upstream-vitest references).                                                                                 |
 | `vite-config.ts`         | `vite.config.ts` merging, default-config injection, staged-config merge, lazy-plugin wrapping, import rewriting (`rewriteAllImports`), migrated-oxlint-config sanitization, lint-staged removal.                        |
diff --git a/packages/cli/src/migration/migrator/catalog.ts b/packages/cli/src/migration/migrator/catalog.ts
index a5aefd7718..ea7a3f383e 100644
--- a/packages/cli/src/migration/migrator/catalog.ts
+++ b/packages/cli/src/migration/migrator/catalog.ts
@@ -29,6 +29,7 @@ import {
   removeYamlMapVitestEntry,
   rewriteMonorepoProject,
   shouldDropProviderOverrideKey,
+  workspaceUsesWebdriverioProvider,
 } from '../migrator.ts';
 import {
   LEGACY_WRAPPER_FALLBACK_VERSIONS,
@@ -262,12 +263,13 @@ export function rewritePnpmWorkspaceYaml(
   vitestEcosystemPackages: ReadonlySet<string>,
   writeWorkspaceSettings = true,
   catalogAdditions: ReadonlySet<string> = new Set(),
+  usesWebdriverioProvider = false,
 ): void {
   const pnpmWorkspaceYamlPath = path.join(projectPath, 'pnpm-workspace.yaml');
   if (!fs.existsSync(pnpmWorkspaceYamlPath)) {
     fs.writeFileSync(pnpmWorkspaceYamlPath, '');
   }
-  const managed = managedOverridePackages(usesVitest);
+  const managed = managedOverridePackages(usesVitest, usesWebdriverioProvider);
 
   editYamlFile(pnpmWorkspaceYamlPath, (doc) => {
     // catalog
@@ -323,9 +325,14 @@ export function rewritePnpmWorkspaceYaml(
       const currentVersion =
         getYamlMapScalarStringValue(overrides, overrideKey) ??
         getYamlMapScalarStringValue(overrides, key);
-      const version = getCatalogDependencySpec(currentVersion, managed[key], true, {
-        preferredCatalogSpec,
-      });
+      // @vitest/browser is an override-only entry: migration removes its direct
+      // dependency and catalog entry because Vite+ already supplies it.
+      const version =
+        key === '@vitest/browser'
+          ? managed[key]
+          : getCatalogDependencySpec(currentVersion, managed[key], true, {
+              preferredCatalogSpec,
+            });
       if (overrides instanceof YAMLMap) {
         overrides.delete(key);
       }
@@ -366,7 +373,7 @@ export function rewritePnpmWorkspaceYaml(
       allowAny.items = allowAny.items.filter((n) => n.value !== 'vitest');
     }
     const existing = new Set(allowAny.items.map((n) => n.value));
-    for (const key of Object.keys(managed)) {
+    for (const key of Object.keys(managedOverridePackages(usesVitest))) {
       if (!existing.has(key)) {
         allowAny.add(scalarString(key));
       }
@@ -387,7 +394,7 @@ export function rewritePnpmWorkspaceYaml(
     if (!usesVitest) {
       removeYamlMapVitestEntry(allowedVersions);
     }
-    for (const key of Object.keys(managed)) {
+    for (const key of Object.keys(managedOverridePackages(usesVitest))) {
       // - vite: '*'
       allowedVersions.set(scalarString(key), scalarString('*'));
     }
@@ -1094,12 +1101,13 @@ export function rewriteBunCatalog(
   projectPath: string,
   usesVitest: boolean,
   vitestEcosystemPackages: ReadonlySet<string>,
+  usesWebdriverioProvider = false,
 ): void {
   const packageJsonPath = path.join(projectPath, 'package.json');
   if (!fs.existsSync(packageJsonPath)) {
     return;
   }
-  const managed = managedOverridePackages(usesVitest);
+  const managed = managedOverridePackages(usesVitest, usesWebdriverioProvider);
 
   editJsonFile<{
     workspaces?: NpmWorkspaces;
@@ -1163,7 +1171,8 @@ export function rewriteBunCatalog(
       if (current !== undefined && typeof current !== 'string') {
         continue;
       }
-      overrides[key] = getCatalogDependencySpec(current, value, true);
+      overrides[key] =
+        key === '@vitest/browser' ? value : getCatalogDependencySpec(current, value, true);
     }
     pkg.overrides = overrides;
 
@@ -1200,7 +1209,10 @@ export function rewriteRootWorkspacePackageJson(
   if (!fs.existsSync(packageJsonPath)) {
     return;
   }
-  const managed = managedOverridePackages(workspaceUsesVitest);
+  const managed = managedOverridePackages(
+    workspaceUsesVitest,
+    workspaceUsesWebdriverioProvider(projectPath, packages),
+  );
 
   let movedPnpmSettings: Record<string, unknown> | undefined;
   editJsonFile<{
@@ -1217,13 +1229,8 @@ export function rewriteRootWorkspacePackageJson(
     pruneLegacyWrapperAliases(pkg.resolutions);
     pruneLegacyWrapperAliases(pkg.overrides);
     pruneLegacyWrapperAliases(pkg.pnpm?.overrides);
-    // Drop stale provider overrides/resolutions (REMOVE_PACKAGES + the now
-    // user-owned opt-in providers, webdriverio/playwright) from the npm/bun
-    // `overrides` and yarn `resolutions` sinks before re-merging managed
-    // overrides. A leftover pin would conflict with the migrated direct
-    // `@vitest/browser-webdriverio` / `@vitest/browser-playwright` dep — npm
-    // hard-fails with EOVERRIDE, and yarn/bun would force the stale version over
-    // the bundled-vitest-aligned 4.1.9. (The pnpm sinks are pruned below.)
+    // Remove stale overrides for bundled and official opt-in providers before
+    // aligning them with Vitest. Preserve community-provider overrides.
     dropRemovePackageOverrideKeys(pkg.resolutions);
     dropRemovePackageOverrideKeys(pkg.overrides);
     // Common case (no workspace-wide direct vitest): strip a lingering managed
@@ -1246,6 +1253,11 @@ export function rewriteRootWorkspacePackageJson(
       };
     } else if (packageManager === PackageManager.bun) {
       // bun overrides are handled in rewriteBunCatalog() with catalog: references
+      // The browser override has no catalog entry and was pruned above with
+      // stale bundled-package pins. Restore its current concrete version.
+      if (managed['@vitest/browser']) {
+        pkg.overrides = { ...pkg.overrides, '@vitest/browser': managed['@vitest/browser'] };
+      }
       // Bun walks transitive peer-deps before resolving overrides; vitest 4.1.9
       // declares peer `vite ^6 || ^7 || ^8` and aborts unless `vite` is a direct
       // dep at the workspace root. Mirror the override as a devDep; the override
@@ -1254,7 +1266,7 @@ export function rewriteRootWorkspacePackageJson(
       // to a `catalog:` reference. See https://github.com/oven-sh/bun/issues/8406.
       setDirectViteEdge(pkg, true, catalogDependencyResolver);
     } else if (packageManager === PackageManager.pnpm) {
-      const overrideKeys = Object.keys(managed);
+      const overrideKeys = Object.keys(managedOverridePackages(workspaceUsesVitest));
       const usePnpmWorkspaceSettings = pnpmSupportsWorkspaceSettings(pnpmVersion ?? '');
       if (!usePnpmWorkspaceSettings) {
         // Strip selector-shaped overrides (e.g. `parent>@vitest/browser-playwright`)
diff --git a/packages/cli/src/migration/migrator/orchestrators.ts b/packages/cli/src/migration/migrator/orchestrators.ts
index 118179ffc4..58805e6a76 100644
--- a/packages/cli/src/migration/migrator/orchestrators.ts
+++ b/packages/cli/src/migration/migrator/orchestrators.ts
@@ -54,6 +54,7 @@ import {
   usesWebdriverioProvider,
   workspaceUsesVitestDirectly,
   workspaceUsesWebdriverio,
+  workspaceUsesWebdriverioProvider,
   wrapLazyPluginsInViteConfig,
 } from '../migrator.ts';
 import { type MigrationReport } from '../report.ts';
@@ -92,6 +93,7 @@ export function rewriteStandaloneProject(
   // package.json contents and no scanned source files are mutated before they
   // are consumed, so the values match the previous lazy per-call scans exactly.
   const providerSourceModes = collectProviderSourceModes(projectPath);
+  const usesWebdriverio = workspaceUsesWebdriverioProvider(projectPath);
   const browserMode = usesVitestBrowserMode(projectPath);
   const retainedVitestModule = sourceTreeReferencesRetainedVitestModule(projectPath);
   const providerCatalogAdditions = collectInjectedProviderNames(
@@ -141,19 +143,14 @@ export function rewriteStandaloneProject(
       browserMode,
       retainedModule: retainedVitestModule,
     });
-    const managed = managedOverridePackages(usesVitest);
+    const managed = managedOverridePackages(usesVitest, usesWebdriverio);
     // Strip stale `vite-plus-test` wrapper aliases before injecting new overrides
     // so the deleted wrapper doesn't survive migration in any sink.
     pruneLegacyWrapperAliases(pkg.resolutions);
     pruneLegacyWrapperAliases(pkg.overrides);
     pruneLegacyWrapperAliases(pkg.pnpm?.overrides);
-    // Drop stale provider overrides/resolutions (REMOVE_PACKAGES + the now
-    // user-owned opt-in providers, webdriverio/playwright) from the npm/bun
-    // `overrides` and yarn `resolutions` sinks before re-merging managed
-    // overrides. A leftover pin would conflict with the migrated direct
-    // `@vitest/browser-webdriverio` / `@vitest/browser-playwright` dep — npm
-    // hard-fails with EOVERRIDE, and yarn/bun would force the stale version over
-    // the bundled-vitest-aligned 4.1.9. (The pnpm sinks are pruned below.)
+    // Remove stale overrides for bundled and official opt-in providers before
+    // aligning them with Vitest. Preserve community-provider overrides.
     dropRemovePackageOverrideKeys(pkg.resolutions);
     dropRemovePackageOverrideKeys(pkg.overrides);
     // Common case (no direct vitest): strip a lingering managed `vitest` from
@@ -187,7 +184,7 @@ export function rewriteStandaloneProject(
       if (usePnpmWorkspaceYaml) {
         shouldAddPnpmWorkspaceVitePlusOverride = isForceOverrideMode();
       }
-      const overrideKeys = Object.keys(managed);
+      const overrideKeys = Object.keys(managedOverridePackages(usesVitest));
       if (!usePnpmWorkspaceYaml) {
         // Strip selector-shaped overrides (e.g. `parent>@vitest/browser-playwright`)
         // whose target is a removed package, before re-merging the user's
@@ -303,6 +300,7 @@ export function rewriteStandaloneProject(
       vitestEcosystemPackages,
       usePnpmWorkspaceYaml,
       providerCatalogAdditions,
+      usesWebdriverio,
     );
   }
 
@@ -379,6 +377,10 @@ export function rewriteMonorepo(
     workspaceInfo.rootDir,
     workspaceInfo.packages,
   );
+  const usesWebdriverio = workspaceUsesWebdriverioProvider(
+    workspaceInfo.rootDir,
+    workspaceInfo.packages,
+  );
   // The SHARED workspace sinks (catalog / overrides / peer rules) keep `vitest`
   // managed iff ANY package in the workspace uses vitest directly.
   const workspaceUsesVitest = workspaceUsesVitestDirectly(
@@ -411,7 +413,12 @@ export function rewriteMonorepo(
       supportCatalog,
     );
   } else if (workspaceInfo.packageManager === PackageManager.bun) {
-    rewriteBunCatalog(workspaceInfo.rootDir, workspaceUsesVitest, vitestEcosystemPackages);
+    rewriteBunCatalog(
+      workspaceInfo.rootDir,
+      workspaceUsesVitest,
+      vitestEcosystemPackages,
+      usesWebdriverio,
+    );
   }
   rewriteRootWorkspacePackageJson(
     workspaceInfo.rootDir,
@@ -434,6 +441,7 @@ export function rewriteMonorepo(
       vitestEcosystemPackages,
       usePnpmWorkspaceSettings,
       providerCatalogAdditions,
+      usesWebdriverio,
     );
     if (usePnpmWorkspaceSettings && isForceOverrideMode()) {
       migratePnpmOverridesToWorkspaceYaml(workspaceInfo.rootDir, {
diff --git a/packages/cli/src/migration/migrator/package-json.ts b/packages/cli/src/migration/migrator/package-json.ts
index 4c78dd163e..827624e80b 100644
--- a/packages/cli/src/migration/migrator/package-json.ts
+++ b/packages/cli/src/migration/migrator/package-json.ts
@@ -51,8 +51,8 @@ export function rewritePackageJson(
   skipStagedMigration?: boolean,
   catalogDependencyResolver?: CatalogDependencyResolver,
   vitestBrowserMode?: boolean,
-  // Source-scan signal per opt-in browser provider name (e.g.
-  // `@vitest/browser-webdriverio` → true). A provider with no dep declared but
+  // Source-scan signal per managed opt-in browser provider name (e.g.
+  // `@vitest/browser-playwright` → true). A provider with no dep declared but
   // imported in source still gets kept/injected.
   providerSourceModes?: Partial<Record<string, boolean>>,
   // Whether the project uses vitest DIRECTLY (a required-peer consumer, an
@@ -224,17 +224,9 @@ export function rewritePackageJson(
       needVitePlus = true;
     }
   }
-  // The browser providers (webdriverio, playwright) are opt-in: vite-plus no
-  // longer bundles them at runtime (each drags a heavy non-optional framework
-  // peer), so a user targeting a provider must own it themselves for the
-  // rewritten `vite-plus/test/browser-<provider>` import to resolve. Unlike the
-  // rest of the `@vitest/*` family they are deliberately NOT in
-  // VITE_PLUS_OVERRIDE_PACKAGES (so projects not using a provider stay
-  // untouched), which means the normalization loop above does not add them. We
-  // align each installed provider here using its existing catalog when present,
-  // or the concrete bundled version otherwise, and ensure its runtime framework
-  // peer (`webdriverio` / `playwright`). (`@vitest/browser`/preview stay bundled
-  // + stripped, handled in the REMOVE_PACKAGES loop above.)
+  // Official opt-in providers remain project dependencies. Align their versions
+  // with bundled Vitest and ensure the framework peer required by each shim.
+  // Community providers are excluded from this list.
   let usesAnyOptInProvider = false;
   for (const provider of OPT_IN_BROWSER_PROVIDERS) {
     const usesProvider =
@@ -279,11 +271,10 @@ export function rewritePackageJson(
         { preferredCatalogSpec: catalogDependencyResolver?.preferredCatalogSpec },
       );
     }
-    const peer = BROWSER_PROVIDER_PEER_DEPS[provider]; // 'webdriverio' / 'playwright'
+    const peer = BROWSER_PROVIDER_PEER_DEPS[provider];
     if (!hasProviderPeerDependency(pkg, peer)) {
       pkg.devDependencies ??= {};
       pkg.devDependencies[peer] = resolveProviderPeerSpec(
-        pkg,
         peer,
         supportCatalog,
         catalogDependencyResolver,
diff --git a/packages/cli/src/migration/migrator/shared.ts b/packages/cli/src/migration/migrator/shared.ts
index 5e8361a567..1b7a5235b6 100644
--- a/packages/cli/src/migration/migrator/shared.ts
+++ b/packages/cli/src/migration/migrator/shared.ts
@@ -46,20 +46,15 @@ export const REMOVE_PACKAGES = [
   '@vitest/browser-preview',
 ] as const;
 
-// The opt-in browser providers. Unlike `@vitest/browser`/preview these are NOT
-// bundled by vite-plus or stripped from users (so they stay out of
-// REMOVE_PACKAGES); each drags a heavy non-optional framework peer
-// (`playwright` / `webdriverio`) that non-browser consumers must not be forced
-// to install. The migration keeps a provider the user actually targets in their
-// own deps, pinned to the bundled vitest version.
+// WebDriverIO is community-maintained. The versioned v5 preflight ensures its
+// minimum version and framework peer; generic reconciliation must not repin it.
 export const WEBDRIVERIO_PROVIDER = '@vitest/browser-webdriverio';
 
 export const PLAYWRIGHT_PROVIDER = '@vitest/browser-playwright';
 
-// All opt-in browser providers handled identically by the migration: kept in
-// the user's deps (pinned to the bundled vitest), framework peer ensured, stale
-// forcing pins dropped, while their catalog entries are PRESERVED.
-export const OPT_IN_BROWSER_PROVIDERS = [WEBDRIVERIO_PROVIDER, PLAYWRIGHT_PROVIDER] as const;
+// Official opt-in providers track the bundled Vitest version. Keep them in the
+// user's dependencies, ensure their framework peers, and remove stale overrides.
+export const OPT_IN_BROWSER_PROVIDERS = [PLAYWRIGHT_PROVIDER] as const;
 
 // Provider names whose stale pnpm overrides / resolutions are dropped during
 // migration: everything vite-plus owns (REMOVE_PACKAGES) plus the user-owned
@@ -79,7 +74,6 @@ export const PROVIDER_OVERRIDE_DROP_NAMES = [
 // must be preserved in devDependencies so browser tests continue to work.
 export const BROWSER_PROVIDER_PEER_DEPS: Record<string, string> = {
   '@vitest/browser-playwright': 'playwright',
-  '@vitest/browser-webdriverio': 'webdriverio',
 };
 
 // Packages that include runtime peer as a dependency.
@@ -87,12 +81,6 @@ const RUNTIME_PEER_INCLUDED_BY: Record<string, readonly string[]> = {
   playwright: ['@playwright/test'],
 };
 
-// Lockstep sibling packages whose declared version a browser provider's runtime
-// framework peer should reuse (they publish together). Keyed by the peer name.
-export const PROVIDER_PEER_VERSION_SIBLINGS: Record<string, readonly string[]> = {
-  webdriverio: ['@wdio/cli', '@wdio/globals'],
-};
-
 // A package's declared spec across all four dependency fields, or undefined.
 export function findDeclaredSpec(pkg: DependencyBag, name: string): string | undefined {
   return (
@@ -114,32 +102,15 @@ export function hasProviderPeerDependency(pkg: DependencyBag, runtimePeer: strin
   );
 }
 
-// A deterministic spec for a browser provider's framework peer instead of `*`:
-// reference the catalog when it already owns the peer, otherwise reuse a declared
-// lockstep sibling's version (concrete, or a catalog reference resolved to its
-// concrete value), falling back to `*` only when there is no sibling. See
-// npmx.dev #27.
+// Reuse an existing framework catalog entry without changing its version.
 export function resolveProviderPeerSpec(
-  pkg: DependencyBag,
   peer: string,
   supportCatalog: boolean,
   catalogDependencyResolver?: CatalogDependencyResolver,
 ): string {
-  if (supportCatalog && catalogDependencyResolver?.('catalog:', peer) !== undefined) {
-    return 'catalog:';
-  }
-  for (const sibling of PROVIDER_PEER_VERSION_SIBLINGS[peer] ?? []) {
-    const spec = findDeclaredSpec(pkg, sibling);
-    const resolved = spec?.startsWith('catalog:')
-      ? catalogDependencyResolver?.(spec, sibling)
-      : spec;
-    // Only reuse a concrete version: a `catalog:` entry may itself alias another
-    // protocol, and npm:/workspace:/file: specs aren't versions to copy.
-    if (resolved && !resolved.includes(':')) {
-      return resolved;
-    }
-  }
-  return '*';
+  return supportCatalog && catalogDependencyResolver?.('catalog:', peer) !== undefined
+    ? 'catalog:'
+    : '*';
 }
 
 // Browser-provider package names that, when present in the user's deps
diff --git a/packages/cli/src/migration/migrator/source-scan.ts b/packages/cli/src/migration/migrator/source-scan.ts
index eac2f7c197..6d01d0b872 100644
--- a/packages/cli/src/migration/migrator/source-scan.ts
+++ b/packages/cli/src/migration/migrator/source-scan.ts
@@ -12,7 +12,6 @@ import {
   OXLINT_PLUGINS_PACKAGE,
   packageOwnsOxlintApi,
   PLAYWRIGHT_PROVIDER,
-  WEBDRIVERIO_PROVIDER,
   readPackageJsonIfExists,
   type DependencyBag,
 } from './shared.ts';
@@ -72,8 +71,7 @@ export function workspaceUsesVitestDirectly(
 //                               `plugins/browser`, `plugins/browser-context`,
 //                               `plugins/browser-client`, `plugins/browser-
 //                               locators`, `plugins/browser-playwright`,
-//                               `plugins/browser-preview`, `plugins/browser-
-//                               webdriverio`), which re-export `@vitest/browser*`
+//                               `plugins/browser-preview`), which re-export `@vitest/browser*`
 //                               under a `/plugins/` segment that the
 //                               `vite-plus/test/browser` hint does not match.
 //                               One prefix covers the whole family.
@@ -104,31 +102,8 @@ const VITEST_BROWSER_SPECIFIER_HINTS = [
   'vite-plus/test/utils',
 ] as const;
 
-// Specifier fragments that signal the WEBDRIVERIO provider specifically. Each
-// is a prefix, matched as a substring, so subpath imports (`/context`,
-// `/provider`, …) are covered too:
-//   - `vitest/browser-webdriverio`, `vitest/browser/providers/webdriverio`, and
-//     `vitest/plugins/browser-webdriverio` are legacy
-//     `@voidzero-dev/vite-plus-test` exports reached through the `vitest` alias
-//   - `@vitest/browser-webdriverio`            pre-migration (incl. `/provider`,
-//                                              `/context` subpaths)
-//   - `vite-plus/test/browser-webdriverio`     migrated (re-run); covers
-//                                              `…/context`
-//   - `vite-plus/test/browser/providers/webdriverio`  migrated provider-subpath
-//                                              form — the import rewriter maps
-//                                              `@vitest/browser-webdriverio/provider`
-//                                              here, so an already-migrated
-//                                              project can contain it. Without
-//                                              this hint a re-run would skip the
-//                                              provider injection and the import
-//                                              would break under pnpm strict /
-//                                              Yarn PnP once the provider is no
-//                                              longer a vite-plus runtime dep.
-//   - `vite-plus/test/plugins/browser-webdriverio`  generated plugin shim that
-//                                              re-exports `@vitest/browser-
-//                                              webdriverio` wholesale; importing
-//                                              it pulls in the (now opt-in)
-//                                              provider, so it signals usage too.
+// Detect the community package and legacy aliases for the versioned migration
+// and driver-build allowances. Generic reconciliation must not repin the provider.
 const WEBDRIVERIO_PROVIDER_SPECIFIER_HINTS = [
   'vitest/browser-webdriverio',
   'vitest/browser/providers/webdriverio',
@@ -141,8 +116,8 @@ const WEBDRIVERIO_PROVIDER_SPECIFIER_HINTS = [
 
 // Specifier fragments that signal the PLAYWRIGHT provider specifically — the
 // playwright analogue of WEBDRIVERIO_PROVIDER_SPECIFIER_HINTS (same prefix /
-// substring matching for `/provider`, `/context` subpaths). Playwright is opt-in
-// just like webdriverio: vite-plus no longer bundles `@vitest/browser-playwright`
+// substring matching for `/provider`, `/context` subpaths). Playwright is opt-in:
+// vite-plus no longer bundles `@vitest/browser-playwright`
 // at runtime, so a source-only user (e.g. `vite.config.ts` importing the
 // provider via a `vite-plus/test/browser-playwright` shim with no declared dep)
 // must still have the provider kept/injected for the rewritten import to resolve.
@@ -161,7 +136,6 @@ const PLAYWRIGHT_PROVIDER_SPECIFIER_HINTS = [
 // Per-provider source-scan hint lists, used to build the `providerSourceModes`
 // map passed to `rewritePackageJson`.
 const BROWSER_PROVIDER_SPECIFIER_HINTS: Record<string, readonly string[]> = {
-  [WEBDRIVERIO_PROVIDER]: WEBDRIVERIO_PROVIDER_SPECIFIER_HINTS,
   [PLAYWRIGHT_PROVIDER]: PLAYWRIGHT_PROVIDER_SPECIFIER_HINTS,
 };
 
@@ -191,6 +165,7 @@ const VITEST_SCAN_SKIP_DIRS = new Set([
   '.svelte-kit',
   '.vite',
   '.cache',
+  '.yarn',
 ]);
 
 // Built plugins can still load the original API after migration. Skip installed
@@ -262,6 +237,7 @@ function sourceTreeMatches(
         }
       } else if (
         entry.isFile() &&
+        !['.pnp.cjs', '.pnp.loader.mjs'].includes(entry.name) &&
         (VITEST_SCAN_EXTENSIONS.has(path.extname(entry.name)) ||
           (options.includeExtensionless && path.extname(entry.name) === '') ||
           (options.includePackageReferences && entry.name === 'package.json'))
diff --git a/packages/cli/src/migration/migrator/vite-plus-bootstrap.ts b/packages/cli/src/migration/migrator/vite-plus-bootstrap.ts
index 9459496c95..afc1b72462 100644
--- a/packages/cli/src/migration/migrator/vite-plus-bootstrap.ts
+++ b/packages/cli/src/migration/migrator/vite-plus-bootstrap.ts
@@ -50,6 +50,7 @@ import {
   vitestEcosystemCatalogReferencesPending,
   workspaceUsesVitestDirectly,
   workspaceUsesWebdriverio,
+  workspaceUsesWebdriverioProvider,
   yarnrcSatisfiesVitePlus,
 } from '../migrator.ts';
 import { type DependencyVersionChange, type MigrationReport } from '../report.ts';
@@ -120,6 +121,9 @@ function isSemanticVitePlusOverrideSpec(dependencyName: string, spec: string | u
   if (spec === VITE_PLUS_OVERRIDE_PACKAGES[dependencyName]) {
     return true;
   }
+  if (dependencyName === '@vitest/browser' && spec === VITEST_VERSION) {
+    return true;
+  }
   return false;
 }
 
@@ -148,8 +152,9 @@ export function overridesSatisfyVitePlus(
   usesVitest: boolean,
   catalogDependencyResolver?: CatalogDependencyResolver,
   keyStyle: ManagedOverrideKeyStyle = 'bare',
+  usesWebdriverioProvider = false,
 ): boolean {
-  const managed = managedOverridePackages(usesVitest);
+  const managed = managedOverridePackages(usesVitest, usesWebdriverioProvider);
   // Common case: a lingering managed `vitest` override is not satisfied. It
   // must be removed, so the bootstrap stays pending until then. Both key
   // spellings count. A pnpm sink migrated before #2309 still holds the bare
@@ -409,7 +414,6 @@ function reconcileVitePlusBootstrapPackage(
     if (!hasProviderPeerDependency(pkg, frameworkPeer)) {
       pkg.devDependencies ??= {};
       pkg.devDependencies[frameworkPeer] = resolveProviderPeerSpec(
-        pkg,
         frameworkPeer,
         supportCatalog,
         catalogDependencyResolver,
@@ -724,10 +728,11 @@ export function detectVitePlusBootstrapPending(
   // Shared override/catalog sinks must keep vitest managed when any package in
   // the workspace needs it. The direct dependency itself is localized above.
   const usesVitest = workspaceUsesVitestDirectly(projectPath, packages, true);
+  const usesWebdriverio = workspaceUsesWebdriverioProvider(projectPath, packages);
 
   if (packageManager === PackageManager.yarn) {
     return (
-      !overridesSatisfyVitePlus(pkg.resolutions, usesVitest) ||
+      !overridesSatisfyVitePlus(pkg.resolutions, usesVitest, undefined, 'bare', usesWebdriverio) ||
       !yarnrcSatisfiesVitePlus(projectPath, usesVitest, supportCatalog) ||
       yarnWorkspaceHoistingOptOutPending(projectPath, packageManager, packages)
     );
@@ -735,7 +740,7 @@ export function detectVitePlusBootstrapPending(
   if (packageManager === PackageManager.npm) {
     return (
       vitePlusDependencyNeedsConcreteVersion(pkg) ||
-      !overridesSatisfyVitePlus(pkg.overrides, usesVitest) ||
+      !overridesSatisfyVitePlus(pkg.overrides, usesVitest, undefined, 'bare', usesWebdriverio) ||
       npmVitePlusManagedDependenciesPending(pkg, usesVitest)
     );
   }
@@ -748,6 +753,8 @@ export function detectVitePlusBootstrapPending(
       pkg.overrides,
       usesVitest,
       supportCatalog ? readBunCatalogDependencyResolver(pkg) : undefined,
+      'bare',
+      usesWebdriverio,
     );
   }
   if (packageManager === PackageManager.pnpm) {
@@ -768,13 +775,20 @@ export function detectVitePlusBootstrapPending(
             usesVitest,
             catalogDependencyResolver,
             'pnpm-ranged',
+            usesWebdriverio,
           ) ||
           !pnpmPeerDependencyRulesSatisfyVitePlus(pkg.pnpm?.peerDependencyRules, usesVitest)
         );
       }
       return (
         vitePlusDependencyNeedsConcreteVersion(pkg) ||
-        !overridesSatisfyVitePlus(pkg.pnpm?.overrides, usesVitest, undefined, 'pnpm-ranged') ||
+        !overridesSatisfyVitePlus(
+          pkg.pnpm?.overrides,
+          usesVitest,
+          undefined,
+          'pnpm-ranged',
+          usesWebdriverio,
+        ) ||
         !pnpmPeerDependencyRulesSatisfyVitePlus(pkg.pnpm?.peerDependencyRules, usesVitest)
       );
     }
@@ -786,6 +800,7 @@ export function detectVitePlusBootstrapPending(
         usesVitest,
         resolver,
         'pnpm-ranged',
+        usesWebdriverio,
       ) ||
       !pnpmPeerDependencyRulesSatisfyVitePlus(
         readPnpmWorkspacePeerDependencyRules(projectPath),
@@ -881,6 +896,7 @@ function ensureOverrideEntries(
   usesVitest: boolean,
   catalogDependencyResolver?: CatalogDependencyResolver,
   keyStyle: ManagedOverrideKeyStyle = 'bare',
+  usesWebdriverioProvider = false,
 ): { overrides: Record<string, string>; changed: boolean } {
   const next = { ...overrides };
   let changed = false;
@@ -889,7 +905,7 @@ function ensureOverrideEntries(
     changed = true;
   }
   for (const [dependencyName, overrideSpec] of Object.entries(
-    managedOverridePackages(usesVitest),
+    managedOverridePackages(usesVitest, usesWebdriverioProvider),
   )) {
     const overrideKey = managedOverrideKey(dependencyName, keyStyle);
     // Move a pre-#2309 bare key's value to the range-qualified key, so the
@@ -963,6 +979,7 @@ export function ensureVitePlusBootstrap(
   // when any package needs it. Each package's direct vitest dependency is
   // reconciled independently below.
   const usesVitest = workspaceUsesVitestDirectly(projectPath, workspaceInfo.packages, true);
+  const usesWebdriverio = workspaceUsesWebdriverioProvider(projectPath, workspaceInfo.packages);
   const pnpmMajorVersion = pnpmMajor(workspaceInfo.downloadPackageManager.version);
   const shouldAllowBrowserBuilds = workspaceUsesWebdriverio(projectPath, workspaceInfo.packages);
   const usePnpmWorkspaceYaml =
@@ -1032,6 +1049,7 @@ export function ensureVitePlusBootstrap(
         vitestEcosystemPackages,
         false,
         providerCatalogAdditions,
+        usesWebdriverio,
       );
     }
   }
@@ -1055,13 +1073,25 @@ export function ensureVitePlusBootstrap(
     );
 
     if (workspaceInfo.packageManager === PackageManager.yarn) {
-      const ensured = ensureOverrideEntries(pkg.resolutions, usesVitest);
+      const ensured = ensureOverrideEntries(
+        pkg.resolutions,
+        usesVitest,
+        undefined,
+        'bare',
+        usesWebdriverio,
+      );
       if (ensured.changed) {
         pkg.resolutions = ensured.overrides;
         packageJsonChanged = true;
       }
     } else if (workspaceInfo.packageManager === PackageManager.npm) {
-      const ensured = ensureOverrideEntries(pkg.overrides, usesVitest);
+      const ensured = ensureOverrideEntries(
+        pkg.overrides,
+        usesVitest,
+        undefined,
+        'bare',
+        usesWebdriverio,
+      );
       if (ensured.changed) {
         pkg.overrides = ensured.overrides;
         packageJsonChanged = true;
@@ -1075,6 +1105,8 @@ export function ensureVitePlusBootstrap(
         pkg.overrides,
         usesVitest,
         supportCatalog ? readBunCatalogDependencyResolver(pkg) : undefined,
+        'bare',
+        usesWebdriverio,
       );
       if (ensured.changed) {
         pkg.overrides = ensured.overrides;
@@ -1090,6 +1122,7 @@ export function ensureVitePlusBootstrap(
         usesVitest,
         supportCatalog ? readPnpmWorkspaceCatalogDependencyResolver(projectPath) : undefined,
         'pnpm-ranged',
+        usesWebdriverio,
       );
       if (ensured.changed) {
         pkg.pnpm.overrides = ensured.overrides;
@@ -1190,6 +1223,7 @@ export function ensureVitePlusBootstrap(
           usesVitest,
           catalogDependencyResolver,
           'pnpm-ranged',
+          usesWebdriverio,
         ) ||
         !pnpmPeerDependencyRulesSatisfyVitePlus(
           readPnpmWorkspacePeerDependencyRules(projectPath),
@@ -1204,6 +1238,7 @@ export function ensureVitePlusBootstrap(
           vitestEcosystemPackages,
           true,
           providerCatalogAdditions,
+          usesWebdriverio,
         );
       }
       if (fs.existsSync(pnpmWorkspaceYamlPath)) {
@@ -1239,7 +1274,7 @@ export function ensureVitePlusBootstrap(
     // rewriteBunCatalog runs only on monorepo roots). A standalone bun project
     // keeps the concrete overrides set by `ensureOverrideEntries` above.
     const before = fs.readFileSync(packageJsonPath, 'utf-8');
-    rewriteBunCatalog(projectPath, usesVitest, vitestEcosystemPackages);
+    rewriteBunCatalog(projectPath, usesVitest, vitestEcosystemPackages, usesWebdriverio);
     const after = fs.readFileSync(packageJsonPath, 'utf-8');
     result.packageJson = result.packageJson || before !== after;
   }
diff --git a/packages/cli/src/migration/migrator/vitest-ecosystem.ts b/packages/cli/src/migration/migrator/vitest-ecosystem.ts
index 88467d5c9a..ffff16ac75 100644
--- a/packages/cli/src/migration/migrator/vitest-ecosystem.ts
+++ b/packages/cli/src/migration/migrator/vitest-ecosystem.ts
@@ -145,7 +145,7 @@ function parentChainReachesVitePlus(segments: string[]): boolean {
 //     (scoped) segments; the remaining leading `/`-segments are the `from` chain,
 //     with scoped ancestors (`@scope/name`) rejoined.
 //   - bare/versioned names (`pkg`, `@scope/pkg`, `pkg@4`) have NO parent → `null`.
-function extractOverrideParentSegments(key: string): string[] | null {
+export function extractOverrideParentSegments(key: string): string[] | null {
   let rest = key.trim();
   // Peel every pnpm `>` parent level. pnpm splits at a `>` whose preceding char
   // is NOT space, `|`, or `@` (its DELIMITER_REGEX), so semver comparators like
@@ -334,15 +334,23 @@ export function dropRemovePackageOverrideKeys(
 // vite-plus and must NOT carry a managed `vitest` pin (which would drift on a
 // future `vp update vite-plus`). When `usesVitest` is false the common-case
 // removal logic ACTIVELY strips any lingering `vitest` entry.
-export function managedOverridePackages(usesVitest: boolean): Record<string, string> {
-  if (usesVitest) {
-    return VITE_PLUS_OVERRIDE_PACKAGES;
-  }
+export function managedOverridePackages(
+  usesVitest: boolean,
+  usesWebdriverioProvider = false,
+): Record<string, string> {
   // Drop only `vitest`; every other managed key (e.g. `vite`, and in
   // force-override/CI mode the `@voidzero-dev/vite-plus-core` file: alias) stays.
-  return Object.fromEntries(
-    Object.entries(VITE_PLUS_OVERRIDE_PACKAGES).filter(([key]) => key !== 'vitest'),
-  );
+  const managed = usesVitest
+    ? VITE_PLUS_OVERRIDE_PACKAGES
+    : Object.fromEntries(
+        Object.entries(VITE_PLUS_OVERRIDE_PACKAGES).filter(([key]) => key !== 'vitest'),
+      );
+  // The community provider uses a range for @vitest/browser. An old lockfile
+  // can retain a different browser version than the bundled runner. Align the
+  // official browser package without synchronizing the community provider.
+  return usesWebdriverioProvider && VITEST_IS_MANAGED_OVERRIDE
+    ? { ...managed, '@vitest/browser': VITEST_VERSION }
+    : managed;
 }
 
 // True iff a dependency field lists a vitest ecosystem package — any name that
diff --git a/packages/cli/src/migration/migrator/vitest-v5.ts b/packages/cli/src/migration/migrator/vitest-v5.ts
new file mode 100644
index 0000000000..53c29b30a3
--- /dev/null
+++ b/packages/cli/src/migration/migrator/vitest-v5.ts
@@ -0,0 +1,1022 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+import { applyEdits, findNodeAtLocation, parse as parseJsonc, parseTree } from 'jsonc-parser';
+import semver from 'semver';
+import { isScalar, parseDocument, visit } from 'yaml';
+
+import { isDirectoryGitignored } from '../../../binding/index.js';
+import cliPackage from '../../../package.json' with { type: 'json' };
+import { PackageManager, type WorkspaceInfoOptional } from '../../types/index.ts';
+import { findGitRoot } from '../../utils/git.ts';
+import { detectPackageMetadata } from '../../utils/package.ts';
+import { createCatalogDependencyResolver } from '../migrator.ts';
+import type { RewriteResult, SourceOptions, VitestV5Finding } from '../vitest-v5/ast.ts';
+import { migrateVitestV5Command } from '../vitest-v5/commands.ts';
+import {
+  findVitestV5ConfigFiles,
+  findVitestV5MergedConfigFiles,
+  migrateVitestV5Config,
+} from '../vitest-v5/config.ts';
+import { vitestV5Documentation } from '../vitest-v5/documentation.ts';
+import { lockedVitestVersion } from '../vitest-v5/lockfile.ts';
+import {
+  findVitestV5ConfigEntries,
+  resolveVitestV5TestModes,
+  type VitestV5TestMode,
+} from '../vitest-v5/scopes.ts';
+import { hasVitestV5SourceUsage, migrateVitestV5Source } from '../vitest-v5/source.ts';
+import { migrateWebdriverioDependencies } from '../vitest-v5/webdriverio.ts';
+
+const SKIP_DIRS = new Set([
+  'node_modules',
+  '.git',
+  '.vite',
+  '.vitest',
+  '.vite-plus',
+  '.cache',
+  '.yarn',
+  'dist',
+  'build',
+  'out',
+  'coverage',
+  '.next',
+  '.nuxt',
+  '.svelte-kit',
+]);
+const CODE_FILE = /\.[cm]?[jt]sx?$/;
+const VITEST_SIGNAL =
+  /(?:['"](?:vitest(?:\/[^'"]*)?|@vitest\/[^'"]+|vite-plus\/test[^'"]*)['"]|\bvp\s+test\b|\bvitest\s+(?:run|list|bench)|\bimport\s*\.\s*meta\s*\.\s*vitest\b)/;
+const VITEST_COMMAND = /\b(?:vp\s+test|vitest)(?:\s|$)/;
+const BROWSER_SIGNAL =
+  /@vitest\/browser|(?:vitest|vite-plus\/test)\/browser|vitest-browser-|browser\s*:\s*\{|--browser(?:[.=\s'"]|$)/;
+const LEGACY_RUNNER = '@voidzero-dev/vite-plus-test';
+
+interface ProjectPlan {
+  directory: string;
+  sourceVersion?: string;
+  active: boolean;
+  options: SourceOptions;
+  configFiles: Set<string>;
+  // Retain deferred findings only through the current invocation's final scan.
+  pendingSourceReviews?: Record<string, string[]>;
+}
+
+const DEFERRED_SOURCE_REVIEWS = new Set(['resolve-config', 'overlapping-edits', 'unsafe-syntax']);
+interface FileChange {
+  file: string;
+  before: string;
+  after: string;
+}
+export interface VitestV5MigrationPlan {
+  rootDir: string;
+  packageManager?: PackageManager;
+  projects: ProjectPlan[];
+  findings: VitestV5Finding[];
+  changes: FileChange[];
+  inputs: ReadonlyMap<string, string | null>;
+}
+
+type MigrationWorkspace = Pick<WorkspaceInfoOptional, 'rootDir' | 'packageManager'> &
+  Partial<Pick<WorkspaceInfoOptional, 'packages'>>;
+
+function workspaceFromPlan(plan: VitestV5MigrationPlan): MigrationWorkspace {
+  return {
+    rootDir: plan.rootDir,
+    packageManager: plan.packageManager,
+    packages: plan.projects.slice(1).map((project) => ({
+      name: '',
+      path: path.relative(plan.rootDir, project.directory),
+    })),
+  };
+}
+
+function readJson(file: string): Record<string, unknown> {
+  return parseJson(fs.readFileSync(file, 'utf8'));
+}
+function parseJson(source: string) {
+  return JSON.parse(source.replace(/^\uFEFF/, ''));
+}
+function record(value: unknown): Record<string, unknown> | undefined {
+  return value !== null && typeof value === 'object' && !Array.isArray(value)
+    ? (value as Record<string, unknown>)
+    : undefined;
+}
+function dependency(pkg: Record<string, unknown>, name: string): string | undefined {
+  for (const field of [
+    'dependencies',
+    'devDependencies',
+    'optionalDependencies',
+    'peerDependencies',
+  ]) {
+    const spec = record(pkg[field])?.[name];
+    if (typeof spec === 'string') {
+      return spec;
+    }
+  }
+  return undefined;
+}
+
+function filesInProject(directory: string): string[] {
+  const files: string[] = [];
+  const walk = (current: string) => {
+    if (current !== directory && fs.existsSync(path.join(current, 'package.json'))) {
+      return;
+    }
+    for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
+      const file = path.join(current, entry.name);
+      // Never follow symlinks into another package or outside the workspace.
+      if (entry.isDirectory() && !SKIP_DIRS.has(entry.name)) {
+        walk(file);
+      } else if (
+        entry.isFile() &&
+        !['.pnp.cjs', '.pnp.loader.mjs'].includes(entry.name) &&
+        (CODE_FILE.test(file) ||
+          /\.(?:json|ya?ml|sh)$/.test(file) ||
+          /^Dockerfile(?:\.|$)|^Containerfile(?:\.|$)/.test(entry.name) ||
+          ['.node-version', '.nvmrc', '.gitignore', 'yarn.lock', 'bun.lock'].includes(entry.name))
+      ) {
+        files.push(file);
+      }
+    }
+  };
+  walk(directory);
+  return files.toSorted();
+}
+
+function finding(
+  file: string,
+  code: string,
+  message: string,
+  severity: VitestV5Finding['severity'] = 'review',
+  source = '',
+  offset = 0,
+): VitestV5Finding {
+  const prefix = source.slice(0, offset);
+  return {
+    file,
+    line: prefix.split('\n').length,
+    column: offset - prefix.lastIndexOf('\n'),
+    code,
+    severity,
+    message,
+  };
+}
+
+/** Follow this project's dependency edges, never an unrelated transitive runner. */
+function lockedSourceVersion(
+  directory: string,
+  root: string,
+  pkg: Record<string, unknown>,
+  manager?: PackageManager,
+  expectedRunnerPackage?: string,
+): string | undefined {
+  if (manager !== undefined && manager !== PackageManager.pnpm) {
+    const spec = dependency(pkg, 'vitest');
+    return spec && !expectedRunnerPackage
+      ? lockedVitestVersion(root, directory, manager, spec)
+      : undefined;
+  }
+  const lockfile = path.join(root, 'pnpm-lock.yaml');
+  if (!fs.existsSync(lockfile)) {
+    return undefined;
+  }
+  try {
+    const document = parseDocument(fs.readFileSync(lockfile, 'utf8'));
+    if (document.errors.length) {
+      return undefined;
+    }
+    const lock = record(document.toJS());
+    const importer = record(
+      record(lock?.importers)?.[path.relative(root, directory).replaceAll('\\', '/') || '.'],
+    );
+    if (!importer) {
+      return undefined;
+    }
+    const name = dependency(pkg, 'vitest') ? 'vitest' : 'vite-plus';
+    const spec = dependency(pkg, name);
+    if (!spec) {
+      return undefined;
+    }
+    const entry = ['dependencies', 'devDependencies', 'optionalDependencies']
+      .map((field) => record(importer[field])?.[name])
+      .find((value) => value !== undefined);
+    const metadata = record(entry);
+    if (typeof metadata?.specifier === 'string' && metadata.specifier !== spec) {
+      return undefined;
+    }
+    const follow = (name: string, value: unknown, depth = 0): string | undefined => {
+      const reference = typeof value === 'string' ? value : record(value)?.version;
+      if (typeof reference !== 'string' || depth > 3) {
+        return undefined;
+      }
+      if (
+        name === 'vitest' &&
+        expectedRunnerPackage &&
+        !reference.startsWith(`${expectedRunnerPackage}@`)
+      ) {
+        return undefined;
+      }
+      if (reference.startsWith(`${LEGACY_RUNNER}@`)) {
+        return follow(LEGACY_RUNNER, reference.slice(LEGACY_RUNNER.length + 1), depth + 1);
+      }
+      const version = reference.split('(')[0];
+      if (!semver.valid(version)) {
+        return undefined;
+      }
+      if (name === 'vitest') {
+        return version;
+      }
+      if (name === LEGACY_RUNNER) {
+        // The wrapper has a Vite+ version; its exact UI peer records the
+        // upstream runner version, including when the optional UI is absent.
+        const legacy = record(record(lock?.packages)?.[`${name}@${version}`]);
+        const runnerVersion = record(legacy?.peerDependencies)?.['@vitest/ui'];
+        return typeof runnerVersion === 'string'
+          ? (semver.valid(runnerVersion) ?? undefined)
+          : undefined;
+      }
+      const snapshot = record(record(lock?.snapshots)?.[`${name}@${reference}`]);
+      const dependencies = record(snapshot?.dependencies);
+      return (
+        follow('vitest', dependencies?.vitest, depth + 1) ??
+        follow(LEGACY_RUNNER, dependencies?.[LEGACY_RUNNER], depth + 1)
+      );
+    };
+    return follow(name, entry);
+  } catch {
+    // An unreadable or unsupported lockfile is not evidence of a v4 runner.
+    return undefined;
+  }
+}
+
+function unambiguousRunnerVersion(range: string): string | undefined {
+  if (
+    !semver.validRange(range) ||
+    (!semver.subset(range, '<5.0.0-0', { includePrerelease: true }) &&
+      !semver.subset(range, '>=5.0.0-0', { includePrerelease: true }))
+  ) {
+    // A range that crosses the v4/v5 boundary cannot establish which defaults
+    // the project used. Require its installed runner or an exact lockfile edge.
+    return undefined;
+  }
+  return semver.minVersion(range)?.version;
+}
+
+function installedSourceVersion(
+  directory: string,
+  name: string,
+  expectedPackage?: string,
+  expectedRange?: string,
+): string | undefined {
+  const installed = detectPackageMetadata(directory, name);
+  if (!installed || (expectedPackage && installed.name !== expectedPackage)) {
+    return undefined;
+  }
+  if (
+    expectedRange &&
+    semver.validRange(expectedRange) &&
+    !semver.satisfies(installed.version, expectedRange, { includePrerelease: true })
+  ) {
+    return undefined;
+  }
+  if (installed.name === 'vitest') {
+    return semver.valid(installed.version) ?? undefined;
+  }
+  const pkg = readJson(path.join(installed.path, 'package.json'));
+  if (installed.name === LEGACY_RUNNER) {
+    const version = record(pkg.peerDependencies)?.['@vitest/ui'];
+    return typeof version === 'string' ? (semver.valid(version) ?? undefined) : undefined;
+  }
+  if (installed.name !== 'vite-plus') {
+    return undefined;
+  }
+  const bundled = dependency(pkg, 'vitest');
+  if (bundled?.startsWith('catalog:')) {
+    // Linked workspace builds retain catalog references in their manifest.
+    // Follow that build's installed runner, not the migrating project's catalog
+    // or the CLI version: repeat runs must identify v5 without saved metadata.
+    return installedSourceVersion(installed.path, 'vitest');
+  }
+  if (bundled && semver.validRange(bundled)) {
+    const version = installedSourceVersion(installed.path, 'vitest');
+    return version && semver.satisfies(version, bundled, { includePrerelease: true })
+      ? version
+      : unambiguousRunnerVersion(bundled);
+  }
+  return dependency(pkg, LEGACY_RUNNER)
+    ? installedSourceVersion(installed.path, LEGACY_RUNNER)
+    : undefined;
+}
+
+function sourceVersion(
+  directory: string,
+  root: string,
+  pkg: Record<string, unknown>,
+  manager?: PackageManager,
+): string | undefined {
+  const catalog = createCatalogDependencyResolver(root, manager ?? PackageManager.pnpm);
+  const vitePlus = dependency(pkg, 'vite-plus');
+  const vitePlusRange = vitePlus?.startsWith('catalog:')
+    ? catalog?.(vitePlus, 'vite-plus')
+    : vitePlus;
+  let spec = dependency(pkg, 'vitest');
+  if (spec?.startsWith('catalog:')) {
+    spec = catalog?.(spec, 'vitest');
+  }
+  const legacyAlias = spec?.startsWith(`npm:${LEGACY_RUNNER}@`);
+  if (spec?.startsWith('npm:vitest@')) {
+    spec = spec.slice('npm:vitest@'.length);
+  }
+  const hasOwnVitest = ['dependencies', 'devDependencies', 'optionalDependencies'].some(
+    (field) => typeof record(pkg[field])?.vitest === 'string',
+  );
+  // A retained peer range describes the library's consumers, not the runner
+  // used by its installed Vite+ toolchain. Prefer that runner on stateless
+  // reruns; an explicit runtime/dev Vitest dependency still takes precedence.
+  if (!hasOwnVitest && vitePlus) {
+    const bundled = installedSourceVersion(directory, 'vite-plus', 'vite-plus', vitePlusRange);
+    if (bundled) {
+      return bundled;
+    }
+  }
+  // A stale install or catalog lock entry can still resolve upstream Vitest
+  // under this name. Its version is not evidence for the declared wrapper.
+  const expectedRunnerPackage = legacyAlias ? LEGACY_RUNNER : undefined;
+  const locked = lockedSourceVersion(directory, root, pkg, manager, expectedRunnerPackage);
+  if (
+    locked &&
+    (!spec ||
+      legacyAlias ||
+      !semver.validRange(spec) ||
+      semver.satisfies(locked, spec, { includePrerelease: true }))
+  ) {
+    return locked;
+  }
+  const installed = installedSourceVersion(directory, 'vitest', expectedRunnerPackage);
+  if (
+    installed &&
+    (!spec || legacyAlias || semver.satisfies(installed, spec, { includePrerelease: true }))
+  ) {
+    return installed;
+  }
+  if (legacyAlias) {
+    // This removed wrapper only shipped the v4 runner. Prefer its exact
+    // version from the original install or lockfile when one is available.
+    return '4.0.0';
+  }
+  if (spec && semver.validRange(spec)) {
+    return unambiguousRunnerVersion(spec);
+  }
+  if (dependency(pkg, 'vite-plus')) {
+    const bundled = installedSourceVersion(directory, 'vite-plus', 'vite-plus', vitePlusRange);
+    if (bundled) {
+      return bundled;
+    }
+  }
+  // A workspace member commonly uses the root's test command and dependencies.
+  if (directory !== root) {
+    return sourceVersion(root, root, readJson(path.join(root, 'package.json')), manager);
+  }
+  return undefined;
+}
+
+function checkNodeRange(
+  file: string,
+  value: string,
+  label: string,
+  findings: VitestV5Finding[],
+  publicContract = false,
+): string | undefined {
+  // At the v5 upgrade baseline, both the latest LTS and Current Node releases
+  // meet our minimum versions; future majors are covered by >=26. These
+  // forward-moving runtime aliases do not need a numeric pin. Named/relative
+  // LTS aliases and public engines ranges still need the checks below.
+  if (!publicContract && ['lts/*', 'lts', 'latest', 'current', 'node', 'stable'].includes(value)) {
+    return undefined;
+  }
+  const range = semver.validRange(value);
+  if (publicContract && range) {
+    // A public engine contract is not a runtime pin. A supported minimum
+    // is sufficient; open ranges need not exclude every unsupported major.
+    const minimum = semver.minVersion(range);
+    if (minimum) {
+      // A whole-major range such as 24.x also permits a supported release.
+      // Do not mistake its implicit 24.0.0 minimum for an exact runtime pin.
+      const majorRange = `${minimum.major}.x`;
+      if (
+        semver.satisfies(minimum, cliPackage.engines.node) ||
+        (semver.subset(majorRange, range) && semver.intersects(majorRange, cliPackage.engines.node))
+      ) {
+        return undefined;
+      }
+    }
+  }
+  let message = `Resolve ${label} (${value}) and select Node ${cliPackage.engines.node}.`;
+  if (range && !publicContract && !semver.intersects(range, cliPackage.engines.node)) {
+    const current = semver.minVersion(range);
+    const upgrade =
+      current &&
+      new semver.Range(cliPackage.engines.node).set
+        .map((comparators) => semver.minVersion(comparators.map(({ value }) => value).join(' ')))
+        .filter((version): version is semver.SemVer => version !== null)
+        .toSorted(semver.compare)
+        .find((version) => semver.gte(version, current));
+    if (upgrade) {
+      // Choose the first supported minimum at or above the requested version.
+      // For example, 20 -> 22.18.0, 24.10 -> 24.11.0, and 25 -> 26.0.0.
+      return upgrade.version;
+    }
+  } else if (range) {
+    if (
+      semver.subset(range, cliPackage.engines.node) ||
+      (!publicContract && !/[<>|*]/.test(value))
+    ) {
+      return undefined;
+    }
+    message = `${label} (${value}) includes unsupported test runtimes. Pin the test/CI runtime to Node ${cliPackage.engines.node}; keep the library's public engine contract separate.`;
+  }
+  findings.push(finding(file, 'node-runtime', message));
+  return undefined;
+}
+
+function migrateNode(file: string, source: string, findings: VitestV5Finding[]): string {
+  // Limit compatibility checks to project runtime declarations. Inferring
+  // runtimes from CI workflows, containers, or other files is out of scope.
+  const base = path.basename(file);
+  if (base === '.node-version' || base === '.nvmrc') {
+    const value = source.trim();
+    const upgrade = checkNodeRange(file, value.replace(/^v/, ''), base, findings);
+    if (upgrade) {
+      const start = source.indexOf(value);
+      return (
+        source.slice(0, start) +
+        (value.startsWith('v') ? 'v' : '') +
+        upgrade +
+        source.slice(start + value.length)
+      );
+    }
+  }
+  if (base === 'package.json') {
+    const pkg = parseJson(source);
+    const tree = parseTree(source.replace(/^\uFEFF/, ' '));
+    const edits: Array<{ offset: number; length: number; content: string }> = [];
+    const checkRuntime = (value: string, label: string, keys: Array<string | number>) => {
+      const upgrade = checkNodeRange(file, value, label, findings);
+      const node = tree && findNodeAtLocation(tree, keys);
+      if (upgrade && node) {
+        edits.push({ offset: node.offset, length: node.length, content: JSON.stringify(upgrade) });
+      }
+    };
+    if (typeof pkg.engines?.node === 'string') {
+      checkNodeRange(file, pkg.engines.node, 'engines.node', findings, true);
+    }
+    const runtime = pkg.devEngines?.runtime;
+    for (const [index, entry] of (Array.isArray(runtime) ? runtime : [runtime]).entries()) {
+      if (entry?.name === 'node' && typeof entry.version === 'string') {
+        checkRuntime(entry.version, 'devEngines.runtime', [
+          'devEngines',
+          'runtime',
+          ...(Array.isArray(runtime) ? [index] : []),
+          'version',
+        ]);
+      }
+    }
+    // The existing setup migration uses Volta only when neither pin file
+    // exists. Check that future .node-version before any project edits.
+    if (
+      typeof pkg.volta?.node === 'string' &&
+      !['.node-version', '.nvmrc'].some((name) =>
+        fs.existsSync(path.join(path.dirname(file), name)),
+      )
+    ) {
+      checkRuntime(pkg.volta.node, 'volta.node', ['volta', 'node']);
+    }
+    return applyEdits(source, edits);
+  }
+  return source;
+}
+
+function scanAndRewriteFile(
+  file: string,
+  source: string,
+  project: ProjectPlan,
+  testMode: VitestV5TestMode,
+  mergedConfig: boolean,
+): RewriteResult {
+  const findings: VitestV5Finding[] = [];
+  if (!project.active) {
+    return { content: migrateNode(file, source, findings), findings };
+  }
+  let content = source;
+  if (
+    CODE_FILE.test(file) &&
+    (testMode.benchmark ||
+      testMode.globals ||
+      testMode.reviewGlobals ||
+      VITEST_SIGNAL.test(source) ||
+      /\.(?:test|spec)\./.test(file) ||
+      project.configFiles.has(file))
+  ) {
+    try {
+      // Canonical and symbol-specific rules run before the native generic import
+      // pass. Config and source edits are separate AST passes to avoid overlap.
+      const sourceResult = migrateVitestV5Source(file, content, {
+        ...project.options,
+        ...testMode,
+      });
+      content = sourceResult.content;
+      findings.push(...sourceResult.findings);
+      const pending =
+        project.pendingSourceReviews?.[
+          path.relative(project.directory, file).replaceAll('\\', '/')
+        ];
+      if (!project.options.preserveV4 && pending?.length) {
+        // Re-evaluate this invocation's deferred v4 findings after its edits.
+        // A later invocation starts from the resolved runner version instead.
+        const review = migrateVitestV5Source(file, content, {
+          ...project.options,
+          ...testMode,
+          preserveV4: true,
+        });
+        findings.push(...review.findings.filter(({ code }) => pending.includes(code)));
+      }
+      if (project.configFiles.has(file)) {
+        const configResult = migrateVitestV5Config(file, content, project.options, mergedConfig);
+        content = configResult.content;
+        findings.push(...configResult.findings);
+      }
+    } catch (error) {
+      content = source;
+      findings.push(
+        finding(
+          file,
+          'source-parse',
+          `Parse and review this file before migration: ${error instanceof Error ? error.message : String(error)}`,
+        ),
+      );
+      if (
+        /['"](?:@vitest\/(?:runner|expect)|(?:vitest|vite-plus\/test)\/(?:runners|suite|internal\/module-runner))/.test(
+          source,
+        )
+      ) {
+        findings.push(
+          finding(
+            file,
+            'removed-api',
+            'This unparsed file references removed APIs. Resolve it before changing dependencies.',
+            'block',
+          ),
+        );
+      }
+    }
+  } else if (path.basename(file) === 'package.json') {
+    const pkg = parseJson(source);
+    // Replace the BOM with one space for offset lookup, but retain it in the
+    // file. Edit only changed script values, preserving all other JSON trivia.
+    const tree = parseTree(source.replace(/^\uFEFF/, ' '));
+    const edits = [];
+    for (const [name, command] of Object.entries(record(pkg.scripts) ?? {})) {
+      if (typeof command !== 'string') {
+        continue;
+      }
+      const node = tree && findNodeAtLocation(tree, ['scripts', name]);
+      if (!node) {
+        continue;
+      }
+      const result = migrateVitestV5Command(
+        file,
+        command,
+        project.options.preserveV4,
+        source.slice(0, node.offset).split('\n').length,
+        project.options.preserveV4 || project.options.reviewV4,
+      );
+      findings.push(...result.findings);
+      if (result.content !== command) {
+        edits.push({
+          offset: node.offset,
+          length: node.length,
+          content: JSON.stringify(result.content),
+        });
+      }
+    }
+    content = applyEdits(source, edits);
+  } else if (/^tsconfig(?:\..+)?\.json$/.test(path.basename(file))) {
+    const types = record(record(parseJsonc(source))?.compilerOptions)?.types;
+    if (
+      Array.isArray(types) &&
+      types.includes('@testing-library/jest-dom') &&
+      !types.includes('@testing-library/jest-dom/vitest')
+    ) {
+      findings.push(
+        finding(
+          file,
+          'jest-dom-types',
+          'If this config checks Vitest tests, load @testing-library/jest-dom/vitest in compilerOptions.types or an included TypeScript setup file. The root jest-dom type entry augments Jest, not Vitest v5.',
+        ),
+      );
+    }
+  } else if (/\.ya?ml$/.test(file)) {
+    const document = parseDocument(source);
+    let changed = false;
+    visit(document, {
+      Pair(_key, pair) {
+        if (
+          !isScalar(pair.key) ||
+          !['run', 'script', 'command'].includes(String(pair.key.value)) ||
+          !isScalar(pair.value) ||
+          typeof pair.value.value !== 'string'
+        ) {
+          return;
+        }
+        const value = pair.value.value;
+        // A multiline shell block can contain functions or continued commands;
+        // report it as one compound command, not independent argv lines.
+        const result = migrateVitestV5Command(
+          file,
+          value.includes('\n') ? `(${value})` : value,
+          project.options.preserveV4,
+          source.slice(0, pair.key.range?.[0] ?? 0).split('\n').length,
+          project.options.preserveV4 || project.options.reviewV4,
+        );
+        findings.push(...result.findings);
+        if (!value.includes('\n') && result.content !== value) {
+          pair.value.value = result.content;
+          changed = true;
+        }
+      },
+    });
+    if (changed) {
+      content = document.toString();
+    }
+  } else if (file.endsWith('.sh')) {
+    findings.push(
+      ...migrateVitestV5Command(
+        file,
+        `(${source})`,
+        project.options.preserveV4,
+        1,
+        project.options.preserveV4 || project.options.reviewV4,
+      ).findings,
+    );
+  }
+  // Apply Node value edits after script rewriting so manifest offsets refer
+  // to the current text and neither pass can overwrite the other's changes.
+  return { content: migrateNode(file, content, findings), findings };
+}
+
+/** Read-only preflight. Call before package-manager conversion, installs,
+ * catalog updates, or generic import rewrites can erase the source version. */
+export function planVitestV5Migration(
+  workspace: MigrationWorkspace,
+  originalProjects?: ReadonlyMap<string, ProjectPlan>,
+): VitestV5MigrationPlan {
+  const findings: VitestV5Finding[] = [];
+  const directories = [
+    workspace.rootDir,
+    ...(workspace.packages ?? []).map((pkg) => path.resolve(workspace.rootDir, pkg.path)),
+  ];
+  const projects: ProjectPlan[] = [];
+  const changes: FileChange[] = [];
+  const projectSources = new Map(
+    [...new Set(directories)].map((directory) => [
+      directory,
+      new Map(filesInProject(directory).map((file) => [file, fs.readFileSync(file, 'utf8')])),
+    ]),
+  );
+  const allSources = new Map<string, string>();
+  for (const sources of projectSources.values()) {
+    for (const [file, source] of sources) {
+      allSources.set(file, source);
+    }
+  }
+  const configEntries = findVitestV5ConfigEntries(allSources, projectSources.keys());
+  const allConfigs = findVitestV5ConfigFiles(
+    allSources,
+    configEntries.flatMap((entry) => (entry.file ? [entry.file] : [])),
+  );
+  const mergedConfigs = findVitestV5MergedConfigFiles(allSources, allConfigs);
+  const browserPossible = [...allSources.values()].some((source) => BROWSER_SIGNAL.test(source));
+  const browserCliOverride = [...allSources].some(
+    ([file, source]) =>
+      /\.(?:json|ya?ml|sh)$/.test(file) &&
+      /\b(?:vitest|vp\s+test)\b[^\n]*--(?:no-)?browser(?:[.=\s'"]|$)/.test(source),
+  );
+  const testModesByVersion = new Map<boolean, ReturnType<typeof resolveVitestV5TestModes>>();
+  const inputs = new Map<string, string | null>(allSources);
+  for (const [directory, sources] of projectSources) {
+    const pkg = readJson(path.join(directory, 'package.json'));
+    const configFiles = new Set([...allConfigs].filter((file) => sources.has(file)));
+    const original = originalProjects?.get(directory);
+    const version = original
+      ? original.sourceVersion
+      : sourceVersion(directory, workspace.rootDir, pkg, workspace.packageManager);
+    const active =
+      original?.active ??
+      (!!dependency(pkg, 'vitest') ||
+        Object.values(record(pkg.scripts) ?? {}).some(
+          (command) => typeof command === 'string' && VITEST_COMMAND.test(command),
+        ) ||
+        [...sources].some(
+          ([file, source]) =>
+            (CODE_FILE.test(file) && hasVitestV5SourceUsage(file, source)) ||
+            (configFiles.has(file) && /\btest\s*:/.test(source)),
+        ));
+    const options: SourceOptions = {
+      // Only the resolved source runner authorizes v4 compatibility edits.
+      // The final scan disables edits while retaining this run's review context.
+      preserveV4: original?.options.preserveV4 ?? (!!version && semver.major(version) < 5),
+      reviewV4: !!version && semver.major(version) < 5,
+      browser: [...sources.values()].some((source) => BROWSER_SIGNAL.test(source)),
+      browserPossible,
+      temporalPolyfill: [...sources.values()].some((source) =>
+        /(?:['"]temporal-polyfill\/global['"]|(?:globalThis|global)\.Temporal\s*=|Object\.(?:assign|defineProperty)\(globalThis,\s*(?:\{\s*Temporal|['"]Temporal['"]))/.test(
+          source,
+        ),
+      ),
+    };
+    if (active && !version) {
+      findings.push(
+        finding(
+          path.join(directory, 'package.json'),
+          'source-version',
+          'Cannot determine the original Vitest version. Install the original lockfile, then re-run migration so v4 defaults are not applied to a v5 project.',
+          'block',
+        ),
+      );
+    }
+    if (active && version && semver.major(version) < 4) {
+      findings.push(
+        finding(
+          path.join(directory, 'package.json'),
+          'source-version',
+          'Upgrade the original project to Vitest 4 before running this migration.',
+          'block',
+        ),
+      );
+    }
+    const project = {
+      directory,
+      sourceVersion: version,
+      active,
+      options,
+      configFiles,
+      pendingSourceReviews: original?.pendingSourceReviews,
+    };
+    projects.push(project);
+    let testModes = testModesByVersion.get(options.preserveV4);
+    if (!testModes) {
+      testModes = resolveVitestV5TestModes(
+        allSources,
+        allConfigs,
+        options.preserveV4,
+        configEntries,
+      );
+      testModesByVersion.set(options.preserveV4, testModes);
+    }
+    for (const [file, source] of sources) {
+      // Ignore lockfile package snapshots; runtime and source checks belong to
+      // project files, not thousands of transitive package metadata entries.
+      if (/[/\\](?:pnpm-lock\.yaml|package-lock\.json|yarn\.lock|bun\.lock)$/.test(file)) {
+        continue;
+      }
+      const result = scanAndRewriteFile(
+        file,
+        source,
+        project,
+        { ...testModes.modes.get(file), ...(browserCliOverride ? { browser: undefined } : {}) },
+        mergedConfigs.has(file),
+      );
+      findings.push(...testModes.findings.filter((item) => item.file === file));
+      findings.push(...result.findings);
+      if (source !== result.content) {
+        changes.push({ file, before: source, after: result.content });
+      }
+    }
+  }
+  // Compose manifest edits with script/Node edits before producing one atomic
+  // preflight plan. This also runs for existing Vite+ projects and stateless reruns.
+  const rewrittenSources = new Map(allSources);
+  for (const change of changes) {
+    rewrittenSources.set(change.file, change.after);
+  }
+  findings.push(...migrateWebdriverioDependencies(workspace, rewrittenSources, inputs));
+  return {
+    rootDir: workspace.rootDir,
+    packageManager: workspace.packageManager,
+    projects,
+    findings,
+    changes: [...rewrittenSources].flatMap(([file, after]) => {
+      const before = allSources.get(file)!;
+      return before !== after ? [{ file, before, after }] : [];
+    }),
+    inputs,
+  };
+}
+
+export function formatVitestV5Findings(
+  plan: Pick<VitestV5MigrationPlan, 'rootDir' | 'findings'>,
+): string {
+  const unique = [
+    ...new Map(
+      plan.findings.map((item) => [
+        `${item.file}:${item.line}:${item.column}:${item.code}:${item.message}`,
+        item,
+      ]),
+    ).values(),
+  ];
+  if (!unique.length) {
+    return '';
+  }
+  const blocks = unique.filter((item) => item.severity === 'block').length;
+  const lines = [
+    `Vitest v5: ${unique.length} review item${unique.length === 1 ? '' : 's'}${blocks ? ` (${blocks} block dependency updates)` : ''}`,
+  ];
+  let previous = '';
+  for (const item of unique.toSorted(
+    (a, b) => a.file.localeCompare(b.file) || a.line - b.line || a.column - b.column,
+  )) {
+    if (item.file !== previous) {
+      lines.push(`\n${path.relative(plan.rootDir, item.file) || '.'}`);
+      previous = item.file;
+    }
+    lines.push(
+      `  ${item.line}:${item.column} ${item.severity === 'block' ? 'BLOCK' : 'REVIEW'} [${item.code}] ${item.message}`,
+      `    Docs: ${vitestV5Documentation(item.code)}`,
+    );
+  }
+  return lines.join('\n');
+}
+
+/** Apply a fully checked compatibility plan. Refuse stale input so an editor
+ * change cannot be overwritten between phases. */
+export function applyVitestV5Migration(plan: VitestV5MigrationPlan): number {
+  if (plan.findings.some((item) => item.severity === 'block')) {
+    throw new Error('Vitest v5 preflight has blocking findings. No migration edits were applied.');
+  }
+  for (const [file, before] of plan.inputs) {
+    const current = fs.existsSync(file) ? fs.readFileSync(file, 'utf8') : null;
+    if (current !== before) {
+      throw new Error(`Migration input changed: ${file}. Re-run vp migrate.`);
+    }
+  }
+  for (const change of plan.changes) {
+    fs.writeFileSync(change.file, change.after);
+  }
+  return plan.changes.length;
+}
+
+/** Upgrade runtime declarations before installers or tool migrators start.
+ * Keep source/config edits deferred until the tool version gates pass. */
+export function applyVitestV5NodeMigration(plan: VitestV5MigrationPlan): number {
+  const changes: FileChange[] = [];
+  for (const [file, before] of plan.inputs) {
+    if (
+      before === null ||
+      !['.node-version', '.nvmrc', 'package.json'].includes(path.basename(file))
+    ) {
+      continue;
+    }
+    const after = migrateNode(file, before, []);
+    if (after !== before) {
+      changes.push({ file, before, after });
+    }
+  }
+  return applyVitestV5Migration({ ...plan, changes });
+}
+
+/** Earlier setup/install steps can change manifests and configs. Re-plan from
+ * their current text without losing the runner version captured before install.
+ * Apply immediately afterward, so the normal stale-input guard still protects
+ * every write. Run this after the earlier tool migration gates have passed. */
+export function refreshVitestV5Migration(plan: VitestV5MigrationPlan): VitestV5MigrationPlan {
+  return planVitestV5Migration(
+    workspaceFromPlan(plan),
+    // Preserve both activity and version: removing a redundant runner must not
+    // erase pending compatibility work, and adding one to satisfy a peer does
+    // not prove the project previously used v4 defaults.
+    new Map(plan.projects.map((project) => [project.directory, project])),
+  );
+}
+
+export function vitestV5NeedsMigration(plan: VitestV5MigrationPlan): boolean {
+  return (
+    plan.changes.length > 0 ||
+    plan.projects.some((project) => project.active && project.options.preserveV4)
+  );
+}
+
+function currentProjectConfigs(plan: VitestV5MigrationPlan): Map<string, string[]> {
+  const filesByProject = new Map(
+    plan.projects.map((project) => [project.directory, filesInProject(project.directory)]),
+  );
+  const sources = new Map(
+    [...filesByProject.values()].flat().map((file) => [file, fs.readFileSync(file, 'utf8')]),
+  );
+  const entries = findVitestV5ConfigEntries(sources, filesByProject.keys());
+  const configs = findVitestV5ConfigFiles(
+    sources,
+    entries.flatMap((entry) => (entry.file ? [entry.file] : [])),
+  );
+  return new Map(
+    [...filesByProject].map(([directory, files]) => [
+      directory,
+      files.filter((file) => configs.has(file)),
+    ]),
+  );
+}
+
+/** Run after other migration steps create or merge configs. Keep the source
+ * version and deferred reviews in memory until the final report; no state file. */
+export function finishVitestV5Migration(plan: VitestV5MigrationPlan): VitestV5Finding[] {
+  const findings: VitestV5Finding[] = [];
+  const completedProjects = new Map<string, ProjectPlan>();
+  const projectConfigs = currentProjectConfigs(plan);
+  const configSources = new Map(
+    [...projectConfigs.values()].flat().map((file) => [file, fs.readFileSync(file, 'utf8')]),
+  );
+  const mergedConfigs = findVitestV5MergedConfigFiles(configSources, new Set(configSources.keys()));
+  for (const project of plan.projects) {
+    if (!project.active || !project.sourceVersion) {
+      continue;
+    }
+    const configs = projectConfigs.get(project.directory)!;
+    for (const file of configs) {
+      const before = fs.readFileSync(file, 'utf8');
+      try {
+        const result = migrateVitestV5Config(
+          file,
+          before,
+          project.options,
+          mergedConfigs.has(file),
+        );
+        findings.push(...result.findings);
+        if (
+          !result.findings.some((finding) => finding.severity === 'block') &&
+          result.content !== before
+        ) {
+          fs.writeFileSync(file, result.content);
+        }
+      } catch (error) {
+        findings.push(finding(file, 'source-parse', `Review this config: ${String(error)}`));
+      }
+    }
+    // An unanchored root rule already covers workspace packages. Stop at the
+    // nearest Git root (including nested repositories), or the workspace root
+    // for projects that do not use Git yet.
+    if (
+      !isDirectoryGitignored(
+        findGitRoot(project.directory) ?? plan.rootDir,
+        path.join(project.directory, '.vitest'),
+      )
+    ) {
+      const ignore = path.join(project.directory, '.gitignore');
+      const ignored = fs.existsSync(ignore) ? fs.readFileSync(ignore, 'utf8') : '';
+      fs.writeFileSync(
+        ignore,
+        `${ignored}${ignored && !ignored.endsWith('\n') ? '\n' : ''}.vitest/\n`,
+      );
+    }
+    const pendingSourceReviews: Record<string, string[]> = {};
+    for (const item of plan.findings) {
+      if (
+        !DEFERRED_SOURCE_REVIEWS.has(item.code) ||
+        !item.file.startsWith(`${project.directory}${path.sep}`)
+      ) {
+        continue;
+      }
+      if (
+        plan.projects.some(
+          (other) =>
+            other !== project &&
+            other.directory.startsWith(`${project.directory}${path.sep}`) &&
+            item.file.startsWith(`${other.directory}${path.sep}`),
+        )
+      ) {
+        continue;
+      }
+      const relative = path.relative(project.directory, item.file).replaceAll('\\', '/');
+      pendingSourceReviews[relative] ??= [];
+      if (!pendingSourceReviews[relative].includes(item.code)) {
+        pendingSourceReviews[relative].push(item.code);
+      }
+    }
+    completedProjects.set(project.directory, {
+      ...project,
+      options: { ...project.options, preserveV4: false },
+      pendingSourceReviews,
+    });
+  }
+  // Preserve inactive projects too: newly installed peers do not establish
+  // original test usage. The next invocation redetects versions from scratch.
+  const after = planVitestV5Migration(
+    workspaceFromPlan(plan),
+    new Map(
+      plan.projects.map((project) => [
+        project.directory,
+        completedProjects.get(project.directory) ?? project,
+      ]),
+    ),
+  );
+  return [...findings, ...after.findings];
+}
diff --git a/packages/cli/src/migration/migrator/yarn.ts b/packages/cli/src/migration/migrator/yarn.ts
index 171fbe6b09..d01a39635c 100644
--- a/packages/cli/src/migration/migrator/yarn.ts
+++ b/packages/cli/src/migration/migrator/yarn.ts
@@ -22,6 +22,7 @@ import {
 import { type MigrationReport } from '../report.ts';
 import {
   WEBDRIVERIO_PROVIDER,
+  findDeclaredSpec,
   readPackageJsonIfExists,
   warnMigration,
   type DependencyBag,
@@ -31,12 +32,24 @@ import {
 const WEBDRIVERIO_PEER_DEP = 'webdriverio';
 
 // Dependencies whose presence before migration signals the user will end up
-// with webdriverio after migration. `@vitest/browser-webdriverio` is the opt-in
-// provider vite-plus keeps in the user's deps (pinned to the bundled vitest)
-// and `webdriverio` is its runtime peer (added via `BROWSER_PROVIDER_PEER_DEPS`);
-// either one means the edgedriver/geckodriver postinstalls must be allowed.
+// with WebDriverIO. Both the community provider and its framework need driver
+// postinstalls, regardless of which one the project declares directly.
 const WEBDRIVERIO_ALLOW_SIGNAL_DEPS = [WEBDRIVERIO_PEER_DEP, WEBDRIVERIO_PROVIDER] as const;
 
+// A standalone WebDriverIO installation does not use Vitest's browser package.
+// Only the provider (or its legacy imports) needs the shared browser override.
+export function workspaceUsesWebdriverioProvider(
+  rootDir: string,
+  packages?: WorkspacePackage[],
+): boolean {
+  return [rootDir, ...(packages ?? []).map((pkg) => path.join(rootDir, pkg.path))].some((dir) => {
+    const pkg = readPackageJsonIfExists(path.join(dir, 'package.json'));
+    return Boolean(
+      (pkg && findDeclaredSpec(pkg, WEBDRIVERIO_PROVIDER)) || usesWebdriverioProvider(dir),
+    );
+  });
+}
+
 export function hasOwnWebdriverioDependency(pkg: DependencyBag): boolean {
   for (const name of WEBDRIVERIO_ALLOW_SIGNAL_DEPS) {
     if (
@@ -61,8 +74,7 @@ export function workspaceUsesWebdriverio(
   }
   // Source-only signal: a package may target the webdriverio provider purely
   // through imports (e.g. `vite-plus/test/browser-webdriverio`) without a
-  // declared dep yet. The migration injects the provider for those, so the
-  // driver postinstalls must be allowed too.
+  // declared dep yet. Allow driver builds when the user installs the provider.
   if (usesWebdriverioProvider(rootDir)) {
     return true;
   }
diff --git a/packages/cli/src/migration/vitest-v5/ast.ts b/packages/cli/src/migration/vitest-v5/ast.ts
new file mode 100644
index 0000000000..278d468845
--- /dev/null
+++ b/packages/cli/src/migration/vitest-v5/ast.ts
@@ -0,0 +1,587 @@
+import type * as t from '@oxc-project/types';
+
+import { analyzeMigrationSource } from '../../../binding/index.js';
+
+interface SourceAnalysis {
+  ast: { node: t.Program };
+  comments: t.Span[];
+  bindings: Array<{ start: number; references: number[]; constant: boolean }>;
+}
+
+interface Binding {
+  declaration: t.Node;
+  references: t.Node[];
+  constant: boolean;
+}
+
+interface ParsedSource {
+  program: t.Program;
+  bindings: SourceAnalysis['bindings'];
+  comments: t.Span[];
+}
+
+type Visitors = {
+  [Type in t.Node['type']]?: (node: Extract<t.Node, { type: Type }>) => void;
+};
+
+function isNode(value: unknown): value is t.Node {
+  return typeof value === 'object' && value !== null && 'type' in value && 'start' in value;
+}
+
+export function isString(node: t.Node | null | undefined): node is t.StringLiteral {
+  return node?.type === 'Literal' && typeof node.value === 'string';
+}
+
+export function isBoolean(node: t.Node | null | undefined): node is t.BooleanLiteral {
+  return node?.type === 'Literal' && typeof node.value === 'boolean';
+}
+
+export function isRegExp(node: t.Node | null | undefined): node is t.RegExpLiteral {
+  return node?.type === 'Literal' && 'regex' in node;
+}
+
+export interface VitestV5Finding {
+  file: string;
+  line: number;
+  column: number;
+  code: string;
+  severity: 'review' | 'block';
+  message: string;
+}
+
+export interface RewriteResult {
+  content: string;
+  findings: VitestV5Finding[];
+}
+
+export interface SourceOptions {
+  preserveV4: boolean;
+  reviewV4?: boolean;
+  browser?: boolean;
+  browserPossible?: boolean;
+  globals?: boolean;
+  reviewGlobals?: boolean;
+  temporalPolyfill?: boolean;
+}
+
+export function propertyName(node: t.Node | null | undefined): string | undefined {
+  if (node?.type === 'Identifier') {
+    return node.name;
+  }
+  if (isString(node)) {
+    return node.value;
+  }
+  return undefined;
+}
+
+export function memberName(node: t.Node | null | undefined): string | undefined {
+  if (node?.type !== 'MemberExpression') {
+    return undefined;
+  }
+  if (node.computed && !isString(node.property)) {
+    return undefined;
+  }
+  return propertyName(node.property);
+}
+
+export function isModuleExports(editor: SourceEditor, node: t.Node): boolean {
+  return (
+    node.type === 'MemberExpression' &&
+    !node.computed &&
+    node.object.type === 'Identifier' &&
+    node.object.name === 'module' &&
+    propertyName(node.property) === 'exports' &&
+    !editor.binding(node.object)
+  );
+}
+
+export function objectProperty(
+  object: t.ObjectExpression,
+  key: string,
+): t.ObjectProperty | undefined {
+  return object.properties.find(
+    (prop): prop is t.ObjectProperty =>
+      prop.type === 'Property' &&
+      prop.kind === 'init' &&
+      !prop.computed &&
+      propertyName(prop.key) === key,
+  );
+}
+
+export function staticObject(
+  node: t.Node | null | undefined,
+  allowMethods = false,
+): node is t.ObjectExpression {
+  if (node?.type !== 'ObjectExpression') {
+    return false;
+  }
+  const names = new Set<string>();
+  return node.properties.every((prop) => {
+    if (
+      prop.type !== 'Property' ||
+      (prop.method && !allowMethods) ||
+      prop.kind !== 'init' ||
+      prop.computed
+    ) {
+      return false;
+    }
+    const name = propertyName(prop.key);
+    if (name === undefined || names.has(name)) {
+      return false;
+    }
+    names.add(name);
+    return true;
+  });
+}
+
+/** Consider both possible project lists without evaluating environment-dependent
+ * config code. Unknown spreads stay in the list for a localized review. */
+export function projectElements(node: t.ArrayExpression): Array<t.Node | null> {
+  const expand = (value: t.Node): Array<t.Node | null> | undefined => {
+    if (value.type === 'ArrayExpression') {
+      return projectElements(value);
+    }
+    if (value.type === 'ConditionalExpression') {
+      const consequent = expand(value.consequent);
+      const alternate = expand(value.alternate);
+      // Conditional exclusions affect sibling string projects. Flattening them
+      // would incorrectly exclude files when that branch is inactive.
+      if (
+        consequent &&
+        alternate &&
+        ![...consequent, ...alternate].some(
+          (entry) => isString(entry) && entry.value.startsWith('!'),
+        )
+      ) {
+        return [...consequent, ...alternate];
+      }
+    }
+    return undefined;
+  };
+  return node.elements.flatMap((entry) =>
+    entry?.type === 'SpreadElement' ? (expand(entry.argument) ?? [entry]) : [entry],
+  );
+}
+
+/** Compare data literals without evaluating config code or invoking getters.
+ * Property order and spelling do not change the value of a plain config object. */
+export function sameStaticValue(left: t.Node, right: t.Node): boolean {
+  if (left.type === 'Literal' && right.type === 'Literal') {
+    return (
+      !('regex' in left || 'regex' in right || 'bigint' in left || 'bigint' in right) &&
+      Object.is(left.value, right.value)
+    );
+  }
+  if (left.type === 'UnaryExpression' && right.type === 'UnaryExpression') {
+    return (
+      ['+', '-'].includes(left.operator) &&
+      left.operator === right.operator &&
+      left.argument.type === 'Literal' &&
+      typeof left.argument.value === 'number' &&
+      sameStaticValue(left.argument, right.argument)
+    );
+  }
+  if (left.type === 'ArrayExpression' && right.type === 'ArrayExpression') {
+    return (
+      left.elements.length === right.elements.length &&
+      left.elements.every((element, index) => {
+        const other = right.elements[index];
+        return !!element && !!other && sameStaticValue(element, other);
+      })
+    );
+  }
+  if (staticObject(left) && staticObject(right)) {
+    return (
+      left.properties.length === right.properties.length &&
+      left.properties.every((property) => {
+        const prop = property as t.ObjectProperty;
+        const other = objectProperty(right, propertyName(prop.key)!);
+        return !!other && sameStaticValue(prop.value, other.value);
+      })
+    );
+  }
+  return false;
+}
+
+export function importedName(
+  editor: SourceEditor,
+  node: t.Node | null | undefined,
+  sources: ReadonlySet<string>,
+): string | undefined {
+  if (
+    node?.type === 'MemberExpression' &&
+    !node.optional &&
+    !node.computed &&
+    node.object.type === 'Identifier'
+  ) {
+    const declaration = editor.binding(node.object)?.declaration;
+    const parent = declaration && editor.parent(declaration);
+    if (
+      declaration?.type === 'ImportNamespaceSpecifier' &&
+      parent?.type === 'ImportDeclaration' &&
+      parent.importKind !== 'type' &&
+      sources.has(parent.source.value)
+    ) {
+      return propertyName(node.property);
+    }
+  }
+  if (node?.type !== 'Identifier') {
+    return undefined;
+  }
+  const declaration = editor.binding(node)?.declaration;
+  const parent = declaration && editor.parent(declaration);
+  if (declaration?.type !== 'ImportSpecifier' || parent?.type !== 'ImportDeclaration') {
+    return undefined;
+  }
+  if (declaration.importKind === 'type' || parent.importKind === 'type') {
+    return undefined;
+  }
+  if (sources.has(parent.source.value)) {
+    return propertyName(declaration.imported);
+  }
+  return undefined;
+}
+
+export const ROOT_TEST_SOURCES = new Set(['vitest', 'vite-plus/test', '@vitest/runner']);
+export const CONFIG_SOURCES = new Set([
+  'vitest/config',
+  'vite-plus',
+  'vite-plus/test/config',
+  'vite',
+]);
+export const NODE_SOURCES = new Set(['vitest/node', 'vite-plus/test/node']);
+
+export function parseSource(file: string, source: string): ParsedSource {
+  // Native errors (including unsupported Flow) reach the existing preflight
+  // diagnostic path, which preserves the original file for manual review.
+  const { ast, bindings, comments } = JSON.parse(
+    analyzeMigrationSource(file, source),
+  ) as SourceAnalysis;
+  // Migration uses source spelling and regex metadata, not the JS-only fixes
+  // that reconstruct RegExp/BigInt values in Oxc's serialized AST.
+  return { program: ast.node, bindings, comments };
+}
+
+export function testApiName(
+  editor: SourceEditor,
+  node: t.Node | null | undefined,
+  globals = false,
+): string | undefined {
+  const imported = importedName(editor, node, ROOT_TEST_SOURCES);
+  if (imported) {
+    return imported;
+  }
+  if (node?.type === 'MemberExpression' && !node.optional && isImportMetaVitest(node.object)) {
+    return memberName(node);
+  }
+  const binding = node && editor.binding(node);
+  const property = binding?.declaration;
+  const pattern = property && editor.parent(property);
+  const declaration = pattern && editor.parent(pattern);
+  if (
+    binding?.constant &&
+    property?.type === 'Property' &&
+    !property.computed &&
+    property.value.type === 'Identifier' &&
+    pattern?.type === 'ObjectPattern' &&
+    declaration?.type === 'VariableDeclarator' &&
+    isImportMetaVitest(declaration.init)
+  ) {
+    return propertyName(property.key);
+  }
+  if (globals && node?.type === 'Identifier' && !editor.binding(node)) {
+    return node.name;
+  }
+  return undefined;
+}
+
+export function isImportMetaVitest(node: t.Node | null | undefined): boolean {
+  return (
+    node?.type === 'MemberExpression' &&
+    !node.optional &&
+    memberName(node) === 'vitest' &&
+    node.object.type === 'MetaProperty' &&
+    node.object.meta.name === 'import' &&
+    node.object.property.name === 'meta'
+  );
+}
+
+export interface AddedProperty {
+  key: string;
+  value: string | AddedProperty[];
+  comment?: string;
+}
+
+function printAddedProperty(property: AddedProperty, indent: string, newline: string): string {
+  const comment = property.comment
+    ? `${property.comment.replaceAll('\n', `${newline}${indent}`)}${newline}${indent}`
+    : '';
+  const value =
+    typeof property.value === 'string'
+      ? property.value
+      : printAddedObject(property.value, indent, newline);
+  return `${comment}${property.key}: ${value}`;
+}
+
+/** Format generated objects without reindenting copied expressions or string literals. */
+export function printAddedObject(properties: AddedProperty[], indent = '', newline = '\n'): string {
+  const childIndent = `${indent}  `;
+  return `{${newline}${properties
+    .map((property) => `${childIndent}${printAddedProperty(property, childIndent, newline)}`)
+    .join(`,${newline}`)}${newline}${indent}}`;
+}
+
+/** Offset edits retain comments and formatting outside the precise changed span. */
+export class SourceEditor {
+  readonly ast: t.Program;
+  readonly comments: t.Span[];
+  readonly findings: VitestV5Finding[] = [];
+  private readonly nodes: t.Node[] = [];
+  private readonly parents = new Map<t.Node, t.Node>();
+  private readonly bindings = new Map<number, Binding>();
+  private readonly names = new Set<string>();
+  private readonly edits: Array<{ start: number; end: number; text: string }> = [];
+  private readonly additions = new Map<t.ObjectExpression, Map<string, AddedProperty>>();
+
+  constructor(
+    readonly file: string,
+    readonly source: string,
+  ) {
+    const parsed = parseSource(file, source);
+    this.ast = parsed.program;
+    this.comments = parsed.comments;
+    const identifiers = new Map<number, t.Node>();
+    const index = (node: t.Node, parent?: t.Node) => {
+      this.nodes.push(node);
+      if (parent) {
+        this.parents.set(node, parent);
+      }
+      if (node.type === 'Identifier') {
+        identifiers.set(node.start, node);
+        this.names.add(node.name);
+      }
+      for (const value of Object.values(node)) {
+        for (const child of Array.isArray(value) ? value : [value]) {
+          if (isNode(child)) {
+            index(child, node);
+          }
+        }
+      }
+    };
+    index(this.ast);
+    for (const binding of parsed.bindings) {
+      const identifier = identifiers.get(binding.start);
+      const declaration = identifier && this.parent(identifier);
+      if (!declaration) {
+        continue;
+      }
+      const references = binding.references.map((start) => identifiers.get(start)).filter(isNode);
+      const resolved = { declaration, references, constant: binding.constant };
+      for (const start of [binding.start, ...binding.references]) {
+        this.bindings.set(start, resolved);
+      }
+    }
+  }
+
+  visit(visitors: Visitors): void {
+    for (const node of this.nodes) {
+      // Dispatch by the same discriminant that selects the visitor's node type.
+      const visitor = visitors[node.type] as ((node: t.Node) => void) | undefined;
+      visitor?.(node);
+    }
+  }
+
+  parent(node: t.Node): t.Node | undefined {
+    return this.parents.get(node);
+  }
+
+  functionParent(node: t.Node): t.Function | t.ArrowFunctionExpression | undefined {
+    let parent = this.parent(node);
+    while (parent) {
+      if (
+        parent.type === 'FunctionDeclaration' ||
+        parent.type === 'FunctionExpression' ||
+        parent.type === 'ArrowFunctionExpression'
+      ) {
+        return parent;
+      }
+      parent = this.parent(parent);
+    }
+    return undefined;
+  }
+
+  binding(node: t.Node): Binding | undefined {
+    return node.type === 'Identifier' ? this.bindings.get(node.start) : undefined;
+  }
+
+  uniqueName(base: string, preferBase = false): string {
+    let name = preferBase && !this.names.has(base) ? base : `_${base}`;
+    let suffix = 2;
+    while (this.names.has(name)) {
+      name = `_${base}${suffix++}`;
+    }
+    this.names.add(name);
+    return name;
+  }
+
+  text(node: t.Node): string {
+    return this.source.slice(node.start, node.end);
+  }
+
+  replace(node: t.Node, text: string): void {
+    this.edit(node.start, node.end, text);
+  }
+
+  edit(start: number, end: number, text: string): void {
+    const same = this.edits.find((edit) => edit.start === start && edit.end === end);
+    if (same?.text === text) {
+      return;
+    }
+    if (same && start === end) {
+      same.text += text;
+      return;
+    }
+    this.edits.push({ start, end, text });
+  }
+
+  add(
+    object: t.ObjectExpression,
+    key: string,
+    value: AddedProperty['value'],
+    comment?: string,
+  ): void {
+    if (objectProperty(object, key)) {
+      return;
+    }
+    let additions = this.additions.get(object);
+    if (!additions) {
+      additions = new Map();
+      this.additions.set(object, additions);
+    }
+    additions.set(key, { key, value, comment });
+  }
+
+  remove(object: t.ObjectExpression, prop: t.ObjectProperty): void {
+    const index = object.properties.indexOf(prop);
+    const nextStart = object.properties[index + 1]?.start ?? object.end - 1;
+    const previousEnd = object.properties[index - 1]?.end ?? object.start + 1;
+    // Between complete property spans only trivia and punctuation can occur.
+    // Skip Oxc's comment spans so a comma inside a comment is never removed.
+    const commaBetween = (start: number, end: number) => {
+      for (let index = start; index < end; index++) {
+        const comment = this.comments.find((span) => span.start <= index && index < span.end);
+        if (comment) {
+          index = comment.end - 1;
+        } else if (this.source[index] === ',') {
+          return index;
+        }
+      }
+      return undefined;
+    };
+    const followingComma = commaBetween(prop.end, nextStart);
+    const precedingComma = commaBetween(previousEnd, prop.start);
+    this.replace(prop, '');
+    const comma = followingComma ?? precedingComma;
+    if (comma !== undefined) {
+      this.edit(comma, comma + 1, '');
+    }
+  }
+
+  report(
+    node: t.Node | undefined,
+    code: string,
+    message: string,
+    severity: VitestV5Finding['severity'] = 'review',
+  ): void {
+    const prefix = this.source.slice(0, node?.start ?? 0);
+    const lines = prefix.split(/\r\n|[\r\n\u2028\u2029]/);
+    const line = lines.length;
+    const column = lines.at(-1)!.length + 1;
+    if (
+      !this.findings.some(
+        (item) =>
+          item.line === line &&
+          item.column === column &&
+          item.code === code &&
+          item.message === message,
+      )
+    ) {
+      this.findings.push({ file: this.file, line, column, code, severity, message });
+    }
+  }
+
+  finish(): RewriteResult {
+    for (const [object, additions] of this.additions) {
+      const start = object.start + 1;
+      const first = object.properties[0]?.start ?? object.end - 1;
+      const prefix = this.source.slice(start, first);
+      const newline = this.source.includes('\r\n') ? '\r\n' : '\n';
+      const multilinePrefix = prefix.includes('\n');
+      const multiline =
+        multilinePrefix ||
+        [...additions.values()].some(({ comment, value }) => comment || Array.isArray(value));
+      const indent =
+        this.source.slice(this.source.lastIndexOf('\n', first) + 1, first).match(/^[\t ]*/)?.[0] ??
+        '';
+      let objectIndent = indent;
+      if (!multilinePrefix) {
+        // Nested inline objects share a source line. Account for their depth
+        // when generated comments expand them onto separate lines.
+        const lineStart = this.source.lastIndexOf('\n', object.start) + 1;
+        let parent = this.parent(object);
+        while (parent && parent.start >= lineStart) {
+          if (parent.type === 'ObjectExpression') {
+            objectIndent += '  ';
+          }
+          parent = this.parent(parent);
+        }
+      }
+      const propertyIndent =
+        multilinePrefix && object.properties.length ? indent : `${objectIndent}  `;
+      const entries = [...additions.values()].map((property) =>
+        printAddedProperty(property, propertyIndent, newline),
+      );
+      // A generated line comment must end before the original inline properties
+      // or closing brace. Keep the original trivia, including existing comments.
+      const suffix =
+        multiline && !multilinePrefix
+          ? `${newline}${object.properties.length ? propertyIndent : objectIndent}`
+          : '';
+      this.edit(
+        start,
+        multiline && !multilinePrefix && /^\s*$/.test(prefix) ? first : start,
+        multiline
+          ? `${newline}${propertyIndent}${entries.join(`,${newline}${propertyIndent}`)}${object.properties.length ? ',' : ''}${suffix}`
+          : ` ${entries.join(', ')}${object.properties.length ? ',' : ''} `,
+      );
+    }
+    const edits = this.edits.toSorted((a, b) => b.start - a.start || b.end - a.end);
+    let result = this.source;
+    let previousStart = this.source.length + 1;
+    for (const edit of edits) {
+      if (edit.end > previousStart) {
+        this.report(
+          undefined,
+          'overlapping-edits',
+          'Review the overlapping Vitest transformations; this file was not changed.',
+        );
+        return { content: this.source, findings: this.findings };
+      }
+      result = result.slice(0, edit.start) + edit.text + result.slice(edit.end);
+      previousStart = edit.start;
+    }
+    if (result !== this.source) {
+      try {
+        parseSource(this.file, result);
+      } catch {
+        this.report(
+          undefined,
+          'unsafe-syntax',
+          'The proposed transform did not parse. Review this file manually; it was not changed.',
+        );
+        return { content: this.source, findings: this.findings };
+      }
+    }
+    return { content: result, findings: this.findings };
+  }
+}
diff --git a/packages/cli/src/migration/vitest-v5/benchmark-config.ts b/packages/cli/src/migration/vitest-v5/benchmark-config.ts
new file mode 100644
index 0000000000..b1ea1c5781
--- /dev/null
+++ b/packages/cli/src/migration/vitest-v5/benchmark-config.ts
@@ -0,0 +1,111 @@
+import type * as t from '@oxc-project/types';
+
+import { SourceEditor, isString, objectProperty, staticObject } from './ast.ts';
+
+const REPORTERS = new Set([
+  'default',
+  'verbose',
+  'dot',
+  'json',
+  'junit',
+  'tap',
+  'tap-flat',
+  'hanging-process',
+  'github-actions',
+]);
+
+function reporterNames(node: t.Node): string[] | undefined {
+  const entries = node.type === 'ArrayExpression' ? node.elements : [node];
+  return entries.every(isString) ? entries.map((entry) => entry.value) : undefined;
+}
+
+/** Move only resolved built-in output settings. The normal config pass reports
+ * any retained legacy options as blockers; no partial output plan is applied. */
+export function migrateBenchmarkConfig(editor: SourceEditor, test: t.ObjectExpression): void {
+  const benchmark = objectProperty(test, 'benchmark')?.value;
+  if (!staticObject(benchmark)) {
+    return;
+  }
+  const oldReporters = objectProperty(benchmark, 'reporters');
+  const oldOutput = objectProperty(benchmark, 'outputFile');
+  const oldJson = objectProperty(benchmark, 'outputJson');
+  if (!oldReporters && !oldOutput && !oldJson) {
+    return;
+  }
+  const benchmarkNames = oldReporters ? reporterNames(oldReporters.value) : ['default'];
+  if (
+    !benchmarkNames?.length ||
+    benchmarkNames.some((name) => !['default', 'verbose'].includes(name))
+  ) {
+    return;
+  }
+  let destination: string | undefined;
+  for (const prop of [oldOutput, oldJson]) {
+    if (!prop) {
+      continue;
+    }
+    if (
+      !isString(prop.value) ||
+      !prop.value.value ||
+      (destination !== undefined && destination !== prop.value.value)
+    ) {
+      return;
+    }
+    destination = prop.value.value;
+  }
+  const reporters = objectProperty(test, 'reporters');
+  const names = reporters ? reporterNames(reporters.value) : benchmarkNames;
+  if (!names || names.some((name) => !REPORTERS.has(name))) {
+    return;
+  }
+  const terminal = names.filter((name) => ['default', 'verbose', 'dot'].includes(name));
+  if (reporters && oldReporters && terminal.some((name) => !benchmarkNames.includes(name))) {
+    return;
+  }
+  const output = objectProperty(test, 'outputFile');
+  const jsonOutput =
+    output &&
+    (staticObject(output.value) ? objectProperty(output.value, 'json')?.value : output.value);
+  if (destination) {
+    if (
+      (jsonOutput && (!isString(jsonOutput) || jsonOutput.value !== destination)) ||
+      (output && !isString(output.value) && !staticObject(output.value))
+    ) {
+      return;
+    }
+  }
+  const combined = [
+    ...new Set([
+      ...names,
+      ...(terminal.length && !oldReporters ? [] : benchmarkNames),
+      ...(destination ? ['json'] : []),
+    ]),
+  ];
+  if (reporters) {
+    if (combined.join('\0') !== names.join('\0')) {
+      // Refuse to discard comments while replacing a literal reporter list.
+      if (
+        editor.comments.some(
+          ({ start, end }) => start >= reporters.value.start && end <= reporters.value.end,
+        )
+      ) {
+        return;
+      }
+      editor.replace(reporters.value, JSON.stringify(combined));
+    }
+  } else {
+    editor.add(test, 'reporters', JSON.stringify(combined));
+  }
+  if (destination && !jsonOutput) {
+    if (output && staticObject(output.value)) {
+      editor.add(output.value, 'json', JSON.stringify(destination));
+    } else {
+      editor.add(test, 'outputFile', `{ json: ${JSON.stringify(destination)} }`);
+    }
+  }
+  for (const prop of [oldReporters, oldOutput, oldJson]) {
+    if (prop) {
+      editor.remove(benchmark, prop);
+    }
+  }
+}
diff --git a/packages/cli/src/migration/vitest-v5/benchmarks.ts b/packages/cli/src/migration/vitest-v5/benchmarks.ts
new file mode 100644
index 0000000000..529c100554
--- /dev/null
+++ b/packages/cli/src/migration/vitest-v5/benchmarks.ts
@@ -0,0 +1,274 @@
+import type * as t from '@oxc-project/types';
+
+import {
+  SourceEditor,
+  isImportMetaVitest,
+  isString,
+  memberName,
+  propertyName,
+  testApiName,
+} from './ast.ts';
+
+interface BenchmarkCall {
+  call: t.CallExpression;
+  modifier?: string;
+}
+
+/** Keep the workload as a separate callback: making it the test callback
+ * would measure nothing, and inlining it into a new closure can change scope. */
+export function migrateBenchmarks(
+  editor: SourceEditor,
+  globals = false,
+): {
+  imports: Set<t.ImportSpecifier>;
+  bindings: Set<t.BindingProperty>;
+  calls: Set<t.CallExpression>;
+} {
+  const imports = new Set<t.ImportSpecifier>();
+  const bindings = new Set<t.BindingProperty>();
+  const calls = new Set<t.CallExpression>();
+  const benchIdentifiers: t.Span[] = [];
+  let fixtureAlias: string | undefined;
+  let shadowedGlobalThis = false;
+  editor.visit({
+    Identifier(node) {
+      if (node.name === 'bench') {
+        benchIdentifiers.push(node);
+      }
+      if (node.name === 'globalThis' && editor.binding(node)) {
+        shadowedGlobalThis = true;
+      }
+    },
+  });
+
+  function workload(node: t.Node, seen = new Set<t.Node>()): boolean {
+    if (
+      node.type === 'ArrowFunctionExpression' ||
+      node.type === 'FunctionExpression' ||
+      node.type === 'FunctionDeclaration'
+    ) {
+      return !!node.body && node.params.length === 0 && !node.generator;
+    }
+    if (node.type !== 'Identifier' || seen.has(node)) {
+      return false;
+    }
+    seen.add(node);
+    const binding = editor.binding(node);
+    if (!binding?.constant) {
+      return false;
+    }
+    const declaration = binding.declaration;
+    if (declaration.type === 'FunctionDeclaration') {
+      return workload(declaration, seen);
+    }
+    return (
+      declaration.type === 'VariableDeclarator' &&
+      !!declaration.init &&
+      workload(declaration.init, seen)
+    );
+  }
+
+  function directCall(reference: t.Node): BenchmarkCall | undefined {
+    let callee = reference;
+    let modifier: string | undefined;
+    const member = editor.parent(reference);
+    if (member?.type === 'MemberExpression' && member.object === reference) {
+      modifier = memberName(member);
+      if (member.optional || !modifier || !['skip', 'only', 'todo'].includes(modifier)) {
+        return undefined;
+      }
+      callee = member;
+    }
+    const call = editor.parent(callee);
+    if (
+      call?.type !== 'CallExpression' ||
+      call.callee !== callee ||
+      call.optional ||
+      call.typeArguments ||
+      editor.parent(call)?.type !== 'ExpressionStatement' ||
+      !call.arguments[0] ||
+      call.arguments[0].type === 'SpreadElement'
+    ) {
+      return undefined;
+    }
+    const callback = call.arguments[1];
+    if (!(modifier === 'todo' && call.arguments.length === 1)) {
+      if (call.arguments.length !== 2 || !callback || !workload(callback)) {
+        return undefined;
+      }
+    }
+    // Register only at module scope or inside ordinary describe/suite
+    // callbacks. Calls from helpers, hooks, or other benchmarks need review.
+    let fn = editor.functionParent(call);
+    while (fn) {
+      const registration = editor.parent(fn);
+      if (
+        fn.async ||
+        fn.generator ||
+        registration?.type !== 'CallExpression' ||
+        registration.optional ||
+        !registration.arguments.includes(fn)
+      ) {
+        return undefined;
+      }
+      let suite = registration.callee;
+      if (!['describe', 'suite'].includes(testApiName(editor, suite, globals) ?? '')) {
+        if (
+          suite.type !== 'MemberExpression' ||
+          suite.optional ||
+          !['skip', 'only'].includes(memberName(suite) ?? '')
+        ) {
+          return undefined;
+        }
+        suite = suite.object;
+      }
+      if (!['describe', 'suite'].includes(testApiName(editor, suite, globals) ?? '')) {
+        return undefined;
+      }
+      fn = editor.functionParent(registration);
+    }
+    return { call, modifier };
+  }
+
+  function rewrite({ call, modifier }: BenchmarkCall, test: string) {
+    calls.add(call);
+    editor.replace(call.callee, `${test}${modifier ? `.${modifier}` : ''}`);
+    const callback = call.arguments[1];
+    if (!callback) {
+      return;
+    }
+    let name = editor.text(call.arguments[0]);
+    const captures: string[] = [];
+    if (!isString(call.arguments[0])) {
+      const captured = editor.uniqueName('benchName');
+      captures.push(`const ${captured} = (${name});`);
+      editor.replace(call.arguments[0], captured);
+      name = captured;
+    }
+    if (callback.type === 'Identifier') {
+      const captured = editor.uniqueName('benchFn');
+      captures.push(`const ${captured} = ${editor.text(callback)};`);
+      editor.replace(callback, captured);
+    }
+    if (captures.length) {
+      // Capture at registration, in the original lexical scope and argument
+      // order. A test executes later, after names or callback bindings may change.
+      const statement = editor.parent(call)!;
+      editor.edit(statement.start, statement.start, `{ ${captures.join(' ')} `);
+      editor.edit(statement.end, statement.end, ' }');
+    }
+    // Only inline workloads move into the fixture's scope. Named workloads
+    // keep their original scope through the callback captured above.
+    const shadowsBench =
+      callback.type !== 'Identifier' &&
+      benchIdentifiers.some((node) => node.start >= callback.start && node.end <= callback.end);
+    let fixtureName = 'bench';
+    if (shadowsBench) {
+      fixtureName = fixtureAlias ??= editor.uniqueName('bench');
+    }
+    const fixture = fixtureName === 'bench' ? 'bench' : `bench: ${fixtureName}`;
+    editor.edit(
+      callback.start,
+      callback.start,
+      `async ({ ${fixture} }) => { await ${fixtureName}(${name}, `,
+    );
+    // Keep surrounding parentheses and trailing comments around the new test
+    // callback by inserting both ends of the wrapper at the callback's span.
+    editor.edit(callback.end, callback.end, ').run(); }');
+  }
+
+  function unsupportedInSource(node: t.Node) {
+    editor.report(
+      node,
+      'benchmark-api',
+      'Migrate this import.meta.vitest bench reference manually: automatic migration requires direct calls with locally resolved zero-argument callbacks and no benchmark options or escaped references. Keep the import.meta.vitest guard.',
+      'block',
+    );
+  }
+
+  editor.visit({
+    VariableDeclarator(node) {
+      if (node.id.type !== 'ObjectPattern' || !isImportMetaVitest(node.init)) {
+        return;
+      }
+      for (const property of node.id.properties) {
+        if (property.type !== 'Property' || propertyName(property.key) !== 'bench') {
+          continue;
+        }
+        const binding = editor.binding(property.value);
+        const registrations = binding?.references.map(directCall);
+        if (
+          property.computed ||
+          node.id.typeAnnotation ||
+          !binding?.constant ||
+          node.id.properties.some((prop) => prop.type === 'RestElement') ||
+          !registrations ||
+          registrations.some((registration) => !registration)
+        ) {
+          unsupportedInSource(property);
+          continue;
+        }
+        // Retarget the binding in place: importing test at module scope would
+        // change production behavior when import.meta.vitest is undefined.
+        const test = editor.uniqueName('test', true);
+        editor.replace(property, test === 'test' ? 'test' : `test: ${test}`);
+        bindings.add(property);
+        for (const registration of registrations) {
+          rewrite(registration!, test);
+        }
+      }
+    },
+    ImportDeclaration(node) {
+      if (!['vitest', 'vite-plus/test'].includes(node.source.value) || node.importKind === 'type') {
+        return;
+      }
+      for (const specifier of node.specifiers) {
+        if (
+          specifier.type !== 'ImportSpecifier' ||
+          specifier.importKind === 'type' ||
+          propertyName(specifier.imported) !== 'bench'
+        ) {
+          continue;
+        }
+        const binding = editor.binding(specifier.local);
+        if (!binding) {
+          continue;
+        }
+        const registrations = binding.references.map(directCall);
+        // Retarget an import only when all uses are understood. A callback
+        // passed to a wrapper or a re-export must not become a test function.
+        if (registrations.some((registration) => !registration)) {
+          continue;
+        }
+        const test = editor.uniqueName('test', true);
+        editor.replace(specifier, test === 'test' ? 'test' : `test as ${test}`);
+        imports.add(specifier);
+        for (const registration of registrations) {
+          rewrite(registration!, test);
+        }
+      }
+    },
+    Identifier(node) {
+      if (!globals || node.name !== 'bench' || editor.binding(node) || shadowedGlobalThis) {
+        return;
+      }
+      const registration = directCall(node);
+      if (registration) {
+        rewrite(registration, 'globalThis.test');
+      }
+    },
+    MemberExpression(node) {
+      const inSource = isImportMetaVitest(node.object) && memberName(node) === 'bench';
+      if (!inSource && testApiName(editor, node, globals) !== 'bench') {
+        return;
+      }
+      const registration = !node.optional && directCall(node);
+      if (registration && (inSource || node.object.type === 'Identifier')) {
+        rewrite(registration, `${editor.text(node.object)}.test`);
+      } else if (inSource) {
+        unsupportedInSource(node);
+      }
+    },
+  });
+  return { imports, bindings, calls };
+}
diff --git a/packages/cli/src/migration/vitest-v5/commands.ts b/packages/cli/src/migration/vitest-v5/commands.ts
new file mode 100644
index 0000000000..f990695d5a
--- /dev/null
+++ b/packages/cli/src/migration/vitest-v5/commands.ts
@@ -0,0 +1,300 @@
+import type { RewriteResult, VitestV5Finding } from './ast.ts';
+
+interface CommandToken {
+  value: string;
+  start: number;
+  end: number;
+}
+
+/** Parse only a single literal argv command. Shell expansion, pipelines, and
+ * compound commands need review; treating them as argv could change behavior. */
+export function literalArgv(command: string): CommandToken[] | undefined {
+  const tokens: CommandToken[] = [];
+  let value = '';
+  let start = 0;
+  let quote = '';
+  let active = false;
+  for (let i = 0; i < command.length; i++) {
+    const character = command[i];
+    if (quote) {
+      if (character === quote) {
+        quote = '';
+      } else if (
+        character === '\\' ||
+        (quote === '"' && (character === '$' || character === '`'))
+      ) {
+        return undefined;
+      } else {
+        value += character;
+      }
+    } else if (character === "'" || character === '"') {
+      if (!active) {
+        start = i;
+      }
+      quote = character;
+      active = true;
+    } else if (character === '\n' || character === '\r') {
+      return undefined;
+    } else if (/\s/.test(character)) {
+      if (active) {
+        tokens.push({ value, start, end: i });
+      }
+      active = false;
+      value = '';
+    } else if (/[|&;<>($`\\)]/.test(character)) {
+      return undefined;
+    } else {
+      if (!active) {
+        start = i;
+      }
+      value += character;
+      active = true;
+    }
+  }
+  if (quote) {
+    return undefined;
+  }
+  if (active) {
+    tokens.push({ value, start, end: command.length });
+  }
+  return tokens;
+}
+
+/** Read command lists without executing a shell. Directory-changing builtins,
+ * expansions, pipelines, and shell programs remain unresolved. */
+export function literalTestCommands(command: string): string[][] | undefined {
+  const commands: string[][] = [];
+  let quote = '';
+  let start = 0;
+  const append = (end: number) => {
+    const tokens = literalArgv(command.slice(start, end));
+    if (!tokens?.length) {
+      return false;
+    }
+    const values = tokens.map(({ value }) => value);
+    while (/^[A-Za-z_]\w*=/.test(values[0] ?? '')) {
+      values.shift();
+    }
+    if (
+      !values.length ||
+      ['cd', 'pushd', 'popd', '.', 'source', 'eval', 'export', 'set', 'unset'].includes(values[0])
+    ) {
+      return false;
+    }
+    commands.push(values);
+    return true;
+  };
+  for (let index = 0; index < command.length; index++) {
+    const char = command[index];
+    if (char === '\\') {
+      return undefined;
+    }
+    if (quote) {
+      if (char === quote) {
+        quote = '';
+      }
+    } else if (char === '"' || char === "'") {
+      quote = char;
+    } else if (char === '#') {
+      return undefined;
+    } else if (
+      char === ';' ||
+      command.slice(index, index + 2) === '&&' ||
+      command.slice(index, index + 2) === '||'
+    ) {
+      if (!append(index)) {
+        return undefined;
+      }
+      if (char !== ';') {
+        index++;
+      }
+      start = index + 1;
+    }
+  }
+  return !quote && append(command.length) ? commands : undefined;
+}
+
+/** Locate the runner's arguments after a supported package-manager wrapper. */
+export function vitestCommandArgsStart(values: readonly string[]): number {
+  let start = 0;
+  if (['pnpm', 'npm', 'yarn', 'bun', 'npx', 'bunx'].includes(values[0])) {
+    start = 1;
+    if (values[start] === 'exec' || values[start] === 'x') {
+      start++;
+    }
+    if (values[start] === '--') {
+      start++;
+    }
+  }
+  if (values[start] === 'vitest') {
+    return start + 1;
+  }
+  if (values[start] === 'vp' && values[start + 1] === 'test') {
+    return start + 2;
+  }
+  return -1;
+}
+
+function migrateBenchmarkOutput(command: string): string {
+  const argv = literalArgv(command);
+  if (!argv) {
+    return command;
+  }
+  const values = argv.map(({ value }) => value);
+  const start = vitestCommandArgsStart(values);
+  if (start < 0) {
+    return command;
+  }
+  const end = values.indexOf('--', start);
+  const args = argv.slice(start, end < 0 ? undefined : end);
+  // A quoted option-looking token can be another flag's value. Restrict this
+  // rewrite to known argv shapes instead of guessing how an unknown flag parses.
+  for (let index = 0; index < args.length; index++) {
+    const { value } = args[index];
+    if (/^--(?:outputJson|outputFile|reporters?)$/.test(value)) {
+      const next = args[++index]?.value;
+      if (!next || next.startsWith('-')) {
+        return command;
+      }
+    } else if (
+      value.startsWith('-') &&
+      !/^--(?:run|watch)$/.test(value) &&
+      !/^--(?:outputJson|outputFile|reporters?)=/.test(value)
+    ) {
+      return command;
+    }
+  }
+  const legacy = args.filter(({ value }) => /^--outputJson(?:=|$)/.test(value));
+  if (legacy.length !== 1) {
+    return command;
+  }
+  const flag = legacy[0];
+  const value = flag.value.startsWith('--outputJson=')
+    ? flag.value.slice('--outputJson='.length)
+    : args[args.indexOf(flag) + 1]?.value;
+  if (!value || value.startsWith('-')) {
+    return command;
+  }
+  const last = flag.value.includes('=') ? flag : args[args.indexOf(flag) + 1];
+  const raw =
+    flag === last
+      ? command.slice(flag.start + '--outputJson='.length, flag.end)
+      : command.slice(last.start, last.end);
+  // Moving an unquoted glob behind '=' can change shell expansion.
+  if (!/^[\w./:@+-]+$/.test(raw) && !/^(['"]).*\1$/.test(raw)) {
+    return command;
+  }
+  const output = args.filter(({ value }) => /^--outputFile(?:[.=]|$)/.test(value));
+  if (output.length > 1) {
+    return command;
+  }
+  if (output.length) {
+    const token = output[0];
+    if (!/^--outputFile(?:=|$)/.test(token.value)) {
+      return command;
+    }
+    const destination = token.value.includes('=')
+      ? token.value.slice('--outputFile='.length)
+      : args[args.indexOf(token) + 1]?.value;
+    if (destination !== value) {
+      return command;
+    }
+  }
+  const reporters: string[] = [];
+  for (const [index, { value }] of args.entries()) {
+    if (/^--reporters?=/.test(value)) {
+      reporters.push(value.slice(value.indexOf('=') + 1));
+    } else if (/^--reporters?$/.test(value)) {
+      reporters.push(args[index + 1]?.value ?? '');
+    }
+  }
+  if (reporters.some((name) => !['default', 'verbose', 'json'].includes(name))) {
+    return command;
+  }
+  const replacement = [
+    ...(!reporters.length ? ['--reporter=default'] : []),
+    ...(!reporters.includes('json') ? ['--reporter=json'] : []),
+    ...(!output.length ? [`--outputFile=${raw}`] : []),
+  ].join(' ');
+  return command.slice(0, flag.start) + replacement + command.slice(last.end);
+}
+
+export function migrateVitestV5Command(
+  file: string,
+  command: string,
+  preserveV4: boolean,
+  line = 1,
+  reviewV4 = preserveV4,
+): RewriteResult {
+  const findings: VitestV5Finding[] = [];
+  const report = (
+    code: string,
+    message: string,
+    severity: VitestV5Finding['severity'] = 'review',
+  ) => findings.push({ file, line, column: 1, code, message, severity });
+  if (!/\bvitest\b|\bvp\s+test\b/.test(command)) {
+    return { content: command, findings };
+  }
+  command = migrateBenchmarkOutput(command);
+  // The bench subcommand still exists in v5. Only its removed flags block
+  // migration; benchmark source changes are handled by the source pass.
+  const argv = literalArgv(command);
+  const values = argv?.map(({ value }) => value);
+  const runner = values ? vitestCommandArgsStart(values) : -1;
+  let removedFlag = /(?:^|\s)(?:--compare|--outputJson)(?:\s|=|$)/.test(command);
+  let reviewNamePattern = /(?:^|\s)(?:-t|--testNamePattern)(?:\s|=)/.test(command);
+  if (values && runner >= 0) {
+    const terminator = values.indexOf('--', runner);
+    const args = values.slice(runner, terminator === -1 ? undefined : terminator);
+    removedFlag = args.some((value) => /^(?:--compare|--outputJson)(?:=|$)/.test(value));
+    reviewNamePattern = args.some((value, index) => {
+      if (!/^(?:-t|--testNamePattern)(?:=|$)/.test(value)) {
+        return false;
+      }
+      const pattern = value.includes('=') ? value.slice(value.indexOf('=') + 1) : args[index + 1];
+      // A plain single-segment substring is unaffected by suite separators.
+      return !pattern || !/^[\w-]+$/.test(pattern);
+    });
+  }
+  if (reviewV4 && reviewNamePattern) {
+    report(
+      'test-name-pattern',
+      'Review test-name patterns across suite boundaries; full names now use > separators.',
+    );
+  }
+  if (removedFlag) {
+    report(
+      'benchmark-api',
+      'Replace removed --compare/--outputJson flags with bench context comparisons or regular JSON reporter output. The bench subcommand is still supported.',
+      'block',
+    );
+  }
+  if (!reviewV4 || !/\blist\b/.test(command)) {
+    return { content: command, findings };
+  }
+  if (!argv || !values) {
+    report(
+      'static-list',
+      'Review this wrapped or compound list command and explicitly choose --no-static-parse to retain runtime collection.',
+    );
+    return { content: command, findings };
+  }
+  const list = runner;
+  if (list < 0 || values[list] !== 'list') {
+    report(
+      'static-list',
+      'Resolve this list command wrapper and explicitly choose a static-parse setting.',
+    );
+    return { content: command, findings };
+  }
+  const optionsEnd = values.indexOf('--', list + 1);
+  const args = values.slice(list + 1, optionsEnd < 0 ? undefined : optionsEnd);
+  if (!preserveV4 || args.some((arg) => /^--(?:no-)?static-parse(?:=|$)/.test(arg))) {
+    return { content: command, findings };
+  }
+  const offset = argv[list].end;
+  return {
+    content: `${command.slice(0, offset)} --no-static-parse${command.slice(offset)}`,
+    findings,
+  };
+}
diff --git a/packages/cli/src/migration/vitest-v5/compatibility.ts b/packages/cli/src/migration/vitest-v5/compatibility.ts
new file mode 100644
index 0000000000..09f9db61a5
--- /dev/null
+++ b/packages/cli/src/migration/vitest-v5/compatibility.ts
@@ -0,0 +1,50 @@
+import type { AddedProperty } from './ast.ts';
+
+const settings = {
+  clearMocks: {
+    value: 'false',
+    reason: 'preserve mock call history.',
+    adoption: 'Remove after tests no longer rely on calls from setup or earlier tests.',
+    section: 'clearmocks-is-enabled-by-default',
+  },
+  sharedViteServer: {
+    value: 'false',
+    reason: 'keep separate Vite servers for inline projects.',
+    adoption: 'Remove when plugins and config hooks can run once for shared projects.',
+    section: 'inline-projects-share-the-vite-server-by-default',
+  },
+  extends: {
+    value: 'false',
+    reason: 'keep this inline project independent of the root config.',
+    adoption: 'Remove to inherit root options, including plugins and setup files.',
+    section: 'inline-projects-inherit-the-root-config-by-default',
+  },
+  exact: {
+    value: 'false',
+    reason: 'keep partial, case-insensitive locator matching.',
+    adoption: 'Remove after updating locators for full, case-sensitive matches.',
+    section: 'locators-are-strict-by-default',
+  },
+  perFile: {
+    value: 'true',
+    reason: 'enforce this coverage threshold per file.',
+    adoption: 'Keep for per-file enforcement; remove to check matching files as a group.',
+    section: 'glob-coverage-thresholds-no-longer-inherit-perfile',
+  },
+  toNotFake: {
+    value: "['Temporal']",
+    reason: 'exclude the global Temporal polyfill from fake timers.',
+    adoption: 'Remove only the Temporal entry when it should follow mocked time.',
+    section: 'fake-timers-and-setsystemtime-now-mock-temporal',
+  },
+};
+
+/** Only attach this guidance to newly inserted v4 compatibility properties. */
+export function compatibilityProperty(key: keyof typeof settings): AddedProperty {
+  const { value, reason, adoption, section } = settings[key];
+  return {
+    key,
+    value,
+    comment: `// Vitest v4 compatibility: ${reason}\n// ${adoption}\n// https://vitest.dev/guide/migration/#${section}`,
+  };
+}
diff --git a/packages/cli/src/migration/vitest-v5/config.ts b/packages/cli/src/migration/vitest-v5/config.ts
new file mode 100644
index 0000000000..08fe74a50a
--- /dev/null
+++ b/packages/cli/src/migration/vitest-v5/config.ts
@@ -0,0 +1,640 @@
+import path from 'node:path';
+
+import type * as t from '@oxc-project/types';
+import { minimatch } from 'minimatch';
+
+import {
+  CONFIG_SOURCES,
+  SourceEditor,
+  importedName,
+  objectProperty,
+  propertyName,
+  projectElements,
+  staticObject,
+  sameStaticValue,
+  isString,
+  isBoolean,
+  isModuleExports,
+  type AddedProperty,
+  type RewriteResult,
+  type SourceOptions,
+} from './ast.ts';
+import { migrateBenchmarkConfig } from './benchmark-config.ts';
+import { compatibilityProperty } from './compatibility.ts';
+
+function isTrue(node: t.Node | undefined): boolean {
+  return isBoolean(node) && node.value;
+}
+
+const CONFIG_FILENAME = /(?:^|[/\\])(?:vite|vitest)(?:\.[\w-]+)?\.config\.[cm]?[jt]s$/;
+const CONFIG_HELPER_IMPORT = /['"](?:vite|vitest\/config|vite-plus(?:\/test\/config)?)['"]/;
+
+function hasTestConfigHelper(file: string, source: string): boolean {
+  if (!CONFIG_HELPER_IMPORT.test(source)) {
+    return false;
+  }
+  try {
+    const editor = new SourceEditor(file, source);
+    const importsTestHelper = editor.ast.body.some(
+      (node) =>
+        node.type === 'ImportDeclaration' &&
+        node.importKind !== 'type' &&
+        ['vitest/config', 'vite-plus/test/config'].includes(node.source.value) &&
+        node.specifiers.some(
+          (specifier) =>
+            specifier.type === 'ImportNamespaceSpecifier' ||
+            (specifier.type === 'ImportSpecifier' &&
+              specifier.importKind !== 'type' &&
+              ['defineConfig', 'defineProject', 'mergeConfig'].includes(
+                propertyName(specifier.imported) ?? '',
+              )),
+        ),
+    );
+    if (importsTestHelper) {
+      return true;
+    }
+    // Vite helpers also appear in plugin source and examples. A generic helper
+    // import alone does not make that file a test config. Require explicit test
+    // options; standard filenames and project references are handled separately.
+    let hasTestOptions = false;
+    editor.visit({
+      CallExpression(node) {
+        if (
+          ['defineConfig', 'defineProject', 'mergeConfig'].includes(
+            importedName(editor, node.callee, CONFIG_SOURCES) ?? '',
+          ) &&
+          node.arguments.some(
+            (argument) =>
+              argument.type === 'ObjectExpression' && !!objectProperty(argument, 'test'),
+          )
+        ) {
+          hasTestOptions = true;
+        }
+      },
+    });
+    return hasTestOptions;
+  } catch {
+    // Keep candidate configs in the normal parse-diagnostic path.
+    return true;
+  }
+}
+
+/** Include literal referenced configs even when they use a custom filename and
+ * export a raw object. Candidate files come from the owning package's scan. */
+export function findVitestV5ConfigFiles(
+  sources: ReadonlyMap<string, string>,
+  entries: string[] = [],
+): Set<string> {
+  const files = new Set(
+    [...sources]
+      .filter(
+        ([file, source]) =>
+          /\.[cm]?[jt]sx?$/.test(file) &&
+          (CONFIG_FILENAME.test(file) || hasTestConfigHelper(file, source)),
+      )
+      .map(([file]) => file),
+  );
+  for (const file of entries) {
+    if (sources.has(file)) {
+      files.add(file);
+    }
+  }
+  for (const file of files) {
+    try {
+      const editor = new SourceEditor(file, sources.get(file)!);
+      const addReference = (reference: string) => {
+        if (reference.startsWith('!')) {
+          return;
+        }
+        const target = path.resolve(path.dirname(file), reference);
+        if (sources.has(target) && /\.[cm]?[jt]sx?$/.test(target)) {
+          files.add(target);
+        } else {
+          for (const candidate of sources.keys()) {
+            const relative = path.relative(path.dirname(file), candidate).replaceAll('\\', '/');
+            const pattern = reference.replaceAll('\\', '/').replace(/^\.\//, '');
+            if (
+              /\.[cm]?[jt]sx?$/.test(candidate) &&
+              (minimatch(relative, pattern, { dot: true }) ||
+                (CONFIG_FILENAME.test(candidate) &&
+                  minimatch(path.posix.dirname(relative), pattern, { dot: true })))
+            ) {
+              files.add(candidate);
+            }
+          }
+        }
+      };
+      const collectReferences = (config: t.Node | undefined) => {
+        if (config?.type !== 'ObjectExpression') {
+          return;
+        }
+        const base = objectProperty(config, 'extends')?.value;
+        if (isString(base)) {
+          addReference(base.value);
+        }
+        const test = objectProperty(config, 'test')?.value;
+        const projects =
+          test?.type === 'ObjectExpression' ? objectProperty(test, 'projects')?.value : undefined;
+        if (projects?.type !== 'ArrayExpression') {
+          return;
+        }
+        for (const project of projectElements(projects)) {
+          if (isString(project)) {
+            addReference(project.value);
+          } else {
+            collectReferences(project ?? undefined);
+          }
+        }
+      };
+      editor.visit({
+        ExportDefaultDeclaration(node) {
+          const declaration = node.declaration;
+          if (declaration.type === 'Identifier') {
+            const binding = editor.binding(declaration);
+            if (binding?.constant && binding.declaration.type === 'VariableDeclarator') {
+              collectReferences(binding.declaration.init ?? undefined);
+            }
+          } else {
+            collectReferences(declaration);
+          }
+        },
+        CallExpression(node) {
+          if (
+            ['defineConfig', 'defineProject', 'mergeConfig'].includes(
+              importedName(editor, node.callee, CONFIG_SOURCES) ?? '',
+            )
+          ) {
+            for (const argument of node.arguments) {
+              collectReferences(argument);
+            }
+          }
+        },
+        AssignmentExpression(node) {
+          if (isModuleExports(editor, node.left)) {
+            collectReferences(node.right);
+          }
+        },
+      });
+    } catch {
+      // The migration's normal parse diagnostic owns reporting this file.
+    }
+  }
+  return files;
+}
+
+function hasConfigMerge(editor: SourceEditor): boolean {
+  let found = false;
+  editor.visit({
+    CallExpression(node) {
+      if (importedName(editor, node.callee, CONFIG_SOURCES) === 'mergeConfig') {
+        found = true;
+      }
+    },
+  });
+  return found;
+}
+
+/** Defaults on one merge fragment can override explicit settings in another.
+ * Include local imported configs so the preflight and finalization agree. */
+export function findVitestV5MergedConfigFiles(
+  sources: ReadonlyMap<string, string>,
+  configFiles: ReadonlySet<string>,
+): Set<string> {
+  const merged = new Set<string>();
+  const imports = new Map<string, string[]>();
+  const extensions = ['.ts', '.mts', '.cts', '.js', '.mjs', '.cjs', '.tsx', '.jsx'];
+  for (const file of configFiles) {
+    try {
+      const editor = new SourceEditor(file, sources.get(file)!);
+      if (hasConfigMerge(editor)) {
+        merged.add(file);
+      }
+      const dependencies: string[] = [];
+      for (const node of editor.ast.body) {
+        if (
+          node.type !== 'ImportDeclaration' &&
+          node.type !== 'ExportNamedDeclaration' &&
+          node.type !== 'ExportAllDeclaration'
+        ) {
+          continue;
+        }
+        const reference = node.source?.value;
+        if (!reference?.startsWith('.')) {
+          continue;
+        }
+        const target = path.resolve(path.dirname(file), reference);
+        const dependency = [
+          target,
+          target.replace(/\.([cm]?)js$/, '.$1ts'),
+          ...extensions.map((extension) => `${target}${extension}`),
+          ...extensions.map((extension) => path.join(target, `index${extension}`)),
+        ].find((candidate) => configFiles.has(candidate));
+        if (dependency) {
+          dependencies.push(dependency);
+        }
+      }
+      imports.set(file, dependencies);
+    } catch {
+      // The normal config pass reports unsupported syntax.
+    }
+  }
+  for (const file of merged) {
+    for (const dependency of imports.get(file) ?? []) {
+      merged.add(dependency);
+    }
+  }
+  return merged;
+}
+
+export function migrateVitestV5Config(
+  file: string,
+  source: string,
+  options: SourceOptions,
+  mergedConfig = false,
+): RewriteResult {
+  // Resolve removed benchmark options first so config edits use fresh offsets.
+  const output = migrateConfig(file, source, options, mergedConfig, true);
+  const result = migrateConfig(file, output.content, options, mergedConfig);
+  return {
+    content: result.content,
+    findings: [
+      ...output.findings.filter(({ code }) =>
+        ['overlapping-edits', 'unsafe-syntax'].includes(code),
+      ),
+      ...result.findings,
+    ],
+  };
+}
+
+function migrateConfig(
+  file: string,
+  source: string,
+  options: SourceOptions,
+  mergedConfig: boolean,
+  benchmarkOnly = false,
+): RewriteResult {
+  const editor = new SourceEditor(file, source);
+  const visited = new Set<t.ObjectExpression>();
+  const merged = mergedConfig || hasConfigMerge(editor);
+  const preserveDefaults = options.preserveV4 && !merged && !benchmarkOnly;
+  const reviewV4 = options.preserveV4 || options.reviewV4;
+  if (merged && reviewV4) {
+    editor.report(
+      undefined,
+      'merged-config-defaults',
+      'Review the effective merged config before adding v4 defaults for clearMocks, browser locators, fake timers, and projects. Defaults were not added to config fragments because they can override explicit settings in another fragment.',
+    );
+  }
+
+  function nested(
+    object: t.ObjectExpression,
+    key: string,
+    additions: string | AddedProperty[],
+    apply: (node: t.ObjectExpression) => void,
+  ) {
+    const prop = objectProperty(object, key);
+    if (!prop) {
+      editor.add(object, key, typeof additions === 'string' ? `{ ${additions} }` : additions);
+    } else if (staticObject(prop.value)) {
+      apply(prop.value);
+    } else {
+      editor.report(
+        prop,
+        'dynamic-config',
+        `Resolve ${key} before applying Vitest v5 compatibility options.`,
+      );
+    }
+  }
+
+  function addCompatibility(
+    object: t.ObjectExpression,
+    key: Parameters<typeof compatibilityProperty>[0],
+  ) {
+    const property = compatibilityProperty(key);
+    editor.add(object, key, property.value, property.comment);
+  }
+
+  function testOptions(
+    test: t.ObjectExpression,
+    inherits: boolean,
+    parentTest?: t.ObjectExpression,
+  ) {
+    if (benchmarkOnly) {
+      // Reporters are global; do not invent destinations on inline projects or
+      // fragments whose effective root settings depend on a merge.
+      if (!parentTest && !merged) {
+        migrateBenchmarkConfig(editor, test);
+      }
+      return;
+    }
+    if (preserveDefaults && !inherits) {
+      addCompatibility(test, 'clearMocks');
+    }
+    const browser = objectProperty(test, 'browser');
+    if (browser && staticObject(browser.value)) {
+      const value = browser.value;
+      // An inherited browser config already receives its defaults at the parent.
+      // Do not replace its explicit or dynamic locator setting in the child.
+      const inheritsBrowser = inherits && parentTest && objectProperty(parentTest, 'browser');
+      if (preserveDefaults && !inheritsBrowser) {
+        nested(value, 'locators', [compatibilityProperty('exact')], (locators) =>
+          addCompatibility(locators, 'exact'),
+        );
+      }
+      const api = objectProperty(value, 'api');
+      if (api) {
+        const target = objectProperty(test, 'api');
+        if (target && !sameStaticValue(target.value, api.value)) {
+          editor.report(
+            api,
+            'api-conflict',
+            'Resolve conflicting test.api and test.browser.api values before upgrading.',
+            'block',
+          );
+        } else {
+          editor.add(test, 'api', editor.text(api.value));
+          editor.remove(value, api);
+        }
+      }
+      const screenshot = objectProperty(value, 'screenshotDirectory');
+      if (screenshot) {
+        const setting = `screenshotDirectory: ${editor.text(screenshot.value)}`;
+        nested(value, 'expect', `toMatchScreenshot: { ${setting} }`, (expect) => {
+          nested(expect, 'toMatchScreenshot', setting, (match) =>
+            editor.add(match, 'screenshotDirectory', editor.text(screenshot.value)),
+          );
+        });
+      }
+      if (objectProperty(value, 'commands')) {
+        editor.report(
+          browser,
+          'locator-commands',
+          'Review browser command parameters: locators are SerializedLocator objects, not selector strings.',
+        );
+      }
+    } else if (browser && reviewV4) {
+      editor.report(
+        browser,
+        'dynamic-project',
+        'Review dynamic browser options and preserve locators.exact: false when migrating v4.',
+      );
+    }
+
+    if (preserveDefaults && options.temporalPolyfill) {
+      nested(test, 'fakeTimers', [compatibilityProperty('toNotFake')], (timers) =>
+        addCompatibility(timers, 'toNotFake'),
+      );
+    }
+    const coverage = objectProperty(test, 'coverage');
+    if (coverage && staticObject(coverage.value)) {
+      for (const key of ['include', 'exclude']) {
+        const pattern = objectProperty(coverage.value, key);
+        if (pattern && reviewV4) {
+          editor.report(
+            pattern,
+            'coverage-patterns',
+            `Compare v4/v5 resolved coverage.${key} file sets; v5 matches relative paths more precisely.`,
+          );
+        }
+      }
+      const thresholds = objectProperty(coverage.value, 'thresholds');
+      if (
+        preserveDefaults &&
+        thresholds &&
+        staticObject(thresholds.value) &&
+        isTrue(objectProperty(thresholds.value, 'perFile')?.value)
+      ) {
+        for (const threshold of thresholds.value.properties) {
+          if (
+            threshold.type !== 'Property' ||
+            [
+              'perFile',
+              'lines',
+              'branches',
+              'functions',
+              'statements',
+              'autoUpdate',
+              '100',
+            ].includes(propertyName(threshold.key) ?? '')
+          ) {
+            continue;
+          }
+          if (staticObject(threshold.value)) {
+            addCompatibility(threshold.value, 'perFile');
+          } else {
+            editor.report(
+              threshold,
+              'coverage-thresholds',
+              'Set perFile: true on this dynamic glob threshold to retain v4 enforcement.',
+            );
+          }
+        }
+      }
+    }
+    const benchmark = objectProperty(test, 'benchmark');
+    if (benchmark) {
+      if (staticObject(benchmark.value)) {
+        for (const key of ['reporters', 'outputFile', 'compare', 'outputJson']) {
+          const removed = objectProperty(benchmark.value, key);
+          if (removed) {
+            editor.report(
+              removed,
+              'benchmark-api',
+              `Replace removed benchmark.${key} with regular test reporters and the bench test-context fixture.`,
+              'block',
+            );
+          }
+        }
+      } else {
+        editor.report(
+          benchmark,
+          'benchmark-api',
+          'Review dynamic benchmark options for removed reporters, outputFile, compare, and outputJson settings.',
+        );
+      }
+    }
+    const projects = objectProperty(test, 'projects');
+    if (!projects) {
+      return;
+    }
+    if (projects.value.type !== 'ArrayExpression') {
+      if (reviewV4) {
+        editor.report(
+          projects,
+          'dynamic-project',
+          'Resolve dynamic projects and review inheritance and sharedViteServer before upgrading.',
+        );
+      }
+      return;
+    }
+    const hasInline = projects.value.elements.some((item) => item && !isString(item));
+    if (hasInline && preserveDefaults) {
+      addCompatibility(test, 'sharedViteServer');
+    }
+    for (const project of projectElements(projects.value)) {
+      if (!project || isString(project)) {
+        continue;
+      }
+      if (!staticObject(project)) {
+        if (reviewV4) {
+          editor.report(
+            project,
+            'dynamic-project',
+            'Review this function, promise, or dynamic inline project. Set explicit inheritance and v4 compatibility options.',
+          );
+        }
+        continue;
+      }
+      const extendsValue = objectProperty(project, 'extends');
+      if (preserveDefaults) {
+        addCompatibility(project, 'extends');
+      }
+      config(project, isTrue(extendsValue?.value), test);
+    }
+  }
+
+  function config(object: t.ObjectExpression, inherits = false, parentTest?: t.ObjectExpression) {
+    if (visited.has(object)) {
+      return;
+    }
+    visited.add(object);
+    const extendsValue = objectProperty(object, 'extends');
+    if (extendsValue && !isBoolean(extendsValue.value) && reviewV4) {
+      // A string refers to a different base, not parentTest. Until that base's
+      // effective options are known, child defaults can override explicit values.
+      editor.report(
+        extendsValue,
+        'project-inheritance',
+        'Review this external or dynamic project base before adding v4 compatibility defaults. Inherited project settings were left unchanged.',
+      );
+      return;
+    }
+    const test = objectProperty(object, 'test');
+    if (!test) {
+      if (preserveDefaults && !inherits) {
+        const properties = [compatibilityProperty('clearMocks')];
+        if (options.temporalPolyfill) {
+          properties.push({ key: 'fakeTimers', value: [compatibilityProperty('toNotFake')] });
+        }
+        editor.add(object, 'test', properties);
+      }
+    } else if (staticObject(test.value, true)) {
+      testOptions(test.value, inherits, parentTest);
+    } else if (reviewV4) {
+      editor.report(
+        test,
+        'dynamic-config',
+        'Review dynamic test options; v4 defaults cannot be preserved automatically.',
+      );
+    }
+  }
+
+  editor.visit({
+    AssignmentExpression(node) {
+      if (isModuleExports(editor, node.left)) {
+        if (staticObject(node.right)) {
+          config(node.right);
+        } else if (node.right.type !== 'CallExpression' && reviewV4) {
+          editor.report(
+            node,
+            'dynamic-config',
+            'Review the effective CommonJS test config and its v4 defaults.',
+          );
+        }
+      }
+    },
+    ExportDefaultDeclaration(node) {
+      if (staticObject(node.declaration)) {
+        config(node.declaration);
+      } else if (node.declaration.type === 'Identifier') {
+        const binding = editor.binding(node.declaration);
+        if (
+          binding?.constant &&
+          binding.declaration.type === 'VariableDeclarator' &&
+          staticObject(binding.declaration.init)
+        ) {
+          config(binding.declaration.init);
+        } else if (reviewV4) {
+          editor.report(
+            node,
+            'dynamic-config',
+            'Review the effective exported test config and its v4 defaults.',
+          );
+        }
+      } else if (node.declaration.type !== 'CallExpression' && reviewV4) {
+        editor.report(
+          node,
+          'dynamic-config',
+          'Review the effective function or promise config and its v4 defaults.',
+        );
+      }
+    },
+    CallExpression(node) {
+      const name = importedName(editor, node.callee, CONFIG_SOURCES);
+      if (name === 'defineConfig' || name === 'defineProject') {
+        if (benchmarkOnly && name === 'defineProject') {
+          return;
+        }
+        const parent = editor.parent(node);
+        const binding =
+          parent?.type === 'VariableDeclarator' && parent.id.type === 'Identifier'
+            ? editor.binding(parent.id)
+            : undefined;
+        const directlyExported =
+          parent?.type === 'ExportDefaultDeclaration' ||
+          (parent?.type === 'AssignmentExpression' &&
+            parent.right === node &&
+            isModuleExports(editor, parent.left)) ||
+          (binding?.constant &&
+            binding.references.length > 0 &&
+            binding.references.every(
+              (reference) => editor.parent(reference)?.type === 'ExportDefaultDeclaration',
+            ));
+        // Wrappers and dynamic inline projects can supply their own defaults.
+        // Do not let a nested helper bypass the ownership check above.
+        if (!directlyExported && !merged) {
+          if (reviewV4) {
+            editor.report(
+              node,
+              'dynamic-config',
+              'Review this config fragment in its wrapper or inline project before adding v4 compatibility settings.',
+            );
+          }
+          return;
+        }
+        const object = node.arguments[0];
+        if (staticObject(object)) {
+          config(object);
+        } else if (reviewV4) {
+          editor.report(
+            object,
+            'dynamic-config',
+            'Review this dynamic config; explicit v4 compatibility settings need manual insertion.',
+          );
+        }
+      }
+      if (name === 'mergeConfig' && reviewV4) {
+        editor.report(
+          node,
+          'nested-project-merge',
+          'Check merged root configs for test.projects; v5 permits nested projects and can recurse or duplicate them.',
+        );
+      }
+    },
+    Property(node) {
+      if (
+        reviewV4 &&
+        ['config', 'configResolved', 'configureServer', 'configureVitest'].includes(
+          propertyName(node.key) ?? '',
+        )
+      ) {
+        editor.report(
+          node,
+          'project-server-lifecycle',
+          'Review this plugin hook for per-project config execution or Vite server state.',
+        );
+      }
+    },
+  });
+  return editor.finish();
+}
diff --git a/packages/cli/src/migration/vitest-v5/documentation.ts b/packages/cli/src/migration/vitest-v5/documentation.ts
new file mode 100644
index 0000000000..147d99d674
--- /dev/null
+++ b/packages/cli/src/migration/vitest-v5/documentation.ts
@@ -0,0 +1,56 @@
+const guide = 'https://viteplus.dev/guide/vitest-v5';
+const upstream = 'https://vitest.dev/guide/migration/';
+
+const sections: Record<string, string> = {
+  'api-conflict': 'browser-api-is-replaced-by-the-top-level-api',
+  'assertion-types': 'assertion-types-expose-return-and-received-types',
+  'async-render': 'render-is-async-in-vitest-browser-vue-and-vitest-browser-svelte',
+  'benchmark-api': 'benchmarking-api-rewrite',
+  'browser-automock': 'automocked-modules-stay-automocked-in-the-browser',
+  'browser-session': 'browser-orchestrator-url-requires-a-session',
+  'class-mock': 'class-mocks-keep-prototype-methods',
+  'coverage-patterns': 'coverage-include-and-exclude-match-more-precisely',
+  'coverage-thresholds': 'glob-coverage-thresholds-no-longer-inherit-perfile',
+  'dom-global': 'dom-environment-global-assignments-now-update-the-underlying-window',
+  'global-descriptors': 'populateglobal-returns-descriptors-in-originals',
+  'locator-commands': 'locators-in-commands-are-serialized-as-objects',
+  'nested-hoisted-mock': 'hoisted-mocking-calls-must-be-at-the-top-level',
+  'nested-project-merge': 'referenced-config-files-can-define-their-own-projects',
+  'poll-timeout': 'expect-poll-fails-when-it-times-out',
+  'project-inheritance': 'inline-projects-inherit-the-root-config-by-default',
+  'project-server-lifecycle': 'inline-projects-share-the-vite-server-by-default',
+  'removed-api': 'removed-deprecated-entrypoints',
+  'resolve-config': 'resolveconfig-returns-the-resolved-vite-config',
+  'sequential-api': 'removed-test-sequential-describe-sequential-and-sequential-options',
+  'temporal-system-time': 'fake-timers-and-setsystemtime-now-mock-temporal',
+  'test-name-pattern': 'testnamepattern-matches-the-joined-full-name',
+  'text-content': 'tohavetextcontent-now-performs-strict-equality',
+  'text-content-project': 'tohavetextcontent-now-performs-strict-equality',
+  'ui-token': 'vitest-ui-requires-an-authenticated-url',
+  'unawaited-assertion': 'unawaited-asynchronous-assertions-fail-the-test',
+  'worker-id': 'worker-and-concurrency-ids-are-1-based',
+};
+
+const localSections: Record<string, string> = {
+  'browser-provider': 'community-webdriverio-provider',
+  'dynamic-config': 'resolve-migration-findings',
+  'dynamic-project': 'resolve-migration-findings',
+  'global-api-ownership': 'resolve-migration-findings',
+  'jest-dom-types': 'review-checklist',
+  'merged-config-defaults': 'preserve-existing-behavior',
+  'node-runtime': 'node-runtime',
+  'overlapping-edits': 'resolve-migration-findings',
+  'source-parse': 'resolve-migration-findings',
+  'source-version': 'before-you-migrate',
+  'static-collect': 'source-changes',
+  'static-list': 'source-changes',
+  'unsafe-syntax': 'resolve-migration-findings',
+};
+
+/** Give future/unknown findings a useful fallback rather than omitting help. */
+export function vitestV5Documentation(code: string): string {
+  if (sections[code]) {
+    return `${upstream}#${sections[code]}`;
+  }
+  return `${guide}#${localSections[code] ?? 'resolve-migration-findings'}`;
+}
diff --git a/packages/cli/src/migration/vitest-v5/lockfile.ts b/packages/cli/src/migration/vitest-v5/lockfile.ts
new file mode 100644
index 0000000000..9b87301819
--- /dev/null
+++ b/packages/cli/src/migration/vitest-v5/lockfile.ts
@@ -0,0 +1,167 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+import { parse as parseJsonc, type ParseError } from 'jsonc-parser';
+import semver from 'semver';
+import { parseDocument } from 'yaml';
+
+import { PackageManager } from '../../types/index.ts';
+
+function record(value: unknown): Record<string, unknown> | undefined {
+  return value !== null && typeof value === 'object' && !Array.isArray(value)
+    ? (value as Record<string, unknown>)
+    : undefined;
+}
+
+function declaredVitest(pkg: unknown): unknown {
+  const manifest = record(pkg);
+  for (const field of [
+    'dependencies',
+    'devDependencies',
+    'optionalDependencies',
+    'peerDependencies',
+  ]) {
+    const spec = record(manifest?.[field])?.vitest;
+    if (typeof spec === 'string') {
+      return spec;
+    }
+  }
+  return undefined;
+}
+
+/** Read a direct upstream Vitest edge without installing or changing a lockfile.
+ * Unsupported protocols, ambiguous layouts and stale entries remain unknown.
+ * In particular, never infer a runner from an unrelated transitive package. */
+export function lockedVitestVersion(
+  root: string,
+  directory: string,
+  manager: PackageManager,
+  spec: string,
+): string | undefined {
+  const range = spec.replace(/^npm:vitest@/, '');
+  if (!semver.validRange(range) && !/^[\w.-]+$/.test(range)) {
+    return undefined;
+  }
+  const valid = (version: unknown): string | undefined =>
+    typeof version === 'string' &&
+    semver.valid(version) &&
+    (!semver.validRange(range) || semver.satisfies(version, range, { includePrerelease: true }))
+      ? version
+      : undefined;
+  const relative = path.relative(root, directory).replaceAll('\\', '/');
+  const read = (name: string) =>
+    fs.readFileSync(path.join(root, name), 'utf8').replace(/^\uFEFF/, '');
+  try {
+    if (manager === PackageManager.npm) {
+      const lock = JSON.parse(
+        read(
+          fs.existsSync(path.join(root, 'npm-shrinkwrap.json'))
+            ? 'npm-shrinkwrap.json'
+            : 'package-lock.json',
+        ),
+      );
+      const packages = record(lock.packages);
+      if (!packages) {
+        // npm v1 locks have no importer specifiers to prove this direct edge.
+        return undefined;
+      }
+      if (declaredVitest(packages[relative]) !== spec) {
+        return undefined;
+      }
+      let owner = relative;
+      while (true) {
+        const entry = record(packages[path.posix.join(owner, 'node_modules/vitest')]);
+        if (entry) {
+          return !entry.link && (!entry.name || entry.name === 'vitest')
+            ? valid(entry.version)
+            : undefined;
+        }
+        if (!owner) {
+          return undefined;
+        }
+        const parent = path.posix.dirname(owner);
+        owner = parent === '.' ? '' : parent;
+      }
+    }
+    if (manager === PackageManager.yarn) {
+      const text = read('yarn.lock');
+      if (/^__metadata:/m.test(text)) {
+        const document = parseDocument(text);
+        if (document.errors.length) {
+          return undefined;
+        }
+        const descriptors = new Set([`vitest@${spec}`, `vitest@npm:${range}`]);
+        const entries = Object.entries(record(document.toJS()) ?? {}).filter(([keys]) =>
+          keys.split(/,\s+/).some((key) => descriptors.has(key)),
+        );
+        if (entries.length !== 1) {
+          return undefined;
+        }
+        const entry = record(entries[0][1]);
+        return typeof entry?.resolution === 'string' && entry.resolution.startsWith('vitest@npm:')
+          ? valid(entry.resolution.slice('vitest@npm:'.length))
+          : undefined;
+      }
+      // Classic's quoted descriptor lists are YAML flow scalars, but its entry
+      // bodies are not YAML. Read only the exact descriptor and version field.
+      const matches: string[] = [];
+      for (const block of text.split(/\r?\n(?=[^\s#])/)) {
+        const [header] = block.split(/\r?\n/);
+        if (!header.endsWith(':')) {
+          continue;
+        }
+        const document = parseDocument(`[${header.slice(0, -1)}]`);
+        const keys: unknown = document.errors.length ? undefined : document.toJS();
+        if (Array.isArray(keys) && keys.includes(`vitest@${spec}`)) {
+          const version = /^  version "([^"]+)"\r?$/m.exec(block)?.[1];
+          if (!version) {
+            return undefined;
+          }
+          matches.push(version);
+        }
+      }
+      return matches.length === 1 ? valid(matches[0]) : undefined;
+    }
+    if (manager === PackageManager.bun) {
+      const errors: ParseError[] = [];
+      const lock = record(parseJsonc(read('bun.lock'), errors, { allowTrailingComma: true }));
+      if (errors.length || declaredVitest(record(lock?.workspaces)?.[relative]) !== spec) {
+        return undefined;
+      }
+      const packages = record(lock?.packages);
+      const direct = packages?.vitest;
+      if (
+        !Array.isArray(direct) ||
+        typeof direct[0] !== 'string' ||
+        !direct[0].startsWith('vitest@')
+      ) {
+        return undefined;
+      }
+      const directVersion = valid(direct[0].slice('vitest@'.length));
+      if (!directVersion) {
+        return undefined;
+      }
+      // Bun can encode multiple nested/isolated package layouts. Only accept a
+      // hoisted edge with a unique matching upstream version; otherwise require
+      // the original install. A lone unrelated nested entry is not evidence.
+      const versions = new Set<string>();
+      for (const entry of Object.values(packages ?? {})) {
+        if (
+          !Array.isArray(entry) ||
+          typeof entry[0] !== 'string' ||
+          !entry[0].startsWith('vitest@')
+        ) {
+          continue;
+        }
+        const version = valid(entry[0].slice('vitest@'.length));
+        if (version) {
+          versions.add(version);
+        }
+      }
+      return versions.size === 1 ? directVersion : undefined;
+    }
+  } catch {
+    // Missing, malformed or unsupported locks are not proof of a runner version.
+  }
+  return undefined;
+}
diff --git a/packages/cli/src/migration/vitest-v5/scopes.ts b/packages/cli/src/migration/vitest-v5/scopes.ts
new file mode 100644
index 0000000000..d61558e300
--- /dev/null
+++ b/packages/cli/src/migration/vitest-v5/scopes.ts
@@ -0,0 +1,706 @@
+import path from 'node:path';
+
+import type * as t from '@oxc-project/types';
+import { minimatch } from 'minimatch';
+
+import {
+  CONFIG_SOURCES,
+  SourceEditor,
+  importedName,
+  isBoolean,
+  isModuleExports,
+  isString,
+  objectProperty,
+  memberName,
+  projectElements,
+  staticObject,
+  type SourceOptions,
+  type VitestV5Finding,
+} from './ast.ts';
+import { literalTestCommands, vitestCommandArgsStart } from './commands.ts';
+
+interface ConfigEntry {
+  file?: string;
+  root: string;
+  uncertain?: boolean;
+  rootOverride?: string;
+  dirOverride?: string;
+  cwd?: string;
+  projects?: string[];
+}
+
+interface TestScope {
+  root: string;
+  dir?: string;
+  discoveryRoot?: string;
+  include?: string[];
+  exclude?: string[];
+  benchmark?: {
+    include?: string[];
+    exclude?: string[];
+    includeSource?: string[];
+  };
+  setupFiles?: string[];
+  unresolvedSetup?: boolean;
+  browser?: boolean;
+  globals?: boolean;
+}
+
+export type VitestV5TestMode = Pick<SourceOptions, 'browser' | 'globals' | 'reviewGlobals'> & {
+  benchmark?: boolean;
+};
+
+const DEFAULT_TEST_INCLUDE = ['**/*.{test,spec}.?(c|m)[jt]s?(x)'];
+const DEFAULT_TEST_EXCLUDE = ['**/node_modules/**', '**/.git/**'];
+const DEFAULT_BENCHMARK_INCLUDE = ['**/*.{bench,benchmark}.?(c|m)[jt]s?(x)'];
+const DEFAULT_BENCHMARK_EXCLUDE = ['**/node_modules/**', '**/.git/**'];
+const TEST_CONFIG_SOURCES = new Set(['vitest/config', 'vite-plus/test/config', 'vite-plus']);
+// Match Vitest's discovery order, including precedence across extensions.
+const CONFIG_NAMES = ['vitest.config', 'vite.config'].flatMap((name) =>
+  ['.ts', '.mts', '.cts', '.js', '.mjs', '.cjs'].map((extension) => name + extension),
+);
+
+function defaultConfig(sources: ReadonlyMap<string, string>, root: string): string | undefined {
+  return CONFIG_NAMES.map((name) => path.join(root, name)).find((file) => sources.has(file));
+}
+
+/** Candidate config files are not all active projects. Select each package's
+ * default config or literal script selections before following project edges. */
+export function findVitestV5ConfigEntries(
+  sources: ReadonlyMap<string, string>,
+  directories: Iterable<string>,
+): ConfigEntry[] {
+  const entries: ConfigEntry[] = [];
+  for (const root of directories) {
+    const manifest = JSON.parse(
+      (sources.get(path.join(root, 'package.json')) ?? '{}').replace(/^\uFEFF/, ''),
+    );
+    const commands = Object.values(manifest.scripts ?? {}).filter(
+      (command): command is string =>
+        typeof command === 'string' && /\bvitest\b|\bvp\s+test\b/.test(command),
+    );
+    if (!commands.length) {
+      entries.push({ root, file: defaultConfig(sources, root) });
+      continue;
+    }
+    for (const command of commands) {
+      const invocations = literalTestCommands(command)?.filter(
+        (argv) => vitestCommandArgsStart(argv) >= 0,
+      );
+      if (!invocations?.length) {
+        entries.push({ root, uncertain: true });
+        continue;
+      }
+      for (const argv of invocations) {
+        const start = vitestCommandArgsStart(argv);
+        let config: string | undefined;
+        let rootOverride: string | undefined;
+        let dirOverride: string | undefined;
+        let uncertain = false;
+        const projects: string[] = [];
+        for (let index = start; index < argv.length && argv[index] !== '--'; index++) {
+          const arg = argv[index];
+          const option = arg.split('=')[0];
+          if (['--config', '-c', '--root', '-r', '--dir', '--project', '-p'].includes(option)) {
+            const value = arg.includes('=') ? arg.slice(arg.indexOf('=') + 1) : argv[++index];
+            if (!value || value.startsWith('-')) {
+              uncertain = true;
+            } else if (option === '--project' || option === '-p') {
+              projects.push(value);
+            } else if (option === '--config' || option === '-c') {
+              config = value;
+            } else if (option === '--dir') {
+              dirOverride = path.resolve(root, value);
+            } else {
+              rootOverride = path.resolve(root, value);
+            }
+          } else if (
+            /^--(?:no-)?(?:globals|include|exclude|workspace|setupFiles|benchmark\.(?:include|exclude|includeSource))(?:[.=]|$)/.test(
+              arg,
+            )
+          ) {
+            // These flags change ownership. Preserve globals until the command's
+            // effective project options can be determined, rather than guessing.
+            uncertain = true;
+          }
+        }
+        const configRoot = rootOverride ?? root;
+        const file = config ? path.resolve(configRoot, config) : defaultConfig(sources, configRoot);
+        entries.push({
+          root,
+          file,
+          rootOverride,
+          dirOverride,
+          projects,
+          uncertain: uncertain || (!!config && !sources.has(file!)),
+        });
+      }
+    }
+  }
+  return entries;
+}
+
+function staticPatterns(node: t.Node | undefined, editor: SourceEditor): string[] | undefined {
+  if (
+    node?.type === 'MemberExpression' &&
+    importedName(editor, node.object, TEST_CONFIG_SOURCES) === 'configDefaults'
+  ) {
+    if (memberName(node) === 'include') {
+      return DEFAULT_TEST_INCLUDE;
+    }
+    if (memberName(node) === 'exclude') {
+      return DEFAULT_TEST_EXCLUDE;
+    }
+  }
+  if (node?.type !== 'ArrayExpression') {
+    return undefined;
+  }
+  const patterns: string[] = [];
+  for (const entry of node.elements) {
+    if (isString(entry)) {
+      patterns.push(entry.value);
+    } else if (entry?.type === 'SpreadElement') {
+      const values = staticPatterns(entry.argument, editor);
+      if (!values) {
+        return undefined;
+      }
+      patterns.push(...values);
+    } else {
+      return undefined;
+    }
+  }
+  return patterns.some((pattern) => pattern.startsWith('!')) ? undefined : patterns;
+}
+
+function booleanOption(
+  node: t.Node | undefined,
+  fallback: boolean | undefined,
+): boolean | undefined {
+  if (!node) {
+    return fallback;
+  }
+  return isBoolean(node) ? node.value : undefined;
+}
+
+function benchmarkPatterns(
+  node: t.Node | undefined,
+  inherited: TestScope['benchmark'],
+  editor: SourceEditor,
+): TestScope['benchmark'] {
+  if (!inherited || (node && !staticObject(node))) {
+    return undefined;
+  }
+  const patterns = { ...inherited };
+  for (const key of ['include', 'exclude', 'includeSource'] as const) {
+    const value = node && objectProperty(node, key)?.value;
+    if (value) {
+      const resolved = staticPatterns(value, editor);
+      if (!resolved) {
+        return undefined;
+      }
+      patterns[key] = [...(inherited[key] ?? []), ...resolved];
+    }
+  }
+  return patterns;
+}
+
+function matches(file: string, root: string, pattern: string): boolean {
+  return minimatch(path.relative(root, file).replaceAll('\\', '/'), pattern.replace(/^\.\//, ''), {
+    dot: true,
+  });
+}
+
+function insideDirectory(file: string, directory: string): boolean {
+  const relative = path.relative(directory, file);
+  return relative !== '..' && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative);
+}
+
+function matchesProject(name: string, pattern: string): boolean {
+  // Vitest supports only '*', case-insensitively; other glob syntax is literal.
+  const expression = pattern
+    .split('*')
+    .map((part) => part.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'))
+    .join('.*');
+  return new RegExp(`^${expression}$`, 'i').test(name);
+}
+
+function projectSelected(
+  test: t.ObjectExpression | undefined,
+  filters: string[],
+  inheritedBrowser: boolean | undefined,
+): boolean | undefined {
+  if (!filters.length) {
+    return true;
+  }
+  const name = test && objectProperty(test, 'name')?.value;
+  if (!isString(name)) {
+    return undefined;
+  }
+  const positives = filters.filter((pattern) => !pattern.startsWith('!'));
+  const excluded = (name: string) =>
+    filters.some((pattern) => pattern.startsWith('!') && matchesProject(name, pattern.slice(1)));
+  if (excluded(name.value)) {
+    return false;
+  }
+  if (!positives.length || positives.some((pattern) => matchesProject(name.value, pattern))) {
+    return true;
+  }
+  const browser = test && objectProperty(test, 'browser')?.value;
+  if (!browser) {
+    return inheritedBrowser === false ? false : undefined;
+  }
+  if (!staticObject(browser)) {
+    return undefined;
+  }
+  const enabled = objectProperty(browser, 'enabled')?.value;
+  if (isBoolean(enabled) && !enabled.value) {
+    return false;
+  }
+  const instances = objectProperty(browser, 'instances')?.value;
+  if (instances?.type !== 'ArrayExpression') {
+    return undefined;
+  }
+  for (const instance of instances.elements) {
+    if (!staticObject(instance)) {
+      return undefined;
+    }
+    const explicitName = objectProperty(instance, 'name')?.value;
+    const browserName = objectProperty(instance, 'browser')?.value;
+    const instanceName = isString(explicitName)
+      ? explicitName.value
+      : !explicitName && isString(browserName)
+        ? name.value
+          ? `${name.value} (${browserName.value})`
+          : browserName.value
+        : undefined;
+    // Instance-specific overrides need review; never silently skip an instance
+    // selected by its name rather than by its parent project name.
+    if (
+      !instanceName ||
+      (!excluded(instanceName) &&
+        positives.some((pattern) => matchesProject(instanceName, pattern)))
+    ) {
+      return undefined;
+    }
+  }
+  return false;
+}
+
+function exportedConfig(editor: SourceEditor, node: t.Node | undefined): t.Node | undefined {
+  if (node?.type === 'Identifier') {
+    const binding = editor.binding(node);
+    node =
+      binding?.constant && binding.declaration.type === 'VariableDeclarator'
+        ? (binding.declaration.init ?? undefined)
+        : undefined;
+  }
+  if (node?.type === 'CallExpression') {
+    node = ['defineConfig', 'defineProject'].includes(
+      importedName(editor, node.callee, CONFIG_SOURCES) ?? '',
+    )
+      ? node.arguments[0]
+      : undefined;
+  }
+  return node;
+}
+
+/** Vitest resolves local setup entries through local-pkg/mlly with import
+ * conditions, then falls back to the literal path. Do not guess TypeScript
+ * extensions or package exports that cannot be resolved from scanned files. */
+function resolveSetupFile(
+  sources: ReadonlyMap<string, string>,
+  root: string,
+  reference: string,
+): string | undefined {
+  const target = path.resolve(root, reference);
+  if (!/^\.\.?(?:[/\\]|$)/.test(reference) && !path.isAbsolute(reference)) {
+    // A bare-looking path may be a root-relative file, but do not confuse a
+    // declared package with a same-named local path.
+    const packageName = reference
+      .split('/')
+      .slice(0, reference.startsWith('@') ? 2 : 1)
+      .join('/');
+    for (const parent of sources.keys()) {
+      if (
+        path.basename(parent) !== 'package.json' ||
+        !insideDirectory(root, path.dirname(parent))
+      ) {
+        continue;
+      }
+      const manifest = JSON.parse(sources.get(parent)!.replace(/^\uFEFF/, ''));
+      if (
+        ['dependencies', 'devDependencies', 'peerDependencies', 'optionalDependencies'].some(
+          (key) => manifest[key]?.[packageName],
+        )
+      ) {
+        return undefined;
+      }
+    }
+    // After package resolution fails, Vitest falls back to the literal path,
+    // without trying local extensions or directory indexes for a bare entry.
+    return sources.has(target) ? target : undefined;
+  }
+  const extensions = ['.mjs', '.cjs', '.js', '.json'];
+  return [
+    target,
+    ...extensions.map((extension) =>
+      /[/\\]$/.test(reference) ? path.join(target, extension) : target + extension,
+    ),
+    ...extensions.map((extension) => path.join(target, 'index' + extension)),
+  ].find((candidate) => sources.has(candidate));
+}
+
+/** Resolve only selected configs and their project references. Unknown config
+ * or conflicting project globals requires review, not silent suppression. */
+export function resolveVitestV5TestModes(
+  sources: ReadonlyMap<string, string>,
+  configFiles: ReadonlySet<string>,
+  preserveV4: boolean,
+  entries: ConfigEntry[],
+): { modes: Map<string, VitestV5TestMode>; findings: VitestV5Finding[] } {
+  const scopes: TestScope[] = [];
+  const findings: VitestV5Finding[] = [];
+  const queue = [...entries];
+  const visitedEntries = new Set<string>();
+  for (const entry of queue) {
+    const key = JSON.stringify(entry);
+    if (visitedEntries.has(key)) {
+      continue;
+    }
+    visitedEntries.add(key);
+    const unknown = () => scopes.push({ root: entry.root });
+    if (entry.uncertain) {
+      unknown();
+      continue;
+    }
+    if (!entry.file) {
+      continue;
+    }
+    let found = false;
+    let editor: SourceEditor;
+    const visited = new Set<t.ObjectExpression>();
+    const walk = (
+      object: t.Node | undefined,
+      directory = entry.root,
+      base?: TestScope,
+      inline = false,
+    ) => {
+      found = true;
+      if (!staticObject(object, true)) {
+        unknown();
+        return;
+      }
+      if (visited.has(object)) {
+        return;
+      }
+      visited.add(object);
+      const test = objectProperty(object, 'test')?.value;
+      if (test && !staticObject(test, true)) {
+        unknown();
+        return;
+      }
+      // test.root overrides root. Inline roots are relative to the declaring
+      // project's root even when extends:false disables option inheritance.
+      const root =
+        (test && objectProperty(test, 'root')?.value) ?? objectProperty(object, 'root')?.value;
+      if (root && !isString(root)) {
+        unknown();
+        return;
+      }
+      const resolvedRoot =
+        (!inline && entry.rootOverride) ||
+        path.resolve(directory, isString(root) ? root.value : '.');
+      const projects = test && objectProperty(test, 'projects')?.value;
+      const selected = projects
+        ? true
+        : projectSelected(test, entry.projects ?? [], base ? base.browser : false);
+      if (selected === false) {
+        return;
+      }
+      const dirValue = test && objectProperty(test, 'dir')?.value;
+      let dir = base ? base.dir : '';
+      if (dirValue) {
+        dir = isString(dirValue) ? dirValue.value : undefined;
+      }
+      // Unlike globals, --dir is not a per-project CLI override in Vitest.
+      const effectiveDir = (!inline ? entry.dirOverride : undefined) ?? dir;
+      const include = test && objectProperty(test, 'include')?.value;
+      const exclude = test && objectProperty(test, 'exclude')?.value;
+      if (
+        (include && !staticPatterns(include, editor)) ||
+        (exclude && !staticPatterns(exclude, editor))
+      ) {
+        unknown();
+        return;
+      }
+      const browser = test && objectProperty(test, 'browser')?.value;
+      const enabled = staticObject(browser) ? objectProperty(browser, 'enabled')?.value : undefined;
+      let browserMode = base ? base.browser : false;
+      if (browser) {
+        browserMode = staticObject(browser) ? booleanOption(enabled, browserMode) : undefined;
+      }
+      const globals = test && objectProperty(test, 'globals')?.value;
+      const benchmark = test && objectProperty(test, 'benchmark')?.value;
+      const setup = test && objectProperty(test, 'setupFiles')?.value;
+      let setupFiles: string[] | undefined = [];
+      if (setup) {
+        setupFiles = isString(setup) ? [setup.value] : staticPatterns(setup, editor);
+      }
+      // Vitest passes dir to the globber as cwd, independently of root.
+      // Relative values use the command's cwd, including in project configs.
+      let discoveryRoot: string | undefined;
+      if (effectiveDir !== undefined) {
+        discoveryRoot = effectiveDir
+          ? path.resolve(entry.cwd ?? entry.root, effectiveDir)
+          : resolvedRoot;
+      }
+      const scope: TestScope = {
+        root: resolvedRoot,
+        dir,
+        discoveryRoot,
+        include: include
+          ? [...(base?.include ?? []), ...staticPatterns(include, editor)!]
+          : base?.include,
+        exclude: exclude
+          ? [...(base?.exclude ?? []), ...staticPatterns(exclude, editor)!]
+          : base?.exclude,
+        // Apply defaults only when matching: implicit parent defaults must not
+        // be appended to an inline project's explicit benchmark patterns.
+        benchmark: benchmarkPatterns(benchmark, base ? base.benchmark : {}, editor),
+        setupFiles:
+          setupFiles && (!base || base.setupFiles)
+            ? [...(base?.setupFiles ?? []), ...setupFiles]
+            : undefined,
+        browser: browserMode,
+        globals:
+          selected === undefined ? undefined : booleanOption(globals, base ? base.globals : false),
+      };
+      const addScope = () => {
+        const resolvedSetup = scope.setupFiles?.map((reference) =>
+          resolveSetupFile(sources, scope.root, reference),
+        );
+        const unresolvedSetup = !resolvedSetup || resolvedSetup.some((file) => !file);
+        if (!scope.discoveryRoot) {
+          editor.report(
+            dirValue ?? object,
+            'global-api-ownership',
+            'Resolve test.dir before migrating global APIs. The test discovery directory is not statically known.',
+          );
+        }
+        if (unresolvedSetup) {
+          editor.report(
+            setup ?? object,
+            'global-api-ownership',
+            'Resolve setupFiles before migrating global APIs. A setup entry cannot be resolved safely from the scanned files.',
+          );
+        }
+        if (!scope.benchmark) {
+          editor.report(
+            benchmark ?? object,
+            'global-api-ownership',
+            'Resolve test.benchmark file patterns before migrating global APIs. Benchmark file ownership is not statically known.',
+          );
+        }
+        scopes.push({
+          ...scope,
+          setupFiles: resolvedSetup?.filter((file): file is string => !!file),
+          unresolvedSetup,
+        });
+      };
+      if (!projects) {
+        addScope();
+        return;
+      }
+      if (projects.type !== 'ArrayExpression') {
+        unknown();
+        return;
+      }
+      const elements = projectElements(projects);
+      const excluded = elements
+        .filter(isString)
+        .map((node) => node.value)
+        .filter((value) => value.startsWith('!'))
+        .map((value) => value.slice(1));
+      for (const project of elements) {
+        if (isString(project)) {
+          if (project.value.startsWith('!')) {
+            continue;
+          }
+          const reference = project.value.replaceAll('\\', '/').replace('<rootDir>', scope.root);
+          const target = path.resolve(scope.root, reference);
+          const candidates = new Set<string>();
+          if (sources.has(target)) {
+            candidates.add(target);
+          }
+          const directoryConfig = defaultConfig(sources, target);
+          if (directoryConfig) {
+            candidates.add(directoryConfig);
+          }
+          for (const file of configFiles) {
+            if (
+              matches(file, scope.root, reference) ||
+              (matches(path.dirname(file), scope.root, reference) &&
+                defaultConfig(sources, path.dirname(file)) === file)
+            ) {
+              candidates.add(file);
+            }
+          }
+          if (!candidates.size) {
+            unknown();
+            continue;
+          }
+          for (const file of candidates) {
+            if (
+              excluded.some(
+                (pattern) =>
+                  matches(file, scope.root, pattern) ||
+                  matches(path.dirname(file), scope.root, pattern),
+              )
+            ) {
+              continue;
+            }
+            if (file === entry.file) {
+              addScope();
+            } else {
+              queue.push({
+                file,
+                root: path.dirname(file),
+                cwd: entry.cwd ?? entry.root,
+                projects: entry.projects,
+              });
+            }
+          }
+          continue;
+        }
+        if (!staticObject(project)) {
+          unknown();
+          continue;
+        }
+        const extendsValue = objectProperty(project, 'extends')?.value;
+        if (extendsValue && !isBoolean(extendsValue)) {
+          // A build-only base has no scope options to inherit. Otherwise its
+          // dir or setupFiles may reach outside the inline root: retain review
+          // instead of guessing that all inherited files live beneath it.
+          const baseFile = isString(extendsValue) && path.resolve(scope.root, extendsValue.value);
+          const baseSource = baseFile && sources.get(baseFile);
+          if (baseSource) {
+            const baseEditor = new SourceEditor(baseFile, baseSource);
+            const declaration = baseEditor.ast.body.find(
+              (node) => node.type === 'ExportDefaultDeclaration',
+            );
+            const baseObject = exportedConfig(baseEditor, declaration?.declaration);
+            if (staticObject(baseObject, true)) {
+              const baseTest = objectProperty(baseObject, 'test')?.value;
+              // Compatibility defaults such as clearMocks do not change file
+              // ownership. Accept them on later migration passes as well.
+              if (
+                !baseTest ||
+                (staticObject(baseTest, true) &&
+                  ![
+                    'root',
+                    'dir',
+                    'include',
+                    'exclude',
+                    'includeSource',
+                    'setupFiles',
+                    'globals',
+                    'browser',
+                    'benchmark',
+                    'projects',
+                    'name',
+                  ].some((key) => objectProperty(baseTest, key)))
+              ) {
+                walk(project, scope.root, undefined, true);
+                continue;
+              }
+            }
+          }
+          unknown();
+          continue;
+        }
+        const inherits = isBoolean(extendsValue) ? extendsValue.value : !preserveV4;
+        walk(project, scope.root, inherits ? scope : undefined, true);
+      }
+    };
+    try {
+      editor = new SourceEditor(entry.file, sources.get(entry.file)!);
+      editor.visit({
+        ExportDefaultDeclaration(node) {
+          walk(exportedConfig(editor, node.declaration));
+        },
+        AssignmentExpression(node) {
+          if (isModuleExports(editor, node.left)) {
+            walk(exportedConfig(editor, node.right));
+          }
+        },
+      });
+      findings.push(...editor.findings);
+    } catch {
+      unknown();
+    }
+    if (!found) {
+      unknown();
+    }
+  }
+  const modes = new Map<string, VitestV5TestMode>(
+    [...sources.keys()].map((file) => {
+      const matching: Array<{ scope: TestScope; certain: boolean }> = [];
+      let benchmarkFile = false;
+      for (const scope of scopes) {
+        // Setup files execute in this project regardless of include/exclude.
+        const setup = scope.setupFiles?.includes(file);
+        const inside = insideDirectory(file, scope.root);
+        const discoveryRoot = scope.discoveryRoot;
+        const test =
+          discoveryRoot &&
+          insideDirectory(file, discoveryRoot) &&
+          (scope.include ?? DEFAULT_TEST_INCLUDE).some((pattern) =>
+            matches(file, discoveryRoot, pattern),
+          ) &&
+          !(scope.exclude ?? DEFAULT_TEST_EXCLUDE).some((pattern) =>
+            matches(file, discoveryRoot, pattern),
+          );
+        const benchmark =
+          discoveryRoot &&
+          insideDirectory(file, discoveryRoot) &&
+          scope.benchmark &&
+          !(scope.benchmark.exclude ?? DEFAULT_BENCHMARK_EXCLUDE).some((pattern) =>
+            matches(file, discoveryRoot, pattern),
+          ) &&
+          ((scope.benchmark.include ?? DEFAULT_BENCHMARK_INCLUDE).some((pattern) =>
+            matches(file, discoveryRoot, pattern),
+          ) ||
+            (scope.benchmark.includeSource?.some((pattern) =>
+              matches(file, discoveryRoot, pattern),
+            ) &&
+              sources.get(file)?.includes('import.meta.vitest')));
+        benchmarkFile ||= !!benchmark;
+        if (setup || test || benchmark) {
+          matching.push({ scope, certain: true });
+        } else if (
+          ((!discoveryRoot || !scope.setupFiles || scope.unresolvedSetup) && inside) ||
+          (!scope.benchmark && discoveryRoot && insideDirectory(file, discoveryRoot))
+        ) {
+          matching.push({ scope, certain: false });
+        }
+      }
+      const browserModes = new Set(
+        matching.map(({ scope, certain }) => (certain ? scope.browser : undefined)),
+      );
+      const globals =
+        matching.length > 0 &&
+        matching.every(({ scope, certain }) => certain && scope.globals === true);
+      return [
+        file,
+        {
+          benchmark: benchmarkFile,
+          browser: browserModes.size === 1 ? browserModes.values().next().value : undefined,
+          globals,
+          reviewGlobals:
+            !globals && matching.some(({ scope, certain }) => !certain || scope.globals !== false),
+        },
+      ];
+    }),
+  );
+  return { modes, findings };
+}
diff --git a/packages/cli/src/migration/vitest-v5/source.ts b/packages/cli/src/migration/vitest-v5/source.ts
new file mode 100644
index 0000000000..5575ec7880
--- /dev/null
+++ b/packages/cli/src/migration/vitest-v5/source.ts
@@ -0,0 +1,985 @@
+import type * as t from '@oxc-project/types';
+
+import entryPoints from '../../vitest-v5-entry-points.json' with { type: 'json' };
+import {
+  NODE_SOURCES,
+  ROOT_TEST_SOURCES,
+  SourceEditor,
+  importedName,
+  memberName,
+  objectProperty,
+  propertyName,
+  staticObject,
+  testApiName,
+  isString,
+  isImportMetaVitest,
+  isBoolean,
+  isRegExp,
+  type RewriteResult,
+  type SourceOptions,
+} from './ast.ts';
+import { migrateBenchmarks } from './benchmarks.ts';
+
+const RUNNER_SYMBOLS: Record<string, string> = {
+  test: 'test',
+  it: 'it',
+  describe: 'describe',
+  suite: 'suite',
+  recordArtifact: 'recordArtifact',
+  TestAPI: 'TestAPI',
+  SuiteAPI: 'SuiteAPI',
+  SuiteCollector: 'SuiteCollector',
+  TestArtifact: 'TestArtifact',
+  File: 'RunnerTestFile',
+  Suite: 'RunnerTestSuite',
+  Test: 'RunnerTestCase',
+  Task: 'RunnerTask',
+  VitestRunner: 'VitestTestRunner',
+  VitestRunnerConfig: 'TestRunnerConfig',
+};
+const RUNNER_METHODS: Record<string, string> = {
+  getCurrentSuite: 'getCurrentSuite',
+  getCurrentTest: 'getCurrentTest',
+  createTaskCollector: 'createTaskCollector',
+  getFn: 'getTestFn',
+  getHooks: 'getSuiteHooks',
+  setFn: 'setTestFn',
+  setHooks: 'setSuiteHooks',
+};
+const EXPECT_SYMBOLS = new Set([
+  'expect',
+  'assert',
+  'should',
+  'createExpect',
+  'Assertion',
+  'AsymmetricMatchersContaining',
+  'ExpectStatic',
+  'JestAssertion',
+  'Matcher',
+  'Matchers',
+  'MatchersObject',
+  'MatcherState',
+]);
+const RUNNER_SOURCES = new Set([
+  '@vitest/runner',
+  'vitest/suite',
+  'vite-plus/test/suite',
+  'vite-plus/test/plugins/runner',
+]);
+const EXPECT_SOURCES = new Set(['@vitest/expect', 'vite-plus/test/plugins/expect']);
+const RUNNERS_SOURCES = new Set(['vitest/runners', 'vite-plus/test/runners']);
+const REMOVED_SOURCES = new Set([
+  'vitest/internal/module-runner',
+  'vite-plus/test/internal/module-runner',
+  '@vitest/runner/utils',
+  '@vitest/runner/types',
+  'vite-plus/test/plugins/runner-utils',
+  'vite-plus/test/plugins/runner-types',
+]);
+const LEGACY_API_SOURCES = new Set([
+  ...RUNNER_SOURCES,
+  ...RUNNERS_SOURCES,
+  ...EXPECT_SOURCES,
+  ...REMOVED_SOURCES,
+]);
+const RENDER_SOURCES = new Set(['vitest-browser-vue', 'vitest-browser-svelte']);
+const REGISTRATIONS = new Set(['test', 'it', 'describe', 'suite']);
+const ASYNC_CALLBACKS = new Set(['test', 'it', 'beforeEach', 'afterEach', 'beforeAll', 'afterAll']);
+const DOM_GLOBALS = new Set([
+  'window',
+  'document',
+  'navigator',
+  'location',
+  'matchMedia',
+  'innerWidth',
+  'innerHeight',
+  'screen',
+  'Element',
+  'HTMLElement',
+  'Node',
+  'Event',
+  'MutationObserver',
+  'ResizeObserver',
+  'requestAnimationFrame',
+  'cancelAnimationFrame',
+  'getComputedStyle',
+]);
+
+const CHILD_PROCESS_SOURCES = new Set(['node:child_process', 'child_process']);
+
+function replacementImport(source: string, name: string): string | undefined {
+  if (RUNNER_SOURCES.has(source)) {
+    return RUNNER_SYMBOLS[name];
+  }
+  if (RUNNERS_SOURCES.has(source) && name === 'VitestTestRunner') {
+    return 'TestRunner';
+  }
+  if (EXPECT_SOURCES.has(source) && EXPECT_SYMBOLS.has(name)) {
+    return name;
+  }
+  return undefined;
+}
+
+function processApiName(editor: SourceEditor, node: t.Node): string | undefined {
+  const imported = importedName(editor, node, CHILD_PROCESS_SOURCES);
+  if (imported) {
+    return imported;
+  }
+  let name = memberName(node);
+  let receiver = node.type === 'MemberExpression' ? node.object : node;
+  let declaration = editor.binding(receiver)?.declaration;
+  const parent = declaration && editor.parent(declaration);
+  if (
+    declaration?.type === 'ImportDefaultSpecifier' &&
+    parent?.type === 'ImportDeclaration' &&
+    CHILD_PROCESS_SOURCES.has(parent.source.value)
+  ) {
+    return name;
+  }
+  if (declaration?.type === 'Property' && parent?.type === 'ObjectPattern') {
+    name = propertyName(declaration.key);
+    declaration = editor.parent(parent);
+  }
+  if (declaration?.type === 'VariableDeclarator' && declaration.init) {
+    receiver = declaration.init;
+  }
+  return receiver.type === 'CallExpression' &&
+    receiver.callee.type === 'Identifier' &&
+    receiver.callee.name === 'require' &&
+    !editor.binding(receiver.callee) &&
+    isString(receiver.arguments[0]) &&
+    CHILD_PROCESS_SOURCES.has(receiver.arguments[0].value)
+    ? name
+    : undefined;
+}
+
+/** A package-name string in plugin code or documentation is not a runner
+ * dependency. Module references, in-source APIs, and bound process calls establish usage. */
+export function hasVitestV5SourceUsage(file: string, source: string): boolean {
+  if (!/vitest|vite-plus|\bvp\b/.test(source)) {
+    return false;
+  }
+  let editor: SourceEditor;
+  try {
+    editor = new SourceEditor(file, source);
+  } catch {
+    // Do not let unsupported syntax bypass the version gate. The source pass
+    // retains its parse diagnostic when the original runner can be resolved.
+    return true;
+  }
+  let used = editor.comments.some(({ start, end }) =>
+    /^\/\/\/\s*<reference\s+types\s*=\s*['"](?:vitest(?:\/[^'"]*)?|@vitest\/[^'"]+|vite-plus\/test(?:\/[^'"]*)?)['"]/.test(
+      source.slice(start, end),
+    ),
+  );
+  const moduleReference = (node: t.Node | null | undefined) => {
+    if (
+      isString(node) &&
+      /^(?:vitest(?:\/|$)|@vitest\/|vite-plus\/test(?:\/|$))/.test(node.value)
+    ) {
+      used = true;
+    }
+  };
+  editor.visit({
+    MemberExpression(node) {
+      if (isImportMetaVitest(node)) {
+        used = true;
+      }
+    },
+    ImportDeclaration: (node) => moduleReference(node.source),
+    ExportNamedDeclaration: (node) => moduleReference(node.source),
+    ExportAllDeclaration: (node) => moduleReference(node.source),
+    ImportExpression: (node) => moduleReference(node.source),
+    TSImportType: (node) => moduleReference(node.source),
+    TSExternalModuleReference: (node) => moduleReference(node.expression),
+    TSModuleDeclaration: (node) => moduleReference(node.id),
+    CallExpression(node) {
+      if (
+        node.callee.type === 'Identifier' &&
+        node.callee.name === 'require' &&
+        !editor.binding(node.callee)
+      ) {
+        moduleReference(node.arguments[0]);
+      }
+      const command = node.arguments[0];
+      if (
+        ['exec', 'execSync', 'execFile', 'execFileSync', 'spawn', 'spawnSync'].includes(
+          processApiName(editor, node.callee) ?? '',
+        ) &&
+        isString(command)
+      ) {
+        const args = node.arguments[1];
+        const argv =
+          args?.type === 'ArrayExpression' && args.elements.every(isString)
+            ? args.elements.map((arg) => arg.value).join(' ')
+            : '';
+        if (/\b(?:vitest|vp\s+test)(?:\s|$)/.test(`${command.value} ${argv}`)) {
+          used = true;
+        }
+      }
+    },
+  });
+  return used;
+}
+
+function looksLikeConstructorMock(editor: SourceEditor, node: t.CallExpression): boolean {
+  if (
+    node.arguments.some(
+      (argument) => argument.type === 'ClassExpression' || argument.type === 'FunctionExpression',
+    )
+  ) {
+    return true;
+  }
+  if (
+    memberName(node.callee) === 'spyOn' &&
+    isString(node.arguments[1]) &&
+    /^[A-Z]/.test(node.arguments[1].value)
+  ) {
+    return true;
+  }
+  const parent = editor.parent(node);
+  if (parent?.type === 'VariableDeclarator' && parent.id.type === 'Identifier') {
+    const name = parent.id.name;
+    const binding = editor.binding(parent.id);
+    return (
+      /^[A-Z]/.test(name) ||
+      !!binding?.references.some((ref) => editor.parent(ref)?.type === 'NewExpression')
+    );
+  }
+  return false;
+}
+
+function chain(
+  node: t.Node,
+  isApi: (node: t.Node) => boolean,
+): { root: t.Node; members: string[]; calls: t.CallExpression[] } {
+  const members: string[] = [];
+  const calls: t.CallExpression[] = [];
+  while (node.type === 'MemberExpression' || node.type === 'CallExpression') {
+    if (node.optional) {
+      break;
+    }
+    if (isApi(node)) {
+      break;
+    }
+    if (node.type === 'MemberExpression') {
+      const name = memberName(node);
+      if (name === undefined) {
+        break;
+      }
+      members.push(name);
+      node = node.object;
+    } else {
+      calls.push(node);
+      node = node.callee;
+    }
+  }
+  return { root: node, members, calls };
+}
+
+export function migrateVitestV5Source(
+  file: string,
+  source: string,
+  options: SourceOptions,
+): RewriteResult {
+  const result = rewriteSource(file, source, options);
+  if (options.reviewGlobals && !options.globals) {
+    // Probe without applying edits: unknown ownership matters only when it
+    // prevents a compatibility edit or diagnostic, not for every test/expect.
+    const withGlobals = rewriteSource(file, source, { ...options, globals: true });
+    if (
+      result.content !== withGlobals.content ||
+      withGlobals.findings.some(
+        (finding) =>
+          !result.findings.some(
+            (existing) =>
+              existing.code === finding.code &&
+              existing.line === finding.line &&
+              existing.column === finding.column &&
+              existing.message === finding.message,
+          ),
+      )
+    ) {
+      result.findings.push({
+        file,
+        line: 1,
+        column: 1,
+        severity: 'review',
+        code: 'global-api-ownership',
+        message:
+          'Resolve the Vitest project ownership of this file before migrating its affected global APIs. Global API edits were not applied because config selection, file scope, or globals settings are unresolved or conflicting.',
+      });
+    }
+  }
+  return result;
+}
+
+function rewriteSource(file: string, source: string, options: SourceOptions): RewriteResult {
+  const editor = new SourceEditor(file, source);
+  const reviewV4 = options.preserveV4 || options.reviewV4;
+  const benchmarks = migrateBenchmarks(editor, options.globals);
+  const runnerAliases: string[] = [];
+  const asyncFunctions = new Set<t.Node>();
+  // Import edits are offset-based, so bindings still refer to the old module
+  // while this traversal visits the assertions that must migrate with them.
+  function apiName(node: t.Node): string | undefined {
+    return (
+      testApiName(editor, node, options.globals) ??
+      (importedName(editor, node, EXPECT_SOURCES) === 'expect' ? 'expect' : undefined)
+    );
+  }
+  function canAwait(node: t.Node): boolean {
+    const fn = editor.functionParent(node);
+    if (!fn) {
+      return false;
+    }
+    if (fn.async) {
+      return true;
+    }
+    if (
+      (fn.type !== 'ArrowFunctionExpression' && fn.type !== 'FunctionExpression') ||
+      fn.generator ||
+      fn.returnType
+    ) {
+      return false;
+    }
+    const parent = editor.parent(fn);
+    if (parent?.type !== 'CallExpression' || !parent.arguments.includes(fn)) {
+      return false;
+    }
+    const { root, members } = chain(parent.callee, (node) => !!apiName(node));
+    if (!ASYNC_CALLBACKS.has(apiName(root) ?? '') || members.includes('extend')) {
+      return false;
+    }
+    if (!asyncFunctions.has(fn)) {
+      editor.edit(fn.start, fn.start, 'async ');
+      asyncFunctions.add(fn);
+    }
+    return true;
+  }
+
+  function unsupported(node: t.Node, source: string, symbol: string, typeOnly: boolean) {
+    editor.report(
+      node,
+      'removed-api',
+      `Migrate ${symbol} from ${source} manually; no reviewed root v5 replacement exists.`,
+      typeOnly ? 'review' : 'block',
+    );
+  }
+
+  function dynamicImport(node: t.Node, source: string): void {
+    if (LEGACY_API_SOURCES.has(source)) {
+      unsupported(node, source, 'dynamic/CommonJS import', false);
+    }
+  }
+
+  editor.visit({
+    ImportDeclaration(node) {
+      const source = node.source.value;
+      if (ROOT_TEST_SOURCES.has(source)) {
+        for (const specifier of node.specifiers) {
+          if (
+            specifier.type === 'ImportSpecifier' &&
+            propertyName(specifier.imported) === 'bench' &&
+            node.importKind !== 'type' &&
+            specifier.importKind !== 'type' &&
+            !benchmarks.imports.has(specifier)
+          ) {
+            editor.report(
+              specifier,
+              'benchmark-api',
+              'Migrate these bench references manually: automatic migration requires direct calls with inline or locally resolved zero-argument callbacks and no benchmark options. Review wrappers, comparison groups, and escaped references.',
+              'block',
+            );
+          }
+        }
+      }
+      if (source in entryPoints) {
+        editor.replace(
+          node.source,
+          JSON.stringify(entryPoints[source as keyof typeof entryPoints]),
+        );
+        return;
+      }
+      if (!LEGACY_API_SOURCES.has(source)) {
+        return;
+      }
+      const imports: string[] = [];
+      const constants: string[] = [];
+      const remaining: string[] = [];
+      let runnerName: string | undefined;
+      for (const specifier of node.specifiers) {
+        const typeOnly =
+          node.importKind === 'type' ||
+          (specifier.type === 'ImportSpecifier' && specifier.importKind === 'type');
+        const name = specifier.type === 'ImportSpecifier' ? propertyName(specifier.imported)! : '*';
+        const target = replacementImport(source, name);
+        if (target) {
+          imports.push(
+            `${typeOnly ? 'type ' : ''}${target}${specifier.local.name === target ? '' : ` as ${specifier.local.name}`}`,
+          );
+        } else if (RUNNER_SOURCES.has(source) && RUNNER_METHODS[name] && !typeOnly) {
+          if (!runnerName) {
+            runnerName = editor.uniqueName('VitestTestRunner');
+            imports.push(`TestRunner as ${runnerName}`);
+          }
+          // Static fields are the original functions, so aliases retain function
+          // identity and also work as callback values (not only direct calls).
+          constants.push(`const ${specifier.local.name} = ${runnerName}.${RUNNER_METHODS[name]};`);
+        } else {
+          unsupported(specifier, source, name, typeOnly);
+          remaining.push(editor.text(specifier));
+        }
+      }
+      if (!node.specifiers.length) {
+        unsupported(node, source, 'side-effect import', false);
+      }
+      if (imports.length) {
+        // A default or namespace import cannot be emitted inside named-import
+        // braces. Keep this blocked declaration intact for manual migration.
+        if (node.specifiers.some((specifier) => specifier.type !== 'ImportSpecifier')) {
+          return;
+        }
+        const kept = remaining.length
+          ? `import ${node.importKind === 'type' ? 'type ' : ''}{ ${remaining.join(', ')} } from ${JSON.stringify(source)};\n`
+          : '';
+        editor.replace(node, `${kept}import { ${imports.join(', ')} } from 'vite-plus/test';`);
+        runnerAliases.push(...constants);
+      }
+    },
+    ExportNamedDeclaration(node) {
+      const source = node.source?.value;
+      if (!source) {
+        return;
+      }
+      if (source in entryPoints) {
+        editor.replace(
+          node.source!,
+          JSON.stringify(entryPoints[source as keyof typeof entryPoints]),
+        );
+      } else if (LEGACY_API_SOURCES.has(source)) {
+        // Re-exports can expose a library contract. Do not silently replace it.
+        for (const specifier of node.specifiers) {
+          unsupported(
+            specifier,
+            source,
+            're-export',
+            node.exportKind === 'type' ||
+              (specifier.type === 'ExportSpecifier' && specifier.exportKind === 'type'),
+          );
+        }
+      }
+    },
+    ExportAllDeclaration(node) {
+      const source = node.source.value;
+      if (LEGACY_API_SOURCES.has(source)) {
+        unsupported(node, source, 'export *', node.exportKind === 'type');
+      }
+    },
+    CallExpression(node) {
+      // Babel represented these as OptionalCallExpression, outside this pass.
+      // Retain that conservative behavior for Oxc's optional CallExpression.
+      if (node.optional) {
+        return;
+      }
+      const parent = editor.parent(node);
+      const { root, members } = chain(node.callee, (node) => !!apiName(node));
+      const name = apiName(root);
+      if (
+        name === 'bench' &&
+        (root.type !== 'Identifier' || !editor.binding(root)) &&
+        !benchmarks.calls.has(node)
+      ) {
+        editor.report(
+          node,
+          'benchmark-api',
+          'Migrate this bench call manually: automatic migration requires a direct call with an inline or locally resolved zero-argument callback and no benchmark options.',
+          'block',
+        );
+      }
+
+      if (REGISTRATIONS.has(name ?? '')) {
+        const seqMember =
+          node.callee.type === 'MemberExpression' && memberName(node.callee) === 'sequential'
+            ? node.callee
+            : undefined;
+        const opts = node.arguments[1];
+        const sequentialOption = staticObject(opts)
+          ? objectProperty(opts, 'sequential')
+          : undefined;
+        let unresolvedSequential = members.includes('sequential');
+        if (seqMember && node.arguments.length >= 2) {
+          if (
+            staticObject(opts) &&
+            !objectProperty(opts, 'concurrent') &&
+            (!sequentialOption ||
+              (isBoolean(sequentialOption.value) && sequentialOption.value.value))
+          ) {
+            editor.edit(seqMember.object.end, seqMember.end, '');
+            if (!sequentialOption) {
+              editor.add(opts, 'concurrent', 'false');
+            }
+            unresolvedSequential = false;
+          } else if (
+            (opts?.type === 'ArrowFunctionExpression' || opts?.type === 'FunctionExpression') &&
+            (node.arguments.length === 2 ||
+              (node.arguments.length === 3 &&
+                node.arguments[2].type === 'Literal' &&
+                typeof node.arguments[2].value === 'number' &&
+                /^\s*,\s*$/.test(editor.source.slice(opts.end, node.arguments[2].start))))
+          ) {
+            const timeout = node.arguments[2];
+            editor.edit(seqMember.object.end, seqMember.end, '');
+            editor.edit(
+              opts.start,
+              opts.start,
+              `{ concurrent: false${timeout ? `, timeout: ${editor.text(timeout)}` : ''} }, `,
+            );
+            if (timeout) {
+              // Vitest accepts three arguments; a fourth timeout is ignored.
+              editor.edit(opts.end, timeout.end, '');
+            }
+            unresolvedSequential = false;
+          } else {
+            editor.report(
+              node,
+              'sequential-api',
+              'Replace sequential with concurrent: false after resolving the options and callback.',
+            );
+          }
+        } else if (members.includes('sequential')) {
+          editor.report(
+            node,
+            'sequential-api',
+            'Review the sequential modifier chain and replace it with concurrent: false.',
+          );
+        }
+        for (const argument of node.arguments.slice(1)) {
+          if (unresolvedSequential || !staticObject(argument)) {
+            continue;
+          }
+          const sequential = objectProperty(argument, 'sequential');
+          if (!sequential) {
+            continue;
+          }
+          if (
+            isBoolean(sequential.value) &&
+            sequential.value.value &&
+            !objectProperty(argument, 'concurrent')
+          ) {
+            editor.replace(sequential.key, 'concurrent');
+            editor.replace(sequential.value, 'false');
+          } else {
+            editor.report(
+              sequential,
+              'sequential-api',
+              'Resolve sequential/concurrent options explicitly before removing sequential.',
+            );
+          }
+        }
+      }
+
+      if (name === 'vi' || name === 'vitest') {
+        const method = memberName(node.callee);
+        if (['mock', 'unmock', 'hoisted'].includes(method ?? '')) {
+          let statement = parent;
+          while (
+            statement &&
+            !statement.type.endsWith('Statement') &&
+            statement.type !== 'VariableDeclaration' &&
+            statement.type !== 'Program'
+          ) {
+            statement = editor.parent(statement);
+          }
+          // A top-level variable initializer for vi.hoisted is valid too.
+          if (
+            editor.functionParent(node) ||
+            !statement ||
+            editor.parent(statement)?.type !== 'Program'
+          ) {
+            editor.report(
+              node,
+              'nested-hoisted-mock',
+              'Move this hoisted mock to the top level after reviewing captured scope.',
+            );
+          }
+        }
+        if (
+          reviewV4 &&
+          (options.browser || (options.browser === undefined && options.browserPossible)) &&
+          method === 'mock' &&
+          node.arguments.length === 1
+        ) {
+          editor.report(
+            node,
+            'browser-automock',
+            'Browser automocks now keep mock defaults; choose { spy: true } if real implementations are required.',
+          );
+        }
+        if (
+          reviewV4 &&
+          (method === 'fn' || method === 'spyOn') &&
+          looksLikeConstructorMock(editor, node)
+        ) {
+          editor.report(
+            node,
+            'class-mock',
+            'If this mock replaces a constructor, review its prototype, methods, and instanceof behavior.',
+          );
+        }
+        if (reviewV4 && method === 'setSystemTime' && /\bTemporal\b/.test(source)) {
+          editor.report(
+            node,
+            'temporal-system-time',
+            'vi.setSystemTime now changes Temporal even without fake timers; toNotFake does not preserve this behavior.',
+          );
+        }
+      }
+      if (
+        reviewV4 &&
+        memberName(node.callee) === 'mockImplementation' &&
+        looksLikeConstructorMock(editor, node)
+      ) {
+        editor.report(
+          node,
+          'class-mock',
+          'Review constructor mock implementations and their inherited prototypes.',
+        );
+      }
+
+      if (name === 'expect') {
+        const matcher = memberName(node.callee);
+        const first = node.arguments[0];
+        if (
+          options.preserveV4 &&
+          ['toThrow', 'toThrowError'].includes(matcher ?? '') &&
+          isString(first) &&
+          first.value === ''
+        ) {
+          editor.replace(first, '/^$/');
+        }
+        if (reviewV4 && matcher === 'toHaveTextContent') {
+          const browserAssertion = members.includes('element') || options.browser === true;
+          const literal = isString(first) || isRegExp(first);
+          if (options.preserveV4 && browserAssertion && literal) {
+            const callee = node.callee as t.MemberExpression;
+            editor.replace(
+              callee.property,
+              callee.computed ? JSON.stringify('toMatchTextContent') : 'toMatchTextContent',
+            );
+          } else if (browserAssertion && !literal) {
+            editor.report(
+              node,
+              'text-content',
+              'Choose toMatchTextContent for v4 partial/regex matching after resolving the expected value.',
+            );
+          } else if (options.browser === undefined && options.browserPossible) {
+            editor.report(
+              node,
+              'text-content-project',
+              "Resolve this assertion's test project: browser assertions need toMatchTextContent for v4 partial matching; keep Node jest-dom assertions unchanged.",
+            );
+          }
+        }
+        if (reviewV4 && members.includes('poll') && matcher !== 'poll') {
+          editor.report(
+            node,
+            'poll-timeout',
+            'Review the configured expect.poll timeout; v5 rejects assertions that finish after it.',
+          );
+        }
+        const asynchronous = members.some((member) =>
+          [
+            'resolves',
+            'rejects',
+            'poll',
+            'element',
+            'toMatchFileSnapshot',
+            'toMatchScreenshot',
+          ].includes(member),
+        );
+        if (asynchronous && parent?.type === 'ExpressionStatement') {
+          if (canAwait(node)) {
+            editor.edit(node.start, node.start, 'await ');
+          } else {
+            editor.report(
+              node,
+              'unawaited-assertion',
+              'Await or return this asynchronous assertion in an async-compatible function.',
+            );
+          }
+        } else if (
+          asynchronous &&
+          parent?.type !== 'MemberExpression' &&
+          parent?.type !== 'AwaitExpression' &&
+          parent?.type !== 'ReturnStatement'
+        ) {
+          editor.report(
+            node,
+            'unawaited-assertion',
+            'Check that the result of this asynchronous assertion is awaited or returned.',
+          );
+        }
+      }
+
+      if (
+        importedName(editor, node.callee, RENDER_SOURCES) === 'render' &&
+        parent?.type !== 'AwaitExpression' &&
+        parent?.type !== 'ReturnStatement'
+      ) {
+        if (canAwait(node)) {
+          editor.edit(node.start, node.start, '(await ');
+          editor.edit(node.end, node.end, ')');
+        } else {
+          editor.report(
+            node,
+            'async-render',
+            'Await render from vitest-browser-vue/svelte after making the enclosing contract async-compatible.',
+          );
+        }
+      }
+
+      if (
+        importedName(editor, node.callee, NODE_SOURCES) === 'resolveConfig' &&
+        options.preserveV4
+      ) {
+        const declaration = parent && editor.parent(parent);
+        if (
+          parent?.type === 'AwaitExpression' &&
+          declaration?.type === 'VariableDeclarator' &&
+          declaration.id.type === 'ObjectPattern'
+        ) {
+          const props = declaration.id.properties;
+          if (
+            props.every(
+              (prop) =>
+                prop.type === 'Property' &&
+                !prop.computed &&
+                prop.value.type === 'Identifier' &&
+                ['viteConfig', 'vitestConfig'].includes(propertyName(prop.key) ?? ''),
+            )
+          ) {
+            const vite = props.find(
+              (prop) => prop.type === 'Property' && propertyName(prop.key) === 'viteConfig',
+            ) as t.BindingProperty | undefined;
+            const vitest = props.find(
+              (prop) => prop.type === 'Property' && propertyName(prop.key) === 'vitestConfig',
+            ) as t.BindingProperty | undefined;
+            const local = vite ? editor.text(vite.value) : editor.uniqueName('viteConfig');
+            editor.replace(declaration.id, local);
+            if (vitest) {
+              editor.edit(
+                declaration.end,
+                declaration.end,
+                `, ${editor.text(vitest.value)} = ${local}.test`,
+              );
+            }
+          } else {
+            editor.report(
+              declaration,
+              'resolve-config',
+              'Replace resolveConfig pair destructuring with the Vite config return value and its .test property.',
+            );
+          }
+        } else {
+          editor.report(
+            node,
+            'resolve-config',
+            'Review resolveConfig consumers; the v5 return value is the Vite config with Vitest options under .test.',
+          );
+        }
+      }
+
+      if (memberName(node.callee) === 'collect') {
+        const object = (node.callee as t.MemberExpression).object;
+        const binding = editor.binding(object);
+        let initializer =
+          binding?.constant && binding.declaration.type === 'VariableDeclarator'
+            ? binding.declaration.init
+            : undefined;
+        if (initializer?.type === 'AwaitExpression') {
+          initializer = initializer.argument;
+        }
+        const known =
+          initializer?.type === 'CallExpression' &&
+          ['createVitest', 'startVitest'].includes(
+            importedName(editor, initializer.callee, NODE_SOURCES) ?? '',
+          );
+        // collect(filters?, options?) places staticParse in the second argument.
+        const opts = node.arguments[1];
+        if (
+          known &&
+          options.preserveV4 &&
+          node.arguments.length <= 2 &&
+          !node.arguments.some((argument) => argument.type === 'SpreadElement') &&
+          (!opts || staticObject(opts))
+        ) {
+          if (staticObject(opts)) {
+            editor.add(opts, 'staticParse', 'false');
+          } else {
+            editor.edit(
+              node.end - 1,
+              node.end - 1,
+              `${node.arguments.length ? ', ' : 'undefined, '}{ staticParse: false }`,
+            );
+          }
+        } else if (
+          reviewV4 &&
+          (!known ||
+            node.arguments.some((argument) => argument.type === 'SpreadElement') ||
+            (opts && !staticObject(opts)))
+        ) {
+          editor.report(
+            node,
+            'static-collect',
+            'If this is Vitest.collect(), review staticParse and set it to false to retain runtime collection.',
+          );
+        }
+      }
+      if (
+        node.callee.type === 'Identifier' &&
+        node.callee.name === 'require' &&
+        !editor.binding(node.callee) &&
+        isString(node.arguments[0])
+      ) {
+        dynamicImport(node, node.arguments[0].value);
+      }
+    },
+    ImportExpression(node) {
+      if (isString(node.source)) {
+        dynamicImport(node, node.source.value);
+      }
+    },
+    MemberExpression(node) {
+      if (reviewV4 && ['VITEST_POOL_ID', 'VITEST_WORKER_ID'].includes(memberName(node) ?? '')) {
+        editor.report(
+          node,
+          'worker-id',
+          'Review worker/pool ID arithmetic and indexing: IDs now start at 1, not 0.',
+        );
+      }
+    },
+    VariableDeclarator(node) {
+      if (reviewV4 && node.id.type === 'ObjectPattern') {
+        for (const prop of node.id.properties) {
+          if (
+            prop.type === 'Property' &&
+            ['VITEST_POOL_ID', 'VITEST_WORKER_ID'].includes(propertyName(prop.key) ?? '')
+          ) {
+            editor.report(
+              prop,
+              'worker-id',
+              'Review worker/pool ID arithmetic and indexing: IDs now start at 1, not 0.',
+            );
+          }
+        }
+      }
+    },
+    AssignmentExpression(node) {
+      if (reviewV4 && /\boriginals\b/.test(editor.text(node.right))) {
+        editor.report(
+          node,
+          'global-descriptors',
+          'populateGlobal().originals stores descriptors; restore them with Object.defineProperty, not assignment.',
+        );
+      }
+      const left = node.left;
+      if (
+        reviewV4 &&
+        ((left.type === 'MemberExpression' &&
+          left.object.type === 'Identifier' &&
+          !editor.binding(left.object) &&
+          ['window', 'globalThis', 'global'].includes(editor.text(left.object)) &&
+          DOM_GLOBALS.has(memberName(left) ?? '')) ||
+          (left.type === 'Identifier' && DOM_GLOBALS.has(left.name) && !editor.binding(left)))
+      ) {
+        editor.report(
+          node,
+          'dom-global',
+          'In jsdom/happy-dom, global assignment also updates the window; review this DOM override.',
+        );
+      }
+    },
+    TSInterfaceDeclaration(node) {
+      if (
+        reviewV4 &&
+        ['Assertion', 'Matchers'].includes(node.id.name) &&
+        (node.typeParameters?.params.length ?? 0) < 2
+      ) {
+        editor.report(
+          node,
+          'assertion-types',
+          'Update custom matcher declarations for the v5 return and received type parameters; review jest.Matchers augmentations.',
+        );
+      }
+    },
+    TSTypeReference(node) {
+      const name = editor.text(node.typeName);
+      if (
+        reviewV4 &&
+        ['Assertion', 'Matchers', 'jest.Matchers'].includes(name) &&
+        (node.typeArguments?.params.length ?? 0) < 2
+      ) {
+        editor.report(
+          node,
+          'assertion-types',
+          'Review old assertion generics; v5 includes return and received types.',
+        );
+      }
+    },
+    TSImportType(node) {
+      const source = node.source.value;
+      if (LEGACY_API_SOURCES.has(source)) {
+        unsupported(node, source, 'type import', true);
+      }
+    },
+    Literal(node) {
+      if (!isString(node)) {
+        return;
+      }
+      const value = node.value;
+      if (/\/__vitest__\//.test(value) && !/[?&]token=/.test(value)) {
+        editor.report(
+          node,
+          'ui-token',
+          'Use the authenticated UI URL printed by Vitest, including its token.',
+        );
+      }
+      if (/\/__vitest_test__\//.test(value) && !/[?&]sessionId=/.test(value)) {
+        editor.report(
+          node,
+          'browser-session',
+          'Use the browser orchestrator URL opened by Vitest, including its sessionId.',
+        );
+      }
+    },
+  });
+  if (runnerAliases.length) {
+    // Imports are hoisted, but these aliases are not. Initialize them before
+    // any executable statement, even when an import occurs later in the file.
+    // Retain directives (and the shebang) at the start of the module.
+    const firstStatement = editor.ast.body.find(
+      (node) =>
+        node.type !== 'ImportDeclaration' &&
+        !(node.type === 'ExpressionStatement' && node.directive),
+    );
+    const offset = firstStatement?.start ?? source.length;
+    editor.edit(offset, offset, `${firstStatement ? '' : '\n'}${runnerAliases.join('\n')}\n`);
+  }
+  const result = editor.finish();
+  const benchmark =
+    benchmarks.imports.values().next().value ??
+    benchmarks.bindings.values().next().value ??
+    benchmarks.calls.values().next().value;
+  if (benchmark && result.content === source) {
+    // Suppress removed-API findings only for edits that survive validation.
+    // A rollback retains the legacy API and must stop dependency upgrades.
+    editor.report(
+      benchmark,
+      'benchmark-api',
+      'The benchmark rewrite was discarded. Migrate the remaining legacy bench API manually before upgrading to Vitest v5.',
+      'block',
+    );
+  }
+  return result;
+}
diff --git a/packages/cli/src/migration/vitest-v5/webdriverio.ts b/packages/cli/src/migration/vitest-v5/webdriverio.ts
new file mode 100644
index 0000000000..36a1cf012c
--- /dev/null
+++ b/packages/cli/src/migration/vitest-v5/webdriverio.ts
@@ -0,0 +1,370 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+import { applyEdits, modify, parse } from 'jsonc-parser';
+import semver from 'semver';
+import { parseDocument } from 'yaml';
+
+import { PackageManager, type WorkspacePackage } from '../../types/index.ts';
+import { VITE_PLUS_OVERRIDE_PACKAGES } from '../../utils/constants.ts';
+import { extractOverrideTargetName } from '../../utils/package-overrides.ts';
+import { detectPackageMetadata } from '../../utils/package.ts';
+import { extractOverrideParentSegments, usesWebdriverioProvider } from '../migrator.ts';
+import { WEBDRIVERIO_PROVIDER } from '../migrator/shared.ts';
+import type { VitestV5Finding } from './ast.ts';
+
+// This is a migration floor, not a lockstep Vitest version. The community
+// provider has its own releases; never downgrade or repin a newer user version.
+// https://vitest.dev/guide/migration/#package-migration
+const MIN_VERSION = '5.0.0';
+const DEFAULT_SPEC = '^5.0.0';
+const REGISTRY_ALIAS = `npm:${WEBDRIVERIO_PROVIDER}@`;
+const INSTALL_FIELDS = ['dependencies', 'devDependencies', 'optionalDependencies'] as const;
+
+/** Narrow mixed ranges without discarding the user's newer allowed versions. */
+export function webdriverioMigrationSpec(spec: string): string | undefined {
+  if (spec.startsWith(REGISTRY_ALIAS)) {
+    const migrated = webdriverioMigrationSpec(spec.slice(REGISTRY_ALIAS.length));
+    return migrated === undefined ? undefined : `${REGISTRY_ALIAS}${migrated}`;
+  }
+  if (!semver.validRange(spec)) {
+    return undefined;
+  }
+  const range = new semver.Range(spec);
+  const branches = range.set.map((set) => set.map((item) => item.value).join(' '));
+  if (
+    branches.every((branch) => {
+      const min = semver.minVersion(branch);
+      return min && semver.gte(min, MIN_VERSION);
+    })
+  ) {
+    return spec;
+  }
+  const narrowed = branches
+    .map((branch) => `${branch} >=${MIN_VERSION}`.trim())
+    .filter((branch) => semver.minVersion(branch) !== null);
+  return narrowed.length ? narrowed.join(' || ') : DEFAULT_SPEC;
+}
+
+function object(value: unknown): Record<string, unknown> {
+  return value !== null && typeof value === 'object' && !Array.isArray(value)
+    ? (value as Record<string, unknown>)
+    : {};
+}
+
+/** Compose dependency edits into the versioned preflight's in-memory sources.
+ * No writes or network resolution: unresolved custom specs block before install. */
+export function migrateWebdriverioDependencies(
+  workspace: { rootDir: string; packageManager?: PackageManager; packages?: WorkspacePackage[] },
+  sources: Map<string, string>,
+  inputs: Map<string, string | null>,
+): VitestV5Finding[] {
+  const findings: VitestV5Finding[] = [];
+  const rootManifest = path.join(workspace.rootDir, 'package.json');
+  const manifests = [
+    rootManifest,
+    ...(workspace.packages ?? []).map((pkg) =>
+      path.resolve(workspace.rootDir, pkg.path, 'package.json'),
+    ),
+  ];
+  const read = (file: string): Record<string, unknown> => {
+    const source = sources.get(file);
+    if (source === undefined) {
+      return {};
+    }
+    return object(file.endsWith('.json') ? parse(source) : parseDocument(source).toJS());
+  };
+  const get = (file: string, keys: string[]): unknown =>
+    keys.reduce<unknown>((value, key) => object(value)[key], read(file));
+  const set = (file: string, keys: string[], value: string | undefined) => {
+    if (get(file, keys) === value) {
+      return;
+    }
+    const source = sources.get(file)!;
+    if (file.endsWith('.json')) {
+      sources.set(
+        file,
+        applyEdits(
+          source,
+          modify(source, keys, value, {
+            formattingOptions: { insertSpaces: true, tabSize: 2 },
+          }),
+        ),
+      );
+    } else {
+      const doc = parseDocument(source);
+      if (value === undefined) {
+        doc.deleteIn(keys);
+      } else {
+        doc.setIn(keys, value);
+      }
+      sources.set(file, doc.toString());
+    }
+  };
+  const block = (file: string, label: string, spec: string) => {
+    findings.push({
+      file,
+      line: 1,
+      column: 1,
+      code: 'browser-provider',
+      severity: 'block',
+      message: `Cannot ensure ${label} (${spec}) uses ${WEBDRIVERIO_PROVIDER} >=${MIN_VERSION}. Select a compatible provider version, then re-run migration.`,
+    });
+  };
+  const catalogEntry = (
+    spec: string,
+    name: string,
+  ): { file: string; keys: string[] } | undefined => {
+    const catalog = spec.slice('catalog:'.length);
+    const keys = catalog && catalog !== 'default' ? ['catalogs', catalog, name] : ['catalog', name];
+    if (workspace.packageManager === PackageManager.bun) {
+      for (const prefix of [['workspaces'], []]) {
+        if (typeof get(rootManifest, [...prefix, ...keys]) === 'string') {
+          return { file: rootManifest, keys: [...prefix, ...keys] };
+        }
+      }
+      return undefined;
+    }
+    const file = path.join(
+      workspace.rootDir,
+      workspace.packageManager === PackageManager.yarn ? '.yarnrc.yml' : 'pnpm-workspace.yaml',
+    );
+    return typeof get(file, keys) === 'string' ? { file, keys } : undefined;
+  };
+  const update = (file: string, keys: string[], directory: string, seen = new Set<string>()) => {
+    const spec = get(file, keys);
+    if (typeof spec !== 'string') {
+      return;
+    }
+    const location = `${file}:${keys.join('.')}`;
+    if (seen.has(location)) {
+      block(file, keys.join('.'), spec);
+      return;
+    }
+    seen.add(location);
+    if (spec.startsWith('catalog:')) {
+      const entry = catalogEntry(spec, WEBDRIVERIO_PROVIDER);
+      if (entry) {
+        update(entry.file, entry.keys, directory, seen);
+      } else {
+        block(file, keys.join('.'), spec);
+      }
+      return;
+    }
+    if (spec.startsWith('$')) {
+      const name = spec.slice(1);
+      const field = INSTALL_FIELDS.find(
+        (field) => typeof get(rootManifest, [field, name]) === 'string',
+      );
+      if (field && name === WEBDRIVERIO_PROVIDER) {
+        update(rootManifest, [field, name], workspace.rootDir, seen);
+      } else {
+        block(file, keys.join('.'), spec);
+      }
+      return;
+    }
+    const migrated = webdriverioMigrationSpec(spec);
+    if (migrated !== undefined) {
+      set(file, keys, migrated);
+      return;
+    }
+    // Installed metadata is useful for local/workspace sources, whose version
+    // can be checked without replacing a user's fork with a registry package.
+    // A tag or Git branch is mutable: an unrelated old install cannot prove it.
+    if (/^(?:file:|link:|workspace:)/.test(spec)) {
+      const local = spec.startsWith('workspace:')
+        ? manifests.find((manifest) => read(manifest).name === WEBDRIVERIO_PROVIDER)
+        : path.resolve(directory, spec.slice(spec.indexOf(':') + 1), 'package.json');
+      if (local && fs.existsSync(local)) {
+        const text = fs.readFileSync(local, 'utf8');
+        inputs.set(local, text);
+        const pkg = object(parse(text));
+        if (
+          pkg.name === WEBDRIVERIO_PROVIDER &&
+          typeof pkg.version === 'string' &&
+          semver.valid(pkg.version) &&
+          semver.gte(pkg.version, MIN_VERSION)
+        ) {
+          return;
+        }
+      }
+    }
+    block(file, keys.join('.'), spec);
+  };
+
+  const selected = manifests.filter((file) => {
+    const pkg = read(file);
+    return (
+      [...INSTALL_FIELDS, 'peerDependencies'].some(
+        (field) => typeof object(pkg[field])[WEBDRIVERIO_PROVIDER] === 'string',
+      ) || usesWebdriverioProvider(path.dirname(file))
+    );
+  });
+  if (!selected.length) {
+    return findings;
+  }
+
+  for (const file of selected) {
+    const directory = path.dirname(file);
+    let installed = false;
+    for (const field of INSTALL_FIELDS) {
+      if (typeof get(file, [field, WEBDRIVERIO_PROVIDER]) === 'string') {
+        update(file, [field, WEBDRIVERIO_PROVIDER], directory);
+        installed = true;
+      }
+    }
+    if (!installed) {
+      // A peer range is a public consumer contract, not a project install.
+      // Add a dev dependency without narrowing that public range.
+      const peer = get(file, ['peerDependencies', WEBDRIVERIO_PROVIDER]);
+      const inherited =
+        file !== rootManifest
+          ? INSTALL_FIELDS.map((field) => get(rootManifest, [field, WEBDRIVERIO_PROVIDER])).find(
+              (spec): spec is string => typeof spec === 'string',
+            )
+          : undefined;
+      let spec = typeof peer === 'string' ? peer : inherited;
+      if (spec?.startsWith('catalog:') && typeof peer === 'string') {
+        const entry = catalogEntry(spec, WEBDRIVERIO_PROVIDER);
+        const resolved = entry && get(entry.file, entry.keys);
+        // Do not change a shared catalog that still describes the public peer.
+        spec = typeof resolved === 'string' ? resolved : spec;
+      }
+      set(file, ['devDependencies', WEBDRIVERIO_PROVIDER], spec ?? DEFAULT_SPEC);
+      update(file, ['devDependencies', WEBDRIVERIO_PROVIDER], directory);
+    }
+    if (!INSTALL_FIELDS.some((field) => typeof get(file, [field, 'webdriverio']) === 'string')) {
+      let peer = '*';
+      for (const name of ['webdriverio', '@wdio/cli', '@wdio/globals']) {
+        const pkg = read(file);
+        const spec = [...INSTALL_FIELDS, 'peerDependencies']
+          .map((field) => object(pkg[field])[name])
+          .find((spec): spec is string => typeof spec === 'string');
+        if (!spec) {
+          continue;
+        }
+        const entry = spec.startsWith('catalog:') ? catalogEntry(spec, name) : undefined;
+        const resolved = entry ? get(entry.file, entry.keys) : spec;
+        if (typeof resolved === 'string' && semver.validRange(resolved)) {
+          peer = name === 'webdriverio' ? spec : resolved;
+          break;
+        }
+      }
+      // An existing installed framework is another safe fallback, e.g. a
+      // WebDriverIO CLI that brings its framework transitively.
+      const metadata = peer === '*' ? detectPackageMetadata(directory, 'webdriverio') : undefined;
+      if (metadata && semver.valid(metadata.version)) {
+        const metadataFile = path.join(metadata.path, 'package.json');
+        inputs.set(metadataFile, fs.readFileSync(metadataFile, 'utf8'));
+        peer = `^${metadata.version}`;
+      }
+      set(file, ['devDependencies', 'webdriverio'], peer);
+    }
+    // npm needs the provider's Vite peer reachable independently of Vitest's
+    // overridden subtree. Keep the same installation support as official providers.
+    if (
+      workspace.packageManager === PackageManager.npm &&
+      VITE_PLUS_OVERRIDE_PACKAGES.vite &&
+      !INSTALL_FIELDS.some((field) => get(file, [field, 'vite']) !== undefined)
+    ) {
+      set(file, ['devDependencies', 'vite'], VITE_PLUS_OVERRIDE_PACKAGES.vite);
+    }
+  }
+
+  const projectNames = selected
+    .map((file) => read(file).name)
+    .filter((name): name is string => typeof name === 'string');
+  const matchesProject = (parents: string[]) => {
+    const concrete = parents.filter((parent) => parent !== '**');
+    return (
+      concrete.length === 0 ||
+      (concrete.length === 1 &&
+        projectNames.some((name) =>
+          new RegExp(
+            `^${concrete[0]
+              .split('*')
+              .map((part) => part.replace(/[.+?^${}()|[\]\\]/g, '\\$&'))
+              .join('.*')}$`,
+          ).test(name),
+        ))
+    );
+  };
+  const overrideMap = (file: string, keys: string[], parents: string[] = []) => {
+    for (const [key, value] of Object.entries(object(get(file, keys)))) {
+      const target = extractOverrideTargetName(key);
+      const ancestors = [...parents, ...(extractOverrideParentSegments(key) ?? [])];
+      const entry = [...keys, key];
+      if (target === WEBDRIVERIO_PROVIDER && matchesProject(ancestors)) {
+        const versionPath = typeof value === 'string' ? entry : [...entry, '.'];
+        const before = get(file, versionPath);
+        const catalog =
+          typeof before === 'string' && before.startsWith('catalog:')
+            ? catalogEntry(before, WEBDRIVERIO_PROVIDER)
+            : undefined;
+        const pin = catalog ? get(catalog.file, catalog.keys) : before;
+        const pinnedRange =
+          typeof pin === 'string'
+            ? semver.validRange(
+                pin.startsWith(REGISTRY_ALIAS) ? pin.slice(REGISTRY_ALIAS.length) : pin,
+              )
+            : null;
+        // An old forcing pin must not override a newer direct declaration.
+        // Remove v4-only pins and let the migrated dependency choose its version.
+        // Preserve the children of npm's long-form override objects.
+        if (pinnedRange && !semver.intersects(pinnedRange, `>=${MIN_VERSION}`)) {
+          set(file, versionPath, undefined);
+          continue;
+        }
+        update(file, versionPath, workspace.rootDir);
+        // npm requires a direct dependency override to use the same spec.
+        // A $ reference preserves a valid existing pin without EOVERRIDE.
+        if (
+          workspace.packageManager === PackageManager.npm &&
+          keys[0] === 'overrides' &&
+          ancestors.length === 0 &&
+          selected.includes(rootManifest) &&
+          typeof before === 'string'
+        ) {
+          const after = get(file, versionPath);
+          const field = INSTALL_FIELDS.find(
+            (field) => get(rootManifest, [field, WEBDRIVERIO_PROVIDER]) !== undefined,
+          )!;
+          if (
+            typeof after === 'string' &&
+            !after.startsWith('$') &&
+            webdriverioMigrationSpec(after) === after
+          ) {
+            const direct = get(rootManifest, [field, WEBDRIVERIO_PROVIDER]);
+            if (
+              typeof direct === 'string' &&
+              webdriverioMigrationSpec(before) !== before &&
+              webdriverioMigrationSpec(direct) === direct
+            ) {
+              set(file, versionPath, `$${WEBDRIVERIO_PROVIDER}`);
+            } else if (direct === after) {
+              continue;
+            } else if (
+              typeof direct === 'string' &&
+              semver.validRange(direct) &&
+              semver.validRange(after) &&
+              semver.intersects(direct, after)
+            ) {
+              set(rootManifest, [field, WEBDRIVERIO_PROVIDER], after);
+              set(file, versionPath, `$${WEBDRIVERIO_PROVIDER}`);
+            } else if (direct !== after) {
+              block(file, versionPath.join('.'), after);
+            }
+          }
+        }
+      }
+      if (value !== null && typeof value === 'object') {
+        overrideMap(file, entry, [...ancestors, target]);
+      }
+    }
+  };
+  overrideMap(rootManifest, ['overrides']);
+  overrideMap(rootManifest, ['resolutions']);
+  overrideMap(rootManifest, ['pnpm', 'overrides']);
+  overrideMap(path.join(workspace.rootDir, 'pnpm-workspace.yaml'), ['overrides']);
+  return findings;
+}
diff --git a/packages/cli/src/oxlint-plugin.ts b/packages/cli/src/oxlint-plugin.ts
index 145837e5c7..6ebeb50562 100644
--- a/packages/cli/src/oxlint-plugin.ts
+++ b/packages/cli/src/oxlint-plugin.ts
@@ -4,11 +4,13 @@ import path from 'node:path';
 import { definePlugin, defineRule } from '@oxlint/plugins';
 import type { Context, ESTree } from '@oxlint/plugins';
 
+import cliPackage from '../package.json' with { type: 'json' };
 import {
   PREFER_VITE_PLUS_IMPORTS_RULE_NAME,
   VITE_PLUS_OXLINT_PLUGIN_NAME,
 } from './oxlint-plugin-config.ts';
 import viteConfigEntryBasenames from './vite-config-entry-basenames.json' with { type: 'json' };
+import vitestV5EntryPoints from './vitest-v5-entry-points.json' with { type: 'json' };
 
 // `declare module 'vitest…'` and `declare module '@vitest/browser…'` are
 // intentionally preserved by `vp migrate` (see migration's import_rewriter and
@@ -103,8 +105,13 @@ function rewriteVitePlusImportSpecifier(specifier: string): string | null {
     return null;
   }
 
+  if (specifier in vitestV5EntryPoints) {
+    return vitestV5EntryPoints[specifier as keyof typeof vitestV5EntryPoints];
+  }
+
   if (specifier.startsWith('vitest/')) {
-    return `vite-plus/test/${specifier.slice('vitest/'.length)}`;
+    const subpath = `./test/${specifier.slice('vitest/'.length)}`;
+    return subpath in cliPackage.exports ? `vite-plus${subpath.slice(1)}` : null;
   }
 
   if (specifier === '@vitest/browser') {
@@ -128,7 +135,6 @@ function rewriteVitePlusImportSpecifier(specifier: string): string | null {
   for (const [prefix, provider] of [
     ['@vitest/browser-playwright', 'playwright'],
     ['@vitest/browser-preview', 'preview'],
-    ['@vitest/browser-webdriverio', 'webdriverio'],
   ] as const) {
     if (specifier === prefix) {
       return `vite-plus/test/${prefix.slice('@vitest/'.length)}`;
diff --git a/packages/cli/src/utils/__tests__/tsconfig.spec.ts b/packages/cli/src/utils/__tests__/tsconfig.spec.ts
index d9e87d866d..0016037037 100644
--- a/packages/cli/src/utils/__tests__/tsconfig.spec.ts
+++ b/packages/cli/src/utils/__tests__/tsconfig.spec.ts
@@ -6,6 +6,7 @@ import { afterEach, beforeEach, describe, expect, it } from 'vitest';
 
 import {
   findTsconfigFiles,
+  hasTypesToRewriteInTsconfig,
   removeDeprecatedTsconfigFalseOption,
   rewriteTypesInTsconfig,
 } from '../tsconfig.js';
@@ -240,6 +241,62 @@ describe('rewriteTypesInTsconfig', () => {
     `);
   });
 
+  it('migrates removed Vite+ test type entries without changing retained entries', () => {
+    const filePath = path.join(tmpDir, 'tsconfig.json');
+    fs.writeFileSync(
+      filePath,
+      JSON.stringify({
+        compilerOptions: {
+          types: [
+            'vite-plus/test/coverage',
+            'vite-plus/test/reporters',
+            'vite-plus/test/environments',
+            'vite-plus/test/snapshot',
+            'vite-plus/test/mocker',
+            'vite-plus/test/globals',
+          ],
+        },
+      }),
+    );
+    expect(hasTypesToRewriteInTsconfig(filePath)).toBe(true);
+    expect(rewriteTypesInTsconfig(filePath)).toBe(true);
+    expect(JSON.parse(fs.readFileSync(filePath, 'utf8')).compilerOptions.types).toEqual([
+      'vite-plus/test/node',
+      'vite-plus/test/node',
+      'vite-plus/test/runtime',
+      'vite-plus/test/runtime',
+      'vite-plus/test/mocker',
+      'vite-plus/test/globals',
+    ]);
+    expect(hasTypesToRewriteInTsconfig(filePath)).toBe(false);
+    expect(rewriteTypesInTsconfig(filePath)).toBe(false);
+  });
+
+  it('restores removed WebDriverIO type entries and preserves community entries', () => {
+    const filePath = path.join(tmpDir, 'tsconfig.json');
+    fs.writeFileSync(
+      filePath,
+      JSON.stringify({
+        compilerOptions: {
+          types: [
+            'vite-plus/test/browser-webdriverio',
+            'vite-plus/test/browser-webdriverio/context',
+            '@vitest/browser-webdriverio/context',
+            '@vitest/browser-webdriverio/future',
+          ],
+        },
+      }),
+    );
+    expect(rewriteTypesInTsconfig(filePath)).toBe(true);
+    expect(JSON.parse(fs.readFileSync(filePath, 'utf8')).compilerOptions.types).toEqual([
+      '@vitest/browser-webdriverio',
+      'vite-plus/test/browser/context',
+      '@vitest/browser-webdriverio/context',
+      '@vitest/browser-webdriverio/future',
+    ]);
+    expect(rewriteTypesInTsconfig(filePath)).toBe(false);
+  });
+
   it('preserves vite/client (issue #2004: vite refs stay outside config files)', () => {
     const filePath = path.join(tmpDir, 'tsconfig.json');
     const original = `{
diff --git a/packages/cli/src/utils/constants.ts b/packages/cli/src/utils/constants.ts
index 3a1b9663d4..e70fbb3142 100644
--- a/packages/cli/src/utils/constants.ts
+++ b/packages/cli/src/utils/constants.ts
@@ -15,7 +15,7 @@ export const VITE_CONFIG_FILES = [
   'vite.config.cts',
 ] as const;
 
-export const VITEST_VERSION = '4.1.11';
+export const VITEST_VERSION = '5.0.1';
 
 // Exact action release used by generated workflows and the @v1 migration.
 // The Renovate custom manager keeps this value current.
@@ -28,10 +28,9 @@ export const VITE_PLUS_OVERRIDE_PACKAGES: Record<string, string> = process.env.V
   ? JSON.parse(process.env.VP_OVERRIDE_PACKAGES)
   : {
       vite: `npm:@voidzero-dev/vite-plus-core@${VITE_PLUS_VERSION}`,
-      // Pin `vitest` only. The `@vitest/*` family (expect, runner, snapshot, spy,
-      // utils, mocker, pretty-format) are EXACT (`4.1.9`) dependencies of `vitest`
-      // itself, so a single `vitest` override cascades one consistent version to
-      // the whole tree — overriding the indirect deps individually is redundant.
+      // The runner inlines its assertion and runner state. Its remaining
+      // official dependencies use exact versions; community providers and
+      // Istanbul internals have their own version ranges.
       // Coverage providers (`@vitest/coverage-v8` / `-istanbul`) are vitest PEER
       // deps the project installs and versions itself — vite-plus never adds,
       // pins, or overrides them. The runtime guard in `define-config.ts` only
diff --git a/packages/cli/src/utils/tsconfig.ts b/packages/cli/src/utils/tsconfig.ts
index b35f2d4c59..d952120a3d 100644
--- a/packages/cli/src/utils/tsconfig.ts
+++ b/packages/cli/src/utils/tsconfig.ts
@@ -5,6 +5,7 @@ import { styleText } from 'node:util';
 import * as prompts from '@voidzero-dev/vite-plus-prompts';
 import { applyEdits, modify, parse as parseJsonc } from 'jsonc-parser';
 
+import vitestV5EntryPoints from '../vitest-v5-entry-points.json' with { type: 'json' };
 import { runCommandSilently } from './command.ts';
 import { BASEURL_TSCONFIG_FIX_PACKAGE, createBaseUrlTsconfigFixArgs } from './constants.ts';
 import { cancelAndExit } from './prompts.ts';
@@ -175,6 +176,10 @@ export function removeDeprecatedTsconfigFalseOption(filePath: string, optionName
 // rewritten here (tsdown is not part of the vite scoping).
 const TSCONFIG_TYPE_REPLACEMENTS: Record<string, string> = {
   'tsdown/client': 'vite-plus/pack/client',
+  // Removed Vite+ exports must also migrate in type-only entry lists.
+  ...Object.fromEntries(
+    Object.entries(vitestV5EntryPoints).filter(([source]) => source.startsWith('vite-plus/')),
+  ),
 };
 
 export function hasTypesToRewriteInTsconfig(filePath: string): boolean {
diff --git a/packages/cli/src/utils/vitest-ecosystem.ts b/packages/cli/src/utils/vitest-ecosystem.ts
index f950cf3ee8..b290b214f7 100644
--- a/packages/cli/src/utils/vitest-ecosystem.ts
+++ b/packages/cli/src/utils/vitest-ecosystem.ts
@@ -1,10 +1,25 @@
-const VITEST_ALIGN_EXCLUDED = new Set([
-  '@vitest/eslint-plugin',
-  // Deprecated at 0.33.0 and replaced by @vitest/coverage-v8. It does not
-  // publish versions on Vitest's current release line.
-  '@vitest/coverage-c8',
+/** Official packages that share the bundled runner's release version. */
+export const VITEST_EXACT_VERSION_PACKAGES: ReadonlySet<string> = new Set([
+  '@vitest/browser',
+  '@vitest/browser-playwright',
+  '@vitest/browser-preview',
+  '@vitest/coverage-v8',
+  '@vitest/coverage-istanbul',
+  '@vitest/mocker',
+  '@vitest/pretty-format',
+  '@vitest/snapshot',
+  '@vitest/spy',
+  '@vitest/ui',
+  '@vitest/utils',
+  '@vitest/web-worker',
+]);
+
+/** Optional peers fall back to the project; unrelated @vitest packages do not redirect. */
+export const VITEST_RESOLVER_PACKAGES: ReadonlySet<string> = new Set([
+  'vitest',
+  ...VITEST_EXACT_VERSION_PACKAGES,
 ]);
 
 export function isAlignableVitestEcosystemPackage(name: string): boolean {
-  return name.startsWith('@vitest/') && !VITEST_ALIGN_EXCLUDED.has(name);
+  return VITEST_EXACT_VERSION_PACKAGES.has(name);
 }
diff --git a/packages/cli/src/vitest-v5-entry-points.json b/packages/cli/src/vitest-v5-entry-points.json
new file mode 100644
index 0000000000..55c5a62cce
--- /dev/null
+++ b/packages/cli/src/vitest-v5-entry-points.json
@@ -0,0 +1,22 @@
+{
+  "vitest/coverage": "vite-plus/test/node",
+  "vitest/reporters": "vite-plus/test/node",
+  "vitest/environments": "vite-plus/test/runtime",
+  "vitest/snapshot": "vite-plus/test/runtime",
+  "vitest/mocker": "vite-plus/test/mocker",
+  "vite-plus/test/coverage": "vite-plus/test/node",
+  "vite-plus/test/reporters": "vite-plus/test/node",
+  "vite-plus/test/environments": "vite-plus/test/runtime",
+  "vite-plus/test/snapshot": "vite-plus/test/runtime",
+  "vitest/browser-webdriverio": "@vitest/browser-webdriverio",
+  "vitest/browser-webdriverio/context": "vite-plus/test/browser/context",
+  "vitest/browser/providers/webdriverio": "@vitest/browser-webdriverio",
+  "vitest/browser/providers/webdriverio/context": "vite-plus/test/browser/context",
+  "vitest/plugins/browser-webdriverio": "@vitest/browser-webdriverio",
+  "vite-plus/test/browser-webdriverio": "@vitest/browser-webdriverio",
+  "vite-plus/test/browser-webdriverio/context": "vite-plus/test/browser/context",
+  "vite-plus/test/browser/providers/webdriverio": "@vitest/browser-webdriverio",
+  "vite-plus/test/browser/providers/webdriverio/context": "vite-plus/test/browser/context",
+  "vite-plus/test/plugins/browser-webdriverio": "@vitest/browser-webdriverio",
+  "@vitest/browser/providers/webdriverio": "@vitest/browser-webdriverio"
+}
diff --git a/packages/tools/src/__tests__/brand-vite.spec.ts b/packages/tools/src/__tests__/brand-vite.spec.ts
new file mode 100644
index 0000000000..1364658cad
--- /dev/null
+++ b/packages/tools/src/__tests__/brand-vite.spec.ts
@@ -0,0 +1,110 @@
+import { execFileSync } from 'node:child_process';
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+
+import { expect, test } from 'vitest';
+
+import { brandVite } from '../brand-vite.ts';
+import { alignVendoredVitestDependencies } from '../vendored-vitest.ts';
+
+const upstreamSources = {
+  'constants.ts': 'export const VERSION = version as string\n',
+  'cli.ts': [
+    "import { VERSION } from './constants'",
+    "cac('vite')",
+    'cli.version(VERSION)',
+    'colors.green(',
+    "            `${colors.bold('VITE')} v${VERSION}`,",
+    '          )',
+    '',
+  ].join('\n'),
+  'build.ts': [
+    '  logger.info(',
+    '    colors.cyan(',
+    '      `vite v${VERSION} ${colors.green(',
+    '        `building ${environment.name} environment for ${environment.config.mode}...`,',
+    '      )}`,',
+    '    ),',
+    '  )',
+    '`[vite]: Rolldown failed`',
+    '',
+  ].join('\n'),
+  'logger.ts': "prefix = '[vite]'\n",
+  'plugins/reporter.ts': [
+    "import path from 'node:path'",
+    '      logInfo: shouldLogInfo ? (msg) => env.logger.info(msg) : undefined,',
+    '',
+  ].join('\n'),
+  'config.ts': [
+    '      !process.env.VITE_CONFIG_NATIVE_IGNORE_WARNING &&',
+    '        createNativeConfigCompatPlugin(nativeIncompatibilities),',
+    '',
+  ].join('\n'),
+};
+
+function write(file: string, source: string) {
+  mkdirSync(dirname(file), { recursive: true });
+  writeFileSync(file, source);
+}
+
+test('branding preserves aligned dependencies and unrelated changes across repeated builds', () => {
+  const root = mkdtempSync(join(tmpdir(), 'vp-brand-vite-'));
+  const viteDir = join(root, 'vite');
+  const nodeDir = join(viteDir, 'packages/vite/src/node');
+  const git = (...args: string[]) => execFileSync('git', args, { cwd: viteDir, stdio: 'pipe' });
+  try {
+    for (const [file, source] of Object.entries(upstreamSources)) {
+      write(join(nodeDir, file), source);
+    }
+    const manifest = join(viteDir, 'packages/vite/package.json');
+    const lockfile = join(viteDir, 'pnpm-lock.yaml');
+    const unrelatedSource = join(nodeDir, 'server.ts');
+    write(manifest, '{"devDependencies":{"@vitest/utils":"4.1.10"}}\n');
+    write(lockfile, '# upstream lockfile\n');
+    write(unrelatedSource, '// upstream source\n');
+    git('init');
+    git('config', 'core.autocrlf', 'false');
+    git('config', 'core.hooksPath', join(root, 'no-hooks'));
+    git('add', '.');
+    git(
+      '-c',
+      'user.name=Test',
+      '-c',
+      'user.email=test@example.com',
+      '-c',
+      'commit.gpgsign=false',
+      'commit',
+      '-m',
+      'upstream fixture',
+    );
+
+    alignVendoredVitestDependencies(root, '5.0.0');
+    const alignedManifest = readFileSync(manifest, 'utf8');
+    expect(JSON.parse(alignedManifest).devDependencies['@vitest/utils']).toBe('5.0.0');
+    write(lockfile, '# local lockfile change\n');
+    write(unrelatedSource, '// unrelated local source change\n');
+
+    let brandedSources: string[] | undefined;
+    for (let run = 0; run < 2; run++) {
+      brandVite(root);
+
+      expect(readFileSync(manifest, 'utf8')).toBe(alignedManifest);
+      expect(readFileSync(lockfile, 'utf8')).toBe('# local lockfile change\n');
+      expect(readFileSync(unrelatedSource, 'utf8')).toBe('// unrelated local source change\n');
+      expect(readFileSync(join(nodeDir, 'cli.ts'), 'utf8')).toContain("cac('vp')");
+      expect(readFileSync(join(nodeDir, 'build.ts'), 'utf8')).not.toContain('logger.info(');
+      const sources = Object.entries(upstreamSources).map(([file, upstream]) => {
+        const source = readFileSync(join(nodeDir, file), 'utf8');
+        expect(source).not.toBe(upstream);
+        return source;
+      });
+      if (brandedSources) {
+        expect(sources).toEqual(brandedSources);
+      }
+      brandedSources = sources;
+    }
+  } finally {
+    rmSync(root, { recursive: true, force: true });
+  }
+});
diff --git a/packages/tools/src/__tests__/local-npm-registry.spec.ts b/packages/tools/src/__tests__/local-npm-registry.spec.ts
new file mode 100644
index 0000000000..dd03810f15
--- /dev/null
+++ b/packages/tools/src/__tests__/local-npm-registry.spec.ts
@@ -0,0 +1,35 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { expect, it } from 'vitest';
+
+it('isolates and cleans the platform temp directory used by bunx on each registry run', () => {
+  const script = fileURLToPath(new URL('../local-npm-registry.ts', import.meta.url));
+  const probe = `
+    const fs = require('node:fs');
+    console.log(JSON.stringify({
+      cache: process.env.BUN_INSTALL_CACHE_DIR,
+      temporary: process.env.BUN_TMPDIR,
+      platformTemporary: process.env.TMPDIR,
+      exists: fs.existsSync(process.env.TMPDIR ?? ''),
+    }));
+  `;
+  const caches = new Set<string>();
+  for (let run = 0; run < 2; run++) {
+    const output = execFileSync(process.execPath, [script, '--', process.execPath, '-e', probe], {
+      cwd: path.dirname(script),
+      encoding: 'utf8',
+      timeout: 10_000,
+      env: { ...process.env, SNAP_LOCAL_VP_PACKAGES_DIR: '' },
+    });
+    const result = JSON.parse(output);
+    expect(result.platformTemporary).toBe(path.join(result.cache, '.tmp'));
+    expect(result.temporary).toBe(result.platformTemporary);
+    expect(result.exists).toBe(true);
+    expect(existsSync(result.cache)).toBe(false);
+    expect(caches.has(result.cache)).toBe(false);
+    caches.add(result.cache);
+  }
+});
diff --git a/packages/tools/src/__tests__/sync-remote-deps.spec.ts b/packages/tools/src/__tests__/sync-remote-deps.spec.ts
index 82ef13c409..ffbea06383 100644
--- a/packages/tools/src/__tests__/sync-remote-deps.spec.ts
+++ b/packages/tools/src/__tests__/sync-remote-deps.spec.ts
@@ -1,11 +1,282 @@
+import { spawnSync } from 'node:child_process';
+import { copyFileSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+
 import * as semver from 'semver';
 import { describe, expect, test } from 'vitest';
+import * as yaml from 'yaml';
 
+import { VITEST_VERSION } from '../../../cli/src/utils/constants.ts';
 import {
   mergePnpmWorkspaces,
   syncCargoOxcVersions,
   syncViteDevtoolsDependencies,
 } from '../sync-remote-deps.ts';
+import { alignVendoredVitestDependencies } from '../vendored-vitest.ts';
+
+describe('vendored Vitest dependency alignment', () => {
+  test('can be imported from stdin without running the bootstrap', () => {
+    const root = mkdtempSync(join(tmpdir(), 'vp-vendored-vitest-import-'));
+    try {
+      const url = new URL('../vendored-vitest.ts', import.meta.url).href;
+      const result = spawnSync(process.execPath, ['--input-type=module', '-'], {
+        cwd: root,
+        encoding: 'utf8',
+        input: `import ${JSON.stringify(url)};`,
+      });
+      expect(result.stderr).toBe('');
+      expect(result.status).toBe(0);
+    } finally {
+      rmSync(root, { recursive: true, force: true });
+    }
+  });
+
+  test('keeps the bootstrap runtime pin in sync with the root catalog', () => {
+    const workspace = yaml.parse(
+      readFileSync(new URL('../../../../pnpm-workspace.yaml', import.meta.url), 'utf8'),
+    );
+    expect(workspace.catalog.vitest).toBe(VITEST_VERSION);
+  });
+
+  test.each(['4.1.10', '^5.0.0', '5.1.0-beta.1'])(
+    'rejects an unsupported bootstrap runtime pin %s before changing manifests',
+    (version) => {
+      const root = mkdtempSync(join(tmpdir(), 'vp-vendored-vitest-bootstrap-'));
+      try {
+        const constantsDir = join(root, 'packages/cli/src/utils');
+        mkdirSync(constantsDir, { recursive: true });
+        writeFileSync(
+          join(constantsDir, 'constants.ts'),
+          `export const VITEST_VERSION = '${version}';\n`,
+        );
+        const script = join(root, 'vendored-vitest.ts');
+        copyFileSync(new URL('../vendored-vitest.ts', import.meta.url), script);
+        const result = spawnSync(process.execPath, [script], { cwd: root, encoding: 'utf8' });
+        expect(result.status).not.toBe(0);
+        expect(result.stderr).toContain('VITEST_VERSION must declare an exact stable v5 version');
+      } finally {
+        rmSync(root, { recursive: true, force: true });
+      }
+    },
+  );
+
+  test.each(['5.0.0', '5.1.2'])(
+    'runs before dependency installation with the selected %s runtime pin',
+    (version) => {
+      const root = mkdtempSync(join(tmpdir(), 'vp-vendored-vitest-bootstrap-'));
+      try {
+        const constantsDir = join(root, 'packages/cli/src/utils');
+        mkdirSync(constantsDir, { recursive: true });
+        writeFileSync(
+          join(constantsDir, 'constants.ts'),
+          `export const VITEST_VERSION = '${version}';\n`,
+        );
+        // Copy the entry point outside the repo so it cannot resolve node_modules.
+        const script = join(root, 'vendored-vitest.ts');
+        copyFileSync(new URL('../vendored-vitest.ts', import.meta.url), script);
+        const directory = join(root, 'vite/packages/vite');
+        mkdirSync(directory, { recursive: true });
+        const manifest = join(directory, 'package.json');
+        writeFileSync(
+          manifest,
+          JSON.stringify({
+            dependencies: { '@vitest/utils': '4.1.10' },
+            devDependencies: { vitest: 'catalog:' },
+            optionalDependencies: { '@vitest/spy': '^4.1.10' },
+          }),
+        );
+        const run = () => spawnSync(process.execPath, [script], { cwd: root, encoding: 'utf8' });
+        const first = run();
+        expect(first.stderr).toBe('');
+        expect(first.status).toBe(0);
+        const source = readFileSync(manifest, 'utf8');
+        expect(JSON.parse(source)).toEqual({
+          dependencies: { '@vitest/utils': version },
+          devDependencies: { vitest: 'catalog:' },
+          optionalDependencies: { '@vitest/spy': version },
+        });
+        expect(run().status).toBe(0);
+        expect(readFileSync(manifest, 'utf8')).toBe(source);
+      } finally {
+        rmSync(root, { recursive: true, force: true });
+      }
+    },
+  );
+
+  test('resolves the reviewed Vitest major catalog conflict', () => {
+    const merged = mergePnpmWorkspaces(
+      { catalog: { vitest: '5.0.0' } },
+      { catalog: { vitest: '^4.1.6' } },
+      { catalog: { vitest: '^4.1.10' } },
+      semver,
+    );
+    expect(merged.catalog?.vitest).toBe('5.0.0');
+  });
+
+  test.each(['=4.1.11', '^5.1.0', '5.2.0', '^6.0.0'])(
+    'preserves the selected exact runner version against upstream %s',
+    (upstream) => {
+      const merged = mergePnpmWorkspaces(
+        { catalog: { vitest: '5.0.0' } },
+        { catalog: { vitest: upstream } },
+        {},
+        semver,
+      );
+      expect(merged.catalog?.vitest).toBe('5.0.0');
+    },
+  );
+
+  test('aligns official catalog entries to the selected runner and preserves the community provider', () => {
+    const merged = mergePnpmWorkspaces(
+      {
+        catalog: {
+          vitest: '5.1.2',
+          '@vitest/browser': '5.0.0',
+          '@vitest/browser-webdriverio': '5.0.0-rc.1',
+        },
+      },
+      {
+        catalog: {
+          vitest: '^4.1.6',
+          '@vitest/browser': '^5.2.0',
+          '@vitest/browser-webdriverio': '5.3.0',
+          '@vitest/utils': '4.1.11',
+          '@vitest/expect': '4.1.11',
+          '@vitest/runner': '4.1.11',
+          '@vitest/eslint-plugin': '^1.0.0',
+        },
+      },
+      {
+        catalog: {
+          '@vitest/coverage-v8': '4.1.11',
+          '@vitest/coverage-istanbul': '^4.1.11',
+          '@vitest/ui': '^5.2.0',
+          '@vitest/web-worker': '4.1.11',
+        },
+      },
+      semver,
+    );
+    expect(merged.catalog).toEqual({
+      vitest: '5.1.2',
+      '@vitest/browser': '5.1.2',
+      '@vitest/browser-webdriverio': '5.0.0-rc.1',
+      '@vitest/utils': '5.1.2',
+      '@vitest/coverage-v8': '5.1.2',
+      '@vitest/coverage-istanbul': '5.1.2',
+      '@vitest/ui': '5.1.2',
+      '@vitest/web-worker': '5.1.2',
+      '@vitest/eslint-plugin': '^1.0.0',
+    });
+  });
+
+  test.each(['^5.0.0', '=5.0.0', '4.1.11', '6.0.0', '5.1.0-beta.1'])(
+    'rejects an unreviewed root runner version %s',
+    (vitest) => {
+      expect(() => mergePnpmWorkspaces({ catalog: { vitest } }, {}, {}, semver)).toThrow(
+        'The root Vitest catalog entry must be an exact stable v5 version',
+      );
+    },
+  );
+
+  test('does not infer a missing root pin from an upstream catalog', () => {
+    expect(() => mergePnpmWorkspaces({}, { catalog: { vitest: '^4.1.6' } }, {}, semver)).toThrow(
+      'The root Vitest catalog entry must be an exact stable v5 version',
+    );
+  });
+
+  test('still resolves tinybench to the higher major version', () => {
+    const merged = mergePnpmWorkspaces(
+      { catalog: { tinybench: '^6.0.0' } },
+      { catalog: { tinybench: '^2.9.0' } },
+      {},
+      semver,
+    );
+    expect(merged.catalog?.tinybench).toBe('^6.0.0');
+  });
+
+  test.each(['@vitest/expect', '@vitest/runner'])(
+    'rejects actual dependencies on removed package %s',
+    (name) => {
+      const root = mkdtempSync(join(tmpdir(), 'vp-vendored-vitest-'));
+      try {
+        mkdirSync(join(root, 'vite', 'packages'), { recursive: true });
+        writeFileSync(
+          join(root, 'vite', 'package.json'),
+          JSON.stringify({ devDependencies: { [name]: 'catalog:' } }),
+        );
+        expect(() => alignVendoredVitestDependencies(root, '5.0.0')).toThrow(
+          `Migrate removed ${name} use`,
+        );
+      } finally {
+        rmSync(root, { recursive: true, force: true });
+      }
+    },
+  );
+
+  test('aligns direct Vite workspace dependencies and leaves fixture manifests alone', () => {
+    const root = mkdtempSync(join(tmpdir(), 'vp-vendored-vitest-'));
+    try {
+      const directory = join(root, 'vite');
+      mkdirSync(join(directory, 'packages/test/fixtures'), { recursive: true });
+      writeFileSync(
+        join(directory, 'package.json'),
+        JSON.stringify({
+          devDependencies: { vitest: '^4.0.0', '@vitest/eslint-plugin': '^1.0.0' },
+        }),
+      );
+      writeFileSync(
+        join(directory, 'packages/test/package.json'),
+        JSON.stringify({
+          devDependencies: {
+            vitest: 'catalog:',
+            '@vitest/utils': '4.1.10',
+            '@vitest/web-worker': 'catalog:legacy',
+            '@vitest/browser-webdriverio': '^5.0.0-beta.5',
+          },
+        }),
+      );
+      writeFileSync(join(directory, 'packages/test/fixtures/package.json'), '\ufeff{}');
+      alignVendoredVitestDependencies(root, '5.0.0');
+      expect(
+        JSON.parse(readFileSync(join(directory, 'package.json'), 'utf8')).devDependencies,
+      ).toEqual({ vitest: '5.0.0', '@vitest/eslint-plugin': '^1.0.0' });
+      expect(
+        JSON.parse(readFileSync(join(directory, 'packages/test/package.json'), 'utf8'))
+          .devDependencies,
+      ).toEqual({
+        vitest: 'catalog:',
+        '@vitest/utils': '5.0.0',
+        '@vitest/web-worker': '5.0.0',
+        '@vitest/browser-webdriverio': '^5.0.0-beta.5',
+      });
+    } finally {
+      rmSync(root, { recursive: true, force: true });
+    }
+  });
+
+  test('leaves Rolldown Vitest dependencies unchanged', () => {
+    const root = mkdtempSync(join(tmpdir(), 'vp-vendored-vitest-'));
+    try {
+      mkdirSync(join(root, 'vite/packages'), { recursive: true });
+      const directory = join(root, 'rolldown/packages/browser-tests');
+      mkdirSync(directory, { recursive: true });
+      const source = JSON.stringify({
+        devDependencies: {
+          vitest: 'catalog:',
+          '@vitest/browser-playwright': '4.1.10',
+          '@vitest/runner': '4.1.10',
+        },
+      });
+      const manifest = join(directory, 'package.json');
+      writeFileSync(manifest, source);
+      alignVendoredVitestDependencies(root, '5.0.0');
+      expect(readFileSync(manifest, 'utf8')).toBe(source);
+    } finally {
+      rmSync(root, { recursive: true, force: true });
+    }
+  });
+});
 
 describe('syncViteDevtoolsDependencies()', () => {
   test('uses the DevTools ranges declared by Vite', () => {
diff --git a/packages/tools/src/__tests__/sync-remote-yaml.spec.ts b/packages/tools/src/__tests__/sync-remote-yaml.spec.ts
index a417ee215a..102f1f7fd6 100644
--- a/packages/tools/src/__tests__/sync-remote-yaml.spec.ts
+++ b/packages/tools/src/__tests__/sync-remote-yaml.spec.ts
@@ -2,6 +2,7 @@ import * as semver from 'semver';
 import { describe, expect, test } from 'vitest';
 import * as yaml from 'yaml';
 
+import { findLatestStableVersionForMajor } from '../../../../.github/scripts/upgrade-deps-utils.ts';
 import { mergePnpmWorkspaces, mergeWorkspaceYaml } from '../sync-remote-deps.ts';
 
 // `pnpm tool sync-remote` rewrites the whole pnpm-workspace.yaml. It must merge
@@ -38,6 +39,34 @@ const VITE_SRC = `catalog:
 `;
 
 describe('mergeWorkspaceYaml()', () => {
+  test('preserves the latest supported pin across repeated upstream syncs', () => {
+    const version = findLatestStableVersionForMajor(['5.0.0', '5.1.2', '5.2.0-beta.1', '6.0.0'], 5);
+    expect(version).toBe('5.1.2');
+    const main = `catalog:
+  # Keep the runner and official packages on the selected release.
+  vitest: ${version}
+  '@vitest/browser': ${version}
+`;
+    const rolldown = `catalog:
+  vitest: '=4.1.11'
+  '@vitest/utils': '^4.1.11'
+`;
+    const vite = `catalog:
+  vitest: '^5.2.0'
+  '@vitest/browser': '^5.2.0'
+`;
+
+    const output = mergeWorkspaceYaml(main, rolldown, vite, yaml, semver);
+
+    expect(yaml.parse(output).catalog).toEqual({
+      vitest: '5.1.2',
+      '@vitest/browser': '5.1.2',
+      '@vitest/utils': '5.1.2',
+    });
+    expect(output).toContain('# Keep the runner and official packages on the selected release.');
+    expect(mergeWorkspaceYaml(output, rolldown, vite, yaml, semver)).toBe(output);
+  });
+
   test('preserves comments from the main workspace', () => {
     const output = mergeWorkspaceYaml(MAIN_SRC, ROLLDOWN_SRC, VITE_SRC, yaml, semver);
 
diff --git a/packages/tools/src/brand-vite.ts b/packages/tools/src/brand-vite.ts
index b452c02213..228dbf6069 100644
--- a/packages/tools/src/brand-vite.ts
+++ b/packages/tools/src/brand-vite.ts
@@ -89,12 +89,24 @@ function logPatch(file: string, desc: string, result: 'patched' | 'already') {
 export function brandVite(rootDir: string = process.cwd()) {
   log('Applying Vite+ branding patches...');
 
-  // Always patch raw upstream sources, including when sync-remote already applied branding.
-  execFileSync('git', ['restore', '--source=HEAD', '--', '.'], {
-    cwd: join(rootDir, VITE_DIR),
-  });
-
   const nodeDir = join(rootDir, VITE_NODE_DIR);
+  // Start from upstream sources on every run, but preserve dependency alignment
+  // from sync-remote and any other files that branding does not modify.
+  execFileSync(
+    'git',
+    [
+      'restore',
+      '--source=HEAD',
+      '--',
+      'constants.ts',
+      'cli.ts',
+      'build.ts',
+      'logger.ts',
+      'plugins/reporter.ts',
+      'config.ts',
+    ],
+    { cwd: nodeDir },
+  );
 
   // 1. constants.ts: Add VITE_PLUS_VERSION constant after VERSION
   const constantsFile = join(nodeDir, 'constants.ts');
diff --git a/packages/tools/src/local-npm-registry.ts b/packages/tools/src/local-npm-registry.ts
index 209a2ba0d2..acce4c4eb7 100644
--- a/packages/tools/src/local-npm-registry.ts
+++ b/packages/tools/src/local-npm-registry.ts
@@ -40,7 +40,7 @@
 
 import { spawn, spawnSync } from 'node:child_process';
 import { createHash } from 'node:crypto';
-import { existsSync, mkdtempSync, readdirSync, readFileSync, rmSync } from 'node:fs';
+import { existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, rmSync } from 'node:fs';
 import { readFile } from 'node:fs/promises';
 import {
   createServer,
@@ -557,6 +557,8 @@ function buildRegistryEnv(registry: string): Record<string, string> {
   const bunCacheRoot =
     process.platform === 'win32' && process.env.CI != null ? homedir() : tmpdir();
   const bunCacheDir = mkdtempSync(path.join(bunCacheRoot, 'vp-local-registry-bun-'));
+  const bunTempDir = path.join(bunCacheDir, '.tmp');
+  mkdirSync(bunTempDir);
   return {
     NPM_CONFIG_REGISTRY: registry,
     npm_config_registry: registry,
@@ -570,7 +572,10 @@ function buildRegistryEnv(registry: string): Record<string, string> {
     npm_config_noproxy: noProxy,
     YARN_GLOBAL_FOLDER: mkdtempSync(path.join(tmpdir(), 'vp-local-registry-yarn-')),
     BUN_INSTALL_CACHE_DIR: bunCacheDir,
-    BUN_TMPDIR: path.join(bunCacheDir, '.tmp'),
+    BUN_TMPDIR: bunTempDir,
+    // bunx uses the platform temp directory, not BUN_TMPDIR. Its lockfiles
+    // must not retain tarball URLs for a previous run's closed registry.
+    TMPDIR: bunTempDir,
   };
 }
 
diff --git a/packages/tools/src/sync-remote-deps.ts b/packages/tools/src/sync-remote-deps.ts
index 28e96c2876..a8c15e4a51 100755
--- a/packages/tools/src/sync-remote-deps.ts
+++ b/packages/tools/src/sync-remote-deps.ts
@@ -4,6 +4,11 @@ import { join } from 'node:path';
 import { parseArgs } from 'node:util';
 
 import upstreamVersions from '../.upstream-versions.json' with { type: 'json' };
+import {
+  alignVendoredVitestDependencies,
+  REMOVED_VITEST_PACKAGES,
+  VITEST_EXACT_VERSION_PACKAGES,
+} from './vendored-vitest.ts';
 
 interface PnpmWorkspace {
   packages?: string[];
@@ -370,11 +375,9 @@ const OXC_PACKAGES = new Set([
   'oxlint',
   'oxlint-tsgolint',
 ]);
-const VITEST_DEPS = new Set(['tinybench']);
-
 // These packages should always use the highest version
 function syncedPackages(packageName: string): boolean {
-  if (OXC_PACKAGES.has(packageName) || VITEST_DEPS.has(packageName)) {
+  if (OXC_PACKAGES.has(packageName) || packageName === 'tinybench') {
     return true;
   }
   return OXC_PACKAGE_PREFIXES.some((prefix) => packageName.startsWith(prefix));
@@ -531,26 +534,34 @@ export function mergePnpmWorkspaces(
   packagesSet.add(`${VITE_DIR}/packages/*`);
   result.packages = Array.from(packagesSet);
 
-  // Merge catalog
-  const catalog: Record<string, string> = { ...main.catalog };
-
-  // Add all entries from rolldown catalog
-  for (const [pkg, version] of Object.entries(rolldown.catalog || {})) {
-    if (catalog[pkg]) {
-      // Merge versions
-      catalog[pkg] = mergeSemverVersions(catalog[pkg], version, pkg, semver);
-    } else {
-      catalog[pkg] = version;
-    }
-  }
-
-  // Add all entries from vite catalog (if it has one)
-  for (const [pkg, version] of Object.entries(rolldownVite.catalog || {})) {
-    if (catalog[pkg]) {
-      // Merge versions
-      catalog[pkg] = mergeSemverVersions(catalog[pkg], version, pkg, semver);
-    } else {
-      catalog[pkg] = version;
+  // The upgrade script selects the latest supported Vitest release and updates
+  // the runtime constant with it. Upstream catalogs must not replace that pin.
+  const vitestVersion = main.catalog?.vitest;
+  const catalog: Record<string, string> = {};
+  for (const workspace of [main, rolldown, rolldownVite]) {
+    for (const [pkg, version] of Object.entries(workspace.catalog || {})) {
+      if (REMOVED_VITEST_PACKAGES.has(pkg)) {
+        // Unused upstream entries are harmless; actual dependency uses fail in
+        // alignVendoredVitestDependencies instead of reinstalling removed packages.
+        continue;
+      }
+      if (VITEST_EXACT_VERSION_PACKAGES.has(pkg)) {
+        if (
+          !vitestVersion ||
+          !/^5\.\d+\.\d+$/.test(vitestVersion) ||
+          semver.valid(vitestVersion) !== vitestVersion
+        ) {
+          throw new Error('The root Vitest catalog entry must be an exact stable v5 version');
+        }
+        catalog[pkg] = vitestVersion;
+      } else if (pkg === '@vitest/browser-webdriverio' && main.catalog?.[pkg]) {
+        // This community provider does not share the official release schedule.
+        catalog[pkg] = main.catalog[pkg];
+      } else {
+        catalog[pkg] = catalog[pkg]
+          ? mergeSemverVersions(catalog[pkg], version, pkg, semver)
+          : version;
+      }
     }
   }
 
@@ -902,7 +913,12 @@ export async function syncRemote() {
   // Merge upstream catalogs into the main workspace while preserving its comments.
   const yamlContent = mergeWorkspaceYaml(mainSrc, rolldownSrc, rolldownViteSrc, yaml, semver);
 
+  const vitestVersion = (yaml.parse(yamlContent) as PnpmWorkspace).catalog?.vitest;
+  if (!vitestVersion || !semver.valid(vitestVersion)) {
+    throw new Error('The Vitest catalog entry must be an exact version');
+  }
   writeFileSync(mainWorkspacePath, yamlContent, 'utf-8');
+  alignVendoredVitestDependencies(rootDir, vitestVersion);
 
   log('✓ pnpm-workspace.yaml updated successfully!');
 
diff --git a/packages/tools/src/vendored-vitest.ts b/packages/tools/src/vendored-vitest.ts
new file mode 100644
index 0000000000..d068690afe
--- /dev/null
+++ b/packages/tools/src/vendored-vitest.ts
@@ -0,0 +1,86 @@
+import { existsSync, readFileSync, readdirSync, realpathSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+// This module runs before dependency installation and Node.js setup in CI.
+// Keep it independent of installed project dependencies, with only built-in imports.
+// These official packages share the runner version selected by upgrade-deps.ts.
+// Community packages, such as browser-webdriverio, have independent versions.
+export const VITEST_EXACT_VERSION_PACKAGES = new Set([
+  'vitest',
+  '@vitest/browser',
+  '@vitest/browser-playwright',
+  '@vitest/browser-preview',
+  '@vitest/coverage-v8',
+  '@vitest/coverage-istanbul',
+  '@vitest/mocker',
+  '@vitest/pretty-format',
+  '@vitest/snapshot',
+  '@vitest/spy',
+  '@vitest/ui',
+  '@vitest/utils',
+  '@vitest/web-worker',
+]);
+export const REMOVED_VITEST_PACKAGES = new Set(['@vitest/runner', '@vitest/expect']);
+
+interface PackageJson {
+  dependencies?: Record<string, string>;
+  devDependencies?: Record<string, string>;
+  optionalDependencies?: Record<string, string>;
+}
+
+export function alignVendoredVitestDependencies(rootDir: string, version: string): void {
+  // Keep Vite's direct dependencies aligned with the root catalog so sync-remote
+  // and CI use the same lockfile. Leave Rolldown's test dependencies to upstream.
+  const packagesDir = join(rootDir, 'vite', 'packages');
+  const dirs = [
+    join(rootDir, 'vite'),
+    ...readdirSync(packagesDir, { withFileTypes: true })
+      .filter((entry) => entry.isDirectory())
+      .map((entry) => join(packagesDir, entry.name)),
+  ];
+  for (const dir of dirs) {
+    const file = join(dir, 'package.json');
+    if (!existsSync(file)) {
+      continue;
+    }
+    const source = readFileSync(file, 'utf8');
+    const pkg: PackageJson = JSON.parse(source);
+    let changed = false;
+    for (const field of ['dependencies', 'devDependencies', 'optionalDependencies'] as const) {
+      const dependencies = pkg[field] ?? {};
+      for (const [name, currentVersion] of Object.entries(dependencies)) {
+        if (REMOVED_VITEST_PACKAGES.has(name)) {
+          throw new Error(`Migrate removed ${name} use in ${file} before synchronizing Vitest`);
+        }
+        if (!VITEST_EXACT_VERSION_PACKAGES.has(name)) {
+          continue;
+        }
+        // Only the default catalog is aligned during sync; named catalogs can still use v4.
+        if (currentVersion !== version && currentVersion !== 'catalog:') {
+          dependencies[name] = version;
+          changed = true;
+        }
+      }
+    }
+    if (changed) {
+      writeFileSync(file, `${JSON.stringify(pkg, null, 2)}\n`);
+    }
+  }
+}
+
+if (
+  process.argv[1] &&
+  existsSync(process.argv[1]) &&
+  fileURLToPath(import.meta.url) === realpathSync(process.argv[1])
+) {
+  const rootDir = process.cwd();
+  // upgrade-deps.ts keeps this exact runtime pin in sync with the root catalog.
+  // Read the declaration without importing CLI code or an installed YAML parser.
+  const constants = readFileSync(join(rootDir, 'packages/cli/src/utils/constants.ts'), 'utf8');
+  const version = constants.match(/^export const VITEST_VERSION = '(5\.\d+\.\d+)';\r?$/m)?.[1];
+  if (!version) {
+    throw new Error('VITEST_VERSION must declare an exact stable v5 version');
+  }
+  alignVendoredVitestDependencies(rootDir, version);
+}
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 17a7772290..193562046e 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -94,38 +94,32 @@ catalogs:
       specifier: 7.0.0-dev.20260605.1
       version: 7.0.0-dev.20260605.1
     '@vitest/browser':
-      specifier: 4.1.11
-      version: 4.1.11
+      specifier: 5.0.1
+      version: 5.0.1
     '@vitest/browser-playwright':
-      specifier: 4.1.11
-      version: 4.1.11
+      specifier: 5.0.1
+      version: 5.0.1
     '@vitest/browser-preview':
-      specifier: 4.1.11
-      version: 4.1.11
+      specifier: 5.0.1
+      version: 5.0.1
     '@vitest/browser-webdriverio':
-      specifier: 4.1.11
-      version: 4.1.11
-    '@vitest/expect':
-      specifier: 4.1.11
-      version: 4.1.11
+      specifier: 5.0.0
+      version: 5.0.0
     '@vitest/mocker':
-      specifier: 4.1.11
-      version: 4.1.11
+      specifier: 5.0.1
+      version: 5.0.1
     '@vitest/pretty-format':
-      specifier: 4.1.11
-      version: 4.1.11
-    '@vitest/runner':
-      specifier: 4.1.11
-      version: 4.1.11
+      specifier: 5.0.1
+      version: 5.0.1
     '@vitest/snapshot':
-      specifier: 4.1.11
-      version: 4.1.11
+      specifier: 5.0.1
+      version: 5.0.1
     '@vitest/spy':
-      specifier: 4.1.11
-      version: 4.1.11
+      specifier: 5.0.1
+      version: 5.0.1
     '@vitest/utils':
-      specifier: 4.1.11
-      version: 4.1.11
+      specifier: 5.0.1
+      version: 5.0.1
     bingo:
       specifier: ^0.9.3
       version: 0.9.3
@@ -253,8 +247,8 @@ catalogs:
       specifier: ^7.0.2
       version: 7.0.2
     vitest:
-      specifier: 4.1.11
-      version: 4.1.11
+      specifier: 5.0.1
+      version: 5.0.1
     vue:
       specifier: ^3.5.35
       version: 3.5.40
@@ -319,7 +313,7 @@ importers:
         version: link:packages/cli
       vitest:
         specifier: 'catalog:'
-        version: 4.1.11(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@4.1.11)(@vitest/browser-preview@4.1.11)(@vitest/browser-webdriverio@4.1.11)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
+        version: 5.0.1(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@5.0.1)(@vitest/browser-preview@5.0.1)(@vitest/browser-webdriverio@5.0.0)(@vitest/ui@5.0.1)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
 
   packages/cli:
     dependencies:
@@ -331,31 +325,25 @@ importers:
         version: 1.79.0
       '@vitest/browser':
         specifier: 'catalog:'
-        version: 4.1.11(vite@packages+core)(vitest@4.1.11)
+        version: 5.0.1(vite@packages+core)(vitest@5.0.1)
       '@vitest/browser-preview':
         specifier: 'catalog:'
-        version: 4.1.11(vite@packages+core)(vitest@4.1.11)
-      '@vitest/expect':
-        specifier: 'catalog:'
-        version: 4.1.11
+        version: 5.0.1(vite@packages+core)(vitest@5.0.1)
       '@vitest/mocker':
         specifier: 'catalog:'
-        version: 4.1.11(vite@packages+core)
+        version: 5.0.1(vite@packages+core)
       '@vitest/pretty-format':
         specifier: 'catalog:'
-        version: 4.1.11
-      '@vitest/runner':
-        specifier: 'catalog:'
-        version: 4.1.11
+        version: 5.0.1
       '@vitest/snapshot':
         specifier: 'catalog:'
-        version: 4.1.11
+        version: 5.0.1
       '@vitest/spy':
         specifier: 'catalog:'
-        version: 4.1.11
+        version: 5.0.1
       '@vitest/utils':
         specifier: 'catalog:'
-        version: 4.1.11
+        version: 5.0.1
       oxfmt:
         specifier: 'catalog:'
         version: 0.68.0(vite-plus@packages+cli)
@@ -370,7 +358,7 @@ importers:
         version: link:../core
       vitest:
         specifier: 'catalog:'
-        version: 4.1.11(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@4.1.11)(@vitest/browser-preview@4.1.11)(@vitest/browser-webdriverio@4.1.11)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
+        version: 5.0.1(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@5.0.1)(@vitest/browser-preview@5.0.1)(@vitest/browser-webdriverio@5.0.0)(@vitest/ui@5.0.1)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
     devDependencies:
       '@emnapi/core':
         specifier: 'catalog:'
@@ -395,10 +383,10 @@ importers:
         version: 4.0.2
       '@vitest/browser-playwright':
         specifier: 'catalog:'
-        version: 4.1.11(playwright@1.62.1)(vite@packages+core)(vitest@4.1.11)
+        version: 5.0.1(playwright@1.62.1)(vite@packages+core)(vitest@5.0.1)
       '@vitest/browser-webdriverio':
         specifier: 'catalog:'
-        version: 4.1.11(vite@packages+core)(vitest@4.1.11)(webdriverio@9.20.1(supports-color@8.1.1))
+        version: 5.0.0(vite@packages+core)(vitest@5.0.1)(webdriverio@9.20.1(supports-color@8.1.1))
       '@voidzero-dev/vite-plus-prompts':
         specifier: workspace:*
         version: link:../prompts
@@ -638,7 +626,7 @@ importers:
         version: 7.8.5
       vitest:
         specifier: 'catalog:'
-        version: 4.1.11(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@4.1.11)(@vitest/browser-preview@4.1.11)(@vitest/browser-webdriverio@4.1.11)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
+        version: 5.0.1(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@5.0.1)(@vitest/browser-preview@5.0.1)(@vitest/browser-webdriverio@5.0.0)(@vitest/ui@5.0.1)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
       yaml:
         specifier: 'catalog:'
         version: 2.9.0
@@ -958,8 +946,8 @@ importers:
         specifier: workspace:@voidzero-dev/vite-plus-core@*
         version: link:../packages/core
       vitest:
-        specifier: ^4.1.11
-        version: 4.1.11(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.13.3)(@vitest/browser-playwright@4.1.11)(@vitest/browser-preview@4.1.11)(@vitest/browser-webdriverio@4.1.11)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
+        specifier: 5.0.1
+        version: 5.0.1(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.13.3)(@vitest/browser-playwright@5.0.1)(@vitest/browser-preview@5.0.1)(@vitest/browser-webdriverio@5.0.0)(@vitest/ui@5.0.1)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
 
   vite/packages/create-vite:
     devDependencies:
@@ -1113,8 +1101,8 @@ importers:
         specifier: ^0.7.1
         version: 0.7.3(@devframes/json-render@0.9.18(@devframes/hub@0.9.18(crossws@0.4.12(srvx@1.0.4))(devframe@0.9.18(cac@7.0.0)(srvx@1.0.4)))(devframe@0.9.18(cac@7.0.0)(srvx@1.0.4)))(crossws@0.4.12(srvx@1.0.4))(srvx@1.0.4)(vite@packages+core)
       '@vitest/utils':
-        specifier: 4.1.11
-        version: 4.1.11
+        specifier: 5.0.1
+        version: 5.0.1
       '@voidzero-dev/vite-task-client':
         specifier: ^0.2.0
         version: 0.2.0
@@ -1863,8 +1851,8 @@ packages:
     resolution: {integrity: sha512-Vj1jF3cPfxg7OAfoI7QnVKLoILlm2JF9pnVHrX8qx7AHMiYWT+NDAA7jChlNgRS4WTLc/fD1lXLmPixluj+3Gg==}
     engines: {node: '>=6.9.0'}
 
-  '@blazediff/core@1.9.1':
-    resolution: {integrity: sha512-ehg3jIkYKulZh+8om/O25vkvSsXXwC+skXmyA87FFx6A/45eqOkZsBltMw/TVteb0mloiGT8oGRTcjRAz66zaA==}
+  '@blazediff/core@1.10.0':
+    resolution: {integrity: sha512-AOQff0zgR7cGsZL+4E7hVkmujoPUpm0J9xzWGWZj5wCjd3gmxESXAPfKyuzs93VdpQNFhHlBhfOjrcZ+XTERtQ==}
 
   '@braidai/lang@1.1.2':
     resolution: {integrity: sha512-qBcknbBufNHlui137Hft8xauQMTZDKdophmLFv05r2eNmdIv/MlPuP4TdUknHG68UdWLgVZwgxVe735HzJNIwA==}
@@ -4288,8 +4276,8 @@ packages:
     resolution: {integrity: sha512-o4PXJQidqJl82ckFaXUeoAW+XysPLauYI43Abki5hABd853iMhitooc6znOnczgbTYmEP6U6/y1ZyKAIsvMKGg==}
     engines: {node: '>=18'}
 
-  '@testing-library/user-event@14.6.1':
-    resolution: {integrity: sha512-vq7fv0rnt+QTXgPxr5Hjc210p6YKq2kmdziLgnsZGgLJ9e6VAShx1pACLuRjd/AS/sr7phAR58OIIpf0LlmQNw==}
+  '@testing-library/user-event@14.6.7':
+    resolution: {integrity: sha512-MPCpX8bxe8zS+JmmTwLp8jd0dy1rAm60Te/SL8JrQM3qvQJcBOs1d7IefJMyZzqM3EWBrDn/LWDt1BCGu4ASfg==}
     engines: {node: '>=12', npm: '>=6'}
     peerDependencies:
       '@testing-library/dom': '>=7.21.4'
@@ -4711,33 +4699,31 @@ packages:
   '@vitejs/release-scripts@1.10.0':
     resolution: {integrity: sha512-1vPdK4Jm2vxCFpaf4D7Nwam677OUoXqUU0WqhLjYec38qiK/XXkzuWK6QnFkn9ty63F+slN13pNUCwEHPOLRuQ==}
 
-  '@vitest/browser-playwright@4.1.11':
-    resolution: {integrity: sha512-riLBxPqwnJ0lWs2DN2WeUfYeKLoAjbP2Xx8cLQdSddzMi20sksIa6K2mPz79DyMZKKVKH2ksOC2yJvtNcZg8cg==}
+  '@vitest/browser-playwright@5.0.1':
+    resolution: {integrity: sha512-BlknN81ZeoCyP5CSm5u7+1BTlS7d0cDU5DfndNSjEC3SmbzOESGrp+DQpNhQmTlggawWc+yKVEM03mM/aBynqg==}
     peerDependencies:
       playwright: '*'
-      vitest: 4.1.11
+      vitest: 5.0.1
 
-  '@vitest/browser-preview@4.1.11':
-    resolution: {integrity: sha512-iPKSE6Ibayey6HFgK1V1/aHgyhx7HSRk1YMi+lnBZGmlIiNV5Uc7xRkD9Su8RDylTxDECK23t7kTHdRKoqSYDQ==}
+  '@vitest/browser-preview@5.0.1':
+    resolution: {integrity: sha512-NagNnZD6A8ccl+pycLWX2b/e9YJtH5NuDUyiiadQjptMRuZVBAB9r9I3itdKm6exxtcl+rOTv2rWt6vu5uOm1A==}
     peerDependencies:
-      vitest: 4.1.11
+      vitest: 5.0.1
 
-  '@vitest/browser-webdriverio@4.1.11':
-    resolution: {integrity: sha512-utftie0XLjhATDCCRAaCZFVlosjQX6mF8UK+mo0q2yTn+XASUdz21tqvAA6fYRgLDiHAIVI06cBaKAklRp4UVA==}
+  '@vitest/browser-webdriverio@5.0.0':
+    resolution: {integrity: sha512-faotr4XiQrpK7yK+GTSWTA2pYSPFMZZA+fXx0rtKh9mvAjCMBM0Q2UJ5NIv6o5Oqkn2CASIrKnePaC/37judJA==}
+    engines: {node: ^22.12.0 || ^24.0.0 || >=26.0.0}
     peerDependencies:
-      vitest: 4.1.11
+      vitest: ^5.0.0
       webdriverio: '*'
 
-  '@vitest/browser@4.1.11':
-    resolution: {integrity: sha512-bwMovvAeuTFOK5kIFevw4VEf+1gVEICv4SYK4k3knJOxl6b1zEWud8mYKD73e1B0odAn174h1MofURy2TPWf3w==}
+  '@vitest/browser@5.0.1':
+    resolution: {integrity: sha512-s2UroEhP2BZPoen1qrXXTtVqnUcs6y2sxMLGCZ8tZDkH2iM/6tTC2GVTPCgF+oVF3X5M6wC/X2O0MvvoHNmH0Q==}
     peerDependencies:
-      vitest: 4.1.11
-
-  '@vitest/expect@4.1.11':
-    resolution: {integrity: sha512-VX2x5vNJXET47KAFzwERI+KRMtTTCSWTfSMKsW7JsUsXV4psq++e3DvZpuTDOpHcxytiDs6p2nhVb2tVDiiUYw==}
+      vitest: 5.0.1
 
-  '@vitest/mocker@4.1.11':
-    resolution: {integrity: sha512-2XJVD55d1o5AZous5CCGKS74g/riOj9odEt2bQpCVZeblHyHdnMeFl4jl0XjU21stf4mbjUkew2eXQZt65g5CQ==}
+  '@vitest/mocker@5.0.1':
+    resolution: {integrity: sha512-6K1DoBNAPGvuOcSsGA4D6x+5zEEff/KmOOP3uetT2TrGpVfI+HRHRnJJfKi5ib/g1vx8IYHQD8s0pbJz8WQI7Q==}
     peerDependencies:
       msw: ^2.4.9
       vite: workspace:@voidzero-dev/vite-plus-core@*
@@ -4747,20 +4733,22 @@ packages:
       vite:
         optional: true
 
-  '@vitest/pretty-format@4.1.11':
-    resolution: {integrity: sha512-yiZzPbGTS9Sr/JpFl8zHrcIkAofNbFV6k21vIgQN/cY/oxZeXhJv5sc/MBJ5jFKWmWs+oJHw0UXLZjmf931+Vw==}
+  '@vitest/pretty-format@5.0.1':
+    resolution: {integrity: sha512-6guWwj5d9bguuefTOvJoq387tfpkzSv554YdUEGzjJH2PnnmvzTLQ1UQSuAk5wBFVhf2CUmy/S/palOcb6dmpA==}
 
-  '@vitest/runner@4.1.11':
-    resolution: {integrity: sha512-LztvUgdwMNJMIkj3hQnnxiC2Xy1zNxq928W/xhjCLaNCzqTZOudjwbQf6v9IntZGPw132i2Lq2rgTRZHD3JHNw==}
+  '@vitest/snapshot@5.0.1':
+    resolution: {integrity: sha512-aEW4fuQVg1i3fnC781qvwxC5QNptUvb+JjIUfX1WuWJqkjCgpiU8+I89mMcJmxOPLdaGAwEPFFVk02rGKYexvw==}
 
-  '@vitest/snapshot@4.1.11':
-    resolution: {integrity: sha512-pN7ikn1ON7h8ee4gIAp4AzyK+zBtJPzVbqOgu5LCEh4VaJVbPQcgYQYJIMGQPXVeJJq1fnfazis7a5pFNPahog==}
+  '@vitest/spy@5.0.1':
+    resolution: {integrity: sha512-rbto/mF/SGERxEgYOek7Xm6B9b+y+mVoo+f4b2LymYO8zM1b7uB5nHuhVMTP2hxdzgxvGiZYGxGIaMvL5y180Q==}
 
-  '@vitest/spy@4.1.11':
-    resolution: {integrity: sha512-apNa/prQy2qCeywhnixOHPRCgGNhvg7T4Dapfl1GahLp/R+uhBm5cPyFoNVyqsNd2h1nJxL6BqqdIjiABL60YA==}
+  '@vitest/ui@5.0.1':
+    resolution: {integrity: sha512-7PvQu/X9/pQoHYfNLAYL22qsD4/+sx2k7zpUA7XvjW0sc40r3/r0lGZ2fsEyOHMuO8Q1KjiO1QQVjJdnWUy/WQ==}
+    peerDependencies:
+      vitest: 5.0.1
 
-  '@vitest/utils@4.1.11':
-    resolution: {integrity: sha512-zTCVGpyFsGWBhllOyKlTw/vnr6D9qxsfSDyfbyZmTyjHw5N/VuvzHpHoQjm2ZJzn4RJgx5w4r7V0er69CmLgPQ==}
+  '@vitest/utils@5.0.1':
+    resolution: {integrity: sha512-E9+yEA+jsfaoxZcUHFzEqUrQcoNh2EwrPT5efIqkUPUwD5Ua2Li9BRWaYeRwvzvdLgTSVrre8oKNeyrfg7KkdQ==}
 
   '@voidzero-dev/vite-task-client@0.2.0':
     resolution: {integrity: sha512-y932hw4I0qrdlqbDhOC4VS7mtLad+MtXToSVJIZ79Cd7Ib6p4bRuoTRrx6OeedhdPm2yf9+r8ndlhJjn8LbsxQ==}
@@ -6131,8 +6119,8 @@ packages:
     resolution: {integrity: sha512-9Be3ZoN4LmYR90tUoVu2te2BsbzHfhJyfEiAVfz7N5/zv+jduIfLrV2xdQXOHbaD6KgpGdO9PRPM1Y4Q9QkPkA==}
     engines: {node: ^18.19.0 || >=20.5.0}
 
-  expect-type@1.3.0:
-    resolution: {integrity: sha512-knvyeauYhqjOYvQ66MznSMs83wmHrCycNEN6Ao+2AeYEfxUIkuiVxdEa1qlGEPK+We3n0THiDciYSsCcgW/DoA==}
+  expect-type@1.4.0:
+    resolution: {integrity: sha512-KfYbmpRm0VbLjEvVa9yGwCi9GI34xvi7A/HXYWQO65CSD2u3MczUJSuwXKFIxlGsgBQizV9q5J9NHj4VG0n+pA==}
     engines: {node: '>=12.0.0'}
 
   exsolve@1.0.8:
@@ -6199,8 +6187,8 @@ packages:
     resolution: {integrity: sha512-7yAQpD2UMJzLi1Dqv7qFYnPbaPx7ZfFK6PiIxQ4PfkGPyNyl2Ugx+a/umUonmKqjhM4DnfbMvdX6otXq83soQQ==}
     engines: {node: ^12.20 || >= 14.13}
 
-  fflate@0.8.2:
-    resolution: {integrity: sha512-cPJU47OaAoCbg0pBvzsgpTPhmhqI5eJjh/JIu8tPj5q+T7iLvW/JAYUqmE7KOB4R1ZyEhzBaIQpQpardBF5z8A==}
+  fflate@0.8.3:
+    resolution: {integrity: sha512-tbZNuJrLwGUp3zshBtdy4W+ORxZuIh8a5ilyIEQDC5rY1f3U20JMry0Ll3WBzU58EZKsEuJFXhb5gwv8CsPvgA==}
 
   figures@6.1.0:
     resolution: {integrity: sha512-d+l3qxjSesT4V7v2fh+QnmFnUWv9lSpjarhShNTgBOfA0ttejbQUAlHLitbjkoRiDulW0OPoQPYIGhIC8ohejg==}
@@ -6230,8 +6218,8 @@ packages:
     resolution: {integrity: sha512-f7ccFPK3SXFHpx15UIGyRJ/FJQctuKZ0zVuN3frBo4HnK3cay9VEW0R6yPYFHC0AgqhukPzKjq22t5DmAyqGyw==}
     engines: {node: '>=16'}
 
-  flatted@3.4.2:
-    resolution: {integrity: sha512-PjDse7RzhcPkIJwy5t7KPWQSZ9cAbzQXcafsetQoD7sOJRQlGikNbx7yZp2OotDnJyrDcbyRq3Ttb18iYOqkxA==}
+  flatted@3.4.4:
+    resolution: {integrity: sha512-5+ybhBZANEJxaH3X5evAFatUxLfEHSr7n6kYJ+1Qd0mUqr4eu9gIf6GDbWHf8RJijHrjjO8G+la14SlL2SeS1Q==}
 
   follow-redirects@1.16.0:
     resolution: {integrity: sha512-y5rN/uOsadFT/JfYwhxRS5R7Qce+g3zG97+JrtFZlC9klX/W5hD7iiLzScI4nZqUS7DNUdhPgw4xI8W2LuXlUw==}
@@ -6910,8 +6898,8 @@ packages:
     resolution: {integrity: sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==}
     engines: {node: '>=16 || 14 >=14.17'}
 
-  minipass@7.1.2:
-    resolution: {integrity: sha512-qOOzS1cBTWYF4BH8fVePDBOO9iptMnGUEZwNc/cMWnTV2nVLZ7VoNWEPHkYczZA0pdoA7dl6e7FL659nX9S2aw==}
+  minipass@7.1.3:
+    resolution: {integrity: sha512-tEBHqDnIoM/1rXME1zgka9g6Q2lcoCkxHLuc7ODJ5BxbP5d4c2Z5cGgtXAku59200Cx7diuHTOYfSBD8n6mm8A==}
     engines: {node: '>=16 || 14 >=14.17'}
 
   mitt@3.0.1:
@@ -7212,9 +7200,9 @@ packages:
     resolution: {integrity: sha512-Xa4Nw17FS9ApQFJ9umLiJS4orGjm7ZzwUrwamcGQuHSzDyth9boKDaycYdDcZDuqYATXw4HFXgaqWTctW/v1HA==}
     engines: {node: '>=16 || 14 >=14.18'}
 
-  path-scurry@2.0.1:
-    resolution: {integrity: sha512-oWyT4gICAu+kaA7QWk/jvCHWarMKNs6pXOGWKDTr7cw4IGcUbW+PeTfbaQiLGheFRpjo6O9J0PmyMfQPjH71oA==}
-    engines: {node: 20 || >=22}
+  path-scurry@2.0.2:
+    resolution: {integrity: sha512-3O/iVVsJAPsOnpwWIeD+d6z/7PmqApyQePUtCndjatj/9I5LylHvt5qluFaBT3I5h3r1ejfR056c+FCv+NnNXg==}
+    engines: {node: 18 || 20 || >=22}
 
   pathe@2.0.3:
     resolution: {integrity: sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==}
@@ -7944,8 +7932,8 @@ packages:
     resolution: {integrity: sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==}
     engines: {node: '>= 0.8'}
 
-  std-env@4.0.0:
-    resolution: {integrity: sha512-zUMPtQ/HBY3/50VbpkupYHbRroTRZJPRLvreamgErJVys0ceuzMkD44J/QjqhHjOzK42GQ3QZIeFG1OYfOtKqQ==}
+  std-env@4.2.0:
+    resolution: {integrity: sha512-oCUKSupKTHX53EyjDtuZQ64pjLJ6yYCtpmEw0goYxtjG9KpbRe8KAsl2tBUGU9DyMcJ0RwJ8GqJAFzMXcXW1Rw==}
 
   streamx@2.23.0:
     resolution: {integrity: sha512-kn+e44esVfn2Fa/O0CPFcex27fjIL6MkVae0Mm6q+E6f0hWv578YCERbv+4m02cjxvDsPKLnmxral/rR6lBMAg==}
@@ -8064,17 +8052,22 @@ packages:
   text-decoder@1.2.3:
     resolution: {integrity: sha512-3/o9z3X0X0fTupwsYvR03pJ/DjWuqqrfwBgTQzdWDiQSm9KitAyz/9WqsT2JQW7KV2m+bC2ol/zqpW37NHxLaA==}
 
-  tinybench@2.9.0:
-    resolution: {integrity: sha512-0+DUvqWMValLmha6lr4kD8iAMK1HzV0/aKnCtWb9v9641TnP/MFb7Pc2bxoxQjTXAErryXVgUOfv2YqNllqGeg==}
-
   tinybench@6.0.0:
     resolution: {integrity: sha512-BWlWpVbbZXaYjRV0twGLNQO00Zj4HA/sjLOQP2IvzQqGwRGp+2kh7UU3ijyJ3ywFRogYDRbiHDMrUOfaMnN56g==}
     engines: {node: '>=20.0.0'}
 
+  tinybench@6.1.4:
+    resolution: {integrity: sha512-9APumHG7r4yOk4X4WlkmE71aZcv1gvin1czO3OQ1U9iJcFA5Ja/ygyb0vPOVHTthFozUYs8CLoLUlM8grb2lTQ==}
+    engines: {node: '>=20.0.0'}
+
   tinyexec@1.2.4:
     resolution: {integrity: sha512-SHf/r48b7vOrjve9PxJo3MN5v5yuyjHvdUcrQffT3WXMUfnGmHDVbC4k3sHJaJTgZCwpUplIaAo5ANtMyp3YHg==}
     engines: {node: '>=18'}
 
+  tinyexec@1.3.0:
+    resolution: {integrity: sha512-QKAl9m8gWWGHV8jZcPeym6j+XULi6tOf1mT83WYJ4Lk2ytW/uwAWkrP0uFsdoYMdueVJ0qs26wZ+23xeB4ibNQ==}
+    engines: {node: '>=18'}
+
   tinyexec@1.3.1:
     resolution: {integrity: sha512-GCvB3aoys96IuDFBMcTB46JOR6mdMtAToqwiW8JlWhsoh1mhHi/xn9ss/Dg7N555GiJyEt2qzoG/NHCwM6h1EA==}
     engines: {node: '>=18'}
@@ -8091,8 +8084,8 @@ packages:
     resolution: {integrity: sha512-9YodfrxS9g9IbFr/KOjE5bAeJ0p61n3bW6mqvy0jtoeKd1kTW1Cxm0oulm6KX2lyM9Gl6WIe8nEbY7LWv5ZJww==}
     engines: {node: ^20.0.0 || >=22.0.0}
 
-  tinyrainbow@3.1.0:
-    resolution: {integrity: sha512-Bf+ILmBgretUrdJxzXM0SgXLZ3XfiaUuOj/IKQHuTXip+05Xn+uyEYdVg0kYDipTBcLrCVyUzAPz7QmArb0mmw==}
+  tinyrainbow@3.1.1:
+    resolution: {integrity: sha512-yau8yJdTt989Mm0Bd/236QnzEiPf2xLLTqUZRUJOo/3CB078LSwzei343DgtJVmfJKJE3TMINY1u42SQsP6mXw==}
     engines: {node: '>=14.0.0'}
 
   tldts-core@7.0.19:
@@ -8425,20 +8418,20 @@ packages:
     resolution: {integrity: sha512-sXMwN6DMHeouPfCxkxWkKAmxphWKEenHYY5H1nIBzU3PmDsmJp6kBXJdshjVdpMZuWCmL9SH7KFRx29AylpP6g==}
     engines: {node: '>=18.12.0'}
 
-  vitest@4.1.11:
-    resolution: {integrity: sha512-fhACrNXUidIbGSBr5FlbuBkO7VWC1ZyLl0DO4CU2DrQoAPxX84Ysxs+HeGQpii5lZWV1Q4gBZTTu49mF+A6Edw==}
-    engines: {node: ^20.0.0 || ^22.0.0 || >=24.0.0}
+  vitest@5.0.1:
+    resolution: {integrity: sha512-iA95lQbKEkvrtTkdAgnWbXfbipWiiWe/hDl2P5tMi6WFwD76G0NxXAGp/M9EOcYupeGJRr6wppMc7CoA41TQjg==}
+    engines: {node: ^22.12.0 || ^24.0.0 || >=26.0.0}
     hasBin: true
     peerDependencies:
       '@edge-runtime/vm': '*'
       '@opentelemetry/api': ^1.9.0
-      '@types/node': ^20.0.0 || ^22.0.0 || >=24.0.0
-      '@vitest/browser-playwright': 4.1.11
-      '@vitest/browser-preview': 4.1.11
-      '@vitest/browser-webdriverio': 4.1.11
-      '@vitest/coverage-istanbul': 4.1.11
-      '@vitest/coverage-v8': 4.1.11
-      '@vitest/ui': 4.1.11
+      '@types/node': ^22.0.0 || >=24.0.0
+      '@vitest/browser-playwright': 5.0.1
+      '@vitest/browser-preview': 5.0.1
+      '@vitest/browser-webdriverio': ^5.0.0-beta.5 || >=5.0.0
+      '@vitest/coverage-istanbul': 5.0.1
+      '@vitest/coverage-v8': 5.0.1
+      '@vitest/ui': 5.0.1
       happy-dom: '*'
       jsdom: '*'
       vite: workspace:@voidzero-dev/vite-plus-core@*
@@ -8712,7 +8705,7 @@ snapshots:
       '@andrewbranch/untar.js': 1.0.3
       '@loaderkit/resolve': 1.0.4
       cjs-module-lexer: 1.4.3
-      fflate: 0.8.2
+      fflate: 0.8.3
       lru-cache: 11.2.7
       semver: 7.8.5
       typescript: 5.6.1-rc
@@ -9473,7 +9466,7 @@ snapshots:
       '@babel/helper-string-parser': 7.29.7
       '@babel/helper-validator-identifier': 7.29.7
 
-  '@blazediff/core@1.9.1': {}
+  '@blazediff/core@1.10.0': {}
 
   '@braidai/lang@1.1.2': {}
 
@@ -11350,7 +11343,7 @@ snapshots:
       picocolors: 1.1.1
       pretty-format: 27.5.1
 
-  '@testing-library/user-event@14.6.1(@testing-library/dom@10.4.1)':
+  '@testing-library/user-event@14.6.7(@testing-library/dom@10.4.1)':
     dependencies:
       '@testing-library/dom': 10.4.1
 
@@ -11767,35 +11760,35 @@ snapshots:
       semver: 7.8.5
       tinyexec: 1.3.1
 
-  '@vitest/browser-playwright@4.1.11(playwright@1.62.1)(vite@packages+core)(vitest@4.1.11)':
+  '@vitest/browser-playwright@5.0.1(playwright@1.62.1)(vite@packages+core)(vitest@5.0.1)':
     dependencies:
-      '@vitest/browser': 4.1.11(vite@packages+core)(vitest@4.1.11)
-      '@vitest/mocker': 4.1.11(vite@packages+core)
+      '@vitest/browser': 5.0.1(vite@packages+core)(vitest@5.0.1)
+      '@vitest/mocker': 5.0.1(vite@packages+core)
       playwright: 1.62.1
-      tinyrainbow: 3.1.0
-      vitest: 4.1.11(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@4.1.11)(@vitest/browser-preview@4.1.11)(@vitest/browser-webdriverio@4.1.11)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
+      tinyrainbow: 3.1.1
+      vitest: 5.0.1(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@5.0.1)(@vitest/browser-preview@5.0.1)(@vitest/browser-webdriverio@5.0.0)(@vitest/ui@5.0.1)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
     transitivePeerDependencies:
       - bufferutil
       - msw
       - utf-8-validate
       - vite
 
-  '@vitest/browser-preview@4.1.11(vite@packages+core)(vitest@4.1.11)':
+  '@vitest/browser-preview@5.0.1(vite@packages+core)(vitest@5.0.1)':
     dependencies:
       '@testing-library/dom': 10.4.1
-      '@testing-library/user-event': 14.6.1(@testing-library/dom@10.4.1)
-      '@vitest/browser': 4.1.11(vite@packages+core)(vitest@4.1.11)
-      vitest: 4.1.11(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@4.1.11)(@vitest/browser-preview@4.1.11)(@vitest/browser-webdriverio@4.1.11)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
+      '@testing-library/user-event': 14.6.7(@testing-library/dom@10.4.1)
+      '@vitest/browser': 5.0.1(vite@packages+core)(vitest@5.0.1)
+      vitest: 5.0.1(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@5.0.1)(@vitest/browser-preview@5.0.1)(@vitest/browser-webdriverio@5.0.0)(@vitest/ui@5.0.1)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
     transitivePeerDependencies:
       - bufferutil
       - msw
       - utf-8-validate
       - vite
 
-  '@vitest/browser-webdriverio@4.1.11(vite@packages+core)(vitest@4.1.11)(webdriverio@9.20.1(supports-color@8.1.1))':
+  '@vitest/browser-webdriverio@5.0.0(vite@packages+core)(vitest@5.0.1)(webdriverio@9.20.1(supports-color@8.1.1))':
     dependencies:
-      '@vitest/browser': 4.1.11(vite@packages+core)(vitest@4.1.11)
-      vitest: 4.1.11(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@4.1.11)(@vitest/browser-preview@4.1.11)(@vitest/browser-webdriverio@4.1.11)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
+      '@vitest/browser': 5.0.1(vite@packages+core)(vitest@5.0.1)
+      vitest: 5.0.1(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@5.0.1)(@vitest/browser-preview@5.0.1)(@vitest/browser-webdriverio@5.0.0)(@vitest/ui@5.0.1)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
       webdriverio: 9.20.1(supports-color@8.1.1)
     transitivePeerDependencies:
       - bufferutil
@@ -11803,16 +11796,17 @@ snapshots:
       - utf-8-validate
       - vite
 
-  '@vitest/browser@4.1.11(vite@packages+core)(vitest@4.1.11)':
+  '@vitest/browser@5.0.1(vite@packages+core)(vitest@5.0.1)':
     dependencies:
-      '@blazediff/core': 1.9.1
-      '@vitest/mocker': 4.1.11(vite@packages+core)
-      '@vitest/utils': 4.1.11
-      magic-string: 0.30.21
+      '@blazediff/core': 1.10.0
+      '@vitest/mocker': 5.0.1(vite@packages+core)
+      '@vitest/ui': 5.0.1(vitest@5.0.1)
+      '@vitest/utils': 5.0.1
+      magic-string: 1.3.1
       pngjs: 7.0.0
       sirv: 3.0.2(patch_hash=c07c56eb72faea34341d465cde2314e89db472106ed378181e3447893af6bf95)
-      tinyrainbow: 3.1.0
-      vitest: 4.1.11(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@4.1.11)(@vitest/browser-preview@4.1.11)(@vitest/browser-webdriverio@4.1.11)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
+      tinyrainbow: 3.1.1
+      vitest: 5.0.1(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@5.0.1)(@vitest/browser-preview@5.0.1)(@vitest/browser-webdriverio@5.0.0)(@vitest/ui@5.0.1)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
       ws: 8.21.3
     transitivePeerDependencies:
       - bufferutil
@@ -11820,46 +11814,43 @@ snapshots:
       - utf-8-validate
       - vite
 
-  '@vitest/expect@4.1.11':
+  '@vitest/mocker@5.0.1(vite@packages+core)':
     dependencies:
-      '@standard-schema/spec': 1.1.0
-      '@types/chai': 5.2.3
-      '@vitest/spy': 4.1.11
-      '@vitest/utils': 4.1.11
-      chai: 6.2.2
-      tinyrainbow: 3.1.0
-
-  '@vitest/mocker@4.1.11(vite@packages+core)':
-    dependencies:
-      '@vitest/spy': 4.1.11
+      '@jridgewell/trace-mapping': 0.3.31
+      '@vitest/spy': 5.0.1
       estree-walker: 3.0.3
-      magic-string: 0.30.21
+      magic-string: 1.3.1
     optionalDependencies:
       vite: link:packages/core
 
-  '@vitest/pretty-format@4.1.11':
+  '@vitest/pretty-format@5.0.1':
     dependencies:
-      tinyrainbow: 3.1.0
+      tinyrainbow: 3.1.1
 
-  '@vitest/runner@4.1.11':
+  '@vitest/snapshot@5.0.1':
     dependencies:
-      '@vitest/utils': 4.1.11
+      '@vitest/pretty-format': 5.0.1
+      '@vitest/utils': 5.0.1
+      magic-string: 1.3.1
       pathe: 2.0.3
 
-  '@vitest/snapshot@4.1.11':
+  '@vitest/spy@5.0.1': {}
+
+  '@vitest/ui@5.0.1(vitest@5.0.1)':
     dependencies:
-      '@vitest/pretty-format': 4.1.11
-      '@vitest/utils': 4.1.11
-      magic-string: 0.30.21
+      '@vitest/utils': 5.0.1
+      fflate: 0.8.3
+      flatted: 3.4.4
       pathe: 2.0.3
+      sirv: 3.0.2(patch_hash=c07c56eb72faea34341d465cde2314e89db472106ed378181e3447893af6bf95)
+      tinyrainbow: 3.1.1
+      vitest: 5.0.1(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@5.0.1)(@vitest/browser-preview@5.0.1)(@vitest/browser-webdriverio@5.0.0)(@vitest/ui@5.0.1)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
 
-  '@vitest/spy@4.1.11': {}
-
-  '@vitest/utils@4.1.11':
+  '@vitest/utils@5.0.1':
     dependencies:
-      '@vitest/pretty-format': 4.1.11
+      '@vitest/pretty-format': 5.0.1
       convert-source-map: 2.0.0
-      tinyrainbow: 3.1.0
+      tinyrainbow: 3.1.1
 
   '@voidzero-dev/vite-task-client@0.2.0': {}
 
@@ -13151,7 +13142,7 @@ snapshots:
       strip-final-newline: 4.0.0
       yoctocolors: 2.1.2
 
-  expect-type@1.3.0: {}
+  expect-type@1.4.0: {}
 
   exsolve@1.0.8: {}
 
@@ -13218,7 +13209,7 @@ snapshots:
       node-domexception: 1.0.0
       web-streams-polyfill: 3.3.3
 
-  fflate@0.8.2: {}
+  fflate@0.8.3: {}
 
   figures@6.1.0:
     dependencies:
@@ -13253,10 +13244,10 @@ snapshots:
 
   flat-cache@4.0.1:
     dependencies:
-      flatted: 3.4.2
+      flatted: 3.4.4
       keyv: 4.5.4
 
-  flatted@3.4.2: {}
+  flatted@3.4.4: {}
 
   follow-redirects@1.16.0(debug@4.4.3(supports-color@8.1.1)):
     optionalDependencies:
@@ -13369,15 +13360,15 @@ snapshots:
       foreground-child: 3.3.1
       jackspeak: 3.4.3
       minimatch: 9.0.5
-      minipass: 7.1.2
+      minipass: 7.1.3
       package-json-from-dist: 1.0.1
       path-scurry: 1.11.1
 
   glob@13.0.0:
     dependencies:
       minimatch: 10.2.4
-      minipass: 7.1.2
-      path-scurry: 2.0.1
+      minipass: 7.1.3
+      path-scurry: 2.0.2
 
   globals@14.0.0: {}
 
@@ -13904,7 +13895,7 @@ snapshots:
     dependencies:
       brace-expansion: 2.0.2
 
-  minipass@7.1.2: {}
+  minipass@7.1.3: {}
 
   mitt@3.0.1: {}
 
@@ -14294,12 +14285,12 @@ snapshots:
   path-scurry@1.11.1:
     dependencies:
       lru-cache: 10.4.3
-      minipass: 7.1.2
+      minipass: 7.1.3
 
-  path-scurry@2.0.1:
+  path-scurry@2.0.2:
     dependencies:
       lru-cache: 11.2.7
-      minipass: 7.1.2
+      minipass: 7.1.3
 
   pathe@2.0.3: {}
 
@@ -15006,7 +14997,7 @@ snapshots:
 
   statuses@2.0.2: {}
 
-  std-env@4.0.0: {}
+  std-env@4.2.0: {}
 
   streamx@2.23.0:
     dependencies:
@@ -15145,12 +15136,14 @@ snapshots:
     transitivePeerDependencies:
       - react-native-b4a
 
-  tinybench@2.9.0: {}
-
   tinybench@6.0.0: {}
 
+  tinybench@6.1.4: {}
+
   tinyexec@1.2.4: {}
 
+  tinyexec@1.3.0: {}
+
   tinyexec@1.3.1: {}
 
   tinyglobby@0.2.17:
@@ -15162,7 +15155,7 @@ snapshots:
 
   tinypool@2.1.2: {}
 
-  tinyrainbow@3.1.0: {}
+  tinyrainbow@3.1.1: {}
 
   tldts-core@7.0.19:
     optional: true
@@ -15441,69 +15434,59 @@ snapshots:
 
   verkit@0.4.0: {}
 
-  vitest@4.1.11(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@4.1.11)(@vitest/browser-preview@4.1.11)(@vitest/browser-webdriverio@4.1.11)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core):
+  vitest@5.0.1(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@5.0.1)(@vitest/browser-preview@5.0.1)(@vitest/browser-webdriverio@5.0.0)(@vitest/ui@5.0.1)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core):
     dependencies:
-      '@vitest/expect': 4.1.11
-      '@vitest/mocker': 4.1.11(vite@packages+core)
-      '@vitest/pretty-format': 4.1.11
-      '@vitest/runner': 4.1.11
-      '@vitest/snapshot': 4.1.11
-      '@vitest/spy': 4.1.11
-      '@vitest/utils': 4.1.11
+      '@types/chai': 5.2.3
+      '@vitest/mocker': 5.0.1(vite@packages+core)
+      chai: 6.2.2
       es-module-lexer: 2.3.2
-      expect-type: 1.3.0
-      magic-string: 0.30.21
+      expect-type: 1.4.0
+      magic-string: 1.3.1
       obug: 2.1.4
-      pathe: 2.0.3
       picomatch: 4.0.7
-      std-env: 4.0.0
-      tinybench: 2.9.0
-      tinyexec: 1.3.1
+      std-env: 4.2.0
+      tinybench: 6.1.4
+      tinyexec: 1.3.0
       tinyglobby: 0.2.17
-      tinyrainbow: 3.1.0
       vite: link:packages/core
       why-is-node-running: 2.3.0
     optionalDependencies:
       '@edge-runtime/vm': 5.0.0
       '@opentelemetry/api': 1.9.0
       '@types/node': 24.10.3
-      '@vitest/browser-playwright': 4.1.11(playwright@1.62.1)(vite@packages+core)(vitest@4.1.11)
-      '@vitest/browser-preview': 4.1.11(vite@packages+core)(vitest@4.1.11)
-      '@vitest/browser-webdriverio': 4.1.11(vite@packages+core)(vitest@4.1.11)(webdriverio@9.20.1(supports-color@8.1.1))
+      '@vitest/browser-playwright': 5.0.1(playwright@1.62.1)(vite@packages+core)(vitest@5.0.1)
+      '@vitest/browser-preview': 5.0.1(vite@packages+core)(vitest@5.0.1)
+      '@vitest/browser-webdriverio': 5.0.0(vite@packages+core)(vitest@5.0.1)(webdriverio@9.20.1(supports-color@8.1.1))
+      '@vitest/ui': 5.0.1(vitest@5.0.1)
       happy-dom: 20.0.10
       jsdom: 27.2.0(supports-color@8.1.1)
     transitivePeerDependencies:
       - msw
 
-  vitest@4.1.11(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.13.3)(@vitest/browser-playwright@4.1.11)(@vitest/browser-preview@4.1.11)(@vitest/browser-webdriverio@4.1.11)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core):
+  vitest@5.0.1(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.13.3)(@vitest/browser-playwright@5.0.1)(@vitest/browser-preview@5.0.1)(@vitest/browser-webdriverio@5.0.0)(@vitest/ui@5.0.1)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core):
     dependencies:
-      '@vitest/expect': 4.1.11
-      '@vitest/mocker': 4.1.11(vite@packages+core)
-      '@vitest/pretty-format': 4.1.11
-      '@vitest/runner': 4.1.11
-      '@vitest/snapshot': 4.1.11
-      '@vitest/spy': 4.1.11
-      '@vitest/utils': 4.1.11
+      '@types/chai': 5.2.3
+      '@vitest/mocker': 5.0.1(vite@packages+core)
+      chai: 6.2.2
       es-module-lexer: 2.3.2
-      expect-type: 1.3.0
-      magic-string: 0.30.21
+      expect-type: 1.4.0
+      magic-string: 1.3.1
       obug: 2.1.4
-      pathe: 2.0.3
       picomatch: 4.0.7
-      std-env: 4.0.0
-      tinybench: 2.9.0
-      tinyexec: 1.3.1
+      std-env: 4.2.0
+      tinybench: 6.1.4
+      tinyexec: 1.3.0
       tinyglobby: 0.2.17
-      tinyrainbow: 3.1.0
       vite: link:packages/core
       why-is-node-running: 2.3.0
     optionalDependencies:
       '@edge-runtime/vm': 5.0.0
       '@opentelemetry/api': 1.9.0
       '@types/node': 24.13.3
-      '@vitest/browser-playwright': 4.1.11(playwright@1.62.1)(vite@packages+core)(vitest@4.1.11)
-      '@vitest/browser-preview': 4.1.11(vite@packages+core)(vitest@4.1.11)
-      '@vitest/browser-webdriverio': 4.1.11(vite@packages+core)(vitest@4.1.11)(webdriverio@9.20.1(supports-color@8.1.1))
+      '@vitest/browser-playwright': 5.0.1(playwright@1.62.1)(vite@packages+core)(vitest@5.0.1)
+      '@vitest/browser-preview': 5.0.1(vite@packages+core)(vitest@5.0.1)
+      '@vitest/browser-webdriverio': 5.0.0(vite@packages+core)(vitest@5.0.1)(webdriverio@9.20.1(supports-color@8.1.1))
+      '@vitest/ui': 5.0.1(vitest@5.0.1)
       happy-dom: 20.0.10
       jsdom: 27.2.0(supports-color@8.1.1)
     transitivePeerDependencies:
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
index 606a3a82dd..867c4e6f99 100644
--- a/pnpm-workspace.yaml
+++ b/pnpm-workspace.yaml
@@ -8,8 +8,11 @@ packages:
   - vite/packages/*
 catalog:
   '@babel/core': ^7.29.7
+  '@babel/parser': ^7.29.8
   '@babel/preset-env': ^7.29.7
   '@babel/preset-typescript': ^7.29.7
+  '@babel/traverse': ^7.29.8
+  '@babel/types': ^7.29.8
   '@clack/core': ^1.0.0
   '@emnapi/core': 2.0.0-alpha.5
   '@emnapi/runtime': 2.0.0-alpha.5
@@ -31,6 +34,7 @@ catalog:
   '@tsdown/css': ^0.23.0
   '@tsdown/exe': ^0.23.0
   '@types/babel__core': 7.20.5
+  '@types/babel__traverse': ^7.28.0
   '@types/connect': ^3.4.38
   '@types/cross-spawn': ^6.0.6
   '@types/fs-extra': ^11.0.4
@@ -47,17 +51,15 @@ catalog:
   '@types/ws': ^8.18.0
   '@typescript/native-preview': 7.0.0-dev.20260605.1
   '@vitejs/plugin-react': ^5.1.2
-  '@vitest/browser': 4.1.11
-  '@vitest/browser-playwright': 4.1.11
-  '@vitest/browser-preview': 4.1.11
-  '@vitest/browser-webdriverio': 4.1.11
-  '@vitest/expect': 4.1.11
-  '@vitest/mocker': 4.1.11
-  '@vitest/pretty-format': 4.1.11
-  '@vitest/runner': 4.1.11
-  '@vitest/snapshot': 4.1.11
-  '@vitest/spy': 4.1.11
-  '@vitest/utils': 4.1.11
+  '@vitest/browser': 5.0.1
+  '@vitest/browser-playwright': 5.0.1
+  '@vitest/browser-preview': 5.0.1
+  '@vitest/browser-webdriverio': 5.0.0
+  '@vitest/mocker': 5.0.1
+  '@vitest/pretty-format': 5.0.1
+  '@vitest/snapshot': 5.0.1
+  '@vitest/spy': 5.0.1
+  '@vitest/utils': 5.0.1
   '@voidzero-dev/vitepress-theme': 4.8.4
   '@vueuse/core': ^14.0.0
   acorn: ^8.17.0
@@ -132,7 +134,7 @@ catalog:
   vitepress-plugin-group-icons: ^1.7.1
   vitepress-plugin-llms: ^1.1.0
   vitepress-plugin-og: ^0.0.5
-  vitest: 4.1.11
+  vitest: 5.0.1
   vue: ^3.5.35
   web-tree-sitter: ^0.27.0
   ws: ^8.20.1
diff --git a/rfcs/vitest-v5-upgrade.md b/rfcs/vitest-v5-upgrade.md
new file mode 100644
index 0000000000..334ccd224f
--- /dev/null
+++ b/rfcs/vitest-v5-upgrade.md
@@ -0,0 +1,480 @@
+# RFC: Upgrade the Bundled Vitest to v5
+
+- Status: Proposed
+- Tracking issue: [#2405](https://github.com/voidzero-dev/vite-plus/issues/2405)
+- Upstream baseline: [`v5.0.1`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.1)
+- Release target: Vite+ before `1.0`
+
+## Decision
+
+Upgrade `vp test` and the `vite-plus/test*` API to Vitest `5.0.1` before Vite+ 1.0. Pin the official Vitest packages to this patch release.
+
+The upgrade has four parts:
+
+1. Update the bundled runner, browser packages, public shims, resolver, and Vite config integration as one versioned unit.
+2. Add a Vitest v5 pass to `vp migrate`. It preserves v4 test execution behavior where a config option can do so, applies safe source rewrites, and reports changes that need review.
+3. Raise the `vite-plus` Node.js range to the intersection of the current Vite+ range and the Vitest v5 range: `^22.18.0 || ^24.11.0 || >=26.0.0`.
+4. Release the change through a Vite+ prerelease and run the compatibility matrix in this RFC before a stable release.
+
+New projects and configless projects use the Vitest v5 defaults. Migrated v4 configs get explicit compatibility options with comments that explain how to adopt the new behavior. Projects already on v5 keep their choices.
+
+## Context
+
+Before this upgrade, Vite+ pinned `vitest` and the managed `@vitest/*` family to `4.1.11` in `pnpm-workspace.yaml`. The `vite-plus` package:
+
+- resolves and starts its bundled Vitest binary from `packages/cli/src/resolve-test.ts`;
+- generates `vite-plus/test*` exports from the installed Vitest export map in `packages/cli/build.ts`;
+- projects browser providers and selected `@vitest/*` packages into extra compatibility paths;
+- forces Vitest-family imports to the bundled package graph in `packages/cli/src/define-config.ts`;
+- injects resolver, dependency-inline, and coverage-version plugins into the root and each inline test project;
+- rewrites Vitest imports and aligns Vitest ecosystem packages during `vp migrate`.
+
+These parts enforce one physical Vitest instance. That property must remain. Mock state, assertion state, browser types, coverage providers, and runner state can fail when a project loads two copies.
+
+Vitest v5 changes the package graph and project configuration model. A version-only catalog update would create invalid exports, duplicate Vite+ plugins in inline projects, retain removed packages, and keep migration rules that emit paths which no longer exist.
+
+## Goals
+
+- Keep `vp test`, `vite-plus/test*`, browser mode, coverage, and config helpers on one compatible Vitest v5 graph.
+- Preserve v4 test execution behavior in existing configs when a v5 option provides an exact compatibility setting.
+- Give a file and an action for each change that cannot be automated safely.
+- Migrate legacy Vite+ entry points to canonical v5 paths; retain the standalone mocker, browser, and supported plugin shims.
+- Test Node, package manager, project, browser, coverage, reporter, and programmatic API boundaries before release.
+
+## Non-goals
+
+- Reimplement removed Vitest internals.
+- Redesign complex benchmark comparisons and custom reporting integrations automatically.
+- Migrate or report changes that affect only title formatting, report output, artifact paths, or dependency deprecation.
+- Hide new Vitest behavior inside the runner after migration.
+- Support Vitest v5 on Node 20 or Node 25.
+- Require the community WebDriverIO provider to publish in lockstep with Vitest.
+
+## Upstream audit
+
+The audit covers every v5 prerelease, the final [`v5.0.0` release](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0), and the complete [Vitest v5 migration guide](https://vitest.dev/guide/migration#vitest-5). Vitest v5 introduced breaking changes in these groups:
+
+| Release                                                                     | Breaking-change themes                                                                                                                                 |
+| --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| [`beta.1`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0-beta.1) | `pretty-format` output, title formatting, browser iframe scaling, coverage glob matching, and `toThrow('')                                             |
+| [`beta.2`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0-beta.2) | artifact paths, removed sequential APIs, browser automocks, serialized locators, inlined expect, blob reports, and removed entry points                |
+| [`beta.3`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0-beta.3) | Node and Vite prerequisites, and strict `expect.poll` timeout handling                                                                                 |
+| [`beta.4`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0-beta.4) | top-level hoisted mocks, strict browser assertions and locators, and the benchmark rewrite                                                             |
+| [`beta.5`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0-beta.5) | config lookup, runner packaging, DOM globals, worker IDs, browser sessions, and per-file coverage thresholds                                           |
+| [`beta.6`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0-beta.6) | screenshot config, fake timers, WebDriverIO ownership, mock clearing, report defaults, UI authentication, and worker-start failure handling            |
+| [`beta.7`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0-beta.7) | the `resolveConfig` return value                                                                                                                       |
+| [`rc.1`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0-rc.1)     | project inheritance, nested projects, shared servers, test-name separators, async assertions, failure screenshots, class mocks, and assertion generics |
+| [`rc.2`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0-rc.2)     | no new breaking change                                                                                                                                 |
+| [`rc.3`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0-rc.3)     | no new breaking change; Istanbul coverage moved to the `@vitest/istanbul-lib-*` packages                                                               |
+| [`rc.4`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0-rc.4)     | `vitest list` and the programmatic `collect()` API use static parsing by default                                                                       |
+| [`v5.0.0`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0)        | no new breaking change after `rc.4`                                                                                                                    |
+
+Vitest published `v5.0.0` on September 3, 2026. The comparison from `rc.4` to the final tag contains fixes, documentation, dependency updates, and performance work. It contains no additional breaking commit. The final package manifests retain the audited Node, Vite, export, browser-provider, and Istanbul dependency contracts.
+
+The Vitest maintainers released [`v5.0.1`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.1) on September 15, 2026, with the browser `define` fix from [#11198](https://github.com/vitest-dev/vitest/pull/11198). Use the upstream fix and remove the temporary Vite+ backport. Keep the browser regression fixtures.
+
+## Compatibility design
+
+### 1. Runtime and dependency graph
+
+Pin the official Vitest packages to the exact version `5.0.1`. Keep the existing coverage-provider version guard. Coverage packages remain project-installed peers and must match the bundled runner exactly.
+
+| Package group                                                                                 | Policy                                                                                                                                                                                                                                                                         |
+| --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `vitest`                                                                                      | Exact dependency and the only runner started by `vp test`                                                                                                                                                                                                                      |
+| `@vitest/browser`, `@vitest/browser-playwright`, `@vitest/browser-preview`                    | Exact version equal to the runner                                                                                                                                                                                                                                              |
+| `@vitest/mocker`, `@vitest/pretty-format`, `@vitest/snapshot`, `@vitest/spy`, `@vitest/utils` | Keep only when a public Vite+ shim needs the standalone package; pin exactly                                                                                                                                                                                                   |
+| `@vitest/expect`                                                                              | Remove from the bundled graph; route Vitest assertions through the root `vitest` entry so assertion state stays shared                                                                                                                                                         |
+| `@vitest/runner`                                                                              | Remove from catalogs, dependencies, shims, migration alignment, and resolver assumptions; v5 no longer publishes it with the runner                                                                                                                                            |
+| `@vitest/ws-client`                                                                           | Do not add a Vite+ shim; retain standalone use if needed without a deprecation-only migration warning                                                                                                                                                                          |
+| `@vitest/browser-webdriverio`                                                                 | Retain Vitest's optional peer metadata. Remove Vite+ provider exports and restore legacy imports to the [community package](https://github.com/vitest-community/vitest-webdriverio). Migration ensures `>=5.0.0` and the framework peer; users manage later provider upgrades. |
+| `@vitest/coverage-v8`, `@vitest/coverage-istanbul`, `@vitest/ui`                              | Project-installed optional packages; require the exact runner version                                                                                                                                                                                                          |
+| `@vitest/web-worker`                                                                          | Project-installed optional package; keep its exact Vitest peer aligned without adding a Vite+ shim                                                                                                                                                                             |
+
+Replace the resolver's broad `@vitest/*` rule with an explicit supported-package set. In particular, do not redirect a user's standalone `@vitest/expect` to a Vite+ copy. Keep bundle-first resolution for the root `vitest` package, its public subpaths, the official browser packages, and other packages that share runner state. Keep the project fallback for optional peers.
+
+Provide Vitest's required `vite` peer through a published dependency alias to the matching `@voidzero-dev/vite-plus-core` version. Test a Yarn install with no project `vite` or `vitest` dependency; Yarn does not install a missing peer for the bundled runner.
+
+For npm projects that declare `vite` without overrides, use an exact core-version alias matching `vite-plus`. npm can replace a tagged alias such as `npm:@voidzero-dev/vite-plus-core@latest` with upstream Vite while resolving Vitest's peer. Test both shared core identity for the exact alias and the CLI's rejection of the replaced alias. Keep the `vp migrate` repair path, which writes an exact alias and package-manager overrides.
+
+The repository vendors Vite and Rolldown workspaces. Keep the root Vitest v5 pin when merging their catalogs during `sync-remote`, and align Vite's direct `@vitest/*` dependencies with that pin so CI can install with `--frozen-lockfile`. Leave upstream test-suite migrations to the Vite and Rolldown maintainers. Do not add their suites to CI or their test fixtures to the root workspace for this upgrade. Validate the Vite+ integration through its unit tests and CLI/browser regression fixtures.
+
+Use the shared TypeScript helper at `packages/tools/src/vendored-vitest.ts` for both `sync-remote` and CI checkout alignment. CI runs it with `npx tsx` before Node setup and dependency installation; the runner's preinstalled Node may not support direct TypeScript execution. Repeated synchronization must leave the workspace manifest unchanged.
+
+Vitest `5.0.0` uses packages from the `vitest-dev/istanbuljs` repository for Istanbul internals: `@vitest/istanbul-lib-coverage`, `@vitest/istanbul-lib-instrument`, `@vitest/istanbul-lib-report`, and `@vitest/istanbul-lib-source-maps`. Keep those packages on the project-installed `@vitest/coverage-istanbul` dependency edge. The resolver allowlist must not redirect them to a missing Vite+ copy.
+
+### 2. Node.js and Vite prerequisites
+
+Vitest v5 supports Node `^22.12.0 || ^24.0.0 || >=26.0.0` and Vite `^6.4.0 || ^7.0.0 || ^8.0.0`. The bundled Vite satisfies the Vite range.
+
+Set the published `vite-plus` engine to `^22.18.0 || ^24.11.0 || >=26.0.0`. This removes Node 20 and Node 25 from the CLI package. Do not raise the standalone core package's engine only because of Vitest.
+
+Use the selected project runtime for `vp test` without a separate Node-version check at command startup. Keep the requirements in package metadata and migration checks. Users who select an unsupported Node version may get an upstream error instead of a custom diagnostic.
+
+Limit the migration preflight's Node compatibility checks to `.node-version`, `.nvmrc`, and the `engines.node`, `devEngines.runtime`, and `volta.node` declarations in `package.json`. Exclude Node versions in CI workflows, containers, and other files.
+
+Automatically upgrade incompatible runtime pins before installing dependencies. Select the nearest supported minimum at or above the old version: `20.19.0` becomes `22.18.0`, `24.10.0` becomes `24.11.0`, and `25.9.0` becomes `26.0.0`. Preserve supported pins and forward-moving aliases such as `lts/*` and `latest`. Report selectors that cannot be resolved for review.
+
+Keep public `engines.node` contracts unchanged. Do not report an engine range with a supported minimum, such as `>=22.19.0`, or a whole supported major, such as `24.x`. A library's public engine contract and its concrete test runtime serve different purposes.
+
+### 3. Public `vite-plus/test*` exports
+
+Continue to generate the main test surface from the v5 `vitest` export map, with extra entries for the standalone mocker API and supported browser and plugin paths. Snapshot the final export keys in a test so an upstream export change cannot alter the Vite+ package by accident.
+
+Remove these legacy Vite+ aliases in 1.0. Migrate both `vitest/*` and `vite-plus/test/*` imports to the canonical Vite+ entries:
+
+| Removed Vite+ path            | Migration target         |
+| ----------------------------- | ------------------------ |
+| `vite-plus/test/coverage`     | `vite-plus/test/node`    |
+| `vite-plus/test/reporters`    | `vite-plus/test/node`    |
+| `vite-plus/test/environments` | `vite-plus/test/runtime` |
+| `vite-plus/test/snapshot`     | `vite-plus/test/runtime` |
+
+Retain `vite-plus/test/mocker` as the migration target for `vitest/mocker`. It re-exports the standalone `@vitest/mocker` API, which has no corresponding v5 `vitest` entry. Keep migration and lint autofixes on the shared entry-point map.
+
+Do not create partial shims for `vite-plus/test/runners`, `vite-plus/test/suite`, `vite-plus/test/plugins/runner`, `vite-plus/test/plugins/expect`, or `vite-plus/test/internal/module-runner`. Their old symbols do not have a complete one-to-one v5 implementation with the required shared state. The migration reports them and directs users to `expect`, `TestRunner`, and its static methods from `vite-plus/test` where possible.
+
+Keep the Playwright and Preview provider aliases. Remove the WebDriverIO aliases and migrate their imports to the community package. Update `packages/cli/BUNDLING.md` to state which paths mirror upstream and which paths are Vite+ compatibility contracts.
+
+Route the existing browser-context runtime aliases to `vitest/browser`. This includes provider `/context` paths, `vite-plus/test/browser/context`, `vite-plus/test/context`, and `vite-plus/test/plugins/browser-context`. Keep their upstream type declarations and augmentations. In v5, the `@vitest/browser/context` JavaScript export is an error stub; the browser plugin resolves only `vitest/browser` as its virtual context module.
+
+Use the final community WebDriverIO provider `5.0.0` as the compatibility test baseline with Vitest `5.0.1`. Keep the optional peer range `^5.0.0-beta.5 || >=5.0.0` from the final Vitest manifest. Test future community releases before changing the baseline; the provider follows its own release schedule.
+
+### 4. Config integration and project inheritance
+
+Vitest v4 inline projects did not inherit root plugins. The v4 Vite+ wrapper therefore prepended its three plugins to the root and every inline project. Vitest v5 sets `extends: true` by default and merges plugin arrays. Keeping the old injection behavior would register each Vite+ plugin twice.
+
+Change the injection algorithm as follows:
+
+1. Inject the resolver, dependency-inline, and coverage-version plugins into the root config.
+2. For an inline project that inherits the declaring config, rely on the inherited plugins.
+3. For `extends: false` or an explicit external base config, inject the plugins into that project.
+4. Apply the same rule after resolving function and promise project entries.
+5. Make each Vite+ plugin idempotent by name as a defense against user merges and nested referenced configs.
+6. Keep the coverage guard keyed by the shared Vitest instance because `configureVitest` can run for several projects.
+
+Referenced config files and directories still resolve their own Vite config. Their `defineConfig` or `defineProject` call injects the Vite+ plugins. Add fixtures for raw config files that do not use the Vite+ helpers and give them the existing soft fallback behavior.
+
+Keep Vitest's directory-local config lookup. Do not scan parent directories or print a startup warning. From a subdirectory, users can select the parent config with `vp test --config ../vite.config.ts --dir .`; document this command in the migration guide.
+
+Limit matcher-dependency detection to Vitest servers. Cache installed and missing packages per project root during each config load, then clear the cache on config reload. Cache the bundled Vitest export metadata across browser entry points and project configs.
+
+## Migration design
+
+Add a versioned Vitest v5 migration pass. Run its preflight before package changes. If blockers exist, print them and stop before edits or dependency updates. Otherwise, perform safe edits and print unresolved review items once in the final summary, grouped by file. Include a documentation link with each Vitest v5 diagnostic.
+
+Determine the source runner version before updating dependencies, including catalog and installed Vite+ dependencies. Keep that version in memory through the current invocation. Do not read or write a migration state file. On later runs, resolve the runner version again and retain v5 choices without applying v4 defaults, including in configless projects.
+
+Require installed or lockfile evidence when a dependency range spans both v4 and v5. Accept manifest ranges that identify one supported source major without requiring an installed runner. Retain deferred source-review findings through the current run's final report without reapplying its v4 edits. Later runs report issues detectable from current files; users must resolve or save v4-specific reviews before discarding the original dependency evidence. Ignore state files from earlier previews and leave their removal to the user.
+
+Apply the Node policy above before installers run. Restrict migration edits and diagnostics to execution compatibility. Leave title formatting, regular reporter options, generated output paths, and dependency deprecation unchanged and unreported. Removed benchmark APIs and flags still need migration so commands can run.
+
+### Behavior-preserving config edits
+
+For a v4 config, write these options when the corresponding setting was absent. The example shows the compatibility values; generated settings also receive the comments described below.
+
+```ts
+export default defineConfig({
+  test: {
+    clearMocks: false,
+    sharedViteServer: false,
+    projects: [
+      {
+        extends: false,
+        test: {
+          clearMocks: false,
+          browser: {
+            locators: { exact: false },
+          },
+        },
+      },
+    ],
+  },
+});
+```
+
+Only write `sharedViteServer: false` when the config has inline projects. Only write `extends: false` on inline object projects that omitted it. Write `clearMocks: false` into each effective project that does not inherit the root setting. Only write `browser.locators.exact: false` for browser projects. Preserve explicit settings and inherited values. When an external base cannot be resolved, retain the child's settings and report inheritance for review instead of inserting defaults that can override the base.
+
+Beside each added compatibility setting, write a comment with its reason, guidance for adopting v5 behavior, and a link to the relevant upstream migration section. This includes `clearMocks`, `sharedViteServer`, `extends`, locator `exact`, coverage `perFile`, and Temporal `toNotFake`. Leave existing settings and comments untouched, including settings inserted by earlier migrations. Repeated runs must not duplicate comments or restore comments that the user removed. See the [migration guide](../docs/guide/vitest-v5.md#preserve-existing-behavior) for an example.
+
+If a v4 project has no test config, use v5 defaults without a review prompt or a new compatibility config. If another migration step creates `vite.config.ts`, apply the v4 compatibility settings to that config during the same invocation.
+
+Also apply these edits when no conflict exists:
+
+- move `browser.api` to top-level `api`, or remove the redundant browser setting when both static values are equivalent, regardless of property order or quote style;
+- copy a custom `browser.screenshotDirectory` to `browser.expect.toMatchScreenshot.screenshotDirectory`;
+- add `perFile: true` to glob threshold objects that inherited a top-level `coverage.thresholds.perFile: true` in v4;
+- add `.vitest/` to `.gitignore`, but retain old artifact entries until their directories are empty;
+- add `Temporal` to `fakeTimers.toNotFake` when the project installs a global Temporal polyfill and did not configure the option.
+
+The `toNotFake` option only preserves behavior while fake timers run. It does not preserve the v4 behavior of `vi.setSystemTime()` without fake timers.
+
+### Safe source and config rewrites
+
+Apply AST or structured command rewrites for these forms:
+
+- `test.sequential`, `it.sequential`, `describe.sequential`, and `{ sequential: true }` to `{ concurrent: false }` forms, moving a numeric third-argument timeout into the new options object;
+- unawaited async assertions in tests and hooks to awaited forms when their callbacks can safely become `async`;
+- all v4 browser `toHaveTextContent` calls with a string or regular expression to `toMatchTextContent`;
+- `await render(...)` for `vitest-browser-vue` and `vitest-browser-svelte` when the enclosing callback can become `async` without changing its contract;
+- `resolveConfig` pair destructuring to the v5 return value and `.test` access;
+- deprecated Vitest entry points to the canonical Vite+ v5 paths;
+- root-safe `@vitest/expect` imports to `vite-plus/test`;
+- supported `@vitest/runner` uses to `TestRunner` from `vite-plus/test`;
+- direct `vitest list` commands without a static-parse flag to include `--no-static-parse`;
+- direct calls to the programmatic `Vitest.collect()` API to pass `{ staticParse: false }` when the options are absent or are a static object without `staticParse`.
+
+Run specific mappings before the current generic `vitest/<subpath>` rewrite. The generic rule must only emit a path present in the final `vite-plus` export map.
+
+Do not infer exact text-match intent from a v4 browser `toHaveTextContent` call. A string used partial matching in v4, even when the current fixture contains the same complete string. A browser project can keep `toHaveTextContent` only when the user chooses v5 assertion behavior.
+
+Preserve Node `@testing-library/jest-dom` calls. Determine file ownership before renaming a plain `expect()` matcher. Report shared Node/browser files, dynamic project settings, and browser CLI overrides for review. An `expect.element()` call identifies a browser assertion even when the config is dynamic.
+
+Follow `projects` and `extends` references within test configs, excluding plugin options with those names. Report the root jest-dom type entry for review in Vitest TypeScript configs. Users must load `@testing-library/jest-dom/vitest` through `compilerOptions.types` or an included TypeScript setup file; a JavaScript runtime setup alone does not prove type coverage.
+
+Use an explicit symbol allowlist for `@vitest/runner` migrations:
+
+| v4 runner symbol                                                                                                       | v5 migration                                                                                                                                |
+| ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
+| `test`, `it`, `describe`, `suite`, `recordArtifact`, `TestAPI`, `SuiteAPI`, `SuiteCollector`, `TestArtifact`           | import the same name from `vite-plus/test`                                                                                                  |
+| `File`, `Suite`, `Test`, `Task`, `VitestRunner`, `VitestRunnerConfig`                                                  | import `RunnerTestFile`, `RunnerTestSuite`, `RunnerTestCase`, `RunnerTask`, `VitestTestRunner`, or `TestRunnerConfig` from `vite-plus/test` |
+| `getCurrentSuite`, `getCurrentTest`, `createTaskCollector`                                                             | use `TestRunner.getCurrentSuite`, `TestRunner.getCurrentTest`, or `TestRunner.createTaskCollector` from `vite-plus/test`                    |
+| `getFn`, `getHooks`, `setFn`, `setHooks`                                                                               | use `TestRunner.getTestFn`, `TestRunner.getSuiteHooks`, `TestRunner.setTestFn`, or `TestRunner.setSuiteHooks` from `vite-plus/test`         |
+| `FileSpecification`, `SuiteHooks`, `TaskUpdateEvent`, `startTests`, `collectTests`, `updateTask`, and unlisted symbols | report the use and require manual migration                                                                                                 |
+
+The migration must preserve local import aliases when it applies a supported rewrite. An unsupported runtime use blocks the package update. An unsupported type-only use produces a review-required finding.
+
+### File ownership
+
+Build scopes from active configs, not every discovered config file. Respect `vitest.config` precedence over `vite.config`, explicit config selection in scripts, and referenced projects. A sibling inactive config must not suppress global API migration.
+
+Resolve `test.root` as an override of the Vite root. Track `test.dir` separately as the test discovery directory, including literal `--root` and `--dir` overrides. Match test include/exclude patterns relative to that directory. Keep setup-file resolution tied to the owning project's root, independently of test discovery patterns.
+
+Include declared setup files even when they have no test filename or Vitest import. Resolve extensionless entries with Vitest-compatible extension precedence and directory index lookup. Report unresolved entries rather than assigning ownership to a guessed file.
+
+Resolve benchmark membership separately through `benchmark.include`, `benchmark.exclude`, and `benchmark.includeSource`, including default benchmark filenames. Scan known in-source benchmarks with `import.meta.vitest` even when globals are disabled.
+
+Only rewrite unbound global APIs in files owned by compatible Vitest scopes. Explicit Vitest bindings remain usable independently of global settings. Preserve unrelated Jest or other runner files. Report uncertain ownership when dynamic settings or incompatible shared scopes prevent a safe decision.
+
+### Review-required findings
+
+Report remaining issues with a file location and documentation link. Gate reviews about changed v4 behavior on the original source version; do not repeat them for a project already on v5. Removed APIs and other invalid current code still need diagnostics. The checklist covers:
+
+- `-t` patterns that may span a suite boundary, excluding plain single-segment filters;
+- nested `vi.mock`, `vi.unmock`, or `vi.hoisted` calls;
+- factory-free `vi.mock()` calls in browser tests;
+- class constructor mocks created with `vi.fn`, `vi.spyOn`, or `mockImplementation`;
+- benchmark references, options, and removed flags that remain after supported automatic rewrites;
+- unawaited `resolves`, `rejects`, file-snapshot, poll, or browser assertions that cannot be rewritten safely;
+- custom matcher declarations that use the old `Assertion<T>`, `Matchers<T>`, or `jest.Matchers` shape;
+- custom browser commands that receive a locator string;
+- code that uses `VITEST_POOL_ID` or `VITEST_WORKER_ID` as a zero-based value;
+- custom environments that restore `populateGlobal().originals` with assignment;
+- assignments to DOM globals in jsdom or happy-dom tests;
+- Temporal use in a file or setup scope that also calls `vi.setSystemTime()`;
+- direct UI or browser-orchestrator URLs without a token or session ID;
+- referenced config files that merge a root config containing `test.projects`;
+- dynamic, function, or promise inline projects whose effective config cannot be determined from source;
+- plugins that depend on one Vite server or config execution per project;
+- `vitest list` commands or programmatic `collect()` calls whose static-parse setting cannot be determined or rewritten safely;
+- configured `coverage.include` or `coverage.exclude` when a v4/v5 resolved file-set comparison is unavailable;
+- imports from removed runner, suite, or internal module-runner APIs that have no direct replacement;
+- `@vitest/expect` or `@vitest/runner` symbols that are not available from the root v5 API.
+
+The command exits successfully after safe edits when only review items remain. Block dependency updates when the source version cannot be determined, when conflicting or unresolved `api` values cannot be merged, or when an unsupported removed runtime API remains. Incompatible Node pins are automatic edits, not blockers; unresolved Node selectors require review.
+
+### Exact output and removed-API reference
+
+Keep these v5 defaults as a reference for users who consume reports and artifacts outside Vitest. They do not require output-only migration edits or diagnostics:
+
+| Surface               | v4                              | v5                                                     |
+| --------------------- | ------------------------------- | ------------------------------------------------------ |
+| Attachments           | `.vitest-attachements/`         | `.vitest/attachments/`                                 |
+| Failure screenshots   | `__screenshots__/`              | `.vitest/attachments/failure-screenshots/`             |
+| Blob reporter         | `.vitest-reports/blob-*.json`   | `.vitest/blob/blob-*.json`                             |
+| HTML reporter         | `html/index.html`; `outputFile` | `.vitest/index.html`; `outputDir`                      |
+| JSON reporter         | stdout                          | `.vitest/json/output.json`                             |
+| JUnit reporter        | stdout                          | `.vitest/junit/output.xml`                             |
+| Reference screenshots | `browser.screenshotDirectory`   | `browser.expect.toMatchScreenshot.screenshotDirectory` |
+
+Users can retain JSON and JUnit stdout with `{ stdout: true }`. An explicit reporter `outputFile` remains valid except for the HTML reporter's renamed directory option. The migration does not insert `stdout: true` or rewrite regular HTML reporter destinations.
+
+Vitest v5 removes the top-level `bench` API; `bench.skip`, `bench.only`, and `bench.todo`; `benchmark.reporters`; `benchmark.outputFile`; `benchmark.compare`; `benchmark.outputJson`; `--compare`; and `--outputJson`. The replacements are the `bench` test-context fixture, regular test modifiers, and regular reporters. `Vitest.mode` is always `test`.
+
+Convert direct `bench` calls with inline zero-argument callbacks or references to unchanged local functions into tests using the `bench` fixture and `.run()`. Support dynamic names by evaluating them once during registration. Preserve parenthesized callback arguments and surrounding `describe` and `suite` scopes. Move simple `skip`, `only`, and `todo` modifiers to the test. Use readable `test` and `bench` bindings, adding aliases only when needed to avoid a name conflict.
+
+Apply these rewrites to imports, owned globals, and supported destructured or direct-member uses of `import.meta.vitest`. Preserve the in-source guard and production behavior. Block unresolved references, wrappers, calls with benchmark options, and unsupported callbacks. If syntax validation or overlapping edits discard a rewrite, retain the removed-API blocker; a review alone must not permit upgrading unchanged legacy code.
+
+Move built-in `benchmark.reporters` settings (`default` and `verbose`) and literal `benchmark.outputFile` or `benchmark.outputJson` destinations to regular reporters when compatible. Rewrite literal `--outputJson` commands to use the JSON reporter while preserving the path. Keep existing reporter choices when they conflict with the proposed move and report the unresolved setting. Custom reporters, dynamic settings, project-specific settings, and config merges need manual review or a blocker when a removed option remains.
+
+Retain supported benchmark options, including `benchmark.enabled`, discovery patterns, and the `vitest bench` command. Baseline `compare` settings and `--compare` flags remain blockers. Report consumers must adopt the v5 JSON schema themselves; do not emit an output-format-only diagnostic.
+
+The entry-point migration uses these exact mappings:
+
+| Removed v4 entry point                   | v5 action                                      |
+| ---------------------------------------- | ---------------------------------------------- |
+| `vitest/coverage`, `vitest/reporters`    | import from `vite-plus/test/node`              |
+| `vitest/environments`, `vitest/snapshot` | import from `vite-plus/test/runtime`           |
+| `vitest/runners`                         | import `TestRunner` from `vite-plus/test`      |
+| `vitest/suite`                           | use static methods on `TestRunner`             |
+| `vitest/mocker`                          | import from `vite-plus/test/mocker`            |
+| `vitest/internal/module-runner`          | no public replacement; require manual redesign |
+
+## Complete incompatible-change and risk matrix
+
+This matrix tracks every v5 migration-guide item and the extra breaking entries in the release notes. It includes reference-only output changes that do not produce migration findings. “Scan” refers to the versioned `vp migrate` pass; reviews about changed v4 behavior apply only when migrating from v4.
+
+| Change                                                       | Upgrade risk                                                                                                                                            | Vite+ handling                                                                                                                                  |
+| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
+| Node `>=22.12` and Vite `>=6.4`                              | The local CLI can fail before tests start.                                                                                                              | Raise the CLI engine, migrate incompatible Node declarations, and keep bundled Vite in range.                                                   |
+| `clearMocks: true` default                                   | Setup-file, top-level, `beforeAll`, and cross-test mock history disappears.                                                                             | Add commented `clearMocks: false` to v4 configs when absent; preserve explicit and inherited settings.                                          |
+| Configless v4 projects                                       | New defaults apply without a config file that the migration can edit.                                                                                   | Use v5 defaults without a prompt or a new compatibility config; apply v4 defaults if another step creates a config.                             |
+| Full test names use `>`                                      | `-t 'suite test'` no longer matches across the boundary.                                                                                                | Review filters that may span a boundary; do not report plain single-segment filters.                                                            |
+| Test listing uses static parsing                             | Runtime-generated tests and collection side effects can be absent from `vitest list` and `Vitest.collect()` results.                                    | Add `--no-static-parse` or `{ staticParse: false }` to direct migrated uses; report dynamic wrappers.                                           |
+| Browser iframe scaling changed                               | Headed browser UI and screenshot dimensions can differ from v4.                                                                                         | Run headed and headless screenshot fixtures at fixed viewports; refresh baselines only after review.                                            |
+| Inline projects inherit root config                          | Plugins, aliases, setup files, and arrays can apply twice or begin applying.                                                                            | Add `extends: false` to static entries, report dynamic entries, and make plugin injection inheritance-aware.                                    |
+| Referenced configs can define nested projects                | A merged root `projects` field can recurse, duplicate projects, or resolve paths from a new base.                                                       | Scan referenced configs and root-config merges; require manual extraction of a shared config.                                                   |
+| Inline projects share a Vite server                          | Config files and plugin hooks run fewer times; stateful plugins can change behavior.                                                                    | Add `sharedViteServer: false` for migrated inline-project configs; new projects use sharing.                                                    |
+| Hoisted mock calls must be top-level                         | A prior warning becomes a startup error.                                                                                                                | Report each nested call; do not move it automatically because scope dependencies may change.                                                    |
+| Browser automocks remain mocked                              | Exports that called real code now return mock defaults.                                                                                                 | Report factory-free browser mocks; suggest `{ spy: true }` when real behavior is required.                                                      |
+| Class mocks inherit implementation prototypes                | Methods and `instanceof` results change.                                                                                                                | Add focused release tests; report class constructor mocks as review items.                                                                      |
+| Benchmark API rewrite                                        | Top-level `bench` and benchmark-specific reporter, output, and compare options are removed; `vitest bench` remains supported.                           | Convert supported imported, global, and in-source calls, reporters, and output flags; block retained removed APIs and comparisons.              |
+| UI token authentication                                      | Stored or proxied bare UI URLs stop working.                                                                                                            | Preserve the token URL in CLI output; report hard-coded `/__vitest__/` URLs.                                                                    |
+| Fake timers mock `Temporal`                                  | Time tests with a global polyfill change.                                                                                                               | Preserve v4 fake-timer behavior with `toNotFake: ['Temporal']` when detected.                                                                   |
+| `vi.setSystemTime()` mocks `Temporal`                        | Code can observe mocked Temporal time without enabling fake timers.                                                                                     | Report scopes that contain both Temporal use and `vi.setSystemTime()`; do not rewrite them.                                                     |
+| `toThrow('')` matches any message                            | Assertions for an empty error message become too broad.                                                                                                 | Rewrite `toThrow('')` and `toThrowError('')` to `/^$/`.                                                                                         |
+| Assertion types add return and received parameters           | Custom matcher declarations and direct assertion types fail type checking.                                                                              | Report old generic forms, update Vite+ examples, and add type fixtures.                                                                         |
+| `expect.poll` rejects at timeout                             | Polls that completed late now fail.                                                                                                                     | Report configured polls and ask users to review the timeout; do not raise it automatically.                                                     |
+| Unawaited async assertions fail                              | Tests that passed with a warning now fail.                                                                                                              | Detect expression statements and add `await` only when the transform is safe; report the rest.                                                  |
+| Titles and inspected values use `pretty-format`              | Snapshots, `test.each` titles, and reporter consumers can change.                                                                                       | Use v5 formatting without migration edits or prompts.                                                                                           |
+| Sequential APIs and options are removed                      | Test collection fails or concurrency changes.                                                                                                           | Rewrite to `{ concurrent: false }` and preserve numeric timeout arguments in the options object.                                                |
+| Browser command locators serialize as objects                | Custom commands receive an object instead of a selector string.                                                                                         | Report locator-typed command parameters and suggest `SerializedLocator`.                                                                        |
+| Browser locators are exact by default                        | Partial or case-insensitive text lookups stop matching.                                                                                                 | Add `browser.locators.exact: false` to migrated browser projects.                                                                               |
+| `toHaveTextContent` is strict                                | Partial strings and regular expressions fail.                                                                                                           | Rewrite all v4 string and regular-expression calls to `toMatchTextContent` unless the user chooses v5 semantics.                                |
+| Vue and Svelte browser `render` are async                    | Immediate queries can race or access a promise.                                                                                                         | Add `await` where safe and report non-async call sites.                                                                                         |
+| Glob thresholds no longer inherit `perFile`                  | Coverage enforcement can become weaker.                                                                                                                 | Copy `perFile: true` into existing glob threshold objects.                                                                                      |
+| `coverage.thresholds.perFile` also accepts an object         | Config libraries that assume a boolean can reject or misread the new shape.                                                                             | Update Vite+ config types and serializers; the old boolean form needs no migration.                                                             |
+| Coverage include/exclude matching is precise                 | The measured file set can shrink or change.                                                                                                             | Compare resolved v4/v5 file sets. If comparison is unavailable, report all configured patterns for review.                                      |
+| Parent config lookup is removed                              | Running below the config root can ignore configuration.                                                                                                 | Document explicit `--config` and `--dir`; preserve v5 lookup rules without a startup diagnostic.                                                |
+| DOM global assignment updates the window                     | `matchMedia` and other DOM APIs can observe new values.                                                                                                 | Cover jsdom and happy-dom fixtures; report assignments to known DOM globals.                                                                    |
+| `populateGlobal().originals` contains descriptors            | Custom environment teardown can restore descriptor objects as values.                                                                                   | Report assignments from `originals`; recommend `Object.defineProperty`.                                                                         |
+| Browser orchestrator URLs need a session                     | Direct `/__vitest_test__/` links fail.                                                                                                                  | Report hard-coded URLs and retain the URL printed or opened by Vitest.                                                                          |
+| `browser.api` moves to `api`                                 | Custom ports are ignored.                                                                                                                               | Move the option or deduplicate equivalent static values; block conflicting or unresolved values.                                                |
+| Reports and artifacts move under `.vitest`                   | CI uploads, merges, ignores, and stdout pipes can break.                                                                                                | Document paths and add `.vitest/` to ignore files; do not rewrite regular reporters or report output-only changes.                              |
+| Screenshot references use a dedicated option                 | Existing baselines can be read from the wrong directory.                                                                                                | Copy the old custom directory to the new expectation option and retain files.                                                                   |
+| Worker and concurrency IDs are 1-based                       | Array indexes, ports, and database names shift.                                                                                                         | Report environment-variable reads and require project-specific review.                                                                          |
+| Worker-start failures are reported gracefully                | Wrappers that match the old thrown error or localStorage warning can observe different diagnostics.                                                     | Snapshot the Vite+ failure path and preserve Vitest's exit status; no project source migration is needed.                                       |
+| `resolveConfig` returns resolved Vite config                 | Destructuring returns `undefined`; consumers miss `.test`.                                                                                              | Apply a targeted AST rewrite and add a programmatic API fixture.                                                                                |
+| Runner, expect, WebSocket, and WebDriverIO package migration | Removed runner publication, split expect state, and community provider ownership can cause resolution or state failures; WebSocket APIs are deprecated. | Migrate supported APIs, report unsupported uses, route assertions through root `vitest`, and decouple WebDriverIO; no deprecation-only warning. |
+| Deprecated entry points are removed                          | Generated Vite+ shims and current generic migration output can become invalid.                                                                          | Rewrite upstream and legacy Vite+ imports to canonical paths, retain the standalone mocker shim, and block unsupported internals.               |
+
+## Rollout
+
+### Phase 1: compatibility branch
+
+- Pin the official Vitest packages to `5.0.1` in a development branch.
+- Update the package graph, export generator, resolver, project plugin injection, and migration package set.
+- Add export snapshots and unit fixtures before accepting generated package changes.
+- Preserve the root Vitest pin during upstream catalog synchronization and align Vite's direct test dependencies.
+
+### Phase 2: migration support
+
+- Implement the versioned scan, safe rewrites, commented compatibility options, and automatic Node pin upgrades.
+- Add before-and-after fixtures for v4 and v5 projects, configless projects, workspaces, browser projects, and stateless reruns.
+- Cover active config selection, mixed-runner ownership, setup files, and benchmark discovery before allowing global API edits.
+- Publish the migration guide with each item in the risk matrix.
+
+### Phase 3: Vite+ prerelease
+
+- Confirm that the lockfile resolves the official `5.0.1` package graph.
+- Verify one compatible community WebDriverIO provider against Vitest `5.0.1`.
+- Publish a Vite+ prerelease and run ecosystem CI against real projects.
+- Keep the v4-based Vite+ release available for Node 20 and for any WebDriverIO user blocked by community-provider timing.
+
+### Phase 4: stable release
+
+Release only after the gates below pass. State the Node requirement, removed entry points, and the `vp migrate` command in the release notes.
+
+## Validation and release gates
+
+Run these checks against the release-candidate commit with Vitest `5.0.1`. Record the commit, runtime and provider versions, and CI results. The historical results in the appendix describe earlier revisions and do not establish that the current candidate passes.
+
+The implementation must pass these gates:
+
+1. `pnpm tsgo`, `vp check`, `pnpm test:unit`, Rust checks for changed global-CLI code, and the CLI snapshot suite.
+2. Package export tests that resolve every generated `vite-plus/test*` path under its published conditions and compile all typed paths with TypeScript. Import Node-facing APIs under Node ESM, test-facing APIs inside Vitest, and browser-only APIs inside a browser test. Type-only exports and upstream context-error stubs must retain their upstream behavior; importing a browser-only API in plain Node is not a success condition.
+3. Identity tests that prove `vp test`, `vite-plus/test`, browser providers, custom matchers, and coverage use one runner and assertion state.
+4. Node 22.18, 24.11, and 26 jobs. Cover command preparation without a Node-version probe and automatic pin upgrades through `vp migrate`.
+5. npm, pnpm, Yarn, and Bun install and test fixtures. Vite+ does not support Yarn PnP runtime resolution. Start the Yarn fixture with PnP, run the documented `vp migrate` conversion to `node_modules`, then execute its tests. Adding PnP runtime support is outside this upgrade.
+6. Configless, single-project, inherited inline-project, `extends: false`, referenced-config, nested-project, and shared-server fixtures. Add a fixture that combines `extends: false` with `sharedViteServer: false`. Assert independent server and plugin-hook behavior without extra inheritance. Cover config precedence, root and directory overrides, setup resolution, and test/benchmark ownership with preservation checks for unrelated files.
+7. Playwright and Preview browser suites. Track the existing Preview real-timer regression separately from new v5 failures, as described below. Run the WebDriverIO suite against a verified community release without requiring an exact Vitest patch version.
+8. V8 and Istanbul coverage with matching providers, mismatched-provider rejection, glob threshold checks, and v4/v5 file-list comparison. Verify the final `@vitest/istanbul-lib-*` dependency graph.
+9. JSON, JUnit, HTML, blob merge, attachments, failure screenshots, and reference-screenshot path fixtures.
+10. UI token, browser session, custom command locator, jsdom, happy-dom, Temporal, custom environment, worker ID, `resolveConfig`, `vitest list`, `Vitest.collect()`, custom matcher, and benchmark migration fixtures. Include globals and `import.meta.vitest` benchmarks, parenthesized callbacks, and plans that retain blockers after rejected rewrites.
+11. `ecosystem-ci` cases for `vite-plus-vitest-global-type-minimal-repro`, `vitest-playwright-repro`, and `vite-plus-vitest-type-aug`, followed by the broader ecosystem set.
+12. Dependency synchronization and a frozen-lockfile install from a clean checkout. The alignment helper must run on CI's preinstalled Node before Node setup or dependency installation. Upstream Vite and Rolldown test suites are outside this release gate.
+13. Migration diagnostics with documentation links, a single final review summary, automatic Node pin upgrades, and comments beside newly inserted compatibility settings. Verify v5-to-Vite+ migration and stateless reruns without v4 defaults, v4-only reviews, or output-only prompts.
+
+## Alternatives
+
+### Adopt all v5 defaults for existing projects
+
+This keeps migrated configs smaller but makes an ordinary package update change mock history, project inheritance, plugin lifetimes, and locator matching at once. New and configless projects get these defaults. Existing v4 configs receive explicit compatibility settings that users can remove after the affected tests pass.
+
+### Force v4 defaults inside `vp test`
+
+This avoids config edits but makes Vite+ behavior differ from the Vitest v5 documentation and programmatic API. Explicit migration options are visible and removable.
+
+### Mirror every v4 package and entry point
+
+Several removed runner and suite APIs do not have a complete v5 target. Partial shims would fail later and with less useful errors. Keep only aliases with exact public replacements.
+
+### Drop WebDriverIO support
+
+The community maintains the provider under its existing package name. Support direct imports and retain Vitest's optional peer metadata. During migration, ensure a provider version of at least `5.0.0`, add missing framework peers, and update referenced catalogs and stale overrides. For projects that use the provider, add an `@vitest/browser` override matching the bundled runner, or a Yarn resolution. Preserve provider versions and ranges above the minimum without restoring the Vite+ shim or synchronizing future releases.
+
+## Known upstream limitation: Preview real timers
+
+On September 15, 2026, the same unmodified locator-click test passed with Vitest and Preview `4.1.0`, then failed with `4.1.1`, `4.1.11`, and `5.0.0`. Each run used `npx vitest run`, Vite `8.3.0`, and real timers. The [standalone reproduction](https://github.com/why-reproductions-are-required/vitest-5-preview-real-timers) also reproduces the `5.0.0` failure in a CLI-only GitHub Action.
+
+[Vitest #9891](https://github.com/vitest-dev/vitest/pull/9891), shipped in [`4.1.1`](https://github.com/vitest-dev/vitest/releases/tag/v4.1.1), added `vi.advanceTimersByTimeAsync()` to the Preview user-event adapter without a fake-timer check. The source v4 baseline is `4.1.11`, which has the same bug. It is not a new v5 regression or a v5 release blocker, so migration does not add a warning or change provider or timer settings for it.
+
+The `test_v5_preview` fixture records the known failure separately from the passing fake-timer integration case. Keep the failure check until upstream fixes it, then require the real-timer test to pass. Passing the expected-failure check does not prove that real-timer clicks work. Use Playwright for affected tests; an arbitrary v4 release or forced fake timers is not a fix.
+
+## Release follow-up
+
+1. Verify the direct community import from `@vitest/browser-webdriverio@5.0.0` against Vitest `5.0.1`. Retain upstream optional peer metadata without Vite+ provider shims. Test migrations from Vite+ 0.x and Vitest 4 that ensure `>=5.0.0`, preserve newer declarations, and make no further changes on a second run.
+2. Verify a clean `--frozen-lockfile` install after the shared helper aligns Vite's dependencies with the root Vitest pin. Keep this installation check without requiring upstream Vite or Rolldown test-suite migrations.
+3. Verify the upstream browser `define` fix in `5.0.1`, with no Vite+ backport. Keep `test_v5_preview` and `test_v5_browser_defines` to check strings and booleans in raw configs, inherited projects, programmatic APIs, and packed installations. Rerun affected ecosystem projects with the upstream release.
+4. Check Node jest-dom and browser matcher declarations together. The recorded `5.0.1` probe rejected Node regex text assertions and CSS custom-property assertions when `vitest/browser` loaded before the jest-dom augmentation; reversing the imports passed. The `test_v5_upstream_types` fixture covers both orders with `@testing-library/jest-dom` versions `6.9.1` and `7.0.1`, without Vite+ installed. Resolve the declaration conflict before enabling the upgrade for affected projects; an explicit jest-dom type entry alone did not fix the recorded `dify` failure.
+
+## Appendix: Historical validation
+
+These results record earlier branch revisions from September 2026. They predate the final migration scope, diagnostic policy, and CI bootstrap changes. Counts and failures below are historical evidence, not the current release status.
+
+### Prerelease investigation
+
+The investigation spike used `5.0.0-rc.2`. It removed the unavailable runner package, built the CLI and 60 generated test exports, and passed the focused config/resolver tests. The complete TypeScript unit run passed 63 files and 1,029 tests. The spike also reproduced the vendored Rolldown catalog conflict. The `rc.4` static-collection change was not present in that spike.
+
+### Earlier implementation checks
+
+Local checks on macOS recorded the following results:
+
+- Node `22.18.0`, `24.11.0`, and `26.0.0`: 70 unit-test files, with 1,240 tests passed and one skipped on each runtime. Type checking, `vp check`, and the docs build passed.
+- Rust: 314 migration tests, the global-CLI Node-range test, and 24 snapshot-redaction tests passed. `cargo fmt --all --check` and Clippy with warnings denied passed for the changed migration and global-CLI crates.
+- The September 6 upstream-suite run passed 1,904 tests and skipped 19 across Vite, Rolldown, Rolldown watch, and dev-server fixture suites. The `test:vendored` command and its CI step were later removed; these upstream suites are outside the scope of this upgrade.
+- A full CLI snapshot rerun passed 774 cases with one ignored. Three upstream-failure regression cases passed separate comparison runs; they verified expected failures, not successful browser behavior. That suite included five package-manager installation cases and covered mixed Node/browser assertions, plugin config references, container runtime pins, jest-dom type guidance, and Yarn without project `vite` or `vitest` dependencies. Container runtime checks were later removed from migration scope.
+- The three required ecosystem projects passed their prescribed test or type-check commands against the packed checkout. Additional runs covered `vite-plus-jest-dom-repro`, `viteplus-ws-repro`, `vp-config`, and `vite-vue-vercel`. The complete `oxlint-plugin-complexity` workflow passed with lint warnings, including 494 tests. The `vite-plus-monorepo-overrides` check and verification workflow also passed.
+- `tanstack-start-helloworld` passed eight browser tests and its build. `bun-vite-template` passed its validation workflow after the fixture applied the reported jest-dom type-entry repair. On Node `22.18.0`, `rollipop` passed its builds, formatting, and 24 tests; its report-only lint and type-check steps reported errors.
+- On Node `24.11.0`, `vibe-dashboard` passed formatting, five browser tests, and its build. `nuxt-devtools` passed its build, type check, and 67 tests. Its migration reported an automatic-formatting failure; its prescribed workflow did not include formatting.
+- `reactive-resume` passed formatting, type-aware lint, its build, and 196 tests on Node `24.11.0`. On the same runtime, `vitepress` passed formatting, its build, 69 unit tests, 35 development-mode browser tests, 34 production-mode browser tests, and six initialization tests; one production-mode test was skipped.
+- `frm-stack` passed lint, formatting, type checking, and 24 Docker-backed database tests on Node `24.11.0`. `tiptap` passed its package and demo builds, lint, and 1,920 tests on that runtime. On Node `22.18.0`, `varlet` passed its bootstrap and 921 Istanbul coverage tests; its report-only lint step reported the documented ambient `declare` error.
+- `vinext` passed its build and checks on Node `24.11.0`. Its unit shard passed 4,615 tests with two skipped on Node `24.20.0`, with loopback requests excluded from the local proxy. The earlier `24.11.0` run exposed Node glob and React stream differences; tests that used `localhost` also failed until the proxy exclusion was set.
+- `dify` passed its build and 41 tests in two files selected by the prescribed test filters. Its build skipped type validation; the separate type check failed on the Node/browser matcher conflict. `npmx.dev` passed formatting, type checking, and 1,652 Node tests. Its browser run passed 819 tests, failed 254, and skipped five; malformed translation-resource URLs reproduced the browser `define` issue. Its lint step was report-only.
+- The WebDriverIO fixture passed with community provider `5.0.0-rc.1`. Preview passed with fake timers; locator clicks with real timers reproduced the existing upstream regression.
+
+At that revision, 20 of 25 active ecosystem projects passed their prescribed workflows. Preflight blocked `decoders` on its Node `20.x` CI pin, `vue-mini` on its Node `25.9.0` runtime pin, and `yaak` on its Node `20` pin. Those blockers do not describe the current migration: CI Node declarations are now out of scope, and incompatible pins in supported locations are upgraded automatically. The `dify` and `npmx.dev` failures, and the outstanding Linux, Windows, and published-prerelease checks, also describe that revision rather than the current candidate.
+
+### Browser define backport check
+
+The September 11 `npmx.dev` run with the temporary backport passed 1,028 browser tests and skipped five; 45 failures in `a11y.spec.ts` reported Vue's `decodeEntities` warning. Vitest `5.0.1` later supplied the upstream fix, so the Vite+ backport was removed. This earlier run does not replace validation against that release.