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，不再完全靜默。

已驗證為已修或過期

• 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 單一來源有測試鎖住。

不可盲動

• services/agent_actions.py 的 0 靜態 caller 不代表可刪，需先確認 LLM/agent 動態 dispatch registry。
• 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 匯入失敗
• 1757837 記錄 Observability fail-safe 區塊失敗