portfolio-optimiser-claude/docs/2026-07-10-sesjonsplan-d7.md

Sesjonsplan D7 — speilings-sesjoner + egne funn (C1.1–C4.0 · delt kø D-A–D-E)

Status: GJELDENDE sesjonsplan for dette repoet. Forfattet av kryssmodell-reviewen 2026-07-10 (Fable 5) — funn-referanser (C-F2/C-F3/C-F4/C-F5/C-F7, C-N1–C-N4, C-P1) peker til reviewen; MAF-referanser (F1–F14, D-A–D-E, S2.x/S3.x/S4.x) peker til hovedrepoets docs/review-2026-07.md og docs/plan/2026-07-10-sesjonsplan-fase2-6.md.

Beslutnings-køen D-A–D-E er DELT med MAF-søskenet (identisk semantikk som MAF-planens §2): beslutningene tas ÉN gang av operatøren, materialiseres som commons-amendments, og gjelder begge repo via PULL-ONLY subtree. Dette repoet planlegger INGEN egen variant av køen — kun bygg-sesjoner gated på den. C1.1/C2.0/C2.5 er byggbare NÅ (ingen beslutnings-avhengighet).

Prinsipp (uendret fra I-programmet): hver sesjon er én-sesjons-stor, offline, gratis (ScriptedClient), TDD (Iron Law), og Opus-eksekverbar med «Les STATE.md og følg instruksjonene». Ingen live-kjøringer: D6 står — S10 var programmets ene; ny spend krever eksplisitt operatør-godkjenning.

1. Den delte beslutnings-køen (operatør — tas i hovedrepoet, gjelder begge)

Beslutning	Innhold (MAF-planens §2, uendret)	Blokkerer HER
D-A	Spec-amendments i commons: (1) nominal-gate + band-invariant (F2/C-F2); (2) kostbaseline-stage (F3/C-F3); (3) /-lenker → bundle-rot (F4/C-F4); (4) per-verdict seeding (F5/C-F5); (5) Magentic-tekst (MAF-only)	C2.7, C2.8, C3.2, C4.0
D-B	Fase-2-scope vs frossen ingest-målbilde (live-kilde, doc-konnektor, MCP-grant)	ingenting her (MAF-scope; D7 speiler evt. ingest-spec-amendments når de lander i commons)
D-C	Vektor-store (§4.5): valg + DELT lagringsformat (.npy + jsonl er anbefalingen)	evt. C-semretrieval (ikke spesifisert her ennå) — se koblings-flagget under
D-D	Concurrency-/feilmodell	ingenting her i dag (ingen portefølje-sti); blir gate hvis D7 får portefølje-speil
D-E	Mål-semantikk + stack-paritet for ekte kjøring	M2-konfig på MAF-siden; her kun paritetsspørsmålet (§4.6)

Koblings-flagg til den delte køen (fra C-P1, MÅ tilbake til hovedrepoet): D-C som planlagt (cosine over tekst-embeddings) kolliderer med frossen method-spec §3 Steg 1 («structural, never textual»). D-C må enten få et D-A-punkt som amender ranking-regelen bevisst, eller re-scopes til strukturelle features. Uten det er S3.1 (MAF) og enhver D7-speiling uimplementerbar spec-konformt.

Commons-regel (alle spec-amendments): skrives i portfolio-optimiser-commons, pulles hit med git subtree pull --prefix=shared commons main --squash. ALDRI subtree push. Sammenligningsprotokoll-konsekvens: etter en D-A-amendment re-pinnes/pulles subtree i BEGGE repo og BEGGE suiter kjøres — aldri én side alene. Endres golden-bytene, re-fryses de koordinert i commons (D-A eier det); begge repo konsumerer fasit uendret.

2. Byggbare NÅ (ingen beslutnings-avhengighet)

C1.1 Method-spec-integritetsvakt (C-N1)

• Mål: §11-raden «Spec integrity» håndheves lokalt — spec-drift i subtree-synken fanges her.
• Scope: ny tests/test_method_spec_loadbearing.py etter test_ingest_spec_loadbearing.py- mønsteret: (1) spec-fila finnes; (2) forbidden-toolkits-liste (samme som ingest-vaktens); (3) §12-kontraktsfelt-dekning for feltene DENNE implementasjonen konsumerer (decision, rationale, id, proposal_features, affected_codes, measure_type, claimed_saving_nok, description, IR-feltene, golden-feltene, type, vokabular-verdiene). KUN testkode — ingen src-endring, ingen spec-endring.
• TDD: testen er selv vakten — RØD-bevis via mutert spec-KOPI i tmp_path (test-parametrisert mot kopi, aldri mot shared/): fjern et felt fra §12 → rød; injiser toolkit-navn → rød; slett fila → rød.
• Verifisering: uv run pytest tests/test_method_spec_loadbearing.py grønn; full gate (pytest/ruff/mypy) grønn; detach-bevis (mutasjons-parametrene) dokumentert i testen selv.

C2.0 Steg-7 kjøresti-inngang (C-N2)

• Mål: en skipbar inngang komponerer §5-sekvensen (merge inbox → seed → fold → run), så «a later run ingests it» er sant om en leverbar sti — ikke bare om primitivene.
• Scope: ny run.py (offline-testbar komposisjonsfunksjon compose_run_context(bundle_dir, inbox_dir=None, k=...) + tynn CLI med --bundle/--inbox/--out som gjenbruker contracts/meter/artifacts). run_s10.py forblir URØRT (fasit-sti, S10-artefaktene er frosne). README-avsnittet om inboxen oppdateres til å peke på den nye inngangen. IKKE: ny live-kjøring (CLI-en testes kun med ScriptedClient; SDK-klienten wires men eksekveres ikke i suiten).
• TDD: RØD: dom droppet i inbox-mappe → inngangens komponerte kontekst MÅ bære dommens markør (detach-punkt: fjern merge-kallet i komposisjonen → rød); kontroll: tom/ manglende inbox → base-kontekst uendret; RØD: rolledelingen — inngangen skriver ALDRI til inboxen (byte-sammenligning før/etter).
• Nøkkelantakelse (testes først): komposisjonen kan gjenbruke fold_experience/ merge_inbox_into_store uendret — ingen ny søm, kun wiring.
• Verifisering: ny testfil grønn; detach → rød; full gate grønn; grep -n "inbox" README.md viser claim som nå matcher en skipbar sti.

C2.5 Inbox-herding + SDK-versjonsvakt (C-F7, C-N3, C-S3-rester)

• Mål: inboxen slutter å være en uvalidert injeksjonsflate; SDK-attributt-premissene får en vakt som tvinger bevisst re-verifisering ved oppgradering.
• Scope: (1) merge_inbox_into_store/load_inbox: decision-vokabular-sjekk (ukjent decision → SKIP, fortsatt tolerant, aldri raise — §4.2-vokabularet {approved, rejected, approved_with_adjustment} på fil-laget), konfigurerbart tak på rationale-lengde + antall filer per merge (fail-fast ved overskridelse, aldri stille kutt); (2) pin claude-agent-sdk>=0.2,<0.3 i pyproject; (3) versjonsvakt-test som feiler med handlingsrettet melding når installert SDK-versjon ikke matcher pinnet serie (premissene i sdk_client.py:12-17 må re-verifiseres bevisst); (4) vurder _total_tokens-strictness (delsum ved felt-drift — dokumentér valget i docstring).
• TDD: RØD: inbox-fil med decision: "hva-som-helst" når ALDRI storen (detach vokabular-sjekken → den entrer → rød — reviewens kjørte bevis blir testens fixture); RØD: rationale > tak → skip/feil per valgt semantikk; RØD: versjonsvakt mot fake-versjon.
• Verifisering: nye tester grønne + detach → rød; full gate grønn; eksisterende step7-suite uendret grønn (tolerant-lasting består).

3. Speilings-sesjoner (gated: D-A + commons-pull — startes IKKE før amendment er pullet)

Felles mal (= MAF-planens S2.7/S3.2/S4.0-mal): amendment lander i commons → subtree-pull → failing test først (moteksemplene fra reviewen ER test-fixturene) → impl → detach-bevis → full gate → golden-regresjon uendret (eller koordinert re-frosset i commons FØRST).

C2.7 Validator-stramming (C-F2; gated: D-A pkt. 1)

• Scope: (a) strukturell blokk claimed > nominal_feasible → Rejection (i tillegg til p90); (b) IR-invariant: hvert band MÅ omslutte itemets unit_cost (Pydantic model_validator). IKKE: kostbaseline (C4.0).
• Premiss (VERIFISERT 2026-07-10 av reviewer): golden- og fixture-kompatibel her — alle ikke-tomme bands omslutter unit_cost; golden-claim 30 000 ≤ nominal 90 000.
• TDD: RØD: reviewens moteksempel #1 (claim 100k, nominal 90k, band [0.70,1.40]) → MÅ bli Rejection; RØD: band [1.8,2.2] rundt unit_cost 1.0 → ValidationError ved konstruksjon; detach nominal-blokken → moteksempel-testen rød.
• Filer: validator.py, ir.py, tests/test_validator.py, tests/test_ir.py; tests/test_bygg_energi_mikro.py uendret grønn (regresjonsbevis).
• Verifisering: uv run pytest tests/test_validator.py tests/test_ir.py tests/test_bygg_energi_mikro.py grønn; golden uendret; full gate grønn.

