Skip to content

chore: upgrade beads to v0.56.1 with Dolt backend#180

Merged
nvandessel merged 1 commit intomainfrom
chore/upgrade-beads-dolt
Feb 28, 2026
Merged

chore: upgrade beads to v0.56.1 with Dolt backend#180
nvandessel merged 1 commit intomainfrom
chore/upgrade-beads-dolt

Conversation

@nvandessel
Copy link
Owner

Summary

  • Upgraded beads (bd) from v0.49.0 (SQLite) to v0.56.1 (Dolt backend)
  • Installed Dolt v1.83.0 as the database engine
  • Migrated all 150 issues from SQLite to Dolt server (verified with bd count, bd list, bd history, full CRUD cycle)
  • Updated AGENTS.md with Dolt workflow commands (bd dolt commit/push/pull, bd history, bd diff)
  • Cleaned up stale export-state files and SQLite artifacts
  • Updated git hooks to v0.56.1

Dolt Server Setup

The Dolt server runs at 127.0.0.1:3307 with data stored at ~/.dolt-data/beads. Start it with:

cd ~/.dolt-data/beads && dolt sql-server --port 3307

Test plan

  • bd count returns 150 issues
  • bd list --limit 5 shows correct issues
  • bd history <id> shows version history (Dolt feature)
  • Full CRUD: create, show, close, delete test issue
  • Existing worktrees unaffected (preserved, not touched)
  • bd doctor passes (1 cosmetic error: server mode lacks .beads/dolt/ dir, expected)

🤖 Generated with Claude Code

Migrated from SQLite (v0.49.0) to Dolt backend (v0.56.1).
Dolt provides git-like version control for the issue database,
enabling bd history, bd diff, and branch-aware issue tracking.

- Installed Dolt v1.83.0, bd v0.56.1 (from GitHub release)
- Migrated 150 issues from SQLite to Dolt server (127.0.0.1:3307)
- Updated AGENTS.md with Dolt workflow (bd dolt commit/push/pull)
- Removed stale export-state files (replaced by Dolt sync)
- Updated .beads/.gitignore for Dolt artifacts
- Updated git hooks to v0.56.1

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@greptile-apps
Copy link

greptile-apps bot commented Feb 28, 2026

Greptile Summary

Successfully migrated beads issue tracking from SQLite (v0.49.0) to Dolt backend (v0.56.1). This enables version history tracking with bd history and bd diff commands, replacing the previous git-based sync workflow with Dolt's native versioning.

Key changes:

  • Updated .beads/config.yaml to minimal Dolt-native sync configuration
  • Migrated .beads/metadata.json to reference Dolt server (port 3307)
  • Updated .beads/.gitignore to handle Dolt files instead of SQLite artifacts
  • Removed 61 stale export-state files (now gitignored)
  • Updated documentation (AGENTS.md, README.md) with new Dolt workflow commands

Migration validation:

  • ✅ All 150 issues migrated and verified
  • ✅ Full CRUD cycle tested
  • ✅ Existing worktrees preserved

The changes are straightforward infrastructure updates with proper testing validation.

Confidence Score: 5/5

  • Safe to merge - well-tested infrastructure migration with verified data integrity
  • This is a clean infrastructure upgrade with thorough testing. All 150 issues were migrated and verified through multiple validation steps (count, list, history, CRUD cycle). The changes are isolated to configuration and documentation files, with no code logic modifications. The simplified config.yaml removes helpful comments but doesn't affect functionality.
  • No files require special attention - all changes are configuration and cleanup

Important Files Changed

Filename Overview
.beads/config.yaml Simplified from 60+ lines of commented documentation to 2-line Dolt mode config
.beads/.gitignore Updated to ignore Dolt files instead of SQLite, added export-state/ to gitignore
.beads/metadata.json Updated backend from SQLite to Dolt with server configuration (port 3307)
.beads/README.md Updated sync command from bd sync to bd dolt push
AGENTS.md Updated beads commands to use Dolt workflow (bd dolt commit/push, bd history, bd diff)

Last reviewed commit: 9e560d9

Copy link

@greptile-apps greptile-apps bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

64 files reviewed, 1 comment

Edit Code Review Agent Settings | Greptile

@nvandessel nvandessel enabled auto-merge (squash) February 28, 2026 20:37
@nvandessel nvandessel merged commit 74519bd into main Feb 28, 2026
10 checks passed
@nvandessel nvandessel deleted the chore/upgrade-beads-dolt branch February 28, 2026 20:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant