@williamthorsen/release-kit 15.0.3 → 16.0.0

package/.meta/changelog.json

@@ -1,4 +1,70 @@
 [
+  {
+    "version": "16.0.0",
+    "date": "2026-10-28",
+    "sections": [
+      {
+        "title": "🎉 Features",
+        "audience": "all",
+        "items": [
+          {
+            "description": "Renames the `changelogMarkdown.keepVersions` config key to `changelogMarkdown.keptVersionCount` and makes config validation reject the old key with an error that names the replacement. (#1134)",
+            "breaking": true,
+            "migration": "Rename `changelogMarkdown.keepVersions` to `changelogMarkdown.keptVersionCount` in `.config/release-kit.config.ts`, keeping the same value.",
+            "hash": "3d44603845a461295a5a62eee60cf151b5291f1a",
+            "entry": 1
+          }
+        ]
+      },
+      {
+        "title": "♻️ Refactoring",
+        "audience": "dev",
+        "items": [
+          {
+            "description": "Renames the boolean options, fields, and parameters in `release-kit` to take an `is`, `has`, `does`, or `should` prefix, such as `dryRun` to `isDryRun` and `exists` to `doesExist`, and leaves every CLI flag spelling unchanged. (#1132)",
+            "hash": "dcb78f0657c580eb7c7be94859e4185ae9f3d3be",
+            "entry": 1
+          },
+          {
+            "description": "Renames the values and type fields declared in `release-kit`'s source files from the first alphabetically through `prepareTarget.ts` so that each name ends with its kind, such as `parsedJson` for `parsed` and `unreleasedReading` for the history field `unreleased`, without changing behavior. (#1133)",
+            "hash": "eae8b6458dca1927393d64626d4731fc7c9f9df1",
+            "entry": 1
+          },
+          {
+            "description": "Renames values and type fields across release-kit's source so that each name ends with its kind, such as `applied` to `appliedWrites` and `TargetPrepareOptions.only` to `onlyTargetIds`. (#1134)",
+            "hash": "3d44603845a461295a5a62eee60cf151b5291f1a",
+            "entry": 2
+          },
+          {
+            "description": "Renames `release-kit`'s source functions and test helpers so that each name starts with a transitive verb that states its action, for example `releasePrepareTargets` to `prepareReleaseTargets` (with its module and test files), `publishWorkflow` to `renderPublishWorkflow`, and `toChangelogEntries` to `convertToChangelogEntries`, without changing the exports of `.` or `./config`. (#1137)",
+            "hash": "a84d9ce0652754a417b85c3f9cd14a6e400c7b51",
+            "entry": 1
+          },
+          {
+            "description": "Renames identifiers in `release-kit` so that each measurement ends with its unit, such as `timestamp` becoming `timestampSec` on `ReleaseWindow` and `SUBJECT_COLUMN_BUDGET` becoming `SUBJECT_BUDGET_COLUMNS`, and so that obscure abbreviations are spelled out, such as `pkg` becoming `packageJson` and `dep` becoming `dependency`. (#1138)",
+            "hash": "f75938c0bfe9365a76b15aa6b4b9d195046c8c78",
+            "entry": 1
+          }
+        ]
+      },
+      {
+        "title": "🧪 Tests",
+        "audience": "dev",
+        "items": [
+          {
+            "description": "Renames the values declared in release-kit's `src/__tests__` files, from the first one alphabetically through `prepareCommand.unit.test.ts`, so that each name ends with its kind, such as `underlying` to `underlyingError` and `unreleased` to `unreleasedReading`. (#1135)",
+            "hash": "b98d26e24e86835ce6edc78f53a964bcc84472fb",
+            "entry": 1
+          },
+          {
+            "description": "Suffixes the values declared in release-kit's remaining tests with their kind, such as `known` to `knownFlags`, `silent` to `silencedConsole`, and `actual` to `actualModule`, in the `src/__tests__` files after `prepareCommand.unit.test.ts` and the tests under `src/init/__tests__` and `src/sync-labels/__tests__`. (#1136)",
+            "hash": "1e947eb5c2d168ffd3d1cf9cf8b0b4e720eaf991",
+            "entry": 1
+          }
+        ]
+      }
+    ]
+  },
   {
     "version": "15.0.3",
     "date": "2026-10-27",

package/.readyup/kits/default.js

@@ -24,14 +24,14 @@ function isRecord(value) {
 }
 
 // src/init/parseJsonRecord.ts
-function parseJsonRecord(raw) {
-  let parsed;
+function parseJsonRecord(jsonText) {
+  let parsedJson;
   try {
-    parsed = JSON.parse(raw);
+    parsedJson = JSON.parse(jsonText);
   } catch {
     return void 0;
   }
-  return isRecord(parsed) ? parsed : void 0;
+  return isRecord(parsedJson) ? parsedJson : void 0;
 }
 
 // src/init/detectRepoType.ts
@@ -40,9 +40,9 @@ function detectRepoType() {
     return "monorepo";
   }
   if (existsSync("package.json")) {
-    const raw = readFileSync("package.json", "utf8");
-    const pkg = parseJsonRecord(raw);
-    if (pkg !== void 0 && Array.isArray(pkg["workspaces"])) {
+    const manifestJson = readFileSync("package.json", "utf8");
+    const packageJson = parseJsonRecord(manifestJson);
+    if (packageJson !== void 0 && Array.isArray(packageJson["workspaces"])) {
       return "monorepo";
     }
   }
@@ -67,9 +67,9 @@ function packsPath(filesField, path) {
 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)}$`);
+  const normalizedEntry = entry.replace(/^\.?\//, "").replace(/\/+$/, "");
+  if (normalizedEntry === "") return void 0;
+  return new RegExp(`^${translateGlob(normalizedEntry)}$`);
 }
 function isStringArray(value) {
   return Array.isArray(value) && value.every((entry) => typeof entry === "string");
@@ -105,7 +105,7 @@ function translateGlob(pattern) {
 function changelogArchivesAreEnabled() {
   const content = readFile(".config/release-kit.config.ts");
   if (content === void 0) return false;
-  return /changelogMarkdown\s*:\s*\{[^}]*keepVersions\s*:/.test(content);
+  return /changelogMarkdown\s*:\s*\{[^}]*keptVersionCount\s*:/.test(content);
 }
 function changelogJsonIsEnabled() {
   const content = readFile(".config/release-kit.config.ts");
@@ -234,7 +234,7 @@ var CREATE_GITHUB_RELEASE_WORKFLOW_HASH_SINGLE = "d6de961de913c67b08dfa7e07f7349
 
 // .readyup/kits/default.ts
 function getMinVersion() {
-  const picked = { "version": "15.0.3" };
+  const picked = { "version": "16.0.0" };
   if (typeof picked["version"] !== "string") {
     throw new TypeError("release-kit/package.json: 'version' must be a string");
   }
@@ -405,7 +405,7 @@ var default_default = defineRdyKit({
           severity: "warn",
           skip: () => {
             if (!hasPublishablePackages()) return "no publishable packages";
-            return !changelogArchivesAreEnabled() && "changelogMarkdown.keepVersions is not set";
+            return !changelogArchivesAreEnabled() && "changelogMarkdown.keptVersionCount is not set";
           },
           check: () => packagesShipChangelogArchives(),
           fix: 'Add "changelogs/" to the files field of each affected package.json, so that the links from CHANGELOG.md to its archive files resolve in the published package'

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

@@ -60,16 +60,16 @@ function lookUpNpmPackage(packageName, registry) {
   return classifyNpmPackageLookup(runNpmJson(args));
 }
 function readNpmError(stdout) {
-  let parsed;
+  let parsedJson;
   try {
-    parsed = JSON.parse(stdout);
+    parsedJson = JSON.parse(stdout);
   } catch {
     return void 0;
   }
-  if (!isRecord(parsed) || !isRecord(parsed["error"]) || typeof parsed["error"]["code"] !== "string") {
+  if (!isRecord(parsedJson) || !isRecord(parsedJson["error"]) || typeof parsedJson["error"]["code"] !== "string") {
     return void 0;
   }
-  const { code, summary } = parsed["error"];
+  const { code, summary } = parsedJson["error"];
   return { code, summary: typeof summary === "string" ? summary : "" };
 }
 function runNpmJson(args) {

package/.readyup/manifest.json

@@ -7,7 +7,7 @@
           "checklist": "release-kit",
           "checks": [
             "@williamthorsen/release-kit in devDependencies",
-            "@williamthorsen/release-kit >= 15.0.3",
+            "@williamthorsen/release-kit >= 16.0.0",
             "release.yaml workflow exists",
             "release.yaml matches template",
             "release.yaml does not reference deprecated tag ref",
@@ -43,12 +43,12 @@
       "esbuildVersion": "0.28.2",
       "inputs": [
         {
-          "hash": "ad3666b8",
+          "hash": "56566d0b",
           "kind": "module",
           "path": "kits/default.ts"
         },
         {
-          "hash": "45fc235f",
+          "hash": "dafe3ffb",
           "kind": "module",
           "path": "lib/changelog-checks.ts"
         },
@@ -63,7 +63,7 @@
           "path": "lib/workflow-hashes.ts"
         },
         {
-          "hash": "5c98064e",
+          "hash": "de7d08de",
           "kind": "inline",
           "path": "../package.json",
           "paths": [
@@ -71,22 +71,22 @@
           ]
         },
         {
-          "hash": "40404aa0",
+          "hash": "694186f4",
           "kind": "module",
           "path": "../src/changelogArchive.ts"
         },
         {
-          "hash": "43bb0452",
+          "hash": "65fa2f33",
           "kind": "module",
           "path": "../src/init/detectRepoType.ts"
         },
         {
-          "hash": "68354f97",
+          "hash": "9ca0f6bf",
           "kind": "module",
           "path": "../src/init/parseJsonRecord.ts"
         },
         {
-          "hash": "1c9cbce9",
+          "hash": "2210df36",
           "kind": "module",
           "path": "../src/packsPath.ts"
         },
@@ -100,8 +100,8 @@
       "path": "kits/default.js",
       "readyupVersion": "0.44.0",
       "source": "kits/default.ts",
-      "sourceHash": "ad3666b8",
-      "targetHash": "35d9bb56"
+      "sourceHash": "56566d0b",
+      "targetHash": "43d5913f"
     },
     {
       "checklistChecks": [
@@ -145,7 +145,7 @@
           "path": "../src/init/hasProvenance.ts"
         },
         {
-          "hash": "3e39b9be",
+          "hash": "bb8746b3",
           "kind": "module",
           "path": "../src/npmRegistry.ts"
         },
@@ -160,7 +160,7 @@
       "readyupVersion": "0.44.0",
       "source": "kits/npm-auto-publish.ts",
       "sourceHash": "682fdd4a",
-      "targetHash": "fac6bc8b"
+      "targetHash": "84f31b6d"
     }
   ]
 }

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All notable changes to this project will be documented in this file.
 
+## 16.0.0 — 2026-10-28
+
+### 🎉 Features
+
+- 🚨 **Breaking:** Renames the `changelogMarkdown.keepVersions` config key to `changelogMarkdown.keptVersionCount` and makes config validation reject the old key with an error that names the replacement. (#1134)
+
+### ♻️ Refactoring
+
+- Renames the boolean options, fields, and parameters in `release-kit` to take an `is`, `has`, `does`, or `should` prefix, such as `dryRun` to `isDryRun` and `exists` to `doesExist`, and leaves every CLI flag spelling unchanged. (#1132)
+- Renames the values and type fields declared in `release-kit`'s source files from the first alphabetically through `prepareTarget.ts` so that each name ends with its kind, such as `parsedJson` for `parsed` and `unreleasedReading` for the history field `unreleased`, without changing behavior. (#1133)
+- Renames values and type fields across release-kit's source so that each name ends with its kind, such as `applied` to `appliedWrites` and `TargetPrepareOptions.only` to `onlyTargetIds`. (#1134)
+- Renames `release-kit`'s source functions and test helpers so that each name starts with a transitive verb that states its action, for example `releasePrepareTargets` to `prepareReleaseTargets` (with its module and test files), `publishWorkflow` to `renderPublishWorkflow`, and `toChangelogEntries` to `convertToChangelogEntries`, without changing the exports of `.` or `./config`. (#1137)
+- Renames identifiers in `release-kit` so that each measurement ends with its unit, such as `timestamp` becoming `timestampSec` on `ReleaseWindow` and `SUBJECT_COLUMN_BUDGET` becoming `SUBJECT_BUDGET_COLUMNS`, and so that obscure abbreviations are spelled out, such as `pkg` becoming `packageJson` and `dep` becoming `dependency`. (#1138)
+
+### 🧪 Tests
+
+- Renames the values declared in release-kit's `src/__tests__` files, from the first one alphabetically through `prepareCommand.unit.test.ts`, so that each name ends with its kind, such as `underlying` to `underlyingError` and `unreleased` to `unreleasedReading`. (#1135)
+- Suffixes the values declared in release-kit's remaining tests with their kind, such as `known` to `knownFlags`, `silent` to `silencedConsole`, and `actual` to `actualModule`, in the `src/__tests__` files after `prepareCommand.unit.test.ts` and the tests under `src/init/__tests__` and `src/sync-labels/__tests__`. (#1136)
+
 ## 15.0.3 — 2026-10-27
 
 ### ♻️ Refactoring

package/README.md

@@ -6,7 +6,13 @@ 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 — v16.0.0 (2026-10-28)
+
+### 🎉 Features
+
+- 🚨 **Breaking:** Renames the `changelogMarkdown.keepVersions` config key to `changelogMarkdown.keptVersionCount` and makes config validation reject the old key with an error that names the replacement. (#1134)
+<!-- /section:release-notes -->
 
 ## Installation
 

package/dist/esm/applyChangelogOverrides.js

@@ -55,10 +55,10 @@ export function resolveOverrideKey(overrideKey, positionsByHash) {
     if (hashes.length > 1) {
         return { kind: 'ambiguous', hashes };
     }
-    const available = [...(positionsByHash.get(hash) ?? [])];
+    const availablePositions = [...(positionsByHash.get(hash) ?? [])];
     const positions = entry === undefined
-        ? available.toSorted((left, right) => (left ?? 0) - (right ?? 0))
-        : available.filter((position) => position === entry);
+        ? availablePositions.toSorted((left, right) => (left ?? 0) - (right ?? 0))
+        : availablePositions.filter((position) => position === entry);
     return positions.length === 0 ? { kind: 'none' } : { kind: 'items', hash, positions };
 }
 function applyOverridesToItems(items, itemIdToOverride) {
@@ -133,10 +133,10 @@ function resolveOverrideKeys(positionsByHash, overrides) {
         }
         const { hash, positions } = resolution;
         if (parseOverrideKey(overrideKey).entry === undefined && positions.length > 1) {
-            const fieldsSet = ['description', 'body'].filter((field) => override[field] !== undefined);
-            if (fieldsSet.length > 0) {
+            const setFields = ['description', 'body'].filter((field) => override[field] !== undefined);
+            if (setFields.length > 0) {
                 const ordinalKeys = positions.map((position) => `${overrideKey}:${position}`).join(', ');
-                errors.push(`Override key '${overrideKey}' sets ${fieldsSet.join(' and ')} on a commit with several items; use ${ordinalKeys}`);
+                errors.push(`Override key '${overrideKey}' sets ${setFields.join(' and ')} on a commit with several items; use ${ordinalKeys}`);
                 continue;
             }
         }

package/dist/esm/assertReleasesOnNpm.js

@@ -4,8 +4,8 @@ import { isPublishableManifest } from "./isPublishableManifest.js";
 import { lookUpNpmPackage } from "./npmRegistry.js";
 import { isRecord } from "./typeGuards.js";
 export function assertReleasesOnNpm(workspacePaths) {
-    const unpublished = [];
-    const unverifiable = [];
+    const unpublishedCandidates = [];
+    const unverifiableCandidates = [];
     for (const workspacePath of workspacePaths) {
         const candidate = buildNpmCandidate(workspacePath);
         if (candidate === undefined) {
@@ -13,16 +13,16 @@ export function assertReleasesOnNpm(workspacePaths) {
         }
         const lookup = lookUpNpmPackage(candidate.name, candidate.registry);
         if (lookup.status === 'unpublished') {
-            unpublished.push(candidate);
+            unpublishedCandidates.push(candidate);
         }
         else if (lookup.status === 'unverifiable') {
-            unverifiable.push({ candidate, detail: lookup.detail });
+            unverifiableCandidates.push({ candidate, detail: lookup.detail });
         }
     }
-    if (unpublished.length === 0 && unverifiable.length === 0) {
+    if (unpublishedCandidates.length === 0 && unverifiableCandidates.length === 0) {
         return;
     }
-    throw new Error(describeRefusal(unpublished, unverifiable));
+    throw new Error(describeRefusal(unpublishedCandidates, unverifiableCandidates));
 }
 function buildNpmCandidate(workspacePath) {
     const manifest = JSON.parse(readFileSync(join(workspacePath, 'package.json'), 'utf8'));
@@ -37,19 +37,19 @@ function buildNpmCandidate(workspacePath) {
         ...(typeof registry === 'string' && { registry }),
     };
 }
-function describeRefusal(unpublished, unverifiable) {
+function describeRefusal(unpublishedCandidates, unverifiableCandidates) {
     const sections = ['Cannot prepare the release: npm must already have every package that the release publishes.'];
-    if (unpublished.length > 0) {
+    if (unpublishedCandidates.length > 0) {
         sections.push([
             'Not on npm yet:',
-            ...unpublished.map(({ name, workspacePath }) => `  - ${name}: run "npm publish --access public" from ${workspacePath}`),
+            ...unpublishedCandidates.map(({ name, workspacePath }) => `  - ${name}: run "npm publish --access public" from ${workspacePath}`),
             'Then register each one as a trusted publisher; "rdy run --from npm:@williamthorsen/release-kit npm-auto-publish" prints the command.',
         ].join('\n'));
     }
-    if (unverifiable.length > 0) {
+    if (unverifiableCandidates.length > 0) {
         sections.push([
             'Could not confirm on npm:',
-            ...unverifiable.map(({ candidate, detail }) => `  - ${candidate.name}: ${detail}`),
+            ...unverifiableCandidates.map(({ candidate, detail }) => `  - ${candidate.name}: ${detail}`),
         ].join('\n'));
     }
     return sections.join('\n\n');

package/dist/esm/assertTaggedBaseline.js

@@ -4,10 +4,10 @@ import { readChangelogEntries } from "./changelogJsonUtils.js";
 import { readCurrentVersion } from "./planVersionBump.js";
 import { readChangelogSections } from "./readChangelogSections.js";
 export function assertTaggedBaseline(findings) {
-    const untagged = findings.filter((finding) => finding !== undefined);
-    if (untagged.length === 0)
+    const untaggedFindings = findings.filter((finding) => finding !== undefined);
+    if (untaggedFindings.length === 0)
         return;
-    const lines = untagged.map(({ label, version, tag }) => `  - ${label}: ${version} (create tag ${tag})`);
+    const lines = untaggedFindings.map(({ label, version, tag }) => `  - ${label}: ${version} (create tag ${tag})`);
     throw new Error([
         'The current version is recorded in the changelog, but its tag is not the previous tag reachable from HEAD:',
         ...lines,
@@ -31,9 +31,9 @@ export function findUntaggedBaseline(target, config) {
 function readRecordedVersions(changelogPaths, config) {
     const versions = new Set();
     for (const changelogPath of changelogPaths) {
-        const { versioned } = readChangelogSections(join(changelogPath, 'CHANGELOG.md'));
+        const { versionedSections } = readChangelogSections(join(changelogPath, 'CHANGELOG.md'));
         const entries = readChangelogEntries(resolveChangelogJsonPath(config, changelogPath)) ?? [];
-        for (const { version } of [...versioned, ...entries]) {
+        for (const { version } of [...versionedSections, ...entries]) {
             versions.add(version);
         }
     }

package/dist/esm/bin/release-kit.js

@@ -127,12 +127,12 @@ if (command === 'init') {
     }
     enterRepoRootOrExit();
     const initFlagSchema = {
-        dryRun: { long: '--dry-run', type: 'boolean' },
-        force: { long: '--force', type: 'boolean' },
-        withConfig: { long: '--with-config', type: 'boolean' },
+        isDryRun: { long: '--dry-run', type: 'boolean' },
+        shouldForce: { long: '--force', type: 'boolean' },
+        shouldScaffoldConfig: { long: '--with-config', type: 'boolean' },
     };
-    const { dryRun, force, withConfig } = parseArgsOrExit(flags, initFlagSchema).flags;
-    const exitCode = initCommand({ dryRun, force, styles, withConfig });
+    const { isDryRun, shouldForce, shouldScaffoldConfig } = parseArgsOrExit(flags, initFlagSchema).flags;
+    const exitCode = initCommand({ isDryRun, shouldForce, styles, shouldScaffoldConfig });
     process.exit(exitCode);
 }
 if (command === 'update-templates') {
@@ -142,10 +142,10 @@ if (command === 'update-templates') {
     }
     enterRepoRootOrExit();
     const updateTemplatesFlagSchema = {
-        dryRun: { long: '--dry-run', type: 'boolean' },
+        isDryRun: { long: '--dry-run', type: 'boolean' },
     };
-    const { dryRun } = parseArgsOrExit(flags, updateTemplatesFlagSchema).flags;
-    const exitCode = updateTemplatesCommand({ dryRun, styles });
+    const { isDryRun } = parseArgsOrExit(flags, updateTemplatesFlagSchema).flags;
+    const exitCode = updateTemplatesCommand({ isDryRun, styles });
     process.exit(exitCode);
 }
 if (command === 'sync-labels') {
@@ -163,15 +163,15 @@ if (command === 'sync-labels') {
         const { invocationDir } = enterRepoRootOrExit();
         const syncLabelsInitFlagSchema = {
             ...configFlagSchema,
-            dryRun: { long: '--dry-run', type: 'boolean' },
-            force: { long: '--force', type: 'boolean' },
+            isDryRun: { long: '--dry-run', type: 'boolean' },
+            shouldForce: { long: '--force', type: 'boolean' },
         };
-        const { config, dryRun, force } = parseArgsOrExit(subflags, syncLabelsInitFlagSchema).flags;
+        const { config, isDryRun, shouldForce } = parseArgsOrExit(subflags, syncLabelsInitFlagSchema).flags;
         const configPath = resolveConfigFlag(config, invocationDir);
         const exitCode = await syncLabelsInitCommand({
             ...(configPath !== undefined && { configPath }),
-            dryRun,
-            force,
+            isDryRun,
+            shouldForce,
             styles,
         });
         process.exit(exitCode);
@@ -184,11 +184,11 @@ if (command === 'sync-labels') {
         const { invocationDir } = enterRepoRootOrExit();
         const generateFlagSchema = {
             ...configFlagSchema,
-            check: { long: '--check', type: 'boolean' },
+            shouldCheck: { long: '--check', type: 'boolean' },
         };
-        const { check, config } = parseArgsOrExit(subflags, generateFlagSchema).flags;
+        const { shouldCheck, config } = parseArgsOrExit(subflags, generateFlagSchema).flags;
         const configPath = resolveConfigFlag(config, invocationDir);
-        const exitCode = await generateCommand({ check, ...(configPath !== undefined && { configPath }), styles });
+        const exitCode = await generateCommand({ shouldCheck, ...(configPath !== undefined && { configPath }), styles });
         process.exit(exitCode);
     }
     if (subcommand === 'sync') {

package/dist/esm/buildChangelogEntries.d.ts

@@ -5,12 +5,30 @@ import type { ChangelogEntry, ChangelogSection, ReleaseSettings, ReleaseType } f
 /**
  * Builds structured changelog entries from the release windows of git history, naming the unreleased window `tag`.
  *
- * Composes `readReleaseHistory` and `toChangelogEntries` for a caller that knows the tag before it reads.
+ * Composes `readReleaseHistory` and `convertToChangelogEntries` for a caller that knows the tag before it reads.
  */
 export declare function buildChangelogEntries(config: ReleaseHistoryConfig, tag: string, options: GenerateChangelogOptions): {
     entries: ChangelogEntry[];
     diagnostics: ChangelogDiagnostics;
 };
+/** Labels the unreleased window of `history` with `tag` and returns the entries of every window, newest first. */
+export declare function convertToChangelogEntries(history: ReleaseHistory, tag: string): ChangelogEntry[];
+/** One read of a scope's release windows. */
+export interface ReleaseHistory {
+    /** The newest matching tag that HEAD reaches; undefined when none does. */
+    previousTag: string | undefined;
+    /** Entries of the released windows, newest first; a window that doesn't yield any item contributes none. */
+    releasedEntries: ChangelogEntry[];
+    unreleasedReading: UnreleasedWindowReading;
+}
+/** The configuration that `readReleaseHistory` reads. */
+export type ReleaseHistoryConfig = Pick<ReleaseSettings, 'breakingPolicies' | 'changelogJson' | 'scopeAliases' | 'versionPatterns' | 'workTypes'>;
+/**
+ * Returns the entries that a direct release tagged `tag` records: those of `convertToChangelogEntries`, or, when the
+ * unreleased window doesn't yield any item, the synthetic "Forced version bump." entry dated `today` ahead of the
+ * released entries.
+ */
+export declare function convertToReleaseEntries(history: ReleaseHistory, tag: string, today: string): ChangelogEntry[];
 /**
  * Reads a scope's release windows once and returns the changelog items of every window, with what the unreleased
  * window decides: its commits, its bump, and its diagnostics.
@@ -21,16 +39,6 @@ export declare function buildChangelogEntries(config: ReleaseHistoryConfig, tag:
  * only for the unreleased window, since the released windows were reported when they were prepared.
  */
 export declare function readReleaseHistory(config: ReleaseHistoryConfig, options: GenerateChangelogOptions): ReleaseHistory;
-/** One read of a scope's release windows. */
-export interface ReleaseHistory {
-    /** The newest matching tag that HEAD reaches; undefined when none does. */
-    previousTag: string | undefined;
-    /** Entries of the released windows, newest first; a window that doesn't yield any item contributes none. */
-    releasedEntries: ChangelogEntry[];
-    unreleased: UnreleasedWindowReading;
-}
-/** The configuration that `readReleaseHistory` reads. */
-export type ReleaseHistoryConfig = Pick<ReleaseSettings, 'breakingPolicies' | 'changelogJson' | 'scopeAliases' | 'versionPatterns' | 'workTypes'>;
 /**
  * Strips a section title down to its bare name.
  *
@@ -39,14 +47,6 @@ export type ReleaseHistoryConfig = Pick<ReleaseSettings, 'breakingPolicies' | 'c
  * through this helper lets the two forms match.
  */
 export declare function stripGroupDecorations(group: string): string;
-/** Labels the unreleased window of `history` with `tag` and returns the entries of every window, newest first. */
-export declare function toChangelogEntries(history: ReleaseHistory, tag: string): ChangelogEntry[];
-/**
- * Returns the entries that a direct release tagged `tag` records: those of `toChangelogEntries`, or, when the
- * unreleased window doesn't yield any item, the synthetic "Forced version bump." entry dated `today` ahead of the
- * released entries.
- */
-export declare function toReleaseEntries(history: ReleaseHistory, tag: string, today: string): ChangelogEntry[];
 /** The unreleased window: its changelog sections and commits, and the bump and diagnostics that they determine. */
 export interface UnreleasedWindowReading {
     /** The highest bump that the window's items call for; undefined when the window doesn't yield any item. */