docs(awooop): record t109 source refs rollout [skip ci]

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 證據
 
 **觸發**：

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）