open/portfolio-optimiser-commons
1
0
Fork 0
Code Issues Releases 1 Activity
1 release 1 tag
  • v0.1.0 fecdb97f1b

    v0.1.0 — framework-neutral shared core Stable

    ktg released this 2026-08-17 11:33:38 +00:00 | 0 commits to main since this release

    No known key found for this signature in database

    Det framework-nøytrale delte kjernen av portfolio-optimiser-metoden: de normative spesifikasjonene, eksempelbundlene og golden-fixturene som begge referanseimplementasjonene konsumerer som git subtree under shared/.

    Dette er repoets første taggede snitt. Det bærer hele innholdet akkumulert siden 2026-06-26, publisert på open/ siden 2026-08-04; ingenting her er nytt i forhold til main ved 73136eb.

    Innhold

    • method-spec.md — den normative, framework-nøytrale metodespesifikasjonen: 8-stegs-loopen, verdict-JSON-kontrakten, inbox/outbox-mappekontrakten, promoteringsportens semantikk, IR-projeksjonen og golden-suiten som eneste fasit, samt budsjett- og provenance-kravene.
    • ingest-spec.md — den normative ingest-spesifikasjonen: det deterministiske steget som materialiserer reelle datakilder som OKF-bundler før loopen, med det polymorfe manifest-skjemaet (file/sql påkrevd, http valgfritt utvidelsespunkt), credential-referanseregelen, provenance-frontmatteret og golden-ekstraksjonsformatet.
    • CONCEPT.md — forretningskonseptet for en ikke-spesialist, på norsk.
    • skills/expert-reviewer/ — expert-reviewer-personaen som framework-nøytral Agent Skill.
    • Fem OKF-eksempelbundler — bygg-energi-mikro (dev-fixture med golden-suite), de fullskala veglys-fv-soer og tunnel-hauglia, og nav-golden-paret hierarchy/escape som prøver navigasjonskontrakten i method-spec §3 Step 1 med ett positivt og ett negativt tilfelle.
    • docs/plan/ — beslutningsprotokollen bak hver avgjørelse i spesifikasjonene, inkludert de som senere ble omgjort.

    Hvorfor 0.1.0 og ikke 1.0.0

    Pre-1.0 med hensikt, ikke av forglemmelse:

    • method-spec.md §1 har en ufravikelig ærlighetsregel — intet artefakt får påstå mer enn implementasjonen gjør. En 1.0.0 under semver påstår at normativ tekst er frosset mot brytende endring. Den forpliktelsen er ikke gitt ennå.
    • SECURITY.md støtter allerede kun latest, uten støttevindu for eldre versjoner.
    • Normativ tekst mottar fortsatt tillegg.
    • Begge konsumenter puller main via git subtree --squash og sporer altså ikke en tag. Tallet merker et publisert snitt; det pinner ingens utsjekk.

    Kjente begrensninger

    Ført fordi ærlighetsregelen er ufravikelig — se CHANGELOG.md for detaljene: README.md lister tre av fem eksempelbundler, og 0.79/0.82 beskriver samme case-klasse med to ulike realiseringsrater (bevisst uharmonisert).

    Downloads