@fern-api/fern-api-dev 5.102.0 → 5.104.0

package/cli.cjs

@@ -90561,6 +90561,53 @@ var init_cloneRepository = __esm({
   }
 });
 
+// ../../commons/github/lib/cloneRepositoryAtRef.js
+async function cloneRepositoryAtRef({ repositoryUrl, ref: ref2 }) {
+  if (!isGitAvailable()) {
+    throw new Error("Git is not installed or not found in PATH. Cloning a git source requires git to be available. Please install git and ensure it is in your PATH.");
+  }
+  const tmpDir = await import_tmp_promise3.default.dir({ unsafeCleanup: true });
+  const cloneArgs = ["--depth", "1", "--config", "core.symlinks=false"];
+  try {
+    if (ref2 != null && isCommitSha(ref2)) {
+      await simpleGit().clone(repositoryUrl, tmpDir.path, [...cloneArgs, "--no-checkout"]);
+      const repoGit = simpleGit(tmpDir.path);
+      await repoGit.fetch("origin", ref2, { "--depth": "1" });
+      await repoGit.checkout(ref2);
+    } else {
+      await simpleGit().clone(repositoryUrl, tmpDir.path, ref2 != null ? [...cloneArgs, "--branch", ref2] : cloneArgs);
+    }
+  } catch (error50) {
+    const errorMessage = extractErrorMessage(error50);
+    if (errorMessage.includes("Authentication failed") || errorMessage.includes("could not read Username") || errorMessage.includes("401") || errorMessage.includes("403")) {
+      throw new Error(`Failed to clone ${repositoryUrl}: authentication failed. Ensure your git credentials are configured for that repository. The CLI uses your system's git credential configuration (credential helpers, SSH keys, GIT_ASKPASS). Original error: ${errorMessage}`);
+    }
+    if (errorMessage.toLowerCase().includes("repository not found") || errorMessage.includes("404")) {
+      throw new Error(`Failed to clone ${repositoryUrl}: repository not found. Check that it exists and your credentials have access. Original error: ${errorMessage}`);
+    }
+    throw new Error(`Failed to clone ${repositoryUrl}${ref2 != null ? ` at ref '${ref2}'` : ""}. Original error: ${errorMessage}`);
+  }
+  return tmpDir.path;
+}
+function resolveRepositorySubpath({ repositoryRoot, subpath, description }) {
+  const resolved = import_path19.default.resolve(repositoryRoot, subpath);
+  if (resolved !== repositoryRoot && !resolved.startsWith(repositoryRoot + import_path19.default.sep)) {
+    throw new Error(`Invalid ${description} '${subpath}': path must be relative to the repository root and cannot traverse outside it.`);
+  }
+  return resolved;
+}
+var import_path19, import_tmp_promise3;
+var init_cloneRepositoryAtRef = __esm({
+  "../../commons/github/lib/cloneRepositoryAtRef.js"() {
+    "use strict";
+    init_lib4();
+    import_path19 = __toESM(require("path"), 1);
+    init_esm16();
+    import_tmp_promise3 = __toESM(require_tmp_promise(), 1);
+    import_tmp_promise3.default.setGracefulCleanup();
+  }
+});
+
 // ../../commons/github/lib/createOrUpdatePullRequest.js
 function parseRepository2(repository) {
   const [owner, repo] = repository.split("/");
@@ -98956,6 +99003,7 @@ var lib_exports4 = {};
 __export(lib_exports4, {
   ClonedRepository: () => ClonedRepository,
   cloneRepository: () => cloneRepository,
+  cloneRepositoryAtRef: () => cloneRepositoryAtRef,
   createOrUpdatePullRequest: () => createOrUpdatePullRequest,
   deleteBranch: () => deleteBranch,
   expandFernignorePatterns: () => expandFernignorePatterns,
@@ -98963,13 +99011,15 @@ __export(lib_exports4, {
   getGithubApiBaseUrl: () => getGithubApiBaseUrl,
   getLatestRelease: () => getLatestRelease,
   getOrUpdateBranch: () => getOrUpdateBranch,
-  parseRepository: () => parseRepository
+  parseRepository: () => parseRepository,
+  resolveRepositorySubpath: () => resolveRepositorySubpath
 });
 var init_lib11 = __esm({
   "../../commons/github/lib/index.js"() {
     "use strict";
     init_ClonedRepository();
     init_cloneRepository();
+    init_cloneRepositoryAtRef();
     init_createOrUpdatePullRequest();
     init_deleteBranch();
     init_expandFernignorePatterns();
@@ -130957,7 +131007,8 @@ var init_OpenApiSettingsSchema2 = __esm({
       "infer-discriminated-union-base-properties": schemas_exports8.boolean().optional(),
       "disambiguate-request-names": schemas_exports8.boolean().optional(),
       "ignore-tags": schemas_exports8.boolean().optional(),
-      "respect-parameter-content": schemas_exports8.boolean().optional()
+      "respect-parameter-content": schemas_exports8.boolean().optional(),
+      "respect-per-spec-base-path": schemas_exports8.boolean().optional()
     }).extend(BaseApiSettingsSchema);
   }
 });
@@ -152823,7 +152874,8 @@ var init_options2 = __esm({
       shouldInferDiscriminatedUnionBaseProperties: false,
       disambiguateRequestNames: true,
       ignoreTags: false,
-      respectParameterContent: false
+      respectParameterContent: false,
+      respectPerSpecBasePath: false
     };
   }
 });
@@ -158813,14 +158865,14 @@ function convertMultipartRequestToSchema(request7) {
     maxProperties: void 0
   });
 }
