beads/cmd/bd/info.go
beads/crew/emma 884cc1171e fix(release): revert all non-Linux targets to CGO_ENABLED=0, bump v0.63.3
Only Linux amd64/arm64 can cross-compile with CGO on the CI runner.
macOS needs CoreFoundation/Security frameworks, Windows needs mingw
with framework support, and Android/FreeBSD lack sysroot headers.
These platforms use server mode; embedded Dolt is Linux-only for now.
Removes zig setup (no longer needed — Linux arm64 uses system gcc).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-30 08:58:25 -07:00

1350 lines
61 KiB
Go

package main
import (
"fmt"
"path/filepath"
"strings"
"github.com/spf13/cobra"
"github.com/steveyegge/beads/internal/types"
)
var infoCmd = &cobra.Command{
Use: "info",
GroupID: "setup",
Short: "Show database information",
Long: `Display information about the current database.
This command helps debug issues where bd is using an unexpected database. It shows:
- The absolute path to the database file
- Database statistics (issue count)
- Schema information (with --schema flag)
- What's new in recent versions (with --whats-new flag)
Examples:
bd info
bd info --json
bd info --schema --json
bd info --whats-new
bd info --whats-new --json
bd info --thanks`,
Run: func(cmd *cobra.Command, args []string) {
schemaFlag, _ := cmd.Flags().GetBool("schema")
whatsNewFlag, _ := cmd.Flags().GetBool("whats-new")
thanksFlag, _ := cmd.Flags().GetBool("thanks")
// Handle --thanks flag
if thanksFlag {
printThanksPage()
return
}
// Handle --whats-new flag
if whatsNewFlag {
showWhatsNew()
return
}
// Get database path (absolute)
absDBPath, err := filepath.Abs(dbPath)
if err != nil {
absDBPath = dbPath
}
// Build info structure
info := map[string]interface{}{
"database_path": absDBPath,
"mode": "direct",
}
// Get issue count from direct store
if store != nil {
ctx := rootCtx
filter := types.IssueFilter{}
issues, err := store.SearchIssues(ctx, "", filter)
if err == nil {
info["issue_count"] = len(issues)
}
}
// Add config to info output
if store != nil {
ctx := rootCtx
configMap, err := store.GetAllConfig(ctx)
if err == nil && len(configMap) > 0 {
info["config"] = configMap
}
}
// Add schema information if requested
if schemaFlag && store != nil {
ctx := rootCtx
// Get schema version
schemaVersion, err := store.GetMetadata(ctx, "bd_version")
if err != nil {
schemaVersion = "unknown"
}
// Get tables
tables := []string{"issues", "dependencies", "labels", "config", "metadata"}
// Get config
configMap := make(map[string]string)
prefix, _ := store.GetConfig(ctx, "issue_prefix") // Best effort: empty prefix is valid
if prefix != "" {
configMap["issue_prefix"] = prefix
}
// Get sample issue IDs
filter := types.IssueFilter{}
issues, err := store.SearchIssues(ctx, "", filter)
sampleIDs := []string{}
detectedPrefix := ""
if err == nil && len(issues) > 0 {
// Get first 3 issue IDs as samples
maxSamples := 3
if len(issues) < maxSamples {
maxSamples = len(issues)
}
for i := 0; i < maxSamples; i++ {
sampleIDs = append(sampleIDs, issues[i].ID)
}
// Detect prefix from first issue
if len(issues) > 0 {
detectedPrefix = extractPrefix(issues[0].ID)
}
}
info["schema"] = map[string]interface{}{
"tables": tables,
"schema_version": schemaVersion,
"config": configMap,
"sample_issue_ids": sampleIDs,
"detected_prefix": detectedPrefix,
}
}
// JSON output
if jsonOutput {
outputJSON(info)
return
}
// Human-readable output
fmt.Println("\nBeads Database Information")
fmt.Println("===========================")
fmt.Printf("Database: %s\n", absDBPath)
fmt.Printf("Mode: direct\n")
// Show issue count
if count, ok := info["issue_count"].(int); ok {
fmt.Printf("\nIssue Count: %d\n", count)
}
// Show schema information if requested
if schemaFlag {
if schemaInfo, ok := info["schema"].(map[string]interface{}); ok {
fmt.Println("\nSchema Information:")
fmt.Printf(" Tables: %v\n", schemaInfo["tables"])
if version, ok := schemaInfo["schema_version"].(string); ok {
fmt.Printf(" Schema Version: %s\n", version)
}
if prefix, ok := schemaInfo["detected_prefix"].(string); ok && prefix != "" {
fmt.Printf(" Detected Prefix: %s\n", prefix)
}
if samples, ok := schemaInfo["sample_issue_ids"].([]string); ok && len(samples) > 0 {
fmt.Printf(" Sample Issues: %v\n", samples)
}
}
}
// Check git hooks status
hookStatuses := CheckGitHooks()
if warning := FormatHookWarnings(hookStatuses); warning != "" {
fmt.Printf("\n%s\n", warning)
}
fmt.Println()
},
}
// extractPrefix extracts the prefix from an issue ID (e.g., "bd-123" -> "bd")
// Uses the last hyphen before a numeric suffix, so "beads-vscode-1" -> "beads-vscode"
func extractPrefix(issueID string) string {
// Try last hyphen first (handles multi-part prefixes like "beads-vscode-1")
lastIdx := strings.LastIndex(issueID, "-")
if lastIdx <= 0 {
return ""
}
suffix := issueID[lastIdx+1:]
// Check if suffix is numeric
if len(suffix) > 0 {
numPart := suffix
if dotIdx := strings.Index(suffix, "."); dotIdx > 0 {
numPart = suffix[:dotIdx]
}
var num int
if _, err := fmt.Sscanf(numPart, "%d", &num); err == nil {
return issueID[:lastIdx]
}
}
// Suffix is not numeric, fall back to first hyphen
firstIdx := strings.Index(issueID, "-")
if firstIdx <= 0 {
return ""
}
return issueID[:firstIdx]
}
// VersionChange represents agent-relevant changes for a specific version
type VersionChange struct {
Version string `json:"version"`
Date string `json:"date"`
Changes []string `json:"changes"`
}
// versionChanges contains agent-actionable changes for recent versions
var versionChanges = []VersionChange{
{
Version: "0.63.3",
Date: "2026-03-29",
Changes: []string{
"NEW: Embedded Dolt is now the default storage backend — no separate server needed",
"NEW: bd create --graph for batch issue creation from dependency graphs",
"NEW: Multi-project/team sync for Linear, Jira, and ADO",
"NEW: Notion sync reimplemented on REST data sources",
"NEW: GitLab group-level issue sync",
"NEW: Top-level command aliases (comment, assign, tag, link, priority)",
"NEW: Storage API expansion — ListWisps, MergeSlot, ReopenIssue, and more",
"CHANGE: Backup system simplified — git-based backup removed, Dolt-native only",
"CHANGE: Dolt writeRetryTx auto-retries on serialization errors",
"FIX: Init git cache reset prevents stale embedded refs",
"FIX: CWD .beads/ priority over git-worktree resolution",
"FIX: Epic closure correctly includes wisp children",
"FIX: Prefix routing for edit, reopen, and delete commands",
"FIX: ADO/Jira custom type_map no longer silently ignored",
},
},
{
Version: "0.62.0",
Date: "2026-03-21",
Changes: []string{
"NEW: Custom status categories (active/wip/done/frozen) control bd ready and bd list behavior",
"NEW: bd statuses command lists all statuses with icons and categories",
"NEW: bd note command for quick note appending",
"NEW: Audit logging of status changes to interactions.jsonl",
"NEW: --exclude-type flag for bd ready and bd list",
"NEW: Azure DevOps integration (bd ado sync/status/projects)",
"NEW: Memories included in export/import round-trip",
"CHANGE: BEADS_ACTOR replaces BD_ACTOR as primary env var",
"CHANGE: ServerMode enum consolidates Dolt server ownership inference",
"CHANGE: Internal GT-specific concepts removed — beads is now standalone",
"FIX: Windows Dolt lifecycle — stale state files, false stop warnings",
"FIX: Hook preservation — all hooks preserved on core.hooksPath override",
"FIX: Shim timeout 30s→300s — chained hooks no longer killed prematurely",
"FIX: GetNextChildIDTx broken SQL CAST for non-numeric IDs",
"FIX: Credential key added to project-root .gitignore",
"FIX: Concurrent initSchemaOnDB serialized with GET_LOCK",
"FIX: External Dolt servers no longer killed by KillStaleServers",
},
},
{
Version: "0.61.0",
Date: "2026-03-15",
Changes: []string{
"NEW: --no-history flag separates Dolt commit skipping from GC eligibility",
"NEW: --claim-next on close auto-claims next ready issue",
"NEW: Auto-detect beads database on git origin during init/bootstrap",
"NEW: Install checksum verification (SHA256)",
"NEW: --exclude-type for wisp GC, --type filter for wisp list",
"NEW: Jira pull_jql config for custom JQL filters",
"CHANGE: Prime SSOT — versioned hash-based markers, profile support, staleness detection",
"CHANGE: Formula extends merges child steps by ID instead of appending",
"CHANGE: Circuit breaker keyed on host:port, not port only",
"CHANGE: Backup export/restore scoped by project prefix",
"FIX: Embedded Dolt CI — stale noms LOCK cleanup, test fixes",
"FIX: Port-0 circuit breaker poisoning prevention",
"FIX: KillStaleServers scoped to repo, port resolution chain fix",
"FIX: Doctor fingerprint, auto-start, runtime detection fixes",
"FIX: Credential key moved to .beads/ (no ghost directories)",
"FIX: UUID primary keys for federation-safe events/comments",
},
},
{
Version: "0.60.0",
Date: "2026-03-12",
Changes: []string{
"NEW: bd bootstrap executes recovery actions directly (hands-free repair)",
"NEW: bd context command for safe-first error guidance",
"NEW: bd help --list and --doc for CLI doc generation",
"NEW: bd done alias for bd close; bd done <id> <message> for inline close reason",
"NEW: --design-file flag for reading design from files",
"NEW: --destroy-token for safe non-interactive re-init (GH#2497)",
"NEW: GitHub Issues tracker plugin integration (GH#2373)",
"NEW: Global ~/.config/beads/PRIME.md fallback (GH#2330)",
"NEW: Shared Dolt server mode for multi-repo/agent setups (GH#2416)",
"NEW: Ephemeral port allocation replaces hash-derived Dolt ports (GH#2415)",
"NEW: Epic close guards with merge re-parenting and progress display",
"NEW: bd search searches external_ref field (GH#2494)",
"NEW: JSON-aware error output with JSONL schema validation (GH#2499)",
"NEW: ai.api_key config fallback for ANTHROPIC_API_KEY",
"CHANGED: Dolt ports are now OS-assigned ephemeral (no more collisions)",
"CHANGED: Auto-push state moved to local file (prevents metadata merge conflicts)",
"CHANGED: Charm glamour v2 and huh v2 upgrades",
"CHANGED: Final daemon and idle monitor infrastructure removal",
"FIX: Dolt journal corruption — KillStaleServers inside flock (GH#2430)",
"FIX: Dolt config corruption from stale working set (GH#2455)",
"FIX: Auto-commit before pull prevents merge errors (GH#2474)",
"FIX: DOLT_PULL wrapped in explicit transaction (GH#2501)",
"FIX: bd dolt remote operates on correct directory (GH#2306)",
"FIX: Metadata merge conflicts auto-resolved on pull (GH#2466)",
"FIX: bd list --json no longer ignored when --tree defaults to true",
"FIX: bd doctor --fix regenerates missing metadata.json (GH#2482)",
"FIX: bd init blocked from creating DB on wrong server (GH#2336)",
"FIX: Worktree hooks use absolute core.hooksPath (GH#2414)",
"FIX: BEADS_DIR stabilized from detached worktrees",
"PERF: Close-time template subgraph loading speed improvement (GH#2458)",
"NEW: Config-driven metadata schema enforcement",
"NEW: --metadata for bd create, --set-metadata/--unset-metadata for bd update",
"NEW: PreToolUse hook blocks interactive cp/mv/rm prompts",
"NEW: Self-managing Dolt server (port collision, idle monitor, crash watchdog)",
"NEW: bd dolt remote add/list/remove commands",
"NEW: Auto-push to Dolt remote with 5-minute debounce",
"NEW: Per-worktree .beads/redirect override",
"NEW: Counter mode (issue_id_mode=counter) for sequential IDs",
"NEW: Auto-migrate SQLite to Dolt on first bd command",
"NEW: Label inheritance — children inherit parent labels",
"NEW: Jira V2 API support",
"NEW: Linear Project sync support",
"FIX: Shadow database prevention — no more silent CREATE DATABASE",
"FIX: Reparented child no longer appears under old parent",
"FIX: Dolt port resolution uses ephemeral port (not hardcoded 3307)",
"FIX: Doctor checks respect dolt-data-dir config",
"FIX: UUID primary keys replace AUTO_INCREMENT (federation-safe)",
"FIX: Windows compatibility (Makefile, connectex, doltserver)",
"FIX: Batch SQL IN-clause queries prevent query explosion",
"FIX: Conditional-blocks deps evaluated in readiness checks",
"FIX: Migration safety — verify DB target, deduplicate, spot-check data",
"PERF: Test parallelization — storage 3.5x, protocol 3x faster",
"PERF: Branch-per-test isolation — doctor tests 44s → 12s",
},
},
{
Version: "0.59.0",
Date: "2026-03-05",
Changes: []string{
"NEW: bd list --tree is now the default display mode",
"NEW: bd doctor detects fresh clone state on Dolt server",
"NEW: bd init distinguishes server-reachable from DB-exists",
"NEW: bd setup includes OpenCode recipe",
"NEW: bd doctor warning suppression via config",
"CHANGED: Daemon infrastructure fully removed — bd is purely CLI-driven",
"CHANGED: Backup git-push defaults to OFF (explicit opt-in required)",
"FIX: bd doctor --fix repairs broken/orphaned hook markers (GH#2344)",
"FIX: Legacy hook migration warns on user-modified hooks",
"FIX: Dolt push/pull uses correct database subdirectory",
"FIX: Contributor auto-routing fallback for show/update/close (GH#2345)",
"FIX: Init port resolution uses DefaultConfig (GH#2372)",
"FIX: Idle monitor single-instance lock and port isolation (GH#2367)",
"FIX: Init prevents data destruction from misleading errors (GH#2363)",
"FIX: Circuit breaker cooldown reduced to 5s with TCP probe",
"FIX: Deterministic ordering with ID tiebreaker in all queries",
"FIX: Batch IN-clause queries prevent full table scans",
},
},
{
Version: "0.58.0",
Date: "2026-03-02",
Changes: []string{
"NEW: bd purge — delete closed ephemeral beads to reclaim storage",
"NEW: bd mol last-activity — show most recent molecule activity timestamp",
"NEW: bd show --current — show active issue without specifying ID",
"NEW: bd doctor validate — Dolt-native conflict detection",
"NEW: bd init --backend — explicit backend selection with SQLite deprecation",
"NEW: --stdin flag for bd create/update (alias for --body-file -)",
"NEW: bd preflight --check aligned with CI checks",
"NEW: JSONL-to-Dolt migration script for pre-0.50 users",
"NEW: bd create-form --parent for sub-issue creation with label inheritance",
"NEW: Persistent agent memory (bd remember/memories/recall/forget)",
"FIX: Dolt CPU spikes — batch IN-clause queries in dependencies",
"FIX: Dolt joinIter hangs in GetReadyWork blocker computation",
"FIX: Stealth mode (no-git-ops) now correctly prevents backup git push",
"FIX: Stale DB connection crash in bd edit",
"FIX: OSC escape leaks from third-party hook runners (lefthook, husky)",
"FIX: validateIssueIDPrefix now checks allowed_prefixes (unblocks convoys)",
"FIX: Molecule steps now appear in bd ready",
"FIX: Cross-prefix dependency routing and validation",
"FIX: Wisps table recreation on schema fast-path",
"FIX: bd search avoids LIKE %% full-table scans",
"REMOVED: SQLite backend and go-sqlite3 dependency (Dolt only)",
"REMOVED: Deprecated commands and legacy SQLite-era scripts",
},
},
{
Version: "0.57.0",
Date: "2026-03-01",
Changes: []string{
"NEW: bd doctor --agent mode for AI agent diagnostics",
"NEW: SSH push/pull fallback with dual-surface remote management",
"NEW: Hook migration system — census and migration planning",
"NEW: Section markers for git hooks (safer hook updates)",
"NEW: bd backup init/sync/restore for Dolt-native backups",
"NEW: bd gc, bd compact, bd flatten for standalone lifecycle",
"NEW: Circuit breaker for Dolt server connections",
},
},
{
Version: "0.56.1",
Date: "2026-02-23",
Changes: []string{
"FIX: Release CI — remove verify-cgo hook from CGO_ENABLED=0 builds (darwin, freebsd)",
},
},
{
Version: "0.56.0",
Date: "2026-02-23",
Changes: []string{
"REMOVED: Embedded Dolt mode — server-only; binary 168MB → 41MB",
"REMOVED: SQLite ephemeral store — wisps now in Dolt-backed table",
"REMOVED: JSONL sync pipeline — Dolt-native push/pull only",
"NEW: OpenTelemetry opt-in instrumentation for hooks and storage",
"NEW: Transaction infrastructure with isolation, retry, and batch wrapping",
"NEW: Metadata query support in bd list, bd search, bd query",
"FIX: Atomic bond/squash/cook operations (single transaction)",
"FIX: Double JSON encoding in daemon-mode RPC calls",
"FIX: bd ready parent filter and blocked status propagation",
"PERF: Test isolation from production Dolt server",
},
},
{
Version: "0.55.4",
Date: "2026-02-20",
Changes: []string{
"FIX: Release CI FreeBSD — CGO_ENABLED=0 (zig sysroot lacks stdlib.h)",
"FIX: Release CI macOS — CGO_ENABLED=0 for darwin (zig sysroot lacks frameworks)",
"FIX: Release CI libresolv — strip -lresolv from zig wrappers (macOS uses netgo)",
},
},
{
Version: "0.55.1",
Date: "2026-02-20",
Changes: []string{
"FIX: Release workflow YAML broken by heredoc in zig wrapper step",
"FIX: Version consistency (marketplace.json missed in v0.55.0 bump)",
"FIX: Go formatting and lint issues in 9 files",
},
},
{
Version: "0.55.0",
Date: "2026-02-20",
Changes: []string{
"FIX: Release CI upgraded zig 0.13→0.14 fixing AccessDenied cross-compilation bug",
"FIX: macOS libresolv resolution with zig 0.14 (-lresolv.9 workaround)",
"FIX: 5 pre-existing test failures and Dolt panic resolved",
"REMOVED: ~5K lines dead code from classic sync cleanup",
},
},
{
Version: "0.54.0",
Date: "2026-02-18",
Changes: []string{
"FIX: mol squash auto-closes wisp root to prevent Dolt lock errors",
"FIX: Release CI zig cross-compilation cache race (--parallelism 1)",
"FIX: Android ARM64 build uses CGO_ENABLED=0 (server mode only)",
"NEW: Mux setup recipe with layered AGENTS and managed hooks",
"CHORE: Remove daemon references from doctor system for post-daemon architecture",
"CHORE: Remove ~5K lines of dead code from classic cleanup",
"FIX: Upgrade zig 0.13.0 to 0.14.0 to fix AccessDenied bug in cross-compilation",
},
},
{
Version: "0.53.0",
Date: "2026-02-18",
Changes: []string{
"NEW: Dolt-in-Git sync — native Dolt push/pull via git remotes replaces JSONL pipeline",
"NEW: bd dolt start/stop — explicit Dolt server management (#1813)",
"NEW: bd dolt commit — desire-path ergonomics for Dolt data",
"NEW: Server mode without CGO — OpenFromConfig exported (#1805)",
"NEW: Hosted Dolt support — TLS, auth, explicit branch config",
"NEW: bd mol wisp gc --closed for bulk purge of closed wisps",
"NEW: Storage interface decouples from concrete DoltStore",
"NEW: Lock health diagnostics in bd doctor",
"FIX: Pre-commit deadlock on embedded Dolt (#1841)",
"FIX: bd doctor --fix hang — run fixes in-process (#1850)",
"FIX: Dolt lock errors surfaced with guidance (#1816)",
"FIX: BEADS_DIR config loading (#1854)",
"REMOVED: JSONL sync-branch pipeline (~11,000 lines deleted)",
"REMOVED: Daemon infrastructure, 3-way merge remnants, dead stubs",
},
},
{
Version: "0.52.0",
Date: "2026-02-16",
Changes: []string{
"NEW: bd ready --include-ephemeral flag to include ephemeral issues in ready work",
"FIX: Doctor redirect target resolution (#1803)",
"FIX: Guard dolt directory creation with server-mode check (#1800)",
"FIX: Tilde expansion in core.hooksPath on Windows (#1798)",
"FIX: Worktree redirect path resolution from worktree root (#1791)",
"FIX: Block rename-prefix in git worktrees (#1792)",
"REMOVED: Dead git-portable sync functions (#1793)",
},
},
{
Version: "0.51.0",
Date: "2026-02-16",
Changes: []string{
"REMOVED: Dolt-native cleanup — removed SQLite backend, JSONL sync, 3-way merge, tombstones, storage factory, daemon stubs (8-phase refactor)",
"CHANGED: bd sync is now a no-op — Dolt handles persistence directly",
"FIX: Dolt config test corruption in worktree environments (t.Setenv fix)",
"FIX: Batch DeleteIssues hang on large ID sets with correctness hardening",
"FIX: bd mol current step readiness uses analyzeMoleculeParallel",
"FIX: bd doctor AccessLock integration, --yes for repo fingerprint",
"FIX: GetReadyWork excludes workflow/identity types",
"PERF: CASCADE deletes cut deletion queries by 60%",
"PERF: Schema init skip when already at current version",
"DOCS: 10+ docs updated from SQLite to Dolt, deprecated docs removed",
},
},
{
Version: "0.50.3",
Date: "2026-02-15",
Changes: []string{
"REFACTOR: All tracker CLIs (Linear, GitLab, Jira) now use shared SyncEngine — eliminates ~800 lines of duplicated sync code",
"NEW: SyncEngine PullHooks/PushHooks for tracker-specific behaviors (GenerateID, FormatDescription, ContentEqual, etc.)",
"NEW: Jira native integration in internal/jira/ with REST API v3, ADF conversion, field mapping",
"NEW: Tracker plugin registry with auto-discovery (tracker.Register + init())",
"FIX: Jira State mapping bug — stale pointer assignment could cause incorrect status mapping",
"FIX: CI Windows build — test helper file renamed to _test.go suffix",
"PERF: Test suite — cached git template replaces ~60 subprocess calls",
},
},
{
Version: "0.50.1",
Date: "2026-02-14",
Changes: []string{
"CHANGED: Default backend is now Dolt for new bd init projects (existing SQLite projects unaffected)",
"NEW: bd graph terminal-native DAG visualization, DOT export, interactive HTML export",
"NEW: bd sql command for raw SQL access (table, JSON, CSV output)",
"NEW: bd help --all for complete command reference dump",
"NEW: decision built-in issue type",
"NEW: Cross-database dependency resolution via prefix routes in bd show/graph/blocked",
"NEW: bd doctor artifact cleanup (--check=artifacts --clean) and Dolt corruption recovery (--fix)",
"NEW: bd doctor Claude Code integration checks and grouped category output",
"REMOVED: Daemon/RPC subsystem and JSONL sync layer fully removed",
"FIX: bd close enforces gate satisfaction (--force to bypass)",
"FIX: bd show exits non-zero when issue not found",
"FIX: Dolt joinIter panic prevented (replaced IN/EXISTS subqueries with Go-level filtering)",
"FIX: Embedded Dolt self-deadlock in git hooks and bd migrate",
"FIX: bd ready excludes children of deferred parents",
},
},
{
Version: "0.49.6",
Date: "2026-02-09",
Changes: []string{
"REVERT: Embedded Dolt mode restored (removal was only intended for Gas Town, not Beads)",
"REMOVED: Daemon subsystem fully removed from bd CLI (Dolt replaces daemon-based sync)",
"REMOVED: JSONL flush/sync machinery deleted (-7,634 lines); JSONL functions are now no-ops",
"CLEANUP: Removed 171 dead daemonClient branches and 46 markDirtyAndScheduleFlush no-op calls",
},
},
{
Version: "0.49.5",
Date: "2026-02-08",
Changes: []string{
"NEW: bd search --has/--no flags for content and null-check filtering",
"NEW: bd promote command for wisp-to-bead promotion",
"NEW: bd todo command for lightweight task management",
"NEW: bd find-duplicates for AI-powered duplicate detection",
"NEW: bd validate integrated into bd doctor --check=validate",
"NEW: Dolt fail-fast TCP check before MySQL protocol init",
"SECURITY: SQL identifier validation prevents injection in dynamic table/db names",
"SECURITY: Path traversal fix in export handler; command injection fix in import",
"FIX: RPC mutation events now include issueID (was zero-value for label/dep ops)",
"FIX: Daemon YAML config recognizes both hyphen and underscore variants",
"FIX: Doctor role check falls back to database config",
"FIX: SQLite Close() idempotent (WAL retry deadlock fix)",
"FIX: SQLITE_BUSY retry for all BEGIN IMMEDIATE calls",
"FIX: Dolt cross-rig contamination prevented with prefix-based db names",
"FIX: bd list separates parent-child from blocks display",
"FIX: Cross-prefix ID resolution in multi-repo scenarios",
"CHANGE: Embedded Dolt mode fully removed (server-only connections)",
"CHANGE: bd init defaults to chaining hooks (no prompt)",
"CHANGE: brew upgrade command corrected to 'brew upgrade beads'",
},
},
{
Version: "0.49.4",
Date: "2026-02-05",
Changes: []string{
"NEW: --label-pattern and --label-regex flags for bd list and bd ready - glob and regex filtering on labels",
"NEW: Simple query language for complex bd list filtering",
"NEW: spec_id field for linking issues to specification documents",
"NEW: Wisp type field for TTL-based compaction of ephemeral molecules",
"NEW: Dolt schema migration runner and doctor validation checks",
"NEW: --metadata flag for bd update (JSON metadata from CLI)",
"NEW: config.local.yaml for local configuration overrides",
"FIX: JSONL file locking prevents race conditions in concurrent writes",
"FIX: Merge driver preserves all issue fields (spec_id, metadata, deps)",
"FIX: Atomic bd claim with compare-and-swap semantics",
"FIX: Dolt lock contention - advisory flock prevents zombie processes",
"FIX: Windows Dolt build via pure-Go regex backend",
"CHANGE: bd ready excludes in_progress issues (shows only claimable work)",
},
},
{
Version: "0.49.3",
Date: "2026-01-31",
Changes: []string{
"FIX: Dolt split-brain eliminated - DatabasePath() always resolves to .beads/dolt/ for dolt backend; JSONL auto-import blocked in dolt-native mode",
"CHANGE: Embedded Dolt is now the default - server mode is opt-in via dolt_mode: server",
"FIX: Dolt mergeJoinIter panic on type-filtered queries eliminated",
"FIX: CGO/ICU build - Makefile and test.sh auto-detect Homebrew icu4c paths on macOS",
},
},
{
Version: "0.49.2",
Date: "2026-01-31",
Changes: []string{
"NEW: GitLab backend - Bidirectional issue sync with GitLab (bd gitlab sync/status/projects)",
"NEW: Key-value store - bd kv get/set/delete/list for persistent key-value storage",
"NEW: Per-issue JSON metadata field for custom structured data (SQLite + Dolt)",
"NEW: Events JSONL export - Opt-in audit trail via events-export config",
"NEW: Role configuration - Explicit roles via git, interactive contributor prompt",
"NEW: bd backend and bd sync mode subcommands for storage inspection",
"NEW: Dolt auto-detect server mode during bd init",
"NEW: comment_count in JSON views, comment timestamps with --local-time",
"CHANGE: Removed Gas Town-specific code from beads core (hooks, validation, role types)",
"CHANGE: Storage layer refactored for backend-agnostic access",
"FIX: Worktree support - GIT_DIR/GIT_WORK_TREE in sync operations",
"FIX: Graceful Dolt server-to-embedded fallback",
"FIX: Multiple sync fixes for dolt-native mode and sync-branch",
"FIX: Formula handlebars, ephemeral sync exclusion, daemon idempotency",
},
},
{
Version: "0.49.1",
Date: "2026-01-25",
Changes: []string{
"NEW: Dolt backend fully supported - Extensively tested and ready for community evaluation",
"NOTE: Dolt is not enabled by default - We encourage users to try it and report feedback!",
"NEW: bd activity --details/-d - Full issue information in activity feed (#1317)",
"NEW: bd export --id/--parent - Targeted exports with filters (#1292)",
"NEW: bd update --append-notes - Append to existing notes (#1304)",
"NEW: bd show --id - For IDs that look like flags",
"NEW: bd doctor --server - Dolt server mode health checks",
"NEW: Dolt server mode - Multi-client access for shared Dolt databases",
"NEW: Dolt auto-commit on writes with explicit commit authors (#1267)",
"FIX: Daemon stack overflow on empty database path (#1288, #1313)",
"FIX: bd list --json optimization - Fetch only needed dependencies (#1316)",
"FIX: Import custom issue types (#1322)",
"FIX: SQLite transaction improvements (#1272, #1276)",
"FIX: Multiple Dolt backend fixes for hooks, routing, and daemon compatibility",
"DOCS: Comprehensive docs/DOLT.md guide (#1310)",
},
},
{
Version: "0.49.0",
Date: "2026-01-21",
Changes: []string{
"NEW: Dolt federation - Peer-to-peer issue sync with bd federation sync command",
"NEW: SQLite to Dolt migration - bd migrate dolt converts existing repos",
"NEW: bd children <id> - Display child issues for a parent",
"NEW: bd rename <old> <new> - Rename issue IDs",
"NEW: bd view - Alias for bd show command",
"NEW: bd config validate - Validate sync configuration",
"NEW: Jujutsu (jj) VCS support - Beads now works with jj repositories",
"NEW: Per-field merge strategies for conflict resolution",
"NEW: -m flag as alias for --description in bd create",
"CHANGED: Auto-routing disabled by default - Enable with routing.mode: auto (#1177)",
"CHANGED: Gas Town types removed from core - Use types.custom configuration",
"FIX: Daemon zombie state after DB replacement (#1213)",
"FIX: WSL2 Docker Desktop - Detect bind mounts and disable WAL mode (#1224)",
"FIX: Daemon stack overflow in handleStaleLock (#1238)",
"FIX: Molecule steps excluded from bd ready (#1246)",
"FIX: Tree ordering stabilization for consistent --tree output (#1228)",
},
},
{
Version: "0.48.0",
Date: "2026-01-17",
Changes: []string{
"NEW: VersionedStorage interface - Abstract storage layer with history/diff/branch operations",
"NEW: bd types command - List valid issue types with descriptions",
"NEW: bd close -m flag - Alias for --reason (git commit convention)",
"NEW: RepoContext API - Centralized git operations context",
"WIP: Dolt backend improvements - Bootstrap from JSONL, hook infrastructure, bd compact --dolt",
"FIX: Doctor sync branch check - Removed destructive --fix behavior (GH#1062)",
"FIX: Duplicate merge target - Use combined weight for better selection (GH#1022)",
"FIX: Worktree exclude paths - Correct --git-common-dir usage (GH#1053)",
"FIX: Daemon git.author - Apply configured author to sync commits",
"FIX: Windows CGO-free builds - Enable building without CGO (#1117)",
"FIX: Git hooks in worktrees - Fix hook execution in linked worktrees (#1126)",
},
},
{
Version: "0.47.2",
Date: "2026-01-14",
Changes: []string{
"NEW: Dolt backend - version-controlled storage with bd init",
"NEW: bd show --children flag - Display child issues inline with parent",
"NEW: Comprehensive NixOS support - Improved flake and home-manager integration",
"FIX: Redirect + sync-branch incompatibility - bd sync works in redirected repos (bd-wayc3)",
"FIX: Doctor project-level settings - Detects plugins/hooks/MCP in .claude/settings.json",
"FIX: Contributor routing - bd init --contributor correctly sets up routing (#1088)",
"CHANGED: Release workflow modernized - bump-version.sh replaced with molecule pointer",
"DOCS: EXTENDING.md deprecated - Custom SQLite tables approach deprecated for Dolt migration",
},
},
{
Version: "0.47.1",
Date: "2026-01-12",
Changes: []string{
"NEW: bd list --ready flag - Show only issues with no blockers (bd-ihu31)",
"NEW: Markdown rendering in comments - Enhanced display for notes (#1019)",
"FIX: Nil pointer in wisp create - Prevent panic in molecule creation",
"FIX: Route prefix for rig issues - Use correct prefix when creating (#1028)",
"FIX: Duplicate merge target - Prefer issues with children/deps (GH#1022)",
"FIX: SQLite cache rebuild after rename-prefix (GH#1016)",
"FIX: MCP custom types - Support non-built-in types/statuses (#1023)",
"FIX: Hyphenated prefix validation - Support hyphens in prefixes (#1013)",
"FIX: Git worktree initialization - Prevent bd init in worktrees (#1026)",
},
},
{
Version: "0.47.0",
Date: "2026-01-11",
Changes: []string{
"NEW: Pull-first sync with 3-way merge - Reconciles local/remote before push (#918)",
"NEW: bd resolve-conflicts command - Mechanical JSONL conflict resolution (bd-7e7ddffa)",
"NEW: bd create --dry-run - Preview issue creation without side effects (bd-0hi7)",
"NEW: bd ready --gated - Find molecules waiting on gates (bd-lhalq)",
"NEW: Gate auto-discovery - Auto-discover workflow run ID in bd gate check (bd-fbkd)",
"NEW: Multi-repo custom types - bd doctor discovers types across repos (bd-62g22)",
"NEW: Stale DB handling - Read-only commands auto-import on stale DB (#977, #982)",
"NEW: Linear project filter - linear.project_id config for sync (#938)",
"FIX: Windows infinite loop in findLocalBeadsDir (GH#996)",
"FIX: bd init hangs on Windows when not in git repo (#991)",
"FIX: Daemon socket for deep paths - Long workspace paths now work (GH#1001)",
"FIX: Prevent closing issues with open blockers (GH#962)",
"FIX: bd edit parses EDITOR with args (GH#987)",
"FIX: Worktree/redirect handling - Skip restore when redirected (bd-lmqhe)",
"CHANGE: Daemon CLI refactored to subcommands (#1006)",
},
},
{
Version: "0.46.0",
Date: "2026-01-06",
Changes: []string{
"NEW: Custom type support - Configure custom issue types in config.yaml (bd-649s)",
"NEW: Gas Town types extraction - Core Gas Town types in beads package (bd-i54l)",
"FIX: Gate workflow discovery - Better matching of GitHub Actions runs (bd-m8ew)",
},
},
{
Version: "0.45.0",
Date: "2026-01-06",
Changes: []string{
"NEW: Dynamic shell completions - Tab complete issue IDs in bash/zsh/fish (#935)",
"NEW: Android/Termux support - Native ARM64 binaries (#887)",
"NEW: Deep pre-commit integration - bd doctor checks pre-commit configs (bd-28r5)",
"NEW: Rig identity bead type - New 'rig' type for Gas Town tracking (gt-zmznh)",
"NEW: --filter-parent alias - Alternative to --parent in bd list (bd-3p4u)",
"NEW: Unified auto-sync config - Simpler daemon config for agents (#904)",
"NEW: BD_SOCKET env var - Test isolation for daemon socket paths (#914)",
"FIX: Init branch persistence - --branch flag persists to config.yaml (#934)",
"FIX: Worktree resolution - Resolve worktrees by name from git registry (#921)",
"FIX: Sync with redirect - Handle .beads/redirect in git status and import",
"FIX: Doctor improvements - skip-worktree flag, duplicate detection, metadata queries",
"FIX: Update prefix routing - bd update routes like bd show (bd-618f)",
},
},
{
Version: "0.44.0",
Date: "2026-01-04",
Changes: []string{
"NEW: Recipe-based setup - bd init refactored to modular recipes (bd-i3ed)",
"NEW: Gate evaluation phases 2-4 - Timer, GitHub, cross-rig gate support",
"NEW: bd gate check/discover/add-waiter/show - Gate workflow commands",
"NEW: --blocks flag for bd dep add - Natural dependency syntax (GH#884)",
"NEW: --blocked-by/--depends-on aliases for bd dep add (bd-09kt)",
"NEW: Multi-prefix support - allowed_prefixes config option (#881)",
"NEW: Sync divergence detection - JSONL/SQLite/git consistency checks (GH#885)",
"NEW: PRIME.md override - Custom prime output per project (GH#876)",
"NEW: Compound visualization - bd mol show displays compound structure (bd-iw4z)",
"NEW: /handoff skill - Session handoff slash command (bd-xwvo)",
"FIX: bd ready now shows in_progress issues (#894)",
"FIX: macOS case-insensitive path handling for worktrees/daemon (GH#880)",
"FIX: Sync metadata timing - finalize after commit not push (GH#885)",
"FIX: Sparse checkout isolation - prevent config leak to main repo (GH#886)",
"FIX: close_reason preserved during merge/sync (GH#891)",
"FIX: Hyphenated rig names supported in agent IDs (GH#854, GH#868)",
},
},
{
Version: "0.43.0",
Date: "2026-01-02",
Changes: []string{
"NEW: Step.Gate evaluation Phase 1 - Human gates for workflow control",
"NEW: bd lint command - Template validation against schema",
"NEW: bd ready --pretty - Formatted human-friendly output",
"FIX: Cross-rig routing for bd close and bd update",
"FIX: Agent ID validation accepts any rig prefix (GH#827)",
"FIX: bd sync in bare repo worktrees - Exit 128 error (GH#827)",
"FIX: bd --no-db dep tree shows complete tree (GH#836)",
},
},
{
Version: "0.42.0",
Date: "2025-12-30",
Changes: []string{
"NEW: llms.txt standard support - AI agent discoverability endpoint (#784)",
"NEW: bd preflight command - PR readiness checks (Phase 1)",
"NEW: --claim flag for bd update - Atomic work queue semantics",
"NEW: bd state/set-state commands - Label-based state management",
"NEW: bd activity --town - Cross-rig aggregated activity feed",
"NEW: Convoy issue type - Reactive completion with 'tracks' relation",
"NEW: prepare-commit-msg hook - Agent identity trailers in commits",
"NEW: Daemon RPC endpoints - Config and mol stale queries",
"NEW: Non-TTY auto-detection - Cleaner output in pipes",
"FIX: Git hook chaining now works correctly (GH#816)",
"FIX: .beads/redirect not committed - Prevents worktree conflicts (GH#814)",
"FIX: bd sync with sync-branch - Worktree copy direction fixed (GH#810, #812)",
"FIX: sync.branch validation - Rejects main/master as sync branch (GH#807)",
"FIX: Read operations read-only - No DB writes on list/ready/show (GH#804)",
"FIX: bd list defaults - Non-closed issues, 50 limit (GH#788)",
"FIX: External direct-commit bypass when sync.branch configured (bd-n663)",
"FIX: Migration 022 SQL syntax error on v0.30.3 upgrade",
"FIX: MCP plugin follows .beads/redirect files",
"FIX: Jira sync error message when Python script not found (GH#803)",
},
},
{
Version: "0.41.0",
Date: "2025-12-29",
Changes: []string{
"NEW: bd swarm commands - Create/status/validate for multi-agent batch coordination",
"NEW: bd repair command - Detect and repair orphaned foreign key references",
"NEW: bd init --from-jsonl - Preserve manual JSONL edits on reinit",
"NEW: bd human command - Focused help menu for humans",
"NEW: bd show --short - Compact output mode for scripting",
"NEW: bd delete --reason - Audit trail for deletions",
"NEW: 'hooked' status - Work actively claimed by a worker",
"NEW: mol_type schema field - Molecule classification tracking",
"FIX: --var flag allows commas in values (GH#786)",
"FIX: bd sync in bare repo worktrees (GH#785)",
"FIX: bd delete --cascade recursive deletion (GH#787)",
"FIX: bd doctor pre-push hook detection (GH#799)",
"FIX: Illumos/Solaris disk space check (GH#798)",
"FIX: hq- prefix routing - Correctly finds town root for routes.jsonl",
"FIX: Pre-migration orphan cleanup - Avoids chicken-and-egg failures",
"CHANGED: CLI command consolidation - Reduced top-level surface area",
"CHANGED: Code organization - Split large cmd/bd files to meet 800-line limit",
},
},
{
Version: "0.39.1",
Date: "2025-12-27",
Changes: []string{
"NEW: bd where command - Show active beads location after following redirects",
"NEW: --parent flag for bd update - Reparent issues between epics",
"NEW: Redirect info in bd prime - Shows when database is redirected",
"FIX: bd doctor follows redirects - Multi-clone compatibility",
"FIX: Remove 8-char prefix limit - bd rename-prefix allows longer prefixes",
"CHANGED: Git context consolidation - Internal refactor for efficiency",
"DOCS: Database Redirects section - ADVANCED.md documentation",
"DOCS: Community Tools update - Added opencode-beads to README",
},
},
{
Version: "0.39.0",
Date: "2025-12-27",
Changes: []string{
"NEW: bd orphans command - Detect issues mentioned in commits but never closed",
"NEW: bd admin parent command - Consolidated cleanup/compact/reset under bd admin",
"NEW: --prefix flag for bd create - Create issues in other rigs from any directory",
"CHANGED: bd mol catalog → bd formula list - Aligns with formula terminology",
"CHANGED: bd info --thanks - Contributors list moved under bd info",
"CHANGED: Removed unused bd pin/unpin/hook commands - Use gt mol commands",
"CHANGED: bd doctor --check=pollution - Test pollution check integrated into doctor",
"FIX: macOS codesigning in bump-version.sh --install - Prevents quarantine issues",
"FIX: Lint errors and Nix vendorHash - Clean builds on all platforms",
"DOCS: Issue Statuses section in CLI_REFERENCE.md - Comprehensive status docs",
"DOCS: Consolidated duplicate UI_PHILOSOPHY files - Single source of truth",
"DOCS: README and PLUGIN.md fixes - Corrected installation instructions",
},
},
{
Version: "0.38.0",
Date: "2025-12-27",
Changes: []string{
"NEW: Prefix-based routing - bd commands auto-route to correct rig via routes.jsonl",
"NEW: Cross-rig ID auto-resolve - bd dep add auto-resolves IDs across rigs",
"NEW: bd mol pour/wisp moved under bd mol subcommand - cleaner command hierarchy",
"NEW: bd show displays comments - Comments now visible in issue details",
"NEW: created_by field on issues - Track issue creator for audit trail",
"NEW: Database corruption recovery in bd doctor --fix - Auto-repair corrupted databases",
"NEW: JSONL integrity check in bd doctor - Detect and fix malformed JSONL",
"NEW: Git hygiene checks in bd doctor - Detect stale branches and sync issues",
"NEW: pre-commit config for local lint enforcement - Consistent code quality",
"NEW: Chaos testing flag for release script - --run-chaos-tests for thorough validation",
"CHANGED: Sync backoff and tips consolidation - Smarter daemon sync timing",
"CHANGED: Wisp/Ephemeral name finalized as 'wisp' - bd mol wisp is the canonical command",
"FIX: Comments display outside dependents block - Proper formatting",
"FIX: no-db mode storeActive initialization - JSONL-only mode works correctly",
"FIX: --resolution alias restored for bd close - Backwards compatibility",
"FIX: bd graph works with daemon running - Graph generation no longer conflicts",
"FIX: created_by field in RPC path - Daemon correctly propagates creator",
"FIX: Migration 028 idempotency - Migration handles partial/re-runs",
"FIX: Routed IDs bypass daemon in show command - Cross-rig show works correctly",
"FIX: Storage connections closed per iteration - Prevents resource leaks",
"FIX: Modern git init compatibility - Tests use --initial-branch=main",
"FIX: golangci-lint errors resolved - Clean lint on all platforms",
"IMPROVED: Test coverage - doctor, daemon, storage, RPC client paths covered",
},
},
{
Version: "0.37.0",
Date: "2025-12-26",
Changes: []string{
"BREAKING: Ephemeral API rename - Wisp→Ephemeral: JSON 'wisp'→'ephemeral', bd wisp→bd ephemeral",
"NEW: bd gate create/show/list/close/wait - Async coordination primitives for agent workflows",
"NEW: bd gate eval - Evaluate timer gates and GitHub gates (gh:run, gh:pr, mail)",
"NEW: bd gate approve - Human gate approval command",
"NEW: bd close --suggest-next - Show newly unblocked issues after close",
"NEW: bd ready/blocked --parent - Scope by epic or parent bead",
"NEW: TOML support for formulas - .formula.toml files alongside JSON",
"NEW: Fork repo auto-detection - Offer to configure .git/info/exclude",
"NEW: Control flow operators - loop and gate operators for formula composition",
"NEW: Aspect composition - Cross-cutting concerns via aspects field in formulas",
"NEW: Runtime expansion - on_complete and for-each dynamic step generation",
"NEW: bd formula list/show - Discover and inspect available formulas",
"NEW: bd mol stale - Detect complete-but-unclosed molecules",
"NEW: Stale molecules check in bd doctor - Proactive detection",
"NEW: Distinct ID prefixes - bd-proto-xxx, bd-mol-xxx, bd-wisp-xxx",
"NEW: no-git-ops config - bd config set no-git-ops true for manual git control",
"NEW: beads-release formula - 18-step molecular workflow for version releases",
"CHANGED: Formula format YAML→JSON - Formulas now use .formula.json extension",
"CHANGED: bd mol run removed - Orchestration moved to gt commands",
"CHANGED: Wisp architecture simplified - Single DB with Wisp=true flag",
"FIX: Gate await fields preserved during upsert - Multirepo sync fix",
"FIX: closed_at timestamp preserved during soft deletes",
"FIX: Git detection caching - Eliminates worktree slowness",
"FIX: installed_plugins.json v2 format - bd doctor handles new Claude Code format",
"FIX: git.IsWorktree() hang on Windows - bd init no longer hangs outside git repos",
"FIX: Skill files deleted by bd sync - .claude/ files now preserved",
"FIX: doctor false positives - Skips interactions.jsonl and molecules.jsonl",
"FIX: bd sync commits non-.beads files - Now only commits .beads/ directory",
"FIX: Aspect self-matching recursion - Prevents infinite loops",
"FIX: Map expansion nested matching - Correctly matches child steps",
"FIX: Content-level merge for divergence - Better conflict resolution",
"FIX: Windows MCP graceful fallback - Daemon mode on Windows",
"FIX: Windows npm postinstall file locking - Install reliability",
},
},
{
Version: "0.36.0",
Date: "2025-12-24",
Changes: []string{
"NEW: Formula system - bd cook <formula> for declarative workflow templates",
"NEW: Gate issue type - bd gate create/open/close for async coordination",
"NEW: bd list --pretty --watch - Built-in colorized viewer with live updates",
"NEW: bd search --after/--before/--priority/--content - Enhanced search filters",
"NEW: bd export --priority - Exact priority filter for exports",
"NEW: --resolution alias for --reason on bd close",
"NEW: Config-based close hooks - Custom scripts on issue close",
"CHANGED: bd mol spawn removed - Use bd pour/bd wisp create only",
"CHANGED: bd ready excludes workflow types by default",
"FIX: Child→parent deps now blocked - Prevents LLM temporal reasoning trap",
"FIX: Dots in prefix handling - my.project prefixes work correctly",
"FIX: Child counter updates - Explicit child IDs update counters",
"FIX: Comment timestamps preserved during import",
"FIX: sync.remote config respected in daemon",
"FIX: Multi-hyphen prefixes - my-project-name works correctly",
"FIX: Stealth mode uses .git/info/exclude - Truly local",
"FIX: MCP output_schema=None for Claude Code",
"IMPROVED: Test coverage - daemon 72%, compact 82%, setup 54%",
},
},
{
Version: "0.35.0",
Date: "2025-12-23",
Changes: []string{
"NEW: bd activity command - Real-time state feed for molecule monitoring",
"NEW: Dynamic molecule bonding - bd mol bond --ref <id> attaches protos at runtime",
"NEW: waits-for dependency type - Fanout gates for parallel step coordination",
"NEW: Parallel step detection - Molecules auto-detect parallelizable steps",
"NEW: bd list --parent flag - Filter issues by parent",
"NEW: Molecule navigation - bd mol next/prev/current for step traversal",
"NEW: Entity tracking types - Creator and Validations fields for work attribution",
"IMPROVED: bd doctor --fix replaces manual commands",
"IMPROVED: bd dep tree shows external dependencies",
"IMPROVED: Performance indexes for large databases",
"FIX: Rich mutation events emitted for status changes",
"FIX: External deps filtered from GetBlockedIssues",
"FIX: bd create -f works with daemon mode",
"FIX: Parallel execution migration race conditions",
},
},
{
Version: "0.34.0",
Date: "2025-12-22",
Changes: []string{
"NEW: Wisp commands - bd wisp create/list/gc for ephemeral molecule management",
"NEW: Chemistry UX - bd pour, bd mol bond --wisp/--pour for phase control",
"NEW: Cross-project deps - external:<repo>:<id> syntax, bd ship command",
"BREAKING: bd repo add/remove now writes to .beads/config.yaml (not DB)",
"FIX: Wisps use Wisp=true flag in main database (not exported to JSONL)",
},
},
{
Version: "0.33.2",
Date: "2025-12-21",
Changes: []string{
"FIX: P0 priority preserved - omitempty removed from Priority field",
"FIX: nil pointer check in markdown parsing",
"CHORE: Remove dead deprecated wrapper functions from deletion_tracking.go",
},
},
{
Version: "0.33.1",
Date: "2025-12-21",
Changes: []string{
"BREAKING: Ephemeral → Wisp rename - JSON field changed from 'ephemeral' to 'wisp'",
"BREAKING: CLI flag changed from --ephemeral to --wisp (bd cleanup)",
"NOTE: SQLite column remains 'ephemeral' (no migration needed)",
},
},
{
Version: "0.33.0",
Date: "2025-12-21",
Changes: []string{
"NEW: Wisp molecules - use 'bd wisp create' for ephemeral wisps",
"NEW: Wisp issues live only in SQLite, never export to JSONL (prevents zombie resurrection)",
"NEW: Use 'bd pour' for persistent mols, 'bd wisp create' for ephemeral wisps",
"NEW: bd mol squash compresses wisp children into digest issue",
"NEW: --summary flag on bd mol squash for agent-provided AI summaries",
"FIX: DeleteIssue now cascades to comments table",
},
},
{
Version: "0.32.1",
Date: "2025-12-21",
Changes: []string{
"NEW: MCP output control params - brief, brief_deps, fields, max_description_length",
"NEW: MCP filtering params - labels, labels_any, query, unassigned, sort_policy",
"NEW: BriefIssue, BriefDep, OperationResult models for 97% context reduction",
"FIX: Pin field not in allowed update fields - bd update --pinned now works",
},
},
{
Version: "0.32.0",
Date: "2025-12-20",
Changes: []string{
"REMOVED: bd mail commands (send, inbox, read, ack, reply) - Mail is orchestration, not data plane",
"NOTE: Data model unchanged - type=message, Sender, Ephemeral, replies_to fields remain",
"NOTE: Orchestration tools should implement mail UI on top of beads data model",
"FIX: Symlink preservation in atomicWriteFile - bd setup no longer clobbers nix/home-manager configs",
"FIX: Broken link to LABELS.md in examples",
},
},
{
Version: "0.31.0",
Date: "2025-12-20",
Changes: []string{
"NEW: bd defer/bd undefer commands - Deferred status for icebox issues",
"NEW: Agent audit trail - .beads/interactions.jsonl with bd audit record/label",
"NEW: Directory-aware label scoping for monorepos - Auto-filter by directory.labels config",
"NEW: Molecules catalog - Templates in separate molecules.jsonl with hierarchical loading",
"NEW: Git commit config - git.author and git.no-gpg-sign options",
"NEW: create.require-description config option",
"CHANGED: bd stats merged into bd status - stats is now alias, colorized output",
"CHANGED: Thin hook shims - Hooks delegate to bd hooks run, no more version drift",
"CHANGED: MCP context tool consolidation - set_context/where_am_i/init merged into single context tool",
"FIX: relates-to excluded from cycle detection",
"FIX: Doctor checks .local_version instead of deprecated LastBdVersion",
"FIX: Read-only gitignore in stealth mode prints manual instructions",
},
},
{
Version: "0.30.7",
Date: "2025-12-19",
Changes: []string{
"FIX: bd graph no longer crashes with nil pointer on epics",
"FIX: Windows npm installer no longer fails with file lock error",
"NEW: Version Bump molecule template for repeatable release workflows",
},
},
{
Version: "0.30.6",
Date: "2025-12-18",
Changes: []string{
"bd graph command shows dependency counts using subgraph formatting",
"types.StatusPinned for persistent beads that survive cleanup",
"CRITICAL: Fixed dependency resurrection bug in 3-way merge - removals now win",
},
},
{
Version: "0.30.5",
Date: "2025-12-18",
Changes: []string{
"REMOVED: YAML simple template system - --from-template flag removed from bd create",
"REMOVED: Embedded templates (bug.yaml, epic.yaml, feature.yaml) - Use Beads templates instead",
"Templates are now purely Beads-based - Create epic with 'template' label, use bd template instantiate",
},
},
{
Version: "0.30.4",
Date: "2025-12-18",
Changes: []string{
"bd template instantiate - Create beads issues from Beads templates",
"--assignee flag for template instantiate - Auto-assign during instantiation",
"bd mail inbox --identity fix - Now properly filters by identity parameter",
"Orphan detection fixes - No longer warns about closed issues",
"EXPERIMENTAL: Graph link fields (relates_to, replies_to, duplicate_of, superseded_by) and mail commands are subject to breaking changes",
},
},
{
Version: "0.30.3",
Date: "2025-12-17",
Changes: []string{
"SECURITY: Data loss race condition fixed - Removed unsafe ClearDirtyIssues() method",
"Stale database warning - Commands now warn when DB is out of sync with JSONL",
"Staleness check error handling improved - Proper warnings on check failures",
},
},
{
Version: "0.30.2",
Date: "2025-12-16",
Changes: []string{
"bd setup droid - Factory.ai (Droid) IDE support",
"Messaging schema fields - New 'message' issue type, sender/wisp/replies_to/relates_to/duplicate_of/superseded_by fields",
"New dependency types: replies-to, relates-to, duplicates, supersedes",
"Windows build fixes - gosec lint errors resolved",
"Issue ID prefix extraction fix - Word-like suffixes now parse correctly",
"Legacy deletions.jsonl code removed - Dolt handles delete propagation natively",
},
},
{
Version: "0.30.1",
Date: "2025-12-16",
Changes: []string{
"bd reset command - Complete beads removal from a repository",
"bd update --type flag - Change issue type after creation",
"bd q silent mode - Quick-capture without output for scripting",
"bd show displays dependent issue status - Shows status for blocked-by/blocking issues",
"claude.local.md support - Local-only documentation, gitignored by default",
"Auto-disable daemon in git worktrees - Prevents database conflicts",
"Enhanced Git Worktree Support - Shared .beads database across worktrees",
},
},
{
Version: "0.30.0",
Date: "2025-12-15",
Changes: []string{
"Git Worktree Support - Shared database across worktrees, worktree-aware hooks",
"MCP Context Engineering - 80-90% context reduction for MCP responses",
"bd thanks command - List contributors to your project",
"BD_NO_INSTALL_HOOKS env var - Disable automatic git hook installation",
"Claude Code skill marketplace - Install beads skill via marketplace",
"Daemon delete auto-sync - Delete operations trigger auto-sync",
"close_reason persistence - Close reasons now saved to database on close",
"JSONL-only mode improvements - GetReadyWork/GetBlockedIssues for memory storage",
"Lock file improvements - Fast fail on stale locks, 98% test coverage",
},
},
{
Version: "0.29.0",
Date: "2025-12-03",
Changes: []string{
"--estimate flag for bd create/update - Add time estimates to issues in minutes",
"bd doctor improvements - SQLite integrity check, config validation, stale sync branch detection",
"bd doctor --output flag - Export diagnostics to file for sharing/debugging",
"bd doctor --dry-run flag - Preview fixes without applying them",
"bd doctor per-fix confirmation mode - Approve each fix individually",
"--readonly flag - Read-only mode for worker sandboxes",
"bd sync safety improvements - Auto-push after merge, diverged history handling",
"Auto-resolve merge conflicts deterministically - All field conflicts resolved without prompts",
"3-char all-letter base36 hash support - Fixes prefix extraction edge case",
},
},
{
Version: "0.28.0",
Date: "2025-12-01",
Changes: []string{
"bd daemon --local flag - Run daemon without git operations for multi-repo/worktree setups",
"bd daemon --foreground flag - Run in foreground for systemd/supervisord integration",
"bd migrate-sync command - Migrate to sync.branch workflow for cleaner main branch",
"Database migration: close_reason column - Fixes sync loops with close_reason",
"Multi-repo prefix filtering - Issues filtered by prefix when flushing from non-primary repos",
"Parent-child dependency UX - Fixed documentation and UI labels for dependencies",
"sync.branch workflow fixes - Fixed .beads/ restoration and doctor detection",
"Jira API migration - Updated from deprecated v2 to v3 API",
},
},
{
Version: "0.27.2",
Date: "2025-11-30",
Changes: []string{
"CRITICAL: Mass database deletion protection - Safety guard prevents purging entire DB on JSONL reset",
"Fresh Clone Initialization - bd init auto-detects prefix from existing JSONL, works without --prefix flag",
"3-Character Hash Support - ExtractIssuePrefix now handles base36 hashes 3+ chars",
"Import Warnings - New warning when issues skipped due to deletions manifest",
},
},
{
Version: "0.27.0",
Date: "2025-11-29",
Changes: []string{
"Git hooks now sync.branch aware - pre-commit/pre-push skip .beads checks when sync.branch configured",
"Custom Status States - Define project-specific statuses via config (testing, blocked, review)",
"Contributor Fork Workflows - `bd init --contributor` auto-configures sync.remote=upstream",
"Git Worktree Support - Full support for worktrees in hooks and detection",
"CRITICAL: Sync corruption prevention - Hash-based staleness + reverse ZFC checks",
"Out-of-Order Dependencies - JSONL import handles deps before targets exist",
"--from-main defaults to noGitHistory=true - Prevents spurious deletions",
"bd sync --squash - Batch multiple sync commits into one",
"Fresh Clone Detection - bd doctor suggests 'bd init' when JSONL exists but no DB",
},
},
{
Version: "0.26.0",
Date: "2025-11-27",
Changes: []string{
"bd doctor --check-health - Lightweight health checks for startup hooks (exit 0 on success)",
"--no-git-history flag - Prevent spurious deletions when git history is unreliable",
"gh2jsonl --id-mode hash - Hash-based ID generation for GitHub imports",
"MCP Protocol Fix - Subprocess stdin no longer breaks MCP JSON-RPC",
"Git Worktree Staleness Fix - Staleness check works after writes in worktrees",
"Multi-Part Prefix Support - Handles prefixes like 'my-app-123' correctly",
"bd sync Commit Scope Fixed - Only commits .beads/ files, not other staged files",
},
},
{
Version: "0.25.1",
Date: "2025-11-25",
Changes: []string{
"Zombie Resurrection Prevention - Stale clones can no longer resurrect deleted issues",
"bd sync commit scope fixed - Now commits entire .beads/ directory before pull",
"bd prime ephemeral branch detection - Auto-detects ephemeral branches and adjusts workflow",
"JSONL Canonicalization - Default JSONL filename is now issues.jsonl; legacy beads.jsonl still supported",
},
},
{
Version: "0.25.0",
Date: "2025-11-25",
Changes: []string{
"Deletion Propagation - Deletions now sync across clones via deletions manifest",
"Stealth Mode - `bd init --stealth` for invisible beads usage",
"Ephemeral Branch Sync - `bd sync --from-main` to sync from main without pushing",
},
},
{
Version: "0.24.4",
Date: "2025-11-25",
Changes: []string{
"Transaction API - Full transactional support for atomic multi-operation workflows",
"Tip System Infrastructure - Smart contextual hints for users",
"Sorting for bd list/search - New `--sort` and `--reverse` flags",
"Claude Integration Verification - New bd doctor checks",
"ARM Linux Support - GoReleaser now builds for linux/arm64",
"Orphan Detection Migration - Identifies orphaned child issues",
},
},
{
Version: "0.24.3",
Date: "2025-11-24",
Changes: []string{
"BD_GUIDE.md Generation - Version-stamped documentation for AI agents",
"Configurable Export Error Policies - Flexible error handling for export operations",
"Command Set Standardization - Global verbosity, dry-run, and label flags",
"Auto-Migration on Version Bump - Automatic database schema updates",
"Monitor Web UI Enhancements - Interactive stats cards, multi-select priority",
},
},
{
Version: "0.24.1",
Date: "2025-11-22",
Changes: []string{
"bd search filters - Date and priority filters added",
"bd count - New command for counting and grouping issues",
"Test Infrastructure - Automatic skip list for tests",
},
},
{
Version: "0.24.0",
Date: "2025-11-20",
Changes: []string{
"bd doctor --fix - Automatic repair functionality",
"bd clean - Remove temporary merge artifacts",
".beads/README.md Generation - Auto-generated during bd init",
"blocked_issues_cache Table - Performance optimization for GetReadyWork",
"Commit Hash in Version Output - Enhanced version reporting",
},
},
{
Version: "0.23.0",
Date: "2025-11-08",
Changes: []string{
"Agent Mail integration - Python adapter library with 98.5% reduction in git traffic",
"`bd info --whats-new` - Quick upgrade summaries for agents (shows last 3 versions)",
"`bd hooks install` - Embedded git hooks command (replaces external script)",
"`bd cleanup` - Bulk deletion for agent-driven compaction",
"`bd new` alias added - Agents often tried this instead of `bd create`",
"`bd list` now one-line-per-issue by default - Prevents agent miscounting (use --long for old format)",
"3-way JSONL merge auto-invoked on conflicts - No manual intervention needed",
"Daemon crash recovery - Panic handler with socket cleanup prevents orphaned processes",
"Auto-import when database missing - `bd import` now auto-initializes",
"Stale database export prevention - ID-based staleness detection",
},
},
}
// showWhatsNew displays agent-relevant changes from recent versions
func showWhatsNew() {
currentVersion := Version // from version.go
if jsonOutput {
outputJSON(map[string]interface{}{
"current_version": currentVersion,
"recent_changes": versionChanges,
})
return
}
// Human-readable output
fmt.Printf("\n🆕 What's New in bd (Current: v%s)\n", currentVersion)
fmt.Println("=" + strings.Repeat("=", 60))
fmt.Println()
for _, vc := range versionChanges {
// Highlight if this is the current version
versionMarker := ""
if vc.Version == currentVersion {
versionMarker = " ← current"
}
fmt.Printf("## v%s (%s)%s\n\n", vc.Version, vc.Date, versionMarker)
for _, change := range vc.Changes {
fmt.Printf(" • %s\n", change)
}
fmt.Println()
}
fmt.Println("💡 Tip: Use `bd info --whats-new --json` for machine-readable output")
fmt.Println()
}
func init() {
infoCmd.Flags().Bool("schema", false, "Include schema information in output")
infoCmd.Flags().Bool("whats-new", false, "Show agent-relevant changes from recent versions")
infoCmd.Flags().Bool("thanks", false, "Show thank you page for contributors")
infoCmd.Flags().BoolVar(&jsonOutput, "json", false, "Output in JSON format")
rootCmd.AddCommand(infoCmd)
}