# AI Agent Host / K3s / Stateful 版本只讀盤點

> 日期：2026-06-11（台北時間）
> 狀態：P2-402F 已完成；P2-402G 已接入 governance UI；整體 AI Agent 主動營運與版本生命週期完成度 100%。
> 事實來源：`ai_agent_host_stateful_version_inventory_v1`、`ai_agent_proactive_operations_contract_v1`、MASTER §3.2.1c。

## 1. 本波完成

| 項目 | 狀態 | 說明 |
|---|---|---|
| Schema | 完成 | `docs/schemas/ai_agent_host_stateful_version_inventory_v1.schema.json` |
| Snapshot | 完成 | `docs/evaluations/ai_agent_host_stateful_version_inventory_2026-06-11.json` |
| 只讀 loader | 完成 | 強制 SSH / kubectl / upgrade / drain / reboot / restart / Telegram / transcript gate 全為 false |
| API | 完成 | `GET /api/v1/agents/agent-host-stateful-version-inventory` |
| 測試 | 完成 | loader / API / rollup / reboot / drain / stateful restart / redaction boundary |
| 主契約同步 | 完成 | `ai_agent_proactive_operations_contract_v1` 完成度 100%，current `P2-402G`，next `P2-403A` |

## 2. 盤點範圍

| 類別 | 數量 | 內容 |
|---|---:|---|
| Host | 5 | 188 AI / DB / monitoring / backup；110 DevOps / registry；112 Kali read-only；120 K3s blocked；121 K3s peer / VIP evidence |
| K3s node | 2 | 120 server、121 server；需要 skew policy、node readiness、ArgoCD sync / health 與 rollback ref |
| Stateful / ops service | 12 | PostgreSQL、Redis、MinIO、ClickHouse、SignOz、Prometheus、Alertmanager、Gitea、Harbor、Sentry、Langfuse、ArgoCD |
| Readonly probe step | 6 | endpoint map、CD banner evidence、host probe packet、K3s skew packet、stateful packet、maintenance packet |
| Maintenance required fields | 11 | owner、decision、maintenance window、affected scope、backup snapshot、rollback、smoke、communication、risk acceptance |

## 3. 仍維持 false

| Gate | 值 |
|---|---|
| SSH login | false |
| Host command execution | false |
| Kubectl command execution | false |
| Apt / kernel / K3s upgrade | false |
| Node drain / kubelet restart | false |
| Reboot | false |
| Stateful service restart / upgrade | false |
| DB migration / restore / backup delete | false |
| Image pull / package install | false |
| External version lookup / active scan | false |
| Telegram direct send / queue write | false |
| Secret plaintext / 工作視窗對話內容 | false |

## 4. Maintenance Window 批准包

任何從「只讀盤點」進到「live probe」或「變更」前，都必須補齊：

| 欄位 | 用途 |
|---|---|
| owner / decision | 明確責任人與是否接受風險 |
| maintenance_window | 維護時間窗，不可由 Agent 自行假設 |
| affected_hosts / affected_services | 爆炸半徑與服務清單 |
| backup_snapshot_ref | 變更前備份證據 |
| rollback_owner / rollback_plan | 回滾責任人與步驟 |
| smoke_plan | public / NodePort / stateful / backup / rollback readback |
| communication_plan | Telegram / AwoooP / owner 溝通草案 |
| risk_acceptance | 人工接受風險，不可由 AI 自動批准 |

## 5. 下一步

| 優先 | 任務 | 關卡 |
|---:|---|---|
| 1 | P2-403A Runtime gate planning | 需 operator approval package，不得直接開排程 / SSH / kubectl |
| 2 | Host readonly probe owner request | 需 owner approval，不得直接 SSH / kubectl |
| 3 | Stateful backup freshness packet | 需備份 evidence，不得 restore / prune |
