@williamthorsen/release-kit 18.1.1 → 18.2.0

package/.readyup/kits/npm-auto-publish.js

@@ -1,6 +1,6 @@
 /** @noformat -- @generated. Do not edit. Compiled by rdy. */
 /* eslint-disable */
-export const __readyupVersion = "0.45.1";
+export const __readyupVersion = "0.46.2";
 
 
 // .readyup/kits/npm-auto-publish.ts

package/.readyup/manifest.json

@@ -3,20 +3,19 @@
   "kits": [
     {
       "bundledDependencies": {
-        "@williamthorsen/toolbelt.datetime": "4.1.2",
-        "@williamthorsen/toolbelt.errors": "0.9.1",
-        "@williamthorsen/toolbelt.filesystem": "0.10.1",
-        "@williamthorsen/toolbelt.numbers": "7.3.2",
-        "@williamthorsen/toolbelt.objects": "4.4.1",
-        "@williamthorsen/toolbelt.packaging": "0.7.1",
-        "@williamthorsen/toolbelt.terminal": "0.3.0",
+        "@williamthorsen/toolbelt.datetime": "4.1.4",
+        "@williamthorsen/toolbelt.errors": "0.10.1",
+        "@williamthorsen/toolbelt.filesystem": "0.10.3",
+        "@williamthorsen/toolbelt.numbers": "8.0.1",
+        "@williamthorsen/toolbelt.objects": "4.4.3",
+        "@williamthorsen/toolbelt.packaging": "0.7.3",
+        "@williamthorsen/toolbelt.terminal": "0.3.1",
         "ansi-regex": "6.6.0",
-        "ansi-styles": "6.2.3",
-        "cli-truncate": "6.1.1",
+        "ansi-styles": "6.2.3, 7.0.0",
+        "cli-truncate": "6.2.0",
         "diff": "9.0.0",
         "get-east-asian-width": "1.7.0",
-        "is-fullwidth-code-point": "5.1.0",
-        "slice-ansi": "9.0.1",
+        "slice-ansi": "10.0.1",
         "string-width": "8.3.0",
         "strip-ansi": "7.2.0",
         "wrap-ansi": "10.0.2"
@@ -26,7 +25,7 @@
           "checklist": "release-kit",
           "checks": [
             "@williamthorsen/release-kit in devDependencies",
-            "@williamthorsen/release-kit >= 18.1.1",
+            "@williamthorsen/release-kit >= 18.2.0",
             "release.yaml workflow exists",
             "release.yaml matches template",
             "release.yaml does not reference deprecated tag ref",
@@ -51,8 +50,7 @@
             "@changesets/cli not in devDependencies",
             "sync-labels.yaml workflow exists",
             "sync-labels.yaml matches template",
-            "sync-labels.yaml does not reference deprecated tag ref",
-            "retired .config/sync-labels.config.ts is absent"
+            "sync-labels.yaml does not reference deprecated tag ref"
           ]
         }
       ],
@@ -142,7 +140,7 @@
           "path": "../../nmr-core/dist/esm/timer.js"
         },
         {
-          "hash": "56566d0b",
+          "hash": "ee8d2dc8",
           "kind": "module",
           "path": "kits/default.ts"
         },
