@fern-api/fern-api-dev 4.68.2-6-gdbf7c6b8be3 → 4.68.3-1-g429be56b56f

package/cli.cjs

@@ -38969,7 +38969,7 @@ var require_errors = __commonJS({
     exports2.keyword$DataError = {
       message: ({ keyword, schemaType }) => schemaType ? (0, codegen_1.str)`"${keyword}" keyword must be ${schemaType} ($data)` : (0, codegen_1.str)`"${keyword}" keyword is invalid ($data)`
     };
-    function reportError(cxt, error50 = exports2.keywordError, errorPaths, overrideAllErrors) {
+    function reportError3(cxt, error50 = exports2.keywordError, errorPaths, overrideAllErrors) {
       const { it: it13 } = cxt;
       const { gen, compositeRule, allErrors } = it13;
       const errObj = errorObjectCode(cxt, error50, errorPaths);
@@ -38979,7 +38979,7 @@ var require_errors = __commonJS({
         returnErrors(it13, (0, codegen_1._)`[${errObj}]`);
       }
     }
-    exports2.reportError = reportError;
+    exports2.reportError = reportError3;
     function reportExtraError(cxt, error50 = exports2.keywordError, errorPaths) {
       const { it: it13 } = cxt;
       const { gen, compositeRule, allErrors } = it13;
@@ -54543,7 +54543,7 @@ function childLoggerName(name2, childDebugger, { namespace: parentNamespace }) {
   }
   return childNamespace || parentNamespace;
 }
-function createLogger(label, verbose, initialStep, infoDebugger = createLog()) {
+function createLogger2(label, verbose, initialStep, infoDebugger = createLog()) {
   const labelPrefix = label && `[${label}]` || "";
   const spawned = [];
   const debugDebugger = typeof verbose === "string" ? infoDebugger.extend(verbose) : verbose;
@@ -54552,7 +54552,7 @@ function createLogger(label, verbose, initialStep, infoDebugger = createLog()) {
   function sibling2(name2, initial) {
     return append(
       spawned,
-      createLogger(label, key2.replace(/^[^:]+/, name2), initial, infoDebugger)
+      createLogger2(label, key2.replace(/^[^:]+/, name2), initial, infoDebugger)
     );
   }
   function step(phase) {
@@ -56283,7 +56283,7 @@ var init_esm16 = __esm({
           }
           createProgress(task) {
             const name2 = _TasksPendingQueue.getName(task.commands[0]);
-            const logger4 = createLogger(this.logLabel, name2);
+            const logger4 = createLogger2(this.logLabel, name2);
             return {
               task,
               logger: logger4,
@@ -57566,7 +57566,7 @@ var init_esm16 = __esm({
         Scheduler = class {
           constructor(concurrency = 2) {
             this.concurrency = concurrency;
-            this.logger = createLogger("", "scheduler");
+            this.logger = createLogger2("", "scheduler");
             this.pending = [];
             this.running = [];
             this.logger(`Constructed, concurrency=%s`, concurrency);
@@ -59886,7 +59886,7 @@ var init_version4 = __esm({
 });
 
 // ../../../node_modules/.pnpm/@octokit+core@6.1.6/node_modules/@octokit/core/dist-src/index.js
-function createLogger2(logger4 = {}) {
+function createLogger3(logger4 = {}) {
   if (typeof logger4.debug !== "function") {
     logger4.debug = noop3;
   }
@@ -59982,7 +59982,7 @@ var init_dist_src2 = __esm({
         }
         this.request = request2.defaults(requestDefaults);
         this.graphql = withCustomRequest(this.request).defaults(requestDefaults);
-        this.log = createLogger2(options2.log);
+        this.log = createLogger3(options2.log);
         this.hook = hook8;
         if (!options2.authStrategy) {
           if (!options2.auth) {
@@ -66343,7 +66343,7 @@ function removeListener(state, webhookNameOrNames, handler3) {
 function createEventHandler(options2) {
   const state = {
     hooks: {},
-    log: createLogger3(options2 && options2.log)
+    log: createLogger4(options2 && options2.log)
   };
   if (options2 && options2.transform) {
     state.transform = options2.transform;
@@ -66385,13 +66385,13 @@ async function verifyAndReceive(state, event) {
     payload
   });
 }
-var createLogger3, emitterEventNames, textDecoder, decode, Webhooks;
+var createLogger4, emitterEventNames, textDecoder, decode, Webhooks;
 var init_dist_bundle13 = __esm({
   "../../../node_modules/.pnpm/@octokit+webhooks@13.9.1/node_modules/@octokit/webhooks/dist-bundle/index.js"() {
     "use strict";
     init_dist_node4();
     init_dist_node4();
-    createLogger3 = (logger4 = {}) => {
+    createLogger4 = (logger4 = {}) => {
       if (typeof logger4.debug !== "function") {
         logger4.debug = () => {
         };
@@ -66746,7 +66746,7 @@ var init_dist_bundle13 = __esm({
           secret: options2.secret,
           additionalSecrets: options2.additionalSecrets,
           hooks: {},
-          log: createLogger3(options2.log)
+          log: createLogger4(options2.log)
         };
         this.sign = sign.bind(null, options2.secret);
         this.verify = verify.bind(null, options2.secret);
@@ -80661,7 +80661,7 @@ var require_errors2 = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.keyword$DataError = exports2.keywordError = void 0;
-    exports2.reportError = reportError;
+    exports2.reportError = reportError3;
     exports2.reportExtraError = reportExtraError;
     exports2.resetErrorsCount = resetErrorsCount;
     exports2.extendErrors = extendErrors;
@@ -80674,7 +80674,7 @@ var require_errors2 = __commonJS({
     exports2.keyword$DataError = {
       message: ({ keyword, schemaType }) => schemaType ? (0, codegen_1.str)`"${keyword}" keyword must be ${schemaType} ($data)` : (0, codegen_1.str)`"${keyword}" keyword is invalid ($data)`
     };
-    function reportError(cxt, error50 = exports2.keywordError, errorPaths, overrideAllErrors) {
+    function reportError3(cxt, error50 = exports2.keywordError, errorPaths, overrideAllErrors) {
       const { it: it13 } = cxt;
       const { gen, compositeRule, allErrors } = it13;
       const errObj = errorObjectCode(cxt, error50, errorPaths);
@@ -485174,6 +485174,222 @@ function commandGroup(cli, name2, description, subcommands) {
   });
 }
 
+// ../task-context/lib/CliError.js
+var CliError = class _CliError extends Error {
+  code;
+  docsLink;
+  constructor({ message, code: code5, docsLink }) {
+    super(message);
+    Object.setPrototypeOf(this, _CliError.prototype);
+    this.code = code5;
+    this.docsLink = docsLink;
+  }
+  static authRequired(message) {
+    return new _CliError({
+      message: message ?? "Authentication required. Please run 'fern login' or set the FERN_TOKEN environment variable.",
+      code: _CliError.Code.AuthError
+    });
+  }
+  static unauthorized(message) {
+    return new _CliError({
+      message: message ?? "Unauthorized. Please run 'fern auth login' or set the FERN_TOKEN environment variable.",
+      code: _CliError.Code.AuthError
+    });
+  }
+  static notFound(message) {
+    return new _CliError({ message, code: _CliError.Code.ConfigError });
+  }
+  static badRequest(message) {
+    return new _CliError({ message, code: _CliError.Code.NetworkError });
+  }
+  static validationError(message) {
+    return new _CliError({ message, code: _CliError.Code.ValidationError });
+  }
+  static internalError(message) {
+    return new _CliError({ message, code: _CliError.Code.InternalError });
+  }
+};
+(function(CliError4) {
+  CliError4.Code = {
+    InternalError: "INTERNAL_ERROR",
+    ResolutionError: "RESOLUTION_ERROR",
+    IrConversionError: "IR_CONVERSION_ERROR",
+    ContainerError: "CONTAINER_ERROR",
+    VersionError: "VERSION_ERROR",
+    ParseError: "PARSE_ERROR",
+    EnvironmentError: "ENVIRONMENT_ERROR",
+    ReferenceError: "REFERENCE_ERROR",
+    ValidationError: "VALIDATION_ERROR",
+    NetworkError: "NETWORK_ERROR",
+    AuthError: "AUTH_ERROR",
+    ConfigError: "CONFIG_ERROR"
+  };
+})(CliError || (CliError = {}));
+var SENTRY_REPORTABLE = {
+  [CliError.Code.InternalError]: true,
+  [CliError.Code.ResolutionError]: true,
+  [CliError.Code.IrConversionError]: true,
+  [CliError.Code.ContainerError]: true,
+  [CliError.Code.VersionError]: true,
+  [CliError.Code.ParseError]: false,
+  [CliError.Code.EnvironmentError]: false,
+  [CliError.Code.ReferenceError]: false,
+  [CliError.Code.ValidationError]: false,
+  [CliError.Code.NetworkError]: false,
+  [CliError.Code.AuthError]: false,
+  [CliError.Code.ConfigError]: false
+};
+function shouldReportToSentry(code5) {
+  return SENTRY_REPORTABLE[code5];
+}
+function isSchemaValidationError(error50) {
+  return error50 instanceof Error && (error50.constructor.name === "ParseError" || error50.constructor.name === "JsonError");
+}
+function isNodeVersionError(error50) {
+  return error50 instanceof Error && error50.message.includes("globalThis");
+}
+function resolveErrorCode(error50, explicitCode) {
+  if (explicitCode != null) {
+    return explicitCode;
+  }
+  if (error50 instanceof CliError) {
+    return error50.code;
+  }
+  if (isSchemaValidationError(error50)) {
+    return CliError.Code.ParseError;
+  }
+  if (isNodeVersionError(error50)) {
+    return CliError.Code.EnvironmentError;
+  }
+  return CliError.Code.InternalError;
+}
+
+// ../logger/lib/LogLevel.js
+var LogLevel = {
+  Trace: "trace",
+  Debug: "debug",
+  Info: "info",
+  Warn: "warn",
+  Error: "error"
+};
+var LOG_LEVELS = Object.values(LogLevel);
+
+// ../logger/lib/createLogger.js
+var LoggerImpl = class {
+  log;
+  enabled;
+  constructor(log4, enabled = true) {
+    this.log = log4;
+    this.enabled = enabled;
+  }
+  disable() {
+    this.enabled = false;
+  }
+  enable() {
+    this.enabled = true;
+  }
+  debug(...args) {
+    if (this.enabled) {
+      this.log(LogLevel.Debug, ...args);
+    }
+  }
+  info(...args) {
+    if (this.enabled) {
+      this.log(LogLevel.Info, ...args);
+    }
+  }
+  warn(...args) {
+    if (this.enabled) {
+      this.log(LogLevel.Warn, ...args);
+    }
+  }
+  error(...args) {
+    if (this.enabled) {
+      this.log(LogLevel.Error, ...args);
+    }
+  }
+  trace(...args) {
+    if (this.enabled) {
+      this.log(LogLevel.Trace, ...args);
+    }
+  }
+};
+function createLogger(log4) {
+  return new LoggerImpl(log4);
+}
+
+// ../logger/lib/console.js
+var CONSOLE_LOGGER = Object.freeze(createLogger(log3));
+function log3(level, ...args) {
+  const consoleLogger = getConsoleLoggerForLevel(level);
+  consoleLogger(...args);
+}
+function getConsoleLoggerForLevel(level) {
+  switch (level) {
+    case LogLevel.Trace:
+      return console.trace;
+    case LogLevel.Debug:
+      return console.debug;
+    case LogLevel.Info:
+      return console.info;
+    case LogLevel.Warn:
+      return console.warn;
+    case LogLevel.Error:
+      return console.error;
+  }
+}
+
+// ../task-context/lib/TaskAbortSignal.js
+var TaskAbortSignal = class {
+  __brand = "TaskAbortSignal";
+};
+
+// ../task-context/lib/TaskContext.js
+var TaskResult;
+(function(TaskResult2) {
+  TaskResult2[TaskResult2["Success"] = 0] = "Success";
+  TaskResult2[TaskResult2["Failure"] = 1] = "Failure";
+})(TaskResult || (TaskResult = {}));
+
+// ../task-context/lib/MockTaskContext.js
+function createMockTaskContext({ logger: logger4 = CONSOLE_LOGGER } = {}) {
+  const context3 = {
+    logger: logger4,
+    takeOverTerminal: () => {
+      throw new Error("Not implemented");
+    },
+    failAndThrow: (message, error50, _options) => {
+      const parts = [];
+      if (message != null) {
+        parts.push(message);
+      }
+      if (error50 != null) {
+        parts.push(JSON.stringify(error50));
+      }
+      if (parts.length > 0) {
+        context3.logger.error(...parts);
+      }
+      throw new TaskAbortSignal();
+    },
+    failWithoutThrowing: (message, error50, _options) => {
+      context3.failAndThrow(message, error50);
+    },
+    captureException: () => {
+    },
+    getResult: () => TaskResult.Success,
+    addInteractiveTask: () => {
+      throw new Error("Not implemented");
+    },
+    runInteractiveTask: () => {
+      throw new Error("Not implemented");
+    },
+    instrumentPostHogEvent: () => {
+      throw new Error("Not implemented");
+    }
+  };
+  return context3;
+}
+
 // ../../../node_modules/.pnpm/chalk@5.6.2/node_modules/chalk/source/vendor/ansi-styles/index.js
 var ANSI_BACKGROUND_OFFSET = 10;
 var wrapAnsi16 = (offset2 = 0) => (code5) => `\x1B[${code5 + offset2}m`;
@@ -518729,17 +518945,17 @@ var FernDocsConfigTimeoutError = class extends Error {
 };
 
 // ../configuration/lib/docs-yml/schemas/sdk/core/logging/logger.js
-var LogLevel = {
+var LogLevel2 = {
   Debug: "debug",
   Info: "info",
   Warn: "warn",
   Error: "error"
 };
 var logLevelMap2 = {
-  [LogLevel.Debug]: 1,
-  [LogLevel.Info]: 2,
-  [LogLevel.Warn]: 3,
-  [LogLevel.Error]: 4
+  [LogLevel2.Debug]: 1,
+  [LogLevel2.Info]: 2,
+  [LogLevel2.Warn]: 3,
+  [LogLevel2.Error]: 4
 };
 var ConsoleLogger = class {
   debug(message, ...args) {
@@ -518781,7 +518997,7 @@ var Logger = class {
    * @returns True if debug logs should be output
    */
   isDebug() {
-    return this.shouldLog(LogLevel.Debug);
+    return this.shouldLog(LogLevel2.Debug);
   }
   /**
    * Logs a debug message if debug logging is enabled.
@@ -518798,7 +519014,7 @@ var Logger = class {
    * @returns True if info logs should be output
    */
   isInfo() {
-    return this.shouldLog(LogLevel.Info);
+    return this.shouldLog(LogLevel2.Info);
   }
   /**
    * Logs an info message if info logging is enabled.
@@ -518815,7 +519031,7 @@ var Logger = class {
    * @returns True if warning logs should be output
    */
   isWarn() {
-    return this.shouldLog(LogLevel.Warn);
+    return this.shouldLog(LogLevel2.Warn);
   }
   /**
    * Logs a warning message if warning logging is enabled.
@@ -518832,7 +519048,7 @@ var Logger = class {
    * @returns True if error logs should be output
    */
   isError() {
-    return this.shouldLog(LogLevel.Error);
+    return this.shouldLog(LogLevel2.Error);
   }
   /**
    * Logs an error message if error logging is enabled.
@@ -518846,7 +519062,7 @@ var Logger = class {
   }
 };
 var defaultLogger = new Logger({
-  level: LogLevel.Info,
+  level: LogLevel2.Info,
   logger: new ConsoleLogger(),
   silent: true
 });
@@ -518854,7 +519070,7 @@ var defaultLogger = new Logger({
 // ../configuration/lib/docs-yml/schemas/sdk/core/logging/exports.js
 var logging;
 (function(logging2) {
-  logging2.LogLevel = LogLevel;
+  logging2.LogLevel = LogLevel2;
   logging2.ConsoleLogger = ConsoleLogger;
 })(logging || (logging = {}));
 
@@ -555047,142 +555263,6 @@ function joinZodPath(arr) {
 
 // ../configuration-loader/lib/dependencies-yml/convertDependenciesConfiguration.js
 init_lib6();
-
-// ../task-context/lib/LoggableFernCliError.js
-var LoggableFernCliError = class _LoggableFernCliError extends Error {
-  log;
-  constructor(log4) {
-    super();
-    this.log = log4;
-    Object.setPrototypeOf(this, _LoggableFernCliError.prototype);
-  }
-};
-
-// ../logger/lib/LogLevel.js
-var LogLevel2 = {
-  Trace: "trace",
-  Debug: "debug",
-  Info: "info",
-  Warn: "warn",
-  Error: "error"
-};
-var LOG_LEVELS = Object.values(LogLevel2);
-
-// ../logger/lib/createLogger.js
-var LoggerImpl = class {
-  log;
-  enabled;
-  constructor(log4, enabled = true) {
-    this.log = log4;
-    this.enabled = enabled;
-  }
-  disable() {
-    this.enabled = false;
-  }
-  enable() {
-    this.enabled = true;
-  }
-  debug(...args) {
-    if (this.enabled) {
-      this.log(LogLevel2.Debug, ...args);
-    }
-  }
-  info(...args) {
-    if (this.enabled) {
-      this.log(LogLevel2.Info, ...args);
-    }
-  }
-  warn(...args) {
-    if (this.enabled) {
-      this.log(LogLevel2.Warn, ...args);
-    }
-  }
-  error(...args) {
-    if (this.enabled) {
-      this.log(LogLevel2.Error, ...args);
-    }
-  }
-  trace(...args) {
-    if (this.enabled) {
-      this.log(LogLevel2.Trace, ...args);
-    }
-  }
-};
-function createLogger4(log4) {
-  return new LoggerImpl(log4);
-}
-
-// ../logger/lib/console.js
-var CONSOLE_LOGGER = Object.freeze(createLogger4(log3));
-function log3(level, ...args) {
-  const consoleLogger = getConsoleLoggerForLevel(level);
-  consoleLogger(...args);
-}
-function getConsoleLoggerForLevel(level) {
-  switch (level) {
-    case LogLevel2.Trace:
-      return console.trace;
-    case LogLevel2.Debug:
-      return console.debug;
-    case LogLevel2.Info:
-      return console.info;
-    case LogLevel2.Warn:
-      return console.warn;
-    case LogLevel2.Error:
-      return console.error;
-  }
-}
-
-// ../task-context/lib/TaskAbortSignal.js
-var TaskAbortSignal = class {
-  __brand = "TaskAbortSignal";
-};
-
-// ../task-context/lib/TaskContext.js
-var TaskResult;
-(function(TaskResult2) {
-  TaskResult2[TaskResult2["Success"] = 0] = "Success";
-  TaskResult2[TaskResult2["Failure"] = 1] = "Failure";
-})(TaskResult || (TaskResult = {}));
-
-// ../task-context/lib/MockTaskContext.js
-function createMockTaskContext({ logger: logger4 = CONSOLE_LOGGER } = {}) {
-  const context3 = {
-    logger: logger4,
-    takeOverTerminal: () => {
-      throw new Error("Not implemented");
-    },
-    failAndThrow: (message, error50) => {
-      const parts = [];
-      if (message != null) {
-        parts.push(message);
-      }
-      if (error50 != null) {
-        parts.push(JSON.stringify(error50));
-      }
-      if (parts.length > 0) {
-        context3.logger.error(...parts);
-      }
-      throw new TaskAbortSignal();
-    },
-    failWithoutThrowing: (message, error50) => {
-      context3.failAndThrow(message, error50);
-    },
-    getResult: () => TaskResult.Success,
-    addInteractiveTask: () => {
-      throw new Error("Not implemented");
-    },
-    runInteractiveTask: () => {
-      throw new Error("Not implemented");
-    },
-    instrumentPostHogEvent: () => {
-      throw new Error("Not implemented");
-    }
-  };
-  return context3;
-}
-
-// ../configuration-loader/lib/dependencies-yml/convertDependenciesConfiguration.js
 var import_path21 = __toESM(require("path"), 1);
 var EMPTY_DEPENDENCIES_CONFIGURATION = {
   dependencies: {}
@@ -571169,7 +571249,7 @@ function getInline2(typeDeclaration2) {
 function getTypeDeclaration(typeId, types4) {
   const maybeTypeDeclaration = types4[typeId];
   if (maybeTypeDeclaration == null) {
-    throw new LoggableFernCliError(`Illegal Error: Failed to load type declaration for type ${typeId}`);
+    throw CliError.internalError(`Failed to load type declaration for type ${typeId}`);
   }
   return maybeTypeDeclaration;
 }
@@ -571231,7 +571311,7 @@ function getObjectTypeDeclarationFromTypeId(typeId, ir15) {
       }
     }
   }
-  throw new LoggableFernCliError(`Unexpected error: ${typeId} is extended but has shape ${typeDeclaration2.shape.type}`);
+  throw CliError.internalError(`Unexpected error: ${typeId} is extended but has shape ${typeDeclaration2.shape.type}`);
 }
 function getAllPropertiesForObject2({ objectTypeDeclaration, ir: ir15 }) {
   const extendedProperties = objectTypeDeclaration.extends.flatMap((extended) => {
@@ -579493,7 +579573,8 @@ function formatLog({ breadcrumbs = [], title: title3, subtitle }) {
 }
 
 // ../cli-logger/lib/logErrorMessage.js
-function logErrorMessage({ message, error: error50, logger: logger4, logLevel = LogLevel2.Error }) {
+var USE_NODE_18_OR_ABOVE_MESSAGE = "The Fern CLI requires Node 18+ or above.";
+function logErrorMessage({ message, error: error50, logger: logger4, logLevel = LogLevel.Error }) {
   if (message != null) {
     logger4.log(logLevel, message);
   } else if (error50 == null) {
@@ -579518,6 +579599,9 @@ function convertErrorToString(error50) {
     return error50;
   }
   if (error50 instanceof Error) {
+    if (error50?.message?.includes("globalThis")) {
+      return USE_NODE_18_OR_ABOVE_MESSAGE;
+    }
     return error50.message;
   }
   return void 0;
@@ -580301,13 +580385,13 @@ function formatLog2(log4, { includeDebugInfo }) {
   }
   content5 += "\n";
   switch (log4.level) {
-    case LogLevel2.Error:
+    case LogLevel.Error:
       return source_default.red(content5);
-    case LogLevel2.Warn:
+    case LogLevel.Warn:
       return source_default.hex("FFA500")(content5);
-    case LogLevel2.Trace:
-    case LogLevel2.Debug:
-    case LogLevel2.Info:
+    case LogLevel.Trace:
+    case LogLevel.Debug:
+    case LogLevel.Info:
       return content5;
   }
 }
@@ -580317,15 +580401,15 @@ function getDebugPrefix(log4) {
 }
 function getLogLevelAsString(logLevel) {
   switch (logLevel) {
-    case LogLevel2.Trace:
+    case LogLevel.Trace:
       return "TRACE";
-    case LogLevel2.Debug:
+    case LogLevel.Debug:
       return "DEBUG";
-    case LogLevel2.Info:
+    case LogLevel.Info:
       return "INFO";
-    case LogLevel2.Warn:
+    case LogLevel.Warn:
       return "WARN";
-    case LogLevel2.Error:
+    case LogLevel.Error:
       return "ERROR";
     default:
       assertNever(logLevel);
@@ -606050,22 +606134,22 @@ var ErrorCollector2 = class {
       }
       switch (level) {
         case APIErrorLevel.ERROR:
-          this.logger.log(LogLevel2.Debug, error50.message);
+          this.logger.log(LogLevel.Debug, error50.message);
           if (error50.path && error50.path.length > 0) {
             const sourceLocation = await this.breadcrumbToLineNumberMapper?.getSourceLocation(error50.path);
             const locationInfo = sourceLocation ? `${this.relativeFilepathToSpec}:${sourceLocation.line}:${sourceLocation.column}` : error50.path.join(" -> ");
-            this.logger.log(LogLevel2.Debug, `	- at location (${locationInfo})`);
+            this.logger.log(LogLevel.Debug, `	- at location (${locationInfo})`);
           }
           break;
         case APIErrorLevel.WARNING:
-          this.logger.log(LogLevel2.Warn, error50.message);
+          this.logger.log(LogLevel.Warn, error50.message);
           if (error50.path && error50.path.length > 0) {
             const sourceLocation = await this.breadcrumbToLineNumberMapper?.getSourceLocation(error50.path);
             const locationInfo = sourceLocation ? `${this.relativeFilepathToSpec}:${sourceLocation.line}:${sourceLocation.column}` : error50.path.join(" -> ");
-            this.logger.log(LogLevel2.Warn, `	- at location (${locationInfo})`);
+            this.logger.log(LogLevel.Warn, `	- at location (${locationInfo})`);
           }
           if (error50.resolution) {
-            this.logger.log(LogLevel2.Warn, `	- resolution: ${error50.resolution}`);
+            this.logger.log(LogLevel.Warn, `	- resolution: ${error50.resolution}`);
           }
           break;
       }
@@ -606094,7 +606178,7 @@ var BreadcrumbToLineNumber = class {
       jsYaml.load(fileContent, { listener: this.map.listen() });
       this.initialized = true;
     } catch (error50) {
-      this.logger.log(LogLevel2.Warn, `Failed to initialize line number mapping for ${this.relativePathToFile}: ${JSON.stringify(error50)}`);
+      this.logger.log(LogLevel.Warn, `Failed to initialize line number mapping for ${this.relativePathToFile}: ${JSON.stringify(error50)}`);
     }
   }
   /**
@@ -619363,851 +619447,16 @@ async function runRulesOnOSSWorkspace({ workspace, context: context3, rules }) {
   return ruleResults.flat();
 }
 
-// ../cli-v2/lib/context/adapter/TaskContextLogger.js
-var TaskContextLogger = class {
-  context;
-  task;
-  logLevel;
-  enabled = true;
-  collectedErrors = [];
-  constructor({ context: context3, task, logLevel = LogLevel2.Warn }) {
-    this.context = context3;
-    this.task = task;
-    this.logLevel = logLevel;
-  }
-  disable() {
-    this.enabled = false;
-  }
-  enable() {
-    this.enabled = true;
-  }
-  trace(..._args) {
-  }
-  debug(...args) {
-    const message = args.join(" ");
-    this.writeLog({ level: LogLevel2.Debug, message });
-    if (this.shouldLogToTask(LogLevel2.Debug)) {
-      if (this.task.logs == null) {
-        this.task.logs = [];
-      }
-      this.task.logs.push({ level: "debug", message });
-    }
-  }
-  info(...args) {
-    const message = args.join(" ");
-    this.writeLog({ level: LogLevel2.Info, message });
-    if (this.shouldLogToTask(LogLevel2.Info)) {
-      if (this.task.logs == null) {
-        this.task.logs = [];
-      }
-      this.task.logs.push({ level: "debug", message });
-    }
-  }
-  warn(...args) {
-    const message = args.join(" ");
-    this.writeLog({ level: LogLevel2.Warn, message });
-    if (this.shouldLogToTask(LogLevel2.Warn)) {
-      if (this.task.logs == null) {
-        this.task.logs = [];
-      }
-      this.task.logs.push({ level: "warn", message });
-    }
-  }
-  error(...args) {
-    const message = args.join(" ");
-    this.writeLog({ level: LogLevel2.Error, message });
-    if (this.shouldLogToTask(LogLevel2.Error)) {
-      this.collectedErrors.push(message);
-      if (this.task.logs == null) {
-        this.task.logs = [];
-      }
-      this.task.logs.push({ level: "error", message });
-    }
-  }
-  log(level, ...args) {
-    switch (level) {
-      case LogLevel2.Debug:
-        this.debug(...args);
-        break;
-      case LogLevel2.Info:
-        this.info(...args);
-        break;
-      case LogLevel2.Warn:
-        this.warn(...args);
-        break;
-      case LogLevel2.Error:
-        this.error(...args);
-        break;
-    }
-  }
-  /**
-   * Write a log entry to the log file. In CI / non-TTY environments,
-   * also write directly to stderr so logs are visible in CI runner output.
-   */
-  writeLog({ level, message }) {
-    this.context.logs.write({ taskName: this.task.name, level, message });
-    if (this.context.isTTY) {
-      return;
-    }
-    if (!this.enabled) {
-      return;
-    }
-    const prefix2 = source_default.dim(`[${this.task.name}]`);
-    switch (level) {
-      case LogLevel2.Warn:
-        process.stderr.write(`${prefix2}: ${source_default.yellow(message)}
-`);
-        break;
-      case LogLevel2.Error:
-        process.stderr.write(`${prefix2}: ${source_default.red(message)}
-`);
-        break;
-      default:
-        process.stderr.write(`${prefix2}: ${message}
-`);
-        break;
-    }
-  }
-  /**
-   * Check if a message at the given level should be logged to the task's UI.
-   */
-  shouldLogToTask(level) {
-    return this.enabled && LOG_LEVELS.indexOf(level) >= LOG_LEVELS.indexOf(this.logLevel);
-  }
-};
-
-// ../cli-v2/lib/context/adapter/TaskContextAdapter.js
-var TaskContextAdapter = class {
-  result = TaskResult.Success;
-  logger;
-  constructor({ context: context3, task, logLevel = LogLevel2.Warn }) {
-    if (task != null) {
-      this.logger = new TaskContextLogger({ context: context3, task, logLevel });
-    } else {
-      this.logger = createLogger4((level, ...args) => {
-        if (LOG_LEVELS.indexOf(level) >= LOG_LEVELS.indexOf(logLevel)) {
-          context3.stderr.log(level, ...args);
-        }
-      });
-    }
-  }
-  async takeOverTerminal(run) {
-    await run();
-  }
-  failAndThrow(message, error50) {
-    this.failWithoutThrowing(message, error50);
-    throw new TaskAbortSignal();
-  }
-  failWithoutThrowing(message, error50) {
-    const fullMessage = this.getFullErrorMessage(message, error50);
-    if (fullMessage != null) {
-      this.logger.error(fullMessage);
-    }
-    this.result = TaskResult.Failure;
-  }
-  getFullErrorMessage(message, error50) {
-    const errorDetails = this.formatError(error50);
-    if (message != null && errorDetails != null) {
-      return message.includes(errorDetails) ? message : `${message}: ${errorDetails}`;
-    }
-    return message ?? errorDetails;
-  }
-  getResult() {
-    return this.result;
-  }
-  addInteractiveTask(_params) {
-    const subtask = {
-      logger: this.logger,
-      takeOverTerminal: this.takeOverTerminal.bind(this),
-      failAndThrow: this.failAndThrow.bind(this),
-      failWithoutThrowing: this.failWithoutThrowing.bind(this),
-      getResult: () => this.result,
-      addInteractiveTask: this.addInteractiveTask.bind(this),
-      runInteractiveTask: this.runInteractiveTask.bind(this),
-      instrumentPostHogEvent: this.instrumentPostHogEvent.bind(this),
-      setSubtitle: (_subtitle) => {
-      },
-      start: () => {
-        return subtask;
-      },
-      isStarted: () => true,
-      finish: () => {
-      },
-      isFinished: () => true
-    };
-    return subtask;
-  }
-  async runInteractiveTask(params2, run) {
-    const subtask = this.addInteractiveTask(params2).start();
-    try {
-      await run(subtask);
-      return true;
-    } catch {
-      return false;
-    }
-  }
-  instrumentPostHogEvent(_event) {
-  }
-  formatError(error50) {
-    if (error50 == null) {
-      return void 0;
-    }
-    if (error50 instanceof Error) {
-      return error50.message;
-    }
-    if (typeof error50 === "string") {
-      return error50;
-    }
-    if (typeof error50 === "object") {
-      const message = this.extractErrorMessage(error50);
-      if (message != null) {
-        return message;
-      }
-    }
-    try {
-      return JSON.stringify(error50);
-    } catch {
-      return String(error50);
-    }
-  }
-  /**
-   * Attempts to extract a human-readable message from a structured error object.
-   *
-   * Handles common shapes from the FDR SDK and other API clients, e.g.:
-   *   { content: { body: { message: "..." } } }
-   *   { body: { message: "..." } }
-   *   { message: "..." }
-   */
-  extractErrorMessage(error50) {
-    const record21 = error50;
-    if (typeof record21.message === "string") {
-      return record21.message;
-    }
-    if (record21.body != null && typeof record21.body === "object") {
-      const body = record21.body;
-      if (typeof body.message === "string") {
-        return body.message;
-      }
-    }
-    if (record21.content != null && typeof record21.content === "object") {
-      return this.extractErrorMessage(record21.content);
-    }
-    return void 0;
-  }
-};
-
-// ../cli-v2/lib/api/adapter/LegacyApiSpecAdapter.js
-init_lib6();
-
-// ../cli-v2/lib/api/config/OpenRpcSpec.js
-function isOpenRpcSpec(spec) {
-  return "openrpc" in spec;
-}
-
-// ../cli-v2/lib/api/config/ProtobufSpec.js
-function isProtobufSpec(spec) {
-  return "proto" in spec;
-}
-
-// ../cli-v2/lib/api/adapter/LegacyApiSpecAdapter.js
-var LegacyApiSpecAdapter = class {
-  context;
-  constructor(config5) {
-    this.context = config5.context;
-  }
-  adapt(spec) {
-    if (isOpenApiSpec(spec)) {
-      return this.adaptOpenApiSpec(spec);
-    }
-    if (isAsyncApiSpec(spec)) {
-      return this.adaptAsyncApiSpec(spec);
-    }
-    if (isProtobufSpec(spec)) {
-      return this.adaptProtobufSpec(spec);
-    }
-    if (isOpenRpcSpec(spec)) {
-      return this.adaptOpenRpcSpec(spec);
-    }
-    throw new Error(`Unsupported spec type: ${JSON.stringify(spec)}`);
-  }
-  convertAll(specs) {
-    return specs.map((spec) => this.adapt(spec));
-  }
-  adaptOpenApiSpec(spec) {
-    return {
-      type: "openapi",
-      absoluteFilepath: spec.openapi,
-      absoluteFilepathToOverrides: spec.overrides,
-      absoluteFilepathToOverlays: spec.overlays,
-      namespace: spec.namespace,
-      source: {
-        type: "openapi",
-        file: spec.openapi
-      },
-      settings: this.adaptOpenApiSettings(spec.settings)
-    };
-  }
-  adaptAsyncApiSpec(spec) {
-    return {
-      type: "openapi",
-      absoluteFilepath: spec.asyncapi,
-      absoluteFilepathToOverrides: spec.overrides,
-      absoluteFilepathToOverlays: void 0,
-      namespace: spec.namespace,
-      source: {
-        type: "asyncapi",
-        file: spec.asyncapi
-      },
-      settings: this.adaptAsyncApiSettings(spec.settings)
-    };
-  }
-  adaptProtobufSpec(spec) {
-    const proto3 = spec.proto;
-    return {
-      type: "protobuf",
-      absoluteFilepathToProtobufRoot: proto3.root,
-      absoluteFilepathToProtobufTarget: proto3.target,
-      absoluteFilepathToOverrides: proto3.overrides,
-      relativeFilepathToProtobufRoot: relativize(this.context.cwd, proto3.root),
-      generateLocally: proto3.localGeneration ?? false,
-      fromOpenAPI: proto3.fromOpenapi ?? false,
-      dependencies: proto3.dependencies?.map((dep) => dep.toString()) ?? [],
-      settings: void 0
-    };
-  }
-  adaptOpenRpcSpec(spec) {
-    return {
-      type: "openrpc",
-      absoluteFilepath: spec.openrpc,
-      absoluteFilepathToOverrides: spec.overrides,
-      namespace: void 0
-    };
-  }
-  adaptOpenApiSettings(settings) {
-    if (settings == null) {
-      return void 0;
-    }
-    const result = {
-      // Base API settings
-      respectNullableSchemas: settings.respectNullableSchemas,
-      wrapReferencesToNullableInOptional: settings.wrapReferencesToNullableInOptional,
-      coerceOptionalSchemasToNullable: settings.coerceOptionalSchemasToNullable,
-      useTitlesAsName: settings.titleAsSchemaName,
-      coerceEnumsToLiterals: settings.coerceEnumsToLiterals,
-      optionalAdditionalProperties: settings.optionalAdditionalProperties,
-      shouldUseIdiomaticRequestNames: settings.idiomaticRequestNames,
-      groupEnvironmentsByHost: settings.groupEnvironmentsByHost,
-      removeDiscriminantsFromSchemas: this.adaptRemoveDiscriminantsFromSchemas(settings.removeDiscriminantsFromSchemas),
-      pathParameterOrder: this.adaptPathParameterOrder(settings.pathParameterOrder),
-      // OpenAPI-specific settings
-      respectReadonlySchemas: settings.respectReadonlySchemas,
-      onlyIncludeReferencedSchemas: settings.onlyIncludeReferencedSchemas,
-      inlinePathParameters: settings.inlinePathParameters,
-      shouldUseUndiscriminatedUnionsWithLiterals: settings.preferUndiscriminatedUnionsWithLiterals,
-      objectQueryParameters: settings.objectQueryParameters,
-      respectForwardCompatibleEnums: settings.respectForwardCompatibleEnums,
-      useBytesForBinaryResponse: settings.useBytesForBinaryResponse,
-      defaultFormParameterEncoding: settings.defaultFormParameterEncoding,
-      filter: settings.filter,
-      exampleGeneration: this.adaptExampleGeneration(settings.exampleGeneration),
-      additionalPropertiesDefaultsTo: settings.additionalPropertiesDefaultsTo,
-      typeDatesAsStrings: settings.typeDatesAsStrings,
-      preserveSingleSchemaOneOf: settings.preserveSingleSchemaOneof,
-      inlineAllOfSchemas: settings.inlineAllOfSchemas,
-      resolveAliases: settings.resolveAliases,
-      groupMultiApiEnvironments: settings.groupMultiApiEnvironments,
-      defaultIntegerFormat: this.adaptDefaultIntegerFormat(settings.defaultIntegerFormat),
-      coerceConstsTo: settings.coerceConstsTo
-    };
-    const hasSettings = Object.values(result).some((v23) => v23 != null);
-    return hasSettings ? result : void 0;
-  }
-  adaptAsyncApiSettings(settings) {
-    if (settings == null) {
-      return void 0;
-    }
-    const result = {
-      // Base API settings (shared)
-      respectNullableSchemas: settings.respectNullableSchemas,
-      wrapReferencesToNullableInOptional: settings.wrapReferencesToNullableInOptional,
-      coerceOptionalSchemasToNullable: settings.coerceOptionalSchemasToNullable,
-      useTitlesAsName: settings.titleAsSchemaName,
-      coerceEnumsToLiterals: settings.coerceEnumsToLiterals,
-      optionalAdditionalProperties: settings.optionalAdditionalProperties,
-      shouldUseIdiomaticRequestNames: settings.idiomaticRequestNames,
-      groupEnvironmentsByHost: settings.groupEnvironmentsByHost,
-      removeDiscriminantsFromSchemas: this.adaptRemoveDiscriminantsFromSchemas(settings.removeDiscriminantsFromSchemas),
-      pathParameterOrder: this.adaptPathParameterOrder(settings.pathParameterOrder),
-      // AsyncAPI-specific settings
-      asyncApiNaming: settings.messageNaming,
-      coerceConstsTo: settings.coerceConstsTo
-    };
-    const hasSettings = Object.values(result).some((v23) => v23 != null);
-    return hasSettings ? result : void 0;
-  }
-  adaptRemoveDiscriminantsFromSchemas(value) {
-    if (value == null) {
-      return void 0;
-    }
-    switch (value) {
-      case "always":
-        return generators_yml_exports.RemoveDiscriminantsFromSchemas.Always;
-      case "never":
-        return generators_yml_exports.RemoveDiscriminantsFromSchemas.Never;
-      default:
-        return void 0;
-    }
-  }
-  adaptPathParameterOrder(value) {
-    if (value == null) {
-      return void 0;
-    }
-    switch (value) {
-      case "urlOrder":
-        return generators_yml_exports.PathParameterOrder.UrlOrder;
-      case "specOrder":
-        return generators_yml_exports.PathParameterOrder.SpecOrder;
-      default:
-        return void 0;
-    }
-  }
-  adaptDefaultIntegerFormat(value) {
-    if (value == null) {
-      return void 0;
-    }
-    switch (value) {
-      case "int32":
-        return generators_yml_exports.DefaultIntegerFormat.Int32;
-      case "int64":
-        return generators_yml_exports.DefaultIntegerFormat.Int64;
-      case "uint32":
-        return generators_yml_exports.DefaultIntegerFormat.Uint32;
-      case "uint64":
-        return generators_yml_exports.DefaultIntegerFormat.Uint64;
-      default:
-        return void 0;
-    }
-  }
-  adaptExampleGeneration(value) {
-    if (value == null) {
-      return void 0;
-    }
-    const result = {};
-    if (value.request != null) {
-      result.request = { "max-depth": value.request.maxDepth };
-    }
-    if (value.response != null) {
-      result.response = { "max-depth": value.response.maxDepth };
-    }
-    return result;
-  }
-};
-
-// ../cli-v2/lib/api/config/ConjureSpec.js
-function isConjureSpec(spec) {
-  return "conjure" in spec;
-}
-
-// ../cli-v2/lib/api/validator/ApiDefinitionValidator.js
-var ApiDefinitionValidator = class {
-  context;
-  taskContext;
-  cliVersion;
-  constructor(config5) {
-    this.context = config5.context;
-    this.taskContext = new TaskContextAdapter({ context: this.context, task: config5.task });
-    this.cliVersion = config5.cliVersion;
-  }
-  /**
-   * Validate an ApiDefinition.
-   *
-   * Runs both Fern definition validation and OSS workspace validation
-   * to ensure the API definition is valid before generation.
-   */
-  async validate(definition3) {
-    const startTime = performance.now();
-    const violations = [];
-    const fernSpec = definition3.specs.find(isFernSpec);
-    if (fernSpec != null) {
-      const fernViolations = await this.validateFernSpec(fernSpec);
-      violations.push(...fernViolations);
-      return {
-        violations,
-        hasErrors: violations.some((v23) => v23.severity === "fatal" || v23.severity === "error"),
-        workspaceRoot: fernSpec.fern,
-        elapsedMillis: performance.now() - startTime
-      };
-    }
-    const conjureSpec = definition3.specs.find(isConjureSpec);
-    if (conjureSpec != null) {
-      return {
-        violations: [],
-        hasErrors: false,
-        workspaceRoot: this.context.cwd,
-        elapsedMillis: performance.now() - startTime
-      };
-    }
-    const ossViolations = await this.validateOssSpecs(definition3.specs);
-    violations.push(...ossViolations);
-    return {
-      violations,
-      hasErrors: violations.some((v23) => v23.severity === "fatal" || v23.severity === "error"),
-      workspaceRoot: this.context.cwd,
-      elapsedMillis: performance.now() - startTime
-    };
-  }
-  async validateFernSpec(spec) {
-    const violations = [];
-    const lazyWorkspace = new LazyFernWorkspace({
-      absoluteFilePath: dirname6(spec.fern),
-      context: this.taskContext,
-      cliVersion: this.cliVersion,
-      generatorsConfiguration: void 0,
-      workspaceName: void 0,
-      changelog: void 0
-    });
-    const fernWorkspace = await lazyWorkspace.toFernWorkspace({ context: this.taskContext });
-    const fernViolations = validateFernWorkspace(fernWorkspace, this.context.stderr);
-    violations.push(...fernViolations);
-    return violations;
-  }
-  async validateOssSpecs(specs) {
-    const violations = [];
-    const ossSpecs = specs.filter((spec) => !isFernSpec(spec) && !isConjureSpec(spec));
-    if (ossSpecs.length === 0) {
-      return violations;
-    }
-    const specAdapter = new LegacyApiSpecAdapter({ context: this.context });
-    const v1Specs = specAdapter.convertAll(ossSpecs);
-    const filteredSpecs = v1Specs.filter((spec) => {
-      if (spec.type === "openrpc") {
-        return false;
-      }
-      if (spec.type === "protobuf" && !spec.fromOpenAPI) {
-        return false;
-      }
-      return true;
-    });
-    const allSpecs = v1Specs.filter((spec) => {
-      if (spec.type === "protobuf" && spec.fromOpenAPI) {
-        return false;
-      }
-      return true;
-    });
-    const ossWorkspace = new OSSWorkspace({
-      specs: filteredSpecs,
-      allSpecs,
-      absoluteFilePath: this.context.cwd,
-      cliVersion: this.cliVersion,
-      changelog: void 0,
-      generatorsConfiguration: void 0,
-      workspaceName: void 0
-    });
-    const fernWorkspace = await ossWorkspace.toFernWorkspace({ context: this.taskContext });
-    const fernViolations = validateFernWorkspace(fernWorkspace, this.context.stderr);
-    violations.push(...fernViolations);
-    const ossViolations = await validateOSSWorkspace(ossWorkspace, this.taskContext);
-    violations.push(...ossViolations);
-    return violations;
-  }
-};
-
-// ../cli-v2/lib/api/checker/ApiChecker.js
-var ApiChecker = class {
-  context;
-  cliVersion;
-  task;
-  constructor(config5) {
-    this.context = config5.context;
-    this.cliVersion = config5.cliVersion;
-    this.task = config5.task;
-  }
-  /**
-   * Check APIs in the workspace and display results.
-   *
-   * @param strict - If true, display all warnings and treat them as errors. If false,
-   *                 only show errors but still report warning count in summary.
-   */
-  async check({ workspace, apiNames, strict = false }) {
-    const startTime = performance.now();
-    const validApis = /* @__PURE__ */ new Set();
-    const invalidApis = /* @__PURE__ */ new Set();
-    const apisToCheck = apiNames ?? Object.keys(workspace.apis);
-    if (apisToCheck.length === 0) {
-      return {
-        validApis,
-        invalidApis,
-        violations: [],
-        errorCount: 0,
-        warningCount: 0,
-        elapsedMillis: performance.now() - startTime
-      };
-    }
-    const validator = new ApiDefinitionValidator({
-      context: this.context,
-      cliVersion: this.cliVersion,
-      task: this.task
-    });
-    const allViolations = [];
-    for (const apiName of apisToCheck) {
-      const apiDefinition = workspace.apis[apiName];
-      if (apiDefinition == null) {
-        invalidApis.add(apiName);
-        continue;
-      }
-      const result = await validator.validate(apiDefinition);
-      if (result.hasErrors) {
-        invalidApis.add(apiName);
-      } else {
-        validApis.add(apiName);
-      }
-      const apiSpecType = apiDefinition.specs.some(isFernSpec) ? "fern" : "openapi";
-      const resolvedViolations = this.resolveViolationPaths({
-        workspaceRoot: result.workspaceRoot,
-        apiName,
-        apiSpecType,
-        apiDefinition,
-        violations: result.violations
-      });
-      allViolations.push(...resolvedViolations);
-    }
-    const dedupedViolations = this.deduplicateViolations(allViolations);
-    return {
-      ...this.countViolations(dedupedViolations),
-      validApis,
-      invalidApis,
-      violations: strict ? dedupedViolations : dedupedViolations.filter((v23) => v23.severity === "fatal" || v23.severity === "error"),
-      elapsedMillis: performance.now() - startTime
-    };
-  }
-  resolveViolationPaths({ violations, workspaceRoot, apiName, apiSpecType, apiDefinition }) {
-    return violations.map((violation) => {
-      const message = apiSpecType === "fern" ? violation.message : this.formatOssMessage(violation);
-      return {
-        ...violation,
-        message,
-        displayRelativeFilepath: this.resolveDisplayPath({
-          workspaceRoot,
-          apiDefinition,
-          apiSpecType,
-          violation
-        }),
-        apiSpecType,
-        apiName,
-        // We don't actually surface valuable line/column information yet, but
-        // this at least points to the correct file.
-        line: 1,
-        column: 1
-      };
-    });
-  }
-  /**
-   * Format a violation message for non-Fern (OSS) specs.
-   *
-   * Prepends a human-readable node path so users can locate the endpoint,
-   * then strips synthetic file paths from the body of the message.
-   */
-  formatOssMessage(violation) {
-    const strippedMessage = this.stripSyntheticFilePaths(violation.message);
-    const nodePathPrefix = this.formatNodePath(violation.nodePath);
-    if (nodePathPrefix.length === 0) {
-      return strippedMessage;
-    }
-    return `${nodePathPrefix} - ${strippedMessage}`;
-  }
-  /**
-   * Formats a NodePath into a readable string like "endpoints -> getUser".
-   *
-   * Skips the leading "service" segment since it's implicit.
-   */
-  formatNodePath(nodePath) {
-    const parts = [];
-    for (const item of nodePath) {
-      if (typeof item === "string") {
-        parts.push(item);
-      } else {
-        parts.push(item.key);
-      }
-    }
-    if (parts[0] === "service") {
-      parts.shift();
-    }
-    return parts.join(" -> ");
-  }
-  resolveDisplayPath({ workspaceRoot, apiDefinition, apiSpecType, violation }) {
-    if (apiSpecType === "fern") {
-      const absolutePath = join8(workspaceRoot, RelativeFilePath2.of(violation.relativeFilepath));
-      return relativize(this.context.cwd, absolutePath);
-    }
-    return this.resolveOssDisplayPath(apiDefinition, violation);
-  }
-  resolveOssDisplayPath(apiDefinition, violation) {
-    const ossSpecs = apiDefinition.specs.filter((s11) => isOpenApiSpec(s11) || isAsyncApiSpec(s11));
-    if (ossSpecs.length === 0) {
-      return violation.relativeFilepath;
-    }
-    if (ossSpecs.length > 1) {
-      for (const spec of ossSpecs) {
-        const namespace = isOpenApiSpec(spec) ? spec.namespace : spec.namespace;
-        if (namespace != null && violation.relativeFilepath.startsWith(namespace)) {
-          const filePath2 = isOpenApiSpec(spec) ? spec.openapi : spec.asyncapi;
-          return relativize(this.context.cwd, filePath2);
-        }
-      }
-    }
-    const firstSpec = ossSpecs[0];
-    if (firstSpec == null) {
-      return violation.relativeFilepath;
-    }
-    const filePath = isOpenApiSpec(firstSpec) ? firstSpec.openapi : firstSpec.asyncapi;
-    return relativize(this.context.cwd, filePath);
-  }
-  deduplicateViolations(violations) {
-    const seen = /* @__PURE__ */ new Set();
-    return violations.filter((v23) => {
-      const key2 = `${v23.apiName}|${v23.displayRelativeFilepath}|${v23.severity}|${JSON.stringify(v23.nodePath)}|${v23.message}`;
-      if (seen.has(key2)) {
-        return false;
-      }
-      seen.add(key2);
-      return true;
-    });
-  }
-  /**
-   * Strip synthetic file path references from violation messages for non-Fern specs.
-   *
-   * The validator produces messages like:
-   *   "- pet.yml -> getPetById /pet/{petId}"
-   * For non-Fern specs these file names are synthetic (they don't exist on disk),
-   * so we strip them to produce:
-   *   "- getPetById /pet/{petId}"
-   */
-  stripSyntheticFilePaths(message) {
-    return message.replace(/^(\s*- )\S+\.[a-zA-Z]+ -> /gm, "$1");
-  }
-  countViolations(violations) {
-    let errorCount = 0;
-    let warningCount = 0;
-    for (const violation of violations) {
-      switch (violation.severity) {
-        case "fatal":
-        case "error":
-          errorCount++;
-          break;
-        case "warning":
-          warningCount++;
-          break;
-        default:
-          assertNever(violation.severity);
-      }
-    }
-    return { errorCount, warningCount };
-  }
-};
-
-// ../cli-v2/lib/errors/CliError.js
-var CliError = class _CliError extends Error {
-  code;
-  docsLink;
-  constructor({ message, code: code5, docsLink }) {
-    super(message);
-    this.code = code5;
-    this.docsLink = docsLink;
-  }
-  static authRequired(message) {
-    return new _CliError({
-      message: message ?? "Authentication required. Please run 'fern login' or set the FERN_TOKEN environment variable.",
-      code: "AUTH_REQUIRED"
-    });
-  }
-  static generationFailed(message) {
-    return new _CliError({
-      message: message ?? "Generation failed. Please check the logs for more information.",
-      code: "GENERATION_FAILED"
-    });
-  }
-  static badRequest(message) {
-    return new _CliError({ message, code: "BAD_REQUEST_ERROR" });
-  }
-  static notFound(message) {
-    return new _CliError({ message, code: "NOT_FOUND_ERROR" });
-  }
-  static unauthorized(message) {
-    return new _CliError({
-      message: message ?? "Unauthorized. Please run 'fern auth login' or set the FERN_TOKEN environment variable.",
-      code: "UNAUTHORIZED_ERROR"
-    });
-  }
-  static validationError(message) {
-    return new _CliError({ message, code: "VALIDATION_ERROR" });
-  }
-  static internalError(message) {
-    return new _CliError({ message, code: "INTERNAL_ERROR" });
-  }
-  /**
-   * A sentinel error that causes the CLI to exit with a non-zero exit code, but no message. This
-   * is useful when a command handles the failure message itself.
-   */
-  static exit() {
-    return new _CliError({
-      message: "",
-      code: "EXIT"
-    });
-  }
-};
-
-// ../cli-v2/lib/ui/format.js
-function formatMultilineText({ text: text9, colorFn, icon, baseIndent = 4, continuationIndent = 6 }) {
-  if (text9 == null) {
-    return "";
-  }
-  const lines = text9.split("\n").filter((line) => line.trim().length > 0);
-  if (lines.length === 0) {
-    return "";
-  }
-  const baseIndentStr = " ".repeat(baseIndent);
-  const contIndentStr = " ".repeat(continuationIndent);
-  if (icon != null) {
-    const [first3, ...rest] = lines;
-    const firstLine = `
-${baseIndentStr}${icon} ${colorFn(first3 ?? "")}`;
-    const restLines = rest.map((line) => `
-${contIndentStr}${colorFn(line)}`).join("");
-    return firstLine + restLines;
-  }
-  return lines.map((line) => `
-${baseIndentStr}${colorFn(line)}`).join("");
-}
-var Icons = {
-  error: source_default.red("\u2717"),
-  warning: source_default.yellow("\u26A0"),
-  success: source_default.green("\u2713"),
-  info: source_default.cyan("\u25C6")
-};
-var Colors = {
-  error: source_default.red.bind(source_default),
-  warning: source_default.yellow.bind(source_default),
-  success: source_default.green.bind(source_default),
-  info: source_default.cyan.bind(source_default),
-  dim: source_default.dim.bind(source_default)
-};
-function formatBytes(bytes) {
-  if (bytes === 0) {
-    return "0 B";
-  }
-  const units = ["B", "KB", "MB", "GB"];
-  const base4 = 1024;
-  const index3 = Math.min(Math.floor(Math.log(bytes) / Math.log(base4)), units.length - 1);
-  const value = bytes / Math.pow(base4, index3);
-  return `${value.toFixed(index3 === 0 ? 0 : 1)} ${units[index3]}`;
-}
-
 // ../cli-v2/lib/auth/errors/KeyringUnavailableError.js
-var KeyringUnavailableError = class extends Error {
+var KeyringUnavailableError = class _KeyringUnavailableError extends CliError {
   platform;
   cause;
   constructor(platform3, cause) {
-    super(getKeyringErrorMessage(platform3));
+    super({
+      message: getKeyringErrorMessage(platform3),
+      code: CliError.Code.AuthError
+    });
+    Object.setPrototypeOf(this, _KeyringUnavailableError.prototype);
     this.platform = platform3;
     this.cause = cause;
   }
@@ -620264,23 +619513,77 @@ If running in a headless environment, use FERN_TOKEN instead:
 }
 
 // ../cli-v2/lib/errors/SourcedValidationError.js
-var SourcedValidationError = class extends Error {
+var SourcedValidationError = class _SourcedValidationError extends CliError {
   issues;
   constructor(issues) {
-    super(issues.map((issue2) => issue2.toString()).join("\n"));
+    super({
+      message: issues.map((issue2) => issue2.toString()).join("\n"),
+      code: CliError.Code.ValidationError
+    });
+    Object.setPrototypeOf(this, _SourcedValidationError.prototype);
     this.issues = issues;
   }
 };
 
 // ../cli-v2/lib/errors/ValidationError.js
-var ValidationError = class extends Error {
+var ValidationError = class _ValidationError extends CliError {
   violations;
   constructor(violations) {
-    super(violations.map((v23) => `${v23.relativeFilepath}: ${v23.message}`).join("\n"));
+    super({
+      message: violations.map((v23) => `${v23.relativeFilepath}: ${v23.message}`).join("\n"),
+      code: CliError.Code.ValidationError
+    });
+    Object.setPrototypeOf(this, _ValidationError.prototype);
     this.violations = violations;
   }
 };
 
+// ../cli-v2/lib/ui/format.js
+function formatMultilineText({ text: text9, colorFn, icon, baseIndent = 4, continuationIndent = 6 }) {
+  if (text9 == null) {
+    return "";
+  }
+  const lines = text9.split("\n").filter((line) => line.trim().length > 0);
+  if (lines.length === 0) {
+    return "";
+  }
+  const baseIndentStr = " ".repeat(baseIndent);
+  const contIndentStr = " ".repeat(continuationIndent);
+  if (icon != null) {
+    const [first3, ...rest] = lines;
+    const firstLine = `
+${baseIndentStr}${icon} ${colorFn(first3 ?? "")}`;
+    const restLines = rest.map((line) => `
+${contIndentStr}${colorFn(line)}`).join("");
+    return firstLine + restLines;
+  }
+  return lines.map((line) => `
+${baseIndentStr}${colorFn(line)}`).join("");
+}
+var Icons = {
+  error: source_default.red("\u2717"),
+  warning: source_default.yellow("\u26A0"),
+  success: source_default.green("\u2713"),
+  info: source_default.cyan("\u25C6")
+};
+var Colors = {
+  error: source_default.red.bind(source_default),
+  warning: source_default.yellow.bind(source_default),
+  success: source_default.green.bind(source_default),
+  info: source_default.cyan.bind(source_default),
+  dim: source_default.dim.bind(source_default)
+};
+function formatBytes(bytes) {
+  if (bytes === 0) {
+    return "0 B";
+  }
+  const units = ["B", "KB", "MB", "GB"];
+  const base4 = 1024;
+  const index3 = Math.min(Math.floor(Math.log(bytes) / Math.log(base4)), units.length - 1);
+  const value = bytes / Math.pow(base4, index3);
+  return `${value.toFixed(index3 === 0 ? 0 : 1)} ${units[index3]}`;
+}
+
 // ../auth/lib/orgs/checkOrganizationMembership.js
 async function checkOrganizationMembership({ organization, token }) {
   const venus = createVenusService({ token: token.value });
@@ -627700,7 +627003,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "4.68.2-6-gdbf7c6b8be3",
+          version: "4.68.3-1-g429be56b56f",
           usingAccessToken: true
         }
       });
@@ -627754,7 +627057,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "4.68.2-6-gdbf7c6b8be3",
+        version: "4.68.3-1-g429be56b56f",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -631266,7 +630569,7 @@ var TelemetryClient = class _TelemetryClient {
    * The caller is responsible for deciding which errors are worth reporting
    * (see `shouldReportToSentry` in withContext.ts).
    */
-  captureException(error50) {
+  captureException(error50, { errorCode }) {
     if (this.sentry === void 0) {
       return;
     }
@@ -631274,7 +630577,7 @@ var TelemetryClient = class _TelemetryClient {
       this.sentry.captureException(error50, {
         captureContext: {
           user: { id: this.distinctId },
-          tags: { ...this.baseTags, ...this.accumulatedTags }
+          tags: { ...this.baseTags, ...this.accumulatedTags, "error.code": errorCode }
         }
       });
     } catch {
@@ -632174,6 +631477,7 @@ var Context = class _Context {
   shutdownCallbacks = [];
   isShuttingDown = false;
   logFilePathPrinted = false;
+  createdAt = Date.now();
   cwd;
   logLevel;
   info;
@@ -632191,10 +631495,10 @@ var Context = class _Context {
   }
   constructor({ cwd: cwd2, logLevel, ttyAwareLogger, telemetry }) {
     this.cwd = cwd2 ?? AbsoluteFilePath2.of(process.cwd());
-    this.logLevel = logLevel ?? LogLevel2.Info;
+    this.logLevel = logLevel ?? LogLevel.Info;
     this.info = parseCommandInfo(process.argv);
-    this.stdout = createLogger4((level, ...args) => this.log(level, ...args));
-    this.stderr = createLogger4((level, ...args) => this.logStderr(level, ...args));
+    this.stdout = createLogger((level, ...args) => this.log(level, ...args));
+    this.stderr = createLogger((level, ...args) => this.logStderr(level, ...args));
     this.cache = new Cache({ logger: this.stderr });
     this.logs = new LogFileWriter(this.cache.logs.absoluteFilePath);
     this.ttyAwareLogger = ttyAwareLogger;
@@ -632252,7 +631556,7 @@ var Context = class _Context {
         this.stderr.warn(`${source_default.yellow("\u26A0")} You are not logged in to Fern.`);
         this.stderr.info("");
         this.stderr.info(source_default.dim("  To authenticate, run: 'fern auth login' or set the FERN_TOKEN environment variable"));
-        throw CliError.exit();
+        throw new CliError({ code: CliError.Code.AuthError });
       }
       return await this.promptAndLogin();
     }
@@ -632262,7 +631566,7 @@ var Context = class _Context {
         this.stderr.error(`${Icons.error} Your access token has expired.`);
         this.stderr.info("");
         this.stderr.info(source_default.dim("  To authenticate, run: 'fern auth login' or set the FERN_TOKEN environment variable"));
-        throw CliError.exit();
+        throw new CliError({ code: CliError.Code.AuthError });
       }
       return await this.promptAndLogin();
     }
@@ -632278,7 +631582,7 @@ var Context = class _Context {
       }
     ]);
     if (!confirm) {
-      throw CliError.exit();
+      throw new CliError({ code: CliError.Code.AuthError });
     }
     this.stderr.info(`${Icons.info} Opening browser to log in to Fern...`);
     this.stderr.info(source_default.dim("  If the browser doesn't open, try: fern auth login --device-code"));
@@ -632290,12 +631594,12 @@ var Context = class _Context {
     const payload = await verifyAndDecodeJwt(idToken);
     if (payload == null) {
       this.stderr.error(`${Icons.error} Internal error; could not verify ID token`);
-      throw CliError.exit();
+      throw new CliError({ code: CliError.Code.InternalError });
     }
     const email3 = payload.email;
     if (email3 == null) {
       this.stderr.error(`${Icons.error} Internal error; ID token does not contain email claim`);
-      throw CliError.exit();
+      throw new CliError({ code: CliError.Code.InternalError });
     }
     await this.tokenService.login(email3, accessToken);
     this.stderr.info(`${Icons.success} Logged in as ${source_default.bold(email3)}`);
@@ -632426,7 +631730,7 @@ ${source_default.dim(`Logs written to: ${this.logs.absoluteFilePath}`)}
   logImmediately(logs4, { stderr = false } = {}) {
     const filtered = logs4.filter((log4) => LOG_LEVELS.indexOf(log4.level) >= LOG_LEVELS.indexOf(this.logLevel));
     this.ttyAwareLogger.log(filtered, {
-      includeDebugInfo: this.logLevel === LogLevel2.Debug,
+      includeDebugInfo: this.logLevel === LogLevel.Debug,
       stderr
     });
   }
@@ -632439,28 +631743,19 @@ var SIGTERM_EXIT_CODE = SIGNAL_EXIT_CODE_BASE + 15;
 function withContext(handler3) {
   return async (args) => {
     const context3 = await createContext(args);
-    const startTime = Date.now();
     setupSignalHandler(context3);
     try {
       await handler3(context3, args);
       context3.telemetry.sendLifecycleEvent({
         command: context3.info.command,
         status: "success",
-        durationMs: Date.now() - startTime
+        durationMs: Date.now() - context3.createdAt
       });
       await context3.telemetry.flush();
       context3.finish();
       await exitGracefully(0);
     } catch (error50) {
-      if (shouldReportToSentry(error50)) {
-        context3.telemetry.captureException(error50);
-      }
-      context3.telemetry.sendLifecycleEvent({
-        command: context3.info.command,
-        status: "error",
-        durationMs: Date.now() - startTime,
-        errorCode: extractErrorCode(error50)
-      });
+      reportError(context3, error50);
       await context3.telemetry.flush();
       handleError(context3, error50);
       context3.finish();
@@ -632500,7 +631795,7 @@ function handleError(context3, error50) {
     return;
   }
   if (error50 instanceof CliError) {
-    if (error50.message.length > 0) {
+    if (error50.message && error50.message.length > 0) {
       process.stderr.write(`${source_default.red(error50.message)}
 `);
     }
@@ -632509,7 +631804,7 @@ function handleError(context3, error50) {
   if (error50 instanceof Error) {
     process.stderr.write(`${source_default.red(error50.message)}
 `);
-    if (error50.stack != null && context3.logLevel === LogLevel2.Debug) {
+    if (error50.stack != null && context3.logLevel === LogLevel.Debug) {
       process.stderr.write(`${source_default.dim(error50.stack)}
 `);
     }
@@ -632518,29 +631813,23 @@ function handleError(context3, error50) {
   process.stderr.write(`${source_default.red(String(error50))}
 `);
 }
-function shouldReportToSentry(error50) {
+function reportError(context3, error50, options2) {
   if (error50 instanceof TaskAbortSignal) {
-    return false;
-  }
-  if (error50 instanceof CliError) {
-    return error50.code === "INTERNAL_ERROR";
-  }
-  if (error50 instanceof ValidationError || error50 instanceof SourcedValidationError || error50 instanceof KeyringUnavailableError) {
-    return false;
-  }
-  return true;
-}
-function extractErrorCode(error50) {
-  if (error50 instanceof CliError && error50.code != null) {
-    return error50.code;
-  }
-  if (error50 instanceof ValidationError || error50 instanceof SourcedValidationError) {
-    return "VALIDATION_ERROR";
+    return;
   }
-  if (error50 instanceof KeyringUnavailableError) {
-    return "UNAUTHORIZED_ERROR";
+  const code5 = resolveErrorCode(error50, options2?.code);
+  const capturable = error50 ?? new CliError({ message: options2?.message ?? "", code: code5 });
+  if (shouldReportToSentry(code5)) {
+    context3.telemetry.captureException(capturable, {
+      errorCode: code5
+    });
   }
-  return "INTERNAL_ERROR";
+  context3.telemetry.sendLifecycleEvent({
+    status: "error",
+    command: context3.info.command,
+    durationMs: Date.now() - context3.createdAt,
+    errorCode: code5
+  });
 }
 function setupSignalHandler(context3) {
   const onSignal = (exitCode) => {
@@ -632565,18 +631854,771 @@ function exitGracefully(code5) {
 function parseLogLevel(level) {
   switch (level.toLowerCase()) {
     case "debug":
-      return LogLevel2.Debug;
+      return LogLevel.Debug;
     case "info":
-      return LogLevel2.Info;
+      return LogLevel.Info;
     case "warn":
-      return LogLevel2.Warn;
+      return LogLevel.Warn;
     case "error":
-      return LogLevel2.Error;
+      return LogLevel.Error;
     default:
-      return LogLevel2.Info;
+      return LogLevel.Info;
   }
 }
 
+// ../cli-v2/lib/context/adapter/TaskContextLogger.js
+var TaskContextLogger = class {
+  context;
+  task;
+  logLevel;
+  enabled = true;
+  collectedErrors = [];
+  constructor({ context: context3, task, logLevel = LogLevel.Warn }) {
+    this.context = context3;
+    this.task = task;
+    this.logLevel = logLevel;
+  }
+  disable() {
+    this.enabled = false;
+  }
+  enable() {
+    this.enabled = true;
+  }
+  trace(..._args) {
+  }
+  debug(...args) {
+    const message = args.join(" ");
+    this.writeLog({ level: LogLevel.Debug, message });
+    if (this.shouldLogToTask(LogLevel.Debug)) {
+      if (this.task.logs == null) {
+        this.task.logs = [];
+      }
+      this.task.logs.push({ level: "debug", message });
+    }
+  }
+  info(...args) {
+    const message = args.join(" ");
+    this.writeLog({ level: LogLevel.Info, message });
+    if (this.shouldLogToTask(LogLevel.Info)) {
+      if (this.task.logs == null) {
+        this.task.logs = [];
+      }
+      this.task.logs.push({ level: "debug", message });
+    }
+  }
+  warn(...args) {
+    const message = args.join(" ");
+    this.writeLog({ level: LogLevel.Warn, message });
+    if (this.shouldLogToTask(LogLevel.Warn)) {
+      if (this.task.logs == null) {
+        this.task.logs = [];
+      }
+      this.task.logs.push({ level: "warn", message });
+    }
+  }
+  error(...args) {
+    const message = args.join(" ");
+    this.writeLog({ level: LogLevel.Error, message });
+    if (this.shouldLogToTask(LogLevel.Error)) {
+      this.collectedErrors.push(message);
+      if (this.task.logs == null) {
+        this.task.logs = [];
+      }
+      this.task.logs.push({ level: "error", message });
+    }
+  }
+  log(level, ...args) {
+    switch (level) {
+      case LogLevel.Debug:
+        this.debug(...args);
+        break;
+      case LogLevel.Info:
+        this.info(...args);
+        break;
+      case LogLevel.Warn:
+        this.warn(...args);
+        break;
+      case LogLevel.Error:
+        this.error(...args);
+        break;
+    }
+  }
+  /**
+   * Write a log entry to the log file. In CI / non-TTY environments,
+   * also write directly to stderr so logs are visible in CI runner output.
+   */
+  writeLog({ level, message }) {
+    this.context.logs.write({ taskName: this.task.name, level, message });
+    if (this.context.isTTY) {
+      return;
+    }
+    if (!this.enabled) {
+      return;
+    }
+    const prefix2 = source_default.dim(`[${this.task.name}]`);
+    switch (level) {
+      case LogLevel.Warn:
+        process.stderr.write(`${prefix2}: ${source_default.yellow(message)}
+`);
+        break;
+      case LogLevel.Error:
+        process.stderr.write(`${prefix2}: ${source_default.red(message)}
+`);
+        break;
+      default:
+        process.stderr.write(`${prefix2}: ${message}
+`);
+        break;
+    }
+  }
+  /**
+   * Check if a message at the given level should be logged to the task's UI.
+   */
+  shouldLogToTask(level) {
+    return this.enabled && LOG_LEVELS.indexOf(level) >= LOG_LEVELS.indexOf(this.logLevel);
+  }
+};
+
+// ../cli-v2/lib/context/adapter/TaskContextAdapter.js
+var TaskContextAdapter = class {
+  result = TaskResult.Success;
+  context;
+  logger;
+  constructor({ context: context3, task, logLevel = LogLevel.Warn }) {
+    this.context = context3;
+    if (task != null) {
+      this.logger = new TaskContextLogger({ context: context3, task, logLevel });
+    } else {
+      this.logger = createLogger((level, ...args) => {
+        if (LOG_LEVELS.indexOf(level) >= LOG_LEVELS.indexOf(logLevel)) {
+          context3.stderr.log(level, ...args);
+        }
+      });
+    }
+  }
+  async takeOverTerminal(run) {
+    await run();
+  }
+  failAndThrow(message, error50, options2) {
+    this.failWithoutThrowing(message, error50, options2);
+    throw new TaskAbortSignal();
+  }
+  failWithoutThrowing(message, error50, options2) {
+    this.result = TaskResult.Failure;
+    if (error50 instanceof TaskAbortSignal) {
+      return;
+    }
+    const fullMessage = this.getFullErrorMessage(message, error50);
+    if (fullMessage != null) {
+      this.logger.error(fullMessage);
+    }
+    reportError(this.context, error50, { ...options2, message });
+  }
+  captureException(error50, code5) {
+    const errorCode = resolveErrorCode(error50, code5);
+    this.context.telemetry.captureException(error50, { errorCode });
+  }
+  getFullErrorMessage(message, error50) {
+    const errorDetails = this.formatError(error50);
+    if (message != null && errorDetails != null) {
+      return message.includes(errorDetails) ? message : `${message}: ${errorDetails}`;
+    }
+    return message ?? errorDetails;
+  }
+  getResult() {
+    return this.result;
+  }
+  addInteractiveTask(_params) {
+    const subtask = {
+      logger: this.logger,
+      takeOverTerminal: this.takeOverTerminal.bind(this),
+      failAndThrow: this.failAndThrow.bind(this),
+      failWithoutThrowing: this.failWithoutThrowing.bind(this),
+      captureException: this.captureException.bind(this),
+      getResult: () => this.result,
+      addInteractiveTask: this.addInteractiveTask.bind(this),
+      runInteractiveTask: this.runInteractiveTask.bind(this),
+      instrumentPostHogEvent: this.instrumentPostHogEvent.bind(this),
+      setSubtitle: (_subtitle) => {
+      },
+      start: () => {
+        return subtask;
+      },
+      isStarted: () => true,
+      finish: () => {
+      },
+      isFinished: () => true
+    };
+    return subtask;
+  }
+  async runInteractiveTask(params2, run) {
+    const subtask = this.addInteractiveTask(params2).start();
+    try {
+      await run(subtask);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  instrumentPostHogEvent(_event) {
+  }
+  formatError(error50) {
+    if (error50 == null) {
+      return void 0;
+    }
+    if (error50 instanceof Error) {
+      return error50.message;
+    }
+    if (typeof error50 === "string") {
+      return error50;
+    }
+    if (typeof error50 === "object") {
+      const message = this.extractErrorMessage(error50);
+      if (message != null) {
+        return message;
+      }
+    }
+    try {
+      return JSON.stringify(error50);
+    } catch {
+      return String(error50);
+    }
+  }
+  /**
+   * Attempts to extract a human-readable message from a structured error object.
+   *
+   * Handles common shapes from the FDR SDK and other API clients, e.g.:
+   *   { content: { body: { message: "..." } } }
+   *   { body: { message: "..." } }
+   *   { message: "..." }
+   */
+  extractErrorMessage(error50) {
+    const record21 = error50;
+    if (typeof record21.message === "string") {
+      return record21.message;
+    }
+    if (record21.body != null && typeof record21.body === "object") {
+      const body = record21.body;
+      if (typeof body.message === "string") {
+        return body.message;
+      }
+    }
+    if (record21.content != null && typeof record21.content === "object") {
+      return this.extractErrorMessage(record21.content);
+    }
+    return void 0;
+  }
+};
+
+// ../cli-v2/lib/api/adapter/LegacyApiSpecAdapter.js
+init_lib6();
+
+// ../cli-v2/lib/api/config/OpenRpcSpec.js
+function isOpenRpcSpec(spec) {
+  return "openrpc" in spec;
+}
+
+// ../cli-v2/lib/api/config/ProtobufSpec.js
+function isProtobufSpec(spec) {
+  return "proto" in spec;
+}
+
+// ../cli-v2/lib/api/adapter/LegacyApiSpecAdapter.js
+var LegacyApiSpecAdapter = class {
+  context;
+  constructor(config5) {
+    this.context = config5.context;
+  }
+  adapt(spec) {
+    if (isOpenApiSpec(spec)) {
+      return this.adaptOpenApiSpec(spec);
+    }
+    if (isAsyncApiSpec(spec)) {
+      return this.adaptAsyncApiSpec(spec);
+    }
+    if (isProtobufSpec(spec)) {
+      return this.adaptProtobufSpec(spec);
+    }
+    if (isOpenRpcSpec(spec)) {
+      return this.adaptOpenRpcSpec(spec);
+    }
+    throw new Error(`Unsupported spec type: ${JSON.stringify(spec)}`);
+  }
+  convertAll(specs) {
+    return specs.map((spec) => this.adapt(spec));
+  }
+  adaptOpenApiSpec(spec) {
+    return {
+      type: "openapi",
+      absoluteFilepath: spec.openapi,
+      absoluteFilepathToOverrides: spec.overrides,
+      absoluteFilepathToOverlays: spec.overlays,
+      namespace: spec.namespace,
+      source: {
+        type: "openapi",
+        file: spec.openapi
+      },
+      settings: this.adaptOpenApiSettings(spec.settings)
+    };
+  }
+  adaptAsyncApiSpec(spec) {
+    return {
+      type: "openapi",
+      absoluteFilepath: spec.asyncapi,
+      absoluteFilepathToOverrides: spec.overrides,
+      absoluteFilepathToOverlays: void 0,
+      namespace: spec.namespace,
+      source: {
+        type: "asyncapi",
+        file: spec.asyncapi
+      },
+      settings: this.adaptAsyncApiSettings(spec.settings)
+    };
+  }
+  adaptProtobufSpec(spec) {
+    const proto3 = spec.proto;
+    return {
+      type: "protobuf",
+      absoluteFilepathToProtobufRoot: proto3.root,
+      absoluteFilepathToProtobufTarget: proto3.target,
+      absoluteFilepathToOverrides: proto3.overrides,
+      relativeFilepathToProtobufRoot: relativize(this.context.cwd, proto3.root),
+      generateLocally: proto3.localGeneration ?? false,
+      fromOpenAPI: proto3.fromOpenapi ?? false,
+      dependencies: proto3.dependencies?.map((dep) => dep.toString()) ?? [],
+      settings: void 0
+    };
+  }
+  adaptOpenRpcSpec(spec) {
+    return {
+      type: "openrpc",
+      absoluteFilepath: spec.openrpc,
+      absoluteFilepathToOverrides: spec.overrides,
+      namespace: void 0
+    };
+  }
+  adaptOpenApiSettings(settings) {
+    if (settings == null) {
+      return void 0;
+    }
+    const result = {
+      // Base API settings
+      respectNullableSchemas: settings.respectNullableSchemas,
+      wrapReferencesToNullableInOptional: settings.wrapReferencesToNullableInOptional,
+      coerceOptionalSchemasToNullable: settings.coerceOptionalSchemasToNullable,
+      useTitlesAsName: settings.titleAsSchemaName,
+      coerceEnumsToLiterals: settings.coerceEnumsToLiterals,
+      optionalAdditionalProperties: settings.optionalAdditionalProperties,
+      shouldUseIdiomaticRequestNames: settings.idiomaticRequestNames,
+      groupEnvironmentsByHost: settings.groupEnvironmentsByHost,
+      removeDiscriminantsFromSchemas: this.adaptRemoveDiscriminantsFromSchemas(settings.removeDiscriminantsFromSchemas),
+      pathParameterOrder: this.adaptPathParameterOrder(settings.pathParameterOrder),
+      // OpenAPI-specific settings
+      respectReadonlySchemas: settings.respectReadonlySchemas,
+      onlyIncludeReferencedSchemas: settings.onlyIncludeReferencedSchemas,
+      inlinePathParameters: settings.inlinePathParameters,
+      shouldUseUndiscriminatedUnionsWithLiterals: settings.preferUndiscriminatedUnionsWithLiterals,
+      objectQueryParameters: settings.objectQueryParameters,
+      respectForwardCompatibleEnums: settings.respectForwardCompatibleEnums,
+      useBytesForBinaryResponse: settings.useBytesForBinaryResponse,
+      defaultFormParameterEncoding: settings.defaultFormParameterEncoding,
+      filter: settings.filter,
+      exampleGeneration: this.adaptExampleGeneration(settings.exampleGeneration),
+      additionalPropertiesDefaultsTo: settings.additionalPropertiesDefaultsTo,
+      typeDatesAsStrings: settings.typeDatesAsStrings,
+      preserveSingleSchemaOneOf: settings.preserveSingleSchemaOneof,
+      inlineAllOfSchemas: settings.inlineAllOfSchemas,
+      resolveAliases: settings.resolveAliases,
+      groupMultiApiEnvironments: settings.groupMultiApiEnvironments,
+      defaultIntegerFormat: this.adaptDefaultIntegerFormat(settings.defaultIntegerFormat),
+      coerceConstsTo: settings.coerceConstsTo
+    };
+    const hasSettings = Object.values(result).some((v23) => v23 != null);
+    return hasSettings ? result : void 0;
+  }
+  adaptAsyncApiSettings(settings) {
+    if (settings == null) {
+      return void 0;
+    }
+    const result = {
+      // Base API settings (shared)
+      respectNullableSchemas: settings.respectNullableSchemas,
+      wrapReferencesToNullableInOptional: settings.wrapReferencesToNullableInOptional,
+      coerceOptionalSchemasToNullable: settings.coerceOptionalSchemasToNullable,
+      useTitlesAsName: settings.titleAsSchemaName,
+      coerceEnumsToLiterals: settings.coerceEnumsToLiterals,
+      optionalAdditionalProperties: settings.optionalAdditionalProperties,
+      shouldUseIdiomaticRequestNames: settings.idiomaticRequestNames,
+      groupEnvironmentsByHost: settings.groupEnvironmentsByHost,
+      removeDiscriminantsFromSchemas: this.adaptRemoveDiscriminantsFromSchemas(settings.removeDiscriminantsFromSchemas),
+      pathParameterOrder: this.adaptPathParameterOrder(settings.pathParameterOrder),
+      // AsyncAPI-specific settings
+      asyncApiNaming: settings.messageNaming,
+      coerceConstsTo: settings.coerceConstsTo
+    };
+    const hasSettings = Object.values(result).some((v23) => v23 != null);
+    return hasSettings ? result : void 0;
+  }
+  adaptRemoveDiscriminantsFromSchemas(value) {
+    if (value == null) {
+      return void 0;
+    }
+    switch (value) {
+      case "always":
+        return generators_yml_exports.RemoveDiscriminantsFromSchemas.Always;
+      case "never":
+        return generators_yml_exports.RemoveDiscriminantsFromSchemas.Never;
+      default:
+        return void 0;
+    }
+  }
+  adaptPathParameterOrder(value) {
+    if (value == null) {
+      return void 0;
+    }
+    switch (value) {
+      case "urlOrder":
+        return generators_yml_exports.PathParameterOrder.UrlOrder;
+      case "specOrder":
+        return generators_yml_exports.PathParameterOrder.SpecOrder;
+      default:
+        return void 0;
+    }
+  }
+  adaptDefaultIntegerFormat(value) {
+    if (value == null) {
+      return void 0;
+    }
+    switch (value) {
+      case "int32":
+        return generators_yml_exports.DefaultIntegerFormat.Int32;
+      case "int64":
+        return generators_yml_exports.DefaultIntegerFormat.Int64;
+      case "uint32":
+        return generators_yml_exports.DefaultIntegerFormat.Uint32;
+      case "uint64":
+        return generators_yml_exports.DefaultIntegerFormat.Uint64;
+      default:
+        return void 0;
+    }
+  }
+  adaptExampleGeneration(value) {
+    if (value == null) {
+      return void 0;
+    }
+    const result = {};
+    if (value.request != null) {
+      result.request = { "max-depth": value.request.maxDepth };
+    }
+    if (value.response != null) {
+      result.response = { "max-depth": value.response.maxDepth };
+    }
+    return result;
+  }
+};
+
+// ../cli-v2/lib/api/config/ConjureSpec.js
+function isConjureSpec(spec) {
+  return "conjure" in spec;
+}
+
+// ../cli-v2/lib/api/validator/ApiDefinitionValidator.js
+var ApiDefinitionValidator = class {
+  context;
+  taskContext;
+  cliVersion;
+  constructor(config5) {
+    this.context = config5.context;
+    this.taskContext = new TaskContextAdapter({ context: this.context, task: config5.task });
+    this.cliVersion = config5.cliVersion;
+  }
+  /**
+   * Validate an ApiDefinition.
+   *
+   * Runs both Fern definition validation and OSS workspace validation
+   * to ensure the API definition is valid before generation.
+   */
+  async validate(definition3) {
+    const startTime = performance.now();
+    const violations = [];
+    const fernSpec = definition3.specs.find(isFernSpec);
+    if (fernSpec != null) {
+      const fernViolations = await this.validateFernSpec(fernSpec);
+      violations.push(...fernViolations);
+      return {
+        violations,
+        hasErrors: violations.some((v23) => v23.severity === "fatal" || v23.severity === "error"),
+        workspaceRoot: fernSpec.fern,
+        elapsedMillis: performance.now() - startTime
+      };
+    }
+    const conjureSpec = definition3.specs.find(isConjureSpec);
+    if (conjureSpec != null) {
+      return {
+        violations: [],
+        hasErrors: false,
+        workspaceRoot: this.context.cwd,
+        elapsedMillis: performance.now() - startTime
+      };
+    }
+    const ossViolations = await this.validateOssSpecs(definition3.specs);
+    violations.push(...ossViolations);
+    return {
+      violations,
+      hasErrors: violations.some((v23) => v23.severity === "fatal" || v23.severity === "error"),
+      workspaceRoot: this.context.cwd,
+      elapsedMillis: performance.now() - startTime
+    };
+  }
+  async validateFernSpec(spec) {
+    const violations = [];
+    const lazyWorkspace = new LazyFernWorkspace({
+      absoluteFilePath: dirname6(spec.fern),
+      context: this.taskContext,
+      cliVersion: this.cliVersion,
+      generatorsConfiguration: void 0,
+      workspaceName: void 0,
+      changelog: void 0
+    });
+    const fernWorkspace = await lazyWorkspace.toFernWorkspace({ context: this.taskContext });
+    const fernViolations = validateFernWorkspace(fernWorkspace, this.context.stderr);
+    violations.push(...fernViolations);
+    return violations;
+  }
+  async validateOssSpecs(specs) {
+    const violations = [];
+    const ossSpecs = specs.filter((spec) => !isFernSpec(spec) && !isConjureSpec(spec));
+    if (ossSpecs.length === 0) {
+      return violations;
+    }
+    const specAdapter = new LegacyApiSpecAdapter({ context: this.context });
+    const v1Specs = specAdapter.convertAll(ossSpecs);
+    const filteredSpecs = v1Specs.filter((spec) => {
+      if (spec.type === "openrpc") {
+        return false;
+      }
+      if (spec.type === "protobuf" && !spec.fromOpenAPI) {
+        return false;
+      }
+      return true;
+    });
+    const allSpecs = v1Specs.filter((spec) => {
+      if (spec.type === "protobuf" && spec.fromOpenAPI) {
+        return false;
+      }
+      return true;
+    });
+    const ossWorkspace = new OSSWorkspace({
+      specs: filteredSpecs,
+      allSpecs,
+      absoluteFilePath: this.context.cwd,
+      cliVersion: this.cliVersion,
+      changelog: void 0,
+      generatorsConfiguration: void 0,
+      workspaceName: void 0
+    });
+    const fernWorkspace = await ossWorkspace.toFernWorkspace({ context: this.taskContext });
+    const fernViolations = validateFernWorkspace(fernWorkspace, this.context.stderr);
+    violations.push(...fernViolations);
+    const ossViolations = await validateOSSWorkspace(ossWorkspace, this.taskContext);
+    violations.push(...ossViolations);
+    return violations;
+  }
+};
+
+// ../cli-v2/lib/api/checker/ApiChecker.js
+var ApiChecker = class {
+  context;
+  cliVersion;
+  task;
+  constructor(config5) {
+    this.context = config5.context;
+    this.cliVersion = config5.cliVersion;
+    this.task = config5.task;
+  }
+  /**
+   * Check APIs in the workspace and display results.
+   *
+   * @param strict - If true, display all warnings and treat them as errors. If false,
+   *                 only show errors but still report warning count in summary.
+   */
+  async check({ workspace, apiNames, strict = false }) {
+    const startTime = performance.now();
+    const validApis = /* @__PURE__ */ new Set();
+    const invalidApis = /* @__PURE__ */ new Set();
+    const apisToCheck = apiNames ?? Object.keys(workspace.apis);
+    if (apisToCheck.length === 0) {
+      return {
+        validApis,
+        invalidApis,
+        violations: [],
+        errorCount: 0,
+        warningCount: 0,
+        elapsedMillis: performance.now() - startTime
+      };
+    }
+    const validator = new ApiDefinitionValidator({
+      context: this.context,
+      cliVersion: this.cliVersion,
+      task: this.task
+    });
+    const allViolations = [];
+    for (const apiName of apisToCheck) {
+      const apiDefinition = workspace.apis[apiName];
+      if (apiDefinition == null) {
+        invalidApis.add(apiName);
+        continue;
+      }
+      const result = await validator.validate(apiDefinition);
+      if (result.hasErrors) {
+        invalidApis.add(apiName);
+      } else {
+        validApis.add(apiName);
+      }
+      const apiSpecType = apiDefinition.specs.some(isFernSpec) ? "fern" : "openapi";
+      const resolvedViolations = this.resolveViolationPaths({
+        workspaceRoot: result.workspaceRoot,
+        apiName,
+        apiSpecType,
+        apiDefinition,
+        violations: result.violations
+      });
+      allViolations.push(...resolvedViolations);
+    }
+    const dedupedViolations = this.deduplicateViolations(allViolations);
+    return {
+      ...this.countViolations(dedupedViolations),
+      validApis,
+      invalidApis,
+      violations: strict ? dedupedViolations : dedupedViolations.filter((v23) => v23.severity === "fatal" || v23.severity === "error"),
+      elapsedMillis: performance.now() - startTime
+    };
+  }
+  resolveViolationPaths({ violations, workspaceRoot, apiName, apiSpecType, apiDefinition }) {
+    return violations.map((violation) => {
+      const message = apiSpecType === "fern" ? violation.message : this.formatOssMessage(violation);
+      return {
+        ...violation,
+        message,
+        displayRelativeFilepath: this.resolveDisplayPath({
+          workspaceRoot,
+          apiDefinition,
+          apiSpecType,
+          violation
+        }),
+        apiSpecType,
+        apiName,
+        // We don't actually surface valuable line/column information yet, but
+        // this at least points to the correct file.
+        line: 1,
+        column: 1
+      };
+    });
+  }
+  /**
+   * Format a violation message for non-Fern (OSS) specs.
+   *
+   * Prepends a human-readable node path so users can locate the endpoint,
+   * then strips synthetic file paths from the body of the message.
+   */
+  formatOssMessage(violation) {
+    const strippedMessage = this.stripSyntheticFilePaths(violation.message);
+    const nodePathPrefix = this.formatNodePath(violation.nodePath);
+    if (nodePathPrefix.length === 0) {
+      return strippedMessage;
+    }
+    return `${nodePathPrefix} - ${strippedMessage}`;
+  }
+  /**
+   * Formats a NodePath into a readable string like "endpoints -> getUser".
+   *
+   * Skips the leading "service" segment since it's implicit.
+   */
+  formatNodePath(nodePath) {
+    const parts = [];
+    for (const item of nodePath) {
+      if (typeof item === "string") {
+        parts.push(item);
+      } else {
+        parts.push(item.key);
+      }
+    }
+    if (parts[0] === "service") {
+      parts.shift();
+    }
+    return parts.join(" -> ");
+  }
+  resolveDisplayPath({ workspaceRoot, apiDefinition, apiSpecType, violation }) {
+    if (apiSpecType === "fern") {
+      const absolutePath = join8(workspaceRoot, RelativeFilePath2.of(violation.relativeFilepath));
+      return relativize(this.context.cwd, absolutePath);
+    }
+    return this.resolveOssDisplayPath(apiDefinition, violation);
+  }
+  resolveOssDisplayPath(apiDefinition, violation) {
+    const ossSpecs = apiDefinition.specs.filter((s11) => isOpenApiSpec(s11) || isAsyncApiSpec(s11));
+    if (ossSpecs.length === 0) {
+      return violation.relativeFilepath;
+    }
+    if (ossSpecs.length > 1) {
+      for (const spec of ossSpecs) {
+        const namespace = isOpenApiSpec(spec) ? spec.namespace : spec.namespace;
+        if (namespace != null && violation.relativeFilepath.startsWith(namespace)) {
+          const filePath2 = isOpenApiSpec(spec) ? spec.openapi : spec.asyncapi;
+          return relativize(this.context.cwd, filePath2);
+        }
+      }
+    }
+    const firstSpec = ossSpecs[0];
+    if (firstSpec == null) {
+      return violation.relativeFilepath;
+    }
+    const filePath = isOpenApiSpec(firstSpec) ? firstSpec.openapi : firstSpec.asyncapi;
+    return relativize(this.context.cwd, filePath);
+  }
+  deduplicateViolations(violations) {
+    const seen = /* @__PURE__ */ new Set();
+    return violations.filter((v23) => {
+      const key2 = `${v23.apiName}|${v23.displayRelativeFilepath}|${v23.severity}|${JSON.stringify(v23.nodePath)}|${v23.message}`;
+      if (seen.has(key2)) {
+        return false;
+      }
+      seen.add(key2);
+      return true;
+    });
+  }
+  /**
+   * Strip synthetic file path references from violation messages for non-Fern specs.
+   *
+   * The validator produces messages like:
+   *   "- pet.yml -> getPetById /pet/{petId}"
+   * For non-Fern specs these file names are synthetic (they don't exist on disk),
+   * so we strip them to produce:
+   *   "- getPetById /pet/{petId}"
+   */
+  stripSyntheticFilePaths(message) {
+    return message.replace(/^(\s*- )\S+\.[a-zA-Z]+ -> /gm, "$1");
+  }
+  countViolations(violations) {
+    let errorCount = 0;
+    let warningCount = 0;
+    for (const violation of violations) {
+      switch (violation.severity) {
+        case "fatal":
+        case "error":
+          errorCount++;
+          break;
+        case "warning":
+          warningCount++;
+          break;
+        default:
+          assertNever(violation.severity);
+      }
+    }
+    return { errorCount, warningCount };
+  }
+};
+
 // ../cli-v2/lib/commands/_internal/command.js
 function command2(cli, name2, description, handler3, builder) {
   cli.command(name2, description, (yargs) => {
@@ -632620,7 +632662,8 @@ var CheckCommand = class {
     if (args.api != null && workspace.apis[args.api] == null) {
       const availableApis = Object.keys(workspace.apis).join(", ");
       throw new CliError({
-        message: `API '${args.api}' not found. Available APIs: ${availableApis}`
+        message: `API '${args.api}' not found. Available APIs: ${availableApis}`,
+        code: CliError.Code.ConfigError
       });
     }
     const checker = new ApiChecker({ context: context3, cliVersion: workspace.cliVersion });
@@ -632634,7 +632677,7 @@ var CheckCommand = class {
       const response = this.buildJsonResponse({ apiCheckResult: result, hasErrors });
       context3.stdout.info(JSON.stringify(response, null, 2));
       if (hasErrors) {
-        throw CliError.exit();
+        throw CliError.validationError();
       }
       return;
     }
@@ -632646,7 +632689,7 @@ var CheckCommand = class {
       }
     }
     if (hasErrors) {
-      throw CliError.exit();
+      throw CliError.validationError();
     }
     if (result.warningCount > 0) {
       context3.stderr.info(`${Icons.warning} ${source_default.yellow(`Found ${result.warningCount} warnings`)}`);
@@ -759321,7 +759364,8 @@ var CompileCommand = class {
       if (definition3 == null) {
         const available2 = apiNames.join(", ");
         throw new CliError({
-          message: `API '${args.api}' not found. Available APIs: ${available2}`
+          message: `API '${args.api}' not found. Available APIs: ${available2}`,
+          code: CliError.Code.ConfigError
         });
       }
       return { apiName: args.api, definition: definition3 };
@@ -759330,20 +759374,23 @@ var CompileCommand = class {
       const apiName = apiNames[0];
       if (apiName == null) {
         throw new CliError({
-          message: "Internal error; no APIs found in workspace"
+          message: "Internal error; no APIs found in workspace",
+          code: CliError.Code.InternalError
         });
       }
       const definition3 = workspace.apis[apiName];
       if (definition3 == null) {
         throw new CliError({
-          message: `Internal error; API '${apiName}' not found in workspace`
+          message: `Internal error; API '${apiName}' not found in workspace`,
+          code: CliError.Code.InternalError
         });
       }
       return { apiName, definition: definition3 };
     }
     const available = apiNames.join(", ");
     throw new CliError({
-      message: `Multiple APIs found: ${available}. Use --api to select one.`
+      message: `Multiple APIs found: ${available}. Use --api to select one.`,
+      code: CliError.Code.ConfigError
     });
   }
   async checkOrThrow({ context: context3, workspace, apiName }) {
@@ -759353,7 +759400,7 @@ var CompileCommand = class {
       for (const violation of result.violations) {
         context3.stderr.error(`${violation.displayRelativeFilepath}:${violation.line}:${violation.column}: ${violation.message}`);
       }
-      throw CliError.exit();
+      throw CliError.validationError(`API '${apiName}' has ${result.violations.length} validation errors`);
     }
   }
   async writeOutput(context3, args, object21) {
@@ -759445,7 +759492,8 @@ var FernYmlEditor = class _FernYmlEditor {
     const doc = document4.toJS();
     if (doc == null || typeof doc !== "object") {
       throw new CliError({
-        message: `Invalid ${FERN_YML_FILENAME}: expected a YAML object; run 'fern init' to initialize a new file.`
+        message: `Invalid ${FERN_YML_FILENAME}: expected a YAML object; run 'fern init' to initialize a new file.`,
+        code: CliError.Code.ParseError
       });
     }
     return new _FernYmlEditor(document4, config5.fernYmlPath);
@@ -759647,7 +759695,8 @@ var FernYmlEditor = class _FernYmlEditor {
         const resolvedPath = join8(dirname6(this.rootFilePath), RelativeFilePath2.of(refPath));
         if (!await doesPathExist(resolvedPath)) {
           throw new CliError({
-            message: `Referenced file '${refPath}' in ${FERN_YML_FILENAME} does not exist.`
+            message: `Referenced file '${refPath}' in ${FERN_YML_FILENAME} does not exist.`,
+            code: CliError.Code.ConfigError
           });
         }
         const refContent = await (0, import_promises50.readFile)(resolvedPath, "utf-8");
@@ -759674,7 +759723,8 @@ var FernYmlEditor = class _FernYmlEditor {
     const existing = section.document.getIn([...section.basePath, name2]);
     if (existing == null) {
       throw new CliError({
-        message: `Target '${name2}' not found in SDK configuration.`
+        message: `Target '${name2}' not found in SDK configuration.`,
+        code: CliError.Code.ConfigError
       });
     }
   }
@@ -760002,9 +760052,9 @@ async function loadSpec(filepath) {
     contents = await (0, import_promises51.readFile)(filepath, "utf8");
   } catch (error50) {
     if (isEnoentError(error50)) {
-      throw new CliError({ message: `File does not exist: ${filepath}` });
+      throw new CliError({ message: `File does not exist: ${filepath}`, code: CliError.Code.ConfigError });
     }
-    throw new CliError({ message: `Failed to read file: ${filepath}` });
+    throw new CliError({ message: `Failed to read file: ${filepath}`, code: CliError.Code.ParseError });
   }
   return parseSpec(contents, filepath);
 }
@@ -760015,7 +760065,10 @@ function parseSpec(contents, filepath) {
     try {
       return jsYaml.load(contents);
     } catch {
-      throw new CliError({ message: `Failed to parse file as JSON or YAML: ${filepath}` });
+      throw new CliError({
+        message: `Failed to parse file as JSON or YAML: ${filepath}`,
+        code: CliError.Code.ParseError
+      });
     }
   }
 }
@@ -760034,7 +760087,7 @@ var MergeCommand = class {
   async handle(context3, args) {
     const workspace = await context3.loadWorkspaceOrThrow();
     if (Object.keys(workspace.apis).length === 0) {
-      throw new CliError({ message: "No APIs found in workspace." });
+      throw new CliError({ message: "No APIs found in workspace.", code: CliError.Code.ConfigError });
     }
     const entries22 = filterSpecs(workspace, { api: args.api });
     if (entries22.length === 0) {
@@ -760046,7 +760099,8 @@ var MergeCommand = class {
       const fernYmlPath = workspace.absoluteFilePath;
       if (fernYmlPath == null) {
         throw new CliError({
-          message: `No ${FERN_YML_FILENAME} found. Run 'fern init' to initialize a project.`
+          message: `No ${FERN_YML_FILENAME} found. Run 'fern init' to initialize a project.`,
+          code: CliError.Code.ConfigError
         });
       }
       editor = await FernYmlEditor.load({ fernYmlPath });
@@ -760181,7 +760235,7 @@ var SplitCommand = class {
   async handle(context3, args) {
     const workspace = await context3.loadWorkspaceOrThrow();
     if (Object.keys(workspace.apis).length === 0) {
-      throw new CliError({ message: "No APIs found in workspace." });
+      throw new CliError({ message: "No APIs found in workspace.", code: CliError.Code.ConfigError });
     }
     const entries22 = filterSpecs(workspace, { api: args.api });
     if (entries22.length === 0) {
@@ -760192,7 +760246,8 @@ var SplitCommand = class {
     const fernYmlPath = workspace.absoluteFilePath;
     if (fernYmlPath == null) {
       throw new CliError({
-        message: `No ${FERN_YML_FILENAME} found. Run 'fern init' to initialize a project.`
+        message: `No ${FERN_YML_FILENAME} found. Run 'fern init' to initialize a project.`,
+        code: CliError.Code.ConfigError
       });
     }
     const editor = await FernYmlEditor.load({ fernYmlPath });
@@ -760313,7 +760368,8 @@ var SplitCommand = class {
       const detail = extractErrorMessage(error50);
       throw new CliError({
         message: `Failed to get file from git HEAD: ${absolutePath}. Is the file tracked by git and has at least one commit?
-  Cause: ${detail}`
+  Cause: ${detail}`,
+        code: CliError.Code.ParseError
       });
     }
   }
@@ -760328,7 +760384,10 @@ var SplitCommand = class {
 function resolvePathOrThrow(context3, outputPath) {
   const resolved = context3.resolveOutputFilePath(outputPath);
   if (resolved == null) {
-    throw new CliError({ message: `Could not resolve output path: ${outputPath}` });
+    throw new CliError({
+      message: `Could not resolve output path: ${outputPath}`,
+      code: CliError.Code.ConfigError
+    });
   }
   return resolved;
 }
@@ -760372,7 +760431,7 @@ var LoginCommand = class {
       context3.stdout.info("Opening browser to log in to Fern...");
       context3.stdout.info(source_default.dim("  If the browser doesn't open, try: fern auth login --device-code"));
     }
-    const taskContext = new TaskContextAdapter({ context: context3, logLevel: LogLevel2.Info });
+    const taskContext = new TaskContextAdapter({ context: context3, logLevel: LogLevel.Info });
     const tokenResponse = await getTokenFromAuth0(taskContext, {
       useDeviceCodeFlow,
       forceReauth: true
@@ -760384,12 +760443,12 @@ var LoginCommand = class {
     const payload = await verifyAndDecodeJwt(idToken);
     if (payload == null) {
       context3.stdout.error(`${Icons.error} Internal error; could not verify ID token`);
-      throw CliError.exit();
+      throw CliError.internalError();
     }
     const email3 = payload.email;
     if (email3 == null) {
       context3.stdout.error(`${Icons.error} Internal error; ID token does not contain email claim`);
-      throw CliError.exit();
+      throw CliError.internalError();
     }
     const { isNew, totalAccounts } = await context3.tokenService.login(email3, accessToken);
     if (isNew) {
@@ -760455,7 +760514,7 @@ var LogoutCommand = class {
     context3.stdout.info("");
     if (!context3.isTTY) {
       context3.stdout.error(`${Icons.error} Use --force to skip confirmation in non-interactive mode`);
-      throw CliError.exit();
+      throw new CliError({ code: CliError.Code.ValidationError });
     }
     const { confirmed } = await lib_default4.prompt([
       {
@@ -760476,7 +760535,9 @@ var LogoutCommand = class {
     const { removed, newActive } = await context3.tokenService.logout(user);
     if (!removed) {
       context3.stdout.error(`${Icons.error} Account not found: ${user}`);
-      throw CliError.exit();
+      throw new CliError({
+        code: CliError.Code.EnvironmentError
+      });
     }
     context3.stdout.info(`${Icons.success} Logged out of ${source_default.bold(user)}`);
     if (newActive != null) {
@@ -760486,7 +760547,9 @@ var LogoutCommand = class {
   async handleLogoutInteractive(context3, accounts) {
     if (!context3.isTTY) {
       context3.stdout.error(`${Icons.error} Multiple accounts found. Use --user or --all in non-interactive mode.`);
-      throw CliError.exit();
+      throw new CliError({
+        code: CliError.Code.EnvironmentError
+      });
     }
     const choices = accounts.map((account) => ({
       name: account.isActive ? `${account.user} ${source_default.dim("(active)")}` : account.user,
@@ -760642,13 +760705,15 @@ var SwitchCommand = class {
       context3.stdout.warn(`${source_default.yellow("\u26A0")} You are not logged in to Fern.`);
       context3.stdout.info("");
       context3.stdout.info(source_default.dim("  To log in, run: fern auth login"));
-      throw CliError.exit();
+      throw new CliError({
+        code: CliError.Code.ConfigError
+      });
     }
     if (accounts.length === 1) {
       const account = accounts[0];
       if (account == null) {
         context3.stdout.error(`${Icons.error} Internal error; no accounts found`);
-        throw CliError.exit();
+        throw CliError.internalError();
       }
       context3.stdout.warn(`${source_default.yellow("\u26A0")} You only have one account logged in: ${source_default.bold(account.user)}`);
       context3.stdout.info("");
@@ -760671,7 +760736,9 @@ var SwitchCommand = class {
   async handleInteractiveSwitch(context3, accounts) {
     if (!context3.isTTY) {
       context3.stdout.error(`${Icons.error} Use --user to specify account in non-interactive mode`);
-      throw CliError.exit();
+      throw new CliError({
+        code: CliError.Code.EnvironmentError
+      });
     }
     const choices = accounts.map((account) => ({
       name: account.isActive ? `${account.user} ${source_default.dim("(current)")}` : account.user,
@@ -760692,7 +760759,9 @@ var SwitchCommand = class {
     const success2 = await context3.tokenService.switchAccount(user);
     if (!success2) {
       context3.stdout.error(`${Icons.error} Account not found: ${user}`);
-      throw CliError.exit();
+      throw new CliError({
+        code: CliError.Code.EnvironmentError
+      });
     }
     context3.stdout.info(`${Icons.success} Switched to ${source_default.bold(user)}`);
   }
@@ -760729,24 +760798,32 @@ var TokenCommand = class {
       organizationNotFoundError: () => {
         process.stderr.write(`${Icons.error} Organization "${orgId}" was not found.
 `);
-        throw CliError.exit();
+        throw new CliError({
+          code: CliError.Code.ConfigError
+        });
       },
       unauthorizedError: () => {
         process.stderr.write(`${Icons.error} You do not have access to organization "${orgId}".
 `);
-        throw CliError.exit();
+        throw new CliError({
+          code: CliError.Code.AuthError
+        });
       },
       missingOrgPermissionsError: () => {
         process.stderr.write(`${Icons.error} You do not have the required permissions in organization "${orgId}".
 `);
-        throw CliError.exit();
+        throw new CliError({
+          code: CliError.Code.AuthError
+        });
       },
       _other: () => {
         process.stderr.write(`${Icons.error} Failed to generate token.
 
   Please contact support@buildwithfern.com for assistance.
 `);
-        throw CliError.exit();
+        throw new CliError({
+          code: CliError.Code.InternalError
+        });
       }
     });
   }
@@ -760762,7 +760839,7 @@ var TokenCommand = class {
 
   Run fern init or specify an organization with --org, then run this command again.
 `);
-      throw CliError.exit();
+      throw new CliError({ code: CliError.Code.ConfigError });
     }
   }
 };
@@ -760782,7 +760859,7 @@ var WhoamiCommand = class {
       context3.stdout.warn(`${source_default.yellow("\u26A0")} You are not logged in to Fern.`);
       context3.stdout.info("");
       context3.stdout.info(source_default.dim("  To log in, run: fern auth login"));
-      throw CliError.exit();
+      throw new CliError({ code: CliError.Code.AuthError });
     }
     if (args.json) {
       context3.stdout.info(JSON.stringify({ email: activeAccount.user }, null, 2));
@@ -817768,7 +817845,7 @@ function checkMissingRedirects(removedSlugs, redirects, basePath) {
 }
 
 // ../yaml/docs-validator/lib/rules/missing-redirects/missing-redirects.js
-var NOOP_CONTEXT = createMockTaskContext({ logger: createLogger4(noop2) });
+var NOOP_CONTEXT = createMockTaskContext({ logger: createLogger(noop2) });
 async function fetchMarkdownEntries(fdrOrigin, domain3, basepath, authToken) {
   try {
     const response = await fetch(`${fdrOrigin}/slugs/markdowns`, {
@@ -839280,7 +839357,7 @@ function collectPathnamesToCheck(content5, { absoluteFilepath, instanceUrls }) {
 }
 
 // ../yaml/docs-validator/lib/rules/valid-markdown-link/valid-markdown-link.js
-var NOOP_CONTEXT2 = createMockTaskContext({ logger: createLogger4(noop2) });
+var NOOP_CONTEXT2 = createMockTaskContext({ logger: createLogger(noop2) });
 var ValidMarkdownLinks = {
   name: "valid-markdown-links",
   create: async ({ workspace, apiWorkspaces, ossWorkspaces }) => {
@@ -840349,7 +840426,8 @@ var DocsChecker = class {
     const docsWorkspace = project.docsWorkspaces;
     if (docsWorkspace == null) {
       throw new CliError({
-        message: "No docs configuration found in fern.yml.\n\n  Add a 'docs:' section to your fern.yml to get started."
+        message: "No docs configuration found in fern.yml.\n\n  Add a 'docs:' section to your fern.yml to get started.",
+        code: CliError.Code.ConfigError
       });
     }
     const ossWorkspaces = await filterOssWorkspaces(project);
@@ -840620,12 +840698,12 @@ var CheckCommand2 = class {
       const response = this.buildJsonResponse({ apiCheckResult, sdkCheckResult, docsCheckResult, hasErrors });
       context3.stdout.info(JSON.stringify(response, null, 2));
       if (hasErrors) {
-        throw CliError.exit();
+        throw new CliError({ code: CliError.Code.ValidationError });
       }
       return;
     }
     if (hasErrors) {
-      throw CliError.exit();
+      throw new CliError({ code: CliError.Code.ValidationError });
     }
     if (totalWarnings > 0) {
       context3.stderr.info(`${Icons.warning} ${source_default.yellow(`Found ${totalWarnings} warnings`)}`);
@@ -840680,7 +840758,8 @@ var CheckCommand2 = class {
     if (args.api != null && workspace.apis[args.api] == null) {
       const availableApis = Object.keys(workspace.apis).join(", ");
       throw new CliError({
-        message: `API '${args.api}' not found. Available APIs: ${availableApis}`
+        message: `API '${args.api}' not found. Available APIs: ${availableApis}`,
+        code: CliError.Code.ConfigError
       });
     }
   }
@@ -842143,7 +842222,7 @@ var MigrateCommand = class {
       }
       return;
     }
-    throw new CliError({ message: "Migration failed" });
+    throw new CliError({ message: "Migration failed", code: CliError.Code.ConfigError });
   }
 };
 function addMigrateCommand(cli) {
@@ -842166,7 +842245,8 @@ var CheckCommand3 = class {
     const workspace = await context3.loadWorkspaceOrThrow();
     if (workspace.docs == null) {
       throw new CliError({
-        message: "No docs configuration found in fern.yml.\n\n  Add a 'docs:' section to your fern.yml to get started."
+        message: "No docs configuration found in fern.yml.\n\n  Add a 'docs:' section to your fern.yml to get started.",
+        code: CliError.Code.ConfigError
       });
     }
     const checker = new DocsChecker({ context: context3 });
@@ -842176,7 +842256,7 @@ var CheckCommand3 = class {
       const response = this.buildJsonResponse({ result, hasErrors });
       context3.stdout.info(JSON.stringify(response, null, 2));
       if (hasErrors) {
-        throw CliError.exit();
+        throw new CliError({ code: CliError.Code.ValidationError });
       }
       return;
     }
@@ -842188,7 +842268,7 @@ var CheckCommand3 = class {
       }
     }
     if (hasErrors) {
-      throw CliError.exit();
+      throw new CliError({ code: CliError.Code.ValidationError });
     }
     if (result.warningCount > 0) {
       context3.stderr.info(`${Icons.warning} ${source_default.yellow(`Found ${result.warningCount} warnings`)}`);
@@ -844029,7 +844109,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.2-6-gdbf7c6b8be3";
+  const version7 = "4.68.3-1-g429be56b56f";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -846011,7 +846091,8 @@ var DevCommand = class {
     const workspace = await context3.loadWorkspaceOrThrow();
     if (workspace.docs == null) {
       throw new CliError({
-        message: "No docs configuration found in fern.yml.\n\n  Add a 'docs:' section to your fern.yml to get started."
+        message: "No docs configuration found in fern.yml.\n\n  Add a 'docs:' section to your fern.yml to get started.",
+        code: CliError.Code.ConfigError
       });
     }
     const backendPort = args["backend-port"] ?? await getPorts();
@@ -846021,7 +846102,7 @@ var DevCommand = class {
       backendPort,
       forceDownload: args["force-download"],
       bundlePath: args["bundle-path"],
-      logLevel: LogLevel2.Info
+      logLevel: LogLevel.Info
     });
   }
 };
@@ -846332,11 +846413,11 @@ function getSeverityForViolations(violations) {
 function getLogLevelForSeverity(severity) {
   switch (severity) {
     case "fatal":
-      return LogLevel2.Error;
+      return LogLevel.Error;
     case "error":
-      return LogLevel2.Error;
+      return LogLevel.Error;
     case "warning":
-      return LogLevel2.Warn;
+      return LogLevel.Warn;
     default:
       assertNever(severity);
   }
@@ -853622,15 +853703,15 @@ async function makeWritableRecursive(dirPath) {
 function convertLogLevel(logLevel) {
   switch (logLevel) {
     case "DEBUG":
-      return LogLevel2.Debug;
+      return LogLevel.Debug;
     case "INFO":
-      return LogLevel2.Info;
+      return LogLevel.Info;
     case "WARN":
-      return LogLevel2.Warn;
+      return LogLevel.Warn;
     case "ERROR":
-      return LogLevel2.Error;
+      return LogLevel.Error;
     default:
-      return LogLevel2.Info;
+      return LogLevel.Info;
   }
 }
 async function checkFernIgnorePresent(absolutePathToLocalOutput) {
@@ -855278,7 +855359,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "4.68.2-6-gdbf7c6b8be3"
+        cliVersion: "4.68.3-1-g429be56b56f"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
         return { success: false };
@@ -855871,7 +855952,8 @@ var PublishCommand = class {
     const workspace = await context3.loadWorkspaceOrThrow();
     if (workspace.docs == null) {
       throw new CliError({
-        message: "No docs configuration found in fern.yml.\n\n  Add a 'docs:' section to your fern.yml to get started."
+        message: "No docs configuration found in fern.yml.\n\n  Add a 'docs:' section to your fern.yml to get started.",
+        code: CliError.Code.ConfigError
       });
     }
     const instanceUrl = this.resolveInstanceUrl({
@@ -855890,7 +855972,8 @@ var PublishCommand = class {
     const docsWorkspace = project.docsWorkspaces;
     if (docsWorkspace == null) {
       throw new CliError({
-        message: "No docs configuration found in fern.yml.\n\n  Add a 'docs:' section to your fern.yml to get started."
+        message: "No docs configuration found in fern.yml.\n\n  Add a 'docs:' section to your fern.yml to get started.",
+        code: CliError.Code.ConfigError
       });
     }
     const ossWorkspaces = await filterOssWorkspaces(project);
@@ -855905,7 +855988,10 @@ var PublishCommand = class {
     });
     const docsTask = taskGroup.getTask("publish");
     if (docsTask == null) {
-      throw new CliError({ message: "Internal error; task 'publish' not found" });
+      throw new CliError({
+        message: "Internal error; task 'publish' not found",
+        code: CliError.Code.InternalError
+      });
     }
     docsTask.start();
     docsTask.stage.validation.start();
@@ -855949,13 +856035,14 @@ var PublishCommand = class {
       errorMessage: labels.error
     });
     if (summary.failedCount > 0) {
-      throw CliError.exit();
+      throw new CliError({ code: CliError.Code.ContainerError });
     }
   }
   resolveInstanceUrl({ instances: instances2, instance }) {
     if (instances2.length === 0) {
       throw new CliError({
-        message: "No docs instances configured.\n\n  Add an instance to the 'docs:' section of your fern.yml."
+        message: "No docs instances configured.\n\n  Add an instance to the 'docs:' section of your fern.yml.",
+        code: CliError.Code.ConfigError
       });
     }
     if (instance != null) {
@@ -855968,7 +856055,8 @@ var PublishCommand = class {
 Available instances:
 ${available}
 
-  Use --instance <url> with one of the URLs above.`
+  Use --instance <url> with one of the URLs above.`,
+          code: CliError.Code.ConfigError
         });
       }
       return match3.url;
@@ -855981,13 +856069,15 @@ ${available}
 Available instances:
 ${available}
 
-  Use --instance <url> to select one.`
+  Use --instance <url> to select one.`,
+        code: CliError.Code.ConfigError
       });
     }
     const first3 = instances2[0];
     if (first3 == null) {
       throw new CliError({
-        message: "No docs instances configured.\n\n  Add an instance to the 'docs:' section of your fern.yml."
+        message: "No docs instances configured.\n\n  Add an instance to the 'docs:' section of your fern.yml.",
+        code: CliError.Code.ConfigError
       });
     }
     return first3.url;
@@ -856021,7 +856111,8 @@ ${available}
       const fernToken = process.env["FERN_TOKEN"];
       if (fernToken == null) {
         throw new CliError({
-          message: "No organization token found. Please set the FERN_TOKEN environment variable."
+          message: "No organization token found. Please set the FERN_TOKEN environment variable.",
+          code: CliError.Code.AuthError
         });
       }
       return Promise.resolve({ type: "organization", value: fernToken });
@@ -856033,7 +856124,10 @@ function addPublishCommand(cli) {
   const cmd = new PublishCommand();
   command2(cli, "publish", "Publish your documentation site", async (context3, args) => {
     const timeout4 = new Promise((_16, reject) => {
-      setTimeout(() => reject(new CliError({ message: "Docs publish timed out after 10 minutes." })), GENERATE_COMMAND_TIMEOUT_MS).unref();
+      setTimeout(() => reject(new CliError({
+        message: "Docs publish timed out after 10 minutes.",
+        code: CliError.Code.NetworkError
+      })), GENERATE_COMMAND_TIMEOUT_MS).unref();
     });
     await Promise.race([cmd.handle(context3, args), timeout4]);
   }, (yargs) => yargs.option("force", {
@@ -856062,7 +856156,8 @@ var DeleteCommand = class {
     if (!this.isPreviewUrl(args.url)) {
       throw new CliError({
         message: `Invalid preview URL: ${args.url}
-  Preview URLs follow the pattern: {org}-preview-{hash}.docs.buildwithfern.com`
+  Preview URLs follow the pattern: {org}-preview-{hash}.docs.buildwithfern.com`,
+        code: CliError.Code.ConfigError
       });
     }
     const token = await context3.getTokenOrPrompt();
@@ -856079,7 +856174,8 @@ var DeleteCommand = class {
           throw CliError.notFound(`Preview site not found: ${args.url}`);
         default:
           throw new CliError({
-            message: `Failed to delete preview site: ${args.url}`
+            message: `Failed to delete preview site: ${args.url}`,
+            code: CliError.Code.InternalError
           });
       }
     }
@@ -856126,7 +856222,10 @@ function addPreviewCommand(cli) {
   const cmd = new PreviewCommand();
   commandWithSubcommands(cli, "preview", "Generate a preview of your documentation site", async (context3, args) => {
     const timeout4 = new Promise((_16, reject) => {
-      setTimeout(() => reject(new CliError({ message: "Docs preview timed out after 10 minutes." })), GENERATE_COMMAND_TIMEOUT_MS).unref();
+      setTimeout(() => reject(new CliError({
+        message: "Docs preview timed out after 10 minutes.",
+        code: CliError.Code.NetworkError
+      })), GENERATE_COMMAND_TIMEOUT_MS).unref();
     });
     await Promise.race([cmd.handle(context3, args), timeout4]);
   }, (yargs) => yargs.option("instance", {
@@ -856513,7 +856612,7 @@ var Wizard = class {
         return void 0;
       }
       this.context.stderr.info(`  ${Icons.info} Opening browser to log in to Fern...`);
-      const taskContext = new TaskContextAdapter({ context: this.context, logLevel: LogLevel2.Info });
+      const taskContext = new TaskContextAdapter({ context: this.context, logLevel: LogLevel.Info });
       const { accessToken, idToken } = await getTokenFromAuth0(taskContext, {
         useDeviceCodeFlow: false,
         forceReauth: false
@@ -857093,7 +857192,8 @@ var InitCommand = class {
   async validateArgs({ context: context3, fernYmlPath, args }) {
     if (await doesPathExist(fernYmlPath)) {
       throw new CliError({
-        message: `A ${FERN_YML_FILENAME} file already exists at ${fernYmlPath}`
+        message: `A ${FERN_YML_FILENAME} file already exists at ${fernYmlPath}`,
+        code: CliError.Code.ConfigError
       });
     }
     if (args.api != null) {
@@ -857101,13 +857201,14 @@ var InitCommand = class {
       if (!api.startsWith("http://") && !api.startsWith("https://")) {
         const resolved = import_path59.default.resolve(context3.cwd, api);
         if (!await doesPathExist(AbsoluteFilePath2.of(resolved))) {
-          throw new CliError({ message: `File not found: ${api}` });
+          throw new CliError({ message: `File not found: ${api}`, code: CliError.Code.ConfigError });
         }
       }
     }
     if (!context3.isTTY && !args.yes) {
       throw new CliError({
-        message: "Cannot run interactive init in non-TTY environment. Use --yes for defaults."
+        message: "Cannot run interactive init in non-TTY environment. Use --yes for defaults.",
+        code: CliError.Code.ConfigError
       });
     }
   }
@@ -857133,7 +857234,7 @@ var CreateCommand = class {
     const token = await context3.getTokenOrPrompt();
     if (token.type === "organization") {
       context3.stderr.error(`${Icons.error} Organization tokens cannot create organizations. Unset the FERN_TOKEN environment variable and run 'fern auth login' to create an organization.`);
-      throw CliError.exit();
+      throw new CliError({ code: CliError.Code.AuthError });
     }
     const validationError = getOrganizationNameValidationError(args.name);
     if (validationError != null) {
@@ -857170,7 +857271,7 @@ var ListCommand = class {
     const token = await context3.getTokenOrPrompt();
     if (token.type === "organization") {
       context3.stderr.error(`${Icons.error} Organization tokens cannot list organizations. Unset the FERN_TOKEN environment variable and run 'fern auth login' to list your organizations.`);
-      throw CliError.exit();
+      throw new CliError({ code: CliError.Code.AuthError });
     }
     const venus = createVenusService({ token: token.value });
     const firstPage = await this.fetchPage({ venus, pageId: 1 });
@@ -857314,13 +857415,14 @@ var AddCommand = class {
     const fernYmlPath = workspace.absoluteFilePath;
     if (fernYmlPath == null) {
       throw new CliError({
-        message: `No ${FERN_YML_FILENAME} found. Run 'fern init' to initialize a project.`
+        message: `No ${FERN_YML_FILENAME} found. Run 'fern init' to initialize a project.`,
+        code: CliError.Code.ConfigError
       });
     }
     const sdkChecker = new SdkChecker({ context: context3 });
     const sdkCheckResult = await sdkChecker.check({ workspace });
     if (sdkCheckResult.errorCount > 0) {
-      throw CliError.exit();
+      throw new CliError({ code: CliError.Code.ValidationError });
     }
     const existingTargets = workspace.sdks?.targets ?? [];
     if (!context3.isTTY || args.yes) {
@@ -857333,7 +857435,8 @@ var AddCommand = class {
       throw new CliError({
         message: `Missing required flags:
 
-  --target <language>    SDK language (e.g. typescript, python, go)`
+  --target <language>    SDK language (e.g. typescript, python, go)`,
+        code: CliError.Code.ConfigError
       });
     }
     const language = this.parseLanguage(args.target);
@@ -857379,7 +857482,8 @@ var AddCommand = class {
         message: `"${value}" looks like a remote reference but is not a recognized git URL.
 
   Please specify a local path (e.g. ./sdks/my-sdk) or a git URL:
-    https://github.com/owner/repo`
+    https://github.com/owner/repo`,
+        code: CliError.Code.ConfigError
       });
     }
     return { path: value };
@@ -857401,7 +857505,8 @@ var AddCommand = class {
   checkForDuplicate({ existingTargets, language }) {
     if (existingTargets.some((t3) => t3.name === language)) {
       throw new CliError({
-        message: `Target '${language}' already exists in ${FERN_YML_FILENAME}.`
+        message: `Target '${language}' already exists in ${FERN_YML_FILENAME}.`,
+        code: CliError.Code.ConfigError
       });
     }
   }
@@ -857453,7 +857558,8 @@ var AddCommand = class {
       return lang;
     }
     throw new CliError({
-      message: `"${target}" is not a supported language. Supported: ${LANGUAGES.join(", ")}`
+      message: `"${target}" is not a supported language. Supported: ${LANGUAGES.join(", ")}`,
+      code: CliError.Code.ConfigError
     });
   }
 };
@@ -857490,7 +857596,7 @@ var CheckCommand4 = class {
       const response = this.buildJsonResponse({ sdkCheckResult: result, hasErrors });
       context3.stdout.info(JSON.stringify(response, null, 2));
       if (hasErrors) {
-        throw CliError.exit();
+        throw new CliError({ code: CliError.Code.ValidationError });
       }
       return;
     }
@@ -857502,7 +857608,7 @@ var CheckCommand4 = class {
       }
     }
     if (hasErrors) {
-      throw CliError.exit();
+      throw new CliError({ code: CliError.Code.ValidationError });
     }
     if (result.warningCount > 0) {
       context3.stderr.info(`${Icons.warning} ${source_default.yellow(`Found ${result.warningCount} warnings`)}`);
@@ -907911,8 +908017,6 @@ var GenerationRunner = class {
           }
         } catch (error50) {
           if (error50 instanceof TaskAbortSignal) {
-          } else if (error50 instanceof LoggableFernCliError) {
-            interactiveTaskContext.failWithoutThrowing(`Generation failed: ${error50.log}`, error50);
           } else {
             interactiveTaskContext.failWithoutThrowing(`Generation failed: ${error50 instanceof Error ? error50.message : "Unknown error"}`, error50);
           }
@@ -908345,7 +908449,7 @@ var LegacyLocalGenerationRunner = class {
     const taskContext = new TaskContextAdapter({
       context: this.context,
       task: args.task,
-      logLevel: LogLevel2.Info
+      logLevel: LogLevel.Info
     });
     try {
       const generatorInvocation = await this.invocationAdapter.adapt(args.target);
@@ -908484,7 +908588,7 @@ var LegacyRemoteGenerationRunner = class {
     const taskContext = new TaskContextAdapter({
       context: this.context,
       task: args.task,
-      logLevel: LogLevel2.Info
+      logLevel: LogLevel.Info
     });
     try {
       const generatorInvocation = await this.invocationAdapter.adapt(args.target);
@@ -908624,7 +908728,8 @@ var GeneratorPipeline = class {
       }
       if (args.target.registry != null) {
         throw new CliError({
-          message: `Custom image configurations are only supported with local generation (--local). Target "${args.target.name}" uses a custom image registry.`
+          message: `Custom image configurations are only supported with local generation (--local). Target "${args.target.name}" uses a custom image registry.`,
+          code: CliError.Code.ConfigError
         });
       }
       return await this.runRemoteGeneration(args);
@@ -908936,7 +909041,8 @@ var GenerateCommand = class {
       throw new CliError({
         message: `No fern.yml found, either run 'fern init' or specify all of the required flags:
 
-` + missingFlags.map((flag) => `  ${flag}`).join("\n")
+` + missingFlags.map((flag) => `  ${flag}`).join("\n"),
+        code: CliError.Code.ConfigError
       });
     }
     const api = args.api;
@@ -908987,12 +909093,12 @@ var GenerateCommand = class {
         }
       }
       if (sdkCheckResult.errorCount > 0) {
-        throw CliError.exit();
+        throw new CliError({ code: CliError.Code.ValidationError });
       }
     }
     const validTargets = targets2.filter((t3) => checkResult.validApis.has(t3.api));
     if (validTargets.length === 0) {
-      throw CliError.exit();
+      throw new CliError({ code: CliError.Code.ValidationError });
     }
     const pipeline5 = new GeneratorPipeline({
       context: context3,
@@ -909020,7 +909126,7 @@ var GenerateCommand = class {
       if (outputPath != null) {
         const { shouldProceed } = await this.checkOutputDirectory({ context: context3, args, outputPath });
         if (!shouldProceed) {
-          throw new CliError({ message: "Generation cancelled." });
+          throw new CliError({ message: "Generation cancelled.", code: CliError.Code.ConfigError });
         }
       }
     }
@@ -909038,7 +909144,10 @@ var GenerateCommand = class {
     await Promise.all(targets2.map(async (target) => {
       const task = taskGroup.getTask(target.name);
       if (task == null) {
-        throw new CliError({ message: `Internal error; task '${target.name}' not found` });
+        throw new CliError({
+          message: `Internal error; task '${target.name}' not found`,
+          code: CliError.Code.InternalError
+        });
       }
       task.start();
       task.stage.validation.start();
@@ -909084,22 +909193,32 @@ var GenerateCommand = class {
       errorMessage: `Failed to generate ${sdkInitialism}`
     });
     if (summary.failedCount > 0) {
-      throw CliError.exit();
+      throw new CliError({ code: CliError.Code.ContainerError });
     }
   }
   validateArgs({ workspace, args, targets: targets2 }) {
     if (args["container-engine"] != null && !args.local) {
-      throw new CliError({ message: "The --container-engine flag can only be used with --local" });
+      throw new CliError({
+        message: "The --container-engine flag can only be used with --local",
+        code: CliError.Code.ConfigError
+      });
     }
     if (args.group != null && args.target != null) {
-      throw new CliError({ message: "The --group and --target flags cannot be used together" });
+      throw new CliError({
+        message: "The --group and --target flags cannot be used together",
+        code: CliError.Code.ConfigError
+      });
     }
     if (targets2.length > 1 && args.output != null) {
-      throw new CliError({ message: "The --output flag can only be used when generating a single target" });
+      throw new CliError({
+        message: "The --output flag can only be used when generating a single target",
+        code: CliError.Code.ConfigError
+      });
     }
     if (args["skip-fernignore"] && args.fernignore != null) {
       throw new CliError({
-        message: "The --skip-fernignore and --fernignore flags cannot be used together."
+        message: "The --skip-fernignore and --fernignore flags cannot be used together.",
+        code: CliError.Code.ConfigError
       });
     }
     const issues = [];
@@ -909151,7 +909270,8 @@ Example:
         throw new CliError({
           message: `Remote generation is not supported with a git URL for --output
 
-  Use --local or specify a local filesystem path for --output`
+  Use --local or specify a local filesystem path for --output`,
+          code: CliError.Code.ConfigError
         });
       }
       const token = process.env.GITHUB_TOKEN ?? process.env.GIT_TOKEN;
@@ -909163,7 +909283,8 @@ Example:
     export GITHUB_TOKEN=ghp_xxx
 
   Or use a local path:
-    --output ./my-sdk`
+    --output ./my-sdk`,
+          code: CliError.Code.AuthError
         });
       }
       return {
@@ -909285,7 +909406,10 @@ function addGenerateCommand(cli) {
   const cmd = new GenerateCommand();
   command2(cli, "generate", "Generate SDKs from fern.yml or directly from an API spec", async (context3, args) => {
     const timeout4 = new Promise((_16, reject) => {
-      setTimeout(() => reject(new CliError({ message: "Generation timed out after 10 minutes." })), GENERATE_COMMAND_TIMEOUT_MS).unref();
+      setTimeout(() => reject(new CliError({
+        message: "Generation timed out after 10 minutes.",
+        code: CliError.Code.NetworkError
+      })), GENERATE_COMMAND_TIMEOUT_MS).unref();
     });
     await Promise.race([cmd.handle(context3, args), timeout4]);
   }, (yargs) => yargs.option("api", {
@@ -909364,7 +909488,10 @@ function addPreviewCommand2(cli) {
   const cmd = new PreviewCommand2();
   command2(cli, "preview", "Generate a preview of an SDK", async (context3, args) => {
     const timeout4 = new Promise((_16, reject) => {
-      setTimeout(() => reject(new CliError({ message: "Preview generation timed out after 10 minutes." })), GENERATE_COMMAND_TIMEOUT_MS).unref();
+      setTimeout(() => reject(new CliError({
+        message: "Preview generation timed out after 10 minutes.",
+        code: CliError.Code.NetworkError
+      })), GENERATE_COMMAND_TIMEOUT_MS).unref();
     });
     await Promise.race([cmd.handle(context3, args), timeout4]);
   }, (yargs) => yargs.option("api", {
@@ -909816,13 +909943,14 @@ var UpdateCommand = class {
     const fernYmlPath = workspace.absoluteFilePath;
     if (fernYmlPath == null) {
       throw new CliError({
-        message: `No ${FERN_YML_FILENAME} found. Run 'fern init' to initialize a project.`
+        message: `No ${FERN_YML_FILENAME} found. Run 'fern init' to initialize a project.`,
+        code: CliError.Code.ConfigError
       });
     }
     const sdkChecker = new SdkChecker({ context: context3 });
     const sdkCheckResult = await sdkChecker.check({ workspace });
     if (sdkCheckResult.errorCount > 0) {
-      throw CliError.exit();
+      throw new CliError({ code: CliError.Code.ValidationError });
     }
     const targets2 = workspace.sdks?.targets;
     if (targets2 == null || targets2.length === 0) {
@@ -909838,7 +909966,8 @@ var UpdateCommand = class {
     });
     if (updates.length === 0 && upToDate.length === 0 && args.target != null) {
       throw new CliError({
-        message: `Target '${args.target}' not found in ${FERN_YML_FILENAME}.`
+        message: `Target '${args.target}' not found in ${FERN_YML_FILENAME}.`,
+        code: CliError.Code.ConfigError
       });
     }
     if (updates.length === 0) {
@@ -924819,19 +924948,19 @@ var Logger4 = class {
     this.enabled = true;
   }
   trace(...args) {
-    this.write(LogLevel2.Trace, ...args);
+    this.write(LogLevel.Trace, ...args);
   }
   debug(...args) {
-    this.write(LogLevel2.Debug, ...args);
+    this.write(LogLevel.Debug, ...args);
   }
   info(...args) {
-    this.write(LogLevel2.Info, ...args);
+    this.write(LogLevel.Info, ...args);
   }
   warn(...args) {
-    this.write(LogLevel2.Warn, ...args);
+    this.write(LogLevel.Warn, ...args);
   }
   error(...args) {
-    this.write(LogLevel2.Error, ...args);
+    this.write(LogLevel.Error, ...args);
   }
   log(level, ...args) {
     this.write(level, ...args);
@@ -928446,6 +928575,24 @@ var esm_default16 = createPrompt((config5, done) => {
 // src/cli-context/CliContext.ts
 init_lodash();
 
+// src/telemetry/reportError.ts
+function reportError2(reporter, error50, options2) {
+  if (error50 instanceof TaskAbortSignal) {
+    return;
+  }
+  const code5 = resolveErrorCode(error50, options2?.code);
+  reporter.instrumentPostHogEvent({
+    command: process.argv.join(" "),
+    properties: {
+      failed: true,
+      errorCode: code5
+    }
+  });
+  if (shouldReportToSentry(code5)) {
+    reporter.captureException(error50 ?? new CliError({ message: options2?.message ?? "", code: code5 }), code5);
+  }
+}
+
 // src/telemetry/SentryClient.ts
 var SentryClient = class {
   sentry;
@@ -928468,12 +928615,15 @@ var SentryClient = class {
       setSentryRunIdTags();
     }
   }
-  async captureException(error50) {
+  captureException(error50, code5) {
     if (this.sentry == null) {
       return;
     }
     try {
-      this.sentry.captureException(error50);
+      this.sentry.captureException(
+        error50,
+        code5 != null ? { captureContext: { tags: { "error.code": code5 } } } : void 0
+      );
     } catch {
     }
   }
@@ -928531,13 +928681,15 @@ var TaskContextImpl = class {
   status = "notStarted";
   onResult;
   instrumentPostHogEventImpl;
+  captureExceptionImpl;
   constructor({
     logImmediately,
     logPrefix,
     takeOverTerminal,
     onResult,
     shouldBufferLogs,
-    instrumentPostHogEvent
+    instrumentPostHogEvent,
+    captureException: captureException2
   }) {
     this.logImmediately = logImmediately;
     this.logPrefix = logPrefix ?? "";
@@ -928545,6 +928697,7 @@ var TaskContextImpl = class {
     this.onResult = onResult;
     this.shouldBufferLogs = shouldBufferLogs;
     this.instrumentPostHogEventImpl = instrumentPostHogEvent;
+    this.captureExceptionImpl = captureException2;
   }
   start() {
     this.status = "running";
@@ -928562,14 +928715,21 @@ var TaskContextImpl = class {
     return this.status === "finished";
   }
   takeOverTerminal;
-  failAndThrow(message, error50) {
-    this.failWithoutThrowing(message, error50);
+  failAndThrow(message, error50, options2) {
+    this.failWithoutThrowing(message, error50, options2);
     this.finish();
     throw new TaskAbortSignal();
   }
-  failWithoutThrowing(message, error50) {
-    logErrorMessage({ message, error: error50, logger: this.logger });
+  failWithoutThrowing(message, error50, options2) {
     this.result = TaskResult.Failure;
+    if (error50 instanceof TaskAbortSignal) {
+      return;
+    }
+    logErrorMessage({ message, error: error50, logger: this.logger });
+    reportError2(this, error50, { ...options2, message });
+  }
+  captureException(error50, code5) {
+    this.captureExceptionImpl?.(error50, code5);
   }
   getResult() {
     return this.result;
@@ -928601,7 +928761,7 @@ var TaskContextImpl = class {
     this.logImmediately(this.bufferedLogs);
     this.bufferedLogs = [];
   }
-  logger = createLogger4(this.logAtLevel.bind(this));
+  logger = createLogger(this.logAtLevel.bind(this));
   addInteractiveTask({ name: name2, subtitle }) {
     const subtask = new InteractiveTaskContextImpl({
       name: name2,
@@ -928611,7 +928771,8 @@ var TaskContextImpl = class {
       takeOverTerminal: this.takeOverTerminal,
       onResult: this.onResult,
       shouldBufferLogs: this.shouldBufferLogs,
-      instrumentPostHogEvent: (event) => this.instrumentPostHogEventImpl(event)
+      instrumentPostHogEvent: (event) => this.instrumentPostHogEventImpl(event),
+      captureException: this.captureExceptionImpl
     });
     this.subtasks.push(subtask);
     return subtask;
@@ -928641,7 +928802,7 @@ var InteractiveTaskContextImpl = class extends TaskContextImpl {
   }
   start() {
     super.start();
-    this.logAtLevelWithOverrides(LogLevel2.Info, ["Started."], {
+    this.logAtLevelWithOverrides(LogLevel.Info, ["Started."], {
       omitOnTTY: true
     });
     this.flushLogs();
@@ -928652,11 +928813,11 @@ var InteractiveTaskContextImpl = class extends TaskContextImpl {
   }
   finish() {
     if (this.result === TaskResult.Success) {
-      this.logAtLevelWithOverrides(LogLevel2.Info, ["Finished."], {
+      this.logAtLevelWithOverrides(LogLevel.Info, ["Finished."], {
         omitOnTTY: true
       });
     } else {
-      this.logAtLevelWithOverrides(LogLevel2.Error, ["Failed."], {
+      this.logAtLevelWithOverrides(LogLevel.Error, ["Failed."], {
         omitOnTTY: true
       });
     }
@@ -928984,7 +929145,7 @@ var CliContext = class _CliContext {
   didSucceed = true;
   numTasks = 0;
   ttyAwareLogger;
-  logLevel = LogLevel2.Info;
+  logLevel = LogLevel.Info;
   isLocal;
   stdoutRedirector = new StdoutRedirector();
   jsonMode = false;
@@ -929019,7 +929180,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "4.68.2-6-gdbf7c6b8be3";
+    return "4.68.3-1-g429be56b56f";
   }
   getCliName() {
     if (false) {
@@ -929035,13 +929196,17 @@ var CliContext = class _CliContext {
       `Running ${source_default.bold(`${this.environment.cliName}`)} (${this.environment.packageName}@${this.environment.packageVersion})`
     );
   }
-  failAndThrow(message, error50) {
-    this.failWithoutThrowing(message, error50);
+  failAndThrow(message, error50, options2) {
+    this.failWithoutThrowing(message, error50, options2);
     throw new TaskAbortSignal();
   }
-  failWithoutThrowing(message, error50) {
+  failWithoutThrowing(message, error50, options2) {
     this.didSucceed = false;
+    if (error50 instanceof TaskAbortSignal) {
+      return;
+    }
     logErrorMessage({ message, error: error50, logger: this.logger });
+    reportError2(this, error50, { ...options2, message });
   }
   /**
    * Activate JSON-output mode: all logger output is forced to stderr
@@ -929144,15 +929309,7 @@ var CliContext = class _CliContext {
     try {
       result = await run(context3);
     } catch (error50) {
-      if (error50 instanceof TaskAbortSignal) {
-        throw error50;
-      }
-      if (error50.message.includes("globalThis")) {
-        context3.logger.error(this.USE_NODE_18_OR_ABOVE_MESSAGE);
-        context3.failWithoutThrowing();
-      } else {
-        context3.failWithoutThrowing(void 0, error50);
-      }
+      context3.failWithoutThrowing(void 0, error50);
       throw new TaskAbortSignal();
     } finally {
       context3.finish();
@@ -929164,11 +929321,11 @@ var CliContext = class _CliContext {
       this.posthogManager.sendEvent(event);
     }
   }
-  async captureException(error50) {
-    await this.sentryClient.captureException(error50);
+  captureException(error50, code5) {
+    this.sentryClient.captureException(error50, code5);
   }
-  logger = createLogger4((level, ...args) => this.log(level, ...args));
-  stderr = createLogger4((level, ...args) => this.logStderr(level, ...args));
+  logger = createLogger((level, ...args) => this.log(level, ...args));
+  stderr = createLogger((level, ...args) => this.logStderr(level, ...args));
   constructTaskInitForWorkspace(workspace) {
     const prefixWithoutPadding = wrapWorkspaceNameForPrefix(
       workspace.type === "docs" ? "docs" : workspace.workspaceName ?? "api"
@@ -929194,7 +929351,10 @@ var CliContext = class _CliContext {
       instrumentPostHogEvent: (event) => {
         this.instrumentPostHogEvent(event);
       },
-      shouldBufferLogs: false
+      shouldBufferLogs: false,
+      captureException: (error50, code5) => {
+        this.sentryClient.captureException(error50, code5);
+      }
     };
   }
   log(level, ...parts) {
@@ -929221,7 +929381,7 @@ var CliContext = class _CliContext {
   logImmediately(logs4, { stderr = false } = {}) {
     const filtered = logs4.filter((log4) => LOG_LEVELS.indexOf(log4.level) >= LOG_LEVELS.indexOf(this.logLevel));
     this.ttyAwareLogger.log(filtered, {
-      includeDebugInfo: this.logLevel === LogLevel2.Debug,
+      includeDebugInfo: this.logLevel === LogLevel.Debug,
       stderr: stderr || this.jsonMode
     });
   }
@@ -947195,7 +947355,6 @@ function evaluateRuntime4() {
 
 // src/cli.ts
 void runCli();
-var USE_NODE_18_OR_ABOVE_MESSAGE = "The Fern CLI requires Node 18+ or above.";
 async function runCli() {
   getOrCreateFernRunId();
   const isLocal = process.argv.includes("--local");
@@ -947233,24 +947392,7 @@ async function runCli() {
       });
     }
   } catch (error50) {
-    cliContext.instrumentPostHogEvent({
-      command: process.argv.join(" "),
-      properties: {
-        failed: true,
-        error: error50
-      }
-    });
-    if (error50 instanceof TaskAbortSignal) {
-      cliContext.failWithoutThrowing();
-    } else if (error50?.message.includes("globalThis")) {
-      cliContext.logger.error(USE_NODE_18_OR_ABOVE_MESSAGE);
-      cliContext.failWithoutThrowing();
-    } else if (error50 instanceof LoggableFernCliError) {
-      cliContext.logger.error(`Failed. ${error50.log}`);
-    } else {
-      await cliContext.captureException(error50);
-      cliContext.failWithoutThrowing("Failed.", error50);
-    }
+    cliContext.failWithoutThrowing(void 0, error50);
   }
   await exit3();
 }
@@ -947281,7 +947423,7 @@ async function tryRunCli(cliContext) {
       }
     }
   ).option("log-level", {
-    default: LogLevel2.Info,
+    default: LogLevel.Info,
     choices: LOG_LEVELS
   }).demandCommand().recommendCommands();
   addDiffCommand(cli, cliContext);