2026-09-13 22:42:09 +02:00
|
|
|
# Evidence ledger
|
|
|
|
|
|
|
|
|
|
`observations/<sha256>.json` contains immutable envelopes created by the CLI.
|
|
|
|
|
Each envelope stores a validated record and SHA-256 of its canonical JSON.
|
|
|
|
|
Source content is represented by its own hash; retain source artifacts separately
|
|
|
|
|
where permitted. Hashes provide integrity, not truth. Corrections are new records
|
|
|
|
|
with `supersedes` pointing to the prior observation ID, leaving history intact.
|
|
|
|
|
|
|
|
|
|
No model scores or prices from the explorations have been accepted as observations.
|
|
|
|
|
Synthetic fixtures live in `examples/` and are used only in temporary demo storage.
|
2026-09-13 23:07:41 +02:00
|
|
|
|
|
|
|
|
## v0.2 stores
|
|
|
|
|
|
|
|
|
|
- captures: immutable retrieval metadata; artifacts: exact original source bytes.
|
|
|
|
|
- ingestion-runs: per-source collection health.
|
|
|
|
|
- recommendations: frozen task/catalog/policy/outcomes/report snapshots.
|
|
|
|
|
- outcomes: unique real or explicitly synthetic execution results.
|
|
|
|
|
- scheduler-runs: durable daily/weekly job receipts.
|
|
|
|
|
|
|
|
|
|
Synthetic advisor demonstrations use temporary directories. The retained real
|
|
|
|
|
comparison explicitly lacks verified benchmark results and requester access.
|
|
|
|
|
Preserve artifacts with captures; replay verifies their content hashes.
|
