feat: wire retro-demoscene widgets into premium dashboard (#291)

Integrate the 4 retro-demoscene widget modules (CRT shader, plasma
canvas, tracker view, oscilloscope) into the BernsteinApp dashboard
with keybindings, visibility toggles, and live agent data flow.

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: chernistry

src/bernstein/cli/dashboard.py

@@ -39,6 +39,10 @@
 
 from bernstein.cli.icons import get_agent_icon, get_icons, get_status_icon
 from bernstein.cli.visual_theme import PALETTE, budget_color, model_color, role_color, sample_gradient, status_color
+from bernstein.tui.crt_shader import CRTMode, CRTShader
+from bernstein.tui.oscilloscope import OscilloscopeWidget
+from bernstein.tui.plasma import PlasmaCanvas
+from bernstein.tui.tracker_view import TrackerView
 
 logger = logging.getLogger(__name__)
 
@@ -1367,6 +1371,23 @@ class BernsteinApp(App[None]):
         overflow-y: auto;
         border-right: heavy $border;
     }
+
+    #retro-bar {
+        height: auto;
+        max-height: 20;
+    }
+
+    #plasma-canvas {
+        height: 12;
+    }
+
+    #tracker-view {
+        height: 16;
+    }
+
+    #oscilloscope {
+        height: 16;
+    }
     """
 
     #: Resize debounce delay in seconds (TUI-001).
@@ -1385,6 +1406,10 @@ class BernsteinApp(App[None]):
         Binding("d", "compare_task", "Diff"),
         Binding("v", "compare_task", "Diff", show=False),
         Binding("i", "inspect_task", "Open", show=False),
+        Binding("C", "toggle_crt", "CRT"),
+        Binding("P", "toggle_plasma", "Plasma"),
+        Binding("T", "toggle_tracker", "Tracker"),
+        Binding("O", "toggle_scope", "Scope"),
     ]
 
     def __init__(self, **kw: Any) -> None:
@@ -1403,6 +1428,7 @@ def __init__(self, **kw: Any) -> None:
         self._last_activity: list[str] = []
         self._compare_mark: str | None = None  # first task ID for compare
         self._resize_timer: object | None = None  # debounce timer handle (TUI-001)
+        self._crt_shader = CRTShader(CRTMode.OFF)
 
     def compose(self) -> ComposeResult:
         yield DashboardHeader(id="header-bar")
@@ -1416,6 +1442,10 @@ def compose(self) -> ComposeResult:
         with Vertical(id="activity-bar"):
             yield Static("ACTIVITY", classes="col-header")
             yield RichLog(id="activity-log", wrap=True, markup=True, auto_scroll=True)
+        with Vertical(id="retro-bar"):
+            yield PlasmaCanvas(id="plasma-canvas")
+            yield TrackerView(id="tracker-view")
+            yield OscilloscopeWidget(id="oscilloscope")
         with Horizontal(id="expert-row"):
             yield ExpertCostPanel(id="expert-cost")
             yield ExpertBanditPanel(id="expert-bandit")
@@ -1477,6 +1507,9 @@ def on_mount(self) -> None:
             except Exception as exc:
                 logger.warning("Failed to read evolve.json: %s", exc)
 
+        # Retro-demoscene widgets hidden by default (toggled via keybindings)
+        self.query_one("#retro-bar").display = False
+
         # Write startup messages to activity log
         log = self.query_one("#activity-log", RichLog)
         log.write(_format_activity_line("system", "Bernstein starting..."))
@@ -1529,6 +1562,7 @@ def _check_agents_file(self) -> None:
                         costs: dict[str, Any] = {}
                         self._update_agents(agents, costs)
                         self._update_activity(agents)
+                        self._update_retro_widgets(agents)
             except Exception:
                 pass
 
@@ -1644,6 +1678,7 @@ def _apply_data(self, data: dict[str, Any]) -> None:
         }
         self._update_stats(data.get("status"), tasks, data.get("agents", []), costs, monitoring)
         self._update_activity(data.get("agents", []))
+        self._update_retro_widgets(data.get("agents", []))
 
     # -- Agents --
 
@@ -2223,6 +2258,66 @@ def action_toggle_expert(self) -> None:
         else:
             self.notify("Novice mode  [e] to toggle on", severity="information", timeout=3)
 
+    def action_toggle_crt(self) -> None:
+        """Cycle CRT phosphor shader mode."""
+        mode = self._crt_shader.cycle_mode()
+        self.notify(f"CRT: {mode.value}", timeout=2)
+
+    def action_toggle_plasma(self) -> None:
+        """Show/hide the demoscene plasma canvas."""
+        retro = self.query_one("#retro-bar")
+        plasma = self.query_one("#plasma-canvas", PlasmaCanvas)
+        plasma.display = not plasma.display
+        # Show retro bar if any retro widget is visible
+        retro.display = (
+            plasma.display
+            or self.query_one("#tracker-view", TrackerView).display
+            or self.query_one("#oscilloscope", OscilloscopeWidget).display
+        )
+
+    def action_toggle_tracker(self) -> None:
+        """Show/hide the tracker-style task monitor."""
+        retro = self.query_one("#retro-bar")
+        tracker = self.query_one("#tracker-view", TrackerView)
+        tracker.display = not tracker.display
+        retro.display = (
+            self.query_one("#plasma-canvas", PlasmaCanvas).display
+            or tracker.display
+            or self.query_one("#oscilloscope", OscilloscopeWidget).display
+        )
+
+    def action_toggle_scope(self) -> None:
+        """Show/hide the braille oscilloscope."""
+        retro = self.query_one("#retro-bar")
+        scope = self.query_one("#oscilloscope", OscilloscopeWidget)
+        scope.display = not scope.display
+        retro.display = (
+            self.query_one("#plasma-canvas", PlasmaCanvas).display
+            or self.query_one("#tracker-view", TrackerView).display
+            or scope.display
+        )
+
+    def _update_retro_widgets(self, agents: list[dict[str, Any]]) -> None:
+        """Feed agent data to retro-demoscene widgets."""
+        plasma = self.query_one("#plasma-canvas", PlasmaCanvas)
+        if plasma.display:
+            plasma.update_activity(len(agents))
+
+        tracker = self.query_one("#tracker-view", TrackerView)
+        if tracker.display:
+            tracker.update_agents(agents)
+
+        scope = self.query_one("#oscilloscope", OscilloscopeWidget)
+        if scope.display:
+            scope.update_agents(agents)
+            samples: dict[str, float] = {}
+            for a in agents:
+                sid = a.get("session_id", a.get("id", ""))
+                if sid:
+                    samples[sid] = a.get("tokens_per_sec", 0.0)
+            if samples:
+                scope.add_samples(samples)
+
     def action_stop_bernstein(self) -> None:
         """Backward-compatible stop -- delegates to drain."""
         self.action_graceful_quit()

tests/unit/test_dashboard_retro_integration.py

@@ -0,0 +1,22 @@
+"""Tests for retro-demoscene widget integration in the dashboard."""
+
+from __future__ import annotations
+
+from bernstein.tui.crt_shader import CRTMode, CRTShader
+
+
+def test_crt_shader_integration():
+    shader = CRTShader(CRTMode.OFF)
+    mode = shader.cycle_mode()
+    assert mode == CRTMode.AMBER
+    assert shader.active
+
+
+def test_retro_widgets_importable():
+    from bernstein.tui.oscilloscope import OscilloscopeWidget
+    from bernstein.tui.plasma import PlasmaCanvas
+    from bernstein.tui.tracker_view import TrackerView
+
+    assert PlasmaCanvas is not None
+    assert TrackerView is not None
+    assert OscilloscopeWidget is not None