Merge Conflicts

This runbook helps you resolve merge conflicts that occur during Dolt sync operations.

Symptoms

# Check database health
bd doctor

# Preview what fixes would be applied
bd doctor --dry-run

Step 1: Back up current state

cp -r .beads .beads.backup

Step 2: Check for conflicts

bd doctor

Step 3: Fix to reconcile

bd doctor --fix

Step 4: Verify state

bd list
bd stats

Step 5: Push resolved state

bd dolt push

Sync before and after work sessions using bd dolt pull / bd dolt push
Avoid concurrent modifications from multiple clones without the Dolt server running