v0.9.2

> **Codewhale** is the public product from Shannon Labs. The `codewhale`
> command, npm package, and release-asset names remain lowercase technical
> identifiers. The legacy npm package `deepseek-tui` is deprecated and
> receives no further releases. Users coming from v0.8.x legacy `deepseek` /
> `deepseek-tui` names should migrate with `docs/REBRAND.md`.

## Install

### Recommended — npm (one command, all three entrypoints)

```bash
npm install -g codewhale
```

The wrapper downloads the matched `codewhale`, `codew`, and `codewhale-tui`
binaries from this Release and places them in the same directory.

### Docker / GHCR

```bash
docker run --rm -it \
  -e DEEPSEEK_API_KEY="$DEEPSEEK_API_KEY" \
  -v codewhale-home:/home/codewhale/.codewhale \
  ghcr.io/hmbown/codewhale:v0.9.2
```

The image ships the `codewhale` dispatcher, `codew` shim, and `codewhale-tui` runtime. The `latest` tag is also updated on release.

### Cargo (Linux / macOS)

```bash
cargo install codewhale-cli codewhale-tui --locked
```

Both crates are required — `codewhale-cli` produces the `codewhale` dispatcher and `codew` shim, while `codewhale-tui` produces the interactive runtime that the dispatcher delegates to. Installing only one crate will fail at runtime with a `MISSING_COMPANION_BINARY` error.

### Manual download — platform archives (recommended)

Each archive below contains the `codewhale` dispatcher, `codew` shim, and `codewhale-tui` runtime, plus an install script:

| Platform | Archive | Install script |
|---|---|---|
| Linux x64 | `codewhale-linux-x64.tar.gz` | `install.sh` |
| Linux ARM64 | `codewhale-linux-arm64.tar.gz` | `install.sh` |
| Android ARM64 (Termux) | `codewhale-android-arm64.tar.gz` | `install.sh` |
| macOS x64 | `codewhale-macos-x64.tar.gz` | `install.sh` |
| macOS ARM | `codewhale-macos-arm64.tar.gz` | `install.sh` |
| Windows x64 (installer) | `CodeWhaleSetup.exe` | NSIS setup |
| Windows x64 | `codewhale-windows-x64.zip` | `install.bat` |
| Windows x64 (portable) | `codewhale-windows-x64-portable.zip` | — |
| Windows ARM64 | `codewhale-windows-arm64.zip` | `install.bat` |
| Windows ARM64 (portable) | `codewhale-windows-arm64-portable.zip` | — |

**Unix (Linux / macOS):**
```bash
tar xzf codewhale-<platform>.tar.gz
cd codewhale-<platform>
./install.sh
```

**Windows:**
- For the installer path, run `CodeWhaleSetup.exe`; it installs `codewhale.exe`, `codew.exe`, and `codewhale-tui.exe` under `%LOCALAPPDATA%\Programs\CodeWhale\bin` and adds that directory to the current-user PATH.
- Extract the archive for your machine: `codewhale-windows-x64.zip` or
  `codewhale-windows-arm64.zip`
- Run `install.bat` (copies to `%USERPROFILE%\bin`)
- Add `%USERPROFILE%\bin` to your PATH

The **portable** Windows archive skips the install script — extract and run from any directory. The NSIS installer is currently unsigned and may trigger Windows SmartScreen until a signing certificate is wired into the release pipeline.

Each platform also has **bare, unarchived** binaries attached below (`codewhale-<platform>`, `codew-<platform>`, and `codewhale-tui-<platform>`) — the npm wrapper and the in-app `codewhale update` download the matched runtime binaries, whereas the `.tar.gz` / `.zip` archives above are the recommended manual download and additionally bundle an install script. The legacy npm package `deepseek-tui` is deprecated and is not republished. For migration from v0.8.x legacy binary names, see `docs/REBRAND.md`.

### Verify (recommended)

Download the checksum manifests from this Release and verify:

```bash
# Linux — archive bundles
sha256sum -c codewhale-bundles-sha256.txt --ignore-missing

# Linux — individual binaries
sha256sum -c codewhale-artifacts-sha256.txt --ignore-missing

# macOS
shasum -a 256 -c codewhale-bundles-sha256.txt --ignore-missing
shasum -a 256 -c codewhale-artifacts-sha256.txt --ignore-missing
```

