Show the tunnel's peers as each machine sees them, and say on the bus when they move (hq issue 522) #225

Merged
mesh-admin merged 2 commits from feat/522-tunnel-peers into main 2026-10-11 21:55:15 +00:00
Contributor

Why (issue 522). On 2026-10-11 from 21:22 UTC the tunnel leg between ace and the hub lost most packets (from shanks: 0% loss to 10.10.0.1, 80% to 10.10.0.2 through the hub, 0% to ace over the LAN) while ace's own check called its tunnel healthy. Telling a home router's port mix-up from anything else needs each peer's endpoint and last handshake as the hub sees them, and no mesh tool said them. The operator also asked that the networking events live on the bus.

What changes (module netcheck)

  • netcheck_tunnel: the private network's peers as this machine sees them, read from wg show mesh0 dump: each peer's machine (by the mesh's names), allowed ips, endpoint (address:port), last handshake and its age, stale (older than 3 minutes, or never), bytes received and sent, keepalive. Never a key: the dump's first line carries the interface's private key; it is read past, and a test asserts neither a private nor a public key appears in the answer. replaces: wg show.
  • Events, from a watcher every 20 s (first look silent): tunnel.endpoint-changed (with from), tunnel.handshake-stale, tunnel.handshake-fresh. A machine without the interface is looked at again every 10 minutes, said once.

After merge: netcheck is assigned to ace and g14 only; it is wanted on the hub (novox) above all, and on shanks, which is a controller assignment for the operator's go.

Checked: merge-check.sh with the controller from main: netcheck ok (5 tools); go vet and go test -race green. Tests: the dump read (endpoint, ages, stale, keepalive, a peer never heard from), no key said, a dump of another shape refused, endpoint and handshake changes said and the first look silent.

**Why** (issue 522). On 2026-10-11 from 21:22 UTC the tunnel leg between ace and the hub lost most packets (from shanks: 0% loss to 10.10.0.1, 80% to 10.10.0.2 through the hub, 0% to ace over the LAN) while ace's own check called its tunnel healthy. Telling a home router's port mix-up from anything else needs each peer's endpoint and last handshake as the hub sees them, and no mesh tool said them. The operator also asked that the networking events live on the bus. **What changes** (module netcheck) - **`netcheck_tunnel`**: the private network's peers as this machine sees them, read from `wg show mesh0 dump`: each peer's machine (by the mesh's names), allowed ips, endpoint (address:port), last handshake and its age, stale (older than 3 minutes, or never), bytes received and sent, keepalive. **Never a key**: the dump's first line carries the interface's private key; it is read past, and a test asserts neither a private nor a public key appears in the answer. `replaces`: `wg show`. - **Events**, from a watcher every 20 s (first look silent): `tunnel.endpoint-changed` (with `from`), `tunnel.handshake-stale`, `tunnel.handshake-fresh`. A machine without the interface is looked at again every 10 minutes, said once. **After merge**: netcheck is assigned to ace and g14 only; it is wanted on the hub (novox) above all, and on shanks, which is a controller assignment for the operator's go. **Checked**: `merge-check.sh` with the controller from main: netcheck ok (5 tools); `go vet` and `go test -race` green. Tests: the dump read (endpoint, ages, stale, keepalive, a peer never heard from), no key said, a dump of another shape refused, endpoint and handshake changes said and the first look silent.
mesh-admin added 1 commit 2026-10-11 21:50:26 +00:00
Show the tunnel's peers as each machine sees them, and say on the bus when they move (hq issue 522)
mesh/delivery superseded: a newer head of the same pull request
mesh/merge-gate pass: builds netcheck → ace, g14; no bus step; every machine composes with the change as it did without (4 of 4 compose)
mesh/repo-check pass: its merge-check.sh passed, each part in its toolchain: merge-check.sh (go), merge-check-typescript.sh (typescript)
4fc769ed29
ace's tunnel leg lost most packets while its own check called the tunnel
healthy, and nothing on the mesh could say which address and port the
hub saw for each peer, which is what tells a home router's port mix-up
from anything else. netcheck_tunnel answers each peer's endpoint, last
handshake and traffic, never a key, and netcheck now says when a
peer's endpoint changes or its handshake goes stale or fresh again.
Author
Contributor

