claude-spotter 1.2.4 → 1.3.0

package/CHANGELOG.md

@@ -1,5 +1,116 @@
 # Changelog
 
+## 1.3.0
+
+**Haiku spawn 時に user/project の MCP server を一切 load しないよう強制 — WSL2 で観測された CPU 100% 飽和 + 孤児 `npm exec` プロセス累積 + チャット入力無反応 の根本原因を断った minor bump**。修正は `claude -p` 起動引数に `--strict-mcp-config --mcp-config <empty>` を必ず付けるだけの最小実装、副作用なし。
+
+### 観測した症状 (2026-05-04 WSL2 実環境)
+
+WSL2 の CPU 使用率が 100% に張り付き、何かがプロセスを「無限増殖」させている — というユーザー報告から調査開始。`ps -eo pid,ppid,pcpu,etime,cmd --sort=-pcpu` の上位に **etime 3〜10 秒の `npm exec @modelcontextprotocol/server-*` / `@playwright/mcp` / `@upstash/context7-mcp` / `homework-mcp` / `caveat mcp` / `mcp-server-github` / `mcp-server-memory` 等が大量並走** し、親 PID は `claude -p --resume <uuid> --model claude-haiku-4-5-20251001` (= Spotter daemon の Haiku caller)。Spotter daemon が 3 並走、各々の Haiku 起動ごとに 60+ 個の MCP server を spawn → 終了 → 再 spawn のサイクルで CPU を食いつぶしていた。隣接プロジェクト ([Chime](file:///home/kite/projects/Chime)) で「VSCode 拡張のチャット入力が無反応」体感症状の真因も同根 (WSL2 全体の CPU 飽和で拡張側の入力処理がドロップ)。
+
+### 真因
+
+`sanitizeHaikuEnv` (v1.1.6) は `CLAUDE_CONFIG_DIR` を strip して Haiku をデフォルト `~/.claude/` で起動するが、**デフォルト config dir には User scope MCP (`~/.claude.json` 直下 `mcpServers`) と plugin MCP がフルで登録されている**。claude CLI 2.1.x は `--print` モード起動時に config dir 内の全 MCP server を eager に spawn するため、Haiku 1 回呼出ごとに数十個の `npm exec` 子プロセスが立つ。Haiku は `{name, description}` カタログ監査しかしない (= MCP server は不要) のに、起動コストとして user/project の MCP がフル load されていた構造的欠陥。
+
+加えて `daemon-702a677d-...log` で同 sessionId の `tool-db loaded` が 15 分間に 8 回記録 = sudden death + auto-resurrect が高頻度発生していた。WSL2 cgroup OOM kill が daemon プロセスごと巻き込んでいた可能性が高く、[docs/open-issues.md](docs/open-issues.md) P0 「daemon プロセスが shutdown ログなしに死ぬ」 (v0.13.2 から残置) の主因もこれと推定。
+
+### 変更点
+
+- **編集 [src/daemon/haiku-caller.mjs](src/daemon/haiku-caller.mjs)**:
+  - 定数 `EMPTY_MCP_CONFIG_PATH = ~/.spotter/workdir/empty-mcp.json` と `EMPTY_MCP_CONFIG_BODY = '{"mcpServers":{}}'` を追加
+  - `ensureWorkdir` を拡張し、空 MCP config ファイルを idempotent に書き出す
+  - 新 named export `emptyMcpConfigPath()` (テストから参照)
+  - `buildSpawnArgs({ ...args, mcpConfigPath })` のシグネチャを拡張、`mcpConfigPath` を必須化 (TypeError on missing/empty)、出力に `--strict-mcp-config --mcp-config <path>` を必ず含める。Windows `cmd.exe /c` 経路でも同様に
+  - `createHaikuCaller` 内 `spawn` 直前で `mcpConfigPath: EMPTY_MCP_CONFIG_PATH` を渡す
+- **編集 [test/haiku-caller.test.mjs](test/haiku-caller.test.mjs)**: 回帰ガード 5 件追加 + 既存 `buildSpawnArgs` 2 件を新シグネチャに追従
+  - 新規: first call と resumed call の両方で `--strict-mcp-config` と `--mcp-config <path>` を含む
+  - 新規: `mcpConfigPath` 欠落 / 空文字 / null で TypeError
+  - 新規: `ensureWorkdir` で `empty-mcp.json` が `{"mcpServers":{}}` で書かれる
+  - 新規: `ensureWorkdir` の idempotent 性 (3 連呼出で破綻しない)
+- **編集 [src/cli/install.mjs](src/cli/install.mjs)**: `HOOK_EVENTS` の Stop/UserPromptSubmit timeout を 15s/30s から **60s に統一**。v0.13.1 で daemon 側 Haiku timeout を 30s→45s に緩和したのに settings.json に書く Claude Code 本体側の hook timeout が旧値のままで、Chime 等の preamble が大きい (93 KB / 357 件) 環境で daemon が 24-32s かけて正常応答を返している最中に Claude Code 側 hook が timeout kill されて「チャット入力無反応」を誘発していた既存バグの hot-fix。`docs/open-issues.md` の P0「install.mjs の hook timeout が v0.13.1 緩和を反映していない」項目を closing
+- **package.json**: `1.2.6` → `1.3.0` (公開 API シグネチャ変更 = `buildSpawnArgs` の新引数を伴うため minor bump)
+- **編集 [docs/open-issues.md](docs/open-issues.md)**: 解決済みリストに 2 件追加、P0「daemon が shutdown ログなしに死ぬ」節に v1.3.0 で根因が大半解消した可能性を追記
+
+### なぜ `--strict-mcp-config --mcp-config <empty>` が正解か
+
+- **Anthropic auth は影響なし** — credentials は `~/.claude/.credentials.json` 等から従来どおり読まれる (`--bare` を使うと keychain skip で OAuth が壊れるが、`--strict-mcp-config` は MCP config を制限するだけで auth とは独立)
+- **副作用ゼロ** — Haiku は `{name, description}` カタログ監査しか必要としない、MCP server を呼ばない。Spotter のカタログ収集 (`investigate-mcp.mjs`) は別経路 (`claude mcp list` + `.mcp.json` 直読み) で行うので Haiku 側に MCP は要らない
+- **クロスプラットフォーム** — `--strict-mcp-config --mcp-config <path>` は Linux/macOS/Windows 全てで動作、`--mcp-config` は v0.x 時代から claude CLI に存在
+- **既存の v1.1.6 `sanitizeHaikuEnv` と直交** — Bell の isolated `CLAUDE_CONFIG_DIR` 継承防止 (auth 失敗回避) は引き続き必要、本修正は MCP load 防止という別軸で重ねがけ
+
+### Chime / Spotter ユーザー側で必要な手順
+
+1. `npm install -g claude-spotter@1.3.0` で global update
+2. 既 install プロジェクトでは hook 設定 (`spotter.mjs` のパス固定) は変わらないので **再 install 不要**、次の SessionStart から自動的に新コードが効く
+3. 既存の孤児 daemon があれば `kill <pid>` + `rm ~/.spotter/runtime/session-*.pid` で掃除 (今後は v1.3.0 の MCP-disable で sudden death 自体が大幅減少見込み)
+
+## 1.2.6
+
+**チャット入力が無視される実害バグの根治**。実プロジェクト ([Chime](file:///home/kite/projects/Chime)) のセッションで Spotter daemon が UserPromptSubmit / Stop hook を Haiku 呼び出しで何度も `E_INTERNAL: haiku exited with code 1` させ、Claude Code 側 hook timeout (30s) に貼り付いて入力が応答しない状態が頻発していた。原因は Haiku を起動する `claude -p` への stdin 引き渡し方式と、claude CLI 2.1.x の stdin 取扱いの仕様の組合せで、推測ではなく実プロジェクト同条件 (`tools=357 件 / preamble=93 KB`) の最小再現で確定した。
+
+### 観測された stderr
+
+```
+Warning: no stdin data received in 3s, proceeding without it.
+  If piping from a slow command, redirect stdin explicitly: < /dev/null to skip, or wait longer.
+Error: Input must be provided either through stdin or as a prompt argument when using --print
+```
+
+### 真因 (推測ではなく実測で確定)
+
+claude CLI 2.1.126 は `--print` モードで stdin の最初の read attempt が **約 3 秒** 以内に readable にならないと「stdin 無し」と判定して引数モードに切替えようとし、prompt が無いので exit 1 する。一方 Spotter は v0.7.0 の tool-db 化で preamble (role + schema + few-shot + 全カタログの JSON) を初回 1 回送信しているが、Chime のように `MCP × スキル × サブエージェント = 357 件` ある環境では preamble が **93 KB** 程度に達する。Linux の kernel pipe buffer (デフォルト 64 KB) を超えるため、Node 側 `child.stdin.end(buf)` の write が drain 待ちになり、claude CLI が起動 (auth + config + plugin 探索) を 3 秒以内に終えて最初の read syscall を発行しないと「3 秒間 no stdin data」と CLI 側で判定 → stdin 放棄 → exit 1。CLI は "Warning" を出して続行するふりをするが、実際は `--print` 引数も無いので "Input must be provided" で死ぬ。
+
+実測 (2026-05-04, /home/kite/projects/Chime での Spotter セッション + WORKDIR 隔離環境):
+
+| stdin 経路 | duration | exit code | stderr |
+|---|---|---|---|
+| `child.stdin.end(prompt)` (pipe) | 17 秒 | 1 | "no stdin data received in 3s" + "Input must be provided" |
+| **tempfile fd を `stdio[0]` に渡す (本修正)** | **24-32 秒** | **0** | (空) — 正常 JSON 応答 |
+
+このバグの可視結果は、daemon log の以下メッセージが繰り返し出る現象として観測されていた:
+- `user_input: haiku invocation failed (E_INTERNAL), rotating session before rethrow: haiku exited with code 1: Warning: no stdin data received in 3s ...`
+- 当該 turn は session を rotate して `mode=first` の cold-start に逆戻り (preamble 再送 → ますます重い) → 30s hook timeout に貼り付き → ユーザー視点で「チャット入力が無視される」
+
+### 変更点
+
+- **編集 [src/daemon/haiku-caller.mjs](src/daemon/haiku-caller.mjs)**: 新規 `preparePromptFile(wirePrompt)` を named export として追加。`os.tmpdir()` 配下にユニーク tempfile (`spotter-prompt-<pid>-<uuid>.txt`) を作って prompt を書き込み、read-only fd と `close()` ハンドラ (fd close + unlink、両方 best-effort) を返す。`createHaikuCaller` 内 `callHaiku` の `spawn` を `stdio: ['pipe', 'pipe', 'pipe']` + `child.stdin.end(prompt)` から `stdio: [promptFile.fd, 'pipe', 'pipe']` に切替え (child.stdin が null になるので関連 noop listener も削除)。close / error / timeout の各 settle 経路で `promptFile.close()` を呼んでから resolve/reject する `settleAfterCleanup` ヘルパで cleanup を一元化、tempfile leak を防止
+- **編集 [test/haiku-caller.test.mjs](test/haiku-caller.test.mjs)**: 回帰ガード 6 件追加 — (1) tempfile が書かれて読める (2) 100 KB (= pipe buffer 超え) でも全 byte 届く (3) `close()` で unlink される (4) `close()` 二重呼び出し可 (timeout-vs-close race の安全性) (5) 非 string 入力で `TypeError` (6) 並列呼び出しで tmpPath が衝突しない (UUID 保証)
+- **package.json**: `1.2.5` → `1.2.6`
+
+### なぜ tempfile fd 方式が正解か
+
+- **file は kernel が即時 readable と判定** — pipe と違い「writer 側の進捗」を待たないので、CLI 起動が遅くても 3 秒タイマーに引っかからない
+- **pipe buffer の制約から完全に独立** — 64 KB / 1 MB / 10 MB どんな payload でも file 経由なら一発で届く
+- **クロスプラットフォーム** — Windows でも `os.tmpdir()` は機能、`stdio[0]` への numeric fd 受け渡しも Node が抽象化済み
+- **CLI 引数モード (`-p "<prompt>"`) と違い ARG_MAX に縛られない** — Windows の CommandLineW 32K 制限を回避
+
+### Chime で「無反応」が消えるまでに必要な手順 (ユーザー側)
+
+1. `npm install -g claude-spotter@1.2.6` で global update
+2. Chime 側の既 install プロジェクトでは hook 設定 (`~/.claude.json` の per-project hooks) は変わらない (`spotter.mjs` のパスは固定) ので **再 install 不要**、次の SessionStart から自動的に新コードが効く
+3. 既存の孤児 daemon があれば `rm ~/.spotter/runtime/session-*.pid` で掃除 (生存 daemon 0 件確認後のみ)
+
+## 1.2.5
+
+**ECC プラグイン経由の MCP サーバー 6 件 (context7 / exa / github / memory / playwright / sequential-thinking) のツール群 (61 件) が Spotter のカタログから silent に欠落していた **二重構造バグ**を修正**。実プロジェクト (Web) で `spotter install` 実行時のログに ``mcp investigate failed for "plugin": Command failed: cmd.exe /c claude mcp get plugin`` が **6 連発** で出ていたのを契機に発見。これらのプラグイン MCP の呼び忘れを Spotter が検出できない状態だった (Web プロジェクトで rebuild すると 309 → 370 件、プラグイン由来 61 件が追加されることを確認)。
+
+### 変更点
+
+- **編集 [src/tool-db/investigate-mcp.mjs](src/tool-db/investigate-mcp.mjs)** (2 段階):
+  1. `parseMcpListOutput` の name 区切りを `indexOf(':')` (コロン単体) から `indexOf(': ')` (コロン + スペース) に変更。サーバー名側に literal `": "` (コロン + スペース) は CLI 仕様上現れない (CLI が name と rest の間に固定でこのペアを置くため) ので、空白入り名前 (`claude.ai Google Drive`) もコロン入り名前 (`plugin:everything-claude-code:context7`) も両立する
+  2. stdio エントリの `command` / `args` を CLI 出力行 (`<name>: <command> <args...> - <status>`) から直接抽出するよう変更。プラグイン MCP は `claude mcp list` には出るが `claude mcp get <name>` では `No MCP server found` で引けない仕様 (実測で確認) のため、CLI 行を唯一の権威ソースとして扱う必要がある。既存 `listMcpToolsOne` の `hasFullConfig` 分岐がそのまま生かされ、`claude mcp get` 経路を skip して直接 spawn するようになる。tokenisation は既存 `splitArgs` と同じ素朴 (whitespace 区切り、quote 非対応) を踏襲、空白入りパスの制約は変わらず
+- **編集 [test/tool-db.test.mjs](test/tool-db.test.mjs)**: 回帰テスト 3 件追加 + 既存 1 件の expectation 拡張 — プラグイン形式 stdio (`plugin:everything-claude-code:context7` を `npx ...` で登録、`command='npx'` / `args=['-y', '@upstash/context7-mcp@2.1.4']` を assert) / プラグイン形式 HTTP (`plugin:everything-claude-code:exa` を `(HTTP)` URL で登録) / 空白入り名前の継続パース (`claude.ai Google Drive` の sse 経路) / 既存 stdio エントリ (`caveat`) も command/args を返すことを assert
+
+### 背景
+
+`claude mcp list` の出力フォーマットは `<name>: <url-or-command> [(HTTP)] - <status>` で、name 部分には許容文字に応じてスペースもコロンも入りうる。Spotter は v0.7.0 でこの text パースを導入したが、当時のサンプル (`caveat: ...`, `x-api: ...`) には内部コロンが無かったため `indexOf(':')` で素朴に切っていた。Claude Code 側でプラグイン経由 MCP の名前が `plugin:<plugin-id>:<server>` 形式になったことで、6 サーバー全てが name=`"plugin"` に折り畳まれ、`claude mcp get plugin` が `No MCP server found` で失敗、catalog 投入をスキップする経路に流れていた。
+
+step 1 (name 区切り修正) でフルネームは取れるようになったが、Web プロジェクトでの局所実測で **`claude mcp get plugin:everything-claude-code:github` 等のフルネーム指定でも `No MCP server found with name: ...` を返す**ことが判明。プラグイン MCP は `mcp get` の対象外であり、`mcp list` 出力が唯一の権威ソース。step 2 で `parseMcpListOutput` を拡張して command/args を直接 tokenize、`hasFullConfig === true` で再 query を skip させた。
+
+`indexOf(': ')` (コロン + スペース) は CLI が固定で挿入する 2 文字ペアであり、サーバー名内部にこのペアが現れることは構造的に無いので、name 内の任意の `:` (コロン単体) と ` ` (スペース単体) を許容しつつ name と rest を一意に切れる。
+
+[docs/open-issues.md](docs/open-issues.md) P1 「`claude mcp list` text パースの脆弱性」全体は依然として残る (CLI フォーマット変更耐性は本修正でも上がらない、`--json` 出力が来たら全面切り替えしたい) が、コロン入り名前 + プラグイン MCP の具体例はこの版で塞がる。
+
 ## 1.2.4
 
 **v1.2.3 で `normalizeProjectPath` の挙動を変えた際に、対になる test の expectation 更新を漏らしたため macOS CI で fail していた hot-fix**。`normalizeProjectPath: separator / trailing slash / Windows case` ([test/tool-db.test.mjs:678](test/tool-db.test.mjs#L678)) は「backslash は常に forward slash になる」という旧仕様の expectation を残したまま v1.2.3 commit に取り込まれており、POSIX 上で `'C:\\Users\\u\\proj'` の入力に対して `'C:\\Users\\u\\proj'` (literal 保持) が返るのを `'C:/Users/u/proj'` で assert していた。Linux CI は v1.2.3 で緑化したが、v1.2.3 push 後の matrix 実行で macOS が同じ test で fail。

package/README.ja.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src=".github/og.svg" alt="Spotter — Audit agent for Claude Code" width="100%">
+  <img src=".github/og.png" alt="Spotter — Audit agent for Claude Code" width="100%">
 </p>
 
 # Spotter
@@ -27,6 +27,9 @@ Spotter が拾うのは、たとえばこういう瞬間です。
 | 「この設定ファイルの中身は？」 | 名前から推測で説明 | `read_file` の使用機会 |
 | 「今何時？」 | 学習時点の情報で答える | `current_time` の使用機会 |
 | 事実の断定 | 裏付けなしで「〜です」 | 検証用ツールの差し込み余地 |
+| 「このライブラリの最新版の使い方は？」 | 学習データから書き起こす | docs lookup MCP の照会機会 |
+| 「この UI 今もちゃんと動く？」 | コード読みだけで結論 | ブラウザ自動化 MCP の使用機会 |
+| 「以前何を決めたっけ？」 | 推測 / 失念のまま回答 | メモリ / ノート系 MCP の照会機会 |
 
 判定軸は 2 段階:
 
@@ -55,23 +58,49 @@ spotter uninstall        # このプロジェクトの hook 登録を解除
 
 ## アーキテクチャ
 
+### 1 ターンの監査フロー
+
+```mermaid
+flowchart TD
+    U([User 発話]) --> UPH[UserPromptSubmit hook<br/>Spotter が発話とカタログから一次判定]
+    UPH --> BT[Bell Thinking<br/>Spotter の推奨を<br/>additionalContext で受信]
+    BT --> BA([Bell の最初の応答])
+    BA --> SH[Stop hook<br/>応答と使用済みツールから最終チェック]
+    SH --> DEC{見落とし<br/>あり?}
+    DEC -->|なし| DONE([完了])
+    DEC -->|あり| SB[差し戻し<br/>max 1 回<br/>stop_hook_active で自動担保]
+    SB --> BA2([Bell の補正応答]) --> DONE
 ```
-User 発話
-  ↓
-UserPromptSubmit hook → Spotter がカタログと発話を見て一次判定
-  ↓
-Bell Thinking (Spotter の推奨を additionalContext で受け取る)
-  ↓
-Bell 最終応答
-  ↓
-Stop hook → Spotter が応答と使用済みツールを見て最終チェック
-  ↓
-見落としあれば差し戻し (max 1 回、Claude Code の stop_hook_active で自動担保)
+
+### カタログの収集経路
+
+```mermaid
+flowchart LR
+    subgraph SRC[収集ソース]
+      direction TB
+      MCP[MCP サーバー<br/>claude mcp list で列挙]
+      SK[スキル<br/>SKILL.md frontmatter]
+      AG[サブエージェント<br/>agent .md frontmatter]
+      BL[claude.ai baseline<br/>Gmail / Calendar / Drive<br/>存在時のみ注入]
+    end
+    subgraph SCOPES["MCP の env / headers — 4 スコープ、上位が衝突に勝つ"]
+      direction TB
+      L["Local — projects.&lt;root&gt;.mcpServers in ~/.claude.json"]
+      P["Project — &lt;root&gt;/.mcp.json"]
+      US["User — mcpServers in ~/.claude.json"]
+      LG["Legacy — ~/.claude/.mcp.json"]
+    end
+    SCOPES -. merge .-> MCP
+    MCP --> DB[(ローカル tool-db.json<br/>name + description<br/>プロジェクト単位)]
+    SK --> DB
+    AG --> DB
+    BL --> DB
+    DB --> H[Haiku 監査<br/>session-scoped, preamble-once]
 ```
 
-監査対象のツール (name + description) は `<project>/.spotter/tool-db.json` (ローカル) に格納されます。**daemon が監査に使うのはローカル DB のみ** (v1.2.0 以降) で、グローバル DB `~/.spotter/tool-db.json` は他プロジェクトでの description 再利用キャッシュとしてのみ機能します (live fetch コスト削減のため初回 refresh で参照、結果は local に write-through)。各プロジェクトの local DB は **そのプロジェクトの現時点の discovery 結果と一致** (refresh 時に prune される) ため、過去にインストールしていた MCP / スキル / サブエージェントが他プロジェクトに混入することはありません。
+監査対象のツール (name + description) は `<project>/.spotter/tool-db.json` (ローカル) に格納されます。**daemon が監査に使うのはローカル DB のみ**で、グローバル DB `~/.spotter/tool-db.json` は他プロジェクトでの description 再利用キャッシュとしてのみ機能します (live fetch コスト削減のため初回 refresh で参照、結果は local に write-through)。各プロジェクトの local DB は **そのプロジェクトの現時点の discovery 結果と一致** (refresh 時に prune される) ため、過去にインストールしていた MCP / スキル / サブエージェントが他プロジェクトに混入することはありません。
 
-**v1.1.0 以降、`spotter install` が初回 seed を自動実行し、Claude Code セッション起動ごとに SessionStart hook が bg で `spotter db refresh` を走らせる**ため、通常の運用で手動コマンドを叩く必要はありません。収集経路は (1) MCP サーバー: `claude mcp list` で集合を確定し、env / headers は Claude Code 公式 3 スコープ — User (`~/.claude.json` 直下 `mcpServers`) / Project (`<projectRoot>/.mcp.json`) / Local (`~/.claude.json` `projects[<root>].mcpServers`) — を precedence Local > Project > User で merge して取得 (v1.2.1 以降、互換のため legacy `~/.claude/.mcp.json` も最下位で参照)、各サーバーの `tools/list` を JSON-RPC で取得、HTTP/SSE transport にも対応、(2) スキル: user/project/プラグインの SKILL.md frontmatter から `{name, description}` を抽出、(3) サブエージェント: user/project/プラグインの agent .md frontmatter から抽出、(4) claude.ai baseline: OAuth proxy 経由の Gmail/Calendar/Drive 25 件は手書き baseline で補完 (v1.1.4 以降、`claude mcp list` に該当サーバーが存在する環境でのみ注入)。**手書きでツールリストを管理する必要はありません**。
+**`spotter install` が初回 seed を自動実行し、Claude Code セッション起動ごとに SessionStart hook が bg で `spotter db refresh` を走らせる**ため、通常の運用で手動コマンドを叩く必要はありません。各 MCP サーバーの `tools/list` は JSON-RPC で取得 (HTTP / SSE / stdio transport 対応)、スキルとサブエージェントは frontmatter から直接抽出、claude.ai baseline (OAuth proxy 経由の Gmail / Calendar / Drive 25 件) は `claude mcp list` に該当サーバーが存在する環境でのみ注入されます。**手書きでツールリストを管理する必要はありません**。
 
 ## Throughline との関係
 
@@ -110,11 +139,15 @@ spotter uninstall        # hook 登録を解除 (~/.spotter は残す)
 - **JSON スキーマ違反は v0.5.0 以降「想定済み異常」として silent pass + session renew で回復**します (role collapse 検知パス、daemon ログに `role_collapse_reset` を残す)。一方 **Haiku timeout は引き続き throw** され、UserPromptSubmit がブロックされてユーザー入力が Bell に届かない症状として顕在化します (timeout は v0.5.0 で 30s、v0.13.1 で 45s に拡張)。timeout の fail-open 化 (pass 扱い) は §0 改訂とセットで今後検討
 
 <details>
-<summary><strong>📋 v1.2.0 リリースノート (2026-04-26)</strong></summary>
+<summary><strong>📋 最近のハイライト</strong></summary>
 
-**当該プロジェクトで使えないツールが提案される回帰を構造的に修正**。daemon が監査に使うカタログを**ローカル DB のみ**に変更し、グローバル DB は他プロジェクトでの description 再利用キャッシュに役割を限定。`resolveAll` 末尾に prune ループ追加で、現プロジェクトの discovery 結果に含まれない既存ローカルエントリを削除 (= 過去の別プロジェクトで discover された MCP / スキル / サブエージェントが居座る経路を遮断)。既 install プロジェクトは npm global update 後、次の SessionStart で自動 refresh が走り、次の次のセッションから幽霊が消える (即時反映は `spotter db refresh` 手動)。v1.1.0 からの柱 (install 時 tool-db 自動構築 + SessionStart での drift 自動追従) は継続。監査対象は v1.0.0 でユーザー追加分 (MCP / スキル / サブエージェント) に絞り込み済み。
+- **プラグイン形式の MCP サーバー対応** — `plugin:everything-claude-code:context7` のように名前に内部コロンを含むサーバーを正しくパースし、配下のツールをカタログに取り込めるようになった (旧版はこの形式のサーバーをすべて単一の `"plugin"` に潰して、Bell の監査から silent に脱落させていた)
+- **プロジェクト単位の監査隔離** — daemon が監査に使うのはローカル DB のみ。グローバル DB は description 再利用キャッシュに役割限定。**他プロジェクト**でインストールしたツールが現プロジェクトの監査に混入することはない
+- **手放しでカタログ維持** — `spotter install` が tool-db を自動 seed、SessionStart で bg refresh が走る。手書き管理は一切不要
+- **監査対象** — ユーザー追加分 (MCP / スキル / サブエージェント) のみ。Claude Code 本体側のツールは意図的に対象外 (Bell は元から自発率が高いため)
+- **実装規範** — フォールバック禁止 / silent fallback 禁止 / 暫定コード禁止 ([CLAUDE.md §0](CLAUDE.md))
 
-詳細は [CHANGELOG](CHANGELOG.md) を参照。
+リリース履歴の全文は [CHANGELOG](CHANGELOG.md) を参照。
 
 </details>
 

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src=".github/og.svg" alt="Spotter — Audit agent for Claude Code" width="100%">
+  <img src=".github/og.png" alt="Spotter — Audit agent for Claude Code" width="100%">
 </p>
 
 # Spotter
@@ -26,7 +26,10 @@ Examples of what Spotter catches:
 | "What's the weather today?" | Guess from training data | Missed call to `web_search` |
 | "What's in this config file?" | Describe based on the filename | Missed call to `read_file` |
 | "What time is it?" | Answer from training-time knowledge | Missed call to `current_time` |
-| Asserting a fact | Stating it without verification | Opportunity to call a verification tool |
+| Asserting a fact | State it without verification | Opportunity to call a verification tool |
+| "How does this library API work in the latest version?" | Recite from training data | Missed call to a docs-lookup MCP |
+| "Does this UI still render correctly?" | Reason from source code alone | Missed call to a browser-automation MCP |
+| "What did we decide about X earlier?" | Guess or admit forgetting | Missed call to a memory / notes MCP |
 
 Spotter audits in two stages:
 
@@ -55,23 +58,49 @@ spotter uninstall        # remove hooks from this project
 
 ## Architecture
 
+### Audit flow per turn
+
+```mermaid
+flowchart TD
+    U([User prompt]) --> UPH[UserPromptSubmit hook<br/>Spotter audits prompt against catalog]
+    UPH --> BT[Bell thinking<br/>receives Spotter's recommendations<br/>as additionalContext]
+    BT --> BA([Bell's first answer])
+    BA --> SH[Stop hook<br/>Spotter re-audits answer + tools used]
+    SH --> DEC{Missed<br/>tool?}
+    DEC -->|No| DONE([Done])
+    DEC -->|Yes| SB[Send-back to Bell<br/>max 1 round<br/>guarded by stop_hook_active]
+    SB --> BA2([Bell's amended answer]) --> DONE
 ```
-User prompt
-  ↓
-UserPromptSubmit hook → Spotter does a first pass against the catalog
-  ↓
-Bell thinking (receives Spotter's recommendations as additionalContext)
-  ↓
-Bell's final answer
-  ↓
-Stop hook → Spotter re-audits the answer + tools actually used
-  ↓
-If something was missed: send-back (max 1 round, guaranteed by Claude Code's stop_hook_active)
+
+### Catalog discovery
+
+```mermaid
+flowchart LR
+    subgraph SRC[Discovery sources]
+      direction TB
+      MCP[MCP servers<br/>via claude mcp list]
+      SK[Skills<br/>SKILL.md frontmatter]
+      AG[Sub-agents<br/>agent .md frontmatter]
+      BL[claude.ai baseline<br/>Gmail / Calendar / Drive<br/>injected when present]
+    end
+    subgraph SCOPES["MCP env / headers — 4 scopes, top wins on collision"]
+      direction TB
+      L["Local — projects.&lt;root&gt;.mcpServers in ~/.claude.json"]
+      P["Project — &lt;root&gt;/.mcp.json"]
+      US["User — mcpServers in ~/.claude.json"]
+      LG["Legacy — ~/.claude/.mcp.json"]
+    end
+    SCOPES -. merged into .-> MCP
+    MCP --> DB[(Local tool-db.json<br/>name + description<br/>per project)]
+    SK --> DB
+    AG --> DB
+    BL --> DB
+    DB --> H[Haiku audit<br/>session-scoped, preamble-once]
 ```
 
-The audited tool catalog (name + description) lives in `<project>/.spotter/tool-db.json`. **Since v1.2.0 the daemon audits against the local DB only**; the global DB at `~/.spotter/tool-db.json` is a description-reuse cache shared across projects, not an audit source. Each project's local DB always matches the **current** discovery snapshot for that project (entries are pruned on refresh), so MCP servers, skills, or sub-agents installed in *other* projects can never bleed into this project's audit.
+The audited catalog lives in `<project>/.spotter/tool-db.json`. **The daemon audits against the local DB only**; the global DB at `~/.spotter/tool-db.json` is a description-reuse cache shared across projects, not an audit source. Each project's local DB always matches the **current** discovery snapshot for that project (stale entries are pruned on refresh), so tools installed in *other* projects can never bleed into this project's audit.
 
-**Since v1.1.0, `spotter install` runs the initial seed automatically, and the SessionStart hook triggers a background `spotter db refresh` on every Claude Code session start** — so you don't need to invoke catalog commands by hand. The discovery sources are: (1) **MCP servers** — enumerated from `claude mcp list` (membership) and merged with all three official Claude Code scopes for env / headers: User (`~/.claude.json` direct `mcpServers`) / Project (`<projectRoot>/.mcp.json`) / Local (`~/.claude.json` `projects[<root>].mcpServers`), with precedence Local > Project > User (v1.2.1+); a legacy `~/.claude/.mcp.json` source is also read at the lowest priority for backward compatibility. Each server's `tools/list` is fetched via JSON-RPC (HTTP/SSE transport supported); (2) **skills** — `{name, description}` extracted from SKILL.md frontmatter at user / project / plugin scope; (3) **sub-agents** — same pattern from agent `.md` frontmatter; (4) **claude.ai baseline** — Gmail / Calendar / Drive (25 entries via OAuth proxy) injected from a hand-maintained baseline only when `claude mcp list` confirms the server is present (v1.1.4+). **You never have to maintain the tool list by hand.**
+**`spotter install` seeds the catalog automatically, and the SessionStart hook runs a background `spotter db refresh` on every Claude Code session start** — so you don't need to invoke catalog commands by hand. Each MCP server's `tools/list` is fetched via JSON-RPC (HTTP / SSE / stdio transports supported); skill and sub-agent metadata comes straight from frontmatter; the claude.ai baseline (25 hand-curated entries for Gmail / Calendar / Drive over OAuth proxy) is injected only when `claude mcp list` confirms the server is present. **You never have to maintain the tool list by hand.**
 
 ## Spotter and Throughline
 
@@ -112,13 +141,15 @@ spotter uninstall        # remove hooks from this project (leaves ~/.spotter int
 - **Since v0.5.0, JSON schema violations from Haiku are treated as expected-anomalies** (silent pass + session renew, logged as `role_collapse_reset`) — this is the role-collapse recovery path. **Haiku timeouts still throw**, which surfaces as `UserPromptSubmit` blocking the user's prompt from reaching Bell. Timeouts have been raised twice (30s in v0.5.0, 45s in v0.13.1); making timeouts fail-open is deferred until §0 is revisited
 
 <details>
-<summary><strong>📋 v1.2.0 release notes (2026-04-26)</strong></summary>
-
-**Structural fix for a regression that suggested tools the current project can't actually use.** The catalog the daemon audits against is now **local-only**. The global DB has been demoted to a cross-project description-reuse cache. A prune step was added to the end of `resolveAll`: any local entry not present in the current project's discovery snapshot is removed. This closes the path through which MCP servers / skills / sub-agents discovered in other projects used to linger in this project's audit set.
+<summary><strong>📋 Recent highlights</strong></summary>
 
-For projects that already have Spotter installed, the next SessionStart after the npm global upgrade triggers an auto-refresh; the ghosts disappear from the session-after-next (immediate cleanup: run `spotter db refresh` by hand). The pillars introduced in v1.1.0 (auto-build of the tool DB at install, automatic drift tracking on SessionStart) are unchanged. The audit scope set in v1.0.0 (user-added MCP / skills / sub-agents) is unchanged.
+- **Plugin-scoped MCP servers** — names like `plugin:everything-claude-code:context7` (with internal colons) are now parsed correctly and their tools enter the catalog. Earlier versions silently collapsed all plugin MCP servers into a single literal `"plugin"`, dropping their tools from Bell's audit
+- **Per-project audit isolation** — the daemon audits against the local DB only; the global DB has been demoted to a description-reuse cache. Tools discovered in *other* projects can never bleed into this project's audit set
+- **Zero-touch catalog** — `spotter install` seeds the tool DB automatically, and SessionStart triggers a background refresh. You never have to maintain the tool list by hand
+- **Audit scope** — only user-added surface (MCP servers / skills / sub-agents). Claude Code's built-in tools are intentionally out of scope; Bell already uses those reliably
+- **Implementation invariants** — no fallbacks, no silent failures, no provisional code (see [§0 in CLAUDE.md](CLAUDE.md))
 
-Full notes: [CHANGELOG](CHANGELOG.md).
+Full release history: [CHANGELOG](CHANGELOG.md).
 
 </details>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-spotter",
-  "version": "1.2.4",
+  "version": "1.3.0",
   "description": "Audit agent running alongside Claude Code that catches missed tool calls — 気づく役と実行する役の分離",
   "type": "module",
   "bin": {

package/src/cli/install.mjs

@@ -28,11 +28,20 @@ const SPOTTER_HOME = join(homedir(), '.spotter');
 
 const MARKER_VERSION = '1';
 
+// v1.2.6: UserPromptSubmit / Stop を 60s に統一。理由:
+// - daemon 側 Haiku timeout は 45s (DEFAULT_HAIKU_TIMEOUT_MS @ daemon.mjs)
+// - hook → daemon IPC 往復・JSON parse・log fsync を加味すると ~50s が上限
+// - Claude Code 本体は settings.json の timeout で hook を kill するので、ここが最も狭い
+// 旧値 (UserPromptSubmit=30 / Stop=15) は v0.13.1 の Haiku timeout 緩和 (30→45s) を
+// 反映しておらず、Chime 等の preamble が大きい (93 KB / 357 件) 環境で daemon が
+// 24-32s かけて正常応答を返している最中に Claude Code 側で hook が timeout で
+// 切られ、ユーザー視点の「チャット入力無反応」を誘発していた。docs/open-issues.md
+// の「install.mjs の hook timeout が v0.13.1 緩和を反映していない」項目を閉じる。
 const HOOK_EVENTS = [
   { event: 'SessionStart', sub: 'session-start', timeout: 5 },
-  { event: 'UserPromptSubmit', sub: 'user-prompt', timeout: 30 },
+  { event: 'UserPromptSubmit', sub: 'user-prompt', timeout: 60 },
   { event: 'PreToolUse', sub: 'pre-tool-use', timeout: 2 },
-  { event: 'Stop', sub: 'stop', timeout: 15 },
+  { event: 'Stop', sub: 'stop', timeout: 60 },
   { event: 'SessionEnd', sub: 'session-end', timeout: 3 },
 ];
 

package/src/daemon/haiku-caller.mjs

@@ -14,13 +14,20 @@
 // puts the catalog only in the first turn's user message; the session retains it for free.
 
 import { spawn } from 'node:child_process';
-import { homedir } from 'node:os';
+import { homedir, tmpdir } from 'node:os';
 import { join } from 'node:path';
-import { mkdir } from 'node:fs/promises';
+import { mkdir, writeFile, unlink, open } from 'node:fs/promises';
 import { randomUUID } from 'node:crypto';
 
 const HAIKU_MODEL = 'claude-haiku-4-5-20251001';
 const WORKDIR = join(homedir(), '.spotter', 'workdir');
+// v1.3.0: Haiku spawn 時に user/project MCP 設定を一切 load させないための空 config。
+// claude CLI の `--strict-mcp-config --mcp-config <path>` に渡せば、`~/.claude.json`
+// (User scope) も `<projectRoot>/.mcp.json` (Project scope) も無視される。Haiku は
+// `{name, description}` カタログ監査しかしないので MCP server は不要 → 起動コスト 0、
+// CPU 飽和 + 孤児 npm exec プロセス累積を根本断ち。
+const EMPTY_MCP_CONFIG_PATH = join(WORKDIR, 'empty-mcp.json');
+const EMPTY_MCP_CONFIG_BODY = '{"mcpServers":{}}';
 
 export class HaikuError extends Error {
   constructor(code, message) {
@@ -33,9 +40,17 @@ export class HaikuError extends Error {
 export async function ensureWorkdir() {
   // §5.2: the workdir is isolated. No CLAUDE.md here.
   await mkdir(WORKDIR, { recursive: true });
+  // v1.3.0: 空 MCP config を idempotent に置く。Haiku spawn 時に `--strict-mcp-config
+  // --mcp-config <path>` で参照させて user/project の MCP server load を完全 disable。
+  // 既存ファイルが内容一致なら write skip でディスク I/O ゼロ。
+  await writeFile(EMPTY_MCP_CONFIG_PATH, EMPTY_MCP_CONFIG_BODY, { encoding: 'utf8' });
   return WORKDIR;
 }
 
+export function emptyMcpConfigPath() {
+  return EMPTY_MCP_CONFIG_PATH;
+}
+
 // Shared header covers BOTH stages — the preamble documents stage=user_input and
 // stage=turn_end so per-turn prompts only need to announce which stage they are.
 //
@@ -231,13 +246,52 @@ export function sanitizeHaikuEnv(baseEnv) {
   return rest;
 }
 
+// v1.3.0: write the wire prompt to a tempfile and return its read-only fd.
+//
+// claude CLI 2.1.x abandons stdin after roughly 3 seconds with no read activity, printing
+// "Warning: no stdin data received in 3s, proceeding without it." and then "Input must be
+// provided either through stdin or as a prompt argument when using --print" before exit
+// 1. With Spotter's full preamble (~93 KB on a project with ~360 catalog entries) the
+// kernel pipe buffer (Linux default 64 KB) fills up; the rest waits for the CLI to drain
+// it. If the CLI's startup (auth + config + plugin discovery) takes longer than 3 s
+// before its first read syscall, it has already given up — even though the parent (Node)
+// is correctly buffering the rest of the prompt.
+//
+// A real file as stdin is always immediately readable to EOF on every platform, sidesteps
+// the pipe-buffer/drain interaction entirely, and removes the timing dependency on CLI
+// startup latency. The tempfile lives in os.tmpdir(); cleanup is best-effort (the OS
+// reclaims it on reboot regardless).
+export async function preparePromptFile(wirePrompt) {
+  if (typeof wirePrompt !== 'string') {
+    throw new TypeError('preparePromptFile: wirePrompt must be a string');
+  }
+  const tmpPath = join(tmpdir(), `spotter-prompt-${process.pid}-${randomUUID()}.txt`);
+  await writeFile(tmpPath, wirePrompt, { encoding: 'utf8' });
+  const handle = await open(tmpPath, 'r');
+  return {
+    tmpPath,
+    fd: handle.fd,
+    close: async () => {
+      try { await handle.close(); } catch (_e) { /* best-effort: child may have closed it */ }
+      try { await unlink(tmpPath); } catch (_e) { /* tmpdir is OS-cleaned; leak is acceptable */ }
+    },
+  };
+}
+
 // On Windows, the `claude` entry is typically a .cmd shim which Node's spawn cannot locate
 // without going through the shell. We use cmd.exe /c explicitly rather than spawn({ shell:
 // true }) because the latter triggers DEP0190 on Node 24+.
-export function buildSpawnArgs({ claudeBin, model, sessionId, resume }) {
-  const args = resume
+//
+// v1.3.0: `--strict-mcp-config --mcp-config <empty>` を必ず付けて MCP load を無効化する。
+// `mcpConfigPath` は呼び出し側 (createHaikuCaller) が必ず渡す前提。テストで shape を pin。
+export function buildSpawnArgs({ claudeBin, model, sessionId, resume, mcpConfigPath }) {
+  if (typeof mcpConfigPath !== 'string' || mcpConfigPath.length === 0) {
+    throw new TypeError('buildSpawnArgs: mcpConfigPath must be a non-empty string');
+  }
+  const baseArgs = resume
     ? ['-p', '--resume', sessionId, '--model', model]
     : ['-p', '--session-id', sessionId, '--model', model];
+  const args = [...baseArgs, '--strict-mcp-config', '--mcp-config', mcpConfigPath];
   if (process.platform === 'win32') {
     return { cmd: 'cmd.exe', cmdArgs: ['/c', claudeBin, ...args] };
   }
@@ -267,38 +321,42 @@ export function createHaikuCaller({ preamble, timeoutMs, claudeBin = 'claude', m
   const callHaiku = async function (prompt) {
     await ensureWorkdir();
     const wirePrompt = (isFirstCall && preamble) ? `${preamble}\n\n${prompt}` : prompt;
+    // v1.3.0: stdin is a tempfile fd, not a pipe. See preparePromptFile for the why.
+    const promptFile = await preparePromptFile(wirePrompt);
     return new Promise((resolve, reject) => {
       const { cmd, cmdArgs } = buildSpawnArgs({
         claudeBin,
         model,
         sessionId: currentSessionId,
         resume: !isFirstCall,
+        mcpConfigPath: EMPTY_MCP_CONFIG_PATH,
       });
       const child = spawn(cmd, cmdArgs, {
         cwd: WORKDIR,
         env: { ...sanitizeHaikuEnv(env), SPOTTER_PARENT_PID: String(process.pid) },
-        stdio: ['pipe', 'pipe', 'pipe'],
+        stdio: [promptFile.fd, 'pipe', 'pipe'],
         windowsHide: true,
       });
       let stdout = '';
       let stderr = '';
       let settled = false;
 
-      // v0.13.2: absorb EPIPE/ECONNRESET on stdio streams. We end(prompt) and
-      // then kill() on timeout — if the write hadn't drained yet, the unflushed
-      // stream can emit 'error' after kill. Today's Node doesn't crash on
-      // unhandled stdin errors, but the docs don't guarantee that, and this
-      // listener removes a potential silent-death path.
+      // child.stdin is null when stdio[0] is a raw fd; only stdout/stderr remain to guard.
       const noop = () => {};
-      child.stdin.on('error', noop);
       child.stdout.on('error', noop);
       child.stderr.on('error', noop);
 
+      const settleAfterCleanup = (fn) => {
+        promptFile.close().finally(fn);
+      };
+
       const timer = setTimeout(() => {
         if (settled) return;
         settled = true;
         child.kill();
-        reject(new HaikuError('E_HAIKU_TIMEOUT', `haiku did not respond within ${timeoutMs}ms`));
+        settleAfterCleanup(() => reject(
+          new HaikuError('E_HAIKU_TIMEOUT', `haiku did not respond within ${timeoutMs}ms`)
+        ));
       }, timeoutMs);
 
       child.stdout.on('data', (chunk) => { stdout += chunk.toString('utf8'); });
@@ -308,25 +366,27 @@ export function createHaikuCaller({ preamble, timeoutMs, claudeBin = 'claude', m
         if (settled) return;
         settled = true;
         clearTimeout(timer);
-        reject(new HaikuError('E_INTERNAL', `failed to spawn ${claudeBin}: ${err.message}`));
+        settleAfterCleanup(() => reject(
+          new HaikuError('E_INTERNAL', `failed to spawn ${claudeBin}: ${err.message}`)
+        ));
       });
 
       child.on('close', (code) => {
         if (settled) return;
         settled = true;
         clearTimeout(timer);
-        if (code !== 0) {
-          reject(new HaikuError('E_INTERNAL', `haiku exited with code ${code}: ${truncate(stderr)}`));
-          return;
-        }
-        // Flip isFirstCall only after a successful spawn — a failed first call should
-        // still be treated as "preamble not yet delivered" so the next attempt re-sends
-        // the full prelude against a fresh --session-id (not --resume a non-existent one).
-        isFirstCall = false;
-        resolve(stdout);
+        settleAfterCleanup(() => {
+          if (code !== 0) {
+            reject(new HaikuError('E_INTERNAL', `haiku exited with code ${code}: ${truncate(stderr)}`));
+            return;
+          }
+          // Flip isFirstCall only after a successful spawn — a failed first call should
+          // still be treated as "preamble not yet delivered" so the next attempt re-sends
+          // the full prelude against a fresh --session-id (not --resume a non-existent one).
+          isFirstCall = false;
+          resolve(stdout);
+        });
       });
-
-      child.stdin.end(wirePrompt, 'utf8');
     });
   };
 

package/src/tool-db/investigate-mcp.mjs

@@ -96,17 +96,25 @@ export async function listMcpServers({ claudeBin = 'claude', projectRoot } = {})
 //   "<name>: <command> <args...> - <status>"
 // We don't need full parsing — we just need the name and to know if it's an HTTP url
 // or a stdio command. For stdio we will re-query `claude mcp get <name>` for proper args.
+//
+// Splitter: ": " (colon + SPACE), not ":" alone. Plugin-style server names contain
+// internal colons — e.g. "plugin:everything-claude-code:context7" — and a bare
+// `indexOf(':')` collapses six distinct ECC plugin MCPs into the literal string
+// "plugin", causing `claude mcp get plugin` to fail and silently dropping the
+// servers' tools from the catalog. Server names cannot contain a literal ": "
+// (colon + space) because the CLI uses that exact pair as the line delimiter, so
+// `indexOf(': ')` is safe even for names with spaces (e.g. "claude.ai Google Drive").
 export function parseMcpListOutput(text) {
   const out = [];
   for (const line of text.split('\n')) {
     const trimmed = line.trim();
     if (trimmed.length === 0) continue;
     if (trimmed.startsWith('Checking') || trimmed.startsWith('Note:')) continue;
-    // Format: "<name>: <rest>"
-    const colonIdx = trimmed.indexOf(':');
-    if (colonIdx <= 0) continue;
-    const name = trimmed.slice(0, colonIdx).trim();
-    const rest = trimmed.slice(colonIdx + 1).trim();
+    // Format: "<name>: <rest>" — split on ": " (colon + space), see comment above.
+    const sepIdx = trimmed.indexOf(': ');
+    if (sepIdx <= 0) continue;
+    const name = trimmed.slice(0, sepIdx).trim();
+    const rest = trimmed.slice(sepIdx + 2).trim();
     // skip the trailing " - ✓ Connected" / " - ✗ Failed"
     const dashIdx = rest.lastIndexOf(' - ');
     const beforeStatus = dashIdx > 0 ? rest.slice(0, dashIdx).trim() : rest;
@@ -115,8 +123,24 @@ export function parseMcpListOutput(text) {
       const url = beforeStatus.replace(/\s*\(HTTP\)$/, '').trim();
       out.push({ name, transport: isHttp ? 'http' : 'sse', url });
     } else {
-      // stdio — defer to `claude mcp get` for properly-tokenized command/args.
-      out.push({ name, transport: 'stdio' });
+      // stdio — extract command + args directly from the CLI line. Plugin-scoped
+      // servers (e.g. "plugin:everything-claude-code:context7") cannot be re-
+      // queried via `claude mcp get` (CLI returns "No MCP server found with
+      // name: ..." even though `mcp list` shows them), so the list line is the
+      // only authoritative source for these. Bare-name servers also work this
+      // way: tokenisation is naive (whitespace-only, matches splitArgs in
+      // getStdioConfig) and matches the existing constraint that command paths
+      // must not contain spaces.
+      const tokens = beforeStatus.split(/\s+/).filter((t) => t.length > 0);
+      // tokens.length === 0 means the CLI emitted "<name>: " followed by only
+      // status text (or nothing) — a malformed entry we cannot spawn anyway.
+      // We `continue` rather than throw so a single broken line cannot poison
+      // refresh for all the other healthy servers in the same `mcp list`. The
+      // fact that this entry was dropped is recoverable: the next refresh re-
+      // reads the CLI from scratch. This is the same "skip one server, log
+      // through listMcpToolsAll" treatment the rest of the path uses.
+      if (tokens.length === 0) continue;
+      out.push({ name, transport: 'stdio', command: tokens[0], args: tokens.slice(1) });
     }
   }
   return out;