@fern-api/fern-api-dev 5.8.1-6-g373abe1fdc5 → 5.9.0-rc.0

package/cli.cjs

@@ -105573,12 +105573,12 @@ ${problem.message}
             endLine: location2.end?.line,
             endColumn: location2.end?.col
           };
-          output_1.output.write(`::${command3} ${formatProperties(properties7)}::${escapeMessage(message)}
+          output_1.output.write(`::${command3} ${formatProperties2(properties7)}::${escapeMessage(message)}
 `);
         }
       }
-      function formatProperties(props) {
-        return Object.entries(props).filter(([, v9]) => v9 !== null && v9 !== void 0).map(([k5, v9]) => `${k5}=${escapeProperty(v9)}`).join(",");
+      function formatProperties2(props) {
+        return Object.entries(props).filter(([, v9]) => v9 !== null && v9 !== void 0).map(([k5, v9]) => `${k5}=${escapeProperty2(v9)}`).join(",");
       }
       function toString10(v9) {
         if (v9 === null || v9 === void 0) {
@@ -105591,7 +105591,7 @@ ${problem.message}
       function escapeMessage(v9) {
         return toString10(v9).replace(/%/g, "%25").replace(/\r/g, "%0D").replace(/\n/g, "%0A");
       }
-      function escapeProperty(v9) {
+      function escapeProperty2(v9) {
         return toString10(v9).replace(/%/g, "%25").replace(/\r/g, "%0D").replace(/\n/g, "%0A").replace(/:/g, "%3A").replace(/,/g, "%2C");
       }
     }
@@ -257357,14 +257357,14 @@ var require_emoji_regex = __commonJS({
 var require_string_width = __commonJS({
   "../../../node_modules/.pnpm/string-width@4.2.3/node_modules/string-width/index.js"(exports2, module4) {
     "use strict";
-    var stripAnsi5 = require_strip_ansi();
+    var stripAnsi6 = require_strip_ansi();
     var isFullwidthCodePoint = require_is_fullwidth_code_point();
     var emojiRegex3 = require_emoji_regex();
     var stringWidth4 = (string28) => {
       if (typeof string28 !== "string" || string28.length === 0) {
         return 0;
       }
-      string28 = stripAnsi5(string28);
+      string28 = stripAnsi6(string28);
       if (string28.length === 0) {
         return 0;
       }
@@ -258499,7 +258499,7 @@ var require_wrap_ansi = __commonJS({
   "../../../node_modules/.pnpm/wrap-ansi@6.2.0/node_modules/wrap-ansi/index.js"(exports2, module4) {
     "use strict";
     var stringWidth4 = require_string_width();
-    var stripAnsi5 = require_strip_ansi();
+    var stripAnsi6 = require_strip_ansi();
     var ansiStyles3 = require_ansi_styles();
     var ESCAPES2 = /* @__PURE__ */ new Set([
       "\x1B",
@@ -258511,7 +258511,7 @@ var require_wrap_ansi = __commonJS({
     var wrapWord2 = (rows, word, columns) => {
       const characters = [...word];
       let isInsideEscape = false;
-      let visible = stringWidth4(stripAnsi5(rows[rows.length - 1]));
+      let visible = stringWidth4(stripAnsi6(rows[rows.length - 1]));
       for (const [index3, character] of characters.entries()) {
         const characterLength = stringWidth4(character);
         if (visible + characterLength <= columns) {
@@ -259899,7 +259899,7 @@ var require_ora = __commonJS({
     var cliCursor2 = require_cli_cursor();
     var cliSpinners2 = require_cli_spinners();
     var logSymbols2 = require_log_symbols();
-    var stripAnsi5 = require_strip_ansi();
+    var stripAnsi6 = require_strip_ansi();
     var wcwidth = require_wcwidth();
     var isInteractive2 = require_is_interactive();
     var isUnicodeSupported3 = require_is_unicode_supported();
@@ -260066,7 +260066,7 @@ var require_ora = __commonJS({
         const columns = this.stream.columns || 80;
         const fullPrefixText = this.getFullPrefixText(this.prefixText, "-");
         this.lineCount = 0;
-        for (const line of stripAnsi5(fullPrefixText + "--" + this[TEXT]).split("\n")) {
+        for (const line of stripAnsi6(fullPrefixText + "--" + this[TEXT]).split("\n")) {
           this.lineCount += Math.max(1, Math.ceil(wcwidth(line) / columns));
         }
       }
@@ -427270,7 +427270,7 @@ var require_wrap_ansi2 = __commonJS({
   "../../../node_modules/.pnpm/wrap-ansi@7.0.0/node_modules/wrap-ansi/index.js"(exports2, module4) {
     "use strict";
     var stringWidth4 = require_string_width();
-    var stripAnsi5 = require_strip_ansi();
+    var stripAnsi6 = require_strip_ansi();
     var ansiStyles3 = require_ansi_styles();
     var ESCAPES2 = /* @__PURE__ */ new Set([
       "\x1B",
@@ -427289,7 +427289,7 @@ var require_wrap_ansi2 = __commonJS({
       const characters = [...word];
       let isInsideEscape = false;
       let isInsideLinkEscape = false;
-      let visible = stringWidth4(stripAnsi5(rows[rows.length - 1]));
+      let visible = stringWidth4(stripAnsi6(rows[rows.length - 1]));
       for (const [index3, character] of characters.entries()) {
         const characterLength = stringWidth4(character);
         if (visible + characterLength <= columns) {
@@ -427683,12 +427683,12 @@ var require_build5 = __commonJS({
       });
     }
     var stringWidth4 = require_string_width();
-    var stripAnsi5 = require_strip_ansi();
+    var stripAnsi6 = require_strip_ansi();
     var wrap10 = require_wrap_ansi2();
     function ui10(opts) {
       return cliui2(opts, {
         stringWidth: stringWidth4,
-        stripAnsi: stripAnsi5,
+        stripAnsi: stripAnsi6,
         wrap: wrap10
       });
     }
@@ -511686,8 +511686,7 @@ var CheckRulesConfig = external_exports.object({
   "valid-local-references": CheckRuleSeverity.optional(),
   "no-circular-redirects": CheckRuleSeverity.optional(),
   "valid-docs-endpoints": CheckRuleSeverity.optional(),
-  "missing-redirects": CheckRuleSeverity.optional(),
-  "valid-changelog-slug": CheckRuleSeverity.optional()
+  "missing-redirects": CheckRuleSeverity.optional()
 });
 var CheckConfig = external_exports.object({
   rules: CheckRulesConfig.optional()
@@ -514650,8 +514649,7 @@ var CheckRulesConfig2 = schemas_exports6.object({
   validLocalReferences: schemas_exports6.property("valid-local-references", CheckRuleSeverity3.optional()),
   noCircularRedirects: schemas_exports6.property("no-circular-redirects", CheckRuleSeverity3.optional()),
   validDocsEndpoints: schemas_exports6.property("valid-docs-endpoints", CheckRuleSeverity3.optional()),
-  missingRedirects: schemas_exports6.property("missing-redirects", CheckRuleSeverity3.optional()),
-  validChangelogSlug: schemas_exports6.property("valid-changelog-slug", CheckRuleSeverity3.optional())
+  missingRedirects: schemas_exports6.property("missing-redirects", CheckRuleSeverity3.optional())
 });
 
 // ../configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/CheckConfig.js
@@ -544585,8 +544583,7 @@ async function parseNavigationOverlayFromDocsYml({ docsYmlContent, langFernDir:
         subtitle: typeof productObj.subtitle === "string" ? productObj.subtitle : void 0,
         announcement: void 0,
         tabs: void 0,
-        navigation: void 0,
-        versions: void 0
+        navigation: void 0
       };
       if (isPlainObject4(productObj.announcement)) {
         const message = extractString(productObj.announcement, "message");
@@ -544595,28 +544592,28 @@ async function parseNavigationOverlayFromDocsYml({ docsYmlContent, langFernDir:
         }
       }
       if (typeof productObj.path === "string") {
-        const navFile = await loadNavOverlayFile({
-          relativeNavPath: productObj.path,
-          overlayDir,
-          overlayKind: "product",
-          context: context3
-        });
-        if (navFile != null) {
-          productOverlay.tabs = navFile.tabs;
-          productOverlay.navigation = navFile.navigation;
+        const resolvedNavFilePath = import_path22.default.resolve(overlayDir, productObj.path);
+        if (!resolvedNavFilePath.startsWith(overlayDir)) {
+          context3.logger.warn(`Invalid path in product overlay: "${productObj.path}" escapes the translations directory. Skipping.`);
+          overlay.products.push(productOverlay);
+          continue;
         }
-      }
-      if (Array.isArray(productObj.versions)) {
-        productOverlay.versions = [];
-        for (const version7 of productObj.versions) {
-          if (!isPlainObject4(version7)) {
-            continue;
+        const navFilePath = resolvedNavFilePath;
+        if (await doesPathExist(navFilePath)) {
+          try {
+            const navContent = jsYaml.load(await (0, import_promises14.readFile)(navFilePath, "utf-8"));
+            if (isPlainObject4(navContent)) {
+              const navObj = navContent;
+              if (isPlainObject4(navObj.tabs)) {
+                productOverlay.tabs = parseTabOverlays(navObj.tabs);
+              }
+              if (Array.isArray(navObj.navigation)) {
+                productOverlay.navigation = parseNavigationItemOverlays(navObj.navigation);
+              }
+            }
+          } catch (error50) {
+            context3.logger.warn(`Failed to load translation nav file "${navFilePath}": ${String(error50)}`);
           }
-          productOverlay.versions.push(await parseVersionOverlay({
-            versionObj: version7,
-            overlayDir,
-            context: context3
-          }));
         }
       }
       overlay.products.push(productOverlay);
@@ -544628,11 +544625,11 @@ async function parseNavigationOverlayFromDocsYml({ docsYmlContent, langFernDir:
       if (!isPlainObject4(version7)) {
         continue;
       }
-      overlay.versions.push(await parseVersionOverlay({
-        versionObj: version7,
-        overlayDir,
-        context: context3
-      }));
+      const versionObj = version7;
+      overlay.versions.push({
+        slug: typeof versionObj.slug === "string" ? versionObj.slug : void 0,
+        displayName: typeof versionObj["display-name"] === "string" ? versionObj["display-name"] : void 0
+      });
     }
   }
   if (Array.isArray(docsYmlContent.navigation)) {
@@ -544640,51 +544637,6 @@ async function parseNavigationOverlayFromDocsYml({ docsYmlContent, langFernDir:
   }
   return overlay;
 }
-async function parseVersionOverlay({ versionObj, overlayDir, context: context3 }) {
-  const versionOverlay = {
-    slug: typeof versionObj.slug === "string" ? versionObj.slug : void 0,
-    displayName: typeof versionObj["display-name"] === "string" ? versionObj["display-name"] : void 0,
-    tabs: void 0,
-    navigation: void 0
-  };
-  if (typeof versionObj.path === "string") {
-    const navFile = await loadNavOverlayFile({
-      relativeNavPath: versionObj.path,
-      overlayDir,
-      overlayKind: "version",
-      context: context3
-    });
-    if (navFile != null) {
-      versionOverlay.tabs = navFile.tabs;
-      versionOverlay.navigation = navFile.navigation;
-    }
-  }
-  return versionOverlay;
-}
-async function loadNavOverlayFile({ relativeNavPath, overlayDir, overlayKind, context: context3 }) {
-  const resolvedNavFilePath = import_path22.default.resolve(overlayDir, relativeNavPath);
-  if (!resolvedNavFilePath.startsWith(overlayDir)) {
-    context3.logger.warn(`Invalid path in ${overlayKind} overlay: "${relativeNavPath}" escapes the translations directory. Skipping.`);
-    return void 0;
-  }
-  if (!await doesPathExist(resolvedNavFilePath)) {
-    return void 0;
-  }
-  try {
-    const navContent = jsYaml.load(await (0, import_promises14.readFile)(resolvedNavFilePath, "utf-8"));
-    if (!isPlainObject4(navContent)) {
-      return void 0;
-    }
-    const navObj = navContent;
-    return {
-      tabs: isPlainObject4(navObj.tabs) ? parseTabOverlays(navObj.tabs) : void 0,
-      navigation: Array.isArray(navObj.navigation) ? parseNavigationItemOverlays(navObj.navigation) : void 0
-    };
-  } catch (error50) {
-    context3.logger.warn(`Failed to load translation nav file "${resolvedNavFilePath}": ${String(error50)}`);
-    return void 0;
-  }
-}
 function parseTabOverlays(tabsObj) {
   const result = {};
   for (const [tabId, tabConfig] of Object.entries(tabsObj)) {
@@ -574121,6 +574073,85 @@ function formatLog({ breadcrumbs = [], title: title2, subtitle }) {
   return lines.join("\n");
 }
 
+// ../cli-logger/lib/githubAnnotations.js
+function shouldEmitGithubAnnotations() {
+  return process.env.GITHUB_ACTIONS === "true";
+}
+var loggerAnnotationsSuppressed = false;
+async function withSuppressedLoggerAnnotations(fn10) {
+  const previous4 = loggerAnnotationsSuppressed;
+  loggerAnnotationsSuppressed = true;
+  try {
+    return await fn10();
+  } finally {
+    loggerAnnotationsSuppressed = previous4;
+  }
+}
+function areLoggerAnnotationsSuppressed() {
+  return loggerAnnotationsSuppressed;
+}
+function renderGithubAnnotation(level, body, properties7 = {}) {
+  const sanitized = sanitizeForAnnotationBody(body);
+  if (sanitized.trim().length === 0) {
+    return void 0;
+  }
+  const propertiesString = formatProperties(properties7);
+  const prefix2 = propertiesString.length > 0 ? `::${level} ${propertiesString}::` : `::${level}::`;
+  return `${prefix2}${sanitized}
+`;
+}
+function renderGithubAnnotationFromLog(log4) {
+  if (log4.omitOnTTY === true) {
+    return void 0;
+  }
+  const level = logLevelToAnnotationLevel(log4.level);
+  if (level == null) {
+    return void 0;
+  }
+  const body = log4.parts.join(" ");
+  const title2 = log4.prefix != null ? extractTitleFromPrefix(log4.prefix) : void 0;
+  return renderGithubAnnotation(level, body, title2 != null ? { title: title2 } : {});
+}
+function logLevelToAnnotationLevel(level) {
+  switch (level) {
+    case LogLevel.Error:
+      return "error";
+    case LogLevel.Warn:
+      return "warning";
+    case LogLevel.Info:
+    case LogLevel.Debug:
+    case LogLevel.Trace:
+      return void 0;
+  }
+}
+function extractTitleFromPrefix(prefix2) {
+  const cleaned = stripAnsi3(prefix2).trim();
+  return cleaned.length > 0 ? cleaned : void 0;
+}
+function sanitizeForAnnotationBody(content5) {
+  return stripAnsi3(content5).replace(/\r\n/g, "\n").replace(/\r/g, "").replace(/\n+$/g, "").replace(/\n/g, "%0A");
+}
+function formatProperties(properties7) {
+  const parts = [];
+  if (properties7.file != null && properties7.file.length > 0) {
+    parts.push(`file=${escapeProperty(properties7.file)}`);
+  }
+  if (properties7.line != null) {
+    parts.push(`line=${properties7.line}`);
+  }
+  if (properties7.title != null && properties7.title.length > 0) {
+    parts.push(`title=${escapeProperty(properties7.title)}`);
+  }
+  return parts.join(",");
+}
+function escapeProperty(value2) {
+  return stripAnsi3(value2).replace(/%/g, "%25").replace(/\r/g, "%0D").replace(/\n/g, "%0A").replace(/:/g, "%3A").replace(/,/g, "%2C");
+}
+var ANSI_ESCAPE_PATTERN = /\[[0-?]*[ -/]*[@-~]/g;
+function stripAnsi3(content5) {
+  return content5.replace(ANSI_ESCAPE_PATTERN, "");
+}
+
 // ../cli-logger/lib/logErrorMessage.js
 var USE_NODE_18_OR_ABOVE_MESSAGE = "The Fern CLI requires Node 18+ or above.";
 function logErrorMessage({ message, error: error50, logger: logger4, logLevel = LogLevel.Error }) {
@@ -574866,6 +574897,7 @@ var TtyAwareLogger = class {
         this.writeStdout(content5);
       }
     };
+    const emitAnnotations = shouldEmitGithubAnnotations() && !areLoggerAnnotationsSuppressed();
     for (const log4 of logs4) {
       const content5 = formatLog2(log4, { includeDebugInfo });
       const omitOnTTY = log4.omitOnTTY ?? false;
@@ -574874,6 +574906,12 @@ var TtyAwareLogger = class {
       } else if (!omitOnTTY) {
         write3(this.clear() + content5 + this.lastPaint);
       }
+      if (emitAnnotations) {
+        const annotation = renderGithubAnnotationFromLog(log4);
+        if (annotation != null) {
+          this.stdout.write(annotation);
+        }
+      }
     }
   }
   repaint() {
@@ -622632,7 +622670,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.8.1-6-g373abe1fdc5",
+          version: "5.9.0-rc.0",
           usingAccessToken: true
         }
       });
@@ -622686,7 +622724,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.8.1-6-g373abe1fdc5",
+        version: "5.9.0-rc.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -628989,13 +629027,13 @@ function command2(cli, name2, description, handler3, builder) {
 
 // ../cli-v2/lib/commands/_internal/toJsonViolation.js
 var ANSI_REGEX = new RegExp(`${String.fromCodePoint(27)}\\[[0-9;]*m`, "g");
-function stripAnsi4(text9) {
+function stripAnsi5(text9) {
   return text9.replace(ANSI_REGEX, "");
 }
 function toJsonViolation(violation, options2) {
   const result = {
     severity: violation.severity,
-    message: stripAnsi4(violation.message)
+    message: stripAnsi5(violation.message)
   };
   if (options2?.api != null) {
     result.api = options2.api;
@@ -804627,7 +804665,7 @@ function applyChildOverlays(children2, parent, overlay) {
         const scopedOverlay = {
           tabs: productOverlay.tabs ?? overlay.tabs,
           products: void 0,
-          versions: productOverlay.versions ?? overlay.versions,
+          versions: overlay.versions,
           announcement: productOverlay.announcement ?? overlay.announcement,
           navigation: productOverlay.navigation ?? overlay.navigation,
           navbarLinks: overlay.navbarLinks
@@ -804645,19 +804683,11 @@ function applyChildOverlays(children2, parent, overlay) {
         return walkAndApply(child, overlay);
       }
       const versionOverlay = findVersionOverlay(childObj, overlay.versions ?? [], index3);
+      const walked = walkAndApply(child, overlay);
       if (versionOverlay != null) {
-        const scopedOverlay = {
-          tabs: versionOverlay.tabs ?? overlay.tabs,
-          products: void 0,
-          versions: void 0,
-          announcement: overlay.announcement,
-          navigation: versionOverlay.navigation ?? overlay.navigation,
-          navbarLinks: overlay.navbarLinks
-        };
-        const walked = walkAndApply(child, scopedOverlay);
         return applyVersionOverlayToNode(walked, versionOverlay);
       }
-      return walkAndApply(child, overlay);
+      return walked;
     });
   }
   if (parentType === "tabbed") {
@@ -819810,14 +819840,12 @@ var rules_exports = {};
 __export(rules_exports, {
   AccentColorContrastRule: () => AccentColorContrastRule,
   AllRolesMustBeDeclaredRule: () => AllRolesMustBeDeclaredRule,
-  CHANGELOG_FEED_ALLOWED_SLUGS: () => CHANGELOG_FEED_ALLOWED_SLUGS,
   FilepathsExistRule: () => FilepathsExistRule,
   MissingRedirectsRule: () => MissingRedirectsRule,
   NoCircularRedirectsRule: () => NoCircularRedirectsRule,
   OnlyVersionedNavigation: () => OnlyVersionedNavigation,
   TabWithHrefRule: () => TabWithHrefRule,
   TranslationDirectoriesExistRule: () => TranslationDirectoriesExistRule,
-  ValidChangelogSlugRule: () => ValidChangelogSlugRule,
   ValidDocsEndpoints: () => ValidDocsEndpoints,
   ValidFileTypes: () => ValidFileTypes,
   ValidFrontmatter: () => ValidFrontmatter,
@@ -819828,8 +819856,6 @@ __export(rules_exports, {
   ValidateProductFileRule: () => ValidateProductFileRule,
   ValidateVersionFileRule: () => ValidateVersionFileRule,
   enforceBackgroundTheme: () => enforceBackgroundTheme,
-  getEffectiveChangelogSlugLastSegment: () => getEffectiveChangelogSlugLastSegment,
-  isAllowedChangelogSlug: () => isAllowedChangelogSlug,
   validateTheme: () => validateTheme
 });
 
@@ -820856,148 +820882,6 @@ function buildExpectedDirectoryTree({ translationsDirExists, missingDirs, fernFo
   return lines.join("\n");
 }
 
-// ../yaml/docs-validator/lib/rules/valid-changelog-slug/valid-changelog-slug.js
-init_lodash();
-var CHANGELOG_FEED_ALLOWED_SLUGS = [
-  "changelog",
-  "changelogs",
-  "release-notes",
-  "releasenotes",
-  "whats-new",
-  "whatsnew"
-];
-var DEFAULT_CHANGELOG_TITLE3 = "Changelog";
-function getEffectiveChangelogSlugLastSegment(config5) {
-  const raw = config5.slug ?? kebabCase_default(config5.title ?? DEFAULT_CHANGELOG_TITLE3);
-  const segments = raw.split("/").filter((s9) => s9.length > 0);
-  return segments[segments.length - 1] ?? "";
-}
-function isAllowedChangelogSlug(lastSegment) {
-  return CHANGELOG_FEED_ALLOWED_SLUGS.includes(lastSegment);
-}
-function collectChangelogLocations(items, breadcrumb) {
-  if (items == null) {
-    return [];
-  }
-  const out = [];
-  for (const item of items) {
-    if (isChangelog(item)) {
-      out.push({
-        where: `${breadcrumb} > changelog (${item.changelog})`,
-        slug: item.slug,
-        title: item.title
-      });
-      continue;
-    }
-    if (isSection3(item)) {
-      const next2 = `${breadcrumb} > section "${item.section}"`;
-      out.push(...collectChangelogLocations(item.contents, next2));
-    }
-  }
-  return out;
-}
-function collectFromTabs(tabs, breadcrumb) {
-  if (tabs == null) {
-    return [];
-  }
-  const out = [];
-  for (const [tabId, tab2] of Object.entries(tabs)) {
-    if (tab2.changelog != null) {
-      out.push({
-        where: `${breadcrumb} > tab "${tabId}" (changelog: ${tab2.changelog})`,
-        slug: tab2.slug,
-        title: tab2.displayName
-      });
-    }
-  }
-  return out;
-}
-function collectFromNavigation(navigation2, breadcrumb) {
-  if (navigation2 == null || !Array.isArray(navigation2) || navigation2.length === 0) {
-    return [];
-  }
-  if (isTabbedNavigation(navigation2)) {
-    const out = [];
-    for (const item of navigation2) {
-      const next2 = `${breadcrumb} > tab "${item.tab}"`;
-      if ("layout" in item && Array.isArray(item.layout)) {
-        out.push(...collectChangelogLocations(item.layout, next2));
-      }
-      if ("variants" in item && Array.isArray(item.variants)) {
-        for (const variant of item.variants) {
-          const variantBreadcrumb = `${next2} > variant "${variant.title}"`;
-          out.push(...collectChangelogLocations(variant.layout, variantBreadcrumb));
-        }
-      }
-    }
-    return out;
-  }
-  return collectChangelogLocations(navigation2, breadcrumb);
-}
-function violationsForLocations(locations) {
-  const violations = [];
-  for (const loc of locations) {
-    const lastSegment = getEffectiveChangelogSlugLastSegment(loc);
-    if (lastSegment === "" || isAllowedChangelogSlug(lastSegment)) {
-      continue;
-    }
-    const allowed = CHANGELOG_FEED_ALLOWED_SLUGS.join(", ");
-    const sourceField = loc.slug != null ? `slug: "${loc.slug}"` : `title: "${loc.title ?? DEFAULT_CHANGELOG_TITLE3}"`;
-    violations.push({
-      severity: "error",
-      message: `Changelog at ${loc.where} resolves to URL segment "${lastSegment}" (from ${sourceField}). The docs server only serves changelog feeds (.rss, .atom, .json) when the final URL segment is one of: ${allowed}. Rename the changelog's title or set an explicit slug to one of these values, otherwise subscribers will get a 404 when they request the feed.`
-    });
-  }
-  return violations;
-}
-var ValidChangelogSlugRule = {
-  name: "valid-changelog-slug",
-  create: () => {
-    return {
-      file: async ({ config: config5 }) => {
-        const locations = [
-          ...collectFromNavigation(config5.navigation, "navigation"),
-          ...collectFromTabs(config5.tabs, "tabs")
-        ];
-        return violationsForLocations(locations);
-      },
-      versionFile: async ({ path: path106, content: content5 }) => {
-        const parseResult = await validateVersionConfigFileSchema({ value: content5 });
-        if (parseResult.type !== "success") {
-          return [];
-        }
-        const versionConfig = parseResult.contents;
-        const locations = [
-          ...collectFromNavigation(versionConfig.navigation, `version "${path106}" navigation`),
-          ...collectFromTabs(versionConfig.tabs, `version "${path106}" tabs`)
-        ];
-        return violationsForLocations(locations);
-      },
-      productFile: async ({ path: path106, content: content5 }) => {
-        const parseResult = await validateProductConfigFileSchema({ value: content5 });
-        if (parseResult.type !== "success") {
-          return [];
-        }
-        const productConfig = parseResult.contents;
-        const locations = [
-          ...collectFromNavigation(productConfig.navigation, `product "${path106}" navigation`),
-          ...collectFromTabs(productConfig.tabs, `product "${path106}" tabs`)
-        ];
-        return violationsForLocations(locations);
-      }
-    };
-  }
-};
-function isChangelog(item) {
-  return item?.changelog != null;
-}
-function isSection3(item) {
-  return item?.section != null;
-}
-function isTabbedNavigation(navigation2) {
-  return Array.isArray(navigation2) && navigation2.length > 0 && navigation2[0]?.tab != null;
-}
-
 // ../yaml/docs-validator/lib/rules/valid-docs-endpoints/valid-docs-endpoints.js
 var ValidDocsEndpoints = {
   name: "valid-docs-endpoints",
@@ -843477,8 +843361,7 @@ var allRules = [
   ValidDocsEndpoints,
   AllRolesMustBeDeclaredRule,
   ValidFrontmatter,
-  TranslationDirectoriesExistRule,
-  ValidChangelogSlugRule
+  TranslationDirectoriesExistRule
   // ValidMarkdownFileReferences
 ];
 function getAllRules3(exclusions) {
@@ -843507,8 +843390,7 @@ var CHECK_RULE_CONFIG_TO_RULE_NAME = {
   validLocalReferences: ValidLocalReferencesRule.name,
   noCircularRedirects: NoCircularRedirectsRule.name,
   validDocsEndpoints: ValidDocsEndpoints.name,
-  missingRedirects: MissingRedirectsRule.name,
-  validChangelogSlug: ValidChangelogSlugRule.name
+  missingRedirects: MissingRedirectsRule.name
 };
 function buildSeverityOverrides(checkConfig) {
   const severityOverrides = /* @__PURE__ */ new Map();
@@ -847588,7 +847470,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.8.1-6-g373abe1fdc5";
+  const version7 = "5.9.0-rc.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -856375,16 +856257,6 @@ var definitions6 = {
             type: "null"
           }
         ]
-      },
-      "valid-changelog-slug": {
-        oneOf: [
-          {
-            $ref: "#/definitions/docs.CheckRuleSeverity"
-          },
-          {
-            type: "null"
-          }
-        ]
       }
     },
     additionalProperties: false
