beads/website/docs/recovery/index.md
Ben Madore 3b39ce577a
docs: update user-facing URLs from steveyegge/beads to gastownhall/beads
Co-authored-by: Ben Madore <823868+madorb@users.noreply.github.com>
2026-04-24 08:17:42 -07:00

1.3 KiB

sidebar_position title description
1 Recovery Overview Diagnose and resolve common Beads issues

Recovery Overview

This section provides step-by-step recovery procedures for common Beads issues. Each runbook follows a consistent format: Symptoms, Diagnosis, Solution (5 steps max), and Prevention.

Common Issues

Issue Symptoms Runbook
Database Corruption SQLite errors, missing data Database Corruption
Merge Conflicts Dolt conflicts during sync Merge Conflicts
Circular Dependencies Cycle detection errors Circular Dependencies
Sync Failures bd dolt push/bd dolt pull errors Sync Failures

Quick Diagnostic

Before diving into specific runbooks, try these quick checks:

# Check Beads status
bd status

# Verify Dolt server is running
bd doctor

# Check for blocked issues
bd blocked

:::tip Most issues can be diagnosed with bd status. Start there before following specific runbooks. :::

Getting Help

If these runbooks don't resolve your issue:

  1. Check the FAQ
  2. Search existing issues
  3. Open a new issue with diagnostic output