Architecture

How evidence becomes an answer

The design separates facts, operational choices, deterministic read models, and agent explanations so one failure does not quietly become financial truth.

D1 holds the record

The reusable contracts assume append-only observations and explicit effective views, not in-place correction of provider facts.

MCP carries the evidence

Tool results state freshness, coverage, status, provenance, and limitations beside the requested data.

Agents stay outside the math

A steward can retry derived work or investigate a case. It cannot make an unsupported row real.