@williamthorsen/release-kit 16.1.1 → 16.1.2

package/.meta/changelog.json

@@ -1,4 +1,21 @@
 [
+  {
+    "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",

package/.readyup/kits/default.js

@@ -234,7 +234,7 @@ var CREATE_GITHUB_RELEASE_WORKFLOW_HASH_SINGLE = "d6de961de913c67b08dfa7e07f7349
 
 // .readyup/kits/default.ts
 function getMinVersion() {
-  const picked = { "version": "16.1.1" };
+  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/manifest.json

@@ -7,7 +7,7 @@
           "checklist": "release-kit",
           "checks": [
             "@williamthorsen/release-kit in devDependencies",
-            "@williamthorsen/release-kit >= 16.1.1",
+            "@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": "1c9904c3",
+          "hash": "ff1fde3d",
           "kind": "inline",
           "path": "../package.json",
           "paths": [
@@ -101,7 +101,7 @@
       "readyupVersion": "0.45.0",
       "source": "kits/default.ts",
       "sourceHash": "56566d0b",
-      "targetHash": "070a29f8"
+      "targetHash": "6a43de10"
     },
     {
       "checklistChecks": [

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 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

package/README.md

@@ -7,11 +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.1 (2026-11-05)
+## Release notes — v16.1.2 (2026-11-06)
 
 ### 🐛 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)
+- 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/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

@@ -1,240 +1,11 @@
 #!/usr/bin/env node
-import { parseArgsOrExit, reportError, resolveSelfVersion } from '@williamthorsen/nmr-core';
-import { describeError } from '@williamthorsen/toolbelt.errors';
-import { commitCommand } from "./commitCommand.js";
-import { configFlagSchema } from "./configFlagSchema.js";
-import { createGithubReleaseCommand } from "./createGithubReleaseCommand.js";
-import { enterRepoRoot } from "./enterRepoRoot.js";
-import { showInitHelp, showUpdateTemplatesHelp } from "./help/initHelp.js";
-import { showOverridesHelp, showOverridesValidateHelp } from "./help/overridesHelp.js";
-import { showPrepareHelp } from "./help/prepareHelp.js";
-import { showCommitHelp, showCreateGithubReleaseHelp, showPublishHelp, showPushHelp, showShowTagPrefixesHelp, showTagHelp, } from "./help/releaseStepsHelp.js";
-import { showSyncLabelsGenerateHelp, showSyncLabelsHelp, showSyncLabelsInitHelp, showSyncLabelsSyncHelp, } from "./help/syncLabelsHelp.js";
-import { showUsage } from "./help/usage.js";
-import { initCommand } from "./init/initCommand.js";
-import { updateTemplatesCommand } from "./init/updateTemplatesCommand.js";
-import { prepareCommand } from "./prepareCommand.js";
-import { publishCommand } from "./publishCommand.js";
-import { pushCommand } from "./pushCommand.js";
-import { resolveConfigFlag } from "./resolveConfigFlag.js";
-import { resolveStylesOrExit } from "./resolveStylesOrExit.js";
-import { showTagPrefixesCommand } from "./showTagPrefixesCommand.js";
-import { generateCommand } from "./sync-labels/generateCommand.js";
-import { syncLabelsInitCommand } from "./sync-labels/initCommand.js";
-import { syncLabelsCommand } from "./sync-labels/syncCommand.js";
-import { tagCommand } from "./tagCommand.js";
-import { validateOverridesCommand } from "./validateOverridesCommand.js";
-const VERSION = resolveSelfVersion(import.meta.url);
-function enterRepoRootOrExit() {
-    try {
-        return enterRepoRoot();
-    }
-    catch (error) {
-        reportError(describeError(error));
-        process.exit(1);
-    }
+import process from 'node:process';
+import { reportFailure } from '@williamthorsen/nmr-core';
+import { runCli } from "./runCli.js";
+try {
+    await runCli(process.argv.slice(2));
 }
-const args = process.argv.slice(2);
-const command = args[0];
-if (command === '--version' || command === '-V') {
-    console.info(VERSION);
-    process.exit(0);
+catch (error) {
+    reportFailure('release-kit', error);
+    process.exitCode = 1;
 }
-if (command === undefined || ['--help', '-h'].includes(command)) {
-    showUsage();
-    process.exit(0);
-}
-const flags = args.slice(1);
-const styles = resolveStylesOrExit({
-    env: process.env,
-    stderrIsTty: process.stderr.isTTY,
-    stdoutIsTty: process.stdout.isTTY,
-});
-if (command === 'prepare') {
-    if (flags.some((f) => f === '--help' || f === '-h')) {
-        showPrepareHelp();
-        process.exit(0);
-    }
-    const { invocationDir } = enterRepoRootOrExit();
-    await prepareCommand(flags, styles, invocationDir);
-    process.exit(0);
-}
-if (command === 'commit') {
-    if (flags.some((f) => f === '--help' || f === '-h')) {
-        showCommitHelp();
-        process.exit(0);
-    }
-    enterRepoRootOrExit();
-    try {
-        commitCommand(flags);
-    }
-    catch (error) {
-        reportError(describeError(error));
-        process.exit(1);
-    }
-    process.exit(0);
-}
-if (command === 'tag') {
-    if (flags.some((f) => f === '--help' || f === '-h')) {
-        showTagHelp();
-        process.exit(0);
-    }
-    enterRepoRootOrExit();
-    tagCommand(flags, styles);
-    process.exit(0);
-}
-if (command === 'push') {
-    if (flags.some((f) => f === '--help' || f === '-h')) {
-        showPushHelp();
-        process.exit(0);
-    }
-    const { invocationDir } = enterRepoRootOrExit();
-    await pushCommand(flags, styles, invocationDir);
-    process.exit(0);
-}
-if (command === 'create-github-release') {
-    if (flags.some((f) => f === '--help' || f === '-h')) {
-        showCreateGithubReleaseHelp();
-        process.exit(0);
-    }
-    const { invocationDir } = enterRepoRootOrExit();
-    await createGithubReleaseCommand(flags, styles, invocationDir);
-    process.exit(0);
-}
-if (command === 'publish') {
-    if (flags.some((f) => f === '--help' || f === '-h')) {
-        showPublishHelp();
-        process.exit(0);
-    }
-    const { invocationDir } = enterRepoRootOrExit();
-    await publishCommand(flags, styles, invocationDir);
-    process.exit(0);
-}
-if (command === 'show-tag-prefixes') {
-    if (flags.some((f) => f === '--help' || f === '-h')) {
-        showShowTagPrefixesHelp();
-        process.exit(0);
-    }
-    const { invocationDir } = enterRepoRootOrExit();
-    const { config } = parseArgsOrExit(flags, configFlagSchema).flags;
-    const exitCode = await showTagPrefixesCommand(styles, resolveConfigFlag(config, invocationDir));
-    process.exit(exitCode);
-}
-if (command === 'init') {
-    if (flags.some((f) => f === '--help' || f === '-h')) {
-        showInitHelp();
-        process.exit(0);
-    }
-    enterRepoRootOrExit();
-    const initFlagSchema = {
-        isDryRun: { long: '--dry-run', type: 'boolean' },
-        shouldForce: { long: '--force', type: 'boolean' },
-        shouldScaffoldConfig: { long: '--with-config', type: 'boolean' },
-    };
-    const { isDryRun, shouldForce, shouldScaffoldConfig } = parseArgsOrExit(flags, initFlagSchema).flags;
-    const exitCode = initCommand({ isDryRun, shouldForce, styles, shouldScaffoldConfig });
-    process.exit(exitCode);
-}
-if (command === 'update-templates') {
-    if (flags.some((f) => f === '--help' || f === '-h')) {
-        showUpdateTemplatesHelp();
-        process.exit(0);
-    }
-    enterRepoRootOrExit();
-    const updateTemplatesFlagSchema = {
-        isDryRun: { long: '--dry-run', type: 'boolean' },
-    };
-    const { isDryRun } = parseArgsOrExit(flags, updateTemplatesFlagSchema).flags;
-    const exitCode = updateTemplatesCommand({ isDryRun, styles });
-    process.exit(exitCode);
-}
-if (command === 'sync-labels') {
-    const subcommand = flags[0];
-    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();
-            process.exit(0);
-        }
-        const { invocationDir } = enterRepoRootOrExit();
-        const syncLabelsInitFlagSchema = {
-            ...configFlagSchema,
-            isDryRun: { long: '--dry-run', type: 'boolean' },
-            shouldForce: { long: '--force', type: 'boolean' },
-        };
-        const { config, isDryRun, shouldForce } = parseArgsOrExit(subflags, syncLabelsInitFlagSchema).flags;
-        const configPath = resolveConfigFlag(config, invocationDir);
-        const exitCode = await syncLabelsInitCommand({
-            ...(configPath !== undefined && { configPath }),
-            isDryRun,
-            shouldForce,
-            styles,
-        });
-        process.exit(exitCode);
-    }
-    if (subcommand === 'generate') {
-        if (subflags.some((f) => f === '--help' || f === '-h')) {
-            showSyncLabelsGenerateHelp();
-            process.exit(0);
-        }
-        const { invocationDir } = enterRepoRootOrExit();
-        const generateFlagSchema = {
-            ...configFlagSchema,
-            shouldCheck: { long: '--check', type: 'boolean' },
-        };
-        const { shouldCheck, config } = parseArgsOrExit(subflags, generateFlagSchema).flags;
-        const configPath = resolveConfigFlag(config, invocationDir);
-        const exitCode = await generateCommand({ shouldCheck, ...(configPath !== undefined && { configPath }), styles });
-        process.exit(exitCode);
-    }
-    if (subcommand === 'sync') {
-        if (subflags.some((f) => f === '--help' || f === '-h')) {
-            showSyncLabelsSyncHelp();
-            process.exit(0);
-        }
-        if (subflags.length > 0) {
-            reportError(`Unknown option: ${subflags[0]}`);
-            process.exit(1);
-        }
-        enterRepoRootOrExit();
-        const exitCode = syncLabelsCommand();
-        process.exit(exitCode);
-    }
-    reportError(`Unknown subcommand: ${subcommand}`);
-    showSyncLabelsHelp();
-    process.exit(1);
-}
-if (command === 'overrides') {
-    const subcommand = flags[0];
-    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();
-            process.exit(0);
-        }
-        const { invocationDir } = enterRepoRootOrExit();
-        const { config } = parseArgsOrExit(subflags, configFlagSchema).flags;
-        const result = await validateOverridesCommand(styles, resolveConfigFlag(config, invocationDir));
-        if (result.exitCode === 0) {
-            console.info(result.message);
-        }
-        else {
-            process.stderr.write(`${result.message}\n`);
-        }
-        process.exit(result.exitCode);
-    }
-    reportError(`Unknown subcommand: ${subcommand}`);
-    showOverridesHelp();
-    process.exit(1);
-}
-reportError(`Unknown command: ${command}`);
-showUsage();
-process.exit(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;