@fern-api/fern-api-dev 5.67.0 → 5.67.1

package/cli.cjs

@@ -564284,7 +564284,8 @@ var require_AutoVersioningService = __commonJS({
             contentLines.push(line);
           }
         }
-        let processedContent = this.removeVersionChangePairs(contentLines, mappedMagicVersion);
+        let processedContent = this.removeGoModulePathSuffixPairs(contentLines);
+        processedContent = this.removeVersionChangePairs(processedContent, mappedMagicVersion);
         processedContent = this.removeRemainingMagicVersionLines(processedContent, mappedMagicVersion);
         let hasChanges2 = false;
         for (const line of processedContent) {
@@ -564420,21 +564421,83 @@ var require_AutoVersioningService = __commonJS({
        * so non-Go diffs like API URL version changes are not affected.
        */
       isGoModulePathSuffixChange(minusLine, plusLine) {
-        const minusContent = minusLine.substring(1);
-        const plusContent = plusLine.substring(1);
-        const goModulePathPattern = /"[^"]*(?:github\.com|golang\.org|google\.golang\.org|gopkg\.in)\/[^"]*"/;
-        const goModuleDirectivePattern = /^\s*module\s+(?:github\.com|golang\.org|google\.golang\.org|gopkg\.in)\/\S+/;
-        const hasGoModulePath = goModulePathPattern.test(minusContent) || goModulePathPattern.test(plusContent) || goModuleDirectivePattern.test(minusContent.trim()) || goModuleDirectivePattern.test(plusContent.trim());
-        if (!hasGoModulePath) {
+        const minus = this.analyzeGoModulePathLine(minusLine);
+        const plus = this.analyzeGoModulePathLine(plusLine);
+        if (minus == null || plus == null) {
           return false;
         }
-        const suffixPattern = /\/v\d+(?=\/|"\s*$|$)/g;
-        const minusWithoutSuffix = minusContent.replace(suffixPattern, "");
-        const plusWithoutSuffix = plusContent.replace(suffixPattern, "");
-        if (minusWithoutSuffix !== plusWithoutSuffix) {
+        if (minus.strippedContent !== plus.strippedContent) {
           return false;
         }
-        return /\/v\d+(?=\/|"\s*$|$)/.test(minusContent) || /\/v\d+(?=\/|"\s*$|$)/.test(plusContent);
+        return minus.hasSuffix || plus.hasSuffix;
+      }
+      /**
+       * Removes Go module path `/vN` suffix-only churn from a diff section, regardless of how the
+       * deletion and addition lines are laid out. `removeVersionChangePairs` only removes a deletion
+       * when it can pair it with a *nearby* addition and keeps every line in between — so a diff that
+       * groups all deletions before all additions (as Go import blocks do) leaks the suffix churn for
+       * every line except the first. That churn then reaches the AI diff analyzer, which sees the
+       * previously published `/vN` module path changing on every import and misclassifies a
+       * no-op regeneration as a breaking change (spurious major bump).
+       *
+       * This pass matches each suffix-bearing deletion with any suffix-only-equivalent addition in
+       * the section (by suffix-stripped content) and drops both, so only genuine content changes to
+       * Go module path lines survive.
+       */
+      removeGoModulePathSuffixPairs(lines) {
+        const additions = [];
+        for (let index3 = 0; index3 < lines.length; index3++) {
+          const line = lines[index3];
+          if (line == null || !this.isAdditionLine(line)) {
+            continue;
+          }
+          const info = this.analyzeGoModulePathLine(line);
+          if (info != null) {
+            additions.push({ index: index3, strippedContent: info.strippedContent });
+          }
+        }
+        const removed = /* @__PURE__ */ new Set();
+        const usedAdditions = /* @__PURE__ */ new Set();
+        for (let index3 = 0; index3 < lines.length; index3++) {
+          const line = lines[index3];
+          if (line == null || !this.isDeletionLine(line)) {
+            continue;
+          }
+          const info = this.analyzeGoModulePathLine(line);
+          if (info == null || !info.hasSuffix) {
+            continue;
+          }
+          const match3 = additions.find((addition) => !usedAdditions.has(addition.index) && addition.strippedContent === info.strippedContent);
+          if (match3 != null) {
+            usedAdditions.add(match3.index);
+            removed.add(index3);
+            removed.add(match3.index);
+          }
+        }
+        if (removed.size === 0) {
+          return lines;
+        }
+        return lines.filter((_5, index3) => !removed.has(index3));
+      }
+      /**
+       * If a diff line (with its leading +/- stripped) references a Go module path — either a quoted
+       * import path or a `module` directive — returns its content with any `/vN` module-version
+       * suffixes removed, plus whether a suffix was present. Returns undefined for non-Go lines so
+       * unrelated diffs (e.g. API URL version segments) are never touched.
+       */
+      analyzeGoModulePathLine(line) {
+        const content5 = line.substring(1);
+        const goModulePathPattern = /"[^"]*(?:github\.com|golang\.org|google\.golang\.org|gopkg\.in)\/[^"]*"/;
+        const goModuleDirectivePattern = /^\s*module\s+(?:github\.com|golang\.org|google\.golang\.org|gopkg\.in)\/\S+/;
+        const isGoModulePathLine = goModulePathPattern.test(content5) || goModuleDirectivePattern.test(content5.trim());
+        if (!isGoModulePathLine) {
+          return void 0;
+        }
+        const suffixPattern = /\/v\d+(?=\/|"|$)/g;
+        return {
+          strippedContent: content5.replace(suffixPattern, ""),
+          hasSuffix: suffixPattern.test(content5)
+        };
       }
       /**
        * Gets the latest semantic version from git tags in the given repository.
@@ -564733,8 +564796,8 @@ var require_VersionUtils = __commonJS({
     };
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.VersionBump = exports2.MAX_RAW_DIFF_BYTES = exports2.MAX_CHUNKS = exports2.MAX_AI_DIFF_BYTES = exports2.MAGIC_VERSION_PYTHON = exports2.MAGIC_VERSION = exports2.AUTO_VERSION = void 0;
-    exports2.extractLanguageFromGeneratorName = extractLanguageFromGeneratorName2;
-    exports2.mapMagicVersionForLanguage = mapMagicVersionForLanguage3;
+    exports2.extractLanguageFromGeneratorName = extractLanguageFromGeneratorName3;
+    exports2.mapMagicVersionForLanguage = mapMagicVersionForLanguage4;
     exports2.maxVersionBump = maxVersionBump3;
     exports2.isAutoVersion = isAutoVersion5;
     exports2.isValidSemver = isValidSemver;
@@ -564742,7 +564805,7 @@ var require_VersionUtils = __commonJS({
     exports2.extractPreviousVersionFromDiffLine = extractPreviousVersionFromDiffLine;
     var semver_1 = __importDefault2(require_semver2());
     var AutoVersioningService_js_1 = require_AutoVersioningService();
-    function extractLanguageFromGeneratorName2(generatorName) {
+    function extractLanguageFromGeneratorName3(generatorName) {
       const name2 = generatorName.toLowerCase();
       if (name2.includes("typescript") || name2.includes("ts-sdk") || name2.includes("node-sdk")) {
         return "typescript";
@@ -564779,7 +564842,7 @@ var require_VersionUtils = __commonJS({
     exports2.AUTO_VERSION = "AUTO";
     exports2.MAGIC_VERSION = "0.0.0-fern-placeholder";
     exports2.MAGIC_VERSION_PYTHON = "0.0.0.dev0";
-    function mapMagicVersionForLanguage3(magicVersion, language) {
+    function mapMagicVersionForLanguage4(magicVersion, language) {
       if (magicVersion !== exports2.MAGIC_VERSION) {
         return magicVersion;
       }
@@ -582073,6 +582136,8 @@ var require_GithubStep = __commonJS({
     exports2.shouldCheckNoDiff = shouldCheckNoDiff;
     exports2.shouldPushGenerationBaseTag = shouldPushGenerationBaseTag;
     exports2.resolveBranchAction = resolveBranchAction;
+    exports2.buildChangelogFileContents = buildChangelogFileContents;
+    exports2.resolveChangelogUrl = resolveChangelogUrl;
     var core_utils_1 = (init_lib4(), __toCommonJS(lib_exports));
     var github_1 = (init_lib11(), __toCommonJS(lib_exports4));
     var rest_1 = (init_dist_src9(), __toCommonJS(dist_src_exports));
@@ -582173,11 +582238,16 @@ var require_GithubStep = __commonJS({
             throw new Error(`Unexpected branch action: ${String(_exhaustive)}`);
           }
         }
+        const createdChangelog = await this.ensureChangelogFile(resolved);
         if (!skipCommit) {
           await this.ensureFernignore();
           this.logger.debug("Committing changes...");
           await repository.commitAllChanges(resolved.commitMessage);
           this.logger.debug(`Committed changes to local copy of GitHub repository at ${this.outputDir}`);
+        } else if (createdChangelog) {
+          this.logger.debug("Committing reconstructed changelog.md on top of the replay commit...");
+          await repository.add("changelog.md");
+          await repository.commit(resolved.commitMessage);
         }
         if (shouldCheckNoDiff(this.config)) {
           const noDiff = await repository.treeHashEquals(`origin/${baseBranch}`);
@@ -582218,7 +582288,18 @@ var require_GithubStep = __commonJS({
           }
         }
         const headSha = await repository.getHeadSha();
-        const changelogUrl = resolved.changelogEntry ? `https://${remote}/${owner}/${repo}/blob/${headSha}/changelog.md` : void 0;
+        const changelogCommitted = (await repository.listTrackedFiles()).includes("changelog.md");
+        const changelogUrl = resolveChangelogUrl({
+          changelogEntry: resolved.changelogEntry,
+          changelogCommitted,
+          remote,
+          owner,
+          repo,
+          headSha
+        });
+        if (resolved.changelogEntry && !changelogCommitted) {
+          this.logger.warn('changelog.md is not present in the committed tree; omitting the "See full changelog" link.');
+        }
         const { prTitle, prBody } = (0, parseCommitMessage_1.parseCommitMessageForPR)(resolved.commitMessage, resolved.changelogEntry, resolved.prDescription, resolved.versionBumpReason, resolved.previousVersion, resolved.newVersion, resolved.versionBump, changelogUrl);
         const replaySection = (0, replay_summary_1.formatReplayPrBody)(replayResult, { branchName: prBranch, repoUri: this.config.uri });
         let enrichedBody = replaySection != null ? prBody + "\n\n---\n\n" + replaySection : prBody;
@@ -582284,6 +582365,7 @@ var require_GithubStep = __commonJS({
           this.logger.debug(`Checking out branch ${this.config.branch}`);
           await repository.checkout(this.config.branch);
         }
+        await this.ensureChangelogFile(resolved);
         await this.ensureFernignore();
         this.logger.debug("Committing changes...");
         await repository.commitAllChanges(resolved.commitMessage);
@@ -582325,6 +582407,7 @@ var require_GithubStep = __commonJS({
           this.logger.debug(`Checking out branch ${this.config.branch}`);
           await repository.checkout(this.config.branch);
         }
+        await this.ensureChangelogFile(resolved);
         await this.ensureFernignore();
         this.logger.debug("Committing changes...");
         await repository.commitAllChanges(resolved.commitMessage);
@@ -582400,6 +582483,33 @@ var require_GithubStep = __commonJS({
           await (0, promises_1.writeFile)(fernignorePath, "# Specify files that shouldn't be modified by Fern\n", "utf-8");
         }
       }
+      /**
+       * 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
+       * "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).
+       *
+       * Returns `true` when it created the file, `false` when the file already existed (or there is
+       * no changelog entry to write).
+       */
+      async ensureChangelogFile(resolved) {
+        const entry = resolved.changelogEntry?.trim();
+        if (entry == null || entry.length === 0) {
+          return false;
+        }
+        const changelogPath = (0, path_1.join)(this.outputDir, "changelog.md");
+        try {
+          await (0, promises_1.access)(changelogPath);
+          return false;
+        } 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;
+        }
+      }
       deriveSkipCommit(replayResult) {
         if (replayResult == null) {
           return false;
@@ -582480,6 +582590,24 @@ _Fern Run ID: \`${config5.runId}\`_`;
       }
       return "create-from-head";
     }
+    function buildChangelogFileContents(entry, version7) {
+      const trimmed2 = entry.trim();
+      const now = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+      const header = version7 != null ? `## [${version7}] - ${now}
+` : `## ${now}
+`;
+      return `# Changelog
+
+${header}${trimmed2}
+
+`;
+    }
+    function resolveChangelogUrl({ changelogEntry, changelogCommitted, remote, owner, repo, headSha }) {
+      if (changelogEntry == null || changelogEntry.trim().length === 0 || !changelogCommitted) {
+        return void 0;
+      }
+      return `https://${remote}/${owner}/${repo}/blob/${headSha}/changelog.md`;
+    }
   }
 });
 
@@ -688959,7 +689087,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.67.0",
+          version: "5.67.1",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -689025,7 +689153,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.67.0",
+        version: "5.67.1",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -870126,7 +870254,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.67.0";
+  const version7 = "5.67.1";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -902685,7 +902813,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.67.0",
+        cliVersion: "5.67.1",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -956878,6 +957006,8 @@ async function runLocalGenerationForWorkspace({ token, projectConfig, workspace,
       const packageName = getPackageNameFromGeneratorConfig(generatorInvocation);
       const userAgentTemplate = getUserAgentTemplateFromGeneratorConfig(generatorInvocation);
       version7 = version7 ?? await computeSemanticVersion({ packageName, generatorInvocation });
+      const irLanguage = generatorInvocation.language ?? (0, import_autoversion4.extractLanguageFromGeneratorName)(generatorInvocation.name);
+      const effectiveIrVersion = version7 != null && (0, import_autoversion4.isAutoVersion)(version7) ? (0, import_autoversion4.mapMagicVersionForLanguage)(import_autoversion4.MAGIC_VERSION, irLanguage) : version7;
       const intermediateRepresentation = generateIntermediateRepresentation({
         workspace: fernWorkspace,
         audiences: generatorGroup.audiences,
@@ -956889,7 +957019,7 @@ async function runLocalGenerationForWorkspace({ token, projectConfig, workspace,
           disabled: generatorInvocation.disableExamples
         },
         readme: generatorInvocation.readme,
-        version: version7 ?? await computeSemanticVersion({ packageName, generatorInvocation }),
+        version: effectiveIrVersion,
         packageName,
         userAgentTemplate,
         organization: projectConfig.organization,
@@ -957171,6 +957301,10 @@ async function getWorkspaceTempDir() {
   });
 }
 function getPublishConfig2({ generatorInvocation, org, version: version7, userProvidedVersion, packageName, context: context3, generateTests }) {
+  const publishLanguage = generatorInvocation.language ?? (0, import_autoversion4.extractLanguageFromGeneratorName)(generatorInvocation.name);
+  const substituteAutoVersion = (candidate) => candidate != null && (0, import_autoversion4.isAutoVersion)(candidate) ? (0, import_autoversion4.mapMagicVersionForLanguage)(import_autoversion4.MAGIC_VERSION, publishLanguage) : candidate;
+  const effectiveVersion = substituteAutoVersion(version7);
+  const effectiveUserProvidedVersion = substituteAutoVersion(userProvidedVersion);
   if (generatorInvocation.raw?.github != null && isGithubSelfhosted2(generatorInvocation.raw.github)) {
     const parsed = parseRepository(generatorInvocation.raw.github.uri);
     const irMode = generatorInvocation.raw.github.mode === "pull-request" ? "pull-request" : void 0;
@@ -957181,35 +957315,39 @@ function getPublishConfig2({ generatorInvocation, org, version: version7, userPr
       token: generatorInvocation.raw.github.token,
       mode: irMode,
       branch: generatorInvocation.raw.github.branch,
-      target: getPublishTarget({ outputSchema: generatorInvocation.raw.output, version: version7, packageName })
+      target: getPublishTarget({
+        outputSchema: generatorInvocation.raw.output,
+        version: effectiveVersion,
+        packageName
+      })
     });
   }
   if (generatorInvocation.raw?.output?.location === "local-file-system") {
     let publishTarget = void 0;
     if (generatorInvocation.language === "python") {
       publishTarget = PublishTarget.pypi({
-        version: version7,
+        version: effectiveVersion,
         packageName
       });
-      context3.logger.debug(`Created PyPiPublishTarget: version ${version7} package name: ${packageName}`);
+      context3.logger.debug(`Created PyPiPublishTarget: version ${effectiveVersion} package name: ${packageName}`);
     } else if (generatorInvocation.language === "typescript") {
-      if (userProvidedVersion != null) {
+      if (effectiveUserProvidedVersion != null) {
         const tsPackageName = packageName ?? (typeof generatorInvocation.raw?.config === "object" && generatorInvocation.raw?.config !== null ? generatorInvocation.raw.config.packageJson?.name : void 0);
         publishTarget = PublishTarget.npm({
-          version: userProvidedVersion,
+          version: effectiveUserProvidedVersion,
           packageName: tsPackageName,
           tokenEnvironmentVariable: ""
         });
-        context3.logger.debug(`Created NpmPublishTarget: version ${userProvidedVersion} package name: ${tsPackageName}`);
+        context3.logger.debug(`Created NpmPublishTarget: version ${effectiveUserProvidedVersion} package name: ${tsPackageName}`);
       }
     } else if (generatorInvocation.language === "rust") {
       publishTarget = PublishTarget.crates({
-        version: version7,
+        version: effectiveVersion,
         packageName
       });
-      context3.logger.debug(`Created CratesPublishTarget: version ${version7} package name: ${packageName}`);
+      context3.logger.debug(`Created CratesPublishTarget: version ${effectiveVersion} package name: ${packageName}`);
     } else if (generatorInvocation.language === "go") {
-      if (userProvidedVersion != null) {
+      if (effectiveUserProvidedVersion != null) {
         const goModulePath = (() => {
           const config5 = generatorInvocation.raw?.config;
           if (typeof config5 !== "object" || config5 === null) {
@@ -957222,10 +957360,10 @@ function getPublishConfig2({ generatorInvocation, org, version: version7, userPr
           return module4.path;
         })();
         publishTarget = PublishTarget.go({
-          version: userProvidedVersion,
+          version: effectiveUserProvidedVersion,
           modulePath: goModulePath
         });
-        context3.logger.debug(`Created GoPublishTarget: version ${userProvidedVersion} module path: ${goModulePath}`);
+        context3.logger.debug(`Created GoPublishTarget: version ${effectiveUserProvidedVersion} module path: ${goModulePath}`);
       }
     } else if (generatorInvocation.language === "java") {
       const config5 = generatorInvocation.raw?.config;
@@ -957251,7 +957389,7 @@ function getPublishConfig2({ generatorInvocation, org, version: version7, userPr
       })();
       const coordinate = mavenCoordinate ? `${mavenCoordinate.groupId}:${mavenCoordinate.artifactId}` : void 0;
       if (coordinate) {
-        const mavenVersion = version7 ?? "0.0.0";
+        const mavenVersion = effectiveVersion ?? "0.0.0";
         publishTarget = PublishTarget.maven({
           coordinate,
           version: mavenVersion,
@@ -969014,7 +969152,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.67.0"
+    cli_version: "5.67.1"
   };
 }
 function isAutomationMode() {
@@ -969846,7 +969984,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.67.0";
+    return "5.67.1";
   }
   getCliName() {
     if (false) {

package/package.json

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