@fern-api/fern-api-dev 5.23.3-661-g00511f12e23 → 5.23.3-664-g6ef41bc5988

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,
@@ -438844,10 +439056,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 +669478,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.23.3-661-g00511f12e23",
+          version: "5.23.3-664-g6ef41bc5988",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -669334,7 +669542,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.23.3-661-g00511f12e23",
+        version: "5.23.3-664-g6ef41bc5988",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -861072,7 +861280,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.23.3-661-g00511f12e23";
+  const version7 = "5.23.3-664-g6ef41bc5988";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -892164,7 +892372,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.23.3-661-g00511f12e23",
+        cliVersion: "5.23.3-664-g6ef41bc5988",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -957354,7 +957562,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.23.3-661-g00511f12e23"
+    cli_version: "5.23.3-664-g6ef41bc5988"
   };
 }
 function isAutomationMode() {
@@ -958180,7 +958388,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.23.3-661-g00511f12e23";
+    return "5.23.3-664-g6ef41bc5988";
   }
   getCliName() {
     if (false) {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "5.23.3-661-g00511f12e23",
+  "version": "5.23.3-664-g6ef41bc5988",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",