uloop-cli 0.68.3 → 0.69.1

package/dist/cli.bundle.cjs

@@ -5384,7 +5384,7 @@ var require_semver2 = __commonJS({
 
 // src/cli.ts
 var import_fs8 = require("fs");
-var import_path9 = require("path");
+var import_path10 = require("path");
 var import_os2 = require("os");
 var import_child_process = require("child_process");
 
@@ -5408,7 +5408,7 @@ var {
 // src/execute-tool.ts
 var readline = __toESM(require("readline"), 1);
 var import_fs5 = require("fs");
-var import_path5 = require("path");
+var import_path6 = require("path");
 var semver = __toESM(require_semver2(), 1);
 
 // src/direct-unity-client.ts
@@ -5542,7 +5542,9 @@ var DirectUnityClient = class {
         this.receiveBuffer = extractResult.remainingData;
         const response = JSON.parse(extractResult.jsonContent);
         if (response.error) {
-          reject(new Error(`Unity error: ${response.error.message}`));
+          const data = response.error.data;
+          const dataMessage = data !== null && data !== void 0 && typeof data === "object" && "message" in data ? ` (${data.message})` : "";
+          reject(new Error(`Unity error: ${response.error.message}${dataMessage}`));
           return;
         }
         resolve7(response.result);
@@ -5736,7 +5738,12 @@ function findUnityProjectInParentsWithoutUloop(startPath) {
 }
 
 // src/port-resolver.ts
-var DEFAULT_PORT = 8700;
+var UnityNotRunningError = class extends Error {
+  constructor(projectRoot) {
+    super("UNITY_NOT_RUNNING");
+    this.projectRoot = projectRoot;
+  }
+};
 function normalizePort(port) {
   if (typeof port !== "number") {
     return null;
@@ -5780,11 +5787,7 @@ async function resolveUnityPort(explicitPort, projectPath) {
   }
   if (projectPath !== void 0) {
     const resolved = validateProjectPath(projectPath);
-    const settingsPort2 = await readPortFromSettings(resolved);
-    if (settingsPort2 !== null) {
-      return settingsPort2;
-    }
-    return DEFAULT_PORT;
+    return await readPortFromSettingsOrThrow(resolved);
   }
   const projectRoot = findUnityProjectRoot();
   if (projectRoot === null) {
@@ -5792,39 +5795,98 @@ async function resolveUnityPort(explicitPort, projectPath) {
       "Unity project not found. Use --port or --project-path option to specify the target."
     );
   }
-  const settingsPort = await readPortFromSettings(projectRoot);
-  if (settingsPort !== null) {
-    return settingsPort;
-  }
-  return DEFAULT_PORT;
+  return await readPortFromSettingsOrThrow(projectRoot);
+}
+function createSettingsReadError(projectRoot) {
+  const settingsPath = (0, import_path2.join)(projectRoot, "UserSettings/UnityMcpSettings.json");
+  return new Error(
+    `Could not read Unity server port from settings.
+
+  Settings file: ${settingsPath}
+
+Run 'uloop launch -r' to restart Unity, or use --port to specify the port directly.`
+  );
 }
-async function readPortFromSettings(projectRoot) {
+async function readPortFromSettingsOrThrow(projectRoot) {
   const settingsPath = (0, import_path2.join)(projectRoot, "UserSettings/UnityMcpSettings.json");
   if (!(0, import_fs2.existsSync)(settingsPath)) {
-    return null;
+    throw createSettingsReadError(projectRoot);
   }
   let content;
   try {
     content = await (0, import_promises.readFile)(settingsPath, "utf-8");
   } catch {
-    return null;
+    throw createSettingsReadError(projectRoot);
   }
-  let settings;
+  let parsed;
   try {
-    settings = JSON.parse(content);
+    parsed = JSON.parse(content);
   } catch {
-    return null;
+    throw createSettingsReadError(projectRoot);
+  }
+  if (typeof parsed !== "object" || parsed === null) {
+    throw createSettingsReadError(projectRoot);
+  }
+  const settings = parsed;
+  if (settings.isServerRunning === false) {
+    throw new UnityNotRunningError(projectRoot);
+  }
+  const port = resolvePortFromUnitySettings(settings);
+  if (port === null) {
+    throw createSettingsReadError(projectRoot);
+  }
+  return port;
+}
+
+// src/project-validator.ts
+var import_node_assert = __toESM(require("node:assert"), 1);
+var import_promises2 = require("fs/promises");
+var import_path3 = require("path");
+var ProjectMismatchError = class extends Error {
+  constructor(expectedProjectRoot, connectedProjectRoot) {
+    super("PROJECT_MISMATCH");
+    this.expectedProjectRoot = expectedProjectRoot;
+    this.connectedProjectRoot = connectedProjectRoot;
+  }
+};
+var JSON_RPC_METHOD_NOT_FOUND = -32601;
+async function normalizePath(path) {
+  const resolved = await (0, import_promises2.realpath)(path);
+  return resolved.replace(/\/+$/, "");
+}
+async function validateConnectedProject(client, expectedProjectRoot) {
+  (0, import_node_assert.default)(client.isConnected(), "client must be connected before validation");
+  let response;
+  try {
+    response = await client.sendRequest("get-version", {});
+  } catch (error) {
+    if (error instanceof Error && (error.message.includes(`${JSON_RPC_METHOD_NOT_FOUND}`) || /method not found/i.test(error.message) || /unknown tool/i.test(error.message))) {
+      console.error(
+        "Warning: Could not verify project identity (get-version not available). Consider updating uLoopMCP package."
+      );
+      return;
+    }
+    throw error;
+  }
+  if (typeof response?.DataPath !== "string" || response.DataPath.length === 0) {
+    console.error("Warning: Could not verify project identity (invalid get-version response).");
+    return;
+  }
+  const connectedProjectRoot = (0, import_path3.dirname)(response.DataPath);
+  const normalizedExpected = await normalizePath(expectedProjectRoot);
+  const normalizedConnected = await normalizePath(connectedProjectRoot);
+  if (normalizedExpected !== normalizedConnected) {
+    throw new ProjectMismatchError(normalizedExpected, normalizedConnected);
   }
-  return resolvePortFromUnitySettings(settings);
 }
 
 // src/tool-cache.ts
 var import_fs3 = require("fs");
-var import_path3 = require("path");
+var import_path4 = require("path");
 
 // src/default-tools.json
 var default_tools_default = {
-  version: "0.68.3",
+  version: "0.69.1",
   tools: [
     {
       name: "compile",
@@ -6293,16 +6355,16 @@ var CACHE_DIR = ".uloop";
 var CACHE_FILE = "tools.json";
 function getCacheDir(projectPath) {
   if (projectPath !== void 0) {
-    return (0, import_path3.join)(projectPath, CACHE_DIR);
+    return (0, import_path4.join)(projectPath, CACHE_DIR);
   }
   const projectRoot = findUnityProjectRoot();
   if (projectRoot === null) {
-    return (0, import_path3.join)(process.cwd(), CACHE_DIR);
+    return (0, import_path4.join)(process.cwd(), CACHE_DIR);
   }
-  return (0, import_path3.join)(projectRoot, CACHE_DIR);
+  return (0, import_path4.join)(projectRoot, CACHE_DIR);
 }
 function getCachePath(projectPath) {
-  return (0, import_path3.join)(getCacheDir(projectPath), CACHE_FILE);
+  return (0, import_path4.join)(getCacheDir(projectPath), CACHE_FILE);
 }
 function getDefaultTools() {
   return default_tools_default;
@@ -6353,7 +6415,7 @@ function getCachedServerVersion() {
 }
 
 // src/version.ts
-var VERSION = "0.68.3";
+var VERSION = "0.69.1";
 
 // src/spinner.ts
 var SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
@@ -6388,10 +6450,10 @@ function createSpinner(initialMessage) {
 }
 
 // src/compile-helpers.ts
-var import_node_assert = __toESM(require("node:assert"), 1);
+var import_node_assert2 = __toESM(require("node:assert"), 1);
 var import_fs4 = require("fs");
 var net2 = __toESM(require("net"), 1);
-var import_path4 = require("path");
+var import_path5 = require("path");
 var SAFE_REQUEST_ID_PATTERN = /^[a-zA-Z0-9_-]+$/;
 var COMPILE_FORCE_RECOMPILE_ARG_KEYS = [
   "ForceRecompile",
@@ -6451,22 +6513,22 @@ function ensureCompileRequestId(args) {
   return requestId;
 }
 function getCompileResultFilePath(projectRoot, requestId) {
-  (0, import_node_assert.default)(
+  (0, import_node_assert2.default)(
     SAFE_REQUEST_ID_PATTERN.test(requestId),
     `requestId contains unsafe characters: '${requestId}'`
   );
-  return (0, import_path4.join)(projectRoot, "Temp", "uLoopMCP", "compile-results", `${requestId}.json`);
+  return (0, import_path5.join)(projectRoot, "Temp", "uLoopMCP", "compile-results", `${requestId}.json`);
 }
 function isUnityBusyByLockFiles(projectRoot) {
-  const compilingLockPath = (0, import_path4.join)(projectRoot, "Temp", "compiling.lock");
+  const compilingLockPath = (0, import_path5.join)(projectRoot, "Temp", "compiling.lock");
   if ((0, import_fs4.existsSync)(compilingLockPath)) {
     return true;
   }
-  const domainReloadLockPath = (0, import_path4.join)(projectRoot, "Temp", "domainreload.lock");
+  const domainReloadLockPath = (0, import_path5.join)(projectRoot, "Temp", "domainreload.lock");
   if ((0, import_fs4.existsSync)(domainReloadLockPath)) {
     return true;
   }
-  const serverStartingLockPath = (0, import_path4.join)(projectRoot, "Temp", "serverstarting.lock");
+  const serverStartingLockPath = (0, import_path5.join)(projectRoot, "Temp", "serverstarting.lock");
   return (0, import_fs4.existsSync)(serverStartingLockPath);
 }
 function stripUtf8Bom(content) {
@@ -6676,15 +6738,15 @@ function checkUnityBusyState(projectPath) {
   if (projectRoot === null) {
     return;
   }
-  const compilingLock = (0, import_path5.join)(projectRoot, "Temp", "compiling.lock");
+  const compilingLock = (0, import_path6.join)(projectRoot, "Temp", "compiling.lock");
   if ((0, import_fs5.existsSync)(compilingLock)) {
     throw new Error("UNITY_COMPILING");
   }
-  const domainReloadLock = (0, import_path5.join)(projectRoot, "Temp", "domainreload.lock");
+  const domainReloadLock = (0, import_path6.join)(projectRoot, "Temp", "domainreload.lock");
   if ((0, import_fs5.existsSync)(domainReloadLock)) {
     throw new Error("UNITY_DOMAIN_RELOAD");
   }
-  const serverStartingLock = (0, import_path5.join)(projectRoot, "Temp", "serverstarting.lock");
+  const serverStartingLock = (0, import_path6.join)(projectRoot, "Temp", "serverstarting.lock");
   if ((0, import_fs5.existsSync)(serverStartingLock)) {
     throw new Error("UNITY_SERVER_STARTING");
   }
@@ -6707,12 +6769,16 @@ async function executeToolCommand(toolName, params, globalOptions) {
   let lastError;
   let immediateResult;
   const projectRoot = globalOptions.projectPath !== void 0 ? validateProjectPath(globalOptions.projectPath) : findUnityProjectRoot();
+  const shouldValidateProject = portNumber === void 0 && projectRoot !== null;
   let requestDispatched = false;
   for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
     checkUnityBusyState(globalOptions.projectPath);
     const client = new DirectUnityClient(port);
     try {
       await client.connect();
+      if (shouldValidateProject) {
+        await validateConnectedProject(client, projectRoot);
+      }
       spinner.update(`Executing ${toolName}...`);
       requestDispatched = true;
       const result = await client.sendRequest(toolName, params);
@@ -6824,6 +6890,8 @@ async function listAvailableTools(globalOptions) {
     portNumber = parsed;
   }
   const port = await resolveUnityPort(portNumber, globalOptions.projectPath);
+  const projectRoot = globalOptions.projectPath !== void 0 ? validateProjectPath(globalOptions.projectPath) : findUnityProjectRoot();
+  const shouldValidateProject = portNumber === void 0 && projectRoot !== null;
   const restoreStdin = suppressStdinEcho();
   const spinner = createSpinner("Connecting to Unity...");
   let lastError;
@@ -6832,6 +6900,9 @@ async function listAvailableTools(globalOptions) {
     const client = new DirectUnityClient(port);
     try {
       await client.connect();
+      if (shouldValidateProject) {
+        await validateConnectedProject(client, projectRoot);
+      }
       spinner.update("Fetching tool list...");
       const result = await client.sendRequest("get-tool-details", { IncludeDevelopmentOnly: false });
       if (!result.Tools || !Array.isArray(result.Tools)) {
@@ -6881,6 +6952,8 @@ async function syncTools(globalOptions) {
     portNumber = parsed;
   }
   const port = await resolveUnityPort(portNumber, globalOptions.projectPath);
+  const projectRoot = globalOptions.projectPath !== void 0 ? validateProjectPath(globalOptions.projectPath) : findUnityProjectRoot();
+  const shouldValidateProject = portNumber === void 0 && projectRoot !== null;
   const restoreStdin = suppressStdinEcho();
   const spinner = createSpinner("Connecting to Unity...");
   let lastError;
@@ -6889,6 +6962,9 @@ async function syncTools(globalOptions) {
     const client = new DirectUnityClient(port);
     try {
       await client.connect();
+      if (shouldValidateProject) {
+        await validateConnectedProject(client, projectRoot);
+      }
       spinner.update("Syncing tools...");
       const result = await client.sendRequest("get-tool-details", { IncludeDevelopmentOnly: false });
       spinner.stop();
@@ -6943,7 +7019,7 @@ function pascalToKebabCase(pascal) {
 
 // src/skills/skills-manager.ts
 var import_fs7 = require("fs");
-var import_path7 = require("path");
+var import_path8 = require("path");
 var import_os = require("os");
 
 // src/skills/deprecated-skills.ts
@@ -6956,15 +7032,15 @@ var DEPRECATED_SKILLS = [
 
 // src/tool-settings-loader.ts
 var import_fs6 = require("fs");
-var import_path6 = require("path");
+var import_path7 = require("path");
 var ULOOP_DIR = ".uloop";
 var TOOL_SETTINGS_FILE = "settings.tools.json";
 function loadDisabledTools(projectPath) {
-  const projectRoot = projectPath !== void 0 ? (0, import_path6.resolve)(projectPath) : findUnityProjectRoot();
+  const projectRoot = projectPath !== void 0 ? (0, import_path7.resolve)(projectPath) : findUnityProjectRoot();
   if (projectRoot === null) {
     return [];
   }
-  const settingsPath = (0, import_path6.join)(projectRoot, ULOOP_DIR, TOOL_SETTINGS_FILE);
+  const settingsPath = (0, import_path7.join)(projectRoot, ULOOP_DIR, TOOL_SETTINGS_FILE);
   let content;
   try {
     content = (0, import_fs6.readFileSync)(settingsPath, "utf-8");
@@ -7039,7 +7115,7 @@ var SkillsPathConstants = class _SkillsPathConstants {
   ];
 };
 function getGlobalSkillsDir(target) {
-  return (0, import_path7.join)((0, import_os.homedir)(), target.projectDir, "skills");
+  return (0, import_path8.join)((0, import_os.homedir)(), target.projectDir, "skills");
 }
 function getProjectSkillsDir(target) {
   const status = getUnityProjectStatus();
@@ -7054,11 +7130,11 @@ function getProjectSkillsDir(target) {
 Please install uLoopMCP package first, then run this command again.`
     );
   }
-  return (0, import_path7.join)(status.path, target.projectDir, "skills");
+  return (0, import_path8.join)(status.path, target.projectDir, "skills");
 }
 function getSkillPath(skillDirName, target, global) {
   const baseDir = global ? getGlobalSkillsDir(target) : getProjectSkillsDir(target);
-  return (0, import_path7.join)(baseDir, skillDirName, target.skillFileName);
+  return (0, import_path8.join)(baseDir, skillDirName, target.skillFileName);
 }
 function isSkillInstalled(skill, target, global) {
   const skillPath = getSkillPath(skill.dirName, target, global);
@@ -7066,8 +7142,8 @@ function isSkillInstalled(skill, target, global) {
 }
 function isSkillOutdated(skill, target, global) {
   const baseDir = global ? getGlobalSkillsDir(target) : getProjectSkillsDir(target);
-  const skillDir = (0, import_path7.join)(baseDir, skill.dirName);
-  const skillPath = (0, import_path7.join)(skillDir, target.skillFileName);
+  const skillDir = (0, import_path8.join)(baseDir, skill.dirName);
+  const skillPath = (0, import_path8.join)(skillDir, target.skillFileName);
   if (!(0, import_fs7.existsSync)(skillPath)) {
     return false;
   }
@@ -7078,7 +7154,7 @@ function isSkillOutdated(skill, target, global) {
   if ("additionalFiles" in skill && skill.additionalFiles) {
     const additionalFiles = skill.additionalFiles;
     for (const [relativePath, expectedContent] of Object.entries(additionalFiles)) {
-      const filePath = (0, import_path7.join)(skillDir, relativePath);
+      const filePath = (0, import_path8.join)(skillDir, relativePath);
       if (!(0, import_fs7.existsSync)(filePath)) {
         return true;
       }
@@ -7154,11 +7230,11 @@ function scanEditorFolderForSkills(editorPath, skills, sourceType, warnLegacy =
     if (EXCLUDED_DIRS2.has(entry.name)) {
       continue;
     }
-    const fullPath = (0, import_path7.join)(editorPath, entry.name);
+    const fullPath = (0, import_path8.join)(editorPath, entry.name);
     if (entry.isDirectory()) {
-      const skillDir = (0, import_path7.join)(fullPath, SkillsPathConstants.SKILL_DIR);
-      const skillMdPath = (0, import_path7.join)(skillDir, SkillsPathConstants.SKILL_FILE);
-      const legacySkillMdPath = (0, import_path7.join)(fullPath, SkillsPathConstants.SKILL_FILE);
+      const skillDir = (0, import_path8.join)(fullPath, SkillsPathConstants.SKILL_DIR);
+      const skillMdPath = (0, import_path8.join)(skillDir, SkillsPathConstants.SKILL_FILE);
+      const legacySkillMdPath = (0, import_path8.join)(fullPath, SkillsPathConstants.SKILL_FILE);
       if (warnLegacy && !(0, import_fs7.existsSync)(skillMdPath) && (0, import_fs7.existsSync)(legacySkillMdPath)) {
         warnLegacySkillStructure(fullPath, legacySkillMdPath);
       }
@@ -7196,7 +7272,7 @@ function findEditorFolders(basePath, maxDepth = 2) {
       if (!entry.isDirectory() || EXCLUDED_DIRS2.has(entry.name)) {
         continue;
       }
-      const fullPath = (0, import_path7.join)(currentPath, entry.name);
+      const fullPath = (0, import_path8.join)(currentPath, entry.name);
       if (entry.name === "Editor") {
         editorFolders.push(fullPath);
       } else {
@@ -7215,9 +7291,9 @@ function collectProjectSkills(excludedRoots = []) {
   const skills = [];
   const seenNames = /* @__PURE__ */ new Set();
   const searchPaths = [
-    (0, import_path7.join)(projectRoot, SkillsPathConstants.ASSETS_DIR),
-    (0, import_path7.join)(projectRoot, SkillsPathConstants.PACKAGES_DIR),
-    (0, import_path7.join)(projectRoot, SkillsPathConstants.LIBRARY_DIR, SkillsPathConstants.PACKAGE_CACHE_DIR)
+    (0, import_path8.join)(projectRoot, SkillsPathConstants.ASSETS_DIR),
+    (0, import_path8.join)(projectRoot, SkillsPathConstants.PACKAGES_DIR),
+    (0, import_path8.join)(projectRoot, SkillsPathConstants.LIBRARY_DIR, SkillsPathConstants.PACKAGE_CACHE_DIR)
   ];
   for (const searchPath of searchPaths) {
     if (!(0, import_fs7.existsSync)(searchPath)) {
@@ -7251,22 +7327,22 @@ function getAllSkillStatuses(target, global) {
 }
 function installSkill(skill, target, global) {
   const baseDir = global ? getGlobalSkillsDir(target) : getProjectSkillsDir(target);
-  const skillDir = (0, import_path7.join)(baseDir, skill.dirName);
-  const skillPath = (0, import_path7.join)(skillDir, target.skillFileName);
+  const skillDir = (0, import_path8.join)(baseDir, skill.dirName);
+  const skillPath = (0, import_path8.join)(skillDir, target.skillFileName);
   (0, import_fs7.mkdirSync)(skillDir, { recursive: true });
   (0, import_fs7.writeFileSync)(skillPath, skill.content, "utf-8");
   if ("additionalFiles" in skill && skill.additionalFiles) {
     const additionalFiles = skill.additionalFiles;
     for (const [relativePath, content] of Object.entries(additionalFiles)) {
-      const fullPath = (0, import_path7.join)(skillDir, relativePath);
-      (0, import_fs7.mkdirSync)((0, import_path7.dirname)(fullPath), { recursive: true });
+      const fullPath = (0, import_path8.join)(skillDir, relativePath);
+      (0, import_fs7.mkdirSync)((0, import_path8.dirname)(fullPath), { recursive: true });
       (0, import_fs7.writeFileSync)(fullPath, content);
     }
   }
 }
 function uninstallSkill(skill, target, global) {
   const baseDir = global ? getGlobalSkillsDir(target) : getProjectSkillsDir(target);
-  const skillDir = (0, import_path7.join)(baseDir, skill.dirName);
+  const skillDir = (0, import_path8.join)(baseDir, skill.dirName);
   if (!(0, import_fs7.existsSync)(skillDir)) {
     return false;
   }
@@ -7284,7 +7360,7 @@ function installAllSkills(target, global) {
   };
   const baseDir = global ? getGlobalSkillsDir(target) : getProjectSkillsDir(target);
   for (const deprecatedName of DEPRECATED_SKILLS) {
-    const deprecatedDir = (0, import_path7.join)(baseDir, deprecatedName);
+    const deprecatedDir = (0, import_path8.join)(baseDir, deprecatedName);
     if ((0, import_fs7.existsSync)(deprecatedDir)) {
       (0, import_fs7.rmSync)(deprecatedDir, { recursive: true, force: true });
       result.deprecatedRemoved++;
@@ -7328,7 +7404,7 @@ function uninstallAllSkills(target, global) {
   const result = { removed: 0, notFound: 0 };
   const baseDir = global ? getGlobalSkillsDir(target) : getProjectSkillsDir(target);
   for (const deprecatedName of DEPRECATED_SKILLS) {
-    const deprecatedDir = (0, import_path7.join)(baseDir, deprecatedName);
+    const deprecatedDir = (0, import_path8.join)(baseDir, deprecatedName);
     if ((0, import_fs7.existsSync)(deprecatedDir)) {
       (0, import_fs7.rmSync)(deprecatedDir, { recursive: true, force: true });
       result.removed++;
@@ -7359,7 +7435,7 @@ function collectAllSkills() {
   return dedupeSkillsByName([packageSkills, cliOnlySkills, projectSkills]);
 }
 function collectPackageSkillsFromRoot(packageRoot) {
-  const mcpToolsRoot = (0, import_path7.join)(
+  const mcpToolsRoot = (0, import_path8.join)(
     packageRoot,
     SkillsPathConstants.EDITOR_DIR,
     SkillsPathConstants.API_DIR,
@@ -7373,7 +7449,7 @@ function collectPackageSkillsFromRoot(packageRoot) {
   return skills;
 }
 function collectCliOnlySkills() {
-  const cliOnlyRoot = (0, import_path7.resolve)(
+  const cliOnlyRoot = (0, import_path8.resolve)(
     __dirname,
     SkillsPathConstants.DIST_PARENT_DIR,
     SkillsPathConstants.SRC_DIR,
@@ -7405,7 +7481,7 @@ function collectSkillFolderFilesRecursive(baseDir, currentDir, additionalFiles)
     if (isExcludedFile(entry.name)) {
       continue;
     }
-    const fullPath = (0, import_path7.join)(currentDir, entry.name);
+    const fullPath = (0, import_path8.join)(currentDir, entry.name);
     const relativePath = fullPath.slice(baseDir.length + 1);
     if (entry.isDirectory()) {
       if (EXCLUDED_DIRS2.has(entry.name)) {
@@ -7444,13 +7520,13 @@ function dedupeSkillsByName(skillGroups) {
 }
 function resolvePackageRoot(projectRoot) {
   const candidates = [];
-  candidates.push((0, import_path7.join)(projectRoot, SkillsPathConstants.PACKAGES_DIR, SkillsPathConstants.SRC_DIR));
+  candidates.push((0, import_path8.join)(projectRoot, SkillsPathConstants.PACKAGES_DIR, SkillsPathConstants.SRC_DIR));
   const manifestPaths = resolveManifestPackagePaths(projectRoot);
   for (const manifestPath of manifestPaths) {
     candidates.push(manifestPath);
   }
   for (const packageName of SkillsPathConstants.PACKAGE_NAMES) {
-    candidates.push((0, import_path7.join)(projectRoot, SkillsPathConstants.PACKAGES_DIR, packageName));
+    candidates.push((0, import_path8.join)(projectRoot, SkillsPathConstants.PACKAGES_DIR, packageName));
   }
   const directRoot = resolveFirstPackageRoot(candidates);
   if (directRoot) {
@@ -7459,7 +7535,7 @@ function resolvePackageRoot(projectRoot) {
   return resolvePackageCacheRoot(projectRoot);
 }
 function resolveManifestPackagePaths(projectRoot) {
-  const manifestPath = (0, import_path7.join)(
+  const manifestPath = (0, import_path8.join)(
     projectRoot,
     SkillsPathConstants.PACKAGES_DIR,
     SkillsPathConstants.MANIFEST_FILE
@@ -7511,10 +7587,10 @@ function resolveDependencyPath(rawPath, projectRoot) {
   if (normalizedPath.startsWith("//")) {
     normalizedPath = normalizedPath.slice(2);
   }
-  if ((0, import_path7.isAbsolute)(normalizedPath)) {
+  if ((0, import_path8.isAbsolute)(normalizedPath)) {
     return normalizedPath;
   }
-  return (0, import_path7.resolve)(projectRoot, normalizedPath);
+  return (0, import_path8.resolve)(projectRoot, normalizedPath);
 }
 function resolveFirstPackageRoot(candidates) {
   for (const candidate of candidates) {
@@ -7526,7 +7602,7 @@ function resolveFirstPackageRoot(candidates) {
   return null;
 }
 function resolvePackageCacheRoot(projectRoot) {
-  const packageCacheDir = (0, import_path7.join)(
+  const packageCacheDir = (0, import_path8.join)(
     projectRoot,
     SkillsPathConstants.LIBRARY_DIR,
     SkillsPathConstants.PACKAGE_CACHE_DIR
@@ -7542,7 +7618,7 @@ function resolvePackageCacheRoot(projectRoot) {
     if (!isTargetPackageCacheDir(entry.name)) {
       continue;
     }
-    const candidate = (0, import_path7.join)(packageCacheDir, entry.name);
+    const candidate = (0, import_path8.join)(packageCacheDir, entry.name);
     const resolvedRoot = resolvePackageRootCandidate(candidate);
     if (resolvedRoot) {
       return resolvedRoot;
@@ -7554,7 +7630,7 @@ function resolvePackageRootCandidate(candidate) {
   if (!(0, import_fs7.existsSync)(candidate)) {
     return null;
   }
-  const directToolsPath = (0, import_path7.join)(
+  const directToolsPath = (0, import_path8.join)(
     candidate,
     SkillsPathConstants.EDITOR_DIR,
     SkillsPathConstants.API_DIR,
@@ -7563,8 +7639,8 @@ function resolvePackageRootCandidate(candidate) {
   if ((0, import_fs7.existsSync)(directToolsPath)) {
     return candidate;
   }
-  const nestedRoot = (0, import_path7.join)(candidate, SkillsPathConstants.PACKAGES_DIR, SkillsPathConstants.SRC_DIR);
-  const nestedToolsPath = (0, import_path7.join)(
+  const nestedRoot = (0, import_path8.join)(candidate, SkillsPathConstants.PACKAGES_DIR, SkillsPathConstants.SRC_DIR);
+  const nestedToolsPath = (0, import_path8.join)(
     nestedRoot,
     SkillsPathConstants.EDITOR_DIR,
     SkillsPathConstants.API_DIR,
@@ -7596,12 +7672,12 @@ function isUnderExcludedRoots(targetPath, excludedRoots) {
   return false;
 }
 function isPathUnder(childPath, parentPath) {
-  const resolvedChild = (0, import_path7.resolve)(childPath);
-  const resolvedParent = (0, import_path7.resolve)(parentPath);
+  const resolvedChild = (0, import_path8.resolve)(childPath);
+  const resolvedParent = (0, import_path8.resolve)(parentPath);
   if (resolvedChild === resolvedParent) {
     return true;
   }
-  return resolvedChild.startsWith(resolvedParent + import_path7.sep);
+  return resolvedChild.startsWith(resolvedParent + import_path8.sep);
 }
 
 // src/skills/target-config.ts
@@ -7786,20 +7862,20 @@ Uninstalling uloop skills (${location})...`);
 }
 
 // src/commands/launch.ts
-var import_path8 = require("path");
+var import_path9 = require("path");
 
 // node_modules/launch-unity/dist/lib.js
 var import_node_child_process = require("node:child_process");
 var import_node_fs2 = require("node:fs");
-var import_promises3 = require("node:fs/promises");
+var import_promises4 = require("node:fs/promises");
 var import_node_path2 = require("node:path");
 var import_node_util = require("node:util");
 
 // node_modules/launch-unity/dist/unityHub.js
-var import_promises2 = require("node:fs/promises");
+var import_promises3 = require("node:fs/promises");
 var import_node_fs = require("node:fs");
 var import_node_path = require("node:path");
-var import_node_assert2 = __toESM(require("node:assert"), 1);
+var import_node_assert3 = __toESM(require("node:assert"), 1);
 var resolveUnityHubProjectFiles = () => {
   if (process.platform === "darwin") {
     const home = process.env.HOME;
@@ -7826,7 +7902,7 @@ var removeTrailingSeparators = (target) => {
   }
   return trimmed;
 };
-var normalizePath = (target) => {
+var normalizePath2 = (target) => {
   const resolvedPath = (0, import_node_path.resolve)(target);
   return removeTrailingSeparators(resolvedPath);
 };
@@ -7834,14 +7910,14 @@ var resolvePathWithActualCase = (target) => {
   try {
     return removeTrailingSeparators(import_node_fs.realpathSync.native(target));
   } catch {
-    return normalizePath(target);
+    return normalizePath2(target);
   }
 };
 var toComparablePath = (value) => {
   return value.replace(/\\/g, "/").toLocaleLowerCase();
 };
 var pathsEqual = (left, right) => {
-  return toComparablePath(normalizePath(left)) === toComparablePath(normalizePath(right));
+  return toComparablePath(normalizePath2(left)) === toComparablePath(normalizePath2(right));
 };
 var safeParseProjectsJson = (content) => {
   try {
@@ -7866,7 +7942,7 @@ var ensureProjectEntryAndUpdate = async (projectPath, version, when, setFavorite
   }
   for (const path of candidates) {
     logDebug(`Trying Unity Hub file: ${path}`);
-    const content = await (0, import_promises2.readFile)(path, "utf8").catch(() => void 0);
+    const content = await (0, import_promises3.readFile)(path, "utf8").catch(() => void 0);
     if (!content) {
       logDebug("Read failed or empty content, skipping.");
       continue;
@@ -7901,7 +7977,7 @@ var ensureProjectEntryAndUpdate = async (projectPath, version, when, setFavorite
       }
     };
     try {
-      await (0, import_promises2.writeFile)(path, JSON.stringify(updatedJson, void 0, 2), "utf8");
+      await (0, import_promises3.writeFile)(path, JSON.stringify(updatedJson, void 0, 2), "utf8");
       logDebug("Write succeeded.");
     } catch (error) {
       logDebug(`Write failed: ${error instanceof Error ? error.message : String(error)}`);
@@ -7918,7 +7994,7 @@ var updateLastModifiedIfExists = async (projectPath, when) => {
     let content;
     let json;
     try {
-      content = await (0, import_promises2.readFile)(path, "utf8");
+      content = await (0, import_promises3.readFile)(path, "utf8");
     } catch {
       continue;
     }
@@ -7946,7 +8022,7 @@ var updateLastModifiedIfExists = async (projectPath, when) => {
       lastModified: when.getTime()
     };
     try {
-      await (0, import_promises2.writeFile)(path, JSON.stringify(json, void 0, 2), "utf8");
+      await (0, import_promises3.writeFile)(path, JSON.stringify(json, void 0, 2), "utf8");
     } catch {
     }
     return;
@@ -7970,7 +8046,7 @@ var resolveUnityHubProjectsInfoFile = () => {
   return void 0;
 };
 var parseCliArgs = (cliArgsString) => {
-  (0, import_node_assert2.default)(cliArgsString !== null && cliArgsString !== void 0, "cliArgsString must not be null");
+  (0, import_node_assert3.default)(cliArgsString !== null && cliArgsString !== void 0, "cliArgsString must not be null");
   const trimmed = cliArgsString.trim();
   if (trimmed.length === 0) {
     return [];
@@ -8026,7 +8102,7 @@ var groupCliArgs = (args) => {
   return groups;
 };
 var getProjectCliArgs = async (projectPath) => {
-  (0, import_node_assert2.default)(projectPath !== null && projectPath !== void 0, "projectPath must not be null");
+  (0, import_node_assert3.default)(projectPath !== null && projectPath !== void 0, "projectPath must not be null");
   const infoFilePath = resolveUnityHubProjectsInfoFile();
   if (!infoFilePath) {
     logDebug("projectsInfo.json path could not be resolved.");
@@ -8035,7 +8111,7 @@ var getProjectCliArgs = async (projectPath) => {
   logDebug(`Reading projectsInfo.json: ${infoFilePath}`);
   let content;
   try {
-    content = await (0, import_promises2.readFile)(infoFilePath, "utf8");
+    content = await (0, import_promises3.readFile)(infoFilePath, "utf8");
   } catch {
     logDebug("projectsInfo.json not found or not readable.");
     return [];
@@ -8047,7 +8123,7 @@ var getProjectCliArgs = async (projectPath) => {
     logDebug("projectsInfo.json parse failed.");
     return [];
   }
-  const normalizedProjectPath = normalizePath(projectPath);
+  const normalizedProjectPath = normalizePath2(projectPath);
   const projectKey = Object.keys(json).find((key) => pathsEqual(key, normalizedProjectPath));
   if (!projectKey) {
     logDebug(`No entry found for project: ${normalizedProjectPath}`);
@@ -8126,7 +8202,7 @@ var removeTrailingSeparators2 = (target) => {
   }
   return trimmed;
 };
-var normalizePath2 = (target) => {
+var normalizePath3 = (target) => {
   const resolvedPath = (0, import_node_path2.resolve)(target);
   const trimmed = removeTrailingSeparators2(resolvedPath);
   return trimmed;
@@ -8135,7 +8211,7 @@ var toComparablePath2 = (value) => {
   return value.replace(/\\/g, "/").toLocaleLowerCase();
 };
 var pathsEqual2 = (left, right) => {
-  return toComparablePath2(normalizePath2(left)) === toComparablePath2(normalizePath2(right));
+  return toComparablePath2(normalizePath3(left)) === toComparablePath2(normalizePath3(right));
 };
 function extractProjectPath(command) {
   const match = command.match(PROJECT_PATH_PATTERN);
@@ -8196,7 +8272,7 @@ async function listUnityProcessesMac() {
     }
     processes.push({
       pid: pidValue,
-      projectPath: normalizePath2(projectArgument)
+      projectPath: normalizePath3(projectArgument)
     });
   }
   return processes;
@@ -8244,7 +8320,7 @@ async function listUnityProcessesWindows() {
     }
     processes.push({
       pid: pidValue,
-      projectPath: normalizePath2(projectArgument)
+      projectPath: normalizePath3(projectArgument)
     });
   }
   return processes;
@@ -8259,7 +8335,7 @@ async function listUnityProcesses() {
   return [];
 }
 async function findRunningUnityProcess(projectPath) {
-  const normalizedTarget = normalizePath2(projectPath);
+  const normalizedTarget = normalizePath3(projectPath);
   const processes = await listUnityProcesses();
   return processes.find((candidate) => pathsEqual2(candidate.projectPath, normalizedTarget));
 }
@@ -8360,14 +8436,14 @@ async function handleStaleLockfile(projectPath) {
   console.log(`UnityLockfile found without active Unity process: ${lockfilePath}`);
   console.log("Assuming previous crash. Cleaning Temp directory and continuing launch.");
   try {
-    await (0, import_promises3.rm)(tempDirectoryPath, { recursive: true, force: true });
+    await (0, import_promises4.rm)(tempDirectoryPath, { recursive: true, force: true });
     console.log("Deleted Temp directory.");
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     console.warn(`Failed to delete Temp directory: ${message}`);
   }
   try {
-    await (0, import_promises3.rm)(lockfilePath, { force: true });
+    await (0, import_promises4.rm)(lockfilePath, { force: true });
     console.log("Deleted UnityLockfile.");
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
@@ -8382,7 +8458,7 @@ async function deleteRecoveryDirectory(projectPath) {
   }
   console.log(`Deleting recovery directory: ${recoveryPath}`);
   try {
-    await (0, import_promises3.rm)(recoveryPath, { recursive: true, force: true });
+    await (0, import_promises4.rm)(recoveryPath, { recursive: true, force: true });
     console.log("Deleted recovery directory.");
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
@@ -8537,7 +8613,7 @@ function findUnityProjectBfs(rootDir, maxDepth) {
     rootCanonical = rootDir;
   }
   queue.push({ dir: rootCanonical, depth: 0 });
-  const visited = /* @__PURE__ */ new Set([toComparablePath2(normalizePath2(rootCanonical))]);
+  const visited = /* @__PURE__ */ new Set([toComparablePath2(normalizePath3(rootCanonical))]);
   while (queue.length > 0) {
     const current = queue.shift();
     if (!current) {
@@ -8545,7 +8621,7 @@ function findUnityProjectBfs(rootDir, maxDepth) {
     }
     const { dir, depth } = current;
     if (isUnityProjectRoot(dir)) {
-      return normalizePath2(dir);
+      return normalizePath3(dir);
     }
     const canDescend = maxDepth === -1 || depth < maxDepth;
     if (!canDescend) {
@@ -8566,7 +8642,7 @@ function findUnityProjectBfs(rootDir, maxDepth) {
       } catch {
         continue;
       }
-      const key = toComparablePath2(normalizePath2(childCanonical));
+      const key = toComparablePath2(normalizePath3(childCanonical));
       if (visited.has(key)) {
         continue;
       }
@@ -8724,7 +8800,7 @@ function parseMaxDepth(value) {
 async function runLaunchCommand(projectPath, options) {
   const maxDepth = parseMaxDepth(options.maxDepth);
   await orchestrateLaunch({
-    projectPath: projectPath ? (0, import_path8.resolve)(projectPath) : void 0,
+    projectPath: projectPath ? (0, import_path9.resolve)(projectPath) : void 0,
     searchRoot: process.cwd(),
     searchMaxDepth: maxDepth,
     platform: options.platform,
@@ -9056,6 +9132,26 @@ async function runWithErrorHandling(fn) {
   try {
     await fn();
   } catch (error) {
+    if (error instanceof UnityNotRunningError) {
+      console.error("\x1B[31mError: Unity Editor for this project is not running.\x1B[0m");
+      console.error("");
+      console.error(`  Project: ${error.projectRoot}`);
+      console.error("");
+      console.error("Start the Unity Editor for this project and try again.");
+      process.exit(1);
+    }
+    if (error instanceof ProjectMismatchError) {
+      console.error("\x1B[31mError: Unity Editor for this project is not running.\x1B[0m");
+      console.error("");
+      console.error(`  Project:      ${error.expectedProjectRoot}`);
+      console.error(`  Connected to: ${error.connectedProjectRoot}`);
+      console.error("");
+      console.error("Another Unity instance was found, but it belongs to a different project.");
+      console.error(
+        "Start the Unity Editor for this project, or use --port to specify the target."
+      );
+      process.exit(1);
+    }
     const message = error instanceof Error ? error.message : String(error);
     if (message === "UNITY_COMPILING") {
       console.error("\x1B[33m\u23F3 Unity is compiling scripts.\x1B[0m");
@@ -9100,7 +9196,7 @@ async function runWithErrorHandling(fn) {
 }
 function detectShell() {
   const shell = process.env["SHELL"] || "";
-  const shellName = (0, import_path9.basename)(shell).replace(/\.exe$/i, "");
+  const shellName = (0, import_path10.basename)(shell).replace(/\.exe$/i, "");
   if (shellName === "zsh") {
     return "zsh";
   }
@@ -9115,12 +9211,12 @@ function detectShell() {
 function getShellConfigPath(shell) {
   const home = (0, import_os2.homedir)();
   if (shell === "zsh") {
-    return (0, import_path9.join)(home, ".zshrc");
+    return (0, import_path10.join)(home, ".zshrc");
   }
   if (shell === "powershell") {
-    return (0, import_path9.join)(home, "Documents", "WindowsPowerShell", "Microsoft.PowerShell_profile.ps1");
+    return (0, import_path10.join)(home, "Documents", "WindowsPowerShell", "Microsoft.PowerShell_profile.ps1");
   }
-  return (0, import_path9.join)(home, ".bashrc");
+  return (0, import_path10.join)(home, ".bashrc");
 }
 function getCompletionScript(shell) {
   if (shell === "bash") {
@@ -9257,10 +9353,10 @@ function cleanupLockFiles(projectPath) {
     console.error("Could not find Unity project root.");
     process.exit(1);
   }
-  const tempDir = (0, import_path9.join)(projectRoot, "Temp");
+  const tempDir = (0, import_path10.join)(projectRoot, "Temp");
   let cleaned = 0;
   for (const lockFile of LOCK_FILES) {
-    const lockPath = (0, import_path9.join)(tempDir, lockFile);
+    const lockPath = (0, import_path10.join)(tempDir, lockFile);
     if ((0, import_fs8.existsSync)(lockPath)) {
       (0, import_fs8.unlinkSync)(lockPath);
       console.log(`Removed: ${lockFile}`);
@@ -9297,7 +9393,7 @@ function handleCompletion(install, shellOverride) {
     return;
   }
   const configPath = getShellConfigPath(shell);
-  const configDir = (0, import_path9.dirname)(configPath);
+  const configDir = (0, import_path10.dirname)(configPath);
   if (!(0, import_fs8.existsSync)(configDir)) {
     (0, import_fs8.mkdirSync)(configDir, { recursive: true });
   }