From 08eab0f2db99256452da76e06b0ba25e1d42cba8 Mon Sep 17 00:00:00 2001
From: "takemi.ohama" <takemi.ohama@gmail.com>
Date: Thu, 24 Sep 2026 20:16:11 +0900
Subject: [PATCH 1/8] =?UTF-8?q?=E8=A8=AD=E8=A8=88(PLAN71):=20prefix=20S=20?=
 =?UTF-8?q?=E3=81=AE=E4=B8=80=E8=A6=A7=E3=81=A8=E3=83=A1=E3=83=8B=E3=83=A5?=
 =?UTF-8?q?=E3=83=BC=E3=82=92=E3=82=B3=E3=83=9E=E3=83=B3=E3=83=89=20tmux-m?=
 =?UTF-8?q?enu=20=E3=81=8B=E3=82=89=E3=82=82=E9=96=8B=E3=81=8F=20(#270)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 issues/PLAN71_tmux-menu-design.md | 203 ++++++++++++++++++++++++++++++
 issues/PLAN71_tmux-menu.md        | 132 +++++++++++++++++++
 2 files changed, 335 insertions(+)
 create mode 100644 issues/PLAN71_tmux-menu-design.md
 create mode 100644 issues/PLAN71_tmux-menu.md

diff --git a/issues/PLAN71_tmux-menu-design.md b/issues/PLAN71_tmux-menu-design.md
new file mode 100644
index 00000000..0ace376d
--- /dev/null
+++ b/issues/PLAN71_tmux-menu-design.md
@@ -0,0 +1,203 @@
+# PLAN71: prefix S のセッションの一覧とメニューをコマンド tmux-menu からも開く の設計
+
+要求と受け入れ条件は [PLAN71_tmux-menu.md](PLAN71_tmux-menu.md) にある。この文書は
+「どう作るか」だけを扱う。土台の `tmux-session` の設計は PLAN69 にある。確定仕様は
+[docs/specifications/tmux-named-session.md](../docs/specifications/tmux-named-session.md) である。
+
+## 機能一覧
+
+| # | 機能 | 誰が使うか |
+| --- | --- | --- |
+| F1 | tmux の中で `tmux-menu` を打つと、今の pane にセッションの一覧を出す。選ぶと `prefix S` と同じメニューが出る | tmux の中にいる利用者 |
+| F2 | tmux の外で `tmux-menu` を打つと、attach と同時に一覧を出す | tmux の外にいる利用者 |
+| F3 | `prefix S` を F1 と同じ定義で開く（一覧を開く定義を 1 か所にする） | tmux の中にいる利用者 |
+| F4 | F1〜F3 を base イメージへ入れ、ホストで使う手順を示す | base を建てる利用者と、ホストの tmux の利用者 |
+
+## 構成要素
+
+| 要素 | 変更 | 責務 |
+| --- | --- | --- |
+| `containers/base/tmux-session` | 変える | 呼ばれた名前 `tmux-menu` を `menu` へ振り分ける。`menu` がセッションを受け取らないときは一覧を開く（決定 1）。一覧を開く `choose-tree` の定義をこのファイルだけに持つ（決定 2） |
+| `containers/base/tmux.conf` | 変える | `prefix S` の行を `run-shell` で `tmux-menu` を呼ぶ形に変える（決定 2） |
+| `containers/base/Dockerfile` の「tmux セッションの整理コマンド」の節 | 変える | symlink の `RUN` に `tmux-menu` を 1 つ足す |
+| `tests/containers/test_tmux_session.py` | 変える | F1・F2・F3 と、`menu -c 端末 <セッション>` の形が変わらないことを確かめる。Dockerfile の symlink の形を固定する（`SHORT_NAMES` に `tmux-menu` を足す） |
+| `tests/containers/test_tmux_conf.py` | 変える | `prefix S` の割り当てが `tmux-menu` を呼ぶことを `list-keys` で確かめる |
+| `docs/user/environment-variables.md` の「セッションを名指しで扱う」 | 変える | `tmux-menu` の使い方を足す。ホストの手順の symlink を 5 つにし、`~/.tmux.conf` の行を新しい割り当てへ差し替える |
+| `docs/specifications/tmux-named-session.md` | 変える（確定仕様化で） | `menu` の 2 つの形と `tmux-menu`、`prefix S` の新しい行 |
+| `CHANGELOG.md` | 変える | `[Unreleased]` の `### Added` に足す。反映に `devbase build base --no-cache` が要ることを書く |
+
+次のものは変えない。
+
+- `tmux-session` の `go` / `peek` / `kill` と、`menu -c 端末 <セッション>` が出すメニューの中身
+- `containers/base/tmux-first` / `containers/base/tmux-clean`
+- `prefix s`（tmux の既定の `choose-tree -Zs`）
+
+## 決定の記録
+
+### 決定 1: `tmux-menu` は `menu` サブコマンドの短縮名にし、セッションを受け取らない形を一覧を開く動きにする
+
+利用者が決めた名前 `tmux-menu` と、サブコマンドの名前 `menu` がそろう。`tmux-go` = `go` と同じ
+規則で読める。今の `menu -c 端末 <セッション>` はセッションを必ず受け取るため、受け取らない
+形は空いている。空いた形に一覧を割り当てれば、今の形の呼び出し元（今の `/etc/tmux.conf` と
+ホストへ写した行）は何も変えずに動く。
+
+新しいサブコマンド（`ui` など）を足して `tmux-menu` をそちらへ振り分ける案は採らない。
+`tmux-menu` と `menu` が別の動きになり、名前から動きが読めない。今の `menu` を別名へ改名する
+案も採らない。ホストへ写した `~/.tmux.conf` の行が壊れる。
+
+### 決定 2: 一覧を開く定義は `tmux-session` だけに持ち、`prefix S` は `run-shell "tmux-menu"` で呼ぶ
+
+`prefix S` と `tmux-menu` が同じ一覧を開くことを、定義を 1 つにして保つ。2 か所に同じ template を
+持つと、片方だけを直したときに 2 つの入口の動きが分かれる。実測のとおり、template を
+`run-shell` の文字列へ直接書く形は `#{…}` の先の展開で壊れる。スクリプトの中に置けば
+`run-shell` の展開を通らない。ホストの手順も `~/.tmux.conf` の 1 行が短くなる。
+
+`prefix S` の行を今のまま残し、`tmux-session` にも同じ template を書く案は採らない。一致を
+テストで縛ることはできるが、同じ文字列を 2 か所で持つこと自体が残る。
+
+### 決定 3: tmux の外では attach 先を引数で取らない
+
+名前の決まったセッションへ行くなら `tmux-go` がある。`tmux-menu` は「まず一覧を見る」入口で、
+attach 先は tmux の既定（直近のセッション）で足りる。一覧からどのセッションへも移れる。
+セッションを引数で取ると、決定 1 の「セッションを受け取るかで 2 つの形を分ける」規則が崩れる。
+
+## 実測（2026-09-24、ホストの tmux 3.7b）
+
+専用のソケットでサーバを立て、`python3` の `pty` で端末を attach した。`tmux-session` の代わりに
+引数を書き出すだけの偽物を置き、一覧で 1 つ上のセッションを選んで Enter を押した。選んだ
+セッションの名前は `it's`（`'` を含む）である。
+
+| 開き方 | `menu` へ渡った引数 | 判定 |
+| --- | --- | --- |
+| tmux の中のプロンプトで `tmux choose-tree -Zs -O name '<template>'` を打つ。別のセッションにも端末を 1 つ繋いでおく | `menu -c <押した端末> <選んだ ID>` | 正しい |
+| tmux の外で `tmux attach \; choose-tree -Zs -O name '<template>'` | `menu -c <押した端末> <選んだ ID>`。attach 先は直近のセッション | 正しい |
+| `bind-key S run-shell "tmux choose-tree … '<template>'"`（template を `run-shell` の文字列へ直接埋め込む） | `menu -c <押した端末>` だけ。ID が消えた | **誤り** |
+| `bind-key S run-shell '<スクリプト>'`。スクリプトが `tmux choose-tree -Zs -O name '<template>'` を実行する | `menu -c <押した端末> <選んだ ID>` | 正しい |
+
+`<template>` は今の `prefix S` の行と同じ次の文字列である。
+
+```tmux
+run-shell -t "%%%" "tmux-session menu -c #{q:client_name} #{q:session_id}"
+```
+
+- **`run-shell` は、渡された文字列の `#{…}` をシェルへ渡す前に展開する。** 3 行目で ID が
+  消えたのはこのためである。4 行目ではスクリプトの本文が `run-shell` の展開を通らないため、
+  template は `choose-tree` へそのまま届く
+- `run-shell` から起動したシェルでは `TMUX` はあり、`TMUX_PANE` は無かった。`choose-tree` は
+  `-t` なしで、キーを押した端末が見ている pane に一覧を出した
+
+## 入出力の契約
+
+### コマンドの形
+
+```text
+tmux-session menu                        一覧を開く（新しい形）
+tmux-session menu -c 端末 <セッション>   メニューを出す（今の形。変えない）
+tmux-menu                                = tmux-session menu
+共通: -h / --help で使い方を出して終了コード 0
+```
+
+`menu` の 2 つの形は、**セッションを受け取るかどうか**で分ける。
+
+| 引数 | 動き |
+| --- | --- |
+| 無し | 一覧を開く |
+| `-c 端末` と `<セッション>` 1 つ | 今と同じメニュー |
+| `<セッション>` があり `-c` が無い | 終了コード 2（今と同じ「menu には -c が要ります」） |
+| `-c 端末` だけでセッションが無い | 終了コード 2（「セッションを指定してください」） |
+| セッションが 2 つ以上 | 終了コード 2（今と同じ） |
+| 知らないオプション | 終了コード 2（今と同じ） |
+
+`tmux-menu` は `tmux-go` などと同じく、呼ばれた名前で `menu` のサブコマンドとして動く。
+`tmux-menu -c 端末 <セッション>` も今の形のメニューを出す。
+
+### 一覧を開く形の動き
+
+| 状況 | 動き | 終了コード |
+| --- | --- | --- |
+| tmux が無い | 標準エラーへ「tmux が見つかりません」 | 1 |
+| サーバが無い | 標準エラーへ「tmux サーバが起動していません」。サーバもセッションも作らない | 1 |
+| tmux の中（`TMUX` がある） | `TMUX_PANE` があれば `-t "$TMUX_PANE"` を付けて `choose-tree` を実行する。無ければ `-t` を付けない（`run-shell` から呼ばれた場合） | `choose-tree` の終了コード |
+| tmux の外 | `exec tmux attach-session \; choose-tree …`。attach 先は tmux の既定（直近のセッション） | `tmux` の終了コード |
+
+`choose-tree` の引数は今の `prefix S` と同じにする。
+
+```sh
+choose-tree -Zs -O name "run-shell -t \"%%%\" \"tmux-session menu -c #{q:client_name} #{q:session_id}\""
+```
+
+## `/etc/tmux.conf` の割り当てと互換性
+
+### 割り当て
+
+```tmux
+# prefix S: セッションを選び、移る・中身を見る・落とすのメニューを出す (#234 / #270)。
+# 一覧の定義は tmux-session にある (tmux-menu と同じ)。run-shell は渡した文字列の #{…} を
+# 先に展開するため、template をここへ書かずにコマンドを呼ぶ。
+bind-key S run-shell "tmux-menu"
+```
+
+### 互換性
+
+- **`menu -c 端末 <セッション>` の形を変えない。** 今の `/etc/tmux.conf` の template と、
+  利用者がホストの `~/.tmux.conf` へ写した今の行は、この形を呼ぶ。変えると、`git pull` した
+  ホストで `prefix S` のメニューが開かなくなる
+- ホストで今の行を残した利用者も、`tmux-menu` の symlink を足せば `tmux-menu` を使える。
+  `prefix S` は今の行のまま動く
+
+## 処理の流れ
+
+```mermaid
+sequenceDiagram
+    actor U as 利用者
+    participant C as tmux-menu（tmux-session menu）
+    participant T as tmux サーバ
+    participant M as tmux-session menu -c … ID
+    alt tmux の中でコマンドを打つ
+        U->>C: tmux-menu
+        C->>T: choose-tree -t TMUX_PANE …
+    else prefix S
+        U->>T: prefix S
+        T->>C: run-shell "tmux-menu"
+        C->>T: choose-tree …（-t なし）
+    else tmux の外
+        U->>C: tmux-menu
+        C->>T: exec tmux attach \; choose-tree …
+    end
+    T-->>U: セッションの一覧
+    U->>T: 選んで Enter
+    T->>M: run-shell -t "=名前:"<br/>menu -c 押した端末 ID
+    M->>T: display-menu（移る a / 中身を見る p / 落とす k）
+```
+
+Enter の後は PLAN69 の `menu` の流れと同じである。
+
+## テスト設計
+
+受け入れ条件の番号は [PLAN71_tmux-menu.md](PLAN71_tmux-menu.md) のもの。テストは
+`test_tmux_session.py` の流儀（専用のソケット、`pty` の端末、偽の `tmux-session`）に合わせる。
+
+| 受け入れ条件 | 何で確かめるか |
+| --- | --- |
+| 1 | tmux の中の端末のプロンプトへ `tmux-menu` を打ち、その端末の `#{pane_mode}` が `tree-mode` になることを見る |
+| 2 | 1 の後に 1 つ上を選んで Enter を押し、偽の `tmux-session` へ `menu -c <押した端末> <選んだ ID>` が渡ることを見る。`'` を含む名前を含める |
+| 3 | 本物の `tmux-session` で 1 → 選ぶ → `a` を送り、押した端末が選んだセッションへ移り、そこに繋がっていた他の端末が外れることを `list-clients` で見る |
+| 4 | tmux の外の端末で `tmux-menu` を起動し、端末がサーバに繋がり `tree-mode` になることを見る |
+| 5 | 4 の後に 2 と同じく選んで Enter を押し、`menu -c <その端末> <選んだ ID>` が渡ることを見る |
+| 6 | サーバの無い環境で `tmux-menu` を実行し、終了コード 1・標準エラーの理由・実行後もサーバが無いことを見る |
+| 7 | 既存の `menu` のテスト（`test_menu_*`）がそのまま通る |
+| 8 | `tmux-menu` と `tmux-session menu` で 1・6 を両方の名前で走らせる（parametrize） |
+| 9 | `-c` だけ・余分な引数・知らないオプションで終了コード 2。`tmux-menu -h` が 0 で、`tmux-session -h` の出力に `tmux-menu` が含まれる |
+| 10 | Dockerfile の symlink の `RUN` に `tmux-menu` が含まれることを固定する（`test_dockerfile_links_short_names`）。建てたイメージで `command -v tmux-menu` を見る |
+| 11 | `tmux.conf` を読んだ tmux の `list-keys -T prefix` の `S` が `run-shell tmux-menu` であることを見る。既存の `test_prefix_s_passes_selected_id_and_client` と `test_menu_*`（`prefix S` から開く）がそのまま通る。`prefix s` は既定のまま |
+| 12 | `git diff --stat main` に `tmux-first` / `tmux-clean` が現れない |
+| 13 | `shellcheck containers/base/tmux-*` と全体の pytest |
+| 14 | 文書の差分をレビューで見る |
+
+## 未確認のまま残ること
+
+| 項目 | 内容 |
+| --- | --- |
+| コンテナの tmux 3.6 での 4 つの開き方 | 実測はホストの 3.7b だけ。`attach \; choose-tree` と `run-shell` からの `choose-tree` は 3.6 でも使える機能だが、建てたイメージで確かめるのは実装の後 |
+| 複数の端末が同じセッションの別々のウィンドウを見ているときの `prefix S` | `run-shell` からの `choose-tree` は `-t` なしで、そのセッションの今のウィンドウの pane に出る。1 つのセッションには今のウィンドウが 1 つしか無いため、押した端末とは別のウィンドウに一覧が出ることは無い見込み。実装でテストを 1 つ足して確かめる |
+| 人が実際の端末で操作する確認 | 条件 1〜5 の人手の確認。リリース後テストへ回す |
diff --git a/issues/PLAN71_tmux-menu.md b/issues/PLAN71_tmux-menu.md
new file mode 100644
index 00000000..a8cb3bd1
--- /dev/null
+++ b/issues/PLAN71_tmux-menu.md
@@ -0,0 +1,132 @@
+# PLAN71: prefix S のセッションの一覧とメニューをコマンド tmux-menu からも開く
+
+対象 issue: devbasex/devbase#270
+
+- ワークフローモード: `standard`
+  - 根拠: base イメージに新しいコマンド `tmux-menu`（公開インタフェース）が加わり、
+    `tmux-session` の振る舞いが増える。変更は base を建て直した全員に届く（前例: PLAN69）
+- ベースブランチ: `main`（`.ndf/worktree.json` に起点の宣言が無く、既定ブランチに落ちる）
+
+## 依頼（原文）
+
+> Ctrl-b S をコマンドにできませんか？
+
+> tmux-menuというコマンドにする
+> issueを起こしてください
+
+## 目的
+
+- **`prefix S`（`Ctrl-b S`）と同じ「セッションの一覧 → 操作のメニュー」を、コマンド
+  `tmux-menu` で開ける。** キーを覚えていない人も、打てば同じ UI に辿り着ける
+- **tmux の外からも開ける。** #234 の設計が弱点に挙げた「tmux の外からは呼べない」を、
+  attach と同時に一覧を開くことで解く
+
+## 影響
+
+| 対象 | 影響 |
+| --- | --- |
+| 公開インタフェース | **増える。** コンテナの `PATH` に短縮名 `tmux-menu` が加わる。`tmux-session` のサブコマンドの受け付ける形が 1 つ増える。既存の `tmux-session menu -c 端末 <セッション>` の形は変えない |
+| データ | 変わらない |
+| 既存の振る舞い | `prefix S` で開く一覧とメニューは変えない（割り当ての行は `tmux-menu` を呼ぶ形に変わる）。`prefix s`・`tmux-go` / `tmux-peek` / `tmux-kill`・`tmux-first` / `tmux-clean` は変えない |
+| イメージのサイズ | symlink 1 つ。パッケージは足さない |
+| 利用者の操作 | **`devbase build base --no-cache` が要る。** 派生イメージも建て直し、稼働中のコンテナは `devbase down` → `devbase up` で作り直す。ホストでは symlink を 1 つ足す（利用者向け文書の手順） |
+
+## 前提
+
+- **前提 1: 対象の tmux は、コンテナの 3.6 とホストの 3.7b（PLAN69 と同じ）。**
+- **前提 2: 名前は `tmux-menu` で確定している**（利用者の指示、2026-09-24）。`tmux-session` の
+  どのサブコマンドへ振り分けるか、既存の `menu` と意味をどう分けるかは設計で決める
+- **前提 3: tmux の外から開くときの attach 先は、tmux の `attach` の既定（直近に使った
+  セッション）に従う。** セッション名を引数で取るかは設計で決める
+- **前提 4: CI はイメージを建てない。** 実イメージでの確認は手元で建てたイメージから採って
+  Pull Request 本文へ載せる（PLAN67 / PLAN69 と同じ）
+
+## 対象範囲
+
+含む:
+
+- `containers/base/tmux-session` への一覧を開く振る舞いの追加と、短縮名 `tmux-menu` の振り分け
+- `containers/base/Dockerfile` への symlink `tmux-menu` の追加
+- `containers/base/tmux.conf` の `prefix S` の行（一覧を開く定義を 1 か所にまとめる）
+- 回帰テスト（`tests/containers/`）
+- 利用者向け文書・確定仕様（`docs/specifications/tmux-named-session.md`）・CHANGELOG
+
+含まない:
+
+- 一覧・メニューの中身（項目・キー・動き）の変更
+- `tmux-first` / `tmux-clean` の変更
+- ホストへの自動の配布（PLAN69 の前提 4 のまま）
+- tmux を使わない一覧の UI（`curses` など）
+
+## 受け入れ条件
+
+検証はすべて専用のソケットで起動した tmux で行い、利用者の tmux サーバに触れない。
+
+### tmux の中で開く
+
+- [ ] 1. tmux の中の pane で `tmux-menu` を実行すると、その pane にセッションの一覧
+      （`choose-tree -Zs`、名前順）が出る
+- [ ] 2. 1 の一覧でセッションを選んで Enter を押すと、`prefix S` から開いたときと同じ
+      メニュー（移る `a` / 中身を見る `p` / 落とす `k`）が、選んだセッションを対象に出る
+- [ ] 3. 2 のメニューの `a` は、Enter を押した端末を選んだセッションへ移し、その端末は外さない。
+      選んだセッションに繋がっていた他の端末は外れる（`prefix S` と同じ）
+
+### tmux の外で開く
+
+- [ ] 4. tmux の外で、サーバが動いているときに `tmux-menu` を実行すると、attach し、
+      attach した画面にすぐセッションの一覧が出る
+- [ ] 5. 4 の一覧から開いたメニューの `a` / `p` / `k` が、3 と同じく選んだセッションに効く
+- [ ] 6. tmux の外で、サーバが無いときは、サーバもセッションも作らず、理由を標準エラーへ出して
+      終了コード 1 で終わる
+
+### 形と互換
+
+- [ ] 7. `tmux-session menu -c 端末 <セッション>`（`prefix S` の割り当てとホストの
+      `~/.tmux.conf` の行が呼ぶ形）は、今までと同じメニューを出す
+- [ ] 8. `tmux-menu` と、それに当たる `tmux-session` のサブコマンドの形が同じ振る舞いをする
+- [ ] 9. 知らないオプション・余分な引数では終了コード 2 で、理由を標準エラーへ出す。
+      `tmux-menu -h` は使い方を出して終了コード 0 で終わる。`tmux-session -h` の使い方に
+      `tmux-menu` が載る
+- [ ] 10. `containers/base/Dockerfile` が `/usr/local/bin/tmux-menu` を `tmux-session` への
+      symlink として作る。建てた base イメージの `PATH` から `tmux-menu` を呼べる
+- [ ] 11. `prefix S` と `prefix s` の割り当ては、変更前と同じ UI を開く（既存のテストが通る）
+- [ ] 12. `tmux-first` / `tmux-clean` の差分が 0 行
+- [ ] 13. `containers/base/tmux-*` の shellcheck が 0 件、全体の pytest が通る
+- [ ] 14. 利用者向け文書に `tmux-menu` の使い方と、ホストで使うときの symlink の手順
+      （5 つ目の `tmux-menu`）が載る。確定仕様と CHANGELOG に反映される
+
+## 検証手段
+
+| 項目 | 手段 |
+| --- | --- |
+| テスト | `env -u DEVBASE_ROOT uv run pytest -q`（`tests/containers/test_tmux_session.py` ほか） |
+| 静的解析 | `uvx --from shellcheck-py shellcheck containers/base/tmux-*`、`uv run ruff check` |
+| 実イメージ | `devbase build base --no-cache` の後、使い捨てのコンテナで `tmux-menu` を確かめる |
+| 手動確認 | 実際の端末で tmux の中と外から `tmux-menu` を打ち、一覧 → メニュー → `a` / `p` / `k` が効くことを利用者が見る（条件 2〜5 の人手の確認） |
+
+## 前提とする取り決め
+
+| 項目 | 参照先 / 決めたこと |
+| --- | --- |
+| プロジェクト構造 | base イメージの構成物は `containers/base/` の直下。コマンドは `/usr/local/bin`（PLAN69 と同じ） |
+| コーディング規約 | POSIX sh（`#!/bin/sh`、`set -eu`）。`tmux-session` の既存の書き方に合わせる |
+| テスト戦略 | `tests/containers/test_tmux_session.py` の流儀（専用のソケットの実物の tmux、pty からのキー入力）に合わせる |
+
+## 境界
+
+| 区分 | 内容 |
+| --- | --- |
+| 常に行う | 手元で全体テスト、shellcheck、`devbase build base --no-cache` と建てたイメージでの確認 |
+| 確認してから行う | 既存の `menu` の形を変えること（設計 Pull Request の承認で確かめる） |
+| 行わない | 一覧・メニューの中身の変更、`tmux-first` / `tmux-clean` の変更、ホストへの自動配布 |
+
+## 未決
+
+要求の時点で未決だった 4 点は、設計（[PLAN71_tmux-menu-design.md](PLAN71_tmux-menu-design.md)）で決めた。
+
+| 項目 | 決めたこと |
+| --- | --- |
+| `tmux-menu` を振り分けるサブコマンド | `menu` の短縮名にし、セッションを受け取らない形を「一覧を開く」にする（設計の決定 1） |
+| tmux の外での attach 先を引数で取るか | 取らない。tmux の既定の attach 先に従う（設計の決定 3） |
+| 一覧を開く定義をまとめるか | `tmux-session` だけに持ち、`prefix S` は `run-shell "tmux-menu"` で呼ぶ（設計の決定 2） |
+| シェルから開いた `choose-tree` の `#{q:client_name}` | Enter を押した端末の名前に展開される。ホストの tmux 3.7b で実測した（設計の「実測」） |

From 98f3829085c93ace2517efa95b3630542d919389 Mon Sep 17 00:00:00 2001
From: "takemi.ohama" <takemi.ohama@gmail.com>
Date: Thu, 24 Sep 2026 20:44:36 +0900
Subject: [PATCH 2/8] =?UTF-8?q?=E8=A8=AD=E8=A8=88(PLAN71):=20prefix=20S=20?=
 =?UTF-8?q?=E3=81=AF=E6=8A=BC=E3=81=97=E3=81=9F=20pane=20=E3=81=AE=20ID=20?=
 =?UTF-8?q?=E3=82=92=E6=B8=A1=E3=81=99=E3=83=BB=E5=AE=9F=E6=B8=AC=E3=81=AE?=
 =?UTF-8?q?=E5=86=8D=E7=8F=BE=E3=82=B9=E3=82=AF=E3=83=AA=E3=83=97=E3=83=88?=
 =?UTF-8?q?=E3=82=92=E8=B6=B3=E3=81=99=20(#270)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 決定 4: run-shell の中には TMUX_PANE が無く、-t の無い choose-tree は直近に
  操作されたセッションへ出る。prefix S を run-shell "TMUX_PANE=#{pane_id} tmux-menu" にする
- 実測を再現用スクリプト issues/PLAN71_tmux-menu-measure.py と出力つきで記録し直す
- attach の既定を「端末の無いセッションを優先し、その中で直近」に直す（要求の前提 3 も）
- menu が一覧を開くのはセッションも -c も無いときに限ると明記する
- 既存の静的テスト test_prefix_s_opens_session_chooser を書き換える対象として明記する

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 issues/PLAN71_tmux-menu-design.md  |  94 +++++++++++-----
 issues/PLAN71_tmux-menu-measure.py | 171 +++++++++++++++++++++++++++++
 issues/PLAN71_tmux-menu.md         |  11 +-
 3 files changed, 244 insertions(+), 32 deletions(-)
 create mode 100755 issues/PLAN71_tmux-menu-measure.py

diff --git a/issues/PLAN71_tmux-menu-design.md b/issues/PLAN71_tmux-menu-design.md
index 0ace376d..519c533e 100644
--- a/issues/PLAN71_tmux-menu-design.md
+++ b/issues/PLAN71_tmux-menu-design.md
@@ -18,12 +18,13 @@
 | 要素 | 変更 | 責務 |
 | --- | --- | --- |
 | `containers/base/tmux-session` | 変える | 呼ばれた名前 `tmux-menu` を `menu` へ振り分ける。`menu` がセッションを受け取らないときは一覧を開く（決定 1）。一覧を開く `choose-tree` の定義をこのファイルだけに持つ（決定 2） |
-| `containers/base/tmux.conf` | 変える | `prefix S` の行を `run-shell` で `tmux-menu` を呼ぶ形に変える（決定 2） |
+| `containers/base/tmux.conf` | 変える | `prefix S` の行を、キーを押した pane の ID を渡して `run-shell` で `tmux-menu` を呼ぶ形に変える（決定 2・決定 4） |
 | `containers/base/Dockerfile` の「tmux セッションの整理コマンド」の節 | 変える | symlink の `RUN` に `tmux-menu` を 1 つ足す |
 | `tests/containers/test_tmux_session.py` | 変える | F1・F2・F3 と、`menu -c 端末 <セッション>` の形が変わらないことを確かめる。Dockerfile の symlink の形を固定する（`SHORT_NAMES` に `tmux-menu` を足す） |
-| `tests/containers/test_tmux_conf.py` | 変える | `prefix S` の割り当てが `tmux-menu` を呼ぶことを `list-keys` で確かめる |
+| `tests/containers/test_tmux_conf.py` | 変える | 既存の `test_prefix_s_opens_session_chooser` を書き換え、`prefix S` の割り当てが `TMUX_PANE=#{pane_id}` を付けて `tmux-menu` を呼ぶことを `list-keys` で確かめる |
 | `docs/user/environment-variables.md` の「セッションを名指しで扱う」 | 変える | `tmux-menu` の使い方を足す。ホストの手順の symlink を 5 つにし、`~/.tmux.conf` の行を新しい割り当てへ差し替える |
 | `docs/specifications/tmux-named-session.md` | 変える（確定仕様化で） | `menu` の 2 つの形と `tmux-menu`、`prefix S` の新しい行 |
+| `issues/PLAN71_tmux-menu-measure.py` | 足す（この設計で） | 「実測」の再現用スクリプト。確定仕様化のときに消す |
 | `CHANGELOG.md` | 変える | `[Unreleased]` の `### Added` に足す。反映に `devbase build base --no-cache` が要ることを書く |
 
 次のものは変えない。
@@ -45,7 +46,7 @@
 `tmux-menu` と `menu` が別の動きになり、名前から動きが読めない。今の `menu` を別名へ改名する
 案も採らない。ホストへ写した `~/.tmux.conf` の行が壊れる。
 
-### 決定 2: 一覧を開く定義は `tmux-session` だけに持ち、`prefix S` は `run-shell "tmux-menu"` で呼ぶ
+### 決定 2: 一覧を開く定義は `tmux-session` だけに持ち、`prefix S` は `run-shell` で `tmux-menu` を呼ぶ
 
 `prefix S` と `tmux-menu` が同じ一覧を開くことを、定義を 1 つにして保つ。2 か所に同じ template を
 持つと、片方だけを直したときに 2 つの入口の動きが分かれる。実測のとおり、template を
@@ -58,21 +59,55 @@
 ### 決定 3: tmux の外では attach 先を引数で取らない
 
 名前の決まったセッションへ行くなら `tmux-go` がある。`tmux-menu` は「まず一覧を見る」入口で、
-attach 先は tmux の既定（直近のセッション）で足りる。一覧からどのセッションへも移れる。
-セッションを引数で取ると、決定 1 の「セッションを受け取るかで 2 つの形を分ける」規則が崩れる。
+attach 先は tmux の既定（**繋がっている端末の無いセッションを優先し、その中で直近に使ったもの**。
+すべてに端末が繋がっていれば全体で直近に使ったもの）で足りる。一覧からどのセッションへも移れる。
+セッションを引数で取ると、決定 1 の「セッションも `-c` も受け取らない形だけが一覧を開く」規則が崩れる。
+
+### 決定 4: `prefix S` はキーを押した pane の ID を `TMUX_PANE` で渡し、`choose-tree` の `-t` に使う
+
+`run-shell` から起動したシェルには `TMUX_PANE` が無い。`-t` の無い `choose-tree` は、呼び出し元の
+pane を継がず、全セッションから直近に操作されたセッションを選び直す。`prefix S` を押してから
+`choose-tree` が走るまでの間に別のセッションの端末が操作されると、一覧がその端末に出る（実測の 5）。
+`run-shell` は渡された文字列の `#{…}` を先に展開するため、`TMUX_PANE=#{pane_id} tmux-menu` と
+書けば押した pane の ID（`%3` の形。引用の要らない文字だけ）が渡る（実測の 6）。
+
+`tmux-menu` に `-t` のオプションを足して ID を渡す案は採らない。`menu` の受け付ける形が増え、
+tmux の中でコマンドを打つ形（`TMUX_PANE` がシェルにある）と同じ入口に揃わない。
 
 ## 実測（2026-09-24、ホストの tmux 3.7b）
 
-専用のソケットでサーバを立て、`python3` の `pty` で端末を attach した。`tmux-session` の代わりに
-引数を書き出すだけの偽物を置き、一覧で 1 つ上のセッションを選んで Enter を押した。選んだ
-セッションの名前は `it's`（`'` を含む）である。
+再現用のスクリプトは [PLAN71_tmux-menu-measure.py](PLAN71_tmux-menu-measure.py) にある
+（`python3 issues/PLAN71_tmux-menu-measure.py`。一時ディレクトリのソケットでサーバを立て、利用者の
+サーバに触れない）。`python3` の `pty` で端末を繋ぎ、`tmux-session` の代わりに引数を書き出すだけの
+偽物を置く。一覧を開くスクリプト `open-list` は `tmux-menu` の代わりで、`TMUX_PANE` があれば
+`-t "$TMUX_PANE"` を付けて次の `<template>` で `choose-tree -Zs -O name` を実行する。セッションは
+`a`・`it's`（`'` を含む）・`b` の 3 つで、端末 `/dev/ttys024` が `a` に、`/dev/ttys025` が `b` に
+繋がっている（端末の名前は実行ごとに変わる）。一覧では 1 つ上を選んで Enter を押した。
+
+| # | 開き方 | 一覧が出た pane | `menu` へ渡った引数（ID → 名前） | 判定 |
+| --- | --- | --- | --- | --- |
+| 1 | `a` の端末のプロンプトで `open-list` を打つ | `a` | `menu -c /dev/ttys024 $1` → `it's` | 正しい |
+| 2 | tmux の外で `tmux attach \; choose-tree -Zs -O name '<template>'` | 新しい端末 `/dev/ttys026` が `it's`（端末の無いセッション）へ繋がる | `menu -c /dev/ttys026 $2` → `b` | 正しい |
+| 3 | `bind-key S run-shell "tmux choose-tree -Zs -O name '<template>'"`（template を `run-shell` の文字列へ直接埋め込む）を `a` の端末で押す | `a` | `menu -c /dev/ttys024 sh`。選ぶ前に押した端末のセッションの ID（`$0`）へ展開され、それをシェルが変数として `sh` に読んだと見られる | **誤り** |
+| 4 | `bind-key S run-shell open-list` を `a` の端末で押す | `a` | `menu -c /dev/ttys024 $1` → `it's` | 正しい |
+| 5 | 4 の形（1 秒待ってから開く `open-list-slow`）で、押した直後に `b` の端末へ 1 文字打つ | **`b`** | （選んでいない） | **誤り** |
+| 6 | `bind-key S run-shell "TMUX_PANE=#{pane_id} open-list-slow"` で 5 と同じ操作。続けて選んで Enter | `a` | `menu -c /dev/ttys024 $1` → `it's` | 正しい |
+
+スクリプトの出力（抜粋。`panes` は `セッション:pane:モード`）:
 
-| 開き方 | `menu` へ渡った引数 | 判定 |
-| --- | --- | --- |
-| tmux の中のプロンプトで `tmux choose-tree -Zs -O name '<template>'` を打つ。別のセッションにも端末を 1 つ繋いでおく | `menu -c <押した端末> <選んだ ID>` | 正しい |
-| tmux の外で `tmux attach \; choose-tree -Zs -O name '<template>'` | `menu -c <押した端末> <選んだ ID>`。attach 先は直近のセッション | 正しい |
-| `bind-key S run-shell "tmux choose-tree … '<template>'"`（template を `run-shell` の文字列へ直接埋め込む） | `menu -c <押した端末>` だけ。ID が消えた | **誤り** |
-| `bind-key S run-shell '<スクリプト>'`。スクリプトが `tmux choose-tree -Zs -O name '<template>'` を実行する | `menu -c <押した端末> <選んだ ID>` | 正しい |
+```text
+## 2 outside: attach ; choose-tree
+  clients: ['/dev/ttys024=a', '/dev/ttys025=b', "/dev/ttys026=it's"]
+  menu args: 'menu -c /dev/ttys026 $2' -> 'menu -c /dev/ttys026 b'
+## 3 bind: run-shell with inline template
+  menu args: 'menu -c /dev/ttys024 sh' -> 'menu -c /dev/ttys024 sh'
+## 5 bind: run-shell (no -t), other client typed during start
+  panes: ['a:%0:', 'b:%2:tree-mode', "it's:%1:"]
+## 6 bind: run-shell TMUX_PANE=#{pane_id}, other client typed during start
+  panes: ['a:%0:tree-mode', 'b:%2:', "it's:%1:"]
+## 6b same binding, pick and Enter
+  menu args: 'menu -c /dev/ttys024 $1' -> "menu -c /dev/ttys024 it's"
+```
 
 `<template>` は今の `prefix S` の行と同じ次の文字列である。
 
@@ -80,11 +115,13 @@ attach 先は tmux の既定（直近のセッション）で足りる。一覧
 run-shell -t "%%%" "tmux-session menu -c #{q:client_name} #{q:session_id}"
 ```
 
-- **`run-shell` は、渡された文字列の `#{…}` をシェルへ渡す前に展開する。** 3 行目で ID が
-  消えたのはこのためである。4 行目ではスクリプトの本文が `run-shell` の展開を通らないため、
-  template は `choose-tree` へそのまま届く
-- `run-shell` から起動したシェルでは `TMUX` はあり、`TMUX_PANE` は無かった。`choose-tree` は
-  `-t` なしで、キーを押した端末が見ている pane に一覧を出した
+- **`run-shell` は、渡された文字列の `#{…}` をシェルへ渡す前に展開する。** 3 で選ぶ前の ID が
+  入ったのはこのためである。4 ではスクリプトの本文が `run-shell` の展開を通らないため、
+  template は `choose-tree` へそのまま届く。6 はこの展開を使って押した pane の ID を渡す
+- `run-shell` から起動したシェルでは `TMUX` はあり、`TMUX_PANE` は無い。`-t` の無い
+  `choose-tree` は直近に操作されたセッションの pane に出る。4 で正しく見えたのは、押した端末が
+  直近だったからにすぎない（5）
+- tmux の外からの `attach` は、端末の繋がっていないセッションを優先する（2）
 
 ## 入出力の契約
 
@@ -97,7 +134,8 @@ tmux-menu                                = tmux-session menu
 共通: -h / --help で使い方を出して終了コード 0
 ```
 
-`menu` の 2 つの形は、**セッションを受け取るかどうか**で分ける。
+`menu` の 2 つの形は、**セッションも `-c` も受け取らないときに限り一覧を開く**。どちらか一方でも
+あれば今の形として読み、足りなければ今と同じく終了コード 2 で終わる。
 
 | 引数 | 動き |
 | --- | --- |
@@ -117,8 +155,8 @@ tmux-menu                                = tmux-session menu
 | --- | --- | --- |
 | tmux が無い | 標準エラーへ「tmux が見つかりません」 | 1 |
 | サーバが無い | 標準エラーへ「tmux サーバが起動していません」。サーバもセッションも作らない | 1 |
-| tmux の中（`TMUX` がある） | `TMUX_PANE` があれば `-t "$TMUX_PANE"` を付けて `choose-tree` を実行する。無ければ `-t` を付けない（`run-shell` から呼ばれた場合） | `choose-tree` の終了コード |
-| tmux の外 | `exec tmux attach-session \; choose-tree …`。attach 先は tmux の既定（直近のセッション） | `tmux` の終了コード |
+| tmux の中（`TMUX` がある） | `TMUX_PANE` があれば `-t "$TMUX_PANE"` を付けて `choose-tree` を実行する。`prefix S` は `TMUX_PANE=#{pane_id}` を渡す（決定 4）。無ければ `-t` を付けない（`run-shell` から素で呼ばれた場合。直近に操作されたセッションに出る） | `choose-tree` の終了コード |
+| tmux の外 | `exec tmux attach-session \; choose-tree …`。attach 先は tmux の既定（端末の繋がっていないセッションを優先し、その中で直近のもの） | `tmux` の終了コード |
 
 `choose-tree` の引数は今の `prefix S` と同じにする。
 
@@ -133,8 +171,9 @@ choose-tree -Zs -O name "run-shell -t \"%%%\" \"tmux-session menu -c #{q:client_
 ```tmux
 # prefix S: セッションを選び、移る・中身を見る・落とすのメニューを出す (#234 / #270)。
 # 一覧の定義は tmux-session にある (tmux-menu と同じ)。run-shell は渡した文字列の #{…} を
-# 先に展開するため、template をここへ書かずにコマンドを呼ぶ。
-bind-key S run-shell "tmux-menu"
+# 先に展開するため、template をここへ書かずにコマンドを呼ぶ。run-shell の中には TMUX_PANE が
+# 無いため、押した pane の ID を渡す (無いと直近に操作された別の端末に出ることがある)。
+bind-key S run-shell "TMUX_PANE=#{pane_id} tmux-menu"
 ```
 
 ### 互換性
@@ -158,8 +197,8 @@ sequenceDiagram
         C->>T: choose-tree -t TMUX_PANE …
     else prefix S
         U->>T: prefix S
-        T->>C: run-shell "tmux-menu"
-        C->>T: choose-tree …（-t なし）
+        T->>C: run-shell "TMUX_PANE=#{pane_id} tmux-menu"
+        C->>T: choose-tree -t 押した pane …
     else tmux の外
         U->>C: tmux-menu
         C->>T: exec tmux attach \; choose-tree …
@@ -189,7 +228,7 @@ Enter の後は PLAN69 の `menu` の流れと同じである。
 | 8 | `tmux-menu` と `tmux-session menu` で 1・6 を両方の名前で走らせる（parametrize） |
 | 9 | `-c` だけ・余分な引数・知らないオプションで終了コード 2。`tmux-menu -h` が 0 で、`tmux-session -h` の出力に `tmux-menu` が含まれる |
 | 10 | Dockerfile の symlink の `RUN` に `tmux-menu` が含まれることを固定する（`test_dockerfile_links_short_names`）。建てたイメージで `command -v tmux-menu` を見る |
-| 11 | `tmux.conf` を読んだ tmux の `list-keys -T prefix` の `S` が `run-shell tmux-menu` であることを見る。既存の `test_prefix_s_passes_selected_id_and_client` と `test_menu_*`（`prefix S` から開く）がそのまま通る。`prefix s` は既定のまま |
+| 11 | **書き換える既存テスト:** `test_prefix_s_opens_session_chooser`（`tests/containers/test_tmux_conf.py`）は割り当てに `choose-tree` と `tmux-session menu` が含まれることを見ており、決定 2 で落ちる。割り当てがちょうど 1 つで、`run-shell` が `TMUX_PANE=#{pane_id} tmux-menu` を呼ぶことを見る形へ改める。**そのまま通る既存テスト:** `test_prefix_s_passes_selected_id_and_client` と `test_menu_*`（`prefix S` から開く）。**足すテスト:** `prefix S` を押した直後に別のセッションの端末へ打っても、一覧が押した端末の pane に出る（実測の 5・6）。`prefix s` は既定のまま |
 | 12 | `git diff --stat main` に `tmux-first` / `tmux-clean` が現れない |
 | 13 | `shellcheck containers/base/tmux-*` と全体の pytest |
 | 14 | 文書の差分をレビューで見る |
@@ -199,5 +238,4 @@ Enter の後は PLAN69 の `menu` の流れと同じである。
 | 項目 | 内容 |
 | --- | --- |
 | コンテナの tmux 3.6 での 4 つの開き方 | 実測はホストの 3.7b だけ。`attach \; choose-tree` と `run-shell` からの `choose-tree` は 3.6 でも使える機能だが、建てたイメージで確かめるのは実装の後 |
-| 複数の端末が同じセッションの別々のウィンドウを見ているときの `prefix S` | `run-shell` からの `choose-tree` は `-t` なしで、そのセッションの今のウィンドウの pane に出る。1 つのセッションには今のウィンドウが 1 つしか無いため、押した端末とは別のウィンドウに一覧が出ることは無い見込み。実装でテストを 1 つ足して確かめる |
 | 人が実際の端末で操作する確認 | 条件 1〜5 の人手の確認。リリース後テストへ回す |
diff --git a/issues/PLAN71_tmux-menu-measure.py b/issues/PLAN71_tmux-menu-measure.py
new file mode 100755
index 00000000..63e03be0
--- /dev/null
+++ b/issues/PLAN71_tmux-menu-measure.py
@@ -0,0 +1,171 @@
+#!/usr/bin/env python3
+"""PLAN71 の実測: choose-tree の開き方ごとに、一覧が出た pane と menu へ渡った引数を見る。
+
+使い方: python3 issues/PLAN71_tmux-menu-measure.py
+一時ディレクトリのソケットでサーバを立て、利用者の tmux サーバに触れない。
+"""
+
+import os
+import pty
+import select
+import subprocess
+import tempfile
+import time
+
+TEMPLATE = 'run-shell -t "%%%" "tmux-session menu -c #{q:client_name} #{q:session_id}"'
+WORK = tempfile.mkdtemp(prefix="plan71-")
+SOCK = os.path.join(WORK, "sock")
+LOG = os.path.join(WORK, "menu.log")
+BINDIR = os.path.join(WORK, "bin")
+
+SCRIPTS = {
+    # 本物の代わりに、受け取った引数を書き出すだけの tmux-session
+    "tmux-session": f'#!/bin/sh\nprintf "%s\\n" "$*" >> {LOG}\n',
+    # tmux-menu の代わり。TMUX_PANE があれば -t に使う（設計の「一覧を開く形」と同じ分岐）
+    "open-list": (
+        "#!/bin/sh\n"
+        f"exec tmux choose-tree ${{TMUX_PANE:+-t \"$TMUX_PANE\"}} -Zs -O name '{TEMPLATE}'\n"
+    ),
+    # 一覧が開くまでの間に別の端末を操作するため、1 秒待ってから開く
+    "open-list-slow": "#!/bin/sh\nsleep 1\nexec open-list\n",
+}
+
+os.mkdir(BINDIR)
+for name, body in SCRIPTS.items():
+    path = os.path.join(BINDIR, name)
+    with open(path, "w") as f:
+        f.write(body)
+    os.chmod(path, 0o755)
+
+ENV = dict(
+    os.environ, PATH=BINDIR + ":" + os.environ["PATH"], SHELL="/bin/sh", TERM="xterm"
+)
+ENV.pop("TMUX", None)
+ENV.pop("TMUX_PANE", None)
+TMUX = ["tmux", "-S", SOCK, "-f", "/dev/null"]
+
+
+def t(*args):
+    return subprocess.run(
+        TMUX + list(args), env=ENV, capture_output=True, text=True, check=False
+    ).stdout.strip()
+
+
+def spawn(*args):
+    """pty の端末で tmux を起動し、端末の fd を返す。"""
+    pid, fd = pty.fork()
+    if pid == 0:
+        os.execvpe("tmux", TMUX + list(args), ENV)
+    time.sleep(1)
+    return fd
+
+
+def drain(fd):
+    while select.select([fd], [], [], 0.05)[0]:
+        try:
+            os.read(fd, 65536)
+        except OSError:
+            break
+
+
+def pick(fd):
+    """一覧で 1 つ上を選んで Enter を押す。"""
+    time.sleep(0.8)
+    os.write(fd, b"\x1b[A")
+    time.sleep(0.3)
+    os.write(fd, b"\r")
+    time.sleep(0.8)
+
+
+def state(label):
+    ids = dict(
+        line.split(" ", 1)
+        for line in t(
+            "list-sessions", "-F", "#{session_id} #{session_name}"
+        ).splitlines()
+    )
+    clients = t("list-clients", "-F", "#{client_name}=#{session_name}")
+    panes = t("list-panes", "-a", "-F", "#{session_name}:#{pane_id}:#{pane_mode}")
+    got = ""
+    if os.path.exists(LOG):
+        with open(LOG) as f:
+            got = f.read().strip()
+    named = " ".join(ids.get(w, w) if w.startswith("$") else w for w in got.split())
+    print(f"## {label}")
+    print(f"  clients: {clients.split()}")
+    print(f"  panes: {panes.split()}")
+    print(f"  menu args: {got!r} -> {named!r}")
+
+
+def reset():
+    if os.path.exists(LOG):
+        os.remove(LOG)
+    for line in t("list-panes", "-a", "-F", "#{pane_id} #{pane_mode}").splitlines():
+        pane, _, mode = line.partition(" ")
+        if mode:
+            t("send-keys", "-t", pane, "q")
+    time.sleep(0.3)
+
+
+def main():
+    for name in ("a", "it's", "b"):
+        t("new-session", "-d", "-s", name, "-x", "80", "-y", "24")
+    c1 = spawn("attach", "-t", "=a")
+    c2 = spawn("attach", "-t", "=b")
+
+    # 1. 中のプロンプトで打つ（pane のシェルには TMUX_PANE がある）
+    reset()
+    drain(c1)
+    os.write(c1, b"open-list\r")
+    pick(c1)
+    state("1 prompt: open-list (a's pane, TMUX_PANE set)")
+
+    # 2. 外から attach \; choose-tree
+    reset()
+    c3 = spawn("attach", ";", "choose-tree", "-Zs", "-O", "name", TEMPLATE)
+    pick(c3)
+    state("2 outside: attach ; choose-tree")
+    t("detach-client", "-t", t("list-clients", "-F", "#{client_name}").split()[-1])
+
+    # 3. template を run-shell の文字列へ直接埋め込む
+    reset()
+    t("bind-key", "S", "run-shell", f"tmux choose-tree -Zs -O name '{TEMPLATE}'")
+    os.write(c1, b"\x02S")
+    pick(c1)
+    state("3 bind: run-shell with inline template")
+
+    # 4. run-shell からスクリプトを呼ぶ（-t なし）
+    reset()
+    t("bind-key", "S", "run-shell", "open-list")
+    os.write(c1, b"\x02S")
+    pick(c1)
+    state("4 bind: run-shell open-list (no TMUX_PANE)")
+
+    # 5. 4 の形で、一覧が開く前に別のセッションの端末が操作される
+    reset()
+    t("bind-key", "S", "run-shell", "open-list-slow")
+    os.write(c1, b"\x02S")
+    time.sleep(0.3)
+    os.write(c2, b"x")
+    time.sleep(1.5)
+    state("5 bind: run-shell (no -t), other client typed during start")
+
+    # 6. #{pane_id} を TMUX_PANE として渡す
+    reset()
+    t("bind-key", "S", "run-shell", "TMUX_PANE=#{pane_id} open-list-slow")
+    os.write(c1, b"\x02S")
+    time.sleep(0.3)
+    os.write(c2, b"x")
+    time.sleep(1.5)
+    state("6 bind: run-shell TMUX_PANE=#{pane_id}, other client typed during start")
+    reset()
+    os.write(c1, b"\x02S")
+    time.sleep(1)
+    pick(c1)
+    state("6b same binding, pick and Enter")
+
+    t("kill-server")
+
+
+if __name__ == "__main__":
+    main()
diff --git a/issues/PLAN71_tmux-menu.md b/issues/PLAN71_tmux-menu.md
index a8cb3bd1..e0a5c60f 100644
--- a/issues/PLAN71_tmux-menu.md
+++ b/issues/PLAN71_tmux-menu.md
@@ -36,8 +36,8 @@
 - **前提 1: 対象の tmux は、コンテナの 3.6 とホストの 3.7b（PLAN69 と同じ）。**
 - **前提 2: 名前は `tmux-menu` で確定している**（利用者の指示、2026-09-24）。`tmux-session` の
   どのサブコマンドへ振り分けるか、既存の `menu` と意味をどう分けるかは設計で決める
-- **前提 3: tmux の外から開くときの attach 先は、tmux の `attach` の既定（直近に使った
-  セッション）に従う。** セッション名を引数で取るかは設計で決める
+- **前提 3: tmux の外から開くときの attach 先は、tmux の `attach` の既定（端末の繋がって
+  いないセッションを優先し、その中で直近に使ったもの）に従う。** セッション名を引数で取るかは設計で決める
 - **前提 4: CI はイメージを建てない。** 実イメージでの確認は手元で建てたイメージから採って
   Pull Request 本文へ載せる（PLAN67 / PLAN69 と同じ）
 
@@ -89,7 +89,10 @@
       `tmux-menu` が載る
 - [ ] 10. `containers/base/Dockerfile` が `/usr/local/bin/tmux-menu` を `tmux-session` への
       symlink として作る。建てた base イメージの `PATH` から `tmux-menu` を呼べる
-- [ ] 11. `prefix S` と `prefix s` の割り当ては、変更前と同じ UI を開く（既存のテストが通る）
+- [ ] 11. `prefix S` と `prefix s` の割り当ては、変更前と同じ UI を、キーを押した端末の pane に
+      開く。`prefix S` の割り当ての文字列を見る既存の静的テスト `test_prefix_s_opens_session_chooser`
+      は、新しい割り当て（`run-shell` で `tmux-menu` を呼ぶ）を見る形へ書き換える。それ以外の既存の
+      テストはそのまま通る
 - [ ] 12. `tmux-first` / `tmux-clean` の差分が 0 行
 - [ ] 13. `containers/base/tmux-*` の shellcheck が 0 件、全体の pytest が通る
 - [ ] 14. 利用者向け文書に `tmux-menu` の使い方と、ホストで使うときの symlink の手順
@@ -128,5 +131,5 @@
 | --- | --- |
 | `tmux-menu` を振り分けるサブコマンド | `menu` の短縮名にし、セッションを受け取らない形を「一覧を開く」にする（設計の決定 1） |
 | tmux の外での attach 先を引数で取るか | 取らない。tmux の既定の attach 先に従う（設計の決定 3） |
-| 一覧を開く定義をまとめるか | `tmux-session` だけに持ち、`prefix S` は `run-shell "tmux-menu"` で呼ぶ（設計の決定 2） |
+| 一覧を開く定義をまとめるか | `tmux-session` だけに持ち、`prefix S` は `run-shell "TMUX_PANE=#{pane_id} tmux-menu"` で呼ぶ（設計の決定 2・決定 4） |
 | シェルから開いた `choose-tree` の `#{q:client_name}` | Enter を押した端末の名前に展開される。ホストの tmux 3.7b で実測した（設計の「実測」） |

From b0e84c94d578838e4abf03b0dc3ef20ff85b07e3 Mon Sep 17 00:00:00 2001
From: "takemi.ohama" <takemi.ohama@gmail.com>
Date: Thu, 24 Sep 2026 21:04:03 +0900
Subject: [PATCH 3/8] =?UTF-8?q?=E8=A8=AD=E8=A8=88(PLAN71):=20TMUX=5FPANE?=
 =?UTF-8?q?=20=E3=82=92=E7=B8=9B=E3=82=8B=E3=83=86=E3=82=B9=E3=83=88?=
 =?UTF-8?q?=E3=82=92=E6=99=82=E9=96=93=E3=81=AB=E9=A0=BC=E3=82=89=E3=81=AA?=
 =?UTF-8?q?=E3=81=84=E5=BD=A2=E3=81=B8=E3=83=BB=E3=83=86=E3=82=B9=E3=83=88?=
 =?UTF-8?q?=E5=9F=BA=E7=9B=A4=E3=81=AE=E6=9B=B4=E6=96=B0=E3=82=92=E6=98=8E?=
 =?UTF-8?q?=E8=A8=98?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 足すテストを「直近の端末を other にしてから inside_env(home) で tmux-menu を実行し、
  home の pane だけが tree-mode になる」形へ差し替える
- SHORT_NAMES への tmux-menu の追加が Dockerfile 検査と TmuxEnv.bin の両方に効くこと、
  fake_tm の fake/ には tmux-menu を置かないことを明記する
- prefix S から開く既存テストを「基盤更新で通る既存テスト」へ分類し直し、受け入れ条件 11 をそろえる

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 issues/PLAN71_tmux-menu-design.md | 44 +++++++++++++++++++++++++++----
 issues/PLAN71_tmux-menu.md        |  5 ++--
 2 files changed, 42 insertions(+), 7 deletions(-)

diff --git a/issues/PLAN71_tmux-menu-design.md b/issues/PLAN71_tmux-menu-design.md
index 519c533e..7f2405f4 100644
--- a/issues/PLAN71_tmux-menu-design.md
+++ b/issues/PLAN71_tmux-menu-design.md
@@ -20,7 +20,7 @@
 | `containers/base/tmux-session` | 変える | 呼ばれた名前 `tmux-menu` を `menu` へ振り分ける。`menu` がセッションを受け取らないときは一覧を開く（決定 1）。一覧を開く `choose-tree` の定義をこのファイルだけに持つ（決定 2） |
 | `containers/base/tmux.conf` | 変える | `prefix S` の行を、キーを押した pane の ID を渡して `run-shell` で `tmux-menu` を呼ぶ形に変える（決定 2・決定 4） |
 | `containers/base/Dockerfile` の「tmux セッションの整理コマンド」の節 | 変える | symlink の `RUN` に `tmux-menu` を 1 つ足す |
-| `tests/containers/test_tmux_session.py` | 変える | F1・F2・F3 と、`menu -c 端末 <セッション>` の形が変わらないことを確かめる。Dockerfile の symlink の形を固定する（`SHORT_NAMES` に `tmux-menu` を足す） |
+| `tests/containers/test_tmux_session.py` | 変える | F1・F2・F3 と、`menu -c 端末 <セッション>` の形が変わらないことを確かめる。`SHORT_NAMES` に `tmux-menu` を足す（下の「テスト基盤の更新」） |
 | `tests/containers/test_tmux_conf.py` | 変える | 既存の `test_prefix_s_opens_session_chooser` を書き換え、`prefix S` の割り当てが `TMUX_PANE=#{pane_id}` を付けて `tmux-menu` を呼ぶことを `list-keys` で確かめる |
 | `docs/user/environment-variables.md` の「セッションを名指しで扱う」 | 変える | `tmux-menu` の使い方を足す。ホストの手順の symlink を 5 つにし、`~/.tmux.conf` の行を新しい割り当てへ差し替える |
 | `docs/specifications/tmux-named-session.md` | 変える（確定仕様化で） | `menu` の 2 つの形と `tmux-menu`、`prefix S` の新しい行 |
@@ -216,19 +216,53 @@ Enter の後は PLAN69 の `menu` の流れと同じである。
 受け入れ条件の番号は [PLAN71_tmux-menu.md](PLAN71_tmux-menu.md) のもの。テストは
 `test_tmux_session.py` の流儀（専用のソケット、`pty` の端末、偽の `tmux-session`）に合わせる。
 
+### テスト基盤の更新
+
+`tests/containers/test_tmux_session.py` の `SHORT_NAMES`（38 行目）へ `tmux-menu` を足す。この
+タプルは 2 つの経路に効く。
+
+| 経路 | どこで使うか | 足した結果 |
+| --- | --- | --- |
+| Dockerfile の検査 | `test_dockerfile_links_short_names` | `ln -sf tmux-session /usr/local/bin/tmux-menu` を要求する（条件 10） |
+| テスト用の `bin` | `TmuxEnv.__init__` の `for name in ("tmux-session", *SHORT_NAMES)`（346 行目） | `bin/tmux-menu` が本物の `tmux-session` を指す symlink になる。`tm.run("tmux-menu", …)` と、`prefix S` の `run-shell` が `PATH` から引く `tmux-menu` はこれを使う |
+
+`fake_tm` フィクスチャ（943 行目）は、`TmuxEnv` の `bin` とは別の `fake/` を `PATH` の先頭に置き、
+そこへ引数を書き出すだけの `tmux-session` を置く。`fake_tm` も `TmuxEnv` を作るため、`bin/tmux-menu`
+は `SHORT_NAMES` の追加だけで `fake_tm` にもできる。**`fake/` には `tmux-menu` を置かない。** `prefix S`
+の `tmux-menu` は本物で一覧を開き、Enter の後に template が呼ぶ `tmux-session menu -c …` だけを
+`fake/` の偽物が受ける必要がある。`fake/` に偽の `tmux-session` を指す `tmux-menu` を置くと、
+`prefix S` が引数の無い `menu` を書き出すだけで一覧が開かず、`test_prefix_s_passes_selected_id_and_client`
+が落ちる。
+
+`SHORT_NAMES` を足さないままでは `bin` に `tmux-menu` が無く、`prefix S` の `run-shell` がコマンドを
+見つけられない。`prefix S` から一覧を開く既存テストは、中身を変えずに、この基盤更新で通る。
+
+| 基盤更新で通る既存テスト（`prefix S` を `_open_tree` / `_open_menu` で送る） | フィクスチャ |
+| --- | --- |
+| `test_prefix_s_passes_selected_id_and_client` | `fake_tm` |
+| `test_menu_go_detaches_others_and_switches` | `ui_tm` |
+| `test_menu_kill_asks_then_kills` | `ui_tm` |
+| `test_menu_kill_own_session` | `ui_tm` |
+| `test_menu_peek_opens_popup` | `ui_tm` |
+
+`test_menu_notifies_client_on_failure` は `prefix S` を通らず `run-shell` から `tmux-go` を呼ぶため、
+この更新に関係なく通る。
+
+### 条件ごとの確かめ方
+
 | 受け入れ条件 | 何で確かめるか |
 | --- | --- |
-| 1 | tmux の中の端末のプロンプトへ `tmux-menu` を打ち、その端末の `#{pane_mode}` が `tree-mode` になることを見る |
+| 1 | tmux の中の端末のプロンプトへ `tmux-menu` を打ち、その端末の `#{pane_mode}` が `tree-mode` になることを見る。一覧を出す pane を `TMUX_PANE` で決めることは行 11 の足すテストで縛る |
 | 2 | 1 の後に 1 つ上を選んで Enter を押し、偽の `tmux-session` へ `menu -c <押した端末> <選んだ ID>` が渡ることを見る。`'` を含む名前を含める |
 | 3 | 本物の `tmux-session` で 1 → 選ぶ → `a` を送り、押した端末が選んだセッションへ移り、そこに繋がっていた他の端末が外れることを `list-clients` で見る |
 | 4 | tmux の外の端末で `tmux-menu` を起動し、端末がサーバに繋がり `tree-mode` になることを見る |
 | 5 | 4 の後に 2 と同じく選んで Enter を押し、`menu -c <その端末> <選んだ ID>` が渡ることを見る |
 | 6 | サーバの無い環境で `tmux-menu` を実行し、終了コード 1・標準エラーの理由・実行後もサーバが無いことを見る |
-| 7 | 既存の `menu` のテスト（`test_menu_*`）がそのまま通る |
+| 7 | 既存の `menu` のテスト（`test_menu_*`）が中身を変えずに通る。`prefix S` を通るものは「テスト基盤の更新」の後に通る |
 | 8 | `tmux-menu` と `tmux-session menu` で 1・6 を両方の名前で走らせる（parametrize） |
 | 9 | `-c` だけ・余分な引数・知らないオプションで終了コード 2。`tmux-menu -h` が 0 で、`tmux-session -h` の出力に `tmux-menu` が含まれる |
-| 10 | Dockerfile の symlink の `RUN` に `tmux-menu` が含まれることを固定する（`test_dockerfile_links_short_names`）。建てたイメージで `command -v tmux-menu` を見る |
-| 11 | **書き換える既存テスト:** `test_prefix_s_opens_session_chooser`（`tests/containers/test_tmux_conf.py`）は割り当てに `choose-tree` と `tmux-session menu` が含まれることを見ており、決定 2 で落ちる。割り当てがちょうど 1 つで、`run-shell` が `TMUX_PANE=#{pane_id} tmux-menu` を呼ぶことを見る形へ改める。**そのまま通る既存テスト:** `test_prefix_s_passes_selected_id_and_client` と `test_menu_*`（`prefix S` から開く）。**足すテスト:** `prefix S` を押した直後に別のセッションの端末へ打っても、一覧が押した端末の pane に出る（実測の 5・6）。`prefix s` は既定のまま |
+| 10 | Dockerfile の symlink の `RUN` に `tmux-menu` が含まれることを固定する（`SHORT_NAMES` を足した `test_dockerfile_links_short_names`）。建てたイメージで `command -v tmux-menu` を見る |
+| 11 | **書き換える既存テスト:** `test_prefix_s_opens_session_chooser`（`tests/containers/test_tmux_conf.py`）は割り当てに `choose-tree` と `tmux-session menu` が含まれることを見ており、決定 2 で落ちる。割り当てがちょうど 1 つで、`run-shell` が `TMUX_PANE=#{pane_id} tmux-menu` を呼ぶことを見る形へ改める。**基盤更新で通る既存テスト:** `test_prefix_s_passes_selected_id_and_client` と、`prefix S` から開く `test_menu_*` 4 件（「テスト基盤の更新」の表）。中身は変えない。**足すテスト:** 時間の競合に頼らず、`TMUX_PANE` の pane に一覧が出ることを見る。`home` と `other` の 2 つのセッションを作り、`tm.attach(home)` の後に `tm.attach(other)` で繋いだ端末へ 1 文字送って直近に操作された端末を `other` にする。そのうえで `tm.run("tmux-menu", env=tm.inside_env(home))` を実行し、`home` の pane の `#{pane_mode}` が `tree-mode` になり、`other` の pane はならないことを見る。`-t "$TMUX_PANE"` を実装から落とすと、一覧は直近の `other` に出て落ちる。`prefix S` が `TMUX_PANE=#{pane_id}` を渡すことは、書き換える静的テストが縛る。実測の 5・6 のような、押した直後に別の端末へ打つテストは、本物の `tmux-menu` では `choose-tree` までの間が数十 ms しかなく `-t` の有無を区別できないため採らない。`prefix s` は既定のまま |
 | 12 | `git diff --stat main` に `tmux-first` / `tmux-clean` が現れない |
 | 13 | `shellcheck containers/base/tmux-*` と全体の pytest |
 | 14 | 文書の差分をレビューで見る |
diff --git a/issues/PLAN71_tmux-menu.md b/issues/PLAN71_tmux-menu.md
index e0a5c60f..08115369 100644
--- a/issues/PLAN71_tmux-menu.md
+++ b/issues/PLAN71_tmux-menu.md
@@ -91,8 +91,9 @@
       symlink として作る。建てた base イメージの `PATH` から `tmux-menu` を呼べる
 - [ ] 11. `prefix S` と `prefix s` の割り当ては、変更前と同じ UI を、キーを押した端末の pane に
       開く。`prefix S` の割り当ての文字列を見る既存の静的テスト `test_prefix_s_opens_session_chooser`
-      は、新しい割り当て（`run-shell` で `tmux-menu` を呼ぶ）を見る形へ書き換える。それ以外の既存の
-      テストはそのまま通る
+      は、新しい割り当て（`run-shell` で `tmux-menu` を呼ぶ）を見る形へ書き換える。テスト基盤の
+      `SHORT_NAMES` に `tmux-menu` を足したうえで、それ以外の既存のテスト（`prefix S` から開く
+      `test_prefix_s_passes_selected_id_and_client` と `test_menu_*` を含む）は中身を変えずに通る
 - [ ] 12. `tmux-first` / `tmux-clean` の差分が 0 行
 - [ ] 13. `containers/base/tmux-*` の shellcheck が 0 件、全体の pytest が通る
 - [ ] 14. 利用者向け文書に `tmux-menu` の使い方と、ホストで使うときの symlink の手順

From bb8eb7f7d9c236f32d20049d73a4d562c4115aa8 Mon Sep 17 00:00:00 2001
From: "takemi.ohama" <takemi.ohama@gmail.com>
Date: Thu, 24 Sep 2026 21:13:00 +0900
Subject: [PATCH 4/8] =?UTF-8?q?=E8=A8=AD=E8=A8=88(PLAN71):=20=E8=A1=8C=201?=
 =?UTF-8?q?1=20=E3=81=AE=E3=83=86=E3=82=B9=E3=83=88=E3=81=8C=E7=B8=9B?=
 =?UTF-8?q?=E3=82=8B=E3=81=AE=E3=81=AF=20TMUX=5FPANE=20=E3=81=AE=20pane=20?=
 =?UTF-8?q?=E3=81=AB=E5=87=BA=E3=82=8B=E6=8C=AF=E3=82=8B=E8=88=9E=E3=81=84?=
 =?UTF-8?q?=E3=81=A8=E5=AE=9F=E6=B8=AC=E3=81=A7=E7=9B=B4=E3=81=99?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

-t 無し・TMUX_PANE 有りで choose-tree を呼ぶ実測 7a〜7c を足した。tmux は端末を
持たないクライアントの現在の pane を環境の TMUX_PANE で決めるため、-t を落としても
一覧は TMUX_PANE の pane に出る。行 11 の足すテストから「-t を落とすと落ちる」の主張を
消し、「TMUX_PANE の pane に出る」振る舞いを縛るテストと書き直した（行 1 も揃えた）。
決定 4 は -t を意図の明示と保険として残し、理由を実測に合わせた。

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 issues/PLAN71_tmux-menu-design.md  | 26 +++++++++++++++++++++++---
 issues/PLAN71_tmux-menu-measure.py | 24 ++++++++++++++++++++++++
 2 files changed, 47 insertions(+), 3 deletions(-)

diff --git a/issues/PLAN71_tmux-menu-design.md b/issues/PLAN71_tmux-menu-design.md
index 7f2405f4..f7a1b478 100644
--- a/issues/PLAN71_tmux-menu-design.md
+++ b/issues/PLAN71_tmux-menu-design.md
@@ -71,6 +71,13 @@ pane を継がず、全セッションから直近に操作されたセッショ
 `run-shell` は渡された文字列の `#{…}` を先に展開するため、`TMUX_PANE=#{pane_id} tmux-menu` と
 書けば押した pane の ID（`%3` の形。引用の要らない文字だけ）が渡る（実測の 6）。
 
+一覧を出す pane を決めるのは `TMUX_PANE` そのものである。tmux は、端末を持たないクライアントから
+来たコマンドの現在の pane を、そのクライアントの環境の `TMUX_PANE` で決める（tmux の `cmd-find.c`
+の `cmd_find_inside_pane`）。`-t` の無い `choose-tree` でも、`TMUX_PANE` があればその pane に出る
+（実測の 7a）。それでも `tmux-menu` は `TMUX_PANE` を `-t` にも渡す。どの pane に出すかをコマンドの
+行に書いて意図を読めるようにし、tmux が環境から現在の pane を引く規則に頼らないためである。
+`-t` は保険であり、`-t` の有無で振る舞いは変わらない（実測の 7a・7b）。
+
 `tmux-menu` に `-t` のオプションを足して ID を渡す案は採らない。`menu` の受け付ける形が増え、
 tmux の中でコマンドを打つ形（`TMUX_PANE` がシェルにある）と同じ入口に揃わない。
 
@@ -80,7 +87,8 @@ tmux の中でコマンドを打つ形（`TMUX_PANE` がシェルにある）と
 （`python3 issues/PLAN71_tmux-menu-measure.py`。一時ディレクトリのソケットでサーバを立て、利用者の
 サーバに触れない）。`python3` の `pty` で端末を繋ぎ、`tmux-session` の代わりに引数を書き出すだけの
 偽物を置く。一覧を開くスクリプト `open-list` は `tmux-menu` の代わりで、`TMUX_PANE` があれば
-`-t "$TMUX_PANE"` を付けて次の `<template>` で `choose-tree -Zs -O name` を実行する。セッションは
+`-t "$TMUX_PANE"` を付けて次の `<template>` で `choose-tree -Zs -O name` を実行する。`open-list-no-t`
+は `open-list` から `-t` を落としたもので、`TMUX_PANE` があっても `-t` に使わない。セッションは
 `a`・`it's`（`'` を含む）・`b` の 3 つで、端末 `/dev/ttys024` が `a` に、`/dev/ttys025` が `b` に
 繋がっている（端末の名前は実行ごとに変わる）。一覧では 1 つ上を選んで Enter を押した。
 
@@ -92,6 +100,9 @@ tmux の中でコマンドを打つ形（`TMUX_PANE` がシェルにある）と
 | 4 | `bind-key S run-shell open-list` を `a` の端末で押す | `a` | `menu -c /dev/ttys024 $1` → `it's` | 正しい |
 | 5 | 4 の形（1 秒待ってから開く `open-list-slow`）で、押した直後に `b` の端末へ 1 文字打つ | **`b`** | （選んでいない） | **誤り** |
 | 6 | `bind-key S run-shell "TMUX_PANE=#{pane_id} open-list-slow"` で 5 と同じ操作。続けて選んで Enter | `a` | `menu -c /dev/ttys024 $1` → `it's` | 正しい |
+| 7a | `b` の端末へ 1 文字打って直近を `b` にしてから、端末を持たないプロセスで `a` の pane の `TMUX`・`TMUX_PANE` を渡して `-t` を付けない `open-list-no-t` を実行する（テストの `tm.run("tmux-menu", env=tm.inside_env(home))` と同じ形） | `a` | （選んでいない） | 正しい（`-t` が無くても `TMUX_PANE` の pane に出る） |
+| 7b | 7a と同じ操作で、`-t "$TMUX_PANE"` を付ける `open-list` を実行する | `a` | （選んでいない） | 正しい |
+| 7c | 7a と同じ操作で、`TMUX_PANE` を渡さずに `open-list-no-t` を実行する | **`b`** | （選んでいない） | 直近の端末に出る |
 
 スクリプトの出力（抜粋。`panes` は `セッション:pane:モード`）:
 
@@ -107,6 +118,12 @@ tmux の中でコマンドを打つ形（`TMUX_PANE` がシェルにある）と
   panes: ['a:%0:tree-mode', 'b:%2:', "it's:%1:"]
 ## 6b same binding, pick and Enter
   menu args: 'menu -c /dev/ttys024 $1' -> "menu -c /dev/ttys024 it's"
+## 7 no tty, b typed last, TMUX_PANE=%0: 7a open-list-no-t, TMUX_PANE=a's pane
+  panes: ['a:%0:tree-mode', 'b:%2:', "it's:%1:"]
+## 7 no tty, b typed last, TMUX_PANE=%0: 7b open-list (-t), TMUX_PANE=a's pane
+  panes: ['a:%0:tree-mode', 'b:%2:', "it's:%1:"]
+## 7 no tty, b typed last, TMUX_PANE=None: 7c open-list-no-t, no TMUX_PANE
+  panes: ['a:%0:', 'b:%2:tree-mode', "it's:%1:"]
 ```
 
 `<template>` は今の `prefix S` の行と同じ次の文字列である。
@@ -121,6 +138,9 @@ run-shell -t "%%%" "tmux-session menu -c #{q:client_name} #{q:session_id}"
 - `run-shell` から起動したシェルでは `TMUX` はあり、`TMUX_PANE` は無い。`-t` の無い
   `choose-tree` は直近に操作されたセッションの pane に出る。4 で正しく見えたのは、押した端末が
   直近だったからにすぎない（5）
+- 端末を持たないクライアントでは、`-t` が無くても環境の `TMUX_PANE` が現在の pane を決める（7a）。
+  `TMUX_PANE` が無いときだけ直近の端末に出る（7c）。`-t "$TMUX_PANE"` を付けても付けなくても
+  結果は同じである（7a・7b）
 - tmux の外からの `attach` は、端末の繋がっていないセッションを優先する（2）
 
 ## 入出力の契約
@@ -252,7 +272,7 @@ Enter の後は PLAN69 の `menu` の流れと同じである。
 
 | 受け入れ条件 | 何で確かめるか |
 | --- | --- |
-| 1 | tmux の中の端末のプロンプトへ `tmux-menu` を打ち、その端末の `#{pane_mode}` が `tree-mode` になることを見る。一覧を出す pane を `TMUX_PANE` で決めることは行 11 の足すテストで縛る |
+| 1 | tmux の中の端末のプロンプトへ `tmux-menu` を打ち、その端末の `#{pane_mode}` が `tree-mode` になることを見る。一覧が `TMUX_PANE` の pane に出る（直近に操作された別の端末には出ない）ことは行 11 の足すテストで縛る |
 | 2 | 1 の後に 1 つ上を選んで Enter を押し、偽の `tmux-session` へ `menu -c <押した端末> <選んだ ID>` が渡ることを見る。`'` を含む名前を含める |
 | 3 | 本物の `tmux-session` で 1 → 選ぶ → `a` を送り、押した端末が選んだセッションへ移り、そこに繋がっていた他の端末が外れることを `list-clients` で見る |
 | 4 | tmux の外の端末で `tmux-menu` を起動し、端末がサーバに繋がり `tree-mode` になることを見る |
@@ -262,7 +282,7 @@ Enter の後は PLAN69 の `menu` の流れと同じである。
 | 8 | `tmux-menu` と `tmux-session menu` で 1・6 を両方の名前で走らせる（parametrize） |
 | 9 | `-c` だけ・余分な引数・知らないオプションで終了コード 2。`tmux-menu -h` が 0 で、`tmux-session -h` の出力に `tmux-menu` が含まれる |
 | 10 | Dockerfile の symlink の `RUN` に `tmux-menu` が含まれることを固定する（`SHORT_NAMES` を足した `test_dockerfile_links_short_names`）。建てたイメージで `command -v tmux-menu` を見る |
-| 11 | **書き換える既存テスト:** `test_prefix_s_opens_session_chooser`（`tests/containers/test_tmux_conf.py`）は割り当てに `choose-tree` と `tmux-session menu` が含まれることを見ており、決定 2 で落ちる。割り当てがちょうど 1 つで、`run-shell` が `TMUX_PANE=#{pane_id} tmux-menu` を呼ぶことを見る形へ改める。**基盤更新で通る既存テスト:** `test_prefix_s_passes_selected_id_and_client` と、`prefix S` から開く `test_menu_*` 4 件（「テスト基盤の更新」の表）。中身は変えない。**足すテスト:** 時間の競合に頼らず、`TMUX_PANE` の pane に一覧が出ることを見る。`home` と `other` の 2 つのセッションを作り、`tm.attach(home)` の後に `tm.attach(other)` で繋いだ端末へ 1 文字送って直近に操作された端末を `other` にする。そのうえで `tm.run("tmux-menu", env=tm.inside_env(home))` を実行し、`home` の pane の `#{pane_mode}` が `tree-mode` になり、`other` の pane はならないことを見る。`-t "$TMUX_PANE"` を実装から落とすと、一覧は直近の `other` に出て落ちる。`prefix S` が `TMUX_PANE=#{pane_id}` を渡すことは、書き換える静的テストが縛る。実測の 5・6 のような、押した直後に別の端末へ打つテストは、本物の `tmux-menu` では `choose-tree` までの間が数十 ms しかなく `-t` の有無を区別できないため採らない。`prefix s` は既定のまま |
+| 11 | **書き換える既存テスト:** `test_prefix_s_opens_session_chooser`（`tests/containers/test_tmux_conf.py`）は割り当てに `choose-tree` と `tmux-session menu` が含まれることを見ており、決定 2 で落ちる。割り当てがちょうど 1 つで、`run-shell` が `TMUX_PANE=#{pane_id} tmux-menu` を呼ぶことを見る形へ改める。**基盤更新で通る既存テスト:** `test_prefix_s_passes_selected_id_and_client` と、`prefix S` から開く `test_menu_*` 4 件（「テスト基盤の更新」の表）。中身は変えない。**足すテスト:** 時間の競合に頼らず、`TMUX_PANE` の pane に一覧が出ることを見る。`home` と `other` の 2 つのセッションを作り、`tm.attach(home)` の後に `tm.attach(other)` で繋いだ端末へ 1 文字送って直近に操作された端末を `other` にする。そのうえで `tm.run("tmux-menu", env=tm.inside_env(home))` を実行し、`home` の pane の `#{pane_mode}` が `tree-mode` になり、`other` の pane はならないことを見る。このテストが縛るのは「一覧が `TMUX_PANE` の pane に出る」という振る舞いであり、`-t "$TMUX_PANE"` の分岐ではない。tmux は `-t` が無くても環境の `TMUX_PANE` で現在の pane を決めるため、`-t` を実装から落としてもこのテストは通る（実測の 7a・7b）。`TMUX_PANE` を渡さない・読み捨てるといった壊し方で落ちる（実測の 7c）。`prefix S` が `TMUX_PANE=#{pane_id}` を渡すことは、書き換える静的テストが縛る。実測の 5・6 のような、押した直後に別の端末へ打つテストは、本物の `tmux-menu` では `choose-tree` までの間が数十 ms しかなく `-t` の有無を区別できないため採らない。`prefix s` は既定のまま |
 | 12 | `git diff --stat main` に `tmux-first` / `tmux-clean` が現れない |
 | 13 | `shellcheck containers/base/tmux-*` と全体の pytest |
 | 14 | 文書の差分をレビューで見る |
diff --git a/issues/PLAN71_tmux-menu-measure.py b/issues/PLAN71_tmux-menu-measure.py
index 63e03be0..86f7d05c 100755
--- a/issues/PLAN71_tmux-menu-measure.py
+++ b/issues/PLAN71_tmux-menu-measure.py
@@ -26,6 +26,8 @@
         "#!/bin/sh\n"
         f"exec tmux choose-tree ${{TMUX_PANE:+-t \"$TMUX_PANE\"}} -Zs -O name '{TEMPLATE}'\n"
     ),
+    # open-list から -t を落としたもの（TMUX_PANE があっても -t に使わない）
+    "open-list-no-t": f"#!/bin/sh\nexec tmux choose-tree -Zs -O name '{TEMPLATE}'\n",
     # 一覧が開くまでの間に別の端末を操作するため、1 秒待ってから開く
     "open-list-slow": "#!/bin/sh\nsleep 1\nexec open-list\n",
 }
