Topology diagram: composed-layout follow-ups (drag-to-arrange, canonical docs image) #183

New issue

Open

opened 2026-08-27 11:58:35 -04:00 by mysticalsoap · 0 comments

mysticalsoap commented

2026-08-27 11:58:35 -04:00

Owner

Remaining follow-ups for the hybrid composed topology diagram (just diagram-composed, added in 68b0879):

Drag-to-arrange cluster placement — small vanilla HTML+JS page (no build step, same pattern as mysticalsoap-web) to drag the per-stack cluster boxes and persist positions back into CLUSTER_GRID in generate_diagram_composed.py, via a tiny local Python BaseHTTPRequestHandler save endpoint. Cluster content keeps regenerating from compose truth every run; only the outer placement becomes a saved preference. Would replace the current hand-authored row-flow grid.
Decide the canonical docs image — _helper/docs/images/docker-topology.svg currently holds the composed render as a preview, but just diagram unconditionally overwrites it back to the default tall-column layout. If the composed look sticks, wire the copy step into just diagram-composed (or stop just diagram from clobbering it) instead of re-copying by hand.
(Optional) curved cross-cluster edges — hand-drawn cross-cluster edges are straight clipped lines; a quadratic-bezier bow would read closer to dot's spline routing. Obstacle-avoiding routing around other clusters is out of scope.

Remaining follow-ups for the hybrid composed topology diagram (`just diagram-composed`, added in 68b0879): - **Drag-to-arrange cluster placement** — small vanilla HTML+JS page (no build step, same pattern as mysticalsoap-web) to drag the per-stack cluster boxes and persist positions back into `CLUSTER_GRID` in `generate_diagram_composed.py`, via a tiny local Python `BaseHTTPRequestHandler` save endpoint. Cluster *content* keeps regenerating from compose truth every run; only the outer placement becomes a saved preference. Would replace the current hand-authored row-flow grid. - **Decide the canonical docs image** — `_helper/docs/images/docker-topology.svg` currently holds the composed render as a preview, but `just diagram` unconditionally overwrites it back to the default tall-column layout. If the composed look sticks, wire the copy step into `just diagram-composed` (or stop `just diagram` from clobbering it) instead of re-copying by hand. - **(Optional) curved cross-cluster edges** — hand-drawn cross-cluster edges are straight clipped lines; a quadratic-bezier bow would read closer to dot's spline routing. Obstacle-avoiding routing around other clusters is out of scope.

mysticalsoap added the

general-admin

on-hold

labels

2026-08-27 11:58:35 -04:00