[Feature] 出場機會成本追蹤：賣出換了什麼？swap net positive 嗎？

[atomchung]

問題

賣掉一個部位後，cash 不會閒置——通常會換進別的標的。但目前沒有任何機制追蹤：

• 賣出後那筆 cash 去了哪？
• 換進的新標的表現比原標的好嗎？
• 如果沒換（cash 閒置），機會成本是多少？

結果就是：每次回頭看「NVDA 賣 $120 後漲到 $160」只會算「虧了 $40」，但完全不知道那 $40 換來的是什麼。這讓出場決策的好壞根本無法正確評估。

核心邏輯：swap framing

賣出的正確評估單位不是「sell」，是「swap（賣什麼 + 換什麼）」：

出場決策品質 = (換入標的表現) - (原標的繼續持有表現)

三種情境：

情境	評估方式
賣 A 換 B	B 報酬 vs A 報酬（同期間、同資金量）
賣 A 閒置 cash	機會成本 = A 繼續持有報酬（負的就是損失）
賣 A 分批換多標的	加權平均換入報酬 vs A 報酬

賣飛的 hindsight loss 只有在「換入表現 < 原標的」時才算真正的決策錯誤。

實作設計

資料來源

在進場紀錄旁標 swap_from：

{
  "ticker": "ORCL",
  "action": "buy",
  "date": "2026-06-15",
  "price": 180.0,
  "shares": 5,
  "swap_from": "NVDA",        // 賣了誰換來的
  "swap_from_exit_price": 120.50,
  "swap_from_shares": 10,
  "inferred": true             // AI 猜的，不確定才問一句
}

swap_from 可以：

• 由 AI 從時間序列推算（同週賣 A 買 B → 大概率是 swap）
• 用戶確認或修正（inference-first，不確定才問）

分析產出（進復盤卡）

出場 swap 追蹤（本週）：
  NVDA → ORCL（2026-06-15）
    賣出：$120.50 × 10 = $1,205
    換入：$180.00 × 5 = $900（+$305 cash 保留）
    NVDA 繼續持有至今：+$39.5（+32.8%）
    ORCL 同期：+$22.0（+12.2%）
    swap 淨損耗：-$17.5 / -20.6pp → 這次 swap 虧了

閒置 cash 偵測

賣出後 N 天內（預設 14 天）沒有對應 buy → 標記「cash 閒置」：

NVDA 出場（2026-06-01）→ 14 天無新買入 → 閒置機會成本：
  NVDA 同期 +18% = 閒置損耗 -$216

與 revisit cadence 的關係（#32）

30/60/90 day revisit 裡的 swap framing 就靠這個資料。#32 是「定時提醒回來看」，本 issue 是「提供正確的對比數字」。

兩者共用同一筆 swap_from 資料，revisit 時自動拉出對比報酬。

實作範圍

• engine/swap.py：從交易序列推算 swap pair（賣 A 後 N 天內的 buy = 換入候選）
• theses.jsonl schema 加 swap_from 欄位
• 復盤卡新增「出場 swap 追蹤」section（有 swap pair 才出現）
• 閒置 cash 偵測（賣出後 14 天無 buy → 標 idle_cash）
• revisit（[Feature] 30/60/90 day revisit cadence：出場後自動追蹤「賣飛了沒」 #32）整合：due 時自動拉 swap 對比報酬

關聯

• [Feature] 30/60/90 day revisit cadence：出場後自動追蹤「賣飛了沒」 #32（30/60/90 revisit cadence）：revisit 時需要 swap 數據
• [Feature] 帳本還原：從 broker CSV 建立持倉快照（本地私有，不上傳） #31（帳本層）：swap 配對需要帳本知道哪筆賣出對應哪筆買入
• investment_note record-trade Step 3d.2b「Capital Reallocation Swap Analysis」是參考實作