Skip to content

3.20.0 — the living notebook and the bound volume

Choose a tag to compare

@JyMinet JyMinet released this 15 Sep 18:50
· 2 commits to main since this release

Since 3.6.0 a work item only starts once the agent has really read the authorities routed for its
scope — and the Human Decisions register is one of them, for every work item. It is read in full
at every start, every resume and every acknowledgement, and it only ever grows.

Measured on a real governed project before a single line was written: the register accounts for
63 % of everything an agent must read before writing, and 69 % of it is frozen by the
project's adoption baseline.

This version cuts it in two, along a line the project has already declared.

What is new

  • decision bind moves the decisions frozen at the adoption baseline into
    docs/governance/HUMAN_DECISIONS_VOLUME_1.md, byte for byte, and writes a summary in the
    living notebook — one line per bound decision, quoting the opening of each field and marking
    where it cuts. The living notebook stays a routed authority; the bound volume is routed nowhere,
    so it never enters a manifest — while the controller still resolves, audits and shows every
    decision in it.
  • decision show HD-NNN prints one recorded decision, from either volume, and writes nothing.
  • DECISION_VOLUMES_CONSISTENT starts from the commit the volume names itself and checks that
    no decision has disappeared — even one no record cites —, that every bound block is identical
    to its form at that origin, and that the summary is complete and faithful.
  • The controller reminds; it never binds by itself. While no volume exists, an adoption
    baseline is declared and the frozen decisions take up at least a third of the register, status
    says so and names the command, in French and in English.

What does not change

A project that has bound nothing behaves exactly as in 3.19.2. No decision is rewritten,
summarised or requalified: the promise that frozen closures are never reconstructed nor
requalified
is extended to the move, and the vocabulary exemption of frozen decisions follows the
decision into its volume. The proof of reading is not relaxed — what changes is what must be
read
.

Summary lines are pointers, not statements of a decision: a cut line does not say what follows it,
and two decisions can share the same opening. Only the recorded text states the human choice.

Measured, not asserted

Rehearsed on a throwaway clone of a real governed project holding 86 decisions: 64 bound, living
notebook down from 186 333 to 69 168 bytes, reading footprint of a business work item down from
294 143 to 188 885 bytes — about 26 300 fewer tokens at every start. Audit 23 PASS, 0 FAIL,
before and after the cut.

Independent review

The scope was reviewed by an independent controller: P19_CADRAGE_REQUIRES_MAJOR_REDLINE, nine
findings. The counter-review rejected none of them. The major red line was well founded and
reproduced: the audit verified that every block it found was intact without ever starting from
the expected set, so a decision no record cites could vanish together with its summary line. Fixed
by pinning the binding origin inside the volume itself. Reports live under provenance/maintenance/.

181 tests, sixteen of them born with this version, each verified red before and green after.

Two debts are assumed and written down: binding a second time once the notebook has grown again is
not built, and the template's own decision journal is routed for nobody.


---

## Note

La copie publique est un miroir anonymisé, produit par un script depuis le dépôt privé et jamais
édité à la main. Elle contient le code, les essais, la doctrine et les rapports de contrôle ; le
projet adopté y est renommé « Alpha » et l'outil d'export reste privé.