Add wmux-client-terminal: TUI client for wmux

[shmuelhizmi]

Summary

• New @playfast/wmux-client-terminal package — renders wmux in the terminal using OpenTUI's React reconciler, connecting via echoform WebSocket transport
• Exposes token and wsUrl on WmuxHandle so consumers can pass credentials to renderWmuxTUI()
• Adds TUI demo entry point (bun run tui in demo/dev-server)

Features

• Sidebar with categories, tabs, and colored status dots
• VT100 terminal buffer (cursor movement, ANSI colors, erase commands, carriage returns)
• File viewer with line numbers
• Tmux-style Ctrl+B prefix for TUI commands — all other keys pass directly to the active PTY
• Auto-scroll to bottom on terminal output (stickyScroll)
• Web client link in top bar header
• Proper lifecycle cleanup via onDestroy callback and uncaught error handlers

Usage

import { wmux } from "@playfast/wmux";
import { renderWmuxTUI } from "@playfast/wmux-client-terminal";

const handle = await wmux({ /* config */ });
await renderWmuxTUI({
  token: handle.token,
  wsUrl: handle.wsUrl,
  webUrl: handle.url,
});

Test plan

• Run bun run tui in demo/dev-server/ — verify sidebar, terminal output, keyboard input
• Test Ctrl+B prefix: j/k to navigate, 1-9 for categories, r restart, s stop, q quit
• Verify shell prompt renders correctly (no stray characters)
• Verify auto-scroll follows new output
• Verify web link appears in top bar

🤖 Generated with Claude Code