refactor: codex channel goes full-dependency — delete vendored codex-call; executable from pai, governance from codex-pro (superpowers-style)

[kiki830621]

Problem

IDD 的 codex 通道是自己 vendored 的 plugins/issue-driven-dev/bin/codex-call（#147 時代決策：「不依賴 pai 的 bin 佈局」）。這個前提已經失效，且形成生態系內同構機件三處：

1. pai 2.18.0 ship bin/codex-call（隨 plugin 進 PATH）— executable 的 canonical provider；codex-pro 的 setup（design D3）明文「executable 歸 pai，不寫死路徑、不越權繞道」
2. codex-pro 治理 model/effort defaults（~/.codex-pro/profile.yaml 兩層 + hardcoded gpt-5.6-sol，codex-pro#3 裁決 2026-07-12）
3. IDD vendored copy — 與 pai 版已分歧 87 diff 行；idd-verify / idd-route / bin/codex-call 的 gpt-5.5 hardcode 落後 GPT 新世代（sister concern from codex-pro#3） #251（2026-07-17）在這份上重做了 codex-pro#3 五天前已做過的同一個 model bump（治理成本重複發生的實證）

#147 的理由在 #207/#219 把 pai 升為 install-time hard dependency（vendored ensemble fork 同時刪除）後已不成立 — IDD 已經 hard-depend pai，卻還 vendor pai 也有的 codex-call。

User Ruling（2026-07-18）

我要改成完全依賴，跟 superpowers 一樣

即：install-time hard dependency + pre-flight fail-fast（缺席 abort + 一步安裝指令），不留 vendored fork（per deep-integration-over-hardcode 的 superpowers exemplar，#209）。

Type

refactor（dependency architecture）

Expected

• plugins/issue-driven-dev/bin/codex-call 刪除
• executable 統一解析 pai 的 bin/codex-call（沿用 idd-verify 既有的 pai cache sort -V 解析 + MIN_PAI version gate — 零新依賴，pai 本就是 hard dependency）
• model/effort 治理 依 codex-pro：上游先官方化 EXTERNAL-CONSUMER CONTRACT（profile.yaml schema + 機器可讀 defaults 檔，同 pai#20 → 2.18.0 前例；上游 issue 見 comment），IDD 解析後以顯式 --model/--effort 呼叫（pai 端 default 是什麼從此無關）
• plugin.json dependencies 加 codex-pro（cross-marketplace：root marketplace allowCrossMarketplaceDependenciesOn 加 codex-pro）
• pre-flight：check-plugin-presence.sh 查 codex-pro（缺席 fail-fast，同 superpowers）
• model-generation-sync drift-guard 重塑：single-pin 從 IDD bin 移到 codex-pro defaults — IDD 樹內零 model pin，換代只動 codex-pro 一處

Actual

三處同構機件；IDD 樹內有一份會漂移的 codex-call fork 與一個 model pin。

Impact

• 消滅 87 行分歧的雙份 executable 維護
• model 換代治理收斂到 codex-pro 一處（IDD/codex-pro 不再各自重做同一個 bump）
• 依賴姿態與 idd-verify should depend on parallel-ai-agents' canonical ensemble engine (retire the vendored fork) #207（pai）/確立「深度整合 >> hard-coded」rule（.claude/rules）並以 superpowers plugin 為首個深度整合對象 #209（superpowers）一致 — IDD 的三個外部能力（ensemble engine / process discipline / codex 治理）全部走同一種 hard-dependency 形狀

---

Current Status

Phase: closed

Tasks

（由 diagnose 產出）

[kiki830621]

Diagnosis

Root Cause / 分析

不是 bug，是依賴架構決策的執行。三處同構機件的成因鏈：#147 當時 pai 還不是 IDD 依賴 → vendor 一份 codex-call 合理；#207/#219 把 pai 升 install-time hard dependency 時，vendored ensemble fork 刪了、codex-call 卻留了下來（當時 scope 只在 ensemble engine）；#251 在 vendored copy 上做 model bump，與 codex-pro#3 五天前的同一 bump 重複 — 治理成本重複的直接實證。

Strategy

三層職責分離（尊重各 plugin 既有架構）：

