@williamthorsen/release-kit 17.0.0 → 18.0.0

package/.meta/changelog.json

@@ -1,4 +1,51 @@
 [
+  {
+    "version": "18.0.0",
+    "date": "2026-11-10",
+    "sections": [
+      {
+        "title": "🎉 Features",
+        "audience": "all",
+        "items": [
+          {
+            "description": "Renames the `common` label preset's `priority:critical`, `priority:high`, `priority:medium`, and `priority:low` labels to `urgency:*`, and declares each old name as an alias so that `release-kit sync-labels` renames a repository's existing labels in place and keeps them on their issues and pull requests. (#1270)",
+            "breaking": true,
+            "migration": "Replace each `priority:*` name in the `repoLabels.labels` record and in any tool that reads labels by name with its `urgency:*` counterpart, then run `release-kit sync-labels generate`; a `priority:*` entry set to `null` now fails generation as a dangling `null`, and a `labels` entry that restates an `urgency:*` label without `aliases` stops the rename.",
+            "hash": "c3da65d2eef59ae0ce5a9087bddbc6bea888c771",
+            "entry": 1
+          }
+        ]
+      },
+      {
+        "title": "♻️ Refactoring",
+        "audience": "dev",
+        "items": [
+          {
+            "description": "Replaces the duplicate `resolveStyles` modules in `release-kit` and `v11y-check` with `resolveCliStyles` from `@williamthorsen/nmr-core/cli`, which each package's `route.ts` calls with its own output-style environment variable. (#1248)",
+            "hash": "c5f4ac68360ce550a7e53006a2a633b79f179f5f",
+            "entry": 1
+          }
+        ]
+      }
+    ]
+  },
+  {
+    "version": "17.0.1",
+    "date": "2026-11-08",
+    "sections": [
+      {
+        "title": "🐛 Bug fixes",
+        "audience": "all",
+        "items": [
+          {
+            "description": "Fixes the issue that `release-kit` did not match a change-record entry's type to a configured work-type key or alias that contains an uppercase letter. (#1216)",
+            "hash": "78108625e45ee74cb473b9a15104ef4d58698f5b",
+            "entry": 1
+          }
+        ]
+      }
+    ]
+  },
   {
     "version": "17.0.0",
     "date": "2026-11-08",

package/.readyup/kits/default.js

@@ -223,7 +223,7 @@ function stripYamlQuotes(value) {
 }
 
 // .readyup/lib/workflow-hashes.ts
-var COMMON_PRESET_HASH = "5c6d7efcc8744d9d30720d24e345b04e03f2b28677ad0c6782020d91731b8aa4";
+var COMMON_PRESET_HASH = "83c27890ea984711d33c7d4ea86c755869f091f9f3414f02ef8a3f9d305db490";
 var SYNC_LABELS_WORKFLOW_HASH = "0a88829d154c0de7cdd4246fede99e9311a89ab4199034dbe601663d641ab1e4";
 var RELEASE_WORKFLOW_HASH_MONOREPO = "f63f4cabb57f94ee6550f17a9874c7a346d46554595ddbcd46fdd3208d613437";
 var RELEASE_WORKFLOW_HASH_SINGLE = "d26dd4ca186632b388ea46bd885721124c03d19918e511baa40821d2d760da69";
@@ -234,7 +234,7 @@ var CREATE_GITHUB_RELEASE_WORKFLOW_HASH_SINGLE = "d6de961de913c67b08dfa7e07f7349
 
 // .readyup/kits/default.ts
 function getMinVersion() {
-  const picked = { "version": "17.0.0" };
+  const picked = { "version": "18.0.0" };
   if (typeof picked["version"] !== "string") {
     throw new TypeError("release-kit/package.json: 'version' must be a string");
   }

package/.readyup/manifest.json

@@ -3,10 +3,10 @@
   "kits": [
     {
       "bundledDependencies": {
-        "@williamthorsen/toolbelt.datetime": "4.1.0",
+        "@williamthorsen/toolbelt.datetime": "4.1.1",
         "@williamthorsen/toolbelt.errors": "0.9.0",
         "@williamthorsen/toolbelt.filesystem": "0.10.0",
-        "@williamthorsen/toolbelt.numbers": "7.3.0",
+        "@williamthorsen/toolbelt.numbers": "7.3.1",
         "@williamthorsen/toolbelt.objects": "4.4.0",
         "@williamthorsen/toolbelt.packaging": "0.7.0",
         "@williamthorsen/toolbelt.terminal": "0.3.0",
@@ -26,7 +26,7 @@
           "checklist": "release-kit",
           "checks": [
             "@williamthorsen/release-kit in devDependencies",
-            "@williamthorsen/release-kit >= 17.0.0",
+            "@williamthorsen/release-kit >= 18.0.0",
             "release.yaml workflow exists",
             "release.yaml matches template",
             "release.yaml does not reference deprecated tag ref",
@@ -157,12 +157,12 @@
           "path": "lib/config-checks.ts"
         },
         {
-          "hash": "f652dae3",
+          "hash": "70e95528",
           "kind": "module",
           "path": "lib/workflow-hashes.ts"
         },
         {
-          "hash": "8df94cba",
+          "hash": "f79c1319",
           "kind": "inline",
           "path": "../package.json",
           "paths": [
@@ -195,14 +195,14 @@
       "readyupVersion": "0.45.0",
       "source": "kits/default.ts",
       "sourceHash": "56566d0b",
-      "targetHash": "060f7720"
+      "targetHash": "f1bc2e7d"
     },
     {
       "bundledDependencies": {
-        "@williamthorsen/toolbelt.datetime": "4.1.0",
+        "@williamthorsen/toolbelt.datetime": "4.1.1",
         "@williamthorsen/toolbelt.errors": "0.9.0",
         "@williamthorsen/toolbelt.filesystem": "0.10.0",
-        "@williamthorsen/toolbelt.numbers": "7.3.0",
+        "@williamthorsen/toolbelt.numbers": "7.3.1",
         "@williamthorsen/toolbelt.objects": "4.4.0",
         "@williamthorsen/toolbelt.packaging": "0.7.0",
         "@williamthorsen/toolbelt.terminal": "0.3.0",

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to this project will be documented in this file.
 
+## 18.0.0 — 2026-11-10
+
+### 🎉 Features
+
+- 🚨 **Breaking:** Renames the `common` label preset's `priority:critical`, `priority:high`, `priority:medium`, and `priority:low` labels to `urgency:*`, and declares each old name as an alias so that `release-kit sync-labels` renames a repository's existing labels in place and keeps them on their issues and pull requests. (#1270)
+
+### ♻️ Refactoring
+
+- Replaces the duplicate `resolveStyles` modules in `release-kit` and `v11y-check` with `resolveCliStyles` from `@williamthorsen/nmr-core/cli`, which each package's `route.ts` calls with its own output-style environment variable. (#1248)
+
+## 17.0.1 — 2026-11-08
+
+### 🐛 Bug fixes
+
+- Fixes the issue that `release-kit` did not match a change-record entry's type to a configured work-type key or alias that contains an uppercase letter. (#1216)
+
 ## 17.0.0 — 2026-11-08
 
 ### 🎉 Features

package/README.md

@@ -7,16 +7,11 @@ 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 the same commit history that decides each bump (with optional [editorial overrides](docs/editorial-overrides.md)).
 
 <!-- section:release-notes -->
-## Release notes — v17.0.0 (2026-11-08)
+## Release notes — v18.0.0 (2026-11-10)
 
 ### 🎉 Features
 
-- 🚨 **Breaking:** Routes `release-kit` commands through the `toolbelt.cli` command parser, which renders help from each command's options and makes a usage error, such as an invalid `RELEASE_KIT_OUTPUT_STYLE` or a stray argument to `sync-labels sync`, exit 2 with a `Try` line instead of exit 1, and makes a bare `release-kit`, `release-kit overrides`, or `release-kit sync-labels` exit 2 instead of printing help and exiting 0. (#1186)
-- Prefixes each handled error line written by `nmr` and its other bins, `release-kit`, and `v11y-check` with the name of the program that wrote it, as `<bin>: <message>` in place of `Error: <message>`, for usage errors such as an unknown command or option as well, and names `v11y` for both of the bins in `v11y-check`. (#1190)
-
-### 🐛 Bug fixes
-
-- Fixes the issue that the tarball refusal from `release-kit prepare` and `release-kit publish` pointed to a `prepack` script, even though the check builds the package through its `prepublishOnly` script, and makes the refusal and `docs/releasing.md` name `"prepublishOnly": "nmr build"` instead. (#1193)
+- 🚨 **Breaking:** Renames the `common` label preset's `priority:critical`, `priority:high`, `priority:medium`, and `priority:low` labels to `urgency:*`, and declares each old name as an alias so that `release-kit sync-labels` renames a repository's existing labels in place and keeps them on their issues and pull requests. (#1270)
 <!-- /section:release-notes -->
 
 ## Installation

package/dist/esm/parseCommitMessage.d.ts

@@ -55,7 +55,5 @@ export interface BreakingPolicyInputs {
  * commit still parses.
  */
 export declare function evaluateBreakingPolicy(inputs: BreakingPolicyInputs): boolean;
-/**
- * Resolves a raw type string to its canonical type name using the record keys and aliases.
- */
+/** Resolves a raw type string to its canonical type name through change-grammar, ignoring case on both sides. */
 export declare function resolveType(rawType: string, workTypes: Record<string, WorkTypeConfig>): string | undefined;

package/dist/esm/parseCommitMessage.js

@@ -1,4 +1,4 @@
-import { compileTemplate, parse, TEMPLATE_CATALOGUE, } from '@williamthorsen/change-grammar';
+import { canonicalizeType, compileTemplate, parse, TEMPLATE_CATALOGUE, } from '@williamthorsen/change-grammar';
 const SUBJECT_TEMPLATES = [
     compileTemplate(TEMPLATE_CATALOGUE.pipedScope),
     compileTemplate(TEMPLATE_CATALOGUE.conventionalCommits),
@@ -54,20 +54,7 @@ export function evaluateBreakingPolicy(inputs) {
     return hasPrefixBreaking || hasFooterBreaking;
 }
 export function resolveType(rawType, workTypes) {
-    const loweredType = rawType.toLowerCase();
-    for (const [key, config] of Object.entries(workTypes)) {
-        if (key === loweredType) {
-            return key;
-        }
-        if (config.aliases !== undefined) {
-            for (const alias of config.aliases) {
-                if (alias === loweredType) {
-                    return key;
-                }
-            }
-        }
-    }
-    return undefined;
+    return canonicalizeType(rawType, adaptToTaxonomy(workTypes));
 }
 function adaptToTaxonomy(workTypes) {
     return {

package/dist/esm/route.js

@@ -1,11 +1,11 @@
 import process from 'node:process';
 import { resolveSelfVersion } from '@williamthorsen/nmr-core';
-import { createCli, runCli } from '@williamthorsen/nmr-core/cli';
+import { createCli, resolveCliStyles, runCli } from '@williamthorsen/nmr-core/cli';
 import { BIN } from "./bin.js";
 import { init, overrides, showTagPrefixes, syncLabels, updateTemplates } from "./cli/maintenanceCommands.js";
 import { commit, createGithubRelease, prepare, publish, push, tag } from "./cli/releaseCommands.js";
-import { OUTPUT_STYLE_ENV_VAR, resolveStyles } from "./resolveStyles.js";
 const VERSION = resolveSelfVersion(import.meta.url);
+const OUTPUT_STYLE_ENV_VAR = 'RELEASE_KIT_OUTPUT_STYLE';
 export async function routeCommand(args) {
     return runCli(args, ROOT, {
         name: BIN,
@@ -18,7 +18,9 @@ export async function routeCommand(args) {
 const { defineGroup } = createCli();
 const ROOT = defineGroup({
     summary: 'Version-bumping and changelog-generation toolkit for release workflows',
-    deriveContext: (_flags, context) => ({ styles: resolveStyles(context) }),
+    deriveContext: (_flags, context) => ({
+        styles: resolveCliStyles({ ...context, envVar: OUTPUT_STYLE_ENV_VAR }),
+    }),
     commands: {
         prepare,
         commit,

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

@@ -3,7 +3,8 @@ import type { LabelDefinition } from './types.js';
 export declare function hashPreset(presetName: string): string;
 /**
  * Loads a named preset from the bundled YAML files. The `common` preset also defines the label of every work type in
- * change-grammar's taxonomy, ahead of the labels in its file.
+ * change-grammar's taxonomy, ahead of the labels in its file. An entry may declare `aliases`, the old names that the
+ * sync renames to the label.
  *
  * Throws if the preset does not exist or has invalid content.
  */

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

@@ -4,6 +4,7 @@ import { resolve } from 'node:path';
 import { CANONICAL_TAXONOMY } from '@williamthorsen/change-grammar';
 import { findPackageRoot, isRecord, UserError } from '@williamthorsen/nmr-core';
 import { parse } from 'yaml';
+import { labelSpecSchema } from "../configSchema.js";
 import { chainUserError } from "../user-error-chaining.js";
 import { deriveTypeLabels } from "./typeLabels.js";
 const TYPE_LABELS_PRESET = 'common';
@@ -33,13 +34,21 @@ export function loadPreset(presetName) {
         if (!isRecord(entry)) {
             throw new UserError(`Preset "${presetName}" contains an invalid label entry: ${JSON.stringify(entry)}`);
         }
-        const { color, description, name } = entry;
+        const { aliases: rawAliases, color, description, name } = entry;
+        const aliasesResult = labelSpecSchema.shape.aliases.safeParse(rawAliases);
         if (typeof name !== 'string' ||
             typeof color !== 'string' ||
-            (description !== undefined && typeof description !== 'string')) {
+            (description !== undefined && typeof description !== 'string') ||
+            !aliasesResult.success) {
             throw new UserError(`Preset "${presetName}" contains a label with invalid fields: ${JSON.stringify(entry)}`);
         }
-        labels.push({ name, color, ...(description !== undefined && { description }) });
+        const aliases = aliasesResult.data;
+        labels.push({
+            name,
+            color,
+            ...(description !== undefined && { description }),
+            ...(aliases !== undefined && { aliases }),
+        });
     }
     return presetName === TYPE_LABELS_PRESET ? [...deriveTypeLabels(CANONICAL_TAXONOMY), ...labels] : labels;
 }

package/docs/labels.md

@@ -38,6 +38,8 @@ The `common` preset defines a label for every work type in change-grammar's taxo
 
 The bundled file's `confidence:` family grades how advisable a recommendation is, for example one that a triage of spike findings turns into a ticket: `confidence:high` is clearly worth doing, `confidence:medium` is worth doing but arguable, and `confidence:low` is not worth a ticket now.
 
+The `urgency:` family states how soon an item needs attention, apart from how valuable it is, which the `value:` family states. Its labels replace the earlier `priority:` family and name the old labels in `aliases`, so a repository that has `priority:` labels has them renamed in place by the first sync after it regenerates `.github/labels.yaml` (see [Renaming a label](#renaming-a-label)).
+
 Names match case-insensitively, as GitHub matches them: `Bug` in the `labels` record replaces a preset's `bug`, and `Bug: null` removes it. A label takes the spelling of the last layer to write it.
 
 `description` is optional throughout, in a preset as in the `labels` record, and `sync-labels init` generates none for a scope label. The generated file spells an absent description `''` because `github-label-sync` reads an omitted description as "leave the label's current one alone"; the empty form clears it. Because a scope label without a description groups compactly in GitHub's label list, release-kit's readyup kit warns about each `scope:` label in the generated file that has one.
@@ -70,7 +72,7 @@ labels: {
 
 The sync renames an existing label that an alias names, in place, rather than deleting it and creating a new one, so the label stays on the issues and pull requests that have it. The dry-run **Label diff** lists the rename. When the repository has both the old name and the new one, the sync adds the new label to every issue and pull request that has the old one, then deletes the old label. A label that an alias names is not reported as undeclared.
 
-`aliases` is set only in the `labels` record, not in a preset, and it takes at least one name. Names match case-insensitively. An alias must not name a label that the config resolves, including the label that declares it, and must not appear twice: Either would make the sync merge one declared label into another and delete it. To rename a preset's label, remove it with `null` and alias it from the new entry:
+`aliases` is set in a preset or in the `labels` record, and it takes at least one name. A `labels` entry that replaces a preset's label replaces its aliases too, so an entry that restates such a label without them stops the rename. Names match case-insensitively. An alias must not name a label that the config resolves, including the label that declares it, and must not appear twice: Either would make the sync merge one declared label into another and delete it. To rename a preset's label, remove it with `null` and alias it from the new entry:
 
 ```typescript
 labels: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@williamthorsen/release-kit",
-  "version": "17.0.0",
+  "version": "18.0.0",
   "description": "Version-bumping and changelog-generation toolkit for release workflows",
   "keywords": [
     "changelog",
@@ -51,8 +51,8 @@
     "templates"
   ],
   "dependencies": {
-    "@williamthorsen/change-grammar": "0.3.1",
-    "@williamthorsen/nmr-core": "0.16.0",
+    "@williamthorsen/change-grammar": "0.4.0",
+    "@williamthorsen/nmr-core": "0.16.1",
     "@williamthorsen/toolbelt.errors": "0.9.0",
     "json-stringify-pretty-compact": "4.0.0",
     "semver": "7.8.6",
@@ -63,7 +63,7 @@
     "@types/semver": "7.8.0",
     "@williamthorsen/toolbelt.filesystem": "0.10.0",
     "@williamthorsen/toolbelt.testing": "0.8.0",
-    "@williamthorsen/toolbelt.vitest": "0.13.1",
+    "@williamthorsen/toolbelt.vitest": "0.13.2",
     "actionlint": "2.0.6",
     "esbuild": "0.28.2",
     "readyup": "0.45.0",

package/presets/labels/common.yaml

@@ -30,15 +30,19 @@
   color: fbca04
   description: Further information is needed
 
-# Priority
-- name: 'priority:critical'
+# Urgency
+- name: 'urgency:critical'
   color: b60205
-- name: 'priority:high'
+  aliases: ['priority:critical']
+- name: 'urgency:high'
   color: d93f0b
-- name: 'priority:medium'
+  aliases: ['priority:high']
+- name: 'urgency:medium'
   color: fbca04
-- name: 'priority:low'
+  aliases: ['priority:medium']
+- name: 'urgency:low'
   color: cfd3d7
+  aliases: ['priority:low']
 
 # Status
 - name: 'status:blocked'

package/dist/esm/resolveStyles.d.ts

@@ -1,10 +0,0 @@
-import { type StreamStyles } from '@williamthorsen/nmr-core';
-/** The environment variable that sets the caller's standing style preference: `auto`, `plain`, or `rich`. */
-export declare const OUTPUT_STYLE_ENV_VAR = "RELEASE_KIT_OUTPUT_STYLE";
-export interface ResolveStylesOptions {
-    readonly env: Readonly<Record<string, string | undefined>>;
-    readonly stderrIsTty: boolean;
-    readonly stdoutIsTty: boolean;
-}
-/** Resolves the style of each output stream, throwing a `UsageError` when the variable doesn't name a setting. */
-export declare function resolveStyles(options: ResolveStylesOptions): StreamStyles;

package/dist/esm/resolveStyles.js

@@ -1,10 +0,0 @@
-import { describeInvalidOutputStyle, resolveStreamStyles } from '@williamthorsen/nmr-core';
-import { UsageError } from '@williamthorsen/nmr-core/cli';
-export const OUTPUT_STYLE_ENV_VAR = 'RELEASE_KIT_OUTPUT_STYLE';
-export function resolveStyles(options) {
-    const { invalid, styles } = resolveStreamStyles({ ...options, envVar: OUTPUT_STYLE_ENV_VAR });
-    if (invalid !== undefined) {
-        throw new UsageError(describeInvalidOutputStyle(invalid));
-    }
-    return styles;
-}