@williamthorsen/release-kit 12.0.0 → 13.0.0

package/presets/labels/common.yaml

@@ -1,37 +1,17 @@
 # Common label definitions for GitHub repositories.
 # Compatible with EndBug/label-sync format.
+# Work-type labels are built from change-grammar's taxonomy in src/sync-labels/typeLabels.ts.
 
 # Main categories
-- name: ai
-  color: a2eeef
-  description: Guidance on working in this repo, such as its AGENTS.md or a repo-local skill, or its agent config
 - name: breaking
   color: b60205
   description: Breaking API change or removal of functionality
 - name: bug
   color: d73a4a
   description: "Something isn't working"
-- name: deprecation
-  color: fbca04
-  description: Marks functionality for future removal
-- name: documentation
-  color: a2eeef
-  description: Documentation for human readers, such as a README, a guide, or a code comment
-- name: feature
-  color: '0075ca'
-  description: Added or improved external functionality
-- name: fix
-  color: d73a4a
-  description: Fixes a bug
 - name: operational
   color: '000000'
   description: Actions outside the codebase
-- name: performance
-  color: '0075ca'
-  description: Improves performance without changing behavior
-- name: security
-  color: b60205
-  description: Security vulnerability or hardening
 - name: spike
   color: '000000'
   description: Investigation
@@ -47,26 +27,6 @@
   color: fbca04
   description: Further information is needed
 
-# Refactoring
-- name: ci
-  color: edc287
-  description: CI/CD tooling & configuration
-- name: dependencies
-  color: edc287
-  description: Change to dependencies
-- name: internal
-  color: 1d76db
-  description: Internal change without external impact
-- name: refactoring
-  color: edc287
-  description: Improvement to code without change in functionality
-- name: tests
-  color: edc287
-  description: Tests
-- name: tooling
-  color: edc287
-  description: Development tools
-
 # Priority
 - name: 'priority:critical'
   color: b60205

package/dist/esm/resolveReleaseNotesConfig.d.ts

@@ -1,26 +0,0 @@
-import type { OutputStyle } from '@williamthorsen/nmr-core';
-import type { ReleaseNotesConfig } from './types.js';
-export interface ResolvedReleaseNotesConfig {
-    releaseNotes: ReleaseNotesConfig;
-    changelogJsonOutputPath: string;
-    /** Section titles in priority order, derived from the merged workTypes record. */
-    sectionOrder: string[];
-}
-export interface ResolveReleaseNotesConfigOptions {
-    /** Config file to read, relative to the working directory. Defaults to `CONFIG_FILE_PATH`. */
-    configPath?: string;
-}
-/**
- * Loads and validates the release-kit config, resolving the release-notes settings it carries.
- *
- * An unusable config reports to stderr and calls `process.exit(1)`, whether the file failed to load or failed
- * validation, and whether it was named by the caller or the default one. Both callers are CLI commands whose
- * whole behavior depends on the resolved config, so neither could proceed on derived defaults without silently
- * dropping a configured `releaseNotes.shouldInjectIntoReadme`, `changelogJson.outputPath`, or `workTypes`.
- * An absent default config is a supported state and resolves to the defaults.
- */
-export declare function resolveReleaseNotesConfig(stderrStyle: OutputStyle, options?: ResolveReleaseNotesConfigOptions): Promise<ResolvedReleaseNotesConfig>;
-/** Extract section headers in declaration order from a merged workTypes record. */
-export declare function deriveSectionOrder(workTypes: Record<string, {
-    header: string;
-}>): string[];

package/dist/esm/resolveReleaseNotesConfig.js

