fix: TUI(list) 経路で env の変数参照を展開する

_load_project_env が $VAR / ${VAR} を展開しない仕様だったため、
全プロジェクト env が依存する WORK_DIR=/work/$GIT_REPO が devbase list
経由ではリテラルのまま VS Code に渡り、ワークスペースが $GIT_REPO という
パスで開いてしまっていた。shell `source ./env` 相当に os.path.expandvars で
変数展開する (単一引用符値はリテラル、$(...) コマンド置換は非対応のまま)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: takemi-ohama

lib/devbase/commands/container.py

@@ -166,26 +166,32 @@ def _load_project_env(env_file: Path) -> None:
 
     env は環境変数定義のみを想定したファイル (bin/devbase 冒頭コメント参照) の
     ため、ここでは ``export`` 接頭辞付き / 無しの単純な ``KEY=VALUE`` 行のみを
-    解釈する。``#`` コメント・空行は無視し、値の前後のクォートは除去する。shell
-    の変数展開やコマンド置換は意図的にサポートしない (安全側に倒す)。
+    解釈する。``#`` コメント・空行は無視し、値の前後のクォートは除去する。
+
+    変数参照 (``$VAR`` / ``${VAR}``) は shell ``source ./env`` (wrapper 経路) と
+    同様に展開する。実 env が ``WORK_DIR=/work/$GIT_REPO`` のように同一ファイル内で
+    先に定義した変数を参照しており、展開しないと TUI (``list``) 経路でワークスペース
+    パスが ``$GIT_REPO`` 等の未展開文字列のまま VS Code で開いてしまうため
+    (行は file 順に ``os.environ`` へ載せるので、参照時には先行行の値が解決済み)。
+    単一引用符 ``'...'`` の値は shell 同様リテラル扱いで展開しない。
 
     .. note:: shell ``source`` との仕様乖離について
 
-       本パーサは完全な POSIX shell パーサではなく、shell ``source ./env``
-       (wrapper 経路) とは以下のケースで挙動が乖離する。env は単純な
+       本パーサは完全な POSIX shell パーサではなく、変数展開はサポートするが
+       以下のケースでは shell ``source ./env`` と挙動が乖離する。env は単純な
        ``KEY=VALUE`` 定義に限定する運用前提のため、これらは意図的な制約として
-       受容し、ファイル側で利用しない方針とする (仕様統一ではなく制約の明示)::
+       受容する (仕様統一ではなく制約の明示)::
 
-         FOO=$BAR        # shell: 展開 → 本実装: リテラル文字列 "$BAR"
          FOO=$(cmd)      # shell: コマンド置換 → 本実装: リテラル "$(cmd)"
+                         #        (os.path.expandvars は $(...) を変数とみなさない)
          FOO=a"b"c       # shell: クォート除去で "abc" → 本実装: 行頭/行末以外の
                          #        クォートは除去せず "a\"b\"c"
          FOO=bar # x     # shell: インラインコメント無効 (値は "bar # x") →
                          #        本実装も値は "bar # x" (行頭 # のみコメント扱い)
 
        いずれも wrapper を経ない直接起動 (例:
-       ``python -m devbase.cli project up <name>``) のフォールバック時のみ影響し、
-       通常運用の wrapper 経路では shell が env を解釈するため差異は生じない。
+       ``python -m devbase.cli project up <name>`` / TUI ``list``) 経路で用いる。
+       通常の wrapper 経路では shell が env を解釈する。
     """
     if not env_file.is_file():
         return
@@ -199,8 +205,19 @@ def _load_project_env(env_file: Path) -> None:
             continue
         key, value = assignment
         value = value.strip()
+        single_quoted = False
         if len(value) >= 2 and value[0] == value[-1] and value[0] in ('"', "'"):
+            single_quoted = value[0] == "'"
             value = value[1:-1]
+        # shell `source ./env` 相当の変数展開 ($VAR / ${VAR}) を行う。実 env は
+        # `WORK_DIR=/work/$GIT_REPO` のように同一ファイル内で先に定義した変数を
+        # 参照しており (行順に os.environ へ載せるため参照時には解決済み)、展開
+        # しないと TUI (list) 経路でワークスペースパスが未展開のまま開いてしまう。
+        # 単一引用符はリテラル ($BAR を展開しない) という shell 規則に合わせ、
+        # `'...'` の場合のみ展開しない。os.path.expandvars は `$(...)` を変数とは
+        # みなさず素通しするため、コマンド置換は従来どおりリテラルのまま残る。
+        if not single_quoted:
+            value = os.path.expandvars(value)
         os.environ[key] = value
 
 

tests/cli/test_project_name_resolution.py

@@ -192,27 +192,50 @@ def test_resolve_clears_caller_only_env_keys(fake_root, monkeypatch):
 def test_load_project_env_diverges_from_shell_source(tmp_path, monkeypatch):
     """shell ``source`` との仕様乖離を固定する回帰テスト (docstring の note 対応)。
 
