fix(up): 実コンテナ名 docker 取得+フォールバックと open_index 範囲検証

レビュー指摘 (PR #69) 対応:

- 指摘A (major): PLAN31_3 §3 が約束した「compose バージョン差異への保険」を実装。
  opener._query_container_name で docker compose ps --format json を実行し、
  NDJSON / JSON 配列の両形式から実 .Name を取得。失敗・非0・例外・空は None に
  握り潰し、resolve_container_name が決定的名へフォールバックする。runner 差替で
  テスト可能。

- 指摘B (minor): _maybe_open_editor に scale を渡し open_index を 1..scale で
  検証。0・負数・scale 超過は warning を出して既定 (1) へフォールバックする。
  DEVBASE_OPEN_INDEX 経由も同じ検証を通る。

756 passed (+8 tests)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: takemi-ohama

lib/devbase/commands/container.py

@@ -356,11 +356,15 @@ def _auto_snapshot() -> None:
 
 
 def _maybe_open_editor(project_name: str, open_flag: Optional[bool],
-                       open_index: Optional[int]) -> None:
+                       open_index: Optional[int], scale: int) -> None:
     """`up` 完了後に dev コンテナへ接続したエディタを開く ([6/6])。
 
     有効判定は ``open_flag`` (CLI ``--open``/``--no-open``) が優先、None なら env
     ``DEVBASE_OPEN_EDITOR``。エディタ起動の成否は ``up`` の戻り値に影響させない。
+
+    ``open_index`` は起動済みインスタンス範囲 ``1..scale`` 内である必要がある。
+    0・負数・``scale`` 超過は存在しないコンテナ URI になり原因不明な起動失敗を招くため、
+    警告を出して既定 (1) へフォールバックする。
     """
     from devbase.editor import opener
 
