From 208a30a0871770cc18d77620b34f44439f9a1326 Mon Sep 17 00:00:00 2001 From: "takemi.ohama" Date: Tue, 17 Nov 2026 06:10:07 +0900 Subject: [PATCH 1/4] =?UTF-8?q?fix(editor):=20tmux=20=E3=81=A7=E6=8B=BE?= =?UTF-8?q?=E3=81=84=E7=9B=B4=E3=81=97=E3=81=9F=E3=82=BD=E3=82=B1=E3=83=83?= =?UTF-8?q?=E3=83=88=E3=81=AB=E5=90=88=E3=81=86=20remote-cli=20=E3=82=92?= =?UTF-8?q?=20PATH=20=E3=81=AE=E5=85=88=E9=A0=AD=E3=81=AB=E5=85=A5?= =?UTF-8?q?=E3=82=8C=E3=82=8B=20(#523)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit セッション環境の VSCODE_GIT_ASKPASS_NODE から VS Code サーバーの bin/remote-cli を求め、 起動に渡す環境とエディタの探索の PATH の先頭に入れる。求められなければ PATH は変えず、 理由と tmux の update-environment の案内を warning に出す。 Co-Authored-By: Claude Opus 5.5 --- lib/devbase/editor/opener.py | 97 +++++++++++- tests/editor/test_opener.py | 295 +++++++++++++++++++++++++++++++++++ 2 files changed, 387 insertions(+), 5 deletions(-) diff --git a/lib/devbase/editor/opener.py b/lib/devbase/editor/opener.py index 1f50f4b6..71c78bb6 100644 --- a/lib/devbase/editor/opener.py +++ b/lib/devbase/editor/opener.py @@ -728,18 +728,87 @@ def _drop_vscode_ipc(env): return env +_ASKPASS_NODE_VAR = "VSCODE_GIT_ASKPASS_NODE" +# 合う remote-cli を求められなかった理由 (warning にそのまま載せる)。 +_REMOTE_CLI_UNSET = f"tmux のセッション環境に {_ASKPASS_NODE_VAR} がありません" +_REMOTE_CLI_REMOVED = ( + f"tmux のセッション環境の {_ASKPASS_NODE_VAR} が消されています (-{_ASKPASS_NODE_VAR})") +_REMOTE_CLI_NOT_ABSOLUTE = f"{_ASKPASS_NODE_VAR} が絶対パスではありません" +_REMOTE_CLI_NO_EDITOR = "{directory} に実行できる {name} がありません" + + +def _editor_name(environ) -> Optional[str]: + """起動するエディタのファイル名 (``remote-cli`` の中で確かめる名前) を返す。 + + ``DEVBASE_EDITOR`` があればその先頭の語の末尾の名前、無ければ ``code``。 + 語に分けられない・名前が空のときは None。 + """ + try: + parts = resolve_editor_display(environ) + except ValueError: + return None + name = os.path.basename(parts[0]) + return name or None + + +def _is_executable_file(path: str) -> bool: + """パスが実行できる通常のファイルか (確かめの途中の例外は False)。""" + try: + return os.path.isfile(path) and os.access(path, os.X_OK) + except (OSError, ValueError): + return False + + +def _find_matching_remote_cli(environ, editor_name: Optional[str] + ) -> tuple[Optional[str], Optional[str]]: + """セッション環境の ``VSCODE_GIT_ASKPASS_NODE`` から合う ``remote-cli`` を求める。 + + ``VSCODE_GIT_ASKPASS_NODE`` は VS Code サーバーの ``node`` の絶対パスで、その置かれた + ディレクトリの ``bin/remote-cli`` が、拾い直したソケットと同じサーバーの CLI になる。 + サーバーのディレクトリを探すことはしない (版のずれたサーバーへ委ねないため)。 + + 戻り値は ``(ディレクトリ, 見つからない理由)`` で、ちょうど一方だけが None でない。 + """ + if editor_name is None: + return None, _REMOTE_CLI_NO_EDITOR.format( + directory="remote-cli", name="エディタ") + value = _tmux_show_env(_ASKPASS_NODE_VAR, environ) + if value is _TMUX_REMOVED: + return None, _REMOTE_CLI_REMOVED + if value is None: + return None, _REMOTE_CLI_UNSET + if not os.path.isabs(value): + return None, _REMOTE_CLI_NOT_ABSOLUTE + # normpath を掛けないので末尾の名前は必ず remote-cli になる。 + directory = os.path.join(os.path.dirname(value), "bin", "remote-cli") + if not _is_executable_file(os.path.join(directory, editor_name)): + return None, _REMOTE_CLI_NO_EDITOR.format(directory=directory, name=editor_name) + return directory, None + + +def _prepend_path(path: Optional[str], directory: str) -> str: + """``directory`` を先頭の要素にした PATH を返す (ほかの要素は並びも重複もそのまま)。""" + if not path: + return directory + return directory + os.pathsep + path + + def _prepare_ipc_env(env, ctx: EditorContext): """拾い直した IPC ソケットを env へ反映し、必要な警告ログを出す。 tmux のセッション環境から拾い直せた場合は、起動する code にもその値を渡す。 - 変数を差し替えないと code 自身が古いソケットへ繋ぎに行って失敗する。変数だけ - 残って接続先が死んでいる IPC ソケットは無言の失敗になりやすいので明示する - (tmux セッション再利用・VS Code ウィンドウのリロード後など)。 + 変数を差し替えないと code 自身が古いソケットへ繋ぎに行って失敗する。あわせて + そのソケットと同じ VS Code サーバーの ``remote-cli`` を PATH の先頭に入れる。 + ペインの PATH の先頭がデスクトップ版の code だと、``VSCODE_IPC_HOOK_CLI`` を + 読まずホストの VS Code へ向けて開いてしまうため。求められなければ PATH は変えず + 警告する。変数だけ残って接続先が死んでいる IPC ソケットは無言の失敗になりやすい + ので明示する (tmux セッション再利用・VS Code ウィンドウのリロード後など)。 ``env`` は差し替えが要る場合のみ複製して返す (要らなければそのまま返す)。 """ stale_ipc = env.get("VSCODE_IPC_HOOK_CLI") if ctx.ipc_socket and ctx.ipc_socket != stale_ipc: + session_env = env env = dict(env) env["VSCODE_IPC_HOOK_CLI"] = ctx.ipc_socket logger.info( @@ -748,6 +817,21 @@ def _prepare_ipc_env(env, ctx: EditorContext): "tmux 設定を参照してください。", stale_ipc or "(未設定)", ctx.ipc_socket, ) + editor_name = _editor_name(session_env) + remote_cli, reason = _find_matching_remote_cli(session_env, editor_name) + if remote_cli: + env["PATH"] = _prepend_path(env.get("PATH"), remote_cli) + logger.info( + "拾い直したソケットに合う remote-cli を PATH の先頭に入れました (%s)", + remote_cli, + ) + else: + logger.warning( + "拾い直したソケットに合う remote-cli が見つかりません (%s)。PATH は変えずに " + "%s で起動します。tmux の update-environment に %s を入れると次から直ります " + "(環境変数ガイドの tmux 設定を参照してください)", + reason, editor_name or "エディタ", _ASKPASS_NODE_VAR, + ) if ctx.ipc_from_previous_client: # ペインを作った以前のクライアントの IPC。生きていても code に渡すとそちらへ # 委譲してしまうので外す (セッション環境の IPC を拾えていれば上で差し替え済み)。 @@ -857,12 +941,15 @@ def open_editor(*, project_name: str, dev_service_name: str, workdir: str, # tmux のセッション環境から拾い直せた場合は env を差し替え、死んだ IPC ソケット # の警告も出す。 had_ipc = bool(env.get("VSCODE_IPC_HOOK_CLI")) + pane_path = env.get("PATH") env = _prepare_ipc_env(env, ctx) # IPC を外したときは remote-cli を除いた PATH で手元の code を探す - # (見つからなければ skip / print_command へ落ちる)。 + # (見つからなければ skip / print_command へ落ちる)。合う remote-cli を PATH の + # 先頭に入れたときも、起動 (Popen は env の PATH で探す) と同じ PATH で探す。 dropped_ipc = had_ipc and "VSCODE_IPC_HOOK_CLI" not in env + path_changed = env.get("PATH") != pane_path editor = resolve_editor_cmd( # launch 用 (which 込み・None あり得る) - env, path=env.get("PATH") if dropped_ipc else None) + env, path=env.get("PATH") if dropped_ipc or path_changed else None) display = resolve_editor_display(env) # print 用 (必ず非 None) plan = decide_action(ctx, editor_available=bool(editor)) diff --git a/tests/editor/test_opener.py b/tests/editor/test_opener.py index 7fc3ad9a..0e4219c2 100644 --- a/tests/editor/test_opener.py +++ b/tests/editor/test_opener.py @@ -549,6 +549,301 @@ def test_open_editor_ssh_reattached_tmux_uses_session_ipc( assert seen["env"]["VSCODE_IPC_HOOK_CLI"] == second_ipc_socket +# --------------------------------------------------------------------------- +# 拾い直したソケットに合う remote-cli を PATH の先頭に入れる (#523) +# --------------------------------------------------------------------------- + +def _make_exe(path): + """``path`` に実行できる空のスクリプトを置く。""" + path.parent.mkdir(parents=True, exist_ok=True) + path.write_text("#!/bin/sh\n") + path.chmod(0o755) + return str(path) + + +def _make_server(root, name="code"): + """VS Code サーバーの配置 (``/node`` と ``/bin/remote-cli/``) を作る。""" + _make_exe(root / "node") + _make_exe(root / "bin" / "remote-cli" / name) + return str(root / "node"), str(root / "bin" / "remote-cli") + + +@pytest.mark.parametrize("value, expected", [ + (None, "code"), + ("", "code"), + ("cursor --reuse-window", "cursor"), + ("/opt/bin/cursor", "cursor"), + ("'unterminated", None), + ('""', None), +]) +def test_editor_name(value, expected): + environ = {} if value is None else {"DEVBASE_EDITOR": value} + assert opener._editor_name(environ) == expected + + +def test_is_executable_file(tmp_path): + exe = _make_exe(tmp_path / "exe") + link = tmp_path / "link" + link.symlink_to(exe) + plain = tmp_path / "plain" + plain.write_text("x") + plain.chmod(0o644) + assert opener._is_executable_file(exe) is True + assert opener._is_executable_file(str(link)) is True + assert opener._is_executable_file(str(plain)) is False + assert opener._is_executable_file(str(tmp_path)) is False + assert opener._is_executable_file(str(tmp_path / "missing")) is False + assert opener._is_executable_file(str(tmp_path / "a\0b")) is False + + +@pytest.mark.parametrize("path, expected", [ + ("/a:/b", "/rc:/a:/b"), + (None, "/rc"), + ("", "/rc"), + ("/x/remote-cli:/a", "/rc:/x/remote-cli:/a"), +]) +def test_prepend_path(path, expected): + expected = expected.replace(":", os.pathsep) + path = path.replace(":", os.pathsep) if path else path + assert opener._prepend_path(path, "/rc") == expected + + +@pytest.mark.parametrize("layout", [ + ("cli", "servers", "Stable-abc", "server"), # 現行の配置 + ("bin", "abc123"), # 旧い配置 +]) +def test_find_matching_remote_cli_found(monkeypatch, tmp_path, layout): + node, rc = _make_server(tmp_path.joinpath(".vscode-server", *layout)) + run = _FakeTmuxEnv({"VSCODE_GIT_ASKPASS_NODE": f"VSCODE_GIT_ASKPASS_NODE={node}\n"}) + monkeypatch.setattr(opener.subprocess, "run", run) + got = opener._find_matching_remote_cli({"TMUX": "x"}, "code") + assert got == (rc, None) + assert os.path.basename(got[0]) == "remote-cli" + assert run.calls == [["tmux", "show-environment", "VSCODE_GIT_ASKPASS_NODE"]] + + +@pytest.mark.parametrize("editor_name, found", [("cursor", True), ("code", False)]) +def test_find_matching_remote_cli_uses_editor_name( + monkeypatch, tmp_path, editor_name, found): + node, rc = _make_server(tmp_path / "server", name="cursor") + monkeypatch.setattr(opener.subprocess, "run", _FakeTmuxEnv( + {"VSCODE_GIT_ASKPASS_NODE": f"VSCODE_GIT_ASKPASS_NODE={node}\n"})) + directory, reason = opener._find_matching_remote_cli({"TMUX": "x"}, editor_name) + assert (directory == rc) is found + assert (reason is None) is found + + +def _bad_code(kind, rc_dir): + """``rc_dir/code`` を「実行できるエディタが無い」状態にする。""" + rc_dir.mkdir(parents=True) + if kind == "not_executable": + (rc_dir / "code").write_text("x") + (rc_dir / "code").chmod(0o644) + elif kind == "directory": + (rc_dir / "code").mkdir() + + +@pytest.mark.parametrize("tmux_line, returncode, expected", [ + ("", 0, opener._REMOTE_CLI_UNSET), + ("", 1, opener._REMOTE_CLI_UNSET), + ("-VSCODE_GIT_ASKPASS_NODE\n", 0, opener._REMOTE_CLI_REMOVED), + ("VSCODE_GIT_ASKPASS_NODE=server/node\n", 0, opener._REMOTE_CLI_NOT_ABSOLUTE), +]) +def test_find_matching_remote_cli_reasons(monkeypatch, tmux_line, returncode, expected): + monkeypatch.setattr(opener.subprocess, "run", + _FakeRun(stdout=tmux_line, returncode=returncode)) + assert opener._find_matching_remote_cli({"TMUX": "x"}, "code") == (None, expected) + + +@pytest.mark.parametrize("kind", ["missing", "not_executable", "directory"]) +def test_find_matching_remote_cli_no_executable_editor(monkeypatch, tmp_path, kind): + server = tmp_path / "server" + _make_exe(server / "node") + _bad_code(kind, server / "bin" / "remote-cli") + monkeypatch.setattr(opener.subprocess, "run", _FakeTmuxEnv( + {"VSCODE_GIT_ASKPASS_NODE": f"VSCODE_GIT_ASKPASS_NODE={server / 'node'}\n"})) + directory, reason = opener._find_matching_remote_cli({"TMUX": "x"}, "code") + assert directory is None + assert reason == opener._REMOTE_CLI_NO_EDITOR.format( + directory=str(server / "bin" / "remote-cli"), name="code") + + +def test_find_matching_remote_cli_without_editor_name_skips_tmux(monkeypatch): + run = _FakeRun() + monkeypatch.setattr(opener.subprocess, "run", run) + directory, reason = opener._find_matching_remote_cli({"TMUX": "x"}, None) + assert directory is None and reason + assert run.calls == [] + + +def test_find_matching_remote_cli_does_not_search_server_dirs(monkeypatch, tmp_path): + """値が無ければ、サーバーのディレクトリに remote-cli/code があっても使わない (I1)。""" + _make_server(tmp_path / ".vscode-server" / "cli" / "servers" / "Stable-abc" / "server") + monkeypatch.setattr(opener.subprocess, "run", _FakeTmuxEnv({})) + assert opener._find_matching_remote_cli({"TMUX": "x"}, "code") == ( + None, opener._REMOTE_CLI_UNSET) + + +def _recovered_ctx(socket): + return opener.EditorContext( + is_tty=True, is_ssh=True, in_vscode=True, is_wsl=False, is_darwin=True, + ipc_socket=socket) + + +def test_prepare_ipc_env_prepends_matching_remote_cli(monkeypatch, tmp_path, caplog): + import logging + node, rc = _make_server(tmp_path / "server") + monkeypatch.setattr(opener.subprocess, "run", _FakeTmuxEnv( + {"VSCODE_GIT_ASKPASS_NODE": f"VSCODE_GIT_ASKPASS_NODE={node}\n"})) + pane_path = os.pathsep.join(["/usr/local/bin", "/usr/bin", "/bin"]) + with caplog.at_level(logging.INFO): + env = opener._prepare_ipc_env( + {"TMUX": "x", "VSCODE_IPC_HOOK_CLI": "/tmp/gone.sock", "PATH": pane_path}, + _recovered_ctx("/tmp/live.sock")) + parts = env["PATH"].split(os.pathsep) + assert parts[0] == rc + assert parts[1:] == pane_path.split(os.pathsep) + assert env["VSCODE_IPC_HOOK_CLI"] == "/tmp/live.sock" + added = [r for r in caplog.records if "remote-cli を PATH の先頭" in r.getMessage()] + assert len(added) == 1 and rc in added[0].getMessage() + assert added[0].levelno == logging.INFO + assert not [r for r in caplog.records if r.levelno >= logging.WARNING] + + +def test_prepare_ipc_env_without_pane_path(monkeypatch, tmp_path): + node, rc = _make_server(tmp_path / "server") + monkeypatch.setattr(opener.subprocess, "run", _FakeTmuxEnv( + {"VSCODE_GIT_ASKPASS_NODE": f"VSCODE_GIT_ASKPASS_NODE={node}\n"})) + env = opener._prepare_ipc_env({"TMUX": "x"}, _recovered_ctx("/tmp/live.sock")) + assert env["PATH"] == rc + + +def test_prepare_ipc_env_previous_client_keeps_recovered_ipc(monkeypatch, tmp_path): + """以前のクライアントの IPC と拾い直しが重なっても IPC を外さず、PATH を差し替える。""" + node, rc = _make_server(tmp_path / "server") + monkeypatch.setattr(opener.subprocess, "run", _FakeTmuxEnv( + {"VSCODE_GIT_ASKPASS_NODE": f"VSCODE_GIT_ASKPASS_NODE={node}\n"})) + ctx = opener.EditorContext( + is_tty=True, is_ssh=True, in_vscode=True, is_wsl=False, is_darwin=True, + ipc_socket="/tmp/live.sock", ipc_from_previous_client=True) + env = opener._prepare_ipc_env( + {"TMUX": "x", "VSCODE_IPC_HOOK_CLI": "/tmp/old.sock", "PATH": "/usr/bin"}, ctx) + assert env["VSCODE_IPC_HOOK_CLI"] == "/tmp/live.sock" + assert env["PATH"].split(os.pathsep)[0] == rc + + +@pytest.mark.parametrize("lines", [ + {}, + {"VSCODE_GIT_ASKPASS_NODE": "-VSCODE_GIT_ASKPASS_NODE\n"}, + {"VSCODE_GIT_ASKPASS_NODE": "VSCODE_GIT_ASKPASS_NODE=server/node\n"}, + {"VSCODE_GIT_ASKPASS_NODE": "VSCODE_GIT_ASKPASS_NODE=/nonexistent/server/node\n"}, +]) +def test_prepare_ipc_env_warns_when_remote_cli_missing(monkeypatch, caplog, lines): + import logging + monkeypatch.setattr(opener.subprocess, "run", _FakeTmuxEnv(lines)) + with caplog.at_level(logging.INFO): + env = opener._prepare_ipc_env( + {"TMUX": "x", "VSCODE_IPC_HOOK_CLI": "/tmp/gone.sock", "PATH": "/usr/bin"}, + _recovered_ctx("/tmp/live.sock")) + assert env["PATH"] == "/usr/bin" + assert env["VSCODE_IPC_HOOK_CLI"] == "/tmp/live.sock" + warnings = [r.getMessage() for r in caplog.records if r.levelno >= logging.WARNING] + assert len(warnings) == 1 + assert "remote-cli が見つかりません" in warnings[0] + assert "update-environment" in warnings[0] + assert "VSCODE_GIT_ASKPASS_NODE" in warnings[0] + + +def test_prepare_ipc_env_without_recovery_does_not_query(monkeypatch): + """拾い直していないときは VSCODE_GIT_ASKPASS_NODE を問い合わせず、env もそのまま。""" + run = _FakeRun() + monkeypatch.setattr(opener.subprocess, "run", run) + environ = {"TMUX": "x", "VSCODE_IPC_HOOK_CLI": "/tmp/live.sock", "PATH": "/usr/bin"} + env = opener._prepare_ipc_env(environ, _recovered_ctx("/tmp/live.sock")) + assert env is environ + assert run.calls == [] + + +def _desktop_pane(monkeypatch, tmp_path, listening_ipc_socket, lines_extra=None, + devbase_editor=None): + """再現手順の状態: ペインの PATH の先頭にデスクトップ版の code、ペインの IPC は死に、 + セッション環境の IPC だけが接続できる (Remote-SSH の統合ターミナルから attach)。""" + desktop = str(tmp_path / "desktop" / "bin") + _make_exe(tmp_path / "desktop" / "bin" / "code") + monkeypatch.setattr(opener, "resolve_container_name", + lambda *a, **kw: "proj-a-dev-1") + lines = { + "SSH_CONNECTION": "SSH_CONNECTION=192.0.2.1 1 192.0.2.2 22\n", + "VSCODE_IPC_HOOK_CLI": f"VSCODE_IPC_HOOK_CLI={listening_ipc_socket}\n", + **(lines_extra or {}), + } + run = _FakeTmuxEnv(lines) + monkeypatch.setattr(opener.subprocess, "run", run) + environ = {"TMUX": "x", "SSH_CONNECTION": "192.0.2.1 1 192.0.2.2 22", + "VSCODE_IPC_HOOK_CLI": str(tmp_path / "gone.sock"), + "PATH": os.pathsep.join([desktop, "/usr/bin"])} + if devbase_editor is not None: + environ["DEVBASE_EDITOR"] = devbase_editor + return environ, run + + +def test_open_editor_recovered_ipc_launches_matching_remote_cli( + monkeypatch, tmp_path, listening_ipc_socket): + """受け入れ条件 1・2: 起動する code は合う remote-cli のものに解決される。""" + node, rc = _make_server(tmp_path / "server") + environ, run = _desktop_pane( + monkeypatch, tmp_path, listening_ipc_socket, + {"VSCODE_GIT_ASKPASS_NODE": f"VSCODE_GIT_ASKPASS_NODE={node}\n"}) + seen = {} + result = opener.open_editor( + project_name="proj-a", dev_service_name="dev", workdir="/work", + environ=environ, isatty=True, system="Darwin", + launcher=lambda cmd, env: seen.update(cmd=cmd, env=env), + ) + assert result == "launch" + assert seen["cmd"][0] == "code" + assert shutil.which(seen["cmd"][0], path=seen["env"]["PATH"]) == os.path.join(rc, "code") + assert seen["env"]["PATH"].split(os.pathsep) == [rc, *environ["PATH"].split(os.pathsep)] + assert seen["env"]["VSCODE_IPC_HOOK_CLI"] == listening_ipc_socket + asked = [c for c in run.calls if c[-1] == "VSCODE_GIT_ASKPASS_NODE"] + assert len(asked) == 1 + + +def test_open_editor_recovered_ipc_keeps_absolute_devbase_editor( + monkeypatch, tmp_path, listening_ipc_socket): + """DEVBASE_EDITOR が絶対パスなら先頭の語はそのまま、PATH は差し替わる (前提 4)。""" + node, rc = _make_server(tmp_path / "server") + editor = _make_exe(tmp_path / "opt" / "code") + environ, _ = _desktop_pane( + monkeypatch, tmp_path, listening_ipc_socket, + {"VSCODE_GIT_ASKPASS_NODE": f"VSCODE_GIT_ASKPASS_NODE={node}\n"}, + devbase_editor=editor) + seen = {} + result = opener.open_editor( + project_name="proj-a", dev_service_name="dev", workdir="/work", + environ=environ, isatty=True, system="Darwin", + launcher=lambda cmd, env: seen.update(cmd=cmd, env=env), + ) + assert result == "launch" + assert seen["cmd"][0] == editor + assert seen["env"]["PATH"].split(os.pathsep)[0] == rc + + +def test_open_editor_recovered_ipc_without_remote_cli_still_launches( + monkeypatch, tmp_path, listening_ipc_socket): + """合う remote-cli が無くても、PATH を変えずにこれまでどおり起動する。""" + environ, _ = _desktop_pane(monkeypatch, tmp_path, listening_ipc_socket) + seen = {} + result = opener.open_editor( + project_name="proj-a", dev_service_name="dev", workdir="/work", + environ=environ, isatty=True, system="Darwin", + launcher=lambda cmd, env: seen.update(cmd=cmd, env=env), + ) + assert result == "launch" + assert seen["env"]["PATH"] == environ["PATH"] + assert seen["env"]["VSCODE_IPC_HOOK_CLI"] == listening_ipc_socket + + def test_detect_context_same_client_keeps_pane_ipc(monkeypatch, listening_ipc_socket): """SSH 状態が食い違わなければ、ペインの生きた IPC をそのまま使う (従来どおり)。""" monkeypatch.setattr(opener.subprocess, "run", _FakeTmuxEnv({ From 713847df63e0af02fa9b19554b853a4292fd4289 Mon Sep 17 00:00:00 2001 From: "takemi.ohama" Date: Tue, 17 Nov 2026 06:11:01 +0900 Subject: [PATCH 2/4] =?UTF-8?q?docs(editor):=20=E6=8B=BE=E3=81=84=E7=9B=B4?= =?UTF-8?q?=E3=81=97=E3=81=9F=E3=81=A8=E3=81=8D=E3=81=AB=E5=90=88=E3=81=86?= =?UTF-8?q?=20remote-cli=20=E3=82=92=20PATH=20=E3=81=AE=E5=85=88=E9=A0=AD?= =?UTF-8?q?=E3=81=AB=E5=85=A5=E3=82=8C=E3=82=8B=E3=81=93=E3=81=A8=E3=82=92?= =?UTF-8?q?=E6=9B=B8=E3=81=8F=20(#523)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 確定仕様(エディタで開く)・環境変数ガイドの tmux の節・CHANGELOG の [Unreleased] に、 VSCODE_GIT_ASKPASS_NODE から合う remote-cli を求めることと、update-environment への設定の要否を書く。 Co-Authored-By: Claude Opus 5.5 --- CHANGELOG.md | 9 +++++++++ docs/specifications/editor-open.md | 32 ++++++++++++++++++++++++++++++ docs/user/environment-variables.md | 6 +++++- 3 files changed, 46 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 6f572c13..cec415fe 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,15 @@ ## [Unreleased] +### Fixed +- **Remote-SSH で入ったホストの tmux から、手元の PC の VS Code にエディタが開くようにしました(#523)。** + 以前のクライアントが作った tmux のペインで、IPC ソケットを tmux のセッション環境から拾い直しても、起動されるのは + ペインの `PATH` の先頭にあるホストのデスクトップ版の `code` で、手元の PC には何も開いていませんでした。 + 拾い直したときは、セッション環境の `VSCODE_GIT_ASKPASS_NODE` からそのソケットと同じ VS Code サーバーの + `remote-cli` を求め、`PATH` の先頭に入れて起動します。見つからないときは理由と設定の案内を警告に出し、 + これまでどおり起動します。**効かせるには `~/.tmux.conf` の `update-environment` に `VSCODE_GIT_ASKPASS_NODE` を + 入れます**([環境変数ガイド](docs/user/environment-variables.md)の tmux の節の推奨設定に含まれています)。 + ## [4.2.0] - 2026-11-06 ### Added diff --git a/docs/specifications/editor-open.md b/docs/specifications/editor-open.md index ae0fe36c..4a288091 100644 --- a/docs/specifications/editor-open.md +++ b/docs/specifications/editor-open.md @@ -92,6 +92,33 @@ graph TD `docker ps` の環境変数 `DOCKER_CONTEXT` と、`opener.open_editor` の `docker_context` の両方に使う - 機密は `login` と同じく任意で注入する(`opener` の `docker compose ps` の補間のため) +### tmux で IPC ソケットを拾い直したときの起動 + +`up` の自動オープンと `open` に共通の、`opener.open_editor` の振る舞いである。tmux のペインのシェルの +`VSCODE_IPC_HOOK_CLI` が使えず、tmux のセッション環境から接続できるソケットを拾い直したとき +(`_prepare_ipc_env`)は、そのソケットと同じ VS Code サーバーの `remote-cli` を `PATH` の先頭に入れて起動する。 +ペインの `PATH` の先頭がデスクトップ版の `code` だと、`VSCODE_IPC_HOOK_CLI` があってもホストの VS Code に向けて +開き、手元の PC に窓が開かないためである。 + +| 場面 | 起動に渡す環境 | ログ | +| --- | --- | --- | +| 拾い直し、合う `remote-cli` がある | `VSCODE_IPC_HOOK_CLI` は拾い直したソケット。`PATH` は先頭が合う `remote-cli`、2 番目以降がペインの `PATH` の要素(並びも重複もそのまま。ペインに `PATH` が無ければ `remote-cli` だけ) | info 1 行(足したディレクトリ) | +| 拾い直し、合う `remote-cli` が無い | `VSCODE_IPC_HOOK_CLI` だけ差し替え、`PATH` はペインのまま。起動は続ける | warning 1 行(見つからない理由と、`update-environment` に `VSCODE_GIT_ASKPASS_NODE` を入れる案内) | +| 拾い直していない | 変更なし。`VSCODE_GIT_ASKPASS_NODE` を問い合わせない | 変更なし | + +- **合う `remote-cli` は、セッション環境の `VSCODE_GIT_ASKPASS_NODE` だけから求める。** 値は VS Code サーバーの + `node` の絶対パスで、その置かれたディレクトリの `bin/remote-cli` を使う。`~/.vscode-server` などのサーバーの + ディレクトリは探さない(版の違うサーバーが並び、拾い直したソケットのものを決められないため)。tmux への + 問い合わせは拾い直したときに 1 回(`tmux show-environment VSCODE_GIT_ASKPASS_NODE`、上限 2 秒)だけ増える +- **足すのは、値が絶対パスで、求めたディレクトリに起動するエディタの名前の実行できる通常のファイルがあるときだけ。** + 名前は `DEVBASE_EDITOR` の先頭の語の末尾の名前、無ければ `code` +- 見つからない理由は 4 つ: セッション環境に無い(tmux の失敗を含む)・消されている(`-VSCODE_GIT_ASKPASS_NODE`)・ + 絶対パスでない・求めたディレクトリに実行できるエディタが無い +- エディタの存在の確かめも、起動に渡す環境の `PATH` で行う(起動も同じ `PATH` で実行ファイルを探すため)。 + 起動するコマンドの先頭の語は書き換えない。`DEVBASE_EDITOR` が絶対パスなら、その実行ファイルが起動される +- `VSCODE_GIT_ASKPASS_NODE` は tmux の `update-environment` の既定に入っていない。利用者が + [環境変数ガイド](../user/environment-variables.md)の tmux の設定を入れたときだけセッション環境に入る + ### 引数と終了コード | 状況 | 終了コード | 出力 | @@ -137,6 +164,7 @@ graph TD | `DEVBASE_OPEN_INDEX` | `--open-index` を省いたときの番号。数でなければ 1。`up` と読み方を共有する | | `DEVBASE_OPEN_EDITOR` / `project.yml` の `open_editor` | `open` では見ない | | `DEVBASE_EDITOR` / `DEVBASE_EDITOR_SSH_HOST` / `DEVBASE_EDITOR_DOCKER_CONTEXT` / `DEVBASE_WORKSPACE` | `opener.open_editor` が従来どおり読む | +| tmux のセッション環境の `VSCODE_GIT_ASKPASS_NODE` | IPC ソケットを拾い直したときだけ読み、合う `remote-cli` を求める。ペインのシェルの値は見ない | 永続データは持たない。 @@ -171,6 +199,10 @@ graph TD - `project_open_candidates` の返す値・切り替え先の接続先へ問い合わせること・名前を解決できない/`docker ps` の失敗で `None`(`tests/commands/test_container_open.py`) - bash / zsh の補完(`tests/cli/test_completion.py`) +- tmux で拾い直したとき、合う `remote-cli` が `PATH` の先頭に入り起動する `code` がそれに解決されること、 + ペインの要素の並びが保たれること、見つからない 4 つの理由で `PATH` が変わらず warning が 1 行出ること、 + 拾い直さないときに `VSCODE_GIT_ASKPASS_NODE` を問い合わせないこと(`tests/editor/test_opener.py`。tmux は + `subprocess.run` を差し替え、実の tmux サーバーに触れない) 実機(起動中のプロジェクト、非 TTY)では、`open` / `open --open-index <動いていない番号>` / `open --context <存在しない context>` / `open --open 2` / `project open --open-index 2` の終了コードが上の表の diff --git a/docs/user/environment-variables.md b/docs/user/environment-variables.md index e392f68d..1a77497e 100644 --- a/docs/user/environment-variables.md +++ b/docs/user/environment-variables.md @@ -563,6 +563,10 @@ devbase は**実際にソケットへ接続できるかを確認**してから V 死んでいた場合、**tmux 内なら `tmux show-environment` を見に行きます**。`update-environment`(後述)を設定していれば、tmux のセッション環境は attach のたびに更新されるので、**ペインのシェルが古くても tmux 側には生きた値が入っています**。拾えた場合はその値を使い、起動する `code` にも渡します(変数を差し替えないと `code` 自身が古いソケットへ繋ぎに行って失敗するため)。 +拾い直したときは、そのソケットと同じ VS Code サーバーの `remote-cli`(`<サーバーのディレクトリ>/bin/remote-cli`)を、起動に渡す `PATH` の先頭に入れます。ペインのシェルの `PATH` の先頭がホストのデスクトップ版の `code`(`/usr/local/bin/code` など)だと、`VSCODE_IPC_HOOK_CLI` があってもホストの VS Code に向けて開き、手元の PC に窓が開かないためです。サーバーのディレクトリは、tmux のセッション環境の `VSCODE_GIT_ASKPASS_NODE`(VS Code サーバーの `node` の絶対パス)の置かれた場所から求めます。`~/.vscode-server` の下を探すことはしません(版の違うサーバーが並び、拾い直したソケットのものを決められないため)。ペインの `PATH` のほかの要素は、並びを変えずに残します。 + +`VSCODE_GIT_ASKPASS_NODE` は tmux の `update-environment` の既定に入っていないため、**後述の設定を入れていないと合う `remote-cli` は見つかりません**。見つからないとき(セッション環境に無い・消されている・絶対パスでない・求めた場所に実行できる `code` が無い)は、理由と後述の設定の案内を警告で出し、`PATH` を変えずにこれまでどおり起動します。 + SSH 越しかどうかの判定も、tmux 内ではセッション環境の `SSH_CONNECTION` を見ます。SSH から立てた tmux サーバーに手元の端末から attach し直すと、ペインのシェルには `SSH_CONNECTION` が残りますが、セッション環境は `-SSH_CONNECTION`(いまのクライアントは SSH でない)に更新されます。`SSH_CONNECTION` は tmux の `update-environment` に既定で入っているので、設定は要りません。セッション環境から分からないとき(tmux 外・tmux の失敗)は、ペインのシェルの `SSH_CONNECTION` / `SSH_CLIENT` / `SSH_TTY` で判定します。 セッション環境から分かるいまのクライアントの SSH 状態が、ペインのシェルの SSH 状態(`SSH_*` の有無)と食い違うときは、向きによらず、ペインのシェルに残る `VSCODE_IPC_HOOK_CLI` はペインを作った以前のクライアントのものとみなし、そのウィンドウが開いたままで接続できても使いません。SSH から立てた tmux に手元から attach し直したときは、ホスト上のコンテナを開く URI がリモートのクライアントへ届いて開けず、手元で立てた tmux に Remote-SSH から attach し直したときは、SSH 先を経由する URI が Remote-SSH の接続を持たない手元の VS Code へ届いて開けないためです。tmux のセッション環境にいまのクライアントの生きた値が入っていれば、そちらを使います。入っていなければ IPC 無しとして扱い、SSH なら手元で実行するコマンドを示し、手元なら手元の `code` を起動します。食い違わないとき・セッション環境から分からないときは、ペインの値をこれまでどおり使います。死んだソケットを指す `VSCODE_IPC_HOOK_CLI` も、起動する `code` に渡しません。`VSCODE_IPC_HOOK_CLI` を外すときは、`PATH` から Remote-SSH などの `remote-cli`(`~/.vscode-server/bin//bin/remote-cli`・`~/.cursor-server/...` など)を除いて手元の `code` を探します。`remote-cli` の `code` は `VSCODE_IPC_HOOK_CLI` が無いと何も開かずに終わるためです。手元の `code` が見つからなければ、起動せずにスキップします。 @@ -584,7 +588,7 @@ SSH 越しかどうかの判定も、tmux 内ではセッション環境の `SSH set -ga update-environment " VSCODE_IPC_HOOK_CLI VSCODE_GIT_IPC_HANDLE VSCODE_GIT_ASKPASS_NODE VSCODE_GIT_ASKPASS_MAIN VSCODE_GIT_ASKPASS_EXTRA_ARGS VSCODE_NONCE GIT_ASKPASS BROWSER TERM_PROGRAM" ``` -これで **attach のたびに**接続してきたクライアントの値でセッション環境が更新されます。**`devbase up` にはこの設定だけで十分**です(devbase がセッション環境を直接読むため)。 +これで **attach のたびに**接続してきたクライアントの値でセッション環境が更新されます。**`devbase up` にはこの設定だけで十分**です(devbase がセッション環境を直接読むため)。`VSCODE_IPC_HOOK_CLI` と `VSCODE_GIT_ASKPASS_NODE` の 2 つは、Remote-SSH で入ったホストの tmux から手元の VS Code に開くために要ります(後者は合う `remote-cli` を求めるため)。 ただし更新されるのはセッション環境であり、**すでに起動しているペインのシェル**には波及しません。`code` を手で叩く、git の askpass を使うなど **devbase 以外**でも追随させたい場合は、シェルの rc(`~/.bash_profile` 等)にプロンプトフックを置きます。なお **rc を書き換えても、すでに動いているシェルには反映されません**(起動時に一度読むだけのため)。そのペインで直ちに効かせたいときは `source ~/.bash_profile` するか、開き直してください。 From be6156b7f2035bb3e48abdfaae6740a0aed09ee7 Mon Sep 17 00:00:00 2001 From: "takemi.ohama" Date: Tue, 17 Nov 2026 06:17:17 +0900 Subject: [PATCH 3/4] =?UTF-8?q?docs(editor):=20=E5=90=88=E3=81=86=20remote?= =?UTF-8?q?-cli=20=E3=81=A7=E7=A2=BA=E3=81=8B=E3=82=81=E3=82=8B=E3=81=AE?= =?UTF-8?q?=E3=81=AF=E8=B5=B7=E5=8B=95=E3=81=99=E3=82=8B=E3=82=A8=E3=83=87?= =?UTF-8?q?=E3=82=A3=E3=82=BF=E3=81=AE=E5=90=8D=E5=89=8D=E3=81=A7=E3=81=82?= =?UTF-8?q?=E3=82=8B=E3=81=93=E3=81=A8=E3=82=92=E7=92=B0=E5=A2=83=E5=A4=89?= =?UTF-8?q?=E6=95=B0=E3=82=AC=E3=82=A4=E3=83=89=E3=81=AB=E6=8F=83=E3=81=88?= =?UTF-8?q?=E3=82=8B=20(#523)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- docs/user/environment-variables.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/user/environment-variables.md b/docs/user/environment-variables.md index 1a77497e..cd43fb8e 100644 --- a/docs/user/environment-variables.md +++ b/docs/user/environment-variables.md @@ -565,7 +565,7 @@ devbase は**実際にソケットへ接続できるかを確認**してから V 拾い直したときは、そのソケットと同じ VS Code サーバーの `remote-cli`(`<サーバーのディレクトリ>/bin/remote-cli`)を、起動に渡す `PATH` の先頭に入れます。ペインのシェルの `PATH` の先頭がホストのデスクトップ版の `code`(`/usr/local/bin/code` など)だと、`VSCODE_IPC_HOOK_CLI` があってもホストの VS Code に向けて開き、手元の PC に窓が開かないためです。サーバーのディレクトリは、tmux のセッション環境の `VSCODE_GIT_ASKPASS_NODE`(VS Code サーバーの `node` の絶対パス)の置かれた場所から求めます。`~/.vscode-server` の下を探すことはしません(版の違うサーバーが並び、拾い直したソケットのものを決められないため)。ペインの `PATH` のほかの要素は、並びを変えずに残します。 -`VSCODE_GIT_ASKPASS_NODE` は tmux の `update-environment` の既定に入っていないため、**後述の設定を入れていないと合う `remote-cli` は見つかりません**。見つからないとき(セッション環境に無い・消されている・絶対パスでない・求めた場所に実行できる `code` が無い)は、理由と後述の設定の案内を警告で出し、`PATH` を変えずにこれまでどおり起動します。 +`VSCODE_GIT_ASKPASS_NODE` は tmux の `update-environment` の既定に入っていないため、**後述の設定を入れていないと合う `remote-cli` は見つかりません**。見つからないとき(セッション環境に無い・消されている・絶対パスでない・求めた場所に実行できるエディタ(`DEVBASE_EDITOR` の先頭の語の名前。無ければ `code`)が無い)は、理由と後述の設定の案内を警告で出し、`PATH` を変えずにこれまでどおり起動します。 SSH 越しかどうかの判定も、tmux 内ではセッション環境の `SSH_CONNECTION` を見ます。SSH から立てた tmux サーバーに手元の端末から attach し直すと、ペインのシェルには `SSH_CONNECTION` が残りますが、セッション環境は `-SSH_CONNECTION`(いまのクライアントは SSH でない)に更新されます。`SSH_CONNECTION` は tmux の `update-environment` に既定で入っているので、設定は要りません。セッション環境から分からないとき(tmux 外・tmux の失敗)は、ペインのシェルの `SSH_CONNECTION` / `SSH_CLIENT` / `SSH_TTY` で判定します。 From ce73ac9301c433bd1f3695d9fafec9df249db47b Mon Sep 17 00:00:00 2001 From: "takemi.ohama" Date: Tue, 17 Nov 2026 06:23:53 +0900 Subject: [PATCH 4/4] =?UTF-8?q?test(editor):=20remote-cli=20=E3=81=8C?= =?UTF-8?q?=E7=84=A1=E3=81=84=E7=B5=8C=E8=B7=AF=E3=81=AE=E3=83=86=E3=82=B9?= =?UTF-8?q?=E3=83=88=E3=81=A7=E3=80=81=E3=83=97=E3=83=AD=E3=82=BB=E3=82=B9?= =?UTF-8?q?=E3=81=AE=20PATH=20=E3=82=92=E3=83=9A=E3=82=A4=E3=83=B3?= =?UTF-8?q?=E3=81=AB=E6=8F=83=E3=81=88=E3=82=8B=20(#523)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit PATH を変えない経路ではエディタを実行中のプロセスの PATH で探すため、 端末に code があるか(macOS の /usr/local/bin/code)で結果が変わり、 CI(Linux)でだけ skip になって落ちていた。 Co-Authored-By: Claude Opus 5.5 --- tests/editor/test_opener.py | 3 +++ 1 file changed, 3 insertions(+) diff --git a/tests/editor/test_opener.py b/tests/editor/test_opener.py index 0e4219c2..7f788e50 100644 --- a/tests/editor/test_opener.py +++ b/tests/editor/test_opener.py @@ -784,6 +784,9 @@ def _desktop_pane(monkeypatch, tmp_path, listening_ipc_socket, lines_extra=None, "PATH": os.pathsep.join([desktop, "/usr/bin"])} if devbase_editor is not None: environ["DEVBASE_EDITOR"] = devbase_editor + # PATH を変えない経路ではエディタを実行中のプロセスの PATH で探す (これまでどおり)。 + # 端末に code があるかで結果が変わらないよう、プロセスの PATH もペインに揃える。 + monkeypatch.setenv("PATH", environ["PATH"]) return environ, run