devbasex
diff --git a/‎docs/user/cli-reference.md‎
Lines changed: 18 additions & 0 deletions b/‎docs/user/cli-reference.md‎
Lines changed: 18 additions & 0 deletions
diff --git a/‎lib/devbase/cli.py‎
Lines changed: 4 additions & 1 deletion b/‎lib/devbase/cli.py‎
Lines changed: 4 additions & 1 deletion
diff --git a/‎lib/devbase/commands/plugin.py‎
Lines changed: 32 additions & 0 deletions b/‎lib/devbase/commands/plugin.py‎
Lines changed: 32 additions & 0 deletions
diff --git a/‎lib/devbase/plugin/installer.py‎
Lines changed: 28 additions & 0 deletions b/‎lib/devbase/plugin/installer.py‎
Lines changed: 28 additions & 0 deletions
@@ -404,6 +404,24 @@ devbase plugin info <name>
 devbase plugin sync
 ```
 
+### `devbase plugin migrate`
+
+旧形式 (`plugins/<name>` へのコピー) でインストールされたプラグインを、`repos/` 配下の永続クローンへ移行します。`install` / `update` 実行時にも自動で呼び出されるため、通常は手動実行不要です。
+
+```
+devbase plugin migrate
+```
+
+移行の挙動:
+
+| 状況 | 動作 |
+|---|---|
+| コピーがクローンと一致 | 旧コピーを削除し `repos/` へ移行 (migrated) |
+| コピーにローカル変更あり | 旧コピーを `plugins/<name>.bak` として保全 (preserved、手動で reconcile) |
+| 移行できない (ソース未登録 等) | スキップしてエラーを表示 (skipped) |
+
+`--link` でインストールしたプラグインは移行対象外です。
+
 ### `devbase plugin repo add`
 
 プラグインリポジトリを登録します。
 
@@ -37,7 +37,7 @@
 SUBCMD_MAP = {
     ('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'],
+    ('plugin', 'pl'):    ['list', 'install', 'uninstall', 'update', 'info', 'sync', 'repo', 'migrate'],
     ('snapshot', 'ss'):  ['create', 'list', 'restore', 'copy', 'delete', 'rotate'],
 }
 
@@ -234,6 +234,9 @@ def _add_plugin_parser(subparsers):
 
     pl_sub.add_parser('sync', help='Resync project symlinks')
 
+    pl_sub.add_parser('migrate',
+                      help='Migrate legacy plugins/ installs to repos/ clones')
+
     # Plugin repo sub-subcommands
     pl_repo = pl_sub.add_parser('repo', help='Manage plugin repositories')
     pl_repo_sub = pl_repo.add_subparsers(dest='repo_command')
 
@@ -9,6 +9,7 @@
 from devbase.plugin.updater import update_plugin
 from devbase.plugin.info import show_plugin_info, show_available_plugins
 from devbase.plugin.syncer import sync_projects
+from devbase.plugin.migrator import migrate
 from devbase.plugin.repo_manager import (
     add_repository,
     remove_repository,
@@ -34,6 +35,7 @@ def cmd_plugin(devbase_root: Path, args) -> int:
         'update':    lambda: cmd_plugin_update(devbase_root, getattr(args, 'name', None)),
         'info':      lambda: cmd_plugin_info(devbase_root, getattr(args, 'name', '')),
         'sync':      lambda: cmd_sync(devbase_root),
+        'migrate':   lambda: cmd_plugin_migrate(devbase_root),
         'repo':      lambda: cmd_repo(devbase_root, args),
     }
 
@@ -138,6 +140,36 @@ def cmd_sync(devbase_root: Path) -> int:
     return 0
 
 
+def cmd_plugin_migrate(devbase_root: Path) -> int:
+    """Migrate legacy plugins/ copy installs to repos/ persistent clones"""
+    registry = PluginRegistry(devbase_root)
+    try:
+        result = migrate(registry)
+    except DevbaseError as e:
+        logger.error("%s", e)
+        return 1
+
+    if not (result.migrated or result.preserved or result.skipped):
+        logger.info("No legacy plugins/ installs to migrate.")
+        return 0
+
+    if result.migrated:
+        logger.info("Migrated %d plugin(s) to repos/: %s",
+                    len(result.migrated), ", ".join(result.migrated))
+    if result.preserved:
+        logger.warning(
+            "Preserved %d plugin(s) with local changes as plugins/<name>.bak "
+            "(reconcile manually): %s",
+            len(result.preserved), ", ".join(result.preserved))
+    if result.skipped:
+        logger.warning("Could not migrate %d plugin(s): %s",
+                       len(result.skipped), ", ".join(result.skipped))
+        for err in result.errors:
+            logger.warning("  %s", err)
+        return 1
+    return 0
+
+
 def cmd_repo(devbase_root: Path, args) -> int:
     """Dispatch repo subcommands"""
     registry = PluginRegistry(devbase_root)
 
@@ -81,6 +81,32 @@ def resolve_repo_url(repo: str) -> str:
     return f"https://github.com/{repo}.git"
 
 
+def _auto_migrate(registry: PluginRegistry) -> None:
+    """Migrate any legacy plugins/ copy installs to repos/ before proceeding.
+
+    Triggered on the first install/update after upgrading to repos/-based
+    plugin management so users do not have to run `devbase plugin migrate`
+    manually.  No-op when nothing legacy remains.
+    """
+    from .migrator import migrate, needs_migration
+    if not needs_migration(registry):
+        return
+    logger.info("Legacy plugins/ installs detected — migrating to repos/...")
+    result = migrate(registry)
+    if result.migrated:
+        logger.info("  Migrated: %s", ", ".join(result.migrated))
+    # preserved/skipped recur on every install/update until the user
+    # reconciles, so avoid re-emitting a loud per-plugin WARNING each time:
+    # surface a single concise hint pointing at the explicit command, which
+    # prints the full per-plugin detail when run.
+    if result.preserved or result.skipped:
+        pending = len(result.preserved) + len(result.skipped)
+        logger.info(
+            "  %d plugin(s) still need attention — run 'devbase plugin migrate' "
+            "for details.", pending,
+        )
+
+
 def install_plugin(
     registry: PluginRegistry,
     source_str: str,
@@ -91,6 +117,8 @@ def install_plugin(
 
     Raises PluginError on failure.
     """
+    _auto_migrate(registry)
+
     source = PluginSource.parse(source_str, link=link)
     plugins_dir = registry.get_plugins_dir()