Design Documents
The architecture pages in this site are the narrative reference. Behind them are the original
engineering design documents — deeper, decision-level records of why each subsystem is built the way it
is, with measurements, trade-offs, and threat models. They are included here in full so that all project
knowledge lives in one place.
Note
These are engineering documents. Some contain source-path references (code/...) that are links within
the repository rather than this site.
Security, identity & tenancy
| Document |
Covers |
| Dynamic Cost-Aware Routing |
shipped — link-state push, Dijkstra path selection, source-route enforcement, self-organizing link inference |
| Optimal Global Routing Plan |
the design/roadmap; phases A/C/D are now implemented (see the architecture page above), B/E/F remain |
| Coordinator Decentralization Plan |
region-first autonomy + elected/sharded coordinators; decomposes the single static global by duty, confines consensus to liveness verdict + global optimization |
| Broker & Data-Plane Performance |
every broker/data-path performance change with measured effect and the config lever |
| Region Federation |
same-host region federation, identity-vs-IP self-detection |
| Network Link Metrics + Auto-Tuning |
per-edge RTT/jitter/throughput/backlog, the auto-tuner control loop, the link cost model |
| Control / Data Plane Isolation |
why priority alone is not enough, dedicated control sockets, the queue/topic bridge split, prefetch bounds, measured effect |
| stunnel Data Path |
tunnel vs session lifetimes, the per-tunnel demux, ordering guarantees, bounded waits and failure modes |
Health, metrics & capability
Exhaustive action reference