## What's in v0.9.2

This is the Codewhale v0.9.2 source candidate. It is not a published release
until the matching tag, packages, checksums, and release assets exist.

### Changed — behavior

- **Legacy `model = auto` no longer elects a network classifier on its own.**
  Holding a DeepSeek API key used to silently select `deepseek-v4-flash` as the
  classifier for every Auto turn — a per-turn cost on a route nobody asked for,
  and one provider privileged over the rest. Auto now stays local and free
  unless an explicit `[auto.router]` block names a provider and model.

  **If you relied on the implicit default**, restore it explicitly:

  ```toml
  [auto.router]
  provider = "deepseek"
  model = "deepseek-v4-flash"
  ```

  `[auto.router]` remains legacy `model = auto` configuration. It is unrelated
  to a Fleet's Adaptive Reasoning Router, which is a saved service referenced by
  name from a Fleet file and decides only how hard an already-frozen route
  thinks.

Landed since v0.9.1, not yet released. A cluster of defects found by a
read-through audit of the policy engine, the MCP proxy, the session index,
and the app-server bridge — several of them cases where the wrong outcome
was reached silently, behind a response or a log line that looked fine. The
release also adds opt-in session, reasoning, localization, and inspectability
surfaces; existing defaults remain stable unless an entry below explicitly
says otherwise.

### Added

