versionary 0.11.1 → 0.13.0

package/README.md

@@ -52,7 +52,7 @@ Current implementation focuses on:
 - strategy-based version updates (`simple`, `node`, `rust`, `r`)
 - release planning and changelog generation
 - review-mode vs direct-mode release flow
-- built-in GitHub SCM plugin capabilities
+- a static internal SCM client (`github` provider today)
 
 Planned/harder areas include deeper monorepo ergonomics, broader SCM coverage,
 and stronger failure recovery around release steps.
@@ -61,8 +61,8 @@ and stronger failure recovery around release steps.
 
 Versionary is set up so new language strategies can be added internally without
 changing release orchestration. A new strategy should implement the
-`VersionStrategy` contract in `src/domain/strategy/types.ts` and be wired in
-`src/domain/strategy/resolve.ts`.
+`VersionStrategy` contract in `src/strategy/types.ts` and be wired in
+`src/strategy/resolve.ts`.
 
 Checklist for new strategies (for example `python`):
 
@@ -71,8 +71,13 @@ Checklist for new strategies (for example `python`):
 - implement `readVersion(cwd, config)` with explicit malformed-file errors
 - implement `writeVersion(cwd, config, version)` returning deterministic updated
   file paths
-- add release-name extraction support if package tags should derive from
-  language metadata (similar to Node/Rust/R)
+- optionally implement `readPackageName(cwd, config)` so monorepo release tags
+  can derive from language metadata (similar to Node/Rust/R)
+- optionally implement `propagateDependentPatchImpacts(cwd, packages)` if
+  dependency updates in this ecosystem should trigger dependent package patch
+  bumps
+- optionally implement `finalizeVersionWrites(cwd, writes)` for ecosystem
+  post-processing after all target version files are written
 - add focused strategy tests for ecosystem-specific behavior and edge cases
 - add/extend strategy contract tests in `tests/strategy-contract.test.ts`
 - update schema/docs for new `release-type` behavior and defaults
@@ -81,8 +86,10 @@ Current ecosystem policy defaults:
 
 - changelog source for publish:
   - root target uses root `changelog-file`
-  - package target uses `packages.<path>.changelog-file` when configured, else
-    root `changelog-file`
+  - package target uses package changelog defaults:
+    - `packages.<path>.changelog-file` when configured
+    - otherwise `NEWS.md` for R targets or `CHANGELOG.md` for other targets at
+      `<package-path>/<default-file>`
 - lockfiles:
   - Node strategy updates root `package-lock.json`/`npm-shrinkwrap.json` when
     present
@@ -91,16 +98,19 @@ Current ecosystem policy defaults:
   - Rust supports `version.workspace = true` via `[workspace.package].version`
   - other strategies should document equivalent inheritance behavior explicitly
 
-## Architecture layout (current migration)
+## Architecture layout (canonical)
 
-The repository is moving to explicit layered modules:
+Current runtime code uses a flat `src/` layout with clear module boundaries:
 
-- `src/app/`: command-level application services and orchestration boundaries
-- `src/domain/`: release and strategy domain logic/contracts
-- `src/infra/`: platform integrations (SCM, git/runtime adapters)
-
-Legacy `src/simple/` has been removed. Remaining compatibility paths are
-`src/strategies` and `src/scm` while migration is finalized.
+- `src/cli/`: command router (`run`, `verify`, `plan`, `changelog`, `pr`, `release`)
+- `src/release/`: release orchestration (plan/changelog/PR/release/state/recovery)
+- `src/strategy/`: strategy contracts, resolver, and built-in implementations
+  (`simple`, `node`, `rust`, `r`)
+- `src/scm/`: SCM client contracts and provider implementation(s)
+- `src/config/`: config loading and schema validation
+- `src/git/`: git commit/range and repository URL helpers
+- `src/verify/`: repository/config verification
+- `src/types/`: shared config/plugin-facing types
 
 Configuration is loaded from `versionary.jsonc` by default (or
 `versionary.json`).
@@ -132,6 +142,8 @@ For a quick trial, use:
   auto-transition to `1.0.0` on a breaking release
 - review mode (`review-mode`): `pr` (PR/MR style) or `direct` (no review
   request)