@@ -164,6 +166,28 @@ def main():
     pick(c1)
     state("6b same binding, pick and Enter")
 
+    # 7. 端末の無いプロセスから、a の pane の TMUX / TMUX_PANE を持って呼ぶ
+    #    （テストの tm.run(..., env=tm.inside_env(home)) と同じ形）。先に b の端末へ打って直近を b にする
+    tmux_var = t("display-message", "-p", "-t", "=a:", "#{socket_path},#{pid},0")
+    a_pane = t("display-message", "-p", "-t", "=a:", "#{pane_id}")
+    for label, prog, pane in (
+        ("7a open-list-no-t, TMUX_PANE=a's pane", "open-list-no-t", a_pane),
+        ("7b open-list (-t), TMUX_PANE=a's pane", "open-list", a_pane),
+        ("7c open-list-no-t, no TMUX_PANE", "open-list-no-t", None),
+    ):
+        reset()
+        os.write(c2, b"x")
+        time.sleep(0.5)
+        env = dict(ENV, TMUX=tmux_var)
+        if pane:
+            env["TMUX_PANE"] = pane
+        subprocess.Popen(
+            [prog], env=env, stdin=subprocess.DEVNULL,
+            stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL,
+        )
+        time.sleep(1)
+        state(f"7 no tty, b typed last, TMUX_PANE={pane}: {label}")
+
     t("kill-server")
 
 

