awoooi/docs/ai/AI_AGENT_PROACTIVE_OPERATIONS_2026-06-11.md

# AI Agent 主動營運委派與版本生命週期分析報告

> 日期：2026-06-11（台北時間）
> 文件定位：P2-402A / P2-402B / P2-402C / P2-402D / P2-402E / P2-402F / P2-402G / P2-403A / P2-403B / P2-403C / P2-403D / P2-403E / P2-403F / P2-403G / P2-403H / P2-403I / P2-403J 只讀契約與治理 UI 摘要。權威細節以 MASTER §3.2.1c / §3.2.1d、`ai_agent_proactive_operations_contract_v1`、`ai_agent_interaction_learning_proof_v1`、`ai_agent_live_read_model_gate_v1`、`ai_agent_redis_dry_run_gate_v1`、`ai_agent_learning_writeback_approval_package_v1`、`ai_agent_telegram_receipt_approval_package_v1`、`ai_agent_owner_approved_learning_dry_run_v1`、`ai_agent_owner_approved_fixture_dry_run_v1`、`ai_agent_runtime_write_gate_review_v1`、`ai_agent_post_write_verifier_package_v1`、`ai_agent_runtime_verifier_evidence_review_v1`、`ai_agent_report_truth_actionability_review_v1`、`ai_agent_report_automation_review_v1`、`ai_agent_version_freshness_snapshot_v1`、`ai_agent_tool_adoption_approval_package_v1`、`ai_agent_telegram_action_required_digest_policy_v1`、`ai_agent_gitea_pr_draft_lane_v1` 與 `ai_agent_host_stateful_version_inventory_v1` 為準。

## 0. P2-403J 補記：報表真相、日週月報與風險自動化

2026-06-12 已新增 `ai_agent_report_truth_actionability_review_v1` 與 `ai_agent_report_automation_review_v1`：全 0 週報不再可被解讀為健康，而是 report truth / source freshness / confidence 缺口；日報、週報、月報需共用 truth gate；Watchdog / NoAlertsReceived 等心跳需進 actionability lane；本產品正式 Telegram 告警需收斂至 **AwoooI SRE 戰情室**（`SRE_GROUP_CHAT_ID`）。同時建立每個 AI Agent 的工作量、圖表化報告、AI 分析建議與高 / 中 / 低風險自動化政策：高風險仍需統帥審核，中低風險目前只完成 policy review，尚未啟動 runtime auto worker。其他 TG Bot、舊 `TELEGRAM_ALERT_CHAT_ID`、direct Telegram API send 與多 bot token route 目前只列為待收斂風險，不代表已改 secret 或已切 route。

## 1. 本波完成度

| 範圍 | 完成度 | 狀態 |
|---|---:|---|
| 主動營運委派契約 | 100% | 已完成 schema / snapshot / API / 測試 |
| Repo-only 版本新鮮度快照 | 100% | P2-402B 已完成 schema / committed snapshot / API / 測試 |
| 工具採用批准包 | 100% | P2-402C 已完成 Renovate / OSV-Scanner / Trivy / Syft / Grype schema / committed snapshot / API / 測試 |
| Telegram action-required digest policy | 100% | P2-402D 已完成 critical / action-required / failure-only digest schema / committed snapshot / API / 測試 |
| Gitea PR 草案 lane | 100% | P2-402E 已完成 grouping、automerge=false、測試證據、rollback、owner response schema / committed snapshot / API / 測試 |
| Host / K3s / stateful 版本只讀盤點 | 100% | P2-402F 已完成 5 台主機、2 個 K3s 節點、12 個 stateful / ops 服務與 maintenance window 批准包 schema / committed snapshot / API / 測試 |
| Governance UI 可委派能力顯示 | 100% | P2-402G 已把可委派能力、版本生命週期、Host / K3s / stateful 只讀盤點、maintenance window 與 Telegram / redaction gate 接入治理頁 |
| Agent 互動與學習證據面 | 100% | P2-403A 已把目前真相、證據階梯、三 Agent lane、可觀測訊號、runtime gates 與 redaction policy 接入治理頁；live counts 全為 `0` |
| Redis dry-run gate | 100% | P2-403C 已把 consumer group dry-run、handoff envelope、ack / dead-letter / replay idempotency 與治理頁顯示接入；live counts 全為 `0` |
| Learning writeback approval package | 100% | P2-403D 已把 KM / PlayBook trust / timeline learning / replay score 的 owner review、rollback、redaction 與 blocked write actions 接入；live writes 全為 `0` |
| 整體主動營運與版本生命週期 | 100% | P2-402A~G、P2-403A、P2-403B、P2-403C、P2-403D、P2-403E、P2-403F、P2-403G、P2-403H、P2-403I 與 P2-403J 只讀契約、snapshot、API、測試與治理 UI 已完成；runtime 排程、工具安裝、CI 變更、實際 PR 建立與更新、host probe、升級、重啟、learning write、Telegram receipt、post-write verifier execution、report delivery、AI analysis runtime、中低風險 auto worker 仍未開 gate |

