open/portfolio-optimiser-commons
1
0
Fork 0
Code Issues Releases Activity

docs(spec): ingest-spec.md — normative ingest layer contract (I1)

Browse source 
Framework-neutral specification of the deterministic ingest step that
materializes real data sources as OKF bundles in front of the loop:
polymorphic manifest schema (file/CSV, SQL, HTTP as optional extension
point), credential-reference rule, verdict-layer reservation + layer
separation, ingest provenance frontmatter with explicit timestamp,
index-generation requirement, and the golden-extraction format.
README contents list updated.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AaQCFnfsh3tfq1VfzdJpoi
This commit is contained in:
Kjell Tore Guttormsen 2026-07-03 14:03:59 +02:00
commit 7aa53fcf68
2 changed files with 286 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

6
README.md
View file

@ -31,6 +31,12 @@ so the only thing that differs is the agent framework itself.
IR projection + golden suite as the only ground truth, and the budget/provenance requirements.
The sibling implementation is built from this spec alone, without reverse-engineering the
reference code.
- [`ingest-spec.md`](ingest-spec.md) — the **normative ingest specification**, framework-neutral
(same guard rule as the method spec): the deterministic ingest step that materializes real
data sources as OKF bundles BEFORE the loop — the polymorphic manifest schema (file/CSV, SQL,
HTTP as extension point), the credential-reference rule, the verdict-layer reservation, the
ingest provenance frontmatter with an explicit timestamp, the index-generation requirement,
and the golden-extraction format.
## Rules