diff --git a/docs/LOGBOOK.md b/docs/LOGBOOK.md index 28a37f62..ae6061c4 100644 --- a/docs/LOGBOOK.md +++ b/docs/LOGBOOK.md @@ -1,3 +1,44 @@ +## 2026-06-03|Knowledge Base Work Items 接續狀態串接 + +**背景**:統帥追問「KM 需要更新」這類治理告警後續到底由誰處理、陳舊數據怎麼處理,以及前端是否要同步呈現已完成與正在推進的工作。上一輪已把 KM 來源、Incident、Playbook、審核缺口視覺化;本輪接續把 Knowledge Base 的陳舊治理缺口接到 AwoooP Work Items,讓操作者能直接看到 owner-review queue 的真實狀態與可處理入口。 + +**本次調整**: +- `/zh-TW/knowledge-base` 新增 `Work Items 接續狀態` 區塊,讀取 Hermes KB owner-review queue 與 burn-down endpoint。 +- 區塊顯示 `陳舊比例`、`陳舊 KM`、`待審核`、`可處理 / 阻塞`、`已完成`,並列出最高優先處理項、Incident / Playbook 關聯與 stale days / score。 +- 新增 `打開 Work Items` 深連結,若 API 回傳 dispatch id,會帶到 `/awooop/work-items?project_id=awoooi&work_item_id=...`,讓操作者從 KB 頁直接接續審核工作。 +- 主責分工明確呈現:Hermes 建立 KM 更新草稿與 owner-review queue;OpenClaw 補告警分類、Playbook 與上下文摘要;Owner 在 AwoooP Work Items 預覽後才確認寫回。 +- 前端加上 `讀取不寫入` 防護呈現;本頁只讀治理狀態,不在讀取時批量改寫 KM。 +- `apps/web/messages/zh-TW.json` / `en.json` 補齊 i18n,保持鏡像一致。 + +**本機驗證**: +- `cmp -s apps/web/messages/zh-TW.json apps/web/messages/en.json` 通過。 +- `git diff --check` 通過。 +- `pnpm --dir apps/web exec tsc --noEmit --tsBuildInfoFile /tmp/kb-work-items-20260603.tsbuildinfo` 通過。 +- `NEXT_PUBLIC_API_URL=https://awoooi.wooo.work NEXT_PRIVATE_BUILD_WORKER_COUNT=1 pnpm --filter @awoooi/web build` 通過;KB route size `56.4 kB`。 +- 本機 Browser:桌機與 390px 手機皆顯示 `Work Items 接續狀態`、主責分工、`讀取不寫入` 與 Work Items 入口;`horizontalOverflow=0`、`canScrollVertical=true`。 +- 本機因 production API CORS 對 `127.0.0.1` origin 失敗,治理數字以 loading/空狀態驗證排版;真資料改由 production 驗證收斂。 + +**正式部署**: +- Code commit:`ebc272a4 fix(web): surface knowledge work item handoff`。 +- Gitea code-review run:`3602` / run number `2496` / success。 +- Gitea CD run:`3601` / run number `2495` / tests `5074` success、build-and-deploy `5075` success、post-deploy-checks `5076` success。 +- Deploy marker:`8446a038 chore(cd): deploy ebc272a [skip ci]`。 +- K8s:`awoooi-api`、`awoooi-web`、`awoooi-worker` image 均為 `ebc272a4a8d41717dbdc8415d5afac384217d666`。 + +**正式驗證**: +- CD post-deploy:Alert Chain smoke `9/9`、監控覆蓋率 `100.0%`、SourceLink canary recorded、Playwright smoke `5 passed`。 +- Live API:`/api/v1/ai/governance/km-stale-owner-review-burndown?project_id=awoooi` 回 `stale_count=2273`、`total_count=2501`、`stale_ratio=0.909`、`threshold=0.2`、`entries_to_threshold=1773`、`pending_owner_reviews=10`、`completed_owner_reviews=1`、`writes_on_read=false`。 +- Live API:`/api/v1/ai/governance/km-stale-owner-review-completion-queue?project_id=awoooi&status_bucket=all` 回 `pending_count=10`、`ready_count=10`、`blocked_count=0`、`completed_count=1`、`writes_on_read=false`、`batch_writes_allowed=false`。 +- Production 桌機:`https://awoooi.wooo.work/zh-TW/knowledge-base?_v=ebc272a-kb-work-items-prod` 顯示 `90.9%`、`2,273`、`10`、`10 / 0`、`已完成 1`、Hermes / OpenClaw / Owner 分工與 `讀取不寫入`;`打開 Work Items` 帶 `work_item_id=c0a62d49-448b-4223-ae80-1abb6e361260`;`horizontalOverflow=0`、`canScrollVertical=true`。 +- Production 手機 390px:同樣顯示 Work Items 接續狀態、治理數字與深連結;`horizontalOverflow=0`、`canScrollVertical=true`。 + +**進度更新**: +- Knowledge Base 產品化可讀性由 `66%` 上修至 `70%`。 +- 前端設計系統 / i18n / 素材治理由 `54%` 上修至 `56%`。 +- CI/CD SourceLink / API rollout 健康維持 `100%`。 +- 首頁產品化入口維持 `80%`;AwoooP/HITL 維持 `99.2%`。 +- 完整 AI 自動化飛輪由 `66%` 小幅上修至 `67%`:本輪完成的是「KM 治理告警 → AwoooP Work Items 可追蹤接續」與 owner-review 可視化,不是新增自動修復或自動寫回能力;陳舊 KM 真正降比仍要後續處理 preview / confirm / writeback 流程。 + ## 2026-06-03|Knowledge Base 引用鏈圖與陳舊處理佇列落地 **背景**:統帥持續要求前端從文字牆改成圖、表、流程、拓樸與可快速理解的產品介面。本輪接續 Knowledge Base 品質軌道,新增「引用鏈圖」與「陳舊處理佇列」,讓操作者一眼看出 KM 來源、Incident / Playbook 覆蓋、審核缺口與下一步處理方向。