ADR 0290 and 0291: the knowledge base, and an issue whole in the issue tracker (research 045) #306

Merged
mesh-admin merged 5 commits from decisions/0290-0291-the-knowledge-base-and-issues-whole-in-the-tracker into main 2026-10-10 23:26:52 +00:00
Contributor

Graduates research 045 (playbook 02).

  • ADR 0290: a module mesh-knowledge (seat knowledge-base) holds each decision record's and research effort's structure and each decision's clauses with their own status; hq keeps the reasoning; a record is accepted when its pull request merges; numbers from the issue tracker (ADR 0275 rule 8). New records write their decision as numbered clauses, checked by a new clauses check in records.py.
  • ADR 0291: an issue lives whole in the issue tracker (report, diagnosis, resolution); the 361 folders are imported and removed; supersedes in part ADR 0275 and ADR 0019, each with its dated note.
  • To-be 55 (new) and to-be 53 (slice 6 added; slice 2 asked for by the knowledge base).
  • Glossary: clause, knowledge base; the homonym row for record no longer calls the records module a knowledge base. Research 045 graduated.

Two choices the operator has not confirmed yet (the research's open questions): (1) drafted clauses for the 226 prose records are confirmed by a second, independent judgement, the operator told per topic and able to send a record back; (2) no issue content is exported to hq. Not merged before the operator confirms both.

Every deferral names its issue: 424 (numbers), 425 (first slice), 426 (frontmatter leaves hq), 427 (issues whole), 428 (designs, playbooks, glossary), 429 (light records).

Left alone: 00-META/how-we-build.md line 202 still says "the knowledge base is indexed on symptoms" in the predecessor's sense; changing it needs a constitution sync (playbook 05).

Checks: merge-check.sh passes locally.

Graduates research 045 (playbook 02). - **ADR 0290**: a module `mesh-knowledge` (seat `knowledge-base`) holds each decision record's and research effort's structure and each decision's **clauses** with their own status; hq keeps the reasoning; a record is accepted when its pull request merges; numbers from the issue tracker (ADR 0275 rule 8). New records write their decision as numbered clauses, checked by a new `clauses` check in records.py. - **ADR 0291**: an issue lives whole in the issue tracker (report, diagnosis, resolution); the 361 folders are imported and removed; supersedes in part ADR 0275 and ADR 0019, each with its dated note. - **To-be 55** (new) and **to-be 53** (slice 6 added; slice 2 asked for by the knowledge base). - Glossary: **clause**, **knowledge base**; the homonym row for *record* no longer calls the records module a knowledge base. Research 045 graduated. **Two choices the operator has not confirmed yet** (the research's open questions): (1) drafted clauses for the 226 prose records are confirmed by a second, independent judgement, the operator told per topic and able to send a record back; (2) no issue content is exported to hq. Not merged before the operator confirms both. Every deferral names its issue: 424 (numbers), 425 (first slice), 426 (frontmatter leaves hq), 427 (issues whole), 428 (designs, playbooks, glossary), 429 (light records). Left alone: `00-META/how-we-build.md` line 202 still says "the knowledge base is indexed on symptoms" in the predecessor's sense; changing it needs a constitution sync (playbook 05). Checks: merge-check.sh passes locally.
mesh-admin added 2 commits 2026-10-10 23:01:52 +00:00
ADR 0290 and 0291: the knowledge base holds each record's structure and clauses, and an issue lives whole in the tracker (research 045)
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
d606b4382f
jschoubben added 1 commit 2026-10-10 23:02:03 +00:00
ADR 0291: the choice of no export is this record's, not an answer the operator gave
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
4c4d96874f
Author
Contributor

Delivery novox/hq@63dcd116e826 — delivered since 2026-10-10T23:27:12Z

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

Transitions

  • 2026-10-10 23:25 (new) → proposed (announced): novox/hq#306's head announced
  • 2026-10-10 23:26 proposed → checked (checked): the verdict names this commit
  • 2026-10-10 23:26 checked → ready (accepted): the gate passed or warned, and the repository's own check did not fail
  • 2026-10-10 23:27 ready → published (merged): on the trunk its modules follow: merged there, and its walk opened — or nothing for a walk to move
  • 2026-10-10 23:27 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@63dcd116e826` — **delivered** since 2026-10-10T23:27:12Z **Delivery plan** — builds nothing: the change touches no module of the mesh's graph **Transitions** - 2026-10-10 23:25 (new) → proposed (announced): novox/hq#306's head announced - 2026-10-10 23:26 proposed → checked (checked): the verdict names this commit - 2026-10-10 23:26 checked → ready (accepted): the gate passed or warned, and the repository's own check did not fail - 2026-10-10 23:27 ready → published (merged): on the trunk its modules follow: merged there, and its walk opened — or nothing for a walk to move - 2026-10-10 23:27 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-10 23:25:13 +00:00
ADR 0290 and 0291: the operator's confirmations, no folder rule before issue 427, the verb return, the documents' row in to-be 53, and both senses of knowledge base
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
b174269ec1
jschoubben added 1 commit 2026-10-10 23:25:51 +00:00
Glossary: the two senses of knowledge base below the senses of record, not among them
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
63dcd116e8
mesh-admin merged commit 08b1077b51 into main 2026-10-10 23:26:52 +00:00
mesh-admin deleted branch decisions/0290-0291-the-knowledge-base-and-issues-whole-in-the-tracker 2026-10-10 23:26:52 +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#306