feat: PLAN06-1 project サブコマンド group + ハンドラ共有 + container 非推奨委譲

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 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 help"
  local matches=()
  for cmd in $commands; do
  [[ "$cmd" == "$input"* ]] && matches+=("$cmd")
@@ -191,7 +191,7 @@ case "$_resolved_cmd" in
  # Python-implemented commands
  --version|-V)
  run_python "$@" ;;
- init|status|shell-rc|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)
  run_python "${_resolved_cmd}" "${@:2}" ;;
  # Shell-implemented commands
  build) shift; cmd_build "$@" ;;

lib/devbase/cli.py

@@ -16,14 +16,19 @@
 
 logger = get_logger("devbase.cli")
 
-# Shortcuts: top-level command -> (group, subcommand)
+# Shortcuts: top-level command -> project subcommand
+# 委譲先は共有の cmd_project (PLAN06 で container は非推奨化)。
+# NOTE: `build` はここに含めない。配布入口 bin/devbase が `build` を shell の
+# cmd_build (devbase-base 依存検出 + 2 段ビルド + --no-cache 対応) に委譲しており、
+# Python の project build (単純な compose build) とは実装が異なるため。Python 側で
+# `build` を project build ショートカットとして広告すると wrapper の実経路と乖離する。
+# project build / container build サブコマンド自体は引き続き利用可能。
 SHORTCUTS = {
- 'up': ('container', 'up'),
- 'down': ('container', 'down'),
- 'login': ('container', 'login'),
- 'build': ('container', 'build'),
- 'ps': ('container', 'ps'),
- 'scale': ('container', 'scale'),
+ 'up': 'up',
+ 'down': 'down',
+ 'login': 'login',
+ 'ps': 'ps',
+ 'scale': 'scale',
 }
 
 # Group aliases
