@alpsckr/unitycli 0.4.2 → 0.4.4

package/README.md

@@ -112,7 +112,7 @@ unitycli tools describe editor.state --instance C:\path\UnityProject
 unitycli tools run editor.state --input '{}' --instance C:\path\UnityProject
 ```
 
-Do not guess Tool names or inputs. Discover the current catalog, read one descriptor, then call that exact Tool. `command <name>` is a schema-argument projection of the same live catalog, not a second capability system.
+Do not guess Tool names or inputs. Discover the current catalog, read one descriptor, then call that exact Tool. `command <name>` is a schema-argument projection of the same live catalog, not a second capability system. 调用方明确要求的业务值优先于schema default和example值；不要把default或example当作连通性、probe或smoke调用。
 
 Optional extensions use their dedicated control plane:
 
@@ -126,9 +126,9 @@ unitycli extensions doctor --project C:\path\UnityProject
 Discovery lists default to 20 items, allow at most 100, and continue with `pageInfo.nextCursor`:
 
 ```powershell
-unitycli tools group list <group> --page-size 20 --instance <id|projectPath|alias>
-unitycli tools search '<k1|k2|...>' --page-size 20 --instance <id|projectPath|alias>
-unitycli command --project-path C:\path\UnityProject --page-size 20
+unitycli tools group list <group> --page-size 20 --cursor <nextCursor> --instance <id|projectPath|alias>
+unitycli tools search '<k1|k2|...>' --page-size 20 --cursor <nextCursor> --instance <id|projectPath|alias>
+unitycli command --project-path C:\path\UnityProject --page-size 20 --cursor <nextCursor>
 ```
 
 In PowerShell, quote pipe-separated search keywords with single quotes.
@@ -149,7 +149,7 @@ Failure:
 {"ok":false,"requestId":"req-...","error":{"code":"...","message":"...","nextActions":[],"transient":false,"retryAfterMs":0}}
 ```
 
-Follow structured `nextActions`. With `--timeout-ms T`, use a host budget of at least `2 * T + 5000` milliseconds and wait for the unitycli process to exit. `E_EXECUTION_TIMEOUT` means no trusted terminal result; timeout does not stop Unity effects or synchronous C# already running. Inspect business state before deciding whether to submit a new mutation.
+Follow structured `nextActions`. With `--timeout-ms T`, use a host budget of at least `2 * T + 5000` milliseconds and wait for the unitycli process to exit. `E_EXECUTION_TIMEOUT` means no trusted terminal result; timeout does not stop Unity effects or synchronous C# already running. For `asset.refresh`, player build, Play Mode, Package installation (including exact version changes), Package removal, and `test.run`, discover the matching domain `.status` Tool and pass the original root `requestId`; status reads the same-session active phase or exact terminal without replaying the effect. Otherwise inspect business state before deciding whether to submit a new mutation.
 
 ## Update And Remove
 