@@ -860241,7 +860113,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.8.1-6-g373abe1fdc5",
+        cliVersion: "5.9.0-rc.0",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -934683,7 +934555,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.8.1-6-g373abe1fdc5";
+    return "5.9.0-rc.0";
   }
   getCliName() {
     if (false) {
@@ -937195,22 +937067,31 @@ function countResults(results) {
   }
   return { succeeded, failed, skipped };
 }
-function buildGeneratorsYmlUrl(absolutePath, lineNumber) {
+function resolveGithubWorkspaceRelativePath(absolutePath) {
   if (absolutePath == null) {
     return null;
   }
-  const serverUrl = process.env.GITHUB_SERVER_URL;
-  const repository = process.env.GITHUB_REPOSITORY;
-  const refName = process.env.GITHUB_REF_NAME;
   const workspace = process.env.GITHUB_WORKSPACE;
-  if (serverUrl == null || repository == null || refName == null || workspace == null) {
+  if (workspace == null) {
     return null;
   }
   const workspaceWithSlash = workspace.endsWith("/") ? workspace : `${workspace}/`;
   if (!absolutePath.startsWith(workspaceWithSlash)) {
     return null;
   }
-  const relativePath = absolutePath.slice(workspaceWithSlash.length);
+  return absolutePath.slice(workspaceWithSlash.length);
+}
+function buildGeneratorsYmlUrl(absolutePath, lineNumber) {
+  const relativePath = resolveGithubWorkspaceRelativePath(absolutePath);
+  if (relativePath == null) {
+    return null;
+  }
+  const serverUrl = process.env.GITHUB_SERVER_URL;
+  const repository = process.env.GITHUB_REPOSITORY;
+  const refName = process.env.GITHUB_REF_NAME;
+  if (serverUrl == null || repository == null || refName == null) {
+    return null;
+  }
   const anchor = lineNumber != null ? `#L${lineNumber}` : "";
   return `${serverUrl}/${repository}/blob/${refName}/${relativePath}${anchor}`;
 }
@@ -937230,7 +937111,9 @@ var GeneratorRunCollector = class {
       errorMessage: null,
       durationMs: args.durationMs,
       sdkRepoUrl: args.outputRepoUrl ?? null,
-      generatorsYmlUrl: buildGeneratorsYmlUrl(args.generatorsYmlAbsolutePath, args.generatorsYmlLineNumber)
+      generatorsYmlUrl: buildGeneratorsYmlUrl(args.generatorsYmlAbsolutePath, args.generatorsYmlLineNumber),
+      generatorsYmlWorkspaceRelativePath: resolveGithubWorkspaceRelativePath(args.generatorsYmlAbsolutePath),
+      generatorsYmlLineNumber: args.generatorsYmlLineNumber ?? null
     });
   }
   recordFailure(args) {
@@ -937247,7 +937130,9 @@ var GeneratorRunCollector = class {
       errorMessage: args.errorMessage,
       durationMs: args.durationMs,
       sdkRepoUrl: args.outputRepoUrl ?? null,
-      generatorsYmlUrl: buildGeneratorsYmlUrl(args.generatorsYmlAbsolutePath, args.generatorsYmlLineNumber)
+      generatorsYmlUrl: buildGeneratorsYmlUrl(args.generatorsYmlAbsolutePath, args.generatorsYmlLineNumber),
+      generatorsYmlWorkspaceRelativePath: resolveGithubWorkspaceRelativePath(args.generatorsYmlAbsolutePath),
+      generatorsYmlLineNumber: args.generatorsYmlLineNumber ?? null
     });
   }
   recordSkipped(args) {
@@ -937264,7 +937149,9 @@ var GeneratorRunCollector = class {
       errorMessage: null,
       durationMs: 0,
       sdkRepoUrl: args.outputRepoUrl ?? null,
-      generatorsYmlUrl: buildGeneratorsYmlUrl(args.generatorsYmlAbsolutePath, args.generatorsYmlLineNumber)
+      generatorsYmlUrl: buildGeneratorsYmlUrl(args.generatorsYmlAbsolutePath, args.generatorsYmlLineNumber),
+      generatorsYmlWorkspaceRelativePath: resolveGithubWorkspaceRelativePath(args.generatorsYmlAbsolutePath),
+      generatorsYmlLineNumber: args.generatorsYmlLineNumber ?? null
     });
   }
   results() {
@@ -937278,6 +937165,55 @@ var GeneratorRunCollector = class {
   }
 };
 