• 上游先行（codex-pro#7）：官方化 profile contract + defaults.json（機器可讀 single source）→ codex-pro 0.7.0 release。同 pai#20 → 2.18.0 前例
• IDD 端（Spectra change）：刪 bin/codex-call；executable 解析改用 pai cache（沿用既有 sort -V + MIN_PAI gate 的 PAI_DIR）；governance 解析新增（讀 codex-pro cache 的 defaults.json + profile.yaml 兩層，MIN_CODEX_PRO=0.7.0 gate）→ 顯式 --model/--effort 呼叫（pai 端 default 從此無關）
• 依賴接線：plugin.json dependencies + check-plugin-presence.sh pre-flight fail-fast + root marketplace allowCrossMarketplaceDependenciesOn 加 codex-pro
• drift-guard 重塑：model-generation-sync 的 single-pin 契約改指 codex-pro defaults.json；IDD 樹 refute 任何 model pin；codex-call 檔案不存在成為 assertion

Conflict Class

A_parallel_safe（無其他 open issue 共享這些檔案）。

Complexity

Spectra（opt-out → 直接 propose）

Layer 2 命中：install-time dependency 契約 + 跨 plugin 解析協定 = published surface（同 #209 idd-depend-on-superpowers、#207 pai 依賴皆走 Spectra）。Opt-out 成立：方向由使用者裁決逐字錨定（「完全依賴，跟 superpowers 一樣」）、形狀有兩個既有 exemplar 可 mirror、殘餘皆為 propose 階段可導出的細節。
Hard-gate: triggered — 單一概念（codex 通道依賴化）散佈 idd-verify SKILL + bin 刪除 + plugin.json + marketplace.json + 2 個 test suite + references ≥ 6 檔。

Risks

• pai codex-call 與 IDD vendored 版 87 行分歧 — 需 diff 審查：IDD 版是否有 pai 版缺的修正（[refactor] idd-verify Codex invocation: migrate codex exec subprocess → codex-call HTTP wrapper #147 後的 hang fix 等）？若有 → 先 upstream 到 pai 再切換，不得以「切換」之名靜默丟失修正
• codex-pro 未安裝的使用者 → fail-fast 訊息必含一步安裝指令（superpowers 同款）
• defaults.json 讀取失敗（cache 佈局變動）→ fail-fast，不靜默 fallback 舊 model（Agent dispatch should default to opus (not inherit the session model) — quota blowout degrades verify #205 fail-loud 判準）

Residue

codex-pro producer skills 全面改讀 defaults.json（上游 follow-up，見 codex-pro#7 Expected 3）；pai 端 default gpt-5.5 的 bump（pai repo 自己的事，IDD 顯式傳參後無關）。

Vagueness Pre-check

• V1: 1 — 使用者裁決 + 兩個 exemplar，做什麼完全清楚
• V4: 2 — 完成 = vendored 刪除 + 兩依賴接線 + suite 綠 + fail-fast 驗證
• Triggered: no

[Layer V: V1=1 V4=2, not triggered; attended]

Hard-gate: triggered — 見 Complexity 段錨點。
Source: /idd-diagnose attended, 2026-07-18 — next: 上游 codex-pro#7 implement → release，回頭 /spectra-propose

[kiki830621]

Divergence Audit（diagnosis Risk 1 清除）

87 行分歧審查完畢，方向與 Risk 假設相反：IDD vendored 版（header 自述 copy 自 pai@2.9.0）落後 pai 2.18.0 四個修正 —

pai 2.18.0 有、IDD vendored 無	後果（留在 vendored 版上）
exp 以 NSNumber parse（Int/Double 兩態）	valid token 讀成 exp=0 → 每次呼叫都強制 refresh
OAuth secrets 寫檔前 umask(0o077)	staging file 出生時 0644 — group/other 可讀的秘鑰窗口
form-encoding 用 RFC 3986 unreserved set（非 .urlQueryAllowed）	refresh_token 含 +/&/= 被靜默毀損或 parameter pollution
flock 取得後 re-read token	parallel ensemble contention 下用 stale token

IDD 版唯一領先：default model gpt-5.6-sol（#251）— 依賴化後 IDD 顯式傳 --model，無需保留。

