@alpsckr/unitycli 0.4.5 → 0.5.0

package/unitypkg/Editor/Infrastructure/UnityCliOperationCoordinator.cs

@@ -242,7 +242,7 @@ namespace UnityCli
             });
         }
 
-        /// <summary>editor.play-mode.status只读取editor.play/editor.stop的direct owner或其已发布终态。</summary>
+        /// <summary>editor.play-mode.status只读取editor.play-mode.start/editor.play-mode.stop的direct owner或其已发布终态。</summary>
         private static object ReadEditorPlayModeStatus(string requestId)
         {
             string requestDigest;
@@ -250,14 +250,14 @@ namespace UnityCli
             object terminal;
             if (UnityCliActiveOperation.TryGetTerminalByRequestId(DirectMutationTerminalScope, requestId, out requestDigest, out statusDomain, out terminal))
             {
-                if (statusDomain != "editor.play" && statusDomain != "editor.stop")
+                if (statusDomain != "editor.play-mode.start" && statusDomain != "editor.play-mode.stop")
                     throw new BridgeCommandException("E_REQUEST_NOT_FOUND", "The requested Play Mode operation was not found in this status domain.");
                 return UnityCliDurableStatusCoordinator.Terminal(requestId, terminal);
             }
             var root = LoadDirectMutationRoot();
             var toolName = root == null ? null : root.ContainsKey("toolName") ? root["toolName"] as string : null;
             if (root == null || !string.Equals(root["requestId"] as string, requestId, StringComparison.Ordinal)
-                || (toolName != "editor.play" && toolName != "editor.stop"))
+                || (toolName != "editor.play-mode.start" && toolName != "editor.play-mode.stop"))
                 throw new BridgeCommandException("E_REQUEST_NOT_FOUND", "The requested Play Mode operation was not found in this Editor session.");
             return UnityCliDurableStatusCoordinator.Running(requestId, root["phase"] as string);
         }
@@ -270,7 +270,7 @@ namespace UnityCli
                 && !string.Equals(root["phase"] as string, "effect_started", StringComparison.Ordinal))
                 throw new BridgeCommandException("E_EXECUTION_TIMEOUT", "Direct mutation active state cannot cross its effect barrier.");
             var toolName = root["toolName"] as string;
-            if ((string.Equals(toolName, "editor.play", StringComparison.Ordinal) || string.Equals(toolName, "editor.stop", StringComparison.Ordinal))
+            if ((string.Equals(toolName, "editor.play-mode.start", StringComparison.Ordinal) || string.Equals(toolName, "editor.play-mode.stop", StringComparison.Ordinal))
                 && !root.ContainsKey("playModeWasPlaying"))
                 root["playModeWasPlaying"] = EditorApplication.isPlaying;
             root["phase"] = "effect_started";
@@ -376,7 +376,7 @@ namespace UnityCli
             catch (BridgeCommandException exception) { return SerializeBridgeExceptionEnvelope(requestId, exception); }
             var toolName = root["toolName"] as string;
             if (string.Equals(phase, "effect_started", StringComparison.Ordinal)
-                && (string.Equals(toolName, "editor.play", StringComparison.Ordinal) || string.Equals(toolName, "editor.stop", StringComparison.Ordinal)))
+                && (string.Equals(toolName, "editor.play-mode.start", StringComparison.Ordinal) || string.Equals(toolName, "editor.play-mode.stop", StringComparison.Ordinal)))
             {
                 if (!TryFinalizeRecoveredPlayModeRoot(
                     ProductionQueueState, requestId, requestDigest,
@@ -495,7 +495,7 @@ namespace UnityCli
                 try { root = LoadDirectMutationRoot(); }
                 catch { root = null; }
                 var toolName = root == null ? null : root["toolName"] as string;
-                if (toolName != "editor.play" && toolName != "editor.stop")
+                if (toolName != "editor.play-mode.start" && toolName != "editor.play-mode.stop")
                     finalized = TryResumeDirectMutation(requestId, requestDigest) != null;
             }
             if (finalized)
@@ -542,8 +542,8 @@ namespace UnityCli
             catch { return false; }
             if (!string.Equals(root["phase"] as string, "effect_started", StringComparison.Ordinal)) return false;
             var toolName = root["toolName"] as string;
-            var enterPlayMode = string.Equals(toolName, "editor.play", StringComparison.Ordinal);
-            if (!enterPlayMode && !string.Equals(toolName, "editor.stop", StringComparison.Ordinal)) return false;
+            var enterPlayMode = string.Equals(toolName, "editor.play-mode.start", StringComparison.Ordinal);
+            if (!enterPlayMode && !string.Equals(toolName, "editor.play-mode.stop", StringComparison.Ordinal)) return false;
 
             object beforeValue;
             object deadlineValue;
@@ -569,8 +569,8 @@ namespace UnityCli
                     IsPaused = isPaused
                 };
                 terminal = enterPlayMode
-                    ? (object)new EditorPlayTool.Response { Result = result, State = readState(), PlannedEffects = new List<EditorPlannedEffect> { new EditorPlannedEffect { Type = "editor.play" } } }
-                    : new EditorStopTool.Response { Result = result, State = readState(), PlannedEffects = new List<EditorPlannedEffect> { new EditorPlannedEffect { Type = "editor.stop" } } };
+                    ? (object)new EditorPlayModeStartTool.Response { Result = result, State = readState(), PlannedEffects = new List<EditorPlannedEffect> { new EditorPlannedEffect { Type = "editor.play-mode.start" } } }
+                    : new EditorPlayModeStopTool.Response { Result = result, State = readState(), PlannedEffects = new List<EditorPlannedEffect> { new EditorPlannedEffect { Type = "editor.play-mode.stop" } } };
                 PublishDirectMutationTerminal(state, requestId, requestDigest,
                     UnityCliSerializer.Serialize(ProtocolEnvelopeFactory.Success(requestId, terminal)));
             }
@@ -652,7 +652,7 @@ namespace UnityCli
             SessionState.SetBool(DirectMutationEffectCommittedSessionKey, true);
         }
 