@@ -157,12 +155,17 @@
           "path": "lib/config-checks.ts"
         },
         {
-          "hash": "9a4023ad",
+          "hash": "70633d7f",
+          "kind": "module",
+          "path": "lib/template-checks.ts"
+        },
+        {
+          "hash": "ec55cfef",
           "kind": "module",
           "path": "lib/workflow-hashes.ts"
         },
         {
-          "hash": "73ff9801",
+          "hash": "ec16f961",
           "kind": "inline",
           "path": "../package.json",
           "paths": [
@@ -179,11 +182,31 @@
           "kind": "module",
           "path": "../src/init/detectRepoType.ts"
         },
+        {
+          "hash": "d360febf",
+          "kind": "module",
+          "path": "../src/init/hasProvenance.ts"
+        },
+        {
+          "hash": "3238f7e0",
+          "kind": "module",
+          "path": "../src/init/managed-workflows.ts"
+        },
         {
           "hash": "133be525",
           "kind": "module",
           "path": "../src/init/parseJsonRecord.ts"
         },
+        {
+          "hash": "5950f562",
+          "kind": "module",
+          "path": "../src/init/scaffold.ts"
+        },
+        {
+          "hash": "e10ddb57",
+          "kind": "module",
+          "path": "../src/init/templates.ts"
+        },
         {
           "hash": "2210df36",
           "kind": "module",
@@ -192,27 +215,26 @@
       ],
       "name": "default",
       "path": "kits/default.js",
-      "readyupVersion": "0.45.1",
+      "readyupVersion": "0.46.2",
       "source": "kits/default.ts",
-      "sourceHash": "56566d0b",
-      "targetHash": "b8e72e90"
+      "sourceHash": "ee8d2dc8",
+      "targetHash": "dfbfab4f"
     },
     {
       "bundledDependencies": {
-        "@williamthorsen/toolbelt.datetime": "4.1.2",
-        "@williamthorsen/toolbelt.errors": "0.9.1",
-        "@williamthorsen/toolbelt.filesystem": "0.10.1",
-        "@williamthorsen/toolbelt.numbers": "7.3.2",
-        "@williamthorsen/toolbelt.objects": "4.4.1",
-        "@williamthorsen/toolbelt.packaging": "0.7.1",
-        "@williamthorsen/toolbelt.terminal": "0.3.0",
+        "@williamthorsen/toolbelt.datetime": "4.1.4",
+        "@williamthorsen/toolbelt.errors": "0.10.1",
+        "@williamthorsen/toolbelt.filesystem": "0.10.3",
+        "@williamthorsen/toolbelt.numbers": "8.0.1",
+        "@williamthorsen/toolbelt.objects": "4.4.3",
+        "@williamthorsen/toolbelt.packaging": "0.7.3",
+        "@williamthorsen/toolbelt.terminal": "0.3.1",
         "ansi-regex": "6.6.0",
-        "ansi-styles": "6.2.3",
-        "cli-truncate": "6.1.1",
+        "ansi-styles": "6.2.3, 7.0.0",
+        "cli-truncate": "6.2.0",
         "diff": "9.0.0",
         "get-east-asian-width": "1.7.0",
-        "is-fullwidth-code-point": "5.1.0",
-        "slice-ansi": "9.0.1",
+        "slice-ansi": "10.0.1",
         "string-width": "8.3.0",
         "strip-ansi": "7.2.0",
         "wrap-ansi": "10.0.2"
@@ -345,10 +367,10 @@
       ],
       "name": "npm-auto-publish",
       "path": "kits/npm-auto-publish.js",
-      "readyupVersion": "0.45.1",
+      "readyupVersion": "0.46.2",
       "source": "kits/npm-auto-publish.ts",
       "sourceHash": "682fdd4a",
-      "targetHash": "884c7f0a"
+      "targetHash": "2bfaa0b5"
     }
   ]
 }

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable changes to this project will be documented in this file.
 
