@williamthorsen/release-kit 10.2.1 → 10.3.0

package/README.md

@@ -5,13 +5,23 @@ 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.2.1 (2026-08-04)
+## Release notes — v10.3.0 (2026-08-08)
+
+### 🎉 Features
+
+- Stop reporting absence checks that pass (#610)
+
+  A ReadyUp check that checks for a problem (such as an unwanted file or a stale config reference) now stays silent unless it finds one. The `nmr`, `release-kit`, and `v11y-check` ReadyUp kits previously printed a line for every such check on every run.
+
+- Stop reporting non-issues in the readyup kits (#613)
+
+  Modifies the `release-kit` and `nmr` ReadyUp kits to avoid verbose reporting when an initial check determines that further checks aren't applicable. In particular, a repo with no `release-kit` config file gets a single line in the `release-kit` report, and a repo that publishes nothing now bypasses the `npm-auto-publish` kit instead of failing it.
 
 ### 🐛 Bug fixes
 
-- Remove the 1 MiB ceiling on captured git output (#596)
+- Publish build output atomically so a failed build cannot destroy it (#631)
 
-  Fixes an issue where `release-kit prepare` began aborting once a repository's release history grew long enough, leaving that repository unable to cut another release. The fix covers, in addition to `prepare`, every other release-kit command that reads from git.
+  Fixes an issue where a failed or still-running `nmr build` could leave a package with no build output at all, breaking the tooling that a subsequent build depends on. Separately, the error reported when a package's build output is missing now names the correct recovery command.
 <!-- /section:release-notes -->
 
 ## Installation
@@ -565,7 +575,7 @@ Run release preparation with automatic workspace discovery.
 | `--set-version=X.Y.Z`        | Set an explicit canonical semver version; bypasses commit-derived bumps. Requires `--only` in monorepo mode (rejected when a `project` block is configured).                                                                                                            |
 | `--force`                    | Release even when no commits or no bump-worthy commits exist since the last tag. In monorepo/project mode, defaults to patch (combine with `--bump=X` for a different level); in single-package mode, a bare `--force` is rejected — pass `--bump=major\|minor\|patch`. |
 | `--only=name1,name2`         | Only process the named workspaces (monorepo only; rejected when a `project` block is configured)                                                                                                                                                                        |
-| `--with-release-notes`       | Write per-workspace release-notes previews under `{workspacePath}/docs/`                                                                                                                                                                                                |
+| `--with-release-notes`       | Write per-workspace release-notes previews under `<workspacePath>/docs/`                                                                                                                                                                                                |
 | `--help`, `-h`               | Show help                                                                                                                                                                                                                                                               |
 
 Workspace names for `--only` match the package directory name (e.g., `arrays`, `release-kit`).
@@ -574,8 +584,8 @@ Workspace names for `--only` match the package directory name (e.g., `arrays`, `
 
 `--with-release-notes` writes two versioned files per workspace after each workspace's `changelog.json` is produced:
 
-- `{workspacePath}/docs/README.v{version}.md` — the workspace `README.md` with release notes injected at the `<!-- section:release-notes -->` marker.
-- `{workspacePath}/docs/RELEASE_NOTES.v{version}.md` — the standalone release notes for this version.
+- `<workspacePath>/docs/README.v<version>.md` — the workspace `README.md` with release notes injected at the `<!-- section:release-notes -->` marker.
+- `<workspacePath>/docs/RELEASE_NOTES.v<version>.md` — the standalone release notes for this version.
 
 The publish-time inject-and-revert lifecycle is unchanged; previews are additive, deterministic, and safe to regenerate. When `changelogJson.enabled` is `false`, the flag logs a warning and skips preview generation. In dry-run mode, planned writes are logged and no files are created.
 
@@ -890,6 +900,8 @@ rdy list --from npm:@williamthorsen/release-kit                  # what release-
 
 `--packages` is the form that survives release-kit publishing further kits. Every form needs `readyup` 0.23 or later, and `@williamthorsen/release-kit` as a _direct_ devDependency: a strict pnpm layout links nothing else into the project, so a transitive copy is unreachable.
 
+`npm-auto-publish` queries the npm registry for each package's trusted publisher, so it needs an authenticated npm session and is meant to be invoked deliberately rather than swept up by an unattended run. Without a login it reports one error naming the missing login and blocks the rest of the `packages` checklist, rather than reporting a trusted-publisher failure for every package.
+
 These kits are no longer reachable through `rdy run --from github:williamthorsen/node-monorepo-tools`. Repos still using that form should switch to one of the invocations above.
 
 ## External dependencies

package/bin/release-kit.js

@@ -3,7 +3,7 @@ try {
   await import('../dist/esm/bin/release-kit.js');
 } catch (error) {
   if (error.code === 'ERR_MODULE_NOT_FOUND') {
-    process.stderr.write('release-kit: build output not found — run `pnpm run build` first\n');
+    process.stderr.write('release-kit: build output not found — run `nmr build` first\n');
   } else {
     process.stderr.write(`release-kit: failed to load: ${error.message}\n`);
   }

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

@@ -263,7 +263,7 @@ if (command === '--version' || command === '-V') {
     console.info(VERSION);
     process.exit(0);
 }
-if (command === '--help' || command === '-h' || command === undefined) {
+if (command === undefined || ['--help', '-h'].includes(command)) {
     showUsage();
     process.exit(0);
 }
@@ -350,7 +350,7 @@ if (command === 'init') {
 if (command === 'sync-labels') {
     const subcommand = flags[0];
     const subflags = flags.slice(1);
-    if (subcommand === '--help' || subcommand === '-h' || subcommand === undefined) {
+    if (subcommand === undefined || ['--help', '-h'].includes(subcommand)) {
         showSyncLabelsHelp();
         process.exit(0);
     }
@@ -398,7 +398,7 @@ if (command === 'sync-labels') {
 if (command === 'overrides') {
     const subcommand = flags[0];
     const subflags = flags.slice(1);
-    if (subcommand === '--help' || subcommand === '-h' || subcommand === undefined) {
+    if (subcommand === undefined || ['--help', '-h'].includes(subcommand)) {
         showOverridesHelp();
         process.exit(0);
     }
@@ -427,7 +427,7 @@ if (command === 'overrides') {
 if (command === 'work-types') {
     const subcommand = flags[0];
     const subflags = flags.slice(1);
-    if (subcommand === '--help' || subcommand === '-h' || subcommand === undefined) {
+    if (subcommand === undefined || ['--help', '-h'].includes(subcommand)) {
         showWorkTypesHelp();
         process.exit(0);
     }

package/dist/esm/buildChangelogEntries.js

@@ -20,7 +20,8 @@ export function buildChangelogEntries(config, tag, options) {
     if (options?.tagPattern !== undefined) {
         cliffArgs.push('--tag-pattern', options.tagPattern);
     }
-    for (const includePath of options?.includePaths ?? []) {
+    const includePaths = options?.includePaths ?? [];
+    for (const includePath of includePaths) {
         cliffArgs.push('--include-path', includePath);
     }
     try {
@@ -30,7 +31,7 @@ export function buildChangelogEntries(config, tag, options) {
         return transformReleases(releases, devOnlySections);
     }
     catch (error) {
-        throw new Error(`Failed to build changelog entries for tag ${tag}: ${error instanceof Error ? error.message : String(error)}`);
+        throw new Error(`Failed to build changelog entries for tag ${tag}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
     }
 }
 function parseCliffContext(json) {
@@ -45,14 +46,14 @@ function toCliffContextRelease(value) {
         return {};
     }
     const release = {};
-    if (typeof value.version === 'string') {
-        release.version = value.version;
+    if (typeof value['version'] === 'string') {
+        release.version = value['version'];
     }
-    if (typeof value.timestamp === 'number') {
-        release.timestamp = value.timestamp;
+    if (typeof value['timestamp'] === 'number') {
+        release.timestamp = value['timestamp'];
     }
-    if (isUnknownArray(value.commits)) {
-        release.commits = value.commits.map(toCliffContextCommit);
+    if (isUnknownArray(value['commits'])) {
+        release.commits = value['commits'].map(toCliffContextCommit);
     }
     return release;
 }
@@ -61,13 +62,13 @@ function toCliffContextCommit(value) {
         return { message: '' };
     }
     const commit = {
-        message: typeof value.message === 'string' ? value.message : '',
+        message: typeof value['message'] === 'string' ? value['message'] : '',
     };
-    if (typeof value.group === 'string') {
-        commit.group = value.group;
+    if (typeof value['group'] === 'string') {
+        commit.group = value['group'];
     }
-    if (typeof value.id === 'string') {
-        commit.id = value.id;
+    if (typeof value['id'] === 'string') {
+        commit.id = value['id'];
     }
     return commit;
 }
@@ -79,9 +80,10 @@ function transformReleases(releases, devOnlySections) {
             continue;
         }
         const version = extractVersion(release.version);
-        const date = release.timestamp !== undefined ? new Date(release.timestamp * 1000).toISOString().slice(0, 10) : 'unreleased';
+        const date = release.timestamp !== undefined ? new Date(release.timestamp * 1_000).toISOString().slice(0, 10) : 'unreleased';
         const sectionMap = new Map();
-        for (const commit of release.commits ?? []) {
+        const commits = release.commits ?? [];
+        for (const commit of commits) {
             const group = stripCommentPrefix(commit.group ?? 'Other');
             const description = extractDescription(commit.message);
             const body = extractBody(commit.message);

package/dist/esm/buildDependencyGraph.js

@@ -51,14 +51,18 @@ function readPackageJsonSubset(filePath) {
         content = readFileSync(filePath, 'utf8');
     }
     catch (error) {
-        throw new Error(`Failed to read ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        throw new Error(`Failed to read ${filePath}: ${error instanceof Error ? error.message : String(error)}`, {
+            cause: error,
+        });
     }
     let parsed;
     try {
         parsed = JSON.parse(content);
     }
     catch (error) {
-        throw new Error(`Failed to parse JSON in ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        throw new Error(`Failed to parse JSON in ${filePath}: ${error instanceof Error ? error.message : String(error)}`, {
+            cause: error,
+        });
     }
     if (!isPackageJsonSubset(parsed)) {
         throw new Error(`Invalid package.json at ${filePath}`);

package/dist/esm/buildReleaseSummary.d.ts

@@ -1,2 +1,2 @@
 import type { PrepareResult } from './types.js';
-export declare function buildReleaseSummary(result: PrepareResult): string;
+export declare function buildReleaseSummary(result: Pick<PrepareResult, 'project' | 'workspaces'>): string;

package/dist/esm/changelogJsonFile.d.ts

@@ -1,6 +1,4 @@
 import type { ChangelogEntry, ReleaseConfig } from './types.js';
 export declare function resolveChangelogJsonPath(config: Pick<ReleaseConfig, 'changelogJson'>, changelogPath: string): string;
-export declare function writeChangelogJson(filePath: string, entries: ChangelogEntry[]): string;
-export declare function upsertChangelogJson(filePath: string, entries: ChangelogEntry[]): string;
-export declare function upsertChangelogJsonAndReturn(filePath: string, entries: ChangelogEntry[]): ChangelogEntry[];
+export declare function renderChangelogJson(entries: ChangelogEntry[]): string;
 export declare function mergeChangelogEntriesWithDisk(filePath: string, entries: ChangelogEntry[]): ChangelogEntry[];

package/dist/esm/changelogJsonFile.js

@@ -1,5 +1,5 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
 import stringify from 'json-stringify-pretty-compact';
 import semver from 'semver';
 import { isChangelogEntry } from "./changelogJsonUtils.js";
@@ -7,22 +7,8 @@ import { isUnknownArray } from "./typeGuards.js";
 export function resolveChangelogJsonPath(config, changelogPath) {
     return join(changelogPath, config.changelogJson.outputPath);
 }
-export function writeChangelogJson(filePath, entries) {
-    const sorted = sortNewestFirst(entries);
-    mkdirSync(dirname(filePath), { recursive: true });
-    writeFileSync(filePath, stringify(sorted, { maxLength: 100 }) + '\n', 'utf8');
-    return filePath;
-}
-export function upsertChangelogJson(filePath, entries) {
-    upsertChangelogJsonAndReturn(filePath, entries);
-    return filePath;
-}
-export function upsertChangelogJsonAndReturn(filePath, entries) {
-    const existing = readExistingEntries(filePath);
-    const merged = mergeEntries(entries, existing);
-    mkdirSync(dirname(filePath), { recursive: true });
-    writeFileSync(filePath, stringify(merged, { maxLength: 100 }) + '\n', 'utf8');
-    return merged;
+export function renderChangelogJson(entries) {
+    return stringify(sortNewestFirst(entries), { maxLength: 100 }) + '\n';
 }
 export function mergeChangelogEntriesWithDisk(filePath, entries) {
     const existing = readExistingEntries(filePath);

package/dist/esm/changelogJsonUtils.js

@@ -3,21 +3,21 @@ import { isRecord, isUnknownArray } from "./typeGuards.js";
 export function isChangelogItem(value) {
     if (!isRecord(value))
         return false;
-    if (typeof value.description !== 'string')
+    if (typeof value['description'] !== 'string')
         return false;
-    if (value.body !== undefined && typeof value.body !== 'string')
+    if (value['body'] !== undefined && typeof value['body'] !== 'string')
         return false;
-    if (value.breaking !== undefined && typeof value.breaking !== 'boolean')
+    if (value['breaking'] !== undefined && typeof value['breaking'] !== 'boolean')
         return false;
-    if (value.hash !== undefined && typeof value.hash !== 'string')
+    if (value['hash'] !== undefined && typeof value['hash'] !== 'string')
         return false;
     return true;
 }
 export function isChangelogEntry(value) {
     return (isRecord(value) &&
-        typeof value.version === 'string' &&
-        typeof value.date === 'string' &&
-        isUnknownArray(value.sections));
+        typeof value['version'] === 'string' &&
+        typeof value['date'] === 'string' &&
+        isUnknownArray(value['sections']));
 }
 export function extractVersion(tag) {
     const match = /(\d+\.\d+\.\d+.*)$/.exec(tag);

package/dist/esm/changelogOverrides.js

@@ -66,8 +66,8 @@ function validateSingleOverride(key, rawEntry, errors) {
         entryValid = false;
     }
     const result = {};
-    if (rawEntry.audience !== undefined) {
-        const audienceResult = validateAudience(key, rawEntry.audience, errors);
+    if (rawEntry['audience'] !== undefined) {
+        const audienceResult = validateAudience(key, rawEntry['audience'], errors);
         if (audienceResult === undefined) {
             entryValid = false;
         }
@@ -75,31 +75,31 @@ function validateSingleOverride(key, rawEntry, errors) {
             result.audience = audienceResult;
         }
     }
-    if (rawEntry.description !== undefined) {
-        if (typeof rawEntry.description !== 'string') {
+    if (rawEntry['description'] !== undefined) {
+        if (typeof rawEntry['description'] !== 'string') {
             errors.push(`overrides['${key}']: 'description' must be a string`);
             entryValid = false;
         }
         else {
-            result.description = rawEntry.description;
+            result.description = rawEntry['description'];
         }
     }
-    if (rawEntry.body !== undefined) {
-        if (typeof rawEntry.body !== 'string') {
+    if (rawEntry['body'] !== undefined) {
+        if (typeof rawEntry['body'] !== 'string') {
             errors.push(`overrides['${key}']: 'body' must be a string`);
             entryValid = false;
         }
         else {
-            result.body = rawEntry.body;
+            result.body = rawEntry['body'];
         }
     }
-    if (rawEntry.breaking !== undefined) {
-        if (typeof rawEntry.breaking !== 'boolean') {
+    if (rawEntry['breaking'] !== undefined) {
+        if (typeof rawEntry['breaking'] !== 'boolean') {
             errors.push(`overrides['${key}']: 'breaking' must be a boolean`);
             entryValid = false;
         }
         else {
-            result.breaking = rawEntry.breaking;
+            result.breaking = rawEntry['breaking'];
         }
     }
     if (Object.keys(result).length === 0 && entryValid) {
@@ -236,7 +236,8 @@ export function loadOverridesForScopes(scopes) {
             project = result.overrides;
         }
     }
-    for (const workspacePath of scopes.workspaces ?? []) {
+    const workspacePaths = scopes.workspaces ?? [];
+    for (const workspacePath of workspacePaths) {
         const result = loadChangelogOverrides(resolveOverridePath(workspacePath));
         if ('errors' in result) {
             errors.push(...result.errors);

package/dist/esm/checkWorkTypesDrift.js

@@ -80,7 +80,7 @@ function stripLocalOnlyFields(value) {
         return value;
     }
     const record = { ...value };
-    delete record.$schema;
+    delete record['$schema'];
     return record;
 }
 function deepEqual(a, b) {

package/dist/esm/commitCommand.js

@@ -1,25 +1,15 @@
 import { execFileSync } from 'node:child_process';
 import { readFileSync } from 'node:fs';
 import { GIT_OUTPUT_LIMIT, parseArgsOrExit } from '@williamthorsen/nmr-core';
-import { RELEASE_SUMMARY_FILE, RELEASE_TAGS_FILE } from "./prepareCommand.js";
+import { readReleaseTags, RELEASE_SUMMARY_FILE, resolveReleaseTagsPath } from "./releaseFiles.js";
 const commitFlagSchema = {
     dryRun: { long: '--dry-run', type: 'boolean' },
 };
 export function commitCommand(argv) {
     const dryRun = parseArgsOrExit(argv, commitFlagSchema).flags.dryRun;
-    let tagsContent;
-    try {
-        tagsContent = readFileSync(RELEASE_TAGS_FILE, 'utf8');
-    }
-    catch {
-        throw new Error('No tags file found. Run `release-kit prepare` first.');
-    }
-    const tags = tagsContent
-        .split('\n')
-        .map((line) => line.trim())
-        .filter((line) => line.length > 0);
+    const tags = readReleaseTags();
     if (tags.length === 0) {
-        throw new Error('Tags file is empty. Run `release-kit prepare` first.');
+        throw new Error(`Tags file at ${resolveReleaseTagsPath()} is empty. Run \`release-kit prepare\` first.`);
     }
     let summary = '';
     try {

package/dist/esm/createTags.js

@@ -1,21 +1,10 @@
 import { execFileSync } from 'node:child_process';
-import { readFileSync } from 'node:fs';
 import { GIT_OUTPUT_LIMIT } from '@williamthorsen/nmr-core';
 import { deleteFileIfExists } from "./deleteFileIfExists.js";
-import { RELEASE_SUMMARY_FILE, RELEASE_TAGS_FILE } from "./prepareCommand.js";
+import { readReleaseTags, RELEASE_SUMMARY_FILE, RELEASE_TAGS_FILE } from "./releaseFiles.js";
 export function createTags(options) {
     const { dryRun, noGitChecks } = options;
-    let content;
-    try {
-        content = readFileSync(RELEASE_TAGS_FILE, 'utf8');
-    }
-    catch {
-        throw new Error('No tags file found. Run `release-kit prepare` first.');
-    }
-    const tags = content
-        .split('\n')
-        .map((line) => line.trim())
-        .filter((line) => line.length > 0);
+    const tags = readReleaseTags();
     if (tags.length === 0) {
         return [];
     }
@@ -62,6 +51,6 @@ function assertCleanWorkingTree() {
         if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
             throw error;
         }
-        throw new Error('Working tree is dirty. Commit or stash changes before tagging, or use `--no-git-checks` to skip this check.');
+        throw new Error('Working tree is dirty. Commit or stash changes before tagging, or use `--no-git-checks` to skip this check.', { cause: error });
     }
 }

package/dist/esm/deriveWorkspaceConfig.js

@@ -10,14 +10,14 @@ export function deriveWorkspaceConfig(workspacePath) {
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        throw new Error(`Failed to read ${packageJsonPath}: ${message}`);
+        throw new Error(`Failed to read ${packageJsonPath}: ${message}`, { cause: error });
     }
-    const name = isRecord(parsed) ? parsed.name : undefined;
+    const name = isRecord(parsed) ? parsed['name'] : undefined;
     if (typeof name !== 'string' || name.length === 0) {
         throw new Error(`${packageJsonPath} is missing a 'name' field (required for tag derivation).`);
     }
     const unscopedName = stripNpmScope(name);
-    const privateField = isRecord(parsed) ? parsed.private : undefined;
+    const privateField = isRecord(parsed) ? parsed['private'] : undefined;
     const isPublishable = privateField === undefined || privateField === false;
     return {
         dir,

package/dist/esm/detectPackageManager.js

@@ -6,8 +6,8 @@ export function detectPackageManager() {
     try {
         const content = readFileSync(packageJsonPath, 'utf8');
         const parsed = JSON.parse(content);
-        if (isRecord(parsed) && typeof parsed.packageManager === 'string') {
-            const [name, version] = parsed.packageManager.split('@', 2);
+        if (isRecord(parsed) && typeof parsed['packageManager'] === 'string') {
+            const [name, version] = parsed['packageManager'].split('@', 2);
             if (name === 'pnpm' || name === 'npm') {
                 return name;
             }

package/dist/esm/detectUndeclaredTagPrefixes.js

@@ -23,7 +23,7 @@ export function detectUndeclaredTagPrefixes(knownPrefixes) {
         const match = CANDIDATE_TAG_PATTERN.exec(tag);
         if (match === null)
             continue;
-        const prefix = match.groups?.prefix ?? '';
+        const prefix = match.groups?.['prefix'] ?? '';
         if (prefix === '' || known.has(prefix))
             continue;
         let tags = grouped.get(prefix);

package/dist/esm/discoverWorkspaces.js

@@ -20,7 +20,7 @@ export async function discoverWorkspaces() {
     if (!isRecord(parsed)) {
         return undefined;
     }
-    const packagesField = parsed.packages;
+    const packagesField = parsed['packages'];
     if (!Array.isArray(packagesField)) {
         return undefined;
     }

package/dist/esm/getCommitsSinceTarget.js

@@ -24,7 +24,7 @@ function findLatestTag(tagPrefixes) {
         if (isNoTagError(error)) {
             return undefined;
         }
-        throw new Error(`Failed to run 'git describe': ${errorMessage(error)}`);
+        throw new Error(`Failed to run 'git describe': ${errorMessage(error)}`, { cause: error });
     }
 }
 const RELEASE_COMMIT_PREFIX = 'release:';
@@ -59,7 +59,7 @@ export function getCommitsSinceTarget(tagPrefixes, paths) {
         }).trim();
     }
     catch (error) {
-        throw new Error(`Failed to run 'git log' for range '${range}': ${errorMessage(error)}`);
+        throw new Error(`Failed to run 'git log' for range '${range}': ${errorMessage(error)}`, { cause: error });
     }
     if (logOutput === '') {
         return { tag, commits: [] };

package/dist/esm/help/prepareHelp.d.ts

@@ -1,2 +1,2 @@
-export declare const prepareHelpText = "\nUsage: release-kit prepare [options]\n\nRun release preparation with automatic workspace discovery.\n\nOptions:\n  --dry-run             Run without modifying any files\n  --bump=major|minor|patch  Override the bump type for all workspaces\n  --set-version=X.Y.Z   Set an explicit version; bypasses commit-derived bumps.\n                         Requires --only in monorepo mode (rejected when a 'project' block is configured).\n  --force               Release even when no commits or no bump-worthy commits exist\n                         since the last tag. In monorepo and project mode, defaults to\n                         patch when --bump is not given; use --bump=X for a different\n                         level. In single-package mode, a bare --force is rejected \u2014\n                         pass --bump=major|minor|patch.\n  --no-git-checks, -n   Skip the clean-working-tree check\n  --only=name1,name2    Only process the named workspaces (comma-separated, monorepo only;\n                         rejected when a 'project' block is configured)\n  --with-release-notes  Also write per-workspace release-notes previews under {workspacePath}/docs/\n                         (docs/README.v{version}.md and docs/RELEASE_NOTES.v{version}.md).\n                         Recommended .gitignore entry: packages/*/docs/*.v*.md (or docs/*.v*.md).\n  --help, -h            Show this help message\n";
+export declare const prepareHelpText = "\nUsage: release-kit prepare [options]\n\nRun release preparation with automatic workspace discovery.\n\nOptions:\n  --dry-run             Run without modifying any files\n  --bump=major|minor|patch  Override the bump type for all workspaces\n  --set-version=X.Y.Z   Set an explicit version; bypasses commit-derived bumps.\n                         Requires --only in monorepo mode (rejected when a 'project' block is configured).\n  --force               Release even when no commits or no bump-worthy commits exist\n                         since the last tag. In monorepo and project mode, defaults to\n                         patch when --bump is not given; use --bump=X for a different\n                         level. In single-package mode, a bare --force is rejected \u2014\n                         pass --bump=major|minor|patch.\n  --no-git-checks, -n   Skip the clean-working-tree check\n  --only=name1,name2    Only process the named workspaces (comma-separated, monorepo only;\n                         rejected when a 'project' block is configured)\n  --with-release-notes  Also write per-workspace release-notes previews under <workspacePath>/docs/\n                         (docs/README.v<version>.md and docs/RELEASE_NOTES.v<version>.md).\n                         Recommended .gitignore entry: packages/*/docs/*.v*.md (or docs/*.v*.md).\n  --help, -h            Show this help message\n";
 export declare function showPrepareHelp(): void;

package/dist/esm/help/prepareHelp.js

@@ -16,8 +16,8 @@ Options:
   --no-git-checks, -n   Skip the clean-working-tree check
   --only=name1,name2    Only process the named workspaces (comma-separated, monorepo only;
                          rejected when a 'project' block is configured)
-  --with-release-notes  Also write per-workspace release-notes previews under {workspacePath}/docs/
-                         (docs/README.v{version}.md and docs/RELEASE_NOTES.v{version}.md).
+  --with-release-notes  Also write per-workspace release-notes previews under <workspacePath>/docs/
+                         (docs/README.v<version>.md and docs/RELEASE_NOTES.v<version>.md).
                          Recommended .gitignore entry: packages/*/docs/*.v*.md (or docs/*.v*.md).
   --help, -h            Show this help message
 `;

package/dist/esm/init/checks.js

@@ -23,7 +23,7 @@ export function usesPnpm() {
     }
     const raw = readFileSync('package.json', 'utf8');
     const pkg = parseJsonRecord(raw);
-    if (pkg !== undefined && typeof pkg.packageManager === 'string' && pkg.packageManager.startsWith('pnpm')) {
+    if (pkg !== undefined && typeof pkg['packageManager'] === 'string' && pkg['packageManager'].startsWith('pnpm')) {
         return { ok: true };
     }
     return {

package/dist/esm/init/detectRepoType.js

@@ -7,7 +7,7 @@ export function detectRepoType() {
     if (existsSync('package.json')) {
         const raw = readFileSync('package.json', 'utf8');
         const pkg = parseJsonRecord(raw);
-        if (pkg !== undefined && Array.isArray(pkg.workspaces)) {
+        if (pkg !== undefined && Array.isArray(pkg['workspaces'])) {
             return 'monorepo';
         }
     }

package/dist/esm/injectReleaseNotesIntoReadme.d.ts

@@ -1,7 +1,9 @@
+import type { ChangelogEntry } from './types.js';
 export interface RenderedInjectedReadme {
     injectedReadme: string;
     releaseNotesMarkdown: string;
 }
+export declare function renderInjectedReadmeFromEntries(readme: string, entries: readonly ChangelogEntry[], tag: string, sectionOrder?: string[]): RenderedInjectedReadme | undefined;
 export declare function renderInjectedReadme(readme: string, changelogJsonPath: string, tag: string, sectionOrder?: string[]): RenderedInjectedReadme | undefined;
 export declare function injectReleaseNotesIntoReadme(readmePath: string, changelogJsonPath: string, tag: string, sectionOrder?: string[]): string | undefined;
 export declare function resolveReadmePath(workspacePath: string): string | undefined;

package/dist/esm/injectReleaseNotesIntoReadme.js

@@ -3,17 +3,8 @@ import { join } from 'node:path';
 import { extractVersion, readChangelogEntries } from "./changelogJsonUtils.js";
 import { injectSection } from "./injectSection.js";
 import { matchesAudience, renderReleaseNotesSingle } from "./renderReleaseNotes.js";
-export function renderInjectedReadme(readme, changelogJsonPath, tag, sectionOrder) {
-    if (!existsSync(changelogJsonPath)) {
-        console.warn(`Warning: ${changelogJsonPath} not found; skipping README injection`);
-        return undefined;
-    }
+export function renderInjectedReadmeFromEntries(readme, entries, tag, sectionOrder) {
     const version = extractVersion(tag);
-    const entries = readChangelogEntries(changelogJsonPath);
-    if (entries === undefined) {
-        console.warn(`Warning: could not parse ${changelogJsonPath}; skipping README injection`);
-        return undefined;
-    }
     const entry = entries.find((e) => e.version === version);
     if (entry === undefined) {
         console.warn(`Warning: no changelog entry for version ${version}; skipping README injection`);
@@ -33,6 +24,18 @@ export function renderInjectedReadme(readme, changelogJsonPath, tag, sectionOrde
     const injectedReadme = injectSection(readme, 'release-notes', releaseNotesMarkdown);
     return { injectedReadme, releaseNotesMarkdown };
 }
+export function renderInjectedReadme(readme, changelogJsonPath, tag, sectionOrder) {
+    if (!existsSync(changelogJsonPath)) {
+        console.warn(`Warning: ${changelogJsonPath} not found; skipping README injection`);
+        return undefined;
+    }
+    const entries = readChangelogEntries(changelogJsonPath);
+    if (entries === undefined) {
+        console.warn(`Warning: could not parse ${changelogJsonPath}; skipping README injection`);
+        return undefined;
+    }
+    return renderInjectedReadmeFromEntries(readme, entries, tag, sectionOrder);
+}
 export function injectReleaseNotesIntoReadme(readmePath, changelogJsonPath, tag, sectionOrder) {
     const originalReadme = readFileSync(readmePath, 'utf8');
     const rendered = renderInjectedReadme(originalReadme, changelogJsonPath, tag, sectionOrder);

package/dist/esm/loadConfig.js

@@ -23,19 +23,19 @@ export function readRootPackageVersion() {
         contents = readFileSync(absolutePath, 'utf8');
     }
     catch (error) {
-        throw new Error(`Failed to read root ${ROOT_PACKAGE_JSON_PATH}: ${error instanceof Error ? error.message : String(error)}`);
+        throw new Error(`Failed to read root ${ROOT_PACKAGE_JSON_PATH}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
     }
     let parsed;
     try {
         parsed = JSON.parse(contents);
     }
     catch (error) {
-        throw new Error(`Failed to parse root ${ROOT_PACKAGE_JSON_PATH}: ${error instanceof Error ? error.message : String(error)}`);
+        throw new Error(`Failed to parse root ${ROOT_PACKAGE_JSON_PATH}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
     }
     if (!isRecord(parsed)) {
         return { exists: true, version: undefined };
     }
-    return { exists: true, version: typeof parsed.version === 'string' ? parsed.version : undefined };
+    return { exists: true, version: typeof parsed['version'] === 'string' ? parsed['version'] : undefined };
 }
 export const CONFIG_FILE_PATH = '.config/release-kit.config.ts';
 export async function loadConfig() {
@@ -44,7 +44,7 @@ export async function loadConfig() {
         return undefined;
     }
     const imported = await import(__rewriteRelativeImportExtension(pathToFileURL(absoluteConfigPath).href));
-    const resolved = isRecord(imported) ? (imported.default ?? imported.config) : undefined;
+    const resolved = isRecord(imported) ? (imported['default'] ?? imported['config']) : undefined;
     if (resolved === undefined) {
         throw new Error('Config file must have a default export or a named `config` export (e.g., `export default { ... }` or `export const config = { ... }`)');
     }
@@ -177,7 +177,8 @@ function assertNoTagPrefixCollisions(workspaces, retiredPackages, project) {
     for (const workspace of workspaces) {
         const owner = `ws:${workspace.dir}`;
         sources.push({ prefix: workspace.tagPrefix, label: `workspace '${workspace.dir}'`, owner });
-        for (const identity of workspace.legacyIdentities ?? []) {
+        const legacyIdentities = workspace.legacyIdentities ?? [];
+        for (const identity of legacyIdentities) {
             sources.push({
                 prefix: identity.tagPrefix,
                 label: `workspace '${workspace.dir}' legacyIdentities entry (name='${identity.name}')`,
@@ -185,7 +186,8 @@ function assertNoTagPrefixCollisions(workspaces, retiredPackages, project) {
             });
         }
     }
-    for (const [index, retired] of (retiredPackages ?? []).entries()) {
+    const retiredEntries = (retiredPackages ?? []).entries();
+    for (const [index, retired] of retiredEntries) {
         sources.push({
             prefix: retired.tagPrefix,
             label: `retiredPackages entry (name='${retired.name}')`,