@williamthorsen/nmr 1.0.0 → 2.0.1

package/.meta/changelog.json

@@ -1,4 +1,108 @@
 [
+  {
+    "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",
+    "sections": [
+      {
+        "title": "🪦 Removed",
+        "audience": "all",
+        "items": [
+          {
+            "description": "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)",
+            "breaking": true,
+            "migration": "Replace each `devBin` entry by overriding the script that runs the bin in `rootScripts` or `workspaceScripts` with `node <path to the bin's source>`, and build an absolute path for a workspace script, because nmr no longer resolves relative paths from the monorepo root and a workspace script runs in each package's directory; a `package.json` script that runs the bin outranks the config, so change it in that `package.json`.",
+            "hash": "5a95865afe2560a4bb9e3f66448bd68f6a32c312",
+            "entry": 1
+          }
+        ]
+      },
+      {
+        "title": "♻️ Refactoring",
+        "audience": "dev",
+        "items": [
+          {
+            "description": "Move the duplicated output-style resolver into nmr-core's cli entry (#1248)",
+            "body": "Replaces the duplicate `resolveStyles` modules in `release-kit` and `v11y-check` with one `resolveCliStyles` function, exported from `@williamthorsen/nmr-core/cli`. Each package still reads its own `RELEASE_KIT_OUTPUT_STYLE` or `V11Y_CHECK_OUTPUT_STYLE` variable and still reports a usage error for a value other than `auto`, `plain`, or `rich`.",
+            "hash": "c5f4ac68360ce550a7e53006a2a633b79f179f5f"
+          }
+        ]
+      }
+    ]
+  },
   {
     "version": "1.0.0",
     "date": "2026-11-08",

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 !== "") {
@@ -8162,11 +8162,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 +8174,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 +8186,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 +8221,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 +8302,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);
@@ -8733,11 +8733,6 @@ function readPackageScripts(packageDir) {
   }
 }
 
-// src/helpers/type-guards.ts
-function isStringRecord(value) {
-  return isRecord2(value) && Object.values(value).every((entry) => typeof entry === "string");
-}
-
 // src/verbosity.ts
 var COMMAND_VERBOSITIES = ["full", "quiet"];
 function formatVerbosityRejection(source, value) {
@@ -8752,7 +8747,7 @@ function isCommandVerbosity(value) {
 var CONFIG_TIERS = {
   root: {
     label: "a monorepo-root config",
-    honoredKeys: ["checkCache", "delegate", "devBin", "output", "rootScripts", "selfHostedRunner", "workspaceScripts"],
+    honoredKeys: ["checkCache", "delegate", "output", "rootScripts", "selfHostedRunner", "workspaceScripts"],
     elsewhere: "the package's own config"
   },
   workspace: {
@@ -8788,8 +8783,6 @@ 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 devBin = validateStringRecordField(value, "devBin", configPath);
-  if (devBin) config.devBin = devBin;
   const output = validateOutputField(value, configPath);
   if (output) config.output = output;
   const workspaceScripts2 = validateScriptField(value, "workspaceScripts", configPath);
@@ -8960,15 +8953,6 @@ function validateScriptField(value, fieldName, configPath) {
   assertValidElements(scripts, fieldName, configPath);
   return scripts;
 }
-function validateStringRecordField(value, fieldName, configPath) {
-  if (!Object.hasOwn(value, fieldName) || value[fieldName] === void 0) {
-    return void 0;
-  }
-  if (!isStringRecord(value[fieldName])) {
-    throw new UserError(`Invalid nmr config at ${configPath}: \`${fieldName}\` must be a Record<string, string>`);
-  }
-  return value[fieldName];
-}
 
 // src/helpers/escapeControlCharacters.ts
 var NAMED_ESCAPES = /* @__PURE__ */ new Map([
@@ -9611,7 +9595,7 @@ function hasSupportedStrictLintVersion() {
   });
 }
 function getMinVersion() {
-  const pickedFields = { "version": "1.0.0" };
+  const pickedFields = { "version": "2.0.1" };
   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 >= 1.0.0",
+            "@williamthorsen/nmr >= 2.0.1",
             "pnpm-workspace.yaml exists",
             "catalogued dependencies use catalog:",
             "package.json has packageManager field",
@@ -86,7 +86,7 @@
           "path": "../../nmr-core/dist/esm/cache/cache-store.js"
         },
         {
-          "hash": "d2edf9e9",
+          "hash": "6ea2c3c0",
           "kind": "module",
           "path": "../../nmr-core/dist/esm/cli.js"
         },
@@ -236,7 +236,7 @@
           "path": "lib/workspace-build.ts"
         },
         {
-          "hash": "2afa0f3c",
+          "hash": "c0b5a504",
           "kind": "inline",
           "path": "../package.json",
           "paths": [
@@ -254,12 +254,12 @@
           "path": "../src/config-check-cache.ts"
         },
         {
-          "hash": "378fb666",
+          "hash": "d25aef4f",
           "kind": "module",
           "path": "../src/config-validation.ts"
         },
         {
-          "hash": "8cb3c082",
+          "hash": "d345a285",
           "kind": "module",
           "path": "../src/config.ts"
         },
@@ -308,11 +308,6 @@
           "kind": "module",
           "path": "../src/helpers/reportClosing.ts"
         },
-        {
-          "hash": "3f8448c9",
-          "kind": "module",
-          "path": "../src/helpers/type-guards.ts"
-        },
         {
           "hash": "77f6bb50",
           "kind": "module",
@@ -324,7 +319,7 @@
           "path": "../src/resolve-scripts.ts"
         },
         {
-          "hash": "5112becc",
+          "hash": "0112952e",
           "kind": "module",
           "path": "../src/resolver.ts"
         },
@@ -361,10 +356,10 @@
       ],
       "name": "default",
       "path": "kits/default.js",
-      "readyupVersion": "0.45.0",
+      "readyupVersion": "0.45.1",
       "source": "kits/default.ts",
       "sourceHash": "9fd61bf4",
-      "targetHash": "5818d99b"
+      "targetHash": "8eca943d"
     }
   ]
 }

