@fern-api/fern-api-dev 5.69.0 → 5.70.1

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);
@@ -117178,7 +117178,8 @@ var init_DocsYmlSchemas = __esm({
       model: AIChatModel.optional(),
       "system-prompt": external_exports.string().optional(),
       location: external_exports.array(AIChatLocation).optional(),
-      datasources: external_exports.array(AIChatDatasource).optional()
+      datasources: external_exports.array(AIChatDatasource).optional(),
+      "mask-pii": external_exports.boolean().optional()
     });
     FontConfigVariant = external_exports.object({
       path: external_exports.string(),
@@ -121576,7 +121577,8 @@ var init_AiChatConfig2 = __esm({
       model: AiChatModel2.optional(),
       systemPrompt: schemas_exports6.property("system-prompt", schemas_exports6.string().optional()),
       location: schemas_exports6.list(AiChatLocation2).optional(),
-      datasources: schemas_exports6.list(AiChatDatasource).optional()
+      datasources: schemas_exports6.list(AiChatDatasource).optional(),
+      maskPii: schemas_exports6.property("mask-pii", schemas_exports6.boolean().optional())
     });
   }
 });
@@ -457162,13 +457164,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,
@@ -461443,7 +461445,8 @@ var init_DocsDefinitionResolver = __esm({
             datasources: this.parsedDocsConfig.aiChatConfig.datasources?.map((ds2) => ({
               url: ds2.url,
               title: ds2.title
-            }))
+            })),
+            maskPii: this.parsedDocsConfig.aiChatConfig.maskPii
           } : void 0,
           hideNavLinks: void 0,
           title: this.parsedDocsConfig.title,
@@ -480469,8 +480472,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);
@@ -564687,7 +564690,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.
@@ -564768,15 +564772,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");
@@ -564795,13 +564800,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;
@@ -564812,6 +564814,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.
@@ -564857,6 +564889,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) {
@@ -564995,7 +565065,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;
@@ -565013,6 +565083,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;
@@ -566397,32 +566474,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) {
@@ -582299,6 +582355,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();
@@ -582640,31 +582697,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) {
@@ -610906,6 +610970,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 }) {
@@ -610930,9 +610995,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);
@@ -610969,9 +611035,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);
@@ -611015,6 +611082,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;
@@ -622828,7 +622914,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);
@@ -622837,7 +622923,7 @@ var require_jsonfile = __commonJS({
     module4.exports = {
       readFile: readFile120,
       readFileSync: readFileSync19,
-      writeFile: writeFile101,
+      writeFile: writeFile102,
       writeFileSync: writeFileSync9
     };
   }
@@ -689243,7 +689329,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.69.0",
+          version: "5.70.1",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -689309,7 +689395,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.69.0",
+        version: "5.70.1",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -870410,7 +870496,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.69.0";
+  const version7 = "5.70.1";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -897206,6 +897292,17 @@ var definitions6 = {
           }
         ],
         description: "Additional content sources that Ask Fern should index and search."
+      },
+      "mask-pii": {
+        oneOf: [
+          {
+            type: "boolean"
+          },
+          {
+            type: "null"
+          }
+        ],
+        description: "When enabled, personally identifiable information (PII) in user messages is masked before\nbeing sent to Ask Fern. Disabled by default."
       }
     },
     additionalProperties: false
@@ -902971,7 +903068,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.69.0",
+        cliVersion: "5.70.1",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -955968,6 +956065,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 });
@@ -955983,6 +956081,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,
@@ -956584,6 +956689,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.
@@ -969332,7 +969489,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.69.0"
+    cli_version: "5.70.1"
   };
 }
 function isAutomationMode() {
@@ -970164,7 +970321,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.69.0";
+    return "5.70.1";
   }
   getCliName() {
     if (false) {

package/package.json

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