docs: tmux 追随フックの生存確認を接続ベースに修正

[takemi-ohama]

概要

#100 で devbase 側の IPC ソケット判定を connect ベースにしましたが、ドキュメントが配っている tmux プロンプトフックのサンプルは test -S のままで、同じ穴が残っていました。実環境でこれが原因となり、#100 のマージ後も devbase up --open が自動で開かない状態が続いていたため修正します。

症状と原因

~/.tmux.conf の update-environment は正しく効いていて、tmux のセッション環境には生きたソケットが入っています。それでも既に動いているペインのシェルだけが古い値を持ち続けていました。

層	VSCODE_IPC_HOOK_CLI	状態
tmux セッション環境	...8dd26478...	ALIVE
実行中のペインのシェル	...8d9a04ee...	DEAD（孤児）

橋渡しをするはずのプロンプトフックが、次の guard で早期 return していたためです。

[ -n"${VSCODE_IPC_HOOK_CLI:-}" ] && [ -S"${VSCODE_IPC_HOOK_CLI}" ] &&return 0

-S はファイルの種別しか見ないので、VS Code の異常終了で残った孤児ソケットも通過します。ls でも test -S でも生きているものと区別が付かず、生死の判定には実際の接続が必要です。

tmux セッションの作成時刻と死んだソケットの mtime が一致することからも裏付けが取れました。

tmux セッション	作成	対応する死んだソケット
devbase-1 / devbase-2	08-16 04:14	8d9a04ee / 846482f8（同時刻）
devbase-3 / devbase-4	08-19 10:06 / 10:12	5656afb6 / 8c041b39（08-19 10:06）

変更点

• サンプルの guard に nc -U -w 1 <sock> </dev/null による接続確認を追加
• -S は前段に残す。ソケットファイルが無い一般ケースでは追加のプロセスを起こさないため
• 本文に「ls でも test -S でも見分けが付かない」旨を明記
• CHANGELOG に Fixed エントリを追加

nc のフラグについて

macOS の nc は -z を付けると Unix ドメインソケットで誤判定します。生きているソケットに対しても rc=1 を返すため、-z は付けていません。

コマンド	生存ソケット	孤児ソケット
nc -z -U <sock>	rc=1（誤判定）	rc=1
nc -U -w 1 <sock> </dev/null	rc=0	rc=1

動作確認

• ドキュメントの bash スニペットを抽出して bash -n — 構文 OK
• 実環境の ~/.bash_profile に同じ修正を適用し、関数を直接呼んで検証
  • 孤児ソケットを持った状態 → 8d9a04ee から生きている 8dd26478 へ拾い直す
  • 生きたソケットを持った状態 → 値は変化せず、無駄な拾い直しをしない
• nc の挙動を実測（上表）
• ruff check --select=E9,F63,F7,F82 lib（CI と同じ引数）— All checks passed