ai-workflow-skill/docs/roadmaps/archive/orch-council-wait.md

Orch Council Wait

Status

• completed

Owner

• codex

Started At

• 2026-03-19

Goal

• implement orch council wait so the leader can block until all three reviewer tasks finish or a timeout is reached

Scope

• add council wait status queries and blocking wait behavior on top of existing council reviewer rows
• add CLI support for orch council wait
• add integration tests for wake and timeout behavior
• update the implementation roadmap and archive this workstream when complete

Checklist

• inspect council wait docs and current council storage
• implement council wait store and CLI command
• add integration coverage for council wait wake and timeout
• run go test ./...
• update docs/implementation-roadmap.md
• archive this roadmap with a completion summary

Files

• docs/roadmaps/archive/orch-council-wait.md
• docs/implementation-roadmap.md
• internal/store/council.go
• internal/cli/orch/council.go
• internal/cli/orch/council_wait.go
• internal/cli/orch/integration_test.go

Decisions

• treat reviewer completion as all council reviewer tasks reaching terminal task states
• reuse the existing orch wait/reconcile polling model rather than introducing a separate push mechanism for councils

Blockers

• none

Next Step

• implement orch council tally by parsing completed reviewer outputs into council_findings and grouping similar proposals

Completion Summary

• orch council wait now blocks until all council reviewer tasks reach terminal task states or a timeout is reached
• wait responses return reviewer task statuses on both wake and timeout paths
• integration tests now cover council wait wake and timeout behavior