@@ -35,6 +40,7 @@
 
 # Subcommand map for prefix resolution: {(aliases...): [subcmds]}
 SUBCMD_MAP = {
+ ('project',): ['up', 'down', 'ps', 'login', 'logs', 'scale', 'build'],
  ('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'],
@@ -63,6 +69,30 @@ def _require_devbase_root() -> Path:
  return Path(root)
 
 
+def _add_login_subparser(sub):
+ """`login` サブコマンドを登録する (project / container 共通)。
+
+ 単一 positional `index` の意味は両グループで完全に同一。`[name]` を足すと
+ `project login 2` を name='2' と誤解釈して index=1 にログインしてしまう曖昧さ
+ (旧 `container login <index>` との非互換) が生じるため、project でも name を
+ 受け付けない。PR2 で project name 解決を導入する際は曖昧さのない `--name`
+ オプションで対応する方針。
+ """
+ p = sub.add_parser('login', help='Login to container')
+ p.add_argument('index', nargs='?', default='1', help='Container index')
+
+
+def _add_build_subparser(sub):
+ """`build` サブコマンドを登録する (project / container 共通)。
+
+ 単一 positional `image` の意味は両グループで同一。`[name]` を許すと
+ `project build web` が name='web', image=None となり image 指定ビルドが
+ compose build に化けるため、project でも name を受け付けない (login 参照)。
+ """
+ p = sub.add_parser('build', help='Build container images')
+ p.add_argument('image', nargs='?', default=None, help='Image name')
+
+
 def _add_container_parser(subparsers):
  """Container group parser"""
  ct_parser = subparsers.add_parser('container', aliases=['ct'],
@@ -72,8 +102,7 @@ def _add_container_parser(subparsers):
  ct_sub.add_parser('up', help='Start containers')
  ct_sub.add_parser('down', help='Stop and remove containers')
 
- ct_login = ct_sub.add_parser('login', help='Login to container')
- ct_login.add_argument('index', nargs='?', default='1', help='Container index')
+ _add_login_subparser(ct_sub)
 
  ct_ps = ct_sub.add_parser('ps', help='Show container status')
  ct_ps.add_argument('--all', '-a', action='store_true', help='Show all containers')
@@ -85,8 +114,49 @@ def _add_container_parser(subparsers):
  ct_scale = ct_sub.add_parser('scale', help='Scale containers online')
  ct_scale.add_argument('new_scale', type=int, help='New number of containers')
 
- ct_build = ct_sub.add_parser('build', help='Build container images')
- ct_build.add_argument('image', nargs='?', default=None, help='Image name')
+ _add_build_subparser(ct_sub)
+
+
+def _add_project_parser(subparsers):
+ """Project group parser (CWD 非依存のプロジェクト操作)。
+
+ `container` と同じ subcommand 群に、省略可能な `[name]` positional を加える。
+ name によるディレクトリ解決 / COMPOSE_PROJECT_NAME 上書きは PLAN06 Task 2 (PR2)
+ で wrapper の cd + Python フォールバックとして実装する。PR1 では parser 構造と
+ name のパースまでを用意する。
+
+ 例外: `login` / `build` は単一 positional が旧 `container` と同義 (index / image)
+ であり、`[name]` を足すと `project login 2` / `project build web` が誤解釈される
+ ため name を受け付けない。両者は project / container で定義が完全に一致するので
+ `_add_login_subparser` / `_add_build_subparser` に共通化している。
+ """
+ pj_parser = subparsers.add_parser('project', help='Manage projects (CWD-independent)')
+ pj_sub = pj_parser.add_subparsers(dest='subcommand')
+
+ pj_up = pj_sub.add_parser('up', help='Start containers')
+ pj_up.add_argument('name', nargs='?', default=None, help='Project name')
+
+ pj_down = pj_sub.add_parser('down', help='Stop and remove containers')
+ pj_down.add_argument('name', nargs='?', default=None, help='Project name')
+
+ _add_login_subparser(pj_sub)
+
+ pj_ps = pj_sub.add_parser('ps', help='Show container status')
+ pj_ps.add_argument('name', nargs='?', default=None, help='Project name')
+ pj_ps.add_argument('--all', '-a', action='store_true', help='Show all containers')
+
+ pj_logs = pj_sub.add_parser('logs', help='Show container logs')
+ pj_logs.add_argument('name', nargs='?', default=None, help='Project name')
+ pj_logs.add_argument('--follow', '-f', action='store_true', help='Follow log output')
+ pj_logs.add_argument('--tail', type=int, default=None, help='Number of lines')
+
+ # NOTE: `[name]` optional + `new_scale` 必須 int の順。値が 1 個なら new_scale に、
+ # 2 個なら (name, new_scale) に割り当てられ曖昧にならない (tests/cli 参照)。
+ pj_scale = pj_sub.add_parser('scale', help='Scale containers online')
+ pj_scale.add_argument('name', nargs='?', default=None, help='Project name')
+ pj_scale.add_argument('new_scale', type=int, help='New number of containers')
+
+ _add_build_subparser(pj_sub)
 
 
 def _add_env_parser(subparsers):
@@ -285,20 +355,36 @@ def _add_snapshot_parser(subparsers):
 
 
 def _add_shortcuts(subparsers):
- """Top-level shortcut parsers"""
+ """Top-level shortcut parsers.
+
+ 委譲先の `project` サブコマンドと引数体系を揃えるため、`up` / `down` / `ps` /
+ `scale` は `project <sub> [name]` と同じく省略可能な `[name]` positional を
+ 受け付ける (`devbase up carmo` ≡ `devbase project up carmo`)。受理した name は
+ _dispatch でショートカット経由でも下流 (cmd_project → _dispatch_lifecycle) へ
+ 伝播する。name の実解決は PLAN06 Task 2 (PR2) で実装するため、PR1 では up/scale
+ も含め name 指定時に未対応 warning を出す (container.py 参照)。
+
+ `login` は project login と同様に単一 positional を `index` として扱い `[name]`
+ は受け付けない (曖昧さ回避)。`build` はショートカットに含めない (SHORTCUTS の
+ 注記参照): bin/devbase が build を shell 実装 (cmd_build) に委譲するため、
+ Python 側でトップレベル build を広告すると実経路と乖離する。
+ """
  login_sc = subparsers.add_parser('login', help='Login to container')
  login_sc.add_argument('index', nargs='?', default='1', help='Container index')
 
- build_sc = subparsers.add_parser('build', help='Build container images')
- build_sc.add_argument('image', nargs='?', default=None, help='Image name')
-
  ps_sc = subparsers.add_parser('ps', help='Show container status')
+ ps_sc.add_argument('name', nargs='?', default=None, help='Project name')
  ps_sc.add_argument('--all', '-a', action='store_true', help='Show all containers')
 
- subparsers.add_parser('up', help='Start containers')
- subparsers.add_parser('down', help='Stop and remove containers')
+ up_sc = subparsers.add_parser('up', help='Start containers')
+ up_sc.add_argument('name', nargs='?', default=None, help='Project name')
+
+ down_sc = subparsers.add_parser('down', help='Stop and remove containers')
+ down_sc.add_argument('name', nargs='?', default=None, help='Project name')
 
+ # `[name]` optional + `new_scale` 必須 int の順 (project scale と同じ規則)。
  scale_sc = subparsers.add_parser('scale', help='Scale containers online')
+ scale_sc.add_argument('name', nargs='?', default=None, help='Project name')
  scale_sc.add_argument('new_scale', type=int, help='New number of containers')
 
 
@@ -310,12 +396,13 @@ def _create_parser():
  formatter_class=argparse.RawDescriptionHelpFormatter,
  epilog=(
  "Shortcuts:\n"
- " up container up\n"
- " down container down\n"
- " login container login\n"
- " build container build\n"
- " ps container ps\n"
- " scale container scale\n"
+ " up project up\n"
+ " down project down\n"
+ " login project login\n"
+ " ps project ps\n"
+ " scale project scale\n"
+ "\n"
+ "Note: `container` is deprecated; use `project` instead.\n"
  )
  )
 
@@ -342,6 +429,7 @@ def _create_parser():
  help='Print shell RC file path (e.g. source "$(devbase shell-rc)")'
  )
 
