ContextQMD
Back to Beads

Recovery Overview

website/docs/recovery/index.md

1.0.31.2 KB
Original Source

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

IssueSymptomsRunbook
Database CorruptionSQLite errors, missing dataDatabase Corruption
Merge ConflictsDolt conflicts during syncMerge Conflicts
Circular DependenciesCycle detection errorsCircular Dependencies
Sync Failuresbd dolt push/bd dolt pull errorsSync Failures

Quick Diagnostic

Before diving into specific runbooks, try these quick checks:

bash
# 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