From beaeea8dab992a253567c5c74f2df144ff31a35a Mon Sep 17 00:00:00 2001 From: mikael-lovqvists-claude-agent Date: Sat, 28 Mar 2026 23:13:20 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20close=20last=20open=20question=20?= =?UTF-8?q?=E2=80=94=20graph=20lives=20in=20ESM=20web=20layer?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Graph representation is plain ESM objects in the web interface. No special format needed. Graph reconstruction, topology diffing, and layout logic belong in ESM rather than C. Future TUI/CLI tools reuse the same ESM libraries via Node.js. No open questions remain. Co-Authored-By: Claude Sonnet 4.6 --- architecture.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/architecture.md b/architecture.md index cbef961..6aec097 100644 --- a/architecture.md +++ b/architecture.md @@ -807,9 +807,10 @@ These were previously open questions and are now resolved: - **Transport for relay edges**: TCP only for now. UDP and shared memory (for local hops) are future considerations; the transport abstraction should accommodate them without the relay needing to care which is in use. - **Byte budgets**: soft limits with hysteresis — two thresholds (start dropping, stop dropping) to avoid thrashing at the boundary. - **Relay scheduler**: strict priority first. Additional policies (round-robin, weighted round-robin, deficit round-robin, source suppression) are documented in the Relay Design section and will be added later. The scheduler interface is pluggable so policies are interchangeable without touching routing logic. +- **Graph representation**: the graph lives in the web interface (ESM). No special format needed — plain objects, classes, and arrays. The web node queries all discovered peers for their wanted and runtime state, reconstructs the graph in-memory, and drives the UI from that. Future TUI/CLI controller tools reuse the same ESM libraries via Node.js. Complex graph logic (reconstruction, topology diffing, layout) is easier to maintain in ESM than in C and belongs there. --- ## Open Questions -- What is the graph's representation format — in-memory object graph, serialized config, or both? +None currently open.