Module tui 

Detached TUI Monitor (SPEC-FT-001 Section 10)

Implements the producer-consumer pattern for real-time training visualization.

Architecture

┌──────────────┐          ┌──────────────┐
│  Trainer     │──write──▶│  Metric      │◀──read──│  TUI Monitor │
│  (Producer)  │          │  Store (IPC) │          │  (Consumer)  │
└──────────────┘          └──────────────┘          └──────────────┘

The TUI runs in a separate process/shell, reading state without blocking training.

Usage

# Shell 1: Start training (writes to metric store)
cargo run --example finetune_test_gen -- --output ./experiments/ft-001

# Shell 2: Attach TUI monitor (reads from metric store)
cargo run --example finetune_test_gen -- --monitor --experiment ./experiments/ft-001

Toyota Way: Andon (アンドン)

Visual alerting system for immediate problem detection. Loss spikes, OOM warnings, and gradient explosions trigger visual alerts.

Re-exports

pub use app::TrainingStateWriter;

pub use app::TuiMonitor;

pub use app::TuiMonitorConfig;

pub use color::colored_bar;

pub use color::colored_value;

pub use color::ColorMode;

pub use color::Rgb;

pub use color::Styled;

pub use color::TrainingPalette;

pub use dashboard::TrainingDashboard;

pub use headless::HeadlessGpu;

pub use headless::HeadlessMonitor;

pub use headless::HeadlessOutput;

pub use headless::HeadlessSample;

pub use headless::HeadlessWriter;

pub use headless::OutputFormat;

pub use panel::layout_can_render;

pub use panel::verify_layout;

pub use panel::GpuPanel;

pub use panel::LossCurvePanel;

pub use panel::MetricsPanel;

pub use panel::Panel;

pub use panel::PanelVerification;

pub use panel::ProcessPanel;

pub use panel::SamplePanel;

pub use render::render_braille_chart;

pub use render::render_gauge;

pub use render::render_layout;

pub use render::render_layout_colored;

pub use render::BrailleChart;

pub use state::GpuProcessInfo;

pub use state::GpuTelemetry;

pub use state::LossTrend;

pub use state::SamplePeek;

pub use state::TrainingSnapshot;

pub use state::TrainingState;

pub use state::TrainingStatus;

Modules

app

TUI Monitor Application (SPEC-FT-001 Section 10)

color

Terminal Color Support (ENT-122)

dashboard

Presentar-based Training Dashboard Widget (ALB-047/048/057)

headless

Headless Output Mode (SPEC-FT-001 Section 10.8)

panel

Panel Verification System (probar-compliant)

render

TUI Rendering - Clean, Simple, Labeled Layout

state

Training State for IPC (SPEC-FT-001 Section 10.1)