@williamthorsen/release-kit 10.7.0 → 10.9.0

package/dist/esm/reportPrepare.js

@@ -1,4 +1,6 @@
+import { formatGlyphLine, formatStatusLine, measureGlyphColumn, STATUS_GLYPHS, } from '@williamthorsen/nmr-core';
 import { bold, dim, sectionHeader } from "./format.js";
+import { RELEASE_GLYPHS } from "./glyphs.js";
 import { GIT_CLIFF_NPX_ARGS } from "./runGitCliff.js";
 const CLIFF_DRY_RUN_COMMAND = `npx ${GIT_CLIFF_NPX_ARGS.join(' ')} ...`;
 export function reportPrepare(plan, options) {
@@ -10,6 +12,7 @@ export function reportPrepare(plan, options) {
 }
 function formatSingleWorkspace(result, options) {
     const dryRun = !options.applied;
+    const { style } = options;
     const lines = [];
     const workspace = result.workspaces[0];
     if (workspace === undefined) {
@@ -20,11 +23,11 @@ function formatSingleWorkspace(result, options) {
     if (workspace.parsedCommitCount !== undefined) {
         lines.push(dim(`  Parsed ${workspace.parsedCommitCount} typed commits`));
     }
-    formatUnparseableWarning(lines, workspace);
-    formatPolicyViolations(lines, workspace.policyViolations);
+    formatUnparseableWarning(lines, workspace, style);
+    formatPolicyViolations(lines, workspace.policyViolations, style);
     if (workspace.status === 'skipped') {
-        lines.push(`⏭️  ${workspace.skipReason}`);
-        formatWarnings(lines, result);
+        lines.push(formatStatusLine(style, 'skipped', workspace.skipReason));
+        formatWarnings(lines, result, style);
         return lines.join('\n');
     }
     if (workspace.setVersion !== undefined) {
@@ -40,49 +43,50 @@ function formatSingleWorkspace(result, options) {
         lines.push(dim(`Bumping versions (version override)...`));
     }
     if (workspace.setVersion !== undefined) {
-        lines.push(`📦 ${workspace.currentVersion} → ${bold(workspace.newVersion)} (version override)`);
+        lines.push(formatGlyphLine(RELEASE_GLYPHS, style, 'bump', `${workspace.currentVersion} → ${bold(workspace.newVersion)} (version override)`));
     }
     else if (workspace.releaseType !== undefined) {
-        lines.push(`📦 ${workspace.currentVersion} → ${bold(workspace.newVersion)} (${workspace.releaseType})`);
+        lines.push(formatGlyphLine(RELEASE_GLYPHS, style, 'bump', `${workspace.currentVersion} → ${bold(workspace.newVersion)} (${workspace.releaseType})`));
     }
     formatBumpFiles(lines, workspace, dryRun);
     lines.push(dim('Generating changelogs...'));
     formatChangelogFiles(lines, workspace, dryRun);
     formatPreviewFiles(lines, workspace, dryRun);
     formatFormatCommand(lines, result, options);
-    formatWarnings(lines, result);
-    lines.push(`✅ Release preparation complete.`, `   🏷️  ${bold(workspace.tag)}`);
+    formatWarnings(lines, result, style);
+    lines.push(formatStatusLine(style, 'passed', 'Release preparation complete.'), `   ${formatGlyphLine(RELEASE_GLYPHS, style, 'tag', bold(workspace.tag))}`);
     return lines.join('\n');
 }
 function formatMultiWorkspace(result, options) {
     const dryRun = !options.applied;
+    const { style } = options;
     const lines = [];
     for (const workspace of result.workspaces) {
-        formatWorkspaceSection(lines, workspace, dryRun);
+        formatWorkspaceSection(lines, workspace, dryRun, style);
     }
     if (result.project !== undefined) {
-        formatProjectSection(lines, result.project, dryRun);
+        formatProjectSection(lines, result.project, dryRun, style);
     }
     formatFormatCommand(lines, result, options);
-    formatWarnings(lines, result);
+    formatWarnings(lines, result, style);
     if (result.tags.length > 0) {
-        lines.push(`\n✅ Release preparation complete.`);
+        lines.push(`\n${formatStatusLine(style, 'passed', 'Release preparation complete.')}`);
         for (const tag of result.tags) {
-            lines.push(`   🏷️  ${bold(tag)}`);
+            lines.push(`   ${formatGlyphLine(RELEASE_GLYPHS, style, 'tag', bold(tag))}`);
         }
     }
     else {
-        lines.push(`\n⏭️  No workspaces had release-worthy changes.`);
+        lines.push(`\n${formatStatusLine(style, 'skipped', 'No workspaces had release-worthy changes.')}`);
     }
     return lines.join('\n');
 }
-function formatProjectSection(lines, project, dryRun) {
+function formatProjectSection(lines, project, dryRun, style) {
     lines.push(`\n${sectionHeader('project')}`);
     const since = project.previousTag === undefined ? '(no previous release found)' : `since ${project.previousTag}`;
     lines.push(dim(`  Found ${project.commitCount} commits ${since}`));
-    formatPolicyViolations(lines, project.policyViolations, '  ');
+    formatPolicyViolations(lines, project.policyViolations, style, '  ');
     if (project.status === 'skipped') {
-        lines.push(`  ⏭️  ${project.skipReason}`);
+        lines.push(`  ${formatStatusLine(style, 'skipped', project.skipReason)}`);
         return;
     }
     const { releaseType, currentVersion, newVersion, tag } = project;
@@ -92,8 +96,8 @@ function formatProjectSection(lines, project, dryRun) {
     if (project.bumpOverride !== undefined) {
         lines.push(`  Using bump override: ${project.bumpOverride}`);
     }
-    formatProjectUnparseable(lines, project);
-    lines.push(dim(`  Bumping versions (${releaseType})...`), `  📦 ${currentVersion} → ${bold(newVersion)} (${releaseType})`);
+    formatProjectUnparseable(lines, project, style);
+    lines.push(dim(`  Bumping versions (${releaseType})...`), `  ${formatGlyphLine(RELEASE_GLYPHS, style, 'bump', `${currentVersion} → ${bold(newVersion)} (${releaseType})`)}`);
     for (const file of project.bumpedFiles) {
         if (dryRun) {
             lines.push(dim(`    [dry-run] Would bump ${file}`));
@@ -112,9 +116,9 @@ function formatProjectSection(lines, project, dryRun) {
         }
     }
     formatPreviewFiles(lines, project, dryRun, '  ');
-    lines.push(`  🏷️  ${bold(tag)}`);
+    lines.push(`  ${formatGlyphLine(RELEASE_GLYPHS, style, 'tag', bold(tag))}`);
 }
-function formatProjectUnparseable(lines, project) {
+function formatProjectUnparseable(lines, project, style) {
     const unparseable = project.unparseableCommits;
     if (unparseable === undefined || unparseable.length === 0) {
         return;
@@ -122,35 +126,35 @@ function formatProjectUnparseable(lines, project) {
     const count = unparseable.length;
     const isPatchFloor = project.parsedCommitCount === 0;
     const suffix = isPatchFloor ? ' (defaulting to patch bump)' : '';
-    lines.push(`    ⚠️  ${count} commit${count === 1 ? '' : 's'} could not be parsed${suffix}`);
+    lines.push(`    ${formatStatusLine(style, 'warning', `${count} commit${count === 1 ? '' : 's'} could not be parsed${suffix}`)}`);
     for (const commit of unparseable) {
         const shortHash = commit.hash.slice(0, 7);
         const truncatedMessage = commit.message.length > 72 ? `${commit.message.slice(0, 69)}...` : commit.message;
         lines.push(`      · ${shortHash} ${truncatedMessage}`);
     }
 }
-function formatWorkspaceSection(lines, workspace, dryRun) {
+function formatWorkspaceSection(lines, workspace, dryRun, style) {
     if (workspace.name !== undefined) {
         lines.push(`\n${sectionHeader(workspace.name)}`);
     }
     const since = workspace.previousTag === undefined ? '(no previous release found)' : `since ${workspace.previousTag}`;
     lines.push(dim(`  Found ${workspace.commitCount} commits ${since}`));
     if (workspace.status === 'skipped') {
-        lines.push(`  ⏭️  ${workspace.skipReason}`);
+        lines.push(`  ${formatStatusLine(style, 'skipped', workspace.skipReason)}`);
         return;
     }
     const { propagatedFrom } = workspace;
     const isPropagatedOnly = propagatedFrom !== undefined && workspace.commitCount === 0;
     formatCommitSummary(lines, workspace, propagatedFrom, isPropagatedOnly);
-    formatUnparseableWarning(lines, workspace, '  ');
-    formatPolicyViolations(lines, workspace.policyViolations, '  ');
+    formatUnparseableWarning(lines, workspace, style, '  ');
+    formatPolicyViolations(lines, workspace.policyViolations, style, '  ');
     formatBumpLabels(lines, workspace, isPropagatedOnly);
-    formatVersionLine(lines, workspace, propagatedFrom, isPropagatedOnly);
+    formatVersionLine(lines, workspace, propagatedFrom, isPropagatedOnly, style);
     formatBumpFiles(lines, workspace, dryRun, '  ');
     lines.push(dim('  Generating changelogs...'));
     formatChangelogFiles(lines, workspace, dryRun, '  ');
     formatPreviewFiles(lines, workspace, dryRun, '  ');
-    lines.push(`  🏷️  ${bold(workspace.tag)}`);
+    lines.push(`  ${formatGlyphLine(RELEASE_GLYPHS, style, 'tag', bold(workspace.tag))}`);
 }
 function formatCommitSummary(lines, workspace, propagatedFrom, isPropagatedOnly) {
     if (isPropagatedOnly && propagatedFrom !== undefined) {
@@ -175,13 +179,14 @@ function formatBumpLabels(lines, workspace, isPropagatedOnly) {
         lines.push(dim(`  Bumping versions (version override)...`));
     }
 }
-function formatVersionLine(lines, workspace, propagatedFrom, isPropagatedOnly) {
+function formatVersionLine(lines, workspace, propagatedFrom, isPropagatedOnly, style) {
+    const versions = `${workspace.currentVersion} → ${bold(workspace.newVersion)}`;
     if (workspace.setVersion !== undefined) {
-        lines.push(`  📦 ${workspace.currentVersion} → ${bold(workspace.newVersion)} (version override)`);
+        lines.push(`  ${formatGlyphLine(RELEASE_GLYPHS, style, 'bump', `${versions} (version override)`)}`);
     }
     else if (workspace.releaseType !== undefined) {
         const suffix = isPropagatedOnly ? formatPropagationSuffix(propagatedFrom) : '';
-        lines.push(`  📦 ${workspace.currentVersion} → ${bold(workspace.newVersion)} (${workspace.releaseType}${suffix})`);
+        lines.push(`  ${formatGlyphLine(RELEASE_GLYPHS, style, 'bump', `${versions} (${workspace.releaseType}${suffix})`)}`);
     }
 }
 function formatBumpFiles(lines, workspace, dryRun, indent = '') {
@@ -215,7 +220,7 @@ function formatPreviewFiles(lines, release, dryRun, indent = '') {
         }
     }
 }
-function formatUnparseableWarning(lines, workspace, indent = '') {
+function formatUnparseableWarning(lines, workspace, style, indent = '') {
     const unparseable = workspace.unparseableCommits;
     if (unparseable === undefined || unparseable.length === 0) {
         return;
@@ -223,19 +228,19 @@ function formatUnparseableWarning(lines, workspace, indent = '') {
     const count = unparseable.length;
     const isPatchFloor = workspace.parsedCommitCount === 0;
     const suffix = isPatchFloor ? ' (defaulting to patch bump)' : '';
-    lines.push(`${indent}  ⚠️  ${count} commit${count === 1 ? '' : 's'} could not be parsed${suffix}`);
+    lines.push(`${indent}  ${formatStatusLine(style, 'warning', `${count} commit${count === 1 ? '' : 's'} could not be parsed${suffix}`)}`);
     for (const commit of unparseable) {
         const shortHash = commit.hash.slice(0, 7);
         const truncatedMessage = commit.message.length > 72 ? `${commit.message.slice(0, 69)}...` : commit.message;
         lines.push(`${indent}    · ${shortHash} ${truncatedMessage}`);
     }
 }
-function formatPolicyViolations(lines, violations, indent = '') {
+function formatPolicyViolations(lines, violations, style, indent = '') {
     if (violations === undefined || violations.length === 0) {
         return;
     }
     const count = violations.length;
-    lines.push(`${indent}  ⚠️  ${count} policy violation${count === 1 ? '' : 's'}:`);
+    lines.push(`${indent}  ${formatStatusLine(style, 'warning', `${count} policy violation${count === 1 ? '' : 's'}:`)}`);
     for (const violation of violations) {
         const shortHash = violation.commitHash.slice(0, 7);
         const subject = violation.commitSubject;
@@ -250,14 +255,14 @@ function formatPropagationSuffix(propagatedFrom) {
     const names = propagatedFrom.map((p) => p.packageName).join(', ');
     return `, dependency: ${names}`;
 }
-function formatWarnings(lines, result) {
+function formatWarnings(lines, result, style) {
     const { warnings } = result;
     if (warnings === undefined || warnings.length === 0) {
         return;
     }
     lines.push('');
     for (const warning of warnings) {
-        lines.push(`⚠️  ${warning}`);
+        lines.push(formatStatusLine(style, 'warning', warning));
     }
 }
 function formatFormatCommand(lines, result, options) {
@@ -272,5 +277,6 @@ function formatFormatCommand(lines, result, options) {
         lines.push(dim(`\n  Running format command: ${result.formatCommand.command}`));
         return;
     }
-    lines.push(`\n  ⚠️  Format command failed: ${result.formatCommand.command}`, `     ${options.formatError}`);
+    const messageIndent = ' '.repeat(2 + measureGlyphColumn(STATUS_GLYPHS[options.style]) + 1);
+    lines.push(`\n  ${formatStatusLine(options.style, 'warning', `Format command failed: ${result.formatCommand.command}`)}`, `${messageIndent}${options.formatError}`);
 }

package/dist/esm/resolveReleaseNotesConfig.d.ts

@@ -1,3 +1,4 @@
+import { type OutputStyle } from '@williamthorsen/nmr-core';
 import type { ReleaseNotesConfig } from './types.js';
 export interface ResolvedReleaseNotesConfig {
     releaseNotes: ReleaseNotesConfig;
@@ -20,7 +21,7 @@ export interface ResolveReleaseNotesConfigOptions {
  * By default, falls back to defaults when `loadConfig()` rejects (legacy publish behavior).
  * When `strictLoad` is `true`, a load failure prints an error and calls `process.exit(1)`.
  */
-export declare function resolveReleaseNotesConfig(options?: ResolveReleaseNotesConfigOptions): Promise<ResolvedReleaseNotesConfig>;
+export declare function resolveReleaseNotesConfig(stderrStyle: OutputStyle, options?: ResolveReleaseNotesConfigOptions): Promise<ResolvedReleaseNotesConfig>;
 /** Extract section headers in declaration order from a merged workTypes record. */
 export declare function deriveSectionOrder(workTypes: Record<string, {
     header: string;

package/dist/esm/resolveReleaseNotesConfig.js

@@ -1,9 +1,9 @@
-import { reportError } from '@williamthorsen/nmr-core';
+import { formatStatusLine, printError, reportError } from '@williamthorsen/nmr-core';
 import { describeError } from '@williamthorsen/toolbelt.errors';
 import { DEFAULT_CHANGELOG_JSON_CONFIG, DEFAULT_RELEASE_NOTES_CONFIG } from "./defaults.js";
 import { loadConfig, resolveWorkTypes } from "./loadConfig.js";
 import { validateConfig } from "./validateConfig.js";
-export async function resolveReleaseNotesConfig(options = {}) {
+export async function resolveReleaseNotesConfig(stderrStyle, options = {}) {
     const { strictLoad = false } = options;
     let rawConfig;
     try {
@@ -28,12 +28,12 @@ export async function resolveReleaseNotesConfig(options = {}) {
     if (errors.length > 0) {
         process.stderr.write('Invalid config:\n');
         for (const err of errors) {
-            process.stderr.write(`  ❌ ${err}\n`);
+            printError(err, stderrStyle);
         }
         process.exit(1);
     }
     for (const warning of warnings) {
-        console.warn(`  ⚠️  ${warning}`);
+        console.warn(`  ${formatStatusLine(stderrStyle, 'warning', warning)}`);
     }
     return {
         releaseNotes: {

package/dist/esm/resolveStylesOrExit.d.ts

@@ -0,0 +1,10 @@
+import { type StreamStyles } from '@williamthorsen/nmr-core';
+/** The environment variable holding the caller's standing style preference: `auto`, `plain`, or `rich`. */
+export declare const OUTPUT_STYLE_ENV_VAR = "RELEASE_KIT_OUTPUT_STYLE";
+export interface ResolveStylesOptions {
+    readonly env: Readonly<Record<string, string | undefined>>;
+    readonly stderrIsTty: boolean;
+    readonly stdoutIsTty: boolean;
+}
+/** Resolves the style of each output stream, exiting with a usage error when the variable names no setting. */
+export declare function resolveStylesOrExit(options: ResolveStylesOptions): StreamStyles;

package/dist/esm/resolveStylesOrExit.js

@@ -0,0 +1,10 @@
+import { describeInvalidOutputStyle, reportError, resolveStreamStyles, } from '@williamthorsen/nmr-core';
+export const OUTPUT_STYLE_ENV_VAR = 'RELEASE_KIT_OUTPUT_STYLE';
+export function resolveStylesOrExit(options) {
+    const { invalid, styles } = resolveStreamStyles({ ...options, envVar: OUTPUT_STYLE_ENV_VAR });
+    if (invalid !== undefined) {
+        reportError(describeInvalidOutputStyle(invalid));
+        process.exit(1);
+    }
+    return styles;
+}

package/dist/esm/showTagPrefixesCommand.d.ts

@@ -1,3 +1,4 @@
+import { type StreamStyles } from '@williamthorsen/nmr-core';
 /**
  * Orchestrate the CLI `show-tag-prefixes` command.
  *
@@ -9,4 +10,4 @@
  *
  * @returns The exit code the caller should use.
  */
-export declare function showTagPrefixesCommand(): Promise<number>;
+export declare function showTagPrefixesCommand(styles: StreamStyles): Promise<number>;

package/dist/esm/showTagPrefixesCommand.js

@@ -1,12 +1,13 @@
+import { formatStatusLine } from '@williamthorsen/nmr-core';
 import { detectRepoType } from "./init/detectRepoType.js";
 import { previewTagPrefixes } from "./previewTagPrefixes.js";
-export async function showTagPrefixesCommand() {
+export async function showTagPrefixesCommand(styles) {
     if (detectRepoType() === 'single-package') {
         process.stdout.write(renderSinglePackage());
         return 0;
     }
     const preview = await previewTagPrefixes();
-    process.stdout.write(renderMonorepo(preview));
+    process.stdout.write(renderMonorepo(preview, styles.stdout));
     return computeExitCode(preview);
 }
 function renderSinglePackage() {
@@ -17,13 +18,13 @@ function renderSinglePackage() {
     ];
     return lines.join('\n');
 }
-function renderMonorepo(preview) {
+function renderMonorepo(preview, style) {
     const lines = ['Workspace tag prefixes:', ''];
     for (const row of preview.workspaces) {
-        lines.push(...renderWorkspaceRow(row));
+        lines.push(...renderWorkspaceRow(row, style));
     }
     if (preview.collisions.length > 0) {
-        lines.push('', ...preview.collisions.map((collision) => `⛔ tag prefix collision: '${collision.tagPrefix}' used by ${collision.workspacePaths.join(', ')}`));
+        lines.push('', ...preview.collisions.map((collision) => formatStatusLine(style, 'failed', `tag prefix collision: '${collision.tagPrefix}' used by ${collision.workspacePaths.join(', ')}`)));
     }
     if (preview.undeclaredCandidates.length > 0) {
         lines.push('', 'Undeclared tag prefixes:', '', ...preview.undeclaredCandidates.map((candidate) => `  '${candidate.prefix}' — ${candidate.tagCount} tags (e.g., ${candidate.exampleTags.join(', ')})`), '', 'Suggested config snippet (adjust `dir` to match your workspace if the guess is wrong, and replace the `name` placeholder with the legacy npm name):', '', renderSuggestedSnippet(preview.undeclaredCandidates), '', "If the suggested `dir` does not match your workspace, adjust before pasting. Each legacy identity requires a `name` — replace the `TODO-fill-in-legacy-npm-name` placeholder with the package's prior npm name.");
@@ -31,20 +32,25 @@ function renderMonorepo(preview) {
     lines.push('');
     return lines.join('\n');
 }
-function renderWorkspaceRow(row) {
+function renderWorkspaceRow(row, style) {
     const lines = [];
     if (row.derivedPrefix === null) {
-        lines.push(`  ${row.workspacePath} — ⛔ derivation failed: ${row.derivationError ?? 'unknown error'}`);
+        const failure = formatStatusLine(style, 'failed', `derivation failed: ${row.derivationError ?? 'unknown error'}`);
+        lines.push(`  ${row.workspacePath} — ${failure}`);
         return lines;
     }
-    const statusMarker = row.derivedTagCount > 0 ? `✅ ${row.derivedTagCount} tags` : '⚠️ no existing tags';
+    const statusMarker = row.derivedTagCount > 0
+        ? formatStatusLine(style, 'passed', `${row.derivedTagCount} tags`)
+        : formatStatusLine(style, 'warning', 'no existing tags');
     lines.push(`  ${row.workspacePath} — derived prefix '${row.derivedPrefix}', ${statusMarker}`);
     for (const entry of row.legacyEntries) {
         if (entry.tagCount > 0) {
-            lines.push(`      ✅ ${entry.tagCount} legacy tags with '${entry.prefix}' prefix (recognized)`);
+            const recognized = `${entry.tagCount} legacy tags with '${entry.prefix}' prefix (recognized)`;
+            lines.push(`      ${formatStatusLine(style, 'passed', recognized)}`);
         }
         else {
-            lines.push(`      ⚠️ recorded legacy prefix '${entry.prefix}' has no tags`);
+            const tagless = `recorded legacy prefix '${entry.prefix}' has no tags`;
+            lines.push(`      ${formatStatusLine(style, 'warning', tagless)}`);
         }
     }
     return lines;

package/dist/esm/sync-labels/generateCommand.d.ts

@@ -1,3 +1,4 @@
+import { type OutputStyle, type StreamStyles } from '@williamthorsen/nmr-core';
 import type { RepoLabelsConfig } from '../types.js';
 import type { LabelDefinition } from './types.js';
 /** Output path for the generated labels file. */
@@ -10,11 +11,12 @@ export declare function formatLabelsYaml(labels: LabelDefinition[], presetHashes
  * Reports an actionable error and returns `undefined` when the config file is missing,
  * fails to load or validate, or carries no `repoLabels` block.
  */
-export declare function loadRepoLabelsConfig(): Promise<RepoLabelsConfig | undefined>;
+export declare function loadRepoLabelsConfig(stderrStyle: OutputStyle): Promise<RepoLabelsConfig | undefined>;
 /** Options for the `sync-labels generate` subcommand. */
 interface GenerateOptions {
     /** Compare the regenerated content against the committed file instead of writing. */
     check?: boolean;
+    styles: StreamStyles;
 }
 /**
  * Runs the `sync-labels generate` command.
@@ -23,5 +25,5 @@ interface GenerateOptions {
  * and writes `.github/labels.yaml` -- or, with `check`, regenerates in memory and reports whether the committed file
  * is stale, writing nothing. Returns 0 on success, 1 on failure.
  */
-export declare function generateCommand({ check }?: GenerateOptions): Promise<number>;
+export declare function generateCommand({ check, styles }: GenerateOptions): Promise<number>;
 export {};

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

@@ -19,8 +19,8 @@ export function formatLabelsYaml(labels, presetHashes) {
     const yamlBody = stringify(declared, { singleQuote: true, lineWidth: 0 });
     return headerLines.join('\n') + '\n' + yamlBody;
 }
-export async function loadRepoLabelsConfig() {
-    const result = await loadValidatedConfig();
+export async function loadRepoLabelsConfig(stderrStyle) {
+    const result = await loadValidatedConfig(stderrStyle);
     if (result.status === 'missing') {
         reportError(`No config file found at ${CONFIG_FILE_PATH}. Run \`release-kit sync-labels init\` first.`);
         return undefined;
@@ -34,11 +34,11 @@ export async function loadRepoLabelsConfig() {
     }
     return result.config.repoLabels;
 }
-export async function generateCommand({ check = false } = {}) {
+export async function generateCommand({ check = false, styles }) {
     if (checkRetiredSyncLabelsConfig()) {
         return 1;
     }
-    const repoLabels = await loadRepoLabelsConfig();
+    const repoLabels = await loadRepoLabelsConfig(styles.stderr);
     if (repoLabels === undefined) {
         return 1;
     }

package/dist/esm/sync-labels/initCommand.d.ts

@@ -1,7 +1,9 @@
+import { type StreamStyles } from '@williamthorsen/nmr-core';
 /** Options for the `sync-labels init` subcommand. */
 interface InitOptions {
     dryRun: boolean;
     force: boolean;
+    styles: StreamStyles;
 }
 /**
  * Run the `sync-labels init` subcommand.
@@ -11,5 +13,5 @@ interface InitOptions {
  * printed to stdout for manual paste when the file is already there — an existing,
  * hand-authored config is never rewritten. Returns 0 on success, 1 on failure.
  */
-export declare function syncLabelsInitCommand({ dryRun, force }: InitOptions): Promise<number>;
+export declare function syncLabelsInitCommand({ dryRun, force, styles }: InitOptions): Promise<number>;
 export {};

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

@@ -8,7 +8,7 @@ import { generateCommand, LABELS_OUTPUT_PATH } from "./generateCommand.js";
 import { checkRetiredSyncLabelsConfig } from "./retiredConfig.js";
 import { buildScopeLabels, renderRepoLabelsBlock, repoLabelsConfigScript, syncLabelsWorkflow } from "./templates.js";
 const WORKFLOW_PATH = '.github/workflows/sync-labels.yaml';
-export async function syncLabelsInitCommand({ dryRun, force }) {
+export async function syncLabelsInitCommand({ dryRun, force, styles }) {
     if (checkRetiredSyncLabelsConfig()) {
         return 1;
     }
@@ -32,14 +32,14 @@ export async function syncLabelsInitCommand({ dryRun, force }) {
         console.info(`  Found ${String(workspacePaths.length)} workspaces`);
     }
     const configExists = existsSync(CONFIG_FILE_PATH);
-    const retiredNames = configExists ? await loadRetiredPackageNames() : [];
+    const retiredNames = configExists ? await loadRetiredPackageNames(styles) : [];
     if (retiredNames === undefined) {
         return 1;
     }
     const scopeLabels = workspacePaths === undefined ? [] : buildScopeLabels(workspacePaths, retiredNames);
     console.info('\n> Scaffolding files');
     const workflowResult = writeFileWithCheck(WORKFLOW_PATH, syncLabelsWorkflow(), { dryRun, overwrite: force });
-    reportWriteResult(workflowResult, dryRun);
+    reportWriteResult(workflowResult, dryRun, styles);
     if (configExists) {
         console.info(`\n> ${CONFIG_FILE_PATH} already exists; add this block to the object passed to defineConfig:\n`);
         console.info(renderRepoLabelsBlock(scopeLabels));
@@ -60,7 +60,7 @@ export async function syncLabelsInitCommand({ dryRun, force }) {
         dryRun,
         overwrite: force,
     });
-    reportWriteResult(configResult, dryRun);
+    reportWriteResult(configResult, dryRun, styles);
     if (workflowResult.outcome === 'failed' || configResult.outcome === 'failed') {
         process.stderr.write('Failed to scaffold one or more files.\n');
         return 1;
@@ -70,7 +70,7 @@ export async function syncLabelsInitCommand({ dryRun, force }) {
     }
     else {
         console.info('\n> Generating labels');
-        const generateExitCode = await generateCommand();
+        const generateExitCode = await generateCommand({ styles });
         if (generateExitCode !== 0) {
             return generateExitCode;
         }
@@ -87,8 +87,8 @@ export async function syncLabelsInitCommand({ dryRun, force }) {
 `);
     return 0;
 }
-async function loadRetiredPackageNames() {
-    const result = await loadValidatedConfig();
+async function loadRetiredPackageNames(styles) {
+    const result = await loadValidatedConfig(styles.stderr);
     if (result.status === 'invalid') {
         return undefined;
     }

package/dist/esm/tagCommand.d.ts

@@ -1,2 +1,3 @@
+import { type StreamStyles } from '@williamthorsen/nmr-core';
 /** Orchestrate the CLI `tag` command: parse flags and delegate to `createTags`. */
-export declare function tagCommand(argv: string[]): void;
+export declare function tagCommand(argv: string[], styles: StreamStyles): void;

package/dist/esm/tagCommand.js

@@ -5,10 +5,10 @@ const tagFlagSchema = {
     dryRun: { long: '--dry-run', type: 'boolean' },
     noGitChecks: { long: '--no-git-checks', type: 'boolean' },
 };
-export function tagCommand(argv) {
+export function tagCommand(argv, styles) {
     const { dryRun, noGitChecks } = parseArgsOrExit(argv, tagFlagSchema).flags;
     try {
-        createTags({ dryRun, noGitChecks });
+        createTags({ dryRun, noGitChecks, style: styles.stdout });
     }
     catch (error) {
         reportError(describeError(error));

package/dist/esm/types.d.ts

@@ -11,19 +11,20 @@ export interface ChangelogItem {
     /**
      * Whether this item represents a breaking change.
      *
-     * `true` when the commit subject carries the `!` prefix (e.g. `feat!:` or `drop(scope)!:`).
-     * The `BREAKING CHANGE:` body footer is intentionally NOT considered here — only the prefix
-     * `!` marks a changelog item as breaking. Renderers prefix breaking-item bullets with the
-     * marker constructed from `WORK_TYPES_DATA.markers.breaking` (rendered as `🚨 **Breaking:** `
-     * with the canonical SSOT values) to surface them prominently in release notes.
+     * `true` when the commit subject carries the `!` prefix (e.g. `feat!:` or `drop(scope)!:`) and
+     * the commit's work-type policy permits it, so the item agrees with the version bump.
+     * The `BREAKING CHANGE:` body footer is intentionally NOT considered here. Renderers prefix
+     * breaking-item bullets with the marker constructed from `WORK_TYPES_DATA.markers.breaking`
+     * (rendered as `🚨 **Breaking:** ` with the canonical SSOT values) to surface them prominently
+     * in release notes.
      */
     breaking?: boolean;
     /**
      * Migration instruction for a consumer, taken from the `Migration:` paragraph of `body`.
      *
      * Derived from `body` wherever `body` is set, and absent where the body carries no labeled
-     * paragraph. Independent of `breaking`: a `fix` that tightens validation cannot carry `!` under
-     * the default breaking policy and still imposes a migration. `body` keeps the paragraph, so
+     * paragraph. Independent of `breaking`: a `deprecate` commit cannot carry `!` under the default
+     * breaking policy and still calls for a migration. `body` keeps the paragraph, so
      * `CHANGELOG.md` goes on rendering it in place.
      */
     migration?: string;

package/dist/esm/validateOverridesCommand.d.ts

@@ -1,9 +1,9 @@
+import { type OutputStyle, type StreamStyles } from '@williamthorsen/nmr-core';
 import { type ValidateAllChangelogOverridesInputs, type ValidateAllChangelogOverridesResult } from './changelogOverrides.js';
 import type { ChangelogEntry, ReleaseConfig } from './types.js';
 /**
  * Result of {@link validateOverridesCommand}: tiered exit code paired with a human-readable
- * message. Mirrors the shape of `checkWorkTypesDrift` so the CLI dispatch layer can stay
- * uniformly thin.
+ * message, which keeps the CLI dispatch layer thin.
  *
  * Exit codes:
  * - `0` — clean: no errors, no warnings.
@@ -36,9 +36,9 @@ export interface ValidateOverridesCommandDependencies {
  * Single-package and monorepo modes are handled uniformly: single-package collapses to one
  * project scope; monorepo expands to a project scope plus one scope per workspace.
  */
-export declare function validateOverridesCommand(dependencies?: ValidateOverridesCommandDependencies): Promise<ValidateOverridesCommandResult>;
+export declare function validateOverridesCommand(styles: StreamStyles, dependencies?: ValidateOverridesCommandDependencies): Promise<ValidateOverridesCommandResult>;
 /**
  * Pure formatter — take an aggregated validation result, return the tiered exit code and a
  * rendered message. Exported for unit testing without going through the full discovery path.
  */
-export declare function formatValidateOverridesResult(result: ValidateAllChangelogOverridesResult): ValidateOverridesCommandResult;
+export declare function formatValidateOverridesResult(result: ValidateAllChangelogOverridesResult, style: OutputStyle): ValidateOverridesCommandResult;

package/dist/esm/validateOverridesCommand.js

@@ -1,4 +1,4 @@
-import { formatErrorLine } from '@williamthorsen/nmr-core';
+import { formatErrorLine, formatStatusLine } from '@williamthorsen/nmr-core';
 import { describeError } from '@williamthorsen/toolbelt.errors';
 import { buildChangelogEntries } from "./buildChangelogEntries.js";
 import { resolveOverridePath, validateAllChangelogOverrides, } from "./changelogOverrides.js";
@@ -7,7 +7,7 @@ import { buildTagPattern, getAllTagPrefixes } from "./generateChangelogs.js";
 import { loadConfig, mergeMonorepoConfig, mergeSinglePackageConfig, readRootPackageVersion } from "./loadConfig.js";
 import { validateConfig } from "./validateConfig.js";
 const SYNTHETIC_VALIDATE_TAG = 'validate-only';
-export async function validateOverridesCommand(dependencies = {}) {
+export async function validateOverridesCommand(styles, dependencies = {}) {
     const discover = dependencies.discoverWorkspaces ?? discoverWorkspaces;
     const load = dependencies.loadConfig ?? loadConfig;
     const buildEntries = dependencies.buildEntries ?? defaultBuildEntries;
@@ -44,17 +44,17 @@ export async function validateOverridesCommand(dependencies = {}) {
         return { exitCode: 2, message: formatErrorLine(`Failed to resolve overrides scope: ${describeError(error)}`) };
     }
     const result = validate(inputs);
-    return formatValidateOverridesResult(result);
+    return formatValidateOverridesResult(result, styles.stderr);
 }
-export function formatValidateOverridesResult(result) {
+export function formatValidateOverridesResult(result, style) {
     const { errors, warnings } = result;
     if (errors.length === 0 && warnings.length === 0) {
         return { exitCode: 0, message: 'All override files are valid (no errors, no stale keys).' };
     }
     const exitCode = errors.length > 0 ? 2 : 1;
     const summary = formatSummaryLine(errors.length, warnings.length);
-    const errorLines = errors.map((message) => `  ❌ ${message}`);
-    const warningLines = warnings.map((message) => `  ⚠️  ${message}`);
+    const errorLines = errors.map((message) => `  ${formatStatusLine(style, 'failed', message)}`);
+    const warningLines = warnings.map((message) => `  ${formatStatusLine(style, 'warning', message)}`);
     const message = [summary, '', ...errorLines, ...warningLines].join('\n');
     return { exitCode, message };
 }