From 85f4b26317684a0b15677a30ef69d9d68c658b61 Mon Sep 17 00:00:00 2001
From: "takemi.ohama" <takemi.ohama@gmail.com>
Date: Thu, 24 Sep 2026 21:19:14 +0900
Subject: [PATCH 5/8] =?UTF-8?q?=E8=A8=AD=E8=A8=88(PLAN71):=20=E6=9D=A1?=
 =?UTF-8?q?=E4=BB=B6=208=20=E3=81=AE=E3=83=86=E3=82=B9=E3=83=88=E3=81=AB?=
 =?UTF-8?q?=E3=83=A1=E3=83=8B=E3=83=A5=E3=83=BC=E3=82=92=E5=87=BA=E3=81=99?=
 =?UTF-8?q?=E5=BD=A2=E3=82=92=20tmux-menu=20=E5=90=8D=E3=81=A7=E8=B5=B0?=
 =?UTF-8?q?=E3=82=89=E3=81=9B=E3=82=8B=E8=A1=8C=E3=82=92=E8=B6=B3=E3=81=99?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

`tmux-menu -c 端末 <セッション>` も今の形のメニューを出すという契約を縛れるよう、
テスト設計の行 8 に両方の名前で -c 形を呼ぶテストを足し、受け入れ条件 8 に
2 つの形の両方で成り立つことを明記する。

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 issues/PLAN71_tmux-menu-design.md | 2 +-
 issues/PLAN71_tmux-menu.md        | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/issues/PLAN71_tmux-menu-design.md b/issues/PLAN71_tmux-menu-design.md
