黒執事（Butler Layer)

調査報告（2026-03-20 13:00 頃実施）¶

報告者: Claude Code (Opus 4.6)

発生状況¶

• セッション中に butler__submit_task で git_commit を投入
• MCP ツール呼び出しが応答なく延々と待ち状態になった
• ユーザーが手動でキャンセル

診断結果¶

プロセス状態¶

PID 不一致の構造¶

• butler/main.py の _write_pid() は os.getpid() を書く
• Python プロセスの PID (6056) が書かれるが、MCP 通信を受ける fastmcp.exe (31048) とは別プロセス
• PID 6056 は起動後に消滅 → PID ファイルが孤立

MCP 接続状態¶

• butler__list_skills() → MCP error -32000: Connection closed
• fastmcp.exe プロセスは存在するが MCP 通信チャネルが死んでいる

ハングの推定メカニズム¶

1. git_commit は同期実行パス（should_submit_synchronously() = true）
2. 同期パスでは _orchestrator_mod.run_task() の完了を待つ
3. MCP 接続が切れている状態で呼び出すと、応答が返らずハングする

追加の発見事項¶

• ~/.claude/secrets/env.sh に REDMINE_URL と REDMINE_TOKEN が未設定（Butler 障害時のフォールバック不可）
• Butler のログ出力先が不明（*.log ファイルが見つからない）

未解明の点¶

• PID 6056 がなぜ消滅したか
• MCP チャネルがいつ切れたか
• Butler のログ永続化の仕組みが無い

提案する対策¶

短期: fastmcp 再起動、env.sh に REDMINE 環境変数追加
中期: PID ファイルに fastmcp の PID を書く、ログ永続化、MCP 健全性チェック（heartbeat/timeout）