HUE-028 — Implement OpenCode-first coding worker adapter with scoped terminal and file tools

Canonical source: docs/roadmap/issues.json · HUE-028

Specification status: TBI · Readiness: agent:blocked

Goal

Make OpenCode the primary v0 software execution backend while HUE retains canonical Session/task/policy/evidence state.

Scope

Implement adapter mode selected by TBD-024
Inject versioned context and least-capability grants
Bind repository/worktree/GitHub issue and normalize events
Support steer/pause/cancel/reconcile
Capture usage, changed files and verification evidence

Acceptance criteria

Real OpenCode task modifies only managed worktree
HUE Session survives adapter restart
Normalized events do not expose backend-specific UI coupling
Cancel/reconcile truthfully classify outcome
An alternate adapter can satisfy same contract

Dependencies

HUE-022
HUE-027

Non-goals

None beyond the documented scope.

Product contract

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>.