@williamthorsen/nmr 0.50.0 → 0.51.0

package/.meta/changelog.json

@@ -1,4 +1,59 @@
 [
+  {
+    "version": "0.51.0",
+    "date": "2026-10-24",
+    "sections": [
+      {
+        "title": "🎉 Features",
+        "audience": "all",
+        "items": [
+          {
+            "description": "Widens the optional `vitest` peer range of `@williamthorsen/nmr` from `>=4.0.0 <5` to `>=4.0.0 <6`, adding support for Vitest 5, under which a bare `vitest` started from a package without its own config needs `--config` naming the root's `vitest.config.*`. (#1100)",
+            "hash": "7a8049951fd41ef398dd2b0fdb88de6086223906",
+            "entry": 1
+          },
+          {
+            "description": "Adds the `nmr-vitest` command and runs every package-scope `test*` script through it; when the package directory does not contain a `vitest.config.*` or `vite.config.*`, `nmr-vitest` passes `--config` naming the `vitest.config.*` at the monorepo root, and otherwise passes its arguments to Vitest unchanged. (#1100)",
+            "hash": "7a8049951fd41ef398dd2b0fdb88de6086223906",
+            "entry": 2
+          }
+        ]
+      },
+      {
+        "title": "🧪 Tests",
+        "audience": "dev",
+        "items": [
+          {
+            "description": "Captures the output that passing tests leaked into the run, asserting on each error, hint, and `TAG_RESOLVE_FAILED` YAML warning emitted by the code under test, and pipes the stdio of the child processes run by tool tests so that their output does not reach the worker's streams. (#1097)",
+            "hash": "ed6e4187d7f30fa27eb59b495c5f51cf07eacdbc",
+            "entry": 2
+          }
+        ]
+      }
+    ]
+  },
+  {
+    "version": "0.50.1",
+    "date": "2026-10-22",
+    "sections": [
+      {
+        "title": "🐛 Bug fixes",
+        "audience": "all",
+        "items": [
+          {
+            "description": "Fixes the issue that the `self-hosted runner` checklist in the `nmr` readyup kit joined every readiness failure into one semicolon-separated line, which hid that a public repo rules out the runner whatever else holds; a public repo now reports its visibility alone, and a private repo lists each failure on its own line. (#1091)",
+            "hash": "615f6f30ff56d0ea777d47752013de0bc479368f",
+            "entry": 1
+          },
+          {
+            "description": "Fixes the issue that the checklist's missing-runner message stated a recent `williamthorsen/hq` allocation as the cause, when it is only a possible one. (#1091)",
+            "hash": "615f6f30ff56d0ea777d47752013de0bc479368f",
+            "entry": 2
+          }
+        ]
+      }
+    ]
+  },
   {
     "version": "0.50.0",
     "date": "2026-10-21",

package/.readyup/kits/default.js

@@ -1,6 +1,6 @@
 /** @noformat -- @generated. Do not edit. Compiled by rdy. */
 /* eslint-disable */
-export const __readyupVersion = "0.42.0";
+export const __readyupVersion = "0.43.0";
 import { createRequire as __rdyCreateRequire } from 'node:module';
 const require = __rdyCreateRequire(import.meta.url);
 
@@ -7382,12 +7382,12 @@ import { isRecord, listTrackedFiles } from "readyup/check-utils";
 import { globSync } from "node:fs";
 import { basename, join, sep } from "node:path";
 
-// ../../node_modules/.pnpm/@williamthorsen+toolbelt.errors@0.8.3/node_modules/@williamthorsen/toolbelt.errors/dist/esm/4-release/isError.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.errors@0.8.4/node_modules/@williamthorsen/toolbelt.errors/dist/esm/4-release/isError.js
 function isError(error) {
   return error instanceof Error || Object.prototype.toString.call(error) === "[object Error]";
 }
 
-// ../../node_modules/.pnpm/@williamthorsen+toolbelt.errors@0.8.3/node_modules/@williamthorsen/toolbelt.errors/dist/esm/4-release/describeError.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.errors@0.8.4/node_modules/@williamthorsen/toolbelt.errors/dist/esm/4-release/describeError.js
 function describeError(error) {
   try {
     if (isError(error) && typeof error.message === "string" && error.message !== "") {
@@ -7660,12 +7660,12 @@ var workspaceScripts = {
   "lint:check": "eslint .",
   "lint:strict": "strict-lint",
   "report-catalog": "nmr-report-catalog",
-  test: `pnpm exec vitest ${GATE_PROJECTS}`,
-  "test:all": "pnpm exec vitest",
-  "test:coverage": `pnpm exec vitest ${GATE_PROJECTS} --coverage`,
-  "test:tool": "pnpm exec vitest --project tool",
-  "test:unit": "pnpm exec vitest --project unit",
-  "test:watch": `pnpm exec vitest ${GATE_PROJECTS} --watch`,
+  test: `nmr-vitest ${GATE_PROJECTS}`,
+  "test:all": "nmr-vitest",
+  "test:coverage": `nmr-vitest ${GATE_PROJECTS} --coverage`,
+  "test:tool": "nmr-vitest --project tool",
+  "test:unit": "nmr-vitest --project unit",
+  "test:watch": `nmr-vitest ${GATE_PROJECTS} --watch`,
   typecheck: "tsgo --noEmit",
   // The command is a string because neither half names an nmr command: Both are binaries.
   upgrade: "nmr-report-catalog && nmr-taze",
@@ -8871,7 +8871,11 @@ async function describeRecommendationSkip(cwd = process.cwd(), readFacts) {
   if ("skip" in status) return status.skip;
   if (status.selection !== "unset") return `CI_RUNS_ON is already set to ${status.facts.ciRunsOn ?? ""}`;
   if (status.exempt !== void 0) return `the repo is exempt: ${status.exempt}`;
-  if (status.failures.length > 0) return `not ready: ${status.failures.join("; ")}`;
+  if (!status.facts.isPrivate) return status.failures.join("\n");
+  if (status.failures.length > 0) {
+    return `not ready:
+${status.failures.map((failure) => `      ${failure}`).join("\n")}`;
+  }
   return false;
 }
 async function describeSelfHostedRunnerSkip(cwd = process.cwd(), readFacts) {
@@ -8879,15 +8883,15 @@ async function describeSelfHostedRunnerSkip(cwd = process.cwd(), readFacts) {
   return "skip" in status && status.skip;
 }
 function findSelfHostedRunnerFailures(facts, cwd) {
-  const failures = [];
   if (!facts.isPrivate) {
-    failures.push(
-      `${facts.nameWithOwner} is public: A self-hosted runner must never run code from a fork's pull request`
-    );
+    return [
+      `${facts.nameWithOwner} is public, so a self-hosted runner must not run its CI: A fork's pull request would run code on the runner`
+    ];
   }
+  const failures = [];
   if (facts.onlineSelfHostedRunners === 0) {
     failures.push(
-      `${facts.nameWithOwner} does not have an online runner labelled self-hosted. When williamthorsen/hq allocates the repo slots in apps/runners/config/repos.yaml, the runners have not registered yet`
+      `${facts.nameWithOwner} does not have an online runner labelled self-hosted. If williamthorsen/hq has just allocated the repo's slots in apps/runners/config/repos.yaml, the runners may not have registered yet`
     );
   }
   const workflows = readWorkflows(cwd);
@@ -8962,7 +8966,7 @@ async function gatherSelfHostedRunnerStatus(cwd, readFacts) {
   try {
     exempt = (await loadRootConfig(cwd)).selfHostedRunner?.exempt;
   } catch (error) {
-    failures.push(`the nmr config cannot be loaded: ${describeError(error)}`);
+    if (facts.isPrivate) failures.push(`the nmr config cannot be loaded: ${describeError(error)}`);
   }
   return {
     facts,
@@ -9184,7 +9188,7 @@ function hasSupportedStrictLintVersion() {
   });
 }
 function getMinVersion() {
-  const pickedFields = { "version": "0.50.0" };
+  const pickedFields = { "version": "0.51.0" };
   if (typeof pickedFields["version"] !== "string") {
     throw new TypeError("nmr/package.json: 'version' must be a string");
   }
@@ -9358,7 +9362,7 @@ var vitestChecks = [
     severity: "recommend",
     quiet: true,
     check: () => noReExportOnlyVitestConfigs(),
-    fix: "Delete these files. Vitest resolves config by walking up from the run root, so a per-package re-export is redundant"
+    fix: "Delete these files. `nmr-vitest` passes the root config to every package that does not have a config of its own, so a per-package re-export is redundant"
   }
 ];
 function everyTestFileNamesItsTier(cwd = process.cwd()) {

package/.readyup/manifest.json

@@ -3,9 +3,9 @@
   "kits": [
     {
       "bundledDependencies": {
-        "@williamthorsen/toolbelt.errors": "0.8.3",
-        "@williamthorsen/toolbelt.filesystem": "0.9.3",
-        "@williamthorsen/toolbelt.packaging": "0.6.3",
+        "@williamthorsen/toolbelt.errors": "0.8.4",
+        "@williamthorsen/toolbelt.filesystem": "0.9.4",
+        "@williamthorsen/toolbelt.packaging": "0.6.4",
         "@williamthorsen/toolbelt.terminal": "0.2.1",
         "ansi-regex": "6.4.0",
         "ansi-styles": "6.2.3",
@@ -24,7 +24,7 @@
           "checklist": "nmr",
           "checks": [
             "@williamthorsen/nmr in devDependencies",
-            "@williamthorsen/nmr >= 0.50.0",
+            "@williamthorsen/nmr >= 0.51.0",
             "pnpm-workspace.yaml exists",
             "catalogued dependencies use catalog:",
             "package.json has packageManager field",
@@ -176,7 +176,7 @@
           "path": "lib/root-scripts.ts"
         },
         {
-          "hash": "3d661ab8",
+          "hash": "97f29052",
           "kind": "module",
           "path": "lib/self-hosted-runner.ts"
         },
@@ -191,7 +191,7 @@
           "path": "lib/shared-configs.ts"
         },
         {
-          "hash": "b3bdf8ee",
+          "hash": "66043902",
           "kind": "module",
           "path": "lib/vitest.ts"
         },
@@ -201,7 +201,7 @@
           "path": "lib/workspace-build.ts"
         },
         {
-          "hash": "4f47ba73",
+          "hash": "006bcdd5",
           "kind": "inline",
           "path": "../package.json",
           "paths": [
@@ -224,7 +224,7 @@
           "path": "../src/config.ts"
         },
         {
-          "hash": "d2448f72",
+          "hash": "72ad1e0e",
           "kind": "module",
           "path": "../src/default-scripts.ts"
         },
@@ -316,10 +316,10 @@
       ],
       "name": "default",
       "path": "kits/default.js",
-      "readyupVersion": "0.42.0",
+      "readyupVersion": "0.43.0",
       "source": "kits/default.ts",
       "sourceHash": "9fd61bf4",
-      "targetHash": "81b3206d"
+      "targetHash": "54da2b6a"
     }
   ]
 }

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable changes to this project will be documented in this file.
 
+## 0.51.0 — 2026-10-24
+
+### 🎉 Features
+
+- Widens the optional `vitest` peer range of `@williamthorsen/nmr` from `>=4.0.0 <5` to `>=4.0.0 <6`, adding support for Vitest 5, under which a bare `vitest` started from a package without its own config needs `--config` naming the root's `vitest.config.*`. (#1100)
+- Adds the `nmr-vitest` command and runs every package-scope `test*` script through it; when the package directory does not contain a `vitest.config.*` or `vite.config.*`, `nmr-vitest` passes `--config` naming the `vitest.config.*` at the monorepo root, and otherwise passes its arguments to Vitest unchanged. (#1100)
+
+### 🧪 Tests
+
+- Captures the output that passing tests leaked into the run, asserting on each error, hint, and `TAG_RESOLVE_FAILED` YAML warning emitted by the code under test, and pipes the stdio of the child processes run by tool tests so that their output does not reach the worker's streams. (#1097)
+
+## 0.50.1 — 2026-10-22
+
+### 🐛 Bug fixes
+
+- Fixes the issue that the `self-hosted runner` checklist in the `nmr` readyup kit joined every readiness failure into one semicolon-separated line, which hid that a public repo rules out the runner whatever else holds; a public repo now reports its visibility alone, and a private repo lists each failure on its own line. (#1091)
+- Fixes the issue that the checklist's missing-runner message stated a recent `williamthorsen/hq` allocation as the cause, when it is only a possible one. (#1091)
+
 ## 0.50.0 — 2026-10-21
 
 ### 🎉 Features

package/README.md

@@ -5,16 +5,12 @@
 Context-aware script runner for pnpm monorepos. Includes an `nmr` (node-monorepo run) binary that provides centralized, consistent script execution across workspace packages and the monorepo root.
 
 <!-- section:release-notes -->
-## Release notes — v0.50.0 (2026-10-21)
+## Release notes — v0.51.0 (2026-10-24)
 
 ### 🎉 Features
 
-- Makes `nmr` run a command on this machine, after printing `nmr: running <command> here rather than on <hosts>` and what `ssh` reported, when the user config's `when` sends the command to other hosts and `ssh` cannot connect to any of them; until now, the delegation failed with exit 255 and a line that named `~/.config/nmr/config.ts`. (#1090)
-- Makes `nmr` delegate to a host that `ssh` connected to, rather than to the first listed host, when several delegation hosts are configured and the lock probe finds every one of them neither free nor busy. (#1090)
-
-### 🐛 Bug fixes
-
-- Fixes the issue that delegation ignored the environment's `GIT_SSH_COMMAND`: `nmr` replaced it with plain `ssh` for the push and ran plain `ssh` for every other call to the host, which kept a machine that reaches its hosts through an ssh wrapper or proxy, such as the Claude Code sandbox, from delegating. (#1088)
+- Widens the optional `vitest` peer range of `@williamthorsen/nmr` from `>=4.0.0 <5` to `>=4.0.0 <6`, adding support for Vitest 5, under which a bare `vitest` started from a package without its own config needs `--config` naming the root's `vitest.config.*`. (#1100)
+- Adds the `nmr-vitest` command and runs every package-scope `test*` script through it; when the package directory does not contain a `vitest.config.*` or `vite.config.*`, `nmr-vitest` passes `--config` naming the `vitest.config.*` at the monorepo root, and otherwise passes its arguments to Vitest unchanged. (#1100)
 <!-- /section:release-notes -->
 
 ## Installation
@@ -84,11 +80,11 @@ nmr detects the directory from which it is invoked and selects the right scripts
 
 nmr's key feature is that the same command runs different scripts depending on where it is invoked. It walks up from the current directory to find `pnpm-workspace.yaml`, then checks whether the current directory is inside a workspace package directory.
 
-| Where `nmr` is invoked            | Registry used     | Working directory | `nmr test` runs                                                      |
-| --------------------------------- | ----------------- | ----------------- | -------------------------------------------------------------------- |
-| Monorepo root                     | Root scripts      | Monorepo root     | `root:test`, then `-R test`                                          |
-| Inside a workspace package        | Workspace scripts | The package root  | `pnpm exec vitest --project unit --project tool` (that package only) |
-| Anywhere, with `--workspace-root` | Root scripts      | Monorepo root     | `root:test`, then `-R test`                                          |
+| Where `nmr` is invoked            | Registry used     | Working directory | `nmr test` runs                                                |
+| --------------------------------- | ----------------- | ----------------- | -------------------------------------------------------------- |
+| Monorepo root                     | Root scripts      | Monorepo root     | `root:test`, then `-R test`                                    |
+| Inside a workspace package        | Workspace scripts | The package root  | `nmr-vitest --project unit --project tool` (that package only) |
+| Anywhere, with `--workspace-root` | Root scripts      | Monorepo root     | `root:test`, then `-R test`                                    |
 
 Relative paths in a script resolve against that working directory, not the invocation directory.
 
@@ -321,7 +317,7 @@ rdy list --from npm:@williamthorsen/nmr  # what nmr publishes
 - [Machine lock](docs/machine-lock.md): Which commands wait for one another, where the lock lives, and bypassing it
 - [Delegating to another machine](docs/delegate.md): The user config, `--delegate`, `--delegate-to`, `NMR_DELEGATE`, where a command runs, choosing among several hosts, what the host runs, and setting it up
 - [Dependency upgrades](docs/upgrades.md): `nmr upgrade`, the upgrade policy, `report-catalog`, `report-overrides`, and `nmr-taze`
-- [Standalone utilities](docs/utilities.md): `nmr-clean`, `nmr-compile`, `nmr-fmt`, and `ensure-prepublish-hooks`
+- [Standalone utilities](docs/utilities.md): `nmr-clean`, `nmr-compile`, `nmr-fmt`, `nmr-vitest`, and `ensure-prepublish-hooks`
 - [Shared Vitest config](docs/vitest.md): Test tiers, test selections, the conventions check, and customization
 - [Shared Prettier config](docs/prettier.md): What it formats and how to customize it
 - [Workspace introspection](docs/workspace.md): The two workspace lookups

package/bin/nmr-vitest.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+try {
+  await import('../dist/esm/cli-vitest.js');
+} catch (error) {
+  if (error.code === 'ERR_MODULE_NOT_FOUND') {
+    process.stderr.write('nmr-vitest: build output not found; run `pnpm run bootstrap` first\n');
+  } else {
+    process.stderr.write(`nmr-vitest: failed to load: ${error.message}\n`);
+  }
+  process.exit(1);
+}

package/dist/esm/cli-vitest.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/cli-vitest.js

@@ -0,0 +1,3 @@
+import process from 'node:process';
+import { runNmrVitest } from "./commands/run-vitest.js";
+process.exitCode = runNmrVitest(process.argv.slice(2), process.cwd());

package/dist/esm/commands/run-vitest.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Runs the Vitest that `cwd` resolves, naming the monorepo root's config when the working directory does not have
+ * one of its own, and returns the exit code to report.
+ */
+export declare function runNmrVitest(argv: string[], cwd?: string): number;
+/**
+ * Returns `argv` with `--config` naming the monorepo root's `vitest.config.*` prepended, or `argv` unchanged when
+ * it already names a config, when `cwd` contains a Vitest or Vite config that Vitest loads itself, or when there is
+ * no monorepo root config to name.
+ *
+ * Vitest 5 does not search parent directories for a config, so a package without its own would otherwise run
+ * without the shared one.
+ */
+export declare function chooseVitestConfigArgs(argv: string[], cwd: string): string[];

package/dist/esm/commands/run-vitest.js

@@ -0,0 +1,79 @@
+import { spawnSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import process from 'node:process';
+import { reportError } from '@williamthorsen/nmr-core';
+import { findMonorepoRoot as findMonorepoRootOrNothing } from '@williamthorsen/nmr-core/workspace';
+import { describeSignalExitCode } from "../child-process.js";
+import { isObject } from "../helpers/type-guards.js";
+const VITEST_PACKAGE = 'vitest';
+const SUPPORTED_VITEST_RANGE = '>=4.0.0 <6';
+const CONFIG_EXTENSIONS = ['ts', 'mts', 'cts', 'js', 'mjs', 'cjs'];
+export function runNmrVitest(argv, cwd = process.cwd()) {
+    const cli = resolveVitestCli(cwd);
+    if (!cli.ok) {
+        reportError(`nmr-vitest: ${cli.error}`);
+        return 1;
+    }
+    const result = spawnSync(process.execPath, [cli.cliPath, ...chooseVitestConfigArgs(argv, cwd)], {
+        cwd,
+        stdio: 'inherit',
+    });
+    if (result.error) {
+        reportError(`nmr-vitest: could not run \`${VITEST_PACKAGE}\` (${result.error.message}).`);
+        return 1;
+    }
+    if (result.signal !== null)
+        return describeSignalExitCode(result.signal);
+    return result.status ?? 1;
+}
+export function chooseVitestConfigArgs(argv, cwd) {
+    if (namesConfig(argv))
+        return argv;
+    if (findConfigFile(cwd, ['vitest.config', 'vite.config']) !== undefined)
+        return argv;
+    const monorepoRoot = findMonorepoRootOrNothing(cwd);
+    if (monorepoRoot === undefined)
+        return argv;
+    const rootConfig = findConfigFile(monorepoRoot, ['vitest.config']);
+    return rootConfig === undefined ? argv : ['--config', rootConfig, ...argv];
+}
+function findConfigFile(dir, stems) {
+    for (const stem of stems) {
+        for (const extension of CONFIG_EXTENSIONS) {
+            const candidate = path.join(dir, `${stem}.${extension}`);
+            if (existsSync(candidate))
+                return candidate;
+        }
+    }
+    return undefined;
+}
+function namesConfig(argv) {
+    for (const arg of argv) {
+        if (arg === '--')
+            return false;
+        if (arg === '--config' || arg === '-c' || arg.startsWith('--config='))
+            return true;
+    }
+    return false;
+}
+function resolveVitestCli(cwd) {
+    const missingResult = {
+        ok: false,
+        error: `requires Vitest ${SUPPORTED_VITEST_RANGE}, but \`${VITEST_PACKAGE}\` could not be resolved from ${cwd}. Install a version in that range as the \`${VITEST_PACKAGE}\` peer dependency.`,
+    };
+    let manifestPath;
+    try {
+        manifestPath = createRequire(path.join(cwd, 'package.json')).resolve(`${VITEST_PACKAGE}/package.json`);
+    }
+    catch {
+        return missingResult;
+    }
+    const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
+    const bin = isObject(manifest) && isObject(manifest['bin']) ? manifest['bin'][VITEST_PACKAGE] : undefined;
+    if (typeof bin !== 'string') {
+        return { ok: false, error: `\`${VITEST_PACKAGE}\` at ${path.dirname(manifestPath)} does not declare a CLI.` };
+    }
+    return { ok: true, cliPath: path.resolve(path.dirname(manifestPath), bin) };
+}

package/dist/esm/default-scripts.js

@@ -18,12 +18,12 @@ export const workspaceScripts = {
     'lint:check': 'eslint .',
     'lint:strict': 'strict-lint',
     'report-catalog': 'nmr-report-catalog',
-    test: `pnpm exec vitest ${GATE_PROJECTS}`,
-    'test:all': 'pnpm exec vitest',
-    'test:coverage': `pnpm exec vitest ${GATE_PROJECTS} --coverage`,
-    'test:tool': 'pnpm exec vitest --project tool',
-    'test:unit': 'pnpm exec vitest --project unit',
-    'test:watch': `pnpm exec vitest ${GATE_PROJECTS} --watch`,
+    test: `nmr-vitest ${GATE_PROJECTS}`,
+    'test:all': 'nmr-vitest',
+    'test:coverage': `nmr-vitest ${GATE_PROJECTS} --coverage`,
+    'test:tool': 'nmr-vitest --project tool',
+    'test:unit': 'nmr-vitest --project unit',
+    'test:watch': `nmr-vitest ${GATE_PROJECTS} --watch`,
     typecheck: 'tsgo --noEmit',
     upgrade: 'nmr-report-catalog && nmr-taze',
     'view-coverage': 'open coverage/index.html',

package/dist/esm/tests.d.ts

@@ -21,7 +21,8 @@ export declare function checkTestFileConventions(options?: TestFileConventionsOp
  * remedy. Outside Vitest it does nothing.
  *
  * A second `@vitest/runner` copy is never handed the running state, and its `describe` fails with a bare `TypeError`.
- * The default `probe` comes from `vitest/suite`, which re-exports the same copy as the `describe` imported here.
+ * The default `probe` is `TestRunner.getCurrentSuite`, imported from the same `vitest` as `describe`, so both come from
+ * one runner copy.
  *
  * @internal - Exported only to enable testing
  */

package/dist/esm/tests.js

@@ -1,5 +1,4 @@
-import { describe, expect, it } from 'vitest';
-import { getCurrentSuite } from 'vitest/suite';
+import { describe, expect, it, TestRunner } from 'vitest';
 import { findMisplacedTestFiles, findUntieredTestFiles, TIER_NAMES } from "./tiers.js";
 import { findMonorepoRoot } from "./workspace.js";
 const MISPLACED_REMEDY = 'Every test file must be under a `__tests__` directory, the only place from which the shared Vitest config collects. Move each file below into one, or name its directory in `excludedBasenames`.';
@@ -18,7 +17,7 @@ export function checkTestFileConventions(options = {}) {
         });
     });
 }
-export function assertImportedRunnerIsActive(probe = getCurrentSuite) {
+export function assertImportedRunnerIsActive(probe = TestRunner.getCurrentSuite) {
     if (process.env['VITEST'] === undefined)
         return;
     try {

package/docs/check-cache.md

@@ -124,7 +124,7 @@ The excerpt is a line; nmr also keeps the run's whole transcript. `nmr --log <co
 ```console
 $ nmr --log test
 💾 nmr: test — recorded 2026-08-12T15:04:05.412Z (12m ago), ran in 12.4s
-$ pnpm exec vitest --project unit --project tool
+$ nmr-vitest --project unit --project tool
 
  ✓ src/__tests__/resolver.unit.test.ts (18 tests) 12ms
 

package/docs/utilities.md

@@ -1,6 +1,6 @@
 # Standalone utilities
 
-The binaries behind nmr's default `clean`, `compile`, and `fmt` commands, and a check for the `prepublishOnly` hooks of publishable packages.
+The binaries behind nmr's default `clean`, `compile`, `fmt`, and package `test` commands, and a check for the `prepublishOnly` hooks of publishable packages.
 
 ## `nmr-clean`
 
@@ -63,6 +63,16 @@ Pass `--no-cache`, or set `NMR_NO_CACHE=1`, to run uncached. `nmr --no-cache fmt
 nmr-fmt --check --no-cache
 ```
 
+## `nmr-vitest`
+
+Run Vitest from a package directory with the monorepo's shared config. Vitest 5 does not search parent directories for a config, so `nmr-vitest` names it: When the working directory does not contain a `vitest.config.*` or `vite.config.*` of its own, it passes `--config` naming the `vitest.config.*` at the monorepo root, the directory that contains `pnpm-workspace.yaml`. It does not search the directories in between. A package with a config of its own, a monorepo root without a `vitest.config.*`, and a directory outside any monorepo all run Vitest without the flag. An explicit `--config` or `-c` ahead of any `--` passes through unchanged, and so does every other argument. This is the command behind every package-scope `test*` script.
+
+`vitest` is an optional peer dependency (`>=4.0.0 <6`), resolved from the working directory alone and never from nmr's installation, because a second copy of the runner is not handed the state of the one that loads the tests. Run without it, `nmr-vitest` fails with an error naming the peer and the range. Its exit status is Vitest's, or 128 plus the signal number when a signal ends Vitest.
+
+```bash
+nmr-vitest --project unit --project tool
+```
+
 ## `ensure-prepublish-hooks`
 
 Verify that all publishable workspace packages have a `prepublishOnly` script. Exits non-zero if any are missing.

package/docs/vitest.md

@@ -4,7 +4,7 @@ The Vitest config that `@williamthorsen/nmr/vitest` publishes: its test tiers an
 
 The [README](../README.md#shared-vitest-config) shows the one-line config file.
 
-`vitest` is a peer dependency (`>=4.0.0 <5`), declared optional; the consuming repo provides it, and repos that never import this subpath are unaffected. `vite` is an optional peer as well (`>=8.0.0 <9`), required only by the [`tsconfigPaths` setting](#resolving-through-tsconfig-paths); a repo that declares a `vite` of its own below that range sees an unmet-peer warning whether or not it sets the flag.
+`vitest` is a peer dependency (`>=4.0.0 <6`), declared optional; the consuming repo provides it, and repos that never import this subpath are unaffected. `vite` is an optional peer as well (`>=8.0.0 <9`), required only by the [`tsconfigPaths` setting](#resolving-through-tsconfig-paths); a repo that declares a `vite` of its own below that range sees an unmet-peer warning whether or not it sets the flag.
 
 ## Test tiers
 
@@ -58,6 +58,8 @@ Every package resolves the same six test commands. Nothing is detected on disk:
 
 To narrow to a single project, go through `test:all`: `nmr test:all --project remote`. Narrowing through `test` does not work, because a second `--project` widens the selection rather than restricting it.
 
+The package scripts run [`nmr-vitest`](utilities.md#nmr-vitest), which names the root config when a package does not have one of its own. Vitest 5 does not search parent directories for a config, so under it a bare `vitest`, or an editor's test runner, started from such a package needs `--config` naming the root's `vitest.config.*`; Vitest 4 finds it unaided. A repo that overrides a package `test*` script with its own `vitest` invocation passes the flag there too.
+
 A run that does not collect any test files passes. That is what lets `nmr test:tool` fan out across a monorepo in which most packages do not have any tool-tier tests, and it means a package without any tests at all does not need a `"test": ""` override.
 
 The root registry defines the same six names, so a command means the same thing from the monorepo root as from inside a package. Each fans out to root-level files and every workspace package.
@@ -100,7 +102,7 @@ checkTestFileConventions({ excludedBasenames: ['cypress', 'generated'] });
 
 **Paths that git ignores are out of scope for both.** The sweep skips every untracked path that git ignores under the swept root, and the shared configs exclude the same paths from collection, so local build output such as a stale `.netlify/` directory is neither reported nor run. Git decides what is ignored: A tracked file stays in scope even when it matches an ignore pattern. Outside a git repository, or when git cannot run, nothing counts as ignored and only the named directories are pruned. A generated directory that the repo's `.gitignore` already covers therefore does not need an entry in either list.
 
-Expect the first run to fail in a repo that has never gated this. Vitest 4 excludes only `node_modules` and `.git` by default, so a `__tests__` tree under a generated or vendored directory that git tracks is collected and runs today; naming that directory in both lists is the fix, rather than widening what nmr prunes for everyone.
+Expect the first run to fail in a repo that has never gated this. Vitest excludes only `node_modules` and `.git` by default, so a `__tests__` tree under a generated or vendored directory that git tracks is collected and runs today; naming that directory in both lists is the fix, rather than widening what nmr prunes for everyone.
 
 In a repo that has not declared the check, [nmr's readyup kit](../README.md#conformance-checks) reports both halves and warns that the check is missing. Once a test file under `__tests__` imports it, the kit skips both reports and names that file as the reason. Only the check reads the repo's `excludedBasenames`, and a kit report beside it could only repeat its findings or name a directory that the repo has pruned.
 
@@ -157,7 +159,7 @@ It folds across layers like the other two, the last layer to declare it winning.
 
 **It is an opt-in because its silent direction is the reverse of the two defaults'.** Leaving it off fails loudly, with an unresolved import naming the specifier. Turning it on is the silent direction, for a repo that declares `paths` for `tsc` alone: A specifier that resolved through a package's `exports` starts resolving through the alias instead, and nothing in the run reports the switch. A repo that does not declare `paths` is unaffected either way.
 
-**It requires Vite 8**, the version that introduced `resolve.tsconfigPaths`. nmr declares `vite` as an optional peer at `>=8.0.0 <9`, so a repo that declares a stale `vite` of its own sees a warning at install time. That check does not apply to a repo whose only Vite comes in through Vitest's own dependency, and Vitest 4 accepts Vite 6 and 7: On those, the emitted key does nothing and the aliased import fails exactly as it would with the flag off.
+**It requires Vite 8**, the version that introduced `resolve.tsconfigPaths`. nmr declares `vite` as an optional peer at `>=8.0.0 <9`, so a repo that declares a stale `vite` of its own sees a warning at install time. That check does not apply to a repo that does not declare `vite` itself, whose Vite is the one that Vitest brings in: a dependency under Vitest 4 and an auto-installed peer under Vitest 5. Both majors accept Vite 6 and 7: On those, the emitted key does nothing and the aliased import fails exactly as it would with the flag off.
 
 ## Customizing by scope
 
@@ -215,7 +217,7 @@ Both factories fold any number of layers left to right: A later layer wins on a
 
 Order matters for `setupFiles`, because a shared setup file establishes the environment in which the package's own then runs. A later layer's `project` block likewise wins over an earlier layer's `tiers` target: The nearer config is the more deliberate.
 
-**A package's own `vite.config.ts` also counts as that one config.** Vitest searches for a config by ascending from the run root and stopping at the first directory containing any of `vitest.config.*` or `vite.config.*`, so a package with only a Vite config ends the search there and never reaches the root config. Within a directory `vitest.config.*` is tried first, which makes the fix a Vitest config beside the Vite one, calling `defineVitestConfig()` as any other package config does. Without it the package does not declare any projects, and every tier-selecting command fails with `No projects matched the filter`, `nmr ci` among them. [nmr's readyup kit](../README.md#conformance-checks) reports a package in that state.
+**A package's own `vite.config.ts` also counts as that one config.** Vitest loads a `vitest.config.*` or `vite.config.*` that it finds in the run root, and [`nmr-vitest`](utilities.md#nmr-vitest) names the root config only for a package that does not contain either, so a package with only a Vite config never reaches the root config. Within a directory `vitest.config.*` is tried first, which makes the fix a Vitest config beside the Vite one, calling `defineVitestConfig()` as any other package config does. Without it the package does not declare any projects, and every tier-selecting command fails with `No projects matched the filter`, `nmr ci` among them. [nmr's readyup kit](../README.md#conformance-checks) reports a package in that state.
 
 **A path in a shared layer must be absolute.** Vitest resolves `setupFiles` against each project's own root, not against the module that declared the path, so a bare `'./vitest.setup.ts'` in a shared module names a different file in every package that consumes it -- and a package that happens to own a file by that name loads the wrong one instead of failing. The co-located form stays correct in a config file that declares the path directly.
 
@@ -249,7 +251,7 @@ The collection exclusions do not name fixtures, and that asymmetry is intentiona
 
 ## Root-scoped tests
 
-A monorepo's own root-level tests need a second config, because the package config is found by walking up from a package directory:
+A monorepo's own root-level tests need a second config, because [`nmr-vitest`](utilities.md#nmr-vitest) passes the root's `vitest.config.*` to every package that does not have a config of its own, and that config covers packages:
 
 ```ts
 // vitest.root.config.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@williamthorsen/nmr",
-  "version": "0.50.0",
+  "version": "0.51.0",
   "private": false,
   "description": "Context-aware script runner for pnpm monorepos",
   "keywords": [
@@ -63,7 +63,8 @@
     "nmr-fmt": "bin/nmr-fmt.js",
     "nmr-report-catalog": "bin/nmr-report-catalog.js",
     "nmr-report-overrides": "bin/nmr-report-overrides.js",
-    "nmr-taze": "bin/nmr-taze.js"
+    "nmr-taze": "bin/nmr-taze.js",
+    "nmr-vitest": "bin/nmr-vitest.js"
   },
   "files": [
     ".meta/changelog.json",
@@ -77,9 +78,9 @@
     "!docs/*.v*.md"
   ],
   "dependencies": {
-    "@williamthorsen/nmr-core": "0.13.5",
-    "@williamthorsen/toolbelt.errors": "0.8.3",
-    "@williamthorsen/toolbelt.filesystem": "0.9.3",
+    "@williamthorsen/nmr-core": "0.13.6",
+    "@williamthorsen/toolbelt.errors": "0.8.4",
+    "@williamthorsen/toolbelt.filesystem": "0.9.4",
     "glob": "13.0.6",
     "prettier": "3.9.10",
     "prettier-plugin-sh": "0.20.2",
@@ -87,20 +88,20 @@
     "unconfig": "7.5.0"
   },
   "devDependencies": {
-    "@williamthorsen/toolbelt.testing": "0.6.3",
-    "@williamthorsen/toolbelt.vitest": "0.10.3",
+    "@williamthorsen/toolbelt.testing": "0.7.0",
+    "@williamthorsen/toolbelt.vitest": "0.12.0",
     "esbuild": "0.28.2",
-    "readyup": "0.42.0",
+    "readyup": "0.43.0",
     "tinyglobby": "0.2.17",
     "typescript": "6.0.3",
     "vite": "8.3.4",
-    "vitest": "4.1.11",
+    "vitest": "5.0.5",
     "yaml": "2.9.1"
   },
   "peerDependencies": {
     "typescript": ">=5.7.0 <7",
     "vite": ">=8.0.0 <9",
-    "vitest": ">=4.0.0 <5"
+    "vitest": ">=4.0.0 <6"
   },
   "peerDependenciesMeta": {
     "typescript": {