portfolio-optimiser/docs/2026-08-26-katalogkostnaden.md

Katalogkallet — list_bundles() fra 112 116 til 362 tokens

Ordre: 20260825T213645Z-9019120455-from-.claude. Dato: 2026-08-26 (økt 65). Kode: src/portfolio_optimiser/explore.py (_index_excerpt, navigator_tools). Gate: tests/test_catalogue_cost_loadbearing.py (7 tester). Suite: 1066 passed / 5 skipped. Golden demo-transcript.stdout byte-uendret (ea8c534773acdbe41ae68f2c55724d69aaf8be4f).

Eksponerings-grense (arvet fra syretesten, holdt): dette repoet pusher til open/. Rapporten bærer kun tall, stier, kommandoer og egne observasjoner. Ingen bundle-fil er kopiert, og ingen kravtekst er gjengitt — alle konsept-tall er lengdemålinger, ikke innhold.

---

1. Instrumentet, validert før noe tall ble trodd

tiktoken.get_encoding("o200k_base") over json.dumps(list_bundles(), ensure_ascii=False), kjørt med uv run --with tiktoken (tiktoken er fortsatt ikke en prosjekt-avhengighet). Samme instrument som syretesten 25.08.

Kjent-positiv kontroll (Verifiseringsloven ansikt 4): de tre flate Vegnormal-basene målte 201 196 tegn / 112 116 tokens før endringen — tallet syretesten publiserte, reprodusert eksakt. Uten den kontrollen ville «etter»-tallet vært en måling ingen visste kunne treffe.

2. Før og etter, med nevner

Katalog	Baser (nevner)	Tegn før	Tokens før	Tegn etter	Tokens etter	Endring
Tre flate baser (syretestens sett)	3	201 196	112 116	877	362	−99,7 %
Grener, N100:2023	40	63 375	33 889	11 679	5 017	−85,2 %
Grener, N200:2024	99	134 667	71 726	28 894	12 396	−82,7 %
Grener, N500:2024	32	36 569	19 329	9 408	4 037	−79,1 %
Alle grener samlet	171	234 611	124 942	49 981	21 448	−82,8 %
kontroll: commons' tre eksempelbaser	3	11 050	3 472	989	321	−90,8 %

Per base: 731 → 125 tokens i grenformen, 37 372 → 121 i den flate.

Nevner-avvik mot ordren, uttalt: ordren oppgir 34 grener for N100:2023. Målt på disk (ls ~/repos/vegnormal-okf/build | grep -c '^B-n100-2023-gren-.*-importert$') er tallet 40. N200:2024 = 99 og N500:2024 = 32 stemmer. Tallene over bruker den målte nevneren, ikke ordrens.

Ordrens hypotese bekreftet: grenformen lukket bundle-siden og gjorde katalogsiden verre — 124 942 tokens over 171 grener mot 112 116 over tre flate baser. Etter endringen er hele maksimal-konfigurasjonen 21 448 tokens, altså under en femtedel av ett 128k-vindu.

3. Hva som ble endret, og hvorfor akkurat det

list_bundles returnerte Bundle.index_summary — hele rot-indeksens body — for hver konfigurert base samtidig, pluss ett JSON-objekt per ufulgt kryss-lenke. Begge vokser med korpuset. Prisen på å finne ut hvilke baser som finnes ble altså satt av hvor mye de basene inneholder. Det er progressiv disclosure snudd på hodet (målbilde §2/§4): katalogen er stigens billigste trinn, og den var loopens dyreste kall.

Hver oppføring er nå bundet ved konstruksjon: id, en ordrett prefiks av indeksbodyen på maks _CATALOGUE_EXCERPT_CHARS (200) tegn, index_truncated, documents, verdict_count, cost_baseline, unreachable_links. Kostnaden er O(baser), aldri O(korpus).

