instance-moves-p7
P7 of #175: the edge-local door. An app's own processes on a box (Tito's router, relay and import-sync loop) dial /run/carlos/edge-local.sock with Host: <instance> and a door key. The edge serves the request as a request from the box itself, carrying the box's public address over https. It wakes a local instance, backhauls to the box that homes the host, and applies the password gate. Apps stop computing socket paths, so moves (P1 to P4) and the isolated-layout pass (P9) stop breaking their routers.
How it holds together:
- The door grants nothing a public request from the same box lacks. Paul ruled on 2026-09-28 that no caller-supplied visitor address is believed.
- The door key says which app is calling, and confines it to that app's hosts. The console's database is the authority for keys. Boxes read a signed, revisioned record that expires after 72 h and is re-signed every 12 h.
- For a remote host, the door checks the owner that host's box publishes in its edges file, and only for single-owner hostnames.
Status:
- Tasks 1 to 7 are built and committed. The Fable whole-branch review found no blockers, and three of its notes are fixed.
- The plan went through six Astra rounds; all findings are committed unedited beside it.
- Waiting on Paul's copy review of 19 strings, including the docs passage. Then the docs go in and the branch merges.
Dormant until a box sets CARLOS_EDGE_DOOR. Turning it on for carlos-tito-ie needs scoped approval.
Human
P7 of #175: a box-local edge door for app routers, authenticated by an app-scoped console-signed door key.
Commits
15
Discussions
0
0 open
Tasks
11/11
done
Discussions
- No discussions on this branch yet.
Tasks 11/11 done
- P7 plan written Done
- P7 plan: Astra review, fold in findings Done
- P7 Task 1: doorkey package Done
- P7 Task 2: console door-key doors Done
- P7 Task 3: carlos instances door-key Done
Activity
- task updated: P7: final review (Fable: no blockers, 3 notes fixed), CI green, merge
- task updated: P7 Task 8: docs and copy review
- claude agent, operated by paul@keymail.dev pushed 5b9a6ae53 P7: approved copy for the door-key CLI and doors; the edge-local door in the CLI reference (#175)
- claude agent, operated by paul@keymail.dev pushed acddcd435 docs: P7 plan, as built: Fable's final-review notes
- claude agent, operated by paul@keymail.dev pushed 586838de2 P7: fold in three notes from Fable's final review (#175)
- task updated: P7 Task 5: door ownership rule
- task updated: P7 Task 6: door handler and listener
- task updated: P7 Task 7: arm the door (CARLOS_EDGE_DOOR)
- claude agent, operated by paul@keymail.dev pushed 1fd2c9391 edge: the edge-local door, dormant until CARLOS_EDGE_DOOR (#175 P7)
- task updated: P7 Task 4: edges files publish owners; edge mirrors door keys
- claude agent, operated by paul@keymail.dev pushed 99516ad5e edges files publish single owners; the edge mirrors signed door keys (#175 P7)
- task updated: P7 Task 3: carlos instances door-key
- task updated: P7 Task 2: console door-key doors
- task updated: P7 plan: Astra review, fold in findings
- claude agent, operated by paul@keymail.dev pushed 4c7f39c69 docs: P7 plan round-6 findings (unedited): ready to build
- claude agent, operated by paul@keymail.dev pushed c65ceff35 cli: carlos instances door-key create, list, revoke (#175 P7)
- claude agent, operated by paul@keymail.dev pushed 3098e4d05 console: door keys, with the database as authority and a re-signed projection (#175 P7)
- claude agent, operated by paul@keymail.dev pushed 256645fce docs: P7 plan rev 6 (a door request is a request from the box); round-5 findings unedited; round-6 brief
- claude agent, operated by paul@keymail.dev pushed 083b5c123 doorkey: the edge-local door's app-scoped, root-signed, expiring credential (#175 P7)
- task updated: P7 Task 1: doorkey package
- claude agent, operated by paul@keymail.dev pushed bb1be8385 docs: P7 plan rev 5 (192.0.0.8, header strip, cache bypass); round-4 findings unedited; round-5 brief
- claude agent, operated by paul@keymail.dev pushed 7ebc545ee docs: P7 plan rev 4 (no address trust, Paul 2026-09-28); round-3 findings unedited; round-4 brief
- claude agent, operated by paul@keymail.dev pushed 4db75572a docs: P7 plan rev 3: one privilege, fewer mechanisms; round-2 findings unedited; round-3 brief
- claude agent, operated by paul@keymail.dev pushed ed1c5faad docs: P7 plan rev 2, folding in Astra round 1; round-1 findings unedited; round-2 brief
- task updated: P7 plan written
- claude agent, operated by paul@keymail.dev added task P7 Task 8: docs and copy review
- claude agent, operated by paul@keymail.dev added task P7: final review (Fable: no blockers, 3 notes fixed), CI green, merge
- claude agent, operated by paul@keymail.dev added task P7 plan: Astra review, fold in findings
- claude agent, operated by paul@keymail.dev added task P7 Task 1: doorkey package
- claude agent, operated by paul@keymail.dev added task P7 Task 2: console door-key doors