index f7a1b478..0fb13c9a 100644
--- a/issues/PLAN71_tmux-menu-design.md
+++ b/issues/PLAN71_tmux-menu-design.md
@@ -279,7 +279,7 @@ Enter の後は PLAN69 の `menu` の流れと同じである。
 | 5 | 4 の後に 2 と同じく選んで Enter を押し、`menu -c <その端末> <選んだ ID>` が渡ることを見る |
 | 6 | サーバの無い環境で `tmux-menu` を実行し、終了コード 1・標準エラーの理由・実行後もサーバが無いことを見る |
 | 7 | 既存の `menu` のテスト（`test_menu_*`）が中身を変えずに通る。`prefix S` を通るものは「テスト基盤の更新」の後に通る |
-| 8 | `tmux-menu` と `tmux-session menu` で 1・6 を両方の名前で走らせる（parametrize） |
+| 8 | 2 つの形をどちらも両方の名前で走らせる。**一覧を開く形:** `tmux-menu` と `tmux-session menu` で 1・6 を走らせる（parametrize）。**メニューを出す形:** `ui_tm` で `target = tm.new("devbase-3")` と `me = tm.attach(tm.new("zz-home"))` を作り、`cmd` = `f"tmux-menu -c {me.tty} {target}"` / `f"tmux-session menu -c {me.tty} {target}"` で parametrize し、`test_menu_notifies_client_on_failure` と同じく `tm.tmux("run-shell", "-b", cmd)` で呼ぶ（`display-menu` が閉じるまで戻らない場合に備え、テストの側で待たない）。どちらの名前でも `me` の端末に同じメニュー（`test_menu_peek_opens_popup` と同じく `中身を見る` の項目）が出ることを見る。`fake_tm` の record では確かめられない。偽物に置き換わるのは `tmux-session` だけで、`bin` の `tmux-menu` は本物のスクリプトへの symlink のまま `display-menu` を出し、`tmux-session` を呼ばないため |
 | 9 | `-c` だけ・余分な引数・知らないオプションで終了コード 2。`tmux-menu -h` が 0 で、`tmux-session -h` の出力に `tmux-menu` が含まれる |
 | 10 | Dockerfile の symlink の `RUN` に `tmux-menu` が含まれることを固定する（`SHORT_NAMES` を足した `test_dockerfile_links_short_names`）。建てたイメージで `command -v tmux-menu` を見る |
 | 11 | **書き換える既存テスト:** `test_prefix_s_opens_session_chooser`（`tests/containers/test_tmux_conf.py`）は割り当てに `choose-tree` と `tmux-session menu` が含まれることを見ており、決定 2 で落ちる。割り当てがちょうど 1 つで、`run-shell` が `TMUX_PANE=#{pane_id} tmux-menu` を呼ぶことを見る形へ改める。**基盤更新で通る既存テスト:** `test_prefix_s_passes_selected_id_and_client` と、`prefix S` から開く `test_menu_*` 4 件（「テスト基盤の更新」の表）。中身は変えない。**足すテスト:** 時間の競合に頼らず、`TMUX_PANE` の pane に一覧が出ることを見る。`home` と `other` の 2 つのセッションを作り、`tm.attach(home)` の後に `tm.attach(other)` で繋いだ端末へ 1 文字送って直近に操作された端末を `other` にする。そのうえで `tm.run("tmux-menu", env=tm.inside_env(home))` を実行し、`home` の pane の `#{pane_mode}` が `tree-mode` になり、`other` の pane はならないことを見る。このテストが縛るのは「一覧が `TMUX_PANE` の pane に出る」という振る舞いであり、`-t "$TMUX_PANE"` の分岐ではない。tmux は `-t` が無くても環境の `TMUX_PANE` で現在の pane を決めるため、`-t` を実装から落としてもこのテストは通る（実測の 7a・7b）。`TMUX_PANE` を渡さない・読み捨てるといった壊し方で落ちる（実測の 7c）。`prefix S` が `TMUX_PANE=#{pane_id}` を渡すことは、書き換える静的テストが縛る。実測の 5・6 のような、押した直後に別の端末へ打つテストは、本物の `tmux-menu` では `choose-tree` までの間が数十 ms しかなく `-t` の有無を区別できないため採らない。`prefix s` は既定のまま |