- `/permissions` now lists the active user permission-rule source, each rule's
  effective matcher and global/repository scope, and whether that scope applies
  in the current workspace. `/permissions remove <number>` previews deletion
  and requires a snapshot-bound confirmation token, so a concurrent edit
  cannot move a different rule under the confirmed index. Appends and removals
  share one adjacent lock, preserve unrelated TOML formatting and comments,
  atomically replace `permissions.toml`, and reload the live user ruleset
  without clearing session-only approvals. `/config ask-rules` remains a
  compatibility entry; rule creation, glob/directory rules, and deny
  persistence remain out of scope (#1186, PR #4960 by @greyfreedom).

- `/preview-request` (aliases `/dryrun` and `/preview_request`) is a human-only,
  provider-free inspection of the next primary turn. Production dispatch and
  preview share one prepared-request seam across Chat Completions, Anthropic
  Messages, and OpenAI Responses, so the manifest reads the final wire model,
  reasoning controls, tool choice, tool schemas, and body hash from the same
  value production sends. Route, tool, or body facts that require Auto's
  provider classifier, an MCP connection, mutable hooks, compaction, or queued
  runtime injections remain typed unavailable. The manifest reports exact
  primary role/lane identity, upstream route-source provenance, requested and
  effective reasoning, canonical JSON sizes, conservative offline estimates,
  and provider-reported usage as unavailable because no request ran. It never
  adds a model-visible tool, sends a provider call, or prints prompt, message,
  credential, endpoint-path, or workspace-path content. The explicit
  `/preview-request base-prompt` mode prints only the exact effective base
  prompt; effective system text remains protected behind its final hash. The
  exact body includes the same authoritative transient Work/To-do tail used by
  production, including graph-backed state newer than the legacy projection.
  Preflight preserves production's separately framed base-plus-Work estimate,
  and fails closed when the authoritative projection is unavailable. An
  exhausted active goal token budget also produces a typed unavailable result
  before any outbound request is built.
  (#1004, #3928; dry-run concept harvested from PR #1099 by @GTC2080 / TaoMu.)

- Slash commands, hotbar actions, and CLI entrypoints for the same Lane/Fleet
  lifecycle operation now share one typed control-plane contract
  (`codewhale-lane::control`): a stable `<domain>.<verb>` id, read-vs-write
  authority, persistence scope, exact-identity target selection, retryability,
  lifecycle outcome, and one bounded, sanitized receipt. `docs/COMMAND_CONTROL_PLANE.md`
  documents it (#1888).

- `/lane [list|status|interrupt|restart|resume]` — durable Lane control from the
  composer, backed by the same executor `codewhale lane …` calls. `codewhale
  lane interrupt|restart|resume` are the matching CLI verbs; `lane stop` stays as
  a compatibility spelling of `lane interrupt`. Appending `@<lifecycle-seq>` to a
  lane id fences a write to the exact durable generation you observed, so a
  concurrent transition is rejected as a conflict rather than acted on (#1888).

- `codewhale fleet list` and `/fleet [list|status|interrupt|resume]` — durable
  Fleet run inspection and control from either surface, through shared DTOs that
  carry the exact provider, provider-table id, model, effective reasoning tier,
  and route source when the ledger records them, and a typed `not_recorded` /
  `not_applicable` / `redacted` reason when it does not. Requested-vs-effective
  reasoning is never back-filled: the ledger persists the effective tier only, so
  the requested tier reports `not_recorded` (#4022).

- The bundled skill pack now ships a `help` skill (catalog generation 7). It is
  `invocation: explicit-only`, so it never enters the model's ambient catalogue
  and costs no prompt budget. Its body is a routing card that points at the
  surfaces this build actually exposes — `/help` and `/help <command>`,
  `/skills` and `/skills inspect`, `/config`, `doctor`, and the `docs/` tree
  when the workspace is a Codewhale checkout — and explicitly forbids pasting a
  command list or settings table into context (#4698).

- `crates/tui/assets/skills-catalog-matrix.json`: an authored, provider-free
  expectation matrix covering every bundled skill (tier, invocation, aliases,
  ambient-catalogue eligibility, shadowed aliases). Contract tests in
  `crates/tui/src/skills/catalog_matrix.rs` assert a bijection between the
  fixture and the shipped bundle, so the starter pack cannot change without an
  explicit fixture update. The matrix covers positive eligibility and explicit
  load, non-activation negatives, alias resolution, explicit-only exclusion,
  alias-vs-canonical collision precedence, and prompt-budget invariants (no
  duplicate catalogue entries, no aliases as extra entries, and the shipped
  pack fitting inside the 12 000-char budget with no omitted-skills line). These
  are deterministic registry/catalog/resolver assertions and make no claim about
  semantic model routing (#4698).

- Locale-routing coverage for the complete bundled catalog across every shipped
  locale (`en`, `ja`, `zh-Hans`, `zh-Hant`, `pt-BR`, `es-419`, `vi`, `ko`). No
  bundled skill ships a localized routing description and none was invented;
  the tested contract is deterministic fallback to the canonical English
  description, with the rendered catalogue byte-identical across locales.
  Exact-tag match, primary-subtag fallback, and English fallback are covered
  against a synthetic authored fixture, and the parity test fails if a bundled
  skill ever gains localized metadata without source-backed coverage (#4698).

- `docs/LIVE_SMOKE.md`: copy-pasteable, opt-in live-smoke instructions for Kimi
  K3 and a second provider/model (DeepSeek). The runs are manual only — nothing
  in CI, tests, or skills invokes them. They use `env -i` plus a throwaway
  `CODEWHALE_HOME`; `HOME` is left unset rather than repurposed, and ambient
  provider variables are not forwarded. The operator names the credential
  variable explicitly, and the isolated child reads its value with echo off,
  restores the prior terminal state on exit or interruption, and never persists
  the value or puts it in a command argument. The page states the expected
  route/model/reasoning/tool receipt fields while treating provider errors as
  unclassified until provider configuration, authentication/entitlement, and
  harness behavior have been corroborated independently (#4698).

- Approval cards can now remember eligible safe shell and file-write approvals
  as exact `allow` rules scoped to the current repository. Remembered shell
  commands use complete-command matching, validated file and patch paths remain
  workspace-relative, and dangerous, critical, or repo-law-held requests stay
  ineligible and continue to require review.

- `tui.header_items` (array of strings, optional, default `[]`): an opt-in
  header chip showing cumulative session token usage as input / cache-hit /
  output. Set `header_items = ["tokens"]` under `[tui]` to enable it. The
  chip is the only elidable element of the header — the git label, context
  meter, and version stamp keep their space, and narrow terminals drop the
  chip rather than the baseline chrome. Unknown entries are warned about and
  skipped so configs written by newer builds stay loadable by older ones
  (#4520 requested by @eugenicum; PR #4610 by @XhesicaFrost, harvested with
  co-authorship).

- `thinking_default_expanded` lets reasoning blocks start open while keeping
  Space as the per-block toggle. The setting is persisted, available through
  native and runtime configuration, and documented for SSH/tmux accessibility
  (issue #4925 and PR #4928 by @M-Maciej).

- The transcript renders a conservative subset of LaTeX math as readable
  Unicode without rewriting fenced/inline code, ordinary currency, escaped
  dollars, or unknown commands. The contribution from PR #4973 by
  @SparkofSpike was hardened and landed through PR #4974; reported by
  @antarikshraya in #4957.

- Session control now includes a sessions rail, shared archive projection,
  picker archive controls, and opt-in interactive auto-resume with explicit
  handoff behavior. The work closes the remaining session-browsing direction
  from #2934; thanks @cy2311 for the original report.

- The bundled contributor-onboarding skill can sync contribution context,
  select the appropriate gate, and prepare a digest without inflating the
  ambient skill catalog. It follows the contributor-navigation request in
  #4227 by @JayBeest.

- Bahasa Indonesia now has a complete repository documentation suite and a
  registered website dictionary alongside the shipped TUI locale (PRs #4962
  and #4972 by @atmosuwiryo, closing #4789).

- Reasoning content can keep its rail, italics, cursor, and expansion controls
  while disabling only the warm background highlight. The independent setting
  is persisted and localized (#4089; reported by @elijahchan2019).

- StepFun setup now asks whether a key belongs to PAYG or Step Plan, keeps the
  two endpoint/billing routes distinct, and localizes the choice across the
  complete packs (#4526; reported by @whp233).

- OpenCode Zen is a separate model-aware API-key provider. Its curated catalog
  selects Responses, Anthropic Messages, or Chat Completions per model;
  unsupported Gemini and unknown models fail closed, and missing Zen
  credentials never fall through to ChatGPT/Codex OAuth guidance. The
  implementation from closed PR #4467 by @snail-vs (snailoniu) is preserved in
  the candidate.

- Markdown exports correlate prompts with stable workspace restore-point ids
  and say when correlation is unavailable or ambiguous, completing the
  remaining restoration/export direction from #2494 by @wywsoor.

### Fixed

- Permission setup now consistently presents the product postures Ask,
  Auto-Review, and Full Access instead of leaking the internal `never` token.
  The same resolved sandbox policy now drives execution and UI receipts: Plan
  stays read-only, Ask and Auto-Review stay workspace-scoped, and Full Access
  is actually unsandboxed unless a stricter effective configuration wins.

- Fleet setup no longer stalls when a user explicitly selects a configured
  Codex or Grok external-consent route. The selected route is activated and
  validated before saving, roster roles open directly on their Model step,
  Review saves on the first Enter, and new profiles default to the personal
  profile directory that the roster loads on the next session.

- Provider credential dialogs now share one wrapping, secret-safe API-key
  surface across every non-OAuth provider. A key already present in durable
  storage is reported as configured without rendering it, typing or pasting is
  clearly framed as replacement, narrow help text remains visible, and Codex
  and Grok OAuth flows remain token-free in this modal.

- Ctrl+O again opens the complete recorded reasoning detail for the selected,
  active, or latest reasoning block. The whole-turn Turn Inspector moved to
  Ctrl+Alt+O and `/turn inspect`, removing the shortcut collision while keeping
  raw leaf detail and post-flush reasoning discoverable.

- Failed child agents now deliver a distinct high-priority failure receipt to
  their owning parent with a sanitized failure class, elapsed work, and a full
  transcript handle. Parent-to-child message, follow-up, and interrupt tools
  now use one hierarchy-checked mailbox path, and persisted nested completion
  envelopes remain safely restorable across instruction-text revisions.

- Background-shell completion events now carry only bounded tails plus a
  retrievable exact-evidence handle. Terminal foreground Bash results are
  acknowledged at the direct tool-result boundary and are no longer emitted a
  second time as background completion artifacts.

- Providerless Fleet and child-agent fixed-model routes now reject only
  high-confidence foreign-provider model ids before creating a worktree, while
  explicit provider/model pairs, custom and local endpoints, unknown ids, and
  aggregator wire-id resolution retain their intended behavior.

- Manual compaction now preserves and reports the supplied provider failure
  class instead of replacing it with an opaque generic error. This does not
  infer quota exhaustion when the recorded failure does not prove it.

- The ambient jellyfish keep complete, readable silhouettes while animating,
  and the website favicon now uses the Signal Current desktop tile instead of
  the legacy whale mark.

- ACP JSON-RPC responses preserve numeric request ids for avante.nvim while
  retaining the negotiated string-id exception for Zed (PR #4929 by
  @atmosuwiryo).

- Restored shell cells whose job no longer exists stop displaying live
  spinners and settle into a truthful stale/no-output state across transcript,
  phase strip, and sidebar (PR #4937 by @LI-Jialu, closing #4547).

- Interrupted checkpoints and timed recovery snapshots remain checkpoints
  instead of being promoted into orphan session files, preventing duplicate
  `/resume` entries (PR #4963 by @SparkofSpike).

- Every shipped locale is admitted by the typed settings schema and native
  chooser, with complete/partial status kept independent and tested (PR #4856
  by @nightt5879, closing #4786). Context-menu hover hit-testing also accounts
  for its title row (PR #4897 by @XhesicaFrost; reported by @SparkofSpike in
  #4803).

- OSC 52 and SSH/tmux clipboard transport run on one bounded background worker
  rather than blocking input and rendering on the TUI loop; late transport
  failures still surface through the status path (PR #4896 by @nightt5879,
  closing #4159).

- Non-streaming model calls receive a generation-length response budget rather
  than the SSE header-open timeout, while actual SSE opens share the bounded
  cross-provider transport seam. The equivalent fix direction came from
  closed PR #4743 by @vibecoding-skills.

- Resumed sessions diagnose a deleted inherited workspace before shell launch
  instead of failing as an opaque Windows process error (report #4100 by
  @redjade75723). DeepSeek native tool-call wrapper tokens are also scrubbed
  from visible streaming and completed output as a grounded fail-soft follow-up
  to report #3880 by @hardy922; that report's exact emitted marker remained
  unconfirmed.

- Auto model routing now preserves the user's requested reasoning effort
  through startup, provider/model changes, session restore, the picker,
  Ctrl+T, and Hotbar actions. The tier is normalized only after the concrete
  provider route is known instead of being silently replaced by Auto
  (#4941, PR #4961 by @nightt5879).

- Auto-compaction now defaults on for every known model context window,
  including Kimi K3's 1,048,576-token routes. Persisting only an
  `auto_compact_threshold` or `auto_compact_threshold_percent` now counts as
  opt-in intent, while an explicit `auto_compact = false` remains authoritative.
  `/config` reports the effective state, percentage, and computed token trigger.

- Per-provider `context_window` overrides are now documented and visible in
  `/config`, provider setup help, diagnostics, and the example configuration.
  The effective override consistently drives preflight budgeting, the context
  meter, and compaction; this lets a user cap a 1M Kimi route to 256K when their
  Coding Plan tier has the smaller window.

- Agent Details now projects status, model, elapsed time, and step counts from
  the same row snapshot as the primary agents list, eliminating contradictory
  worker state between the two surfaces.

- Composer submission and its hints now share one state machine. Portable
  terminals use Enter to queue during a running turn and Enter again to steer;
  Ctrl/Cmd+Enter is accepted only when an enhanced terminal reports it and is
  no longer advertised as universally available.

- `edit_file` now matches LF-only model search text against CRLF files,
  preserves the file's line-ending style for replacement text, and still
  rejects newline-normalized duplicate matches as non-unique (#4764).
  Implemented in PR #4942 by @nightt5879; reported and root-caused by
  @LmeSzinc.

- `/fleet status` read the current TUI session's sub-agents while `codewhale
  fleet status` read the durable `.codewhale/fleet.jsonl` ledger — two different
  things wearing one name, so a run started by `codewhale fleet run` never
  appeared in the TUI. `/fleet status` now reads the durable ledger through the
  same code path as the CLI; the session view keeps its own name as
  `/fleet workers` (`/subagents` and `n` still work). When a workspace has no
  ledger, both surfaces report a typed `no_fleet_ledger` reason instead of an
  empty-looking "all clear", and neither creates the ledger as a side effect of
  reading it (#4022).

- `codewhale fleet status` (and `list`/`interrupt`/`resume`) created
  `.codewhale/fleet.jsonl` as a side effect of opening the manager, then
  reported `no_fleet_ledger` for the file it had just made — so the second
  invocation showed an empty Fleet where none existed. The CLI now refuses
  those verbs before the manager is constructed, matching `/fleet` (#4022).

- `fleet resume <run-id>` accepted any string. An id absent from the ledger
  reconciled nothing but still wrote a run-status record keyed by whatever was
  typed, and reported `no_change`. Unknown ids are now refused as `not_found`
  before any durable write (#4022).

- `lane interrupt` reported `transitioned` even when it changed nothing —
  another process's stop looked like our own. The Runtime backend now reports
  whether *this* call performed the transition, and a no-op is `no_change`.
  The `@<lifecycle-seq>` fence is also evaluated inside the registry's per-Lane
  lock rather than before it, so a stale fence refuses without running Runtime
  teardown instead of racing between the check and the stop (#1888).

- `/lane` no longer runs Runtime teardown on the TUI composer thread. Reads on
  the slash surface skip reconciliation (which probes tmux and takes a lock)
  and say so on the receipt instead of implying freshness; `lane interrupt` is
  CLI-only until that work runs off-thread, and reports
  `surface_not_supported` naming `codewhale lane interrupt` (#4022).

- The hotbar is no longer modelled as a third control surface. A slot binds a
  slash command and fires it with no argument, so it runs *as* the slash
  surface; the contract now declares which verb a bare press actually reaches
  (`hotbar_bare_dispatch`, true only for `lane.list`) instead of advertising
  target-taking verbs as hotbar-reachable (#1888).

- `codewhale lane list --json` and `lane status --json` keep emitting the
  `LaneRecord` shape they always have — the receipt did not replace it. The
  human `lane status` output also regained `branch`, `session`, `socket`,
  `attach`, and `log`, which the first cut of the shared DTO had dropped
  (#1888).

- No surface advertises a backend it does not have. `lane restart` and
  `lane resume` have no implementation — a Lane is re-created by
  `codewhale lane start`, and a stopped Lane's Runtime session is gone — so all
  three surfaces refuse them with `backend_not_implemented` and say why.
  `fleet restart` drives the manager loop to completion, which only the CLI
  runs, so `/fleet restart` reports `surface_not_supported` and names the CLI
  command rather than quietly doing a smaller thing (#1888).

- Deny rules in `permissions.toml` no longer miss a command because of an
  intervening flag: deny matching is token-based with flag-skipping and
  backtracking, so a `git push` rule still catches
  `git -c foo=bar push`. Path matching folds case only on platforms whose
  filesystems are case-insensitive, and the default approval branch no
  longer proposes the working directory as a network host.

- MCP tool calls run once. A failed call is no longer retried as if it
  were a failed lookup, qualified-name resolution collects every match and
  reports an ambiguity instead of taking whichever the hash map yielded
  first, and registering a server whose name collides with an existing one
  after sanitization is now an error rather than a silent overwrite.
  The equivalent call-once fix direction came from closed PR #4756 by
  @adity982.

- The session index survives a torn line: an unparseable entry is skipped
  rather than aborting the whole read, appends carry their data through to
  disk, and appends and compaction share a lock so a compaction can no
  longer race an append into a lost record.

- `Edit` counts as a write tool for workflow elevation, and the TUI's
  write/shell classification now delegates to one shared allowlist rather
  than keeping a second copy that could drift.

- A rejected `app/config/set` stays a no-op. Previously an invalid value
  still tore down the cached runtime bridge, killing the child runtime and
  orphaning every other in-flight stdio thread behind a response that
  correctly reported failure.

- A malformed project `config.toml` is no longer indistinguishable from
  having no project config. Because a project config may only *tighten*
  approval and sandbox policy, silently discarding a broken one dropped a
  repository's restrictions back to the looser user defaults; the setup
  wizard now says so, naming the file but never quoting its contents.

- An expired lane worktree no longer leaves its branch behind, which made
  reusing the same lane name fail with "branch already exists". A branch
  still carrying unmerged commits is kept — a TTL lapsing is not consent
  to delete someone's work.

- An in-flight `thread/message` turn can be stopped. The stdio loop keeps
  reading while a turn streams, so the new `thread/interrupt` request (and
  `shutdown`) can reach a runaway turn instead of waiting on the very turn
  they were meant to stop.

- Precedence is stated only in the constitution's "Whose word wins" section.
  Memory hygiene no longer ships an inverted Tier list that put the
  constitution above the user's current request; approval, compaction, and
  personality overlays describe behavior without rank vocabulary; and the
  authority recap points at the single source rather than restating a second
  ladder.

- `<turn_meta>` carries facts (mode, posture, model, workspace), not mode
  doctrine or permission-question essays re-asserted every user message.

- The project context pack (pretty-printed workspace tree) is off by default
  and opt-in via `[context] project_pack = true`. Language law is compressed
  while keeping the English-constitution / user-language-reply contract.

- Modal lists and config pickers wrap selection at both ends (Down past the
  last row returns to the top). Home-directory resolution prefers
  `HOME`/`USERPROFILE` via `effective_home_dir` across remaining call sites so
  Windows tests that fake the home env vars match production paths. The
  equivalent home-directory sweep came from closed PR #4760 by
  @EvanProgramming.

### Changed

- Prefix-cache tool catalog entries store only the SHA-256 digest, not the
  joined catalog string. Unused plan-transition validation helpers are removed.

- Settings sections now hold only what they claim (#4751). Fleet keeps
  Fleet/member concerns; `/goal` moved to a **Session** section and Workflow
  orchestration to its own **Workflow** section. The inert DeepSeek-only
  `default_model` fallback moved out of Model settings into an explicit
  **Legacy** section — exact-Fleet users switch Fleets, not fallback models;
  the config field is retained because the runtime still reads it. This is
  presentation only: the persisted keys (`goal_command`, `workflow`,
  `default_model`), their values, scopes, and runtime behavior are unchanged.

- Auto model routing is scoped to the active provider. The classifier
  inventory no longer discloses other providers' runnable routes (or the fact
  that their credentials exist), a classifier reply naming another provider is
  refused, the local heuristic no longer falls back to a different provider
  when the active one is unusable, and the implicit DeepSeek-flash classifier
  is skipped for non-DeepSeek sessions. Auto receipts and the model picker
  hint report the active-provider-only scope instead of "runnable providers".
  Cross-provider Auto is available only through the persisted `[auto]
  cross_provider = true` opt-in (an explicit `[auto.router]` route remains its
  own opt-in for the classifier call). Same-provider strong/fast selection and
  `[auto] cost_saving` are unchanged.

- The QA pseudo-terminal acceptance harness now parses frames with `rio-vt`
  behind its existing neutral frame/color surface, retaining the assertions
  while removing the `vt100` dependency (PR #4931 by @raphamorim).

- Anthropic Messages and OpenAI Responses stream opening now share the
  `client/stream_entry.rs` seam already used by Chat Completions: one bounded
  response-header wait, shared dual/HTTP-1.1 policy selection, at most one
  HTTP/1.1 fallback on a classified HTTP/2 header stall, and common idle-timeout
  diagnostics. Wire-specific authentication, headers, endpoints, decoding, and
  rate-limit behavior remain at each adapter edge. The timeout-placement
  diagnosis and fix direction came from closed PR #4743 by
  @vibecoding-skills.

### Security

- Release containers now publish an SBOM attestation and pin maximum-mode
  provenance explicitly so supply-chain metadata cannot silently weaken with a
  builder-default change (PR #4958 by @kobihikri).

## Contributors

Thank you to the contributors whose code, reports, and reviews shaped v0.9.2:

- [@greyfreedom](https://github.com/greyfreedom) — exact repository-scoped
  allow grants and cross-platform path semantics (PR #4761), plus safe
  permission-rule listing and snapshot-bound removal (PR #4960).
- [@nightt5879](https://github.com/nightt5879) — off-event-loop clipboard
  writes (PR #4896), complete locale exposure in settings (PR #4856), CRLF-safe
  edits (PR #4942), and reasoning-effort preservation across automatic model
  routing (PR #4961).
- [@XhesicaFrost](https://github.com/XhesicaFrost) — the configurable
  session-token header (PR #4610) and context-menu hover alignment (PR #4897).
- [@cyq1017](https://github.com/cyq1017) — the hooks configuration/executor
  split from PR #4087.
- [@snail-vs](https://github.com/snail-vs) (snailoniu) — OpenCode Zen's
  model-aware routes, authentication, documentation, and test isolation from
  closed PR #4467, whose contributor commits are preserved in the candidate.
- [@SparkofSpike](https://github.com/SparkofSpike) — the zh-Hans translation
  quality review harvested from PR #4908, duplicate-session fix in PR #4963,
  LaTeX implementation from PR #4973 landed through #4974, and the context-menu
  reproduction in #4803.
- [@GTC2080](https://github.com/GTC2080) — the request-preview concept from
  PR #1099.
- [@h3c-hexin](https://github.com/h3c-hexin) — non-UTF-8 `fetch_url`
  decoding direction from PR #4909.
- [@fleitz](https://github.com/fleitz) — required source-candidate credit for
  the canonical `Bash` no-`cwd` workspace fix and regression in PR #4673
  (issue #4674).
- [@LmeSzinc](https://github.com/LmeSzinc) — the Windows CRLF `edit_file`
  reproduction, root-cause analysis, and affected-code anchors in issue #4764.
- [@atmosuwiryo](https://github.com/atmosuwiryo) — ACP numeric-id compatibility
  (PR #4929) and the Indonesian documentation and website locale (PRs #4962
  and #4972).
- [@M-Maciej](https://github.com/M-Maciej) — the expanded-by-default reasoning
  setting and its original report (PR #4928, issue #4925).
- [@raphamorim](https://github.com/raphamorim) — migration of the QA PTY frame
  parser to `rio-vt` (PR #4931).
- [@LI-Jialu](https://github.com/LI-Jialu) — truthful finalization of restored
  stale shell cells (PR #4937).
- [@kobihikri](https://github.com/kobihikri) — release-container SBOM and
  explicit provenance mode (PR #4958).
- [@EvanProgramming](https://github.com/EvanProgramming),
  [@adity982](https://github.com/adity982), and
  [@vibecoding-skills](https://github.com/vibecoding-skills) — equivalent fix
  direction for the effective-home sweep (#4760), MCP call-once behavior
  (#4756), and streaming/non-streaming timeout split (#4743).
- [@antarikshraya](https://github.com/antarikshraya) — the LaTeX transcript
  rendering report in #4957.
- [@eugenicum](https://github.com/eugenicum) — the token-header request and
  output-presentation measurements in #4520 and #4468.
- [@whp233](https://github.com/whp233) — the StepFun/OpenCode subscription-route
  request in #4526.
- [@redjade75723](https://github.com/redjade75723),
  [@hardy922](https://github.com/hardy922),
  [@JayBeest](https://github.com/JayBeest),
  [@elijahchan2019](https://github.com/elijahchan2019),
  [@cy2311](https://github.com/cy2311), and
  [@wywsoor](https://github.com/wywsoor) — reports and product direction behind
  the stale-workspace diagnosis (#4100), native-tool-token filtering (#3880),
  contributor onboarding (#4227), optional reasoning highlight (#4089),
  session control (#2934), and export/restore correlation (#2494).

See [CHANGELOG.md](https://github.com/Hmbown/CodeWhale/blob/main/CHANGELOG.md) for full notes and [docs/CHANGELOG_ARCHIVE.md](https://github.com/Hmbown/CodeWhale/blob/main/docs/CHANGELOG_ARCHIVE.md) for older releases.