uloop-cli 1.6.1 → 1.6.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uloop-cli",
-  "version": "1.6.1",
+  "version": "1.6.3",
   "//version": "x-release-please-version",
   "description": "CLI tool for Unity Editor communication via Unity CLI Loop",
   "main": "dist/cli.bundle.cjs",
@@ -57,11 +57,11 @@
     "eslint-plugin-prettier": "5.5.5",
     "eslint-plugin-security": "4.0.0",
     "jest": "30.3.0",
-    "knip": "6.0.6",
+    "knip": "6.1.1",
     "prettier": "3.8.1",
     "ts-jest": "29.4.6",
     "typescript": "5.9.3",
-    "typescript-eslint": "8.57.2"
+    "typescript-eslint": "8.58.0"
   },
   "overrides": {
     "minimatch": "10.2.4"

package/src/cli-constants.ts

@@ -0,0 +1,5 @@
+// User-facing display name for the product (shown in error messages, diagnostics)
+export const PRODUCT_DISPLAY_NAME = 'Unity CLI Loop';
+
+// Unity Editor menu path to the server window
+export const MENU_PATH_SERVER = 'Window > Unity CLI Loop > Server';

package/src/cli.ts

@@ -8,6 +8,7 @@
 // and object keys come from tool definitions which are internal trusted data
 /* eslint-disable no-console, security/detect-non-literal-fs-filename, security/detect-object-injection */
 
+import { PRODUCT_DISPLAY_NAME, MENU_PATH_SERVER } from './cli-constants';
 import { existsSync, readFileSync, writeFileSync, mkdirSync, unlinkSync } from 'fs';
 import { join, basename, dirname } from 'path';
 import { homedir } from 'os';
@@ -133,7 +134,7 @@ program.helpCommand(true);
 program
   .command('list')
   .description('List all available tools from Unity')
-  .option('-p, --port <port>', 'Unity TCP port')
+  .addOption(createHiddenPortOption())
   .option('--project-path <path>', 'Unity project path')
   .action(async (options: CliOptions) => {
     await runWithErrorHandling(() => listAvailableTools(extractGlobalOptions(options)));
@@ -142,7 +143,7 @@ program
 program
   .command('sync')
   .description('Sync tool definitions from Unity to local cache')
-  .option('-p, --port <port>', 'Unity TCP port')
+  .addOption(createHiddenPortOption())
   .option('--project-path <path>', 'Unity project path')
   .action(async (options: CliOptions) => {
     await runWithErrorHandling(() => syncTools(extractGlobalOptions(options)));
@@ -210,8 +211,7 @@ function registerToolCommand(tool: ToolDefinition, helpGroup: string): void {
     }
   }
 
-  // Add global options
-  cmd.option('-p, --port <port>', 'Unity TCP port');
+  cmd.addOption(createHiddenPortOption());
   cmd.option('--project-path <path>', 'Unity project path');
 
   cmd.action(async (options: CliOptions) => {
@@ -364,6 +364,11 @@ function getToolHelpGroup(toolName: string, defaultToolNames: ReadonlySet<string
   return defaultToolNames.has(toolName) ? HELP_GROUP_BUILTIN_TOOLS : HELP_GROUP_THIRD_PARTY_TOOLS;
 }
 
+// Option instances are mutated by commander, so each command needs its own
+function createHiddenPortOption(): Option {
+  return new Option('-p, --port <port>', 'Unity TCP port').hideHelp();
+}
+
 function extractGlobalOptions(options: Record<string, unknown>): GlobalOptions {
   return {
     port: options['port'] as string | undefined,
@@ -382,7 +387,8 @@ function printToolDisabledError(cmdName: string): void {
 
 function printConnectionError(): void {
   console.error('\x1b[31mError: Cannot connect to Unity.\x1b[0m');
-  console.error('Make sure Unity Editor is open and uLoopMCP server is running.');
+  console.error(`Make sure Unity Editor is open and ${PRODUCT_DISPLAY_NAME} server is running.`);
+  console.error(`You can start the server from: ${MENU_PATH_SERVER}`);
   console.error('');
   console.error('[For AI] Please report the above to the user.');
 }
@@ -440,7 +446,7 @@ async function runWithErrorHandling(fn: () => Promise<void>): Promise<void> {
       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.',
+        'Start the Unity Editor for this project, or use --project-path to specify the target.',
       );
       process.exit(1);
     }

package/src/default-tools.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.6.1",
+  "version": "1.6.3",
   "tools": [
     {
       "name": "compile",

package/src/execute-tool.ts

@@ -7,6 +7,7 @@
 // and lock file paths are constructed from trusted project root detection
 /* eslint-disable no-console, security/detect-object-injection, security/detect-non-literal-fs-filename */
 
+import { PRODUCT_DISPLAY_NAME } from './cli-constants';
 import * as readline from 'readline';
 import { existsSync } from 'fs';
 import { join } from 'path';
@@ -138,7 +139,7 @@ function printVersionWarning(cliVersion: string, serverVersion: string): void {
   const isCliOlder = isVersionOlder(cliVersion, serverVersion);
   const updateCommand = isCliOlder
     ? `npm install -g uloop-cli@${serverVersion}`
-    : `Update uLoopMCP package to ${cliVersion} via Unity Package Manager`;
+    : `Update ${PRODUCT_DISPLAY_NAME} package to ${cliVersion} via Unity Package Manager`;
 
   console.error('\x1b[33m⚠️ Version mismatch detected!\x1b[0m');
   console.error(`   uloop-cli version:    ${cliVersion}`);

package/src/port-resolver.ts

@@ -6,6 +6,7 @@
 // File paths are constructed from Unity project root detection, not from user input
 /* eslint-disable security/detect-non-literal-fs-filename */
 
+import { PRODUCT_DISPLAY_NAME } from './cli-constants';
 import { readFile } from 'fs/promises';
 import { existsSync } from 'fs';
 import { join, resolve } from 'path';
@@ -61,7 +62,7 @@ export function validateProjectPath(projectPath: string): string {
 
   if (!hasUloopInstalled(resolved)) {
     throw new Error(
-      `uLoopMCP is not installed in this project (UserSettings/UnityMcpSettings.json not found): ${resolved}`,
+      `${PRODUCT_DISPLAY_NAME} is not installed in this project (UserSettings/UnityMcpSettings.json not found): ${resolved}`,
     );
   }
 
@@ -87,9 +88,7 @@ export async function resolveUnityPort(
 
   const projectRoot = findUnityProjectRoot();
   if (projectRoot === null) {
-    throw new Error(
-      'Unity project not found. Use --port or --project-path option to specify the target.',
-    );
+    throw new Error('Unity project not found. Use --project-path option to specify the target.');
   }
 
   return await readPortFromSettingsOrThrow(projectRoot);
@@ -100,7 +99,7 @@ function createSettingsReadError(projectRoot: string): Error {
   return new Error(
     `Could not read Unity server port from settings.\n\n` +
       `  Settings file: ${settingsPath}\n\n` +
-      `Run 'uloop launch -r' to restart Unity, or use --port to specify the port directly.`,
+      `Run 'uloop launch -r' to restart Unity.`,
   );
 }
 

package/src/project-validator.ts

@@ -6,6 +6,7 @@
 // Paths come from trusted Unity responses and validated project root, console.error for user warnings
 /* eslint-disable security/detect-non-literal-fs-filename, no-console */
 
+import { PRODUCT_DISPLAY_NAME } from './cli-constants';
 import assert from 'node:assert';
 import { realpath } from 'fs/promises';
 import { dirname } from 'path';
@@ -41,7 +42,7 @@ export async function validateConnectedProject(
   try {
     response = await client.sendRequest<GetVersionResponse>('get-version', {});
   } catch (error) {
-    // Method not found: old uLoopMCP version without get-version tool
+    // Method not found: old package version without get-version tool
     if (
       error instanceof Error &&
       (error.message.includes(`${JSON_RPC_METHOD_NOT_FOUND}`) ||
@@ -49,7 +50,7 @@ export async function validateConnectedProject(
         /unknown tool/i.test(error.message))
     ) {
       console.error(
-        'Warning: Could not verify project identity (get-version not available). Consider updating uLoopMCP package.',
+        `Warning: Could not verify project identity (get-version not available). Consider updating ${PRODUCT_DISPLAY_NAME} package.`,
       );
       return;
     }

package/src/skills/skill-definitions/cli-only/uloop-focus-window/Skill/SKILL.md

@@ -21,8 +21,7 @@ None.
 
 | Option | Description |
 |--------|-------------|
-| `--project-path <path>` | Target a specific Unity project (mutually exclusive with `--port`). Path resolution follows the same rules as `cd` — absolute paths are used as-is, relative paths are resolved from cwd. |
-| `-p, --port <port>` | Specify Unity TCP port directly (mutually exclusive with `--project-path`). |
+| `--project-path <path>` | Target a specific Unity project. Path resolution follows the same rules as `cd` — absolute paths are used as-is, relative paths are resolved from cwd. |
 
 ## Examples
 

package/src/skills/skills-manager.ts

@@ -7,6 +7,7 @@
 // File paths are constructed from home directory and skill names, not from untrusted user input
 /* eslint-disable security/detect-non-literal-fs-filename */
 
+import { PRODUCT_DISPLAY_NAME } from '../cli-constants';
 import { existsSync, mkdirSync, readFileSync, writeFileSync, rmSync, readdirSync } from 'fs';
 import { join, dirname, resolve, isAbsolute, sep } from 'path';
 import { homedir } from 'os';
@@ -84,8 +85,8 @@ function getProjectSkillsDir(target: TargetConfig): string {
   }
   if (!status.hasUloop) {
     throw new Error(
-      `uLoopMCP is not installed in this Unity project (${status.path}).\n` +
-        'Please install uLoopMCP package first, then run this command again.',
+      `${PRODUCT_DISPLAY_NAME} is not installed in this Unity project (${status.path}).\n` +
+        `Please install ${PRODUCT_DISPLAY_NAME} package first, then run this command again.`,
     );
   }
   return join(status.path as string, target.projectDir, 'skills');

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 = '1.6.1'; // x-release-please-version
+export const VERSION = '1.6.3'; // x-release-please-version