同步四 Agent AI 自動化治理紀錄

CONSTITUTION.md

@@ -2,8 +2,8 @@
 
 > 本文件定義專案開發的核心準則與不可違反的規範
 > **建立日期**: 2026-01-12
-> **當前版本**: V10.2 (治理與安全重疊整合版)
-> **最後更新**: 2026-04-18
+> **當前版本**: V10.4 (四 AI Agent 自動化治理版)
+> **最後更新**: 2026-04-29
 
 ---
 
@@ -305,21 +305,23 @@
 
 ---
 
-## 第十三章：AI 三 Agent 自主學習架構規範（2026-04-18 加入）
+## 第十三章：AI 四 Agent 自主學習與自動化架構規範（2026-04-29 修訂）
 
-### 第 40 條：三 Agent 分工架構（絕對禁止違反）
+### 第 40 條：四 Agent 分工架構（絕對禁止違反）
 - **Hermes（採集層）**: `192.168.0.111` Ollama，負責 embedding、去重、品質分數計算。成本 = $0
 - **NemoTron（處理層）**: NVIDIA NIM Llama 3.1 8B，負責 tool calling 邏輯路由與 DB 寫入。限額 80 次/天
 - **OpenClaw / Gemini（應用層）**: 負責最終 PPT 生成、洞察報告對外輸出。成本最高，最後動用
+- **ElephantAlpha（編排層）**: 負責跨 Agent orchestration、HITL、AutoHeal bridge 與受控執行計畫，不可繞過安全入口
 - ❌ **禁止**：讓 OpenClaw 做 Hermes 層的苦力工作（高算力浪費）
 - ❌ **禁止**：讓 Hermes 直接生成對外報告（品質不足）
+- ❌ **禁止**：讓 ElephantAlpha 直接繞過 EventRouter / AutoHeal / ADR-011 執行高風險副作用
 
 ### 第 41 條：AI 學習數據雙寫（絕對禁止違反）
-- ✅ **正確**：所有 AI 產出（PPT 洞察、競品分析、對話記錄）必須**雙寫** PostgreSQL `ai_insights` + pgvector embedding
+- ✅ **正確**：所有 AI 產出（PPT 洞察、競品分析、對話記錄、Agent action、自癒紀錄）必須**雙寫** PostgreSQL `ai_insights` + pgvector embedding
 - ❌ **禁止**：只寫 DB 不寫 KM（RAG 無法語意搜尋）
 - ❌ **禁止**：只寫 KM 不寫 DB（精確 period/sku 查詢無法命中）
 - **理由**：DB 是精準命中，KM 是語意搜尋，兩者互補缺一不可（ADR-007）
-- **入口**：NemoTron `store_insight` tool call → 同步寫 DB → 異步排隊給 Hermes 做 embedding
+- **入口**：`store_insight()` 或 raw insert + `enqueue_insight_embedding()` → 同步寫 DB → 異步排隊給 Hermes 做 embedding
 
 ### 第 42 條：KM 向量庫技術選型（絕對禁止違反）
 - ✅ **唯一選擇**：pgvector（與現有 PostgreSQL `192.168.0.188` 同一 DB）
@@ -332,7 +334,7 @@
 - **維度**：1024 dim（`vector(1024)` 欄位）（ADR-003）
 
 ### 第 44 條：NemoTron 配額 Fallback 機制（強制要求）
-- ✅ **正確**：當 NIM 回傳 HTTP 429 時，立刻 fallback 至 `_hermes_rule_fallback()` rule-based 派發
+- ✅ **正確**：當 NIM 缺 API key、HTTP 429、timeout、network/HTTP error 或 0 tool call 時，立刻 fallback 至 `_hermes_rule_fallback()` rule-based 派發
 - ❌ **禁止**：配額耗盡時讓告警管線中斷
 - **標記**：降級模式告警須帶 `🟡` 前綴，讓統帥識別（ADR-004）
 
@@ -341,6 +343,14 @@
 - **decay_rate**：`0.005`（預設）；`decay_exempt=True` 用於結構性/憲法類知識
 - **理由**：確保 RAG 優先抓取最新、最適用的洞察，避免歷史偏誤（ADR-005）
 
+### 第 45.1 條：AI 自動化安全閉環（絕對禁止違反）
+- ✅ **正確**：EventRouter 是告警、降級、去重、通知 replay 與 L2 safe action 的入口
+- ✅ **正確**：AutoHeal 是自癒副作用入口，失敗時必須安全降級為 alert / log / file queue
+- ✅ **正確**：L2 safe action 必須可審計、可回放、低副作用
+- ❌ **禁止**：自動 restart / stop / recreate `momo-db` 或 `momo-postgres`
+- ❌ **禁止**：AI 分析失敗導致 Telegram 告警完全不送出
+- **依據**：ADR-012、ADR-013、ADR-018
+
 ---
 
 ## 第十四章：Codex 工作規則（2026-04-29 修訂）
@@ -374,6 +384,7 @@
 
 ### 第 49 條：本專案不以本地 Skills 作為正式治理層（強制要求）
 - ✅ **正確**：重複流程優先寫成 `docs/guides/*.md`、腳本、測試或 ADR
+- ✅ **正確**：AI 自動化重複流程以 `docs/guides/ai_automation_session_sop.md` 維護
 - ❌ **禁止**：把 `.claude/skills`、私有 agent 腳本、外部平台工作流當成本專案正式規範來源
 
 ### 第 50 條：角色派工以 AGENTS 入口為準（強制要求）