-        /// <summary>code.exec等内部direct命令在首个用户effect前同样重验完整lease identity。</summary>
+        /// <summary>code.execute等内部direct命令在首个用户effect前同样重验完整lease identity。</summary>
         private static void BeginDirectEffect(string requestId)
         {
             var requestDigest = SessionState.GetString(DirectMutationRequestDigestSessionKey, string.Empty);
@@ -821,15 +821,15 @@ namespace UnityCli
             if (IsInstanceCleanupCommand(toolName)) return InstanceCleanupCompletionContract();
             UnityCliToolCompletionContract contract;
             if (UnityCliToolCompletionRegistry.TryGet(toolName, out contract)) return contract;
-            if (string.Equals(toolName, "code.exec", StringComparison.Ordinal))
+            if (string.Equals(toolName, "code.execute", StringComparison.Ordinal))
                 return UnityCliToolCompletionRegistry.CodeExec;
             return ResolveRegisteredCustomToolCompletionContract(toolName);
         }
 
         private static string RequestToolName(BridgeRequest request)
         {
-            if (request != null && (string.Equals(request.Command, "project-tool.run", StringComparison.Ordinal)
-                || string.Equals(request.Command, "runtime-tool.run", StringComparison.Ordinal)))
+            if (request != null && (string.Equals(request.Command, "catalog.editor.run", StringComparison.Ordinal)
+                || string.Equals(request.Command, "catalog.player.run", StringComparison.Ordinal)))
             {
                 var input = request.Input as IDictionary<string, object>;
                 object rawName;
@@ -868,7 +868,7 @@ namespace UnityCli
             if (IsInstanceCleanupCommand(toolName)) return InstanceCleanupCompletionContract();
             UnityCliToolCompletionContract contract;
             if (UnityCliToolCompletionRegistry.TryGet(toolName, out contract)) return contract;
-            return string.Equals(toolName, "code.exec", StringComparison.Ordinal) ? UnityCliToolCompletionRegistry.CodeExec : null;
+            return string.Equals(toolName, "code.execute", StringComparison.Ordinal) ? UnityCliToolCompletionRegistry.CodeExec : null;
         }
 
         private sealed class DurableMutationBarrierProof
@@ -906,8 +906,8 @@ namespace UnityCli
             var inputMutation = RequestMutationFromImmutableInput(contract.ToolName, input, out requiresSceneState);
             if (!requiresSceneState) return inputMutation;
             if (contract.ToolName == "physics.rigidbody") return RigidbodyNeedsMutation(input);
-            if (contract.ToolName == "graphics.reflection-probe") return CreateProbeNeedsMutation(input, true);
-            if (contract.ToolName == "graphics.light-probe-group") return CreateProbeNeedsMutation(input, false);
+            if (contract.ToolName == "lighting.reflection-probe") return CreateProbeNeedsMutation(input, true);
+            if (contract.ToolName == "lighting.light-probe-group") return CreateProbeNeedsMutation(input, false);
             return true;
         }
 
