From be585c4071c14d2cce9fcf76840f8d695ecb0832 Mon Sep 17 00:00:00 2001 From: Your Name Date: Thu, 21 May 2026 14:32:42 +0800 Subject: [PATCH] docs(awooop): record t128 approvals source flow [skip ci] --- docs/LOGBOOK.md | 60 +++++++++++++++++++ ...-04-15-MASTER-ai-autonomous-flywheel-v2.md | 6 ++ 2 files changed, 66 insertions(+) diff --git a/docs/LOGBOOK.md b/docs/LOGBOOK.md index 37e14ea01..d584596b0 100644 --- a/docs/LOGBOOK.md +++ b/docs/LOGBOOK.md @@ -1,3 +1,63 @@ +## 2026-05-21｜T128 Approvals source flow column + +**觸發**： + +- T125-T127 已把 source flow 帶到 Status Chain、Runs list、Work Items，但人工審批頁 `/awooop/approvals` 仍只能看到 AI 證據與完整 Status Chain。 +- 當 Telegram callback / approval gate 卡住時，operator 需要在 Approvals 列表層就知道來源證據停在 Provider、Evidence、Applied 或 Verified，避免進入人工閘門後又失去「AI 流程跑到哪」的脈絡。 + +**修正**： + +- `apps/web/src/app/[locale]/awooop/approvals/page.tsx` 新增 `來源流程 / Source Flow` 欄位。 +- 資料直接讀取既有 `approval.awooop_status_chain.source_refs.correlation`，不新增 API、不新增 mock data： + - `已驗證 / Verified`：`verification_status` 為 `applied_link_verified` 或 `direct_ref_verified`。 + - `已套用 / Applied`：`applied_link_total > 0`。 + - `已找到證據 / Evidence found`：`direct_ref_total > 0` 或 `candidate_total > 0`。 + - `Provider 已接收 / Provider received`：`provider_event_total > 0`。 + - `等待來源 / Waiting`：尚無 correlation。 +- 欄位顯示 `providers / direct / candidate / applied`，讓人工決策前能先看到 Sentry / SignOz / Alertmanager 來源證據是否已進入 AwoooP 狀態鏈。 + +**Verification**： + +```text +python3 -m json.tool apps/web/messages/en.json +python3 -m json.tool apps/web/messages/zh-TW.json +git diff --check + -> pass +pnpm --filter @awoooi/web typecheck + -> pass +pnpm --filter @awoooi/web exec next lint --file src/app/[locale]/awooop/approvals/page.tsx + -> exit 0, existing literal-string warnings remain in approvals/page.tsx +NEXT_PUBLIC_API_URL=https://awoooi.wooo.work pnpm --filter @awoooi/web build + -> compiled successfully + -> generated static pages 90/90 +Gitea / CD: + -> 140c9cda feat(awooop): show source flow in approvals + -> Code Review #2762 success + -> CD #2761 tests / build-and-deploy / post-deploy-checks success + -> deploy marker 992bb05e chore(cd): deploy 140c9cd [skip ci] +Production readback: + -> awoooi-web image = 192.168.0.110:5000/awoooi/web:140c9cdaef6c82957cb9a4195dfe0b0a41b8e446 + -> awoooi-web ready = 2/2 + -> /api/v1/platform/approvals returned {"items":[],"total":0} + -> /zh-TW/awooop/approvals loaded with Approvals empty queue + -> screenshot: /tmp/awooop-t128-production-approvals-empty.png +``` + +**判讀**： + +- T128 把 source flow 從「看 Run / Work Item 才知道」推進到「人工審批入口也能看」。 +- Production 當下沒有待審批 rows，所以無法做 live row readback；但部署 image、CD post-deploy、API total=0 與頁面空佇列一致。 +- Approvals 頁仍有既有 i18n literal-string 技術債；本次新增欄位使用既有 i18n key，未擴大硬編碼債。 + +**目前整體進度**： + +- AwoooP 告警可觀測鏈：99.998%。 +- Incident-level source correlation 可見性：98.5% → 98.6%。 +- Source correlation apply 狀態鏈可驗證性：99.72%。 +- Source correlation freshness / rolling gate：98.2%。 +- 前端 AI 自動化管理介面同步：99.996% → 99.997%。 +- 完整 AI 自動化管理產品化：99.92% → 99.93%。 + ## 2026-05-21｜T127 Work Items source flow summary **觸發**： diff --git a/docs/superpowers/specs/2026-04-15-MASTER-ai-autonomous-flywheel-v2.md b/docs/superpowers/specs/2026-04-15-MASTER-ai-autonomous-flywheel-v2.md index 4e3653e17..8aac667b9 100644 --- a/docs/superpowers/specs/2026-04-15-MASTER-ai-autonomous-flywheel-v2.md +++ b/docs/superpowers/specs/2026-04-15-MASTER-ai-autonomous-flywheel-v2.md @@ -2609,6 +2609,12 @@ Phase 6 完成後 - Verification：messages JSON parse ok；`git diff --check` pass；`pnpm --filter @awoooi/web typecheck` pass；scoped `next lint --file src/app/[locale]/awooop/work-items/page.tsx` pass；`NEXT_PUBLIC_API_URL=https://awoooi.wooo.work pnpm --filter @awoooi/web build` compiled successfully，90/90 static pages generated。Local Browser 以 same-origin local proxy + production API 顯示 `來源流程：來源證據已到` 與 refs / Sentry / SignOz / provider event id。`ebb73af1 feat(awooop): show source flow in work items` 已推 Gitea main；Actions #2753 Code Review success，#2752 CD tests / build-and-deploy / post-deploy-checks success；deploy marker `39f0f765 chore(cd): deploy ebb73af [skip ci]`。Production Browser readback：`/zh-TW/awooop/work-items?project_id=awoooi&incident_id=INC-20260521-A02D7D` 顯示 `來源流程：來源證據已到`、`refs=116; Sentry=0; SignOz=0; event=alertmanager:received:alert-20260521141001:be6a1821f6336fa44b5ec33855b9f23d`，同頁也顯示 DockerContainerMemoryLimitPressure / GiteaMemoryPressure source flow。既有 dashboard SSE snapshot fetch warning 仍存在，列為前端全域技術債，不阻塞 T127。 - 目前進度更新：AwoooP 告警可觀測鏈約 99.998%；Incident-level source correlation 可見性約 98.5%；Source correlation apply 狀態鏈可驗證性約 99.72%；Source correlation freshness / rolling gate 約 98.2%；前端 AI 自動化管理介面同步約 99.996%；完整 AI 自動化管理產品化約 99.92%。 +**T128 Approvals source flow column（2026-05-21 台北）**： +- 觸發：T125-T127 已把 source flow 帶到 Status Chain、Runs list、Work Items，但人工審批入口 `/awooop/approvals` 仍缺獨立掃描欄；operator 在 manual gate 需要先知道 source evidence 停在 Provider、Evidence、Applied 或 Verified。 +- 修正：`apps/web/src/app/[locale]/awooop/approvals/page.tsx` 新增 `來源流程 / Source Flow` 欄位，直接讀取既有 `approval.awooop_status_chain.source_refs.correlation`。分類為 Verified、Applied、Evidence found、Provider received、Waiting；欄位顯示 `providers/direct/candidate/applied`。不新增 API、不新增 mock data；文案使用既有 `awooop.listEvidence.sourceFlow` i18n key；UI 使用 lucide icons。 +- Verification：messages JSON parse ok；`git diff --check` pass；`pnpm --filter @awoooi/web typecheck` pass；scoped `next lint --file src/app/[locale]/awooop/approvals/page.tsx` exit 0（approvals/page.tsx 既有 literal-string warnings 仍存在）；`NEXT_PUBLIC_API_URL=https://awoooi.wooo.work pnpm --filter @awoooi/web build` compiled successfully，90/90 static pages generated。`140c9cda feat(awooop): show source flow in approvals` 已推 Gitea main；Actions #2762 Code Review success，#2761 CD tests / build-and-deploy / post-deploy-checks success；deploy marker `992bb05e chore(cd): deploy 140c9cd [skip ci]`。Production readback：`awoooi-web` image 為 `192.168.0.110:5000/awoooi/web:140c9cdaef6c82957cb9a4195dfe0b0a41b8e446` 且 2/2 ready；`/api/v1/platform/approvals` 回 `{"items":[],"total":0}`，正式站 `/zh-TW/awooop/approvals` 正確顯示空審批佇列。因 production 當下無待審批 rows，無 live row 可讀；截圖留存 `/tmp/awooop-t128-production-approvals-empty.png`。 +- 目前進度更新：AwoooP 告警可觀測鏈約 99.998%；Incident-level source correlation 可見性約 98.6%；Source correlation apply 狀態鏈可驗證性約 99.72%；Source correlation freshness / rolling gate 約 98.2%；前端 AI 自動化管理介面同步約 99.997%；完整 AI 自動化管理產品化約 99.93%。 + --- ### 2026-04-20 晚 (台北) — C1-C4 全流程串接 — Playbook 鏈路保護（commit de2d34d）