@williamthorsen/nmr 0.54.0 → 0.55.0

package/.meta/changelog.json

@@ -1,4 +1,69 @@
 [
+  {
+    "version": "0.55.0",
+    "date": "2026-11-06",
+    "sections": [
+      {
+        "title": "🎉 Features",
+        "audience": "all",
+        "items": [
+          {
+            "description": "Adds the built-in root command `lint:shell`, which runs the new `nmr-shellcheck` bin to lint every tracked `*.sh` file with nmr's pinned shellcheck and passes without downloading shellcheck when the repo does not track any. (#1161)",
+            "hash": "d5cb485398fbc00f81b5533bd8c71033d81e6026",
+            "entry": 1
+          },
+          {
+            "description": "Adds a warning to nmr's readyup kit that reports a `lint:shell` entry in `.config/nmr.config.ts`, which overrides the built-in command, and directs the repo to delete the entry. (#1161)",
+            "hash": "d5cb485398fbc00f81b5533bd8c71033d81e6026",
+            "entry": 2
+          }
+        ]
+      },
+      {
+        "title": "🐛 Bug fixes",
+        "audience": "all",
+        "items": [
+          {
+            "description": "Adopt the crash convention in release-kit (#1158)",
+            "body": "Makes `release-kit` report a bug in its own code as `release-kit: internal error: <message>` followed by the stack, rather than as the `Error: <message>` line that it keeps for a failure in the user's input, config, or environment. The same change makes `nmr` and `v11y-check` print a Node system error, such as `EACCES` or `ENOENT`, as `Error: <message>` rather than as an internal error.",
+            "hash": "3a62cc768b23f37156c846f32fd4acaa70f7f931"
+          }
+        ]
+      }
+    ]
+  },
+  {
+    "version": "0.54.1",
+    "date": "2026-11-05",
+    "sections": [
+      {
+        "title": "🐛 Bug fixes",
+        "audience": "all",
+        "items": [
+          {
+            "description": "Fixes the issue that `pnpm add` failed when an install hook such as `postinstall` ran an nmr command delegated by `NMR_DELEGATE` or the user config, because the host's frozen install rejected a manifest that was ahead of its lockfile, by making nmr run such a command on this machine unless `--delegate` or `--delegate-to` is passed. (#1151)",
+            "hash": "0037919912a86b9bf927e1afccf079956d6c2968",
+            "entry": 1
+          },
+          {
+            "description": "Fixes the issue that `nmr` printed an unexpected crash as its raw stack, whose first line, `Error: <message>`, read the same as a handled error; it now prints `nmr: internal error: <message>` followed by the stack frames, and still prints an error caused by the user's own config as `Error: <message>`. (#1153)",
+            "hash": "0289c032b00438984efcf7466f2b3055b4dbc546",
+            "entry": 1
+          },
+          {
+            "description": "Fixes the issue that the `nmr` sub-bins, such as `nmr-compile` and `nmr-fmt`, and the `v11y` subcommands reported an unexpected crash as a handled `Error: <message>` line, rather than as `<bin>: internal error: <message>` with its stack frames. (#1157)",
+            "hash": "ef1ed5f50bf0b01f19b6d6fe82a40322a8286002",
+            "entry": 1
+          },
+          {
+            "description": "Fixes the issue that the bin scripts of `nmr`, `release-kit`, and `v11y-check` reported every error other than missing build output as `<bin>: failed to load: <message>` without a stack, which hid where the fault occurred. (#1157)",
+            "hash": "ef1ed5f50bf0b01f19b6d6fe82a40322a8286002",
+            "entry": 2
+          }
+        ]
+      }
+    ]
+  },
   {
     "version": "0.54.0",
     "date": "2026-10-31",

package/.readyup/kits/default.js

@@ -1,6 +1,6 @@
 /** @noformat -- @generated. Do not edit. Compiled by rdy. */
 /* eslint-disable */
-export const __readyupVersion = "0.44.0";
+export const __readyupVersion = "0.45.0";
 import { createRequire as __rdyCreateRequire } from 'node:module';
 const require = __rdyCreateRequire(import.meta.url);
 
@@ -7691,6 +7691,7 @@ function buildRootScripts(workspaceGlobs) {
     "fmt:check": "nmr-fmt --check",
     lint: "eslint --fix .",
     "lint:check": "eslint .",
+    "lint:shell": "nmr-shellcheck",
     "lint:strict": "strict-lint",
     "lint:workflows": "nmr-actionlint",
     // The audit takes seconds and `ci` takes minutes, so the cheap gate fails first. The audit reads the
@@ -7829,10 +7830,15 @@ function readWorkspaceManifest(monorepoRoot) {
   }
 }
 
-// src/UserError.ts
+// ../nmr-core/dist/esm/hasErrnoCode.js
+function hasErrnoCode(error, code) {
+  return isError(error) && "code" in error && error.code === code;
+}
+
+// ../nmr-core/dist/esm/UserError.js
 var UserError = class extends Error {
-  constructor(message) {
-    super(message);
+  constructor(message, options) {
+    super(message, options);
     this.name = "UserError";
   }
 };
@@ -7875,6 +7881,8 @@ var INSTALL_LIFECYCLE_SCRIPTS = [
 ];
 var LEFTHOOK_CHECK_INSTALL_PATTERN = /\blefthook\s+check-install\b/;
 var LEFTHOOK_INSTALL_PATTERN = /\blefthook\s+install\b/;
+var LINT_SHELL_KEY_PATTERN = /['"]lint:shell['"]\s*:/;
+var NMR_CONFIG_PATH = ".config/nmr.config.ts";
 var rootScriptChecks = [
   {
     name: "root package.json has no nmr-provided scripts",
@@ -7882,6 +7890,13 @@ var rootScriptChecks = [
     quiet: true,
     check: noRedundantRootScripts,
     fix: "Remove scripts from root package.json that nmr provides as built-in root scripts, and invoke them through nmr directly"
+  },
+  {
+    name: ".config/nmr.config.ts does not override lint:shell",
+    severity: "warn",
+    quiet: true,
+    check: () => noLintShellOverride(),
+    fix: "Delete the `lint:shell` entry from `rootScripts` in .config/nmr.config.ts, because nmr provides `lint:shell` as a built-in root command that passes when the repo does not track any shell script"
   }
 ];
 var gitHookChecks = [
@@ -7909,6 +7924,11 @@ var legacyRunnerChecks = [
     fix: 'Remove "ws" script entries and replace any "pnpm run ws" invocations with nmr in each packages/*/package.json'
   }
 ];
+function noLintShellOverride(cwd = process.cwd()) {
+  const content = readFileIn(cwd, NMR_CONFIG_PATH);
+  if (content === void 0 || !LINT_SHELL_KEY_PATTERN.test(content)) return true;
+  return { ok: false, detail: `${NMR_CONFIG_PATH}: rootScripts.lint:shell` };
+}
 function noUnguardedLefthookInstall(cwd = process.cwd()) {
   const scripts = readRootScripts(cwd);
   const unguardedScripts = INSTALL_LIFECYCLE_SCRIPTS.flatMap((name) => {
@@ -8026,11 +8046,6 @@ function isHookName(key) {
 // src/resolver.ts
 import { readFileSync as readFileSync2 } from "node:fs";
 
-// ../nmr-core/dist/esm/hasErrnoCode.js
-function hasErrnoCode(error, code) {
-  return isError(error) && "code" in error && error.code === code;
-}
-
 // src/helpers/package-json.ts
 import path5 from "node:path";
 
@@ -9190,7 +9205,7 @@ function hasSupportedStrictLintVersion() {
   });
 }
 function getMinVersion() {
-  const pickedFields = { "version": "0.54.0" };
+  const pickedFields = { "version": "0.55.0" };
   if (typeof pickedFields["version"] !== "string") {
     throw new TypeError("nmr/package.json: 'version' must be a string");
   }

package/.readyup/manifest.json

@@ -27,7 +27,7 @@
           "checklist": "nmr",
           "checks": [
             "@williamthorsen/nmr in devDependencies",
-            "@williamthorsen/nmr >= 0.54.0",
+            "@williamthorsen/nmr >= 0.55.0",
             "pnpm-workspace.yaml exists",
             "catalogued dependencies use catalog:",
             "package.json has packageManager field",
@@ -38,6 +38,7 @@
             "eslint >= 10.0.0",
             "@williamthorsen/strict-lint >= 9.3.0",
             "root package.json has no nmr-provided scripts",
+            ".config/nmr.config.ts does not override lint:shell",
             "no root install script runs lefthook install unguarded",
             "all workspace packages can build",
             "every bin target is a committed wrapper",
@@ -89,7 +90,7 @@
           "path": "../../nmr-core/dist/esm/gitObjects.js"
         },
         {
-          "hash": "14216f5f",
+          "hash": "d5a89448",
           "kind": "module",
           "path": "../../nmr-core/dist/esm/gitOutputLimit.js"
         },
@@ -109,12 +110,17 @@
           "path": "../../nmr-core/dist/esm/helpers/workspace-patterns.js"
         },
         {
-          "hash": "dcd24627",
+          "hash": "76923c93",
           "kind": "module",
           "path": "../../nmr-core/dist/esm/index.js"
         },
         {
-          "hash": "a2053951",
+          "hash": "85d76864",
+          "kind": "module",
+          "path": "../../nmr-core/dist/esm/isAnticipatedFailure.js"
+        },
+        {
+          "hash": "de51ceb3",
           "kind": "module",
           "path": "../../nmr-core/dist/esm/parseArgs.js"
         },
@@ -124,7 +130,7 @@
           "path": "../../nmr-core/dist/esm/runGit.js"
         },
         {
-          "hash": "46b44e18",
+          "hash": "01ad20df",
           "kind": "module",
           "path": "../../nmr-core/dist/esm/terminal.js"
         },
@@ -138,6 +144,11 @@
           "kind": "module",
           "path": "../../nmr-core/dist/esm/updateManagedFile.js"
         },
+        {
+          "hash": "e02e0a74",
+          "kind": "module",
+          "path": "../../nmr-core/dist/esm/UserError.js"
+        },
         {
           "hash": "00d00fae",
           "kind": "module",
@@ -179,7 +190,7 @@
           "path": "lib/repo-files.ts"
         },
         {
-          "hash": "2a90a1d3",
+          "hash": "a62f92eb",
           "kind": "module",
           "path": "lib/root-scripts.ts"
         },
@@ -209,7 +220,7 @@
           "path": "lib/workspace-build.ts"
         },
         {
-          "hash": "79b213aa",
+          "hash": "f22b8da5",
           "kind": "inline",
           "path": "../package.json",
           "paths": [
@@ -217,22 +228,22 @@
           ]
         },
         {
-          "hash": "19b57f2e",
+          "hash": "578af9fd",
           "kind": "module",
           "path": "../src/config-check-cache.ts"
         },
         {
-          "hash": "2cfe8c2e",
+          "hash": "fa9330c5",
           "kind": "module",
           "path": "../src/config-validation.ts"
         },
         {
-          "hash": "5b589c7e",
+          "hash": "4240e226",
           "kind": "module",
           "path": "../src/config.ts"
         },
         {
-          "hash": "b8e98c81",
+          "hash": "463c7bbd",
           "kind": "module",
           "path": "../src/default-scripts.ts"
         },
@@ -262,7 +273,7 @@
           "path": "../src/helpers/hook-name.ts"
         },
         {
-          "hash": "8850834f",
+          "hash": "7fb6c09d",
           "kind": "module",
           "path": "../src/helpers/package-json.ts"
         },
@@ -301,11 +312,6 @@
           "kind": "module",
           "path": "../src/tiers.ts"
         },
-        {
-          "hash": "faad986a",
-          "kind": "module",
-          "path": "../src/UserError.ts"
-        },
         {
           "hash": "ecf8a873",
           "kind": "module",
@@ -317,17 +323,17 @@
           "path": "../src/workspace-globs.ts"
         },
         {
-          "hash": "922e7155",
+          "hash": "770e4f3a",
           "kind": "module",
           "path": "../src/workspace.ts"
         }
       ],
       "name": "default",
       "path": "kits/default.js",
-      "readyupVersion": "0.44.0",
+      "readyupVersion": "0.45.0",
       "source": "kits/default.ts",
       "sourceHash": "9fd61bf4",
-      "targetHash": "5689b2d3"
+      "targetHash": "6eb9c2b5"
     }
   ]
 }

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 All notable changes to this project will be documented in this file.
 
