PreCompact と SessionEnd で長時間セッションの決定事項を引き継ぐ

#!/usr/bin/env python3
"""PreCompact: トランスクリプトから決定事項を抽出し handoff へ退避する。
入力: stdin の JSON（session_id, transcript_path, trigger, cwd）
出力: .claude/handoff/<session_id>.md（追記）
"""
import json
import re
import sys
from pathlib import Path
 
# 「判断の根拠」を含む行だけを拾うためのマーカー。
# 対象を広げすぎると要約が肥大するので、意図的に絞り込んでいます。
MARKERS = re.compile(
    r"(決定|方針|採用しません|却下|制約|理由は|前提として"
    r"|decided|constraint|because|instead of|do not)",
    re.IGNORECASE,
)
MAX_LINES = 60          # 復元時のコンテキスト圧を抑える上限
MAX_CHARS_PER_LINE = 240
 
 
def iter_assistant_text(transcript: Path):
    """JSONL を1行ずつ読む。壊れた行はスキップする（セッション中の書き込みと競合し得るため）。"""
    with transcript.open(encoding="utf-8", errors="replace") as f:
        for raw in f:
            raw = raw.strip()
            if not raw:
                continue
            try:
                rec = json.loads(raw)
            except json.JSONDecodeError:
                continue
            if rec.get("type") != "assistant":
                continue
            content = rec.get("message", {}).get("content", [])
            if isinstance(content, str):
                yield content
                continue
            for block in content:
                if isinstance(block, dict) and block.get("type") == "text":
                    yield block.get("text", "")
 
 
def extract(transcript: Path) -> list[str]:
    seen, picked = set(), []
    for text in iter_assistant_text(transcript):
        for line in text.splitlines():
            line = line.strip(" -*#\t")
            if len(line) < 12 or not MARKERS.search(line):
                continue
            line = line[:MAX_CHARS_PER_LINE]
            if line in seen:      # 同じ決定の再掲を落とす
                continue
            seen.add(line)
            picked.append(line)
    return picked[-MAX_LINES:]   # 新しい決定を優先して残す
 
 
def main() -> int:
    payload = json.load(sys.stdin)
    transcript = Path(payload["transcript_path"])
    if not transcript.exists():
        return 0                 # 履歴が無いなら黙って成功扱い
 
    lines = extract(transcript)
    if not lines:
        return 0
 
    out_dir = Path(payload.get("cwd", ".")) / ".claude" / "handoff"
    out_dir.mkdir(parents=True, exist_ok=True)
    out = out_dir / f"{payload['session_id']}.md"
 
    with out.open("a", encoding="utf-8") as f:
        f.write(f"\n## compact ({payload.get('trigger', 'auto')})\n")
        for line in lines:
            f.write(f"- {line}\n")
 
    # stderr はユーザーにのみ表示され、モデルのコンテキストには入りません。
    print(f"[handoff] {len(lines)} decisions -> {out}", file=sys.stderr)
    return 0
 
 
if __name__ == "__main__":
    sys.exit(main())

## compact (auto)
- 決定: articles.json にはメタデータのみを載せ、本文HTMLは public/content/ 側へ分割する
- 制約: Cloudflare Workers のバンドル上限が 62 MiB のため、生成物を同梱しない
- 理由は、ビルド時に本文を含めると Worker のデプロイ自体が落ちるためです
- 採用しません: articles.json への本文インライン化（過去に一度戻して失敗しています）

{
  "hooks": {
    "PreCompact": [
      {
        "matcher": "auto",
        "hooks": [
          { "type": "command", "command": "python3 .claude/hooks/handoff_capture.py", "timeout": 30 }
        ]
      }
    ],
    "SessionEnd": [
      {
        "hooks": [
          { "type": "command", "command": "python3 .claude/hooks/handoff_capture.py", "timeout": 30 }
        ]
      }
    ],
    "SessionStart": [
      {
        "matcher": "resume",
        "hooks": [
          { "type": "command", "command": "python3 .claude/hooks/handoff_restore.py", "timeout": 10 }
        ]
      }
    ]
  }
}

#!/usr/bin/env python3
"""SessionStart: 直近の handoff を読み、additionalContext として注入する。"""
import json
import sys
from pathlib import Path
 
MAX_BYTES = 8_000   # 注入量の上限。これ以上は前提が薄まるより先に予算を食う
 
 
def main() -> int:
    payload = json.load(sys.stdin)
    hand = Path(payload.get("cwd", ".")) / ".claude" / "handoff"
    files = sorted(hand.glob("*.md"), key=lambda p: p.stat().st_mtime)
    if not files:
        return 0
 
    text = files[-1].read_text(encoding="utf-8")[-MAX_BYTES:]
 
    # stdout に出した JSON が Claude Code に解釈されます。
    print(json.dumps({
        "hookSpecificOutput": {
            "hookEventName": "SessionStart",
            "additionalContext": (
                "前セッションで確定した決定事項です。"
                "矛盾する提案をする前に、必ずここを確認してください。\n\n" + text
            ),
        }
    }))
    return 0
 
 
if __name__ == "__main__":
    sys.exit(main())