@fern-api/fern-api-dev 5.8.1 → 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
@@ -574075,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 }) {
@@ -574820,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;
@@ -574828,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() {
@@ -622586,7 +622670,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.8.1",
+          version: "5.9.0-rc.0",
           usingAccessToken: true
         }
       });
@@ -622640,7 +622724,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.8.1",
+        version: "5.9.0-rc.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -628943,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;
@@ -819756,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,
@@ -819774,8 +819856,6 @@ __export(rules_exports, {
   ValidateProductFileRule: () => ValidateProductFileRule,
   ValidateVersionFileRule: () => ValidateVersionFileRule,
   enforceBackgroundTheme: () => enforceBackgroundTheme,
-  getEffectiveChangelogSlugLastSegment: () => getEffectiveChangelogSlugLastSegment,
-  isAllowedChangelogSlug: () => isAllowedChangelogSlug,
   validateTheme: () => validateTheme
 });
 
@@ -820802,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",
@@ -843423,8 +843361,7 @@ var allRules = [
   ValidDocsEndpoints,
   AllRolesMustBeDeclaredRule,
   ValidFrontmatter,
-  TranslationDirectoriesExistRule,
-  ValidChangelogSlugRule
+  TranslationDirectoriesExistRule
   // ValidMarkdownFileReferences
 ];
 function getAllRules3(exclusions) {
@@ -843453,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();
@@ -847534,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";
+  const version7 = "5.9.0-rc.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -856321,16 +856257,6 @@ var definitions6 = {
             type: "null"
           }
         ]
-      },
-      "valid-changelog-slug": {
-        oneOf: [
-          {
-            $ref: "#/definitions/docs.CheckRuleSeverity"
-          },
-          {
-            type: "null"
-          }
-        ]
       }
     },
     additionalProperties: false
@@ -860187,7 +860113,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.8.1",
+        cliVersion: "5.9.0-rc.0",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -934629,7 +934555,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.8.1";
+    return "5.9.0-rc.0";
   }
   getCliName() {
     if (false) {
@@ -937141,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}`;
 }
@@ -937176,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) {
@@ -937193,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) {
@@ -937210,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() {
@@ -937224,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");
@@ -937464,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",
+  "version": "5.9.0-rc.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",