idd-verify should depend on parallel-ai-agents' canonical ensemble engine (retire the vendored fork)

[kiki830621]

Problem

Original text:
「等一下，idd不是應該要依賴 parallel-ai-agents嗎？現在是不是沒有完全依賴，而有太多hard-coded的東西。 需要官方就直接依賴」
— Source: 使用者訊息 2026-07-02（parallel-ai-agents#20 pipeline 中裁決）

idd-verify 目前 vendor 一份 305 行的 ensemble 引擎 fork（skills/idd-verify/ensemble-workflow.js），與 parallel-ai-agents 的 canonical 引擎（513 行，profiles/replicas/customLenses/maxAgents 泛化）重複維護：findings schema、fail-closed integrity、merge/dedup、sentinel、DA/codex 相位全部同構。重複的實證代價：#205 的 model-default bug 兩邊各修一次（IDD#205 + pai#20）。

Type

refactor

Expected

idd-verify 解析已安裝的 pai 引擎作為 verify backend（依 pai#20 官方化的 stable args 契約）：

• 解析機制：plugin cache 版本發現（~/.claude/plugins/cache/parallel-ai-agents/parallel-ai-agents/<ver>/workflows/ensemble-workflow.js）
• 組態表達：profile:'custom' + customLenses（requirements/logic/security/regression）+ daFocus + sentinel-wrapped issue bodies 經 contextBlock + diffFile + agentModel（值 = idd-verify 既有 IDD_AGENT_MODEL 解析結果）
• Graceful degrade（同 idd-all feature+docs: idd-verify --loop / idd-all unattended 隱性依賴 ralph-loop — 應宣告 + auto-detect + 內建探索 #28 ralph-loop gate 前例）：pai 未安裝 → 降級用現有 vendored copy（退役為 fallback-only、凍結不再演化）→ 再不可用 → manual fan-out
• findings/verdict 消費面不變（兩引擎回傳同構）

Actual

vendored fork 是主路徑；pai 引擎完全未被引用。

Impact

• skills/idd-verify/SKILL.md（backend 解析鏈 + args 組裝）
• skills/idd-verify/ensemble-workflow.js（降級為 fallback-only + 凍結註記）
• 依賴健康檢查（版本相容性宣告：pai >= 2.18.0——agentModel 契約起點）

References

• 依賴裁決與重複度盤點證據：Agent dispatch should default to opus (not inherit the session model) — tracking issue-driven-development#205 parallel-ai-agents#20（diagnosis comment）
• Stable 契約定義：pai workflows/ensemble-workflow.js header「EXTERNAL-CONSUMER CONTRACT」（2.18.0）
• 同型 model-default 修復：issue-driven-development#205（已 shipped 2.88.0）

Clarity Surface(idd-clarify run 2026-07-02T07:55:00Z)

Type	Source	Suggested canonical	Status
(none)	—	no issues detected — issue authored by the pai#20 pipeline with the user's dependency ruling pre-resolved; version-gate 與 customLenses 細節屬 design 決策（Spectra artifacts 定案），非 user-context 缺口	passed

---

Current Status

• Phase: closed
• Updated: 2026-07-02
• Complexity: Spectra · Conflict Class: A_parallel_safe
• Verify: PASS post-fix（0 blocking；2×HIGH 接線缺口當輪修復；Tier-1 契約 live smoke 全項實證）
• Implementation: 1bbb8af on idd/207-idd-verify-depend-on-pai-engine（Spectra idd-verify-depend-on-pai-engine，tasks 7/7）
• Diagnosis: idd-verify should depend on parallel-ai-agents' canonical ensemble engine (retire the vendored fork) #207 (comment)

[kiki830621]

Diagnosis

Root Cause

（架構債，非 bug）idd-verify vendor 一份 305 行窄化 ensemble fork，與 parallel-ai-agents 的 513 行 canonical 引擎重複維護同構機件（findings schema、fail-closed integrity、merge/dedup、sentinel、DA/codex 相位）。重複的實證代價：#205 的 model-default bug 兩 repo 各修一次（IDD#205 + pai#20）。依賴接口已在 pai#20 官方化（EXTERNAL-CONSUMER CONTRACT，pai 2.18.0 起）：profile:'custom' + customLenses + contextBlock + diffFile + agentModel + return {findings, verdict, stats.dispatchModel}。完整重複度盤點證據見 parallel-ai-agents#20 diagnosis。

Strategy

Spectra change（idd-verify spec MODIFIED）：

