tokenfabrikker/CHANGELOG.md
Kjell Tore Guttormsen aee22b9101
docs: describe the code, the commands and the new conventions
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-12 10:08:48 +01:00

2 KiB
Raw Blame History

Changelog

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

Unreleased

  • Pre-registration of what is tested and what it takes for the hypothesis to hold (FORHANDSREGISTRERING.md).
  • Source bank: 948 entries in 21 areas, each checked against its primary source (kilder/). The second round (areas 13–21) covers the parameters that lacked a source when the model was specified.
  • Model specification, draft 3 (47 equations), after a pre-read of draft 2, two independent reviews of draft 3 and a control of the corrections (modell/).
  • Parameters frozen before anything is computed: 124 parameters in 2025 kroner, one distribution each, with the source entries they rest on (modell/parametere.json). The checksum is recorded in the pre-registration. No code and no results yet.
  • Eight clarifications of the pre-registered criteria, approved by the project owner after the parameter freeze and before anything is computed (FORHANDSREGISTRERING.md, «Presiseringer»). The parameter file is unchanged.
  • First code (src/tokenfabrikker/): one function per equation for the power plant, the data centre and the revenue (S1–S21, S36, S43–S47), a strict reader for the frozen parameter file with unit conversion, and the 10 000 Monte Carlo draws stored in data/. Python with pinned numpy and scipy, pytest, ruff ALL and mypy strict. No result for the hypothesis has been computed.
  • An independent reader coded the key equations from the specification alone. The two implementations agree on all 23 functions. The 19 ambiguities the reader found are settled in a new, dated chapter 16 of the specification (modell/); the parameter file and the pre-registration are unchanged.
  • Known-answer tests against Argonne, NOU 2026: 4, Epoch and NVE with the sources' own assumptions (tests/test_fasit.py). The misses are kept as documented expected failures: wind on land and offshore wind come out 5–6 % below NVE, and three rows of Argonne's table depend on a reading the source does not settle.