@alpsckr/unitycli 0.4.5 → 0.5.0

package/unitypkg/Editor/Tools/asset/{modify.cs → write-text.cs}

@@ -6,9 +6,9 @@ using UnityEditor;
 namespace UnityCli
 {
     /// <summary>
-    /// asset.modify — 用新 content 覆盖文本类资产文件并重新导入。
+    /// asset.write-text — 用新 content 覆盖文本类资产文件并重新导入。
     /// </summary>
-    public class AssetModifyTool : IUnityCliTool<AssetModifyTool.Request, AssetModifyTool.Result>
+    public class AssetWriteTextTool : IUnityCliTool<AssetWriteTextTool.Request, AssetWriteTextTool.Result>
     {
         public sealed class Request
         {
@@ -24,7 +24,7 @@ namespace UnityCli
 
         public ToolDescriptor Describe() => new()
         {
-            Name = "asset.modify",
+            Name = "asset.write-text",
             Summary = "Overwrite a text-like asset file with new content and force-reimport it.",
             Description = "Overwrite a text-like asset file with new content and force-reimport it. The asset must already exist. Use asset.create for new files and asset.import for binary source files.",
             Group = "asset",
@@ -42,13 +42,13 @@ namespace UnityCli
 
         public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
-            AssetToolSupport.EnsureEditorNotBusy("asset.modify");
+            AssetToolSupport.EnsureEditorNotBusy("asset.write-text");
             var path = AssetToolSupport.RequireExistingAssetPath(request.Path);
             var content = request.Content;
             var extension = Path.GetExtension(path).ToLowerInvariant();
             var textExtensions = new HashSet<string> { ".txt", ".json", ".xml", ".csv", ".md", ".yaml", ".yml", ".uss", ".uxml", ".shader", ".cginc", ".compute", ".asmdef", ".asmref" };
             if (!textExtensions.Contains(extension) || Directory.Exists(AssetToolSupport.AssetFullPath(path)))
-                throw new UnityCliBridge.BridgeCommandException("E_ASSET_MODIFY_TYPE_UNSUPPORTED", "asset.modify only supports existing ordinary text files with a safe extension: " + path, "Use an approved text extension or the specialized asset tool.");
+                throw new UnityCliBridge.BridgeCommandException("E_ASSET_MODIFY_TYPE_UNSUPPORTED", "asset.write-text only supports existing ordinary text files with a safe extension: " + path, "Use an approved text extension or the specialized asset tool.");
             if (content == null)
             {
                 throw new UnityCliBridge.BridgeCommandException("E_ASSET_CONTENT_REQUIRED", "Asset modify requires content or content-file.", "Pass text content for a text-like asset file.");
@@ -61,7 +61,7 @@ namespace UnityCli
             return new System.Threading.Tasks.ValueTask<Result>(new Result
             {
                 Asset = AssetToolSupport.BuildAssetDetail(path),
-                PlannedEffects = new List<AssetPlannedEffect> { new AssetPlannedEffect { Type = "asset.modify", Path = path } }
+                PlannedEffects = new List<AssetPlannedEffect> { new AssetPlannedEffect { Type = "asset.write-text", Path = path } }
             });
         }
     }

package/unitypkg/Editor/Tools/component/get.cs

@@ -43,7 +43,7 @@ namespace UnityCli
         {
             Name = "component.get",
             Summary = "Deep-read one Component by GameObject and component selector; use paths/viewQuery for token-safe fields.",
-            Description = "Deep-read one Component after selecting a GameObject with go.find, scene.hierarchy, scene.gameobject, or scene.gameobject.components. For token safety, pass exact paths or one viewQuery; they are mutually exclusive and skip full fields/props expansion. Use componentIndex/componentInstanceId when duplicate components exist. maxDepth is 0..16, maxArrayItems is 1..1000, and paths accepts at most 128 ordered exact reads. All reads share budget scan/node/getter/reflection/time/UTF-8 ceilings; truncated nodes return nextPath. Defaults are 10000 scans, 4096 nodes, 2048 getters, 4096 reflection calls, 250 main-thread ms, and 1 MiB; maxima are 100000/20000/10000/20000/2000 ms/8 MiB. Read-only in Edit and Play Mode.",
+            Description = "Deep-read one Component after selecting a GameObject with game-object.find, scene.hierarchy, scene.gameobject, or scene.gameobject.components. For token safety, pass exact paths or one viewQuery; they are mutually exclusive and skip full fields/props expansion. Use componentIndex/componentInstanceId when duplicate components exist. maxDepth is 0..16, maxArrayItems is 1..1000, and paths accepts at most 128 ordered exact reads. All reads share budget scan/node/getter/reflection/time/UTF-8 ceilings; truncated nodes return nextPath. Defaults are 10000 scans, 4096 nodes, 2048 getters, 4096 reflection calls, 250 main-thread ms, and 1 MiB; maxima are 100000/20000/10000/20000/2000 ms/8 MiB. Read-only in Edit and Play Mode.",
             Group = "component",
             DestructiveHint = false,
             Target = "editor",

package/unitypkg/Editor/Tools/component/list-types.cs

@@ -25,7 +25,7 @@ namespace UnityCli
         {
             public long Count { get; set; }
             public List<ComponentTypeInfo> Types { get; set; }
-            public GoPageInfo PageInfo { get; set; }
+            public GameObjectPageInfo PageInfo { get; set; }
         }
 
         public ToolDescriptor Describe() => new()
@@ -72,7 +72,7 @@ namespace UnityCli
             {
                 Count = total,
                 Types = page.ConvertAll(t => new ComponentTypeInfo { FullName = t.FullName, Name = t.Name, Assembly = t.Assembly.GetName().Name, Namespace = t.Namespace }),
-                PageInfo = new GoPageInfo { PageSize = pageSize, Cursor = cursor, NextCursor = nextCursor, Total = total }
+                PageInfo = new GameObjectPageInfo { PageSize = pageSize, Cursor = cursor, NextCursor = nextCursor, Total = total }
             };
             return new System.Threading.Tasks.ValueTask<Result>(result);
         }

package/unitypkg/Editor/Tools/component/modify.cs

@@ -41,7 +41,7 @@ namespace UnityCli
         public ToolDescriptor Describe() => new()
         {
             Name = "component.modify",
-            Summary = "Modify one Component with verified serialized pathPatches; use component.get/type.schema first.",
+            Summary = "Modify one Component with verified serialized pathPatches; use component.get/runtime-reflection.type.schema first.",
             Description = "Apply direct replace pathPatches to verifiable SerializedProperties of one Component. Returns fresh updated data and changed paths. Use component.get first. In Play Mode, scene component changes affect only the current runtime session unless later persisted by Unity workflow; in Edit Mode they mark scene/component state dirty.",
             Group = "component",
             DestructiveHint = true,

package/unitypkg/Editor/Tools/component/set.cs

@@ -33,7 +33,7 @@ namespace UnityCli
         {
             Name = "component.set",
             Summary = "Set one simple public field/property, or multiple simple fields/properties via properties, on a Component attached to a GameObject.",
-            Description = "Set one simple public field/property, or multiple simple fields/properties via properties, on a Component attached to a GameObject. For nested values, object references, arrays, or SerializedObject-style patches, use component.modify after component.get/type.schema.",
+            Description = "Set one simple public field/property, or multiple simple fields/properties via properties, on a Component attached to a GameObject. For nested values, object references, arrays, or SerializedObject-style patches, use component.modify after component.get/runtime-reflection.type.schema.",
             Group = "component",
             DestructiveHint = false,
             SideEffects = new[] { "component-modify", "scene-modify" },

package/unitypkg/Editor/Tools/console/{get.cs → read.cs}

@@ -3,8 +3,8 @@ using System.Collections.Generic;
 
 namespace UnityCli
 {
-    /// <summary>console.get — 按稳定 raw Console 位置执行有界过滤与续页。</summary>
-    public class ConsoleGetTool : IUnityCliTool<ConsoleGetTool.Request, ConsoleGetTool.Result>
+    /// <summary>console.read — 按稳定 raw Console 位置执行有界过滤与续页。</summary>
+    public class ConsoleReadTool : IUnityCliTool<ConsoleReadTool.Request, ConsoleReadTool.Result>
     {
         public sealed class Request
         {
@@ -26,7 +26,7 @@ namespace UnityCli
 
         public ToolDescriptor Describe() => new()
         {
-            Name = "console.get",
+            Name = "console.read",
             Summary = "Read one bounded, non-resumable Unity Console snapshot under request-wide limits.",
             Description = "Read Console entries newest-first from one Unity snapshot window without materializing the Console. count defaults to 50 and is limited to 1..500. Filtering advances over raw positions and every entry uses the shared scan/reflection/getter/main-thread/UTF-8 budget. Unity exposes no reliable generation covering external Console clear/rebuild, so this tool intentionally has no cursor; truncated=true means start a fresh snapshot with a larger count or budget. rawEntryCount is Unity's raw count, not a filtered total. Read-only in Edit and Play Mode.",
             Group = "console",

package/unitypkg/Editor/Tools/editor/{play.cs → play-mode/start.cs}

@@ -7,17 +7,17 @@ using UnityEngine.SceneManagement;
 
 namespace UnityCli
 {
-    /// <summary>editor.play — 进入 Play Mode。</summary>
-    public class EditorPlayTool : IUnityCliTool<EditorPlayTool.Request, EditorPlayTool.Response>
+    /// <summary>editor.play-mode.start — 进入 Play Mode。</summary>
+    public class EditorPlayModeStartTool : IUnityCliTool<EditorPlayModeStartTool.Request, EditorPlayModeStartTool.Response>
     {
         public sealed class Request { }
         public sealed class Response { public PlayModeResult Result { get; set; } public EditorStateInfo State { get; set; } public List<EditorPlannedEffect> PlannedEffects { get; set; } }
-        public ToolDescriptor Describe() => new() { Name = "editor.play", Summary = "Enter Unity Play Mode and return only after the Editor reaches a stable playing state.", Description = "Set EditorApplication.isPlaying=true, absorb the PlayMode transition or same-session reload, and return the stable Editor state. Success proves isPlaying=true and the central PlayMode transition flag is false.", Group = "editor",DestructiveHint = false, SideEffects = new[] { "session-affecting" }, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Enter play mode", Input = new Request { } } } };
+        public ToolDescriptor Describe() => new() { Name = "editor.play-mode.start", Summary = "Enter Unity Play Mode and return only after the Editor reaches a stable playing state.", Description = "Set EditorApplication.isPlaying=true, absorb the PlayMode transition or same-session reload, and return the stable Editor state. Success proves isPlaying=true and the central PlayMode transition flag is false.", Group = "editor",DestructiveHint = false, SideEffects = new[] { "session-affecting" }, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Enter play mode", Input = new Request { } } } };
         public async System.Threading.Tasks.ValueTask<Response> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
             // 首次effect前状态由固定direct root持久化；Tool重入不再创建逐请求SessionState键。
             var before = EditorApplication.isPlaying;
-            EditorToolSupport.EnsureEditorNotBusy("editor.play");
+            EditorToolSupport.EnsureEditorNotBusy("editor.play-mode.start");
             ctx.CommitEffect();
             EditorApplication.isPaused = false;
             EditorApplication.isPlaying = true;
@@ -27,7 +27,7 @@ namespace UnityCli
                 ct: ct);
             if (!stable || !EditorApplication.isPlaying || UnityCliBridge.IsPlayModeChanging())
                 throw new UnityCliBridge.BridgeCommandException("E_PLAY_MODE_TERMINAL_NOT_OBSERVED", "Play Mode did not reach a stable playing state.", "Inspect editor.state before deciding whether to submit a new request.");
-            return new Response { Result = new PlayModeResult { Changed = !before, IsPlaying = true, IsPaused = EditorApplication.isPaused }, State = EditorToolSupport.BuildEditorState(), PlannedEffects = new List<EditorPlannedEffect> { new EditorPlannedEffect { Type = "editor.play" } } };
+            return new Response { Result = new PlayModeResult { Changed = !before, IsPlaying = true, IsPaused = EditorApplication.isPaused }, State = EditorToolSupport.BuildEditorState(), PlannedEffects = new List<EditorPlannedEffect> { new EditorPlannedEffect { Type = "editor.play-mode.start" } } };
         }
     }
 }

package/unitypkg/Editor/Tools/editor/{stop.cs → play-mode/stop.cs}

@@ -7,17 +7,17 @@ using UnityEngine.SceneManagement;
 
 namespace UnityCli
 {
-    /// <summary>editor.stop — 退出 Play Mode。</summary>
-    public class EditorStopTool : IUnityCliTool<EditorStopTool.Request, EditorStopTool.Response>
+    /// <summary>editor.play-mode.stop — 退出 Play Mode。</summary>
+    public class EditorPlayModeStopTool : IUnityCliTool<EditorPlayModeStopTool.Request, EditorPlayModeStopTool.Response>
     {
         public sealed class Request { }
         public sealed class Response { public PlayModeResult Result { get; set; } public EditorStateInfo State { get; set; } public List<EditorPlannedEffect> PlannedEffects { get; set; } }
-        public ToolDescriptor Describe() => new() { Name = "editor.stop", Summary = "Exit Unity Play Mode and return only after the Editor reaches stable Edit Mode.", Description = "Set EditorApplication.isPlaying=false, absorb the PlayMode transition or same-session reload, and return the stable Editor state. Success proves isPlaying=false and the central PlayMode transition flag is false.", Group = "editor",DestructiveHint = false, SideEffects = new[] { "session-affecting" }, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Exit play mode", Input = new Request { } } } };
+        public ToolDescriptor Describe() => new() { Name = "editor.play-mode.stop", Summary = "Exit Unity Play Mode and return only after the Editor reaches stable Edit Mode.", Description = "Set EditorApplication.isPlaying=false, absorb the PlayMode transition or same-session reload, and return the stable Editor state. Success proves isPlaying=false and the central PlayMode transition flag is false.", Group = "editor",DestructiveHint = false, SideEffects = new[] { "session-affecting" }, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Exit play mode", Input = new Request { } } } };
         public async System.Threading.Tasks.ValueTask<Response> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
             // 首次effect前状态由固定direct root持久化；Tool重入不再创建逐请求SessionState键。
             var before = EditorApplication.isPlaying;
-            EditorToolSupport.EnsureEditorNotBusy("editor.stop");
+            EditorToolSupport.EnsureEditorNotBusy("editor.play-mode.stop");
             ctx.CommitEffect();
             EditorApplication.isPaused = false;
             EditorApplication.isPlaying = false;
@@ -27,7 +27,7 @@ namespace UnityCli
                 ct: ct);
             if (!stable || EditorApplication.isPlaying || UnityCliBridge.IsPlayModeChanging())
                 throw new UnityCliBridge.BridgeCommandException("E_EDIT_MODE_TERMINAL_NOT_OBSERVED", "The Editor did not reach stable Edit Mode.", "Inspect editor.state before deciding whether to submit a new request.");
-            return new Response { Result = new PlayModeResult { Changed = before, IsPlaying = false, IsPaused = false }, State = EditorToolSupport.BuildEditorState(), PlannedEffects = new List<EditorPlannedEffect> { new EditorPlannedEffect { Type = "editor.stop" } } };
+            return new Response { Result = new PlayModeResult { Changed = before, IsPlaying = false, IsPaused = false }, State = EditorToolSupport.BuildEditorState(), PlannedEffects = new List<EditorPlannedEffect> { new EditorPlannedEffect { Type = "editor.play-mode.stop" } } };
         }
     }
 }

package/unitypkg/Editor/Tools/editor/search.cs

@@ -10,7 +10,7 @@ namespace UnityCli
         {
             Name = "editor.search",
             Summary = "Run a bounded Unity Search query with explicit provider metadata and paging.",
-            Description = "Uses UnityEditor.Search directly across active Unity Search providers. providers accepts at most 16 exact active provider IDs; omission uses the active provider set. offset accepts 0..10000 and limit defaults to 50 with a maximum of 200. At most offset+limit+1 items are scanned and only the requested page is retained. This is provider-level Unity Search, not an alias for asset.search or go.find.",
+            Description = "Uses UnityEditor.Search directly across active Unity Search providers. providers accepts at most 16 exact active provider IDs; omission uses the active provider set. offset accepts 0..10000 and limit defaults to 50 with a maximum of 200. At most offset+limit+1 items are scanned and only the requested page is retained. This is provider-level Unity Search, not an alias for asset.search or game-object.find.",
             Group = "editor",
             DestructiveHint = false,
             SupportsDryRun = false,

package/unitypkg/Editor/Tools/{go → game-object}/GameObjectToolSupport.cs

@@ -64,14 +64,14 @@ namespace UnityCli
             return options;
         }
 
-        // ─── 变更校验与应用(复刻 go.create/modify 的 ApplyGameObjectMutations/ValidateGameObjectMutationInputs) ──
+        // ─── 变更校验与应用(复刻 game-object.create/modify 的 ApplyGameObjectMutations/ValidateGameObjectMutationInputs) ──
 
         /// <summary>校验 tag/layer 输入是否有效,无效抛 BridgeCommandException。</summary>
         public static void ValidateMutationInputs(string tagValue, string layerValue)
         {
             if (!string.IsNullOrEmpty(tagValue) && !IsKnownTag(tagValue))
             {
-                throw new UnityCliBridge.BridgeCommandException("E_TAG_NOT_FOUND", "Tag not found: " + tagValue, "Create the tag first with project.tag.add or pass an existing Unity tag.");
+                throw new UnityCliBridge.BridgeCommandException("E_TAG_NOT_FOUND", "Tag not found: " + tagValue, "Create the tag first with project-settings.tag.add or pass an existing Unity tag.");
             }
             if (!string.IsNullOrEmpty(layerValue)) ParseLayer(layerValue);
         }
@@ -425,7 +425,7 @@ namespace UnityCli
             {
                 return new ComponentPropertyChange(propertyName, ConvertComponentValue(value, field.FieldType), field.FieldType, null, field, value);
             }
-            throw new UnityCliBridge.BridgeCommandException("E_COMPONENT_PROPERTY_NOT_FOUND", "Writable component property not found: " + propertyName, "Use component.get or type.schema to inspect writable public fields/properties.");
+            throw new UnityCliBridge.BridgeCommandException("E_COMPONENT_PROPERTY_NOT_FOUND", "Writable component property not found: " + propertyName, "Use component.get or runtime-reflection.type.schema to inspect writable public fields/properties.");
         }
 
         public static void ApplyComponentPropertyChanges(Component component, List<ComponentPropertyChange> changes)
@@ -456,7 +456,7 @@ namespace UnityCli
                 throw new UnityCliBridge.BridgeCommandException(
                     "E_COMPONENT_VALUE_INVALID",
                     "Component value could not be converted to " + type.Name + ": " + exception.Message,
-                    "Pass a JSON value matching the writable member type shown by component.get or type.schema.");
+                    "Pass a JSON value matching the writable member type shown by component.get or runtime-reflection.type.schema.");
             }
         }
 
@@ -545,25 +545,8 @@ namespace UnityCli
         public string SideEffects { get; set; }
     }
 
-    /// <summary>层级搜索结果项。</summary>
-    public sealed class GoFindItem
-    {
-        public long Id { get; set; }
-        public string Name { get; set; }
-        public string Path { get; set; }
-        public bool Active { get; set; }
-        public bool ActiveInHierarchy { get; set; }
-        public string Tag { get; set; }
-        public long Layer { get; set; }
-        public long ChildCount { get; set; }
-        public bool ChildrenTruncated { get; set; }
-        public long ComponentCount { get; set; }
-        public List<string> ComponentTypes { get; set; }
-        public List<string> Components { get; set; }
-    }
-
     /// <summary>分页信息。</summary>
-    public sealed class GoPageInfo
+    public sealed class GameObjectPageInfo
     {
         public long PageSize { get; set; }
         public long Cursor { get; set; }

package/unitypkg/Editor/Tools/{go → game-object}/create.cs

@@ -81,10 +81,10 @@ namespace UnityCli
 
         public ToolDescriptor Describe() => new()
         {
-            Name = "go.create",
+            Name = "game-object.create",
             Summary = "Create one or up to 1000 scene GameObjects in one call, with optional primitive, parent, and per-object local transforms.",
             Description = "count defaults to 1. For a batch, positions/rotations/scales are optional arrays of exactly count [x,y,z] vectors; scalar transform fields remain the single-object form. The parent and every input are resolved before one effect barrier. Success returns the complete ordered object set from fresh instance-id readback.",
-            Group = "go",
+            Group = "game-object",
             DestructiveHint = false,
             SideEffects = new[] { "scene-modify", "undo-stack" },
             Target = "editor",
@@ -112,14 +112,14 @@ namespace UnityCli
         /// <summary>整批预检后跨越唯一 effect barrier，在一个 Undo group 中创建并 fresh 证明完整集合。</summary>
         public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken))
         {
-            GameObjectToolSupport.EnsureEditorNotBusy("go.create");
+            GameObjectToolSupport.EnsureEditorNotBusy("game-object.create");
             ct.ThrowIfCancellationRequested();
             var plan = Prepare(request ?? new Request());
 
             ct.ThrowIfCancellationRequested();
             ctx.CommitEffect();
             var instanceIds = new List<int>(plan.Count);
-            var undoGroup = UnityCliSceneMutation.BeginUndoGroup("go.create");
+            var undoGroup = UnityCliSceneMutation.BeginUndoGroup("game-object.create");
             try
             {
                 foreach (var item in plan.Items)
@@ -132,7 +132,7 @@ namespace UnityCli
                     GameObjectToolSupport.ApplyGameObjectMutations(gameObject, null, plan.Active, plan.TagValue, plan.LayerValue,
                         item.X, item.Y, item.Z, item.RotationX, item.RotationY, item.RotationZ, item.ScaleX, item.ScaleY, item.ScaleZ);
                     ApplyLocalTransforms(gameObject.transform, item);
-                    UnityCliSceneMutation.RegisterCreatedObject(gameObject, "go.create");
+                    UnityCliSceneMutation.RegisterCreatedObject(gameObject, "game-object.create");
                     UnityCliSceneMutation.MarkSceneDirty(gameObject.scene);
                     instanceIds.Add(gameObject.GetInstanceID());
                 }
@@ -151,7 +151,7 @@ namespace UnityCli
                 GameObjects = observed,
                 PlannedEffects = new List<PlannedEffect>
                 {
-                    new PlannedEffect { Type = "go.create", Count = observed.Count, Parent = parentPath, Target = parentPath ?? "<scene-root>" }
+                    new PlannedEffect { Type = "game-object.create", Count = observed.Count, Parent = parentPath, Target = parentPath ?? "<scene-root>" }
                 }
             });
         }
@@ -161,7 +161,7 @@ namespace UnityCli
         {
             var count = request.Count ?? 1;
             if (count < 1 || count > MaxBatchCount)
-                throw Error("E_GO_BATCH_COUNT_INVALID", "go.create count must be between 1 and " + MaxBatchCount + ".", "count", count);
+                throw Error("E_GO_BATCH_COUNT_INVALID", "game-object.create count must be between 1 and " + MaxBatchCount + ".", "count", count);
             ValidateVectorArray(request.Positions, count, "positions");
             ValidateVectorArray(request.Rotations, count, "rotations");
             ValidateVectorArray(request.Scales, count, "scales");
@@ -180,7 +180,7 @@ namespace UnityCli
                 : GameObjectToolSupport.ParsePrimitiveType(request.Primitive);
             var baseName = request.Name ?? request.Target ?? "GameObject";
             if (string.IsNullOrWhiteSpace(baseName))
-                throw Error("E_GO_CREATE_NAME_INVALID", "go.create name must not be empty or whitespace.", "name", null);
+                throw Error("E_GO_CREATE_NAME_INVALID", "game-object.create name must not be empty or whitespace.", "name", null);
 
             var items = new List<CreateItemPlan>(count);
             for (var index = 0; index < count; index++)
@@ -261,13 +261,13 @@ namespace UnityCli
         private static List<GameObjectDetail> Prove(CreatePlan plan, List<int> instanceIds)
         {
             if (instanceIds.Count != plan.Count)
-                throw Error("E_GO_CREATE_SET_MISMATCH", "go.create did not produce the requested object count.", "count", instanceIds.Count);
+                throw Error("E_GO_CREATE_SET_MISMATCH", "game-object.create did not produce the requested object count.", "count", instanceIds.Count);
             var uniqueIds = new HashSet<int>();
             var result = new List<GameObjectDetail>(plan.Count);
             for (var index = 0; index < instanceIds.Count; index++)
             {
                 if (!uniqueIds.Add(instanceIds[index]))
-                    throw Error("E_GO_CREATE_SET_MISMATCH", "go.create returned a duplicate object identity.", "instanceId", instanceIds[index]);
+                    throw Error("E_GO_CREATE_SET_MISMATCH", "game-object.create returned a duplicate object identity.", "instanceId", instanceIds[index]);
                 var observed = EditorUtility.InstanceIDToObject(instanceIds[index]) as GameObject;
                 var expected = plan.Items[index];
                 if (observed == null || !observed.scene.IsValid() || !observed.scene.isLoaded
@@ -326,7 +326,7 @@ namespace UnityCli
                 code,
                 message,
                 new Dictionary<string, object> { { "field", field }, { "actual", actual } },
-                new[] { "Inspect tools describe go.create and submit one valid single-object or batch request." });
+                new[] { "Inspect tools describe game-object.create and submit one valid single-object or batch request." });
         }
     }
 }

package/unitypkg/Editor/Tools/{go → game-object}/delete.cs

@@ -4,7 +4,7 @@ using System.Collections.Generic;
 namespace UnityCli
 {
     /// <summary>
-    /// go.delete — 从场景删除单个 GameObject(递归删除子级)。支持 dryRun 预览。
+    /// game-object.delete — 从场景删除单个 GameObject(递归删除子级)。支持 dryRun 预览。
     /// </summary>
     public class GameObjectDeleteTool : IUnityCliTool<GameObjectDeleteTool.Request, GameObjectDeleteTool.Result>
     {
@@ -23,10 +23,10 @@ namespace UnityCli
 
         public ToolDescriptor Describe() => new()
         {
-            Name = "go.delete",
+            Name = "game-object.delete",
             Summary = "Delete one scene GameObject; EditMode stays dirty, and final PlayMode proof requires reading editor.state.",
             Description = "Delete one GameObject from the current scene/session and recursively remove its children. Dry-run returns target with destroyed=false. Live execution returns deleted with destroyed=true only after the target no longer exists; Play Mode scene instances are destroyed synchronously before the command returns. In EditMode, deletion adds shared Undo history and intentionally leaves the scene dirty. If a task started from a clean scene and must discard all temporary in-memory changes without saving, finish business verification, delete the temporary object, then call scene.load once with the exact active scene path; do not probe or repeat editor.undo when pre-existing Undo history is unknown. When final PlayMode is a task requirement, read the editor.state Context after cleanup. Prefer hierarchy paths or instance ids when plain names may be ambiguous.",
-            Group = "go",
+            Group = "game-object",
             DestructiveHint = false,
             SupportsDryRun = true,
             SideEffects = new[] { "scene-modify", "undo-stack", "recursive-delete" },
@@ -43,7 +43,7 @@ namespace UnityCli
 
         public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
-            GameObjectToolSupport.EnsureEditorNotBusy("go.delete");
+            GameObjectToolSupport.EnsureEditorNotBusy("game-object.delete");
             if (string.IsNullOrEmpty(request.Target))
             {
                 throw new UnityCliBridge.BridgeCommandException("E_TARGET_NOT_FOUND", "GameObject delete requires a target.", "Pass a GameObject name, hierarchy path or instance id.");
@@ -56,7 +56,7 @@ namespace UnityCli
                 {
                     DryRun = true,
                     Destroyed = false,
-                    PlannedEffects = new List<GameObjectPlannedEffect> { new GameObjectPlannedEffect { Type = "go.delete", Target = targetRef.Path, SideEffects = "none" } }
+                    PlannedEffects = new List<GameObjectPlannedEffect> { new GameObjectPlannedEffect { Type = "game-object.delete", Target = targetRef.Path, SideEffects = "none" } }
                 });
             }
             var scene = gameObject.scene;
@@ -72,14 +72,14 @@ namespace UnityCli
                         { "target", targetRef.Path },
                         { "instanceId", targetRef.Id }
                     },
-                    new[] { "Run tools run scene.gameobject for the target and inspect console.get before retrying." });
+                    new[] { "Run tools run scene.gameobject for the target and inspect console.read before retrying." });
             }
             UnityCliSceneMutation.MarkSceneDirty(scene);
             return new System.Threading.Tasks.ValueTask<Result>(new Result
             {
                 Deleted = targetRef,
                 Destroyed = true,
-                PlannedEffects = new List<GameObjectPlannedEffect> { new GameObjectPlannedEffect { Type = "go.delete", Target = targetRef.Path } }
+                PlannedEffects = new List<GameObjectPlannedEffect> { new GameObjectPlannedEffect { Type = "game-object.delete", Target = targetRef.Path } }
             });
         }
     }

