@williamthorsen/release-kit 10.5.0 → 10.6.0

package/.readyup/kits/default.js

@@ -50,9 +50,55 @@ function detectRepoType() {
   return "single-package";
 }
 
+// src/packsPath.ts
+function packsPath(filesField, path) {
+  if (!isStringArray(filesField)) return true;
+  const prefixes = listAncestorPrefixes(path);
+  return filesField.some((entry) => {
+    const pattern = compileEntry(entry);
+    return pattern !== void 0 && prefixes.some((prefix) => pattern.test(prefix));
+  });
+}
+var GLOB_TOKEN_PATTERN = /\*\*\/|\*\*|\*|\?|[^*?]+/g;
+function compileEntry(entry) {
+  if (entry.startsWith("!")) return void 0;
+  const normalized = entry.replace(/^\.?\//, "").replace(/\/+$/, "");
+  if (normalized === "") return void 0;
+  return new RegExp(`^${translateGlob(normalized)}$`);
+}
+function isStringArray(value) {
+  return Array.isArray(value) && value.every((entry) => typeof entry === "string");
+}
+function listAncestorPrefixes(path) {
+  const segments = path.split("/");
+  return segments.map((_segment, index) => segments.slice(0, index + 1).join("/"));
+}
+function translateGlob(pattern) {
+  let source = "";
+  for (const [token] of pattern.matchAll(GLOB_TOKEN_PATTERN)) {
+    switch (token) {
+      case "**/":
+        source += String.raw`(?:[^/]*\/)*`;
+        break;
+      case "**":
+        source += ".*";
+        break;
+      case "*":
+        source += "[^/]*";
+        break;
+      case "?":
+        source += "[^/]";
+        break;
+      default:
+        source += RegExp.escape(token);
+    }
+  }
+  return source;
+}
+
 // .readyup/kits/default.ts
 function getMinVersion() {
-  const picked = { "version": "10.5.0" };
+  const picked = { "version": "10.6.0" };
   if (typeof picked["version"] !== "string") {
     throw new TypeError("release-kit/package.json: 'version' must be a string");
   }
@@ -61,6 +107,7 @@ function getMinVersion() {
 function hasPublishablePackages() {
   return discoverWorkspaces({ filter: (w) => w.isPackage }).length > 0;
 }
+var DEFAULT_CHANGELOG_JSON_PATH = ".meta/changelog.json";
 var CONFIG_EXPORT_PATTERNS = [
   /export\s+default\b/,
   /export\s+(?:const|let|var)\s+config\b/,
@@ -204,6 +251,32 @@ var default_default = defineRdyKit({
             }
           ]
         },
+        // Deliberately outside the config gate above: that check skips where the config file is absent, and a repo
+        // with no config file still defaults `changelogJson.enabled` to true and still publishes tarballs.
+        {
+          name: "published packages ship CHANGELOG.md",
+          severity: "warn",
+          skip: () => !hasPublishablePackages() ? "no publishable packages" : false,
+          check: () => packagesShipChangelog(),
+          fix: 'Add "CHANGELOG.md" to the files field of each affected package.json'
+        },
+        {
+          name: "changelog.json generation is enabled",
+          severity: "recommend",
+          skip: () => !hasPublishablePackages() ? "no publishable packages" : false,
+          check: () => changelogJsonIsEnabled(),
+          fix: "Remove changelogJson.enabled: false from .config/release-kit.config.ts so release-kit writes the machine-readable changelog that upgrade tooling reads before CHANGELOG.md",
+          checks: [
+            {
+              name: "published packages ship the changelog JSON",
+              severity: "warn",
+              check: () => packagesShipChangelogJson(),
+              get fix() {
+                return `Add "${resolveChangelogJsonOutputPath()}" to the files field of each affected package.json`;
+              }
+            }
+          ]
+        },
         {
           name: "config does not use removed releaseNotes.shouldCreateGithubRelease",
           severity: "error",
@@ -264,6 +337,11 @@ var default_default = defineRdyKit({
     }
   ]
 });
+function changelogJsonIsEnabled() {
+  const content = readFile(".config/release-kit.config.ts");
+  if (content === void 0) return true;
+  return !/changelogJson\s*:\s*\{[^}]*enabled\s*:\s*false/.test(content);
+}
 function configFileExportsConfig() {
   const content = readFile(".config/release-kit.config.ts");
   if (content === void 0) return false;
@@ -276,6 +354,12 @@ function labelsHaveCurrentPresetHash(presetName, expectedHash) {
   const match = pattern.exec(content);
   return match !== null && match[1] === expectedHash;
 }
+function packagesShipChangelog() {
+  return reportWorkspacesOmitting("CHANGELOG.md");
+}
+function packagesShipChangelogJson() {
+  return reportWorkspacesOmitting(resolveChangelogJsonOutputPath());
+}
 function readmeHasReleaseNotesMarkers(content) {
   return content.includes("<!-- section:release-notes -->") && content.includes("<!-- /section:release-notes -->");
 }
@@ -308,16 +392,41 @@ function releaseNotesInjectsIntoReadme() {
   if (content === void 0) return false;
   return /shouldInjectIntoReadme\s*:\s*true/.test(content);
 }
+function reportWorkspacesOmitting(path) {
+  const failing = [];
+  const packageWorkspaces = discoverWorkspaces({ filter: (w) => w.isPackage });
+  for (const { dir, packageJson } of packageWorkspaces) {
+    if (!packsPath(packageJson["files"], path)) {
+      failing.push(dir === "." ? "package.json" : `${dir}/package.json`);
+    }
+  }
+  if (failing.length === 0) return true;
+  return {
+    ok: false,
+    detail: `files field omits ${path}: ${failing.join(", ")}`
+  };
+}
+function resolveChangelogJsonOutputPath() {
+  const content = readFile(".config/release-kit.config.ts");
+  if (content === void 0) return DEFAULT_CHANGELOG_JSON_PATH;
+  const match = /changelogJson\s*:\s*\{[^}]*outputPath\s*:\s*['"]([^'"]+)['"]/.exec(content);
+  return match?.[1] ?? DEFAULT_CHANGELOG_JSON_PATH;
+}
 export {
   CLIFF_TEMPLATE_HASH,
   COMMON_PRESET_HASH,
+  DEFAULT_CHANGELOG_JSON_PATH,
   PUBLISH_WORKFLOW_HASH_MONOREPO,
   PUBLISH_WORKFLOW_HASH_SINGLE,
   RELEASE_WORKFLOW_HASH_MONOREPO,
   RELEASE_WORKFLOW_HASH_SINGLE,
   SYNC_LABELS_WORKFLOW_HASH,
+  changelogJsonIsEnabled,
   configFileExportsConfig,
   default_default as default,
+  packagesShipChangelog,
+  packagesShipChangelogJson,
   readmeHasReleaseNotesMarkers,
-  readmesHaveReleaseNotesMarkers
+  readmesHaveReleaseNotesMarkers,
+  resolveChangelogJsonOutputPath
 };

package/.readyup/manifest.json

@@ -8,12 +8,12 @@
       "esbuildVersion": "0.28.2",
       "inputs": [
         {
-          "hash": "c948b179",
+          "hash": "4a359cc9",
           "kind": "module",
           "path": "kits/default.ts"
         },
         {
-          "hash": "221d9444",
+          "hash": "bb217228",
           "kind": "inline",
           "path": "../package.json",
           "paths": [
@@ -30,6 +30,11 @@
           "kind": "module",
           "path": "../src/init/parseJsonRecord.ts"
         },
+        {
+          "hash": "b798d024",
+          "kind": "module",
+          "path": "../src/packsPath.ts"
+        },
         {
           "hash": "646fe51b",
           "kind": "module",
@@ -40,8 +45,8 @@
       "path": "kits/default.js",
       "readyupVersion": "0.35.0",
       "source": "kits/default.ts",
-      "sourceHash": "c948b179",
-      "targetHash": "08e4eb5a"
+      "sourceHash": "4a359cc9",
+      "targetHash": "5b3e6dcf"
     },
     {
       "checklists": [

package/CHANGELOG.md

@@ -2,6 +2,43 @@
 
 All notable changes to this project will be documented in this file.
 
+## 10.6.0 — 2026-09-08
+
+### 🎉 Features
+
+- Report a package whose tarball would omit its changelog (#768)
+
+  Adds ReadyUp checks to verify that every published package bundles its changelog files: the human-readable `CHANGELOG.md` and the machine-readable `changelog.json`.
+
+- Add a migration field to changelog.json items (#770)
+
+  Adds an optional `migration` field to entries in the `.meta/changelog.json` that `release-kit` generates. If a commit body contains a labeled migration step, that content is copied to the `migration` field.
+
+### 🐛 Bug fixes
+
+- Pin git-cliff and remove the per-run npx cache refresh (#776)
+
+  Fixes an issue where git-cliff's version was unpinned, resulting in a per-run cache refresh. An exact version is now pinned.
+
+  Removes the per-run cache refresh, which re-ran `npx` without `--prefer-offline` once per prepare and forced a registry round trip. An exact version leaves npm nothing to revalidate, so a prepare run no longer waits on registry latency.
+
+  Also silences git-cliff's INFO output, in particular the crates.io update notice.
+
+### ♻️ Refactoring
+
+- Remove the unwired isChangelogItem type guard (#771)
+
+  Removes the unused `isChangelogItem` from `release-kit`'s `changelogJsonUtils.ts`, together with its tests.
+
+  Documentation is updated to record the boundary on `isChangelogEntry`: Entries parsed from `.meta/changelog.json` are shape-checked at the top level only, and strict validation applies only to the human-authored `.meta/changelog-overrides.json`.
+
+### 🧪 Tests
+
+- Read console spy output with listConsoleLines rather than by hand (#781)
+
+  - Replaces the hand-rolled reads of a console spy's `mock.calls` in the `nmr`, `release-kit`, and `v11y-check` test suites with `listConsoleLines` from `@williamthorsen/toolbelt.vitest/candidate`.
+  - Clears the `toolbelt.vitest/no-console-calls-read` recommendation that `rdy run --packages` reported.
+
 ## 10.5.0 — 2026-09-01
 
 ### 🎉 Features

package/README.md

@@ -5,13 +5,27 @@ Version-bumping and changelog-generation toolkit for release workflows.
 Provides a self-contained CLI that auto-discovers workspaces from `pnpm-workspace.yaml`, parses conventional commits, determines version bumps, updates `package.json` files, and generates changelogs from `git-cliff --context` output rendered in-process (with optional [editorial overrides](#editorial-overrides)).
 
 <!-- section:release-notes -->
-## Release notes — v10.5.0 (2026-09-01)
+## Release notes — v10.6.0 (2026-09-08)
 
 ### 🎉 Features
 
-- Report a consuming repo that still declares @changesets/cli (#764)
+- Report a package whose tarball would omit its changelog (#768)
 
-  Adds a check to the default ReadyUp kit in `@williamthorsen/release-kit` that reports a repo still declaring `@changesets/cli`, the release tool superseded by release-kit. The check reports at `recommend` severity; its fix directs the consumer to remove the dependency together with the `.changeset/` directory and any `changeset:*` scripts.
+  Adds ReadyUp checks to verify that every published package bundles its changelog files: the human-readable `CHANGELOG.md` and the machine-readable `changelog.json`.
+
+- Add a migration field to changelog.json items (#770)
+
+  Adds an optional `migration` field to entries in the `.meta/changelog.json` that `release-kit` generates. If a commit body contains a labeled migration step, that content is copied to the `migration` field.
+
+### 🐛 Bug fixes
+
+- Pin git-cliff and remove the per-run npx cache refresh (#776)
+
+  Fixes an issue where git-cliff's version was unpinned, resulting in a per-run cache refresh. An exact version is now pinned.
+
+  Removes the per-run cache refresh, which re-ran `npx` without `--prefer-offline` once per prepare and forced a registry round trip. An exact version leaves npm nothing to revalidate, so a prepare run no longer waits on registry latency.
+
+  Also silences git-cliff's INFO output, in particular the crates.io update notice.
 <!-- /section:release-notes -->
 
 ## Installation
@@ -72,6 +86,8 @@ That's it for most repos. The CLI auto-discovers workspaces and applies sensible
 4. **Version bump + changelog**: bumps `package.json` versions, builds structured `ChangelogEntry[]` from `git-cliff --context`, applies any [editorial overrides](#editorial-overrides) from per-scope `.meta/changelog-overrides.json` files, and renders both `CHANGELOG.md` and `.meta/changelog.json` from that single source. `git-cliff` is invoked only for its `--context` JSON; markdown rendering happens in-process so `.meta/changelog.json` and `CHANGELOG.md` always agree.
 5. **Release tags file**: writes computed tags to `tmp/.release-tags` for the release workflow to read when tagging and pushing.
 
+Neither changelog reaches a published tarball on its own. npm stopped including `CHANGELOG` automatically in npm 7, so a package that declares a `files` field ships a changelog only where that field names `CHANGELOG.md` and `.meta/changelog.json`. release-kit's readyup kit reports a publishable workspace whose `files` field omits either.
+
 ## Commit format
 
 release-kit parses commits in these formats:
@@ -400,6 +416,40 @@ Work types from your config are merged with these defaults by key — your entri
 
 The default `devOnlySections` (excluded from public release notes but still written to `CHANGELOG.md`) are derived from the `internal` and `process` tiers (excluding `fmt`). Override via `changelogJson.devOnlySections` in your config; matching is decorator-tolerant, so a bare-name override like `['Internal features']` keeps working against the emoji-prefixed and prefix-decorated default titles.
 
+## `changelog.json` item schema
+
+Each item under a section in `.meta/changelog.json` carries one required field and four optional ones:
+
+| Field         | Type      | Meaning                                                                                                                           |
+| ------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------- |
+| `description` | `string`  | The bullet headline, taken from the commit subject with the ticket ID and type prefix stripped.                                   |
+| `body`        | `string`  | The commit body, with trailing trailer metadata stripped.                                                                         |
+| `breaking`    | `boolean` | Present and `true` where the commit subject carried the `!` prefix. See [`!` (breaking change) policy](#-breaking-change-policy). |
+| `migration`   | `string`  | The migration step for a consumer. See below.                                                                                     |
+| `hash`        | `string`  | The full commit SHA, and the key on which an override entry matches. Absent on synthetic propagation entries.                     |
+
+Every optional field is omitted rather than emitted as `null`, so a consumer tests for presence.
+
+### The `migration` field
+
+A commit body states a migration step as a paragraph opening with the literal label `Migration:`. Where one is present, `migration` carries that paragraph with the label stripped:
+
+```jsonc
+{
+  "description": "Rename the workspace field",
+  "body": "Renames `name` to `id`.\n\nMigration: Change any uses of `name` to `id`.",
+  "migration": "Change any uses of `name` to `id`.",
+}
+```
+
+Three properties are worth knowing:
+
+- **It is independent of `breaking`.** A `fix` cannot carry `!` under the default breaking policy, and a `fix` that tightens validation still imposes a migration. Filter on `migration` to find every step; filter on `breaking` to find every breaking change.
+- **`body` keeps the paragraph.** The field is an extraction, not a move, so `CHANGELOG.md` and `.meta/changelog.json` go on agreeing.
+- **It is derived, not authored.** `migration` is not a field an override file can set (see [File shape](#file-shape)); it is re-derived from whatever `body` an override installs, and cleared where that body carries no labeled paragraph. To change the migration text, override `body`.
+
+The label match is exact: `migration:` and `**Migration:**` are not recognized.
+
 ## Editorial overrides
 
 Generated changelogs occasionally need editorial correction — typos, redacted scope, reworded entries, or historical commits whose bodies carry verbatim PR-template scaffolding (`## What`, `## Why`, etc.) that renders as literal text in user-facing release notes. Rewriting git history is not viable, and any in-place edit to `CHANGELOG.md` or `.meta/changelog.json` is overwritten on the next release because release-kit regenerates both artifacts from scratch.
@@ -461,6 +511,8 @@ Per-entry fields are all optional, but at least one must be present per entry:
 | `body`        | `string`                   | Replaces the entry's body (the prose that renders below the bullet). Other fields are preserved.                                  |
 | `breaking`    | `boolean`                  | Toggles the `🚨 **Breaking:** ` marker on the bullet.                                                                             |
 
+There is no `migration` key: the field is derived from `body`, so an override that replaces `body` re-derives it. See [The `migration` field](#the-migration-field).
+
 ### Hash-prefix matching
 
 Keys can be either the full 40-character commit SHA or a non-ambiguous prefix. The matcher walks every `ChangelogItem.hash` value present in the entry tree and resolves each override key to its set of matching hashes:
@@ -916,7 +968,7 @@ These kits are no longer reachable through `rdy run --from github:williamthorsen
 This package shells out to two external tools:
 
 - **`git`** — must be available on `PATH`. Used to find tags and retrieve commit history.
-- **`git-cliff`** — automatically downloaded and cached via `npx` on first invocation. No need to install it as a dev dependency.
+- **`git-cliff`** — pinned to an exact version and fetched via `npx` on first invocation, then served from npx's cache. No need to install it as a dev dependency. The pin moves only when a new release-kit version names a newer git-cliff, so two releases cut months apart run the same changelog generator.
 
 ## Upgrading from v4 to v5
 
@@ -1070,7 +1122,7 @@ If your format command does not accept file arguments, update it to one that doe
 
 ### v1.1.0: `git-cliff` is no longer a required dev dependency
 
-`git-cliff` is now invoked via `npx --yes git-cliff` instead of requiring it as a dev dependency. You can remove it from your `devDependencies`. The version is not pinned, so `npx` downloads and caches the latest version on first invocation. To pin a specific version, use `npx --yes git-cliff@2.12.0` by wrapping the call in a custom script.
+`git-cliff` is now invoked via `npx` instead of requiring it as a dev dependency. You can remove it from your `devDependencies`. release-kit names an exact version in the invocation, so the version you get is decided by the release-kit version you install rather than by whatever the registry serves that day.
 
 ## Migration from changesets
 

package/dist/esm/buildChangelogEntries.js

@@ -1,6 +1,7 @@
 import { chainError } from '@williamthorsen/toolbelt.errors/candidate';
 import { extractVersion } from "./changelogJsonUtils.js";
 import { DEFAULT_WORK_TYPES } from "./defaults.js";
+import { extractMigration } from "./extractMigration.js";
 import { COMMIT_PREPROCESSOR_PATTERNS, PIPE_SCOPE_SOURCE } from "./parseCommitMessage.js";
 import { resolveCliffConfigPath } from "./resolveCliffConfigPath.js";
 import { runGitCliff } from "./runGitCliff.js";
@@ -101,6 +102,10 @@ function transformReleases(releases, devOnlySections) {
             if (breaking) {
                 item.breaking = true;
             }
+            const migration = extractMigration(body);
+            if (migration !== undefined) {
+                item.migration = migration;
+            }
             if (commit.id !== undefined && commit.id !== '') {
                 item.hash = commit.id;
             }

package/dist/esm/changelogJsonUtils.d.ts

@@ -1,13 +1,11 @@
-import type { ChangelogEntry, ChangelogItem } from './types.js';
+import type { ChangelogEntry } from './types.js';
 /**
- * Type guard for `ChangelogItem` values parsed from JSON.
+ * Type guard for `ChangelogEntry` values parsed from JSON.
  *
- * Accepts the required `description` plus optional `body`, `breaking`, and `hash` fields. The
- * `hash` field is shape-checked but not required — synthetic propagation entries omit it, and
- * pre-hash `changelog.json` files are still considered valid.
+ * Checks the entry's top level only: `sections` is verified to be an array, and its contents pass
+ * through unvalidated. `.meta/changelog.json` is written by release-kit and read tolerantly; strict
+ * validation applies to the human-authored `.meta/changelog-overrides.json`, in `changelogOverrides.ts`.
  */
-export declare function isChangelogItem(value: unknown): value is ChangelogItem;
-/** Type guard for `ChangelogEntry` values parsed from JSON. */
 export declare function isChangelogEntry(value: unknown): value is ChangelogEntry;
 /** Extract the version from a tag by stripping the prefix up to the first digit. */
 export declare function extractVersion(tag: string): string;

package/dist/esm/changelogJsonUtils.js

@@ -1,18 +1,5 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { isRecord, isUnknownArray } from "./typeGuards.js";
-export function isChangelogItem(value) {
-    if (!isRecord(value))
-        return false;
-    if (typeof value['description'] !== 'string')
-        return false;
-    if (value['body'] !== undefined && typeof value['body'] !== 'string')
-        return false;
-    if (value['breaking'] !== undefined && typeof value['breaking'] !== 'boolean')
-        return false;
-    if (value['hash'] !== undefined && typeof value['hash'] !== 'string')
-        return false;
-    return true;
-}
 export function isChangelogEntry(value) {
     return (isRecord(value) &&
         typeof value['version'] === 'string' &&

package/dist/esm/changelogOverrides.js

@@ -1,6 +1,7 @@
 import { existsSync, readFileSync } from 'node:fs';
 import path from 'node:path';
 import { describeError } from '@williamthorsen/toolbelt.errors';
+import { extractMigration } from "./extractMigration.js";
 import { isRecord } from "./typeGuards.js";
 const OVERRIDES_FILENAME = '.meta/changelog-overrides.json';
 const VALID_AUDIENCE_VALUES = new Set(['all', 'dev', 'skip']);
@@ -206,6 +207,13 @@ function applyOverrideToItem(item, override) {
     }
     if (override.body !== undefined) {
         result.body = override.body;
+        const migration = extractMigration(override.body);
+        if (migration === undefined) {
+            delete result.migration;
+        }
+        else {
+            result.migration = migration;
+        }
     }
     if (override.breaking !== undefined) {
         result.breaking = override.breaking;

package/dist/esm/extractMigration.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Extracts the instruction from a commit body's `Migration:` paragraph.
+ *
+ * The first paragraph opening with the label wins: the lede doctrine specifies one labeled
+ * paragraph per body, so a second is ignored rather than appended. The match is anchored and
+ * case-sensitive, so `migration:` and `**Migration:**` yield nothing; the doctrine calls the
+ * label literal, and tolerating variants would let the form drift.
+ *
+ * Newlines inside the paragraph are preserved. The first character is capitalized, which is
+ * inert for the imperative the doctrine requires and repairs the lowercase continuation of a
+ * paragraph written before it. Returns `undefined` when no paragraph carries the label, or when
+ * the label is followed by nothing.
+ */
+export declare function extractMigration(body: string | undefined): string | undefined;

package/dist/esm/extractMigration.js

@@ -0,0 +1,18 @@
+const PARAGRAPH_SEPARATOR = /\n(?:[ \t]*\n)+/;
+const MIGRATION_LABEL = /^Migration:[ \t]*/;
+export function extractMigration(body) {
+    if (body === undefined) {
+        return undefined;
+    }
+    for (const paragraph of body.split(PARAGRAPH_SEPARATOR)) {
+        if (!MIGRATION_LABEL.test(paragraph)) {
+            continue;
+        }
+        const instruction = paragraph.replace(MIGRATION_LABEL, '').trim();
+        if (instruction.length === 0) {
+            return undefined;
+        }
+        return instruction.charAt(0).toUpperCase() + instruction.slice(1);
+    }
+    return undefined;
+}

package/dist/esm/packsPath.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Reports whether npm would place `path` in the published tarball, given a package.json `files` value.
+ *
+ * An absent or malformed `files` value packs everything, so it reports `true`; an empty array packs nothing
+ * beyond the files npm always includes, so it reports `false`. An entry naming an ancestor directory covers
+ * everything beneath it, which is how `files: ["dist/*"]` ships `dist/esm/index.js`, so every ancestor prefix
+ * of `path` is tested rather than `path` alone.
+ *
+ * Two approximations of npm's packing rules remain, both failing toward a silent pass: a negation entry
+ * (`!dist/*.map`) never counts toward inclusion, because gitignore-style ordered negation is not modeled; and a
+ * repo controlling its tarball through `.npmignore` alone declares no `files` field, so it reports `true`
+ * without the ignore file being read. For a check that warns about an omission, a missed report costs less than
+ * a false one.
+ */
+export declare function packsPath(filesField: unknown, path: string): boolean;

package/dist/esm/packsPath.js

@@ -0,0 +1,47 @@
+export function packsPath(filesField, path) {
+    if (!isStringArray(filesField))
+        return true;
+    const prefixes = listAncestorPrefixes(path);
+    return filesField.some((entry) => {
+        const pattern = compileEntry(entry);
+        return pattern !== undefined && prefixes.some((prefix) => pattern.test(prefix));
+    });
+}
+const GLOB_TOKEN_PATTERN = /\*\*\/|\*\*|\*|\?|[^*?]+/g;
+function compileEntry(entry) {
+    if (entry.startsWith('!'))
+        return undefined;
+    const normalized = entry.replace(/^\.?\//, '').replace(/\/+$/, '');
+    if (normalized === '')
+        return undefined;
+    return new RegExp(`^${translateGlob(normalized)}$`);
+}
+function isStringArray(value) {
+    return Array.isArray(value) && value.every((entry) => typeof entry === 'string');
+}
+function listAncestorPrefixes(path) {
+    const segments = path.split('/');
+    return segments.map((_segment, index) => segments.slice(0, index + 1).join('/'));
+}
+function translateGlob(pattern) {
+    let source = '';
+    for (const [token] of pattern.matchAll(GLOB_TOKEN_PATTERN)) {
+        switch (token) {
+            case '**/':
+                source += String.raw `(?:[^/]*\/)*`;
+                break;
+            case '**':
+                source += '.*';
+                break;
+            case '*':
+                source += '[^/]*';
+                break;
+            case '?':
+                source += '[^/]';
+                break;
+            default:
+                source += RegExp.escape(token);
+        }
+    }
+    return source;
+}

package/dist/esm/releasePrepare.js

@@ -16,7 +16,6 @@ import { planVersionBump, planVersionSet } from "./planVersionBump.js";
 import { readCurrentVersion } from "./readCurrentVersion.js";
 import { renderChangelogMarkdown } from "./renderChangelogMarkdown.js";
 import { deriveSectionOrder } from "./resolveReleaseNotesConfig.js";
-import { refreshGitCliffCache } from "./runGitCliff.js";
 export function releasePrepare(config, options) {
     const { bumpOverride, setVersion, withReleaseNotes } = options;
     const writes = [];
@@ -46,7 +45,6 @@ export function releasePrepare(config, options) {
         if (!isForwardVersion(currentVersion, setVersion)) {
             throw new Error(`--set-version ${setVersion} is not greater than current version ${currentVersion}`);
         }
-        refreshGitCliffCache();
         bump = planVersionSet(config.packageFiles, setVersion);
     }
     else {
@@ -78,7 +76,6 @@ export function releasePrepare(config, options) {
                 formatCommand: undefined,
             };
         }
-        refreshGitCliffCache();
         bump = planVersionBump(config.packageFiles, releaseType);
     }
     writes.push(...bump.writes);

package/dist/esm/releasePrepareMono.js

@@ -23,7 +23,6 @@ import { readCurrentVersion } from "./readCurrentVersion.js";
 import { releasePrepareProject } from "./releasePrepareProject.js";
 import { renderChangelogMarkdown } from "./renderChangelogMarkdown.js";
 import { deriveSectionOrder } from "./resolveReleaseNotesConfig.js";
-import { refreshGitCliffCache } from "./runGitCliff.js";
 export function releasePrepareMono(config, options) {
     const { only, withReleaseNotes } = options;
     const writes = [];
@@ -53,9 +52,6 @@ export function releasePrepareMono(config, options) {
         enabled: withReleaseNotes === true && config.changelogJson.enabled,
         sectionOrder,
     };
-    if (fullReleaseSet.size > 0) {
-        refreshGitCliffCache();
-    }
     const { tags, modifiedFiles } = executeReleaseSet({
         sortedDirs,
         fullReleaseSet,

package/dist/esm/reportPrepare.js

@@ -1,4 +1,6 @@
 import { bold, dim, sectionHeader } from "./format.js";
+import { GIT_CLIFF_NPX_ARGS } from "./runGitCliff.js";
+const CLIFF_DRY_RUN_COMMAND = `npx ${GIT_CLIFF_NPX_ARGS.join(' ')} ...`;
 export function reportPrepare(plan, options) {
     const isMultiWorkspace = plan.workspaces.some((w) => w.name !== undefined) || plan.project !== undefined;
     if (isMultiWorkspace) {
@@ -103,7 +105,7 @@ function formatProjectSection(lines, project, dryRun) {
     lines.push(dim('  Generating changelogs...'));
     for (const file of project.changelogFiles) {
         if (dryRun) {
-            lines.push(dim(`    [dry-run] Would run: npx --yes git-cliff ... --output ${file}`));
+            lines.push(dim(`    [dry-run] Would run: ${CLIFF_DRY_RUN_COMMAND} --output ${file}`));
         }
         else {
             lines.push(dim(`    Generating changelog: ${file}`));
@@ -195,7 +197,7 @@ function formatBumpFiles(lines, workspace, dryRun, indent = '') {
 function formatChangelogFiles(lines, workspace, dryRun, indent = '') {
     for (const file of workspace.changelogFiles) {
         if (dryRun) {
-            lines.push(dim(`${indent}  [dry-run] Would run: npx --yes git-cliff ... --output ${file}`));
+            lines.push(dim(`${indent}  [dry-run] Would run: ${CLIFF_DRY_RUN_COMMAND} --output ${file}`));
         }
         else {
             lines.push(dim(`${indent}  Generating changelog: ${file}`));