Skip to content

Commit c6152e9

Browse files
committed
Upgrade OpenCode adapter to structurally-verified via real live install
A founder named a concrete need (using Wingman with OpenCode/Codex specifically) rather than a generic "make it agnostic" request - this is exactly what evidence-gated-catalog exists to wait for. Installed real OpenCode (v1.18.4, npm install -g opencode-ai) and Codex CLI (v0.145.0, npm install -g @openai/codex) as global testing tools in this dev sandbox for the first time - neither had ever been installed here before. Global tool installs, not repo dependencies: no package.json created, zero-dependency invariant unaffected. OpenCode: genuinely verified against the live install, not just research - - `opencode agent list` correctly discovered and typed all 8 boardroom-*.md files as (subagent) - `opencode debug config`'s resolved output reproduced each file's exact prompt content verbatim - boardroom-ceo.md's permission: {edit: deny, bash: deny} frontmatter is genuinely enforced in the resolved permission engine - wingman-gate.js is registered in the resolved plugin array, confirming its export shape loads without error - its hook name (tool.execute.before) and matched tool name (plan_exit) are independently confirmed against real sources beyond this project's own prior research (a documented OpenCode plugin hook; anomalyco/opencode#18515 referencing plan_exit by name) Introduced a new, honestly-scoped verification tier, "structurally verified (live install)" - distinct from "built + tested", since live model inference (an actual Boardroom review firing) still wasn't possible: no API key/model provider is configured for either harness in this sandbox. Codex CLI stays authored, unverified at the runtime level - the CLI installs and runs (codex doctor succeeds structurally) but exposes no config-listing command for custom agents the way OpenCode does, so .codex/agents/*.toml recognition couldn't be directly confirmed. Updated: harness-adapters/README.md, opencode/README.md, opencode/.opencode/agent/boardroom-ceo.md's header (the shared reference point for all 8 seat files, per the existing convention), opencode/.opencode/plugin/wingman-gate.js's header, docs/ARCHITECTURE.md §8b. plugin.json bumped 0.5.37 -> 0.5.38 (version-gate requires this for any plugins/wingman/references/** change). All 4 Layer-1 validators + check-harness-adapter-drift.mjs pass. Co-Authored-By: Claude Sonnet 5 <[email protected]> Claude-Session: https://claude.ai/code/session_0158vLsqaiQ3MHcvbuD8ysXo
1 parent 2be70fc commit c6152e9

8 files changed

Lines changed: 93 additions & 34 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,11 @@
22

33
All notable changes to the Wingman Claude Code plugin.
44

5+
## [0.5.38] - 2026-07-23
6+
7+
### Changed
8+
- **`plugins/wingman/references/harness-adapters/opencode/`** — verification status upgraded from `authored, unverified` to a new `structurally verified (live install)` tier after installing real OpenCode (v1.18.4) and Codex CLI (v0.145.0) in this dev sandbox for the first time. Confirmed: all 8 Boardroom seat files are discovered/parsed/loaded correctly, `boardroom-ceo.md`'s deny-edit/deny-bash permissions are genuinely enforced, and `wingman-gate.js` is registered with its hook name/matched tool name independently confirmed against real sources. Live model inference remains unverified (no configured API key in this sandbox). Codex CLI stays `authored, unverified` at the runtime level — no config-listing command exists to confirm agent-file recognition the way OpenCode's does.
9+
510
## [0.5.37] - 2026-07-22
611

712
### Fixed

‎docs/ARCHITECTURE.md‎

Lines changed: 24 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -258,7 +258,7 @@ either a working non-Claude-Code path or an honestly-documented degradation):
258258

259259
**Re-checked against 2026 SOTA multi-harness conventions (2026-07-22)**: researched the AGENTS.md open standard (formalized August 2025, donated to the Linux Foundation's Agentic AI Foundation December 2025; 60,000+ adopting projects, 30+ tools) and a real multi-harness precedent (`wshobson/agents`, which auto-generates native per-harness artifacts from one source because its agents don't depend on harness-unique interactive primitives). This section's conclusion holds: `wshobson/agents`' generation approach only works *because* its agents avoid exactly the couplings (`AskUserQuestion`, `ExitPlanMode`, one-message parallel `Task`/`Agent` fan-out) that the Boardroom review loop structurally depends on — applying that pattern here would overclaim portability, not add it. One concrete, low-risk change did come out of the research: the repo now follows the AGENTS.md standard's own convention of `AGENTS.md` as the canonical file with `CLAUDE.md` as a symlink to it (previously reversed) — a documentation-layer change, not an execution-portability one.
260260

