@fern-api/fern-api-dev 5.45.3 → 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}.`);
@@ -422248,15 +422248,19 @@ var require_AutoVersionStep = __commonJS({
             analysis: { versionBump: "PATCH", message: this.brandMessage("SDK regeneration") }
           });
         }
-        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: split diff into ${chunks.length} chunks` + (skippedChunks > 0 ? ` (capped at ${index_1.MAX_CHUNKS}, skipping ${skippedChunks})` : ""));
-        }
         let analysis;
         try {
-          analysis = cappedChunks.length <= 1 ? await this.analyzeSingle(cleanedDiff, language, previousVersion) : await this.analyzeChunks(cappedChunks, language, previousVersion);
+          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: 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: FAI analysis failed (${String(error50)}); falling back to PATCH bump.`);
           analysis = { versionBump: "PATCH", message: this.brandMessage("SDK regeneration") };
@@ -422279,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
@@ -422336,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)) {
@@ -422385,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,
@@ -422518,6 +422734,47 @@ ${newBlock}${remainder}`;
           };
         }
       }
+      /**
+       * Calls the hosted FAI service (`/sdks/analyze-commit-diff`) with the fern token.
+       * Used when no BAML `ai` config is supplied (remote generation via fiddle). FAI
+       * handles chunking, parallelism, and retries server-side. Returns null on
+       * NO_CHANGE; throws on transport/HTTP errors so the caller's PATCH fallback applies.
+       */
+      async analyzeViaFaiService(cleanedDiff, language, previousVersion) {
+        const baseUrl = this.config.faiBaseUrl ?? "https://fai.buildwithfern.com";
+        const response = await fetch(`${baseUrl}/sdks/analyze-commit-diff`, {
+          method: "POST",
+          headers: {
+            Authorization: `Bearer ${this.config.fernToken}`,
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify({
+            diff: cleanedDiff,
+            language,
+            previous_version: previousVersion,
+            prior_changelog: this.config.priorChangelog ?? void 0,
+            spec_commit_message: this.config.specCommitMessage ?? void 0
+          })
+        });
+        if (!response.ok) {
+          const body = await response.text().catch(() => "");
+          throw new Error(`FAI analyze-commit-diff failed with status ${response.status}: ${body.slice(0, 500)}`);
+        }
+        const parsed = await response.json();
+        if (!isFaiAnalyzeResponse(parsed)) {
+          throw new Error("FAI analyze-commit-diff returned an unexpected response shape");
+        }
+        if (parsed.version_bump === "NO_CHANGE") {
+          return null;
+        }
+        return {
+          versionBump: parsed.version_bump,
+          message: this.brandMessage(parsed.message),
+          changelogEntry: nonEmpty2(parsed.changelog_entry),
+          prDescription: nonEmpty2(parsed.pr_description),
+          versionBumpReason: nonEmpty2(parsed.version_bump_reason)
+        };
+      }
       /**
        * Dynamically imports @fern-api/cli-ai only when autoversion actually needs to
        * call FAI. The package is ESM-only with extensionless internal imports, so
@@ -422560,6 +422817,20 @@ ${newBlock}${remainder}`;
       }
     };
     exports2.AutoVersionStep = AutoVersionStep;
+    var FAI_VERSION_BUMPS = ["MAJOR", "MINOR", "PATCH", "NO_CHANGE"];
+    function isFaiAnalyzeResponse(value2) {
+      if (typeof value2 !== "object" || value2 == null) {
+        return false;
+      }
+      const candidate = value2;
+      return typeof candidate.message === "string" && typeof candidate.version_bump === "string" && FAI_VERSION_BUMPS.includes(candidate.version_bump) && isStringOrAbsent(candidate.changelog_entry) && isStringOrAbsent(candidate.pr_description) && isStringOrAbsent(candidate.version_bump_reason);
+    }
+    function isStringOrAbsent(value2) {
+      return value2 == null || typeof value2 === "string";
+    }
+    function nonEmpty2(value2) {
+      return value2 != null && value2.trim().length > 0 ? value2 : void 0;
+    }
   }
 });
 
@@ -428061,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;
@@ -428117,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);
@@ -428900,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;
@@ -429000,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() {
@@ -429011,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);
@@ -429058,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
@@ -429086,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);
@@ -429757,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;
+              }
             }
           }
         }
@@ -429778,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";
@@ -429957,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" };
@@ -430003,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 });
@@ -431213,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") {
@@ -431366,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") {
@@ -432283,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.
@@ -438785,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));
         }
@@ -669211,7 +669559,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.45.3",
+          version: "5.46.1",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -669275,7 +669623,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.45.3",
+        version: "5.46.1",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -856646,7 +856994,7 @@ function createDocsConfigFileAstVisitorForRules({ relativeFilepath, allRulesWith
           const ruleViolations = await visitFromRule(node4);
           const severityOverride = severityOverrides?.get(ruleName);
           addViolations(ruleViolations.map((violation) => ({
-            name: violation.name,
+            name: violation.name ?? ruleName,
             severity: severityOverride ?? violation.severity,
             relativeFilepath: violation.relativeFilepath ?? RelativeFilePath2.of(""),
             nodePath: violation.nodePath ?? nodePath,
@@ -861013,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.45.3";
+  const version7 = "5.46.1";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -892105,7 +892453,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.45.3",
+        cliVersion: "5.46.1",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -916319,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":
@@ -917533,13 +917886,16 @@ var EndpointSnippetGenerator3 = class {
   }
   getBytesBodyRequestArg({ value: value2 }) {
     const bytesValue = typeof value2 === "string" ? value2 : "";
-    return go_exports.TypeInstantiation.reference(go_exports.invokeFunc({
-      func: go_exports.typeReference({
-        name: "NewReader",
-        importPath: "bytes"
-      }),
-      arguments_: [go_exports.TypeInstantiation.bytes(bytesValue)]
-    }));
+    if (this.context.customConfig?.useReaderForBytesRequest ?? true) {
+      return go_exports.TypeInstantiation.reference(go_exports.invokeFunc({
+        func: go_exports.typeReference({
+          name: "NewReader",
+          importPath: "bytes"
+        }),
+        arguments_: [go_exports.TypeInstantiation.bytes(bytesValue)]
+      }));
+    }
+    return go_exports.TypeInstantiation.bytes(bytesValue);
   }
   getMethodArgsForInlinedRequest({ request: request7, snippet: snippet2 }) {
     const otherArgs = [];
@@ -917659,7 +918015,7 @@ var EndpointSnippetGenerator3 = class {
   getReferencedRequestBodyPropertyTypeInstantiation({ body, value: value2 }) {
     switch (body.type) {
       case "bytes":
-        return this.getBytesBodyRequestArg({ value: value2 });
+        return go_exports.TypeInstantiation.bytes(typeof value2 === "string" ? value2 : "");
       case "typeReference":
         return this.context.dynamicTypeInstantiationMapper.convert({ typeReference: body.value, value: value2 });
       default:
@@ -917687,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;
@@ -943539,13 +943896,19 @@ function getGithubPublishConfig(githubPublishInfo) {
         secretKeyEnvironmentVariable: (0, import_api50.EnvironmentVariable)(value2.signature.secretKey ?? "")
       } : void 0
     }),
-    pypi: (value2) => import_generator_exec_sdk.FernGeneratorExec.GithubPublishInfo.pypi({
-      registryUrl: value2.registryUrl,
-      packageName: value2.packageName,
-      usernameEnvironmentVariable: (0, import_api50.EnvironmentVariable)("PYPI_USERNAME"),
-      passwordEnvironmentVariable: (0, import_api50.EnvironmentVariable)("PYPI_PASSWORD"),
-      pypiMetadata: value2.pypiMetadata
-    }),
+    pypi: (value2) => {
+      const password = (value2.credentials?.password ?? "").trim();
+      const useOidc = password === "<USE_OIDC>" || password === "OIDC";
+      const hasCredentials = value2.credentials != null;
+      return import_generator_exec_sdk.FernGeneratorExec.GithubPublishInfo.pypi({
+        registryUrl: value2.registryUrl,
+        packageName: value2.packageName,
+        usernameEnvironmentVariable: (0, import_api50.EnvironmentVariable)("PYPI_USERNAME"),
+        passwordEnvironmentVariable: (0, import_api50.EnvironmentVariable)(useOidc ? "OIDC" : "PYPI_PASSWORD"),
+        shouldGeneratePublishWorkflow: useOidc || hasCredentials,
+        pypiMetadata: value2.pypiMetadata
+      });
+    },
     rubygems: (value2) => import_generator_exec_sdk.FernGeneratorExec.GithubPublishInfo.rubygems({
       registryUrl: value2.registryUrl,
       packageName: value2.packageName,
@@ -943667,10 +944030,11 @@ function getGeneratorConfig({ generatorInvocation, customConfig, workspaceName,
       });
     }
   });
+  const publishConfig = getPublishConfigForGithubOidc(generatorInvocation, outputVersion);
   return {
     irFilepath: irPath,
     output: output2,
-    publish: void 0,
+    publish: publishConfig,
     customConfig,
     workspaceName,
     organization,
@@ -943861,6 +944225,42 @@ function getPublishTargetFromPublishModeV2(mode) {
     _other: () => void 0
   });
 }
+function getPublishConfigForGithubOidc(generatorInvocation, version7) {
+  const publishInfo = generatorInvocation.outputMode._visit({
+    publish: () => void 0,
+    publishV2: () => void 0,
+    downloadFiles: () => void 0,
+    github: (value2) => value2.publishInfo,
+    githubV2: (value2) => value2._visit({
+      push: (v9) => v9.publishInfo,
+      commitAndRelease: (v9) => v9.publishInfo,
+      pullRequest: (v9) => v9.publishInfo,
+      _other: () => void 0
+    }),
+    _other: () => void 0
+  });
+  if (publishInfo == null || publishInfo.type !== "pypi") {
+    return void 0;
+  }
+  const password = (publishInfo.credentials?.password ?? "").trim();
+  if (password !== "OIDC" && password !== "<USE_OIDC>") {
+    return void 0;
+  }
+  const registriesV2 = structuredClone(emptyRegistriesConfigV2);
+  registriesV2.pypi = {
+    registryUrl: publishInfo.registryUrl,
+    username: "__token__",
+    password: "OIDC",
+    packageName: publishInfo.packageName,
+    pypiMetadata: publishInfo.pypiMetadata
+  };
+  return {
+    registries: structuredClone(emptyRegistriesConfig),
+    registriesV2,
+    publishTarget: void 0,
+    version: version7
+  };
+}
 var emptyRegistriesConfig = {
   maven: { registryUrl: "", username: "", password: "", group: "", signature: void 0 },
   npm: { registryUrl: "", token: "", scope: "" }
@@ -944444,7 +944844,7 @@ var LocalTaskHandler = class {
     const absolutePathToFernignore = AbsoluteFilePath2.of(join8(this.absolutePathToLocalOutput, RelativeFilePath2.of(FERNIGNORE_FILENAME)));
     const fernIgnorePaths = await getFernIgnorePaths({ absolutePathToFernignore });
     const pathsToPreserve = await this.getPathsToPreserve(fernIgnorePaths);
-    await (0, import_promises129.cp)(this.absolutePathToLocalOutput, tmpOutputResolutionDir, { recursive: true });
+    await (0, import_promises129.cp)(this.absolutePathToLocalOutput, tmpOutputResolutionDir, { recursive: true, verbatimSymlinks: true });
     await this.runThrowawayGitCommand(["init"], tmpOutputResolutionDir);
     await this.runThrowawayGitCommand(["config", "gc.auto", "0"], tmpOutputResolutionDir);
     await this.runThrowawayGitCommand(["add", "."], tmpOutputResolutionDir);
@@ -944472,7 +944872,7 @@ var LocalTaskHandler = class {
       retryDelay: 100
     });
     await (0, import_promises129.rm)(this.absolutePathToLocalOutput, { recursive: true });
-    await (0, import_promises129.cp)(tmpOutputResolutionDir, this.absolutePathToLocalOutput, { recursive: true });
+    await (0, import_promises129.cp)(tmpOutputResolutionDir, this.absolutePathToLocalOutput, { recursive: true, verbatimSymlinks: true });
   }
   async copyGeneratedFilesNoFernIgnorePreservingGit() {
     const contents = await (0, import_promises129.readdir)(this.absolutePathToLocalOutput);
@@ -944500,10 +944900,10 @@ var LocalTaskHandler = class {
     if (firstLocalOutputItem.endsWith(".zip")) {
       await (0, import_decompress2.default)(join8(this.absolutePathToTmpOutputDirectory, RelativeFilePath2.of(firstLocalOutputItem)), outputPath);
       for (const localOutputItem of remaininglocalOutputItems) {
-        await (0, import_promises129.cp)(join8(this.absolutePathToTmpOutputDirectory, RelativeFilePath2.of(localOutputItem)), join8(outputPath, RelativeFilePath2.of(localOutputItem)), { recursive: true });
+        await (0, import_promises129.cp)(join8(this.absolutePathToTmpOutputDirectory, RelativeFilePath2.of(localOutputItem)), join8(outputPath, RelativeFilePath2.of(localOutputItem)), { recursive: true, verbatimSymlinks: true });
       }
     } else {
-      await (0, import_promises129.cp)(this.absolutePathToTmpOutputDirectory, outputPath, { recursive: true });
+      await (0, import_promises129.cp)(this.absolutePathToTmpOutputDirectory, outputPath, { recursive: true, verbatimSymlinks: true });
     }
   }
   async copySnippetJSON({ absolutePathToTmpSnippetJSON, absolutePathToLocalSnippetJSON }) {
@@ -957243,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.45.3"
+    cli_version: "5.46.1"
   };
 }
 function isAutomationMode() {
@@ -958069,7 +958469,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.45.3";
+    return "5.46.1";
   }
   getCliName() {
     if (false) {
@@ -972785,101 +973185,132 @@ async function validateWorkspaces({
   const apiResults = [];
   let docsResult;
   let hasAnyErrors = false;
+  let abortReason;
   const apiWorkspacesToValidate = commandLineApiWorkspace != null ? project.apiWorkspaces.filter((workspace) => workspace.workspaceName === commandLineApiWorkspace) : project.apiWorkspaces;
-  const docsWorkspace = project.docsWorkspaces;
-  if (docsWorkspace != null) {
-    const excludeRules = brokenLinks || errorOnBrokenLinks ? [] : ["valid-markdown-links"];
-    const ossWorkspaces = await filterOssWorkspaces(project);
-    let collected;
-    await cliContext.runTaskForWorkspace(docsWorkspace, async (context3) => {
-      collected = await collectDocsWorkspaceViolations({
-        workspace: docsWorkspace,
-        context: context3,
-        apiWorkspaces: project.apiWorkspaces,
-        ossWorkspaces,
-        errorOnBrokenLinks,
-        excludeRules
-      });
-    });
-    if (collected != null) {
-      docsResult = {
-        violations: collected.violations,
-        elapsedMillis: collected.elapsedMillis
-      };
-      if (collected.hasErrors) {
-        hasAnyErrors = true;
-      }
-    }
-  }
-  await Promise.all(
-    apiWorkspacesToValidate.map(async (workspace) => {
-      if (workspace.generatorsConfiguration?.groups.length === 0 && workspace.type !== "fern") {
-        return;
-      }
-      if (workspace instanceof OSSWorkspace && directFromOpenapi) {
-        await cliContext.runTaskForWorkspace(workspace, async (context3) => {
-          await workspace.getIntermediateRepresentation({
-            context: context3,
-            audiences: { type: "all" },
-            enableUniqueErrorsPerEndpoint: false,
-            generateV1Examples: false,
-            logWarnings
-          });
-        });
-        return;
-      }
-      if (workspace instanceof LazyFernWorkspace) {
-        const absolutePathToApiYml = join8(
-          workspace.absoluteFilePath,
-          RelativeFilePath2.of(DEFINITION_DIRECTORY),
-          RelativeFilePath2.of(ROOT_API_FILENAME)
-        );
-        const apiYmlExists = await doesPathExist(absolutePathToApiYml);
-        if (!apiYmlExists) {
-          await cliContext.runTask(async (context3) => {
-            context3.logger.error(`Missing file: ${ROOT_API_FILENAME}`);
-            return context3.failAndThrow(void 0, void 0, { code: CliError.Code.ValidationError });
-          });
-          return;
-        }
-      }
+  let hasErrors = false;
+  try {
+    const docsWorkspace = project.docsWorkspaces;
+    if (docsWorkspace != null) {
+      const excludeRules = brokenLinks || errorOnBrokenLinks ? [] : ["valid-markdown-links"];
+      const ossWorkspaces = await filterOssWorkspaces(project);
       let collected;
-      await cliContext.runTaskForWorkspace(workspace, async (context3) => {
-        const fernWorkspace = await workspace.toFernWorkspace({ context: context3 });
-        collected = await collectAPIWorkspaceViolations({
-          workspace: fernWorkspace,
+      await cliContext.runTaskForWorkspace(docsWorkspace, async (context3) => {
+        collected = await collectDocsWorkspaceViolations({
+          workspace: docsWorkspace,
           context: context3,
-          ossWorkspace: workspace instanceof OSSWorkspace ? workspace : void 0
+          apiWorkspaces: project.apiWorkspaces,
+          ossWorkspaces,
+          errorOnBrokenLinks,
+          excludeRules
         });
       });
       if (collected != null) {
-        apiResults.push({
-          apiName: collected.apiName,
+        docsResult = {
           violations: collected.violations,
           elapsedMillis: collected.elapsedMillis
-        });
+        };
         if (collected.hasErrors) {
           hasAnyErrors = true;
         }
       }
-    })
-  );
-  const { hasErrors } = await cliContext.runTask((context3) => {
-    return printCheckReport({
-      apiResults,
-      docsResult,
-      logWarnings,
-      context: context3
-    });
-  });
-  if (cliContext.isJsonMode) {
-    const showApiNames = apiResults.length > 1;
-    cliContext.writeJsonToStdout(
-      buildCheckJsonResult({ apiResults, docsResult, hasErrors: hasErrors || hasAnyErrors, showApiNames })
+    }
+    await Promise.all(
+      apiWorkspacesToValidate.map(async (workspace) => {
+        if (workspace.generatorsConfiguration?.groups.length === 0 && workspace.type !== "fern") {
+          return;
+        }
+        if (workspace instanceof OSSWorkspace && directFromOpenapi) {
+          await cliContext.runTaskForWorkspace(workspace, async (context3) => {
+            await workspace.getIntermediateRepresentation({
+              context: context3,
+              audiences: { type: "all" },
+              enableUniqueErrorsPerEndpoint: false,
+              generateV1Examples: false,
+              logWarnings
+            });
+          });
+          return;
+        }
+        if (workspace instanceof LazyFernWorkspace) {
+          const absolutePathToApiYml = join8(
+            workspace.absoluteFilePath,
+            RelativeFilePath2.of(DEFINITION_DIRECTORY),
+            RelativeFilePath2.of(ROOT_API_FILENAME)
+          );
+          const apiYmlExists = await doesPathExist(absolutePathToApiYml);
+          if (!apiYmlExists) {
+            abortReason = "missing api.yml";
+            await cliContext.runTask(async (context3) => {
+              context3.logger.error(`Missing file: ${ROOT_API_FILENAME}`);
+              return context3.failAndThrow(void 0, void 0, {
+                code: CliError.Code.ValidationError
+              });
+            });
+            return;
+          }
+        }
+        let collected;
+        await cliContext.runTaskForWorkspace(workspace, async (context3) => {
+          const fernWorkspace = await workspace.toFernWorkspace({ context: context3 });
+          collected = await collectAPIWorkspaceViolations({
+            workspace: fernWorkspace,
+            context: context3,
+            ossWorkspace: workspace instanceof OSSWorkspace ? workspace : void 0
+          });
+        });
+        if (collected != null) {
+          apiResults.push({
+            apiName: collected.apiName,
+            violations: collected.violations,
+            elapsedMillis: collected.elapsedMillis
+          });
+          if (collected.hasErrors) {
+            hasAnyErrors = true;
+          }
+        }
+      })
     );
-  }
-  if (hasErrors || hasAnyErrors) {
-    cliContext.failAndThrow(void 0, void 0, { code: CliError.Code.ValidationError });
+    const reportResult = await cliContext.runTask((context3) => {
+      return printCheckReport({
+        apiResults,
+        docsResult,
+        logWarnings,
+        context: context3
+      });
+    });
+    hasErrors = reportResult.hasErrors;
+    if (cliContext.isJsonMode) {
+      const showApiNames = apiResults.length > 1;
+      cliContext.writeJsonToStdout(
+        buildCheckJsonResult({ apiResults, docsResult, hasErrors: hasErrors || hasAnyErrors, showApiNames })
+      );
+    }
+    if (hasErrors || hasAnyErrors) {
+      abortReason = "validation errors";
+      cliContext.failAndThrow(void 0, void 0, { code: CliError.Code.ValidationError });
+    }
+  } catch (error50) {
+    if (abortReason == null) {
+      abortReason = error50 instanceof Error ? error50.message.slice(0, 100) : "unexpected error";
+    }
+    throw error50;
+  } finally {
+    const allViolations = [...apiResults.flatMap((r5) => r5.violations), ...docsResult?.violations ?? []];
+    const firedRules = [
+      ...new Set(allViolations.map((v9) => v9.name).filter((name2) => name2 != null))
+    ];
+    const numErrors = allViolations.filter((v9) => v9.severity === "fatal" || v9.severity === "error").length;
+    const numWarnings = allViolations.filter((v9) => v9.severity === "warning").length;
+    cliContext.instrumentPostHogEvent({
+      command: "fern check",
+      properties: {
+        validationRules: firedRules,
+        numErrors,
+        numWarnings,
+        passed: !hasErrors && !hasAnyErrors,
+        abortReason
+      }
+    });
   }
 }
 
@@ -974233,24 +974664,46 @@ function addValidateCommand(cli, cliContext) {
       default: false
     }),
     async (argv) => {
-      const project = await loadProjectAndRegisterWorkspacesWithContext(cliContext, {
-        commandLineApiWorkspace: void 0,
-        defaultToAllApiWorkspaces: true
-      });
-      if (argv.api != null && !project.apiWorkspaces.some((ws5) => ws5.workspaceName === argv.api)) {
-        cliContext.failAndThrow(`API does not exist: ${argv.api}`, void 0, {
-          code: CliError.Code.ConfigError
+      let project;
+      try {
+        project = await loadProjectAndRegisterWorkspacesWithContext(cliContext, {
+          commandLineApiWorkspace: void 0,
+          defaultToAllApiWorkspaces: true
         });
+        if (argv.api != null && !project.apiWorkspaces.some((ws5) => ws5.workspaceName === argv.api)) {
+          cliContext.instrumentPostHogEvent({
+            command: "fern check",
+            properties: {
+              passed: false,
+              abortReason: `API does not exist: ${argv.api}`
+            }
+          });
+          cliContext.failAndThrow(`API does not exist: ${argv.api}`, void 0, {
+            code: CliError.Code.ConfigError
+          });
+        }
+        await validateWorkspaces({
+          project,
+          cliContext,
+          logWarnings: argv.warnings,
+          brokenLinks: argv.brokenLinks,
+          errorOnBrokenLinks: argv.strictBrokenLinks,
+          directFromOpenapi: argv.fromOpenapi,
+          commandLineApiWorkspace: argv.api
+        });
+      } catch (error50) {
+        if (project == null) {
+          const reason = error50 instanceof Error ? error50.message.slice(0, 100) : "project load failed";
+          cliContext.instrumentPostHogEvent({
+            command: "fern check",
+            properties: {
+              passed: false,
+              abortReason: reason
+            }
+          });
+        }
+        throw error50;
       }
-      await validateWorkspaces({
-        project,
-        cliContext,
-        logWarnings: argv.warnings,
-        brokenLinks: argv.brokenLinks,
-        errorOnBrokenLinks: argv.strictBrokenLinks,
-        directFromOpenapi: argv.fromOpenapi,
-        commandLineApiWorkspace: argv.api
-      });
     }
   );
 }

package/package.json

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