versionary 1.0.0 → 1.0.1

package/dist/cli/index.js

@@ -5,6 +5,20 @@ import { createReleasePlan } from "../release/plan.js";
 import { closeStaleReviewRequestIfExists, isReleaseCommitMessage, openOrUpdateReviewRequest, prepareReleasePr, pushReleaseBranch, resolveReleaseHighlights, } from "../release/pr.js";
 import { runRelease, runReleaseDetailed } from "../release/release.js";
 import { verifyProject } from "../release/verify-project.js";
+/**
+ * What a dry run would actually release. `plan.nextVersion` is the repository
+ * aggregate, which in a monorepo names no real release, so prefer the
+ * per-package versions whenever the plan has them.
+ */
+function formatDryRunReleaseSubject(plan) {
+    const releasing = (plan.packages ?? []).filter((pkg) => pkg.nextVersion);
+    if (releasing.length === 0) {
+        return plan.nextVersion ?? "";
+    }
+    return releasing
+        .map((pkg) => `${pkg.path === "." ? plan.packageName : pkg.path} ${pkg.nextVersion}`)
+        .join(", ");
+}
 function printVerifyResult() {
     const result = verifyProject();
     const categories = [
@@ -114,7 +128,7 @@ async function main() {
             return 0;
         }
         if (flags["dry-run"]) {
-            const dryRunMessage = `Dry run: would prepare release PR branch ${plan.releaseBranchPrefix} for ${plan.nextVersion}`;
+            const dryRunMessage = `Dry run: would prepare release PR branch ${plan.releaseBranchPrefix} for ${formatDryRunReleaseSubject(plan)}`;
             if (flags.json) {
                 emitJson({
                     action: "pr-dry-run",
@@ -218,7 +232,7 @@ async function main() {
             return 0;
         }
         if (flags["dry-run"]) {
-            console.log(`Dry run: would prepare release PR branch ${plan.releaseBranchPrefix} for ${plan.nextVersion}`);
+            console.log(`Dry run: would prepare release PR branch ${plan.releaseBranchPrefix} for ${formatDryRunReleaseSubject(plan)}`);
             return 0;
         }
         const pr = prepareReleasePr(process.cwd(), { logger: console });

package/dist/release/changelog.js

@@ -2,7 +2,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { applyRevertSuppression, inferReleaseTypeFromParsedCommit, parseConventionalCommitMessage, } from "../git/commits.js";
 import { resolveRepositoryWebBaseUrl } from "../git/repo-url.js";
-import { resolvePackageDependencies } from "./plan.js";
+import { resolvePackageDependencies, resolveRootReleaseView, } from "./plan.js";
 import { isVersionHeading } from "./semver.js";
 const REVIEW_REQUEST_FOOTER = "---\n\nThis PR was generated by [Versionary](https://github.com/jolars/versionary).";
 function formatDate() {
@@ -192,24 +192,27 @@ export function renderReviewRequestFooter() {
     return REVIEW_REQUEST_FOOTER;
 }
 export function renderReleasePlanChangelog(plan, options = {}) {
-    if (!plan.nextVersion) {
+    // Root's changelog describes root's own release, so it must be driven by the
+    // root package's version and commit set rather than the plan-level aggregate.
+    const root = resolveRootReleaseView(plan);
+    if (!root.nextVersion) {
         return "";
     }
     const dedupedCommits = [
-        ...new Map(plan.commits.map((commit) => [commit.hash, commit])).values(),
+        ...new Map(root.commits.map((commit) => [commit.hash, commit])).values(),
     ];
     if (plan.changelogFormat === "r-news") {
         return renderRNewsReleaseNotes({
             packageName: plan.packageName,
-            nextVersion: plan.nextVersion,
+            nextVersion: root.nextVersion,
             commits: dedupedCommits,
             cwd: process.cwd(),
             highlights: options.highlights,
         });
     }
     return renderReleaseNotesSection({
-        currentVersion: plan.currentVersion,
-        nextVersion: plan.nextVersion,
+        currentVersion: root.currentVersion,
+        nextVersion: root.nextVersion,
         commits: dedupedCommits,
         cwd: options.cwd ?? process.cwd(),
         dependencies: resolvePackageDependencies(plan, "."),

package/dist/release/plan.d.ts

@@ -34,6 +34,28 @@ export declare function getChangelogDefaults(config: {
     changelogFormat: VersionaryChangelogFormat;
 };
 export declare function createReleasePlan(cwd?: string): ReleasePlan;
+/**
+ * The root package's own release, as distinct from the plan-level aggregate.
+ *
+ * `plan.releaseType`/`plan.nextVersion`/`plan.commits` describe the repository
+ * as a whole: the aggregate release type folds in every package's commits and
+ * is then applied to root's version number. That answers "is anything
+ * releasing, and how large is the biggest change anywhere" — not "what is root
+ * releasing". A sibling's `feat` therefore lifts the aggregate to a minor even
+ * when root's own `exclude-paths` drop that commit, so anything that names or
+ * describes root's release must go through here instead. Using the aggregate
+ * would report a version no version file carries and list commits root
+ * deliberately excluded.
+ *
+ * Falls back to the aggregate when the plan has no explicit root package: the
+ * top-level changelog is then a repository-wide summary with no package of its
+ * own to describe.
+ */
+export declare function resolveRootReleaseView(plan: ReleasePlan): {
+    currentVersion: string;
+    nextVersion: string | null;
+    commits: ParsedCommit[];
+};
 export declare function resolvePackageDependencies(plan: ReleasePlan, packagePath: string): Array<{
     name: string;
     version: string;

package/dist/release/plan.js

@@ -480,6 +480,38 @@ export function createReleasePlan(cwd = process.cwd()) {
         packages: visiblePackages.map(({ implicitRoot: _implicitRoot, ...pkgPlan }) => pkgPlan),
     };
 }
+/**
+ * The root package's own release, as distinct from the plan-level aggregate.
+ *
+ * `plan.releaseType`/`plan.nextVersion`/`plan.commits` describe the repository
+ * as a whole: the aggregate release type folds in every package's commits and
+ * is then applied to root's version number. That answers "is anything
+ * releasing, and how large is the biggest change anywhere" — not "what is root
+ * releasing". A sibling's `feat` therefore lifts the aggregate to a minor even
+ * when root's own `exclude-paths` drop that commit, so anything that names or
+ * describes root's release must go through here instead. Using the aggregate
+ * would report a version no version file carries and list commits root
+ * deliberately excluded.
+ *
+ * Falls back to the aggregate when the plan has no explicit root package: the
+ * top-level changelog is then a repository-wide summary with no package of its
+ * own to describe.
+ */
+export function resolveRootReleaseView(plan) {
+    const rootPackage = plan.packages?.find((pkg) => pkg.path === ".");
+    if (!rootPackage) {
+        return {
+            currentVersion: plan.currentVersion,
+            nextVersion: plan.nextVersion,
+            commits: plan.commits,
+        };
+    }
+    return {
+        currentVersion: rootPackage.currentVersion,
+        nextVersion: rootPackage.nextVersion,
+        commits: rootPackage.commits,
+    };
+}
 export function resolvePackageDependencies(plan, packagePath) {
     const target = plan.packages?.find((pkg) => pkg.path === packagePath);
     if (!target) {

package/dist/release/pr.js

@@ -258,8 +258,14 @@ export function prepareReleasePr(cwd = process.cwd(), options = {}) {
     const highlightsResult = resolveReleaseHighlights(cwd, plan.changelogFile, plan.changelogFormat);
     const highlights = highlightsResult.highlights;
     const section = renderReleasePlanChangelog(plan, { highlights, cwd });
-    prependChangelog(cwd, plan.changelogFile, section, plan.changelogFormat);
-    const updatedChangelogFiles = [plan.changelogFile];
+    const updatedChangelogFiles = [];
+    // An empty section means root itself is not releasing, only siblings are.
+    // Writing then would leave a bare heading behind and, worse, strip the
+    // manual-notes block that nothing has folded in yet.
+    if (section.length > 0) {
+        prependChangelog(cwd, plan.changelogFile, section, plan.changelogFormat);
+        updatedChangelogFiles.push(plan.changelogFile);
+    }
     for (const packagePlan of plan.packages ?? []) {
         if (!packagePlan.nextVersion || packagePlan.path === ".") {
             continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "versionary",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Automatic release framework based on conventional commits and semantic versioning",
   "keywords": [
     "releasing",