docs(governance): record km healthcheck backlog rollout [skip ci]

This commit is contained in:
Your Name
2026-05-19 21:58:36 +08:00
parent 9e9b30689f
commit 955dbce670
2 changed files with 76 additions and 9 deletions

View File

@@ -2296,11 +2296,13 @@ Phase 6 完成後
- 觸發:`knowledge_degradation` 告警已能說明 stale KM 與 Hermes / OpenClaw / ElephantAlpha ownership`run_kb_growth_healthcheck` 仍缺 DB 派工狀態與前端可見階段Operator 無法確認 AI 是否已判斷、為何跳過、是否等待 owner。
- 修正:`governance_remediation_dispatch` read model 顯示 lightweight decision context`executor_type``decision_path``workflow_stage``workflow_steps``next_action``lead_agent``support_agents``human_owner``/ai/governance/queue` 支援 `dispatch_status=all` + `event_type=knowledge_degradation`
- Dispatcher`decision_path=skip` 不再只落在 log會留下 terminal `skipped` dispatch trailskip 不等於 resolved只代表目前不能自動派遣讓 AwoooP 可顯示人工接手點。
- Intake`GovernanceAgent` 建立 `knowledge_degradation` event 時同步建立 non-executing `hermes_kb_growth_healthcheck` pending dispatch`GovernanceDispatcher` 也會對既有 unresolved `run_kb_growth_healthcheck` 事件補建 intake dispatch避免告警進 DB 但 Work Items 沒有可追蹤工作項。
- Intake`GovernanceAgent` 建立 `knowledge_degradation` event 時同步建立 non-executing `hermes_kb_growth_healthcheck` pending dispatch`GovernanceDispatcher` 也會對既有 unresolved `run_kb_growth_healthcheck` 事件補建 intake dispatch避免告警進 DB 但 Work Items 沒有可追蹤工作項。第二段 hotfix 另修正 legacy skip cooldown 與 poll starvationKM healthcheck intake 不再被舊 skip cooldown 擋住poll SQL 會排除已有 active dispatch 的事件,避免舊 backlog 卡住後續事件。
- KM workflow metadata`run_kb_growth_healthcheck` 對齊 `detected → ai_analyzed → queued_kb_healthcheck → draft_km_updates → waiting_owner_review → km_writeback_after_approval → stale_ratio_recheck`。此鏈路明確標記 `writes_km_without_approval=false`,避免 AI 自動固化錯誤知識。
- UI`/awooop/work-items` 新增 T88「KM 健康檢查派工」面板,顯示 dispatch status、stage、next action、Hermes 主責、OpenClaw / ElephantAlpha 支援與 KM owner 人工覆核。
- Production`c99be252``b85ab70c``2f68b3f4` 已推 Gitea maindeploy markers `aee0a700``271aadce``9e9b3068`CD runs `2482``2490``2494` 全 success。Production `GET /api/v1/ai/governance/queue?dispatch_status=all&event_type=knowledge_degradation&size=30``total=13``table_pending=false``executor_type=hermes_kb_growth_healthcheck``workflow_stage=queued_kb_healthcheck`Work Items Playwright smoke 顯示 KM 面板 / Hermes / backlog total / nav 均正常且無 console error。
- 邊界T88 完成派工 / skipped / owner review 可追蹤性,不代表 Hermes KB growth worker 已能自動產生 KM 草稿,也不代表 stale ratio 已下降;後續需由 worker 消費 dispatch row 並推進 executing / succeeded / failed。
- 目前進度更新:治理告警可讀性 / 可處置性約 94%AI Agent ownership 可追溯性約 92%KM healthcheck 派工可追蹤性約 72%;完整 AI 自動化管理產品化約 91.8%
- 技術債:`/api/v1/ai/governance/events` 目前仍回 `dispatch_ids=[]`,即使 queue 已有 dispatch rows下一段需把 event detail/history read model join dispatch table補齊使用者在 Telegram「詳情 / 歷史」按鈕看到的鏈路
- 目前進度更新:治理告警可讀性 / 可處置性約 95%AI Agent ownership 可追溯性約 94%KM healthcheck 派工可追蹤性約 88%;完整 AI 自動化管理產品化約 92.4%。
---