@williamthorsen/release-kit 8.0.1 → 9.0.0

package/dist/esm/releasePrepareMono.js

@@ -95,8 +95,8 @@ export function releasePrepareMono(config, options) {
         tags,
         formatCommand,
         dryRun,
-        ...(allWarnings.length > 0 ? { warnings: allWarnings } : {}),
-        ...(project === undefined ? {} : { project }),
+        ...(allWarnings.length > 0 && { warnings: allWarnings }),
+        ...(project !== undefined && { project }),
     };
 }
 function determineDirectBumps(config, options) {
@@ -487,10 +487,11 @@ function topologicalSort(releaseSet, graph) {
     const sortedSet = new Set(sorted);
     const cyclicDirs = [];
     for (const dir of releaseDirs) {
-        if (!sortedSet.has(dir)) {
-            sorted.push(dir);
-            cyclicDirs.push(dir);
+        if (sortedSet.has(dir)) {
+            continue;
         }
+        sorted.push(dir);
+        cyclicDirs.push(dir);
     }
     return { sorted, cyclicDirs };
 }

package/dist/esm/renderReleaseNotes.js

@@ -50,8 +50,8 @@ function sortSectionsByOrder(sections, order) {
     }
     const indexed = sections.map((section, index) => ({ section, index }));
     indexed.sort((a, b) => {
-        const priorityA = priority.get(a.section.title) ?? Number.POSITIVE_INFINITY;
-        const priorityB = priority.get(b.section.title) ?? Number.POSITIVE_INFINITY;
+        const priorityA = priority.get(a.section.title) ?? Infinity;
+        const priorityB = priority.get(b.section.title) ?? Infinity;
         if (priorityA !== priorityB) {
             return priorityA - priorityB;
         }

package/dist/esm/resolveCommandTags.js

@@ -42,10 +42,11 @@ export async function resolveCommandTags(tags) {
     if (tags !== undefined) {
         const availableTagNames = resolvedTags.map((t) => t.tag);
         for (const name of tags) {
-            if (!availableTagNames.includes(name)) {
-                reportError(`Unknown tag "${name}" in --tags. Available: ${availableTagNames.join(', ')}`);
-                process.exit(1);
+            if (availableTagNames.includes(name)) {
+                continue;
             }
+            reportError(`Unknown tag "${name}" in --tags. Available: ${availableTagNames.join(', ')}`);
+            process.exit(1);
         }
         resolvedTags = resolvedTags.filter((t) => tags.includes(t.tag));
     }

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}`];
-    for (const [name, hash] of [...presetHashes.entries()].sort(([a], [b]) => a.localeCompare(b))) {
+    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,16 +6,39 @@ name: Sync labels
 on:
   workflow_dispatch:
 
-permissions:
-  contents: read
-  issues: write
+  # Apply on merge, so that a regenerated labels file cannot sit unapplied.
+  push:
+    paths:
+      - .github/labels.yaml
 
+  # 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.
 jobs:
+  # 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:
+      contents: read
+      issues: write
+    uses: williamthorsen/node-monorepo-tools/.github/workflows/sync-labels.reusable.yaml@workflow/sync-labels-v1
+
+  check:
+    if: github.event_name == 'pull_request'
+    permissions:
+      contents: read
+      issues: read
     uses: williamthorsen/node-monorepo-tools/.github/workflows/sync-labels.reusable.yaml@workflow/sync-labels-v1
+    with:
+      dry-run: true
 `;
 }
-export function buildScopeLabels(workspacePaths) {
+export function buildScopeLabels(workspacePaths, retiredNames = []) {
     const labels = [
         { name: 'scope:root', color: '00ff96', description: 'Monorepo root configuration' },
     ];
@@ -23,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/dist/esm/writeReleaseNotesPreviews.js

@@ -53,7 +53,7 @@ function writePreviewFile(filePath, content, dryRun) {
     const result = writeFileWithCheck(filePath, content, { dryRun: false, overwrite: true });
     if (result.outcome === 'failed') {
         reportError(`Failed to write ${filePath}: ${result.error ?? 'unknown error'}`);
-        return { filePath, outcome: 'failed', ...(result.error === undefined ? {} : { error: result.error }) };
+        return { filePath, outcome: 'failed', ...(result.error !== undefined && { error: result.error }) };
     }
     if (result.outcome === 'created' || result.outcome === 'overwritten') {
         console.info(dim(`  Wrote ${filePath}`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@williamthorsen/release-kit",
-  "version": "8.0.1",
+  "version": "9.0.0",
   "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,14 +39,14 @@
     "semver": "7.8.5",
     "yaml": "2.9.0",
     "zod": "4.4.3",
-    "@williamthorsen/nmr-core": "0.7.0"
+    "@williamthorsen/nmr-core": "0.7.2"
   },
   "devDependencies": {
     "@types/semver": "7.7.1",
     "smol-toml": "1.7.0"
   },
   "engines": {
-    "node": ">=18.17.0"
+    "node": ">=24"
   },
   "publishConfig": {
     "access": "public",

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 }),
-    };
-}