@alpsckr/unitycli 0.4.4 → 0.5.0

package/extensions/vfx-graph/bridge/domains/vfx.ts

@@ -2,33 +2,33 @@ import { boolFlag, compactArgs, floatFlag, numberFlag, stringFlag, targetArgs }
 import type { BridgeCommandSpec, BridgeFlags } from "../types.js";
 
 export const vfxBridgeSpecs: BridgeCommandSpec[] = markToolsOnly([
-  { group: "vfx", command: "graph.info", bridgeCommand: "project-tool.run", toolName: "vfx.graph.info", buildArgs: vfxGraphInfoArgs },
-  { group: "vfx", command: "graph.create", bridgeCommand: "project-tool.run", toolName: "vfx.graph.create", buildArgs: vfxGraphCreateArgs, destructiveHint: true, supportsDryRun: true },
-  { group: "vfx", command: "effect.info", bridgeCommand: "project-tool.run", toolName: "vfx.effect.info", buildArgs: vfxTargetArgs },
-  { group: "vfx", command: "effect.add", bridgeCommand: "project-tool.run", toolName: "vfx.effect.add", buildArgs: vfxEffectGraphArgs },
-  { group: "vfx", command: "effect.assign", bridgeCommand: "project-tool.run", toolName: "vfx.effect.assign", buildArgs: vfxEffectGraphArgs },
-  { group: "vfx", command: "parameter", bridgeCommand: "project-tool.run", toolName: "vfx.parameter", buildArgs: vfxParameterArgs },
-  { group: "vfx", command: "control.play", bridgeCommand: "project-tool.run", toolName: "vfx.control.play", buildArgs: vfxTargetArgs },
-  { group: "vfx", command: "control.stop", bridgeCommand: "project-tool.run", toolName: "vfx.control.stop", buildArgs: vfxTargetArgs },
-  { group: "vfx", command: "control.pause", bridgeCommand: "project-tool.run", toolName: "vfx.control.pause", buildArgs: vfxTargetArgs },
-  { group: "vfx", command: "control.reinitialize", bridgeCommand: "project-tool.run", toolName: "vfx.control.reinitialize", buildArgs: vfxTargetArgs },
-  { group: "vfx", command: "control.set-rate", bridgeCommand: "project-tool.run", toolName: "vfx.control.set-rate", buildArgs: vfxControlRateArgs },
-  { group: "vfx", command: "control.set-seed", bridgeCommand: "project-tool.run", toolName: "vfx.control.set-seed", buildArgs: vfxControlSeedArgs },
-  { group: "vfx", command: "template.list", bridgeCommand: "project-tool.run", toolName: "vfx.template.list", buildArgs: vfxEmptyArgs },
-  { group: "vfx", command: "template.create", bridgeCommand: "project-tool.run", toolName: "vfx.template.create", buildArgs: vfxTemplateCreateArgs, destructiveHint: true, supportsDryRun: true },
-  { group: "vfx", command: "particle-create", bridgeCommand: "project-tool.run", toolName: "vfx.particle-create", buildArgs: vfxParticleArgs },
-  { group: "vfx", command: "particle-info", bridgeCommand: "project-tool.run", toolName: "vfx.particle-info", buildArgs: vfxParticleInfoArgs },
-  { group: "vfx", command: "particle-main", bridgeCommand: "project-tool.run", toolName: "vfx.particle-main", buildArgs: vfxParticleMainArgs },
-  { group: "vfx", command: "particle-emission", bridgeCommand: "project-tool.run", toolName: "vfx.particle-emission", buildArgs: vfxParticleEmissionArgs },
-  { group: "vfx", command: "particle-shape", bridgeCommand: "project-tool.run", toolName: "vfx.particle-shape", buildArgs: vfxParticleShapeArgs },
-  { group: "vfx", command: "particle.play", bridgeCommand: "project-tool.run", toolName: "vfx.particle.play", buildArgs: vfxParticleActionArgs },
-  { group: "vfx", command: "particle.stop", bridgeCommand: "project-tool.run", toolName: "vfx.particle.stop", buildArgs: vfxParticleStopArgs },
-  { group: "vfx", command: "particle.pause", bridgeCommand: "project-tool.run", toolName: "vfx.particle.pause", buildArgs: vfxParticleActionArgs },
-  { group: "vfx", command: "particle.clear", bridgeCommand: "project-tool.run", toolName: "vfx.particle.clear", buildArgs: vfxParticleActionArgs },
-  { group: "vfx", command: "line-create", bridgeCommand: "project-tool.run", toolName: "vfx.line-create", buildArgs: vfxLineCreateArgs },
-  { group: "vfx", command: "line-positions", bridgeCommand: "project-tool.run", toolName: "vfx.line-positions", buildArgs: vfxLinePositionsArgs },
-  { group: "vfx", command: "trail.create", bridgeCommand: "project-tool.run", toolName: "vfx.trail.create", buildArgs: vfxTrailCreateArgs },
-  { group: "vfx", command: "trail.set", bridgeCommand: "project-tool.run", toolName: "vfx.trail.set", buildArgs: vfxTrailSetArgs }
+  { group: "vfx", command: "graph.info", bridgeCommand: "catalog.editor.run", toolName: "vfx.graph.info", buildArgs: vfxGraphInfoArgs },
+  { group: "vfx", command: "graph.create", bridgeCommand: "catalog.editor.run", toolName: "vfx.graph.create", buildArgs: vfxGraphCreateArgs, destructiveHint: true, supportsDryRun: true },
+  { group: "vfx", command: "effect.info", bridgeCommand: "catalog.editor.run", toolName: "vfx.effect.info", buildArgs: vfxTargetArgs },
+  { group: "vfx", command: "effect.add", bridgeCommand: "catalog.editor.run", toolName: "vfx.effect.add", buildArgs: vfxEffectGraphArgs },
+  { group: "vfx", command: "effect.assign", bridgeCommand: "catalog.editor.run", toolName: "vfx.effect.assign", buildArgs: vfxEffectGraphArgs },
+  { group: "vfx", command: "parameter", bridgeCommand: "catalog.editor.run", toolName: "vfx.parameter", buildArgs: vfxParameterArgs },
+  { group: "vfx", command: "control.play", bridgeCommand: "catalog.editor.run", toolName: "vfx.control.play", buildArgs: vfxTargetArgs },
+  { group: "vfx", command: "control.stop", bridgeCommand: "catalog.editor.run", toolName: "vfx.control.stop", buildArgs: vfxTargetArgs },
+  { group: "vfx", command: "control.pause", bridgeCommand: "catalog.editor.run", toolName: "vfx.control.pause", buildArgs: vfxTargetArgs },
+  { group: "vfx", command: "control.reinitialize", bridgeCommand: "catalog.editor.run", toolName: "vfx.control.reinitialize", buildArgs: vfxTargetArgs },
+  { group: "vfx", command: "control.set-rate", bridgeCommand: "catalog.editor.run", toolName: "vfx.control.set-rate", buildArgs: vfxControlRateArgs },
+  { group: "vfx", command: "control.set-seed", bridgeCommand: "catalog.editor.run", toolName: "vfx.control.set-seed", buildArgs: vfxControlSeedArgs },
+  { group: "vfx", command: "template.list", bridgeCommand: "catalog.editor.run", toolName: "vfx.template.list", buildArgs: vfxEmptyArgs },
+  { group: "vfx", command: "template.create", bridgeCommand: "catalog.editor.run", toolName: "vfx.template.create", buildArgs: vfxTemplateCreateArgs, destructiveHint: true, supportsDryRun: true },
+  { group: "vfx", command: "particle-create", bridgeCommand: "catalog.editor.run", toolName: "vfx.particle-create", buildArgs: vfxParticleArgs },
+  { group: "vfx", command: "particle-info", bridgeCommand: "catalog.editor.run", toolName: "vfx.particle-info", buildArgs: vfxParticleInfoArgs },
+  { group: "vfx", command: "particle-main", bridgeCommand: "catalog.editor.run", toolName: "vfx.particle-main", buildArgs: vfxParticleMainArgs },
+  { group: "vfx", command: "particle-emission", bridgeCommand: "catalog.editor.run", toolName: "vfx.particle-emission", buildArgs: vfxParticleEmissionArgs },
+  { group: "vfx", command: "particle-shape", bridgeCommand: "catalog.editor.run", toolName: "vfx.particle-shape", buildArgs: vfxParticleShapeArgs },
+  { group: "vfx", command: "particle.play", bridgeCommand: "catalog.editor.run", toolName: "vfx.particle.play", buildArgs: vfxParticleActionArgs },
+  { group: "vfx", command: "particle.stop", bridgeCommand: "catalog.editor.run", toolName: "vfx.particle.stop", buildArgs: vfxParticleStopArgs },
+  { group: "vfx", command: "particle.pause", bridgeCommand: "catalog.editor.run", toolName: "vfx.particle.pause", buildArgs: vfxParticleActionArgs },
+  { group: "vfx", command: "particle.clear", bridgeCommand: "catalog.editor.run", toolName: "vfx.particle.clear", buildArgs: vfxParticleActionArgs },
+  { group: "vfx", command: "line-create", bridgeCommand: "catalog.editor.run", toolName: "vfx.line-create", buildArgs: vfxLineCreateArgs },
+  { group: "vfx", command: "line-positions", bridgeCommand: "catalog.editor.run", toolName: "vfx.line-positions", buildArgs: vfxLinePositionsArgs },
+  { group: "vfx", command: "trail.create", bridgeCommand: "catalog.editor.run", toolName: "vfx.trail.create", buildArgs: vfxTrailCreateArgs },
+  { group: "vfx", command: "trail.set", bridgeCommand: "catalog.editor.run", toolName: "vfx.trail.set", buildArgs: vfxTrailSetArgs }
 ]);
 
 function markToolsOnly(specs: BridgeCommandSpec[]): BridgeCommandSpec[] {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alpsckr/unitycli",
-  "version": "0.4.4",
+  "version": "0.5.0",
   "description": "Windows-first CLI for UnityCLI automation.",
   "type": "module",
   "bin": {

package/skills/unitycli/SKILL.md

@@ -55,7 +55,7 @@ PowerShell 中以单引号包住内联 JSON 和 `tools search '<k1|k2|...>'`。
 
 ## 能力扩展
 
-现有 Tool 不适合时，先判断是否真的需要 Unity 侧执行。普通源码或文本仍可直接处理；有界的临时 Unity 内存或 Editor API 逻辑可以考虑 `code.exec`。同步 C# 开始后不能由 CLI timeout 中止，复杂等待或不确定终态先读 `references/operation-protocol.md`。
+现有 Tool 不适合时，先判断是否真的需要 Unity 侧执行。普通源码或文本仍可直接处理；有界的临时 Unity 内存或 Editor API 逻辑可以考虑 `code.execute`。同步 C# 开始后不能由 CLI timeout 中止，复杂等待或不确定终态先读 `references/operation-protocol.md`。
 
 当能力需要稳定发现、typed schema、结构化结果、明确副作用、重复使用或团队共享时，读取 `references/custom-tools.md` 并实现项目自定义 `IUnityCliTool<TReq,TRes>`。自定义 Tool 仍从当前 catalog 发现、describe 和调用，不假设名称、group 或输入。
 

package/skills/unitycli/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "unitycli",
-  "version": "0.4.4",
+  "version": "0.5.0",
   "owner": "alps-unity-cli maintainers",
   "updated_at": "2026-08-27",
   "status": "active",

package/skills/unitycli/references/operation-protocol.md

@@ -69,7 +69,7 @@ compile、import、domain reload和listener generation交接由session superviso
 
 `editor.state`公开状态固定为`ready|transitioning|blocked|unresponsive|unverifiable|offline|conflict`。它与`editor.dialogs`、`editor.dialog.click`是仅有的三个exact观察名称：使用冻结本地descriptor进入统一dispatcher，不依赖可能被阻断的Live catalog或普通业务admission；alias、group、handler和其他offline Tool不继承该路径。`tools describe`可精确学习这三个descriptor。三者仍执行schema、availability、completion和结果校验，共用从dispatch开始的一份absolute deadline；`editor.state`只可发出一次private snapshot观察，dialogs仅Windows可用。`conflict`只表示至少两个verified live claim；身份读取失败使用`unverifiable`，transport存在但主线程不推进使用`unresponsive`。原错误包含`details.blockers`时，先`tools run editor.dialogs`。点击前使用当前返回的dialogId和规范化button label；只能选择当前可见且enabled的按钮。点击会保留最小pre-effect预算，deadline先到会关闭首次effect barrier；点击后必须证明弹窗消失或状态改变。
 
-`build.run`、`test.run`、`editor.refresh`、`code.exec` 和需要刷新 Editor 的 Package Tool 在一次调用内等待最终业务结果。超时只表示该次调用没有可信终态，后续动作由调用方决定。`code.exec`的同步C#一旦在Unity主线程开始，timeout不能中止它；死循环、阻塞等待或长期Unity API调用可继续占用Editor。调用方应先判断这类代码是否确有必要；决定执行后应把timeout视为outcome unknown并在重试前观察业务状态。
+`build.run`、`test.run`、`editor.refresh`、`code.execute` 和需要刷新 Editor 的 Package Tool 在一次调用内等待最终业务结果。超时只表示该次调用没有可信终态，后续动作由调用方决定。`code.execute`的同步C#一旦在Unity主线程开始，timeout不能中止它；死循环、阻塞等待或长期Unity API调用可继续占用Editor。调用方应先判断这类代码是否确有必要；决定执行后应把timeout视为outcome unknown并在重试前观察业务状态。
 
 ## 扩展与安装
 

package/unitypkg/Editor/Bridge/BridgeHttpServer.cs

@@ -429,9 +429,9 @@ namespace UnityCli
                 var allowedDuringPlayModeTransition = UnityCliDurableStatusCoordinator.IsCommand(request.Command) || UnityCliCompileCoordinator.IsCommand(request.Command) || UnityCliLiveRefreshCoordinator.IsCommand(request.Command) || UnityCliAssetRefreshCoordinator.IsCommand(request.Command) || UnityCliPackageEmbedCoordinator.IsCommand(request.Command) || UnityCliPackageResolveCoordinator.IsCommand(request.Command) || UnityCliTestRunCoordinator.IsCommand(request.Command) || UnityCliNavMeshBakeCoordinator.IsCommand(request.Command) || UnityCliOcclusionBakeCoordinator.IsCommand(request.Command)
                     || IsEditorStateSnapshotCommand(request.Command)
                     || request.Command == "editor.pause"
-                    || request.Command == "editor.stop"
+                    || request.Command == "editor.play-mode.stop"
                     || IsProjectToolCatalogReadCommand(request.Command)
-                    || request.Command == "runtime-tool.run"
+                    || request.Command == "catalog.player.run"
                     || IsDoctorAdmissionBypassCommand(request.Command);
 
                 WriteLog("http_play_mode_guard requestId=" + request.RequestId + " command=" + request.Command + " cachedIsPlayingOrWillChange=" + Bool(cachedIsPlayingOrWillChangePlaymode) + " cachedIsPlaying=" + Bool(cachedIsPlaying) + " transitionAllowed=" + Bool(allowedDuringPlayModeTransition));

package/unitypkg/Editor/Commands/ProjectToolCommands.cs

@@ -30,14 +30,14 @@ namespace UnityCli
     {
         private static void RegisterProjectToolCommands(BridgeCommandRegistry registry)
         {
-            RegisterCommand(registry, "project-tool.health", "project-tool", false, ProjectToolCatalogHealth);
-            RegisterCommand(registry, "project-tool.groups", "project-tool", false, ProjectToolGroups);
-            RegisterCommand(registry, "project-tool.summary", "project-tool", false, ProjectToolSummary);
-            RegisterCommand(registry, "project-tool.describe", "project-tool", false, ProjectToolDescribe);
-            RegisterCommand(registry, "project-tool.list", "project-tool", false, ProjectToolList);
+            RegisterCommand(registry, "catalog.editor.health", "catalog", false, ProjectToolCatalogHealth);
+            RegisterCommand(registry, "catalog.editor.groups", "catalog", false, ProjectToolGroups);
+            RegisterCommand(registry, "catalog.editor.summary", "catalog", false, ProjectToolSummary);
+            RegisterCommand(registry, "catalog.editor.describe", "catalog", false, ProjectToolDescribe);
+            RegisterCommand(registry, "catalog.editor.list", "catalog", false, ProjectToolList);
             registry.Register<UnityCli.Protocol.BridgeRequest>(
-                "project-tool.run",
-                "project-tool",
+                "catalog.editor.run",
+                "catalog",
                 false,
                 60000,
                 ProjectToolRun);

package/unitypkg/Editor/Commands/RuntimeToolCommands.cs

@@ -30,13 +30,13 @@ namespace UnityCli
     {
         private static void RegisterRuntimeToolCommands(BridgeCommandRegistry registry)
         {
-            RegisterCommand(registry, "runtime-tool.groups", "runtime-tool", false, RuntimeToolGroups);
-            RegisterCommand(registry, "runtime-tool.summary", "runtime-tool", false, RuntimeToolSummary);
-            RegisterCommand(registry, "runtime-tool.describe", "runtime-tool", false, RuntimeToolDescribe);
-            RegisterCommand(registry, "runtime-tool.list", "runtime-tool", false, RuntimeToolList);
+            RegisterCommand(registry, "catalog.player.groups", "catalog", false, RuntimeToolGroups);
+            RegisterCommand(registry, "catalog.player.summary", "catalog", false, RuntimeToolSummary);
+            RegisterCommand(registry, "catalog.player.describe", "catalog", false, RuntimeToolDescribe);
+            RegisterCommand(registry, "catalog.player.list", "catalog", false, RuntimeToolList);
             registry.Register<UnityCli.Protocol.BridgeRequest>(
-                "runtime-tool.run",
-                "runtime-tool",
+                "catalog.player.run",
+                "catalog",
                 false,
                 60000,
                 RuntimeToolRun);