From 101b08946ae8304c35380a7b183d1ca850509987 Mon Sep 17 00:00:00 2001
From: Your Name <you@example.com>
Date: Mon, 25 May 2026 21:11:47 +0800
Subject: [PATCH] docs(logbook): record trace gap prefix deploy [skip ci]

---
 docs/LOGBOOK.md | 74 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 74 insertions(+)

diff --git a/docs/LOGBOOK.md b/docs/LOGBOOK.md
index ce54af3bc..245e80a20 100644
--- a/docs/LOGBOOK.md
+++ b/docs/LOGBOOK.md
@@ -21143,3 +21143,77 @@ missing trace top prefixes:
 - KM governance：約 84.6%。
 - AI Provider lane visibility：約 92.2%。
 - 完整 AI 自動化管理產品化：約 97.8%。
+
+### 2026-05-25 — T191 Trace-ref gap top prefixes（post-deploy）
+
+**部署證據**：
+
+```text
+commit: 345c6781 feat(awooop): show trace ref gap prefixes
+deploy marker: 5d22f59d chore(cd): deploy 345c678 [skip ci]
+
+kubectl rollout status:
+  deploy/awoooi-api successfully rolled out
+  deploy/awoooi-web successfully rolled out
+
+production images:
+  awoooi-api = 192.168.0.110:5000/awoooi/api:345c6781b828a61a904b2ccc910498c13ef88c25
+  awoooi-web = 192.168.0.110:5000/awoooi/web:345c6781b828a61a904b2ccc910498c13ef88c25
+```
+
+**production API smoke**：
+
+```text
+GET /api/v1/platform/runs/callback-replies?project_id=awoooi&per_page=5
+  outbound_reply_markup_missing_trace_ref_total = 417
+  outbound_reply_markup_missing_trace_ref_top_prefixes:
+    silence = 277, recent_24h_total = 22, last_sent_at = 2026-05-25T12:13:01Z
+    ai_advisory_handled = 52, recent_24h_total = 21, last_sent_at = 2026-05-25T12:07:17Z
+    approve = 50, recent_24h_total = 0, last_sent_at = 2026-05-13T04:00:04Z
+    unknown = 21, recent_24h_total = 0, last_sent_at = 2026-05-13T04:00:11Z
+    drift_view = 12, recent_24h_total = 0, last_sent_at = 2026-05-13T04:00:28Z
+  outbound_reply_markup_missing_incident_ref_total = 684
+  snapshot_status = partial
+  next_action = review_legacy_callback_snapshot_gap
+
+GET /api/v1/health
+  status = healthy
+  api/postgresql/redis/openclaw/signoz/ollama = up
+```
+
+**production frontend smoke**：
+
+```text
+/zh-TW/awooop/runs?project_id=awoooi
+  TG Callback Evidence visible
+  缺 trace top prefixes visible
+  silence 277 visible
+  ai_advisory_handled 52 visible
+  缺 incident top prefixes visible
+  缺 trace refs 417 visible
+  缺 incident refs 684 visible
+  console_errors = 0
+```
+
+**判讀**：
+
+- `missing trace ref` 與 `missing incident ref` 已分流顯示。非 Incident governance
+  卡片不會再被 incident-only 指標誤判成完全沒有來源追蹤。
+- `silence` / `ai_advisory_handled` 仍出現在 24h 缺口，是因為 deploy 前的歷史
+  callback snapshot；T190/T191 會約束 deploy 後新送出的 action cards。
+- 下一步仍是清掉 legacy callback snapshot gap，並觀察 deploy 後新訊息是否不再增加
+  `missing_trace_ref_total`。
+
+**目前整體進度（post-deploy）**：
+
+- AwoooP 告警可觀測鏈：約 99.75%。
+- 低風險自動修復閉環：約 95.8%。
+- 前端 AI 自動化管理介面同步：約 99.6%。
+- Telegram outbound / callback DB coverage 可視化：約 99.7%。
+- callback / DB replayability：約 98.7%。
+- MCP / 自建 MCP 可視化：約 95.1%。
+- Sentry / SigNoz source correlation：約 94.5%。
+- Ansible / PlayBook 可視化：約 92.6%。
+- KM governance：約 84.6%。
+- AI Provider lane visibility：約 92.2%。
+- 完整 AI 自動化管理產品化：約 97.85%。