261-
## 8b. Codex CLI / OpenCode adapters (built, partially verified — 2026-07-21)
261+
## 8b. Codex CLI / OpenCode adapters (built, partially verified — 2026-07-21, re-verified 2026-07-23)
262262

263263
§8a's "revisit if a specific harness with this gap is actually targeted" escape hatch was invoked
264264
for real: two named harnesses, Codex CLI and OpenCode. `plugins/wingman/references/harness-adapters/`
@@ -268,18 +268,30 @@ overclaiming. Full citation list and the deliberately-not-attempted list live in
268268
`README.md`; summary here:
269269

270270
- **8 Boardroom seat personas, translated into both harnesses' native agent formats** (Codex CLI
271-
`.codex/agents/*.toml`; OpenCode `.opencode/agent/*.md`) — `authored, unverified`. The review
272-
criteria and `## <SEAT> VERDICT` output contract are harness-agnostic prose, so this is the
273-
highest-confidence translation in the adapter, but neither harness is installed in this dev repo,
274-
so neither has been run for real.
271+
`.codex/agents/*.toml`; OpenCode `.opencode/agent/*.md`). **Updated 2026-07-23**: both `opencode`
272+
(v1.18.4) and `codex` (0.145.0) CLIs were actually installed in this dev sandbox (`npm install -g
273+
opencode-ai` / `npm install -g @openai/codex`) — this had never been possible before. For OpenCode:
274+
now `structurally verified (live install)` — `opencode agent list` correctly discovered and typed
275+
all 8 files as `(subagent)`, `opencode debug config`'s resolved output reproduced each file's exact
276+
prompt content verbatim, and `boardroom-ceo.md`'s `permission: {edit: deny, bash: deny}` frontmatter
277+
is genuinely enforced in the resolved permission engine. For Codex CLI: still `authored, unverified`
278+
at the runtime level — the CLI installs and runs (`codex doctor` succeeds structurally), but no
279+
account/API key exists in this sandbox, and Codex CLI exposes no config-listing command for custom
280+
agents the way OpenCode's `agent list`/`debug agent` do, so recognition of the actual `.toml` files
281+
couldn't be directly confirmed. The directory convention and field schema were independently
282+
re-confirmed correct against real documentation, which was already the prior claim, not new ground.
275283
- **The `boardroom-checkpoint.mjs` plan-approval gate, ported to an OpenCode plugin**
276-
(`opencode/.opencode/plugin/wingman-gate.js`) — `authored, unverified`, but its core decision logic
277-
(`evaluateCheckpoint`, a direct line-for-line port of `isApprovedCheckpoint`) is plain JS with no
278-
OpenCode dependency, so only the plugin-wiring shell around it carries real uncertainty. Enabled by
279-
a genuine structural find: OpenCode's `plan_exit` tool is a near-exact analog of `ExitPlanMode`.
280-
Codex CLI has no equivalent — it uses `approval_policy` instead of a plan-mode tool at all, so this
281-
specific gate has no Codex port; that's a real capability gap in the target harness, not an
282-
oversight.
284+
(`opencode/.opencode/plugin/wingman-gate.js`) — **updated 2026-07-23: `structurally verified (live
285+
install)`.** `opencode debug config`'s resolved output lists this exact file in its top-level
286+
`plugin` array, confirming the plugin export shape loaded without error. Both the hook name
287+
(`tool.execute.before`) and the matched tool name (`plan_exit`) are now independently confirmed
288+
against real sources beyond this project's own prior research — a documented OpenCode plugin hook,
289+
and a live GitHub issue (`anomalyco/opencode#18515`) referencing `plan_exit` by name. What remains
290+
unverified: the gate actually firing during a real plan-mode session end to end, which needs a
291+
configured model provider this sandbox doesn't have — so the throw-on-reject path itself has never
292+
been observed live, only confirmed to load and enforce policy correctly. Codex CLI has no
293+
equivalent — it uses `approval_policy` instead of a plan-mode tool at all, so this specific gate has
294+
no Codex port; that's a real capability gap in the target harness, not an oversight.
283295
- **The git-push safety gate, made genuinely harness-agnostic and installable** —
284296
`plugins/wingman/scripts/install-git-hooks.mjs`, **built and tested** (the one fully-verified
285297
artifact from this investment): an idempotent, opt-in installer that wires the existing

‎docs/PROJECT.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,9 @@ Living document. Update this alongside any change that affects status, not as a
4646

