@williamthorsen/release-kit 10.6.0 → 10.8.0

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

@@ -35,8 +35,9 @@ Commands:
   work-types       Check for or sync work-type taxonomy drift against the upstream canonical
 
 Options:
-  --dry-run     Preview changes without writing files
-  --help, -h    Show this help message
+  --dry-run        Preview changes without writing files
+  --help, -h       Show this help message
+  --version, -V    Show the version number
 `);
 }
 function showSyncLabelsHelp() {
@@ -95,7 +96,7 @@ function showInitHelp() {
 Usage: release-kit init [options]
 
 Initialize release-kit in the current repository.
-By default, scaffolds only the GitHub Actions workflow file.
+By default, scaffolds only the GitHub Actions workflow files.
 
 Options:
   --with-config   Also scaffold .config/release-kit.config.ts and .config/git-cliff.toml
@@ -208,7 +209,7 @@ Subcommands:
   sync          Overwrite the local work-types.json with the upstream contents
 
 Exit codes (check):
-  0    Match (or upstream missing — transitional warning printed)
+  0    Match (or upstream not found, with a warning)
   1    Drift detected
   2    Network error
   3    Schema mismatch
@@ -222,8 +223,8 @@ function showWorkTypesCheckHelp() {
 Usage: release-kit work-types check
 
 Compare the local work-types.json against the upstream codeassembly canonical and report
-drift. Exit 0 on match, 1 on drift, 0 + warning when upstream is missing (transitional),
-2 on network error, 3 on schema mismatch.
+drift. Exit 0 on match, 1 on drift, 0 + warning when upstream is not found, 2 on network
+error, 3 on schema mismatch.
 
 Options:
   --help, -h    Show this help message

package/dist/esm/buildChangelogEntries.d.ts

@@ -23,4 +23,4 @@ export declare function stripGroupDecorations(group: string): string;
  * not whether git-cliff runs). This means dry-run exercises the full git-cliff toolchain and surfaces missing-binary,
  * malformed-config, and template-resolution failures earlier than before.
  */
-export declare function buildChangelogEntries(config: Pick<ReleaseConfig, 'cliffConfigPath' | 'changelogJson'>, tag: string, options?: GenerateChangelogOptions): ChangelogEntry[];
+export declare function buildChangelogEntries(config: Pick<ReleaseConfig, 'breakingPolicies' | 'changelogJson' | 'cliffConfigPath' | 'workTypes'>, tag: string, options?: GenerateChangelogOptions): ChangelogEntry[];

package/dist/esm/buildChangelogEntries.js

@@ -1,8 +1,8 @@
 import { chainError } from '@williamthorsen/toolbelt.errors/candidate';
 import { extractVersion } from "./changelogJsonUtils.js";
-import { DEFAULT_WORK_TYPES } from "./defaults.js";
+import { DEFAULT_BREAKING_POLICIES, DEFAULT_WORK_TYPES } from "./defaults.js";
 import { extractMigration } from "./extractMigration.js";
-import { COMMIT_PREPROCESSOR_PATTERNS, PIPE_SCOPE_SOURCE } from "./parseCommitMessage.js";
+import { COMMIT_PREPROCESSOR_PATTERNS, parseCommitMessage, PIPE_SCOPE_SOURCE } from "./parseCommitMessage.js";
 import { resolveCliffConfigPath } from "./resolveCliffConfigPath.js";
 import { runGitCliff } from "./runGitCliff.js";
 import { stripEmojiPrefix } from "./stripEmojiPrefix.js";
@@ -30,7 +30,9 @@ export function buildChangelogEntries(config, tag, options) {
         const contextJson = runGitCliff(resolvedConfigPath, cliffArgs);
         const releases = parseCliffContext(contextJson);
         const devOnlySections = new Set(config.changelogJson.devOnlySections);
-        return transformReleases(releases, devOnlySections);
+        const workTypes = config.workTypes ?? DEFAULT_WORK_TYPES;
+        const breakingPolicies = config.breakingPolicies ?? DEFAULT_BREAKING_POLICIES;
+        return transformReleases(releases, devOnlySections, workTypes, breakingPolicies);
     }
     catch (error) {
         throw chainError(`Failed to build changelog entries for tag ${tag}`, error);
@@ -74,7 +76,7 @@ function toCliffContextCommit(value) {
     }
     return commit;
 }
-function transformReleases(releases, devOnlySections) {
+function transformReleases(releases, devOnlySections, workTypes, breakingPolicies) {
     const entries = [];
     const devOnlyNormalised = new Set([...devOnlySections].map(stripGroupDecorations));
     for (const release of releases) {
@@ -89,7 +91,7 @@ function transformReleases(releases, devOnlySections) {
             const group = stripCommentPrefix(commit.group ?? 'Other');
             const description = extractDescription(commit.message);
             const body = extractBody(commit.message);
-            const breaking = subjectHasBreakingMarker(commit.message);
+            const breaking = isBreakingUnderPolicy(commit, workTypes, breakingPolicies);
             let items = sectionMap.get(group);
             if (items === undefined) {
                 items = [];
@@ -132,6 +134,13 @@ function transformReleases(releases, devOnlySections) {
 function stripCommentPrefix(group) {
     return group.replace(HTML_COMMENT_PREFIX_PATTERN, '');
 }
+function isBreakingUnderPolicy(commit, workTypes, breakingPolicies) {
+    if (!subjectHasBreakingMarker(commit.message)) {
+        return false;
+    }
+    const parsed = parseCommitMessage(commit.message, commit.id ?? '', workTypes, undefined, { breakingPolicies });
+    return parsed?.breaking ?? true;
+}
 const SUBJECT_BREAKING_MARKER_PATTERN = new RegExp(String.raw `^(?:${PIPE_SCOPE_SOURCE}\|)?\w+(?:\([^)]+\))?!:`);
 function subjectHasBreakingMarker(message) {
     let subject = message.split('\n', 1)[0] ?? '';

package/dist/esm/buildDependencyGraph.d.ts

@@ -1,10 +1,12 @@
 import type { WorkspaceConfig } from './types.js';
-/** Reverse adjacency map from package names to their workspace dependents. */
+/** Identities, current versions, and `workspace:` dependency edges of the workspaces' packages. */
 export interface DependencyGraph {
     /** Resolve a package name to its workspace `dir`. */
     packageNameToDir: Map<string, string>;
     /** Resolve a workspace `dir` to its package name (inverse of `packageNameToDir`). */
     dirToPackageName: Map<string, string>;
+    /** Resolve a workspace `dir` to its current version; absent when its `package.json` has no string `version`. */
+    dirToVersion: Map<string, string>;
     /** Map a package name to the workspaces that depend on it. */
     dependentsOf: Map<string, WorkspaceConfig[]>;
     /**
@@ -14,11 +16,10 @@ export interface DependencyGraph {
     dependenciesOf: Map<string, Set<string>>;
 }
 /**
- * Build a reverse dependency graph from the workspaces' `package.json` files.
+ * Builds the dependency graph from the workspaces' `package.json` files.
  *
  * Reads each workspace's primary `package.json` (first entry in `packageFiles`) to discover
- * `workspace:` references in `dependencies` and `peerDependencies`. Returns a map from each
- * package name to the workspaces that depend on it, enabling upward traversal from a bumped
- * package to all its dependents.
+ * `workspace:` references in `dependencies` and `peerDependencies`, and to record its current
+ * version.
  */
 export declare function buildDependencyGraph(workspaces: readonly WorkspaceConfig[]): DependencyGraph;

package/dist/esm/buildDependencyGraph.js

@@ -6,6 +6,7 @@ function isPackageJsonSubset(value) {
 export function buildDependencyGraph(workspaces) {
     const packageNameToDir = new Map();
     const dirToPackageName = new Map();
+    const dirToVersion = new Map();
     const dependentsOf = new Map();
     const dependenciesOf = new Map();
     const workspacePackages = new Map();
@@ -16,6 +17,9 @@ export function buildDependencyGraph(workspaces) {
         }
         const pkg = readPackageJsonSubset(primaryPackageFile);
         workspacePackages.set(workspace, pkg);
+        if (typeof pkg.version === 'string') {
+            dirToVersion.set(workspace.dir, pkg.version);
+        }
         if (pkg.name === undefined) {
             continue;
         }
@@ -44,7 +48,7 @@ export function buildDependencyGraph(workspaces) {
             }
         }
     }
-    return { packageNameToDir, dirToPackageName, dependentsOf, dependenciesOf };
+    return { packageNameToDir, dirToPackageName, dirToVersion, dependentsOf, dependenciesOf };
 }
 function readPackageJsonSubset(filePath) {
     let content;

package/dist/esm/checkWorkTypesDrift.d.ts

@@ -4,7 +4,7 @@ export declare const UPSTREAM_WORK_TYPES_URL = "https://raw.githubusercontent.co
 export interface DriftCheckResult {
     /**
      * Process exit code semantics:
-     * - `0` — match (or upstream missing/transitional, with a warning).
+     * - `0` — match (or upstream not found, with a warning).
      * - `1` — drift detected.
      * - `2` — network error.
      * - `3` — schema mismatch (upstream JSON does not parse or fails the schema invariants).
@@ -27,8 +27,7 @@ export interface CheckWorkTypesDriftDependencies {
  *
  * Failure modes:
  * - Network error → exit 2 with a diagnostic.
- * - Upstream 404 → exit 0 with a transitional warning (codeassembly hasn't published the
- *   JSON yet; the check is informational while migration is in flight).
+ * - Upstream 404 → exit 0 with a warning.
  * - Schema mismatch → exit 3 with a diagnostic.
  * - Drift → exit 1 with a unified-diff-style message.
  * - Match → exit 0.

package/dist/esm/checkWorkTypesDrift.js

@@ -38,7 +38,7 @@ export async function checkWorkTypesDrift(dependencies = {}) {
     if (response.status === 404) {
         return {
             exitCode: 0,
-            message: `Upstream work-types.json not yet published at ${url}; skipping drift check.`,
+            message: `Upstream work-types.json not found at ${url}; skipping drift check.`,
         };
     }
     if (!response.ok) {

package/dist/esm/init/scaffold.js

@@ -1,22 +1,30 @@
-import { existsSync, readFileSync } from 'node:fs';
+import { readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
 import { findPackageRoot, writeFileWithCheck } from '@williamthorsen/nmr-core';
 import { describeError } from '@williamthorsen/toolbelt.errors';
 import { createGithubReleaseWorkflow, publishWorkflow, releaseConfigScript, releaseWorkflow } from "./templates.js";
 export function copyCliffTemplate(dryRun, overwrite) {
     const destPath = '.config/git-cliff.toml';
-    const root = findPackageRoot(import.meta.url);
-    const templatePath = resolve(root, 'cliff.toml.template');
-    if (!existsSync(templatePath)) {
-        return { filePath: destPath, outcome: 'failed', error: `Could not find bundled template at ${templatePath}` };
+    let root;
+    try {
+        root = findPackageRoot(import.meta.url);
+    }
+    catch (error) {
+        const message = describeError(error);
+        return { filePath: destPath, outcome: 'failed', error: `Failed to resolve package root: ${message}` };
     }
+    const templatePath = resolve(root, 'cliff.toml.template');
     let content;
     try {
         content = readFileSync(templatePath, 'utf8');
     }
     catch (error) {
         const message = describeError(error);
-        return { filePath: destPath, outcome: 'failed', error: `Failed to read template ${templatePath}: ${message}` };
+        return {
+            filePath: destPath,
+            outcome: 'failed',
+            error: `Failed to read bundled template at ${templatePath}: ${message}`,
+        };
     }
     return writeFileWithCheck(destPath, content, { dryRun, overwrite });
 }

package/dist/esm/parseCommitMessage.d.ts

@@ -15,10 +15,9 @@ export type PolicyViolationSurface = 'prefix' | 'body';
 /**
  * Callback invoked when `parseCommitMessage` detects a `!`-policy violation.
  *
- * Two-tier policy: at write-time (commit-msg hook, OOS for ticket #355), violations are
- * rejected outright; at release-time (this parser), violations are warn-and-continue so
- * legacy log entries don't block releases. Callers (`decideRelease`, `releasePrepareMono`,
- * etc.) collect callback invocations and surface them in the release report.
+ * The parser warns and continues on a violation, so legacy log entries don't block releases.
+ * Callers (`decideRelease`, `releasePrepareMono`, etc.) collect callback invocations and
+ * surface them in the release report.
  */
 export type PolicyViolationHandler = (commit: Commit, type: string, surface: PolicyViolationSurface) => void;
 /** Optional configuration for `parseCommitMessage` beyond the core inputs. */
@@ -47,6 +46,6 @@ export interface ParseCommitMessageOptions {
  * `!`-policy enforcement is **release-time tolerant**: when the resolved type's policy
  * forbids `!`, the marker is dropped from the parse (`breaking: false`) and
  * `onPolicyViolation` is invoked. When the policy requires `!`, a bare type triggers the
- * same warning path. The strict write-time gate (commit-msg hook) is out of scope.
+ * same warning path.
  */
 export declare function parseCommitMessage(message: string, hash: string, workTypes: Record<string, WorkTypeConfig>, scopeAliases?: Record<string, string>, options?: ParseCommitMessageOptions): ParsedCommit | undefined;

package/dist/esm/planVersionBump.d.ts

@@ -16,6 +16,7 @@ export interface VersionBumpPlan {
 export declare function planVersionBump(packageFiles: readonly string[], releaseType: ReleaseType): VersionBumpPlan;
 /**
  * Computes an explicit version assignment for a workspace's package files without writing them,
- * bypassing commit-derived bump logic. Backs the `--set-version` flag.
+ * bypassing commit-derived bump logic. Backs the `--set-version` flag, and so rejects a
+ * `newVersion` that is not greater than the current version.
  */
 export declare function planVersionSet(packageFiles: readonly string[], newVersion: string): VersionBumpPlan;

package/dist/esm/planVersionBump.js

@@ -1,6 +1,7 @@
 import { readFileSync } from 'node:fs';
 import { chainError } from '@williamthorsen/toolbelt.errors/candidate';
 import { bumpVersion } from "./bumpVersion.js";
+import { isForwardVersion } from "./compareVersions.js";
 function isPackageJson(value) {
     return typeof value === 'object' && value !== null && 'version' in value && typeof value.version === 'string';
 }
@@ -13,6 +14,9 @@ export function planVersionBump(packageFiles, releaseType) {
 export function planVersionSet(packageFiles, newVersion) {
     const { firstFile, firstPkg } = readPrimaryPackage(packageFiles);
     const currentVersion = firstPkg.version;
+    if (!isForwardVersion(currentVersion, newVersion)) {
+        throw new Error(`--set-version ${newVersion} is not greater than current version ${currentVersion}`);
+    }
     return { currentVersion, newVersion, writes: renderVersionWrites(packageFiles, firstFile, firstPkg, newVersion) };
 }
 function readPrimaryPackage(packageFiles) {

package/dist/esm/propagateBumps.d.ts

@@ -12,8 +12,6 @@ export interface ReleaseEntry {
      */
     newVersionOverride?: string;
 }
-/** Map from workspace `dir` to its current version string (read from package.json). */
-export type CurrentVersions = Map<string, string>;
 /**
  * Walk upward through the dependency graph via BFS, adding `patch` bumps for dependents
  * not already in the release set with a higher bump.
@@ -21,4 +19,4 @@ export type CurrentVersions = Map<string, string>;
  * Returns the full release set (direct + propagated). Direct entries that also have a
  * propagated dependency get `propagatedFrom` metadata without changing their bump type.
  */
-export declare function propagateBumps(directBumps: Map<string, ReleaseEntry>, graph: DependencyGraph, currentVersions: CurrentVersions): Map<string, ReleaseEntry>;
+export declare function propagateBumps(directBumps: Map<string, ReleaseEntry>, graph: DependencyGraph): Map<string, ReleaseEntry>;

package/dist/esm/propagateBumps.js

@@ -1,5 +1,5 @@
 import { bumpVersion } from "./bumpVersion.js";
-export function propagateBumps(directBumps, graph, currentVersions) {
+export function propagateBumps(directBumps, graph) {
     const result = new Map();
     for (const [dir, entry] of directBumps) {
         result.set(dir, { ...entry });
@@ -19,7 +19,7 @@ export function propagateBumps(directBumps, graph, currentVersions) {
         if (packageName === undefined) {
             continue;
         }
-        const currentVersion = currentVersions.get(dir);
+        const currentVersion = graph.dirToVersion.get(dir);
         const entry = result.get(dir);
         if (currentVersion === undefined || entry === undefined) {
             continue;

package/dist/esm/releasePrepare.js

@@ -5,7 +5,6 @@ import { buildReleaseSummary } from "./buildReleaseSummary.js";
 import { mergeChangelogEntriesWithDisk, renderChangelogJson, resolveChangelogJsonPath } from "./changelogJsonFile.js";
 import { applyChangelogOverrides, formatStaleOverrideKeyWarning, loadOverridesForScopes, } from "./changelogOverrides.js";
 import { createPolicyViolationCollector } from "./collectPolicyViolations.js";
-import { isForwardVersion } from "./compareVersions.js";
 import { DEFAULT_BREAKING_POLICIES, DEFAULT_VERSION_PATTERNS, DEFAULT_WORK_TYPES } from "./defaults.js";
 import { determineBumpFromCommits } from "./determineBumpFromCommits.js";
 import { getCommitsSinceTarget } from "./getCommitsSinceTarget.js";
@@ -13,7 +12,6 @@ import { hasPrettierConfig } from "./hasPrettierConfig.js";
 import { resolveWorkTypes } from "./loadConfig.js";
 import { planReleaseNotesPreviews } from "./planReleaseNotesPreviews.js";
 import { planVersionBump, planVersionSet } from "./planVersionBump.js";
-import { readCurrentVersion } from "./readCurrentVersion.js";
 import { renderChangelogMarkdown } from "./renderChangelogMarkdown.js";
 import { deriveSectionOrder } from "./resolveReleaseNotesConfig.js";
 export function releasePrepare(config, options) {
@@ -34,17 +32,6 @@ export function releasePrepare(config, options) {
     const collector = createPolicyViolationCollector();
     let bump;
     if (setVersion !== undefined) {
-        const primaryPackageFile = config.packageFiles[0];
-        if (primaryPackageFile === undefined) {
-            throw new Error('No package files specified');
-        }
-        const currentVersion = readCurrentVersion(primaryPackageFile);
-        if (currentVersion === undefined) {
-            throw new Error(`Cannot validate --set-version: failed to read current version from ${primaryPackageFile}`);
-        }
-        if (!isForwardVersion(currentVersion, setVersion)) {
-            throw new Error(`--set-version ${setVersion} is not greater than current version ${currentVersion}`);
-        }
         bump = planVersionSet(config.packageFiles, setVersion);
     }
     else {

package/dist/esm/releasePrepareMono.js

@@ -8,7 +8,6 @@ import { buildSyntheticChangelogEntry } from "./buildSyntheticChangelogEntry.js"
 import { mergeChangelogEntriesWithDisk, renderChangelogJson, resolveChangelogJsonPath } from "./changelogJsonFile.js";
 import { applyWorkspaceOverrides, createOverrideContext, formatStaleOverrideKeyWarning, } from "./changelogOverrides.js";
 import { createPolicyViolationCollector } from "./collectPolicyViolations.js";
-import { isForwardVersion } from "./compareVersions.js";
 import { decideRelease } from "./decideRelease.js";
 import { DEFAULT_BREAKING_POLICIES, DEFAULT_VERSION_PATTERNS, DEFAULT_WORK_TYPES } from "./defaults.js";
 import { detectUndeclaredTagPrefixes } from "./detectUndeclaredTagPrefixes.js";
@@ -19,7 +18,6 @@ import { resolveWorkTypes } from "./loadConfig.js";
 import { planReleaseNotesPreviews } from "./planReleaseNotesPreviews.js";
 import { planVersionBump, planVersionSet } from "./planVersionBump.js";
 import { propagateBumps } from "./propagateBumps.js";
-import { readCurrentVersion } from "./readCurrentVersion.js";
 import { releasePrepareProject } from "./releasePrepareProject.js";
 import { renderChangelogMarkdown } from "./renderChangelogMarkdown.js";
 import { deriveSectionOrder } from "./resolveReleaseNotesConfig.js";
@@ -32,7 +30,7 @@ export function releasePrepareMono(config, options) {
     }
     const sectionOrder = deriveSectionOrder(resolveWorkTypes(config.workTypes));
     const overrideContext = createOverrideContext(config.workspaces);
-    const { directBumps, directResults, skippedResults, currentVersions } = determineDirectBumps(config, options);
+    const { directBumps, directResults, skippedResults } = determineDirectBumps(config, options);
     const previousTags = new Map();
     for (const result of directResults.values()) {
         previousTags.set(result.workspace.dir, result.tag);
@@ -41,7 +39,7 @@ export function releasePrepareMono(config, options) {
         previousTags.set(skipped.workspace.dir, skipped.tag);
     }
     const graph = buildDependencyGraph(config.workspaces);
-    const fullReleaseSet = propagateBumps(directBumps, graph, currentVersions);
+    const fullReleaseSet = propagateBumps(directBumps, graph);
     const { sorted: sortedDirs, cyclicDirs } = topologicalSort(fullReleaseSet, graph);
     if (cyclicDirs.length > 0) {
         warnings.push(`Circular workspace dependencies detected among: ${cyclicDirs.join(', ')}. ` +
@@ -119,7 +117,6 @@ function determineDirectBumps(config, options) {
     const directBumps = new Map();
     const directResults = new Map();
     const skippedResults = [];
-    const currentVersions = new Map();
     const hintState = { emitted: false };
     const knownPrefixes = config.workspaces.flatMap(getAllTagPrefixes);
     for (const workspace of config.workspaces) {
@@ -130,21 +127,7 @@ function determineDirectBumps(config, options) {
         if (tag === undefined) {
             maybeEmitBaselineHint(workspace, knownPrefixes, hintState);
         }
-        const primaryPackageFile = workspace.packageFiles[0];
-        if (primaryPackageFile !== undefined) {
-            const currentVersion = tryStage(stageLabel, () => readCurrentVersion(primaryPackageFile));
-            if (currentVersion !== undefined) {
-                currentVersions.set(workspace.dir, currentVersion);
-            }
-        }
         if (setVersion !== undefined) {
-            const currentVersion = currentVersions.get(workspace.dir);
-            if (currentVersion === undefined) {
-                throw new Error(`Cannot validate --set-version: failed to read current version from ${primaryPackageFile ?? '(no package file)'}`);
-            }
-            if (!isForwardVersion(currentVersion, setVersion)) {
-                throw new Error(`--set-version ${setVersion} is not greater than current version ${currentVersion}`);
-            }
             directBumps.set(workspace.dir, { releaseType: 'patch', newVersionOverride: setVersion });
             directResults.set(workspace.dir, {
                 workspace,
@@ -199,7 +182,7 @@ function determineDirectBumps(config, options) {
             bumpOverride,
         });
     }
-    return { directBumps, directResults, skippedResults, currentVersions };
+    return { directBumps, directResults, skippedResults };
 }
 function collectSkippedWorkspaces(skippedResults, fullReleaseSet) {
     const workspaces = [];

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

@@ -5,9 +5,11 @@ import type { LabelDefinition } from './types.js';
  *
  * Resolution is an ordered fold with last-writer-wins: presets are loaded in `extends` order (a later preset replaces
  * an earlier preset's label of the same name), then the `labels` record is applied: An entry adds a label, replaces
- * one an earlier layer defined, or removes it (`null`). Replacement is wholesale, so an entry omitting `description`
+ * one an earlier layer defined, or removes it (`null`). Names match case-insensitively, as GitHub matches them, and the
+ * replacing layer's spelling becomes the label's name. Replacement is wholesale, so an entry omitting `description`
  * drops the one an earlier layer supplied rather than inheriting it.
- * Throws only on a dangling `null`: a removal naming a label no preset defined, which is a stale reference that
- * would otherwise produce no output diff to review.
+ * Throws on two misstatements that would otherwise leave no trace in the output diff: keys in the `labels` record that
+ * differ only in case, all but one of which the fold would discard, and a dangling `null`, a removal naming a label that
+ * no preset defined.
  */
 export declare function resolveLabels(config: RepoLabelsConfig): LabelDefinition[];

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

@@ -1,22 +1,28 @@
 import { loadPreset } from "./presets.js";
 export function resolveLabels(config) {
+    const labelEntries = Object.entries(config.labels ?? {});
+    const caseVariantGroups = findCaseVariantGroups(labelEntries.map(([name]) => name));
+    if (caseVariantGroups.length > 0) {
+        const groupList = caseVariantGroups.map((group) => group.map((name) => `'${name}'`).join(' and ')).join('; ');
+        throw new Error(`Keys in 'labels' differ only in case, which GitHub treats as the same label: ${groupList}. Keep one entry per label.`);
+    }
     const resolved = new Map();
     const presetNames = config.extends ?? [];
     for (const presetName of presetNames) {
         for (const label of loadPreset(presetName)) {
-            resolved.set(label.name, label);
+            resolved.set(toLabelKey(label.name), label);
         }
     }
-    const labelEntries = Object.entries(config.labels ?? {});
     for (const [name, spec] of labelEntries) {
+        const key = toLabelKey(name);
         if (spec === null) {
-            if (!resolved.has(name)) {
+            if (!resolved.has(key)) {
                 throw new Error(`Label '${name}' is set to null (remove), but no preset in 'extends' defines it. Fix the name or delete the entry.`);
             }
-            resolved.delete(name);
+            resolved.delete(key);
         }
         else {
-            resolved.set(name, {
+            resolved.set(key, {
                 name,
                 color: spec.color,
                 ...(spec.description !== undefined && { description: spec.description }),
@@ -25,6 +31,15 @@ export function resolveLabels(config) {
     }
     return sortLabels(resolved.values().toArray());
 }
+function findCaseVariantGroups(names) {
+    return Map.groupBy(names, toLabelKey)
+        .values()
+        .filter((group) => group.length > 1)
+        .toArray();
+}
 function sortLabels(labels) {
-    return [...labels].sort((a, b) => a.name.localeCompare(b.name));
+    return labels.toSorted((a, b) => a.name.localeCompare(b.name));
+}
+function toLabelKey(name) {
+    return name.toLowerCase();
 }

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;
@@ -388,8 +389,10 @@ export type LabelSpec = z.infer<typeof labelSpecSchema>;
  * the GitHub repo, distinct from labels applied to PRs and issues).
  *
  * Resolution is an ordered fold with last-writer-wins: presets in `extends` order, then the `labels` record,
- * where an entry adds a label, replaces one an earlier layer defined, or removes it (`null`).
- * A `null` naming a label no earlier layer defined is a resolve-time error (`resolveLabels`), not a schema error.
+ * where an entry adds a label, replaces one an earlier layer defined, or removes it (`null`). Names match
+ * case-insensitively, as GitHub matches them, and the replacing layer's spelling wins.
+ * Two misstatements are resolve-time errors (`resolveLabels`), not schema errors: `labels` keys that differ only in
+ * case, and a `null` naming a label that no earlier layer defined.
  */
 export declare const repoLabelsSchema: z.ZodObject<{
     extends: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/dist/esm/validateConfig.js

@@ -31,7 +31,7 @@ function preprocessDeprecatedKeys(raw) {
     const errors = [];
     const cleaned = { ...raw };
     if (isRecord(cleaned['releaseNotes']) && Object.hasOwn(cleaned['releaseNotes'], 'shouldCreateGithubRelease')) {
-        errors.push('releaseNotes.shouldCreateGithubRelease is no longer supported. Adoption is now signaled by installing the create-github-release workflow. Remove this field from your config; see README for the updated workflow.');
+        errors.push('releaseNotes.shouldCreateGithubRelease is no longer supported. Adoption is now signaled by installing the create-github-release workflow, which `release-kit init` scaffolds. Remove this field from your config.');
         const releaseNotesCopy = { ...cleaned['releaseNotes'] };
         delete releaseNotesCopy['shouldCreateGithubRelease'];
         cleaned['releaseNotes'] = releaseNotesCopy;