@williamthorsen/release-kit 16.1.0 → 16.1.2

package/.meta/changelog.json

@@ -1,4 +1,49 @@
 [
+  {
+    "version": "16.1.2",
+    "date": "2026-11-06",
+    "sections": [
+      {
+        "title": "🐛 Bug fixes",
+        "audience": "all",
+        "items": [
+          {
+            "description": "Fixes the issue that `release-kit` printed a bug in its own code as an ordinary `Error: <message>`, which it now prints as `release-kit: internal error: <message>` followed by the stack, while a failure in the user's input, config, or environment, including a failed `git`, `gh`, or `npm` call, keeps the `Error: <message>` form. (#1158)",
+            "hash": "3a62cc768b23f37156c846f32fd4acaa70f7f931",
+            "entry": 1
+          }
+        ]
+      }
+    ]
+  },
+  {
+    "version": "16.1.1",
+    "date": "2026-11-05",
+    "sections": [
+      {
+        "title": "🐛 Bug fixes",
+        "audience": "all",
+        "items": [
+          {
+            "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
+          }
+        ]
+      },
+      {
+        "title": "♻️ Refactoring",
+        "audience": "dev",
+        "items": [
+          {
+            "description": "Moves the CLI entries of `release-kit` and `v11y-check` from `src/bin/` to `src/cli.ts`, matching the layout of `nmr`, and renames the command module previously at `v11y-check`'s `src/cli.ts` to `src/commands.ts`. (#1154)",
+            "hash": "8ec4abd71b8952d9bee798031bd336c386fa7cf1",
+            "entry": 1
+          }
+        ]
+      }
+    ]
+  },
   {
     "version": "16.1.0",
     "date": "2026-11-03",

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";
 
 
 // .readyup/kits/default.ts
@@ -234,7 +234,7 @@ var CREATE_GITHUB_RELEASE_WORKFLOW_HASH_SINGLE = "d6de961de913c67b08dfa7e07f7349
 
 // .readyup/kits/default.ts
 function getMinVersion() {
-  const picked = { "version": "16.1.0" };
+  const picked = { "version": "16.1.2" };
   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.44.0";
+export const __readyupVersion = "0.45.0";
 
 
 // .readyup/kits/npm-auto-publish.ts

package/.readyup/manifest.json

@@ -7,7 +7,7 @@
           "checklist": "release-kit",
           "checks": [
             "@williamthorsen/release-kit in devDependencies",
-            "@williamthorsen/release-kit >= 16.1.0",
+            "@williamthorsen/release-kit >= 16.1.2",
             "release.yaml workflow exists",
             "release.yaml matches template",
             "release.yaml does not reference deprecated tag ref",
@@ -63,7 +63,7 @@
           "path": "lib/workflow-hashes.ts"
         },
         {
-          "hash": "b44f7148",
+          "hash": "ff1fde3d",
           "kind": "inline",
           "path": "../package.json",
           "paths": [
@@ -98,10 +98,10 @@
       ],
       "name": "default",
       "path": "kits/default.js",
-      "readyupVersion": "0.44.0",
+      "readyupVersion": "0.45.0",
       "source": "kits/default.ts",
       "sourceHash": "56566d0b",
-      "targetHash": "5f810bb7"
+      "targetHash": "6a43de10"
     },
     {
       "checklistChecks": [
@@ -157,10 +157,10 @@
       ],
       "name": "npm-auto-publish",
       "path": "kits/npm-auto-publish.js",
-      "readyupVersion": "0.44.0",
+      "readyupVersion": "0.45.0",
       "source": "kits/npm-auto-publish.ts",
       "sourceHash": "682fdd4a",
-      "targetHash": "84f31b6d"
+      "targetHash": "52d15648"
     }
   ]
 }

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to this project will be documented in this file.
 
+## 16.1.2 — 2026-11-06
+
+### 🐛 Bug fixes
+
+- Fixes the issue that `release-kit` printed a bug in its own code as an ordinary `Error: <message>`, which it now prints as `release-kit: internal error: <message>` followed by the stack, while a failure in the user's input, config, or environment, including a failed `git`, `gh`, or `npm` call, keeps the `Error: <message>` form. (#1158)
+
+## 16.1.1 — 2026-11-05
+
+### 🐛 Bug fixes
+
+- 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)
+
+### ♻️ Refactoring
+
+- Moves the CLI entries of `release-kit` and `v11y-check` from `src/bin/` to `src/cli.ts`, matching the layout of `nmr`, and renames the command module previously at `v11y-check`'s `src/cli.ts` to `src/commands.ts`. (#1154)
+
 ## 16.1.0 — 2026-11-03
 
 ### 🎉 Features