## 2. 可交給 AI Agent 的工作分類

| 類別 | 可交給 Agent 主動做 | 不可自動做 |
|---|---|---|
| 版本與依賴 | 版本發現、新鮮度、changelog、升級批准包 | 套件升級、lockfile 寫入、auto merge |
| AI Agent / 模型 | 市場 watch、scorecard、sanitized replay 計畫 | SDK 安裝、付費 API、shadow/canary、生產路由 |
| 主機 / K3s | version skew、maintenance window 草案 | apt upgrade、kernel / K3s 升級、reboot |
| 資安 / SBOM | SBOM / CVE / license 工具採用評估 | 安裝掃描器、外部 live scan、修補套件 |
| 監控 / 告警 | 噪音分析、Telegram 送達稽核、fallback gap | 改 receiver、route、silence、直接發 Bot |
| 備份 / DR | freshness、restore readiness、DR 批准包 | restore、prune、offsite sync |
| 成本 / 容量 | resource / provider / cost delta 建議 | 增費、改 runtime limit、切付費 provider |
| 前後台 / 文件 | UI smoke、overflow、a11y、runbook / postmortem 草稿 | 修改 UI、發布文件、寫 canonical KM |

## 3. 已定義的正式契約

| 產物 | 用途 |
|---|---|
| `docs/schemas/ai_agent_proactive_operations_contract_v1.schema.json` | 主動營運委派與版本生命週期 schema |
| `docs/evaluations/ai_agent_proactive_operations_contract_2026-06-11.json` | 12 類版本 domain、24 類可委派能力、5 種 cadence、8 類 MCP、4 類 RAG memory |
| `GET /api/v1/agents/agent-proactive-operations-contract` | 只讀 API；不啟用排程、不升級、不發 Telegram |
| `docs/schemas/ai_agent_version_freshness_snapshot_v1.schema.json` | Repo-only 版本新鮮度 schema；所有外部查詢與更新權限預設 false |
| `docs/evaluations/ai_agent_version_freshness_snapshot_2026-06-11.json` | 12 類 repo-only source、5 個 daily step、3 Agent role、5 個 action-required source |
| `GET /api/v1/agents/agent-version-freshness-snapshot` | 只讀 API；不觸發掃描、不查外部、不改 repo、不發 Telegram |
| `docs/schemas/ai_agent_tool_adoption_approval_package_v1.schema.json` | 工具採用批准包 schema；工具安裝、CI 變更、外部查詢、漏洞 DB、PR、Telegram 全部預設 false |
| `docs/evaluations/ai_agent_tool_adoption_approval_package_2026-06-11.json` | Renovate / OSV-Scanner / Trivy / Syft / Grype 官方來源、採用 lane、批准欄位、rollback plan |
| `GET /api/v1/agents/agent-tool-adoption-approval-package` | 只讀 API；不安裝工具、不改 CI、不查外部、不建 PR、不發 Telegram |
| `docs/schemas/ai_agent_telegram_action_required_digest_policy_v1.schema.json` | Telegram action-required digest policy schema；direct send、queue write、route / receiver change、workflow、transcript 全部預設 false |
| `docs/evaluations/ai_agent_telegram_action_required_digest_policy_2026-06-11.json` | 8 條 digest rule、3 個 channel 草案、5 類 trigger category、成功降噪、redaction、fallback policy |
| `GET /api/v1/agents/agent-telegram-action-required-digest-policy` | 只讀 API；不送 Telegram、不寫 queue、不改 route / receiver、不觸發 workflow |
| `docs/schemas/ai_agent_gitea_pr_draft_lane_v1.schema.json` | Gitea PR 草案 lane schema；branch push、PR creation、workflow trigger、lockfile、automerge、Telegram 全部預設 false |
| `docs/evaluations/ai_agent_gitea_pr_draft_lane_2026-06-11.json` | 6 條 grouping rule、7 個 lane step、9 個 required check、6 條 rollback requirement、4 個 draft template |
| `GET /api/v1/agents/agent-gitea-pr-draft-lane` | 只讀 API；不 push branch、不建立 PR、不觸發 workflow、不改 CI、不升級套件、不發 Telegram |
| `docs/schemas/ai_agent_host_stateful_version_inventory_v1.schema.json` | Host / K3s / stateful 版本只讀盤點 schema；SSH、kubectl、upgrade、drain、reboot、restart、Telegram 全部預設 false |
| `docs/evaluations/ai_agent_host_stateful_version_inventory_2026-06-11.json` | 5 台主機、2 個 K3s 節點、12 個 stateful / ops 服務、6 個只讀 probe 步驟、maintenance window approval package |
| `GET /api/v1/agents/agent-host-stateful-version-inventory` | 只讀 API；不 SSH、不 kubectl、不升級、不 drain、不 reboot、不重啟 stateful、不發 Telegram |
| `docs/schemas/ai_agent_interaction_learning_proof_v1.schema.json` | P2-403A Agent 互動、接手、學習、成長與 Telegram receipt 證據面 schema |
| `docs/evaluations/ai_agent_interaction_learning_proof_2026-06-11.json` | 證據階梯、live truth、三 Agent lane、可觀測訊號、runtime gates；P2-403J 後完成度 `100%`，live counts 全部 `0` |
| `GET /api/v1/agents/agent-interaction-learning-proof` | 只讀 API；不啟動 worker、不開 Redis consumer、不 DB migration、不發 Telegram、不顯示工作視窗對話 |
| `docs/schemas/ai_agent_post_write_verifier_package_v1.schema.json` | P2-403H post-write verifier package schema；canonical readback、rollback work item、Telegram failure receipt 與 live verifier execution 全部 false |
| `GET /api/v1/agents/agent-post-write-verifier-package` | 只讀 API；只回傳 verifier package、failure lane 與人工操作選項，不讀 canonical target、不寫 rollback、不發 Telegram |
| `docs/schemas/ai_agent_runtime_verifier_evidence_review_v1.schema.json` | P2-403I runtime verifier evidence review schema；runtime verifier implementation、canonical readback、rollback work item、Telegram failure receipt 與 live verifier execution 全部 false |
| `GET /api/v1/agents/agent-runtime-verifier-evidence-review` | 只讀 API；只回傳 evidence checks、implementation lanes 與人工操作選項，不實作或執行 verifier |
| `docs/schemas/ai_agent_report_truth_actionability_review_v1.schema.json` | P2-403J 報表真相與告警有效性審查 schema；全 0 週報、日週月 truth gate、Telegram route 收斂與 operator actions |
| `GET /api/v1/agents/agent-report-truth-actionability-review` | 只讀 API；不發 Telegram、不改 CronJob / Alertmanager / route、不讀 secret、不寫 work item |
| `docs/schemas/ai_agent_report_automation_review_v1.schema.json` | P2-403J 日週月報、每個 Agent 工作量、圖表化報告、AI 分析建議與高 / 中 / 低風險自動化 policy review schema |
| `GET /api/v1/agents/agent-report-automation-review` | 只讀 API；不排程實發、不送 Telegram、不啟動中低風險 auto worker、不執行生產優化 |
| `docs/schemas/ai_agent_live_read_model_gate_v1.schema.json` | P2-403B AgentSession / Redis Streams live read model gate schema |
| `docs/evaluations/ai_agent_live_read_model_gate_2026-06-11.json` | AgentSession safe fields、Redis envelope、worker gate、rollback plan、no-write smoke、frontend redaction；live counts 全部 `0` |
| `GET /api/v1/agents/agent-live-read-model-gate` | 只讀 API；不連 DB、不讀寫 Redis、不啟動 worker、不發 Telegram |

