fix: 古い VSCODE_IPC_HOOK_CLI で devbase up --open が無言失敗する問題を修正

[takemi-ohama]

Pull Request

概要

tmux / screen のセッションを再利用している端末や、VS Code のウィンドウをリロードした後の古いシェルでは、VSCODE_IPC_HOOK_CLI が すでに削除されたソケット ($TMPDIR/vscode-ipc-<uuid>.sock) を指したまま残ります。

従来の detect_context() は 変数の有無だけ で VS Code 統合ターミナルと判定していたため、devbase up --open はこの状態で launch を選び、code が死んだソケットへ接続を試みて失敗していました。さらに _launch() が stderr を DEVNULL に捨てていたため、何も起きないがエラーも出ない という最も切り分けづらい失敗になっていました。

ソケットの実在を確認したうえで判定し、古い場合は理由を warning に出して「手元で実行するコマンドの提示」へ degrade します。

関連 Issue

• Closes #

変更点

• lib/devbase/editor/opener.py
  • _ipc_socket_alive() を追加し、VSCODE_IPC_HOOK_CLI が実在するソケットを指す場合のみ in_vscode=True にする
  • detect_context() / open_editor() にテスト用差し替え口 ipc_alive を追加
  • 変数だけ残って実体が消えている場合は原因（tmux 再アタッチ / ウィンドウリロード）を warning で明示
  • _launch() の stderr を握り潰さず親へ継承する（code は IPC 接続失敗の理由を stderr にのみ出すため）
• docs/user/environment-variables.md
  • 判定表に「tmux / screen 経由のターミナル」の行を追加
  • 「tmux / screen 経由で使う場合」節を追加。仕組みの説明と、set -ga update-environment による追随設定、既存ペイン向けのプロンプトフック、tmux kill-server での反映手順を記載
• tests/editor/test_opener.py
  • 生きたソケット / 消えたソケット / ipc_alive 明示のケースを追加
  • 死んだ IPC ソケット + SSH で print_command へ degrade し、原因が分かるログが出ることを検証する回帰テストを追加
• CHANGELOG.md に Fixed エントリを追加

動作確認

• pytest tests/editor/test_opener.py が green（81 passed）
• 全テストスイートが green（1232 passed）
• tmux セッション再アタッチ後の端末で devbase up --open を実行し、warning とコマンド提示が出ることを確認
• ドキュメント (docs/user/environment-variables.md) を更新した
• CI が green である

スクリーンショット・ログ（任意）

$ .venv/bin/pytest tests/editor/test_opener.py -q
81 passed in 0.19s
$ .venv/bin/pytest -q
1232 passed in 39.66s

補足

_ipc_socket_alive() は os.path.exists() で判定しています（ソケットが「存在するが応答しない」ケースまでは検出しません）。実際に問題となっていたのは ファイル自体が消えている パターンで、接続可能性まで確かめるには code を実行するしかないため、ここでは安価な存在確認に留めています。

_launch() は非ブロッキング起動のため、stderr のメッセージは up の出力に遅れて混ざり得ますが、無言の失敗よりは有用と判断しました。

[takemi-ohama]

🤖 cross-review | round 1 | codex | APPROVE

修正を求める指摘はありません。

[takemi-ohama]

🤖 cross-review | round 1 | gemini | APPROVE

IPC ソケットの実在確認によって tmux 等での無言失敗を防ぐ堅牢な改善です。1点だけ標準ライブラリの仕様に伴う冗長な記述について提案しました。