@@ -1,29 +0,0 @@
-import { DEFAULT_CHANGELOG_JSON_CONFIG, DEFAULT_RELEASE_NOTES_CONFIG } from "./defaults.js";
-import { resolveWorkTypes } from "./loadConfig.js";
-import { loadValidatedConfig, reportConfigProblem, reportConfigWarnings } from "./loadValidatedConfig.js";
-export async function resolveReleaseNotesConfig(stderrStyle, options = {}) {
-    const result = await loadValidatedConfig(options.configPath);
-    if (result.status === 'invalid') {
-        reportConfigProblem(result.problem, stderrStyle);
-        process.exit(1);
-    }
-    if (result.status === 'missing') {
-        return {
-            releaseNotes: { ...DEFAULT_RELEASE_NOTES_CONFIG },
-            changelogJsonOutputPath: DEFAULT_CHANGELOG_JSON_CONFIG.outputPath,
-            sectionOrder: deriveSectionOrder(resolveWorkTypes()),
-        };
-    }
-    reportConfigWarnings(result.warnings, stderrStyle);
-    const { config } = result;
-    return {
-        releaseNotes: {
-            shouldInjectIntoReadme: config.releaseNotes?.shouldInjectIntoReadme ?? DEFAULT_RELEASE_NOTES_CONFIG.shouldInjectIntoReadme,
-        },
-        changelogJsonOutputPath: config.changelogJson?.outputPath ?? DEFAULT_CHANGELOG_JSON_CONFIG.outputPath,
-        sectionOrder: deriveSectionOrder(resolveWorkTypes(config.workTypes)),
-    };
-}
-export function deriveSectionOrder(workTypes) {
-    return Object.values(workTypes).map((entry) => entry.header);
-}

package/dist/esm/workTypesData.d.ts

@@ -1,50 +0,0 @@
-/**
- * Canonical work-types data: the runtime mirror of `work-types.json`.
- *
- * `work-types.json` is release-kit's copy of the codeassembly canonical. This `.ts` mirror exists for
- * runtime consumption: The compiler baseline does not enable JSON module imports, and a TS constant keeps
- * `breakingPolicy` typed as its three-value union.
- *
- * `nmr work-types:sync` updates only the JSON, so copy its change here by hand. A drift test
- * (`workTypesData.unit.test.ts`) asserts that this constant deep-equals the parsed contents of
- * `work-types.json`.
- */
-/** Schema for a single entry. */
-export interface WorkTypeEntry {
-    tier: string;
-    key: string;
-    aliases: string[];
-    emoji: string;
-    label: string;
-    description: string;
-    breakingPolicy: 'forbidden' | 'optional' | 'required';
-    excludedFromChangelog?: boolean;
-}
-/**
- * Schema for an orthogonal section marker (e.g., breaking-changes indicator).
- *
- * Stored as plain text — consumers add formatting (bold, prefix punctuation) when
- * constructing the rendered form. Keeps the SSOT format-agnostic across Markdown,
- * HTML, terminal, and plain-text consumers.
- */
-export interface MarkerEntry {
-    emoji: string;
-    label: string;
-}
-/** Schema for the full data. */
-export interface WorkTypesData {
-    /** Semantic version of the data shape, as declared by the upstream canonical. */
-    version: string;
-    tiers: string[];
-    types: WorkTypeEntry[];
-    /**
-     * Cross-cutting section markers keyed by marker name. The `breaking` marker is
-     * canonical and required; additional keys are permitted for forward-compatibility.
-     */
-    markers: {
-        [key: string]: MarkerEntry;
-        breaking: MarkerEntry;
-    };
-}
-/** Canonical work-types data, kept in lockstep with `work-types.json`. */
-export declare const WORK_TYPES_DATA: WorkTypesData;

package/dist/esm/workTypesData.js

