docs(logbook): record telegram owner review triage [skip ci]

This commit is contained in:
Your Name
2026-05-25 09:12:28 +08:00
parent 42efb2fbe8
commit 862f35fee7

View File

@@ -1,3 +1,80 @@
## 2026-05-25T166 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-25T165 Callback owner-review triage 可視化
**背景**