@williamthorsen/release-kit 8.1.0 → 9.0.1

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 All notable changes to this project will be documented in this file.
 
+## 9.0.1 — 2026-07-30
+
+### ⚙️ Tooling
+
+- Adopt Vitest projects in this repo (#530)
+
+  Simplifies test configurations so that every package exposes the same test commands, which select suites by test category: `nmr test` runs everything except integration tests, `nmr test:integration` runs only those, and `nmr test:all` runs both. `nmr test:integration` now succeeds in a package that has no integration tests instead of failing. release-kit's drift checks can now be run on their own, apart from unit and integration tests. A fresh clone now has to run `pnpm run bootstrap` before any test run, not just before `nmr` commands.
+
+## 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
@@ -46,12 +68,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

@@ -4,15 +4,7 @@ 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.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`.
-<!-- /section:release-notes -->
+<!-- section:release-notes --><!-- /section:release-notes -->
 
 ## Installation
 
@@ -94,9 +86,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 }],
 
@@ -108,12 +100,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
 
@@ -128,6 +118,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.
 
@@ -163,13 +154,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:
@@ -720,15 +709,51 @@ 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
 

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";
@@ -124,12 +124,13 @@ 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', 1)[0] ?? message;

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

@@ -1,4 +1,5 @@
-import { COMMIT_PREPROCESSOR_PATTERNS } from "./parseCommitMessage.js";
+import { COMMIT_PREPROCESSOR_PATTERNS, PIPE_SCOPE_SOURCE } from "./parseCommitMessage.js";
+const PIPE_SCOPE_PATTERN = new RegExp(String.raw `^${PIPE_SCOPE_SOURCE}\|(.*)$`);
 export function stripScope(message) {
     let ticketPrefix = '';
     let remainder = message;
@@ -9,7 +10,7 @@ export function stripScope(message) {
             remainder = remainder.slice(match[0].length);
         }
     }
-    const pipeMatch = remainder.match(/^[^|]+\|(.*)$/);
+    const pipeMatch = remainder.match(PIPE_SCOPE_PATTERN);
     if (pipeMatch) {
         return `${ticketPrefix}${pipeMatch[1]}`;
     }

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

@@ -1,4 +1,10 @@
+import type { RepoLabelsConfig } from '../types.js';
 import type { LabelDefinition } from './types.js';
 export declare const LABELS_OUTPUT_PATH = ".github/labels.yaml";
 export declare function formatLabelsYaml(labels: LabelDefinition[], presetHashes: Map<string, string>): string;
-export declare function generateCommand(): Promise<number>;
+export declare function loadRepoLabelsConfig(): Promise<RepoLabelsConfig | undefined>;
+interface GenerateOptions {
+    check?: boolean;
+}
+export declare function generateCommand({ check }?: GenerateOptions): Promise<number>;
+export {};

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

@@ -1,36 +1,47 @@
-import { mkdirSync, writeFileSync } from 'node:fs';
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname } from 'node:path';
 import { reportError } from '@williamthorsen/nmr-core';
 import { stringify } from 'yaml';
-import { loadSyncLabelsConfig, SYNC_LABELS_CONFIG_PATH } from "./loadSyncLabelsConfig.js";
+import { CONFIG_FILE_PATH } from "../loadConfig.js";
+import { loadValidatedConfig } from "../loadValidatedConfig.js";
 import { hashPresetFile } from "./presets.js";
 import { resolveLabels } from "./resolveLabels.js";
+import { checkRetiredSyncLabelsConfig } from "./retiredConfig.js";
 export const LABELS_OUTPUT_PATH = '.github/labels.yaml';
 export function formatLabelsYaml(labels, presetHashes) {
-    const headerLines = ['# Generated by release-kit sync-labels — do not edit.', `# Source: ${SYNC_LABELS_CONFIG_PATH}`];
+    const headerLines = ['# Generated by release-kit sync-labels — do not edit.', `# Source: ${CONFIG_FILE_PATH}`];
     for (const [name, hash] of [...presetHashes].sort(([a], [b]) => a.localeCompare(b))) {
         headerLines.push(`# ${name} preset hash: ${hash}`);
     }
     const yamlBody = stringify(labels, { singleQuote: true, lineWidth: 0 });
     return headerLines.join('\n') + '\n' + yamlBody;
 }