+// src/commands/automations/generate/renderGithubAnnotationsForResults.ts
+var GITHUB_ACTIONS_ANNOTATIONS_PER_LEVEL_CAP = 10;
+function renderGithubAnnotationsForResults(results) {
+  if (!shouldEmitGithubAnnotations()) {
+    return "";
+  }
+  const lines = [];
+  let failureCount = 0;
+  for (const result of results) {
+    if (result.status !== "failed") {
+      continue;
+    }
+    failureCount++;
+    const annotation = renderAnnotationForFailure(result);
+    if (annotation != null) {
+      lines.push(annotation);
+    }
+  }
+  const overflow = renderOverflowWarning(failureCount);
+  if (overflow != null) {
+    lines.push(overflow);
+  }
+  return lines.join("");
+}
+function renderAnnotationForFailure(result) {
+  const body = result.errorMessage ?? "Generator failed";
+  const title2 = buildTitle(result);
+  const file4 = result.generatorsYmlWorkspaceRelativePath ?? void 0;
+  const line = file4 != null ? result.generatorsYmlLineNumber ?? void 0 : void 0;
+  return renderGithubAnnotation("error", body, { title: title2, file: file4, line });
+}
+function buildTitle(result) {
+  const qualifiers = [`group=${result.groupName}`];
+  if (result.apiName != null && result.apiName.length > 0) {
+    qualifiers.push(`api=${result.apiName}`);
+  }
+  return `${result.generatorName} failed (${qualifiers.join(", ")})`;
+}
+function renderOverflowWarning(failureCount) {
+  if (failureCount <= GITHUB_ACTIONS_ANNOTATIONS_PER_LEVEL_CAP) {
+    return void 0;
+  }
+  const suppressed = failureCount - GITHUB_ACTIONS_ANNOTATIONS_PER_LEVEL_CAP;
+  const body = `${suppressed} additional generator ${suppressed === 1 ? "failure was" : "failures were"} hidden by GitHub's per-step annotation cap. See the step summary table for the full list.`;
+  return renderGithubAnnotation("warning", body, {
+    title: `${failureCount} generators failed (showing first ${GITHUB_ACTIONS_ANNOTATIONS_PER_LEVEL_CAP})`
+  });
+}
+
 // src/commands/automations/generate/reportGenerateResults.ts
 init_lib4();
 var import_fs37 = require("fs");
