4.71.2
(fix): Fix allOf composition bugs in V3 OpenAPI importer: resolve ref-resolved
schemas, preserve inline status through allOf merge path, handle nullable
enum patterns in allOf shortcuts, detect cycles across recursive
single-element allOf chains, filter unresolved $ref objects from nested allOf
flattening, recursively flatten deeply-nested allOf arrays, strip oneOf/anyOf
from child schemas during allOf merging, and propagate outer schema metadata
through single-element allOf paths.
4.71.1
(fix): Fix false positive warnings in the missing-redirects check. Pages are no
longer flagged as removed or moved when their old URL is still actively
served by another page in the local docs config.
4.71.0
(feat): Add --id flag to fern docs preview delete, allowing deletion of preview deployments by their stable preview ID instead of the full URL. The org is resolved automatically from fern.config.json. Existing usage of fern docs preview delete <url> continues to work unchanged via the new auto-detecting [target] positional.
4.70.2
(fix): Fix “Edit this page” button appearing on docs sites that never configured it.
The default editThisPageLaunch is now undefined instead of "dashboard",
so the button only renders when explicitly configured.
4.70.1
(fix): Fix “Edit this page” button appearing on docs sites that never configured it.
The default editThisPageLaunch is now undefined instead of "dashboard",
so the button only renders when explicitly configured.
4.70.0
(feat): Enable --push-diff flag for fern sdk preview to push a preview diff
branch to the SDK repo in addition to publishing to the preview registry.
Adds diff_url to the JSON and text output for use by CI integrations.
4.69.0
(feat): Improve auto-versioning prompts for better SDK version bump determination and changelog quality.
Commit type now matches version bump severity, per-chunk changelog entries use category tags,
consolidation prompt deduplicates aggressively, and version context is passed to consolidation.
4.68.5
(chore): Migrate CLI to a unified error system using a shared CliError class with typed error codes.
Error codes drive Sentry reporting eligibility; unclassified errors are temporarily suppressed
from Sentry until all call sites are migrated.
4.68.4
(fix): Deduplicate global headers when merging IRs from multiple OpenAPI specs. Previously, if multiple specs shared the same globalHeaderOverrides from generators.yml, the same header would appear once per spec in the merged IR.
4.68.3
(fix): Fix global headers from generators.yml not appearing in documentation endpoints. The new OpenAPI v3 parser (openapi-to-ir) had a TODO placeholder but never converted globalHeaderOverrides into IR headers.
4.68.2
(fix): Fix an issue where api:<apiName>:METHOD/path links worked on published docs sites but did not resolve in fern docs dev.
4.68.1
(fix): Fix CLI blocking when PostHog is unreachable by adding a 3-second timeout
and error handling to analytics flush calls.
4.68.0
(feat): Add support for x-fern-display-name on AsyncAPI operations. This allows setting friendly display names on AsyncAPI v2 publish/subscribe operations and v3 operations, which is useful when operation keys need to be normalized (e.g. for versioned endpoints) but you still want readable names in docs.
4.67.1
(fix): Fall back to git tags for auto-versioning when the magic version is not
embedded in any generated source file. This fixes auto-versioning for
SDKs like Swift that use git tags for versioning (via SPM) rather than
a version field in source code.
4.67.0
(feat): Add agents.llms-txt and agents.llms-full-txt to docs.yml so customers can upload
custom llms.txt and llms-full.txt files that override the auto-generated versions
on their docs sites.
4.66.1
(fix): Fix GraphQL converter to properly handle interface types. Interfaces
with implementing types (e.g., CatalogProductOption with
CheckboxOption, MultipleChoiceOption, etc.) are now converted to
undiscriminatedUnion shapes so that all possible concrete types are
discoverable in generated docs. Interfaces with no implementations
fall back to plain object types.
4.66.0
(chore): Internal infrastructure for GitHub Actions-based SDK generation automation.
4.65.3
(fix): Fix broken-link checker incorrectly flagging absolute links in versioned
docs pages as broken.
4.65.2
(fix): Improve error messages for fern docs preview list command. The default
error now suggests checking authentication instead of network connectivity,
and the full error response is logged at debug level for easier diagnosis.
4.65.1
(fix): Fixed a performance issue in fern check where valid-markdown-links
repeatedly reprocessed duplicate API descriptions and pathnames in API
sections, significantly improving runtime on large docs sites.
4.64.1
(chore): Tag Sentry errors with fern_run_id and github_run_id for cross-run
correlation. The CLI now generates a FERN_RUN_ID at startup if one is
not already set in the environment (e.g. by the fern-api/actions/setup-cli
GitHub Action), threading a single correlation ID through all CLI
invocations in a workflow run.
4.65.0
(feat): Add --output flag to fern sdk preview that accepts filesystem paths
and/or registry URLs. Omit to publish to the default preview registry and
write to a temp directory. Use --output <path> for disk-only output, or
--output <path> --output <url> to write to disk and publish to a custom registry.
4.64.0
(feat): Support default on discriminant properties in OpenAPI discriminated unions. When a variant’s
discriminant property has a default value matching its const value, the default variant is
threaded through the IR so generators can fall back to it when the discriminant field is omitted.
The x-fern-default extension takes priority over default if both are set.
4.63.5
(fix): Fix union variant display names showing “object” instead of proper
schema names in documentation.
4.63.4
(fix): Add no-conflicting-parameter-names OSS validation rule to fern check.
Detects when header parameters and query/path parameters on the same endpoint
normalize to the same camelCase name, which causes broken generated SDK code
(Python SyntaxError from duplicate keyword arguments, TypeScript duplicate
interface properties). The rule reports an error at validation time so the
collision is caught before code generation.
4.63.3
(fix): Fix coerce-enums-to-literals: false not being respected for boolean
single-value enums (type: boolean, enum: [true]). Previously, boolean
enums were always coerced to literals regardless of the setting. Now
getSingleBooleanEnumValue checks coerceEnumsToLiterals consistently
with the string enum path.
4.63.2
(fix): Add log rotation for fern docs dev debug logs in ~/.fern/logs/.
Old log files are automatically deleted when the directory exceeds
100 MB, keeping the most recent logs.
4.63.1
(fix): Fix Go dynamic snippets not being generated during docs publish.
The Go package name comparison between snippet configuration and
generator output was failing due to an https:// prefix mismatch,
causing docs to fall back to raw net/http code instead of
SDK-idiomatic snippets.
4.63.0
(feat): Speed up fern docs dev bundle refresh by renaming the old bundle
and deleting it asynchronously instead of blocking on removal.
4.62.6
(fix): Clean up Fern Docs cache on fern docs dev startup and shutdown.
4.62.5
(fix): Fix replay init to create .gitattributes with linguist-generated markers and sync .fernignore entries with fern-replay.
4.62.4
(chore): Internal CLI improvements.
4.62.3
(fix): Make GitHub token optional for replay init. Public repos no longer require a token.
4.62.1
(chore): Remove deprecated private field from DocsInstance configuration.
4.62.2
(fix): Fix OpenAPI importer dropping request body examples when the request
body has no schema defined. Previously, endpoints with a JSON content
type but no schema were treated as having no request body at all,
causing valid example JSON to be lost. The importer now preserves the
request and its examples so they render in docs and code snippets.
4.62.0
(feat): Make the fern api enrich command public. This command merges an
AI examples overrides file into an OpenAPI spec, integrating
x-fern-examples into native OpenAPI example fields.
4.60.0
(feat): Add agents.page-description-source to docs.yml to control which
frontmatter field is preferred for one-line page descriptions in llms.txt.
Supports description and subtitle, and falls back to other supported
frontmatter fields when the preferred field is not present.
