feat: PLAN06-3 project list 一覧表示 + --interactive 選択起動

`devbase project list` / トップレベルシノニム `devbase list` を新設し、
$DEVBASE_ROOT/projects/ 配下を NAME / PLUGIN / STATUS で一覧表示する。

- lib/devbase/commands/project.py (新規):
  - _resolve_plugin_name: symlink 先から plugin 名を解決。PLAN04 の同名衝突
    suffix (carmo.takemi) はリンク名のみに付きリンク先 dir は素の <proj> の
    ままなので、リンク先を辿ることで suffix 有無に関わらず正しく解決する。
  - list_projects: projects/ 配下 (symlink/実dir/broken symlink) を列挙。
    status は status._container_status_for を共有 (取得不能は unknown)。
  - cmd_project_list: 整列テーブル表示 / --interactive で番号入力選択 →
    project up 起動 (新規依存を足さず stdlib input、非TTY は EOFError graceful)。
- lib/devbase/commands/status.py:
  - per-entry の _container_status_for を抽出し project list と共有
    (cmd_status の挙動は不変)。
- lib/devbase/cli.py:
  - project list サブコマンド (--interactive/-i) + トップレベル list シノニム
  - SUBCMD_MAP / _expand_argv / dispatch に list を同期 (DEVBASE_ROOT 必須)
- bin/devbase:
  - resolve_command 候補 + dispatch case に list を追加 (name 解決対象外)
- tests: test_project_list.py 新規 (25件) + wrapper dispatch に list 経路 4件

pytest: 395 passed (baseline 366 + 29)

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

Author: takemi-ohama

bin/devbase

@@ -168,7 +168,7 @@ run_python() {
 # Resolve abbreviated command to full command name via unique prefix matching
 resolve_command() {
     local input="$1"
-    local commands="init status shell-rc project container ct env plugin pl snapshot ss up down login build ps scale help"
+    local commands="init status shell-rc project container ct env plugin pl snapshot ss up down login build ps scale list help"
     local matches=()
     for cmd in $commands; do
         [[ "$cmd" == "$input"* ]] && matches+=("$cmd")
@@ -279,7 +279,7 @@ 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)
+    init|status|shell-rc|project|container|ct|env|plugin|pl|snapshot|ss|up|down|login|ps|scale|list)
         run_python "${_resolved_cmd}" "${_DEVBASE_ARGS[@]}" ;;
     # Shell-implemented commands
     build)  cmd_build "${_DEVBASE_ARGS[@]}" ;;

lib/devbase/cli.py

@@ -45,7 +45,7 @@
 
 # Subcommand map for prefix resolution: {(aliases...): [subcmds]}
 SUBCMD_MAP = {
-    ('project',):        ['up', 'down', 'ps', 'login', 'logs', 'scale', 'build'],
+    ('project',):        ['up', 'down', 'ps', 'login', 'logs', 'scale', 'build', 'list'],
     ('container', 'ct'): ['up', 'down', 'ps', 'login', 'logs', 'scale', 'build'],
     ('env',):            ['init', 'sync', 'list', 'set', 'get', 'delete', 'edit', 'project', 'export', 'import'],
     ('plugin', 'pl'):    ['list', 'install', 'uninstall', 'update', 'info', 'sync', 'repo', 'migrate'],
@@ -167,6 +167,20 @@ def _add_project_parser(subparsers):
 
     _add_build_subparser(pj_sub)
 
+    # `list` は lifecycle ではなく一覧表示 (commands/project.py)。name positional は
+    # 取らない (wrapper の _PROJECT_NAME_SUBCOMMANDS にも含めない)。
+    _add_list_subparser(pj_sub)
+
+
+def _add_list_subparser(sub):
+    """`list` サブコマンドを登録する (project list / top-level list 共通)。
+
+    NAME / PLUGIN / STATUS の一覧表示。`--interactive` で選択 → `project up` 起動。
+    """
+    p = sub.add_parser('list', help='List projects (NAME / PLUGIN / STATUS)')
+    p.add_argument('--interactive', '-i', action='store_true',
+                   help='Select a project interactively and start it')
+
 
 def _add_env_parser(subparsers):
     """Env group parser"""
@@ -396,6 +410,11 @@ def _add_shortcuts(subparsers):
     scale_sc.add_argument('name', nargs='?', default=None, help='Project name')
     scale_sc.add_argument('new_scale', type=int, help='New number of containers')
 
+    # `list` は `project list` のトップレベルシノニム。lifecycle ではなく一覧表示
+    # のため SHORTCUTS (project lifecycle へ写像) ではなく _dispatch で個別に
+    # cmd_project_list へ振り分ける。
+    _add_list_subparser(subparsers)
+
 
 def _create_parser():
     """Create command line parser"""
@@ -477,7 +496,7 @@ def _expand_argv():
     # bin/devbase が build を shell 実装に委譲するため Python 側には top-level
     # build parser が無い。project build / container build は引き続き利用可能。
     commands = ['init', 'status', 'shell-rc', 'project', 'container', 'ct', 'env', 'plugin', 'pl',
-                'snapshot', 'ss', 'up', 'down', 'login', 'ps', 'scale', 'help']
+                'snapshot', 'ss', 'up', 'down', 'login', 'ps', 'scale', 'list', 'help']
     repo_subcmds = ['add', 'remove', 'list', 'refresh']
 
     if len(sys.argv) >= 2 and not sys.argv[1].startswith('-'):
