Changelog

Copy Markdown View Source

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

0.1.0 - 2026-06-04

Initial release — a terminal dashboard for Beam Bots robots, built on ExRatatui.

Added

  • Dashboard layout. A multi-panel terminal UI — title bar, Safety, Joint Control, Commands, Events, Parameters, and a status bar — composed through ExRatatui's reducer runtime. Pure state transitions live in BB.TUI.State; BB.TUI.App wires input and async results to those transitions.
  • Safety panel. Arm / disarm / force-disarm controls with a confirmation popup for force-disarm, plus an animated throbber while disarming. Reflects the robot's live safety state (:armed / :disarmed / :disarming / :error).
  • Joint control panel. Position table showing joint type (revolute / prismatic / continuous), units (degrees / mm), visual range bars, last-commanded target markers, and simulated-joint tags. Direct keyboard position adjustment in 1%-of-range and 10%-of-range steps.
  • Commands panel. Lists available robot commands with Ready / Blocked indicators based on runtime state. Argument-less commands execute on Enter; commands with declared arguments open an inline edit mode (Tab / Shift+Tab to cycle fields, type-to-edit, Enter to run, Esc to cancel). Argument types — boolean, integer, float, atom, enum ({:in, [...]}), and string — are parsed before dispatch. Entered values are preserved per command across executions.
  • Parameters panel. Live parameter table grouped by path with real-time updates and schema-aware editing (min / max bounds drive 1%-of-range stepping). Bridge tabs surface remote-parameter lists fetched per bridge, editable through the same keys; press t to cycle tabs.
  • Event stream. Scrollable, color-coded event log with summaries and timestamps taken from BB.Message.wall_time (publish time, not arrival time). Pause / resume, clear, and Enter to open a detail popup showing the full payload.
  • High-rate sensor handling. The event log debounces repeats of the same {path, payload-type} within a one-second window so a fast sensor can't flood it, and sensor-driven re-renders are coalesced to ~30fps — keeping the UI responsive under high-rate telemetry while key presses, command results, and safety / parameter / state changes still render immediately. Both windows are tunable.
  • Status bar, help overlay, and theme system. Status bar shows robot name, safety indicator, runtime state, and contextual key hints; a scrollable help overlay lists the full keybinding reference; a consistent color palette provides semantic styles (safety colors, focus borders, panel headers).
  • Keyboard-driven navigation. Tab / Shift+Tab to cycle panels, number keys to jump directly to a panel, and vim-style j/k/h/l within panels.
  • SSH transport. Serve the dashboard over SSH; multiple operators can connect simultaneously, each with an isolated session (built on ExRatatui's :ssh transport).
  • Distribution attach. Run the TUI on the robot node and attach a thin renderer from any connected BEAM node (built on ExRatatui's :distributed transport).
  • Nerves support. Register the dashboard as a nerves_ssh subsystem so operators can attach over SSH on-device.
  • Runtime inspection. Snapshot, trace, and inject events into a running TUI via ExRatatui.Runtime — useful for debugging SSH sessions that aren't otherwise observable.
  • mix bb.tui task. Standalone launch — mix bb.tui --robot MyApp.Robot, with --ssh and distribution options.
  • mix bb_tui.install Igniter task. Adds bb_tui to a project, imports formatter rules, optionally scaffolds a BB robot, and wires up launch for the default, --ssh, or --nerves install shapes.
  • Headless test suite. Full coverage using Mimic and ExRatatui's test backend, including end-to-end tests that drive a real server via ExRatatui.Runtime.inject_event/2.