## 4. P2-402B Repo-only 版本新鮮度快照

| Source | 主責 | 狀態 | 下一步 |
|---|---|---|---|
| JavaScript workspace manifests | Hermes | action_required | P2-402C 前只比較 repo specifier / lockfile，不查 npm registry |
| Python package manifests | Hermes | action_required | 只讀比較 pyproject / requirements，不 pip / uv install |
| Dockerfiles | Hermes | action_required | P2-402C 評估 Trivy / Syft / Grype / Docker Scout 採用，不 build / pull |
| Committed evaluation snapshots | Hermes | action_required | 將 2026-06-04~06-05 舊基線列入 stale refs，不假裝是外部最新 |
| Agent / model governance snapshots | NemoTron | action_required | 只做離線 freshness note，不進 shadow / canary / production route |
| K8s / Gitea / observability / Ansible / backup / web surfaces | OpenClaw + Hermes | baseline_ready / planned_next | P2-403K 已進 SRE 戰情室路由收斂；下一步接 P2-403L 報表 runtime 啟動前閘門與 P2-403M no-write dry-run；現階段仍只讀 |

本波只把「每天要看哪些 repo 內版本來源」定義成可驗證資料面。每日排程、外部 registry 查詢、主機/K3s live probe、Telegram digest 與 Gitea PR lane 都仍是下一階段 gate。