@@ -533,9 +552,20 @@ def _dispatch(cmd, args):
 
     # --- Project group (推奨) ---
     if cmd == 'project':
+        # `project list` は lifecycle ではなく一覧表示 (DEVBASE_ROOT 必須)。
+        if getattr(args, 'subcommand', None) == 'list':
+            devbase_root = _require_devbase_root()
+            from devbase.commands.project import cmd_project_list
+            return cmd_project_list(devbase_root, args)
         from devbase.commands.container import cmd_project
         return cmd_project(args)
 
+    # --- Top-level `list` synonym for `project list` ---
+    if cmd == 'list':
+        devbase_root = _require_devbase_root()
+        from devbase.commands.project import cmd_project_list
+        return cmd_project_list(devbase_root, args)
+
     # --- Container group (非推奨: project へ委譲 + warning) ---
     if cmd == 'container':
         from devbase.commands.container import cmd_container

lib/devbase/commands/project.py

@@ -0,0 +1,155 @@
+"""Project listing commands (`devbase project list` / `devbase list`).
+
+PLAN06 Task 3。`$DEVBASE_ROOT/projects/` 配下を NAME / PLUGIN / STATUS で一覧表示し、
+``--interactive`` で選択 → `project up` 起動を行う。
+
+ライフサイクル操作 (up/down/ps/login/logs/scale/build) は引き続き
+``commands/container.py`` の共有ハンドラが担当し、本モジュールは listing と
+interactive 起動のみを担う。
+"""
+
+from __future__ import annotations
+
+import os
+from pathlib import Path
+
+from devbase.log import get_logger
+
+logger = get_logger(__name__)
+
+
+def _resolve_plugin_name(entry: Path) -> str | None:
+    """projects/ 配下の entry が属する plugin 名を解決する。
+
+    entry が symlink の場合、その **リンク先** (``../<plugin.path>/projects/<proj>``)
+    から plugin 名を解決する。PLAN04 の同名衝突 suffix (例 ``carmo.takemi--carmo``)
+    は **リンク名のみ** に付与され、リンク先 dir 名は素の ``<proj>`` のままであるため、
+    リンク名でなくリンク先を辿ることで suffix の有無に関わらず正しく解決できる。
+
+    plugin 名はリンク先パスの ``projects`` セグメント直前の要素:
+      - repos ベース: ``../repos/<owner>--<repo>/<plugin>/projects/<proj>`` → ``<plugin>``
+      - --link ベース: ``../plugins/<name>/projects/<proj>``               → ``<name>``
+
+    symlink でない実ディレクトリ (plugin に属さない) や解決不能な場合は ``None``。
+    リンク先実体が存在しない (broken symlink) 場合もリンクテキストから解決する。
+    """
+    if not entry.is_symlink():
+        return None
+    try:
+        target = os.readlink(entry)
+    except OSError:
+        return None
+
+    parts = Path(target).parts
+    # `projects` の最後の出現位置 (proj 名の直前) を採用する。
+    for i in range(len(parts) - 1, 0, -1):
+        if parts[i] == "projects":
+            return parts[i - 1]
+    return None
+
+
+def list_projects(projects_dir: Path) -> list[dict]:
+    """projects/ 配下のプロジェクトを NAME / PLUGIN / STATUS で列挙する。
+
+    各要素は ``{"name", "plugin", "status"}``。
+
+    - ``name``:   projects/ 内のエントリ名 (衝突 suffix 付きもそのまま)
+    - ``plugin``: ``_resolve_plugin_name`` の結果。実ディレクトリ / 解決不能は ``"-"``
+    - ``status``: ``status._container_status_for`` の状態文字列。
+                  compose.yml 無し / docker 不在等で取得できない場合は ``"unknown"``
+
+    symlink (broken 含む) と実ディレクトリの両方を対象とする。
+    """
+    # status ロジックは commands/status.py と共有する (PLAN06 リファクタで per-entry
+    # 関数 _container_status_for を分離済み)。import は循環回避のため関数内で行う。
+    from devbase.commands import status as status_mod
+
+    results: list[dict] = []
+    if not projects_dir.exists():
+        return results
+
+    for entry in sorted(projects_dir.iterdir()):
+        # broken symlink は is_dir() が False になるため symlink 自体も拾う。
+        if not (entry.is_symlink() or entry.is_dir()):
+            continue
+
+        plugin = _resolve_plugin_name(entry)
+
+        status = "unknown"
+        # is_dir() は symlink 先まで辿る。broken symlink は False → unknown のまま。
+        if entry.is_dir():
+            st = status_mod._container_status_for(entry)
+            if st is not None:
+                status = st["status"]
+
+        results.append({
+            "name": entry.name,
+            "plugin": plugin or "-",
+            "status": status,
+        })
+
+    return results
+
+
+def _print_table(rows: list[dict]) -> None:
+    """NAME / PLUGIN / STATUS の整列テーブルを標準出力に表示する。"""
+    name_w = max(len("NAME"), *(len(r["name"]) for r in rows))
+    plugin_w = max(len("PLUGIN"), *(len(r["plugin"]) for r in rows))
+    print(f"{'NAME':<{name_w}}  {'PLUGIN':<{plugin_w}}  STATUS")
+    for r in rows:
+        print(f"{r['name']:<{name_w}}  {r['plugin']:<{plugin_w}}  {r['status']}")
+
+
+def _interactive_select_and_up(rows: list[dict]) -> int:
+    """一覧から番号入力で 1 件選択し ``project up <name>`` を起動する。
+
+    外部依存 (simple_term_menu 等) を増やさず stdlib の ``input()`` で実装する。
+    非対話環境 (stdin が閉じている等で EOFError) ではエラー終了する。空入力は中止。
+    """
+    print("起動するプロジェクトを選択してください:")
+    for i, r in enumerate(rows, 1):
+        print(f"  [{i}] {r['name']}  ({r['plugin']}, {r['status']})")
+
+    try:
+        raw = input("番号 (空で中止): ").strip()
+    except EOFError:
+        logger.error("対話入力ができません (非 TTY 環境)。"
+                     "`devbase project up <name>` で直接指定してください。")
+        return 1
+
+    if not raw:
+        logger.info("中止しました。")
+        return 0
+
+    try:
+        idx = int(raw)
+    except ValueError:
+        logger.error("番号で指定してください: %r", raw)
+        return 1
+
+    if not (1 <= idx <= len(rows)):
+        logger.error("範囲外の番号です: %d (1〜%d)", idx, len(rows))
+        return 1
+
+    name = rows[idx - 1]["name"]
+    # name 解決 (chdir) + up は共有ハンドラ cmd_project に委譲する。
+    import types
+
+    from devbase.commands.container import cmd_project
+    return cmd_project(types.SimpleNamespace(subcommand="up", name=name, scale=None))
+
+
+def cmd_project_list(devbase_root: Path, args) -> int:
+    """`devbase project list [--interactive]` / `devbase list [--interactive]`。"""
+    projects_dir = Path(devbase_root) / "projects"
+    rows = list_projects(projects_dir)
+
+    if not rows:
+        logger.info("プロジェクトがありません (%s)。", projects_dir)
+        return 0
+
+    if getattr(args, "interactive", False):
+        return _interactive_select_and_up(rows)
+
+    _print_table(rows)
+    return 0