Delivery novox/mesh-catalog@c31e29f9a601 — delivered since 2026-10-11T22:01:33Z

Delivery plan — builds netcheck → ace, g14; no bus step

  • tier 0: netcheck
  • ace: receives netcheck
  • g14: receives netcheck
  • grants step: if this changes what the bus's user list says (a new tool, subject or user), novox is sent that list alone, every build there kept, before netcheck is judged on its first machine

Machines

  • netcheck on ace: passed — healthy 3 times over 2m41s
  • netcheck on the rest running it: sent

Transitions

  • 2026-10-11 21:51 (new) → proposed (announced): novox/mesh-catalog#225's head announced
  • 2026-10-11 21:54 proposed → checked (checked): the verdict names this commit
  • 2026-10-11 21:54 checked → ready (accepted): the gate passed or warned, and the repository's own check did not fail
  • 2026-10-11 21:56 ready → published (merged): on the trunk its modules follow: merged there, and its walk opened — or nothing for a walk to move
  • 2026-10-11 21:57 published → delivering (go): its walk started: let go by this owner in its group's order, by a person, or on the controller's own path — not a failed walk that carried a later commit for it, after which it waits for a walk of its own commit
  • 2026-10-11 22:01 delivering → delivered (done): its walk is done, carrying its own commit: every machine of its deploy plan passed, or was left as its policy says

The commit's note under refs/notes/mesh-plan keeps every transition: git log --notes=mesh-plan.

<!-- mesh-delivery:view --> **Delivery** `novox/mesh-catalog@c31e29f9a601` — **delivered** since 2026-10-11T22:01:33Z **Delivery plan** — builds netcheck → ace, g14; no bus step - tier 0: netcheck - ace: receives netcheck - g14: receives netcheck - grants step: if this changes what the bus's user list says (a new tool, subject or user), novox is sent that list alone, every build there kept, before netcheck is judged on its first machine **Machines** - netcheck on ace: passed — healthy 3 times over 2m41s - netcheck on the rest running it: sent **Transitions** - 2026-10-11 21:51 (new) → proposed (announced): novox/mesh-catalog#225's head announced - 2026-10-11 21:54 proposed → checked (checked): the verdict names this commit - 2026-10-11 21:54 checked → ready (accepted): the gate passed or warned, and the repository's own check did not fail - 2026-10-11 21:56 ready → published (merged): on the trunk its modules follow: merged there, and its walk opened — or nothing for a walk to move - 2026-10-11 21:57 published → delivering (go): its walk started: let go by this owner in its group's order, by a person, or on the controller's own path — not a failed walk that carried a later commit for it, after which it waits for a walk of its own commit - 2026-10-11 22:01 delivering → delivered (done): its walk is done, carrying its own commit: every machine of its deploy plan passed, or was left as its policy says The commit's note under `refs/notes/mesh-plan` keeps every transition: `git log --notes=mesh-plan`.
jschoubben added 1 commit 2026-10-11 21:51:43 +00:00
Keep watching the tunnel after a failed look, and remember peers' names
mesh/merge-gate pass: builds netcheck → ace, g14; no bus step; every machine composes with the change as it did without (4 of 4 compose)
mesh/repo-check pass: its merge-check.sh passed, each part in its toolchain: merge-check.sh (go), merge-check-typescript.sh (typescript)
mesh/delivery delivered
c31e29f9a6
Author
Contributor

Merge check at 4fc769ed

  • mesh/merge-gate: PASS — every machine composes with the change as it did without (4 of 4 compose) (modules: netcheck)
  • mesh/repo-check: PASS — its merge-check.sh passed, each part in its toolchain: merge-check.sh (go), merge-check-typescript.sh (typescript)

Delivery plan — builds netcheck → ace, g14; no bus step

  • tier 0: netcheck
  • ace: receives netcheck
  • g14: receives netcheck
  • grants step: if this changes what the bus's user list says (a new tool, subject or user), novox is sent that list alone, every build there kept, before netcheck is judged on its first machine

