feat(plugin): 既存 plugins/ → repos/ マイグレーション (PLAN04 PR2)

docs/user/cli-reference.md

@@ -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`
 
 プラグインリポジトリを登録します。

lib/devbase/cli.py

@@ -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')

lib/devbase/commands/plugin.py

@@ -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)

lib/devbase/plugin/installer.py

@@ -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()