HZR 0.3.8

HZR 0.3.8 — CLI clarity and workspace-aware diagnostics

HZR 0.3.8 improves day-to-day operator visibility without changing the honest-accounting or
bounded-output contracts from 0.3.7. The CLI explains itself better, doctor surfaces actionable
next steps and index readiness, MCP registrations pin to the selected workspace, and project-scoped
provider receipts can be matched to a workspace filter in hzr stats.

The release also adds non-destructive update discovery, a first-class activation status command,
and documentation that matches the current memory hygiene surface.

What changed

• Root hzr --help groups commands (Setup, Runtime, Search & Memory, Agent tools, Distribution,
  Legacy), fills global and common flag help, adds an Examples footer, and applies light HZR orange
  styling.
• High-traffic subcommands (update, stats, enable/disable, doctor, agent, mcp,
  memory leaves) gain long_about text and Examples footers.
• hzr update --check reports whether a newer GitHub release is available without downloading or
  installing. Exit 0 when the check succeeds; non-zero only on failure.
• hzr activation status lists project-only activation mode and enabled workspace roots in human
  and --json form.
• hzr install and hzr mcp config --apply pin MCP registrations with
  mcp serve --workspace <dir> so Desktop and Codex memory are not bound to /.
• hzr doctor warns when Claude Code has no HZR MCP registration and prints the
  claude mcp add remediation.
• hzr doctor human output separates permanent host limits (*_global_codec) as NOTE and lists
  actionable remediations under Next actions:. The JSON schema is unchanged.
• hzr doctor reports index_readiness when the semantic index is missing or not yet warm, with
  remediation to hzr index init or wait for the hzrd watcher.
• Provider usage receipts may carry a workspace project_path. hzr stats --workspace labels
  matching receipts project_matched and omits older unscoped rows from project provider totals;
  the global lifetime view still includes every receipt. Estimated savings remain separate from
  billed provider counters.
• hzr stats always shows the MCP channel in coverage, including mcp=0 when there was no MCP
  traffic.
• README and known-gap text no longer claim that memory forget, update, or prune are absent. The
  basic command list now documents hzr memory forget|update|prune alongside recall, store, and
  status, plus enable/disable where relevant.

Upgrade impact

No ledger, index, memory, or activation rewrite is required. Existing MCP registrations are not
mutated automatically; re-run hzr install or hzr mcp config --apply when you want workspace-pinned
registrations. Provider receipts written before this release remain global-only in project-scoped
stats until new scoped receipts arrive.

Upgrade and verify with:

hzr update
hzr --version
hzr activation status
hzr doctor --workspace .
hzr stats

Restart already-open agent sessions after upgrading so they reload managed hook and MCP contracts.

Verification

The release was checked with:

cargo fmt --all -- --check
cargo clippy --all-targets --all-features -- -D warnings
cargo test --all-targets --all-features
scripts/verify-fork-core.sh --test
cd integrations/caveman-code && npm ci --ignore-scripts && node --test bridge.test.mjs
cd visualizer && bun run typecheck && bun test
scripts/smoke-install.sh /path/to/hzr.tar.gz /path/to/SHA256SUMS

The fork-core gate passed 1717 tests with one intentionally ignored test and matched the reviewed
141-warning inherited Clippy ratchet. The packaged smoke passed clean installation, project-only
activation, same-version re-attestation, tamper rejection, and upgrade/rollback checks. Provider-backed
benchmarks were not regenerated because this release changes CLI visibility and workspace attribution,
not model fidelity or billed-token measurement.