@fern-api/fern-api-dev 4.68.4 → 4.68.5-1-g8e557fa8d81

package/cli.cjs

@@ -627016,7 +627016,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "4.68.4",
+          version: "4.68.5-1-g8e557fa8d81",
           usingAccessToken: true
         }
       });
@@ -627070,7 +627070,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "4.68.4",
+        version: "4.68.5-1-g8e557fa8d81",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -844122,7 +844122,7 @@ var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 var MAX_LOGS_DIR_SIZE_BYTES = 100 * 1024 * 1024;
 function getCliSource() {
-  const version7 = "4.68.4";
+  const version7 = "4.68.5-1-g8e557fa8d81";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -855372,7 +855372,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "4.68.4"
+        cliVersion: "4.68.5-1-g8e557fa8d81"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
         return { success: false };
@@ -928615,7 +928615,10 @@ var SentryClient = class {
     if (isTelemetryEnabled && sentryDsn != null && sentryDsn.length > 0) {
       const sentryEnvironment = "development";
       if (sentryEnvironment == null || sentryEnvironment.length === 0) {
-        throw new Error("SENTRY_ENVIRONMENT must be set when SENTRY_DSN is configured");
+        throw new CliError({
+          message: "SENTRY_ENVIRONMENT must be set when SENTRY_DSN is configured",
+          code: CliError.Code.ConfigError
+        });
       }
       this.sentry = init2({
         dsn: sentryDsn,
@@ -928654,7 +928657,10 @@ var StdoutRedirector = class {
   redirected = false;
   redirect() {
     if (this.redirected) {
-      throw new Error("StdoutRedirector: already redirected \u2014 did you forget to restore()?");
+      throw new CliError({
+        message: "StdoutRedirector: already redirected \u2014 did you forget to restore()?",
+        code: CliError.Code.InternalError
+      });
     }
     this.originalWrite = process.stdout.write;
     process.stdout.write = process.stderr.write.bind(process.stderr);
@@ -928963,7 +928969,7 @@ async function normalizeGeneratorName2(generatorImage) {
   });
   const generatorResponse = await client3.generators.getGeneratorByImage({ dockerImage: generatorImage });
   if (!generatorResponse.ok || generatorResponse.body == null) {
-    throw new Error(`Generator ${generatorImage} not found`);
+    throw new CliError({ message: `Generator ${generatorImage} not found`, code: CliError.Code.InternalError });
   }
   return generatorResponse.body.displayName;
 }
@@ -929144,9 +929150,16 @@ async function getLatestVersionOfCli({
   if (cliEnvironment.packageName !== "fern-api" || cliEnvironment.packageVersion === "0.0.0") {
     return cliEnvironment.packageVersion;
   }
-  return latestVersion(cliEnvironment.packageName, {
-    version: includePreReleases ? "prerelease" : "latest"
-  });
+  try {
+    return await latestVersion(cliEnvironment.packageName, {
+      version: includePreReleases ? "prerelease" : "latest"
+    });
+  } catch (error50) {
+    throw new CliError({
+      message: `Failed to resolve latest CLI version: ${error50 instanceof Error ? error50.message : String(error50)}`,
+      code: CliError.Code.NetworkError
+    });
+  }
 }
 
 // src/cli-context/CliContext.ts
@@ -929193,7 +929206,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "4.68.4";
+    return "4.68.5-1-g8e557fa8d81";
   }
   getCliName() {
     if (false) {
@@ -929474,7 +929487,15 @@ var CliContext = class _CliContext {
    * @returns Promise<string> representing the user's input
    */
   async getInput(config5) {
-    return await esm_default10({ message: config5.message, default: config5.default });
+    try {
+      return await esm_default10({ message: config5.message, default: config5.default });
+    } catch (error50) {
+      if (error50?.name === "ExitPromptError") {
+        this.logger.info("\nCancelled by user.");
+        throw new TaskAbortSignal();
+      }
+      throw error50;
+    }
   }
 };
 function wrapWorkspaceNameForPrefix(workspaceName) {
@@ -929689,7 +929710,9 @@ async function getGeneratorList({
   try {
     await (0, import_promises126.writeFile)(outputLocation, generatorsListYaml);
   } catch (error50) {
-    cliContext.failAndThrow(`Could not write file to the specified location: ${outputLocation}`, error50);
+    cliContext.failAndThrow(`Could not write file to the specified location: ${outputLocation}`, error50, {
+      code: CliError.Code.ConfigError
+    });
   }
 }
 function isGeneratorInModeSet(generator, modes) {
@@ -929767,7 +929790,9 @@ async function getOrganization({
   try {
     await (0, import_promises127.writeFile)(outputLocation, org);
   } catch (error50) {
-    context3.failAndThrow(`Could not write file to the specified location: ${outputLocation}`, error50);
+    context3.failAndThrow(`Could not write file to the specified location: ${outputLocation}`, error50, {
+      code: CliError.Code.ConfigError
+    });
   }
 }
 
@@ -929895,7 +929920,10 @@ async function ensureMigrationsInstalled(logger4) {
       const packageJsonContent = await (0, import_promises128.readFile)(packageJsonPath, "utf-8");
       const packageJson2 = JSON.parse(packageJsonContent);
       if (packageJson2.main == null) {
-        throw new Error(`No main field found in package.json for ${MIGRATION_PACKAGE_NAME2}`);
+        throw new CliError({
+          message: `No main field found in package.json for ${MIGRATION_PACKAGE_NAME2}`,
+          code: CliError.Code.InternalError
+        });
       }
       const packageEntryPoint = (0, import_path78.join)(packageDir, packageJson2.main);
       const { migrations } = await import((0, import_url9.pathToFileURL)(packageEntryPoint).href);
@@ -929968,9 +929996,10 @@ function filterMigrations(params2) {
     const aVersion = import_semver16.default.parse(a10.version);
     const bVersion = import_semver16.default.parse(b19.version);
     if (aVersion == null || bVersion == null) {
-      throw new Error(
-        `Internal error: Invalid migration version found during sort. Version A: ${a10.version}, Version B: ${b19.version}. This should not happen as invalid versions are filtered out.`
-      );
+      throw new CliError({
+        message: `Internal error: Invalid migration version found during sort. Version A: ${a10.version}, Version B: ${b19.version}. This should not happen as invalid versions are filtered out.`,
+        code: CliError.Code.InternalError
+      });
     }
     return import_semver16.default.compare(aVersion, bVersion);
   });
@@ -929988,15 +930017,16 @@ function runMigrations(params2) {
       appliedVersions.push(migration23.version);
     } catch (error50) {
       const errorMessage = extractErrorMessage(error50);
-      throw new Error(
-        `Failed to apply migration for version ${migration23.version}.
+      throw new CliError({
+        message: `Failed to apply migration for version ${migration23.version}.
 
 Reason: ${errorMessage}
 
 This migration was attempting to update your generator configuration. The upgrade has been halted to prevent partial or invalid changes.
 
-Please report this issue at: https://github.com/fern-api/fern/issues`
-      );
+Please report this issue at: https://github.com/fern-api/fern/issues`,
+        code: CliError.Code.InternalError
+      });
     }
   }
   return {
@@ -930016,13 +930046,14 @@ function isValidGeneratorConfig(config5) {
 async function loadAndRunMigrations(params2) {
   const { generatorName, from: from4, to: to8, config: config5, logger: logger4 } = params2;
   if (!isValidGeneratorConfig(config5)) {
-    throw new Error(
-      `Invalid generator configuration for ${generatorName}.
+    throw new CliError({
+      message: `Invalid generator configuration for ${generatorName}.
 
 The generator configuration must be an object with either a 'name' property or an 'image' property, but the current configuration does not match this structure. This may indicate a malformed generators.yml file.
 
-Please check your generators.yml file and ensure the generator is properly configured.`
-    );
+Please check your generators.yml file and ensure the generator is properly configured.`,
+      code: CliError.Code.InternalError
+    });
   }
   const typedConfig = config5;
   const migrationModule = await loadMigrationModule({ generatorName, logger: logger4 });
@@ -930087,7 +930118,9 @@ async function loadAndUpdateGenerators({
     };
   }
   if (!import_yaml6.default.isMap(generatorGroups)) {
-    context3.failAndThrow(`Expected 'groups' to be a map in ${import_path79.default.relative(process.cwd(), filepath)}`);
+    context3.failAndThrow(`Expected 'groups' to be a map in ${import_path79.default.relative(process.cwd(), filepath)}`, void 0, {
+      code: CliError.Code.ParseError
+    });
     return {
       updatedConfiguration: void 0,
       skippedMajorUpgrades: [],
@@ -930106,7 +930139,9 @@ async function loadAndUpdateGenerators({
     const group = groupBlock.value;
     if (!import_yaml6.default.isMap(group)) {
       context3.failAndThrow(
-        `Expected group ${groupName} to be a map in ${import_path79.default.relative(process.cwd(), filepath)}`
+        `Expected group ${groupName} to be a map in ${import_path79.default.relative(process.cwd(), filepath)}`,
+        void 0,
+        { code: CliError.Code.ConfigError }
       );
       continue;
     }
@@ -930117,7 +930152,9 @@ async function loadAndUpdateGenerators({
     const generators = group.get("generators");
     if (!import_yaml6.default.isSeq(generators)) {
       context3.failAndThrow(
-        `Expected group ${groupName} to have a 'generators' key in ${import_path79.default.relative(process.cwd(), filepath)}`
+        `Expected group ${groupName} to have a 'generators' key in ${import_path79.default.relative(process.cwd(), filepath)}`,
+        void 0,
+        { code: CliError.Code.ConfigError }
       );
       continue;
     }
@@ -930125,7 +930162,9 @@ async function loadAndUpdateGenerators({
     for (const generator of generators.items) {
       if (!import_yaml6.default.isMap(generator)) {
         context3.failAndThrow(
-          `Expected generator in group ${groupName} to be a map in ${import_path79.default.relative(process.cwd(), filepath)}`
+          `Expected generator in group ${groupName} to be a map in ${import_path79.default.relative(process.cwd(), filepath)}`,
+          void 0,
+          { code: CliError.Code.VersionError }
         );
       }
       if (generator.get("image") != null) {
@@ -930659,7 +930698,9 @@ function addGeneratorCommands(cli, cliContext) {
         if (generator == null) {
           const maybeApiFilter = argv.api ? ` for API ${argv.api}` : "";
           cliContext.failAndThrow(
-            `Generator ${argv.generator}, in group ${argv.group}${maybeApiFilter} was not found.`
+            `Generator ${argv.generator}, in group ${argv.group}${maybeApiFilter} was not found.`,
+            void 0,
+            { code: CliError.Code.ConfigError }
           );
         }
         const generatorMetadata = {};
@@ -930703,7 +930744,8 @@ function addGeneratorCommands(cli, cliContext) {
           } catch (error50) {
             cliContext.failAndThrow(
               `Could not write file to the specified location: ${argv.output}`,
-              error50
+              error50,
+              { code: CliError.Code.ConfigError }
             );
           }
         }
@@ -930780,7 +930822,9 @@ async function diff({
   const bump = bumpOrUndefined ?? "patch";
   const nextVersion = import_semver18.default.inc(fromVersion, bump);
   if (!nextVersion) {
-    context3.failWithoutThrowing(`Invalid current version: ${fromVersion}`);
+    context3.failWithoutThrowing(`Invalid current version: ${fromVersion}`, void 0, {
+      code: CliError.Code.VersionError
+    });
     throw new TaskAbortSignal();
   }
   return { bump, nextVersion, errors: errors4 };
@@ -930792,13 +930836,27 @@ async function readIr({
 }) {
   const absoluteFilepath = AbsoluteFilePath2.of(resolve6(cwd(), filepath));
   if (!await doesPathExist(absoluteFilepath, "file")) {
-    context3.failWithoutThrowing(`File not found: ${absoluteFilepath}`);
+    context3.failWithoutThrowing(`File not found: ${absoluteFilepath}`, void 0, {
+      code: CliError.Code.ConfigError
+    });
+    throw new TaskAbortSignal();
+  }
+  let ir15;
+  try {
+    ir15 = await streamObjectFromFile(absoluteFilepath);
+  } catch (error50) {
+    context3.failWithoutThrowing(
+      `Failed to parse IR file ${absoluteFilepath}: ${error50 instanceof Error ? error50.message : String(error50)}`,
+      error50,
+      { code: CliError.Code.ParseError }
+    );
     throw new TaskAbortSignal();
   }
-  const ir15 = await streamObjectFromFile(absoluteFilepath);
   const parsed = serialization_exports2.IntermediateRepresentation.parse(ir15);
   if (!parsed.ok) {
-    context3.failWithoutThrowing(`Invalid --${flagName}; expected a filepath containing a valid IR`);
+    context3.failWithoutThrowing(`Invalid --${flagName}; expected a filepath containing a valid IR`, void 0, {
+      code: CliError.Code.ParseError
+    });
     throw new TaskAbortSignal();
   }
   return parsed.value;
@@ -930864,7 +930922,9 @@ function diffGeneratorVersions(context3, generatorVersions) {
       errors: errors4
     };
   } catch (error50) {
-    context3.failWithoutThrowing(`Error diffing generator versions ${from4} and ${to8}: ${error50}`);
+    context3.failWithoutThrowing(`Error diffing generator versions ${from4} and ${to8}: ${error50}`, void 0, {
+      code: CliError.Code.InternalError
+    });
     throw new TaskAbortSignal();
   }
 }
@@ -930894,7 +930954,7 @@ async function collectDocsWorkspaceViolations({
 }) {
   if (workspace.config.settings?.substituteEnvVars) {
     workspace.config = replaceEnvVariables(workspace.config, {
-      onError: (e6) => context3.failAndThrow(e6)
+      onError: (e6) => context3.failAndThrow(e6, void 0, { code: CliError.Code.ValidationError })
     });
   }
   const startTime = performance.now();
@@ -930929,7 +930989,7 @@ async function validateDocsWorkspaceWithoutExiting({
 }) {
   if (workspace.config.settings?.substituteEnvVars) {
     workspace.config = replaceEnvVariables(workspace.config, {
-      onError: (e6) => context3.failAndThrow(e6)
+      onError: (e6) => context3.failAndThrow(e6, void 0, { code: CliError.Code.ValidationError })
     });
   }
   const startTime = performance.now();
@@ -930974,7 +931034,7 @@ async function validateDocsWorkspaceAndLogIssues({
     excludeRules
   });
   if (hasErrors) {
-    context3.failAndThrow();
+    context3.failAndThrow(void 0, void 0, { code: CliError.Code.ValidationError });
   }
 }
 
@@ -931108,7 +931168,10 @@ async function getSlugForFiles({
   });
   if (!response.ok) {
     const errorText = await response.text();
-    throw new Error(`Failed to get slugs for files: ${response.status} ${response.statusText} - ${errorText}`);
+    throw new CliError({
+      message: `Failed to get slugs for files: ${response.status} ${response.statusText} - ${errorText}`,
+      code: CliError.Code.InternalError
+    });
   }
   return await response.json();
 }
@@ -931357,11 +931420,11 @@ async function generateComparisons({
 }
 function getProductionUrlInfo(docsConfig) {
   if (docsConfig.instances == null || docsConfig.instances.length === 0) {
-    throw new Error("No docs instances configured in docs.yml");
+    throw new CliError({ message: "No docs instances configured in docs.yml", code: CliError.Code.InternalError });
   }
   const firstInstance = docsConfig.instances[0];
   if (firstInstance == null) {
-    throw new Error("No docs instances configured in docs.yml");
+    throw new CliError({ message: "No docs instances configured in docs.yml", code: CliError.Code.InternalError });
   }
   const instanceUrl = firstInstance["custom-domain"] ?? firstInstance.url;
   let normalizedUrl = instanceUrl;
@@ -931386,14 +931449,18 @@ async function docsDiff({
 }) {
   const docsWorkspace = project.docsWorkspaces;
   if (docsWorkspace == null) {
-    cliContext.failAndThrow("No docs workspace found. Make sure you have a docs.yml file.");
+    cliContext.failAndThrow("No docs workspace found. Make sure you have a docs.yml file.", void 0, {
+      code: CliError.Code.ConfigError
+    });
     return { diffs: [] };
   }
   const token = await cliContext.runTask(async (context3) => {
     return askToLogin(context3);
   });
   if (token == null) {
-    cliContext.failAndThrow("Failed to authenticate. Please run 'fern login' first.");
+    cliContext.failAndThrow("Failed to authenticate. Please run 'fern login' first.", void 0, {
+      code: CliError.Code.AuthError
+    });
     return { diffs: [] };
   }
   const fernToken = process.env.FERN_TOKEN ?? token.value;
@@ -935838,7 +935905,7 @@ function createLibraryDocsClient({ token }) {
     });
     if (!response.ok) {
       const text9 = await response.text().catch(() => "");
-      throw new Error(`HTTP ${response.status}: ${text9}`);
+      throw new CliError({ message: `HTTP ${response.status}: ${text9}`, code: CliError.Code.NetworkError });
     }
     return await response.json();
   }
@@ -935862,21 +935929,27 @@ var POLL_TIMEOUT_MS = 3 * 60 * 1e3;
 async function generateLibraryDocs({ project, cliContext, library }) {
   const docsWorkspace = project.docsWorkspaces;
   if (docsWorkspace == null) {
-    cliContext.failAndThrow("No docs workspace found. Make sure you have a docs.yml file.");
+    cliContext.failAndThrow("No docs workspace found. Make sure you have a docs.yml file.", void 0, {
+      code: CliError.Code.ConfigError
+    });
     return;
   }
   const rawConfig = docsWorkspace.config;
   const libraries = rawConfig.libraries;
   if (libraries == null || Object.keys(libraries).length === 0) {
     cliContext.failAndThrow(
-      "No libraries configured in docs.yml. Add a `libraries` section to configure library documentation."
+      "No libraries configured in docs.yml. Add a `libraries` section to configure library documentation.",
+      void 0,
+      { code: CliError.Code.ConfigError }
     );
     return;
   }
   const librariesToGenerate = library != null ? { [library]: libraries[library] } : libraries;
   if (library != null && libraries[library] == null) {
     cliContext.failAndThrow(
-      `Library '${library}' not found in docs.yml. Available libraries: ${Object.keys(libraries).join(", ")}`
+      `Library '${library}' not found in docs.yml. Available libraries: ${Object.keys(libraries).join(", ")}`,
+      void 0,
+      { code: CliError.Code.ConfigError }
     );
     return;
   }
@@ -935884,7 +935957,9 @@ async function generateLibraryDocs({ project, cliContext, library }) {
     return askToLogin(context3);
   });
   if (token == null) {
-    cliContext.failAndThrow("Failed to authenticate. Please run 'fern login' first.");
+    cliContext.failAndThrow("Failed to authenticate. Please run 'fern login' first.", void 0, {
+      code: CliError.Code.AuthError
+    });
     return;
   }
   const orgId = project.config.organization;
@@ -935896,7 +935971,9 @@ async function generateLibraryDocs({ project, cliContext, library }) {
         }
         if (!isGitLibraryInput2(config5.input)) {
           context3.failAndThrow(
-            `Library '${name2}' uses 'path' input which is not yet supported. Please use 'git' input.`
+            `Library '${name2}' uses 'path' input which is not yet supported. Please use 'git' input.`,
+            void 0,
+            { code: CliError.Code.ConfigError }
           );
           return false;
         }
@@ -935929,7 +936006,9 @@ async function generateSingleLibrary({
   return context3.runInteractiveTask({ name: name2 }, async (interactiveTaskContext) => {
     if (config5.config?.doxyfile != null && config5.lang !== "cpp") {
       return interactiveTaskContext.failAndThrow(
-        `Library '${name2}': 'doxyfile' config is only valid for lang: cpp`
+        `Library '${name2}': 'doxyfile' config is only valid for lang: cpp`,
+        void 0,
+        { code: CliError.Code.ConfigError }
       );
     }
     let doxyfileContent;
@@ -935939,13 +936018,19 @@ async function generateSingleLibrary({
         doxyfileContent = await (0, import_promises133.readFile)(doxyfilePath, "utf-8");
       } catch {
         return interactiveTaskContext.failAndThrow(
-          `Library '${name2}': Could not read Doxyfile at '${config5.config.doxyfile}' (resolved to ${doxyfilePath})`
+          `Library '${name2}': Could not read Doxyfile at '${config5.config.doxyfile}' (resolved to ${doxyfilePath})`,
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       }
     }
     const language = config5.lang === "python" ? "PYTHON" : config5.lang === "cpp" ? "CPP" : void 0;
     if (language == null) {
-      return interactiveTaskContext.failAndThrow(`Library '${name2}': unsupported language '${config5.lang}'`);
+      return interactiveTaskContext.failAndThrow(
+        `Library '${name2}': unsupported language '${config5.lang}'`,
+        void 0,
+        { code: CliError.Code.ConfigError }
+      );
     }
     const client3 = createLibraryDocsClient({ token: token.value });
     interactiveTaskContext.logger.debug(`Starting generation for library '${name2}' from ${gitInput.git}`);
@@ -935985,7 +936070,11 @@ To include in your docs navigation, add to docs.yml:
       });
       interactiveTaskContext.logger.debug(`Generated ${generateResult.pageCount} pages at ${resolvedOutputPath}`);
     } else {
-      return interactiveTaskContext.failAndThrow(`Library '${name2}': unsupported language '${config5.lang}'`);
+      return interactiveTaskContext.failAndThrow(
+        `Library '${name2}': unsupported language '${config5.lang}'`,
+        void 0,
+        { code: CliError.Code.ConfigError }
+      );
     }
   });
 }
@@ -936007,7 +936096,9 @@ async function startGeneration(client3, context3, opts) {
     return result.jobId;
   } catch (error50) {
     return context3.failAndThrow(
-      `Failed to start generation for library '${opts.name}': ${extractErrorMessage(error50)}`
+      `Failed to start generation for library '${opts.name}': ${extractErrorMessage(error50)}`,
+      error50,
+      { code: CliError.Code.NetworkError }
     );
   }
 }
@@ -936020,7 +936111,9 @@ async function pollForCompletion(client3, jobId, libraryName, context3) {
       status = await client3.getLibraryDocsGenerationStatus({ jobId });
     } catch (error50) {
       return context3.failAndThrow(
-        `Failed to check generation status for library '${libraryName}': ${extractErrorMessage(error50)}`
+        `Failed to check generation status for library '${libraryName}': ${extractErrorMessage(error50)}`,
+        error50,
+        { code: CliError.Code.NetworkError }
       );
     }
     switch (status.status) {
@@ -936035,15 +936128,23 @@ async function pollForCompletion(client3, jobId, libraryName, context3) {
         return;
       case "FAILED":
         return context3.failAndThrow(
-          `Generation failed for library '${libraryName}': ${status.error?.message ?? "Unknown error"} (${status.error?.code ?? "UNKNOWN"})`
+          `Generation failed for library '${libraryName}': ${status.error?.message ?? "Unknown error"} (${status.error?.code ?? "UNKNOWN"})`,
+          void 0,
+          { code: CliError.Code.InternalError }
         );
       default:
         return context3.failAndThrow(
-          `Unexpected generation status for library '${libraryName}': ${status.status}`
+          `Unexpected generation status for library '${libraryName}': ${status.status}`,
+          void 0,
+          { code: CliError.Code.InternalError }
         );
     }
   }
-  return context3.failAndThrow(`Generation timed out for library '${libraryName}' after ${POLL_TIMEOUT_MS / 1e3}s`);
+  return context3.failAndThrow(
+    `Generation timed out for library '${libraryName}' after ${POLL_TIMEOUT_MS / 1e3}s`,
+    void 0,
+    { code: CliError.Code.NetworkError }
+  );
 }
 async function downloadIr(client3, jobId, libraryName, language, context3) {
   let resultUrl;
@@ -936052,29 +936153,39 @@ async function downloadIr(client3, jobId, libraryName, language, context3) {
     resultUrl = result.resultUrl;
   } catch (error50) {
     return context3.failAndThrow(
-      `Failed to fetch generation result for library '${libraryName}': ${extractErrorMessage(error50)}`
+      `Failed to fetch generation result for library '${libraryName}': ${extractErrorMessage(error50)}`,
+      error50,
+      { code: CliError.Code.NetworkError }
     );
   }
   context3.logger.debug(`Fetching IR from ${resultUrl}`);
   const irFetchResponse = await fetch(resultUrl);
   if (!irFetchResponse.ok) {
     return context3.failAndThrow(
-      `Failed to download IR for library '${libraryName}': HTTP ${irFetchResponse.status}`
+      `Failed to download IR for library '${libraryName}': HTTP ${irFetchResponse.status}`,
+      void 0,
+      { code: CliError.Code.NetworkError }
     );
   }
   const irWrapper = await irFetchResponse.json();
   const ir15 = irWrapper.ir;
   if (ir15 == null) {
-    return context3.failAndThrow(`IR is empty for library '${libraryName}'`);
+    return context3.failAndThrow(`IR is empty for library '${libraryName}'`, void 0, {
+      code: CliError.Code.InternalError
+    });
   }
   if (language === "CPP") {
     if (ir15.rootNamespace == null) {
-      return context3.failAndThrow(`IR has no rootNamespace for C++ library '${libraryName}'`);
+      return context3.failAndThrow(`IR has no rootNamespace for C++ library '${libraryName}'`, void 0, {
+        code: CliError.Code.InternalError
+      });
     }
     context3.logger.debug(`Downloaded C++ IR for '${libraryName}'`);
   } else {
     if (ir15.rootModule == null) {
-      return context3.failAndThrow(`IR has no rootModule for library '${libraryName}'`);
+      return context3.failAndThrow(`IR has no rootModule for library '${libraryName}'`, void 0, {
+        code: CliError.Code.InternalError
+      });
     }
     context3.logger.debug(`Downloaded IR with ${Object.keys(ir15.rootModule).length} top-level keys`);
   }
@@ -936105,7 +936216,9 @@ async function deleteDocsPreview({
       `Invalid preview URL: ${previewUrl}
 Only preview sites can be deleted with this command.
 Preview URLs follow the pattern: {org}-preview-{hash}.docs.buildwithfern.com
-Example: acme-preview-abc123.docs.buildwithfern.com`
+Example: acme-preview-abc123.docs.buildwithfern.com`,
+      void 0,
+      { code: CliError.Code.ConfigError }
     );
     return;
   }
@@ -936113,7 +936226,9 @@ Example: acme-preview-abc123.docs.buildwithfern.com`
     return askToLogin(context3);
   });
   if (token == null) {
-    cliContext.failAndThrow("Failed to authenticate. Please run 'fern login' first.");
+    cliContext.failAndThrow("Failed to authenticate. Please run 'fern login' first.", void 0, {
+      code: CliError.Code.AuthError
+    });
     return;
   }
   await cliContext.runTask(async (context3) => {
@@ -936128,12 +936243,18 @@ Example: acme-preview-abc123.docs.buildwithfern.com`
       switch (deleteResponse.error.error) {
         case "UnauthorizedError":
           return context3.failAndThrow(
-            "You do not have permissions to delete this preview site. Reach out to support@buildwithfern.com"
+            "You do not have permissions to delete this preview site. Reach out to support@buildwithfern.com",
+            void 0,
+            { code: CliError.Code.NetworkError }
           );
         case "DocsNotFoundError":
-          return context3.failAndThrow(`Preview site not found: ${previewUrl}`);
+          return context3.failAndThrow(`Preview site not found: ${previewUrl}`, void 0, {
+            code: CliError.Code.ConfigError
+          });
         default:
-          return context3.failAndThrow(`Failed to delete preview site: ${previewUrl}`, deleteResponse.error);
+          return context3.failAndThrow(`Failed to delete preview site: ${previewUrl}`, deleteResponse.error, {
+            code: CliError.Code.NetworkError
+          });
       }
     }
   });
@@ -936149,7 +936270,9 @@ async function listDocsPreview({
     return askToLogin(context3);
   });
   if (token == null) {
-    cliContext.failAndThrow("Failed to authenticate. Please run 'fern login' first.");
+    cliContext.failAndThrow("Failed to authenticate. Please run 'fern login' first.", void 0, {
+      code: CliError.Code.AuthError
+    });
     return;
   }
   await cliContext.runTask(async (context3) => {
@@ -936164,14 +936287,17 @@ async function listDocsPreview({
       switch (listResponse.error.error) {
         case "UnauthorizedError":
           return context3.failAndThrow(
-            "Unauthorized to list preview deployments. Please run 'fern login' to refresh your credentials, or set the FERN_TOKEN environment variable."
+            "Unauthorized to list preview deployments. Please run 'fern login' to refresh your credentials, or set the FERN_TOKEN environment variable.",
+            void 0,
+            { code: CliError.Code.NetworkError }
           );
         default: {
           const errorContent = listResponse.error.content != null && typeof listResponse.error.content === "object" && "body" in listResponse.error.content ? listResponse.error.content.body : listResponse.error.content;
           context3.logger.debug(`Error fetching preview deployments: ${JSON.stringify(errorContent)}`);
           return context3.failAndThrow(
             "Failed to fetch preview deployments. Please ensure you are logged in with 'fern login' or have FERN_TOKEN set, then try again.",
-            listResponse.error
+            listResponse.error,
+            { code: CliError.Code.NetworkError }
           );
         }
       }
@@ -936935,11 +937061,15 @@ async function downgrade({
   targetVersion
 }) {
   if (!targetVersion) {
-    return cliContext.failAndThrow("Please specify a version to downgrade to using --version");
+    return cliContext.failAndThrow("Please specify a version to downgrade to using --version", void 0, {
+      code: CliError.Code.ConfigError
+    });
   }
   const fernDirectory = await getFernDirectory();
   if (fernDirectory == null) {
-    return cliContext.failAndThrow(`Directory "${FERN_DIRECTORY}" not found.`);
+    return cliContext.failAndThrow(`Directory "${FERN_DIRECTORY}" not found.`, void 0, {
+      code: CliError.Code.ConfigError
+    });
   }
   const projectConfig = await cliContext.runTask(
     (context3) => loadProjectConfig({ directory: fernDirectory, context: context3 })
@@ -937017,7 +937147,10 @@ function convertType4(typeDeclaration2, ir15) {
       return convertUndiscriminatedUnion2({ undiscriminatedUnionDeclaration, docs });
     },
     _other: () => {
-      throw new Error("Encountered unknown type: " + shape.type);
+      throw new CliError({
+        message: "Encountered unknown type: " + shape.type,
+        code: CliError.Code.InternalError
+      });
     }
   });
   return {
@@ -937086,7 +937219,10 @@ function convertUnion({
         required: [getWireValue(unionTypeDeclaration.discriminant)]
       }),
       _other: () => {
-        throw new Error("Unknown SingleUnionTypeProperties: " + singleUnionType.shape.propertiesType);
+        throw new CliError({
+          message: "Unknown SingleUnionTypeProperties: " + singleUnionType.shape.propertiesType,
+          code: CliError.Code.InternalError
+        });
       }
     });
   });
@@ -937137,7 +937273,10 @@ function convertTypeReference4(typeReference2) {
       return {};
     },
     _other: () => {
-      throw new Error("Encountered unknown typeReference: " + typeReference2.type);
+      throw new CliError({
+        message: "Encountered unknown typeReference: " + typeReference2.type,
+        code: CliError.Code.InternalError
+      });
     }
   });
 }
@@ -937222,7 +937361,10 @@ function convertPrimitiveType3(primitiveType2) {
         };
       },
       _other: () => {
-        throw new Error("Encountered unknown primitiveType: " + primitiveType2.v1);
+        throw new CliError({
+          message: "Encountered unknown primitiveType: " + primitiveType2.v1,
+          code: CliError.Code.InternalError
+        });
       }
     }) ?? {};
   }
@@ -937312,7 +937454,10 @@ function convertPrimitiveType3(primitiveType2) {
       };
     },
     _other: () => {
-      throw new Error("Encountered unknown primitiveType: " + primitiveType2.v2);
+      throw new CliError({
+        message: "Encountered unknown primitiveType: " + primitiveType2.v2,
+        code: CliError.Code.InternalError
+      });
     }
   });
 }
@@ -937372,7 +937517,10 @@ function convertContainerType3(containerType) {
       });
     },
     _other: () => {
-      throw new Error("Encountered unknown containerType: " + containerType.type);
+      throw new CliError({
+        message: "Encountered unknown containerType: " + containerType.type,
+        code: CliError.Code.InternalError
+      });
     }
   });
 }
@@ -937491,7 +937639,10 @@ function convertServices2({
       });
       const pathsObject = paths[fullPath] ??= {};
       if (pathsObject[convertedHttpMethod] != null) {
-        throw new Error(`Duplicate ${convertedHttpMethod} endpoint at ${fullPath}`);
+        throw new CliError({
+          message: `Duplicate ${convertedHttpMethod} endpoint at ${fullPath}`,
+          code: CliError.Code.ConfigError
+        });
       }
       pathsObject[convertedHttpMethod] = operationObject;
     });
@@ -937576,12 +937727,15 @@ function convertHttpEndpoint4({
   if (httpEndpoint.baseUrl != null) {
     const baseUrlId = httpEndpoint.baseUrl;
     if (environments2?.environments.type !== "multipleBaseUrls") {
-      throw new Error("baseUrl is defined environments are not multipleBaseUrls");
+      throw new CliError({
+        message: "baseUrl is defined environments are not multipleBaseUrls",
+        code: CliError.Code.InternalError
+      });
     }
     operationObject.servers = environments2.environments.environments.map((environment2) => {
       const url3 = environment2.urls[baseUrlId];
       if (url3 == null) {
-        throw new Error("No URL defined for " + baseUrlId);
+        throw new CliError({ message: "No URL defined for " + baseUrlId, code: CliError.Code.InternalError });
       }
       const server = { url: url3 };
       if (environment2.docs != null) {
@@ -937627,7 +937781,10 @@ function convertHttpMethod3(httpMethod) {
       return import_openapi_types3.OpenAPIV3.HttpMethods.HEAD;
     },
     _other: () => {
-      throw new Error("Encountered unknown http method: " + httpMethod);
+      throw new CliError({
+        message: "Encountered unknown http method: " + httpMethod,
+        code: CliError.Code.InternalError
+      });
     }
   });
 }
@@ -937719,7 +937876,10 @@ function convertRequestBody4({
                     };
                   },
                   _other: () => {
-                    throw new Error("Unknown FileUploadRequestProperty: " + property23.type);
+                    throw new CliError({
+                      message: "Unknown FileUploadRequestProperty: " + property23.type,
+                      code: CliError.Code.InternalError
+                    });
                   }
                 });
                 return {
@@ -937747,7 +937907,10 @@ function convertRequestBody4({
       };
     },
     _other: () => {
-      throw new Error("Unknown HttpRequestBody type: " + httpRequest2.type);
+      throw new CliError({
+        message: "Unknown HttpRequestBody type: " + httpRequest2.type,
+        code: CliError.Code.InternalError
+      });
     }
   });
 }
@@ -937847,9 +938010,10 @@ function convertResponse3({
       for (const responseError of responseErrors) {
         const errorDeclaration = errorsByName[getErrorTypeNameKey(responseError.error)];
         if (errorDeclaration == null) {
-          throw new Error(
-            "Encountered undefined error declaration: " + getOriginalName(responseError.error.name)
-          );
+          throw new CliError({
+            message: "Encountered undefined error declaration: " + getOriginalName(responseError.error.name),
+            code: CliError.Code.ResolutionError
+          });
         }
         const responseForStatusCode = {
           description: responseError.docs ?? ""
@@ -937931,7 +938095,10 @@ function convertResponse3({
       }
     },
     _other: () => {
-      throw new Error("Unknown error discrimination strategy: " + errorDiscriminationStrategy.type);
+      throw new CliError({
+        message: "Unknown error discrimination strategy: " + errorDiscriminationStrategy.type,
+        code: CliError.Code.InternalError
+      });
     }
   });
   return responseByStatusCode;
@@ -937965,7 +938132,10 @@ function getErrorInfoByStatusCode({
   for (const responseError of responseErrors) {
     const errorDeclaration = errorsByName[getErrorTypeNameKey(responseError.error)];
     if (errorDeclaration == null) {
-      throw new Error("Encountered undefined error declaration: " + getOriginalName(responseError.error.name));
+      throw new CliError({
+        message: "Encountered undefined error declaration: " + getOriginalName(responseError.error.name),
+        code: CliError.Code.ResolutionError
+      });
     }
     const statusCode = errorDeclaration.statusCode;
     const statusCodeErrorInfo = errorInfoByStatusCode[statusCode];
@@ -938106,7 +938276,10 @@ function isTypeReferenceRequired({
     const key2 = getDeclaredTypeNameKey(typeReference2);
     const typeDeclaration2 = typesByName[key2];
     if (typeDeclaration2 == null) {
-      throw new Error("Encountered non-existent type: " + getOriginalName(typeReference2.name));
+      throw new CliError({
+        message: "Encountered non-existent type: " + getOriginalName(typeReference2.name),
+        code: CliError.Code.ResolutionError
+      });
     }
     if (typeDeclaration2.shape.type === "alias") {
       return isTypeReferenceRequired({ typeReference: typeDeclaration2.shape.aliasOf, typesByName });
@@ -938136,7 +938309,10 @@ function constructEndpointSecurity(apiAuth) {
       return [];
     },
     _other: () => {
-      throw new Error("Unknown auth scheme requirement: " + apiAuth.requirement);
+      throw new CliError({
+        message: "Unknown auth scheme requirement: " + apiAuth.requirement,
+        code: CliError.Code.InternalError
+      });
     }
   });
 }
@@ -938163,7 +938339,10 @@ function constructSecuritySchemes(apiAuth) {
       }),
       inferred: () => void 0,
       _other: () => {
-        throw new Error("Unknown auth scheme: " + scheme.type);
+        throw new CliError({
+          message: "Unknown auth scheme: " + scheme.type,
+          code: CliError.Code.InternalError
+        });
       }
     });
     if (oasScheme) {
@@ -938180,7 +938359,10 @@ function getNameForAuthScheme(authScheme) {
     oauth: () => "BearerAuth",
     header: (header) => `${getPascalCaseUnsafe(header.name)}Auth`,
     _other: () => {
-      throw new Error("Unknown auth scheme: " + authScheme.type);
+      throw new CliError({
+        message: "Unknown auth scheme: " + authScheme.type,
+        code: CliError.Code.InternalError
+      });
     }
   });
 }
@@ -938499,7 +938681,7 @@ async function generateWorkspace({
       const suggestedCommand = `fern ${currentArgs} --${GROUP_CLI_OPTION} ${name2}`;
       return ` \u203A ${source_default.bold(name2.padEnd(longestGroupName))}  ${source_default.dim(suggestedCommand)}`;
     }).join("\n");
-    return context3.failAndThrow(message);
+    return context3.failAndThrow(message, void 0, { code: CliError.Code.NetworkError });
   }
   const resolvedGroupNames = resolveGroupAlias(
     groupNameOrDefault,
@@ -938509,7 +938691,7 @@ async function generateWorkspace({
   );
   const { ai: ai7, replay } = workspace.generatorsConfiguration;
   if (!useLocalDocker && !token) {
-    return context3.failAndThrow("Please run fern login");
+    return context3.failAndThrow("Please run fern login", void 0, { code: CliError.Code.AuthError });
   }
   await Promise.all(
     resolvedGroupNames.map(async (resolvedGroupName) => {
@@ -938517,7 +938699,9 @@ async function generateWorkspace({
         (otherGroup) => otherGroup.groupName === resolvedGroupName
       );
       if (group == null) {
-        return context3.failAndThrow(`Group '${resolvedGroupName}' does not exist.`);
+        return context3.failAndThrow(`Group '${resolvedGroupName}' does not exist.`, void 0, {
+          code: CliError.Code.ConfigError
+        });
       }
       const filterResult = filterGenerators({
         generators: group.generators,
@@ -938526,7 +938710,7 @@ async function generateWorkspace({
         groupName: resolvedGroupName
       });
       if (!filterResult.ok) {
-        return context3.failAndThrow(filterResult.error);
+        return context3.failAndThrow(filterResult.error, void 0, { code: CliError.Code.ConfigError });
       }
       group = { ...group, generators: filterResult.generators };
       if (lfsOverride != null) {
@@ -938595,7 +938779,9 @@ function resolveGroupAlias(groupNameOrAlias, groupAliases, availableGroups, cont
     for (const groupName of aliasGroups) {
       if (!availableGroups.includes(groupName)) {
         context3.failAndThrow(
-          `Group alias '${groupNameOrAlias}' references non-existent group '${groupName}'. Available groups: ${availableGroups.join(", ")}`
+          `Group alias '${groupNameOrAlias}' references non-existent group '${groupName}'. Available groups: ${availableGroups.join(", ")}`,
+          void 0,
+          { code: CliError.Code.NetworkError }
         );
       }
     }
@@ -938607,7 +938793,9 @@ function resolveGroupAlias(groupNameOrAlias, groupAliases, availableGroups, cont
   const availableAliases = Object.keys(groupAliases);
   const suggestions = [...availableGroups, ...availableAliases];
   context3.failAndThrow(
-    `'${groupNameOrAlias}' is not a valid group or alias. Available groups: ${availableGroups.join(", ")}` + (availableAliases.length > 0 ? `. Available aliases: ${availableAliases.join(", ")}` : "")
+    `'${groupNameOrAlias}' is not a valid group or alias. Available groups: ${availableGroups.join(", ")}` + (availableAliases.length > 0 ? `. Available aliases: ${availableAliases.join(", ")}` : ""),
+    void 0,
+    { code: CliError.Code.NetworkError }
   );
   return [];
 }
@@ -938742,7 +938930,7 @@ async function generateAPIWorkspaces({
           force
         );
         if (!shouldProceed) {
-          cliContext.failAndThrow("Generation cancelled");
+          cliContext.failAndThrow("Generation cancelled", void 0, { code: CliError.Code.ConfigError });
         }
       }
     }
@@ -938921,7 +939109,10 @@ function buildPreviewDomain({ orgId, previewId }) {
   const availableSpace = SUBDOMAIN_LIMIT - prefix2.length;
   const minIdLength = 8;
   if (availableSpace < minIdLength) {
-    throw new Error(`Organization name "${orgId}" is too long to generate a valid preview URL`);
+    throw new CliError({
+      message: `Organization name "${orgId}" is too long to generate a valid preview URL`,
+      code: CliError.Code.InternalError
+    });
   }
   const truncatedId = sanitizedId.slice(0, availableSpace).replace(/-+$/, "");
   return `${prefix2}${truncatedId}.${DOMAIN_SUFFIX}`;
@@ -938941,7 +939132,9 @@ async function generateDocsWorkspace({
 }) {
   const docsWorkspace = project.docsWorkspaces;
   if (docsWorkspace == null) {
-    cliContext.failAndThrow("No docs.yml file found. Please make sure your project has one.");
+    cliContext.failAndThrow("No docs.yml file found. Please make sure your project has one.", void 0, {
+      code: CliError.Code.ConfigError
+    });
     return;
   }
   const hasFdrOriginOverride = !!process.env["FERN_FDR_ORIGIN"] || !!process.env["OVERRIDE_FDR_ORIGIN"];
@@ -938963,7 +939156,9 @@ ${source_default.yellow("?")} Are you sure you want to continue?`,
     const fernToken = await getToken2();
     if (!fernToken) {
       cliContext.failAndThrow(
-        "No token found. Please set the FERN_TOKEN environment variable or run `fern login`."
+        "No token found. Please set the FERN_TOKEN environment variable or run `fern login`.",
+        void 0,
+        { code: CliError.Code.AuthError }
       );
       return;
     }
@@ -939021,7 +939216,9 @@ ${source_default.yellow("?")} Are you sure you want to continue?`,
           context3.logger.error(`${error50.relativeFilepath}: ${error50.message}`);
         }
         context3.failAndThrow(
-          `OpenAPI spec validation failed with ${errors4.length} error${errors4.length !== 1 ? "s" : ""}. Fix the errors above before generating docs.`
+          `OpenAPI spec validation failed with ${errors4.length} error${errors4.length !== 1 ? "s" : ""}. Fix the errors above before generating docs.`,
+          void 0,
+          { code: CliError.Code.ValidationError }
         );
       }
     }
@@ -939123,7 +939320,10 @@ async function generateDynamicIrForWorkspaces({
           disableDynamicExamples
         });
         if (intermediateRepresentation.dynamic == null) {
-          throw new Error("Internal error; dynamic IR was not generated");
+          throw new CliError({
+            message: "Internal error; dynamic IR was not generated",
+            code: CliError.Code.InternalError
+          });
         }
         const irOutputFilePath = import_path83.default.resolve(irFilepath);
         await streamObjectToFile(AbsoluteFilePath2.of(irOutputFilePath), intermediateRepresentation.dynamic);
@@ -939334,10 +939534,14 @@ async function compareOpenAPISpecs({
 }) {
   await cliContext.runTask(async (context3) => {
     if (!await doesPathExist(originalPath)) {
-      return context3.failAndThrow(`Original file does not exist: ${originalPath}`);
+      return context3.failAndThrow(`Original file does not exist: ${originalPath}`, void 0, {
+        code: CliError.Code.ConfigError
+      });
     }
     if (!await doesPathExist(modifiedPath)) {
-      return context3.failAndThrow(`Modified file does not exist: ${modifiedPath}`);
+      return context3.failAndThrow(`Modified file does not exist: ${modifiedPath}`, void 0, {
+        code: CliError.Code.ConfigError
+      });
     }
     context3.logger.info(`Comparing ${originalPath} with ${modifiedPath}`);
     const original = await loadSpec2(originalPath, context3);
@@ -939374,7 +939578,9 @@ async function loadSpec2(filepath, context3) {
     try {
       return jsYaml.load(contents);
     } catch (err) {
-      return context3.failAndThrow(`Failed to parse file as JSON or YAML: ${filepath}`);
+      return context3.failAndThrow(`Failed to parse file as JSON or YAML: ${filepath}`, void 0, {
+        code: CliError.Code.ParseError
+      });
     }
   }
 }
@@ -939501,7 +939707,9 @@ async function readExistingOverrides(overridesFilepath, context3) {
       parsedOverrides = jsYaml.load(contents, { json: true });
     }
   } catch (err) {
-    return context3.failAndThrow(`Failed to read OpenAPI overrides from file ${overridesFilepath}`);
+    return context3.failAndThrow(`Failed to read OpenAPI overrides from file ${overridesFilepath}`, void 0, {
+      code: CliError.Code.ConfigError
+    });
   }
   return parsedOverrides;
 }
@@ -939615,7 +939823,9 @@ async function installDependencies({ cliContext }) {
     const failed = results.filter((r23) => !r23.success);
     if (failed.length > 0) {
       context3.failAndThrow(
-        `Failed to install: ${failed.map((r23) => r23.name).join(", ")}. Check network connectivity and try again.`
+        `Failed to install: ${failed.map((r23) => r23.name).join(", ")}. Check network connectivity and try again.`,
+        void 0,
+        { code: CliError.Code.EnvironmentError }
       );
     }
     context3.logger.info("All dependencies installed successfully.");
@@ -940054,10 +940264,14 @@ async function mergeOpenAPIWithOverrides({
 }) {
   await cliContext.runTask(async (context3) => {
     if (!await doesPathExist(openapiPath)) {
-      return context3.failAndThrow(`OpenAPI spec file does not exist: ${openapiPath}`);
+      return context3.failAndThrow(`OpenAPI spec file does not exist: ${openapiPath}`, void 0, {
+        code: CliError.Code.ConfigError
+      });
     }
     if (!await doesPathExist(overridesPath)) {
-      return context3.failAndThrow(`Overrides file does not exist: ${overridesPath}`);
+      return context3.failAndThrow(`Overrides file does not exist: ${overridesPath}`, void 0, {
+        code: CliError.Code.ConfigError
+      });
     }
     context3.logger.info(`Merging ${overridesPath} into ${openapiPath}`);
     const openapi = await loadYamlOrJson(openapiPath, context3);
@@ -940077,7 +940291,9 @@ async function loadYamlOrJson(filepath, context3) {
     try {
       return jsYaml.load(contents);
     } catch (err) {
-      return context3.failAndThrow(`Failed to parse file as JSON or YAML: ${filepath}`);
+      return context3.failAndThrow(`Failed to parse file as JSON or YAML: ${filepath}`, void 0, {
+        code: CliError.Code.ParseError
+      });
     }
   }
 }
@@ -940666,7 +940882,9 @@ async function mockServer({
     command: "fern mock"
   });
   if (project.apiWorkspaces.length !== 1 || project.apiWorkspaces[0] == null) {
-    return cliContext.failAndThrow(`No API specified. Use the --${API_CLI_OPTION} option.`);
+    return cliContext.failAndThrow(`No API specified. Use the --${API_CLI_OPTION} option.`, void 0, {
+      code: CliError.Code.ConfigError
+    });
   }
   const workspace = project.apiWorkspaces[0];
   await cliContext.runTaskForWorkspace(workspace, async (context3) => {
@@ -940724,7 +940942,9 @@ async function registerWorkspacesV1({
     project.apiWorkspaces.map(async (workspace) => {
       await cliContext.runTaskForWorkspace(workspace, async (context3) => {
         if (workspace instanceof OSSWorkspace) {
-          context3.failWithoutThrowing("Registering from OpenAPI not currently supported.");
+          context3.failWithoutThrowing("Registering from OpenAPI not currently supported.", void 0, {
+            code: CliError.Code.ConfigError
+          });
           return;
         }
         const resolvedWorkspace = await workspace.toFernWorkspace({ context: context3 });
@@ -940737,10 +940957,12 @@ async function registerWorkspacesV1({
         if (!registerApiResponse.ok) {
           registerApiResponse.error._visit({
             versionAlreadyExists: () => {
-              context3.failAndThrow(`Version ${version7 ?? ""} is already registered`);
+              context3.failAndThrow(`Version ${version7 ?? ""} is already registered`, void 0, {
+                code: CliError.Code.VersionError
+              });
             },
             _other: (value) => {
-              context3.failAndThrow("Failed to register", value);
+              context3.failAndThrow("Failed to register", value, { code: CliError.Code.NetworkError });
             }
           });
           return;
@@ -940810,7 +941032,7 @@ var execAsync = (0, import_util70.promisify)(import_child_process10.exec);
 async function getClientRegistry(context3, project) {
   const workspace = project.apiWorkspaces[0];
   if (workspace == null) {
-    context3.failAndThrow("No API workspaces found in the project.");
+    context3.failAndThrow("No API workspaces found in the project.", void 0, { code: CliError.Code.ConfigError });
   }
   const generatorsConfig = await loadGeneratorsConfiguration({
     absolutePathToWorkspace: workspace.absoluteFilePath,
@@ -940818,11 +941040,17 @@ async function getClientRegistry(context3, project) {
     context: context3
   });
   if (generatorsConfig == null) {
-    context3.failAndThrow("Could not find generators.yml in the workspace. Is this a valid fern project?");
+    context3.failAndThrow(
+      "Could not find generators.yml in the workspace. Is this a valid fern project?",
+      void 0,
+      { code: CliError.Code.ConfigError }
+    );
   }
   if (generatorsConfig.ai == null) {
     context3.failAndThrow(
-      "No AI service configuration found in generators.yml. Please add an 'ai' section with provider and model."
+      "No AI service configuration found in generators.yml. Please add an 'ai' section with provider and model.",
+      void 0,
+      { code: CliError.Code.ConfigError }
     );
   }
   context3.logger.debug(`Using AI service: ${generatorsConfig.ai.provider} with model ${generatorsConfig.ai.model}`);
@@ -940840,11 +941068,11 @@ async function sdkDiffCommand({
   From: ${fromPath}
   To:   ${toPath5}`);
   if (!await doesPathExist(fromPath, "directory")) {
-    context3.failWithoutThrowing(`Directory not found: ${fromPath}`);
+    context3.failWithoutThrowing(`Directory not found: ${fromPath}`, void 0, { code: CliError.Code.ConfigError });
     throw new TaskAbortSignal();
   }
   if (!await doesPathExist(toPath5, "directory")) {
-    context3.failWithoutThrowing(`Directory not found: ${toPath5}`);
+    context3.failWithoutThrowing(`Directory not found: ${toPath5}`, void 0, { code: CliError.Code.ConfigError });
     throw new TaskAbortSignal();
   }
   const clientRegistry = await getClientRegistry(context3, project);
@@ -940866,7 +941094,9 @@ async function sdkDiffCommand({
   const diffBytes = Buffer.byteLength(gitDiff, "utf-8");
   if (diffBytes > MAX_RAW_DIFF_BYTES) {
     return context3.failAndThrow(
-      `Diff too large for analysis (${(diffBytes / 1e6).toFixed(1)}MB, limit ${MAX_RAW_DIFF_BYTES / 1e6}MB). Try excluding generated files or splitting the comparison.`
+      `Diff too large for analysis (${(diffBytes / 1e6).toFixed(1)}MB, limit ${MAX_RAW_DIFF_BYTES / 1e6}MB). Try excluding generated files or splitting the comparison.`,
+      void 0,
+      { code: CliError.Code.ConfigError }
     );
   }
   const chunks = diffBytes > MAX_AI_DIFF_BYTES ? service.chunkDiff(gitDiff, MAX_AI_DIFF_BYTES) : [gitDiff];
@@ -940953,7 +941183,9 @@ async function sdkDiffCommand({
   } catch (error50) {
     const errorMessage = extractErrorMessage(error50);
     context3.failWithoutThrowing(
-      `Failed to analyze SDK diff. Diff stats: ${gitDiff.length.toLocaleString()} chars, ${diffSizeKB}KB, ${fileCount} files changed. ` + (cappedChunks.length > 1 ? `The diff was split into ${cappedChunks.length} chunks but analysis still failed. ` : "") + `Error: ${errorMessage}`
+      `Failed to analyze SDK diff. Diff stats: ${gitDiff.length.toLocaleString()} chars, ${diffSizeKB}KB, ${fileCount} files changed. ` + (cappedChunks.length > 1 ? `The diff was split into ${cappedChunks.length} chunks but analysis still failed. ` : "") + `Error: ${errorMessage}`,
+      void 0,
+      { code: CliError.Code.NetworkError }
     );
     throw new TaskAbortSignal();
   }
@@ -940974,7 +941206,9 @@ async function generateDiff({
     if (typeof error50 === "object" && error50 != null && "code" in error50 && error50.code === 1 && "stdout" in error50 && typeof error50.stdout === "string") {
       return error50.stdout;
     }
-    return context3.failAndThrow(`Failed to generate diff: ${extractErrorMessage(error50)}`);
+    return context3.failAndThrow(`Failed to generate diff: ${extractErrorMessage(error50)}`, void 0, {
+      code: CliError.Code.InternalError
+    });
   }
 }
 
@@ -941160,7 +941394,9 @@ async function sdkPreview({
       return askToLogin(context3);
     });
     if (token == null) {
-      return cliContext.failAndThrow("Authentication required. Run 'fern login' or set FERN_TOKEN.");
+      return cliContext.failAndThrow("Authentication required. Run 'fern login' or set FERN_TOKEN.", void 0, {
+        code: CliError.Code.AuthError
+      });
     }
     const project = await loadProjectAndRegisterWorkspacesWithContext(cliContext, {
       commandLineApiWorkspace: apiName,
@@ -941212,19 +941448,25 @@ async function sdkPreview({
       const groupNameOrDefault = groupName ?? workspace.generatorsConfiguration.defaultGroup;
       if (groupNameOrDefault == null) {
         return cliContext.failAndThrow(
-          `No group specified. Use the --${GROUP_CLI_OPTION} option, or set "${DEFAULT_GROUP_GENERATORS_CONFIG_KEY}" in ${GENERATORS_CONFIGURATION_FILENAME}`
+          `No group specified. Use the --${GROUP_CLI_OPTION} option, or set "${DEFAULT_GROUP_GENERATORS_CONFIG_KEY}" in ${GENERATORS_CONFIGURATION_FILENAME}`,
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       }
       const group = workspace.generatorsConfiguration.groups.find((g19) => g19.groupName === groupNameOrDefault);
       if (group == null) {
         return cliContext.failAndThrow(
-          `Group '${groupNameOrDefault}' does not exist in ${GENERATORS_CONFIGURATION_FILENAME}`
+          `Group '${groupNameOrDefault}' does not exist in ${GENERATORS_CONFIGURATION_FILENAME}`,
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       }
       const generators = generatorFilter != null ? group.generators.filter((g19) => g19.name === generatorFilter) : group.generators;
       if (generatorFilter != null && generators.length === 0) {
         return cliContext.failAndThrow(
-          `Generator '${generatorFilter}' not found in group '${groupNameOrDefault}' in ${GENERATORS_CONFIGURATION_FILENAME}`
+          `Generator '${generatorFilter}' not found in group '${groupNameOrDefault}' in ${GENERATORS_CONFIGURATION_FILENAME}`,
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       }
       const npmGenerators = generators.filter((g19) => isNpmGenerator(g19.name));
@@ -941236,14 +941478,18 @@ async function sdkPreview({
       }
       if (npmGenerators.length === 0) {
         return cliContext.failAndThrow(
-          `No supported generators found in group '${groupNameOrDefault}'. SDK preview currently only supports TypeScript/npm generators.`
+          `No supported generators found in group '${groupNameOrDefault}'. SDK preview currently only supports TypeScript/npm generators.`,
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       }
       for (const generator of npmGenerators) {
         const originalPackageName = getPackageNameFromGeneratorConfig(generator);
         if (originalPackageName == null) {
           return cliContext.failAndThrow(
-            `Could not determine package name for generator '${generator.name}'. Ensure 'output.package-name' is set in ${GENERATORS_CONFIGURATION_FILENAME}.`
+            `Could not determine package name for generator '${generator.name}'. Ensure 'output.package-name' is set in ${GENERATORS_CONFIGURATION_FILENAME}.`,
+            void 0,
+            { code: CliError.Code.ConfigError }
           );
         }
         const previewPackageName = toPreviewPackageName(originalPackageName, project.config.organization);
@@ -941572,7 +941818,7 @@ Resolved to: ${installationMethod.resolvedPath}`;
     }
     errorMessage += "\n\nPlease manually update using your package manager (npm, pnpm, yarn, bun, or brew).";
     errorMessage += "\nFor more diagnostic information, run with: FERN_LOG_LEVEL=debug fern self-update";
-    return cliContext.failAndThrow(errorMessage);
+    return cliContext.failAndThrow(errorMessage, void 0, { code: CliError.Code.EnvironmentError });
   }
   cliContext.logger.info(`Detected installation method: ${source_default.cyan(installationMethod.type)}`);
   if (installationMethod.detectedPath != null) {
@@ -941584,7 +941830,9 @@ Resolved to: ${installationMethod.resolvedPath}`;
   const updateCommand = getUpdateCommand(installationMethod, version7);
   if (updateCommand.length === 0) {
     return cliContext.failAndThrow(
-      `Unable to construct update command for installation method: ${installationMethod.type}`
+      `Unable to construct update command for installation method: ${installationMethod.type}`,
+      void 0,
+      { code: CliError.Code.EnvironmentError }
     );
   }
   if (installationMethod.type === "brew" && version7 != null) {
@@ -941603,7 +941851,7 @@ Resolved to: ${installationMethod.resolvedPath}`;
   cliContext.logger.info(`Running: ${source_default.dim(commandString)}`);
   const [command3, ...args] = updateCommand;
   if (command3 == null) {
-    return cliContext.failAndThrow("Invalid update command");
+    return cliContext.failAndThrow("Invalid update command", void 0, { code: CliError.Code.InternalError });
   }
   const { failed, stderr } = await loggingExeca(cliContext.logger, command3, args, {
     doNotPipeOutput: false,
@@ -941611,7 +941859,9 @@ Resolved to: ${installationMethod.resolvedPath}`;
   });
   if (failed) {
     cliContext.logger.error(`Failed to update Fern CLI: ${stderr}`);
-    return cliContext.failAndThrow("Update failed. Please try updating manually.");
+    return cliContext.failAndThrow("Update failed. Please try updating manually.", void 0, {
+      code: CliError.Code.EnvironmentError
+    });
   }
   cliContext.logger.info(source_default.green("\u2713 Fern CLI updated successfully!"));
 }
@@ -941628,10 +941878,14 @@ async function testOutput({
     command: "fern test"
   });
   if (testCommand == null) {
-    return cliContext.failAndThrow("No test command specified. Use the --command option.");
+    return cliContext.failAndThrow("No test command specified. Use the --command option.", void 0, {
+      code: CliError.Code.ConfigError
+    });
   }
   if (project.apiWorkspaces.length !== 1 || project.apiWorkspaces[0] == null) {
-    return cliContext.failAndThrow(`No API specified. Use the --${API_CLI_OPTION} option.`);
+    return cliContext.failAndThrow(`No API specified. Use the --${API_CLI_OPTION} option.`, void 0, {
+      code: CliError.Code.ConfigError
+    });
   }
   const workspace = project.apiWorkspaces[0];
   await cliContext.runTaskForWorkspace(workspace, async (context3) => {
@@ -941676,7 +941930,7 @@ async function testOutput({
         mockServer2.stop();
         context3.logger.error("Tests failed, Fern mock server stopping.");
         context3.logger.error("View test output above.");
-        cliContext.failAndThrow();
+        cliContext.failAndThrow(void 0, void 0, { code: CliError.Code.ValidationError });
       }
     }
     mockServer2.stop();
@@ -941703,15 +941957,25 @@ async function generateToken({
   }
   response.error._visit({
     organizationNotFoundError: () => taskContext.failAndThrow(
-      `Failed to create token because the organization ${orgId} was not found. Please reach out to support@buildwithfern.com`
+      `Failed to create token because the organization ${orgId} was not found. Please reach out to support@buildwithfern.com`,
+      void 0,
+      { code: CliError.Code.AuthError }
     ),
     unauthorizedError: () => taskContext.failAndThrow(
-      `Failed to create token because you are not in the ${orgId} organization. Please reach out to support@buildwithfern.com`
+      `Failed to create token because you are not in the ${orgId} organization. Please reach out to support@buildwithfern.com`,
+      void 0,
+      { code: CliError.Code.AuthError }
     ),
     missingOrgPermissionsError: () => taskContext.failAndThrow(
-      `Failed to create token because you do not have the required permissions in the ${orgId} organization. Please reach out to support@buildwithfern.com`
+      `Failed to create token because you do not have the required permissions in the ${orgId} organization. Please reach out to support@buildwithfern.com`,
+      void 0,
+      { code: CliError.Code.AuthError }
     ),
-    _other: () => taskContext.failAndThrow("Failed to create token. Please reach out to support@buildwithfern.com")
+    _other: () => taskContext.failAndThrow(
+      "Failed to create token. Please reach out to support@buildwithfern.com",
+      void 0,
+      { code: CliError.Code.AuthError }
+    )
   });
 }
 
@@ -941766,7 +942030,10 @@ function isIntrospectionResult(data2) {
 }
 function extractIntrospectionData(data2) {
   if (!data2 || typeof data2 !== "object") {
-    throw new Error("Data does not contain valid GraphQL introspection result");
+    throw new CliError({
+      message: "Data does not contain valid GraphQL introspection result",
+      code: CliError.Code.InternalError
+    });
   }
   if ("__schema" in data2 && data2.__schema) {
     return data2;
@@ -941774,7 +942041,10 @@ function extractIntrospectionData(data2) {
   if ("data" in data2 && data2.data && typeof data2.data === "object" && "__schema" in data2.data) {
     return data2.data;
   }
-  throw new Error("Data does not contain valid GraphQL introspection result");
+  throw new CliError({
+    message: "Data does not contain valid GraphQL introspection result",
+    code: CliError.Code.InternalError
+  });
 }
 async function tryGraphQLIntrospection(url3, logger4) {
   try {
@@ -941901,7 +942171,7 @@ Attempt 2 (GET direct fetch): ${getResult.error}
 To update the schema from its defined origin, please ensure the origin either:
 1. Accepts GraphQL introspection queries via POST, or
 2. Returns introspection results directly via GET`;
-  throw new Error(errorMessage);
+  throw new CliError({ message: errorMessage, code: CliError.Code.InternalError });
 }
 async function updateApiSpec({
   cliContext,
@@ -945135,7 +945405,7 @@ async function rerunFernCliAtVersion({
     if (throwOnError) {
       throw new RerunCliError({ version: version7, stdout, stderr });
     }
-    cliContext.failWithoutThrowing();
+    cliContext.failWithoutThrowing(void 0, void 0, { code: CliError.Code.InternalError });
   }
 }
 
@@ -945279,7 +945549,9 @@ function validateVersionAhead({
   const versionAhead = isVersionAhead(targetVersion, currentVersion);
   if (!versionAhead) {
     cliContext.failAndThrow(
-      `Cannot upgrade because target version (${targetVersion}) is not ahead of existing version ${currentVersion}`
+      `Cannot upgrade because target version (${targetVersion}) is not ahead of existing version ${currentVersion}`,
+      void 0,
+      { code: CliError.Code.VersionError }
     );
   }
 }
@@ -945334,7 +945606,9 @@ async function upgrade({
       }
       const fernDirectory2 = await getFernDirectory();
       if (fernDirectory2 == null) {
-        return cliContext.failAndThrow(`Directory "${FERN_DIRECTORY}" not found.`);
+        return cliContext.failAndThrow(`Directory "${FERN_DIRECTORY}" not found.`, void 0, {
+          code: CliError.Code.ConfigError
+        });
       }
       const projectConfig2 = await cliContext.runTask(
         (context3) => loadProjectConfig({ directory: fernDirectory2, context: context3 })
@@ -945368,7 +945642,9 @@ async function upgrade({
   if (cliContext.environment.packageVersion === resolvedTargetVersion || isLocalDev) {
     const fernDirectory2 = await getFernDirectory();
     if (fernDirectory2 == null) {
-      return cliContext.failAndThrow(`Directory "${FERN_DIRECTORY}" not found.`);
+      return cliContext.failAndThrow(`Directory "${FERN_DIRECTORY}" not found.`, void 0, {
+        code: CliError.Code.ConfigError
+      });
     }
     const projectConfig2 = await cliContext.runTask(
       (context3) => loadProjectConfig({ directory: fernDirectory2, context: context3 })
@@ -945410,7 +945686,9 @@ async function upgrade({
   });
   const fernDirectory = await getFernDirectory();
   if (fernDirectory == null) {
-    return cliContext.failAndThrow(`Directory "${FERN_DIRECTORY}" not found.`);
+    return cliContext.failAndThrow(`Directory "${FERN_DIRECTORY}" not found.`, void 0, {
+      code: CliError.Code.ConfigError
+    });
   }
   const projectConfig = await cliContext.runTask(
     (context3) => loadProjectConfig({ directory: fernDirectory, context: context3 })
@@ -945449,7 +945727,9 @@ async function upgrade({
       const isVersionNotFound = errorOutput.includes("ETARGET") || errorOutput.includes("E404") || errorOutput.includes("404 Not Found") || errorOutput.includes("No matching version found") || errorOutput.includes("version not found");
       if (isVersionNotFound) {
         return cliContext.failAndThrow(
-          `Failed to upgrade to ${resolvedTargetVersion} because it does not exist. See https://www.npmjs.com/package/${cliContext.environment.packageName}?activeTab=versions.`
+          `Failed to upgrade to ${resolvedTargetVersion} because it does not exist. See https://www.npmjs.com/package/${cliContext.environment.packageName}?activeTab=versions.`,
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       }
     }
@@ -945465,7 +945745,7 @@ async function validateDocsBrokenLinks({
 }) {
   const docsWorkspace = project.docsWorkspaces;
   if (docsWorkspace == null) {
-    cliContext.failAndThrow("No docs workspace found");
+    cliContext.failAndThrow("No docs workspace found", void 0, { code: CliError.Code.ConfigError });
     return;
   }
   await cliContext.runTaskForWorkspace(docsWorkspace, async (context3) => {
@@ -945488,7 +945768,7 @@ async function validateDocsBrokenLinks({
       elapsedMillis
     });
     if (violations.length > 0 && errorOnBrokenLinks) {
-      context3.failAndThrow();
+      context3.failAndThrow(void 0, void 0, { code: CliError.Code.ValidationError });
     }
   });
 }
@@ -945970,7 +946250,7 @@ async function validateWorkspaces({
         if (!apiYmlExists) {
           await cliContext.runTask(async (context3) => {
             context3.logger.error(`Missing file: ${ROOT_API_FILENAME}`);
-            return context3.failAndThrow();
+            return context3.failAndThrow(void 0, void 0, { code: CliError.Code.ValidationError });
           });
           return;
         }
@@ -946011,7 +946291,7 @@ async function validateWorkspaces({
     );
   }
   if (hasErrors || hasAnyErrors) {
-    cliContext.failAndThrow();
+    cliContext.failAndThrow(void 0, void 0, { code: CliError.Code.ValidationError });
   }
 }
 
@@ -946229,7 +946509,10 @@ async function translateText({
     cliContext.logger.error(
       "Authentication required. Please run 'fern login' or set the FERN_TOKEN environment variable."
     );
-    throw new Error("Authentication required for translation service");
+    throw new CliError({
+      message: "Authentication required for translation service",
+      code: CliError.Code.AuthError
+    });
   }
   const config5 = {
     maxRetries: retryConfig.maxRetries ?? DEFAULT_MAX_RETRIES3,
@@ -946266,7 +946549,7 @@ async function translateText({
           errorDetail = await response.text();
         }
         if (response.status === 403) {
-          throw new Error(`403: ${errorDetail}`);
+          throw new CliError({ message: `403: ${errorDetail}`, code: CliError.Code.AuthError });
         }
         const error50 = new Error(`HTTP ${response.status}: ${errorDetail}`);
         if (!isRetriableError(error50, response)) {
@@ -946946,7 +947229,10 @@ async function writeTranslationForProject({
     const translationsDirectory = join8(fernDirectory, RelativeFilePath2.of("translations"));
     const sourceLanguage = languages[0];
     if (!sourceLanguage) {
-      throw new Error("Unexpected error - first element of languages array is invalid");
+      throw new CliError({
+        message: "Unexpected error - first element of languages array is invalid",
+        code: CliError.Code.InternalError
+      });
     }
     if (!(0, import_fs38.existsSync)(translationsDirectory)) {
       context3.logger.debug(`Creating translations directory at: ${translationsDirectory}`);
@@ -947259,19 +947545,23 @@ async function resolveGroupGithubConfig(cliContext, groupName, apiWorkspace) {
   });
   const workspace = project.apiWorkspaces[0];
   if (workspace == null) {
-    return cliContext.failAndThrow("No API workspace found.");
+    return cliContext.failAndThrow("No API workspace found.", void 0, { code: CliError.Code.ConfigError });
   }
   const generatorsConfig = workspace.generatorsConfiguration;
   if (generatorsConfig == null) {
-    return cliContext.failAndThrow("No generators.yml found in workspace.");
+    return cliContext.failAndThrow("No generators.yml found in workspace.", void 0, {
+      code: CliError.Code.ConfigError
+    });
   }
   const group = generatorsConfig.groups.find((g19) => g19.groupName === groupName);
   if (group == null) {
     const available = generatorsConfig.groups.map((g19) => g19.groupName).join(", ");
-    return cliContext.failAndThrow(`Group "${groupName}" not found. Available groups: ${available}`);
+    return cliContext.failAndThrow(`Group "${groupName}" not found. Available groups: ${available}`, void 0, {
+      code: CliError.Code.ConfigError
+    });
   }
   const resolveEnv = (value) => replaceEnvVariables(value, {
-    onError: (message) => cliContext.failAndThrow(message)
+    onError: (message) => cliContext.failAndThrow(message, void 0, { code: CliError.Code.ConfigError })
   });
   const generatorWithSelfhosted = group.generators.find(
     (g19) => g19.raw?.github != null && isGithubSelfhosted(g19.raw.github)
@@ -947302,7 +947592,9 @@ async function resolveGroupGithubConfig(cliContext, groupName, apiWorkspace) {
       branch: "branch" in githubConfig ? githubConfig.branch : void 0
     };
   }
-  return cliContext.failAndThrow(`No generator in group "${groupName}" has a github configuration.`);
+  return cliContext.failAndThrow(`No generator in group "${groupName}" has a github configuration.`, void 0, {
+    code: CliError.Code.ConfigError
+  });
 }
 
 // src/runtime.ts
@@ -947432,7 +947724,7 @@ async function tryRunCli(cliContext) {
         cliContext.logger.info(cliContext.environment.packageVersion);
       } else {
         cli.showHelp();
-        cliContext.failAndThrow();
+        cliContext.failAndThrow(void 0, void 0, { code: CliError.Code.ConfigError });
       }
     }
   ).option("log-level", {
@@ -947558,14 +947850,22 @@ function addInitCommand2(cli, cliContext) {
         }
       }
       if (argv.api != null && argv.docs != null) {
-        return cliContext.failWithoutThrowing("Cannot specify both --api and --docs. Please choose one.");
+        return cliContext.failWithoutThrowing(
+          "Cannot specify both --api and --docs. Please choose one.",
+          void 0,
+          { code: CliError.Code.ConfigError }
+        );
       } else if (argv.readme != null && argv.mintlify != null) {
         return cliContext.failWithoutThrowing(
-          "Cannot specify both --readme and --mintlify. Please choose one."
+          "Cannot specify both --readme and --mintlify. Please choose one.",
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       } else if (argv.openapi != null && argv["fern-definition"] === true) {
         return cliContext.failWithoutThrowing(
-          "Cannot specify both --openapi and --fern-definition. Please choose one."
+          "Cannot specify both --openapi and --fern-definition. Please choose one.",
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       } else if (argv.readme != null) {
         await cliContext.runTask(async (context3) => {
@@ -947599,7 +947899,9 @@ function addInitCommand2(cli, cliContext) {
           if (isURL(argv.openapi)) {
             const result = await loadOpenAPIFromUrl({ url: argv.openapi, logger: cliContext.logger });
             if (result.status === LoadOpenAPIStatus.Failure) {
-              cliContext.failAndThrow(result.errorMessage);
+              cliContext.failAndThrow(result.errorMessage, void 0, {
+                code: CliError.Code.NetworkError
+              });
             }
             const tmpFilepath = result.filePath;
             absoluteOpenApiPath = AbsoluteFilePath2.of(tmpFilepath);
@@ -947608,7 +947910,9 @@ function addInitCommand2(cli, cliContext) {
           }
           const pathExists2 = await doesPathExist(absoluteOpenApiPath);
           if (!pathExists2) {
-            cliContext.failAndThrow(`${absoluteOpenApiPath} does not exist`);
+            cliContext.failAndThrow(`${absoluteOpenApiPath} does not exist`, void 0, {
+              code: CliError.Code.ConfigError
+            });
           }
         }
         await cliContext.runTask(async (context3) => {
@@ -947652,9 +947956,10 @@ function addDiffCommand(cli, cliContext) {
       description: "Whether to suppress output written to stderr"
     }).middleware((argv) => {
       if (!haveSameNullishness(argv.fromGeneratorVersion, argv.toGeneratorVersion)) {
-        throw new Error(
-          "Both --from-generator-version and --to-generator-version must be provided together, or neither should be provided"
-        );
+        throw new CliError({
+          message: "Both --from-generator-version and --to-generator-version must be provided together, or neither should be provided",
+          code: CliError.Code.ValidationError
+        });
       }
     }),
     async (argv) => {
@@ -947905,50 +948210,84 @@ function addGenerateCommand2(cli, cliContext) {
     }),
     async (argv) => {
       if (argv.api != null && argv.docs != null) {
-        return cliContext.failWithoutThrowing("Cannot specify both --api and --docs. Please choose one.");
+        return cliContext.failWithoutThrowing(
+          "Cannot specify both --api and --docs. Please choose one.",
+          void 0,
+          { code: CliError.Code.ConfigError }
+        );
       }
       if (argv.id != null && !argv.preview) {
-        return cliContext.failWithoutThrowing("The --id flag can only be used with --preview.");
+        return cliContext.failWithoutThrowing("The --id flag can only be used with --preview.", void 0, {
+          code: CliError.Code.ConfigError
+        });
       }
       if (argv.id != null && argv.docs == null) {
-        return cliContext.failWithoutThrowing("The --id flag can only be used with --docs.");
+        return cliContext.failWithoutThrowing("The --id flag can only be used with --docs.", void 0, {
+          code: CliError.Code.ConfigError
+        });
       }
       if (argv.skipUpload && !argv.preview) {
-        return cliContext.failWithoutThrowing("The --skip-upload flag can only be used with --preview.");
+        return cliContext.failWithoutThrowing(
+          "The --skip-upload flag can only be used with --preview.",
+          void 0,
+          { code: CliError.Code.ConfigError }
+        );
       }
       if (argv.skipUpload && argv.docs == null) {
-        return cliContext.failWithoutThrowing("The --skip-upload flag can only be used with --docs.");
+        return cliContext.failWithoutThrowing(
+          "The --skip-upload flag can only be used with --docs.",
+          void 0,
+          { code: CliError.Code.ConfigError }
+        );
       }
       if (argv.fernignore != null && (argv.local || argv.runner != null)) {
         return cliContext.failWithoutThrowing(
-          "The --fernignore flag is not supported with local generation (--local or --runner). It can only be used with remote generation."
+          "The --fernignore flag is not supported with local generation (--local or --runner). It can only be used with remote generation.",
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       }
       if (argv["skip-fernignore"] && argv.fernignore != null) {
         return cliContext.failWithoutThrowing(
-          "The --skip-fernignore and --fernignore flags cannot be used together."
+          "The --skip-fernignore and --fernignore flags cannot be used together.",
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       }
       if (argv["dynamic-ir-only"] && (argv.local || argv.runner != null)) {
         return cliContext.failWithoutThrowing(
-          "The --dynamic-ir-only flag is not supported with local generation (--local or --runner). It can only be used with remote generation."
+          "The --dynamic-ir-only flag is not supported with local generation (--local or --runner). It can only be used with remote generation.",
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       }
       if (argv["dynamic-ir-only"] && argv.version == null) {
         return cliContext.failWithoutThrowing(
-          "The --dynamic-ir-only flag requires a version to be specified with --version."
+          "The --dynamic-ir-only flag requires a version to be specified with --version.",
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       }
       if (argv["dynamic-ir-only"] && argv.docs != null) {
         return cliContext.failWithoutThrowing(
-          "The --dynamic-ir-only flag can only be used for API generation, not docs generation."
+          "The --dynamic-ir-only flag can only be used for API generation, not docs generation.",
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       }
       if (argv.output != null && !argv.preview) {
-        return cliContext.failWithoutThrowing("The --output flag currently only works with --preview.");
+        return cliContext.failWithoutThrowing(
+          "The --output flag currently only works with --preview.",
+          void 0,
+          { code: CliError.Code.ConfigError }
+        );
       }
       if (argv.output != null && argv.docs != null) {
-        return cliContext.failWithoutThrowing("The --output flag is not supported for docs generation.");
+        return cliContext.failWithoutThrowing(
+          "The --output flag is not supported for docs generation.",
+          void 0,
+          { code: CliError.Code.ConfigError }
+        );
       }
       const correctedGeneratorFilter = argv.generator != null ? warnAndCorrectIncorrectDockerOrg(argv.generator, cliContext) : void 0;
       const { generatorName, generatorIndex } = parseGeneratorArg(correctedGeneratorFilter);
@@ -948880,17 +949219,26 @@ function addDocsDevCommand(cli, cliContext) {
         );
       }
       let port;
-      if (argv.port != null) {
-        port = argv.port;
-      } else {
-        port = await getPorts({ port: [3e3, 3001, 3002, 3003, 3004, 3005, 3006, 3007, 3008, 3009, 3010] });
-      }
       let backendPort;
-      if (argv.backendPort != null) {
-        backendPort = argv.backendPort;
-      } else {
-        backendPort = await getPorts({
-          port: [3001, 3002, 3003, 3004, 3005, 3006, 3007, 3008, 3009, 3010, 3011]
+      try {
+        if (argv.port != null) {
+          port = argv.port;
+        } else {
+          port = await getPorts({
+            port: [3e3, 3001, 3002, 3003, 3004, 3005, 3006, 3007, 3008, 3009, 3010]
+          });
+        }
+        if (argv.backendPort != null) {
+          backendPort = argv.backendPort;
+        } else {
+          backendPort = await getPorts({
+            port: [3001, 3002, 3003, 3004, 3005, 3006, 3007, 3008, 3009, 3010, 3011]
+          });
+        }
+      } catch (error50) {
+        throw new CliError({
+          message: `Failed to find an available port: ${error50 instanceof Error ? error50.message : String(error50)}`,
+          code: CliError.Code.EnvironmentError
         });
       }
       const bundlePath = argv.bundlePath;
@@ -948943,7 +949291,7 @@ function addDocsMdCheckCommand(cli, cliContext) {
         defaultToAllApiWorkspaces: true
       });
       if (project.docsWorkspaces == null) {
-        cliContext.failAndThrow("No docs workspace found");
+        cliContext.failAndThrow("No docs workspace found", void 0, { code: CliError.Code.ConfigError });
       }
       const docsWorkspace = project.docsWorkspaces;
       let hasErrors = false;
@@ -948958,7 +949306,7 @@ function addDocsMdCheckCommand(cli, cliContext) {
         }
       });
       if (hasErrors) {
-        cliContext.failWithoutThrowing();
+        cliContext.failWithoutThrowing(void 0, void 0, { code: CliError.Code.ValidationError });
       }
     }
   );
@@ -949317,7 +949665,7 @@ function addBetaCommand(cli, cliContext) {
         await runCliV2(v2Args);
       } catch (error50) {
         cliContext.logger.error("CLI v2 failed:", String(error50));
-        cliContext.failWithoutThrowing();
+        cliContext.failWithoutThrowing(void 0, error50, { code: CliError.Code.InternalError });
       }
     }
   );
@@ -949442,7 +949790,11 @@ function addReplayInitCommand(cli, cliContext) {
       }
       if (githubRepo == null) {
         return cliContext.failAndThrow(
-          "Missing required github config. Either use --group to read from generators.yml, or provide --github directly."
+          "Missing required github config. Either use --group to read from generators.yml, or provide --github directly.",
+          void 0,
+          {
+            code: CliError.Code.ConfigError
+          }
         );
       }
       if (token == null) {
@@ -949478,7 +949830,9 @@ function addReplayInitCommand(cli, cliContext) {
           return;
         }
         if (result.lockfileContent == null) {
-          return cliContext.failAndThrow("Bootstrap succeeded but lockfile content is missing.");
+          return cliContext.failAndThrow("Bootstrap succeeded but lockfile content is missing.", void 0, {
+            code: CliError.Code.InternalError
+          });
         }
         const fernToken = await cliContext.runTask((context3) => askToLogin(context3));
         const { owner, repo } = parseOwnerRepo(githubRepo);
@@ -949500,18 +949854,24 @@ function addReplayInitCommand(cli, cliContext) {
         if (!response.ok) {
           if (response.status === 404) {
             return cliContext.failAndThrow(
-              "The Fern GitHub App is not installed on this repository. Install it at https://github.com/apps/fern-api to enable server-side PR creation."
+              "The Fern GitHub App is not installed on this repository. Install it at https://github.com/apps/fern-api to enable server-side PR creation.",
+              void 0,
+              { code: CliError.Code.ConfigError }
             );
           }
           const body = await response.text();
-          return cliContext.failAndThrow(`Failed to create PR via Fern: ${body}`);
+          return cliContext.failAndThrow(`Failed to create PR via Fern: ${body}`, void 0, {
+            code: CliError.Code.NetworkError
+          });
         }
         const data2 = await response.json();
         cliContext.logger.info(`
 PR created: ${data2.prUrl}`);
         cliContext.logger.info("Merge the PR to enable Replay for this repository.");
       } catch (error50) {
-        cliContext.failAndThrow(`Failed to initialize Replay: ${extractErrorMessage(error50)}`);
+        cliContext.failAndThrow(`Failed to initialize Replay: ${extractErrorMessage(error50)}`, error50, {
+          code: CliError.Code.NetworkError
+        });
       }
     }
   );
@@ -949574,12 +949934,18 @@ Resolve the conflicts in your editor, then run \`fern replay resolve\` again to
                 }
                 cliContext.logger.warn(`Resolve them first, then run \`fern replay resolve\` again.`);
               } else {
-                cliContext.failAndThrow(`Resolve failed: ${result.reason ?? "unknown error"}`);
+                cliContext.failAndThrow(
+                  `Resolve failed: ${result.reason ?? "unknown error"}`,
+                  void 0,
+                  { code: CliError.Code.InternalError }
+                );
               }
             }
         }
       } catch (error50) {
-        cliContext.failAndThrow(`Failed to resolve: ${extractErrorMessage(error50)}`);
+        cliContext.failAndThrow(`Failed to resolve: ${extractErrorMessage(error50)}`, error50, {
+          code: CliError.Code.InternalError
+        });
       }
     }
   );
@@ -949795,7 +950161,10 @@ function parseOwnerRepo(githubRepo) {
   const owner = parts[parts.length - 2];
   const repo = parts[parts.length - 1];
   if (owner == null || repo == null) {
-    throw new Error(`Could not parse owner/repo from: ${githubRepo}`);
+    throw new CliError({
+      message: `Could not parse owner/repo from: ${githubRepo}`,
+      code: CliError.Code.ParseError
+    });
   }
   return { owner, repo };
 }