thin-wrapper-docs — Workgraph live mirror

Metadata

Status	done
Assigned	`agent-308`
Agent identity	`f51439356729d112a6c404803d88015d5b44832c6c584c62b96732b63c2b0c7e`
Created	2026-04-26T17:29:58.499861646+00:00
Started	2026-04-27T02:39:19.362424426+00:00
Completed	2026-04-27T02:44:34.852178157+00:00
Tags	`eval-scheduled`
Eval score	0.75
└ blocking impact	0.80
└ completeness	0.78
└ constraint fidelity	0.40
└ coordination overhead	0.78
└ correctness	0.75
└ downstream usability	0.72
└ efficiency	0.70
└ intent fidelity	0.80
└ style adherence	0.75

Description

Documentation pass for the codex-thin-wrap path. Explain when to use codex vs claude vs nex (and signal that nex is on a deprecation path now that codex covers OAI-compat workloads reliably).

File scope (no overlap with siblings)

README.md (executor section — clarify when to pick which executor)
docs/executors.md (new file OR existing — add codex section detailing custom OAI-compat endpoint config)
docs/research/thin-wrapper-executors-2026-04.md (cross-link only — do NOT modify the research artifact)
DO NOT touch src/ at all
DO NOT touch tests/

Content requirements

Executor selection guide — short table: claude (Anthropic), codex (OpenAI + any OAI-compat including local lambda01-style), nex (in-process, FRAGILE — being phased out), shell, amplifier.
codex + custom endpoint walkthrough — copy-paste recipe matching the user's repro:
```
wg init -m qwen3-coder -e https://lambda01.tail334fe6.ts.net:30000 -x codex
wg service start
wg tui
```
Including any required OPENAI_API_KEY / ~/.codex/config.toml setup steps (whatever the impl task ended up requiring).
Migration note — for users currently on nex: switching to codex is a one-flag change (-x codex instead of -x nex) with the same model + endpoint args.

Validation

README executor table updated.
docs/executors.md has codex section with the user's repro recipe.
Cross-link to docs/research/thin-wrapper-executors-2026-04.md present.
cargo build still passes (no doc-test regressions).
All file paths and CLI flags mentioned actually exist (verify with grep).

Implement directly — do not decompose further.

## Description

Documentation pass for the codex-thin-wrap path. Explain when to use codex vs claude vs nex (and signal that nex is on a deprecation path now that codex covers OAI-compat workloads reliably).

## File scope (no overlap with siblings)
- README.md (executor section — clarify when to pick which executor)
- docs/executors.md (new file OR existing — add codex section detailing custom OAI-compat endpoint config)
- docs/research/thin-wrapper-executors-2026-04.md (cross-link only — do NOT modify the research artifact)
- DO NOT touch src/ at all
- DO NOT touch tests/

## Content requirements

1. **Executor selection guide** — short table: claude (Anthropic), codex (OpenAI + any OAI-compat including local lambda01-style), nex (in-process, FRAGILE — being phased out), shell, amplifier.
2. **codex + custom endpoint walkthrough** — copy-paste recipe matching the user's repro:
   ```
   wg init -m qwen3-coder -e https://lambda01.tail334fe6.ts.net:30000 -x codex
   wg service start
   wg tui
   ```
   Including any required `OPENAI_API_KEY` / `~/.codex/config.toml` setup steps (whatever the impl task ended up requiring).
3. **Migration note** — for users currently on `nex`: switching to codex is a one-flag change (`-x codex` instead of `-x nex`) with the same model + endpoint args.

## Validation
- [ ] README executor table updated.
- [ ] docs/executors.md has codex section with the user's repro recipe.
- [ ] Cross-link to docs/research/thin-wrapper-executors-2026-04.md present.
- [ ] cargo build still passes (no doc-test regressions).
- [ ] All file paths and CLI flags mentioned actually exist (verify with grep).

Implement directly — do not decompose further.

Depends on

done .assign-thin-wrapper-docs

Required by

(none)

Log

2026-04-27T02:39:19.174636758+00:00 Lightweight assignment: agent=Careful Programmer (f5143935), exec_mode=full, context_scope=task, reason=Documentation requires careful verification of CLI flags, file paths, and cargo build compatibility; Careful Programmer's thorough approach matches validation requirements and proven track record (0.70, 90 tasks).
2026-04-27T02:39:19.362427481+00:00 Spawned by coordinator --executor claude --model opus
2026-04-27T02:39:29.446922937+00:00 Starting docs pass for codex-thin-wrap path. Target files: README.md, docs/executors.md, cross-link to docs/research/thin-wrapper-executors-2026-04.md
2026-04-27T02:44:09.007878174+00:00 Wrote docs/executors.md (full per-executor reference + codex custom-OAI walkthrough + nex→codex migration). Updated README with executor selection table + codex repro recipe + cross-link to research artifact. cargo build passes; only pre-existing warnings.
2026-04-27T02:44:31.158622161+00:00 Committed: dfd9764df — pushed to origin/wg/agent-308/thin-wrapper-docs
2026-04-27T02:44:34.852184990+00:00 Task pending LLM gate validation
2026-04-27T02:44:37.073031524+00:00 Migrated PendingValidation → Done (deprecate-pending-validation): agency `.evaluate-*` is now the dependency-unblock gate. To force re-spawn instead, run `wg reject <task>`.