diff --git a/issues/PLAN71_tmux-menu.md b/issues/PLAN71_tmux-menu.md
index 08115369..a95880a2 100644
--- a/issues/PLAN71_tmux-menu.md
+++ b/issues/PLAN71_tmux-menu.md
@@ -83,7 +83,8 @@
 
 - [ ] 7. `tmux-session menu -c 端末 <セッション>`（`prefix S` の割り当てとホストの
       `~/.tmux.conf` の行が呼ぶ形）は、今までと同じメニューを出す
-- [ ] 8. `tmux-menu` と、それに当たる `tmux-session` のサブコマンドの形が同じ振る舞いをする
+- [ ] 8. `tmux-menu` と、それに当たる `tmux-session` のサブコマンドの形が同じ振る舞いをする。
+      一覧を開く形（引数なし）と、メニューを出す形（`-c 端末 <セッション>`）の両方で成り立つ
 - [ ] 9. 知らないオプション・余分な引数では終了コード 2 で、理由を標準エラーへ出す。
       `tmux-menu -h` は使い方を出して終了コード 0 で終わる。`tmux-session -h` の使い方に
       `tmux-menu` が載る

From 43db2820ecd913c5c287e8be7f5037c59268995e Mon Sep 17 00:00:00 2001
From: "takemi.ohama" <takemi.ohama@gmail.com>
Date: Thu, 24 Sep 2026 21:29:40 +0900
Subject: [PATCH 6/8] =?UTF-8?q?=E8=A8=AD=E8=A8=88(PLAN71):=20=E6=9D=A1?=
 =?UTF-8?q?=E4=BB=B6=201=E3=83=BB2=E3=83=BB4=E3=80=9C6=E3=83=BB8=20?=
 =?UTF-8?q?=E3=81=AE=E7=A2=BA=E3=81=8B=E3=82=81=E6=96=B9=E3=81=AB=E3=83=95?=
 =?UTF-8?q?=E3=82=A3=E3=82=AF=E3=82=B9=E3=83=81=E3=83=A3=E3=81=A8=E8=B5=B7?=
 =?UTF-8?q?=E5=8B=95=E3=81=AE=E5=BD=A2=E3=82=92=E6=98=8E=E8=A8=98=E3=81=97?=
 =?UTF-8?q?=E3=80=81run-shell=20=E3=81=AE=20ID=20=E3=82=92=E5=BC=95?=
 =?UTF-8?q?=E7=94=A8=E3=81=99=E3=82=8B?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 行 8 のメニューを出す形は target (ID `$0`) を shlex.quote で引用する。run-shell は sh -c に渡すため
  引用しないと `$0` が sh に展開される
- 行 1 は ui_tm で、プロンプトへは tm.bin の絶対パスで打つ。fake_tm では名前の tmux-session が
  fake/ の偽物に解決される
- 行 2・3・4・5・6 もフィクスチャと起動の形 (tm.bin の絶対パス / tm.spawn / tm.run) を明記する

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 issues/PLAN71_tmux-menu-design.md | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/issues/PLAN71_tmux-menu-design.md b/issues/PLAN71_tmux-menu-design.md
index 0fb13c9a..2e4c0912 100644
--- a/issues/PLAN71_tmux-menu-design.md
+++ b/issues/PLAN71_tmux-menu-design.md
@@ -272,14 +272,14 @@ Enter の後は PLAN69 の `menu` の流れと同じである。
 
 | 受け入れ条件 | 何で確かめるか |
 | --- | --- |
-| 1 | tmux の中の端末のプロンプトへ `tmux-menu` を打ち、その端末の `#{pane_mode}` が `tree-mode` になることを見る。一覧が `TMUX_PANE` の pane に出る（直近に操作された別の端末には出ない）ことは行 11 の足すテストで縛る |
-| 2 | 1 の後に 1 つ上を選んで Enter を押し、偽の `tmux-session` へ `menu -c <押した端末> <選んだ ID>` が渡ることを見る。`'` を含む名前を含める |
-| 3 | 本物の `tmux-session` で 1 → 選ぶ → `a` を送り、押した端末が選んだセッションへ移り、そこに繋がっていた他の端末が外れることを `list-clients` で見る |
-| 4 | tmux の外の端末で `tmux-menu` を起動し、端末がサーバに繋がり `tree-mode` になることを見る |
-| 5 | 4 の後に 2 と同じく選んで Enter を押し、`menu -c <その端末> <選んだ ID>` が渡ることを見る |
-| 6 | サーバの無い環境で `tmux-menu` を実行し、終了コード 1・標準エラーの理由・実行後もサーバが無いことを見る |
+| 1 | `ui_tm` で、tmux の中の端末のプロンプトへ `tmux-menu` を打ち、その端末の `#{pane_mode}` が `tree-mode` になることを見る。プロンプトへは名前ではなく `tm.bin` の絶対パスで打つ（`me.send(f"{tm.bin}/tmux-menu\r")`、行 8 の `tmux-session menu` の側は `f"{tm.bin}/tmux-session menu\r"`）。pane のシェルはテストの環境の `PATH` を引き継ぐため、`fake_tm` で名前で打った `tmux-session` は `fake/` の偽物に解決されて一覧が開かない。絶対パスにしておけば、どのフィクスチャで打っても本物が動く。一覧が `TMUX_PANE` の pane に出る（直近に操作された別の端末には出ない）ことは行 11 の足すテストで縛る |
+| 2 | `fake_tm` で 1 と同じく `f"{tm.bin}/tmux-menu\r"` を打って一覧を開き、1 つ上を選んで Enter を押し、偽の `tmux-session` へ `menu -c <押した端末> <選んだ ID>` が渡ることを見る。`'` を含む名前を含める |
+| 3 | `ui_tm`（本物の `tmux-session`）で 1 → 選ぶ → `a` を送り、押した端末が選んだセッションへ移り、そこに繋がっていた他の端末が外れることを `list-clients` で見る |
+| 4 | `ui_tm` で、tmux の外の端末として `tm.spawn([str(tm.bin / "tmux-menu")])` を起動し、端末がサーバに繋がり `tree-mode` になることを見る |
+| 5 | `fake_tm` で 4 と同じく `tm.spawn([str(tm.bin / "tmux-menu")])` で開き、2 と同じく選んで Enter を押し、`menu -c <その端末> <選んだ ID>` が渡ることを見る |
+| 6 | `tm` のサーバの無い環境で `tm.run("tmux-menu")` を実行し（`tm.run` は `bin` の絶対パスで起動する）、終了コード 1・標準エラーの理由・実行後もサーバが無いことを見る |
 | 7 | 既存の `menu` のテスト（`test_menu_*`）が中身を変えずに通る。`prefix S` を通るものは「テスト基盤の更新」の後に通る |