@@ -915,27 +915,27 @@ namespace UnityCli
         private static bool RequestMutationFromImmutableInput(string name, IDictionary<string, object> input, out bool requiresSceneState)
         {
             requiresSceneState = false;
-            if (name == "graphics.reflection-probe")
+            if (name == "lighting.reflection-probe")
             {
                 if (HasAnyMeaningfulInput(input, "mode", "resolution", "bounces", "hdr", "boxSize", "boxOffset")) return true;
                 requiresSceneState = InputBoolean(input, "create");
                 return false;
             }
-            if (name == "graphics.light-probe-group")
+            if (name == "lighting.light-probe-group")
             {
                 if (HasAnyMeaningfulInput(input, "positions")) return true;
                 requiresSceneState = InputBoolean(input, "create");
                 return false;
             }
-            if (name == "graphics.skybox-set-properties") return HasAllMeaningfulInput(input, "property", "value");
+            if (name == "lighting.skybox.set-properties") return HasAllMeaningfulInput(input, "property", "value");
             if (name == "build.settings.set") return HasAnyInput(input, "apiCompatibilityLevel", "applicationIdentifier", "bundleVersion", "companyId", "productName", "scriptingBackend");
-            if (name == "graphics.bake-settings") return HasAnyInput(input, "bakedGI", "bounces", "directSamples", "environmentSamples", "filtering", "indirectSamples", "lightingMode", "realtimeGI");
-            if (name == "graphics.quality") return HasAnyInput(input, "anisotropicFiltering", "antiAliasing", "lodBias", "masterTextureLimit", "maximumLODLevel", "qualityLevel", "realtimeReflectionProbes", "shadowDistance", "shadowResolution", "shadows", "softParticles", "vSyncCount");
-            if (name == "graphics.pipeline-settings") return HasAnyInput(input, "renderPipeline");
-            if (name == "graphics.skybox-set-ambient") return HasAnyMeaningfulInput(input, "ambientEquatorColor", "ambientGroundColor", "ambientSkyColor", "color", "intensity", "mode");
-            if (name == "graphics.skybox-set-fog") return HasAnyMeaningfulInput(input, "color", "density", "enabled", "endDistance", "mode", "startDistance");
-            if (name == "graphics.skybox-set-reflection") return HasAnyMeaningfulInput(input, "bounces", "intensity", "mode", "resolution");
-            if (name == "graphics.scene-debug") return HasAnyInput(input, "drawMode", "shadingMode");
+            if (name == "lighting.bake.settings") return HasAnyInput(input, "bakedGI", "bounces", "directSamples", "environmentSamples", "filtering", "indirectSamples", "lightingMode", "realtimeGI");
+            if (name == "rendering.quality") return HasAnyInput(input, "anisotropicFiltering", "antiAliasing", "lodBias", "masterTextureLimit", "maximumLODLevel", "qualityLevel", "realtimeReflectionProbes", "shadowDistance", "shadowResolution", "shadows", "softParticles", "vSyncCount");
+            if (name == "rendering.pipeline.settings") return HasAnyInput(input, "renderPipeline");
+            if (name == "lighting.skybox.set-ambient") return HasAnyMeaningfulInput(input, "ambientEquatorColor", "ambientGroundColor", "ambientSkyColor", "color", "intensity", "mode");
+            if (name == "lighting.skybox.set-fog") return HasAnyMeaningfulInput(input, "color", "density", "enabled", "endDistance", "mode", "startDistance");
+            if (name == "lighting.skybox.set-reflection") return HasAnyMeaningfulInput(input, "bounces", "intensity", "mode", "resolution");
+            if (name == "rendering.scene-debug") return HasAnyInput(input, "drawMode", "shadingMode");
             if (name == "physics.collision-matrix") return HasAllInput(input, "layerA", "layerB", "ignore");
             if (name == "physics.settings") return HasAnyInput(input, "autoSimulation", "bounceThreshold", "defaultContactOffset", "defaultSolverIterations", "defaultSolverVelocityIterations", "gravity", "gravity2d", "property", "queriesHitBackfaces", "queriesHitTriggers", "queriesStartInColliders", "value");
             if (name == "physics.rigidbody")
@@ -961,7 +961,7 @@ namespace UnityCli
         {
             var root = request.Input as IDictionary<string, object>;
             if (root == null) return new Dictionary<string, object>();
-            if (string.Equals(request.Command, "project-tool.run", StringComparison.Ordinal) || string.Equals(request.Command, "runtime-tool.run", StringComparison.Ordinal))
+            if (string.Equals(request.Command, "catalog.editor.run", StringComparison.Ordinal) || string.Equals(request.Command, "catalog.player.run", StringComparison.Ordinal))
             {
                 object nested;
                 var typed = root.TryGetValue("input", out nested) ? nested as IDictionary<string, object> : null;
@@ -1037,10 +1037,10 @@ namespace UnityCli
         {
             if (IsEditorStateSnapshotCommand(command) || IsDoctorDiagnosticCommand(command)) return true;
             return IsProjectToolCatalogReadCommand(command)
-                || string.Equals(command, "runtime-tool.groups", StringComparison.Ordinal)
-                || string.Equals(command, "runtime-tool.summary", StringComparison.Ordinal)
-                || string.Equals(command, "runtime-tool.describe", StringComparison.Ordinal)
-                || string.Equals(command, "runtime-tool.list", StringComparison.Ordinal);
+                || string.Equals(command, "catalog.player.groups", StringComparison.Ordinal)
+                || string.Equals(command, "catalog.player.summary", StringComparison.Ordinal)
+                || string.Equals(command, "catalog.player.describe", StringComparison.Ordinal)
+                || string.Equals(command, "catalog.player.list", StringComparison.Ordinal);
         }
 
         private static Dictionary<string, object> ValidateCoordinatedTerminal(string response, string requestId)

package/unitypkg/Editor/Infrastructure/UnityCliReflection.cs

@@ -56,7 +56,7 @@ namespace UnityCli
                         Generation = generation,
                         Data = new Dictionary<string, object>
                         {
-                            { "command", "type.schema" }, { "typeName", FriendlyTypeName(type, context) }, { "schema", rootSchema },
+                            { "command", "runtime-reflection.type.schema" }, { "typeName", FriendlyTypeName(type, context) }, { "schema", rootSchema },
                             { "memberCount", 0L }, { "returnedMemberCount", 0L }, { "definitionCount", (long)context.Definitions.Count }
                         }
                     };
@@ -80,7 +80,7 @@ namespace UnityCli
                 var typeDisplayName = FriendlyTypeName(type, context);
                 var schema = new Dictionary<string, object> { { "type", "object" }, { "typeName", typeDisplayName }, { "properties", rootProperties } };
                 if (context.Definitions.Count > 0) schema["$defs"] = context.Definitions;
-                var next = index < members.Length ? UnityCliContinuationToken.Create("type.schema", generation, "member:" + index.ToString(CultureInfo.InvariantCulture)) : null;
+                var next = index < members.Length ? UnityCliContinuationToken.Create("runtime-reflection.type.schema", generation, "member:" + index.ToString(CultureInfo.InvariantCulture)) : null;
                 return new Page
                 {
                     Truncated = next != null || context.Truncated,
@@ -88,7 +88,7 @@ namespace UnityCli
                     Generation = generation,
                     Data = new Dictionary<string, object>
                     {
-                        { "command", "type.schema" }, { "typeName", typeDisplayName }, { "schema", schema },
+                        { "command", "runtime-reflection.type.schema" }, { "typeName", typeDisplayName }, { "schema", schema },
                         { "memberCount", (long)members.Length }, { "returnedMemberCount", (long)rootProperties.Count },
                         { "definitionCount", (long)context.Definitions.Count }
                     }
@@ -99,7 +99,7 @@ namespace UnityCli
             {
                 string position;
                 index = -1;
-                if (!UnityCliContinuationToken.TryParse(cursor, "type.schema", generation, out position)
+                if (!UnityCliContinuationToken.TryParse(cursor, "runtime-reflection.type.schema", generation, out position)
                     || !position.StartsWith("member:", StringComparison.Ordinal)
                     || !int.TryParse(position.Substring(7), NumberStyles.Integer, CultureInfo.InvariantCulture, out index)
                     || index < 0 || index > memberCount) throw StaleSchemaCursor();
@@ -107,7 +107,7 @@ namespace UnityCli
 
             private static BridgeCommandException StaleSchemaCursor()
             {
-                return new BridgeCommandException("E_CONTINUATION_STALE", "The type.schema continuation does not match the current assembly generation and limits.", "Start a new type.schema read without cursor.");
+                return new BridgeCommandException("E_CONTINUATION_STALE", "The runtime-reflection.type.schema continuation does not match the current assembly generation and limits.", "Start a new runtime-reflection.type.schema read without cursor.");
             }
 
             /// <summary>递归生成 schema；复杂嵌套类型通过 $defs/$ref 去重，避免循环类型无限展开。</summary>
@@ -538,9 +538,9 @@ namespace UnityCli
                 if (!string.IsNullOrEmpty(cursor))
                 {
                     string position;
-                    if (!UnityCliContinuationToken.TryParse(cursor, "reflection.method.find", generation, out position)
+                    if (!UnityCliContinuationToken.TryParse(cursor, "runtime-reflection.method.find", generation, out position)
                         || !int.TryParse(position, NumberStyles.Integer, CultureInfo.InvariantCulture, out index) || index < 0 || index > methods.Length)
-                        throw new BridgeCommandException("E_CONTINUATION_STALE", "The reflection method continuation does not match the current assembly generation and selector.", "Start a new reflection.method.find read without cursor.");
+                        throw new BridgeCommandException("E_CONTINUATION_STALE", "The reflection method continuation does not match the current assembly generation and selector.", "Start a new runtime-reflection.method.find read without cursor.");
                 }
                 var pageStartIndex = index;
                 var result = new List<ReflectionMethodDescriptor>();
@@ -576,7 +576,7 @@ namespace UnityCli
                 }
                 if (index == pageStartIndex && index < methods.Length)
                     throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension ?? "scannedRecords");
-                var next = index < methods.Length ? UnityCliContinuationToken.Create("reflection.method.find", generation, index.ToString(CultureInfo.InvariantCulture)) : null;
+                var next = index < methods.Length ? UnityCliContinuationToken.Create("runtime-reflection.method.find", generation, index.ToString(CultureInfo.InvariantCulture)) : null;
                 return new MethodPage { Methods = result, Total = methods.Length, NextCursor = next, Generation = generation, Truncated = next != null || budget.IsExhausted };
             }
 
@@ -684,7 +684,7 @@ namespace UnityCli
                     || typeof(CustomYieldInstruction).IsAssignableFrom(returnType))
                     throw new BridgeCommandException(
                         "E_METHOD_COMPLETION_UNPROVABLE",
-                        "reflection.method.call cannot prove immediate completion for awaitable, yield, or AsyncOperation returns: " + returnType.FullName + ".",
+                        "runtime-reflection.method.invoke cannot prove immediate completion for awaitable, yield, or AsyncOperation returns: " + returnType.FullName + ".",
                         "Use a dedicated Tool with an explicit business predicate and proof source.");
             }
 
@@ -701,7 +701,7 @@ namespace UnityCli
                         if (parameterType == null)
                         {
                             if (budget.IsExhausted) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
-                            throw new BridgeCommandException("E_TYPE_NOT_FOUND", "Parameter type not found: " + parameterTypeName, "Use the full parameterType returned by reflection.method.find.");
+                            throw new BridgeCommandException("E_TYPE_NOT_FOUND", "Parameter type not found: " + parameterTypeName, "Use the full parameterType returned by runtime-reflection.method.find.");
                         }
                         selectedParameterTypes.Add(parameterType);
                     }
