feat(cli): refresh interactive terminal UI

Refresh the interactive terminal transcript, activity rail, and prompt visuals. Document the 2026-05-23 CLI update in README and keep generated CLI screenshots out of git.

Author: warren618

.gitignore

@@ -43,6 +43,8 @@ data/backup/
 docs/
 !wiki/docs/
 !wiki/docs/**
+docs/screenshots/agent-run.png
+docs/screenshots/boot.png
 data/minutes/
 data/overnight*.log
 data/*.log

CHANGELOG.md

@@ -5,6 +5,11 @@ This project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+### UI
+- Redesigned the interactive CLI startup and run-state visuals with a large
+  figlet-style banner plus a Claude Code-style activity rail using `●`, `│`,
+  and `·` glyphs. Non-TTY prompt runs now fall back to plain text output.
+
 ### Added
 
 ### Changed

README.md

@@ -46,12 +46,13 @@
 
 ## 📰 News
 
+- **2026-05-23** 🖥️ **Interactive CLI refresh**: The terminal front door now opens with a larger Vibe-Trading banner, a cleaner prompt divider, prior-turn recap, post-run timing, and a Claude Code-style activity rail for live agent work. Tool calls, web/data fetches, shell-style actions, Markdown answers, and pipe tables render in a more readable transcript, while piped or non-TTY runs keep plain-text output for automation. Generated CLI screenshots are now treated as local artifacts instead of committed docs files, keeping the repository lighter.
 - **2026-05-22** 🧭 **Swarm recovery + MCP keepalive**: Swarm status now reconciles from live task files on every read, so API/MCP/SSE/list views recover crashed or stale runs instead of showing permanent `running` snapshots. `run_swarm` sends MCP progress heartbeats while it polls, with a fixed first frame of `swarm_started run_id=<id>` for clients that reconnect after transport drops; workers now heartbeat through LLM streaming, grounding fetches, and tool execution. The stale-run reaper uses per-run thresholds and derives terminal status from task states, `SwarmTool` no longer cancels a still-running team just because its wait budget elapsed, and MCP clients can call `reap_stale_runs()` for explicit cleanup. Today's DX pass also refreshed provider default models and aligned CI syntax checks with the new `agent/cli/` package. 22 new regressions cover hydration, terminal recovery, stale reaping, keepalive cadence, env parsing, and heartbeat wiring; the full swarm/MCP suite is at 169 passed, 4 skipped.
 - **2026-05-21** 🧱 **CLI package refactor**: `agent/cli.py` (3216 LOC) split into the `agent/cli/` package — interactive front door, slash router, Rich components, plus a `_legacy.py` shim that preserves every subcommand and re-exports every public symbol so `cli.cmd_*` / `cli._INIT_ENV_PATH` / `cli.Confirm` keep working. New FastAPI middleware serves the SPA shell when a browser opens `/runs/{id}` or `/correlation` directly; same narrowing landed in the Vite dev proxy. Version unified via `cli/_version.py` (no more drift between `--version` and the banner), `python -m cli` restored via `__main__.py`, and the chat-gate narrowed so `chat --help` / `chat extra` reach legacy argparse instead of being swallowed by the REPL.
-- **2026-05-20** 🔬 **Hypothesis Registry CLI**: Closes the CLI side of the Hypothesis Registry shipped backend-only on 2026-05-16. `vibe-trading hypothesis list` prints a Rich table or JSON (`--status` filter, `--limit`); `show <id>` renders a detail panel including linked run cards; `invalidate <id> --note "..."` flips status to `rejected` while preserving prior invalidation notes when `--note` is omitted. Honors the existing `VIBE_TRADING_HYPOTHESES_PATH` env override and adds a per-invocation `--path`. 22 new tests cover wiring, JSON output, status filter, limit, missing-id errors, and note persistence.
 <details>
 <summary>Earlier news</summary>
 
+- **2026-05-20** 🔬 **Hypothesis Registry CLI**: Closes the CLI side of the Hypothesis Registry shipped backend-only on 2026-05-16. `vibe-trading hypothesis list` prints a Rich table or JSON (`--status` filter, `--limit`); `show <id>` renders a detail panel including linked run cards; `invalidate <id> --note "..."` flips status to `rejected` while preserving prior invalidation notes when `--note` is omitted. Honors the existing `VIBE_TRADING_HYPOTHESES_PATH` env override and adds a per-invocation `--path`. 22 new tests cover wiring, JSON output, status filter, limit, missing-id errors, and note persistence.
 - **2026-05-19** ✨ **Live tool feedback + graceful cancel**: Long-running tools (backtests, large PDFs, swarm workers) no longer look frozen. Each tool call now emits a 3-second heartbeat plus structured per-stage progress — `run_backtest` shows phase markers (`validate` / `simulate` / `finalize`), `read_document` ticks per page on PDF or per sheet on Excel, `read_url` marks `fetch` / `parse`. The CLI Rich Live dashboard renders a Unicode spinner, ASCII progress bar, ETA, and stacks up to 3 parallel tools keyed by name; the frontend chat ships a new `ToolProgressIndicator` with rAF-coalesced renders, ARIA `role="status"` + hidden native `<progress>` for screen readers, and a determinate `ProgressRing` SVG when total is known. First `Ctrl+C` during a CLI run now calls `agent.cancel()` for graceful exit (current step finishes, trace closes cleanly); a second within 2s force-quits. Reusable primitives extracted along the way: `ProgressBar.tsx` and `lib/tools.ts` (shared tool-name i18n).
 - **2026-05-18** 🧹 **Cleanup pass + three latent bug fixes**: `CompositeEngine` no longer misroutes bare Chinese-futures codes like `RB2410` to `GlobalFuturesEngine` — `_is_china_futures` moved into a shared `_market_hooks` module with a case-normalized product table and a non-CN exchange guard, plus 9 new regression cases. Session FTS5 indexes now persist timestamps so cross-session search can sort by date; the same path also fixed a re-upsert that was wall-clocking every session's `started_at`. The Vite dev-mode proxy gained the missing `/alpha` entry so the AlphaZoo page resolves on `npm run dev`. `tests/test_e2e_harness_v2.py` (real-LLM e2e suite) is now gated behind `VIBE_TRADING_RUN_LIVE_E2E=1` so CI no longer changes shape based on env-key presence. Ruff `per-file-ignores` added for the factor zoo (3783 → 0 F401 noise), frontend tsconfig enables `noUnusedLocals` / `noUnusedParameters` as regression guards, and 76 unused `vw = vwap(...)` boilerplate lines were dropped from `gtja191` alphas. Net **-918 LOC**.
 - **2026-05-17** 🧬 **Alpha Zoo v1 (0.1.8)**: 452 pre-built quant alphas across 4 zoos — `qlib158` (Microsoft Qlib, Apache-2 attribution), `alpha101` (Kakushadze 101 Formulaic Alphas, paper rewrite from arXiv:1601.00991), `gtja191` (Guotai Junan 2014 short-horizon factor report), and `academic` (Fama-French 5 + Carhart price-based proxies). One-line CLI to bench any zoo on your universe: `vibe-trading alpha bench --zoo gtja191 --universe csi300 --period 2018-2025`. Ships with AST purity gate, lookahead-guard test, `pytest-socket` network kill-switch, per-zoo LICENSE.md, and a Developer Certificate of Origin (DCO) workflow for community PRs. Auto-rendered Alpha Library at [vibetrading.wiki/alpha-library/](https://vibetrading.wiki/alpha-library/) + research-lab post [Which of the 191 GTJA alphas still work in 2026?](https://vibetrading.wiki/research-lab/posts/alpha-191-in-2026.html).
@@ -463,6 +464,8 @@ The default `agent/.env.example` ships with DeepSeek official API + `deepseek-v4
 
 ## 🖥 CLI Reference
 
+The interactive TUI (`vibe-trading`) now uses a terminal-native transcript: a startup banner, prompt rule, previous-turn recap, live activity rail, Markdown/table rendering, and run timing all stay in the CLI. Non-interactive invocations such as `vibe-trading run`, pipes, and `--json` remain script-friendly.
+
 ```bash
 vibe-trading               # interactive TUI
 vibe-trading run -p "..."  # single run

agent/cli/_legacy.py

@@ -784,6 +784,9 @@ def render(self) -> Panel:
         return Panel(body, title="Vibe-Trading", border_style="cyan", padding=(1, 1 if compact else 2))
 
 
+from cli.ui.rail import RailRunDashboard as _RunDashboard  # noqa: E402,F811
+
+
 # ---------------------------------------------------------------------------
 # Agent execution core
 # ---------------------------------------------------------------------------
@@ -1241,6 +1244,7 @@ def cmd_run(prompt: str, max_iter: int, *, json_mode: bool = False, no_rich: boo
             with Live(dashboard.render(), console=console, refresh_per_second=6, transient=True) as live:
                 dashboard.live = live
                 result = _run_agent(prompt, max_iter=max_iter, dashboard=dashboard)
+                dashboard.finish(result, time.perf_counter() - start)
     except KeyboardInterrupt:
         if json_mode:
             _print_json_result({"status": "cancelled", "run_id": None, "run_dir": None, "reason": "Interrupted"})
@@ -1334,6 +1338,7 @@ def cmd_continue(
                 max_iter=max_iter,
                 dashboard=dashboard,
             )
+            dashboard.finish(result, time.perf_counter() - start)
     except KeyboardInterrupt:
         console.print("\n[yellow]Interrupted[/yellow]")
         return EXIT_RUN_FAILED
@@ -1727,6 +1732,7 @@ def cmd_interactive(max_iter: int) -> None:
             with Live(dashboard.render(), console=console, refresh_per_second=6, transient=True) as live:
                 dashboard.live = live
                 result = _run_agent(user_input, history=history[-6:], max_iter=max_iter, dashboard=dashboard)
+                dashboard.finish(result, time.perf_counter() - start)
         except KeyboardInterrupt:
             console.print("\n[yellow]Interrupted[/yellow]")
             continue
@@ -3118,6 +3124,10 @@ def main(argv: list[str] | None = None) -> int:
         args = parser.parse_args(raw_argv)
     except SystemExit as exc:
         return int(exc.code) if isinstance(exc.code, int) else EXIT_USAGE_ERROR
+    if not sys.stdout.isatty():
+        args.no_rich = True
+        if hasattr(args, "run_no_rich"):
+            args.run_no_rich = True
 
     if args.command == "init":
         return cmd_init()

agent/cli/components/tool_event.py

@@ -2,9 +2,9 @@
 
 Layout (matches design_proposal §3.5):
 
-    ⏺ Get Financials ("AAPL", quarterly, last 8 quarters)         1.4s · 8 quarters
+    ● Get Financials ("AAPL", quarterly, last 8 quarters)         1.4s · 8 quarters
 
-* ``⏺`` (U+23FA media-record) marker, color-coded by status:
+* ``●`` (U+25CF black circle) marker, color-coded by status:
     running → ``--warning`` amber (pulse via Rich style ``blink`` when
               the terminal advertises it, otherwise solid amber)
     ok      → ``--success`` green, solid
@@ -174,7 +174,7 @@ def render_tool_event(
         # raising; CLI rendering should never crash the agent loop.
         status = "running"
 
-    marker = Text("⏺ ", style=_STATUS_STYLE[status])
+    marker = Text("● ", style=_STATUS_STYLE[status])
     line = Text()
     line.append(marker)
     line.append(_pretty_tool_name(name), style="bold")

agent/cli/input.py

@@ -7,7 +7,7 @@
       a plain Enter on a balanced buffer submits.
     * Ctrl+C with three-state semantics (clear buffer → exit hint → exit)
     * A surrogate-safe :class:`FileHistory` subclass for Windows users
-    * UTF-8 stdout reconfigure on Windows so the brand glyph ``⏺`` and the
+    * UTF-8 stdout reconfigure on Windows so the brand glyph ``●`` and the
       Rich box-drawing characters print without ``UnicodeEncodeError``
 
 Cancel-during-generation lives outside the input loop — that is owned by
@@ -18,6 +18,7 @@
 from __future__ import annotations
 
 import sys
+import shutil
 import time
 from pathlib import Path
 from typing import Optional
@@ -26,6 +27,10 @@
 from prompt_toolkit.formatted_text import FormattedText
 from prompt_toolkit.history import FileHistory
 from prompt_toolkit.key_binding import KeyBindings
+from prompt_toolkit.layout.containers import Window
+from prompt_toolkit.layout.controls import FormattedTextControl
+from prompt_toolkit.layout.dimension import Dimension
+from prompt_toolkit.styles import Style
 
 
 # Sentinel raised by the Ctrl+C path so the caller can distinguish
@@ -73,6 +78,32 @@ def _strip_surrogates(text: str) -> str:
 # ---------------------------------------------------------------- session ----
 
 
+class _VibePromptSession(PromptSession):
+    """PromptSession with a prompt-height that hugs the edited text."""
+
+    def _create_layout(self):  # type: ignore[no-untyped-def]
+        layout = super()._create_layout()
+        # prompt_toolkit's bottom_toolbar is a screen-bottom status bar. Insert
+        # our divider directly after the input container so it hugs the prompt.
+        layout.container.children.insert(1, _prompt_divider_window())
+        return layout
+
+    def _get_default_buffer_control_height(self) -> Dimension:  # type: ignore[override]
+        line_count = self.default_buffer.document.line_count
+        return Dimension.exact(max(1, line_count))
+
+
+def _prompt_divider_window() -> Window:
+    return Window(
+        FormattedTextControl(
+            lambda: FormattedText([("class:prompt-border", _prompt_rule())])
+        ),
+        height=1,
+        style="class:prompt-border",
+        dont_extend_height=True,
+    )
+
+
 def _force_utf8_stdout() -> None:
     """Reconfigure stdout to UTF-8 on Windows so brand glyphs render."""
     if sys.platform != "win32":
@@ -252,14 +283,21 @@ def make_session(history_path: Optional[Path] = None) -> PromptSession:
     from cli.completer import SlashCompleter
 
     ctrl_c_state = _CtrlCState()
-    session = PromptSession(
+    session = _VibePromptSession(
         history=SafeFileHistory(str(path)),
         completer=SlashCompleter(),
         complete_while_typing=True,
         key_bindings=_build_keybindings(ctrl_c_state),
         enable_history_search=True,
         mouse_support=False,
         multiline=True,
+        reserve_space_for_menu=0,
+        style=Style.from_dict(
+            {
+                "prompt": "#258bff bold",
+                "prompt-border": "#4b5563",
+            }
+        ),
     )
     # Expose the state so the outer loop can implement two-press exit.
     setattr(session, "vibe_ctrl_c_state", ctrl_c_state)
@@ -270,7 +308,7 @@ def make_session(history_path: Optional[Path] = None) -> PromptSession:
 
 
 def get_user_input(
-    prompt_message: str = "> ",
+    prompt_message: str = "❯ ",
     *,
     session: Optional[PromptSession] = None,
 ) -> str:
@@ -284,10 +322,20 @@ def get_user_input(
         EOFError: When the user hits Ctrl+D, or Ctrl+C on an empty line.
     """
     sess = session or make_session()
-    formatted = FormattedText([("class:prompt", prompt_message)])
+    formatted = FormattedText(
+        [
+            ("class:prompt-border", _prompt_rule() + "\n"),
+            ("class:prompt", prompt_message),
+        ]
+    )
     return sess.prompt(formatted)
 
 
+def _prompt_rule() -> str:
+    cols = shutil.get_terminal_size((88, 24)).columns
+    return "─" * max(10, cols)
+
+
 def ctrl_c_within_window(session: PromptSession, window_sec: float = _EXIT_HINT_GAP_SEC) -> bool:
     """Return True if the most recent Ctrl+C press was a "second press".