From 3a186a69d618dd88a94c43c7a4ff45e2c7253b00 Mon Sep 17 00:00:00 2001 From: Steve Yegge Date: Mon, 15 Dec 2025 00:10:40 -0800 Subject: [PATCH] docs: prepare v0.30.0 changelog and whats-new entry MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Add comprehensive CHANGELOG entry for v0.30.0 (tombstone architecture) - Add v0.30.0 to versionChanges in info.go for `bd info --whats-new` - Acknowledge 13 community contributors 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 --- CHANGELOG.md | 106 ++++++++++++++++++++++++++++++++++++++++++++++++- cmd/bd/info.go | 18 +++++++++ 2 files changed, 123 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 774cebe3..e74342ee 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ## [Unreleased] +## [0.30.0] - 2025-12-15 + +**Tombstone Architecture** - This release completes the migration to inline tombstones +for soft-delete, replacing the legacy `deletions.jsonl` manifest. This is intended to +be the last significant architectural change to Beads' storage format. + ### Added - **Inline tombstones for soft-delete (bd-vw8)** @@ -21,7 +27,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - Archives old file as `deletions.jsonl.migrated` - Use `--dry-run` to preview changes -- **Enhanced Git Worktree Support** (bd-737): Comprehensive compatibility improvements for git worktrees using shared database architecture +- **`bd doctor` tombstone health checks (bd-s3v)** + - Detects orphaned tombstones (missing from database) + - Identifies expired tombstones ready for pruning + - Warns about tombstone/live issue conflicts + +- **Enhanced Git Worktree Support (bd-737)** - Comprehensive compatibility improvements using shared database architecture - Shared `.beads` database across all worktrees in a repository - Worktree-aware database discovery prioritizes main repository - Git hooks automatically adapt to worktree context @@ -30,6 +41,99 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - Worktree lifecycle management with sparse checkout for sync branches - Automatic detection and user-friendly warnings for worktree conflicts +- **MCP Context Engineering Optimizations (GH #481)** - 80-90% context reduction + - Smarter tool response formatting reduces token usage + - Compaction configuration options for MCP server + - Extended context engineering documentation + +- **`bd thanks` command (GH #555)** - Thank contributors to your project + - Lists contributors with their contribution counts + - Useful for acknowledgments and community building + +- **`BD_NO_INSTALL_HOOKS` environment variable (GH #500)** + - Set to disable automatic git hook installation + - Useful for CI environments or custom hook setups + +- **Claude Code skill marketplace installation (GH #468)** + - Beads skill now installable via Claude Code marketplace + - Slash commands updated to use `beads:` prefix (GH #467) + +- **Smithery integration (GH #501)** - "Run in Smithery" badge for easy MCP server deployment + +- **`bd version` shows commit and branch (GH #504)** - Better version diagnostics + +### Fixed + +- **Daemon delete auto-sync (GH #528, #537)** + - Delete operations now properly trigger auto-sync to sync branch + - RPC support for delete mutations + - Fixed sync branch commits failing with pre-commit hooks (GH #521) + +- **`close_reason` persistence (GH #551)** - Close reasons now properly saved to database on close + +- **`bd migrate-tombstones` corruption fix (GH #554)** - Prevents corrupting deletions manifest during migration + +- **JSONL-only mode improvements (GH #549)** + - Proper `GetReadyWork`/`GetBlockedIssues` implementation for memory storage + - Fixed child counters in no-database mode + - Better detection and error messages (GH #534) + +- **Tombstone sync fixes** + - Preserve tombstones in `sanitizeJSONLWithDeletions` (bd-kzxd) + - Include tombstones when building ID map during import + - Clear `closed_at` when converting closed issue to tombstone + - Include tombstones in `getCurrentJSONLIDs` to prevent doctor corruption (GH #552) + +- **Sync safety improvements** + - Protect locally exported issues from sanitization (bd-3ee1) + - Add safety guards for issue deletion in blocked command + - Retry with rebase for concurrent push conflicts + - Protect local issues from git-history-backfill during sync (GH #485) + +- **Windows fixes** + - `bd onboard` no longer hangs on Windows (GH #531) + - Restored Windows smoke tests (reverted by #478) + +- **External `BEADS_DIR` support** - Sync now works with beads data in separate git repository + +- **Go version inconsistencies and broken documentation links (GH #535)** + +- **Stealth mode path fix (GH #538)** - Use project-specific paths in global gitignore + +- **Daemon sync-branch hook incompatibility detection (GH #532)** + +### Performance + +- **Lock file improvements (GH #484, #555)** + - Fixed stale startlock delay + - Fast fail on stale lock from crashed process + - Comprehensive benchmarks added + - Test coverage improved from 42% to 98% + +### Documentation + +- Agent memory patterns using comments (GH #487) - @bryceroche +- Added beads_viewer TUI to third-party tools (GH #515) - @aspiers +- Go install fallback instructions and uninstall documentation + +### Contributors + +Thanks to our community contributors for this release: + +- @aspiers - Documentation for beads_viewer +- @AodhanHayter - Nix version fix (GH #502) +- @broady - close_reason persistence (GH #551) +- @bryceroche - Agent memory documentation (GH #487) +- @cerebustech-dev - Sync protection fix (GH #485) +- @cpdata - Daemon sync fixes (GH #521, #528, #537) +- @gurdasnijor - Smithery badge (GH #501) +- @loganthomas - Documentation fixes (GH #535) +- @mahawi1992 - MCP context optimizations (GH #481) +- @maphew - Version output and migration fix (GH #504, #554) +- @rsnodgrass - `bd thanks` and benchmarks (GH #484, #555) +- @schpet - Claude Code skill marketplace (GH #467, #468) +- @withzombies - `BD_NO_INSTALL_HOOKS` env var (GH #500) + ## [0.29.0] - 2025-12-03 ### Added diff --git a/cmd/bd/info.go b/cmd/bd/info.go index 93014dd4..224bdc9b 100644 --- a/cmd/bd/info.go +++ b/cmd/bd/info.go @@ -287,6 +287,24 @@ type VersionChange struct { // versionChanges contains agent-actionable changes for recent versions var versionChanges = []VersionChange{ + { + Version: "0.30.0", + Date: "2025-12-15", + Changes: []string{ + "TOMBSTONE ARCHITECTURE - Deleted issues become inline tombstones in issues.jsonl (bd-vw8)", + "bd migrate-tombstones - Convert legacy deletions.jsonl to inline tombstones (bd-8f9)", + "bd doctor tombstone health checks - Detects orphaned/expired tombstones (bd-s3v)", + "Git Worktree Support (bd-737) - Shared database across worktrees, worktree-aware hooks", + "MCP Context Engineering (GH #481) - 80-90% context reduction for MCP responses", + "bd thanks command (GH #555) - List contributors to your project", + "BD_NO_INSTALL_HOOKS env var (GH #500) - Disable automatic git hook installation", + "Claude Code skill marketplace (GH #468) - Install beads skill via marketplace", + "Daemon delete auto-sync (GH #528, #537) - Delete operations trigger auto-sync", + "close_reason persistence (GH #551) - Close reasons now saved to database on close", + "JSONL-only mode improvements (GH #549) - GetReadyWork/GetBlockedIssues for memory storage", + "Lock file improvements (GH #484, #555) - Fast fail on stale locks, 98% test coverage", + }, + }, { Version: "0.29.0", Date: "2025-12-03",