Release v0.24.3

New Features

Version Management & Auto-Migration

• Built-in version tracking (bd-loka): bd now tracks its own version in metadata.json
• Auto-migrate database on CLI version bump (bd-jgxi): Database schema migrations happen automatically when upgrading
• metadata.json version tracking validation in bd doctor (bd-u4sb)
• Agent upgrade awareness documentation and tooling

Command Set Improvements

• Complete command set standardization (bd-au0)
• --shared flag for bd hooks install: Install versioned hooks that can be committed to git

Integration & Tooling

• Aider integration: Proper YAML config format for beads issue tracking
• BEADS_SYNC_BRANCH environment variable: Override sync branch configuration
• --upgrade-mcp flag for bump-version.sh script

Monitor Web UI Enhancements

• Interactive filters on stats cards
• Find-as-you-type filtering functionality
• Improved UX/UI with better card layout, alignment, and status toggle
• Fixed priority filter and search clear button behavior

Bug Fixes

Data Consistency & Sync

• Handle FOREIGN KEY constraint violations gracefully during import (bd-koab)
• Auto-fix metadata.json jsonl_export mismatch (bd-afd)
• Enforce ZFC (JSONL First Consistency): Refuse export when DB >> JSONL (bd-l0r)
• Fix ZFC: Only force import when DB >> JSONL (stale DB)
• Remove mtime fast-path in hasJSONLChanged (bd-v0y): More reliable change detection
• Fix N+1 query pattern in export operations (bd-rcmg): Performance improvement
• Remove invalid closed_at for open status (bd-1rh)
• Fix unvalidated dependency parsing in create.go

Merge & Conflict Resolution

• Merge conflicts now prefer closed>open and deletion>modification (bd-pq5k)
• Support both canonical and legacy JSONL filenames in merge driver check
• Auto-repair stale merge driver configs with invalid placeholders

Git Hooks & Configuration

• Add executable bit validation for git hooks (bd-fwul)
• Auto-configure sync.branch during bd init (bd-flil)
• bd doctor check and fix for missing sync.branch config (bd-rsua)
• Improve pre-push hook: Suggest bd sync with auto-sync option

Daemon & IPC

• Fix race condition in client socket cleanup (bd-4owj)
• Daemon respects auto-commit/auto-push DB config (#360)
• Use dynamic JSONL path in daemon sync branch operations (#361)
• Improve staleness check error handling (bd-2q6d, bd-o4qy, bd-n4td)

Security & Permissions

• Change file permissions from 0644 to 0600 for better security
• Add security tests for WriteFile permissions in doctor command

Cross-Platform & CI

• Fix Windows CI test failures
• Fix Windows and Nix test failures
• Fix linter issues and test failures
• Fix TestAddCommentUpdatesTimestamp timing flake on Windows
• Skip /etc/passwd check on Windows in security test (#363)
• Remove duplicate context variable declarations in benchmark tests
• Remove TestFallbackToDirectModeEnablesFlush from test skip list

User Experience

• Fix GH#366: Encourage descriptions when creating issues
• Fix GH#367: bd import defaulting to stdin is confusing
• Fix priority 0 bug display using nullish coalescing
• Add missing yellow color function in init.go
• Fix unused variable in init.go

Error Handling

• Add configurable export error handling policies (bd-exug)
• Add comprehensive error handling guidelines documentation

Documentation

• Mark FastMCP outputSchema issue as resolved in README
• Add beads-ui to Community & Ecosystem section
• Remove Beadster link from README
• Add tests and documentation for --shared hooks feature

Testing

• Add explicit cache validation tests for blocked_issues_cache
• Add security tests for WriteFile permissions in doctor command

Full Changelog: v0.24.2...v0.24.3