@williamthorsen/nmr 2.0.0 → 2.0.2

package/.meta/changelog.json

@@ -1,4 +1,168 @@
 [
+  {
+    "version": "2.0.2",
+    "date": "2026-11-12",
+    "sections": [
+      {
+        "title": "🐛 Bug fixes",
+        "audience": "all",
+        "items": [
+          {
+            "description": "Fixes the issue that `nmr-fmt` and `nmr-taze` exited with 1 when a signal ended Prettier or taze, and makes each exit with 128 plus the signal number, as the other commands that nmr runs already did. (#1281)",
+            "hash": "9999694c843db32f1fc2851617402b61794abd3d",
+            "entry": 1
+          },
+          {
+            "description": "Fixes the issue that `nmr-fmt` formatted with nmr's own copy of Prettier when the repository's copy had a malformed or unreadable manifest, and makes `nmr-fmt` fail with an error that names that manifest instead. (#1282)",
+            "hash": "73319582559a85130ba65e810483acb24954e0ac",
+            "entry": 1
+          },
+          {
+            "description": "Fixes the issue that `nmr-vitest` reported a Vitest whose manifest is malformed or unreadable as not installed, and makes `nmr-vitest` name that manifest and the repair instead. (#1282)",
+            "hash": "73319582559a85130ba65e810483acb24954e0ac",
+            "entry": 2
+          },
+          {
+            "description": "Fixes the issue that `nmr-fmt` and `nmr-vitest` crashed on a Prettier or Vitest manifest that starts with a byte-order mark, which Node accepts. (#1282)",
+            "hash": "73319582559a85130ba65e810483acb24954e0ac",
+            "entry": 3
+          },
+          {
+            "description": "Fixes the issue that a `.config/nmr.config.ts` or `~/.config/nmr/config.ts` that failed to parse or threw while loading crashed `nmr` with an internal error that did not name the file, and makes `nmr` report an error that names the config and, for a syntax error, the file and line that Node reports, including those of a module that the config imports. (#1296)",
+            "hash": "3d120c5ce21b5cae276030dee7db1b63514fbe29",
+            "entry": 1
+          },
+          {
+            "description": "Fixes the issue that `nmr` read any value of `NMR_DEBUG`, `NMR_NO_CACHE`, `NMR_NO_LOCK`, or `NMR_RUN_IF_PRESENT` other than `1`, such as `true`, as off without reporting it, by making `nmr` and `nmr-fmt` exit 2 with a message that names the variable and the values that it accepts. (#1297)",
+            "migration": "Set each of these variables to `1` to turn it on, and to `0` or an empty value, or leave it unset, to turn it off. Any other value now stops the run with exit 2 before a command runs.",
+            "hash": "3a396f8788b37d60546eebf5b4c33859064314c6",
+            "entry": 1
+          },
+          {
+            "description": "Fixes the issue that `nmr upgrade --write` rewrote the `nodejs` pin in `.tool-versions` to a release that asdf could not install yet, by limiting the check to releases that node-build defines and reporting a newer release without a definition as held back. (#1300)",
+            "hash": "d97eab803118bb0055b9acd781f928c4ec548a55",
+            "entry": 1
+          }
+        ]
+      },
+      {
+        "title": "♻️ Refactoring",
+        "audience": "dev",
+        "items": [
+          {
+            "description": "Replaces the copies of the inherited-stdio spawn and exit-code mapping in `nmr-actionlint`, `nmr-shellcheck`, and `nmr-vitest` with the shared `spawnInherited` and `resolveInheritedExitCode` in `spawn-inherited.ts`, so that the copies can no longer change independently. (#1281)",
+            "hash": "9999694c843db32f1fc2851617402b61794abd3d",
+            "entry": 2
+          },
+          {
+            "description": "Replaces the separate `bin` parsing in `resolveVitestCli` and `resolvePrettierCli` with one `resolveDeclaredCli` in `package-manifest.ts`, which takes `bin` either as a bare path or as a map keyed by the package name, so `nmr-vitest` now also accepts a Vitest manifest whose `bin` is a bare path. (#1283)",
+            "hash": "31ebafea1ceb209f1f8993520f90f10cb87bf88d",
+            "entry": 1
+          },
+          {
+            "description": "Groups nmr's check-cache modules under `packages/nmr/src/check-cache/` and its delegation modules under `packages/nmr/src/delegation/`, each directory containing its own tests in `__tests__/`. (#1293)",
+            "hash": "91f900f679d4e84687e1ba74ece7d42bf089abc3",
+            "entry": 1
+          },
+          {
+            "description": "Makes `runCli` accept `runSteps` and `readFilterSelection` as optional dependencies that default to the real functions, and passes them on the `Invocation` to fan-out and the check-cache gate, which no longer import the real functions. (#1295)",
+            "hash": "40098138b5136fdb4c6824d03e1873ab15583693",
+            "entry": 1
+          }
+        ]
+      },
+      {
+        "title": "🧪 Tests",
+        "audience": "dev",
+        "items": [
+          {
+            "description": "Adds `createRunCliHarness` and a shared `it` in `test-utils/run-cli-fixtures.ts` that gives each test a workspace `tree` and fresh fakes, and moves the five `runCli` unit suites onto them, so that the suites no longer depend on the file layout of the modules that they used to mock. (#1295)",
+            "hash": "40098138b5136fdb4c6824d03e1873ab15583693",
+            "entry": 2
+          },
+          {
+            "description": "Covers each decision branch of the check-cache gate with unit suites for lookup, recording, scope, and the command's own stated outcome, which inject a fake tree reader through a new `readTree` option on `runCli`, and removes the tool cases that they supersede, including `check-cache-gate.build-output.tool.test.ts`. (#1298)",
+            "hash": "2b3163471bc0adf4b70b8fe5b386e341241aaaae",
+            "entry": 1
+          }
+        ]
+      }
+    ]
+  },
+  {
+    "version": "2.0.1",
+    "date": "2026-11-11",
+    "sections": [
+      {
+        "title": "🐛 Bug fixes",
+        "audience": "all",
+        "items": [
+          {
+            "description": "Fixes the issue that `nmr-clean`, `nmr-compile`, `nmr-report-catalog`, and `nmr-report-overrides` ignored their arguments, so `--help` or a mistyped option ran the command, and `nmr-clean --help` removed build output instead of printing usage. (#1273)",
+            "hash": "a4bfd2bc9c298a919c15070bae4437188c0edb37",
+            "entry": 1
+          }
+        ]
+      },
+      {
+        "title": "♻️ Refactoring",
+        "audience": "dev",
+        "items": [
+          {
+            "description": "Adds an optional `spawn` adapter to `runPrettier` in `packages/nmr/src/commands/fmt.ts`, which defaults to `spawnSync` with inherited stdio, so that a test can replace the Prettier process without mocking `node:child_process`. (#1271)",
+            "hash": "18227bf9c7d8fb0fb11bf3382602be131603419a",
+            "entry": 1
+          },
+          {
+            "description": "Extracts the unchanged-build skip report from `detectBuildChanges` into the exported `reportUnchangedBuild`, which takes the environment as a parameter rather than reading `process.env`. (#1272)",
+            "hash": "7708c82fe5b528709dd3c822c1449b6a843292c4",
+            "entry": 1
+          },
+          {
+            "description": "Replaces the copies of the entry-point `glob` call in `buildPackage` and `hasBuildOutput` with one function, `resolveEntryPoints` in `build-output.ts`, so the build and the check cache's probe for build output cannot select different files. (#1274)",
+            "hash": "aadd160714f8a4b00aa9965897b97fb15ee8500b",
+            "entry": 1
+          },
+          {
+            "description": "Moves the printing of the build's progress and outcome lines from `buildPackage` to `nmr-compile`, which renders the `BuildOutcome` returned by `buildPackage` and the events from its new `onProgress` callback through `build-report.ts`. (#1277)",
+            "hash": "7204e9ebbb7ef2d60f0ddf74a1ea4de4b62e50c0",
+            "entry": 1
+          },
+          {
+            "description": "Moves the emit's staging, swap by rename, and scratch-directory handling from `build.ts` and `build-output.ts` into `publish-output.ts`, which `build.ts` now calls with the emit directory. (#1278)",
+            "hash": "27bc6915156ae739206679b977baf91267f73fa9",
+            "entry": 1
+          },
+          {
+            "description": "Makes `cleanFrom` in `clean.ts` return a `CleanOutcome` and report each completed step through an `onProgress` callback rather than print, leaving `runClean` as the only function that prints, through the renderers in the new `clean-report.ts`. (#1279)",
+            "hash": "5188dd2411cd737d337ae8bf232fc68d5bc911c6",
+            "entry": 1
+          }
+        ]
+      },
+      {
+        "title": "🧪 Tests",
+        "audience": "dev",
+        "items": [
+          {
+            "description": "Moves the `runPrettier` cases from `fmt.tool.test.ts` to a new `fmt.unit.test.ts` that asserts on the invocations recorded by a spawn fake, and adds cases for a spawn error and for a Prettier process killed by a signal. (#1271)",
+            "hash": "18227bf9c7d8fb0fb11bf3382602be131603419a",
+            "entry": 2
+          },
+          {
+            "description": "Replaces six skip-report cases in `build.publication.tool.test.ts`, each of which compiled a package to seed the cache, with unit tests of `reportUnchangedBuild` in `build.unit.test.ts` that write the recorded emit duration directly. (#1272)",
+            "hash": "7708c82fe5b528709dd3c822c1449b6a843292c4",
+            "entry": 2
+          },
+          {
+            "description": "Tests `resolveEntryPoints` directly in `build-output.unit.test.ts` and removes the tool-tier tests in `build.tool.test.ts` that checked the same default exclusions, `ignorePatterns` override, and `extraIgnorePatterns` composition through a full build. (#1274)",
+            "hash": "aadd160714f8a4b00aa9965897b97fb15ee8500b",
+            "entry": 2
+          }
+        ]
+      }
+    ]
+  },
   {
     "version": "2.0.0",
     "date": "2026-11-10",

package/.readyup/kits/default.js

@@ -1,6 +1,6 @@
 /** @noformat -- @generated. Do not edit. Compiled by rdy. */
 /* eslint-disable */
-export const __readyupVersion = "0.45.0";
+export const __readyupVersion = "0.45.1";
 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.9.0/node_modules/@williamthorsen/toolbelt.errors/dist/esm/4-release/isError.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.errors@0.9.1/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.9.0/node_modules/@williamthorsen/toolbelt.errors/dist/esm/4-release/describeError.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.errors@0.9.1/node_modules/@williamthorsen/toolbelt.errors/dist/esm/4-release/describeError.js
 function describeError(error) {
   try {
     if (isError(error) && typeof error.message === "string" && error.message !== "") {
@@ -8019,7 +8019,6 @@ import { isRecord as isRecord5 } from "readyup/check-utils";
 
 // src/config.ts
 import { existsSync as existsSync3 } from "node:fs";
-import { pathToFileURL } from "node:url";
 
 // src/helpers/findClosestName.ts
 function findClosestName(name, candidates) {
@@ -8162,11 +8161,11 @@ function formatMalformedScript(dir, key, value) {
   return `${rejection} A step list belongs in \`${CONFIG_RELATIVE_PATH}\` under \`${field}\`.`;
 }
 
-// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.0/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/parseArgs.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.1/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/parseArgs.js
 import path6 from "node:path";
 import process2 from "node:process";
 
-// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.0/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/UsageError.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.1/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/UsageError.js
 var UsageError = class extends Error {
   constructor(message, options) {
     super(message, options);
@@ -8174,7 +8173,7 @@ var UsageError = class extends Error {
   }
 };
 
-// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.0/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/ParseError.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.1/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/ParseError.js
 var ParseError = class extends UsageError {
   kind;
   token;
@@ -8186,12 +8185,12 @@ var ParseError = class extends UsageError {
   }
 };
 
-// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.0/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/resolveLongName.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.1/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/resolveLongName.js
 function resolveLongName(key, definition) {
   return definition.long ?? key.replaceAll(/[A-Z]/g, (capital) => `-${capital.toLowerCase()}`);
 }
 
-// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.0/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/tokenizeArgs.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.1/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/tokenizeArgs.js
 import { parseArgs as nodeParseArgs } from "node:util";
 function tokenizeArgs(argv, schema, extraBooleans = []) {
   const nodeOptions = {};
@@ -8221,7 +8220,7 @@ function findFlagEntry(flagsByName, token) {
   return entry.definition.short === token.rawName.slice(1) ? entry : void 0;
 }
 
-// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.0/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/validateSpec.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.1/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/validateSpec.js
 var CAMEL_CASE_KEY = /^[a-z][a-z0-9]*(?:[A-Z][a-z0-9]+)*$/;
 function validateSpec(spec) {
   validateFlags(spec.flags ?? {});
@@ -8302,7 +8301,7 @@ function validateOperands(operands) {
   }
 }
 
-// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.0/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/parseArgs.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.1/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/parseArgs.js
 function parseArgs(argv, spec, options = {}) {
   validateSpec(spec);
   return parseValidatedArgs(argv, spec, options);
@@ -8673,7 +8672,7 @@ function buildRootRegistry(config, monorepoRoot) {
   };
 }
 
-// src/config-check-cache.ts
+// src/check-cache/config-check-cache.ts
 function assertResolvableCheckCacheCommands(config, configPath, baseDir) {
   const { checkCache } = config;
   if (checkCache === void 0 || !isMonorepoRoot(baseDir)) {
@@ -8968,6 +8967,44 @@ function escapeControlCharacters(text) {
   return escapedText;
 }
 
+// src/helpers/importConfigDefault.ts
+import { realpathSync } from "node:fs";
+import { pathToFileURL } from "node:url";
+async function importConfigDefault(configPath) {
+  let importedModule;
+  try {
+    importedModule = await import(pathToFileURL(configPath).href);
+  } catch (error) {
+    const location = readSyntaxErrorLocation(error);
+    const isInConfig = location !== void 0 && isConfigFile(location.file, configPath);
+    const configLocation = isInConfig ? `${configPath}:${location.line}` : configPath;
+    const foreignLocation = location === void 0 || isInConfig ? "" : `${location.file}:${location.line}: `;
+    throw new UserError(
+      `Cannot load nmr config at ${configLocation}: ${foreignLocation}${describeError(error)}. Fix the file and rerun.`,
+      { cause: error }
+    );
+  }
+  return isRecord2(importedModule) ? importedModule["default"] : void 0;
+}
+function isConfigFile(file, configPath) {
+  return file === configPath || file === resolveRealPath(configPath);
+}
+function readSyntaxErrorLocation(error) {
+  if (!isError(error) || error.stack === void 0) {
+    return void 0;
+  }
+  const match = /^(?<file>.+):(?<line>\d+)$/u.exec(error.stack.split("\n", 1)[0] ?? "");
+  const { file, line } = match?.groups ?? {};
+  return file === void 0 || line === void 0 ? void 0 : { file, line };
+}
+function resolveRealPath(filePath) {
+  try {
+    return realpathSync(filePath);
+  } catch {
+    return void 0;
+  }
+}
+
 // src/config.ts
 var SCRIPT_FIELDS = [
   { field: "rootScripts", scope: "root" },
@@ -8978,8 +9015,7 @@ async function loadConfig(baseDir) {
   if (!existsSync3(configPath)) {
     return {};
   }
-  const importedModule = await import(pathToFileURL(configPath).href);
-  const loadedConfig = isRecord2(importedModule) ? importedModule["default"] : void 0;
+  const loadedConfig = await importConfigDefault(configPath);
   return validateConfig(loadedConfig, configPath, baseDir);
 }
 async function loadRootConfig(monorepoRoot) {
@@ -9595,7 +9631,7 @@ function hasSupportedStrictLintVersion() {
   });
 }
 function getMinVersion() {
-  const pickedFields = { "version": "2.0.0" };
+  const pickedFields = { "version": "2.0.2" };
   if (typeof pickedFields["version"] !== "string") {
     throw new TypeError("nmr/package.json: 'version' must be a string");
   }

package/.readyup/manifest.json

@@ -3,19 +3,19 @@
   "kits": [
     {
       "bundledDependencies": {
-        "@williamthorsen/toolbelt.arrays": "6.4.1",
-        "@williamthorsen/toolbelt.cli": "0.8.0",
-        "@williamthorsen/toolbelt.datetime": "4.1.1",
-        "@williamthorsen/toolbelt.errors": "0.9.0",
-        "@williamthorsen/toolbelt.filesystem": "0.10.0",
-        "@williamthorsen/toolbelt.guards": "4.2.0",
-        "@williamthorsen/toolbelt.numbers": "7.3.1",
-        "@williamthorsen/toolbelt.objects": "4.4.0",
-        "@williamthorsen/toolbelt.packaging": "0.7.0",
+        "@williamthorsen/toolbelt.arrays": "6.4.2",
+        "@williamthorsen/toolbelt.cli": "0.8.1",
+        "@williamthorsen/toolbelt.datetime": "4.1.2",
+        "@williamthorsen/toolbelt.errors": "0.9.1",
+        "@williamthorsen/toolbelt.filesystem": "0.10.1",
+        "@williamthorsen/toolbelt.guards": "4.2.1",
+        "@williamthorsen/toolbelt.numbers": "7.3.2",
+        "@williamthorsen/toolbelt.objects": "4.4.1",
+        "@williamthorsen/toolbelt.packaging": "0.7.1",
         "@williamthorsen/toolbelt.sets": "3.1.0",
-        "@williamthorsen/toolbelt.strings": "8.2.1",
+        "@williamthorsen/toolbelt.strings": "8.2.2",
         "@williamthorsen/toolbelt.terminal": "0.3.0",
-        "ansi-regex": "6.5.0",
+        "ansi-regex": "6.6.0",
         "ansi-styles": "6.2.3",
         "cli-truncate": "6.1.1",
         "diff": "9.0.0",
@@ -32,7 +32,7 @@
           "checklist": "nmr",
           "checks": [
             "@williamthorsen/nmr in devDependencies",
-            "@williamthorsen/nmr >= 2.0.0",
+            "@williamthorsen/nmr >= 2.0.2",
             "pnpm-workspace.yaml exists",
             "catalogued dependencies use catalog:",
             "package.json has packageManager field",
@@ -236,7 +236,7 @@
           "path": "lib/workspace-build.ts"
         },
         {
-          "hash": "6933f29e",
+          "hash": "cf90a835",
           "kind": "inline",
           "path": "../package.json",
           "paths": [
@@ -244,22 +244,22 @@
           ]
         },
         {
-          "hash": "eb0306ed",
+          "hash": "a34d9027",
           "kind": "module",
-          "path": "../src/commands/ensure-prepublish-hooks.ts"
+          "path": "../src/check-cache/config-check-cache.ts"
         },
         {
-          "hash": "578af9fd",
+          "hash": "eb0306ed",
           "kind": "module",
-          "path": "../src/config-check-cache.ts"
+          "path": "../src/commands/ensure-prepublish-hooks.ts"
         },
         {
-          "hash": "d25aef4f",
+          "hash": "0555552a",
           "kind": "module",
           "path": "../src/config-validation.ts"
         },
         {
-          "hash": "d345a285",
+          "hash": "f5e9e2fd",
           "kind": "module",
           "path": "../src/config.ts"
         },
@@ -293,6 +293,11 @@
           "kind": "module",
           "path": "../src/helpers/hook-name.ts"
         },
+        {
+          "hash": "d6455b2e",
+          "kind": "module",
+          "path": "../src/helpers/importConfigDefault.ts"
+        },
         {
           "hash": "62caa37e",
           "kind": "module",
@@ -356,10 +361,10 @@
       ],
       "name": "default",
       "path": "kits/default.js",
-      "readyupVersion": "0.45.0",
+      "readyupVersion": "0.45.1",
       "source": "kits/default.ts",
       "sourceHash": "9fd61bf4",
-      "targetHash": "7ddb0518"
+      "targetHash": "9895b0df"
     }
   ]
 }

package/CHANGELOG.md

@@ -2,6 +2,51 @@
 
 All notable changes to this project will be documented in this file.
 
+## 2.0.2 — 2026-11-12
+
+### 🐛 Bug fixes
+
+- Fixes the issue that `nmr-fmt` and `nmr-taze` exited with 1 when a signal ended Prettier or taze, and makes each exit with 128 plus the signal number, as the other commands that nmr runs already did. (#1281)
+- Fixes the issue that `nmr-fmt` formatted with nmr's own copy of Prettier when the repository's copy had a malformed or unreadable manifest, and makes `nmr-fmt` fail with an error that names that manifest instead. (#1282)
+- Fixes the issue that `nmr-vitest` reported a Vitest whose manifest is malformed or unreadable as not installed, and makes `nmr-vitest` name that manifest and the repair instead. (#1282)
+- Fixes the issue that `nmr-fmt` and `nmr-vitest` crashed on a Prettier or Vitest manifest that starts with a byte-order mark, which Node accepts. (#1282)
+- Fixes the issue that a `.config/nmr.config.ts` or `~/.config/nmr/config.ts` that failed to parse or threw while loading crashed `nmr` with an internal error that did not name the file, and makes `nmr` report an error that names the config and, for a syntax error, the file and line that Node reports, including those of a module that the config imports. (#1296)
+- Fixes the issue that `nmr` read any value of `NMR_DEBUG`, `NMR_NO_CACHE`, `NMR_NO_LOCK`, or `NMR_RUN_IF_PRESENT` other than `1`, such as `true`, as off without reporting it, by making `nmr` and `nmr-fmt` exit 2 with a message that names the variable and the values that it accepts. (#1297)
+- Fixes the issue that `nmr upgrade --write` rewrote the `nodejs` pin in `.tool-versions` to a release that asdf could not install yet, by limiting the check to releases that node-build defines and reporting a newer release without a definition as held back. (#1300)
+
+### ♻️ Refactoring
+
+- Replaces the copies of the inherited-stdio spawn and exit-code mapping in `nmr-actionlint`, `nmr-shellcheck`, and `nmr-vitest` with the shared `spawnInherited` and `resolveInheritedExitCode` in `spawn-inherited.ts`, so that the copies can no longer change independently. (#1281)
+- Replaces the separate `bin` parsing in `resolveVitestCli` and `resolvePrettierCli` with one `resolveDeclaredCli` in `package-manifest.ts`, which takes `bin` either as a bare path or as a map keyed by the package name, so `nmr-vitest` now also accepts a Vitest manifest whose `bin` is a bare path. (#1283)
+- Groups nmr's check-cache modules under `packages/nmr/src/check-cache/` and its delegation modules under `packages/nmr/src/delegation/`, each directory containing its own tests in `__tests__/`. (#1293)
+- Makes `runCli` accept `runSteps` and `readFilterSelection` as optional dependencies that default to the real functions, and passes them on the `Invocation` to fan-out and the check-cache gate, which no longer import the real functions. (#1295)
+
+### 🧪 Tests
+
+- Adds `createRunCliHarness` and a shared `it` in `test-utils/run-cli-fixtures.ts` that gives each test a workspace `tree` and fresh fakes, and moves the five `runCli` unit suites onto them, so that the suites no longer depend on the file layout of the modules that they used to mock. (#1295)
+- Covers each decision branch of the check-cache gate with unit suites for lookup, recording, scope, and the command's own stated outcome, which inject a fake tree reader through a new `readTree` option on `runCli`, and removes the tool cases that they supersede, including `check-cache-gate.build-output.tool.test.ts`. (#1298)
+
+## 2.0.1 — 2026-11-11
+
+### 🐛 Bug fixes
+
+- Fixes the issue that `nmr-clean`, `nmr-compile`, `nmr-report-catalog`, and `nmr-report-overrides` ignored their arguments, so `--help` or a mistyped option ran the command, and `nmr-clean --help` removed build output instead of printing usage. (#1273)
+
+### ♻️ Refactoring
+
+- Adds an optional `spawn` adapter to `runPrettier` in `packages/nmr/src/commands/fmt.ts`, which defaults to `spawnSync` with inherited stdio, so that a test can replace the Prettier process without mocking `node:child_process`. (#1271)
+- Extracts the unchanged-build skip report from `detectBuildChanges` into the exported `reportUnchangedBuild`, which takes the environment as a parameter rather than reading `process.env`. (#1272)
+- Replaces the copies of the entry-point `glob` call in `buildPackage` and `hasBuildOutput` with one function, `resolveEntryPoints` in `build-output.ts`, so the build and the check cache's probe for build output cannot select different files. (#1274)
+- Moves the printing of the build's progress and outcome lines from `buildPackage` to `nmr-compile`, which renders the `BuildOutcome` returned by `buildPackage` and the events from its new `onProgress` callback through `build-report.ts`. (#1277)
+- Moves the emit's staging, swap by rename, and scratch-directory handling from `build.ts` and `build-output.ts` into `publish-output.ts`, which `build.ts` now calls with the emit directory. (#1278)
+- Makes `cleanFrom` in `clean.ts` return a `CleanOutcome` and report each completed step through an `onProgress` callback rather than print, leaving `runClean` as the only function that prints, through the renderers in the new `clean-report.ts`. (#1279)
+
+### 🧪 Tests
+
+- Moves the `runPrettier` cases from `fmt.tool.test.ts` to a new `fmt.unit.test.ts` that asserts on the invocations recorded by a spawn fake, and adds cases for a spawn error and for a Prettier process killed by a signal. (#1271)
+- Replaces six skip-report cases in `build.publication.tool.test.ts`, each of which compiled a package to seed the cache, with unit tests of `reportUnchangedBuild` in `build.unit.test.ts` that write the recorded emit duration directly. (#1272)
+- Tests `resolveEntryPoints` directly in `build-output.unit.test.ts` and removes the tool-tier tests in `build.tool.test.ts` that checked the same default exclusions, `ignorePatterns` override, and `extraIgnorePatterns` composition through a full build. (#1274)
+
 ## 2.0.0 — 2026-11-10
 
 ### 🪦 Removed

package/README.md

@@ -5,11 +5,17 @@
 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 — v2.0.0 (2026-11-10)
+## Release notes — v2.0.2 (2026-11-12)
 
-### 🪦 Removed
+### 🐛 Bug fixes
 
-- 🚨 **Breaking:** Removes the `devBin` root-config field of `@williamthorsen/nmr`, which replaced the first token of a resolved command with a command that ran a bin from source. (#1269)
+- Fixes the issue that `nmr-fmt` and `nmr-taze` exited with 1 when a signal ended Prettier or taze, and makes each exit with 128 plus the signal number, as the other commands that nmr runs already did. (#1281)
+- Fixes the issue that `nmr-fmt` formatted with nmr's own copy of Prettier when the repository's copy had a malformed or unreadable manifest, and makes `nmr-fmt` fail with an error that names that manifest instead. (#1282)
+- Fixes the issue that `nmr-vitest` reported a Vitest whose manifest is malformed or unreadable as not installed, and makes `nmr-vitest` name that manifest and the repair instead. (#1282)
+- Fixes the issue that `nmr-fmt` and `nmr-vitest` crashed on a Prettier or Vitest manifest that starts with a byte-order mark, which Node accepts. (#1282)
+- Fixes the issue that a `.config/nmr.config.ts` or `~/.config/nmr/config.ts` that failed to parse or threw while loading crashed `nmr` with an internal error that did not name the file, and makes `nmr` report an error that names the config and, for a syntax error, the file and line that Node reports, including those of a module that the config imports. (#1296)
+- Fixes the issue that `nmr` read any value of `NMR_DEBUG`, `NMR_NO_CACHE`, `NMR_NO_LOCK`, or `NMR_RUN_IF_PRESENT` other than `1`, such as `true`, as off without reporting it, by making `nmr` and `nmr-fmt` exit 2 with a message that names the variable and the values that it accepts. (#1297)
+- Fixes the issue that `nmr upgrade --write` rewrote the `nodejs` pin in `.tool-versions` to a release that asdf could not install yet, by limiting the check to releases that node-build defines and reporting a newer release without a definition as held back. (#1300)
 <!-- /section:release-notes -->
 
 ## Installation
@@ -189,7 +195,7 @@ $ nmr check
 nmr: waiting for test in /Users/me/repos/other-repo (pid 41872) to finish
 ```
 
-The lock lives in `/tmp/nmr-<uid>/`, or in `NMR_LOCK_DIR`; a sandboxed session needs write access to it. `nmr --no-lock <command>` or `NMR_NO_LOCK=1` runs without waiting. [Machine lock](docs/machine-lock.md) covers which commands take it, nesting and fan-outs, reclaiming a lock that its holder left behind, and CI.
+The lock lives in `/tmp/nmr-<uid>/`, or in `NMR_LOCK_DIR`; a sandboxed session needs write access to it. `nmr --no-lock <command>` or `NMR_NO_LOCK=1` runs without waiting; [environment switches](docs/scripts.md#environment-switches) lists the values that the variable accepts. [Machine lock](docs/machine-lock.md) covers which commands take it, nesting and fan-outs, reclaiming a lock that its holder left behind, and CI.
 
 ## Delegating to another machine
 

package/dist/esm/{check-cache-build-output.d.ts → check-cache/check-cache-build-output.d.ts}

@@ -1,4 +1,4 @@
-import type { NmrConfig } from './types.js';
+import type { NmrConfig } from '../types.js';
 /** What nmr's own build has left on disk across the workspace. */
 export interface BuildOutputState {
     /** Covered packages whose output is absent. */

package/dist/esm/{check-cache-build-output.js → check-cache/check-cache-build-output.js}

@@ -1,10 +1,10 @@
 import path from 'node:path';
-import { hasBuildOutput, readBuildDigest } from "./commands/build-output.js";
-import { loadWorkspaceConfig } from "./config.js";
-import { getDefaultWorkspaceScripts } from "./resolve-scripts.js";
-import { buildWorkspaceRegistry, resolveScript } from "./resolver.js";
-import { renderChain } from "./steps.js";
-import { getWorkspacePackageDirs } from "./workspace.js";
+import { hasBuildOutput, readBuildDigest } from "../commands/build-output.js";
+import { loadWorkspaceConfig } from "../config.js";
+import { getDefaultWorkspaceScripts } from "../resolve-scripts.js";
+import { buildWorkspaceRegistry, resolveScript } from "../resolver.js";
+import { renderChain } from "../steps.js";
+import { getWorkspacePackageDirs } from "../workspace.js";
 const BUILT_IN_COMPILE = 'nmr-compile';
 export function findStaleBuildOutput(earlierDigests, laterDigests) {
     const names = [...new Set([...Object.keys(earlierDigests), ...Object.keys(laterDigests)])].toSorted();

package/dist/esm/{check-cache-delegation.d.ts → check-cache/check-cache-delegation.d.ts}

@@ -1,8 +1,8 @@
+import type { HostRunResult } from '../delegation/delegate-host.js';
+import { type RunPlan } from '../invocation.js';
+import type { OutputChannels } from '../output-channel.js';
 import { type TreeSnapshot } from './check-cache.js';
 import type { BuildOutputState } from './check-cache-build-output.js';
-import type { HostRunResult } from './delegate-host.js';
-import { type RunPlan } from './invocation.js';
-import type { OutputChannels } from './output-channel.js';
 /** What the check-result cache gates a run on: the key, the tree, and the build output that the run saw. */
 export interface Gate {
     buildOutputBefore: BuildOutputState;

package/dist/esm/{check-cache-delegation.js → check-cache/check-cache-delegation.js}

@@ -1,8 +1,8 @@
 import path from 'node:path';
+import { VERSION } from "../invocation.js";
 import { resolveTreeSnapshot, writeDebugNote } from "./check-cache.js";
 import { computeCacheKey, computeRetentionKey } from "./check-cache-key.js";
 import { recordHostPass } from "./check-cache-record.js";
-import { VERSION } from "./invocation.js";
 import { formatManifestScope, validatePassManifest } from "./pass-manifest.js";
 export async function recordDelegatedPass(plan, gate, hostRun) {
     const { anchorDir, command, context, env, stderr } = plan.invocation;
@@ -11,7 +11,7 @@ export async function recordDelegatedPass(plan, gate, hostRun) {
         writeDebugNote(`not recording ${command}: the pushed tree is not the tree that the gate keyed on`, env, stderr);
         return;
     }
-    const currentRead = resolveTreeSnapshot({ monorepoRoot, env: {} });
+    const currentRead = resolveTreeSnapshot({ monorepoRoot, env: {}, readTree: plan.invocation.readTree });
     if (!currentRead.ok) {
         writeDebugNote(`not recording ${command}: ${currentRead.reason}`, env, stderr);
         return;

package/dist/esm/{check-cache-entries.js → check-cache/check-cache-entries.js}

@@ -1,8 +1,8 @@
 import path from 'node:path';
 import { isRecord, readCacheEntry, readJsonCacheEntry, removeCacheDir, removeCacheEntry, resolveCacheEntryPath, writeCacheEntry, } from '@williamthorsen/nmr-core';
 import { describeError } from '@williamthorsen/toolbelt.errors';
+import { isStringRecord } from "../helpers/type-guards.js";
 import { writeDebugNote } from "./check-cache.js";
-import { isStringRecord } from "./helpers/type-guards.js";
 const CACHE_TOOL = 'nmr-check';
 const UNSAFE_SLUG_CHARACTERS = /[^\w.-]+/g;
 export async function certifyRetention(options) {

package/dist/esm/{check-cache-gate.d.ts → check-cache/check-cache-gate.d.ts}

@@ -1,9 +1,9 @@
 import type { Writable } from 'node:stream';
 import { type OutputStyle } from '@williamthorsen/nmr-core';
-import { type TreeSnapshot } from './check-cache.js';
-import { type RunPlan } from './invocation.js';
-import type { NmrConfig } from './types.js';
-import type { VerdictOutcome } from './verdict.js';
+import { type RunPlan } from '../invocation.js';
+import type { NmrConfig } from '../types.js';
+import type { VerdictOutcome } from '../verdict.js';
+import { type TreeReader, type TreeSnapshot } from './check-cache.js';
 /**
  * Decides whether the check-result cache covers this invocation, and takes the tree snapshot on which it would
  * gate.
@@ -20,6 +20,7 @@ export declare function openGate(options: {
     env: NodeJS.ProcessEnv;
     monorepoRoot: string;
     passthrough: string[];
+    readTree: TreeReader;
     stderr: Writable;
     style: OutputStyle;
 }): TreeSnapshot | undefined;