+- `release-draft` (default `false`) publishes GitHub releases as drafts when
+  enabled
 - optional monorepo planning with `monorepo-mode` and `packages`:
   - `independent` computes package bumps per path
   - `fixed` computes one shared bump across configured package paths
@@ -229,8 +241,8 @@ Commands:
 - `pnpm pr`
 - `pnpm release`
 
-`pnpm pr` prepares release commit + branch and opens/updates the review request
-via SCM plugin capability. `pnpm run` is the recommended CI entrypoint and
+`pnpm pr` prepares release commit + branch and opens/updates a review request
+through the SCM client. `pnpm run` is the recommended CI entrypoint and
 auto-dispatches between PR/update and release publish.
 
 For first-run bootstrapping, set `bootstrap-sha` (similar to release-please).
@@ -251,15 +263,21 @@ Versionary fails fast when recovery is unsafe (for example, local and remote
 tags with the same name point to different SHAs). In these cases, the error
 message includes remediation guidance so CI logs are actionable.
 
-## Built-in plugins
+## SCM API model
+
+Versionary currently uses a static internal SCM client model:
 
-Versionary ships with built-in SCM plugin support:
+- `src/scm/types.ts` defines the `ScmClient` contract
+- `src/scm/client.ts` returns the active provider client
+- current provider is `github` via `src/scm/github-plugin.ts`
 
-- `github` (default): review request + release metadata
+There is no runtime discovery/loading of external SCM providers in the release
+flow. Adding another provider is an internal extension: implement `ScmClient`
+and wire provider selection in `src/scm/client.ts`.
 
 ### GitHub integration: env, permissions, and flow
 
-Required environment for the built-in GitHub plugin:
+Required environment for the GitHub SCM provider:
 
 - `GITHUB_REPOSITORY` (format: `owner/repo`)
 - one token env var: `VERSIONARY_PR_TOKEN` or `GH_TOKEN` or `GITHUB_TOKEN`

package/dist/cli/index.js

