diff --git a/docs/LOGBOOK.md b/docs/LOGBOOK.md index b056b015..992a3bde 100644 --- a/docs/LOGBOOK.md +++ b/docs/LOGBOOK.md @@ -1,3 +1,80 @@ +## 2026-05-25|T166 Telegram detail/history 顯示 owner-review triage + +**背景**: + +- T165 已讓 Work Items 與 Runs 看得到 callback owner-review triage。 +- 但使用者最常先看到 Telegram 告警與詳情 / 歷史按鈕,因此 Telegram 回覆本身也必須說清楚流程階段、主責、是否可安全自動修復與卡點。 +- 本階段只修改 detail/history read-only formatter 與 summary,不新增推播頻率、不改 callback mutation、不寫 KM / incident / governance audit。 + +**完成變更**: + +- Telegram `KM Owner Review` 區塊新增 triage: + - 流程:`callback_observed_owner_review_link_missing` + - 匹配:`related_incident_id_exact_match` + - 主責:`Hermes` + - 協作:`OpenClaw / ElephantAlpha` + - 自動化:`manual_owner_review_required` + - `safe-auto=no` + - 卡點:`no_matching_completion_item` +- `_fetch_km_stale_completion_summary_for_incident` 在沒有 related owner-review item 時,會帶 `work_item.triage` 與 top-level `triage`。 +- 新增 Telegram formatter 測試,避免 detail/history 再退回只顯示泛用 queue counts。 + +**本地驗證**: + +```text +python3 -m py_compile apps/api/src/services/telegram_gateway.py apps/api/tests/test_telegram_message_templates.py +/Users/ogt/.pyenv/versions/3.11.7/bin/ruff check --select F,E9 apps/api/src/services/telegram_gateway.py apps/api/tests/test_telegram_message_templates.py +DATABASE_URL='postgresql+asyncpg://test:test@localhost:5432/test?ssl=disable' /Users/ogt/.pyenv/versions/3.11.7/bin/pytest apps/api/tests/test_telegram_message_templates.py apps/api/tests/test_awooop_operator_timeline_labels.py apps/api/tests/test_ai_governance_endpoints.py -q + -> 151 passed +git diff --check +``` + +**production deploy / smoke**: + +```text +Code commit: +eeece58c feat(telegram): show callback owner review triage + +Deploy marker: +42efb2fb chore(cd): deploy eeece58 [skip ci] + +Gitea Actions: +3038 / run_number 2088 Code Review -> success +3037 / run_number 2087 CD -> success + 4018 tests -> success + 4019 build-and-deploy -> success + 4020 post-deploy-checks -> success + +Production API regression: +GET https://awoooi.wooo.work/api/v1/platform/runs/callback-replies?project_id=awoooi&incident_id=INC-20260524-16109D&per_page=2 + -> total=2, items=2 + -> km_stale_completion_summary.status=no_related_owner_review + -> work_item.triage.flow_stage=callback_observed_owner_review_link_missing + +Telegram renderer smoke(不實際送訊): + -> KM Owner Review + -> 此事件 no_related_owner_review + -> 流程 callback_observed_owner_review_link_missing + -> 主責 Hermes / 協作 OpenClaw / ElephantAlpha + -> 自動化 manual_owner_review_required / safe-auto no + -> 卡點 no_matching_completion_item +``` + +**production health note**: + +- `GET /api/v1/health` 仍回 `status=degraded`,與前一階段相同,主要是既有 provider health 退化;本次 Telegram formatter 變更未改 provider routing、runtime mutation 或送訊頻率。 + +**目前整體進度**: + +- AwoooP 告警可觀測鏈:約 98.4%。 +- 低風險自動修復閉環:約 95%。 +- 前端 AI 自動化管理介面同步:約 94.5%。 +- Telegram detail/history 可解釋性:約 93%。 +- CI/CD 通知與部署證據鏈:約 99%。 +- 治理告警可讀性 / 可處置性:約 93%。 +- KM owner-review / completion 可治理鏈:約 81.5%。 +- 完整 AI 自動化管理產品化:約 91.4%。 + ## 2026-05-25|T165 Callback owner-review triage 可視化 **背景**: