feat(governance): 接入三 Agent 佈建布局

docs/ai/AI_AGENT_AUTOMATION_WORKLIST_2026-06-04.md

@@ -11,10 +11,13 @@
 | Agent 市場治理 | 72% | 進行中 | `agent_market_governance_snapshot_v1`、API、UI 分頁、每週觀察流程 |
 | Nemotron 實際整合應用 | 30% | 完整回放前仍被關卡擋下 | `blocked_needs_evidence`，下一關是 `refresh_source_evidence_then_5_record_smoke_only` |
 | 工具 / 服務 / 套件 AI 自動化 | 92% | P0 已完成；P1 服務 / runtime / 監控 / provider / service health / 備份 / DR / 套件與供應鏈只讀基線已完成；P1-007 失敗限定通知合約與前端 redaction 合約已完成；下一主線是 P2-004 依賴 / 供應鏈漂移監控 | 狀態分類、盤點 schema、權限矩陣、靜態盤點種子、只讀 API、UI 骨架、驗證、自動化待辦 schema / 快照 / API / 分組 UI、Backup / DR 目標盤點、準備度矩陣、備份通知政策、Backup / DR 證據 UI、復原演練批准包模板、異地 / escrow 準備度狀態、任務批准邊界、確定性進度彙總、Python 套件 / 供應鏈只讀基線、JS pnpm/npm 只讀基線、Docker build surface 只讀基線、CVE / license / drift 嚴重度政策、定期依賴漂移與外部資料來源檢查設計、依賴升級批准包模板、runtime_surface_inventory_v1 schema / snapshot / API / UI、gitea_workflow_runner_health_v1 schema / snapshot / API / UI、observability_contract_matrix_v1 schema / snapshot / API / UI、ai_provider_route_matrix_v1 schema / snapshot / API / UI、service_health_gap_matrix_v1 schema / snapshot / API / UI、service health evidence cards UI、service_health_failure_notification_policy_v1 schema / snapshot / API / UI 已完成 |
+| OpenClaw / Hermes / NemoTron 佈建布局 | 45% | P1-401 / P1-402 已完成；仍是只讀 layout 與治理頁顯示，不是 runtime deploy | `ai_agent_deployment_layout_v1` schema、`ai_agent_deployment_layout_2026-06-11.json`、`GET /api/v1/agents/agent-deployment-layout`、治理頁自動化盤點 UI、`AI_AGENT_DEPLOYMENT_LAYOUT_2026-06-11.md` |
 | 本工作清單與分析報告 | 100% | 已完成 | 本 MD 文件 |
 
 AI Agent 自動化工作包目前完成度：**92%**。本工作清單文件本身完成度：**100%**。
 
