uloop-cli 0.62.2 → 0.62.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uloop-cli",
-  "version": "0.62.2",
+  "version": "0.62.4",
   "//version": "x-release-please-version",
   "description": "CLI tool for Unity Editor communication via uLoopMCP",
   "main": "dist/cli.bundle.cjs",

package/src/cli.ts

@@ -38,14 +38,20 @@ interface CliOptions extends GlobalOptions {
   [key: string]: unknown;
 }
 
+const LAUNCH_COMMAND = 'launch' as const;
+const UPDATE_COMMAND = 'update' as const;
+
+// commander.js built-in flags that exit immediately without needing Unity
+const NO_SYNC_FLAGS = ['-v', '--version', '-h', '--help'] as const;
+
 const BUILTIN_COMMANDS = [
   'list',
   'sync',
   'completion',
-  'update',
+  UPDATE_COMMAND,
   'fix',
   'skills',
-  'launch',
+  LAUNCH_COMMAND,
   'focus-window',
 ] as const;
 
@@ -743,6 +749,13 @@ function commandExists(cmdName: string): boolean {
   return tools.tools.some((t) => t.name === cmdName);
 }
 
+function shouldSkipAutoSync(cmdName: string | undefined, args: string[]): boolean {
+  if (cmdName === LAUNCH_COMMAND || cmdName === UPDATE_COMMAND) {
+    return true;
+  }
+  return args.some((arg) => (NO_SYNC_FLAGS as readonly string[]).includes(arg));
+}
+
 /**
  * Main entry point with auto-sync for unknown commands.
  */
@@ -751,24 +764,29 @@ async function main(): Promise<void> {
     return;
   }
 
-  // Check if cache version is outdated and auto-sync if needed
-  const cachedVersion = loadToolsCache().version;
-  if (hasCacheFile() && cachedVersion !== VERSION) {
-    console.log(
-      `\x1b[33mCache outdated (${cachedVersion} → ${VERSION}). Syncing tools from Unity...\x1b[0m`,
-    );
-    try {
-      await syncTools({});
-      console.log('\x1b[32m✓ Tools synced successfully.\x1b[0m\n');
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      if (isConnectionError(message)) {
-        console.error('\x1b[33mWarning: Failed to sync tools. Using cached definitions.\x1b[0m');
-        console.error("\x1b[33mRun 'uloop sync' manually when Unity is available.\x1b[0m\n");
-      } else {
-        console.error('\x1b[33mWarning: Failed to sync tools. Using cached definitions.\x1b[0m');
-        console.error(`\x1b[33mError: ${message}\x1b[0m`);
-        console.error("\x1b[33mRun 'uloop sync' manually when Unity is available.\x1b[0m\n");
+  const args = process.argv.slice(2);
+  const cmdName = args.find((arg) => !arg.startsWith('-'));
+
+  if (!shouldSkipAutoSync(cmdName, args)) {
+    // Check if cache version is outdated and auto-sync if needed
+    const cachedVersion = loadToolsCache().version;
+    if (hasCacheFile() && cachedVersion !== VERSION) {
+      console.log(
+        `\x1b[33mCache outdated (${cachedVersion} → ${VERSION}). Syncing tools from Unity...\x1b[0m`,
+      );
+      try {
+        await syncTools({});
+        console.log('\x1b[32m✓ Tools synced successfully.\x1b[0m\n');
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (isConnectionError(message)) {
+          console.error('\x1b[33mWarning: Failed to sync tools. Using cached definitions.\x1b[0m');
+          console.error("\x1b[33mRun 'uloop sync' manually when Unity is available.\x1b[0m\n");
+        } else {
+          console.error('\x1b[33mWarning: Failed to sync tools. Using cached definitions.\x1b[0m');
+          console.error(`\x1b[33mError: ${message}\x1b[0m`);
+          console.error("\x1b[33mRun 'uloop sync' manually when Unity is available.\x1b[0m\n");
+        }
       }
     }
   }
@@ -779,9 +797,6 @@ async function main(): Promise<void> {
     registerToolCommand(tool);
   }
 
-  const args = process.argv.slice(2);
-  const cmdName = args.find((arg) => !arg.startsWith('-'));
-
   if (cmdName && !commandExists(cmdName)) {
     console.log(`\x1b[33mUnknown command '${cmdName}'. Syncing tools from Unity...\x1b[0m`);
     try {

package/src/default-tools.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.62.2",
+  "version": "0.62.4",
   "tools": [
     {
       "name": "compile",

package/src/version.ts

@@ -4,4 +4,4 @@
  * This file exists to avoid bundling the entire package.json into the CLI bundle.
  * This version is automatically updated by release-please.
  */
-export const VERSION = '0.62.2'; // x-release-please-version
+export const VERSION = '0.62.4'; // x-release-please-version