feat(claude): claude-interactive モードで対話的 Claude Code 経路に対応

[owayo]

Summary

2026-06-15 以降、Anthropic は claude -p / Agent SDK / GitHub Actions を Agent SDK 専用月次クレジット（Pro $20/月、Max 5x $100/月、Max 20x $200/月）に分離します。token-burn は「プラン使用枠を使い切る」のが目的なので、claude -p のままだと月 $20 相当しか使えなくなり目的が成立しなくなります。プラン枠を消費する 対話モード経路（claude "prompt"）への移行を実装しました。

方針: このPRはdraftのまま 2026-06-15 を待ってから main にマージします

機能

1. AgentMode enum

auto / generic / claude-print / claude-interactive、デフォルト auto。command 内容から自動判定。

2. claude-interactive モード

• claude "prompt" を tmux 実 TTY で起動
• --settings <task-settings.json> で公式 Stop / StopFailure hooks を注入
• token-burn claude-hook が outcome JSON を書き出し、token-burn classify-claude-outcome が分類
• tmux pipe-pane でログ取得、outcome 監視 watcher が C-d で claude を閉じる

3. claude-print モード（既存経路の保持）

従来の claude -p 経路を opt-in で保持（段階的移行）。

4. claude_settings: user の Claude settings を統合

公式 --settings の複数指定挙動は非明記なので、token-burn が必ず 1 個だけ渡す方針に統一。[[agents]].claude_settings に user 設定を集約し、token-burn の Stop / StopFailure hooks を prepend で deep merge して 1 ファイル化:

claude_settings = [
    { file = "~/.config/claude/plugin-settings.json" },
    { command = ["bash", "-lc", "~/bin/claude-plugin-settings.sh"] },
    { inline = { enabledPlugins = { "my-plugin@org" = true } } },
]

• 動的判定（cwd 依存等）は command source で実現
• file / command / inline ソースは valid な JSON object を返す必要あり
• hooks.Stop / hooks.StopFailure 配列は token-burn の hook が user hooks の 先頭 に prepend されるため、user hooks の decision: "block" は保持される

5. validate 強化

• claude-interactive + -p/--print/--output-format 等の print-only フラグ → reject
• claude 経路で command 内の --settings / --settings=... 直書き → reject（claude_settings に集約）
• generic モードで claude_settings 非空 → reject

あるべき姿（codex 相談済み）

設計判断は codex に 2 回相談:

1. Plan D 採用: tmux send-keys / PTY 制御 / claude resume より、公式 Stop / StopFailure hook が堅牢
2. claude_settings source enum 採用: user の wrapper script --settings $PLUGIN_SETTINGS と token-burn の --settings <path> が衝突する問題に対し、token-burn が user 設定を取り込んで 1 個に統合するのが正しい責務分担

詳細は memory/project_claude_p_migration.md 参照（auto memory）。

注意・制限事項

• claude-interactive モードでは stream-json の rate_limit_event が使えないため、settings.rate_limit_threshold による 95% 自動停止は機能しない。StopFailure(error=rate_limit) を受けたタスクのみが failed 扱いになる
• Anthropic 側のポリシー変更で対話モード経路もいずれ制限される可能性あり（README/AGENTS.md に明記）
• --settings 指定時に user/project settings.json の hooks がマージされるか上書きされるかは公式ドキュメント非明記（claude_settings で user 設定を明示的に統合する想定で設計）

Test plan

• cargo test 451 件 pass（既存 407 + 新規 44）
• cargo fmt --check clean
• cargo clippy --all-targets -- -D warnings warning ゼロ
• hook simulator: Stop / StopFailure(rate_limit/server_error/billing_error) の各 outcome JSON を CLI 経由で生成・分類し、exit code が期待通りであることを確認
• validate 動作確認: claude-interactive + -p 設定で実 binary が reject すること、-p なし設定で --verbose などのフラグが自動付与されないこと、--dry-run で plan が表示されること
• 実機検証 (要マニュアル): 小さな claude プロンプトを mode = "claude-interactive" で 1 件流し、outcome JSON が Stop で書かれることを確認
• 実機検証: 意図的にレート制限を発生させ、StopFailure(error=rate_limit) で failed-N マーカーが作られることを確認
• 実機検証: claude_settings = [{ command = [...] }] で wrapper の plugin 設定が merged settings 経由で適用され、token-burn の Stop hook も発火することを確認
• 実機検証: hook が発火しなかった場合に failed-N + hook did not fire エラーが記録されることを確認
• 既存 mode = "claude-print" 経路で従来通り動くことを回帰確認

Migration

• 既存 config で claude -p ... を使っている場合、デフォルトの mode = "auto" のままで claude-print として自動判定される。動作は変わらない
• 6/15 以降のプラン枠消費を維持したい場合: command から -p / --output-format 等の print-only フラグを除外し、mode = "claude-interactive" を明示
• wrapper script で claude --settings "$JSON" を渡している場合: wrapper 内の --settings を削除し、生成ロジックを claude_settings = [{ command = ["bash", "-lc", "..."] }] に移植
• token-burn init の新規生成では mode = "claude-interactive" がデフォルト

Commits

• cf39aa0: feat(claude): claude-interactive モードで対話的 Claude Code 経路に対応
• 6794a21: feat(claude): claude_settings で user の Claude settings を統合