From 17df979741745ac738a8c29127d33a470ca1afbf Mon Sep 17 00:00:00 2001 From: Your Name Date: Thu, 18 Jun 2026 17:38:09 +0800 Subject: [PATCH] =?UTF-8?q?docs(logbook):=20=E8=A8=98=E9=8C=84=20Knowledge?= =?UTF-8?q?=20Base=20=E8=87=AA=E5=8B=95=E5=8C=96=E6=8E=8C=E6=8E=A7?= =?UTF-8?q?=E5=8F=B0=E9=A9=97=E8=AD=89=20[skip=20ci]?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/LOGBOOK.md | 30 +++++++++++++++++++ ...026-06-04-iwooos-security-governance-p0.md | 3 +- 2 files changed, 32 insertions(+), 1 deletion(-) diff --git a/docs/LOGBOOK.md b/docs/LOGBOOK.md index aa889eddc..7afed9213 100644 --- a/docs/LOGBOOK.md +++ b/docs/LOGBOOK.md @@ -1,3 +1,33 @@ +## 2026-06-18｜Knowledge Base 前移 KM 自動化掌控台正式驗證 + +**背景**：統帥指出所有 KM、PlayBook、腳本、排程與自動化機制如果在頁面與告警訊息看不到，就等同沒有被完整記錄和沉澱。AwoooP Approvals / Runs / Alerts 與 Telegram 告警卡已先補上資產沉澱矩陣，但 `/zh-TW/knowledge-base` 仍容易被大量條目清單淹沒，使用者無法第一眼看出 KM 是否健康、owner review 是否排隊、哪些沉澱已完成、哪些仍卡在可操作前。 + +**完成內容**： +- `d581f455 feat(web): 前移 Knowledge Base 自動化掌控台`：把 KM 治理狀態前移到 Knowledge Base 首屏，新增 `KM 自動化掌控台`。 +- 首屏現在直接顯示 `Stale Ratio`、`Stale KM`、`Owner Review`、`已寫回` 四張決策卡，並把 `ready / blocked`、距離門檻仍需處理數、Work Items 接續入口與治理流程圖放在列表前。 +- 既有 `自動化資產沉澱總帳` 保留並接在掌控台下方，繼續顯示 `KM`、`PlayBook`、`腳本 / Ansible`、`排程 / 監控規則`、`Verifier` 五類沉澱狀態。 +- 本段只調整可視化與讀模型前置排序；不寫 KM、不提升 PlayBook trust、不批次完成 owner review、不建立 runtime action、不開 runtime gate。 + +**驗證**： +- 本地 `apps/web/messages/zh-TW.json` / `apps/web/messages/en.json` JSON parse 通過。 +- i18n mirror：`zhLeaves=12714`、`enLeaves=12714`、`enOnly=0`、`zhOnly=0`。 +- `git diff --check`、`source-control-owner-response-guard.py --root .`、`security-mirror-progress-guard.py --root .` 通過。 +- 本地 `pnpm --filter @awoooi/web typecheck` 因此 worktree 缺少 `apps/web/node_modules/typescript/bin/tsc` 未能執行；以 Gitea clean env code-review / CD 為準。 +- Gitea `code-review.yaml #3188`：成功。 +- Gitea `cd.yaml #3187`：成功；deploy marker `07066f02 chore(cd): deploy d581f45 [skip ci]`。 +- Production health：`https://awoooi.wooo.work/api/v1/health` 回 `healthy / prod / mock_mode=false`。 +- Desktop DOM：`https://awoooi.wooo.work/zh-TW/knowledge-base?_v=07066f02-kb-command-prod-desktop` 可見 `KM 自動化掌控台`、`KM 治理警戒`、`98.8%`、`1,900`、`Owner Review`、`ready 10 / blocked 0`、`已寫回`、`自動化資產沉澱總帳`、`處理 Owner Review`；`clientWidth=1434`、`scrollWidth=1434`、`horizontalOverflow=false`、console error `0`、敏感片語命中 `0`。 +- Mobile DOM：`https://awoooi.wooo.work/zh-TW/knowledge-base?_v=07066f02-kb-command-prod-mobile` 可見同一組必要文字；`clientWidth=384`、`scrollWidth=384`、`horizontalOverflow=false`、console error `0`、敏感片語命中 `0`。 +- 截圖：`/tmp/awoooi-kb-command-prod-desktop-07066f02.png`、`/tmp/awoooi-kb-command-prod-mobile-07066f02.png`。 + +**完成度同步**： +- Knowledge Base KM 自動化掌控台：本地 `100%`、正式站 desktop / mobile `100%`。 +- AwoooP / Knowledge Base / Telegram 第一輪資產沉澱可視化：Approvals / Runs / Alerts / Telegram 主卡 / Knowledge Base 已完成；Observability、Tenants 與報表 / 告警日週月 digest 仍需接同一總帳。 +- AgentOps 治理與可觀測基礎：`79% -> 80%`，只代表可視化與 decision readback 前進。 +- KM write、PlayBook trust write、腳本 / 排程套用、Verifier live execution、owner review batch complete、Telegram live send、Gateway queue write、runtime execution：仍 `0 / false`。 + +**下一步**：接續把 Observability 與 Tenants 改成同一套資產沉澱 / topology / service map，不再讓主機、專案、網站前後台、服務與工具分散在重複頁面與長文段落中。 + ## 2026-06-18｜Telegram 告警卡補上自動化資產沉澱總帳 **背景**：統帥指出 KM、PlayBook、腳本、排程與自動化機制如果在頁面、告警訊息與事件處置包看不到，就等同沒有完整記錄與沉澱。Approvals / Runs / Alerts 已補上共用資產沉澱矩陣，但正式 Telegram `ACTION REQUIRED` 卡片仍沒有把同一筆事件的 KM / PlayBook / script / schedule / verifier 前移到第一屏，值班者仍需閱讀長段狀態鏈才能推斷 AI 自動化到底留下什麼。 diff --git a/docs/workplans/2026-06-04-iwooos-security-governance-p0.md b/docs/workplans/2026-06-04-iwooos-security-governance-p0.md index e15e16901..b1afe12a8 100644 --- a/docs/workplans/2026-06-04-iwooos-security-governance-p0.md +++ b/docs/workplans/2026-06-04-iwooos-security-governance-p0.md @@ -59,7 +59,8 @@ | Frontend design system / visual grammar | 維持 `60%` | 否 | 本輪只推進 IwoooS 頁面資訊架構與圖表排序，不宣稱全站設計系統完成 | | P2 全站繁中治理 D0+D1+D2 註解語氣 / AIOps sample / Code Review 候選分類 / AwoooP Runs fallback | `53%` | 只限高風險可見 literal、盤點、註解語氣、AIOps 範例資料命名、Code Review route i18n 與 AwoooP Runs fallback readability | D0 已清 messages 高風險殘留；D1 已掃 `apps/web/src` 字串 literal 並修正高風險可見 / bundle 文案；D2 已清 `apps/web/src` 內部稱謂註解、AIOps sample/mock 命名、Code Review 可見文案搬進 `codeReview` namespace，並清理 Runs / Callback / Source Flow fallback 可見殘留。全站 hardcoded TSX 可見 literal 仍需後續分批搬遷 | | AI Agent automation inventory UX / readability | 本地 `100%`；正式站 `100%` | 否 | 治理頁已把 P1-002 後資料重排為決策指揮摘要、決策支援六因子覆蓋率與 Gitea / Runner 缺口矩陣；這是可讀性與決策支援 slice，不調高 backlog `78%`、IwoooS `64%`、S4.9 gate 或 active runtime gate | -| Telegram 監控告警 / 批准執行真相鏈 | outbound 主鏈路 `100%`；批准後執行止血 `100%`；no-action 人工處置包 D0 `100%`；MCP / PlayBook 修復候選 D5 `88%`；Approvals / Runs / Alerts / Telegram 告警卡資產沉澱矩陣 `100% / desktop 100% / 100% / formatter+deploy 100%`；治理長期項 `98%` | 是，僅限候選產生、阻擋原因、人工草案包、AwoooP 工作項可追蹤性、Work Items 詳細接手板、Approvals / Runs / Alerts / Telegram 告警卡資產沉澱欄與 coverage gap metadata | 已修復 Alertmanager tenant context、既有 approval 收斂告警 recurrence、AI 分析中重複告警 recurrence、no-action approval 誤導執行、可執行修復 execution / KM / verifier 紀錄、no-action 人工處置包、MCP evidence / PlayBook trust 候選產生、通用兜底 / 診斷型 PlayBook 阻擋理由、缺候選時的 PlayBook 草案欄位 / 下一步 / AwoooP work item 入口與詳細處置板、blocked result 的服務 coverage gap / blocking stage / required MCP evidence refs，以及 Approvals / Runs / Alerts / Telegram 告警卡的 `KM / PlayBook / 腳本 / 排程 / Verifier` 資產沉澱矩陣；完整自動修復飛輪仍需用真實告警驗證 approval -> execution -> verifier -> KM / PlayBook trust 全鏈，不調高 runtime gate | +| Knowledge Base KM 自動化掌控台 / 資產沉澱可視化 | 本地 `100%`；正式站 desktop / mobile `100%` | 是，僅限 KM governance readback、Owner Review queue、資產沉澱總帳與 Work Items 接續入口 | `/zh-TW/knowledge-base` 已把 `KM 自動化掌控台` 前移到首屏，直接顯示 stale ratio `98.8%`、stale KM `1,900`、Owner Review `10`、`ready 10 / blocked 0`、已寫回 `1`、治理流程圖與 `KM / PlayBook / 腳本 / 排程 / Verifier` 五類沉澱狀態；不寫 KM、不提升 PlayBook trust、不批次完成 owner review、不開 runtime gate | +| Telegram 監控告警 / 批准執行真相鏈 | outbound 主鏈路 `100%`；批准後執行止血 `100%`；no-action 人工處置包 D0 `100%`；MCP / PlayBook 修復候選 D5 `88%`；Approvals / Runs / Alerts / Knowledge Base / Telegram 告警卡資產沉澱矩陣 `100% / desktop 100% / 100% / 100% / formatter+deploy 100%`；治理長期項 `98%` | 是，僅限候選產生、阻擋原因、人工草案包、AwoooP 工作項可追蹤性、Work Items 詳細接手板、Approvals / Runs / Alerts / Knowledge Base / Telegram 告警卡資產沉澱欄與 coverage gap metadata | 已修復 Alertmanager tenant context、既有 approval 收斂告警 recurrence、AI 分析中重複告警 recurrence、no-action approval 誤導執行、可執行修復 execution / KM / verifier 紀錄、no-action 人工處置包、MCP evidence / PlayBook trust 候選產生、通用兜底 / 診斷型 PlayBook 阻擋理由、缺候選時的 PlayBook 草案欄位 / 下一步 / AwoooP work item 入口與詳細處置板、blocked result 的服務 coverage gap / blocking stage / required MCP evidence refs，以及 Approvals / Runs / Alerts / Knowledge Base / Telegram 告警卡的 `KM / PlayBook / 腳本 / 排程 / Verifier` 資產沉澱矩陣；完整自動修復飛輪仍需用真實告警驗證 approval -> execution -> verifier -> KM / PlayBook trust 全鏈，不調高 runtime gate | ## 2. P0 工作拆解與優先順序