5.45.4
(fix): Fix fs.cp resolving relative symlinks to absolute temp-directory paths
during local generation. Adds verbatimSymlinks: true so symlinks like
.claude -> .agents are preserved as-is when copying generator output.
(fix): Fix fs.cp resolving relative symlinks to absolute temp-directory paths
during local generation. Adds verbatimSymlinks: true so symlinks like
.claude -> .agents are preserved as-is when copying generator output.
(feat): Add OIDC support for PyPI publishing in local generation. When
token: OIDC is configured for a PyPI output, the CLI now detects
the OIDC credential and propagates it through both the GitHub publish
info and the publish config so the Python generator can activate its
OIDC trusted-publisher workflow.
(feat): Track which validation rules fired during fern check as part of the PostHog CLI telemetry event.
The event now includes validationRules (array of rule names that produced violations),
numErrors, numWarnings, and passed properties.
(fix): Bump @fern-api/generator-cli to 0.9.36: AutoVersionStep now calls the hosted FAI
service with fernToken when no BAML ai config is supplied, restoring real
version bumps and changelog entries for replay-enabled remote generations.
(chore): Upgrade Venus API SDK from v0.22.34 to v5.0.0 with HTTPBearer root-level authentication.
(fix): Fix native generator execution to correctly pass raw API specs directory
via FERN_SPECS_DIR environment variable, enabling local seed tests for
generators that consume OpenAPI specs (e.g. CLI generator).
(fix): Fix v3 OpenAPI importer to check x-fern-server-name extension in getEndpointBaseUrls(),
preventing path-level server descriptions from being misinterpreted as base URL IDs when the
extension is present.
(feat): The ai.provider field in generators.yml now uses BAML provider
identifiers directly. bedrock has been renamed to aws-bedrock.
Update your config: provider: bedrock → provider: aws-bedrock.
(fix): Fix fern export to emit top-level servers array for multi-URL environments
(multipleBaseUrls). Previously only single-URL environments produced servers.
Each environment × base-URL combination is now listed with a description like
"Production (api)". Endpoint-level servers also now include the environment
name in their description.
(fix): Fix fern check parameter-name collision validator to honor x-fern-parameter-name.
Previously, parameters with distinct x-fern-parameter-name overrides were still
flagged as collisions based on their raw OpenAPI name field.
(fix): Fix SPM auto-compiling dynamic snippet files as 650+ separate executables by
moving snippets into Tests/Snippets/ and wrapping them as library code (compiled
as part of the test target instead of standalone executables).
(chore): Combine build and test into single swift test -c release invocation to avoid
redundant recompilation in seed scripts.
(fix): Fix AI example enhancement to backfill missing required fields from the auto-generated
example. When the AI Lambda produces a partial example (e.g., missing fields from nested
allOf chains), the missing fields are now merged from the correct auto-generated example,
ensuring all required fields are present in published documentation.
(fix): Fix false positive warnings in the missing-redirects check for changelog
entries and embedded content pages. FDR stores an empty slug for pages that
don’t resolve to a standalone navigation node; these are no longer reported as
removed pages whose previously published URL was ”/”, even when the site’s home
page lives under a non-root slug or basepath.
(fix): Fix fern check validators (valid-local-references, no-non-component-refs) incorrectly reporting $ref values found inside YAML comments.
(fix): Fix example generation for nested allOf $ref chains. When a schema uses
multi-level allOf (e.g. UserPost → UserBase → UserStrict), properties from
grandparent schemas were missing from generated code snippets because
mergeAllOfProperties only resolved one level of allOf. Now recursively
resolves the full chain so all required fields appear in examples.
(fix): Fix AsyncAPI v2 enum collision where multiple channels with identically
named query parameters (or headers/path params) that have different enum
values would overwrite each other. The v2 channel converter now passes
parameterNamePrefix (the channel path) to the ParameterConverter,
matching the v3 converter behavior.
(fix): Update CLI irVersion metadata from 66 to 67 so that FDR correctly
reports IR 67-compatible generator versions (e.g. CLI generator ≥ 0.2.0)
when resolving fern generator upgrade.
(chore): Rename the CLI generator Docker image from fernapi/fern-cli to
fernapi/fern-cli-generator.
(fix): Fix docs rendering dropping parent properties when an allOf parent schema
itself uses allOf with ref objects during allOf flattening instead of silently
filtering them out.
(fix): Fix OpenAPI parser emitting redundant or wrongly-required base properties for
discriminated unions when infer-discriminated-union-base-properties: true.
The inference now (1) skips properties every variant already inherits via a
shared allOf $ref parent — the parent schema is the single source of truth —
and (2) lifts an inferred property as optional if any variant declares it as
not-required. Together these prevent generated TypeScript SDKs from synthesizing
a _Base interface that collides with the real parent on either presence or
optionality (TS2320).
(fix): Fix localized docs builds so translated OpenAPI specs are used for API reference content and navigation titles.
(fix): Fix ENOTEMPTY error during local generation when removing the temporary
.git directory in copyGeneratedFilesWithFernIgnoreInTempRepo. The fs.rm
call now uses maxRetries: 3 to handle race conditions with git background
processes (e.g. auto-gc) that may still hold references to .git/objects/pack.
Also disables git auto-gc during the temporary git init to reduce the
likelihood of the race condition.
(fix): Fix false-positive “Example is missing required property” errors when validating
examples of discriminated unions whose base-properties overlap with properties
each variant also inherits via its own extends chain. The union validator now
preserves keys claimed by the variant when constructing the example handed to
variant-level validation, so inherited required properties are no longer dropped.
(chore): Replace external petstore3.swagger.io URL with a local OpenAPI server in the v2 generate ETE test to remove a flaky dependency on the public petstore endpoint.
(feat): Add fern api enrich command to CLI v2 for merging AI-generated examples
from an overrides file into native OpenAPI example fields.
(feat): Prompt for an optional description when creating a token interactively via fern org token create.
(feat): Add fern docs diff command to CLI v2 for generating visual diffs between preview and production docs pages.
(fix): Skip AI example enhancement in self-hosted builds to avoid Venus JWT 401 errors and unnecessary latency.
(fix): Stop overwriting native OpenAPI examples with AI-generated ones (FER-10006).
When a customer provides an example or examples on a request body whose
media type also has a schema, the example is now correctly classified as
user-specified at both the IR and FDR layers, so the AI example enhancer
skips the endpoint instead of replacing the human-authored payload.
(feat): Add X-Request-Id header to all CLI v2 HTTP requests for request tracing and debugging.
(fix): Add /openapi.json, /openapi.yaml, /openapi.yml, /asyncapi.json, /asyncapi.yaml, and /asyncapi.yml
to the link validator whitelist, and add pattern-based matching for dynamic API spec paths like
/openapi/<id>.json so fern check no longer reports false broken-link errors for these special doc pages.