From 0980ae3e49a381688c4d1f3d6a71b7f346d1d572 Mon Sep 17 00:00:00 2001 From: Your Name Date: Fri, 5 Jun 2026 12:12:54 +0800 Subject: [PATCH] =?UTF-8?q?docs(governance):=20=E8=A8=98=E9=8C=84=E8=87=AA?= =?UTF-8?q?=E5=8B=95=E5=8C=96=E7=9B=A4=E9=BB=9E=E6=B1=BA=E7=AD=96=E6=91=98?= =?UTF-8?q?=E8=A6=81=E4=B8=8A=E7=B7=9A=20[skip=20ci]?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/LOGBOOK.md | 40 +++++++++++++++++++ ...026-06-04-iwooos-security-governance-p0.md | 4 +- 2 files changed, 43 insertions(+), 1 deletion(-) diff --git a/docs/LOGBOOK.md b/docs/LOGBOOK.md index e07ac56fa..2182a4bc4 100644 --- a/docs/LOGBOOK.md +++ b/docs/LOGBOOK.md @@ -1,3 +1,43 @@ +## 2026-06-05｜AI Agent 自動化盤點決策摘要正式上線 + +**背景**：接續 P1-002 Gitea workflow / runner health contract 與文字換行正式驗證，治理頁 `/zh-TW/governance?tab=automation-inventory` 已能呈現完整資料，但首屏資訊密度偏高，使用者難以快速判讀「目前狀態、拖累因素、下一步」。本段只優化既有資訊呈現，不移除原明細、不新增 API、不改 workflow / runner / secret / runtime 行為。 + +**本輪完成**： +- 新增「決策指揮摘要」首屏看板：把自動化推進、決策支援、Runner 缺口與批准邊界整理成四張摘要卡。 +- 新增「決策支援覆蓋率」多因子拆解：由任務完成度、只讀證據覆蓋、批准邊界清楚度、執行面綁定、Runner 證明與降噪政策加權計算，不再只顯示單一低參考性百分比。 +- 新增 Gitea / Runner 缺口矩陣：顯示 Runner 證據、觸發面、通知降噪與安全邊界，讓 P1-002 的主要缺口可在讀 workflow 明細前先被理解。 +- 保留原本 backlog、asset、backup / DR、offsite escrow、runtime surface、Gitea workflow、task 與 boundary 明細區；本段是資訊層級重排，不是移除內容。 + +**正式部署**： +- Code commit：`67940d62 feat(governance): 優化自動化盤點決策摘要`。 +- Deploy marker：`44c09c3b chore(cd): deploy 67940d6 [skip ci]`。 +- Gitea code-review `#2603` 成功；CD `#2602` 成功並推回 deploy marker。 + +**正式驗證**： +- Production API readback：`/api/v1/health` 200 healthy、environment `prod`、mock_mode `false`。 +- `/api/v1/agents/automation-backlog-snapshot`：overall `78%`、done `18/23`、current `P1-002`、next `P1-003`。 +- `/api/v1/agents/gitea-workflow-runner-health`：schema `gitea_workflow_runner_health_v1`、workflow `9`、runner attestation gaps `8`。 +- Production browser smoke： + - Desktop `1440x1000`：`https://awoooi.wooo.work/zh-TW/governance?tab=automation-inventory&_v=44c09c3b-decision-ux-prod-desktop` + - Mobile `390x844`：`https://awoooi.wooo.work/zh-TW/governance?tab=automation-inventory&_v=44c09c3b-decision-ux-prod-mobile` + - 皆確認：`決策指揮摘要`、`決策支援覆蓋率`、`Runner 證明`、`P1-002`、`P1-003`、`78%` 可見；console error `0`；錯誤文字 `0`；`horizontalOverflow=0`；overflowing elements `0`。 + - Gitea 精準區塊 desktop / mobile 皆確認：`Gitea 工作流程 / Runner 健康合約`、`Runner 證據 11%`、`通知降噪 33%`、`安全邊界 0` 可見。 + - 截圖：`/tmp/awoooi-decision-ux-prod-desktop-44c09c3b.png`、`/tmp/awoooi-decision-ux-prod-mobile-44c09c3b.png`、`/tmp/awoooi-decision-ux-prod-gitea-desktop-44c09c3b.png`、`/tmp/awoooi-decision-ux-prod-gitea-mobile-44c09c3b.png`。 + +**驗證補充**： +- `python3 -m json.tool apps/web/messages/zh-TW.json` / `apps/web/messages/en.json` 通過。 +- zh-TW / en i18n key 鏡像差異 `0`。 +- `pnpm --filter @awoooi/web typecheck` 通過。 +- `NEXT_PUBLIC_API_URL=https://awoooi.wooo.work NEXT_PRIVATE_BUILD_WORKER_COUNT=1 SENTRY_SUPPRESS_GLOBAL_ERROR_HANDLER_FILE_WARNING=1 pnpm --filter @awoooi/web build` 通過；`/zh-TW/governance` First Load JS `384 kB`。 +- `git diff --check`、`source-control-owner-response-guard.py`、`security-mirror-progress-guard.py` 通過。 +- 本地 localhost production smoke 受正式 API CORS 阻擋，未作為 UI 行為判定；正式站同源 smoke 已補足。 + +**完成度更新 / 邊界**： +- AI Agent automation inventory UX / readability slice：本地 `100%`，正式站 `100%`。 +- AI Agent automation backlog：維持 P1-002 後 `78%`、done `18/23`、下一步 `P1-003`。 +- IwoooS 整體仍 `64%`；S4.9 owner response gate 仍 `0%`；active runtime gate 仍 `0`。 +- 本段不代表 workflow 修改、runner 重啟、Secret 讀取、通知發送、deploy / migration 觸發、runtime execution 或 owner response accepted。 + ## 2026-06-05｜S4.9 Security Acceptance Record Template **背景**：接續 S4.9 reviewer validation checklist，本段把 `ready_for_security_acceptance_record` 的下一步拆成可填的 security acceptance record 模板。P1-002 Gitea workflow / runner health contract 已由平行 AwoooP Session 補正式驗證紀錄，最新基準為 `70c01003 docs(governance): 記錄 P1-002 正式驗證 [skip ci]`；本視窗只做 docs-only 規範，不送 request、不收 owner response、不標記 reviewer validation passed、不改 Gitea / GitHub / refs / workflow / secret / runner / host / runtime。 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 b30a48ee9..b6414ba88 100644 --- a/docs/workplans/2026-06-04-iwooos-security-governance-p0.md +++ b/docs/workplans/2026-06-04-iwooos-security-governance-p0.md @@ -9,7 +9,7 @@ | 工作視窗 | IwoooS / AWOOOI 資安治理 P0 | | 本次乾淨 worktree | `/private/tmp/awoooi-p1-106-offsite-escrow-readiness-20260605` | | 本次分支 | `codex/p1-305-velero-minio-freshness` | -| 最新觀察到的 `gitea/main` | `70c01003 docs(governance): 記錄 P1-002 正式驗證 [skip ci]` | +| 最新觀察到的 `gitea/main` | `44c09c3b chore(cd): deploy 67940d6 [skip ci]` | | 最新 P2-D0 繁中文案基準 | code `cd2275a2`、deploy marker `1920bd08`、code-review `2565`、CD `2564` | | 最新 P2-D1 本地掃描基準 | `VISIBLE_LITERAL_TARGET_SCAN_OK files=221`；全站 TS / TSX 中文 literal 盤點 `35` 檔 / `752` 行；註解語氣 backlog `32` 筆 | | 最新 P2-D1 正式部署基準 | code `f9bf8a28`、deploy marker `879b0a36`、CD `2578`、code-review `2579` | @@ -20,6 +20,7 @@ | 最新 AI Agent automation P1-305 / P1-306 基準 | code `4f0787f8`、deploy marker `af3a9d48`、CD `2592`、code-review `2593`；任務批准邊界與進度彙總已正式驗證；backlog `70%`、done `16/23`、下一步 `P1-001` | | 最新 AI Agent automation P1-001 基準 | code `de3007b7`、stability fix `fd33591c`、deploy marker `8caba233`、LOGBOOK / marker 對齊 `37c0e171`；runtime surface `22`、Secret surface `4`、live gaps `6`、backlog `74%`、done `17/23`、下一步 `P1-002` | | 最新 AI Agent automation P1-002 基準 | code `943faaee`、stability fix `ff266926`、deploy marker `01b8712d`、LOGBOOK / marker 對齊 `70c01003`；Gitea workflows `9`、runner contracts `4`、需 runner attestation workflows `8`、backlog `78%`、done `18/23`、下一步 `P1-003` | +| 最新 AI Agent automation inventory UX 基準 | code `67940d62`、deploy marker `44c09c3b`；治理頁新增決策指揮摘要、決策支援覆蓋率六因子拆解、Gitea / Runner 缺口矩陣；正式站 desktop / mobile 驗證通過，backlog 仍 `78%`、done `18/23`、下一步 `P1-003` | | 最新 S4.9 canonical owner response envelope 基準 | `docs/security/S4-9-CANONICAL-OWNER-RESPONSE-ENVELOPE.md`；六欄信封、欄位 alias、五題投影、quarantine-first 與 reviewer checklist 已固定；owner response gate 仍 `0%` | | 最新 S4.9 owner response intake form 基準 | `docs/security/S4-9-OWNER-RESPONSE-INTAKE-FORM.md`；五題可填表、六欄填寫規則、reviewer 收件欄與 outcome lanes 已固定；owner response gate 仍 `0%` | | 最新 S4.9 reviewer validation checklist 基準 | `docs/security/S4-9-REVIEWER-VALIDATION-CHECKLIST.md`；Reviewer 分工、V0-V8 gates、outcome 決策表、count transition 與 cross-packet consistency 已固定；owner response gate 仍 `0%` | @@ -45,6 +46,7 @@ | IwoooS P2 首屏 UX / 資安圖表 | 本地階段 `100%`；正式站 `100%`；本輪前端發佈 `100%` | 否 | 首屏已精簡成摘要、資安網圖、拓樸圖譜、決策閘門與矩陣；S4.9 與長證據改為展開式。這只完成 P2 視覺 / 資訊架構 slice，不調高 IwoooS 整體 64% | | 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 | ## 2. P0 工作拆解與優先順序