fix(queue): rename queued_ids to active_ids, document circular-dep caveat

This commit is contained in:
damocles 2026-06-04 17:35:56 +02:00 committed by mara
commit 5f05caee31
2 changed files with 14 additions and 4 deletions

View file

@ -96,6 +96,11 @@ each entry finishes. When a dep entry transitions to terminal, the loop re-evalu
the queue immediately, so downstream entries are unblocked with no extra wakeup. No
additional `notify_one()` call is needed.
**Circular-dep caveat**: if A depends on B and B depends on A, neither entry ever
becomes runnable — the worker skips both indefinitely with no error. Callers must
ensure acyclic dep graphs. Cycle detection is deferred to a future iteration (when
parallel workers make a stuck queue more visible).
---
## Container view