# I3 — D7-speil av ingest (filkatalog/CSV) — brief

> Forankret i hovedrepoets sesjonsplan
> `~/repos/portfolio-optimiser/docs/plan/2026-07-03-sesjonsplan-ingest.md` §I3 og dette
> repoets STATE. Bygget **fra `shared/ingest-spec.md` alene** (subtree-pull fra commons) —
> aldri ved reverse-engineering av MAF-koden. Golden-**bytene** (den delte fasiten) er lest,
> siden spec §11 gjør dem til konformanskravet begge stacker reproduserer.

## Mål (§I3)

Samme ingest-kontrakt konsumert **uendret** fra commons i dette søskenrepoet — beviser at
ingest-spec-en faktisk er delt: D7s uavhengige impl reproduserer MAF I2s golden **byte-identisk**
fra spec alene. Scope = `file`-kildetypen (lokal CSV-katalog). `sql` = senere (I5), `http` =
ikke i D7 (målbildet: HTTP/MCP demonstreres MAF-only, I6).

## To beslutninger (operatør-avgjort denne økta)

1. **Golden-fasit: repo-lokal kopi.** I2 la ingest-golden repo-lokalt (`examples/ingest-golden-file`,
   ulikt method-golden i `shared/examples/`). D7 speiler mønsteret: kopi i dette repoets
   `examples/ingest-golden-file/`, speiltest peker dit. Holder I3 som én lukket økt, ingen
   commons-runde. (Alternativ — løfte golden til commons — avvist: egen GATET runde + avvik fra
   I2-mønsteret.)

2. **okf relaksert for frontmatterløs index (følg standarden).** Funn: den delte golden-ens
   `index.md` har **ingen** frontmatter; D7s `okf.navigate_bundle` krevde det → kunne ikke både
   reprodusere golden byte-identisk OG navigere den med uendret okf. **method-spec §3 Step 1 er
   avgjørende:** «the rendered read-context is *the index body (the summary)* followed by each
   *non-index concept file* as a `## {type}: {title}` section» — standarden behandler index via
   sin *body*, ikke som en typet concept-fil. Golden-en er altså spec-konform; D7s okf var
   **strengere enn standarden**. Fix: `okf` tolererer nå frontmatterløs index (hele fila = body,
   `type` defaulter til `index`); frontmatter-ful kuratert index parses uendret; non-index
   concept-filer krever fortsatt `type` (relaksasjonen er scoped, bevist av egen honesty-test).
   (Alternativ — «typet index overalt» via commons-RFC + MAF golden-regen — avvist: omskriver
   standarden for å romme en D7-quirk, endrer frossen fasit, flerrepo GATET.)

## Leveranse

- `examples/ingest-golden-file/` — repo-lokal golden (kopi av I2s, byte-frossen).
- `src/portfolio_optimiser_claude/ingest.py` — `ManifestContract` (pydantic, fail-fast,
  `file`-kilde, verdict-reservasjon §3, id-grammatikk, `max_rows`>0), CSV-konnektor
  (boundary-checked fail-closed), materialisering (§5-frontmatter i eksakt rekkefølge,
  markdown-tabell m/ §5-escaping, LF-only, SHA-256 manifest-stamp), index-generering (§6),
  replacement-semantikk (§3/§5).
- `src/…/okf.py` — `_parse_index_entry` (frontmatterløs index-toleranse, method-spec §3).
- Speiltester (I2s load-bearing-sett): `test_ingest_golden.py` (byte-fasit + 3 mutasjonskontroller),
  `test_ingest_loadbearing.py` (provenance / navigability / verdict-reservasjon / re-ingest-safety),
  `test_ingest.py` (kontrakt fail-fast, max_rows, boundary, kollisjon, escaping),
  `test_ingest_spec_loadbearing.py` (spec-integritet §11: fil finnes · navngir ingen toolkit ·
  dokumenterer hvert kontrakt-felt) — D7-analogen til MAFs I1-guard.

## SDK-kroker (STATE steg 4 — søk-først)

I3 (filkatalog/CSV) introduserer **ingen SDK-flate**: ingest er deterministisk, null modellkall.
Søk-først SDK-krok-reverifisering (API-drift på `create_sdk_mcp_server`) er relevant for I6
(HTTP/MCP), ikke I3 — utsatt dit kroken faktisk brukes. Eksisterende SDK-klient (`sdk_client.py`,
`test_sdk_isolation.py`) uendret og grønn i suiten.

## Verifisering (kjørt, grønn)

- Golden **byte-identisk** konsumert (5/5, inkl. idempotens + mutasjonskontroller).
- Speiltester **røde ved detach** — alle fire sømmer bevist load-bearing (detach-bevis-skript).
- Søskensuite **grønn uten nøkkel/nettverk**: 239 passed (189 + 50 nye).
- `ruff check` + `ruff format` rene · `mypy --strict src`: no issues (16 filer).

## Åpent (forslag, ikke utført — utenfor I3-scope)

- **Standard-evolusjon:** vil operatøren senere ha «alle bundle-filer er typede concept-filer»
  (typet index overalt) som bevisst OKF-endring, er det en egen koordinert commons-RFC (begge
  specs, begge golden, begge okf). Dagens permissive okf er forover-kompatibel med det.