package/README.md

@@ -7,13 +7,11 @@ 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 the same commit history that decides each bump (with optional [editorial overrides](docs/editorial-overrides.md)).
 
 <!-- section:release-notes -->
-## Release notes — v16.1.0 (2026-11-03)
+## Release notes — v16.1.2 (2026-11-06)
 
-### 🎉 Features
+### 🐛 Bug fixes
 
-- Makes `prepare` and `publish` refuse a release, dry runs included, when a tarball packed from a clean checkout of HEAD lacks a file named by the package's `main`, `types`, `bin`, or `exports`, which keeps a package with missing build output from reaching the registry. (#1147)
-- Adds the `devExportConditions` config key, which lists the export conditions that resolve only inside the repo and whose targets the tarball check does not require, in addition to `source`. (#1147)
-- Adds a `content` label to the `common` label preset, for consumer-facing material such as copy, images, or displayed data rather than functionality. (#1150)
+- Fixes the issue that `release-kit` printed a bug in its own code as an ordinary `Error: <message>`, which it now prints as `release-kit: internal error: <message>` followed by the stack, while a failure in the user's input, config, or environment, including a failed `git`, `gh`, or `npm` call, keeps the `Error: <message>` form. (#1158)
 <!-- /section:release-notes -->
 
 ## Installation

package/bin/release-kit.js

@@ -1,11 +1,15 @@
 #!/usr/bin/env node
 try {
-  await import('../dist/esm/bin/release-kit.js');
+  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('release-kit: build output not found; run `nmr build` first\n');
   } else {
-    process.stderr.write(`release-kit: 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(`release-kit: internal error: ${message}\n${frames}`);
   }
   process.exit(1);
 }

package/dist/esm/assertCleanWorkingTree.js

@@ -1,12 +1,19 @@
 import { execFileSync } from 'node:child_process';
-import { GIT_OUTPUT_LIMIT_BYTES } from '@williamthorsen/nmr-core';
+import { GIT_OUTPUT_LIMIT_BYTES, UserError } from '@williamthorsen/nmr-core';
+import { asUserError } from "./user-error-chaining.js";
 export function assertCleanWorkingTree() {
-    const status = execFileSync('git', ['status', '--porcelain'], {
-        encoding: 'utf8',
-        maxBuffer: GIT_OUTPUT_LIMIT_BYTES,
-        stdio: ['pipe', 'pipe', 'pipe'],
-    }).trim();
+    let status;
+    try {
+        status = execFileSync('git', ['status', '--porcelain'], {
+            encoding: 'utf8',
+            maxBuffer: GIT_OUTPUT_LIMIT_BYTES,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch (error) {
+        throw asUserError(error);
+    }
     if (status.length > 0) {
-        throw new Error('Working tree has uncommitted changes. Commit or stash them, or use --no-git-checks to bypass this check.');
+        throw new UserError('Working tree has uncommitted changes. Commit or stash them, or use --no-git-checks to bypass this check.');
     }
 }

package/dist/esm/assertReleasesOnNpm.js

@@ -1,8 +1,10 @@
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
+import { UserError } from '@williamthorsen/nmr-core';
 import { isPublishableManifest } from "./isPublishableManifest.js";
 import { lookUpNpmPackage } from "./npmRegistry.js";
 import { isRecord } from "./typeGuards.js";
+import { chainUserError } from "./user-error-chaining.js";
 export function assertReleasesOnNpm(workspacePaths) {
     const unpublishedCandidates = [];
     const unverifiableCandidates = [];
@@ -22,10 +24,17 @@ export function assertReleasesOnNpm(workspacePaths) {
     if (unpublishedCandidates.length === 0 && unverifiableCandidates.length === 0) {
         return;
     }
-    throw new Error(describeRefusal(unpublishedCandidates, unverifiableCandidates));
+    throw new UserError(describeRefusal(unpublishedCandidates, unverifiableCandidates));
 }
 function buildNpmCandidate(workspacePath) {
-    const manifest = JSON.parse(readFileSync(join(workspacePath, 'package.json'), 'utf8'));
+    const manifestPath = join(workspacePath, 'package.json');
+    let manifest;
+    try {
+        manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
+    }
+    catch (error) {
+        throw chainUserError(`Failed to parse ${manifestPath}`, error);
+    }
     if (!isRecord(manifest) || !isPublishableManifest(manifest) || typeof manifest['name'] !== 'string') {
         return undefined;
     }

package/dist/esm/assertTaggedBaseline.js

@@ -1,4 +1,5 @@
 import { join } from 'node:path';
+import { UserError } from '@williamthorsen/nmr-core';
 import { resolveChangelogJsonPath } from "./changelogJsonFile.js";
 import { readChangelogEntries } from "./changelogJsonUtils.js";
 import { readCurrentVersion } from "./planVersionBump.js";
@@ -8,7 +9,7 @@ export function assertTaggedBaseline(findings) {
     if (untaggedFindings.length === 0)
         return;
     const lines = untaggedFindings.map(({ label, version, tag }) => `  - ${label}: ${version} (create tag ${tag})`);
-    throw new Error([
+    throw new UserError([
         'The current version is recorded in the changelog, but its tag is not the previous tag reachable from HEAD:',
         ...lines,
         'Tag the commit that released each version, then run prepare again.',

package/dist/esm/assertTarballsComplete.js

@@ -1,11 +1,13 @@
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
+import { isAnticipatedFailure, UserError } from '@williamthorsen/nmr-core';
 import { describeError } from '@williamthorsen/toolbelt.errors';
 import { detectPackageManager } from "./detectPackageManager.js";
 import { findMissingManifestPaths } from "./findMissingManifestPaths.js";
 import { isPublishableManifest } from "./isPublishableManifest.js";
 import { packFromCleanCheckout } from "./packFromCleanCheckout.js";
 import { isRecord } from "./typeGuards.js";
+import { chainUserError } from "./user-error-chaining.js";
 export function assertTarballsComplete(workspacePaths, devExportConditions, pack = packFromCleanCheckout) {
     const candidates = workspacePaths
         .map((workspacePath) => ({ workspacePath, manifest: readManifest(workspacePath) }))
@@ -19,7 +21,10 @@ export function assertTarballsComplete(workspacePaths, devExportConditions, pack
         filesByWorkspace = pack(candidates.map(({ workspacePath }) => workspacePath), detectPackageManager());
     }
     catch (error) {
-        throw new Error(`Cannot release: The packages could not be packed from a clean checkout of HEAD.\n${describeError(error)}`, { cause: error });
+        if (!isAnticipatedFailure(error)) {
+            throw error;
+        }
+        throw new UserError(`Cannot release: The packages could not be packed from a clean checkout of HEAD.\n${describeError(error)}`, { cause: error });
     }
     const incompletePackages = candidates
         .map(({ workspacePath, manifest }) => ({
@@ -31,7 +36,7 @@ export function assertTarballsComplete(workspacePaths, devExportConditions, pack
     if (incompletePackages.length === 0) {
         return;
     }
-    throw new Error(describeRefusal(incompletePackages));
+    throw new UserError(describeRefusal(incompletePackages));
 }
 function describeRefusal(incompletePackages) {
     const sections = ['Cannot release: The tarball of every package must contain each file that its manifest names.'];
@@ -47,6 +52,13 @@ function describeRefusal(incompletePackages) {
     return sections.join('\n\n');
 }
 function readManifest(workspacePath) {
-    const manifest = JSON.parse(readFileSync(join(workspacePath, 'package.json'), 'utf8'));
+    const manifestPath = join(workspacePath, 'package.json');
+    let manifest;
+    try {
+        manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
+    }
+    catch (error) {
+        throw chainUserError(`Failed to parse ${manifestPath}`, error);
+    }
     return isRecord(manifest) ? manifest : {};
 }

package/dist/esm/buildChangelogEntries.js

@@ -1,4 +1,3 @@
-import { chainError } from '@williamthorsen/toolbelt.errors/candidate';
 import { buildEntryItem, buildTitleItem, hasRoutedEntry, } from "./buildChangelogItem.js";
 import { buildEmptyReleaseEntry } from "./buildEmptyReleaseEntry.js";
 import { extractVersion } from "./changelogJsonUtils.js";
@@ -8,6 +7,7 @@ import { determineBumpType } from "./determineBumpType.js";
 import { enumerateReleaseWindows } from "./enumerateReleaseWindows.js";
 import { parseChangeRecordBlock } from "./parseChangeRecordBlock.js";
 import { stripEmojiPrefix } from "./stripEmojiPrefix.js";
+import { prefixUserError } from "./user-error-chaining.js";
 const UNRELEASED_TAG = 'unreleased';
 const CANONICAL_SECTION_ORDER = new Map(Object.values(DEFAULT_WORK_TYPES).map((config, index) => [stripGroupDecorations(config.header), index]));
 export function buildChangelogEntries(config, tag, options) {
@@ -49,7 +49,7 @@ export function readReleaseHistory(config, options) {
         return transformReleases(windows, context);
     }
     catch (error) {
-        throw chainError(`Failed to read the release history for ${options.tagPrefixes.join(', ')}`, error);
+        throw prefixUserError(`Failed to read the release history for ${options.tagPrefixes.join(', ')}`, error);
     }
 }
 export function stripGroupDecorations(group) {

package/dist/esm/buildDependencyGraph.js

@@ -1,5 +1,6 @@
 import { readFileSync } from 'node:fs';
-import { chainError } from '@williamthorsen/toolbelt.errors/candidate';
+import { UserError } from '@williamthorsen/nmr-core';
+import { chainUserError } from "./user-error-chaining.js";
 function isPackageJsonSubset(value) {
     return typeof value === 'object' && value !== null;
 }
@@ -56,17 +57,17 @@ function readPackageJsonSubset(filePath) {
         content = readFileSync(filePath, 'utf8');
     }
     catch (error) {
-        throw chainError(`Failed to read ${filePath}`, error);
+        throw chainUserError(`Failed to read ${filePath}`, error);
     }
     let parsedJson;
     try {
         parsedJson = JSON.parse(content);
     }
     catch (error) {
-        throw chainError(`Failed to parse JSON in ${filePath}`, error);
+        throw chainUserError(`Failed to parse JSON in ${filePath}`, error);
     }
     if (!isPackageJsonSubset(parsedJson)) {
-        throw new Error(`Invalid package.json at ${filePath}`);
+        throw new UserError(`Invalid package.json at ${filePath}`);
     }
     return parsedJson;
 }

package/dist/esm/bumpVersion.js

@@ -1,13 +1,14 @@
+import { UserError } from '@williamthorsen/nmr-core';
 export function bumpVersion(version, releaseType) {
     const match = version.match(/^(\d+)\.(\d+)\.(\d+)$/);
     if (!match) {
-        throw new Error(`Invalid semver version: '${version}'`);
+        throw new UserError(`Invalid semver version: '${version}'`);
     }
     const major = match[1];
     const minor = match[2];
     const patch = match[3];
     if (major === undefined || minor === undefined || patch === undefined) {
-        throw new Error(`Invalid semver version: '${version}'`);
+        throw new UserError(`Invalid semver version: '${version}'`);
     }
     const majorNumber = Number.parseInt(major, 10);
     const minorNumber = Number.parseInt(minor, 10);

package/dist/esm/changelogOverrides.js

@@ -1,4 +1,5 @@
 import path from 'node:path';
+import { UserError } from '@williamthorsen/nmr-core';
 import { applyChangelogOverrides, formatStaleOverrideKeyWarning } from "./applyChangelogOverrides.js";
 import { loadChangelogOverrides } from "./loadChangelogOverrides.js";
 const OVERRIDES_FILENAME = '.meta/changelog-overrides.json';
@@ -8,7 +9,7 @@ export function applyWorkspaceOverrides(newEntries, workspacePath, overrideConte
     const composedOverrides = composeOverrides(projectOverrides, workspaceOverrides);
     const appliedResult = applyChangelogOverrides(newEntries, composedOverrides);
     if (appliedResult.errors.length > 0) {
-        throw new Error(`Changelog override application failed:\n  - ${appliedResult.errors.join('\n  - ')}`);
+        throw new UserError(`Changelog override application failed:\n  - ${appliedResult.errors.join('\n  - ')}`);
     }
     overrideWarnings.push(...appliedResult.warnings);
     const matchedSet = new Set(appliedResult.matchedKeys);
@@ -38,7 +39,7 @@ export function composeOverrides(rootEntries, workspaceEntries) {
 export function createOverrideContext(workspacePaths) {
     const result = loadOverridesForScopes({ projectPath: '.', workspaces: [...workspacePaths] });
     if (result.errors.length > 0) {
-        throw new Error(`Failed to load changelog overrides:\n  - ${result.errors.join('\n  - ')}`);
+        throw new UserError(`Failed to load changelog overrides:\n  - ${result.errors.join('\n  - ')}`);
     }
     return {
         projectOverrides: result.projectOverrides,

package/dist/esm/cli.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import process from 'node:process';
+import { reportFailure } from '@williamthorsen/nmr-core';
+import { runCli } from "./runCli.js";
+try {
+    await runCli(process.argv.slice(2));
+}
+catch (error) {
+    reportFailure('release-kit', error);
+    process.exitCode = 1;
+}

package/dist/esm/commitCommand.js

@@ -1,7 +1,8 @@
 import { execFileSync } from 'node:child_process';
 import { readFileSync } from 'node:fs';
-import { GIT_OUTPUT_LIMIT_BYTES, hasErrnoCode, parseArgsOrExit } from '@williamthorsen/nmr-core';
+import { GIT_OUTPUT_LIMIT_BYTES, hasErrnoCode, parseArgsOrExit, UserError } from '@williamthorsen/nmr-core';
 import { readReleaseTags, RELEASE_SUMMARY_FILE, resolveReleaseTagsPath } from "./releaseFiles.js";
+import { asUserError } from "./user-error-chaining.js";
 const commitFlagSchema = {
     isDryRun: { long: '--dry-run', type: 'boolean' },
 };
@@ -9,7 +10,7 @@ export function commitCommand(argv) {
     const isDryRun = parseArgsOrExit(argv, commitFlagSchema).flags.isDryRun;
     const tags = readReleaseTags();
     if (tags.length === 0) {
-        throw new Error(`Tags file at ${resolveReleaseTagsPath()} is empty. Run \`release-kit prepare\` first.`);
+        throw new UserError(`Tags file at ${resolveReleaseTagsPath()} is empty. Run \`release-kit prepare\` first.`);
     }
     let summary = '';
     try {
@@ -19,7 +20,7 @@ export function commitCommand(argv) {
         if (hasErrnoCode(error, 'ENOENT')) {
         }
         else {
-            throw error;
+            throw asUserError(error);
         }
     }
     const title = `release: ${tags.join(' ')}`;
@@ -42,7 +43,12 @@ export function commitCommand(argv) {
         }
         return;
     }
-    execFileSync('git', ['add', '-A'], { maxBuffer: GIT_OUTPUT_LIMIT_BYTES });
-    execFileSync('git', ['commit', '-m', message], { maxBuffer: GIT_OUTPUT_LIMIT_BYTES });
+    try {
+        execFileSync('git', ['add', '-A'], { maxBuffer: GIT_OUTPUT_LIMIT_BYTES });
+        execFileSync('git', ['commit', '-m', message], { maxBuffer: GIT_OUTPUT_LIMIT_BYTES });
+    }
+    catch (error) {
+        throw asUserError(error);
+    }
     console.info(`Created release commit: ${title}`);
 }

package/dist/esm/compareVersions.js

@@ -1,9 +1,10 @@
+import { UserError } from '@williamthorsen/nmr-core';
 import semver from 'semver';
 const CANONICAL_SEMVER_PATTERN = /^(\d+)\.(\d+)\.(\d+)$/;
 function parseCanonicalSemver(version) {
     const match = version.match(CANONICAL_SEMVER_PATTERN);
     if (!match) {
-        throw new Error(`Invalid semver version: '${version}'`);
+        throw new UserError(`Invalid semver version: '${version}'`);
     }
     const [, major = '', minor = '', patch = ''] = match;
     return {

package/dist/esm/createGithubRelease.js

@@ -3,6 +3,7 @@ import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { extractVersion, readChangelogEntries } from "./changelogJsonUtils.js";
 import { matchesAudience, renderReleaseNotesSingle } from "./renderReleaseNotes.js";
+import { asUserError } from "./user-error-chaining.js";
 export function createGithubRelease(options) {
     const { tag, changelogJsonPath, isDryRun, sectionOrder } = options;
     if (!existsSync(changelogJsonPath)) {
@@ -36,7 +37,12 @@ export function createGithubRelease(options) {
         console.info(`[dry-run] Would run: gh ${args.join(' ')}`);
         return { status: 'created' };
     }
-    execFileSync('gh', args, { stdio: 'inherit' });
+    try {
+        execFileSync('gh', args, { stdio: 'inherit' });
+    }
+    catch (error) {
+        throw asUserError(error);
+    }
     return { status: 'created' };
 }
 export function createGithubReleases(tags, changelogJsonOutputPath, isDryRun, sectionOrder) {

package/dist/esm/createGithubReleaseCommand.js

@@ -1,5 +1,4 @@
-import { parseArgsOrExit, reportError } from '@williamthorsen/nmr-core';
-import { describeError } from '@williamthorsen/toolbelt.errors';
+import { parseArgsOrExit } from '@williamthorsen/nmr-core';
 import { configFlagSchema } from "./configFlagSchema.js";
 import { createGithubReleases } from "./createGithubRelease.js";
 import { deriveReleaseNotesConfig } from "./deriveReleaseNotesConfig.js";
@@ -8,6 +7,7 @@ import { loadUsableConfig } from "./loadValidatedConfig.js";
 import { parseRequestedTags } from "./parseRequestedTags.js";
 import { resolveCommandTags } from "./resolveCommandTags.js";
 import { resolveConfigFlag } from "./resolveConfigFlag.js";
+import { prefixUserError } from "./user-error-chaining.js";
 const createGithubReleaseFlagSchema = {
     ...configFlagSchema,
     isDryRun: { long: '--dry-run', type: 'boolean' },
@@ -35,8 +35,7 @@ export async function createGithubReleaseCommand(argv, styles, invocationDir) {
         outcome = createGithubReleases(releasableTags, changelogJsonOutputPath, isDryRun, sectionOrder);
     }
     catch (error) {
-        reportError(`Failed to create GitHub Releases: ${describeError(error)}`);
-        process.exit(1);
+        throw prefixUserError('Failed to create GitHub Releases', error);
     }
     if (outcome.skippedTags.length === 0) {
         return;

package/dist/esm/createTags.js

@@ -1,8 +1,9 @@
 import { execFileSync } from 'node:child_process';
-import { formatGlyphLine, GIT_OUTPUT_LIMIT_BYTES, hasErrnoCode } from '@williamthorsen/nmr-core';
+import { formatGlyphLine, GIT_OUTPUT_LIMIT_BYTES, hasErrnoCode, UserError, } from '@williamthorsen/nmr-core';
 import { deleteFileIfExists } from "./deleteFileIfExists.js";
 import { RELEASE_GLYPHS } from "./glyphs.js";
 import { readReleaseTags, RELEASE_SUMMARY_FILE, RELEASE_TAGS_FILE } from "./releaseFiles.js";
+import { asUserError } from "./user-error-chaining.js";
 export function createTags(options) {
     const { isDryRun, shouldSkipGitChecks, style } = options;
     const tags = readReleaseTags();
@@ -26,13 +27,14 @@ export function createTags(options) {
             createdTags.push(tag);
         }
         catch (error) {
+            const failure = asUserError(error);
             if (createdTags.length > 0) {
                 console.warn('Tags created before failure:');
                 for (const tag of createdTags) {
                     console.warn(`  ${tag}`);
                 }
             }
-            throw error;
+            throw failure;
         }
     }
     console.info('Created tags:');
@@ -50,8 +52,8 @@ function assertCleanWorkingTree() {
     }
     catch (error) {
         if (hasErrnoCode(error, 'ENOENT')) {
-            throw error;
+            throw asUserError(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 });
+        throw new UserError('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,5 +1,6 @@
 import { unlinkSync } from 'node:fs';
 import { hasErrnoCode } from '@williamthorsen/nmr-core';
+import { asUserError } from "./user-error-chaining.js";
 export function deleteFileIfExists(filePath) {
     try {
         unlinkSync(filePath);
@@ -8,6 +9,6 @@ export function deleteFileIfExists(filePath) {
         if (hasErrnoCode(error, 'ENOENT')) {
             return;
         }
-        throw error;
+        throw asUserError(error);
     }
 }

package/dist/esm/deriveDirectoryConfig.js

@@ -1,13 +1,14 @@
 import { existsSync, readFileSync, statSync } from 'node:fs';
 import path from 'node:path';
-import { chainError } from '@williamthorsen/toolbelt.errors/candidate';
+import { UserError } from '@williamthorsen/nmr-core';
 import { isRecord } from "./typeGuards.js";
+import { chainUserError } from "./user-error-chaining.js";
 export const DIRECTORY_VERSION_FILE = 'version.json';
 const TAG_PREFIX_PATTERN = /^[\w.-]+$/;
 export function deriveDirectoryConfig(declaredDirectory, root = process.cwd()) {
     const label = `releases.${declaredDirectory.name}`;
     if (statSync(path.resolve(root, declaredDirectory.path), { throwIfNoEntry: false })?.isDirectory() !== true) {
-        throw new Error(`${label}: path '${declaredDirectory.path}' is not a directory; declare a directory that exists in the repo`);
+        throw new UserError(`${label}: path '${declaredDirectory.path}' is not a directory; declare a directory that exists in the repo`);
     }
     const versionFile = resolveVersionFile(declaredDirectory.path, root);
     assertVersionField(label, versionFile, root);
@@ -28,17 +29,17 @@ export function deriveDirectoryConfig(declaredDirectory, root = process.cwd()) {
 function assertVersionField(label, versionFile, root) {
     const absolutePath = path.resolve(root, versionFile);
     if (!existsSync(absolutePath)) {
-        throw new Error(`${label}: ${versionFile} not found; create it with the directory's current version, such as { "version": "0.0.0" }`);
+        throw new UserError(`${label}: ${versionFile} not found; create it with the directory's current version, such as { "version": "0.0.0" }`);
     }
     let parsedJson;
     try {
         parsedJson = JSON.parse(readFileSync(absolutePath, 'utf8'));
     }
     catch (error) {
-        throw chainError(`${label}: failed to read ${versionFile}`, error);
+        throw chainUserError(`${label}: failed to read ${versionFile}`, error);
     }
     if (!isRecord(parsedJson) || typeof parsedJson['version'] !== 'string') {
-        throw new Error(`${label}: ${versionFile} does not contain a string 'version' field; add one`);
+        throw new UserError(`${label}: ${versionFile} does not contain a string 'version' field; add one`);
     }
 }
 function deriveTagPrefix(label, directoryPath) {
@@ -47,7 +48,7 @@ function deriveTagPrefix(label, directoryPath) {
     }
     const basename = path.posix.basename(directoryPath);
     if (!TAG_PREFIX_PATTERN.test(basename)) {
-        throw new Error(`${label}: the directory name '${basename}' cannot form a tag prefix; set tagPrefix, such as '${basename.replaceAll(/[^\w.-]+/g, '-')}-v'`);
+        throw new UserError(`${label}: the directory name '${basename}' cannot form a tag prefix; set tagPrefix, such as '${basename.replaceAll(/[^\w.-]+/g, '-')}-v'`);
     }
     return `${basename}-v`;
 }

package/dist/esm/deriveWorkspaceConfig.js

@@ -1,8 +1,9 @@
 import { readFileSync } from 'node:fs';
 import { basename } from 'node:path';
-import { chainError } from '@williamthorsen/toolbelt.errors/candidate';
+import { UserError } from '@williamthorsen/nmr-core';
 import { isPublishableManifest } from "./isPublishableManifest.js";
 import { isRecord } from "./typeGuards.js";
+import { chainUserError } from "./user-error-chaining.js";
 export function deriveWorkspaceConfig(workspacePath) {
     const dir = basename(workspacePath);
     const packageJsonPath = `${workspacePath}/package.json`;
@@ -11,11 +12,11 @@ export function deriveWorkspaceConfig(workspacePath) {
         parsedJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
     }
     catch (error) {
-        throw chainError(`Failed to read ${packageJsonPath}`, error);
+        throw chainUserError(`Failed to read ${packageJsonPath}`, error);
     }
     const name = isRecord(parsedJson) ? parsedJson['name'] : undefined;
     if (typeof name !== 'string' || name.length === 0) {
-        throw new Error(`${packageJsonPath} is missing a 'name' field (required for tag derivation).`);
+        throw new UserError(`${packageJsonPath} is missing a 'name' field (required for tag derivation).`);
     }
     const unscopedName = stripNpmScope(name);
     const isPublishable = isPublishableManifest(parsedJson);