@williamthorsen/nmr 2.0.3 → 2.1.0

package/.meta/changelog.json

@@ -1,4 +1,59 @@
 [
+  {
+    "version": "2.1.0",
+    "date": "2026-11-12",
+    "sections": [
+      {
+        "title": "🎉 Features",
+        "audience": "all",
+        "items": [
+          {
+            "description": "Adds the `fanOut.extraSortedCommands` root-config key, which lists commands besides `build` whose fan-out keeps the topological order, and nmr rejects a name in it that does not resolve to any command when it loads the config. (#1306)",
+            "hash": "01a2cf5ec7b3a64da280a9053c1d608e8594e3f8",
+            "entry": 2
+          }
+        ]
+      },
+      {
+        "title": "⚡ Performance",
+        "audience": "all",
+        "items": [
+          {
+            "description": "Drops pnpm's topological sort, which runs each package only after its workspace dependencies finish, from every `-R` and `-F` fan-out except one of `build`, so that `nmr test`, the `test:*` commands, and `nmr typecheck` start each package without waiting for its workspace dependencies. (#1306)",
+            "hash": "01a2cf5ec7b3a64da280a9053c1d608e8594e3f8",
+            "entry": 1
+          }
+        ]
+      },
+      {
+        "title": "♻️ Refactoring",
+        "audience": "dev",
+        "items": [
+          {
+            "description": "Renames each single-export module in `packages/nmr/src` after its main export, such as `bin-path.ts` to `prependBinDirs.ts`, and renames the test files that matched the old names. (#1303)",
+            "hash": "5e1b404c4aa76defaf9d3921b3b88d7266a57297",
+            "entry": 1
+          },
+          {
+            "description": "Stops exporting seven values from `nmr`'s source modules, among them `REPORT_FORMATS`, `COMMAND_VERBOSITIES`, and the machine lock's `POLL_INTERVAL_MS`, because only the module that defines each one reads it. (#1305)",
+            "hash": "fa7addca5299b46f5e8a40663cae8e8c56b4547d",
+            "entry": 1
+          }
+        ]
+      },
+      {
+        "title": "🧪 Tests",
+        "audience": "dev",
+        "items": [
+          {
+            "description": "Replaces the hand-copied git setup in the nmr tool tests and fixtures, and the local `initRepo` that shadowed the shared helper in `check-cache.tool.test.ts`, with calls to `test-utils/initRepo.ts`. (#1304)",
+            "hash": "20121aef0112f24b64880b68675d6cdcea6066a0",
+            "entry": 1
+          }
+        ]
+      }
+    ]
+  },
   {
     "version": "2.0.3",
     "date": "2026-11-12",

package/.readyup/kits/default.js

@@ -1,6 +1,6 @@
 /** @noformat -- @generated. Do not edit. Compiled by rdy. */
 /* eslint-disable */
-export const __readyupVersion = "0.45.1";
+export const __readyupVersion = "0.46.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.1/node_modules/@williamthorsen/toolbelt.errors/dist/esm/4-release/isError.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.errors@0.10.0/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.1/node_modules/@williamthorsen/toolbelt.errors/dist/esm/4-release/describeError.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.errors@0.10.0/node_modules/@williamthorsen/toolbelt.errors/dist/esm/4-release/describeError.js
 function describeError(error) {
   try {
     if (isError(error) && typeof error.message === "string" && error.message !== "") {
@@ -7725,9 +7725,15 @@ function buildRootScripts(workspaceGlobs) {
   };
 }
 
+// src/toWorkspacePackageGlobs.ts
+import path from "node:path";
+function toWorkspacePackageGlobs(monorepoRoot, packageDirs) {
+  return packageDirs.map((dir) => path.relative(monorepoRoot, dir).split(path.sep).join("/")).filter((relativeDir) => relativeDir !== "").map((relativeDir) => `${relativeDir}/**`).toSorted();
+}
+
 // ../nmr-core/dist/esm/workspace/workspace.js
 import { existsSync, readFileSync } from "node:fs";
-import path2 from "node:path";
+import path3 from "node:path";
 var import_yaml = __toESM(require_dist(), 1);
 
 // ../nmr-core/dist/esm/portable/isRecord.js
@@ -7737,7 +7743,7 @@ function isRecord2(value) {
 
 // ../nmr-core/dist/esm/workspace/workspace-patterns.js
 import { globSync as globSync2 } from "node:fs";
-import path from "node:path";
+import path2 from "node:path";
 var MANIFEST_FILENAME = "package.json";
 var ALWAYS_EXCLUDED_PATTERNS = ["**/node_modules/**"];
 function matchPackageDirs(monorepoRoot, includedPatterns, excludedPatterns) {
@@ -7747,7 +7753,7 @@ function matchPackageDirs(monorepoRoot, includedPatterns, excludedPatterns) {
     followSymlinks: true
   };
   const matches = globSync2([...includedPatterns], options);
-  const dirs = matches.map((match) => path.dirname(path.resolve(monorepoRoot, match)));
+  const dirs = matches.map((match) => path2.dirname(path2.resolve(monorepoRoot, match)));
   return [...new Set(dirs)].toSorted();
 }
 function resolvePackageDirs(monorepoRoot, patterns) {
@@ -7776,7 +7782,7 @@ function buildManifestPattern(pattern) {
 // ../nmr-core/dist/esm/workspace/workspace.js
 var WORKSPACE_MANIFEST_FILENAME = "pnpm-workspace.yaml";
 function isMonorepoRoot(dir) {
-  return existsSync(path2.join(dir, WORKSPACE_MANIFEST_FILENAME));
+  return existsSync(path3.join(dir, WORKSPACE_MANIFEST_FILENAME));
 }
 function resolveWorkspace(monorepoRoot) {
   const manifestReadResult = readWorkspaceManifest(monorepoRoot);
@@ -7821,7 +7827,7 @@ function readDeclaredPackages(parsedManifest) {
   return packages.length === 0 ? { kind: "absent" } : { kind: "patterns", patterns: packages };
 }
 function readWorkspaceManifest(monorepoRoot) {
-  const workspaceManifestPath = path2.join(monorepoRoot, WORKSPACE_MANIFEST_FILENAME);
+  const workspaceManifestPath = path3.join(monorepoRoot, WORKSPACE_MANIFEST_FILENAME);
   if (!existsSync(workspaceManifestPath)) {
     return { kind: "absent" };
   }
@@ -7881,12 +7887,6 @@ function getWorkspacePackageDirs(monorepoRoot) {
   return resolution.kind === "packages" ? resolution.packageDirs : [];
 }
 
-// src/workspace-globs.ts
-import path3 from "node:path";
-function toWorkspacePackageGlobs(monorepoRoot, packageDirs) {
-  return packageDirs.map((dir) => path3.relative(monorepoRoot, dir).split(path3.sep).join("/")).filter((relativeDir) => relativeDir !== "").map((relativeDir) => `${relativeDir}/**`).toSorted();
-}
-
 // src/resolve-scripts.ts
 function getDefaultWorkspaceScripts() {
   return { ...workspaceScripts };
@@ -8065,7 +8065,7 @@ function readCell(row, index) {
   return value;
 }
 
-// src/helpers/hook-name.ts
+// src/helpers/isHookName.ts
 function isHookName(key) {
   return key.length > 4 && key.endsWith(":pre") || key.length > 5 && key.endsWith(":post");
 }
@@ -8161,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.1/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/parseArgs.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.2/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.1/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/UsageError.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.2/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/UsageError.js
 var UsageError = class extends Error {
   constructor(message, options) {
     super(message, options);
@@ -8173,7 +8173,7 @@ var UsageError = class extends Error {
   }
 };
 
-// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.1/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/ParseError.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.2/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/ParseError.js
 var ParseError = class extends UsageError {
   kind;
   token;
@@ -8185,12 +8185,12 @@ var ParseError = class extends UsageError {
   }
 };
 
-// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.1/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/resolveLongName.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.2/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.1/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/tokenizeArgs.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.2/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 = {};
@@ -8220,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.1/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/validateSpec.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.2/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 ?? {});
@@ -8301,7 +8301,7 @@ function validateOperands(operands) {
   }
 }
 
-// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.1/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/parseArgs.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.2/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/parseArgs.js
 function parseArgs(argv, spec, options = {}) {
   validateSpec(spec);
   return parseValidatedArgs(argv, spec, options);
@@ -8672,18 +8672,16 @@ function buildRootRegistry(config, monorepoRoot) {
   };
 }
 
-// src/check-cache/config-check-cache.ts
-function assertResolvableCheckCacheCommands(config, configPath, baseDir) {
-  const { checkCache } = config;
-  if (checkCache === void 0 || !isMonorepoRoot(baseDir)) {
+// src/assertResolvableCommandLists.ts
+function assertResolvableCommandLists(config, configPath, baseDir) {
+  const entries = listCommandEntries(config);
+  if (entries.length === 0 || !isMonorepoRoot(baseDir)) {
     return;
   }
-  const fields = ["excludeCommands", "extraCommands"];
-  const entries = fields.flatMap((field) => (checkCache[field] ?? []).map((command) => ({ command, field })));
-  const hook = entries.find(({ command }) => isHookName(command));
+  const hook = entries.find(({ command, fieldPath }) => fieldPath.startsWith("checkCache.") && isHookName(command));
   if (hook !== void 0) {
     throw new UserError(
-      `Invalid nmr config at ${configPath}: \`checkCache.${hook.field}\` names the hook \`${hook.command}\`, which is never gated on its own: It runs as part of the chain of the command that it wraps.`
+      `Invalid nmr config at ${configPath}: \`${hook.fieldPath}\` names the hook \`${hook.command}\`, which is never gated on its own: It runs as part of the chain of the command that it wraps.`
     );
   }
   const registeredNames = /* @__PURE__ */ new Set([
@@ -8701,9 +8699,21 @@ function assertResolvableCheckCacheCommands(config, configPath, baseDir) {
   }
   const closestName = findClosestName(unresolvableEntry.command, [...registeredNames, ...declaredNames]);
   throw new UserError(
-    `Invalid nmr config at ${configPath}: \`checkCache.${unresolvableEntry.field}\` does not name any command: \`${unresolvableEntry.command}\`.${closestName === void 0 ? "" : ` Did you mean \`${closestName}\`?`}`
+    `Invalid nmr config at ${configPath}: \`${unresolvableEntry.fieldPath}\` does not name any command: \`${unresolvableEntry.command}\`.${closestName === void 0 ? "" : ` Did you mean \`${closestName}\`?`}`
   );
 }
+function listCommandEntries(config) {
+  const checkCacheFields = ["excludeCommands", "extraCommands"];
+  return [
+    ...checkCacheFields.flatMap(
+      (field) => (config.checkCache?.[field] ?? []).map((command) => ({ command, fieldPath: `checkCache.${field}` }))
+    ),
+    ...(config.fanOut?.extraSortedCommands ?? []).map((command) => ({
+      command,
+      fieldPath: "fanOut.extraSortedCommands"
+    }))
+  ];
+}
 function readDeclaredScriptNames(monorepoRoot) {
   let packageDirs;
   try {
@@ -8746,7 +8756,7 @@ function isCommandVerbosity(value) {
 var CONFIG_TIERS = {
   root: {
     label: "a monorepo-root config",
-    honoredKeys: ["checkCache", "delegate", "output", "rootScripts", "selfHostedRunner", "workspaceScripts"],
+    honoredKeys: ["checkCache", "delegate", "fanOut", "output", "rootScripts", "selfHostedRunner", "workspaceScripts"],
     elsewhere: "the package's own config"
   },
   workspace: {
@@ -8758,6 +8768,7 @@ var CONFIG_TIERS = {
 var RECOGNIZED_KEYS = [...CONFIG_TIERS.root.honoredKeys, ...CONFIG_TIERS.workspace.honoredKeys];
 var RECOGNIZED_BUILD_KEYS = ["extraIgnorePatterns"];
 var RECOGNIZED_CHECK_CACHE_KEYS = ["enabled", "excludeCommands", "extraCommands"];
+var RECOGNIZED_FAN_OUT_KEYS = ["extraSortedCommands"];
 var RECOGNIZED_OUTPUT_KEYS = ["commandVerbosity", "extraAgentEnvVars"];
 var RECOGNIZED_SELF_HOSTED_RUNNER_KEYS = ["exempt"];
 var RECOGNIZED_STEP_KEYS = ["run", "shouldDeclineArguments", "shouldRunInBackground"];
@@ -8782,6 +8793,8 @@ function validateConfig(value, configPath, baseDir) {
   const checkCache = validateCheckCacheField(value, configPath);
   if (checkCache) config.checkCache = checkCache;
   if (value["delegate"] !== void 0) config.delegate = validateDelegateField(value["delegate"], configPath);
+  const fanOut = validateFanOutField(value, configPath);
+  if (fanOut) config.fanOut = fanOut;
   const output = validateOutputField(value, configPath);
   if (output) config.output = output;
   const workspaceScripts2 = validateScriptField(value, "workspaceScripts", configPath);
@@ -8790,7 +8803,7 @@ function validateConfig(value, configPath, baseDir) {
   if (rootScripts) config.rootScripts = rootScripts;
   const selfHostedRunner = validateSelfHostedRunnerField(value, configPath);
   if (selfHostedRunner) config.selfHostedRunner = selfHostedRunner;
-  assertResolvableCheckCacheCommands(config, configPath, baseDir);
+  assertResolvableCommandLists(config, configPath, baseDir);
   return config;
 }
 function assertNoRetiredKeys(value, retiredKeys, configPath, prefix) {
@@ -8893,6 +8906,24 @@ function validateDelegateField(delegate, configPath) {
     `Invalid nmr config at ${configPath}: \`delegate\` accepts only \`false\`, which keeps the repo's checks on the machine that has the tree. Hosts and \`when\` belong in the user config, \`~/.config/nmr/config.ts\`.`
   );
 }
+function validateFanOutField(value, configPath) {
+  const fanOut = value["fanOut"];
+  if (fanOut === void 0) {
+    return void 0;
+  }
+  if (!isRecord2(fanOut)) {
+    throw new UserError(`Invalid nmr config at ${configPath}: \`fanOut\` must be an object`);
+  }
+  assertRecognizedKeys(fanOut, RECOGNIZED_FAN_OUT_KEYS, configPath, "fanOut.");
+  const extraSortedCommands = fanOut["extraSortedCommands"];
+  if (extraSortedCommands === void 0) {
+    return {};
+  }
+  if (!isStringArray(extraSortedCommands)) {
+    throw new UserError(`Invalid nmr config at ${configPath}: \`fanOut.extraSortedCommands\` must be a string[]`);
+  }
+  return { extraSortedCommands };
+}
 function validateOutputField(value, configPath) {
   const output = value["output"];
   if (output === void 0) {
@@ -9068,7 +9099,7 @@ function formatSelfReferenceRemedy(options) {
 import { readdirSync as readdirSync2 } from "node:fs";
 import path7 from "node:path";
 
-// src/git-ignored-paths.ts
+// src/listGitIgnoredPaths.ts
 function listGitIgnoredPaths(dir) {
   const result = runGit(
     ["ls-files", "-z", "--others", "--ignored", "--exclude-standard", "--directory", "--no-empty-directory"],
@@ -9631,7 +9662,7 @@ function hasSupportedStrictLintVersion() {
   });
 }
 function getMinVersion() {
-  const pickedFields = { "version": "2.0.3" };
+  const pickedFields = { "version": "2.1.0" };
   if (typeof pickedFields["version"] !== "string") {
     throw new TypeError("nmr/package.json: 'version' must be a string");
   }

package/.readyup/manifest.json

@@ -3,25 +3,24 @@
   "kits": [
     {
       "bundledDependencies": {
-        "@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.2",
-        "@williamthorsen/toolbelt.terminal": "0.3.0",
+        "@williamthorsen/toolbelt.arrays": "6.5.0",
+        "@williamthorsen/toolbelt.cli": "0.8.2",
+        "@williamthorsen/toolbelt.datetime": "4.1.3",
+        "@williamthorsen/toolbelt.errors": "0.10.0",
+        "@williamthorsen/toolbelt.filesystem": "0.10.2",
+        "@williamthorsen/toolbelt.guards": "4.2.2",
+        "@williamthorsen/toolbelt.numbers": "8.0.0",
+        "@williamthorsen/toolbelt.objects": "4.4.2",
+        "@williamthorsen/toolbelt.packaging": "0.7.2",
+        "@williamthorsen/toolbelt.sets": "3.1.1",
+        "@williamthorsen/toolbelt.strings": "8.2.3",
+        "@williamthorsen/toolbelt.terminal": "0.3.1",
         "ansi-regex": "6.6.0",
-        "ansi-styles": "6.2.3",
-        "cli-truncate": "6.1.1",
+        "ansi-styles": "6.2.3, 7.0.0",
+        "cli-truncate": "6.2.0",
         "diff": "9.0.0",
         "get-east-asian-width": "1.7.0",
-        "is-fullwidth-code-point": "5.1.0",
-        "slice-ansi": "9.0.1",
+        "slice-ansi": "10.0.1",
         "string-width": "8.3.0",
         "strip-ansi": "7.2.0",
         "wrap-ansi": "10.0.2",
@@ -32,7 +31,7 @@
           "checklist": "nmr",
           "checks": [
             "@williamthorsen/nmr in devDependencies",
-            "@williamthorsen/nmr >= 2.0.3",
+            "@williamthorsen/nmr >= 2.1.0",
             "pnpm-workspace.yaml exists",
             "catalogued dependencies use catalog:",
             "package.json has packageManager field",
@@ -236,7 +235,7 @@
           "path": "lib/workspace-build.ts"
         },
         {
-          "hash": "79865804",
+          "hash": "5277f03b",
           "kind": "inline",
           "path": "../package.json",
           "paths": [
@@ -244,9 +243,9 @@
           ]
         },
         {
-          "hash": "a34d9027",
+          "hash": "9219d11c",
           "kind": "module",
-          "path": "../src/check-cache/config-check-cache.ts"
+          "path": "../src/assertResolvableCommandLists.ts"
         },
         {
           "hash": "eb0306ed",
@@ -254,12 +253,12 @@
           "path": "../src/commands/ensure-prepublish-hooks.ts"
         },
         {
-          "hash": "0555552a",
+          "hash": "8c3aa404",
           "kind": "module",
           "path": "../src/config-validation.ts"
         },
         {
-          "hash": "f5e9e2fd",
+          "hash": "6df8ab2e",
           "kind": "module",
           "path": "../src/config.ts"
         },
@@ -268,11 +267,6 @@
           "kind": "module",
           "path": "../src/default-scripts.ts"
         },
-        {
-          "hash": "b58621ab",
-          "kind": "module",
-          "path": "../src/git-ignored-paths.ts"
-        },
         {
           "hash": "ae257d50",
           "kind": "module",
@@ -289,14 +283,14 @@
           "path": "../src/helpers/findClosestName.ts"
         },
         {
-          "hash": "3efe4131",
+          "hash": "d6455b2e",
           "kind": "module",
-          "path": "../src/helpers/hook-name.ts"
+          "path": "../src/helpers/importConfigDefault.ts"
         },
         {
-          "hash": "d6455b2e",
+          "hash": "3efe4131",
           "kind": "module",
-          "path": "../src/helpers/importConfigDefault.ts"
+          "path": "../src/helpers/isHookName.ts"
         },
         {
           "hash": "62caa37e",
@@ -313,13 +307,18 @@
           "kind": "module",
           "path": "../src/helpers/reportClosing.ts"
         },
+        {
+          "hash": "b58621ab",
+          "kind": "module",
+          "path": "../src/listGitIgnoredPaths.ts"
+        },
         {
           "hash": "77f6bb50",
           "kind": "module",
           "path": "../src/nmr-flags.ts"
         },
         {
-          "hash": "78ca6bd4",
+          "hash": "7e6066dd",
           "kind": "module",
           "path": "../src/resolve-scripts.ts"
         },
@@ -339,19 +338,19 @@
           "path": "../src/steps.ts"
         },
         {
-          "hash": "d8368f1a",
+          "hash": "b82cfdf6",
           "kind": "module",
           "path": "../src/tiers.ts"
         },
         {
-          "hash": "ecf8a873",
+          "hash": "f08b6ff3",
           "kind": "module",
-          "path": "../src/verbosity.ts"
+          "path": "../src/toWorkspacePackageGlobs.ts"
         },
         {
-          "hash": "f08b6ff3",
+          "hash": "cc34f13c",
           "kind": "module",
-          "path": "../src/workspace-globs.ts"
+          "path": "../src/verbosity.ts"
         },
         {
           "hash": "770e4f3a",
@@ -361,10 +360,10 @@
       ],
       "name": "default",
       "path": "kits/default.js",
-      "readyupVersion": "0.45.1",
+      "readyupVersion": "0.46.1",
       "source": "kits/default.ts",
       "sourceHash": "9fd61bf4",
-      "targetHash": "51e36551"
+      "targetHash": "70e833f9"
     }
   ]
 }

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All notable changes to this project will be documented in this file.
 
+## 2.1.0 — 2026-11-12
+
+### 🎉 Features
+
+- Adds the `fanOut.extraSortedCommands` root-config key, which lists commands besides `build` whose fan-out keeps the topological order, and nmr rejects a name in it that does not resolve to any command when it loads the config. (#1306)
+
+### ⚡ Performance
+
+- Drops pnpm's topological sort, which runs each package only after its workspace dependencies finish, from every `-R` and `-F` fan-out except one of `build`, so that `nmr test`, the `test:*` commands, and `nmr typecheck` start each package without waiting for its workspace dependencies. (#1306)
+
+### ♻️ Refactoring
+
+- Renames each single-export module in `packages/nmr/src` after its main export, such as `bin-path.ts` to `prependBinDirs.ts`, and renames the test files that matched the old names. (#1303)
+- Stops exporting seven values from `nmr`'s source modules, among them `REPORT_FORMATS`, `COMMAND_VERBOSITIES`, and the machine lock's `POLL_INTERVAL_MS`, because only the module that defines each one reads it. (#1305)
+
+### 🧪 Tests
+
+- Replaces the hand-copied git setup in the nmr tool tests and fixtures, and the local `initRepo` that shadowed the shared helper in `check-cache.tool.test.ts`, with calls to `test-utils/initRepo.ts`. (#1304)
+
 ## 2.0.3 — 2026-11-12
 
 ### ⚙️ Tooling

package/README.md

@@ -4,7 +4,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 --><!-- /section:release-notes -->
+<!-- section:release-notes -->
+## Release notes — v2.1.0 (2026-11-12)
+
+### 🎉 Features
+
+- Adds the `fanOut.extraSortedCommands` root-config key, which lists commands besides `build` whose fan-out keeps the topological order, and nmr rejects a name in it that does not resolve to any command when it loads the config. (#1306)
+
+### ⚡ Performance
+
+- Drops pnpm's topological sort, which runs each package only after its workspace dependencies finish, from every `-R` and `-F` fan-out except one of `build`, so that `nmr test`, the `test:*` commands, and `nmr typecheck` start each package without waiting for its workspace dependencies. (#1306)
+<!-- /section:release-notes -->
 
 ## Installation
 

package/dist/esm/assertResolvableCommandLists.d.ts

@@ -0,0 +1,18 @@
+import type { NmrConfig } from './types.js';
+/**
+ * Rejects a name in a config list of command names (`checkCache.excludeCommands`, `checkCache.extraCommands`,
+ * `fanOut.extraSortedCommands`) that does not resolve to any command. Each list is read by name alone, so a
+ * misspelt entry is inert: The command that it meant to name goes on running as though the list did not mention
+ * it.
+ *
+ * Because the test is resolvability rather than membership of the set that a list adjusts, an entry written
+ * against a name that a later release moves into or out of the defaults remains valid.
+ *
+ * Reads nothing while every name resolves in the merged registries, and reads a package's own `scripts` only
+ * once a name is missing from them: Those are a resolution tier of their own; a name declared only there is
+ * valid.
+ *
+ * Does nothing outside a monorepo root, where these keys are ones that the tier does not honor. `assertTierKeys`
+ * reports that, and of the two messages it is the one that names the real mistake.
+ */
+export declare function assertResolvableCommandLists(config: NmrConfig, configPath: string, baseDir: string): void;

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

@@ -1,18 +1,16 @@
 import { UserError } from '@williamthorsen/nmr-core';
-import { findClosestName } from "../helpers/findClosestName.js";
-import { isHookName } from "../helpers/hook-name.js";
-import { buildRootRegistry, buildWorkspaceRegistry, readPackageJsonScripts } from "../resolver.js";
-import { getWorkspacePackageDirs, isMonorepoRoot } from "../workspace.js";
-export function assertResolvableCheckCacheCommands(config, configPath, baseDir) {
-    const { checkCache } = config;
-    if (checkCache === undefined || !isMonorepoRoot(baseDir)) {
+import { findClosestName } from "./helpers/findClosestName.js";
+import { isHookName } from "./helpers/isHookName.js";
+import { buildRootRegistry, buildWorkspaceRegistry, readPackageJsonScripts } from "./resolver.js";
+import { getWorkspacePackageDirs, isMonorepoRoot } from "./workspace.js";
+export function assertResolvableCommandLists(config, configPath, baseDir) {
+    const entries = listCommandEntries(config);
+    if (entries.length === 0 || !isMonorepoRoot(baseDir)) {
         return;
     }
-    const fields = ['excludeCommands', 'extraCommands'];
-    const entries = fields.flatMap((field) => (checkCache[field] ?? []).map((command) => ({ command, field })));
-    const hook = entries.find(({ command }) => isHookName(command));
+    const hook = entries.find(({ command, fieldPath }) => fieldPath.startsWith('checkCache.') && isHookName(command));
     if (hook !== undefined) {
-        throw new UserError(`Invalid nmr config at ${configPath}: \`checkCache.${hook.field}\` names the hook \`${hook.command}\`, ` +
+        throw new UserError(`Invalid nmr config at ${configPath}: \`${hook.fieldPath}\` names the hook \`${hook.command}\`, ` +
             'which is never gated on its own: It runs as part of the chain of the command that it wraps.');
     }
     const registeredNames = new Set([
@@ -29,9 +27,19 @@ export function assertResolvableCheckCacheCommands(config, configPath, baseDir)
         return;
     }
     const closestName = findClosestName(unresolvableEntry.command, [...registeredNames, ...declaredNames]);
-    throw new UserError(`Invalid nmr config at ${configPath}: \`checkCache.${unresolvableEntry.field}\` does not name any command: ` +
+    throw new UserError(`Invalid nmr config at ${configPath}: \`${unresolvableEntry.fieldPath}\` does not name any command: ` +
         `\`${unresolvableEntry.command}\`.${closestName === undefined ? '' : ` Did you mean \`${closestName}\`?`}`);
 }
+function listCommandEntries(config) {
+    const checkCacheFields = ['excludeCommands', 'extraCommands'];
+    return [
+        ...checkCacheFields.flatMap((field) => (config.checkCache?.[field] ?? []).map((command) => ({ command, fieldPath: `checkCache.${field}` }))),
+        ...(config.fanOut?.extraSortedCommands ?? []).map((command) => ({
+            command,
+            fieldPath: 'fanOut.extraSortedCommands',
+        })),
+    ];
+}
 function readDeclaredScriptNames(monorepoRoot) {
     let packageDirs;
     try {

package/dist/esm/check-cache/check-cache-entries.js

@@ -1,7 +1,7 @@
 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 { isStringRecord } from "../helpers/isStringRecord.js";
 import { writeDebugNote } from "./check-cache.js";
 const CACHE_TOOL = 'nmr-check';
 const UNSAFE_SLUG_CHARACTERS = /[^\w.-]+/g;

package/dist/esm/check-cache/check-cache-gate.js

@@ -7,11 +7,11 @@ import { resolveChannel } from "../output-channel.js";
 import { splitSegments } from "../shell-syntax.js";
 import { formatMisplacedNoCacheWarning, isCacheableCommand, resolveTreeSnapshot, writeDebugNote, } from "./check-cache.js";
 import { findStaleBuildOutput, readBuildOutputState } from "./check-cache-build-output.js";
-import { recordDelegatedPass } from "./check-cache-delegation.js";
 import { certifyRetention, readCheckCacheEntry } from "./check-cache-entries.js";
 import { computeCacheKey, computeRetentionKey } from "./check-cache-key.js";
 import { recordPass } from "./check-cache-record.js";
 import { writePassManifestEntry } from "./pass-manifest.js";
+import { recordDelegatedPass } from "./recordDelegatedPass.js";
 export function openGate(options) {
     const { command, config, env, monorepoRoot, passthrough, readTree, stderr, style } = options;
     if (!isCacheableCommand(config.checkCache, command)) {