+ _add_project_parser(subparsers)
  _add_container_parser(subparsers)
  _add_env_parser(subparsers)
  _add_plugin_parser(subparsers)
@@ -371,8 +459,16 @@ def _resolve_prefix(input_cmd, candidates, preferences=None):
 
 def _expand_argv():
  """Expand abbreviated command/subcommand names in sys.argv in-place."""
- commands = ['init', 'status', 'shell-rc', 'container', 'ct', 'env', 'plugin', 'pl',
- 'snapshot', 'ss', 'up', 'down', 'login', 'build', 'ps', 'scale', 'help']
+ # この `commands` リストの並びは _create_parser のグループ登録順と一致させる:
+ # トップレベル → グループ (各 group の直後にその alias を隣接配置: container/ct,
+ # plugin/pl, snapshot/ss) → ショートカット。`project` (推奨) を `container`
+ # (非推奨) より前に置くのは登録順と揃えた意図的な並びで、prefix 解決は
+ # _resolve_prefix が一意一致のみ採用するため順序に機能的影響はない。
+ # `build` はトップレベルショートカットから除外 (SHORTCUTS の注記参照)。
+ # 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']
  repo_subcmds = ['add', 'remove', 'list', 'refresh']
 
  if len(sys.argv) >= 2 and not sys.argv[1].startswith('-'):
@@ -418,13 +514,20 @@ def _dispatch(cmd, args):
  # Resolve group aliases
  cmd = GROUP_ALIASES.get(cmd, cmd)
 
- # --- Shortcuts (top-level -> container subcommand) ---
+ # --- Shortcuts (top-level -> project subcommand) ---
+ # ショートカットは非推奨ではないため、warning を出す cmd_container ではなく
+ # 共有の cmd_project へ委譲する。
  if cmd in SHORTCUTS:
- args.subcommand = SHORTCUTS[cmd][1]
- from devbase.commands.container import cmd_container
- return cmd_container(args)
+ args.subcommand = SHORTCUTS[cmd]
+ from devbase.commands.container import cmd_project
+ return cmd_project(args)
+
+ # --- Project group (推奨) ---
+ if cmd == 'project':
+ from devbase.commands.container import cmd_project
+ return cmd_project(args)
 
- # --- Container group ---
+ # --- Container group (非推奨: project へ委譲 + warning) ---
  if cmd == 'container':
  from devbase.commands.container import cmd_container
  return cmd_container(args)

lib/devbase/commands/container.py

@@ -81,20 +81,44 @@ def _run_pre_up_hook() -> bool:
 # ディスパッチャ
 # ---------------------------------------------------------------------------
 
-def cmd_container(args) -> int:
- """サブコマンドディスパッチャ"""
+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 である点に注意 (ディレクトリ解決は未実装)。
+ """
  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 であるため同様に警告する。
+ if project_name:
+ logger.warning(
+ "project name '%s' によるディレクトリ解決は未実装です。"
+ "カレントディレクトリの compose に対して実行します "
+ "(name 指定は将来のリリースで対応予定)。",
+ project_name,
+ )
 
  handlers = {
- 'up': lambda: cmd_up(project_name=getattr(args, 'project_name', None),
+ 'up': lambda: cmd_up(project_name=project_name,
  scale=getattr(args, 'scale', None)),
  'down': lambda: cmd_down(),
  'login': lambda: cmd_login(index=getattr(args, 'index', '1')),
  'ps': lambda: cmd_ps(all_containers=getattr(args, 'all', False)),
  'logs': lambda: cmd_logs(follow=getattr(args, 'follow', False),
  tail=getattr(args, 'tail', None)),
  'scale': lambda: cmd_scale(new_scale=getattr(args, 'new_scale', None),
- project_name=getattr(args, 'project_name', None)),
+ project_name=project_name),
  'build': lambda: cmd_build(image=getattr(args, 'image', None)),
  }
 
@@ -106,6 +130,24 @@ def cmd_container(args) -> int:
  return 1
 
 
+def cmd_project(args) -> int:
+ """`devbase project <sub> [name]` ディスパッチャ (推奨エントリ)。"""
+ return _dispatch_lifecycle(args)
+
+
+def cmd_container(args) -> int:
+ """`devbase container <sub>` ディスパッチャ。
+
+ 非推奨: `devbase project` に移行してください (移行期間後に削除予定)。
+ 挙動は `cmd_project` と同一で、警告のみ追加する。
+ """
+ logger.warning(
+ "`devbase container` は非推奨です。`devbase project` を使用してください "
+ "(将来のリリースで削除されます)。"
+ )
+ return _dispatch_lifecycle(args)
+
+
 # ---------------------------------------------------------------------------
 # cmd_up (deploy.py の cmd_deploy を移植)
 # ---------------------------------------------------------------------------