+## 0.55.0 — 2026-11-06
+
+### 🎉 Features
+
+- Adds the built-in root command `lint:shell`, which runs the new `nmr-shellcheck` bin to lint every tracked `*.sh` file with nmr's pinned shellcheck and passes without downloading shellcheck when the repo does not track any. (#1161)
+- Adds a warning to nmr's readyup kit that reports a `lint:shell` entry in `.config/nmr.config.ts`, which overrides the built-in command, and directs the repo to delete the entry. (#1161)
+
+### 🐛 Bug fixes
+
+- Adopt the crash convention in release-kit (#1158)
+
+  Makes `release-kit` report a bug in its own code as `release-kit: internal error: <message>` followed by the stack, rather than as the `Error: <message>` line that it keeps for a failure in the user's input, config, or environment. The same change makes `nmr` and `v11y-check` print a Node system error, such as `EACCES` or `ENOENT`, as `Error: <message>` rather than as an internal error.
+
+## 0.54.1 — 2026-11-05
+
+### 🐛 Bug fixes
+
+- Fixes the issue that `pnpm add` failed when an install hook such as `postinstall` ran an nmr command delegated by `NMR_DELEGATE` or the user config, because the host's frozen install rejected a manifest that was ahead of its lockfile, by making nmr run such a command on this machine unless `--delegate` or `--delegate-to` is passed. (#1151)
+- Fixes the issue that `nmr` printed an unexpected crash as its raw stack, whose first line, `Error: <message>`, read the same as a handled error; it now prints `nmr: internal error: <message>` followed by the stack frames, and still prints an error caused by the user's own config as `Error: <message>`. (#1153)
+- Fixes the issue that the `nmr` sub-bins, such as `nmr-compile` and `nmr-fmt`, and the `v11y` subcommands reported an unexpected crash as a handled `Error: <message>` line, rather than as `<bin>: internal error: <message>` with its stack frames. (#1157)
+- Fixes the issue that the bin scripts of `nmr`, `release-kit`, and `v11y-check` reported every error other than missing build output as `<bin>: failed to load: <message>` without a stack, which hid where the fault occurred. (#1157)
+
 ## 0.54.0 — 2026-10-31
 
 ### 🎉 Features

package/README.md

@@ -5,11 +5,18 @@
 Context-aware script runner for pnpm monorepos. Includes an `nmr` (node-monorepo run) binary that provides centralized, consistent script execution across workspace packages and the monorepo root.
 
 <!-- section:release-notes -->
-## Release notes — v0.54.0 (2026-10-31)
+## Release notes — v0.55.0 (2026-11-06)
 
 ### 🎉 Features
 
-- Adds a check of the `nodejs` pin in `.tool-versions` to `nmr upgrade`, which reports the newest release at least 24 hours old in the pin's major line and, under `--write`, rewrites the pin to it. (#1141)
+- Adds the built-in root command `lint:shell`, which runs the new `nmr-shellcheck` bin to lint every tracked `*.sh` file with nmr's pinned shellcheck and passes without downloading shellcheck when the repo does not track any. (#1161)
+- Adds a warning to nmr's readyup kit that reports a `lint:shell` entry in `.config/nmr.config.ts`, which overrides the built-in command, and directs the repo to delete the entry. (#1161)
+
+### 🐛 Bug fixes
+
+- Adopt the crash convention in release-kit (#1158)
+
+  Makes `release-kit` report a bug in its own code as `release-kit: internal error: <message>` followed by the stack, rather than as the `Error: <message>` line that it keeps for a failure in the user's input, config, or environment. The same change makes `nmr` and `v11y-check` print a Node system error, such as `EACCES` or `ENOENT`, as `Error: <message>` rather than as an internal error.
 <!-- /section:release-notes -->
 
 ## Installation
@@ -316,7 +323,7 @@ rdy list --from npm:@williamthorsen/nmr  # what nmr publishes
 - [Machine lock](docs/machine-lock.md): Which commands wait for one another, where the lock lives, and bypassing it
 - [Delegating to another machine](docs/delegate.md): The user config, `--delegate`, `--delegate-to`, `NMR_DELEGATE`, where a command runs, choosing among several hosts, what the host runs, and setting it up
 - [Dependency upgrades](docs/upgrades.md): `nmr upgrade`, the upgrade policy, the Node version pin, `report-catalog`, `report-overrides`, and `nmr-taze`
-- [Standalone utilities](docs/utilities.md): `nmr-actionlint`, `nmr-clean`, `nmr-compile`, `nmr-fmt`, `nmr-vitest`, and `ensure-prepublish-hooks`
+- [Standalone utilities](docs/utilities.md): `nmr-actionlint`, `nmr-clean`, `nmr-compile`, `nmr-fmt`, `nmr-shellcheck`, `nmr-vitest`, and `ensure-prepublish-hooks`
 - [Shared Vitest config](docs/vitest.md): Test tiers, test selections, the conventions check, and customization
 - [Shared Prettier config](docs/prettier.md): What it formats and how to customize it
 - [Workspace introspection](docs/workspace.md): The two workspace lookups

package/bin/ensure-prepublish-hooks.js

@@ -2,10 +2,14 @@
 try {
   await import('../dist/esm/cli-ensure-prepublish-hooks.js');
 } catch (error) {
-  if (error.code === 'ERR_MODULE_NOT_FOUND') {
+  if (error?.code === 'ERR_MODULE_NOT_FOUND') {
     process.stderr.write('ensure-prepublish-hooks: build output not found; run `pnpm run bootstrap` first\n');
   } else {
-    process.stderr.write(`ensure-prepublish-hooks: failed to load: ${error.message}\n`);
+    const message = typeof error?.message === 'string' && error.message !== '' ? error.message : String(error);
+    const lines = typeof error?.stack === 'string' ? error.stack.split('\n') : [];
+    const firstFrame = lines.findIndex((line) => /^\s+at /.test(line));
+    const frames = firstFrame === -1 ? '' : `${lines.slice(firstFrame).join('\n')}\n`;
+    process.stderr.write(`ensure-prepublish-hooks: internal error: ${message}\n${frames}`);
   }
   process.exit(1);
 }

package/bin/nmr-actionlint.js

@@ -2,10 +2,14 @@
 try {
   await import('../dist/esm/cli-actionlint.js');
 } catch (error) {
-  if (error.code === 'ERR_MODULE_NOT_FOUND') {
+  if (error?.code === 'ERR_MODULE_NOT_FOUND') {
     process.stderr.write('nmr-actionlint: build output not found; run `pnpm run bootstrap` first\n');
   } else {
-    process.stderr.write(`nmr-actionlint: failed to load: ${error.message}\n`);
+    const message = typeof error?.message === 'string' && error.message !== '' ? error.message : String(error);
+    const lines = typeof error?.stack === 'string' ? error.stack.split('\n') : [];
+    const firstFrame = lines.findIndex((line) => /^\s+at /.test(line));
+    const frames = firstFrame === -1 ? '' : `${lines.slice(firstFrame).join('\n')}\n`;
+    process.stderr.write(`nmr-actionlint: internal error: ${message}\n${frames}`);
   }
   process.exit(1);
 }

package/bin/nmr-clean.js

@@ -2,10 +2,14 @@
 try {
   await import('../dist/esm/cli-clean.js');
 } catch (error) {
-  if (error.code === 'ERR_MODULE_NOT_FOUND') {
+  if (error?.code === 'ERR_MODULE_NOT_FOUND') {
     process.stderr.write('nmr-clean: build output not found; run `pnpm run bootstrap` first\n');
   } else {
-    process.stderr.write(`nmr-clean: failed to load: ${error.message}\n`);
+    const message = typeof error?.message === 'string' && error.message !== '' ? error.message : String(error);
+    const lines = typeof error?.stack === 'string' ? error.stack.split('\n') : [];
+    const firstFrame = lines.findIndex((line) => /^\s+at /.test(line));
+    const frames = firstFrame === -1 ? '' : `${lines.slice(firstFrame).join('\n')}\n`;
+    process.stderr.write(`nmr-clean: internal error: ${message}\n${frames}`);
   }
   process.exit(1);
 }

package/bin/nmr-compile.js

@@ -2,10 +2,14 @@
 try {
   await import('../dist/esm/cli-build.js');
 } catch (error) {
-  if (error.code === 'ERR_MODULE_NOT_FOUND') {
+  if (error?.code === 'ERR_MODULE_NOT_FOUND') {
     process.stderr.write('nmr-compile: build output not found; run `pnpm run bootstrap` first\n');
   } else {
-    process.stderr.write(`nmr-compile: failed to load: ${error.message}\n`);
+    const message = typeof error?.message === 'string' && error.message !== '' ? error.message : String(error);
+    const lines = typeof error?.stack === 'string' ? error.stack.split('\n') : [];
+    const firstFrame = lines.findIndex((line) => /^\s+at /.test(line));
+    const frames = firstFrame === -1 ? '' : `${lines.slice(firstFrame).join('\n')}\n`;
+    process.stderr.write(`nmr-compile: internal error: ${message}\n${frames}`);
   }
   process.exit(1);
 }

package/bin/nmr-fmt.js

@@ -2,10 +2,14 @@
 try {
   await import('../dist/esm/cli-fmt.js');
 } catch (error) {
-  if (error.code === 'ERR_MODULE_NOT_FOUND') {
+  if (error?.code === 'ERR_MODULE_NOT_FOUND') {
     process.stderr.write('nmr-fmt: build output not found; run `pnpm run bootstrap` first\n');
   } else {
-    process.stderr.write(`nmr-fmt: failed to load: ${error.message}\n`);
+    const message = typeof error?.message === 'string' && error.message !== '' ? error.message : String(error);
+    const lines = typeof error?.stack === 'string' ? error.stack.split('\n') : [];
+    const firstFrame = lines.findIndex((line) => /^\s+at /.test(line));
+    const frames = firstFrame === -1 ? '' : `${lines.slice(firstFrame).join('\n')}\n`;
+    process.stderr.write(`nmr-fmt: internal error: ${message}\n${frames}`);
   }
   process.exit(1);
 }

package/bin/nmr-report-catalog.js

@@ -2,10 +2,14 @@
 try {
   await import('../dist/esm/cli-report-catalog.js');
 } catch (error) {
-  if (error.code === 'ERR_MODULE_NOT_FOUND') {
+  if (error?.code === 'ERR_MODULE_NOT_FOUND') {
     process.stderr.write('nmr-report-catalog: build output not found; run `pnpm run bootstrap` first\n');
   } else {
-    process.stderr.write(`nmr-report-catalog: failed to load: ${error.message}\n`);
+    const message = typeof error?.message === 'string' && error.message !== '' ? error.message : String(error);
+    const lines = typeof error?.stack === 'string' ? error.stack.split('\n') : [];
+    const firstFrame = lines.findIndex((line) => /^\s+at /.test(line));
+    const frames = firstFrame === -1 ? '' : `${lines.slice(firstFrame).join('\n')}\n`;
+    process.stderr.write(`nmr-report-catalog: internal error: ${message}\n${frames}`);
   }
   process.exit(1);
 }

package/bin/nmr-report-overrides.js

@@ -2,10 +2,14 @@
 try {
   await import('../dist/esm/cli-report-overrides.js');
 } catch (error) {
-  if (error.code === 'ERR_MODULE_NOT_FOUND') {
+  if (error?.code === 'ERR_MODULE_NOT_FOUND') {
     process.stderr.write('nmr-report-overrides: build output not found; run `pnpm run bootstrap` first\n');
   } else {
-    process.stderr.write(`nmr-report-overrides: failed to load: ${error.message}\n`);
+    const message = typeof error?.message === 'string' && error.message !== '' ? error.message : String(error);
+    const lines = typeof error?.stack === 'string' ? error.stack.split('\n') : [];
+    const firstFrame = lines.findIndex((line) => /^\s+at /.test(line));
+    const frames = firstFrame === -1 ? '' : `${lines.slice(firstFrame).join('\n')}\n`;
+    process.stderr.write(`nmr-report-overrides: internal error: ${message}\n${frames}`);
   }
   process.exit(1);
 }

package/bin/nmr-shellcheck.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+try {
+  await import('../dist/esm/cli-shellcheck.js');
+} catch (error) {
+  if (error?.code === 'ERR_MODULE_NOT_FOUND') {
+    process.stderr.write('nmr-shellcheck: build output not found; run `pnpm run bootstrap` first\n');
+  } else {
+    const message = typeof error?.message === 'string' && error.message !== '' ? error.message : String(error);
+    const lines = typeof error?.stack === 'string' ? error.stack.split('\n') : [];
+    const firstFrame = lines.findIndex((line) => /^\s+at /.test(line));
+    const frames = firstFrame === -1 ? '' : `${lines.slice(firstFrame).join('\n')}\n`;
+    process.stderr.write(`nmr-shellcheck: internal error: ${message}\n${frames}`);
+  }
+  process.exit(1);
+}

package/bin/nmr-taze.js

@@ -2,10 +2,14 @@
 try {
   await import('../dist/esm/cli-taze.js');
 } catch (error) {
-  if (error.code === 'ERR_MODULE_NOT_FOUND') {
+  if (error?.code === 'ERR_MODULE_NOT_FOUND') {
     process.stderr.write('nmr-taze: build output not found; run `pnpm run bootstrap` first\n');
   } else {
-    process.stderr.write(`nmr-taze: failed to load: ${error.message}\n`);
+    const message = typeof error?.message === 'string' && error.message !== '' ? error.message : String(error);
+    const lines = typeof error?.stack === 'string' ? error.stack.split('\n') : [];
+    const firstFrame = lines.findIndex((line) => /^\s+at /.test(line));
+    const frames = firstFrame === -1 ? '' : `${lines.slice(firstFrame).join('\n')}\n`;
+    process.stderr.write(`nmr-taze: internal error: ${message}\n${frames}`);
   }
   process.exit(1);
 }

package/bin/nmr-vitest.js

@@ -2,10 +2,14 @@
 try {
   await import('../dist/esm/cli-vitest.js');
 } catch (error) {
-  if (error.code === 'ERR_MODULE_NOT_FOUND') {
+  if (error?.code === 'ERR_MODULE_NOT_FOUND') {
     process.stderr.write('nmr-vitest: build output not found; run `pnpm run bootstrap` first\n');
   } else {
-    process.stderr.write(`nmr-vitest: failed to load: ${error.message}\n`);
+    const message = typeof error?.message === 'string' && error.message !== '' ? error.message : String(error);
+    const lines = typeof error?.stack === 'string' ? error.stack.split('\n') : [];
+    const firstFrame = lines.findIndex((line) => /^\s+at /.test(line));
+    const frames = firstFrame === -1 ? '' : `${lines.slice(firstFrame).join('\n')}\n`;
+    process.stderr.write(`nmr-vitest: internal error: ${message}\n${frames}`);
   }
   process.exit(1);
 }

package/bin/nmr.js

@@ -2,10 +2,14 @@
 try {
   await import('../dist/esm/cli.js');
 } catch (error) {
-  if (error.code === 'ERR_MODULE_NOT_FOUND') {
+  if (error?.code === 'ERR_MODULE_NOT_FOUND') {
     process.stderr.write('nmr: build output not found; run `pnpm run bootstrap` first\n');
   } else {
-    process.stderr.write(`nmr: failed to load: ${error.message}\n`);
+    const message = typeof error?.message === 'string' && error.message !== '' ? error.message : String(error);
+    const lines = typeof error?.stack === 'string' ? error.stack.split('\n') : [];
+    const firstFrame = lines.findIndex((line) => /^\s+at /.test(line));
+    const frames = firstFrame === -1 ? '' : `${lines.slice(firstFrame).join('\n')}\n`;
+    process.stderr.write(`nmr: internal error: ${message}\n${frames}`);
   }
   process.exit(1);
 }

package/dist/esm/check-cache.js

@@ -10,6 +10,7 @@ export const DEFAULT_CACHEABLE_COMMANDS = [
     'fix:check',
     'fmt:check',
     'lint:check',
+    'lint:shell',
     'lint:strict',
     'lint:workflows',
     'root:check',

package/dist/esm/child-process.js

@@ -4,7 +4,7 @@ import process from 'node:process';
 import { reportError } from '@williamthorsen/nmr-core';
 import { createBoundedBuffer } from "./helpers/createBoundedBuffer.js";
 const SIGNAL_EXIT_BASE = 128;
-const PIPE_DRAIN_GRACE_MS = 2_000;
+const PIPE_DRAIN_GRACE_MS = 2000;
 export function describeSignalExitCode(signal) {
     return SIGNAL_EXIT_BASE + os.constants.signals[signal];
 }

package/dist/esm/cli-actionlint.js

@@ -1,12 +1,11 @@
 import process from 'node:process';
-import { reportError } from '@williamthorsen/nmr-core';
-import { describeError } from '@williamthorsen/toolbelt.errors';
+import { reportFailure } from '@williamthorsen/nmr-core';
 import { runActionlint } from "./commands/actionlint.js";
 import { findMonorepoRoot } from "./workspace.js";
 try {
     process.exitCode = await runActionlint(findMonorepoRoot(), process.argv.slice(2));
 }
 catch (error) {
-    reportError(describeError(error));
+    reportFailure('nmr-actionlint', error);
     process.exitCode = 1;
 }

package/dist/esm/cli-build.js

@@ -1,5 +1,4 @@
-import { reportError } from '@williamthorsen/nmr-core';
-import { describeError } from '@williamthorsen/toolbelt.errors';
+import { reportFailure } from '@williamthorsen/nmr-core';
 import { buildPackage } from "./commands/build.js";
 import { loadWorkspaceConfig } from "./config.js";
 import { resolveBinStyles } from "./resolveBinStyles.js";
@@ -13,6 +12,6 @@ try {
     });
 }
 catch (error) {
-    reportError(describeError(error));
+    reportFailure('nmr-compile', error);
     process.exitCode = 1;
 }

package/dist/esm/cli-clean.js

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