I3187 — A link names the endpoint candidates it tried, the one it chose and why

✕BLOKOVÁNO vlna 1 · p3 · profil implementation · bezpečné paralelně

Part of mesh-connectivity — Trusted nodes connect across NAT through proven transports, and every surface says which path.

Cíl

Record, per link, the endpoint candidates each discovery provider produced (source, observed_at, expires_at), the dial attempts with their outcome and latency, the path chosen and the rule that chose it, with hysteresis against flapping; serve it in mesh peers and /ui/mesh.

Proč

Every 10-12..10-18 connectivity design starts with one typed decision record so that transports can be added without a scheduler change and nobody keeps a parallel endpoint list; 'peer.address' as a property of the peer was rejected. Every surface that shows peers derives from mesh.peers. The cockpit view (I2983, 5a, in flight with no record yet) takes this block from that capability when it lands and writes no second derivation. ui/mesh.rs is also changed by I2943 (in flight for 0.30.0, no record on master), so this issue lands after it. Proposed in ADR 0202 (The mesh routes work to an identity, never an address, and selects among proven transports instead of implementing NAT traversal) (proposed; it carries no authority until the owner accepts it). Sources: chatgpt-majordomus:c279#7, chatgpt-majordomus:c282#5, chatgpt-majordomus:c237#4.

Aktuální stav

Verified: mesh/address.rs ranks local interfaces; rendezvous and multicast produce addresses; no record says why a link used one.

Cílový stav

A connectivity block per peer in mesh.peers; candidates expire.

Rozsah

• apps/majordomus-cli/src/mesh/link.rs
• apps/majordomus-cli/src/mesh/address.rs
• apps/majordomus-cli/src/mesh/provider.rs
• apps/majordomus-cli/src/ui/mesh.rs
• apps/majordomus-cli/src/capability/builtin/mesh.rs
• apps/majordomus-cli/src/commands/mesh.rs
• docs/MESH.md
• site/content/docs/mesh.md

Mimo rozsah

• New transports
• Recording candidates, dial attempts or the chosen path as journal events or in the folded mesh state: they are local observations

Závislosti

• I2410○PŘIPRAVENO Důvěryhodný stroj na tailnetu se najde přes Tailscale, bez ručně zapsané adresy

Co na tom čeká

• I3189✕BLOCKED Two nodes with no direct path cooperate through a trusted hub that relays their authenticated frames

Kritéria přijetí

• mesh peers shows candidates, choice and reason for every link
• An expired candidate is never dialled
• This issue writes apps/majordomus-cli/tests/mesh_connectivity.rs and, in the same change, records it as the test ref of criterion path-is-explained (evidence: test)
• The PeerTree output of mesh.peers carries the connectivity block, so the CLI text, JSON, HTTP and MCP answers all show it from one declaration (majordomus generate)
• Adding path records leaves the mesh state digest unchanged and the lab's three_node_convergence scenario green
• docs/MESH.md explains the path record and the site page is regenerated from it

Validace

• majordomus plan validate
• cargo test --lib mesh::link

Požadované důkazy

• test_a_link_names_its_path
• test_mesh_connectivity_names_the_path

Důkazy

Nic nezaznamenáno. Za každým tokenem výše musí stát příkaz nebo artefakt, než lze tento úkol dokončit; vyprávění se odmítá.

Časová osa

zahájeno

—

ověřeno

—

dokončeno

—

Tato tři pole, důkazy výše a stav závislostí jsou vše, z čeho se stav skládá. Neexistuje žádné pole stavu, které by s nimi mohlo být v rozporu.

Canonical record: .ai/repo/project/issues/I3187.yaml. Read it back with majordomus plan show I3187.