@@ -1,145 +0,0 @@
-export const WORK_TYPES_DATA = {
-    version: '1.1.0',
-    tiers: ['public', 'internal', 'process'],
-    types: [
-        {
-            tier: 'public',
-            key: 'feat',
-            aliases: ['feature'],
-            emoji: '🎉',
-            label: 'Features',
-            description: 'A change that gives consumers a new capability or extends an existing one.',
-            breakingPolicy: 'optional',
-        },
-        {
-            tier: 'public',
-            key: 'drop',
-            aliases: [],
-            emoji: '🪦',
-            label: 'Removed',
-            description: 'A change that removes a capability or surface on which consumers depend.',
-            breakingPolicy: 'required',
-        },
-        {
-            tier: 'public',
-            key: 'deprecate',
-            aliases: [],
-            emoji: '🗑️',
-            label: 'Deprecated',
-            description: 'A change that marks a capability or surface for removal while the capability or surface keeps working.',
-            breakingPolicy: 'forbidden',
-        },
-        {
-            tier: 'public',
-            key: 'fix',
-            aliases: ['bugfix'],
-            emoji: '🐛',
-            label: 'Bug fixes',
-            description: 'A change that corrects behavior that consumers meet and that differs from what was intended.',
-            breakingPolicy: 'optional',
-        },
-        {
-            tier: 'public',
-            key: 'sec',
-            aliases: ['security'],
-            emoji: '🔒',
-            label: 'Security',
-            description: 'A change that closes a vulnerability or hardens a consumer-facing surface against attack.',
-            breakingPolicy: 'optional',
-        },
-        {
-            tier: 'public',
-            key: 'perf',
-            aliases: ['performance'],
-            emoji: '⚡',
-            label: 'Performance',
-            description: 'A change that reduces the time, memory, or other resources that consumer-facing work uses, without changing its result.',
-            breakingPolicy: 'optional',
-        },
-        {
-            tier: 'internal',
-            key: 'internal',
-            aliases: ['utility'],
-            emoji: '🏗️',
-            label: 'Internal features',
-            description: 'A change that adds or extends a capability that consumers do not use directly, such as a helper or an internal module.',
-            breakingPolicy: 'forbidden',
-        },
-        {
-            tier: 'internal',
-            key: 'refactor',
-            aliases: [],
-            emoji: '♻️',
-            label: 'Refactoring',
-            description: 'A change that restructures existing code without changing its behavior.',
-            breakingPolicy: 'forbidden',
-        },
-        {
-            tier: 'internal',
-            key: 'tests',
-            aliases: ['test'],
-            emoji: '🧪',
-            label: 'Tests',
-            description: 'A change confined to tests, test fixtures, or test helpers, including one that unblocks a build or a type check.',
-            breakingPolicy: 'forbidden',
-        },
-        {
-            tier: 'process',
-            key: 'tooling',
-            aliases: [],
-            emoji: '⚙️',
-            label: 'Tooling',
-            description: 'A change to the tools used to develop the project: build, lint, formatting, and release configuration, and development scripts.',
-            breakingPolicy: 'forbidden',
-        },
-        {
-            tier: 'process',
-            key: 'ci',
-            aliases: [],
-            emoji: '👷',
-            label: 'CI',
-            description: 'A change to continuous-integration workflows and their configuration.',
-            breakingPolicy: 'forbidden',
-        },
-        {
-            tier: 'process',
-            key: 'deps',
-            aliases: ['dep'],
-            emoji: '📦',
-            label: 'Dependencies',
-            description: 'A change that adds, removes, or upgrades a dependency, including its lockfile and version-catalog entries.',
-            breakingPolicy: 'forbidden',
-        },
-        {
-            tier: 'process',
-            key: 'ai',
-            aliases: [],
-            emoji: '🤖',
-            label: 'Agentic support',
-            description: "A change to guidance on working in the repository itself, such as its `AGENTS.md` or a repo-local skill, or to the repository's agent configuration.",
-            breakingPolicy: 'forbidden',
-        },
-        {
-            tier: 'process',
-            key: 'docs',
-            aliases: ['doc'],
-            emoji: '📚',
-            label: 'Documentation',
-            description: 'A change to documentation for human readers, such as a README, a guide, or a code comment.',
-            breakingPolicy: 'forbidden',
-        },
-        {
-            tier: 'process',
-            key: 'fmt',
-            aliases: [],
-            emoji: '🎨',
-            label: 'Formatting',
-            description: 'A change to formatting alone, such as whitespace or line wrapping, that leaves the content unchanged.',
-            breakingPolicy: 'forbidden',
-            excludedFromChangelog: true,
-        },
-    ],
-    markers: {
-        breaking: { emoji: '🚨', label: 'Breaking' },
-    },
-};

package/schemas/label-map.json

@@ -1,24 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "label-map",
-  "description": "Maps commit-prefix scopes and types to GitHub label names. Consumed by agent skills, CI tooling, and any script that needs to translate commit conventions into label operations.",
-  "type": "object",
-  "required": ["types", "scopes"],
-  "additionalProperties": false,
-  "properties": {
-    "$schema": {
-      "type": "string",
-      "description": "JSON Schema reference for editor support."
-    },
-    "types": {
-      "type": "object",
-      "description": "Maps commit-type prefix (e.g., `feat`) to GitHub label name (e.g., `feature`).",
-      "additionalProperties": { "type": "string" }
-    },
-    "scopes": {
-      "type": "object",
-      "description": "Maps commit-scope prefix (e.g., `audit`) to GitHub label name (e.g., `scope:audit`).",
-      "additionalProperties": { "type": "string" }
-    }
-  }
-}