-| 8 | 2 つの形をどちらも両方の名前で走らせる。**一覧を開く形:** `tmux-menu` と `tmux-session menu` で 1・6 を走らせる（parametrize）。**メニューを出す形:** `ui_tm` で `target = tm.new("devbase-3")` と `me = tm.attach(tm.new("zz-home"))` を作り、`cmd` = `f"tmux-menu -c {me.tty} {target}"` / `f"tmux-session menu -c {me.tty} {target}"` で parametrize し、`test_menu_notifies_client_on_failure` と同じく `tm.tmux("run-shell", "-b", cmd)` で呼ぶ（`display-menu` が閉じるまで戻らない場合に備え、テストの側で待たない）。どちらの名前でも `me` の端末に同じメニュー（`test_menu_peek_opens_popup` と同じく `中身を見る` の項目）が出ることを見る。`fake_tm` の record では確かめられない。偽物に置き換わるのは `tmux-session` だけで、`bin` の `tmux-menu` は本物のスクリプトへの symlink のまま `display-menu` を出し、`tmux-session` を呼ばないため |
+| 8 | 2 つの形をどちらも両方の名前で走らせる。**一覧を開く形:** `tmux-menu` と `tmux-session menu` で 1・6 を走らせる（parametrize。1 は行 1 のとおり `ui_tm` で `tm.bin` の絶対パスを打ち、6 は `tm.run` で起動する）。**メニューを出す形:** `ui_tm` で `target = tm.new("devbase-3")` と `me = tm.attach(tm.new("zz-home"))` を作り、`cmd` = `f"tmux-menu -c {me.tty} {shlex.quote(target)}"` / `f"tmux-session menu -c {me.tty} {shlex.quote(target)}"` で parametrize し、`test_menu_notifies_client_on_failure` と同じく `tm.tmux("run-shell", "-b", cmd)` で呼ぶ。`tm.new` はセッションの ID を返し、`ui_tm` で最初に作る `devbase-3` の ID は `$0` になる。`run-shell` は文字列を `sh -c` へ渡すため、引用しないと `$0` が `sh` に展開され（実測の 3 と同じ現象）、`tmux-session` は「セッションがありません: sh」で終了コード 1 になる（専用ソケットで `run-shell 'printf "<%s>\n" $0'` が `<sh>`、`'$0'` と引用すると `<$0>` になることを確かめた）。テストのファイルに `import shlex` を足す（`display-menu` が閉じるまで戻らない場合に備え、テストの側で待たない）。どちらの名前でも `me` の端末に同じメニュー（`test_menu_peek_opens_popup` と同じく `中身を見る` の項目）が出ることを見る。`fake_tm` の record では確かめられない。偽物に置き換わるのは `tmux-session` だけで、`bin` の `tmux-menu` は本物のスクリプトへの symlink のまま `display-menu` を出し、`tmux-session` を呼ばないため |
 | 9 | `-c` だけ・余分な引数・知らないオプションで終了コード 2。`tmux-menu -h` が 0 で、`tmux-session -h` の出力に `tmux-menu` が含まれる |
 | 10 | Dockerfile の symlink の `RUN` に `tmux-menu` が含まれることを固定する（`SHORT_NAMES` を足した `test_dockerfile_links_short_names`）。建てたイメージで `command -v tmux-menu` を見る |
 | 11 | **書き換える既存テスト:** `test_prefix_s_opens_session_chooser`（`tests/containers/test_tmux_conf.py`）は割り当てに `choose-tree` と `tmux-session menu` が含まれることを見ており、決定 2 で落ちる。割り当てがちょうど 1 つで、`run-shell` が `TMUX_PANE=#{pane_id} tmux-menu` を呼ぶことを見る形へ改める。**基盤更新で通る既存テスト:** `test_prefix_s_passes_selected_id_and_client` と、`prefix S` から開く `test_menu_*` 4 件（「テスト基盤の更新」の表）。中身は変えない。**足すテスト:** 時間の競合に頼らず、`TMUX_PANE` の pane に一覧が出ることを見る。`home` と `other` の 2 つのセッションを作り、`tm.attach(home)` の後に `tm.attach(other)` で繋いだ端末へ 1 文字送って直近に操作された端末を `other` にする。そのうえで `tm.run("tmux-menu", env=tm.inside_env(home))` を実行し、`home` の pane の `#{pane_mode}` が `tree-mode` になり、`other` の pane はならないことを見る。このテストが縛るのは「一覧が `TMUX_PANE` の pane に出る」という振る舞いであり、`-t "$TMUX_PANE"` の分岐ではない。tmux は `-t` が無くても環境の `TMUX_PANE` で現在の pane を決めるため、`-t` を実装から落としてもこのテストは通る（実測の 7a・7b）。`TMUX_PANE` を渡さない・読み捨てるといった壊し方で落ちる（実測の 7c）。`prefix S` が `TMUX_PANE=#{pane_id}` を渡すことは、書き換える静的テストが縛る。実測の 5・6 のような、押した直後に別の端末へ打つテストは、本物の `tmux-menu` では `choose-tree` までの間が数十 ms しかなく `-t` の有無を区別できないため採らない。`prefix s` は既定のまま |

From 9302a3310cb2c248e396297b0e77bda0d24f558e Mon Sep 17 00:00:00 2001
From: "takemi.ohama" <takemi.ohama@gmail.com>
Date: Thu, 24 Sep 2026 21:42:16 +0900
Subject: [PATCH 7/8] =?UTF-8?q?=E8=A8=AD=E8=A8=88(PLAN71):=20=E7=A2=BA?=
 =?UTF-8?q?=E3=81=8B=E3=82=81=E6=96=B9=E3=81=AE=E8=A1=A8=E3=82=92=E5=AE=9F?=
 =?UTF-8?q?=E3=82=B3=E3=83=BC=E3=83=89=E3=81=A8=E5=AE=9F=E6=B8=AC=E3=81=AB?=
 =?UTF-8?q?=E5=90=88=E3=82=8F=E3=81=9B=E3=81=A6=E5=85=A8=E8=A1=8C=E8=A6=8B?=
 =?UTF-8?q?=E7=9B=B4=E3=81=99?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 一覧は pane へ send-keys で打って開き、1 つ上は send-keys の Up、Enter は押した端末から
  送り直し付きで送る補助 _pick_above を決める（Enter を send-keys で送ると client_name が
  直近の端末になることを実測 8a・8b で確かめた）
- 行 4・5 に外から開くときの組み方（zz-home を端末の無い唯一のセッションにする）と期待値を書く
- 行 11 の落ちる壊し方を「TMUX_PANE を消し、-t にも使わない」だけに直す（実測 7d・7e）
- 行 2・3・6・9 にフィクスチャ・期待値・parametrize を明記し、基盤更新の節の偽 tmux-menu の説明を直す

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 issues/PLAN71_tmux-menu-design.md  | 75 ++++++++++++++++++++++++------
 issues/PLAN71_tmux-menu-measure.py | 31 ++++++++++++
 2 files changed, 93 insertions(+), 13 deletions(-)

diff --git a/issues/PLAN71_tmux-menu-design.md b/issues/PLAN71_tmux-menu-design.md
index 2e4c0912..7e70b095 100644
--- a/issues/PLAN71_tmux-menu-design.md
+++ b/issues/PLAN71_tmux-menu-design.md
@@ -88,7 +88,8 @@ tmux の中でコマンドを打つ形（`TMUX_PANE` がシェルにある）と
 サーバに触れない）。`python3` の `pty` で端末を繋ぎ、`tmux-session` の代わりに引数を書き出すだけの
 偽物を置く。一覧を開くスクリプト `open-list` は `tmux-menu` の代わりで、`TMUX_PANE` があれば
 `-t "$TMUX_PANE"` を付けて次の `<template>` で `choose-tree -Zs -O name` を実行する。`open-list-no-t`
-は `open-list` から `-t` を落としたもので、`TMUX_PANE` があっても `-t` に使わない。セッションは
+は `open-list` から `-t` を落としたもので、`TMUX_PANE` があっても `-t` に使わない。`open-list-unset` は
+`TMUX_PANE` を `unset` してから `-t` を付けずに開き、`open-list-unset-t` は `unset` する前の値を `-t` に使う。セッションは
 `a`・`it's`（`'` を含む）・`b` の 3 つで、端末 `/dev/ttys024` が `a` に、`/dev/ttys025` が `b` に
 繋がっている（端末の名前は実行ごとに変わる）。一覧では 1 つ上を選んで Enter を押した。
 
@@ -103,6 +104,10 @@ tmux の中でコマンドを打つ形（`TMUX_PANE` がシェルにある）と
 | 7a | `b` の端末へ 1 文字打って直近を `b` にしてから、端末を持たないプロセスで `a` の pane の `TMUX`・`TMUX_PANE` を渡して `-t` を付けない `open-list-no-t` を実行する（テストの `tm.run("tmux-menu", env=tm.inside_env(home))` と同じ形） | `a` | （選んでいない） | 正しい（`-t` が無くても `TMUX_PANE` の pane に出る） |
 | 7b | 7a と同じ操作で、`-t "$TMUX_PANE"` を付ける `open-list` を実行する | `a` | （選んでいない） | 正しい |
 | 7c | 7a と同じ操作で、`TMUX_PANE` を渡さずに `open-list-no-t` を実行する | **`b`** | （選んでいない） | 直近の端末に出る |
+| 7d | 7a と同じ操作で、`TMUX_PANE` を渡して `open-list-unset` を実行する | **`b`** | （選んでいない） | 直近の端末に出る（7c と同じ） |
+| 7e | 7a と同じ操作で、`TMUX_PANE` を渡して `open-list-unset-t` を実行する | `a` | （選んでいない） | 正しい（消しても `-t` に値があれば出る） |
+| 8a | `a` の pane へ `send-keys -t =a: <open-list の絶対パス> Enter` でコマンド行を打って一覧を開き、`send-keys -t =a: Up` で 1 つ上へ動かす。`b` の端末へ 1 文字打ってから `send-keys -t =a: Enter` | `a` | `menu -c /dev/ttys025 $1` → `it's`（端末は **`b`** のもの） | Enter を `send-keys` で送ると、`#{client_name}` は直近に操作された端末になる |
+| 8b | 8a と同じ操作で、Enter だけを `a` の端末から送る | `a` | `menu -c /dev/ttys024 $1` → `it's` | 正しい（`send-keys` で開いた一覧でも、`send-keys` の `Up` は効く） |
 
 スクリプトの出力（抜粋。`panes` は `セッション:pane:モード`）:
 
@@ -124,6 +129,14 @@ tmux の中でコマンドを打つ形（`TMUX_PANE` がシェルにある）と
   panes: ['a:%0:tree-mode', 'b:%2:', "it's:%1:"]
 ## 7 no tty, b typed last, TMUX_PANE=None: 7c open-list-no-t, no TMUX_PANE
   panes: ['a:%0:', 'b:%2:tree-mode', "it's:%1:"]
+## 7 no tty, b typed last, TMUX_PANE=%0: 7d open-list-unset, TMUX_PANE=a's pane
+  panes: ['a:%0:', 'b:%2:tree-mode', "it's:%1:"]
+## 7 no tty, b typed last, TMUX_PANE=%0: 7e open-list-unset-t, TMUX_PANE=a's pane
+  panes: ['a:%0:tree-mode', 'b:%2:', "it's:%1:"]
+## 8a Enter by send-keys (open by send-keys, b typed last)
+  menu args: 'menu -c /dev/ttys025 $1' -> "menu -c /dev/ttys025 it's"
+## 8b Enter by a's terminal (open by send-keys, b typed last)
+  menu args: 'menu -c /dev/ttys024 $1' -> "menu -c /dev/ttys024 it's"
 ```
 
 `<template>` は今の `prefix S` の行と同じ次の文字列である。
@@ -140,7 +153,11 @@ run-shell -t "%%%" "tmux-session menu -c #{q:client_name} #{q:session_id}"
   直近だったからにすぎない（5）
 - 端末を持たないクライアントでは、`-t` が無くても環境の `TMUX_PANE` が現在の pane を決める（7a）。
   `TMUX_PANE` が無いときだけ直近の端末に出る（7c）。`-t "$TMUX_PANE"` を付けても付けなくても
-  結果は同じである（7a・7b）
+  結果は同じである（7a・7b）。実装の中で `TMUX_PANE` を消しても、消す前の値を `-t` に使えば
+  出る pane は変わらない（7d・7e）
+- `send-keys` で pane へ送ったキーは、その pane の一覧を動かす。ただし一覧の Enter で展開される
+  `#{client_name}` は、`send-keys` では pane に繋がった端末ではなく直近に操作された端末になる
+  （8a）。押した端末の名前を確かめるには、Enter をその端末から送る（8b）
 - tmux の外からの `attach` は、端末の繋がっていないセッションを優先する（2）
 
 ## 入出力の契約
@@ -251,8 +268,8 @@ Enter の後は PLAN69 の `menu` の流れと同じである。
 は `SHORT_NAMES` の追加だけで `fake_tm` にもできる。**`fake/` には `tmux-menu` を置かない。** `prefix S`
 の `tmux-menu` は本物で一覧を開き、Enter の後に template が呼ぶ `tmux-session menu -c …` だけを
 `fake/` の偽物が受ける必要がある。`fake/` に偽の `tmux-session` を指す `tmux-menu` を置くと、
-`prefix S` が引数の無い `menu` を書き出すだけで一覧が開かず、`test_prefix_s_passes_selected_id_and_client`
-が落ちる。
+`prefix S` の `tmux-menu` は偽物になり、空の引数を書き出すだけで一覧を開かない。
+`test_prefix_s_passes_selected_id_and_client` は `_open_tree` が `tree-mode` を待ち切れずに落ちる。
 
 `SHORT_NAMES` を足さないままでは `bin` に `tmux-menu` が無く、`prefix S` の `run-shell` がコマンドを
 見つけられない。`prefix S` から一覧を開く既存テストは、中身を変えずに、この基盤更新で通る。
@@ -270,19 +287,51 @@ Enter の後は PLAN69 の `menu` の流れと同じである。
 
 ### 条件ごとの確かめ方
 
+表の行を読む前提として、一覧の開き方・選び方と、端末の置き方を先に決める。
+
+**一覧の開き方（tmux の中）。** pane のプロンプトへコマンド行を打つときは、繋いだ端末（`me.send`）
+ではなく pane へ直接送る。`tm.tmux("send-keys", "-t", home, f"{tm.bin}/tmux-menu", "Enter")`
+（`tmux-session` の側は `f"{tm.bin}/tmux-session menu"`）。`_open_tree` のコメントのとおり、繋いだ
+直後の端末は入力を捨てることがあり、コマンド行の一部が落ちると送り直しても残骸が行に残る。
+`send-keys` は端末を通らずに pane へ届き、pane のシェルは `home` の pane の `TMUX_PANE` を持つ。
+コマンドは名前ではなく `tm.bin` の絶対パスで打つ。pane のシェルはログインシェルで、`PATH` は
+テストの環境の `PATH`（`fake_tm` では `fake/` が先頭）が元になる。名前で打つと、`fake_tm` では
+`tmux-session` が `fake/` の偽物に解決されて一覧が開かず、`/etc/profile` が `PATH` を並べ替える
+環境では解決先がさらに変わりうる。一覧が開いたことは `tm.tmux("display-message", "-p", "-t", home,
+"#{pane_mode}")` が `tree-mode` になるのを `_wait` で待って確かめる。
+
+**一覧の開き方（tmux の外）。** `me = tm.spawn([str(tm.bin / "tmux-menu")])`。attach 先は tmux の
+既定で、端末の繋がっていないセッションを優先し、同じ条件の中では直近に使ったものになる（実測の 2）。
+行 4・5 は `target = tm.new(<名前>)`・`home = tm.new("zz-home")`・`tm.attach(target)` の順に作り、
+`zz-home` を端末の無いただ 1 つのセッションにする。`me` は `zz-home` に繋がり
+（`_wait(lambda: tm.all_clients().get(me.tty) == home)`）、その pane が `tree-mode` になる。
+
+**1 つ上を選ぶ（テストに足す補助 `_pick_above(tm, me, sid)`）。** 一覧は名前順（`-O name`）で、
+カーソルは開いた pane のセッション `zz-home` にある。どのテストでも選ぶセッションの名前は
+`zz-home` より前に並ぶため、1 つ上が選ぶセッションになる。
+
+1. `tm.tmux("send-keys", "-t", sid, "Up")` で 1 つ上へ動かす。`send-keys` のキーは端末を通らずに一覧を
+   動かす（実測の 8b）
+2. Enter は `me.send("\r")` で `me` の端末から送る。一覧の template の `#{client_name}` は Enter を押した
+   端末に展開されるが、`send-keys` で送った Enter では直近に操作された端末になり（実測の 8a）、押した
+   端末を確かめられない
+3. `me` は繋いだ直後で Enter を捨てることがある。`sid` の pane が `tree-mode` のままなら、2 秒待つごとに
+   Enter を送り直す（`_open_tree` と同じ回数）。`tree-mode` を抜けたら送らない。抜けたことは `me` が入力を
+   受け付けている証拠になり、その後に `me` へ送る `a` / `p` / `k` は捨てられない
+
 | 受け入れ条件 | 何で確かめるか |
 | --- | --- |