## 5. P2-402C 工具採用批准包

| 工具 | 主責 Agent | 建議角色 | 目前狀態 |
|---|---|---|---|
| Renovate for Gitea | Hermes | 依賴更新 PR 草案、grouping、automerge=false | 只建立批准包；bot token、workflow、PR 全部未啟用 |
| OSV-Scanner | OpenClaw | 依賴漏洞 advisory lookup 候選 | 只建立批准包；外部查詢與 DB lookup 未啟用 |
| Trivy | OpenClaw | Container / filesystem / IaC / SBOM scanner 候選 | 只建立批准包；不安裝、不下載 DB、不掃 image |
| Syft | Hermes | SBOM 產生候選 | 只建立批准包；不產 SBOM artifact、不上傳 artifact |
| Grype | OpenClaw | Syft SBOM / image vulnerability cross-check 候選 | 只建立批准包；不安裝、不下載 DB、不送 Telegram |

P2-402C 的重點是把「哪些工具可被採用、採用前要填哪些批准欄位、風險與 rollback 如何定義」固定成資料契約。它不是工具導入本身；工具安裝、CI workflow、外部 registry / vulnerability DB、Gitea PR、Telegram 實發都維持 blocked。

## 6. P2-402D Telegram Action-Required Digest Policy

| 類別 | 決策 | Telegram 邊界 |
|---|---|---|
| 成功 / 已驗證 / 快照完成 | `suppress_success_noise` | 不即時送 Telegram，只進每日 KM / LOGBOOK 摘要草案 |
| 版本來源失敗 / Telegram silence / critical CVE 或 EOL | `draft_failure_escalation_digest` | 只產 failure escalation digest 草案；需 OpenClaw review，不能直發 |
| 工具安裝 / CI 變更 / scanner disagreement / no executable repair candidate | `draft_action_required_digest` | 只產 action-required digest 草案；未批准不得寫 Gateway queue |

