Release notes: v1.8.1

Why this release

v1.8.1 is a stability and operability hardening release focused on trustworthy day-2 operation: deterministic provider diagnostics, fail-closed MCP governance, docs reliability gates, internal TUI maintainability, and stronger local-model reliability behavior.

Top user-facing wins

  1. Provider preflight command: akmon doctor providers with actionable remediation and CI-friendly exit codes.
  2. MCP governance hardening with explicit server/tool policy dimensions and enriched audit context.
  3. Deterministic docs quality checks in CI (mdBook, links, CLI snippets, JSON snippets, fixtures).
  4. Local-model reliability improvements for Ollama (adaptive timeouts, unified status hints, clearer remediation).
  5. TUI internal state decomposition that improves maintainability without UX/command changes.

Upgrade notes

  • No CLI breaking changes in this release.
  • For configured policy + MCP environments, define explicit [mcp.servers] and [mcp.tools] allow rules.
  • For local-model-heavy workflows, warm models (ollama run <model>) before long tasks and use /clear when context becomes noisy.

Verification checklist

akmon doctor providers
akmon --output json doctor providers
akmon audit verify .akmon/audit/<session-id>.jsonl
akmon evidence verify .akmon/evidence/<session-id>.json
akmon slo verify .akmon/evidence/<session-id>.json --strict