To-be 08: the five connectivity contexts walked through the network layers #275

Merged
mesh-admin merged 2 commits from design/connectivity-through-the-layers into main 2026-10-14 21:14:49 +00:00
Contributor

Adds a reading-aid section to 03-DESIGN/01-to-be/08-connectivity.md, before What this removes:

  • a table placing each of the five contexts (private network, resolution, exposure, filtering, certificates), the bus and the uplink on an OSI layer;
  • the private network drawn as a layer 3 network carried at layer 4 of the underlay;
  • the hub shape of §1 (hub and anchor, a roaming laptop through the hub only, two home-servers at one site peered directly);
  • one tool call from a laptop to a home-server, wrapped layer by layer, and how far the hub unwraps it (to layer 7 for the bus, to layer 3 when it relays);
  • the machine's own network checks (ADR 0241) mapped onto layers, read from the bottom up.

No new decision record, by the operator's choice (2026-10-09). The section changes no intention: it decides nothing, states no rule, and every claim cites the section or record that decided it (ADR 0106, 0117, 0169, 0241). decisions: gains 0241 and 0117 because the section cites them; updated: moves to today.

Public-repository check: role names only, no node names, provider, addresses or ports; the diff was scanned for them.

Checks: sh merge-check.sh (records, index, cycle, words with the catalogue's list) passes on this head, which is on main's head.

Adds a reading-aid section to `03-DESIGN/01-to-be/08-connectivity.md`, before *What this removes*: - a table placing each of the five contexts (private network, resolution, exposure, filtering, certificates), the bus and the uplink on an OSI layer; - the private network drawn as a layer 3 network carried at layer 4 of the underlay; - the hub shape of §1 (hub and anchor, a roaming laptop through the hub only, two home-servers at one site peered directly); - one tool call from a laptop to a home-server, wrapped layer by layer, and how far the hub unwraps it (to layer 7 for the bus, to layer 3 when it relays); - the machine's own network checks (ADR 0241) mapped onto layers, read from the bottom up. **No new decision record, by the operator's choice (2026-10-09).** The section changes no intention: it decides nothing, states no rule, and every claim cites the section or record that decided it (ADR 0106, 0117, 0169, 0241). `decisions:` gains 0241 and 0117 because the section cites them; `updated:` moves to today. Public-repository check: role names only, no node names, provider, addresses or ports; the diff was scanned for them. Checks: `sh merge-check.sh` (records, index, cycle, words with the catalogue's list) passes on this head, which is on main's head.
Author
Contributor

Delivery novox/hq@3c5edc387955 — delivered since 2026-10-14T21:15:04Z

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

Transitions

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

Rework needed before merge (triage, 2026-10-11): it conflicts with today's main in 08-connectivity.md since the records left hq (#312). Rebase onto main and cite decisions in main's form: "ADR 0241" and "ADR 0117" in the frontmatter, plain "ADR NNNN" in prose instead of ../../02-DECISIONS/… links. The layers section is still wanted. Its green checks ran before #312 and are stale.

Rework needed before merge (triage, 2026-10-11): it conflicts with today's main in 08-connectivity.md since the records left hq (#312). Rebase onto main and cite decisions in main's form: "ADR 0241" and "ADR 0117" in the frontmatter, plain "ADR NNNN" in prose instead of ../../02-DECISIONS/… links. The layers section is still wanted. Its green checks ran before #312 and are stale.
jschoubben added 2 commits 2026-10-14 21:13:28 +00:00
Cite decisions by number now that they live in the knowledge base, and date the design today
mesh/merge-gate head 3c5edc387955 merged into trunk 35d5b2814f09 — pass: the change touches no module of the mesh's graph
mesh/repo-check head 3c5edc387955 merged into trunk 35d5b2814f09 — pass: its merge-check.sh passed
mesh/delivery delivered
3c5edc3879
jschoubben force-pushed design/connectivity-through-the-layers from b740ce9321 to 3c5edc3879 2026-10-14 21:13:28 +00:00 Compare
mesh-admin added the mesh/ready label 2026-10-14 21:13:38 +00:00
Author
Contributor

ready at 3c5edc3879

Rebased onto main (frontmatter kept from main, ADR 0241 and ADR 0117 added, links to 02-DECISIONS files turned into ADR citations now that decisions live in the knowledge base). Independent review: APPROVE at this head; merge-check.sh passes.

ready at 3c5edc387955167c3744421df1092ff11133dbd6 Rebased onto main (frontmatter kept from main, ADR 0241 and ADR 0117 added, links to 02-DECISIONS files turned into ADR citations now that decisions live in the knowledge base). Independent review: APPROVE at this head; merge-check.sh passes.
mesh-admin merged commit 010a34cc33 into main 2026-10-14 21:14:49 +00:00
mesh-admin deleted branch design/connectivity-through-the-layers 2026-10-14 21:14:50 +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#275