lib/devbase/commands/status.py

@@ -16,82 +16,84 @@
 logger = get_logger(__name__)
 
 
-def _get_container_status(projects_dir: Path) -> list[dict]:
-    """projects/ 配下の各プロジェクトのコンテナ状態を取得する"""
-    results = []
-    if not projects_dir.exists():
-        return results
-
-    for entry in sorted(projects_dir.iterdir()):
-        if not entry.is_dir():
-            continue
-        compose_file = entry / "compose.yml"
-        if not compose_file.exists():
-            continue
+def _container_status_for(entry: Path) -> dict | None:
+    """単一プロジェクトディレクトリのコンテナ状態を取得する。
+
+    `projects/<name>` (実ディレクトリ or plugin への symlink) を受け取り、
+    ``{"name", "status", "count"}`` を返す。対象外 (compose.yml が無い) や docker
+    コマンドが利用できない / タイムアウト / 異常終了の場合は ``None`` を返す。
+
+    PLAN06 で ``project list`` (commands/project.py) が同じ per-entry ロジックを
+    再利用するため、``_get_container_status`` のループ本体から分離した。挙動は
+    分離前と同一 (None を返す条件 = 旧実装で ``continue`` していた条件)。
+    """
+    compose_file = entry / "compose.yml"
+    if not compose_file.exists():
+        return None
 
