@williamthorsen/release-kit 10.3.1 → 10.4.0

package/.readyup/kits/default.js

@@ -1,6 +1,6 @@
 /** @noformat — @generated. Do not edit. Compiled by rdy. */
 /* eslint-disable */
-export const __readyupVersion = "0.26.0";
+export const __readyupVersion = "0.28.0";
 
 
 // .readyup/kits/default.ts
@@ -52,7 +52,7 @@ function detectRepoType() {
 
 // .readyup/kits/default.ts
 function getMinVersion() {
-  const picked = { "version": "10.3.1" };
+  const picked = { "version": "10.4.0" };
   if (typeof picked["version"] !== "string") {
     throw new TypeError("release-kit/package.json: 'version' must be a string");
   }

package/.readyup/kits/npm-auto-publish.js

@@ -1,6 +1,6 @@
 /** @noformat — @generated. Do not edit. Compiled by rdy. */
 /* eslint-disable */
-export const __readyupVersion = "0.26.0";
+export const __readyupVersion = "0.28.0";
 
 
 // .readyup/kits/npm-auto-publish.ts

package/.readyup/manifest.json

@@ -5,24 +5,63 @@
       "checklists": [
         "release-kit"
       ],
+      "esbuildVersion": "0.28.1",
+      "inputs": [
+        {
+          "hash": "fe239d01",
+          "kind": "module",
+          "path": "kits/default.ts"
+        },
+        {
+          "hash": "07509c48",
+          "kind": "inline",
+          "path": "../package.json",
+          "paths": [
+            "version"
+          ]
+        },
+        {
+          "hash": "850b703f",
+          "kind": "module",
+          "path": "../src/init/detectRepoType.ts"
+        },
+        {
+          "hash": "b6873aba",
+          "kind": "module",
+          "path": "../src/init/parseJsonRecord.ts"
+        },
+        {
+          "hash": "646fe51b",
+          "kind": "module",
+          "path": "../src/typeGuards.ts"
+        }
+      ],
       "name": "default",
       "path": "kits/default.js",
-      "readyupVersion": "0.26.0",
+      "readyupVersion": "0.28.0",
       "source": "kits/default.ts",
       "sourceHash": "fe239d01",
-      "targetHash": "d3143e73"
+      "targetHash": "5413984b"
     },
     {
       "checklists": [
         "repo",
         "packages"
       ],
+      "esbuildVersion": "0.28.1",
+      "inputs": [
+        {
+          "hash": "ac484613",
+          "kind": "module",
+          "path": "kits/npm-auto-publish.ts"
+        }
+      ],
       "name": "npm-auto-publish",
       "path": "kits/npm-auto-publish.js",
-      "readyupVersion": "0.26.0",
+      "readyupVersion": "0.28.0",
       "source": "kits/npm-auto-publish.ts",
       "sourceHash": "ac484613",
-      "targetHash": "461ded99"
+      "targetHash": "0636c995"
     }
   ]
 }

package/CHANGELOG.md

@@ -2,6 +2,56 @@
 
 All notable changes to this project will be documented in this file.
 
