@fern-api/generator-cli 0.9.7 → 0.9.8

package/dist/api.d.ts

@@ -536,8 +536,14 @@ interface GithubStepConfig {
     changelogEntry?: string;
     /** Structured PR description with Before/After code fences for breaking changes. Takes priority over changelogEntry for PR body. */
     prDescription?: string;
-    /** One-sentence justification for WHY the version bump was chosen. Prepended to PR body when present. */
+    /** One-sentence justification for WHY the version bump was chosen. Shown only for breaking changes. */
     versionBumpReason?: string;
+    /** The previous SDK version before this change (e.g. "1.2.3"). Used for version header in PR body. */
+    previousVersion?: string;
+    /** The new SDK version after this change (e.g. "1.3.0"). Used for version header in PR body. */
+    newVersion?: string;
+    /** The version bump level: MAJOR, MINOR, or PATCH. Used for version header formatting. */
+    versionBump?: string;
     /** Skip push/PR creation, just prepare branches locally */
     previewMode?: boolean;
     /** Generator name for namespaced fern-generation-base tag */

package/dist/api.js

@@ -10122,15 +10122,37 @@ async function checkPRHasOnlyGenerationCommits(octokit, owner, repo, pullNumber,
 }
 
 // src/pipeline/github/parseCommitMessage.ts
-function parseCommitMessageForPR(commitMessage, changelogEntry, prDescription, versionBumpReason) {
+function parseCommitMessageForPR(commitMessage, changelogEntry, prDescription, versionBumpReason, previousVersion, newVersion, versionBump, changelogUrl) {
   const lines = commitMessage.split("\n");
   const prTitle = lines[0]?.trim() || "SDK Generation";
   const bodyFromCommit = lines.slice(1).join("\n").trim() || "Automated SDK generation by Fern";
   let prBody = prDescription?.trim() || changelogEntry?.trim() || bodyFromCommit;
-  if (versionBumpReason?.trim()) {
-    prBody = `**Version Bump:** ${versionBumpReason.trim()}
+  const isBreaking = versionBump === "MAJOR";
+  if (previousVersion?.trim() && newVersion?.trim()) {
+    const emoji = isBreaking ? "\u26A0\uFE0F " : "";
+    const header = `## ${emoji}${previousVersion.trim()} \u2192 ${newVersion.trim()}`;
+    if (isBreaking && versionBumpReason?.trim()) {
+      prBody = `${header}
+
+**Breaking:** ${versionBumpReason.trim()}
+
+${prBody}`;
+    } else {
+      prBody = `${header}
 
 ${prBody}`;
+    }
+  } else if (isBreaking && versionBumpReason?.trim()) {
+    prBody = `\u26A0\uFE0F **Breaking:** ${versionBumpReason.trim()}
+
+${prBody}`;
+  }
+  if (changelogUrl?.trim()) {
+    prBody += `
+
+---
+
+[See full changelog](${changelogUrl.trim()})`;
   }
   return { prTitle, prBody };
 }
@@ -10415,11 +10437,17 @@ var GithubStep = class extends BaseStep {
       }
     }
     const finalCommitMessage = this.config.commitMessage ?? "SDK Generation";
+    const headSha = await repository.getHeadSha();
+    const changelogUrl = this.config.changelogEntry ? `https://github.com/${this.config.uri}/blob/${headSha}/changelog.md` : void 0;
     const { prTitle, prBody } = parseCommitMessageForPR(
       finalCommitMessage,
       this.config.changelogEntry,
       this.config.prDescription,
-      this.config.versionBumpReason
+      this.config.versionBumpReason,
+      this.config.previousVersion,
+      this.config.newVersion,
+      this.config.versionBump,
+      changelogUrl
     );
     const replaySection = formatReplayPrBody(replayResult, { branchName: prBranch, repoUri: this.config.uri });
     let enrichedBody = replaySection != null ? prBody + "\n\n---\n\n" + replaySection : prBody;

package/dist/cli.js

@@ -33032,15 +33032,37 @@ async function checkPRHasOnlyGenerationCommits(octokit, owner, repo, pullNumber,
 }
 
 // src/pipeline/github/parseCommitMessage.ts
-function parseCommitMessageForPR(commitMessage, changelogEntry, prDescription, versionBumpReason) {
+function parseCommitMessageForPR(commitMessage, changelogEntry, prDescription, versionBumpReason, previousVersion, newVersion, versionBump, changelogUrl) {
   const lines = commitMessage.split("\n");
   const prTitle = lines[0]?.trim() || "SDK Generation";
   const bodyFromCommit = lines.slice(1).join("\n").trim() || "Automated SDK generation by Fern";
   let prBody = prDescription?.trim() || changelogEntry?.trim() || bodyFromCommit;
-  if (versionBumpReason?.trim()) {
-    prBody = `**Version Bump:** ${versionBumpReason.trim()}
+  const isBreaking = versionBump === "MAJOR";
+  if (previousVersion?.trim() && newVersion?.trim()) {
+    const emoji = isBreaking ? "\u26A0\uFE0F " : "";
+    const header = `## ${emoji}${previousVersion.trim()} \u2192 ${newVersion.trim()}`;
+    if (isBreaking && versionBumpReason?.trim()) {
+      prBody = `${header}
+
+**Breaking:** ${versionBumpReason.trim()}
+
+${prBody}`;
+    } else {
+      prBody = `${header}
 
 ${prBody}`;
+    }
+  } else if (isBreaking && versionBumpReason?.trim()) {
+    prBody = `\u26A0\uFE0F **Breaking:** ${versionBumpReason.trim()}
+
+${prBody}`;
+  }
+  if (changelogUrl?.trim()) {
+    prBody += `
+
+---
+
+[See full changelog](${changelogUrl.trim()})`;
   }
   return { prTitle, prBody };
 }
@@ -33289,11 +33311,17 @@ var GithubStep = class extends BaseStep {
       }
     }
     const finalCommitMessage = this.config.commitMessage ?? "SDK Generation";
+    const headSha = await repository.getHeadSha();
+    const changelogUrl = this.config.changelogEntry ? `https://github.com/${this.config.uri}/blob/${headSha}/changelog.md` : void 0;
     const { prTitle, prBody } = parseCommitMessageForPR(
       finalCommitMessage,
       this.config.changelogEntry,
       this.config.prDescription,
-      this.config.versionBumpReason
+      this.config.versionBumpReason,
+      this.config.previousVersion,
+      this.config.newVersion,
+      this.config.versionBump,
+      changelogUrl
     );
     const replaySection = formatReplayPrBody(replayResult, { branchName: prBranch, repoUri: this.config.uri });
     let enrichedBody = replaySection != null ? prBody + "\n\n---\n\n" + replaySection : prBody;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fern-api/generator-cli",
-  "version": "0.9.7",
+  "version": "0.9.8",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",