fix(cli): API レスポンスの無検証キャストと版照会手段の欠如で版違いデーモンに静かに誤動作する

[Kewton]

事象

CLI（send / wait / respond / capture / instances / ls / report）は稼働デーモンへ HTTP で話すが、API レスポンスを無検証で型キャストしており、版違いのデーモンに対して静かに誤動作する。CLI がデーモンの版を照会する手段（version / health エンドポイント）も存在しない。

原因

• src/cli/utils/api-client.ts:199-211 — get<T>: (await response.json()) as T（無検証キャスト）
• 同 :223-239, 252-267 — post/patch: JSON.parse(text) as T（同様）
• 版ヘッダ・シェイプ検証はどこにも無い
• src/app/api/ 配下に version / health 系エンドポイントが無い（update-check はあるが CLI から版照合には使われていない）

具体例

src/cli/utils/agent-instances.ts:26-28 の worktree.agentInstances ?? [] — 旧デーモンが agentInstances フィールドを返さない場合、無音で空配列になり「No agent instances found」と表示される（実在するのに）。エラーではなく「静かに間違った答え」になるのが問題。

失敗シナリオ

#1337 の状況（新 CLI + 旧デーモン、またはその逆）で、レスポンス形状の差分が誤った既定値・undefined アクセスとして現れる。利用者にもエージェント（CLI を自動操作する側）にも版ずれが見えない。

対策案

• 軽量な GET /api/version（または update-check 流用）を追加し、CLI が接続時に版を照合、不一致なら警告を表示する（fix(cli): 稼働デーモンの版が据え置かれ、利用者が古い版だと気づけない #1337 対策①の基盤にもなる）
• 重要なレスポンスに最低限のシェイプ検証（必須フィールドの存在チェック）を入れ、欠落時は「デーモンの版が古い可能性」を示すエラーにする

関連

• fix(cli): 稼働デーモンの版が据え置かれ、利用者が古い版だと気づけない #1337（CLI↔デーモン版ずれの検知基盤として同時設計が望ましい）

優先度

中。

確信度

コード確認済み。

---

この Issue は #1337〜#1341 の真因分析から横展開した潜在バグ調査（2026-07-17）により検出。