+## 18.2.0 — 2026-11-13
+
+### 🎉 Features
+
+- Changes `release-kit show-tag-prefixes` to print one block per target that lists the derived prefix and each declared legacy identity with their tag counts in aligned columns, and to print the "Undeclared tag prefixes" section on every run, showing `(none)` when the scan does not find any candidates. (#1332)
+- Adds a "Retired packages" section to `release-kit show-tag-prefixes`, which lists each entry declared in `retiredPackages` with its tag prefix, tag count, name, and successor. (#1332)
+- Adds a closing note to `release-kit show-tag-prefixes` when a derived prefix does not have any tags yet, which explains that `release-kit tag` creates the first tag from the tags file that `release-kit prepare` writes. (#1332)
+- Makes the template checks for `release.yaml`, `publish.yaml`, and `create-github-release.yaml` report the differing hunks, and distinguish a missing file from an unreadable one, rather than report only that a hash differs. (#1336)
+
+### 🪦 Removed
+
+- Removes the check for the retired `.config/sync-labels.config.ts`, which made `sync-labels init`, `generate`, and `sync` exit with an error and made the release-kit readyup kit fail while the file existed. (#1333)
+
+### 🐛 Bug fixes
+
+- Fixes the issue that `release-kit`'s ReadyUp kit reported the warning `releaseNotes.shouldInjectIntoReadme is true`, which the consumer could not clear, in a repo without any publishable package, by making the check skip with the reason `no publishable packages`. (#1334)
+- Fixes the issue that the `publish.yaml matches template` check in `rdy run --from npm:@williamthorsen/release-kit` failed a `publish.yaml` that omits provenance, a setting that `release-kit update-templates` preserves. (#1336)
+
 ## 18.1.1 — 2026-11-12
 
 ### ⚙️ Tooling

package/README.md

@@ -6,7 +6,25 @@ Version-bumping and changelog-generation toolkit for release workflows.
 
 Provides a self-contained CLI that auto-discovers workspaces from `pnpm-workspace.yaml`, parses conventional commits, determines version bumps, updates `package.json` files, and generates changelogs from the same commit history that decides each bump (with optional [editorial overrides](docs/editorial-overrides.md)).
 
-<!-- section:release-notes --><!-- /section:release-notes -->
+<!-- section:release-notes -->
+## Release notes — v18.2.0 (2026-11-13)
+
+### 🎉 Features
+
+- Changes `release-kit show-tag-prefixes` to print one block per target that lists the derived prefix and each declared legacy identity with their tag counts in aligned columns, and to print the "Undeclared tag prefixes" section on every run, showing `(none)` when the scan does not find any candidates. (#1332)
+- Adds a "Retired packages" section to `release-kit show-tag-prefixes`, which lists each entry declared in `retiredPackages` with its tag prefix, tag count, name, and successor. (#1332)
+- Adds a closing note to `release-kit show-tag-prefixes` when a derived prefix does not have any tags yet, which explains that `release-kit tag` creates the first tag from the tags file that `release-kit prepare` writes. (#1332)
+- Makes the template checks for `release.yaml`, `publish.yaml`, and `create-github-release.yaml` report the differing hunks, and distinguish a missing file from an unreadable one, rather than report only that a hash differs. (#1336)
+
+### 🪦 Removed
+
+- Removes the check for the retired `.config/sync-labels.config.ts`, which made `sync-labels init`, `generate`, and `sync` exit with an error and made the release-kit readyup kit fail while the file existed. (#1333)
+
+### 🐛 Bug fixes
+
+- Fixes the issue that `release-kit`'s ReadyUp kit reported the warning `releaseNotes.shouldInjectIntoReadme is true`, which the consumer could not clear, in a repo without any publishable package, by making the check skip with the reason `no publishable packages`. (#1334)
+- Fixes the issue that the `publish.yaml matches template` check in `rdy run --from npm:@williamthorsen/release-kit` failed a `publish.yaml` that omits provenance, a setting that `release-kit update-templates` preserves. (#1336)
+<!-- /section:release-notes -->
 
 ## Installation
 

package/dist/esm/cli/maintenanceCommands.js

@@ -12,7 +12,7 @@ import { CONFIG_FLAG, runReportingFailures } from "./commandKit.js";
 const { defineCommand, defineGroup } = createCli();
 export const showTagPrefixes = defineCommand({
     summary: 'Show derived and declared legacy tag prefixes per workspace',
-    description: 'Print a per-workspace table of derived tag prefixes, tag counts, and declared legacy tag prefixes. Reports any release-shaped tags whose prefix is neither a derived prefix nor declared in `legacyIdentities`, with a copy-pasteable config snippet.',
+    description: 'Print one block per workspace with its derived tag prefix, declared legacy identities, and tag counts, followed by the declared retired packages. Reports any release-shaped tags whose prefix is neither derived nor declared, with a copy-pasteable config snippet.',
     flags: CONFIG_FLAG,
     run: ({ flags, context }) => runReportingFailures(context.styles, () => {
         enterRepoRoot();

package/dist/esm/init/managed-workflows.d.ts

@@ -0,0 +1,10 @@
+import type { RepoType } from './detectRepoType.js';
+/** Renders the create-github-release workflow that the repo should contain. */
+export declare function renderExpectedCreateGithubReleaseWorkflow(repoType: RepoType): string;
+/**
+ * Renders the publish workflow that the repo should contain, keeping the provenance setting of the existing
+ * `publish.yaml` and enabling provenance when the file is missing.
+ */
+export declare function renderExpectedPublishWorkflow(repoType: RepoType): string;
+/** Renders the release workflow that the repo should contain. */
+export declare function renderExpectedReleaseWorkflow(repoType: RepoType): string;

package/dist/esm/init/managed-workflows.js

@@ -0,0 +1,18 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { hasProvenance } from "./hasProvenance.js";
+import { PUBLISH_WORKFLOW_PATH } from "./scaffold.js";
+import { renderCreateGithubReleaseWorkflow, renderPublishWorkflow, renderReleaseWorkflow } from "./templates.js";
+export function renderExpectedCreateGithubReleaseWorkflow(repoType) {
+    return renderCreateGithubReleaseWorkflow(repoType);
+}
+export function renderExpectedPublishWorkflow(repoType) {
+    return renderPublishWorkflow(repoType, { shouldGenerateProvenance: readProvenanceSetting() });
+}
+export function renderExpectedReleaseWorkflow(repoType) {
+    return renderReleaseWorkflow(repoType);
+}
+function readProvenanceSetting() {
+    if (!existsSync(PUBLISH_WORKFLOW_PATH))
+        return true;
+    return hasProvenance(readFileSync(PUBLISH_WORKFLOW_PATH, 'utf8'));
+}

package/dist/esm/init/updateTemplatesCommand.js

@@ -1,13 +1,12 @@
-import { existsSync, readFileSync } from 'node:fs';
+import { existsSync } from 'node:fs';
 import { isAnticipatedFailure, printError, printSkip, printStep, printSuccess, reportTemplateUpdate, updateManagedFile, } from '@williamthorsen/nmr-core';
 import { describeError } from '@williamthorsen/toolbelt.errors';
 import { readSyncLabelsWorkflowTemplate } from "../sync-labels/templates.js";
 import { detectRepoType } from "./detectRepoType.js";
-import { hasProvenance } from "./hasProvenance.js";
 import { formatPrivateWorkflowSkip, hasPublishablePackage } from "./hasPublishablePackage.js";
 import { checkEligibility } from "./initCommand.js";
+import { renderExpectedCreateGithubReleaseWorkflow, renderExpectedPublishWorkflow, renderExpectedReleaseWorkflow, } from "./managed-workflows.js";
 import { CREATE_GITHUB_RELEASE_WORKFLOW_PATH, PUBLISH_WORKFLOW_PATH, PUBLISHING_WORKFLOW_PATHS } from "./scaffold.js";
-import { renderCreateGithubReleaseWorkflow, renderPublishWorkflow, renderReleaseWorkflow } from "./templates.js";
 const SYNC_LABELS_WORKFLOW_PATH = '.github/workflows/sync-labels.yaml';
 export function updateTemplatesCommand({ isDryRun, styles }) {
     if (isDryRun) {
@@ -65,17 +64,12 @@ function buildManagedFiles(repoType, publishable) {
         ? []
         : PUBLISHING_WORKFLOW_PATHS.filter((filePath) => !existsSync(filePath));
     const files = [
-        [CREATE_GITHUB_RELEASE_WORKFLOW_PATH, renderCreateGithubReleaseWorkflow(repoType)],
-        [PUBLISH_WORKFLOW_PATH, renderPublishWorkflow(repoType, { shouldGenerateProvenance: readProvenanceSetting() })],
-        ['.github/workflows/release.yaml', renderReleaseWorkflow(repoType)],
+        [CREATE_GITHUB_RELEASE_WORKFLOW_PATH, renderExpectedCreateGithubReleaseWorkflow(repoType)],
+        [PUBLISH_WORKFLOW_PATH, renderExpectedPublishWorkflow(repoType)],
+        ['.github/workflows/release.yaml', renderExpectedReleaseWorkflow(repoType)],
     ];
     if (existsSync(SYNC_LABELS_WORKFLOW_PATH)) {
         files.push([SYNC_LABELS_WORKFLOW_PATH, readSyncLabelsWorkflowTemplate()]);
     }
     return { files: files.filter(([filePath]) => !skippedPaths.includes(filePath)), skippedPaths };
 }
-function readProvenanceSetting() {
-    if (!existsSync(PUBLISH_WORKFLOW_PATH))
-        return true;
-    return hasProvenance(readFileSync(PUBLISH_WORKFLOW_PATH, 'utf8'));
-}

package/dist/esm/previewTagPrefixes.d.ts

@@ -6,6 +6,11 @@ export interface TagPrefixPreviewRow {
     workspacePath: string;
     /** Directory basename (e.g., `core`). */
     dir: string;
+    /**
+     * The workspace's `package.json` name or the directory target's `releases` key; `null` when a workspace's derivation
+     * failed.
+     */
+    name: string | null;
     /** The derived tag prefix, or `null` when derivation failed. */
     derivedPrefix: string | null;
     /** Human-readable reason derivation failed, or `null` when it succeeded. */
@@ -15,8 +20,9 @@ export interface TagPrefixPreviewRow {
     /** One entry per declared legacy prefix, with its current tag count. */
     legacyEntries: LegacyTagPrefixEntry[];
 }
-/** A single declared legacy prefix and its tag count. */
+/** A single declared legacy identity's prefix and its tag count. */
 export interface LegacyTagPrefixEntry {
+    name: string;
     prefix: string;
     tagCount: number;
 }

package/dist/esm/previewTagPrefixes.js

@@ -17,7 +17,7 @@ export function previewTagPrefixes(config) {
     const workspacePaths = workspace.kind === 'packages' ? workspace.packageDirs : [];
     const overridesByPath = buildOverrideMap(config, workspacePaths);
     const workspaces = [
-        ...Array.from(workspacePaths, (workspacePath) => buildPreviewRow(workspacePath, () => deriveWorkspaceConfig(workspacePath).tagPrefix, overridesByPath)),
+        ...Array.from(workspacePaths, (workspacePath) => buildPreviewRow(workspacePath, null, () => deriveWorkspaceConfig(workspacePath), overridesByPath)),
         ...buildDirectoryRows(config, workspacePaths, overridesByPath),
     ];
     const retiredPackages = buildRetiredPreviewEntries(config?.retiredPackages ?? []);
@@ -59,15 +59,18 @@ function buildDirectoryRows(config, workspacePaths, overridesByPath) {
             path: directoryPath,
             ...(entry.tagPrefix !== undefined && { tagPrefix: entry.tagPrefix }),
         };
-        return [buildPreviewRow(directoryPath, () => deriveDirectoryConfig(declaredDirectory).tagPrefix, overridesByPath)];
+        return [buildPreviewRow(directoryPath, name, () => deriveDirectoryConfig(declaredDirectory), overridesByPath)];
     });
 }
-function buildPreviewRow(workspacePath, derivePrefix, overridesByPath) {
+function buildPreviewRow(workspacePath, knownName, deriveTarget, overridesByPath) {
     const dir = basename(workspacePath);
+    let name = knownName;
     let derivedPrefix = null;
     let derivationError = null;
     try {
-        derivedPrefix = derivePrefix();
+        const target = deriveTarget();
+        name = target.name;
+        derivedPrefix = target.tagPrefix;
     }
     catch (error) {
         derivationError = describeError(error);
@@ -75,12 +78,14 @@ function buildPreviewRow(workspacePath, derivePrefix, overridesByPath) {
     const derivedTagCount = derivedPrefix === null ? 0 : countTagsMatching(derivedPrefix);
     const declaredIdentities = overridesByPath.get(workspacePath) ?? [];
     const legacyEntries = declaredIdentities.map((identity) => ({
+        name: identity.name,
         prefix: identity.tagPrefix,
         tagCount: countTagsMatching(identity.tagPrefix),
     }));
     return {
         workspacePath,
         dir,
+        name,
         derivedPrefix,
         derivationError,
         derivedTagCount,

package/dist/esm/showTagPrefixesCommand.d.ts

@@ -2,11 +2,11 @@ import { type StreamStyles } from '@williamthorsen/nmr-core';
 /**
  * Runs the CLI `show-tag-prefixes` command and returns its exit code.
  *
- * Prints a per-workspace table of derived prefixes, tag counts, and declared legacy entries, followed by an
- * "Undeclared tag prefixes" section when candidate-shaped tags exist outside the known set. Returns `1` on any
- * derivation failure or collision and `0` otherwise; undeclared candidates do not affect the exit code. When a config
- * exists and either fails to load or fails validation, the command reports it to stderr and returns `1` in both repo
- * modes, because a default-config preview would understate the declared legacy prefixes. When the default config is
- * absent, the command previews against derived defaults.
+ * Prints one block per target, with its derived prefix and declared legacy identities and their tag counts, then the
+ * declared retired packages, the candidate-shaped tags outside the known set, and a footer on creating the first tag
+ * when a target does not have any. Returns `1` on any derivation failure or collision and `0` otherwise; undeclared
+ * candidates do not affect the exit code. When a config exists and either fails to load or fails validation, the
+ * command reports it to stderr and returns `1` in both repo modes, because a default-config preview would understate
+ * the declared legacy prefixes. When the default config is absent, the command previews against derived defaults.
  */
 export declare function showTagPrefixesCommand(styles: StreamStyles, configPath?: string): Promise<number>;

package/dist/esm/showTagPrefixesCommand.js

@@ -2,7 +2,7 @@ import { formatStatusLine, isAnticipatedFailure, reportError, } from '@williamth
 import { BIN } from "./bin.js";
 import { detectRepoType } from "./init/detectRepoType.js";
 import { loadValidatedConfig, reportConfigProblem } from "./loadValidatedConfig.js";
-import { previewTagPrefixes } from "./previewTagPrefixes.js";
+import { previewTagPrefixes, } from "./previewTagPrefixes.js";
 export async function showTagPrefixesCommand(styles, configPath) {
     const result = await loadValidatedConfig(configPath);
     if (result.status === 'invalid') {
@@ -27,59 +27,114 @@ export async function showTagPrefixesCommand(styles, configPath) {
     process.stdout.write(renderMonorepo(preview, styles.stdout));
     return computeExitCode(preview);
 }
-function renderSinglePackage() {
-    const lines = [
-        'Workspace   Derived prefix   Status',
-        '.           v                (single-package mode)',
-        '',
-    ];
-    return lines.join('\n');
+const LABEL_WIDTH = 'legacy identity'.length;
+const FIRST_TAG_FOOTER = 'A workspace marked "no derived tags yet" has not been released under its derived prefix. `release-kit tag` creates its first tag from the tags file that `release-kit prepare` writes.';
+function computeExitCode(preview) {
+    const hasDerivationFailure = preview.workspaces.some((row) => row.derivedPrefix === null);
+    const hasCollision = preview.collisions.length > 0;
+    return hasDerivationFailure || hasCollision ? 1 : 0;
+}
+function formatPrefixColumns(columns, prefix, tagCount, note) {
+    const cells = `${prefix.padEnd(columns.prefixWidth)}  ${String(tagCount).padStart(columns.countDigits)} tags`;
+    return note === undefined ? cells : `${cells}  ${note}`;
+}
+function formatRow(label, body) {
+    return `  ${label.padEnd(LABEL_WIDTH)}   ${body}`;
+}
+function measureColumns(preview) {
+    const entries = preview.retiredPackages.map((entry) => ({
+        prefix: entry.tagPrefix,
+        tagCount: entry.tagCount,
+    }));
+    for (const row of preview.workspaces) {
+        if (row.derivedPrefix !== null)
+            entries.push({ prefix: row.derivedPrefix, tagCount: row.derivedTagCount });
+        entries.push(...row.legacyEntries);
+    }
+    return {
+        prefixWidth: Math.max(0, ...entries.map((entry) => entry.prefix.length)),
+        countDigits: Math.max(1, ...entries.map((entry) => String(entry.tagCount).length)),
+    };
 }
 function renderMonorepo(preview, style) {
-    const lines = ['Workspace tag prefixes:', ''];
+    const columns = measureColumns(preview);
+    const lines = ['Workspace tag prefixes'];
     for (const row of preview.workspaces) {
-        lines.push(...renderWorkspaceRow(row, style));
+        lines.push('', ...renderTargetBlock(row, preview.collisions, columns, style));
     }
-    if (preview.collisions.length > 0) {
-        lines.push('', ...preview.collisions.map((collision) => formatStatusLine(style, 'failed', `tag prefix collision: '${collision.tagPrefix}' used by ${collision.workspacePaths.join(', ')}`)));
+    if (preview.retiredPackages.length > 0) {
+        lines.push('', 'Retired packages', '', ...renderRetiredLines(preview.retiredPackages, columns, style));
     }
-    if (preview.undeclaredCandidates.length > 0) {
-        lines.push('', 'Undeclared tag prefixes:', '', ...preview.undeclaredCandidates.map((candidate) => `  '${candidate.prefix}': ${candidate.tagCount} tags (e.g., ${candidate.exampleTags.join(', ')})`), '', 'Suggested config snippet (adjust `dir` to match the workspace if the guess is wrong, and replace the `name` placeholder with the legacy npm name):', '', renderSuggestedSnippet(preview.undeclaredCandidates), '', "If the suggested `dir` does not match the workspace, adjust it before pasting. Each legacy identity requires a `name`: Replace the `TODO-fill-in-legacy-npm-name` placeholder with the package's prior npm name.");
+    lines.push('', 'Undeclared tag prefixes', '', ...renderUndeclaredSection(preview.undeclaredCandidates, style));
+    if (preview.workspaces.some((row) => row.derivedPrefix !== null && row.derivedTagCount === 0)) {
+        lines.push('', formatStatusLine(style, 'info', FIRST_TAG_FOOTER));
     }
     lines.push('');
     return lines.join('\n');
 }
-function renderWorkspaceRow(row, style) {
-    const lines = [];
+function renderRetiredLines(retiredPackages, columns, style) {
+    return retiredPackages.map((entry) => {
+        const identity = entry.successor === undefined ? entry.name : `${entry.name}, successor: ${entry.successor}`;
+        const status = entry.tagCount > 0 ? 'passed' : 'warning';
+        return `  ${formatStatusLine(style, status, formatPrefixColumns(columns, entry.tagPrefix, entry.tagCount, identity))}`;
+    });
+}
+function renderSinglePackage() {
+    const lines = [
+        'Workspace tag prefixes',
+        '',
+        '. (single-package mode)',
+        formatRow('derived prefix', 'v'),
+        '',
+    ];
+    return lines.join('\n');
+}
+function renderSuggestedSnippet(candidates) {
+    const entries = candidates
+        .map((candidate) => `    { dir: '${candidate.suggestedDir}', legacyIdentities: [{ name: 'TODO-fill-in-legacy-npm-name', tagPrefix: '${candidate.prefix}' }] },`)
+        .join('\n');
+    return `  workspaces: [\n${entries}\n  ],`;
+}
+function renderTargetBlock(row, collisions, columns, style) {
+    const lines = [row.name === null ? row.workspacePath : `${row.workspacePath} (${row.name})`];
     if (row.derivedPrefix === null) {
         const failure = formatStatusLine(style, 'failed', `derivation failed: ${row.derivationError ?? 'unknown error'}`);
-        lines.push(`  ${row.workspacePath}: ${failure}`);
+        lines.push(formatRow('derived prefix', failure));
         return lines;
     }
-    const statusMarker = row.derivedTagCount > 0
-        ? formatStatusLine(style, 'passed', `${row.derivedTagCount} tags`)
-        : formatStatusLine(style, 'warning', 'no existing tags');
-    lines.push(`  ${row.workspacePath}: derived prefix '${row.derivedPrefix}', ${statusMarker}`);
+    const collidingPaths = collisions
+        .filter((collision) => collision.tagPrefix === row.derivedPrefix)
+        .flatMap((collision) => collision.workspacePaths)
+        .filter((path) => path !== row.workspacePath);
+    let derivedStatus = 'passed';
+    let derivedNote;
+    if (collidingPaths.length > 0) {
+        derivedStatus = 'failed';
+        derivedNote = `collides with ${collidingPaths.join(', ')}`;
+    }
+    else if (row.derivedTagCount === 0) {
+        derivedStatus = 'warning';
+        derivedNote = 'no derived tags yet';
+    }
+    const derivedCells = formatPrefixColumns(columns, row.derivedPrefix, row.derivedTagCount, derivedNote);
+    lines.push(formatRow('derived prefix', formatStatusLine(style, derivedStatus, derivedCells)));
     for (const entry of row.legacyEntries) {
-        if (entry.tagCount > 0) {
-            const recognizedMessage = `${entry.tagCount} legacy tags with '${entry.prefix}' prefix (recognized)`;
-            lines.push(`      ${formatStatusLine(style, 'passed', recognizedMessage)}`);
-        }
-        else {
-            const taglessMessage = `recorded legacy prefix '${entry.prefix}' does not have any tags`;
-            lines.push(`      ${formatStatusLine(style, 'warning', taglessMessage)}`);
-        }
+        const status = entry.tagCount > 0 ? 'passed' : 'warning';
+        const legacyCells = formatPrefixColumns(columns, entry.prefix, entry.tagCount, entry.name);
+        lines.push(formatRow('legacy identity', formatStatusLine(style, status, legacyCells)));
     }
     return lines;
 }
-function renderSuggestedSnippet(candidates) {
-    const entries = candidates
-        .map((candidate) => `    { dir: '${candidate.suggestedDir}', legacyIdentities: [{ name: 'TODO-fill-in-legacy-npm-name', tagPrefix: '${candidate.prefix}' }] },`)
-        .join('\n');
-    return `  workspaces: [\n${entries}\n  ],`;
-}
-function computeExitCode(preview) {
-    const hasDerivationFailure = preview.workspaces.some((row) => row.derivedPrefix === null);
-    const hasCollision = preview.collisions.length > 0;
-    return hasDerivationFailure || hasCollision ? 1 : 0;
+function renderUndeclaredSection(candidates, style) {
+    if (candidates.length === 0)
+        return ['  (none)'];
+    return [
+        ...candidates.map((candidate) => `  ${formatStatusLine(style, 'warning', `'${candidate.prefix}': ${candidate.tagCount} tags (e.g., ${candidate.exampleTags.join(', ')})`)}`),
+        '',
+        'Suggested config snippet (adjust `dir` to match the workspace if the guess is wrong, and replace the `name` placeholder with the legacy npm name):',
+        '',
+        renderSuggestedSnippet(candidates),
+        '',
+        "If the suggested `dir` does not match the workspace, adjust it before pasting. Each legacy identity requires a `name`: Replace the `TODO-fill-in-legacy-npm-name` placeholder with the package's prior npm name.",
+    ];
 }

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

@@ -8,7 +8,6 @@ import { CONFIG_FILE_PATH } from "../loadConfig.js";
 import { loadValidatedConfig, reportConfigProblem } from "../loadValidatedConfig.js";
 import { hashPreset } 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, configFilePath = CONFIG_FILE_PATH) {
     const headerLines = ['# Generated by release-kit sync-labels — do not edit.', `# Source: ${configFilePath}`];
@@ -43,9 +42,6 @@ export async function loadRepoLabelsConfig(stderrStyle, configPath) {
     return result.config.repoLabels;
 }
 export async function generateCommand({ shouldCheck = false, configPath, styles }) {
-    if (checkRetiredSyncLabelsConfig(configPath)) {
-        return 1;
-    }
     const repoLabels = await loadRepoLabelsConfig(styles.stderr, configPath);
     if (repoLabels === undefined) {
         return 1;

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

@@ -5,14 +5,10 @@ import { describeEmptyWorkspace, discoverWorkspaces } from "../discoverWorkspace
 import { CONFIG_FILE_PATH } from "../loadConfig.js";
 import { loadValidatedConfig, reportConfigProblem } from "../loadValidatedConfig.js";
 import { generateCommand, LABELS_OUTPUT_PATH } from "./generateCommand.js";
-import { checkRetiredSyncLabelsConfig } from "./retiredConfig.js";
 import { buildScopeLabels, readSyncLabelsWorkflowTemplate, renderRepoLabelsBlock, renderRepoLabelsConfigScript, } from "./templates.js";
 const WORKFLOW_PATH = '.github/workflows/sync-labels.yaml';
 export async function syncLabelsInitCommand({ configPath, isDryRun, shouldForce, styles, }) {
     const configFilePath = configPath ?? CONFIG_FILE_PATH;
-    if (checkRetiredSyncLabelsConfig(configPath)) {
-        return 1;
-    }
     if (isDryRun) {
         console.info('[dry-run mode]');
     }

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

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