ADR 0287: a seat names the paths its holder owns, and a claim without them is refused (issue 412, research 023) #301

Merged
mesh-admin merged 2 commits from feat/grad-023-seat-paths into main 2026-10-10 19:59:46 +00:00
Contributor

Graduates research 023 into ADR 0287 and amends to-be 26 (the seats). Issue 412 tracks the build in mesh-controller; nothing is built here.

What is decided:

  • A node seat's definition may name paths its holder owns. It names only paths that belong to the role on any machine, not to one program. It starts with node-hostname: /etc/hosts and /etc/hostname; node-uplink: /etc/resolv.conf, stepping back for node-resolver; node-resolver: /etc/resolv.conf.
  • CanHold refuses a claim that lacks the seat's paths, at registration and at handover.
  • A module that does not claim the seat and declares one of its paths is refused at registration, and a generated resource on such a path is refused at composition.
  • No two seats name one path, unless one steps back for the other by definition. This is the step-back from ADR 0247, moved from code into the seat.
  • The seats listing shows each seat's paths.
  • The paths are compiled with the set and are not stored in the seat table.

Evidence: mesh-catalog main 61dcdf0 has 125 manifests. Only the four holders declare these three paths, and all four already comply.

Also changed: research 023 is now graduated with became:, the glossary's seat entry mentions the paths, and ADRs 0199 and 0222 get notes saying their mechanism changed.

Checks: cycle, records, index and words pass, and sh merge-check.sh exits 0 (run with MESH_CATALOG_DIR set).

Graduates research 023 into ADR 0287 and amends to-be 26 (the seats). Issue 412 tracks the build in mesh-controller; nothing is built here. What is decided: - A node seat's definition may name paths its holder owns. It names only paths that belong to the role on any machine, not to one program. It starts with node-hostname: /etc/hosts and /etc/hostname; node-uplink: /etc/resolv.conf, stepping back for node-resolver; node-resolver: /etc/resolv.conf. - CanHold refuses a claim that lacks the seat's paths, at registration and at handover. - A module that does not claim the seat and declares one of its paths is refused at registration, and a generated resource on such a path is refused at composition. - No two seats name one path, unless one steps back for the other by definition. This is the step-back from ADR 0247, moved from code into the seat. - The seats listing shows each seat's paths. - The paths are compiled with the set and are not stored in the seat table. Evidence: mesh-catalog main 61dcdf0 has 125 manifests. Only the four holders declare these three paths, and all four already comply. Also changed: research 023 is now graduated with became:, the glossary's seat entry mentions the paths, and ADRs 0199 and 0222 get notes saying their mechanism changed. Checks: cycle, records, index and words pass, and sh merge-check.sh exits 0 (run with MESH_CATALOG_DIR set).
Author
Contributor

Delivery novox/hq@906d702b8ddf — delivered since 2026-10-10T19:59:59Z

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

Transitions

  • 2026-10-10 19:57 (new) → proposed (announced): novox/hq#301's head announced
  • 2026-10-10 19:58 proposed → checked (checked): the verdict names this commit
  • 2026-10-10 19:58 checked → ready (accepted): the gate passed or warned, and the repository's own check did not fail
  • 2026-10-10 19:59 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 19:59 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@906d702b8ddf` — **delivered** since 2026-10-10T19:59:59Z **Delivery plan** — builds nothing: the change touches no module of the mesh's graph **Transitions** - 2026-10-10 19:57 (new) → proposed (announced): novox/hq#301's head announced - 2026-10-10 19:58 proposed → checked (checked): the verdict names this commit - 2026-10-10 19:58 checked → ready (accepted): the gate passed or warned, and the repository's own check did not fail - 2026-10-10 19:59 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 19:59 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 force-pushed feat/grad-023-seat-paths from 748681cfb4 to d9103b1c4b 2026-10-10 19:53:57 +00:00 Compare
jschoubben added 2 commits 2026-10-10 19:57:31 +00:00
jschoubben force-pushed feat/grad-023-seat-paths from d9103b1c4b to 906d702b8d 2026-10-10 19:57:31 +00:00 Compare
mesh-admin merged commit 8932e93a4b into main 2026-10-10 19:59:46 +00:00
mesh-admin deleted branch feat/grad-023-seat-paths 2026-10-10 19:59:47 +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#301