TL;DR

Beads now offers enhanced configuration options for Dolt mode (a version-controlled database), improved issue creation and management, and more robust error handling, making it easier to integrate with existing workflows and maintain data integrity.

Breaking

• Dolt Mode Configuration: The dolt.mode configuration key now requires a value of either server or embedded, and will issue a warning for ambiguous configurations.

New

• Copilot CLI Setup: Added a recipe to easily set up Beads with the Copilot CLI (AI pair programmer).
• Gemini/Claude Hooks: Beads can now integrate with Gemini and Claude via JSON hooks, with a new --hook-json flag for configuration and a migration for existing hooks.
• Schema Skew Guard: A new feature prevents forward database drift, ensuring data consistency.

Fixes Worth Knowing

• Issue Creation: Labels are now correctly committed during initial issue creation. Deferred dates are handled correctly.
• Dolt Integration: Improved detection of managed Dolt handoff port conflicts and origin adoption on first push.
• Export Functionality: Fixed issues with auto-export failing on git add errors and overwriting existing JSONL files.
• Audit Entropy: Increased entropy for new IDs to improve security.

Before You Upgrade

• If you are using the dolt.mode configuration, ensure it is set to either server or embedded.

TL;DR

Beads now correctly detects databases embedded within .dolt directories, improving usability with the Dolt (version controlled data) system.

Fixes Worth Knowing

• Beads now lists all convoy-type formulas when displaying available formulas.
• Database discovery now works correctly when databases are located inside .dolt directories.