C2.8 OKF /-lenke-mapping (C-F4; gated: D-A pkt. 3)

• Scope: ledende / i cross-link-mål mappes til bundle-rot i navigate_bundle; boundary-sjekken består fail-closed (subkatalog-policy følger amendmentens ordlyd).
• TDD: RØD: bundle med ](/tiltak.md) → tiltaket navigeres og renders (detach mappingen → kun index → rød); RØD: ](/../escape.md) → fortsatt skippet (boundary består); eksisterende skip-tester oppdateres KUN slik amendmenten krever.
• Filer: okf.py, tests/test_okf.py. Merk: MAF-siden mangler i dag en tilsvarende bygg-sesjon for F4 — flagget i reviewen §1 C-F4; operatøren bør legge den til der.
• Verifisering: nye tester grønne + detach → rød; full gate grønn; golden-bundelen navigerer uendret.

C3.2 Per-verdict seeding (C-F5; gated: D-A pkt. 4)

• Scope: seed_store_from_bundle leser features fra verdict-filas EGEN frontmatter (nye valgfrie felt affected_codes/measure_type/claimed_saving_nok; fallback = dagens bundle-projeksjon for bakoverkompatibilitet); promote skriver feltene. Multi-kandidat- fixture repo-lokalt (aldri i shared/ uten commons-endring).
• TDD: RØD: to kandidater i én bundle → dom om B når ALDRI As hypotese-prompt via retrieval på As features (detach per-verdict-nøklingen → feil-folding → rød — reviewens F5-bevis blir fixturen); eksisterende step1/step7/step8 uendret grønne (fallback).
• Filer: experience.py, promotion.py, tests/test_step1_expel_loadbearing.py, tests/test_step8_promotion_loadbearing.py, ny fixture + tester.
• Verifisering: nye tester grønne + detach → rød; full gate grønn.

C4.0 Kostbaseline-forankring (C-F3; gated: D-A pkt. 2)

• Scope: baseline-projeksjon i bundle (cost-baseline.json, commons-amendment/fixture)
  • fail-closed avstemmings-stage i validate_proposal (ukjent kode → Rejection; quantity/unit_cost utenfor toleranse → Rejection; toleranse konfig). Baseline-argumentet VALGFRITT (None = dagens oppførsel) så eksisterende suite står — men kjøresti-inngangen (C2.0) SETTER den når fila finnes i bundelen. Ingest-laget er den naturlige produsenten av projeksjonen (egen liten oppfølging hvis commons definerer format).
• TDD: RØD: reviewens F3-moteksempel (diktet kode, 10 MNOK) → Rejection «unknown cost code» (detach avstemmingen → validated → rød); kontroll: ekte baseline-linje validerer som før; golden-bundelen (uten baseline-fil) validerer uendret.
• Filer: validator.py, okf.py/ir.py (loader, fail-fast ved malformet fil — tolerant ved fraværende), commons-fixture, nye tester.
• Verifisering: nye tester grønne + detach → rød; golden uendret; full gate grønn. MÅ være grønn før enhver eventuell fremtidig live-kjøring i dette repoet.

4. Valgfri / lav prioritet (ubesluttet — foreslått, ikke godkjent)

• C3.5 Budsjett-guard (C-N4): pre-call-sjekk i loop-laget (nekt kall når rest-tak < 0)
  • eksplisitt run-total USD-grense over SdkModelClient.total_cost_usd. Mest verd rett før en eventuell ny live-kjøring; ingen gate.

Overføres IKKE hit (MAF-spesifikt): S2.0-portefølje, S2.1-outbox (output-laget finnes her: artifacts.py), S2.2 MCP-konnektor, S2.3 doc-konnektor, S2.4 http-herding, S3.1/S3.3/ S3.4, S4.1/S4.2-Foundry, S5.x, M1–M3. extending.md står: ingen D7-HTTP/MCP-økt planlagt.

5. Anbefalt sekvens

1. C1.1 → C2.5 → C2.0 (autonome, ingen gate — i den rekkefølgen: vakt først, herding, så ny kjøresti-inngang som drar nytte av herdet inbox)
2. Operatør: D-A (i hovedrepoet; ta C-P1-koblingsflagget med i samme bolk) → commons- amendment → subtree-pull HER
3. C2.7 → C2.8 → C3.2 → C4.0 (etter pull; C2.7 først — minst avhengigheter, størst spec-verdi)
4. Etter hver amendment-bølge: begge repo re-pinnes/pulles og begge suiter kjøres (sammenligningsprotokollen) — aldri én side alene.