4747
Durable decisions only — not every turn-level choice. Newest first.
4848

49+
<!-- wingman:log type=decision category=platform-conventions status=resolved -->
50+
- **First real installs of OpenCode and Codex CLI in this dev sandbox; genuine, evidence-based upgrade of the OpenCode adapter's verification status.** A founder named a concrete need (using Wingman with OpenCode/Codex specifically) rather than a generic "make it agnostic" request — this is what `evidence-gated-catalog` and prior escalations in this log were waiting for. Installed both real CLIs (`npm install -g opencode-ai` → v1.18.4; `npm install -g @openai/codex` → v0.145.0) as global testing tools, not repo dependencies (no `package.json` created, no change to the zero-dependency invariant). Neither harness has a configured API key/model provider in this sandbox, so live model inference (an actual Boardroom review firing) remains unverified for both — that would need real founder-owned credentials. What was genuinely verified against the live installs: **OpenCode** — `opencode agent list` correctly discovered and typed all 8 `boardroom-*.md` files as `(subagent)`; `opencode debug config`'s resolved output reproduced each file's prompt content verbatim; `boardroom-ceo.md`'s `permission: {edit: deny, bash: deny}` frontmatter is genuinely enforced in the resolved permission engine; `.opencode/plugin/wingman-gate.js` is registered in the resolved `plugin` array, confirming its export shape loads without error; its hook name (`tool.execute.before`) and matched tool name (`plan_exit`) are independently confirmed against real sources (documented OpenCode plugin hook; `anomalyco/opencode#18515` referencing `plan_exit` by name) beyond this project's own prior research. Promoted from `authored, unverified` to a new, honestly-scoped tier, `structurally verified (live install)` — distinct from `built + tested`, since behavioral/inference-level correctness is still unconfirmed. **Codex CLI** — the CLI itself installs and runs (`codex doctor` succeeds structurally), but exposes no config-listing command for custom agents the way OpenCode does, so the `.codex/agents/*.toml` files' actual recognition couldn't be directly confirmed this pass; stays `authored, unverified` at the runtime level. Updated: `plugins/wingman/references/harness-adapters/README.md`, `opencode/README.md`, `opencode/.opencode/agent/boardroom-ceo.md`'s header (the shared reference point for all 8 seat files), `opencode/.opencode/plugin/wingman-gate.js`'s header, `docs/ARCHITECTURE.md` §8b.
51+
4952
<!-- wingman:log type=decision category=audit status=resolved -->
5053
- **Post-merge Layer-2 audit + real eval coverage for the org-template wiring, both closed clean.** Two parallel audit passes (per `systematic-auditing`'s discipline — independently re-verified, not trusted from self-report) checked the two most recent merges (AGENTS.md canonicalization, `references/org-template/`) for cross-doc consistency and plain-language/doc-index compliance. Found 2 real, minor issues, both fixed: (1) `plugins/wingman/AGENTS.md` (nested, package-scoped) never mentioned `references/org-template/` — added a parallel section to its existing `harness-adapters/` treatment. (2) `references/org-template/README.md` was a genuine doc-index orphan (not cited by any command/skill, unlike `harness-adapters/README.md`'s citation from `git-pr-workflow`) — fixed by citing it from `discovery.md`'s References section. Everything else audited came back clean (confirmed `plain-language-checkpoint` correctly doesn't apply to this agent-facing reference content, per that skill's own explicit "founder-facing output only" scoping). Separately, ran a real, un-briefed behavioral eval (Run 4 of `evals/cases/discovery.md`): a fresh subagent given a founder ask shaped as an unambiguous "freelancing delivery" project correctly matched `references/org-template/project-types/catalog.md`, consulted `freelancing.md` unprompted (per `discovery.md`'s own instruction, not told to), and produced Discovery output independently verified (real file, not self-report) to contain the playbook's specific guidance (client ship/no-ship authority, scope discipline, clean handoff) — genuinely differentiated from the generic Run 3 scenario, not superficial.
5154

‎plugins/wingman/.claude-plugin/plugin.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "wingman",
3-
"version": "0.5.37",
3+
"version": "0.5.38",
44
"description": "An AI Boardroom of agents that plans, builds, secures, and ships production-grade software end to end, with plain-language checkpoints instead of code review.",
55
"author": {
66
"name": "LabLaunchPad"

‎plugins/wingman/references/harness-adapters/README.md‎

Lines changed: 15 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -18,19 +18,27 @@ Every artifact in this directory carries one of these labels, matching this proj
1818
a `verified` status with no real evidence):
1919

