Docs: refresh for public repo — rewrite README, update roadmap/STATUS/requirements

plan/roadmap.md

@@ -3,57 +3,50 @@
 ## Phase 1 — Semantics core (done)
 
 The engine: money, accounts, journal, ledger commands, trial balance, P&L,
-balance sheet, golden files, property tests, and the docs an agent needs to
+balance sheet, cash flow, fixed assets with depreciation, golden files,
-work here (AGENTS.md, requirements, architecture, oracle, parity, glossary).
+property tests, mutation testing, fuzzing, and the docs an agent needs to
-Parity floor: 6 done.
+work here. Parity floor: 12 done.
 
-## Phase 2 — AI-first interface (now)
+## Phase 2 — AI-first interface (done)
 
 The primary interface is MCP, not a cloned GUI (Stephen's call, 2026-10-10).
 
-- `ledger-store`: SQLite persistence, append-only triggers, amounts as TEXT,
+- `ledger-store`: append-only hash-chained JSONL journal (source of truth),
-  event log, migrations, rebuild-from-log verify. Spec: `docs/receipt-store.md`.
+  SQLite as disposable projection with auto-rebuild, content-addressed
-- Blob store: content-addressed receipts and documents, attachment metadata,
+  blob store, durable drafts.
-  Drive backfill script.
+- `ledger-mcp`: 27 tools over stdio and Streamable HTTP, preview-before-post,
-- `ledger-mcp`: stdio transport first, Streamable HTTP later; narrow tools,
+  server-side receipt policy (>$25) with anti-splitting, asset management,
-  preview-before-post, digest, read-only resources, the agent operating
+  digest for human review, read-only resources.
-  contract in the tool descriptions. Spec: `docs/mcp-interface.md`.
+- `ledger-import`: QuickBooks CSV import (bank, chart), IIF and XLSX export.
-- Capability parity vs the GSheet+GDrive system: `docs/capability-parity.md`.
+- Capability parity 12 of 12 vs the GSheet+GDrive system.
-- Parallel run with the sheet; cutover per the cutover rule.
+- Parallel run with the sheet; cutover per the cutover rule
-- Done when: every specced capability-parity row is covered, a month of
+  (`docs/parallel-run.md`).
-  parallel run diffs clean, Stephen approves the cutover.
 
-## Phase 3 — Oracle harness
+## Phase 3 — Oracle harness (next)
 
-- `ledger-import`: QuickBooks CSV read-only import (bank transactions, chart
+- `ledger-oracle`: fixture books through our engine and GnuCash headless,
-  of accounts)
+  automatic `snapshot()` diffing.
-- `ledger-export`: CSV, XLSX, and IIF renderers (IIF for QuickBooks Desktop,
-  which many CPAs still run)
-- `ledger-oracle`: fixture books through our engine and GnuCash headless
-  (fed via QIF/OFX or its Python bindings — mechanism TBD at implementation),
-  automatic `snapshot()` diffing via `cargo xtask oracle`
 - Parity catalog becomes machine-readable; CI enforces the non-regression
-  floor
+  floor.
 - Done when: a fixture book produces byte-identical snapshots from both
-  engines with zero manual steps
+  engines with zero manual steps.
 
 ## Phase 4 — Read-only GUI
 
-- Consumes the `ledger-store` event log: live updates via tail/SSE — the
+- Consumes the `ledger-store` event log: live updates — the answer to
-  answer to "watch its files to update live."
+  "watch its files to update live."
 - egui or web; a dumb client holding no accounting logic.
 - This is the trust layer for humans (Stephen, Kat, the CPA), not the
   primary interface. Read-only at first; editing stays with the agent.
 
 ## Phase 5 — Workflow parity
 
-- A/R and A/P workflows, bank reconciliation, budgets, scheduled transactions
+- A/R and A/P workflows, bank reconciliation, budgets, scheduled transactions.
-- Multi-currency with FX translation
+- Multi-currency with FX translation.
-- Period close and cash flow (engine R-FUTURE items) land as their phases
+- Period close.
-  demand, not before
 - The goal: a self-hosted bookkeeping system with a tested claim to
   semantic parity with GnuCash and capability parity with the old
-  GSheet+GDrive workflow — no SaaS subscription required
+  GSheet+GDrive workflow — no SaaS subscription required.
 
 ## Explicitly not on the roadmap