codex-implementer: Phase 2 — 委任 effort を max へ引き上げる (upstream openai/codex-plugin-cc#454 待ち / Plan B 直叩き)

[natsuume]

概要

codex-implementer の委任 reasoning effort を xhigh から max へ引き上げる。前提は upstream openai/codex-plugin-cc#454 (companion の --effort max/ultra 受理) のマージ (経路 A)、または upstream 停滞時の Plan B として codex exec 直叩きへの切替 (経路 B)。

背景

• 親 issue codex-implementer: codex を実装役 subagent として利用する plugin を新設する (luna 委任 + rate limit ガード + 段階的 max 対応) #246 の Phase 2。Phase 1 (codex-implementer: Phase 1 — gpt-5.6-luna 委任 subagent を実装する #247) の完了が前提 (blocked-by)
• gpt-5.6-luna は max effort をサポートする (2026-07-15 実測: app-server model/list RPC で supported reasoning efforts = low/medium/high/xhigh/max。codex debug models でも同じ内容を確認可能。ultra は sol/terra 専用で luna 非対応)
• codex exec --sandbox read-only -m gpt-5.6-luna -c model_reasoning_effort="max" の動作は実機で実証済み (2026-07-15、codex CLI 0.144.1)
• companion v1.0.6 は --effort max をクライアント側 allowlist (normalizeReasoningEffort) で拒否する。修正 PR fix: accept max and ultra reasoning efforts for task --effort openai/codex-plugin-cc#454 が open (allowlist 拡張 + model/list による model-aware validation を実装済み、Codex bot review 通過、2026-07-15 時点でメンテナ応答なし)
• ハングの罠: 未サポートの model×effort ペアを app-server に送ると 400 エラーではなく無イベントのハングになる (app-server: turn/start accepts a model+reasoningEffort pair the model catalog says is unsupported, then hangs with zero events openai/codex#31552)。Phase 2 の実装では組合せ検証が必須要件
• 参考: API のエラーメッセージの effort 列挙は max 未記載のまま (launch 未追随) だが、実際には受理される。API 側挙動が安定していない可能性があるため、着手時に再検証すること

発動条件 (どちらかを満たしたら着手)

• 経路 A: fix: accept max and ultra reasoning efforts for task --effort openai/codex-plugin-cc#454 がマージされ、--effort max を受理する openai-codex plugin の新 version が配布された
• 経路 B (Plan B): upstream の停滞が続き、ユーザが本 issue の pick up を明示的に指示した。この場合 companion を経由せず codex exec --sandbox workspace-write -m <model> -c model_reasoning_effort="max" の直叩きへ切り替える

いずれの経路でも、着手時点で本 issue の記載と実状の差分 (companion の version・API の effort 受理状況) を再確認し、未確定点 (経路 A での companion version 検出方法、旧 companion 環境でのフォールバック挙動等) は実装前に AskUserQuestion で確定させる。

受入基準

• 委任実行時の reasoning effort が max になる (companion の job 記録または codex session rollout で事後確認できること)
• model×effort の組合せ検証: 設定された model が max をサポートしない場合 (例: 将来の model 変更時) は委任せず exit 1 + 理由を stderr に出す (ハング防止)
• max が受理されなくなった場合 (API 側変更等) に無イベントハングで固まらない (timeout と組合せ検証で防御)
• Phase 1 の I/O 契約 (stdin / stdout / stderr / exit code) を変更しない
• 経路 B の場合: hang 防御 (検証済みペアへの限定 or codex debug models / model/list による事前検証) を wrapper 内に実装する

制約

• ultra は対象外
• xhigh → max の性能・枠消費の差分評価は導入後の実測とし、本 issue の完了条件に含めない
• 経路 A / B の選択はユーザ判断であり、本 issue を自動的に pick up しない

想定ファイル

• plugins/codex-implementer/scripts/run-codex-implementer.sh
• plugins/codex-implementer/agents/codex-implementer.md
• plugins/codex-implementer/.claude-plugin/plugin.json (version bump)
• .claude-plugin/marketplace.json
• README.md

関連 issue

親 issue: #246 / blocked-by: #247 / 関連部品: #245 / 外部依存: openai/codex-plugin-cc#454