-export async function generateCommand() {
-    let config;
-    try {
-        config = await loadSyncLabelsConfig();
+export async function loadRepoLabelsConfig() {
+    const result = await loadValidatedConfig();
+    if (result.status === 'missing') {
+        reportError(`No config file found at ${CONFIG_FILE_PATH}. Run \`release-kit sync-labels init\` first.`);
+        return undefined;
     }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        reportError(`Failed to load config: ${message}`);
+    if (result.status === 'invalid') {
+        return undefined;
+    }
+    if (result.config.repoLabels === undefined) {
+        reportError(`No \`repoLabels\` block found in ${CONFIG_FILE_PATH}. Run \`release-kit sync-labels init\` to seed one.`);
+        return undefined;
+    }
+    return result.config.repoLabels;
+}
+export async function generateCommand({ check = false } = {}) {
+    if (checkRetiredSyncLabelsConfig()) {
         return 1;
     }
-    if (config === undefined) {
-        reportError(`No config file found at ${SYNC_LABELS_CONFIG_PATH}. Run \`release-kit sync-labels init\` first.`);
+    const repoLabels = await loadRepoLabelsConfig();
+    if (repoLabels === undefined) {
         return 1;
     }
     let labels;
     try {
-        labels = resolveLabels(config);
+        labels = resolveLabels(repoLabels);
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
@@ -38,10 +49,13 @@ export async function generateCommand() {
         return 1;
     }
     const presetHashes = new Map();
-    for (const presetName of config.presets ?? []) {
+    for (const presetName of repoLabels.extends ?? []) {
         presetHashes.set(presetName, hashPresetFile(presetName));
     }
     const content = formatLabelsYaml(labels, presetHashes);
+    if (check) {
+        return compareAgainstCommittedFile(content);
+    }
     try {
         mkdirSync(dirname(LABELS_OUTPUT_PATH), { recursive: true });
         writeFileSync(LABELS_OUTPUT_PATH, content, 'utf8');
@@ -54,3 +68,19 @@ export async function generateCommand() {
     console.info(`Generated ${LABELS_OUTPUT_PATH} with ${String(labels.length)} labels.`);
     return 0;
 }
+function compareAgainstCommittedFile(expected) {
+    let existing;
+    try {
+        existing = readFileSync(LABELS_OUTPUT_PATH, 'utf8');
+    }
+    catch {
+        reportError(`${LABELS_OUTPUT_PATH} is missing. Run \`release-kit sync-labels generate\` and commit the result.`);
+        return 1;
+    }
+    if (existing !== expected) {
+        reportError(`${LABELS_OUTPUT_PATH} is stale. Run \`release-kit sync-labels generate\` and commit the result.`);
+        return 1;
+    }
+    console.info(`${LABELS_OUTPUT_PATH} is up to date.`);
+    return 0;
+}

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

@@ -1,10 +1,16 @@
+import { existsSync } from 'node:fs';
 import { reportWriteResult, writeFileWithCheck } from '@williamthorsen/nmr-core';
 import { discoverWorkspaces } from "../discoverWorkspaces.js";
+import { CONFIG_FILE_PATH } from "../loadConfig.js";
+import { loadValidatedConfig } from "../loadValidatedConfig.js";
 import { generateCommand, LABELS_OUTPUT_PATH } from "./generateCommand.js";
-import { SYNC_LABELS_CONFIG_PATH } from "./loadSyncLabelsConfig.js";
-import { buildScopeLabels, syncLabelsConfigScript, syncLabelsWorkflow } from "./templates.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 }) {
+    if (checkRetiredSyncLabelsConfig()) {
+        return 1;
+    }
     if (dryRun) {
         console.info('[dry-run mode]');
     }
@@ -18,20 +24,41 @@ export async function syncLabelsInitCommand({ dryRun, force }) {
         process.stderr.write(`  Failed to discover workspaces: ${message}\n`);
         return 1;
     }
-    const scopeLabels = workspacePaths === undefined ? [] : buildScopeLabels(workspacePaths);
     if (workspacePaths === undefined) {
         console.info('  No pnpm workspaces found (single-package repo)');
     }
     else {
         console.info(`  Found ${String(workspacePaths.length)} workspaces`);
     }
+    const configExists = existsSync(CONFIG_FILE_PATH);
+    const retiredNames = configExists ? await loadRetiredPackageNames() : [];
+    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 });
-    const configResult = writeFileWithCheck(SYNC_LABELS_CONFIG_PATH, syncLabelsConfigScript(scopeLabels), {
+    reportWriteResult(workflowResult, dryRun);
+    if (configExists) {
+        console.info(`\n> ${CONFIG_FILE_PATH} already exists; add this block to the object passed to defineConfig:\n`);
+        console.info(renderRepoLabelsBlock(scopeLabels));
+        if (workflowResult.outcome === 'failed') {
+            process.stderr.write('Failed to scaffold one or more files.\n');
+            return 1;
+        }
+        console.info(`
+> Next steps
+  1. Paste the block above into ${CONFIG_FILE_PATH}.
+  2. Run \`release-kit sync-labels generate\` to produce ${LABELS_OUTPUT_PATH}.
+  3. Commit the changes.
+  4. Run \`release-kit sync-labels sync\` to apply labels to your GitHub repo.
+`);
+        return 0;
+    }
+    const configResult = writeFileWithCheck(CONFIG_FILE_PATH, repoLabelsConfigScript(scopeLabels), {
         dryRun,
         overwrite: force,
     });
-    reportWriteResult(workflowResult, dryRun);
     reportWriteResult(configResult, dryRun);
     if (workflowResult.outcome === 'failed' || configResult.outcome === 'failed') {
         process.stderr.write('Failed to scaffold one or more files.\n');
@@ -51,11 +78,24 @@ export async function syncLabelsInitCommand({ dryRun, force }) {
 > Next steps
   1. Review the generated files:
      - ${WORKFLOW_PATH}
-     - ${SYNC_LABELS_CONFIG_PATH}
+     - ${CONFIG_FILE_PATH}
      - ${LABELS_OUTPUT_PATH}
-  2. Customize ${SYNC_LABELS_CONFIG_PATH} as needed, then re-run \`release-kit sync-labels generate\`.
+  2. Customize the \`repoLabels\` block in ${CONFIG_FILE_PATH} as needed, then re-run \`release-kit sync-labels generate\`.
   3. Commit the generated files.
   4. Run \`release-kit sync-labels sync\` to apply labels to your GitHub repo.
 `);
     return 0;
 }
+async function loadRetiredPackageNames() {
+    const result = await loadValidatedConfig();
+    if (result.status === 'invalid') {
+        return undefined;
+    }
+    if (result.status === 'missing') {
+        return [];
+    }
+    return (result.config.retiredPackages ?? []).map((retired) => toUnscopedName(retired.name));
+}
+function toUnscopedName(name) {
+    return name.startsWith('@') ? name.slice(name.indexOf('/') + 1) : name;
+}

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

@@ -1,2 +1,3 @@
-import type { LabelDefinition, SyncLabelsConfig } from './types.js';
-export declare function resolveLabels(config: SyncLabelsConfig): LabelDefinition[];
+import type { RepoLabelsConfig } from '../types.js';
+import type { LabelDefinition } from './types.js';
+export declare function resolveLabels(config: RepoLabelsConfig): LabelDefinition[];

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

@@ -1,35 +1,23 @@
 import { loadPreset } from "./presets.js";
 export function resolveLabels(config) {
-    const presetLabels = [];
-    for (const presetName of config.presets ?? []) {
-        const loaded = loadPreset(presetName);
-        presetLabels.push(...loaded);
-    }
-    const customLabels = config.labels ?? [];
-    detectCollisions(presetLabels, customLabels);
-    return sortLabels([...presetLabels, ...customLabels]);
-}
-function detectCollisions(presetLabels, customLabels) {
-    const seenPresetNames = new Set();
-    const withinPresetDuplicates = [];
-    for (const label of presetLabels) {
-        if (seenPresetNames.has(label.name)) {
-            withinPresetDuplicates.push(label.name);
+    const resolved = new Map();
+    for (const presetName of config.extends ?? []) {
+        for (const label of loadPreset(presetName)) {
+            resolved.set(label.name, label);
         }
-        seenPresetNames.add(label.name);
-    }
-    if (withinPresetDuplicates.length > 0) {
-        throw new Error(`Label name collision within presets: the following labels are defined by multiple presets: ${withinPresetDuplicates.join(', ')}. Remove the duplicates or use different presets.`);
     }
-    const conflicts = [];
-    for (const label of customLabels) {
-        if (seenPresetNames.has(label.name)) {
-            conflicts.push(label.name);
+    for (const [name, spec] of Object.entries(config.labels ?? {})) {
+        if (spec === null) {
+            if (!resolved.has(name)) {
+                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);
+        }
+        else {
+            resolved.set(name, { name, color: spec.color, description: spec.description });
         }
     }
-    if (conflicts.length > 0) {
-        throw new Error(`Label name collision: the following labels appear in both presets and custom labels: ${conflicts.join(', ')}. Remove duplicates from your custom labels or use a different name.`);
-    }
+    return sortLabels([...resolved.values()]);
 }
 function sortLabels(labels) {
     return [...labels].sort((a, b) => a.name.localeCompare(b.name));

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

@@ -0,0 +1,2 @@
+export declare const RETIRED_SYNC_LABELS_CONFIG_PATH = ".config/sync-labels.config.ts";
+export declare function checkRetiredSyncLabelsConfig(): boolean;

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

@@ -0,0 +1,11 @@
+import { existsSync } from 'node:fs';
+import { reportError } from '@williamthorsen/nmr-core';
+import { CONFIG_FILE_PATH } from "../loadConfig.js";
+export const RETIRED_SYNC_LABELS_CONFIG_PATH = '.config/sync-labels.config.ts';
+export function checkRetiredSyncLabelsConfig() {
+    if (!existsSync(RETIRED_SYNC_LABELS_CONFIG_PATH)) {
+        return false;
+    }
+    reportError(`${RETIRED_SYNC_LABELS_CONFIG_PATH} is no longer read. Move its labels into the \`repoLabels\` block of ${CONFIG_FILE_PATH} (presets move to \`repoLabels.extends\`; each label becomes a \`'name': { color, description }\` entry under \`repoLabels.labels\`), then delete the file.`);
+    return true;
+}

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

@@ -1,6 +1,7 @@
 import { execSync } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import { reportError } from '@williamthorsen/nmr-core';
+import { checkRetiredSyncLabelsConfig } from "./retiredConfig.js";
 const WORKFLOW_FILE = '.github/workflows/sync-labels.yaml';
 function checkGhAvailable() {
     try {
@@ -12,6 +13,9 @@ function checkGhAvailable() {
     }
 }
 export function syncLabelsCommand() {
+    if (checkRetiredSyncLabelsConfig()) {
+        return 1;
+    }
     if (!checkGhAvailable()) {
         reportError('The `gh` CLI is not installed or not in PATH. Install it from https://cli.github.com/');
         return 1;

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

@@ -1,4 +1,5 @@
 import type { LabelDefinition } from './types.js';
 export declare function syncLabelsWorkflow(): string;
-export declare function buildScopeLabels(workspacePaths: string[]): LabelDefinition[];
-export declare function syncLabelsConfigScript(scopeLabels: LabelDefinition[]): string;
+export declare function buildScopeLabels(workspacePaths: string[], retiredNames?: string[]): LabelDefinition[];
+export declare function renderRepoLabelsBlock(scopeLabels: LabelDefinition[]): string;
+export declare function repoLabelsConfigScript(scopeLabels: LabelDefinition[]): string;

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

@@ -6,22 +6,21 @@ name: Sync labels
 on:
   workflow_dispatch:
 
-  # Apply on merge, so a regenerated labels file cannot sit unapplied.
+  # Apply on merge, so that a regenerated labels file cannot sit unapplied.
   push:
     paths:
       - .github/labels.yaml
 
-  # Preview on review: the check's log carries the full computed diff,
-  # including deletions of labels the file does not declare.
+  # Preview on review: The check's log has a full computed diff, including deletions of labels not declared by the file.
   pull_request:
     paths:
       - .github/labels.yaml
 
 # Permissions are fixed when a run is created and cannot vary by trigger within a job,
-# so applying and previewing are separate jobs and the write token stays out of PR runs.
+# so applying and previewing are separate jobs.
 jobs:
-  # The push arm applies on the default branch alone. A \`branches:\` filter cannot name the
-  # default branch, so the gate lives on the job and this file stays identical across repos.
+  # The push arm applies on the default branch alone. A \`branches:\` filter cannot name the default branch,
+  # so that the gate lives on the job and this file stays identical across repos.
   sync:
     if: github.event_name != 'pull_request' && (github.event_name != 'push' || github.ref_name == github.event.repository.default_branch)
     permissions:
@@ -39,7 +38,7 @@ jobs:
       dry-run: true
 `;
 }
-export function buildScopeLabels(workspacePaths) {
+export function buildScopeLabels(workspacePaths, retiredNames = []) {
     const labels = [
         { name: 'scope:root', color: '00ff96', description: 'Monorepo root configuration' },
     ];
@@ -47,29 +46,34 @@ export function buildScopeLabels(workspacePaths) {
         const name = basename(workspacePath);
         labels.push({ name: `scope:${name}`, color: '00ff96', description: `${name} package` });
     }
+    for (const retiredName of retiredNames) {
+        labels.push({ name: `scope:${retiredName}`, color: '00ff96', description: `${retiredName} package (retired)` });
+    }
     return labels;
 }
 function escapeForSingleQuotedString(value) {
     return value.replace(/\\/g, '\\\\').replace(/'/g, String.raw `\'`);
 }
-export function syncLabelsConfigScript(scopeLabels) {
-    const labelsArray = scopeLabels
+export function renderRepoLabelsBlock(scopeLabels) {
+    const entries = scopeLabels
         .map((label) => {
         const name = escapeForSingleQuotedString(label.name);
         const color = escapeForSingleQuotedString(label.color);
         const description = escapeForSingleQuotedString(label.description);
-        return `    { name: '${name}', color: '${color}', description: '${description}' },`;
+        return `      '${name}': { color: '${color}', description: '${description}' },`;
     })
         .join('\n');
-    return `import type { SyncLabelsConfig } from '@williamthorsen/release-kit';
-
-const config: SyncLabelsConfig = {
-  presets: ['common'],
-  labels: [
-${labelsArray}
-  ],
-};
+    const labelsBlock = entries === '' ? '    labels: {},' : `    labels: {\n${entries}\n    },`;
+    return `  repoLabels: {
+    extends: ['common'],
+${labelsBlock}
+  },`;
+}
+export function repoLabelsConfigScript(scopeLabels) {
+    return `import { defineConfig } from '@williamthorsen/release-kit';
 
-export default config;
+export default defineConfig({
+${renderRepoLabelsBlock(scopeLabels)}
+});
 `;
 }

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

@@ -3,7 +3,3 @@ export interface LabelDefinition {
     color: string;
     description: string;
 }
-export interface SyncLabelsConfig {
-    presets?: string[];
-    labels?: LabelDefinition[];
-}

package/dist/esm/types.d.ts

@@ -171,6 +171,19 @@ export declare const breakingPolicyValueSchema: z.ZodEnum<{
     forbidden: "forbidden";
     required: "required";
 }>;
+export declare const labelSpecSchema: z.ZodObject<{
+    color: z.ZodString;
+    description: z.ZodString;
+}, z.core.$strict>;
+export type LabelSpec = z.infer<typeof labelSpecSchema>;
+export declare const repoLabelsSchema: z.ZodObject<{
+    extends: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodObject<{
+        color: z.ZodString;
+        description: z.ZodString;
+    }, z.core.$strict>>>>;
+}, z.core.$strict>;
+export type RepoLabelsConfig = z.infer<typeof repoLabelsSchema>;
 export declare const releaseKitConfigSchema: z.ZodObject<{
     breakingPolicies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
         optional: "optional";
@@ -190,6 +203,13 @@ export declare const releaseKitConfigSchema: z.ZodObject<{
     releaseNotes: z.ZodOptional<z.ZodObject<{
         shouldInjectIntoReadme: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
+    repoLabels: z.ZodOptional<z.ZodObject<{
+        extends: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodObject<{
+            color: z.ZodString;
+            description: z.ZodString;
+        }, z.core.$strict>>>>;
+    }, z.core.$strict>>;
     retiredPackages: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         tagPrefix: z.ZodString;

package/dist/esm/types.js

@@ -49,6 +49,18 @@ export const versionPatternsSchema = z
 })
     .strict();
 export const breakingPolicyValueSchema = z.enum(['forbidden', 'optional', 'required']);
+export const labelSpecSchema = z
+    .object({
+    color: z.string().min(1),
+    description: z.string(),
+})
+    .strict();
+export const repoLabelsSchema = z
+    .object({
+    extends: z.array(z.string().min(1)).optional(),
+    labels: z.record(z.string().min(1), labelSpecSchema.nullable()).optional(),
+})
+    .strict();
 export const releaseKitConfigSchema = z
     .object({
     breakingPolicies: z.record(z.string(), breakingPolicyValueSchema).optional(),
@@ -57,6 +69,7 @@ export const releaseKitConfigSchema = z
     formatCommand: z.string().min(1).optional(),
     project: projectConfigSchema.optional(),
     releaseNotes: releaseNotesInputSchema.optional(),
+    repoLabels: repoLabelsSchema.optional(),
     retiredPackages: z.array(retiredPackageSchema).optional(),
     scopeAliases: z.record(z.string(), z.string()).optional(),
     versionPatterns: versionPatternsSchema.optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@williamthorsen/release-kit",
-  "version": "8.1.0",
+  "version": "9.0.1",
   "description": "Version-bumping and changelog-generation toolkit for release workflows",
   "keywords": [],
   "homepage": "https://github.com/williamthorsen/node-monorepo-tools/tree/main/packages/release-kit#readme",
@@ -39,7 +39,7 @@
     "semver": "7.8.5",
     "yaml": "2.9.0",
     "zod": "4.4.3",
-    "@williamthorsen/nmr-core": "0.7.1"
+    "@williamthorsen/nmr-core": "0.7.3"
   },
   "devDependencies": {
     "@types/semver": "7.7.1",

package/presets/labels/common.yaml

@@ -2,6 +2,9 @@
 # Compatible with EndBug/label-sync format.
 
 # Main categories
+- name: ai
+  color: a2eeef
+  description: Documentation and configs used by agents
 - name: breaking
   color: b60205
   description: Breaking API change or removal of functionality

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

@@ -1,3 +0,0 @@
-import type { SyncLabelsConfig } from './types.js';
-export declare const SYNC_LABELS_CONFIG_PATH = ".config/sync-labels.config.ts";
-export declare function loadSyncLabelsConfig(): Promise<SyncLabelsConfig | undefined>;

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

@@ -1,53 +0,0 @@
-import { existsSync } from 'node:fs';
-import path from 'node:path';
-import { isRecord } from "../typeGuards.js";
-export const SYNC_LABELS_CONFIG_PATH = '.config/sync-labels.config.ts';
-export async function loadSyncLabelsConfig() {
-    const absoluteConfigPath = path.resolve(process.cwd(), SYNC_LABELS_CONFIG_PATH);
-    if (!existsSync(absoluteConfigPath)) {
-        return undefined;
-    }
-    const { createJiti } = await import('jiti');
-    const jiti = createJiti(import.meta.url);
-    const imported = await jiti.import(absoluteConfigPath);
-    if (!isRecord(imported)) {
-        throw new Error(`Config file must export an object, got ${Array.isArray(imported) ? 'array' : typeof imported}`);
-    }
-    const resolved = imported.default ?? imported.config;
-    if (resolved === undefined) {
-        throw new Error('Config file must have a default export or a named `config` export (e.g., `export default { ... }` or `export const config = { ... }`)');
-    }
-    return validateSyncLabelsConfig(resolved);
-}
-function validateSyncLabelsConfig(value) {
-    if (!isRecord(value)) {
-        throw new Error(`Config must be an object, got ${typeof value}`);
-    }
-    let presets;
-    if (value.presets !== undefined) {
-        if (!Array.isArray(value.presets) || !value.presets.every((p) => typeof p === 'string')) {
-            throw new Error('Config `presets` must be an array of strings');
-        }
-        presets = value.presets;
-    }
-    let labels;
-    if (value.labels !== undefined) {
-        if (!Array.isArray(value.labels)) {
-            throw new TypeError('Config `labels` must be an array');
-        }
-        labels = [];
-        for (const label of value.labels) {
-            if (!isRecord(label)) {
-                throw new Error('Each label must be an object with `name`, `color`, and `description`');
-            }
-            if (typeof label.name !== 'string' || typeof label.color !== 'string' || typeof label.description !== 'string') {
-                throw new TypeError('Each label must have string `name`, `color`, and `description` fields');
-            }
-            labels.push({ name: label.name, color: label.color, description: label.description });
-        }
-    }
-    return {
-        ...(presets !== undefined && { presets }),
-        ...(labels !== undefined && { labels }),
-    };
-}