@fern-api/generator-cli 0.9.6 → 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

@@ -20098,7 +20098,7 @@ var init_diff3 = __esm({
   }
 });
 
-// ../../node_modules/.pnpm/@fern-api+replay@0.10.3/node_modules/@fern-api/replay/dist/index.js
+// ../../node_modules/.pnpm/@fern-api+replay@0.10.4/node_modules/@fern-api/replay/dist/index.js
 var dist_exports = {};
 __export(dist_exports, {
   FERN_BOT_EMAIL: () => FERN_BOT_EMAIL2,
@@ -21063,7 +21063,7 @@ function status(outputDir) {
 }
 var import_fs6, import_path8, import_yaml, import_crypto, import_promises4, import_os, import_path9, import_fs7, import_path10, import_crypto2, import_fs8, import_path11, import_yaml2, import_crypto3, import_fs9, import_path12, import_fs10, __defProp3, __getOwnPropNames3, __esm3, __export3, GitClient_exports, GitClient, init_GitClient, HybridReconstruction_exports, init_HybridReconstruction, FERN_BOT_NAME2, FERN_BOT_EMAIL2, FERN_BOT_LOGIN2, FERN_SUPPORT_NAMES, LOCKFILE_HEADER, LockfileNotFoundError, LockfileManager, INFRASTRUCTURE_FILES, ReplayDetector, CONFLICT_OPENER, CONFLICT_SEPARATOR, CONFLICT_CLOSER, BINARY_EXTENSIONS, ReplayApplicator, ReplayCommitter, ReplayService, FernignoreMigrator, REPLAY_FERNIGNORE_ENTRIES, GITATTRIBUTES_ENTRIES, EMPTY_RESULT;
 var init_dist3 = __esm({
-  "../../node_modules/.pnpm/@fern-api+replay@0.10.3/node_modules/@fern-api/replay/dist/index.js"() {
+  "../../node_modules/.pnpm/@fern-api+replay@0.10.4/node_modules/@fern-api/replay/dist/index.js"() {
     "use strict";
     init_esm4();
     import_fs6 = require("fs");
@@ -21427,6 +21427,7 @@ var init_dist3 = __esm({
         }
         const log = await this.git.exec([
           "log",
+          "--first-parent",
           "--format=%H%x00%an%x00%ae%x00%s",
           `${lastGen.commit_sha}..HEAD`,
           "--",
@@ -21442,11 +21443,20 @@ var init_dist3 = __esm({
           if (isGenerationCommit(commit)) {
             continue;
           }
-          const parents = await this.git.getCommitParents(commit.sha);
-          if (parents.length > 1) {
+          if (lock.patches.find((p) => p.original_commit === commit.sha)) {
             continue;
           }
-          if (lock.patches.find((p) => p.original_commit === commit.sha)) {
+          const parents = await this.git.getCommitParents(commit.sha);
+          if (parents.length > 1) {
+            const compositePatch = await this.createMergeCompositePatch({
+              mergeCommit: commit,
+              firstParent: parents[0],
+              lastGen,
+              lock
+            });
+            if (compositePatch) {
+              newPatches.push(compositePatch);
+            }
             continue;
           }
           let patchContent;
@@ -21545,6 +21555,46 @@ var init_dist3 = __esm({
         const normalized = patchContent.split("\n").filter((line) => !line.startsWith("From ") && !line.startsWith("index ") && !line.startsWith("Date: ")).join("\n");
         return `sha256:${(0, import_crypto.createHash)("sha256").update(normalized).digest("hex")}`;
       }
+      /**
+       * Create a single composite patch for a merge commit by diffing the merge
+       * commit against its first parent. This captures the net change of the
+       * entire merged branch as one patch, eliminating accumulator chaining and
+       * zero-net-change ghost conflicts.
+       */
+      async createMergeCompositePatch(input) {
+        const { mergeCommit, firstParent, lastGen, lock } = input;
+        const forgottenHashes = new Set(lock.forgotten_hashes ?? []);
+        const filesOutput = await this.git.exec([
+          "diff",
+          "--name-only",
+          firstParent,
+          mergeCommit.sha
+        ]);
+        const files = filesOutput.trim().split("\n").filter(Boolean).filter((f2) => !INFRASTRUCTURE_FILES.has(f2)).filter((f2) => !f2.startsWith(".fern/"));
+        if (files.length === 0) return null;
+        const diff = await this.git.exec([
+          "diff",
+          firstParent,
+          mergeCommit.sha,
+          "--",
+          ...files
+        ]);
+        if (!diff.trim()) return null;
+        const contentHash = this.computeContentHash(diff);
+        if (lock.patches.some((p) => p.content_hash === contentHash) || forgottenHashes.has(contentHash)) {
+          return null;
+        }
+        return {
+          id: `patch-merge-${mergeCommit.sha.slice(0, 8)}`,
+          content_hash: contentHash,
+          original_commit: mergeCommit.sha,
+          original_message: mergeCommit.message,
+          original_author: `${mergeCommit.authorName} <${mergeCommit.authorEmail}>`,
+          base_generation: lastGen.commit_sha,
+          files,
+          patch_content: diff
+        };
+      }
       /**
        * Detect patches via tree diff for non-linear history. Returns a composite patch.
        * Revert reconciliation is skipped here because tree-diff produces a single composite
@@ -32982,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 };
 }
@@ -33239,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.6",
+  "version": "0.9.8",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",
@@ -22,7 +22,7 @@
     "**"
   ],
   "dependencies": {
-    "@fern-api/replay": "0.10.3",
+    "@fern-api/replay": "0.10.4",
     "@octokit/rest": "^22.0.1",
     "es-toolkit": "^1.45.1",
     "tmp-promise": "^3.0.3"