@fern-api/generator-cli 0.9.23 → 0.9.24

package/dist/api.d.ts

@@ -582,6 +582,14 @@ interface ReplayRunResult {
     currentGenerationSha: string | null;
     /** SHA of main's HEAD before replay ran. Always on main's lineage, stable after squash merges. */
     baseBranchHead: string | null;
+    /** True when this run inlined `bootstrap()` to create the lockfile (auto-init from `fern generate`). */
+    autoBootstrapped: boolean;
+    /**
+     * True when the lockfile-missing branch was entered, regardless of bootstrap outcome.
+     * Distinct from `autoBootstrapped` (true only on success) — together they let telemetry
+     * distinguish "tried but no anchor / threw" from "lockfile already existed".
+     */
+    bootstrapAttempted: boolean;
     /**
      * Set when prepare or apply crashed (e.g. corrupted lockfile, git failure, library bug).
      * Distinguishes a real failure from "no replay initialized" (lockfile missing → null report, no failureReason).

package/dist/api.js

@@ -10247,7 +10247,7 @@ var import_replay4 = require("@fern-api/replay");
 var import_child_process3 = require("child_process");
 var import_fs3 = require("fs");
 var import_path5 = require("path");
-async function replayPrepare(params) {
+async function replayPrepare(params, state) {
   const {
     outputDir,
     cliVersion,
@@ -10258,8 +10258,36 @@ async function replayPrepare(params) {
     logger
   } = params;
   const lockfilePath = (0, import_path5.join)(outputDir, ".fern", "replay.lock");
+  let autoBootstrapped = false;
+  let bootstrapAttempted = false;
   if (!(0, import_fs3.existsSync)(lockfilePath)) {
-    return null;
+    if (process.env.FERN_DISABLE_AUTO_BOOTSTRAP === "true" || process.env.FERN_DISABLE_AUTO_BOOTSTRAP === "1") {
+      return null;
+    }
+    bootstrapAttempted = true;
+    if (state) {
+      state.bootstrapAttempted = true;
+    }
+    try {
+      const bootstrapResult = await (0, import_replay4.bootstrap)(outputDir, {
+        fernignoreAction: "skip",
+        force: false,
+        importHistory: false
+      });
+      if (bootstrapResult.generationCommit == null) {
+        return null;
+      }
+      autoBootstrapped = true;
+    } catch (error) {
+      logger?.warn("Replay auto-bootstrap failed, continuing without replay: " + String(error));
+      try {
+        if ((0, import_fs3.existsSync)(lockfilePath)) {
+          (0, import_fs3.unlinkSync)(lockfilePath);
+        }
+      } catch {
+      }
+      return null;
+    }
   }
   const baseBranchHead = gitRevParse(outputDir, "HEAD");
   let previousGenerationSha = null;
@@ -10339,7 +10367,9 @@ async function replayPrepare(params) {
     flow: preparation.flow,
     previousGenerationSha,
     currentGenerationSha: preparation.currentGenerationSha,
-    baseBranchHead
+    baseBranchHead,
+    autoBootstrapped,
+    bootstrapAttempted
   };
 }
 async function replayApply(prepared, params = {}) {
@@ -10355,6 +10385,8 @@ async function replayApply(prepared, params = {}) {
       previousGenerationSha: prepared.previousGenerationSha,
       currentGenerationSha: prepared.currentGenerationSha,
       baseBranchHead: prepared.baseBranchHead,
+      autoBootstrapped: prepared.autoBootstrapped,
+      bootstrapAttempted: prepared.bootstrapAttempted,
       failureReason: String(error)
     };
   }
@@ -10377,13 +10409,16 @@ async function replayApply(prepared, params = {}) {
     fernignoreUpdated,
     previousGenerationSha: prepared.previousGenerationSha,
     currentGenerationSha: prepared.currentGenerationSha,
-    baseBranchHead: resolvedBaseBranchHead
+    baseBranchHead: resolvedBaseBranchHead,
+    autoBootstrapped: prepared.autoBootstrapped,
+    bootstrapAttempted: prepared.bootstrapAttempted
   };
 }
 async function replayRun(params) {
+  const prepareState = { bootstrapAttempted: false };
   let prepared;
   try {
-    prepared = await replayPrepare(params);
+    prepared = await replayPrepare(params, prepareState);
   } catch (error) {
     return {
       report: null,
@@ -10391,6 +10426,8 @@ async function replayRun(params) {
       previousGenerationSha: null,
       currentGenerationSha: null,
       baseBranchHead: null,
+      autoBootstrapped: false,
+      bootstrapAttempted: prepareState.bootstrapAttempted,
       failureReason: error instanceof ReplayPrepareError ? error.reason : String(error)
     };
   }
@@ -10400,7 +10437,9 @@ async function replayRun(params) {
       fernignoreUpdated: false,
       previousGenerationSha: null,
       currentGenerationSha: null,
-      baseBranchHead: null
+      baseBranchHead: null,
+      autoBootstrapped: false,
+      bootstrapAttempted: prepareState.bootstrapAttempted
     };
   }
   return replayApply(prepared, { stageOnly: params.stageOnly, logger: params.logger });

package/dist/cli.js

@@ -39300,7 +39300,7 @@ init_dist3();
 var import_child_process4 = require("child_process");
 var import_fs12 = require("fs");
 var import_path17 = require("path");
-async function replayPrepare(params) {
+async function replayPrepare(params, state) {
   const {
     outputDir,
     cliVersion,
@@ -39311,8 +39311,36 @@ async function replayPrepare(params) {
     logger
   } = params;
   const lockfilePath = (0, import_path17.join)(outputDir, ".fern", "replay.lock");
+  let autoBootstrapped = false;
+  let bootstrapAttempted = false;
   if (!(0, import_fs12.existsSync)(lockfilePath)) {
-    return null;
+    if (process.env.FERN_DISABLE_AUTO_BOOTSTRAP === "true" || process.env.FERN_DISABLE_AUTO_BOOTSTRAP === "1") {
+      return null;
+    }
+    bootstrapAttempted = true;
+    if (state) {
+      state.bootstrapAttempted = true;
+    }
+    try {
+      const bootstrapResult = await bootstrap(outputDir, {
+        fernignoreAction: "skip",
+        force: false,
+        importHistory: false
+      });
+      if (bootstrapResult.generationCommit == null) {
+        return null;
+      }
+      autoBootstrapped = true;
+    } catch (error) {
+      logger?.warn("Replay auto-bootstrap failed, continuing without replay: " + String(error));
+      try {
+        if ((0, import_fs12.existsSync)(lockfilePath)) {
+          (0, import_fs12.unlinkSync)(lockfilePath);
+        }
+      } catch {
+      }
+      return null;
+    }
   }
   const baseBranchHead = gitRevParse(outputDir, "HEAD");
   let previousGenerationSha = null;
@@ -39392,7 +39420,9 @@ async function replayPrepare(params) {
     flow: preparation.flow,
     previousGenerationSha,
     currentGenerationSha: preparation.currentGenerationSha,
-    baseBranchHead
+    baseBranchHead,
+    autoBootstrapped,
+    bootstrapAttempted
   };
 }
 async function replayApply(prepared, params = {}) {
@@ -39408,6 +39438,8 @@ async function replayApply(prepared, params = {}) {
       previousGenerationSha: prepared.previousGenerationSha,
       currentGenerationSha: prepared.currentGenerationSha,
       baseBranchHead: prepared.baseBranchHead,
+      autoBootstrapped: prepared.autoBootstrapped,
+      bootstrapAttempted: prepared.bootstrapAttempted,
       failureReason: String(error)
     };
   }
@@ -39430,13 +39462,16 @@ async function replayApply(prepared, params = {}) {
     fernignoreUpdated,
     previousGenerationSha: prepared.previousGenerationSha,
     currentGenerationSha: prepared.currentGenerationSha,
-    baseBranchHead: resolvedBaseBranchHead
+    baseBranchHead: resolvedBaseBranchHead,
+    autoBootstrapped: prepared.autoBootstrapped,
+    bootstrapAttempted: prepared.bootstrapAttempted
   };
 }
 async function replayRun(params) {
+  const prepareState = { bootstrapAttempted: false };
   let prepared;
   try {
-    prepared = await replayPrepare(params);
+    prepared = await replayPrepare(params, prepareState);
   } catch (error) {
     return {
       report: null,
@@ -39444,6 +39479,8 @@ async function replayRun(params) {
       previousGenerationSha: null,
       currentGenerationSha: null,
       baseBranchHead: null,
+      autoBootstrapped: false,
+      bootstrapAttempted: prepareState.bootstrapAttempted,
       failureReason: error instanceof ReplayPrepareError ? error.reason : String(error)
     };
   }
@@ -39453,7 +39490,9 @@ async function replayRun(params) {
       fernignoreUpdated: false,
       previousGenerationSha: null,
       currentGenerationSha: null,
-      baseBranchHead: null
+      baseBranchHead: null,
+      autoBootstrapped: false,
+      bootstrapAttempted: prepareState.bootstrapAttempted
     };
   }
   return replayApply(prepared, { stageOnly: params.stageOnly, logger: params.logger });
@@ -40646,7 +40685,12 @@ var AutoVersionStep = class extends BaseStep {
   async handleNormalFlow(params) {
     const { prepared, service, language, mappedMagicVersion, previousGenerationSha } = params;
     const rawDiff = this.gitDiff(previousGenerationSha, prepared.currentGenerationSha);
-    const previousVersion = await this.resolvePreviousVersion({ service, rawDiff, mappedMagicVersion });
+    const previousVersion = await this.resolvePreviousVersion({
+      service,
+      rawDiff,
+      mappedMagicVersion,
+      baseVersion: this.config.baseVersion
+    });
     if (previousVersion == null) {
       return await this.handleFirstGeneration({ service, language, mappedMagicVersion });
     }
@@ -40783,7 +40827,11 @@ var AutoVersionStep = class extends BaseStep {
     };
   }
   async resolvePreviousVersion(params) {
-    const { service, rawDiff, mappedMagicVersion } = params;
+    const { service, rawDiff, mappedMagicVersion, baseVersion } = params;
+    if (baseVersion != null && isValidSemver(baseVersion)) {
+      this.logger.debug(`AutoVersionStep: previous version from pipeline baseVersion: ${baseVersion}`);
+      return this.normalizeVersionPrefix(baseVersion, mappedMagicVersion);
+    }
     try {
       const extracted = service.extractPreviousVersion(rawDiff, mappedMagicVersion);
       if (extracted != null) {
@@ -41037,16 +41085,20 @@ var GenerationCommitStep = class extends BaseStep {
   name = "generationCommit";
   async execute(_context) {
     const headBeforePrepare = tryRevParse(this.outputDir, "HEAD");
+    const prepareState = { bootstrapAttempted: false };
     let prepared;
     try {
-      prepared = await replayPrepare({
-        outputDir: this.outputDir,
-        cliVersion: this.cliVersion,
-        generatorVersions: this.generatorVersions,
-        generatorName: this.generatorName,
-        skipApplication: this.config.skipApplication,
-        logger: this.logger
-      });
+      prepared = await replayPrepare(
+        {
+          outputDir: this.outputDir,
+          cliVersion: this.cliVersion,
+          generatorVersions: this.generatorVersions,
+          generatorName: this.generatorName,
+          skipApplication: this.config.skipApplication,
+          logger: this.logger
+        },
+        prepareState
+      );
     } catch (error) {
       const reason = error instanceof ReplayPrepareError ? error.reason : String(error);
       if (headBeforePrepare != null) {
@@ -41062,14 +41114,16 @@ var GenerationCommitStep = class extends BaseStep {
         executed: true,
         success: true,
         errorMessage: reason,
-        preparedReplay: null
+        preparedReplay: null,
+        bootstrapAttempted: prepareState.bootstrapAttempted
       };
     }
     if (prepared == null) {
       return {
         executed: true,
         success: true,
-        preparedReplay: null
+        preparedReplay: null,
+        bootstrapAttempted: prepareState.bootstrapAttempted
       };
     }
     return {
@@ -41079,7 +41133,8 @@ var GenerationCommitStep = class extends BaseStep {
       previousGenerationSha: prepared.previousGenerationSha ?? void 0,
       currentGenerationSha: prepared.currentGenerationSha,
       baseBranchHead: prepared.baseBranchHead ?? void 0,
-      flow: prepared.flow
+      flow: prepared.flow,
+      bootstrapAttempted: prepareState.bootstrapAttempted
     };
   }
 };
@@ -41830,6 +41885,8 @@ var ReplayStep = class extends BaseStep {
         success: true,
         replayCrashed: true,
         errorMessage: generationCommit.errorMessage,
+        autoBootstrapped: false,
+        bootstrapAttempted: generationCommit.bootstrapAttempted === true,
         flow: "normal-regeneration",
         patchesDetected: 0,
         patchesApplied: 0,
@@ -41840,6 +41897,8 @@ var ReplayStep = class extends BaseStep {
       return {
         executed: true,
         success: true,
+        autoBootstrapped: false,
+        bootstrapAttempted: generationCommit.bootstrapAttempted === true,
         flow: "first-generation",
         patchesDetected: 0,
         patchesApplied: 0,
@@ -41867,6 +41926,8 @@ var ReplayStep = class extends BaseStep {
         previousGenerationSha: result.previousGenerationSha ?? void 0,
         currentGenerationSha: result.currentGenerationSha ?? void 0,
         baseBranchHead: result.baseBranchHead ?? void 0,
+        autoBootstrapped: result.autoBootstrapped,
+        bootstrapAttempted: result.bootstrapAttempted,
         flow: "normal-regeneration",
         patchesDetected: 0,
         patchesApplied: 0,
@@ -41880,6 +41941,8 @@ var ReplayStep = class extends BaseStep {
         previousGenerationSha: result.previousGenerationSha ?? void 0,
         currentGenerationSha: result.currentGenerationSha ?? void 0,
         baseBranchHead: result.baseBranchHead ?? void 0,
+        autoBootstrapped: result.autoBootstrapped,
+        bootstrapAttempted: result.bootstrapAttempted,
         flow: "first-generation",
         patchesDetected: 0,
         patchesApplied: 0,
@@ -41893,6 +41956,8 @@ var ReplayStep = class extends BaseStep {
       previousGenerationSha: result.previousGenerationSha ?? void 0,
       currentGenerationSha: result.currentGenerationSha ?? void 0,
       baseBranchHead: result.baseBranchHead ?? void 0,
+      autoBootstrapped: result.autoBootstrapped,
+      bootstrapAttempted: result.bootstrapAttempted,
       flow: report.flow,
       patchesDetected: report.patchesDetected,
       patchesApplied: report.patchesApplied,

package/package.json

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