@fern-api/fern-api-dev 5.55.0 → 5.55.1

package/cli.cjs

@@ -44766,15 +44766,6 @@ var init_MockTaskContext = __esm({
 });
 
 // ../task-context/lib/index.js
-var lib_exports3 = {};
-__export(lib_exports3, {
-  CliError: () => CliError,
-  TaskAbortSignal: () => TaskAbortSignal,
-  TaskResult: () => TaskResult,
-  createMockTaskContext: () => createMockTaskContext,
-  resolveErrorCode: () => resolveErrorCode,
-  shouldReportToSentry: () => shouldReportToSentry
-});
 var init_lib6 = __esm({
   "../task-context/lib/index.js"() {
     "use strict";
@@ -53821,8 +53812,8 @@ var init_waitUntilPathExists = __esm({
 });
 
 // ../../commons/fs-utils/lib/index.js
-var lib_exports4 = {};
-__export(lib_exports4, {
+var lib_exports3 = {};
+__export(lib_exports3, {
   AbsoluteFilePath: () => AbsoluteFilePath2,
   RelativeFilePath: () => RelativeFilePath2,
   basename: () => basename3,
@@ -97679,8 +97670,8 @@ var init_getOrUpdateBranch = __esm({
 });
 
 // ../../commons/github/lib/index.js
-var lib_exports5 = {};
-__export(lib_exports5, {
+var lib_exports4 = {};
+__export(lib_exports4, {
   ClonedRepository: () => ClonedRepository,
   cloneRepository: () => cloneRepository,
   createOrUpdatePullRequest: () => createOrUpdatePullRequest,
@@ -240086,8 +240077,8 @@ var require_whatwg_url = __commonJS({
 });
 
 // ../../../node_modules/.pnpm/node-fetch@2.7.0/node_modules/node-fetch/lib/index.mjs
-var lib_exports6 = {};
-__export(lib_exports6, {
+var lib_exports5 = {};
+__export(lib_exports5, {
   AbortError: () => AbortError2,
   FetchError: () => FetchError,
   Headers: () => Headers2,
@@ -241389,12 +241380,12 @@ var require_getFetchFn = __commonJS({
           return fetch;
         }
         if (runtime_1.RUNTIME.type === "node") {
-          return (yield Promise.resolve().then(() => __importStar2((init_lib18(), __toCommonJS(lib_exports6))))).default;
+          return (yield Promise.resolve().then(() => __importStar2((init_lib18(), __toCommonJS(lib_exports5))))).default;
         }
         if (typeof fetch == "function") {
           return fetch;
         }
-        return (yield Promise.resolve().then(() => __importStar2((init_lib18(), __toCommonJS(lib_exports6))))).default;
+        return (yield Promise.resolve().then(() => __importStar2((init_lib18(), __toCommonJS(lib_exports5))))).default;
       });
     }
     exports2.getFetchFn = getFetchFn3;
@@ -279194,16 +279185,16 @@ var init_ConjureImporter = __esm({
               });
             }
             for (const [endpointName, endpointDeclaration] of Object.entries(serviceDeclaration.endpoints ?? {})) {
-              const endpointLocator = parseEndpointLocator(endpointDeclaration.http);
-              if (endpointLocator.type === "failure") {
+              const endpointLocator2 = parseEndpointLocator(endpointDeclaration.http);
+              if (endpointLocator2.type === "failure") {
                 this.context?.logger.error(`Failed to parse ${endpointDeclaration.http}. Skipping.`);
                 continue;
               }
               const auth8 = endpointDeclaration.auth ?? serviceDeclaration.defaultAuth;
               const endpoint3 = {
                 auth: auth8 === ConjureAuthDefinitionType.None ? false : true,
-                path: endpointLocator.path,
-                method: endpointLocator.method,
+                path: endpointLocator2.path,
+                method: endpointLocator2.method,
                 response: endpointDeclaration.returns === "binary" ? "file" : endpointDeclaration.returns
               };
               if (endpointDeclaration.docs != null) {
@@ -279211,7 +279202,7 @@ var init_ConjureImporter = __esm({
               }
               const pathParameters = {};
               if (endpointDeclaration.args != null) {
-                for (const pathParameter of endpointLocator.pathParameters) {
+                for (const pathParameter of endpointLocator2.pathParameters) {
                   const pathParameterType = endpointDeclaration.args[pathParameter];
                   if (pathParameterType == null) {
                     throw new CliError({
@@ -329708,8 +329699,8 @@ var require_lib6 = __commonJS({
 });
 
 // ../../../node_modules/.pnpm/node-fetch-h2@2.3.0/node_modules/node-fetch-h2/lib/index.mjs
-var lib_exports8 = {};
-__export(lib_exports8, {
+var lib_exports7 = {};
+__export(lib_exports7, {
   FetchError: () => FetchError2,
   Headers: () => Headers5,
   Request: () => Request7,
@@ -336843,7 +336834,7 @@ var require_oas_resolver = __commonJS({
     var fs34 = require("fs");
     var path119 = require("path");
     var url3 = require("url");
-    var fetch6 = (init_lib28(), __toCommonJS(lib_exports8));
+    var fetch6 = (init_lib28(), __toCommonJS(lib_exports7));
     var yaml3 = require_yaml();
     var jptr = require_jptr().jptr;
     var recurse = require_recurse().recurse;
@@ -337485,7 +337476,7 @@ var require_swagger2openapi = __commonJS({
     var url3 = require("url");
     var pathlib = require("path");
     var maybe = require_maybe();
-    var fetch6 = (init_lib28(), __toCommonJS(lib_exports8));
+    var fetch6 = (init_lib28(), __toCommonJS(lib_exports7));
     var yaml3 = require_yaml();
     var jptr = require_jptr();
     var resolveInternal = jptr.jptr;
@@ -354970,8 +354961,8 @@ var init_createLoggingExecutable = __esm({
 });
 
 // ../../commons/logging-execa/lib/index.js
-var lib_exports9 = {};
-__export(lib_exports9, {
+var lib_exports8 = {};
+__export(lib_exports8, {
   createLoggingExecutable: () => createLoggingExecutable,
   loggingExeca: () => loggingExeca,
   runExeca: () => runExeca
@@ -366781,8 +366772,8 @@ var init_GraphQLConverter = __esm({
 });
 
 // ../api-importers/graphql/lib/index.js
-var lib_exports10 = {};
-__export(lib_exports10, {
+var lib_exports9 = {};
+__export(lib_exports9, {
   GraphQLConverter: () => GraphQLConverter
 });
 var init_lib34 = __esm({
@@ -367002,7 +366993,7 @@ var init_OSSWorkspace = __esm({
         return Object.keys(this.graphqlTypes).length;
       }
       async processGraphQLSpecs(context3) {
-        const { GraphQLConverter: GraphQLConverter2 } = await Promise.resolve().then(() => (init_lib34(), lib_exports10));
+        const { GraphQLConverter: GraphQLConverter2 } = await Promise.resolve().then(() => (init_lib34(), lib_exports9));
         const graphqlSpecs = this.allSpecs.filter((spec) => spec.type === "graphql");
         for (const spec of graphqlSpecs) {
           try {
@@ -449574,8 +449565,8 @@ var init_transformAtPrefixImports = __esm({
 });
 
 // ../docs-markdown-utils/lib/index.js
-var lib_exports11 = {};
-__export(lib_exports11, {
+var lib_exports10 = {};
+__export(lib_exports10, {
   extractAttributeValueLiteral: () => extractAttributeValueLiteral,
   extractSingleLiteral: () => extractSingleLiteral,
   getMarkdownFormat: () => getMarkdownFormat,
@@ -449612,100 +449603,229 @@ var init_lib64 = __esm({
 });
 
 // ../docs-resolver/lib/applyTranslatedApiTitlesToNavTree.js
-function applyTranslatedApiTitlesToNavTree(root6, baseApis, translatedApis) {
-  const mapsByApiId = /* @__PURE__ */ new Map();
-  for (const [apiId, translatedApi] of Object.entries(translatedApis)) {
-    const holder = navigation_exports.ApiDefinitionHolder.create(translatedApi);
-    const endpoints = /* @__PURE__ */ new Map();
-    for (const [id, endpoint3] of holder.endpoints) {
-      if (endpoint3.name != null && endpoint3.name.length > 0) {
-        endpoints.set(id, endpoint3.name);
-      }
+function stringifyPathPartsForLocator(path119) {
+  return path119.map((part) => part.type === "literal" ? part.value : "{}").join("");
+}
+function endpointLocator(endpoint3) {
+  return `${endpoint3.method} ${stringifyPathPartsForLocator(endpoint3.path.parts)}`;
+}
+function webhookLocator(webhook) {
+  return `${webhook.method} ${webhook.path.join("/")}`;
+}
+function webSocketLocator(webSocket) {
+  return `WSS ${stringifyPathPartsForLocator(webSocket.path.parts)}`;
+}
+function nonEmptyTitle(name2) {
+  return name2 != null && name2.length > 0 ? name2 : void 0;
+}
+function subpackageTitle(pkg2) {
+  return pkg2.displayName ?? titleCase(pkg2.name);
+}
+function subpackageLocators(pkg2) {
+  return [
+    ...pkg2.endpoints.map(endpointLocator),
+    ...pkg2.webhooks.map(webhookLocator),
+    ...pkg2.websockets.map(webSocketLocator)
+  ];
+}
+function buildResolverForKind(baseEntries, translatedEntries, locatorOf, titleOf) {
+  const translatedIdByLocator = /* @__PURE__ */ new Map();
+  for (const [navId, def] of translatedEntries) {
+    if (!translatedIdByLocator.has(locatorOf(def))) {
+      translatedIdByLocator.set(locatorOf(def), navId);
     }
-    const webhooks2 = /* @__PURE__ */ new Map();
-    for (const [id, webhook] of holder.webhooks) {
-      if (webhook.name != null && webhook.name.length > 0) {
-        webhooks2.set(id, webhook.name);
-      }
+  }
+  return (baseNavId) => {
+    const exact = translatedEntries.get(baseNavId);
+    if (exact != null) {
+      return { translatedId: baseNavId, title: titleOf(exact) };
     }
-    const webSockets = /* @__PURE__ */ new Map();
-    for (const [id, webSocket] of holder.webSockets) {
-      if (webSocket.name != null && webSocket.name.length > 0) {
-        webSockets.set(id, webSocket.name);
+    const baseDef = baseEntries.get(baseNavId);
+    if (baseDef == null) {
+      return void 0;
+    }
+    const translatedId = translatedIdByLocator.get(locatorOf(baseDef));
+    if (translatedId == null) {
+      return void 0;
+    }
+    const translatedDef = translatedEntries.get(translatedId);
+    return { translatedId, title: translatedDef != null ? titleOf(translatedDef) : void 0 };
+  };
+}
+function buildPackagesByBaseTitle(baseApi, translatedApi) {
+  const packagesByBaseTitle = /* @__PURE__ */ new Map();
+  for (const [subpackageId, translatedSubpackage] of Object.entries(translatedApi.subpackages)) {
+    const baseSubpackage = baseApi.subpackages[subpackageId];
+    if (baseSubpackage == null) {
+      continue;
+    }
+    const baseTitle = subpackageTitle(baseSubpackage);
+    const translatedTitle = subpackageTitle(translatedSubpackage);
+    if (baseTitle !== translatedTitle) {
+      packagesByBaseTitle.set(baseTitle, translatedTitle);
+    }
+  }
+  const baseTitleByLocator = /* @__PURE__ */ new Map();
+  for (const baseSubpackage of Object.values(baseApi.subpackages)) {
+    const baseTitle = subpackageTitle(baseSubpackage);
+    for (const locator of subpackageLocators(baseSubpackage)) {
+      if (!baseTitleByLocator.has(locator)) {
+        baseTitleByLocator.set(locator, baseTitle);
       }
     }
-    const graphql4 = /* @__PURE__ */ new Map();
-    for (const [id, operation] of holder.graphqlOperations) {
-      const name2 = operation.displayName ?? operation.name;
-      if (name2 != null && name2.length > 0) {
-        graphql4.set(id, name2);
+  }
+  for (const translatedSubpackage of Object.values(translatedApi.subpackages)) {
+    const translatedTitle = subpackageTitle(translatedSubpackage);
+    for (const locator of subpackageLocators(translatedSubpackage)) {
+      const baseTitle = baseTitleByLocator.get(locator);
+      if (baseTitle != null && baseTitle !== translatedTitle && !packagesByBaseTitle.has(baseTitle)) {
+        packagesByBaseTitle.set(baseTitle, translatedTitle);
       }
     }
-    const packagesByBaseTitle = /* @__PURE__ */ new Map();
+  }
+  return packagesByBaseTitle;
+}
+function buildApiTranslationResolvers(baseApis, translatedApis) {
+  const resolvers = /* @__PURE__ */ new Map();
+  for (const [apiId, translatedApi] of Object.entries(translatedApis)) {
     const baseApi = baseApis[apiId];
-    if (baseApi != null) {
-      for (const [subpackageId, translatedSubpackage] of Object.entries(translatedApi.subpackages)) {
-        const baseSubpackage = baseApi.subpackages[subpackageId];
-        if (baseSubpackage == null) {
-          continue;
-        }
-        const baseTitle = baseSubpackage.displayName ?? titleCase(baseSubpackage.name);
-        const translatedTitle = translatedSubpackage.displayName ?? titleCase(translatedSubpackage.name);
-        if (baseTitle !== translatedTitle) {
-          packagesByBaseTitle.set(baseTitle, translatedTitle);
-        }
+    if (baseApi == null) {
+      continue;
+    }
+    const baseHolder = navigation_exports.ApiDefinitionHolder.create(baseApi);
+    const translatedHolder = navigation_exports.ApiDefinitionHolder.create(translatedApi);
+    const resolveEndpoint = buildResolverForKind(baseHolder.endpoints, translatedHolder.endpoints, endpointLocator, (endpoint3) => nonEmptyTitle(endpoint3.name));
+    const resolveWebhook = buildResolverForKind(baseHolder.webhooks, translatedHolder.webhooks, webhookLocator, (webhook) => nonEmptyTitle(webhook.name));
+    const resolveWebSocket = buildResolverForKind(baseHolder.webSockets, translatedHolder.webSockets, webSocketLocator, (webSocket) => nonEmptyTitle(webSocket.name));
+    const graphqlTitlesById = /* @__PURE__ */ new Map();
+    for (const [id, operation] of translatedHolder.graphqlOperations) {
+      const name2 = operation.displayName ?? operation.name;
+      const title2 = nonEmptyTitle(name2);
+      if (title2 != null) {
+        graphqlTitlesById.set(id, title2);
       }
     }
-    mapsByApiId.set(apiId, { endpoints, webhooks: webhooks2, webSockets, graphql: graphql4, packagesByBaseTitle });
+    resolvers.set(apiId, {
+      resolveEndpoint,
+      resolveWebhook,
+      resolveWebSocket,
+      graphqlTitlesById,
+      packagesByBaseTitle: buildPackagesByBaseTitle(baseApi, translatedApi)
+    });
   }
-  const clone5 = structuredClone(root6);
-  const visit5 = (node4) => {
-    if (node4 == null || typeof node4 !== "object") {
+  return resolvers;
+}
+function getApiDefinitionId(node4) {
+  return typeof node4.apiDefinitionId === "string" ? node4.apiDefinitionId : void 0;
+}
+function visitNavigationNodes(node4, callback) {
+  if (node4 == null || typeof node4 !== "object") {
+    return;
+  }
+  if (Array.isArray(node4)) {
+    for (const item of node4) {
+      visitNavigationNodes(item, callback);
+    }
+    return;
+  }
+  const obj = node4;
+  callback(obj);
+  for (const value2 of Object.values(obj)) {
+    visitNavigationNodes(value2, callback);
+  }
+}
+function findIncompatibleTranslatedApiIds(root6, baseApis, translatedApis) {
+  const incompatible = /* @__PURE__ */ new Set();
+  for (const apiId of Object.keys(translatedApis)) {
+    if (baseApis[apiId] == null) {
+      incompatible.add(apiId);
+    }
+  }
+  if (root6 == null) {
+    return incompatible;
+  }
+  const resolvers = buildApiTranslationResolvers(baseApis, translatedApis);
+  visitNavigationNodes(root6, (obj) => {
+    const apiDefinitionId = getApiDefinitionId(obj);
+    if (apiDefinitionId == null || incompatible.has(apiDefinitionId)) {
+      return;
+    }
+    const resolver2 = resolvers.get(apiDefinitionId);
+    if (resolver2 == null) {
       return;
     }
-    if (Array.isArray(node4)) {
-      for (const item of node4) {
-        visit5(item);
+    const type7 = obj.type;
+    if (type7 === "endpoint" && typeof obj.endpointId === "string") {
+      if (resolver2.resolveEndpoint(obj.endpointId) == null) {
+        incompatible.add(apiDefinitionId);
       }
+    } else if (type7 === "webhook" && typeof obj.webhookId === "string") {
+      if (resolver2.resolveWebhook(obj.webhookId) == null) {
+        incompatible.add(apiDefinitionId);
+      }
+    } else if (type7 === "webSocket" && typeof obj.webSocketId === "string") {
+      if (resolver2.resolveWebSocket(obj.webSocketId) == null) {
+        incompatible.add(apiDefinitionId);
+      }
+    }
+  });
+  return incompatible;
+}
+function applyTranslatedApiTitlesToNavTree(root6, baseApis, translatedApis, options2) {
+  const resolvers = buildApiTranslationResolvers(baseApis, translatedApis);
+  const rewritableApiIds = options2?.rewritableApiIds;
+  const canRewriteIds = (apiDefinitionId) => rewritableApiIds == null || rewritableApiIds.has(apiDefinitionId);
+  const clone5 = structuredClone(root6);
+  visitNavigationNodes(clone5, (obj) => {
+    const apiDefinitionId = getApiDefinitionId(obj);
+    const resolver2 = apiDefinitionId != null ? resolvers.get(apiDefinitionId) : void 0;
+    if (resolver2 == null || apiDefinitionId == null) {
       return;
     }
-    const obj = node4;
-    const apiDefinitionId = typeof obj.apiDefinitionId === "string" ? obj.apiDefinitionId : void 0;
-    const maps = apiDefinitionId != null ? mapsByApiId.get(apiDefinitionId) : void 0;
-    if (maps != null) {
-      const type7 = obj.type;
-      if (type7 === "endpoint" && typeof obj.endpointId === "string") {
-        const translated = maps.endpoints.get(obj.endpointId);
-        if (translated != null) {
-          obj.title = translated;
+    const rewriteIds = canRewriteIds(apiDefinitionId);
+    const type7 = obj.type;
+    if (type7 === "endpoint" && typeof obj.endpointId === "string") {
+      const match3 = resolver2.resolveEndpoint(obj.endpointId);
+      if (match3 != null) {
+        if (rewriteIds) {
+          obj.endpointId = match3.translatedId;
         }
-      } else if (type7 === "webhook" && typeof obj.webhookId === "string") {
-        const translated = maps.webhooks.get(obj.webhookId);
-        if (translated != null) {
-          obj.title = translated;
+        if (match3.title != null) {
+          obj.title = match3.title;
         }
-      } else if (type7 === "webSocket" && typeof obj.webSocketId === "string") {
-        const translated = maps.webSockets.get(obj.webSocketId);
-        if (translated != null) {
-          obj.title = translated;
+      }
+    } else if (type7 === "webhook" && typeof obj.webhookId === "string") {
+      const match3 = resolver2.resolveWebhook(obj.webhookId);
+      if (match3 != null) {
+        if (rewriteIds) {
+          obj.webhookId = match3.translatedId;
         }
-      } else if (type7 === "graphql" && typeof obj.graphqlOperationId === "string") {
-        const translated = maps.graphql.get(obj.graphqlOperationId);
-        if (translated != null) {
-          obj.title = translated;
+        if (match3.title != null) {
+          obj.title = match3.title;
         }
-      } else if (type7 === "apiPackage" && typeof obj.title === "string") {
-        const translated = maps.packagesByBaseTitle.get(obj.title);
-        if (translated != null) {
-          obj.title = translated;
+      }
+    } else if (type7 === "webSocket" && typeof obj.webSocketId === "string") {
+      const match3 = resolver2.resolveWebSocket(obj.webSocketId);
+      if (match3 != null) {
+        if (rewriteIds) {
+          obj.webSocketId = match3.translatedId;
+        }
+        if (match3.title != null) {
+          obj.title = match3.title;
         }
       }
+    } else if (type7 === "graphql" && typeof obj.graphqlOperationId === "string") {
+      const translated = resolver2.graphqlTitlesById.get(obj.graphqlOperationId);
+      if (translated != null) {
+        obj.title = translated;
+      }
+    } else if (type7 === "apiPackage" && typeof obj.title === "string") {
+      const translated = resolver2.packagesByBaseTitle.get(obj.title);
+      if (translated != null) {
+        obj.title = translated;
+      }
     }
-    for (const value2 of Object.values(obj)) {
-      visit5(value2);
-    }
-  };
-  visit5(clone5);
+  });
   return clone5;
 }
 var init_applyTranslatedApiTitlesToNavTree = __esm({
@@ -561695,8 +561815,8 @@ var init_runDocker = __esm({
 });
 
 // ../generation/local-generation/docker-utils/lib/index.js
-var lib_exports14 = {};
-__export(lib_exports14, {
+var lib_exports13 = {};
+__export(lib_exports13, {
   copyFromContainer: () => copyFromContainer,
   copyToContainer: () => copyToContainer,
   execInContainer: () => execInContainer,
@@ -561850,9 +561970,7 @@ var require_AutoVersioningService = __commonJS({
     exports2.AutoVersioningService = exports2.AutoVersioningException = void 0;
     exports2.countFilesInDiff = countFilesInDiff3;
     exports2.formatSizeKB = formatSizeKB3;
-    var core_utils_1 = (init_lib4(), __toCommonJS(lib_exports));
-    var logging_execa_1 = (init_lib33(), __toCommonJS(lib_exports9));
-    var task_context_1 = (init_lib6(), __toCommonJS(lib_exports3));
+    var logging_execa_1 = (init_lib33(), __toCommonJS(lib_exports8));
     var fs_1 = require("fs");
     var promises_1 = require("fs/promises");
     var path_1 = require("path");
@@ -561894,6 +562012,43 @@ var require_AutoVersioningService = __commonJS({
     function formatSizeKB3(charLength) {
       return (charLength / 1024).toFixed(1);
     }
+    var EXCLUDED_DIRECTORIES = /* @__PURE__ */ new Set([
+      // Version control
+      ".git",
+      // Dependency directories
+      "vendor",
+      "node_modules",
+      "Pods",
+      // Python environments and caches
+      ".venv",
+      "venv",
+      "__pycache__",
+      ".tox",
+      ".mypy_cache",
+      ".pytest_cache",
+      ".ruff_cache",
+      // Build output directories
+      "build",
+      "dist",
+      "out",
+      "target",
+      "bin",
+      "obj",
+      // Build tool caches
+      ".gradle",
+      ".mvn",
+      // Framework build caches
+      ".next",
+      ".nuxt",
+      ".cache",
+      // IDE directories
+      ".idea",
+      ".vscode",
+      ".eclipse",
+      // Language-specific tool caches
+      ".dart_tool",
+      ".swiftpm"
+    ]);
     var EXCLUDED_FILE_PATTERNS = [
       // Documentation / generated reference
       /(?:^|\/)reference\.md$/i,
@@ -562490,34 +562645,37 @@ var require_AutoVersioningService = __commonJS({
        */
       async replaceMagicVersion(workingDirectory, mappedMagicVersion, finalVersion) {
         this.logger.debug(`Replacing placeholder version ${mappedMagicVersion} with final version: ${finalVersion}`);
-        const sedCommand = `s/${this.escapeForSed(mappedMagicVersion)}/${this.escapeForSed(finalVersion)}/g`;
-        let isGNUSed = false;
-        try {
-          await (0, logging_execa_1.loggingExeca)(this.logger, "sed", ["--version"], {
-            doNotPipeOutput: true
-          });
-          isGNUSed = true;
-        } catch {
-          isGNUSed = false;
-        }
-        let command3;
-        if (isGNUSed) {
-          command3 = `find "${workingDirectory}" -type f -not -path "*/.git/*" -exec sed -i '${sedCommand}' {} +`;
-        } else {
-          command3 = `find "${workingDirectory}" -type f -not -path "*/.git/*" -exec sed -i '' '${sedCommand}' {} +`;
-        }
+        const files = await this.walkDirectory(workingDirectory, () => true);
+        const replaceInFile = async (filePath) => {
+          if (await this.isBinaryFile(filePath)) {
+            return false;
+          }
+          const content5 = await (0, promises_1.readFile)(filePath, "utf-8");
+          if (!content5.includes(mappedMagicVersion)) {
+            return false;
+          }
+          const updated = content5.split(mappedMagicVersion).join(finalVersion);
+          await (0, promises_1.writeFile)(filePath, updated, "utf-8");
+          return true;
+        };
+        const results = await this.processInParallel(files, replaceInFile);
+        const replacedCount = results.filter(Boolean).length;
+        this.logger.debug(`Placeholder version replaced successfully in ${replacedCount} file(s)`);
+      }
+      async isBinaryFile(filePath) {
+        const fileHandle = await (0, promises_1.open)(filePath, "r");
         try {
-          await (0, logging_execa_1.loggingExeca)(this.logger, "bash", ["-c", command3], {
-            cwd: workingDirectory,
-            doNotPipeOutput: true
-          });
-        } catch (error50) {
-          throw new task_context_1.CliError({
-            message: `Failed to replace placeholder version in generated files: ${(0, core_utils_1.extractErrorMessage)(error50)}`,
-            code: task_context_1.CliError.Code.UserError
-          });
+          const header = Buffer.alloc(8192);
+          const { bytesRead } = await fileHandle.read(header, 0, 8192, 0);
+          for (let i5 = 0; i5 < bytesRead; i5++) {
+            if (header[i5] === 0) {
+              return true;
+            }
+          }
+          return false;
+        } finally {
+          await fileHandle.close();
         }
-        this.logger.debug("Placeholder version replaced successfully");
       }
       /**
        * Adds /vN suffix to Go module paths and import statements when the computed
@@ -562606,9 +562764,12 @@ var require_AutoVersioningService = __commonJS({
         const entries24 = await (0, promises_1.readdir)(dir);
         for (const entry of entries24) {
           const fullPath = (0, path_1.join)(dir, entry);
-          const entryStat = await (0, promises_1.stat)(fullPath);
+          const entryStat = await (0, promises_1.lstat)(fullPath);
+          if (entryStat.isSymbolicLink()) {
+            continue;
+          }
           if (entryStat.isDirectory()) {
-            if (entry === ".git" || entry === "vendor") {
+            if (EXCLUDED_DIRECTORIES.has(entry)) {
               continue;
             }
             const subResults = await this.walkDirectory(fullPath, filter8);
@@ -562619,14 +562780,22 @@ var require_AutoVersioningService = __commonJS({
         }
         return results;
       }
+      static CONCURRENCY_LIMIT = 32;
+      async processInParallel(items, fn2) {
+        const results = [];
+        for (let i5 = 0; i5 < items.length; i5 += _AutoVersioningService.CONCURRENCY_LIMIT) {
+          const batch = items.slice(i5, i5 + _AutoVersioningService.CONCURRENCY_LIMIT);
+          const batchResults = await Promise.all(batch.map(fn2));
+          results.push(...batchResults);
+        }
+        return results;
+      }
       /**
        * Adds a version suffix to import paths in all .go files in the repository.
        */
       async addSuffixToGoFiles(repoRoot, modulePath, suffix) {
         const goFiles = await this.walkDirectory(repoRoot, (filePath) => (0, path_1.extname)(filePath) === ".go");
-        for (const filePath of goFiles) {
-          await this.addSuffixToGoFile(filePath, modulePath, suffix);
-        }
+        await this.processInParallel(goFiles, (filePath) => this.addSuffixToGoFile(filePath, modulePath, suffix));
       }
       /**
        * Adds a version suffix to import paths in a single .go file.
@@ -562666,12 +562835,6 @@ var require_AutoVersioningService = __commonJS({
           this.logger.debug(`Updated Go imports in ${filePath}`);
         }
       }
-      /**
-       * Escapes special characters for use in sed command.
-       */
-      escapeForSed(str2) {
-        return str2.replace(/[/&]/g, "\\$&");
-      }
       /**
        * Extracts the file path from a diff file section.
        * Parses the "diff --git a/path b/path" header line.
@@ -563622,8 +563785,8 @@ var init_types191 = __esm({
 });
 
 // ../ai/lib/index.js
-var lib_exports15 = {};
-__export(lib_exports15, {
+var lib_exports14 = {};
+__export(lib_exports14, {
   VersionBump: () => VersionBump2,
   loadBamlDependencies: () => loadBamlDependencies
 });
@@ -563721,7 +563884,7 @@ var require_AutoVersionStep = __commonJS({
         const { service, language, mappedMagicVersion, commit } = params2;
         const initialVersion = this.config.baseVersion ?? (mappedMagicVersion.startsWith("v") ? "v0.0.1" : "0.0.1");
         if (!(0, index_1.isValidSemver)(initialVersion)) {
-          const errorMessage = `AutoVersionStep: baseVersion ${JSON.stringify(initialVersion)} is not a valid semver string (expected e.g. "1.2.3" or "v1.2.3"). Refusing to run to avoid shell injection into the placeholder-rewrite step.`;
+          const errorMessage = `AutoVersionStep: baseVersion ${JSON.stringify(initialVersion)} is not a valid semver string (expected e.g. "1.2.3" or "v1.2.3"). Refusing to run.`;
           this.logger.error(errorMessage);
           return {
             executed: true,
@@ -564328,7 +564491,7 @@ ${newBlock}${remainder}`;
         if (this.config.ai == null) {
           throw new Error("AutoVersionStep: ai config is missing. Set autoVersion.ai to a BAML provider+model pair.");
         }
-        const { loadBamlDependencies: loadBamlDependencies2, VersionBump: VersionBump3 } = await Promise.resolve().then(() => __importStar2((init_lib69(), __toCommonJS(lib_exports15))));
+        const { loadBamlDependencies: loadBamlDependencies2, VersionBump: VersionBump3 } = await Promise.resolve().then(() => __importStar2((init_lib69(), __toCommonJS(lib_exports14))));
         const { BamlClient, configureBamlClient: configureBamlClient2 } = await loadBamlDependencies2();
         const registry2 = configureBamlClient2(this.config.ai);
         return {
@@ -580044,7 +580207,7 @@ var require_GithubStep = __commonJS({
     exports2.shouldPushGenerationBaseTag = shouldPushGenerationBaseTag;
     exports2.resolveBranchAction = resolveBranchAction;
     var core_utils_1 = (init_lib4(), __toCommonJS(lib_exports));
-    var github_1 = (init_lib11(), __toCommonJS(lib_exports5));
+    var github_1 = (init_lib11(), __toCommonJS(lib_exports4));
     var rest_1 = (init_dist_src9(), __toCommonJS(dist_src_exports));
     var promises_1 = require("fs/promises");
     var path_1 = require("path");
@@ -580587,7 +580750,7 @@ var require_VerificationStep = __commonJS({
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.VerificationStep = void 0;
     var core_utils_1 = (init_lib4(), __toCommonJS(lib_exports));
-    var docker_utils_1 = (init_lib68(), __toCommonJS(lib_exports14));
+    var docker_utils_1 = (init_lib68(), __toCommonJS(lib_exports13));
     var logger_1 = (init_lib5(), __toCommonJS(lib_exports2));
     var fs_1 = require("fs");
     var path_1 = require("path");
@@ -607555,7 +607718,7 @@ var require_ReadmeGenerator = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.ReadmeGenerator = void 0;
-    var github_1 = (init_lib11(), __toCommonJS(lib_exports5));
+    var github_1 = (init_lib11(), __toCommonJS(lib_exports4));
     var compat_1 = require_compat2();
     var string_1 = require_string3();
     var index_js_1 = require_sdk();
@@ -608548,8 +608711,8 @@ var require_GitHub = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.GitHub = void 0;
-    var fs_utils_1 = (init_lib8(), __toCommonJS(lib_exports4));
-    var github_1 = (init_lib11(), __toCommonJS(lib_exports5));
+    var fs_utils_1 = (init_lib8(), __toCommonJS(lib_exports3));
+    var github_1 = (init_lib11(), __toCommonJS(lib_exports4));
     var rest_1 = (init_dist_src9(), __toCommonJS(dist_src_exports));
     var GitHub = class {
       githubConfig;
@@ -608740,7 +608903,7 @@ var require_replay_init = __commonJS({
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.replayInit = replayInit3;
     exports2.formatBootstrapSummary = formatBootstrapSummary3;
-    var github_1 = (init_lib11(), __toCommonJS(lib_exports5));
+    var github_1 = (init_lib11(), __toCommonJS(lib_exports4));
     var replay_1 = require_dist24();
     var fs_1 = require("fs");
     var path_1 = require("path");
@@ -611050,8 +611213,8 @@ var require_Fetcher3 = __commonJS({
         const fetchFn = runtime_1.RUNTIME.type === "node" ? (
           // `.default` is required due to this issue:
           // https://github.com/node-fetch/node-fetch/issues/450#issuecomment-387045223
-          (init_lib18(), __toCommonJS(lib_exports6)).default
-        ) : typeof fetch == "function" ? fetch : (init_lib18(), __toCommonJS(lib_exports6)).default;
+          (init_lib18(), __toCommonJS(lib_exports5)).default
+        ) : typeof fetch == "function" ? fetch : (init_lib18(), __toCommonJS(lib_exports5)).default;
         const makeRequest3 = () => __awaiter36(this, void 0, void 0, function* () {
           const controller = new AbortController();
           let abortId = void 0;
@@ -686793,7 +686956,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.55.0",
+          version: "5.55.1",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -686859,7 +687022,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.55.0",
+        version: "5.55.1",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -864646,7 +864809,7 @@ var MdxParseValidator = class {
       navigation: parsedConfig.navigation
     });
     const filesToCheck = Array.from(new Set(allPages));
-    const { parseMarkdownToTree: parseMarkdownToTree2 } = await Promise.resolve().then(() => (init_lib64(), lib_exports11));
+    const { parseMarkdownToTree: parseMarkdownToTree2 } = await Promise.resolve().then(() => (init_lib64(), lib_exports10));
     const errorOrNulls = await Promise.all(filesToCheck.map(async (filepath) => {
       const content5 = await (0, import_promises89.readFile)(filepath, "utf-8");
       try {
@@ -867953,7 +868116,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.55.0";
+  const version7 = "5.55.1";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -871602,10 +871765,24 @@ async function runAppPreviewServer({ initialProject, reloadProject, validateProj
             translatedNavbarLinks = localeNavOverlay.navbarLinks;
           }
         }
+        const baseApis = docsDefinition.apis;
         const localeApis = translatedApiDefinitions?.[locale];
-        const translatedApis = localeApis != null ? { ...docsDefinition.apis, ...localeApis } : docsDefinition.apis;
+        let servedLocaleApis = localeApis;
+        let rewritableApiIds;
         if (localeApis != null && updatedRoot != null) {
-          updatedRoot = applyTranslatedApiTitlesToNavTree(updatedRoot, docsDefinition.apis, localeApis);
+          const incompatibleApiIds = findIncompatibleTranslatedApiIds(updatedRoot, baseApis, localeApis);
+          if (incompatibleApiIds.size > 0) {
+            context3.logger.warn(`Translated API definition(s) [${Array.from(incompatibleApiIds).join(", ")}] for locale "${locale}" diverge from the default-locale spec (e.g. changed OpenAPI tag names, operationIds, or paths, or a missing/added endpoint), so they can't be fully matched to the navigation tree. Serving the default-locale API for those (localized sidebar titles are still applied where they can be matched). For fully localized API reference content, translate only human-readable text and keep tag names/operationIds/paths identical to the base spec.`);
+            servedLocaleApis = Object.fromEntries(Object.entries(localeApis).filter(([apiId]) => !incompatibleApiIds.has(apiId)));
+          }
+          rewritableApiIds = new Set(Object.keys(localeApis).filter((apiId) => !incompatibleApiIds.has(apiId)));
+        }
+        const hasServedLocaleApis = servedLocaleApis != null && Object.keys(servedLocaleApis).length > 0;
+        const translatedApis = hasServedLocaleApis ? { ...docsDefinition.apis, ...servedLocaleApis } : docsDefinition.apis;
+        if (localeApis != null && Object.keys(localeApis).length > 0 && updatedRoot != null) {
+          updatedRoot = applyTranslatedApiTitlesToNavTree(updatedRoot, baseApis, localeApis, {
+            rewritableApiIds
+          });
         }
         const translatedDefinition = {
           ...docsDefinition,
@@ -898783,8 +898960,19 @@ async function buildAllTranslationInputs({ docsDefinition, git, apiDefinitions,
             }
           }
         }
+        const incompatibleApiIds = findIncompatibleTranslatedApiIds(translatedDefinition.config.root, baseReadApis, translatedApisForTitles);
+        if (incompatibleApiIds.size > 0) {
+          context3.logger.warn(`Translated API definition(s) [${Array.from(incompatibleApiIds).join(", ")}] for locale "${locale}" diverge from the default-locale spec (e.g. changed OpenAPI tag names, operationIds, or paths, or a missing/added endpoint), so they can't be fully matched to the navigation tree. Serving the default-locale API for those (localized sidebar titles are still applied where they can be matched). For fully localized API reference content, translate only human-readable text and keep tag names/operationIds/paths identical to the base spec.`);
+          for (const apiId of incompatibleApiIds) {
+            const baseDef = apiDefinitions.get(apiId);
+            if (baseDef != null) {
+              localeApiDefinitions.set(apiId, baseDef);
+            }
+          }
+        }
+        const rewritableApiIds = new Set(Object.keys(translatedApisForTitles).filter((apiId) => !incompatibleApiIds.has(apiId)));
         if (Object.keys(translatedApisForTitles).length > 0) {
-          translatedDefinition.config.root = applyTranslatedApiTitlesToNavTree(translatedDefinition.config.root, baseReadApis, translatedApisForTitles);
+          translatedDefinition.config.root = applyTranslatedApiTitlesToNavTree(translatedDefinition.config.root, baseReadApis, translatedApisForTitles, { rewritableApiIds });
         }
       }
     }
@@ -899528,8 +899716,16 @@ ${JSON.stringify(errorDetails, void 0, 2)}`);
                 translatedApisForTitles[baseApiId] = translatedRead;
               }
             }
-            updatedRoot = Object.keys(translatedApisForTitles).length > 0 ? applyTranslatedApiTitlesToNavTree(updatedRoot, baseApisForTitles, translatedApisForTitles) : structuredClone(updatedRoot);
+            const incompatibleApiIds = findIncompatibleTranslatedApiIds(updatedRoot, baseApisForTitles, translatedApisForTitles);
+            if (incompatibleApiIds.size > 0) {
+              context3.logger.warn(`Translated API definition(s) [${Array.from(incompatibleApiIds).join(", ")}] for locale "${locale}" diverge from the default-locale spec (e.g. changed OpenAPI tag names, operationIds, or paths, or a missing/added endpoint), so they can't be fully matched to the navigation tree. Serving the default-locale API for those (localized sidebar titles are still applied where they can be matched). For fully localized API reference content, translate only human-readable text and keep tag names/operationIds/paths identical to the base spec.`);
+            }
+            const rewritableApiIds = new Set(Object.keys(translatedApisForTitles).filter((apiId) => !incompatibleApiIds.has(apiId)));
+            updatedRoot = Object.keys(translatedApisForTitles).length > 0 ? applyTranslatedApiTitlesToNavTree(updatedRoot, baseApisForTitles, translatedApisForTitles, { rewritableApiIds }) : structuredClone(updatedRoot);
             for (const [baseApiId, translatedApiId] of localeApiIdMap) {
+              if (incompatibleApiIds.has(baseApiId)) {
+                continue;
+              }
               updateApiDefinitionIdInTree(updatedRoot, baseApiId, translatedApiId);
             }
           }
@@ -900173,11 +900369,13 @@ async function runRemoteGenerationForDocsWorkspace({ organization, apiWorkspaces
     context3.failAndThrow(`More than one docs instances. Please specify one (e.g. --instance ${instances2[0]?.url})`, void 0, { code: CliError.Code.ConfigError });
     return;
   }
-  const maybeInstance = instances2.find((instance) => instance.url === instanceUrl) ?? instances2[0];
+  const maybeInstance = instanceUrl != null ? instances2.find((instance) => instance.url === instanceUrl) : instances2[0];
   if (maybeInstance == null) {
-    context3.failAndThrow(`No docs instance with url ${instanceUrl}. Failed to register.`, void 0, {
-      code: CliError.Code.ConfigError
-    });
+    const available = instances2.map((inst) => `  - ${inst.url}`).join("\n");
+    context3.failAndThrow(instanceUrl != null ? `No docs instance found matching '${instanceUrl}'.
+
+Available instances:
+${available}` : `No docs instance found. Failed to register.`, void 0, { code: CliError.Code.ConfigError });
     return;
   }
   const customDomains = (typeof maybeInstance.customDomain === "string" ? [maybeInstance.customDomain] : maybeInstance.customDomain ?? []).map(stripCustomDomainProtocol);
@@ -900272,7 +900470,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.55.0",
+        cliVersion: "5.55.1",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -966541,7 +966739,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.55.0"
+    cli_version: "5.55.1"
   };
 }
 function isAutomationMode() {
@@ -967373,7 +967571,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.55.0";
+    return "5.55.1";
   }
   getCliName() {
     if (false) {

package/package.json

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