uloop-cli 1.6.2 → 1.6.3

package/README.md

@@ -70,25 +70,18 @@ Custom skills defined in your project are also automatically detected.
 
 You can also call the CLI directly without using Skills.
 
-### Project Path / Port Specification
+### Project Path Specification
 
-If `--project-path` / `--port` is omitted, the port is automatically selected from the Unity project detected in the current directory.
+If `--project-path` is omitted, the port is automatically selected from the Unity project detected in the current directory.
 
-To operate multiple Unity instances from a single LLM tool, explicitly specify a project path or port:
+To operate multiple Unity instances from a single LLM tool, explicitly specify a project path:
 
 ```bash
 # Specify by project path (absolute or relative)
 uloop compile --project-path /Users/foo/my-unity-project
 uloop compile --project-path ../other-project
-
-# Specify by port number
-uloop compile --port {target-port}
 ```
 
-> [!NOTE]
-> - `--project-path` and `--port` cannot be used together.
-> - You can find the port number in each Unity's uLoopMCP Window.
-
 ### Chaining Commands
 
 Chain commands with `&&` to automate a sequence of operations:

package/README_ja.md

@@ -70,25 +70,18 @@ Skills はUnityプロジェクト内の uLoopMCP パッケージから動的に
 
 Skills を使わずに、CLI を直接呼び出すこともできます。
 
-### プロジェクトパス指定 / ポート指定
+### プロジェクトパス指定
 
-`--project-path` / `--port` を省略した場合は、カレントディレクトリの Unity プロジェクトで設定されたポートが自動選択されます。
+`--project-path` を省略した場合は、カレントディレクトリの Unity プロジェクトで設定されたポートが自動選択されます。
 
-一つのLLMツールから複数のUnityインスタンスを操作したい場合、プロジェクトパスまたはポートを明示的に指定します：
+一つのLLMツールから複数のUnityインスタンスを操作したい場合、プロジェクトパスを明示的に指定します：
 
 ```bash
 # プロジェクトパスで指定（絶対パス・相対パスどちらも可）
 uloop compile --project-path /Users/foo/my-unity-project
 uloop compile --project-path ../other-project
-
-# ポート番号で指定
-uloop compile --port {target-port}
 ```
 
-> [!NOTE]
-> - `--project-path` と `--port` は同時に指定できません。
-> - ポート番号は各Unityの uLoopMCP Window で確認できます。
-
 ### コマンドの連携
 
 `&&` でコマンドを連結することで、一連の操作を自動化できます：

package/dist/cli.bundle.cjs

@@ -795,7 +795,7 @@ ${itemIndentStr}`);
 var require_option = __commonJS({
   "node_modules/commander/lib/option.js"(exports2) {
     var { InvalidArgumentError: InvalidArgumentError2 } = require_error();
-    var Option3 = class {
+    var Option2 = class {
       /**
        * Initialize a new `Option` with the given `flags` and `description`.
        *
@@ -1099,7 +1099,7 @@ var require_option = __commonJS({
         );
       return { shortFlag, longFlag };
     }
-    exports2.Option = Option3;
+    exports2.Option = Option2;
     exports2.DualOptions = DualOptions;
   }
 });
@@ -1195,7 +1195,7 @@ var require_command = __commonJS({
     var { Argument: Argument2, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
     var { Help: Help2, stripColor } = require_help();
-    var { Option: Option3, DualOptions } = require_option();
+    var { Option: Option2, DualOptions } = require_option();
     var { suggestSimilar } = require_suggestSimilar();
     var Command2 = class _Command extends EventEmitter {
       /**
@@ -1680,7 +1680,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Option} new option
        */
       createOption(flags, description) {
-        return new Option3(flags, description);
+        return new Option2(flags, description);
       }
       /**
        * Wrap parseArgs to catch 'commander.invalidArgument'.
@@ -1805,7 +1805,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @private
        */
       _optionEx(config, flags, description, fn, defaultValue) {
-        if (typeof flags === "object" && flags instanceof Option3) {
+        if (typeof flags === "object" && flags instanceof Option2) {
           throw new Error(
             "To add an Option object use addOption() instead of option() or requiredOption()"
           );
@@ -3437,13 +3437,13 @@ var require_commander = __commonJS({
     var { Command: Command2 } = require_command();
     var { CommanderError: CommanderError2, InvalidArgumentError: InvalidArgumentError2 } = require_error();
     var { Help: Help2 } = require_help();
-    var { Option: Option3 } = require_option();
+    var { Option: Option2 } = require_option();
     exports2.program = new Command2();
     exports2.createCommand = (name) => new Command2(name);
-    exports2.createOption = (flags, description) => new Option3(flags, description);
+    exports2.createOption = (flags, description) => new Option2(flags, description);
     exports2.createArgument = (name, description) => new Argument2(name, description);
     exports2.Command = Command2;
-    exports2.Option = Option3;
+    exports2.Option = Option2;
     exports2.Argument = Argument2;
     exports2.Help = Help2;
     exports2.CommanderError = CommanderError2;
@@ -5382,6 +5382,10 @@ var require_semver2 = __commonJS({
   }
 });
 
+// src/cli-constants.ts
+var PRODUCT_DISPLAY_NAME = "Unity CLI Loop";
+var MENU_PATH_SERVER = "Window > Unity CLI Loop > Server";
+
 // src/cli.ts
 var import_fs8 = require("fs");
 var import_path10 = require("path");
@@ -5773,7 +5777,7 @@ function validateProjectPath(projectPath) {
   }
   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}`
     );
   }
   return resolved;