結論：切換到 pai 的 codex-call = 淨升級，無任何修正需要 upstream。這同時是本案的最強實證 — vendored copy 的靜默落後正是 deep-integration rule 要消滅的失敗模式。

Source: divergence audit, 2026-07-18

[kiki830621]

Implementation Complete

PR: #265（idd/264-codex-channel-dependency）
Spectra change: codex-channel-dependency（proposal / design D1–D5 / spec delta（idd-verify ADDED）/ tasks 4/4，validate ✓ analyze 0；merge 後 archive）
Commit: 228763d；上游 codex-pro 98c1b59（0.7.0）+ pai（2.19.0），皆已 ship + 結案

Checklist

• 上游先行：codex-pro#7（profile-contract.md + defaults.json，0.7.0）＋ pai#22（codexModel/codexEffort args，2.19.0）— 兩邊 marketplace 已同步
• Divergence audit（Risk 1）：vendored 版落後 pai 四個修正 → 切換 = 淨升級，無需 upstream 任何東西
• 刪 bin/codex-call；executable 統一 $PAI_CODEX_CALL（前置區 PAI_DIR 兩用重排）
• 治理解析：MIN_CODEX_PRO=0.7.0 gate + defaults.json 起底 + profile.yaml 兩層；fail-fast 無 soft fallback
• canonical tier codexModel/codexEffort args（MIN_PAI → 2.19.0）；manual fan-out / legacy 直呼帶顯式參數
• dependencies + allowCrossMarketplaceDependenciesOn + pre-flight（superpowers 形狀逐項對齊）
• model-generation-sync v2 契約重塑（RED 17/8 → GREEN 25/0）；全 sweep 36 suites 0 fail

Residue

pai 自家 codex-call default 的 bump（顯式傳參後對 IDD 無關，pai 另案）；codex-pro producer resolver 讀檔化（codex-pro#7 Residue）。

[kiki830621]

Closing Summary

Problem：codex 通道三處同構機件 — pai ship executable、codex-pro 管治理、IDD 還 vendor 一份 codex-call（#147 時代，前提已被 #207/#219 推翻）。divergence audit 證實 vendored 版落後 pai 四個安全/正確性修正；#251 在其上重做了 codex-pro#3 五天前已做過的 model bump。

User Ruling（2026-07-18）：完全依賴，跟 superpowers 一樣。

Solution（Spectra change codex-channel-dependency；上游先行）：

• codex-pro 0.7.0（their issue 7）：治理層官方化 — profile-contract.md + 機器可讀 defaults.json
• pai 2.19.0（their issue 22）：codexModel/codexEffort additive 契約 args（原 engine 寫死 --model gpt-5.5）
• IDD：刪 bin/codex-call；executable 統一 $PAI_CODEX_CALL（MIN_PAI → 2.19.0）；治理 MIN_CODEX_PRO=0.7.0 gate + defaults.json 起底 + profile.yaml 兩層、fail-fast 無 soft fallback；三處呼叫帶顯式治理值；dependencies + marketplace 白名單 + pre-flight（superpowers 形狀逐項對齊）。IDD 樹內零 model pin — 換代只動 codex-pro 一處。

Verification：model-generation-sync 重塑 v2 契約（vendored 檔重現 = 紅；RED 17/8 → GREEN 25/0）；全 sweep 36 suites 0 fail；PR #265 review + merged（228763d）。

Changes：idd-verify SKILL、刪 bin/codex-call、suite 重塑、plugin.json、root marketplace.json、Spectra artifacts（隨後 archive）。

Residue：pai 自家 codex-call default bump（顯式傳參後與 IDD 無關）；codex-pro producer resolver 讀檔化（codex-pro#7 Residue）。

Distribution sync：v2.98.0（本 session 隨後發版）。

[kiki830621]

📊 For Reviewer / Collaborator

現在：codex 通道完全依賴化落地 — executable 歸 pai（2.19.0）、治理歸 codex-pro（0.7.0）、IDD vendored copy 刪除、樹內零 model pin，PR #265 merged
Blocking：無
你該做什麼：無 — 已結案（root cause / solution 詳見 Closing Summary）

last-updated by idd-close at closed, 2026-07-18