bd-dolt-troubleshooter
Diagnose and repair beads (bd) issue-tracker problems caused by its Dolt backend — including engine-mode mismatches, DATABASE MISMATCH repo-ID errors, corrupt auto-backups that revert writes, dolt sql-server lock contention, hook-timeout stash-wipes, orphaned server leaks, and schema version skew (remote-backed migration blocks or client behind DB). Use when bd won't start, daemon-error is present, bd writes revert, issues.jsonl is out of sync, untracked files vanish on commit, or bd fails with "refusing to auto-apply pending schema migrations".
- Version
- 1.9.1
- License
- Apache-2.0
- Compatibility
- Requires the `bd` (beads) CLI and a repo with a `.beads/` directory using the Dolt backend. Diagnostic scripts are POSIX sh; tested on macOS and Linux.
Pinned to revision 3f5a7bccce88, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/bd-dolt-troubleshooter/SKILL.md
- skills/bd-dolt-troubleshooter/assets/process-flow.dot
- skills/bd-dolt-troubleshooter/assets/process-flow.webp
- skills/bd-dolt-troubleshooter/references/cgo-and-schema-drift.md
- skills/bd-dolt-troubleshooter/references/recovery-playbook.md
- skills/bd-dolt-troubleshooter/references/schema-version-skew.md
- skills/bd-dolt-troubleshooter/references/symptoms.md
- skills/bd-dolt-troubleshooter/scripts/diagnose.sh
- skills/bd-dolt-troubleshooter/scripts/find-dolt-server.sh
- skills/bd-dolt-troubleshooter/scripts/inspect-binary.sh
- skills/bd-dolt-troubleshooter/scripts/repair-corrupt-backup.sh
- skills/bd-dolt-troubleshooter/scripts/repair.sh
- skills/bd-dolt-troubleshooter/scripts/restore-bd.sh
Every link opens the file at its source, pinned to the revision this page describes.