@fern-api/fern-api-dev 5.28.0 → 5.28.2

package/cli.cjs

@@ -360342,9 +360342,9 @@ var require_diff3 = __commonJS({
   }
 });
 
-// ../../../node_modules/.pnpm/@fern-api+replay@0.15.2/node_modules/@fern-api/replay/dist/index.cjs
+// ../../../node_modules/.pnpm/@fern-api+replay@0.16.0/node_modules/@fern-api/replay/dist/index.cjs
 var require_dist14 = __commonJS({
-  "../../../node_modules/.pnpm/@fern-api+replay@0.15.2/node_modules/@fern-api/replay/dist/index.cjs"(exports2, module4) {
+  "../../../node_modules/.pnpm/@fern-api+replay@0.16.0/node_modules/@fern-api/replay/dist/index.cjs"(exports2, module4) {
     "use strict";
     var __defProp4 = Object.defineProperty;
     var __getOwnPropDesc4 = Object.getOwnPropertyDescriptor;
@@ -360880,9 +360880,22 @@ var require_dist14 = __commonJS({
       const hasGenerationMarker = commit.message.startsWith("[fern-generated]") || commit.message.startsWith("[fern-replay]") || commit.message.startsWith("[fern-autoversion]") || commit.message.includes("Generated by Fern") || commit.message.includes("\u{1F916} Generated with Fern") || // Squash merge of a Fern-generated PR uses the PR title as commit message.
       // The default PR title is "SDK Generation" (from GithubStep's commitMessage default).
       // GitHub appends "(#N)" for the PR number, e.g. "SDK Generation (#70)".
-      commit.message.startsWith("SDK Generation");
+      commit.message.startsWith("SDK Generation") || // Merge commit (GitHub's "Create a merge commit" option) of a fern-bot
+      // regen PR. First-parent walking lands on this commit, not on the
+      // generation commit on the side branch, so the classifier must treat
+      // it as a generation boundary. GitHub's default subject is
+      // "Merge pull request #N from <owner>/<branch>"; fern-bot branches are
+      // named "<owner>/fern-bot/<...>".
+      /^Merge pull request #\d+ from [^/]+\/fern-bot\//.test(commit.message);
       return isBotAuthor || hasGenerationMarker;
     }
+    function isGenerationBoundary(commit) {
+      const isFernSupport = FERN_SUPPORT_NAMES.includes(commit.authorName);
+      const isBotAuthor = !isFernSupport && (commit.authorLogin === FERN_BOT_LOGIN || commit.authorEmail === FERN_BOT_EMAIL || commit.authorName === FERN_BOT_NAME);
+      const isAutoversion = commit.message.startsWith("[fern-autoversion]");
+      const hasBoundaryMarker = commit.message.startsWith("[fern-generated]") || commit.message.startsWith("[fern-replay]") || commit.message.includes("Generated by Fern") || commit.message.includes("\u{1F916} Generated with Fern") || commit.message.startsWith("SDK Generation");
+      return isBotAuthor && !isAutoversion || hasBoundaryMarker;
+    }
     function isReplayCommit(commit) {
       return commit.message.startsWith("[fern-replay]");
     }
@@ -361202,8 +361215,48 @@ var require_dist14 = __commonJS({
         this.lockManager = lockManager;
         this.sdkOutputDir = sdkOutputDir;
       }
+      /**
+       * Derive the previous-generation SHA from git history instead of trusting
+       * `lock.current_generation`.
+       *
+       * Walks `git log HEAD --first-parent` and returns the SHA of the most recent
+       * commit that `isGenerationBoundary` classifies as a customization-baseline
+       * boundary, or null if no such commit is reachable from HEAD on the mainline.
+       *
+       * `isGenerationBoundary` is intentionally narrower than `isGenerationCommit`:
+       * it excludes `[fern-autoversion]` (lightweight bumps that don't reset the
+       * baseline) and the GitHub merge-commit subject for fern-bot regen PRs
+       * (which sits on first-parent but where the customer fix-up commits live
+       * on second-parent — stopping at the merge would hide them).
+       *
+       * See docs/adr/0001-derived-scan-boundary.md.
+       */
+      async findPreviousGenerationFromHistory() {
+        let log4;
+        try {
+          log4 = await this.git.exec([
+            "log",
+            "--first-parent",
+            "--format=%H%x00%an%x00%ae%x00%s",
+            "HEAD"
+          ]);
+        } catch {
+          return null;
+        }
+        for (const commit of this.parseGitLog(log4)) {
+          if (isGenerationBoundary(commit)) {
+            return commit.sha;
+          }
+        }
+        return null;
+      }
       async detectNewPatches() {
         const lock = this.lockManager.read();
+        const derivedSha = await this.findPreviousGenerationFromHistory();
+        if (derivedSha !== null) {
+          const derivedRecord = await this.synthesizeGenerationRecord(derivedSha);
+          return this.detectPatchesInRange(derivedSha, derivedRecord, lock);
+        }
         const lastGen = this.getLastGeneration(lock);
         if (!lastGen) {
           return { patches: [], revertedPatchIds: [] };
@@ -361211,7 +361264,7 @@ var require_dist14 = __commonJS({
         const exists2 = await this.git.commitExists(lastGen.commit_sha);
         if (!exists2) {
           this.warnings.push(
-            `Generation commit ${lastGen.commit_sha.slice(0, 7)} not found in git history. Falling back to alternate detection.`
+            `Generation commit ${lastGen.commit_sha.slice(0, 7)} not found in git history. Falling back to tree-diff detection (likely a shallow clone).`
           );
           return this.detectPatchesViaTreeDiff(
             lastGen,
@@ -361219,44 +361272,8 @@ var require_dist14 = __commonJS({
             true
           );
         }
-        const isAncestor = await this.git.isAncestor(lastGen.commit_sha, "HEAD");
-        if (!isAncestor) {
-          return this.detectPatchesViaMergeBase(lastGen, lock);
-        }
         return this.detectPatchesInRange(lastGen.commit_sha, lastGen, lock);
       }
-      /**
-       * Non-linear-history detection via `merge-base(prevGen, HEAD)`.
-       *
-       * After a squash-merge of a Fern-bot PR, `lastGen.commit_sha` (the previous
-       * `[fern-generated]`) is orphaned but still in git's object database. The
-       * merge-base is the commit on main from which the bot's branch was created —
-       * a reachable ancestor of HEAD. Walking that range and classifying each
-       * commit via `isGenerationCommit` mirrors the linear path and eliminates
-       * the bug class where pipeline-driven changes (autoversion, replay,
-       * generation) get bundled as customer customizations.
-       *
-       * Falls through to the legacy composite path when no common ancestor exists
-       * (truly disjoint history — orphan branches with no shared root).
-       */
-      async detectPatchesViaMergeBase(lastGen, lock) {
-        let mergeBase = "";
-        try {
-          mergeBase = (await this.git.exec(["merge-base", lastGen.commit_sha, "HEAD"])).trim();
-        } catch {
-        }
-        if (!mergeBase) {
-          this.warnings.push(
-            `No common ancestor between previous generation ${lastGen.commit_sha.slice(0, 7)} and HEAD. Falling back to composite tree-diff detection.`
-          );
-          return this.detectPatchesViaTreeDiff(
-            lastGen,
-            /* commitKnownMissing */
-            false
-          );
-        }
-        return this.detectPatchesInRange(mergeBase, lastGen, lock);
-      }
       /**
        * Walk `${rangeStart}..HEAD`, classify each commit, emit one
        * `StoredPatch` per customer commit. Body shared by the linear path
@@ -361692,6 +361709,26 @@ var require_dist14 = __commonJS({
       getLastGeneration(lock) {
         return lock.generations.find((g8) => g8.commit_sha === lock.current_generation);
       }
+      /**
+       * Build a transient `GenerationRecord` from a SHA derived by walking git
+       * history. Only `commit_sha` (and `tree_hash` when needed downstream) is
+       * load-bearing here; the rest are filled with defensible placeholders.
+       * This record is consumed by `detectPatchesInRange` and is never persisted.
+       */
+      async synthesizeGenerationRecord(sha) {
+        let tree_hash = "";
+        try {
+          tree_hash = await this.git.getTreeHash(sha);
+        } catch {
+        }
+        return {
+          commit_sha: sha,
+          tree_hash,
+          timestamp: (/* @__PURE__ */ new Date(0)).toISOString(),
+          cli_version: "",
+          generator_versions: {}
+        };
+      }
     };
     var import_node_diff3 = require_diff3();
     function threeWayMerge(base4, ours, theirs) {
@@ -362813,8 +362850,7 @@ Patches absorbed by generator (${buckets.absorbed.length}):`;
           tree_hash: treeHash,
           timestamp: (/* @__PURE__ */ new Date()).toISOString(),
           cli_version: options2?.cliVersion ?? "unknown",
-          generator_versions: options2?.generatorVersions ?? {},
-          base_branch_head: options2?.baseBranchHead
+          generator_versions: options2?.generatorVersions ?? {}
         };
       }
       async stageAll() {
@@ -363193,7 +363229,6 @@ Patches absorbed by generator (${buckets.absorbed.length}):`;
             flow: "first-generation",
             previousGenerationSha: null,
             currentGenerationSha: headSha,
-            baseBranchHead: options2.baseBranchHead ?? null,
             _prepared: {
               kind: "terminal",
               flow: "first-generation",
@@ -363203,8 +363238,7 @@ Patches absorbed by generator (${buckets.absorbed.length}):`;
         }
         const commitOpts = options2 ? {
           cliVersion: options2.cliVersion ?? "unknown",
-          generatorVersions: options2.generatorVersions ?? {},
-          baseBranchHead: options2.baseBranchHead
+          generatorVersions: options2.generatorVersions ?? {}
         } : void 0;
         await this.service.committer.commitGeneration("Initial SDK generation", commitOpts);
         const genRecord = await this.service.committer.createGenerationRecord(commitOpts);
@@ -363213,7 +363247,6 @@ Patches absorbed by generator (${buckets.absorbed.length}):`;
           flow: "first-generation",
           previousGenerationSha: null,
           currentGenerationSha: genRecord.commit_sha,
-          baseBranchHead: options2?.baseBranchHead ?? null,
           _prepared: {
             kind: "active",
             flow: "first-generation",
@@ -363248,8 +363281,7 @@ Patches absorbed by generator (${buckets.absorbed.length}):`;
       async prepare(options2) {
         const commitOpts = options2 ? {
           cliVersion: options2.cliVersion ?? "unknown",
-          generatorVersions: options2.generatorVersions ?? {},
-          baseBranchHead: options2.baseBranchHead
+          generatorVersions: options2.generatorVersions ?? {}
         } : void 0;
         await this.service.committer.commitGeneration("Update SDK (replay skipped)", commitOpts);
         await this.service.cleanupStaleConflictMarkers();
@@ -363271,7 +363303,6 @@ Patches absorbed by generator (${buckets.absorbed.length}):`;
           flow: "skip-application",
           previousGenerationSha,
           currentGenerationSha: genRecord.commit_sha,
-          baseBranchHead: options2?.baseBranchHead ?? null,
           _prepared: {
             kind: "active",
             flow: "skip-application",
@@ -363330,7 +363361,6 @@ Patches absorbed by generator (${buckets.absorbed.length}):`;
             flow: "no-patches",
             previousGenerationSha,
             currentGenerationSha: headSha,
-            baseBranchHead: options2.baseBranchHead ?? null,
             _prepared: {
               kind: "terminal",
               flow: "no-patches",
@@ -363362,8 +363392,7 @@ Patches absorbed by generator (${buckets.absorbed.length}):`;
         }
         const commitOpts = options2 ? {
           cliVersion: options2.cliVersion ?? "unknown",
-          generatorVersions: options2.generatorVersions ?? {},
-          baseBranchHead: options2.baseBranchHead
+          generatorVersions: options2.generatorVersions ?? {}
         } : void 0;
         await this.service.committer.commitGeneration("Update SDK", commitOpts);
         await this.service.cleanupStaleConflictMarkers();
@@ -363373,7 +363402,6 @@ Patches absorbed by generator (${buckets.absorbed.length}):`;
           flow: "no-patches",
           previousGenerationSha,
           currentGenerationSha: genRecord.commit_sha,
-          baseBranchHead: options2?.baseBranchHead ?? null,
           _prepared: {
             kind: "active",
             flow: "no-patches",
@@ -363461,7 +363489,6 @@ Patches absorbed by generator (${buckets.absorbed.length}):`;
             flow: "normal-regeneration",
             previousGenerationSha,
             currentGenerationSha: headSha,
-            baseBranchHead: options2.baseBranchHead ?? null,
             _prepared: {
               kind: "terminal",
               flow: "normal-regeneration",
@@ -363479,14 +363506,16 @@ Patches absorbed by generator (${buckets.absorbed.length}):`;
         existingPatches = this.service.lockManager.getPatches();
         const seenHashes = /* @__PURE__ */ new Map();
         for (const p14 of existingPatches) {
-          const priorPatchId = seenHashes.get(p14.content_hash);
-          if (priorPatchId !== void 0) {
-            this.service.lockManager.removePatch(p14.id);
-            this.service.warnings.push(
-              `Consolidated patch ${p14.id} (commit ${(p14.original_commit || "<missing>").slice(0, 7)}) into prior patch ${priorPatchId}: byte-identical patch_content. Per-commit attribution preserved in git log; lockfile collapsed to avoid duplicate-apply corruption on next regen.`
-            );
-          } else {
-            seenHashes.set(p14.content_hash, p14.id);
+          if (!p14.original_commit || p14.original_commit === "") {
+            const priorPatchId = seenHashes.get(p14.content_hash);
+            if (priorPatchId !== void 0) {
+              this.service.lockManager.removePatch(p14.id);
+              this.service.warnings.push(
+                `Consolidated patch ${p14.id} into prior patch ${priorPatchId}: byte-identical patch_content. Lockfile collapsed to avoid duplicate-apply corruption on next regen.`
+              );
+            } else {
+              seenHashes.set(p14.content_hash, p14.id);
+            }
           }
         }
         existingPatches = this.service.lockManager.getPatches();
@@ -363515,8 +363544,7 @@ Patches absorbed by generator (${buckets.absorbed.length}):`;
         const allPatches = [...existingPatches, ...newPatches];
         const commitOpts = options2 ? {
           cliVersion: options2.cliVersion ?? "unknown",
-          generatorVersions: options2.generatorVersions ?? {},
-          baseBranchHead: options2.baseBranchHead
+          generatorVersions: options2.generatorVersions ?? {}
         } : void 0;
         await this.service.committer.commitGeneration("Update SDK", commitOpts);
         await this.service.cleanupStaleConflictMarkers();
@@ -363526,7 +363554,6 @@ Patches absorbed by generator (${buckets.absorbed.length}):`;
           flow: "normal-regeneration",
           previousGenerationSha,
           currentGenerationSha: genRecord.commit_sha,
-          baseBranchHead: options2?.baseBranchHead ?? null,
           _prepared: {
             kind: "active",
             flow: "normal-regeneration",
@@ -363717,68 +363744,6 @@ Patches absorbed by generator (${buckets.absorbed.length}):`;
         const prep = await this.prepareReplay(options2);
         return this.applyPreparedReplay(prep, options2);
       }
-      /**
-       * Sync the lockfile after a divergent PR was squash-merged.
-       * Call this BEFORE runReplay() when the CLI detects a merged divergent PR.
-       *
-       * After updating the generation record, re-detects customer patches via
-       * tree diff between the generation tag (pure generation tree) and HEAD
-       * (which includes customer customizations after squash merge). This ensures
-       * patches survive the squash merge → regenerate cycle even when the lockfile
-       * was restored from the base branch during conflict PR creation.
-       */
-      async syncFromDivergentMerge(generationCommitSha, options2) {
-        const treeHash = await this.git.getTreeHash(generationCommitSha);
-        const timestamp2 = (await this.git.exec(["log", "-1", "--format=%aI", generationCommitSha])).trim();
-        const record23 = {
-          commit_sha: generationCommitSha,
-          tree_hash: treeHash,
-          timestamp: timestamp2,
-          cli_version: options2?.cliVersion ?? "unknown",
-          generator_versions: options2?.generatorVersions ?? {},
-          base_branch_head: options2?.baseBranchHead
-        };
-        let resolvedPatches;
-        if (!this.lockManager.exists()) {
-          this.lockManager.initializeInMemory(record23);
-        } else {
-          this.lockManager.read();
-          const unresolvedPatches = [
-            ...this.lockManager.getUnresolvedPatches(),
-            ...this.lockManager.getResolvingPatches()
-          ];
-          resolvedPatches = this.lockManager.getPatches().filter((p14) => p14.status == null);
-          this.lockManager.addGeneration(record23);
-          this.lockManager.clearPatches();
-          for (const patch5 of unresolvedPatches) {
-            this.lockManager.addPatch(patch5);
-          }
-        }
-        try {
-          const { patches: redetectedPatches } = await this.detector.detectNewPatches();
-          if (redetectedPatches.length > 0) {
-            const redetectedFiles = new Set(redetectedPatches.flatMap((p14) => p14.files));
-            const currentPatches = this.lockManager.getPatches();
-            for (const patch5 of currentPatches) {
-              if (patch5.status != null && patch5.files.some((f4) => redetectedFiles.has(f4))) {
-                this.lockManager.removePatch(patch5.id);
-              }
-            }
-            for (const patch5 of redetectedPatches) {
-              this.lockManager.addPatch(patch5);
-            }
-          }
-        } catch (error50) {
-          for (const patch5 of resolvedPatches ?? []) {
-            this.lockManager.addPatch(patch5);
-          }
-          this.detector.warnings.push(
-            `Patch re-detection failed after divergent merge sync. ${(resolvedPatches ?? []).length} previously resolved patch(es) preserved. Error: ${error50 instanceof Error ? error50.message : String(error50)}`
-          );
-        }
-        this.lockManager.save();
-        this.detector.warnings.push(...this.lockManager.warnings);
-      }
       determineFlow() {
         try {
           const lock = this.lockManager.read();
@@ -365476,14 +365441,12 @@ var require_replay_run = __commonJS({
     exports2.replayPrepare = replayPrepare;
     exports2.replayApply = replayApply;
     exports2.replayRun = replayRun;
-    exports2.isTagMergedIntoHead = isTagMergedIntoHead;
     var replay_1 = require_dist14();
-    var child_process_1 = require("child_process");
     var fs_1 = require("fs");
     var path_1 = require("path");
     var fernignore_1 = require_fernignore();
     async function replayPrepare(params2, state) {
-      const { outputDir, cliVersion, generatorVersions, stageOnly = false, generatorName, skipApplication, logger: logger4 } = params2;
+      const { outputDir, cliVersion, generatorVersions, stageOnly = false, skipApplication, logger: logger4 } = params2;
       const lockfilePath = (0, path_1.join)(outputDir, ".fern", "replay.lock");
       let autoBootstrapped = false;
       let bootstrapAttempted = false;
@@ -365516,57 +365479,6 @@ var require_replay_run = __commonJS({
           return null;
         }
       }
-      const baseBranchHead = gitRevParse(outputDir, "HEAD");
-      let previousGenerationSha = null;
-      let prevBaseBranchHead = null;
-      try {
-        const lockManager = new replay_1.LockfileManager(outputDir);
-        if (lockManager.exists()) {
-          const lock = lockManager.read();
-          previousGenerationSha = lock.current_generation;
-          const latestGen = lock.generations.find((g8) => g8.commit_sha === lock.current_generation);
-          prevBaseBranchHead = latestGen?.base_branch_head ?? null;
-        }
-      } catch {
-      }
-      if (previousGenerationSha != null) {
-        const sanitizedName = generatorName?.replace(/\//g, "--");
-        const namespacedTag = sanitizedName != null ? `fern-generation-base--${sanitizedName}` : null;
-        const tagSha = (namespacedTag != null ? gitRevParse(outputDir, namespacedTag) : null) ?? gitRevParse(outputDir, "fern-generation-base");
-        let shouldSync = false;
-        if (tagSha != null) {
-          const tagParent = gitRevParse(outputDir, `${tagSha}^`);
-          if (tagParent === prevBaseBranchHead || tagParent === previousGenerationSha) {
-            const tagDistance = gitDiffNameOnly(outputDir, tagSha, "HEAD").length;
-            const lockDistance = gitDiffNameOnly(outputDir, prevBaseBranchHead ?? previousGenerationSha, "HEAD").length;
-            shouldSync = tagDistance < lockDistance;
-          }
-        }
-        if (shouldSync && tagSha != null) {
-          if (!isTagMergedIntoHead(outputDir, tagSha)) {
-            logger4?.warn(`fern-generation-base tag ${tagSha} is not reachable from HEAD \u2014 skipping divergent-merge sync. The tag likely points at an unmerged generation (PR closed without merge).`);
-          } else {
-            try {
-              const syncService = new replay_1.ReplayService(outputDir, { enabled: true });
-              await syncService.syncFromDivergentMerge(tagSha, {
-                cliVersion,
-                generatorVersions,
-                baseBranchHead: baseBranchHead ?? void 0
-              });
-            } catch (error50) {
-              logger4?.warn("Replay divergent-merge sync failed, continuing without sync: " + String(error50));
-              throw new ReplayPrepareError(String(error50), error50);
-            }
-            try {
-              const freshLockManager = new replay_1.LockfileManager(outputDir);
-              if (freshLockManager.exists()) {
-                previousGenerationSha = freshLockManager.read().current_generation;
-              }
-            } catch {
-            }
-          }
-        }
-      }
       const service = new replay_1.ReplayService(outputDir, { enabled: true });
       let preparation;
       try {
@@ -365574,8 +365486,7 @@ var require_replay_run = __commonJS({
           cliVersion,
           generatorVersions,
           stageOnly,
-          skipApplication,
-          baseBranchHead: baseBranchHead ?? void 0
+          skipApplication
         });
       } catch (error50) {
         logger4?.warn("Replay prepare failed, continuing without replay: " + String(error50));
@@ -365586,9 +365497,8 @@ var require_replay_run = __commonJS({
         _preparation: preparation,
         outputDir,
         flow: preparation.flow,
-        previousGenerationSha,
+        previousGenerationSha: preparation.previousGenerationSha,
         currentGenerationSha: preparation.currentGenerationSha,
-        baseBranchHead,
         autoBootstrapped,
         bootstrapAttempted
       };
@@ -365605,24 +365515,11 @@ var require_replay_run = __commonJS({
           fernignoreUpdated: false,
           previousGenerationSha: prepared.previousGenerationSha,
           currentGenerationSha: prepared.currentGenerationSha,
-          baseBranchHead: prepared.baseBranchHead,
           autoBootstrapped: prepared.autoBootstrapped,
           bootstrapAttempted: prepared.bootstrapAttempted,
           failureReason: String(error50)
         };
       }
-      let resolvedBaseBranchHead = prepared.baseBranchHead;
-      try {
-        const freshLockManager = new replay_1.LockfileManager(prepared.outputDir);
-        if (freshLockManager.exists()) {
-          const freshLock = freshLockManager.read();
-          const latestGen = freshLock.generations.find((g8) => g8.commit_sha === freshLock.current_generation);
-          if (latestGen?.base_branch_head) {
-            resolvedBaseBranchHead = latestGen.base_branch_head;
-          }
-        }
-      } catch {
-      }
       const fernignoreUpdated = await (0, fernignore_1.ensureReplayFernignoreEntries)(prepared.outputDir);
       await (0, fernignore_1.ensureGitattributesEntries)(prepared.outputDir);
       return {
@@ -365630,7 +365527,6 @@ var require_replay_run = __commonJS({
         fernignoreUpdated,
         previousGenerationSha: prepared.previousGenerationSha,
         currentGenerationSha: prepared.currentGenerationSha,
-        baseBranchHead: resolvedBaseBranchHead,
         autoBootstrapped: prepared.autoBootstrapped,
         bootstrapAttempted: prepared.bootstrapAttempted
       };
@@ -365646,7 +365542,6 @@ var require_replay_run = __commonJS({
           fernignoreUpdated: false,
           previousGenerationSha: null,
           currentGenerationSha: null,
-          baseBranchHead: null,
           autoBootstrapped: false,
           bootstrapAttempted: prepareState.bootstrapAttempted,
           failureReason: error50 instanceof ReplayPrepareError ? error50.reason : String(error50)
@@ -365658,7 +365553,6 @@ var require_replay_run = __commonJS({
           fernignoreUpdated: false,
           previousGenerationSha: null,
           currentGenerationSha: null,
-          baseBranchHead: null,
           autoBootstrapped: false,
           bootstrapAttempted: prepareState.bootstrapAttempted
         };
@@ -365678,53 +365572,6 @@ var require_replay_run = __commonJS({
       }
     };
     exports2.ReplayPrepareError = ReplayPrepareError;
-    function isTagMergedIntoHead(cwd2, tagSha) {
-      try {
-        (0, child_process_1.execFileSync)("git", ["merge-base", "--is-ancestor", tagSha, "HEAD"], {
-          cwd: cwd2,
-          stdio: "pipe"
-        });
-        return true;
-      } catch {
-      }
-      const tagTree = gitRevParse(cwd2, `${tagSha}^{tree}`);
-      if (tagTree == null) {
-        return false;
-      }
-      try {
-        const trees = (0, child_process_1.execFileSync)("git", ["log", "HEAD", "--format=%T", "--max-count=500"], {
-          cwd: cwd2,
-          encoding: "utf-8",
-          stdio: "pipe"
-        });
-        return trees.split("\n").some((t3) => t3.trim() === tagTree);
-      } catch {
-        return false;
-      }
-    }
-    function gitRevParse(cwd2, rev) {
-      try {
-        return (0, child_process_1.execFileSync)("git", ["rev-parse", "--verify", rev], {
-          cwd: cwd2,
-          encoding: "utf-8",
-          stdio: "pipe"
-        }).trim();
-      } catch {
-        return null;
-      }
-    }
-    function gitDiffNameOnly(cwd2, from4, to10) {
-      try {
-        const output2 = (0, child_process_1.execFileSync)("git", ["diff", "--name-only", from4, to10], {
-          cwd: cwd2,
-          encoding: "utf-8",
-          stdio: "pipe"
-        });
-        return output2.trim().split("\n").filter(Boolean);
-      } catch {
-        return [];
-      }
-    }
   }
 });
 
@@ -365741,14 +365588,12 @@ var require_GenerationCommitStep = __commonJS({
       config;
       cliVersion;
       generatorVersions;
-      generatorName;
       name = "generationCommit";
-      constructor(outputDir, logger4, config5, cliVersion, generatorVersions, generatorName) {
+      constructor(outputDir, logger4, config5, cliVersion, generatorVersions) {
         super(outputDir, logger4);
         this.config = config5;
         this.cliVersion = cliVersion;
         this.generatorVersions = generatorVersions;
-        this.generatorName = generatorName;
       }
       async execute(_context) {
         const headBeforePrepare = tryRevParse(this.outputDir, "HEAD");
@@ -365759,7 +365604,6 @@ var require_GenerationCommitStep = __commonJS({
             outputDir: this.outputDir,
             cliVersion: this.cliVersion,
             generatorVersions: this.generatorVersions,
-            generatorName: this.generatorName,
             skipApplication: this.config.skipApplication,
             logger: this.logger
           }, prepareState);
@@ -365796,7 +365640,6 @@ var require_GenerationCommitStep = __commonJS({
           preparedReplay: prepared,
           previousGenerationSha: prepared.previousGenerationSha ?? void 0,
           currentGenerationSha: prepared.currentGenerationSha,
-          baseBranchHead: prepared.baseBranchHead ?? void 0,
           flow: prepared.flow,
           bootstrapAttempted: prepareState.bootstrapAttempted
         };
@@ -370467,14 +370310,12 @@ var require_ReplayStep = __commonJS({
       config;
       cliVersion;
       generatorVersions;
-      generatorName;
       name = "replay";
-      constructor(outputDir, logger4, config5, cliVersion, generatorVersions, generatorName) {
+      constructor(outputDir, logger4, config5, cliVersion, generatorVersions) {
         super(outputDir, logger4);
         this.config = config5;
         this.cliVersion = cliVersion;
         this.generatorVersions = generatorVersions;
-        this.generatorName = generatorName;
       }
       async execute(context3) {
         const generationCommit = context3.previousStepResults.generationCommit;
@@ -370513,7 +370354,6 @@ var require_ReplayStep = __commonJS({
           cliVersion: this.cliVersion,
           generatorVersions: this.generatorVersions,
           stageOnly: this.config.stageOnly ?? false,
-          generatorName: this.generatorName,
           skipApplication: this.config.skipApplication,
           logger: this.logger
         });
@@ -370525,7 +370365,6 @@ var require_ReplayStep = __commonJS({
             errorMessage: result.failureReason,
             previousGenerationSha: result.previousGenerationSha ?? void 0,
             currentGenerationSha: result.currentGenerationSha ?? void 0,
-            baseBranchHead: result.baseBranchHead ?? void 0,
             autoBootstrapped: result.autoBootstrapped,
             bootstrapAttempted: result.bootstrapAttempted,
             flow: "normal-regeneration",
@@ -370540,7 +370379,6 @@ var require_ReplayStep = __commonJS({
             success: true,
             previousGenerationSha: result.previousGenerationSha ?? void 0,
             currentGenerationSha: result.currentGenerationSha ?? void 0,
-            baseBranchHead: result.baseBranchHead ?? void 0,
             autoBootstrapped: result.autoBootstrapped,
             bootstrapAttempted: result.bootstrapAttempted,
             flow: "first-generation",
@@ -370555,7 +370393,6 @@ var require_ReplayStep = __commonJS({
           success: true,
           previousGenerationSha: result.previousGenerationSha ?? void 0,
           currentGenerationSha: result.currentGenerationSha ?? void 0,
-          baseBranchHead: result.baseBranchHead ?? void 0,
           autoBootstrapped: result.autoBootstrapped,
           bootstrapAttempted: result.bootstrapAttempted,
           flow: report.flow,
@@ -370948,13 +370785,13 @@ var require_PostGenerationPipeline = __commonJS({
           autoVersionEnabled = false;
         }
         if (replayEnabled && config5.replay != null) {
-          this.steps.push(new GenerationCommitStep_1.GenerationCommitStep(config5.outputDir, this.logger, { enabled: true, skipApplication: config5.replay.skipApplication }, config5.cliVersion, config5.generatorVersions, config5.generatorName));
+          this.steps.push(new GenerationCommitStep_1.GenerationCommitStep(config5.outputDir, this.logger, { enabled: true, skipApplication: config5.replay.skipApplication }, config5.cliVersion, config5.generatorVersions));
         }
         if (autoVersionEnabled && config5.autoVersion != null) {
           this.steps.push(new AutoVersionStep_1.AutoVersionStep(config5.outputDir, this.logger, config5.autoVersion));
         }
         if (replayEnabled && config5.replay != null) {
-          this.steps.push(new ReplayStep_1.ReplayStep(config5.outputDir, this.logger, config5.replay, config5.cliVersion, config5.generatorVersions, config5.generatorName));
+          this.steps.push(new ReplayStep_1.ReplayStep(config5.outputDir, this.logger, config5.replay, config5.cliVersion, config5.generatorVersions));
         }
         if (config5.verify?.enabled) {
           this.steps.push(new VerificationStep_1.VerificationStep(config5.outputDir, this.logger, config5.verify, config5.generatorName, config5.generatorVersions));
@@ -668113,7 +667950,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.28.0",
+          version: "5.28.2",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -668177,7 +668014,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.28.0",
+        version: "5.28.2",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -825352,6 +825189,7 @@ function convertAvailability5(availability) {
 }
 
 // ../docs-resolver/lib/stitchGlobalTheme.js
+init_lib4();
 init_lib8();
 init_lib6();
 var import_promises66 = require("fs/promises");
@@ -825486,6 +825324,18 @@ async function resolveThemeFileUrls(themeConfig, tmpDir) {
   }
   return cfg;
 }
+function deepMergeGlobalWins(local, global3) {
+  const result = { ...local };
+  for (const [key2, globalValue] of Object.entries(global3)) {
+    const localValue = local[key2];
+    if (isPlainObject4(globalValue) && isPlainObject4(localValue)) {
+      result[key2] = deepMergeGlobalWins(localValue, globalValue);
+    } else {
+      result[key2] = globalValue;
+    }
+  }
+  return result;
+}
 var THEME_FIELD_POLICIES = {
   logo: "global",
   favicon: "global",
@@ -825539,7 +825389,11 @@ function mergeThemeOverride(local, themeOverride) {
     const localHasValue = localValue !== void 0 && localValue !== null;
     if (policy === "global") {
       if (themeHasValue) {
-        merged[key2] = themeValue;
+        if (isPlainObject4(themeValue) && isPlainObject4(localValue)) {
+          merged[key2] = deepMergeGlobalWins(localValue, themeValue);
+        } else {
+          merged[key2] = themeValue;
+        }
       }
     } else {
       if (localHasValue) {
@@ -859851,7 +859705,7 @@ var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 var MAX_LOGS_DIR_SIZE_BYTES = 100 * 1024 * 1024;
 function getCliSource() {
-  const version7 = "5.28.0";
+  const version7 = "5.28.2";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -873860,7 +873714,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.28.0",
+        cliVersion: "5.28.2",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -948265,7 +948119,7 @@ function getAutomationContextFromEnv() {
     config_branch: process.env.FERN_CONFIG_BRANCH,
     config_pr_number: process.env.FERN_CONFIG_PR_NUMBER,
     trigger: process.env.GITHUB_EVENT_NAME,
-    cli_version: "5.28.0"
+    cli_version: "5.28.2"
   };
 }
 function isAutomationMode() {
@@ -949091,7 +948945,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.28.0";
+    return "5.28.2";
   }
   getCliName() {
     if (false) {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "5.28.0",
+  "version": "5.28.2",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",