Run by the build seat on g14 as build-1791755445423897606 (builds --log build-1791755445423897606).

--- the gate: netcheck
netcheck: ok, 5 tool(s)
long-running resources without health: 0
files asking for a setting without saying whether it is trusted: 0
1 manifest(s) checked. Judged against the seats this binary carries; a claim on one of the mesh's own seats is judged fully at registration, and a seat declared by a module not given here reads as unknown. Identities judged on a 6-character machine name, against the bounds of the providers given here
judging 1 module(s) changed against 4 machine(s), as the snapshot of 2026-10-11T21:42:09Z says they run
composing every machine as the mesh is
the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued
the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued
composing every machine with the change
the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued
the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued
merge gate: PASS — every machine composes with the change as it did without (4 of 4 compose)
judged by controller development build against the facts of 2026-10-11T21:42:09Z

modules the change moves:
  - netcheck (changed)

machines:
  - a machine (f35): composes
  - holds mesh-dns-resolver (idt): composes
  - holds git, holds mesh-artifact-store, holds mesh-broker, holds mesh-catalog, holds mesh-delivery, holds mesh-dns-resolver, holds mesh-store, holds mesh-vault, holds npm-package-registry, the control node, the hub (ygcyr): composes
  - a machine (yvbpsm): composes

a merge would rebuild 1 module(s) in 1 tier(s): netcheck
--- its merge-check.sh (go toolchain)
ok  	git.novox.be/novox/mesh-catalog/checks/words	0.004s
words: 12 retired words and 70 daemons' lines, none in the 42148 strings of 680 files
ok  	git.novox.be/novox/mesh-catalog/checks/agenthome	0.009s
agent-home: no archive and no file written into under the agent's home
ok  	git.novox.be/novox/mesh-catalog/checks/paths	0.006s
paths: no module names another's state on its machine (3 known, listed to go)
long-running resources without health: 69, as kept
testing modules/netcheck
ok  	netcheck/cmd/netcheck	1.020s
--- its merge-check-typescript.sh (typescript toolchain)
type-checking modules/netcheck (TypeScript)
testing modules/netcheck (TypeScript)
✔ only http and https URLs are checked (0.730154ms)
✔ only HEAD and GET are used (0.158959ms)
✔ a status, its headers and a redirect not followed (28.207252ms)
✔ a refused connection is a result with its error (3.291063ms)
ℹ tests 4
ℹ suites 0
ℹ pass 4
ℹ fail 0
ℹ cancelled 0
ℹ skipped 0
ℹ todo 0
ℹ duration_ms 118.289533
**Merge check** at `4fc769ed` - `mesh/merge-gate`: **PASS** — every machine composes with the change as it did without (4 of 4 compose) (modules: netcheck) - `mesh/repo-check`: **PASS** — its merge-check.sh passed, each part in its toolchain: merge-check.sh (go), merge-check-typescript.sh (typescript) **Delivery plan** — builds netcheck → ace, g14; no bus step - tier 0: netcheck - ace: receives netcheck - g14: receives netcheck - grants step: if this changes what the bus's user list says (a new tool, subject or user), novox is sent that list alone, every build there kept, before netcheck is judged on its first machine Run by the build seat on g14 as `build-1791755445423897606` (`builds --log build-1791755445423897606`). ``` --- the gate: netcheck netcheck: ok, 5 tool(s) long-running resources without health: 0 files asking for a setting without saying whether it is trusted: 0 1 manifest(s) checked. Judged against the seats this binary carries; a claim on one of the mesh's own seats is judged fully at registration, and a seat declared by a module not given here reads as unknown. Identities judged on a 6-character machine name, against the bounds of the providers given here judging 1 module(s) changed against 4 machine(s), as the snapshot of 2026-10-11T21:42:09Z says they run composing every machine as the mesh is the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued composing every machine with the change the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued merge gate: PASS — every machine composes with the change as it did without (4 of 4 compose) judged by controller development build against the facts of 2026-10-11T21:42:09Z modules the change moves: - netcheck (changed) machines: - a machine (f35): composes - holds mesh-dns-resolver (idt): composes - holds git, holds mesh-artifact-store, holds mesh-broker, holds mesh-catalog, holds mesh-delivery, holds mesh-dns-resolver, holds mesh-store, holds mesh-vault, holds npm-package-registry, the control node, the hub (ygcyr): composes - a machine (yvbpsm): composes a merge would rebuild 1 module(s) in 1 tier(s): netcheck --- its merge-check.sh (go toolchain) ok git.novox.be/novox/mesh-catalog/checks/words 0.004s words: 12 retired words and 70 daemons' lines, none in the 42148 strings of 680 files ok git.novox.be/novox/mesh-catalog/checks/agenthome 0.009s agent-home: no archive and no file written into under the agent's home ok git.novox.be/novox/mesh-catalog/checks/paths 0.006s paths: no module names another's state on its machine (3 known, listed to go) long-running resources without health: 69, as kept testing modules/netcheck ok netcheck/cmd/netcheck 1.020s --- its merge-check-typescript.sh (typescript toolchain) type-checking modules/netcheck (TypeScript) testing modules/netcheck (TypeScript) ✔ only http and https URLs are checked (0.730154ms) ✔ only HEAD and GET are used (0.158959ms) ✔ a status, its headers and a redirect not followed (28.207252ms) ✔ a refused connection is a result with its error (3.291063ms) ℹ tests 4 ℹ suites 0 ℹ pass 4 ℹ fail 0 ℹ cancelled 0 ℹ skipped 0 ℹ todo 0 ℹ duration_ms 118.289533 ```
Author
Contributor