+## 10.4.0 — 2026-08-17
+
+### 🎉 Features
+
+- Let a project release cover repo-root paths (#685)
+
+  Extends `release-kit`'s project release to a repo whose content lives at the root. Such a repo declares `project: { paths: ['**'] }` and gets the root `CHANGELOG.md`, the root `.meta/changelog.json`, the `--with-release-notes` previews under root `docs/`, the root `package.json` bump, and the project tag that the stage produces.
+
+  `paths` scopes any project release's window, not only the whole-tree case, and the project tier of `release-kit validate-overrides` with it. A declared value replaces the workspace union rather than extending it; omitting `paths` resolves to that union, so existing consumers see no change.
+
+### ♻️ Refactoring
+
+- Adopt silenceConsole across the test suites (#677)
+
+  Adopts `silenceConsole` from `@williamthorsen/toolbelt.vitest` to replace all hand-rolled `vi.spyOn(console, …)` spies and reduce boilerplate across the repo's test suites. The function returns a disposable, allowing the caller to use `using` to enable restoration of the console method at the end of the test scope.
+
+- Adopt `isError` and consolidate errno narrowing on a shared helper (#697)
+
+  Replaces every hand-rolled `instanceof Error` narrowing with `hasErrnoCode`, a new predicate exported from `@williamthorsen/nmr-core`, or with `isError` from `@williamthorsen/toolbelt.errors`. Previously the errno question was answered by inline copies alongside two private helpers of differing shape; both helpers are removed.
+
+  Separately, `eslint.config.ts` now bans `instanceof Error` in every position rather than in a ternary alone.
+
+### 🧪 Tests
+
+- Replace the stdio spies with captureStdio (#678)
+
+  Replaces every `process.stdout` and `process.stderr` spy in the test suites with `captureStdio` from `@williamthorsen/toolbelt.testing` and deletes the obviated local capture helpers. `captureStdio` buffers writes rather than recording calls, so assertions that previously used `toHaveBeenCalledWith` instead check `stderr`/`stdout` strings and their chunk arrays.
+
+  Separately, `unicorn/no-nonstandard-builtin-properties` is off for test files. Its hand-maintained symbol table omits `Symbol.dispose`, which a suite-scoped capture calls to restore the streams, and `schema: []` offers no way to extend the table.
+
+- Adopt throwOnProcessExit and captureError across the test suites (#690)
+
+  Adopts `throwOnProcessExit` from `@williamthorsen/toolbelt.vitest`, replacing every hand-rolled `process.exit` mock in the `release-kit` and `nmr-core` test suites, and `captureError` from `@williamthorsen/toolbelt.testing`, replacing inline try/catch/`instanceof` blocks.
+
+  Separately, `@williamthorsen/toolbelt.vitest` is now listed in the ReadyUp config, so that its kit is run by `rdy run --packages`.
+
+## 10.3.2 — 2026-08-13
+
+### ♻️ Refactoring
+
+- Adopt toolbelt.errors for error-message extraction and cause-chaining (#652)
+
+  Improves error reporting by adopting standardized ways of capturing and describing errors across the codebase.
+
+### ⚙️ Tooling
+
+- Upgrade the lint config and clear its violations (#671)
+
+  Upgrades `@williamthorsen/eslint-config-typescript`, along with other config packages, and clears lint violations surfaced by the newly activated rules.
+
 ## 10.3.0 — 2026-08-08
 
 ### 🎉 Features

package/README.md

@@ -4,7 +4,17 @@ Version-bumping and changelog-generation toolkit for release workflows.
 
 Provides a self-contained CLI that auto-discovers workspaces from `pnpm-workspace.yaml`, parses conventional commits, determines version bumps, updates `package.json` files, and generates changelogs from `git-cliff --context` output rendered in-process (with optional [editorial overrides](#editorial-overrides)).
 
-<!-- section:release-notes --><!-- /section:release-notes -->
+<!-- section:release-notes -->
+## Release notes — v10.4.0 (2026-08-17)
+
+### 🎉 Features
+
+- Let a project release cover repo-root paths (#685)
+
+  Extends `release-kit`'s project release to a repo whose content lives at the root. Such a repo declares `project: { paths: ['**'] }` and gets the root `CHANGELOG.md`, the root `.meta/changelog.json`, the `--with-release-notes` previews under root `docs/`, the root `package.json` bump, and the project tag that the stage produces.
+
+  `paths` scopes any project release's window, not only the whole-tree case, and the project tier of `release-kit validate-overrides` with it. A declared value replaces the workspace union rather than extending it; omitting `paths` resolves to that union, so existing consumers see no change.
+<!-- /section:release-notes -->
 
 ## Installation
 
@@ -201,33 +211,50 @@ export default config;
 
 When configured, each `release-kit prepare` run additionally:
 
-- Computes commits since the last project tag (`<tagPrefix><version>`), filtered to the union of every contributing workspace's paths.
+- Computes commits since the last project tag (`<tagPrefix><version>`), filtered to `paths` (by default, the union of every contributing workspace's paths).
 - Bumps the root `package.json`'s `version` field using the same bump-derivation rules as workspaces (or the `--bump=...` override).
-- Regenerates the root `./CHANGELOG.md` from the structured `ChangelogEntry[]` produced by `git-cliff --context` (scoped to the project's `tagPrefix` and contributing paths) and any matching editorial overrides.
+- Regenerates the root `./CHANGELOG.md` from the structured `ChangelogEntry[]` produced by `git-cliff --context` (scoped to the project's `tagPrefix` and the same `paths`) and any matching editorial overrides.
 - Emits `./.meta/changelog.json` (when `changelogJson.enabled`).
 - With `--with-release-notes`, additionally emits `./docs/RELEASE_NOTES.v<version>.md`.
 - Appends the project tag to `tmp/.release-tags` so `release-kit commit` and `release-kit tag` pick it up alongside per-workspace tags.
 
-If no contributing workspace has commits since the last project tag, the project release is silently skipped — same behavior as a per-workspace skip.
+If no commit under `paths` has landed since the last project tag, the project release is silently skipped — same behavior as a per-workspace skip.
 
 #### `ProjectConfig`
 
 ```typescript
 interface ProjectConfig {
+  paths?: string[]; // Defaults to the union of every contributing workspace's paths
   tagPrefix?: string; // Defaults to 'v'
 }
 ```
 
-| Field       | Default | Description                                                          |
-| ----------- | ------- | -------------------------------------------------------------------- |
-| `tagPrefix` | `'v'`   | Prefix for project tags. The full tag is `${tagPrefix}${newVersion}` |
+| Field       | Default                 | Description                                                          |
+| ----------- | ----------------------- | -------------------------------------------------------------------- |
+| `paths`     | Contributing-path union | Patterns selecting the commits the project release considers         |
+| `tagPrefix` | `'v'`                   | Prefix for project tags. The full tag is `${tagPrefix}${newVersion}` |
+
+By default the contributing workspaces are implicit: every non-excluded discovered workspace contributes its `<dir>/**` glob, and the project release considers commits under their union.
+
+Declare `paths` to choose the window yourself. Each entry reaches two matchers: `git log` as a pathspec, and `git-cliff --include-path` as a glob. A declared value **replaces** the workspace union rather than extending it: `paths: ['docs/**']` drops every workspace commit from the project release.
+
+A repo whose content lives at the root — where no commit matches any `<dir>/**` glob, so the project release would skip every run — declares the whole tree:
+
+```typescript
+const config: ReleaseKitConfig = {
+  project: { paths: ['**'] },
+};
+```
+
+`'**'` is the whole-tree pattern, matching root-level files, dotfiles, and nested paths alike.
 
-Contributing workspaces are implicit: every non-excluded discovered workspace contributes. There is no field to override the contributing set in this initial release; if a future consumer needs to release a workspace as a component but exclude it from the project release, that override can be added then.
+Terminate a directory scope with `/**`. The two matchers agree on `'aws/**'` but diverge on a bare `'aws'`, which git reads as the whole subtree and git-cliff matches against nothing; `'.'` is the same trap for the repo root. A release under such an entry finds commits, bumps the version, and writes the tag, while its changelog gains no entry for them — and nothing reports an error.
 
 Validation rules:
 
 - The root `package.json` must exist and declare a `version` field. release-kit reports an error at config-load time if either is missing.
-- The `project` block is rejected in single-package mode (the implicit "all non-excluded workspaces contribute" rule is meaningless in a single-package repo).
+- The `project` block is rejected in single-package mode (the package's own release already covers the whole repo, so a project tier would only duplicate it).
+- `paths`, when declared, must hold at least one non-empty string. An empty array is rejected: it reaches git and git-cliff as no filter at all, which is the inverse of how it reads.
 - Unknown fields inside `project` are rejected.
 
 CLI flag interactions:

package/dist/esm/bin/release-kit.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { parseArgsOrExit, readPackageVersion, reportError } from '@williamthorsen/nmr-core';
+import { describeError } from '@williamthorsen/toolbelt.errors';
 import { checkWorkTypesDrift } from "../checkWorkTypesDrift.js";
 import { commitCommand } from "../commitCommand.js";
 import { createGithubReleaseCommand } from "../createGithubReleaseCommand.js";
@@ -258,7 +259,6 @@ Options:
 }
 const args = process.argv.slice(2);
 const command = args[0];
-const flags = args.slice(1);
 if (command === '--version' || command === '-V') {
     console.info(VERSION);
     process.exit(0);
@@ -267,6 +267,7 @@ if (command === undefined || ['--help', '-h'].includes(command)) {
     showUsage();
     process.exit(0);
 }
+const flags = args.slice(1);
 if (command === 'prepare') {
     if (flags.some((f) => f === '--help' || f === '-h')) {
         showPrepareHelp();
@@ -284,7 +285,7 @@ if (command === 'commit') {
         commitCommand(flags);
     }
     catch (error) {
-        reportError(error instanceof Error ? error.message : String(error));
+        reportError(describeError(error));
         process.exit(1);
     }
     process.exit(0);
@@ -349,11 +350,11 @@ if (command === 'init') {
 }
 if (command === 'sync-labels') {
     const subcommand = flags[0];
-    const subflags = flags.slice(1);
     if (subcommand === undefined || ['--help', '-h'].includes(subcommand)) {
         showSyncLabelsHelp();
         process.exit(0);
     }
+    const subflags = flags.slice(1);
     if (subcommand === 'init') {
         if (subflags.some((f) => f === '--help' || f === '-h')) {
             showSyncLabelsInitHelp();
@@ -397,11 +398,11 @@ if (command === 'sync-labels') {
 }
 if (command === 'overrides') {
     const subcommand = flags[0];
-    const subflags = flags.slice(1);
     if (subcommand === undefined || ['--help', '-h'].includes(subcommand)) {
         showOverridesHelp();
         process.exit(0);
     }
+    const subflags = flags.slice(1);
     if (subcommand === 'validate') {
         if (subflags.some((f) => f === '--help' || f === '-h')) {
             showOverridesValidateHelp();
@@ -426,11 +427,11 @@ if (command === 'overrides') {
 }
 if (command === 'work-types') {
     const subcommand = flags[0];
-    const subflags = flags.slice(1);
     if (subcommand === undefined || ['--help', '-h'].includes(subcommand)) {
         showWorkTypesHelp();
         process.exit(0);
     }
+    const subflags = flags.slice(1);
     if (subcommand === 'check') {
         if (subflags.some((f) => f === '--help' || f === '-h')) {
             showWorkTypesCheckHelp();

package/dist/esm/buildChangelogEntries.js

@@ -1,3 +1,4 @@
+import { chainError } from '@williamthorsen/toolbelt.errors/candidate';
 import { extractVersion } from "./changelogJsonUtils.js";
 import { DEFAULT_WORK_TYPES } from "./defaults.js";
 import { COMMIT_PREPROCESSOR_PATTERNS, PIPE_SCOPE_SOURCE } from "./parseCommitMessage.js";
@@ -31,7 +32,7 @@ export function buildChangelogEntries(config, tag, options) {
         return transformReleases(releases, devOnlySections);
     }
     catch (error) {
-        throw new Error(`Failed to build changelog entries for tag ${tag}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+        throw chainError(`Failed to build changelog entries for tag ${tag}`, error);
     }
 }
 function parseCliffContext(json) {

package/dist/esm/buildDependencyGraph.js

@@ -1,4 +1,5 @@
 import { readFileSync } from 'node:fs';
+import { chainError } from '@williamthorsen/toolbelt.errors/candidate';
 function isPackageJsonSubset(value) {
     return typeof value === 'object' && value !== null;
 }
@@ -51,18 +52,14 @@ function readPackageJsonSubset(filePath) {
         content = readFileSync(filePath, 'utf8');
     }
     catch (error) {
-        throw new Error(`Failed to read ${filePath}: ${error instanceof Error ? error.message : String(error)}`, {
-            cause: error,
-        });
+        throw chainError(`Failed to read ${filePath}`, error);
     }
     let parsed;
     try {
         parsed = JSON.parse(content);
     }
     catch (error) {
-        throw new Error(`Failed to parse JSON in ${filePath}: ${error instanceof Error ? error.message : String(error)}`, {
-            cause: error,
-        });
+        throw chainError(`Failed to parse JSON in ${filePath}`, error);
     }
     if (!isPackageJsonSubset(parsed)) {
         throw new Error(`Invalid package.json at ${filePath}`);

package/dist/esm/changelogJsonFile.js

@@ -1,5 +1,6 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
+import { describeError } from '@williamthorsen/toolbelt.errors';
 import stringify from 'json-stringify-pretty-compact';
 import semver from 'semver';
 import { isChangelogEntry } from "./changelogJsonUtils.js";
@@ -30,7 +31,7 @@ function readExistingEntries(filePath) {
         return parsed.filter(isChangelogEntry);
     }
     catch (error) {
-        console.warn(`Warning: could not parse existing ${filePath}: ${error instanceof Error ? error.message : String(error)}; treating as empty`);
+        console.warn(`Warning: could not parse existing ${filePath}: ${describeError(error)}; treating as empty`);
         return [];
     }
 }

package/dist/esm/changelogOverrides.js

@@ -1,5 +1,6 @@
 import { existsSync, readFileSync } from 'node:fs';
 import path from 'node:path';
+import { describeError } from '@williamthorsen/toolbelt.errors';
 import { isRecord } from "./typeGuards.js";
 const OVERRIDES_FILENAME = '.meta/changelog-overrides.json';
 const VALID_AUDIENCE_VALUES = new Set(['all', 'dev', 'skip']);
@@ -15,7 +16,7 @@ export function loadChangelogOverrides(path) {
     }
     catch (error) {
         return {
-            errors: [`Failed to read override file ${path}: ${error instanceof Error ? error.message : String(error)}`],
+            errors: [`Failed to read override file ${path}: ${describeError(error)}`],
         };
     }
     let parsed;
@@ -24,7 +25,7 @@ export function loadChangelogOverrides(path) {
     }
     catch (error) {
         return {
-            errors: [`Failed to parse override file ${path}: ${error instanceof Error ? error.message : String(error)}`],
+            errors: [`Failed to parse override file ${path}: ${describeError(error)}`],
         };
     }
     const result = validateChangelogOverrides(parsed);

package/dist/esm/checkWorkTypesDrift.js

@@ -2,7 +2,8 @@ import { readFileSync } from 'node:fs';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { formatErrorLine } from '@williamthorsen/nmr-core';
-import { buildFetchInit, errorMessage, hasExpectedTopLevelShape } from "./workTypesUtils.js";
+import { describeError } from '@williamthorsen/toolbelt.errors';
+import { buildFetchInit, hasExpectedTopLevelShape } from "./workTypesUtils.js";
 export const UPSTREAM_WORK_TYPES_URL = 'https://raw.githubusercontent.com/williamthorsen/codeassembly/main/packages/agents/content/skills/_data/work-types.json';
 function resolveDefaultLocalPath() {
     const moduleDir = dirname(fileURLToPath(import.meta.url));
@@ -20,7 +21,7 @@ export async function checkWorkTypesDrift(dependencies = {}) {
     catch (error) {
         return {
             exitCode: 3,
-            message: `Local work-types.json is not valid JSON: ${errorMessage(error)}`,
+            message: `Local work-types.json is not valid JSON: ${describeError(error)}`,
         };
     }
     const fetchInit = buildFetchInit();
@@ -31,7 +32,7 @@ export async function checkWorkTypesDrift(dependencies = {}) {
     catch (error) {
         return {
             exitCode: 2,
-            message: formatErrorLine(`Failed to fetch upstream work-types.json: ${errorMessage(error)}`),
+            message: formatErrorLine(`Failed to fetch upstream work-types.json: ${describeError(error)}`),
         };
     }
     if (response.status === 404) {
@@ -54,7 +55,7 @@ export async function checkWorkTypesDrift(dependencies = {}) {
     catch (error) {
         return {
             exitCode: 3,
-            message: `Upstream work-types.json is not valid JSON: ${errorMessage(error)}`,
+            message: `Upstream work-types.json is not valid JSON: ${describeError(error)}`,
         };
     }
     if (!hasExpectedTopLevelShape(upstreamJson)) {

package/dist/esm/commitCommand.js

@@ -1,6 +1,6 @@
 import { execFileSync } from 'node:child_process';
 import { readFileSync } from 'node:fs';
-import { GIT_OUTPUT_LIMIT, parseArgsOrExit } from '@williamthorsen/nmr-core';
+import { GIT_OUTPUT_LIMIT, hasErrnoCode, parseArgsOrExit } from '@williamthorsen/nmr-core';
 import { readReleaseTags, RELEASE_SUMMARY_FILE, resolveReleaseTagsPath } from "./releaseFiles.js";
 const commitFlagSchema = {
     dryRun: { long: '--dry-run', type: 'boolean' },
@@ -16,7 +16,7 @@ export function commitCommand(argv) {
         summary = readFileSync(RELEASE_SUMMARY_FILE, 'utf8').trim();
     }
     catch (error) {
-        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+        if (hasErrnoCode(error, 'ENOENT')) {
         }
         else {
             throw error;

package/dist/esm/createGithubReleaseCommand.js

@@ -1,4 +1,5 @@
 import { parseArgsOrExit, reportError } from '@williamthorsen/nmr-core';
+import { describeError } from '@williamthorsen/toolbelt.errors';
 import { createGithubReleases } from "./createGithubRelease.js";
 import { formatPrivateSkip } from "./formatPrivateSkip.js";
 import { parseRequestedTags } from "./parseRequestedTags.js";
@@ -28,7 +29,7 @@ export async function createGithubReleaseCommand(argv) {
         outcome = createGithubReleases(publishableTags, changelogJsonOutputPath, dryRun, sectionOrder);
     }
     catch (error) {
-        reportError(`Failed to create GitHub Releases: ${error instanceof Error ? error.message : String(error)}`);
+        reportError(`Failed to create GitHub Releases: ${describeError(error)}`);
         process.exit(1);
     }
     if (outcome.skipped.length > 0) {

package/dist/esm/createTags.js

@@ -1,5 +1,5 @@
 import { execFileSync } from 'node:child_process';
-import { GIT_OUTPUT_LIMIT } from '@williamthorsen/nmr-core';
+import { GIT_OUTPUT_LIMIT, hasErrnoCode } from '@williamthorsen/nmr-core';
 import { deleteFileIfExists } from "./deleteFileIfExists.js";
 import { readReleaseTags, RELEASE_SUMMARY_FILE, RELEASE_TAGS_FILE } from "./releaseFiles.js";
 export function createTags(options) {
@@ -48,7 +48,7 @@ function assertCleanWorkingTree() {
         execFileSync('git', ['diff', '--quiet', '--cached'], { maxBuffer: GIT_OUTPUT_LIMIT });
     }
     catch (error) {
-        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+        if (hasErrnoCode(error, 'ENOENT')) {
             throw error;
         }
         throw new Error('Working tree is dirty. Commit or stash changes before tagging, or use `--no-git-checks` to skip this check.', { cause: error });

package/dist/esm/deleteFileIfExists.js

@@ -1,10 +1,11 @@
 import { unlinkSync } from 'node:fs';
+import { hasErrnoCode } from '@williamthorsen/nmr-core';
 export function deleteFileIfExists(filePath) {
     try {
         unlinkSync(filePath);
     }
     catch (error) {
-        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+        if (hasErrnoCode(error, 'ENOENT')) {
             return;
         }
         throw error;

package/dist/esm/deriveWorkspaceConfig.js

@@ -1,5 +1,6 @@
 import { readFileSync } from 'node:fs';
 import { basename } from 'node:path';
+import { chainError } from '@williamthorsen/toolbelt.errors/candidate';
 import { isRecord } from "./typeGuards.js";
 export function deriveWorkspaceConfig(workspacePath) {
     const dir = basename(workspacePath);
@@ -9,8 +10,7 @@ export function deriveWorkspaceConfig(workspacePath) {
         parsed = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
     }
     catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        throw new Error(`Failed to read ${packageJsonPath}: ${message}`, { cause: error });
+        throw chainError(`Failed to read ${packageJsonPath}`, error);
     }
     const name = isRecord(parsed) ? parsed['name'] : undefined;
     if (typeof name !== 'string' || name.length === 0) {

package/dist/esm/discoverWorkspaces.js

@@ -1,5 +1,6 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
+import { describeError } from '@williamthorsen/toolbelt.errors';
 import { glob } from 'glob';
 import { parse } from 'yaml';
 import { isRecord } from "./typeGuards.js";
@@ -13,7 +14,7 @@ export async function discoverWorkspaces() {
         content = readFileSync(workspaceFile, 'utf8');
     }
     catch (error) {
-        console.warn(`Warning: Failed to read ${workspaceFile}: ${error instanceof Error ? error.message : String(error)}`);
+        console.warn(`Warning: Failed to read ${workspaceFile}: ${describeError(error)}`);
         return undefined;
     }
     const parsed = parse(content);

package/dist/esm/getCommitsSinceTarget.js

@@ -1,12 +1,10 @@
 import { execFileSync } from 'node:child_process';
 import { GIT_OUTPUT_LIMIT } from '@williamthorsen/nmr-core';
+import { chainError } from '@williamthorsen/toolbelt.errors/candidate';
 const FIELD_SEPARATOR = '\u{1F}';
 function isNoTagError(err) {
     return typeof err === 'object' && err !== null && 'status' in err && err.status === 128;
 }
-function errorMessage(err) {
-    return err instanceof Error ? err.message : String(err);
-}
 function findLatestTag(tagPrefixes) {
     if (tagPrefixes.length === 0) {
         throw new Error('findLatestTag: tagPrefixes must contain at least one entry');
@@ -24,7 +22,7 @@ function findLatestTag(tagPrefixes) {
         if (isNoTagError(error)) {
             return undefined;
         }
-        throw new Error(`Failed to run 'git describe': ${errorMessage(error)}`, { cause: error });
+        throw chainError(`Failed to run 'git describe'`, error);
     }
 }
 const RELEASE_COMMIT_PREFIX = 'release:';
@@ -59,7 +57,7 @@ export function getCommitsSinceTarget(tagPrefixes, paths) {
         }).trim();
     }
     catch (error) {
-        throw new Error(`Failed to run 'git log' for range '${range}': ${errorMessage(error)}`, { cause: error });
+        throw chainError(`Failed to run 'git log' for range '${range}'`, error);
     }
     if (logOutput === '') {
         return { tag, commits: [] };

package/dist/esm/init/initCommand.js

@@ -1,4 +1,5 @@
 import { printError, printStep, printSuccess, reportWriteResult } from '@williamthorsen/nmr-core';
+import { describeError } from '@williamthorsen/toolbelt.errors';
 import { hasPackageJson, isGitRepo, usesPnpm } from "./checks.js";
 import { detectRepoType } from "./detectRepoType.js";
 import { scaffoldFiles } from "./scaffold.js";
@@ -29,7 +30,7 @@ export function initCommand({ dryRun, force, withConfig }) {
         eligible = checkEligibility();
     }
     catch (error) {
-        printError(`Eligibility check failed: ${error instanceof Error ? error.message : String(error)}`);
+        printError(`Eligibility check failed: ${describeError(error)}`);
         return 1;
     }
     if (!eligible)
@@ -40,7 +41,7 @@ export function initCommand({ dryRun, force, withConfig }) {
         repoType = detectRepoType();
     }
     catch (error) {
-        printError(`Failed to detect repo type: ${error instanceof Error ? error.message : String(error)}`);
+        printError(`Failed to detect repo type: ${describeError(error)}`);
         return 1;
     }
     printSuccess(`Detected: ${repoType}`);
@@ -50,7 +51,7 @@ export function initCommand({ dryRun, force, withConfig }) {
         results = scaffoldFiles({ repoType, dryRun, overwrite: force, withConfig });
     }
     catch (error) {
-        printError(`Failed to scaffold files: ${error instanceof Error ? error.message : String(error)}`);
+        printError(`Failed to scaffold files: ${describeError(error)}`);
         return 1;
     }
     for (const result of results) {

package/dist/esm/init/scaffold.js

@@ -1,6 +1,7 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
 import { findPackageRoot, writeFileWithCheck } from '@williamthorsen/nmr-core';
+import { describeError } from '@williamthorsen/toolbelt.errors';
 import { createGithubReleaseWorkflow, publishWorkflow, releaseConfigScript, releaseWorkflow } from "./templates.js";
 export function copyCliffTemplate(dryRun, overwrite) {
     const destPath = '.config/git-cliff.toml';
@@ -14,7 +15,7 @@ export function copyCliffTemplate(dryRun, overwrite) {
         content = readFileSync(templatePath, 'utf8');
     }
     catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
+        const message = describeError(error);
         return { filePath: destPath, outcome: 'failed', error: `Failed to read template ${templatePath}: ${message}` };
     }
     return writeFileWithCheck(destPath, content, { dryRun, overwrite });