-        try:
-            proc = subprocess.run(
-                ["docker", "compose", "ps", "--format", "json"],
-                cwd=str(entry),
-                capture_output=True,
-                text=True,
-                timeout=10,
-            )
-            if proc.returncode != 0:
+    try:
+        proc = subprocess.run(
+            ["docker", "compose", "ps", "--format", "json"],
+            cwd=str(entry),
+            capture_output=True,
+            text=True,
+            timeout=10,
+        )
+        if proc.returncode != 0:
+            return None
+
+        output = proc.stdout.strip()
+        if not output:
+            return {"name": entry.name, "status": "stopped", "count": 0}
+
+        # docker compose ps --format json は1行1JSONまたはJSON配列
+        containers = []
+        for line in output.splitlines():
+            line = line.strip()
+            if not line:
                 continue
-
-            output = proc.stdout.strip()
-            if not output:
-                results.append({
-                    "name": entry.name,
-                    "status": "stopped",
-                    "count": 0,
-                })
+            try:
+                parsed = json.loads(line)
+                if isinstance(parsed, list):
+                    containers.extend(parsed)
+                else:
+                    containers.append(parsed)
+            except json.JSONDecodeError:
                 continue
 
-            # docker compose ps --format json は1行1JSONまたはJSON配列
-            containers = []
-            for line in output.splitlines():
-                line = line.strip()
-                if not line:
-                    continue
-                try:
-                    parsed = json.loads(line)
-                    if isinstance(parsed, list):
-                        containers.extend(parsed)
-                    else:
-                        containers.append(parsed)
-                except json.JSONDecodeError:
-                    continue
-
-            if not containers:
-                results.append({
-                    "name": entry.name,
-                    "status": "stopped",
-                    "count": 0,
-                })
-                continue
+        if not containers:
+            return {"name": entry.name, "status": "stopped", "count": 0}
 
-            running = sum(
-                1 for c in containers
-                if c.get("State", "").lower() == "running"
-            )
-            total = len(containers)
+        running = sum(
+            1 for c in containers
+            if c.get("State", "").lower() == "running"
+        )
+        total = len(containers)
 
-            if running > 0:
-                status = f"running ({total} containers)"
-            else:
-                status = "stopped"
+        if running > 0:
+            status = f"running ({total} containers)"
+        else:
+            status = "stopped"
 
-            results.append({
-                "name": entry.name,
-                "status": status,
-                "count": total,
-            })
+        return {"name": entry.name, "status": status, "count": total}
 
-        except (subprocess.TimeoutExpired, OSError):
-            # dockerコマンドが利用できない、またはタイムアウト
+    except (subprocess.TimeoutExpired, OSError):
+        # dockerコマンドが利用できない、またはタイムアウト
+        return None
+
+
+def _get_container_status(projects_dir: Path) -> list[dict]:
+    """projects/ 配下の各プロジェクトのコンテナ状態を取得する"""
+    results = []
+    if not projects_dir.exists():
+        return results
+
+    for entry in sorted(projects_dir.iterdir()):
+        if not entry.is_dir():
             continue
+        status = _container_status_for(entry)
+        if status is not None:
+            results.append(status)
 
     return results