@fern-api/fern-api-dev 4.68.4 → 4.68.5-8-g6594a748f1f

package/cli.cjs

@@ -627016,7 +627016,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "4.68.4",
+          version: "4.68.5-8-g6594a748f1f",
           usingAccessToken: true
         }
       });
@@ -627070,7 +627070,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "4.68.4",
+        version: "4.68.5-8-g6594a748f1f",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -844122,7 +844122,7 @@ var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 var MAX_LOGS_DIR_SIZE_BYTES = 100 * 1024 * 1024;
 function getCliSource() {
-  const version7 = "4.68.4";
+  const version7 = "4.68.5-8-g6594a748f1f";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -855372,7 +855372,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "4.68.4"
+        cliVersion: "4.68.5-8-g6594a748f1f"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
         return { success: false };
@@ -906294,7 +906294,7 @@ var AsyncHttpRequest = class {
       throw (0, import_baml.toBamlError)(error50);
     }
   }
-  async ConsolidateChangelog(raw_entries, version_bump, language, __baml_options__) {
+  async ConsolidateChangelog(raw_entries, version_bump, language, previous_version, new_version, __baml_options__) {
     try {
       const __rawEnv__ = __baml_options__?.env ? { ...process.env, ...__baml_options__.env } : { ...process.env };
       const __env__ = Object.fromEntries(Object.entries(__rawEnv__).filter(([_16, value]) => value !== void 0));
@@ -906306,7 +906306,9 @@ var AsyncHttpRequest = class {
       return await this.runtime.buildRequest("ConsolidateChangelog", {
         "raw_entries": raw_entries,
         "version_bump": version_bump,
-        "language": language
+        "language": language,
+        "previous_version": previous_version,
+        "new_version": new_version
       }, this.ctxManager.cloneContext(), __baml_options__?.tb?.__tb(), __clientRegistry__, false, __env__);
     } catch (error50) {
       throw (0, import_baml.toBamlError)(error50);
@@ -906340,7 +906342,7 @@ var AsyncHttpStreamRequest = class {
       throw (0, import_baml.toBamlError)(error50);
     }
   }
-  async ConsolidateChangelog(raw_entries, version_bump, language, __baml_options__) {
+  async ConsolidateChangelog(raw_entries, version_bump, language, previous_version, new_version, __baml_options__) {
     try {
       const __rawEnv__ = __baml_options__?.env ? { ...process.env, ...__baml_options__.env } : { ...process.env };
       const __env__ = Object.fromEntries(Object.entries(__rawEnv__).filter(([_16, value]) => value !== void 0));
@@ -906352,7 +906354,9 @@ var AsyncHttpStreamRequest = class {
       return await this.runtime.buildRequest("ConsolidateChangelog", {
         "raw_entries": raw_entries,
         "version_bump": version_bump,
-        "language": language
+        "language": language,
+        "previous_version": previous_version,
+        "new_version": new_version
       }, this.ctxManager.cloneContext(), __baml_options__?.tb?.__tb(), __clientRegistry__, true, __env__);
     } catch (error50) {
       throw (0, import_baml.toBamlError)(error50);
@@ -906420,7 +906424,7 @@ var import_baml3 = require("@boundaryml/baml");
 
 // ../ai/lib/baml_client/inlinedbaml.js
 var fileMap = {
-  "diff_analyzer.baml": '// SDK Diff Analyzer\n// Analyzes git diffs of SDK code and produces semantic commit messages and version bumps\n\nenum VersionBump {\n    MAJOR\n    MINOR\n    PATCH\n    NO_CHANGE\n}\n\nclass AnalyzeCommitDiffRequest {\n    diff string @description("The git diff to analyze for generating a commit message")\n}\n\nclass AnalyzeCommitDiffResponse {\n    message string\n        @description("Developer-facing git commit message. Use conventional commit format. Reference specific code symbols (function names, class names). Keep summary under 72 chars.")\n\n    changelog_entry string\n        @description("User-facing release note for CHANGELOG.md and GitHub Releases. Describe the impact on SDK consumers, not implementation details. Include migration instructions for MAJOR. Use plain prose, not conventional commit format. Empty string for PATCH.")\n\n    version_bump VersionBump\n        @description("The recommended semantic version bump: MAJOR for breaking changes, MINOR for new features, PATCH for bug fixes and other changes, NO_CHANGE for empty diffs")\n\n    version_bump_reason string\n        @description("One sentence explaining WHY this version bump was chosen. For MAJOR: name the specific breaking symbol(s). For MINOR: name the new capability. For PATCH: describe the fix. For NO_CHANGE: \'No functional changes detected.\' Example: \'MAJOR because `parserCreateJob` InputStream overloads were removed from `RawLabReportClient`.\'")\n}\n\n// Main function that analyzes SDK diffs\nfunction AnalyzeSdkDiff(\n    diff: string @description("The git diff to analyze"),\n    language: string @description("The SDK programming language, e.g. \'typescript\', \'python\', \'java\'"),\n    previous_version: string @description("The current published version before this change, e.g. \'1.2.3\'"),\n    prior_changelog: string @description("The last 3 changelog entries for this SDK, empty string if none. Use this to match the existing commit message style and understand the versioning pattern."),\n    spec_commit_message: string @description("The commit message from the API spec repository that triggered this SDK generation. Use as a hint for the intent of the change, but verify against the actual diff. Empty string if unavailable.")\n) -> AnalyzeCommitDiffResponse {\n  client DefaultClient\n\n  prompt #"\n    You are an expert software engineer analyzing changes to generate semantic commit messages.\n\n    Analyze the provided git diff and return a structured response with these fields:\n    - message: A git commit message formatted like the example below\n    - version_bump: One of: MAJOR, MINOR, PATCH, or NO_CHANGE\n\n    Version Bump Guidelines:\n    - MAJOR: Breaking changes (removed/renamed functions, changed signatures, removed parameters)\n    - MINOR: New features that are backward compatible (new functions, new optional parameters).\n      Also MINOR: behavioral changes invisible to the public API surface that still affect consumers:\n      - Changed HTTP status code handling (e.g. 404 now throws instead of returning null)\n      - Changed default parameter values (timeout, retry count, page size, base URL)\n      - Changed serialization behavior (date formats, null handling, field ordering)\n      - Changed error message text that consumers may depend on\n      - Changed HTTP header names or values sent to the server\n      - Changed retry or backoff behavior (different retry counts, delay strategies)\n    - PATCH: Bug fixes, documentation, internal refactoring with no observable behavioral change\n    - NO_CHANGE: The diff is empty\n\n    --- Examples ---\n\n    Examples of correct classifications:\n\n    --- MAJOR: removed exported TypeScript function ---\n    diff --git a/src/api/client.ts b/src/api/client.ts\n    -export async function getUser(id: string): Promise<User> {\n    -    return this.request("GET", `/users/${id}`);\n    -}\n    version_bump: MAJOR\n    reason: Existing callers of getUser() will get a compile error.\n\n    --- MAJOR: removed Python public method ---\n    diff --git a/vital/client.py b/vital/client.py\n    -    def get_user(self, user_id: str) -> User:\n    -        return self._request("GET", f"/users/{user_id}")\n    version_bump: MAJOR\n    reason: Existing callers crash with AttributeError.\n\n    --- MINOR: new optional TypeScript parameter ---\n    diff --git a/src/api/client.ts b/src/api/client.ts\n    -async createUser(name: string): Promise<User>\n    +async createUser(name: string, role?: UserRole): Promise<User>\n    version_bump: MINOR\n    reason: Existing callers unaffected \u2014 new parameter is optional.\n\n    --- MINOR: new Java public method ---\n    diff --git a/src/.../UsersClient.java b/src/.../UsersClient.java\n    +    public CompletableFuture<User> getUserAsync(String userId) {\n    +        return this.httpClient.sendAsync(...);\n    +    }\n    version_bump: MINOR\n    reason: New capability added, nothing removed or changed.\n\n    --- MINOR: changed default retry count ---\n    diff --git a/src/core/http_client.py b/src/core/http_client.py\n    -MAX_RETRIES = 3\n    +MAX_RETRIES = 5\n    version_bump: MINOR\n    reason: Changed default retry count \u2014 existing consumers will experience different retry behavior.\n\n    --- PATCH: Go import reorganization ---\n    diff --git a/client.go b/client.go\n    -import "fmt"\n    -import "net/http"\n    +import (\n    +    "fmt"\n    +    "net/http"\n    +)\n    version_bump: PATCH\n    reason: Formatting change only, no functional difference.\n\n    --- End Examples ---\n\n    {% if language == "typescript" %}\n    Language-specific breaking change rules for TypeScript:\n\n    MAJOR (breaking):\n    - Removing a required response field is always MAJOR\n    - Removing or renaming a public class, method, function, or exported symbol is MAJOR\n    - Making a response field optional is MAJOR (type changes from T to T | undefined, breaking existing property access without null checks)\n    - Changing a method return type (e.g. Promise<T> to Promise<T | undefined>, or T to T | null) is MAJOR\n    - New enum values are MAJOR if the SDK generates exhaustive switch/if-else chains (callers get compile errors on unhandled cases)\n    - Changing a union type (adding/removing variants) is MAJOR if callers use exhaustive type narrowing or discriminated unions\n    - Adding a new required property to a request/input type is MAJOR (existing callers won\'t compile)\n    - Removing or renaming an exported type, interface, or type alias is MAJOR\n    - Changing the type of an existing property (e.g. string to number, or string to string[]) is MAJOR\n    - Changing a generic type parameter constraint (e.g. <T extends Foo> to <T extends Bar>) is MAJOR\n    - Converting a synchronous method to async (or vice versa) is MAJOR (changes return type to Promise<T>)\n    - Removing a default export or switching between default and named exports is MAJOR\n    - Changing the structure of a discriminated union (e.g. changing the discriminant field name) is MAJOR\n    - Removing or renaming environment/server URL constants is MAJOR\n    - Changing the constructor signature of a client class (adding required params) is MAJOR\n    - Narrowing a parameter type (e.g. string | number to string) is MAJOR (callers passing number break)\n\n    MINOR (backward-compatible additions):\n    - Adding a new optional parameter to a function is MINOR\n    - Adding new exported types, interfaces, or classes is MINOR\n    - Adding new methods to an existing client class is MINOR\n    - Adding new optional properties to request types is MINOR\n    - Adding new enum values when NOT used in exhaustive checks is MINOR\n    - Adding new environment/server URL constants is MINOR\n    - Widening a parameter type (e.g. string to string | number) is MINOR\n    - Adding new re-exports from index files is MINOR\n    - Adding new error types or exception classes is MINOR\n    - Adding new RequestOptions fields (e.g. timeout, retries) is MINOR\n    - Deprecating (but not removing) a public API is MINOR\n\n    PATCH (no API surface change):\n    - Changes to internal/private modules (core/, _internal/, utils/) are PATCH\n    - Reordering imports, formatting, or comment changes are PATCH\n    - Updating SDK version headers (X-Fern-SDK-Version, User-Agent) is PATCH\n    - Refactoring HTTP client internals without changing observable defaults or behavior is PATCH\n    - Updating dependency versions in package.json is PATCH\n    - Adding or modifying JSDoc/TSDoc comments is PATCH\n    - Refactoring internal implementation without changing public signatures is PATCH\n    - Changes to .npmignore, tsconfig.json, or build configuration are PATCH\n    - Updating serialization/deserialization logic that preserves the same public types is PATCH\n\n    {% elif language == "python" %}\n    Language-specific breaking change rules for Python:\n\n    MAJOR (breaking):\n    - Removing a required response field is always MAJOR\n    - Removing or renaming a public class, method, or function is always MAJOR\n    - Adding a new required parameter to a public method is MAJOR (callers get TypeError)\n    - Renaming a parameter in a public method is MAJOR if callers use keyword arguments\n    - Removing a parameter from a public method signature is MAJOR\n    - Changing the type of a parameter from one concrete type to an incompatible one is MAJOR\n    - Changing exception types raised by a method (callers catching specific exceptions break) is MAJOR\n    - Removing or renaming a public module or subpackage is MAJOR (import statements break)\n    - Moving a public class/function to a different module without re-exporting from the original is MAJOR\n    - Changing a class from inheriting one base to another when callers use isinstance() checks is MAJOR\n    - Removing a public class attribute or property is MAJOR\n\n    MINOR (backward-compatible additions):\n    - Making a response field optional is usually MINOR (Python uses None propagation; callers rarely type-check strictly)\n    - New enum values are MINOR (unknown values are handled gracefully with string fallbacks)\n    - Changing a return type from a concrete type to Optional is MINOR (duck typing absorbs this)\n    - Adding new public methods, classes, or modules is MINOR\n    - Adding new optional parameters (with defaults) is MINOR\n    - Adding new optional fields to Pydantic models is MINOR\n    - Adding new exception/error classes is MINOR\n    - Adding new class attributes or properties is MINOR\n    - Adding new type overloads (@overload decorator) is MINOR\n    - Adding new environment/server URL constants is MINOR\n    - Adding new RequestOptions fields (e.g. timeout, max_retries) is MINOR\n    - Deprecating (but not removing) a public API is MINOR\n    - Widening a type annotation (e.g. str to Union[str, int]) is MINOR\n\n    PATCH (no API surface change):\n    - Changes to private methods (prefixed with _) are PATCH\n    - Changes to type hints only (no runtime effect) are PATCH\n    - Reformatting, docstring updates, or comment changes are PATCH\n    - Updating SDK version headers (X-Fern-SDK-Version, User-Agent) are PATCH\n    - Refactoring httpx/requests client internals without changing observable defaults or behavior is PATCH\n    - Updating dependency versions in pyproject.toml/setup.py is PATCH\n    - Updating serialization/deserialization logic that preserves the same public types is PATCH\n    - Refactoring internal implementation without changing public signatures is PATCH\n    - Changes to __init__.py that don\'t alter public re-exports are PATCH\n    - Changes to conftest.py, test files, or CI configuration are PATCH\n\n    {% elif language == "java" %}\n    Language-specific breaking change rules for Java:\n\n    MAJOR (breaking):\n    - Removing a required response field is always MAJOR\n    - Removing or renaming a public class, method, or interface is always MAJOR\n    - Making a response field optional (e.g. T to Optional<T>) is MAJOR (callers must handle Optional unwrapping)\n    - New enum values are MAJOR if the SDK generates exhaustive switch statements\n    - Adding a new required parameter to a public method is MAJOR\n    - Changing a method\'s return type is MAJOR (even if compatible at runtime, recompilation fails)\n    - Removing or changing a public static final constant is MAJOR\n    - Changing a class from concrete to abstract (or vice versa) is MAJOR\n    - Changing the checked exceptions declared in a throws clause is MAJOR\n    - Removing a public constructor or changing its parameter list is MAJOR\n    - Removing an interface that a public class implements is MAJOR\n    - Changing generic type parameters on a public class (e.g. Foo<T> to Foo<T, U>) is MAJOR\n    - Moving a public class to a different package without re-exporting is MAJOR\n    - Narrowing a parameter type (e.g. Object to String) is MAJOR\n    - Making a non-final class final is MAJOR (breaks subclassing)\n    - Changing the type of a builder method parameter is MAJOR\n\n    MINOR (backward-compatible additions):\n    - Adding new overloaded methods is MINOR\n    - Adding new public classes or interfaces is MINOR\n    - Adding new optional builder methods is MINOR\n    - Adding new enum values when NOT used in exhaustive switch statements is MINOR\n    - Adding new optional fields to request objects is MINOR\n    - Adding new exception/error classes is MINOR\n    - Adding new static utility methods is MINOR\n    - Adding new environment/server URL constants is MINOR\n    - Adding new RequestOptions fields (e.g. timeout, retries) is MINOR\n    - Widening a parameter type (e.g. String to Object) is MINOR\n    - Adding default methods to interfaces (Java 8+) is MINOR\n    - Deprecating (but not removing) public APIs with @Deprecated is MINOR\n\n    PATCH (no API surface change):\n    - Changes to package-private or private methods are PATCH\n    - Changes to annotations (other than public API annotations), Javadoc, or formatting are PATCH\n    - Updating SDK version headers (X-Fern-SDK-Version, User-Agent) is PATCH\n    - Refactoring OkHttp/HttpClient internals without changing observable defaults or behavior is PATCH\n    - Updating dependency versions in build.gradle/pom.xml is PATCH\n    - Refactoring internal implementation without changing public signatures is PATCH\n    - Updating serialization/deserialization logic (Jackson/Gson config) that preserves public types is PATCH\n    - Changes to test files, CI configuration, or build scripts are PATCH\n\n    {% elif language == "go" %}\n    Language-specific breaking change rules for Go:\n\n    MAJOR (breaking):\n    - Removing a required response field is always MAJOR\n    - Removing or renaming an exported function, method, or type is always MAJOR\n    - Making a response field a pointer type (e.g. string to *string) is MAJOR (callers must dereference)\n    - Changing a function signature (adding/removing parameters or return values) is MAJOR (Go has no overloading)\n    - Removing or renaming an exported struct field is MAJOR\n    - Changing the type of an exported struct field is MAJOR\n    - Removing or renaming an exported constant or variable is MAJOR\n    - Changing an interface by adding methods is MAJOR (all implementations must add the method)\n    - Removing a method from an interface is MAJOR (callers using that method break)\n    - Changing a function\'s return type(s) is MAJOR (Go is strict about return types)\n    - Changing a variadic parameter to non-variadic (or vice versa) is MAJOR\n    - Moving a type/function to a different package without aliasing in the original is MAJOR\n    - Changing the receiver type of a method (value receiver to pointer receiver changes method set) is MAJOR\n    - Changing an exported error variable\'s type or value is MAJOR (callers using errors.Is break)\n\n    MINOR (backward-compatible additions):\n    - Adding new exported functions, methods, or types is MINOR\n    - New enum-like constants are MINOR (Go enums are not exhaustive by default)\n    - Adding new fields to a struct is MINOR (existing code still compiles, zero-value initialization)\n    - Making a response field optional (pointer) is usually MINOR if the field was already a struct field\n    - Adding new optional function parameters via functional options pattern is MINOR\n    - Adding new interface types is MINOR\n    - Adding new error types/variables is MINOR\n    - Adding new environment/server URL constants is MINOR\n    - Adding new RequestOption functions is MINOR\n    - Widening a return type from a concrete type to an interface is MINOR (if interface is satisfied)\n    - Adding new methods to a concrete type (does not break interface implementations) is MINOR\n\n    PATCH (no API surface change):\n    - Changes to unexported (lowercase) functions or types are PATCH\n    - Changes to go.mod dependencies, import reordering, or formatting are PATCH\n    - Updating SDK version headers (X-Fern-SDK-Version, User-Agent) is PATCH\n    - Refactoring http.Client internals without changing observable defaults or behavior is PATCH\n    - Updating serialization/deserialization logic (JSON tags, encoding) that preserves identical output is PATCH\n    - Refactoring internal implementation without changing exported signatures is PATCH\n    - Changes to *_test.go files, Makefile, or CI configuration are PATCH\n    - Updating comments, godoc, or code formatting (gofmt) is PATCH\n\n    {% elif language == "ruby" %}\n    Language-specific breaking change rules for Ruby:\n\n    MAJOR (breaking):\n    - Removing a required response field is always MAJOR\n    - Removing or renaming a public method is MAJOR (callers get NoMethodError)\n    - Adding a new required positional parameter is MAJOR\n    - Removing a method parameter is MAJOR (callers passing that argument get ArgumentError)\n    - Changing the order of positional parameters is MAJOR\n    - Removing or renaming a public class or module is MAJOR (callers get NameError)\n    - Changing a method from instance to class method (or vice versa) is MAJOR\n    - Changing the return type in a breaking way (e.g. returning nil where an object was expected and callers chain methods) is MAJOR\n    - Removing a public constant is MAJOR\n    - Changing exception types raised by a method is MAJOR (callers rescuing specific exceptions break)\n\n    MINOR (backward-compatible additions):\n    - Making a response field optional is usually MINOR (Ruby uses nil propagation; callers rarely type-check)\n    - New enum values are MINOR (unknown values are handled gracefully)\n    - Adding new optional keyword parameters (with defaults) is MINOR\n    - Adding new public methods or classes is MINOR\n    - Adding new optional fields to response/request objects is MINOR\n    - Adding new exception/error classes is MINOR\n    - Adding new environment/server URL constants is MINOR\n    - Adding new RequestOptions fields (e.g. timeout, max_retries) is MINOR\n    - Deprecating (but not removing) a public API is MINOR\n    - Adding new modules or mixins is MINOR\n\n    PATCH (no API surface change):\n    - Changes to private methods are PATCH\n    - Gemspec metadata, comment, or formatting changes are PATCH\n    - Updating SDK version headers is PATCH\n    - Refactoring Faraday/Net::HTTP internals without changing observable defaults or behavior is PATCH\n    - Updating dependency versions in Gemfile/gemspec is PATCH\n    - Refactoring internal implementation without changing public signatures is PATCH\n    - Changes to test files, Rakefile, or CI configuration are PATCH\n\n    {% elif language == "csharp" %}\n    Language-specific breaking change rules for C#:\n\n    MAJOR (breaking):\n    - Removing a required response field is always MAJOR\n    - Removing or renaming a public class, method, property, or interface is always MAJOR\n    - Making a response field nullable (e.g. T to T?) is MAJOR (callers must handle null checks)\n    - New enum values are MAJOR if the SDK generates exhaustive switch expressions\n    - Adding a new required parameter to a public method is MAJOR\n    - Changing a method\'s return type is MAJOR\n    - Removing or changing a public constant or static readonly field is MAJOR\n    - Changing a class from non-sealed to sealed (or abstract to concrete) is MAJOR\n    - Changing the base class of a public class is MAJOR\n    - Removing an interface implementation from a public class is MAJOR\n    - Changing generic type constraints on a public class or method is MAJOR\n    - Moving a public type to a different namespace without type forwarding is MAJOR\n    - Changing property from read-write to read-only (removing setter) is MAJOR\n    - Changing async method to sync (Task<T> to T) or vice versa is MAJOR\n\n    MINOR (backward-compatible additions):\n    - Adding new public classes, interfaces, or methods is MINOR\n    - Adding new optional parameters (with default values) is MINOR\n    - Adding new overloaded methods is MINOR\n    - Adding new enum values when NOT used in exhaustive switch expressions is MINOR\n    - Adding new optional properties to request objects is MINOR\n    - Adding new exception types is MINOR\n    - Adding new environment/server URL constants is MINOR\n    - Adding new RequestOptions fields (e.g. Timeout, MaxRetries) is MINOR\n    - Adding new extension methods is MINOR\n    - Deprecating (but not removing) public APIs with [Obsolete] is MINOR\n\n    PATCH (no API surface change):\n    - Changes to internal or private members are PATCH\n    - XML doc comments, formatting, or namespace reorganization are PATCH\n    - Updating SDK version headers is PATCH\n    - Refactoring HttpClient internals without changing observable defaults or behavior is PATCH\n    - Updating dependency versions in .csproj is PATCH\n    - Refactoring internal implementation without changing public signatures is PATCH\n    - Updating serialization/deserialization (System.Text.Json/Newtonsoft) config that preserves public types is PATCH\n    - Changes to test files, .sln, or CI configuration are PATCH\n\n    {% elif language == "php" %}\n    Language-specific breaking change rules for PHP:\n\n    MAJOR (breaking):\n    - Removing a required response field is always MAJOR\n    - Removing or renaming a public method or class is always MAJOR\n    - Changing a method signature (adding required parameters) is MAJOR\n    - Removing a method parameter is MAJOR\n    - Changing the type declaration of a parameter to an incompatible type is MAJOR\n    - Removing or renaming a public constant is MAJOR\n    - Changing a class from non-final to final is MAJOR (breaks extension)\n    - Removing an interface implementation from a public class is MAJOR\n    - Changing the return type declaration to an incompatible type is MAJOR\n    - Moving a class to a different namespace without aliasing is MAJOR\n    - Changing exception types thrown by a method is MAJOR\n\n    MINOR (backward-compatible additions):\n    - Making a response field nullable is MINOR in most cases (PHP is dynamically typed)\n    - Adding new optional parameters (with defaults) is MINOR\n    - Adding new public classes or methods is MINOR\n    - New enum cases are usually MINOR (PHP enums are not typically used in exhaustive matches)\n    - Adding new optional fields to request/response objects is MINOR\n    - Adding new exception classes is MINOR\n    - Adding new environment/server URL constants is MINOR\n    - Adding new traits or interfaces is MINOR\n    - Adding new RequestOptions fields is MINOR\n    - Deprecating (but not removing) public APIs is MINOR\n\n    PATCH (no API surface change):\n    - Changes to private/protected methods are PATCH\n    - PHPDoc, formatting, or composer.json metadata changes are PATCH\n    - Updating SDK version headers is PATCH\n    - Refactoring Guzzle/cURL internals without changing observable defaults or behavior is PATCH\n    - Updating dependency versions in composer.json is PATCH\n    - Refactoring internal implementation without changing public signatures is PATCH\n    - Changes to test files, phpunit.xml, or CI configuration are PATCH\n\n    {% elif language == "swift" %}\n    Language-specific breaking change rules for Swift:\n\n    MAJOR (breaking):\n    - Removing a required response field is always MAJOR\n    - Removing or renaming a public method, property, or type is always MAJOR\n    - Making a response field optional (T to T?) is MAJOR (callers must unwrap with if-let/guard)\n    - New enum cases are MAJOR (Swift switch statements must be exhaustive unless using default)\n    - Adding a new required parameter to a public method is MAJOR\n    - Changing the type of a public property is MAJOR\n    - Removing or changing a public protocol requirement is MAJOR\n    - Removing protocol conformance from a public type is MAJOR\n    - Changing a struct to a class (or vice versa) is MAJOR (value vs reference semantics)\n    - Making a public initializer failable (init to init?) or vice versa is MAJOR\n    - Changing the associated values of an enum case is MAJOR\n    - Removing a public typealias is MAJOR\n    - Changing access level from public to internal/private is MAJOR\n\n    MINOR (backward-compatible additions):\n    - Adding new public types, methods, or properties is MINOR\n    - Adding new optional parameters (with default values) is MINOR\n    - Adding new enum cases when callers use default in switch is MINOR\n    - Adding new protocol extensions with default implementations is MINOR\n    - Adding new optional fields to request/response structs is MINOR\n    - Adding new error types is MINOR\n    - Adding new environment/server URL constants is MINOR\n    - Adding new RequestOptions fields is MINOR\n    - Adding new convenience initializers is MINOR\n    - Deprecating (but not removing) public APIs with @available(*, deprecated) is MINOR\n\n    PATCH (no API surface change):\n    - Changes to internal or private members are PATCH\n    - Formatting, comments, or documentation changes are PATCH\n    - Updating SDK version headers is PATCH\n    - Refactoring URLSession internals without changing observable defaults or behavior is PATCH\n    - Updating dependency versions in Package.swift is PATCH\n    - Refactoring internal implementation without changing public signatures is PATCH\n    - Changes to test files, xcconfig, or CI configuration are PATCH\n\n    {% elif language == "rust" %}\n    Language-specific breaking change rules for Rust:\n\n    MAJOR (breaking):\n    - Removing a required response field is always MAJOR\n    - Removing or renaming a public function, struct, enum, or trait is always MAJOR\n    - Making a response field optional (T to Option<T>) is MAJOR (callers must handle the Option)\n    - New enum variants are MAJOR (Rust match statements must be exhaustive unless using _ wildcard)\n    - Adding a new required field to a public struct is MAJOR (unless #[non_exhaustive])\n    - Removing a public trait implementation is MAJOR\n    - Changing a function\'s return type is MAJOR\n    - Adding a required method to a public trait is MAJOR (all implementations must add it)\n    - Changing the type of a public struct field is MAJOR\n    - Removing or renaming a public module is MAJOR\n    - Making a public type private (pub to pub(crate) or removing pub) is MAJOR\n    - Changing a struct from non-exhaustive to exhaustive construction (removing .. Default::default()) is MAJOR\n    - Changing generic type parameters or their bounds on public types is MAJOR\n    - Changing from Result<T, E1> to Result<T, E2> where E2 is a different error type is MAJOR\n    - Removing a public constant or static is MAJOR\n\n    MINOR (backward-compatible additions):\n    - Adding new public functions, structs, or enums is MINOR\n    - Adding new optional fields to #[non_exhaustive] structs is MINOR\n    - Adding new enum variants to #[non_exhaustive] enums is MINOR\n    - Adding new trait implementations for existing types is MINOR\n    - Adding new public constants or statics is MINOR\n    - Adding new methods to existing impl blocks is MINOR\n    - Adding new error types is MINOR\n    - Adding new environment/server URL constants is MINOR\n    - Adding new RequestOptions fields is MINOR\n    - Adding new optional builder methods is MINOR\n    - Deprecating (but not removing) public APIs with #[deprecated] is MINOR\n\n    PATCH (no API surface change):\n    - Changes to pub(crate) or private items are PATCH\n    - Cargo.toml metadata, formatting, or comment changes are PATCH\n    - Updating SDK version headers is PATCH\n    - Refactoring reqwest/hyper internals without changing observable defaults or behavior is PATCH\n    - Updating dependency versions in Cargo.toml is PATCH\n    - Refactoring internal implementation without changing public signatures is PATCH\n    - Updating serialization/deserialization (serde) config that preserves public types is PATCH\n    - Changes to test files, build.rs, or CI configuration are PATCH\n\n    {% elif language == "kotlin" %}\n    Language-specific breaking change rules for Kotlin:\n\n    MAJOR (breaking):\n    - Removing a required response field is always MAJOR\n    - Removing or renaming a public function, class, or property is always MAJOR\n    - Making a response field nullable (T to T?) is MAJOR (callers must handle null safety operators)\n    - New enum values are MAJOR if used in when() expressions without else branch\n    - Adding a new required parameter to a public function is MAJOR\n    - Changing a method\'s return type is MAJOR\n    - Removing or changing a public constant (const val / companion object val) is MAJOR\n    - Changing a class from open to final (or data class to regular class) is MAJOR\n    - Removing an interface implementation from a public class is MAJOR\n    - Changing generic type parameters or their variance (in/out) on public types is MAJOR\n    - Moving a public class to a different package without type aliasing is MAJOR\n    - Changing a property from var to val (or removing a setter) is MAJOR\n    - Changing a suspend function to non-suspend (or vice versa) is MAJOR\n    - Changing sealed class/interface hierarchy (removing subclasses) is MAJOR\n\n    MINOR (backward-compatible additions):\n    - Adding new public classes, functions, or extension functions is MINOR\n    - Adding new optional parameters (with default values) is MINOR\n    - Adding new enum values when callers use else in when() is MINOR\n    - Adding new optional properties to data classes is MINOR\n    - Adding new exception types is MINOR\n    - Adding new environment/server URL constants is MINOR\n    - Adding new RequestOptions fields is MINOR\n    - Adding new sealed class/interface subtypes is MINOR (if callers have else branch)\n    - Deprecating (but not removing) public APIs with @Deprecated is MINOR\n    - Adding new companion object functions is MINOR\n\n    PATCH (no API surface change):\n    - Changes to internal or private members are PATCH\n    - KDoc, formatting, or build.gradle changes are PATCH\n    - Updating SDK version headers is PATCH\n    - Refactoring OkHttp internals without changing observable defaults or behavior is PATCH\n    - Updating dependency versions in build.gradle.kts is PATCH\n    - Refactoring internal implementation without changing public signatures is PATCH\n    - Updating serialization/deserialization (kotlinx.serialization/Moshi) config that preserves public types is PATCH\n    - Changes to test files or CI configuration are PATCH\n\n    {% else %}\n    Language-specific breaking change rules (language: {{ language }}):\n\n    MAJOR (breaking):\n    - Removing a required response field is always MAJOR\n    - Removing or renaming a public class, method, or function is always MAJOR\n    - Making a response field optional is MAJOR in statically-typed languages (TypeScript, Java, C#, Swift, Rust, Kotlin, Go), usually MINOR in dynamically-typed ones (Python, Ruby, PHP)\n    - New enum values are MAJOR if the language enforces exhaustive matching (TypeScript, Java, C#, Swift, Rust), MINOR otherwise\n    - Adding a new required parameter to a public method is MAJOR\n    - Changing a method\'s return type is MAJOR\n    - Changing the type of an existing field/property is MAJOR\n    - Removing or changing public constants is MAJOR\n\n    MINOR (backward-compatible additions):\n    - Adding new public APIs (classes, methods, functions) is MINOR\n    - Adding new optional parameters is MINOR\n    - Adding new optional fields to request/response objects is MINOR\n    - Adding new error/exception types is MINOR\n    - Deprecating (but not removing) public APIs is MINOR\n\n    PATCH (no API surface change):\n    - Internal/private changes are PATCH\n    - Formatting, documentation, or comment changes are PATCH\n    - Dependency version updates are PATCH\n    - SDK version header updates are PATCH\n    - Refactoring retry/timeout internals without changing observable defaults or behavior is PATCH\n    - Refactoring internals without changing public signatures is PATCH\n    {% endif %}\n\n    Apply these patterns to the diff below. When in doubt between MINOR and PATCH,\n    prefer MINOR. When in doubt between MAJOR and MINOR, examine whether existing\n    callers would break without any code changes on their side.\n\n    Message Format (use this exact structure):\n    ```\n    <type>: <short summary>\n\n    <detailed description of what changed and why it matters>\n\n    Key changes:\n    - <change 1>\n    - <change 2>\n    - <change 3>\n    ```\n\n    Message Guidelines:\n    - Use conventional commit types: feat, fix, refactor, docs, chore, test, style, perf\n    - Keep the summary line under 72 characters\n    - Write in present tense imperative mood ("add" not "added" or "adds")\n    - For breaking changes: include migration instructions in the detailed description\n    - For new features: highlight new capabilities in the key changes\n    - For PATCH: describe the fix or improvement\n    - For NO_CHANGE: use type "chore" and state that no functional changes were made\n    - Be specific and action-oriented\n    - Do not use "Fern regeneration" in commit messages - use "SDK regeneration" instead\n    - NEVER include the literal version "0.0.0-fern-placeholder" in the commit message - if you see this placeholder\n    in the diff, describe changes generically (e.g., "added X-Fern-SDK-Version header")\n    - The previous version is provided for context only. Do not include it\n    literally in the commit message summary line.\n\n    {% if prior_changelog %}\n    Prior changelog entries (for style reference):\n    ---\n    {{prior_changelog}}\n    ---\n    Match the tone and format of these entries in your commit message.\n    {% endif %}\n\n    {% if spec_commit_message %}\n    The API spec change that triggered this SDK generation had the following commit message:\n    "{{spec_commit_message}}"\n    Use this as a hint for understanding the intent of the change, but always verify\n    against the actual diff below. The commit message may be vague or inaccurate.\n    {% endif %}\n\n    Previous version: {{previous_version}}\n    SDK language: {{language}}\n\n    Git Diff:\n    ---\n    {{diff}}\n    ---\n\n    Changelog Entry Guidelines:\n    - Write for SDK consumers, not engineers reading the source code\n    - MAJOR: explain what broke and how to migrate ("The `getUser` method has been\n      removed. Replace calls with `fetchUser(id)` which returns the same type.")\n    - MINOR: describe the new capability ("New `createPayment()` method available\n      on `PaymentsClient`.")\n    - PATCH: leave empty string \u2014 patch changes don\'t warrant changelog entries\n    - Do not use conventional commit prefixes (no "feat:", "fix:", etc.)\n    - Write in third person ("The SDK now supports..." not "Add support for...")\n    - IMPORTANT: Wrap any type references containing angle brackets in backticks\n      to prevent MDX parsing issues. For example, write `Optional<String>` not\n      Optional<String>, and `Map<String, Object>` not Map<String, Object>.\n\n    Remember again that YOU MUST return a structured JSON response with these four fields:\n    - message: A git commit message formatted like the example previously provided\n    - changelog_entry: A user-facing release note (empty string for PATCH)\n    - version_bump: One of: MAJOR, MINOR, PATCH, or NO_CHANGE\n    - version_bump_reason: One sentence explaining WHY this bump level was chosen.\n      For MAJOR, name the specific breaking symbol(s) and explain why existing callers break.\n      For MINOR, name the new capability added.\n      For PATCH, describe what was fixed or improved.\n      For NO_CHANGE, say "No functional changes detected."\n      Example: "MAJOR because `parserCreateJob` InputStream overloads were removed from `RawLabReportClient`, breaking existing callers."\n  "#\n}\n\nclass ConsolidateChangelogResponse {\n    consolidated_changelog string\n        @description("CHANGELOG.md entry in Keep a Changelog format. Group under ### Breaking Changes, ### Added, ### Changed, ### Fixed. Bold symbol names, one tight sentence per bullet. Prose only, no code fences. Append migration action inline for breaking changes.")\n\n    pr_description string\n        @description("PR description with ## Breaking Changes section (if any) containing ### per breaking change with Before/After code fences and Migration line, then ## What\'s New section summarizing features in prose paragraphs grouped by theme. Do NOT list every class individually \u2014 summarize repetitive changes as a single entry.")\n\n    version_bump_reason string\n        @description("One sentence explaining WHY the overall version bump was chosen. For MAJOR: name the specific breaking symbol(s). For MINOR: name the new capability. For PATCH: describe the fix. Example: \'MAJOR because `parserCreateJob` InputStream overloads were removed from `RawLabReportClient`.\'")\n}\n\nfunction ConsolidateChangelog(\n    raw_entries: string @description("Newline-separated raw changelog entries from chunked diff analysis"),\n    version_bump: string @description("The overall version bump: MAJOR, MINOR, or PATCH"),\n    language: string @description("The SDK programming language, e.g. \'typescript\', \'python\', \'java\'")\n) -> ConsolidateChangelogResponse {\n  client DefaultClient\n\n  prompt #"\n    You are a technical writer formatting release notes for a {{language}} SDK.\n\n    The raw change notes below are noisy and repetitive \u2014 many bullets describe the same\n    change across different packages. Deduplicate aggressively: if the same feature appears\n    multiple times, merge into one entry.\n\n    Raw changelog entries:\n    ---\n    {{raw_entries}}\n    ---\n\n    Overall version bump: {{version_bump}}\n\n    Produce three outputs:\n\n    ---\n\n    ## 1. CHANGELOG.md entry (Keep a Changelog format)\n\n    - Group under: `### Breaking Changes`, `### Added`, `### Changed`, `### Fixed`\n    - Only include sections with entries\n    - **Bold the symbol name** first, then one tight sentence for SDK consumers\n    - No code fences \u2014 prose only\n    - For breaking changes, append the migration action inline\n\n    ## 2. PR Description\n\n    - `## Breaking Changes` section at top (if any)\n      - One `###` per breaking change with **Before/After** code fences and a **Migration:** line\n    - `## What\'s New` section summarizing added/changed features in prose paragraphs,\n      grouped by theme (e.g. logging, streaming, pagination, builder improvements)\n    - Do NOT list every class that got the same method \u2014 summarize as a single entry\n\n    ## 3. Version Bump Reason\n\n    - One sentence explaining WHY the overall version bump ({{version_bump}}) was chosen\n    - For MAJOR: name the specific breaking symbol(s) and explain why existing callers break\n    - For MINOR: name the new capability added\n    - For PATCH: describe what was fixed or improved\n    - Example: "MAJOR because `parserCreateJob` InputStream overloads were removed from `RawLabReportClient`, breaking existing callers."\n\n    ---\n\n    {{ ctx.output_format }}\n  "#\n}\n',
+  "diff_analyzer.baml": '// SDK Diff Analyzer\n// Analyzes git diffs of SDK code and produces semantic commit messages and version bumps\n\nenum VersionBump {\n    MAJOR\n    MINOR\n    PATCH\n    NO_CHANGE\n}\n\nclass AnalyzeCommitDiffRequest {\n    diff string @description("The git diff to analyze for generating a commit message")\n}\n\nclass AnalyzeCommitDiffResponse {\n    message string\n        @description("Developer-facing git commit message. Use conventional commit format. Reference specific code symbols (function names, class names). Keep summary under 72 chars.")\n\n    changelog_entry string\n        @description("User-facing release note for CHANGELOG.md and GitHub Releases. Describe the impact on SDK consumers, not implementation details. Include migration instructions for MAJOR. Use plain prose, not conventional commit format. Empty string for PATCH.")\n\n    version_bump VersionBump\n        @description("The recommended semantic version bump: MAJOR for breaking changes, MINOR for new features, PATCH for bug fixes and other changes, NO_CHANGE for empty diffs")\n\n    version_bump_reason string\n        @description("One sentence explaining WHY this version bump was chosen. For MAJOR: name the specific breaking symbol(s). For MINOR: name the new capability. For PATCH: describe the fix. For NO_CHANGE: \'No functional changes detected.\' Example: \'MAJOR because `parserCreateJob` InputStream overloads were removed from `RawLabReportClient`.\'")\n}\n\n// Main function that analyzes SDK diffs\nfunction AnalyzeSdkDiff(\n    diff: string @description("The git diff to analyze"),\n    language: string @description("The SDK programming language, e.g. \'typescript\', \'python\', \'java\'"),\n    previous_version: string @description("The current published version before this change, e.g. \'1.2.3\'"),\n    prior_changelog: string @description("The last 3 changelog entries for this SDK, empty string if none. Use this to match the existing commit message style and understand the versioning pattern."),\n    spec_commit_message: string @description("The commit message from the API spec repository that triggered this SDK generation. Use as a hint for the intent of the change, but verify against the actual diff. Empty string if unavailable.")\n) -> AnalyzeCommitDiffResponse {\n  client DefaultClient\n\n  prompt #"\n    You are an expert software engineer analyzing changes to generate semantic commit messages.\n\n    Analyze the provided git diff and return a structured response with these fields:\n    - message: A git commit message formatted like the example below\n    - version_bump: One of: MAJOR, MINOR, PATCH, or NO_CHANGE\n\n    Version Bump Guidelines:\n    - MAJOR: Breaking changes (removed/renamed functions, changed signatures, removed parameters)\n    - MINOR: New features that are backward compatible (new functions, new optional parameters).\n      Also MINOR: behavioral changes invisible to the public API surface that still affect consumers:\n      - Changed HTTP status code handling (e.g. 404 now throws instead of returning null)\n      - Changed default parameter values (timeout, retry count, page size, base URL)\n      - Changed serialization behavior (date formats, null handling, field ordering)\n      - Changed error message text that consumers may depend on\n      - Changed HTTP header names or values sent to the server\n      - Changed retry or backoff behavior (different retry counts, delay strategies)\n    - PATCH: Bug fixes, documentation, internal refactoring with no observable behavioral change\n    - NO_CHANGE: The diff is empty\n\n    --- Examples ---\n\n    Examples of correct classifications:\n\n    --- MAJOR: removed exported TypeScript function ---\n    diff --git a/src/api/client.ts b/src/api/client.ts\n    -export async function getUser(id: string): Promise<User> {\n    -    return this.request("GET", `/users/${id}`);\n    -}\n    version_bump: MAJOR\n    reason: Existing callers of getUser() will get a compile error.\n\n    --- MAJOR: removed Python public method ---\n    diff --git a/vital/client.py b/vital/client.py\n    -    def get_user(self, user_id: str) -> User:\n    -        return self._request("GET", f"/users/{user_id}")\n    version_bump: MAJOR\n    reason: Existing callers crash with AttributeError.\n\n    --- MINOR: new optional TypeScript parameter ---\n    diff --git a/src/api/client.ts b/src/api/client.ts\n    -async createUser(name: string): Promise<User>\n    +async createUser(name: string, role?: UserRole): Promise<User>\n    version_bump: MINOR\n    reason: Existing callers unaffected \u2014 new parameter is optional.\n\n    --- MINOR: new Java public method ---\n    diff --git a/src/.../UsersClient.java b/src/.../UsersClient.java\n    +    public CompletableFuture<User> getUserAsync(String userId) {\n    +        return this.httpClient.sendAsync(...);\n    +    }\n    version_bump: MINOR\n    reason: New capability added, nothing removed or changed.\n\n    --- MINOR: changed default retry count ---\n    diff --git a/src/core/http_client.py b/src/core/http_client.py\n    -MAX_RETRIES = 3\n    +MAX_RETRIES = 5\n    version_bump: MINOR\n    reason: Changed default retry count \u2014 existing consumers will experience different retry behavior.\n\n    --- PATCH: Go import reorganization ---\n    diff --git a/client.go b/client.go\n    -import "fmt"\n    -import "net/http"\n    +import (\n    +    "fmt"\n    +    "net/http"\n    +)\n    version_bump: PATCH\n    reason: Formatting change only, no functional difference.\n\n    --- End Examples ---\n\n    {% if language == "typescript" %}\n    Language-specific breaking change rules for TypeScript:\n\n    MAJOR (breaking):\n    - Removing a required response field is always MAJOR\n    - Removing or renaming a public class, method, function, or exported symbol is MAJOR\n    - Making a response field optional is MAJOR (type changes from T to T | undefined, breaking existing property access without null checks)\n    - Changing a method return type (e.g. Promise<T> to Promise<T | undefined>, or T to T | null) is MAJOR\n    - New enum values are MAJOR if the SDK generates exhaustive switch/if-else chains (callers get compile errors on unhandled cases)\n    - Changing a union type (adding/removing variants) is MAJOR if callers use exhaustive type narrowing or discriminated unions\n    - Adding a new required property to a request/input type is MAJOR (existing callers won\'t compile)\n    - Removing or renaming an exported type, interface, or type alias is MAJOR\n    - Changing the type of an existing property (e.g. string to number, or string to string[]) is MAJOR\n    - Changing a generic type parameter constraint (e.g. <T extends Foo> to <T extends Bar>) is MAJOR\n    - Converting a synchronous method to async (or vice versa) is MAJOR (changes return type to Promise<T>)\n    - Removing a default export or switching between default and named exports is MAJOR\n    - Changing the structure of a discriminated union (e.g. changing the discriminant field name) is MAJOR\n    - Removing or renaming environment/server URL constants is MAJOR\n    - Changing the constructor signature of a client class (adding required params) is MAJOR\n    - Narrowing a parameter type (e.g. string | number to string) is MAJOR (callers passing number break)\n\n    MINOR (backward-compatible additions):\n    - Adding a new optional parameter to a function is MINOR\n    - Adding new exported types, interfaces, or classes is MINOR\n    - Adding new methods to an existing client class is MINOR\n    - Adding new optional properties to request types is MINOR\n    - Adding new enum values when NOT used in exhaustive checks is MINOR\n    - Adding new environment/server URL constants is MINOR\n    - Widening a parameter type (e.g. string to string | number) is MINOR\n    - Adding new re-exports from index files is MINOR\n    - Adding new error types or exception classes is MINOR\n    - Adding new RequestOptions fields (e.g. timeout, retries) is MINOR\n    - Deprecating (but not removing) a public API is MINOR\n\n    PATCH (no API surface change):\n    - Changes to internal/private modules (core/, _internal/, utils/) are PATCH\n    - Reordering imports, formatting, or comment changes are PATCH\n    - Updating SDK version headers (X-Fern-SDK-Version, User-Agent) is PATCH\n    - Refactoring HTTP client internals without changing observable defaults or behavior is PATCH\n    - Updating dependency versions in package.json is PATCH\n    - Adding or modifying JSDoc/TSDoc comments is PATCH\n    - Refactoring internal implementation without changing public signatures is PATCH\n    - Changes to .npmignore, tsconfig.json, or build configuration are PATCH\n    - Updating serialization/deserialization logic that preserves the same public types is PATCH\n\n    {% elif language == "python" %}\n    Language-specific breaking change rules for Python:\n\n    MAJOR (breaking):\n    - Removing a required response field is always MAJOR\n    - Removing or renaming a public class, method, or function is always MAJOR\n    - Adding a new required parameter to a public method is MAJOR (callers get TypeError)\n    - Renaming a parameter in a public method is MAJOR if callers use keyword arguments\n    - Removing a parameter from a public method signature is MAJOR\n    - Changing the type of a parameter from one concrete type to an incompatible one is MAJOR\n    - Changing exception types raised by a method (callers catching specific exceptions break) is MAJOR\n    - Removing or renaming a public module or subpackage is MAJOR (import statements break)\n    - Moving a public class/function to a different module without re-exporting from the original is MAJOR\n    - Changing a class from inheriting one base to another when callers use isinstance() checks is MAJOR\n    - Removing a public class attribute or property is MAJOR\n\n    MINOR (backward-compatible additions):\n    - Making a response field optional is usually MINOR (Python uses None propagation; callers rarely type-check strictly)\n    - New enum values are MINOR (unknown values are handled gracefully with string fallbacks)\n    - Changing a return type from a concrete type to Optional is MINOR (duck typing absorbs this)\n    - Adding new public methods, classes, or modules is MINOR\n    - Adding new optional parameters (with defaults) is MINOR\n    - Adding new optional fields to Pydantic models is MINOR\n    - Adding new exception/error classes is MINOR\n    - Adding new class attributes or properties is MINOR\n    - Adding new type overloads (@overload decorator) is MINOR\n    - Adding new environment/server URL constants is MINOR\n    - Adding new RequestOptions fields (e.g. timeout, max_retries) is MINOR\n    - Deprecating (but not removing) a public API is MINOR\n    - Widening a type annotation (e.g. str to Union[str, int]) is MINOR\n\n    PATCH (no API surface change):\n    - Changes to private methods (prefixed with _) are PATCH\n    - Changes to type hints only (no runtime effect) are PATCH\n    - Reformatting, docstring updates, or comment changes are PATCH\n    - Updating SDK version headers (X-Fern-SDK-Version, User-Agent) are PATCH\n    - Refactoring httpx/requests client internals without changing observable defaults or behavior is PATCH\n    - Updating dependency versions in pyproject.toml/setup.py is PATCH\n    - Updating serialization/deserialization logic that preserves the same public types is PATCH\n    - Refactoring internal implementation without changing public signatures is PATCH\n    - Changes to __init__.py that don\'t alter public re-exports are PATCH\n    - Changes to conftest.py, test files, or CI configuration are PATCH\n\n    {% elif language == "java" %}\n    Language-specific breaking change rules for Java:\n\n    MAJOR (breaking):\n    - Removing a required response field is always MAJOR\n    - Removing or renaming a public class, method, or interface is always MAJOR\n    - Making a response field optional (e.g. T to Optional<T>) is MAJOR (callers must handle Optional unwrapping)\n    - New enum values are MAJOR if the SDK generates exhaustive switch statements\n    - Adding a new required parameter to a public method is MAJOR\n    - Changing a method\'s return type is MAJOR (even if compatible at runtime, recompilation fails)\n    - Removing or changing a public static final constant is MAJOR\n    - Changing a class from concrete to abstract (or vice versa) is MAJOR\n    - Changing the checked exceptions declared in a throws clause is MAJOR\n    - Removing a public constructor or changing its parameter list is MAJOR\n    - Removing an interface that a public class implements is MAJOR\n    - Changing generic type parameters on a public class (e.g. Foo<T> to Foo<T, U>) is MAJOR\n    - Moving a public class to a different package without re-exporting is MAJOR\n    - Narrowing a parameter type (e.g. Object to String) is MAJOR\n    - Making a non-final class final is MAJOR (breaks subclassing)\n    - Changing the type of a builder method parameter is MAJOR\n\n    MINOR (backward-compatible additions):\n    - Adding new overloaded methods is MINOR\n    - Adding new public classes or interfaces is MINOR\n    - Adding new optional builder methods is MINOR\n    - Adding new enum values when NOT used in exhaustive switch statements is MINOR\n    - Adding new optional fields to request objects is MINOR\n    - Adding new exception/error classes is MINOR\n    - Adding new static utility methods is MINOR\n    - Adding new environment/server URL constants is MINOR\n    - Adding new RequestOptions fields (e.g. timeout, retries) is MINOR\n    - Widening a parameter type (e.g. String to Object) is MINOR\n    - Adding default methods to interfaces (Java 8+) is MINOR\n    - Deprecating (but not removing) public APIs with @Deprecated is MINOR\n\n    PATCH (no API surface change):\n    - Changes to package-private or private methods are PATCH\n    - Changes to annotations (other than public API annotations), Javadoc, or formatting are PATCH\n    - Updating SDK version headers (X-Fern-SDK-Version, User-Agent) is PATCH\n    - Refactoring OkHttp/HttpClient internals without changing observable defaults or behavior is PATCH\n    - Updating dependency versions in build.gradle/pom.xml is PATCH\n    - Refactoring internal implementation without changing public signatures is PATCH\n    - Updating serialization/deserialization logic (Jackson/Gson config) that preserves public types is PATCH\n    - Changes to test files, CI configuration, or build scripts are PATCH\n\n    {% elif language == "go" %}\n    Language-specific breaking change rules for Go:\n\n    MAJOR (breaking):\n    - Removing a required response field is always MAJOR\n    - Removing or renaming an exported function, method, or type is always MAJOR\n    - Making a response field a pointer type (e.g. string to *string) is MAJOR (callers must dereference)\n    - Changing a function signature (adding/removing parameters or return values) is MAJOR (Go has no overloading)\n    - Removing or renaming an exported struct field is MAJOR\n    - Changing the type of an exported struct field is MAJOR\n    - Removing or renaming an exported constant or variable is MAJOR\n    - Changing an interface by adding methods is MAJOR (all implementations must add the method)\n    - Removing a method from an interface is MAJOR (callers using that method break)\n    - Changing a function\'s return type(s) is MAJOR (Go is strict about return types)\n    - Changing a variadic parameter to non-variadic (or vice versa) is MAJOR\n    - Moving a type/function to a different package without aliasing in the original is MAJOR\n    - Changing the receiver type of a method (value receiver to pointer receiver changes method set) is MAJOR\n    - Changing an exported error variable\'s type or value is MAJOR (callers using errors.Is break)\n\n    MINOR (backward-compatible additions):\n    - Adding new exported functions, methods, or types is MINOR\n    - New enum-like constants are MINOR (Go enums are not exhaustive by default)\n    - Adding new fields to a struct is MINOR (existing code still compiles, zero-value initialization)\n    - Making a response field optional (pointer) is usually MINOR if the field was already a struct field\n    - Adding new optional function parameters via functional options pattern is MINOR\n    - Adding new interface types is MINOR\n    - Adding new error types/variables is MINOR\n    - Adding new environment/server URL constants is MINOR\n    - Adding new RequestOption functions is MINOR\n    - Widening a return type from a concrete type to an interface is MINOR (if interface is satisfied)\n    - Adding new methods to a concrete type (does not break interface implementations) is MINOR\n\n    PATCH (no API surface change):\n    - Changes to unexported (lowercase) functions or types are PATCH\n    - Changes to go.mod dependencies, import reordering, or formatting are PATCH\n    - Updating SDK version headers (X-Fern-SDK-Version, User-Agent) is PATCH\n    - Refactoring http.Client internals without changing observable defaults or behavior is PATCH\n    - Updating serialization/deserialization logic (JSON tags, encoding) that preserves identical output is PATCH\n    - Refactoring internal implementation without changing exported signatures is PATCH\n    - Changes to *_test.go files, Makefile, or CI configuration are PATCH\n    - Updating comments, godoc, or code formatting (gofmt) is PATCH\n\n    {% elif language == "ruby" %}\n    Language-specific breaking change rules for Ruby:\n\n    MAJOR (breaking):\n    - Removing a required response field is always MAJOR\n    - Removing or renaming a public method is MAJOR (callers get NoMethodError)\n    - Adding a new required positional parameter is MAJOR\n    - Removing a method parameter is MAJOR (callers passing that argument get ArgumentError)\n    - Changing the order of positional parameters is MAJOR\n    - Removing or renaming a public class or module is MAJOR (callers get NameError)\n    - Changing a method from instance to class method (or vice versa) is MAJOR\n    - Changing the return type in a breaking way (e.g. returning nil where an object was expected and callers chain methods) is MAJOR\n    - Removing a public constant is MAJOR\n    - Changing exception types raised by a method is MAJOR (callers rescuing specific exceptions break)\n\n    MINOR (backward-compatible additions):\n    - Making a response field optional is usually MINOR (Ruby uses nil propagation; callers rarely type-check)\n    - New enum values are MINOR (unknown values are handled gracefully)\n    - Adding new optional keyword parameters (with defaults) is MINOR\n    - Adding new public methods or classes is MINOR\n    - Adding new optional fields to response/request objects is MINOR\n    - Adding new exception/error classes is MINOR\n    - Adding new environment/server URL constants is MINOR\n    - Adding new RequestOptions fields (e.g. timeout, max_retries) is MINOR\n    - Deprecating (but not removing) a public API is MINOR\n    - Adding new modules or mixins is MINOR\n\n    PATCH (no API surface change):\n    - Changes to private methods are PATCH\n    - Gemspec metadata, comment, or formatting changes are PATCH\n    - Updating SDK version headers is PATCH\n    - Refactoring Faraday/Net::HTTP internals without changing observable defaults or behavior is PATCH\n    - Updating dependency versions in Gemfile/gemspec is PATCH\n    - Refactoring internal implementation without changing public signatures is PATCH\n    - Changes to test files, Rakefile, or CI configuration are PATCH\n\n    {% elif language == "csharp" %}\n    Language-specific breaking change rules for C#:\n\n    MAJOR (breaking):\n    - Removing a required response field is always MAJOR\n    - Removing or renaming a public class, method, property, or interface is always MAJOR\n    - Making a response field nullable (e.g. T to T?) is MAJOR (callers must handle null checks)\n    - New enum values are MAJOR if the SDK generates exhaustive switch expressions\n    - Adding a new required parameter to a public method is MAJOR\n    - Changing a method\'s return type is MAJOR\n    - Removing or changing a public constant or static readonly field is MAJOR\n    - Changing a class from non-sealed to sealed (or abstract to concrete) is MAJOR\n    - Changing the base class of a public class is MAJOR\n    - Removing an interface implementation from a public class is MAJOR\n    - Changing generic type constraints on a public class or method is MAJOR\n    - Moving a public type to a different namespace without type forwarding is MAJOR\n    - Changing property from read-write to read-only (removing setter) is MAJOR\n    - Changing async method to sync (Task<T> to T) or vice versa is MAJOR\n\n    MINOR (backward-compatible additions):\n    - Adding new public classes, interfaces, or methods is MINOR\n    - Adding new optional parameters (with default values) is MINOR\n    - Adding new overloaded methods is MINOR\n    - Adding new enum values when NOT used in exhaustive switch expressions is MINOR\n    - Adding new optional properties to request objects is MINOR\n    - Adding new exception types is MINOR\n    - Adding new environment/server URL constants is MINOR\n    - Adding new RequestOptions fields (e.g. Timeout, MaxRetries) is MINOR\n    - Adding new extension methods is MINOR\n    - Deprecating (but not removing) public APIs with [Obsolete] is MINOR\n\n    PATCH (no API surface change):\n    - Changes to internal or private members are PATCH\n    - XML doc comments, formatting, or namespace reorganization are PATCH\n    - Updating SDK version headers is PATCH\n    - Refactoring HttpClient internals without changing observable defaults or behavior is PATCH\n    - Updating dependency versions in .csproj is PATCH\n    - Refactoring internal implementation without changing public signatures is PATCH\n    - Updating serialization/deserialization (System.Text.Json/Newtonsoft) config that preserves public types is PATCH\n    - Changes to test files, .sln, or CI configuration are PATCH\n\n    {% elif language == "php" %}\n    Language-specific breaking change rules for PHP:\n\n    MAJOR (breaking):\n    - Removing a required response field is always MAJOR\n    - Removing or renaming a public method or class is always MAJOR\n    - Changing a method signature (adding required parameters) is MAJOR\n    - Removing a method parameter is MAJOR\n    - Changing the type declaration of a parameter to an incompatible type is MAJOR\n    - Removing or renaming a public constant is MAJOR\n    - Changing a class from non-final to final is MAJOR (breaks extension)\n    - Removing an interface implementation from a public class is MAJOR\n    - Changing the return type declaration to an incompatible type is MAJOR\n    - Moving a class to a different namespace without aliasing is MAJOR\n    - Changing exception types thrown by a method is MAJOR\n\n    MINOR (backward-compatible additions):\n    - Making a response field nullable is MINOR in most cases (PHP is dynamically typed)\n    - Adding new optional parameters (with defaults) is MINOR\n    - Adding new public classes or methods is MINOR\n    - New enum cases are usually MINOR (PHP enums are not typically used in exhaustive matches)\n    - Adding new optional fields to request/response objects is MINOR\n    - Adding new exception classes is MINOR\n    - Adding new environment/server URL constants is MINOR\n    - Adding new traits or interfaces is MINOR\n    - Adding new RequestOptions fields is MINOR\n    - Deprecating (but not removing) public APIs is MINOR\n\n    PATCH (no API surface change):\n    - Changes to private/protected methods are PATCH\n    - PHPDoc, formatting, or composer.json metadata changes are PATCH\n    - Updating SDK version headers is PATCH\n    - Refactoring Guzzle/cURL internals without changing observable defaults or behavior is PATCH\n    - Updating dependency versions in composer.json is PATCH\n    - Refactoring internal implementation without changing public signatures is PATCH\n    - Changes to test files, phpunit.xml, or CI configuration are PATCH\n\n    {% elif language == "swift" %}\n    Language-specific breaking change rules for Swift:\n\n    MAJOR (breaking):\n    - Removing a required response field is always MAJOR\n    - Removing or renaming a public method, property, or type is always MAJOR\n    - Making a response field optional (T to T?) is MAJOR (callers must unwrap with if-let/guard)\n    - New enum cases are MAJOR (Swift switch statements must be exhaustive unless using default)\n    - Adding a new required parameter to a public method is MAJOR\n    - Changing the type of a public property is MAJOR\n    - Removing or changing a public protocol requirement is MAJOR\n    - Removing protocol conformance from a public type is MAJOR\n    - Changing a struct to a class (or vice versa) is MAJOR (value vs reference semantics)\n    - Making a public initializer failable (init to init?) or vice versa is MAJOR\n    - Changing the associated values of an enum case is MAJOR\n    - Removing a public typealias is MAJOR\n    - Changing access level from public to internal/private is MAJOR\n\n    MINOR (backward-compatible additions):\n    - Adding new public types, methods, or properties is MINOR\n    - Adding new optional parameters (with default values) is MINOR\n    - Adding new enum cases when callers use default in switch is MINOR\n    - Adding new protocol extensions with default implementations is MINOR\n    - Adding new optional fields to request/response structs is MINOR\n    - Adding new error types is MINOR\n    - Adding new environment/server URL constants is MINOR\n    - Adding new RequestOptions fields is MINOR\n    - Adding new convenience initializers is MINOR\n    - Deprecating (but not removing) public APIs with @available(*, deprecated) is MINOR\n\n    PATCH (no API surface change):\n    - Changes to internal or private members are PATCH\n    - Formatting, comments, or documentation changes are PATCH\n    - Updating SDK version headers is PATCH\n    - Refactoring URLSession internals without changing observable defaults or behavior is PATCH\n    - Updating dependency versions in Package.swift is PATCH\n    - Refactoring internal implementation without changing public signatures is PATCH\n    - Changes to test files, xcconfig, or CI configuration are PATCH\n\n    {% elif language == "rust" %}\n    Language-specific breaking change rules for Rust:\n\n    MAJOR (breaking):\n    - Removing a required response field is always MAJOR\n    - Removing or renaming a public function, struct, enum, or trait is always MAJOR\n    - Making a response field optional (T to Option<T>) is MAJOR (callers must handle the Option)\n    - New enum variants are MAJOR (Rust match statements must be exhaustive unless using _ wildcard)\n    - Adding a new required field to a public struct is MAJOR (unless #[non_exhaustive])\n    - Removing a public trait implementation is MAJOR\n    - Changing a function\'s return type is MAJOR\n    - Adding a required method to a public trait is MAJOR (all implementations must add it)\n    - Changing the type of a public struct field is MAJOR\n    - Removing or renaming a public module is MAJOR\n    - Making a public type private (pub to pub(crate) or removing pub) is MAJOR\n    - Changing a struct from non-exhaustive to exhaustive construction (removing .. Default::default()) is MAJOR\n    - Changing generic type parameters or their bounds on public types is MAJOR\n    - Changing from Result<T, E1> to Result<T, E2> where E2 is a different error type is MAJOR\n    - Removing a public constant or static is MAJOR\n\n    MINOR (backward-compatible additions):\n    - Adding new public functions, structs, or enums is MINOR\n    - Adding new optional fields to #[non_exhaustive] structs is MINOR\n    - Adding new enum variants to #[non_exhaustive] enums is MINOR\n    - Adding new trait implementations for existing types is MINOR\n    - Adding new public constants or statics is MINOR\n    - Adding new methods to existing impl blocks is MINOR\n    - Adding new error types is MINOR\n    - Adding new environment/server URL constants is MINOR\n    - Adding new RequestOptions fields is MINOR\n    - Adding new optional builder methods is MINOR\n    - Deprecating (but not removing) public APIs with #[deprecated] is MINOR\n\n    PATCH (no API surface change):\n    - Changes to pub(crate) or private items are PATCH\n    - Cargo.toml metadata, formatting, or comment changes are PATCH\n    - Updating SDK version headers is PATCH\n    - Refactoring reqwest/hyper internals without changing observable defaults or behavior is PATCH\n    - Updating dependency versions in Cargo.toml is PATCH\n    - Refactoring internal implementation without changing public signatures is PATCH\n    - Updating serialization/deserialization (serde) config that preserves public types is PATCH\n    - Changes to test files, build.rs, or CI configuration are PATCH\n\n    {% elif language == "kotlin" %}\n    Language-specific breaking change rules for Kotlin:\n\n    MAJOR (breaking):\n    - Removing a required response field is always MAJOR\n    - Removing or renaming a public function, class, or property is always MAJOR\n    - Making a response field nullable (T to T?) is MAJOR (callers must handle null safety operators)\n    - New enum values are MAJOR if used in when() expressions without else branch\n    - Adding a new required parameter to a public function is MAJOR\n    - Changing a method\'s return type is MAJOR\n    - Removing or changing a public constant (const val / companion object val) is MAJOR\n    - Changing a class from open to final (or data class to regular class) is MAJOR\n    - Removing an interface implementation from a public class is MAJOR\n    - Changing generic type parameters or their variance (in/out) on public types is MAJOR\n    - Moving a public class to a different package without type aliasing is MAJOR\n    - Changing a property from var to val (or removing a setter) is MAJOR\n    - Changing a suspend function to non-suspend (or vice versa) is MAJOR\n    - Changing sealed class/interface hierarchy (removing subclasses) is MAJOR\n\n    MINOR (backward-compatible additions):\n    - Adding new public classes, functions, or extension functions is MINOR\n    - Adding new optional parameters (with default values) is MINOR\n    - Adding new enum values when callers use else in when() is MINOR\n    - Adding new optional properties to data classes is MINOR\n    - Adding new exception types is MINOR\n    - Adding new environment/server URL constants is MINOR\n    - Adding new RequestOptions fields is MINOR\n    - Adding new sealed class/interface subtypes is MINOR (if callers have else branch)\n    - Deprecating (but not removing) public APIs with @Deprecated is MINOR\n    - Adding new companion object functions is MINOR\n\n    PATCH (no API surface change):\n    - Changes to internal or private members are PATCH\n    - KDoc, formatting, or build.gradle changes are PATCH\n    - Updating SDK version headers is PATCH\n    - Refactoring OkHttp internals without changing observable defaults or behavior is PATCH\n    - Updating dependency versions in build.gradle.kts is PATCH\n    - Refactoring internal implementation without changing public signatures is PATCH\n    - Updating serialization/deserialization (kotlinx.serialization/Moshi) config that preserves public types is PATCH\n    - Changes to test files or CI configuration are PATCH\n\n    {% else %}\n    Language-specific breaking change rules (language: {{ language }}):\n\n    MAJOR (breaking):\n    - Removing a required response field is always MAJOR\n    - Removing or renaming a public class, method, or function is always MAJOR\n    - Making a response field optional is MAJOR in statically-typed languages (TypeScript, Java, C#, Swift, Rust, Kotlin, Go), usually MINOR in dynamically-typed ones (Python, Ruby, PHP)\n    - New enum values are MAJOR if the language enforces exhaustive matching (TypeScript, Java, C#, Swift, Rust), MINOR otherwise\n    - Adding a new required parameter to a public method is MAJOR\n    - Changing a method\'s return type is MAJOR\n    - Changing the type of an existing field/property is MAJOR\n    - Removing or changing public constants is MAJOR\n\n    MINOR (backward-compatible additions):\n    - Adding new public APIs (classes, methods, functions) is MINOR\n    - Adding new optional parameters is MINOR\n    - Adding new optional fields to request/response objects is MINOR\n    - Adding new error/exception types is MINOR\n    - Deprecating (but not removing) public APIs is MINOR\n\n    PATCH (no API surface change):\n    - Internal/private changes are PATCH\n    - Formatting, documentation, or comment changes are PATCH\n    - Dependency version updates are PATCH\n    - SDK version header updates are PATCH\n    - Refactoring retry/timeout internals without changing observable defaults or behavior is PATCH\n    - Refactoring internals without changing public signatures is PATCH\n    {% endif %}\n\n    Apply these patterns to the diff below. When in doubt between MINOR and PATCH,\n    prefer MINOR. When in doubt between MAJOR and MINOR, examine whether existing\n    callers would break without any code changes on their side.\n\n    Message Format (use this exact structure):\n    ```\n    <type>: <short summary>\n\n    <detailed description of what changed and why it matters>\n\n    Key changes:\n    - <change 1>\n    - <change 2>\n    - <change 3>\n    ```\n\n    Message Guidelines:\n    - The commit type MUST match the version bump:\n      - MAJOR \u2192 use "feat!:" prefix (the "!" signals a breaking change per Conventional Commits)\n      - MINOR \u2192 use "feat:" prefix\n      - PATCH \u2192 use "fix:" or "chore:" prefix (whichever fits the change)\n      - NO_CHANGE \u2192 use "chore:" prefix\n    - Keep the summary line under 72 characters\n    - Write in present tense imperative mood ("add" not "added" or "adds")\n    - For MAJOR: the summary MUST name the breaking change (e.g., "feat!: remove parserCreateJob InputStream overloads")\n    - For MINOR: the summary should name the new capability\n    - For PATCH: describe the fix or improvement\n    - Be specific \u2014 do not use generic summaries like "update SDK" or "regenerate SDK"\n    - Do not use "Fern regeneration" in commit messages \u2014 use "SDK regeneration" instead\n    - NEVER include the literal version "0.0.0-fern-placeholder" in the commit message \u2014 if you see this placeholder\n      in the diff, describe changes generically (e.g., "added X-Fern-SDK-Version header")\n    - The previous version is provided for context only. Do not include it literally in the summary line.\n\n    {% if prior_changelog %}\n    Prior changelog entries (for style reference):\n    ---\n    {{prior_changelog}}\n    ---\n    Match the tone and format of these entries in your commit message.\n    {% endif %}\n\n    {% if spec_commit_message %}\n    The API spec change that triggered this SDK generation had the following commit message:\n    "{{spec_commit_message}}"\n    Use this as a hint for understanding the intent of the change, but always verify\n    against the actual diff below. The commit message may be vague or inaccurate.\n    {% endif %}\n\n    Previous version: {{previous_version}}\n    SDK language: {{language}}\n\n    Git Diff:\n    ---\n    {{diff}}\n    ---\n\n    Changelog Entry Guidelines:\n    - Write for SDK consumers, not engineers reading the source code\n    - Prefix each entry with a category tag: [BREAKING], [ADDED], [CHANGED], or [FIXED]\n      - MAJOR changes MUST use [BREAKING]\n      - MINOR additions use [ADDED]\n      - MINOR behavioral changes use [CHANGED]\n      - PATCH fixes use [FIXED] (or empty string if trivial)\n    - For [BREAKING]: name the exact symbol, explain what broke, and give a one-line migration\n      Example: "[BREAKING] **`parserCreateJob`** now accepts `File[]` instead of `File`. Wrap single files in an array: `parserCreateJob([file], request)`."\n    - For [ADDED]: name the new capability in one sentence\n      Example: "[ADDED] **`LabAccountClient`** for managing team lab accounts."\n    - Describe patterns once, not per-file. If the same method was added to 50 classes,\n      write ONE entry: "[ADDED] **`additionalProperty()`** and **`additionalProperties()`** builder methods on all request types."\n      Do NOT write 50 separate entries.\n    - NEVER silently drop a category of change. If new enum values were added, new clients were introduced,\n      or fields were removed, each *category* must appear \u2014 but you don\'t need to list every individual value.\n      GOOD: "[ADDED] New enum values added across several types including `ProviderType` and `OrderStatus`."\n      BAD:  listing every enum value\n    - PATCH: leave empty string \u2014 patch changes don\'t warrant changelog entries\n    - Do not use conventional commit prefixes (no "feat:", "fix:", etc.)\n    - Write in third person present tense\n    - Prefer fewer, richer entries over many thin ones. Aim for 3-5 entries per chunk by grouping related changes.\n    - IMPORTANT: Wrap type references containing angle brackets in backticks (e.g., `Optional<String>`)\n\n    Remember again that YOU MUST return a structured JSON response with these four fields:\n    - message: A git commit message formatted like the example previously provided\n    - changelog_entry: A user-facing release note (empty string for PATCH)\n    - version_bump: One of: MAJOR, MINOR, PATCH, or NO_CHANGE\n    - version_bump_reason: One sentence explaining WHY this bump level was chosen.\n      For MAJOR, name the specific breaking symbol(s) and explain why existing callers break.\n      For MINOR, name the new capability added.\n      For PATCH, describe what was fixed or improved.\n      For NO_CHANGE, say "No functional changes detected."\n      Example: "MAJOR because `parserCreateJob` InputStream overloads were removed from `RawLabReportClient`, breaking existing callers."\n  "#\n}\n\nclass ConsolidateChangelogResponse {\n    consolidated_changelog string\n        @description("CHANGELOG.md entry in Keep a Changelog format. Group under ### Breaking Changes, ### Added, ### Changed, ### Fixed. Bold symbol names, one tight sentence per bullet. Prose only, no code fences. Append migration action inline for breaking changes.")\n\n    pr_description string\n        @description("PR description with ## Breaking Changes section (if any) containing ### per breaking change with Before/After code fences and Migration line, then ## What\'s New section summarizing features in prose paragraphs grouped by theme. Do NOT list every class individually \u2014 summarize repetitive changes as a single entry.")\n\n    version_bump_reason string\n        @description("One sentence explaining WHY the overall version bump was chosen. For MAJOR: name the specific breaking symbol(s). For MINOR: name the new capability. For PATCH: describe the fix. Example: \'MAJOR because `parserCreateJob` InputStream overloads were removed from `RawLabReportClient`.\'")\n}\n\nfunction ConsolidateChangelog(\n    raw_entries: string @description("Newline-separated raw changelog entries from chunked diff analysis"),\n    version_bump: string @description("The overall version bump: MAJOR, MINOR, or PATCH"),\n    language: string @description("The SDK programming language, e.g. \'typescript\', \'python\', \'java\'"),\n    previous_version: string @description("The previous SDK version before this change, e.g. \'1.2.3\'. Empty string if unknown."),\n    new_version: string @description("The new SDK version after this change, e.g. \'1.3.0\'. Empty string if unknown.")\n) -> ConsolidateChangelogResponse {\n  client DefaultClient\n\n  prompt #"\n    You are a technical writer producing release notes for a {{language}} SDK.\n\n    ## Input\n\n    Raw changelog entries from chunked diff analysis (noisy, repetitive):\n    ---\n    {{raw_entries}}\n    ---\n\n    Overall version bump: {{version_bump}}\n    {% if previous_version %}Previous version: {{previous_version}}{% endif %}\n    {% if new_version %}New version: {{new_version}}{% endif %}\n\n    ## Deduplication Rules (CRITICAL)\n\n    Before writing anything, apply these deduplication rules:\n\n    1. **Pattern collapse**: If the same method/field/type was added/changed/removed across\n       multiple classes or files, write ONE bullet summarizing the pattern.\n       BAD:  "- `additionalProperty()` added to UserRequest" + "- `additionalProperty()` added to OrderRequest" + ... (x15)\n       GOOD: "- **`additionalProperty()`** and **`additionalProperties()`** builder methods added to all request and response types"\n\n    2. **Semantic merge**: If multiple entries describe aspects of the same feature, merge them.\n       BAD:  "- New LabAccountClient" + "- New getTeamLabAccounts method" + "- Lab account management support"\n       GOOD: "- **`LabAccountClient`** \u2014 new client for managing team lab accounts with `getTeamLabAccounts()` support"\n\n    3. **No silent drops**: Every *category* of change (new clients, new methods, removed methods,\n       new enum values, field type changes, etc.) must be represented in at least one bullet.\n       You don\'t need to list every individual value or class \u2014 just acknowledge the category.\n       GOOD: "- **New enum values** added across several types including `ProviderType` and `OrderStatus`"\n       BAD:  Silently omitting that enum values changed at all\n       ALSO BAD: Listing every value: `SamsungHealth`, `SonoraQuest`, `Cancelled`, `Processing`, ...\n\n    4. **Prefer concise output**: Aim for 5-15 bullets total. Prioritize breaking changes and new\n       capabilities. Bulk additions (builder methods, enum values) get one summary bullet each.\n\n    ## Output 1: consolidated_changelog (CHANGELOG.md entry)\n\n    Structure it EXACTLY like this, omitting empty sections:\n\n    ### Breaking Changes\n    - **`symbolName`** \u2014 what broke and how to migrate. Example: replace `foo(file)` with `foo([file])`.\n\n    ### Added\n    - **`symbolName`** \u2014 what was added, one sentence.\n\n    ### Changed\n    - **`symbolName`** \u2014 what changed, one sentence.\n\n    ### Fixed\n    - **`symbolName`** \u2014 what was fixed, one sentence.\n\n    Rules:\n    - **Breaking Changes** section MUST come first when present\n    - Bold the symbol name, then a dash, then one tight sentence\n    - No code fences in the changelog \u2014 prose and backtick-wrapped symbols only\n    - Aim for 5-15 total bullets. Every *category* of change must be represented, but individual\n      values/classes within a category can be summarized (e.g., "new enum values across several types").\n    - One line per change, no multi-line bullets\n\n    ## Output 2: pr_description (PR body)\n\n    {% if previous_version and new_version %}\n    The PR description MUST start with a version summary block:\n\n    ## {{previous_version}} \u2192 {{new_version}} ({{version_bump}})\n\n    **Reason:** {version_bump_reason}\n\n    Then the breaking changes / what\'s new sections follow.\n    {% endif %}\n\n    If version_bump is MAJOR, start with:\n\n    ## Breaking Changes\n\n    ### `symbolName` \u2014 short description\n    **Before:**\n    ```{{language}}\n    // old usage\n    ```\n    **After:**\n    ```{{language}}\n    // new usage\n    ```\n    **Migration:** One sentence on how to update.\n\n    (repeat for each breaking change)\n\n    Then:\n\n    ## What\'s New\n    Brief prose paragraphs grouped by theme. Do NOT list every class \u2014 summarize patterns.\n\n    If version_bump is MINOR or PATCH, just use:\n\n    ## What\'s New\n    Brief prose paragraphs grouped by theme. Do NOT list every class \u2014 summarize patterns.\n\n    Rules:\n    - Breaking changes section at top with Before/After code examples\n    - What\'s New in prose paragraphs, not bullet lists \u2014 group by theme (e.g., "Lab account management", "Builder improvements")\n    - Do NOT list every class that got the same method \u2014 summarize as one theme\n    - Every *category* of change from the changelog must be mentioned somewhere in the PR description.\n      Don\'t enumerate every value \u2014 summarize bulk changes in a sentence.\n\n    ## Output 3: version_bump_reason\n\n    One sentence explaining WHY the overall version bump ({{version_bump}}) was chosen.\n    - For MAJOR: name the specific breaking symbol(s) and explain why existing callers break\n    - For MINOR: name the new capability added\n    - For PATCH: describe what was fixed or improved\n    - Example: "MAJOR because `parserCreateJob` InputStream overloads were removed from `RawLabReportClient`, breaking existing callers that pass InputStream arguments."\n\n    {{ ctx.output_format }}\n  "#\n}\n',
   "generators.baml": 'generator target {\n    output_type "typescript"\n\n    output_dir "../src/"\n\n    version "0.219.0"\n\n    default_client_mode async\n}\n',
   "main.baml": "// BAML client configuration for LLM providers\n\n// OpenAI client configuration\nclient<llm> OpenAI {\n  provider openai\n  options {\n    model gpt-4o\n    api_key env.OPENAI_API_KEY\n  }\n}\n\n// Anthropic client configuration\nclient<llm> Anthropic {\n  provider anthropic\n  options {\n    model claude-sonnet-4-5-20250929\n    api_key env.ANTHROPIC_API_KEY\n  }\n}\n\n// Bedrock client configuration\nclient<llm> Bedrock {\n    provider aws-bedrock\n    options {\n        model anthropic.claude-3-5-sonnet-20240620-v1:0\n    }\n}\n\n// Fallback client that tries multiple providers\n// TODO(tjb9dc): I wish we didn't have to specify this, we're only going to use one at runtime\nclient<llm> DefaultClient {\n  provider fallback\n  options {\n    strategy [\n      Anthropic\n      OpenAI\n      Bedrock\n    ]\n  }\n}\n"
 };
@@ -906502,7 +906506,7 @@ var BamlAsyncClient = class _BamlAsyncClient {
       throw (0, import_baml4.toBamlError)(error50);
     }
   }
-  async ConsolidateChangelog(raw_entries, version_bump, language, __baml_options__) {
+  async ConsolidateChangelog(raw_entries, version_bump, language, previous_version, new_version, __baml_options__) {
     try {
       const __options__ = { ...this.bamlOptions, ...__baml_options__ || {} };
       const __signal__ = __options__.signal;
@@ -906510,7 +906514,7 @@ var BamlAsyncClient = class _BamlAsyncClient {
         throw new import_baml4.BamlAbortError("Operation was aborted", __signal__.reason);
       }
       if (__options__.onTick) {
-        const __stream__ = this.stream.ConsolidateChangelog(raw_entries, version_bump, language, __baml_options__);
+        const __stream__ = this.stream.ConsolidateChangelog(raw_entries, version_bump, language, previous_version, new_version, __baml_options__);
         return await __stream__.getFinalResponse();
       }
       const __collector__ = __options__.collector ? Array.isArray(__options__.collector) ? __options__.collector : [__options__.collector] : [];
@@ -906524,7 +906528,9 @@ var BamlAsyncClient = class _BamlAsyncClient {
       const __raw__ = await this.runtime.callFunction("ConsolidateChangelog", {
         "raw_entries": raw_entries,
         "version_bump": version_bump,
-        "language": language
+        "language": language,
+        "previous_version": previous_version,
+        "new_version": new_version
       }, this.ctxManager.cloneContext(), __options__.tb?.__tb(), __clientRegistry__, __collector__, __options__.tags || {}, __env__, __signal__, __options__.watchers);
       return __raw__.parsed(false);
     } catch (error50) {
@@ -906583,7 +906589,7 @@ var BamlStreamClient = class {
       throw (0, import_baml4.toBamlError)(error50);
     }
   }
-  ConsolidateChangelog(raw_entries, version_bump, language, __baml_options__) {
+  ConsolidateChangelog(raw_entries, version_bump, language, previous_version, new_version, __baml_options__) {
     try {
       const __options__ = { ...this.bamlOptions, ...__baml_options__ || {} };
       const __signal__ = __options__.signal;
@@ -906616,7 +906622,9 @@ var BamlStreamClient = class {
       const __raw__ = this.runtime.streamFunction("ConsolidateChangelog", {
         "raw_entries": raw_entries,
         "version_bump": version_bump,
-        "language": language
+        "language": language,
+        "previous_version": previous_version,
+        "new_version": new_version
       }, void 0, this.ctxManager.cloneContext(), __options__.tb?.__tb(), __clientRegistry__, __collector__, __options__.tags || {}, __env__, __signal__, __onTickWrapper__);
       return new import_baml4.BamlStream(__raw__, (a10) => a10, (a10) => a10, this.ctxManager.cloneContext(), __options__.signal);
     } catch (error50) {
@@ -906962,9 +906970,10 @@ var LocalTaskHandler = class {
               const rawEntries = allChangelogEntries.map((e6) => e6.startsWith("- ") ? e6 : `- ${e6}`).join("\n");
               try {
                 this.context.logger.debug(`Consolidating ${allChangelogEntries.length} changelog entries via AI rollup`);
+                const projectedVersion = this.incrementVersion(previousVersion, bestBump);
                 const rollup = await b18.withOptions({
                   clientRegistry: await this.getClientRegistry()
-                }).ConsolidateChangelog(rawEntries, bestBump, this.generatorLanguage ?? "unknown");
+                }).ConsolidateChangelog(rawEntries, bestBump, this.generatorLanguage ?? "unknown", previousVersion, projectedVersion);
                 changelogEntry2 = rollup.consolidated_changelog?.trim() || rawEntries;
                 prDescription2 = rollup.pr_description?.trim() || void 0;
                 versionBumpReason2 = rollup.version_bump_reason?.trim() || void 0;
@@ -928615,7 +928624,10 @@ var SentryClient = class {
     if (isTelemetryEnabled && sentryDsn != null && sentryDsn.length > 0) {
       const sentryEnvironment = "development";
       if (sentryEnvironment == null || sentryEnvironment.length === 0) {
-        throw new Error("SENTRY_ENVIRONMENT must be set when SENTRY_DSN is configured");
+        throw new CliError({
+          message: "SENTRY_ENVIRONMENT must be set when SENTRY_DSN is configured",
+          code: CliError.Code.ConfigError
+        });
       }
       this.sentry = init2({
         dsn: sentryDsn,
@@ -928654,7 +928666,10 @@ var StdoutRedirector = class {
   redirected = false;
   redirect() {
     if (this.redirected) {
-      throw new Error("StdoutRedirector: already redirected \u2014 did you forget to restore()?");
+      throw new CliError({
+        message: "StdoutRedirector: already redirected \u2014 did you forget to restore()?",
+        code: CliError.Code.InternalError
+      });
     }
     this.originalWrite = process.stdout.write;
     process.stdout.write = process.stderr.write.bind(process.stderr);
@@ -928963,7 +928978,7 @@ async function normalizeGeneratorName2(generatorImage) {
   });
   const generatorResponse = await client3.generators.getGeneratorByImage({ dockerImage: generatorImage });
   if (!generatorResponse.ok || generatorResponse.body == null) {
-    throw new Error(`Generator ${generatorImage} not found`);
+    throw new CliError({ message: `Generator ${generatorImage} not found`, code: CliError.Code.InternalError });
   }
   return generatorResponse.body.displayName;
 }
@@ -929144,9 +929159,16 @@ async function getLatestVersionOfCli({
   if (cliEnvironment.packageName !== "fern-api" || cliEnvironment.packageVersion === "0.0.0") {
     return cliEnvironment.packageVersion;
   }
-  return latestVersion(cliEnvironment.packageName, {
-    version: includePreReleases ? "prerelease" : "latest"
-  });
+  try {
+    return await latestVersion(cliEnvironment.packageName, {
+      version: includePreReleases ? "prerelease" : "latest"
+    });
+  } catch (error50) {
+    throw new CliError({
+      message: `Failed to resolve latest CLI version: ${error50 instanceof Error ? error50.message : String(error50)}`,
+      code: CliError.Code.NetworkError
+    });
+  }
 }
 
 // src/cli-context/CliContext.ts
@@ -929193,7 +929215,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "4.68.4";
+    return "4.68.5-8-g6594a748f1f";
   }
   getCliName() {
     if (false) {
@@ -929474,7 +929496,15 @@ var CliContext = class _CliContext {
    * @returns Promise<string> representing the user's input
    */
   async getInput(config5) {
-    return await esm_default10({ message: config5.message, default: config5.default });
+    try {
+      return await esm_default10({ message: config5.message, default: config5.default });
+    } catch (error50) {
+      if (error50?.name === "ExitPromptError") {
+        this.logger.info("\nCancelled by user.");
+        throw new TaskAbortSignal();
+      }
+      throw error50;
+    }
   }
 };
 function wrapWorkspaceNameForPrefix(workspaceName) {
@@ -929689,7 +929719,9 @@ async function getGeneratorList({
   try {
     await (0, import_promises126.writeFile)(outputLocation, generatorsListYaml);
   } catch (error50) {
-    cliContext.failAndThrow(`Could not write file to the specified location: ${outputLocation}`, error50);
+    cliContext.failAndThrow(`Could not write file to the specified location: ${outputLocation}`, error50, {
+      code: CliError.Code.ConfigError
+    });
   }
 }
 function isGeneratorInModeSet(generator, modes) {
@@ -929767,7 +929799,9 @@ async function getOrganization({
   try {
     await (0, import_promises127.writeFile)(outputLocation, org);
   } catch (error50) {
-    context3.failAndThrow(`Could not write file to the specified location: ${outputLocation}`, error50);
+    context3.failAndThrow(`Could not write file to the specified location: ${outputLocation}`, error50, {
+      code: CliError.Code.ConfigError
+    });
   }
 }
 
@@ -929895,7 +929929,10 @@ async function ensureMigrationsInstalled(logger4) {
       const packageJsonContent = await (0, import_promises128.readFile)(packageJsonPath, "utf-8");
       const packageJson2 = JSON.parse(packageJsonContent);
       if (packageJson2.main == null) {
-        throw new Error(`No main field found in package.json for ${MIGRATION_PACKAGE_NAME2}`);
+        throw new CliError({
+          message: `No main field found in package.json for ${MIGRATION_PACKAGE_NAME2}`,
+          code: CliError.Code.InternalError
+        });
       }
       const packageEntryPoint = (0, import_path78.join)(packageDir, packageJson2.main);
       const { migrations } = await import((0, import_url9.pathToFileURL)(packageEntryPoint).href);
@@ -929968,9 +930005,10 @@ function filterMigrations(params2) {
     const aVersion = import_semver16.default.parse(a10.version);
     const bVersion = import_semver16.default.parse(b19.version);
     if (aVersion == null || bVersion == null) {
-      throw new Error(
-        `Internal error: Invalid migration version found during sort. Version A: ${a10.version}, Version B: ${b19.version}. This should not happen as invalid versions are filtered out.`
-      );
+      throw new CliError({
+        message: `Internal error: Invalid migration version found during sort. Version A: ${a10.version}, Version B: ${b19.version}. This should not happen as invalid versions are filtered out.`,
+        code: CliError.Code.InternalError
+      });
     }
     return import_semver16.default.compare(aVersion, bVersion);
   });
@@ -929988,15 +930026,16 @@ function runMigrations(params2) {
       appliedVersions.push(migration23.version);
     } catch (error50) {
       const errorMessage = extractErrorMessage(error50);
-      throw new Error(
-        `Failed to apply migration for version ${migration23.version}.
+      throw new CliError({
+        message: `Failed to apply migration for version ${migration23.version}.
 
 Reason: ${errorMessage}
 
 This migration was attempting to update your generator configuration. The upgrade has been halted to prevent partial or invalid changes.
 
-Please report this issue at: https://github.com/fern-api/fern/issues`
-      );
+Please report this issue at: https://github.com/fern-api/fern/issues`,
+        code: CliError.Code.InternalError
+      });
     }
   }
   return {
@@ -930016,13 +930055,14 @@ function isValidGeneratorConfig(config5) {
 async function loadAndRunMigrations(params2) {
   const { generatorName, from: from4, to: to8, config: config5, logger: logger4 } = params2;
   if (!isValidGeneratorConfig(config5)) {
-    throw new Error(
-      `Invalid generator configuration for ${generatorName}.
+    throw new CliError({
+      message: `Invalid generator configuration for ${generatorName}.
 
 The generator configuration must be an object with either a 'name' property or an 'image' property, but the current configuration does not match this structure. This may indicate a malformed generators.yml file.
 
-Please check your generators.yml file and ensure the generator is properly configured.`
-    );
+Please check your generators.yml file and ensure the generator is properly configured.`,
+      code: CliError.Code.InternalError
+    });
   }
   const typedConfig = config5;
   const migrationModule = await loadMigrationModule({ generatorName, logger: logger4 });
@@ -930087,7 +930127,9 @@ async function loadAndUpdateGenerators({
     };
   }
   if (!import_yaml6.default.isMap(generatorGroups)) {
-    context3.failAndThrow(`Expected 'groups' to be a map in ${import_path79.default.relative(process.cwd(), filepath)}`);
+    context3.failAndThrow(`Expected 'groups' to be a map in ${import_path79.default.relative(process.cwd(), filepath)}`, void 0, {
+      code: CliError.Code.ParseError
+    });
     return {
       updatedConfiguration: void 0,
       skippedMajorUpgrades: [],
@@ -930106,7 +930148,9 @@ async function loadAndUpdateGenerators({
     const group = groupBlock.value;
     if (!import_yaml6.default.isMap(group)) {
       context3.failAndThrow(
-        `Expected group ${groupName} to be a map in ${import_path79.default.relative(process.cwd(), filepath)}`
+        `Expected group ${groupName} to be a map in ${import_path79.default.relative(process.cwd(), filepath)}`,
+        void 0,
+        { code: CliError.Code.ConfigError }
       );
       continue;
     }
@@ -930117,7 +930161,9 @@ async function loadAndUpdateGenerators({
     const generators = group.get("generators");
     if (!import_yaml6.default.isSeq(generators)) {
       context3.failAndThrow(
-        `Expected group ${groupName} to have a 'generators' key in ${import_path79.default.relative(process.cwd(), filepath)}`
+        `Expected group ${groupName} to have a 'generators' key in ${import_path79.default.relative(process.cwd(), filepath)}`,
+        void 0,
+        { code: CliError.Code.ConfigError }
       );
       continue;
     }
@@ -930125,7 +930171,9 @@ async function loadAndUpdateGenerators({
     for (const generator of generators.items) {
       if (!import_yaml6.default.isMap(generator)) {
         context3.failAndThrow(
-          `Expected generator in group ${groupName} to be a map in ${import_path79.default.relative(process.cwd(), filepath)}`
+          `Expected generator in group ${groupName} to be a map in ${import_path79.default.relative(process.cwd(), filepath)}`,
+          void 0,
+          { code: CliError.Code.VersionError }
         );
       }
       if (generator.get("image") != null) {
@@ -930659,7 +930707,9 @@ function addGeneratorCommands(cli, cliContext) {
         if (generator == null) {
           const maybeApiFilter = argv.api ? ` for API ${argv.api}` : "";
           cliContext.failAndThrow(
-            `Generator ${argv.generator}, in group ${argv.group}${maybeApiFilter} was not found.`
+            `Generator ${argv.generator}, in group ${argv.group}${maybeApiFilter} was not found.`,
+            void 0,
+            { code: CliError.Code.ConfigError }
           );
         }
         const generatorMetadata = {};
@@ -930703,7 +930753,8 @@ function addGeneratorCommands(cli, cliContext) {
           } catch (error50) {
             cliContext.failAndThrow(
               `Could not write file to the specified location: ${argv.output}`,
-              error50
+              error50,
+              { code: CliError.Code.ConfigError }
             );
           }
         }
@@ -930780,7 +930831,9 @@ async function diff({
   const bump = bumpOrUndefined ?? "patch";
   const nextVersion = import_semver18.default.inc(fromVersion, bump);
   if (!nextVersion) {
-    context3.failWithoutThrowing(`Invalid current version: ${fromVersion}`);
+    context3.failWithoutThrowing(`Invalid current version: ${fromVersion}`, void 0, {
+      code: CliError.Code.VersionError
+    });
     throw new TaskAbortSignal();
   }
   return { bump, nextVersion, errors: errors4 };
@@ -930792,13 +930845,27 @@ async function readIr({
 }) {
   const absoluteFilepath = AbsoluteFilePath2.of(resolve6(cwd(), filepath));
   if (!await doesPathExist(absoluteFilepath, "file")) {
-    context3.failWithoutThrowing(`File not found: ${absoluteFilepath}`);
+    context3.failWithoutThrowing(`File not found: ${absoluteFilepath}`, void 0, {
+      code: CliError.Code.ConfigError
+    });
+    throw new TaskAbortSignal();
+  }
+  let ir15;
+  try {
+    ir15 = await streamObjectFromFile(absoluteFilepath);
+  } catch (error50) {
+    context3.failWithoutThrowing(
+      `Failed to parse IR file ${absoluteFilepath}: ${error50 instanceof Error ? error50.message : String(error50)}`,
+      error50,
+      { code: CliError.Code.ParseError }
+    );
     throw new TaskAbortSignal();
   }
-  const ir15 = await streamObjectFromFile(absoluteFilepath);
   const parsed = serialization_exports2.IntermediateRepresentation.parse(ir15);
   if (!parsed.ok) {
-    context3.failWithoutThrowing(`Invalid --${flagName}; expected a filepath containing a valid IR`);
+    context3.failWithoutThrowing(`Invalid --${flagName}; expected a filepath containing a valid IR`, void 0, {
+      code: CliError.Code.ParseError
+    });
     throw new TaskAbortSignal();
   }
   return parsed.value;
@@ -930864,7 +930931,9 @@ function diffGeneratorVersions(context3, generatorVersions) {
       errors: errors4
     };
   } catch (error50) {
-    context3.failWithoutThrowing(`Error diffing generator versions ${from4} and ${to8}: ${error50}`);
+    context3.failWithoutThrowing(`Error diffing generator versions ${from4} and ${to8}: ${error50}`, void 0, {
+      code: CliError.Code.InternalError
+    });
     throw new TaskAbortSignal();
   }
 }
@@ -930894,7 +930963,7 @@ async function collectDocsWorkspaceViolations({
 }) {
   if (workspace.config.settings?.substituteEnvVars) {
     workspace.config = replaceEnvVariables(workspace.config, {
-      onError: (e6) => context3.failAndThrow(e6)
+      onError: (e6) => context3.failAndThrow(e6, void 0, { code: CliError.Code.ValidationError })
     });
   }
   const startTime = performance.now();
@@ -930929,7 +930998,7 @@ async function validateDocsWorkspaceWithoutExiting({
 }) {
   if (workspace.config.settings?.substituteEnvVars) {
     workspace.config = replaceEnvVariables(workspace.config, {
-      onError: (e6) => context3.failAndThrow(e6)
+      onError: (e6) => context3.failAndThrow(e6, void 0, { code: CliError.Code.ValidationError })
     });
   }
   const startTime = performance.now();
@@ -930974,7 +931043,7 @@ async function validateDocsWorkspaceAndLogIssues({
     excludeRules
   });
   if (hasErrors) {
-    context3.failAndThrow();
+    context3.failAndThrow(void 0, void 0, { code: CliError.Code.ValidationError });
   }
 }
 
@@ -931108,7 +931177,10 @@ async function getSlugForFiles({
   });
   if (!response.ok) {
     const errorText = await response.text();
-    throw new Error(`Failed to get slugs for files: ${response.status} ${response.statusText} - ${errorText}`);
+    throw new CliError({
+      message: `Failed to get slugs for files: ${response.status} ${response.statusText} - ${errorText}`,
+      code: CliError.Code.InternalError
+    });
   }
   return await response.json();
 }
@@ -931357,11 +931429,11 @@ async function generateComparisons({
 }
 function getProductionUrlInfo(docsConfig) {
   if (docsConfig.instances == null || docsConfig.instances.length === 0) {
-    throw new Error("No docs instances configured in docs.yml");
+    throw new CliError({ message: "No docs instances configured in docs.yml", code: CliError.Code.InternalError });
   }
   const firstInstance = docsConfig.instances[0];
   if (firstInstance == null) {
-    throw new Error("No docs instances configured in docs.yml");
+    throw new CliError({ message: "No docs instances configured in docs.yml", code: CliError.Code.InternalError });
   }
   const instanceUrl = firstInstance["custom-domain"] ?? firstInstance.url;
   let normalizedUrl = instanceUrl;
@@ -931386,14 +931458,18 @@ async function docsDiff({
 }) {
   const docsWorkspace = project.docsWorkspaces;
   if (docsWorkspace == null) {
-    cliContext.failAndThrow("No docs workspace found. Make sure you have a docs.yml file.");
+    cliContext.failAndThrow("No docs workspace found. Make sure you have a docs.yml file.", void 0, {
+      code: CliError.Code.ConfigError
+    });
     return { diffs: [] };
   }
   const token = await cliContext.runTask(async (context3) => {
     return askToLogin(context3);
   });
   if (token == null) {
-    cliContext.failAndThrow("Failed to authenticate. Please run 'fern login' first.");
+    cliContext.failAndThrow("Failed to authenticate. Please run 'fern login' first.", void 0, {
+      code: CliError.Code.AuthError
+    });
     return { diffs: [] };
   }
   const fernToken = process.env.FERN_TOKEN ?? token.value;
@@ -935838,7 +935914,7 @@ function createLibraryDocsClient({ token }) {
     });
     if (!response.ok) {
       const text9 = await response.text().catch(() => "");
-      throw new Error(`HTTP ${response.status}: ${text9}`);
+      throw new CliError({ message: `HTTP ${response.status}: ${text9}`, code: CliError.Code.NetworkError });
     }
     return await response.json();
   }
@@ -935862,21 +935938,27 @@ var POLL_TIMEOUT_MS = 3 * 60 * 1e3;
 async function generateLibraryDocs({ project, cliContext, library }) {
   const docsWorkspace = project.docsWorkspaces;
   if (docsWorkspace == null) {
-    cliContext.failAndThrow("No docs workspace found. Make sure you have a docs.yml file.");
+    cliContext.failAndThrow("No docs workspace found. Make sure you have a docs.yml file.", void 0, {
+      code: CliError.Code.ConfigError
+    });
     return;
   }
   const rawConfig = docsWorkspace.config;
   const libraries = rawConfig.libraries;
   if (libraries == null || Object.keys(libraries).length === 0) {
     cliContext.failAndThrow(
-      "No libraries configured in docs.yml. Add a `libraries` section to configure library documentation."
+      "No libraries configured in docs.yml. Add a `libraries` section to configure library documentation.",
+      void 0,
+      { code: CliError.Code.ConfigError }
     );
     return;
   }
   const librariesToGenerate = library != null ? { [library]: libraries[library] } : libraries;
   if (library != null && libraries[library] == null) {
     cliContext.failAndThrow(
-      `Library '${library}' not found in docs.yml. Available libraries: ${Object.keys(libraries).join(", ")}`
+      `Library '${library}' not found in docs.yml. Available libraries: ${Object.keys(libraries).join(", ")}`,
+      void 0,
+      { code: CliError.Code.ConfigError }
     );
     return;
   }
@@ -935884,7 +935966,9 @@ async function generateLibraryDocs({ project, cliContext, library }) {
     return askToLogin(context3);
   });
   if (token == null) {
-    cliContext.failAndThrow("Failed to authenticate. Please run 'fern login' first.");
+    cliContext.failAndThrow("Failed to authenticate. Please run 'fern login' first.", void 0, {
+      code: CliError.Code.AuthError
+    });
     return;
   }
   const orgId = project.config.organization;
@@ -935896,7 +935980,9 @@ async function generateLibraryDocs({ project, cliContext, library }) {
         }
         if (!isGitLibraryInput2(config5.input)) {
           context3.failAndThrow(
-            `Library '${name2}' uses 'path' input which is not yet supported. Please use 'git' input.`
+            `Library '${name2}' uses 'path' input which is not yet supported. Please use 'git' input.`,
+            void 0,
+            { code: CliError.Code.ConfigError }
           );
           return false;
         }
@@ -935929,7 +936015,9 @@ async function generateSingleLibrary({
   return context3.runInteractiveTask({ name: name2 }, async (interactiveTaskContext) => {
     if (config5.config?.doxyfile != null && config5.lang !== "cpp") {
       return interactiveTaskContext.failAndThrow(
-        `Library '${name2}': 'doxyfile' config is only valid for lang: cpp`
+        `Library '${name2}': 'doxyfile' config is only valid for lang: cpp`,
+        void 0,
+        { code: CliError.Code.ConfigError }
       );
     }
     let doxyfileContent;
@@ -935939,13 +936027,19 @@ async function generateSingleLibrary({
         doxyfileContent = await (0, import_promises133.readFile)(doxyfilePath, "utf-8");
       } catch {
         return interactiveTaskContext.failAndThrow(
-          `Library '${name2}': Could not read Doxyfile at '${config5.config.doxyfile}' (resolved to ${doxyfilePath})`
+          `Library '${name2}': Could not read Doxyfile at '${config5.config.doxyfile}' (resolved to ${doxyfilePath})`,
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       }
     }
     const language = config5.lang === "python" ? "PYTHON" : config5.lang === "cpp" ? "CPP" : void 0;
     if (language == null) {
-      return interactiveTaskContext.failAndThrow(`Library '${name2}': unsupported language '${config5.lang}'`);
+      return interactiveTaskContext.failAndThrow(
+        `Library '${name2}': unsupported language '${config5.lang}'`,
+        void 0,
+        { code: CliError.Code.ConfigError }
+      );
     }
     const client3 = createLibraryDocsClient({ token: token.value });
     interactiveTaskContext.logger.debug(`Starting generation for library '${name2}' from ${gitInput.git}`);
@@ -935985,7 +936079,11 @@ To include in your docs navigation, add to docs.yml:
       });
       interactiveTaskContext.logger.debug(`Generated ${generateResult.pageCount} pages at ${resolvedOutputPath}`);
     } else {
-      return interactiveTaskContext.failAndThrow(`Library '${name2}': unsupported language '${config5.lang}'`);
+      return interactiveTaskContext.failAndThrow(
+        `Library '${name2}': unsupported language '${config5.lang}'`,
+        void 0,
+        { code: CliError.Code.ConfigError }
+      );
     }
   });
 }
@@ -936007,7 +936105,9 @@ async function startGeneration(client3, context3, opts) {
     return result.jobId;
   } catch (error50) {
     return context3.failAndThrow(
-      `Failed to start generation for library '${opts.name}': ${extractErrorMessage(error50)}`
+      `Failed to start generation for library '${opts.name}': ${extractErrorMessage(error50)}`,
+      error50,
+      { code: CliError.Code.NetworkError }
     );
   }
 }
@@ -936020,7 +936120,9 @@ async function pollForCompletion(client3, jobId, libraryName, context3) {
       status = await client3.getLibraryDocsGenerationStatus({ jobId });
     } catch (error50) {
       return context3.failAndThrow(
-        `Failed to check generation status for library '${libraryName}': ${extractErrorMessage(error50)}`
+        `Failed to check generation status for library '${libraryName}': ${extractErrorMessage(error50)}`,
+        error50,
+        { code: CliError.Code.NetworkError }
       );
     }
     switch (status.status) {
@@ -936035,15 +936137,23 @@ async function pollForCompletion(client3, jobId, libraryName, context3) {
         return;
       case "FAILED":
         return context3.failAndThrow(
-          `Generation failed for library '${libraryName}': ${status.error?.message ?? "Unknown error"} (${status.error?.code ?? "UNKNOWN"})`
+          `Generation failed for library '${libraryName}': ${status.error?.message ?? "Unknown error"} (${status.error?.code ?? "UNKNOWN"})`,
+          void 0,
+          { code: CliError.Code.InternalError }
         );
       default:
         return context3.failAndThrow(
-          `Unexpected generation status for library '${libraryName}': ${status.status}`
+          `Unexpected generation status for library '${libraryName}': ${status.status}`,
+          void 0,
+          { code: CliError.Code.InternalError }
         );
     }
   }
-  return context3.failAndThrow(`Generation timed out for library '${libraryName}' after ${POLL_TIMEOUT_MS / 1e3}s`);
+  return context3.failAndThrow(
+    `Generation timed out for library '${libraryName}' after ${POLL_TIMEOUT_MS / 1e3}s`,
+    void 0,
+    { code: CliError.Code.NetworkError }
+  );
 }
 async function downloadIr(client3, jobId, libraryName, language, context3) {
   let resultUrl;
@@ -936052,29 +936162,39 @@ async function downloadIr(client3, jobId, libraryName, language, context3) {
     resultUrl = result.resultUrl;
   } catch (error50) {
     return context3.failAndThrow(
-      `Failed to fetch generation result for library '${libraryName}': ${extractErrorMessage(error50)}`
+      `Failed to fetch generation result for library '${libraryName}': ${extractErrorMessage(error50)}`,
+      error50,
+      { code: CliError.Code.NetworkError }
     );
   }
   context3.logger.debug(`Fetching IR from ${resultUrl}`);
   const irFetchResponse = await fetch(resultUrl);
   if (!irFetchResponse.ok) {
     return context3.failAndThrow(
-      `Failed to download IR for library '${libraryName}': HTTP ${irFetchResponse.status}`
+      `Failed to download IR for library '${libraryName}': HTTP ${irFetchResponse.status}`,
+      void 0,
+      { code: CliError.Code.NetworkError }
     );
   }
   const irWrapper = await irFetchResponse.json();
   const ir15 = irWrapper.ir;
   if (ir15 == null) {
-    return context3.failAndThrow(`IR is empty for library '${libraryName}'`);
+    return context3.failAndThrow(`IR is empty for library '${libraryName}'`, void 0, {
+      code: CliError.Code.InternalError
+    });
   }
   if (language === "CPP") {
     if (ir15.rootNamespace == null) {
-      return context3.failAndThrow(`IR has no rootNamespace for C++ library '${libraryName}'`);
+      return context3.failAndThrow(`IR has no rootNamespace for C++ library '${libraryName}'`, void 0, {
+        code: CliError.Code.InternalError
+      });
     }
     context3.logger.debug(`Downloaded C++ IR for '${libraryName}'`);
   } else {
     if (ir15.rootModule == null) {
-      return context3.failAndThrow(`IR has no rootModule for library '${libraryName}'`);
+      return context3.failAndThrow(`IR has no rootModule for library '${libraryName}'`, void 0, {
+        code: CliError.Code.InternalError
+      });
     }
     context3.logger.debug(`Downloaded IR with ${Object.keys(ir15.rootModule).length} top-level keys`);
   }
@@ -936105,7 +936225,9 @@ async function deleteDocsPreview({
       `Invalid preview URL: ${previewUrl}
 Only preview sites can be deleted with this command.
 Preview URLs follow the pattern: {org}-preview-{hash}.docs.buildwithfern.com
-Example: acme-preview-abc123.docs.buildwithfern.com`
+Example: acme-preview-abc123.docs.buildwithfern.com`,
+      void 0,
+      { code: CliError.Code.ConfigError }
     );
     return;
   }
@@ -936113,7 +936235,9 @@ Example: acme-preview-abc123.docs.buildwithfern.com`
     return askToLogin(context3);
   });
   if (token == null) {
-    cliContext.failAndThrow("Failed to authenticate. Please run 'fern login' first.");
+    cliContext.failAndThrow("Failed to authenticate. Please run 'fern login' first.", void 0, {
+      code: CliError.Code.AuthError
+    });
     return;
   }
   await cliContext.runTask(async (context3) => {
@@ -936128,12 +936252,18 @@ Example: acme-preview-abc123.docs.buildwithfern.com`
       switch (deleteResponse.error.error) {
         case "UnauthorizedError":
           return context3.failAndThrow(
-            "You do not have permissions to delete this preview site. Reach out to support@buildwithfern.com"
+            "You do not have permissions to delete this preview site. Reach out to support@buildwithfern.com",
+            void 0,
+            { code: CliError.Code.NetworkError }
           );
         case "DocsNotFoundError":
-          return context3.failAndThrow(`Preview site not found: ${previewUrl}`);
+          return context3.failAndThrow(`Preview site not found: ${previewUrl}`, void 0, {
+            code: CliError.Code.ConfigError
+          });
         default:
-          return context3.failAndThrow(`Failed to delete preview site: ${previewUrl}`, deleteResponse.error);
+          return context3.failAndThrow(`Failed to delete preview site: ${previewUrl}`, deleteResponse.error, {
+            code: CliError.Code.NetworkError
+          });
       }
     }
   });
@@ -936149,7 +936279,9 @@ async function listDocsPreview({
     return askToLogin(context3);
   });
   if (token == null) {
-    cliContext.failAndThrow("Failed to authenticate. Please run 'fern login' first.");
+    cliContext.failAndThrow("Failed to authenticate. Please run 'fern login' first.", void 0, {
+      code: CliError.Code.AuthError
+    });
     return;
   }
   await cliContext.runTask(async (context3) => {
@@ -936164,14 +936296,17 @@ async function listDocsPreview({
       switch (listResponse.error.error) {
         case "UnauthorizedError":
           return context3.failAndThrow(
-            "Unauthorized to list preview deployments. Please run 'fern login' to refresh your credentials, or set the FERN_TOKEN environment variable."
+            "Unauthorized to list preview deployments. Please run 'fern login' to refresh your credentials, or set the FERN_TOKEN environment variable.",
+            void 0,
+            { code: CliError.Code.NetworkError }
           );
         default: {
           const errorContent = listResponse.error.content != null && typeof listResponse.error.content === "object" && "body" in listResponse.error.content ? listResponse.error.content.body : listResponse.error.content;
           context3.logger.debug(`Error fetching preview deployments: ${JSON.stringify(errorContent)}`);
           return context3.failAndThrow(
             "Failed to fetch preview deployments. Please ensure you are logged in with 'fern login' or have FERN_TOKEN set, then try again.",
-            listResponse.error
+            listResponse.error,
+            { code: CliError.Code.NetworkError }
           );
         }
       }
@@ -936935,11 +937070,15 @@ async function downgrade({
   targetVersion
 }) {
   if (!targetVersion) {
-    return cliContext.failAndThrow("Please specify a version to downgrade to using --version");
+    return cliContext.failAndThrow("Please specify a version to downgrade to using --version", void 0, {
+      code: CliError.Code.ConfigError
+    });
   }
   const fernDirectory = await getFernDirectory();
   if (fernDirectory == null) {
-    return cliContext.failAndThrow(`Directory "${FERN_DIRECTORY}" not found.`);
+    return cliContext.failAndThrow(`Directory "${FERN_DIRECTORY}" not found.`, void 0, {
+      code: CliError.Code.ConfigError
+    });
   }
   const projectConfig = await cliContext.runTask(
     (context3) => loadProjectConfig({ directory: fernDirectory, context: context3 })
@@ -937017,7 +937156,10 @@ function convertType4(typeDeclaration2, ir15) {
       return convertUndiscriminatedUnion2({ undiscriminatedUnionDeclaration, docs });
     },
     _other: () => {
-      throw new Error("Encountered unknown type: " + shape.type);
+      throw new CliError({
+        message: "Encountered unknown type: " + shape.type,
+        code: CliError.Code.InternalError
+      });
     }
   });
   return {
@@ -937086,7 +937228,10 @@ function convertUnion({
         required: [getWireValue(unionTypeDeclaration.discriminant)]
       }),
       _other: () => {
-        throw new Error("Unknown SingleUnionTypeProperties: " + singleUnionType.shape.propertiesType);
+        throw new CliError({
+          message: "Unknown SingleUnionTypeProperties: " + singleUnionType.shape.propertiesType,
+          code: CliError.Code.InternalError
+        });
       }
     });
   });
@@ -937137,7 +937282,10 @@ function convertTypeReference4(typeReference2) {
       return {};
     },
     _other: () => {
-      throw new Error("Encountered unknown typeReference: " + typeReference2.type);
+      throw new CliError({
+        message: "Encountered unknown typeReference: " + typeReference2.type,
+        code: CliError.Code.InternalError
+      });
     }
   });
 }
@@ -937222,7 +937370,10 @@ function convertPrimitiveType3(primitiveType2) {
         };
       },
       _other: () => {
-        throw new Error("Encountered unknown primitiveType: " + primitiveType2.v1);
+        throw new CliError({
+          message: "Encountered unknown primitiveType: " + primitiveType2.v1,
+          code: CliError.Code.InternalError
+        });
       }
     }) ?? {};
   }
@@ -937312,7 +937463,10 @@ function convertPrimitiveType3(primitiveType2) {
       };
     },
     _other: () => {
-      throw new Error("Encountered unknown primitiveType: " + primitiveType2.v2);
+      throw new CliError({
+        message: "Encountered unknown primitiveType: " + primitiveType2.v2,
+        code: CliError.Code.InternalError
+      });
     }
   });
 }
@@ -937372,7 +937526,10 @@ function convertContainerType3(containerType) {
       });
     },
     _other: () => {
-      throw new Error("Encountered unknown containerType: " + containerType.type);
+      throw new CliError({
+        message: "Encountered unknown containerType: " + containerType.type,
+        code: CliError.Code.InternalError
+      });
     }
   });
 }
@@ -937491,7 +937648,10 @@ function convertServices2({
       });
       const pathsObject = paths[fullPath] ??= {};
       if (pathsObject[convertedHttpMethod] != null) {
-        throw new Error(`Duplicate ${convertedHttpMethod} endpoint at ${fullPath}`);
+        throw new CliError({
+          message: `Duplicate ${convertedHttpMethod} endpoint at ${fullPath}`,
+          code: CliError.Code.ConfigError
+        });
       }
       pathsObject[convertedHttpMethod] = operationObject;
     });
@@ -937576,12 +937736,15 @@ function convertHttpEndpoint4({
   if (httpEndpoint.baseUrl != null) {
     const baseUrlId = httpEndpoint.baseUrl;
     if (environments2?.environments.type !== "multipleBaseUrls") {
-      throw new Error("baseUrl is defined environments are not multipleBaseUrls");
+      throw new CliError({
+        message: "baseUrl is defined environments are not multipleBaseUrls",
+        code: CliError.Code.InternalError
+      });
     }
     operationObject.servers = environments2.environments.environments.map((environment2) => {
       const url3 = environment2.urls[baseUrlId];
       if (url3 == null) {
-        throw new Error("No URL defined for " + baseUrlId);
+        throw new CliError({ message: "No URL defined for " + baseUrlId, code: CliError.Code.InternalError });
       }
       const server = { url: url3 };
       if (environment2.docs != null) {
@@ -937627,7 +937790,10 @@ function convertHttpMethod3(httpMethod) {
       return import_openapi_types3.OpenAPIV3.HttpMethods.HEAD;
     },
     _other: () => {
-      throw new Error("Encountered unknown http method: " + httpMethod);
+      throw new CliError({
+        message: "Encountered unknown http method: " + httpMethod,
+        code: CliError.Code.InternalError
+      });
     }
   });
 }
@@ -937719,7 +937885,10 @@ function convertRequestBody4({
                     };
                   },
                   _other: () => {
-                    throw new Error("Unknown FileUploadRequestProperty: " + property23.type);
+                    throw new CliError({
+                      message: "Unknown FileUploadRequestProperty: " + property23.type,
+                      code: CliError.Code.InternalError
+                    });
                   }
                 });
                 return {
@@ -937747,7 +937916,10 @@ function convertRequestBody4({
       };
     },
     _other: () => {
-      throw new Error("Unknown HttpRequestBody type: " + httpRequest2.type);
+      throw new CliError({
+        message: "Unknown HttpRequestBody type: " + httpRequest2.type,
+        code: CliError.Code.InternalError
+      });
     }
   });
 }
@@ -937847,9 +938019,10 @@ function convertResponse3({
       for (const responseError of responseErrors) {
         const errorDeclaration = errorsByName[getErrorTypeNameKey(responseError.error)];
         if (errorDeclaration == null) {
-          throw new Error(
-            "Encountered undefined error declaration: " + getOriginalName(responseError.error.name)
-          );
+          throw new CliError({
+            message: "Encountered undefined error declaration: " + getOriginalName(responseError.error.name),
+            code: CliError.Code.ResolutionError
+          });
         }
         const responseForStatusCode = {
           description: responseError.docs ?? ""
@@ -937931,7 +938104,10 @@ function convertResponse3({
       }
     },
     _other: () => {
-      throw new Error("Unknown error discrimination strategy: " + errorDiscriminationStrategy.type);
+      throw new CliError({
+        message: "Unknown error discrimination strategy: " + errorDiscriminationStrategy.type,
+        code: CliError.Code.InternalError
+      });
     }
   });
   return responseByStatusCode;
@@ -937965,7 +938141,10 @@ function getErrorInfoByStatusCode({
   for (const responseError of responseErrors) {
     const errorDeclaration = errorsByName[getErrorTypeNameKey(responseError.error)];
     if (errorDeclaration == null) {
-      throw new Error("Encountered undefined error declaration: " + getOriginalName(responseError.error.name));
+      throw new CliError({
+        message: "Encountered undefined error declaration: " + getOriginalName(responseError.error.name),
+        code: CliError.Code.ResolutionError
+      });
     }
     const statusCode = errorDeclaration.statusCode;
     const statusCodeErrorInfo = errorInfoByStatusCode[statusCode];
@@ -938106,7 +938285,10 @@ function isTypeReferenceRequired({
     const key2 = getDeclaredTypeNameKey(typeReference2);
     const typeDeclaration2 = typesByName[key2];
     if (typeDeclaration2 == null) {
-      throw new Error("Encountered non-existent type: " + getOriginalName(typeReference2.name));
+      throw new CliError({
+        message: "Encountered non-existent type: " + getOriginalName(typeReference2.name),
+        code: CliError.Code.ResolutionError
+      });
     }
     if (typeDeclaration2.shape.type === "alias") {
       return isTypeReferenceRequired({ typeReference: typeDeclaration2.shape.aliasOf, typesByName });
@@ -938136,7 +938318,10 @@ function constructEndpointSecurity(apiAuth) {
       return [];
     },
     _other: () => {
-      throw new Error("Unknown auth scheme requirement: " + apiAuth.requirement);
+      throw new CliError({
+        message: "Unknown auth scheme requirement: " + apiAuth.requirement,
+        code: CliError.Code.InternalError
+      });
     }
   });
 }
@@ -938163,7 +938348,10 @@ function constructSecuritySchemes(apiAuth) {
       }),
       inferred: () => void 0,
       _other: () => {
-        throw new Error("Unknown auth scheme: " + scheme.type);
+        throw new CliError({
+          message: "Unknown auth scheme: " + scheme.type,
+          code: CliError.Code.InternalError
+        });
       }
     });
     if (oasScheme) {
@@ -938180,7 +938368,10 @@ function getNameForAuthScheme(authScheme) {
     oauth: () => "BearerAuth",
     header: (header) => `${getPascalCaseUnsafe(header.name)}Auth`,
     _other: () => {
-      throw new Error("Unknown auth scheme: " + authScheme.type);
+      throw new CliError({
+        message: "Unknown auth scheme: " + authScheme.type,
+        code: CliError.Code.InternalError
+      });
     }
   });
 }
@@ -938499,7 +938690,7 @@ async function generateWorkspace({
       const suggestedCommand = `fern ${currentArgs} --${GROUP_CLI_OPTION} ${name2}`;
       return ` \u203A ${source_default.bold(name2.padEnd(longestGroupName))}  ${source_default.dim(suggestedCommand)}`;
     }).join("\n");
-    return context3.failAndThrow(message);
+    return context3.failAndThrow(message, void 0, { code: CliError.Code.NetworkError });
   }
   const resolvedGroupNames = resolveGroupAlias(
     groupNameOrDefault,
@@ -938509,7 +938700,7 @@ async function generateWorkspace({
   );
   const { ai: ai7, replay } = workspace.generatorsConfiguration;
   if (!useLocalDocker && !token) {
-    return context3.failAndThrow("Please run fern login");
+    return context3.failAndThrow("Please run fern login", void 0, { code: CliError.Code.AuthError });
   }
   await Promise.all(
     resolvedGroupNames.map(async (resolvedGroupName) => {
@@ -938517,7 +938708,9 @@ async function generateWorkspace({
         (otherGroup) => otherGroup.groupName === resolvedGroupName
       );
       if (group == null) {
-        return context3.failAndThrow(`Group '${resolvedGroupName}' does not exist.`);
+        return context3.failAndThrow(`Group '${resolvedGroupName}' does not exist.`, void 0, {
+          code: CliError.Code.ConfigError
+        });
       }
       const filterResult = filterGenerators({
         generators: group.generators,
@@ -938526,7 +938719,7 @@ async function generateWorkspace({
         groupName: resolvedGroupName
       });
       if (!filterResult.ok) {
-        return context3.failAndThrow(filterResult.error);
+        return context3.failAndThrow(filterResult.error, void 0, { code: CliError.Code.ConfigError });
       }
       group = { ...group, generators: filterResult.generators };
       if (lfsOverride != null) {
@@ -938595,7 +938788,9 @@ function resolveGroupAlias(groupNameOrAlias, groupAliases, availableGroups, cont
     for (const groupName of aliasGroups) {
       if (!availableGroups.includes(groupName)) {
         context3.failAndThrow(
-          `Group alias '${groupNameOrAlias}' references non-existent group '${groupName}'. Available groups: ${availableGroups.join(", ")}`
+          `Group alias '${groupNameOrAlias}' references non-existent group '${groupName}'. Available groups: ${availableGroups.join(", ")}`,
+          void 0,
+          { code: CliError.Code.NetworkError }
         );
       }
     }
@@ -938607,7 +938802,9 @@ function resolveGroupAlias(groupNameOrAlias, groupAliases, availableGroups, cont
   const availableAliases = Object.keys(groupAliases);
   const suggestions = [...availableGroups, ...availableAliases];
   context3.failAndThrow(
-    `'${groupNameOrAlias}' is not a valid group or alias. Available groups: ${availableGroups.join(", ")}` + (availableAliases.length > 0 ? `. Available aliases: ${availableAliases.join(", ")}` : "")
+    `'${groupNameOrAlias}' is not a valid group or alias. Available groups: ${availableGroups.join(", ")}` + (availableAliases.length > 0 ? `. Available aliases: ${availableAliases.join(", ")}` : ""),
+    void 0,
+    { code: CliError.Code.NetworkError }
   );
   return [];
 }
@@ -938742,7 +938939,7 @@ async function generateAPIWorkspaces({
           force
         );
         if (!shouldProceed) {
-          cliContext.failAndThrow("Generation cancelled");
+          cliContext.failAndThrow("Generation cancelled", void 0, { code: CliError.Code.ConfigError });
         }
       }
     }
@@ -938921,7 +939118,10 @@ function buildPreviewDomain({ orgId, previewId }) {
   const availableSpace = SUBDOMAIN_LIMIT - prefix2.length;
   const minIdLength = 8;
   if (availableSpace < minIdLength) {
-    throw new Error(`Organization name "${orgId}" is too long to generate a valid preview URL`);
+    throw new CliError({
+      message: `Organization name "${orgId}" is too long to generate a valid preview URL`,
+      code: CliError.Code.InternalError
+    });
   }
   const truncatedId = sanitizedId.slice(0, availableSpace).replace(/-+$/, "");
   return `${prefix2}${truncatedId}.${DOMAIN_SUFFIX}`;
@@ -938941,7 +939141,9 @@ async function generateDocsWorkspace({
 }) {
   const docsWorkspace = project.docsWorkspaces;
   if (docsWorkspace == null) {
-    cliContext.failAndThrow("No docs.yml file found. Please make sure your project has one.");
+    cliContext.failAndThrow("No docs.yml file found. Please make sure your project has one.", void 0, {
+      code: CliError.Code.ConfigError
+    });
     return;
   }
   const hasFdrOriginOverride = !!process.env["FERN_FDR_ORIGIN"] || !!process.env["OVERRIDE_FDR_ORIGIN"];
@@ -938963,7 +939165,9 @@ ${source_default.yellow("?")} Are you sure you want to continue?`,
     const fernToken = await getToken2();
     if (!fernToken) {
       cliContext.failAndThrow(
-        "No token found. Please set the FERN_TOKEN environment variable or run `fern login`."
+        "No token found. Please set the FERN_TOKEN environment variable or run `fern login`.",
+        void 0,
+        { code: CliError.Code.AuthError }
       );
       return;
     }
@@ -939021,7 +939225,9 @@ ${source_default.yellow("?")} Are you sure you want to continue?`,
           context3.logger.error(`${error50.relativeFilepath}: ${error50.message}`);
         }
         context3.failAndThrow(
-          `OpenAPI spec validation failed with ${errors4.length} error${errors4.length !== 1 ? "s" : ""}. Fix the errors above before generating docs.`
+          `OpenAPI spec validation failed with ${errors4.length} error${errors4.length !== 1 ? "s" : ""}. Fix the errors above before generating docs.`,
+          void 0,
+          { code: CliError.Code.ValidationError }
         );
       }
     }
@@ -939123,7 +939329,10 @@ async function generateDynamicIrForWorkspaces({
           disableDynamicExamples
         });
         if (intermediateRepresentation.dynamic == null) {
-          throw new Error("Internal error; dynamic IR was not generated");
+          throw new CliError({
+            message: "Internal error; dynamic IR was not generated",
+            code: CliError.Code.InternalError
+          });
         }
         const irOutputFilePath = import_path83.default.resolve(irFilepath);
         await streamObjectToFile(AbsoluteFilePath2.of(irOutputFilePath), intermediateRepresentation.dynamic);
@@ -939334,10 +939543,14 @@ async function compareOpenAPISpecs({
 }) {
   await cliContext.runTask(async (context3) => {
     if (!await doesPathExist(originalPath)) {
-      return context3.failAndThrow(`Original file does not exist: ${originalPath}`);
+      return context3.failAndThrow(`Original file does not exist: ${originalPath}`, void 0, {
+        code: CliError.Code.ConfigError
+      });
     }
     if (!await doesPathExist(modifiedPath)) {
-      return context3.failAndThrow(`Modified file does not exist: ${modifiedPath}`);
+      return context3.failAndThrow(`Modified file does not exist: ${modifiedPath}`, void 0, {
+        code: CliError.Code.ConfigError
+      });
     }
     context3.logger.info(`Comparing ${originalPath} with ${modifiedPath}`);
     const original = await loadSpec2(originalPath, context3);
@@ -939374,7 +939587,9 @@ async function loadSpec2(filepath, context3) {
     try {
       return jsYaml.load(contents);
     } catch (err) {
-      return context3.failAndThrow(`Failed to parse file as JSON or YAML: ${filepath}`);
+      return context3.failAndThrow(`Failed to parse file as JSON or YAML: ${filepath}`, void 0, {
+        code: CliError.Code.ParseError
+      });
     }
   }
 }
@@ -939501,7 +939716,9 @@ async function readExistingOverrides(overridesFilepath, context3) {
       parsedOverrides = jsYaml.load(contents, { json: true });
     }
   } catch (err) {
-    return context3.failAndThrow(`Failed to read OpenAPI overrides from file ${overridesFilepath}`);
+    return context3.failAndThrow(`Failed to read OpenAPI overrides from file ${overridesFilepath}`, void 0, {
+      code: CliError.Code.ConfigError
+    });
   }
   return parsedOverrides;
 }
@@ -939615,7 +939832,9 @@ async function installDependencies({ cliContext }) {
     const failed = results.filter((r23) => !r23.success);
     if (failed.length > 0) {
       context3.failAndThrow(
-        `Failed to install: ${failed.map((r23) => r23.name).join(", ")}. Check network connectivity and try again.`
+        `Failed to install: ${failed.map((r23) => r23.name).join(", ")}. Check network connectivity and try again.`,
+        void 0,
+        { code: CliError.Code.EnvironmentError }
       );
     }
     context3.logger.info("All dependencies installed successfully.");
@@ -940054,10 +940273,14 @@ async function mergeOpenAPIWithOverrides({
 }) {
   await cliContext.runTask(async (context3) => {
     if (!await doesPathExist(openapiPath)) {
-      return context3.failAndThrow(`OpenAPI spec file does not exist: ${openapiPath}`);
+      return context3.failAndThrow(`OpenAPI spec file does not exist: ${openapiPath}`, void 0, {
+        code: CliError.Code.ConfigError
+      });
     }
     if (!await doesPathExist(overridesPath)) {
-      return context3.failAndThrow(`Overrides file does not exist: ${overridesPath}`);
+      return context3.failAndThrow(`Overrides file does not exist: ${overridesPath}`, void 0, {
+        code: CliError.Code.ConfigError
+      });
     }
     context3.logger.info(`Merging ${overridesPath} into ${openapiPath}`);
     const openapi = await loadYamlOrJson(openapiPath, context3);
@@ -940077,7 +940300,9 @@ async function loadYamlOrJson(filepath, context3) {
     try {
       return jsYaml.load(contents);
     } catch (err) {
-      return context3.failAndThrow(`Failed to parse file as JSON or YAML: ${filepath}`);
+      return context3.failAndThrow(`Failed to parse file as JSON or YAML: ${filepath}`, void 0, {
+        code: CliError.Code.ParseError
+      });
     }
   }
 }
@@ -940666,7 +940891,9 @@ async function mockServer({
     command: "fern mock"
   });
   if (project.apiWorkspaces.length !== 1 || project.apiWorkspaces[0] == null) {
-    return cliContext.failAndThrow(`No API specified. Use the --${API_CLI_OPTION} option.`);
+    return cliContext.failAndThrow(`No API specified. Use the --${API_CLI_OPTION} option.`, void 0, {
+      code: CliError.Code.ConfigError
+    });
   }
   const workspace = project.apiWorkspaces[0];
   await cliContext.runTaskForWorkspace(workspace, async (context3) => {
@@ -940724,7 +940951,9 @@ async function registerWorkspacesV1({
     project.apiWorkspaces.map(async (workspace) => {
       await cliContext.runTaskForWorkspace(workspace, async (context3) => {
         if (workspace instanceof OSSWorkspace) {
-          context3.failWithoutThrowing("Registering from OpenAPI not currently supported.");
+          context3.failWithoutThrowing("Registering from OpenAPI not currently supported.", void 0, {
+            code: CliError.Code.ConfigError
+          });
           return;
         }
         const resolvedWorkspace = await workspace.toFernWorkspace({ context: context3 });
@@ -940737,10 +940966,12 @@ async function registerWorkspacesV1({
         if (!registerApiResponse.ok) {
           registerApiResponse.error._visit({
             versionAlreadyExists: () => {
-              context3.failAndThrow(`Version ${version7 ?? ""} is already registered`);
+              context3.failAndThrow(`Version ${version7 ?? ""} is already registered`, void 0, {
+                code: CliError.Code.VersionError
+              });
             },
             _other: (value) => {
-              context3.failAndThrow("Failed to register", value);
+              context3.failAndThrow("Failed to register", value, { code: CliError.Code.NetworkError });
             }
           });
           return;
@@ -940810,7 +941041,7 @@ var execAsync = (0, import_util70.promisify)(import_child_process10.exec);
 async function getClientRegistry(context3, project) {
   const workspace = project.apiWorkspaces[0];
   if (workspace == null) {
-    context3.failAndThrow("No API workspaces found in the project.");
+    context3.failAndThrow("No API workspaces found in the project.", void 0, { code: CliError.Code.ConfigError });
   }
   const generatorsConfig = await loadGeneratorsConfiguration({
     absolutePathToWorkspace: workspace.absoluteFilePath,
@@ -940818,11 +941049,17 @@ async function getClientRegistry(context3, project) {
     context: context3
   });
   if (generatorsConfig == null) {
-    context3.failAndThrow("Could not find generators.yml in the workspace. Is this a valid fern project?");
+    context3.failAndThrow(
+      "Could not find generators.yml in the workspace. Is this a valid fern project?",
+      void 0,
+      { code: CliError.Code.ConfigError }
+    );
   }
   if (generatorsConfig.ai == null) {
     context3.failAndThrow(
-      "No AI service configuration found in generators.yml. Please add an 'ai' section with provider and model."
+      "No AI service configuration found in generators.yml. Please add an 'ai' section with provider and model.",
+      void 0,
+      { code: CliError.Code.ConfigError }
     );
   }
   context3.logger.debug(`Using AI service: ${generatorsConfig.ai.provider} with model ${generatorsConfig.ai.model}`);
@@ -940840,11 +941077,11 @@ async function sdkDiffCommand({
   From: ${fromPath}
   To:   ${toPath5}`);
   if (!await doesPathExist(fromPath, "directory")) {
-    context3.failWithoutThrowing(`Directory not found: ${fromPath}`);
+    context3.failWithoutThrowing(`Directory not found: ${fromPath}`, void 0, { code: CliError.Code.ConfigError });
     throw new TaskAbortSignal();
   }
   if (!await doesPathExist(toPath5, "directory")) {
-    context3.failWithoutThrowing(`Directory not found: ${toPath5}`);
+    context3.failWithoutThrowing(`Directory not found: ${toPath5}`, void 0, { code: CliError.Code.ConfigError });
     throw new TaskAbortSignal();
   }
   const clientRegistry = await getClientRegistry(context3, project);
@@ -940866,7 +941103,9 @@ async function sdkDiffCommand({
   const diffBytes = Buffer.byteLength(gitDiff, "utf-8");
   if (diffBytes > MAX_RAW_DIFF_BYTES) {
     return context3.failAndThrow(
-      `Diff too large for analysis (${(diffBytes / 1e6).toFixed(1)}MB, limit ${MAX_RAW_DIFF_BYTES / 1e6}MB). Try excluding generated files or splitting the comparison.`
+      `Diff too large for analysis (${(diffBytes / 1e6).toFixed(1)}MB, limit ${MAX_RAW_DIFF_BYTES / 1e6}MB). Try excluding generated files or splitting the comparison.`,
+      void 0,
+      { code: CliError.Code.ConfigError }
     );
   }
   const chunks = diffBytes > MAX_AI_DIFF_BYTES ? service.chunkDiff(gitDiff, MAX_AI_DIFF_BYTES) : [gitDiff];
@@ -940931,7 +941170,7 @@ async function sdkDiffCommand({
       const rawEntries = allChangelogEntries.map((e6) => e6.startsWith("- ") ? e6 : `- ${e6}`).join("\n");
       try {
         context3.logger.debug(`Consolidating ${allChangelogEntries.length} changelog entries via AI rollup`);
-        const rollup = await bamlClient.ConsolidateChangelog(rawEntries, bestBump, "unknown");
+        const rollup = await bamlClient.ConsolidateChangelog(rawEntries, bestBump, "unknown", "", "");
         changelogEntry = rollup.consolidated_changelog?.trim() || rawEntries;
         versionBumpReason = rollup.version_bump_reason?.trim() || "";
       } catch (rollupError) {
@@ -940953,7 +941192,9 @@ async function sdkDiffCommand({
   } catch (error50) {
     const errorMessage = extractErrorMessage(error50);
     context3.failWithoutThrowing(
-      `Failed to analyze SDK diff. Diff stats: ${gitDiff.length.toLocaleString()} chars, ${diffSizeKB}KB, ${fileCount} files changed. ` + (cappedChunks.length > 1 ? `The diff was split into ${cappedChunks.length} chunks but analysis still failed. ` : "") + `Error: ${errorMessage}`
+      `Failed to analyze SDK diff. Diff stats: ${gitDiff.length.toLocaleString()} chars, ${diffSizeKB}KB, ${fileCount} files changed. ` + (cappedChunks.length > 1 ? `The diff was split into ${cappedChunks.length} chunks but analysis still failed. ` : "") + `Error: ${errorMessage}`,
+      void 0,
+      { code: CliError.Code.NetworkError }
     );
     throw new TaskAbortSignal();
   }
@@ -940974,7 +941215,9 @@ async function generateDiff({
     if (typeof error50 === "object" && error50 != null && "code" in error50 && error50.code === 1 && "stdout" in error50 && typeof error50.stdout === "string") {
       return error50.stdout;
     }
-    return context3.failAndThrow(`Failed to generate diff: ${extractErrorMessage(error50)}`);
+    return context3.failAndThrow(`Failed to generate diff: ${extractErrorMessage(error50)}`, void 0, {
+      code: CliError.Code.InternalError
+    });
   }
 }
 
@@ -941160,7 +941403,9 @@ async function sdkPreview({
       return askToLogin(context3);
     });
     if (token == null) {
-      return cliContext.failAndThrow("Authentication required. Run 'fern login' or set FERN_TOKEN.");
+      return cliContext.failAndThrow("Authentication required. Run 'fern login' or set FERN_TOKEN.", void 0, {
+        code: CliError.Code.AuthError
+      });
     }
     const project = await loadProjectAndRegisterWorkspacesWithContext(cliContext, {
       commandLineApiWorkspace: apiName,
@@ -941212,19 +941457,25 @@ async function sdkPreview({
       const groupNameOrDefault = groupName ?? workspace.generatorsConfiguration.defaultGroup;
       if (groupNameOrDefault == null) {
         return cliContext.failAndThrow(
-          `No group specified. Use the --${GROUP_CLI_OPTION} option, or set "${DEFAULT_GROUP_GENERATORS_CONFIG_KEY}" in ${GENERATORS_CONFIGURATION_FILENAME}`
+          `No group specified. Use the --${GROUP_CLI_OPTION} option, or set "${DEFAULT_GROUP_GENERATORS_CONFIG_KEY}" in ${GENERATORS_CONFIGURATION_FILENAME}`,
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       }
       const group = workspace.generatorsConfiguration.groups.find((g19) => g19.groupName === groupNameOrDefault);
       if (group == null) {
         return cliContext.failAndThrow(
-          `Group '${groupNameOrDefault}' does not exist in ${GENERATORS_CONFIGURATION_FILENAME}`
+          `Group '${groupNameOrDefault}' does not exist in ${GENERATORS_CONFIGURATION_FILENAME}`,
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       }
       const generators = generatorFilter != null ? group.generators.filter((g19) => g19.name === generatorFilter) : group.generators;
       if (generatorFilter != null && generators.length === 0) {
         return cliContext.failAndThrow(
-          `Generator '${generatorFilter}' not found in group '${groupNameOrDefault}' in ${GENERATORS_CONFIGURATION_FILENAME}`
+          `Generator '${generatorFilter}' not found in group '${groupNameOrDefault}' in ${GENERATORS_CONFIGURATION_FILENAME}`,
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       }
       const npmGenerators = generators.filter((g19) => isNpmGenerator(g19.name));
@@ -941236,14 +941487,18 @@ async function sdkPreview({
       }
       if (npmGenerators.length === 0) {
         return cliContext.failAndThrow(
-          `No supported generators found in group '${groupNameOrDefault}'. SDK preview currently only supports TypeScript/npm generators.`
+          `No supported generators found in group '${groupNameOrDefault}'. SDK preview currently only supports TypeScript/npm generators.`,
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       }
       for (const generator of npmGenerators) {
         const originalPackageName = getPackageNameFromGeneratorConfig(generator);
         if (originalPackageName == null) {
           return cliContext.failAndThrow(
-            `Could not determine package name for generator '${generator.name}'. Ensure 'output.package-name' is set in ${GENERATORS_CONFIGURATION_FILENAME}.`
+            `Could not determine package name for generator '${generator.name}'. Ensure 'output.package-name' is set in ${GENERATORS_CONFIGURATION_FILENAME}.`,
+            void 0,
+            { code: CliError.Code.ConfigError }
           );
         }
         const previewPackageName = toPreviewPackageName(originalPackageName, project.config.organization);
@@ -941572,7 +941827,7 @@ Resolved to: ${installationMethod.resolvedPath}`;
     }
     errorMessage += "\n\nPlease manually update using your package manager (npm, pnpm, yarn, bun, or brew).";
     errorMessage += "\nFor more diagnostic information, run with: FERN_LOG_LEVEL=debug fern self-update";
-    return cliContext.failAndThrow(errorMessage);
+    return cliContext.failAndThrow(errorMessage, void 0, { code: CliError.Code.EnvironmentError });
   }
   cliContext.logger.info(`Detected installation method: ${source_default.cyan(installationMethod.type)}`);
   if (installationMethod.detectedPath != null) {
@@ -941584,7 +941839,9 @@ Resolved to: ${installationMethod.resolvedPath}`;
   const updateCommand = getUpdateCommand(installationMethod, version7);
   if (updateCommand.length === 0) {
     return cliContext.failAndThrow(
-      `Unable to construct update command for installation method: ${installationMethod.type}`
+      `Unable to construct update command for installation method: ${installationMethod.type}`,
+      void 0,
+      { code: CliError.Code.EnvironmentError }
     );
   }
   if (installationMethod.type === "brew" && version7 != null) {
@@ -941603,7 +941860,7 @@ Resolved to: ${installationMethod.resolvedPath}`;
   cliContext.logger.info(`Running: ${source_default.dim(commandString)}`);
   const [command3, ...args] = updateCommand;
   if (command3 == null) {
-    return cliContext.failAndThrow("Invalid update command");
+    return cliContext.failAndThrow("Invalid update command", void 0, { code: CliError.Code.InternalError });
   }
   const { failed, stderr } = await loggingExeca(cliContext.logger, command3, args, {
     doNotPipeOutput: false,
@@ -941611,7 +941868,9 @@ Resolved to: ${installationMethod.resolvedPath}`;
   });
   if (failed) {
     cliContext.logger.error(`Failed to update Fern CLI: ${stderr}`);
-    return cliContext.failAndThrow("Update failed. Please try updating manually.");
+    return cliContext.failAndThrow("Update failed. Please try updating manually.", void 0, {
+      code: CliError.Code.EnvironmentError
+    });
   }
   cliContext.logger.info(source_default.green("\u2713 Fern CLI updated successfully!"));
 }
@@ -941628,10 +941887,14 @@ async function testOutput({
     command: "fern test"
   });
   if (testCommand == null) {
-    return cliContext.failAndThrow("No test command specified. Use the --command option.");
+    return cliContext.failAndThrow("No test command specified. Use the --command option.", void 0, {
+      code: CliError.Code.ConfigError
+    });
   }
   if (project.apiWorkspaces.length !== 1 || project.apiWorkspaces[0] == null) {
-    return cliContext.failAndThrow(`No API specified. Use the --${API_CLI_OPTION} option.`);
+    return cliContext.failAndThrow(`No API specified. Use the --${API_CLI_OPTION} option.`, void 0, {
+      code: CliError.Code.ConfigError
+    });
   }
   const workspace = project.apiWorkspaces[0];
   await cliContext.runTaskForWorkspace(workspace, async (context3) => {
@@ -941676,7 +941939,7 @@ async function testOutput({
         mockServer2.stop();
         context3.logger.error("Tests failed, Fern mock server stopping.");
         context3.logger.error("View test output above.");
-        cliContext.failAndThrow();
+        cliContext.failAndThrow(void 0, void 0, { code: CliError.Code.ValidationError });
       }
     }
     mockServer2.stop();
@@ -941703,15 +941966,25 @@ async function generateToken({
   }
   response.error._visit({
     organizationNotFoundError: () => taskContext.failAndThrow(
-      `Failed to create token because the organization ${orgId} was not found. Please reach out to support@buildwithfern.com`
+      `Failed to create token because the organization ${orgId} was not found. Please reach out to support@buildwithfern.com`,
+      void 0,
+      { code: CliError.Code.AuthError }
     ),
     unauthorizedError: () => taskContext.failAndThrow(
-      `Failed to create token because you are not in the ${orgId} organization. Please reach out to support@buildwithfern.com`
+      `Failed to create token because you are not in the ${orgId} organization. Please reach out to support@buildwithfern.com`,
+      void 0,
+      { code: CliError.Code.AuthError }
     ),
     missingOrgPermissionsError: () => taskContext.failAndThrow(
-      `Failed to create token because you do not have the required permissions in the ${orgId} organization. Please reach out to support@buildwithfern.com`
+      `Failed to create token because you do not have the required permissions in the ${orgId} organization. Please reach out to support@buildwithfern.com`,
+      void 0,
+      { code: CliError.Code.AuthError }
     ),
-    _other: () => taskContext.failAndThrow("Failed to create token. Please reach out to support@buildwithfern.com")
+    _other: () => taskContext.failAndThrow(
+      "Failed to create token. Please reach out to support@buildwithfern.com",
+      void 0,
+      { code: CliError.Code.AuthError }
+    )
   });
 }
 
@@ -941766,7 +942039,10 @@ function isIntrospectionResult(data2) {
 }
 function extractIntrospectionData(data2) {
   if (!data2 || typeof data2 !== "object") {
-    throw new Error("Data does not contain valid GraphQL introspection result");
+    throw new CliError({
+      message: "Data does not contain valid GraphQL introspection result",
+      code: CliError.Code.InternalError
+    });
   }
   if ("__schema" in data2 && data2.__schema) {
     return data2;
@@ -941774,7 +942050,10 @@ function extractIntrospectionData(data2) {
   if ("data" in data2 && data2.data && typeof data2.data === "object" && "__schema" in data2.data) {
     return data2.data;
   }
-  throw new Error("Data does not contain valid GraphQL introspection result");
+  throw new CliError({
+    message: "Data does not contain valid GraphQL introspection result",
+    code: CliError.Code.InternalError
+  });
 }
 async function tryGraphQLIntrospection(url3, logger4) {
   try {
@@ -941901,7 +942180,7 @@ Attempt 2 (GET direct fetch): ${getResult.error}
 To update the schema from its defined origin, please ensure the origin either:
 1. Accepts GraphQL introspection queries via POST, or
 2. Returns introspection results directly via GET`;
-  throw new Error(errorMessage);
+  throw new CliError({ message: errorMessage, code: CliError.Code.InternalError });
 }
 async function updateApiSpec({
   cliContext,
@@ -945135,7 +945414,7 @@ async function rerunFernCliAtVersion({
     if (throwOnError) {
       throw new RerunCliError({ version: version7, stdout, stderr });
     }
-    cliContext.failWithoutThrowing();
+    cliContext.failWithoutThrowing(void 0, void 0, { code: CliError.Code.InternalError });
   }
 }
 
@@ -945279,7 +945558,9 @@ function validateVersionAhead({
   const versionAhead = isVersionAhead(targetVersion, currentVersion);
   if (!versionAhead) {
     cliContext.failAndThrow(
-      `Cannot upgrade because target version (${targetVersion}) is not ahead of existing version ${currentVersion}`
+      `Cannot upgrade because target version (${targetVersion}) is not ahead of existing version ${currentVersion}`,
+      void 0,
+      { code: CliError.Code.VersionError }
     );
   }
 }
@@ -945334,7 +945615,9 @@ async function upgrade({
       }
       const fernDirectory2 = await getFernDirectory();
       if (fernDirectory2 == null) {
-        return cliContext.failAndThrow(`Directory "${FERN_DIRECTORY}" not found.`);
+        return cliContext.failAndThrow(`Directory "${FERN_DIRECTORY}" not found.`, void 0, {
+          code: CliError.Code.ConfigError
+        });
       }
       const projectConfig2 = await cliContext.runTask(
         (context3) => loadProjectConfig({ directory: fernDirectory2, context: context3 })
@@ -945368,7 +945651,9 @@ async function upgrade({
   if (cliContext.environment.packageVersion === resolvedTargetVersion || isLocalDev) {
     const fernDirectory2 = await getFernDirectory();
     if (fernDirectory2 == null) {
-      return cliContext.failAndThrow(`Directory "${FERN_DIRECTORY}" not found.`);
+      return cliContext.failAndThrow(`Directory "${FERN_DIRECTORY}" not found.`, void 0, {
+        code: CliError.Code.ConfigError
+      });
     }
     const projectConfig2 = await cliContext.runTask(
       (context3) => loadProjectConfig({ directory: fernDirectory2, context: context3 })
@@ -945410,7 +945695,9 @@ async function upgrade({
   });
   const fernDirectory = await getFernDirectory();
   if (fernDirectory == null) {
-    return cliContext.failAndThrow(`Directory "${FERN_DIRECTORY}" not found.`);
+    return cliContext.failAndThrow(`Directory "${FERN_DIRECTORY}" not found.`, void 0, {
+      code: CliError.Code.ConfigError
+    });
   }
   const projectConfig = await cliContext.runTask(
     (context3) => loadProjectConfig({ directory: fernDirectory, context: context3 })
@@ -945449,7 +945736,9 @@ async function upgrade({
       const isVersionNotFound = errorOutput.includes("ETARGET") || errorOutput.includes("E404") || errorOutput.includes("404 Not Found") || errorOutput.includes("No matching version found") || errorOutput.includes("version not found");
       if (isVersionNotFound) {
         return cliContext.failAndThrow(
-          `Failed to upgrade to ${resolvedTargetVersion} because it does not exist. See https://www.npmjs.com/package/${cliContext.environment.packageName}?activeTab=versions.`
+          `Failed to upgrade to ${resolvedTargetVersion} because it does not exist. See https://www.npmjs.com/package/${cliContext.environment.packageName}?activeTab=versions.`,
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       }
     }
@@ -945465,7 +945754,7 @@ async function validateDocsBrokenLinks({
 }) {
   const docsWorkspace = project.docsWorkspaces;
   if (docsWorkspace == null) {
-    cliContext.failAndThrow("No docs workspace found");
+    cliContext.failAndThrow("No docs workspace found", void 0, { code: CliError.Code.ConfigError });
     return;
   }
   await cliContext.runTaskForWorkspace(docsWorkspace, async (context3) => {
@@ -945488,7 +945777,7 @@ async function validateDocsBrokenLinks({
       elapsedMillis
     });
     if (violations.length > 0 && errorOnBrokenLinks) {
-      context3.failAndThrow();
+      context3.failAndThrow(void 0, void 0, { code: CliError.Code.ValidationError });
     }
   });
 }
@@ -945970,7 +946259,7 @@ async function validateWorkspaces({
         if (!apiYmlExists) {
           await cliContext.runTask(async (context3) => {
             context3.logger.error(`Missing file: ${ROOT_API_FILENAME}`);
-            return context3.failAndThrow();
+            return context3.failAndThrow(void 0, void 0, { code: CliError.Code.ValidationError });
           });
           return;
         }
@@ -946011,7 +946300,7 @@ async function validateWorkspaces({
     );
   }
   if (hasErrors || hasAnyErrors) {
-    cliContext.failAndThrow();
+    cliContext.failAndThrow(void 0, void 0, { code: CliError.Code.ValidationError });
   }
 }
 
@@ -946229,7 +946518,10 @@ async function translateText({
     cliContext.logger.error(
       "Authentication required. Please run 'fern login' or set the FERN_TOKEN environment variable."
     );
-    throw new Error("Authentication required for translation service");
+    throw new CliError({
+      message: "Authentication required for translation service",
+      code: CliError.Code.AuthError
+    });
   }
   const config5 = {
     maxRetries: retryConfig.maxRetries ?? DEFAULT_MAX_RETRIES3,
@@ -946266,7 +946558,7 @@ async function translateText({
           errorDetail = await response.text();
         }
         if (response.status === 403) {
-          throw new Error(`403: ${errorDetail}`);
+          throw new CliError({ message: `403: ${errorDetail}`, code: CliError.Code.AuthError });
         }
         const error50 = new Error(`HTTP ${response.status}: ${errorDetail}`);
         if (!isRetriableError(error50, response)) {
@@ -946946,7 +947238,10 @@ async function writeTranslationForProject({
     const translationsDirectory = join8(fernDirectory, RelativeFilePath2.of("translations"));
     const sourceLanguage = languages[0];
     if (!sourceLanguage) {
-      throw new Error("Unexpected error - first element of languages array is invalid");
+      throw new CliError({
+        message: "Unexpected error - first element of languages array is invalid",
+        code: CliError.Code.InternalError
+      });
     }
     if (!(0, import_fs38.existsSync)(translationsDirectory)) {
       context3.logger.debug(`Creating translations directory at: ${translationsDirectory}`);
@@ -947259,19 +947554,23 @@ async function resolveGroupGithubConfig(cliContext, groupName, apiWorkspace) {
   });
   const workspace = project.apiWorkspaces[0];
   if (workspace == null) {
-    return cliContext.failAndThrow("No API workspace found.");
+    return cliContext.failAndThrow("No API workspace found.", void 0, { code: CliError.Code.ConfigError });
   }
   const generatorsConfig = workspace.generatorsConfiguration;
   if (generatorsConfig == null) {
-    return cliContext.failAndThrow("No generators.yml found in workspace.");
+    return cliContext.failAndThrow("No generators.yml found in workspace.", void 0, {
+      code: CliError.Code.ConfigError
+    });
   }
   const group = generatorsConfig.groups.find((g19) => g19.groupName === groupName);
   if (group == null) {
     const available = generatorsConfig.groups.map((g19) => g19.groupName).join(", ");
-    return cliContext.failAndThrow(`Group "${groupName}" not found. Available groups: ${available}`);
+    return cliContext.failAndThrow(`Group "${groupName}" not found. Available groups: ${available}`, void 0, {
+      code: CliError.Code.ConfigError
+    });
   }
   const resolveEnv = (value) => replaceEnvVariables(value, {
-    onError: (message) => cliContext.failAndThrow(message)
+    onError: (message) => cliContext.failAndThrow(message, void 0, { code: CliError.Code.ConfigError })
   });
   const generatorWithSelfhosted = group.generators.find(
     (g19) => g19.raw?.github != null && isGithubSelfhosted(g19.raw.github)
@@ -947302,7 +947601,9 @@ async function resolveGroupGithubConfig(cliContext, groupName, apiWorkspace) {
       branch: "branch" in githubConfig ? githubConfig.branch : void 0
     };
   }
-  return cliContext.failAndThrow(`No generator in group "${groupName}" has a github configuration.`);
+  return cliContext.failAndThrow(`No generator in group "${groupName}" has a github configuration.`, void 0, {
+    code: CliError.Code.ConfigError
+  });
 }
 
 // src/runtime.ts
@@ -947432,7 +947733,7 @@ async function tryRunCli(cliContext) {
         cliContext.logger.info(cliContext.environment.packageVersion);
       } else {
         cli.showHelp();
-        cliContext.failAndThrow();
+        cliContext.failAndThrow(void 0, void 0, { code: CliError.Code.ConfigError });
       }
     }
   ).option("log-level", {
@@ -947558,14 +947859,22 @@ function addInitCommand2(cli, cliContext) {
         }
       }
       if (argv.api != null && argv.docs != null) {
-        return cliContext.failWithoutThrowing("Cannot specify both --api and --docs. Please choose one.");
+        return cliContext.failWithoutThrowing(
+          "Cannot specify both --api and --docs. Please choose one.",
+          void 0,
+          { code: CliError.Code.ConfigError }
+        );
       } else if (argv.readme != null && argv.mintlify != null) {
         return cliContext.failWithoutThrowing(
-          "Cannot specify both --readme and --mintlify. Please choose one."
+          "Cannot specify both --readme and --mintlify. Please choose one.",
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       } else if (argv.openapi != null && argv["fern-definition"] === true) {
         return cliContext.failWithoutThrowing(
-          "Cannot specify both --openapi and --fern-definition. Please choose one."
+          "Cannot specify both --openapi and --fern-definition. Please choose one.",
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       } else if (argv.readme != null) {
         await cliContext.runTask(async (context3) => {
@@ -947599,7 +947908,9 @@ function addInitCommand2(cli, cliContext) {
           if (isURL(argv.openapi)) {
             const result = await loadOpenAPIFromUrl({ url: argv.openapi, logger: cliContext.logger });
             if (result.status === LoadOpenAPIStatus.Failure) {
-              cliContext.failAndThrow(result.errorMessage);
+              cliContext.failAndThrow(result.errorMessage, void 0, {
+                code: CliError.Code.NetworkError
+              });
             }
             const tmpFilepath = result.filePath;
             absoluteOpenApiPath = AbsoluteFilePath2.of(tmpFilepath);
@@ -947608,7 +947919,9 @@ function addInitCommand2(cli, cliContext) {
           }
           const pathExists2 = await doesPathExist(absoluteOpenApiPath);
           if (!pathExists2) {
-            cliContext.failAndThrow(`${absoluteOpenApiPath} does not exist`);
+            cliContext.failAndThrow(`${absoluteOpenApiPath} does not exist`, void 0, {
+              code: CliError.Code.ConfigError
+            });
           }
         }
         await cliContext.runTask(async (context3) => {
@@ -947652,9 +947965,10 @@ function addDiffCommand(cli, cliContext) {
       description: "Whether to suppress output written to stderr"
     }).middleware((argv) => {
       if (!haveSameNullishness(argv.fromGeneratorVersion, argv.toGeneratorVersion)) {
-        throw new Error(
-          "Both --from-generator-version and --to-generator-version must be provided together, or neither should be provided"
-        );
+        throw new CliError({
+          message: "Both --from-generator-version and --to-generator-version must be provided together, or neither should be provided",
+          code: CliError.Code.ValidationError
+        });
       }
     }),
     async (argv) => {
@@ -947905,50 +948219,84 @@ function addGenerateCommand2(cli, cliContext) {
     }),
     async (argv) => {
       if (argv.api != null && argv.docs != null) {
-        return cliContext.failWithoutThrowing("Cannot specify both --api and --docs. Please choose one.");
+        return cliContext.failWithoutThrowing(
+          "Cannot specify both --api and --docs. Please choose one.",
+          void 0,
+          { code: CliError.Code.ConfigError }
+        );
       }
       if (argv.id != null && !argv.preview) {
-        return cliContext.failWithoutThrowing("The --id flag can only be used with --preview.");
+        return cliContext.failWithoutThrowing("The --id flag can only be used with --preview.", void 0, {
+          code: CliError.Code.ConfigError
+        });
       }
       if (argv.id != null && argv.docs == null) {
-        return cliContext.failWithoutThrowing("The --id flag can only be used with --docs.");
+        return cliContext.failWithoutThrowing("The --id flag can only be used with --docs.", void 0, {
+          code: CliError.Code.ConfigError
+        });
       }
       if (argv.skipUpload && !argv.preview) {
-        return cliContext.failWithoutThrowing("The --skip-upload flag can only be used with --preview.");
+        return cliContext.failWithoutThrowing(
+          "The --skip-upload flag can only be used with --preview.",
+          void 0,
+          { code: CliError.Code.ConfigError }
+        );
       }
       if (argv.skipUpload && argv.docs == null) {
-        return cliContext.failWithoutThrowing("The --skip-upload flag can only be used with --docs.");
+        return cliContext.failWithoutThrowing(
+          "The --skip-upload flag can only be used with --docs.",
+          void 0,
+          { code: CliError.Code.ConfigError }
+        );
       }
       if (argv.fernignore != null && (argv.local || argv.runner != null)) {
         return cliContext.failWithoutThrowing(
-          "The --fernignore flag is not supported with local generation (--local or --runner). It can only be used with remote generation."
+          "The --fernignore flag is not supported with local generation (--local or --runner). It can only be used with remote generation.",
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       }
       if (argv["skip-fernignore"] && argv.fernignore != null) {
         return cliContext.failWithoutThrowing(
-          "The --skip-fernignore and --fernignore flags cannot be used together."
+          "The --skip-fernignore and --fernignore flags cannot be used together.",
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       }
       if (argv["dynamic-ir-only"] && (argv.local || argv.runner != null)) {
         return cliContext.failWithoutThrowing(
-          "The --dynamic-ir-only flag is not supported with local generation (--local or --runner). It can only be used with remote generation."
+          "The --dynamic-ir-only flag is not supported with local generation (--local or --runner). It can only be used with remote generation.",
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       }
       if (argv["dynamic-ir-only"] && argv.version == null) {
         return cliContext.failWithoutThrowing(
-          "The --dynamic-ir-only flag requires a version to be specified with --version."
+          "The --dynamic-ir-only flag requires a version to be specified with --version.",
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       }
       if (argv["dynamic-ir-only"] && argv.docs != null) {
         return cliContext.failWithoutThrowing(
-          "The --dynamic-ir-only flag can only be used for API generation, not docs generation."
+          "The --dynamic-ir-only flag can only be used for API generation, not docs generation.",
+          void 0,
+          { code: CliError.Code.ConfigError }
         );
       }
       if (argv.output != null && !argv.preview) {
-        return cliContext.failWithoutThrowing("The --output flag currently only works with --preview.");
+        return cliContext.failWithoutThrowing(
+          "The --output flag currently only works with --preview.",
+          void 0,
+          { code: CliError.Code.ConfigError }
+        );
       }
       if (argv.output != null && argv.docs != null) {
-        return cliContext.failWithoutThrowing("The --output flag is not supported for docs generation.");
+        return cliContext.failWithoutThrowing(
+          "The --output flag is not supported for docs generation.",
+          void 0,
+          { code: CliError.Code.ConfigError }
+        );
       }
       const correctedGeneratorFilter = argv.generator != null ? warnAndCorrectIncorrectDockerOrg(argv.generator, cliContext) : void 0;
       const { generatorName, generatorIndex } = parseGeneratorArg(correctedGeneratorFilter);
@@ -948880,17 +949228,26 @@ function addDocsDevCommand(cli, cliContext) {
         );
       }
       let port;
-      if (argv.port != null) {
-        port = argv.port;
-      } else {
-        port = await getPorts({ port: [3e3, 3001, 3002, 3003, 3004, 3005, 3006, 3007, 3008, 3009, 3010] });
-      }
       let backendPort;
-      if (argv.backendPort != null) {
-        backendPort = argv.backendPort;
-      } else {
-        backendPort = await getPorts({
-          port: [3001, 3002, 3003, 3004, 3005, 3006, 3007, 3008, 3009, 3010, 3011]
+      try {
+        if (argv.port != null) {
+          port = argv.port;
+        } else {
+          port = await getPorts({
+            port: [3e3, 3001, 3002, 3003, 3004, 3005, 3006, 3007, 3008, 3009, 3010]
+          });
+        }
+        if (argv.backendPort != null) {
+          backendPort = argv.backendPort;
+        } else {
+          backendPort = await getPorts({
+            port: [3001, 3002, 3003, 3004, 3005, 3006, 3007, 3008, 3009, 3010, 3011]
+          });
+        }
+      } catch (error50) {
+        throw new CliError({
+          message: `Failed to find an available port: ${error50 instanceof Error ? error50.message : String(error50)}`,
+          code: CliError.Code.EnvironmentError
         });
       }
       const bundlePath = argv.bundlePath;
@@ -948943,7 +949300,7 @@ function addDocsMdCheckCommand(cli, cliContext) {
         defaultToAllApiWorkspaces: true
       });
       if (project.docsWorkspaces == null) {
-        cliContext.failAndThrow("No docs workspace found");
+        cliContext.failAndThrow("No docs workspace found", void 0, { code: CliError.Code.ConfigError });
       }
       const docsWorkspace = project.docsWorkspaces;
       let hasErrors = false;
@@ -948958,7 +949315,7 @@ function addDocsMdCheckCommand(cli, cliContext) {
         }
       });
       if (hasErrors) {
-        cliContext.failWithoutThrowing();
+        cliContext.failWithoutThrowing(void 0, void 0, { code: CliError.Code.ValidationError });
       }
     }
   );
@@ -949317,7 +949674,7 @@ function addBetaCommand(cli, cliContext) {
         await runCliV2(v2Args);
       } catch (error50) {
         cliContext.logger.error("CLI v2 failed:", String(error50));
-        cliContext.failWithoutThrowing();
+        cliContext.failWithoutThrowing(void 0, error50, { code: CliError.Code.InternalError });
       }
     }
   );
@@ -949442,7 +949799,11 @@ function addReplayInitCommand(cli, cliContext) {
       }
       if (githubRepo == null) {
         return cliContext.failAndThrow(
-          "Missing required github config. Either use --group to read from generators.yml, or provide --github directly."
+          "Missing required github config. Either use --group to read from generators.yml, or provide --github directly.",
+          void 0,
+          {
+            code: CliError.Code.ConfigError
+          }
         );
       }
       if (token == null) {
@@ -949478,7 +949839,9 @@ function addReplayInitCommand(cli, cliContext) {
           return;
         }
         if (result.lockfileContent == null) {
-          return cliContext.failAndThrow("Bootstrap succeeded but lockfile content is missing.");
+          return cliContext.failAndThrow("Bootstrap succeeded but lockfile content is missing.", void 0, {
+            code: CliError.Code.InternalError
+          });
         }
         const fernToken = await cliContext.runTask((context3) => askToLogin(context3));
         const { owner, repo } = parseOwnerRepo(githubRepo);
@@ -949500,18 +949863,24 @@ function addReplayInitCommand(cli, cliContext) {
         if (!response.ok) {
           if (response.status === 404) {
             return cliContext.failAndThrow(
-              "The Fern GitHub App is not installed on this repository. Install it at https://github.com/apps/fern-api to enable server-side PR creation."
+              "The Fern GitHub App is not installed on this repository. Install it at https://github.com/apps/fern-api to enable server-side PR creation.",
+              void 0,
+              { code: CliError.Code.ConfigError }
             );
           }
           const body = await response.text();
-          return cliContext.failAndThrow(`Failed to create PR via Fern: ${body}`);
+          return cliContext.failAndThrow(`Failed to create PR via Fern: ${body}`, void 0, {
+            code: CliError.Code.NetworkError
+          });
         }
         const data2 = await response.json();
         cliContext.logger.info(`
 PR created: ${data2.prUrl}`);
         cliContext.logger.info("Merge the PR to enable Replay for this repository.");
       } catch (error50) {
-        cliContext.failAndThrow(`Failed to initialize Replay: ${extractErrorMessage(error50)}`);
+        cliContext.failAndThrow(`Failed to initialize Replay: ${extractErrorMessage(error50)}`, error50, {
+          code: CliError.Code.NetworkError
+        });
       }
     }
   );
@@ -949574,12 +949943,18 @@ Resolve the conflicts in your editor, then run \`fern replay resolve\` again to
                 }
                 cliContext.logger.warn(`Resolve them first, then run \`fern replay resolve\` again.`);
               } else {
-                cliContext.failAndThrow(`Resolve failed: ${result.reason ?? "unknown error"}`);
+                cliContext.failAndThrow(
+                  `Resolve failed: ${result.reason ?? "unknown error"}`,
+                  void 0,
+                  { code: CliError.Code.InternalError }
+                );
               }
             }
         }
       } catch (error50) {
-        cliContext.failAndThrow(`Failed to resolve: ${extractErrorMessage(error50)}`);
+        cliContext.failAndThrow(`Failed to resolve: ${extractErrorMessage(error50)}`, error50, {
+          code: CliError.Code.InternalError
+        });
       }
     }
   );
@@ -949795,7 +950170,10 @@ function parseOwnerRepo(githubRepo) {
   const owner = parts[parts.length - 2];
   const repo = parts[parts.length - 1];
   if (owner == null || repo == null) {
-    throw new Error(`Could not parse owner/repo from: ${githubRepo}`);
+    throw new CliError({
+      message: `Could not parse owner/repo from: ${githubRepo}`,
+      code: CliError.Code.ParseError
+    });
   }
   return { owner, repo };
 }