Kjell Tore Guttormsen e03bd79876 feat(ingest): I3 — D7-speil av ingest (filkatalog/CSV), bygget fra commons-spec alene

Speiler MAF I2 fra shared/ingest-spec.md alene: manifest → CSV-konnektor →
materialisert OKF-bundle, byte-identisk med den delte golden-fasiten.

- ingest.py: ManifestContract (pydantic, fail-fast, file-kilde, verdict-reservasjon
  §3, id-grammatikk, max_rows), CSV-konnektor (boundary-checked fail-closed),
  materialisering (§5-frontmatter eksakt rekkefølge, markdown-tabell m/ escaping,
  LF-only, SHA-256 manifest-stamp), index-generering (§6), replacement §3/§5.
- okf.py: _parse_index_entry — tolererer frontmatterløs index (method-spec §3:
  index rendres via body = summary, ikke som typet concept-fil). Golden var
  spec-konform; D7-okf var strengere enn standarden. Scoped: non-index concept-
  filer krever fortsatt type (honesty-test).
- examples/ingest-golden-file/: repo-lokal golden (byte-frossen kopi av I2s fasit).
- Speiltester (I2s load-bearing-sett, alle detach-bevist røde): golden byte-fasit
  + mutasjonskontroller · provenance/navigability/verdict-reservasjon/re-ingest-safety
  · kontrakt fail-fast/max_rows/boundary/kollisjon · spec-integritet §11.
- docs/2026-07-04-I3-brief.md: brief + de to operatør-avgjorte beslutningene.

Suite 239 passed uten nøkkel/nettverk (189 + 50 nye) · ruff + mypy --strict rene.

[skip-docs] README + docs/extending.md er bevisst utsatt til I7 per sesjonsplan
(programmet batcher ingest-doc der, avgrenset til det D7 faktisk har — CSV nå,
SQL/HTTP senere). Endringen er dokumentert i docs/2026-07-04-I3-brief.md.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017MM6BWb1hWmJZuXFZ7rjxT

2026-07-04 06:12:43 +02:00

4.4 KiB

Raw Blame History

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)

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.)
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.

4.4 KiB Raw Blame History