@fern-api/fern-api-dev 4.71.6 → 4.72.0-1-g2825b1479c3

package/cli.cjs

@@ -68360,8 +68360,8 @@ var require_graceful_fs = __commonJS({
       fs30.createReadStream = createReadStream5;
       fs30.createWriteStream = createWriteStream7;
       var fs$readFile = fs30.readFile;
-      fs30.readFile = readFile102;
-      function readFile102(path97, options2, cb2) {
+      fs30.readFile = readFile103;
+      function readFile103(path97, options2, cb2) {
         if (typeof options2 === "function")
           cb2 = options2, options2 = null;
         return go$readFile(path97, options2, cb2);
@@ -68377,8 +68377,8 @@ var require_graceful_fs = __commonJS({
         }
       }
       var fs$writeFile = fs30.writeFile;
-      fs30.writeFile = writeFile89;
-      function writeFile89(path97, data2, options2, cb2) {
+      fs30.writeFile = writeFile90;
+      function writeFile90(path97, data2, options2, cb2) {
         if (typeof options2 === "function")
           cb2 = options2, options2 = null;
         return go$writeFile(path97, data2, options2, cb2);
@@ -68432,9 +68432,9 @@ var require_graceful_fs = __commonJS({
         }
       }
       var fs$readdir = fs30.readdir;
-      fs30.readdir = readdir21;
+      fs30.readdir = readdir22;
       var noReaddirOptionVersions = /^v[0-5]\./;
-      function readdir21(path97, options2, cb2) {
+      function readdir22(path97, options2, cb2) {
         if (typeof options2 === "function")
           cb2 = options2, options2 = null;
         var go$readdir = noReaddirOptionVersions.test(process.version) ? function go$readdir2(path98, options3, cb3, startTime) {
@@ -294064,8 +294064,8 @@ var require_graceful_fs2 = __commonJS({
       fs30.createReadStream = createReadStream5;
       fs30.createWriteStream = createWriteStream7;
       var fs$readFile = fs30.readFile;
-      fs30.readFile = readFile102;
-      function readFile102(path97, options2, cb2) {
+      fs30.readFile = readFile103;
+      function readFile103(path97, options2, cb2) {
         if (typeof options2 === "function")
           cb2 = options2, options2 = null;
         return go$readFile(path97, options2, cb2);
@@ -294081,8 +294081,8 @@ var require_graceful_fs2 = __commonJS({
         }
       }
       var fs$writeFile = fs30.writeFile;
-      fs30.writeFile = writeFile89;
-      function writeFile89(path97, data2, options2, cb2) {
+      fs30.writeFile = writeFile90;
+      function writeFile90(path97, data2, options2, cb2) {
         if (typeof options2 === "function")
           cb2 = options2, options2 = null;
         return go$writeFile(path97, data2, options2, cb2);
@@ -294136,9 +294136,9 @@ var require_graceful_fs2 = __commonJS({
         }
       }
       var fs$readdir = fs30.readdir;
-      fs30.readdir = readdir21;
+      fs30.readdir = readdir22;
       var noReaddirOptionVersions = /^v[0-5]\./;
-      function readdir21(path97, options2, cb2) {
+      function readdir22(path97, options2, cb2) {
         if (typeof options2 === "function")
           cb2 = options2, options2 = null;
         var go$readdir = noReaddirOptionVersions.test(process.version) ? function go$readdir2(path98, options3, cb3, startTime) {
@@ -351974,7 +351974,7 @@ var require_dist14 = __commonJS({
       }
       return result;
     }
-    var import_promises182 = require("fs/promises");
+    var import_promises183 = require("fs/promises");
     var import_node_os15 = require("os");
     var import_node_path210 = require("path");
     var import_minimatch8 = require_commonjs3();
@@ -352173,9 +352173,9 @@ var require_dist14 = __commonJS({
               if (laterFiles.has(fileResult.file) || laterFiles.has(originalPath)) {
                 const filePath = (0, import_node_path210.join)(this.outputDir, fileResult.file);
                 try {
-                  const content5 = await (0, import_promises182.readFile)(filePath, "utf-8");
+                  const content5 = await (0, import_promises183.readFile)(filePath, "utf-8");
                   const stripped = stripConflictMarkers(content5);
-                  await (0, import_promises182.writeFile)(filePath, stripped);
+                  await (0, import_promises183.writeFile)(filePath, stripped);
                 } catch {
                 }
               }
@@ -352187,7 +352187,7 @@ var require_dist14 = __commonJS({
       /** Populate accumulator after git apply succeeds. */
       async populateAccumulatorForPatch(patch5, baseGen, currentTreeHash) {
         if (!baseGen) return;
-        const tempDir2 = await (0, import_promises182.mkdtemp)((0, import_node_path210.join)((0, import_node_os15.tmpdir)(), "replay-acc-"));
+        const tempDir2 = await (0, import_promises183.mkdtemp)((0, import_node_path210.join)((0, import_node_os15.tmpdir)(), "replay-acc-"));
         const { GitClient: GitClient22 } = await Promise.resolve().then(() => (init_GitClient(), GitClient_exports));
         const tempGit = new GitClient22(tempDir2);
         await tempGit.exec(["init"]);
@@ -352199,7 +352199,7 @@ var require_dist14 = __commonJS({
             const resolvedPath = await this.resolveFilePath(filePath, baseGen.tree_hash, currentTreeHash);
             const base4 = await this.git.showFile(baseGen.tree_hash, filePath);
             const theirs = await this.applyPatchToContent(base4, patch5.patch_content, filePath, tempGit, tempDir2);
-            const effectiveTheirs = theirs ?? await (0, import_promises182.readFile)((0, import_node_path210.join)(this.outputDir, resolvedPath), "utf-8").catch(() => null);
+            const effectiveTheirs = theirs ?? await (0, import_promises183.readFile)((0, import_node_path210.join)(this.outputDir, resolvedPath), "utf-8").catch(() => null);
             if (effectiveTheirs) {
               this.fileTheirsAccumulator.set(resolvedPath, {
                 content: effectiveTheirs,
@@ -352208,7 +352208,7 @@ var require_dist14 = __commonJS({
             }
           }
         } finally {
-          await (0, import_promises182.rm)(tempDir2, { recursive: true }).catch(() => {
+          await (0, import_promises183.rm)(tempDir2, { recursive: true }).catch(() => {
           });
         }
       }
@@ -352233,7 +352233,7 @@ var require_dist14 = __commonJS({
               resolvedFiles[filePath] = resolvedPath;
             }
             const fullPath = (0, import_node_path210.join)(this.outputDir, resolvedPath);
-            snapshots.set(resolvedPath, await (0, import_promises182.readFile)(fullPath, "utf-8").catch(() => null));
+            snapshots.set(resolvedPath, await (0, import_promises183.readFile)(fullPath, "utf-8").catch(() => null));
           }
           try {
             await this.git.execWithInput(["apply", "--3way"], patch5.patch_content);
@@ -352248,9 +352248,9 @@ var require_dist14 = __commonJS({
             for (const [resolvedPath, content5] of snapshots) {
               const fullPath = (0, import_node_path210.join)(this.outputDir, resolvedPath);
               if (content5 != null) {
-                await (0, import_promises182.writeFile)(fullPath, content5);
+                await (0, import_promises183.writeFile)(fullPath, content5);
               } else {
-                await (0, import_promises182.unlink)(fullPath).catch(() => {
+                await (0, import_promises183.unlink)(fullPath).catch(() => {
                 });
               }
             }
@@ -352261,7 +352261,7 @@ var require_dist14 = __commonJS({
       async applyWithThreeWayMerge(patch5) {
         const fileResults = [];
         const resolvedFiles = {};
-        const tempDir2 = await (0, import_promises182.mkdtemp)((0, import_node_path210.join)((0, import_node_os15.tmpdir)(), "replay-"));
+        const tempDir2 = await (0, import_promises183.mkdtemp)((0, import_node_path210.join)((0, import_node_os15.tmpdir)(), "replay-"));
         const { GitClient: GitClient22 } = await Promise.resolve().then(() => (init_GitClient(), GitClient_exports));
         const tempGit = new GitClient22(tempDir2);
         await tempGit.exec(["init"]);
@@ -352284,7 +352284,7 @@ var require_dist14 = __commonJS({
             fileResults.push(result);
           }
         } finally {
-          await (0, import_promises182.rm)(tempDir2, { recursive: true }).catch(() => {
+          await (0, import_promises183.rm)(tempDir2, { recursive: true }).catch(() => {
           });
         }
         const conflictFiles = fileResults.filter((r23) => r23.status === "conflict");
@@ -352325,7 +352325,7 @@ var require_dist14 = __commonJS({
             }
           }
           const oursPath = (0, import_node_path210.join)(this.outputDir, resolvedPath);
-          const ours = await (0, import_promises182.readFile)(oursPath, "utf-8").catch(() => null);
+          const ours = await (0, import_promises183.readFile)(oursPath, "utf-8").catch(() => null);
           let ghostReconstructed = false;
           let theirs = null;
           if (!base4 && ours && !renameSourcePath) {
@@ -352413,15 +352413,15 @@ var require_dist14 = __commonJS({
               baseGeneration: patch5.base_generation
             });
             const outDir2 = (0, import_node_path210.dirname)(oursPath);
-            await (0, import_promises182.mkdir)(outDir2, { recursive: true });
-            await (0, import_promises182.writeFile)(oursPath, effective_theirs);
+            await (0, import_promises183.mkdir)(outDir2, { recursive: true });
+            await (0, import_promises183.writeFile)(oursPath, effective_theirs);
             return { file: resolvedPath, status: "merged", reason: "new-file" };
           }
           if (base4 == null && ours && effective_theirs && !useAccumulatorAsMergeBase) {
             const merged2 = threeWayMerge("", ours, effective_theirs);
             const outDir2 = (0, import_node_path210.dirname)(oursPath);
-            await (0, import_promises182.mkdir)(outDir2, { recursive: true });
-            await (0, import_promises182.writeFile)(oursPath, merged2.content);
+            await (0, import_promises183.mkdir)(outDir2, { recursive: true });
+            await (0, import_promises183.writeFile)(oursPath, merged2.content);
             if (merged2.hasConflicts) {
               return {
                 file: resolvedPath,
@@ -352457,8 +352457,8 @@ var require_dist14 = __commonJS({
           }
           const merged = threeWayMerge(mergeBase, ours, effective_theirs);
           const outDir = (0, import_node_path210.dirname)(oursPath);
-          await (0, import_promises182.mkdir)(outDir, { recursive: true });
-          await (0, import_promises182.writeFile)(oursPath, merged.content);
+          await (0, import_promises183.mkdir)(outDir, { recursive: true });
+          await (0, import_promises183.writeFile)(oursPath, merged.content);
           if (effective_theirs && !merged.hasConflicts) {
             this.fileTheirsAccumulator.set(resolvedPath, {
               content: effective_theirs,
@@ -352533,8 +352533,8 @@ var require_dist14 = __commonJS({
         try {
           if (sourceFilePath) {
             const tempSourcePath = (0, import_node_path210.join)(tempDir2, sourceFilePath);
-            await (0, import_promises182.mkdir)((0, import_node_path210.dirname)(tempSourcePath), { recursive: true });
-            await (0, import_promises182.writeFile)(tempSourcePath, base4);
+            await (0, import_promises183.mkdir)((0, import_node_path210.dirname)(tempSourcePath), { recursive: true });
+            await (0, import_promises183.writeFile)(tempSourcePath, base4);
             await tempGit.exec(["add", sourceFilePath]);
             await tempGit.exec([
               "commit",
@@ -352544,15 +352544,15 @@ var require_dist14 = __commonJS({
             ]);
             await tempGit.execWithInput(["apply", "--allow-empty"], fileDiff);
             const tempTargetPath = (0, import_node_path210.join)(tempDir2, filePath);
-            return await (0, import_promises182.readFile)(tempTargetPath, "utf-8");
+            return await (0, import_promises183.readFile)(tempTargetPath, "utf-8");
           }
           const tempFilePath = (0, import_node_path210.join)(tempDir2, filePath);
-          await (0, import_promises182.mkdir)((0, import_node_path210.dirname)(tempFilePath), { recursive: true });
-          await (0, import_promises182.writeFile)(tempFilePath, base4);
+          await (0, import_promises183.mkdir)((0, import_node_path210.dirname)(tempFilePath), { recursive: true });
+          await (0, import_promises183.writeFile)(tempFilePath, base4);
           await tempGit.exec(["add", filePath]);
           await tempGit.exec(["commit", "-m", `base for ${filePath}`, "--allow-empty"]);
           await tempGit.execWithInput(["apply", "--allow-empty"], fileDiff);
-          return await (0, import_promises182.readFile)(tempFilePath, "utf-8");
+          return await (0, import_promises183.readFile)(tempFilePath, "utf-8");
         } catch {
           return null;
         }
@@ -355822,7 +355822,7 @@ var require_jsonfile = __commonJS({
       }
       return obj;
     }
-    var readFile102 = universalify.fromPromise(_readFile);
+    var readFile103 = universalify.fromPromise(_readFile);
     function readFileSync19(file4, options2 = {}) {
       if (typeof options2 === "string") {
         options2 = { encoding: options2 };
@@ -355847,16 +355847,16 @@ var require_jsonfile = __commonJS({
       const str3 = stringify5(obj, options2);
       await universalify.fromCallback(fs29.writeFile)(file4, str3, options2);
     }
-    var writeFile89 = universalify.fromPromise(_writeFile);
+    var writeFile90 = universalify.fromPromise(_writeFile);
     function writeFileSync7(file4, obj, options2 = {}) {
       const fs29 = options2.fs || _fs;
       const str3 = stringify5(obj, options2);
       return fs29.writeFileSync(file4, str3, options2);
     }
     module4.exports = {
-      readFile: readFile102,
+      readFile: readFile103,
       readFileSync: readFileSync19,
-      writeFile: writeFile89,
+      writeFile: writeFile90,
       writeFileSync: writeFileSync7
     };
   }
@@ -419233,7 +419233,7 @@ async function unpackArchive(archivePath, folderPath) {
   } else if (archivePath.endsWith(".tar.bz2")) {
     await extractTar(archivePath, folderPath, "bzip2");
   } else if (archivePath.endsWith(".dmg")) {
-    await (0, import_promises118.mkdir)(folderPath);
+    await (0, import_promises119.mkdir)(folderPath);
     await installDMG(archivePath, folderPath);
   } else if (archivePath.endsWith(".exe")) {
     const result = (0, import_node_child_process4.spawnSync)(archivePath, [`/ExtractDir=${folderPath}`], {
@@ -419322,7 +419322,7 @@ async function installDMG(dmgPath, folderPath) {
   }
   const mountPath = volumes[0];
   try {
-    const fileNames = await (0, import_promises118.readdir)(mountPath);
+    const fileNames = await (0, import_promises119.readdir)(mountPath);
     const appName = fileNames.find((item) => {
       return typeof item === "string" && item.endsWith(".app");
     });
@@ -419335,13 +419335,13 @@ async function installDMG(dmgPath, folderPath) {
     (0, import_node_child_process4.spawnSync)("hdiutil", ["detach", mountPath, "-quiet"]);
   }
 }
-var import_node_child_process4, import_node_fs24, import_promises118, path79, import_node_stream6, import_debug8, debugFileUtil, internalConstantsForTesting;
+var import_node_child_process4, import_node_fs24, import_promises119, path79, import_node_stream6, import_debug8, debugFileUtil, internalConstantsForTesting;
 var init_fileUtil = __esm({
   "../../../node_modules/.pnpm/@puppeteer+browsers@2.13.0/node_modules/@puppeteer/browsers/lib/esm/fileUtil.js"() {
     "use strict";
     import_node_child_process4 = require("child_process");
     import_node_fs24 = require("fs");
-    import_promises118 = require("fs/promises");
+    import_promises119 = require("fs/promises");
     path79 = __toESM(require("path"), 1);
     import_node_stream6 = require("stream");
     import_debug8 = __toESM(require_src(), 1);
@@ -419404,7 +419404,7 @@ async function installWithProviders(options2) {
       }
       debugInstall(`Successfully got URL from ${provider.getName()}: ${url3}`);
       if (!(0, import_node_fs25.existsSync)(browserRoot)) {
-        await (0, import_promises119.mkdir)(browserRoot, { recursive: true });
+        await (0, import_promises120.mkdir)(browserRoot, { recursive: true });
       }
       return await installUrl(url3, options2, provider);
     } catch (err) {
@@ -419477,7 +419477,7 @@ async function installUrl(url3, options2, provider) {
   const browserRoot = cache2.browserRoot(options2.browser);
   const archivePath = import_node_path33.default.join(browserRoot, `${options2.buildId}-${fileName}`);
   if (!(0, import_node_fs25.existsSync)(browserRoot)) {
-    await (0, import_promises119.mkdir)(browserRoot, { recursive: true });
+    await (0, import_promises120.mkdir)(browserRoot, { recursive: true });
   }
   if (!options2.unpack) {
     if ((0, import_node_fs25.existsSync)(archivePath)) {
@@ -419541,7 +419541,7 @@ async function installUrl(url3, options2, provider) {
     return installedBrowser;
   } finally {
     if ((0, import_node_fs25.existsSync)(archivePath)) {
-      await (0, import_promises119.unlink)(archivePath);
+      await (0, import_promises120.unlink)(archivePath);
     }
   }
 }
@@ -419621,14 +419621,14 @@ function toMegabytes(bytes) {
   const mb2 = bytes / 1e3 / 1e3;
   return `${Math.round(mb2 * 10) / 10} MB`;
 }
-var import_node_assert3, import_node_child_process5, import_node_fs25, import_promises119, import_node_os9, import_node_path33, import_progress, debugInstall, times;
+var import_node_assert3, import_node_child_process5, import_node_fs25, import_promises120, import_node_os9, import_node_path33, import_progress, debugInstall, times;
 var init_install = __esm({
   "../../../node_modules/.pnpm/@puppeteer+browsers@2.13.0/node_modules/@puppeteer/browsers/lib/esm/install.js"() {
     "use strict";
     import_node_assert3 = __toESM(require("assert"), 1);
     import_node_child_process5 = require("child_process");
     import_node_fs25 = require("fs");
-    import_promises119 = require("fs/promises");
+    import_promises120 = require("fs/promises");
     import_node_os9 = __toESM(require("os"), 1);
     import_node_path33 = __toESM(require("path"), 1);
     import_progress = __toESM(require_progress(), 1);
@@ -621394,7 +621394,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "4.71.6",
+          version: "4.72.0-1-g2825b1479c3",
           usingAccessToken: true
         }
       });
@@ -621448,7 +621448,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "4.71.6",
+        version: "4.72.0-1-g2825b1479c3",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -624684,7 +624684,8 @@ var YamlConfigLoader = class {
       data: parseResult.data,
       sourced: sourceResolver.toSourced(parseResult.data),
       absoluteFilePath,
-      relativeFilePath: RelativeFilePath2.of(relative4(this.cwd, absoluteFilePath))
+      relativeFilePath: RelativeFilePath2.of(relative4(this.cwd, absoluteFilePath)),
+      pathMappings: resolved.pathMappings
     };
   }
   async parseDocument(absoluteFilePath) {
@@ -624747,6 +624748,17 @@ var YamlConfigLoader = class {
       case "unrecognized_keys":
         return `unknown key(s): ${issue2.keys.join(", ")}`;
       case "invalid_union": {
+        const unknownKeys = [];
+        for (const errorGroup of issue2.errors) {
+          for (const err of errorGroup) {
+            if (err.code === "unrecognized_keys") {
+              unknownKeys.push(...err.keys);
+            }
+          }
+        }
+        if (unknownKeys.length > 0) {
+          return `unknown key(s): ${[...new Set(unknownKeys)].join(", ")}`;
+        }
         const expectedTypes = /* @__PURE__ */ new Set();
         for (const errorGroup of issue2.errors) {
           for (const err of errorGroup) {
@@ -625075,7 +625087,7 @@ var ApiDefinitionConverter = class {
     let result = {};
     if (api != null && !isNullish2(sourced.api)) {
       result = await this.convertApi({
-        absoluteFernYmlPath: fernYml.absoluteFilePath,
+        absoluteFernYmlPath: this.resolveBasePathForKey("api", fernYml),
         api,
         sourcedApi: sourced.api
       });
@@ -625083,6 +625095,7 @@ var ApiDefinitionConverter = class {
     if (apis != null && !isNullish2(sourced.apis)) {
       result = await this.convertApis({
         absoluteFernYmlPath: fernYml.absoluteFilePath,
+        pathMappings: fernYml.pathMappings,
         apis,
         sourcedApis: sourced.apis
       });
@@ -625120,14 +625133,15 @@ var ApiDefinitionConverter = class {
       [DEFAULT_API_NAME]: apiDefinition
     };
   }
-  async convertApis({ absoluteFernYmlPath, apis, sourcedApis }) {
+  async convertApis({ absoluteFernYmlPath, pathMappings, apis, sourcedApis }) {
     if (isNullish2(sourcedApis)) {
       return {};
     }
     const apiEntries = Object.entries(apis).filter(([apiName]) => !isNullish2(sourcedApis[apiName])).map(([apiName, apiDef]) => ({ apiName, apiDef, sourcedApiDef: sourcedApis[apiName] })).filter((entry) => !isNullish2(entry.sourcedApiDef));
     const convertedEntries = await Promise.all(apiEntries.map(async ({ apiName, apiDef, sourcedApiDef }) => {
+      const entryBasePath = this.findBasePathInMappings(["apis", apiName], pathMappings) ?? this.findBasePathInMappings(["apis"], pathMappings) ?? absoluteFernYmlPath;
       const specs = await this.convertSpecs({
-        absoluteFernYmlPath,
+        absoluteFernYmlPath: entryBasePath,
         specs: apiDef.specs,
         sourced: sourcedApiDef.specs
       });
@@ -625423,9 +625437,33 @@ var ApiDefinitionConverter = class {
       }
     }
   }
+  /**
+   * Returns the file path of the document that provided the content at the
+   * given YAML path prefix (via a `$ref`), or `undefined` if no mapping matches.
+   *
+   * Used to resolve spec paths relative to the correct source file when a
+   * config section (e.g. `api`, `apis`, `apis.my-api`) was loaded via `$ref`.
+   */
+  findBasePathInMappings(yamlPath, pathMappings) {
+    for (const mapping of pathMappings) {
+      if (mapping.yamlPath.length === yamlPath.length && yamlPath.every((seg, i11) => seg === mapping.yamlPath[i11])) {
+        return mapping.document.absoluteFilePath;
+      }
+    }
+    return void 0;
+  }
+  /**
+   * Returns the base file path to use for resolving paths in the given top-level
+   * key (e.g. "api"). If the key was `$ref`'d, returns the path of the referenced
+   * file; otherwise falls back to the fern.yml path.
+   */
+  resolveBasePathForKey(key2, fernYml) {
+    return this.findBasePathInMappings([key2], fernYml.pathMappings) ?? fernYml.absoluteFilePath;
+  }
 };
 
 // ../cli-v2/lib/docs/config/converter/DocsConfigConverter.js
+var DOCS_YAML_PATH = "docs";
 var DocsConfigConverter = class {
   issues = [];
   convert({ fernYml }) {
@@ -625437,10 +625475,13 @@ var DocsConfigConverter = class {
     if (this.issues.length > 0) {
       return { success: false, issues: this.issues };
     }
+    const docsPathMapping = fernYml.pathMappings.find((m11) => m11.yamlPath.length === 1 && m11.yamlPath[0] === DOCS_YAML_PATH);
+    const absoluteFilePath = docsPathMapping != null ? docsPathMapping.document.absoluteFilePath : fernYml.absoluteFilePath;
     return {
       success: true,
       config: {
-        raw: docs
+        raw: docs,
+        absoluteFilePath
       }
     };
   }
@@ -753732,8 +753773,13 @@ var IrCompiler = class {
 var CompileCommand = class {
   async handle(context3, args) {
     const workspace = await context3.loadWorkspaceOrThrow();
-    const { apiName, definition: definition3 } = this.resolveApi(args, workspace);
-    await this.checkOrThrow({ context: context3, workspace, apiName });
+    const entries23 = this.resolveApiEntries(args, workspace);
+    if (args.output != null && entries23.length > 1) {
+      throw new CliError({
+        message: `--output requires --api when multiple APIs are configured`,
+        code: CliError.Code.ConfigError
+      });
+    }
     const compiler2 = new IrCompiler({
       context: context3,
       cliVersion: workspace.cliVersion
@@ -753745,43 +753791,35 @@ var CompileCommand = class {
       disableExamples: args["disable-examples"],
       irVersion: args["ir-version"]
     };
-    const result = args.dynamic ? await compiler2.compileDynamic({ apiName, definition: definition3, options: options2 }) : await compiler2.compile({ apiName, definition: definition3, options: options2 });
-    await this.writeOutput(context3, args, result.object);
+    for (const { apiName, definition: definition3 } of entries23) {
+      await this.checkOrThrow({ context: context3, workspace, apiName });
+      const result = args.dynamic ? await compiler2.compileDynamic({ apiName, definition: definition3, options: options2 }) : await compiler2.compile({ apiName, definition: definition3, options: options2 });
+      await this.writeOutput(context3, args, result.object);
+    }
   }
-  resolveApi(args, workspace) {
-    const apiNames = Object.keys(workspace.apis);
+  /**
+   * Resolves the set of APIs to compile.
+   *
+   * - If `--api` is provided, returns only that API (throws if not found).
+   * - Otherwise returns all APIs in the workspace, matching the behavior of
+   *   `check`, `merge`, and `split` which also run on all APIs by default.
+   */
+  resolveApiEntries(args, workspace) {
+    const allApiNames = Object.keys(workspace.apis);
     if (args.api != null) {
       const definition3 = workspace.apis[args.api];
       if (definition3 == null) {
-        const available2 = apiNames.join(", ");
+        const available = allApiNames.join(", ");
         throw new CliError({
-          message: `API '${args.api}' not found. Available APIs: ${available2}`,
+          message: `API '${args.api}' not found. Available APIs: ${available}`,
           code: CliError.Code.ConfigError
         });
       }
-      return { apiName: args.api, definition: definition3 };
+      return [{ apiName: args.api, definition: definition3 }];
     }
-    if (apiNames.length === 1) {
-      const apiName = apiNames[0];
-      if (apiName == null) {
-        throw new CliError({
-          message: "Internal error; no APIs found in workspace",
-          code: CliError.Code.InternalError
-        });
-      }
+    return allApiNames.flatMap((apiName) => {
       const definition3 = workspace.apis[apiName];
-      if (definition3 == null) {
-        throw new CliError({
-          message: `Internal error; API '${apiName}' not found in workspace`,
-          code: CliError.Code.InternalError
-        });
-      }
-      return { apiName, definition: definition3 };
-    }
-    const available = apiNames.join(", ");
-    throw new CliError({
-      message: `Multiple APIs found: ${available}. Use --api to select one.`,
-      code: CliError.Code.ConfigError
+      return definition3 != null ? [{ apiName, definition: definition3 }] : [];
     });
   }
   async checkOrThrow({ context: context3, workspace, apiName }) {
@@ -795489,13 +795527,13 @@ async function removeInvalidAiExamples({ sourceFilePath, context: context3 }) {
         }
       }
     }
-    const { writeFile: writeFile89 } = await import("fs/promises");
+    const { writeFile: writeFile90 } = await import("fs/promises");
     const yamlContent = jsYaml.dump(parsed, {
       indent: 2,
       lineWidth: -1,
       noRefs: true
     });
-    await writeFile89(overrideFilePath, yamlContent, "utf-8");
+    await writeFile90(overrideFilePath, yamlContent, "utf-8");
     context3.logger.info(`Removed ${validationResult.invalidCount} invalid AI examples from ai_examples_override.yml`);
     return {
       removedCount: validationResult.invalidCount,
@@ -833544,7 +833582,7 @@ var MDX_NODE_TYPES = [
   "mdxTextExpression",
   "mdxjsEsm"
 ];
-function collectLinksAndSources({ readFile: readFile102 = (path97) => (0, import_node_fs14.readFileSync)(path97, "utf-8"), ...opts }) {
+function collectLinksAndSources({ readFile: readFile103 = (path97) => (0, import_node_fs14.readFileSync)(path97, "utf-8"), ...opts }) {
   const visitedAbsoluteFilepaths = /* @__PURE__ */ new Set();
   const contentQueue = [opts];
   const links = [];
@@ -833582,7 +833620,7 @@ function collectLinksAndSources({ readFile: readFile102 = (path97) => (0, import
                 const resolvedImportPath = resolve6(dirname6(absoluteFilepath), importPath);
                 if (resolvedImportPath.endsWith(".mdx") || resolvedImportPath.endsWith(".md")) {
                   contentQueue.push({
-                    content: readFile102(resolvedImportPath),
+                    content: readFile103(resolvedImportPath),
                     absoluteFilepath: resolvedImportPath
                   });
                 }
@@ -833625,7 +833663,7 @@ function collectLinksAndSources({ readFile: readFile102 = (path97) => (0, import
           if (absoluteFilepath && typeof src === "string") {
             const resolvedImportPath = resolve6(dirname6(absoluteFilepath), src);
             contentQueue.push({
-              content: readFile102(resolvedImportPath),
+              content: readFile103(resolvedImportPath),
               absoluteFilepath: resolvedImportPath
             });
           }
@@ -834698,13 +834736,15 @@ async function runRulesOnDocsWorkspace({ workspace, rules: selectedRules, contex
 }
 
 // ../cli-v2/lib/docs/adapter/LegacyDocsWorkspaceAdapter.js
+init_lib6();
 var LegacyDocsWorkspaceAdapter = class {
   adapt({ docsConfig, absoluteFilePath }) {
+    const docsFilePath = docsConfig.absoluteFilePath ?? absoluteFilePath;
     return {
       type: "docs",
       workspaceName: void 0,
-      absoluteFilePath,
-      absoluteFilepathToDocsConfig: absoluteFilePath,
+      absoluteFilePath: dirname6(docsFilePath),
+      absoluteFilepathToDocsConfig: docsFilePath,
       config: docsConfig.raw
     };
   }
@@ -834721,9 +834761,9 @@ var LegacyProjectAdapter = class {
   }
   adapt(workspace) {
     const apiWorkspaces = this.buildApiWorkspaces(workspace);
-    const docsWorkspace = workspace.docs != null && workspace.absoluteFilePath != null ? this.docsAdapter.adapt({
+    const docsWorkspace = workspace.docs != null ? this.docsAdapter.adapt({
       docsConfig: workspace.docs,
-      absoluteFilePath: workspace.absoluteFilePath
+      absoluteFilePath: workspace.docs.absoluteFilePath ?? workspace.absoluteFilePath ?? this.context.cwd
     }) : void 0;
     return {
       config: {
@@ -835180,7 +835220,7 @@ function addCheckCommand2(cli) {
 
 // ../cli-v2/lib/migrator/Migrator.js
 init_lib6();
-var import_promises75 = require("fs/promises");
+var import_promises76 = require("fs/promises");
 
 // ../cli-v2/lib/migrator/converters/convertApiSpecs.js
 init_lib6();
@@ -835190,6 +835230,7 @@ var import_promises72 = require("fs/promises");
 var SETTINGS_KEY_MAP = {
   // Base settings
   "use-title": "titleAsSchemaName",
+  "title-as-schema-name": "titleAsSchemaName",
   "respect-nullable-schemas": "respectNullableSchemas",
   "wrap-references-to-nullable-in-optional": "wrapReferencesToNullableInOptional",
   "coerce-optional-schemas-to-nullable": "coerceOptionalSchemasToNullable",
@@ -835752,9 +835793,6 @@ function convertSdkTargetsFromRaw(options2) {
     }
   }
   const sdks = { targets: targets2 };
-  if (defaultGroup != null) {
-    sdks.defaultGroup = defaultGroup;
-  }
   if (autorelease != null) {
     sdks.autorelease = autorelease;
   }
@@ -835808,12 +835846,42 @@ function convertRawGeneratorToTarget(options2) {
   if (generator.config != null) {
     target.config = generator.config;
   }
-  target.group = [groupName];
   const outputResult = convertRawOutputConfig(generator, warnings);
   target.output = outputResult.output;
   if (outputResult.publish != null) {
     target.publish = outputResult.publish;
   }
+  const generatorMetadata = generator.metadata;
+  if (generatorMetadata != null) {
+    const targetMetadata = {};
+    if (generatorMetadata["package-description"] != null) {
+      targetMetadata.description = generatorMetadata["package-description"];
+    }
+    if (generatorMetadata.author != null || generatorMetadata.email != null) {
+      targetMetadata.authors = [{ name: generatorMetadata.author ?? "", email: generatorMetadata.email ?? "" }];
+    }
+    if (generatorMetadata["reference-url"] != null) {
+      warnings.push({
+        type: "unsupported",
+        message: `metadata.reference-url is not supported in fern.yml`,
+        suggestion: "Remove reference-url from metadata"
+      });
+    }
+    if (generatorMetadata.license != null && typeof target.output !== "string" && target.output.git != null) {
+      const license = generatorMetadata.license;
+      target.output.git.license = typeof license === "string" ? license : license.custom;
+    }
+    if (targetMetadata.description != null || targetMetadata.authors != null) {
+      target.metadata = targetMetadata;
+    }
+  }
+  if (generator["smart-casing"] != null) {
+    warnings.push({
+      type: "unsupported",
+      message: `smart-casing is not supported in fern.yml`,
+      suggestion: "Remove smart-casing from your generator configuration"
+    });
+  }
   if (generator["ir-version"] != null) {
     warnings.push({
       type: "deprecated",
@@ -836073,6 +836141,16 @@ function convertRawReadme(readme) {
   return hasFields ? result : void 0;
 }
 
+// ../cli-v2/lib/migrator/docs-yml/DocsYmlMigrator.js
+init_lib6();
+async function migrateDocsYml(fernDir) {
+  const filePath = join8(fernDir, RelativeFilePath2.of(DOCS_CONFIGURATION_FILENAME));
+  if (!await doesPathExist(filePath, "file")) {
+    return { found: false };
+  }
+  return { docsRef: { $ref: `./${DOCS_CONFIGURATION_FILENAME}` }, found: true };
+}
+
 // ../cli-v2/lib/migrator/fern-config-json/FernConfigJsonMigrator.js
 init_lib4();
 init_lib6();
@@ -836323,6 +836401,38 @@ var GeneratorsYmlMigrator = class {
   }
 };
 
+// ../cli-v2/lib/migrator/github-workflows/GithubWorkflowMigrator.js
+init_lib6();
+var import_promises75 = require("fs/promises");
+var WORKFLOWS_DIR = ".github/workflows";
+async function migrateGithubWorkflows(cwd2) {
+  const warnings = [];
+  const workflowsDir = join8(cwd2, RelativeFilePath2.of(WORKFLOWS_DIR));
+  if (!await doesPathExist(workflowsDir, "directory")) {
+    return warnings;
+  }
+  const entries23 = await (0, import_promises75.readdir)(workflowsDir, { withFileTypes: true });
+  const files = entries23.filter((e6) => e6.isFile() && (e6.name.endsWith(".yml") || e6.name.endsWith(".yaml")));
+  for (const entry of files) {
+    const filePath = join8(workflowsDir, RelativeFilePath2.of(entry.name));
+    const original = await (0, import_promises75.readFile)(filePath, "utf-8");
+    const migrated = migrateFernCommands(original);
+    if (migrated !== original) {
+      await (0, import_promises75.writeFile)(filePath, migrated, "utf-8");
+      warnings.push({ type: "info", message: `Updated workflow file: ${WORKFLOWS_DIR}/${entry.name}` });
+    }
+  }
+  return warnings;
+}
+function migrateFernCommands(content5) {
+  return content5.split("\n").map((line) => {
+    if (!/\bfern(?:-api)?\s+generate\b/.test(line)) {
+      return line;
+    }
+    return line.replace(/(\bfern(?:-api)?\s+)generate\b/g, "$1sdk generate").replace(/--group\b/g, "--target");
+  }).join("\n");
+}
+
 // ../cli-v2/lib/migrator/Migrator.js
 var Migrator = class {
   cwd;
@@ -836407,13 +836517,17 @@ var Migrator = class {
       }
       fernYml = singleApiResult.fernYml;
     }
+    const docsResult = await migrateDocsYml(fernDir);
+    if (docsResult.docsRef != null) {
+      fernYml.docs = docsResult.docsRef;
+    }
     const fernYmlPath = join8(this.cwd, RelativeFilePath2.of(FERN_YML_FILENAME));
     const yamlContent = this.serializeFernYml(fernYml);
-    await (0, import_promises75.writeFile)(fernYmlPath, yamlContent, "utf-8");
+    await (0, import_promises76.writeFile)(fernYmlPath, yamlContent, "utf-8");
     if (this.deleteOriginals) {
       for (const absoluteFilePath of migratedFiles) {
         try {
-          await (0, import_promises75.rm)(absoluteFilePath);
+          await (0, import_promises76.rm)(absoluteFilePath);
           this.logger.debug(`Deleted ${absoluteFilePath}`);
         } catch {
           warnings.push({
@@ -836424,6 +836538,7 @@ var Migrator = class {
       }
     }
     this.logger.info(`Created ${fernYmlPath}`);
+    warnings.push(...await migrateGithubWorkflows(this.cwd));
     return {
       success: true,
       warnings,
@@ -836457,7 +836572,7 @@ var Migrator = class {
   }
   async migrateMultiApi(options2) {
     const { fernDir, apisDir, org, warnings, migratedFiles } = options2;
-    const apiDirs = await (0, import_promises75.readdir)(apisDir, { withFileTypes: true });
+    const apiDirs = await (0, import_promises76.readdir)(apisDir, { withFileTypes: true });
     const apiNames = apiDirs.filter((d14) => d14.isDirectory()).map((d14) => d14.name);
     if (apiNames.length === 0) {
       warnings.push({
@@ -836468,7 +836583,6 @@ var Migrator = class {
     }
     const generatorsYmlApis = {};
     let combinedSdks = { targets: {} };
-    let defaultGroup;
     let autorelease;
     for (const apiName of apiNames) {
       const apiDir = join8(apisDir, RelativeFilePath2.of(apiName));
@@ -836483,9 +836597,6 @@ var Migrator = class {
         for (const [targetName, target] of Object.entries(generatorsResult.sdks.targets)) {
           combinedSdks.targets[targetName] = target;
         }
-        if (generatorsResult.sdks.defaultGroup != null && defaultGroup == null) {
-          defaultGroup = generatorsResult.sdks.defaultGroup;
-        }
         if (generatorsResult.sdks.autorelease != null && autorelease == null) {
           autorelease = generatorsResult.sdks.autorelease;
         }
@@ -836502,9 +836613,6 @@ var Migrator = class {
       apis: apisResult.apis
     };
     if (Object.keys(combinedSdks.targets).length > 0) {
-      if (defaultGroup != null) {
-        combinedSdks.defaultGroup = defaultGroup;
-      }
       if (autorelease != null) {
         combinedSdks.autorelease = autorelease;
       }
@@ -836550,6 +836658,9 @@ var Migrator = class {
     if (fernYml.cli != null) {
       doc.cli = fernYml.cli;
     }
+    if (fernYml.docs != null) {
+      doc.docs = fernYml.docs;
+    }
     if (fernYml.sdks != null) {
       doc.sdks = this.simplifySdks(fernYml.sdks);
     }
@@ -836867,7 +836978,7 @@ var import_child_process6 = require("child_process");
 var import_cors = __toESM(require_lib14(), 1);
 var import_express2 = __toESM(require_express3(), 1);
 var import_fs25 = __toESM(require("fs"), 1);
-var import_promises79 = require("fs/promises");
+var import_promises80 = require("fs/promises");
 var import_http9 = __toESM(require("http"), 1);
 var import_path55 = __toESM(require("path"), 1);
 
@@ -837283,7 +837394,7 @@ var isFunction8 = (value) => {
 };
 
 // ../../../node_modules/.pnpm/tiny-readdir@2.7.4/node_modules/tiny-readdir/dist/index.js
-var readdir11 = (rootPath, options2) => {
+var readdir12 = (rootPath, options2) => {
   const followSymlinks = options2?.followSymlinks ?? false;
   const maxDepth = options2?.depth ?? Infinity;
   const maxPaths = options2?.limit ?? Infinity;
@@ -837449,7 +837560,7 @@ var readdir11 = (rootPath, options2) => {
   };
   return populateResultFromRoot(rootPath);
 };
-var dist_default4 = readdir11;
+var dist_default4 = readdir12;
 
 // ../../../node_modules/.pnpm/watcher@2.3.1/node_modules/watcher/dist/utils.js
 var Utils = {
@@ -838540,14 +838651,14 @@ init_wrapper();
 
 // ../docs-preview/lib/DebugLogger.js
 init_lib6();
-var import_promises76 = require("fs/promises");
+var import_promises77 = require("fs/promises");
 var import_os9 = require("os");
 var import_path54 = __toESM(require("path"), 1);
 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.71.6";
+  const version7 = "4.72.0-1-g2825b1479c3";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -838569,7 +838680,7 @@ var DebugLogger = class {
     const localStorageFolder = join8(AbsoluteFilePath2.of((0, import_os9.homedir)()), RelativeFilePath2.of(LOCAL_STORAGE_FOLDER4));
     const logsDir = join8(localStorageFolder, RelativeFilePath2.of(LOGS_FOLDER_NAME));
     if (!await doesPathExist(logsDir)) {
-      await (0, import_promises76.mkdir)(logsDir, { recursive: true });
+      await (0, import_promises77.mkdir)(logsDir, { recursive: true });
     }
     const timestamp2 = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
     const logFileName = `${timestamp2}.debug.log`;
@@ -838582,7 +838693,7 @@ var DebugLogger = class {
       "================================================================================",
       ""
     ].join("\n");
-    await (0, import_promises76.writeFile)(this.logFilePath, header, "utf-8");
+    await (0, import_promises77.writeFile)(this.logFilePath, header, "utf-8");
     this.initialized = true;
     void this.enforceLogSizeLimit(logsDir);
   }
@@ -838601,7 +838712,7 @@ var DebugLogger = class {
     }
     const line = JSON.stringify(entry) + "\n";
     try {
-      await (0, import_promises76.appendFile)(this.logFilePath, line, "utf-8");
+      await (0, import_promises77.appendFile)(this.logFilePath, line, "utf-8");
     } catch (error50) {
     }
   }
@@ -838706,13 +838817,13 @@ var DebugLogger = class {
    */
   async enforceLogSizeLimit(logsDir) {
     try {
-      const entries23 = await (0, import_promises76.readdir)(logsDir);
+      const entries23 = await (0, import_promises77.readdir)(logsDir);
       const logFiles = entries23.filter((name2) => name2.endsWith(".log"));
       const fileInfos = [];
       for (const name2 of logFiles) {
         const fullPath = import_path54.default.join(logsDir, name2);
         try {
-          const stats = await (0, import_promises76.stat)(fullPath);
+          const stats = await (0, import_promises77.stat)(fullPath);
           fileInfos.push({ name: name2, fullPath, size: stats.size, mtimeMs: stats.mtimeMs });
         } catch {
         }
@@ -838734,7 +838845,7 @@ var DebugLogger = class {
           continue;
         }
         try {
-          await (0, import_promises76.unlink)(file4.fullPath);
+          await (0, import_promises77.unlink)(file4.fullPath);
           totalSize -= file4.size;
         } catch {
         }
@@ -838877,7 +838988,7 @@ function getBun() {
 init_lib6();
 var import_cli_progress = __toESM(require_cli_progress(), 1);
 var import_decompress = __toESM(require_decompress(), 1);
-var import_promises77 = require("fs/promises");
+var import_promises78 = require("fs/promises");
 var import_os10 = require("os");
 var import_tmp_promise8 = __toESM(require_tmp_promise(), 1);
 var import_xml2js = __toESM(require_xml2js(), 1);
@@ -838965,7 +839076,7 @@ async function downloadBundle({ bucketUrl, logger: logger4, preferCached, app =
     let currentETag = void 0;
     if (currentETagExists) {
       logger4.debug("Reading existing ETag");
-      currentETag = (await (0, import_promises77.readFile)(eTagFilepath)).toString();
+      currentETag = (await (0, import_promises78.readFile)(eTagFilepath)).toString();
     }
     if (currentETag != null && currentETag === eTag) {
       logger4.debug("ETag matches. Using already downloaded bundle");
@@ -839029,20 +839140,20 @@ async function downloadBundle({ bucketUrl, logger: logger4, preferCached, app =
       }
     }
     const nodeBuffer = Buffer.concat(chunks);
-    await (0, import_promises77.writeFile)(outputZipPath, new Uint8Array(nodeBuffer));
+    await (0, import_promises78.writeFile)(outputZipPath, new Uint8Array(nodeBuffer));
     logger4.debug(`Wrote ${tryTar ? "output.tar.gz" : "output.zip"} to ${outputZipPath}`);
     const absolutePathToPreviewFolder = getPathToPreviewFolder({ app });
     if (await doesPathExist(absolutePathToPreviewFolder)) {
       const oldBundlePath = AbsoluteFilePath2.of(`${absolutePathToPreviewFolder}-old-${Date.now()}`);
       logger4.debug(`Moving previously cached bundle to: ${oldBundlePath}`);
-      await (0, import_promises77.rename)(absolutePathToPreviewFolder, oldBundlePath);
-      (0, import_promises77.rm)(oldBundlePath, { recursive: true }).catch((error50) => {
+      await (0, import_promises78.rename)(absolutePathToPreviewFolder, oldBundlePath);
+      (0, import_promises78.rm)(oldBundlePath, { recursive: true }).catch((error50) => {
         logger4.debug(`Failed to remove old bundle at ${oldBundlePath}: ${error50}`);
       });
     }
-    await (0, import_promises77.mkdir)(absolutePathToPreviewFolder, { recursive: true });
+    await (0, import_promises78.mkdir)(absolutePathToPreviewFolder, { recursive: true });
     const absolutePathToBundleFolder = getPathToBundleFolder({ app });
-    await (0, import_promises77.mkdir)(absolutePathToBundleFolder, { recursive: true });
+    await (0, import_promises78.mkdir)(absolutePathToBundleFolder, { recursive: true });
     logger4.debug(`Decompressing bundle from ${outputZipPath} to ${absolutePathToBundleFolder}`);
     let unzipProgressBar;
     let unzipInterval;
@@ -839077,7 +839188,7 @@ async function downloadBundle({ bucketUrl, logger: logger4, preferCached, app =
         unzipProgressBar.stop();
       }
     }
-    await (0, import_promises77.writeFile)(eTagFilepath, eTag);
+    await (0, import_promises78.writeFile)(eTagFilepath, eTag);
     logger4.debug(`Downloaded bundle to ${absolutePathToBundleFolder}`);
     if (app) {
       logger4.debug("Checking if pnpm is installed");
@@ -839159,15 +839270,15 @@ async function downloadBundle({ bucketUrl, logger: logger4, preferCached, app =
         }
         if (!pnpmfileExists) {
           logger4.debug(`Writing pnpmfile.cjs at ${pnpmfilePath}`);
-          await (0, import_promises77.writeFile)(pnpmfilePath, PNPMFILE_CJS_CONTENTS);
+          await (0, import_promises78.writeFile)(pnpmfilePath, PNPMFILE_CJS_CONTENTS);
         }
         if (!npmrcExists) {
           logger4.debug(`Writing .npmrc at ${npmrcPath}`);
-          await (0, import_promises77.writeFile)(npmrcPath, NPMRC_CONTENTS);
+          await (0, import_promises78.writeFile)(npmrcPath, NPMRC_CONTENTS);
         }
         if (instrumentationJsExists) {
           logger4.debug(`Removing instrumentation.js at ${absPathToInstrumentationJs}`);
-          await (0, import_promises77.rm)(absPathToInstrumentationJs);
+          await (0, import_promises78.rm)(absPathToInstrumentationJs);
         }
         try {
           logger4.debug("Running pnpm install within standalone");
@@ -839187,7 +839298,7 @@ async function downloadBundle({ bucketUrl, logger: logger4, preferCached, app =
     logger4.error(`Error: ${error50}`);
     const absolutePathToPreviewFolder = getPathToPreviewFolder({ app });
     if (await doesPathExist(absolutePathToPreviewFolder)) {
-      await (0, import_promises77.rm)(absolutePathToPreviewFolder, { recursive: true });
+      await (0, import_promises78.rm)(absolutePathToPreviewFolder, { recursive: true });
     }
     logger4.debug(`Removing incomplete bundle: rm -rf ${absolutePathToPreviewFolder}`);
     return {
@@ -839200,7 +839311,7 @@ async function downloadBundle({ bucketUrl, logger: logger4, preferCached, app =
 init_lib4();
 init_js();
 init_lib6();
-var import_promises78 = require("fs/promises");
+var import_promises79 = require("fs/promises");
 var import_gray_matter8 = __toESM(require_gray_matter(), 1);
 var frontmatterPositionCache = /* @__PURE__ */ new Map();
 var frontmatterSidebarTitleCache = /* @__PURE__ */ new Map();
@@ -839270,7 +839381,7 @@ async function getPreviewDocsDefinition({ domain: domain3, project, context: con
         navAffectingChange = true;
         continue;
       }
-      const markdown = (await (0, import_promises78.readFile)(absoluteFilePath)).toString();
+      const markdown = (await (0, import_promises79.readFile)(absoluteFilePath)).toString();
       const isNewFile = previousValue == null;
       if (isNewFile) {
         navAffectingChange = true;
@@ -839675,7 +839786,7 @@ var SnippetDependencyTracker = class {
       const markdownFiles = await this.findMarkdownFiles(docsWorkspace.absoluteFilePath);
       for (const markdownFile of markdownFiles) {
         try {
-          const content5 = await (0, import_promises79.readFile)(markdownFile, "utf-8");
+          const content5 = await (0, import_promises80.readFile)(markdownFile, "utf-8");
           const referencedFiles = this.extractReferences(content5, markdownFile, docsWorkspace.absoluteFilePath);
           this.pageToSnippets.set(markdownFile, referencedFiles);
           for (const referencedFile of referencedFiles) {
@@ -839761,7 +839872,7 @@ async function cleanFernDocsCache(bundleRoot, context3) {
     const cacheExists = await doesPathExist(AbsoluteFilePath2.of(cachePath));
     if (cacheExists) {
       context3.logger.debug(`Cleaning Fern Docs cache at ${cachePath}`);
-      await (0, import_promises79.rm)(cachePath, { recursive: true });
+      await (0, import_promises80.rm)(cachePath, { recursive: true });
       context3.logger.debug("Fern Docs cache cleaned successfully");
     } else {
       context3.logger.debug("No Fern Docs cache to clean");
@@ -839814,7 +839925,7 @@ async function runAppPreviewServer({ initialProject, reloadProject, validateProj
     const appPreviewFolder = getPathToPreviewFolder({ app: true });
     if (await doesPathExist(appPreviewFolder)) {
       context3.logger.info("Force download requested. Deleting cached bundle...");
-      await (0, import_promises79.rm)(appPreviewFolder, { recursive: true });
+      await (0, import_promises80.rm)(appPreviewFolder, { recursive: true });
     }
   }
   if (bundlePath != null) {
@@ -841294,7 +841405,7 @@ init_lib6();
 
 // ../workspace/loader/lib/listFernFiles.js
 init_lib6();
-var import_promises80 = require("fs/promises");
+var import_promises81 = require("fs/promises");
 async function listFernFiles2(root6, extensionGlob) {
   const files = [];
   for (const absoluteFilepath of await listFiles(root6, extensionGlob)) {
@@ -841309,7 +841420,7 @@ async function createFernFile2({ relativeFilepath, absoluteFilepath }) {
   return {
     relativeFilepath,
     absoluteFilepath,
-    fileContents: (await (0, import_promises80.readFile)(absoluteFilepath)).toString()
+    fileContents: (await (0, import_promises81.readFile)(absoluteFilepath)).toString()
   };
 }
 
@@ -841616,7 +841727,7 @@ async function loadAPIWorkspace({ absolutePathToWorkspace, context: context3, cl
 // ../workspace/loader/lib/loadDocsWorkspace.js
 init_lib4();
 init_lib6();
-var import_promises81 = require("fs/promises");
+var import_promises82 = require("fs/promises");
 
 // ../workspace/loader/lib/docs-yml.schema.json
 var docs_yml_schema_exports = {};
@@ -847559,7 +847670,7 @@ async function loadDocsConfiguration({ absolutePathToDocsDefinition, context: co
   });
 }
 async function loadRawDocsConfiguration({ absolutePathOfConfiguration, context: context3 }) {
-  const contentsStr = await (0, import_promises81.readFile)(absolutePathOfConfiguration);
+  const contentsStr = await (0, import_promises82.readFile)(absolutePathOfConfiguration);
   const contentsJson = jsYaml.load(contentsStr.toString());
   const result = validateAgainstJsonSchema(contentsJson, docs_yml_schema_exports, {
     filePath: absolutePathOfConfiguration
@@ -847590,8 +847701,8 @@ ${result.error?.message ?? "Unknown error"}`);
 // ../generation/remote-generation/remote-workspace-runner/lib/downloadSnippetsForTask.js
 init_lib6();
 var import_fs26 = require("fs");
-var import_promises82 = require("fs/promises");
-var import_promises83 = require("stream/promises");
+var import_promises83 = require("fs/promises");
+var import_promises84 = require("stream/promises");
 async function downloadSnippetsForTask({ snippetsS3PreSignedReadUrl, absolutePathToLocalSnippetJSON, context: context3 }) {
   try {
     await downloadFileForTask({
@@ -847608,10 +847719,10 @@ async function downloadFileForTask({ s3PreSignedReadUrl, absolutePathToLocalOutp
     responseType: "stream"
   });
   if (await doesPathExist(absolutePathToLocalOutput)) {
-    await (0, import_promises82.rm)(absolutePathToLocalOutput, { recursive: true });
+    await (0, import_promises83.rm)(absolutePathToLocalOutput, { recursive: true });
   }
-  await (0, import_promises82.mkdir)(dirname6(absolutePathToLocalOutput), { recursive: true });
-  await (0, import_promises83.pipeline)(request7.data, (0, import_fs26.createWriteStream)(absolutePathToLocalOutput));
+  await (0, import_promises83.mkdir)(dirname6(absolutePathToLocalOutput), { recursive: true });
+  await (0, import_promises84.pipeline)(request7.data, (0, import_fs26.createWriteStream)(absolutePathToLocalOutput));
 }
 
 // ../generation/remote-generation/remote-workspace-runner/lib/resolveAutoDiscoveredFernignorePath.js
@@ -847635,7 +847746,7 @@ init_js();
 // ../generation/remote-generation/remote-workspace-runner/lib/createAndStartJob.js
 init_lib6();
 var import_form_data4 = __toESM(require_form_data(), 1);
-var import_promises84 = require("fs/promises");
+var import_promises85 = require("fs/promises");
 var import_url_join23 = __toESM(require_url_join(), 1);
 var import_util19 = require("util");
 var import_zlib5 = require("zlib");
@@ -847688,7 +847799,7 @@ async function createAndStartJob({ projectConfig, workspace, organization, inter
     fernignoreContents = "";
   } else if (fernignorePath != null) {
     try {
-      fernignoreContents = await (0, import_promises84.readFile)(fernignorePath, "utf-8");
+      fernignoreContents = await (0, import_promises85.readFile)(fernignorePath, "utf-8");
     } catch (error50) {
       context3.failAndThrow(`Failed to read fernignore file at ${fernignorePath}: ${error50}`);
     }
@@ -847935,9 +848046,9 @@ function pollJobAndReportStatus({ job, taskId, taskHandler, context: context3 })
 init_lib4();
 init_lib6();
 var import_fs27 = require("fs");
-var import_promises85 = require("fs/promises");
+var import_promises86 = require("fs/promises");
 var import_path57 = __toESM(require("path"), 1);
-var import_promises86 = require("stream/promises");
+var import_promises87 = require("stream/promises");
 
 // ../../../node_modules/.pnpm/terminal-link@3.0.0/node_modules/terminal-link/index.js
 var import_supports_hyperlinks = __toESM(require_supports_hyperlinks(), 1);
@@ -848106,9 +848217,9 @@ async function downloadZipForTask({ s3PreSignedReadUrl, absolutePathToLocalOutpu
   });
   const tmpDir = await import_tmp_promise9.default.dir({ prefix: "fern", unsafeCleanup: true });
   const outputZipPath = import_path57.default.join(tmpDir.path, "output.zip");
-  await (0, import_promises86.pipeline)(request7.data, (0, import_fs27.createWriteStream)(outputZipPath));
+  await (0, import_promises87.pipeline)(request7.data, (0, import_fs27.createWriteStream)(outputZipPath));
   await forceRemoveDirectory(absolutePathToLocalOutput);
-  await (0, import_promises85.mkdir)(absolutePathToLocalOutput, { recursive: true });
+  await (0, import_promises86.mkdir)(absolutePathToLocalOutput, { recursive: true });
   await extractZipToDirectory(outputZipPath, absolutePathToLocalOutput);
 }
 async function forceRemoveDirectory(dirPath) {
@@ -848116,22 +848227,22 @@ async function forceRemoveDirectory(dirPath) {
     return;
   }
   await makeWritableRecursive(dirPath);
-  await (0, import_promises85.rm)(dirPath, { recursive: true, force: true });
+  await (0, import_promises86.rm)(dirPath, { recursive: true, force: true });
 }
 async function makeWritableRecursive(dirPath) {
   try {
-    const entries23 = await (0, import_promises85.readdir)(dirPath, { withFileTypes: true });
+    const entries23 = await (0, import_promises86.readdir)(dirPath, { withFileTypes: true });
     for (const entry of entries23) {
       const fullPath = AbsoluteFilePath2.of(import_path57.default.join(dirPath, entry.name));
       if (entry.isDirectory()) {
         await makeWritableRecursive(fullPath);
       }
       try {
-        await (0, import_promises85.chmod)(fullPath, 493);
+        await (0, import_promises86.chmod)(fullPath, 493);
       } catch {
       }
     }
-    await (0, import_promises85.chmod)(dirPath, 493);
+    await (0, import_promises86.chmod)(dirPath, 493);
   } catch {
   }
 }
@@ -848177,7 +848288,7 @@ async function downloadFilesWithFernIgnoreInTempRepo({ s3PreSignedReadUrl, absol
   const tmpOutputResolutionDir = AbsoluteFilePath2.of((await import_tmp_promise9.default.dir({})).path);
   const absolutePathToFernignore = join8(absolutePathToLocalOutput, RelativeFilePath2.of(FERNIGNORE_FILENAME));
   const fernIgnorePaths = await getFernIgnorePaths({ absolutePathToFernignore });
-  await (0, import_promises85.cp)(absolutePathToLocalOutput, tmpOutputResolutionDir, { recursive: true });
+  await (0, import_promises86.cp)(absolutePathToLocalOutput, tmpOutputResolutionDir, { recursive: true });
   await runGitCommand(["init"], tmpOutputResolutionDir, context3);
   await runGitCommand(["add", "."], tmpOutputResolutionDir, context3);
   await runGitCommand([
@@ -848200,7 +848311,7 @@ async function downloadFilesWithFernIgnoreInTempRepo({ s3PreSignedReadUrl, absol
   await runGitCommand(["restore", "."], tmpOutputResolutionDir, context3);
   await forceRemoveDirectory(join8(tmpOutputResolutionDir, RelativeFilePath2.of(".git")));
   await forceRemoveDirectory(absolutePathToLocalOutput);
-  await (0, import_promises85.cp)(tmpOutputResolutionDir, absolutePathToLocalOutput, { recursive: true });
+  await (0, import_promises86.cp)(tmpOutputResolutionDir, absolutePathToLocalOutput, { recursive: true });
 }
 async function downloadAndExtractZipToDirectory({ s3PreSignedReadUrl, outputPath }) {
   const request7 = await axios_default.get(s3PreSignedReadUrl, {
@@ -848208,7 +848319,7 @@ async function downloadAndExtractZipToDirectory({ s3PreSignedReadUrl, outputPath
   });
   const tmpDir = await import_tmp_promise9.default.dir({ prefix: "fern", unsafeCleanup: true });
   const outputZipPath = import_path57.default.join(tmpDir.path, "output.zip");
-  await (0, import_promises86.pipeline)(request7.data, (0, import_fs27.createWriteStream)(outputZipPath));
+  await (0, import_promises87.pipeline)(request7.data, (0, import_fs27.createWriteStream)(outputZipPath));
   await extractZipToDirectory(outputZipPath, outputPath);
 }
 async function extractZipToDirectory(zipPath, outputDir) {
@@ -848223,10 +848334,10 @@ async function extractZipToDirectory(zipPath, outputDir) {
       zipFile.on("entry", (entry) => {
         const outputPath = import_path57.default.join(outputDir, entry.fileName);
         if (entry.fileName.endsWith("/")) {
-          (0, import_promises85.mkdir)(outputPath, { recursive: true }).then(() => zipFile.readEntry()).catch(reject);
+          (0, import_promises86.mkdir)(outputPath, { recursive: true }).then(() => zipFile.readEntry()).catch(reject);
           return;
         }
-        (0, import_promises85.mkdir)(import_path57.default.dirname(outputPath), { recursive: true }).then(() => {
+        (0, import_promises86.mkdir)(import_path57.default.dirname(outputPath), { recursive: true }).then(() => {
           zipFile.openReadStream(entry, (streamErr, readStream2) => {
             if (streamErr || !readStream2) {
               reject(streamErr ?? new Error("Failed to open read stream"));
@@ -848243,7 +848354,7 @@ async function extractZipToDirectory(zipPath, outputDir) {
 
 // ../generation/remote-generation/remote-workspace-runner/lib/SourceUploader.js
 init_lib6();
-var import_promises87 = require("fs/promises");
+var import_promises88 = require("fs/promises");
 var import_tmp_promise10 = __toESM(require_tmp_promise(), 1);
 var PROTOBUF_ZIP_FILENAME = "proto.zip";
 var SourceUploader = class {
@@ -848264,7 +848375,7 @@ var SourceUploader = class {
   }
   async uploadSource(source2, uploadURL) {
     const uploadCommand = await this.getUploadCommand(source2);
-    const fileData = await (0, import_promises87.readFile)(uploadCommand.absoluteFilePath);
+    const fileData = await (0, import_promises88.readFile)(uploadCommand.absoluteFilePath);
     const response = await fetch(uploadURL, {
       method: "PUT",
       body: fileData,
@@ -848284,7 +848395,7 @@ var SourceUploader = class {
         absoluteFilePath,
         cleanup: async () => {
           this.context.logger.debug(`Removing ${absoluteFilePath}`);
-          await (0, import_promises87.unlink)(absoluteFilePath);
+          await (0, import_promises88.unlink)(absoluteFilePath);
         }
       };
     }
@@ -848735,7 +848846,7 @@ init_lib4();
 init_js();
 init_lib6();
 var import_crypto10 = require("crypto");
-var import_promises88 = require("fs/promises");
+var import_promises89 = require("fs/promises");
 init_lodash();
 var mime = __toESM(require_mime_types(), 1);
 
@@ -848814,7 +848925,7 @@ async function unlockDeploy({ fdrOrigin, token, domain: domain3, basepath }) {
   }
 }
 async function calculateFileHash(absoluteFilePath) {
-  const fileBuffer = await (0, import_promises88.readFile)(absoluteFilePath);
+  const fileBuffer = await (0, import_promises89.readFile)(absoluteFilePath);
   return (0, import_crypto10.createHash)("sha256").update(new Uint8Array(fileBuffer)).digest("hex");
 }
 function sanitizeRelativePathForS3(relativeFilePath) {
@@ -849166,7 +849277,7 @@ async function uploadFiles(filesToUpload, docsWorkspacePath, context3, batchSize
       const absoluteFilePath = sanitizedToAbsoluteMap.get(key2) || resolve6(docsWorkspacePath, RelativeFilePath2.of(key2));
       try {
         const mimeType = mime.lookup(absoluteFilePath);
-        await axios_default.put(uploadUrl, await (0, import_promises88.readFile)(absoluteFilePath), {
+        await axios_default.put(uploadUrl, await (0, import_promises89.readFile)(absoluteFilePath), {
           headers: {
             "Content-Type": mimeType === false ? "application/octet-stream" : mimeType,
             // Set max cache control for S3 uploads
@@ -849794,7 +849905,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "4.71.6"
+        cliVersion: "4.72.0-1-g2825b1479c3"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
         return { success: false };
@@ -850363,6 +850474,36 @@ var DocsTaskGroup = class {
   }
 };
 
+// ../cli-v2/lib/ui/promptSelect.js
+async function promptSelect({ isTTY, message, choices, nonInteractiveError, flagHint }) {
+  if (choices.length === 0) {
+    throw new CliError({
+      message: "No options available to select from.",
+      code: CliError.Code.InternalError
+    });
+  }
+  if (!isTTY) {
+    throw new CliError({ message: nonInteractiveError, code: CliError.Code.ConfigError });
+  }
+  const maxNameLen = Math.max(...choices.map((c16) => c16.name.length));
+  const { selected } = await lib_default4.prompt([
+    {
+      type: "list",
+      name: "selected",
+      message,
+      choices: choices.map((c16) => {
+        if (flagHint == null) {
+          return { name: c16.name, value: c16.value };
+        }
+        const hint = flagHint(c16.value);
+        const label = hint != null ? `${c16.name.padEnd(maxNameLen)}   ${source_default.dim(hint)}` : c16.name;
+        return { name: label, value: c16.value };
+      })
+    }
+  ]);
+  return selected;
+}
+
 // ../cli-v2/lib/commands/docs/publish/command.js
 var PublishCommand = class {
   async handle(context3, args) {
@@ -850391,7 +850532,8 @@ var PublishCommand = class {
         code: CliError.Code.ConfigError
       });
     }
-    const instanceUrl = this.resolveInstanceUrl({
+    const instanceUrl = await this.resolveInstanceUrl({
+      context: context3,
       instances: workspace.docs.raw.instances,
       instance: args.instance
     });
@@ -850473,7 +850615,7 @@ var PublishCommand = class {
       throw new CliError({ code: CliError.Code.ContainerError });
     }
   }
-  resolveInstanceUrl({ instances: instances2, instance }) {
+  async resolveInstanceUrl({ context: context3, instances: instances2, instance }) {
     if (instances2.length === 0) {
       throw new CliError({
         message: "No docs instances configured.\n\n  Add an instance to the 'docs:' section of your fern.yml.",
@@ -850498,14 +850640,17 @@ ${available}
     }
     if (instances2.length > 1) {
       const available = instances2.map((i11) => `  - ${i11.url}`).join("\n");
-      throw new CliError({
-        message: `Multiple docs instances configured. Please specify which instance to publish.
+      return await promptSelect({
+        isTTY: context3.isTTY,
+        message: "Multiple docs instances configured. Select one:",
+        choices: instances2.map((i11) => ({ name: i11.url, value: i11.url })),
+        nonInteractiveError: `Multiple docs instances configured. Please specify which instance to publish.
 
 Available instances:
 ${available}
 
   Use --instance <url> to select one.`,
-        code: CliError.Code.ConfigError
+        flagHint: (value) => `--instance ${value}`
       });
     }
     const first3 = instances2[0];
@@ -850719,7 +850864,7 @@ function addDocsCommand(cli) {
 // ../cli-v2/lib/commands/init/command.js
 init_lib4();
 init_lib6();
-var import_promises89 = require("fs/promises");
+var import_promises90 = require("fs/promises");
 var import_path59 = __toESM(require("path"), 1);
 
 // ../cli-v2/lib/config/fern-yml/FernYmlBuilder.js
@@ -851594,7 +851739,7 @@ var InitCommand = class {
       apiPath,
       defaultGroup: result.defaultGroup
     });
-    await (0, import_promises89.writeFile)(fernYmlPath, fernYmlContent, "utf-8");
+    await (0, import_promises90.writeFile)(fernYmlPath, fernYmlContent, "utf-8");
     context3.stderr.info(`
   ${Icons.success} Created ${FERN_YML_FILENAME}`);
   }
@@ -851616,9 +851761,9 @@ var InitCommand = class {
   }
   async writeSpecFile(cwd2, filename, content5) {
     const specsDir = join8(cwd2, RelativeFilePath2.of(SPECS_DIR));
-    await (0, import_promises89.mkdir)(specsDir, { recursive: true });
+    await (0, import_promises90.mkdir)(specsDir, { recursive: true });
     const filePath = join8(specsDir, RelativeFilePath2.of(filename));
-    await (0, import_promises89.writeFile)(filePath, content5, "utf-8");
+    await (0, import_promises90.writeFile)(filePath, content5, "utf-8");
   }
   resolveApiPath(apiSource) {
     switch (apiSource.type) {
@@ -852568,11 +852713,11 @@ function addCheckCommand4(cli) {
 // ../cli-v2/lib/commands/sdk/generate/command.js
 init_lib4();
 init_lib6();
-var import_promises107 = require("fs/promises");
+var import_promises108 = require("fs/promises");
 
 // ../cli-v2/lib/api/resolver/ApiSpecResolver.js
 init_lib6();
-var import_promises90 = require("fs/promises");
+var import_promises91 = require("fs/promises");
 var import_os11 = require("os");
 var import_path60 = __toESM(require("path"), 1);
 
@@ -852620,9 +852765,9 @@ var ApiSpecResolver = class {
   async resolveUrl({ reference: reference4 }) {
     const { content: content5, contentType } = await this.fetchContent({ url: reference4 });
     const extension4 = this.inferExtension({ url: reference4, contentType });
-    const tempDir2 = await (0, import_promises90.mkdtemp)(import_path60.default.join((0, import_os11.tmpdir)(), "fern-"));
+    const tempDir2 = await (0, import_promises91.mkdtemp)(import_path60.default.join((0, import_os11.tmpdir)(), "fern-"));
     const absoluteFilePath = AbsoluteFilePath2.of(import_path60.default.join(tempDir2, `spec${extension4}`));
-    await (0, import_promises90.writeFile)(absoluteFilePath, content5, "utf-8");
+    await (0, import_promises91.writeFile)(absoluteFilePath, content5, "utf-8");
     const specType = await this.detector.detect({ absoluteFilePath, content: content5, reference: reference4 });
     return {
       absoluteFilePath,
@@ -852635,7 +852780,7 @@ var ApiSpecResolver = class {
     if (!await doesPathExist(absoluteFilePath)) {
       throw new Error(`API spec file does not exist: ${reference4}`);
     }
-    const content5 = await (0, import_promises90.readFile)(absoluteFilePath, "utf-8");
+    const content5 = await (0, import_promises91.readFile)(absoluteFilePath, "utf-8");
     const specType = await this.detector.detect({ absoluteFilePath, content: content5, reference: reference4 });
     return {
       absoluteFilePath,
@@ -852722,7 +852867,7 @@ var AutoVersioningCache = class {
 
 // ../generation/local-generation/local-workspace-runner/lib/AutoVersioningService.js
 var import_fs28 = require("fs");
-var import_promises91 = require("fs/promises");
+var import_promises92 = require("fs/promises");
 var import_path61 = require("path");
 var import_semver12 = __toESM(require_semver2(), 1);
 var AutoVersioningException = class extends Error {
@@ -853429,7 +853574,7 @@ var AutoVersioningService = class _AutoVersioningService {
    * Reads the module path from a go.mod file.
    */
   async readGoModulePath(goModPath) {
-    const content5 = await (0, import_promises91.readFile)(goModPath, "utf-8");
+    const content5 = await (0, import_promises92.readFile)(goModPath, "utf-8");
     for (const line of content5.split("\n")) {
       const trimmed2 = line.trim();
       if (trimmed2.startsWith("module ")) {
@@ -853442,7 +853587,7 @@ var AutoVersioningService = class _AutoVersioningService {
    * Adds a version suffix to the module line in go.mod.
    */
   async addSuffixToGoMod(goModPath, modulePath, suffix) {
-    const content5 = await (0, import_promises91.readFile)(goModPath, "utf-8");
+    const content5 = await (0, import_promises92.readFile)(goModPath, "utf-8");
     const lines = content5.split("\n");
     let changed = false;
     for (let i11 = 0; i11 < lines.length; i11++) {
@@ -853454,7 +853599,7 @@ var AutoVersioningService = class _AutoVersioningService {
       }
     }
     if (changed) {
-      await (0, import_promises91.writeFile)(goModPath, lines.join("\n"), "utf-8");
+      await (0, import_promises92.writeFile)(goModPath, lines.join("\n"), "utf-8");
       this.logger.debug(`Updated go.mod: added ${suffix} to module path`);
     }
   }
@@ -853463,10 +853608,10 @@ var AutoVersioningService = class _AutoVersioningService {
    */
   async walkDirectory(dir, filter8) {
     const results = [];
-    const entries23 = await (0, import_promises91.readdir)(dir);
+    const entries23 = await (0, import_promises92.readdir)(dir);
     for (const entry of entries23) {
       const fullPath = (0, import_path61.join)(dir, entry);
-      const entryStat = await (0, import_promises91.stat)(fullPath);
+      const entryStat = await (0, import_promises92.stat)(fullPath);
       if (entryStat.isDirectory()) {
         if (entry === ".git" || entry === "vendor") {
           continue;
@@ -853493,7 +853638,7 @@ var AutoVersioningService = class _AutoVersioningService {
    * Replaces occurrences of the module path with modulePath + suffix in import statements.
    */
   async addSuffixToGoFile(filePath, modulePath, suffix) {
-    const content5 = await (0, import_promises91.readFile)(filePath, "utf-8");
+    const content5 = await (0, import_promises92.readFile)(filePath, "utf-8");
     const lines = content5.split("\n");
     let changed = false;
     let inImportBlock = false;
@@ -853522,7 +853667,7 @@ var AutoVersioningService = class _AutoVersioningService {
       }
     }
     if (changed) {
-      await (0, import_promises91.writeFile)(filePath, lines.join("\n"), "utf-8");
+      await (0, import_promises92.writeFile)(filePath, lines.join("\n"), "utf-8");
       this.logger.debug(`Updated Go imports in ${filePath}`);
     }
   }
@@ -853575,7 +853720,7 @@ var AutoVersioningService = class _AutoVersioningService {
 };
 
 // ../generation/local-generation/docker-utils/lib/runDocker.js
-var import_promises92 = require("fs/promises");
+var import_promises93 = require("fs/promises");
 var import_tmp_promise11 = __toESM(require_tmp_promise(), 1);
 async function runContainer({ logger: logger4, imageName, args = [], binds = [], envVars = {}, ports = {}, writeLogsToFile = true, removeAfterCompletion = false, runner, signal }) {
   const tryRun = () => tryRunContainer({
@@ -853626,7 +853771,7 @@ async function tryRunContainer({ logger: logger4, imageName, args, binds, envVar
   const logs4 = stdout + stderr;
   if (writeLogsToFile) {
     const tmpFile = await import_tmp_promise11.default.file();
-    await (0, import_promises92.writeFile)(tmpFile.path, logs4);
+    await (0, import_promises93.writeFile)(tmpFile.path, logs4);
     logger4.info(`Generator logs here: ${tmpFile.path}`);
   }
   if (exitCode == null) {
@@ -872145,7 +872290,7 @@ var DynamicSnippetsGenerator = class extends AbstractDynamicSnippetsGenerator {
 
 // ../generation/local-generation/local-workspace-runner/lib/dynamic-snippets/csharp/DynamicSnippetsCsharpTestGenerator.js
 init_lib6();
-var import_promises93 = require("fs/promises");
+var import_promises94 = require("fs/promises");
 var import_path63 = __toESM(require("path"), 1);
 
 // ../generation/local-generation/local-workspace-runner/lib/dynamic-snippets/utils/convertEndpointSnippetRequest.js
@@ -872277,8 +872422,8 @@ var DynamicSnippetsCsharpTestGenerator = class {
           endpointId
         });
         const dynamicSnippetFilePath = this.getTestFilePath({ absolutePathToOutputDir, idx });
-        await (0, import_promises93.mkdir)(import_path63.default.dirname(dynamicSnippetFilePath), { recursive: true });
-        await (0, import_promises93.writeFile)(dynamicSnippetFilePath, response.snippet);
+        await (0, import_promises94.mkdir)(import_path63.default.dirname(dynamicSnippetFilePath), { recursive: true });
+        await (0, import_promises94.writeFile)(dynamicSnippetFilePath, response.snippet);
       } catch (error50) {
         this.context.logger.error(`Failed to generate dynamic snippet for endpoint ${JSON.stringify(request7.endpoint)}: ${error50}`);
       }
@@ -872287,8 +872432,8 @@ var DynamicSnippetsCsharpTestGenerator = class {
   }
   async initializeProject(outputDir) {
     const absolutePathToOutputDir = join8(outputDir, RelativeFilePath2.of("Snippets"));
-    await (0, import_promises93.mkdir)(absolutePathToOutputDir, { recursive: true });
-    await (0, import_promises93.writeFile)(join8(absolutePathToOutputDir, RelativeFilePath2.of("Snippets.csproj")), PROJECT_FILE_CONTENT);
+    await (0, import_promises94.mkdir)(absolutePathToOutputDir, { recursive: true });
+    await (0, import_promises94.writeFile)(join8(absolutePathToOutputDir, RelativeFilePath2.of("Snippets.csproj")), PROJECT_FILE_CONTENT);
     return absolutePathToOutputDir;
   }
   getTestFilePath({ absolutePathToOutputDir, idx }) {
@@ -875728,7 +875873,7 @@ var DynamicSnippetsGenerator2 = class extends AbstractDynamicSnippetsGenerator {
 };
 
 // ../generation/local-generation/local-workspace-runner/lib/dynamic-snippets/go/DynamicSnippetsGoTestGenerator.js
-var import_promises94 = require("fs/promises");
+var import_promises95 = require("fs/promises");
 var import_path65 = __toESM(require("path"), 1);
 var DynamicSnippetsGoTestGenerator = class {
   context;
@@ -875757,8 +875902,8 @@ var DynamicSnippetsGoTestGenerator = class {
           endpointId
         });
         const dynamicSnippetFilePath = this.getTestFilePath({ outputDir, idx });
-        await (0, import_promises94.mkdir)(import_path65.default.dirname(dynamicSnippetFilePath), { recursive: true });
-        await (0, import_promises94.writeFile)(dynamicSnippetFilePath, response.snippet);
+        await (0, import_promises95.mkdir)(import_path65.default.dirname(dynamicSnippetFilePath), { recursive: true });
+        await (0, import_promises95.writeFile)(dynamicSnippetFilePath, response.snippet);
       } catch (error50) {
         this.context.logger.error(`Failed to generate dynamic snippet for endpoint ${JSON.stringify(request7.endpoint)}: ${error50}`);
         if (error50 instanceof Error && error50.stack) {
@@ -879135,7 +879280,7 @@ var DynamicSnippetsGenerator3 = class extends AbstractDynamicSnippetsGenerator {
 };
 
 // ../generation/local-generation/local-workspace-runner/lib/dynamic-snippets/java/DynamicSnippetsJavaTestGenerator.js
-var import_promises95 = require("fs/promises");
+var import_promises96 = require("fs/promises");
 var import_path66 = __toESM(require("path"), 1);
 var DynamicSnippetsJavaTestGenerator = class {
   context;
@@ -879170,8 +879315,8 @@ var DynamicSnippetsJavaTestGenerator = class {
           endpointId
         });
         const dynamicSnippetFilePath = this.getTestFilePath({ absolutePathToOutputDir, idx });
-        await (0, import_promises95.mkdir)(import_path66.default.dirname(dynamicSnippetFilePath), { recursive: true });
-        await (0, import_promises95.writeFile)(dynamicSnippetFilePath, response.snippet);
+        await (0, import_promises96.mkdir)(import_path66.default.dirname(dynamicSnippetFilePath), { recursive: true });
+        await (0, import_promises96.writeFile)(dynamicSnippetFilePath, response.snippet);
       } catch (error50) {
         this.context.logger.error(`Failed to generate dynamic snippet for endpoint ${JSON.stringify(request7.endpoint)}: ${error50}`);
       }
@@ -879198,7 +879343,7 @@ var DynamicSnippetsJavaTestGenerator = class {
           const reportsPath = join8(outputDir, RelativeFilePath2.of("reports"));
           const buildReportsExists = await doesPathExist(buildReportsPath, "directory");
           if (buildReportsExists) {
-            await (0, import_promises95.cp)(buildReportsPath, reportsPath, { recursive: true });
+            await (0, import_promises96.cp)(buildReportsPath, reportsPath, { recursive: true });
             this.context.logger.info("Gradle profiling report copied to reports/");
           } else {
             this.context.logger.info("No profiling report found in build/reports/");
@@ -879212,7 +879357,7 @@ var DynamicSnippetsJavaTestGenerator = class {
   }
   async initializeProject(outputDir) {
     const absolutePathToOutputDir = join8(outputDir, RelativeFilePath2.of("src/main/java/com/snippets"));
-    await (0, import_promises95.mkdir)(absolutePathToOutputDir, { recursive: true });
+    await (0, import_promises96.mkdir)(absolutePathToOutputDir, { recursive: true });
     return absolutePathToOutputDir;
   }
   getTestFilePath({ absolutePathToOutputDir, idx }) {
@@ -882600,7 +882745,7 @@ var DynamicSnippetsGenerator4 = class extends AbstractDynamicSnippetsGenerator {
 };
 
 // ../generation/local-generation/local-workspace-runner/lib/dynamic-snippets/php/DynamicSnippetsPhpTestGenerator.js
-var import_promises96 = require("fs/promises");
+var import_promises97 = require("fs/promises");
 var import_path67 = __toESM(require("path"), 1);
 var DynamicSnippetsPhpTestGenerator = class {
   context;
@@ -882629,8 +882774,8 @@ var DynamicSnippetsPhpTestGenerator = class {
           endpointId
         });
         const dynamicSnippetFilePath = this.getTestFilePath({ outputDir, idx });
-        await (0, import_promises96.mkdir)(import_path67.default.dirname(dynamicSnippetFilePath), { recursive: true });
-        await (0, import_promises96.writeFile)(dynamicSnippetFilePath, response.snippet);
+        await (0, import_promises97.mkdir)(import_path67.default.dirname(dynamicSnippetFilePath), { recursive: true });
+        await (0, import_promises97.writeFile)(dynamicSnippetFilePath, response.snippet);
       } catch (error50) {
         this.context.logger.error(`Failed to generate dynamic snippet for endpoint ${JSON.stringify(request7.endpoint)}: ${error50}`);
       }
@@ -885831,7 +885976,7 @@ var DynamicSnippetsGenerator5 = class extends AbstractDynamicSnippetsGenerator {
 };
 
 // ../generation/local-generation/local-workspace-runner/lib/dynamic-snippets/python/DynamicSnippetsPythonTestGenerator.js
-var import_promises97 = require("fs/promises");
+var import_promises98 = require("fs/promises");
 var import_path68 = __toESM(require("path"), 1);
 var DynamicSnippetsPythonTestGenerator = class {
   context;
@@ -885860,8 +886005,8 @@ var DynamicSnippetsPythonTestGenerator = class {
           endpointId
         });
         const dynamicSnippetFilePath = this.getTestFilePath({ outputDir, idx });
-        await (0, import_promises97.mkdir)(import_path68.default.dirname(dynamicSnippetFilePath), { recursive: true });
-        await (0, import_promises97.writeFile)(dynamicSnippetFilePath, response.snippet);
+        await (0, import_promises98.mkdir)(import_path68.default.dirname(dynamicSnippetFilePath), { recursive: true });
+        await (0, import_promises98.writeFile)(dynamicSnippetFilePath, response.snippet);
       } catch (error50) {
         this.context.logger.error(`Failed to generate dynamic snippet for endpoint ${JSON.stringify(request7.endpoint)}: ${error50}`);
       }
@@ -888466,7 +888611,7 @@ var DynamicSnippetsGenerator6 = class extends AbstractDynamicSnippetsGenerator {
 };
 
 // ../generation/local-generation/local-workspace-runner/lib/dynamic-snippets/ruby/DynamicSnippetsRubyTestGenerator.js
-var import_promises98 = require("fs/promises");
+var import_promises99 = require("fs/promises");
 var import_path69 = __toESM(require("path"), 1);
 var DynamicSnippetsRubyTestGenerator = class {
   context;
@@ -888495,8 +888640,8 @@ var DynamicSnippetsRubyTestGenerator = class {
           endpointId
         });
         const dynamicSnippetFilePath = this.getTestFilePath({ outputDir, idx });
-        await (0, import_promises98.mkdir)(import_path69.default.dirname(dynamicSnippetFilePath), { recursive: true });
-        await (0, import_promises98.writeFile)(dynamicSnippetFilePath, response.snippet);
+        await (0, import_promises99.mkdir)(import_path69.default.dirname(dynamicSnippetFilePath), { recursive: true });
+        await (0, import_promises99.writeFile)(dynamicSnippetFilePath, response.snippet);
       } catch (error50) {
         this.context.logger.error(`Failed to generate dynamic snippet for endpoint ${JSON.stringify(request7.endpoint)}: ${error50}`);
         if (error50 instanceof Error && error50.stack) {
@@ -888512,7 +888657,7 @@ var DynamicSnippetsRubyTestGenerator = class {
 };
 
 // ../generation/local-generation/local-workspace-runner/lib/dynamic-snippets/rust/DynamicSnippetsRustTestGenerator.js
-var import_promises99 = require("fs/promises");
+var import_promises100 = require("fs/promises");
 var import_node_path24 = __toESM(require("path"), 1);
 init_lib6();
 
@@ -893746,8 +893891,8 @@ var DynamicSnippetsRustTestGenerator = class {
           absolutePathToOutputDir,
           idx
         });
-        await (0, import_promises99.mkdir)(import_node_path24.default.dirname(dynamicSnippetFilePath), { recursive: true });
-        await (0, import_promises99.writeFile)(dynamicSnippetFilePath, response.snippet);
+        await (0, import_promises100.mkdir)(import_node_path24.default.dirname(dynamicSnippetFilePath), { recursive: true });
+        await (0, import_promises100.writeFile)(dynamicSnippetFilePath, response.snippet);
       } catch (error50) {
         this.context.logger.error(`Failed to generate dynamic snippet for endpoint ${JSON.stringify(request7.endpoint)}: ${error50}`);
       }
@@ -893756,7 +893901,7 @@ var DynamicSnippetsRustTestGenerator = class {
   }
   async initializeProject(outputDir) {
     const absolutePathToOutputDir = join8(outputDir, RelativeFilePath2.of("dynamic-snippets"));
-    await (0, import_promises99.mkdir)(absolutePathToOutputDir, { recursive: true });
+    await (0, import_promises100.mkdir)(absolutePathToOutputDir, { recursive: true });
     return absolutePathToOutputDir;
   }
   getTestFilePath({ absolutePathToOutputDir, idx }) {
@@ -893765,7 +893910,7 @@ var DynamicSnippetsRustTestGenerator = class {
 };
 
 // ../generation/local-generation/local-workspace-runner/lib/dynamic-snippets/swift/DynamicSnippetsSwiftTestGenerator.js
-var import_promises100 = require("fs/promises");
+var import_promises101 = require("fs/promises");
 var import_node_path25 = __toESM(require("path"), 1);
 init_lib6();
 
@@ -898260,8 +898405,8 @@ var DynamicSnippetsSwiftTestGenerator = class {
           absolutePathToOutputDir,
           idx
         });
-        await (0, import_promises100.mkdir)(import_node_path25.default.dirname(dynamicSnippetFilePath), { recursive: true });
-        await (0, import_promises100.writeFile)(dynamicSnippetFilePath, response.snippet);
+        await (0, import_promises101.mkdir)(import_node_path25.default.dirname(dynamicSnippetFilePath), { recursive: true });
+        await (0, import_promises101.writeFile)(dynamicSnippetFilePath, response.snippet);
       } catch (error50) {
         this.context.logger.error(`Failed to generate dynamic snippet for endpoint ${JSON.stringify(request7.endpoint)}: ${error50}`);
       }
@@ -898270,7 +898415,7 @@ var DynamicSnippetsSwiftTestGenerator = class {
   }
   async initializeProject(outputDir) {
     const absolutePathToOutputDir = join8(outputDir, RelativeFilePath2.of("Snippets"));
-    await (0, import_promises100.mkdir)(absolutePathToOutputDir, { recursive: true });
+    await (0, import_promises101.mkdir)(absolutePathToOutputDir, { recursive: true });
     return absolutePathToOutputDir;
   }
   getTestFilePath({ absolutePathToOutputDir, idx }) {
@@ -900598,7 +900743,7 @@ var DynamicSnippetsGenerator9 = class extends AbstractDynamicSnippetsGenerator {
 };
 
 // ../generation/local-generation/local-workspace-runner/lib/dynamic-snippets/typescript/DynamicSnippetsTypeScriptTestGenerator.js
-var import_promises101 = require("fs/promises");
+var import_promises102 = require("fs/promises");
 var import_path70 = __toESM(require("path"), 1);
 var DynamicSnippetsTypeScriptTestGenerator = class {
   context;
@@ -900627,8 +900772,8 @@ var DynamicSnippetsTypeScriptTestGenerator = class {
           endpointId
         });
         const dynamicSnippetFilePath = this.getTestFilePath({ outputDir, idx });
-        await (0, import_promises101.mkdir)(import_path70.default.dirname(dynamicSnippetFilePath), { recursive: true });
-        await (0, import_promises101.writeFile)(dynamicSnippetFilePath, response.snippet);
+        await (0, import_promises102.mkdir)(import_path70.default.dirname(dynamicSnippetFilePath), { recursive: true });
+        await (0, import_promises102.writeFile)(dynamicSnippetFilePath, response.snippet);
       } catch (error50) {
         this.context.logger.error(`Failed to generate dynamic snippet for endpoint ${JSON.stringify(request7.endpoint)}: ${error50}`);
       }
@@ -900727,7 +900872,7 @@ async function generateDynamicSnippetTests({ context: context3, ir: ir15, config
 // ../generation/local-generation/local-workspace-runner/lib/runGenerator.js
 init_lib6();
 var import_serialization = __toESM(require_serialization2(), 1);
-var import_promises103 = require("fs/promises");
+var import_promises104 = require("fs/promises");
 var path70 = __toESM(require("path"), 1);
 var import_path72 = require("path");
 var import_tmp_promise13 = __toESM(require_tmp_promise(), 1);
@@ -901594,7 +901739,7 @@ function configureBamlClient(config5) {
 init_lib4();
 init_lib6();
 var import_decompress2 = __toESM(require_decompress(), 1);
-var import_promises102 = require("fs/promises");
+var import_promises103 = require("fs/promises");
 var import_os12 = require("os");
 var import_path71 = require("path");
 var import_semver13 = __toESM(require_semver2(), 1);
@@ -901774,7 +901919,7 @@ var LocalTaskHandler = class {
     try {
       this.context.logger.info("Analyzing SDK changes for automatic semantic versioning");
       diffFile = await this.generateDiffFile();
-      const diffContent = await (0, import_promises102.readFile)(diffFile, "utf-8");
+      const diffContent = await (0, import_promises103.readFile)(diffFile, "utf-8");
       if (diffContent.trim().length === 0) {
         this.context.logger.info("No changes detected in generated SDK");
         return null;
@@ -901972,7 +902117,7 @@ var LocalTaskHandler = class {
     } finally {
       if (diffFile) {
         try {
-          await (0, import_promises102.rm)(diffFile);
+          await (0, import_promises103.rm)(diffFile);
         } catch (cleanupError) {
           this.context.logger.warn(`Failed to delete temp diff file: ${diffFile}`, String(cleanupError));
         }
@@ -902134,7 +902279,7 @@ var LocalTaskHandler = class {
     const absolutePathToFernignore = AbsoluteFilePath2.of(join8(this.absolutePathToLocalOutput, RelativeFilePath2.of(FERNIGNORE_FILENAME)));
     const fernIgnorePaths = await getFernIgnorePaths({ absolutePathToFernignore });
     const pathsToPreserve = await this.getPathsToPreserve(fernIgnorePaths);
-    await (0, import_promises102.cp)(this.absolutePathToLocalOutput, tmpOutputResolutionDir, { recursive: true });
+    await (0, import_promises103.cp)(this.absolutePathToLocalOutput, tmpOutputResolutionDir, { recursive: true });
     await this.runThrowawayGitCommand(["init"], tmpOutputResolutionDir);
     await this.runThrowawayGitCommand(["add", "."], tmpOutputResolutionDir);
     await this.runThrowawayGitCommand([
@@ -902154,17 +902299,17 @@ var LocalTaskHandler = class {
     await this.runThrowawayGitCommand(["reset", "--", ...pathsToPreserve], tmpOutputResolutionDir);
     await this.runThrowawayGitCommand(["clean", "-fd", "--", ...pathsToPreserve], tmpOutputResolutionDir);
     await this.runThrowawayGitCommand(["restore", "."], tmpOutputResolutionDir);
-    await (0, import_promises102.rm)(join8(tmpOutputResolutionDir, RelativeFilePath2.of(".git")), { recursive: true });
-    await (0, import_promises102.rm)(this.absolutePathToLocalOutput, { recursive: true });
-    await (0, import_promises102.cp)(tmpOutputResolutionDir, this.absolutePathToLocalOutput, { recursive: true });
+    await (0, import_promises103.rm)(join8(tmpOutputResolutionDir, RelativeFilePath2.of(".git")), { recursive: true });
+    await (0, import_promises103.rm)(this.absolutePathToLocalOutput, { recursive: true });
+    await (0, import_promises103.cp)(tmpOutputResolutionDir, this.absolutePathToLocalOutput, { recursive: true });
   }
   async copyGeneratedFilesNoFernIgnorePreservingGit() {
-    const contents = await (0, import_promises102.readdir)(this.absolutePathToLocalOutput);
+    const contents = await (0, import_promises103.readdir)(this.absolutePathToLocalOutput);
     const itemsToPreserve = [".git"];
     if (await this.generatedOutputMissingReadme()) {
       itemsToPreserve.push("README.md");
     }
-    await Promise.all(contents.filter((item) => !itemsToPreserve.includes(item)).map((item) => (0, import_promises102.rm)(join8(this.absolutePathToLocalOutput, RelativeFilePath2.of(item)), {
+    await Promise.all(contents.filter((item) => !itemsToPreserve.includes(item)).map((item) => (0, import_promises103.rm)(join8(this.absolutePathToLocalOutput, RelativeFilePath2.of(item)), {
       force: true,
       recursive: true
     })));
@@ -902172,11 +902317,11 @@ var LocalTaskHandler = class {
   }
   async copyGeneratedFilesNoFernIgnoreDeleteAll() {
     this.context.logger.debug(`rm -rf ${this.absolutePathToLocalOutput}`);
-    await (0, import_promises102.rm)(this.absolutePathToLocalOutput, { force: true, recursive: true });
+    await (0, import_promises103.rm)(this.absolutePathToLocalOutput, { force: true, recursive: true });
     await this.copyGeneratedFilesToDirectory(this.absolutePathToLocalOutput);
   }
   async copyGeneratedFilesToDirectory(outputPath) {
-    const [firstLocalOutputItem, ...remaininglocalOutputItems] = await (0, import_promises102.readdir)(this.absolutePathToTmpOutputDirectory);
+    const [firstLocalOutputItem, ...remaininglocalOutputItems] = await (0, import_promises103.readdir)(this.absolutePathToTmpOutputDirectory);
     if (firstLocalOutputItem == null) {
       return;
     }
@@ -902184,15 +902329,15 @@ var LocalTaskHandler = class {
     if (firstLocalOutputItem.endsWith(".zip")) {
       await (0, import_decompress2.default)(join8(this.absolutePathToTmpOutputDirectory, RelativeFilePath2.of(firstLocalOutputItem)), outputPath);
       for (const localOutputItem of remaininglocalOutputItems) {
-        await (0, import_promises102.cp)(join8(this.absolutePathToTmpOutputDirectory, RelativeFilePath2.of(localOutputItem)), join8(outputPath, RelativeFilePath2.of(localOutputItem)), { recursive: true });
+        await (0, import_promises103.cp)(join8(this.absolutePathToTmpOutputDirectory, RelativeFilePath2.of(localOutputItem)), join8(outputPath, RelativeFilePath2.of(localOutputItem)), { recursive: true });
       }
     } else {
-      await (0, import_promises102.cp)(this.absolutePathToTmpOutputDirectory, outputPath, { recursive: true });
+      await (0, import_promises103.cp)(this.absolutePathToTmpOutputDirectory, outputPath, { recursive: true });
     }
   }
   async copySnippetJSON({ absolutePathToTmpSnippetJSON, absolutePathToLocalSnippetJSON }) {
     this.context.logger.debug(`Copying generated snippets to ${absolutePathToLocalSnippetJSON}`);
-    await (0, import_promises102.cp)(absolutePathToTmpSnippetJSON, absolutePathToLocalSnippetJSON);
+    await (0, import_promises103.cp)(absolutePathToTmpSnippetJSON, absolutePathToLocalSnippetJSON);
   }
   /**
    * Checks whether the generated output is missing README.md.
@@ -902201,7 +902346,7 @@ var LocalTaskHandler = class {
    */
   async generatedOutputMissingReadme() {
     try {
-      const contents = await (0, import_promises102.readdir)(this.absolutePathToTmpOutputDirectory);
+      const contents = await (0, import_promises103.readdir)(this.absolutePathToTmpOutputDirectory);
       if (contents.length === 1 && contents[0] != null && contents[0].endsWith(".zip")) {
         return false;
       }
@@ -902244,13 +902389,13 @@ var LocalTaskHandler = class {
   async readPriorChangelog(maxEntries) {
     const MAX_CHANGELOG_SIZE = 2048;
     try {
-      const files = await (0, import_promises102.readdir)(this.absolutePathToLocalOutput);
+      const files = await (0, import_promises103.readdir)(this.absolutePathToLocalOutput);
       const changelogFile = files.find((f10) => f10.toLowerCase() === "changelog.md");
       if (!changelogFile) {
         return "";
       }
       const changelogPath = join8(this.absolutePathToLocalOutput, RelativeFilePath2.of(changelogFile));
-      const content5 = await (0, import_promises102.readFile)(changelogPath, "utf-8");
+      const content5 = await (0, import_promises103.readFile)(changelogPath, "utf-8");
       if (content5.trim().length === 0) {
         return "";
       }
@@ -902360,24 +902505,24 @@ async function writeFilesToDiskAndRunGenerator({ organization, absolutePathToFer
   context3.logger.debug("Wrote IR to: " + absolutePathToIr);
   const configJsonFile = (0, import_path72.join)(workspaceTempDir.path, GENERATOR_CONFIG_FILENAME);
   const absolutePathToWriteConfigJson = AbsoluteFilePath2.of(configJsonFile);
-  await (0, import_promises103.writeFile)(configJsonFile, "");
+  await (0, import_promises104.writeFile)(configJsonFile, "");
   context3.logger.debug("Will write config.json to: " + absolutePathToWriteConfigJson);
   const tmpOutputDirectory = (0, import_path72.join)(workspaceTempDir.path, CODEGEN_OUTPUT_DIRECTORY_NAME);
   const absolutePathToTmpOutputDirectory = AbsoluteFilePath2.of(tmpOutputDirectory);
-  await (0, import_promises103.mkdir)(tmpOutputDirectory, { recursive: true });
+  await (0, import_promises104.mkdir)(tmpOutputDirectory, { recursive: true });
   context3.logger.debug("Will write output to: " + absolutePathToTmpOutputDirectory);
   let absolutePathToTmpSnippetJSON = void 0;
   if (absolutePathToLocalSnippetJSON != null) {
     const snippetJsonFile = (0, import_path72.join)(workspaceTempDir.path, "snippet.json");
     absolutePathToTmpSnippetJSON = AbsoluteFilePath2.of(snippetJsonFile);
-    await (0, import_promises103.writeFile)(snippetJsonFile, "");
+    await (0, import_promises104.writeFile)(snippetJsonFile, "");
     context3.logger.debug("Will write snippet.json to: " + absolutePathToTmpSnippetJSON);
   }
   let absolutePathToTmpSnippetTemplatesJSON = void 0;
   if (absolutePathToLocalSnippetTemplateJSON != null) {
     const snippetTemplatesJsonFile = (0, import_path72.join)(workspaceTempDir.path, SNIPPET_TEMPLATES_JSON_FILENAME);
     absolutePathToTmpSnippetTemplatesJSON = AbsoluteFilePath2.of(snippetTemplatesJsonFile);
-    await (0, import_promises103.writeFile)(snippetTemplatesJsonFile, "");
+    await (0, import_promises104.writeFile)(snippetTemplatesJsonFile, "");
     context3.logger.debug("Will write snippet-templates.json to: " + absolutePathToTmpSnippetTemplatesJSON);
   }
   const environment2 = executionEnvironment ?? new ContainerExecutionEnvironment({
@@ -902416,7 +902561,7 @@ async function writeFilesToDiskAndRunGenerator({ organization, absolutePathToFer
     publishToRegistry,
     paths
   });
-  await (0, import_promises103.writeFile)(absolutePathToWriteConfigJson, JSON.stringify(await import_serialization.GeneratorConfig.jsonOrThrow(config5), void 0, 4));
+  await (0, import_promises104.writeFile)(absolutePathToWriteConfigJson, JSON.stringify(await import_serialization.GeneratorConfig.jsonOrThrow(config5), void 0, 4));
   const absolutePathToLicenseFile = extractLicenseFilePath(generatorInvocation, absolutePathToFernConfig);
   const sourceMounts = workspace.getSources().filter((source2) => source2.type === "protobuf").map((source2) => ({
     hostPath: source2.absoluteFilePath,
@@ -903040,13 +903185,13 @@ var GenerationRunner = class {
 };
 
 // ../cli-v2/lib/sdk/generator/LegacyLocalGenerationRunner.js
-var import_promises105 = require("fs/promises");
+var import_promises106 = require("fs/promises");
 
 // ../cli-v2/lib/sdk/adapter/LegacyGeneratorInvocationAdapter.js
 init_lib4();
 init_lib6();
 init_lib7();
-var import_promises104 = require("fs/promises");
+var import_promises105 = require("fs/promises");
 var LegacyGeneratorInvocationAdapter = class {
   context;
   constructor(config5) {
@@ -903286,7 +903431,7 @@ var LegacyGeneratorInvocationAdapter = class {
     if (!await doesPathExist(absolutePath, "file")) {
       throw new Error(`Custom license file "${absolutePath}" does not exist; did you mean to use either MIT or Apache-2.0?`);
     }
-    const contents = await (0, import_promises104.readFile)(absolutePath, "utf-8");
+    const contents = await (0, import_promises105.readFile)(absolutePath, "utf-8");
     return api_exports5.GithubLicense.custom({ contents });
   }
   buildReadme(target) {
@@ -903510,7 +903655,7 @@ var LegacyLocalGenerationRunner = class {
     });
     if (args.target.output.path != null && generatorInvocation.absolutePathToLocalOutput != null) {
       const snippetPath = join8(generatorInvocation.absolutePathToLocalOutput, RelativeFilePath2.of(SNIPPET_JSON_FILENAME));
-      await (0, import_promises105.rm)(snippetPath, { force: true });
+      await (0, import_promises106.rm)(snippetPath, { force: true });
     }
     if (taskContext.getResult() === TaskResult.Failure) {
       return {
@@ -903527,7 +903672,7 @@ var LegacyLocalGenerationRunner = class {
 // ../cli-v2/lib/sdk/generator/LegacyRemoteGenerationRunner.js
 init_lib4();
 init_lib6();
-var import_promises106 = require("fs/promises");
+var import_promises107 = require("fs/promises");
 var import_os14 = require("os");
 var LegacyRemoteGenerationRunner = class {
   context;
@@ -903582,13 +903727,13 @@ var LegacyRemoteGenerationRunner = class {
         const previewOutputDirectory = join8(absolutePathToPreview, RelativeFilePath2.of(generatorName));
         const targetOutputDirectory = generatorInvocation.absolutePathToLocalOutput;
         if (targetOutputDirectory != null) {
-          await (0, import_promises106.cp)(previewOutputDirectory, targetOutputDirectory, { recursive: true });
-          await (0, import_promises106.rm)(join8(targetOutputDirectory, RelativeFilePath2.of(".git")), {
+          await (0, import_promises107.cp)(previewOutputDirectory, targetOutputDirectory, { recursive: true });
+          await (0, import_promises107.rm)(join8(targetOutputDirectory, RelativeFilePath2.of(".git")), {
             recursive: true,
             force: true
           });
         }
-        await (0, import_promises106.rm)(absolutePathToPreview, { recursive: true, force: true });
+        await (0, import_promises107.rm)(absolutePathToPreview, { recursive: true, force: true });
       }
       if (taskContext.getResult() === TaskResult.Failure) {
         return {
@@ -903617,7 +903762,7 @@ var LegacyRemoteGenerationRunner = class {
   }
   async getAbsolutePathToPreview(args) {
     if (this.isLocalGitCombo(args)) {
-      const tmpPreviewDirectory = await (0, import_promises106.mkdtemp)(join8(AbsoluteFilePath2.of((0, import_os14.tmpdir)()), RelativeFilePath2.of("fern-preview-")));
+      const tmpPreviewDirectory = await (0, import_promises107.mkdtemp)(join8(AbsoluteFilePath2.of((0, import_os14.tmpdir)()), RelativeFilePath2.of("fern-preview-")));
       return AbsoluteFilePath2.of(tmpPreviewDirectory);
     }
     if (!args.preview) {
@@ -903966,7 +904111,8 @@ var GenerateCommand = class {
         org: args.org
       };
     }
-    const targets2 = this.getTargets({
+    const targets2 = await this.getTargets({
+      context: context3,
       workspace: workspaceWithOverrides,
       args,
       groupName: args.target != null ? void 0 : args.group ?? workspaceWithOverrides.sdks?.defaultGroup
@@ -903999,10 +904145,13 @@ var GenerateCommand = class {
         code: CliError.Code.ConfigError
       });
     }
-    const api = args.api;
-    const target = args.target;
-    const org = args.org;
-    const output2 = args.output;
+    if (args.api == null || args.target == null || args.org == null || args.output == null) {
+      throw new CliError({
+        message: "Internal error: required flags missing",
+        code: CliError.Code.InternalError
+      });
+    }
+    const { api, target, org, output: output2 } = args;
     const resolver2 = new ApiSpecResolver({ context: context3 });
     const resolvedSpec = await resolver2.resolve({
       reference: api
@@ -904251,19 +904400,70 @@ Example:
     }
     return { path: args.output };
   }
-  getTargets({ workspace, args, groupName }) {
+  async getTargets({ context: context3, workspace, args, groupName }) {
     let matched = workspace.sdks != null ? this.filterTargetsByGroup(workspace.sdks.targets, groupName) : [];
     if (args.target != null) {
       matched = matched.filter((t3) => t3.name === args.target);
       if (matched.length === 0) {
-        throw new Error(`Target '${args.target}' not found`);
+        const allTargets = workspace.sdks?.targets ?? [];
+        const available = allTargets.map((t3) => t3.name);
+        if (available.length > 0) {
+          throw new CliError({
+            message: `Target '${args.target}' not found. Available targets: ${available.join(", ")}`,
+            code: CliError.Code.ConfigError
+          });
+        } else {
+          throw new CliError({
+            message: `Target '${args.target}' not found`,
+            code: CliError.Code.ConfigError
+          });
+        }
       }
     }
     if (matched.length === 0) {
       if (groupName != null) {
-        throw new Error(`No targets found for group '${groupName}'`);
+        throw new CliError({
+          message: `No targets found for group '${groupName}'`,
+          code: CliError.Code.ConfigError
+        });
+      }
+      throw new CliError({
+        message: "No targets configured in fern.yml",
+        code: CliError.Code.ConfigError
+      });
+    }
+    if (groupName == null && args.target == null && matched.length > 1) {
+      const allGroups = this.collectGroups(matched);
+      if (allGroups.length > 1) {
+        const selectedGroup = await promptSelect({
+          isTTY: context3.isTTY,
+          message: "Multiple SDK groups found. Select one:",
+          choices: [
+            { name: `all (${matched.length} targets)`, value: void 0 },
+            ...allGroups.map((g19) => ({ name: g19, value: g19 }))
+          ],
+          nonInteractiveError: `Multiple SDK groups found: ${allGroups.join(", ")}. Use --group to select one.`,
+          flagHint: (value) => value != null ? `--group ${value}` : void 0
+        });
+        if (selectedGroup != null) {
+          matched = this.filterTargetsByGroup(matched, selectedGroup);
+        }
+      } else {
+        const targetNames = matched.map((t3) => t3.name);
+        const selectedTarget = await promptSelect({
+          isTTY: context3.isTTY,
+          message: "Multiple SDK targets found. Select one:",
+          choices: [
+            { name: `all (${matched.length} targets)`, value: void 0 },
+            ...targetNames.map((name2) => ({ name: name2, value: name2 }))
+          ],
+          nonInteractiveError: `Multiple SDK targets found: ${targetNames.join(", ")}. Use --target to select one.`,
+          flagHint: (value) => value != null ? `--target ${value}` : void 0
+        });
+        if (selectedTarget != null) {
+          matched = matched.filter((t3) => t3.name === selectedTarget);
+        }
       }
-      throw new Error("No targets configured in fern.yml");
     }
     return matched.map((target) => ({
       ...target,
@@ -904271,6 +904471,17 @@ Example:
       output: args.output != null ? this.parseTargetOutput(args) : target.output
     }));
   }
+  collectGroups(targets2) {
+    const groups2 = /* @__PURE__ */ new Set();
+    for (const target of targets2) {
+      if (target.groups != null) {
+        for (const group of target.groups) {
+          groups2.add(group);
+        }
+      }
+    }
+    return [...groups2].sort();
+  }
   async checkOutputDirectory({ context: context3, args, outputPath }) {
     if (args.force || !context3.isTTY) {
       return { shouldProceed: true };
@@ -904279,7 +904490,7 @@ Example:
     if (!exists2) {
       return { shouldProceed: true };
     }
-    const files = await (0, import_promises107.readdir)(outputPath);
+    const files = await (0, import_promises108.readdir)(outputPath);
     if (files.length === 0) {
       return { shouldProceed: true };
     }
@@ -904300,11 +904511,13 @@ Example:
     return targets2.filter((target) => target.groups?.includes(groupName));
   }
   resolveLanguage(target) {
-    const lang = target;
-    if (LANGUAGES.includes(lang)) {
-      return lang;
+    if (isLanguage(target)) {
+      return target;
     }
-    throw new Error(`"${target}" is not a supported language. Supported: ${LANGUAGES.join(", ")}`);
+    throw new CliError({
+      message: `"${target}" is not a supported language. Supported: ${LANGUAGES.join(", ")}`,
+      code: CliError.Code.ConfigError
+    });
   }
   parseAudiences(audiences) {
     if (audiences == null || audiences.length === 0) {
@@ -904356,6 +904569,9 @@ Example:
     return text9.trimEnd().split("\n").map((line) => line.length > 0 ? `  ${line}` : line).join("\n");
   }
 };
+function isLanguage(target) {
+  return LANGUAGES.includes(target);
+}
 function addGenerateCommand(cli) {
   const cmd = new GenerateCommand();
   command2(cli, "generate", "Generate SDKs from fern.yml or directly from an API spec", async (context3, args) => {
@@ -904505,7 +904721,7 @@ init_lib4();
 // ../cli-v2/lib/sdk/updater/GeneratorMigrator.js
 init_lib4();
 var import_fs29 = require("fs");
-var import_promises108 = require("fs/promises");
+var import_promises109 = require("fs/promises");
 var import_path75 = require("path");
 var import_semver14 = __toESM(require_semver2(), 1);
 var import_url8 = require("url");
@@ -904615,7 +904831,7 @@ var GeneratorMigrator = class _GeneratorMigrator {
     }
     this.migrationsInstallPromise = (async () => {
       const cacheDir = this.cachePath;
-      await (0, import_promises108.mkdir)(cacheDir, { recursive: true });
+      await (0, import_promises109.mkdir)(cacheDir, { recursive: true });
       const npmCacheDir = (0, import_path75.join)(cacheDir, ".npm-cache");
       const packageDir = (0, import_path75.join)(cacheDir, "node_modules", MIGRATION_PACKAGE_NAME);
       const packageJsonPath = (0, import_path75.join)(packageDir, "package.json");
@@ -904632,7 +904848,7 @@ var GeneratorMigrator = class _GeneratorMigrator {
           "--no-audit",
           "--no-fund"
         ], { doNotPipeOutput: true });
-        const packageJsonContent = await (0, import_promises108.readFile)(packageJsonPath, "utf-8");
+        const packageJsonContent = await (0, import_promises109.readFile)(packageJsonPath, "utf-8");
         const packageJson2 = JSON.parse(packageJsonContent);
         if (packageJson2.main == null) {
           throw new Error(`No main field found in package.json for ${MIGRATION_PACKAGE_NAME}`);
@@ -904674,7 +904890,7 @@ var GeneratorMigrator = class _GeneratorMigrator {
     const myPid = String(process.pid);
     while (true) {
       try {
-        const fh = await (0, import_promises108.open)(lockPath, "wx");
+        const fh = await (0, import_promises109.open)(lockPath, "wx");
         await fh.writeFile(myPid);
         await fh.close();
         const exitHandler = () => {
@@ -904691,9 +904907,9 @@ var GeneratorMigrator = class _GeneratorMigrator {
         return async () => {
           process.removeListener("exit", exitHandler);
           try {
-            const currentContent = await (0, import_promises108.readFile)(lockPath, "utf-8");
+            const currentContent = await (0, import_promises109.readFile)(lockPath, "utf-8");
             if (currentContent.trim() === myPid) {
-              await (0, import_promises108.unlink)(lockPath);
+              await (0, import_promises109.unlink)(lockPath);
             } else {
               logger4.debug(`Lock file owned by another process (expected pid=${myPid}, found=${currentContent.trim()}); skipping release`);
             }
@@ -904707,14 +904923,14 @@ var GeneratorMigrator = class _GeneratorMigrator {
           throw err;
         }
         try {
-          const lockContent = await (0, import_promises108.readFile)(lockPath, "utf-8");
+          const lockContent = await (0, import_promises109.readFile)(lockPath, "utf-8");
           const lockPid = Number(lockContent.trim());
-          const lockStat = await (0, import_promises108.stat)(lockPath);
+          const lockStat = await (0, import_promises109.stat)(lockPath);
           const lockAge = Date.now() - lockStat.mtimeMs;
           if (lockAge > _GeneratorMigrator.LOCK_STALE_MS || Number.isFinite(lockPid) && lockPid > 0 && !_GeneratorMigrator.isProcessAlive(lockPid)) {
             logger4.debug(`Removing stale migration lock (pid=${lockContent.trim()}, age=${lockAge}ms)`);
             try {
-              await (0, import_promises108.unlink)(lockPath);
+              await (0, import_promises109.unlink)(lockPath);
             } catch (unlinkErr) {
               logger4.debug(`Failed to remove stale lock: ${unlinkErr}`);
             }
@@ -905189,13 +905405,13 @@ var import_generator_cli2 = __toESM(require_api4(), 1);
 
 // ../init/lib/initializeAPI.js
 init_lib6();
-var import_promises112 = require("fs/promises");
+var import_promises113 = require("fs/promises");
 var import_fs_extra = __toESM(require_lib19(), 1);
 var import_path76 = __toESM(require("path"), 1);
 
 // ../init/lib/createFernDirectoryAndOrganization.js
 init_lib6();
-var import_promises109 = require("fs/promises");
+var import_promises110 = require("fs/promises");
 init_lodash();
 var GITIGNORE_CONTENT = "**/.preview\n**/.definition\n";
 async function createFernDirectoryAndWorkspace({ organization, taskContext, versionOfCli }) {
@@ -905225,7 +905441,7 @@ async function createFernDirectoryAndWorkspace({ organization, taskContext, vers
         }
       }
     }
-    await (0, import_promises109.mkdir)(FERN_DIRECTORY);
+    await (0, import_promises110.mkdir)(FERN_DIRECTORY);
     await writeProjectConfig({
       filepath: join8(pathToFernDirectory, RelativeFilePath2.of(PROJECT_CONFIG_FILENAME)),
       organization,
@@ -905249,11 +905465,11 @@ async function writeProjectConfig({ organization, filepath, versionOfCli }) {
     organization,
     version: versionOfCli
   };
-  await (0, import_promises109.writeFile)(filepath, JSON.stringify(projectConfig, void 0, 4));
+  await (0, import_promises110.writeFile)(filepath, JSON.stringify(projectConfig, void 0, 4));
 }
 async function writeGitignore({ absolutePathToFernDirectory }) {
   const gitignorePath = join8(absolutePathToFernDirectory, RelativeFilePath2.of(".gitignore"));
-  await (0, import_promises109.writeFile)(gitignorePath, GITIGNORE_CONTENT);
+  await (0, import_promises110.writeFile)(gitignorePath, GITIGNORE_CONTENT);
 }
 
 // ../fern-definition/formatter/lib/FernDefinitionFileFormatter.js
@@ -905442,7 +905658,7 @@ async function formatDefinitionFile({ fileContents }) {
 
 // ../fern-definition/formatter/lib/formatWorkspace.js
 init_lib4();
-var import_promises110 = require("fs/promises");
+var import_promises111 = require("fs/promises");
 async function formatFernWorkspace({ workspace, context: context3, shouldFix }) {
   for (const [relativeFilepath, file4] of entries(workspace.definition.namedDefinitionFiles)) {
     const formatted = await formatDefinitionFile({
@@ -905450,7 +905666,7 @@ async function formatFernWorkspace({ workspace, context: context3, shouldFix })
     });
     if (formatted !== file4.rawContents) {
       if (shouldFix) {
-        await (0, import_promises110.writeFile)(file4.absoluteFilePath, formatted);
+        await (0, import_promises111.writeFile)(file4.absoluteFilePath, formatted);
         context3.logger.info(source_default.green(`Formatted ${source_default.bold(relativeFilepath)}`));
       } else {
         context3.logger.info(source_default.red(`Invalid formatting: ${source_default.bold(relativeFilepath)}`));
@@ -905462,7 +905678,7 @@ async function formatFernWorkspace({ workspace, context: context3, shouldFix })
 
 // ../init/lib/createWorkspace.js
 init_lib6();
-var import_promises111 = require("fs/promises");
+var import_promises112 = require("fs/promises");
 
 // ../init/lib/sampleImdbApi.js
 var SAMPLE_IMDB_API = `
@@ -905662,7 +905878,7 @@ components:
 // ../init/lib/createWorkspace.js
 async function createFernWorkspace({ directoryOfWorkspace, cliVersion, context: context3, apiName = "api" }) {
   if (!await doesPathExist(directoryOfWorkspace)) {
-    await (0, import_promises111.mkdir)(directoryOfWorkspace);
+    await (0, import_promises112.mkdir)(directoryOfWorkspace);
   }
   await writeGeneratorsConfiguration({
     filepath: join8(directoryOfWorkspace, RelativeFilePath2.of(GENERATORS_CONFIGURATION_FILENAME)),
@@ -905677,7 +905893,7 @@ async function createFernWorkspace({ directoryOfWorkspace, cliVersion, context:
 }
 async function createOpenAPIWorkspace({ directoryOfWorkspace, openAPIFilePath, cliVersion, context: context3 }) {
   if (!await doesPathExist(directoryOfWorkspace)) {
-    await (0, import_promises111.mkdir)(directoryOfWorkspace);
+    await (0, import_promises112.mkdir)(directoryOfWorkspace);
   }
   await writeGeneratorsConfiguration({
     filepath: join8(directoryOfWorkspace, RelativeFilePath2.of(GENERATORS_CONFIGURATION_FILENAME)),
@@ -905690,10 +905906,10 @@ async function createOpenAPIWorkspace({ directoryOfWorkspace, openAPIFilePath, c
 }
 async function createDefaultOpenAPIWorkspace({ directoryOfWorkspace, cliVersion, context: context3 }) {
   if (!await doesPathExist(directoryOfWorkspace)) {
-    await (0, import_promises111.mkdir)(directoryOfWorkspace, { recursive: true });
+    await (0, import_promises112.mkdir)(directoryOfWorkspace, { recursive: true });
   }
   const openApiFilePath = join8(directoryOfWorkspace, RelativeFilePath2.of("openapi.yml"));
-  await (0, import_promises111.writeFile)(openApiFilePath, SAMPLE_OPENAPI);
+  await (0, import_promises112.writeFile)(openApiFilePath, SAMPLE_OPENAPI);
   await writeGeneratorsConfiguration({
     filepath: join8(directoryOfWorkspace, RelativeFilePath2.of(GENERATORS_CONFIGURATION_FILENAME)),
     cliVersion,
@@ -905738,7 +905954,7 @@ async function getDefaultGeneratorsConfiguration({ cliVersion, context: context3
   return config5;
 }
 async function writeGeneratorsConfiguration({ filepath, cliVersion, context: context3, apiConfiguration }) {
-  await (0, import_promises111.writeFile)(filepath, "# yaml-language-server: $schema=https://schema.buildwithfern.dev/generators-yml.json\n" + jsYaml.dump(await getDefaultGeneratorsConfiguration({ cliVersion, context: context3, apiConfiguration }), {
+  await (0, import_promises112.writeFile)(filepath, "# yaml-language-server: $schema=https://schema.buildwithfern.dev/generators-yml.json\n" + jsYaml.dump(await getDefaultGeneratorsConfiguration({ cliVersion, context: context3, apiConfiguration }), {
     sortKeys: (a10, b19) => {
       if (a10 === "api") {
         return -1;
@@ -905757,10 +905973,10 @@ async function writeSampleApiDefinition({ directoryOfDefinition, apiName }) {
       strategy: "status-code"
     }
   };
-  await (0, import_promises111.mkdir)(directoryOfDefinition);
-  await (0, import_promises111.writeFile)(join8(directoryOfDefinition, RelativeFilePath2.of(ROOT_API_FILENAME)), jsYaml.dump(rootApi));
+  await (0, import_promises112.mkdir)(directoryOfDefinition);
+  await (0, import_promises112.writeFile)(join8(directoryOfDefinition, RelativeFilePath2.of(ROOT_API_FILENAME)), jsYaml.dump(rootApi));
   const absoluteFilepathToImdbYaml = join8(directoryOfDefinition, RelativeFilePath2.of("imdb.yml"));
-  await (0, import_promises111.writeFile)(absoluteFilepathToImdbYaml, await formatDefinitionFile({
+  await (0, import_promises112.writeFile)(absoluteFilepathToImdbYaml, await formatDefinitionFile({
     fileContents: SAMPLE_IMDB_API
   }));
 }
@@ -905813,7 +906029,7 @@ async function getDirectoryOfNewAPIWorkspace({ absolutePathToFernDirectory, task
   if (inlinedApiDefinition || inlinedOpenApiWorkspace) {
     taskContext.logger.info("Creating workspaces to support multiple API Definitions.");
     const apiWorkspaceDirectory = join8(absolutePathToFernDirectory, RelativeFilePath2.of(APIS_DIRECTORY), RelativeFilePath2.of("api"));
-    await (0, import_promises112.mkdir)(apiWorkspaceDirectory, { recursive: true });
+    await (0, import_promises113.mkdir)(apiWorkspaceDirectory, { recursive: true });
     if (inlinedApiDefinition) {
       const inlinedDefinitionDirectory = join8(absolutePathToFernDirectory, RelativeFilePath2.of(DEFINITION_DIRECTORY));
       const workspaceDefinitionDirectory = join8(apiWorkspaceDirectory, RelativeFilePath2.of(DEFINITION_DIRECTORY));
@@ -905850,7 +906066,7 @@ async function hasInlinedOpenAPIWorkspace({ absolutePathToFernDirectory }) {
 // ../init/lib/initializeDocs.js
 init_lib4();
 init_lib6();
-var import_promises113 = require("fs/promises");
+var import_promises114 = require("fs/promises");
 async function initializeDocs({ organization, taskContext, versionOfCli }) {
   const createDirectoryResponse = await createFernDirectoryAndWorkspace({
     organization,
@@ -905865,7 +906081,7 @@ async function initializeDocs({ organization, taskContext, versionOfCli }) {
     } else {
       try {
         const docsConfig = getDocsConfig(createDirectoryResponse.organization);
-        await (0, import_promises113.writeFile)(docsYmlPath, jsYaml.dump(docsConfig));
+        await (0, import_promises114.writeFile)(docsYmlPath, jsYaml.dump(docsConfig));
         taskContext.logger.info(source_default.green("Created docs configuration"));
         return;
       } catch (writeError) {
@@ -905920,7 +906136,7 @@ var FernDocsBuilder = class {
 
 // ../docs-importers/commons/lib/FernDocsBuilderImpl.js
 init_lib6();
-var import_promises114 = require("fs/promises");
+var import_promises115 = require("fs/promises");
 var FernDocsBuilderImpl = class extends FernDocsBuilder {
   openApiSpecs = {};
   nonTabbedNavigation = new NonTabbedNavigationBuilderImpl();
@@ -905979,7 +906195,7 @@ var FernDocsBuilderImpl = class extends FernDocsBuilder {
   }
   async build({ outputDirectory }) {
     const absolutePathToFernDirectory = join8(outputDirectory, RelativeFilePath2.of(FERN_DIRECTORY));
-    await (0, import_promises114.mkdir)(absolutePathToFernDirectory, { recursive: true });
+    await (0, import_promises115.mkdir)(absolutePathToFernDirectory, { recursive: true });
     if (Object.keys(this.tabbedNavigation).length > 0) {
       this.docsYml.tabs = Object.fromEntries(Object.entries(this.tabbedNavigation).map(([key2, value]) => {
         return [value.tabId, value.tabConfig];
@@ -906004,27 +906220,27 @@ var FernDocsBuilderImpl = class extends FernDocsBuilder {
           }))
         };
       }
-      await (0, import_promises114.writeFile)(join8(absolutePathToFernDirectory, RelativeFilePath2.of(GENERATORS_CONFIGURATION_FILENAME)), jsYaml.dump(generators_yml_exports.serialization.GeneratorsConfigurationSchema.jsonOrThrow(this.generatorsYml)));
+      await (0, import_promises115.writeFile)(join8(absolutePathToFernDirectory, RelativeFilePath2.of(GENERATORS_CONFIGURATION_FILENAME)), jsYaml.dump(generators_yml_exports.serialization.GeneratorsConfigurationSchema.jsonOrThrow(this.generatorsYml)));
       await Promise.all(Object.entries(this.openApiSpecs).map(async ([relativePath, absolutePath]) => {
         const absolutePathToOpenAPI = join8(absolutePathToFernDirectory, RelativeFilePath2.of(relativePath));
-        await (0, import_promises114.mkdir)(dirname6(absolutePathToOpenAPI), { recursive: true });
-        await (0, import_promises114.cp)(absolutePath, absolutePathToOpenAPI);
+        await (0, import_promises115.mkdir)(dirname6(absolutePathToOpenAPI), { recursive: true });
+        await (0, import_promises115.cp)(absolutePath, absolutePathToOpenAPI);
       }));
     }
-    await (0, import_promises114.writeFile)(join8(absolutePathToFernDirectory, RelativeFilePath2.of(DOCS_CONFIGURATION_FILENAME)), jsYaml.dump(docs_yml_exports.RawSchemas.Serializer.DocsConfiguration.jsonOrThrow(this.docsYml, { omitUndefined: true })));
+    await (0, import_promises115.writeFile)(join8(absolutePathToFernDirectory, RelativeFilePath2.of(DOCS_CONFIGURATION_FILENAME)), jsYaml.dump(docs_yml_exports.RawSchemas.Serializer.DocsConfiguration.jsonOrThrow(this.docsYml, { omitUndefined: true })));
     await Promise.all(Object.entries(this.markdownPages).map(async ([filepath, page]) => {
       const absoluteFilepathToMarkdownPage = join8(absolutePathToFernDirectory, RelativeFilePath2.of(filepath));
-      await (0, import_promises114.mkdir)(dirname6(absoluteFilepathToMarkdownPage), { recursive: true });
+      await (0, import_promises115.mkdir)(dirname6(absoluteFilepathToMarkdownPage), { recursive: true });
       const frontmatter = Object.keys(page.frontmatter).length > 0 ? `---
 ${jsYaml.dump(JSON.parse(JSON.stringify(page.frontmatter)))}---
 
 ` : "";
-      await (0, import_promises114.writeFile)(absoluteFilepathToMarkdownPage, `${frontmatter}${page.markdown}`);
+      await (0, import_promises115.writeFile)(absoluteFilepathToMarkdownPage, `${frontmatter}${page.markdown}`);
     }));
     await Promise.all(Object.entries(this.assets).map(async ([filepath, asset]) => {
       const absolutePathToAsset = join8(absolutePathToFernDirectory, RelativeFilePath2.of(filepath));
-      await (0, import_promises114.mkdir)(dirname6(absolutePathToAsset), { recursive: true });
-      await (0, import_promises114.cp)(asset.absoluteFilePathToAsset, absolutePathToAsset);
+      await (0, import_promises115.mkdir)(dirname6(absolutePathToAsset), { recursive: true });
+      await (0, import_promises115.cp)(asset.absoluteFilePathToAsset, absolutePathToAsset);
     }));
   }
   setInstance({ companyName }) {
@@ -906057,7 +906273,7 @@ var NonTabbedNavigationBuilderImpl = class {
 
 // ../docs-importers/mintlify/lib/MintlifyImporter.js
 init_lib6();
-var import_promises116 = require("fs/promises");
+var import_promises117 = require("fs/promises");
 
 // ../docs-importers/mintlify/lib/convertColors.js
 function convertColors(colors19) {
@@ -906118,10 +906334,10 @@ init_lib6();
 
 // ../docs-importers/mintlify/lib/convertMarkdown.js
 init_lib6();
-var import_promises115 = require("fs/promises");
+var import_promises116 = require("fs/promises");
 var import_gray_matter9 = __toESM(require_gray_matter(), 1);
 async function convertMarkdown({ absolutePathToMintJson, absoluteFilepathToMarkdown, relativeFilepathFromRoot, builder }) {
-  const text9 = await (0, import_promises115.readFile)(absoluteFilepathToMarkdown, "utf-8");
+  const text9 = await (0, import_promises116.readFile)(absoluteFilepathToMarkdown, "utf-8");
   const { data: data2, content: content5 } = parseMintlifyFrontmatter(text9);
   const slug = relativeFilepathFromRoot.replace(/\.(md|mdx)$/, "");
   const transformedContent = markReferencedAssets({
@@ -906284,7 +906500,7 @@ var MintlifyImporter = class extends DocsImporter {
   documentationTab = void 0;
   tabUrlToInfo = {};
   async import({ args, builder }) {
-    const mintJsonContent = await (0, import_promises116.readFile)(args.absolutePathToMintJson, "utf-8");
+    const mintJsonContent = await (0, import_promises117.readFile)(args.absolutePathToMintJson, "utf-8");
     const mint = JSON.parse(mintJsonContent);
     builder.setTitle({ title: mint.name });
     const relativePathToFavicon = RelativeFilePath2.of(mint.favicon.substring(1));
@@ -906410,7 +906626,7 @@ var MintlifyImporter = class extends DocsImporter {
 
 // ../docs-importers/mintlify/lib/runMintlifyMigration.js
 init_lib6();
-var import_promises117 = require("fs/promises");
+var import_promises118 = require("fs/promises");
 async function runMintlifyMigration({ absolutePathToMintJson, outputPath, taskContext, versionOfCli, organization }) {
   const mintlifyImporter = new MintlifyImporter({
     context: taskContext
@@ -906421,7 +906637,7 @@ async function runMintlifyMigration({ absolutePathToMintJson, outputPath, taskCo
     builder
   });
   await builder.build({ outputDirectory: outputPath });
-  await (0, import_promises117.writeFile)(join8(AbsoluteFilePath2.of(outputPath), RelativeFilePath2.of(FERN_DIRECTORY), RelativeFilePath2.of(PROJECT_CONFIG_FILENAME)), JSON.stringify({
+  await (0, import_promises118.writeFile)(join8(AbsoluteFilePath2.of(outputPath), RelativeFilePath2.of(FERN_DIRECTORY), RelativeFilePath2.of(PROJECT_CONFIG_FILENAME)), JSON.stringify({
     version: versionOfCli,
     organization
   }, void 0, 4));
@@ -906475,7 +906691,7 @@ function assertIsStringArray(val) {
 // ../docs-importers/readme/lib/ReadmeImporter.js
 init_lib4();
 init_lib6();
-var import_promises122 = require("fs/promises");
+var import_promises123 = require("fs/promises");
 
 // ../docs-importers/readme/lib/extract/favicon.js
 async function getFavicon(hast) {
@@ -917893,7 +918109,7 @@ init_disposable();
 init_incremental_id_generator();
 
 // ../../../node_modules/.pnpm/puppeteer-core@24.40.0/node_modules/puppeteer-core/lib/esm/puppeteer/node/ChromeLauncher.js
-var import_promises120 = require("fs/promises");
+var import_promises121 = require("fs/promises");
 var import_node_os11 = __toESM(require("os"), 1);
 var import_node_path35 = __toESM(require("path"), 1);
 init_main();
@@ -918337,7 +918553,7 @@ var ChromeLauncher = class extends BrowserLauncher {
     });
     if (userDataDirIndex < 0) {
       isTempUserDataDir = true;
-      chromeArguments.push(`--user-data-dir=${await (0, import_promises120.mkdtemp)(this.getProfilePath())}`);
+      chromeArguments.push(`--user-data-dir=${await (0, import_promises121.mkdtemp)(this.getProfilePath())}`);
       userDataDirIndex = chromeArguments.length - 1;
     }
     const userDataDir = chromeArguments[userDataDirIndex].split("=", 2)[1];
@@ -918494,7 +918710,7 @@ function removeMatchingFlags(array3, flag) {
 
 // ../../../node_modules/.pnpm/puppeteer-core@24.40.0/node_modules/puppeteer-core/lib/esm/puppeteer/node/FirefoxLauncher.js
 var import_node_fs28 = __toESM(require("fs"), 1);
-var import_promises121 = require("fs/promises");
+var import_promises122 = require("fs/promises");
 var import_node_os12 = __toESM(require("os"), 1);
 var import_node_path36 = __toESM(require("path"), 1);
 init_main();
@@ -918548,7 +918764,7 @@ var FirefoxLauncher = class _FirefoxLauncher extends BrowserLauncher {
       }
       isTempUserDataDir = false;
     } else {
-      userDataDir = await (0, import_promises121.mkdtemp)(this.getProfilePath());
+      userDataDir = await (0, import_promises122.mkdtemp)(this.getProfilePath());
       firefoxArguments.push("--profile");
       firefoxArguments.push(userDataDir);
     }
@@ -918589,8 +918805,8 @@ var FirefoxLauncher = class _FirefoxLauncher extends BrowserLauncher {
           const prefsBackupPath = import_node_path36.default.join(userDataDir, file4 + backupSuffix);
           if (import_node_fs28.default.existsSync(prefsBackupPath)) {
             const prefsPath = import_node_path36.default.join(userDataDir, file4);
-            await (0, import_promises121.unlink)(prefsPath);
-            await (0, import_promises121.rename)(prefsBackupPath, prefsPath);
+            await (0, import_promises122.unlink)(prefsPath);
+            await (0, import_promises122.rename)(prefsBackupPath, prefsPath);
           }
         }));
         for (const result of results) {
@@ -919623,7 +919839,7 @@ var ReadmeImporter = class extends DocsImporter {
       if (response.ok) {
         const imageBuffer = Buffer.from(await response.arrayBuffer());
         const faviconPath = join8(assetsDirectory, RelativeFilePath2.of("favicon"));
-        await (0, import_promises122.writeFile)(faviconPath, new Uint8Array(imageBuffer));
+        await (0, import_promises123.writeFile)(faviconPath, new Uint8Array(imageBuffer));
         builder.setFavicon({ favicon: relativize(this.absolutePathToFernDirectory, faviconPath) });
       }
     }
@@ -919640,7 +919856,7 @@ var ReadmeImporter = class extends DocsImporter {
    */
   async getAndCreateAssetsDirectory() {
     const assetsDirectory = join8(this.absolutePathToFernDirectory, RelativeFilePath2.of("assets"));
-    await (0, import_promises122.mkdir)(assetsDirectory, { recursive: true });
+    await (0, import_promises123.mkdir)(assetsDirectory, { recursive: true });
     return assetsDirectory;
   }
   /**
@@ -919690,7 +919906,7 @@ var ReadmeImporter = class extends DocsImporter {
         absolutePathToOutputDirectory,
         section
       });
-      await (0, import_promises122.mkdir)(absolutePathToOutputDirectoryForSection, { recursive: true });
+      await (0, import_promises123.mkdir)(absolutePathToOutputDirectoryForSection, { recursive: true });
       await Promise.all(section.pages.filter((page) => page.type === "page").map(async (page) => {
         const url3 = new URL(page.slug.toString(), this.url);
         this.logger.debug(`Fetching page: ${url3.toString()}`);
@@ -919705,7 +919921,7 @@ var ReadmeImporter = class extends DocsImporter {
             absolutePathToOutputDirectoryForSection,
             page: page.slug
           });
-          await (0, import_promises122.writeFile)(absolutePathForPage, result.data.mdx);
+          await (0, import_promises123.writeFile)(absolutePathForPage, result.data.mdx);
           if (result.data.images.imageURLs.length > 0) {
             this.logger.debug(`Found ${result.data.images.imageURLs.length} images to download for ${url3.toString()}`);
             await Promise.all(Object.entries(result.data.images.imageURLToFilename).map(async ([imageUrl, filename]) => {
@@ -919718,8 +919934,8 @@ var ReadmeImporter = class extends DocsImporter {
                 const imageBuffer = Buffer.from(await response.arrayBuffer());
                 const imagePath = join8(absolutePathToOutputDirectoryForSection, RelativeFilePath2.of(filename));
                 const imageDir = dirname6(imagePath);
-                await (0, import_promises122.mkdir)(imageDir, { recursive: true });
-                await (0, import_promises122.writeFile)(imagePath, new Uint8Array(imageBuffer));
+                await (0, import_promises123.mkdir)(imageDir, { recursive: true });
+                await (0, import_promises123.writeFile)(imagePath, new Uint8Array(imageBuffer));
                 this.logger.debug(`Saved image to ${imagePath}`);
               } catch (error50) {
                 this.logger.warn(`Error downloading image ${imageUrl}: ${error50}`);
@@ -919802,7 +920018,7 @@ var ReadmeImporter = class extends DocsImporter {
 
 // ../docs-importers/readme/lib/runReadmeMigration.js
 init_lib6();
-var import_promises123 = require("fs/promises");
+var import_promises124 = require("fs/promises");
 async function runReadmeMigration({ readmeUrl, outputPath, taskContext, versionOfCli, organization }) {
   const builder = new FernDocsBuilderImpl();
   builder.setInstance({ companyName: organization });
@@ -919817,7 +920033,7 @@ async function runReadmeMigration({ readmeUrl, outputPath, taskContext, versionO
     builder
   });
   await builder.build({ outputDirectory: outputPath });
-  await (0, import_promises123.writeFile)(join8(AbsoluteFilePath2.of(outputPath), RelativeFilePath2.of(FERN_DIRECTORY), RelativeFilePath2.of(PROJECT_CONFIG_FILENAME)), JSON.stringify({
+  await (0, import_promises124.writeFile)(join8(AbsoluteFilePath2.of(outputPath), RelativeFilePath2.of(FERN_DIRECTORY), RelativeFilePath2.of(PROJECT_CONFIG_FILENAME)), JSON.stringify({
     version: versionOfCli,
     organization
   }, void 0, 4));
@@ -919840,7 +920056,7 @@ var initializeWithReadme = async ({ readmeUrl, organization, taskContext, versio
 };
 
 // ../init/lib/utils/loadOpenApiFromUrl.js
-var import_promises124 = require("fs/promises");
+var import_promises125 = require("fs/promises");
 var import_path77 = require("path");
 var import_tmp_promise15 = __toESM(require_tmp_promise(), 1);
 var LoadOpenAPIStatus;
@@ -919855,7 +920071,7 @@ async function loadOpenAPIFromUrl({ url: url3, logger: logger4 }) {
     const filePath = (0, import_path77.join)(tmpDir.path, url3.endsWith(".json") ? "openapi.json" : "openapi.yaml");
     logger4.debug("tmpDir", tmpDir.path);
     logger4.debug("filePath", filePath);
-    await (0, import_promises124.writeFile)(filePath, data2);
+    await (0, import_promises125.writeFile)(filePath, data2);
     return {
       status: LoadOpenAPIStatus.Success,
       filePath
@@ -924147,7 +924363,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "4.71.6";
+    return "4.72.0-1-g2825b1479c3";
   }
   getCliName() {
     if (false) {
@@ -924445,7 +924661,7 @@ function wrapWorkspaceNameForPrefix(workspaceName) {
 
 // ../project-loader/lib/loadProject.js
 init_lib6();
-var import_promises125 = require("fs/promises");
+var import_promises126 = require("fs/promises");
 async function loadProject({ context: context3, nameOverride, ...args }) {
   const fernDirectory = await getFernDirectory(nameOverride);
   if (fernDirectory == null) {
@@ -924508,7 +924724,7 @@ async function loadApis({ cliName, fernDirectory, context: context3, cliVersion,
   const apisDirectory = join8(fernDirectory, RelativeFilePath2.of(APIS_DIRECTORY));
   const apisDirectoryExists = await doesPathExist(apisDirectory);
   if (apisDirectoryExists) {
-    const apiDirectoryContents = await (0, import_promises125.readdir)(apisDirectory, { withFileTypes: true });
+    const apiDirectoryContents = await (0, import_promises126.readdir)(apisDirectory, { withFileTypes: true });
     const apiWorkspaceDirectoryNames = apiDirectoryContents.reduce((all9, item) => {
       if (item.isDirectory()) {
         all9.push(item.name);
@@ -924585,11 +924801,11 @@ async function loadProjectAndRegisterWorkspacesWithContext(cliContext, args, reg
 
 // src/cliV2.ts
 var import_generators_sdk5 = __toESM(require_generators_sdk(), 1);
-var import_promises130 = require("fs/promises");
+var import_promises131 = require("fs/promises");
 
 // src/commands/generator-list/getGeneratorList.ts
 init_lib4();
-var import_promises126 = require("fs/promises");
+var import_promises127 = require("fs/promises");
 var GenerationModeFilter = {
   GitHub: "github",
   Local: "local-file-system",
@@ -924649,7 +924865,7 @@ async function getGeneratorList({
     return;
   }
   try {
-    await (0, import_promises126.writeFile)(outputLocation, generatorsListYaml);
+    await (0, import_promises127.writeFile)(outputLocation, generatorsListYaml);
   } catch (error50) {
     cliContext.failAndThrow(`Could not write file to the specified location: ${outputLocation}`, error50, {
       code: CliError.Code.ConfigError
@@ -924717,7 +924933,7 @@ async function getGeneratorMetadata({
 }
 
 // src/commands/organization/getOrganization.ts
-var import_promises127 = require("fs/promises");
+var import_promises128 = require("fs/promises");
 async function getOrganization({
   project,
   outputLocation,
@@ -924729,7 +924945,7 @@ async function getOrganization({
     return;
   }
   try {
-    await (0, import_promises127.writeFile)(outputLocation, org);
+    await (0, import_promises128.writeFile)(outputLocation, org);
   } catch (error50) {
     context3.failAndThrow(`Could not write file to the specified location: ${outputLocation}`, error50, {
       code: CliError.Code.ConfigError
@@ -924739,7 +924955,7 @@ async function getOrganization({
 
 // src/commands/upgrade/upgradeGenerator.ts
 init_lib6();
-var import_promises129 = require("fs/promises");
+var import_promises130 = require("fs/promises");
 var import_path79 = __toESM(require("path"), 1);
 var import_semver17 = __toESM(require_semver2(), 1);
 var import_yaml6 = __toESM(require_dist9(), 1);
@@ -924747,7 +924963,7 @@ var import_yaml6 = __toESM(require_dist9(), 1);
 // src/commands/upgrade/migrations/loader.ts
 init_lib4();
 var import_fs32 = require("fs");
-var import_promises128 = require("fs/promises");
+var import_promises129 = require("fs/promises");
 var import_os15 = require("os");
 var import_path78 = require("path");
 var import_semver16 = __toESM(require_semver2(), 1);
@@ -924775,7 +924991,7 @@ async function acquireLock3(logger4, cacheDir) {
   const myPid = String(process.pid);
   while (true) {
     try {
-      const fh = await (0, import_promises128.open)(lockPath, "wx");
+      const fh = await (0, import_promises129.open)(lockPath, "wx");
       await fh.writeFile(myPid);
       await fh.close();
       const exitHandler = () => {
@@ -924792,9 +925008,9 @@ async function acquireLock3(logger4, cacheDir) {
       return async () => {
         process.removeListener("exit", exitHandler);
         try {
-          const currentContent = await (0, import_promises128.readFile)(lockPath, "utf-8");
+          const currentContent = await (0, import_promises129.readFile)(lockPath, "utf-8");
           if (currentContent.trim() === myPid) {
-            await (0, import_promises128.unlink)(lockPath);
+            await (0, import_promises129.unlink)(lockPath);
           } else {
             logger4.debug(
               `Lock file owned by another process (expected pid=${myPid}, found=${currentContent.trim()}); skipping release`
@@ -924810,14 +925026,14 @@ async function acquireLock3(logger4, cacheDir) {
         throw err;
       }
       try {
-        const lockContent = await (0, import_promises128.readFile)(lockPath, "utf-8");
+        const lockContent = await (0, import_promises129.readFile)(lockPath, "utf-8");
         const lockPid = Number(lockContent.trim());
-        const lockStat = await (0, import_promises128.stat)(lockPath);
+        const lockStat = await (0, import_promises129.stat)(lockPath);
         const lockAge = Date.now() - lockStat.mtimeMs;
         if (lockAge > LOCK_STALE_MS || Number.isFinite(lockPid) && lockPid > 0 && !isProcessAlive(lockPid)) {
           logger4.debug(`Removing stale migration lock (pid=${lockContent.trim()}, age=${lockAge}ms)`);
           try {
-            await (0, import_promises128.unlink)(lockPath);
+            await (0, import_promises129.unlink)(lockPath);
           } catch (unlinkErr) {
             logger4.debug(`Failed to remove stale lock: ${unlinkErr}`);
           }
@@ -924841,7 +925057,7 @@ async function ensureMigrationsInstalled(logger4) {
   }
   migrationsInstallPromise = (async () => {
     const cacheDir = getMigrationCacheDir();
-    await (0, import_promises128.mkdir)(cacheDir, { recursive: true });
+    await (0, import_promises129.mkdir)(cacheDir, { recursive: true });
     const npmCacheDir = (0, import_path78.join)(cacheDir, ".npm-cache");
     const packageDir = (0, import_path78.join)(cacheDir, "node_modules", MIGRATION_PACKAGE_NAME2);
     const packageJsonPath = (0, import_path78.join)(packageDir, "package.json");
@@ -924858,7 +925074,7 @@ async function ensureMigrationsInstalled(logger4) {
         "--no-audit",
         "--no-fund"
       ]);
-      const packageJsonContent = await (0, import_promises128.readFile)(packageJsonPath, "utf-8");
+      const packageJsonContent = await (0, import_promises129.readFile)(packageJsonPath, "utf-8");
       const packageJson2 = JSON.parse(packageJsonContent);
       if (packageJson2.main == null) {
         throw new CliError({
@@ -925044,7 +925260,7 @@ async function loadAndUpdateGenerators({
       skippedAutoreleaseDisabled: []
     };
   }
-  const contents = await (0, import_promises129.readFile)(filepath);
+  const contents = await (0, import_promises130.readFile)(filepath);
   context3.logger.debug(`Found generators: ${contents.toString()}`);
   const parsedDocument = import_yaml6.default.parseDocument(contents.toString());
   const generatorGroups = parsedDocument.get("groups");
@@ -925281,7 +925497,7 @@ async function upgradeGenerator({
           absolutePathToWorkspace: workspace.absoluteFilePath
         });
         if (absolutePathToGeneratorsConfiguration != null && result.updatedConfiguration != null) {
-          await (0, import_promises129.writeFile)(absolutePathToGeneratorsConfiguration, result.updatedConfiguration);
+          await (0, import_promises130.writeFile)(absolutePathToGeneratorsConfiguration, result.updatedConfiguration);
         }
         allSkippedMajorUpgrades.push(...result.skippedMajorUpgrades);
         if (result.appliedUpgrades.length > 0) {
@@ -925681,7 +925897,7 @@ function addGeneratorCommands(cli, cliContext) {
         }
         if (argv.output) {
           try {
-            await (0, import_promises130.writeFile)(argv.output, JSON.stringify(generatorMetadata, null, 2));
+            await (0, import_promises131.writeFile)(argv.output, JSON.stringify(generatorMetadata, null, 2));
           } catch (error50) {
             cliContext.failAndThrow(
               `Could not write file to the specified location: ${argv.output}`,
@@ -925696,7 +925912,7 @@ function addGeneratorCommands(cli, cliContext) {
 }
 
 // src/commands/add-generator/addGeneratorToWorkspaces.ts
-var import_promises131 = require("fs/promises");
+var import_promises132 = require("fs/promises");
 async function addGeneratorToWorkspaces({
   project: { apiWorkspaces },
   generatorName,
@@ -925723,7 +925939,7 @@ async function addGeneratorToWorkspaces({
         if (absolutePathToGeneratorsConfiguration == null) {
           return;
         }
-        await (0, import_promises131.writeFile)(
+        await (0, import_promises132.writeFile)(
           absolutePathToGeneratorsConfiguration,
           "# yaml-language-server: $schema=https://schema.buildwithfern.dev/generators-yml.json\n" + jsYaml.dump(newConfiguration)
         );
@@ -926092,7 +926308,7 @@ async function previewDocsWorkspace({
 
 // src/commands/docs-diff/docsDiff.ts
 init_lib6();
-var import_promises132 = require("fs/promises");
+var import_promises133 = require("fs/promises");
 var import_pngjs = __toESM(require_png2(), 1);
 async function getSlugForFiles({
   previewUrl,
@@ -926315,8 +926531,8 @@ async function generateComparisons({
   afterPath,
   comparisonBasePath
 }) {
-  const beforePng = import_pngjs.PNG.sync.read(await (0, import_promises132.readFile)(beforePath));
-  const afterPng = import_pngjs.PNG.sync.read(await (0, import_promises132.readFile)(afterPath));
+  const beforePng = import_pngjs.PNG.sync.read(await (0, import_promises133.readFile)(beforePath));
+  const afterPng = import_pngjs.PNG.sync.read(await (0, import_promises133.readFile)(afterPath));
   const beforeOriginalHeight = beforePng.height;
   const afterOriginalHeight = afterPng.height;
   const width = Math.max(beforePng.width, afterPng.width);
@@ -926354,7 +926570,7 @@ async function generateComparisons({
     const sideBySide = createSideBySideComparison(croppedBefore, croppedAfter, 20, true);
     const outPath = `${base4}-region-${i11 + 1}.png`;
     const pngBuffer = import_pngjs.PNG.sync.write(sideBySide);
-    await (0, import_promises132.writeFile)(outPath, new Uint8Array(pngBuffer));
+    await (0, import_promises133.writeFile)(outPath, new Uint8Array(pngBuffer));
     results.push({ changePercent, boundingBox, comparisonPath: outPath });
   }
   return results;
@@ -926433,7 +926649,7 @@ async function docsDiff({
     outputDir.startsWith("/") ? outputDir : join8(cwd(), RelativeFilePath2.of(outputDir))
   );
   if (!await doesPathExist(outputPath)) {
-    await (0, import_promises132.mkdir)(outputPath, { recursive: true });
+    await (0, import_promises133.mkdir)(outputPath, { recursive: true });
   }
   const results = [];
   await cliContext.runTask(async (context3) => {
@@ -930846,7 +931062,7 @@ function renderModuleTree(module4, ctx, writer2, parentPath) {
 }
 
 // src/commands/docs-md-generate/generateLibraryDocs.ts
-var import_promises133 = require("fs/promises");
+var import_promises134 = require("fs/promises");
 function createLibraryDocsClient({ token }) {
   const defaultOrigin = "https://registry-dev2.buildwithfern.com";
   const baseUrl = process.env.FERN_FDR_ORIGIN ?? process.env.OVERRIDE_FDR_ORIGIN ?? defaultOrigin;
@@ -930972,7 +931188,7 @@ async function generateSingleLibrary({
     if (config5.lang === "cpp" && config5.config?.doxyfile != null) {
       const doxyfilePath = resolve6(docsWorkspace.absoluteFilePath, config5.config.doxyfile);
       try {
-        doxyfileContent = await (0, import_promises133.readFile)(doxyfilePath, "utf-8");
+        doxyfileContent = await (0, import_promises134.readFile)(doxyfilePath, "utf-8");
       } catch {
         return interactiveTaskContext.failAndThrow(
           `Library '${name2}': Could not read Doxyfile at '${config5.config.doxyfile}' (resolved to ${doxyfilePath})`,
@@ -931313,7 +931529,7 @@ Found ${previewDeployments.length} preview deployment(s):
 }
 
 // src/commands/downgrade/downgrade.ts
-var import_promises134 = require("fs/promises");
+var import_promises135 = require("fs/promises");
 
 // ../../../node_modules/.pnpm/immer@10.2.0/node_modules/immer/dist/immer.mjs
 var NOTHING = /* @__PURE__ */ Symbol.for("immer-nothing");
@@ -932064,13 +932280,13 @@ async function downgrade({
   const newProjectConfig = produce(projectConfig.rawConfig, (draft) => {
     draft.version = targetVersion;
   });
-  await (0, import_promises134.writeFile)(projectConfig._absolutePath, ensureFinalNewline(JSON.stringify(newProjectConfig, void 0, 2)));
+  await (0, import_promises135.writeFile)(projectConfig._absolutePath, ensureFinalNewline(JSON.stringify(newProjectConfig, void 0, 2)));
   cliContext.logger.info(`Updated ${PROJECT_CONFIG_FILENAME} to version ${targetVersion}`);
 }
 
 // src/commands/export/generateOpenAPIForWorkspaces.ts
 init_lib6();
-var import_promises135 = require("fs/promises");
+var import_promises136 = require("fs/promises");
 
 // src/commands/export/converters/servicesConverter.ts
 init_lib4();
@@ -933453,8 +933669,8 @@ async function generateOpenAPIForWorkspaces({
           ir: ir15,
           mode: "openapi"
         });
-        await (0, import_promises135.mkdir)(dirname6(outputPath), { recursive: true });
-        await (0, import_promises135.writeFile)(
+        await (0, import_promises136.mkdir)(dirname6(outputPath), { recursive: true });
+        await (0, import_promises136.writeFile)(
           outputPath,
           outputPath.endsWith(".json") ? JSON.stringify(openapi, void 0, indent4) : jsYaml.dump(openapi, { indent: indent4 })
         );
@@ -933538,11 +933754,11 @@ var LOCAL_STORAGE_FOLDER6 = ".fern-dev";
 
 // src/commands/generate/checkOutputDirectory.ts
 init_lib6();
-var import_promises138 = require("fs/promises");
+var import_promises139 = require("fs/promises");
 
 // src/persistence/output-directories/getOutputDirectories.ts
 init_lib6();
-var import_promises136 = require("fs/promises");
+var import_promises137 = require("fs/promises");
 
 // src/persistence/output-directories/getPathToOutputDirectoriesFile.ts
 init_lib6();
@@ -933562,17 +933778,17 @@ async function getOutputDirectories() {
   if (!doesOutputDirectoriesFileExist) {
     return [];
   }
-  const outputDirectoriesFileContents = await (0, import_promises136.readFile)(pathToOutputDirectoriesFile, { encoding: "utf-8" });
+  const outputDirectoriesFileContents = await (0, import_promises137.readFile)(pathToOutputDirectoriesFile, { encoding: "utf-8" });
   const outputDirectories = JSON.parse(outputDirectoriesFileContents);
   return outputDirectories;
 }
 
 // src/persistence/output-directories/storeOutputDirectories.ts
-var import_promises137 = require("fs/promises");
+var import_promises138 = require("fs/promises");
 var import_path82 = __toESM(require("path"), 1);
 async function storeOutputDirectories(outputDirectories) {
-  await (0, import_promises137.mkdir)(import_path82.default.dirname(getPathToOutputDirectoriesFile()), { recursive: true });
-  await (0, import_promises137.writeFile)(getPathToOutputDirectoriesFile(), JSON.stringify(outputDirectories, null, 2));
+  await (0, import_promises138.mkdir)(import_path82.default.dirname(getPathToOutputDirectoriesFile()), { recursive: true });
+  await (0, import_promises138.writeFile)(getPathToOutputDirectoriesFile(), JSON.stringify(outputDirectories, null, 2));
 }
 
 // src/commands/generate/checkOutputDirectory.ts
@@ -933594,7 +933810,7 @@ async function checkOutputDirectory(outputPath, cliContext, force) {
       shouldProceed: true
     };
   }
-  const files = await (0, import_promises138.readdir)(outputPath);
+  const files = await (0, import_promises139.readdir)(outputPath);
   if (files.length === 0) {
     return {
       shouldProceed: true
@@ -934531,7 +934747,7 @@ async function generateOpenAPIIrForWorkspaces({
 
 // src/commands/generate-overrides/compareOpenAPISpecs.ts
 init_lib6();
-var import_promises139 = require("fs/promises");
+var import_promises140 = require("fs/promises");
 async function compareOpenAPISpecs({
   originalPath,
   modifiedPath,
@@ -934572,12 +934788,12 @@ async function compareOpenAPISpecs({
       }
       outputPath = join8(dirname6(originalPath), RelativeFilePath2.of(overridesFilename));
     }
-    await (0, import_promises139.writeFile)(outputPath, jsYaml.dump(overrides, { lineWidth: -1, noRefs: true }));
+    await (0, import_promises140.writeFile)(outputPath, jsYaml.dump(overrides, { lineWidth: -1, noRefs: true }));
     context3.logger.info(`Overrides written to ${outputPath}`);
   });
 }
 async function loadSpec2(filepath, context3) {
-  const contents = await (0, import_promises139.readFile)(filepath, "utf8");
+  const contents = await (0, import_promises140.readFile)(filepath, "utf8");
   try {
     return JSON.parse(contents);
   } catch {
@@ -934681,7 +934897,7 @@ function deepEqual(a10, b19) {
 
 // src/commands/generate-overrides/writeOverridesForWorkspaces.ts
 init_lib6();
-var import_promises140 = require("fs/promises");
+var import_promises141 = require("fs/promises");
 async function writeOverridesForWorkspaces({
   project,
   includeModels,
@@ -934706,7 +934922,7 @@ async function writeOverridesForWorkspaces({
 async function readExistingOverrides(overridesFilepath, context3) {
   let parsedOverrides = null;
   try {
-    const contents = (await (0, import_promises140.readFile)(overridesFilepath, "utf8")).toString();
+    const contents = (await (0, import_promises141.readFile)(overridesFilepath, "utf8")).toString();
     try {
       parsedOverrides = JSON.parse(contents);
     } catch (err) {
@@ -934771,7 +934987,7 @@ async function writeDefinitionForOpenAPIWorkspace({
       for (const overridesPath of overridesPaths) {
         const existingOverrides = await readExistingOverrides(overridesPath, context3);
         const content5 = generateOverridesContent({ ir: ir15, existingOverrides, includeModels, context: context3 });
-        await (0, import_promises140.writeFile)(overridesPath, jsYaml.dump(content5));
+        await (0, import_promises141.writeFile)(overridesPath, jsYaml.dump(content5));
       }
     } else {
       const content5 = generateOverridesContent({ ir: ir15, existingOverrides: {}, includeModels, context: context3 });
@@ -934785,7 +935001,7 @@ async function writeDefinitionForOpenAPIWorkspace({
           overridesFilename = `${nameWithoutExt}-overrides${extension4}`;
         }
       }
-      await (0, import_promises140.writeFile)(
+      await (0, import_promises141.writeFile)(
         join8(dirname6(spec.absoluteFilepath), RelativeFilePath2.of(overridesFilename)),
         jsYaml.dump(content5)
       );
@@ -935201,7 +935417,7 @@ function convertIRtoJsonSchema(args) {
 }
 
 // src/commands/jsonschema/generateJsonschemaForWorkspace.ts
-var import_promises141 = require("fs/promises");
+var import_promises142 = require("fs/promises");
 async function generateJsonschemaForWorkspaces({
   typeLocator,
   project,
@@ -935249,9 +935465,9 @@ async function generateJsonschemaForWorkspaces({
           context: context3
         });
         if (!await doesPathExist(dirname6(jsonschemaFilepath))) {
-          await (0, import_promises141.mkdir)(dirname6(jsonschemaFilepath), { recursive: true });
+          await (0, import_promises142.mkdir)(dirname6(jsonschemaFilepath), { recursive: true });
         }
-        await (0, import_promises141.writeFile)(jsonschemaFilepath, JSON.stringify(jsonSchema, null, 2));
+        await (0, import_promises142.writeFile)(jsonschemaFilepath, JSON.stringify(jsonSchema, null, 2));
         context3.logger.info(source_default.green(`Wrote JSON Schema to ${jsonschemaFilepath}`));
       });
     })
@@ -935260,7 +935476,7 @@ async function generateJsonschemaForWorkspaces({
 
 // src/commands/merge/mergeOpenAPIWithOverrides.ts
 init_lib6();
-var import_promises142 = require("fs/promises");
+var import_promises143 = require("fs/promises");
 var HTTP_METHODS2 = /* @__PURE__ */ new Set(["get", "put", "post", "delete", "options", "head", "patch", "trace"]);
 async function mergeOpenAPIWithOverrides({
   openapiPath,
@@ -935285,12 +935501,12 @@ async function mergeOpenAPIWithOverrides({
     const merged = mergeExamplesIntoSpec(openapi, overrides, context3);
     const isJson = outputPath.endsWith(".json");
     const output2 = isJson ? JSON.stringify(merged, null, 2) : jsYaml.dump(merged, { lineWidth: -1, noRefs: true });
-    await (0, import_promises142.writeFile)(outputPath, output2);
+    await (0, import_promises143.writeFile)(outputPath, output2);
     context3.logger.info(`Merged output written to ${outputPath}`);
   });
 }
 async function loadYamlOrJson(filepath, context3) {
-  const contents = await (0, import_promises142.readFile)(filepath, "utf8");
+  const contents = await (0, import_promises143.readFile)(filepath, "utf8");
   try {
     return JSON.parse(contents);
   } catch {
@@ -935924,7 +936140,7 @@ async function mockServer({
 }
 
 // src/commands/register/registerWorkspacesV1.ts
-var import_promises143 = require("fs/promises");
+var import_promises144 = require("fs/promises");
 var import_path88 = __toESM(require("path"), 1);
 var import_tmp_promise16 = __toESM(require_tmp_promise(), 1);
 async function registerWorkspacesV1({
@@ -935977,7 +936193,7 @@ async function registerWorkspacesV1({
         context3.logger.debug(`Compressing definition at ${tmpDir.path}`);
         await Zn3({ file: tarPath, cwd: resolvedWorkspace.absoluteFilePath }, ["."]);
         context3.logger.info("Uploading definition...");
-        await axios_default.put(registerApiResponse.body.definitionS3UploadUrl, await (0, import_promises143.readFile)(tarPath));
+        await axios_default.put(registerApiResponse.body.definitionS3UploadUrl, await (0, import_promises144.readFile)(tarPath));
         context3.logger.info(
           `Registered @${project.config.organization}/${resolvedWorkspace.definition.rootApiFile.contents.name}:${registerApiResponse.body.version}`
         );
@@ -936219,7 +936435,7 @@ async function generateDiff({
 
 // src/commands/sdk-preview/sdkPreview.ts
 init_lib6();
-var import_promises144 = __toESM(require("fs/promises"), 1);
+var import_promises145 = __toESM(require("fs/promises"), 1);
 
 // src/commands/sdk-preview/computePreviewVersion.ts
 var BASE_VERSION = "0.0.1";
@@ -936435,7 +936651,7 @@ async function sdkPreview({
     const firstPath = pathOutputs[0];
     const absolutePathToOutput = firstPath != null ? AbsoluteFilePath2.of(resolve6(cwd(), firstPath)) : void 0;
     if (absolutePathToOutput != null) {
-      await import_promises144.default.mkdir(absolutePathToOutput, { recursive: true });
+      await import_promises145.default.mkdir(absolutePathToOutput, { recursive: true });
     }
     for (const workspace of project.apiWorkspaces) {
       if (workspace.generatorsConfiguration == null) {
@@ -936643,7 +936859,7 @@ async function sdkPreview({
 }
 
 // src/commands/self-update/selfUpdate.ts
-var import_promises145 = require("fs/promises");
+var import_promises146 = require("fs/promises");
 var import_path89 = require("path");
 async function getPackageManagerBinDir(logger4, pm) {
   let command3;
@@ -936689,7 +936905,7 @@ async function detectInstallationMethod(logger4) {
   logger4.debug(`Found fern at: ${fernPath}`);
   let resolvedPath;
   try {
-    resolvedPath = await (0, import_promises145.realpath)(fernPath);
+    resolvedPath = await (0, import_promises146.realpath)(fernPath);
     logger4.debug(`Resolved to: ${resolvedPath}`);
   } catch (error50) {
     logger4.debug(`Failed to resolve symlink: ${error50}`);
@@ -936992,21 +937208,21 @@ async function generateToken({
 // src/commands/upgrade/updateApiSpec.ts
 init_lib6();
 var fs28 = __toESM(require("fs"), 1);
-var import_promises146 = require("fs/promises");
+var import_promises147 = require("fs/promises");
 init_graphql();
 var import_stream16 = require("stream");
-var import_promises147 = require("stream/promises");
+var import_promises148 = require("stream/promises");
 async function fetchAndWriteFile(url3, path97, logger4, indent4) {
   const resp = await fetch(url3);
   if (resp.ok && resp.body) {
     logger4.debug("Origin successfully fetched, writing to file");
     const fileStream = fs28.createWriteStream(path97);
-    await (0, import_promises147.finished)(import_stream16.Readable.fromWeb(resp.body).pipe(fileStream));
-    const fileContents = await (0, import_promises146.readFile)(path97, "utf8");
+    await (0, import_promises148.finished)(import_stream16.Readable.fromWeb(resp.body).pipe(fileStream));
+    const fileContents = await (0, import_promises147.readFile)(path97, "utf8");
     try {
-      await (0, import_promises146.writeFile)(path97, JSON.stringify(JSON.parse(fileContents), void 0, indent4), "utf8");
+      await (0, import_promises147.writeFile)(path97, JSON.stringify(JSON.parse(fileContents), void 0, indent4), "utf8");
     } catch (e6) {
-      await (0, import_promises146.writeFile)(path97, jsYaml.dump(jsYaml.load(fileContents), { indent: indent4 }), "utf8");
+      await (0, import_promises147.writeFile)(path97, jsYaml.dump(jsYaml.load(fileContents), { indent: indent4 }), "utf8");
     }
     logger4.debug("File written successfully");
   }
@@ -937162,14 +937378,14 @@ async function tryDirectJSONFetch(url3, logger4) {
 async function fetchGraphQLSchemaWithAutoDetection(url3, path97, logger4) {
   const postResult = await tryGraphQLIntrospection(url3, logger4);
   if (postResult.success) {
-    await (0, import_promises146.writeFile)(path97, postResult.result, "utf8");
+    await (0, import_promises147.writeFile)(path97, postResult.result, "utf8");
     logger4.info("Successfully fetched GraphQL schema using POST introspection");
     return;
   }
   logger4.debug(`POST introspection failed: ${postResult.error}`);
   const getResult = await tryDirectJSONFetch(url3, logger4);
   if (getResult.success) {
-    await (0, import_promises146.writeFile)(path97, getResult.result, "utf8");
+    await (0, import_promises147.writeFile)(path97, getResult.result, "utf8");
     logger4.info("Successfully fetched GraphQL schema using direct JSON fetch");
     return;
   }
@@ -937278,7 +937494,7 @@ async function processDefinitions({
 init_lib4();
 
 // ../cli-migrations/lib/migrations/0.0.191/discriminant/migration.js
-var import_promises148 = require("fs/promises");
+var import_promises149 = require("fs/promises");
 
 // ../cli-migrations/lib/migrations/0.0.191/discriminant/getAllYamlFiles.js
 init_lib6();
@@ -937314,7 +937530,7 @@ var migration = {
       try {
         const fileContents = await getFileContents(yamlFilepath);
         const newContents = addDiscriminantToFile(fileContents);
-        await (0, import_promises148.writeFile)(yamlFilepath, newContents);
+        await (0, import_promises149.writeFile)(yamlFilepath, newContents);
       } catch (error50) {
         context3.failAndThrow("Failed to migrate " + yamlFilepath, error50);
       }
@@ -937322,7 +937538,7 @@ var migration = {
   }
 };
 async function getFileContents(filepath) {
-  const buffer = await (0, import_promises148.readFile)(filepath);
+  const buffer = await (0, import_promises149.readFile)(filepath);
   return buffer.toString();
 }
 var UNION_REGEX = /^(\s{2,})union:\s*$/gm;
@@ -937351,7 +937567,7 @@ var versionMigrations = {
 var __default = versionMigrations;
 
 // ../cli-migrations/lib/migrations/0.0.203/union-single-property-key/migration.js
-var import_promises149 = require("fs/promises");
+var import_promises150 = require("fs/promises");
 var import_yaml7 = __toESM(require_dist9(), 1);
 
 // ../cli-migrations/lib/migrations/0.0.203/union-single-property-key/getAllYamlFiles.js
@@ -937394,7 +937610,7 @@ var migration2 = {
   }
 };
 async function migrateFile(filepath, context3) {
-  const contents = await (0, import_promises149.readFile)(filepath);
+  const contents = await (0, import_promises150.readFile)(filepath);
   const parsedDocument = import_yaml7.default.parseDocument(contents.toString());
   const types4 = parsedDocument.get("types");
   if (types4 == null) {
@@ -937426,7 +937642,7 @@ async function migrateFile(filepath, context3) {
       }
     }
   }
-  await (0, import_promises149.writeFile)(filepath, parsedDocument.toString());
+  await (0, import_promises150.writeFile)(filepath, parsedDocument.toString());
 }
 
 // ../cli-migrations/lib/migrations/0.0.203/index.js
@@ -937437,7 +937653,7 @@ var versionMigrations2 = {
 var __default2 = versionMigrations2;
 
 // ../cli-migrations/lib/migrations/0.0.207/add-mode-to-draft-generators/migration.js
-var import_promises150 = require("fs/promises");
+var import_promises151 = require("fs/promises");
 var import_yaml8 = __toESM(require_dist9(), 1);
 
 // ../cli-migrations/lib/migrations/0.0.207/add-mode-to-draft-generators/getAllGeneratorYamlFiles.js
@@ -937480,7 +937696,7 @@ var migration3 = {
   }
 };
 async function migrateGeneratorsYml(filepath, context3) {
-  const contents = await (0, import_promises150.readFile)(filepath);
+  const contents = await (0, import_promises151.readFile)(filepath);
   const parsedDocument = import_yaml8.default.parseDocument(contents.toString());
   const draftGenerators = parsedDocument.get("draft");
   if (draftGenerators == null) {
@@ -937507,7 +937723,7 @@ async function migrateGeneratorsYml(filepath, context3) {
       draftGenerator.set("output-path", name2.value.includes("openapi") ? "./generated-openapi" : name2.value.includes("postman") ? "./generated-postman" : localOutput);
     }
   });
-  await (0, import_promises150.writeFile)(filepath, parsedDocument.toString());
+  await (0, import_promises151.writeFile)(filepath, parsedDocument.toString());
 }
 
 // ../cli-migrations/lib/migrations/0.0.207/index.js
@@ -937518,7 +937734,7 @@ var versionMigrations3 = {
 var __default3 = versionMigrations3;
 
 // ../cli-migrations/lib/migrations/0.0.210/remove-inline-error-declarations/migration.js
-var import_promises151 = require("fs/promises");
+var import_promises152 = require("fs/promises");
 var import_yaml9 = __toESM(require_dist9(), 1);
 
 // ../cli-migrations/lib/migrations/0.0.210/remove-inline-error-declarations/getAllYamlFiles.js
@@ -937561,7 +937777,7 @@ var migration4 = {
   }
 };
 async function migrateFile2(filepath, context3) {
-  const contents = await (0, import_promises151.readFile)(filepath);
+  const contents = await (0, import_promises152.readFile)(filepath);
   const parsedDocument = import_yaml9.default.parseDocument(contents.toString());
   const addType = (typeName, typeDeclaration2) => {
     const types4 = parsedDocument.get("types");
@@ -937605,7 +937821,7 @@ async function migrateFile2(filepath, context3) {
       }
     }
   }
-  await (0, import_promises151.writeFile)(filepath, parsedDocument.toString());
+  await (0, import_promises152.writeFile)(filepath, parsedDocument.toString());
 }
 
 // ../cli-migrations/lib/migrations/0.0.210/index.js
@@ -937616,7 +937832,7 @@ var versionMigrations4 = {
 var __default4 = versionMigrations4;
 
 // ../cli-migrations/lib/migrations/0.0.212/add-publishing-to-release-generators/migration.js
-var import_promises152 = require("fs/promises");
+var import_promises153 = require("fs/promises");
 var import_yaml10 = __toESM(require_dist9(), 1);
 
 // ../cli-migrations/lib/migrations/0.0.212/add-publishing-to-release-generators/getAllGeneratorYamlFiles.js
@@ -937659,7 +937875,7 @@ var migration5 = {
   }
 };
 async function migrateGeneratorsYml2(filepath, context3) {
-  const contents = await (0, import_promises152.readFile)(filepath);
+  const contents = await (0, import_promises153.readFile)(filepath);
   const parsedDocument = import_yaml10.default.parseDocument(contents.toString());
   const releaseGenerators = parsedDocument.get("release");
   if (releaseGenerators == null) {
@@ -937697,7 +937913,7 @@ async function migrateGeneratorsYml2(filepath, context3) {
     }
     releaseGenerator.delete("outputs");
   });
-  await (0, import_promises152.writeFile)(filepath, parsedDocument.toString());
+  await (0, import_promises153.writeFile)(filepath, parsedDocument.toString());
 }
 
 // ../cli-migrations/lib/migrations/0.0.212/index.js
@@ -937708,7 +937924,7 @@ var versionMigrations5 = {
 var __default5 = versionMigrations5;
 
 // ../cli-migrations/lib/migrations/0.0.220/rename-alias-key-to-type/migration.js
-var import_promises153 = require("fs/promises");
+var import_promises154 = require("fs/promises");
 
 // ../cli-migrations/lib/migrations/0.0.220/rename-alias-key-to-type/getAllYamlFiles.js
 init_lib6();
@@ -937741,9 +937957,9 @@ var migration6 = {
   run: async ({ context: context3 }) => {
     const yamlFiles = await getAllYamlFiles4(context3);
     for (const filepath of yamlFiles) {
-      const contents = await (0, import_promises153.readFile)(filepath);
+      const contents = await (0, import_promises154.readFile)(filepath);
       const newContents = contents.toString().replaceAll(" alias:", " type:");
-      await (0, import_promises153.writeFile)(filepath, newContents);
+      await (0, import_promises154.writeFile)(filepath, newContents);
     }
   }
 };
@@ -937756,7 +937972,7 @@ var versionMigrations6 = {
 var __default6 = versionMigrations6;
 
 // ../cli-migrations/lib/migrations/0.0.221/add-error-discriminant/migration.js
-var import_promises154 = require("fs/promises");
+var import_promises155 = require("fs/promises");
 
 // ../cli-migrations/lib/migrations/0.0.221/add-error-discriminant/getAllRootApiYamlFiles.js
 init_lib6();
@@ -937789,9 +938005,9 @@ var migration7 = {
   run: async ({ context: context3 }) => {
     const yamlFiles = await getAllRootApiYamlFiles(context3);
     for (const filepath of yamlFiles) {
-      const contents = await (0, import_promises154.readFile)(filepath);
+      const contents = await (0, import_promises155.readFile)(filepath);
       const newContents = contents.toString() + "\nerror-discriminant: error";
-      await (0, import_promises154.writeFile)(filepath, newContents);
+      await (0, import_promises155.writeFile)(filepath, newContents);
     }
   }
 };
@@ -937805,7 +938021,7 @@ var __default7 = versionMigrations7;
 
 // ../cli-migrations/lib/migrations/0.0.241/add-generator-groups/migration.js
 init_lib4();
-var import_promises155 = require("fs/promises");
+var import_promises156 = require("fs/promises");
 
 // ../cli-migrations/lib/migrations/0.0.241/add-generator-groups/getAllGeneratorYamlFiles.js
 init_lib6();
@@ -937914,7 +938130,7 @@ var migration8 = {
   }
 };
 async function migrateGeneratorsYml3(filepath) {
-  const contentsStr = await (0, import_promises155.readFile)(filepath);
+  const contentsStr = await (0, import_promises156.readFile)(filepath);
   const contents = jsYaml.load(contentsStr.toString());
   const oldGeneratorsConfiguration = GeneratorsConfigurationSchema2.parse(contents);
   let newGeneratorsConfiguration = {};
@@ -937932,7 +938148,7 @@ async function migrateGeneratorsYml3(filepath) {
       generators: oldGeneratorsConfiguration.release.map((releaseGeneratorInvocation) => convertReleaseGeneratorInvocation(releaseGeneratorInvocation))
     };
   }
-  await (0, import_promises155.writeFile)(filepath, jsYaml.dump(newGeneratorsConfiguration));
+  await (0, import_promises156.writeFile)(filepath, jsYaml.dump(newGeneratorsConfiguration));
 }
 function convertDraftGeneratorInvocation(draftGeneratorInvocation) {
   const newSchema = {
@@ -938007,7 +938223,7 @@ var versionMigrations8 = {
 var __default8 = versionMigrations8;
 
 // ../cli-migrations/lib/migrations/0.0.248/add-error-discrimination-config/migration.js
-var import_promises156 = require("fs/promises");
+var import_promises157 = require("fs/promises");
 var import_yaml11 = __toESM(require_dist9(), 1);
 
 // ../cli-migrations/lib/migrations/0.0.248/add-error-discrimination-config/getAllRootApiYamlFiles.js
@@ -938050,7 +938266,7 @@ var migration9 = {
   }
 };
 async function migrateRootApiFile(filepath) {
-  const contents = await (0, import_promises156.readFile)(filepath);
+  const contents = await (0, import_promises157.readFile)(filepath);
   const parsedDocument = import_yaml11.default.parseDocument(contents.toString());
   const errorDiscriminant = parsedDocument.get("error-discriminant", true);
   if (errorDiscriminant == null || !import_yaml11.default.isScalar(errorDiscriminant) || typeof errorDiscriminant.value !== "string") {
@@ -938061,7 +938277,7 @@ async function migrateRootApiFile(filepath) {
     "property-name": errorDiscriminant.value
   });
   parsedDocument.delete("error-discriminant");
-  await (0, import_promises156.writeFile)(filepath, parsedDocument.toString());
+  await (0, import_promises157.writeFile)(filepath, parsedDocument.toString());
 }
 
 // ../cli-migrations/lib/migrations/0.0.248/index.js
@@ -938072,7 +938288,7 @@ var versionMigrations9 = {
 var __default9 = versionMigrations9;
 
 // ../cli-migrations/lib/migrations/0.1.3-rc3/add-inline-requests/migration.js
-var import_promises157 = require("fs/promises");
+var import_promises158 = require("fs/promises");
 var import_yaml12 = __toESM(require_dist9(), 1);
 
 // ../cli-migrations/lib/migrations/0.1.3-rc3/add-inline-requests/getAllYamlFiles.js
@@ -938115,7 +938331,7 @@ var migration10 = {
   }
 };
 async function migrateYamlFile(filepath, context3) {
-  const contents = await (0, import_promises157.readFile)(filepath);
+  const contents = await (0, import_promises158.readFile)(filepath);
   const parsedDocument = import_yaml12.default.parseDocument(contents.toString());
   const services = parsedDocument.get("services");
   if (services == null) {
@@ -938155,7 +938371,7 @@ async function migrateYamlFile(filepath, context3) {
         context3.failWithoutThrowing("Failed to convert endpoint", e6);
       }
     }
-    await (0, import_promises157.writeFile)(filepath, parsedDocument.toString());
+    await (0, import_promises158.writeFile)(filepath, parsedDocument.toString());
   }
 }
 function convertEndpoint4({ document: document4, endpoint: endpoint3 }) {
@@ -938234,7 +938450,7 @@ var versionMigrations10 = {
 var __default10 = versionMigrations10;
 
 // ../cli-migrations/lib/migrations/0.3.0-rc12/add-value-key-to-type-examples/migration.js
-var import_promises158 = require("fs/promises");
+var import_promises159 = require("fs/promises");
 var import_yaml13 = __toESM(require_dist9(), 1);
 
 // ../cli-migrations/lib/migrations/0.3.0-rc12/add-value-key-to-type-examples/getAllYamlFiles.js
@@ -938277,7 +938493,7 @@ var migration11 = {
   }
 };
 async function migrateYamlFile2(filepath, context3) {
-  const contents = await (0, import_promises158.readFile)(filepath);
+  const contents = await (0, import_promises159.readFile)(filepath);
   const parsedDocument = import_yaml13.default.parseDocument(contents.toString());
   const types4 = parsedDocument.get("types");
   if (types4 == null) {
@@ -938303,7 +938519,7 @@ async function migrateYamlFile2(filepath, context3) {
       examples.set(i11, { value });
     }
   }
-  await (0, import_promises158.writeFile)(filepath, parsedDocument.toString());
+  await (0, import_promises159.writeFile)(filepath, parsedDocument.toString());
 }
 
 // ../cli-migrations/lib/migrations/0.3.0-rc12/index.js
@@ -938314,7 +938530,7 @@ var versionMigrations11 = {
 var __default11 = versionMigrations11;
 
 // ../cli-migrations/lib/migrations/0.3.23/change-services-key-to-service/migration.js
-var import_promises159 = require("fs/promises");
+var import_promises160 = require("fs/promises");
 var import_yaml14 = __toESM(require_dist9(), 1);
 
 // ../cli-migrations/lib/migrations/0.3.23/change-services-key-to-service/getAllYamlFiles.js
@@ -938357,7 +938573,7 @@ var migration12 = {
   }
 };
 async function migrateYamlFile3(filepath, context3) {
-  const contents = await (0, import_promises159.readFile)(filepath);
+  const contents = await (0, import_promises160.readFile)(filepath);
   const parsedDocument = import_yaml14.default.parseDocument(contents.toString());
   if (!import_yaml14.default.isMap(parsedDocument.contents)) {
     return context3.failAndThrow("File is not a map");
@@ -938387,7 +938603,7 @@ async function migrateYamlFile3(filepath, context3) {
       pair.value = firstService.value;
     }
   }
-  await (0, import_promises159.writeFile)(filepath, parsedDocument.toString());
+  await (0, import_promises160.writeFile)(filepath, parsedDocument.toString());
 }
 
 // ../cli-migrations/lib/migrations/0.3.23/index.js
@@ -938398,7 +938614,7 @@ var versionMigrations12 = {
 var __default12 = versionMigrations12;
 
 // ../cli-migrations/lib/migrations/0.5.4/move-service-docs-to-top-level/migration.js
-var import_promises160 = require("fs/promises");
+var import_promises161 = require("fs/promises");
 var import_yaml15 = __toESM(require_dist9(), 1);
 
 // ../cli-migrations/lib/migrations/0.5.4/move-service-docs-to-top-level/getAllYamlFiles.js
@@ -938441,7 +938657,7 @@ var migration13 = {
   }
 };
 async function migrateYamlFile4(filepath, context3) {
-  const contents = await (0, import_promises160.readFile)(filepath);
+  const contents = await (0, import_promises161.readFile)(filepath);
   const parsedDocument = import_yaml15.default.parseDocument(contents.toString());
   if (!import_yaml15.default.isMap(parsedDocument.contents)) {
     return context3.failAndThrow("File is not a map");
@@ -938460,7 +938676,7 @@ async function migrateYamlFile4(filepath, context3) {
   }
   service.items.splice(indexOfServiceDocsPair, 1);
   parsedDocument.contents.items.unshift(docsPair);
-  await (0, import_promises160.writeFile)(filepath, parsedDocument.toString());
+  await (0, import_promises161.writeFile)(filepath, parsedDocument.toString());
 }
 
 // ../cli-migrations/lib/migrations/0.5.4/index.js
@@ -938471,7 +938687,7 @@ var versionMigrations13 = {
 var __default13 = versionMigrations13;
 
 // ../cli-migrations/lib/migrations/0.9.10/add-suffix-to-docs-domain/migration.js
-var import_promises161 = require("fs/promises");
+var import_promises162 = require("fs/promises");
 
 // ../cli-migrations/lib/migrations/0.9.10/add-suffix-to-docs-domain/getAllGeneratorYamlFiles.js
 init_lib6();
@@ -938513,14 +938729,14 @@ var migration14 = {
   }
 };
 async function migrateYamlFile5(filepath) {
-  const contents = await (0, import_promises161.readFile)(filepath);
+  const contents = await (0, import_promises162.readFile)(filepath);
   const domainSuffix = process.env.DOMAIN_SUFFIX ?? "docs.buildwithfern.com";
   const regex5 = /(docs:\s*domain:\s*)"([^"]*)"/g;
   const updatedSnapshot = contents.toString().replace(regex5, (_match, _prefix, domain3) => {
     return `docs:
       domain: "${domain3}.${domainSuffix}"`;
   });
-  await (0, import_promises161.writeFile)(filepath, updatedSnapshot.toString());
+  await (0, import_promises162.writeFile)(filepath, updatedSnapshot.toString());
 }
 
 // ../cli-migrations/lib/migrations/0.9.10/index.js
@@ -938540,10 +938756,10 @@ var LegacyDocsSerializers = __toESM(require_serialization4(), 1);
 
 // ../cli-migrations/lib/migrations/0.15.0-rc0/update-directory-structure/docs-config/loadRawDocsConfiguration.js
 init_lib6();
-var import_promises162 = require("fs/promises");
+var import_promises163 = require("fs/promises");
 async function loadRawDocsConfiguration2({ absolutePathToWorkspace }) {
   const filepath = getAbsolutePathToDocsYaml({ absolutePathToWorkspace });
-  const contentsStr = await (0, import_promises162.readFile)(filepath);
+  const contentsStr = await (0, import_promises163.readFile)(filepath);
   const contentsParsed = jsYaml.load(contentsStr.toString());
   const result = await LegacyDocsSerializers.DocsConfiguration.parse(contentsParsed);
   if (result.ok) {
@@ -938562,7 +938778,7 @@ function getAbsolutePathToDocsFolder({ absolutePathToWorkspace }) {
 
 // ../cli-migrations/lib/migrations/0.15.0-rc0/update-directory-structure/migrateDocsAndMultipleAPIs.js
 init_lib6();
-var import_promises164 = require("fs/promises");
+var import_promises165 = require("fs/promises");
 
 // ../cli-migrations/lib/migrations/0.15.0-rc0/update-directory-structure/docs-config/convertLegacyDocsConfig.js
 function convertLegacyDocsConfig({ docsConfiguration, docsURLs, apiName }) {
@@ -938745,10 +938961,10 @@ __export(legacy_exports, {
 
 // ../cli-migrations/lib/migrations/0.15.0-rc0/update-directory-structure/generators-configuration/loadRawGeneratorsConfiguration.js
 init_lib6();
-var import_promises163 = require("fs/promises");
+var import_promises164 = require("fs/promises");
 async function loadRawGeneratorsConfiguration2({ absolutePathToWorkspace }) {
   const filepath = getAbsolutePathToGeneratorsConfiguration({ absolutePathToWorkspace });
-  const contentsStr = await (0, import_promises163.readFile)(filepath);
+  const contentsStr = await (0, import_promises164.readFile)(filepath);
   const contentsParsed = jsYaml.load(contentsStr.toString());
   const result = await legacy_exports.GeneratorsConfigurationSchema.safeParseAsync(contentsParsed);
   if (result.success) {
@@ -938778,7 +938994,7 @@ function migrateDocsInstances(docsURLs) {
 var APIS_DIRECTORY2 = "apis";
 async function migrateDocsAndMultipleAPIs({ absolutePathToFernDirectory, workspaces, workspaceContainingDocs }) {
   const absolutePathToApisDirectory = join8(absolutePathToFernDirectory, RelativeFilePath2.of(APIS_DIRECTORY2));
-  await (0, import_promises164.mkdir)(absolutePathToApisDirectory);
+  await (0, import_promises165.mkdir)(absolutePathToApisDirectory);
   for (const workspace of workspaces) {
     const absolutePathToWorkspace = join8(absolutePathToFernDirectory, RelativeFilePath2.of(workspace));
     const docsURLs = await migrateAndWriteGeneratorsYml({ absolutePathToWorkspace });
@@ -938786,11 +939002,11 @@ async function migrateDocsAndMultipleAPIs({ absolutePathToFernDirectory, workspa
       await migrateAndWriteDocsYml({ absolutePathToWorkspace, docsURLs, apiName: workspaceContainingDocs });
       const absolutePathToDocsFolder = getAbsolutePathToDocsFolder({ absolutePathToWorkspace });
       await moveFolder({ src: absolutePathToDocsFolder, dest: absolutePathToFernDirectory });
-      await (0, import_promises164.rm)(absolutePathToDocsFolder, { recursive: true });
+      await (0, import_promises165.rm)(absolutePathToDocsFolder, { recursive: true });
     }
     const absolutePathToNestedWorkspace = join8(absolutePathToApisDirectory, RelativeFilePath2.of(workspace));
     await moveFolder({ src: absolutePathToWorkspace, dest: absolutePathToNestedWorkspace });
-    await (0, import_promises164.rm)(absolutePathToWorkspace, { recursive: true });
+    await (0, import_promises165.rm)(absolutePathToWorkspace, { recursive: true });
   }
 }
 async function migrateAndWriteGeneratorsYml({ absolutePathToWorkspace }) {
@@ -938803,7 +939019,7 @@ async function migrateAndWriteGeneratorsYml({ absolutePathToWorkspace }) {
     generatorsConfiguration,
     pathModificationStrategy: PathModificationStrategy.Nest
   });
-  await (0, import_promises164.writeFile)(absolutePathToGeneratorsConfiguration, jsYaml.dump(convertedResponse.value));
+  await (0, import_promises165.writeFile)(absolutePathToGeneratorsConfiguration, jsYaml.dump(convertedResponse.value));
   return convertedResponse.docsURLs;
 }
 async function migrateAndWriteDocsYml({ absolutePathToWorkspace, docsURLs, apiName }) {
@@ -938817,20 +939033,20 @@ async function migrateAndWriteDocsYml({ absolutePathToWorkspace, docsURLs, apiNa
     apiName
   });
   const absolutePathToDocsConfig = getAbsolutePathToDocsYaml({ absolutePathToWorkspace });
-  await (0, import_promises164.writeFile)(absolutePathToDocsConfig, jsYaml.dump(convertedDocsConfig));
+  await (0, import_promises165.writeFile)(absolutePathToDocsConfig, jsYaml.dump(convertedDocsConfig));
 }
 
 // ../cli-migrations/lib/migrations/0.15.0-rc0/update-directory-structure/migrateDocsAndSingleAPI.js
 init_lib6();
-var import_promises165 = require("fs/promises");
+var import_promises166 = require("fs/promises");
 async function migrateDocsAndSingleAPI({ absolutePathToFernDirectory, absolutePathToWorkspace }) {
   const docsURLs = await migrateAndWriteGeneratorsYml2({ absolutePathToWorkspace });
   await migrateAndWriteDocsYml2({ absolutePathToWorkspace, docsURLs });
   const absolutePathToDocsFolder = getAbsolutePathToDocsFolder({ absolutePathToWorkspace });
   await moveFolder({ src: absolutePathToDocsFolder, dest: absolutePathToFernDirectory });
   await moveFolder({ src: absolutePathToWorkspace, dest: absolutePathToFernDirectory });
-  await (0, import_promises165.rm)(absolutePathToDocsFolder, { recursive: true });
-  await (0, import_promises165.rm)(absolutePathToWorkspace, { recursive: true });
+  await (0, import_promises166.rm)(absolutePathToDocsFolder, { recursive: true });
+  await (0, import_promises166.rm)(absolutePathToWorkspace, { recursive: true });
 }
 async function migrateAndWriteDocsYml2({ absolutePathToWorkspace, docsURLs }) {
   const docsConfiguration = await loadRawDocsConfiguration2({ absolutePathToWorkspace });
@@ -938843,7 +939059,7 @@ async function migrateAndWriteDocsYml2({ absolutePathToWorkspace, docsURLs }) {
     apiName: void 0
   });
   const absolutePathToDocsConfig = getAbsolutePathToDocsYaml({ absolutePathToWorkspace });
-  await (0, import_promises165.writeFile)(absolutePathToDocsConfig, jsYaml.dump(convertedDocsConfig));
+  await (0, import_promises166.writeFile)(absolutePathToDocsConfig, jsYaml.dump(convertedDocsConfig));
 }
 async function migrateAndWriteGeneratorsYml2({ absolutePathToWorkspace }) {
   const generatorsConfiguration = await loadRawGeneratorsConfiguration2({ absolutePathToWorkspace });
@@ -938855,23 +939071,23 @@ async function migrateAndWriteGeneratorsYml2({ absolutePathToWorkspace }) {
     generatorsConfiguration,
     pathModificationStrategy: "MoveUp"
   });
-  await (0, import_promises165.writeFile)(absolutePathToGeneratorsConfiguration, jsYaml.dump(convertedResponse.value));
+  await (0, import_promises166.writeFile)(absolutePathToGeneratorsConfiguration, jsYaml.dump(convertedResponse.value));
   return convertedResponse.docsURLs;
 }
 
 // ../cli-migrations/lib/migrations/0.15.0-rc0/update-directory-structure/migrateOnlyMultipleAPIs.js
 init_lib6();
-var import_promises166 = require("fs/promises");
+var import_promises167 = require("fs/promises");
 var APIS_DIRECTORY3 = "apis";
 async function migrateOnlyMultipleAPIs({ absolutePathToFernDirectory, workspaces }) {
   const absolutePathToApisDirectory = join8(absolutePathToFernDirectory, RelativeFilePath2.of(APIS_DIRECTORY3));
-  await (0, import_promises166.mkdir)(absolutePathToApisDirectory);
+  await (0, import_promises167.mkdir)(absolutePathToApisDirectory);
   for (const workspace of workspaces) {
     const absolutePathToWorkspace = join8(absolutePathToFernDirectory, RelativeFilePath2.of(workspace));
     await migrateAndWriteGeneratorsYml3({ absolutePathToWorkspace });
     const absolutePathToNestedWorkspace = join8(absolutePathToApisDirectory, RelativeFilePath2.of(workspace));
     await moveFolder({ src: absolutePathToWorkspace, dest: absolutePathToNestedWorkspace });
-    await (0, import_promises166.rm)(absolutePathToWorkspace, { recursive: true });
+    await (0, import_promises167.rm)(absolutePathToWorkspace, { recursive: true });
   }
 }
 async function migrateAndWriteGeneratorsYml3({ absolutePathToWorkspace }) {
@@ -938884,16 +939100,16 @@ async function migrateAndWriteGeneratorsYml3({ absolutePathToWorkspace }) {
     generatorsConfiguration,
     pathModificationStrategy: PathModificationStrategy.Nest
   });
-  await (0, import_promises166.writeFile)(absolutePathToGeneratorsConfiguration, jsYaml.dump(convertedResponse.value));
+  await (0, import_promises167.writeFile)(absolutePathToGeneratorsConfiguration, jsYaml.dump(convertedResponse.value));
 }
 
 // ../cli-migrations/lib/migrations/0.15.0-rc0/update-directory-structure/migrateOnlySingleAPI.js
 init_lib6();
-var import_promises167 = require("fs/promises");
+var import_promises168 = require("fs/promises");
 async function migrateOnlySingleAPI({ absolutePathToFernDirectory, absolutePathToWorkspace }) {
   await migrateAndWriteGeneratorsYml4({ absolutePathToWorkspace });
   await moveFolder({ src: absolutePathToWorkspace, dest: absolutePathToFernDirectory });
-  await (0, import_promises167.rm)(absolutePathToWorkspace, { recursive: true });
+  await (0, import_promises168.rm)(absolutePathToWorkspace, { recursive: true });
 }
 async function migrateAndWriteGeneratorsYml4({ absolutePathToWorkspace }) {
   const generatorsConfiguration = await loadRawGeneratorsConfiguration2({ absolutePathToWorkspace });
@@ -938905,7 +939121,7 @@ async function migrateAndWriteGeneratorsYml4({ absolutePathToWorkspace }) {
     generatorsConfiguration,
     pathModificationStrategy: "MoveUp"
   });
-  await (0, import_promises167.writeFile)(absolutePathToGeneratorsConfiguration, jsYaml.dump(convertedResponse.value));
+  await (0, import_promises168.writeFile)(absolutePathToGeneratorsConfiguration, jsYaml.dump(convertedResponse.value));
 }
 
 // ../cli-migrations/lib/migrations/0.15.0-rc0/update-directory-structure/migration.js
@@ -938983,7 +939199,7 @@ var __default15 = versionMigrations15;
 
 // ../cli-migrations/lib/migrations/0.41.0-rc0/require-generators-yml/migration.js
 init_lib6();
-var import_promises168 = require("fs/promises");
+var import_promises169 = require("fs/promises");
 var import_yaml16 = __toESM(require_dist9(), 1);
 var migration16 = {
   name: "require-generators-yml",
@@ -939026,7 +939242,7 @@ async function addApiConfigurationToSingleWorkspace({ absolutePathToFernDirector
   if (existingGeneratorsYml == null) {
     if (openapiDirectory != null && openapiDirectory.contents[0] != null) {
       const absolutePathToGeneratorsYml = join8(absoluteFilepathToWorkspace, RelativeFilePath2.of("generators.yml"));
-      await (0, import_promises168.writeFile)(absolutePathToGeneratorsYml, jsYaml.dump({
+      await (0, import_promises169.writeFile)(absolutePathToGeneratorsYml, jsYaml.dump({
         api: {
           path: join8(relativize(absolutePathToFernDirectory, absoluteFilepathToWorkspace), RelativeFilePath2.of(openapiDirectory.name), RelativeFilePath2.of(openapiDirectory.contents[0]?.name))
         }
@@ -939041,7 +939257,7 @@ async function addApiConfigurationToSingleWorkspace({ absolutePathToFernDirector
       parsedDocument.set("api", {
         path: join8(relativize(absolutePathToFernDirectory, absoluteFilepathToWorkspace), RelativeFilePath2.of(openapiDirectory.name), RelativeFilePath2.of(openapiDirectory.contents[0]?.name))
       });
-      await (0, import_promises168.writeFile)(existingGeneratorsYml.absolutePath, parsedDocument.toString());
+      await (0, import_promises169.writeFile)(existingGeneratorsYml.absolutePath, parsedDocument.toString());
       context3.logger.info(source_default.green(`Updated ${existingGeneratorsYml.absolutePath}`));
     }
   }
@@ -939069,7 +939285,7 @@ var __default16 = versionMigrations16;
 
 // ../cli-migrations/lib/migrations/0.54.0-rc0/use-generators-yml-specs/migration.js
 init_lib6();
-var import_promises169 = require("fs/promises");
+var import_promises170 = require("fs/promises");
 var import_yaml17 = __toESM(require_dist9(), 1);
 var migration17 = {
   name: "generators-yml-use-api-specs",
@@ -939249,7 +939465,7 @@ async function addApiConfigurationToSingleWorkspace2({ absoluteFilepathToWorkspa
   if (schemaComment && documentToWrite.indexOf(schemaComment) === -1) {
     documentToWrite = `${schemaComment}${documentToWrite}`;
   }
-  await (0, import_promises169.writeFile)(generatorsYmlFile.absolutePath, documentToWrite);
+  await (0, import_promises170.writeFile)(generatorsYmlFile.absolutePath, documentToWrite);
   context3.logger.info(source_default.green(`Updated ${generatorsYmlFile.absolutePath}`));
 }
 async function parseApiSpec({ oldSpec, absoluteFilepathToWorkspace, files, directories, context: context3, namespace }) {
@@ -939296,7 +939512,7 @@ async function parseApiSpec({ oldSpec, absoluteFilepathToWorkspace, files, direc
   }
   let specContent;
   try {
-    const fileContents = await (0, import_promises169.readFile)(absoluteSpecPath, { encoding: "utf-8" });
+    const fileContents = await (0, import_promises170.readFile)(absoluteSpecPath, { encoding: "utf-8" });
     specContent = jsYaml.load(fileContents);
   } catch (e6) {
     context3.logger.warn(`Failed to read API spec file ${spec.path}. Error: ${e6}. Skipping...`);
@@ -939400,7 +939616,7 @@ var __default17 = versionMigrations17;
 
 // ../cli-migrations/lib/migrations/0.82.1/add-path-parameter-order-setting/migration.js
 init_lib6();
-var import_promises170 = require("fs/promises");
+var import_promises171 = require("fs/promises");
 var migration18 = {
   name: "add-path-parameter-order-setting",
   summary: `Adds the 'path-parameter-order' setting to existing API configurations to maintain backwards compatibility.
@@ -939488,7 +939704,7 @@ async function updateGeneratorsYml({ context: context3, files }) {
     documentToWrite = `${schemaComment}
 ${documentToWrite}`;
   }
-  await (0, import_promises170.writeFile)(generatorsYmlFile.absolutePath, documentToWrite);
+  await (0, import_promises171.writeFile)(generatorsYmlFile.absolutePath, documentToWrite);
   context3.logger.info(source_default.green(`Updated ${generatorsYmlFile.absolutePath}`));
 }
 async function getFilesAndDirectories3(absoluteFilepath) {
@@ -939525,7 +939741,7 @@ var __default18 = versionMigrations18;
 
 // ../cli-migrations/lib/migrations/1.0.0/update-settings-defaults/migration.js
 init_lib6();
-var import_promises171 = require("fs/promises");
+var import_promises172 = require("fs/promises");
 var migration19 = {
   name: "update-1_0_0-defaults",
   summary: `The defaults of the API spec settings have changed. 
@@ -939700,7 +939916,7 @@ async function updateGeneratorsYml2({ context: context3, files }) {
     documentToWrite = `${schemaComment}
 ${documentToWrite}`;
   }
-  await (0, import_promises171.writeFile)(generatorsYmlFile.absolutePath, documentToWrite);
+  await (0, import_promises172.writeFile)(generatorsYmlFile.absolutePath, documentToWrite);
   context3.logger.info(source_default.green(`Updated ${generatorsYmlFile.absolutePath}`));
 }
 async function getFilesAndDirectories4(absoluteFilepath) {
@@ -939770,7 +939986,7 @@ var __default19 = versionMigrations19;
 
 // ../cli-migrations/lib/migrations/2.0.0-rc0/update-settings-defaults/migration.js
 init_lib6();
-var import_promises172 = require("fs/promises");
+var import_promises173 = require("fs/promises");
 var migration20 = {
   name: "update-2_0_0-defaults",
   summary: `The default of 'coerce-enums-to-literals' has changed from true to false. 
@@ -939945,7 +940161,7 @@ async function updateGeneratorsYml3({ context: context3, files }) {
     documentToWrite = `${schemaComment}
 ${documentToWrite}`;
   }
-  await (0, import_promises172.writeFile)(generatorsYmlFile.absolutePath, documentToWrite);
+  await (0, import_promises173.writeFile)(generatorsYmlFile.absolutePath, documentToWrite);
   context3.logger.info(source_default.green(`Updated ${generatorsYmlFile.absolutePath}`));
 }
 async function getFilesAndDirectories5(absoluteFilepath) {
@@ -939992,7 +940208,7 @@ var __default20 = versionMigrations20;
 
 // ../cli-migrations/lib/migrations/2.13.0/migrate-deprecated-generator-api-settings/migration.js
 init_lib6();
-var import_promises173 = require("fs/promises");
+var import_promises174 = require("fs/promises");
 var migration21 = {
   name: "migrate-deprecated-generator-api-settings",
   summary: `Migrates deprecated generator-level API settings keys to their new equivalents:
@@ -940083,7 +940299,7 @@ async function updateGeneratorsYml4({ context: context3, files }) {
     documentToWrite = `${schemaComment}
 ${documentToWrite}`;
   }
-  await (0, import_promises173.writeFile)(generatorsYmlFile.absolutePath, documentToWrite);
+  await (0, import_promises174.writeFile)(generatorsYmlFile.absolutePath, documentToWrite);
   context3.logger.info(source_default.green(`Updated ${generatorsYmlFile.absolutePath}`));
 }
 function migrateDeprecatedSettings(settings, context3) {
@@ -940130,7 +940346,7 @@ var __default21 = versionMigrations21;
 
 // ../cli-migrations/lib/migrations/3.0.0/enable-smart-casing/migration.js
 init_lib6();
-var import_promises174 = require("fs/promises");
+var import_promises175 = require("fs/promises");
 var migration22 = {
   name: "enable-smart-casing",
   summary: `Sets 'smart-casing: false' for existing generators to preserve backwards compatibility.
@@ -940214,7 +940430,7 @@ async function updateGeneratorsYml5({ context: context3, files }) {
     documentToWrite = `${schemaComment}
 ${documentToWrite}`;
   }
-  await (0, import_promises174.writeFile)(generatorsYmlFile.absolutePath, documentToWrite);
+  await (0, import_promises175.writeFile)(generatorsYmlFile.absolutePath, documentToWrite);
   context3.logger.info(source_default.green(`Updated ${generatorsYmlFile.absolutePath}`));
 }
 function setSmartCasingFalseIfNotConfigured(generator, context3) {
@@ -940355,7 +940571,7 @@ ${source_default.dim(migration23.summary)}`
 }
 
 // src/commands/upgrade/upgrade.ts
-var import_promises175 = require("fs/promises");
+var import_promises176 = require("fs/promises");
 
 // src/cwd.ts
 var FERN_CWD_ENV_VAR = "FERN_CWD";
@@ -940682,7 +940898,7 @@ async function upgrade({
     const newProjectConfig = produce(projectConfig2.rawConfig, (draft) => {
       draft.version = resolvedTargetVersion;
     });
-    await (0, import_promises175.writeFile)(
+    await (0, import_promises176.writeFile)(
       projectConfig2._absolutePath,
       ensureFinalNewline2(JSON.stringify(newProjectConfig, void 0, 2))
     );
@@ -941307,7 +941523,7 @@ async function validateWorkspaces({
 
 // src/commands/write-definition/writeDefinitionForWorkspaces.ts
 init_lib6();
-var import_promises176 = require("fs/promises");
+var import_promises177 = require("fs/promises");
 var import_path91 = __toESM(require("path"), 1);
 async function writeDefinitionForWorkspaces({
   project,
@@ -941388,28 +941604,28 @@ async function writeFernDefinition({
     return a10.localeCompare(b19);
   };
   if (await doesPathExist(absolutePathToOutputDirectory)) {
-    await (0, import_promises176.rm)(absolutePathToOutputDirectory, { recursive: true });
+    await (0, import_promises177.rm)(absolutePathToOutputDirectory, { recursive: true });
   }
-  await (0, import_promises176.mkdir)(absolutePathToOutputDirectory, { recursive: true });
-  await (0, import_promises176.writeFile)(
+  await (0, import_promises177.mkdir)(absolutePathToOutputDirectory, { recursive: true });
+  await (0, import_promises177.writeFile)(
     join8(absolutePathToOutputDirectory, RelativeFilePath2.of(ROOT_API_FILENAME)),
     jsYaml.dump(definition3.rootApiFile.contents, { sortKeys })
   );
   for (const [relativePath, packageMarker] of Object.entries(definition3.packageMarkers)) {
     const absoluteFilepath = join8(absolutePathToOutputDirectory, RelativeFilePath2.of(relativePath));
-    await (0, import_promises176.mkdir)(dirname6(absoluteFilepath), { recursive: true });
-    await (0, import_promises176.writeFile)(absoluteFilepath, jsYaml.dump(packageMarker.contents, { sortKeys }));
+    await (0, import_promises177.mkdir)(dirname6(absoluteFilepath), { recursive: true });
+    await (0, import_promises177.writeFile)(absoluteFilepath, jsYaml.dump(packageMarker.contents, { sortKeys }));
   }
   for (const [relativePath, definitionFile] of Object.entries(definition3.namedDefinitionFiles)) {
     const absoluteFilepath = join8(absolutePathToOutputDirectory, RelativeFilePath2.of(relativePath));
-    await (0, import_promises176.mkdir)(dirname6(absoluteFilepath), { recursive: true });
-    await (0, import_promises176.writeFile)(absoluteFilepath, jsYaml.dump(definitionFile.contents, { sortKeys }));
+    await (0, import_promises177.mkdir)(dirname6(absoluteFilepath), { recursive: true });
+    await (0, import_promises177.writeFile)(absoluteFilepath, jsYaml.dump(definitionFile.contents, { sortKeys }));
   }
 }
 
 // src/commands/write-docs-definition/writeDocsDefinitionForProject.ts
 init_lib6();
-var import_promises177 = require("fs/promises");
+var import_promises178 = require("fs/promises");
 async function writeDocsDefinitionForProject({
   project,
   outputPath,
@@ -941441,7 +941657,7 @@ async function writeDocsDefinitionForProject({
       targetAudiences: docsWorkspace.config.instances[0]?.audiences ? Array.isArray(docsWorkspace.config.instances[0].audiences) ? docsWorkspace.config.instances[0].audiences : [docsWorkspace.config.instances[0].audiences] : void 0
     });
     const docsDefinition = await docsResolver.resolve();
-    await (0, import_promises177.writeFile)(AbsoluteFilePath2.of(outputPath), JSON.stringify(docsDefinition, null, 2));
+    await (0, import_promises178.writeFile)(AbsoluteFilePath2.of(outputPath), JSON.stringify(docsDefinition, null, 2));
     context3.logger.info(source_default.green(`Docs definition written to ${outputPath}`));
   });
 }
@@ -941450,7 +941666,7 @@ async function writeDocsDefinitionForProject({
 init_lib6();
 var import_cli_progress2 = __toESM(require_cli_progress(), 1);
 var import_fs38 = require("fs");
-var import_promises181 = require("fs/promises");
+var import_promises182 = require("fs/promises");
 var import_is_ci3 = __toESM(require_is_ci(), 1);
 var import_path94 = __toESM(require("path"), 1);
 
@@ -941943,7 +942159,7 @@ function shouldProcessFile(filePath, stub) {
 
 // src/commands/write-translation/docs-config-utils.ts
 init_lib6();
-var import_promises178 = require("fs/promises");
+var import_promises179 = require("fs/promises");
 
 // src/commands/write-translation/url-utils.ts
 function addLanguageSuffixToUrl(url3, language) {
@@ -942100,7 +942316,7 @@ async function createLanguageSpecificDocsConfig({
   stub = false
 }) {
   try {
-    const originalConfigContent = await (0, import_promises178.readFile)(originalDocsConfigPath, "utf-8");
+    const originalConfigContent = await (0, import_promises179.readFile)(originalDocsConfigPath, "utf-8");
     const transformation = {
       filePath: DOCS_CONFIGURATION_FILENAME,
       language,
@@ -942114,7 +942330,7 @@ async function createLanguageSpecificDocsConfig({
     const modifiedConfigContent = jsYaml.dump(modifiedConfig, {
       sortKeys: false
     });
-    await (0, import_promises178.writeFile)(modifiedConfigPath, modifiedConfigContent, "utf-8");
+    await (0, import_promises179.writeFile)(modifiedConfigPath, modifiedConfigContent, "utf-8");
     context3.logger.debug(`Created language-specific docs config: ${modifiedConfigPath}`);
   } catch (error50) {
     if (error50 instanceof Error && error50.message.includes("403")) {
@@ -942127,11 +942343,11 @@ async function createLanguageSpecificDocsConfig({
 // src/commands/write-translation/file-collection-utils.ts
 init_lib6();
 var import_fs36 = require("fs");
-var import_promises179 = require("fs/promises");
+var import_promises180 = require("fs/promises");
 var import_path92 = __toESM(require("path"), 1);
 async function collectFiles(baseDirectory, relativeBase) {
   const discoveredFiles = {};
-  const entries23 = await (0, import_promises179.readdir)(baseDirectory);
+  const entries23 = await (0, import_promises180.readdir)(baseDirectory);
   for (const entry of entries23) {
     if (entry === "translations") {
       continue;
@@ -942154,7 +942370,7 @@ async function collectFiles(baseDirectory, relativeBase) {
 // src/commands/write-translation/hash-utils.ts
 var import_crypto13 = require("crypto");
 var import_fs37 = require("fs");
-var import_promises180 = require("fs/promises");
+var import_promises181 = require("fs/promises");
 var import_path93 = __toESM(require("path"), 1);
 function calculateContentHash(content5) {
   return (0, import_crypto13.createHash)("sha256").update(content5, "utf-8").digest("hex");
@@ -942165,7 +942381,7 @@ async function loadHashMappings(translationsDirectory) {
     return {};
   }
   try {
-    const hashesContent = await (0, import_promises180.readFile)(hashesFilePath, "utf-8");
+    const hashesContent = await (0, import_promises181.readFile)(hashesFilePath, "utf-8");
     const parsed = JSON.parse(hashesContent);
     const { _comment, ...hashMappings } = parsed;
     return hashMappings;
@@ -942186,11 +942402,11 @@ async function saveHashMappings(translationsDirectory, hashMappings) {
     _comment: "This file is auto-generated by Fern to track source file changes for translation purposes. Do not edit manually - it will be overwritten on the next translation update.",
     ...sortedMappings
   };
-  await (0, import_promises180.writeFile)(hashesFilePath, JSON.stringify(fileContent, null, 2), "utf-8");
+  await (0, import_promises181.writeFile)(hashesFilePath, JSON.stringify(fileContent, null, 2), "utf-8");
 }
 async function hasFileChanged(filePath, relativePath, previousHashes) {
   try {
-    const content5 = await (0, import_promises180.readFile)(filePath, "utf-8");
+    const content5 = await (0, import_promises181.readFile)(filePath, "utf-8");
     const currentHash = calculateContentHash(content5);
     const previousHash = previousHashes[relativePath];
     return currentHash !== previousHash;
@@ -942246,7 +942462,7 @@ async function writeTranslationForProject({
     }
     if (!(0, import_fs38.existsSync)(translationsDirectory)) {
       context3.logger.debug(`Creating translations directory at: ${translationsDirectory}`);
-      await (0, import_promises181.mkdir)(translationsDirectory, { recursive: true });
+      await (0, import_promises182.mkdir)(translationsDirectory, { recursive: true });
     }
     const languageStats = {};
     const targetLanguages = languages.filter((lang) => lang !== sourceLanguage);
@@ -942259,7 +942475,7 @@ async function writeTranslationForProject({
         RelativeFilePath2.of("fern")
       );
       if (!(0, import_fs38.existsSync)(languageDirectory)) {
-        await (0, import_promises181.mkdir)(languageDirectory, { recursive: true });
+        await (0, import_promises182.mkdir)(languageDirectory, { recursive: true });
       }
       languageStats[language] = {
         filesProcessed: 0,
@@ -942361,7 +942577,7 @@ async function writeTranslationForProject({
                 `[COMPLETED] ${DOCS_CONFIGURATION_FILENAME} -> ${language}/${DOCS_CONFIGURATION_FILENAME}`
               );
             }
-            const originalConfigContent = await (0, import_promises181.readFile)(originalDocsConfigPath, "utf-8");
+            const originalConfigContent = await (0, import_promises182.readFile)(originalDocsConfigPath, "utf-8");
             await updateAndSaveHashForFile(
               translationsDirectory,
               hashMappings,
@@ -942406,7 +942622,7 @@ async function writeTranslationForProject({
             continue;
           }
           cliContext.logger.debug(`[PROCESSING] ${relativePath} (detected changes)`);
-          const originalContent = await (0, import_promises181.readFile)(filePath, "utf-8");
+          const originalContent = await (0, import_promises182.readFile)(filePath, "utf-8");
           await updateAndSaveHashForFile(translationsDirectory, hashMappings, relativePath, originalContent);
           const sourceStats = languageStats[sourceLanguage];
           if (sourceStats) {
@@ -942431,7 +942647,7 @@ async function writeTranslationForProject({
             const destPath = join8(languageDirectory, relativePath);
             const destDir = import_path94.default.dirname(destPath);
             if (!(0, import_fs38.existsSync)(destDir)) {
-              await (0, import_promises181.mkdir)(destDir, { recursive: true });
+              await (0, import_promises182.mkdir)(destDir, { recursive: true });
             }
             const transformation = {
               filePath: relativePath,
@@ -942444,7 +942660,7 @@ async function writeTranslationForProject({
               cliContext,
               stub
             });
-            await (0, import_promises181.writeFile)(destPath, transformedContent, "utf-8");
+            await (0, import_promises182.writeFile)(destPath, transformedContent, "utf-8");
             const languageStatsForLang = languageStats[language];
             if (languageStatsForLang) {
               languageStatsForLang.filesProcessed++;
@@ -942475,9 +942691,9 @@ async function writeTranslationForProject({
             const destPath = join8(languageDirectory, relativePath);
             const destDir = import_path94.default.dirname(destPath);
             if (!(0, import_fs38.existsSync)(destDir)) {
-              await (0, import_promises181.mkdir)(destDir, { recursive: true });
+              await (0, import_promises182.mkdir)(destDir, { recursive: true });
             }
-            await (0, import_promises181.copyFile)(filePath, destPath);
+            await (0, import_promises182.copyFile)(filePath, destPath);
             assetsCopied++;
             cliContext.logger.debug(`[ASSET COPIED] ${relativePath} -> ${language}/${relativePath}`);
           }