feat: PLAN06-2 wrapper cd によるプロジェクト名解決 + トップレベルシノニム

任意の CWD から `devbase project up <name>` / `devbase up <name>` でプロジェクトを
指定操作できるよう、プロジェクト名解決を実装する (PLAN06 Task 2 / 方針 A: wrapper cd)。

bin/devbase (核心):
- maybe_cd_project を追加。project/container <sub> <name> 及びトップレベルシノニム
  <sub> <name> の <name> が $DEVBASE_ROOT/projects/<name> に実在する場合のみ cd し、
  COMPOSE_PROJECT_NAME / ./env を cd 後に再設定、argv から name を strip して下流へ。
- 実在性ベースの判定により login <index> / build <image> / scale <N> の既存
  positional と曖昧にならない (実在プロジェクト名のときだけ name 扱い)。
- build は shell 実装 (cmd_build) のため、この wrapper cd だけが build の name
  解決手段になる (方針 A の核心)。dispatch を name strip 後の _DEVBASE_ARGS 経由に変更。

lib/devbase/commands/container.py (Python 防御フォールバック):
- PR1 の「name 解決は未実装」warning を撤去し、_resolve_project_name で
  projects/<name> 解決 → os.chdir (wrapper が cd 済みなら冪等 no-op) +
  COMPOSE_PROJECT_NAME 上書き。chdir は _dispatch_lifecycle で一括実施
  (down/login/logs は project_name 引数を持たないため per-handler では救えない)。
- 存在しない name はエラー + 候補一覧を提示。

tests:
- 新規 test_project_name_resolution.py: wrapper cd / argv strip / 曖昧性回避 /
  Python 解決 / 候補提示を検証。
- PR1 の未実装 warning 系テストを新挙動 (解決 → handler / 解決失敗 → abort) へ更新。
- build dispatch の文字列アサートを _DEVBASE_ARGS 形式へ追従。

全 359 テスト pass。

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

Author: takemi-ohama

bin/devbase

@@ -180,21 +180,76 @@ resolve_command() {
     fi
 }
 
+# ===================================================================
+# Project name resolution (PLAN06 Task 2)
+# ===================================================================
+# `devbase project <sub> <name>` および同義のトップレベルシノニム
+# `devbase <sub> <name>` の <name> が $DEVBASE_ROOT/projects/<name> に実在する
+# 場合、そのディレクトリへ cd し COMPOSE_PROJECT_NAME / env を再設定する。
+# これにより任意の CWD からプロジェクトを指定してコンテナ操作できる。
+#
+# 重要: `build` は shell 実装 (cmd_build) が CWD で動くため、この wrapper cd
+# だけが build の name 解決手段になる (PLAN06 方針 A の核心)。Python 側 chdir
+# フォールバックでは build を救えない。
+#
+# <name> 判定は projects/ 配下の実在性で行う。これにより `login <index>` /
+# `build <image>` / `scale <N>` の既存 positional と曖昧にならない: 実在する
+# プロジェクト名のときだけ name として解釈し cd + strip する。実在しなければ
+# 引数はそのまま下流 (Python パーサ) へ渡し、Python 側で index/image/scale
+# あるいは「存在しない name」エラーとして扱わせる。
+
+# name 候補を受け取り projects/ 配下に実在すれば cd + env 再設定して 0 を返す。
+maybe_cd_project() {
+    local name="${1:-}"
+    case "$name" in -*|"") return 1 ;; esac   # フラグ・空は name ではない
+    local target="${DEVBASE_ROOT}/projects/${name}"
+    [ -d "$target" ] || return 1
+    cd "$target" || return 1
+    export COMPOSE_PROJECT_NAME="$name"
+    # cd 後にプロジェクトの env を再 source (初期 CWD で読んだ値を上書き)。
+    # project の .env (dotfile) は CRLF / 特殊文字対策で意図的に source しない
+    # 方針を踏襲する (冒頭コメント参照)。
+    [ -f "env" ] && set -a && source ./env && set +a
+    return 0
+}
+
 # Resolve the command (skip flags like --version, -V, -h, --help)
 _resolved_cmd="${1:-}"
 case "$_resolved_cmd" in
     --*|-*|"") ;;  # flags and empty: don't resolve
     *) _resolved_cmd="$(resolve_command "$_resolved_cmd")" ;;
 esac
 
