swactor/crates/dashboard/AGENTS.md

# Dashboard crate contract

Keep this crate read-only with respect to observed programs.

- It may ingest telemetry frames.
- It may retain bounded raw-frame and view state for HTML/API rendering.
- It may host universal swactor runtime views.
- It must not send control signals to observed runtimes.
- It must not require changes outside `crates/dashboard` for dashboard-only work.

Main built-in view: the fused control plane at `/` and `/view/fleet` (node cards with machine + actor rollup, per-node roster, per-actor dossier via `/api/view/fleet/detail`), backed by `host.*`, `proc.<label>.lifecycle`, `runtime.stats`, and `runtime.actors` frames when present. It is a pure frame consumer, tolerant of publisher shape. Message history is folded view-side from `messages_processed` deltas — no producer changes. The unified navbar is injected server-side from the view registry; pages opt in with a `<!--swactor:nav-->` placeholder.
refactor(dashboard): rebuild around swactor worker view Replace telemetry/history/plugin/topology/warnings layer with store/view and swactor worker_page/worker_view fed by datastream frames. Add mvp-system local_e2e_cluster harness; archive pipeline-parallel-inference to old-pipeline-parallel-inference. Signed-off-by: Zachery Aaron Shores-Chmielewski <zacheryasc@gmail.com> 2026-06-25 07:29:16 +00:00			`# Dashboard crate contract`
feat: tui, agent interface, stats hook (#29) Runtime dashboard now features a TUI option and an interface for LLM tool use. Removed some bloat from stats collecting and replaced with a hook function to dump runtime stats into. Signed-off-by: Zachery Aaron Shores-Chmielewski <zacheryasc@gmail.com> 2026-02-11 15:23:26 +00:00
refactor(dashboard): rebuild around swactor worker view Replace telemetry/history/plugin/topology/warnings layer with store/view and swactor worker_page/worker_view fed by datastream frames. Add mvp-system local_e2e_cluster harness; archive pipeline-parallel-inference to old-pipeline-parallel-inference. Signed-off-by: Zachery Aaron Shores-Chmielewski <zacheryasc@gmail.com> 2026-06-25 07:29:16 +00:00			`Keep this crate read-only with respect to observed programs.`
feat: tui, agent interface, stats hook (#29) Runtime dashboard now features a TUI option and an interface for LLM tool use. Removed some bloat from stats collecting and replaced with a hook function to dump runtime stats into. Signed-off-by: Zachery Aaron Shores-Chmielewski <zacheryasc@gmail.com> 2026-02-11 15:23:26 +00:00
refactor: `datastream` crate is now `telemetry` The crate is the per-node metrics/logging pipe with a universal subscriber endpoint, but "datastream" kept getting misread as a general messaging plane. Rename crate, module paths, and public API (`DatastreamEndpoint` → `TelemetryEndpoint`, etc.) so misuse is visible on sight. Renamed contracts (all in-repo producers/consumers migrated): - env vars `MYELIN_DATASTREAM_` → `MYELIN_TELEMETRY_` - artifact `datastream.ndjson` → `telemetry.ndjson` - actor names `telemetry-publisher` / `telemetry-sink` - wire ALPN `swactor/telemetry/0` - `DATASTREAM_SPEC.md` → `TELEMETRY_SPEC.md` Also fixes two latent test breaks: `process` and `iroh-driver` tests imported `DatastreamEvent` from the crate root, which was never re-exported; they now use the observer path `telemetry::frame::`. 2026-08-15 08:17:48 +00:00			`- It may ingest telemetry frames.`
refactor(dashboard): rebuild around swactor worker view Replace telemetry/history/plugin/topology/warnings layer with store/view and swactor worker_page/worker_view fed by datastream frames. Add mvp-system local_e2e_cluster harness; archive pipeline-parallel-inference to old-pipeline-parallel-inference. Signed-off-by: Zachery Aaron Shores-Chmielewski <zacheryasc@gmail.com> 2026-06-25 07:29:16 +00:00			`- It may retain bounded raw-frame and view state for HTML/API rendering.`
			`- It may host universal swactor runtime views.`
			`- It must not send control signals to observed runtimes.`
			- It must not require changes outside `crates/dashboard` for dashboard-only work.
feat: tui, agent interface, stats hook (#29) Runtime dashboard now features a TUI option and an interface for LLM tool use. Removed some bloat from stats collecting and replaced with a hook function to dump runtime stats into. Signed-off-by: Zachery Aaron Shores-Chmielewski <zacheryasc@gmail.com> 2026-02-11 15:23:26 +00:00
feat(dashboard): fused control-plane view with unified navbar and stale pooling Replace fleet/actor-overview/actor-dossier/workers views and the root link list with one ControlPlaneView serving / and /view/fleet: node cards fuse machine stats with actor rollup, node click opens machine detail + roster, actor click opens an in-page dossier (identity, message diet, sparkline, sampled message history via /api/view/fleet/detail). - Message history folds view-side from messages_processed deltas: 16-receipt ring, 250ms spacing, sampled-out counters — noisy actors cannot flood the page and producers stay untouched. - Stale streams render in a separate collapsed pool; superseded life generations are evicted immediately; stale pool hard-capped at 50. - Unified navbar injected server-side from the view registry; pages opt in with a <!--swactor:nav--> placeholder so app-registered views appear automatically. Hardcoded per-page navs stripped. - Rust type names are the actor display name; address is the unique key. Stale doc comment claiming types are not on the frame fixed. 2026-08-15 22:42:40 +00:00			Main built-in view: the fused control plane at `/` and `/view/fleet` (node cards with machine + actor rollup, per-node roster, per-actor dossier via `/api/view/fleet/detail`), backed by `host.*`, `proc.<label>.lifecycle`, `runtime.stats`, and `runtime.actors` frames when present. It is a pure frame consumer, tolerant of publisher shape. Message history is folded view-side from `messages_processed` deltas — no producer changes. The unified navbar is injected server-side from the view registry; pages opt in with a `<!--swactor:nav-->` placeholder.