to-be 55: a drafted clause may be changed, and a clause another record links keeps its number (issue 494, ADR 0321) #329

Merged
mesh-admin merged 1 commits from design/55-a-drafted-clause-may-be-changed into main 2026-10-12 12:18:25 +00:00
Contributor

Amends to-be 55 (the knowledge base) for ADR 0321, its home.

  • decisions: adds ADR 0321.
  • §7 gains a paragraph: a later record's changes may name a drafted clause (confirmed or not); on acceptance the clause is changed, keeps its number, stays drafted and is never served as in force; return refuses a record whose clauses another record changed or links by number, naming the links.
  • §10 gains the row that says how it is checked (the module's tests in mesh-catalog #245).

Why: issue 494. propose refused changes onto a drafted clause (ADR 0294, 0301, 0320), and return once renumbered a record's clauses, pointing other records' links at other clauses. The code is mesh-catalog #245.

Checked: MESH_CATALOG_DIR=<mesh-catalog checkout> sh merge-check.sh passes (records, index, cycle, words). Role names only; nothing installation-specific.

For issue 494. Not merged.

Amends to-be 55 (the knowledge base) for **ADR 0321**, its home. - `decisions:` adds ADR 0321. - §7 gains a paragraph: a later record's `changes` may name a drafted clause (confirmed or not); on acceptance the clause is `changed`, keeps its number, stays `drafted` and is never served as in force; `return` refuses a record whose clauses another record changed or links by number, naming the links. - §10 gains the row that says how it is checked (the module's tests in mesh-catalog #245). Why: issue 494. `propose` refused `changes` onto a drafted clause (ADR 0294, 0301, 0320), and `return` once renumbered a record's clauses, pointing other records' links at other clauses. The code is mesh-catalog #245. Checked: `MESH_CATALOG_DIR=<mesh-catalog checkout> sh merge-check.sh` passes (records, index, cycle, words). Role names only; nothing installation-specific. For issue 494. Not merged.
mesh-admin added 1 commit 2026-10-12 12:15:10 +00:00
to-be 55: a drafted clause may be changed, and a clause another record links keeps its number (issue 494, ADR 0321)
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
12e59b3c42
Names ADR 0321 in its home, so the knowledge base's cited rule holds through
the design that carries it.
Author
Contributor

Delivery novox/hq@12e59b3c422f — delivered since 2026-10-12T12:18:36Z

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

Transitions

  • 2026-10-12 12:15 (new) → proposed (announced): novox/hq#329's head announced
  • 2026-10-12 12:16 proposed → checked (checked): the verdict names this commit
  • 2026-10-12 12:16 checked → ready (accepted): the gate passed or warned, and the repository's own check did not fail
  • 2026-10-12 12:18 ready → published (merged): on the trunk its modules follow: merged there, and its walk opened — or nothing for a walk to move
  • 2026-10-12 12:18 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@12e59b3c422f` — **delivered** since 2026-10-12T12:18:36Z **Delivery plan** — builds nothing: the change touches no module of the mesh's graph **Transitions** - 2026-10-12 12:15 (new) → proposed (announced): novox/hq#329's head announced - 2026-10-12 12:16 proposed → checked (checked): the verdict names this commit - 2026-10-12 12:16 checked → ready (accepted): the gate passed or warned, and the repository's own check did not fail - 2026-10-12 12:18 ready → published (merged): on the trunk its modules follow: merged there, and its walk opened — or nothing for a walk to move - 2026-10-12 12:18 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-admin left a comment
Author
Contributor

Verdict: approve at 12e59b3

Independent review of the to-be 55 amendment for issue 494 and ADR 0321.

Checks. mesh/repo-check passes, and mesh/merge-gate passes (it touches no module). Locally at 12e59b3, sh merge-check.sh exits 0: records, index, cycle (436 documents) and words all pass. The catalogue comparison was skipped because MESH_CATALOG_DIR was not set; that is expected for a design-only change.

Public-repo rules. The diff has no node names, addresses, domains or paths. It names records only as "ADR 0321" and "issue 494", in the form records.py wants.

It matches ADR 0321. decisions: adds "ADR 0321". The §7 paragraph follows the record's three clauses:

  • a drafted clause, confirmed or not, may be changed, and only a superseded or proposed clause is refused (§1);
  • once changed, the clause is marked changed, keeps its number, stays drafted and is never served, and get and ask say both (§2);
  • return refuses a record any of whose clauses another record changed or links by number, in a version served or proposed, names each link, and gives the changing record as the way to correct it (§3).

It matches mesh-catalog #245. The new §10 row describes what TestARecordMayChangeAClauseHeldOnlyAsDrafted and TestARecordWhoseClausesAreLinkedByNumberIsNeverReturned assert, including "writes nothing". I reviewed #245 at 9f893b6 and approved it there.

Nothing to change.

Verdict: approve at 12e59b3 Independent review of the to-be 55 amendment for issue 494 and ADR 0321. **Checks.** mesh/repo-check passes, and mesh/merge-gate passes (it touches no module). Locally at 12e59b3, `sh merge-check.sh` exits 0: records, index, cycle (436 documents) and words all pass. The catalogue comparison was skipped because MESH_CATALOG_DIR was not set; that is expected for a design-only change. **Public-repo rules.** The diff has no node names, addresses, domains or paths. It names records only as "ADR 0321" and "issue 494", in the form records.py wants. **It matches ADR 0321.** `decisions:` adds "ADR 0321". The §7 paragraph follows the record's three clauses: - a drafted clause, confirmed or not, may be changed, and only a superseded or proposed clause is refused (§1); - once changed, the clause is marked `changed`, keeps its number, stays drafted and is never served, and `get` and `ask` say both (§2); - `return` refuses a record any of whose clauses another record changed or links by number, in a version served or proposed, names each link, and gives the changing record as the way to correct it (§3). **It matches mesh-catalog #245.** The new §10 row describes what `TestARecordMayChangeAClauseHeldOnlyAsDrafted` and `TestARecordWhoseClausesAreLinkedByNumberIsNeverReturned` assert, including "writes nothing". I reviewed #245 at 9f893b6 and approved it there. Nothing to change.
mesh-admin merged commit 992c075444 into main 2026-10-12 12:18:25 +00:00
mesh-admin deleted branch design/55-a-drafted-clause-may-be-changed 2026-10-12 12:18:26 +00:00
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: novox/hq#329