refactor(examples)!: remove two example bundles; 0.2.0 in CHANGELOG

Replaces sector-specific example material with generic, fictitious
examples: removes the two full-scale example bundles under examples/ (18
files) and every reference to them in README Contents and CHANGELOG
(neutral wording in the 0.1.0 entry; history untouched). The
falsification-reviewer worked example now uses a building-energy scenario
with the same structure, judgement (undecided) and evidence states. One
word in the author's own commentary in docs/plan/ is made generic; the
quoted source text is unchanged.

Remaining examples: bygg-energi-mikro, nav-golden-hierarchy,
nav-golden-escape.

Cuts [Unreleased] as [0.2.0] - 2026-09-23 with its link reference.
CHANGELOG.md is the only file that carries the repository version. No tag.

scripts/check-excluded-topics.py: red (180 hits / 20 files / 68 paths)
-> green (0 hits / 50 tracked paths, self-test passed), measured after
git add with the local term list in place.

Valgt 0.2.0 fordi fjerningen er brytende for konsumentene, og pre-1.0
semver bærer brudd som minor-bump. Valgt én commit for fjerning og
versjonskutt fordi CHANGELOG-teksten for begge er samme endring.

BREAKING CHANGE: consumers that vendor shared/examples/ lose the two
directories on the next subtree pull.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-09-23 15:12:55 +02:00
commit 8aa19ec774
Signed by: ktg
SSH key fingerprint: SHA256:JakMjO6FTBBzN0Bhfj9saOoEjaFxlSdYuZQQpM/lF9Q
22 changed files with 45 additions and 1673 deletions

View file

@ -18,8 +18,30 @@ affected by this file.
## [Unreleased]
## [0.2.0] - 2026-09-23
### Removed
- **Two full-scale example bundles are removed from [`examples/`](examples/).** What remains is
`bygg-energi-mikro` (the dev fixture with its golden suite) and the `nav-golden-hierarchy` /
`nav-golden-escape` fixture pair. A consumer that vendors this repository loses the two
directories on its next subtree pull; anything in a consumer that reads them by path must
be removed or repointed first.
### Changed
- **[`skills/falsification-reviewer/references/example-evidence.json`](skills/falsification-reviewer/references/example-evidence.json)**
now uses a building-energy scenario (daylight-responsive lighting control in an office
building). The structure, the judgement (`undecided`), the evidence states and every rule the
example demonstrates are unchanged; only the concept ids, titles and claim text changed.
### Added
- **[`scripts/check-excluded-topics.py`](scripts/check-excluded-topics.py)** — a repository
hygiene gate: fails if any tracked path or text file matches a term list kept outside the tree,
in `<git-common-dir>/info/excluded-topics`. It runs a self-test first (known positives must
match, known negatives must not) and exits 2 rather than report a clean scan from a pattern that
cannot find; without the term list it reports SKIPPED and exits 3.
- **[`method-spec.md`](method-spec.md) §3 Step 1 — Amendment A1 (2026-09-02), multi-source
provenance.** `sources` is normatively written as a **single-line flow sequence of one or
more flow mappings**; a block list MUST NOT be emitted, and a consumer that meets one reports
@ -83,8 +105,8 @@ on 2026-06-26 and published at `open/` on 2026-08-04; nothing in this release is
`references/example-verdict.json`.
- **Example knowledge bundles (OKF).** Five directories under
[`examples/`](examples/): the `bygg-energi-mikro` dev fixture with its golden suite; the
full-scale `veglys-fv-soer` and `tunnel-hauglia` bundles, each with cost baseline, method note,
sources, measures and a seed expert verdict; and the `nav-golden-hierarchy` /
two full-scale bundles, each with cost baseline, method note, sources, measures and a seed
expert verdict (removed in [0.2.0]); and the `nav-golden-hierarchy` /
`nav-golden-escape` fixture pair exercising the navigation contract of method-spec §3 Step 1
with one positive and one negative case. The nav-golden pair is an informative listing: no
normative file refers to it, and its comparison rule is deliberately unpinned.
@ -98,8 +120,8 @@ on 2026-06-26 and published at `open/` on 2026-08-04; nothing in this release is
Recorded because the honesty rule of method-spec §1 is unwaivable, and because a reader of the
published surface would otherwise have to discover these by reading the git history:
- **`README.md` lists three of the five example bundles.** `tunnel-hauglia` and `veglys-fv-soer`
are absent from the Contents section. No claim in the README is untrue, but the two largest
- **`README.md` lists three of the five example bundles.** The two full-scale bundles are absent
from the Contents section. No claim in the README is untrue, but the two largest
bundles are invisible on the first screen.
- **Two different realization rates describe the same case class.**
`skills/expert-reviewer/references/example-verdict.json` states
@ -112,4 +134,5 @@ published surface would otherwise have to discover these by reading the git hist
unharmonized deliberately — 0.79 is traced through a consumer's byte-pinned golden
transcript, so changing it here would turn a consumer's gate red.
[0.2.0]: https://git.fromaitochitta.com/open/portfolio-optimiser-commons/releases/tag/v0.2.0
[0.1.0]: https://git.fromaitochitta.com/open/portfolio-optimiser-commons/releases/tag/v0.1.0