portfolio-optimiser-claude/docs/2026-07-04-I7-brief.md
Kjell Tore Guttormsen 880f00f305 docs(brief): the plan reference must not be a link only this machine can follow
The repo-standard gate SKIPs a link that leaves the repository — and a SKIP is
"not measured", never a pass. This one left it into `/Users/ktg/repos/...`, so
for every reader but the operator it was a dead click dressed as a citation.

The reference itself is correct and stays: the programme plans deliberately
live in the sibling repo (CLAUDE.md). Only the link form goes, replaced by the
repo name plus the path inside it — which a stranger can act on and this
machine's layout can no longer invalidate.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Gu3n2PVVnb9fZDCe2wnU1h
2026-08-04 11:55:17 +02:00

47 lines
2.4 KiB
Markdown

# I7-brief (D7) — program-avslutning: dokumentasjon + statusrapport
> **Type:** docs-avslutning, **ingen ny kode**. Komprimert pipeline (ingen
> research/plan/execute-runder — deterministisk docs-oppgave). Forankret i sesjonsplan
> §I7 (søsken-repoet `portfolio-optimiser`, `docs/plan/2026-07-03-sesjonsplan-ingest.md`) og
> STATE-ens «når I7 åpnes»-oppskrift.
## Kontekst / gate
I7 var GATET på at MAF lander **I6** (HTTP/MCP demonstrert MAF-only mot lokal mock, bak
opt-in-nettverksflagget). Gaten er **oppfylt**: MAF I6 landet (commits `58dda46``696f19a`,
review `72cb15f`, WARN akseptert). Bekreftet ved `git -C …/portfolio-optimiser log`
**kun eksistens**, ingen lesing/reverse-engineering av MAF-koden.
## Scope (denne økta rører KUN dette repoet)
1. **README.md** — flett inn ingest-laget (CSV + SQL) som post-S10-tillegg; oppdater
testtall (187 → 265); HTTP/MCP kun som peker (D7 har ingen HTTP-konnektor).
2. **`docs/extending.md`** (ny) — avgrenset til det D7 faktisk har: `file` (CSV) + `sql`
(sqlite RO). Hvordan legge til en kildetype. HTTP/MCP KUN som peker: spec §4-skjema +
MAF-søskenets I6-demonstrasjon + SDK-primitivet `create_sdk_mcp_server` som *ubygd*
vehikkel (D7-`src/` bruker det ingen steder; `ingest.py` er ren stdlib).
3. **Grep-sjekk mot overpåstand** før commit.
4. **Norsk statusrapport** med verifiseringslogg (hver påstand → kommando/kilde).
## Ærlighetsregelen (ufravikelig, method-spec §1 / ingest-spec §1)
Ingen artefakt påstår:
- HTTP/MCP-**støtte i D7** (D7 avviser `http`-manifest fail-fast — testbevist
`test_malformed_manifest_is_rejected`).
- **Live-kilde-integrasjon** (ingest gjør null modellkall, null nettverk; testene kjører
uten nøkkel/nettverk).
- Mer live-atferd enn den ENE dokumenterte S10-kjøringen (uendret påstand).
## Verifisering (øktas suksesskriterier)
- `uv run pytest -q`**265 passed** uten nøkkel/nettverk.
- Grep: ingen artefakt påstår HTTP/MCP-støtte i D7 eller live-kilde-integrasjon.
- `uv run ruff check .` + `uv run mypy src` grønne (docs-only, men suite + lint holdes grønn).
- Statusrapport med verifiseringslogg levert.
## Ikke i scope (gated på operatør)
- Åpent-speil-synk (`open/…`) av I3+I5+I7-koden — egen outward-facing operatør-handling.
- LICENSE / S12-release.
- Kryss-stack-sluttkriteriet (begge stacker identiske golden) eies av MAF-programrapporten;
denne D7-rapporten peker dit i stedet for å duplisere.