ewoooc/docs/memory/claude_inventory_validation_20260513.md

Claude Code 盤點驗證記憶（2026-05-13）

用途：接續 V1/V2 全棧盤點整改時，先看這份，避免把已修或已過期的項目重複當成阻擋。

已驗證並修補

• rag_query_log.saved_call：已改為只有高信心 RAG 命中且跳過 LLM 時寫 true，並補測試。
• ai_calls.rag_hit：logger API 原本可寫但缺回歸測試；已補 set_rag_hit(True) 寫入測試。
• 舊 SSH_JUMP_* / SSH_TARGET_*：Python caller 已不存在；已從 config.py 與 .env.example 範例移除，執行路徑以 ELEPHANT_ALPHA_JUMP_* 為準。
• filesystem-mcp：MCP_BASE_HOSTS 與 health check 已存在；已補 ops_diagnostics 唯讀工具白名單，並測試 read_file 可通、write_file 被拒。
• mcp_calls.status：已補 ok/cache_only/timeout/rate_limited/error 細分，早退結果也會帶 status='error'。
• Telegram cat_ callback：主 OpenClaw route 不是問題；polling bot helper 的預設 cat 才是潛在漏 handler。已改預設為既有 handler trend 並補測試。
• Scheduler 觀測任務：BGE-M3 embedding consistency 不一致、host health probe、AI error spike、觀測台日報與 cleanup 例外都已接 _notify_scheduler_failure()。
• AutoHeal Telegram inline：obs_heal 已用 _CURRENT_USER_ID_CTX 記錄實際 Telegram user，webhook request 開頭會清空 stale user context。
• 匯入檔名日期 helper：routes/import_routes.py 已改用 utils.text_helpers.extract_snapshot_date_from_filename() 單一來源，並用真實日期解析拒絕 20261399 這類不可能日期。
• ROI 月報 feedback 區塊：反饋趨勢查詢失敗仍不阻擋月報，但已改為 warning + stack，避免完全靜默。
• Elephant Alpha short-circuit：log_ai_call 遙測失敗仍不阻擋省成本 return，但已改為 warning + stack。
• Claude cost throttle：成本節流檢查失敗仍維持 Claude 可用，但已改為 warning + stack，避免成本保護失效無跡可查。
• ai_call_logger caller registry：registry 匯入失敗仍不阻擋 LLM 遙測，但已改為 warning + stack。
• Observability route：promotion review RAG 相似查詢、PPT audit history 缺表、host health probe 寫入、MCP 24h summary 缺表等 fail-safe 區塊已改成 debug/warning log，不再完全靜默。
• Google Drive import：services/import_service.py 的日期 IN (...) 刪除/驗證查詢已改為 SQLAlchemy bind params，不再把 DataFrame 日期值拼進 SQL 字串。
• OpenClaw Bot：中文字型下載、趨勢同期 DB 查詢、匯入格式業績預覽解析等 best-effort 區塊已補 debug/exception/warnings，避免真正錯誤完全無跡可查。

已驗證為已修或過期

