docs(readme): Contents lister alle fem eksempelbundler — veglys + tunnel var usynlige

README-ens Contents-seksjon listet tre av fem kataloger under examples/.
tunnel-hauglia og veglys-fv-soer — de to bundlene i realistisk skala — sto
ikke på første skjerm, og mangelen var ført som known limitation i den
publiserte v0.1.0-releasen.

To bullets i samme mønster som den eksisterende bygg-energi-mikro-oppføringen.
Ingen versjonsbump, ingen tag.

Verifisert: `grep -o 'examples/[a-z-]*/' README.md | sort -u` gir nå de samme
fem navnene som `ls -d examples/*/` — sett-likhet, ikke bare antall.

Ordre: 20260821T093259Z-1033122789-from-portfolio-optimiser-commons

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-08-23 21:26:21 +02:00
commit 6b39f3bdee

View file

@ -38,6 +38,20 @@ specifications alone, without reverse-engineering the reference code.
bundle (OKF / LLM-wiki): one office building, one LED-retrofit measure, with a seed expert
verdict encoding the realization gap and a golden-suite of expected validator outcomes. A small
**dev fixture** for exercising the agentic loop; a realistic full-scale example comes later.
- [`examples/veglys-fv-soer/`](examples/veglys-fv-soer/) — an example knowledge bundle at realistic
scale: a county-road street-lighting portfolio with two candidate measures (LED replacement of
2 500 of 9 500 HPS luminaires, and adaptive control), a seed expert verdict, the IR projection
the deterministic validator reads, and the project's cost baseline. The realization gap is a
parameter error — burn hours overestimated — on a Norwegian evidence base where many
installations have no metering at all. Project layer fictional, literature layer real and cited.
Written in Norwegian.
- [`examples/tunnel-hauglia/`](examples/tunnel-hauglia/) — an example knowledge bundle at realistic
scale, same file layout as the veglys bundle: a two-tube road tunnel with two candidate measures
(3-step to 13-step dimming of the entrance and transition zones, and passive portal screening).
Its realization gap arises in operation rather than in the parameters, so the seed verdict carries
`gap_source: control-tracking-overestimation` where both bygg-energi-mikro and veglys-fv-soer
carry `hours-of-use-overestimation` — a second gap class, so a learning loop exercised here has seen
more than one cause. Project layer fictional, literature layer real and cited. Written in Norwegian.
- [`examples/nav-golden-hierarchy/`](examples/nav-golden-hierarchy/) and
[`examples/nav-golden-escape/`](examples/nav-golden-escape/) — the **nav-golden** fixture class:
`bundle/` in, `expected-read-context.md` out, exercising the navigation contract (method-spec §3