archive-mail-view

Archive Mail — Thread View

讀 .threads.json + per-email md 檔，聚合成單一 thread 視圖檔。用來把散在多個 md 檔裡的對話串整理成敘事性的一篇。

使用方式

/archive-mail-view "SE manuscript 10xx-2025"
/archive-mail-view "SE manuscript" communications
/archive-mail-view "SE" communications/emails

• 第一個參數：thread key（可以是 substring，會模糊匹配 .threads.json 裡的 key）
• 第二個參數（可選）：archive 目錄，預設 communication/emails

執行步驟

Step 1: 解析參數

從 $ARGUMENTS 取得：

• thread_query: 要找的 thread key（必填）
• archive_dir: archive 目錄，預設 communication/emails

若無參數，提示：

Usage: /archive-mail-view <thread-key> [archive-dir]

Try: /archive-mail-view "SE manuscript 10xx-2025"

Step 2: 載入索引（v2.8.0+ 從 .claude/.mail/state/archives/${SLUG}/）

NAMESPACE_DIR=".claude/.mail"
SLUG=$(echo "${archive_dir}" | tr '/' '-' | sed 's/^[-.]*//;s/[-.]*$//')
THREADS_FILE="${NAMESPACE_DIR}/state/archives/${SLUG}/threads.json"

# Auto-migrate from legacy(silent)
if [ ! -f "${THREADS_FILE}" ] && [ -f "${archive_dir}/.threads.json" ]; then
  mkdir -p "$(dirname "${THREADS_FILE}")"
  mv "${archive_dir}/.threads.json" "${THREADS_FILE}"
  echo "🔄 Migrated ${archive_dir}/.threads.json → ${THREADS_FILE}"
fi

[ -f "${THREADS_FILE}" ] || {
  echo "ERROR: ${THREADS_FILE} not found (also no legacy ${archive_dir}/.threads.json)."
  echo "Run /archive-mail first to create the index, or /archive-mail-rebuild-threads to regenerate from existing md files."
  exit 1
}

Step 3: 匹配 thread key

在 .threads.json 的 threads 物件中用 case-insensitive substring match 找符合的 key：

• 0 個匹配：列出前 20 個可用 thread key 給使用者參考，退出
• 1 個匹配：使用該 key
• 多個匹配：列出所有匹配的 thread key（含 message_count、last_message），讓使用者用更具體的 query 重跑

Step 4: 讀取 messages 並依時序排序

對選定的 thread entry：

1. 從 messages 陣列讀取所有 file 路徑
2. 依 date 欄位排序（asc，最早的在前）
3. 對每個 md 檔：
   • Read 該檔
   • 解析 YAML frontmatter 取得 message_id / sender / direction / date / in_reply_to
   • 提取 ## 信件內容 到下一個 --- 之間的 body（不含 thread quote 尾巴；thread quote 的辨識 pattern 同 archive-mail Step 5.5：差出人: / 寄件者: / From: / On .* wrote:）
   • 提取 ## 重點摘要（若有）
   • 提取 Attachments: 區塊（若有）