Root cause: renderInfo called CheckGitHooks()/FormatHookWarnings() unconditionally, so setting doctor.suppress.git-hooks=true silenced the check in bd doctor but bd info kept printing "Git hooks not installed". Fix: split the config-map half of the doctor suppress reader out as doctor.SuppressedChecksFromConfig (the store-backed helper now delegates to it, same semantics), and have both bd info paths (direct and proxied-server) feed it the config map they already load. renderInfo skips the hook warning when the git-hooks slug is suppressed. bd info --json never carried the warning and is unchanged. Agent-Signature: claude-code-opus-5-5-unknown-reasoning on behalf of Harry Miller Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
1541 lines
80 KiB
Go
1541 lines
80 KiB
Go
package main
|
||
|
||
import (
|
||
"fmt"
|
||
"path/filepath"
|
||
"strings"
|
||
|
||
"github.com/spf13/cobra"
|
||
"github.com/steveyegge/beads/cmd/bd/doctor"
|
||
"github.com/steveyegge/beads/internal/metrics"
|
||
"github.com/steveyegge/beads/internal/types"
|
||
"github.com/steveyegge/beads/internal/workapi"
|
||
)
|
||
|
||
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`,
|
||
SilenceUsage: true,
|
||
SilenceErrors: true,
|
||
RunE: func(cmd *cobra.Command, args []string) error {
|
||
evt := metrics.NewCommandEvent("info")
|
||
defer func() {
|
||
if c := metrics.Global(); c != nil {
|
||
c.CloseEventAndAdd(evt)
|
||
}
|
||
}()
|
||
|
||
schemaFlag, _ := cmd.Flags().GetBool("schema")
|
||
whatsNewFlag, _ := cmd.Flags().GetBool("whats-new")
|
||
thanksFlag, _ := cmd.Flags().GetBool("thanks")
|
||
|
||
if thanksFlag {
|
||
printThanksPage()
|
||
return nil
|
||
}
|
||
|
||
if whatsNewFlag {
|
||
return showWhatsNew()
|
||
}
|
||
|
||
if usesProxiedServer() {
|
||
return runInfoProxiedServer(rootCtx, schemaFlag)
|
||
}
|
||
|
||
absDBPath := absoluteDBPath()
|
||
|
||
info := map[string]interface{}{
|
||
"database_path": absDBPath,
|
||
"mode": "direct",
|
||
}
|
||
|
||
suppressHookWarning := false
|
||
|
||
if store != nil {
|
||
ctx := rootCtx
|
||
|
||
issues, err := store.SearchIssues(ctx, "", types.IssueFilter{})
|
||
if err == nil {
|
||
info["issue_count"] = len(issues)
|
||
}
|
||
|
||
// THE SAME FILTER THE SETTINGS ROLE USES. `bd info --json` serves
|
||
// this map whole, and the beads MCP server's get_schema_info tool
|
||
// runs `bd info --schema --json` and returns the parsed dict —
|
||
// config included — so every memory key AND VALUE landed in the
|
||
// transcript of any agent that asked a SCHEMA question. `bd info`
|
||
// is also the diagnostic people paste into bug reports.
|
||
//
|
||
// Unlike `bd config show`, which an operator asks for by name to
|
||
// see provenance, nothing here says "show me my memories".
|
||
configMap, err := store.GetAllConfig(ctx)
|
||
if err == nil {
|
||
if filtered := workapi.FilterSettingsEnumeration(configMap); len(filtered) > 0 {
|
||
info["config"] = filtered
|
||
}
|
||
// GH#6027: honor the same doctor.suppress.git-hooks bd doctor does.
|
||
suppressHookWarning = doctor.SuppressedChecksFromConfig(configMap)[doctor.CheckNameToSlug("Git Hooks")]
|
||
}
|
||
|
||
if schemaFlag {
|
||
schemaVersion, err := store.GetLocalMetadata(ctx, "bd_version")
|
||
if err != nil {
|
||
schemaVersion = "unknown"
|
||
}
|
||
prefix, _ := store.GetConfig(ctx, "issue_prefix") // Best effort: empty prefix is valid
|
||
info["schema"] = buildInfoSchema(schemaVersion, prefix, issues)
|
||
}
|
||
}
|
||
|
||
return renderInfo(info, schemaFlag, absDBPath, suppressHookWarning)
|
||
},
|
||
}
|
||
|
||
func absoluteDBPath() string {
|
||
absDBPath, err := filepath.Abs(dbPath)
|
||
if err != nil {
|
||
return dbPath
|
||
}
|
||
return absDBPath
|
||
}
|
||
|
||
func buildInfoSchema(schemaVersion, prefix string, issues []*types.Issue) map[string]interface{} {
|
||
tables := []string{"issues", "dependencies", "labels", "config", "metadata"}
|
||
|
||
configMap := make(map[string]string)
|
||
if prefix != "" {
|
||
configMap["issue_prefix"] = prefix
|
||
}
|
||
|
||
sampleIDs := []string{}
|
||
detectedPrefix := ""
|
||
if len(issues) > 0 {
|
||
maxSamples := 3
|
||
if len(issues) < maxSamples {
|
||
maxSamples = len(issues)
|
||
}
|
||
for i := 0; i < maxSamples; i++ {
|
||
sampleIDs = append(sampleIDs, issues[i].ID)
|
||
}
|
||
detectedPrefix = extractPrefix(issues[0].ID)
|
||
}
|
||
|
||
return map[string]interface{}{
|
||
"tables": tables,
|
||
"schema_version": schemaVersion,
|
||
"config": configMap,
|
||
"sample_issue_ids": sampleIDs,
|
||
"detected_prefix": detectedPrefix,
|
||
}
|
||
}
|
||
|
||
func renderInfo(info map[string]interface{}, schemaFlag bool, absDBPath string, suppressHookWarning bool) error {
|
||
if jsonOutput {
|
||
return outputJSON(info)
|
||
}
|
||
|
||
mode, _ := info["mode"].(string)
|
||
|
||
fmt.Println("\nBeads Database Information")
|
||
fmt.Println("===========================")
|
||
fmt.Printf("Database: %s\n", absDBPath)
|
||
fmt.Printf("Mode: %s\n", mode)
|
||
|
||
if count, ok := info["issue_count"].(int); ok {
|
||
fmt.Printf("\nIssue Count: %d\n", count)
|
||
}
|
||
|
||
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)
|
||
}
|
||
}
|
||
}
|
||
|
||
if !suppressHookWarning {
|
||
hookStatuses := CheckGitHooks()
|
||
if warning := FormatHookWarnings(hookStatuses); warning != "" {
|
||
fmt.Printf("\n%s\n", warning)
|
||
}
|
||
}
|
||
|
||
fmt.Println()
|
||
return nil
|
||
}
|
||
|
||
// 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: "1.3.0",
|
||
Date: "2026-09-15",
|
||
Changes: []string{
|
||
"RELEASE: first tested release off main since the 1.1 line. v1.2.2 shipped the v1.1.2 tree, so a v1.2.2 user gets the 1.2.1 changes AND the 1.3.0 changes in one step; read the [1.3.0] AND [1.2.1] sections of CHANGELOG.md. 'bd upgrade review' prints exactly the entries between your previous version and this one — prefer it to 'bd info --whats-new', which dumps the whole release history.",
|
||
"MIGRATION: on an embedded/local store the first invocation auto-migrates from schema v53 to v66 in place. That is ~28 migrations, not 13: the main series runs 0054->0066, then the clone-local series runs 0012->0026 through the same printer, so the counter VISIBLY RESTARTS partway through. That is not a loop — let it finish. Two passes rewrite rows, so the first command is noticeably slower; it is crash-resumable, do not interrupt it. Progress prints per step on stderr only when stderr is a terminal — a silent CI upgrade is not a stuck one.",
|
||
"SHARED SERVER: a shared Dolt sql-server is NEVER auto-migrated (#5920, #6048) — migrating promotes the schema for every connected client at once, so it waits for explicit consent via 'bd migrate schema' (add --global for the shared global database). Upgrade every client of that server FIRST; between upgrade and consent, upgraded clients read normally and their writes are refused with guidance. If the shared server also has a Dolt remote, use 'bd migrate --force' from exactly one machine, then 'bd dolt push'.",
|
||
"BACKUP: back up BEFORE installing, with your OLD binary. Under 1.3.0 'bd export' triggers the migration before exporting, so a snapshot taken afterwards cannot protect you against the migration going wrong. Old binary: 'bd dolt push' (remote-backed stores) then 'bd export --all -o .beads/backup/pre-1.3.0.jsonl'. For a Dolt-native snapshot use 'bd backup init <path>' then 'bd backup sync' — bare 'bd backup' is a command group that prints help and takes NO backup. Remote-backed stores stay gated after install; one designated clone migrates and pushes.",
|
||
"UPGRADE: after migrating, older co-resident binaries REFUSE the store (forward schema-skew guard), so every client sharing a store must be upgraded together. Check with 'which -a bd' and restart any long-running 'bd serve'. Rollback is a schema-cursor rollback: https://beads.gascity.com/recovery/accidental-1-2-1-release",
|
||
"BREAKING (highlights, not the full set — read the [1.2.1] CHANGELOG section too): 'bd update -s <done-status>' enforces close policy (override with --force); 'bd search' includes closed by default (narrow with --status open); the no-ID last-touched fallback on update/close is interactive-only; 'bd human list' hides done/frozen/pinned and validates --status; 'bd dolt push'/'bd sync' no longer adopt a git-origin-derived Dolt remote without consent; an explicitly configured Dolt port outranks BEADS_DOLT_PORT; and actor matching decodes an exact '--' run to '/'.",
|
||
"BREAKING: 'bd --readonly serve' is now REFUSED instead of binding a writable server, so a scripted read-only server does not come back up after this upgrade — drop the flag. 'bd config list' and GET /v0/beads/config no longer enumerate the kv. plane where 'bd remember' memories live (use 'bd kv'/'bd remember'; scripts get empty output, not an error). The published backend package drops OrphanHandling and issueops.CheckOrphan, so a Go consumer naming them no longer compiles.",
|
||
"BREAKING: the CPU profiling flag is now --cpu-profile; the old --profile spelling is gone with no alias and fails as an unknown flag.",
|
||
"CHANGE: migration 0061 rekeys every events/comments/snapshot/compaction-snapshot row to a content-derived (UUIDv5-over-SHA-256) id, once per clone, on the first open after upgrade. Ids captured before the upgrade will not resolve afterwards.",
|
||
"CHANGE: migration 0062 moves the events audit table to the clone-local plane — events keep full local durability and 'bd history <id> --events' still reads them, but they no longer replicate on push or pull.",
|
||
"CHANGE: the interactions.jsonl audit sidecar is opt-in (audit.enabled defaults false, or BD_AUDIT_ENABLED=1); use 'bd history <id> --events' instead. Auto-backup now defaults OFF under a Dolt sql-server (embedded is unchanged); set backup.enabled explicitly to override.",
|
||
"CHANGE: 'bd import' now ERRORS on a redirected stdin with no source argument instead of importing the default JSONL — use 'bd import -' or name the file. 'bd hooks install --chain/--force' are accepted no-ops; marker sections always preserve non-bd hook content.",
|
||
"FIX: 'bd purge'/'bd prune' select candidates by tier (#5995), so typed wisps minted before the ephemeral column are reachable again — the first purge after upgrade may clear considerably more than usual.",
|
||
"NEW: a two-level cooperative gate writes *.gate.lock files beside .beads and beside the Dolt physical root (e.g. .beads/embeddeddolt.gate.lock). They are flock names, never deleted; 'bd doctor --fix' adds the *.gate.lock* gitignore pattern.",
|
||
},
|
||
},
|
||
{
|
||
Version: "1.3.0-rc.2",
|
||
Date: "2026-09-05",
|
||
Changes: []string{
|
||
"RC: candidate for the 1.3.0 line, carrying three server-mode fixes reported against rc.1; the [1.3.0] entry below still describes everything a 1.2.2 user meets, including the migration and backup notes — read it first.",
|
||
"FIX: an env-pointed Dolt sql-server (BEADS_DOLT_SERVER_PORT) is classified shared, not owned, so the #5920/#6048 shared-store consent gate runs instead of being bypassed. Before this, bd migrated the shared database in place and exited 0, and older co-resident clients were then hard-refused with a schema version mismatch (#6118).",
|
||
"FIX: a config.yaml server-mode workspace (dolt.mode: server, no metadata.json) is no longer misread as a legacy workspace — the guard resolves mode through the IsDoltServerMode precedence chain, and a .local_version witness naming bd 1.0 or later vetoes the legacy verdict in every mode (#6119).",
|
||
"FIX: a metadata-less server-mode workspace no longer opens a phantom .beads/embeddeddolt database that answered 'bd list' with a false-empty exit 0; substitution gates on IsDoltServerMode and honors BEADS_DOLT_SERVER_MODE (#6120).",
|
||
"CHANGE: 'bd ready --claim' under --proxied-server now refuses a --max-rows/BEADS_MAX_ROWS cap instead of silently dropping it; --claim is no longer exempt. Agent rigs that set the cap globally must unset it for proxied 'bd ready --claim'. Direct mode is unchanged.",
|
||
},
|
||
},
|
||
{
|
||
// Keyed so an rc.1 tester upgrading to rc.2 gets the rc.2 digest
|
||
// above instead of the whole release history: getVersionsSince
|
||
// returns every entry when it cannot find the previous version.
|
||
Version: "1.3.0-rc.1",
|
||
Date: "2026-08-31",
|
||
Changes: []string{
|
||
"RC: first candidate for the 1.3.0 line. Everything a 1.2.2 user meets on the way here — the in-place schema migration, the shared-server consent gate, the backup ordering, and the breaking changes — is described in the [1.3.0] entry below; read it first.",
|
||
},
|
||
},
|
||
{
|
||
Version: "1.2.2",
|
||
Date: "2026-08-15",
|
||
Changes: []string{
|
||
"RELEASE: v1.2.2 re-releases the tested 1.1 line (identical code to v1.1.2) to supersede the accidental, untested v1.2.0/v1.2.1; 1.2.x-only features (leases, events journal, sync federation, HTTP API server, provenance) are not included.",
|
||
"RECOVERY: if v1.2.1 already migrated a database to schema v65, the v1.2.2 binary refuses with a schema version mismatch; see https://beads.gascity.com/recovery/accidental-1-2-1-release — recommended fix is rolling the schema_migrations cursor back to v53, stopgap is BD_IGNORE_SCHEMA_SKEW=1.",
|
||
"GO: go.mod retracts v1.2.1/v1.2.0/v1.1.1 so 'go install ...@latest' resolves to v1.2.2.",
|
||
},
|
||
},
|
||
{
|
||
Version: "1.2.1",
|
||
Date: "2026-08-11",
|
||
Changes: []string{
|
||
"MIGRATION: first open with this binary runs migration 0062 (events -> dolt_ignored storage, bd-red8u): a one-time four-phase self-committing flip that removes per-event dolt commit churn. Expect one slower first invocation per clone; do not interrupt it.",
|
||
"NEW: `bd sync` — the federation loop (export, commit, pull, import, push) as one verb.",
|
||
"NEW: `--brief` on `bd list` / `bd ready --json` and the HTTP listings — omits free-form text fields (~93% smaller payloads on large stores); fields are omitted without a marker, so only the caller that passed the flag knows rows are partial.",
|
||
"BEHAVIOR: expired dated defers now AUTO-WAKE on ready-front reads and claims (#5386) — a lapsed `--defer` no longer hides an issue forever; stale defers surface on the next `bd ready`.",
|
||
"PERF: telemetry no longer costs startup time on every invocation (#5646), and the queued-events dir is bounded (7d TTL + drop-oldest caps, #5660) — a backlogged ~/.beads/eventsData self-prunes.",
|
||
},
|
||
},
|
||
{
|
||
Version: "1.1.2",
|
||
Date: "2026-07-26",
|
||
Changes: []string{
|
||
"FIX: the v53 aux row re-key no longer aborts the migration on dolt#11131 encoding drift ('invalid hash length' panic); drifted tables are skipped with a warning, recorded clone-locally, and retried on later passes instead of leaving the database unopenable (#4380).",
|
||
},
|
||
},
|
||
{
|
||
Version: "1.1.0",
|
||
Date: "2026-07-04",
|
||
Changes: []string{
|
||
"STABLE: first stable 1.1.x release; includes the rc.1 and rc.2 cross-clone migration-safety work plus post-rc.2 recovery fixes.",
|
||
"UPGRADE: back up with bd export --all before migrating older or remote-backed databases; the upgrade docs now carry the stable 1.1.0 recipes.",
|
||
"FIX: failed v53 migrations can self-heal on the next open, including wisp_dependencies split-column drift and dirty snapshot tables left by a half-applied pass (#4555, #4558).",
|
||
"FIX: bd dolt commit and bd vc commit can commit a dirty embedded working set that is blocking a pending schema migration; after that, bd migrate can proceed (#4566, #4567).",
|
||
"NEW: the state-aware remote-migrate gate is enabled by default; safe first-mover migrations proceed, while remote-ahead or content-skew cases still stop for adoption or human review (#4516).",
|
||
},
|
||
},
|
||
{
|
||
Version: "1.1.0-rc.2",
|
||
Date: "2026-07-02",
|
||
Changes: []string{
|
||
"RC: fixes the two upgrade-breaking migration regressions reported against rc.1 (#4502, #4534); back up with bd export --all before migrating a remote-backed database.",
|
||
"FIX: the v53 migration no longer fails with Unknown column on databases whose issues table predates the rig/agent columns; the runner repairs the drift before applying (#4502).",
|
||
"FIX: an orphaned child_counters row no longer bricks every bd create after the fk_counter_parent constraint returned; a clone-local cleanup migration heals affected databases automatically (#4534).",
|
||
"FIX: old binaries fail fast on writable opens of a schema-newer database instead of proceeding blind (#4531).",
|
||
"NEW: the remote-migrate gate is state-aware and agent-safe — provably safe migrations auto-resolve; risky states still require BD_ALLOW_REMOTE_MIGRATE=1 by the designated migrator (#4515, #4516).",
|
||
"UPGRADE: the upgrade guide now carries a validated remote-backed / multi-clone recipe with a pre-migrate backup step (#4514).",
|
||
},
|
||
},
|
||
{
|
||
Version: "1.1.0-rc.1",
|
||
Date: "2026-06-23",
|
||
Changes: []string{
|
||
"RC: v1.0.5 was pulled from the default release path after #4259; this candidate carries the cross-clone data-safety fixes for validation before stable promotion.",
|
||
"UPGRADE: For multiple clones sharing one Dolt remote, sync every clone before upgrading, designate one machine to migrate and push, then upgrade/pull the remaining clones before doing tracked work.",
|
||
"NEW: bd refuses silent in-place schema migrations on existing remote-backed databases unless BD_ALLOW_REMOTE_MIGRATE=1 is set by the designated migrator.",
|
||
"NEW: schema_migrations records per-migration content hashes, and bd doctor reports migration-content skew against the cached remote-tracking ref.",
|
||
"FIX: dependencies and wisp_dependencies now use deterministic natural-key-derived IDs, with migration 0050 rekeying existing rows and same-edge pull conflicts auto-resolved when only audit columns differ.",
|
||
"FIX: Dolt primary-key merge refusals are classified with recovery guidance instead of surfacing only a raw Error 1105.",
|
||
},
|
||
},
|
||
{
|
||
Version: "1.0.5",
|
||
Date: "2026-05-28",
|
||
Changes: []string{
|
||
"CHANGE: dependencies.depends_on_id is now a STORED generated column — writes must target exactly one of depends_on_issue_id/depends_on_wisp_id/depends_on_external (enforced by ck_dep_one_target); inserting into depends_on_id fails. Migrations 0041–0042 are intentionally irreversible (restore from a prior Dolt commit to roll back).",
|
||
"CHANGE: JSONL auto-export and auto-staging are now opt-in — set export.auto=true and export.git-add=true to keep the old behavior. Dolt is the canonical store; use bd dolt push/pull for sync and bd backup for restorable backups.",
|
||
"CHANGE: Foreign keys with ON DELETE/UPDATE CASCADE now span issue and wisp tables, so parent delete/rename cascades automatically.",
|
||
"NEW: dolt.mode config key (server|embedded) with validation; bd init warns on ambiguous configs and hard-fails when dolt.host/dolt.port are set without server mode.",
|
||
"NEW: forward schema-skew guard hard-fails when a binary opens a database migrated to a newer schema than it understands.",
|
||
"NEW: bd list --skip-labels toggle; bd show --json count-only details with opt-in streamed payloads.",
|
||
"FIX: bd close supports per-id reasons and idempotent re-close; bd create --defer <future> creates a deferred issue; bd create commits labels atomically.",
|
||
"FIX: migrations run on a connection with no read timeout; duplicate migration version numbers hard-fail instead of silently under-applying.",
|
||
},
|
||
},
|
||
{
|
||
Version: "1.0.4",
|
||
Date: "2026-05-07",
|
||
Changes: []string{
|
||
"NEW: bd init-safety plus --reinit-local/--discard-remote make remote-history destructive init paths explicit, with stable refusal exit codes 10/11/12",
|
||
"CHANGE: bd init --force is now local-only and deprecated in favor of --reinit-local; use --discard-remote only when intentionally replacing remote Dolt history",
|
||
"CHANGE: beads.OpenBestAvailable now returns (Storage, error); SDK callers must drop the removed Unlocker return value",
|
||
"FIX: bd close now uses routed ID resolution in contributor auto-routing workspaces, matching show/update behavior",
|
||
"FIX: Dolt-in-git internal refs/dolt/data pushes skip git hooks to avoid hook recursion",
|
||
"FIX: release workflow and packaging paths hardened for the v1.0.4 release attempt, including checked-in formula adoption and pure-Go test helper coverage",
|
||
},
|
||
},
|
||
{
|
||
Version: "1.0.3",
|
||
Date: "2026-04-24",
|
||
Changes: []string{
|
||
"FIX: go install @latest — new release tag removes the go.mod replace directives that made v1.0.1 and v1.0.2 uninstallable via go install",
|
||
"FIX: npm macOS installs — release archives are flat so npm postinstall finds the bd binary at the archive root",
|
||
"FIX: Windows install — make install removes stale extensionless bd before installing bd.exe so old binaries do not shadow the new executable",
|
||
"FIX: Windows test portability and embedded pre-commit export cwd handling",
|
||
},
|
||
},
|
||
{
|
||
Version: "1.0.2",
|
||
Date: "2026-04-15",
|
||
Changes: []string{
|
||
"FIX: npm publish — updated npm-package/package.json URLs (repository, bugs, homepage) from steveyegge/beads to gastownhall/beads so sigstore provenance validation accepts the artifact (v1.0.0 and v1.0.1 npm publishes failed E422 on provenance verification)",
|
||
},
|
||
},
|
||
{
|
||
Version: "1.0.1",
|
||
Date: "2026-04-15",
|
||
Changes: []string{
|
||
"NEW: bd batch — atomic multi-operation transactions across create/update/close/dep",
|
||
"NEW: bd config drift / bd config apply — detect and reconcile config drift across yaml, git, and database",
|
||
"NEW: bd config show — unified provenance view for effective config values",
|
||
"NEW: started_at timestamp on issues (recorded when first entering in_progress)",
|
||
"NEW: Selective sync — --issues flag, push/pull subcommands, --parent port across trackers",
|
||
"NEW: Pool metrics telemetry for shared-server connection pool diagnosis",
|
||
"NEW: OpenBestAvailable public API for library consumers",
|
||
"NEW: az:// (Azure Blob Storage) recognized as Dolt remote URL scheme",
|
||
"NEW: BEADS_DOLT_READY_TIMEOUT env var to override 10s waitForReady timeout on slow hardware",
|
||
"CHANGE: Auto-export enabled by default — export.path defaults to issues.jsonl, git-add on",
|
||
"CHANGE: gms_pure_go by default — ICU linkage dropped from test/install helpers and release binaries",
|
||
"FIX: Worktree-aware path resolution across hooks, doctor, config validate, bootstrap, reset, rename-prefix, formula search",
|
||
"FIX: Schema migration conflict and wisp-tables-missing-after-bootstrap-clone",
|
||
"FIX: bd mol bond now detects transitive dependency cycles",
|
||
"FIX: bd dep add/remove allows cross-prefix dependency targets",
|
||
"FIX: bd dolt pull nil-pointer panic in embedded mode",
|
||
"FIX: bd list truncation hint shown in all output modes; --watch hierarchy ordering stable",
|
||
"FIX: bd update --defer correctly sets status=deferred",
|
||
"FIX: Remote URL validation hardened at config parse time (security)",
|
||
"FIX: GitLab issue link dependencies now imported during sync pull",
|
||
"FIX: SQLite-era JSONL migration preserves dependencies and labels",
|
||
"FIX: MCP workspace discovery detects Dolt-backed projects",
|
||
"FIX: go install on Windows (ICU header dependency removed)",
|
||
},
|
||
},
|
||
{
|
||
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 Dolt backend guide, now at docs/architecture/dolt.md (#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",
|
||
},
|
||
},
|
||
}
|
||
|
||
func showWhatsNew() error {
|
||
currentVersion := Version
|
||
|
||
if jsonOutput {
|
||
return outputJSON(map[string]interface{}{
|
||
"current_version": currentVersion,
|
||
"recent_changes": versionChanges,
|
||
})
|
||
}
|
||
|
||
// 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()
|
||
return nil
|
||
}
|
||
|
||
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")
|
||
rootCmd.AddCommand(infoCmd)
|
||
}
|