docs(telegram): record t69 status chain rollout [skip ci]

This commit is contained in:
Your Name
2026-05-19 09:50:34 +08:00
parent 383cc6ab2a
commit 30b2f5bd6e
2 changed files with 55 additions and 0 deletions

View File

@@ -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 importT69 沒做高風險大檔重排。
**production deployment / verification**
- Code commit`109f55a1 feat(telegram): surface awooop status chain`
- Gitea Code Review run `2392` successCD 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 truthproduction drift scan 也連續 `no-drift`。但那次修復證據只存在 LOGBOOK / shell historyOperator 從 Telegram 或前端仍無法直接看出「舊 drift 怎麼處理、是否已驗證、驗證 report 是哪一筆」。

View File

@@ -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 verified2026-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 historytruth-chain fetch 失敗時仍用 remediation evidence 顯示降級狀態,不再只剩 Redis TTL / old frequency snapshot。
- Verificationlocal `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 mainCode Review run `2392` successCD run `2391` jobs `2975/tests``2976/build-and-deploy``2977/post-deploy-checks` 全 successdeploy marker `383cc6ab chore(cd): deploy 109f55a [skip ci]`
- Production smokeAPI / worker rollout successrunning 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