From 53d8a1cdb63d834cfce7fda3826b57402a4140ee Mon Sep 17 00:00:00 2001 From: beads/crew/grip Date: Tue, 13 Jan 2026 19:40:30 -0800 Subject: [PATCH] docs(skill): update beads skill documentation to v0.47.1 - Update SKILL.md version from 0.43.0 to 0.47.1 - Update prerequisites from v0.34.0+ to v0.43.0+ - Add v0.47.0+ row to README.md version compatibility table - Update CLI_REFERENCE.md version from 0.21.0+ to 0.47.0+ - Document new v0.47 features: - bd list --ready flag (v0.47.1) - bd ready --gated for gate-resume discovery - bd create --dry-run for previewing issue creation - bd resolve-conflicts for JSONL merge conflict resolution Co-Authored-By: Claude Opus 4.5 --- claude-plugin/skills/beads/README.md | 1 + claude-plugin/skills/beads/SKILL.md | 4 ++-- .../skills/beads/resources/CLI_REFERENCE.md | 14 +++++++++++++- 3 files changed, 16 insertions(+), 3 deletions(-) diff --git a/claude-plugin/skills/beads/README.md b/claude-plugin/skills/beads/README.md index 84cd9f78..944331e9 100644 --- a/claude-plugin/skills/beads/README.md +++ b/claude-plugin/skills/beads/README.md @@ -99,6 +99,7 @@ NEXT: Implement rate limiting" | Version | Features | |---------|----------| +| v0.47.0+ | Pull-first sync, resolve-conflicts, dry-run create, gate auto-discovery | | v0.43.0+ | Full support: agents, gates, worktrees, chemistry patterns | | v0.40.0+ | Agent beads, async gates, worktree management | | v0.34.0+ | Molecules, wisps, cross-project dependencies | diff --git a/claude-plugin/skills/beads/SKILL.md b/claude-plugin/skills/beads/SKILL.md index 8577d44f..de899404 100644 --- a/claude-plugin/skills/beads/SKILL.md +++ b/claude-plugin/skills/beads/SKILL.md @@ -5,7 +5,7 @@ description: > memory across conversation compaction. Use when work spans sessions, has blockers, or needs context recovery after compaction. allowed-tools: "Read,Bash(bd:*)" -version: "0.43.0" +version: "0.47.1" author: "Steve Yegge " license: "MIT" --- @@ -41,7 +41,7 @@ Graph-based issue tracker that survives conversation compaction. Provides persis ## Prerequisites ```bash -bd --version # Requires v0.34.0+ +bd --version # Requires v0.43.0+ ``` - **bd CLI** installed and in PATH diff --git a/claude-plugin/skills/beads/resources/CLI_REFERENCE.md b/claude-plugin/skills/beads/resources/CLI_REFERENCE.md index 78612b8c..d0f6691f 100644 --- a/claude-plugin/skills/beads/resources/CLI_REFERENCE.md +++ b/claude-plugin/skills/beads/resources/CLI_REFERENCE.md @@ -1,7 +1,7 @@ # CLI Command Reference **For:** AI agents and developers using bd command-line interface -**Version:** 0.21.0+ +**Version:** 0.47.0+ ## Quick Navigation @@ -33,6 +33,10 @@ bd info --json ```bash # Find ready work (no blockers) bd ready --json +bd list --ready --json # Same, integrated into list (v0.47.1+) + +# Find molecules waiting on gates for resume (v0.47.0+) +bd ready --gated --json # Gate-resume discovery # Find stale issues (not updated recently) bd stale --days 30 --json # Default: 30 days @@ -71,6 +75,9 @@ bd create "Tests" -p 1 --json # Auto-assigned: bd-a3f8e9. # Create and link discovered work (one command) bd create "Found bug" -t bug -p 1 --deps discovered-from: --json + +# Preview creation without side effects (v0.47.0+) +bd create "Issue title" -t task -p 1 --dry-run --json # Shows what would be created ``` ### Update Issues @@ -431,6 +438,11 @@ bd sync # 3. Pull from remote # 4. Import any updates # 5. Push to remote + +# Resolve JSONL merge conflict markers (v0.47.0+) +bd resolve-conflicts # Resolve in mechanical mode +bd resolve-conflicts --dry-run --json # Preview resolution +# Mechanical mode rules: updated_at wins, closed beats open, higher priority wins ``` ## Issue Types