• migration / ORM：032 已入庫，033 host label、034 embedding_signature、035 business baseline、036 incidents 雙欄、037 action_plans guardrails 均已存在。
• migrations/031 權限已是 644。
• app.py 的 SYSTEM_VERSION 已從 config.py import，app 內只留版本註解。
• V2 提到的 app.py 死 import 與 scheduler.py import schedule 已不成立；app.py 仍使用 schedule.run_pending() 等呼叫。
• Cron 盲區清單多數已補 _notify_scheduler_failure()；ROI 月報已避開 09:00 改 09:05，AI smoke 已是 09:10。
• 0-byte database/momo*.db 迷惑檔已不存在；真實 SQLite 僅在 data/momo_database.db。
• .gitignore 已涵蓋 .claude/worktrees/、.tmp_*、MOMO Pro/、uploads/screenshots。
• cache_service.py 已成為 cache_manager.py 的相容 shim，_SALES_CACHE_TTL 單一來源有測試鎖住。
• aiops-core/requirements.txt 已不存在，aiops-core/README.md 已標記此目錄只保留歷史 stub，不應安裝或部署。
• V2 提到的「死依賴」不可整批刪：beautifulsoup4 用於多個 crawler、google-api-python-client 用於 Google Drive、google-generativeai 用於 Gemini paths、python-pptx 用於 PPT generator、matplotlib 用於 Telegram/圖表/PPT。
• Telegram momo:eig:<event_id> callback 已在 routes/openclaw_bot_routes.py 與 services/telegram_bot_service.py 實作並有 webhook 測試覆蓋，不是未實作缺口。
• mcp_calls.status CHECK 已接受 ok/error/timeout/rate_limited/cache_only，與 services/mcp_router.py 的細分狀態一致。
• DB migration / ORM 覆蓋已有 tests/test_migration_metadata_coverage.py 守門，Base.metadata.tables - migrations CREATE TABLE 必須為空；tests/test_ai_observability_models.py 也鎖住 v5 observability ORM stub。
• incidents 雙欄相容與 action_plans source/status guardrails 已在 migration 036/037 與 tests/test_auto_heal_safety.py 覆蓋。
• services/agent_actions.py 不是死碼：services/event_router.py 透過 SAFE_ACTIONS registry 動態執行 ADR-012 L2 actions，tests/test_agent_actions.py 與 tests/test_event_router.py 已覆蓋並通過。

不可盲動

• services/agent_actions.py 不能只看靜態 caller 清理；已確認它是 SAFE_ACTIONS 動態 dispatch 入口，未來改動必須同步更新 registry 與 EventRouter 測試。
• logo_circle.svg / logo_navbar.svg / logo_transparent.png 不能只因 runtime rg 無引用就刪；設計文件仍規劃品牌頁、登入頁、錯誤頁使用。
• 多個永遠 OFF feature flag 屬產品/上線策略決策，不應在清債時直接全部改 ON 或刪除。
• ai_calls.rag_hit 不等同 rag_query_log.saved_call：跳過 LLM 的 RAG 命中應記在 rag_query_log.saved_call；有實際 LLM 呼叫且 caller 明確用了 RAG context 時才適合標 ai_calls.rag_hit。

本輪已推 commits

• 36d0e5d 標記 RAG 命中節省 LLM 呼叫
• 20cab6e 補上 RAG hit logger 回歸測試
• 6817f64 移除舊 SSH jump 設定殘影
• 44eb369 補上 MCP filesystem 唯讀白名單
• 2068a37 修正 Telegram 分類按鈕預設 callback
• bdb74b1 告警 BGE embedding 一致性異常
• d15b221 細分 MCP 呼叫遙測狀態
• 34db2db 修正 scheduler 合成告警 trace
• 5785a58 補齊 scheduler 觀測任務失敗告警
• a335ab5 修正 AutoHeal Telegram 觸發者審計
• d7ae243 清空 Telegram webhook 使用者上下文
• ba8510e 補齊 MCP 早退狀態
• 317ff1b 共用匯入檔名日期解析
• c300e49 記錄 ROI 月報反饋區塊失敗
• f49413e 記錄 EA short-circuit 遙測失敗
• 0a75d11 記錄 Claude 成本節流檢查失敗
• 5625032 記錄 AI caller registry 匯入失敗
• 0bc6f18 更新 Claude 盤點修補記憶
• 3cb091f 記錄 Observability fail-safe 區塊失敗
• e29529f 校正 Observability 修補記憶 hash
• 4e6e9bf 綁定自動匯入日期查詢參數
• 47c59fd 更新自動匯入修補記憶
• ae79cdd 記錄依賴盤點驗證結果
• 2b1174a 移出誤入的本地變更
• adfcccf 補齊盤點修補 commit 清單
• 4256a04 記錄 Telegram 與 MCP 缺口驗證
• 5285abe 記錄 DB migration 覆蓋守門
• f9d3da5 記錄 AutoHeal DB guardrail 驗證
• 7e92850 記錄 Agent Actions 動態入口驗證