package/contracts/command-contract.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "generatedFrom": "unified C#/TS/metadata command contract",
+  "generatedFrom": "canonical C#/TS source inventory and metadata",
   "commands": [
     {
       "bridgeCommand": "animation.clip",
@@ -227,6 +227,15 @@
       "destructive": false,
       "timeout": 30000
     },
+    {
+      "bridgeCommand": "asset.refresh.status",
+      "group": "asset",
+      "command": "refresh.status",
+      "handler_type": "hybrid",
+      "csharp_handler": "none",
+      "destructive": false,
+      "timeout": 30000
+    },
     {
       "bridgeCommand": "asset.rename",
       "group": "asset",
@@ -272,6 +281,15 @@
       "destructive": true,
       "timeout": 30000
     },
+    {
+      "bridgeCommand": "build.player.status",
+      "group": "build",
+      "command": "player.status",
+      "handler_type": "hybrid",
+      "csharp_handler": "none",
+      "destructive": false,
+      "timeout": 30000
+    },
     {
       "bridgeCommand": "build.profile.create",
       "group": "build",
@@ -800,24 +818,6 @@
       "destructive": true,
       "timeout": 30000
     },
-    {
-      "bridgeCommand": "diagnose.capabilities",
-      "group": "diagnose",
-      "command": "capabilities",
-      "handler_type": "offline",
-      "csharp_handler": "none",
-      "destructive": false,
-      "timeout": 30000
-    },
-    {
-      "bridgeCommand": "diagnose.preflight",
-      "group": "diagnose",
-      "command": "preflight",
-      "handler_type": "bridge",
-      "csharp_handler": "present",
-      "destructive": false,
-      "timeout": 30000
-    },
     {
       "bridgeCommand": "docs.get",
       "group": "docs",
@@ -872,15 +872,6 @@
       "destructive": false,
       "timeout": 120000
     },
-    {
-      "bridgeCommand": "editor.console",
-      "group": "editor",
-      "command": "console",
-      "handler_type": "bridge",
-      "csharp_handler": "present",
-      "destructive": false,
-      "timeout": 30000
-    },
     {
       "bridgeCommand": "editor.dialog.click",
       "group": "editor",
@@ -944,6 +935,15 @@
       "destructive": false,
       "timeout": 30000
     },
+    {
+      "bridgeCommand": "editor.play-mode.status",
+      "group": "editor",
+      "command": "play-mode.status",
+      "handler_type": "hybrid",
+      "csharp_handler": "none",
+      "destructive": false,
+      "timeout": 30000
+    },
     {
       "bridgeCommand": "editor.redo",
       "group": "editor",
@@ -1043,15 +1043,6 @@
       "destructive": false,
       "timeout": 30000
     },
-    {
-      "bridgeCommand": "extension.status",
-      "group": "extension",
-      "command": "status",
-      "handler_type": "bridge",
-      "csharp_handler": "present",
-      "destructive": false,
-      "timeout": 30000
-    },
     {
       "bridgeCommand": "go.create",
       "group": "go",
@@ -1088,15 +1079,6 @@
       "destructive": false,
       "timeout": 30000
     },
-    {
-      "bridgeCommand": "go.inspect",
-      "group": "go",
-      "command": "inspect",
-      "handler_type": "bridge",
-      "csharp_handler": "present",
-      "destructive": false,
-      "timeout": 30000
-    },
     {
       "bridgeCommand": "go.look-at",
       "group": "go",
@@ -1205,15 +1187,6 @@
       "destructive": false,
       "timeout": 30000
     },
-    {
-      "bridgeCommand": "graphics.pipeline-quality",
-      "group": "graphics",
-      "command": "pipeline-quality",
-      "handler_type": "bridge",
-      "csharp_handler": "present",
-      "destructive": true,
-      "timeout": 30000
-    },
     {
       "bridgeCommand": "graphics.pipeline-settings",
       "group": "graphics",
@@ -1223,15 +1196,6 @@
       "destructive": true,
       "timeout": 30000
     },
-    {
-      "bridgeCommand": "graphics.probe-positions",
-      "group": "graphics",
-      "command": "probe-positions",
-      "handler_type": "bridge",
-      "csharp_handler": "present",
-      "destructive": false,
-      "timeout": 30000
-    },
     {
       "bridgeCommand": "graphics.quality",
       "group": "graphics",
@@ -1259,15 +1223,6 @@
       "destructive": false,
       "timeout": 30000
     },
-    {
-      "bridgeCommand": "graphics.settings",
-      "group": "graphics",
-      "command": "settings",
-      "handler_type": "bridge",
-      "csharp_handler": "present",
-      "destructive": true,
-      "timeout": 30000
-    },
     {
       "bridgeCommand": "graphics.skybox-get",
       "group": "graphics",
@@ -1340,24 +1295,6 @@
       "destructive": false,
       "timeout": 30000
     },
-    {
-      "bridgeCommand": "graphics.stats-counters",
-      "group": "graphics",
-      "command": "stats-counters",
-      "handler_type": "bridge",
-      "csharp_handler": "present",
-      "destructive": false,
-      "timeout": 30000
-    },
-    {
-      "bridgeCommand": "graphics.stats-memory",
-      "group": "graphics",
-      "command": "stats-memory",
-      "handler_type": "bridge",
-      "csharp_handler": "present",
-      "destructive": false,
-      "timeout": 30000
-    },
     {
       "bridgeCommand": "graphics.volume",
       "group": "graphics",
@@ -1451,15 +1388,6 @@
         "com.unity.render-pipelines.high-definition"
       ]
     },