Merge check at c31e29f9

  • mesh/merge-gate: PASS — every machine composes with the change as it did without (4 of 4 compose) (modules: netcheck)
  • mesh/repo-check: PASS — its merge-check.sh passed, each part in its toolchain: merge-check.sh (go), merge-check-typescript.sh (typescript)

Delivery plan — builds netcheck → ace, g14; no bus step

  • tier 0: netcheck
  • ace: receives netcheck
  • g14: receives netcheck
  • grants step: if this changes what the bus's user list says (a new tool, subject or user), novox is sent that list alone, every build there kept, before netcheck is judged on its first machine

Run by the build seat on novox as build-1791755506713177256 (builds --log build-1791755506713177256).

--- the gate: netcheck
netcheck: ok, 5 tool(s)
long-running resources without health: 0
files asking for a setting without saying whether it is trusted: 0
1 manifest(s) checked. Judged against the seats this binary carries; a claim on one of the mesh's own seats is judged fully at registration, and a seat declared by a module not given here reads as unknown. Identities judged on a 6-character machine name, against the bounds of the providers given here
judging 1 module(s) changed against 4 machine(s), as the snapshot of 2026-10-11T21:42:09Z says they run
composing every machine as the mesh is
the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued
the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued
composing every machine with the change
the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued
the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued
merge gate: PASS — every machine composes with the change as it did without (4 of 4 compose)
judged by controller development build against the facts of 2026-10-11T21:42:09Z

modules the change moves:
  - netcheck (changed)

machines:
  - a machine (f35): composes
  - holds mesh-dns-resolver (idt): composes
  - holds git, holds mesh-artifact-store, holds mesh-broker, holds mesh-catalog, holds mesh-delivery, holds mesh-dns-resolver, holds mesh-store, holds mesh-vault, holds npm-package-registry, the control node, the hub (ygcyr): composes
  - a machine (yvbpsm): composes

