V2 路由契約

Router 會針對目前的工作單元建立有邊界的決策。它不會把 Skill 選擇誤當成權限、不會暗中修改 Codex 原生 Goal，也不會宣稱 Host 尚未驗證的 Runtime 能力。

1. 判定請求型態

先判定 Goal relation，再選擇唯一一種 envelope：

Single：單一且有邊界的意圖，只選最小必要 Primary capability。
Phased：包含兩個以上不同階段；每個 Phase 都依最新證據重新路由。
Managed Goal：需要恢復、里程碑或相依關係；每個 Work Item 再使用 Single 或 Phased。

結果必須記錄 envelope、runtime mode、risk、scope anchor 與目前 capability snapshot。

2. 鎖定使用者主導權

沒有 User-specified Skill 時，selection mode 為 auto：Router 選擇最小充分的 Primary 與 Supporting 組合，不需要為自己的推薦反覆詢問 consent。

存在 User-specified Skill 時，selection mode 為 explicit-locked。使用者指定的 Skill 具有主導權；任何額外輔助都必須先提出限定範圍的用途並取得 consent。被拒絕的輔助維持 rejected，同一 scope 內不得啟用或重複詢問。

Plugin runtime 會以 propose_support_consent 將 concrete support set 綁定目前 Phase、scope anchor、Goal revision、plan revision 與 context fingerprint。transition_support_consent 只接受 approve 或 reject intent，呼叫端不能在 transition 時替換 route 欄位。Skill-only 行為只屬 advisory，不是 durable consent gate。

auto 模式必須讀取 capability 的 description、domains、stages 與 availability，不可只靠名稱猜測。Primary 負責目前決策瓶頸或第一個未完成 Phase；Supporting Skills 只包含目前 Phase 與 immediate exit gate 不可缺少的能力，未來 Phase 的能力必須延後到進入該 Phase 時重新路由。Managed Goal 依目前 Work Item 選擇能力，不把 Router 自己當成預設 Primary；未來 Work Item 的 Skill 只保留在計畫中，進入該 Work Item 時再路由，不得聚合進目前 support set。Availability 在語意選擇後才作為 activation gate，不得靜默改寫 intended Skill。

固定輸出形狀是「目前 route = 目前 Phase Primary + immediate exit-gate support」。Phase transition 會建立新 route；Goal 規劃時，未來交付 Skill 留在 Work Graph。若 verified snapshot 將 intended canonical Skill 標為 unavailable，該 Skill 仍是 Primary；fallback 只能寫入 limitation，不得塞入 support_skills。

3. 執行前宣告 Planned Skills

Envelope: single | phased | managed-goal
Phase 或 Work Item: 目前工作範圍
Runtime mode: hybrid | skill-only
Planned Skills: Primary 加上已核准的 Supporting Skills
Consent: not-required | pending | granted | declined
Fallback 或 exit gate: 能力不可用時必須明示

plan_work 對應輸出 routing_envelope、selection_mode、support_consent_required、planned_skill_ids 與 runtime_mode。兩個 consent tools 會回傳 bound route、consent_action、decision reference、state version 與 replay status。

4. 啟用前驗證

只有 capability identity、freshness、authority、policy revision、consent grants、risk requirements 與 activation bindings 全部通過，路由才可執行。Runtime permission、Skill consent 與 production authorization 是彼此分離的決策。

不可用能力必須回傳 typed limitation 與 fallback，不得偽裝成成功執行。

5. 結束後回報 Actual Skills

Actual Skills: 實際開啟 instruction 或 runtime binding 的能力
Changed from plan: 增減項目與原因
Outcome: complete | limited | blocked
Evidence: route、activation、gate 或 fallback references

Skill 只被發現、推薦或出現在 metadata，不代表它能列入 Actual Skills。

延伸閱讀：V2 routing guide 與 security boundaries。