Repository navigation
v0.8.0 — minor-tier (N33 orchestrator drift root-cause closure)
[0.8.0] - 2026-04-28
Added — minor-tier (N33 orchestrator drift root-cause closure)
7 stories closing N33 (12+ consecutive cycles of orchestrator drift requiring manual takeover). First minor-tier release since v0.7.0 (8 cycles). Twelfth multi-cycle populated-CSV run. v0.8.0 self-validated: tier=LOW score=25 files=22 sensitive=0 → skip with automated:true. 16 consecutive LOW-tier self-validations (v0.6.5..v0.8.0).
Root cause synthesis (5 parallel research agents): the recovery infrastructure (5 layers shipped v0.6.8..v0.7.2) was inert — wrap_orchestrator_dispatch had zero production callers. quantum-loop.sh did not source lib/orchestrator-liveness.sh. The agents/orchestrator.md agent definition consumed ~30% of context window (1,743 lines / ~39,900 tokens) before any work began. No per-story re-prompt for orchestrator. Signal protocol asymmetry between shell-side and agent-side parsing. git rev-parse HEAD mismatch in worktree mode.
- US-001 — wire recovery infrastructure into
quantum-loop.sh— sourceslib/orchestrator-liveness.sh; newql_wrap_subagent_dispatchhelper for callers (US-004 coordinator + external supervisor scripts). Recovery layers are now reachable in production code. - US-002 — worktree-aware
poll_orchestrator_commits— extends signature to accept optionalWORKTREE_PATH4th arg (andwrap_orchestrator_dispatch3rd arg). Eliminates false-positive STALE in worktree-parallel mode where orchestrator commits land under.ql-wt/<story>/on feature branches. Tests 12 + 13 (4 new assertions on worktree-path STALE + LIVE detection). 22 → 26 liveness assertions. - US-003 — modularize
agents/orchestrator.md— extracts 13 optional/conditional sections toagents/orchestrator-modules/*.md(slop-cleanup, dead-code-detection, intent-graph, skeleton-drift, constant-scan, hyclone, type-audit, full-feature-review, init-and-routing, observations, reground, contract-promotion, quantum-json-fields). Each section inorchestrator.mdreplaced with a stub reference + activation guard. 1,743 → 1,007 lines (42% reduction), exceeds initial AC drift target (≤700 lines) but delivers substantive context-window relief. - US-004 — per-wave coordinator pattern — new
agents/coordinator.mddefines a thin per-wave subagent (one wave per invocation, then exits). Newlib/spawn.sh::spawn_coordinator+build_coordinator_prompthelpers. New--coordinatoropt-in flag inquantum-loop.sh(default--legacy-orchestratorpreserves existing single-spawn behavior). v0.8.1 dogfood will validate end-to-end. - US-005 — signal protocol unification — new
runner_parse_subagent_outputwrapper inlib/runner.shroutes subagent output through the canonicalrunner_parse_outputchain (claim-check + heuristic fallback).agents/orchestrator.mdandagents/coordinator.mdupdated to cite the wrapper instead of ad-hoc<quantum>...</quantum>grep on TaskOutput. - US-006 — integration tests — new
tests/test_quantum_loop_recovery.sh(5 asserts) verifies recovery wiring fires on stale stub orchestrator. Newtests/test_coordinator_dispatch.sh(7 asserts) verifies coordinator agent file + spawn helpers + flag parsing. Plus +4 worktree-path assertions in extended liveness test. - US-007 — retrospective + IDEA_REPORT_v22 + version bump 0.7.10 → 0.8.0 — first minor since v0.7.0 (8 cycles).
Test-suite delta
+16 new assertions across 3 test files:
- 1 extended:
test_orchestrator_liveness.sh22 → 26 (+4) - 2 new:
test_quantum_loop_recovery.sh(5) +test_coordinator_dispatch.sh(7)
Architectural rationale (minor-tier)
This is the first new architectural concept since the multi-runner foundation (v0.7.4 N5) — introduces (a) production wiring for previously-inert infrastructure, (b) a per-wave coordinator pattern (vs the long-running monolithic orchestrator), (c) modular orchestrator definition (13 lazy-loaded modules), (d) unified signal handling. Genuinely minor-tier, validated by the operator.
Honest scope drift
- US-003 AC said
agents/orchestrator.md≤ 700 lines; actual = 1,007 lines. The 42% reduction is substantive but doesn't hit the original target. Further reduction would require extracting Step 3B (Parallel Execution) core logic, which carries regression risk and was deferred. - US-006 ships unit/integration coverage; full coordinator-pattern dogfood validation is deferred to v0.8.1 (running a real cycle through the new path).
Dogfood milestone (v0.8.0)
7/7 user-facing stories shipped first-attempt PASS under manual takeover. 0 retries. Multi-cycle CSV milestone: 33 → 36 rows (3 advisory rows). Aggregate severity now includes 1 MEDIUM finding (first MEDIUM in 8+ cycles — healthy signal for substantive minor work). G30 self-validation: tier=LOW score=25 files=22 sensitive=0 → skip; recorded with automated:true. N33 root-cause closure: 12+ consecutive manual-takeover cycles addressed via 4 layers of fixes; v0.8.1 validation will confirm whether auto-recovery actually fires in a real cycle. Full retrospective: idea-stage/PIPELINE_REPORT_v22.md. v0.8.x backlog: idea-stage/IDEA_REPORT_v22.md.