a merge would rebuild 1 module(s) in 1 tier(s): netcheck
--- its merge-check.sh (go toolchain)
ok  	git.novox.be/novox/mesh-catalog/checks/words	0.013s
words: 12 retired words and 70 daemons' lines, none in the 42152 strings of 680 files
ok  	git.novox.be/novox/mesh-catalog/checks/agenthome	0.014s
agent-home: no archive and no file written into under the agent's home
ok  	git.novox.be/novox/mesh-catalog/checks/paths	0.007s
paths: no module names another's state on its machine (3 known, listed to go)
long-running resources without health: 69, as kept
testing modules/netcheck
ok  	netcheck/cmd/netcheck	1.029s
--- its merge-check-typescript.sh (typescript toolchain)
type-checking modules/netcheck (TypeScript)
testing modules/netcheck (TypeScript)
✔ only http and https URLs are checked (0.795481ms)
✔ only HEAD and GET are used (0.21051ms)
✔ a status, its headers and a redirect not followed (23.502433ms)
✔ a refused connection is a result with its error (3.432423ms)
ℹ tests 4
ℹ suites 0
ℹ pass 4
ℹ fail 0
ℹ cancelled 0
ℹ skipped 0
ℹ todo 0
ℹ duration_ms 124.834329
**Merge check** at `c31e29f9` - `mesh/merge-gate`: **PASS** — every machine composes with the change as it did without (4 of 4 compose) (modules: netcheck) - `mesh/repo-check`: **PASS** — its merge-check.sh passed, each part in its toolchain: merge-check.sh (go), merge-check-typescript.sh (typescript) **Delivery plan** — builds netcheck → ace, g14; no bus step - tier 0: netcheck - ace: receives netcheck - g14: receives netcheck - grants step: if this changes what the bus's user list says (a new tool, subject or user), novox is sent that list alone, every build there kept, before netcheck is judged on its first machine Run by the build seat on novox as `build-1791755506713177256` (`builds --log build-1791755506713177256`). ``` --- the gate: netcheck netcheck: ok, 5 tool(s) long-running resources without health: 0 files asking for a setting without saying whether it is trusted: 0 1 manifest(s) checked. Judged against the seats this binary carries; a claim on one of the mesh's own seats is judged fully at registration, and a seat declared by a module not given here reads as unknown. Identities judged on a 6-character machine name, against the bounds of the providers given here judging 1 module(s) changed against 4 machine(s), as the snapshot of 2026-10-11T21:42:09Z says they run composing every machine as the mesh is the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued composing every machine with the change the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued merge gate: PASS — every machine composes with the change as it did without (4 of 4 compose) judged by controller development build against the facts of 2026-10-11T21:42:09Z modules the change moves: - netcheck (changed) machines: - a machine (f35): composes - holds mesh-dns-resolver (idt): composes - holds git, holds mesh-artifact-store, holds mesh-broker, holds mesh-catalog, holds mesh-delivery, holds mesh-dns-resolver, holds mesh-store, holds mesh-vault, holds npm-package-registry, the control node, the hub (ygcyr): composes - a machine (yvbpsm): composes a merge would rebuild 1 module(s) in 1 tier(s): netcheck --- its merge-check.sh (go toolchain) ok git.novox.be/novox/mesh-catalog/checks/words 0.013s words: 12 retired words and 70 daemons' lines, none in the 42152 strings of 680 files ok git.novox.be/novox/mesh-catalog/checks/agenthome 0.014s agent-home: no archive and no file written into under the agent's home ok git.novox.be/novox/mesh-catalog/checks/paths 0.007s paths: no module names another's state on its machine (3 known, listed to go) long-running resources without health: 69, as kept testing modules/netcheck ok netcheck/cmd/netcheck 1.029s --- its merge-check-typescript.sh (typescript toolchain) type-checking modules/netcheck (TypeScript) testing modules/netcheck (TypeScript) ✔ only http and https URLs are checked (0.795481ms) ✔ only HEAD and GET are used (0.21051ms) ✔ a status, its headers and a redirect not followed (23.502433ms) ✔ a refused connection is a result with its error (3.432423ms) ℹ tests 4 ℹ suites 0 ℹ pass 4 ℹ fail 0 ℹ cancelled 0 ℹ skipped 0 ℹ todo 0 ℹ duration_ms 124.834329 ```
mesh-admin merged commit d2dff99bcf into main 2026-10-11 21:55:15 +00:00
mesh-admin deleted branch feat/522-tunnel-peers 2026-10-11 21:55:15 +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/mesh-catalog#225