What problem does it solve?
Beads projects with complex dependency graphs often overwhelm manual triage. BV computes 9 graph metrics and generates deterministic recommendations to surface bottlenecks, plan work, and improve release health, all through an interactive human TUI or robot-friendly flags.
Core Features & Use Cases
- Graph metrics: PageRank, Betweenness, HITS, Critical Path, Eigenvector, Degree, Density, Cycles, and Topo Sort to reveal project dynamics.
- Two-phase analysis: instant basic metrics followed by a 500ms phase for deeper analytics, with status reporting for robustness.
- Robot-ready commands and outputs: triage, plan, insights, and exports for integration with agents and dashboards.
- Use Cases: triage top bottlenecks in beads.jsonl graphs; generate deterministic execution plans; detect structural issues like cycles.
Quick Start
Start with bv --robot-triage to surface top bottlenecks and generate an actionable plan.