本波把「哪些事情值得通知」和「哪些成功訊息必須壓掉」固定成資料契約。Telegram Gateway queue write、direct send、route / receiver change、AwoooP event write、workflow trigger、runtime execution 仍全部為 false。

## 7. P2-402E Gitea PR 草案 Lane

| 類別 | 本波定義 | 仍禁止 |
|---|---|---|
| Grouping | 6 條：低風險依賴、CVE / OSV、container image、AI Agent contract、host / K3s / stateful、docs / KM | 不混入無關風險，不把 critical 變更和低風險 patch 同 PR |
| PR policy | `automerge=false`、draft-only、需 OpenClaw review、需 rollback | 不 push branch、不建立 / 更新 PR、不留言、不 merge |
| Tests | schema / JSON、targeted tests、secret / transcript redaction、vulnerability / image / replay / deployment evidence | 不觸發 workflow、不改 CI、不 build / pull image |
| Owner response | owner、decision、business impact、risk acceptance、rollback acceptance、maintenance window、evidence ref | 不用 Agent 自我批准取代 owner response |
| Redaction | 不顯示 secret、提示詞、推理鏈、瀏覽器上下文、工作視窗對話內容 | 不把工作視窗對話放到前端或文件 |

P2-402E 的重點是先把「PR 草案要長什麼樣、要有哪些證據、誰要回覆、怎麼 rollback」固定成契約。它不是 Gitea bot 啟用；bot account、branch policy、實際 PR creation、workflow trigger、lockfile write、package upgrade、Telegram 實發全部維持 blocked。

## 8. P2-402F Host / K3s / Stateful 版本只讀盤點

| 類別 | 本波定義 | 仍禁止 |
|---|---|---|
| Host inventory | 5 台主機：188 AI / DB / monitoring / backup、110 DevOps / registry、112 Kali read-only、120 K3s blocked、121 K3s peer / VIP evidence | 不 SSH、不跑 host command、不 apt upgrade、不 reboot |
| K3s inventory | 2 個 K3s server 節點與 VIP API endpoint；要求 version skew policy、node readiness、ArgoCD sync / health、rollback ref | 不 kubectl、不 K3s upgrade、不 node drain、不 kubelet restart |
| Stateful services | 12 個服務：PostgreSQL、Redis、MinIO、ClickHouse、SignOz、Prometheus、Alertmanager、Gitea、Harbor、Sentry、Langfuse、ArgoCD | 不 restart、不 upgrade、不 migration、不 restore、不刪 backup |
| Readonly probe packet | 6 個 planned-only step：repo endpoint map、CD banner evidence、host probe packet、K3s skew packet、stateful packet、maintenance window packet | 不把 planned probe 當已執行，不開 runtime gate |
| Maintenance window | owner、decision、maintenance window、affected scope、backup snapshot、rollback owner、smoke plan、communication plan、risk acceptance | 不用 Agent 自我批准取代 owner gate |

P2-402F 的重點是把「要盤哪些主機與 stateful 服務、盤點前要誰批准、升級前要哪些備份與 rollback 證據」固定成資料契約。它不是主機探測或升級；SSH、kubectl、apt upgrade、K3s upgrade、node drain、reboot、stateful restart、Telegram 實發全部維持 blocked。

## 9. P2-402G Governance UI 顯示可委派能力

| 類別 | 本波定義 | 仍禁止 |
|---|---|---|
| 可委派能力 | 顯示 24 類 capability、主責 Agent、風險、自主層級、批准 gate、Telegram policy | 不提供批准、執行、安裝、更新或發送按鈕 |
| 版本生命週期 | 顯示 12 類 domain、owner、cadence、允許 autonomy、approval gate | 不查外部 registry、不改 workflow、不建立 PR |
| Host / K3s / stateful | 顯示 5 台主機、2 個 K3s node、12 個 stateful / ops 服務、6 個只讀 probe、11 個 maintenance 欄位 | 不顯示敏感端點、不 SSH、不 kubectl、不重啟、不升級 |
| Telegram / redaction | 顯示 direct send / gateway queue / frontend redaction gate 都維持 locked | 不發 Telegram、不寫 queue、不顯示工作視窗對話內容 |

