TL;DR

Beads now defaults to using a smarter remote migration gate, improving the reliability of data transfers and reducing manual intervention.

New

• The prime tool (data consistency checker) now alerts you when documentation for agents and Claude diverge, helping maintain accurate information.
• export now automatically exports JSONL data in SQL Server mode, simplifying data retrieval.

Fixes Worth Knowing

• Fixed an issue where working-set reconciliation commands could fail during table migrations.
• Resolved a schema dependency issue preventing proper operation.
• Corrected an error handling issue related to missing storage entries.

TL;DR

Beads now includes robust database migration tooling, improving reliability when upgrading and enabling remote-backed databases. Several fixes address data corruption risks and improve the overall stability of the system.

Breaking

• Remote Migration Gate: The remote-migrate gate is now stricter, potentially blocking upgrades if the remote isn't properly configured. Ensure your remote is accessible and healthy before upgrading.

New

• Metrics Command: A new bd metrics command provides insights into database performance and usage (performance monitoring).
• Improved Dependency Management: Deterministic dependency keys enhance merge safety across clones.
• Migration Content Hashing: Per-migration content hashes are recorded, improving the reliability of schema migrations.

Fixes Worth Knowing

• Data Corruption Fixes: Several fixes prevent potential data corruption during compaction, dependency resolution, and database upgrades.
• CLI Stability: Numerous CLI improvements address error handling, output rendering, and command behavior in various scenarios.
• Remote Access: Improved handling of remote access, including fixes for shared-server mode and remote-backed databases.

Before You Upgrade

• Verify Remote Access: Confirm your remote is accessible and healthy before upgrading, as the remote-migrate gate is now more sensitive.
• Review Migration History: If you've experienced issues with database upgrades in the past, review your migration history after upgrading to ensure everything is consistent.

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.