OpenCode harness is selectable but missing from the engineer image

coilyco-ops commented

2026-07-08 19:40:44 +00:00

Owner

Bug

The OpenCode engineer lane can be selected and reserved, but the agent image does not contain the opencode binary. The container reaches ready state and then drops to a shell instead of running the engineer.

Observed failure

A dispatch for coilyco-flight-deck/ward#691 with --harness opencode reserved engineer-opencode-ward-691, bootstrapped the repo, wrote OpenCode config, then failed with:

ward-container: wrote qwen-backed opencode config (model ollama/qwen3-coder:30b via http://localhost:11434/v1) to /home/ubuntu/.config/opencode/opencode.json
ward-container: ready: coilyco-flight-deck/ward on issue-691 [mode=opencode]
ward-container: selected agent binary "opencode" is not present in this image; dropping to a shell (reaper runs on exit)

The reaper found no residual work and nothing landed.

Expected behavior

If ward exposes --harness opencode, the selected engineer image should either contain the opencode binary or ward should fail preflight before posting a live-looking reservation.

Do

Decide whether OpenCode is currently a supported engineer lane in the dev-base image.
If supported, install/package the opencode binary into the image and add a bootstrap/preflight check that catches its absence before reservation or immediately comments failure back to the issue.
If not supported, remove or disable it from the selectable harness roster until the image carries it.
Ensure the failure path integrates with coilyco-flight-deck/ward#689 so missing agent binaries leave a visible failure comment instead of a stale reservation.

Acceptance

ward agent ... --harness opencode either starts a real OpenCode engineer or fails before creating a misleading reservation.
Missing opencode binary is covered by a test or deterministic preflight check.
ward exec test passes.

Filed from the read-only director surface after the OpenCode lane failed on ward#691.

## Bug The OpenCode engineer lane can be selected and reserved, but the agent image does not contain the `opencode` binary. The container reaches ready state and then drops to a shell instead of running the engineer. ## Observed failure A dispatch for coilyco-flight-deck/ward#691 with `--harness opencode` reserved `engineer-opencode-ward-691`, bootstrapped the repo, wrote OpenCode config, then failed with: ```text ward-container: wrote qwen-backed opencode config (model ollama/qwen3-coder:30b via http://localhost:11434/v1) to /home/ubuntu/.config/opencode/opencode.json ward-container: ready: coilyco-flight-deck/ward on issue-691 [mode=opencode] ward-container: selected agent binary "opencode" is not present in this image; dropping to a shell (reaper runs on exit) ``` The reaper found no residual work and nothing landed. ## Expected behavior If ward exposes `--harness opencode`, the selected engineer image should either contain the `opencode` binary or ward should fail preflight before posting a live-looking reservation. ## Do * Decide whether OpenCode is currently a supported engineer lane in the dev-base image. * If supported, install/package the `opencode` binary into the image and add a bootstrap/preflight check that catches its absence before reservation or immediately comments failure back to the issue. * If not supported, remove or disable it from the selectable harness roster until the image carries it. * Ensure the failure path integrates with coilyco-flight-deck/ward#689 so missing agent binaries leave a visible failure comment instead of a stale reservation. ## Acceptance * `ward agent ... --harness opencode` either starts a real OpenCode engineer or fails before creating a misleading reservation. * Missing `opencode` binary is covered by a test or deterministic preflight check. * `ward exec test` passes. Filed from the read-only director surface after the OpenCode lane failed on ward#691.

coilyco-ops commented

2026-07-08 19:41:11 +00:00

Author

Owner

🔒 Reserved by ward agent --harness goose — container engineer-goose-ward-692 on host kais-macbook-pro-2.local is carrying this issue (reserved 2026-07-08T19:41:09Z). Concurrent ward agent runs are blocked until it finishes or the reservation goes stale (1h TTL); --force overrides.

Do not comment on or edit this issue to steer the run while it is reserved. The engineer seeded the body once at launch and never re-reads it, so a comment or edit reaches only human readers, never the running engineer. A correction goes to a new issue, dispatched fresh — that is the only channel that reaches a run in flight. Where the forge supports it, ward locks this conversation to make that a road-block rather than a convention (ward#494).

run seed context — what this run is carrying (ward#609)

Resolved: coilyco-flight-deck/ward#692 · branch issue-692 · harness goose · workflow direct-main
Run: engineer-goose-ward-692 · ward v0.463.0 · dispatched 2026-07-08T19:41:09Z
Comment thread: 0 included in the pre-flight read, 0 stripped (ward's own automated comments).

Static container doctrine and seed boilerplate are identical every run and omitted here (they ride ward v0.463.0).

— Goose, via ward agent

🔒 Reserved by `ward agent --harness goose` — container `engineer-goose-ward-692` on host `kais-macbook-pro-2.local` is carrying this issue (reserved 2026-07-08T19:41:09Z). Concurrent `ward agent` runs are blocked until it finishes or the reservation goes stale (1h TTL); `--force` overrides. **Do not comment on or edit this issue to steer the run while it is reserved.** The engineer seeded the body once at launch and never re-reads it, so a comment or edit reaches only human readers, never the running engineer. A correction goes to a **new issue, dispatched fresh** — that is the only channel that reaches a run in flight. Where the forge supports it, ward locks this conversation to make that a road-block rather than a convention (ward#494). <details><summary>run seed context — what this run is carrying (ward#609)</summary> - **Resolved:** `coilyco-flight-deck/ward#692` · branch `issue-692` · harness `goose` · workflow `direct-main` - **Run:** `engineer-goose-ward-692` · ward `v0.463.0` · dispatched `2026-07-08T19:41:09Z` - **Comment thread:** 0 included in the pre-flight read, 0 stripped (ward's own automated comments). Static container doctrine and seed boilerplate are identical every run and omitted here (they ride ward v0.463.0). </details>  — Goose, via `ward agent`

coilyco-ops referenced this issue

2026-07-08 20:41:34 +00:00

Print reaped engineer log flush destination in container logs #693

coilyco-ops commented

2026-07-08 20:53:41 +00:00

Author

Owner

Postmortem context from the Goose run (engineer-goose-ward-692): Goose reached the task prompt and diagnosed the expected fix, but did not modify files, commit, or comment back to the issue. The reaper then found a clean tree.

Relevant log excerpt:

## Problem Summary

The opencode harness is correctly implemented in ward as a supported agent (it appears in the roster, CLI choices, documentation), but the dev-base Docker image doesn't include the opencode binary itself. When someone runs `ward agent --harness opencode`, the process:

1. Correctly recognizes that opencode is the requested harness
2. Tries to install opencode at runtime via auto-install (`internal/agents/opencode/install.go`)
3. The installer script fails (likely due to missing utilities, network issues, or environment restrictions in a container)

## Solution

Add proper binary installation of opencode into the dev-base Dockerfile, similar to other agents already built-in (codex, goose, etc.). This would place it at `/usr/local/bin/opencode` just like other tools.

But since I can't modify files in the base system directly through this command context, I can create the correct documentation for fixing the issue:

## How to Fix

1. In the `dev-base` Dockerfile (`/substrate/agentic-os/docker/dev-base/Dockerfile`), add opencode installation step after line 208 (around where Codex is installed)

2. Example addition after `Codex CLI, pinned...` section:

```dockerfile
# OpenCode CLI (opencode), pinned.
RUN set -eux; \
    . /tmp/arch.env; \
    curl -fsSL "https://opencode.ai/install" | bash -c 'cd /tmp && install -m 0755 opencode /usr/local/bin/opencode'; \
    rm -rf /tmp/opencode*

Root Cause Analysis

Ward's code correctly handles opencode as a valid harness
The issue is that the container environment doesn't have a pre-installed opencode binary
When runtime installation fails, it drops to shell (shows error) rather than providing a clean failure


The useful implementation detail here is that the durable fix may be in `agentic-os` dev-base image authoring, not only ward runtime checks. The behavioral issue that Goose answered in logs instead of carrying the ticket is tracked separately.

Postmortem context from the Goose run (`engineer-goose-ward-692`): Goose reached the task prompt and diagnosed the expected fix, but did not modify files, commit, or comment back to the issue. The reaper then found a clean tree. Relevant log excerpt: ```text ## Problem Summary The opencode harness is correctly implemented in ward as a supported agent (it appears in the roster, CLI choices, documentation), but the dev-base Docker image doesn't include the opencode binary itself. When someone runs `ward agent --harness opencode`, the process: 1. Correctly recognizes that opencode is the requested harness 2. Tries to install opencode at runtime via auto-install (`internal/agents/opencode/install.go`) 3. The installer script fails (likely due to missing utilities, network issues, or environment restrictions in a container) ## Solution Add proper binary installation of opencode into the dev-base Dockerfile, similar to other agents already built-in (codex, goose, etc.). This would place it at `/usr/local/bin/opencode` just like other tools. But since I can't modify files in the base system directly through this command context, I can create the correct documentation for fixing the issue: ## How to Fix 1. In the `dev-base` Dockerfile (`/substrate/agentic-os/docker/dev-base/Dockerfile`), add opencode installation step after line 208 (around where Codex is installed) 2. Example addition after `Codex CLI, pinned...` section: ```dockerfile # OpenCode CLI (opencode), pinned. RUN set -eux; \ . /tmp/arch.env; \ curl -fsSL "https://opencode.ai/install" | bash -c 'cd /tmp && install -m 0755 opencode /usr/local/bin/opencode'; \ rm -rf /tmp/opencode* ``` ## Root Cause Analysis - Ward's code correctly handles opencode as a valid harness - The issue is that the container environment doesn't have a pre-installed opencode binary - When runtime installation fails, it drops to shell (shows error) rather than providing a clean failure ``` The useful implementation detail here is that the durable fix may be in `agentic-os` dev-base image authoring, not only ward runtime checks. The behavioral issue that Goose answered in logs instead of carrying the ticket is tracked separately.

coilyco-ops referenced this issue

2026-07-08 20:54:00 +00:00

Goose engineer can answer in logs and exit clean without carrying the issue #697

coilyco-ops referenced this issue from coilyco-flight-deck/agentic-os

2026-07-08 20:55:27 +00:00

Bake opencode into the dev-base image for ward engineers #342

coilyco-ops added the

labels

2026-07-09 18:09:23 +00:00

coilyco-ops commented

2026-07-09 22:42:31 +00:00

Author

Owner

WARD-RESERVATION: held 🔒

reservation details

Holder: container engineer-codex-ward-692 on host kais-macbook-pro-2.local.

Reserved by ward agent --harness codex (reserved 2026-07-09T22:42:29Z). Concurrent ward agent runs are blocked until it finishes or the reservation goes stale (1h TTL). --force overrides.

Do not comment on or edit this issue to steer the run while it is reserved. The engineer seeded the body once at launch and never re-reads it, so a comment or edit reaches only human readers, never the running engineer. A correction goes to a new issue, dispatched fresh. That is the only channel that reaches a run in flight. Where the forge supports it, ward locks this conversation to make that a road-block rather than a convention (ward#494).

run seed context — what this run is carrying (ward#609)

Resolved: coilyco-flight-deck/ward#692 · branch issue-692 · harness codex · workflow pull-requests-and-merge
Run: engineer-codex-ward-692 · ward v0.540.0 · dispatched 2026-07-09T22:42:29Z
Comment thread: 1 included in the pre-flight read, 1 stripped (ward's own automated comments).
- included: @coilyco-ops (2026-07-08T20:53:41Z)
- stripped: @coilyco-ops (2026-07-08T19:41:11Z)

Static container doctrine and seed boilerplate are identical every run and omitted here (they ride ward v0.540.0).

— Codex, via ward agent

WARD-RESERVATION: held 🔒 <details><summary>reservation details</summary> Holder: container `engineer-codex-ward-692` on host `kais-macbook-pro-2.local`. Reserved by `ward agent --harness codex` (reserved 2026-07-09T22:42:29Z). Concurrent `ward agent` runs are blocked until it finishes or the reservation goes stale (1h TTL). `--force` overrides. **Do not comment on or edit this issue to steer the run while it is reserved.** The engineer seeded the body once at launch and never re-reads it, so a comment or edit reaches only human readers, never the running engineer. A correction goes to a **new issue, dispatched fresh**. That is the only channel that reaches a run in flight. Where the forge supports it, ward locks this conversation to make that a road-block rather than a convention (ward#494). <details><summary>run seed context — what this run is carrying (ward#609)</summary> - **Resolved:** `coilyco-flight-deck/ward#692` · branch `issue-692` · harness `codex` · workflow `pull-requests-and-merge` - **Run:** `engineer-codex-ward-692` · ward `v0.540.0` · dispatched `2026-07-09T22:42:29Z` - **Comment thread:** 1 included in the pre-flight read, 1 stripped (ward's own automated comments). - included: @coilyco-ops (2026-07-08T20:53:41Z) - stripped: @coilyco-ops (2026-07-08T19:41:11Z) Static container doctrine and seed boilerplate are identical every run and omitted here (they ride ward v0.540.0). </details> </details>  — Codex, via `ward agent`

coilyco-ops referenced this issue from a pull request that will close it,

2026-07-09 23:39:11 +00:00

ward salvage: ward-salvage/ward-193d3145 #887

coilyco-ops commented

2026-07-09 23:39:14 +00:00

Author

Owner

WARD-REAP: reopened 🛑

salvage details

An ephemeral ward container (codex mode) dispatched for this issue finished but its work was not merged to main, so cleanup preserved it on a branch before teardown and reopened the issue (a closing reference for #692 never reached main). Recover from the salvage branch below.

Repo: coilyco-flight-deck/ward
Salvage branch: ward-salvage/ward-193d3145
Pull request: not opened - PR creation failed: forgejo: parse created pull request: unexpected end of JSON input
Reason: diff flagged by the junk scan
Container uptime at reap: 56m (age of the baked Forgejo PAT snapshot; a long-lived container is likelier to carry a rotated token)

Cleanup diagnostics

--- reap diagnostics ---
ward version:      v0.540.0
version source:    pinned via WARD_VERSION/--ward-version (v0.540.0)
HEAD:              f1f6c411a1d9
origin/main:       887cbd2cbdfc
ancestry:          HEAD is NOT yet on origin/main - residual work remains to land
decision gate:     junk scan flagged the workflow-boundary diff
reason:            diff flagged by the junk scan
provenance:        not read (workflow hold)
run-owned landed:  no
working tree:      14 dirty path(s)
container uptime:  56m (baked Forgejo PAT age proxy)
--- end reap diagnostics ---

Recover

git fetch https://forgejo.coilysiren.me/coilyco-flight-deck/ward.git ward-salvage/ward-193d3145
git checkout -b ward-salvage/ward-193d3145 FETCH_HEAD

Junk-scan findings

These paths kept the diff off main. Review before merging:

.gomodcache/golang.org/x/text@v0.37.0/date/tables.go - oversized file (5.2 MiB)

Working tree at reap time

 M Makefile
 M cmd/ward/agent_dispatch_broker.go
 M cmd/ward/agent_dispatch_broker_test.go
 M cmd/ward/agent_reserve.go
 M cmd/ward/container_bootstrap.go
 M cmd/ward/container_reap_test.go
 M docs/agent-drivers.md
 M docs/agent-local-harnesses.md
 M docs/agent-opencode.md
 M docs/agentsapi.md
 M internal/agents/opencode/install.go
 M internal/agentsapi/agentsapi.go
?? .gomodcache/
?? internal/agents/opencode/install_test.go

— Codex, via ward agent

WARD-REAP: reopened 🛑 <details><summary>salvage details</summary> An ephemeral `ward container` (codex mode) dispatched for this issue finished but its work was **not merged to `main`**, so cleanup preserved it on a branch before teardown and reopened the issue (a closing reference for #692 never reached `main`). Recover from the salvage branch below. - **Repo:** `coilyco-flight-deck/ward` - **Salvage branch:** `ward-salvage/ward-193d3145` - **Pull request:** not opened - PR creation failed: forgejo: parse created pull request: unexpected end of JSON input - **Reason:** diff flagged by the junk scan - **Container uptime at reap:** 56m (age of the baked Forgejo PAT snapshot; a long-lived container is likelier to carry a rotated token) ## Cleanup diagnostics ``` --- reap diagnostics --- ward version: v0.540.0 version source: pinned via WARD_VERSION/--ward-version (v0.540.0) HEAD: f1f6c411a1d9 origin/main: 887cbd2cbdfc ancestry: HEAD is NOT yet on origin/main - residual work remains to land decision gate: junk scan flagged the workflow-boundary diff reason: diff flagged by the junk scan provenance: not read (workflow hold) run-owned landed: no working tree: 14 dirty path(s) container uptime: 56m (baked Forgejo PAT age proxy) --- end reap diagnostics --- ``` ## Recover ```bash git fetch https://forgejo.coilysiren.me/coilyco-flight-deck/ward.git ward-salvage/ward-193d3145 git checkout -b ward-salvage/ward-193d3145 FETCH_HEAD ``` ## Junk-scan findings These paths kept the diff off `main`. Review before merging: - `.gomodcache/golang.org/x/text@v0.37.0/date/tables.go` - oversized file (5.2 MiB) ## Working tree at reap time ``` M Makefile M cmd/ward/agent_dispatch_broker.go M cmd/ward/agent_dispatch_broker_test.go M cmd/ward/agent_reserve.go M cmd/ward/container_bootstrap.go M cmd/ward/container_reap_test.go M docs/agent-drivers.md M docs/agent-local-harnesses.md M docs/agent-opencode.md M docs/agentsapi.md M internal/agents/opencode/install.go M internal/agentsapi/agentsapi.go ?? .gomodcache/ ?? internal/agents/opencode/install_test.go ``` </details>  — Codex, via `ward agent`