Canvas document: simple versioned format with JSON, Markdown and image export #93

New issue

Open

opened 2026-10-08 10:43:37 +00:00 by kayg · 1 comment

kayg commented

2026-10-08 10:43:37 +00:00

Owner

Owner (2026-10-08): the canvas should live in a very simple format that exports easily to JSON, Markdown and pretty images.

Today the clusters mockup keeps the canvas in an in-memory model (apps/tracer/src/clusters-model.ts, proto-clusters). It mixes in viewport pixel sizes and mock terminal lines, and nothing is persisted. D178 makes the canvas per account and synced, so it needs a canonical document.

Proposal (to grill before building):

One versioned JSON document per account ({ "version": 1, "views": [...] }). It is viewport-independent: view positions on the coarse grid in cells; columns with relative width weights; windows as { id, kind, ref }, where ref points to a session, container, VM or node id. It holds no content (no scrollback, no secrets) and no device camera (that stays per device, D178).
Stored server-side and synced live (D178). Small, so it diffs cheaply.
Markdown export: a readable outline (view → column → window kind, host and session name).
Image export through the share studio (separate issue).
Import of the same JSON (restore or move a layout).
Privacy: exports hide IPs and hostnames on request, matching the D120 share defaults.

Owner (2026-10-08): the canvas should live in a very simple format that exports easily to JSON, Markdown and pretty images. Today the clusters mockup keeps the canvas in an in-memory model (`apps/tracer/src/clusters-model.ts`, proto-clusters). It mixes in viewport pixel sizes and mock terminal lines, and nothing is persisted. D178 makes the canvas per account and synced, so it needs a canonical document. Proposal (to grill before building): - **One versioned JSON document per account** (`{ "version": 1, "views": [...] }`). It is viewport-independent: view positions on the coarse grid in cells; columns with relative width weights; windows as `{ id, kind, ref }`, where `ref` points to a session, container, VM or node id. It holds no content (no scrollback, no secrets) and no device camera (that stays per device, D178). - Stored server-side and synced live (D178). Small, so it diffs cheaply. - **Markdown export:** a readable outline (view → column → window kind, host and session name). - **Image export** through the share studio (separate issue). - **Import** of the same JSON (restore or move a layout). - Privacy: exports hide IPs and hostnames on request, matching the D120 share defaults.

kayg commented

2026-10-08 10:59:04 +00:00

Author

Owner

Owner answers recorded as D180 (main). Internal format is ours; exports JSON, Markdown, image, Excalidraw; JSON Canvas only if cheap. Grants referenced by name only. Topology renamed Mesh.

kayg referenced this issue

2026-10-08 12:51:37 +00:00

Per-account canvas document: server storage and live sync by operations (D178, D180) #98

kayg referenced this issue

2026-10-08 20:18:29 +00:00

Per-account canvas document: server storage and live sync by operations (D178, D180) #98

kayg referenced this issue

2026-10-09 07:00:16 +00:00

Per-account canvas document: server storage and live sync by operations (D178, D180) #98

kayg referenced this issue

2026-10-09 07:03:39 +00:00

Per-account canvas document: server storage and live sync by operations (D178, D180) #98