HUE-004 — ADR: choose orchestration foundation and v0 worker/runtime contracts
Canonical source:
docs/roadmap/issues.json·HUE-004Specification status:
TBD· Readiness:agent:ready
Choose the smallest durable scheduler/router core and freeze provider-neutral worker plus runtime lifecycle contracts, including the first OpenCode adapter mode.
- Compare custom state machine with Magentic, LangGraph, Mastra and ADK concepts
- Define Space/Session attachment, plan, worker, adapter, steering and reconciliation contracts
- Specify depth, budget and topology defaults
- Spike OpenCode API/server/managed-CLI integration options
Acceptance criteria
Section titled “Acceptance criteria”- ADR resolves TBD-003, TBD-005, TBD-009 and TBD-024
- Contract covers start/events/steer/pause/resume/cancel/reconcile
- HUE—not OpenCode/Hermes—owns canonical Session state
- Unknown-outcome semantics are demonstrated
- At least one fake adapter passes contract tests
Dependencies
Section titled “Dependencies”HUE-003
Non-goals
Section titled “Non-goals”- None beyond the documented scope.
Product contract
Section titled “Product contract”Implementation handoff requirements
Section titled “Implementation handoff requirements”- Preserve the documented security, project, memory and event boundaries.
- Add or update automated tests for every observable acceptance criterion.
- Provide real verification output; do not rely on a worker/agent self-report.
- Update only the exact documentation sections whose status changed.
- Include screenshots or a recording for user-interface changes.
- Include migration, rollback and recovery notes for data/state changes.
- Link the pull request to this issue with
Closes #<issue-number>.