Skip to content

v3.28.0 — Beads integration overhaul

Choose a tag to compare

View all tags
@zigrivers zigrivers released this 24 May 23:54
· 256 commits to main since this release
v3.28.0
be497d8
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Comprehensive update to scaffold's Beads task-tracking integration to match upstream Beads v1.0.4. Covers ~28 audit findings plus four originally-deferred design decisions.

Highlights

  • Stale-command sweep: bd sync, bd start, bd claim, bd status <id>, bd done, bd block, bd list --actor, and bd worktree create-as-registrar all corrected against the actual v1.0.4 CLI surface. BD_ACTOR → BEADS_ACTOR.
  • Vocabulary alignment: Task statuses migrated to upstream enum (open, in_progress, blocked, deferred, closed + status categories). Priority scale extended to P0–P4. IDs migrated to lowercase hash-style (bd-a3f8).
  • New prescriptions: bd doctor --fix on init + worktree setup, bd ready --claim --json atomic claim, bd preflight before PR, bd merge-slot create + acquire --wait/release for 3+-agent merge serialization, bd gate create --blocks for async coordination, --deps discovered-from:<id> for incidental work.
  • Upstream recipes: /scaffold:beads delegates to bd setup <recipe> instead of hand-rolling CLAUDE.md. New multi-agent-coordination knowledge entry covers bd merge-slot + bd gate.
  • Observability cross-link: task_claimed ledger events now atomically claim the corresponding Beads issue + tag it with ledger_event_id metadata.
  • Opt-in MMR → Beads bridge: .mmr.yaml beads.create_issues_from_blocking_findings. When enabled, blocking review findings become bd bugs (--external-ref "mmr:<finding-hash>").
  • Memory scope split: Filesystem auto-memory documented as user-level; bd remember as project-level.
  • Methodology-scaled types.custom: bd config set types.custom '["story","milestone","spike"]' in deep, off in mvp.

Reference

  • PR: #355
  • Audit: `docs/audits/beads-integration-audit-2026-05-24.md`
  • Plans: `docs/superpowers/plans/2026-05-24-beads-integration-{fixes,deferred-decisions}.md`
  • Follow-ups: `docs/audits/beads-integration-audit-2026-05-24-followups.md`

Known follow-ups

5 small documentation-polish items (1 P1 + 3 P2 + 1 P3) recorded in the follow-ups doc above. None block real-world use; a single follow-up PR will sweep them.

Upgrade notes

For projects upgrading Beads alongside this scaffold release: run bd doctor --fix once to re-sync git hooks. This fixes the unknown command "hook" for "bd" error from stale post-checkout / post-merge shims.

🤖 Built with Claude Code

Assets 2
Loading