@fern-api/fern-api-dev 4.107.0 → 4.107.2-1-g488c64ae1ff

package/cli.cjs

@@ -340394,9 +340394,9 @@ var require_diff3 = __commonJS({
   }
 });
 
-// ../../../node_modules/.pnpm/@fern-api+replay@0.12.0/node_modules/@fern-api/replay/dist/index.cjs
+// ../../../node_modules/.pnpm/@fern-api+replay@0.13.0/node_modules/@fern-api/replay/dist/index.cjs
 var require_dist14 = __commonJS({
-  "../../../node_modules/.pnpm/@fern-api+replay@0.12.0/node_modules/@fern-api/replay/dist/index.cjs"(exports2, module4) {
+  "../../../node_modules/.pnpm/@fern-api+replay@0.13.0/node_modules/@fern-api/replay/dist/index.cjs"(exports2, module4) {
     "use strict";
     var __defProp4 = Object.defineProperty;
     var __getOwnPropDesc4 = Object.getOwnPropertyDescriptor;
@@ -341136,17 +341136,57 @@ var require_dist14 = __commonJS({
         }
         const isAncestor = await this.git.isAncestor(lastGen.commit_sha, "HEAD");
         if (!isAncestor) {
+          return this.detectPatchesViaMergeBase(lastGen, lock);
+        }
+        return this.detectPatchesInRange(lastGen.commit_sha, lastGen, lock);
+      }
+      /**
+       * FER-10201 — Non-linear-history detection via `merge-base(prevGen, HEAD)`.
+       *
+       * After a squash-merge of a Fern-bot PR, `lastGen.commit_sha` (the previous
+       * `[fern-generated]`) is orphaned but still in git's object database. The
+       * merge-base is the commit on main from which the bot's branch was created —
+       * a reachable ancestor of HEAD. Walking that range and classifying each
+       * commit via `isGenerationCommit` mirrors the linear path and eliminates
+       * the bug class where pipeline-driven changes (autoversion, replay,
+       * generation) get bundled as customer customizations.
+       *
+       * Falls through to the legacy composite path when no common ancestor exists
+       * (truly disjoint history — orphan branches with no shared root).
+       */
+      async detectPatchesViaMergeBase(lastGen, lock) {
+        let mergeBase = "";
+        try {
+          mergeBase = (await this.git.exec(["merge-base", lastGen.commit_sha, "HEAD"])).trim();
+        } catch {
+        }
+        if (!mergeBase) {
+          this.warnings.push(
+            `No common ancestor between previous generation ${lastGen.commit_sha.slice(0, 7)} and HEAD. Falling back to composite tree-diff detection.`
+          );
           return this.detectPatchesViaTreeDiff(
             lastGen,
             /* commitKnownMissing */
             false
           );
         }
+        return this.detectPatchesInRange(mergeBase, lastGen, lock);
+      }
+      /**
+       * FER-10201 — Walk `${rangeStart}..HEAD`, classify each commit, emit one
+       * `StoredPatch` per customer commit. Body shared by the linear path
+       * (rangeStart = lastGen.commit_sha) and the merge-base path.
+       *
+       * Patch `base_generation` is always `lastGen.commit_sha` — the
+       * lockfile-tracked reference the applicator uses to fetch base file
+       * content, regardless of where the walk actually started.
+       */
+      async detectPatchesInRange(rangeStart, lastGen, lock) {
         const log4 = await this.git.exec([
           "log",
           "--first-parent",
           "--format=%H%x00%an%x00%ae%x00%s",
-          `${lastGen.commit_sha}..HEAD`,
+          `${rangeStart}..HEAD`,
           "--",
           this.sdkOutputDir
         ]);
@@ -477410,7 +477450,8 @@ var USER_ENVIRONMENT_ERRNOS = /* @__PURE__ */ new Set([
   "EROFS",
   "EMFILE",
   "ENFILE",
-  "EBUSY"
+  "EBUSY",
+  "EADDRINUSE"
 ]);
 var NETWORK_ERRNOS = /* @__PURE__ */ new Set([
   "ENOTFOUND",
@@ -543570,6 +543611,7 @@ function parseVariantOverlays(variants) {
 }
 
 // ../configuration-loader/lib/fern-config-json/loadProjectConfig.js
+init_lib4();
 init_lib6();
 var import_promises15 = require("fs/promises");
 
@@ -543584,7 +543626,15 @@ var ProjectConfigSchema = external_exports2.strictObject({
 async function loadProjectConfig({ directory, context: context3 }) {
   const pathToConfig = join8(directory, RelativeFilePath2.of(PROJECT_CONFIG_FILENAME));
   const projectConfigStr = await (0, import_promises15.readFile)(pathToConfig);
-  const projectConfigParsed = JSON.parse(projectConfigStr.toString());
+  let projectConfigParsed;
+  try {
+    projectConfigParsed = JSON.parse(projectConfigStr.toString());
+  } catch (error50) {
+    throw new CliError({
+      message: `Failed to parse ${PROJECT_CONFIG_FILENAME}: ${extractErrorMessage(error50)}`,
+      code: CliError.Code.ParseError
+    });
+  }
   const rawProjectConfig = await validateSchema({
     schema: ProjectConfigSchema,
     value: projectConfigParsed,
@@ -599468,6 +599518,9 @@ async function parseOpenAPI({ absolutePathToOpenAPI, absolutePathToOpenAPIOverri
           `Continuing without full reference resolution.`
         ].join("\n"));
       }
+      if (circularRefs.length > 0) {
+        breakCircularRefCycles(document4, circularRefs);
+      }
       return document4;
     }
     throw error50;
@@ -599481,6 +599534,50 @@ async function readAndParseFile2(absoluteFilePath) {
   }
   return jsYaml.load(contents);
 }
+function breakCircularRefCycles(document4, circularRefs) {
+  if (typeof document4 !== "object" || document4 == null) {
+    return;
+  }
+  const backEdgeRefs = /* @__PURE__ */ new Set();
+  for (const info of circularRefs) {
+    if (info.ref.startsWith("#/")) {
+      backEdgeRefs.add(info.ref);
+    }
+  }
+  replaceCircularRefs(document4, backEdgeRefs);
+}
+function replaceCircularRefs(obj, targets2) {
+  if (typeof obj !== "object" || obj == null) {
+    return;
+  }
+  if (Array.isArray(obj)) {
+    for (let i9 = 0; i9 < obj.length; i9++) {
+      const item = obj[i9];
+      if (isCircularRefObject(item, targets2)) {
+        obj[i9] = { type: "object", "x-fern-circular-ref": true };
+      } else {
+        replaceCircularRefs(item, targets2);
+      }
+    }
+    return;
+  }
+  const record22 = obj;
+  for (const key2 of Object.keys(record22)) {
+    const value2 = record22[key2];
+    if (isCircularRefObject(value2, targets2)) {
+      record22[key2] = { type: "object", "x-fern-circular-ref": true };
+    } else {
+      replaceCircularRefs(value2, targets2);
+    }
+  }
+}
+function isCircularRefObject(value2, targets2) {
+  if (typeof value2 !== "object" || value2 == null || Array.isArray(value2)) {
+    return false;
+  }
+  const record22 = value2;
+  return typeof record22.$ref === "string" && targets2.has(record22.$ref);
+}
 
 // ../workspace/lazy-fern-workspace/lib/utils/resolveDescriptionMarkdownRefs.js
 init_lib4();
@@ -612683,6 +612780,16 @@ function collapseSpecBooleanSetting(specs, getter) {
   }
   return values2.every((v9) => v9 == null || v9 === true);
 }
+function toRelativePath(raw, field5) {
+  try {
+    return RelativeFilePath2.of(raw);
+  } catch {
+    throw new CliError({
+      message: `"${field5}: ${raw}" must be a relative path, not an absolute one.`,
+      code: CliError.Code.ConfigError
+    });
+  }
+}
 function convertRemoveDiscriminantsFromSchemas(specs) {
   if (specs.every((spec) => spec.settings?.removeDiscriminantsFromSchemas === generators_yml_exports.RemoveDiscriminantsFromSchemas.Never)) {
     return generators_yml_exports.RemoveDiscriminantsFromSchemas.Never;
@@ -613078,20 +613185,20 @@ var OSSWorkspace = class _OSSWorkspace extends BaseOpenAPIWorkspace {
     const specs = [];
     for (const spec of specsOverride) {
       if (generators_yml_exports.isOpenApiSpecSchema(spec)) {
-        const absoluteFilepath = join8(this.absoluteFilePath, RelativeFilePath2.of(spec.openapi));
+        const absoluteFilepath = join8(this.absoluteFilePath, toRelativePath(spec.openapi, "openapi"));
         let absoluteFilepathToOverrides;
         const specOverridePaths = [];
         if (spec.overrides != null) {
           if (Array.isArray(spec.overrides)) {
-            specOverridePaths.push(...spec.overrides.map((override) => join8(this.absoluteFilePath, RelativeFilePath2.of(override))));
+            specOverridePaths.push(...spec.overrides.map((override) => join8(this.absoluteFilePath, toRelativePath(override, "overrides"))));
           } else {
-            specOverridePaths.push(join8(this.absoluteFilePath, RelativeFilePath2.of(spec.overrides)));
+            specOverridePaths.push(join8(this.absoluteFilePath, toRelativePath(spec.overrides, "overrides")));
           }
         }
         if (specOverridePaths.length > 0) {
           absoluteFilepathToOverrides = specOverridePaths.length === 1 ? specOverridePaths[0] : specOverridePaths;
         }
-        const absoluteFilepathToOverlays = spec.overlays ? join8(this.absoluteFilePath, RelativeFilePath2.of(spec.overlays)) : void 0;
+        const absoluteFilepathToOverlays = spec.overlays ? join8(this.absoluteFilePath, toRelativePath(spec.overlays, "overlays")) : void 0;
         const openApiSpec = {
           type: "openapi",
           absoluteFilepath,
@@ -621265,7 +621372,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "4.107.0",
+          version: "4.107.2-1-g488c64ae1ff",
           usingAccessToken: true
         }
       });
@@ -621319,7 +621426,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "4.107.0",
+        version: "4.107.2-1-g488c64ae1ff",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -799313,7 +799420,10 @@ var DocsDefinitionResolver = class {
         }
       } catch (error50) {
         this.taskContext.logger.error(`Failed to parse ${relativePath}: ${extractErrorMessage(error50)}`);
-        throw error50;
+        throw new CliError({
+          message: `Failed to parse markdown file ${relativePath}: ${extractErrorMessage(error50)}`,
+          code: CliError.Code.ParseError
+        });
       }
     }
     const imageParseTime = performance.now() - imageParseStart;
@@ -832962,7 +833072,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 = "4.107.0";
+  const version7 = "4.107.2-1-g488c64ae1ff";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -833985,10 +834095,19 @@ async function getPreviewDocsDefinition({ domain: domain3, project, context: con
         absolutePathToFernFolder: docsWorkspace.absoluteFilePath,
         absolutePathToMarkdownFile: absoluteFilePath
       });
-      const { markdown: markdownWithAbsPaths, filepaths } = parseImagePaths(markdownReplacedMdAndCode, {
-        absolutePathToFernFolder: docsWorkspace.absoluteFilePath,
-        absolutePathToMarkdownFile: absoluteFilePath
-      });
+      let markdownWithAbsPaths;
+      let filepaths;
+      try {
+        ({ markdown: markdownWithAbsPaths, filepaths } = parseImagePaths(markdownReplacedMdAndCode, {
+          absolutePathToFernFolder: docsWorkspace.absoluteFilePath,
+          absolutePathToMarkdownFile: absoluteFilePath
+        }));
+      } catch (error50) {
+        throw new CliError({
+          message: `Failed to parse markdown in ${absoluteFilePath}: ${extractErrorMessage(error50)}`,
+          code: CliError.Code.ParseError
+        });
+      }
       if (previousDocsDefinition.filesV2 == null) {
         previousDocsDefinition.filesV2 = {};
       }
@@ -845371,7 +845490,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "4.107.0",
+        cliVersion: "4.107.2-1-g488c64ae1ff",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -873709,28 +873828,28 @@ var STRING_TYPE_REFERENCE = {
   type: "primitive",
   value: "STRING"
 };
-function unwrapOptionalFromListItems(typeReference2) {
+function stripOptionalAndNullable(item) {
+  let current3 = item;
+  while (current3.type === "optional" || current3.type === "nullable") {
+    current3 = current3.value;
+  }
+  return current3;
+}
+function stripListItemWrappers(typeReference2) {
   if (typeReference2.type === "optional" && typeReference2.value.type === "list") {
-    const listType = typeReference2.value;
-    const itemType = listType.value;
-    if (itemType.type === "optional") {
-      return {
-        type: "optional",
-        value: {
-          type: "list",
-          value: itemType.value
-        }
-      };
+    const itemType = typeReference2.value.value;
+    const stripped = stripOptionalAndNullable(itemType);
+    if (stripped === itemType) {
+      return typeReference2;
     }
+    return { type: "optional", value: { type: "list", value: stripped } };
   }
   if (typeReference2.type === "list") {
-    const itemType = typeReference2.value;
-    if (itemType.type === "optional") {
-      return {
-        type: "list",
-        value: itemType.value
-      };
+    const stripped = stripOptionalAndNullable(typeReference2.value);
+    if (stripped === typeReference2.value) {
+      return typeReference2;
     }
+    return { type: "list", value: stripped };
   }
   return typeReference2;
 }
@@ -874246,9 +874365,7 @@ var EndpointSnippetGenerator4 = class {
     const queryParameterFields = sortedQueryParameters.map((queryParameter) => ({
       name: this.context.getMethodName(queryParameter.name.name),
       value: this.context.dynamicTypeLiteralMapper.convert({
-        // Unwrap optional from list items for allow-multiple query params.
-        // Java SDK builders have convenience overloads that accept List<T>.
-        typeReference: unwrapOptionalFromListItems(queryParameter.typeReference),
+        typeReference: stripListItemWrappers(queryParameter.typeReference),
         value: queryParameter.value,
         as: "request"
       })
@@ -881444,52 +881561,6 @@ var Begin = class extends AstNode6 {
   }
 };
 
-// ../../../generators/ruby-v2/ast/lib/ast/IfElse.js
-var IfElse = class extends AstNode6 {
-  ifBranch;
-  elseIfs;
-  elseBody;
-  constructor({ if: ifBranch, elseIf, elseBody }) {
-    super();
-    this.ifBranch = ifBranch;
-    this.elseIfs = elseIf ?? [];
-    this.elseBody = elseBody ? Array.isArray(elseBody) ? elseBody : [elseBody] : void 0;
-  }
-  write(writer2) {
-    writer2.write("if ");
-    this.ifBranch.condition.write(writer2);
-    writer2.writeLine();
-    writer2.indent();
-    for (const stmt of this.ifBranch.thenBody) {
-      stmt.write(writer2);
-      writer2.writeNewLineIfLastLineNot();
-    }
-    writer2.dedent();
-    for (const elseIf of this.elseIfs) {
-      writer2.write("elsif ");
-      elseIf.condition.write(writer2);
-      writer2.writeLine();
-      writer2.indent();
-      for (const stmt of elseIf.thenBody) {
-        stmt.write(writer2);
-        writer2.writeNewLineIfLastLineNot();
-      }
-      writer2.dedent();
-    }
-    if (this.elseBody && this.elseBody.length > 0) {
-      writer2.writeLine("else");
-      writer2.indent();
-      for (const stmt of this.elseBody) {
-        stmt.write(writer2);
-        writer2.writeNewLineIfLastLineNot();
-      }
-      writer2.dedent();
-    }
-    writer2.write("end");
-    writer2.writeNewLineIfLastLineNot();
-  }
-};
-
 // ../../../generators/ruby-v2/ast/lib/ast/Comment.js
 var MAX_LINE_LENGTH2 = 120;
 var COMMENT_PREFIX_LENGTH = 2;
@@ -881504,7 +881575,8 @@ var Comment6 = class extends AstNode6 {
       this.docs.split("\n").forEach((line) => {
         const wrappedLines = this.wrapLine(line, writer2);
         wrappedLines.forEach((wrappedLine) => {
-          writer2.writeLine(`# ${wrappedLine}`);
+          const trimmed2 = wrappedLine.trimEnd();
+          writer2.writeLine(trimmed2 === "" ? "#" : `# ${trimmed2}`);
         });
       });
     }
@@ -882136,19 +882208,20 @@ var Class_ = class extends Module_ {
       writer2.writeLine("; end");
       return;
     }
-    if (this.statements.length) {
+    if (this.statements.length || this.methods.length) {
       writer2.newLine();
       writer2.indent();
       this.statements.forEach((statement, index3) => {
         statement.write(writer2);
-        writer2.newLine();
+        writer2.writeNewLineIfLastLineNot();
+        if (index3 < this.statements.length - 1) {
+          writer2.newLine();
+        }
       });
-      writer2.dedent();
-    }
-    if (this.methods.length) {
-      writer2.newLine();
-      writer2.indent();
-      this.methods.forEach((method8) => {
+      this.methods.forEach((method8, index3) => {
+        if (index3 > 0 || this.statements.length > 0) {
+          writer2.newLine();
+        }
         method8.write(writer2);
       });
       writer2.dedent();
@@ -882186,6 +882259,112 @@ var Class_ = class extends Module_ {
   }
 };
 
+// ../../../generators/ruby-v2/ast/lib/ast/IfElse.js
+var IfElse = class extends AstNode6 {
+  ifBranch;
+  elseIfs;
+  elseBody;
+  constructor({ if: ifBranch, elseIf, elseBody }) {
+    super();
+    this.ifBranch = ifBranch;
+    this.elseIfs = elseIf ?? [];
+    this.elseBody = elseBody ? Array.isArray(elseBody) ? elseBody : [elseBody] : void 0;
+  }
+  write(writer2) {
+    const modifier = this.renderAsModifier(writer2);
+    if (modifier != null) {
+      writer2.write(modifier);
+      writer2.writeNewLineIfLastLineNot();
+      return;
+    }
+    writer2.write("if ");
+    this.ifBranch.condition.write(writer2);
+    writer2.writeLine();
+    writer2.indent();
+    for (const stmt of this.ifBranch.thenBody) {
+      stmt.write(writer2);
+      writer2.writeNewLineIfLastLineNot();
+    }
+    writer2.dedent();
+    for (const elseIf of this.elseIfs) {
+      writer2.write("elsif ");
+      elseIf.condition.write(writer2);
+      writer2.writeLine();
+      writer2.indent();
+      for (const stmt of elseIf.thenBody) {
+        stmt.write(writer2);
+        writer2.writeNewLineIfLastLineNot();
+      }
+      writer2.dedent();
+    }
+    if (this.elseBody && this.elseBody.length > 0) {
+      writer2.writeLine("else");
+      writer2.indent();
+      for (const stmt of this.elseBody) {
+        stmt.write(writer2);
+        writer2.writeNewLineIfLastLineNot();
+      }
+      writer2.dedent();
+    }
+    writer2.write("end");
+    writer2.writeNewLineIfLastLineNot();
+  }
+  /**
+   * Returns the modifier-form rendering (`stmt if cond`) when this if is
+   * eligible:
+   *   - exactly one statement in the then-body
+   *   - no elsif and no else
+   *   - the single statement is not an intrinsically multi-line AST node
+   *     (Class, Module, Method, Begin, IfElse)
+   *   - the rendered statement and condition each fit on a single line
+   *
+   * Returns undefined when the shape isn't eligible, in which case the caller
+   * falls back to explicit if/end form.
+   *
+   * The generator's .rubocop.yml disables Layout/LineLength, so rubocop's
+   * Style/IfUnlessModifier accepts modifier form at any line length. Shape
+   * eligibility is therefore sufficient; we don't gate on a max-line-length
+   * budget here.
+   */
+  renderAsModifier(writer2) {
+    if (this.ifBranch.thenBody.length !== 1) {
+      return void 0;
+    }
+    if (this.elseIfs.length > 0) {
+      return void 0;
+    }
+    if (this.elseBody != null && this.elseBody.length > 0) {
+      return void 0;
+    }
+    const stmt = this.ifBranch.thenBody[0];
+    if (stmt == null) {
+      return void 0;
+    }
+    if (isKnownMultiLineNode(stmt) || isKnownMultiLineNode(this.ifBranch.condition)) {
+      return void 0;
+    }
+    const stmtRendered = renderNode(stmt, writer2);
+    const conditionRendered = renderNode(this.ifBranch.condition, writer2);
+    if (stmtRendered.length === 0 || conditionRendered.length === 0) {
+      return void 0;
+    }
+    if (stmtRendered.includes("\n") || conditionRendered.includes("\n")) {
+      return void 0;
+    }
+    return `${stmtRendered} if ${conditionRendered}`;
+  }
+};
+function isKnownMultiLineNode(node4) {
+  return node4 instanceof Class_ || node4 instanceof Module_ || node4 instanceof Method6 || node4 instanceof Begin || node4 instanceof IfElse;
+}
+function renderNode(node4, parentWriter) {
+  const rendered = node4.toString({
+    customConfig: parentWriter.customConfig,
+    formatter: parentWriter.formatter
+  });
+  return rendered.replace(/\n+$/, "");
+}
+
 // ../../../generators/ruby-v2/ast/lib/ast/ClassInstantiation.js
 var ClassInstantiation5 = class extends AstNode6 {
   classReference;
@@ -882446,9 +882625,36 @@ var TypeLiteral3 = class _TypeLiteral extends AstNode6 {
     super();
     this.internalType = internalType;
   }
+  /**
+   * Returns a stable string representation of this literal suitable for
+   * deduplicating hash keys (see Lint/DuplicateHashKey). Returns undefined
+   * for compound/dynamic shapes where value equality isn't decidable at
+   * emit time.
+   */
+  getDedupKey() {
+    switch (this.internalType.type) {
+      case "str":
+        return `str:${this.internalType.value}`;
+      case "interpolatedStr":
+        return `istr:${this.internalType.value}`;
+      case "int":
+        return `int:${this.internalType.value}`;
+      case "float":
+        return `float:${this.internalType.value}`;
+      case "bool":
+        return `bool:${this.internalType.value}`;
+      case "nil":
+        return "nil";
+      default:
+        return void 0;
+    }
+  }
   static string(value2) {
     return new this({ type: "str", value: value2 });
   }
+  static interpolatedString(value2) {
+    return new this({ type: "interpolatedStr", value: value2 });
+  }
   static integer(value2) {
     return new this({ type: "int", value: value2 });
   }
@@ -882485,6 +882691,11 @@ var TypeLiteral3 = class _TypeLiteral extends AstNode6 {
   write(writer2) {
     switch (this.internalType.type) {
       case "str": {
+        const value2 = this.internalType.value.replaceAll("\r\n", "\n");
+        writer2.write(`"${value2.replaceAll("\\", "\\\\").replaceAll('"', '\\"').replace(/#(?=[{$@])/g, "\\#")}"`);
+        break;
+      }
+      case "interpolatedStr": {
         const value2 = this.internalType.value.replaceAll("\r\n", "\n");
         writer2.write(`"${value2.replaceAll("\\", "\\\\").replaceAll('"', '\\"')}"`);
         break;
@@ -882502,7 +882713,21 @@ var TypeLiteral3 = class _TypeLiteral extends AstNode6 {
         break;
       }
       case "hash": {
-        const entries23 = this.internalType.entries.filter((entry) => !_TypeLiteral.isNop(entry.key) && !_TypeLiteral.isNop(entry.value));
+        const filteredEntries = this.internalType.entries.filter((entry) => !_TypeLiteral.isNop(entry.key) && !_TypeLiteral.isNop(entry.value));
+        const seenKeys = /* @__PURE__ */ new Map();
+        filteredEntries.forEach((entry, index3) => {
+          const rendered = renderKeyForDedup(entry.key);
+          if (rendered != null) {
+            seenKeys.set(rendered, index3);
+          }
+        });
+        const entries23 = filteredEntries.filter((entry, index3) => {
+          const rendered = renderKeyForDedup(entry.key);
+          if (rendered == null) {
+            return true;
+          }
+          return seenKeys.get(rendered) === index3;
+        });
         if (entries23.length === 0) {
           writer2.write("{}");
           break;
@@ -882582,6 +882807,12 @@ var TypeLiteral3 = class _TypeLiteral extends AstNode6 {
     }
   }
 };
+function renderKeyForDedup(key2) {
+  if (!(key2 instanceof TypeLiteral3)) {
+    return void 0;
+  }
+  return key2.getDedupKey();
+}
 
 // ../../../generators/ruby-v2/ast/lib/ast/TypeParameter.js
 var Variance;
@@ -883544,6 +883775,7 @@ var EndpointSnippetGenerator7 = class {
       invokeMethodArgs.keywordArguments = invokeMethodArgs.keywordArguments ?? [];
       invokeMethodArgs.keywordArguments.push(requestOptions);
     }
+    invokeMethodArgs.keywordArguments = dedupeKeywordArguments(invokeMethodArgs.keywordArguments);
     return ruby_exports.invokeMethod(invokeMethodArgs);
   }
   /**
@@ -883577,6 +883809,7 @@ var EndpointSnippetGenerator7 = class {
       invokeMethodArgs.keywordArguments = invokeMethodArgs.keywordArguments ?? [];
       invokeMethodArgs.keywordArguments.push(requestOptions);
     }
+    invokeMethodArgs.keywordArguments = dedupeKeywordArguments(invokeMethodArgs.keywordArguments);
     return ruby_exports.invokeMethod(invokeMethodArgs);
   }
   /**
@@ -883913,6 +884146,21 @@ var EndpointSnippetGenerator7 = class {
     return this.context.getMethodName(endpoint3.declaration.name);
   }
 };
+function dedupeKeywordArguments(kwargs) {
+  if (kwargs == null || kwargs.length <= 1) {
+    return kwargs;
+  }
+  const lastIndexByName = /* @__PURE__ */ new Map();
+  kwargs.forEach((arg, index3) => {
+    lastIndexByName.set(arg.name, index3);
+  });
+  const deduped = kwargs.filter((arg, index3) => lastIndexByName.get(arg.name) === index3);
+  if (deduped.length !== kwargs.length) {
+    const droppedNames = Array.from(new Set(kwargs.map((arg) => arg.name).filter((name2, index3) => lastIndexByName.get(name2) !== index3)));
+    console.warn(`[ruby-v2 dynamic-snippets] duplicate keyword argument name(s) [${droppedNames.join(", ")}] in a generated snippet; keeping last occurrence to match **params runtime behavior. This indicates a latent name collision in the Ruby SDK method signature that should be disambiguated at the generator level.`);
+  }
+  return deduped;
+}
 
 // ../../../generators/ruby-v2/dynamic-snippets/lib/DynamicSnippetsGenerator.js
 var DynamicSnippetsGenerator6 = class extends AbstractDynamicSnippetsGenerator {
@@ -919360,10 +919608,15 @@ function processGeneratorGroups(groups2, maybeApiName, logger4) {
   for (const [groupName, group] of Object.entries(groups2)) {
     for (const [generatorName, generatorVersions] of Object.entries(group)) {
       logger4.debug(`Checking if ${generatorName} in group ${groupName} has an upgrade available...`);
-      const isUpgradeAvailable = isVersionAhead(
-        generatorVersions.latestVersion,
-        generatorVersions.previousVersion
-      );
+      let isUpgradeAvailable;
+      try {
+        isUpgradeAvailable = isVersionAhead(generatorVersions.latestVersion, generatorVersions.previousVersion);
+      } catch {
+        throw new CliError({
+          message: `Generator "${generatorName}" has an invalid version "${generatorVersions.previousVersion}" in generators.yml. Use an exact version like 1.2.3.`,
+          code: CliError.Code.ConfigError
+        });
+      }
       logger4.debug(
         `Latest version: ${generatorVersions.latestVersion}. ` + (isUpgradeAvailable ? "Upgrade available." : "No upgrade available.")
       );
@@ -919472,7 +919725,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "4.107.0";
+    return "4.107.2-1-g488c64ae1ff";
   }
   getCliName() {
     if (false) {
@@ -928005,7 +928258,9 @@ async function resolvePreviewUrlFromId({
   const fernDirectory = await getFernDirectory();
   if (fernDirectory == null) {
     return cliContext.failAndThrow(
-      "No fern directory found. The --id flag requires a Fern project to resolve the organization.\nRun this command from within a Fern project directory, or use the URL argument instead."
+      "No fern directory found. The --id flag requires a Fern project to resolve the organization.\nRun this command from within a Fern project directory, or use the URL argument instead.",
+      void 0,
+      { code: CliError.Code.ValidationError }
     );
   }
   const projectConfig = await cliContext.runTask(
@@ -930898,6 +931153,7 @@ async function formatWorkspaces({
 }
 
 // src/commands/generate/generateDocsWorkspace.ts
+init_lib4();
 init_js();
 
 // src/utils/environment.ts
@@ -931099,27 +931355,35 @@ ${source_default.yellow("?")} Are you sure you want to continue?`,
       errorOnBrokenLinks: strictBrokenLinks,
       excludeRules: getExcludeRules(brokenLinks, strictBrokenLinks)
     });
+    const skippedWorkspacePaths = /* @__PURE__ */ new Set();
     const ossWorkspacesForValidation = await filterOssWorkspaces(project);
     for (const ossWorkspace of ossWorkspacesForValidation) {
-      const violations = await validateOSSWorkspace(ossWorkspace, context3);
-      const errors4 = violations.filter((v9) => v9.severity === "fatal" || v9.severity === "error");
-      if (errors4.length > 0) {
-        for (const error50 of errors4) {
-          context3.logger.error(`${error50.relativeFilepath}: ${error50.message}`);
+      try {
+        const violations = await validateOSSWorkspace(ossWorkspace, context3);
+        const errors4 = violations.filter((v9) => v9.severity === "fatal" || v9.severity === "error");
+        if (errors4.length > 0) {
+          for (const error50 of errors4) {
+            context3.logger.warn(`${error50.relativeFilepath}: ${error50.message}`);
+          }
+          context3.logger.warn(
+            `Skipping API workspace at ${ossWorkspace.absoluteFilePath} due to ${errors4.length} validation error${errors4.length !== 1 ? "s" : ""}. Run fern check for details.`
+          );
+          skippedWorkspacePaths.add(ossWorkspace.absoluteFilePath);
         }
-        context3.failAndThrow(
-          `OpenAPI spec validation failed with ${errors4.length} error${errors4.length !== 1 ? "s" : ""}. Fix the errors above before generating docs.`,
-          void 0,
-          { code: CliError.Code.ValidationError }
+      } catch (error50) {
+        context3.logger.warn(
+          `Skipping API workspace at ${ossWorkspace.absoluteFilePath}: ${extractErrorMessage(error50)}`
         );
+        skippedWorkspacePaths.add(ossWorkspace.absoluteFilePath);
       }
     }
     context3.logger.info("Validation complete, starting remote docs generation...");
     const filterStart = performance.now();
-    const ossWorkspaces = await filterOssWorkspaces(project);
+    const allOssWorkspaces = await filterOssWorkspaces(project);
+    const ossWorkspaces = allOssWorkspaces.filter((ws5) => !skippedWorkspacePaths.has(ws5.absoluteFilePath));
     const filterTime = performance.now() - filterStart;
     context3.logger.debug(
-      `Filtered OSS workspaces (${ossWorkspaces.length} workspaces) in ${filterTime.toFixed(0)}ms`
+      `Filtered OSS workspaces (${ossWorkspaces.length} workspaces, ${skippedWorkspacePaths.size} skipped) in ${filterTime.toFixed(0)}ms`
     );
     const generationStart = performance.now();
     await runRemoteGenerationForDocsWorkspace({

package/package.json

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