package/unitypkg/Editor/Tools/{go → game-object}/duplicate.cs

@@ -7,7 +7,7 @@ using UnityEngine;
 namespace UnityCli
 {
     /// <summary>
-    /// go.duplicate — 复制场景中的 GameObject,可指定新名称或父级。
+    /// game-object.duplicate — 复制场景中的 GameObject,可指定新名称或父级。
     /// </summary>
     public class GameObjectDuplicateTool : IUnityCliTool<GameObjectDuplicateTool.Request, GameObjectDuplicateTool.Result>
     {
@@ -27,10 +27,10 @@ namespace UnityCli
 
         public ToolDescriptor Describe() => new()
         {
-            Name = "go.duplicate",
+            Name = "game-object.duplicate",
             Summary = "Duplicate a GameObject in the active scene, optionally assigning a new name or parent.",
             Description = "Duplicate a GameObject in the active scene, optionally assigning a new name or parent. Prefer hierarchy paths or instance ids for target and parent; returns the duplicate path/id so follow-up calls can avoid ambiguous names.",
-            Group = "go",
+            Group = "game-object",
             DestructiveHint = false,
             SideEffects = new[] { "scene-modify", "undo-stack" },
             Target = "editor",
@@ -45,7 +45,7 @@ namespace UnityCli
 
         public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
-            GameObjectToolSupport.EnsureEditorNotBusy("go.duplicate");
+            GameObjectToolSupport.EnsureEditorNotBusy("game-object.duplicate");
             if (string.IsNullOrEmpty(request.Target))
             {
                 throw new UnityCliBridge.BridgeCommandException("E_TARGET_NOT_FOUND", "GameObject duplicate requires a target.", "Pass a GameObject name, hierarchy path or instance id.");
@@ -56,7 +56,7 @@ namespace UnityCli
             var duplicateName = request.NewName ?? request.Name ?? (source.name + " Copy");
             ctx.CommitEffect();
             var duplicate = UnityEngine.Object.Instantiate(source);
-            UnityCliSceneMutation.RegisterCreatedObject(duplicate, "go.duplicate");
+            UnityCliSceneMutation.RegisterCreatedObject(duplicate, "game-object.duplicate");
             var duplicateId = duplicate.GetInstanceID();
             duplicate.name = duplicateName;
             duplicate.transform.SetParent(parentTransform, true);
@@ -68,7 +68,7 @@ namespace UnityCli
             return new System.Threading.Tasks.ValueTask<Result>(new Result
             {
                 GameObject = GameObjectToolSupport.BuildGameObjectDetail(observed),
-                PlannedEffects = new List<GameObjectPlannedEffect> { new GameObjectPlannedEffect { Type = "go.duplicate", Target = GameObjectToolSupport.HierarchyPath(observed) } }
+                PlannedEffects = new List<GameObjectPlannedEffect> { new GameObjectPlannedEffect { Type = "game-object.duplicate", Target = GameObjectToolSupport.HierarchyPath(observed) } }
             });
         }
     }

package/unitypkg/Editor/Tools/{go → game-object}/find.cs

@@ -8,7 +8,7 @@ using UnityEngine.SceneManagement;
 
 namespace UnityCli
 {
-    /// <summary>go.find — exact selector 直达，其他 selector 按 raw hierarchy position 有界续页。</summary>
+    /// <summary>game-object.find — exact selector 直达，其他 selector 按 raw hierarchy position 有界续页。</summary>
     public class GameObjectFindTool : IUnityCliTool<GameObjectFindTool.Request, GameObjectFindTool.Result>
     {
         public sealed class Request
@@ -65,10 +65,10 @@ namespace UnityCli
 
         public ToolDescriptor Describe() => new()
         {
-            Name = "go.find",
+            Name = "game-object.find",
             Summary = "Resolve exact GameObject ids/paths directly or page filtered hierarchy matches from stable raw positions.",
             Description = "Search loaded GameObjects by exact name, tag, layer or component. by_id uses direct instance resolution and by_path walks only the exact case-sensitive path; neither materializes the scene tree. Other selectors stream Unity hierarchy order with pageSize 1..500 (default 50). All work shares budget defaults of 10000 scans, 4096 nodes, 2048 getters, 4096 reflection calls, 250 main-thread ms and 1 MiB UTF-8; maxima are 100000/20000/10000/20000/2000 ms/8 MiB. No filtered total is fabricated: pageInfo.complete/truncated and nextCursor identify the next raw object. preferPrefabStage scans the open Prefab Stage first. Read-only in Edit and Play Mode.",
-            Group = "go",
+            Group = "game-object",
             DestructiveHint = false,
             Target = "editor",
             PlayModeSupport = "supported",
@@ -130,7 +130,7 @@ namespace UnityCli
             if (string.IsNullOrEmpty(request.Cursor)) current = prefabOpen ? prefabRoot : sceneTraversal.First(budget);
             else
             {
-                current = UnityCliHierarchyPager.ResolveCursor(request.Cursor, "go.find", generation, budget, out phase);
+                current = UnityCliHierarchyPager.ResolveCursor(request.Cursor, "game-object.find", generation, budget, out phase);
                 if (phase != "scene" && phase != "prefab") throw UnityCliHierarchyPager.Stale();
                 if (phase == "prefab" && (!prefabOpen || !IsDescendantOrSelf(current.transform, prefabRoot.transform, budget))) throw UnityCliHierarchyPager.Stale();
                 if (phase == "scene" && prefabOpen && current.scene.handle == prefabStage.scene.handle) throw UnityCliHierarchyPager.Stale();
@@ -159,7 +159,7 @@ namespace UnityCli
             }
 
             if (items.Count == 0 && current != null) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension ?? "scannedRecords");
-            var nextCursor = UnityCliHierarchyPager.Cursor("go.find", generation, phase, current, budget);
+            var nextCursor = UnityCliHierarchyPager.Cursor("game-object.find", generation, phase, current, budget);
             return new System.Threading.Tasks.ValueTask<Result>(ResultPage(items, pageSize, request.Cursor, nextCursor, generation, prefabOpen, budget));
         }
 

package/unitypkg/Editor/Tools/{go → game-object}/look-at.cs

@@ -7,7 +7,7 @@ using UnityEngine;
 namespace UnityCli
 {
     /// <summary>
-    /// go.look-at — 旋转 GameObject 使其 forward 指向另一个 GameObject。
+    /// game-object.look-at — 旋转 GameObject 使其 forward 指向另一个 GameObject。
     /// </summary>
     public class GameObjectLookAtTool : IUnityCliTool<GameObjectLookAtTool.Request, GameObjectLookAtTool.Result>
     {
@@ -26,10 +26,10 @@ namespace UnityCli
 
         public ToolDescriptor Describe() => new()
         {
-            Name = "go.look-at",
+            Name = "game-object.look-at",
             Summary = "Rotate a GameObject so its forward vector looks at another GameObject.",
             Description = "Rotate a GameObject so its forward vector looks at another GameObject. Prefer hierarchy paths or instance ids for both target and lookAt after create/duplicate operations.",
-            Group = "go",
+            Group = "game-object",
             DestructiveHint = false,
             SideEffects = new[] { "scene-modify", "undo-stack" },
             Target = "editor",
@@ -44,22 +44,22 @@ namespace UnityCli
 
         public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
-            GameObjectToolSupport.EnsureEditorNotBusy("go.look-at");
+            GameObjectToolSupport.EnsureEditorNotBusy("game-object.look-at");
             if (string.IsNullOrEmpty(request.Target))
             {
                 throw new UnityCliBridge.BridgeCommandException("E_TARGET_NOT_FOUND", "GameObject look-at requires a target.", "Pass a GameObject name, hierarchy path or instance id.");
             }
             var gameObject = GameObjectToolSupport.ResolveUniqueTarget(request.Target, "GameObject look-at requires a target.");
             var lookAtName = request.LookAt ?? request.Destination;
-            var lookAt = GameObjectToolSupport.ResolveUniqueTarget(lookAtName, "GameObject look-at requires a lookAt target. Use unitycli tools run go.look-at --input '{\"target\":\"CameraRig\",\"lookAt\":\"Player\"}'.");
+            var lookAt = GameObjectToolSupport.ResolveUniqueTarget(lookAtName, "GameObject look-at requires a lookAt target. Use unitycli tools run game-object.look-at --input '{\"target\":\"CameraRig\",\"lookAt\":\"Player\"}'.");
             var gameObjectId = gameObject.GetInstanceID();
             var direction = lookAt.transform.position - gameObject.transform.position;
             if (direction.sqrMagnitude <= Mathf.Epsilon)
-                throw new UnityCliBridge.BridgeCommandException("E_GO_LOOK_AT_DIRECTION_INVALID", "GameObject look-at target must not share the target position.", "Move one object before calling go.look-at.");
+                throw new UnityCliBridge.BridgeCommandException("E_GO_LOOK_AT_DIRECTION_INVALID", "GameObject look-at target must not share the target position.", "Move one object before calling game-object.look-at.");
             // 在 barrier 前冻结 LookAt 的不可变期望旋转，写入后只接受 fresh readback。
             var expectedRotation = Quaternion.LookRotation(direction);
             ctx.CommitEffect();
-            UnityCliSceneMutation.RecordObject(gameObject.transform, "go.look-at");
+            UnityCliSceneMutation.RecordObject(gameObject.transform, "game-object.look-at");
             gameObject.transform.rotation = expectedRotation;
             UnityCliSceneMutation.MarkSceneDirty(gameObject.scene);
             var observed = EditorUtility.InstanceIDToObject(gameObjectId) as GameObject;
@@ -68,7 +68,7 @@ namespace UnityCli
             return new System.Threading.Tasks.ValueTask<Result>(new Result
             {
                 GameObject = GameObjectToolSupport.BuildGameObjectDetail(observed),
-                PlannedEffects = new List<GameObjectPlannedEffect> { new GameObjectPlannedEffect { Type = "go.look-at", Target = GameObjectToolSupport.HierarchyPath(observed) } }
+                PlannedEffects = new List<GameObjectPlannedEffect> { new GameObjectPlannedEffect { Type = "game-object.look-at", Target = GameObjectToolSupport.HierarchyPath(observed) } }
             });
         }
     }