• Backend 解析鏈改三層：(1) 已安裝 pai 引擎（~/.claude/plugins/cache/parallel-ai-agents/parallel-ai-agents/<ver>/workflows/ensemble-workflow.js，sort -V 取最高版，版本閘門 ≥ 2.18.0——agentModel 契約起點）→ (2) vendored fallback（凍結）→ (3) manual fan-out。每層印 notice line 揭露實際 backend
• args 映射：profile:'custom'、customLenses = IDD 4 lens（requirements/logic/security/regression，focus 文本自現引擎 port）、daFocus、contextBlock = DATA_GUARD 前言 + issue bodies + attachments 清單（pai 端 dataBlock 再包 sentinel）、diffFile、codexCallPath = IDD 自己 vendored 的 codex-call、agentModel = 既有 IDD_AGENT_MODEL 解析值
• vendored copy 凍結：header 加 fallback-only banner（新功能一律上游 pai，不再演化此 fork）
• Engine 行揭露（首輪 prose-only 被 verify 2×HIGH 抓出，模板已真接線）：pai-ensemble <version> (model: <dispatchModel>) vs vendored fallback vs manual fan-out
• spec delta（idd-verify MODIFIED：backend resolution 條款 + degrade scenario）、CHANGELOG、2.88.0 → 2.89.0 — 全項 done；Tier-1 契約 live smoke 全項實證（wf_27d7d3dd-c35）

時序解耦（重要）：本 change 可先於 pai#21 merge 安全出貨——現裝 pai 為 2.17.0（< 閘門），解析鏈自然落在 vendored fallback；使用者 merge pai#21 + dist-sync 2.18.0 後，canonical 路徑自動點亮，零改動。

Complexity

Spectra

Conflict Class

A_parallel_safe（觸碰檔案與 #205 相同但該線已 close；無其他在飛工作）

Residue

• 正式 external-consumer reference 文件（pai 側 verify F16 已註記）——接口穩定後由兩 repo 擇一收斂
• vendored fallback 的最終移除（等 canonical 路徑跑過數輪真 verify 後另議）

[kiki830621]

Verify: #207

Engine

vendored dynamic-workflow fallback — 6/6（4 lenses + DA + Codex/gpt-5.5）, model: opus（本輪跑在 2.88.0 cache 引擎；#207 的三層鏈尚未 ship 故走 fallback——正是本 change 要改變的現狀）

要求覆蓋率

4/4（三層解析鏈、args 映射、fork 凍結、graceful degrade）——但首輪實作被抓到「prose 宣稱 vs 實際接線」落差（見下）。

Findings（合併後 15 筆，triage）

