johno/beads
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
a020c6c7fe3a54c1069e64803a5499815a509c64
beads/cmd/bd
History
Ryan f7e80dd80c feat: add context optimization features for AI agents (#297) 
* feat: add bd prime and setup commands for AI agent integration

This commit consolidates context optimization features for AI agents:

## New Commands

**bd prime** - AI-optimized workflow context injection
- Outputs ~1-2k tokens of workflow context
- Context-aware: adapts to MCP vs CLI mode
- MCP mode: minimal reminders (~500 tokens)
- CLI mode: full command reference (~1-2k tokens)
- Warns against TodoWrite tool and markdown TODOs
- Designed for SessionStart/PreCompact hooks

**bd setup claude** - Claude Code integration installer
- Installs hooks via JSON configuration (not file scripts)
- Supports --project for project-only installation
- Supports --check to verify installation
- Supports --remove to uninstall hooks
- Idempotent (safe to run multiple times)
- Merges with existing settings

**bd setup cursor** - Cursor IDE integration installer
- Creates .cursor/rules/beads.mdc with workflow rules
- Simplified implementation (just overwrites file)

## bd doctor Enhancements

- New: CheckClaude() verifies Claude Code integration
- Detects plugin, MCP server, and hooks installation
- Provides actionable fix suggestions
- Extracted legacy pattern detection to doctor/legacy.go
- Detects JSONL-only mode and warns about legacy issues.jsonl

## Core Improvements

- FindBeadsDir() utility for cross-platform .beads/ discovery
- Works in JSONL-only mode (no database required)
- Sorted noDbCommands alphabetically (one per line for easy diffs)

## Testing

- Unit tests for setup command hook manipulation
- Tests for idempotency, adding/removing hooks
- All tests passing

## Documentation

- cmd/bd/doctor/claude.md - Documents why beads doesn't use Claude Skills
- commands/prime.md - Slash command for bd prime
- Fixed G304 gosec warnings with nosec comments

## Token Efficiency

The bd prime approach reduces AI context usage dramatically:
- MCP mode: ~500 tokens (vs ~10.5k for full MCP tool scan)
- CLI mode: ~1-2k tokens
- 80-99% reduction in standing context overhead

* fix: resolve linting errors in setup utils and remove obsolete test

- Add error check for tmpFile.Close() in setup/utils.go to fix golangci-lint G104
- Remove TestCheckMultipleJSONLFiles test that referenced deleted checkMultipleJSONLFiles function

Fixes golangci-lint errcheck violations introduced in the bd prime/setup feature.
2025-11-12 10:48:36 -08:00
..
doctor
feat: add context optimization features for AI agents (#297)
2025-11-12 10:48:36 -08:00
setup
feat: add context optimization features for AI agents (#297)
2025-11-12 10:48:36 -08:00
templates
fix: add version marker to post-checkout hook and include in CheckGitHooks
2025-11-09 14:58:03 -08:00
testdata
fix: Update dep_add test to match current show output format
2025-11-04 00:23:25 -08:00
autoflush.go
Remove version field from metadata.json
2025-11-08 18:16:39 -08:00
autoimport_test.go
Fix remaining Windows test failures
2025-11-02 10:01:38 -08:00
autoimport.go
Improve Windows git path normalization
2025-11-02 10:38:24 -08:00
autostart_test.go
…
cleanup.go
Add bd cleanup command for bulk deletion of closed issues
2025-11-07 22:06:50 -08:00
cli_fast_test.go
Fix parallel test deadlock by removing t.Parallel() from TestCLI_* tests
2025-11-09 12:55:14 -08:00
comments_test.go
Implement bd comment alias for bd comments add (bd-d3f0)
2025-11-03 22:23:36 -08:00
comments.go
Implement bd comment alias for bd comments add (bd-d3f0)
2025-11-03 22:23:36 -08:00
compact_test.go
Improve cmd/bd test coverage to 42.9%
2025-11-01 11:11:20 -07:00
compact.go
Fix compact command failing with 'SQLite DB needed' error when daemon is running by removing premature store check and using ensureDirectMode for analyze/apply modes (closes beads-vlo) (#294)
2025-11-12 10:37:54 -08:00
config_test.go
…
config.go
Add sync.branch configuration support (bd-b7d2)
2025-11-02 15:37:57 -08:00
create_test.go
Add routing integration tests and documentation
2025-11-04 23:12:42 -08:00
create.go
Add 'new' as alias for 'create' command
2025-11-08 03:12:11 -08:00
daemon_autoimport_test.go
Optimize test suite: split integration tests, add -short support
2025-11-05 20:39:47 -08:00
daemon_autostart.go
Centralize BD_DEBUG logging into internal/debug package
2025-11-06 20:14:34 -08:00
daemon_config.go
Reorganize project structure: move Go files to internal/beads, docs to docs/
2025-11-05 21:04:00 -08:00
daemon_crash_test.go
bd-vcg5: Add daemon crash recovery with panic handler + socket cleanup
2025-11-07 21:17:24 -08:00
daemon_debouncer_test.go
Optimize test suite performance (15-18x speedup)
2025-11-05 10:26:58 -08:00
daemon_debouncer.go
…
daemon_event_loop.go
Fix daemon orphaning: track parent PID and exit when parent dies
2025-11-07 18:57:43 -08:00
daemon_lifecycle.go
Add RPC diagnostics with BD_RPC_DEBUG env var
2025-11-07 21:29:22 -08:00
daemon_lock_test.go
Optimize test suite: split integration tests, add -short support
2025-11-05 20:39:47 -08:00
daemon_lock_unix.go
…
daemon_lock_wasm.go
WIP: WASM port - switch to ncruces/go-sqlite3, add WASM stubs
2025-11-02 22:17:08 -08:00
daemon_lock_windows.go
…
daemon_lock.go
Fix daemon orphaning: track parent PID and exit when parent dies
2025-11-07 18:57:43 -08:00
daemon_logger.go
Refactor daemon.go for testability and maintainability (bd-2b34)
2025-11-01 19:20:01 -07:00
daemon_parent_test.go
Fix daemon orphaning: track parent PID and exit when parent dies
2025-11-07 18:57:43 -08:00
daemon_rotation_test.go
…
daemon_server.go
Fix daemon exiting after 5s on macOS due to PID 1 parent monitoring (GH #278)
2025-11-10 10:22:03 -08:00
daemon_sync_branch_test.go
Optimize test suite: split integration tests, add -short support
2025-11-05 20:39:47 -08:00
daemon_sync_branch.go
Support local-only git repos without remote origin (bd-biwp)
2025-11-09 16:16:45 -08:00
daemon_sync_test.go
Add test coverage for daemon lifecycle and config modules
2025-11-01 21:27:09 -07:00
daemon_sync.go
Cache getMultiRepoJSONLPaths() to avoid redundant calls (bd-we4p)
2025-11-06 19:41:38 -08:00
daemon_test.go
Optimize test suite: split integration tests, add -short support
2025-11-05 20:39:47 -08:00
daemon_unix.go
…
daemon_wasm.go
WIP: WASM port - switch to ncruces/go-sqlite3, add WASM stubs
2025-11-02 22:17:08 -08:00
daemon_watcher_platform_test.go
Optimize test suite: split integration tests, add -short support
2025-11-05 20:39:47 -08:00
daemon_watcher_test.go
Optimize test suite: split integration tests, add -short support
2025-11-05 20:39:47 -08:00
daemon_watcher.go
fix: Address all errcheck and misspell linter errors
2025-11-01 23:56:03 -07:00
daemon_windows.go
…
daemon.go
bd-vcg5: Add daemon crash recovery with panic handler + socket cleanup
2025-11-07 21:17:24 -08:00
daemons_test.go
…
daemons.go
Fix --json flag shadowing issue causing test failures
2025-11-02 18:52:44 -08:00
delete_test.go
Fix bd-8kde: disable auto-import during delete operations
2025-11-08 03:10:12 -08:00
delete.go
Fix --json flag shadowing issue causing test failures
2025-11-02 18:52:44 -08:00
deletion_tracking_test.go
Refactor snapshot management into dedicated module (bd-urob)
2025-11-08 02:20:33 -08:00
deletion_tracking.go
Refactor snapshot management into dedicated module (bd-urob)
2025-11-08 02:20:33 -08:00
dep_test.go
…
dep.go
Fix widespread double JSON encoding bug in daemon RPC calls (bd-1048, bd-4ec8)
2025-11-02 22:34:24 -08:00
detect_pollution.go
fix: Suppress gosec warnings with nolint comments
2025-11-02 08:09:58 -08:00
direct_mode_test.go
…
direct_mode.go
Remove version field from metadata.json
2025-11-08 18:16:39 -08:00
doctor_test.go
feat: add context optimization features for AI agents (#297)
2025-11-12 10:48:36 -08:00
doctor.go
feat: add context optimization features for AI agents (#297)
2025-11-12 10:48:36 -08:00
duplicates_test.go
…
duplicates.go
feat: Add bd merge command for git 3-way JSONL merging (bd-omx1)
2025-11-05 19:16:50 -08:00
epic_test.go
Improve cmd/bd test coverage to 42.9%
2025-11-01 11:11:20 -07:00
epic.go
Fix --json flag shadowing issue causing test failures
2025-11-02 18:52:44 -08:00
export_import_test.go
Optimize test suite performance (15-18x speedup)
2025-11-05 10:26:58 -08:00
export_integrity_integration_test.go
Fix bd-c6cf: Force full export when export_hashes is cleared
2025-11-01 20:29:13 -07:00
export_staleness_test.go
Fix bd-srwk: Add ID-based staleness detection to bd export
2025-11-07 20:07:59 -08:00
export_test.go
Implement bd-zbq2: Export JSONL line count verification
2025-11-05 14:31:41 -08:00
export.go
Fix bd-srwk: Add ID-based staleness detection to bd export
2025-11-07 20:07:59 -08:00
git_sync_test.go
Optimize test suite: split integration tests, add -short support
2025-11-05 20:39:47 -08:00
helpers_test.go
bd sync: 2025-11-09 14:53:59
2025-11-09 14:53:59 -08:00
hooks_test.go
Add bd hooks install command with embedded git hooks (bd-908z)
2025-11-08 01:28:19 -08:00
hooks.go
fix: add version marker to post-checkout hook and include in CheckGitHooks
2025-11-09 14:58:03 -08:00
import_bug_test.go
…
import_idempotent_test.go
…
import_mtime_test.go
fix(import): Update database mtime after import to prevent bd doctor false warnings (#263)
2025-11-08 11:36:05 -08:00
import_multipart_id_test.go
bd sync: 2025-11-09 14:53:59
2025-11-09 14:53:59 -08:00
import_profile_test.go
…
import_shared.go
Add --clear-duplicate-external-refs flag to bd import
2025-11-06 13:01:44 -08:00
import_uncommitted_test.go
Fix bd-u4f5: Add warning when import syncs with working tree but not git HEAD
2025-11-08 00:00:43 -08:00
import.go
Fix: Update DB mtime after import even with 0 changes (#296)
2025-11-12 10:37:32 -08:00
info_test.go
feat: Add bd info --whats-new for agent version awareness (bd-eiz9)
2025-11-08 02:28:54 -08:00
info.go
bd sync: 2025-11-09 14:53:59
2025-11-09 14:53:59 -08:00
init_contributor.go
feat: Add bd init --contributor and --team wizards
2025-11-05 19:04:14 -08:00
init_hooks_test.go
Fix GH#254: bd init now detects and chains with existing git hooks
2025-11-07 15:55:19 -08:00
init_team.go
feat: Add bd init --contributor and --team wizards
2025-11-05 19:04:14 -08:00
init_test.go
bd sync: 2025-11-09 14:13:48
2025-11-09 14:13:48 -08:00
init.go
bd sync: 2025-11-09 14:13:48
2025-11-09 14:13:48 -08:00
integrity_test.go
Fix daemon race condition: prevent stale exports
2025-11-01 22:01:41 -07:00
integrity.go
Fix bd-9bsx: Add sync validation to prevent infinite dirty loop
2025-11-05 18:10:06 -08:00
jsonl_integrity_test.go
Fix bd-c6cf: Force full export when export_hashes is cleared
2025-11-01 20:29:13 -07:00
label_test.go
…
label.go
Fix widespread double JSON encoding bug in daemon RPC calls (bd-1048, bd-4ec8)
2025-11-02 22:34:24 -08:00
list_test.go
Extract normalizeLabels to internal/util/strings.go
2025-11-06 20:00:08 -08:00
list.go
Change bd list to one line per issue, add --long flag
2025-11-08 01:32:13 -08:00
main_test.go
Fix bd-17d5: conflict marker false positives on JSON-encoded content
2025-11-08 13:09:42 -08:00
main.go
feat: add context optimization features for AI agents (#297)
2025-11-12 10:48:36 -08:00
markdown_test.go
…
markdown.go
bd sync: 2025-11-05 13:56:12
2025-11-05 13:56:12 -08:00
merge.go
Vendor beads-merge by @neongreen for native bd merge command
2025-11-06 15:38:48 -08:00
message.go
Implement message system improvements (bd-6uix)
2025-11-08 13:16:53 -08:00
migrate_hash_ids_test.go
…
migrate_hash_ids.go
Merge remote changes and fix isHashID for Base36
2025-11-06 19:23:06 -08:00
migrate_issues.go
Add multi-repo migration guide and bd migrate-issues command
2025-11-05 18:44:02 -08:00
migrate_test.go
Fix config system: rename config.json → metadata.json, fix config.yaml loading
2025-11-02 14:31:22 -08:00
migrate.go
Remove version field from metadata.json
2025-11-08 18:16:39 -08:00
nodb_test.go
bd sync: 2025-11-09 14:53:59
2025-11-09 14:53:59 -08:00
nodb.go
bd sync: 2025-11-09 14:53:59
2025-11-09 14:53:59 -08:00
onboard_test.go
Enhance bd onboard with AI planning docs management guidance
2025-11-02 17:10:41 -08:00
onboard.go
Fix all gosec, misspell, and unparam linter errors
2025-11-02 20:06:05 -08:00
output_test.go
…
prime.go
feat: add context optimization features for AI agents (#297)
2025-11-12 10:48:36 -08:00
priority_test.go
bd sync: 2025-11-05 13:56:12
2025-11-05 13:56:12 -08:00
quickstart.go
…
ready_test.go
…
ready.go
Extract normalizeLabels to internal/util/strings.go
2025-11-06 20:00:08 -08:00
reinit_test.go
Skip TestDatabaseReinitialization on Windows
2025-11-02 11:02:58 -08:00
rename_prefix_repair_test.go
…
rename_prefix_test.go
…
rename_prefix.go
…
reopen_test.go
…
reopen.go
Fix widespread double JSON encoding bug in daemon RPC calls (bd-1048, bd-4ec8)
2025-11-02 22:34:24 -08:00
repair_deps_test.go
…
repair_deps.go
fix: Address all errcheck and misspell linter errors
2025-11-01 23:56:03 -07:00
repo.go
Add multi-repo CLI commands and integrate with daemon sync
2025-11-04 23:12:41 -08:00
restore_test.go
Improve cmd/bd test coverage from 21% to 23.1% (bd-27ea)
2025-10-31 19:44:43 -07:00
restore.go
bd sync: 2025-10-31 22:39:53
2025-10-31 22:39:53 -07:00
scripttest_test.go
Optimize test suite performance - 45% reduction in integration tests
2025-11-04 11:25:36 -08:00
setup.go
feat: add context optimization features for AI agents (#297)
2025-11-12 10:48:36 -08:00
show_test.go
Improve cmd/bd test coverage from 20.2% to 23.3%
2025-11-08 18:22:28 -08:00
show.go
bd sync: 2025-11-05 13:56:12
2025-11-05 13:56:12 -08:00
simple_helpers_test.go
…
snapshot_manager.go
Refactor snapshot management into dedicated module (bd-urob)
2025-11-08 02:20:33 -08:00
stale_test.go
Implement bd stale command (bd-c01f, closes #184)
2025-10-31 23:03:56 -07:00
stale.go
Add --json flag to stale command
2025-11-02 21:25:40 -08:00
status_test.go
Fix bd-9v7l: bd status now uses git history for recent activity
2025-11-06 18:49:07 -08:00
status.go
Fix bd-9v7l: bd status now uses git history for recent activity
2025-11-06 18:49:07 -08:00
sync_local_only_test.go
Support local-only git repos without remote origin (bd-biwp)
2025-11-09 16:16:45 -08:00
sync_merge_test.go
Fix bd-9bsx: Add sync validation to prevent infinite dirty loop
2025-11-05 18:10:06 -08:00
sync_test.go
Add git hooks check to bd doctor
2025-11-02 17:09:39 -08:00
sync.go
Fix bd sync Windows upstream detection (#281)
2025-11-10 10:59:46 -08:00
template_security_test.go
Add template support for issue creation (bd-164b)
2025-11-03 20:31:11 -08:00
template_test.go
Add template support for issue creation (bd-164b)
2025-11-03 20:31:11 -08:00
template.go
fix: CI failures - performance thresholds, test eligibility, Nix hash, lint errors
2025-11-03 22:01:37 -08:00
test_helpers_test.go
Add test safeguards to prevent production database pollution (bd-2c5a)
2025-11-07 21:58:22 -08:00
test_wait_helper.go
test: add waitFor helper for event-driven testing
2025-11-04 01:10:18 -08:00
validate_test.go
Improve cmd/bd test coverage from 21% to 23.1% (bd-27ea)
2025-10-31 19:44:43 -07:00
validate.go
Fix bd-17d5: conflict marker false positives on JSON-encoded content
2025-11-08 13:09:42 -08:00
version_test.go
Add support for bd --version flag
2025-11-05 17:37:53 -08:00
version.go
chore: Bump version to 0.23.1
2025-11-08 22:59:00 -08:00
worktree_test.go
Improve cmd/bd test coverage from 20.2% to 23.3%
2025-11-08 18:22:28 -08:00
worktree.go
Reorganize project structure: move Go files to internal/beads, docs to docs/
2025-11-05 21:04:00 -08:00