P2-402G 的重點是把前面六個資料契約接回治理頁，讓統帥可以用一個 UI 看到「哪些事情可委派、誰負責、目前只能做到哪一層、下一個 gate 是什麼」。它仍然是 read-only evidence surface，不是 runtime agent loop。

## 10. 下一步優先順序

| ID | 優先 | 任務 | 關卡 |
|---|---|---|---|
| P2-402D | 0 | Telegram action-required digest policy | 已完成，只讀；Telegram send / queue write 未啟用 |
| P2-402E | 1 | Gitea PR 草案 lane | 已完成，只讀；branch push / PR creation / workflow trigger 未啟用 |
| P2-402F | 2 | host OS / K3s / stateful services 版本只讀盤點 | 已完成，只讀；SSH / kubectl / upgrade / reboot 未啟用 |
| P2-402G | 3 | governance UI 顯示可委派能力 | 已完成，只讀；不顯示敏感端點或工作對話內容 |
| P2-403A | 4 | Agent 互動、接手、學習、成長與 Telegram receipt 證據面 | 已完成，只讀；live counts 全為 `0` |
| P2-403B | 5 | live AgentSession / Redis read model：safe fields、Redis envelope、worker gate、rollback、no-write smoke | 已完成，只讀；live DB query / Redis consumer / worker 未啟用 |
| P2-403C | 6 | Redis Streams consumer group dry-run、handoff envelope、ack / dead letter / replay | 已完成，只讀；production Redis consumer / worker / ACK / replay 未啟用 |
| P2-403D | 7 | Learning writeback approval package、資料保留、錯誤補償、人工回饋回滾 | 已完成，只讀；KM / PlayBook trust / timeline learning / replay score 寫入未啟用 |
| P2-403E | 8 | Telegram receipt approval package、queue / delivery / ack / failure / retry | 已完成，只讀；Gateway queue / Bot API / delivery receipt / retry worker 未啟用 |
| P2-403F | 9 | Owner-approved learning dry-run preview、fixture dry-run、人工操作選項、驗證與 rollback | 已完成，只讀；owner approval / dry-run preview generation / KM / PlayBook trust / timeline / replay score write / Gateway queue / Telegram send 未啟用 |
| P2-403G | 10 | Runtime write gate review、雙重批准、dry-run hash、post-write verifier、redaction gate | 已完成，只讀；KM / PlayBook trust / timeline / replay score / Telegram send 未啟用，live write total `0` |
| P2-403H | 11 | Post-write verifier package、rollback lane、failure lane、人工操作選項 | 已完成，只讀；canonical readback / rollback work item / Telegram failure receipt / verifier execution 未啟用，live verifier execution `0` |

## 11. 仍維持 false 的安全邊界

- `runtime_version_update_allowed=false`
- `package_upgrade_allowed=false`
- `host_upgrade_allowed=false`
- `container_pull_allowed=false`
- `workflow_schedule_enabled=false`
- `auto_merge_allowed=false`
- `gitea_pr_creation_allowed=false`
- `telegram_direct_send_allowed=false`
- `secret_plaintext_allowed=false`
- `paid_external_service_allowed=false`
- `production_route_change_allowed=false`
- `external_registry_lookup_allowed=false`
- `daily_schedule_enabled=false`
- `gitea_pr_creation_allowed=false`
- `ssh_login_allowed=false`
- `kubectl_command_execution_allowed=false`
- `apt_upgrade_allowed=false`
- `k3s_upgrade_allowed=false`
- `node_drain_allowed=false`
- `reboot_allowed=false`
- `stateful_service_restart_allowed=false`