Et premiss ble felt FØR noe ble bygget på det. «Indeksbodyen forteller en manager hva basen handler om» er usant for maskin-importerte baser: grenbasenes index.md har verken frontmatter eller prosa — den er en ren lenkeliste (målt: B-n200-2024-gren-1-1-importert/index.md, 959 bytes, første tegn er -). Feltet var altså ikke bare dyrt, det var dyrt og innholdsløst der. En avkortet prefiks taper ingenting en manager brukte.

Tre valg, hvert med sin begrunnelse:

• Fast vindu, ikke en andel av basen. En andel ville skalert med korpuset igjen — bare med en mindre konstant. Mutasjon M8 (body[:len(body)//10]) er rød mot nettopp den formen.
• Avkorting ANNONSERES, som felt. index_truncated står ved siden av utdraget, ikke som en markør limt inn i det — samme grunn som BudgetExceeded bærer trippelen sin som felt (kø-(y)): en konsument som må re-parse prosa for å vite om den holder helheten, har fått en diagnostikk den ikke kan handle på. En base som passer blir ikke merket avkortet og får hele bodyen — omisjon, aldri en løgn i noen av retningene (M3 og M4 er begge røde, hver sin vei).
• En ufulgt kryss-lenke overlever som ANTALL. Fakta fra økt 51 («et hopp er tolerert, men ikke lenger taust») står; per-lenke-detaljen blir liggende der den er handlingsbar — på RunResult.skipped_links / DryRunReport.skipped_links — og rir ikke med i et kall hvis hele jobb er å være billig.

Hele indeksen er fortsatt ett read_file(id, "index.md") unna. Dette er et disclosure-nivå, ikke datatap.

4. Gaten

Taket (500 tegn per base) bor i testen, ikke i explore.py: en test som importerte implementasjonens budsjett ville flyttet seg med det, og å heve budsjettet er nøyaktig den regresjonen fila finnes for.

Syv armer: (a) taket over mange store baser · (b) kostnaden sporer ikke korpus-størrelse · (c) katalogen identifiserer fortsatt hver base — anti-vakuitets-armen, uten den består «returner bare id-ene» (a) perfekt · (d) avkorting annonsert, utdraget ordrett, begge retninger · (e) stigen er intakt, hele indeksen er ett kall unna · (f) ufulgte lenker overlever som antall · (g) kontrollen — én bases rå indeksbody alene sprenger taket for hele katalogen, så en grønn (a) betyr at bindingen fyrte, ikke at fixturen var liten.

Ni mutasjoner, alle røde mot HELE suiten, hver med sin egen signatur (grønn kontroll 1066/5):

#	Mutasjon	Røde tester
M1	ingen binding i det hele tatt (tilbake til hele bodyen)	4
M2	bundet, men vakuøst (utdraget tømt)	2
M3	avkorting ikke annonsert (stille kutt)	1
M4	over-annonsert (en hel indeks meldt avkortet)	1
M5	per-lenke-lista rir med igjen	1
M6	det ufulgte faktumet slettet	1
M7	bundet, men suffiks i stedet for ordrett prefiks	2
M8	en andel av basen i stedet for et fast vindu	2
M9	størrelses-signalet (documents) gjort konstant	1

M9 ble kjørt fordi documents var et felt uten gate — et felt ingen test kan se, råtner.

5. Grenser, uttalt

• MAJOR-1 (repeterbart --bundle-dir) var ikke nødvendig for dette. Bindingen sitter i verktøykroppen, bak en uendret CLI-flate. Operatørbeslutning 26.08: repeterbart --bundle-dir er nei — multi-base forblir bibliotek-partisjonen (run_mandate_across_bundles).
• navigate_bundle kalles fortsatt per base per katalogkall, altså leses hver fil på disk for å telle dokumenter og dommer. Det er I/O og veggklokke, ikke tokens, og er utenfor denne bestillingen — men det er ikke gratis ved 171 baser, og det er ikke målt her.
• Ingen levende modell har kalt det nye verktøyet. Formen er bevist offline; at en manager faktisk velger bedre med et utdrag enn med hele indeksen er ikke målt (samme klasse som structured-output-grensen).
• N101 er ikke berørt — utenfor bestillingen (operatørpresisering 26.08).