Spec: AI-first MCP interface phase (ledger-mcp, receipt store, capability parity)
This commit is contained in:
1 parent
ae61f02eb8
commit
a3fdc37f1d
1 file changed
+23
-16
+23
-16
@@ -24,22 +24,23 @@ first engine slice is built, tested, and green.
|
|||||||
|
|
||||||
## Next arcs (in order)
|
## Next arcs (in order)
|
||||||
|
|
||||||
1. **Period close** (R-FUTURE-2): fiscal periods, closing entries moving P&L
|
The project went AI-first on 2026-10-10 (Stephen's call): the primary
|
||||||
to retained earnings, locked periods. Parity: balance sheet then reports
|
interface is MCP, not a cloned GUI. The engine roadmap (period close, cash
|
||||||
retained earnings instead of folded current earnings.
|
flow, proptest) continues as needed, but the next *phase* is the interface:
|
||||||
2. **Cash flow, indirect method** (R-FUTURE-3): from P&L + balance-sheet
|
|
||||||
deltas. Golden-covered.
|
1. **`ledger-store`** (`docs/receipt-store.md`): SQLite persistence,
|
||||||
3. **Property tests graduate**: `proptest` with shrinking for the randomized
|
append-only triggers, TEXT amounts, event log, migrations,
|
||||||
invariant test; new properties for close and cash flow.
|
rebuild-from-log verify.
|
||||||
4. **GnuCash XML import** (R-FUTURE-4, read-only): parse GnuCash files into
|
2. **Blob store**: content-addressed receipts/documents, attachment metadata,
|
||||||
fixture books. This unblocks the oracle harness.
|
Drive backfill script.
|
||||||
5. **Oracle harness** (`ledger-oracle`, `cargo xtask oracle`): run fixture
|
3. **`ledger-mcp`** (`docs/mcp-interface.md`): stdio transport first;
|
||||||
books through our engine and GnuCash headless, diff snapshots
|
narrow tools with preview-before-post; digest; read-only resources; the
|
||||||
automatically. Parity catalog becomes machine-checked; CI enforces the
|
agent operating contract in the tool descriptions.
|
||||||
floor.
|
4. **Capability parity** (`docs/capability-parity.md`): build every specced
|
||||||
6. **egui app shell** (`books-app`): command-driven UI, native + WASM,
|
row, then the month-long parallel run against the GSheet; cutover per
|
||||||
screenshot-in-the-loop per the storytold protocol. Workflow parity catalog
|
the cutover rule.
|
||||||
(QuickBooks/Xero reference) starts here.
|
5. Then: oracle harness (GnuCash diff), read-only GUI on the event log,
|
||||||
|
workflow parity.
|
||||||
|
|
||||||
## Decisions log
|
## Decisions log
|
||||||
|
|
||||||
@@ -51,3 +52,9 @@ first engine slice is built, tested, and green.
|
|||||||
never prints "-0". (Caught by the golden test on day one; the oracle works.)
|
never prints "-0". (Caught by the golden test on day one; the oracle works.)
|
||||||
- 2026-10-10: License MIT OR Apache-2.0, matching the storytold projects.
|
- 2026-10-10: License MIT OR Apache-2.0, matching the storytold projects.
|
||||||
GnuCash clean-room boundary documented in `docs/oracle.md`.
|
GnuCash clean-room boundary documented in `docs/oracle.md`.
|
||||||
|
- 2026-10-10: AI-first pivot (Stephen). Primary interface is MCP
|
||||||
|
(`docs/mcp-interface.md`), not a cloned GUI. Receipts/documents become a
|
||||||
|
content-addressed blob store (`docs/receipt-store.md`). Parity target for
|
||||||
|
the phase is the GSheet+GDrive system (`docs/capability-parity.md`), with
|
||||||
|
a parallel-run cutover rule. GUI drops to read-only, event-log-driven,
|
||||||
|
phase 4.
|
||||||
Reference in new issue
Block a user