# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

### Added

**The method, implemented (D7).** Sibling implementation of the portfolio-optimiser method
on the Claude Agent SDK, built from the shared frozen spec + golden suite alone — never by
reverse-engineering the MAF sibling.

- **Deterministic backbone** — the typed cost-IR, the mandatory blocking validator (frozen by
  the shared golden suite, its only oracle), first-class provenance, and fail-fast startup
  contracts including the role → model map.
- **Agentic loop** — bounded generation, maker–checker debate, the validator gate, and
  informed refinement; the budget meter admits no unbounded loop anywhere, and carries an
  optional pre-call run-total USD belt on top of the post-charge token/round caps.
- **Learning loop** — the OKF context seam (navigation, never chunk-stuffing), the ExpeL-style
  experience fold, the async expert-verdict inbox, and the fail-closed promotion gate.
- **Ingest layer** — deterministic CSV (`file`) and SQLite (`sql`) connectors in front of the
  loop, materializing OKF bundles the unchanged loop consumes; frozen by byte-identical golden
  extractions. `http`/MCP is an extension point this repo does **not** build, and a manifest
  naming it is rejected fail-fast.
- **Value layer** — the fail-closed savings ledger (dimension-free sum, no double-counting),
  the hard/soft goal contract, the outbox output layer, the HITL pending/routing view, the
  pre-run cost simulation over schema-validated pricing config, the SDK/API preflight, opt-in
  notification sinks (webhook egress only behind an explicit per-run flag), and the per-run
  value report (modelled → expert-corrected → realized, goal progress, quantified learning
  effect, cost against value).
- **Operator CLI** — one collecting entrance (`run.py`) for a single project (`--bundle`) or a
  portfolio (`--portfolio`, `--verdict-dir`), with `--goals` + `--ledger` stopping a run before
  any model call when the target is already met, and `--value-report` projecting what the run
  delivered. Standalone entrances for `valuereport`, `hitl`, `costsim` and `preflight`. Every
  flag the README documents is checked against the actual `--help` output by a load-bearing
  test.
- **Knowledge-base recipe** — the documented team process for building the OKF bundles the
  framework reads (`docs/oppskrift-kunnskapsbase.md`), with an honest 1–2 week expectation.
- **The programme's one live model run** (S10) — executed and validated at a documented
  $0.127514, its four artifacts committed as fixed reference output under `runs/s10/`.
- **Load-bearing tests** — every seam is proven by a test that goes red when the seam is
  detached; the whole suite runs offline, with no API key and no network.

### Notes

- Honesty rule (method spec §1): no artifact in this repo claims more than the implementation
  does. Scripted stand-ins are labelled as such, unbuilt extension points are named as
  unbuilt, and a figure the data does not carry is reported unmarked rather than back-filled.
- Licensed under the MIT License (see `LICENSE`).