beads/website/docs/cli-reference/recompute-blocked.md
matt wilkie dfa8ea4813
fix(docgen): generate CLI docs in one process (#4474)
Add a bulk help docs writer that emits the root CLI reference and website command pages from a single Cobra walk. Update the shell generator to call that mode, preserve the pure-Go docs binary guard, and refresh historical versioned CLI docs only when release snapshotting requests a specific version.

Agent-Signature: codex-gpt-5.5-medium on behalf of matt wilkie
2026-06-22 18:25:58 -07:00

1.2 KiB

id title slug sidebar_position
recompute-blocked bd recompute-blocked /cli-reference/recompute-blocked 999

Generated from bd help --doc recompute-blocked

bd recompute-blocked

Recompute the denormalized is_blocked flag for every issue and wisp.

is_blocked is derived from the dependency graph and maintained automatically by local writes and by a post-pull recompute scoped to what the merge changed. If that scoped recompute is skipped — a recompute that failed after its merge committed, or a conflicted pull resolved by hand — the flag can go stale, and a later pull that merges nothing will not refresh it (bd-6dnrw.37). 'bd ready' trusts the flag, so stale values silently hide ready work or surface blocked work.

This command runs the full recompute unconditionally and commits the result. It is idempotent: on a consistent database it changes nothing. Works in both embedded and server mode (unlike 'bd doctor', which is server-mode only).

Examples: bd recompute-blocked # Repair stale is_blocked flags bd recompute-blocked --json # Machine-parseable {"rows_corrected": N}

bd recompute-blocked [flags]