bv

Beads Viewer to narzędzie do analizy struktury projektów Beads. Oblicza 9 metryk grafu (PageRank, betweenness, ścieżkę krytyczną, cykle) i generuje plany wykonania. Zamiast parsować surowy plik beads.jsonl, otrzymujesz gotowe rekomendacje o wąskich gardłach i zależnościach. Tryb robot (flagi --robot-*) pozwala agentom AI na szybkie zapytania z niskim kosztem kontekstu.

1. Zainstaluj narzędzie bv w swoim środowisku (np. przez pip lub npm, w zależności od dystrybucji). Upewnij się, że plik .beads/beads.jsonl istnieje w katalogu projektu.

2. Nigdy nie uruchamiaj samego polecenia bv — otwiera interaktywny interfejs TUI, który blokuje sesję. Zawsze używaj flag --robot-*.

3. Uruchom bv --robot-triage jako główne polecenie. Zwraca ono pełną analizę: top 5 wąskich gardeł, cykle w zależnościach, metryki PageRank i betweenness, oraz plan wykonania. To najczęściej używane polecenie.

4. Jeśli potrzebujesz szybkiej odpowiedzi, użyj bv --robot-next — zwraca tylko jeden najważniejszy element do wykonania. Dla pełnego planu równoległych ścieżek użyj bv --robot-plan.

5. Aby zobaczyć wszystkie 9 metryk grafu (PageRank, betweenness, HITS, ścieżka krytyczna, eigenvector, degree, density, clustering, cycles), uruchom bv --robot-insights. Wynik jest strukturą JSON o stałym rozmiarze, idealna dla agentów AI.

6. Zintegruj wybrane polecenie w skrypt agenta lub pipeline CI/CD. Beads Viewer oblicza metryki deterministycznie, więc wyniki są powtarzalne i bezpieczne — cykle są zawsze jawnie flagowane.