+# name 解決: 実在するプロジェクト名を検出したら cd し、その token を argv から
+# 取り除いた配列 _DEVBASE_ARGS を組み立てる。検出しなければ素通し。
+# name 候補の位置:
+#   project|container <sub> <name>  -> $3 (サブコマンドは保持)
+#   トップレベルシノニム <sub> <name> -> $2
+_DEVBASE_ARGS=("${@:2}")
+_NAME_RESOLVABLE_SHORTCUTS=" up down ps scale login build "
+case "$_resolved_cmd" in
+    project|container)
+        if maybe_cd_project "${3:-}"; then
+            _DEVBASE_ARGS=("${2:-}" "${@:4}")
+        fi
+        ;;
+    *)
+        if [[ "$_NAME_RESOLVABLE_SHORTCUTS" == *" $_resolved_cmd "* ]]; then
+            if maybe_cd_project "${2:-}"; then
+                _DEVBASE_ARGS=("${@:3}")
+            fi
+        fi
+        ;;
+esac
+
 case "$_resolved_cmd" in
     # Python-implemented commands
     --version|-V)
         run_python "$@" ;;
     init|status|shell-rc|project|container|ct|env|plugin|pl|snapshot|ss|up|down|login|ps|scale)
-        run_python "${_resolved_cmd}" "${@:2}" ;;
+        run_python "${_resolved_cmd}" "${_DEVBASE_ARGS[@]}" ;;
     # Shell-implemented commands
-    build)  shift; cmd_build "$@" ;;
+    build)  cmd_build "${_DEVBASE_ARGS[@]}" ;;
     # Help and unknown
     -h|--help|help|"") run_python "--help" ;;
     *)      echo "Error: unknown command '$1'" >&2; exit 1 ;;

lib/devbase/commands/container.py

@@ -81,33 +81,88 @@ def _run_pre_up_hook() -> bool:
 # ディスパッチャ
 # ---------------------------------------------------------------------------
 
+def _projects_dir() -> Optional[Path]:
+    """$DEVBASE_ROOT/projects を返す。DEVBASE_ROOT 未設定なら None。"""
+    root = os.environ.get('DEVBASE_ROOT')
+    if not root:
+        return None
+    return Path(root) / 'projects'
+
+
+def _report_unknown_project(name: str, projects_dir: Path) -> None:
+    """存在しない project name に対するエラーと候補一覧を出力する。"""
+    logger.error("プロジェクト '%s' が見つかりません (%s 配下に存在しません)。",
+                 name, projects_dir)
+    try:
+        candidates = sorted(
+            p.name for p in projects_dir.iterdir()
+            if p.is_dir() or p.is_symlink()
+        )
+    except OSError:
+        candidates = []
+    if candidates:
+        logger.error("利用可能なプロジェクト: %s", ', '.join(candidates))
+
+
+def _resolve_project_name(project_name: str) -> bool:
+    """project name を $DEVBASE_ROOT/projects/<name> へ解決し chdir する。
+
+    通常は wrapper (bin/devbase) が起動前に cd 済みのため、ここは
+
+      - `python -m devbase.cli project up <name>` の直接起動
+      - wrapper を経ない経路 (`_ensure_env_files` 等)
+
+    に対する防御的フォールバックとして働く。wrapper が既に対象ディレクトリへ
+    cd 済みなら chdir は no-op になる (同一パス判定)。
+
+    Returns:
+        True:  解決成功 (または既に対象ディレクトリにいる)
+        False: DEVBASE_ROOT 未設定 / 対象が存在しない (呼び出し側で return 1)
+    """
+    projects_dir = _projects_dir()
+    if projects_dir is None:
+        logger.error("DEVBASE_ROOT が未設定のため project name '%s' を解決できません。",
+                     project_name)
+        return False
+
+    target = projects_dir / project_name
+    if not target.is_dir():
+        _report_unknown_project(project_name, projects_dir)
+        return False
+
+    try:
+        already_there = target.resolve() == Path.cwd().resolve()
+    except OSError:
+        already_there = False
+    if not already_there:
+        os.chdir(target)
+
+    # COMPOSE_PROJECT_NAME を name で上書き (wrapper が設定済みでも冪等)。
+    os.environ['COMPOSE_PROJECT_NAME'] = project_name
+    return True
+
+
 def _dispatch_lifecycle(args) -> int:
     """`project` / `container` 共有のサブコマンドディスパッチャ。
 
     `project <sub> [name]` の `name` を解決して project_name へ畳み込む。
     `container` 経路には `name` 属性が無いため従来通り None になる。
 
-    NOTE (PLAN06): name によるディレクトリ解決の本体は Task 2 (PR2) で wrapper の
-    cd + Python フォールバックとして実装する。PR1 では project_name 引数を取れる
-    up / scale にのみ name を伝播するが、その name も compose のプロジェクトラベル
-    (COMPOSE_PROJECT_NAME 相当) として使われるだけで、操作対象はあくまで CWD の
-    compose.yml である点に注意 (ディレクトリ解決は未実装)。
+    name 指定時は handler 呼び出し前に一括で `$DEVBASE_ROOT/projects/<name>` へ
+    chdir する (PLAN06 方針 A の Python 側フォールバック)。chdir を各 handler に
+    散らさずここで実施するのは、`cmd_down()` / `cmd_login()` / `cmd_logs()` 等が
+    project_name 引数を取らず、per-handler 実装では down/login/logs で名前解決が
+    効かなくなるため。build は wrapper の shell 実装で CWD 実行されるため、この
+    Python フォールバックの対象外 (name 属性も持たない)。
     """
     subcmd = getattr(args, 'subcommand', None)
     project_name = getattr(args, 'name', None) or getattr(args, 'project_name', None)
 
