@williamthorsen/nmr 0.37.0 → 0.38.0

package/.meta/changelog.json

@@ -1,4 +1,34 @@
 [
+  {
+    "version": "0.38.0",
+    "date": "2026-09-18",
+    "sections": [
+      {
+        "title": "🎉 Features",
+        "audience": "all",
+        "items": [
+          {
+            "description": "Give nmr plain output in pipes and CI logs (#838)",
+            "body": "- Stops `nmr` from printing emoji to a pipe or a CI log: When the output stream is not a terminal or `CI` is set, a verdict reads `PASS`, `FAIL`, `SKIP`, or `NOOP` and a command icon is omitted, so that a log can be searched for a verdict.\n- Adds `--output-style <auto|plain|rich>` to `nmr` and the `NMR_OUTPUT_STYLE` variable, each forcing either style; the flag outranks the variable, a value that names no style exits 1 with a usage error, and neither enters a check-cache key: A rich run and a plain run share a recorded pass.\n- Replaces several rich glyphs, taking the status markers from the set that release-kit and v11y-check print so that one status has one glyph across the three tools: a recalled pass shows ⏩ in place of ⏭️, a skipped empty override shows ⚪ in place of ⛔, a warning and the `--log` refusal show 🟠 in place of ⚠️ and 📭, the `--log` header shows 💾 in place of 📼, and `nmr-ensure-prepublish-hooks` reports ✅ and ❌ in place of ✓ and ✗.",
+            "hash": "693b3a7f57def3d299ced240c19bda90f6253bdc"
+          }
+        ]
+      },
+      {
+        "title": "🪦 Removed",
+        "audience": "all",
+        "items": [
+          {
+            "description": "Rename the declinesArgs step declaration to shouldDeclineArguments (#822)",
+            "body": "- Makes a `.config/nmr.config.ts` that still declares `declinesArgs` on a composite script's `{ run, declinesArgs }` step fail to load, with an error that names `shouldDeclineArguments` as the replacement.\n- Renames the matching field of the `StepSpec` type exported by `@williamthorsen/nmr/config` and `@williamthorsen/nmr/scripts`.\n\nMigration: Rename `declinesArgs` to `shouldDeclineArguments` in each composite script step of `.config/nmr.config.ts`, and in any code that sets or reads the field on a `StepSpec`.",
+            "breaking": true,
+            "migration": "Rename `declinesArgs` to `shouldDeclineArguments` in each composite script step of `.config/nmr.config.ts`, and in any code that sets or reads the field on a `StepSpec`.",
+            "hash": "b12333390e731c1a9d7055d293b686028c89ad26"
+          }
+        ]
+      }
+    ]
+  },
   {
     "version": "0.37.0",
     "date": "2026-09-15",

package/.readyup/kits/default.js

@@ -1,18 +1,18 @@
 /** @noformat -- @generated. Do not edit. Compiled by rdy. */
 /* eslint-disable */
-export const __readyupVersion = "0.36.0";
+export const __readyupVersion = "0.38.0";
 
 
 // .readyup/kits/default.ts
 import { existsSync, globSync, readdirSync as readdirSync2 } from "node:fs";
 import { basename, dirname, join, posix, sep } from "node:path";
 
-// ../../node_modules/.pnpm/@williamthorsen+toolbelt.errors@0.7.0/node_modules/@williamthorsen/toolbelt.errors/dist/esm/4-release/isError.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.errors@0.8.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.7.0/node_modules/@williamthorsen/toolbelt.errors/dist/esm/4-release/describeError.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.errors@0.8.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 !== "") {
@@ -41,8 +41,8 @@ import {
 
 // src/default-scripts.ts
 var GATE_PROJECTS = "--project unit --project tool";
-var TYPECHECK_STEP = { run: "typecheck", declinesArgs: true };
-var ROOT_TYPECHECK_STEP = { run: "root:typecheck", declinesArgs: true };
+var TYPECHECK_STEP = { run: "typecheck", shouldDeclineArguments: true };
+var ROOT_TYPECHECK_STEP = { run: "root:typecheck", shouldDeclineArguments: true };
 var workspaceScripts = {
   build: ["compile"],
   check: [TYPECHECK_STEP, "fmt:check", "lint:check", "test"],
@@ -77,7 +77,7 @@ var rootScripts = {
   "check:strict": [TYPECHECK_STEP, "fmt:check", "lint:strict", "test"],
   // Excludes the audit, which in CI has a workflow of its own. The build is what the narrowed check runs
   // against, so it declines the arguments rather than being narrowed by them.
-  ci: [{ run: "build", declinesArgs: true }, "check:strict"],
+  ci: [{ run: "build", shouldDeclineArguments: true }, "check:strict"],
   clean: "nmr-clean",
   fix: ["lint", "fmt"],
   "fix:check": ["fmt:check", "lint:check"],
@@ -88,7 +88,7 @@ var rootScripts = {
   "lint:strict": "strict-lint",
   // The audit costs seconds and `ci` costs minutes, so the cheap gate fails first. The audit reads the
   // dependency tree, which no argument narrowing the code under test says anything about.
-  prepush: [{ run: "audit", declinesArgs: true }, "ci"],
+  prepush: [{ run: "audit", shouldDeclineArguments: true }, "ci"],
   "report-overrides": "nmr-report-overrides",
   "root:check": [ROOT_TYPECHECK_STEP, "fmt:check", "root:lint:check", "root:test"],
   "root:lint": "eslint --fix --ignore-pattern 'packages/**' .",
@@ -110,7 +110,7 @@ var rootScripts = {
   "test:watch": `vitest ${GATE_PROJECTS} --watch`,
   // Neither step is narrowable, so `nmr typecheck <file>` is rejected rather than checking that file under
   // default options at the root and hunting for it in every package.
-  typecheck: [ROOT_TYPECHECK_STEP, { run: "-R typecheck", declinesArgs: true }],
+  typecheck: [ROOT_TYPECHECK_STEP, { run: "-R typecheck", shouldDeclineArguments: true }],
   // The command is a string because neither half names an nmr command: both are binaries, and a composite
   // element can name only a command.
   upgrade: "nmr-report-overrides && nmr-taze --recursive"
@@ -597,7 +597,7 @@ function formatPaths(paths) {
 ${paths.map((path2) => `      ${path2}`).join("\n")}`;
 }
 function getMinVersion() {
-  const picked = { "version": "0.37.0" };
+  const picked = { "version": "0.38.0" };
   if (typeof picked["version"] !== "string") {
     throw new TypeError("nmr/package.json: 'version' must be a string");
   }

package/.readyup/manifest.json

@@ -3,7 +3,7 @@
   "kits": [
     {
       "bundledDependencies": {
-        "@williamthorsen/toolbelt.errors": "0.7.0"
+        "@williamthorsen/toolbelt.errors": "0.8.1"
       },
       "checklists": [
         "nmr"
@@ -16,7 +16,7 @@
           "path": "kits/default.ts"
         },
         {
-          "hash": "d4b2e208",
+          "hash": "521b947a",
           "kind": "inline",
           "path": "../package.json",
           "paths": [
@@ -24,7 +24,7 @@
           ]
         },
         {
-          "hash": "74bd7994",
+          "hash": "06bffeed",
           "kind": "module",
           "path": "../src/default-scripts.ts"
         },
@@ -41,10 +41,10 @@
       ],
       "name": "default",
       "path": "kits/default.js",
-      "readyupVersion": "0.36.0",
+      "readyupVersion": "0.38.0",
       "source": "kits/default.ts",
       "sourceHash": "488459c0",
-      "targetHash": "d1c8d02c"
+      "targetHash": "cbef780a"
     }
   ]
 }

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All notable changes to this project will be documented in this file.
 
+## 0.38.0 — 2026-09-18
+
+### 🎉 Features
+
+- Give nmr plain output in pipes and CI logs (#838)
+
+  - Stops `nmr` from printing emoji to a pipe or a CI log: When the output stream is not a terminal or `CI` is set, a verdict reads `PASS`, `FAIL`, `SKIP`, or `NOOP` and a command icon is omitted, so that a log can be searched for a verdict.
+  - Adds `--output-style <auto|plain|rich>` to `nmr` and the `NMR_OUTPUT_STYLE` variable, each forcing either style; the flag outranks the variable, a value that names no style exits 1 with a usage error, and neither enters a check-cache key: A rich run and a plain run share a recorded pass.
+  - Replaces several rich glyphs, taking the status markers from the set that release-kit and v11y-check print so that one status has one glyph across the three tools: a recalled pass shows ⏩ in place of ⏭️, a skipped empty override shows ⚪ in place of ⛔, a warning and the `--log` refusal show 🟠 in place of ⚠️ and 📭, the `--log` header shows 💾 in place of 📼, and `nmr-ensure-prepublish-hooks` reports ✅ and ❌ in place of ✓ and ✗.
+
+### 🪦 Removed
+
+- 🚨 **Breaking:** Rename the declinesArgs step declaration to shouldDeclineArguments (#822)
+
+  - Makes a `.config/nmr.config.ts` that still declares `declinesArgs` on a composite script's `{ run, declinesArgs }` step fail to load, with an error that names `shouldDeclineArguments` as the replacement.
+  - Renames the matching field of the `StepSpec` type exported by `@williamthorsen/nmr/config` and `@williamthorsen/nmr/scripts`.
+
+  Migration: Rename `declinesArgs` to `shouldDeclineArguments` in each composite script step of `.config/nmr.config.ts`, and in any code that sets or reads the field on a `StepSpec`.
+
 ## 0.37.0 — 2026-09-15
 
 ### 🎉 Features

package/README.md

@@ -5,43 +5,24 @@
 Context-aware script runner for pnpm monorepos. Ships an `nmr` (node-monorepo run) binary that provides centralized, consistent script execution across workspace packages and the monorepo root.
 
 <!-- section:release-notes -->
-## Release notes — v0.37.0 (2026-09-15)
+## Release notes — v0.38.0 (2026-09-18)
 
 ### 🎉 Features
 
-- Guard lefthook install in root prepare and report unguarded installs (#798)
+- Give nmr plain output in pipes and CI logs (#838)
 
-  - Adds a `warn` check to the readyup kit of `@williamthorsen/nmr` that reports a root script run by `pnpm install`, such as `prepare` or `postinstall`, whose command calls `lefthook install` without `lefthook check-install`.
-  - Includes in the check's suggested fix the guarded form `lefthook check-install || lefthook install`, which skips rewriting `.git/hooks` while `lefthook.yml` is unchanged since the last install, so that a repo using that form can run `pnpm install` without write access to `.git/hooks`, as inside the Claude Code sandbox, and under pnpm's default `verifyDepsBeforeRun` avoids a reinstall before every `pnpm exec`.
+  - Stops `nmr` from printing emoji to a pipe or a CI log: When the output stream is not a terminal or `CI` is set, a verdict reads `PASS`, `FAIL`, `SKIP`, or `NOOP` and a command icon is omitted, so that a log can be searched for a verdict.
+  - Adds `--output-style <auto|plain|rich>` to `nmr` and the `NMR_OUTPUT_STYLE` variable, each forcing either style; the flag outranks the variable, a value that names no style exits 1 with a usage error, and neither enters a check-cache key: A rich run and a plain run share a recorded pass.
+  - Replaces several rich glyphs, taking the status markers from the set that release-kit and v11y-check print so that one status has one glyph across the three tools: a recalled pass shows ⏩ in place of ⏭️, a skipped empty override shows ⚪ in place of ⛔, a warning and the `--log` refusal show 🟠 in place of ⚠️ and 📭, the `--log` header shows 💾 in place of 📼, and `nmr-ensure-prepublish-hooks` reports ✅ and ❌ in place of ✓ and ✗.
 
-- Report misplaced test files and a missing guard from the readyup kit (#804)
+### 🪦 Removed
 
-  - Adds an `error` check to the `@williamthorsen/nmr` readyup kit that reports each `*.test.ts` or `*.test.tsx` file outside a `__tests__` directory, which no Vitest project collects and which therefore runs nowhere.
-  - Adds a `warn` check that passes once a test file under `__tests__` imports `checkTestFileConventions` from `@williamthorsen/nmr/tests`, and whose fix shows the one-line guard test to add.
-  - Makes the kit skip both test-file checks once it finds that guard, because the guard reports the same files and applies the repo's `exclude` list, which the kit cannot read.
+- 🚨 **Breaking:** Rename the declinesArgs step declaration to shouldDeclineArguments (#822)
 
-### 🐛 Bug fixes
+  - Makes a `.config/nmr.config.ts` that still declares `declinesArgs` on a composite script's `{ run, declinesArgs }` step fail to load, with an error that names `shouldDeclineArguments` as the replacement.
+  - Renames the matching field of the `StepSpec` type exported by `@williamthorsen/nmr/config` and `@williamthorsen/nmr/scripts`.
 
-- Fail when a -F pattern selects no workspace (#785)
-
-  - Fixes a run that reported success without doing anything. `nmr -F <pattern> <command>` printed nothing and exited 0 when the pattern matched no package. It now exits 1, names the rejected pattern, and explains the likely cause.
-  - Covers three further selections that ran nothing and exited 0: an exclusion that leaves only the workspace root, such as `nmr -F '!./packages/*'`; `-R` in a workspace that declares no package; and an empty `-F ''`.
-
-  Migration: Replace any `-F` pattern that names a directory with the package's manifest `name`. A filter that selects nothing now fails the run instead of passing in silence.
-
-- Fix test runs failing on a dependency with a TypeScript source export (#793)
-
-  - Fixes the issue that, with `resolveFromSource` at its default of `true`, every test in a file failed with `Stripping types is currently unsupported for files under node_modules` when the file's imports reached a dependency whose `exports` map declares a `source` condition pointing at TypeScript.
-  - Limits the source resolution enabled by `resolveFromSource` to packages whose real path lies outside every `node_modules`, which covers workspace packages and packages linked into the repo from elsewhere.
-  - Makes an import of a workspace package fail when that package's `source` condition names a missing file, instead of resolving to the build output without warning.
-  - Makes conditions that a config adds to `resolve.conditions` or `ssr.resolve.conditions` extend Vite's defaults when `resolveFromSource` is `false`, instead of replacing them.
-
-  Migration: Point each workspace package's `source` condition at a file that exists, or remove the condition. Build a workspace package before running a test that reaches it through an externalized dependency (one that Vitest loads through Node instead of transforming): Node resolves that import without the `source` condition, so it loads the package's build output.
-
-- Prevent a recursive or multi-package run from hanging under pnpm 12 (#814)
-
-  - Fixes a hang under pnpm 12: In a terminal, `nmr -R <command>`, a root command that runs in every package such as `nmr build`, and a `-F` pattern that selects several packages printed nothing and waited until Ctrl+C when a package command read keyboard input or changed the terminal's mode, as the spinner in `next build` does.
-  - Gives no terminal input to each package of a `-R` run or a multi-package `-F` run, including a dependency-chain filter such as `-F 'app...'`, and keeps it for a `-F` filter that selects one package, which an interactive command such as `nmr -F <pkg> test:watch` needs.
+  Migration: Rename `declinesArgs` to `shouldDeclineArguments` in each composite script step of `.config/nmr.config.ts`, and in any code that sets or reads the field on a `StepSpec`.
 <!-- /section:release-notes -->
 
 ## Installation
@@ -176,13 +157,15 @@ Every command nmr runs reports one line naming the scope it ran at, the command,
 ```console
 ✅ nmr-core: test: passed in 12.4s
 ❌ nmr: build: failed in 1.2s (exit 1)
-⏭️ nmr-core: test: passed 4m ago on this tree, saved ~12s
-⛔ nmr-core: lint: skipped, the override is empty
+⏩ nmr-core: test: passed 4m ago on this tree, saved ~12s
+⚪ nmr-core: lint: skipped, the override is empty
 ```
 
+**A pipe and a CI log get words rather than emoji.** The same four lines read `PASS`, `FAIL`, `SKIP`, and `NOOP` there, which `grep FAIL` finds. `--output-style` and `NMR_OUTPUT_STYLE` each force either style.
+
 **Verdicts print in every verbosity.** `-q` withholds the output of the commands nmr runs, never nmr's own words: a passing quiet run reports its verdicts and nothing else. A command whose override resolved to `""` or `":"` reports the skip rather than exiting 0 in silence, which is what separates it from a command that passed. An `NMR_RUN_IF_PRESENT` miss reports nothing, having no command to report on.
 
-[What nmr reports](docs/reporting.md) covers how verdicts nest, the `--json` format, and where the verbosity of a run comes from.
+[What nmr reports](docs/reporting.md) covers how verdicts nest, the `--json` format, the output style, and where the verbosity of a run comes from.
 
 ## Check-result cache
 
@@ -193,7 +176,7 @@ $ nmr ci
 # ... four minutes of build, typecheck, lint, and tests ...
 
 $ nmr ci
-⏭️ node-monorepo-tools: ci: passed 2m ago on this tree, saved ~4m
+⏩ node-monorepo-tools: ci: passed 2m ago on this tree, saved ~4m
 ```
 
 [Check-result cache](docs/check-cache.md) covers what is cached, what a hit requires, replaying and reading a recorded run, and bypassing or configuring the cache.
@@ -297,7 +280,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
-- [What nmr reports](docs/reporting.md): verdicts, `--json`, and verbosity
+- [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
 - [Dependency upgrades](docs/upgrades.md): `nmr upgrade`, the upgrade policy, `report-catalog`, `report-overrides`, and `nmr-taze`
 - [Standalone utilities](docs/utilities.md): `nmr-clean`, `nmr-compile`, `nmr-fmt`, and `ensure-prepublish-hooks`

package/agents/guidance/rulebooks/nmr.md

@@ -10,8 +10,8 @@ delivery: ambient
 - Scope follows cwd, and bare `nmr` lists both registries: from the repo root a command covers root files and every workspace; from inside a package, that package alone. `nmr -F <pkg> <command>` targets one package from anywhere; `nmr root:<command>` targets root files alone, which isolates a failure to root code.
 - Never `npx nmr`: inside a git worktree it can resolve a different nmr from outside the tree. Fall back to `pnpm exec nmr`.
 - `nmr ci` runs what a code-quality workflow runs (build, then strict checks) and not the dependency audit, which belongs to a workflow of its own; `nmr prepush` runs the audit first, then `ci`, so a vulnerability stops the run before the long gate. Neither installs or binds a git hook.
-- A check that already passed on the current working tree skips, printing `⏭️ <scope>: <command>: passed …` and, where the recalled run left one, `— replayed: <excerpt>` of what that run concluded. Any edit, addition, or deletion re-runs it, so read the replayed excerpt rather than paying for the answer again: never pass `--no-cache` to get a "real" run, which costs the command's full runtime to reach the same answer. Its one use is a file rather than an exit status -- a skipped command writes none, so a fresh `coverage/` needs `nmr --no-cache test:coverage`. A composite replays its constituents' excerpts, each attributed as `<scope>: <command>: <excerpt>` and cut at the line's ceiling where there are too many to fit. A skip carrying no excerpt is one whose run wrote to a terminal, or one whose constituents recorded none.
+- A check that already passed on the current working tree skips, printing `SKIP <scope>: <command>: passed …` and, where the recalled run left one, `— replayed: <excerpt>` of what that run concluded. Any edit, addition, or deletion re-runs it, so read the replayed excerpt rather than paying for the answer again: never pass `--no-cache` to get a "real" run, which costs the command's full runtime to reach the same answer. Its one use is a file rather than an exit status -- a skipped command writes none, so a fresh `coverage/` needs `nmr --no-cache test:coverage`. A composite replays its constituents' excerpts, each attributed as `<scope>: <command>: <excerpt>` and cut at the line's ceiling where there are too many to fit. A skip carrying no excerpt is one whose run wrote to a terminal, or one whose constituents recorded none.
 - `nmr --log <command>` prints the whole run behind that excerpt -- up to 256 KiB, led by when it was recorded, how long it ran, and the command string that produced it -- so output you need in full is a recording to read rather than a run to pay for again. It runs nothing, and it is held to the tree rather than to the terminal: a recording a piped run made prints for a reader at one. A composite prints its constituents' excerpts, so the transcript of one of them is `nmr -F <pkg> --log <command>` or that constituent's own name. Nothing to show is said on one line and exits non-zero, naming which it is.
-- Every command nmr runs reports one line -- `✅ <scope>: <command>: passed in 12.4s`, `❌ … failed in 1.2s (exit 1)`, `⏭️ … passed 4m ago on this tree`, or `⛔ … skipped, the override is empty` -- and a composite reports alongside every command it expands into. The lines print in every verbosity, so `-q` is the low-noise way to run rather than a silent one: it withholds the output of the commands nmr runs and keeps nmr's own verdicts, which is how a pass, a cached skip, and a `""`/`":"` override stay distinguishable. Expect a run to be quiet already without the flag: nmr recognizes a known agent harness in the environment and takes quiet from that, as it does from `NMR_COMMAND_VERBOSITY` or the repo's `output.commandVerbosity`. A command whose output you need in full is one to run with `NMR_COMMAND_VERBOSITY=full`, which outranks both.
+- Every command nmr runs reports one line -- `PASS <scope>: <command>: passed in 12.4s`, `FAIL … failed in 1.2s (exit 1)`, `SKIP … passed 4m ago on this tree`, or `NOOP … skipped, the override is empty` -- and a composite reports alongside every command it expands into. Those are the words a pipe and a CI log get; a terminal gets ✅, ❌, ⏩, and ⚪ in their place, and `--output-style rich` or `NMR_OUTPUT_STYLE=rich` forces the emoji on any stream. The lines print in every verbosity, so `-q` is the low-noise way to run rather than a silent one: it withholds the output of the commands nmr runs and keeps nmr's own verdicts, which is how a pass, a cached skip, and a `""`/`":"` override stay distinguishable. Expect a run to be quiet already without the flag: nmr recognizes a known agent harness in the environment and takes quiet from that, as it does from `NMR_COMMAND_VERBOSITY` or the repo's `output.commandVerbosity`. A command whose output you need in full is one to run with `NMR_COMMAND_VERBOSITY=full`, which outranks both.
 - Every test file lives under a `__tests__` directory and names its isolation tier last: `<subject>[.<aspect>].<tier>.test.ts`, where any earlier segment is free-form documentation. A tier is the furthest thing the test reaches -- `tool` (a program the environment supplies), `localhost` (a service on this machine), `remote` (a machine that isn't this one), or `unit`, the residual claiming everything else. A file outside `__tests__`, or one whose tier segment is missing or misspelt, fails the test run in a repo that declares nmr's exported conventions check, which reports both. In a repo that has not, neither fails anything -- the first is collected by nothing and the second runs under `unit` -- and `rdy run --packages` reports both and warns that the check is missing.
 - The rest is in `node_modules/@williamthorsen/nmr/docs/`: `scripts.md` for pre/post hooks (every `nmr X` auto-wraps as `nmr X:pre && nmr X && nmr X:post`) and script overrides and their `""`/`":"` skip values; `upgrades.md` for `nmr upgrade` ceilings (report-only until `nmr upgrade --write`); `utilities.md` for the `nmr-compile` build (there is no repo-local build script); `vitest.md` for the test tiers' timeout budgets, the `tiers` seam that raises one, and which script reaches which tier; and `check-cache.md` for the check-result cache's key, the retention key a replayed excerpt is additionally held to, the retention ceiling `--log` prints within, its `checkCache` config, and every condition that disables it.

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

@@ -1,4 +1,5 @@
 import type { Writable } from 'node:stream';
+import { type OutputStyle } from '@williamthorsen/nmr-core';
 import type { OutputChannels } from './runner.js';
 import type { CheckCacheConfig, NmrConfig } from './types.js';
 /** A recorded pass: what ran, on which tree, and what it cost. */
@@ -159,7 +160,7 @@ export declare function findStaleBuildOutput(earlier: Record<string, string>, la
  * command rather than a flag to nmr. Passing it on unchanged is the honest thing to do with an argument, so
  * the warning is all that separates this from a silently un-bypassed run.
  */
-export declare function formatMisplacedNoCacheWarning(command: string): string;
+export declare function formatMisplacedNoCacheWarning(command: string, style: OutputStyle): string;
 /**
  * Reports whether a command's passes are recorded at all, which is what separates a command with no recording
  * from one that could never have had one.

package/dist/esm/check-cache.js

@@ -2,7 +2,7 @@ import { createHash, randomUUID } from 'node:crypto';
 import { readFileSync, realpathSync } from 'node:fs';
 import path from 'node:path';
 import process from 'node:process';
-import { hashWorkingTree, readCacheEntry, readHeadSha, readJsonCacheEntry, removeCacheDir, removeCacheEntry, resolveCacheEntryPath, writeCacheEntry, } from '@williamthorsen/nmr-core';
+import { hashWorkingTree, readCacheEntry, readHeadSha, readJsonCacheEntry, removeCacheDir, removeCacheEntry, resolveCacheEntryPath, STATUS_GLYPHS, writeCacheEntry, } from '@williamthorsen/nmr-core';
 import { describeError } from '@williamthorsen/toolbelt.errors';
 import { hasBuildOutput, readBuildDigest } from "./commands/build-output.js";
 import { loadWorkspaceConfig } from "./config.js";
@@ -107,9 +107,9 @@ export function findStaleBuildOutput(earlier, later) {
     const names = [...new Set([...Object.keys(earlier), ...Object.keys(later)])].toSorted();
     return names.find((name) => earlier[name] !== later[name]);
 }
-export function formatMisplacedNoCacheWarning(command) {
-    return (`⚠️ --no-cache after the command name is passed to \`${command}\`, not read by nmr. ` +
-        `Did you mean \`nmr --no-cache ${command}\`?`);
+export function formatMisplacedNoCacheWarning(command, style) {
+    return (`${STATUS_GLYPHS[style].warning.text} --no-cache after the command name is passed to \`${command}\`, ` +
+        `not read by nmr. Did you mean \`nmr --no-cache ${command}\`?`);
 }
 export function isCacheableCommand(checkCache, command) {
     return !isHookName(command) && checkCache?.enabled !== false && resolveCacheableCommands(checkCache).has(command);

package/dist/esm/cli-build.js

@@ -2,10 +2,13 @@ import { reportError } from '@williamthorsen/nmr-core';
 import { describeError } from '@williamthorsen/toolbelt.errors';
 import { buildPackage } from "./commands/build.js";
 import { loadWorkspaceConfig } from "./config.js";
+import { resolveBinStyles } from "./resolveBinStyles.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 }),
     });
 }

package/dist/esm/cli-clean.js

@@ -1,8 +1,10 @@
+import process from 'node:process';
 import { reportError } from '@williamthorsen/nmr-core';
 import { describeError } from '@williamthorsen/toolbelt.errors';
 import { runClean } from "./commands/clean.js";
+import { resolveBinStyles } from "./resolveBinStyles.js";
 try {
-    await runClean(process.cwd());
+    await runClean(process.cwd(), resolveBinStyles().stdout);
 }
 catch (error) {
     reportError(describeError(error));

package/dist/esm/cli-ensure-prepublish-hooks.js

@@ -1,6 +1,7 @@
 import { parseArgsOrExit, reportError } from '@williamthorsen/nmr-core';
 import { describeError } from '@williamthorsen/toolbelt.errors';
 import { DEFAULT_HOOK, ensurePrepublishHooks, reportPrepublishHooks } from "./commands/ensure-prepublish-hooks.js";
+import { resolveBinStyles } from "./resolveBinStyles.js";
 import { findMonorepoRoot } from "./workspace.js";
 const flagSchema = {
     fix: { long: '--fix', type: 'boolean' },
@@ -9,10 +10,11 @@ const flagSchema = {
 };
 const { fix, dryRun, command } = parseArgsOrExit(process.argv.slice(2), flagSchema).flags;
 try {
+    const { stdout } = resolveBinStyles();
     const monorepoRoot = findMonorepoRoot();
     const options = command ? { fix, dryRun, command } : { fix, dryRun };
     const result = ensurePrepublishHooks(monorepoRoot, options);
-    reportPrepublishHooks(result, command ?? DEFAULT_HOOK);
+    reportPrepublishHooks(result, command ?? DEFAULT_HOOK, stdout);
     if (result.hasFailures) {
         process.exitCode = 1;
     }

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

@@ -2,8 +2,9 @@ import process from 'node:process';
 import { reportError } from '@williamthorsen/nmr-core';
 import { describeError } from '@williamthorsen/toolbelt.errors';
 import { reportCatalog } from "./commands/report-catalog.js";
+import { resolveBinStyles } from "./resolveBinStyles.js";
 try {
-    reportCatalog(process.cwd());
+    reportCatalog(process.cwd(), resolveBinStyles().stderr);
 }
 catch (error) {
     reportError(describeError(error));

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

@@ -1,10 +1,11 @@
 import { reportError } from '@williamthorsen/nmr-core';
 import { describeError } from '@williamthorsen/toolbelt.errors';
 import { reportOverrides } from "./commands/report-overrides.js";
+import { resolveBinStyles } from "./resolveBinStyles.js";
 import { findMonorepoRoot } from "./workspace.js";
 try {
     const monorepoRoot = findMonorepoRoot();
-    reportOverrides(monorepoRoot);
+    reportOverrides(monorepoRoot, resolveBinStyles().stderr);
 }
 catch (error) {
     reportError(describeError(error));

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

@@ -1,3 +1,4 @@
+import { type OutputStyle } from '@williamthorsen/nmr-core';
 import { type BuildOptions } from './build-output.js';
 /**
  * The toolchain a build's emit comes from: the resolved compiler and the nmr running it. Both join the build
@@ -7,6 +8,10 @@ export interface BuildToolchain {
     compilerVersion: string;
     fingerprint: string;
 }
+/** What a build needs beyond its sources: the options shaping the emit, and the style it reports in. */
+export interface BuildPackageOptions extends BuildOptions {
+    style: OutputStyle;
+}
 /**
  * Compiles a package's `src` tree to `dist/esm` with the TypeScript compiler API, emitting `.js` and
  * `.d.ts` from two programs and rewriting relative `.ts` specifiers and tsconfig `paths` aliases to
@@ -17,7 +22,7 @@ export interface BuildToolchain {
  * current inputs rather than an accumulation of every build that ever ran. Assets belong outside it, or in a
  * `build:post` hook, which runs after the output is published.
  */
-export declare function buildPackage(packageDir: string, options?: BuildOptions): Promise<void>;
+export declare function buildPackage(packageDir: string, options: BuildPackageOptions): Promise<void>;
 /**
  * Produces a digest of the given files (paths and contents), the emit config, and the toolchain.
  * The file list is sorted so the digest is order-invariant, and each path is folded in so renames are detected.

package/dist/esm/commands/build.js

@@ -2,19 +2,18 @@ import { createHash } from 'node:crypto';
 import { existsSync } from 'node:fs';
 import { readFile, rename, rm } from 'node:fs/promises';
 import path from 'node:path';
-import { readCacheEntry, writeCacheEntry } from '@williamthorsen/nmr-core';
+import { formatGlyphLine, readCacheEntry, STATUS_GLYPHS, writeCacheEntry, } from '@williamthorsen/nmr-core';
 import { glob } from 'glob';
 import * as ts from 'typescript';
+import { NMR_GLYPHS } from "../glyphs.js";
 import { resolveConfigPath } from "../helpers/config-path.js";
 import { DEFAULT_ENTRY_GLOBS, DEFAULT_IGNORE_PATTERNS, DEFAULT_OUTDIR, hasExpectedBuildOutput, resolveBuildCachePath, resolveScratchDirs, resolveToolchainFingerprint, } from "./build-output.js";
-const PACKAGE_ICON = '📦';
-const SKIPPED_ICON = '⏭️';
 const SOURCE_ROOT = 'src';
 const MINIMUM_TYPESCRIPT_MAJOR = 5;
 const MINIMUM_TYPESCRIPT_MINOR = 7;
 const TS_EXTENSION = '.ts';
 const JS_EXTENSION = '.js';
-export async function buildPackage(packageDir, options = {}) {
+export async function buildPackage(packageDir, options) {
     assertSupportedTypeScript();
     const cachePath = resolveBuildCachePath(packageDir);
     const outdir = options.outdir ?? DEFAULT_OUTDIR;
@@ -34,14 +33,14 @@ export async function buildPackage(packageDir, options = {}) {
         compilerVersion: ts.version,
         fingerprint: await resolveToolchainFingerprint(packageDir),
     };
-    const { changed, currentHash } = await detectBuildChanges(packageDir, [...entryPoints, ...dependencies], emitConfig, toolchain, cachePath, hasExpectedBuildOutput(packageDir, outdir, entryPoints));
+    const { changed, currentHash } = await detectBuildChanges(packageDir, [...entryPoints, ...dependencies], emitConfig, toolchain, cachePath, hasExpectedBuildOutput(packageDir, outdir, entryPoints), options.style);
     if (!changed) {
         await discardScratchDirs(resolveScratchDirs(emitDir));
         return;
     }
     const emittedFileCount = await emitPackage(packageDir, entryPoints, outdir);
     await writeCacheEntry(cachePath, currentHash);
-    console.info(`${PACKAGE_ICON} ${path.basename(packageDir)}: ${describeEmit(emittedFileCount, outdir)}`);
+    console.info(formatGlyphLine(NMR_GLYPHS, options.style, 'package', `${path.basename(packageDir)}: ${describeEmit(emittedFileCount, outdir)}`));
 }
 export async function computeBuildHash(packageDir, files, emitConfig, toolchain) {
     const hash = createHash('sha256');
@@ -275,19 +274,19 @@ function getModuleSpecifier(node) {
     }
     return undefined;
 }
-async function detectBuildChanges(packageDir, files, emitConfig, toolchain, cachePath, outputPresent) {
+async function detectBuildChanges(packageDir, files, emitConfig, toolchain, cachePath, outputPresent, style) {
     const packageName = path.basename(packageDir);
     const previousHash = await readCacheEntry(cachePath);
     const currentHash = await computeBuildHash(packageDir, files, emitConfig, toolchain);
     if (previousHash === currentHash) {
         if (outputPresent) {
-            console.info(`${SKIPPED_ICON} ${packageName}: No changes detected. Skipping build.`);
+            console.info(`${STATUS_GLYPHS[style].skipped.text} ${packageName}: No changes detected. Skipping build.`);
             return { changed: false, currentHash };
         }
-        console.info(`${PACKAGE_ICON} ${packageName}: Build output is missing. Rebuilding.`);
+        console.info(formatGlyphLine(NMR_GLYPHS, style, 'package', `${packageName}: Build output is missing. Rebuilding.`));
         return { changed: true, currentHash };
     }
-    console.info(`${PACKAGE_ICON} ${packageName}: Changes detected.`);
+    console.info(formatGlyphLine(NMR_GLYPHS, style, 'package', `${packageName}: Changes detected.`));
     return { changed: true, currentHash };
 }
 function assertSupportedTypeScript() {

package/dist/esm/commands/clean.d.ts

@@ -1,8 +1,9 @@
+import { type OutputStyle } from '@williamthorsen/nmr-core';
 /**
  * Removes a package's build output and the build-cache entry that describes it, so no state survives to
  * make the next build skip. Removal is idempotent: an already-clean package is a silent no-op.
  */
-export declare function cleanPackage(packageDir: string): Promise<void>;
+export declare function cleanPackage(packageDir: string, style: OutputStyle): Promise<void>;
 /**
  * Cleans the package containing `cwd`, or every workspace package when run from the monorepo root.
  *
@@ -14,4 +15,4 @@ export declare function cleanPackage(packageDir: string): Promise<void>;
  * a `rimraf` in nmr's dependency tree would be unreachable — while nmr's own bins are linked into the
  * consumer's `node_modules/.bin`, nmr being a direct dependency.
  */
-export declare function runClean(cwd?: string): Promise<void>;
+export declare function runClean(cwd: string, style: OutputStyle): Promise<void>;

package/dist/esm/commands/clean.js

@@ -1,52 +1,53 @@
 import { rm } from 'node:fs/promises';
 import path from 'node:path';
+import { formatGlyphLine } from '@williamthorsen/nmr-core';
 import { removeCheckCache } from "../check-cache.js";
 import { loadRootConfig } from "../config.js";
 import { findContainingPackageDir } from "../context.js";
+import { NMR_GLYPHS } from "../glyphs.js";
 import { reportClosing } from "../helpers/reportClosing.js";
 import { applyDevBin, buildWorkspaceRegistry, resolveScript } from "../resolver.js";
 import { resolveChannel, runCommand } from "../runner.js";
 import { renderChain } from "../steps.js";
 import { findMonorepoRoot, getWorkspacePackageDirs } from "../workspace.js";
 import { resolveBuildCachePath } from "./build-output.js";
-const CLEAN_ICON = '🧹';
 const CLEAN_COMMAND = 'clean';
 const BUILT_IN_CLEAN = 'nmr-clean';
 const OUTPUT_ROOT = 'dist';
-export async function cleanPackage(packageDir) {
+export async function cleanPackage(packageDir, style) {
     await rm(path.resolve(packageDir, OUTPUT_ROOT), { recursive: true, force: true });
     await rm(resolveBuildCachePath(packageDir), { force: true });
-    console.info(`${CLEAN_ICON} ${path.basename(packageDir)}: Removed build output and cache.`);
+    console.info(formatGlyphLine(NMR_GLYPHS, style, 'clean', `${path.basename(packageDir)}: Removed build output and cache.`));
 }
-export async function runClean(cwd = process.cwd()) {
+export async function runClean(cwd, style) {
     let monorepoRoot;
     try {
         monorepoRoot = findMonorepoRoot(cwd);
     }
     catch {
-        await clearCheckCache(cwd);
-        await cleanPackage(cwd);
+        await clearCheckCache(cwd, style);
+        await cleanPackage(cwd, style);
         return;
     }
-    await clearCheckCache(monorepoRoot);
+    await clearCheckCache(monorepoRoot, style);
     const workspacePackageDirs = getWorkspacePackageDirs(monorepoRoot);
     const packageDir = findContainingPackageDir(cwd, workspacePackageDirs);
     if (packageDir !== undefined) {
-        await cleanPackage(packageDir);
+        await cleanPackage(packageDir, style);
         return;
     }
-    await sweepWorkspace(monorepoRoot, workspacePackageDirs);
+    await sweepWorkspace(monorepoRoot, workspacePackageDirs, style);
 }
-async function clearCheckCache(scopeDir) {
+async function clearCheckCache(scopeDir, style) {
     await removeCheckCache(scopeDir);
-    console.info(`${CLEAN_ICON} Removed all recorded check results.`);
+    console.info(formatGlyphLine(NMR_GLYPHS, style, 'clean', 'Removed all recorded check results.'));
 }
 function describeSweep(cleaned, skipped) {
     const packages = cleaned === 1 ? '1 package' : `${cleaned} packages`;
     const skipClause = skipped === 0 ? '' : `, skipping ${skipped} with an empty clean override`;
     return `Cleaned ${packages}${skipClause}.`;
 }
-async function sweepWorkspace(monorepoRoot, workspacePackageDirs) {
+async function sweepWorkspace(monorepoRoot, workspacePackageDirs, style) {
     const config = await loadRootConfig(monorepoRoot);
     const registry = buildWorkspaceRegistry(config);
     let cleaned = 0;
@@ -59,7 +60,7 @@ async function sweepWorkspace(monorepoRoot, workspacePackageDirs) {
             continue;
         }
         if (resolvedCommand === BUILT_IN_CLEAN) {
-            await cleanPackage(packageDir);
+            await cleanPackage(packageDir, style);
             cleaned++;
             continue;
         }
@@ -72,5 +73,5 @@ async function sweepWorkspace(monorepoRoot, workspacePackageDirs) {
         }
         cleaned++;
     }
-    reportClosing(`${CLEAN_ICON} ${describeSweep(cleaned, skipped)}`);
+    reportClosing(formatGlyphLine(NMR_GLYPHS, style, 'clean', describeSweep(cleaned, skipped)));
 }

package/dist/esm/commands/ensure-prepublish-hooks.d.ts

@@ -1,3 +1,4 @@
+import { type OutputStyle } from '@williamthorsen/nmr-core';
 export interface PackageHookStatus {
     packageName: string;
     packageDir: string;
@@ -23,7 +24,7 @@ export declare function ensurePrepublishHooks(monorepoRoot: string, options: {
  * Reports one line per publishable package and closes with what the run came to. Private packages appear in
  * neither: they publish nothing, so a `prepublishOnly` is not theirs to carry.
  *
- * Every line goes to stdout, the `✗` included, and the exit code is what carries a failure. A report split
+ * Every line goes to stdout, a failure's included, and the exit code is what carries a failure. A report split
  * across two streams leaves no reader holding the whole list.
  */
-export declare function reportPrepublishHooks(result: EnsurePrepublishHooksResult, hookCommand: string): void;
+export declare function reportPrepublishHooks(result: EnsurePrepublishHooksResult, hookCommand: string, style: OutputStyle): void;