@fern-api/fern-api-dev 5.70.0 → 5.70.2

package/cli.cjs

@@ -100196,8 +100196,8 @@ var require_graceful_fs = __commonJS({
         }
       }
       var fs$writeFile = fs35.writeFile;
-      fs35.writeFile = writeFile101;
-      function writeFile101(path120, data2, options2, cb) {
+      fs35.writeFile = writeFile102;
+      function writeFile102(path120, data2, options2, cb) {
         if (typeof options2 === "function")
           cb = options2, options2 = null;
         return go$writeFile(path120, data2, options2, cb);
@@ -167522,6 +167522,20 @@ function detectMultipleBaseUrls(servers1, servers2) {
   }
   return allMatch && allDifferent;
 }
+function dedupeServers(servers) {
+  const seen = /* @__PURE__ */ new Set();
+  return servers.filter((server) => {
+    if (server.type === "grouped") {
+      return true;
+    }
+    const key2 = `${getEnvironmentName2(server)}\0${server.url}`;
+    if (seen.has(key2)) {
+      return false;
+    }
+    seen.add(key2);
+    return true;
+  });
+}
 function getPreferredUrlForNameExtraction(server) {
   return server.defaultUrl ?? server.url;
 }
@@ -167737,7 +167751,7 @@ function merge6(ir1, ir22, options2) {
     description: ir1.description ?? ir22.description,
     basePath: ir1.basePath ?? ir22.basePath,
     basePathParameters: ir1.basePathParameters ?? ir22.basePathParameters,
-    servers: [...ir1.servers, ...ir22.servers],
+    servers: dedupeServers([...ir1.servers, ...ir22.servers]),
     websocketServers: [...ir1.websocketServers, ...ir22.websocketServers],
     tags: {
       tagsById: {
@@ -457164,13 +457178,13 @@ async function removeInvalidAiExamples({ sourceFilePath, context: context3 }) {
         }
       }
     }
-    const { writeFile: writeFile101 } = await import("fs/promises");
+    const { writeFile: writeFile102 } = await import("fs/promises");
     const yamlContent = index_vite_proxy_tmp_default.dump(parsed, {
       indent: 2,
       lineWidth: -1,
       noRefs: true
     });
-    await writeFile101(overrideFilePath, yamlContent, "utf-8");
+    await writeFile102(overrideFilePath, yamlContent, "utf-8");
     context3.logger.info(`Removed ${validationResult.invalidCount} invalid AI examples from ai_examples_override.yml`);
     return {
       removedCount: validationResult.invalidCount,
@@ -480472,8 +480486,8 @@ var require_graceful_fs2 = __commonJS({
         }
       }
       var fs$writeFile = fs35.writeFile;
-      fs35.writeFile = writeFile101;
-      function writeFile101(path120, data2, options2, cb) {
+      fs35.writeFile = writeFile102;
+      function writeFile102(path120, data2, options2, cb) {
         if (typeof options2 === "function")
           cb = options2, options2 = null;
         return go$writeFile(path120, data2, options2, cb);
@@ -564690,7 +564704,8 @@ var require_AutoVersioningService = __commonJS({
         }
         await this.addSuffixToGoMod(goModPath, modulePath, suffix);
         await this.addSuffixToGoFiles(workingDirectory, modulePath, suffix);
-        this.logger.info(`Added ${suffix} to Go module path ${modulePath} and all import paths`);
+        await this.addSuffixToMarkdownFiles(workingDirectory, modulePath, suffix);
+        this.logger.info(`Added ${suffix} to Go module path ${modulePath} across imports, headers, and docs`);
       }
       /**
        * Extracts the major version number from a version string.
@@ -564771,15 +564786,16 @@ var require_AutoVersioningService = __commonJS({
         return results;
       }
       /**
-       * Adds a version suffix to import paths in all .go files in the repository.
+       * Adds a version suffix to import paths and embedded module-path string
+       * literals (e.g. the X-Fern-SDK-Name header value) in all .go files.
        */
       async addSuffixToGoFiles(repoRoot, modulePath, suffix) {
         const goFiles = await this.walkDirectory(repoRoot, (filePath) => (0, path_1.extname)(filePath) === ".go");
         await this.processInParallel(goFiles, (filePath) => this.addSuffixToGoFile(filePath, modulePath, suffix));
       }
       /**
-       * Adds a version suffix to import paths in a single .go file.
-       * Replaces occurrences of the module path with modulePath + suffix in import statements.
+       * Adds a version suffix to import paths and embedded module-path string
+       * literals in a single .go file.
        */
       async addSuffixToGoFile(filePath, modulePath, suffix) {
         const content5 = await (0, promises_1.readFile)(filePath, "utf-8");
@@ -564798,13 +564814,10 @@ var require_AutoVersioningService = __commonJS({
             inImportBlock = false;
           }
           const isImportLine = inImportBlock || trimmed2.startsWith('import "') || trimmed2.startsWith('import	"') || /^import\s+\w+\s+"/.test(trimmed2);
-          if (!isImportLine) {
-            continue;
-          }
           if (!line.includes(modulePath)) {
             continue;
           }
-          const newLine = line.replace(`"${modulePath}/`, `"${modulePath}${suffix}/`).replace(`"${modulePath}"`, `"${modulePath}${suffix}"`);
+          const newLine = isImportLine ? line.split(`"${modulePath}/`).join(`"${modulePath}${suffix}/`).split(`"${modulePath}"`).join(`"${modulePath}${suffix}"`) : line.split(`"${modulePath}"`).join(`"${modulePath}${suffix}"`);
           if (newLine !== line) {
             lines[i5] = newLine;
             changed = true;
@@ -564815,6 +564828,36 @@ var require_AutoVersioningService = __commonJS({
           this.logger.debug(`Updated Go imports in ${filePath}`);
         }
       }
+      /**
+       * Adds a version suffix to Go module references in all Markdown files
+       * (e.g. README.md) in the repository, so documented install commands and
+       * import samples resolve to the correct /vN module path when copy-pasted.
+       */
+      async addSuffixToMarkdownFiles(repoRoot, modulePath, suffix) {
+        const markdownFiles = await this.walkDirectory(repoRoot, (filePath) => (0, path_1.extname)(filePath).toLowerCase() === ".md");
+        await this.processInParallel(markdownFiles, (filePath) => this.addSuffixToMarkdownFile(filePath, modulePath, suffix));
+      }
+      /**
+       * Adds a version suffix to Go module references in a single Markdown file.
+       * Rewrites `go get`/`go install` install commands and quoted import paths in
+       * code samples. Web URLs (e.g. `https://pkg.go.dev/<modulePath>`) are left
+       * untouched because the module path there is neither quote-anchored nor
+       * preceded by an install command.
+       */
+      async addSuffixToMarkdownFile(filePath, modulePath, suffix) {
+        const content5 = await (0, promises_1.readFile)(filePath, "utf-8");
+        if (!content5.includes(modulePath)) {
+          return;
+        }
+        let updated = content5.split(`"${modulePath}/`).join(`"${modulePath}${suffix}/`).split(`"${modulePath}"`).join(`"${modulePath}${suffix}"`);
+        const escapedModulePath = modulePath.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        const installCommandPattern = new RegExp(`(go (?:get|install)(?:\\s+-\\S+)*\\s+)${escapedModulePath}(?![\\w./-])`, "g");
+        updated = updated.replace(installCommandPattern, `$1${modulePath}${suffix}`);
+        if (updated !== content5) {
+          await (0, promises_1.writeFile)(filePath, updated, "utf-8");
+          this.logger.debug(`Updated Go module path in ${filePath}`);
+        }
+      }
       /**
        * Extracts the file path from a diff file section.
        * Parses the "diff --git a/path b/path" header line.
@@ -564860,6 +564903,44 @@ var require_AutoVersioningService = __commonJS({
   }
 });
 
+// ../../generator-cli/lib/autoversion/changelogUtils.js
+var require_changelogUtils = __commonJS({
+  "../../generator-cli/lib/autoversion/changelogUtils.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.prependChangelogBlock = prependChangelogBlock2;
+    exports2.changelogContainsVersion = changelogContainsVersion2;
+    function prependChangelogBlock2({ existingContent, version: version7, entry, date: date26 = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10) }) {
+      const header = version7 != null ? `## [${version7}] - ${date26}
+` : `## ${date26}
+`;
+      const trimmedEntry = entry.trim();
+      const newBlock = trimmedEntry.length > 0 ? `${header}${trimmedEntry}
+
+` : `${header}
+`;
+      if (existingContent.trim().length === 0) {
+        return `# Changelog
+
+${newBlock}`;
+      }
+      if (existingContent.startsWith("# Changelog")) {
+        const newlineIdx = existingContent.indexOf("\n");
+        const headerLine = newlineIdx >= 0 ? existingContent.slice(0, newlineIdx) : existingContent;
+        const remainder = (newlineIdx >= 0 ? existingContent.slice(newlineIdx + 1) : "").replace(/^\s*\n/, "");
+        return `${headerLine}
+
+${newBlock}${remainder}`;
+      }
+      return `${newBlock}${existingContent}`;
+    }
+    function changelogContainsVersion2(content5, version7) {
+      const escaped = version7.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+      return new RegExp(`^## \\[${escaped}\\]`, "m").test(content5);
+    }
+  }
+});
+
 // ../../generator-cli/lib/autoversion/VersionUtils.js
 var require_VersionUtils = __commonJS({
   "../../generator-cli/lib/autoversion/VersionUtils.js"(exports2) {
@@ -564998,7 +565079,7 @@ var require_autoversion = __commonJS({
   "../../generator-cli/lib/autoversion/index.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.VersionBump = exports2.maxVersionBump = exports2.mapMagicVersionForLanguage = exports2.MAX_RAW_DIFF_BYTES = exports2.MAX_CHUNKS = exports2.MAX_AI_DIFF_BYTES = exports2.MAGIC_VERSION_PYTHON = exports2.MAGIC_VERSION = exports2.isValidSemver = exports2.isAutoVersion = exports2.incrementVersion = exports2.extractPreviousVersionFromDiffLine = exports2.extractLanguageFromGeneratorName = exports2.AUTO_VERSION = exports2.formatSizeKB = exports2.countFilesInDiff = exports2.AutoVersioningService = exports2.AutoVersioningException = exports2.AutoVersioningCache = void 0;
+    exports2.VersionBump = exports2.maxVersionBump = exports2.mapMagicVersionForLanguage = exports2.MAX_RAW_DIFF_BYTES = exports2.MAX_CHUNKS = exports2.MAX_AI_DIFF_BYTES = exports2.MAGIC_VERSION_PYTHON = exports2.MAGIC_VERSION = exports2.isValidSemver = exports2.isAutoVersion = exports2.incrementVersion = exports2.extractPreviousVersionFromDiffLine = exports2.extractLanguageFromGeneratorName = exports2.AUTO_VERSION = exports2.prependChangelogBlock = exports2.changelogContainsVersion = exports2.formatSizeKB = exports2.countFilesInDiff = exports2.AutoVersioningService = exports2.AutoVersioningException = exports2.AutoVersioningCache = void 0;
     var AutoVersioningCache_js_1 = require_AutoVersioningCache();
     Object.defineProperty(exports2, "AutoVersioningCache", { enumerable: true, get: function() {
       return AutoVersioningCache_js_1.AutoVersioningCache;
@@ -565016,6 +565097,13 @@ var require_autoversion = __commonJS({
     Object.defineProperty(exports2, "formatSizeKB", { enumerable: true, get: function() {
       return AutoVersioningService_js_1.formatSizeKB;
     } });
+    var changelogUtils_js_1 = require_changelogUtils();
+    Object.defineProperty(exports2, "changelogContainsVersion", { enumerable: true, get: function() {
+      return changelogUtils_js_1.changelogContainsVersion;
+    } });
+    Object.defineProperty(exports2, "prependChangelogBlock", { enumerable: true, get: function() {
+      return changelogUtils_js_1.prependChangelogBlock;
+    } });
     var VersionUtils_js_1 = require_VersionUtils();
     Object.defineProperty(exports2, "AUTO_VERSION", { enumerable: true, get: function() {
       return VersionUtils_js_1.AUTO_VERSION;
@@ -566400,32 +566488,11 @@ ${body}` : `${COMMIT_MARKER} ${subject}`;
       async prependChangelogEntry(params2) {
         const { version: version7, entry } = params2;
         const changelogPath = (0, path_1.join)(this.outputDir, "changelog.md");
-        const now = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-        const header = `## [${version7}] - ${now}
-`;
-        const newBlock = `${header}${entry.trim()}
-
-`;
         let existing = "";
         if ((0, fs_1.existsSync)(changelogPath)) {
           existing = await (0, promises_1.readFile)(changelogPath, "utf-8");
         }
-        let output2;
-        if (existing.trim().length === 0) {
-          output2 = `# Changelog
-
-${newBlock}`;
-        } else if (existing.startsWith("# Changelog")) {
-          const newlineIdx = existing.indexOf("\n");
-          const headerLine = newlineIdx >= 0 ? existing.slice(0, newlineIdx) : existing;
-          const remainder = (newlineIdx >= 0 ? existing.slice(newlineIdx + 1) : "").replace(/^\s*\n/, "");
-          output2 = `${headerLine}
-
-${newBlock}${remainder}`;
-        } else {
-          output2 = `${newBlock}${existing}`;
-        }
-        await (0, promises_1.writeFile)(changelogPath, output2, "utf-8");
+        await (0, promises_1.writeFile)(changelogPath, (0, index_1.prependChangelogBlock)({ existingContent: existing, version: version7, entry }), "utf-8");
       }
       brandMessage(message) {
         if (this.config.isWhitelabel) {
@@ -582302,6 +582369,7 @@ var require_GithubStep = __commonJS({
     var rest_1 = (init_dist_src9(), __toCommonJS(dist_src_exports));
     var promises_1 = require("fs/promises");
     var path_1 = require("path");
+    var index_1 = require_autoversion();
     var createReplayBranch_1 = require_createReplayBranch();
     var findExistingUpdatablePR_1 = require_findExistingUpdatablePR();
     var parseCommitMessage_1 = require_parseCommitMessage();
@@ -582643,31 +582711,38 @@ var require_GithubStep = __commonJS({
         }
       }
       /**
-       * Guarantees `changelog.md` is present in the output directory whenever a changelog entry
-       * exists for this run, so the file lands in the committed tree that GithubStep pushes and the
+       * Guarantees `changelog.md` records this run whenever there is a changelog entry or a
+       * resolved version, so the file lands in the committed tree that GithubStep pushes and the
        * "See full changelog" link resolves. AutoVersionStep normally writes this file via
-       * `prependChangelogEntry`; this is a safety net for paths where that write never reached the
-       * directory GithubStep commits (e.g. non-replay self-hosted generation), which previously left
-       * the link pointing at a non-existent blob (404).
+       * `prependChangelogEntry`; this covers the paths where that write never reached the
+       * directory GithubStep commits (e.g. non-replay self-hosted generation) and explicitly
+       * versioned runs (`--version X.Y.Z`), which record a version-only entry with an empty
+       * description. Existing entries are always preserved — the new block is prepended.
        *
-       * Returns `true` when it created the file, `false` when the file already existed (or there is
-       * no changelog entry to write).
+       * Returns `true` when it created or modified the file, `false` when the version's entry was
+       * already recorded (e.g. by AutoVersionStep) or there is nothing to write.
        */
       async ensureChangelogFile(resolved) {
-        const entry = resolved.changelogEntry?.trim();
-        if (entry == null || entry.length === 0) {
+        const entry = resolved.changelogEntry?.trim() ?? "";
+        const version7 = resolved.newVersion ?? resolved.previousVersion;
+        if (entry.length === 0 && resolved.newVersion == null) {
           return false;
         }
         const changelogPath = (0, path_1.join)(this.outputDir, "changelog.md");
+        let existing;
         try {
-          await (0, promises_1.access)(changelogPath);
-          return false;
+          existing = await (0, promises_1.readFile)(changelogPath, "utf-8");
         } catch {
-          const version7 = resolved.newVersion ?? resolved.previousVersion;
-          await (0, promises_1.writeFile)(changelogPath, buildChangelogFileContents(entry, version7), "utf-8");
-          this.logger.debug(`Wrote changelog.md${version7 != null ? ` for ${version7}` : ""}.`);
-          return true;
+          existing = void 0;
+        }
+        if (existing != null) {
+          if (version7 == null || (0, index_1.changelogContainsVersion)(existing, version7)) {
+            return false;
+          }
         }
+        await (0, promises_1.writeFile)(changelogPath, (0, index_1.prependChangelogBlock)({ existingContent: existing ?? "", version: version7, entry }), "utf-8");
+        this.logger.debug(`Wrote changelog.md${version7 != null ? ` for ${version7}` : ""}.`);
+        return true;
       }
       deriveSkipCommit(replayResult) {
         if (replayResult == null) {
@@ -610909,6 +610984,7 @@ var require_GitHub = __commonJS({
     var fs_utils_1 = (init_lib8(), __toCommonJS(lib_exports3));
     var github_1 = (init_lib11(), __toCommonJS(lib_exports4));
     var rest_1 = (init_dist_src9(), __toCommonJS(dist_src_exports));
+    var promises_1 = require("fs/promises");
     var GitHub = class {
       githubConfig;
       constructor({ githubConfig }) {
@@ -610933,9 +611009,10 @@ var require_GitHub = __commonJS({
             await repository.pull(branch);
           }
           const fernIgnoreFiles = await this.getFernignoreFiles(repository);
+          const changelogFiles = await this.getChangelogFilesToPreserve(repository, sourceDirectory);
           await repository.overwriteLocalContents(sourceDirectory);
           await repository.add(".");
-          await this.restoreFiles(repository, fernIgnoreFiles);
+          await this.restoreFiles(repository, [...fernIgnoreFiles, ...changelogFiles]);
           await repository.commit("SDK Generation");
           if (isEmptyRepo) {
             await repository.pushUpstream(branch);
@@ -610972,9 +611049,10 @@ var require_GitHub = __commonJS({
           const prBranch = `fern-bot/${formattedDate}`;
           await repository.checkout(prBranch);
           const fernIgnoreFiles = await this.getFernignoreFiles(repository);
+          const changelogFiles = await this.getChangelogFilesToPreserve(repository, sourceDirectory);
           await repository.overwriteLocalContents(sourceDirectory);
           await repository.add(".");
-          await this.restoreFiles(repository, fernIgnoreFiles);
+          await this.restoreFiles(repository, [...fernIgnoreFiles, ...changelogFiles]);
           await repository.commit("SDK Generation");
           await repository.push();
           const apiBaseUrl = (0, github_1.getGithubApiBaseUrl)(this.githubConfig.uri);
@@ -611018,6 +611096,25 @@ var require_GitHub = __commonJS({
         const tracked = await repository.listTrackedFiles();
         return (0, github_1.expandFernignorePatterns)(fernignore, tracked);
       }
+      /**
+       * Returns tracked changelog files (e.g. `changelog.md`) that should be restored after
+       * `overwriteLocalContents`, so existing changelog entries are never wiped when the
+       * generated output doesn't include a changelog of its own.
+       */
+      async getChangelogFilesToPreserve(repository, sourceDirectory) {
+        const tracked = await repository.listTrackedFiles();
+        const trackedChangelogs = tracked.filter((file4) => file4.toLowerCase() === "changelog.md");
+        if (trackedChangelogs.length === 0) {
+          return [];
+        }
+        try {
+          const sourceFiles = await (0, promises_1.readdir)(sourceDirectory);
+          const sourceHasChangelog = sourceFiles.some((file4) => file4.toLowerCase() === "changelog.md");
+          return sourceHasChangelog ? [] : trackedChangelogs;
+        } catch {
+          return trackedChangelogs;
+        }
+      }
       async restoreFiles(repository, files) {
         if (files.length === 0) {
           return;
@@ -622831,7 +622928,7 @@ var require_jsonfile = __commonJS({
       const str2 = stringify5(obj, options2);
       await universalify.fromCallback(fs34.writeFile)(file4, str2, options2);
     }
-    var writeFile101 = universalify.fromPromise(_writeFile);
+    var writeFile102 = universalify.fromPromise(_writeFile);
     function writeFileSync9(file4, obj, options2 = {}) {
       const fs34 = options2.fs || _fs;
       const str2 = stringify5(obj, options2);
@@ -622840,7 +622937,7 @@ var require_jsonfile = __commonJS({
     module4.exports = {
       readFile: readFile120,
       readFileSync: readFileSync19,
-      writeFile: writeFile101,
+      writeFile: writeFile102,
       writeFileSync: writeFileSync9
     };
   }
@@ -689246,7 +689343,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.70.0",
+          version: "5.70.2",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -689312,7 +689409,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.70.0",
+        version: "5.70.2",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -870413,7 +870510,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.70.0";
+  const version7 = "5.70.2";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -902985,7 +903082,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.70.0",
+        cliVersion: "5.70.2",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -922875,6 +922972,11 @@ var Generation = class {
       multipartMethodNameForCollection: "AddFileParameterParts",
       isReferenceType: true
     }),
+    /** Factory for the default HttpClient with automatic response decompression */
+    DefaultHttpClientFactory: () => this.csharp.classReference({
+      namespace: this.namespaces.core,
+      origin: this.model.staticExplicit("DefaultHttpClientFactory")
+    }),
     /** HTTP header management utilities */
     Headers: () => this.csharp.classReference({
       namespace: this.namespaces.core,
@@ -955982,6 +956084,7 @@ var LocalTaskHandler = class {
     const isFernIgnorePresent = this.skipFernignore ? false : await this.isFernIgnorePresent();
     const isExistingGitRepo = await this.isGitRepository();
     const priorChangelog = this.version != null && (0, import_autoversion2.isAutoVersion)(this.version) ? await this.readPriorChangelog(3) : "";
+    const priorChangelogFile = await this.readChangelogFile();
     if (isFernIgnorePresent) {
       const absolutePathToFernignore = AbsoluteFilePath2.of(join8(this.absolutePathToLocalOutput, RelativeFilePath2.of(FERNIGNORE_FILENAME)));
       const fernIgnorePaths = await getFernIgnorePaths({ absolutePathToFernignore });
@@ -955997,6 +956100,13 @@ var LocalTaskHandler = class {
     } else {
       await this.copyGeneratedFilesNoFernIgnoreDeleteAll();
     }
+    await this.restoreChangelogFile(priorChangelogFile);
+    if (this.version != null && !(0, import_autoversion2.isAutoVersion)(this.version)) {
+      await this.prependExplicitVersionChangelogEntry({
+        version: this.version,
+        createIfMissing: isExistingGitRepo
+      });
+    }
     if (this.absolutePathToTmpSnippetJSON != null && this.absolutePathToLocalSnippetJSON != null && await doesPathExist(this.absolutePathToTmpSnippetJSON)) {
       await this.copySnippetJSON({
         absolutePathToTmpSnippetJSON: this.absolutePathToTmpSnippetJSON,
@@ -956598,6 +956708,58 @@ var LocalTaskHandler = class {
       return "";
     }
   }
+  /**
+   * Reads the full contents of the changelog file (case-insensitive `changelog.md`)
+   * in the output directory. Returns undefined when no changelog file exists.
+   */
+  async readChangelogFile() {
+    try {
+      const files = await (0, import_promises137.readdir)(this.absolutePathToLocalOutput);
+      const filename = files.find((f3) => f3.toLowerCase() === "changelog.md");
+      if (filename == null) {
+        return void 0;
+      }
+      const content5 = await (0, import_promises137.readFile)(join8(this.absolutePathToLocalOutput, RelativeFilePath2.of(filename)), "utf-8");
+      return { filename, content: content5 };
+    } catch (error50) {
+      this.context.logger.debug(`Failed to read changelog file: ${error50}`);
+      return void 0;
+    }
+  }
+  /**
+   * Restores the changelog file captured before the copy operations if those
+   * operations removed it (generators don't emit changelog.md, so a plain copy
+   * would silently drop all prior entries).
+   */
+  async restoreChangelogFile(prior) {
+    if (prior == null) {
+      return;
+    }
+    const current3 = await this.readChangelogFile();
+    if (current3 != null) {
+      return;
+    }
+    await (0, import_promises137.writeFile)(join8(this.absolutePathToLocalOutput, RelativeFilePath2.of(prior.filename)), prior.content);
+    this.context.logger.debug(`Restored ${prior.filename} removed during generation.`);
+  }
+  /**
+   * Prepends a version-only changelog entry (version header, empty description) for an
+   * explicitly pinned version. Skips when the version is already recorded. When no
+   * changelog file exists, one is created only if `createIfMissing` is set (SDK repos) —
+   * plain local filesystem outputs are left untouched.
+   */
+  async prependExplicitVersionChangelogEntry({ version: version7, createIfMissing }) {
+    const existing = await this.readChangelogFile();
+    if (existing == null && !createIfMissing) {
+      return;
+    }
+    if (existing != null && (0, import_autoversion2.changelogContainsVersion)(existing.content, version7)) {
+      return;
+    }
+    const filename = existing?.filename ?? "changelog.md";
+    await (0, import_promises137.writeFile)(join8(this.absolutePathToLocalOutput, RelativeFilePath2.of(filename)), (0, import_autoversion2.prependChangelogBlock)({ existingContent: existing?.content ?? "", version: version7, entry: "" }));
+    this.context.logger.debug(`Recorded version ${version7} in ${filename}.`);
+  }
   /**
    * Reads the most recent git commit message that touched the .fern/ directory
    * in the spec repo. This provides context to the AI about why the API changed.
@@ -969346,7 +969508,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.70.0"
+    cli_version: "5.70.2"
   };
 }
 function isAutomationMode() {
@@ -970178,7 +970340,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.70.0";
+    return "5.70.2";
   }
   getCliName() {
     if (false) {

package/package.json

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