refactor: エージェント抽象を導入して Codex / Grok の差し込み口を作る（Phase A）

[takecchi]

何のための PR か

codiva は Claude Code 専用でしたが、将来 Codex / Grok に対応できる形にするための土台を入れます。
挙動は変えず、差し込み口だけを作る Phase A です（アダプタ本体の実装は Phase B 以降）。

さらに「Claude で実装を進めていたが途中から Codex に切り替える」というユースケースを想定した
状態モデルまで入れてあります。

構造の変更

SDKMessage を直接 SessionState へ畳み込んでいた sdk-parse.ts を 2 段に割りました。

provider のメッセージ ─[アダプタの parse]→ AgentEvent[] ─[applyAgentEvent]→ SessionState
   SDKMessage             claude-parse.ts      agent-events.ts
  （Codex/Grok の形）      （各アダプタ）        （全 provider 共通）

新しいファイル	役割
core/agent-ports.ts	AgentAdapter / AgentRun / AgentCapabilities / PermissionDecision = DI 境界（leaf）
core/agent-events.ts	AgentEvent の語彙 + 全 provider 共通の畳み込み applyAgentEvent
core/claude-parse.ts	旧 sdk-parse.ts。SDKMessage → AgentEvent[] の写像に専念
core/claude-errors.ts	Claude CLI の文言 / typed kind / HTTP status → AgentStopCause の分類
core/claude-adapter.ts	query() の組み立てと canUseTool ⇄ requestPermission の写像

境界を SessionHandle / AgentAdapter に引いた理由（QueryFn ではない）

• SessionManager から上（UI・永続化・PR 自動化・worktree・通知）は既に SessionHandle 越しにしか
  セッションを触っておらず、もともとエージェント非依存でした。その下にアダプタを足すだけで済みます。
• 逆に SDK の query() の署名（AsyncIterable<SDKUserMessage> + Options + canUseTool +
  control request）を共通 IF にすると、全 provider に Claude の制御モデルの模倣を強いることになります。

副次的に直ったこと

• 中立モジュールから SDK の import が消えた。@anthropic-ai/claude-agent-sdk を import するのは
  claude-*.ts（アダプタ 3 点）だけになりました。
• PermissionResult（SDK 型）が core に漏れていたのを自前の PermissionDecision に置換
  （PermissionRequest は元から自前だったので、ようやく対になりました）。
• Session.consume が rate_limit_event を直接読んでいた既存の規約違反（「形の知識は 1 か所」）を解消。
• 失敗の分類（認証切れ / レート制限 / 通信断）が reducer の正規表現から AgentAdapter.classifyError へ。
  aborted イベントは cause を運びます。文言の見分け方は provider ごとの知識なので状態機械には置きません。

セッション途中のエージェント切替

worktree（＝実際の成果物）は provider 非依存なので引き継げますが、モデル側の文脈は provider を
またげません（各 CLI が自分のトランスクリプトを持つため）。したがって切替は
「今のターンを畳む → 同じ worktree で別 provider の新セッションを開く」形になります。

引き継がれる	引き継がれない
worktree（コード・コミット・ブランチ）	モデル側の会話文脈
codiva 側のログ・TODO・コスト・PR	解決済みモデル名

• SessionState.agentSessions に provider ごとの resume id を持たせ、永続化しました。
  Claude → Codex → Claude と戻ると Claude 側は続きから再開します（新規会話になりません）。
• LogEntry.agent でどこからが別エージェントの発言かを刻みます。切替を使っていないセッションには
  付かないので、既存の表示・ログの形は一切変わりません。
• Session.setAgent() / getAgent()、CodivaEvent の agent_switched を追加。
• 旧スナップショットは 'claude' にフォールバックするので、既存の state.json はそのまま読めます。

/agent コマンドと引き継ぎプロンプトの生成は Phase B です。

挙動が変わらないことの担保

• 1,100 行超の実データテスト（claude-parse.spec.ts + __fixtures__/*.jsonl）は、分割前と
  同じ入口（旧 applySdkMessage → applyClaudeMessage）を叩き続けます = 分割のリグレッション網。
• 変更が必要だったテストは status-reducer.spec.ts の 4 件だけで、これは分類が
  アダプタへ移ったことの反映です（文言 → 分類のテストは claude-errors.spec.ts の
  classifyClaudeError に移設・拡充）。
• agent-events.spec.ts を新規追加（19 件）。切替時の resume id の退避・復元、完了ゲート、
  rollup ガード、PR 検出、通知の畳み込みをカバー。

テスト

• npm run lint … 211 ファイル通過
• npm run typecheck … 通過
• npm test … 2,277 件通過 / カバレッジ statements 95.07%・branches 90.42%（閾値 80 / 75）
• npm run build … 通過（dist/index.js + dist/main-<hash>.js の 2 ファイル構成も維持）
• 手動確認（TTY + 認証が必要なためエージェントセッションでは実行不可。挙動不変の
  リファクタリングであり配線は統合テストで検証済みですが、体感確認はお願いします）

ついでに直したもの

tests/update.test.tsx の 2 件が既存の flake でした（unavailable を検証する 2 つだけ
await flush() が抜けており、ダイアログが「確認中…」のまま assert していた）。兄弟テストと
同じ待ち方に揃えています。

ドキュメント

docs/ARCHITECTURE.md に「エージェント抽象」節を新設し、上記の設計判断を理由つきで記録しました。
CLAUDE.md の不変条件 2・3・4、.claude/rules/{sdk-integration,session-domain,architecture}.md、
docs/PRD.md / docs/TASKS.md（Phase A ✅ / B〜D 未着手）も更新済みです。
README.md はユーザー可視の挙動が変わらないため無変更です。

次の Phase（この PR には含みません）

Phase	内容
B	ACP（Agent Client Protocol）アダプタ + Codex 対応。session/request_permission が canUseTool に、session/cancel が interrupt に、session/load が resume にほぼ 1:1 で対応します
C	Grok 対応（grok agent stdio）
D	capability による UI 縮退の配線・/agent コマンド・引き継ぎプロンプトの生成