-| 1 | `ui_tm` で、tmux の中の端末のプロンプトへ `tmux-menu` を打ち、その端末の `#{pane_mode}` が `tree-mode` になることを見る。プロンプトへは名前ではなく `tm.bin` の絶対パスで打つ（`me.send(f"{tm.bin}/tmux-menu\r")`、行 8 の `tmux-session menu` の側は `f"{tm.bin}/tmux-session menu\r"`）。pane のシェルはテストの環境の `PATH` を引き継ぐため、`fake_tm` で名前で打った `tmux-session` は `fake/` の偽物に解決されて一覧が開かない。絶対パスにしておけば、どのフィクスチャで打っても本物が動く。一覧が `TMUX_PANE` の pane に出る（直近に操作された別の端末には出ない）ことは行 11 の足すテストで縛る |
-| 2 | `fake_tm` で 1 と同じく `f"{tm.bin}/tmux-menu\r"` を打って一覧を開き、1 つ上を選んで Enter を押し、偽の `tmux-session` へ `menu -c <押した端末> <選んだ ID>` が渡ることを見る。`'` を含む名前を含める |
-| 3 | `ui_tm`（本物の `tmux-session`）で 1 → 選ぶ → `a` を送り、押した端末が選んだセッションへ移り、そこに繋がっていた他の端末が外れることを `list-clients` で見る |
-| 4 | `ui_tm` で、tmux の外の端末として `tm.spawn([str(tm.bin / "tmux-menu")])` を起動し、端末がサーバに繋がり `tree-mode` になることを見る |
-| 5 | `fake_tm` で 4 と同じく `tm.spawn([str(tm.bin / "tmux-menu")])` で開き、2 と同じく選んで Enter を押し、`menu -c <その端末> <選んだ ID>` が渡ることを見る |
-| 6 | `tm` のサーバの無い環境で `tm.run("tmux-menu")` を実行し（`tm.run` は `bin` の絶対パスで起動する）、終了コード 1・標準エラーの理由・実行後もサーバが無いことを見る |
+| 1 | `ui_tm` で `home = tm.new("zz-home")`・`tm.attach(home)` を作り、上の「tmux の中」の形で `tmux-menu` を打つ。`home` の pane の `#{pane_mode}` が `tree-mode` になることを見る。一覧が `TMUX_PANE` の pane に出る（直近に操作された別の端末には出ない）ことは行 11 の足すテストで縛る |
+| 2 | `fake_tm` で `SPECIAL_NAMES`（`'` を含む）を parametrize し、`target = tm.new(name)`・`home = tm.new("zz-home")`・`me = tm.attach(home)` を作る。1 と同じ形で開き、`_pick_above(tm, me, home)` で選び、`tm.record` が `["menu", "-c", me.tty, target]` になることを見る（`test_prefix_s_passes_selected_id_and_client` と同じ期待値）。打った絶対パスの `tmux-menu` は本物のスクリプトで一覧を開き、Enter の後に `run-shell` がサーバの `PATH`（`fake/` が先頭）から引く `tmux-session` だけが偽物になる |
+| 3 | `ui_tm`（本物の `tmux-session`）で `test_menu_go_detaches_others_and_switches` と同じく `target = tm.new(name)`・`home = tm.new("zz-home")`・`me = tm.attach(home)`・`stale = tm.attach(target)` を作る。1 と同じ形で開き、`_pick_above(tm, me, home)` の後に `_wait(lambda: "移る" in me.output())` を待って `me.send("a")` を送る。`tm.clients_of(target) == {me.tty}` になり、`stale.tty` が `tm.all_clients()` から消えることを見る |
+| 4 | `ui_tm` で上の「tmux の外」の形（`target = tm.new("devbase-3")`・`home = tm.new("zz-home")`・`tm.attach(target)` の後に `me = tm.spawn([str(tm.bin / "tmux-menu")])`）を作る。`me` が `home` に繋がり、`home` の pane の `#{pane_mode}` が `tree-mode` になることを見る |
+| 5 | `fake_tm` で `SPECIAL_NAMES` を parametrize し、4 と同じ組み方で `target = tm.new(name)` として開く。`me` が `home` に繋がり一覧が開くのを待ち、`_pick_above(tm, me, home)` で選ぶ。カーソルは `zz-home` にあるため 1 つ上は `target` で、`tm.record` が `["menu", "-c", me.tty, target]` になることを見る |
+| 6 | `tm` のサーバの無い環境で `tm.run("tmux-menu")` を実行し（`tm.run` は `bin` の絶対パスで起動する）、終了コード 1・標準エラーに「サーバ」を含むこと・実行後も `tm.sessions() == {}` であることを見る |
 | 7 | 既存の `menu` のテスト（`test_menu_*`）が中身を変えずに通る。`prefix S` を通るものは「テスト基盤の更新」の後に通る |
-| 8 | 2 つの形をどちらも両方の名前で走らせる。**一覧を開く形:** `tmux-menu` と `tmux-session menu` で 1・6 を走らせる（parametrize。1 は行 1 のとおり `ui_tm` で `tm.bin` の絶対パスを打ち、6 は `tm.run` で起動する）。**メニューを出す形:** `ui_tm` で `target = tm.new("devbase-3")` と `me = tm.attach(tm.new("zz-home"))` を作り、`cmd` = `f"tmux-menu -c {me.tty} {shlex.quote(target)}"` / `f"tmux-session menu -c {me.tty} {shlex.quote(target)}"` で parametrize し、`test_menu_notifies_client_on_failure` と同じく `tm.tmux("run-shell", "-b", cmd)` で呼ぶ。`tm.new` はセッションの ID を返し、`ui_tm` で最初に作る `devbase-3` の ID は `$0` になる。`run-shell` は文字列を `sh -c` へ渡すため、引用しないと `$0` が `sh` に展開され（実測の 3 と同じ現象）、`tmux-session` は「セッションがありません: sh」で終了コード 1 になる（専用ソケットで `run-shell 'printf "<%s>\n" $0'` が `<sh>`、`'$0'` と引用すると `<$0>` になることを確かめた）。テストのファイルに `import shlex` を足す（`display-menu` が閉じるまで戻らない場合に備え、テストの側で待たない）。どちらの名前でも `me` の端末に同じメニュー（`test_menu_peek_opens_popup` と同じく `中身を見る` の項目）が出ることを見る。`fake_tm` の record では確かめられない。偽物に置き換わるのは `tmux-session` だけで、`bin` の `tmux-menu` は本物のスクリプトへの symlink のまま `display-menu` を出し、`tmux-session` を呼ばないため |
-| 9 | `-c` だけ・余分な引数・知らないオプションで終了コード 2。`tmux-menu -h` が 0 で、`tmux-session -h` の出力に `tmux-menu` が含まれる |
+| 8 | 2 つの形をどちらも両方の名前で走らせる。**一覧を開く形:** `tmux-menu` と `tmux-session menu` で 1・6 を走らせる（parametrize。1 は `send-keys` で `f"{tm.bin}/tmux-menu"` / `f"{tm.bin}/tmux-session menu"` を打ち、6 は `tm.run("tmux-menu")` / `tm.run("tmux-session", "menu")` で起動する）。**メニューを出す形:** `ui_tm` で `target = tm.new("devbase-3")` と `me = tm.attach(tm.new("zz-home"))` を作り、`cmd` = `f"tmux-menu -c {me.tty} {shlex.quote(target)}"` / `f"tmux-session menu -c {me.tty} {shlex.quote(target)}"` で parametrize し、`test_menu_notifies_client_on_failure` と同じく `tm.tmux("run-shell", "-b", cmd)` で呼ぶ。`run-shell` はサーバの環境の `PATH`（`bin` を含む）でコマンドを引く。`tm.new` はセッションの ID を返し、`ui_tm` で最初に作る `devbase-3` の ID は `$0` になる。`run-shell` は文字列を `sh -c` へ渡すため、引用しないと `$0` が `sh` に展開され（実測の 3 と同じ現象）、`tmux-session` は「セッションがありません: sh」で終了コード 1 になる（専用ソケットで `run-shell 'printf "<%s>\n" $0'` が `<sh>`、`'$0'` と引用すると `<$0>` になることを確かめた）。テストのファイルに `import shlex` を足す。`-b` で背景に回すため、`display-menu` が閉じるまでテストは止まらない。どちらの名前でも `me` の端末に同じメニュー（`test_menu_peek_opens_popup` と同じく `中身を見る` の項目）が出ることを `_wait(lambda: "中身を見る" in me.output())` で見る。`fake_tm` の record では確かめられない。偽物に置き換わるのは `tmux-session` だけで、`bin` の `tmux-menu` は本物のスクリプトへの symlink のまま `display-menu` を出し、`tmux-session` を呼ばないため |
+| 9 | `test_usage_errors_exit_two` の parametrize へ `("tmux-menu", "-c", "/dev/pts/1")`（`-c` だけ）・`("tmux-menu", "a")`（`-c` が無い）・`("tmux-menu", "-c", "/dev/pts/1", "a", "b")`（余分な引数）・`("tmux-menu", "-x")`（知らないオプション）を足し、終了コード 2 と標準エラーの理由を見る。`test_help_exits_zero` へ `("tmux-menu", "-h")` を足し、`tm.run("tmux-session", "-h")` の標準出力に `tmux-menu` が含まれることを見る |
 | 10 | Dockerfile の symlink の `RUN` に `tmux-menu` が含まれることを固定する（`SHORT_NAMES` を足した `test_dockerfile_links_short_names`）。建てたイメージで `command -v tmux-menu` を見る |
-| 11 | **書き換える既存テスト:** `test_prefix_s_opens_session_chooser`（`tests/containers/test_tmux_conf.py`）は割り当てに `choose-tree` と `tmux-session menu` が含まれることを見ており、決定 2 で落ちる。割り当てがちょうど 1 つで、`run-shell` が `TMUX_PANE=#{pane_id} tmux-menu` を呼ぶことを見る形へ改める。**基盤更新で通る既存テスト:** `test_prefix_s_passes_selected_id_and_client` と、`prefix S` から開く `test_menu_*` 4 件（「テスト基盤の更新」の表）。中身は変えない。**足すテスト:** 時間の競合に頼らず、`TMUX_PANE` の pane に一覧が出ることを見る。`home` と `other` の 2 つのセッションを作り、`tm.attach(home)` の後に `tm.attach(other)` で繋いだ端末へ 1 文字送って直近に操作された端末を `other` にする。そのうえで `tm.run("tmux-menu", env=tm.inside_env(home))` を実行し、`home` の pane の `#{pane_mode}` が `tree-mode` になり、`other` の pane はならないことを見る。このテストが縛るのは「一覧が `TMUX_PANE` の pane に出る」という振る舞いであり、`-t "$TMUX_PANE"` の分岐ではない。tmux は `-t` が無くても環境の `TMUX_PANE` で現在の pane を決めるため、`-t` を実装から落としてもこのテストは通る（実測の 7a・7b）。`TMUX_PANE` を渡さない・読み捨てるといった壊し方で落ちる（実測の 7c）。`prefix S` が `TMUX_PANE=#{pane_id}` を渡すことは、書き換える静的テストが縛る。実測の 5・6 のような、押した直後に別の端末へ打つテストは、本物の `tmux-menu` では `choose-tree` までの間が数十 ms しかなく `-t` の有無を区別できないため採らない。`prefix s` は既定のまま |
+| 11 | **書き換える既存テスト:** `test_prefix_s_opens_session_chooser`（`tests/containers/test_tmux_conf.py`）は割り当てに `choose-tree` と `tmux-session menu` が含まれることを見ており、決定 2 で落ちる。割り当てがちょうど 1 つで、`run-shell` が `TMUX_PANE=#{pane_id} tmux-menu` を呼ぶことを見る形へ改める。**基盤更新で通る既存テスト:** `test_prefix_s_passes_selected_id_and_client` と、`prefix S` から開く `test_menu_*` 4 件（「テスト基盤の更新」の表）。中身は変えない。**足すテスト:** 時間の競合に頼らず、`TMUX_PANE` の pane に一覧が出ることを見る。`tm` で `home` と `other` の 2 つのセッションを作り、`tm.attach(home)` の後に `tm.attach(other)` で繋ぐ。後に繋いだ `other` の端末が直近に操作された端末になり、端末へ打たなくてもこの順だけで決まる（手元の 3.7b の専用ソケットで、打たずに `TMUX_PANE` を消して開くと `other` に出ることを確かめた）。そのうえで `tm.run("tmux-menu", env=tm.inside_env(home))` を実行し、`home` の pane の `#{pane_mode}` が `tree-mode` になり、`other` の pane はならないことを見る。このテストが縛るのは「一覧が `TMUX_PANE` の pane に出る」という振る舞いであり、`-t "$TMUX_PANE"` の分岐ではない。`inside_env` は `TMUX_PANE` を必ず渡し、tmux は `-t` が無くても環境の `TMUX_PANE` で現在の pane を決めるため、実装が `-t` を落としても、`TMUX_PANE` を読まなくても通る（実測の 7a・7b）。落ちるのは、実装が `TMUX_PANE` を消し（`unset TMUX_PANE` や `env -u TMUX_PANE`）、かつその値を `-t` にも使わずに tmux を呼ぶ壊し方だけである（実測の 7d。消す前の値を `-t` に使えば通る、7e）。`prefix S` が `TMUX_PANE=#{pane_id}` を渡すことは、書き換える静的テストが縛る。実測の 5・6 のような、押した直後に別の端末へ打つテストは採らない。実測では 1 秒待つ `open-list-slow` で押してから `choose-tree` までの間を作ったが、本物の `tmux-menu` にはその待ちが無く、その間に別の端末を操作できる保証が無いため、割り当てが `TMUX_PANE` を渡さなくても通りうる。`prefix s` は既定のまま |
 | 12 | `git diff --stat main` に `tmux-first` / `tmux-clean` が現れない |
 | 13 | `shellcheck containers/base/tmux-*` と全体の pytest |
 | 14 | 文書の差分をレビューで見る |
diff --git a/issues/PLAN71_tmux-menu-measure.py b/issues/PLAN71_tmux-menu-measure.py
index 86f7d05c..aec6e88f 100755
--- a/issues/PLAN71_tmux-menu-measure.py
+++ b/issues/PLAN71_tmux-menu-measure.py
@@ -28,6 +28,16 @@
     ),
     # open-list から -t を落としたもの（TMUX_PANE があっても -t に使わない）
     "open-list-no-t": f"#!/bin/sh\nexec tmux choose-tree -Zs -O name '{TEMPLATE}'\n",
+    # TMUX_PANE を消してから -t を付けずに開く（TMUX_PANE を消す壊し方）
+    "open-list-unset": (
+        f"#!/bin/sh\nunset TMUX_PANE\nexec tmux choose-tree -Zs -O name '{TEMPLATE}'\n"
+    ),
+    # TMUX_PANE を消すが、消す前の値を -t に使う
+    "open-list-unset-t": (
+        "#!/bin/sh\n"
+        'pane=$TMUX_PANE\nunset TMUX_PANE\n'
+        f"exec tmux choose-tree -t \"$pane\" -Zs -O name '{TEMPLATE}'\n"
+    ),
     # 一覧が開くまでの間に別の端末を操作するため、1 秒待ってから開く
     "open-list-slow": "#!/bin/sh\nsleep 1\nexec open-list\n",
 }
@@ -174,6 +184,8 @@ def main():
         ("7a open-list-no-t, TMUX_PANE=a's pane", "open-list-no-t", a_pane),
         ("7b open-list (-t), TMUX_PANE=a's pane", "open-list", a_pane),
         ("7c open-list-no-t, no TMUX_PANE", "open-list-no-t", None),
+        ("7d open-list-unset, TMUX_PANE=a's pane", "open-list-unset", a_pane),
+        ("7e open-list-unset-t, TMUX_PANE=a's pane", "open-list-unset-t", a_pane),
     ):
         reset()
         os.write(c2, b"x")
@@ -188,6 +200,25 @@ def main():
         time.sleep(1)
         state(f"7 no tty, b typed last, TMUX_PANE={pane}: {label}")
 
+    # 8. pane へ send-keys でコマンド行を打って一覧を開き、send-keys で 1 つ上へ動かす。
+    #    直近を b の端末にしてから Enter を送り、#{client_name} がどの端末になるかを見る
+    for label, enter_from_client in (
+        ("8a Enter by send-keys", False),
+        ("8b Enter by a's terminal", True),
+    ):
+        reset()
+        t("send-keys", "-t", "=a:", os.path.join(BINDIR, "open-list"), "Enter")
+        time.sleep(1)
+        t("send-keys", "-t", "=a:", "Up")
+        os.write(c2, b"x")
+        time.sleep(0.5)
+        if enter_from_client:
+            os.write(c1, b"\r")
+        else:
+            t("send-keys", "-t", "=a:", "Enter")
+        time.sleep(1)
+        state(f"{label} (open by send-keys, b typed last)")
+
     t("kill-server")
 
 

From 936903deb79d11189c6cf2758312c7a790150201 Mon Sep 17 00:00:00 2001
From: "takemi.ohama" <takemi.ohama@gmail.com>
Date: Thu, 24 Sep 2026 21:54:06 +0900
Subject: [PATCH 8/8] =?UTF-8?q?=E8=A8=AD=E8=A8=88(PLAN71):=20=E6=89=93?=
 =?UTF-8?q?=E3=81=9F=E3=81=9A=E3=81=AB=20attach=20=E3=81=97=E3=81=9F?=
 =?UTF-8?q?=E9=A0=86=E3=81=A0=E3=81=91=E3=81=A7=E7=9B=B4=E8=BF=91=E3=81=8C?=
 =?UTF-8?q?=E6=B1=BA=E3=81=BE=E3=82=8B=E3=81=93=E3=81=A8=E3=82=92=E5=AE=9F?=
 =?UTF-8?q?=E6=B8=AC=209=20=E3=81=AB=E8=B6=B3=E3=81=99?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

行 11 の足すテストが頼る「tm.attach(home) → tm.attach(other) の順だけで other が直近になる」前提を、
再現用スクリプトの 9a（c→d の順に attach、打たずに TMUX_PANE 無しで開くと d に出る）と
9b（c の TMUX_PANE を渡すと c に出る）で確かめ、実測表・出力の抜粋・所見へ載せる。
端末の名前は今回の実行に揃えた。

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 issues/PLAN71_tmux-menu-design.md  | 42 ++++++++++++++++++------------
 issues/PLAN71_tmux-menu-measure.py | 23 ++++++++++++++++
 2 files changed, 49 insertions(+), 16 deletions(-)

diff --git a/issues/PLAN71_tmux-menu-design.md b/issues/PLAN71_tmux-menu-design.md
index 7e70b095..010a7cb0 100644
--- a/issues/PLAN71_tmux-menu-design.md
+++ b/issues/PLAN71_tmux-menu-design.md
@@ -90,39 +90,42 @@ tmux の中でコマンドを打つ形（`TMUX_PANE` がシェルにある）と
 `-t "$TMUX_PANE"` を付けて次の `<template>` で `choose-tree -Zs -O name` を実行する。`open-list-no-t`
 は `open-list` から `-t` を落としたもので、`TMUX_PANE` があっても `-t` に使わない。`open-list-unset` は
 `TMUX_PANE` を `unset` してから `-t` を付けずに開き、`open-list-unset-t` は `unset` する前の値を `-t` に使う。セッションは
-`a`・`it's`（`'` を含む）・`b` の 3 つで、端末 `/dev/ttys024` が `a` に、`/dev/ttys025` が `b` に
-繋がっている（端末の名前は実行ごとに変わる）。一覧では 1 つ上を選んで Enter を押した。
+`a`・`it's`（`'` を含む）・`b` の 3 つで、端末 `/dev/ttys023` が `a` に、`/dev/ttys024` が `b` に
+繋がっている（端末の名前は実行ごとに変わる）。9 だけは最後に `c`・`d` の 2 つを足し、端末を
+`c`→`d` の順に繋ぐ。一覧では 1 つ上を選んで Enter を押した。
 
 | # | 開き方 | 一覧が出た pane | `menu` へ渡った引数（ID → 名前） | 判定 |
 | --- | --- | --- | --- | --- |