package/CHANGELOG.md

@@ -2,6 +2,39 @@
 
 All notable changes to this project will be documented in this file.
 
+## 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
+
+- 🚨 **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)
+
+### ♻️ Refactoring
+
+- Move the duplicated output-style resolver into nmr-core's cli entry (#1248)
+
+  Replaces the duplicate `resolveStyles` modules in `release-kit` and `v11y-check` with one `resolveCliStyles` function, exported from `@williamthorsen/nmr-core/cli`. Each package still reads its own `RELEASE_KIT_OUTPUT_STYLE` or `V11Y_CHECK_OUTPUT_STYLE` variable and still reports a usage error for a value other than `auto`, `plain`, or `rich`.
+
 ## 1.0.0 — 2026-11-08
 
 ### 🧪 Tests

package/README.md

@@ -4,7 +4,13 @@
 
 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.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)
+<!-- /section:release-notes -->
 
 ## Installation
 
@@ -141,7 +147,7 @@ export default defineConfig({
 });
 ```
 
-[Scripts and configuration](docs/scripts.md#configuration) lists every `defineConfig` field and covers package-level configuration and `devBin`.
+[Scripts and configuration](docs/scripts.md#configuration) lists every `defineConfig` field, covers package-level configuration, and shows how to run a workspace bin from source.
 
 ## What nmr reports
 
@@ -304,7 +310,7 @@ rdy list --from npm:@williamthorsen/nmr  # what nmr publishes
 
 ## Documentation
 
-- [Scripts and configuration](docs/scripts.md): Override tiers, script values, hooks, `defineConfig` fields, `devBin`, and the default commands
+- [Scripts and configuration](docs/scripts.md): Override tiers, script values, hooks, `defineConfig` fields, running a workspace bin from source, and the default commands
 - [What nmr reports](docs/reporting.md): Verdicts, `--json`, output style, and verbosity
 - [Check-result cache](docs/check-cache.md): What is skipped, what a hit requires, and replaying, reading, and bypassing recorded runs
 - [Machine lock](docs/machine-lock.md): Which commands wait for one another, where the lock lives, and bypassing it

package/dist/esm/check-cache-gate.d.ts

@@ -25,8 +25,6 @@ export declare function openGate(options: {
 }): TreeSnapshot | undefined;
 /**
  * Computes the key under which this invocation would be recorded, or `undefined` when the cache does not apply.
- * The cache does not apply to a `devBin` substitution: the substitute is built from a location that the tree id
- * does not describe, so a pass by it is not a pass by the command that the key names.
  */
 export declare function resolveCacheKey(options: {
     anchorDir: string;
@@ -36,7 +34,6 @@ export declare function resolveCacheKey(options: {
     monorepoRoot: string;
     snapshot: TreeSnapshot | undefined;
     stderr: Writable;
-    substitution: string | undefined;
 }): string | undefined;
 /**
  * Runs the resolved steps behind the check-result cache: skips them when a recorded pass covers this

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

@@ -33,14 +33,10 @@ export function openGate(options) {
     return snapshot.snapshot;
 }
 export function resolveCacheKey(options) {
-    const { env, snapshot, stderr, substitution } = options;
+    const { env, snapshot, stderr } = options;
     if (snapshot === undefined) {
         return undefined;
     }
-    if (substitution !== undefined) {
-        writeDebugNote(`gate disabled: devBin substituted \`${substitution}\``, env, stderr);
-        return undefined;
-    }
     const result = computeCacheKey({
         anchorDir: options.anchorDir,
         command: options.command,

package/dist/esm/cli-build.js

@@ -1,16 +1,9 @@
+import process from 'node:process';
 import { reportFailure } from '@williamthorsen/nmr-core';
 import { NMR_COMPILE_BIN } from "./bins.js";
-import { buildPackage } from "./commands/build.js";
-import { loadWorkspaceConfig } from "./config.js";
-import { resolveBinStyles } from "./resolveBinStyles.js";
+import { runCompile } from "./commands/compile.js";
 try {
-    const { stdout } = resolveBinStyles();
-    const packageDir = process.cwd();
-    const { build } = await loadWorkspaceConfig(packageDir);
-    await buildPackage(packageDir, {
-        style: stdout,
-        ...(build?.extraIgnorePatterns !== undefined && { extraIgnorePatterns: build.extraIgnorePatterns }),
-    });
+    process.exitCode = await runCompile(process.argv.slice(2), process.cwd());
 }
 catch (error) {
     reportFailure(NMR_COMPILE_BIN, error);

package/dist/esm/cli-clean.js

@@ -2,9 +2,8 @@ import process from 'node:process';
 import { reportFailure } from '@williamthorsen/nmr-core';
 import { NMR_CLEAN_BIN } from "./bins.js";
 import { runClean } from "./commands/clean.js";
-import { resolveBinStyles } from "./resolveBinStyles.js";
 try {
-    await runClean(process.cwd(), resolveBinStyles().stdout);
+    process.exitCode = await runClean(process.argv.slice(2), process.cwd());
 }
 catch (error) {
     reportFailure(NMR_CLEAN_BIN, error);

package/dist/esm/cli-report-catalog.js

@@ -1,10 +1,9 @@
 import process from 'node:process';
 import { reportFailure } from '@williamthorsen/nmr-core';
 import { NMR_REPORT_CATALOG_BIN } from "./bins.js";
-import { reportCatalog } from "./commands/report-catalog.js";
-import { resolveBinStyles } from "./resolveBinStyles.js";
+import { runReportCatalog } from "./commands/report-catalog.js";
 try {
-    reportCatalog(process.cwd(), resolveBinStyles().stderr);
+    process.exitCode = await runReportCatalog(process.argv.slice(2), process.cwd());
 }
 catch (error) {
     reportFailure(NMR_REPORT_CATALOG_BIN, error);

package/dist/esm/cli-report-overrides.js

@@ -1,11 +1,9 @@
+import process from 'node:process';
 import { reportFailure } from '@williamthorsen/nmr-core';
 import { NMR_REPORT_OVERRIDES_BIN } from "./bins.js";
-import { reportOverrides } from "./commands/report-overrides.js";
-import { resolveBinStyles } from "./resolveBinStyles.js";
-import { findMonorepoRoot } from "./workspace.js";
+import { runReportOverrides } from "./commands/report-overrides.js";
 try {
-    const monorepoRoot = findMonorepoRoot();
-    reportOverrides(monorepoRoot, resolveBinStyles().stderr);
+    process.exitCode = await runReportOverrides(process.argv.slice(2), process.cwd());
 }
 catch (error) {
     reportFailure(NMR_REPORT_OVERRIDES_BIN, error);

package/dist/esm/commands/build-output.d.ts

@@ -6,28 +6,13 @@ export interface BuildOptions {
     ignorePatterns?: string[];
     outdir?: string;
 }
-/** The pair of directories through which a build publishes, both siblings of the emit directory. */
-export interface ScratchDirs {
-    previousDir: string;
-    stagingDir: string;
-}
-export declare const DEFAULT_ENTRY_GLOBS: string[];
-/**
- * Directories holding test scaffolding rather than published code, excluded from entry-point selection so that a
- * package does not publish its own helpers. The list differs from the vitest factory's `COVERAGE_EXCLUDE`, which
- * leaves `test-utils/` inside the coverage include set, and neither list can be derived from the other.
- *
- * Ignoring a file removes it as an entry point, not from the emit. The compiler still emits whatever the
- * surviving entry points import, which keeps a production module that uses a helper from emitting a dangling
- * specifier. Widening this list can therefore only drop files that production code does not import.
- */
-export declare const DEFAULT_IGNORE_PATTERNS: string[];
 export declare const DEFAULT_OUTDIR = "dist/esm/";
 /**
- * Reports whether the output that a build of `packageDir` would produce is currently on disk. Applies the build's
- * own rule, on the same options that the build was given, so a caller probing for output and the build deciding
- * whether to rebuild cannot disagree: A package whose entry points emit nothing does not expect any output, and
- * reports present. Passing options that the build was not given would make the two disagree.
+ * Reports whether the output that a build of `packageDir` would produce is currently on disk. Selects entry points
+ * through `resolveEntryPoints` and tests them through `hasExpectedBuildOutput`, as the build does, so a caller
+ * probing for output and the build deciding whether to rebuild cannot disagree: A package whose entry points emit
+ * nothing does not expect any output, and reports present. Passing options that the build was not given would make
+ * the two disagree.
  */
 export declare function hasBuildOutput(packageDir: string, options?: BuildOptions): Promise<boolean>;
 /**
@@ -65,18 +50,8 @@ export declare function resolveBuildCachePath(packageDir: string): string;
  * `readBuildDigest` returns.
  */
 export declare function resolveEmitDurationPath(packageDir: string): string;
-/**
- * Resolves the two scratch directories through which a build publishes: `staging`, which the emit is written to,
- * and `previous`, which the outgoing output is renamed aside to. Both are siblings of the emit directory, so a
- * rename between them never crosses a filesystem, and both are dot-prefixed so that a leftover stays out of the
- * globs that select sources.
- *
- * The names are fixed rather than unique because the build removes both before use. A unique name would need a
- * sweep to accomplish that removal, and a sweep cannot tell a directory orphaned by a killed run from one that a
- * concurrent build is still writing. Because a directory left behind by a failed build is cleared the same way,
- * the failure path does not need any cleanup of its own.
- */
-export declare function resolveScratchDirs(emitDir: string): ScratchDirs;
+/** Selects the entry points that a build of `packageDir` compiles, as paths relative to `packageDir`. */
+export declare function resolveEntryPoints(packageDir: string, options?: BuildOptions): Promise<string[]>;
 /**
  * Resolves the fingerprint of the nmr compiling `packageDir`, the `BuildToolchain` member that identifies nmr. It
  * is nmr's own build digest when one is on disk, which changes on a dev-loop edit that the version does not

package/dist/esm/commands/build-output.js

@@ -3,17 +3,14 @@ import path from 'node:path';
 import { findPackageRoot, readCacheEntry, readGuardedCacheEntry, resolveCacheEntryPath, writeGuardedCacheEntry, } from '@williamthorsen/nmr-core';
 import { glob } from 'glob';
 import { readPackageJson } from "../helpers/package-json.js";
-export const DEFAULT_ENTRY_GLOBS = ['src/**/*.{ts,tsx}'];
-export const DEFAULT_IGNORE_PATTERNS = ['**/__fixtures__/**', '**/__mocks__/**', '**/__tests__/**', '**/test-utils/**'];
+const DEFAULT_ENTRY_GLOBS = ['src/**/*.{ts,tsx}'];
+const DEFAULT_IGNORE_PATTERNS = ['**/__fixtures__/**', '**/__mocks__/**', '**/__tests__/**', '**/test-utils/**'];
 export const DEFAULT_OUTDIR = 'dist/esm/';
 const BUILD_CACHE_TOOL = 'nmr-compile';
 const SELF_DIR = findPackageRoot(import.meta.url);
 export async function hasBuildOutput(packageDir, options = {}) {
     const outdir = options.outdir ?? DEFAULT_OUTDIR;
-    const entryPoints = await glob(options.entryGlobs ?? DEFAULT_ENTRY_GLOBS, {
-        cwd: packageDir,
-        ignore: [...(options.ignorePatterns ?? DEFAULT_IGNORE_PATTERNS), ...(options.extraIgnorePatterns ?? [])],
-    });
+    const entryPoints = await resolveEntryPoints(packageDir, options);
     return hasExpectedBuildOutput(packageDir, outdir, entryPoints);
 }
 export function hasExpectedBuildOutput(packageDir, outdir, entryPoints) {
@@ -49,13 +46,11 @@ export function resolveEmitDurationPath(packageDir) {
         extension: '.duration.json',
     });
 }
-export function resolveScratchDirs(emitDir) {
-    const parent = path.dirname(emitDir);
-    const name = path.basename(emitDir);
-    return {
-        previousDir: path.join(parent, `.${name}.previous`),
-        stagingDir: path.join(parent, `.${name}.staging`),
-    };
+export async function resolveEntryPoints(packageDir, options = {}) {
+    return glob(options.entryGlobs ?? DEFAULT_ENTRY_GLOBS, {
+        cwd: packageDir,
+        ignore: [...(options.ignorePatterns ?? DEFAULT_IGNORE_PATTERNS), ...(options.extraIgnorePatterns ?? [])],
+    });
 }
 export async function resolveToolchainFingerprint(packageDir, selfDir = SELF_DIR) {
     if (!isSameDir(packageDir, selfDir)) {

package/dist/esm/commands/build-report.d.ts

@@ -0,0 +1,6 @@
+import { type OutputStyle } from '@williamthorsen/nmr-core';
+import type { BuildOutcome, BuildProgress } from './build.js';
+/** Renders the line that closes a build: the skip, naming the saving when it is worth naming, or the emit. */
+export declare function renderBuildOutcome(outcome: BuildOutcome, packageName: string, style: OutputStyle): string;
+/** Renders the line that announces an emit, naming why the build is about to run. */
+export declare function renderBuildProgress(progress: BuildProgress, packageName: string, style: OutputStyle): string;

package/dist/esm/commands/build-report.js

@@ -0,0 +1,21 @@
+import { formatGlyphLine, STATUS_GLYPHS } from '@williamthorsen/nmr-core';
+import { NMR_GLYPHS } from "../glyphs.js";
+import { formatSaving } from "../helpers/duration.js";
+export function renderBuildOutcome(outcome, packageName, style) {
+    if (outcome.kind === 'unchanged') {
+        const saving = formatSaving(outcome.savedMs ?? 0);
+        const savingClause = saving === undefined ? '' : `, ${saving}`;
+        return `${STATUS_GLYPHS[style].skipped.text} ${packageName}: No changes detected. Skipping build${savingClause}.`;
+    }
+    return formatGlyphLine(NMR_GLYPHS, style, 'package', `${packageName}: ${describeEmit(outcome.fileCount, outcome.outdir)}`);
+}
+export function renderBuildProgress(progress, packageName, style) {
+    const message = progress.kind === 'output-missing' ? 'Build output is missing. Rebuilding.' : 'Changes detected.';
+    return formatGlyphLine(NMR_GLYPHS, style, 'package', `${packageName}: ${message}`);
+}
+function describeEmit(fileCount, outdir) {
+    if (fileCount === 0) {
+        return 'Did not emit any output.';
+    }
+    return `Compiled ${fileCount} files to ${outdir.replace(/\/+$/u, '')}.`;
+}