Expand description
incin-viz - out-of-process terminal UI for observing live Incin
training runs. Tails an out-of-process telemetry transport (see
incin-telemetry) and renders it through a plugin-extensible panel
system (see incin-viz-plugin-api).
Modules§
- app
- Application state and event-loop integration for the visualizer.
incin-viz’s application state andtokio::select!-driven async event loop, multiplexing three streams: terminal input (crossterm::event::EventStream), transport-tail polling, and a fixed render tick. - dispatch
- Dispatches telemetry data and user actions to visualizer panels.
Host-owned panic-containment layer: every
Paneltrait-method call fromapp.rs’s event loop is routed through one of these wrapper functions, never called on the panel directly. This is the only boundary between untrusted-quality (not untrusted-intent) plugin code and host process stability – see PLUGIN-03 / T-08-01 in08-04-PLAN.md’s threat model. - err
- Errors reported while loading or rendering visualizer data.
Centralized error type for
incin-viz, mirroringincin-telemetry’serr.rsconvention. - panels
- Built-in panels for graph, loss, norm, scalar, and system views.
Built-in panels proving the plugin pipeline end-to-end (Plan 08-05):
a real loss
Chartpanel and a deliberate panic-test panel. Both implementincin_viz_plugin_api::panel::Panelwith zero access to any incin-viz-internal-only API (PLUGIN-01/PLUGIN-02’s “no privileged API” property). - transport_
reader - Reads schema-versioned telemetry events from a run transport.
Read-side counterpart to
incin-telemetry’sTransporttrait: a poll-based tailer for the JSONL transport file a training process writes to.