@@ -937518,60 +937454,72 @@ async function executeAutomationsGenerate({
     }
     outputsFlushed = true;
     writeResultsSync({ results: collector.results(), jsonOutputPath });
+    emitStructuredAnnotations(collector);
   };
   process.once("SIGINT", flushOnSignal);
   process.once("SIGTERM", flushOnSignal);
   try {
-    await cliContext.runTask(async () => {
-      await generateAPIWorkspaces({
-        project: await loadProjectAndRegisterWorkspacesWithContext(cliContext, {
-          commandLineApiWorkspace: options2.api,
-          defaultToAllApiWorkspaces: true
-        }),
-        cliContext,
-        version: options2.version,
-        groupNames: options2.group != null ? [options2.group] : void 0,
-        generatorName,
-        generatorIndex,
-        shouldLogS3Url: false,
-        keepDocker: false,
-        useLocalDocker: false,
-        preview: false,
-        mode: void 0,
-        force: true,
-        runner: void 0,
-        inspect: false,
-        lfsOverride: void 0,
-        fernignorePath: void 0,
-        skipFernignore: false,
-        dynamicIrOnly: false,
-        outputDir: void 0,
-        noReplay: false,
-        retryRateLimited: false,
-        requireEnvVars: false,
-        automationMode: true,
-        autoMerge: options2.autoMerge,
-        skipIfNoDiff: true,
-        automation: { recorder: collector }
-      });
+    await withSuppressedLoggerAnnotations(async () => {
+      try {
+        await cliContext.runTask(async () => {
+          await generateAPIWorkspaces({
+            project: await loadProjectAndRegisterWorkspacesWithContext(cliContext, {
+              commandLineApiWorkspace: options2.api,
+              defaultToAllApiWorkspaces: true
+            }),
+            cliContext,
+            version: options2.version,
+            groupNames: options2.group != null ? [options2.group] : void 0,
+            generatorName,
+            generatorIndex,
+            shouldLogS3Url: false,
+            keepDocker: false,
+            useLocalDocker: false,
+            preview: false,
+            mode: void 0,
+            force: true,
+            runner: void 0,
+            inspect: false,
+            lfsOverride: void 0,
+            fernignorePath: void 0,
+            skipFernignore: false,
+            dynamicIrOnly: false,
+            outputDir: void 0,
+            noReplay: false,
+            retryRateLimited: false,
+            requireEnvVars: false,
+            automationMode: true,
+            autoMerge: options2.autoMerge,
+            skipIfNoDiff: true,
+            automation: { recorder: collector }
+          });
+        });
+      } catch (error50) {
+        if (!(error50 instanceof TaskAbortSignal)) {
+          throw error50;
+        }
+        taskAborted = true;
+      }
     });
-  } catch (error50) {
-    if (!(error50 instanceof TaskAbortSignal)) {
-      throw error50;
-    }
-    taskAborted = true;
   } finally {
     process.off("SIGINT", flushOnSignal);
     process.off("SIGTERM", flushOnSignal);
     if (!outputsFlushed) {
       outputsFlushed = true;
       await reportFinalOutputs({ collector, jsonOutputPath, taskAborted });
+      emitStructuredAnnotations(collector);
     }
     if (collector.hasFailures()) {
       process.exitCode = 1;
     }
   }
 }
+function emitStructuredAnnotations(collector) {
+  const annotations = renderGithubAnnotationsForResults(collector.results());
+  if (annotations.length > 0) {
+    process.stdout.write(annotations);
+  }
+}
 async function reportFinalOutputs({
   collector,
   jsonOutputPath,

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "5.8.1-6-g373abe1fdc5",
+  "version": "5.9.0-rc.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",