@williamthorsen/release-kit 10.4.0 → 10.4.1

package/.readyup/kits/default.js

@@ -1,6 +1,6 @@
 /** @noformat — @generated. Do not edit. Compiled by rdy. */
 /* eslint-disable */
-export const __readyupVersion = "0.28.0";
+export const __readyupVersion = "0.29.0";
 
 
 // .readyup/kits/default.ts
@@ -52,7 +52,7 @@ function detectRepoType() {
 
 // .readyup/kits/default.ts
 function getMinVersion() {
-  const picked = { "version": "10.4.0" };
+  const picked = { "version": "10.4.1" };
   if (typeof picked["version"] !== "string") {
     throw new TypeError("release-kit/package.json: 'version' must be a string");
   }

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

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

package/.readyup/manifest.json

@@ -13,7 +13,7 @@
           "path": "kits/default.ts"
         },
         {
-          "hash": "07509c48",
+          "hash": "bbdcc849",
           "kind": "inline",
           "path": "../package.json",
           "paths": [
@@ -38,10 +38,10 @@
       ],
       "name": "default",
       "path": "kits/default.js",
-      "readyupVersion": "0.28.0",
+      "readyupVersion": "0.29.0",
       "source": "kits/default.ts",
       "sourceHash": "fe239d01",
-      "targetHash": "5413984b"
+      "targetHash": "6ba7f24f"
     },
     {
       "checklists": [
@@ -58,10 +58,10 @@
       ],
       "name": "npm-auto-publish",
       "path": "kits/npm-auto-publish.js",
-      "readyupVersion": "0.28.0",
+      "readyupVersion": "0.29.0",
       "source": "kits/npm-auto-publish.ts",
       "sourceHash": "ac484613",
-      "targetHash": "0636c995"
+      "targetHash": "c7b01e0b"
     }
   ]
 }

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to this project will be documented in this file.
 
