# AI Agent Telegram Action-Required Digest Policy 工作報告

> 日期：2026-06-11（台北時間）
> 狀態：P2-402D 已完成；P2-402E / P2-402F / P2-402G 已接續完成；整體 AI Agent 主動營運與版本生命週期完成度 100%。
> 邊界：本文件與對應 API 只提供 Telegram digest policy，不送 Telegram、不寫 Telegram Gateway queue、不改 Alertmanager route / receiver、不寫 AwoooP event、不觸發 workflow、不執行 runtime、不讀取 secret、不顯示工作視窗對話內容。

## 1. 本波完成項目

| 項目 | 狀態 | 產出 |
|---|---|---|
| Telegram digest policy schema | 完成 | `docs/schemas/ai_agent_telegram_action_required_digest_policy_v1.schema.json` |
| Telegram digest policy snapshot | 完成 | `docs/evaluations/ai_agent_telegram_action_required_digest_policy_2026-06-11.json` |
| API loader | 完成 | `apps/api/src/services/ai_agent_telegram_action_required_digest_policy.py` |
| 只讀 API | 完成 | `GET /api/v1/agents/agent-telegram-action-required-digest-policy` |
| 測試 | 完成 | loader / API / direct-send boundary / success-noise suppression / rollup mismatch / transcript redaction |
| 主契約同步 | 完成 | `ai_agent_proactive_operations_contract_v1` 完成度 100%，current `P2-402G`，next `P2-403A` |

## 2. Digest 規則摘要

| 決策 | 規則數 | 用途 | 邊界 |
|---|---:|---|---|
| `suppress_success_noise` | 2 | repo-only freshness 成功、工具批准包完成等成功訊號只進每日摘要 | 不即時 Telegram、不寫 queue |
| `draft_failure_escalation_digest` | 3 | version watch source failed、critical CVE / EOL、Telegram delivery silence | 需 OpenClaw review；只產草案 |
| `draft_action_required_digest` | 3 | 工具安裝 / CI 變更需批准、scanner disagreement、approval 後沒有可執行修復候選 | 需 evidence ref、owner、approval gate |

## 3. Agent 分工

| Agent | 本波可做 | 本波不可做 |
|---|---|---|
| Hermes | 彙整 repo-only freshness、source failure、工具採用 evidence refs 與每日摘要草案 | 直接發 Telegram、寫 Gateway queue、觸發 workflow |
| OpenClaw | 仲裁 critical / action-required / failure-only digest 草案，確認 blast radius、rollback 與 approval gate | 自行批准發送、改 route / receiver、把成功訊息升級為告警 |
| NemoTron | 針對 scanner disagreement、AI Agent / model / prompt / tool-call risk 產生離線 replay note | 呼叫付費模型、新增 SDK、開 shadow / canary |

## 4. 仍維持 false 的邊界

- `telegram_direct_send_allowed=false`
- `telegram_test_message_allowed=false`
- `telegram_gateway_queue_write_allowed=false`
- `alertmanager_route_change_allowed=false`
- `telegram_receiver_change_allowed=false`
- `awooop_event_write_allowed=false`
- `workflow_trigger_allowed=false`
- `external_scan_allowed=false`
- `runtime_execution_allowed=false`
- `secret_plaintext_allowed=false`
- `conversation_transcript_allowed=false`

## 5. 下一步代辦

| 優先 | ID | 工作 | 完成標準 |
|---:|---|---|---|
| 1 | P2-402E | Gitea PR 草案 lane | 已完成：Renovate grouping、automerge=false、測試要求、rollback、owner response；bot / branch policy 仍未批准 |
| 2 | P2-402F | host OS / K3s / stateful services 版本只讀盤點 | 已完成；主機、K3s、PostgreSQL、Redis、MinIO、Harbor、Gitea 只讀版本矩陣 |
| 3 | P2-402G | Governance UI 顯示可委派能力 | 已完成；前端顯示 autonomy level、gate、owner、Telegram policy，無執行按鈕 |
| 4 | P2-403A | Runtime gate planning | queue write / send / callback / fallback path 的逐項批准與 rollout gate |