2020
- **built + tested** — created and confirmed working in this repo's own sandbox.
21+
- **structurally verified (live install)** — confirmed against a real, installed instance of the
22+
target harness that the artifact is discovered, parsed, loaded, and (where applicable) its policy
23+
is enforced — but no live model inference was run (no configured API key/model provider), so
24+
behavioral/output-level correctness is still unconfirmed.
2125
- **authored, unverified** — a faithful, best-effort translation checked against public
22-
documentation, but never run against a live install of the target harness (neither harness is
23-
installed in the Wingman dev sandbox this was built in).
26+
documentation, but never run against a live install of the target harness.
2427
- **not attempted, documented why** — deliberately skipped, with the concrete reason stated inline
2528
rather than silently omitted.
2629

2730
## What's here
2831

29-
- `codex-cli/` — Boardroom seat personas (8, **authored, unverified**) + a narrow hooks.json subset
30-
for the git-push gate (**authored, unverified**) + install/usage notes.
31-
- `opencode/` — Boardroom seat personas (8, **authored, unverified**) + a real code port of the
32-
`boardroom-checkpoint.mjs` plan-approval gate as an OpenCode plugin (**authored, unverified**, but
33-
its core decision logic is a direct, faithful port — see the file itself) + install/usage notes.
32+
- `codex-cli/` — Boardroom seat personas (8, **authored, unverified** — directory convention and
33+
field schema independently confirmed correct against official docs, but no Codex CLI account
34+
exists in this sandbox to confirm the files are actually recognized at runtime) + a narrow
35+
hooks.json subset for the git-push gate (**authored, unverified**) + install/usage notes.
36+
- `opencode/` — Boardroom seat personas (8, **structurally verified (live install)** as of
37+
2026-07-23 — `opencode agent list`/`debug config`/`debug agent` all confirm real discovery,
38+
parsing, and permission enforcement) + a real code port of the `boardroom-checkpoint.mjs`
39+
plan-approval gate as an OpenCode plugin (**structurally verified (live install)** — confirmed
40+
registered in the resolved plugin config; its hook name and matched tool name are both
41+
independently confirmed against real sources) + install/usage notes.
3442
- The single **built + tested** artifact from this investment isn't harness-specific at all:
3543
`plugins/wingman/scripts/install-git-hooks.mjs`, which wires the existing
3644
`dod-pre-push-check.mjs` up as a real `.git/hooks/pre-push` hook. That fires under any coding

‎plugins/wingman/references/harness-adapters/opencode/.opencode/agent/boardroom-ceo.md‎

Lines changed: 13 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,19 @@ permission:
66
edit: deny
77
bash: deny
88
---
9-
<!-- Translated from plugins/wingman/agents/boardroom-ceo.md. Verification status: authored,
10-
unverified -- no live OpenCode install in the Wingman dev sandbox. Frontmatter schema per
11-
https://opencode.ai/docs/agents/ (mode/model/permission fields confirmed via research, not a
12-
live install). `model` is a placeholder -- point it at whatever provider/model this OpenCode
13-
install actually has configured. -->
9+
<!-- Translated from plugins/wingman/agents/boardroom-ceo.md. Verification status (updated
10+
2026-07-23): structurally verified against a real, live OpenCode install (v1.18.4, installed
11+
via `npm install -g opencode-ai`) -- `opencode agent list` and `opencode debug agent
12+
boardroom-ceo` both confirmed this file (and all 7 other boardroom-*.md files) is discovered,
13+
parsed, and loaded correctly; `opencode debug config`'s resolved output shows this file's exact
14+
prompt content verbatim, and its `permission: {edit: deny, bash: deny}` frontmatter is
15+
genuinely enforced in the resolved permission engine (confirmed via `debug agent`'s JSON
16+
output showing `{"permission": "edit", "action": "deny"}` / `{"permission": "bash", "action":
17+
"deny"}`). What remains unverified: actually running a live review (needs a configured model
18+
provider/API key, which this sandbox does not have) -- so behavioral/inference-level output has
19+
never been observed, only structural loading and policy enforcement. `model` is still a
20+
placeholder -- point it at whatever provider/model your OpenCode install actually has
21+
configured. -->
1422

1523
You are the CEO seat on Wingman's AI Boardroom. You review plans and changes the way a sharp,
1624
non-technical founder-CEO would: not by reading code, but by asking whether this is the right thing