#	Sev	Finding	Action
1/2	HIGH ×2（requirements + DA，同根因）	兩個 master-report ### Engine 模板未接線——canonical 跑起來報告會謊稱「5 general-purpose Agents」（主動誤報，非漏報）；tasks 1.3 勾了但只存在於 prose	Fixed：模板改 ${BACKEND_DESC}, model: ${DISPATCH_MODEL}、三 tier 各設 BACKEND_DESC；tasks.md 誠實化（1.3 註記首輪 prose-only）
3/5/8/11	2×MED+MED+LOW（codex+logic+DA）	$CONTEXT_BLOCK 有消費無組裝（used-before-defined）→ canonical 啟用時 reviewer 會拿不到 issue 文本（pai 端 truthiness gate 直接丟掉 Context 段）——requirements lens 全盲	Fixed：顯式組裝步驟（DATA_GUARD literal + per-issue 全文 + attachments 清單）；live smoke 證實送達（requirements lens 逐字引用 #999 examples）
4/6/13	2×MED+LOW 修正	dispatchModel 抽取只讀 top-level，pai 是巢狀 stats.dispatchModel（DA 正確指出當時屬未驗證假設）	Fixed + 實證：雙路徑抽取 `findings.dispatchModel
7	MED (DA)	「canonical 路徑對未釋出契約零測試、dormant」	Closed with evidence：Tier-1 契約 live smoke wf_27d7d3dd-c35——pai 2.18.0 branch 引擎 × 一字不差 Tier-1 args × 種雙 bug 的 diff：IDD lens 鍵 attribution ✓、contextBlock 送達 ✓、stats.dispatchModel ✓、5/5 agent 實跑 claude-opus-4-8 ✓、雙 bug 四 lens 獨立抓到 + DA 有效對抗 ✓。dormant-by-design（時序解耦）本就記載於 proposal
9	LOW	D3 prose 只寫 codexCall、canonical 用 codexCallPath	Fixed（雙 arg 名分流標注）
10	LOW	版本探索缺 semver 驗證；fallback notice reason 籠統（sort -V 可攜性部分已被 refuted）	Fixed：semver 目錄過濾 + notice 印實際 degrade 原因（四種情況擇一）
12	LOW	段落標題/status prose 仍描述舊二層模型	Fixed（三層化）
14	INFO	Codex 4 項疑慮經交叉驗證 refuted（customLenses shape 等——誠實記錄不進 merge）	Noted
15	INFO	共通前置在 Tier 3 是無害冗餘	Documented（前置註記）

In-scope fixes

2 commits：1bbb8af（實作）+ 36c4137（verify fixes + smoke 證據入 design 契約）。spectra validate 綠；customLenses ≡ vendored LENSES 字面 grep 驗證通過。

Residue

• canonical 路徑的實戰首跑（非 smoke）發生在 pai#21 merge + dist-sync 2.18.0 之後的第一次真 verify——屆時 Engine 行應揭露 pai-ensemble 2.18.0 (canonical #207)，若否即接線回歸
• vendored fork 物理移除另議（issue Residue 既載）

Result

PASS（verify-gated, post-fix） — 0 blocking。本輪教訓：「prose 宣稱的接線」不是接線——揭露格式寫在解析鏈註解裡、模板沒動，兩個 HIGH 一個根因；由 ensemble 抓出 + live smoke 關死，與 #205「load-bearing 假設用一手證據關」同譜系。

[kiki830621]

Closing Summary

Problem

idd-verify vendor 一份 305 行 ensemble fork，與 parallel-ai-agents 的 513 行 canonical 引擎重複維護同構機件；#205 的 model-default bug 兩 repo 各修一次。使用者裁決（pai#20 逐字在案）：「idd不是應該要依賴 parallel-ai-agents嗎…需要官方就直接依賴」。

Root Cause

（架構債）血緣 fork 從未收斂：兩引擎的 findings schema、fail-closed integrity、merge/dedup、sentinel、DA/codex 相位全部同構，卻各自演化。依賴接口在 pai#20 官方化（EXTERNAL-CONSUMER CONTRACT，2.18.0 起）後，維持 fork 再無理由。

Solution

（squash 04f12ee，2 commits）三層 backend 解析鏈：

1. canonical：已安裝 pai 引擎（cache semver 目錄 sort -V 最高版；MIN_PAI=2.18.0 閘門——契約前引擎會靜默丟 agentModel 致 Agent dispatch should default to opus (not inherit the session model) — quota blowout degrades verify #205 回歸 + 揭露造假，永不使用）；args 映射 profile:'custom' + 4 IDD lens（focus ≡ vendored LENSES 字面）+ daFocus + 顯式組裝的 DATA_GUARD contextBlock（pai 端 sentinel 雙層包）+ diffFile + IDD 自有 codexCallPath + IDD_AGENT_MODEL 直通 agentModel
2. vendored fallback：FROZEN banner（新功能一律上游 pai）
3. manual fan-out（不變）
   Engine 模板接線：${BACKEND_DESC}, model: ${DISPATCH_MODEL}（雙路徑抽取：vendored top-level / pai 巢狀 stats.dispatchModel；request-echo fallback 如實標注）。

Verification

6-AI verify（master report：#207 issuecomment-4863931356）→ 2×HIGH（Engine 模板未接線=主動誤報風險）+ MEDIUMs（CONTEXT_BLOCK 懸空、dispatchModel 路徑）當輪全修；DA「對未釋出契約零測試」以 Tier-1 契約 live smoke 關死（run wf_27d7d3dd-c35：pai 2.18.0 branch 引擎 × 完整 args × 種雙 bug diff——IDD lens attribution ✓、contextBlock 送達（requirements lens 逐字引用 acceptance examples）✓、巢狀 stats.dispatchModel='opus' ✓、5/5 agent 實跑 claude-opus-4-8 ✓、雙 bug 四 lens 獨立抓到 ✓）。spectra validate 綠。

Changes

• PR feat: idd-verify depends on parallel-ai-agents' canonical ensemble engine — three-tier resolution, frozen fork (#207) #208（squash → 04f12ee）；spec delta idd-verify MODIFIED；2.89.0
• 註 1：merge-completeness rc=3 = squash 下 intra-branch supersession 假陽性（36c4137 改寫 1bbb8af 的行）——已機械驗證 main（BACKEND_DESC/MIN_PAI/CONTEXT_BLOCK ×14、FROZEN banner、2.89.0）
• 註 2：時序——pai#20 已先 close + dist-sync，cache 現有 2.18.0：本 change ship 當下 canonical 路徑即點亮（閘門 2.18.0 ≥ 2.18.0 通過）

Residue（依 Diagnosis，均已有去處）

• 正式 external-consumer reference 文件：接口穩定後兩 repo 擇一收斂（pai#20 verify F16 亦註記）
• vendored fork 物理移除：等 canonical 跑過數輪實戰 verify 後另議——下一次真 verify 的 Engine 行應揭露 pai-ensemble 2.18.0 (canonical #207)，若否即接線回歸

Distribution Sync

chain 2.89.0：marketplace.json 2.88.0 → 2.89.0、cache 同步、已安裝 plugin 更新（本 session 第 6 次 chain 先例）。