John Lam
ba6f06e98b
fix(docs): correct bd dep add syntax and semantics
...
Fixed incorrect bd dep documentation in prime.go, cursor.go, and aider.go
- Added missing 'add' subcommand (was 'bd dep <from> <to>', now 'bd dep add <issue> <depends-on>')
- Corrected semantics (docs claimed 'from blocks to' but actual behavior is 'issue depends on depends-on')
This fixes AI agents and users consistently creating dependencies in the wrong direction.
Co-authored-by: jflam <jflam@users.noreply.github.com >
2025-11-29 22:07:00 -08:00
Steve Yegge
d453c6e9ea
bd prime: Auto-detect ephemeral branches and adjust workflow
...
When running on a branch with no upstream (e.g., gastown polecats), output
different SESSION CLOSE PROTOCOL instructions:
- Use 'bd sync --from-main' instead of 'bd sync'
- Skip git push step (branch is local-only)
- Update Sync & Collaboration section to show --from-main
- Update Completing work workflow accordingly
Detection: git rev-parse --abbrev-ref --symbolic-full-name @{u} returns
error if no upstream configured.
Closes bd-4l5
2025-11-25 17:12:42 -08:00
Steve Yegge
7abb870a57
bd sync: 2025-11-24 01:17:34
2025-11-24 01:17:34 -08:00
Codex Agent
bf9b2c83fb
Annotate gosec-safe file accesses
2025-11-17 10:12:46 -07:00
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
