@ai-setting/roy-agent-cli 1.7.15 → 1.7.17

package/dist/bin/roy-agent.js

@@ -1678,7 +1678,7 @@ __export(exports_repl_ink, {
 });
 import * as React2 from "react";
 import { Box as Box3, Text as Text4, Static, useApp, useInput as useInput2 } from "ink";
-import { createLogger as createLogger4 } from "@ai-setting/roy-agent-core";
+import { createLogger as createLogger5 } from "@ai-setting/roy-agent-core";
 import { jsxDEV as jsxDEV4 } from "react/jsx-dev-runtime";
 function nextMessageId() {
   _msgIdCounter += 1;
@@ -2033,7 +2033,7 @@ var init_repl_ink = __esm(() => {
       children: out
     }, undefined, false, undefined, this);
   });
-  inkLogger = createLogger4("repl-ink");
+  inkLogger = createLogger5("repl-ink");
   MultilineInput = React2.memo(React2.forwardRef(function MultilineInput2(props, ref) {
     const { onSubmit, placeholder, popupActive, onChange, onEscape } = props;
     const [buffer, setBuffer] = React2.useState("");
@@ -9461,7 +9461,7 @@ class CliQuietModeService {
 // package.json
 var package_default = {
   name: "@ai-setting/roy-agent-cli",
-  version: "1.7.15",
+  version: "1.7.17",
   type: "module",
   description: "CLI for roy-agent - Non-interactive command execution",
   main: "./dist/index.js",
@@ -10381,6 +10381,8 @@ __legacyDecorateClassTS([
 import { ContextError as ContextError2, ErrorCodes as ErrorCodes2, getTracerProvider as getTracerProvider2 } from "@ai-setting/roy-agent-core";
 
 // src/commands/shared/task-event-handler.ts
+import { createLogger as createLogger4 } from "@ai-setting/roy-agent-core";
+var logger4 = createLogger4("task-event-handler");
 var TASK_EVENTS = {
   CREATED: "task.created",
   UPDATED: "task.updated",
@@ -10407,14 +10409,14 @@ class TaskEventHandler {
         this.handleEvent(event);
       }
     });
-    console.log("[TaskEventHandler] Started");
+    logger4.info("[TaskEventHandler] Started");
     return () => this.stop();
   }
   stop() {
     if (this.unsubscribe) {
       this.unsubscribe();
       this.unsubscribe = null;
-      console.log("[TaskEventHandler] Stopped");
+      logger4.info("[TaskEventHandler] Stopped");
     }
   }
   handleEvent(event) {
@@ -10439,47 +10441,47 @@ class TaskEventHandler {
         this.logTaskDelegated(payload);
         break;
       default:
-        console.log(`[${event.type}]`, payload);
+        logger4.info(`[${event.type}]`, payload);
     }
   }
   logTaskCreated(payload) {
     const task = payload.task;
-    console.log(`\uD83D\uDCDD Task created: #${task.id} - ${task.title}`);
-    console.log(`   Status: ${task.status}, Priority: ${task.priority}, Type: ${task.type || "normal"}`);
+    logger4.info(`\uD83D\uDCDD Task created: #${task.id} - ${task.title}`);
+    logger4.info(`   Status: ${task.status}, Priority: ${task.priority}, Type: ${task.type || "normal"}`);
     if (task.project_path) {
-      console.log(`   Project: ${task.project_path}`);
+      logger4.info(`   Project: ${task.project_path}`);
     }
     if (task.context) {
-      console.log(`   Context: ${task.context}`);
+      logger4.info(`   Context: ${task.context}`);
     }
   }
   logTaskUpdated(payload) {
     const task = payload.task;
     const changes = payload.changes;
-    console.log(`✏️  Task updated: #${task.id} - ${task.title}`);
-    console.log(`   Status: ${task.status}, Priority: ${task.priority}, Type: ${task.type || "normal"}, Progress: ${task.progress}%`);
+    logger4.info(`✏️  Task updated: #${task.id} - ${task.title}`);
+    logger4.info(`   Status: ${task.status}, Priority: ${task.priority}, Type: ${task.type || "normal"}, Progress: ${task.progress}%`);
     if (changes) {
-      console.log(`   Changes: ${JSON.stringify(changes)}`);
+      logger4.info(`   Changes: ${JSON.stringify(changes)}`);
     }
   }
   logTaskCompleted(payload) {
     const task = payload.task;
-    console.log(`✅ Task completed: #${task.id} - ${task.title}`);
-    console.log(`   Progress: ${task.progress}%, Updated: ${task.updatedAt}`);
+    logger4.info(`✅ Task completed: #${task.id} - ${task.title}`);
+    logger4.info(`   Progress: ${task.progress}%, Updated: ${task.updatedAt}`);
   }
   logTaskDeleted(payload) {
-    console.log(`\uD83D\uDDD1️  Task deleted: #${payload.taskId}`);
+    logger4.info(`\uD83D\uDDD1️  Task deleted: #${payload.taskId}`);
   }
   logOperationAdded(payload) {
     const op = payload.operation;
-    console.log(`\uD83D\uDCCB Operation added to task #${payload.taskId}:`);
-    console.log(`   [${op.milestoneType}] ${op.milestoneTitle}`);
-    console.log(`   Session: ${op.sessionId}`);
+    logger4.info(`\uD83D\uDCCB Operation added to task #${payload.taskId}:`);
+    logger4.info(`   [${op.milestoneType}] ${op.milestoneTitle}`);
+    logger4.info(`   Session: ${op.sessionId}`);
   }
   logTaskDelegated(payload) {
-    console.log(`\uD83D\uDE80 Task delegated: #${payload.taskId}`);
-    console.log(`   Background: ${payload.backgroundTaskId}, Type: ${payload.subagentType}`);
-    console.log(`   ${payload.description}`);
+    logger4.info(`\uD83D\uDE80 Task delegated: #${payload.taskId}`);
+    logger4.info(`   Background: ${payload.backgroundTaskId}, Type: ${payload.subagentType}`);
+    logger4.info(`   ${payload.description}`);
   }
 }
 
@@ -10557,9 +10559,9 @@ async function runActShutdownCleanup(deps) {
     envService,
     shouldDisposeEnvService,
     output,
-    logger: logger4
+    logger: logger5
   } = deps;
-  const log = logger4 ?? {
+  const log = logger5 ?? {
     debug: () => {},
     warn: (msg) => console.warn(msg)
   };
@@ -11703,7 +11705,7 @@ function hasActiveDescendants(env, parentSessionId) {
 
 // src/commands/interactive.ts
 init_stream_output_service();
-import { createLogger as createLogger5, getTracerProvider as getTracerProvider3 } from "@ai-setting/roy-agent-core";
+import { createLogger as createLogger6, getTracerProvider as getTracerProvider3 } from "@ai-setting/roy-agent-core";
 
 // src/commands/input-handler.ts
 class InputHandler {
@@ -12028,7 +12030,7 @@ async function shutdownInteractiveSteps(deps) {
     envService,
     shouldDisposeEnvService,
     output,
-    logger: logger4,
+    logger: logger5,
     console: consoleLike
   } = deps;
   const log = (msg) => consoleLike?.log?.(msg) ?? console.log(msg);
@@ -12041,7 +12043,7 @@ async function shutdownInteractiveSteps(deps) {
       await memoryPluginDispose();
       log("\uD83D\uDCBE 记忆已保存完毕");
     } catch (err) {
-      logger4.warn(`[Shutdown] MemoryPlugin dispose failed: ${err}`);
+      logger5.warn(`[Shutdown] MemoryPlugin dispose failed: ${err}`);
       output.warn(`⚠️ 记忆保存失败: ${err}`);
     }
   }
@@ -12049,25 +12051,25 @@ async function shutdownInteractiveSteps(deps) {
     try {
       await lspManagerDispose();
     } catch (err) {
-      logger4.warn(`[Shutdown] LSP Manager dispose failed: ${err}`);
+      logger5.warn(`[Shutdown] LSP Manager dispose failed: ${err}`);
     }
   }
   if (pluginAdapterDispose) {
     try {
       await pluginAdapterDispose();
     } catch (err) {
-      logger4.warn(`[Shutdown] PluginAdapter dispose failed: ${err}`);
+      logger5.warn(`[Shutdown] PluginAdapter dispose failed: ${err}`);
     }
   }
   try {
     eventHandler.stop();
   } catch (err) {
-    logger4.warn(`[Shutdown] EventHandler.stop failed: ${err}`);
+    logger5.warn(`[Shutdown] EventHandler.stop failed: ${err}`);
   }
   try {
     queryExecutor.dispose();
   } catch (err) {
-    logger4.warn(`[Shutdown] QueryExecutor.dispose failed: ${err}`);
+    logger5.warn(`[Shutdown] QueryExecutor.dispose failed: ${err}`);
   }
   try {
     const eventSourceComponent = env.getComponent("event-source");
@@ -12076,7 +12078,7 @@ async function shutdownInteractiveSteps(deps) {
       if (sources && sources.length > 0) {
         for (const source of sources) {
           const status = eventSourceComponent.getStatus?.(source.id);
-          logger4.debug(`[Shutdown] 检查事件源: ${source.id}, 状态: ${status}`);
+          logger5.debug(`[Shutdown] 检查事件源: ${source.id}, 状态: ${status}`);
           if (status !== "stopped" && status !== "created") {
             try {
               await eventSourceComponent.stopSource(source.id);
@@ -12089,20 +12091,20 @@ async function shutdownInteractiveSteps(deps) {
       }
     }
   } catch (err) {
-    logger4.warn(`[Shutdown] EventSource cleanup failed: ${err}`);
+    logger5.warn(`[Shutdown] EventSource cleanup failed: ${err}`);
   }
   if (shouldDisposeEnvService) {
     try {
       await envService.dispose();
     } catch (err) {
-      logger4.warn(`[Shutdown] envService.dispose failed: ${err}`);
+      logger5.warn(`[Shutdown] envService.dispose failed: ${err}`);
     }
   }
   try {
     await TempFileManager2.getInstance().cleanupAll();
-    logger4.debug("[Shutdown] TempFileManager cleaned up");
+    logger5.debug("[Shutdown] TempFileManager cleaned up");
   } catch (err) {
-    logger4.warn(`[Shutdown] TempFileManager cleanup failed: ${err}`);
+    logger5.warn(`[Shutdown] TempFileManager cleanup failed: ${err}`);
   }
 }
 
@@ -12292,7 +12294,7 @@ var COLOR_BY_STATUS = {
   busy: COLORS.accent
 };
 // src/commands/interactive.ts
-var logger4 = createLogger5("cli:interactive");
+var logger5 = createLogger6("cli:interactive");
 var USER_PROMPT = COLORS.accent("❯ ");
 
 class REPL {
@@ -12484,10 +12486,10 @@ ${COLORS.system("[正在中断...]")}`);
           const agentComponent = this.env.getComponent("agent");
           if (agentComponent?.abortAll) {
             agentComponent.abortAll();
-            logger4.debug("[/abort] AgentComponent.abortAll() called");
+            logger5.debug("[/abort] AgentComponent.abortAll() called");
           } else if (agentComponent?.abort) {
             agentComponent.abort("default");
-            logger4.debug("[/abort] AgentComponent.abort('default') called (fallback)");
+            logger5.debug("[/abort] AgentComponent.abort('default') called (fallback)");
           }
         }
         abortStream();
@@ -12582,7 +12584,7 @@ ${COLORS.system("[没有正在执行的请求]")}`);
               try {
                 await this.options.onAfterExecute(this.lastUsage);
               } catch (hookError) {
-                logger4.warn("onAfterExecute hook failed (ink path)", { error: String(hookError) });
+                logger5.warn("onAfterExecute hook failed (ink path)", { error: String(hookError) });
               }
             }
           } catch (err) {
@@ -12602,7 +12604,7 @@ ${COLORS.system("[没有正在执行的请求]")}`);
         await this.shutdown();
         resolve();
       }).catch(async (err) => {
-        logger4.error("ink REPL render failed", { error: String(err) });
+        logger5.error("ink REPL render failed", { error: String(err) });
         await this.shutdown();
         resolve();
       });
@@ -12659,7 +12661,7 @@ ${COLORS.system("[没有正在执行的请求]")}`);
       }
       if (key.name === "escape") {
         this.handleEscKey().catch((err) => {
-          logger4.warn(`[Esc] handleEscKey failed: ${err}`);
+          logger5.warn(`[Esc] handleEscKey failed: ${err}`);
         });
       }
     };
@@ -12854,7 +12856,7 @@ ${COLORS.system("[通知2] ❯ " + message.replace(/\n/g, `
         try {
           await this.options.onAfterExecute(this.lastUsage);
         } catch (hookError) {
-          logger4.warn("onAfterExecute hook failed", { error: String(hookError) });
+          logger5.warn("onAfterExecute hook failed", { error: String(hookError) });
         }
       }
     } catch (error) {
@@ -13017,12 +13019,12 @@ ${COLORS.error("❌ 执行失败: " + error)}
   }
   async handleEscKey() {
     if (this.isShuttingDown) {
-      logger4.debug("[Esc] handler entered (isShuttingDown=true) → early return");
+      logger5.debug("[Esc] handler entered (isShuttingDown=true) → early return");
       return;
     }
     const mainSessionIdEarly = this.options.sessionId;
     const hasActiveDescendant = mainSessionIdEarly ? hasActiveDescendants(this.env, mainSessionIdEarly) : false;
-    logger4.debug(`[Esc] handler entered: isExecuting=${this.isExecuting} hasActiveDescendant=${hasActiveDescendant} lastEscPressTime=${this.lastEscPressTime}`);
+    logger5.debug(`[Esc] handler entered: isExecuting=${this.isExecuting} hasActiveDescendant=${hasActiveDescendant} lastEscPressTime=${this.lastEscPressTime}`);
     const now = Date.now();
     const isExecuting = this.isExecuting;
     const canCascade = isExecuting || hasActiveDescendant;
@@ -13031,17 +13033,17 @@ ${COLORS.error("❌ 执行失败: " + error)}
       this.lastEscPressTime = now;
     }
     if (!canCascade) {
-      logger4.debug("[Esc] idle no-op: isExecuting=false, no active descendant");
+      logger5.debug("[Esc] idle no-op: isExecuting=false, no active descendant");
       return;
     }
     if (this.env) {
       const agentComponent = this.env.getComponent("agent");
       if (agentComponent?.abortAll) {
         agentComponent.abortAll();
-        logger4.debug("[Esc] AgentComponent.abortAll() called");
+        logger5.debug("[Esc] AgentComponent.abortAll() called");
       } else if (agentComponent?.abort) {
         agentComponent.abort("default");
-        logger4.debug("[Esc] AgentComponent.abort('default') called (fallback)");
+        logger5.debug("[Esc] AgentComponent.abort('default') called (fallback)");
       }
     }
     abortStream();
@@ -13049,7 +13051,7 @@ ${COLORS.error("❌ 执行失败: " + error)}
       try {
         this.inkApi.finishAssistantStream();
       } catch (err) {
-        logger4.warn("[Esc] finishAssistantStream failed", { error: String(err) });
+        logger5.warn("[Esc] finishAssistantStream failed", { error: String(err) });
       }
     }
     const mainSessionId = this.options.sessionId;
@@ -13062,9 +13064,9 @@ ${COLORS.error("❌ 执行失败: " + error)}
             timer = setTimeout(() => reject(new Error("cascade timeout 5s")), 5000);
           })
         ]);
-        logger4.info(`[Esc] cascade stop force=${result.force} tasks=${result.stoppedTaskIds.length} workflows=${result.stoppedWorkflowSessionIds.length} errors=${result.errors.length}`);
+        logger5.info(`[Esc] cascade stop force=${result.force} tasks=${result.stoppedTaskIds.length} workflows=${result.stoppedWorkflowSessionIds.length} errors=${result.errors.length}`);
       } catch (err) {
-        logger4.warn(`[Esc] cascade stop failed: ${err}`);
+        logger5.warn(`[Esc] cascade stop failed: ${err}`);
       } finally {
         if (timer !== undefined)
           clearTimeout(timer);
@@ -13446,7 +13448,7 @@ function createInteractiveCommand(externalEnvService) {
               envService,
               shouldDisposeEnvService,
               output,
-              logger: logger4,
+              logger: logger5,
               console
             });
           }
@@ -25493,24 +25495,106 @@ var LspCommand = {
 
 // src/commands/install/index.ts
 import { spawnSync } from "node:child_process";
-import { existsSync as existsSync4, readFileSync as readFileSync3, writeFileSync, mkdirSync, rmSync } from "node:fs";
-import { join as join5, resolve } from "node:path";
+import { existsSync as existsSync5, readFileSync as readFileSync4, writeFileSync, mkdirSync, rmSync as rmSync2 } from "node:fs";
+import { join as join6, resolve } from "node:path";
 import { homedir as homedir4 } from "node:os";
+
+// src/commands/install/cleanup-stale-plugin-copies.ts
+import { existsSync as existsSync4, readFileSync as readFileSync3, rmSync, cpSync } from "node:fs";
+import { join as join5 } from "node:path";
+import { homedir as nodeHomedir, tmpdir as nodeTmpdir } from "node:os";
+function cleanupStalePluginCopies(packageName, options) {
+  const HOME = options.homedir ?? nodeHomedir();
+  const paths = options.localNodeModulesPaths ?? [
+    join5(HOME, "node_modules"),
+    join5(HOME, ".roy-agent", "node_modules")
+  ];
+  const backupRoot = options.backupDir ?? nodeTmpdir();
+  const result = {
+    cleaned: [],
+    skipped: [],
+    backups: []
+  };
+  if (!options.globalVersion) {
+    for (const p of paths) {
+      const candidate = join5(p, packageName);
+      result.skipped.push({ path: candidate, reason: "no-global-version" });
+    }
+    return result;
+  }
+  for (const nmPath of paths) {
+    const localPkgDir = join5(nmPath, packageName);
+    const localPkgJson = join5(localPkgDir, "package.json");
+    if (!existsSync4(localPkgJson)) {
+      result.skipped.push({ path: localPkgDir, reason: "no-local-copy" });
+      continue;
+    }
+    let localVersion = null;
+    try {
+      const pkg = JSON.parse(readFileSync3(localPkgJson, "utf-8"));
+      localVersion = typeof pkg.version === "string" ? pkg.version : null;
+    } catch {
+      localVersion = null;
+    }
+    const shouldClean = localVersion === null || compareVersions(localVersion, options.globalVersion) < 0;
+    if (!shouldClean) {
+      result.skipped.push({ path: localPkgDir, reason: "local-equal-or-newer" });
+      continue;
+    }
+    let backupPath = null;
+    try {
+      const safeName = packageName.replace(/@/g, "").replace(/[^a-zA-Z0-9._/-]/g, "-");
+      const safeLocalVersion = (localVersion ?? "unknown").replace(/[^a-zA-Z0-9._-]/g, "-");
+      const timestamp = Date.now();
+      backupPath = join5(backupRoot, `${safeName}-${safeLocalVersion}-backup-${timestamp}`);
+      cpSync(localPkgDir, backupPath, { recursive: true });
+      result.backups.push({ originalPath: localPkgDir, backupPath });
+    } catch (err) {
+      backupPath = null;
+      console.warn(`⚠️  Failed to backup stale copy at '${localPkgDir}': ${err}`);
+    }
+    try {
+      rmSync(localPkgDir, { recursive: true, force: true });
+      result.cleaned.push(localPkgDir);
+    } catch (err) {
+      console.warn(`⚠️  Failed to remove stale copy at '${localPkgDir}': ${err}`);
+      result.skipped.push({ path: localPkgDir, reason: "cleanup-failed" });
+      if (backupPath) {
+        console.warn(`   ↪ Backup preserved at '${backupPath}' for manual recovery`);
+      }
+    }
+  }
+  return result;
+}
+function compareVersions(a, b) {
+  const pa = a.split(".").map((s) => Number.parseInt(s, 10));
+  const pb = b.split(".").map((s) => Number.parseInt(s, 10));
+  for (let i = 0;i < 3; i++) {
+    const na = Number.isFinite(pa[i]) ? pa[i] : 0;
+    const nb = Number.isFinite(pb[i]) ? pb[i] : 0;
+    const diff = na - nb;
+    if (diff !== 0)
+      return diff;
+  }
+  return 0;
+}
+
+// src/commands/install/index.ts
 function getConfigDir(scope) {
-  return scope === "global" ? join5(homedir4(), ".roy-agent") : join5(process.cwd(), ".roy");
+  return scope === "global" ? join6(homedir4(), ".roy-agent") : join6(process.cwd(), ".roy");
 }
 function detectDefaultScope() {
-  const projectDir = join5(process.cwd(), ".roy");
-  return existsSync4(projectDir) ? "project" : "global";
+  const projectDir = join6(process.cwd(), ".roy");
+  return existsSync5(projectDir) ? "project" : "global";
 }
 function getConfigPath(scope) {
-  return join5(getConfigDir(scope), "plugins.json");
+  return join6(getConfigDir(scope), "plugins.json");
 }
 function loadPlugins(scope) {
   const configPath = getConfigPath(scope);
   try {
-    if (existsSync4(configPath)) {
-      const raw = readFileSync3(configPath, "utf-8");
+    if (existsSync5(configPath)) {
+      const raw = readFileSync4(configPath, "utf-8");
       const config = JSON.parse(raw);
       return config.plugins ?? [];
     }
@@ -25520,7 +25604,7 @@ function loadPlugins(scope) {
 function savePlugins(plugins, scope) {
   const configDir = getConfigDir(scope);
   const configPath = getConfigPath(scope);
-  if (!existsSync4(configDir)) {
+  if (!existsSync5(configDir)) {
     mkdirSync(configDir, { recursive: true });
   }
   const config = { plugins };
@@ -25536,10 +25620,10 @@ function stripVersionSpec(packageName) {
 function readPackageInfo(packageName) {
   const bareName = packageName.startsWith("/") || packageName.startsWith(".") ? packageName : stripVersionSpec(packageName);
   if (packageName.startsWith("/") || packageName.startsWith(".")) {
-    const localPkgPath = join5(packageName, "package.json");
-    if (existsSync4(localPkgPath)) {
+    const localPkgPath = join6(packageName, "package.json");
+    if (existsSync5(localPkgPath)) {
       try {
-        const pkg = JSON.parse(readFileSync3(localPkgPath, "utf-8"));
+        const pkg = JSON.parse(readFileSync4(localPkgPath, "utf-8"));
         return {
           version: pkg.version ?? "0.0.0",
           name: pkg.name ?? packageName,
@@ -25551,19 +25635,19 @@ function readPackageInfo(packageName) {
     }
   }
   const searchPaths = [
-    join5(process.cwd(), "node_modules", bareName, "package.json"),
+    join6(process.cwd(), "node_modules", bareName, "package.json"),
     resolve(process.cwd(), "..", "node_modules", bareName, "package.json"),
-    join5(process.cwd(), ".roy", "plugins", bareName, "package.json"),
+    join6(process.cwd(), ".roy", "plugins", bareName, "package.json"),
     ...(() => {
       const globalRoot = getNpmGlobalRoot();
-      return globalRoot ? [join5(globalRoot, bareName, "package.json")] : [];
+      return globalRoot ? [join6(globalRoot, bareName, "package.json")] : [];
     })(),
-    join5(homedir4(), ".roy-agent", "node_modules", bareName, "package.json")
+    join6(homedir4(), ".roy-agent", "node_modules", bareName, "package.json")
   ];
   for (const pkgPath of searchPaths) {
     try {
-      if (existsSync4(pkgPath)) {
-        const pkg = JSON.parse(readFileSync3(pkgPath, "utf-8"));
+      if (existsSync5(pkgPath)) {
+        const pkg = JSON.parse(readFileSync4(pkgPath, "utf-8"));
         return {
           version: pkg.version ?? "0.0.0",
           name: pkg.name ?? bareName,
@@ -25585,19 +25669,6 @@ function getNpmGlobalRoot() {
   }
   return null;
 }
-function cleanupStaleCpCopy(packageName) {
-  const cpDir = join5(homedir4(), ".roy-agent", "node_modules", packageName);
-  if (!existsSync4(cpDir)) {
-    return false;
-  }
-  try {
-    rmSync(cpDir, { recursive: true, force: true });
-    return true;
-  } catch (err) {
-    console.warn(`⚠️  Failed to clean stale cp copy at '${cpDir}': ${err}`);
-    return false;
-  }
-}
 async function verifyInstalledVersion(packageName, declaredVersion) {
   const actual = readPackageInfo(packageName);
   if (!actual || !actual.version) {
@@ -25609,15 +25680,15 @@ async function verifyInstalledVersion(packageName, declaredVersion) {
   return { ok: true, actualVersion: actual.version };
 }
 function getPackageManagerCommand() {
-  if (existsSync4(join5(process.cwd(), "pnpm-lock.yaml"))) {
-    if (existsSync4(join5(process.cwd(), "pnpm-workspace.yaml"))) {
+  if (existsSync5(join6(process.cwd(), "pnpm-lock.yaml"))) {
+    if (existsSync5(join6(process.cwd(), "pnpm-workspace.yaml"))) {
       return "pnpm -w";
     }
     return "pnpm";
   }
-  if (existsSync4(join5(process.cwd(), "yarn.lock")))
+  if (existsSync5(join6(process.cwd(), "yarn.lock")))
     return "yarn";
-  if (existsSync4(join5(process.cwd(), "bun.lock")) || existsSync4(join5(process.cwd(), "bun.lockb")))
+  if (existsSync5(join6(process.cwd(), "bun.lock")) || existsSync5(join6(process.cwd(), "bun.lockb")))
     return "bun";
   return "npm";
 }
@@ -25656,14 +25727,14 @@ var InstallPackageCommand = {
         }
         resolvedName = info2.name;
         const srcDir = resolve(packageName);
-        if (!existsSync4(srcDir)) {
+        if (!existsSync5(srcDir)) {
           console.error(`
 ❌ Local path '${srcDir}' does not exist.
 `);
           process.exit(1);
         }
-        const pluginDir = join5(process.cwd(), ".roy", "plugins", resolvedName);
-        if (!existsSync4(pluginDir)) {
+        const pluginDir = join6(process.cwd(), ".roy", "plugins", resolvedName);
+        if (!existsSync5(pluginDir)) {
           mkdirSync(pluginDir, { recursive: true });
         }
         const result = spawnSync("cp", ["-r", `${srcDir}/.`, pluginDir], {
@@ -25698,12 +25769,12 @@ var InstallPackageCommand = {
           process.exit(1);
         }
         resolvedName = info2.name;
-        const pluginDir = join5(process.cwd(), ".roy", "plugins", resolvedName);
-        if (!existsSync4(pluginDir)) {
+        const pluginDir = join6(process.cwd(), ".roy", "plugins", resolvedName);
+        if (!existsSync5(pluginDir)) {
           mkdirSync(pluginDir, { recursive: true });
         }
-        const nmPath = join5(process.cwd(), "node_modules", packageName);
-        if (existsSync4(nmPath)) {
+        const nmPath = join6(process.cwd(), "node_modules", packageName);
+        if (existsSync5(nmPath)) {
           spawnSync("cp", ["-r", `${nmPath}/.`, pluginDir], { stdio: "inherit", shell: false });
         }
       }
@@ -25723,11 +25794,24 @@ var InstallPackageCommand = {
       }
       const tmpInfo = readPackageInfo(packageName);
       if (tmpInfo) {
-        const cleaned = cleanupStaleCpCopy(tmpInfo.name);
-        if (cleaned) {
+        const cleanupResult = cleanupStalePluginCopies(tmpInfo.name, {
+          globalVersion: tmpInfo.version,
+          homedir: homedir4()
+        });
+        if (cleanupResult.cleaned.length > 0) {
           console.log(`
-\uD83E\uDDF9 Cleaned stale cp copy: ~/.roy-agent/node_modules/${tmpInfo.name}
-`);
+\uD83E\uDDF9 Cleaned stale plugin copies:`);
+          for (const path9 of cleanupResult.cleaned) {
+            console.log(`   - ${path9}`);
+          }
+          if (cleanupResult.backups.length > 0) {
+            console.log(`
+\uD83D\uDCE6 Backups (for manual recovery):`);
+            for (const b of cleanupResult.backups) {
+              console.log(`   ${b.originalPath} → ${b.backupPath}`);
+            }
+          }
+          console.log();
         }
       }
     }
@@ -25852,8 +25936,8 @@ var InstallRemoveCommand = {
 \uD83D\uDDD1️  Removing plugin: ${plugin.packageName}@${plugin.version} (${scope})
 `);
     if (scope === "project") {
-      const pluginDir = join5(process.cwd(), ".roy", "plugins", plugin.packageName);
-      if (existsSync4(pluginDir)) {
+      const pluginDir = join6(process.cwd(), ".roy", "plugins", plugin.packageName);
+      if (existsSync5(pluginDir)) {
         spawnSync("rm", ["-rf", pluginDir], { stdio: "inherit", shell: false });
         console.log(`  Removed plugin directory: ${pluginDir}`);
       }
@@ -25868,8 +25952,8 @@ var InstallRemoveCommand = {
 `);
         process.exit(result.status ?? 1);
       }
-      const globalNm = join5(homedir4(), ".roy-agent", "node_modules", plugin.packageName);
-      if (existsSync4(globalNm)) {
+      const globalNm = join6(homedir4(), ".roy-agent", "node_modules", plugin.packageName);
+      if (existsSync5(globalNm)) {
         spawnSync("rm", ["-rf", globalNm], { stdio: "inherit", shell: false });
       }
     }

package/dist/index.js

@@ -1677,7 +1677,7 @@ __export(exports_repl_ink, {
 });
 import * as React2 from "react";
 import { Box as Box3, Text as Text4, Static, useApp, useInput as useInput2 } from "ink";
-import { createLogger as createLogger4 } from "@ai-setting/roy-agent-core";
+import { createLogger as createLogger5 } from "@ai-setting/roy-agent-core";
 import { jsxDEV as jsxDEV4 } from "react/jsx-dev-runtime";
 function nextMessageId() {
   _msgIdCounter += 1;
@@ -2032,7 +2032,7 @@ var init_repl_ink = __esm(() => {
       children: out
     }, undefined, false, undefined, this);
   });
-  inkLogger = createLogger4("repl-ink");
+  inkLogger = createLogger5("repl-ink");
   MultilineInput = React2.memo(React2.forwardRef(function MultilineInput2(props, ref) {
     const { onSubmit, placeholder, popupActive, onChange, onEscape } = props;
     const [buffer, setBuffer] = React2.useState("");
@@ -9460,7 +9460,7 @@ class CliQuietModeService {
 // package.json
 var package_default = {
   name: "@ai-setting/roy-agent-cli",
-  version: "1.7.15",
+  version: "1.7.17",
   type: "module",
   description: "CLI for roy-agent - Non-interactive command execution",
   main: "./dist/index.js",
@@ -10380,6 +10380,8 @@ __legacyDecorateClassTS([
 import { ContextError as ContextError2, ErrorCodes as ErrorCodes2, getTracerProvider as getTracerProvider2 } from "@ai-setting/roy-agent-core";
 
 // src/commands/shared/task-event-handler.ts
+import { createLogger as createLogger4 } from "@ai-setting/roy-agent-core";
+var logger4 = createLogger4("task-event-handler");
 var TASK_EVENTS = {
   CREATED: "task.created",
   UPDATED: "task.updated",
@@ -10406,14 +10408,14 @@ class TaskEventHandler {
         this.handleEvent(event);
       }
     });
-    console.log("[TaskEventHandler] Started");
+    logger4.info("[TaskEventHandler] Started");
     return () => this.stop();
   }
   stop() {
     if (this.unsubscribe) {
       this.unsubscribe();
       this.unsubscribe = null;
-      console.log("[TaskEventHandler] Stopped");
+      logger4.info("[TaskEventHandler] Stopped");
     }
   }
   handleEvent(event) {
@@ -10438,47 +10440,47 @@ class TaskEventHandler {
         this.logTaskDelegated(payload);
         break;
       default:
-        console.log(`[${event.type}]`, payload);
+        logger4.info(`[${event.type}]`, payload);
     }
   }
   logTaskCreated(payload) {
     const task = payload.task;
-    console.log(`\uD83D\uDCDD Task created: #${task.id} - ${task.title}`);
-    console.log(`   Status: ${task.status}, Priority: ${task.priority}, Type: ${task.type || "normal"}`);
+    logger4.info(`\uD83D\uDCDD Task created: #${task.id} - ${task.title}`);
+    logger4.info(`   Status: ${task.status}, Priority: ${task.priority}, Type: ${task.type || "normal"}`);
     if (task.project_path) {
-      console.log(`   Project: ${task.project_path}`);
+      logger4.info(`   Project: ${task.project_path}`);
     }
     if (task.context) {
-      console.log(`   Context: ${task.context}`);
+      logger4.info(`   Context: ${task.context}`);
     }
   }
   logTaskUpdated(payload) {
     const task = payload.task;
     const changes = payload.changes;
-    console.log(`✏️  Task updated: #${task.id} - ${task.title}`);
-    console.log(`   Status: ${task.status}, Priority: ${task.priority}, Type: ${task.type || "normal"}, Progress: ${task.progress}%`);
+    logger4.info(`✏️  Task updated: #${task.id} - ${task.title}`);
+    logger4.info(`   Status: ${task.status}, Priority: ${task.priority}, Type: ${task.type || "normal"}, Progress: ${task.progress}%`);
     if (changes) {
-      console.log(`   Changes: ${JSON.stringify(changes)}`);
+      logger4.info(`   Changes: ${JSON.stringify(changes)}`);
     }
   }
   logTaskCompleted(payload) {
     const task = payload.task;
-    console.log(`✅ Task completed: #${task.id} - ${task.title}`);
-    console.log(`   Progress: ${task.progress}%, Updated: ${task.updatedAt}`);
+    logger4.info(`✅ Task completed: #${task.id} - ${task.title}`);
+    logger4.info(`   Progress: ${task.progress}%, Updated: ${task.updatedAt}`);
   }
   logTaskDeleted(payload) {
-    console.log(`\uD83D\uDDD1️  Task deleted: #${payload.taskId}`);
+    logger4.info(`\uD83D\uDDD1️  Task deleted: #${payload.taskId}`);
   }
   logOperationAdded(payload) {
     const op = payload.operation;
-    console.log(`\uD83D\uDCCB Operation added to task #${payload.taskId}:`);
-    console.log(`   [${op.milestoneType}] ${op.milestoneTitle}`);
-    console.log(`   Session: ${op.sessionId}`);
+    logger4.info(`\uD83D\uDCCB Operation added to task #${payload.taskId}:`);
+    logger4.info(`   [${op.milestoneType}] ${op.milestoneTitle}`);
+    logger4.info(`   Session: ${op.sessionId}`);
   }
   logTaskDelegated(payload) {
-    console.log(`\uD83D\uDE80 Task delegated: #${payload.taskId}`);
-    console.log(`   Background: ${payload.backgroundTaskId}, Type: ${payload.subagentType}`);
-    console.log(`   ${payload.description}`);
+    logger4.info(`\uD83D\uDE80 Task delegated: #${payload.taskId}`);
+    logger4.info(`   Background: ${payload.backgroundTaskId}, Type: ${payload.subagentType}`);
+    logger4.info(`   ${payload.description}`);
   }
 }
 
@@ -10556,9 +10558,9 @@ async function runActShutdownCleanup(deps) {
     envService,
     shouldDisposeEnvService,
     output,
-    logger: logger4
+    logger: logger5
   } = deps;
-  const log = logger4 ?? {
+  const log = logger5 ?? {
     debug: () => {},
     warn: (msg) => console.warn(msg)
   };
@@ -11702,7 +11704,7 @@ function hasActiveDescendants(env, parentSessionId) {
 
 // src/commands/interactive.ts
 init_stream_output_service();
-import { createLogger as createLogger5, getTracerProvider as getTracerProvider3 } from "@ai-setting/roy-agent-core";
+import { createLogger as createLogger6, getTracerProvider as getTracerProvider3 } from "@ai-setting/roy-agent-core";
 
 // src/commands/input-handler.ts
 class InputHandler {
@@ -12027,7 +12029,7 @@ async function shutdownInteractiveSteps(deps) {
     envService,
     shouldDisposeEnvService,
     output,
-    logger: logger4,
+    logger: logger5,
     console: consoleLike
   } = deps;
   const log = (msg) => consoleLike?.log?.(msg) ?? console.log(msg);
@@ -12040,7 +12042,7 @@ async function shutdownInteractiveSteps(deps) {
       await memoryPluginDispose();
       log("\uD83D\uDCBE 记忆已保存完毕");
     } catch (err) {
-      logger4.warn(`[Shutdown] MemoryPlugin dispose failed: ${err}`);
+      logger5.warn(`[Shutdown] MemoryPlugin dispose failed: ${err}`);
       output.warn(`⚠️ 记忆保存失败: ${err}`);
     }
   }
@@ -12048,25 +12050,25 @@ async function shutdownInteractiveSteps(deps) {
     try {
       await lspManagerDispose();
     } catch (err) {
-      logger4.warn(`[Shutdown] LSP Manager dispose failed: ${err}`);
+      logger5.warn(`[Shutdown] LSP Manager dispose failed: ${err}`);
     }
   }
   if (pluginAdapterDispose) {
     try {
       await pluginAdapterDispose();
     } catch (err) {
-      logger4.warn(`[Shutdown] PluginAdapter dispose failed: ${err}`);
+      logger5.warn(`[Shutdown] PluginAdapter dispose failed: ${err}`);
     }
   }
   try {
     eventHandler.stop();
   } catch (err) {
-    logger4.warn(`[Shutdown] EventHandler.stop failed: ${err}`);
+    logger5.warn(`[Shutdown] EventHandler.stop failed: ${err}`);
   }
   try {
     queryExecutor.dispose();
   } catch (err) {
-    logger4.warn(`[Shutdown] QueryExecutor.dispose failed: ${err}`);
+    logger5.warn(`[Shutdown] QueryExecutor.dispose failed: ${err}`);
   }
   try {
     const eventSourceComponent = env.getComponent("event-source");
@@ -12075,7 +12077,7 @@ async function shutdownInteractiveSteps(deps) {
       if (sources && sources.length > 0) {
         for (const source of sources) {
           const status = eventSourceComponent.getStatus?.(source.id);
-          logger4.debug(`[Shutdown] 检查事件源: ${source.id}, 状态: ${status}`);
+          logger5.debug(`[Shutdown] 检查事件源: ${source.id}, 状态: ${status}`);
           if (status !== "stopped" && status !== "created") {
             try {
               await eventSourceComponent.stopSource(source.id);
@@ -12088,20 +12090,20 @@ async function shutdownInteractiveSteps(deps) {
       }
     }
   } catch (err) {
-    logger4.warn(`[Shutdown] EventSource cleanup failed: ${err}`);
+    logger5.warn(`[Shutdown] EventSource cleanup failed: ${err}`);
   }
   if (shouldDisposeEnvService) {
     try {
       await envService.dispose();
     } catch (err) {
-      logger4.warn(`[Shutdown] envService.dispose failed: ${err}`);
+      logger5.warn(`[Shutdown] envService.dispose failed: ${err}`);
     }
   }
   try {
     await TempFileManager2.getInstance().cleanupAll();
-    logger4.debug("[Shutdown] TempFileManager cleaned up");
+    logger5.debug("[Shutdown] TempFileManager cleaned up");
   } catch (err) {
-    logger4.warn(`[Shutdown] TempFileManager cleanup failed: ${err}`);
+    logger5.warn(`[Shutdown] TempFileManager cleanup failed: ${err}`);
   }
 }
 
@@ -12291,7 +12293,7 @@ var COLOR_BY_STATUS = {
   busy: COLORS.accent
 };
 // src/commands/interactive.ts
-var logger4 = createLogger5("cli:interactive");
+var logger5 = createLogger6("cli:interactive");
 var USER_PROMPT = COLORS.accent("❯ ");
 
 class REPL {
@@ -12483,10 +12485,10 @@ ${COLORS.system("[正在中断...]")}`);
           const agentComponent = this.env.getComponent("agent");
           if (agentComponent?.abortAll) {
             agentComponent.abortAll();
-            logger4.debug("[/abort] AgentComponent.abortAll() called");
+            logger5.debug("[/abort] AgentComponent.abortAll() called");
           } else if (agentComponent?.abort) {
             agentComponent.abort("default");
-            logger4.debug("[/abort] AgentComponent.abort('default') called (fallback)");
+            logger5.debug("[/abort] AgentComponent.abort('default') called (fallback)");
           }
         }
         abortStream();
@@ -12581,7 +12583,7 @@ ${COLORS.system("[没有正在执行的请求]")}`);
               try {
                 await this.options.onAfterExecute(this.lastUsage);
               } catch (hookError) {
-                logger4.warn("onAfterExecute hook failed (ink path)", { error: String(hookError) });
+                logger5.warn("onAfterExecute hook failed (ink path)", { error: String(hookError) });
               }
             }
           } catch (err) {
@@ -12601,7 +12603,7 @@ ${COLORS.system("[没有正在执行的请求]")}`);
         await this.shutdown();
         resolve();
       }).catch(async (err) => {
-        logger4.error("ink REPL render failed", { error: String(err) });
+        logger5.error("ink REPL render failed", { error: String(err) });
         await this.shutdown();
         resolve();
       });
@@ -12658,7 +12660,7 @@ ${COLORS.system("[没有正在执行的请求]")}`);
       }
       if (key.name === "escape") {
         this.handleEscKey().catch((err) => {
-          logger4.warn(`[Esc] handleEscKey failed: ${err}`);
+          logger5.warn(`[Esc] handleEscKey failed: ${err}`);
         });
       }
     };
@@ -12853,7 +12855,7 @@ ${COLORS.system("[通知2] ❯ " + message.replace(/\n/g, `
         try {
           await this.options.onAfterExecute(this.lastUsage);
         } catch (hookError) {
-          logger4.warn("onAfterExecute hook failed", { error: String(hookError) });
+          logger5.warn("onAfterExecute hook failed", { error: String(hookError) });
         }
       }
     } catch (error) {
@@ -13016,12 +13018,12 @@ ${COLORS.error("❌ 执行失败: " + error)}
   }
   async handleEscKey() {
     if (this.isShuttingDown) {
-      logger4.debug("[Esc] handler entered (isShuttingDown=true) → early return");
+      logger5.debug("[Esc] handler entered (isShuttingDown=true) → early return");
       return;
     }
     const mainSessionIdEarly = this.options.sessionId;
     const hasActiveDescendant = mainSessionIdEarly ? hasActiveDescendants(this.env, mainSessionIdEarly) : false;
-    logger4.debug(`[Esc] handler entered: isExecuting=${this.isExecuting} hasActiveDescendant=${hasActiveDescendant} lastEscPressTime=${this.lastEscPressTime}`);
+    logger5.debug(`[Esc] handler entered: isExecuting=${this.isExecuting} hasActiveDescendant=${hasActiveDescendant} lastEscPressTime=${this.lastEscPressTime}`);
     const now = Date.now();
     const isExecuting = this.isExecuting;
     const canCascade = isExecuting || hasActiveDescendant;
@@ -13030,17 +13032,17 @@ ${COLORS.error("❌ 执行失败: " + error)}
       this.lastEscPressTime = now;
     }
     if (!canCascade) {
-      logger4.debug("[Esc] idle no-op: isExecuting=false, no active descendant");
+      logger5.debug("[Esc] idle no-op: isExecuting=false, no active descendant");
       return;
     }
     if (this.env) {
       const agentComponent = this.env.getComponent("agent");
       if (agentComponent?.abortAll) {
         agentComponent.abortAll();
-        logger4.debug("[Esc] AgentComponent.abortAll() called");
+        logger5.debug("[Esc] AgentComponent.abortAll() called");
       } else if (agentComponent?.abort) {
         agentComponent.abort("default");
-        logger4.debug("[Esc] AgentComponent.abort('default') called (fallback)");
+        logger5.debug("[Esc] AgentComponent.abort('default') called (fallback)");
       }
     }
     abortStream();
@@ -13048,7 +13050,7 @@ ${COLORS.error("❌ 执行失败: " + error)}
       try {
         this.inkApi.finishAssistantStream();
       } catch (err) {
-        logger4.warn("[Esc] finishAssistantStream failed", { error: String(err) });
+        logger5.warn("[Esc] finishAssistantStream failed", { error: String(err) });
       }
     }
     const mainSessionId = this.options.sessionId;
@@ -13061,9 +13063,9 @@ ${COLORS.error("❌ 执行失败: " + error)}
             timer = setTimeout(() => reject(new Error("cascade timeout 5s")), 5000);
           })
         ]);
-        logger4.info(`[Esc] cascade stop force=${result.force} tasks=${result.stoppedTaskIds.length} workflows=${result.stoppedWorkflowSessionIds.length} errors=${result.errors.length}`);
+        logger5.info(`[Esc] cascade stop force=${result.force} tasks=${result.stoppedTaskIds.length} workflows=${result.stoppedWorkflowSessionIds.length} errors=${result.errors.length}`);
       } catch (err) {
-        logger4.warn(`[Esc] cascade stop failed: ${err}`);
+        logger5.warn(`[Esc] cascade stop failed: ${err}`);
       } finally {
         if (timer !== undefined)
           clearTimeout(timer);
@@ -13445,7 +13447,7 @@ function createInteractiveCommand(externalEnvService) {
               envService,
               shouldDisposeEnvService,
               output,
-              logger: logger4,
+              logger: logger5,
               console
             });
           }
@@ -25492,24 +25494,106 @@ var LspCommand = {
 
 // src/commands/install/index.ts
 import { spawnSync } from "node:child_process";
-import { existsSync as existsSync4, readFileSync as readFileSync3, writeFileSync, mkdirSync, rmSync } from "node:fs";
-import { join as join5, resolve } from "node:path";
+import { existsSync as existsSync5, readFileSync as readFileSync4, writeFileSync, mkdirSync, rmSync as rmSync2 } from "node:fs";
+import { join as join6, resolve } from "node:path";
 import { homedir as homedir4 } from "node:os";
+
+// src/commands/install/cleanup-stale-plugin-copies.ts
+import { existsSync as existsSync4, readFileSync as readFileSync3, rmSync, cpSync } from "node:fs";
+import { join as join5 } from "node:path";
+import { homedir as nodeHomedir, tmpdir as nodeTmpdir } from "node:os";
+function cleanupStalePluginCopies(packageName, options) {
+  const HOME = options.homedir ?? nodeHomedir();
+  const paths = options.localNodeModulesPaths ?? [
+    join5(HOME, "node_modules"),
+    join5(HOME, ".roy-agent", "node_modules")
+  ];
+  const backupRoot = options.backupDir ?? nodeTmpdir();
+  const result = {
+    cleaned: [],
+    skipped: [],
+    backups: []
+  };
+  if (!options.globalVersion) {
+    for (const p of paths) {
+      const candidate = join5(p, packageName);
+      result.skipped.push({ path: candidate, reason: "no-global-version" });
+    }
+    return result;
+  }
+  for (const nmPath of paths) {
+    const localPkgDir = join5(nmPath, packageName);
+    const localPkgJson = join5(localPkgDir, "package.json");
+    if (!existsSync4(localPkgJson)) {
+      result.skipped.push({ path: localPkgDir, reason: "no-local-copy" });
+      continue;
+    }
+    let localVersion = null;
+    try {
+      const pkg = JSON.parse(readFileSync3(localPkgJson, "utf-8"));
+      localVersion = typeof pkg.version === "string" ? pkg.version : null;
+    } catch {
+      localVersion = null;
+    }
+    const shouldClean = localVersion === null || compareVersions(localVersion, options.globalVersion) < 0;
+    if (!shouldClean) {
+      result.skipped.push({ path: localPkgDir, reason: "local-equal-or-newer" });
+      continue;
+    }
+    let backupPath = null;
+    try {
+      const safeName = packageName.replace(/@/g, "").replace(/[^a-zA-Z0-9._/-]/g, "-");
+      const safeLocalVersion = (localVersion ?? "unknown").replace(/[^a-zA-Z0-9._-]/g, "-");
+      const timestamp = Date.now();
+      backupPath = join5(backupRoot, `${safeName}-${safeLocalVersion}-backup-${timestamp}`);
+      cpSync(localPkgDir, backupPath, { recursive: true });
+      result.backups.push({ originalPath: localPkgDir, backupPath });
+    } catch (err) {
+      backupPath = null;
+      console.warn(`⚠️  Failed to backup stale copy at '${localPkgDir}': ${err}`);
+    }
+    try {
+      rmSync(localPkgDir, { recursive: true, force: true });
+      result.cleaned.push(localPkgDir);
+    } catch (err) {
+      console.warn(`⚠️  Failed to remove stale copy at '${localPkgDir}': ${err}`);
+      result.skipped.push({ path: localPkgDir, reason: "cleanup-failed" });
+      if (backupPath) {
+        console.warn(`   ↪ Backup preserved at '${backupPath}' for manual recovery`);
+      }
+    }
+  }
+  return result;
+}
+function compareVersions(a, b) {
+  const pa = a.split(".").map((s) => Number.parseInt(s, 10));
+  const pb = b.split(".").map((s) => Number.parseInt(s, 10));
+  for (let i = 0;i < 3; i++) {
+    const na = Number.isFinite(pa[i]) ? pa[i] : 0;
+    const nb = Number.isFinite(pb[i]) ? pb[i] : 0;
+    const diff = na - nb;
+    if (diff !== 0)
+      return diff;
+  }
+  return 0;
+}
+
+// src/commands/install/index.ts
 function getConfigDir(scope) {
-  return scope === "global" ? join5(homedir4(), ".roy-agent") : join5(process.cwd(), ".roy");
+  return scope === "global" ? join6(homedir4(), ".roy-agent") : join6(process.cwd(), ".roy");
 }
 function detectDefaultScope() {
-  const projectDir = join5(process.cwd(), ".roy");
-  return existsSync4(projectDir) ? "project" : "global";
+  const projectDir = join6(process.cwd(), ".roy");
+  return existsSync5(projectDir) ? "project" : "global";
 }
 function getConfigPath(scope) {
-  return join5(getConfigDir(scope), "plugins.json");
+  return join6(getConfigDir(scope), "plugins.json");
 }
 function loadPlugins(scope) {
   const configPath = getConfigPath(scope);
   try {
-    if (existsSync4(configPath)) {
-      const raw = readFileSync3(configPath, "utf-8");
+    if (existsSync5(configPath)) {
+      const raw = readFileSync4(configPath, "utf-8");
       const config = JSON.parse(raw);
       return config.plugins ?? [];
     }
@@ -25519,7 +25603,7 @@ function loadPlugins(scope) {
 function savePlugins(plugins, scope) {
   const configDir = getConfigDir(scope);
   const configPath = getConfigPath(scope);
-  if (!existsSync4(configDir)) {
+  if (!existsSync5(configDir)) {
     mkdirSync(configDir, { recursive: true });
   }
   const config = { plugins };
@@ -25535,10 +25619,10 @@ function stripVersionSpec(packageName) {
 function readPackageInfo(packageName) {
   const bareName = packageName.startsWith("/") || packageName.startsWith(".") ? packageName : stripVersionSpec(packageName);
   if (packageName.startsWith("/") || packageName.startsWith(".")) {
-    const localPkgPath = join5(packageName, "package.json");
-    if (existsSync4(localPkgPath)) {
+    const localPkgPath = join6(packageName, "package.json");
+    if (existsSync5(localPkgPath)) {
       try {
-        const pkg = JSON.parse(readFileSync3(localPkgPath, "utf-8"));
+        const pkg = JSON.parse(readFileSync4(localPkgPath, "utf-8"));
         return {
           version: pkg.version ?? "0.0.0",
           name: pkg.name ?? packageName,
@@ -25550,19 +25634,19 @@ function readPackageInfo(packageName) {
     }
   }
   const searchPaths = [
-    join5(process.cwd(), "node_modules", bareName, "package.json"),
+    join6(process.cwd(), "node_modules", bareName, "package.json"),
     resolve(process.cwd(), "..", "node_modules", bareName, "package.json"),
-    join5(process.cwd(), ".roy", "plugins", bareName, "package.json"),
+    join6(process.cwd(), ".roy", "plugins", bareName, "package.json"),
     ...(() => {
       const globalRoot = getNpmGlobalRoot();
-      return globalRoot ? [join5(globalRoot, bareName, "package.json")] : [];
+      return globalRoot ? [join6(globalRoot, bareName, "package.json")] : [];
     })(),
-    join5(homedir4(), ".roy-agent", "node_modules", bareName, "package.json")
+    join6(homedir4(), ".roy-agent", "node_modules", bareName, "package.json")
   ];
   for (const pkgPath of searchPaths) {
     try {
-      if (existsSync4(pkgPath)) {
-        const pkg = JSON.parse(readFileSync3(pkgPath, "utf-8"));
+      if (existsSync5(pkgPath)) {
+        const pkg = JSON.parse(readFileSync4(pkgPath, "utf-8"));
         return {
           version: pkg.version ?? "0.0.0",
           name: pkg.name ?? bareName,
@@ -25584,19 +25668,6 @@ function getNpmGlobalRoot() {
   }
   return null;
 }
-function cleanupStaleCpCopy(packageName) {
-  const cpDir = join5(homedir4(), ".roy-agent", "node_modules", packageName);
-  if (!existsSync4(cpDir)) {
-    return false;
-  }
-  try {
-    rmSync(cpDir, { recursive: true, force: true });
-    return true;
-  } catch (err) {
-    console.warn(`⚠️  Failed to clean stale cp copy at '${cpDir}': ${err}`);
-    return false;
-  }
-}
 async function verifyInstalledVersion(packageName, declaredVersion) {
   const actual = readPackageInfo(packageName);
   if (!actual || !actual.version) {
@@ -25608,15 +25679,15 @@ async function verifyInstalledVersion(packageName, declaredVersion) {
   return { ok: true, actualVersion: actual.version };
 }
 function getPackageManagerCommand() {
-  if (existsSync4(join5(process.cwd(), "pnpm-lock.yaml"))) {
-    if (existsSync4(join5(process.cwd(), "pnpm-workspace.yaml"))) {
+  if (existsSync5(join6(process.cwd(), "pnpm-lock.yaml"))) {
+    if (existsSync5(join6(process.cwd(), "pnpm-workspace.yaml"))) {
       return "pnpm -w";
     }
     return "pnpm";
   }
-  if (existsSync4(join5(process.cwd(), "yarn.lock")))
+  if (existsSync5(join6(process.cwd(), "yarn.lock")))
     return "yarn";
-  if (existsSync4(join5(process.cwd(), "bun.lock")) || existsSync4(join5(process.cwd(), "bun.lockb")))
+  if (existsSync5(join6(process.cwd(), "bun.lock")) || existsSync5(join6(process.cwd(), "bun.lockb")))
     return "bun";
   return "npm";
 }
@@ -25655,14 +25726,14 @@ var InstallPackageCommand = {
         }
         resolvedName = info2.name;
         const srcDir = resolve(packageName);
-        if (!existsSync4(srcDir)) {
+        if (!existsSync5(srcDir)) {
           console.error(`
 ❌ Local path '${srcDir}' does not exist.
 `);
           process.exit(1);
         }
-        const pluginDir = join5(process.cwd(), ".roy", "plugins", resolvedName);
-        if (!existsSync4(pluginDir)) {
+        const pluginDir = join6(process.cwd(), ".roy", "plugins", resolvedName);
+        if (!existsSync5(pluginDir)) {
           mkdirSync(pluginDir, { recursive: true });
         }
         const result = spawnSync("cp", ["-r", `${srcDir}/.`, pluginDir], {
@@ -25697,12 +25768,12 @@ var InstallPackageCommand = {
           process.exit(1);
         }
         resolvedName = info2.name;
-        const pluginDir = join5(process.cwd(), ".roy", "plugins", resolvedName);
-        if (!existsSync4(pluginDir)) {
+        const pluginDir = join6(process.cwd(), ".roy", "plugins", resolvedName);
+        if (!existsSync5(pluginDir)) {
           mkdirSync(pluginDir, { recursive: true });
         }
-        const nmPath = join5(process.cwd(), "node_modules", packageName);
-        if (existsSync4(nmPath)) {
+        const nmPath = join6(process.cwd(), "node_modules", packageName);
+        if (existsSync5(nmPath)) {
           spawnSync("cp", ["-r", `${nmPath}/.`, pluginDir], { stdio: "inherit", shell: false });
         }
       }
@@ -25722,11 +25793,24 @@ var InstallPackageCommand = {
       }
       const tmpInfo = readPackageInfo(packageName);
       if (tmpInfo) {
-        const cleaned = cleanupStaleCpCopy(tmpInfo.name);
-        if (cleaned) {
+        const cleanupResult = cleanupStalePluginCopies(tmpInfo.name, {
+          globalVersion: tmpInfo.version,
+          homedir: homedir4()
+        });
+        if (cleanupResult.cleaned.length > 0) {
           console.log(`
-\uD83E\uDDF9 Cleaned stale cp copy: ~/.roy-agent/node_modules/${tmpInfo.name}
-`);
+\uD83E\uDDF9 Cleaned stale plugin copies:`);
+          for (const path9 of cleanupResult.cleaned) {
+            console.log(`   - ${path9}`);
+          }
+          if (cleanupResult.backups.length > 0) {
+            console.log(`
+\uD83D\uDCE6 Backups (for manual recovery):`);
+            for (const b of cleanupResult.backups) {
+              console.log(`   ${b.originalPath} → ${b.backupPath}`);
+            }
+          }
+          console.log();
         }
       }
     }
@@ -25851,8 +25935,8 @@ var InstallRemoveCommand = {
 \uD83D\uDDD1️  Removing plugin: ${plugin.packageName}@${plugin.version} (${scope})
 `);
     if (scope === "project") {
-      const pluginDir = join5(process.cwd(), ".roy", "plugins", plugin.packageName);
-      if (existsSync4(pluginDir)) {
+      const pluginDir = join6(process.cwd(), ".roy", "plugins", plugin.packageName);
+      if (existsSync5(pluginDir)) {
         spawnSync("rm", ["-rf", pluginDir], { stdio: "inherit", shell: false });
         console.log(`  Removed plugin directory: ${pluginDir}`);
       }
@@ -25867,8 +25951,8 @@ var InstallRemoveCommand = {
 `);
         process.exit(result.status ?? 1);
       }
-      const globalNm = join5(homedir4(), ".roy-agent", "node_modules", plugin.packageName);
-      if (existsSync4(globalNm)) {
+      const globalNm = join6(homedir4(), ".roy-agent", "node_modules", plugin.packageName);
+      if (existsSync5(globalNm)) {
         spawnSync("rm", ["-rf", globalNm], { stdio: "inherit", shell: false });
       }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-setting/roy-agent-cli",
-  "version": "1.7.15",
+  "version": "1.7.17",
   "type": "module",
   "description": "CLI for roy-agent - Non-interactive command execution",
   "main": "./dist/index.js",