perf(tui): トレース無効時にキー毎の TraceEvent 構築を省く

[kkyosuke]

目的

ホーム画面のイベントループは毎キー押下で操作トレースを記録しているが、トレース無効（既定）でもイベント構築のコストを払っていた。trace_log の docstring が掲げる「opt-in なのでホットパスのコストはゼロ」という不変条件を、この呼び出し箇所で実体に合わせる。

背景

event_loop のキー処理は次を呼んでいた:

TraceLog::record(
    TraceEvent::now(TraceCategory::Tui, "key")
        .with_detail(format!("{:?} {:?}", state.mode(), key)),
);

record() は内部で is_enabled() を見て即 return するが、引数の TraceEvent::now（Utc::now() + 文字列確保）と format! は無効時でも先行評価される。キー入力は人間速度なので CPU 実害は小さいが、宣言された不変条件の破れであり修正は明快。

変更内容

• infrastructure/trace_log.rs
  • TraceLog::record_with(impl FnOnce() -> TraceEvent) を追加。is_enabled() を通過してからクロージャでイベントを構築するため、無効時はタイムスタンプ・確保・format! のいずれも走らない。
  • record の本体を private な emit(&TraceEvent) に切り出し、record / record_with で共有。
  • 冷たい経路（CLI 終了・セッション create/remove・MCP は detail が "ok"/"error" と軽量）は record のまま据え置く。
• presentation/tui/home/event/mod.rs
  • キー押下トレースを record_with(|| ..) に変更。

テスト・確認方法

• cargo fmt / cargo clippy --all-targets -- -D warnings / cargo test 通過。
• 追加テスト:
  • trace_log: record_with の有効/無効両分岐（無効時は書き込みなし、有効時は tui イベントが残る）。
  • event: USAGI_TRACE を有効にしてループを回し、キー押下が記録されることを確認（計測対象 event/mod.rs のクロージャをカバー）。
• cargo llvm-cov --workspace（CI 相当）で Lines/Functions 100% を維持（変更ファイルともに 100%）。

補足（今回見送った性能観点の指摘）

レビューでは他に 2 点を挙げたが、いずれも変更を見送った:

1. MonitorHandle::snapshot() の毎ティック clone — イベントループ側では結果が apply_badges に消費されるため clone は実質必須。没入側の非描画 wake での再計算も頻度が低い。回避には監視状態の世代カウンタ導入が要るが、live 集合は各ペインの生存フラグから毎フレーム導出しており世代化するとライブ判定が最大 200ms 遅延する挙動退行になる。便益も計測下では無で、見送り。
2. 没入時のグリッド全文字列化 — 不変 Arc スナップショット設計の固有コストで、60fps コアレス＋行差分で実画面書き込みは最小化済み。「修正」は設計の作り替えで退行リスクがあり便益も不確実。

どちらも欠陥ではなく、現状が妥当という判断。世代化アプローチを試す価値があると判断される場合は別途ご相談ください。

🤖 Generated with Claude Code

[github-actions]

📊 Test Coverage

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

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