From 5561756bad1c8a471d180c67f4808cda4abff45b Mon Sep 17 00:00:00 2001
From: jwbron <8340608+jwbron@users.noreply.github.com>
Date: Thu, 7 May 2026 05:21:02 +0000
Subject: [PATCH 1/2] docs: add --for STATUS to pre-confirm wait-loop example
 (#2531)

---
 docs/guides/concurrent-execution.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/guides/concurrent-execution.md b/docs/guides/concurrent-execution.md
index 2633309de0..5c9effb09c 100644
--- a/docs/guides/concurrent-execution.md
+++ b/docs/guides/concurrent-execution.md
@@ -116,7 +116,12 @@ egg-orch message wait-loop \
   --for CONSENSUS_ACK \
   --for CONSENSUS_NACK \
   --for CONSENSUS_RE_REVIEW \
+  --for STATUS \
   --for OVERSEER_ALERT
+# STATUS carries the directed "Ready to confirm" nudge (#2531): when every reviewer
+# has already ACKed, no further CONSENSUS_ACK/NACK arrive, so STATUS is the only
+# signal that confirms preconditions cleared. On wake: if metadata.ready_to_confirm
+# == true, go to step 5 CONFIRM; otherwise re-enter the wait.
 
 # Producer STAY ALIVE (post-confirm, step 6) — exits on consensus, re-review, or overseer alert
 egg-orch message wait-loop \

From c2ab1691369279a894af53b2301c0f386a829b92 Mon Sep 17 00:00:00 2001
From: "egg-reviewer[bot]"
 <261018737+egg-reviewer[bot]@users.noreply.github.com>
Date: Thu, 7 May 2026 06:13:34 +0000
Subject: [PATCH 2/2] docs: add --for STATUS to lower-level wait --json
 producer loop
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The cursor-threading variant in agent-wait-patterns.md §6 was a BRC
producer pre-confirm loop (same role as the canonical wait-loop idiom)
but did not include --for STATUS. A copy-paster of this snippet would
hit the same all-reviewers-already-ACKed stall #2531 fixed in the
wait-loop variant — the directed STATUS nudge with
metadata.ready_to_confirm == true is the only signal once every
reviewer has already ACKed.

Addresses egg-reviewer non-blocking observation on PR #2545.

Authored-by: egg
---
 docs/reference/agent-wait-patterns.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/reference/agent-wait-patterns.md b/docs/reference/agent-wait-patterns.md
index 937239c0bd..8327bd43b3 100644
--- a/docs/reference/agent-wait-patterns.md
+++ b/docs/reference/agent-wait-patterns.md
@@ -451,7 +451,8 @@ cursor=""
 while true; do
     out=$(egg-orch message wait --json \
         --for CONSENSUS_ACK --for CONSENSUS_NACK \
-        --for CONSENSUS_RE_REVIEW --for OVERSEER_ALERT \
+        --for CONSENSUS_RE_REVIEW --for STATUS \
+        --for OVERSEER_ALERT \
         --timeout 60 \
         ${cursor:+--since "$cursor"})
     rc=$?