feat(telegram): expose alert learning writeback refs

docs/LOGBOOK.md

@@ -1,3 +1,19 @@
+## 2026-07-02 — 19:58 CIR-P0-TG-001 AI alert card learning writeback refs
+
+**完成內容**：
+- `/api/v1/platform/runs/ai-alert-cards` 的 response model 已補 `learning_writeback_ready`、`learning_writeback_status` 與 `learning_writeback_refs`，每筆 AI alert card delivery receipt 會投影 deterministic KM entry、PlayBook candidate、RAG chunk、MCP evidence 與 post-verifier refs。
+- summary 已補 `learning_writeback_ready_total`、`learning_writeback_missing_total`、KM / PlayBook / RAG / MCP / verifier ready totals 與 `learning_writeback_next_action`，讓 Telegram 告警不只停在通知送達，而是可被 AI Loop Agent 當學習與後續自動化依據。
+- `telegram_alert_ai_automation_matrix` source contract 已要求 `learning_writeback_refs` / `learning_writeback_ready_total`；本地 matrix 讀回 direct gap `0`、learning refs count `1`，下一個 P0 action 推進為 `promote_telegram_alert_learning_refs_to_km_rag_mcp_registry`。
+- `awoooi-priority-work-order-readback` 與 commander inserted requirements ledger 已同步：`CIR-P0-TG-001` 不再停在 bind delivery receipt，下一步改為 KM / PlayBook / RAG / MCP registry readback。
+
+**驗證**：
+- `DATABASE_URL=postgresql+asyncpg://test:test@localhost/test PYTHONPATH=apps/api python3.11 -m pytest apps/api/tests/test_telegram_alert_ai_automation_matrix_api.py apps/api/tests/test_ai_agent_report_truth_actionability_review.py apps/api/tests/test_ai_agent_report_truth_actionability_review_api.py apps/api/tests/test_awoooi_priority_work_order_readback_api.py apps/api/tests/test_awooop_operator_timeline_labels.py -q -p no:cacheprovider`：`96 passed`。
+- `DATABASE_URL=postgresql+asyncpg://test:test@localhost/test PYTHONPATH=apps/api python3.11 -m pytest ops/runner/test_cd_controlled_runtime_profile.py -q -p no:cacheprovider`：`45 passed`。
+- `python3.11 -m py_compile apps/api/src/api/v1/platform/operator_runs.py apps/api/src/services/platform_operator_service.py apps/api/src/services/telegram_alert_ai_automation_matrix.py`、`git diff --check`：通過。
+
+**仍維持**：
+- 未送 Telegram、未呼叫 Bot API、未讀 secret / token / `.env` / raw sessions / SQLite / auth；未寫 production DB、未改 receiver route、未 workflow_dispatch、未重啟主機 / VM / Docker / Nginx / K3s / DB / firewall。
+
 ## 2026-07-02 — 19:23 CIR-P0-TG-001 ops direct Telegram sender 收斂完成
 
 **完成內容**：

docs/workplans/2026-07-02-commander-inserted-requirements-priority-ledger.md

@@ -88,7 +88,7 @@
 | 2 | CIR-P0-AILOOP-002 | P0 | 「所有 AI 自動化完整流程、節點必須完整且詳盡紀錄」 | 每次 AI 自動化事件記錄 trace_id、run_id、work_item_id、節點狀態、timestamp、evidence refs、verifier、rollback、KM/PlayBook trust writeback | 已升為 API/UI 可見 P0 工作項；節點 schema 待補 | 建立 AI automation node receipt schema，先套用 Telegram alert 與 P0 runtime lanes |
 | 3 | CIR-P0-LOG-001 | P0 | 「所有專案、產品、網站、服務、套件、工具的 LOG 都要收進去」 | 建立全域 LOG source registry 與 ingestion adapters，含 redaction、retention、freshness、last_success、owner lane | 已升為 API/UI 可見 P0 工作項 | 先做 metadata-only LOG source registry，不讀 secret / raw payload |
 | 4 | CIR-P0-LOG-002 | P0 | 「LOG 要貼標、分類、分群，讓 AI Agent 可以處理」 | LOG 自動貼 product/project/site/service/package/tool、severity、lane、confidence、AI route、cluster_id、fingerprint | 已升為 API/UI 可見 P0 工作項 | 定義 tag taxonomy 與 clustering readback，先覆蓋 Telegram、CPU、backup、freshness |
-| 5 | CIR-P0-TG-001 | P0 | 「所有發送到 Telegram 的監控告警是否全面清查、完整寫入 DB 或日誌、符合 AI 自動化？」 | 每個 Telegram 告警映射 DB/log receipt、AI route、controlled queue、work item、post verifier、learning writeback；direct send / manual default 列缺口 | workflow direct send 已收斂到 0；API direct gap 仍需追 | 擴充 Telegram alert inventory/readback，人工預設只允許 critical / break-glass 或歷史證據 |
+| 5 | CIR-P0-TG-001 | P0 | 「所有發送到 Telegram 的監控告警是否全面清查、完整寫入 DB 或日誌、符合 AI 自動化？」 | 每個 Telegram 告警映射 DB/log receipt、AI route、controlled queue、work item、post verifier、learning writeback；direct send / manual default 列缺口 | workflow / ops / API direct send 已收斂到 0；`/runs/ai-alert-cards` 已補 KM / PlayBook / RAG / MCP `learning_writeback_refs` read model | 接 KM / PlayBook / RAG / MCP registry readback，人工預設只允許 critical / break-glass 或歷史證據 |
 | 6 | CIR-P0-IA-001 | P0 | 「IwoooS 被移除、導航列菜單被移除，且沒有整合到相關頁面」 | 建立 IA/nav removal recovery ledger：被移除 menu/route/page 必須有保留、合併、替代目的地、redirect、權限邊界與 smoke | 已升為 API/UI 可見 P0 工作項；route/menu 盤點待補 | 盤點 navigation config、route list 與 removed-page destination，補 readback |
 | 7 | CIR-P1-AUTO-001 | P1 | 「不能偏離不代表一定要每一個工作完成，才能進行下一個」 | 建立主線並行推進規則：不離開 P0/P1 主線，但依賴允許時可同時推 API/UI、LOG、Telegram、KM/RAG/MCP/PlayBook、verifier | 已升為 API/UI 可見 P1 工作項 | 後續回報以 active lane + evidence 更新，不等待單一項完全結束 |
 | 8 | CIR-P1-UI-001 | P1 | 「UI/UX 工作項目不見；整個前端頁面一大堆文字，要主流專業產品做法」 | UI/UX 成為主線：first-viewport cockpit、cards/flow rows、少文字牆、route/nav 一致、desktop/mobile smoke | 已升為 API/UI spotlight | 先讓 AI Loop / LOG / Telegram / IA 工作項在 Work Items spotlight 可見，再排 UI smoke |