@@ -1,19 +1,14 @@
 #!/usr/bin/env node
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 const node_child_process_1 = require("node:child_process");
-const node_fs_1 = __importDefault(require("node:fs"));
-const node_path_1 = __importDefault(require("node:path"));
-const pr_js_1 = require("../app/release/pr.js");
-const release_js_1 = require("../app/release/release.js");
-const verify_js_1 = require("../app/release/verify.js");
-const changelog_js_1 = require("../domain/release/changelog.js");
-const plan_js_1 = require("../domain/release/plan.js");
+const changelog_js_1 = require("../release/changelog.js");
+const plan_js_1 = require("../release/plan.js");
+const pr_js_1 = require("../release/pr.js");
+const release_js_1 = require("../release/release.js");
+const verify_project_js_1 = require("../release/verify-project.js");
 function printVerifyResult() {
-    const result = (0, verify_js_1.verifyProject)();
+    const result = (0, verify_project_js_1.verifyProject)();
     const categories = [
         { key: "config", title: "Config" },
         { key: "paths", title: "Paths" },
@@ -57,7 +52,7 @@ async function main() {
         }).trim();
         if ((0, pr_js_1.isReleaseCommitMessage)(commitMessage)) {
             if (flags["dry-run"] && !flags.json) {
-                const release = await (0, release_js_1.runSimpleReleaseDetailed)(process.cwd(), {
+                const release = await (0, release_js_1.runReleaseDetailed)(process.cwd(), {
                     logger,
                     "dry-run": true,
                 });
@@ -67,7 +62,7 @@ async function main() {
                 }
             }
             if (flags.json) {
-                const release = await (0, release_js_1.runSimpleReleaseDetailed)(process.cwd(), {
+                const release = await (0, release_js_1.runReleaseDetailed)(process.cwd(), {
                     logger,
                     "dry-run": flags["dry-run"],
                 });
@@ -98,11 +93,11 @@ async function main() {
                 });
                 return 0;
             }
-            const message = await (0, release_js_1.runSimpleRelease)(process.cwd());
+            const message = await (0, release_js_1.runRelease)(process.cwd());
             console.log(message);
             return 0;
         }
-        const plan = (0, plan_js_1.createSimplePlan)();
+        const plan = (0, plan_js_1.createReleasePlan)();
         if (!plan.nextVersion) {
             const message = "No releasable commits found. Nothing to do.";
             if (flags.json) {
@@ -145,9 +140,9 @@ async function main() {
             console.log(dryRunMessage);
             return 0;
         }
-        const pr = (0, pr_js_1.prepareSimpleReleasePr)(process.cwd(), { logger });
+        const pr = (0, pr_js_1.prepareReleasePr)(process.cwd(), { logger });
         (0, pr_js_1.pushReleaseBranch)(process.cwd(), pr.branch);
-        const reviewResult = await (0, pr_js_1.openOrUpdateSimpleReviewRequest)(process.cwd(), pr.branch, pr.title, pr.version, pr.previousVersion, pr.commits, pr.plan, { logger });
+        const reviewResult = await (0, pr_js_1.openOrUpdateReviewRequest)(process.cwd(), pr.branch, pr.title, pr.version, pr.previousVersion, pr.commits, pr.plan, { logger });
         const message = `Prepared release PR branch ${pr.branch}`;
         if (flags.json) {
             emitJson({
@@ -170,35 +165,29 @@ async function main() {
         return printVerifyResult();
     }
     if (command === "plan") {
-        const plan = (0, plan_js_1.createSimplePlan)();
+        const plan = (0, plan_js_1.createReleasePlan)();
         console.log(JSON.stringify(plan, null, 2));
         return 0;
     }
     if (command === "changelog") {
         const write = args.includes("--write");
-        const plan = (0, plan_js_1.createSimplePlan)();
+        const plan = (0, plan_js_1.createReleasePlan)();
         if (!plan.nextVersion) {
             console.log("No releasable commits found.");
             return 0;
         }
-        const section = (0, changelog_js_1.renderSimpleChangelog)(plan);
+        const section = (0, changelog_js_1.renderReleasePlanChangelog)(plan);
         if (!write) {
             console.log(section);
             return 0;
         }
-        const changelogPath = node_path_1.default.join(process.cwd(), plan.changelogFile);
-        const existing = node_fs_1.default.existsSync(changelogPath)
-            ? node_fs_1.default.readFileSync(changelogPath, "utf8")
-            : "";
-        const heading = "# Changelog\n\n";
-        const body = existing.replace(/^# Changelog\s*/u, "");
-        node_fs_1.default.writeFileSync(changelogPath, `${`${heading}${section}\n${body}`.trimEnd()}\n`, "utf8");
+        (0, changelog_js_1.prependChangelog)(process.cwd(), plan.changelogFile, section, plan.changelogFormat);
         console.log(`Updated ${plan.changelogFile}`);
         return 0;
     }
     if (command === "pr") {
         if (flags["dry-run"]) {
-            const plan = (0, plan_js_1.createSimplePlan)();
+            const plan = (0, plan_js_1.createReleasePlan)();
             if (!plan.nextVersion) {
                 console.log("No releasable commits found. Nothing to do.");
                 return 0;
@@ -206,9 +195,9 @@ async function main() {
             console.log(`Dry run: would prepare release PR branch ${plan.releaseBranchPrefix} for ${plan.nextVersion}`);
             return 0;
         }
-        const pr = (0, pr_js_1.prepareSimpleReleasePr)(process.cwd(), { logger: console });
+        const pr = (0, pr_js_1.prepareReleasePr)(process.cwd(), { logger: console });
         (0, pr_js_1.pushReleaseBranch)(process.cwd(), pr.branch);
-        const reviewResult = await (0, pr_js_1.openOrUpdateSimpleReviewRequest)(process.cwd(), pr.branch, pr.title, pr.version, pr.previousVersion, pr.commits, pr.plan);
+        const reviewResult = await (0, pr_js_1.openOrUpdateReviewRequest)(process.cwd(), pr.branch, pr.title, pr.version, pr.previousVersion, pr.commits, pr.plan);
         console.log(`Prepared release PR branch ${pr.branch}`);
         console.log(`Title: ${pr.title}`);
         console.log(reviewResult);
@@ -216,7 +205,7 @@ async function main() {
     }
     if (command === "release") {
         if (flags["dry-run"]) {
-            const result = await (0, release_js_1.runSimpleReleaseDetailed)(process.cwd(), {
+            const result = await (0, release_js_1.runReleaseDetailed)(process.cwd(), {
                 logger,
                 "dry-run": true,
             });
@@ -231,7 +220,7 @@ async function main() {
             }
             return 0;
         }
-        const message = await (0, release_js_1.runSimpleRelease)(process.cwd());
+        const message = await (0, release_js_1.runRelease)(process.cwd());
         console.log(message);
         return 0;
     }
@@ -239,7 +228,7 @@ async function main() {
     console.log("Commands:");
     console.log("  run [--json] [--dry-run]  Auto-dispatch release PR/update or release publish by context");
     console.log("  verify  Validate config and basic repository shape");
-    console.log("  plan    Print release plan (simple mode)");
+    console.log("  plan    Print release plan");
     console.log("  changelog [--write]  Print or write changelog section");
     console.log("  pr [--dry-run]      Prepare release PR commit and branch");
     console.log("  release [--dry-run] Publish release metadata for release commit context");

package/dist/config/schema.d.ts

@@ -9,6 +9,11 @@ export declare const configSchema: z.ZodObject<{
     }>>;
     "version-file": z.ZodOptional<z.ZodString>;
     "changelog-file": z.ZodOptional<z.ZodString>;
+    "changelog-format": z.ZodOptional<z.ZodEnum<{
+        "markdown-changelog": "markdown-changelog";
+        "r-news": "r-news";
+    }>>;
+    "release-draft": z.ZodOptional<z.ZodBoolean>;
     "release-branch": z.ZodOptional<z.ZodString>;
     "baseline-file": z.ZodOptional<z.ZodString>;
     "bootstrap-sha": z.ZodOptional<z.ZodString>;
@@ -24,6 +29,10 @@ export declare const configSchema: z.ZodObject<{
         "release-type": z.ZodOptional<z.ZodString>;
         "package-name": z.ZodOptional<z.ZodString>;
         "changelog-file": z.ZodOptional<z.ZodString>;
+        "changelog-format": z.ZodOptional<z.ZodEnum<{
+            "markdown-changelog": "markdown-changelog";
+            "r-news": "r-news";
+        }>>;
         "exclude-paths": z.ZodOptional<z.ZodArray<z.ZodString>>;
         "extra-files": z.ZodOptional<z.ZodArray<z.ZodObject<{
             type: z.ZodEnum<{

package/dist/config/schema.js

@@ -54,6 +54,7 @@ const packageSchema = zod_1.z
     "release-type": zod_1.z.string().optional(),
     "package-name": zod_1.z.string().optional(),
     "changelog-file": zod_1.z.string().optional(),
+    "changelog-format": zod_1.z.enum(["markdown-changelog", "r-news"]).optional(),
     "exclude-paths": zod_1.z.array(zod_1.z.string()).optional(),
     "extra-files": zod_1.z.array(artifactRuleSchema).optional(),
 })
@@ -65,6 +66,8 @@ exports.configSchema = zod_1.z
     "review-mode": zod_1.z.enum(["direct", "pr", "review"]).optional(),
     "version-file": zod_1.z.string().optional(),
     "changelog-file": zod_1.z.string().optional(),
+    "changelog-format": zod_1.z.enum(["markdown-changelog", "r-news"]).optional(),
+    "release-draft": zod_1.z.boolean().optional(),
     "release-branch": zod_1.z.string().optional(),
     "baseline-file": zod_1.z.string().optional(),
     "bootstrap-sha": zod_1.z.string().optional(),

package/dist/{infra/git → git}/commits.d.ts

@@ -1,4 +1,4 @@
-import type { ReleaseType } from "../../domain/release/semver.js";
+import type { ReleaseType } from "../release/semver.js";
 export interface CommitInfo {
     hash: string;
     subject: string;

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 export { loadConfig } from "./config/load-config.js";
-export { resolveVersionStrategy } from "./domain/strategy/resolve.js";
-export { createGitHubPlugin } from "./infra/scm/github/plugin.js";
-export { findPluginsByCapability, pluginHasCapability, } from "./plugins/capabilities.js";
-export { loadRuntimePlugins } from "./plugins/runtime.js";
+export { verifyProject } from "./release/verify-project.js";
+export { findPluginsByCapability, pluginHasCapability, } from "./scm/capabilities.js";
+export { getScmClient } from "./scm/client.js";
+export { createGitHubPlugin } from "./scm/github-plugin.js";
+export type { ScmClient, ScmClientContext, ScmProvider, ScmReleaseMetadataInput, ScmReleaseMetadataResult, ScmReviewRequestInput, ScmReviewRequestResult, } from "./scm/types.js";
+export { resolveVersionStrategy } from "./strategy/resolve.js";
 export type { VersionaryArtifactRule, VersionaryConfig, VersionaryPackage, } from "./types/config.js";
 export type { VersionaryPluginCapability, VersionaryPluginContext, VersionaryPluginRuntime, VersionaryScmReleaseMetadataInput, VersionaryScmReleaseMetadataResult, VersionaryScmReviewRequestInput, VersionaryScmReviewRequestResult, } from "./types/plugins.js";
-export { verifyProject } from "./verify/verify-project.js";

package/dist/index.js

@@ -1,16 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.verifyProject = exports.loadRuntimePlugins = exports.pluginHasCapability = exports.findPluginsByCapability = exports.createGitHubPlugin = exports.resolveVersionStrategy = exports.loadConfig = void 0;
+exports.resolveVersionStrategy = exports.createGitHubPlugin = exports.getScmClient = exports.pluginHasCapability = exports.findPluginsByCapability = exports.verifyProject = exports.loadConfig = void 0;
 var load_config_js_1 = require("./config/load-config.js");
 Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return load_config_js_1.loadConfig; } });
-var resolve_js_1 = require("./domain/strategy/resolve.js");
-Object.defineProperty(exports, "resolveVersionStrategy", { enumerable: true, get: function () { return resolve_js_1.resolveVersionStrategy; } });
-var plugin_js_1 = require("./infra/scm/github/plugin.js");
-Object.defineProperty(exports, "createGitHubPlugin", { enumerable: true, get: function () { return plugin_js_1.createGitHubPlugin; } });
-var capabilities_js_1 = require("./plugins/capabilities.js");
+var verify_project_js_1 = require("./release/verify-project.js");
+Object.defineProperty(exports, "verifyProject", { enumerable: true, get: function () { return verify_project_js_1.verifyProject; } });
+var capabilities_js_1 = require("./scm/capabilities.js");
 Object.defineProperty(exports, "findPluginsByCapability", { enumerable: true, get: function () { return capabilities_js_1.findPluginsByCapability; } });
 Object.defineProperty(exports, "pluginHasCapability", { enumerable: true, get: function () { return capabilities_js_1.pluginHasCapability; } });
-var runtime_js_1 = require("./plugins/runtime.js");
-Object.defineProperty(exports, "loadRuntimePlugins", { enumerable: true, get: function () { return runtime_js_1.loadRuntimePlugins; } });
-var verify_project_js_1 = require("./verify/verify-project.js");
-Object.defineProperty(exports, "verifyProject", { enumerable: true, get: function () { return verify_project_js_1.verifyProject; } });
+var client_js_1 = require("./scm/client.js");
+Object.defineProperty(exports, "getScmClient", { enumerable: true, get: function () { return client_js_1.getScmClient; } });
+var github_plugin_js_1 = require("./scm/github-plugin.js");
+Object.defineProperty(exports, "createGitHubPlugin", { enumerable: true, get: function () { return github_plugin_js_1.createGitHubPlugin; } });
+var resolve_js_1 = require("./strategy/resolve.js");
+Object.defineProperty(exports, "resolveVersionStrategy", { enumerable: true, get: function () { return resolve_js_1.resolveVersionStrategy; } });

package/dist/release/artifact-rules.d.ts

@@ -0,0 +1,3 @@
+import type { VersionaryConfig } from "../types/config.js";
+import type { SimplePlan } from "./plan.js";
+export declare function applyConfiguredArtifactRules(cwd: string, config: VersionaryConfig, plan: SimplePlan): string[];

package/dist/release/changelog.d.ts

@@ -0,0 +1,32 @@
+import { type ParsedCommit } from "../git/commits.js";
+import type { VersionaryChangelogFormat } from "../types/config.js";
+import type { ReleasePlan, SimplePlan } from "./plan.js";
+export declare function renderSimpleReleaseNotes(input: {
+    currentVersion: string;
+    nextVersion: string;
+    commits: ParsedCommit[];
+    cwd?: string;
+    dependencies?: Array<{
+        name: string;
+        version: string;
+    }>;
+}, options?: {
+    includeFooter?: boolean;
+}): string;
+export declare function renderReleasePlanChangelog(plan: ReleasePlan): string;
+/** @deprecated Use renderReleasePlanChangelog. */
+export declare function renderSimpleChangelog(plan: SimplePlan): string;
+export declare function renderPackageChangelogSection(input: {
+    currentVersion: string;
+    nextVersion: string;
+    commits: ParsedCommit[];
+    tagPrefix: string;
+    cwd?: string;
+}): string;
+export declare function prependChangelog(cwd: string, changelogFile: string, section: string, format?: VersionaryChangelogFormat): void;
+export declare function renderRNewsReleaseNotes(input: {
+    packageName: string;
+    nextVersion: string;
+    commits: ParsedCommit[];
+    cwd?: string;
+}): string;

package/dist/{domain/release → release}/changelog.js

@@ -4,13 +4,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderSimpleReleaseNotes = renderSimpleReleaseNotes;
+exports.renderReleasePlanChangelog = renderReleasePlanChangelog;
 exports.renderSimpleChangelog = renderSimpleChangelog;
 exports.renderPackageChangelogSection = renderPackageChangelogSection;
 exports.prependChangelog = prependChangelog;
+exports.renderRNewsReleaseNotes = renderRNewsReleaseNotes;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
-const commits_js_1 = require("../../infra/git/commits.js");
-const repo_url_js_1 = require("../../infra/git/repo-url.js");
+const commits_js_1 = require("../git/commits.js");
+const repo_url_js_1 = require("../git/repo-url.js");
 function formatDate() {
     return new Date().toISOString().slice(0, 10);
 }
@@ -102,23 +104,52 @@ function renderSimpleReleaseNotes(input, options = {}) {
     if (grouped.reverts.length > 0) {
         sections.push("### Reverts", ...grouped.reverts, "");
     }
+    if (input.dependencies && input.dependencies.length > 0) {
+        sections.push("### Dependencies", ...input.dependencies.map((dependency) => `- updated ${dependency.name} to v${dependency.version}`), "");
+    }
     const lines = [header, "", ...sections];
     if (options.includeFooter) {
         lines.push("\n---\n\nThis PR was generated by [Versionary](https://github.com/jolars/versionary).");
     }
     return lines.join("\n");
 }
-function renderSimpleChangelog(plan) {
+function renderReleasePlanChangelog(plan) {
     if (!plan.nextVersion) {
         return "";
     }
+    const propagatedRootPackage = plan.packages?.find((pkg) => pkg.path === "." && pkg.bumpReason === "dependency-propagation");
+    const isDirectBump = (pkg) => pkg.bumpReason === "direct" ||
+        (pkg.bumpReason === undefined &&
+            Boolean(pkg.nextVersion) &&
+            pkg.commits.length > 0);
+    const dependencies = propagatedRootPackage && plan.packages
+        ? plan.packages
+            .filter((pkg) => pkg.path !== "." && isDirectBump(pkg) && pkg.nextVersion)
+            .map((pkg) => ({
+            name: pkg.path,
+            version: pkg.nextVersion,
+        }))
+        : [];
+    if (plan.changelogFormat === "r-news") {
+        return renderRNewsReleaseNotes({
+            packageName: plan.packageName,
+            nextVersion: plan.nextVersion,
+            commits: plan.commits,
+            cwd: process.cwd(),
+        });
+    }
     return renderSimpleReleaseNotes({
         currentVersion: plan.currentVersion,
         nextVersion: plan.nextVersion,
         commits: plan.commits,
         cwd: process.cwd(),
+        dependencies,
     });
 }
+/** @deprecated Use renderReleasePlanChangelog. */
+function renderSimpleChangelog(plan) {
+    return renderReleasePlanChangelog(plan);
+}
 function renderPackageChangelogSection(input) {
     const repoUrl = (0, repo_url_js_1.resolveRepositoryWebBaseUrl)(input.cwd ?? process.cwd());
     const header = repoUrl
@@ -140,14 +171,42 @@ function renderPackageChangelogSection(input) {
     }
     return [header, "", ...sections].join("\n");
 }
-function prependChangelog(cwd, changelogFile, section) {
+function prependChangelog(cwd, changelogFile, section, format = "markdown-changelog") {
     const changelogPath = node_path_1.default.join(cwd, changelogFile);
     const existing = node_fs_1.default.existsSync(changelogPath)
         ? node_fs_1.default.readFileSync(changelogPath, "utf8")
         : "";
-    const heading = existing.startsWith("# Changelog") ? "" : "# Changelog\n\n";
+    if (format === "r-news") {
+        const bodyWithoutDevHeader = existing.replace(/^#\s+.+\s+\(development version\)\s*(?:\r?\n)*/u, "");
+        const separator = bodyWithoutDevHeader.length > 0 ? "\n\n" : "";
+        const next = `${`${section}${separator}${bodyWithoutDevHeader}`.trimEnd()}\n`;
+        node_fs_1.default.writeFileSync(changelogPath, next, "utf8");
+        return;
+    }
+    const heading = "# Changelog\n\n";
+    const bodyWithoutHeading = existing.replace(/^# Changelog\s*/u, "");
     const separator = existing.length > 0 ? "\n" : "";
-    const next = `${heading}${section}${separator}${existing.replace(/^# Changelog\s*/u, "")}`.trimEnd() +
-        "\n";
+    const next = `${`${heading}${section}${separator}${bodyWithoutHeading}`.trimEnd()}\n`;
     node_fs_1.default.writeFileSync(changelogPath, next, "utf8");
 }
+function renderRNewsReleaseNotes(input) {
+    const repoUrl = (0, repo_url_js_1.resolveRepositoryWebBaseUrl)(input.cwd ?? process.cwd());
+    const grouped = groupCommitLines(input.commits, repoUrl);
+    const normalizedVersion = input.nextVersion.replace(/\.\d+$/u, "");
+    const sections = [];
+    if (grouped.breaking.length > 0) {
+        sections.push("## Breaking changes", "", ...grouped.breaking, "");
+    }
+    if (grouped.features.length > 0) {
+        sections.push("## Features", "", ...grouped.features, "");
+    }
+    if (grouped.fixes.length > 0) {
+        sections.push("## Bug fixes", "", ...grouped.fixes, "");
+    }
+    if (grouped.reverts.length > 0) {
+        sections.push("## Reverts", "", ...grouped.reverts, "");
+    }
+    return [`# ${input.packageName} ${normalizedVersion}`, "", ...sections]
+        .join("\n")
+        .trimEnd();
+}

package/dist/release/plan.d.ts

@@ -0,0 +1,37 @@
+import { type ParsedCommit } from "../git/commits.js";
+import type { VersionaryChangelogFormat, VersionaryConfig } from "../types/config.js";
+import { type ReleaseType } from "./semver.js";
+export interface ReleasePlan {
+    mode: "simple";
+    releaseType: ReleaseType;
+    currentVersion: string;
+    nextVersion: string | null;
+    packageName: string;
+    versionFile: string;
+    changelogFile: string;
+    changelogFormat: VersionaryChangelogFormat;
+    releaseBranchPrefix: string;
+    baselineSha: string | null;
+    commits: ParsedCommit[];
+    packages?: Array<{
+        path: string;
+        releaseType: ReleaseType;
+        currentVersion: string;
+        nextVersion: string | null;
+        bumpReason?: "direct" | "dependency-propagation";
+        commits: ParsedCommit[];
+    }>;
+}
+/** @deprecated Use ReleasePlan. */
+export type SimplePlan = ReleasePlan;
+export declare function getChangelogDefaults(config: {
+    "release-type"?: VersionaryConfig["release-type"];
+    "changelog-file"?: VersionaryConfig["changelog-file"];
+    "changelog-format"?: VersionaryConfig["changelog-format"];
+}): {
+    changelogFile: string;
+    changelogFormat: VersionaryChangelogFormat;
+};
+export declare function createReleasePlan(cwd?: string): ReleasePlan;
+/** @deprecated Use createReleasePlan. */
+export declare function createSimplePlan(cwd?: string): ReleasePlan;