docs: instance peering described from fact (#124) #151

Merged

Cordy merged 1 commit from docs/peering-124 into main

2026-08-09 03:03:09 +00:00

Cordy commented

2026-08-09 03:02:53 +00:00

Owner

Closes #124. Written once, after #106 passed, from what actually shipped — exactly as the issue prescribed.

README: peering entry in Features (trust model, e2e encryption, allow-lists, Inbox delivery, runtime switch, test button, notifications, perUserHomes prerequisite stated) + peering in the opt-in config-block list.
example.config.json: peering block with the three default paths, annotated.
ARCHITECTURE.md: new §10 Instance peering (implemented) — model, transport (single-port h2c/ALPN incl. the #140/#143 lessons), both-direction fail-closed authorization, data path through the full decorator stack, runtime operation. Milestones renumbered to §11; the v0.5 milestone bullet now records the ship date and points at §10 instead of speaking in future tense.
docs/handbook/peering.md: new operator+user page — prerequisites, the alias-is-the-join-key pairing walkthrough (product-neutral hostnames), allow-lists, sending/receiving UX, a troubleshooting table mapping every error the dogfood actually hit, security properties. Index table updated; peering removed from the backlog line.

example.config.json verified still valid JSON.

Closes #124. Written once, after #106 passed, from what actually shipped — exactly as the issue prescribed. - **README**: peering entry in Features (trust model, e2e encryption, allow-lists, Inbox delivery, runtime switch, test button, notifications, `perUserHomes` prerequisite stated) + `peering` in the opt-in config-block list. - **example.config.json**: `peering` block with the three default paths, annotated. - **ARCHITECTURE.md**: new **§10 Instance peering (implemented)** — model, transport (single-port h2c/ALPN incl. the #140/#143 lessons), both-direction fail-closed authorization, data path through the full decorator stack, runtime operation. Milestones renumbered to §11; the v0.5 milestone bullet now records the ship date and points at §10 instead of speaking in future tense. - **docs/handbook/peering.md**: new operator+user page — prerequisites, the alias-is-the-join-key pairing walkthrough (product-neutral hostnames), allow-lists, sending/receiving UX, a troubleshooting table mapping every error the dogfood actually hit, security properties. Index table updated; peering removed from the backlog line. `example.config.json` verified still valid JSON.

Cordy added 1 commit

2026-08-09 03:02:55 +00:00