* fix: narrow cross-version smoke CI triggers and warn on high skip rate
Remove push-to-main and PR triggers from cross-version smoke test
workflow — 30-45 min runtime is too costly for every push. Keep tag
pushes (releases/RCs) and manual dispatch.
Add a visible warning when >80% of tested versions are skipped, printed
to stderr and GitHub step summary. Prevents silent "all passed" when
nearly nothing actually ran.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* chore: add .buildflags for consistent ICU build configuration
Amp-Thread-ID: https://ampcode.com/threads/T-019d5c3f-42eb-7794-8d59-524bbf77bdf8
Co-authored-by: Amp <amp@ampcode.com>
* Add analysis of getting-started docs: necessity vs. fixable errors
Analyzes ~3,200 lines of getting-started documentation across 9 files.
Finds ~50% of the content compensates for tool-level UX gaps that should
be fixed rather than documented. Categorizes every section as genuinely
necessary, useful reference, workaround for fixable issue, or redundant.
Includes specific recommendations for both tool fixes and doc consolidation.
Requested by @csells.
https://claude.ai/code/session_01Fak22deVmDX3KRBKVptJBL
* Streamline getting-started docs: reduce noise, fix user-facing paths
QUICKSTART.md:
- Change all ./bd to bd (reflects installed binary, not local build)
- Replace go-build install section with brew/npm + link to INSTALLING.md
- Remove Notion sync, database maintenance, and migration sections
(these are advanced topics, not quickstart material)
- Add "Database maintenance" link to Next Steps
README.md:
- Consolidate installation from ~30 lines to ~8 lines
- Remove CGO/build-from-source details (belong in INSTALLING.md)
- Add links to INSTALLING.md sections for all install methods
INSTALLING.md:
- Demote go install/source to "Contributors / Go developers" in matrix
- Move Build Dependencies section after platform installs, retitle to
"Build Dependencies (Contributors Only)" with skip-if-prebuilt note
- Add cross-reference to TROUBLESHOOTING.md in troubleshooting section
Net effect: -91 lines, clearer separation between user and contributor
paths, less noise in the first-time experience.
https://claude.ai/code/session_01Fak22deVmDX3KRBKVptJBL
* fix: detect permission errors in bd init with platform-specific guidance
On Windows, Controlled Folder Access can block bd init from creating
.beads/ with no useful error. Now detects os.IsPermission and prints
specific guidance for Windows (CFA whitelist instructions) and Unix
(ls -la / chmod suggestions) instead of a generic failure message.
https://claude.ai/code/session_01Fak22deVmDX3KRBKVptJBL
* fix: add circuit breaker cleanup to bd doctor --fix
Stale circuit breaker files in /tmp/beads-circuit/ can block all bd
operations. Previously users had to manually rm these files. Now
bd doctor detects stale breaker files as a fixable check, and
bd doctor --fix clears them automatically via CleanStaleCircuitBreakerFiles.
https://claude.ai/code/session_01Fak22deVmDX3KRBKVptJBL
* feat: warn about multiple bd binaries in PATH
bd version now scans PATH for duplicate bd executables and warns when
more than one is found. This catches the common case where go install
and Homebrew binaries coexist, causing version confusion. Symlinks
are resolved to avoid false positives.
https://claude.ai/code/session_01Fak22deVmDX3KRBKVptJBL
* fix: show holding process PID in database lock errors
When the Dolt database is locked, the error message now tries to
identify the holding process by scanning /proc for bd/dolt processes.
On Linux, users see e.g. "Process 12345 (bd/dolt) may be holding
the lock." Gracefully degrades to the previous message on platforms
without /proc (macOS, Windows, FreeBSD).
https://claude.ai/code/session_01Fak22deVmDX3KRBKVptJBL
* fix: only flag circuit breaker files as stale after TTL expires
CheckCircuitBreaker() was counting any open/half-open breaker as stale
regardless of age. This could reset a legitimately active breaker
during a real outage. Now uses the same 5-minute staleness threshold
as CleanStaleCircuitBreakerFiles() — only breakers older than 5 minutes
(from TrippedAt or LastFailure) are flagged for cleanup.
https://claude.ai/code/session_01Fak22deVmDX3KRBKVptJBL
* fix: correct broken doc anchors in README installation links
The "go install" and "from source" links pointed to nonexistent anchors
in INSTALLING.md. Found during review checklist testing.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix: suppress gosec G304 false positive in circuit breaker check
Path comes from filepath.Glob with a controlled pattern, matching
the same nolint pattern used in internal/storage/dolt/circuit.go.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: Amp <amp@ampcode.com>
Stable release. Embedded Dolt default on all platforms, critical
reliability fixes (concurrent panic, spaces in path, schema migration),
22 community PRs merged, tracker hardening across all backends.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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>
Gate embeddeddolt package on //go:build cgo with stub files for !cgo.
Android and freebsd targets use CGO_ENABLED=0 since zig lacks sysroot
headers for these platforms. Server mode still works on all targets.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Zig lacks sysroot headers for android and freebsd targets, causing
stdlib.h not found errors. Revert these two targets to CGO_ENABLED=0
(they do not need embedded Dolt). Remove unused zig wrappers.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Embedded Dolt is now the default storage backend. Adds multi-project/team
sync for Linear/Jira/ADO, Notion and GitLab sync, bd create --graph,
simplified backup system, and 18 bug fixes from 18 contributors.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
The v0.57.0 release was tagged and published from a polecat branch but
the version bump commit was never merged back to main. This lands the
version files, CHANGELOG, and info.go versionChanges on main.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Executed-By: beads/crew/emma
Rig: beads
Role: crew
v0.56.0 release failed because verify-cgo.sh was added to darwin and
freebsd builds which intentionally use CGO_ENABLED=0. Bump to v0.56.1.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Executed-By: beads/crew/emma
Rig: beads
Role: crew
Delete 6 CGO/nocgo stub files and remove //go:build cgo tags from
dolt.go and bootstrap.go. Beads now always operates in server mode
(dolt sql-server subprocess). Embedded mode references removed from
CLI help text and config commands.
Part of epic: Remove embedded Dolt mode (server-only operation).
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Disable CGO for FreeBSD cross-compilation (zig sysroot lacks stdlib.h).
Add PreToolUse hook to block gh run watch across all crew sessions.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Executed-By: beads/crew/emma
Rig: beads
Role: crew
Fix release CI: strip -lresolv entirely from zig cross-compilation
wrappers instead of replacing with -lresolv.9 (zig sysroot has neither).
macOS builds use netgo tag so libresolv is not needed.
Also add GitHub API rate limit warnings to release formula, release.sh,
and emma private memory to prevent burning 5000/hr quota during CI wait.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Executed-By: beads/crew/emma
Rig: beads
Role: crew
Since v0.51.0, the embedded Dolt backend requires CGO. Pre-built
binaries may ship without CGO, causing confusing "no beads database
found" errors instead of explaining the real issue.
Changes:
- Add cgo_check_cgo.go / cgo_check_nocgo.go build-tag pair that
exposes cgoAvailable() at compile time
- Add early CGO check in PersistentPreRun (after noDbCommands) that
exits with a clear, actionable error message pointing users to
Homebrew, GitHub releases, or CGO_ENABLED=1 source builds
- Show CGO status in `bd version` output and JSON response so users
can quickly diagnose binary issues
Commands that don't need a database (version, help, doctor, init, etc.)
continue to work without CGO.
Complements #1870 (release pipeline verification) with defense-in-depth
at the binary level.
Fixes#1856
Fix release workflow YAML broken by heredoc in zig wrapper step,
fix marketplace.json version missed in v0.55.0, run gofmt on 8 files,
fix unused parameter and dead code lint in config.go.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Executed-By: beads/crew/emma
Rig: beads
Role: crew
Retag as v0.54.1 because v0.54.0 tag was poisoned by repeated
delete/recreate cycles and GitHub Actions no longer triggers workflows
for it.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Executed-By: beads/crew/emma
Rig: beads
Role: crew
Also fixes ruff target-version in pyproject.toml (was clobbered to
"0.50.0" by version bump script, restored to "py310").
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Dolt Transition Complete. SQLite backend deleted, JSONL sync layer removed,
daemon/RPC subsystem eliminated. Over 30,000 lines of legacy code removed.
Dolt is now the sole storage backend.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Phase 2 of Dolt transition (woho.2): Remove the entire daemon/RPC layer
now that all commands use direct storage access.
- Delete internal/rpc/ directory (40 files, ~11K lines)
- Delete daemon_deprecated.go stub layer
- Delete compact_rpc.go (daemon-only compact via RPC)
- Delete daemon-specific test files (delete_rpc_test.go, direct_mode_test.go,
dual_mode_test.go, list_watch_test.go)
- Clean up remaining daemon references in ~25 source files:
- Remove daemon RPC branches from update, create, template, markdown,
gate_discover, mol_stale, mol_current, import, query, version, prime
- Remove rpc.Client parameter from show_thread functions
- Simplify info.go to always show "direct" mode
- Simplify sync_import.go to always use inline import
- Remove daemon status checks from staleness, migrate_dolt, rename_prefix
- Remove unused fallbackToDirectMode function
- Remove stale daemon comments from sync.go
- Add daemon_compat.go with --no-daemon flag (backward compat for hooks)
and utility functions (boolToFlag, truncateString, formatUptime, progressBar)
- Fix test files: remove daemonClient cleanup blocks, update findRepliesTo/
findReplies call signatures, remove RPC test functions
- go vet ./... passes clean
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Patch release to restore embedded Dolt mode that was incorrectly
removed from Beads in v0.49.5 (was only supposed to be removed
from Gas Town).
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Executed-By: beads/crew/emma
Rig: beads
Role: crew
Release highlights:
- VersionedStorage interface for pluggable backends
- bd types command and enhancement type alias
- bd close -m flag (git commit convention)
- RepoContext API for centralized git operations
- Dolt backend improvements (WIP)
- Many bug fixes for doctor, sync, hooks, worktrees
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Centralizes repository context resolution via RepoContext API, fixing bugs where git commands run in the wrong repo when BEADS_DIR points elsewhere or in worktree scenarios.