@fern-api/fern-api-dev 5.46.0 → 5.46.1

package/cli.cjs

@@ -422153,30 +422153,30 @@ var require_AutoVersionStep = __commonJS({
       }
       async execute(context3) {
         const prepared = context3.previousStepResults.generationCommit?.preparedReplay;
-        if (!prepared) {
-          this.logger.info("AutoVersionStep: no replay preparation available (replay uninitialized or prepare failed); skipping.");
-          return { executed: true, success: true };
-        }
-        if (prepared.flow === "skip-application") {
-          this.logger.info("AutoVersionStep: replay flow is skip-application; skipping autoversion.");
-          return { executed: true, success: true };
-        }
-        const language = this.config.language;
-        const mappedMagicVersion = (0, index_1.mapMagicVersionForLanguage)(index_1.MAGIC_VERSION, language);
-        const service = new index_1.AutoVersioningService({ logger: this.toTaskLogger() });
-        if (prepared.previousGenerationSha == null) {
-          return await this.handleFirstGeneration({ service, language, mappedMagicVersion });
+        if (prepared) {
+          if (prepared.flow === "skip-application") {
+            this.logger.info("AutoVersionStep: replay flow is skip-application; skipping autoversion.");
+            return { executed: true, success: true };
+          }
+          const language = this.config.language;
+          const mappedMagicVersion = (0, index_1.mapMagicVersionForLanguage)(index_1.MAGIC_VERSION, language);
+          const service = new index_1.AutoVersioningService({ logger: this.toTaskLogger() });
+          if (prepared.previousGenerationSha == null) {
+            return await this.handleFirstGeneration({ service, language, mappedMagicVersion, commit: true });
+          }
+          return await this.handleNormalFlow({
+            prepared,
+            service,
+            language,
+            mappedMagicVersion,
+            previousGenerationSha: prepared.previousGenerationSha
+          });
         }
-        return await this.handleNormalFlow({
-          prepared,
-          service,
-          language,
-          mappedMagicVersion,
-          previousGenerationSha: prepared.previousGenerationSha
-        });
+        this.logger.info("AutoVersionStep: running in non-replay mode (git diff HEAD).");
+        return await this.handleNonReplayFlow();
       }
       async handleFirstGeneration(params2) {
-        const { service, language, mappedMagicVersion } = params2;
+        const { service, language, mappedMagicVersion, commit } = params2;
         const initialVersion = this.config.baseVersion ?? (mappedMagicVersion.startsWith("v") ? "v0.0.1" : "0.0.1");
         if (!(0, index_1.isValidSemver)(initialVersion)) {
           const errorMessage = `AutoVersionStep: baseVersion ${JSON.stringify(initialVersion)} is not a valid semver string (expected e.g. "1.2.3" or "v1.2.3"). Refusing to run to avoid shell injection into the placeholder-rewrite step.`;
@@ -422193,7 +422193,7 @@ var require_AutoVersionStep = __commonJS({
           await service.addGoMajorVersionSuffix(this.outputDir, initialVersion);
         }
         const commitMessage = this.brandMessage("Initial SDK generation");
-        const commitSha = this.commitAutoversion(commitMessage);
+        const commitSha = commit ? this.commitAutoversion(commitMessage) : void 0;
         return {
           executed: true,
           success: true,
@@ -422212,7 +422212,7 @@ var require_AutoVersionStep = __commonJS({
           baseVersion: this.config.baseVersion
         });
         if (previousVersion == null) {
-          return await this.handleFirstGeneration({ service, language, mappedMagicVersion });
+          return await this.handleFirstGeneration({ service, language, mappedMagicVersion, commit: true });
         }
         if (rawDiff.trim().length === 0) {
           this.logger.info(`AutoVersionStep: empty diff between generations; rewriting placeholder to ${previousVersion}.`);
@@ -422283,6 +422283,94 @@ var require_AutoVersionStep = __commonJS({
           analysis
         });
       }
+      /**
+       * Non-replay autoversion: diffs HEAD (committed SDK) vs the working tree
+       * (freshly generated files). Does NOT commit — GithubStep will commit all
+       * changes (including the rewritten placeholder) in a single generation commit.
+       */
+      async handleNonReplayFlow() {
+        const language = this.config.language;
+        const mappedMagicVersion = (0, index_1.mapMagicVersionForLanguage)(index_1.MAGIC_VERSION, language);
+        const service = new index_1.AutoVersioningService({ logger: this.toTaskLogger() });
+        const rawDiff = this.gitDiffHead();
+        const previousVersion = await this.resolvePreviousVersionNonReplay({
+          service,
+          rawDiff,
+          mappedMagicVersion,
+          baseVersion: this.config.baseVersion
+        });
+        if (previousVersion == null) {
+          return await this.handleFirstGeneration({ service, language, mappedMagicVersion, commit: false });
+        }
+        if (rawDiff.trim().length === 0) {
+          this.logger.info(`AutoVersionStep: empty diff (non-replay); rewriting placeholder to ${previousVersion}.`);
+          return await this.finalizeNoChangeNonReplay({
+            service,
+            language,
+            mappedMagicVersion,
+            previousVersion,
+            reason: "no diff between generations"
+          });
+        }
+        const cleanedDiff = service.cleanDiffForAI(rawDiff, mappedMagicVersion);
+        const rawBytes = Buffer.byteLength(rawDiff, "utf-8");
+        const cleanedBytes = Buffer.byteLength(cleanedDiff, "utf-8");
+        this.logger.debug(`AutoVersionStep (non-replay): raw=${(0, index_1.formatSizeKB)(rawBytes)}KB (${(0, index_1.countFilesInDiff)(rawDiff)} files), cleaned=${(0, index_1.formatSizeKB)(cleanedBytes)}KB (${(0, index_1.countFilesInDiff)(cleanedDiff)} files)`);
+        if (cleanedDiff.trim().length === 0) {
+          this.logger.info(`AutoVersionStep: cleaned diff empty (non-replay); rewriting placeholder to ${previousVersion}.`);
+          return await this.finalizeNoChangeNonReplay({
+            service,
+            language,
+            mappedMagicVersion,
+            previousVersion,
+            reason: "no semantic changes"
+          });
+        }
+        if (cleanedBytes > index_1.MAX_RAW_DIFF_BYTES) {
+          this.logger.warn(`AutoVersionStep (non-replay): diff too large (${(0, index_1.formatSizeKB)(cleanedBytes)}KB). Falling back to PATCH.`);
+          return await this.finalizeWithBumpNonReplay({
+            service,
+            language,
+            mappedMagicVersion,
+            previousVersion,
+            analysis: { versionBump: "PATCH", message: this.brandMessage("SDK regeneration") }
+          });
+        }
+        let analysis;
+        try {
+          if (this.config.ai == null && this.config.fernToken != null) {
+            analysis = await this.analyzeViaFaiService(cleanedDiff, language, previousVersion);
+          } else {
+            const chunks = service.chunkDiff(cleanedDiff, index_1.MAX_AI_DIFF_BYTES);
+            const cappedChunks = chunks.slice(0, index_1.MAX_CHUNKS);
+            const skippedChunks = chunks.length - cappedChunks.length;
+            if (chunks.length > 1) {
+              this.logger.info(`AutoVersionStep (non-replay): split diff into ${chunks.length} chunks` + (skippedChunks > 0 ? ` (capped at ${index_1.MAX_CHUNKS}, skipping ${skippedChunks})` : ""));
+            }
+            analysis = cappedChunks.length <= 1 ? await this.analyzeSingle(cleanedDiff, language, previousVersion) : await this.analyzeChunks(cappedChunks, language, previousVersion);
+          }
+        } catch (error50) {
+          this.logger.warn(`AutoVersionStep (non-replay): FAI analysis failed (${String(error50)}); falling back to PATCH bump.`);
+          analysis = { versionBump: "PATCH", message: this.brandMessage("SDK regeneration") };
+        }
+        if (analysis == null) {
+          this.logger.info(`AutoVersionStep (non-replay): FAI returned NO_CHANGE; rewriting placeholder to ${previousVersion}.`);
+          return await this.finalizeNoChangeNonReplay({
+            service,
+            language,
+            mappedMagicVersion,
+            previousVersion,
+            reason: "FAI returned NO_CHANGE"
+          });
+        }
+        return await this.finalizeWithBumpNonReplay({
+          service,
+          language,
+          mappedMagicVersion,
+          previousVersion,
+          analysis
+        });
+      }
       /**
        * Terminal path for runs that determine no semver bump is needed. The
        * current working tree still contains `0.0.0-fern-placeholder` from this
@@ -422340,6 +422428,94 @@ var require_AutoVersionStep = __commonJS({
           commitSha
         };
       }
+      /**
+       * Non-replay variant of finalizeNoChange. Rewrites the placeholder to
+       * `previousVersion` but does NOT commit — GithubStep handles the commit.
+       */
+      async finalizeNoChangeNonReplay(params2) {
+        const { service, language, mappedMagicVersion, previousVersion, reason } = params2;
+        if (!(0, index_1.isValidSemver)(previousVersion)) {
+          const errorMessage = `AutoVersionStep: resolved previousVersion ${JSON.stringify(previousVersion)} is not a valid semver string. Refusing to rewrite placeholder to avoid shell injection.`;
+          this.logger.error(errorMessage);
+          return { executed: true, success: false, errorMessage };
+        }
+        await service.replaceMagicVersion(this.outputDir, mappedMagicVersion, previousVersion);
+        if (language === "go") {
+          await service.addGoMajorVersionSuffix(this.outputDir, previousVersion);
+        }
+        const commitMessage = this.brandMessage(`SDK regeneration (no semver change: ${reason})`);
+        return {
+          executed: true,
+          success: true,
+          version: previousVersion,
+          previousVersion,
+          versionBump: "NO_CHANGE",
+          commitMessage
+        };
+      }
+      /**
+       * Non-replay variant of finalizeWithBump. Rewrites the placeholder to
+       * the bumped version but does NOT commit — GithubStep handles the commit.
+       */
+      async finalizeWithBumpNonReplay(params2) {
+        const { service, language, mappedMagicVersion, previousVersion, analysis } = params2;
+        const newVersion = (0, index_1.incrementVersion)(previousVersion, analysis.versionBump);
+        this.logger.info(`AutoVersionStep (non-replay): ${analysis.versionBump} bump: ${previousVersion} \u2192 ${newVersion}`);
+        await service.replaceMagicVersion(this.outputDir, mappedMagicVersion, newVersion);
+        if (language === "go") {
+          await service.addGoMajorVersionSuffix(this.outputDir, newVersion);
+        }
+        if (analysis.changelogEntry && analysis.changelogEntry.trim().length > 0) {
+          await this.prependChangelogEntry({ version: newVersion, entry: analysis.changelogEntry });
+        }
+        return {
+          executed: true,
+          success: true,
+          version: newVersion,
+          commitMessage: analysis.message,
+          changelogEntry: analysis.changelogEntry,
+          previousVersion,
+          versionBump: analysis.versionBump,
+          prDescription: analysis.prDescription,
+          versionBumpReason: analysis.versionBumpReason
+        };
+      }
+      /**
+       * Resolves the previous version for non-replay mode. Reads HEAD:.fern/metadata.json
+       * (not HEAD~1, since no generation commit exists yet) as the primary fallback.
+       */
+      async resolvePreviousVersionNonReplay(params2) {
+        const { service, rawDiff, mappedMagicVersion, baseVersion } = params2;
+        if (baseVersion != null && (0, index_1.isValidSemver)(baseVersion)) {
+          this.logger.debug(`AutoVersionStep (non-replay): previous version from pipeline baseVersion: ${baseVersion}`);
+          return this.normalizeVersionPrefix(baseVersion, mappedMagicVersion);
+        }
+        try {
+          const extracted = service.extractPreviousVersion(rawDiff, mappedMagicVersion);
+          if (extracted != null) {
+            this.logger.debug(`AutoVersionStep (non-replay): previous version from diff: ${extracted}`);
+            return extracted;
+          }
+        } catch (error50) {
+          if (!(error50 instanceof index_1.AutoVersioningException) || !error50.magicVersionAbsent) {
+            throw error50;
+          }
+          this.logger.info("AutoVersionStep (non-replay): magic version not in diff; trying metadata + git tags.");
+        }
+        const metadataVersion = this.readVersionFromMetadataAtHead();
+        if (metadataVersion != null) {
+          return this.normalizeVersionPrefix(metadataVersion, mappedMagicVersion);
+        }
+        try {
+          const tagVersion = await service.getLatestVersionFromGitTags(this.outputDir);
+          if (tagVersion != null) {
+            return this.normalizeVersionPrefix(tagVersion, mappedMagicVersion);
+          }
+        } catch (error50) {
+          this.logger.debug(`AutoVersionStep (non-replay): git-tags fallback failed (${String(error50)}); ignoring.`);
+        }
+        return null;
+      }
       async resolvePreviousVersion(params2) {
         const { service, rawDiff, mappedMagicVersion, baseVersion } = params2;
         if (baseVersion != null && (0, index_1.isValidSemver)(baseVersion)) {
@@ -422389,6 +422565,42 @@ var require_AutoVersionStep = __commonJS({
         const stripped = version7.startsWith("v") ? version7.slice(1) : version7;
         return mappedMagicVersion.startsWith("v") ? `v${stripped}` : stripped;
       }
+      /**
+       * Reads the sdkVersion from the committed (HEAD) .fern/metadata.json.
+       * Used by the non-replay path where no generation commit exists yet,
+       * so HEAD is the unmodified SDK repository.
+       */
+      readVersionFromMetadataAtHead() {
+        try {
+          const output2 = (0, child_process_1.execFileSync)("git", ["show", "HEAD:.fern/metadata.json"], {
+            cwd: this.outputDir,
+            encoding: "utf-8",
+            stdio: "pipe"
+          });
+          const parsed = JSON.parse(output2);
+          return parsed.sdkVersion ?? void 0;
+        } catch (error50) {
+          this.logger.debug(`AutoVersionStep: failed to read HEAD:.fern/metadata.json (${String(error50)})`);
+          return void 0;
+        }
+      }
+      /**
+       * Computes a diff between HEAD (committed SDK) and the working tree (new
+       * generation). Marks untracked files as intent-to-add so they appear in
+       * the diff, matching LocalTaskHandler.generateDiffFile() behavior.
+       */
+      gitDiffHead() {
+        (0, child_process_1.execFileSync)("git", ["add", "-N", "."], {
+          cwd: this.outputDir,
+          stdio: "pipe"
+        });
+        return (0, child_process_1.execFileSync)("git", ["diff", "HEAD", "--", ".", ":(exclude).fern/metadata.json"], {
+          cwd: this.outputDir,
+          encoding: "utf-8",
+          stdio: "pipe",
+          maxBuffer: 256 * 1024 * 1024
+        });
+      }
       gitDiff(from4, to10) {
         return (0, child_process_1.execFileSync)("git", ["diff", from4, to10, "--", ".", ":(exclude).fern/metadata.json"], {
           cwd: this.outputDir,
@@ -428120,9 +428332,9 @@ var require_diff3 = __commonJS({
   }
 });
 
-// ../../../node_modules/.pnpm/@fern-api+replay@0.16.2/node_modules/@fern-api/replay/dist/index.cjs
+// ../../../node_modules/.pnpm/@fern-api+replay@0.18.0/node_modules/@fern-api/replay/dist/index.cjs
 var require_dist24 = __commonJS({
-  "../../../node_modules/.pnpm/@fern-api+replay@0.16.2/node_modules/@fern-api/replay/dist/index.cjs"(exports2, module4) {
+  "../../../node_modules/.pnpm/@fern-api+replay@0.18.0/node_modules/@fern-api/replay/dist/index.cjs"(exports2, module4) {
     "use strict";
     var __defProp4 = Object.defineProperty;
     var __getOwnPropDesc3 = Object.getOwnPropertyDescriptor;
@@ -428176,6 +428388,11 @@ var require_dist24 = __commonJS({
               proc2.stderr.on("data", (data2) => {
                 stderr += data2.toString();
               });
+              proc2.on("error", (err) => {
+                reject(new Error(`git ${args.join(" ")} failed to spawn: ${err.message}`));
+              });
+              proc2.stdin.on("error", () => {
+              });
               proc2.on("close", (code5) => {
                 if (code5 === 0) {
                   resolve22(stdout);
@@ -428959,7 +429176,8 @@ var require_dist24 = __commonJS({
     var INFRASTRUCTURE_FILES = /* @__PURE__ */ new Set([".fernignore"]);
     function matchesFernignorePattern(filePath, patterns) {
       if (patterns.length === 0) return false;
-      return patterns.some((p14) => {
+      return patterns.some((rawPattern) => {
+        const p14 = rawPattern.endsWith("/") ? rawPattern.slice(0, -1) : rawPattern;
         if (filePath === p14) return true;
         if ((0, import_minimatch22.minimatch)(filePath, p14)) return true;
         if (!p14.includes("*") && !p14.includes("?") && filePath.startsWith(p14 + "/")) return true;
@@ -429059,6 +429277,22 @@ var require_dist24 = __commonJS({
             return commit.sha;
           }
         }
+        let fullLog;
+        try {
+          fullLog = await this.git.exec([
+            "log",
+            "--no-merges",
+            "--format=%H%x00%an%x00%ae%x00%s",
+            "HEAD"
+          ]);
+        } catch {
+          return null;
+        }
+        for (const commit of this.parseGitLog(fullLog)) {
+          if (isGenerationBoundary(commit)) {
+            return commit.sha;
+          }
+        }
         return null;
       }
       async detectNewPatches() {
@@ -429070,6 +429304,11 @@ var require_dist24 = __commonJS({
         }
         const lastGen = this.getLastGeneration(lock);
         if (!lastGen) {
+          if (lock.current_generation) {
+            this.warnings.push(
+              `No generation boundary found in git history and the lockfile's recorded generation (${lock.current_generation.slice(0, 7)}) matches no entry in its generation records. Customer customizations may differ from the last known generation and could be lost on the next regeneration. Run \`fern-replay bootstrap --force\` to re-initialize tracking.`
+            );
+          }
           return { patches: [], revertedPatchIds: [] };
         }
         const exists2 = await this.git.commitExists(lastGen.commit_sha);
@@ -429117,20 +429356,15 @@ var require_dist24 = __commonJS({
             continue;
           }
           const parents = await this.git.getCommitParents(commit.sha);
-          let patchContent;
+          let filesOutput;
           try {
-            patchContent = await this.git.formatPatch(commit.sha);
+            filesOutput = await this.git.exec(["diff-tree", "--no-commit-id", "--name-only", "-r", commit.sha]);
           } catch {
             this.warnings.push(
               `Could not generate patch for commit ${commit.sha.slice(0, 7)} \u2014 it may be unreachable in a shallow clone. Skipping.`
             );
             continue;
           }
-          let contentHash = this.computeContentHash(patchContent);
-          if (lock.patches.find((p14) => p14.content_hash === contentHash) || forgottenHashes.has(contentHash)) {
-            continue;
-          }
-          const filesOutput = await this.git.exec(["diff-tree", "--no-commit-id", "--name-only", "-r", commit.sha]);
           const { files, sensitiveFiles, fernignoredFiles } = filterInfrastructureAndSensitiveFiles(
             filesOutput,
             this.fernignorePatterns
@@ -429145,19 +429379,31 @@ var require_dist24 = __commonJS({
               `.fernignore-protected file(s) excluded from patch for commit ${commit.sha.slice(0, 7)}: ${fernignoredFiles.join(", ")}. These files are managed by .fernignore, not Replay.`
             );
           }
-          if ((sensitiveFiles.length > 0 || fernignoredFiles.length > 0) && files.length > 0) {
-            const parentSha = parents[0];
-            if (parentSha) {
-              try {
-                patchContent = await this.git.exec(["diff", parentSha, commit.sha, "--", ...files]);
-              } catch {
-                continue;
-              }
-              if (!patchContent.trim()) continue;
-              contentHash = this.computeContentHash(patchContent);
+          if (files.length === 0) {
+            continue;
+          }
+          const wasFiltered = sensitiveFiles.length > 0 || fernignoredFiles.length > 0;
+          const parentSha = parents[0];
+          let patchContent;
+          if (wasFiltered && parentSha) {
+            try {
+              patchContent = await this.git.exec(["diff", parentSha, commit.sha, "--", ...files]);
+            } catch {
+              continue;
+            }
+            if (!patchContent.trim()) continue;
+          } else {
+            try {
+              patchContent = await this.git.formatPatch(commit.sha);
+            } catch {
+              this.warnings.push(
+                `Could not generate patch for commit ${commit.sha.slice(0, 7)} \u2014 it may be unreachable in a shallow clone. Skipping.`
+              );
+              continue;
             }
           }
-          if (files.length === 0) {
+          const contentHash = this.computeContentHash(patchContent);
+          if (lock.patches.find((p14) => p14.content_hash === contentHash) || forgottenHashes.has(contentHash)) {
             continue;
           }
           const theirsSnapshot = await capturePatchSnapshot(this.git, files, commit.sha);
@@ -429816,16 +430062,20 @@ var require_dist24 = __commonJS({
       const oursPath = (0, import_node_path310.join)(outputDir, resolvedPath);
       const ours = await (0, import_promises208.readFile)(oursPath, "utf-8").catch(() => null);
       let ghostTheirs = null;
-      if (!base4 && ours && !renameSourcePath) {
+      let baseTreeUnreachable = false;
+      if (!base4 && !renameSourcePath) {
         const treeReachable = await isTreeReachable(baseGen.tree_hash);
         if (!treeReachable) {
-          const fileDiff = extractFileDiff2(patch5.patch_content, filePath);
-          if (fileDiff) {
-            const { reconstructFromGhostPatch: reconstructFromGhostPatch2 } = await Promise.resolve().then(() => (init_HybridReconstruction(), HybridReconstruction_exports));
-            const result = reconstructFromGhostPatch2(fileDiff, ours);
-            if (result) {
-              base4 = result.base;
-              ghostTheirs = result.theirs;
+          baseTreeUnreachable = true;
+          if (ours) {
+            const fileDiff = extractFileDiff2(patch5.patch_content, filePath);
+            if (fileDiff) {
+              const { reconstructFromGhostPatch: reconstructFromGhostPatch2 } = await Promise.resolve().then(() => (init_HybridReconstruction(), HybridReconstruction_exports));
+              const result = reconstructFromGhostPatch2(fileDiff, ours);
+              if (result) {
+                base4 = result.base;
+                ghostTheirs = result.theirs;
+              }
             }
           }
         }
@@ -429837,7 +430087,11 @@ var require_dist24 = __commonJS({
         ours,
         oursPath,
         renameSourcePath,
-        ghostTheirs
+        ghostTheirs,
+        // Only meaningful when ghost reconstruction did NOT recover a base; if it
+        // did, `base` is non-null and the merge proceeds normally. We still set
+        // the flag truthfully (the tree IS unreachable) so Phase 3 can decide.
+        baseTreeUnreachable
       };
     }
     var CONFLICT_OPENER = "<<<<<<< Generated";
@@ -430016,7 +430270,11 @@ var require_dist24 = __commonJS({
         return { kind: "new-file-only-user", theirs: effective_theirs };
       }
       if (base4 == null && ours != null && effective_theirs != null && !useAccumulatorAsMergeBase) {
-        return { kind: "new-file-both", theirs: effective_theirs };
+        return {
+          kind: "new-file-both",
+          theirs: effective_theirs,
+          ...inputs.baseTreeUnreachable ? { baseTreeUnreachable: true } : {}
+        };
       }
       if (effective_theirs == null) {
         return { kind: "skipped", reason: "missing-content" };
@@ -430062,17 +430320,19 @@ var require_dist24 = __commonJS({
         const merged2 = threeWayMerge("", ours, plan.theirs);
         await (0, import_promises210.mkdir)((0, import_node_path44.dirname)(oursPath), { recursive: true });
         await (0, import_promises210.writeFile)(oursPath, merged2.content);
+        const unreachableFlag = plan.baseTreeUnreachable ? { baseTreeUnreachable: true } : {};
         if (merged2.hasConflicts) {
           return {
             file: resolvedPath,
             status: "conflict",
             conflicts: merged2.conflicts,
             conflictReason: "new-file-both",
-            conflictMetadata: metadata
+            conflictMetadata: metadata,
+            ...unreachableFlag
           };
         }
         accumulator.recordMerge(resolvedPath, merged2.content, patch5.base_generation);
-        return { file: resolvedPath, status: "merged" };
+        return { file: resolvedPath, status: "merged", ...unreachableFlag };
       }
       const merged = threeWayMerge(plan.mergeBase, ours, plan.theirs);
       await (0, import_promises210.mkdir)((0, import_node_path44.dirname)(oursPath), { recursive: true });
@@ -431272,6 +431532,7 @@ Patches absorbed by generator (${buckets.absorbed.length}):`;
           results = await this.service.applicator.applyPatches(newPatches);
           this.service._lastApplyResults = results;
           this.service.recordDroppedContextLineWarnings(results);
+          this.service.recordUnreachableBaseWarnings(results);
           this.service.revertConflictingFiles(results);
           for (const result of results) {
             if (result.status === "conflict") {
@@ -431425,6 +431686,7 @@ Patches absorbed by generator (${buckets.absorbed.length}):`;
         const results = await this.service.applicator.applyPatches(allPatches);
         this.service._lastApplyResults = results;
         this.service.recordDroppedContextLineWarnings(results);
+        this.service.recordUnreachableBaseWarnings(results);
         this.service.revertConflictingFiles(results);
         for (const result of results) {
           if (result.status === "conflict") {
@@ -432342,6 +432604,37 @@ If you want to keep these lines, restore them in a follow-up commit and re-run r
           }
         }
       }
+      /**
+       * After applyPatches(), surface a warning for each (patch × file) where a
+       * customization's BASE could not be read because the patch's
+       * base-generation tree is unreachable in this clone (shallow-clone window
+       * too small / pruned history). In that state the merge pipeline falls
+       * through to `new-file-both` and the customer's edit can be dropped with NO
+       * conflict and NO error — the INC-866 silent-loss class. This converts that
+       * silence into an explicit, actionable warning naming the file and the
+       * likely cause (insufficient clone window).
+       *
+       * Mirrors `recordDroppedContextLineWarnings`'s "surface, never silently
+       * drop" contract. De-duplicated per file path so a single insufficient
+       * window doesn't spam one warning per touched file repeatedly.
+       */
+      /** @internal Used by Flow implementations in `src/flows/`. */
+      recordUnreachableBaseWarnings(results) {
+        const warned2 = /* @__PURE__ */ new Set();
+        for (const result of results) {
+          if (!result.fileResults) continue;
+          for (const fr9 of result.fileResults) {
+            if (!fr9.baseTreeUnreachable) continue;
+            if (warned2.has(fr9.file)) continue;
+            warned2.add(fr9.file);
+            const base4 = fr9.conflictMetadata?.baseGeneration;
+            const baseRef = base4 ? ` (base generation ${base4.slice(0, 7)})` : "";
+            this.warnings.push(
+              `${fr9.file}: could not read the prior generation's version of this file${baseRef} because that generation's tree is outside the clone window (insufficient shallow-clone depth or pruned history). The customization was treated as a new file, which can drop your edits silently. Re-run with the prior generation in the clone window \u2014 e.g. \`git fetch --shallow-since=<date just before the prior [fern-generated] commit>\` or \`git fetch --unshallow\` \u2014 then re-run replay.`
+            );
+          }
+        }
+      }
       /**
        * After applyPatches(), strip conflict markers from conflicting files
        * so only clean content is committed. Keeps the Generated (OURS) side.
@@ -438844,10 +439137,6 @@ var require_PostGenerationPipeline = __commonJS({
           this.logger.warn(`Replay is not supported with GitHub ${config5.github.mode} mode. Disabling replay to prevent push to base branch.`);
           replayEnabled = false;
         }
-        if (autoVersionEnabled && !replayEnabled) {
-          this.logger.warn("AutoVersion requires Replay to be enabled. Disabling AutoVersion for this run.");
-          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));
         }
@@ -669270,7 +669559,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.46.0",
+          version: "5.46.1",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -669334,7 +669623,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.46.0",
+        version: "5.46.1",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -861072,7 +861361,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.46.0";
+  const version7 = "5.46.1";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -892164,7 +892453,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.46.0",
+        cliVersion: "5.46.1",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -916378,6 +916667,11 @@ var DynamicTypeInstantiationMapper = class {
       writer2.writeNode(collectionLiteral);
     }));
   }
+  // Materializes a literal value (e.g. a literal path parameter), as opposed to
+  // convert(), which treats literals as a no-op since they are usually omitted.
+  convertLiteral(literal3) {
+    return this.convertLiteralValue(literal3);
+  }
   convertLiteralValue(literal3) {
     switch (literal3.type) {
       case "boolean":
@@ -917749,9 +918043,10 @@ var EndpointSnippetGenerator3 = class {
       values: snippet2.pathParameters ?? {}
     });
     for (const parameter6 of pathParameters) {
+      const value2 = parameter6.typeReference.type === "literal" ? this.context.dynamicTypeInstantiationMapper.convertLiteral(parameter6.typeReference.value) : asPointer ? this.context.dynamicTypeInstantiationMapper.convertToPointerIfPossible(parameter6) : this.context.dynamicTypeInstantiationMapper.convert(parameter6);
       args.push({
         name: this.context.getTypeName(parameter6.name.name),
-        value: asPointer ? this.context.dynamicTypeInstantiationMapper.convertToPointerIfPossible(parameter6) : this.context.dynamicTypeInstantiationMapper.convert(parameter6)
+        value: value2
       });
     }
     return args;
@@ -957348,7 +957643,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.46.0"
+    cli_version: "5.46.1"
   };
 }
 function isAutomationMode() {
@@ -958174,7 +958469,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.46.0";
+    return "5.46.1";
   }
   getCliName() {
     if (false) {

package/package.json

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