@@ -739,7 +739,7 @@ namespace UnityCli
                 {
                     throw new BridgeCommandException("E_METHOD_NOT_FOUND", "No overload matches the supplied reflection method signature: " + type.FullName + "." + methodName,
                         new Dictionary<string, object> { { "typeName", type.FullName }, { "methodName", methodName }, { "parameterTypes", parameterTypeNames ?? new List<string>() } },
-                        new[] { "Run reflection.method.find and pass the returned parameterType values as parameterTypes." });
+                        new[] { "Run runtime-reflection.method.find and pass the returned parameterType values as parameterTypes." });
                 }
 
                 var signatures = new List<string>();
@@ -755,7 +755,7 @@ namespace UnityCli
                 }
                 throw new BridgeCommandException("E_METHOD_AMBIGUOUS", "Multiple overloads match: " + type.FullName + "." + methodName,
                     new Dictionary<string, object> { { "typeName", type.FullName }, { "methodName", methodName }, { "candidateSignatures", signatures } },
-                    new[] { "Run reflection.method.find and pass one returned signature's parameterType values as parameterTypes." });
+                    new[] { "Run runtime-reflection.method.find and pass one returned signature's parameterType values as parameterTypes." });
             }
 
             private static bool MethodMatchesBindings(MethodInfo method, BindingFlags bindings, bool declaredOnTarget)

package/unitypkg/Editor/Infrastructure/UnityCliRuntimeExecutor.cs

@@ -166,7 +166,7 @@ namespace UnityCli
                 WriteLog("runtime_tool_not_ready requestId=" + request.RequestId + " name=" + name + " sessionId=" + (currentPlayModeSessionId ?? "null"));
                 throw new BridgeCommandException("E_RUNTIME_NOT_READY",
                     "Runtime Tool cannot execute because the selected Editor is not in a ready Play Mode session.",
-                    "Run unitycli tools run editor.play, wait until editor.state reports ready Play Mode, then retry.");
+                    "Run unitycli tools run editor.play-mode.start, wait until editor.state reports ready Play Mode, then retry.");
             }
 
             // Validate the tool exists and is a runtime tool

package/unitypkg/Editor/ProjectTools/ProjectToolRegistry.cs

@@ -713,8 +713,8 @@ namespace UnityCli
 
         private static bool IsProjectToolCatalogReadCommand(string command)
         {
-            return command == "project-tool.health" || command == "project-tool.groups" || command == "project-tool.summary" || command == "project-tool.describe" || command == "project-tool.list"
-                || command == "runtime-tool.groups" || command == "runtime-tool.summary" || command == "runtime-tool.describe" || command == "runtime-tool.list";
+            return command == "catalog.editor.health" || command == "catalog.editor.groups" || command == "catalog.editor.summary" || command == "catalog.editor.describe" || command == "catalog.editor.list"
+                || command == "catalog.player.groups" || command == "catalog.player.summary" || command == "catalog.player.describe" || command == "catalog.player.list";
         }
 
         private static object ProjectToolGroups(UnityCli.Protocol.BridgeRequest request) { return ProjectToolCatalogGroups(request, false); }
@@ -779,13 +779,13 @@ namespace UnityCli
                     new[] { "Enter Play Mode before running this Tool." });
             }
 
-            // If the tool has Target=runtime, reject from project-tool.run and suggest runtime-tool.run
+            // If the tool has Target=runtime, reject from catalog.editor.run and suggest catalog.player.run
             if (definition.Target == "runtime")
             {
                 throw new BridgeCommandException("E_RUNTIME_TOOL_TARGET_MISMATCH",
-                    "Tool " + name + " has Target=runtime and must be executed via the runtime path (runtime-tool.run).",
+                    "Tool " + name + " has Target=runtime and must be executed via the runtime path (catalog.player.run).",
                     new Dictionary<string, object> { { "toolName", name }, { "toolTarget", definition.Target } },
-                    new[] { "Use runtime-tool.run <name> or tools run <name> with a runtime target to execute this tool in Play Mode." });
+                    new[] { "Use catalog.player.run <name> or tools run <name> with a runtime target to execute this tool in Play Mode." });
             }
             var dryRun = request.Execution != null && request.Execution.DryRun == true;
             var timeoutMs = request.ExecutionTimeoutMs(definition.DefaultTimeoutMs, definition.MaxTimeoutMs);

package/unitypkg/Editor/Tools/{animation → animation-clip}/AnimationToolSupport.cs