-    # PR1 では name によるディレクトリ解決は未実装で、どのサブコマンドも CWD の
-    # compose.yml に対して動作する。name を指定されたまま黙って CWD に作用すると
-    # 「指定したプロジェクトに対して操作できた」と誤解させるため、明示的に警告する
-    # (name → ディレクトリ解決は PR2 で実装)。up / scale は name をプロジェクト
-    # ラベルには反映するが、対象ディレクトリは依然 CWD であるため同様に警告する。
+    # name 指定時はディレクトリを解決して chdir する。解決失敗 (DEVBASE_ROOT 未設定
+    # / 存在しない name) は候補提示の上でエラー終了する。
     if project_name:
-        logger.warning(
-            "project name '%s' によるディレクトリ解決は未実装です。"
-            "カレントディレクトリの compose に対して実行します "
-            "(name 指定は将来のリリースで対応予定)。",
-            project_name,
-        )
+        if not _resolve_project_name(project_name):
+            return 1
 
     handlers = {
         'up':    lambda: cmd_up(project_name=project_name,

tests/cli/test_build_shortcut_consistency.py

@@ -56,8 +56,9 @@ def test_wrapper_routes_build_to_shell_not_python():
     # bin/devbase の dispatch で build は shell の cmd_build に委譲され、
     # Python 用 run_python の case には含まれないことを確認する。
     wrapper = (Path(__file__).resolve().parents[2] / "bin" / "devbase").read_text()
-    # build は専用の shell ケースへ
-    assert "build)  shift; cmd_build" in wrapper or "build) shift; cmd_build" in wrapper
+    # build は専用の shell ケースへ (PLAN06 Task 2 で name strip 後の _DEVBASE_ARGS
+    # を渡す形に変更。引数は wrapper 側の name 解決で既にコマンド/名を除去済み)。
+    assert "build)  cmd_build" in wrapper or "build) cmd_build" in wrapper
     # run_python に委譲する case 行に build が紛れ込んでいないこと
     for line in wrapper.splitlines():
         if "run_python" in line and "${_resolved_cmd}" in line:

tests/cli/test_project_dispatch.py

@@ -120,6 +120,8 @@ def test_lifecycle_passes_name_to_cmd_up(monkeypatch):
     """`project up <name>` の name は project_name として up に伝播する。"""
     from devbase.commands import container
     captured = {}
+    # name 解決 (chdir) は別テストで検証するためここでは no-op 化し、伝播のみ見る。
+    monkeypatch.setattr(container, '_resolve_project_name', lambda name: True)
     monkeypatch.setattr(container, 'cmd_up',
                         lambda project_name=None, scale=None:
                         captured.update(project_name=project_name) or 0)
@@ -141,42 +143,49 @@ def test_lifecycle_container_path_has_no_name(monkeypatch):
 
 
 # ---------------------------------------------------------------------------
-# _dispatch_lifecycle: name 未実装 warning
-# (PR1 では up/scale も含め全サブコマンドが CWD の compose に作用するため、
-#  name 指定時はサブコマンドに関わらず警告する)
+# _dispatch_lifecycle: name 解決 (PR2 で wrapper cd の Python フォールバックを実装)
+# name 指定時は handler 呼び出し前に _resolve_project_name で chdir する。
+# 解決失敗時は handler を呼ばずに 1 を返す。詳細な解決ロジックは
+# test_project_name_resolution.py を参照。
 # ---------------------------------------------------------------------------
 
-def test_lifecycle_warns_for_up_with_name(monkeypatch, caplog):
-    """`project up <name>` は name 指定時に未実装 warning を出す。"""
+def test_lifecycle_resolves_name_before_handler(monkeypatch):
+    """name 指定時は handler 前に _resolve_project_name を呼ぶ。"""
     from devbase.commands import container
-    monkeypatch.setattr(container, 'cmd_up', lambda project_name=None, scale=None: 0)
+    order = []
+    monkeypatch.setattr(container, '_resolve_project_name',
+                        lambda name: order.append(('resolve', name)) or True)
+    monkeypatch.setattr(container, 'cmd_up',
+                        lambda project_name=None, scale=None:
+                        order.append(('up', project_name)) or 0)
     args = _args(subcommand='up', name='carmo', scale=None)
-    with caplog.at_level(logging.WARNING, logger='devbase.commands.container'):
-        assert container._dispatch_lifecycle(args) == 0
-    assert any('未実装' in r.message for r in caplog.records), \
-        'up でも name 指定時は警告しなければならない'
+    assert container._dispatch_lifecycle(args) == 0
+    assert order == [('resolve', 'carmo'), ('up', 'carmo')]
 
 
-def test_lifecycle_warns_for_scale_with_name(monkeypatch, caplog):
-    """`project scale <name> N` も name 指定時に未実装 warning を出す。"""
+def test_lifecycle_aborts_when_name_unresolved(monkeypatch):
+    """name 解決に失敗したら handler を呼ばず 1 を返す。"""
     from devbase.commands import container
-    monkeypatch.setattr(container, 'cmd_scale',
-                        lambda new_scale=None, project_name=None: 0)
-    args = _args(subcommand='scale', name='carmo', new_scale=3)
-    with caplog.at_level(logging.WARNING, logger='devbase.commands.container'):
-        assert container._dispatch_lifecycle(args) == 0
-    assert any('未実装' in r.message for r in caplog.records), \
-        'scale でも name 指定時は警告しなければならない'
+    called = []
+    monkeypatch.setattr(container, '_resolve_project_name', lambda name: False)
+    monkeypatch.setattr(container, 'cmd_up',
+                        lambda project_name=None, scale=None:
+                        called.append('up') or 0)
+    args = _args(subcommand='up', name='bogus', scale=None)
+    assert container._dispatch_lifecycle(args) == 1
+    assert called == [], '解決失敗時は handler を呼んではならない'
 
 
-def test_lifecycle_no_warning_without_name(monkeypatch, caplog):
-    """name 未指定なら警告を出さない。"""
+def test_lifecycle_no_resolution_without_name(monkeypatch):
+    """name 未指定なら _resolve_project_name を呼ばない。"""
     from devbase.commands import container
+    resolved = []
+    monkeypatch.setattr(container, '_resolve_project_name',
+                        lambda name: resolved.append(name) or True)
     monkeypatch.setattr(container, 'cmd_up', lambda project_name=None, scale=None: 0)
     args = _args(subcommand='up', scale=None)  # name 属性なし
-    with caplog.at_level(logging.WARNING, logger='devbase.commands.container'):
-        assert container._dispatch_lifecycle(args) == 0
-    assert not any('未実装' in r.message for r in caplog.records)
+    assert container._dispatch_lifecycle(args) == 0
+    assert resolved == []
 
 
 # ---------------------------------------------------------------------------
@@ -293,6 +302,7 @@ def test_shortcut_up_propagates_name_through_dispatch(monkeypatch):
     """`devbase up <name>` の name がショートカット経由で cmd_up まで伝播する。"""
     from devbase.commands import container
     captured = {}
+    monkeypatch.setattr(container, '_resolve_project_name', lambda name: True)
     monkeypatch.setattr(container, 'cmd_up',
                         lambda project_name=None, scale=None:
                         captured.update(project_name=project_name) or 0)
@@ -306,6 +316,7 @@ def test_shortcut_scale_propagates_name_through_dispatch(monkeypatch):
     """`devbase scale <name> N` の name がショートカット経由で cmd_scale まで伝播する。"""
     from devbase.commands import container
     captured = {}
+    monkeypatch.setattr(container, '_resolve_project_name', lambda name: True)
     monkeypatch.setattr(container, 'cmd_scale',
                         lambda new_scale=None, project_name=None:
                         captured.update(project_name=project_name, new_scale=new_scale) or 0)