-| 1 | `a` の端末のプロンプトで `open-list` を打つ | `a` | `menu -c /dev/ttys024 $1` → `it's` | 正しい |
-| 2 | tmux の外で `tmux attach \; choose-tree -Zs -O name '<template>'` | 新しい端末 `/dev/ttys026` が `it's`（端末の無いセッション）へ繋がる | `menu -c /dev/ttys026 $2` → `b` | 正しい |
-| 3 | `bind-key S run-shell "tmux choose-tree -Zs -O name '<template>'"`（template を `run-shell` の文字列へ直接埋め込む）を `a` の端末で押す | `a` | `menu -c /dev/ttys024 sh`。選ぶ前に押した端末のセッションの ID（`$0`）へ展開され、それをシェルが変数として `sh` に読んだと見られる | **誤り** |
-| 4 | `bind-key S run-shell open-list` を `a` の端末で押す | `a` | `menu -c /dev/ttys024 $1` → `it's` | 正しい |
+| 1 | `a` の端末のプロンプトで `open-list` を打つ | `a` | `menu -c /dev/ttys023 $1` → `it's` | 正しい |
+| 2 | tmux の外で `tmux attach \; choose-tree -Zs -O name '<template>'` | 新しい端末 `/dev/ttys025` が `it's`（端末の無いセッション）へ繋がる | `menu -c /dev/ttys025 $2` → `b` | 正しい |
+| 3 | `bind-key S run-shell "tmux choose-tree -Zs -O name '<template>'"`（template を `run-shell` の文字列へ直接埋め込む）を `a` の端末で押す | `a` | `menu -c /dev/ttys023 sh`。選ぶ前に押した端末のセッションの ID（`$0`）へ展開され、それをシェルが変数として `sh` に読んだと見られる | **誤り** |
+| 4 | `bind-key S run-shell open-list` を `a` の端末で押す | `a` | `menu -c /dev/ttys023 $1` → `it's` | 正しい |
 | 5 | 4 の形（1 秒待ってから開く `open-list-slow`）で、押した直後に `b` の端末へ 1 文字打つ | **`b`** | （選んでいない） | **誤り** |
-| 6 | `bind-key S run-shell "TMUX_PANE=#{pane_id} open-list-slow"` で 5 と同じ操作。続けて選んで Enter | `a` | `menu -c /dev/ttys024 $1` → `it's` | 正しい |
+| 6 | `bind-key S run-shell "TMUX_PANE=#{pane_id} open-list-slow"` で 5 と同じ操作。続けて選んで Enter | `a` | `menu -c /dev/ttys023 $1` → `it's` | 正しい |
 | 7a | `b` の端末へ 1 文字打って直近を `b` にしてから、端末を持たないプロセスで `a` の pane の `TMUX`・`TMUX_PANE` を渡して `-t` を付けない `open-list-no-t` を実行する（テストの `tm.run("tmux-menu", env=tm.inside_env(home))` と同じ形） | `a` | （選んでいない） | 正しい（`-t` が無くても `TMUX_PANE` の pane に出る） |
 | 7b | 7a と同じ操作で、`-t "$TMUX_PANE"` を付ける `open-list` を実行する | `a` | （選んでいない） | 正しい |
 | 7c | 7a と同じ操作で、`TMUX_PANE` を渡さずに `open-list-no-t` を実行する | **`b`** | （選んでいない） | 直近の端末に出る |
 | 7d | 7a と同じ操作で、`TMUX_PANE` を渡して `open-list-unset` を実行する | **`b`** | （選んでいない） | 直近の端末に出る（7c と同じ） |
 | 7e | 7a と同じ操作で、`TMUX_PANE` を渡して `open-list-unset-t` を実行する | `a` | （選んでいない） | 正しい（消しても `-t` に値があれば出る） |
-| 8a | `a` の pane へ `send-keys -t =a: <open-list の絶対パス> Enter` でコマンド行を打って一覧を開き、`send-keys -t =a: Up` で 1 つ上へ動かす。`b` の端末へ 1 文字打ってから `send-keys -t =a: Enter` | `a` | `menu -c /dev/ttys025 $1` → `it's`（端末は **`b`** のもの） | Enter を `send-keys` で送ると、`#{client_name}` は直近に操作された端末になる |
-| 8b | 8a と同じ操作で、Enter だけを `a` の端末から送る | `a` | `menu -c /dev/ttys024 $1` → `it's` | 正しい（`send-keys` で開いた一覧でも、`send-keys` の `Up` は効く） |
+| 8a | `a` の pane へ `send-keys -t =a: <open-list の絶対パス> Enter` でコマンド行を打って一覧を開き、`send-keys -t =a: Up` で 1 つ上へ動かす。`b` の端末へ 1 文字打ってから `send-keys -t =a: Enter` | `a` | `menu -c /dev/ttys024 $1` → `it's`（端末は **`b`** のもの） | Enter を `send-keys` で送ると、`#{client_name}` は直近に操作された端末になる |
+| 8b | 8a と同じ操作で、Enter だけを `a` の端末から送る | `a` | `menu -c /dev/ttys023 $1` → `it's` | 正しい（`send-keys` で開いた一覧でも、`send-keys` の `Up` は効く） |
+| 9a | 新しいセッション `c`・`d` を作り、端末を `c`→`d` の順に attach する。**どの端末へも打たずに**、端末を持たないプロセスで `c` の `TMUX` だけを渡し、`TMUX_PANE` を渡さずに `open-list-no-t` を実行する（テストの `tm.attach(home)` → `tm.attach(other)` と同じ順） | **`d`** | （選んでいない） | 後に attach した端末が直近になる。打たなくても繋いだ順だけで決まる |
+| 9b | 9a に続けて、`c` の pane の `TMUX_PANE` を渡して `open-list` を実行する（行 11 の足すテストと同じ形） | `c` | （選んでいない） | 正しい（直近が `d` でも `TMUX_PANE` の pane に出る） |
 
 スクリプトの出力（抜粋。`panes` は `セッション:pane:モード`）:
 
 ```text
 ## 2 outside: attach ; choose-tree
-  clients: ['/dev/ttys024=a', '/dev/ttys025=b', "/dev/ttys026=it's"]
-  menu args: 'menu -c /dev/ttys026 $2' -> 'menu -c /dev/ttys026 b'
+  clients: ['/dev/ttys023=a', '/dev/ttys024=b', "/dev/ttys025=it's"]
+  menu args: 'menu -c /dev/ttys025 $2' -> 'menu -c /dev/ttys025 b'
 ## 3 bind: run-shell with inline template
-  menu args: 'menu -c /dev/ttys024 sh' -> 'menu -c /dev/ttys024 sh'
+  menu args: 'menu -c /dev/ttys023 sh' -> 'menu -c /dev/ttys023 sh'
 ## 5 bind: run-shell (no -t), other client typed during start
   panes: ['a:%0:', 'b:%2:tree-mode', "it's:%1:"]
 ## 6 bind: run-shell TMUX_PANE=#{pane_id}, other client typed during start
   panes: ['a:%0:tree-mode', 'b:%2:', "it's:%1:"]
 ## 6b same binding, pick and Enter
-  menu args: 'menu -c /dev/ttys024 $1' -> "menu -c /dev/ttys024 it's"
+  menu args: 'menu -c /dev/ttys023 $1' -> "menu -c /dev/ttys023 it's"
 ## 7 no tty, b typed last, TMUX_PANE=%0: 7a open-list-no-t, TMUX_PANE=a's pane
   panes: ['a:%0:tree-mode', 'b:%2:', "it's:%1:"]
 ## 7 no tty, b typed last, TMUX_PANE=%0: 7b open-list (-t), TMUX_PANE=a's pane
@@ -134,9 +137,14 @@ tmux の中でコマンドを打つ形（`TMUX_PANE` がシェルにある）と
 ## 7 no tty, b typed last, TMUX_PANE=%0: 7e open-list-unset-t, TMUX_PANE=a's pane
   panes: ['a:%0:tree-mode', 'b:%2:', "it's:%1:"]
 ## 8a Enter by send-keys (open by send-keys, b typed last)
-  menu args: 'menu -c /dev/ttys025 $1' -> "menu -c /dev/ttys025 it's"
-## 8b Enter by a's terminal (open by send-keys, b typed last)
   menu args: 'menu -c /dev/ttys024 $1' -> "menu -c /dev/ttys024 it's"
+## 8b Enter by a's terminal (open by send-keys, b typed last)
+  menu args: 'menu -c /dev/ttys023 $1' -> "menu -c /dev/ttys023 it's"
+## 9 no tty, attached c then d (no typing), TMUX_PANE=None: 9a open-list-no-t, no TMUX_PANE
+  clients: ['/dev/ttys023=a', '/dev/ttys024=b', '/dev/ttys028=c', '/dev/ttys029=d']
+  panes: ['a:%0:', 'b:%2:', 'c:%3:', 'd:%4:tree-mode', "it's:%1:"]
+## 9 no tty, attached c then d (no typing), TMUX_PANE=%3: 9b open-list (-t), TMUX_PANE=c's pane
+  panes: ['a:%0:', 'b:%2:', 'c:%3:tree-mode', 'd:%4:', "it's:%1:"]
 ```
 
 `<template>` は今の `prefix S` の行と同じ次の文字列である。
@@ -155,6 +163,8 @@ run-shell -t "%%%" "tmux-session menu -c #{q:client_name} #{q:session_id}"
   `TMUX_PANE` が無いときだけ直近の端末に出る（7c）。`-t "$TMUX_PANE"` を付けても付けなくても
   結果は同じである（7a・7b）。実装の中で `TMUX_PANE` を消しても、消す前の値を `-t` に使えば
   出る pane は変わらない（7d・7e）
+- 端末へ打たなくても、後に attach した端末が直近に操作された端末になる（9a）。そのうえで
+  `TMUX_PANE` を渡せば、直近の端末ではなく `TMUX_PANE` の pane に出る（9b）
 - `send-keys` で pane へ送ったキーは、その pane の一覧を動かす。ただし一覧の Enter で展開される
   `#{client_name}` は、`send-keys` では pane に繋がった端末ではなく直近に操作された端末になる
   （8a）。押した端末の名前を確かめるには、Enter をその端末から送る（8b）
@@ -331,7 +341,7 @@ Enter の後は PLAN69 の `menu` の流れと同じである。
 | 8 | 2 つの形をどちらも両方の名前で走らせる。**一覧を開く形:** `tmux-menu` と `tmux-session menu` で 1・6 を走らせる（parametrize。1 は `send-keys` で `f"{tm.bin}/tmux-menu"` / `f"{tm.bin}/tmux-session menu"` を打ち、6 は `tm.run("tmux-menu")` / `tm.run("tmux-session", "menu")` で起動する）。**メニューを出す形:** `ui_tm` で `target = tm.new("devbase-3")` と `me = tm.attach(tm.new("zz-home"))` を作り、`cmd` = `f"tmux-menu -c {me.tty} {shlex.quote(target)}"` / `f"tmux-session menu -c {me.tty} {shlex.quote(target)}"` で parametrize し、`test_menu_notifies_client_on_failure` と同じく `tm.tmux("run-shell", "-b", cmd)` で呼ぶ。`run-shell` はサーバの環境の `PATH`（`bin` を含む）でコマンドを引く。`tm.new` はセッションの ID を返し、`ui_tm` で最初に作る `devbase-3` の ID は `$0` になる。`run-shell` は文字列を `sh -c` へ渡すため、引用しないと `$0` が `sh` に展開され（実測の 3 と同じ現象）、`tmux-session` は「セッションがありません: sh」で終了コード 1 になる（専用ソケットで `run-shell 'printf "<%s>\n" $0'` が `<sh>`、`'$0'` と引用すると `<$0>` になることを確かめた）。テストのファイルに `import shlex` を足す。`-b` で背景に回すため、`display-menu` が閉じるまでテストは止まらない。どちらの名前でも `me` の端末に同じメニュー（`test_menu_peek_opens_popup` と同じく `中身を見る` の項目）が出ることを `_wait(lambda: "中身を見る" in me.output())` で見る。`fake_tm` の record では確かめられない。偽物に置き換わるのは `tmux-session` だけで、`bin` の `tmux-menu` は本物のスクリプトへの symlink のまま `display-menu` を出し、`tmux-session` を呼ばないため |
 | 9 | `test_usage_errors_exit_two` の parametrize へ `("tmux-menu", "-c", "/dev/pts/1")`（`-c` だけ）・`("tmux-menu", "a")`（`-c` が無い）・`("tmux-menu", "-c", "/dev/pts/1", "a", "b")`（余分な引数）・`("tmux-menu", "-x")`（知らないオプション）を足し、終了コード 2 と標準エラーの理由を見る。`test_help_exits_zero` へ `("tmux-menu", "-h")` を足し、`tm.run("tmux-session", "-h")` の標準出力に `tmux-menu` が含まれることを見る |
 | 10 | Dockerfile の symlink の `RUN` に `tmux-menu` が含まれることを固定する（`SHORT_NAMES` を足した `test_dockerfile_links_short_names`）。建てたイメージで `command -v tmux-menu` を見る |
-| 11 | **書き換える既存テスト:** `test_prefix_s_opens_session_chooser`（`tests/containers/test_tmux_conf.py`）は割り当てに `choose-tree` と `tmux-session menu` が含まれることを見ており、決定 2 で落ちる。割り当てがちょうど 1 つで、`run-shell` が `TMUX_PANE=#{pane_id} tmux-menu` を呼ぶことを見る形へ改める。**基盤更新で通る既存テスト:** `test_prefix_s_passes_selected_id_and_client` と、`prefix S` から開く `test_menu_*` 4 件（「テスト基盤の更新」の表）。中身は変えない。**足すテスト:** 時間の競合に頼らず、`TMUX_PANE` の pane に一覧が出ることを見る。`tm` で `home` と `other` の 2 つのセッションを作り、`tm.attach(home)` の後に `tm.attach(other)` で繋ぐ。後に繋いだ `other` の端末が直近に操作された端末になり、端末へ打たなくてもこの順だけで決まる（手元の 3.7b の専用ソケットで、打たずに `TMUX_PANE` を消して開くと `other` に出ることを確かめた）。そのうえで `tm.run("tmux-menu", env=tm.inside_env(home))` を実行し、`home` の pane の `#{pane_mode}` が `tree-mode` になり、`other` の pane はならないことを見る。このテストが縛るのは「一覧が `TMUX_PANE` の pane に出る」という振る舞いであり、`-t "$TMUX_PANE"` の分岐ではない。`inside_env` は `TMUX_PANE` を必ず渡し、tmux は `-t` が無くても環境の `TMUX_PANE` で現在の pane を決めるため、実装が `-t` を落としても、`TMUX_PANE` を読まなくても通る（実測の 7a・7b）。落ちるのは、実装が `TMUX_PANE` を消し（`unset TMUX_PANE` や `env -u TMUX_PANE`）、かつその値を `-t` にも使わずに tmux を呼ぶ壊し方だけである（実測の 7d。消す前の値を `-t` に使えば通る、7e）。`prefix S` が `TMUX_PANE=#{pane_id}` を渡すことは、書き換える静的テストが縛る。実測の 5・6 のような、押した直後に別の端末へ打つテストは採らない。実測では 1 秒待つ `open-list-slow` で押してから `choose-tree` までの間を作ったが、本物の `tmux-menu` にはその待ちが無く、その間に別の端末を操作できる保証が無いため、割り当てが `TMUX_PANE` を渡さなくても通りうる。`prefix s` は既定のまま |
+| 11 | **書き換える既存テスト:** `test_prefix_s_opens_session_chooser`（`tests/containers/test_tmux_conf.py`）は割り当てに `choose-tree` と `tmux-session menu` が含まれることを見ており、決定 2 で落ちる。割り当てがちょうど 1 つで、`run-shell` が `TMUX_PANE=#{pane_id} tmux-menu` を呼ぶことを見る形へ改める。**基盤更新で通る既存テスト:** `test_prefix_s_passes_selected_id_and_client` と、`prefix S` から開く `test_menu_*` 4 件（「テスト基盤の更新」の表）。中身は変えない。**足すテスト:** 時間の競合に頼らず、`TMUX_PANE` の pane に一覧が出ることを見る。`tm` で `home` と `other` の 2 つのセッションを作り、`tm.attach(home)` の後に `tm.attach(other)` で繋ぐ。後に繋いだ `other` の端末が直近に操作された端末になり、端末へ打たなくてもこの順だけで決まる（実測の 9a。`TMUX_PANE` を渡さずに開くと後に繋いだ `d` に出る。9b で `TMUX_PANE` を渡すと先に繋いだ `c` に出る）。そのうえで `tm.run("tmux-menu", env=tm.inside_env(home))` を実行し、`home` の pane の `#{pane_mode}` が `tree-mode` になり、`other` の pane はならないことを見る。このテストが縛るのは「一覧が `TMUX_PANE` の pane に出る」という振る舞いであり、`-t "$TMUX_PANE"` の分岐ではない。`inside_env` は `TMUX_PANE` を必ず渡し、tmux は `-t` が無くても環境の `TMUX_PANE` で現在の pane を決めるため、実装が `-t` を落としても、`TMUX_PANE` を読まなくても通る（実測の 7a・7b）。落ちるのは、実装が `TMUX_PANE` を消し（`unset TMUX_PANE` や `env -u TMUX_PANE`）、かつその値を `-t` にも使わずに tmux を呼ぶ壊し方だけである（実測の 7d。消す前の値を `-t` に使えば通る、7e）。`prefix S` が `TMUX_PANE=#{pane_id}` を渡すことは、書き換える静的テストが縛る。実測の 5・6 のような、押した直後に別の端末へ打つテストは採らない。実測では 1 秒待つ `open-list-slow` で押してから `choose-tree` までの間を作ったが、本物の `tmux-menu` にはその待ちが無く、その間に別の端末を操作できる保証が無いため、割り当てが `TMUX_PANE` を渡さなくても通りうる。`prefix s` は既定のまま |
 | 12 | `git diff --stat main` に `tmux-first` / `tmux-clean` が現れない |
 | 13 | `shellcheck containers/base/tmux-*` と全体の pytest |
 | 14 | 文書の差分をレビューで見る |
diff --git a/issues/PLAN71_tmux-menu-measure.py b/issues/PLAN71_tmux-menu-measure.py
index aec6e88f..22f55532 100755
--- a/issues/PLAN71_tmux-menu-measure.py
+++ b/issues/PLAN71_tmux-menu-measure.py
@@ -219,6 +219,29 @@ def main():
         time.sleep(1)
         state(f"{label} (open by send-keys, b typed last)")
 
+    # 9. 端末へ打たず、新しいセッション c・d へ c→d の順に attach しただけで直近が決まるか。
+    #    （テストの tm.attach(home) → tm.attach(other) と同じ形。7 と違って b の端末へ打たない）
+    for name in ("c", "d"):
+        t("new-session", "-d", "-s", name, "-x", "80", "-y", "24")
+    spawn("attach", "-t", "=c")
+    spawn("attach", "-t", "=d")
+    tmux_var = t("display-message", "-p", "-t", "=c:", "#{socket_path},#{pid},0")
+    c_pane = t("display-message", "-p", "-t", "=c:", "#{pane_id}")
+    for label, prog, pane in (
+        ("9a open-list-no-t, no TMUX_PANE", "open-list-no-t", None),
+        ("9b open-list (-t), TMUX_PANE=c's pane", "open-list", c_pane),
+    ):
+        reset()
+        env = dict(ENV, TMUX=tmux_var)
+        if pane:
+            env["TMUX_PANE"] = pane
+        subprocess.Popen(
+            [prog], env=env, stdin=subprocess.DEVNULL,
+            stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL,
+        )
+        time.sleep(1)
+        state(f"9 no tty, attached c then d (no typing), TMUX_PANE={pane}: {label}")
+
     t("kill-server")