+## 10.4.1 — 2026-08-18
+
+### 🐛 Bug fixes
+
+- Accept `--only` under a project block, skipping the project release (#702)
+
+  Fixes an issue where `release-kit prepare --only` exited with an error in any repo whose config declares a `project` block, which left the `only` dispatch input that `release-kit init` scaffolds into `release.yaml` unusable. A narrowed run now releases the named workspaces and skips the project release, reporting the skip and the selection that caused it as a warning.
+
+- Route release-notes preview warnings through the prepare plan (#705)
+
+  Fixes an issue where `release-kit prepare --with-release-notes` printed its diagnostics to stderr ahead of the release report, and described a skipped release-notes preview as a skipped README injection. The messages now render as `⚠️` lines inside the report and are worded for release-notes previews; a skip belonging to one workspace names that workspace.
+
 ## 10.4.0 — 2026-08-17
 
 ### 🎉 Features

package/README.md

@@ -5,15 +5,17 @@ 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.4.0 (2026-08-17)
+## Release notes — v10.4.1 (2026-08-18)
 
-### 🎉 Features
+### 🐛 Bug fixes
 
-- Let a project release cover repo-root paths (#685)
+- Accept `--only` under a project block, skipping the project release (#702)
 
-  Extends `release-kit`'s project release to a repo whose content lives at the root. Such a repo declares `project: { paths: ['**'] }` and gets the root `CHANGELOG.md`, the root `.meta/changelog.json`, the `--with-release-notes` previews under root `docs/`, the root `package.json` bump, and the project tag that the stage produces.
+  Fixes an issue where `release-kit prepare --only` exited with an error in any repo whose config declares a `project` block, which left the `only` dispatch input that `release-kit init` scaffolds into `release.yaml` unusable. A narrowed run now releases the named workspaces and skips the project release, reporting the skip and the selection that caused it as a warning.
 
-  `paths` scopes any project release's window, not only the whole-tree case, and the project tier of `release-kit validate-overrides` with it. A declared value replaces the workspace union rather than extending it; omitting `paths` resolves to that union, so existing consumers see no change.
+- Route release-notes preview warnings through the prepare plan (#705)
+
+  Fixes an issue where `release-kit prepare --with-release-notes` printed its diagnostics to stderr ahead of the release report, and described a skipped release-notes preview as a skipped README injection. The messages now render as `⚠️` lines inside the report and are worded for release-notes previews; a skip belonging to one workspace names that workspace.
 <!-- /section:release-notes -->
 
 ## Installation
@@ -262,7 +264,7 @@ CLI flag interactions:
 - `--dry-run` previews project artifacts alongside workspace artifacts; no files are written.
 - `--bump=major|minor|patch` propagates to the project release as a level chooser. It does not trigger a release on its own when there are no commits or no bump-worthy commits.
 - `--force` runs the project release even when no commits or no bump-worthy commits exist since the last project tag. Defaults to patch when `--bump` is not given; combine with `--bump=X` to release at a different level.
-- `--only` is rejected with an error when `project` is configured. `--only` is a surgical, single-workspace operation; combining it with a project release that rolls up every contributing workspace would create ambiguous semantics. To release a single workspace, use a config without a `project` block, or run a full `prepare` (no `--only`) to include the project release.
+- `--only` narrows the run to the named workspaces and skips the project release, which is reported as a warning. The project release rolls up every contributing workspace, and `--only` changes which workspaces those are, so rolling up a narrowed set would release a project version covering work the run excluded. Run a full `prepare` (no `--only`) to include the project release.
 - `--set-version` is rejected with an error when `project` is configured. `--set-version` operates on a single workspace, but a project release rolls up every contributing workspace; the two semantics don't compose. To use `--set-version`, run on a config without a `project` block.
 
 `--bump` and `--force` are orthogonal: `--bump` is purely a level chooser; `--force` is purely a release trigger. Examples:
@@ -468,7 +470,7 @@ Per-entry fields are all optional, but at least one must be present per entry:
 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:
 
 - **Exact prefix match (1 hit)** — the override applies. A 7-character prefix is usually unambiguous within a single repo's history; longer prefixes are always safe.
-- **No matches (0 hits)** — the override is treated as a stale reference (probably from a rebase or branch deletion) and a warning is logged. The release continues.
+- **No matches (0 hits)** — the override is treated as a stale reference (probably from a rebase or branch deletion) and prepare reports a warning. The release continues.
 - **Ambiguous prefix (2+ hits)** — the release aborts with an error naming the key and the matching hashes. Lengthen the prefix or use the full SHA.
 
 Override application errors abort the run with a non-zero exit; warnings (zero-match keys) are non-fatal and surface on `PrepareResult.warnings`.
@@ -581,9 +583,9 @@ Run release preparation with automatic workspace discovery.
 | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `--dry-run`                  | Preview changes without writing files                                                                                                                                                                                                                                   |
 | `--bump=major\|minor\|patch` | Override the bump type for all workspaces                                                                                                                                                                                                                               |
-| `--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).                                                                                                            |
+| `--set-version=X.Y.Z`        | Set an explicit canonical semver version; bypasses commit-derived bumps. In monorepo mode it requires `--only`, and is 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)                                                                                                                                                                        |
+| `--only=name1,name2`         | Only process the named workspaces (monorepo only). When a `project` block is configured, the project release is skipped.                                                                                                                                                |
 | `--with-release-notes`       | Write per-workspace release-notes previews under `<workspacePath>/docs/`                                                                                                                                                                                                |
 | `--help`, `-h`               | Show help                                                                                                                                                                                                                                                               |
 
@@ -596,7 +598,7 @@ Workspace names for `--only` match the package directory name (e.g., `arrays`, `
 - `<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.
+The publish-time inject-and-revert lifecycle is unchanged; previews are additive, deterministic, and safe to regenerate. When `changelogJson.enabled` is `false`, prepare reports a warning and skips preview generation. In dry-run mode, planned writes are logged and no files are created.
 
 Because preview filenames are versioned, committing them will accumulate files over time. The recommended `.gitignore` entry for monorepos is:
 

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. In monorepo\n                         mode it requires --only, and is 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                         When a 'project' block is configured, the project release is skipped.\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

@@ -6,16 +6,16 @@ Run release preparation with automatic workspace discovery.
 Options:
   --dry-run             Run without modifying any files
   --bump=major|minor|patch  Override the bump type for all workspaces
-  --set-version=X.Y.Z   Set an explicit version; bypasses commit-derived bumps.
-                         Requires --only in monorepo mode (rejected when a 'project' block is configured).
+  --set-version=X.Y.Z   Set an explicit version; bypasses commit-derived bumps. In monorepo
+                         mode it requires --only, and is 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 and project mode, defaults to
                          patch when --bump is not given; use --bump=X for a different
                          level. In single-package mode, a bare --force is rejected —
                          pass --bump=major|minor|patch.
   --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)
+  --only=name1,name2    Only process the named workspaces (comma-separated, monorepo only).
+                         When a 'project' block is configured, the project release is skipped.
   --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).

package/dist/esm/injectReleaseNotesIntoReadme.d.ts

@@ -3,7 +3,16 @@ export interface RenderedInjectedReadme {
     injectedReadme: string;
     releaseNotesMarkdown: string;
 }
-export declare function renderInjectedReadmeFromEntries(readme: string, entries: readonly ChangelogEntry[], tag: string, sectionOrder?: string[]): RenderedInjectedReadme | undefined;
+export type RenderInjectedReadmeSkipReason = 'no-entry' | 'empty-body';
+export type RenderInjectedReadmeResult = {
+    status: 'rendered';
+    rendered: RenderedInjectedReadme;
+} | {
+    status: 'skipped';
+    reason: RenderInjectedReadmeSkipReason;
+    version: string;
+};
+export declare function renderInjectedReadmeFromEntries(readme: string, entries: readonly ChangelogEntry[], tag: string, sectionOrder?: string[]): RenderInjectedReadmeResult;
 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

@@ -7,8 +7,7 @@ export function renderInjectedReadmeFromEntries(readme, entries, tag, sectionOrd
     const version = extractVersion(tag);
     const entry = entries.find((e) => e.version === version);
     if (entry === undefined) {
-        console.warn(`Warning: no changelog entry for version ${version}; skipping README injection`);
-        return undefined;
+        return { status: 'skipped', reason: 'no-entry', version };
     }
     const renderedSections = renderReleaseNotesSingle(entry, {
         filter: matchesAudience('all'),
@@ -16,13 +15,12 @@ export function renderInjectedReadmeFromEntries(readme, entries, tag, sectionOrd
         ...(sectionOrder !== undefined && { sectionOrder }),
     });
     if (renderedSections.trimEnd().length === 0) {
-        console.warn(`Warning: no user-facing release notes for version ${version}; skipping README injection`);
-        return undefined;
+        return { status: 'skipped', reason: 'empty-body', version };
     }
     const labeledHeading = `## Release notes — v${version} (${entry.date})`;
     const releaseNotesMarkdown = `${labeledHeading}\n\n${renderedSections.trimEnd()}`;
     const injectedReadme = injectSection(readme, 'release-notes', releaseNotesMarkdown);
-    return { injectedReadme, releaseNotesMarkdown };
+    return { status: 'rendered', rendered: { injectedReadme, releaseNotesMarkdown } };
 }
 export function renderInjectedReadme(readme, changelogJsonPath, tag, sectionOrder) {
     if (!existsSync(changelogJsonPath)) {
@@ -34,7 +32,12 @@ export function renderInjectedReadme(readme, changelogJsonPath, tag, sectionOrde
         console.warn(`Warning: could not parse ${changelogJsonPath}; skipping README injection`);
         return undefined;
     }
-    return renderInjectedReadmeFromEntries(readme, entries, tag, sectionOrder);
+    const result = renderInjectedReadmeFromEntries(readme, entries, tag, sectionOrder);
+    if (result.status === 'skipped') {
+        console.warn(`Warning: ${describeRenderSkip(result.reason, result.version)}; skipping README injection`);
+        return undefined;
+    }
+    return result.rendered;
 }
 export function injectReleaseNotesIntoReadme(readmePath, changelogJsonPath, tag, sectionOrder) {
     const originalReadme = readFileSync(readmePath, 'utf8');
@@ -49,3 +52,8 @@ export function resolveReadmePath(workspacePath) {
     const readmePath = join(workspacePath, 'README.md');
     return existsSync(readmePath) ? readmePath : undefined;
 }
+function describeRenderSkip(reason, version) {
+    return reason === 'no-entry'
+        ? `no changelog entry for version ${version}`
+        : `no user-facing release notes for version ${version}`;
+}

package/dist/esm/planReleaseNotesPreviews.js

@@ -2,16 +2,18 @@ import { existsSync, readFileSync } from 'node:fs';
 import path from 'node:path';
 import { describeError } from '@williamthorsen/toolbelt.errors';
 import { extractVersion } from "./changelogJsonUtils.js";
-import { renderInjectedReadmeFromEntries } from "./injectReleaseNotesIntoReadme.js";
+import { renderInjectedReadmeFromEntries, } from "./injectReleaseNotesIntoReadme.js";
 export function planReleaseNotesPreviews(options) {
     const { workspacePath, tag, entries, sectionOrder } = options;
     const warnings = [];
     const readmePath = path.join(workspacePath, 'README.md');
     const readme = readWorkspaceReadme(readmePath, warnings);
-    const rendered = renderInjectedReadmeFromEntries(readme.content, entries, tag, sectionOrder);
-    if (rendered === undefined) {
+    const result = renderInjectedReadmeFromEntries(readme.content, entries, tag, sectionOrder);
+    if (result.status === 'skipped') {
+        warnings.push(describePreviewSkip(workspacePath, result.reason, result.version));
         return { writes: [], warnings };
     }
+    const { rendered } = result;
     if (!readme.exists && !readme.unreadable) {
         warnings.push(`${readmePath} not found; skipping injected-README preview but still writing standalone release notes`);
     }
@@ -29,6 +31,12 @@ export function planReleaseNotesPreviews(options) {
     });
     return { writes, warnings };
 }
+function describePreviewSkip(workspacePath, reason, version) {
+    const cause = reason === 'no-entry'
+        ? `no changelog entry for version ${version}`
+        : `no user-facing release notes for version ${version}`;
+    return `${workspacePath}: ${cause}; skipping release-notes previews`;
+}
 function readWorkspaceReadme(readmePath, warnings) {
     if (!existsSync(readmePath)) {
         return { content: '', exists: false, unreadable: false };

package/dist/esm/prepareCommand.js

@@ -137,12 +137,6 @@ function runMonorepoMode(discoveredPaths, userConfig, options, only, setVersion,
             'contributing workspace. To use --set-version, run on a config without a `project` block.');
         process.exit(1);
     }
-    if (only !== undefined && config.project !== undefined) {
-        reportError('--only cannot be combined with a project release. ' +
-            'To release a single workspace, use a config without a `project` block, ' +
-            'or run a full `prepare` (no --only) to include the project release.');
-        process.exit(1);
-    }
     if (only !== undefined) {
         const knownNames = config.workspaces.map((w) => w.dir);
         for (const name of only) {
@@ -183,7 +177,7 @@ function runMonorepoMode(discoveredPaths, userConfig, options, only, setVersion,
             process.exit(1);
         }
     }
-    runAndReport(() => releasePrepareMono(config, options), dryRun);
+    runAndReport(() => releasePrepareMono(config, { ...options, ...(only !== undefined && { only }) }), dryRun);
 }
 async function loadAndValidateConfig() {
     let rawConfig;

package/dist/esm/releasePrepare.d.ts

@@ -4,6 +4,7 @@ export interface ReleasePrepareOptions {
     force?: boolean;
     bumpOverride?: ReleaseType;
     setVersion?: string;
+    only?: string[];
     withReleaseNotes?: boolean;
 }
 export declare function releasePrepare(config: ReleaseConfig, options: ReleasePrepareOptions): ReleasePlan;

package/dist/esm/releasePrepare.js

@@ -83,17 +83,17 @@ export function releasePrepare(config, options) {
     }
     writes.push(...bump.writes);
     const newTag = `${config.tagPrefix}${bump.newVersion}`;
-    const overrideWarnings = [];
+    const planWarnings = [];
     const changelogs = planSinglePackageChangelogs({
         config,
         commits,
         newTag,
         newVersion: bump.newVersion,
         overrides,
-        overrideWarnings,
+        overrideWarnings: planWarnings,
     });
     const { changelogFiles, changelogJsonFiles } = changelogs;
-    const previewWrites = planSinglePackagePreviews(withReleaseNotes === true, config, newTag, changelogs.entries, overrideWarnings);
+    const previewWrites = planSinglePackagePreviews(withReleaseNotes === true, config, newTag, changelogs.entries, planWarnings);
     writes.push(...changelogs.writes, ...previewWrites);
     const formatCommandStr = config.formatCommand ?? (hasPrettierConfig() ? 'npx prettier --write' : undefined);
     let formatCommand;
@@ -125,8 +125,8 @@ export function releasePrepare(config, options) {
         summary: buildReleaseSummary({ workspaces: [released] }),
         formatCommand,
     };
-    if (overrideWarnings.length > 0) {
-        plan.warnings = overrideWarnings;
+    if (planWarnings.length > 0) {
+        plan.warnings = planWarnings;
     }
     return plan;
 }
@@ -229,7 +229,7 @@ function planSinglePackagePreviews(withReleaseNotes, config, newTag, entries, wa
         return [];
     }
     if (!config.changelogJson.enabled) {
-        console.warn('Warning: --with-release-notes requires changelogJson.enabled; skipping preview generation');
+        warnings.push('--with-release-notes requires changelogJson.enabled; skipping preview generation');
         return [];
     }
     if (config.changelogPaths.length === 0) {

package/dist/esm/releasePrepareMono.js

@@ -25,10 +25,11 @@ import { renderChangelogMarkdown } from "./renderChangelogMarkdown.js";
 import { deriveSectionOrder } from "./resolveReleaseNotesConfig.js";
 import { refreshGitCliffCache } from "./runGitCliff.js";
 export function releasePrepareMono(config, options) {
-    const { withReleaseNotes } = options;
+    const { only, withReleaseNotes } = options;
     const writes = [];
+    const warnings = [];
     if (withReleaseNotes === true && !config.changelogJson.enabled) {
-        console.warn('Warning: --with-release-notes requires changelogJson.enabled; skipping preview generation');
+        warnings.push('--with-release-notes requires changelogJson.enabled; skipping preview generation');
     }
     const sectionOrder = deriveSectionOrder(resolveWorkTypes(config.workTypes));
     const overrideContext = createOverrideContext(config.workspaces);
@@ -43,7 +44,6 @@ export function releasePrepareMono(config, options) {
     const graph = buildDependencyGraph(config.workspaces);
     const fullReleaseSet = propagateBumps(directBumps, graph, currentVersions);
     const { sorted: sortedDirs, cyclicDirs } = topologicalSort(fullReleaseSet, graph);
-    const warnings = [];
     if (cyclicDirs.length > 0) {
         warnings.push(`Circular workspace dependencies detected among: ${cyclicDirs.join(', ')}. ` +
             'Propagation metadata may be incomplete for these workspaces.');
@@ -77,17 +77,23 @@ export function releasePrepareMono(config, options) {
     });
     let project;
     if (config.project !== undefined) {
-        project = tryStage('project release stage', () => releasePrepareProject({
-            config,
-            options,
-            modifiedFiles,
-            writes,
-            tags,
-            warnings,
-            rootOverrides: overrideContext.project,
-            overrideWarnings: overrideContext.overrideWarnings,
-            globalMatchedRootKeys: overrideContext.globalMatchedRootKeys,
-        }));
+        if (only === undefined) {
+            project = tryStage('project release stage', () => releasePrepareProject({
+                config,
+                options,
+                modifiedFiles,
+                writes,
+                tags,
+                warnings,
+                rootOverrides: overrideContext.project,
+                overrideWarnings: overrideContext.overrideWarnings,
+                globalMatchedRootKeys: overrideContext.globalMatchedRootKeys,
+            }));
+        }
+        else {
+            warnings.push(`Project release skipped: --only narrows this run to ${only.join(', ')}. ` +
+                'Run `release-kit prepare` without --only to include the project release.');
+        }
     }
     const formatCommand = planFormatCommand(config, tags, modifiedFiles);
     for (const overrideKey of overrideContext.project.keys()) {

package/dist/esm/reportPrepare.js

@@ -22,6 +22,7 @@ function formatSingleWorkspace(result, options) {
     formatPolicyViolations(lines, workspace.policyViolations);
     if (workspace.status === 'skipped') {
         lines.push(`⏭️  ${workspace.skipReason}`);
+        formatWarnings(lines, result);
         return lines.join('\n');
     }
     if (workspace.setVersion !== undefined) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@williamthorsen/release-kit",
-  "version": "10.4.0",
+  "version": "10.4.1",
   "description": "Version-bumping and changelog-generation toolkit for release workflows",
   "keywords": [
     "changelog",
@@ -60,7 +60,7 @@
     "@types/semver": "7.8.0",
     "@williamthorsen/toolbelt.testing": "0.3.0",
     "@williamthorsen/toolbelt.vitest": "0.4.0",
-    "readyup": "0.28.0",
+    "readyup": "0.29.0",
     "smol-toml": "1.7.1"
   },
   "engines": {