> This page is for CLI 参考.

> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://buildwithfern.com/learn/llms.txt.

## 5.28.2

**`(chore):`** Generator-cli now delegates divergent-merge recovery (squash-merge of a regen
PR, force-push past a generation, lost-then-found generations) entirely to
`@fern-api/replay`'s derived scan boundary. Customers no longer hit the
pre-replay precondition gauntlet that occasionally got stuck on stale
`fern-generation-base` tag pointers. Replay still writes the tag for
backward compatibility with older bundled generator-cli versions.

## 5.28.1

**`(fix):`** Fix global theme merge to deep-merge object fields instead of overwriting them.
Local-only sub-fields (e.g. logo.right-text, logo.height) are now preserved
when the global theme defines sibling fields on the same object.

## 5.28.0

**`(feat):`** Consolidate all CLI v2 cache directories into `~/.fern/`. Docs preview bundles are now
managed under `~/.fern/v1/docs-preview/` and discoverable via `fern cache show` and
`fern cache clear --docs-preview`. The `fern cache clear` command never touches the
user's auth token or telemetry ID.

## 5.27.8

**`(fix):`** Fix property-level x-fern-audiences filtering breaking error type resolution when
enableUniqueErrorsPerEndpoint is true. Types referenced via object properties (e.g.
ErrorResponse → ErrorResponseError) are now correctly included during audience filtering,
resolving "Failed to find ErrorResponseError" errors in fern check and fern docs dev.