ADR 0290 rewritten: a decision record lives whole in the knowledge base #307

Merged
mesh-admin merged 2 commits from decisions/0290-records-whole-in-the-knowledge-base into main 2026-10-11 00:07:49 +00:00
Contributor

On the operator's word (2026-10-11): one record should not live in two places, and ADR 0290 is updated in place rather than superseded. The record carries a dated Rewritten note naming the earlier version's commit (08b1077b); nothing was built on it.

  • ADR 0290 (renamed, links updated): the knowledge base holds a decision record and research effort whole, reasoning and every version included; a record is proposed (refused at the write by the 29 per-record and prose rules), reviewed by an independent agent and accepted there, with the operator's Approve when it needs it; the records leave hq once the import is checked (issue 426); whether hq keeps a generated public copy is issue 435.
  • To-be 55 rewritten to match: versions and history, propose/review, acceptance, the import whole.
  • ADR 0291: its sentences that relied on decision records staying public in hq now point at issue 435.
  • Glossary and design index updated.
  • cycle.py (issue 436): a deferral tracked by an issue that lives only in the tracker (numbered above every folder) now counts; before, every issue from 365 on was invisible to the check.

Checks: merge-check.sh passes locally; the deferral check fails a deferral naming no issue and passes one naming a tracker-only issue.

On the operator's word (2026-10-11): one record should not live in two places, and ADR 0290 is updated in place rather than superseded. The record carries a dated *Rewritten* note naming the earlier version's commit (08b1077b); nothing was built on it. - **ADR 0290** (renamed, links updated): the knowledge base holds a decision record and research effort whole, reasoning and every version included; a record is proposed (refused at the write by the 29 per-record and prose rules), reviewed by an independent agent and accepted there, with the operator's Approve when it needs it; the records leave hq once the import is checked (issue 426); whether hq keeps a generated public copy is issue 435. - **To-be 55** rewritten to match: versions and `history`, `propose`/`review`, acceptance, the import whole. - **ADR 0291**: its sentences that relied on decision records staying public in hq now point at issue 435. - Glossary and design index updated. - **cycle.py** (issue 436): a deferral tracked by an issue that lives only in the tracker (numbered above every folder) now counts; before, every issue from 365 on was invisible to the check. Checks: merge-check.sh passes locally; the deferral check fails a deferral naming no issue and passes one naming a tracker-only issue.
mesh-admin added 1 commit 2026-10-11 00:05:20 +00:00
ADR 0290 rewritten on the operator's word: a decision record lives whole in the knowledge base, reviewed and accepted there; and cycle.py sees issues that live only in the tracker (issue 436)
mesh/merge-gate pass: the change touches no module of the mesh's graph
mesh/repo-check pass: its merge-check.sh passed
mesh/delivery superseded: a newer head of the same pull request
a5d1e0fbf6
Author
Contributor

Delivery novox/hq@d188941e7323 — delivered since 2026-10-11T00:08:03Z

Delivery plan — builds nothing: the change touches no module of the mesh's graph

Transitions

  • 2026-10-11 00:07 (new) → proposed (announced): novox/hq#307's head announced
  • 2026-10-11 00:07 proposed → checked (checked): the verdict names this commit
  • 2026-10-11 00:07 checked → ready (accepted): the gate passed or warned, and the repository's own check did not fail
  • 2026-10-11 00:08 ready → published (merged): on the trunk its modules follow: merged there, and its walk opened — or nothing for a walk to move
  • 2026-10-11 00:08 published → delivered (done): nothing for a walk to move

The commit's note under refs/notes/mesh-plan keeps every transition: git log --notes=mesh-plan.

<!-- mesh-delivery:view --> **Delivery** `novox/hq@d188941e7323` — **delivered** since 2026-10-11T00:08:03Z **Delivery plan** — builds nothing: the change touches no module of the mesh's graph **Transitions** - 2026-10-11 00:07 (new) → proposed (announced): novox/hq#307's head announced - 2026-10-11 00:07 proposed → checked (checked): the verdict names this commit - 2026-10-11 00:07 checked → ready (accepted): the gate passed or warned, and the repository's own check did not fail - 2026-10-11 00:08 ready → published (merged): on the trunk its modules follow: merged there, and its walk opened — or nothing for a walk to move - 2026-10-11 00:08 published → delivered (done): nothing for a walk to move The commit's note under `refs/notes/mesh-plan` keeps every transition: `git log --notes=mesh-plan`.
jschoubben added 1 commit 2026-10-11 00:07:02 +00:00
Checks README: a tracking issue that lives only in the tracker counts, and what that cannot catch (issue 436)
mesh/merge-gate pass: the change touches no module of the mesh's graph
mesh/repo-check pass: its merge-check.sh passed
mesh/delivery delivered
d188941e73
mesh-admin merged commit 07ecb39a2e into main 2026-10-11 00:07:49 +00:00
mesh-admin deleted branch decisions/0290-records-whole-in-the-knowledge-base 2026-10-11 00:07:49 +00:00
Sign in to join this conversation.
No Reviewers
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: novox/hq#307