open/portfolio-optimiser
1
0
Fork 0
Code Issues Releases 3 Activity

Merge commit '74008aebfe'

Browse source
This commit is contained in:
Kjell Tore Guttormsen 2026-09-02 21:16:39 +02:00
commit 21c476bbe7
13 changed files with 693 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

18
shared/README.md
View file

@ -37,7 +37,23 @@ specifications alone, without reverse-engineering the reference code.
- [`examples/bygg-energi-mikro/`](examples/bygg-energi-mikro/) — the first example knowledge
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.
**dev fixture** for exercising the agentic loop; the two full-scale bundles below
([`veglys-fv-soer`](examples/veglys-fv-soer/), [`tunnel-hauglia`](examples/tunnel-hauglia/))
are the realistic ones.
- [`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