@@ -375,6 +379,14 @@ def _maybe_open_editor(project_name: str, open_flag: Optional[bool],
         except ValueError:
             open_index = 1
 
+    # 起動済みインスタンス範囲 (1..scale) の検証。範囲外は既定 (1) へフォールバック。
+    if not (1 <= open_index <= scale):
+        logger.warning(
+            "open index %d is out of range (1..%d); falling back to 1",
+            open_index, scale,
+        )
+        open_index = 1
+
     dev_service_name = get_dev_service_name()
     workdir = opener.resolve_workdir(os.environ, project_name)
     logger.info("[6/6] Opening editor attached to the dev container...")
@@ -458,7 +470,7 @@ def cmd_up(project_name: str = None, scale: int = None,
         if deploy_script.exists() and deploy_script.is_file():
             _run_deploy_script_for_instances(deploy_script, range(1, scale + 1))
 
-        _maybe_open_editor(project_name, open_editor, open_index)
+        _maybe_open_editor(project_name, open_editor, open_index, scale)
 
         logger.info("=== Deploy completed successfully ===")
         return 0

lib/devbase/editor/opener.py

@@ -135,13 +135,87 @@ def build_attach_uri(container_name: str, workdir: str) -> str:
     return f"vscode-remote://attached-container+{hexname}{path}"
 
 
-def resolve_container_name(dev_service_name: str, project_name: str, index: int = 1) -> str:
+def _parse_compose_ps_name(stdout: str) -> Optional[str]:
+    """``docker compose ps --format json`` の出力から ``.Name`` を 1 件取り出す。
+
+    docker compose のバージョン差で出力形式が異なる:
+
+    - 新しめ: 1 行 1 JSON オブジェクト (改行区切り NDJSON)
+    - 古め:   JSON 配列 ``[{...}, ...]``
+
+    どちらでも先頭インスタンスの ``Name`` を返す。解釈不能・空なら None。
+    """
+    text = (stdout or "").strip()
+    if not text:
+        return None
+    # まず JSON 配列としてのパースを試す。
+    try:
+        obj = json.loads(text)
+    except ValueError:
+        obj = None
+    if isinstance(obj, list):
+        for item in obj:
+            if isinstance(item, dict) and item.get("Name"):
+                return item["Name"]
+        return None
+    if isinstance(obj, dict) and obj.get("Name"):
+        return obj["Name"]
+    # NDJSON (1 行 1 JSON) として行ごとにパース。
+    for line in text.splitlines():
+        line = line.strip()
+        if not line:
+            continue
+        try:
+            item = json.loads(line)
+        except ValueError:
+            continue
+        if isinstance(item, dict) and item.get("Name"):
+            return item["Name"]
+    return None
+
+
+def _query_container_name(dev_service_name: str, index: int,
+                          runner: Optional[Callable] = None) -> Optional[str]:
+    """実 docker へ問い合わせて dev インスタンスの実コンテナ名を取得する (保険)。
+
+    scale 生成 compose ではサービス名が ``{dev}-{index}`` (例 ``dev-1``) になるため
+    その service token を指定して ``docker compose ps --format json`` を実行する。
+    取得できなければ None。docker 不在・非0・例外・空はすべて None に握り潰し、
+    呼び出し側が決定的名へフォールバックできるようにする。
+    """
+    run = runner or subprocess.run
+    service_token = f"{dev_service_name}-{index}"
+    try:
+        proc = run(
+            ["docker", "compose", "ps", "--format", "json", service_token],
+            capture_output=True, text=True, timeout=10,
+        )
+    except Exception:  # noqa: BLE001 - docker 不在等は保険なので握り潰す
+        return None
+    if getattr(proc, "returncode", 1) != 0:
+        return None
+    try:
+        return _parse_compose_ps_name(proc.stdout)
+    except Exception:  # noqa: BLE001 - パース失敗も決定的名へフォールバック
+        return None
+
+
+def resolve_container_name(dev_service_name: str, project_name: str, index: int = 1,
+                           runner: Optional[Callable] = None) -> str:
     """dev コンテナの実コンテナ名を返す。
 
-    scale 生成 compose が ``container_name = ${COMPOSE_PROJECT_NAME}-{dev}-{index}``
+    PLAN31_3 §3: compose バージョン差異への保険として、まず実 docker へ
+    ``docker compose ps --format json`` で問い合わせて実 ``Name`` を取得する。
+    取得できなければ決定的名 ``{project_name}-{dev_service_name}-{index}`` へ
+    フォールバックする。
+
+    scale 生成 compose は ``container_name = ${COMPOSE_PROJECT_NAME}-{dev}-{index}``
     を全インスタンスへ設定する (volume/compose.py)。COMPOSE_PROJECT_NAME は
-    project_name と一致するため決定的に組み立てられる。
+    project_name と一致するため、docker 問い合わせに失敗しても決定的に組み立てられる。
     """
+    queried = _query_container_name(dev_service_name, index, runner=runner)
+    if queried:
+        return queried
     return f"{project_name}-{dev_service_name}-{index}"
 
 

tests/cli/test_project_dispatch.py

@@ -359,7 +359,7 @@ def test_maybe_open_editor_disabled_by_default(monkeypatch):
     called = []
     monkeypatch.setattr(opener, 'open_editor',
                         lambda **kw: called.append(kw) or 'launch')
-    container._maybe_open_editor('carmo', None, None)
+    container._maybe_open_editor('carmo', None, None, 1)
     assert called == []
 
 
@@ -372,7 +372,7 @@ def test_maybe_open_editor_flag_overrides_env(monkeypatch):
     monkeypatch.setattr(opener, 'open_editor',
                         lambda **kw: called.append(kw) or 'launch')
     monkeypatch.setattr(container, 'get_dev_service_name', lambda: 'dev')
-    container._maybe_open_editor('carmo', True, 1)
+    container._maybe_open_editor('carmo', True, 1, 1)
     assert len(called) == 1
     assert called[0]['project_name'] == 'carmo'
 
@@ -388,4 +388,32 @@ def boom(**kw):
         raise RuntimeError("x")
 
     monkeypatch.setattr(opener, 'open_editor', boom)
-    container._maybe_open_editor('carmo', None, None)  # 例外が出なければ OK
+    container._maybe_open_editor('carmo', None, None, 1)  # 例外が出なければ OK
+
+
+@pytest.mark.parametrize('bad_index', [0, -1, 3])
+def test_maybe_open_editor_out_of_range_index_falls_back(monkeypatch, bad_index):
+    """0・負数・scale 超過の index は既定 (1) へフォールバックする (scale=2)。"""
+    from devbase.commands import container
+    from devbase.editor import opener
+    monkeypatch.setattr(opener, 'is_open_enabled', lambda environ=None: True)
+    monkeypatch.setattr(container, 'get_dev_service_name', lambda: 'dev')
+    called = []
+    monkeypatch.setattr(opener, 'open_editor',
+                        lambda **kw: called.append(kw) or 'launch')
+    container._maybe_open_editor('carmo', True, bad_index, 2)
+    assert len(called) == 1
+    assert called[0]['index'] == 1
+
+
+def test_maybe_open_editor_valid_index_within_scale(monkeypatch):
+    """範囲内 (1..scale) の index はそのまま使われる。"""
+    from devbase.commands import container
+    from devbase.editor import opener
+    monkeypatch.setattr(opener, 'is_open_enabled', lambda environ=None: True)
+    monkeypatch.setattr(container, 'get_dev_service_name', lambda: 'dev')
+    called = []
+    monkeypatch.setattr(opener, 'open_editor',
+                        lambda **kw: called.append(kw) or 'launch')
+    container._maybe_open_editor('carmo', True, 2, 3)
+    assert called[0]['index'] == 2

tests/editor/test_opener.py

@@ -3,12 +3,20 @@
 from __future__ import annotations
 
 import json
+from dataclasses import dataclass
 
 import pytest
 
 from devbase.editor import opener
 
 
+@dataclass
+class _Proc:
+    """subprocess.run 互換の軽量スタブ (returncode / stdout のみ)。"""
+    returncode: int = 0
+    stdout: str = ""
+
+
 # ---------------------------------------------------------------------------
 # detect_context
 # ---------------------------------------------------------------------------
@@ -109,8 +117,50 @@ def test_build_attach_uri_adds_leading_slash():
 # ---------------------------------------------------------------------------
 
 def test_resolve_container_name_deterministic():
+    """docker 問い合わせが失敗 (非0) する場合は決定的名へフォールバックする。"""
+    def failing_runner(cmd, **kw):
+        return _Proc(returncode=1, stdout="")
+
+    assert opener.resolve_container_name("dev", "carmo", 1, runner=failing_runner) \
+        == "carmo-dev-1"
+    assert opener.resolve_container_name("app", "carmo", 3, runner=failing_runner) \
+        == "carmo-app-3"
+
+
+def test_resolve_container_name_falls_back_when_docker_absent(monkeypatch):
+    """docker 不在 (例外) でも決定的名で必ず動く。"""
+    monkeypatch.setattr(opener, "_query_container_name",
+                        lambda *a, **kw: None)
     assert opener.resolve_container_name("dev", "carmo", 1) == "carmo-dev-1"
-    assert opener.resolve_container_name("app", "carmo", 3) == "carmo-app-3"
+
+
+def test_resolve_container_name_prefers_docker_name_ndjson():
+    """docker から取得できた実 Name (NDJSON) を決定的名より優先する。"""
+    def runner(cmd, **kw):
+        # service token は dev-2 を指定しているはず
+        assert cmd[:4] == ["docker", "compose", "ps", "--format"]
+        assert cmd[-1] == "dev-2"
+        return _Proc(returncode=0,
+                     stdout='{"Name":"real-dev-2","Service":"dev-2"}\n')
+
+    assert opener.resolve_container_name("dev", "carmo", 2, runner=runner) \
+        == "real-dev-2"
+
+
+def test_resolve_container_name_prefers_docker_name_json_array():
+    """JSON 配列形式の docker compose ps 出力にも対応する。"""
+    def runner(cmd, **kw):
+        return _Proc(returncode=0,
+                     stdout='[{"Name":"real-dev-1","Service":"dev-1"}]')
+
+    assert opener.resolve_container_name("dev", "carmo", 1, runner=runner) \
+        == "real-dev-1"
+
+
+def test_parse_compose_ps_name_empty_and_invalid():
+    assert opener._parse_compose_ps_name("") is None
+    assert opener._parse_compose_ps_name("not json") is None
+    assert opener._parse_compose_ps_name("[]") is None
 
 
 def test_resolve_workdir_prefers_work_dir_env():