-    {
-      "bridgeCommand": "instances.list",
-      "group": "instances",
-      "command": "list",
-      "handler_type": "bridge",
-      "csharp_handler": "present",
-      "destructive": false,
-      "timeout": 30000
-    },
     {
       "bridgeCommand": "material.assign",
       "group": "material",
@@ -1652,15 +1580,6 @@
       "destructive": true,
       "timeout": 120000
     },
-    {
-      "bridgeCommand": "package.info",
-      "group": "package",
-      "command": "info",
-      "handler_type": "offline",
-      "csharp_handler": "none",
-      "destructive": false,
-      "timeout": 30000
-    },
     {
       "bridgeCommand": "package.install",
       "group": "package",
@@ -1671,10 +1590,10 @@
       "timeout": 120000
     },
     {
-      "bridgeCommand": "package.list",
+      "bridgeCommand": "package.install.status",
       "group": "package",
-      "command": "list",
-      "handler_type": "offline",
+      "command": "install.status",
+      "handler_type": "hybrid",
       "csharp_handler": "none",
       "destructive": false,
       "timeout": 30000
@@ -1688,15 +1607,6 @@
       "destructive": true,
       "timeout": 30000
     },
-    {
-      "bridgeCommand": "package.registry.get",
-      "group": "package",
-      "command": "registry.get",
-      "handler_type": "offline",
-      "csharp_handler": "none",
-      "destructive": false,
-      "timeout": 30000
-    },
     {
       "bridgeCommand": "package.registry.set",
       "group": "package",
@@ -1715,6 +1625,15 @@
       "destructive": true,
       "timeout": 120000
     },
+    {
+      "bridgeCommand": "package.remove.status",
+      "group": "package",
+      "command": "remove.status",
+      "handler_type": "hybrid",
+      "csharp_handler": "none",
+      "destructive": false,
+      "timeout": 30000
+    },
     {
       "bridgeCommand": "package.resolve",
       "group": "package",
@@ -1742,15 +1661,6 @@
       "destructive": true,
       "timeout": 30000
     },
-    {
-      "bridgeCommand": "package.scoped-registry.list",
-      "group": "package",
-      "command": "scoped-registry.list",
-      "handler_type": "offline",
-      "csharp_handler": "none",
-      "destructive": false,
-      "timeout": 30000
-    },
     {
       "bridgeCommand": "package.scoped-registry.remove",
       "group": "package",
@@ -1760,24 +1670,6 @@
       "destructive": true,
       "timeout": 30000
     },
-    {
-      "bridgeCommand": "package.search",
-      "group": "package",
-      "command": "search",
-      "handler_type": "offline",
-      "csharp_handler": "none",
-      "destructive": false,
-      "timeout": 30000
-    },
-    {
-      "bridgeCommand": "package.status",
-      "group": "package",
-      "command": "status",
-      "handler_type": "offline",
-      "csharp_handler": "none",
-      "destructive": false,
-      "timeout": 30000
-    },
     {
       "bridgeCommand": "physics.assign-material",
       "group": "physics",
@@ -1859,15 +1751,6 @@
       "destructive": false,
       "timeout": 30000
     },
