Design 55: the knowledge base keeps its records on the bus and is written and reviewed by section (ADR 0592, ADR 0593 §10) #502

2026-11-02T18:58:46Z

mesh-tools commented

2026-11-02 18:58:46 +00:00

Amends the to-be design 55 for ADR 0592 (accepted 2026-11-02 on the operator's Approve): records, versions and sections on the bus (state heads, stream versions keeping its history, object bucket sections by digest, drafts/asked/names/findings), written by section (open, write, remove, order, submit, drop, take-over), reviewed in parts, titles instead of file names, the move off the database with the drop only on the operator's yes, and the module's tools, health and events. Follows ADR 0593 §10: the mesh-sdk release sdk1 (issue 1585) does what ADR 0592 §16 gave the controller (the grants part creates the buckets and history streams, grants read-only access and raises the 75 percent condition; the indexer's judge checks the forms), so the order is that release, then mesh-knowledge.

Issue 1966 (the knowledge-base build). Review: one reviewer against ADR 0592 and ADR 0593 rather than four by architectural domain, because the design carries out a decision that had that review; round 1 found five faults (fixed in c2b162a), round 2 approved. go test ./... passes.

Reviewed-by: review-55@shanks at c2b162a9e8

Amends the to-be design 55 for ADR 0592 (accepted 2026-11-02 on the operator's Approve): records, versions and sections on the bus (state `heads`, stream `versions` keeping its history, object bucket `sections` by digest, drafts/asked/names/findings), written by section (open, write, remove, order, submit, drop, take-over), reviewed in parts, titles instead of file names, the move off the database with the drop only on the operator's yes, and the module's tools, health and events. Follows ADR 0593 §10: the mesh-sdk release sdk1 (issue 1585) does what ADR 0592 §16 gave the controller (the grants part creates the buckets and history streams, grants read-only access and raises the 75 percent condition; the indexer's judge checks the forms), so the order is that release, then mesh-knowledge. Issue 1966 (the knowledge-base build). Review: one reviewer against ADR 0592 and ADR 0593 rather than four by architectural domain, because the design carries out a decision that had that review; round 1 found five faults (fixed in c2b162a), round 2 approved. `go test ./...` passes. Reviewed-by: review-55@shanks at c2b162a9e8da8f5ab849c1849586d87353348078

mesh-tools added 9 commits 2026-11-02 18:58:46 +00:00

Design 55: the knowledge base keeps its records on the bus and is written and reviewed by section (ADR 0592), so a long record is judged whole and a draft lives only in the knowledge base 5a9a5d8d1d

The glossary gains section, draft, form-only version and search index, and the homonyms section and draft.

Design 55: follow ADR 0592's revision: a stream that keeps its history, a module's own object bucket, the frame's bound and the move's full check 012d276dcc

Design 55: follow ADR 0592's sixth version and the review by aspect: whole-or-refused writes, caps, the move's window and rollback, the delivery order, the judge's judged event, events with what they carry, a test per failure path, and a section Reviewed by aspect 6256fc8e3b

The glossary gains opened and drafted, so a draft's first step is never called drafted.

Design 55: follow ADR 0592's eighth version: readers by ADR 0363's grant, extended to the object bucket; each cap within its form's bound; clause numbers after the splits b9a42eaf90

Design 55: follow ADR 0592's tenth version: submit commits when its version is stored, and the tests for the rollback's double write and the Approve bound to its sections eaa98758b9

Design 55: the review section uses the word the operator chose, architectural domain b8ad9da784

Design 55: one more use of the chosen word 36517018d3

Design 55: follow ADR 0593: the mesh-sdk release sdk1 does the controller's part (the grants part creates, grants and warns; the indexer's judge checks the forms) 3122e8be84

Design 55: readers by grant, the take-over refused while an Approve waits, the grants part's own test, §30 for nesting, the glossary's word in the review table

mesh/check pass c2b162a9e8da on f6bd4246b0d7 | carried from 979bf3f19cce | unit 39 run, 0 kept, 1 skipped | integration 39 run, 0 kept, 1 skipped | co…

mesh/delivery merged: source.main moved to novox/hq@4d4524cda3e0

Details

c2b162a9e8

mesh-tools commented

2026-11-02 18:58:52 +00:00

Delivery novox/hq@c2b162a9e8da — merged since 2026-11-03T00:07:26Z

Source — source.main moved to novox/hq@4d4524cda3. Whether it reached the machines is mesh-delivery-view's, derived from source.main, the wants and the haves.

Transitions

2026-11-02 18:58 (new) → proposed (announced): novox/hq#502's head announced
2026-11-02 18:58 proposed → ready (accepted): a verdict names this commit and the trunk's head as its trunk commit, the gate passed or warned, and the repository's own check did not fail; or the check gates no merge (check-gates-merge false)
2026-11-03 00:07 ready → merged (merged): on the trunk its modules follow: merged there

The commit's note under refs/notes/mesh-plan keeps every transition of this change up to its merge: git log --notes=mesh-plan.

**Delivery** `novox/hq@c2b162a9e8da` — **merged** since 2026-11-03T00:07:26Z **Source** — source.main moved to novox/hq@4d4524cda3e0. Whether it reached the machines is `mesh-delivery-view`'s, derived from `source.main`, the wants and the haves. **Transitions** - 2026-11-02 18:58 (new) → proposed (announced): novox/hq#502's head announced - 2026-11-02 18:58 proposed → ready (accepted): a verdict names this commit and the trunk's head as its trunk commit, the gate passed or warned, and the repository's own check did not fail; or the check gates no merge (check-gates-merge false) - 2026-11-03 00:07 ready → merged (merged): on the trunk its modules follow: merged there The commit's note under `refs/notes/mesh-plan` keeps every transition of this change up to its merge: `git log --notes=mesh-plan`.

mesh-tools merged commit 4d4524cda3 into main

2026-11-03 00:07:23 +00:00

mesh-tools deleted branch feat/kb-nats-native

2026-11-03 00:07:23 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: novox/hq#502