@williamthorsen/release-kit 8.0.1 → 9.0.0

package/CHANGELOG.md

@@ -2,6 +2,34 @@
 
 All notable changes to this project will be documented in this file.
 
+## 9.0.0 — 2026-07-28
+
+### 🎉 Features
+
+- 🚨 **Breaking:** Unify label configuration in release-kit.config.ts (#505)
+
+  Repositories now declare their label set alongside the rest of their release-kit configuration in `.config/release-kit.config.ts`, and the declaration is validated and completed in the editor as it is written. A label supplied by a bundled preset can now be recolored, reworded, or dropped. `sync-labels generate --check` now reports when the committed label file has fallen behind the declaration, writing nothing. The standalone `.config/sync-labels.config.ts` is no longer read; while it remains in place, every `sync-labels` command refuses to run, naming what to move and where.
+
+### 🐛 Bug fixes
+
+- Include commits scoped to `*` in the changelog (#496)
+
+  Fixes an issue where commits scoped to `*` raised the version but were silently dropped from the generated changelog.
+
+## 8.1.0 — 2026-07-22
+
+### 🎉 Features
+
+- Make label deletions reviewable and apply labels on merge (#493)
+
+  Pull requests that touch a repository's label file now get a check listing every label change the sync would make, including deletions of labels the file never mentions, which a diff of the file cannot show. Merging the pull request now applies those labels. The sync's deletion and rename handling now changes only through a reviewed upgrade to a verified release. Repositories that already scaffolded this workflow adopt the new triggers by re-running `release-kit sync-labels init --force`.
+
+### 📦 Dependencies
+
+- Upgrade dependencies and align the Node support policy (#483)
+
+  All four published packages (`nmr`, `nmr-core`, `release-kit`, and `v11y-check`) now require Node.js 24 or later, up from Node 18.17. Separately, `nmr-compile` now rebuilds when the TypeScript version changes.
+
 ## 8.0.1 — 2026-07-18
 
 ### 🐛 Bug fixes
@@ -32,12 +60,24 @@ All notable changes to this project will be documented in this file.
 
 ### 🎉 Features
 
+- 🚨 **Breaking:** Rewrite parseArgs on node:util with typed error and exit API (#428)
+
+  `@williamthorsen/nmr-core` gains a typed error API for CLI parsing: `parseArgsOrExit` (parse, or print a usage error and exit) and `ParseError` replace the per-command boilerplate, so every bundled CLI reports a flag mistake the same way. Breaking: the `translateParseError` export is removed and `parseArgs` now throws `ParseError`.
+
 - 🚨 **Breaking:** Auto-activate integration test variant from config presence (#448)
 
   A package can now separate its integration tests from its standalone suite simply by including a `vitest.integration.config.ts` (alongside a `vitest.standalone.config.ts`). The `--int-test` flag that previously enabled this is removed — that config-file pairing is now the only way to activate the separation. In such a package, `test` and `test:coverage` run only the standalone suite and skip integration tests, while a new `test:all` runs both suites together. The separation now holds even when tests run across every package at once, so a full-workspace `test` run still keeps integration tests out of the default suite. Packages that previously hand-copied these test scripts no longer need to.
 
 ### ♻️ Refactoring
 
+- Route all CLI error reporting through a single stderr helper (#437)
+
+  Consolidates error reporting across the CLIs so every command reports errors the same way, and guards against the previous inconsistency returning. The error messages and exit codes users see are unchanged.
+
+- Normalize CLI error wording to the canonical Error: format (#439)
+
+  Single-line error messages from the `nmr` and `release-kit` commands now print in one uniform shape, so the same class of failure reads the same way no matter which command produced it. Previously the wording varied, which made error output harder to scan and harder for scripts to match against. Richer output, such as multi-line validation reports and the stack trace from an unexpected crash, is unchanged.
+
 - Consolidate prepare parsing onto parseArgsOrExit (#441)
 
   Makes `release-kit`'s `prepare` command report invalid arguments the same way its other commands already do. The error message and exit code a user sees for a bad argument are unchanged.

package/README.md

@@ -5,17 +5,25 @@ Version-bumping and changelog-generation toolkit for release workflows.
 Provides a self-contained CLI that auto-discovers workspaces from `pnpm-workspace.yaml`, parses conventional commits, determines version bumps, updates `package.json` files, and generates changelogs from `git-cliff --context` output rendered in-process (with optional [editorial overrides](#editorial-overrides)).
 
 <!-- section:release-notes -->
-## Release notes — v8.0.1 (2026-07-18)
+## Release notes — v9.0.0 (2026-07-28)
+
+### 🎉 Features
+
+- 🚨 **Breaking:** Unify label configuration in release-kit.config.ts (#505)
+
+  Repositories now declare their label set alongside the rest of their release-kit configuration in `.config/release-kit.config.ts`, and the declaration is validated and completed in the editor as it is written. A label supplied by a bundled preset can now be recolored, reworded, or dropped. `sync-labels generate --check` now reports when the committed label file has fallen behind the declaration, writing nothing. The standalone `.config/sync-labels.config.ts` is no longer read; while it remains in place, every `sync-labels` command refuses to run, naming what to move and where.
 
 ### 🐛 Bug fixes
 
-- Skip private packages cleanly in publish and create-github-release (#477)
+- Include commits scoped to `*` in the changelog (#496)
 
-  Fixes an issue where a workspace marked private in its `package.json` could break a release: `release-kit publish` failed on it, and `release-kit create-github-release` created an unwanted public GitHub Release for it. Both commands now skip private workspaces cleanly: publish reports the skip and continues instead of failing the run, and create-github-release produces no Release for a private package. Any publishable packages released alongside it still publish and still get their Releases. Marking a workspace private is now all it takes to exclude it from both publishing and GitHub Releases.
+  Fixes an issue where commits scoped to `*` raised the version but were silently dropped from the generated changelog.
 <!-- /section:release-notes -->
 
 ## Installation
 
+Requires Node.js 24 or later.
+
 ```bash
 pnpm add -D @williamthorsen/release-kit
 ```
@@ -92,9 +100,9 @@ Configuration is optional. The CLI works out of the box by auto-discovering work
 ### Config file
 
 ```typescript
-import type { ReleaseKitConfig } from '@williamthorsen/release-kit';
+import { defineConfig } from '@williamthorsen/release-kit';
 
-const config: ReleaseKitConfig = {
+export default defineConfig({
   // Exclude a workspace from release processing
   workspaces: [{ dir: 'internal-tools', shouldExclude: true }],
 
@@ -106,12 +114,10 @@ const config: ReleaseKitConfig = {
 
   // Add or override work types (merged with defaults by key)
   workTypes: { perf: { header: 'Performance' } },
-};
-
-export default config;
+});
 ```
 
-The config file supports both `export default config` and `export const config = { ... }`.
+`defineConfig` is a type-safe identity function: it gives the config object validation and completion in `.ts` files and full inference in `.js` ones. The loader also accepts a plain `export default config` or `export const config = { ... }`.
 
 ### `ReleaseKitConfig` reference
 
@@ -126,6 +132,7 @@ The config file supports both `export default config` and `export const config =
 | `breakingPolicies` | `Record<string, 'forbidden' \| 'optional' \| 'required'>` | Per-type `!`-policy lookup. Defaults to `DEFAULT_BREAKING_POLICIES`. Replaces the default entirely when provided. Set to `{}` to disable enforcement |
 | `retiredPackages`  | `RetiredPackage[]`                                        | Packages that once lived in this repo but have been extracted or removed; suppresses undeclared-tag-prefix warnings                                  |
 | `project`          | `ProjectConfig`                                           | Opt-in project-level release block. Declaring `project: {}` (even empty) enables a project-release stage in `prepare`                                |
+| `repoLabels`       | `RepoLabelsConfig`                                        | Declares the repository's label registry for `sync-labels`; see [Label configuration](#label-configuration)                                          |
 
 All fields are optional.
 
@@ -161,13 +168,11 @@ interface RetiredPackage {
 Worked example — `preflight` was extracted from this monorepo and continues as the standalone `readyup` project. Its tags stay in this repo as historical anchors:
 
 ```typescript
-import type { ReleaseKitConfig } from '@williamthorsen/release-kit';
+import { defineConfig } from '@williamthorsen/release-kit';
 
-const config: ReleaseKitConfig = {
+export default defineConfig({
   retiredPackages: [{ name: '@scope/preflight', tagPrefix: 'preflight-v', successor: 'readyup' }],
-};
-
-export default config;
+});
 ```
 
 Validation rules:
@@ -718,15 +723,85 @@ The token needs `contents: read` on the codeassembly repo (fine-grained PAT scop
 
 ### `release-kit sync-labels`
 
-Manage GitHub label definitions via config-driven YAML files.
+Manage GitHub label definitions via the `repoLabels` block of `.config/release-kit.config.ts`.
 
 | Subcommand | Description                                                    | Flags                  |
 | ---------- | -------------------------------------------------------------- | ---------------------- |
-| `init`     | Scaffold config, caller workflow, and generate labels          | `--dry-run`, `--force` |
-| `generate` | Regenerate `.github/labels.yaml` from config                   | —                      |
+| `init`     | Scaffold the caller workflow, seed config, and generate labels | `--dry-run`, `--force` |
+| `generate` | Regenerate `.github/labels.yaml` from config                   | `--check`              |
 | `sync`     | Trigger the `sync-labels` GitHub Actions workflow via `gh` CLI | —                      |
 
-`init` scaffolds `.config/sync-labels.config.ts` with auto-detected workspace scope labels and a `.github/workflows/sync-labels.yaml` caller workflow, then generates `.github/labels.yaml`. `generate` reads the config and writes `.github/labels.yaml`. `sync` triggers the workflow remotely — it requires the `gh` CLI and an existing workflow file.
+`init` scaffolds the `.github/workflows/sync-labels.yaml` caller workflow and seeds a `repoLabels` block with scope labels discovered from workspaces and declared `retiredPackages`. When `.config/release-kit.config.ts` does not exist, `init` writes it; when it does, `init` prints the block for manual paste — a hand-authored config is never rewritten. `generate` resolves the block and writes `.github/labels.yaml`; with `--check` it regenerates in memory and exits non-zero if the committed file is stale or missing, writing nothing. `sync` triggers the workflow remotely — it requires the `gh` CLI and an existing workflow file.
+
+Every `sync-labels` subcommand refuses to run while the retired `.config/sync-labels.config.ts` is present, so custom labels cannot be silently dropped mid-migration; see [Migrating from `.config/sync-labels.config.ts`](#migrating-from-configsync-labelsconfigts).
+
+#### Label configuration
+
+```typescript
+import { defineConfig } from '@williamthorsen/release-kit';
+
+export default defineConfig({
+  repoLabels: {
+    extends: ['common'],
+    labels: {
+      'scope:my-package': { color: '00ff96', description: 'my-package package' }, // add
+      bug: { color: 'b60205', description: 'Something broken' }, // replace the preset's `bug`
+      wontfix: null, // remove the preset's `wontfix`
+    },
+  },
+});
+```
+
+The block declares the repository's label registry — the set of labels defined on the GitHub repo, distinct from labels applied to PRs and issues. Resolution is an ordered fold with last-writer-wins:
+
+1. Presets, in `extends` order — a later preset wins on a shared name.
+2. The `labels` record — an entry adds a label, replaces one an earlier layer defined, or removes it (`null`). A replacing entry supplies the full `{ color, description }`.
+
+Overlaps are never errors; order resolves them, and the committed `.github/labels.yaml` diff is where an unexpected change surfaces at review. The one config error is a dangling `null` — removing a name no preset defines — because that misstatement is invisible in the output diff.
+
+#### Migrating from `.config/sync-labels.config.ts`
+
+Label configuration formerly lived in a standalone `.config/sync-labels.config.ts` (`presets` + a `labels` array). To migrate:
+
+1. Move the preset list to `repoLabels.extends` in `.config/release-kit.config.ts`.
+2. Convert each `labels` array entry to a `'name': { color, description }` record entry under `repoLabels.labels`.
+3. Delete `.config/sync-labels.config.ts` and run `release-kit sync-labels generate`.
+
+The regenerated `.github/labels.yaml` differs only in its `# Source:` header line. Name collisions with preset labels, which the old format rejected, now mean your entry replaces the preset label.
+
+#### When labels are applied
+
+The scaffolded workflow carries three triggers:
+
+| Trigger                                                   | Job     | Token           | Effect                            |
+| --------------------------------------------------------- | ------- | --------------- | --------------------------------- |
+| Push to the default branch touching `.github/labels.yaml` | `sync`  | `issues: write` | Applies the labels                |
+| Manual dispatch (`release-kit sync-labels sync`)          | `sync`  | `issues: write` | Applies the labels                |
+| Pull request touching `.github/labels.yaml`               | `check` | `issues: read`  | Logs the diff without applying it |
+
+Applying on merge closes the window in which a regenerated `.github/labels.yaml` sits unapplied — a window in which a later manual dispatch would apply a label set nobody reviewed.
+
+The `check` job runs the same sync in dry-run. Its **Label diff** log group lists every create, edit, rename, and deletion the sync would perform, including deletions of labels the file does not declare — the destructive edits a diff of `.github/labels.yaml` alone cannot show, because a label created by hand or by another workflow is absent from the file both before and after. Read that log; the check reports success whether or not the diff is destructive, so a green check is not evidence that nothing will be deleted.
+
+The two jobs are split because a job's permissions are fixed when the run is created and cannot vary by trigger. The split is what keeps a write-scoped token out of pull-request runs.
+
+The push trigger filters on the path alone; the `sync` job compares `github.ref_name` against the repository's default branch. The workflow therefore needs no per-repo edit whatever that branch is named — and a push touching `.github/labels.yaml` on any other branch produces a run whose jobs all skip.
+
+Manual dispatch is not a preview. It matches the `sync` job, so it applies the labels, deletions included; only the pull-request path runs in dry-run.
+
+#### Dry-run checks on fork pull requests
+
+GitHub issues a read-only `GITHUB_TOKEN` to pull requests from forks, and by default holds runs from first-time contributors until a maintainer approves them. The dry-run reads labels and writes nothing, so the check normally runs once approved. A repo that disables workflows on fork pull requests gets no check at all; to preview such a change, push the branch to the base repo and open the pull request from there.
+
+#### Migrating an existing repo
+
+The caller workflow gained the `push` and `pull_request` triggers after its first release. A repo scaffolded before that keeps working on manual dispatch alone — nothing breaks — but it applies labels only when someone remembers to. To adopt the new shape:
+
+```sh
+pnpm exec release-kit sync-labels init --force
+```
+
+`readyup` prompts for this: its `sync-labels.yaml matches template` check fails once the scaffolded workflow no longer matches the current template.
 
 #### Published JSON Schema for `.meta/label-map.json`
 

package/cliff.toml.template

@@ -33,26 +33,26 @@ commit_preprocessors = []
 commit_parsers = [
   { message = "^release:", skip = true },
   { message = "^Merge", skip = true },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?feat(!)?:", group = "<!-- 01 -->🎉 Features" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?feature(!)?:", group = "<!-- 01 -->🎉 Features" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?drop(!)?:", group = "<!-- 02 -->🪦 Removed" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?deprecate(!)?:", group = "<!-- 03 -->🗑️ Deprecated" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?fix(!)?:", group = "<!-- 04 -->🐛 Bug fixes" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?bugfix(!)?:", group = "<!-- 04 -->🐛 Bug fixes" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?sec(!)?:", group = "<!-- 05 -->🔒 Security" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?security(!)?:", group = "<!-- 05 -->🔒 Security" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?perf(!)?:", group = "<!-- 06 -->⚡ Performance" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?performance(!)?:", group = "<!-- 06 -->⚡ Performance" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?internal(!)?:", group = "<!-- 07 -->🏗️ Internal features" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?utility(!)?:", group = "<!-- 07 -->🏗️ Internal features" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?refactor(!)?:", group = "<!-- 08 -->♻️ Refactoring" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?tests?(!)?:", group = "<!-- 09 -->🧪 Tests" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?tooling(!)?:", group = "<!-- 10 -->⚙️ Tooling" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?ci(!)?:", group = "<!-- 11 -->👷 CI" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?deps?(!)?:", group = "<!-- 12 -->📦 Dependencies" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?ai(!)?:", group = "<!-- 13 -->🤖 Agentic support" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?docs?(!)?:", group = "<!-- 14 -->📚 Documentation" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?fmt(!)?:", skip = true },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([^|]+\\|)?feat(!)?:", group = "<!-- 01 -->🎉 Features" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([^|]+\\|)?feature(!)?:", group = "<!-- 01 -->🎉 Features" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([^|]+\\|)?drop(!)?:", group = "<!-- 02 -->🪦 Removed" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([^|]+\\|)?deprecate(!)?:", group = "<!-- 03 -->🗑️ Deprecated" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([^|]+\\|)?fix(!)?:", group = "<!-- 04 -->🐛 Bug fixes" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([^|]+\\|)?bugfix(!)?:", group = "<!-- 04 -->🐛 Bug fixes" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([^|]+\\|)?sec(!)?:", group = "<!-- 05 -->🔒 Security" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([^|]+\\|)?security(!)?:", group = "<!-- 05 -->🔒 Security" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([^|]+\\|)?perf(!)?:", group = "<!-- 06 -->⚡ Performance" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([^|]+\\|)?performance(!)?:", group = "<!-- 06 -->⚡ Performance" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([^|]+\\|)?internal(!)?:", group = "<!-- 07 -->🏗️ Internal features" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([^|]+\\|)?utility(!)?:", group = "<!-- 07 -->🏗️ Internal features" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([^|]+\\|)?refactor(!)?:", group = "<!-- 08 -->♻️ Refactoring" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([^|]+\\|)?tests?(!)?:", group = "<!-- 09 -->🧪 Tests" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([^|]+\\|)?tooling(!)?:", group = "<!-- 10 -->⚙️ Tooling" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([^|]+\\|)?ci(!)?:", group = "<!-- 11 -->👷 CI" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([^|]+\\|)?deps?(!)?:", group = "<!-- 12 -->📦 Dependencies" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([^|]+\\|)?ai(!)?:", group = "<!-- 13 -->🤖 Agentic support" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([^|]+\\|)?docs?(!)?:", group = "<!-- 14 -->📚 Documentation" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([^|]+\\|)?fmt(!)?:", skip = true },
   # Skip unticketed commits (maintenance, deps, initial scaffolding, etc.)
   { message = ".*", skip = true },
 ]

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

@@ -57,8 +57,10 @@ function showSyncLabelsInitHelp() {
     console.info(`
 Usage: release-kit sync-labels init [options]
 
-Scaffold the sync-labels caller workflow and config file, auto-discover workspaces
-for scope labels, then generate .github/labels.yaml.
+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.
 
 Options:
   --dry-run     Preview changes without writing files
@@ -68,11 +70,12 @@ Options:
 }
 function showSyncLabelsGenerateHelp() {
     console.info(`
-Usage: release-kit sync-labels generate
+Usage: release-kit sync-labels generate [options]
 
-Regenerate .github/labels.yaml from .config/sync-labels.config.ts.
+Regenerate .github/labels.yaml from the repoLabels block of .config/release-kit.config.ts.
 
 Options:
+  --check       Report whether .github/labels.yaml is stale instead of writing it
   --help, -h    Show this help message
 `);
 }
@@ -369,11 +372,11 @@ if (command === 'sync-labels') {
             showSyncLabelsGenerateHelp();
             process.exit(0);
         }
-        if (subflags.length > 0) {
-            reportError(`Unknown option: ${subflags[0]}`);
-            process.exit(1);
-        }
-        const exitCode = await generateCommand();
+        const generateFlagSchema = {
+            check: { long: '--check', type: 'boolean' },
+        };
+        const { check } = parseArgsOrExit(subflags, generateFlagSchema).flags;
+        const exitCode = await generateCommand({ check });
         process.exit(exitCode);
     }
     if (subcommand === 'sync') {

package/dist/esm/buildChangelogEntries.js

@@ -1,6 +1,6 @@
 import { extractVersion } from "./changelogJsonUtils.js";
 import { DEFAULT_WORK_TYPES } from "./defaults.js";
-import { COMMIT_PREPROCESSOR_PATTERNS } from "./parseCommitMessage.js";
+import { COMMIT_PREPROCESSOR_PATTERNS, PIPE_SCOPE_SOURCE } from "./parseCommitMessage.js";
 import { resolveCliffConfigPath } from "./resolveCliffConfigPath.js";
 import { runGitCliff } from "./runGitCliff.js";
 import { stripEmojiPrefix } from "./stripEmojiPrefix.js";
@@ -9,7 +9,7 @@ const HTML_COMMENT_PREFIX_PATTERN = /^<!--[^>]*-->/;
 const CANONICAL_SECTION_ORDER = new Map(Object.values(DEFAULT_WORK_TYPES).map((config, index) => [stripGroupDecorations(config.header), index]));
 function canonicalSectionPriority(title) {
     const index = CANONICAL_SECTION_ORDER.get(stripGroupDecorations(title));
-    return index ?? Number.POSITIVE_INFINITY;
+    return index ?? Infinity;
 }
 export function stripGroupDecorations(group) {
     return stripEmojiPrefix(group.replace(HTML_COMMENT_PREFIX_PATTERN, ''));
@@ -124,15 +124,16 @@ function transformReleases(releases, devOnlySections) {
 function stripCommentPrefix(group) {
     return group.replace(HTML_COMMENT_PREFIX_PATTERN, '');
 }
+const SUBJECT_BREAKING_MARKER_PATTERN = new RegExp(String.raw `^(?:${PIPE_SCOPE_SOURCE}\|)?\w+(?:\([^)]+\))?!:`);
 function subjectHasBreakingMarker(message) {
     let subject = message.split('\n', 1)[0] ?? '';
     for (const pattern of COMMIT_PREPROCESSOR_PATTERNS) {
         subject = subject.replace(pattern, '');
     }
-    return /^(?:[^|]+\|)?\w+(?:\([^)]+\))?!:/.test(subject);
+    return SUBJECT_BREAKING_MARKER_PATTERN.test(subject);
 }
 function extractDescription(message) {
-    const firstLine = message.split('\n')[0] ?? message;
+    const firstLine = message.split('\n', 1)[0] ?? message;
     const afterColon = firstLine.split(': ').slice(1).join(': ');
     if (afterColon.length > 0) {
         return afterColon.charAt(0).toUpperCase() + afterColon.slice(1);

package/dist/esm/changelogOverrides.js

@@ -59,10 +59,11 @@ function validateSingleOverride(key, rawEntry, errors) {
     }
     let entryValid = true;
     for (const fieldName of Object.keys(rawEntry)) {
-        if (!KNOWN_OVERRIDE_FIELDS.has(fieldName)) {
-            errors.push(`overrides['${key}']: unknown field '${fieldName}'`);
-            entryValid = false;
+        if (KNOWN_OVERRIDE_FIELDS.has(fieldName)) {
+            continue;
         }
+        errors.push(`overrides['${key}']: unknown field '${fieldName}'`);
+        entryValid = false;
     }
     const result = {};
     if (rawEntry.audience !== undefined) {

package/dist/esm/createGithubRelease.js

@@ -26,7 +26,7 @@ export function createGithubRelease(options) {
     const body = renderReleaseNotesSingle(entry, {
         filter: matchesAudience('all'),
         includeHeading: false,
-        ...(sectionOrder === undefined ? {} : { sectionOrder }),
+        ...(sectionOrder !== undefined && { sectionOrder }),
     });
     if (body.trim() === '') {
         return { status: 'skipped', reason: 'empty-body' };
@@ -48,7 +48,7 @@ export function createGithubReleases(tags, changelogJsonOutputPath, dryRun, sect
             tag,
             changelogJsonPath,
             dryRun,
-            ...(sectionOrder === undefined ? {} : { sectionOrder }),
+            ...(sectionOrder !== undefined && { sectionOrder }),
         });
         if (result.status === 'created') {
             created.push(tag);

package/dist/esm/defineConfig.d.ts

@@ -0,0 +1,2 @@
+import type { ReleaseKitConfig } from './types.js';
+export declare function defineConfig(config: ReleaseKitConfig): ReleaseKitConfig;

package/dist/esm/defineConfig.js

@@ -0,0 +1,3 @@
+export function defineConfig(config) {
+    return config;
+}

package/dist/esm/detectPackageManager.js

@@ -7,7 +7,7 @@ export function detectPackageManager() {
         const content = readFileSync(packageJsonPath, 'utf8');
         const parsed = JSON.parse(content);
         if (isRecord(parsed) && typeof parsed.packageManager === 'string') {
-            const [name, version] = parsed.packageManager.split('@');
+            const [name, version] = parsed.packageManager.split('@', 2);
             if (name === 'pnpm' || name === 'npm') {
                 return name;
             }

package/dist/esm/format.js

@@ -1,8 +1,8 @@
 export function bold(text) {
-    return `\u001B[1m${text}\u001B[0m`;
+    return `\u{1B}[1m${text}\u{1B}[0m`;
 }
 export function dim(text) {
-    return `\u001B[2m${text}\u001B[0m`;
+    return `\u{1B}[2m${text}\u{1B}[0m`;
 }
 export function sectionHeader(name) {
     return `━━━ ${name} ━━━`;

package/dist/esm/getCommitsSinceTarget.js

@@ -1,5 +1,5 @@
 import { execFileSync } from 'node:child_process';
-const FIELD_SEPARATOR = '\u001F';
+const FIELD_SEPARATOR = '\u{1F}';
 function isNoTagError(err) {
     return typeof err === 'object' && err !== null && 'status' in err && err.status === 128;
 }

package/dist/esm/index.d.ts

@@ -1,4 +1,4 @@
 export { type ChangelogOverrideScope, validateAllChangelogOverrides, type ValidateAllChangelogOverridesInputs, type ValidateAllChangelogOverridesResult, } from './changelogOverrides.js';
-export type { SyncLabelsConfig } from './sync-labels/types.js';
-export type { ReleaseKitConfig } from './types.js';
+export { defineConfig } from './defineConfig.js';
+export type { LabelSpec, ReleaseKitConfig, RepoLabelsConfig } from './types.js';
 export { formatValidateOverridesResult, type ValidateOverridesCommandResult } from './validateOverridesCommand.js';

package/dist/esm/index.js

@@ -1,2 +1,3 @@
 export { validateAllChangelogOverrides, } from "./changelogOverrides.js";
+export { defineConfig } from "./defineConfig.js";
 export { formatValidateOverridesResult } from "./validateOverridesCommand.js";

package/dist/esm/init/templates.js

@@ -1,8 +1,8 @@
 export function releaseConfigScript(repoType) {
     if (repoType === 'monorepo') {
-        return `import type { ReleaseKitConfig } from '@williamthorsen/release-kit';
+        return `import { defineConfig } from '@williamthorsen/release-kit';
 
-const config: ReleaseKitConfig = {
+export default defineConfig({
   releaseNotes: {
     shouldInjectIntoReadme: true,
   },
@@ -19,14 +19,12 @@ const config: ReleaseKitConfig = {
 
   // Uncomment to add custom work types (merged with defaults):
   // workTypes: { perf: { header: 'Performance' } },
-};
-
-export default config;
+});
 `;
     }
-    return `import type { ReleaseKitConfig } from '@williamthorsen/release-kit';
+    return `import { defineConfig } from '@williamthorsen/release-kit';
 
-const config: ReleaseKitConfig = {
+export default defineConfig({
   releaseNotes: {
     shouldInjectIntoReadme: true,
   },
@@ -38,9 +36,7 @@ const config: ReleaseKitConfig = {
 
   // Uncomment to add custom work types (merged with defaults):
   // workTypes: { perf: { header: 'Performance' } },
-};
-
-export default config;
+});
 `;
 }
 export function publishWorkflow(repoType) {

package/dist/esm/injectReleaseNotesIntoReadme.js

@@ -22,7 +22,7 @@ export function renderInjectedReadme(readme, changelogJsonPath, tag, sectionOrde
     const renderedSections = renderReleaseNotesSingle(entry, {
         filter: matchesAudience('all'),
         includeHeading: false,
-        ...(sectionOrder === undefined ? {} : { sectionOrder }),
+        ...(sectionOrder !== undefined && { sectionOrder }),
     });
     if (renderedSections.trimEnd().length === 0) {
         console.warn(`Warning: no user-facing release notes for version ${version}; skipping README injection`);

package/dist/esm/loadValidatedConfig.d.ts

@@ -0,0 +1,10 @@
+import type { ReleaseKitConfig } from './types.js';
+export type LoadValidatedConfigResult = {
+    status: 'invalid';
+} | {
+    status: 'missing';
+} | {
+    status: 'ok';
+    config: ReleaseKitConfig;
+};
+export declare function loadValidatedConfig(): Promise<LoadValidatedConfigResult>;

package/dist/esm/loadValidatedConfig.js

@@ -0,0 +1,26 @@
+import { reportError } from '@williamthorsen/nmr-core';
+import { loadConfig } from "./loadConfig.js";
+import { validateConfig } from "./validateConfig.js";
+export async function loadValidatedConfig() {
+    let raw;
+    try {
+        raw = await loadConfig();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        reportError(`Failed to load config: ${message}`);
+        return { status: 'invalid' };
+    }
+    if (raw === undefined) {
+        return { status: 'missing' };
+    }
+    const { config, errors } = validateConfig(raw);
+    if (errors.length > 0) {
+        process.stderr.write('Invalid config:\n');
+        for (const err of errors) {
+            process.stderr.write(`  ❌ ${err}\n`);
+        }
+        return { status: 'invalid' };
+    }
+    return { status: 'ok', config };
+}

package/dist/esm/parseCommitMessage.d.ts

@@ -1,5 +1,6 @@
 import type { Commit, ParsedCommit, WorkTypeConfig } from './types.js';
 export declare const COMMIT_PREPROCESSOR_PATTERNS: readonly RegExp[];
+export declare const PIPE_SCOPE_SOURCE = "[^|]+";
 export type PolicyViolationSurface = 'prefix' | 'body';
 export type PolicyViolationHandler = (commit: Commit, type: string, surface: PolicyViolationSurface) => void;
 export interface ParseCommitMessageOptions {

package/dist/esm/parseCommitMessage.js

@@ -1,8 +1,10 @@
 export const COMMIT_PREPROCESSOR_PATTERNS = [/^##\s+/, /^#\d+([.-]\d+)?\s+/, /^[A-Z]+-\d+\s+/];
+export const PIPE_SCOPE_SOURCE = '[^|]+';
+const COMMIT_SUBJECT_PATTERN = new RegExp(String.raw `^(?:(${PIPE_SCOPE_SOURCE})\|)?(\w+)(?:\(([^)]+)\))?(!)?:\s*(.*)$`);
 export function parseCommitMessage(message, hash, workTypes, scopeAliases, options) {
     const firstLine = message.split('\n', 1)[0] ?? '';
     const stripped = stripTicketPrefix(firstLine);
-    const match = stripped.match(/^(?:([^|]+)\|)?(\w+)(?:\(([^)]+)\))?(!)?:\s*(.*)$/);
+    const match = stripped.match(COMMIT_SUBJECT_PATTERN);
     if (!match) {
         return undefined;
     }

package/dist/esm/prepareCommand.js

@@ -85,9 +85,9 @@ export async function prepareCommand(argv) {
     const options = {
         dryRun,
         force,
-        ...(bumpOverride === undefined ? {} : { bumpOverride }),
-        ...(setVersion === undefined ? {} : { setVersion }),
-        ...(withReleaseNotes ? { withReleaseNotes: true } : {}),
+        ...(bumpOverride !== undefined && { bumpOverride }),
+        ...(setVersion !== undefined && { setVersion }),
+        ...(withReleaseNotes && { withReleaseNotes: true }),
     };
     if (dryRun) {
         console.info('\n🔍 DRY RUN — no files will be modified\n');
@@ -155,10 +155,11 @@ function runMonorepoMode(discoveredPaths, userConfig, options, only, setVersion,
     if (only !== undefined) {
         const knownNames = config.workspaces.map((w) => w.dir);
         for (const name of only) {
-            if (!knownNames.includes(name)) {
-                reportError(`Unknown workspace "${name}". Known workspaces: ${knownNames.join(', ')}`);
-                process.exit(1);
+            if (knownNames.includes(name)) {
+                continue;
             }
+            reportError(`Unknown workspace "${name}". Known workspaces: ${knownNames.join(', ')}`);
+            process.exit(1);
         }
         const graph = buildDependencyGraph(config.workspaces);
         const violations = validateOnlyExcludesStrandedDependents(config.workspaces, only, graph, (workspace) => {

package/dist/esm/previewTagPrefixes.js

@@ -9,10 +9,7 @@ export async function previewTagPrefixes() {
     const workspacePaths = (await discoverWorkspaces()) ?? [];
     const userConfig = await loadUserConfig();
     const overridesByDir = buildOverrideMap(userConfig);
-    const workspaces = [];
-    for (const workspacePath of workspacePaths) {
-        workspaces.push(buildPreviewRow(workspacePath, overridesByDir));
-    }
+    const workspaces = Array.from(workspacePaths, (workspacePath) => buildPreviewRow(workspacePath, overridesByDir));
     const retiredPackages = buildRetiredPreviewEntries(userConfig?.retiredPackages ?? []);
     const collisions = detectCollisions(workspaces);
     const knownPrefixes = collectKnownPrefixes(workspaces, retiredPackages);
@@ -120,6 +117,6 @@ function buildRetiredPreviewEntries(retiredPackages) {
         name: retired.name,
         tagPrefix: retired.tagPrefix,
         tagCount: countTagsMatching(retired.tagPrefix),
-        ...(retired.successor !== undefined ? { successor: retired.successor } : {}),
+        ...(retired.successor !== undefined && { successor: retired.successor }),
     }));
 }