@williamthorsen/release-kit 16.1.1 → 17.0.0

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/changelogJsonUtils.js

@@ -1,5 +1,6 @@
 import { existsSync, readFileSync } from 'node:fs';
-import { isRecord, isUnknownArray } from "./typeGuards.js";
+import { isRecord } from '@williamthorsen/nmr-core';
+import { isUnknownArray } from "./typeGuards.js";
 export function isChangelogEntry(value) {
     return (isRecord(value) &&
         typeof value['version'] === 'string' &&

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/commandKit.d.ts

@@ -0,0 +1,18 @@
+import { type StreamStyles } from '@williamthorsen/nmr-core';
+/** The context that every `release-kit` command receives from the root group. */
+export interface CommandContext {
+    styles: StreamStyles;
+}
+/** The `--config` flag of every command that reads the config file. */
+export declare const CONFIG_FLAG: {
+    config: {
+        type: "path";
+        description: string;
+        valueHint: string;
+    };
+};
+/**
+ * Runs a command and resolves to its exit code, 0 when it returns nothing. Reports an unusable config in its own form
+ * and any other anticipated failure as `<bin>: <message>`, each with exit code 1, and rethrows anything else.
+ */
+export declare function runReportingFailures(styles: StreamStyles, runCommand: () => number | undefined | Promise<number | undefined>): Promise<number>;

package/dist/esm/cli/commandKit.js

@@ -0,0 +1,27 @@
+import { isAnticipatedFailure, reportError } from '@williamthorsen/nmr-core';
+import { describeError } from '@williamthorsen/toolbelt.errors';
+import { BIN } from "../bin.js";
+import { ConfigProblemError, reportConfigProblem } from "../loadValidatedConfig.js";
+export const CONFIG_FLAG = {
+    config: {
+        type: 'path',
+        description: 'Config file, relative to the current directory (default: .config/release-kit.config.ts at the repo root)',
+        valueHint: 'path',
+    },
+};
+export async function runReportingFailures(styles, runCommand) {
+    try {
+        return (await runCommand()) ?? 0;
+    }
+    catch (error) {
+        if (error instanceof ConfigProblemError) {
+            reportConfigProblem(error.problem, styles.stderr);
+            return 1;
+        }
+        if (!isAnticipatedFailure(error)) {
+            throw error;
+        }
+        reportError(BIN, describeError(error));
+        return 1;
+    }
+}

package/dist/esm/cli/maintenanceCommands.d.ts

@@ -0,0 +1,6 @@
+import { type CommandContext } from './commandKit.js';
+export declare const showTagPrefixes: import("@williamthorsen/nmr-core/cli").Command<CommandContext>;
+export declare const init: import("@williamthorsen/nmr-core/cli").Command<CommandContext>;
+export declare const updateTemplates: import("@williamthorsen/nmr-core/cli").Command<CommandContext>;
+export declare const overrides: import("@williamthorsen/nmr-core/cli").Group<CommandContext>;
+export declare const syncLabels: import("@williamthorsen/nmr-core/cli").Group<CommandContext>;

package/dist/esm/cli/maintenanceCommands.js

@@ -0,0 +1,129 @@
+import process from 'node:process';
+import { createCli } from '@williamthorsen/nmr-core/cli';
+import { enterRepoRoot } from "../enterRepoRoot.js";
+import { initCommand } from "../init/initCommand.js";
+import { updateTemplatesCommand } from "../init/updateTemplatesCommand.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 { validateOverridesCommand } from "../validateOverridesCommand.js";
+import { CONFIG_FLAG, runReportingFailures } from "./commandKit.js";
+const { defineCommand, defineGroup } = createCli();
+export const showTagPrefixes = defineCommand({
+    summary: 'Show derived and declared legacy tag prefixes per workspace',
+    description: 'Print a per-workspace table of derived tag prefixes, tag counts, and declared legacy tag prefixes. Reports any release-shaped tags whose prefix is neither a derived prefix nor declared in `legacyIdentities`, with a copy-pasteable config snippet.',
+    flags: CONFIG_FLAG,
+    run: ({ flags, context }) => runReportingFailures(context.styles, () => {
+        enterRepoRoot();
+        return showTagPrefixesCommand(context.styles, flags.config);
+    }),
+});
+export const init = defineCommand({
+    summary: 'Initialize release-kit in the current repository',
+    description: 'Initialize release-kit in the current repository. By default, scaffolds only the GitHub Actions workflow files. When every package is private, skips publish.yaml and create-github-release.yaml.',
+    flags: {
+        shouldScaffoldConfig: {
+            type: 'boolean',
+            long: 'with-config',
+            description: 'Also scaffold .config/release-kit.config.ts',
+        },
+        shouldForce: { type: 'boolean', long: 'force', description: 'Overwrite existing files instead of skipping them' },
+        isDryRun: { type: 'boolean', long: 'dry-run', description: 'Preview changes without writing files' },
+    },
+    run: ({ flags, context }) => runReportingFailures(context.styles, () => {
+        enterRepoRoot();
+        return initCommand({
+            isDryRun: flags.isDryRun,
+            shouldForce: flags.shouldForce,
+            shouldScaffoldConfig: flags.shouldScaffoldConfig,
+            styles: context.styles,
+        });
+    }),
+});
+export const updateTemplates = defineCommand({
+    summary: 'Update the scaffolded workflows to the current templates',
+    description: "Update the GitHub Actions workflows that release-kit scaffolds to the templates of the installed version, showing what changed in each file. Creates a missing workflow that `init` would create, and refreshes sync-labels.yaml only when it exists. When every package is private, refreshes publish.yaml and create-github-release.yaml only when they exist. Keeps publish.yaml's provenance setting. Never touches config files.",
+    flags: {
+        isDryRun: { type: 'boolean', long: 'dry-run', description: 'Preview changes without writing files' },
+    },
+    run: ({ flags, context }) => runReportingFailures(context.styles, () => {
+        enterRepoRoot();
+        return updateTemplatesCommand({ isDryRun: flags.isDryRun, styles: context.styles });
+    }),
+});
+const overridesValidate = defineCommand({
+    summary: 'Validate every `.meta/changelog-overrides.json` file across all scopes',
+    description: 'Validate every `.meta/changelog-overrides.json` file across the project and per-workspace scopes. Reports schema/parse errors, ambiguous-prefix errors, conflicting-key errors, and stale-key warnings.',
+    flags: CONFIG_FLAG,
+    epilog: `Exit codes:
+  0    Clean: no errors, no stale keys
+  1    Stale-key warnings only (no errors)
+  2    Schema/parse, ambiguous-prefix, or conflicting-key errors (errors take precedence)`,
+    run: ({ flags, context }) => runReportingFailures(context.styles, async () => {
+        enterRepoRoot();
+        const result = await validateOverridesCommand(context.styles, flags.config);
+        if (result.exitCode === 0) {
+            process.stdout.write(`${result.message}\n`);
+        }
+        else {
+            process.stderr.write(`${result.message}\n`);
+        }
+        return result.exitCode;
+    }),
+});
+export const overrides = defineGroup({
+    summary: 'Manage editorial changelog overrides',
+    commands: { validate: overridesValidate },
+});
+const syncLabelsInit = defineCommand({
+    summary: 'Scaffold caller workflow and config, then generate labels',
+    description: 'Scaffold the sync-labels caller workflow and seed the repoLabels block of .config/release-kit.config.ts with scope labels discovered from workspaces and retired packages, then generate .github/labels.yaml. When the config file already exists, print the block for manual paste instead of rewriting the file.',
+    flags: {
+        ...CONFIG_FLAG,
+        isDryRun: { type: 'boolean', long: 'dry-run', description: 'Preview changes without writing files' },
+        shouldForce: { type: 'boolean', long: 'force', description: 'Overwrite existing files instead of skipping them' },
+    },
+    run: ({ flags, context }) => runReportingFailures(context.styles, () => {
+        enterRepoRoot();
+        return syncLabelsInitCommand({
+            ...(flags.config !== undefined && { configPath: flags.config }),
+            isDryRun: flags.isDryRun,
+            shouldForce: flags.shouldForce,
+            styles: context.styles,
+        });
+    }),
+});
+const syncLabelsGenerate = defineCommand({
+    summary: 'Regenerate .github/labels.yaml from config',
+    description: 'Regenerate .github/labels.yaml from the repoLabels block of .config/release-kit.config.ts.',
+    flags: {
+        shouldCheck: {
+            type: 'boolean',
+            long: 'check',
+            description: 'Report whether .github/labels.yaml is stale instead of writing it',
+        },
+        ...CONFIG_FLAG,
+    },
+    run: ({ flags, context }) => runReportingFailures(context.styles, () => {
+        enterRepoRoot();
+        return generateCommand({
+            shouldCheck: flags.shouldCheck,
+            ...(flags.config !== undefined && { configPath: flags.config }),
+            styles: context.styles,
+        });
+    }),
+});
+const syncLabelsSync = defineCommand({
+    summary: 'Trigger the sync-labels workflow via gh CLI',
+    description: 'Trigger the sync-labels GitHub Actions workflow via the gh CLI.',
+    run: ({ context }) => runReportingFailures(context.styles, () => {
+        enterRepoRoot();
+        return syncLabelsCommand();
+    }),
+});
+export const syncLabels = defineGroup({
+    summary: 'Manage GitHub label synchronization',
+    description: 'Manage GitHub label synchronization via preset and custom label definitions.',
+    commands: { init: syncLabelsInit, generate: syncLabelsGenerate, sync: syncLabelsSync },
+});

package/dist/esm/cli/releaseCommands.d.ts

@@ -0,0 +1,7 @@
+import { type CommandContext } from './commandKit.js';
+export declare const prepare: import("@williamthorsen/nmr-core/cli").Command<CommandContext>;
+export declare const commit: import("@williamthorsen/nmr-core/cli").Command<CommandContext>;
+export declare const tag: import("@williamthorsen/nmr-core/cli").Command<CommandContext>;
+export declare const push: import("@williamthorsen/nmr-core/cli").Command<CommandContext>;
+export declare const publish: import("@williamthorsen/nmr-core/cli").Command<CommandContext>;
+export declare const createGithubRelease: import("@williamthorsen/nmr-core/cli").Command<CommandContext>;

package/dist/esm/cli/releaseCommands.js

@@ -0,0 +1,156 @@
+import { createCli } from '@williamthorsen/nmr-core/cli';
+import { commitCommand } from "../commitCommand.js";
+import { createGithubReleaseCommand } from "../createGithubReleaseCommand.js";
+import { enterRepoRoot } from "../enterRepoRoot.js";
+import { parseRequestedTags } from "../parseRequestedTags.js";
+import { prepareCommand } from "../prepareCommand.js";
+import { publishCommand } from "../publishCommand.js";
+import { pushCommand } from "../pushCommand.js";
+import { tagCommand } from "../tagCommand.js";
+import { CONFIG_FLAG, runReportingFailures } from "./commandKit.js";
+const { defineCommand } = createCli();
+const TAGS_FLAG = {
+    type: 'string',
+    valueHint: 'tag1,tag2',
+};
+export const prepare = defineCommand({
+    summary: 'Run release preparation (auto-discovers workspaces)',
+    description: 'Run release preparation with automatic workspace discovery.',
+    flags: {
+        ...CONFIG_FLAG,
+        isDryRun: { type: 'boolean', long: 'dry-run', description: 'Run without modifying any files' },
+        bump: {
+            type: 'string',
+            description: 'Set the level of every release that happens; does not trigger one',
+            choices: ['major', 'minor', 'patch'],
+        },
+        setVersion: {
+            type: 'string',
+            long: 'set-version',
+            description: "Set an explicit version; bypasses the changelog-derived bump. In monorepo mode, name each workspace or directory target: --set-version=arrays@1.0.0[,strings@2.0.0]. Rejected when a composite (a 'project' block or a releases composite) is configured.",
+            valueHint: 'X.Y.Z',
+        },
+        shouldForce: {
+            type: 'boolean',
+            long: 'force',
+            description: 'Release even when the last tag is not followed by any commits, or by any bump-worthy ones. Defaults to patch when --bump is not given; use --bump=X for a different level.',
+        },
+        shouldSkipGitChecks: {
+            type: 'boolean',
+            long: 'no-git-checks',
+            description: 'Skip the clean-working-tree check',
+            short: 'n',
+        },
+        only: {
+            type: 'string',
+            description: "Release only the named release targets and their dependents (comma-separated, monorepo only). A composite declared under 'releases' releases only when named; a 'project' block's release is skipped.",
+            valueHint: 'name1,name2',
+        },
+        shouldIncludeReleaseNotes: {
+            type: 'boolean',
+            long: 'with-release-notes',
+            description: '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).',
+        },
+    },
+    run: ({ flags, context }) => runReportingFailures(context.styles, async () => {
+        enterRepoRoot();
+        await prepareCommand({
+            bumpOverride: flags.bump,
+            configPath: flags.config,
+            isDryRun: flags.isDryRun,
+            onlyNames: flags.only?.split(','),
+            setVersion: flags.setVersion,
+            shouldForce: flags.shouldForce,
+            shouldIncludeReleaseNotes: flags.shouldIncludeReleaseNotes,
+            shouldSkipGitChecks: flags.shouldSkipGitChecks,
+            styles: context.styles,
+        });
+    }),
+});
+export const commit = defineCommand({
+    summary: 'Stage changes and create the release commit',
+    description: 'Stage all changes and create the release commit using the tags and summary produced by `prepare`.',
+    flags: {
+        isDryRun: { type: 'boolean', long: 'dry-run', description: 'Preview the commit message without creating it' },
+    },
+    run: ({ flags, context }) => runReportingFailures(context.styles, () => {
+        enterRepoRoot();
+        commitCommand({ isDryRun: flags.isDryRun });
+    }),
+});
+export const tag = defineCommand({
+    summary: 'Create annotated git tags from the tags file',
+    description: 'Create annotated git tags from the tags file produced by `prepare`.',
+    flags: {
+        isDryRun: { type: 'boolean', long: 'dry-run', description: 'Preview without creating tags' },
+        shouldSkipGitChecks: { type: 'boolean', long: 'no-git-checks', description: 'Skip the dirty-working-tree check' },
+    },
+    run: ({ flags, context }) => runReportingFailures(context.styles, () => {
+        enterRepoRoot();
+        tagCommand({ isDryRun: flags.isDryRun, shouldSkipGitChecks: flags.shouldSkipGitChecks, styles: context.styles });
+    }),
+});
+export const push = defineCommand({
+    summary: 'Push the release commit and tags (one push per tag)',
+    description: 'Push the release commit and each tag individually, so that GitHub Actions starts a separate workflow run for each tag.',
+    flags: {
+        ...CONFIG_FLAG,
+        isDryRun: { type: 'boolean', long: 'dry-run', description: 'Preview without pushing' },
+        tags: { ...TAGS_FLAG, description: 'Only push the named tags (comma-separated, full tag names)' },
+        tagsOnly: { type: 'boolean', description: 'Skip the branch push (push tags only)' },
+    },
+    run: ({ flags, context }) => runReportingFailures(context.styles, async () => {
+        enterRepoRoot();
+        await pushCommand({
+            configPath: flags.config,
+            isDryRun: flags.isDryRun,
+            tags: parseRequestedTags(flags.tags),
+            tagsOnly: flags.tagsOnly,
+            styles: context.styles,
+        });
+    }),
+});
+export const publish = defineCommand({
+    summary: 'Publish packages with release tags on HEAD',
+    description: 'Publish packages that have release tags on HEAD. Operates only on workspaces whose package.json#private is absent or false. Without --tags, unpublishable workspaces are silently filtered out. With --tags, an unpublishable tag is skipped with a warning while any publishable tags are still published. A project tag is never published.',
+    flags: {
+        ...CONFIG_FLAG,
+        isDryRun: { type: 'boolean', long: 'dry-run', description: 'Preview without publishing' },
+        shouldSkipGitChecks: { type: 'boolean', long: 'no-git-checks', description: 'Skip the clean-working-tree check' },
+        tags: { ...TAGS_FLAG, description: 'Only publish the named tags (comma-separated, full tag names)' },
+        shouldGenerateProvenance: {
+            type: 'boolean',
+            long: 'provenance',
+            description: 'Generate a provenance statement (requires OIDC; not supported by classic yarn)',
+        },
+    },
+    run: ({ flags, context }) => runReportingFailures(context.styles, async () => {
+        enterRepoRoot();
+        await publishCommand({
+            configPath: flags.config,
+            isDryRun: flags.isDryRun,
+            shouldGenerateProvenance: flags.shouldGenerateProvenance,
+            shouldSkipGitChecks: flags.shouldSkipGitChecks,
+            tags: parseRequestedTags(flags.tags),
+            styles: context.styles,
+        });
+    }),
+});
+export const createGithubRelease = defineCommand({
+    summary: 'Create GitHub Releases from changelog.json for tags on HEAD',
+    description: "Create GitHub Releases from changelog.json for tags on HEAD. Private (package.json#private) workspaces are skipped with a warning, and the command doesn't create a Release for them. A project tag gets a Release even when the root package is private.",
+    flags: {
+        ...CONFIG_FLAG,
+        isDryRun: { type: 'boolean', long: 'dry-run', description: 'Preview without creating releases' },
+        tags: { ...TAGS_FLAG, description: 'Only create releases for the named tags (comma-separated, full tag names)' },
+    },
+    run: ({ flags, context }) => runReportingFailures(context.styles, async () => {
+        enterRepoRoot();
+        await createGithubReleaseCommand({
+            configPath: flags.config,
+            isDryRun: flags.isDryRun,
+            tags: parseRequestedTags(flags.tags),
+            styles: context.styles,
+        });
+    }),
+});

package/dist/esm/cli.js

@@ -1,240 +1,12 @@
 #!/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 { BIN } from "./bin.js";
+import { routeCommand } from "./route.js";
+try {
+    process.exitCode = await routeCommand(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(BIN, 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.d.ts

@@ -1,5 +1,8 @@
+export interface CommitCommandOptions {
+    isDryRun: boolean;
+}
 /**
  * Runs the CLI `commit` command: reads the tags and summary files written by `prepare`, stages all changes, and
  * creates the release commit.
  */
-export declare function commitCommand(argv: string[]): void;
+export declare function commitCommand({ isDryRun }: CommitCommandOptions): void;