@@ -23,7 +23,7 @@ namespace UnityCli
         {
             var path = SceneToolSupport.NormalizeAssetPath(rawPath);
             if (string.IsNullOrEmpty(path))
-                throw new UnityCliBridge.BridgeCommandException("E_ANIMATION_CLIP_PATH_REQUIRED", "Pass an Assets/*.anim path.", "Use tools run animation.clip --input '{\"path\":\"Assets/Animations/Example.anim\"}'.");
+                throw new UnityCliBridge.BridgeCommandException("E_ANIMATION_CLIP_PATH_REQUIRED", "Pass an Assets/*.anim path.", "Use tools run animation-clip.read --input '{\"path\":\"Assets/Animations/Example.anim\"}'.");
             if (!path.StartsWith("Assets/", System.StringComparison.OrdinalIgnoreCase) || !path.EndsWith(".anim", System.StringComparison.OrdinalIgnoreCase))
                 throw new UnityCliBridge.BridgeCommandException("E_ANIMATION_CLIP_PATH_INVALID", "AnimationClip path must be under Assets/ and end with .anim: " + path, "Pass a Unity asset path such as Assets/Animations/Player.anim.");
             return path;
@@ -53,7 +53,7 @@ namespace UnityCli
         {
             var clip = AssetDatabase.LoadAssetAtPath<AnimationClip>(path);
             if (clip == null)
-                throw new UnityCliBridge.BridgeCommandException("E_ANIMATION_CLIP_NOT_FOUND", "AnimationClip asset not found: " + path, "Check the path or create one with animation.clip.create.");
+                throw new UnityCliBridge.BridgeCommandException("E_ANIMATION_CLIP_NOT_FOUND", "AnimationClip asset not found: " + path, "Check the path or create one with animation-clip.create.");
             return clip;
         }
 
@@ -62,7 +62,7 @@ namespace UnityCli
         {
             var path = SceneToolSupport.NormalizeAssetPath(rawPath);
             if (string.IsNullOrEmpty(path))
-                throw new UnityCliBridge.BridgeCommandException("E_CONTROLLER_PATH_REQUIRED", "Pass --controller-path <Assets/...>.controller>.", "Use controller.create to create one first.");
+                throw new UnityCliBridge.BridgeCommandException("E_CONTROLLER_PATH_REQUIRED", "Pass --controller-path <Assets/...>.controller>.", "Use animator-controller.create to create one first.");
             if (!path.StartsWith("Assets/", System.StringComparison.Ordinal) || !path.EndsWith(".controller", System.StringComparison.OrdinalIgnoreCase))
                 throw new UnityCliBridge.BridgeCommandException("E_CONTROLLER_PATH_INVALID", "AnimatorController path must be a canonical Assets/*.controller path: " + path, "Pass a Unity asset path such as Assets/Animations/Player.controller.");
             // 在任何 AssetDatabase 查找或创建目录前证明物理路径仍受 Assets/ 包含。

package/unitypkg/Editor/Tools/{animation/clip → animation-clip}/create.cs

@@ -6,12 +6,12 @@ using UnityEngine;
 
 namespace UnityCli
 {
-    /// <summary>animation.clip.create — 创建持久化 AnimationClip 资产。</summary>
+    /// <summary>animation-clip.create — 创建持久化 AnimationClip 资产。</summary>
     public class AnimationClipCreateTool : IUnityCliTool<AnimationClipCreateTool.Request, AnimationClipCreateTool.Result>
     {
         public sealed class Request { public string Path { get; set; } public bool? Overwrite { get; set; } public float? FrameRate { get; set; } public bool? Legacy { get; set; } public string WrapMode { get; set; } public bool? LoopTime { get; set; } public float? StartTime { get; set; } public float? StopTime { get; set; } public float? Length { get; set; } public int? MaxCurveKeys { get; set; } }
         public sealed class Result { public bool DryRun { get; set; } public bool WouldOverwrite { get; set; } public AnimationClipInfo Clip { get; set; } public List<AnimationPlannedEffect> PlannedEffects { get; set; } }
-        public ToolDescriptor Describe() => new() { Name = "animation.clip.create", Summary = "Create or overwrite a persistent AnimationClip asset at an Assets/*.anim path.", Description = "Create a new .anim asset with clip-level settings (frameRate, legacy, wrapMode, loopTime, startTime/stopTime/length). overwrite=true to replace existing.", Group = "animation",DestructiveHint = true, SupportsDryRun = true, SideEffects = new[] { "asset-write" }, Target = "editor", PlayModeSupport = "editor-only", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Create clip", Input = new Request { Path = "Assets/Animations/Created.anim", FrameRate = 30f, LoopTime = true } } } };
+        public ToolDescriptor Describe() => new() { Name = "animation-clip.create", Summary = "Create or overwrite a persistent AnimationClip asset at an Assets/*.anim path.", Description = "Create a new .anim asset with clip-level settings (frameRate, legacy, wrapMode, loopTime, startTime/stopTime/length). overwrite=true to replace existing.", Group = "animation-clip",DestructiveHint = true, SupportsDryRun = true, SideEffects = new[] { "asset-write" }, Target = "editor", PlayModeSupport = "editor-only", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Create clip", Input = new Request { Path = "Assets/Animations/Created.anim", FrameRate = 30f, LoopTime = true } } } };
         public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
             var path = AnimationToolSupport.RequireAnimationClipPath(r.Path);
@@ -22,7 +22,7 @@ namespace UnityCli
                 throw new UnityCliBridge.BridgeCommandException("E_ANIMATION_CLIP_EXISTS", "AnimationClip already exists: " + path, "Pass overwrite:true after inspecting the existing clip, or choose another Assets/*.anim path.");
             var dryRun = ctx.DryRun;
             if (dryRun)
-                return new System.Threading.Tasks.ValueTask<Result>(new Result { DryRun = true, WouldOverwrite = existing != null, PlannedEffects = new List<AnimationPlannedEffect> { new AnimationPlannedEffect { Type = "animation.clip.create", Path = path } } });
+                return new System.Threading.Tasks.ValueTask<Result>(new Result { DryRun = true, WouldOverwrite = existing != null, PlannedEffects = new List<AnimationPlannedEffect> { new AnimationPlannedEffect { Type = "animation-clip.create", Path = path } } });
             ctx.CommitEffect();
             SceneToolSupport.CreateAssetDirectory(path);
             if (existing != null) AssetDatabase.DeleteAsset(path);
@@ -41,7 +41,7 @@ namespace UnityCli
             var observedSettings = observedClip == null ? default(AnimationClipSettings) : AnimationUtility.GetAnimationClipSettings(observedClip);
             if (observedClip == null || observedClip.name != clip.name || (r.FrameRate.HasValue && !Mathf.Approximately(observedClip.frameRate, r.FrameRate.Value)) || (r.Legacy.HasValue && observedClip.legacy != r.Legacy.Value) || (!string.IsNullOrEmpty(r.WrapMode) && observedClip.wrapMode != wm) || (r.LoopTime.HasValue && observedSettings.loopTime != r.LoopTime.Value) || (r.StartTime.HasValue && !Mathf.Approximately(observedSettings.startTime, r.StartTime.Value)) || (r.StopTime.HasValue && !Mathf.Approximately(observedSettings.stopTime, r.StopTime.Value)) || (r.Length.HasValue && !r.StopTime.HasValue && !Mathf.Approximately(observedSettings.stopTime - observedSettings.startTime, r.Length.Value)))
                 throw AnimationToolSupport.StateMismatch("E_ANIMATION_CLIP_CREATE_STATE_MISMATCH", "AnimationClip creation");
-            return new System.Threading.Tasks.ValueTask<Result>(new Result { DryRun = false, Clip = AnimationToolSupport.BuildAnimationClipInfo(path, observedClip, r.MaxCurveKeys ?? 5), PlannedEffects = new List<AnimationPlannedEffect> { new AnimationPlannedEffect { Type = "animation.clip.create", Path = path } } });
+            return new System.Threading.Tasks.ValueTask<Result>(new Result { DryRun = false, Clip = AnimationToolSupport.BuildAnimationClipInfo(path, observedClip, r.MaxCurveKeys ?? 5), PlannedEffects = new List<AnimationPlannedEffect> { new AnimationPlannedEffect { Type = "animation-clip.create", Path = path } } });
         }
     }
 }

package/unitypkg/Editor/Tools/{animation/clip.cs → animation-clip/read.cs}

@@ -6,12 +6,12 @@ using UnityEngine;
 
 namespace UnityCli
 {
-    /// <summary>animation.clip — 读取 AnimationClip 资产的设置、绑定曲线和事件。</summary>
-    public class AnimationClipTool : IUnityCliTool<AnimationClipTool.Request, AnimationClipTool.Result>
+    /// <summary>animation-clip.read — 读取 AnimationClip 资产的设置、绑定曲线和事件。</summary>
+    public class AnimationClipReadTool : IUnityCliTool<AnimationClipReadTool.Request, AnimationClipReadTool.Result>
     {
         public sealed class Request { public string Path { get; set; } public int? MaxCurveKeys { get; set; } }
         public sealed class Result { public AnimationClipInfo Clip { get; set; } }
-        public ToolDescriptor Describe() => new() { Name = "animation.clip", Summary = "Read an AnimationClip asset's settings, curve bindings, and events.", Description = "Read Assets/*.anim AnimationClip settings, events, and bounded curve summaries. maxCurveKeys limits keys per binding (default 5).", Group = "animation",DestructiveHint = false, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Read clip", Input = new Request { Path = "Assets/Animations/Idle.anim" } } } };
+        public ToolDescriptor Describe() => new() { Name = "animation-clip.read", Summary = "Read an AnimationClip asset's settings, curve bindings, and events.", Description = "Read Assets/*.anim AnimationClip settings, events, and bounded curve summaries. maxCurveKeys limits keys per binding (default 5).", Group = "animation-clip",DestructiveHint = false, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Read clip", Input = new Request { Path = "Assets/Animations/Idle.anim" } } } };
         public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
             var path = AnimationToolSupport.RequireAnimationClipPath(r.Path);

package/unitypkg/Editor/Tools/{animation/clip/modify.cs → animation-clip/update.cs}

@@ -6,12 +6,12 @@ using UnityEngine;
 
 namespace UnityCli
 {
-    /// <summary>animation.clip.modify — 修改已存在 AnimationClip 的 clip 级设置。</summary>
-    public class AnimationClipModifyTool : IUnityCliTool<AnimationClipModifyTool.Request, AnimationClipModifyTool.Result>
+    /// <summary>animation-clip.update — 修改已存在 AnimationClip 的 clip 级设置。</summary>
+    public class AnimationClipUpdateTool : IUnityCliTool<AnimationClipUpdateTool.Request, AnimationClipUpdateTool.Result>
     {
         public sealed class Request { public string Path { get; set; } public float? FrameRate { get; set; } public bool? Legacy { get; set; } public string WrapMode { get; set; } public bool? LoopTime { get; set; } public float? StartTime { get; set; } public float? StopTime { get; set; } public float? Length { get; set; } public int? MaxCurveKeys { get; set; } }
         public sealed class Result { public bool DryRun { get; set; } public AnimationClipInfo Clip { get; set; } public List<AnimationPlannedEffect> PlannedEffects { get; set; } }
-        public ToolDescriptor Describe() => new() { Name = "animation.clip.modify", Summary = "Update clip-level settings on an existing AnimationClip asset.", Description = "Modify frameRate, legacy, wrapMode, loopTime, startTime/stopTime/length on an existing .anim asset. Does not touch curves or events.", Group = "animation",DestructiveHint = true, SupportsDryRun = true, SideEffects = new[] { "asset-write" }, Target = "editor", PlayModeSupport = "editor-only", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Set loop time", Input = new Request { Path = "Assets/Animations/Walk.anim", LoopTime = true } } } };
+        public ToolDescriptor Describe() => new() { Name = "animation-clip.update", Summary = "Update clip-level settings on an existing AnimationClip asset.", Description = "Modify frameRate, legacy, wrapMode, loopTime, startTime/stopTime/length on an existing .anim asset. Does not touch curves or events.", Group = "animation-clip",DestructiveHint = true, SupportsDryRun = true, SideEffects = new[] { "asset-write" }, Target = "editor", PlayModeSupport = "editor-only", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Set loop time", Input = new Request { Path = "Assets/Animations/Walk.anim", LoopTime = true } } } };
         public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
             var path = AnimationToolSupport.RequireAnimationClipPath(r.Path);
@@ -19,7 +19,7 @@ namespace UnityCli
             var wm = AnimationToolSupport.ValidateClipSettings(r.FrameRate, r.WrapMode, r.StartTime, r.StopTime, r.Length);
             var dryRun = ctx.DryRun;
             if (dryRun)
-                return new System.Threading.Tasks.ValueTask<Result>(new Result { DryRun = true, Clip = AnimationToolSupport.BuildAnimationClipInfo(path, clip, r.MaxCurveKeys ?? 5), PlannedEffects = new List<AnimationPlannedEffect> { new AnimationPlannedEffect { Type = "animation.clip.modify", Path = path } } });
+                return new System.Threading.Tasks.ValueTask<Result>(new Result { DryRun = true, Clip = AnimationToolSupport.BuildAnimationClipInfo(path, clip, r.MaxCurveKeys ?? 5), PlannedEffects = new List<AnimationPlannedEffect> { new AnimationPlannedEffect { Type = "animation-clip.update", Path = path } } });
             ctx.CommitEffect();
             Undo.RecordObject(clip, "Modify AnimationClip Settings");
             if (r.FrameRate.HasValue) clip.frameRate = r.FrameRate.Value;
@@ -36,7 +36,7 @@ namespace UnityCli
             var observedSettings = observedClip == null ? default(AnimationClipSettings) : AnimationUtility.GetAnimationClipSettings(observedClip);
             if (observedClip == null || (r.FrameRate.HasValue && !Mathf.Approximately(observedClip.frameRate, r.FrameRate.Value)) || (r.Legacy.HasValue && observedClip.legacy != r.Legacy.Value) || (!string.IsNullOrEmpty(r.WrapMode) && observedClip.wrapMode != wm) || (r.LoopTime.HasValue && observedSettings.loopTime != r.LoopTime.Value) || (r.StartTime.HasValue && !Mathf.Approximately(observedSettings.startTime, r.StartTime.Value)) || (r.StopTime.HasValue && !Mathf.Approximately(observedSettings.stopTime, r.StopTime.Value)) || (r.Length.HasValue && !r.StopTime.HasValue && !Mathf.Approximately(observedSettings.stopTime - observedSettings.startTime, r.Length.Value)))
                 throw AnimationToolSupport.StateMismatch("E_ANIMATION_CLIP_MODIFY_STATE_MISMATCH", "AnimationClip settings");
-            return new System.Threading.Tasks.ValueTask<Result>(new Result { DryRun = false, Clip = AnimationToolSupport.BuildAnimationClipInfo(path, observedClip, r.MaxCurveKeys ?? 5), PlannedEffects = new List<AnimationPlannedEffect> { new AnimationPlannedEffect { Type = "animation.clip.modify", Path = path } } });
+            return new System.Threading.Tasks.ValueTask<Result>(new Result { DryRun = false, Clip = AnimationToolSupport.BuildAnimationClipInfo(path, observedClip, r.MaxCurveKeys ?? 5), PlannedEffects = new List<AnimationPlannedEffect> { new AnimationPlannedEffect { Type = "animation-clip.update", Path = path } } });
         }
     }
 }

package/unitypkg/Editor/Tools/{animation/animator → animator}/crossfade.cs

@@ -19,7 +19,7 @@ namespace UnityCli
             Name = "animator.crossfade",
             Summary = "Cross-fade an Animator to a named state with fresh state readback.",
             Description = "Cross-fade a resolved Animator to a named state. The tool validates the controller, layer and state before one effect, then reads current and next state from the same Animator layer before returning.",
-            Group = "animation",DestructiveHint = false,
+            Group = "animator",DestructiveHint = false,
             SideEffects = new[] { "scene-modify" }, Target = "editor", PlayModeSupport = "supported",
             DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000,
             Examples = new[] { new ToolExample { Description = "Crossfade to Run", Input = new Request { Target = "Player", State = "Run", Duration = 0.3f } } }

package/unitypkg/Editor/Tools/{animation/animator → animator}/get-info.cs

@@ -11,7 +11,7 @@ namespace UnityCli
     {
         public sealed class Request { public string Target { get; set; } }
         public sealed class Result { public AnimatorInfo Animator { get; set; } }
-        public ToolDescriptor Describe() => new() { Name = "animator.get-info", Summary = "Read Animator details: layers, parameters, clips, and runtime controller.", Description = "Resolve a target with an Animator and return enabled, speed, layerCount, parameters, layers, and clips.", Group = "animation",DestructiveHint = false, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Read animator info", Input = new Request { Target = "Player" } } } };
+        public ToolDescriptor Describe() => new() { Name = "animator.get-info", Summary = "Read Animator details: layers, parameters, clips, and runtime controller.", Description = "Resolve a target with an Animator and return enabled, speed, layerCount, parameters, layers, and clips.", Group = "animator",DestructiveHint = false, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Read animator info", Input = new Request { Target = "Player" } } } };
         public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
             var go = GameObjectToolSupport.ResolveUniqueTarget(r.Target, "Animator info requires --target <go>.");

package/unitypkg/Editor/Tools/{animation/animator → animator}/get-parameter.cs

@@ -11,7 +11,7 @@ namespace UnityCli
     {
         public sealed class Request { public string Target { get; set; } public string ParameterName { get; set; } }
         public sealed class Result { public AnimatorParameterWithValue Parameter { get; set; } }
-        public ToolDescriptor Describe() => new() { Name = "animator.get-parameter", Summary = "Read a single Animator parameter's current or default value.", Description = "Resolve a target with an Animator and read a named parameter. Returns runtime value if available, otherwise the controller default.", Group = "animation",DestructiveHint = false, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Read Speed parameter", Input = new Request { Target = "Player", ParameterName = "Speed" } } } };
+        public ToolDescriptor Describe() => new() { Name = "animator.get-parameter", Summary = "Read a single Animator parameter's current or default value.", Description = "Resolve a target with an Animator and read a named parameter. Returns runtime value if available, otherwise the controller default.", Group = "animator",DestructiveHint = false, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Read Speed parameter", Input = new Request { Target = "Player", ParameterName = "Speed" } } } };
         public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
             var go = GameObjectToolSupport.ResolveUniqueTarget(r.Target, "Animator get-parameter requires --target <go>.");

package/unitypkg/Editor/Tools/{animation/state.cs → animator/get-state.cs}

@@ -6,12 +6,12 @@ using UnityEngine;
 
 namespace UnityCli
 {
-    /// <summary>animation.state — 读取目标 Animator 的当前状态信息。</summary>
-    public class AnimationStateTool : IUnityCliTool<AnimationStateTool.Request, AnimationStateTool.Result>
+    /// <summary>animator.get-state — 读取目标 Animator 的当前状态信息。</summary>
+    public class AnimatorGetStateTool : IUnityCliTool<AnimatorGetStateTool.Request, AnimatorGetStateTool.Result>
     {
         public sealed class Request { public string Target { get; set; } public int? Layer { get; set; } }
         public sealed class Result { public AnimatorInfo Animator { get; set; } }
-        public ToolDescriptor Describe() => new() { Name = "animation.state", Summary = "Read the current Animator state for a target GameObject.", Description = "Resolve a target with an Animator and return current state info (layer, state hash, normalized time).", Group = "animation",DestructiveHint = false, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Read animation state", Input = new Request { Target = "Player" } } } };
+        public ToolDescriptor Describe() => new() { Name = "animator.get-state", Summary = "Read the current Animator state for a target GameObject.", Description = "Resolve a target with an Animator and return current state info (layer, state hash, normalized time).", Group = "animator",DestructiveHint = false, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Read animation state", Input = new Request { Target = "Player" } } } };
         public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
             var go = GameObjectToolSupport.ResolveUniqueTarget(r.Target, "Animation state requires --target <go>.");

package/unitypkg/Editor/Tools/{animation → animator}/play.cs

@@ -6,12 +6,12 @@ using UnityEngine;
 
 namespace UnityCli
 {
-    /// <summary>animation.play — 播放指定 Animator 状态。</summary>
-    public class AnimationPlayTool : IUnityCliTool<AnimationPlayTool.Request, AnimationPlayTool.Result>
+    /// <summary>animator.play — 播放指定 Animator 状态。</summary>
+    public class AnimatorPlayTool : IUnityCliTool<AnimatorPlayTool.Request, AnimatorPlayTool.Result>
     {
         public sealed class Request { public string Target { get; set; } public string State { get; set; } public int? Layer { get; set; } public float? NormalizedTime { get; set; } }
         public sealed class Result { public AnimatorInfo Animator { get; set; } public List<AnimationPlannedEffect> PlannedEffects { get; set; } }
-        public ToolDescriptor Describe() => new() { Name = "animation.play", Summary = "Play a named Animator state on a target GameObject.", Description = "Resolve a target with an Animator and play the named state on the given layer.", Group = "animation",DestructiveHint = false, SideEffects = new[] { "scene-modify" }, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Play Walk state", Input = new Request { Target = "Player", State = "Walk" } } } };
+        public ToolDescriptor Describe() => new() { Name = "animator.play", Summary = "Play a named Animator state on a target GameObject.", Description = "Resolve a target with an Animator and play the named state on the given layer.", Group = "animator",DestructiveHint = false, SideEffects = new[] { "scene-modify" }, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Play Walk state", Input = new Request { Target = "Player", State = "Walk" } } } };
         public async System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
             var go = GameObjectToolSupport.ResolveUniqueTarget(r.Target, "Animation play requires --target <go>.");
@@ -22,7 +22,7 @@ namespace UnityCli
                 throw new UnityCliBridge.BridgeCommandException("E_ANIMATION_NO_CONTROLLER", "Animator has no RuntimeAnimatorController assigned or no effective layers: " + GameObjectToolSupport.HierarchyPath(go), "Assign a RuntimeAnimatorController with at least one layer.");
             if (string.IsNullOrEmpty(r.State)) throw new UnityCliBridge.BridgeCommandException("E_ANIMATION_STATE_REQUIRED", "Animation play requires --state <name>.", "Pass an Animator state name.");
             var layer = r.Layer ?? 0;
-            if (layer < 0 || layer >= effectiveLayerCount) throw new UnityCliBridge.BridgeCommandException("E_ANIMATION_LAYER_INVALID", "Animator layer is out of range: " + layer, "Run animation.state to inspect layer count.");
+            if (layer < 0 || layer >= effectiveLayerCount) throw new UnityCliBridge.BridgeCommandException("E_ANIMATION_LAYER_INVALID", "Animator layer is out of range: " + layer, "Run animator.get-state to inspect layer count.");
             var controller = animator.runtimeAnimatorController as AnimatorController;
             var state = controller == null || layer >= controller.layers.Length ? null : AnimationToolSupport.FindStateInLayer(controller.layers[layer].stateMachine, r.State);
             if (state == null) throw new UnityCliBridge.BridgeCommandException("E_ANIMATION_STATE_UNOBSERVABLE", "Animation state cannot be resolved to a stable Animator readback: " + r.State, "Pass a root state name from the selected AnimatorController layer.");
@@ -34,7 +34,7 @@ namespace UnityCli
             if (!observed) throw new UnityCliBridge.BridgeCommandException("E_ANIMATION_STATE_TIMEOUT", "Animator did not reach the requested state before timeout: " + r.State, "Check Animator transitions and retry after the requested state is reachable.");
             UnityCliSceneMutation.MarkSceneObjectDirty(animator);
             var finalAnimator = AnimationToolSupport.BuildAnimatorInfo(animator, layer);
-            return new Result { Animator = finalAnimator, PlannedEffects = new List<AnimationPlannedEffect> { new AnimationPlannedEffect { Type = "animation.play", Target = GameObjectToolSupport.HierarchyPath(go), State = r.State } } };
+            return new Result { Animator = finalAnimator, PlannedEffects = new List<AnimationPlannedEffect> { new AnimationPlannedEffect { Type = "animator.play", Target = GameObjectToolSupport.HierarchyPath(go), State = r.State } } };
         }
     }
 }

package/unitypkg/Editor/Tools/{animation/animator → animator}/set-enabled.cs

@@ -11,7 +11,7 @@ namespace UnityCli
     {
         public sealed class Request { public string Target { get; set; } public bool? Value { get; set; } }
         public sealed class Result { public bool Enabled { get; set; } public List<AnimationPlannedEffect> PlannedEffects { get; set; } }
-        public ToolDescriptor Describe() => new() { Name = "animator.set-enabled", Summary = "Enable or disable an Animator component on a target GameObject.", Description = "Resolve a target with an Animator and set animator.enabled. Defaults to true.", Group = "animation",DestructiveHint = false, SideEffects = new[] { "scene-modify" }, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Disable animator", Input = new Request { Target = "Player", Value = false } } } };
+        public ToolDescriptor Describe() => new() { Name = "animator.set-enabled", Summary = "Enable or disable an Animator component on a target GameObject.", Description = "Resolve a target with an Animator and set animator.enabled. Defaults to true.", Group = "animator",DestructiveHint = false, SideEffects = new[] { "scene-modify" }, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Disable animator", Input = new Request { Target = "Player", Value = false } } } };
         public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
             var go = GameObjectToolSupport.ResolveUniqueTarget(r.Target, "Animator set-enabled requires --target <go>.");

package/unitypkg/Editor/Tools/{animation/animator → animator}/set-parameter.cs

@@ -11,7 +11,7 @@ namespace UnityCli
     {
         public sealed class Request { public string Target { get; set; } public string ParameterName { get; set; } public string Value { get; set; } }
         public sealed class Result { public AnimatorParameterRef Parameter { get; set; } public List<AnimationPlannedEffect> PlannedEffects { get; set; } }
-        public ToolDescriptor Describe() => new() { Name = "animator.set-parameter", Summary = "Set an Animator parameter default value by editing the AnimatorController asset.", Description = "In edit mode, modifies the AnimatorController asset parameter defaults. Requires an AnimatorController assigned to the Animator.", Group = "animation",DestructiveHint = true, SideEffects = new[] { "asset-write" }, Target = "editor", PlayModeSupport = "editor-only", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Set Speed default", Input = new Request { Target = "Player", ParameterName = "Speed", Value = "0.5" } } } };
+        public ToolDescriptor Describe() => new() { Name = "animator.set-parameter", Summary = "Set an Animator parameter default value by editing the AnimatorController asset.", Description = "In edit mode, modifies the AnimatorController asset parameter defaults. Requires an AnimatorController assigned to the Animator.", Group = "animator",DestructiveHint = true, SideEffects = new[] { "asset-write" }, Target = "editor", PlayModeSupport = "editor-only", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Set Speed default", Input = new Request { Target = "Player", ParameterName = "Speed", Value = "0.5" } } } };
         public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
             var go = GameObjectToolSupport.ResolveUniqueTarget(r.Target, "Animator set-parameter requires --target <go>.");

package/unitypkg/Editor/Tools/{animation/animator → animator}/set-speed.cs

@@ -11,7 +11,7 @@ namespace UnityCli
     {
         public sealed class Request { public string Target { get; set; } public float? Speed { get; set; } }
         public sealed class Result { public double Speed { get; set; } public List<AnimationPlannedEffect> PlannedEffects { get; set; } }
-        public ToolDescriptor Describe() => new() { Name = "animator.set-speed", Summary = "Set the playback speed of an Animator component.", Description = "Resolve a target with an Animator and set animator.speed. Defaults to 1.0.", Group = "animation",DestructiveHint = false, SideEffects = new[] { "scene-modify" }, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Set speed to 2x", Input = new Request { Target = "Player", Speed = 2f } } } };
+        public ToolDescriptor Describe() => new() { Name = "animator.set-speed", Summary = "Set the playback speed of an Animator component.", Description = "Resolve a target with an Animator and set animator.speed. Defaults to 1.0.", Group = "animator",DestructiveHint = false, SideEffects = new[] { "scene-modify" }, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Set speed to 2x", Input = new Request { Target = "Player", Speed = 2f } } } };
         public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
             var go = GameObjectToolSupport.ResolveUniqueTarget(r.Target, "Animator set-speed requires --target <go>.");