test: IO 入口を DI でテスト可能にしカバレッジ計測へ追加

[kkyosuke]

目的

これまで「テスト不能」として scripts/coverage.sh の COVERAGE_IGNORE に逃がしていた薄い IO ラッパ群を、依存注入（DI）でテスト可能にしてカバレッジ計測（行・関数 100%）の対象に戻す。「ignore をやめる」ための第一弾。

方針 — テスト不能部分を DI で対処する

実 IO（標準入出力・サブプロセス・端末・スレッド）を引数やジェネリックで注入し、本物の IO は合成ルート src/main.rs（計測対象外）で束ねる。これで presentation/CLI のオーケストレーションがユニットテストだけで 100% を満たせる。

補足: CI のカバレッジは cargo llvm-cov --workspace＝lib が test/非 test の二重ビルドになる。ジェネリック関数は非 test ビルドで単相化されず、test ビルドのユニットテストのみが計測対象になるため、具象 IO 関数の「非 test 側コピーが未カバー」という二重計上を避けられる。

変更内容

計測対象に追加した 10 ファイル（いずれも行・関数 100%）:

ファイル	DI の入れ方
cli/agent_phase.rs	フック payload を impl Read で注入（実 stdin をブロックしない）
cli/mcp.rs	Box<dyn AgentBackend> と impl BufRead/impl Write を注入。実 IO の CliAgentBackend は main.rs へ移設
cli/clean.rs	detached spawn を関数注入。実 spawn_detached は main.rs へ移設。usagi_bin フォールバックを純粋関数へ抽出
cli/hop.rs / cli/run.rs	TUI / gallery 起動を注入
tui/splash|welcome|new|gallery/mod.rs	event_loop を #[cfg(test)] の use エイリアスでモックに差し替え
tui/echo.rs	EchoGuard に fd を注入し、PTY で echo クリア／復元を検証

補助:

• session create/list <x> 補完フォールバックのテストを追加し home/command/builtins.rs を 100% に（既存の未カバー行を解消）。
• COVERAGE_IGNORE を「テスト可能なロジックを抜いた後に残る実 IO 層」だけに限定し、残置理由を scripts/coverage.sh に明記。
• document/06-conventions.md に DI でテスト可能化する方針を追記。

テスト・確認方法

cargo fmt --check
cargo clippy --all-targets -- -D warnings
cargo test
# CI と同条件のカバレッジ enforce
. ./scripts/coverage.sh
cargo llvm-cov --workspace --ignore-filename-regex "$COVERAGE_IGNORE" --summary-only
cargo llvm-cov report --ignore-filename-regex "$COVERAGE_IGNORE" \
  --fail-under-lines 100 --fail-under-functions 100   # exit 0

ローカル（macOS）で全テスト緑・カバレッジ 100%（行・関数）・enforce exit 0 を確認。

残作業（後続 PR）

次の除外ファイルは、より大きな DI リファクタが必要なため別 PR で対応する:

• タイムアウトループのクロック/子プロセス注入: infrastructure/release.rs・cli/llm_mcp.rs（std::process::ExitStatus が構築不能なため、ポーリング結果を独自 enum に分離して sleep/timeout 分岐をテスト可能化）
• 実 PTY: infrastructure/pty.rs（実シェルを PTY に起動する統合テスト + reap ループの注入）
• live TTY 入力: tui/term_reader.rs（raw キー源・readiness・raw mode を注入。select/poll は fd 注入で直接テスト）
• 大型オーケストレータ: tui/app/mod.rs・tui/home/mod.rs・home/terminal_pane.rs・home/terminal_pool.rs・tui/open/mod.rs・tui/config/mod.rs・tui/config/provisioning.rs（PtySession の抽象化とスクリプト駆動が必要）
• src/main.rs は合成ルート（実 IO の注入先）として計測対象外を維持。

🤖 Generated with Claude Code

[github-actions]

📊 Test Coverage

🚀 いまのカバレッジ (Lines): 100.00% — この調子でいこう！

🎉✨ パーフェクト！全ファイル Lines カバレッジ 100% を達成しました 🏆🐰