@@ -5791,9 +5795,7 @@ async function resolveUnityPort(explicitPort, projectPath) {
   }
   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);
 }
@@ -5804,7 +5806,7 @@ function createSettingsReadError(projectRoot) {
 
   Settings file: ${settingsPath}
 
-Run 'uloop launch -r' to restart Unity, or use --port to specify the port directly.`
+Run 'uloop launch -r' to restart Unity.`
   );
 }
 async function readPortFromSettingsOrThrow(projectRoot) {
@@ -5862,7 +5864,7 @@ async function validateConnectedProject(client, expectedProjectRoot) {
   } 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."
+        `Warning: Could not verify project identity (get-version not available). Consider updating ${PRODUCT_DISPLAY_NAME} package.`
       );
       return;
     }
@@ -5886,7 +5888,7 @@ var import_path4 = require("path");
 
 // src/default-tools.json
 var default_tools_default = {
-  version: "1.6.2",
+  version: "1.6.3",
   tools: [
     {
       name: "compile",
@@ -6519,7 +6521,7 @@ function getCachedServerVersion() {
 }
 
 // src/version.ts
-var VERSION = "1.6.2";
+var VERSION = "1.6.3";
 
 // src/spinner.ts
 var SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
@@ -6821,7 +6823,7 @@ function isVersionOlder(v1, v2) {
 }
 function printVersionWarning(cliVersion, serverVersion) {
   const isCliOlder = isVersionOlder(cliVersion, serverVersion);
-  const updateCommand = isCliOlder ? `npm install -g uloop-cli@${serverVersion}` : `Update uLoopMCP package to ${cliVersion} via Unity Package Manager`;
+  const updateCommand = isCliOlder ? `npm install -g uloop-cli@${serverVersion}` : `Update ${PRODUCT_DISPLAY_NAME} package to ${cliVersion} via Unity Package Manager`;
   console.error("\x1B[33m\u26A0\uFE0F Version mismatch detected!\x1B[0m");
   console.error(`   uloop-cli version:    ${cliVersion}`);
   console.error(`   uloop server version: ${serverVersion}`);
@@ -7236,8 +7238,8 @@ function getProjectSkillsDir(target) {
   }
   if (!status.hasUloop) {
     throw new Error(
-      `uLoopMCP is not installed in this Unity project (${status.path}).
-Please install uLoopMCP package first, then run this command again.`
+      `${PRODUCT_DISPLAY_NAME} is not installed in this Unity project (${status.path}).
+Please install ${PRODUCT_DISPLAY_NAME} package first, then run this command again.`
     );
   }
   return (0, import_path8.join)(status.path, target.projectDir, "skills");
@@ -9065,10 +9067,10 @@ program2.option("--list-commands", "List all command names (for shell completion
 program2.option("--list-options <cmd>", "List options for a command (for shell completion)");
 program2.commandsGroup(HELP_GROUP_CLI_COMMANDS);
 program2.helpCommand(true);
-program2.command("list").description("List all available tools from Unity").option("-p, --port <port>", "Unity TCP port").option("--project-path <path>", "Unity project path").action(async (options) => {
+program2.command("list").description("List all available tools from Unity").addOption(createHiddenPortOption()).option("--project-path <path>", "Unity project path").action(async (options) => {
   await runWithErrorHandling(() => listAvailableTools(extractGlobalOptions(options)));
 });
-program2.command("sync").description("Sync tool definitions from Unity to local cache").option("-p, --port <port>", "Unity TCP port").option("--project-path <path>", "Unity project path").action(async (options) => {
+program2.command("sync").description("Sync tool definitions from Unity to local cache").addOption(createHiddenPortOption()).option("--project-path <path>", "Unity project path").action(async (options) => {
   await runWithErrorHandling(() => syncTools(extractGlobalOptions(options)));
 });
 program2.command("completion").description("Setup shell completion").option("--install", "Install completion to shell config file").option("--shell <type>", "Shell type: bash, zsh, or powershell").action((options) => {
@@ -9103,7 +9105,7 @@ function registerToolCommand(tool, helpGroup) {
       cmd.option(optionStr, description);
     }
   }
-  cmd.option("-p, --port <port>", "Unity TCP port");
+  cmd.addOption(createHiddenPortOption());
   cmd.option("--project-path <path>", "Unity project path");
   cmd.action(async (options) => {
     const params = buildParams(options, properties);
@@ -9212,6 +9214,9 @@ function convertValue(value, propInfo) {
 function getToolHelpGroup(toolName, defaultToolNames) {
   return defaultToolNames.has(toolName) ? HELP_GROUP_BUILTIN_TOOLS : HELP_GROUP_THIRD_PARTY_TOOLS;
 }
+function createHiddenPortOption() {
+  return new Option("-p, --port <port>", "Unity TCP port").hideHelp();
+}
 function extractGlobalOptions(options) {
   return {
     port: options["port"],
@@ -9227,7 +9232,8 @@ function printToolDisabledError(cmdName) {
 }
 function printConnectionError() {
   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.");
 }
@@ -9275,7 +9281,7 @@ async function runWithErrorHandling(fn) {
       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);
     }