[EricTechPro]

Note

⏳ In review · round 1 · ✅ 10/10 AC · Closes #35 · Closes #39 · Closes #37 · head 621b38e

Problem

• ✨ [feat] host: unknown host asks for a selection, not Claude #35 Where: scripts/super-board-host.sh
  • a. Any shell it did not recognise answered claude, so OpenCode or a bare terminal silently started the Claude backend
  • b. SUPER_BOARD_HOST accepted only claude or codex
• ✨ [feat] host: detect OpenCode and read a config host key #39 Where: super-board-host.sh, the board config, scripts/super-board-setup.py
  • a. No OpenCode detection, and no saved per-project host to fall back on
• 📝 [docs] hosts: supported hosts, versions and gaps page #37 Where: docs/, README.md
  • a. Nothing told a user which hosts and versions work, how to sign in, or what is missing
• Who: the run orchestrator, onboard, and anyone running super-board outside Claude Code (part of First-class Codex and OpenCode support with shared workflow core and native adapters #30)

Solution

• ✨ [feat] host: unknown host asks for a selection, not Claude #35: claude only on CLAUDECODE; no sign prints nothing, explains SUPER_BOARD_HOST on stderr and exits 65. opencode is a valid override. run-workflow.md halts before any claim on exit 65 or opencode
• ✨ [feat] host: detect OpenCode and read a config host key #39: OPENCODE=1 prints opencode (recorded on OpenCode v2.0.22), checked before CLAUDECODE because it leaks from a parent Claude session; AGENT=1 is ignored. --config <file> reads a top-level host key (same place ♻️ [refactor] install: shared .agents/ folder with per-host links #71's install.sh reads it). A bad config host exits 64
• ✨ [feat] host: detect OpenCode and read a config host key #39 added scope (Eric's decision): setup's fix always writes a missing host from --host and never replaces a set one; check flags values outside claude/codex/opencode (host_errors, red). Onboard writes host from the host check, asking on exit 65. Documented in config-schema.json
• 📝 [docs] hosts: supported hosts, versions and gaps page #37: docs/hosts.md with a row per host (tested version, run, sign-in, gaps, incl. OpenCode's unenforced external_directory deny → attended-only), the detection order, and evidence. README Install links it. tests/test-hosts-doc.sh fails when a SUPER_BOARD_HOST value has no row

Precedence: SUPER_BOARD_HOST > Codex ids > OPENCODE > CLAUDECODE > config host > exit 65, exactly as #39 orders it. A live env sign beats the saved config, so a Codex lane under a Claude-configured board still answers codex.

Acceptance criteria

• ✨ [feat] host: unknown host asks for a selection, not Claude #35: CLAUDECODE=1 → claude; plus CODEX_THREAD_ID → codex; empty env exits 65 with empty stdout
  ↳ tests/test-host.sh
• ✨ [feat] host: unknown host asks for a selection, not Claude #35: SUPER_BOARD_HOST=opencode → opencode; gemini exits 64
  ↳ tests/test-host.sh
• ✨ [feat] host: unknown host asks for a selection, not Claude #35: run-workflow.md names exit 65 and opencode as a halt with a host-selection request; no "otherwise Workflow tool" for an unknown host
  ↳ "Unknown host halts" + step 4 Launch
• ✨ [feat] host: detect OpenCode and read a config host key #39: OpenCode sign alone → opencode; override claude beats it; a Codex id beats it
  ↳ tests/test-host.sh
• ✨ [feat] host: detect OpenCode and read a config host key #39: empty env + --config {"host":"codex"} → codex; no host key still exits 65
  ↳ tests/test-host.sh
• ✨ [feat] host: detect OpenCode and read a config host key #39: config-schema.json documents host next to worker_backend; setup check flags gemini and accepts all three
  ↳ tests/test-setup.sh scenario 13
• ✨ [feat] host: detect OpenCode and read a config host key #39 (added): fix always writes host, never overwrites a set one
  ↳ tests/test-setup.sh scenarios 2 and 13
• 📝 [docs] hosts: supported hosts, versions and gaps page #37: docs/hosts.md row per host with version, invocation, sign-in, gaps; README Install links it
  ↳ tests/test-hosts-doc.sh
• bash tests/run-safety.sh passes on python 3.9
  ↳ PASS 60 suites
• bash tests/run-safety.sh passes on python 3.12
  ↳ PASS 60 suites

Iteration history

Lane	Done	Time	Details
🔨 builder	✅	Oct 19	bash tests/run-safety.sh → PASS 60 suites (py3.9, py3.12) · 621b38e

Risk

🟡 Medium · a Claude shell without CLAUDECODE now halts instead of running; SUPER_BOARD_HOST or config host is the escape hatch. Existing configs get host added on the next setup fix.

🤖 Generated with Claude Code

[qodo-code-review]

Qodo reviews are paused for this user.

Troubleshooting steps vary by plan Learn more →

On a Teams plan?
Reviews resume once this user has a paid seat and their Git account is linked in Qodo.
Link Git account →

Using GitHub Enterprise Server, GitLab Self-Managed, or Bitbucket Data Center?
These require an Enterprise plan - Contact us
Contact us →