diff --git a/agent-pack/platforms/codex/README.md b/agent-pack/platforms/codex/README.md index 6ed336c..d29c5dc 100644 --- a/agent-pack/platforms/codex/README.md +++ b/agent-pack/platforms/codex/README.md @@ -32,6 +32,51 @@ The `AGENTS.md` content is a pointer to merge into the target repository's project instructions. This package does not provide an installer, write to `~/.codex`, or claim Desktop support. +## Codex CLI 0.149.0 native capabilities + +The following provider-native commands are bounded execution and diagnostic +surfaces. They do not become NeuralEngine authority. + +### Optional provider preflight: `codex doctor --json` + +`codex doctor --json` emits a redacted machine-readable report that may provide +evidence about Codex installation and runtime provenance, configuration +parsing, app-server state, sandbox and approval policy, provider/network +readiness, local state/database health, and environment or update state. + +It is an optional provider-side preflight. A healthy result does not replace +`neural status`, verification of `AGENTS.md` or NeuralEngine skill discovery, +NeuralEngine Brain/provenance checks, or live model/session validation. + +### Session browser: `codex agents` + +`codex agents` browses agent sessions on the shared local app-server daemon. It +is not a NeuralEngine role registry and does not define or map `builder`, +`reviewer`, `planner`, or `mechanical` responsibilities. It is not a task +delegation, permission-isolation, concurrency, or review-workflow contract. + +### Existing-session continuation: `codex queue` + +`codex queue --thread --message ` queues a message to an +existing session or thread. The observed command surface does not establish +workflow scheduling, dependency handling, retry or cancellation semantics, +ownership, role transitions, review-artifact generation, Brain-write +authorization, or publication authorization. + +Queue-based workflow automation remains `HOLD` pending a separate bounded +runtime validation. Do not use it to turn a builder continuation into a +reviewer, authorize Brain writes, or imply staging, commit, push, merge, tag, +release, or publication. + +## NeuralEngine authority boundary + +`AGENTS.md` remains the project-instruction authority and +`agent-pack/shared/neuralengine.md` remains the semantic authority. The Codex +skill is a controlled projection of that shared contract. `neural status`, +relevance-gated `neural knowledge search/show`, the read-only Brain default, +explicit Brain-write authorization, and separate publication authorization +remain unchanged. + ## Limitations - Codex CLI is the only supported surface in this adapter.