bvlisted

# 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. Always use `--robot-*` flags: ```bash bv --robot-triage # THE MEGA-COMMAND: start here bv --robot-next # Minimal: just the single top pick bv --robot-plan # Parallel execution tracks bv --robot-insights # Full graph metrics ``` ## The 9 Graph Metrics BV computes these metrics to surface hidden project dynamics: | Metric | What It Measures | Key Insight | |--------|------------------|-------------| | **PageRank** | Recursive dependency importance | Foundational blockers | | **Betweenness** | Shortest-path traffic | Bottlenecks and bridges | | **HITS** | Hub/Authority dualit