From 30b2f5bd6e203f6520225a9cddbfa164b89a00ed Mon Sep 17 00:00:00 2001 From: Your Name Date: Tue, 19 May 2026 09:50:34 +0800 Subject: [PATCH] docs(telegram): record t69 status chain rollout [skip ci] --- docs/LOGBOOK.md | 45 +++++++++++++++++++ ...-04-15-MASTER-ai-autonomous-flywheel-v2.md | 10 +++++ 2 files changed, 55 insertions(+) diff --git a/docs/LOGBOOK.md b/docs/LOGBOOK.md index d01141765..b5ff0dba6 100644 --- a/docs/LOGBOOK.md +++ b/docs/LOGBOOK.md @@ -1,3 +1,48 @@ +## 2026-05-19 | T69 Telegram detail/history AwoooP status-chain visibility + +**背景**：Telegram 主卡與前端已逐步接上 truth-chain / remediation evidence，但「詳情」與「歷史」仍把 timeline、ADR-100 history、MCP Gateway、automation quality 分散顯示。值班者還是需要自己拼：目前跑到哪一階段、AI 是否真正執行、自動修復是否已驗證、或是不是只讀試跑等待人工。 + +**修正**： +- `telegram_gateway.py` 新增 `_format_awooop_status_chain_lines()` 共用 helper。 + - 同源讀取 `fetch_truth_chain(...).truth_status` / `automation_quality` 與 `adr100_remediation_service.history()`。 + - 詳情與歷史 callback 都顯示同一段「AwoooP 狀態鏈」。 + - 欄位包含：階段、判定、AI 修復狀態、驗證結果、auto-repair / ops / MCP / KM evidence count、ADR-100 route、write flags、是否需人工、下一步。 +- `history` callback 不再只依賴 `frequency_snapshot` / Redis TTL；會一起讀 ADR-100 history，並在 truth-chain fetch 失敗時仍以 remediation evidence 顯示降級狀態。 +- 保留既有 `ADR-100 補救試跑`、`MCP Gateway`、`自動化品質` 區塊；T69 只是補上最上層判讀，不改 callback 執行、不改 approval、不改 incident 狀態。 + +**local verification**： +- `py_compile`：`telegram_gateway.py`、`test_telegram_message_templates.py` pass。 +- `pytest apps/api/tests/test_telegram_message_templates.py apps/api/tests/test_telegram_ai_automation_block.py apps/api/tests/test_awooop_operator_timeline_labels.py -q`：75 passed。 +- `cd apps/api && pytest tests/test_telegram_adr050.py -q`：33 passed。 +- `ruff check --select F,E9`：pass。 +- `git diff --check`：pass。 +- 未把整支 `telegram_gateway.py` 的 legacy lazy-import I001 當 gate；該檔既有多處 inline import，T69 沒做高風險大檔重排。 + +**production deployment / verification**： +- Code commit：`109f55a1 feat(telegram): surface awooop status chain`。 +- Gitea Code Review run `2392` success；CD run `2391` success。 + - jobs：`2975/tests` success、`2976/build-and-deploy` success、`2977/post-deploy-checks` success。 +- Deploy marker：`383cc6ab chore(cd): deploy 109f55a [skip ci]`。 +- Production image： + - `awoooi-api` → `192.168.0.110:5000/awoooi/api:109f55a12ba93895a16e6b9f9b3f614f6b7b15d5`。 + - `awoooi-worker` → same API image tag。 +- Health：`https://awoooi.wooo.work/api/v1/health` → `status=healthy`、`mock_mode=false`、`environment=prod`。 +- API smoke：`GET /api/v1/platform/runs/list?project_id=awoooi&page=1&per_page=1` → HTTP 200，`total=5785`。 + +**邊界 / 下一步**： +- T69 是 Telegram detail/history 的可見性與判讀收斂，不新增自動修復執行權限，也不把 write flags 自動視為已修復。 +- 真正能宣稱 AI 自動修復完成仍需要 `auto_repair_executions` / `automation_operation_log` + verification result + incident closure / KM evidence 同時成立。 +- 下一步可把同一段 AwoooP 狀態鏈回填到前端 Run Detail / Callback Replies 列表，讓 Telegram 回覆與 Operator Console 逐字同源。 + +**目前整體進度**： +- AwoooP observability / truth-chain 可回看：約 99.6%。 +- 來源告警入庫、重複發生、Sentry / SignOz 與修復結果可見性：約 99.5%。 +- Telegram callback detail/history 可追溯：約 98.0%。 +- AI 自動修復閉環：約 97.9%；T69 補可見性，不新增全自動執行能力。 +- Config Drift 治理：約 99.6%。 +- 前端 AI 自動化管理介面產品化：約 98.9%。 +- 完整 AI 自動化管理產品化：約 98.1%。 + ## 2026-05-19 | T68 Config Drift remediation record + frontend verified state **背景**：T67 已把 live env drift 回到 Git/ConfigMap truth，production drift scan 也連續 `no-drift`。但那次修復證據只存在 LOGBOOK / shell history；Operator 從 Telegram 或前端仍無法直接看出「舊 drift 怎麼處理、是否已驗證、驗證 report 是哪一筆」。 diff --git a/docs/superpowers/specs/2026-04-15-MASTER-ai-autonomous-flywheel-v2.md b/docs/superpowers/specs/2026-04-15-MASTER-ai-autonomous-flywheel-v2.md index 05d71d029..fe6746cf9 100644 --- a/docs/superpowers/specs/2026-04-15-MASTER-ai-autonomous-flywheel-v2.md +++ b/docs/superpowers/specs/2026-04-15-MASTER-ai-autonomous-flywheel-v2.md @@ -2262,6 +2262,16 @@ Phase 6 完成後 - 邊界：T68 補齊 evidence/status writeback，不宣稱 T67 是全自動修復。下一步可把同樣 record-only remediation pattern 推廣到其他 Telegram 告警，讓 investigation / remediation / verification / human gate 都能在前端與 Telegram 回覆裡同源呈現。 - 目前進度更新：AwoooP truth-chain 可回看約 99.5%；AI 自動修復閉環約 97.8%；Config Drift 治理約 99.6%；前端 AI 自動化管理介面產品化約 98.9%；完整 AI 自動化管理產品化約 97.6%。 +**T69 Telegram detail/history AwoooP status-chain production verified（2026-05-19 台北）**： +- 觸發：Telegram 詳情 / 歷史仍把 timeline、ADR-100 history、MCP Gateway、automation quality 分散顯示；Operator 要自己判斷「現在階段、AI 是否真的執行、是否已驗證、是否只讀試跑待人工」。 +- 修正：`telegram_gateway.py` 新增 `_format_awooop_status_chain_lines()`，詳情與歷史 callback 同源輸出「AwoooP 狀態鏈」：`DB Truth-chain` + `ADR-100 history`、current stage、verdict、AI 修復狀態、verification、auto-repair / ops / MCP / KM evidence count、ADR-100 route、write flags、human gate、next step。 +- 降級：history callback 會先讀 ADR-100 history；truth-chain fetch 失敗時仍用 remediation evidence 顯示降級狀態，不再只剩 Redis TTL / old frequency snapshot。 +- Verification：local `py_compile`、Telegram template / automation block / operator timeline tests `75 passed`、`cd apps/api && pytest tests/test_telegram_adr050.py -q` `33 passed`、ruff `F/E9`、`git diff --check` pass。 +- Production deploy：`109f55a1 feat(telegram): surface awooop status chain` 已推 Gitea main；Code Review run `2392` success；CD run `2391` jobs `2975/tests`、`2976/build-and-deploy`、`2977/post-deploy-checks` 全 success；deploy marker `383cc6ab chore(cd): deploy 109f55a [skip ci]`。 +- Production smoke：API / worker rollout success，running image `192.168.0.110:5000/awoooi/api:109f55a12ba93895a16e6b9f9b3f614f6b7b15d5`；health healthy；`/api/v1/platform/runs/list?project_id=awoooi&page=1&per_page=1` HTTP 200 / `total=5785`。 +- 邊界：T69 只收斂 Telegram detail/history 的 operator-visible truth-chain，不新增自動修復執行權限、不修改 approval / incident state。宣稱 AI 自動修復完成仍必須由 execution + verification + closure / KM evidence 共同成立。 +- 目前進度更新：AwoooP truth-chain 可回看約 99.6%；Telegram callback detail/history 可追溯約 98.0%；AI 自動修復閉環約 97.9%；完整 AI 自動化管理產品化約 98.1%。 + --- ### 2026-04-20 晚 (台北) — C1-C4 全流程串接 — Playbook 鏈路保護（commit de2d34d）