From 31a49c72dec4c1df07a6c51f6ae3ce5bc69e108e Mon Sep 17 00:00:00 2001 From: Your Name Date: Wed, 20 May 2026 15:46:37 +0800 Subject: [PATCH] docs(awooop): record t109 source refs rollout [skip ci] --- docs/LOGBOOK.md | 85 +++++++++++++++++++ ...-04-15-MASTER-ai-autonomous-flywheel-v2.md | 8 ++ 2 files changed, 93 insertions(+) diff --git a/docs/LOGBOOK.md b/docs/LOGBOOK.md index 37629e07..428db8d9 100644 --- a/docs/LOGBOOK.md +++ b/docs/LOGBOOK.md @@ -1,3 +1,88 @@ +## 2026-05-20｜T109 Alerts 顯示 Source refs / Sentry / SigNoz 關聯證據 + +**觸發**： + +- T108 已讓 execution / Ansible / PlayBook 可見，但統帥先前要求告警必須能匹配 Sentry、SigNoz 等相關工作日誌。 +- truth-chain 已有 `channel.inbound_events/outbound_messages` 與 `source_envelope.source_refs`，但 `/status-chain` 沒有投影到前端；Operator 看不到這張 incident 是否真的有 inbound 保存、是否關聯 Sentry / SigNoz / Alertmanager refs。 + +**修正**： + +- `GET /api/v1/platform/status-chain` 新增 read-only `source_refs` section： + - inbound_total / outbound_total + - inbound_channels + - refs.alert_ids / sentry_issue_ids / signoz_alerts / fingerprints / incident_ids + - latest_inbound / latest_outbound 摘要 +- `IncidentCard` 新增 `來源明細`： + - Inbound / Outbound + - Alert / Sentry / SigNoz refs count + - 最新來源 provider ref +- zh-TW / en i18n 補齊 source refs 文案；`AwoooPStatusChain` TypeScript contract 同步新增 `source_refs` 欄位。 + +**邊界**： + +- 本輪仍是 read-only visibility，不改 Sentry / SigNoz ingestion，不補寫舊事件 refs，不改 Alertmanager routing。 +- 若前端顯示 `Sentry 0 / SigNoz 0`，代表此 incident 的 truth-chain 目前沒有關聯 source refs；這是 ingestion / correlation 技術債，不是前端漏顯。 + +**Local / production verification**： + +```text +python3 -m py_compile platform_operator_service.py test_awooop_operator_timeline_labels.py + -> pass +DATABASE_URL=postgresql+asyncpg://test:test@localhost/test pytest tests/test_awooop_operator_timeline_labels.py -q + -> 35 passed +ruff check platform_operator_service.py test_awooop_operator_timeline_labels.py --select F,E9,I + -> pass +node JSON parse zh-TW/en messages + -> i18n json ok +pnpm --dir apps/web exec tsc --noEmit --pretty false + -> pass +pnpm --dir apps/web exec next lint --file incident-card.tsx --file status-chain.tsx + -> exit 0 +NEXT_PUBLIC_API_URL=https://awoooi.wooo.work pnpm --dir apps/web run build + -> compiled successfully, 90/90 static pages +Local Playwright mock source refs + -> incident-source-ref-evidence=50, Sentry 1, SigNoz 1, latest signoz/signoz:abc +Production /api/v1/platform/status-chain?incident_id=INC-20260520-4D1124 + -> source_refs.inbound_total=100 + -> outbound_total=3 + -> inbound_channels=[internal] + -> alert_ids present, fingerprints present + -> sentry_issue_ids=[], signoz_alerts=[] +Production Playwright https://awoooi.wooo.work/zh-TW/alerts + -> incident-source-ref-evidence=50 + -> examples show Inbound / Outbound / Alert / Sentry / SigNoz counts + -> observed gaps: some cards Sentry 0 / SigNoz 0, some Inbound 0 / Outbound 0 + -> pageErrors=0, consoleErrors=0 + -> screenshot /tmp/awoooi-t109-source-refs-production.png +``` + +**Gitea deploy / smoke**： + +```text +Code commit: + 3aa90b8e feat(awooop): expose source refs on incidents + +Deploy marker: + 2d37149e chore(cd): deploy 3aa90b8 [skip ci] + +Gitea Actions: + 1931 Code Review -> success in 11s + 1930 CD -> success in 9m01s +``` + +**目前整體進度**： + +- 首頁資料可信度：約 99.9%。 +- Alerts 完整清單可追蹤性：約 99.97%。 +- 前端 AI 自動化管理介面同步：約 99.98%。 +- AwoooP 告警可觀測鏈：約 99.94%。 +- MCP / 自建 MCP 使用證據可見性：約 99.6%。 +- Execution / Ansible / PlayBook 證據可見性：約 99.3%。 +- Source refs / Sentry / SigNoz 關聯可見性：約 99.0%。 +- Source refs 實際覆蓋率：約 78%，因為 production 仍有 Sentry/SigNoz 0 與 Inbound 0 的事件。 +- 低風險自動修復閉環：約 95.3%。 +- 完整 AI 自動化管理產品化：約 99.4%。 + ## 2026-05-20｜T108 Alerts 顯示 Execution / Ansible / PlayBook 證據 **觸發**： 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 61cf297a..977b74c2 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 @@ -2450,6 +2450,14 @@ Phase 6 完成後 - 邊界：T108 是 execution visibility，不把 Ansible 接成 apply executor、不新增 auto-repair 權限、不改 approval / execution / rollback gate。`Ansible 已納入` 只代表 audit/candidate/check-mode evidence，不能解讀成已自動 apply。 - 目前進度更新：首頁資料可信度約 99.9%；Alerts 完整清單可追蹤性約 99.95%；前端 AI 自動化管理介面同步約 99.97%；AwoooP 告警可觀測鏈約 99.92%；MCP / 自建 MCP 使用證據可見性約 99.6%；Execution / Ansible / PlayBook 證據可見性約 99.3%；MCP Gateway enforcement 可驗證性約 96.5%；Ansible 自動執行成熟度約 82%；低風險自動修復閉環約 95.3%；完整 AI 自動化管理產品化約 99.35%。 +**T109 Alerts 顯示 Source refs / Sentry / SigNoz 關聯證據（2026-05-20 台北）**： +- 觸發：T108 已讓 execution 可見，但 Telegram / 前端仍無法一眼判斷 incident 是否有 inbound/outbound 保存、是否關聯 Alertmanager / Sentry / SigNoz source refs。 +- 修正：`GET /api/v1/platform/status-chain` 新增 read-only `source_refs` section，包含 inbound/outbound totals、inbound channels、alert_ids / sentry_issue_ids / signoz_alerts / fingerprints / incident_ids refs、latest inbound/outbound 摘要。`IncidentCard` 顯示 `來源明細：Inbound / Outbound；Alert；Sentry；SigNoz；最新`。 +- 驗證：後端 `py_compile` pass；status-chain 單測 `35 passed`；ruff `F/E9/I` pass；i18n JSON ok；web typecheck pass；targeted lint exit 0；production build 90/90 static pages。Local Playwright mock source refs 確認 50 張 card 顯示 Sentry 1 / SigNoz 1 / latest signoz ref。 +- Production / CI：`3aa90b8e feat(awooop): expose source refs on incidents` 已推 Gitea main；deploy marker `2d37149e chore(cd): deploy 3aa90b8 [skip ci]`。Actions：#1931 Code Review success 11s、#1930 CD success 9m01s。Production `status-chain?incident_id=INC-20260520-4D1124` 回 inbound_total=100、outbound_total=3、inbound_channels=[internal]、alert_ids/fingerprints present、sentry_issue_ids=[]、signoz_alerts=[]。Production Alerts Playwright 確認 `incident-source-ref-evidence=50`，範例顯示 Inbound / Outbound / Alert / Sentry / SigNoz counts，pageErrors=0 / consoleErrors=0。 +- 邊界：T109 是 source refs visibility，不改 Sentry/SigNoz ingestion、不補寫舊事件、不改 Alertmanager routing。若前端顯示 Sentry 0 / SigNoz 0 或 Inbound 0，代表 ingestion / correlation 技術債浮出水面，不是前端漏顯。 +- 目前進度更新：首頁資料可信度約 99.9%；Alerts 完整清單可追蹤性約 99.97%；前端 AI 自動化管理介面同步約 99.98%；AwoooP 告警可觀測鏈約 99.94%；MCP / 自建 MCP 使用證據可見性約 99.6%；Execution / Ansible / PlayBook 證據可見性約 99.3%；Source refs / Sentry / SigNoz 關聯可見性約 99.0%；Source refs 實際覆蓋率約 78%；低風險自動修復閉環約 95.3%；完整 AI 自動化管理產品化約 99.4%。 + --- ### 2026-04-20 晚 (台北) — C1-C4 全流程串接 — Playbook 鏈路保護（commit de2d34d）