@williamthorsen/release-kit 5.4.0 → 7.0.0

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";
@@ -16,7 +17,7 @@ import { tagCommand } from "../tagCommand.js";
 import { validateOverridesCommand } from "../validateOverridesCommand.js";
 const VERSION = readPackageVersion(import.meta.url);
 function showUsage() {
-  console.info(`
+    console.info(`
 Usage: release-kit <command> [options]
 
 Commands:
@@ -38,7 +39,7 @@ Options:
 `);
 }
 function showSyncLabelsHelp() {
-  console.info(`
+    console.info(`
 Usage: release-kit sync-labels <subcommand> [options]
 
 Manage GitHub label synchronization via preset and custom label definitions.
@@ -53,7 +54,7 @@ Options:
 `);
 }
 function showSyncLabelsInitHelp() {
-  console.info(`
+    console.info(`
 Usage: release-kit sync-labels init [options]
 
 Scaffold the sync-labels caller workflow and config file, auto-discover workspaces
@@ -66,7 +67,7 @@ Options:
 `);
 }
 function showSyncLabelsGenerateHelp() {
-  console.info(`
+    console.info(`
 Usage: release-kit sync-labels generate
 
 Regenerate .github/labels.yaml from .config/sync-labels.config.ts.
@@ -76,7 +77,7 @@ Options:
 `);
 }
 function showSyncLabelsSyncHelp() {
-  console.info(`
+    console.info(`
 Usage: release-kit sync-labels sync
 
 Trigger the sync-labels GitHub Actions workflow via the gh CLI.
@@ -86,7 +87,7 @@ Options:
 `);
 }
 function showInitHelp() {
-  console.info(`
+    console.info(`
 Usage: release-kit init [options]
 
 Initialize release-kit in the current repository.
@@ -99,26 +100,8 @@ 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(`
+    console.info(`
 Usage: release-kit commit [options]
 
 Stage all changes and create the release commit using tags and summary
@@ -130,7 +113,7 @@ Options:
 `);
 }
 function showTagHelp() {
-  console.info(`
+    console.info(`
 Usage: release-kit tag [options]
 
 Create annotated git tags from the tags file produced by \`prepare\`.
@@ -142,7 +125,7 @@ Options:
 `);
 }
 function showPushHelp() {
-  console.info(`
+    console.info(`
 Usage: release-kit push [options]
 
 Push the release commit and each tag individually, ensuring GitHub Actions
@@ -156,7 +139,7 @@ Options:
 `);
 }
 function showCreateGithubReleaseHelp() {
-  console.info(`
+    console.info(`
 Usage: release-kit create-github-release [options]
 
 Create GitHub Releases from changelog.json for tags on HEAD.
@@ -168,7 +151,7 @@ Options:
 `);
 }
 function showShowTagPrefixesHelp() {
-  console.info(`
+    console.info(`
 Usage: release-kit show-tag-prefixes [options]
 
 Print a per-workspace table of derived tag prefixes, tag counts, and declared
@@ -181,7 +164,7 @@ Options:
 `);
 }
 function showOverridesHelp() {
-  console.info(`
+    console.info(`
 Usage: release-kit overrides <subcommand> [options]
 
 Manage editorial changelog overrides.
@@ -194,14 +177,14 @@ Options:
 `);
 }
 function showOverridesValidateHelp() {
-  console.info(`
+    console.info(`
 Usage: release-kit overrides validate
 
 Validate every \`.meta/changelog-overrides.json\` file across the project and per-workspace
 scopes. Reports schema/parse errors, ambiguous-prefix errors, and stale-key warnings.
 
 Exit codes:
-  0    Clean \u2014 no errors, no stale keys
+  0    Clean — no errors, no stale keys
   1    Stale-key warnings only (no errors)
   2    Schema/parse or ambiguous-prefix errors (errors dominate)
 
@@ -210,7 +193,7 @@ Options:
 `);
 }
 function showWorkTypesHelp() {
-  console.info(`
+    console.info(`
 Usage: release-kit work-types <subcommand>
 
 Manage the canonical work-types taxonomy used by changelog and release-notes generation.
@@ -220,7 +203,7 @@ Subcommands:
   sync          Overwrite the local work-types.json with the upstream contents
 
 Exit codes (check):
-  0    Match (or upstream missing \u2014 transitional warning printed)
+  0    Match (or upstream missing — transitional warning printed)
   1    Drift detected
   2    Network error
   3    Schema mismatch
@@ -230,7 +213,7 @@ Options:
 `);
 }
 function showWorkTypesCheckHelp() {
-  console.info(`
+    console.info(`
 Usage: release-kit work-types check
 
 Compare the local work-types.json against the upstream codeassembly canonical and report
@@ -242,7 +225,7 @@ Options:
 `);
 }
 function showWorkTypesSyncHelp() {
-  console.info(`
+    console.info(`
 Usage: release-kit work-types sync
 
 Fetch the upstream work-types.json, validate its top-level shape, and overwrite the local
@@ -253,7 +236,7 @@ Options:
 `);
 }
 function showPublishHelp() {
-  console.info(`
+    console.info(`
 Usage: release-kit publish [options]
 
 Publish packages that have release tags on HEAD. Operates only on workspaces where
@@ -271,228 +254,218 @@ Options:
 const args = process.argv.slice(2);
 const command = args[0];
 const flags = args.slice(1);
-if (command === "--version" || command === "-V") {
-  console.info(VERSION);
-  process.exit(0);
-}
-if (command === "--help" || command === "-h" || command === void 0) {
-  showUsage();
-  process.exit(0);
-}
-if (command === "prepare") {
-  if (flags.some((f) => f === "--help" || f === "-h")) {
-    showPrepareHelp();
+if (command === '--version' || command === '-V') {
+    console.info(VERSION);
     process.exit(0);
-  }
-  await prepareCommand(flags);
-  process.exit(0);
 }
-if (command === "commit") {
-  if (flags.some((f) => f === "--help" || f === "-h")) {
-    showCommitHelp();
+if (command === '--help' || command === '-h' || command === undefined) {
+    showUsage();
     process.exit(0);
-  }
-  try {
-    commitCommand(flags);
-  } catch (error) {
-    console.error(error instanceof Error ? error.message : String(error));
-    process.exit(1);
-  }
-  process.exit(0);
 }
-if (command === "tag") {
-  if (flags.some((f) => f === "--help" || f === "-h")) {
-    showTagHelp();
+if (command === 'prepare') {
+    if (flags.some((f) => f === '--help' || f === '-h')) {
+        showPrepareHelp();
+        process.exit(0);
+    }
+    await prepareCommand(flags);
     process.exit(0);
-  }
-  tagCommand(flags);
-  process.exit(0);
 }
-if (command === "push") {
-  if (flags.some((f) => f === "--help" || f === "-h")) {
-    showPushHelp();
+if (command === 'commit') {
+    if (flags.some((f) => f === '--help' || f === '-h')) {
+        showCommitHelp();
+        process.exit(0);
+    }
+    try {
+        commitCommand(flags);
+    }
+    catch (error) {
+        reportError(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
     process.exit(0);
-  }
-  await pushCommand(flags);
-  process.exit(0);
 }
-if (command === "create-github-release") {
-  if (flags.some((f) => f === "--help" || f === "-h")) {
-    showCreateGithubReleaseHelp();
+if (command === 'tag') {
+    if (flags.some((f) => f === '--help' || f === '-h')) {
+        showTagHelp();
+        process.exit(0);
+    }
+    tagCommand(flags);
     process.exit(0);
-  }
-  await createGithubReleaseCommand(flags);
-  process.exit(0);
 }
-if (command === "publish") {
-  if (flags.some((f) => f === "--help" || f === "-h")) {
-    showPublishHelp();
+if (command === 'push') {
+    if (flags.some((f) => f === '--help' || f === '-h')) {
+        showPushHelp();
+        process.exit(0);
+    }
+    await pushCommand(flags);
     process.exit(0);
-  }
-  await publishCommand(flags);
-  process.exit(0);
 }
-if (command === "show-tag-prefixes") {
-  if (flags.some((f) => f === "--help" || f === "-h")) {
-    showShowTagPrefixesHelp();
+if (command === 'create-github-release') {
+    if (flags.some((f) => f === '--help' || f === '-h')) {
+        showCreateGithubReleaseHelp();
+        process.exit(0);
+    }
+    await createGithubReleaseCommand(flags);
     process.exit(0);
-  }
-  if (flags.length > 0) {
-    console.error(`Error: Unknown option: ${flags[0]}`);
-    process.exit(1);
-  }
-  const exitCode = await showTagPrefixesCommand();
-  process.exit(exitCode);
 }
-if (command === "init") {
-  if (flags.some((f) => f === "--help" || f === "-h")) {
-    showInitHelp();
+if (command === 'publish') {
+    if (flags.some((f) => f === '--help' || f === '-h')) {
+        showPublishHelp();
+        process.exit(0);
+    }
+    await publishCommand(flags);
     process.exit(0);
-  }
-  const initFlagSchema = {
-    dryRun: { long: "--dry-run", type: "boolean" },
-    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 exitCode = initCommand({ dryRun, force, withConfig });
-  process.exit(exitCode);
 }
-if (command === "sync-labels") {
-  const subcommand = flags[0];
-  const subflags = flags.slice(1);
-  if (subcommand === "--help" || subcommand === "-h" || subcommand === void 0) {
-    showSyncLabelsHelp();
-    process.exit(0);
-  }
-  if (subcommand === "init") {
-    if (subflags.some((f) => f === "--help" || f === "-h")) {
-      showSyncLabelsInitHelp();
-      process.exit(0);
+if (command === 'show-tag-prefixes') {
+    if (flags.some((f) => f === '--help' || f === '-h')) {
+        showShowTagPrefixesHelp();
+        process.exit(0);
     }
-    const syncLabelsInitFlagSchema = {
-      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 exitCode = await syncLabelsInitCommand({ dryRun, force });
-    process.exit(exitCode);
-  }
-  if (subcommand === "generate") {
-    if (subflags.some((f) => f === "--help" || f === "-h")) {
-      showSyncLabelsGenerateHelp();
-      process.exit(0);
-    }
-    if (subflags.length > 0) {
-      console.error(`Error: Unknown option: ${subflags[0]}`);
-      process.exit(1);
+    if (flags.length > 0) {
+        reportError(`Unknown option: ${flags[0]}`);
+        process.exit(1);
     }
-    const exitCode = await generateCommand();
+    const exitCode = await showTagPrefixesCommand();
     process.exit(exitCode);
-  }
-  if (subcommand === "sync") {
-    if (subflags.some((f) => f === "--help" || f === "-h")) {
-      showSyncLabelsSyncHelp();
-      process.exit(0);
-    }
-    if (subflags.length > 0) {
-      console.error(`Error: Unknown option: ${subflags[0]}`);
-      process.exit(1);
+}
+if (command === 'init') {
+    if (flags.some((f) => f === '--help' || f === '-h')) {
+        showInitHelp();
+        process.exit(0);
     }
-    const exitCode = syncLabelsCommand();
+    const initFlagSchema = {
+        dryRun: { long: '--dry-run', type: 'boolean' },
+        force: { long: '--force', type: 'boolean' },
+        withConfig: { long: '--with-config', type: 'boolean' },
+    };
+    const { dryRun, force, withConfig } = parseArgsOrExit(flags, initFlagSchema).flags;
+    const exitCode = initCommand({ dryRun, force, withConfig });
     process.exit(exitCode);
-  }
-  console.error(`Error: Unknown subcommand: ${subcommand}`);
-  showSyncLabelsHelp();
-  process.exit(1);
 }
-if (command === "overrides") {
-  const subcommand = flags[0];
-  const subflags = flags.slice(1);
-  if (subcommand === "--help" || subcommand === "-h" || subcommand === void 0) {
-    showOverridesHelp();
-    process.exit(0);
-  }
-  if (subcommand === "validate") {
-    if (subflags.some((f) => f === "--help" || f === "-h")) {
-      showOverridesValidateHelp();
-      process.exit(0);
+if (command === 'sync-labels') {
+    const subcommand = flags[0];
+    const subflags = flags.slice(1);
+    if (subcommand === '--help' || subcommand === '-h' || subcommand === undefined) {
+        showSyncLabelsHelp();
+        process.exit(0);
     }
-    if (subflags.length > 0) {
-      console.error(`Error: Unknown option: ${subflags[0]}`);
-      process.exit(1);
+    if (subcommand === 'init') {
+        if (subflags.some((f) => f === '--help' || f === '-h')) {
+            showSyncLabelsInitHelp();
+            process.exit(0);
+        }
+        const syncLabelsInitFlagSchema = {
+            dryRun: { long: '--dry-run', type: 'boolean' },
+            force: { long: '--force', type: 'boolean' },
+        };
+        const { dryRun, force } = parseArgsOrExit(subflags, syncLabelsInitFlagSchema).flags;
+        const exitCode = await syncLabelsInitCommand({ dryRun, force });
+        process.exit(exitCode);
     }
-    const result = await validateOverridesCommand();
-    if (result.exitCode === 0) {
-      console.info(result.message);
-    } else {
-      console.error(result.message);
+    if (subcommand === 'generate') {
+        if (subflags.some((f) => f === '--help' || f === '-h')) {
+            showSyncLabelsGenerateHelp();
+            process.exit(0);
+        }
+        if (subflags.length > 0) {
+            reportError(`Unknown option: ${subflags[0]}`);
+            process.exit(1);
+        }
+        const exitCode = await generateCommand();
+        process.exit(exitCode);
     }
-    process.exit(result.exitCode);
-  }
-  console.error(`Error: Unknown subcommand: ${subcommand}`);
-  showOverridesHelp();
-  process.exit(1);
-}
-if (command === "work-types") {
-  const subcommand = flags[0];
-  const subflags = flags.slice(1);
-  if (subcommand === "--help" || subcommand === "-h" || subcommand === void 0) {
-    showWorkTypesHelp();
-    process.exit(0);
-  }
-  if (subcommand === "check") {
-    if (subflags.some((f) => f === "--help" || f === "-h")) {
-      showWorkTypesCheckHelp();
-      process.exit(0);
+    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);
+        }
+        const exitCode = syncLabelsCommand();
+        process.exit(exitCode);
     }
-    if (subflags.length > 0) {
-      console.error(`Error: Unknown option: ${subflags[0]}`);
-      process.exit(1);
+    reportError(`Unknown subcommand: ${subcommand}`);
+    showSyncLabelsHelp();
+    process.exit(1);
+}
+if (command === 'overrides') {
+    const subcommand = flags[0];
+    const subflags = flags.slice(1);
+    if (subcommand === '--help' || subcommand === '-h' || subcommand === undefined) {
+        showOverridesHelp();
+        process.exit(0);
     }
-    const result = await checkWorkTypesDrift();
-    if (result.exitCode === 0) {
-      console.info(result.message);
-    } else {
-      console.error(result.message);
+    if (subcommand === 'validate') {
+        if (subflags.some((f) => f === '--help' || f === '-h')) {
+            showOverridesValidateHelp();
+            process.exit(0);
+        }
+        if (subflags.length > 0) {
+            reportError(`Unknown option: ${subflags[0]}`);
+            process.exit(1);
+        }
+        const result = await validateOverridesCommand();
+        if (result.exitCode === 0) {
+            console.info(result.message);
+        }
+        else {
+            process.stderr.write(`${result.message}\n`);
+        }
+        process.exit(result.exitCode);
     }
-    process.exit(result.exitCode);
-  }
-  if (subcommand === "sync") {
-    if (subflags.some((f) => f === "--help" || f === "-h")) {
-      showWorkTypesSyncHelp();
-      process.exit(0);
+    reportError(`Unknown subcommand: ${subcommand}`);
+    showOverridesHelp();
+    process.exit(1);
+}
+if (command === 'work-types') {
+    const subcommand = flags[0];
+    const subflags = flags.slice(1);
+    if (subcommand === '--help' || subcommand === '-h' || subcommand === undefined) {
+        showWorkTypesHelp();
+        process.exit(0);
     }
-    if (subflags.length > 0) {
-      console.error(`Error: Unknown option: ${subflags[0]}`);
-      process.exit(1);
+    if (subcommand === 'check') {
+        if (subflags.some((f) => f === '--help' || f === '-h')) {
+            showWorkTypesCheckHelp();
+            process.exit(0);
+        }
+        if (subflags.length > 0) {
+            reportError(`Unknown option: ${subflags[0]}`);
+            process.exit(1);
+        }
+        const result = await checkWorkTypesDrift();
+        if (result.exitCode === 0) {
+            console.info(result.message);
+        }
+        else {
+            process.stderr.write(`${result.message}\n`);
+        }
+        process.exit(result.exitCode);
     }
-    const result = await syncWorkTypes();
-    if (result.exitCode === 0) {
-      console.info(result.message);
-    } else {
-      console.error(result.message);
+    if (subcommand === 'sync') {
+        if (subflags.some((f) => f === '--help' || f === '-h')) {
+            showWorkTypesSyncHelp();
+            process.exit(0);
+        }
+        if (subflags.length > 0) {
+            reportError(`Unknown option: ${subflags[0]}`);
+            process.exit(1);
+        }
+        const result = await syncWorkTypes();
+        if (result.exitCode === 0) {
+            console.info(result.message);
+        }
+        else {
+            process.stderr.write(`${result.message}\n`);
+        }
+        process.exit(result.exitCode);
     }
-    process.exit(result.exitCode);
-  }
-  console.error(`Error: Unknown subcommand: ${subcommand}`);
-  showWorkTypesHelp();
-  process.exit(1);
+    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/buildChangelogEntries.d.ts

@@ -1,4 +1,4 @@
-import type { GenerateChangelogOptions } from './generateChangelogs.ts';
-import type { ChangelogEntry, ReleaseConfig } from './types.ts';
+import type { GenerateChangelogOptions } from './generateChangelogs.js';
+import type { ChangelogEntry, ReleaseConfig } from './types.js';
 export declare function stripGroupDecorations(group: string): string;
 export declare function buildChangelogEntries(config: Pick<ReleaseConfig, 'cliffConfigPath' | 'changelogJson'>, tag: string, options?: GenerateChangelogOptions): ChangelogEntry[];