@williamthorsen/release-kit 5.3.2 → 6.0.0

package/CHANGELOG.md

@@ -2,6 +2,38 @@
 
 All notable changes to this project will be documented in this file.
 
+## 6.0.0 — 2026-06-30
+
+### 🎉 Features
+
+- 🚨 **Breaking:** Auto-activate integration test variant from config presence (#448)
+
+  A package can now separate its integration tests from its standalone suite simply by including a `vitest.integration.config.ts` (alongside a `vitest.standalone.config.ts`). The `--int-test` flag that previously enabled this is removed — that config-file pairing is now the only way to activate the separation. In such a package, `test` and `test:coverage` run only the standalone suite and skip integration tests, while a new `test:all` runs both suites together. The separation now holds even when tests run across every package at once, so a full-workspace `test` run still keeps integration tests out of the default suite. Packages that previously hand-copied these test scripts no longer need to.
+
+### ♻️ Refactoring
+
+- Consolidate prepare parsing onto parseArgsOrExit (#441)
+
+  Makes `release-kit`'s `prepare` command report invalid arguments the same way its other commands already do. The error message and exit code a user sees for a bad argument are unchanged.
+
+- Unify prepare help text into a testable module (#443)
+
+  Running `release-kit prepare --help` now lists the complete set of options. The `--force` flag and the restriction that `--set-version` and `--only` cannot be used when a project block is configured were previously missing from the help and are now shown there; the same `--set-version` restriction was added to the package README's `prepare` reference.
+
+### 📚 Documentation
+
+- Document single-package --force rejection in release-kit prepare (#450)
+
+  The `release-kit prepare` `--force` documentation now correctly describes per-mode behavior: a bare `--force` is rejected in a single-package repo, where an explicit `--bump` level must be passed, while the "defaults to patch" shortcut applies only in monorepo and project mode.
+
+## 5.4.0 — 2026-06-27
+
+### 🎉 Features
+
+- Centralize the per-package build as an nmr-compile bin (#419)
+
+  Introduces `nmr-compile`, a single command shipped with `@williamthorsen/nmr` that compiles each workspace package and now backs the default build. Consuming repos can delete their own per-package build script and pick up future build fixes just by upgrading nmr. Repeated builds with unchanged source now reliably skip recompiling instead of occasionally rebuilding for no reason, and import aliases now resolve correctly in symlinked checkouts.
+
 ## 5.3.2 — 2026-06-16
 
 ### ♻️ Refactoring

package/README.md

@@ -4,7 +4,15 @@ 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 — v6.0.0 (2026-06-30)
+
+### 🎉 Features
+
+- 🚨 **Breaking:** Auto-activate integration test variant from config presence (#448)
+
+  A package can now separate its integration tests from its standalone suite simply by including a `vitest.integration.config.ts` (alongside a `vitest.standalone.config.ts`). The `--int-test` flag that previously enabled this is removed — that config-file pairing is now the only way to activate the separation. In such a package, `test` and `test:coverage` run only the standalone suite and skip integration tests, while a new `test:all` runs both suites together. The separation now holds even when tests run across every package at once, so a full-workspace `test` run still keeps integration tests out of the default suite. Packages that previously hand-copied these test scripts no longer need to.
+<!-- /section:release-notes -->
 
 ## Installation
 
@@ -549,15 +557,15 @@ The first release that ships under the new renderer will produce a one-time nois
 
 Run release preparation with automatic workspace discovery.
 
-| Flag                         | Description                                                                                                                                        |
-| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `--dry-run`                  | Preview changes without writing files                                                                                                              |
-| `--bump=major\|minor\|patch` | Override the bump type for all workspaces                                                                                                          |
-| `--set-version=X.Y.Z`        | Set an explicit canonical semver version; bypasses commit-derived bumps. Requires `--only` in monorepo mode.                                       |
-| `--force`                    | Release even when no commits or no bump-worthy commits exist since the last tag (defaults to patch; combine with `--bump=X` for a different level) |
-| `--only=name1,name2`         | Only process the named workspaces (monorepo only; rejected when a `project` block is configured)                                                   |
-| `--with-release-notes`       | Write per-workspace release-notes previews under `{workspacePath}/docs/`                                                                           |
-| `--help`, `-h`               | Show help                                                                                                                                          |
+| Flag                         | Description                                                                                                                                                                                                                                                             |
+| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `--dry-run`                  | Preview changes without writing files                                                                                                                                                                                                                                   |
+| `--bump=major\|minor\|patch` | Override the bump type for all workspaces                                                                                                                                                                                                                               |
+| `--set-version=X.Y.Z`        | Set an explicit canonical semver version; bypasses commit-derived bumps. Requires `--only` in monorepo mode (rejected when a `project` block is configured).                                                                                                            |
+| `--force`                    | Release even when no commits or no bump-worthy commits exist since the last tag. In monorepo/project mode, defaults to patch (combine with `--bump=X` for a different level); in single-package mode, a bare `--force` is rejected — pass `--bump=major\|minor\|patch`. |
+| `--only=name1,name2`         | Only process the named workspaces (monorepo only; rejected when a `project` block is configured)                                                                                                                                                                        |
+| `--with-release-notes`       | Write per-workspace release-notes previews under `{workspacePath}/docs/`                                                                                                                                                                                                |
+| `--help`, `-h`               | Show help                                                                                                                                                                                                                                                               |
 
 Workspace names for `--only` match the package directory name (e.g., `arrays`, `release-kit`).
 

package/dist/esm/.cache

@@ -1 +1 @@
-a675735fcc8ee6abbe7201c05a9cec6517a6495d796f61322b141ed79e4e7bcf
+5ed41ffb0267b5678fc3b3273d6104a1c1c120fea20f92d48e173aee3ae9e2f5

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

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
-import { parseArgs, readPackageVersion, translateParseError } from "@williamthorsen/nmr-core";
+import { parseArgsOrExit, readPackageVersion, reportError } from "@williamthorsen/nmr-core";
 import { checkWorkTypesDrift } from "../checkWorkTypesDrift.js";
 import { commitCommand } from "../commitCommand.js";
 import { createGithubReleaseCommand } from "../createGithubReleaseCommand.js";
+import { showPrepareHelp } from "../help/prepareHelp.js";
 import { initCommand } from "../init/initCommand.js";
 import { prepareCommand } from "../prepareCommand.js";
 import { publishCommand } from "../publishCommand.js";
@@ -99,24 +100,6 @@ Options:
   --help, -h      Show this help message
 `);
 }
-function showPrepareHelp() {
-  console.info(`
-Usage: release-kit prepare [options]
-
-Run release preparation with automatic workspace discovery.
-
-Options:
-  --dry-run             Run without modifying any files
-  --bump=major|minor|patch  Override the bump type for all workspaces
-  --set-version=X.Y.Z   Set an explicit version; bypasses commit-derived bumps. Requires --only in monorepo mode.
-  --no-git-checks, -n   Skip the clean-working-tree check
-  --only=name1,name2    Only process the named workspaces (comma-separated, monorepo only)
-  --with-release-notes  Also write per-workspace release-notes previews under {workspacePath}/docs/
-                         (docs/README.v{version}.md and docs/RELEASE_NOTES.v{version}.md).
-                         Recommended .gitignore entry: packages/*/docs/*.v*.md (or docs/*.v*.md).
-  --help, -h            Show this help message
-`);
-}
 function showCommitHelp() {
   console.info(`
 Usage: release-kit commit [options]
@@ -295,7 +278,7 @@ if (command === "commit") {
   try {
     commitCommand(flags);
   } catch (error) {
-    console.error(error instanceof Error ? error.message : String(error));
+    reportError(error instanceof Error ? error.message : String(error));
     process.exit(1);
   }
   process.exit(0);
@@ -338,7 +321,7 @@ if (command === "show-tag-prefixes") {
     process.exit(0);
   }
   if (flags.length > 0) {
-    console.error(`Error: Unknown option: ${flags[0]}`);
+    reportError(`Unknown option: ${flags[0]}`);
     process.exit(1);
   }
   const exitCode = await showTagPrefixesCommand();
@@ -354,14 +337,7 @@ if (command === "init") {
     force: { long: "--force", type: "boolean" },
     withConfig: { long: "--with-config", type: "boolean" }
   };
-  let parsed;
-  try {
-    parsed = parseArgs(flags, initFlagSchema);
-  } catch (error) {
-    console.error(`Error: ${translateParseError(error)}`);
-    process.exit(1);
-  }
-  const { dryRun, force, withConfig } = parsed.flags;
+  const { dryRun, force, withConfig } = parseArgsOrExit(flags, initFlagSchema).flags;
   const exitCode = initCommand({ dryRun, force, withConfig });
   process.exit(exitCode);
 }
@@ -381,14 +357,7 @@ if (command === "sync-labels") {
       dryRun: { long: "--dry-run", type: "boolean" },
       force: { long: "--force", type: "boolean" }
     };
-    let syncParsed;
-    try {
-      syncParsed = parseArgs(subflags, syncLabelsInitFlagSchema);
-    } catch (error) {
-      console.error(`Error: ${translateParseError(error)}`);
-      process.exit(1);
-    }
-    const { dryRun, force } = syncParsed.flags;
+    const { dryRun, force } = parseArgsOrExit(subflags, syncLabelsInitFlagSchema).flags;
     const exitCode = await syncLabelsInitCommand({ dryRun, force });
     process.exit(exitCode);
   }
@@ -398,7 +367,7 @@ if (command === "sync-labels") {
       process.exit(0);
     }
     if (subflags.length > 0) {
-      console.error(`Error: Unknown option: ${subflags[0]}`);
+      reportError(`Unknown option: ${subflags[0]}`);
       process.exit(1);
     }
     const exitCode = await generateCommand();
@@ -410,13 +379,13 @@ if (command === "sync-labels") {
       process.exit(0);
     }
     if (subflags.length > 0) {
-      console.error(`Error: Unknown option: ${subflags[0]}`);
+      reportError(`Unknown option: ${subflags[0]}`);
       process.exit(1);
     }
     const exitCode = syncLabelsCommand();
     process.exit(exitCode);
   }
-  console.error(`Error: Unknown subcommand: ${subcommand}`);
+  reportError(`Unknown subcommand: ${subcommand}`);
   showSyncLabelsHelp();
   process.exit(1);
 }
@@ -433,18 +402,19 @@ if (command === "overrides") {
       process.exit(0);
     }
     if (subflags.length > 0) {
-      console.error(`Error: Unknown option: ${subflags[0]}`);
+      reportError(`Unknown option: ${subflags[0]}`);
       process.exit(1);
     }
     const result = await validateOverridesCommand();
     if (result.exitCode === 0) {
       console.info(result.message);
     } else {
-      console.error(result.message);
+      process.stderr.write(`${result.message}
+`);
     }
     process.exit(result.exitCode);
   }
-  console.error(`Error: Unknown subcommand: ${subcommand}`);
+  reportError(`Unknown subcommand: ${subcommand}`);
   showOverridesHelp();
   process.exit(1);
 }
@@ -461,14 +431,15 @@ if (command === "work-types") {
       process.exit(0);
     }
     if (subflags.length > 0) {
-      console.error(`Error: Unknown option: ${subflags[0]}`);
+      reportError(`Unknown option: ${subflags[0]}`);
       process.exit(1);
     }
     const result = await checkWorkTypesDrift();
     if (result.exitCode === 0) {
       console.info(result.message);
     } else {
-      console.error(result.message);
+      process.stderr.write(`${result.message}
+`);
     }
     process.exit(result.exitCode);
   }
@@ -478,21 +449,22 @@ if (command === "work-types") {
       process.exit(0);
     }
     if (subflags.length > 0) {
-      console.error(`Error: Unknown option: ${subflags[0]}`);
+      reportError(`Unknown option: ${subflags[0]}`);
       process.exit(1);
     }
     const result = await syncWorkTypes();
     if (result.exitCode === 0) {
       console.info(result.message);
     } else {
-      console.error(result.message);
+      process.stderr.write(`${result.message}
+`);
     }
     process.exit(result.exitCode);
   }
-  console.error(`Error: Unknown subcommand: ${subcommand}`);
+  reportError(`Unknown subcommand: ${subcommand}`);
   showWorkTypesHelp();
   process.exit(1);
 }
-console.error(`Error: Unknown command: ${command}`);
+reportError(`Unknown command: ${command}`);
 showUsage();
 process.exit(1);

package/dist/esm/checkWorkTypesDrift.js

@@ -1,6 +1,7 @@
 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";
 const UPSTREAM_WORK_TYPES_URL = "https://raw.githubusercontent.com/williamthorsen/codeassembly/main/packages/agents/content/skills/_data/work-types.json";
 function resolveDefaultLocalPath() {
@@ -28,7 +29,7 @@ async function checkWorkTypesDrift(dependencies = {}) {
   } catch (error) {
     return {
       exitCode: 2,
-      message: `Network error fetching upstream work-types.json: ${errorMessage(error)}`
+      message: formatErrorLine(`Failed to fetch upstream work-types.json: ${errorMessage(error)}`)
     };
   }
   if (response.status === 404) {
@@ -40,7 +41,9 @@ async function checkWorkTypesDrift(dependencies = {}) {
   if (!response.ok) {
     return {
       exitCode: 2,
-      message: `Failed to fetch upstream work-types.json: HTTP ${response.status} ${response.statusText}`
+      message: formatErrorLine(
+        `Failed to fetch upstream work-types.json: HTTP ${response.status} ${response.statusText}`
+      )
     };
   }
   const upstreamText = await response.text();

package/dist/esm/commitCommand.js

@@ -1,19 +1,12 @@
 import { execFileSync } from "node:child_process";
 import { readFileSync } from "node:fs";
-import { parseArgs, translateParseError } from "@williamthorsen/nmr-core";
+import { parseArgsOrExit } from "@williamthorsen/nmr-core";
 import { RELEASE_SUMMARY_FILE, RELEASE_TAGS_FILE } from "./prepareCommand.js";
 const commitFlagSchema = {
   dryRun: { long: "--dry-run", type: "boolean" }
 };
 function commitCommand(argv) {
-  let parsed;
-  try {
-    parsed = parseArgs(argv, commitFlagSchema);
-  } catch (error) {
-    console.error(`Error: ${translateParseError(error)}`);
-    process.exit(1);
-  }
-  const dryRun = parsed.flags.dryRun;
+  const dryRun = parseArgsOrExit(argv, commitFlagSchema).flags.dryRun;
   let tagsContent;
   try {
     tagsContent = readFileSync(RELEASE_TAGS_FILE, "utf8");

package/dist/esm/createGithubReleaseCommand.js

@@ -1,4 +1,4 @@
-import { parseArgs, translateParseError } from "@williamthorsen/nmr-core";
+import { parseArgsOrExit, reportError } from "@williamthorsen/nmr-core";
 import { createGithubReleases } from "./createGithubRelease.js";
 import { parseRequestedTags } from "./parseRequestedTags.js";
 import { resolveCommandTags } from "./resolveCommandTags.js";
@@ -8,13 +8,7 @@ const createGithubReleaseFlagSchema = {
   tags: { long: "--tags", type: "string" }
 };
 async function createGithubReleaseCommand(argv) {
-  let parsed;
-  try {
-    parsed = parseArgs(argv, createGithubReleaseFlagSchema);
-  } catch (error) {
-    console.error(`Error: ${translateParseError(error)}`);
-    process.exit(1);
-  }
+  const parsed = parseArgsOrExit(argv, createGithubReleaseFlagSchema);
   const { dryRun } = parsed.flags;
   const requestedTags = parseRequestedTags(parsed.flags.tags);
   const resolvedTags = await resolveCommandTags(requestedTags);
@@ -23,7 +17,7 @@ async function createGithubReleaseCommand(argv) {
   try {
     outcome = createGithubReleases(resolvedTags, changelogJsonOutputPath, dryRun, sectionOrder);
   } catch (error) {
-    console.error(`Error creating GitHub Releases: ${error instanceof Error ? error.message : String(error)}`);
+    reportError(`Failed to create GitHub Releases: ${error instanceof Error ? error.message : String(error)}`);
     process.exit(1);
   }
   if (outcome.skipped.length > 0) {

package/dist/esm/help/prepareHelp.d.ts

@@ -0,0 +1,2 @@
+export declare const prepareHelpText = "\nUsage: release-kit prepare [options]\n\nRun release preparation with automatic workspace discovery.\n\nOptions:\n  --dry-run             Run without modifying any files\n  --bump=major|minor|patch  Override the bump type for all workspaces\n  --set-version=X.Y.Z   Set an explicit version; bypasses commit-derived bumps.\n                         Requires --only in monorepo mode (rejected when a 'project' block is configured).\n  --force               Release even when no commits or no bump-worthy commits exist\n                         since the last tag. In monorepo and project mode, defaults to\n                         patch when --bump is not given; use --bump=X for a different\n                         level. In single-package mode, a bare --force is rejected \u2014\n                         pass --bump=major|minor|patch.\n  --no-git-checks, -n   Skip the clean-working-tree check\n  --only=name1,name2    Only process the named workspaces (comma-separated, monorepo only;\n                         rejected when a 'project' block is configured)\n  --with-release-notes  Also write per-workspace release-notes previews under {workspacePath}/docs/\n                         (docs/README.v{version}.md and docs/RELEASE_NOTES.v{version}.md).\n                         Recommended .gitignore entry: packages/*/docs/*.v*.md (or docs/*.v*.md).\n  --help, -h            Show this help message\n";
+export declare function showPrepareHelp(): void;

package/dist/esm/help/prepareHelp.js

@@ -0,0 +1,30 @@
+const prepareHelpText = `
+Usage: release-kit prepare [options]
+
+Run release preparation with automatic workspace discovery.
+
+Options:
+  --dry-run             Run without modifying any files
+  --bump=major|minor|patch  Override the bump type for all workspaces
+  --set-version=X.Y.Z   Set an explicit version; bypasses commit-derived bumps.
+                         Requires --only in monorepo mode (rejected when a 'project' block is configured).
+  --force               Release even when no commits or no bump-worthy commits exist
+                         since the last tag. In monorepo and project mode, defaults to
+                         patch when --bump is not given; use --bump=X for a different
+                         level. In single-package mode, a bare --force is rejected \u2014
+                         pass --bump=major|minor|patch.
+  --no-git-checks, -n   Skip the clean-working-tree check
+  --only=name1,name2    Only process the named workspaces (comma-separated, monorepo only;
+                         rejected when a 'project' block is configured)
+  --with-release-notes  Also write per-workspace release-notes previews under {workspacePath}/docs/
+                         (docs/README.v{version}.md and docs/RELEASE_NOTES.v{version}.md).
+                         Recommended .gitignore entry: packages/*/docs/*.v*.md (or docs/*.v*.md).
+  --help, -h            Show this help message
+`;
+function showPrepareHelp() {
+  console.info(prepareHelpText);
+}
+export {
+  prepareHelpText,
+  showPrepareHelp
+};

package/dist/esm/prepareCommand.d.ts

@@ -2,6 +2,37 @@ import type { WriteResult } from '@williamthorsen/nmr-core';
 import type { ReleaseType } from './types.ts';
 export declare const RELEASE_TAGS_FILE = "tmp/.release-tags";
 export declare const RELEASE_SUMMARY_FILE = "tmp/.release-summary";
+export declare const prepareFlagSchema: {
+    dryRun: {
+        long: string;
+        type: "boolean";
+    };
+    force: {
+        long: string;
+        type: "boolean";
+    };
+    noGitChecks: {
+        long: string;
+        type: "boolean";
+        short: string;
+    };
+    bump: {
+        long: string;
+        type: "string";
+    };
+    setVersion: {
+        long: string;
+        type: "string";
+    };
+    only: {
+        long: string;
+        type: "string";
+    };
+    withReleaseNotes: {
+        long: string;
+        type: "boolean";
+    };
+};
 export declare function parseArgs(argv: string[]): {
     dryRun: boolean;
     force: boolean;

package/dist/esm/prepareCommand.js

@@ -1,4 +1,4 @@
-import { parseArgs as coreParseArgs, translateParseError, writeFileWithCheck } from "@williamthorsen/nmr-core";
+import { parseArgsOrExit, reportError, writeFileWithCheck } from "@williamthorsen/nmr-core";
 import { assertCleanWorkingTree } from "./assertCleanWorkingTree.js";
 import { buildDependencyGraph } from "./buildDependencyGraph.js";
 import { buildReleaseSummary } from "./buildReleaseSummary.js";
@@ -18,27 +18,6 @@ const CANONICAL_SEMVER_PATTERN = /^\d+\.\d+\.\d+$/;
 function isReleaseType(value) {
   return VALID_BUMP_TYPES.includes(value);
 }
-function showHelp() {
-  console.info(`
-Usage: npx @williamthorsen/release-kit prepare [options]
-
-Options:
-  --dry-run             Run without modifying any files
-  --bump=major|minor|patch  Override the bump type for all workspaces
-  --set-version=X.Y.Z   Set an explicit version; bypasses commit-derived bumps.
-                         Requires --only in monorepo mode (rejected when a 'project' block is configured).
-  --force               Release even when no commits or no bump-worthy commits exist
-                         since the last tag. Defaults to patch when --bump is not given;
-                         use --bump=X to release at a different level.
-  --no-git-checks, -n   Skip the clean-working-tree check
-  --only=name1,name2    Only process the named workspaces (comma-separated, monorepo only;
-                         rejected when a 'project' block is configured)
-  --with-release-notes  Also write per-workspace release-notes previews under {workspacePath}/docs/
-                         (docs/README.v{version}.md and docs/RELEASE_NOTES.v{version}.md).
-                         Recommended .gitignore entry: packages/*/docs/*.v*.md (or docs/*.v*.md).
-  --help                Show this help message
-`);
-}
 const prepareFlagSchema = {
   dryRun: { long: "--dry-run", type: "boolean" },
   force: { long: "--force", type: "boolean" },
@@ -50,34 +29,25 @@ const prepareFlagSchema = {
   bump: { long: "--bump", type: "string" },
   setVersion: { long: "--set-version", type: "string" },
   only: { long: "--only", type: "string" },
-  withReleaseNotes: { long: "--with-release-notes", type: "boolean" },
-  help: { long: "--help", type: "boolean", short: "-h" }
+  withReleaseNotes: { long: "--with-release-notes", type: "boolean" }
 };
 function parseArgs(argv) {
-  let parsed;
-  try {
-    parsed = coreParseArgs(argv, prepareFlagSchema);
-  } catch (error) {
-    throw new Error(translateParseError(error));
-  }
-  const { flags } = parsed;
-  if (flags.help) {
-    showHelp();
-    process.exit(0);
-  }
+  const { flags } = parseArgsOrExit(argv, prepareFlagSchema);
   let bumpOverride;
   if (flags.bump !== void 0) {
     if (!isReleaseType(flags.bump)) {
-      throw new Error(`Invalid bump type "${flags.bump}". Must be one of: ${VALID_BUMP_TYPES.join(", ")}`);
+      reportError(`Invalid bump type "${flags.bump}". Must be one of: ${VALID_BUMP_TYPES.join(", ")}`);
+      process.exit(1);
     }
     bumpOverride = flags.bump;
   }
   let setVersion;
   if (flags.setVersion !== void 0) {
     if (!CANONICAL_SEMVER_PATTERN.test(flags.setVersion)) {
-      throw new Error(
+      reportError(
         `Invalid --set-version value "${flags.setVersion}". Must be canonical semver (N.N.N, no pre-release suffix).`
       );
+      process.exit(1);
     }
     setVersion = flags.setVersion;
   }
@@ -86,10 +56,12 @@ function parseArgs(argv) {
     only = flags.only.split(",");
   }
   if (setVersion !== void 0 && bumpOverride !== void 0) {
-    throw new Error("--set-version cannot be combined with --bump");
+    reportError("--set-version cannot be combined with --bump");
+    process.exit(1);
   }
   if (setVersion !== void 0 && flags.force) {
-    throw new Error("--set-version cannot be combined with --force");
+    reportError("--set-version cannot be combined with --force");
+    process.exit(1);
   }
   return {
     dryRun: flags.dryRun,
@@ -111,19 +83,7 @@ function writeReleaseTags(tags, dryRun) {
   });
 }
 async function prepareCommand(argv) {
-  let dryRun;
-  let force;
-  let noGitChecks;
-  let bumpOverride;
-  let only;
-  let setVersion;
-  let withReleaseNotes;
-  try {
-    ({ dryRun, force, noGitChecks, bumpOverride, only, setVersion, withReleaseNotes } = parseArgs(argv));
-  } catch (error) {
-    console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
-    process.exit(1);
-  }
+  const { dryRun, force, noGitChecks, bumpOverride, only, setVersion, withReleaseNotes } = parseArgs(argv);
   const options = {
     dryRun,
     force,
@@ -138,7 +98,7 @@ async function prepareCommand(argv) {
     try {
       assertCleanWorkingTree();
     } catch (error) {
-      console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
+      reportError(error instanceof Error ? error.message : String(error));
       process.exit(1);
     }
   }
@@ -147,7 +107,7 @@ async function prepareCommand(argv) {
   try {
     discoveredPaths = await discoverWorkspaces();
   } catch (error) {
-    console.error(`Error discovering workspaces: ${error instanceof Error ? error.message : String(error)}`);
+    reportError(`Failed to discover workspaces: ${error instanceof Error ? error.message : String(error)}`);
     process.exit(1);
   }
   if (discoveredPaths === void 0) {
@@ -158,12 +118,12 @@ async function prepareCommand(argv) {
 }
 function runSinglePackageMode(userConfig, options, only, dryRun) {
   if (only !== void 0) {
-    console.error("Error: --only is only supported for monorepo configurations");
+    reportError("--only is only supported for monorepo configurations");
     process.exit(1);
   }
   if (options.force && options.bumpOverride === void 0) {
-    console.error(
-      "Error: --force without --bump is only supported for monorepo configurations. Use --bump=major|minor|patch to set the level for a single-package release."
+    reportError(
+      "--force without --bump is only supported for monorepo configurations. Use --bump=major|minor|patch to set the level for a single-package release."
     );
     process.exit(1);
   }
@@ -176,18 +136,18 @@ function runMonorepoMode(discoveredPaths, userConfig, options, only, setVersion,
     const rootPackage = readRootPackageVersion();
     config = mergeMonorepoConfig(discoveredPaths, userConfig, rootPackage);
   } catch (error) {
-    console.error(`Error resolving workspaces: ${error instanceof Error ? error.message : String(error)}`);
+    reportError(`Failed to resolve workspaces: ${error instanceof Error ? error.message : String(error)}`);
     process.exit(1);
   }
   if (setVersion !== void 0 && config.project !== void 0) {
-    console.error(
-      "Error: --set-version cannot be combined with a project release. --set-version operates on a single workspace; a project release rolls up every contributing workspace. To use --set-version, run on a config without a `project` block."
+    reportError(
+      "--set-version cannot be combined with a project release. --set-version operates on a single workspace; a project release rolls up every contributing workspace. To use --set-version, run on a config without a `project` block."
     );
     process.exit(1);
   }
   if (only !== void 0 && config.project !== void 0) {
-    console.error(
-      "Error: --only cannot be combined with a project release. To release a single workspace, use a config without a `project` block, or run a full `prepare` (no --only) to include the project release."
+    reportError(
+      "--only cannot be combined with a project release. To release a single workspace, use a config without a `project` block, or run a full `prepare` (no --only) to include the project release."
     );
     process.exit(1);
   }
@@ -195,7 +155,7 @@ function runMonorepoMode(discoveredPaths, userConfig, options, only, setVersion,
     const knownNames = config.workspaces.map((w) => w.dir);
     for (const name of only) {
       if (!knownNames.includes(name)) {
-        console.error(`Error: Unknown workspace "${name}". Known workspaces: ${knownNames.join(", ")}`);
+        reportError(`Unknown workspace "${name}". Known workspaces: ${knownNames.join(", ")}`);
         process.exit(1);
       }
     }
@@ -209,26 +169,27 @@ function runMonorepoMode(discoveredPaths, userConfig, options, only, setVersion,
       return { has: result.commits.length > 0, tag: result.tag };
     });
     if (violations !== void 0) {
-      console.error("Error: --only excludes packages with changes that would be stranded by the release.");
-      console.error("The following packages must be added to --only or have their dependencies removed:");
+      reportError("--only excludes packages with changes that would be stranded by the release.");
+      process.stderr.write("The following packages must be added to --only or have their dependencies removed:\n");
       for (const violation of violations) {
         const since = violation.tag ?? "the beginning";
-        console.error(`  - ${violation.dir} (downstream of ${violation.downstreamOf}; has commits since ${since})`);
+        process.stderr.write(
+          `  - ${violation.dir} (downstream of ${violation.downstreamOf}; has commits since ${since})
+`
+        );
       }
-      console.error("Alternatively, run `release-kit prepare` without --only to release everything.");
+      process.stderr.write("Alternatively, run `release-kit prepare` without --only to release everything.\n");
       process.exit(1);
     }
     config.workspaces = config.workspaces.filter((w) => only.includes(w.dir));
   }
   if (setVersion !== void 0) {
     if (only === void 0) {
-      console.error("Error: --set-version requires --only in monorepo mode");
+      reportError("--set-version requires --only in monorepo mode");
       process.exit(1);
     }
     if (config.workspaces.length !== 1) {
-      console.error(
-        `Error: --set-version requires --only to match exactly one workspace; matched ${config.workspaces.length}`
-      );
+      reportError(`--set-version requires --only to match exactly one workspace; matched ${config.workspaces.length}`);
       process.exit(1);
     }
   }
@@ -239,7 +200,7 @@ async function loadAndValidateConfig() {
   try {
     rawConfig = await loadConfig();
   } catch (error) {
-    console.error(`Error loading config: ${error instanceof Error ? error.message : String(error)}`);
+    reportError(`Failed to load config: ${error instanceof Error ? error.message : String(error)}`);
     process.exit(1);
   }
   if (rawConfig === void 0) {
@@ -247,9 +208,10 @@ async function loadAndValidateConfig() {
   }
   const { config, errors, warnings } = validateConfig(rawConfig);
   if (errors.length > 0) {
-    console.error("Invalid config:");
+    process.stderr.write("Invalid config:\n");
     for (const err of errors) {
-      console.error(`  \u274C ${err}`);
+      process.stderr.write(`  \u274C ${err}
+`);
     }
     process.exit(1);
   }
@@ -263,13 +225,13 @@ function runAndReport(execute, dryRun) {
   try {
     result = execute();
   } catch (error) {
-    console.error(error instanceof Error ? error.message : String(error));
+    reportError(error instanceof Error ? error.message : String(error));
     process.exit(1);
   }
   process.stdout.write(reportPrepare(result) + "\n");
   const writeResult = writeReleaseTags(result.tags, dryRun);
   if (writeResult?.outcome === "failed") {
-    console.error(`Error writing release tags: ${writeResult.error ?? "unknown error"}`);
+    reportError(`Failed to write release tags: ${writeResult.error ?? "unknown error"}`);
     process.exit(1);
   }
   if (writeResult) {
@@ -288,7 +250,7 @@ function runAndReport(execute, dryRun) {
       overwrite: true
     });
     if (summaryResult.outcome === "failed") {
-      console.error(`Error writing release summary: ${summaryResult.error ?? "unknown error"}`);
+      reportError(`Failed to write release summary: ${summaryResult.error ?? "unknown error"}`);
       process.exit(1);
     }
     if (dryRun) {
@@ -298,8 +260,9 @@ function runAndReport(execute, dryRun) {
     }
   }
   if (writeResult && !dryRun) {
-    console.error(`
-Run 'release-kit commit' to create the release commit.`);
+    process.stderr.write(`
+Run 'release-kit commit' to create the release commit.
+`);
   }
 }
 export {
@@ -307,5 +270,6 @@ export {
   RELEASE_TAGS_FILE,
   parseArgs,
   prepareCommand,
+  prepareFlagSchema,
   writeReleaseTags
 };

package/dist/esm/publishCommand.js

@@ -1,6 +1,6 @@
 import { writeFileSync } from "node:fs";
 import { join } from "node:path";
-import { parseArgs, translateParseError } from "@williamthorsen/nmr-core";
+import { parseArgsOrExit, reportError } from "@williamthorsen/nmr-core";
 import { assertCleanWorkingTree } from "./assertCleanWorkingTree.js";
 import { detectPackageManager } from "./detectPackageManager.js";
 import { injectReleaseNotesIntoReadme, resolveReadmePath } from "./injectReleaseNotesIntoReadme.js";
@@ -15,19 +15,13 @@ const publishFlagSchema = {
   tags: { long: "--tags", type: "string" }
 };
 async function publishCommand(argv) {
-  let parsed;
-  try {
-    parsed = parseArgs(argv, publishFlagSchema);
-  } catch (error) {
-    console.error(`Error: ${translateParseError(error)}`);
-    process.exit(1);
-  }
+  const parsed = parseArgsOrExit(argv, publishFlagSchema);
   const { dryRun, noGitChecks, provenance } = parsed.flags;
   if (!dryRun && !noGitChecks) {
     try {
       assertCleanWorkingTree();
     } catch (error) {
-      console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
+      reportError(error instanceof Error ? error.message : String(error));
       process.exit(1);
     }
   }
@@ -80,7 +74,7 @@ async function publishCommand(argv) {
         console.warn(`  ${t}`);
       }
     }
-    console.error(error instanceof Error ? error.message : String(error));
+    reportError(error instanceof Error ? error.message : String(error));
     process.exit(1);
   }
 }
@@ -92,7 +86,7 @@ function filterPublishableTags(resolvedTags, isExplicit) {
   }
   if (isExplicit && unpublishable.length > 0) {
     for (const { tag, workspacePath } of unpublishable) {
-      console.error(`Error: ${tag} (${workspacePath}) cannot be published: package.json#private is true.`);
+      reportError(`${tag} (${workspacePath}) cannot be published: package.json#private is true.`);
     }
     process.exit(1);
   }

package/dist/esm/pushCommand.js

@@ -1,4 +1,4 @@
-import { parseArgs, translateParseError } from "@williamthorsen/nmr-core";
+import { parseArgsOrExit, reportError } from "@williamthorsen/nmr-core";
 import { parseRequestedTags } from "./parseRequestedTags.js";
 import { pushRelease } from "./pushRelease.js";
 import { resolveCommandTags } from "./resolveCommandTags.js";
@@ -8,13 +8,7 @@ const pushFlagSchema = {
   tagsOnly: { long: "--tags-only", type: "boolean" }
 };
 async function pushCommand(argv) {
-  let parsed;
-  try {
-    parsed = parseArgs(argv, pushFlagSchema);
-  } catch (error) {
-    console.error(`Error: ${translateParseError(error)}`);
-    process.exit(1);
-  }
+  const parsed = parseArgsOrExit(argv, pushFlagSchema);
   const { dryRun, tagsOnly } = parsed.flags;
   const requestedTags = parseRequestedTags(parsed.flags.tags);
   const resolvedTags = await resolveCommandTags(requestedTags);
@@ -38,7 +32,7 @@ async function pushCommand(argv) {
       }
     }
   } catch (error) {
-    console.error(error instanceof Error ? error.message : String(error));
+    reportError(error instanceof Error ? error.message : String(error));
     process.exit(1);
   }
 }

package/dist/esm/releasePrepareMono.js

@@ -487,8 +487,9 @@ function maybeEmitBaselineHint(workspace, knownPrefixes, state) {
   if (candidates.length === 0) return;
   const totalTags = candidates.reduce((sum, candidate) => sum + candidate.tagCount, 0);
   const example = candidates[0]?.exampleTags[0] ?? `${candidates[0]?.prefix ?? ""}?`;
-  console.error(
-    `Hint: no baseline tag found for ${workspace.dir} under '${workspace.tagPrefix}', but ${totalTags} candidate-shaped tags exist (e.g., ${example}). Run 'release-kit show-tag-prefixes' to check for undeclared legacy prefixes.`
+  process.stderr.write(
+    `Hint: no baseline tag found for ${workspace.dir} under '${workspace.tagPrefix}', but ${totalTags} candidate-shaped tags exist (e.g., ${example}). Run 'release-kit show-tag-prefixes' to check for undeclared legacy prefixes.
+`
   );
   state.emitted = true;
 }

package/dist/esm/resolveCommandTags.js

@@ -1,3 +1,4 @@
+import { reportError } from "@williamthorsen/nmr-core";
 import { deriveWorkspaceConfig } from "./deriveWorkspaceConfig.js";
 import { discoverWorkspaces } from "./discoverWorkspaces.js";
 import { resolveReleaseTags } from "./resolveReleaseTags.js";
@@ -6,7 +7,7 @@ async function resolveCommandTags(tags) {
   try {
     discoveredPaths = await discoverWorkspaces();
   } catch (error) {
-    console.error(`Error discovering workspaces: ${error instanceof Error ? error.message : String(error)}`);
+    reportError(`Failed to discover workspaces: ${error instanceof Error ? error.message : String(error)}`);
     process.exit(1);
   }
   let workspaces;
@@ -18,7 +19,7 @@ async function resolveCommandTags(tags) {
       workspaces = discoveredPaths.map((workspacePath) => deriveWorkspaceConfig(workspacePath));
     }
   } catch (error) {
-    console.error(`Error resolving workspaces: ${error instanceof Error ? error.message : String(error)}`);
+    reportError(`Failed to resolve workspaces: ${error instanceof Error ? error.message : String(error)}`);
     process.exit(1);
   }
   let resolvedTags;
@@ -30,14 +31,14 @@ async function resolveCommandTags(tags) {
     throw new Error("resolveCommandTags: invariant violated \u2014 neither workspaces nor singleWorkspace was derived");
   }
   if (resolvedTags.length === 0) {
-    console.error("Error: No release tags found on HEAD. Create tags with `release-kit tag` first.");
+    reportError("No release tags found on HEAD. Create tags with `release-kit tag` first.");
     process.exit(1);
   }
   if (tags !== void 0) {
     const availableTagNames = resolvedTags.map((t) => t.tag);
     for (const name of tags) {
       if (!availableTagNames.includes(name)) {
-        console.error(`Error: Unknown tag "${name}" in --tags. Available: ${availableTagNames.join(", ")}`);
+        reportError(`Unknown tag "${name}" in --tags. Available: ${availableTagNames.join(", ")}`);
         process.exit(1);
       }
     }

package/dist/esm/resolveReleaseNotesConfig.js

@@ -1,3 +1,4 @@
+import { reportError } from "@williamthorsen/nmr-core";
 import { DEFAULT_CHANGELOG_JSON_CONFIG, DEFAULT_RELEASE_NOTES_CONFIG } from "./defaults.js";
 import { loadConfig, resolveWorkTypes } from "./loadConfig.js";
 import { validateConfig } from "./validateConfig.js";
@@ -9,7 +10,7 @@ async function resolveReleaseNotesConfig(options = {}) {
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     if (strictLoad) {
-      console.error(`Error: failed to load config: ${message}`);
+      reportError(`Failed to load config: ${message}`);
       process.exit(1);
     }
     console.warn(`Warning: failed to load config; using defaults: ${message}`);
@@ -23,9 +24,10 @@ async function resolveReleaseNotesConfig(options = {}) {
   }
   const { config, errors, warnings } = validateConfig(rawConfig);
   if (errors.length > 0) {
-    console.error("Invalid config:");
+    process.stderr.write("Invalid config:\n");
     for (const err of errors) {
-      console.error(`  \u274C ${err}`);
+      process.stderr.write(`  \u274C ${err}
+`);
     }
     process.exit(1);
   }

package/dist/esm/sync-labels/generateCommand.js

@@ -1,5 +1,6 @@
 import { mkdirSync, writeFileSync } from "node:fs";
 import { dirname } from "node:path";
+import { reportError } from "@williamthorsen/nmr-core";
 import { stringify } from "yaml";
 import { loadSyncLabelsConfig, SYNC_LABELS_CONFIG_PATH } from "./loadSyncLabelsConfig.js";
 import { hashPresetFile } from "./presets.js";
@@ -19,11 +20,11 @@ async function generateCommand() {
     config = await loadSyncLabelsConfig();
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
-    console.error(`Error loading config: ${message}`);
+    reportError(`Failed to load config: ${message}`);
     return 1;
   }
   if (config === void 0) {
-    console.error(`No config file found at ${SYNC_LABELS_CONFIG_PATH}. Run \`release-kit sync-labels init\` first.`);
+    reportError(`No config file found at ${SYNC_LABELS_CONFIG_PATH}. Run \`release-kit sync-labels init\` first.`);
     return 1;
   }
   let labels;
@@ -31,7 +32,7 @@ async function generateCommand() {
     labels = resolveLabels(config);
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
-    console.error(`Error resolving labels: ${message}`);
+    reportError(`Failed to resolve labels: ${message}`);
     return 1;
   }
   const presetHashes = /* @__PURE__ */ new Map();
@@ -44,7 +45,7 @@ async function generateCommand() {
     writeFileSync(LABELS_OUTPUT_PATH, content, "utf8");
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
-    console.error(`Error writing ${LABELS_OUTPUT_PATH}: ${message}`);
+    reportError(`Failed to write ${LABELS_OUTPUT_PATH}: ${message}`);
     return 1;
   }
   console.info(`Generated ${LABELS_OUTPUT_PATH} with ${String(labels.length)} labels.`);

package/dist/esm/sync-labels/initCommand.js

@@ -14,7 +14,8 @@ async function syncLabelsInitCommand({ dryRun, force }) {
     workspacePaths = await discoverWorkspaces();
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
-    console.error(`  Failed to discover workspaces: ${message}`);
+    process.stderr.write(`  Failed to discover workspaces: ${message}
+`);
     return 1;
   }
   const scopeLabels = workspacePaths === void 0 ? [] : buildScopeLabels(workspacePaths);
@@ -32,7 +33,7 @@ async function syncLabelsInitCommand({ dryRun, force }) {
   reportWriteResult(workflowResult, dryRun);
   reportWriteResult(configResult, dryRun);
   if (workflowResult.outcome === "failed" || configResult.outcome === "failed") {
-    console.error("Failed to scaffold one or more files.");
+    process.stderr.write("Failed to scaffold one or more files.\n");
     return 1;
   }
   if (dryRun) {

package/dist/esm/sync-labels/syncCommand.js

@@ -1,5 +1,6 @@
 import { execSync } from "node:child_process";
 import { existsSync } from "node:fs";
+import { reportError } from "@williamthorsen/nmr-core";
 const WORKFLOW_FILE = ".github/workflows/sync-labels.yaml";
 function checkGhAvailable() {
   try {
@@ -11,18 +12,18 @@ function checkGhAvailable() {
 }
 function syncLabelsCommand() {
   if (!checkGhAvailable()) {
-    console.error("Error: The `gh` CLI is not installed or not in PATH. Install it from https://cli.github.com/");
+    reportError("The `gh` CLI is not installed or not in PATH. Install it from https://cli.github.com/");
     return 1;
   }
   if (!existsSync(WORKFLOW_FILE)) {
-    console.error(`Error: ${WORKFLOW_FILE} not found. Run \`release-kit sync-labels init\` first.`);
+    reportError(`${WORKFLOW_FILE} not found. Run \`release-kit sync-labels init\` first.`);
     return 1;
   }
   try {
     execSync("gh workflow run sync-labels.yaml", { stdio: "inherit" });
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
-    console.error(`Error triggering workflow: ${message}`);
+    reportError(`Failed to trigger workflow: ${message}`);
     return 1;
   }
   console.info("Workflow triggered successfully. View runs at: gh run list --workflow=sync-labels.yaml");

package/dist/esm/syncWorkTypes.js

@@ -1,6 +1,7 @@
 import { readFileSync, writeFileSync } from "node:fs";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
+import { formatErrorLine } from "@williamthorsen/nmr-core";
 import { UPSTREAM_WORK_TYPES_URL } from "./checkWorkTypesDrift.js";
 import { isRecord } from "./typeGuards.js";
 import { buildFetchInit, errorMessage, hasExpectedTopLevelShape } from "./workTypesUtils.js";
@@ -32,13 +33,15 @@ async function syncWorkTypes(dependencies = {}) {
   } catch (error) {
     return {
       exitCode: 2,
-      message: `Network error fetching upstream work-types.json: ${errorMessage(error)}`
+      message: formatErrorLine(`Failed to fetch upstream work-types.json: ${errorMessage(error)}`)
     };
   }
   if (!response.ok) {
     return {
       exitCode: 2,
-      message: `Failed to fetch upstream work-types.json: HTTP ${response.status} ${response.statusText}`
+      message: formatErrorLine(
+        `Failed to fetch upstream work-types.json: HTTP ${response.status} ${response.statusText}`
+      )
     };
   }
   const upstreamText = await response.text();
@@ -78,7 +81,7 @@ async function syncWorkTypes(dependencies = {}) {
   } catch (error) {
     return {
       exitCode: 2,
-      message: `Failed to write ${localPath}: ${errorMessage(error)}`
+      message: formatErrorLine(`Failed to write ${localPath}: ${errorMessage(error)}`)
     };
   }
   return {

package/dist/esm/tagCommand.js

@@ -1,22 +1,15 @@
-import { parseArgs, translateParseError } from "@williamthorsen/nmr-core";
+import { parseArgsOrExit, reportError } from "@williamthorsen/nmr-core";
 import { createTags } from "./createTags.js";
 const tagFlagSchema = {
   dryRun: { long: "--dry-run", type: "boolean" },
   noGitChecks: { long: "--no-git-checks", type: "boolean" }
 };
 function tagCommand(argv) {
-  let parsed;
-  try {
-    parsed = parseArgs(argv, tagFlagSchema);
-  } catch (error) {
-    console.error(`Error: ${translateParseError(error)}`);
-    process.exit(1);
-  }
-  const { dryRun, noGitChecks } = parsed.flags;
+  const { dryRun, noGitChecks } = parseArgsOrExit(argv, tagFlagSchema).flags;
   try {
     createTags({ dryRun, noGitChecks });
   } catch (error) {
-    console.error(error instanceof Error ? error.message : String(error));
+    reportError(error instanceof Error ? error.message : String(error));
     process.exit(1);
   }
 }

package/dist/esm/validateOverridesCommand.js

@@ -1,3 +1,4 @@
+import { formatErrorLine } from "@williamthorsen/nmr-core";
 import { buildChangelogEntries } from "./buildChangelogEntries.js";
 import {
   resolveOverridePath,
@@ -13,9 +14,15 @@ async function validateOverridesCommand(dependencies = {}) {
   const load = dependencies.loadConfig ?? loadConfig;
   const buildEntries = dependencies.buildEntries ?? defaultBuildEntries;
   const validate = dependencies.validate ?? validateAllChangelogOverrides;
+  let rawConfig;
+  try {
+    rawConfig = await load();
+  } catch (error) {
+    return { exitCode: 2, message: formatErrorLine(`Failed to load config: ${errorMessage(error)}`) };
+  }
   let userConfig;
   try {
-    userConfig = await loadAndValidateConfig(load);
+    userConfig = validateLoadedConfig(rawConfig);
   } catch (error) {
     return { exitCode: 2, message: errorMessage(error) };
   }
@@ -23,13 +30,13 @@ async function validateOverridesCommand(dependencies = {}) {
   try {
     discoveredPaths = await discover();
   } catch (error) {
-    return { exitCode: 2, message: `Error discovering workspaces: ${errorMessage(error)}` };
+    return { exitCode: 2, message: formatErrorLine(`Failed to discover workspaces: ${errorMessage(error)}`) };
   }
   let inputs;
   try {
     inputs = discoveredPaths === void 0 ? buildSinglePackageInputs(userConfig, buildEntries) : buildMonorepoInputs(discoveredPaths, userConfig, buildEntries);
   } catch (error) {
-    return { exitCode: 2, message: `Error resolving overrides scope: ${errorMessage(error)}` };
+    return { exitCode: 2, message: formatErrorLine(`Failed to resolve overrides scope: ${errorMessage(error)}`) };
   }
   const result = validate(inputs);
   return formatValidateOverridesResult(result);
@@ -85,13 +92,7 @@ function flattenEntriesToHashes(entries) {
   }
   return hashes;
 }
-async function loadAndValidateConfig(load) {
-  let rawConfig;
-  try {
-    rawConfig = await load();
-  } catch (error) {
-    throw new Error(`Error loading config: ${errorMessage(error)}`);
-  }
+function validateLoadedConfig(rawConfig) {
   if (rawConfig === void 0) {
     return void 0;
   }

package/dist/esm/writeReleaseNotesPreviews.js

@@ -1,6 +1,6 @@
 import { existsSync, readFileSync } from "node:fs";
 import path from "node:path";
-import { writeFileWithCheck } from "@williamthorsen/nmr-core";
+import { reportError, writeFileWithCheck } from "@williamthorsen/nmr-core";
 import { extractVersion } from "./changelogJsonUtils.js";
 import { dim } from "./format.js";
 import { renderInjectedReadme } from "./injectReleaseNotesIntoReadme.js";
@@ -51,7 +51,7 @@ function writePreviewFile(filePath, content, dryRun) {
   }
   const result = writeFileWithCheck(filePath, content, { dryRun: false, overwrite: true });
   if (result.outcome === "failed") {
-    console.error(`Error writing ${filePath}: ${result.error ?? "unknown error"}`);
+    reportError(`Failed to write ${filePath}: ${result.error ?? "unknown error"}`);
     return { filePath, outcome: "failed", ...result.error === void 0 ? {} : { error: result.error } };
   }
   if (result.outcome === "created" || result.outcome === "overwritten") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@williamthorsen/release-kit",
-  "version": "5.3.2",
+  "version": "6.0.0",
   "description": "Version-bumping and changelog-generation toolkit for release workflows",
   "keywords": [],
   "homepage": "https://github.com/williamthorsen/node-monorepo-tools/tree/main/packages/release-kit#readme",
@@ -35,14 +35,14 @@
     "glob": "13.0.6",
     "jiti": "2.7.0",
     "json-stringify-pretty-compact": "4.0.0",
-    "semver": "7.8.4",
+    "semver": "7.8.5",
     "yaml": "2.9.0",
     "zod": "4.4.3",
-    "@williamthorsen/nmr-core": "0.3.2"
+    "@williamthorsen/nmr-core": "0.5.0"
   },
   "devDependencies": {
     "@types/semver": "7.7.1",
-    "smol-toml": "1.6.1"
+    "smol-toml": "1.7.0"
   },
   "engines": {
     "node": ">=18.17.0"
@@ -53,10 +53,6 @@
   },
   "scripts": {
     "build:post": "node scripts/copy-work-types.js",
-    "test": "pnpm exec vitest --config=vitest.standalone.config.ts",
-    "test:coverage": "pnpm exec vitest --config=vitest.standalone.config.ts --coverage",
-    "test:integration": "pnpm exec vitest --config=vitest.integration.config.ts",
-    "test:watch": "pnpm exec vitest --config=vitest.standalone.config.ts --watch",
     "work-types:check": "pnpm exec release-kit work-types check",
     "work-types:sync": "pnpm exec release-kit work-types sync"
   }