+三 Agent 佈建布局目前完成度：**45%**。第一波已完成只讀 schema / snapshot / API / 測試 / 報告，第二波已接入治理頁自動化盤點 UI；正式 runtime 佈署、Telegram E2E 發送與 AgentSession 工作流仍需逐項 gate。
+
 完成度計算模型：
 
 ```text
@@ -54,6 +57,19 @@ AI Agent 自動化工作包目前完成度：**92%**。本工作清單文件本
 | Claude Agent SDK 候選 | DevOps / 程式修復專家 | 離線修復評分、patch plan 批判 | SDK/API 使用、未經 OpenClaw/HITL 的執行 |
 | CrewAI / ADK / Microsoft 候選 | 次級或平台候選 | 觀察 / 回放準備度、能力評分表 | 生產執行 |
 
+### 3.1 OpenClaw / Hermes / NemoTron 佈建布局（P1-401）
+
+| 項目 | 狀態 |
+|---|---|
+| 佈建布局 schema | 已完成：`docs/schemas/ai_agent_deployment_layout_v1.schema.json` |
+| 佈建布局 snapshot | 已完成：`docs/evaluations/ai_agent_deployment_layout_2026-06-11.json` |
+| 只讀 API | 已完成：`GET /api/v1/agents/agent-deployment-layout` |
+| 細化報告 | 已完成：`docs/ai/AI_AGENT_DEPLOYMENT_LAYOUT_2026-06-11.md` |
+| 前端治理 UI | 已完成：P1-402，治理頁自動化盤點 tab 已顯示佈建布局、主責 Agent、Telegram policy、批准/阻擋狀態 |
+| Telegram 三 Agent lane E2E | 待辦：P1-403，必須沿用 Gateway / ADR-035，不允許 Agent 直接發送 |
+| AgentSession / Redis Streams runtime loop | 待辦：P2-401，需 migration / worker gate |
+| NemoTron 3 Ultra smoke | 待辦：P3-401，需 source refresh + cost/data approval |
+
 ## 4. 工作流總覽
 
 | ID | 工作流 | 目標 | 目前狀態 | 目標狀態 |

docs/ai/AI_AGENT_DEPLOYMENT_LAYOUT_2026-06-11.md

@@ -0,0 +1,116 @@
+# OpenClaw / Hermes / NemoTron 佈建布局與協作報告
+
+> 日期：2026-06-11（台北時間）
+> 狀態：只讀布局與治理頁接線完成，runtime 佈署尚未授權。
+> 權威資料：`docs/evaluations/ai_agent_deployment_layout_2026-06-11.json`
+> Schema：`docs/schemas/ai_agent_deployment_layout_v1.schema.json`
+> API：`GET /api/v1/agents/agent-deployment-layout`
+
+## 1. 結論
+
+目前已把 OpenClaw、Hermes、NemoTron 依各自專長安排到主機、套件、工具、服務、專案、網站前後台、學習協作與 Telegram 告警布局中。
+
+本波完成的是「可驗證佈建布局」，不是直接把 Agent 遠端安裝到所有主機；因此不會碰 Secret、不送 Telegram、不改主機、不裝 SDK、不呼叫付費 API、不進 shadow/canary、不改 production route。
+
+## 2. 完成度
+
+| 範圍 | 完成度 | 狀態 |
+|---|---:|---|
+| 三 Agent 佈建布局合約 | 100% | Schema、snapshot、loader、API、測試已建立 |
+| 佈建布局資料覆蓋 | 100% | 42 個 target 已納入 |
+| 治理頁只讀顯示 | 100% | 自動化盤點 tab 已接 API 與繁中顯示 |
+| Runtime 實際部署 | 0% | 需要逐項 gate / approval / deploy |
+| Telegram Gateway 整合布局 | 70% | 既有 Gateway / ADR-035 可承接；本波不直接送訊息 |
+| 主動學習與協作布局 | 45% | 已定義 AgentSession / Redis Streams / KM / replay 回饋；runtime loop 需後續落地 |
+
+## 3. Agent 分工
+
+| Agent | 專長 | 主要佈建 lane | 可主動做 | 必須交給誰 |
+|---|---|---|---|---|
+| OpenClaw | 生產仲裁、HITL、執行風險、Telegram action-required | production decision core | 只讀診斷、風險分級、批准包審查、批准後執行仲裁 | Hermes 彙整治理；NemoTron 做離線模型評估 |
+| Hermes | 治理、知識、文件、套件/供應鏈、降噪、跨專案盤點 | governance / knowledge / reporting | 盤點、報告、runbook、依賴漂移、降噪提案、批准包草稿 | OpenClaw 仲裁生產與 Telegram；NemoTron 評估模型能力 |
+| NemoTron | 離線專家、模型比較、工具呼叫、NIM / NVIDIA replay | offline evaluator | sanitized smoke、replay 評分、輸出合約檢查、模型能力矩陣 | OpenClaw 仲裁 shadow/canary/production；Hermes 彙整來源與報告 |
+
+## 4. 覆蓋範圍
+
+| Domain | Target 數 | 主要 owner |
+|---|---:|---|
+| 主機 | 6 | OpenClaw |
+| 套件與建置 | 3 | Hermes |
+| 工具 | 8 | Hermes / OpenClaw |
+| 服務 | 8 | OpenClaw / Hermes |
+| 專案 | 8 | Hermes / OpenClaw |
+| 網站前後台 | 5 | Hermes / OpenClaw |
+| 學習與協作 | 4 | OpenClaw / Hermes / NemoTron |
+
+合計：42 個 target。
+
+## 5. 主機佈建策略
+
+| 主機 | 角色 | 主 Agent | 狀態 | Telegram |
+|---|---|---|---|---|
+| 110 | DevOps / runner / monitoring | OpenClaw | active_governed | action_required |
+| 188 | AI / Web / DB / Redis / SigNoz | OpenClaw | active_governed | action_required |
+| 111 | Ollama fallback | OpenClaw | read_only_layout | failure_only |
+| 120 | K3s blocked recovery | OpenClaw | blocked_by_gate | action_required |
+| 121 | K3s peer | OpenClaw | active_governed | failure_only |
+| 112 | Kali / security evidence | Hermes | read_only_layout | no_direct_notify |
+
+120 仍維持 blocked，不安排自動修復；必須等 console / SSH / K3s evidence 回來。
+
+## 6. Telegram 策略
+
+所有 Agent 都不得直接持有 token 或直接送訊息；統一經 `apps/api/src/services/telegram_gateway.py` 與 ADR-035 的部署後 E2E 驗證鏈路。
+
+通知等級：
+
+| 類型 | 策略 |
+|---|---|
+| critical failure | 立即告警 |
+| operator action required | 立即告警 |
+| approval required | Telegram approval card |
+| success / healthy | 壓低或每日摘要 |
+| watch-only no-op | 靜默 |
+
+訊息不得包含 Secret、token、cookie、private key、原始 payload、操作對話原文或 Agent 私有推理。
+
+## 7. 主動學習與互相溝通
+
+協作路徑：
+
+1. Prometheus / Sentry / SigNoz / backup / runtime snapshot 產生事件。
+2. Hermes 先彙整只讀證據與 runbook / dependency / market context。
+3. OpenClaw 仲裁風險、HITL、Telegram action-required 與是否能進 dry-run。
+4. NemoTron 只處理 sanitized smoke / replay / model comparison。
+5. 結果回寫 AgentSession、Timeline、KM、Playbook trust 與 market scorecard。
+
+學習來源：
+
+- incident timeline
+- approval outcome
+- alert operation log
+- service health snapshot
+- backup / DR evidence
+- dependency drift snapshot
+- agent market watch
+- NemoTron smoke / replay result
+
+## 8. 優先順序
+
+| 優先級 | 任務 | 狀態 | 下一步 |
+|---|---|---|---|
+| P1-401 | 建立三 Agent 佈建布局 schema / snapshot / API | 完成 | 進入 Telegram / 協作 runtime gate |
+| P1-402 | 治理後台顯示佈建布局 | 完成 | 已顯示 target、owner、Telegram policy、批准/阻擋狀態 |
+| P1-403 | Telegram Gateway 對三 Agent lane 做 E2E smoke 包 | 待辦 | 不直接發送，先做批准包 |
+| P2-401 | AgentSession / Redis Streams 協作資料面落地 | 待辦 | 需要 migration / worker gate |
+| P2-402 | Playbook trust / KM / operator feedback loop 補強 | 待辦 | 先做只讀報表 |
+| P3-401 | NemoTron 3 Ultra source refresh + 5-record smoke | 待辦 | 需要 cost/data approval 後才能跑 |
+
+## 9. 紅線
+
+- 不把布局當成 runtime 授權。
+- 不把 AwoooP work item 當成生產批准。
+- 不把 IwoooS UI 可見當成安全授權。
+- 不讓 NemoTron 在 smoke/replay gate 前進 shadow/canary。
+- 不讓 Hermes 直接發 Telegram 或修改生產。
+- 不讓任何 Agent 顯示操作對話原文或私有推理到前端。