-    {
-      "bridgeCommand": "physics.raycast-all",
-      "group": "physics",
-      "command": "raycast-all",
-      "handler_type": "bridge",
-      "csharp_handler": "present",
-      "destructive": false,
-      "timeout": 30000
-    },
     {
       "bridgeCommand": "physics.rigidbody",
       "group": "physics",
@@ -2507,7 +2390,7 @@
       "command": "memory-snapshot.take",
       "handler_type": "bridge",
       "csharp_handler": "present",
-      "destructive": true,
+      "destructive": false,
       "timeout": 30000,
       "requires_packages": [
         "com.unity.memoryprofiler"
@@ -2594,6 +2477,33 @@
       "destructive": false,
       "timeout": 30000
     },
+    {
+      "bridgeCommand": "project-tool.describe",
+      "group": "project-tool",
+      "command": "describe",
+      "handler_type": "bridge",
+      "csharp_handler": "present",
+      "destructive": false,
+      "timeout": 30000
+    },
+    {
+      "bridgeCommand": "project-tool.groups",
+      "group": "project-tool",
+      "command": "groups",
+      "handler_type": "bridge",
+      "csharp_handler": "present",
+      "destructive": false,
+      "timeout": 30000
+    },
+    {
+      "bridgeCommand": "project-tool.health",
+      "group": "project-tool",
+      "command": "health",
+      "handler_type": "bridge",
+      "csharp_handler": "present",
+      "destructive": false,
+      "timeout": 30000
+    },
     {
       "bridgeCommand": "project-tool.list",
       "group": "project-tool",
@@ -2612,6 +2522,15 @@
       "destructive": false,
       "timeout": 30000
     },
+    {
+      "bridgeCommand": "project-tool.summary",
+      "group": "project-tool",
+      "command": "summary",
+      "handler_type": "bridge",
+      "csharp_handler": "present",
+      "destructive": false,
+      "timeout": 30000
+    },
     {
       "bridgeCommand": "project.audio-settings",
       "group": "project",
@@ -2792,6 +2711,24 @@
       "destructive": false,
       "timeout": 30000
     },
+    {
+      "bridgeCommand": "runtime-tool.describe",
+      "group": "runtime-tool",
+      "command": "describe",
+      "handler_type": "bridge",
+      "csharp_handler": "present",
+      "destructive": false,
+      "timeout": 30000
+    },
+    {
+      "bridgeCommand": "runtime-tool.groups",
+      "group": "runtime-tool",
+      "command": "groups",
+      "handler_type": "bridge",
+      "csharp_handler": "present",
+      "destructive": false,
+      "timeout": 30000
+    },
     {
       "bridgeCommand": "runtime-tool.list",
       "group": "runtime-tool",
@@ -2810,6 +2747,15 @@
       "destructive": false,
       "timeout": 30000
     },
+    {
+      "bridgeCommand": "runtime-tool.summary",
+      "group": "runtime-tool",
+      "command": "summary",
+      "handler_type": "bridge",
+      "csharp_handler": "present",
+      "destructive": false,
+      "timeout": 30000
+    },
     {
       "bridgeCommand": "runtime.console",
       "group": "runtime",
@@ -2897,15 +2843,6 @@
       "destructive": false,
       "timeout": 30000
     },
-    {
-      "bridgeCommand": "scene.build-settings",
-      "group": "scene",
-      "command": "build-settings",
-      "handler_type": "bridge",
-      "csharp_handler": "present",
-      "destructive": false,
-      "timeout": 30000
-    },
     {
       "bridgeCommand": "scene.create",
       "group": "scene",
@@ -2915,15 +2852,6 @@
       "destructive": true,
       "timeout": 30000
     },
-    {
-      "bridgeCommand": "scene.data",
-      "group": "scene",
-      "command": "data",
-      "handler_type": "bridge",
-      "csharp_handler": "present",
-      "destructive": false,
-      "timeout": 30000
-    },
     {
       "bridgeCommand": "scene.gameobject",
       "group": "scene",
@@ -3213,11 +3141,11 @@
       "timeout": 600000
     },
     {
-      "bridgeCommand": "tests.list",
-      "group": "tests",
-      "command": "list",
-      "handler_type": "bridge",
-      "csharp_handler": "present",
+      "bridgeCommand": "test.run.status",
+      "group": "test",
+      "command": "run.status",
+      "handler_type": "hybrid",
+      "csharp_handler": "none",
       "destructive": false,
       "timeout": 30000
     },
@@ -3332,42 +3260,6 @@
         "com.unity.timeline"
       ]
     },
-    {
-      "bridgeCommand": "tools.describe",
-      "group": "tools",
-      "command": "describe",
-      "handler_type": "offline",
-      "csharp_handler": "none",
-      "destructive": false,
-      "timeout": 30000
-    },
-    {
-      "bridgeCommand": "tools.group",
-      "group": "tools",
-      "command": "group",
-      "handler_type": "offline",
-      "csharp_handler": "none",
-      "destructive": false,
-      "timeout": 30000
-    },
-    {
-      "bridgeCommand": "tools.group-list",
-      "group": "tools",
-      "command": "group-list",
-      "handler_type": "offline",
-      "csharp_handler": "none",
-      "destructive": false,
-      "timeout": 30000
-    },
-    {
-      "bridgeCommand": "tools.search",
-      "group": "tools",
-      "command": "search",
-      "handler_type": "offline",
-      "csharp_handler": "none",
-      "destructive": false,
-      "timeout": 30000
-    },
     {
       "bridgeCommand": "type.schema",
       "group": "reflection",