Skip to content

feat(core): tiered orchestration doctrine, depth ladder, verdict disposal contract - #132

Merged
LeXwDeX merged 2 commits into
devfrom
feat/dag-orchestration-depth
Jul 29, 2026
Merged

feat(core): tiered orchestration doctrine, depth ladder, verdict disposal contract#132
LeXwDeX merged 2 commits into
devfrom
feat/dag-orchestration-depth

Conversation

@LeXwDeX

@LeXwDeX LeXwDeX commented Jul 29, 2026

Copy link
Copy Markdown
Owner

Summary

Full restructure of the dag-flow orchestration manual plus a TUI sidebar fix, driven by a real-run diagnosis of shallow orchestration (/dag-flow review produced a flat 6-node graph whose REVISE verdict died silently at the terminal boundary).

Orchestration manual (packages/core/src/plugin/command)

  • Tiered Orchestration Doctrine (policy, governing): advanced-tier nodes conduct/check (decomposition, gates, claim verification, arbitration); standard-tier nodes carry volume; accuracy is bought with breadth (concurrent fan-out, N-sampling) and depth (verdict-gated waves). Tier placement bound to the mechanical lever: required: true / review* workers → advanced tier of dag.jsonc (matches DagConfig.tierModel).
  • Depth Ladder: hard minimum waves by target size — module scope requires exploration → analysis → claim verification → arbitration; "a single wave of parallel opinions is a poll, not a review".
  • Verdict Disposal Contract: non-ACCEPT checkpoint verdicts MUST be disposed in the wake turn (extend / pause-replan-resume / new workflow / reasoned stop) — closes the gap where the runtime orchestrator_unresponsive guard only fires for live workflows, so terminal checkpoints escaped all enforcement.
  • workflow.md: five-phase lifecycle compressed 175→12 lines (it is also the workflow tool description — per-turn token tax); adversarial-review example gains a condition: verdict != ACCEPT continuation node ending the arbiter dead-end; terminal-boundary facts documented; dag-flow.txt gains blast-radius graph scaling.
  • 12 dag-prompts templates shipped (.opencode/dag-prompts/): the manual's template list previously pointed at files that did not exist anywhere — nodes using { id: ... } failed at spawn. Hard-contract style: falsifiable judgment conditions, file:line evidence discipline, unverified_claims sections feeding the verification wave, normalized verdicts.
  • Dead dag_templates/_example.yaml removed (referenced nonexistent dagworker tool).
  • Tests: +3 assertion blocks pinning doctrine/ladder/contract, +1 pinning the example fix.

TUI (packages/tui)

  • DAG sidebar panel: header chevron always rendered and collapsible (was gated on >2 workflows — unreachable, misaligned with MCP); node list ordered by topological waves via computeWaves (was reverse insertion order from desc(seq)).

Test plan

  • packages/core command.test.ts: 16 pass / 174 assertions
  • packages/opencode command.test.ts + dag-templates.test.ts: 29 pass
  • packages/tui dag-inspector-utils.test.ts: 19 pass
  • tsgo --noEmit clean on core and tui

LeXwDeX added 2 commits July 29, 2026 10:40
…osal contract

Restructure the dag-flow orchestration manual around a tiered doctrine: advanced-tier nodes conduct and check, standard-tier nodes buy accuracy with breadth (concurrent fan-out) and depth (verdict-gated waves). Add depth ladder hard minimums, graded review profile with claim verification, verdict disposal contract at the terminal boundary, ship the 12 dag-prompts templates the manual promised, fix the arbiter dead-end example, and drop the dead dagworker template relic.
@LeXwDeX
LeXwDeX merged commit 7b49ab5 into dev Jul 29, 2026
4 checks passed
@LeXwDeX
LeXwDeX deleted the feat/dag-orchestration-depth branch July 29, 2026 02:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant