BV - Beads Viewer

A graph-aware triage engine for Beads projects (.beads/beads.jsonl). Computes 9 graph metrics, generates execution plans, and provides deterministic recommendations. Human TUI for browsing; robot flags for AI agents.

Why BV vs Raw Beads

Capability	Raw beads.jsonl	BV Robot Mode
Query	"List all issues"	"List the top 5 bottlenecks blocking the release"
Context Cost	High (linear with issue count)	Low (fixed summary struct)
Graph Logic	Agent must compute	Pre-computed (PageRank, betweenness, cycles)
Safety	Agent might miss cycles	Cycles explicitly flagged

Use BV instead of parsing beads.jsonl directly. It computes graph metrics deterministically.

CRITICAL: Robot Mode for Agents

Never run bare bv. It launches an interactive TUI that blocks your session.