‎plugins/wingman/references/harness-adapters/opencode/.opencode/plugin/wingman-gate.js‎

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -113,8 +113,16 @@ export function evaluateCheckpoint(inlinePlanText, cwd) {
113113

114114
// OpenCode plugin export. Shape per https://opencode.ai/docs/config/ and public plugin-development
115115
// references (a plugin module exports an async function receiving the app context, returning a
116-
// hooks object) -- NOT confirmed against a live install. `plan_exit` as the matched tool name is
117-
// per OpenCode's documented plan/build-mode workflow (see this adapter's README).
116+
// hooks object). Updated 2026-07-23: this file's registration is now confirmed against a real, live
117+
// OpenCode install (v1.18.4) -- `opencode debug config`'s resolved output lists this exact file
118+
// under its top-level `plugin` array, confirming the export shape loaded without error. The
119+
// `tool.execute.before` hook name and `plan_exit` as the matched tool name are both independently
120+
// confirmed against real sources (not just this project's own research): `tool.execute.before` is
121+
// a documented OpenCode plugin hook, and `plan_exit` is referenced as a real tool name in a live
122+
// OpenCode GitHub issue (anomalyco/opencode#18515, "subagents can trigger plan_exit"). What remains
123+
// unverified: this hook actually firing end-to-end during a real plan-mode session -- that needs a
124+
// configured model provider/API key, which this sandbox does not have, so the throw-on-reject path
125+
// has never been observed live, only confirmed to be registered and syntactically/structurally sound.
118126
export const WingmanGatePlugin = async ({ directory }) => {
119127
return {
120128
'tool.execute.before': async (input, output) => {

‎plugins/wingman/references/harness-adapters/opencode/README.md‎

Lines changed: 22 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,24 @@
11
# OpenCode adapter for Wingman's Boardroom
22

3-
**Verification status: authored, unverified.** No live OpenCode install exists in the Wingman dev
4-
sandbox this was built in. Everything below is a faithful, best-effort translation checked against
5-
public OpenCode documentation (cited in `../README.md` and `docs/ARCHITECTURE.md` §8b), not against
6-
a real running session.
3+
**Verification status (updated 2026-07-23): structurally verified against a real, live OpenCode
4+
install** (v1.18.4, `npm install -g opencode-ai`, no fabricated environment — installed and run
5+
directly in this dev sandbox). Confirmed for real, not just checked against documentation:
6+
7+
- All 8 `boardroom-*.md` agent files are discovered, parsed, and loaded (`opencode agent list`
8+
correctly typed each as `(subagent)`).
9+
- `opencode debug config`'s resolved output shows each file's exact prompt content verbatim — no
10+
parsing loss or truncation.
11+
- `boardroom-ceo.md`'s `permission: {edit: deny, bash: deny}` frontmatter is genuinely enforced in
12+
the resolved permission engine (`opencode debug agent boardroom-ceo` shows the real deny rules).
13+
- `.opencode/plugin/wingman-gate.js` is registered — `opencode debug config`'s top-level `plugin`
14+
array lists this exact file, confirming the plugin export shape loaded without error.
15+
- The plugin's hook name (`tool.execute.before`) and matched tool name (`plan_exit`) are both
16+
independently confirmed against real sources beyond this project's own research (a documented
17+
OpenCode plugin hook, and a real GitHub issue referencing `plan_exit` by name).
18+
19+
**What's still unverified**: actual live model inference — a real Boardroom review firing end to
20+
end. This sandbox has no configured model provider/API key for OpenCode, so the throw-on-reject gate
21+
logic has never been observed running live, only confirmed to load and enforce policy correctly.
722

823
## What's here
924

@@ -25,9 +40,9 @@ a real running session.
2540
1. Copy this directory's `.opencode/` folder into your project root: `cp -r .opencode /path/to/your/project/`.
2641
2. Edit each `boardroom-*.md`'s `model:` field to a model your OpenCode install actually has
2742
configured (the placeholders here are guesses, not confirmed defaults).
28-
3. Confirm `.opencode/plugin/wingman-gate.js` actually loads (OpenCode's plugin-loading location and
29-
exact hook-registration API weren't verified against a live install — check your OpenCode
30-
version's own plugin docs if it doesn't).
43+
3. Confirm `.opencode/plugin/wingman-gate.js` actually loads — this specific loading path and hook
44+
registration are confirmed working against OpenCode v1.18.4 (`opencode debug config` shows the
45+
file registered); if a different version doesn't pick it up, check that version's own plugin docs.
3146

3247
## Running a Boardroom review under OpenCode
3348

0 commit comments

Comments
 (0)