-var fs, path19, ExampleEndpointFactory;
+var fs, path20, ExampleEndpointFactory;
 var init_ExampleEndpointFactory = __esm({
   "../api-importers/openapi/openapi-ir-parser/lib/openapi/v3/converters/ExampleEndpointFactory.js"() {
     "use strict";
     init_lib4();
     init_lib13();
     fs = __toESM(require("fs"), 1);
-    path19 = __toESM(require("path"), 1);
+    path20 = __toESM(require("path"), 1);
     init_ExampleTypeFactory();
     init_convertSchemaToSchemaWithExample();
     init_isSchemaRequired();
@@ -158861,15 +158913,15 @@ var init_ExampleEndpointFactory = __esm({
         let logDir;
         if (this.context.source.type === "openapi") {
           const sourceFile = this.context.source.file;
-          const sourceDir = path19.dirname(sourceFile);
+          const sourceDir = path20.dirname(sourceFile);
           let currentDir = sourceDir;
-          while (currentDir !== path19.dirname(currentDir)) {
-            const fernDir = path19.join(currentDir, "fern");
+          while (currentDir !== path20.dirname(currentDir)) {
+            const fernDir = path20.join(currentDir, "fern");
             if (fs.existsSync(fernDir) && fs.statSync(fernDir).isDirectory()) {
               logDir = fernDir;
               break;
             }
-            currentDir = path19.dirname(currentDir);
+            currentDir = path20.dirname(currentDir);
           }
           if (!logDir) {
             logDir = sourceDir;
@@ -158878,7 +158930,7 @@ var init_ExampleEndpointFactory = __esm({
           logDir = process.cwd();
         }
         const resolvedLogDir = logDir ?? process.cwd();
-        const logPath = path19.join(resolvedLogDir, "schemas_missing_examples.txt");
+        const logPath = path20.join(resolvedLogDir, "schemas_missing_examples.txt");
         const logContent = [
           `# Schemas Missing Examples Report`,
           `# Generated on: ${(/* @__PURE__ */ new Date()).toISOString()}`,
@@ -165595,7 +165647,7 @@ function maybeResolveCodeReference(code5, baseDir) {
     return code5;
   }
   if (isCodeReference(code5)) {
-    const resolvedPath = (0, import_path19.resolve)(baseDir ?? process.cwd(), code5.$ref);
+    const resolvedPath = (0, import_path20.resolve)(baseDir ?? process.cwd(), code5.$ref);
     if ((0, import_fs12.existsSync)(resolvedPath)) {
       try {
         const fileContent = (0, import_fs12.readFileSync)(resolvedPath, "utf-8");
@@ -165629,7 +165681,7 @@ function resolveCodeSamples(codeSamples, baseDir) {
 }
 function getExamplesFromExtension(operationContext, operationObject, context3) {
   const exampleEndpointCalls = getExtension(operationObject, FernOpenAPIExtension.EXAMPLES);
-  const baseDir = context3.source.type === "openapi" ? (0, import_path19.dirname)(context3.source.file) : void 0;
+  const baseDir = context3.source.type === "openapi" ? (0, import_path20.dirname)(context3.source.file) : void 0;
   const resolvedExamples = (exampleEndpointCalls ?? []).map((example) => {
     if (!isPlainObject4(example)) {
       return example;
@@ -165677,7 +165729,7 @@ function getExamplesFromExtension(operationContext, operationObject, context3) {
   }
   return validatedExampleEndpointCalls.map(EndpointExample2.unknown);
 }
-var import_fs12, import_path19;
+var import_fs12, import_path20;
 var init_getExamplesFromExtension = __esm({
   "../api-importers/openapi/openapi-ir-parser/lib/openapi/v3/extensions/getExamplesFromExtension.js"() {
     "use strict";
@@ -165685,7 +165737,7 @@ var init_getExamplesFromExtension = __esm({
     init_lib10();
     init_lib13();
     import_fs12 = require("fs");
-    import_path19 = require("path");
+    import_path20 = require("path");
     init_getExtension();
     init_RedoclyCodeSampleSchema();
     init_extensions();
@@ -168635,6 +168687,7 @@ function generateIr({ openApi, taskContext, options: options2, source: source2,
       taskContext.logger.warn(message);
     }
   }
+  const plainBasePath = options2.respectPerSpecBasePath && fernBasePathParsed != null && fernBasePathParsed.pathParameters.length === 0 ? fernBasePathParsed.basePath : void 0;
   Object.entries(openApi.paths ?? {}).forEach(([path122, pathItem]) => {
     if (pathItem == null) {
       return;
@@ -168647,16 +168700,16 @@ function generateIr({ openApi, taskContext, options: options2, source: source2,
       }
       switch (operation.type) {
         case "async":
-          endpointsWithExample.push(...operation.sync);
-          endpointsWithExample.push(...operation.async);
+          endpointsWithExample.push(...prependBasePathToEndpoints(operation.sync, plainBasePath));
+          endpointsWithExample.push(...prependBasePathToEndpoints(operation.async, plainBasePath));
           break;
         case "http":
-          endpointsWithExample.push(...operation.value);
+          endpointsWithExample.push(...prependBasePathToEndpoints(operation.value, plainBasePath));
           break;
         case "streaming":
-          endpointsWithExample.push(...operation.streaming);
+          endpointsWithExample.push(...prependBasePathToEndpoints(operation.streaming, plainBasePath));
           if (operation.nonStreaming) {
-            endpointsWithExample.push(...operation.nonStreaming);
+            endpointsWithExample.push(...prependBasePathToEndpoints(operation.nonStreaming, plainBasePath));
           }
           break;
         case "webhook":
@@ -168864,17 +168917,8 @@ function generateIr({ openApi, taskContext, options: options2, source: source2,
       document: openApi
     }),
     specVersion: openApi.info.version != null && openApi.info.version.length > 0 ? openApi.info.version : void 0,
-    basePath: (() => {
-      const parsed = getFernBasePath(openApi);
-      return parsed?.basePath;
-    })(),
-    basePathParameters: (() => {
-      const parsed = getFernBasePath(openApi);
-      if (parsed == null || parsed.pathParameters.length === 0) {
-        return void 0;
-      }
-      return parsed.pathParameters;
-    })(),
+    basePath: fernBasePathParsed != null && (!options2.respectPerSpecBasePath || fernBasePathParsed.pathParameters.length > 0) ? fernBasePathParsed.basePath : void 0,
+    basePathParameters: fernBasePathParsed != null && fernBasePathParsed.pathParameters.length > 0 ? fernBasePathParsed.pathParameters : void 0,
     title: openApi.info.title ?? "",
     description: openApi.info.description,
     groups: Object.fromEntries(Object.entries(groupInfo ?? {}).map(([key2, value2]) => {
@@ -168962,6 +169006,26 @@ function maybeRemoveDiscriminantsFromSchemas(schemas, context3, source2) {
   }
   return result;
 }
+function prependBasePath(path122, basePath) {
+  if (basePath == null || basePath === "/") {
+    return path122;
+  }
+  const normalizedBasePath = basePath.replace(/\/+$/, "");
+  if (path122 === normalizedBasePath || path122.startsWith(`${normalizedBasePath}/`)) {
+    return path122;
+  }
+  const normalizedPath = path122.replace(/^\/+/, "");
+  return normalizedPath.length > 0 ? `${normalizedBasePath}/${normalizedPath}` : normalizedBasePath;
+}
+function prependBasePathToEndpoints(endpoints, basePath) {
+  if (basePath == null || basePath === "/") {
+    return endpoints;
+  }
+  return endpoints.map((endpoint3) => ({
+    ...endpoint3,
+    path: prependBasePath(endpoint3.path, basePath)
+  }));
+}
 function getParentSchemaIdsWithNonUnionChildren(schemas, context3) {
   const protectedParents = /* @__PURE__ */ new Set();
   for (const [schemaId, schema] of Object.entries(schemas)) {
@@ -169141,7 +169205,7 @@ function parse8({ context: context3, documents, options: options2 }) {
             source: source2,
             namespace: document4.namespace
           });
-          ir3 = merge6(ir3, openapiIr, getParseOptions({ options: document4.settings, overrides: options2 }));
+          ir3 = merge6(ir3, openapiIr, getParseOptions({ options: document4.settings, overrides: options2 }), context3);
           documentIndex++;
           break;
         }
@@ -169338,7 +169402,17 @@ function extractApiNameFromServers(servers) {
 function hasGroupedServers(servers) {
   return servers.some((server) => server.type === "grouped");
 }
-function merge6(ir1, ir22, options2) {
+function mergeBasePath(ir1, ir22, options2, context3) {
+  if (options2?.respectPerSpecBasePath === true && ir1.basePath != null && ir22.basePath != null && ir1.basePath !== ir22.basePath) {
+    context3.failWithoutThrowing(`Conflicting parameterized x-fern-base-path values: '${ir1.basePath}' and '${ir22.basePath}'.`);
+  }
+  return {
+    basePath: ir1.basePath ?? ir22.basePath,
+    basePathParameters: ir1.basePathParameters ?? ir22.basePathParameters
+  };
+}
+function merge6(ir1, ir22, options2, context3) {
+  const mergedBasePath = mergeBasePath(ir1, ir22, options2, context3);
   const shouldGroupEnvironments = options2?.groupMultiApiEnvironments === true;
   if (!shouldGroupEnvironments) {
     return {
@@ -169346,8 +169420,8 @@ function merge6(ir1, ir22, options2) {
       specVersion: ir1.specVersion ?? ir22.specVersion,
       title: ir1.title ?? ir22.title,
       description: ir1.description ?? ir22.description,
-      basePath: ir1.basePath ?? ir22.basePath,
-      basePathParameters: ir1.basePathParameters ?? ir22.basePathParameters,
+      basePath: mergedBasePath.basePath,
+      basePathParameters: mergedBasePath.basePathParameters,
       servers: [...ir1.servers, ...ir22.servers],
       websocketServers: [...ir1.websocketServers, ...ir22.websocketServers],
       tags: {
@@ -169489,8 +169563,8 @@ function merge6(ir1, ir22, options2) {
       specVersion: ir1.specVersion ?? ir22.specVersion,
       title: ir1.title ?? ir22.title,
       description: ir1.description ?? ir22.description,
-      basePath: ir1.basePath ?? ir22.basePath,
-      basePathParameters: ir1.basePathParameters ?? ir22.basePathParameters,
+      basePath: mergedBasePath.basePath,
+      basePathParameters: mergedBasePath.basePathParameters,
       // Cast grouped servers to Server[] - buildEnvironments.ts handles the grouped structure
       // biome-ignore lint/suspicious/noExplicitAny: Required to preserve grouped server metadata through type system
       servers: mergedServers,
@@ -169544,8 +169618,8 @@ function merge6(ir1, ir22, options2) {
     specVersion: ir1.specVersion ?? ir22.specVersion,
     title: ir1.title ?? ir22.title,
     description: ir1.description ?? ir22.description,
-    basePath: ir1.basePath ?? ir22.basePath,
-    basePathParameters: ir1.basePathParameters ?? ir22.basePathParameters,
+    basePath: mergedBasePath.basePath,
+    basePathParameters: mergedBasePath.basePathParameters,
     servers: dedupeServers([...ir1.servers, ...ir22.servers]),
     websocketServers: [...ir1.websocketServers, ...ir22.websocketServers],
     tags: {
@@ -200021,7 +200095,8 @@ var init_getAPIDefinitionSettings = __esm({
       shouldInferDiscriminatedUnionBaseProperties: "shouldInferDiscriminatedUnionBaseProperties",
       disambiguateRequestNames: "disambiguateRequestNames",
       ignoreTags: "ignoreTags",
-      respectParameterContent: "respectParameterContent"
+      respectParameterContent: "respectParameterContent",
+      respectPerSpecBasePath: "respectPerSpecBasePath"
     };
   }
 });
@@ -200252,7 +200327,7 @@ async function validateSchema({ schema, value: value2, context: context3, filepa
       prefix: "  - "
     });
   });
-  const errorMessage = [`Failed to parse file: ${import_path20.default.relative(process.cwd(), filepathBeingParsed)}`, ...issues].join("\n");
+  const errorMessage = [`Failed to parse file: ${import_path21.default.relative(process.cwd(), filepathBeingParsed)}`, ...issues].join("\n");
   return context3.failAndThrow(errorMessage, void 0, { code: CliError.Code.ConfigError });
 }
 function joinZodPath(arr) {
@@ -200264,13 +200339,13 @@ function joinZodPath(arr) {
     return acc + separator + value2;
   }, "");
 }
-var import_path20;
+var import_path21;
 var init_validateSchema = __esm({
   "../configuration-loader/lib/commons/validateSchema.js"() {
     "use strict";
     init_lib4();
     init_lib6();
-    import_path20 = __toESM(require("path"), 1);
+    import_path21 = __toESM(require("path"), 1);
   }
 });
 
@@ -200289,7 +200364,7 @@ async function convertDependenciesConfiguration({ absolutePathToWorkspace, rawDe
   const dependencies = {};
   for (const [coordinate, versionOrPath] of Object.entries(rawDependenciesConfiguration.dependencies)) {
     if (isPath(versionOrPath)) {
-      const pathToApi = AbsoluteFilePath2.of(import_path21.default.join(absolutePathToWorkspace, versionOrPath));
+      const pathToApi = AbsoluteFilePath2.of(import_path22.default.join(absolutePathToWorkspace, versionOrPath));
       if (await doesPathExist(pathToApi)) {
         dependencies[coordinate] = {
           type: "local",
@@ -200330,13 +200405,13 @@ async function convertDependenciesConfiguration({ absolutePathToWorkspace, rawDe
 function isPath(value2) {
   return RELATIVE_PATH_UP_ONE_DIRECTORY_PATTERN.test(value2);
 }
-var import_path21, EMPTY_DEPENDENCIES_CONFIGURATION, RELATIVE_PATH_UP_ONE_DIRECTORY_PATTERN;
+var import_path22, EMPTY_DEPENDENCIES_CONFIGURATION, RELATIVE_PATH_UP_ONE_DIRECTORY_PATTERN;
 var init_convertDependenciesConfiguration = __esm({
   "../configuration-loader/lib/dependencies-yml/convertDependenciesConfiguration.js"() {
     "use strict";
     init_lib8();
     init_lib6();
-    import_path21 = __toESM(require("path"), 1);
+    import_path22 = __toESM(require("path"), 1);
     EMPTY_DEPENDENCIES_CONFIGURATION = {
       dependencies: {}
     };
@@ -236019,7 +236094,7 @@ async function materializeGitRef({ ref: ref2, absolutePathToFernFolder, context:
     return { ...cached2, ref: ref2 };
   }
   await runGit({ args: ["worktree", "prune"], cwd: repoRoot, context: context3 });
-  const tmpDir = await import_tmp_promise3.default.dir({ unsafeCleanup: true });
+  const tmpDir = await import_tmp_promise4.default.dir({ unsafeCleanup: true });
   const worktreePath = AbsoluteFilePath2.of(tmpDir.path);
   const addResult = await runGit({
     args: ["worktree", "add", "--detach", "--force", worktreePath, sha],
@@ -236048,7 +236123,7 @@ async function materializeGitRef({ ref: ref2, absolutePathToFernFolder, context:
   materializedRefsBySha.set(cacheKey, materialized);
   return materialized;
 }
-var import_tmp_promise3, materializedRefsBySha;
+var import_tmp_promise4, materializedRefsBySha;
 var init_materializeGitRef = __esm({
   "../configuration-loader/lib/docs-yml/git-versions/materializeGitRef.js"() {
     "use strict";
@@ -236056,8 +236131,8 @@ var init_materializeGitRef = __esm({
     init_lib8();
     init_lib18();
     init_lib6();
-    import_tmp_promise3 = __toESM(require_tmp_promise(), 1);
-    import_tmp_promise3.default.setGracefulCleanup();
+    import_tmp_promise4 = __toESM(require_tmp_promise(), 1);
+    import_tmp_promise4.default.setGracefulCleanup();
     materializedRefsBySha = /* @__PURE__ */ new Map();
   }
 });
@@ -237860,7 +237935,7 @@ async function expandFolderConfiguration({ rawConfig, absolutePathToFernFolder,
   });
   const indexPage = contents.find((item) => item.type === "page" && (item.slug === "index" || item.absolutePath.toLowerCase().endsWith("/index.mdx") || item.absolutePath.toLowerCase().endsWith("/index.md")));
   const filteredContents = indexPage ? contents.filter((item) => item !== indexPage) : contents;
-  const folderName = import_path22.default.basename(folderPath);
+  const folderName = import_path23.default.basename(folderPath);
   const indexFrontmatterTitle = effectiveTitleSource === "frontmatter" && indexPage?.type === "page" ? (await getFrontmatterMetadata({ absolutePath: indexPage.absolutePath })).title : void 0;
   const title2 = rawConfig.title ?? indexFrontmatterTitle ?? nameToTitle({ name: folderName });
   const slug = rawConfig.slug ?? nameToSlug({ name: folderName });
@@ -238405,14 +238480,14 @@ async function loadTranslationPages({ translations, defaultLocale, pages, absolu
   if (translations == null || translations.length === 0) {
     return void 0;
   }
-  const translationsRootDir = import_path22.default.join(absolutePathToFernFolder, "translations");
+  const translationsRootDir = import_path23.default.join(absolutePathToFernFolder, "translations");
   const result = {};
   const normalizedTranslations = translations.map((t3) => docs_yml_exports.DocsYmlSchemas.normalizeTranslationConfig(t3));
   await Promise.all(normalizedTranslations.map(async ({ lang }) => {
     if (lang === defaultLocale) {
       return;
     }
-    const langDir = import_path22.default.join(translationsRootDir, lang);
+    const langDir = import_path23.default.join(translationsRootDir, lang);
     if (!await doesPathExist(langDir)) {
       context3.failAndThrow(`Translation directory for locale "${lang}" not found.
 Expected a directory at: ${langDir}
@@ -238425,7 +238500,7 @@ version at "translations/${lang}/pages/getting-started.mdx".`, void 0, { code: C
     const localePages = {};
     const missingFiles = [];
     await Promise.all(Object.keys(pages).map(async (relativeFilePath) => {
-      const translatedFilePath = import_path22.default.join(langDir, relativeFilePath);
+      const translatedFilePath = import_path23.default.join(langDir, relativeFilePath);
       if (await doesPathExist(translatedFilePath)) {
         localePages[relativeFilePath] = await (0, import_promises15.readFile)(translatedFilePath, "utf-8");
       } else {
@@ -238445,7 +238520,7 @@ async function loadTranslationNavigationOverlays({ translations, defaultLocale,
   if (translations == null || translations.length === 0) {
     return void 0;
   }
-  const translationsRootDir = import_path22.default.join(absolutePathToFernFolder, "translations");
+  const translationsRootDir = import_path23.default.join(absolutePathToFernFolder, "translations");
   const result = {};
   const normalizedTranslations = translations.map((t3) => docs_yml_exports.DocsYmlSchemas.normalizeTranslationConfig(t3));
   await Promise.all(normalizedTranslations.map(async ({ lang }) => {
@@ -238483,13 +238558,13 @@ async function loadTranslationNavigationOverlays({ translations, defaultLocale,
   return result;
 }
 async function resolveTranslationOverlayDocsYml({ translationsRootDir, lang }) {
-  const langDir = import_path22.default.join(translationsRootDir, lang);
-  const directDocsYmlPath = import_path22.default.join(langDir, "docs.yml");
+  const langDir = import_path23.default.join(translationsRootDir, lang);
+  const directDocsYmlPath = import_path23.default.join(langDir, "docs.yml");
   if (await doesPathExist(directDocsYmlPath)) {
     return { overlayDocsYmlPath: directDocsYmlPath, overlayDir: langDir };
   }
-  const legacyFernDir = import_path22.default.join(langDir, "fern");
-  const legacyDocsYmlPath = import_path22.default.join(legacyFernDir, "docs.yml");
+  const legacyFernDir = import_path23.default.join(langDir, "fern");
+  const legacyDocsYmlPath = import_path23.default.join(legacyFernDir, "docs.yml");
   if (await doesPathExist(legacyDocsYmlPath)) {
     return { overlayDocsYmlPath: legacyDocsYmlPath, overlayDir: legacyFernDir };
   }
@@ -238633,7 +238708,7 @@ async function parseVersionOverlay({ versionObj, overlayDir, context: context3 }
   return versionOverlay;
 }
 async function loadNavOverlayFile({ relativeNavPath, overlayDir, overlayKind, context: context3 }) {
-  const resolvedNavFilePath = import_path22.default.resolve(overlayDir, relativeNavPath);
+  const resolvedNavFilePath = import_path23.default.resolve(overlayDir, relativeNavPath);
   if (!resolvedNavFilePath.startsWith(overlayDir)) {
     context3.logger.warn(`Invalid path in ${overlayKind} overlay: "${relativeNavPath}" escapes the translations directory. Skipping.`);
     return void 0;
@@ -238723,7 +238798,7 @@ function parseVariantOverlays(variants) {
   }
   return result;
 }
-var import_promises15, import_path22, DEFAULT_CHANGELOG_TITLE;
+var import_promises15, import_path23, DEFAULT_CHANGELOG_TITLE;
 var init_parseDocsConfiguration = __esm({
   "../configuration-loader/lib/docs-yml/parseDocsConfiguration.js"() {
     "use strict";
@@ -238734,7 +238809,7 @@ var init_parseDocsConfiguration = __esm({
     init_lib6();
     import_promises15 = require("fs/promises");
     init_js_yaml();
-    import_path22 = __toESM(require("path"), 1);
+    import_path23 = __toESM(require("path"), 1);
     init_convertColorsConfiguration();
     init_getAllPages();
     init_getVersionContentRef();
@@ -264278,7 +264353,8 @@ function parseOpenApiDefinitionSettingsSchema(settings) {
     shouldInferDiscriminatedUnionBaseProperties: settings?.["infer-discriminated-union-base-properties"],
     disambiguateRequestNames: settings?.["disambiguate-request-names"],
     ignoreTags: settings?.["ignore-tags"],
-    respectParameterContent: settings?.["respect-parameter-content"]
+    respectParameterContent: settings?.["respect-parameter-content"],
+    respectPerSpecBasePath: settings?.["respect-per-spec-base-path"]
   };
 }
 function parseAsyncApiDefinitionSettingsSchema(settings) {
@@ -264912,7 +264988,7 @@ async function getGithubLicense({ absolutePathToGeneratorsConfiguration, githubL
         assertNever(githubLicense);
     }
   }
-  const absolutePathToLicense = join8(AbsoluteFilePath2.of(import_path23.default.dirname(absolutePathToGeneratorsConfiguration)), RelativeFilePath2.of(githubLicense.custom));
+  const absolutePathToLicense = join8(AbsoluteFilePath2.of(import_path24.default.dirname(absolutePathToGeneratorsConfiguration)), RelativeFilePath2.of(githubLicense.custom));
   const licenseContent = await (0, import_promises17.readFile)(absolutePathToLicense);
   return api_exports4.GithubLicense.custom({
     contents: licenseContent.toString()
@@ -265093,7 +265169,7 @@ function isGithubSelfhosted(github) {
   }
   return "uri" in github && "token" in github;
 }
-var import_promises17, import_path23, UNDEFINED_API_DEFINITION_SETTINGS;
+var import_promises17, import_path24, UNDEFINED_API_DEFINITION_SETTINGS;
 var init_convertGeneratorsConfiguration = __esm({
   "../configuration-loader/lib/generators-yml/convertGeneratorsConfiguration.js"() {
     "use strict";
@@ -265104,7 +265180,7 @@ var init_convertGeneratorsConfiguration = __esm({
     init_lib6();
     init_esm18();
     import_promises17 = require("fs/promises");
-    import_path23 = __toESM(require("path"), 1);
+    import_path24 = __toESM(require("path"), 1);
     init_getGeneratorName();
     UNDEFINED_API_DEFINITION_SETTINGS = {
       shouldUseTitleAsName: void 0,
@@ -265146,7 +265222,8 @@ var init_convertGeneratorsConfiguration = __esm({
       shouldInferDiscriminatedUnionBaseProperties: void 0,
       disambiguateRequestNames: void 0,
       ignoreTags: void 0,
-      respectParameterContent: void 0
+      respectParameterContent: void 0,
+      respectPerSpecBasePath: void 0
     };
   }
 });
@@ -265177,7 +265254,7 @@ async function loadRawGeneratorsConfiguration({ absolutePathToWorkspace, context
     });
   } catch (e2) {
     if (e2 instanceof index_vite_proxy_tmp_default.YAMLException) {
-      const relativePath = import_path24.default.relative(process.cwd(), filepath);
+      const relativePath = import_path25.default.relative(process.cwd(), filepath);
       let errorMessage = `Failed to parse ${relativePath}: ${e2.reason}`;
       if (e2.mark != null) {
         errorMessage += `
@@ -265233,7 +265310,7 @@ async function getPathToGeneratorsConfiguration({ absolutePathToWorkspace }) {
   }
   return void 0;
 }
-var import_promises18, import_path24;
+var import_promises18, import_path25;
 var init_loadGeneratorsConfiguration = __esm({
   "../configuration-loader/lib/generators-yml/loadGeneratorsConfiguration.js"() {
     "use strict";
@@ -265242,7 +265319,7 @@ var init_loadGeneratorsConfiguration = __esm({
     init_lib6();
     import_promises18 = require("fs/promises");
     init_js_yaml();
-    import_path24 = __toESM(require("path"), 1);
+    import_path25 = __toESM(require("path"), 1);
     init_convertGeneratorsConfiguration();
   }
 });
@@ -318174,7 +318251,7 @@ function setProxy(options2, configProxy, location2, isRedirect) {
     setProxy(redirectOptions, configProxy, redirectOptions.href, true);
   };
 }
-var import_http5, import_https2, import_http22, import_util16, import_path27, import_follow_redirects, import_zlib2, import_stream6, import_events, zlibOptions, brotliOptions, isBrotliSupported, httpFollow, httpsFollow, isHttps, FORM_DATA_CONTENT_HEADERS, kAxiosSocketListener, kAxiosCurrentReq, supportedProtocols, decodeURIComponentSafe, flushOnFinish, Http2Sessions, http2Sessions, isHttpAdapterSupported, wrapAsync, resolveFamily, buildAddressEntry, http2Transport, http_default;
+var import_http5, import_https2, import_http22, import_util16, import_path28, import_follow_redirects, import_zlib2, import_stream6, import_events, zlibOptions, brotliOptions, isBrotliSupported, httpFollow, httpsFollow, isHttps, FORM_DATA_CONTENT_HEADERS, kAxiosSocketListener, kAxiosCurrentReq, supportedProtocols, decodeURIComponentSafe, flushOnFinish, Http2Sessions, http2Sessions, isHttpAdapterSupported, wrapAsync, resolveFamily, buildAddressEntry, http2Transport, http_default;
 var init_http5 = __esm({
   "../../../node_modules/.pnpm/axios@1.16.0/node_modules/axios/lib/adapters/http.js"() {
     "use strict";
@@ -318187,7 +318264,7 @@ var init_http5 = __esm({
     import_https2 = __toESM(require("https"), 1);
     import_http22 = __toESM(require("http2"), 1);
     import_util16 = __toESM(require("util"), 1);
-    import_path27 = require("path");
+    import_path28 = require("path");
     import_follow_redirects = __toESM(require_follow_redirects(), 1);
     import_zlib2 = __toESM(require("zlib"), 1);
     init_data();
@@ -318665,9 +318742,9 @@ var init_http5 = __esm({
           }
           if (config5.allowedSocketPaths != null) {
             const allowed = Array.isArray(config5.allowedSocketPaths) ? config5.allowedSocketPaths : [config5.allowedSocketPaths];
-            const resolvedSocket = (0, import_path27.resolve)(config5.socketPath);
+            const resolvedSocket = (0, import_path28.resolve)(config5.socketPath);
             const isAllowed = allowed.some(
-              (entry) => typeof entry === "string" && (0, import_path27.resolve)(entry) === resolvedSocket
+              (entry) => typeof entry === "string" && (0, import_path28.resolve)(entry) === resolvedSocket
             );
             if (!isAllowed) {
               return reject(
@@ -320588,7 +320665,7 @@ function Un(s5, t3) {
 function Hn(s5, t3) {
   s5.head = new de2(t3, void 0, s5.head, s5), s5.tail || (s5.tail = s5.head), s5.length++;
 }
-var import_events2, import_fs13, import_node_events6, import_node_stream3, import_node_string_decoder2, import_node_path9, import_node_fs6, import_path28, import_events3, import_assert5, import_buffer, Ms, import_zlib3, import_node_path10, import_node_path11, import_fs14, import_fs15, import_path29, import_node_path12, import_path30, import_node_fs7, import_node_assert, import_node_crypto5, import_node_fs8, import_node_path13, import_fs16, import_node_fs9, import_node_path14, import_node_fs10, import_promises21, import_node_path15, import_node_path16, import_node_fs11, import_node_path17, Mr, Br, xs, zr, Ur, Hr, q3, Q3, rt2, Le2, qt2, Ne2, Ls, De2, Ns, z4, Mt2, g2, Qt2, Bt2, b3, D3, _3, gi, Ae2, L4, w2, bi, _i, Ds, Oi, Z3, Ti, Ie2, Jt2, Rt2, F4, jt2, Wr, Gr, Zr, Yr, Fe2, xi, Kr, Vr, A3, Xr, ot2, H4, te2, m2, Ni, j4, Di, Ci, ki, ie2, Ce2, Ut2, Ht2, Ai, Pt2, ht2, U4, nt2, Y3, zt2, Ii, J3, ee3, Fi, ke2, gt2, ve2, bt2, _t2, Me2, tt2, Wt2, qr2, Is, Fs, Cs, ks, vs, Qr, se2, K3, jr, M4, tn, Bs, en, Mi, Tt2, Gt2, Bi, re3, Be2, Pe2, ze2, Ue2, He2, We2, Ge2, Ze2, Ye2, Ps, rn, nn, zs, on, hn, Us, Hs, Ui, ne3, ln, zi, oe2, Ke2, C4, cn, xt2, Hi, fn, at2, dn, un, mn, lt2, pn, En, wn, Wi, Sn, Lt2, ct2, Rn, gn, bn, _n, f2, Ve2, Nt2, Tn, Vi, $i, xn, B3, Dt2, et2, Gi, Ws, V3, he2, ft2, Gs, p3, it2, dt2, Zi, At2, y3, $e2, Xe2, Yi, Zs, Ys, ae2, Ki, qe2, Yt2, ut2, Qe2, It2, Je2, je2, Ks, Ln, st2, mt2, An, Xi, In, Fn, Ft2, qi, kn, Vs, le2, ti, Qi, vn, Mn, Ji, $s, er2, Bn, Qs, Js, js, ts, tr2, ce2, ei, es, ii, is, ss, rs, ns, pt2, si, os4, ji, X3, fe2, ri, ni, Pn, oi, de2, mi, ir2, ai, ue2, W4, me2, Et2, Ct2, pe2, hi, G5, hs, li, sr2, cs, fs4, ci, fi, rr2, as, di, or2, ls, wt2, kt2, Wn, Gn, ar2, lr2, Zn, Yn, Kn, Vn, ur2, mr2, cr2, pr2, Er, wr2, $n, Xn, qn, fr2, ds, us, pi, Qn, ms, Jn, ps, we2, St2, to, Sr2, Es, yr2, eo, Rr2, ws, gr2, Vt2, br2, io, so, ro, Si, Or, Tr2, gs, xr, bs, P4, _s, Os, Ri, Lr, Nr, ye2, Dr, Ar, Ss, yt2, O4, yi, Ir, $t2, ys, Rs, Ts, Re2, ge2, be2, _e2, oo, Oe2, ho, ao, lo, Fr, Xt2, Se2, Te2, co, fo, uo, mo, po, Eo, wo, So, vt2, yo, Ro;
+var import_events2, import_fs13, import_node_events6, import_node_stream3, import_node_string_decoder2, import_node_path9, import_node_fs6, import_path29, import_events3, import_assert5, import_buffer, Ms, import_zlib3, import_node_path10, import_node_path11, import_fs14, import_fs15, import_path30, import_node_path12, import_path31, import_node_fs7, import_node_assert, import_node_crypto5, import_node_fs8, import_node_path13, import_fs16, import_node_fs9, import_node_path14, import_node_fs10, import_promises21, import_node_path15, import_node_path16, import_node_fs11, import_node_path17, Mr, Br, xs, zr, Ur, Hr, q3, Q3, rt2, Le2, qt2, Ne2, Ls, De2, Ns, z4, Mt2, g2, Qt2, Bt2, b3, D3, _3, gi, Ae2, L4, w2, bi, _i, Ds, Oi, Z3, Ti, Ie2, Jt2, Rt2, F4, jt2, Wr, Gr, Zr, Yr, Fe2, xi, Kr, Vr, A3, Xr, ot2, H4, te2, m2, Ni, j4, Di, Ci, ki, ie2, Ce2, Ut2, Ht2, Ai, Pt2, ht2, U4, nt2, Y3, zt2, Ii, J3, ee3, Fi, ke2, gt2, ve2, bt2, _t2, Me2, tt2, Wt2, qr2, Is, Fs, Cs, ks, vs, Qr, se2, K3, jr, M4, tn, Bs, en, Mi, Tt2, Gt2, Bi, re3, Be2, Pe2, ze2, Ue2, He2, We2, Ge2, Ze2, Ye2, Ps, rn, nn, zs, on, hn, Us, Hs, Ui, ne3, ln, zi, oe2, Ke2, C4, cn, xt2, Hi, fn, at2, dn, un, mn, lt2, pn, En, wn, Wi, Sn, Lt2, ct2, Rn, gn, bn, _n, f2, Ve2, Nt2, Tn, Vi, $i, xn, B3, Dt2, et2, Gi, Ws, V3, he2, ft2, Gs, p3, it2, dt2, Zi, At2, y3, $e2, Xe2, Yi, Zs, Ys, ae2, Ki, qe2, Yt2, ut2, Qe2, It2, Je2, je2, Ks, Ln, st2, mt2, An, Xi, In, Fn, Ft2, qi, kn, Vs, le2, ti, Qi, vn, Mn, Ji, $s, er2, Bn, Qs, Js, js, ts, tr2, ce2, ei, es, ii, is, ss, rs, ns, pt2, si, os4, ji, X3, fe2, ri, ni, Pn, oi, de2, mi, ir2, ai, ue2, W4, me2, Et2, Ct2, pe2, hi, G5, hs, li, sr2, cs, fs4, ci, fi, rr2, as, di, or2, ls, wt2, kt2, Wn, Gn, ar2, lr2, Zn, Yn, Kn, Vn, ur2, mr2, cr2, pr2, Er, wr2, $n, Xn, qn, fr2, ds, us, pi, Qn, ms, Jn, ps, we2, St2, to, Sr2, Es, yr2, eo, Rr2, ws, gr2, Vt2, br2, io, so, ro, Si, Or, Tr2, gs, xr, bs, P4, _s, Os, Ri, Lr, Nr, ye2, Dr, Ar, Ss, yt2, O4, yi, Ir, $t2, ys, Rs, Ts, Re2, ge2, be2, _e2, oo, Oe2, ho, ao, lo, Fr, Xt2, Se2, Te2, co, fo, uo, mo, po, Eo, wo, So, vt2, yo, Ro;
 var init_index_min2 = __esm({
   "../../../node_modules/.pnpm/tar@7.5.16/node_modules/tar/dist/esm/index.min.js"() {
     "use strict";
@@ -320599,7 +320676,7 @@ var init_index_min2 = __esm({
     import_node_string_decoder2 = require("string_decoder");
     import_node_path9 = __toESM(require("path"), 1);
     import_node_fs6 = __toESM(require("fs"), 1);
-    import_path28 = require("path");
+    import_path29 = require("path");
     import_events3 = require("events");
     import_assert5 = __toESM(require("assert"), 1);
     import_buffer = require("buffer");
@@ -320609,9 +320686,9 @@ var init_index_min2 = __esm({
     import_node_path11 = require("path");
     import_fs14 = __toESM(require("fs"), 1);
     import_fs15 = __toESM(require("fs"), 1);
-    import_path29 = __toESM(require("path"), 1);
-    import_node_path12 = require("path");
     import_path30 = __toESM(require("path"), 1);
+    import_node_path12 = require("path");
+    import_path31 = __toESM(require("path"), 1);
     import_node_fs7 = __toESM(require("fs"), 1);
     import_node_assert = __toESM(require("assert"), 1);
     import_node_crypto5 = require("crypto");
@@ -321931,11 +322008,11 @@ var init_index_min2 = __esm({
     };
     Xi = (s5, t3) => {
       let e2 = new Map(t3.map((n2) => [mt2(n2), true])), i5 = s5.filter, r4 = (n2, o3 = "") => {
-        let a3 = o3 || (0, import_path28.parse)(n2).root || ".", h4;
+        let a3 = o3 || (0, import_path29.parse)(n2).root || ".", h4;
         if (n2 === a3) h4 = false;
         else {
           let l2 = e2.get(n2);
-          h4 = l2 !== void 0 ? l2 : r4((0, import_path28.dirname)(n2), a3);
+          h4 = l2 !== void 0 ? l2 : r4((0, import_path29.dirname)(n2), a3);
         }
         return e2.set(n2, h4), h4;
       };
@@ -322055,7 +322132,7 @@ var init_index_min2 = __esm({
           let [o3, a3] = le2(this.path);
           o3 && typeof a3 == "string" && (this.path = a3, r4 = o3);
         }
-        this.win32 = !!i5.win32 || process.platform === "win32", this.win32 && (this.path = $s(this.path.replaceAll(/\\/g, "/")), t3 = t3.replaceAll(/\\/g, "/")), this.absolute = f2(i5.absolute || import_path29.default.resolve(this.cwd, t3)), this.path === "" && (this.path = "./"), r4 && this.warn("TAR_ENTRY_INFO", `stripping ${r4} from absolute path`, { entry: this, path: r4 + this.path });
+        this.win32 = !!i5.win32 || process.platform === "win32", this.win32 && (this.path = $s(this.path.replaceAll(/\\/g, "/")), t3 = t3.replaceAll(/\\/g, "/")), this.absolute = f2(i5.absolute || import_path30.default.resolve(this.cwd, t3)), this.path === "" && (this.path = "./"), r4 && this.warn("TAR_ENTRY_INFO", `stripping ${r4} from absolute path`, { entry: this, path: r4 + this.path });
         let n2 = this.statCache.get(this.absolute);
         n2 ? this[ii](n2) : this[es]();
       }
@@ -322114,7 +322191,7 @@ var init_index_min2 = __esm({
       }
       [tr2](t3) {
         if (!this.stat) throw new Error("cannot create link entry without stat");
-        this.type = "Link", this.linkpath = f2(import_path29.default.relative(this.cwd, t3)), this.stat.size = 0, this[ce2](), this.end();
+        this.type = "Link", this.linkpath = f2(import_path30.default.relative(this.cwd, t3)), this.stat.size = 0, this[ce2](), this.end();
       }
       [Js]() {
         if (!this.stat) throw new Error("cannot create file entry without stat");
@@ -322518,7 +322595,7 @@ var init_index_min2 = __esm({
         return typeof t3 == "string" ? this[li](t3) : this[sr2](t3), this.flowing;
       }
       [sr2](t3) {
-        let e2 = f2(import_path30.default.resolve(this.cwd, t3.path));
+        let e2 = f2(import_path31.default.resolve(this.cwd, t3.path));
         if (!this.filter(t3.path, t3)) t3.resume();
         else {
           let i5 = new mi(t3.path, e2);
@@ -322527,7 +322604,7 @@ var init_index_min2 = __esm({
         this[Ct2]();
       }
       [li](t3) {
-        let e2 = f2(import_path30.default.resolve(this.cwd, t3));
+        let e2 = f2(import_path31.default.resolve(this.cwd, t3));
         this[W4].push(new mi(t3, e2)), this[Ct2]();
       }
       [cs](t3) {
@@ -323682,8 +323759,8 @@ async function downloadDependency({ s3PreSignedReadUrl, absolutePathToLocalOutpu
   const request7 = await axios_default.get(s3PreSignedReadUrl, {
     responseType: "stream"
   });
-  const tmpDir = await import_tmp_promise4.default.dir();
-  const outputTarPath = import_path31.default.join(tmpDir.path, "api.tgz");
+  const tmpDir = await import_tmp_promise5.default.dir();
+  const outputTarPath = import_path32.default.join(tmpDir.path, "api.tgz");
   await (0, import_promises23.pipeline)(request7.data, (0, import_fs17.createWriteStream)(outputTarPath));
   await uo({ file: outputTarPath, cwd: absolutePathToLocalOutput });
 }
@@ -323697,7 +323774,7 @@ function stringifyDependency(dependency) {
       assertNever(dependency);
   }
 }
-var import_fs17, import_promises22, import_os, import_path31, import_promises23, import_tmp_promise4, FIDDLE, DEPENDENCIES_FOLDER_NAME, METADATA_RESPONSE_FILENAME, LOCAL_STORAGE_FOLDER;
+var import_fs17, import_promises22, import_os, import_path32, import_promises23, import_tmp_promise5, FIDDLE, DEPENDENCIES_FOLDER_NAME, METADATA_RESPONSE_FILENAME, LOCAL_STORAGE_FOLDER;
 var init_loadDependency = __esm({
   "../workspace/lazy-fern-workspace/lib/utils/loadDependency.js"() {
     "use strict";
@@ -323712,10 +323789,10 @@ var init_loadDependency = __esm({
     import_fs17 = require("fs");
     import_promises22 = require("fs/promises");
     import_os = require("os");
-    import_path31 = __toESM(require("path"), 1);
+    import_path32 = __toESM(require("path"), 1);
     import_promises23 = require("stream/promises");
     init_index_min2();
-    import_tmp_promise4 = __toESM(require_tmp_promise(), 1);
+    import_tmp_promise5 = __toESM(require_tmp_promise(), 1);
     init_Result();
     FIDDLE = createFiddleService();
     DEPENDENCIES_FOLDER_NAME = "dependencies";
@@ -335317,7 +335394,7 @@ function validateStructureOfYamlFiles({ files, absolutePathToDefinition, skipVal
           addFailure(result);
         }
       }
-    } else if (import_path32.default.basename(relativeFilepath) === FERN_PACKAGE_MARKER_FILENAME) {
+    } else if (import_path33.default.basename(relativeFilepath) === FERN_PACKAGE_MARKER_FILENAME) {
       const cached2 = packageMarkerParsedCache.get(file4.rawContents);
       if (cached2 != null && (cached2.validated || skipValidation)) {
         packageMarkers[relativeFilepath] = {
@@ -335407,7 +335484,7 @@ function validateStructureOfYamlFiles({ files, absolutePathToDefinition, skipVal
     };
   }
 }
-var import_path32, rootApiParsedCache, definitionParsedCache, packageMarkerParsedCache;
+var import_path33, rootApiParsedCache, definitionParsedCache, packageMarkerParsedCache;
 var init_validateStructureOfYamlFiles = __esm({
   "../workspace/lazy-fern-workspace/lib/utils/validateStructureOfYamlFiles.js"() {
     "use strict";
@@ -335415,7 +335492,7 @@ var init_validateStructureOfYamlFiles = __esm({
     init_lib4();
     init_lib10();
     init_lib8();
-    import_path32 = __toESM(require("path"), 1);
+    import_path33 = __toESM(require("path"), 1);
     init_api_yml_schema();
     init_fern_schema();
     init_package_yml_schema();
@@ -345532,7 +345609,7 @@ function parseExternalRef(ref2, baseDir) {
   const hashIndex = ref2.indexOf("#");
   const filePath = hashIndex >= 0 ? ref2.slice(0, hashIndex) : ref2;
   const jsonPointer = hashIndex >= 0 ? ref2.slice(hashIndex + 1) : "";
-  const absolutePath = (0, import_path33.resolve)(baseDir, filePath);
+  const absolutePath = (0, import_path34.resolve)(baseDir, filePath);
   return { filePath, jsonPointer, absolutePath };
 }
 function isExternalRefValue(value2) {
@@ -345622,7 +345699,7 @@ async function resolveExternalRefs(obj, baseDir, mainFileAbsPath, registry2, app
     newVisited.add(cacheKey);
     const fileContent = await readAndParseFile(sourceFileAbsPath, fileCache);
     const parsed = navigateJsonPointer(fileContent, pointer2, sourceFileAbsPath);
-    const refDir = (0, import_path33.dirname)(sourceFileAbsPath);
+    const refDir = (0, import_path34.dirname)(sourceFileAbsPath);
     const resolved = await resolveExternalRefs(parsed, refDir, mainFileAbsPath, registry2, true, newVisited, fileCache, sourceFileAbsPath);
     return mergeWithSiblings(resolved, siblingProperties, hasSiblings);
   }
@@ -345646,7 +345723,7 @@ async function resolveExternalRefs(obj, baseDir, mainFileAbsPath, registry2, app
     newVisited.add(cacheKey);
     const fileContent = await readAndParseFile(absoluteRefPath, fileCache);
     const parsed = navigateJsonPointer(fileContent, jsonPointer, absoluteRefPath);
-    const refDir = (0, import_path33.dirname)(absoluteRefPath);
+    const refDir = (0, import_path34.dirname)(absoluteRefPath);
     const resolved = await resolveExternalRefs(parsed, refDir, mainFileAbsPath, registry2, true, newVisited, fileCache, absoluteRefPath);
     return mergeWithSiblings(resolved, siblingProperties, hasSiblings);
   }
@@ -345656,14 +345733,14 @@ async function resolveExternalRefs(obj, baseDir, mainFileAbsPath, registry2, app
   }
   return result;
 }
-var import_promises25, import_path33;
+var import_promises25, import_path34;
 var init_resolveExternalRefs = __esm({
   "../workspace/lazy-fern-workspace/lib/utils/resolveExternalRefs.js"() {
     "use strict";
     init_lib6();
     import_promises25 = require("fs/promises");
     init_js_yaml();
-    import_path33 = require("path");
+    import_path34 = require("path");
   }
 });
 
@@ -345671,7 +345748,7 @@ var init_resolveExternalRefs = __esm({
 async function loadAsyncAPI({ context: context3, absoluteFilePath, absoluteFilePathToOverrides }) {
   const contents = (await (0, import_promises26.readFile)(absoluteFilePath)).toString();
   const parsed = await index_vite_proxy_tmp_default.load(contents);
-  const baseDir = (0, import_path34.dirname)(absoluteFilePath);
+  const baseDir = (0, import_path35.dirname)(absoluteFilePath);
   const registry2 = buildExternalRefRegistry(parsed, baseDir);
   const bundled = await resolveExternalRefs(parsed, baseDir, absoluteFilePath, registry2);
   let overridesFilepaths = [];
@@ -345692,13 +345769,13 @@ async function loadAsyncAPI({ context: context3, absoluteFilePath, absoluteFileP
   }
   return result;
 }
-var import_promises26, import_path34;
+var import_promises26, import_path35;
 var init_loadAsyncAPI = __esm({
   "../workspace/lazy-fern-workspace/lib/utils/loadAsyncAPI.js"() {
     "use strict";
     import_promises26 = require("fs/promises");
     init_js_yaml();
-    import_path34 = require("path");
+    import_path35 = require("path");
     init_mergeWithOverrides2();
     init_resolveExternalRefs();
   }
@@ -345707,7 +345784,7 @@ var init_loadAsyncAPI = __esm({
 // ../workspace/lazy-fern-workspace/lib/loaders/applyOverlays.js
 async function getTempDir() {
   if (tempDir === void 0) {
-    const dir = await import_tmp_promise5.default.dir({ prefix: "fern-overlay-" });
+    const dir = await import_tmp_promise6.default.dir({ prefix: "fern-overlay-" });
     tempDir = dir.path;
   }
   return tempDir;
@@ -345723,9 +345800,9 @@ async function applyOverlays({ absoluteFilePathToOverlay, absoluteFilePathToOpen
     overlay
   });
   const dir = await getTempDir();
-  const originalFileName = import_path35.default.basename(absoluteFilePathToOpenAPI);
-  const outputFileName = `${import_path35.default.parse(originalFileName).name}.overlaid.json`;
-  const outputPath = import_path35.default.join(dir, outputFileName);
+  const originalFileName = import_path36.default.basename(absoluteFilePathToOpenAPI);
+  const outputFileName = `${import_path36.default.parse(originalFileName).name}.overlaid.json`;
+  const outputPath = import_path36.default.join(dir, outputFileName);
   await (0, import_promises27.writeFile)(outputPath, JSON.stringify(result, null, 2), "utf8");
   context3.logger.debug(`Wrote overlaid OpenAPI spec to: ${outputPath}`);
   return result;
@@ -345788,7 +345865,7 @@ function validateOverlay(overlay, context3) {
 function isRecord(value2) {
   return typeof value2 === "object" && value2 != null && !Array.isArray(value2);
 }
-var import_promises27, import_path35, import_tmp_promise5, tempDir;
+var import_promises27, import_path36, import_tmp_promise6, tempDir;
 var init_applyOverlays = __esm({
   "../workspace/lazy-fern-workspace/lib/loaders/applyOverlays.js"() {
     "use strict";
@@ -345796,19 +345873,19 @@ var init_applyOverlays = __esm({
     init_lib6();
     import_promises27 = require("fs/promises");
     init_js_yaml();
-    import_path35 = __toESM(require("path"), 1);
-    import_tmp_promise5 = __toESM(require_tmp_promise(), 1);
+    import_path36 = __toESM(require("path"), 1);
+    import_tmp_promise6 = __toESM(require_tmp_promise(), 1);
   }
 });
 
 // ../workspace/lazy-fern-workspace/lib/loaders/OpenAPIRefResolver.js
-var import_openapi_core2, import_path36, OpenAPIRefResolver;
+var import_openapi_core2, import_path37, OpenAPIRefResolver;
 var init_OpenAPIRefResolver = __esm({
   "../workspace/lazy-fern-workspace/lib/loaders/OpenAPIRefResolver.js"() {
     "use strict";
     init_lib8();
     import_openapi_core2 = __toESM(require_lib2(), 1);
-    import_path36 = __toESM(require("path"), 1);
+    import_path37 = __toESM(require("path"), 1);
     OpenAPIRefResolver = class extends import_openapi_core2.BaseResolver {
       absolutePathToOpenAPIOverrides;
       absolutePathToOpenAPIOverlays;
@@ -345826,13 +345903,13 @@ var init_OpenAPIRefResolver = __esm({
           return result;
         }
         if (this.absolutePathToOpenAPIOverlays != null) {
-          const overlayResolved = import_path36.default.resolve(import_path36.default.dirname(this.absolutePathToOpenAPIOverlays), ref2);
+          const overlayResolved = import_path37.default.resolve(import_path37.default.dirname(this.absolutePathToOpenAPIOverlays), ref2);
           if (doesPathExistSync(AbsoluteFilePath2.of(overlayResolved))) {
             return overlayResolved;
           }
         }
         if (this.absolutePathToOpenAPIOverrides != null) {
-          return import_path36.default.resolve(import_path36.default.dirname(this.absolutePathToOpenAPIOverrides), ref2);
+          return import_path37.default.resolve(import_path37.default.dirname(this.absolutePathToOpenAPIOverrides), ref2);
         }
         return result;
       }
@@ -346124,7 +346201,7 @@ function describeRef(value2) {
   return `target="${ref2}"${siblingSuffix}`;
 }
 async function readMarkdownRef(ref2, baseDir, context3, path122) {
-  const absolutePath = (0, import_path37.resolve)(baseDir, ref2);
+  const absolutePath = (0, import_path38.resolve)(baseDir, ref2);
   try {
     const contents = await (0, import_promises29.readFile)(absolutePath, "utf-8");
     return contents.trimEnd();
@@ -346133,13 +346210,13 @@ async function readMarkdownRef(ref2, baseDir, context3, path122) {
     return "";
   }
 }
-var import_promises29, import_path37, SKIP_METADATA_PARENTS;
+var import_promises29, import_path38, SKIP_METADATA_PARENTS;
 var init_resolveDescriptionMarkdownRefs = __esm({
   "../workspace/lazy-fern-workspace/lib/utils/resolveDescriptionMarkdownRefs.js"() {
     "use strict";
     init_lib4();
     import_promises29 = require("fs/promises");
-    import_path37 = require("path");
+    import_path38 = require("path");
     SKIP_METADATA_PARENTS = /* @__PURE__ */ new Set(["properties", "patternProperties"]);
   }
 });
@@ -356898,7 +356975,7 @@ function maybeResolveSourceReference(source2, baseDir) {
     return source2;
   }
   if (isCodeReference2(source2)) {
-    const resolvedPath = (0, import_path38.resolve)(baseDir ?? process.cwd(), source2.$ref);
+    const resolvedPath = (0, import_path39.resolve)(baseDir ?? process.cwd(), source2.$ref);
     if ((0, import_fs18.existsSync)(resolvedPath)) {
       try {
         const fileContent = (0, import_fs18.readFileSync)(resolvedPath, "utf-8");
@@ -356910,14 +356987,14 @@ function maybeResolveSourceReference(source2, baseDir) {
   }
   return void 0;
 }
-var import_fs18, import_path38, RedoclyCodeSamplesExtension;
+var import_fs18, import_path39, RedoclyCodeSamplesExtension;
 var init_x_code_samples = __esm({
   "../api-importers/openapi-to-ir/lib/extensions/x-code-samples.js"() {
     "use strict";
     init_lib4();
     init_lib30();
     import_fs18 = require("fs");
-    import_path38 = require("path");
+    import_path39 = require("path");
     RedoclyCodeSamplesExtension = class extends AbstractExtension {
       operation;
       baseDir;
@@ -356986,7 +357063,7 @@ function maybeResolveCodeReference2(code5, baseDir) {
     return code5;
   }
   if (isCodeReference3(code5)) {
-    const resolvedPath = (0, import_path39.resolve)(baseDir ?? process.cwd(), code5.$ref);
+    const resolvedPath = (0, import_path40.resolve)(baseDir ?? process.cwd(), code5.$ref);
     if ((0, import_fs19.existsSync)(resolvedPath)) {
       try {
         const fileContent = (0, import_fs19.readFileSync)(resolvedPath, "utf-8");
@@ -357018,7 +357095,7 @@ function resolveCodeSamples2(codeSamples, baseDir) {
   }
   return resolved;
 }
-var import_fs19, import_path39, FernExamplesExtension2;
+var import_fs19, import_path40, FernExamplesExtension2;
 var init_x_fern_examples2 = __esm({
   "../api-importers/openapi-to-ir/lib/extensions/x-fern-examples.js"() {
     "use strict";
@@ -357026,7 +357103,7 @@ var init_x_fern_examples2 = __esm({
     init_lib10();
     init_lib30();
     import_fs19 = require("fs");
-    import_path39 = require("path");
+    import_path40 = require("path");
     FernExamplesExtension2 = class extends AbstractExtension {
       operation;
       baseDir;
@@ -360639,7 +360716,7 @@ function getPlatformInfo() {
 }
 function getCacheDir() {
   const homeDir = import_os2.default.homedir();
-  return AbsoluteFilePath2.of(import_path40.default.join(homeDir, CACHE_DIR_NAME, BIN_DIR_NAME));
+  return AbsoluteFilePath2.of(import_path41.default.join(homeDir, CACHE_DIR_NAME, BIN_DIR_NAME));
 }
 function getVersionedBinaryPath() {
   const { extension: extension4 } = getPlatformInfo();
@@ -360657,7 +360734,7 @@ function getVersionMarkerPath() {
 }
 function getLockDirPath() {
   const cacheDir = getCacheDir();
-  return import_path40.default.join(cacheDir, `${BINARY_NAME}.lock`);
+  return import_path41.default.join(cacheDir, `${BINARY_NAME}.lock`);
 }
 function getDownloadUrl() {
   const { os: osName, arch: arch4, extension: extension4 } = getPlatformInfo();
@@ -360790,7 +360867,7 @@ async function atomicCopyBinary(src, dest) {
   await (0, import_promises34.chmod)(tmpDest, 493);
   await (0, import_promises34.rename)(tmpDest, dest);
 }
-var import_promises34, import_os2, import_path40, BUF_VERSION, GITHUB_RELEASE_URL_BASE, BINARY_NAME, CACHE_DIR_NAME, BIN_DIR_NAME, LOCK_TIMEOUT_MS, LOCK_RETRY_INTERVAL_MS;
+var import_promises34, import_os2, import_path41, BUF_VERSION, GITHUB_RELEASE_URL_BASE, BINARY_NAME, CACHE_DIR_NAME, BIN_DIR_NAME, LOCK_TIMEOUT_MS, LOCK_RETRY_INTERVAL_MS;
 var init_BufDownloader = __esm({
   "../workspace/lazy-fern-workspace/lib/protobuf/BufDownloader.js"() {
     "use strict";
@@ -360798,7 +360875,7 @@ var init_BufDownloader = __esm({
     init_lib6();
     import_promises34 = require("fs/promises");
     import_os2 = __toESM(require("os"), 1);
-    import_path40 = __toESM(require("path"), 1);
+    import_path41 = __toESM(require("path"), 1);
     BUF_VERSION = "v1.50.0";
     GITHUB_RELEASE_URL_BASE = "https://github.com/bufbuild/buf/releases/download";
     BINARY_NAME = "buf";
@@ -360868,7 +360945,7 @@ async function detectAirGappedModeForProtobuf(absoluteFilepathToProtobufRoot, lo
   if (!bufLockExists) {
     return false;
   }
-  const tmpDir = AbsoluteFilePath2.of((await import_tmp_promise6.default.dir()).path);
+  const tmpDir = AbsoluteFilePath2.of((await import_tmp_promise7.default.dir()).path);
   try {
     const bufYamlPath = join8(absoluteFilepathToProtobufRoot, RelativeFilePath2.of("buf.yaml"));
     try {
@@ -360929,7 +361006,7 @@ async function ensureBufCommand(logger4) {
     });
   }
 }
-var import_promises35, import_tmp_promise6, airGapDetectionResult, airGapDetectionPromise, PROTOBUF_GENERATOR_CONFIG_FILENAME, PROTOBUF_GENERATOR_OUTPUT_PATH, PROTOBUF_GENERATOR_OUTPUT_FILEPATH, PROTOBUF_SHELL_PROXY_FILENAME, PROTOBUF_EXPORT_CONFIG_V1, PROTOBUF_EXPORT_CONFIG_V2, getProtobufYamlV1, PROTOBUF_GEN_CONFIG, PROTOBUF_MODULE_PACKAGE_JSON, PROTOBUF_SHELL_PROXY;
+var import_promises35, import_tmp_promise7, airGapDetectionResult, airGapDetectionPromise, PROTOBUF_GENERATOR_CONFIG_FILENAME, PROTOBUF_GENERATOR_OUTPUT_PATH, PROTOBUF_GENERATOR_OUTPUT_FILEPATH, PROTOBUF_SHELL_PROXY_FILENAME, PROTOBUF_EXPORT_CONFIG_V1, PROTOBUF_EXPORT_CONFIG_V2, getProtobufYamlV1, PROTOBUF_GEN_CONFIG, PROTOBUF_MODULE_PACKAGE_JSON, PROTOBUF_SHELL_PROXY;
 var init_utils14 = __esm({
   "../workspace/lazy-fern-workspace/lib/protobuf/utils.js"() {
     "use strict";
@@ -360938,7 +361015,7 @@ var init_utils14 = __esm({
     init_lib18();
     init_lib6();
     import_promises35 = require("fs/promises");
-    import_tmp_promise6 = __toESM(require_tmp_promise(), 1);
+    import_tmp_promise7 = __toESM(require_tmp_promise(), 1);
     init_BufDownloader();
     PROTOBUF_GENERATOR_CONFIG_FILENAME = "buf.gen.yaml";
     PROTOBUF_GENERATOR_OUTPUT_PATH = "output";
@@ -361022,7 +361099,7 @@ async function ensureFernGloballyInstalled(cwd2, logger4) {
   })();
   return fernGlobalInstallPromise;
 }
-var import_promises36, import_path41, import_tmp_promise7, fernGlobalInstallPromise, ProtobufIRGenerator;
+var import_promises36, import_path42, import_tmp_promise8, fernGlobalInstallPromise, ProtobufIRGenerator;
 var init_ProtobufIRGenerator = __esm({
   "../workspace/lazy-fern-workspace/lib/protobuf/ProtobufIRGenerator.js"() {
     "use strict";
@@ -361030,8 +361107,8 @@ var init_ProtobufIRGenerator = __esm({
     init_lib18();
     init_lib6();
     import_promises36 = require("fs/promises");
-    import_path41 = __toESM(require("path"), 1);
-    import_tmp_promise7 = __toESM(require_tmp_promise(), 1);
+    import_path42 = __toESM(require("path"), 1);
+    import_tmp_promise8 = __toESM(require_tmp_promise(), 1);
     init_utils14();
     ProtobufIRGenerator = class {
       context;
@@ -361065,7 +361142,7 @@ var init_ProtobufIRGenerator = __esm({
         });
       }
       async setupProtobufGeneratorConfig({ absoluteFilepathToProtobufRoot, absoluteFilepathToProtobufTarget }) {
-        const protobufGeneratorConfigPath = AbsoluteFilePath2.of((await import_tmp_promise7.default.dir()).path);
+        const protobufGeneratorConfigPath = AbsoluteFilePath2.of((await import_tmp_promise8.default.dir()).path);
         if (absoluteFilepathToProtobufTarget !== void 0) {
           await this.exportProtobufFilesForTarget({
             protobufGeneratorConfigPath,
@@ -361095,7 +361172,7 @@ var init_ProtobufIRGenerator = __esm({
         const bufCommand = this.resolvedBufCommand ?? "buf";
         for (const version7 of ["v1", "v2"]) {
           this.context.logger.info(`Using buf export with version: ${version7}`);
-          const tmpBufConfigFile = await import_tmp_promise7.default.file({ postfix: ".yaml" });
+          const tmpBufConfigFile = await import_tmp_promise8.default.file({ postfix: ".yaml" });
           const configContent = version7 === "v1" ? PROTOBUF_EXPORT_CONFIG_V1 : PROTOBUF_EXPORT_CONFIG_V2;
           await (0, import_promises36.writeFile)(tmpBufConfigFile.path, configContent, "utf8");
           try {
@@ -361129,7 +361206,7 @@ var init_ProtobufIRGenerator = __esm({
         await (0, import_promises36.cp)(absoluteFilepathToProtobufRoot, protobufGeneratorConfigPath, {
           recursive: true,
           filter: (src) => {
-            const basename8 = import_path41.default.basename(src);
+            const basename8 = import_path42.default.basename(src);
             return basename8 !== "buf.yaml" && !(basename8.startsWith("buf.gen.") && basename8.endsWith(".yaml"));
           }
         });
@@ -361243,7 +361320,7 @@ function getPlatformInfo2() {
 }
 function getCacheDir2() {
   const homeDir = import_os3.default.homedir();
-  return AbsoluteFilePath2.of(import_path42.default.join(homeDir, CACHE_DIR_NAME2, BIN_DIR_NAME2));
+  return AbsoluteFilePath2.of(import_path43.default.join(homeDir, CACHE_DIR_NAME2, BIN_DIR_NAME2));
 }
 function getVersionedBinaryPath2() {
   const { extension: extension4 } = getPlatformInfo2();
@@ -361261,7 +361338,7 @@ function getVersionMarkerPath2() {
 }
 function getLockDirPath2() {
   const cacheDir = getCacheDir2();
-  return import_path42.default.join(cacheDir, `${BINARY_NAME2}.lock`);
+  return import_path43.default.join(cacheDir, `${BINARY_NAME2}.lock`);
 }
 function getDownloadUrl2() {
   const { os: osName, arch: arch4, extension: extension4 } = getPlatformInfo2();
@@ -361394,7 +361471,7 @@ async function atomicCopyBinary2(src, dest) {
   await (0, import_promises37.chmod)(tmpDest, 493);
   await (0, import_promises37.rename)(tmpDest, dest);
 }
-var import_promises37, import_os3, import_path42, PROTOC_GEN_OPENAPI_VERSION, GITHUB_RELEASE_URL_BASE2, BINARY_NAME2, CACHE_DIR_NAME2, BIN_DIR_NAME2, LOCK_TIMEOUT_MS2, LOCK_RETRY_INTERVAL_MS2;
+var import_promises37, import_os3, import_path43, PROTOC_GEN_OPENAPI_VERSION, GITHUB_RELEASE_URL_BASE2, BINARY_NAME2, CACHE_DIR_NAME2, BIN_DIR_NAME2, LOCK_TIMEOUT_MS2, LOCK_RETRY_INTERVAL_MS2;
 var init_ProtocGenOpenAPIDownloader = __esm({
   "../workspace/lazy-fern-workspace/lib/protobuf/ProtocGenOpenAPIDownloader.js"() {
     "use strict";
@@ -361402,7 +361479,7 @@ var init_ProtocGenOpenAPIDownloader = __esm({
     init_lib6();
     import_promises37 = require("fs/promises");
     import_os3 = __toESM(require("os"), 1);
-    import_path42 = __toESM(require("path"), 1);
+    import_path43 = __toESM(require("path"), 1);
     PROTOC_GEN_OPENAPI_VERSION = "v0.1.13";
     GITHUB_RELEASE_URL_BASE2 = "https://github.com/fern-api/protoc-gen-openapi/releases/download";
     BINARY_NAME2 = "protoc-gen-openapi";
@@ -361429,7 +361506,7 @@ plugins:
       - source_root=${relativeFilepathToProtobufRoot}
 `;
 }
-var import_promises38, import_path43, import_tmp_promise8, PROTOBUF_GENERATOR_CONFIG_FILENAME2, PROTOBUF_GENERATOR_OUTPUT_PATH2, PROTOBUF_GENERATOR_OUTPUT_FILEPATH2, ProtobufOpenAPIGenerator;
+var import_promises38, import_path44, import_tmp_promise9, PROTOBUF_GENERATOR_CONFIG_FILENAME2, PROTOBUF_GENERATOR_OUTPUT_PATH2, PROTOBUF_GENERATOR_OUTPUT_FILEPATH2, ProtobufOpenAPIGenerator;
 var init_ProtobufOpenAPIGenerator = __esm({
   "../workspace/lazy-fern-workspace/lib/protobuf/ProtobufOpenAPIGenerator.js"() {
     "use strict";
@@ -361437,8 +361514,8 @@ var init_ProtobufOpenAPIGenerator = __esm({
     init_lib18();
     init_lib6();
     import_promises38 = require("fs/promises");
-    import_path43 = __toESM(require("path"), 1);
-    import_tmp_promise8 = __toESM(require_tmp_promise(), 1);
+    import_path44 = __toESM(require("path"), 1);
+    import_tmp_promise9 = __toESM(require_tmp_promise(), 1);
     init_ProtocGenOpenAPIDownloader();
     init_utils14();
     PROTOBUF_GENERATOR_CONFIG_FILENAME2 = "buf.gen.yaml";
@@ -361482,10 +361559,10 @@ var init_ProtobufOpenAPIGenerator = __esm({
         if (deps.length > 0 && this.isAirGapped === void 0) {
           this.isAirGapped = await detectAirGappedModeForProtobuf(absoluteFilepathToProtobufRoot, this.context.logger, this.resolvedBufCommand);
         }
-        const cwd2 = AbsoluteFilePath2.of((await import_tmp_promise8.default.dir()).path);
+        const cwd2 = AbsoluteFilePath2.of((await import_tmp_promise9.default.dir()).path);
         await (0, import_promises38.cp)(absoluteFilepathToProtobufRoot, cwd2, { recursive: true });
         await (0, import_promises38.writeFile)(join8(cwd2, RelativeFilePath2.of(PROTOBUF_GENERATOR_CONFIG_FILENAME2)), getProtobufGeneratorConfig({ relativeFilepathToProtobufRoot }));
-        const envOverride = this.protocGenOpenAPIBinDir != null ? { PATH: `${this.protocGenOpenAPIBinDir}${import_path43.default.delimiter}${process.env.PATH ?? ""}` } : void 0;
+        const envOverride = this.protocGenOpenAPIBinDir != null ? { PATH: `${this.protocGenOpenAPIBinDir}${import_path44.default.delimiter}${process.env.PATH ?? ""}` } : void 0;
         const bufYamlPath = join8(cwd2, RelativeFilePath2.of("buf.yaml"));
         const bufLockPath = join8(cwd2, RelativeFilePath2.of("buf.lock"));
         await (0, import_promises38.writeFile)(bufYamlPath, getProtobufYamlV1(deps));
@@ -361544,7 +361621,7 @@ var init_ProtobufOpenAPIGenerator = __esm({
           });
         }
         const outputPath = join8(preparedDir.cwd, RelativeFilePath2.of(PROTOBUF_GENERATOR_OUTPUT_FILEPATH2));
-        const uniqueOutput = AbsoluteFilePath2.of((await import_tmp_promise8.default.file({ postfix: ".yaml" })).path);
+        const uniqueOutput = AbsoluteFilePath2.of((await import_tmp_promise9.default.file({ postfix: ".yaml" })).path);
         await (0, import_promises38.copyFile)(outputPath, uniqueOutput);
         await (0, import_promises38.unlink)(outputPath);
         return { absoluteFilepath: uniqueOutput };
@@ -361568,7 +361645,7 @@ var init_ProtobufOpenAPIGenerator = __esm({
         });
       }
       async setupProtobufGeneratorConfig({ absoluteFilepathToProtobufRoot, relativeFilepathToProtobufRoot }) {
-        const protobufGeneratorConfigPath = AbsoluteFilePath2.of((await import_tmp_promise8.default.dir()).path);
+        const protobufGeneratorConfigPath = AbsoluteFilePath2.of((await import_tmp_promise9.default.dir()).path);
         await (0, import_promises38.cp)(absoluteFilepathToProtobufRoot, protobufGeneratorConfigPath, { recursive: true });
         await (0, import_promises38.writeFile)(join8(protobufGeneratorConfigPath, RelativeFilePath2.of(PROTOBUF_GENERATOR_CONFIG_FILENAME2)), getProtobufGeneratorConfig({ relativeFilepathToProtobufRoot }));
         return protobufGeneratorConfigPath;
@@ -361579,7 +361656,7 @@ var init_ProtobufOpenAPIGenerator = __esm({
         const bufLockPath = join8(cwd2, RelativeFilePath2.of("buf.lock"));
         let cleanupBufLock = false;
         const configContent = getProtobufYamlV1(deps);
-        const envOverride = this.protocGenOpenAPIBinDir != null ? { PATH: `${this.protocGenOpenAPIBinDir}${import_path43.default.delimiter}${process.env.PATH ?? ""}` } : void 0;
+        const envOverride = this.protocGenOpenAPIBinDir != null ? { PATH: `${this.protocGenOpenAPIBinDir}${import_path44.default.delimiter}${process.env.PATH ?? ""}` } : void 0;
         const bufCommand = this.resolvedBufCommand ?? "buf";
         const buf = createLoggingExecutable(bufCommand, {
           cwd: cwd2,
@@ -424433,7 +424510,7 @@ function tokenizeWwwAutolink(effects, ok3, nok) {
     }
     effects.enter("literalAutolink");
     effects.enter("literalAutolinkWww");
-    return effects.check(wwwPrefix, effects.attempt(domain2, effects.attempt(path47, wwwAfter), nok), nok)(code5);
+    return effects.check(wwwPrefix, effects.attempt(domain2, effects.attempt(path48, wwwAfter), nok), nok)(code5);
   }
   function wwwAfter(code5) {
     effects.exit("literalAutolinkWww");
@@ -424483,7 +424560,7 @@ function tokenizeProtocolAutolink(effects, ok3, nok) {
     return nok(code5);
   }
   function afterProtocol(code5) {
-    return code5 === null || asciiControl(code5) || markdownLineEndingOrSpace(code5) || unicodeWhitespace(code5) || unicodePunctuation(code5) ? nok(code5) : effects.attempt(domain2, effects.attempt(path47, protocolAfter), nok)(code5);
+    return code5 === null || asciiControl(code5) || markdownLineEndingOrSpace(code5) || unicodeWhitespace(code5) || unicodePunctuation(code5) ? nok(code5) : effects.attempt(domain2, effects.attempt(path48, protocolAfter), nok)(code5);
   }
   function protocolAfter(code5) {
     effects.exit("literalAutolinkHttp");
@@ -424659,7 +424736,7 @@ function previousUnbalanced(events) {
   }
   return result;
 }
-var wwwPrefix, domain2, path47, trail, emailDomainDotTrail, wwwAutolink, protocolAutolink, emailAutolink, text4, code2;
+var wwwPrefix, domain2, path48, trail, emailDomainDotTrail, wwwAutolink, protocolAutolink, emailAutolink, text4, code2;
 var init_syntax = __esm({
   "../../../node_modules/.pnpm/micromark-extension-gfm-autolink-literal@2.1.0/node_modules/micromark-extension-gfm-autolink-literal/lib/syntax.js"() {
     "use strict";
@@ -424672,7 +424749,7 @@ var init_syntax = __esm({
       tokenize: tokenizeDomain,
       partial: true
     };
-    path47 = {
+    path48 = {
       tokenize: tokenizePath,
       partial: true
     };
@@ -426750,7 +426827,7 @@ function sizingGroup(value2, options2, baseOptions) {
   }
   return buildCommon.makeFragment(inner2);
 }
-var SourceLocation2, Token2, ParseError22, contains, deflt, uppercase2, hyphenate, ESCAPE_LOOKUP, ESCAPE_REGEX, getBaseElem, isCharacterBox, assert5, protocolFromUrl, utils, SETTINGS_SCHEMA, Settings, Style, D4, Dc, T3, Tc, S5, Sc, SS, SSc, styles4, sup, sub, fracNum, fracDen, cramp, text$1, Style$1, scriptData, allBlocks, hLinePad, sqrtMain, sqrtSize1, sqrtSize2, sqrtSize3, sqrtSize4, phasePath, sqrtTall, sqrtPath, innerPath, path48, tallDelim, DocumentFragment2, fontMetricsData, sigmasAndXis, extraCharacterMap, fontMetricsBySizeIndex, sizeStyleMap, sizeMultipliers, sizeAtStyle, Options, ptPerUnit, relativeUnit, validUnit, calculateSize, makeEm, createClass, initNode, toNode, invalidAttributeNameRegex, toMarkup, Span, Anchor, Img, iCombinations, SymbolNode, SvgNode, PathNode, LineNode, ATOMS, NON_ATOMS, symbols, math2, text5, main2, ams, accent, bin, close2, inner, mathord, op, open2, punct, rel, spacing, textord, ligatures, mathTextSymbols, ch, i3, textSymbols, _ch, _i2, letters, _ch2, _i22, wideChar, _ch3, _i3, _ch4, _i4, extraLatin, _ch5, _i5, wideLatinLetterData, wideNumeralData, wideCharacterFont, lookupSymbol, makeSymbol, mathsym, boldsymbol, makeOrd, canCombine, tryCombineChars, sizeElementFromChildren, makeSpan$2, makeSvgSpan, makeLineSpan, makeAnchor, makeFragment, wrapFragment, getVListChildrenAndDepth, makeVList, makeGlue, retrieveTextFontName, fontMap, svgData, staticSvg, buildCommon, thinspace, mediumspace, thickspace, spacings, tightSpacings, _functions, _htmlGroupBuilders, _mathmlGroupBuilders, normalizeArgument, ordargument, makeSpan$1, binLeftCanceller, binRightCanceller, styleMap$1, DomEnum, buildExpression$1, traverseNonSpaceNodes, checkPartialGroup, getOutermostNode, getTypeOfDomTree, makeNullDelimiter, buildGroup$1, MathNode, TextNode, SpaceNode, mathMLTree, makeText, makeRow, getVariant, buildExpression2, buildExpressionRow, buildGroup2, optionsFromSettings, displayWrap, buildTree, buildHTMLTree, stretchyCodePoint, mathMLnode, katexImagesData, groupLength, svgSpan, encloseSpan, stretchy, htmlBuilder$a, mathmlBuilder$9, NON_STRETCHY_ACCENT_REGEX, paddedNode, makeSpan2, binrelClass, cdArrowFunctionName, newCell, isStartOfArrow, isLabelEnd, htmlBuilder$8, mathmlBuilder$7, globalMap, checkControlSequence, getRHS, letCommand, getMetrics, styleWrap, centerSpan, makeSmallDelim, mathrmSize, makeLargeDelim, makeGlyphSpan, makeInner, lapInEms, lap, verts, doubleVerts, makeStackedDelim, vbPad, emPad, sqrtSvg, makeSqrtImage, stackLargeDelimiters, stackAlwaysDelimiters, stackNeverDelimiters, sizeToMaxHeight, makeSizedDelim, stackNeverDelimiterSequence, stackAlwaysDelimiterSequence, stackLargeDelimiterSequence, delimTypeToFont, traverseSequence, makeCustomSizedDelim, makeLeftRightDelim, delimiter2, delimiterSizes, delimiters, htmlBuilder$7, mathmlBuilder$6, _environments, _macros, validateAmsEnvironmentContext, htmlBuilder$6, alignMap, mathmlBuilder$5, alignedHandler, environments, htmlBuilder$5, mathmlBuilder$4, fontAliases, adjustStyle, htmlBuilder$4, mathmlBuilder$3, stylArray, delimFromValue, htmlBuilder$3, mathmlBuilder$2, sizeData, chooseMathStyle, assembleSupSub, noSuccessor, htmlBuilder$2, mathmlBuilder$1, singleCharBigOps, singleCharIntegrals, htmlBuilder$1, mathmlBuilder2, sizeFuncs, htmlBuilder2, styleMap, htmlBuilderDelegate, defaultVariant, cssSpace, regularSpace, pad, textFontFamilies, textFontWeights, textFontShapes, optionsWithFont, makeVerb, functions, spaceRegexString, controlWordRegexString, controlSymbolRegexString, controlWordWhitespaceRegexString, controlSpaceRegexString, combiningDiacriticalMarkString, combiningDiacriticalMarksEndRegex, tokenRegexString, Lexer2, Namespace2, macros, digitToNumber, newcommand, dotsByToken, spaceAfterDots, latexRaiseA, braketHelper, implicitCommands, MacroExpander, unicodeSubRegEx, uSubsAndSups, unicodeAccents, unicodeSymbols, Parser3, parseTree, render, renderToString, generateParseTree, renderError, renderToDomTree, renderToHTMLTree, version3, __domTree, katex;
+var SourceLocation2, Token2, ParseError22, contains, deflt, uppercase2, hyphenate, ESCAPE_LOOKUP, ESCAPE_REGEX, getBaseElem, isCharacterBox, assert5, protocolFromUrl, utils, SETTINGS_SCHEMA, Settings, Style, D4, Dc, T3, Tc, S5, Sc, SS, SSc, styles4, sup, sub, fracNum, fracDen, cramp, text$1, Style$1, scriptData, allBlocks, hLinePad, sqrtMain, sqrtSize1, sqrtSize2, sqrtSize3, sqrtSize4, phasePath, sqrtTall, sqrtPath, innerPath, path49, tallDelim, DocumentFragment2, fontMetricsData, sigmasAndXis, extraCharacterMap, fontMetricsBySizeIndex, sizeStyleMap, sizeMultipliers, sizeAtStyle, Options, ptPerUnit, relativeUnit, validUnit, calculateSize, makeEm, createClass, initNode, toNode, invalidAttributeNameRegex, toMarkup, Span, Anchor, Img, iCombinations, SymbolNode, SvgNode, PathNode, LineNode, ATOMS, NON_ATOMS, symbols, math2, text5, main2, ams, accent, bin, close2, inner, mathord, op, open2, punct, rel, spacing, textord, ligatures, mathTextSymbols, ch, i3, textSymbols, _ch, _i2, letters, _ch2, _i22, wideChar, _ch3, _i3, _ch4, _i4, extraLatin, _ch5, _i5, wideLatinLetterData, wideNumeralData, wideCharacterFont, lookupSymbol, makeSymbol, mathsym, boldsymbol, makeOrd, canCombine, tryCombineChars, sizeElementFromChildren, makeSpan$2, makeSvgSpan, makeLineSpan, makeAnchor, makeFragment, wrapFragment, getVListChildrenAndDepth, makeVList, makeGlue, retrieveTextFontName, fontMap, svgData, staticSvg, buildCommon, thinspace, mediumspace, thickspace, spacings, tightSpacings, _functions, _htmlGroupBuilders, _mathmlGroupBuilders, normalizeArgument, ordargument, makeSpan$1, binLeftCanceller, binRightCanceller, styleMap$1, DomEnum, buildExpression$1, traverseNonSpaceNodes, checkPartialGroup, getOutermostNode, getTypeOfDomTree, makeNullDelimiter, buildGroup$1, MathNode, TextNode, SpaceNode, mathMLTree, makeText, makeRow, getVariant, buildExpression2, buildExpressionRow, buildGroup2, optionsFromSettings, displayWrap, buildTree, buildHTMLTree, stretchyCodePoint, mathMLnode, katexImagesData, groupLength, svgSpan, encloseSpan, stretchy, htmlBuilder$a, mathmlBuilder$9, NON_STRETCHY_ACCENT_REGEX, paddedNode, makeSpan2, binrelClass, cdArrowFunctionName, newCell, isStartOfArrow, isLabelEnd, htmlBuilder$8, mathmlBuilder$7, globalMap, checkControlSequence, getRHS, letCommand, getMetrics, styleWrap, centerSpan, makeSmallDelim, mathrmSize, makeLargeDelim, makeGlyphSpan, makeInner, lapInEms, lap, verts, doubleVerts, makeStackedDelim, vbPad, emPad, sqrtSvg, makeSqrtImage, stackLargeDelimiters, stackAlwaysDelimiters, stackNeverDelimiters, sizeToMaxHeight, makeSizedDelim, stackNeverDelimiterSequence, stackAlwaysDelimiterSequence, stackLargeDelimiterSequence, delimTypeToFont, traverseSequence, makeCustomSizedDelim, makeLeftRightDelim, delimiter2, delimiterSizes, delimiters, htmlBuilder$7, mathmlBuilder$6, _environments, _macros, validateAmsEnvironmentContext, htmlBuilder$6, alignMap, mathmlBuilder$5, alignedHandler, environments, htmlBuilder$5, mathmlBuilder$4, fontAliases, adjustStyle, htmlBuilder$4, mathmlBuilder$3, stylArray, delimFromValue, htmlBuilder$3, mathmlBuilder$2, sizeData, chooseMathStyle, assembleSupSub, noSuccessor, htmlBuilder$2, mathmlBuilder$1, singleCharBigOps, singleCharIntegrals, htmlBuilder$1, mathmlBuilder2, sizeFuncs, htmlBuilder2, styleMap, htmlBuilderDelegate, defaultVariant, cssSpace, regularSpace, pad, textFontFamilies, textFontWeights, textFontShapes, optionsWithFont, makeVerb, functions, spaceRegexString, controlWordRegexString, controlSymbolRegexString, controlWordWhitespaceRegexString, controlSpaceRegexString, combiningDiacriticalMarkString, combiningDiacriticalMarksEndRegex, tokenRegexString, Lexer2, Namespace2, macros, digitToNumber, newcommand, dotsByToken, spaceAfterDots, latexRaiseA, braketHelper, implicitCommands, MacroExpander, unicodeSubRegEx, uSubsAndSups, unicodeAccents, unicodeSymbols, Parser3, parseTree, render, renderToString, generateParseTree, renderError, renderToDomTree, renderToHTMLTree, version3, __domTree, katex;
 var init_katex = __esm({
   "../../../node_modules/.pnpm/katex@0.16.21/node_modules/katex/dist/katex.mjs"() {
     "use strict";
@@ -427313,7 +427390,7 @@ var init_katex = __esm({
           return "";
       }
     };
-    path48 = {
+    path49 = {
       // The doubleleftarrow geometry is from glyph U+21D0 in the font KaTeX Main
       doubleleftarrow: "M262 157\nl10-10c34-36 62.7-77 86-123 3.3-8 5-13.3 5-16 0-5.3-6.7-8-20-8-7.3\n 0-12.2.5-14.5 1.5-2.3 1-4.8 4.5-7.5 10.5-49.3 97.3-121.7 169.3-217 216-28\n 14-57.3 25-88 33-6.7 2-11 3.8-13 5.5-2 1.7-3 4.2-3 7.5s1 5.8 3 7.5\nc2 1.7 6.3 3.5 13 5.5 68 17.3 128.2 47.8 180.5 91.5 52.3 43.7 93.8 96.2 124.5\n 157.5 9.3 8 15.3 12.3 18 13h6c12-.7 18-4 18-10 0-2-1.7-7-5-15-23.3-46-52-87\n-86-123l-10-10h399738v-40H218c328 0 0 0 0 0l-10-8c-26.7-20-65.7-43-117-69 2.7\n-2 6-3.7 10-5 36.7-16 72.3-37.3 107-64l10-8h399782v-40z\nm8 0v40h399730v-40zm0 194v40h399730v-40z",
       // doublerightarrow is from glyph U+21D2 in font KaTeX Main
@@ -430358,7 +430435,7 @@ var init_katex = __esm({
         if (this.alternate) {
           node4.setAttribute("d", this.alternate);
         } else {
-          node4.setAttribute("d", path48[this.pathName]);
+          node4.setAttribute("d", path49[this.pathName]);
         }
         return node4;
       }
@@ -430366,7 +430443,7 @@ var init_katex = __esm({
         if (this.alternate) {
           return '<path d="' + utils.escape(this.alternate) + '"/>';
         } else {
-          return '<path d="' + utils.escape(path48[this.pathName]) + '"/>';
+          return '<path d="' + utils.escape(path49[this.pathName]) + '"/>';
         }
       }
     };
@@ -454597,7 +454674,7 @@ function replaceImagePathsAndUrls(markdown, fileIdsMap, markdownFilesToPathName,
     if (image3 == null || isExternalUrl(image3) || isDataUrl(image3)) {
       return void 0;
     }
-    if ((0, import_path55.isAbsolute)(image3) || isWindowsAbsolutePath(image3)) {
+    if ((0, import_path56.isAbsolute)(image3) || isWindowsAbsolutePath(image3)) {
       const absolutePath = convertToFernHostAbsoluteFilePath(AbsoluteFilePath2.of(image3));
       const fileId = fileIdsMap.get(absolutePath);
       if (fileId) {
@@ -454964,14 +455041,14 @@ function replaceFrontmatterImagesforLogo(data2, mapImage) {
     }
   }
 }
-var import_gray_matter3, import_path55, JSX_TAG_NAME_START_REGEX, BLANK_LINE_REGEX, CODE_FENCE_REGEX, LogoOverrideFrontmatterSchema;
+var import_gray_matter3, import_path56, JSX_TAG_NAME_START_REGEX, BLANK_LINE_REGEX, CODE_FENCE_REGEX, LogoOverrideFrontmatterSchema;
 var init_parseImagePaths = __esm({
   "../docs-markdown-utils/lib/parseImagePaths.js"() {
     "use strict";
     init_js();
     init_lib8();
     import_gray_matter3 = __toESM(require_gray_matter(), 1);
-    import_path55 = require("path");
+    import_path56 = require("path");
     init_unist_util_visit();
     init_zod2();
     init_extract_literals();
@@ -456215,7 +456292,7 @@ function getBundleCacheDir() {
 }
 function getBundleCacheFilePath(cacheDir, contents) {
   const hash5 = (0, import_crypto6.createHash)("sha256").update(ROLLDOWN_VERSION).update("\0").update(contents).digest("hex");
-  return import_path56.default.join(cacheDir, `${hash5}.js`);
+  return import_path57.default.join(cacheDir, `${hash5}.js`);
 }
 async function readCachedBundle(contents) {
   const cacheDir = getBundleCacheDir();
@@ -456254,13 +456331,13 @@ async function maybeBundleMdxComponent({ absoluteFilePath, contents, context: co
     return cachedBundle;
   }
   context3.logger.debug(`Bundling ${absoluteFilePath} to inline third-party imports: ${thirdPartyImports.join(", ")}`);
-  const { path: tmpDir, cleanup } = await import_tmp_promise9.default.dir({ unsafeCleanup: true });
+  const { path: tmpDir, cleanup } = await import_tmp_promise10.default.dir({ unsafeCleanup: true });
   try {
-    const outputFilePath = import_path56.default.join(tmpDir, "bundle.js");
-    const configFilePath2 = import_path56.default.join(tmpDir, "rolldown.config.mjs");
+    const outputFilePath = import_path57.default.join(tmpDir, "bundle.js");
+    const configFilePath2 = import_path57.default.join(tmpDir, "rolldown.config.mjs");
     await (0, import_promises71.writeFile)(configFilePath2, buildRolldownConfig({ absoluteFilePath, outputFilePath }));
     const result = await loggingExeca(context3.logger, "npx", ["--quiet", "--yes", `rolldown@${ROLLDOWN_VERSION}`, "-c", configFilePath2], {
-      cwd: import_path56.default.dirname(absoluteFilePath),
+      cwd: import_path57.default.dirname(absoluteFilePath),
       doNotPipeOutput: true,
       reject: false
     });
@@ -456311,7 +456388,7 @@ export default {
 };
 `;
 }
-var import_crypto6, import_promises71, import_module2, import_path56, import_tmp_promise9, BUNDLEABLE_EXTENSIONS_REGEX, RENDERER_PROVIDED_MODULES, BUNDLE_CACHE_DIR_ENV_VAR, ROLLDOWN_VERSION, IMPORT_SPECIFIER_REGEX;
+var import_crypto6, import_promises71, import_module2, import_path57, import_tmp_promise10, BUNDLEABLE_EXTENSIONS_REGEX, RENDERER_PROVIDED_MODULES, BUNDLE_CACHE_DIR_ENV_VAR, ROLLDOWN_VERSION, IMPORT_SPECIFIER_REGEX;
 var init_bundleMdxComponent = __esm({
   "../docs-resolver/lib/utils/bundleMdxComponent.js"() {
     "use strict";
@@ -456319,8 +456396,8 @@ var init_bundleMdxComponent = __esm({
     import_crypto6 = require("crypto");
     import_promises71 = require("fs/promises");
     import_module2 = require("module");
-    import_path56 = __toESM(require("path"), 1);
-    import_tmp_promise9 = __toESM(require_tmp_promise(), 1);
+    import_path57 = __toESM(require("path"), 1);
+    import_tmp_promise10 = __toESM(require_tmp_promise(), 1);
     BUNDLEABLE_EXTENSIONS_REGEX = /\.(js|jsx|ts|tsx)$/;
     RENDERER_PROVIDED_MODULES = ["react", "react-dom", "@mdx-js/react", "next"];
     BUNDLE_CACHE_DIR_ENV_VAR = "FERN_MDX_BUNDLE_CACHE_DIR";
@@ -456569,9 +456646,6 @@ async function resolveRemoteSpecs({ definitions: definitions7, context: context3
   if (gitDefinitions.length === 0) {
     return definitions7;
   }
-  if (!isGitAvailable()) {
-    throw new Error("Git is not installed or not found in PATH. Remote git sources in generators.yml require git to be available. Please install git and ensure it is in your PATH.");
-  }
   const cloneTargets = /* @__PURE__ */ new Map();
   for (const def of gitDefinitions) {
     const gitSource = def.gitSource;
@@ -456587,36 +456661,8 @@ async function resolveRemoteSpecs({ definitions: definitions7, context: context3
   const clonedPaths = /* @__PURE__ */ new Map();
   for (const [key2, target] of cloneTargets.entries()) {
     context3.logger.info(`Cloning remote spec source: ${target.repo}${target.ref ? `@${target.ref}` : ""}`);
-    const tmpDir = await import_tmp_promise10.default.dir({ unsafeCleanup: true });
-    const clonePath = AbsoluteFilePath2.of(tmpDir.path);
-    const git = simpleGit();
-    const useCommitShaFlow = target.ref != null && isCommitSha(target.ref);
-    try {
-      if (useCommitShaFlow) {
-        const ref2 = target.ref;
-        const cloneArgs = ["--depth", "1", "--config", "core.symlinks=false", "--no-checkout"];
-        await git.clone(target.repo, tmpDir.path, cloneArgs);
-        const repoGit = simpleGit(tmpDir.path);
-        await repoGit.fetch("origin", ref2, { "--depth": "1" });
-        await repoGit.checkout(ref2);
-      } else {
-        const cloneArgs = ["--depth", "1", "--config", "core.symlinks=false"];
-        if (target.ref != null) {
-          cloneArgs.push("--branch", target.ref);
-        }
-        await git.clone(target.repo, tmpDir.path, cloneArgs);
-      }
-    } catch (error50) {
-      const errorMessage = extractErrorMessage(error50);
-      if (errorMessage.includes("Authentication failed") || errorMessage.includes("could not read Username") || errorMessage.includes("401") || errorMessage.includes("403")) {
-        throw new Error(`Failed to clone remote spec source: authentication failed. Ensure your git credentials are configured for ${target.repo}. The CLI uses your system's git credential configuration (credential helpers, SSH keys, GIT_ASKPASS). Original error: ${errorMessage}`);
-      }
-      if (errorMessage.includes("Repository not found") || errorMessage.includes("not found") || errorMessage.includes("404")) {
-        throw new Error(`Failed to clone remote spec source: repository not found. Check that ${target.repo} exists and your credentials have access. Original error: ${errorMessage}`);
-      }
-      throw new Error(`Failed to clone remote spec source ${target.repo}${target.ref ? ` at ref '${target.ref}'` : ""}. Original error: ${errorMessage}`);
-    }
-    clonedPaths.set(key2, clonePath);
+    const clonePath = await cloneRepositoryAtRef({ repositoryUrl: target.repo, ref: target.ref });
+    clonedPaths.set(key2, AbsoluteFilePath2.of(clonePath));
   }
   return definitions7.map((def) => {
     if (def.gitSource == null) {
@@ -456628,15 +456674,17 @@ async function resolveRemoteSpecs({ definitions: definitions7, context: context3
     if (clonedPath == null) {
       throw new Error(`Internal error: no clone found for ${key2}`);
     }
-    const resolvedPath = AbsoluteFilePath2.of(import_path57.default.resolve(clonedPath, def.gitSource.path));
-    if (!resolvedPath.startsWith(clonedPath + import_path57.default.sep) && resolvedPath !== clonedPath) {
-      throw new Error(`Invalid git source path '${def.gitSource.path}': path must be relative to the repository root and cannot traverse outside it.`);
-    }
+    const resolvedPath = AbsoluteFilePath2.of(resolveRepositorySubpath({
+      repositoryRoot: clonedPath,
+      subpath: def.gitSource.path,
+      description: "git source path"
+    }));
     if (def.schema.type === "protobuf") {
-      const resolvedTarget = def.schema.target.length > 0 ? import_path57.default.resolve(clonedPath, def.schema.target) : def.schema.target;
-      if (resolvedTarget.length > 0 && !resolvedTarget.startsWith(clonedPath + import_path57.default.sep) && resolvedTarget !== clonedPath) {
-        throw new Error(`Invalid proto target path '${def.schema.target}': path must be relative to the repository root and cannot traverse outside it.`);
-      }
+      const resolvedTarget = def.schema.target.length > 0 ? resolveRepositorySubpath({
+        repositoryRoot: clonedPath,
+        subpath: def.schema.target,
+        description: "proto target path"
+      }) : def.schema.target;
       return {
         ...def,
         schema: {
@@ -456659,15 +456707,11 @@ async function resolveRemoteSpecs({ definitions: definitions7, context: context3
     };
   });
 }
-var import_path57, import_tmp_promise10;
 var init_resolveRemoteSpecs = __esm({
   "../workspace/loader/lib/resolveRemoteSpecs.js"() {
     "use strict";
-    init_lib4();
     init_lib8();
-    import_path57 = __toESM(require("path"), 1);
-    init_esm16();
-    import_tmp_promise10 = __toESM(require_tmp_promise(), 1);
+    init_lib11();
   }
 });
 
@@ -689478,14 +689522,14 @@ function getCamelCaseNormalizedCollisions(nameToProperties) {
 
 // ../fern-definition/validator/lib/rules/no-duplicate-declarations/no-duplicate-declarations.js
 init_lib17();
-var import_path25 = __toESM(require("path"), 1);
+var import_path26 = __toESM(require("path"), 1);
 var NoDuplicateDeclarationsRule = {
   name: "no-duplicate-declarations",
   create: ({ workspace, logger: logger4 }) => {
     const declarations = getDeclarations(workspace);
     const seenTypes = {};
     const getRuleViolations = ({ declaredName, relativeFilepath }) => {
-      const relativeDirectoryPath = import_path25.default.dirname(relativeFilepath);
+      const relativeDirectoryPath = import_path26.default.dirname(relativeFilepath);
       const declarationsForName = declarations[relativeDirectoryPath]?.[declaredName];
       if (declarationsForName == null) {
         logger4.error(`Could not find declarations for name: ${declaredName}. This is an error in the Fern validator.`);
@@ -689521,7 +689565,7 @@ var NoDuplicateDeclarationsRule = {
 function getDeclarations(workspace) {
   const declarations = {};
   visitAllDefinitionFiles(workspace, (relativeFilepath, file4) => {
-    const relativeDirectoryPath = import_path25.default.dirname(relativeFilepath);
+    const relativeDirectoryPath = import_path26.default.dirname(relativeFilepath);
     const declarationsForDirectory = declarations[relativeDirectoryPath] ??= {};
     const addDeclaration = (declaredName) => {
       (declarationsForDirectory[declaredName] ??= []).push(relativeFilepath);
@@ -691530,7 +691574,7 @@ init_lib20();
 init_lib4();
 init_lib8();
 init_lib6();
-var import_path26 = __toESM(require("path"), 1);
+var import_path27 = __toESM(require("path"), 1);
 var ValidNavigationRule = {
   name: "valid-navigation",
   create: ({ workspace }) => {
@@ -691538,7 +691582,7 @@ var ValidNavigationRule = {
     const allNamedDefinitionFilepaths = keys2(getAllNamedDefinitionFiles(workspace.definition));
     const directoryToChildren = allNamedDefinitionFilepaths.reduce((acc, definitionFilepath) => {
       const children2 = acc[dirname6(definitionFilepath)] ??= /* @__PURE__ */ new Set();
-      children2.add(import_path26.default.basename(definitionFilepath));
+      children2.add(import_path27.default.basename(definitionFilepath));
       return acc;
     }, {});
     return {
@@ -694841,7 +694885,12 @@ var OpenApiSettingsSchema2 = BaseApiSettingsSchema2.extend({
    * back to a string.
    * Defaults to false.
    */
-  "respect-parameter-content": external_exports.boolean().optional()
+  "respect-parameter-content": external_exports.boolean().optional(),
+  /**
+   * If true, apply each OpenAPI document's plain `x-fern-base-path` to that document's endpoints.
+   * Defaults to false.
+   */
+  "respect-per-spec-base-path": external_exports.boolean().optional()
 });
 
 // ../config/lib/schemas/specs/OpenApiSpecSchema.js
@@ -696281,10 +696330,10 @@ async function removeToken() {
 
 // ../auth/lib/persistence/storeToken.js
 var import_promises48 = require("fs/promises");
-var import_path44 = __toESM(require("path"), 1);
+var import_path45 = __toESM(require("path"), 1);
 async function storeToken(token) {
   const pathToTokenFile = getPathToTokenFile();
-  await (0, import_promises48.mkdir)(import_path44.default.dirname(pathToTokenFile), { recursive: true });
+  await (0, import_promises48.mkdir)(import_path45.default.dirname(pathToTokenFile), { recursive: true });
   await (0, import_promises48.writeFile)(pathToTokenFile, token);
 }
 
@@ -698704,7 +698753,7 @@ var inquirer = {
 var lib_default4 = inquirer;
 
 // ../../../node_modules/.pnpm/posthog-node@5.35.1_rxjs@7.8.2/node_modules/posthog-node/dist/extensions/error-tracking/modifiers/module.node.mjs
-var import_path45 = require("path");
+var import_path46 = require("path");
 function createModulerModifier() {
   const getModuleFromFileName = createGetModuleFromFilename2();
   return async (frames) => {
@@ -698712,12 +698761,12 @@ function createModulerModifier() {
     return frames;
   };
 }
-function createGetModuleFromFilename2(basePath = process.argv[1] ? (0, import_path45.dirname)(process.argv[1]) : process.cwd(), isWindows = "\\" === import_path45.sep) {
+function createGetModuleFromFilename2(basePath = process.argv[1] ? (0, import_path46.dirname)(process.argv[1]) : process.cwd(), isWindows = "\\" === import_path46.sep) {
   const normalizedBase = isWindows ? normalizeWindowsPath2(basePath) : basePath;
   return (filename) => {
     if (!filename) return;
     const normalizedFilename = isWindows ? normalizeWindowsPath2(filename) : filename;
-    let { dir, base: file4, ext: ext2 } = import_path45.posix.parse(normalizedFilename);
+    let { dir, base: file4, ext: ext2 } = import_path46.posix.parse(normalizedFilename);
     if (".js" === ext2 || ".mjs" === ext2 || ".cjs" === ext2) file4 = file4.slice(0, -1 * ext2.length);
     const decodedFile = decodeURIComponent(file4);
     if (!dir) dir = ".";
@@ -701363,14 +701412,14 @@ function snipLine2(line, colno) {
 }
 
 // ../../../node_modules/.pnpm/posthog-node@5.35.1_rxjs@7.8.2/node_modules/posthog-node/dist/extensions/error-tracking/modifiers/relative-path.node.mjs
-var import_path46 = require("path");
+var import_path47 = require("path");
 function createRelativePathModifier(basePath = process.cwd()) {
-  const isWindows = "\\" === import_path46.sep;
+  const isWindows = "\\" === import_path47.sep;
   const toUnix = (p6) => isWindows ? p6.replace(/\\/g, "/") : p6;
   const normalizedBase = toUnix(basePath);
   return async (frames) => {
     for (const frame of frames) if (!(!frame.filename || frame.filename.startsWith("node:") || frame.filename.startsWith("data:"))) {
-      if ((0, import_path46.isAbsolute)(frame.filename)) frame.filename = toUnix((0, import_path46.relative)(normalizedBase, toUnix(frame.filename)));
+      if ((0, import_path47.isAbsolute)(frame.filename)) frame.filename = toUnix((0, import_path47.relative)(normalizedBase, toUnix(frame.filename)));
     }
     return frames;
   };
@@ -703430,7 +703479,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.102.0",
+          version: "5.104.0",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -703469,7 +703518,7 @@ init_lib27();
 init_lib8();
 var import_promises49 = require("fs/promises");
 var import_os6 = require("os");
-var import_path47 = require("path");
+var import_path48 = require("path");
 init_dist_node6();
 var DISTINCT_ID_FILENAME = "id";
 var LOCAL_STORAGE_FOLDER3 = ".fern-dev";
@@ -703496,7 +703545,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.102.0",
+        version: "5.104.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -703548,7 +703597,7 @@ var UserPosthogManager = class {
       const pathToFile = join8(AbsoluteFilePath2.of((0, import_os6.homedir)()), RelativeFilePath2.of(LOCAL_STORAGE_FOLDER3), RelativeFilePath2.of(DISTINCT_ID_FILENAME));
       try {
         if (!await doesPathExist(pathToFile)) {
-          await (0, import_promises49.mkdir)((0, import_path47.dirname)(pathToFile), { recursive: true });
+          await (0, import_promises49.mkdir)((0, import_path48.dirname)(pathToFile), { recursive: true });
           await (0, import_promises49.writeFile)(pathToFile, generatedDistinctId);
           this.persistedDistinctId = generatedDistinctId;
         } else {
@@ -706546,7 +706595,7 @@ var import_os7 = __toESM(require("os"), 1);
 
 // ../cli-v2/lib/cache/docs-preview/DocsPreviewCache.js
 var import_promises54 = __toESM(require("fs/promises"), 1);
-var import_path48 = __toESM(require("path"), 1);
+var import_path49 = __toESM(require("path"), 1);
 var DocsPreviewCache = class {
   /** Absolute file path to the docs-preview cache directory */
   absoluteFilePath;
@@ -706564,7 +706613,7 @@ var DocsPreviewCache = class {
       for (const entry of entries24) {
         if (entry.isDirectory()) {
           bundleCount++;
-          totalSize += await this.getDirectorySize(import_path48.default.join(this.absoluteFilePath, entry.name));
+          totalSize += await this.getDirectorySize(import_path49.default.join(this.absoluteFilePath, entry.name));
         }
       }
     } catch {
@@ -706581,7 +706630,7 @@ var DocsPreviewCache = class {
       const entries24 = await import_promises54.default.readdir(this.absoluteFilePath, { withFileTypes: true });
       for (const entry of entries24) {
         if (entry.isDirectory()) {
-          const fullPath = import_path48.default.join(this.absoluteFilePath, entry.name);
+          const fullPath = import_path49.default.join(this.absoluteFilePath, entry.name);
           const size2 = await this.getDirectorySize(fullPath);
           deletedCount++;
           freedSize += size2;
@@ -706599,7 +706648,7 @@ var DocsPreviewCache = class {
     try {
       const entries24 = await import_promises54.default.readdir(dirPath, { withFileTypes: true });
       for (const entry of entries24) {
-        const entryPath = import_path48.default.join(dirPath, entry.name);
+        const entryPath = import_path49.default.join(dirPath, entry.name);
         if (entry.isFile() || entry.isSymbolicLink()) {
           try {
             const stats = await import_promises54.default.stat(entryPath);
@@ -708177,7 +708226,7 @@ var import_promises60 = require("fs/promises");
 var import_is_ci2 = __toESM(require_is_ci(), 1);
 var os10 = __toESM(require("os"), 1);
 var import_os8 = require("os");
-var import_path49 = require("path");
+var import_path50 = require("path");
 init_dist_node6();
 var TelemetryClient = class _TelemetryClient {
   posthog;
@@ -708327,7 +708376,7 @@ var TelemetryClient = class _TelemetryClient {
     let distinctId = null;
     try {
       if (!await doesPathExist(distinctIdFilepath)) {
-        await (0, import_promises60.mkdir)((0, import_path49.dirname)(distinctIdFilepath), { recursive: true });
+        await (0, import_promises60.mkdir)((0, import_path50.dirname)(distinctIdFilepath), { recursive: true });
         await (0, import_promises60.writeFile)(distinctIdFilepath, v4_default(), { flag: "wx" });
       }
       const content5 = (await (0, import_promises60.readFile)(distinctIdFilepath)).toString().trim();
@@ -709721,12 +709770,12 @@ function getLogLevelPrefix(level) {
 init_source();
 var import_dotenv = __toESM(require_main2(), 1);
 var import_fs24 = __toESM(require("fs"), 1);
-var import_path50 = __toESM(require("path"), 1);
+var import_path51 = __toESM(require("path"), 1);
 function loadDotenvFile(envFilePath, logDebug) {
   if (envFilePath == null) {
     return;
   }
-  const resolved = import_path50.default.resolve(process.cwd(), envFilePath);
+  const resolved = import_path51.default.resolve(process.cwd(), envFilePath);
   if (!import_fs24.default.existsSync(resolved)) {
     process.stderr.write(`${source_default.yellow("warn")} .env file not found: ${resolved}
 `);
@@ -710313,7 +710362,8 @@ var LegacyApiSpecAdapter = class {
       shouldInferDiscriminatedUnionBaseProperties: settings.inferDiscriminatedUnionBaseProperties,
       disambiguateRequestNames: settings["disambiguate-request-names"],
       ignoreTags: settings["ignore-tags"],
-      respectParameterContent: settings["respect-parameter-content"]
+      respectParameterContent: settings["respect-parameter-content"],
+      respectPerSpecBasePath: settings["respect-per-spec-base-path"]
     };
     const hasSettings = Object.values(result).some((v3) => v3 != null);
     return hasSettings ? result : void 0;
@@ -849483,7 +849533,7 @@ init_lib8();
 init_lib6();
 init_source();
 var import_promises65 = require("fs/promises");
-var import_path51 = __toESM(require("path"), 1);
+var import_path52 = __toESM(require("path"), 1);
 
 // ../cli-v2/lib/commands/api/utils/loadSpec.js
 init_lib6();
@@ -849941,8 +849991,8 @@ function stripFernExamples(spec) {
 // ../cli-v2/lib/commands/api/enrich/command.js
 var EnrichCommand = class {
   async handle(context3, args) {
-    const openapiPath = AbsoluteFilePath2.of(import_path51.default.resolve(context3.cwd, args.openapi));
-    const outputPath = args.output != null ? AbsoluteFilePath2.of(import_path51.default.resolve(context3.cwd, args.output)) : openapiPath;
+    const openapiPath = AbsoluteFilePath2.of(import_path52.default.resolve(context3.cwd, args.openapi));
+    const outputPath = args.output != null ? AbsoluteFilePath2.of(import_path52.default.resolve(context3.cwd, args.output)) : openapiPath;
     if (args.file == null) {
       if (args["ai-examples"] === true) {
         throw new CliError({
@@ -849955,7 +850005,7 @@ var EnrichCommand = class {
         code: CliError.Code.ConfigError
       });
     }
-    const overridesPath = AbsoluteFilePath2.of(import_path51.default.resolve(context3.cwd, args.file));
+    const overridesPath = AbsoluteFilePath2.of(import_path52.default.resolve(context3.cwd, args.file));
     const [spec, overrides] = await Promise.all([loadSpec(openapiPath), loadSpec(overridesPath)]);
     const logger4 = {
       warn: (msg) => context3.stderr.warn(msg)
@@ -850010,7 +850060,7 @@ init_lib4();
 init_lib6();
 init_source();
 var import_promises67 = require("fs/promises");
-var import_path53 = __toESM(require("path"), 1);
+var import_path54 = __toESM(require("path"), 1);
 
 // ../cli-v2/lib/config/fern-yml/constants.js
 var FERN_YML_FILENAME = "fern.yml";
@@ -850020,7 +850070,7 @@ var REF_KEY2 = "$ref";
 init_lib8();
 init_lib6();
 var import_promises66 = require("fs/promises");
-var import_path52 = __toESM(require("path"), 1);
+var import_path53 = __toESM(require("path"), 1);
 var import_yaml4 = __toESM(require_dist11(), 1);
 var FernYmlEditor = class _FernYmlEditor {
   rootDocument;
@@ -850121,23 +850171,23 @@ var FernYmlEditor = class _FernYmlEditor {
   async addOverride(specFilePath, overrideAbsolutePath) {
     const section = await this.resolveSection("api", ["specs"]);
     const fileDir = dirname6(section.filePath);
-    const relativeOverridePath = `./${import_path52.default.relative(fileDir, overrideAbsolutePath)}`;
+    const relativeOverridePath = `./${import_path53.default.relative(fileDir, overrideAbsolutePath)}`;
     const index3 = this.findSpecIndex(section, specFilePath);
     if (index3 < 0) {
       return void 0;
     }
     const overridesPath = [...section.basePath, index3, "overrides"];
     const existing = nodeToJS(section.document.getIn(overridesPath));
-    const normalizedNew = import_path52.default.normalize(relativeOverridePath);
+    const normalizedNew = import_path53.default.normalize(relativeOverridePath);
     if (existing == null) {
       section.document.setIn(overridesPath, relativeOverridePath);
     } else if (typeof existing === "string") {
-      if (import_path52.default.normalize(existing) === normalizedNew) {
+      if (import_path53.default.normalize(existing) === normalizedNew) {
         return void 0;
       }
       section.document.setIn(overridesPath, section.document.createNode([existing, relativeOverridePath]));
     } else if (Array.isArray(existing)) {
-      if (existing.some((p6) => import_path52.default.normalize(p6) === normalizedNew)) {
+      if (existing.some((p6) => import_path53.default.normalize(p6) === normalizedNew)) {
         return void 0;
       }
       const updated = [...existing, relativeOverridePath];
@@ -850195,18 +850245,18 @@ var FernYmlEditor = class _FernYmlEditor {
   async addOverlay(specFilePath, overlayAbsolutePath) {
     const section = await this.resolveSection("api", ["specs"]);
     const fileDir = dirname6(section.filePath);
-    const relativeOverlayPath = `./${import_path52.default.relative(fileDir, overlayAbsolutePath)}`;
+    const relativeOverlayPath = `./${import_path53.default.relative(fileDir, overlayAbsolutePath)}`;
     const index3 = this.findSpecIndex(section, specFilePath);
     if (index3 < 0) {
       return void 0;
     }
     const overlaysPath = [...section.basePath, index3, "overlays"];
     const existing = nodeToJS(section.document.getIn(overlaysPath));
-    const normalizedNew = import_path52.default.normalize(relativeOverlayPath);
+    const normalizedNew = import_path53.default.normalize(relativeOverlayPath);
     if (existing == null) {
       section.document.setIn(overlaysPath, relativeOverlayPath);
     } else if (typeof existing === "string") {
-      if (import_path52.default.normalize(existing) === normalizedNew) {
+      if (import_path53.default.normalize(existing) === normalizedNew) {
         return void 0;
       }
       section.document.setIn(overlaysPath, relativeOverlayPath);
@@ -850329,14 +850379,14 @@ var FernYmlEditor = class _FernYmlEditor {
       return -1;
     }
     const fileDir = dirname6(section.filePath);
-    const relativeSpecPath = import_path52.default.normalize(import_path52.default.relative(fileDir, specFilePath));
+    const relativeSpecPath = import_path53.default.normalize(import_path53.default.relative(fileDir, specFilePath));
     for (let i5 = 0; i5 < specs.length; i5++) {
       const spec = specs[i5];
       if (spec == null) {
         continue;
       }
       const specPath = spec.openapi ?? spec.asyncapi;
-      if (specPath != null && import_path52.default.normalize(specPath) === relativeSpecPath) {
+      if (specPath != null && import_path53.default.normalize(specPath) === relativeSpecPath) {
         return i5;
       }
     }
@@ -850665,16 +850715,16 @@ var MergeCommand = class {
         if (overridePaths != null) {
           const edit = await editor.removeOverrides(entry.specFilePath);
           if (edit != null) {
-            const relPath = import_path53.default.relative(context3.cwd, await editor.getApiFilePath());
-            const names2 = overridePaths.map((o3) => import_path53.default.basename(o3)).join(", ");
+            const relPath = import_path54.default.relative(context3.cwd, await editor.getApiFilePath());
+            const names2 = overridePaths.map((o3) => import_path54.default.basename(o3)).join(", ");
             context3.stderr.info(source_default.dim(`${relPath}:${edit.line}: removed reference to ${names2}`));
           }
         }
         if (overlayPath != null) {
           const edit = await editor.removeOverlay(entry.specFilePath);
           if (edit != null) {
-            const relPath = import_path53.default.relative(context3.cwd, await editor.getApiFilePath());
-            context3.stderr.info(source_default.dim(`${relPath}:${edit.line}: removed reference to ${import_path53.default.basename(overlayPath)}`));
+            const relPath = import_path54.default.relative(context3.cwd, await editor.getApiFilePath());
+            context3.stderr.info(source_default.dim(`${relPath}:${edit.line}: removed reference to ${import_path54.default.basename(overlayPath)}`));
           }
         }
       }
@@ -850727,7 +850777,7 @@ init_lib6();
 init_source();
 var import_child_process6 = require("child_process");
 var import_promises68 = require("fs/promises");
-var import_path54 = __toESM(require("path"), 1);
+var import_path55 = __toESM(require("path"), 1);
 var import_util17 = require("util");
 
 // ../cli-v2/lib/commands/api/split/deriveOutputPath.js
@@ -850826,7 +850876,7 @@ var SplitCommand = class {
    */
   async handleStdoutPreview(context3, entries24, format3) {
     if (entries24.length > 1) {
-      const names2 = entries24.map((e2) => import_path54.default.basename(e2.specFilePath)).join(", ");
+      const names2 = entries24.map((e2) => import_path55.default.basename(e2.specFilePath)).join(", ");
       throw new CliError({
         message: `--output "-" requires --api to select a single spec, but ${entries24.length} matched: ${names2}.`,
         code: CliError.Code.ConfigError
@@ -850872,8 +850922,8 @@ var SplitCommand = class {
     }
     const edit = await editor.addOverlay(entry.specFilePath, outputPath);
     if (edit != null) {
-      const relPath = import_path54.default.relative(context3.cwd, await editor.getApiFilePath());
-      context3.stderr.info(source_default.dim(`${relPath}:${edit.line}: added reference to ${import_path54.default.basename(outputPath)}`));
+      const relPath = import_path55.default.relative(context3.cwd, await editor.getApiFilePath());
+      context3.stderr.info(source_default.dim(`${relPath}:${edit.line}: added reference to ${import_path55.default.basename(outputPath)}`));
     }
   }
   async splitAsOverrides(context3, editor, entry, originalContent, currentContent, outputArg) {
@@ -850887,8 +850937,8 @@ var SplitCommand = class {
     }
     const edit = await editor.addOverride(entry.specFilePath, outputPath);
     if (edit != null) {
-      const relPath = import_path54.default.relative(context3.cwd, await editor.getApiFilePath());
-      context3.stderr.info(source_default.dim(`${relPath}:${edit.line}: added reference to ${import_path54.default.basename(outputPath)}`));
+      const relPath = import_path55.default.relative(context3.cwd, await editor.getApiFilePath());
+      context3.stderr.info(source_default.dim(`${relPath}:${edit.line}: added reference to ${import_path55.default.basename(outputPath)}`));
     }
   }
   /**
@@ -850932,7 +850982,7 @@ var SplitCommand = class {
   }
   async getFileFromGitHead(repoRoot, absolutePath) {
     try {
-      const relativePath = import_path54.default.relative(repoRoot, absolutePath);
+      const relativePath = import_path55.default.relative(repoRoot, absolutePath);
       const { stdout } = await execFileAsync5("git", ["show", `HEAD:${relativePath}`], {
         cwd: repoRoot,
         encoding: "utf8",
@@ -850950,7 +851000,7 @@ var SplitCommand = class {
   }
   async getRepoRoot(nearPath) {
     const { stdout } = await execFileAsync5("git", ["rev-parse", "--show-toplevel"], {
-      cwd: import_path54.default.dirname(nearPath),
+      cwd: import_path55.default.dirname(nearPath),
       encoding: "utf8"
     });
     return stdout.trim();
@@ -884878,7 +884928,7 @@ var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 var MAX_LOGS_DIR_SIZE_BYTES = 100 * 1024 * 1024;
 function getCliSource() {
-  const version7 = "5.102.0";
+  const version7 = "5.104.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -904552,6 +904602,7 @@ function writeGroupPage(group, dir, writer2, written) {
 var import_promises116 = require("fs/promises");
 init_lib4();
 init_lib8();
+init_lib11();
 init_lib6();
 init_source();
 
@@ -904587,6 +904638,7 @@ async function runLocalParser({ context: context3, sourcePath, language, config:
     await (0, import_promises115.writeFile)(configFile.path, JSON.stringify({
       packagePath: config5.packagePath,
       sourceUrl: config5.sourceUrl,
+      branch: config5.branch,
       doxyfileContent: config5.doxyfileContent
     }));
     await runContainer({
@@ -905567,16 +905619,35 @@ async function generateIrRemotely({ client: client3, name: name2, config: config
   });
 }
 async function generateIrLocally({ context: context3, name: name2, config: config5, docsDirectoryPath, language, doxyfileContent, wrapStep }) {
+  let sourcePath;
+  let parserConfig;
   if (isGitLibraryInput2(config5.input)) {
-    throw new CliError({
-      message: `Library '${name2}': 'git' inputs are generated remotely, not with --local. For --local, use a 'path' input pointing at a local checkout of the library.`,
-      code: CliError.Code.ConfigError
+    const gitInput = config5.input;
+    const clonePath = await wrapStep({
+      message: `Library '${name2}': cloning ${gitInput.git}${gitInput.ref != null ? ` (ref: ${gitInput.ref})` : ""}`,
+      operation: () => cloneRepositoryAtRef({ repositoryUrl: gitInput.git, ref: gitInput.ref })
     });
+    if (gitInput.subpath != null) {
+      resolveRepositorySubpath({
+        repositoryRoot: clonePath,
+        subpath: gitInput.subpath,
+        description: `subpath for library '${name2}'`
+      });
+    }
+    sourcePath = AbsoluteFilePath2.of(clonePath);
+    parserConfig = {
+      packagePath: gitInput.subpath,
+      sourceUrl: gitInput.git,
+      branch: gitInput.ref,
+      doxyfileContent
+    };
+  } else {
+    sourcePath = resolve6(docsDirectoryPath, config5.input.path);
+    parserConfig = { doxyfileContent };
   }
-  const sourcePath = resolve6(docsDirectoryPath, config5.input.path);
   const ir3 = await wrapStep({
     message: `Library '${name2}': parsing library source locally`,
-    operation: () => runLocalParser({ context: context3, sourcePath, language, config: { doxyfileContent } })
+    operation: () => runLocalParser({ context: context3, sourcePath, language, config: parserConfig })
   });
   validateLibraryIr(ir3, language, name2);
   return ir3;
@@ -910943,7 +911014,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.102.0",
+        cliVersion: "5.104.0",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -978314,7 +978385,7 @@ function getAutomationContextFromEnv() {
     config_branch: process.env.FERN_CONFIG_BRANCH,
     config_pr_number: process.env.FERN_CONFIG_PR_NUMBER,
     trigger: process.env.GITHUB_EVENT_NAME,
-    cli_version: "5.102.0"
+    cli_version: "5.104.0"
   };
 }
 function isAutomationMode() {
@@ -979146,7 +979217,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.102.0";
+    return "5.104.0";
   }
   getCliName() {
     if (false) {