-    本パーサは変数展開・コマンド置換・行中クォート除去・インラインコメントを
-    解釈せず、値を安全側にリテラルとして扱う。この意図的な制約を pin する。
+    変数展開 (``$VAR`` / ``${VAR}``) は shell ``source`` 同様にサポートするが、
+    コマンド置換・行中クォート除去・インラインコメントは解釈しない。この境界を pin する。
     """
-    for k in ("LIT_VAR", "LIT_CMD", "INNER_Q", "INLINE_C"):
+    for k in ("LIT_CMD", "INNER_Q", "INLINE_C"):
         monkeypatch.delenv(k, raising=False)
     env_path = tmp_path / "env"
     env_path.write_text(
-        "LIT_VAR=$HOME\n"        # 変数展開しない (リテラル "$HOME")
         "LIT_CMD=$(echo x)\n"    # コマンド置換しない (リテラル "$(echo x)")
         'INNER_Q=a"b"c\n'        # 行中クォートは除去しない
         "INLINE_C=bar # note\n"  # 行頭以外の # はコメント扱いしない
     )
 
     container._load_project_env(env_path)
 
-    assert os.environ["LIT_VAR"] == "$HOME"
     assert os.environ["LIT_CMD"] == "$(echo x)"
     assert os.environ["INNER_Q"] == 'a"b"c'
     assert os.environ["INLINE_C"] == "bar # note"
 
 
+def test_load_project_env_expands_variable_references(tmp_path, monkeypatch):
+    """``$VAR`` / ``${VAR}`` を shell ``source`` 同様に展開する回帰テスト。
+
+    実 env の ``WORK_DIR=/work/$GIT_REPO`` (同一ファイル内で先に定義した変数を参照)
+    が TUI (``list``) 経路で未展開のまま VS Code に渡る不具合の回帰防止。
+    単一引用符値はリテラル扱いで展開しないことも併せて pin する。
+    """
+    for k in ("GIT_REPO", "WORK_DIR", "WORK_DIR_BRACE", "SINGLE_Q"):
+        monkeypatch.delenv(k, raising=False)
+    env_path = tmp_path / "env"
+    env_path.write_text(
+        "GIT_REPO=adminer\n"
+        "WORK_DIR=/work/$GIT_REPO\n"        # 行順に解決済みの GIT_REPO を展開
+        "WORK_DIR_BRACE=/work/${GIT_REPO}\n"  # ${VAR} 形式も展開
+        "SINGLE_Q='/work/$GIT_REPO'\n"      # 単一引用符はリテラル
+    )
+
+    container._load_project_env(env_path)
+
+    assert os.environ["GIT_REPO"] == "adminer"
+    assert os.environ["WORK_DIR"] == "/work/adminer"
+    assert os.environ["WORK_DIR_BRACE"] == "/work/adminer"
+    assert os.environ["SINGLE_Q"] == "/work/$GIT_REPO"
+
+
 # ===========================================================================
 # wrapper: cd + argv strip + 存在性ベースの曖昧性回避
 # ===========================================================================