statecraft.
Catalog/statecraft-cli

055-codex-adapter

A Codex adapter, built on the capability seam and admitted only by its own pass of spec 004's suite

Lifecycle approvedImplementation pendingVerification unknownQualification unknown

Proposes statecraft-adapter-codex, the second provider adapter under the conditional F-07 lift of 2026-10-20. It mirrors the Claude Code adapter's shape: codex exec's JSONL stream mapped to spec 003's closed outcomes, a constructed environment, a per-run CODEX_HOME in the spirit of spec 042, and harness delivery under spec 008 without touching the user's own Codex configuration. It declares its capabilities through the seam proposed as spec 047 and is built only after that seam merges. It is qualified only by its own pass of spec 004's negative suite on fixtures recorded from a named Codex version. An appendix records preloop's facts on other harnesses as reference for later adapters; no code.

Read the full pinned specification ↗

Relationships

Claimed units

  • establishes
    {
  "kind": "directory",
  "path": "crates/statecraft-adapter-codex/"
}
  • extends
    {
  "nature": "additive",
  "spec": "004-execution-adapter",
  "unit": {
    "kind": "directory",
    "path": "crates/statecraft-adapter/"
  }
}

Source headings

  1. 055: Codex adapter
  2. 1. Purpose
  3. 2. Territory
  4. 3. Behavior
  5. 3.1 What is spawned
  6. 3.2 The stream and the outcome mapping
  7. 3.3 Per-run configuration
  8. 3.4 The gate hook
  9. 3.5 Qualification
  10. 3.6 Declared capabilities
  11. 4. Out of scope
  12. 5. Resolved decisions
  13. Appendix A: other harnesses (reference only)
  14. Verification

Frozen anchors

No frozen anchors declared.