From 86d20958e0113738fe1e8ba47dc1a42ae4416525 Mon Sep 17 00:00:00 2001
From: "takemi.ohama" <takemi.ohama@gmail.com>
Date: Thu, 20 Aug 2026 00:54:26 +0900
Subject: [PATCH] =?UTF-8?q?docs:=20tmux=20=E8=BF=BD=E9=9A=8F=E3=83=95?=
 =?UTF-8?q?=E3=83=83=E3=82=AF=E3=81=AE=E7=94=9F=E5=AD=98=E7=A2=BA=E8=AA=8D?=
 =?UTF-8?q?=E3=82=92=E6=8E=A5=E7=B6=9A=E3=83=99=E3=83=BC=E3=82=B9=E3=81=AB?=
 =?UTF-8?q?=E4=BF=AE=E6=AD=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

PR #100 で devbase 側の判定は connect ベースにしたが、docs が配っている tmux
プロンプトフックのサンプルは `test -S` のままだった。-S はファイルの種別しか見ない
ため、VS Code の異常終了で残った listen していない孤児ソケットも通過してしまい、
フックが tmux show-environment からの拾い直しを早期 return でスキップする。

その結果、tmux セッション環境には生きたソケットが入っているのに、すでに動いている
ペインのシェルだけが古い値を持ち続け、`devbase up --open` が毎回「手元で実行する
コマンドの提示」へ degrade していた（実機で再現を確認）。

- サンプルの guard に `nc -U -w 1 <sock> </dev/null` による接続確認を追加。
  macOS の nc は -z を付けると Unix ドメインソケットで誤判定するため付けない
  (生存ソケットで rc=1 になることを実測)
- -S を前段に残し、ソケットファイルが無い一般ケースでは nc を起動しないままにする
- 孤児ソケットは ls でも test -S でも見分けが付かない旨を本文に明記
- CHANGELOG に Fixed エントリを追加

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01622CAKyYfonYuZ6AqRJvDg
---
 CHANGELOG.md                       |  8 ++++++++
 docs/user/environment-variables.md | 14 ++++++++------
 2 files changed, 16 insertions(+), 6 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index ccb7ee6..87c6dcc 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -90,6 +90,14 @@
   `. <DEVBASE_ROOT>/bin/rc` に書き換えてください。
 
 ### Fixed
+- **tmux 追随フックのサンプル（`docs/user/environment-variables.md`）が孤児ソケットを
+  検出できない**問題を修正しました。`test -S` はファイルの種別しか見ないため、VS Code の
+  異常終了で残った listen していないソケットも「生きている」と判定し、フックが
+  `tmux show-environment` からの拾い直しを早期 return でスキップしていました。
+  結果として `devbase up --open` が毎回「手元で実行するコマンドの提示」へ degrade します。
+  `nc -U -w 1 <sock> </dev/null` による接続確認を後段に足しました（macOS の `nc` は
+  `-z` を付けると Unix ドメインソケットで誤判定するため付けません）。`-S` を前段に
+  残しているので、ソケットファイルが無い一般ケースでは従来どおり追加のプロセスは起きません。
 - **VS Code の異常終了後に残った IPC ソケットで `devbase up --open` が
   `ECONNREFUSED` で失敗する問題を修正**しました。`VSCODE_IPC_HOOK_CLI` が指す
   ソケットの死に方には「ファイルごと消えている」ほかに「ファイルは残っているが
diff --git a/docs/user/environment-variables.md b/docs/user/environment-variables.md
index 29634b9..4815297 100644
--- a/docs/user/environment-variables.md
+++ b/docs/user/environment-variables.md
@@ -203,7 +203,7 @@ devbase は**実際にソケットへ接続できるかを確認**してから V
 | ファイルごと消えている | VS Code のウィンドウを正常に閉じた（VS Code が削除する） | 無し |
 | ファイルは残っているが listen していない | VS Code のクラッシュ・強制終了・OS 再起動で後始末されなかった | **有り** |
 
-後者は `$TMPDIR` に孤児ソケットとして溜まり、接続しようとすると `ECONNREFUSED` になります。`ls` では生きているものと見分けが付きません。
+後者は `$TMPDIR` に孤児ソケットとして溜まり、接続しようとすると `ECONNREFUSED` になります。`ls` でも `test -S` でも生きているものと見分けが付かないため、**生死の判定には実際の接続が要ります**。
 
 自動で開く状態に戻すには、tmux 側に環境変数を追随させます。`~/.tmux.conf` に以下を追記してください。
 
@@ -216,11 +216,13 @@ set -ga update-environment " VSCODE_IPC_HOOK_CLI VSCODE_GIT_IPC_HANDLE VSCODE_GI
 ```bash
 if [ -n "${TMUX:-}" ]; then
   _vscode_sync_env() {
-    # ソケットが生きている間は何もしない（サブプロセスを起動しない）。
-    # 注意: -S はファイルの種別しか見ないため、listen していない孤児ソケットは
-    # 「生きている」と判定されてしまう。この guard に引っかかって追随しない場合は
-    # 行ごと削除して、毎回 tmux show-environment で同期する。
-    [ -n "${VSCODE_IPC_HOOK_CLI:-}" ] && [ -S "${VSCODE_IPC_HOOK_CLI}" ] && return 0
+    # ソケットが生きている間は拾い直さない。生存確認は 2 段で行う。
+    # -S はファイルの種別しか見ないため、listen していない孤児ソケットも
+    # 通過してしまう（上表の 2 つめ）。実際に接続できるかまで確認する。
+    # -S を前段に置くことで、ファイルが無い一般ケースでは nc を起動しない。
+    # macOS の nc は -z を付けると Unix ソケットで誤判定するので付けないこと。
+    [ -n "${VSCODE_IPC_HOOK_CLI:-}" ] && [ -S "${VSCODE_IPC_HOOK_CLI}" ] \
+      && nc -U -w 1 "${VSCODE_IPC_HOOK_CLI}" </dev/null >/dev/null 2>&1 && return 0
     local line
     while IFS= read -r line; do
       case "$line" in