From 092d37632623dd8d423f652d73f463531ca23fa3 Mon Sep 17 00:00:00 2001 From: jedarden Date: Thu, 2 Jul 2026 14:08:27 -0400 Subject: [PATCH] docs(tb-1zrf): document and fix bead-worker starvation bug Self-blocking dependency on tb-1me prevented Pluck from claiming any beads. Removed the circular dependency and documented the root cause and fix. Bead-Id: tb-1zrf Co-Authored-By: Claude --- notes/tb-1zrf.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 notes/tb-1zrf.md diff --git a/notes/tb-1zrf.md b/notes/tb-1zrf.md new file mode 100644 index 0000000..b0d3601 --- /dev/null +++ b/notes/tb-1zrf.md @@ -0,0 +1,30 @@ +# Bead tb-1zrf: Starvation Alert - Self-Blocking Dependency Fix + +## Issue +Starvation alert: "Open beads exist but Pluck found none — possible configuration error." +- 9 open beads in workspace +- 0 beads found by Pluck (bead-worker) + +## Root Cause +`tb-1me` had a **self-blocking dependency** - it blocked itself via a dependency entry added by a batch operation on 2026-07-02T15:25:21.217314Z. + +This created a deadlock: +1. `tb-1me` (deferred) could not be claimed because it blocked itself +2. All non-deferred open beads (tb-163k, tb-2ir, tb-2lh, tb-3iu, tb-5wj, tb-62m) were blocked by `tb-1me` +3. Pluck found 0 claimable beads + +## Resolution +Removed the self-blocking dependency: +```bash +br dep remove tb-1me tb-1me -w . +``` + +After removal, `br ready` now returns `tb-1me` as claimable. + +## Lessons +- Self-blocking dependencies can silently starve the bead worker +- The starvation alert mechanism correctly surfaced the issue +- Always validate dependency chains after batch operations + +## Date Resolved +2026-07-02