@alpsckr/unitycli 0.4.0

package/extensions/hdrp/unitypkg/Editor/Hdrp/settings-get.cs

@@ -0,0 +1,29 @@
+#if UNITY_EDITOR
+using System.Collections.Generic;
+
+namespace UnityCli
+{
+    /// <summary>读取活动 HDRP pipeline asset 设置。</summary>
+    public sealed class HdrpSettingsGetTool : IUnityCliTool<HdrpSettingsGetTool.Request, HdrpSettingsGetTool.Result>
+    {
+        public sealed class Request { }
+        public sealed class Result { [UnityCliAnyJson] public Dictionary<string, object> Settings { get; set; } }
+
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "hdrp.settings.get", Summary = "Read active HDRP pipeline asset settings.",
+            Description = "Read supported public settings from the active HDRenderPipelineAsset without modifying it.",
+            Group = "hdrp",RequiresPackages = new[] { "com.unity.render-pipelines.high-definition" },
+            SideEffects = new string[0], Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000,
+            Examples = new[] { new ToolExample { Description = "Read HDRP settings", Input = new Request() } }
+        };
+
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext context, System.Threading.CancellationToken ct = default)
+        {
+            GameObjectToolSupport.EnsureEditorNotBusy("hdrp.settings.get");
+            var pipeline = HdrpToolSupport.GetActivePipelineAsset();
+            return new System.Threading.Tasks.ValueTask<Result>(new Result { Settings = HdrpToolSupport.ReadSettings(pipeline)});
+        }
+    }
+}
+#endif

package/extensions/hdrp/unitypkg/Editor/Hdrp/settings-set.cs

@@ -0,0 +1,47 @@
+#if UNITY_EDITOR
+using System;
+using System.Collections.Generic;
+using System.Reflection;
+using UnityEditor;
+
+namespace UnityCli
+{
+    /// <summary>设置活动 HDRP pipeline asset 的一个属性。</summary>
+    public sealed class HdrpSettingsSetTool : IUnityCliTool<HdrpSettingsSetTool.Request, HdrpSettingsSetTool.Result>
+    {
+        public sealed class Request { [UnityCliRequired] public string Property { get; set; } [UnityCliRequired] public string Value { get; set; } }
+        public sealed class Result { public string ObservedValue { get; set; } [UnityCliAnyJson] public Dictionary<string, object> Settings { get; set; } public bool DryRun { get; set; } public List<HdrpPlannedEffect> PlannedEffects { get; set; } }
+
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "hdrp.settings.set", Summary = "Set one active HDRP pipeline asset setting.",
+            Description = "Set one public property or SerializedProperty on the active HDRenderPipelineAsset. Supports --dry-run without saving the asset.",
+            Group = "hdrp",DestructiveHint = true, SupportsDryRun = true,
+            RequiresPackages = new[] { "com.unity.render-pipelines.high-definition" }, SideEffects = new[] { "asset-write", "render-pipeline-settings" },
+            Target = "editor", PlayModeSupport = "editor-only", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000,
+            Examples = new[] { new ToolExample { Description = "Rename the HDRP asset", Input = new Request { Property = "name", Value = "Matrix HDRP" } } }
+        };
+
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            GameObjectToolSupport.EnsureEditorNotBusy("hdrp.settings.set");
+            var pipeline = HdrpToolSupport.GetActivePipelineAsset();
+            var plan = HdrpToolSupport.PrepareSetting(pipeline, request.Property, request.Value);
+            var effects = new List<HdrpPlannedEffect> { new HdrpPlannedEffect { Type = "hdrp.settings.set", Property = request.Property, Value = request.Value } };
+            var observedValue = request.Value;
+            var pipelinePath = AssetDatabase.GetAssetPath(pipeline);
+            if (!ctx.DryRun && string.IsNullOrEmpty(pipelinePath)) throw new UnityCliBridge.BridgeCommandException("E_HDRP_SETTING_PERSISTENCE_UNPROVABLE", "HDRP pipeline setting cannot be independently persisted because the active pipeline has no asset path.", "Use an asset-backed pipeline or add a contract strategy for transient pipeline settings.");
+            if (!ctx.DryRun) ctx.CommitEffect();
+            if (!ctx.DryRun)
+            {
+                HdrpToolSupport.ApplySetting(plan);
+                AssetDatabase.SaveAssets();
+                AssetDatabase.ImportAsset(pipelinePath, ImportAssetOptions.ForceUpdate);
+                observedValue = HdrpToolSupport.VerifySettingReadback(plan, AssetDatabase.LoadAssetAtPath<UnityEngine.Object>(pipelinePath));
+            }
+            var observedPipeline = ctx.DryRun ? pipeline : HdrpToolSupport.GetActivePipelineAsset();
+            return new System.Threading.Tasks.ValueTask<Result>(new Result { ObservedValue = observedValue, Settings = HdrpToolSupport.ReadSettings(observedPipeline), DryRun = ctx.DryRun, PlannedEffects = effects});
+        }
+    }
+}
+#endif

package/extensions/hdrp/unitypkg/Editor/Hdrp/volume-add-effect.cs

@@ -0,0 +1,28 @@
+#if UNITY_EDITOR
+using System.Collections.Generic;
+
+namespace UnityCli
+{
+    /// <summary>hdrp.volume.add-effect：向 HDRP Volume 的内存 profile 添加效果。</summary>
+    public sealed class HdrpVolumeAddEffectTool : IUnityCliTool<HdrpVolumeAddEffectTool.Request, HdrpVolumeAddEffectTool.Result>
+    {
+        public sealed class Request { [UnityCliRequired] public string Target { get; set; } [UnityCliRequired] public string EffectType { get; set; } }
+        public sealed class Result { public List<HdrpPlannedEffect> PlannedEffects { get; set; } }
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "hdrp.volume.add-effect", Summary = "Add a VolumeComponent effect to a scene-session HDRP Volume profile.",
+            Description = "Adds effectType to the in-memory profile on the target HDRP Volume. target accepts a GameObject name or hierarchy path. The profile and scene remain unsaved. Requires com.unity.render-pipelines.high-definition and an active HDRenderPipelineAsset.",
+            Group = "hdrp",DestructiveHint = false, RequiresPackages = new[] { "com.unity.render-pipelines.high-definition" }, SideEffects = new[] { "scene-modify", "volume-profile-edit" }, Target = "editor", PlayModeSupport = "session-affecting", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000,
+            Examples = new[] { new ToolExample { Description = "Add VisualEnvironment", Input = new Request { Target = "GlobalVolume", EffectType = "VisualEnvironment" } } }
+        };
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            GameObjectToolSupport.EnsureEditorNotBusy("hdrp.volume.add-effect"); HdrpToolSupport.EnsureHdrpAvailable();
+            HdrpVolumeOperations.ValidateAddEffect(request.Target, request.EffectType, "E_HDRP", HdrpToolSupport.FindVolumeEffectType);
+            ctx.CommitEffect();
+            var added = HdrpVolumeOperations.AddEffect(request.Target, request.EffectType, "E_HDRP", HdrpToolSupport.FindVolumeEffectType);
+            return new System.Threading.Tasks.ValueTask<Result>(new Result { PlannedEffects = new List<HdrpPlannedEffect> { new HdrpPlannedEffect { Type = "hdrp.volume.add-effect", Target = GameObjectToolSupport.HierarchyPath(added.GameObject), EffectType = added.ObservedEffectType } }});
+        }
+    }
+}
+#endif

package/extensions/hdrp/unitypkg/Editor/Hdrp/volume-create.cs

@@ -0,0 +1,28 @@
+#if UNITY_EDITOR
+using System.Collections.Generic;
+
+namespace UnityCli
+{
+    /// <summary>hdrp.volume.create：创建仅存在于当前会话的 HDRP Volume。</summary>
+    public sealed class HdrpVolumeCreateTool : IUnityCliTool<HdrpVolumeCreateTool.Request, HdrpVolumeCreateTool.Result>
+    {
+        public sealed class Request { public string Name { get; set; } public bool? IsGlobal { get; set; } public double? Priority { get; set; } public double? Weight { get; set; } }
+        public sealed class Result { public GameObjectRef Target { get; set; } public List<HdrpPlannedEffect> PlannedEffects { get; set; } }
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "hdrp.volume.create", Summary = "Create a scene-session HDRP Volume with a new in-memory profile.",
+            Description = "Creates an HDRP Volume GameObject and assigns a new in-memory VolumeProfile. name defaults to HDRPVolume; isGlobal defaults to true. The scene and profile are not saved as assets. Requires com.unity.render-pipelines.high-definition and an active HDRenderPipelineAsset.",
+            Group = "hdrp",DestructiveHint = false, RequiresPackages = new[] { "com.unity.render-pipelines.high-definition" }, SideEffects = new[] { "scene-modify", "volume-profile-edit" }, Target = "editor", PlayModeSupport = "session-affecting", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000,
+            Examples = new[] { new ToolExample { Description = "Create a global HDRP volume", Input = new Request { Name = "GlobalVolume", IsGlobal = true } }, new ToolExample { Description = "Create a weighted HDRP volume", Input = new Request { Name = "OptionalHDRPVolume", IsGlobal = true, Priority = 1, Weight = 0.5 } } }
+        };
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            GameObjectToolSupport.EnsureEditorNotBusy("hdrp.volume.create"); HdrpToolSupport.EnsureHdrpAvailable();
+            var plan = HdrpVolumeOperations.ValidateCreate(request.Priority, request.Weight, "E_HDRP");
+            ctx.CommitEffect();
+            var created = HdrpVolumeOperations.Create(request.Name, request.IsGlobal, plan, "HDRP", "E_HDRP");
+            return new System.Threading.Tasks.ValueTask<Result>(new Result { Target = GameObjectToolSupport.BuildGameObjectRef(created.GameObject), PlannedEffects = new List<HdrpPlannedEffect> { new HdrpPlannedEffect { Type = "hdrp.volume.create", Name = created.GameObject.name } }});
+        }
+    }
+}
+#endif

package/extensions/hdrp/unitypkg/Editor/Hdrp/volume-info.cs

@@ -0,0 +1,25 @@
+#if UNITY_EDITOR
+using System.Collections.Generic;
+
+namespace UnityCli
+{
+    /// <summary>hdrp.volume.info：读取一个 HDRP Volume 的会话状态。</summary>
+    public sealed class HdrpVolumeInfoTool : IUnityCliTool<HdrpVolumeInfoTool.Request, HdrpVolumeInfoTool.Result>
+    {
+        public sealed class Request { [UnityCliRequired] public string Target { get; set; } }
+        public sealed class Result { public List<VolumeInfo> Volumes { get; set; } }
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "hdrp.volume.info", Summary = "Read one scene-session HDRP Volume component and in-memory profile reference.",
+            Description = "Reads the HDRP Volume matching target by GameObject name or hierarchy path. Returns its current session state and profile reference. Requires com.unity.render-pipelines.high-definition and an active HDRenderPipelineAsset. Does not save scenes or assets.",
+            Group = "hdrp",DestructiveHint = false, RequiresPackages = new[] { "com.unity.render-pipelines.high-definition" }, SideEffects = new string[0], Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000,
+            Examples = new[] { new ToolExample { Description = "Inspect an HDRP volume", Input = new Request { Target = "GlobalVolume" } } }
+        };
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            GameObjectToolSupport.EnsureEditorNotBusy("hdrp.volume.info"); HdrpToolSupport.EnsureHdrpAvailable(); HdrpVolumeOperations.RequireTarget(request.Target, "info");
+            return new System.Threading.Tasks.ValueTask<Result>(new Result { Volumes = HdrpToolSupport.ListVolumes(request.Target)});
+        }
+    }
+}
+#endif

package/extensions/hdrp/unitypkg/Editor/Hdrp/volume-list.cs

@@ -0,0 +1,25 @@
+#if UNITY_EDITOR
+using System.Collections.Generic;
+
+namespace UnityCli
+{
+    /// <summary>hdrp.volume.list：列出当前场景会话中的 HDRP Volume。</summary>
+    public sealed class HdrpVolumeListTool : IUnityCliTool<HdrpVolumeListTool.Request, HdrpVolumeListTool.Result>
+    {
+        public sealed class Request { }
+        public sealed class Result { public List<VolumeInfo> Volumes { get; set; } }
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "hdrp.volume.list", Summary = "List scene-session HDRP Volume components and their in-memory profiles.",
+            Description = "Lists HDRP Volume components in loaded scenes with their global state, priority, weight, and current in-memory profile reference. Requires com.unity.render-pipelines.high-definition and an active HDRenderPipelineAsset. Does not save scenes or assets.",
+            Group = "hdrp",DestructiveHint = false, RequiresPackages = new[] { "com.unity.render-pipelines.high-definition" }, SideEffects = new string[0], Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000,
+            Examples = new[] { new ToolExample { Description = "List HDRP volumes", Input = new Request() } }
+        };
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            GameObjectToolSupport.EnsureEditorNotBusy("hdrp.volume.list"); HdrpToolSupport.EnsureHdrpAvailable();
+            return new System.Threading.Tasks.ValueTask<Result>(new Result { Volumes = HdrpToolSupport.ListVolumes(null)});
+        }
+    }
+}
+#endif

package/extensions/hdrp/unitypkg/Editor/Hdrp/volume-set.cs

@@ -0,0 +1,28 @@
+#if UNITY_EDITOR
+using System.Collections.Generic;
+
+namespace UnityCli
+{
+    /// <summary>hdrp.volume.set：修改 HDRP Volume 内存 profile 中的效果参数。</summary>
+    public sealed class HdrpVolumeSetTool : IUnityCliTool<HdrpVolumeSetTool.Request, HdrpVolumeSetTool.Result>
+    {
+        public sealed class Request { [UnityCliRequired] public string Target { get; set; } [UnityCliRequired] public string EffectType { get; set; } [UnityCliRequired] public string Property { get; set; } [UnityCliRequired] public string Value { get; set; } }
+        public sealed class Result { public List<HdrpPlannedEffect> PlannedEffects { get; set; } }
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "hdrp.volume.set", Summary = "Set a scalar serialized parameter on a scene-session HDRP Volume effect.",
+            Description = "Sets property on effectType in the target HDRP Volume's in-memory profile, verifies its typed SerializedProperty readback, and returns the observed value. property is a SerializedProperty path such as intensity.m_Value. Only scalar serialized values are supported. The profile and scene remain unsaved. Requires com.unity.render-pipelines.high-definition and an active HDRenderPipelineAsset.",
+            Group = "hdrp",DestructiveHint = false, RequiresPackages = new[] { "com.unity.render-pipelines.high-definition" }, SideEffects = new[] { "scene-modify", "volume-profile-edit" }, Target = "editor", PlayModeSupport = "session-affecting", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000,
+            Examples = new[] { new ToolExample { Description = "Set Bloom intensity", Input = new Request { Target = "GlobalVolume", EffectType = "Bloom", Property = "intensity.m_Value", Value = "1.5" } } }
+        };
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            GameObjectToolSupport.EnsureEditorNotBusy("hdrp.volume.set"); HdrpToolSupport.EnsureHdrpAvailable();
+            var plan = HdrpVolumeOperations.ValidateSet(request.Target, request.EffectType, request.Property, request.Value, "E_HDRP", HdrpToolSupport.FindVolumeEffectType);
+            ctx.CommitEffect();
+            var set = HdrpVolumeOperations.Set(plan, "E_HDRP");
+            return new System.Threading.Tasks.ValueTask<Result>(new Result { PlannedEffects = new List<HdrpPlannedEffect> { new HdrpPlannedEffect { Type = "hdrp.volume.set", Target = GameObjectToolSupport.HierarchyPath(set.GameObject), EffectType = set.ObservedEffectType, Property = request.Property, Value = set.Value } }});
+        }
+    }
+}
+#endif

package/extensions/hdrp/unitypkg/UnityCli.Extensions.Hdrp.Editor.asmdef

@@ -0,0 +1,19 @@
+{
+  "name": "UnityCli.Extensions.Hdrp.Editor",
+  "rootNamespace": "UnityCli.Hdrp",
+  "references": [
+    "UnityCli.Editor",
+    "Unity.RenderPipelines.Core.Runtime"
+  ],
+  "includePlatforms": [
+    "Editor"
+  ],
+  "excludePlatforms": [],
+  "allowUnsafeCode": false,
+  "overrideReferences": false,
+  "precompiledReferences": [],
+  "autoReferenced": true,
+  "defineConstraints": [],
+  "versionDefines": [],
+  "noEngineReferences": false
+}

package/extensions/probuilder/bridge/domains/probuilder.ts

@@ -0,0 +1,386 @@
+import { boolFlag, compactArgs, floatFlag, numberFlag, queryArgs, stringFlag, targetArgs } from "../args.js";
+import type { BridgeCommandSpec, BridgeFlags } from "../types.js";
+
+/**
+ * ProBuilder extension bridge specs — 37 single-action tools.
+ *
+ * Each CLI command is routed through the project-tool.run bridge command
+ * to reach ProBuilder IUnityCliTool handlers in the Unity package. The
+ * bridgeCommand field is always "project-tool.run";
+ * the toolName field carries the underlying project-tool name (e.g.
+ * "probuilder.ping"). The buildArgs output is wrapped into { name, input }
+ * so the C# ProjectToolRun handler receives both the tool name and its
+ * JSON input payload.
+ */
+
+export const probuilderBridgeSpecs: BridgeCommandSpec[] = markToolsOnly([
+  // ─── Utility ───────────────────────────────────────────
+  { group: "probuilder", command: "ping", bridgeCommand: "project-tool.run", toolName: "probuilder.ping", buildArgs: probuilderPingArgs },
+  { group: "probuilder", command: "scene", bridgeCommand: "project-tool.run", toolName: "probuilder.scene", buildArgs: probuilderSceneArgs },
+
+  // ─── Shape Creation ────────────────────────────────────
+  { group: "probuilder", command: "create-shape", bridgeCommand: "project-tool.run", toolName: "probuilder.create-shape", buildArgs: probuilderCreateShapeArgs },
+  { group: "probuilder", command: "create-poly-shape", bridgeCommand: "project-tool.run", toolName: "probuilder.create-poly-shape", buildArgs: probuilderCreatePolyShapeArgs },
+
+  // ─── Face Operations ──────────────────────────────────
+  { group: "probuilder", command: "extrude-faces", bridgeCommand: "project-tool.run", toolName: "probuilder.extrude-faces", buildArgs: probuilderTargetWithIndicesArgs },
+  { group: "probuilder", command: "delete-faces", bridgeCommand: "project-tool.run", toolName: "probuilder.delete-faces", buildArgs: probuilderTargetWithIndicesArgs },
+  { group: "probuilder", command: "detach-faces", bridgeCommand: "project-tool.run", toolName: "probuilder.detach-faces", buildArgs: probuilderDetachFacesArgs },
+  { group: "probuilder", command: "merge-faces", bridgeCommand: "project-tool.run", toolName: "probuilder.merge-faces", buildArgs: probuilderTargetWithIndicesArgs },
+  { group: "probuilder", command: "subdivide", bridgeCommand: "project-tool.run", toolName: "probuilder.subdivide", buildArgs: probuilderTargetWithOptionalIndicesArgs },
+  { group: "probuilder", command: "flip-normals", bridgeCommand: "project-tool.run", toolName: "probuilder.flip-normals", buildArgs: probuilderTargetWithOptionalIndicesArgs },
+  { group: "probuilder", command: "select-faces", bridgeCommand: "project-tool.run", toolName: "probuilder.select-faces", buildArgs: probuilderSelectFacesArgs },
+  { group: "probuilder", command: "set-face-material", bridgeCommand: "project-tool.run", toolName: "probuilder.set-face-material", buildArgs: probuilderSetFaceMaterialArgs },
+  { group: "probuilder", command: "set-face-color", bridgeCommand: "project-tool.run", toolName: "probuilder.set-face-color", buildArgs: probuilderSetFaceColorArgs },
+  { group: "probuilder", command: "set-face-uvs", bridgeCommand: "project-tool.run", toolName: "probuilder.set-face-uvs", buildArgs: probuilderSetFaceUvsArgs },
+
+  // ─── Edge Operations ──────────────────────────────────
+  { group: "probuilder", command: "extrude-edges", bridgeCommand: "project-tool.run", toolName: "probuilder.extrude-edges", buildArgs: probuilderEdgeArgs },
+  { group: "probuilder", command: "bevel-edges", bridgeCommand: "project-tool.run", toolName: "probuilder.bevel-edges", buildArgs: probuilderBevelArgs },
+  { group: "probuilder", command: "bridge-edges", bridgeCommand: "project-tool.run", toolName: "probuilder.bridge-edges", buildArgs: probuilderBridgeEdgesArgs },
+  { group: "probuilder", command: "connect-elements", bridgeCommand: "project-tool.run", toolName: "probuilder.connect-elements", buildArgs: probuilderConnectArgs },
+
+  // ─── Mesh Combine / Merge ─────────────────────────────
+  { group: "probuilder", command: "combine-meshes", bridgeCommand: "project-tool.run", toolName: "probuilder.combine-meshes", buildArgs: probuilderMultiTargetArgs },
+  { group: "probuilder", command: "merge-objects", bridgeCommand: "project-tool.run", toolName: "probuilder.merge-objects", buildArgs: probuilderMergeObjectsArgs },
+  { group: "probuilder", command: "duplicate-and-flip", bridgeCommand: "project-tool.run", toolName: "probuilder.duplicate-and-flip", buildArgs: probuilderTargetWithOptionalIndicesArgs },
+  { group: "probuilder", command: "create-polygon", bridgeCommand: "project-tool.run", toolName: "probuilder.create-polygon", buildArgs: probuilderCreatePolygonArgs },
+
+  // ─── Vertex Operations ────────────────────────────────
+  { group: "probuilder", command: "merge-vertices", bridgeCommand: "project-tool.run", toolName: "probuilder.merge-vertices", buildArgs: probuilderVertexIndicesArgs },
+  { group: "probuilder", command: "weld-vertices", bridgeCommand: "project-tool.run", toolName: "probuilder.weld-vertices", buildArgs: probuilderWeldArgs },
+  { group: "probuilder", command: "split-vertices", bridgeCommand: "project-tool.run", toolName: "probuilder.split-vertices", buildArgs: probuilderVertexIndicesArgs },
+  { group: "probuilder", command: "move-vertices", bridgeCommand: "project-tool.run", toolName: "probuilder.move-vertices", buildArgs: probuilderMoveVerticesArgs },
+  { group: "probuilder", command: "insert-vertex", bridgeCommand: "project-tool.run", toolName: "probuilder.insert-vertex", buildArgs: probuilderInsertVertexArgs },
+  { group: "probuilder", command: "append-vertices-to-edge", bridgeCommand: "project-tool.run", toolName: "probuilder.append-vertices-to-edge", buildArgs: probuilderAppendVerticesArgs },
+
+  // ─── Info / Inspection ────────────────────────────────
+  { group: "probuilder", command: "mesh-info", bridgeCommand: "project-tool.run", toolName: "probuilder.mesh-info", buildArgs: probuilderMeshInfoArgs },
+  { group: "probuilder", command: "validate-mesh", bridgeCommand: "project-tool.run", toolName: "probuilder.validate-mesh", buildArgs: probuilderTargetOnlyArgs },
+
+  // ─── Conversion ───────────────────────────────────────
+  { group: "probuilder", command: "convert-to-probuilder", bridgeCommand: "project-tool.run", toolName: "probuilder.convert-to-probuilder", buildArgs: probuilderTargetOnlyArgs },
+
+  // ─── Smoothing ────────────────────────────────────────
+  { group: "probuilder", command: "set-smoothing", bridgeCommand: "project-tool.run", toolName: "probuilder.set-smoothing", buildArgs: probuilderSetSmoothingArgs },
+  { group: "probuilder", command: "auto-smooth", bridgeCommand: "project-tool.run", toolName: "probuilder.auto-smooth", buildArgs: probuilderAutoSmoothArgs },
+
+  // ─── Pivot / Transform ────────────────────────────────
+  { group: "probuilder", command: "center-pivot", bridgeCommand: "project-tool.run", toolName: "probuilder.center-pivot", buildArgs: probuilderTargetOnlyArgs },
+  { group: "probuilder", command: "freeze-transform", bridgeCommand: "project-tool.run", toolName: "probuilder.freeze-transform", buildArgs: probuilderTargetOnlyArgs },
+  { group: "probuilder", command: "set-pivot", bridgeCommand: "project-tool.run", toolName: "probuilder.set-pivot", buildArgs: probuilderSetPivotArgs },
+
+  // ─── Repair ───────────────────────────────────────────
+  { group: "probuilder", command: "repair-mesh", bridgeCommand: "project-tool.run", toolName: "probuilder.repair-mesh", buildArgs: probuilderTargetOnlyArgs }
+]);
+
+function markToolsOnly(specs: BridgeCommandSpec[]): BridgeCommandSpec[] {
+  return specs.map((spec) => ({ ...spec, toolsOnly: true }));
+}
+
+// ─── Arg builder functions ──────────────────────────────────
+
+function probuilderPingArgs({ flags }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({});
+}
+
+function probuilderSceneArgs({ flags }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    namePattern: stringFlag(flags, "name-pattern") ?? stringField(flags, "namePattern"),
+    pageSize: numberFlag(flags, "page-size") ?? numberField(flags, "pageSize")
+  });
+}
+
+function probuilderCreateShapeArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    shapeType: positionalTarget ?? stringFlag(flags, "shape-type") ?? stringFlag(flags, "shape") ?? stringFlag(flags, "type") ?? stringField(flags, "shapeType"),
+    name: stringFlag(flags, "name") ?? stringField(flags, "name"),
+    position: positionalPosition(flags),
+    width: floatFlag(flags, "width") ?? numberField(flags, "width"),
+    height: floatFlag(flags, "height") ?? numberField(flags, "height"),
+    depth: floatFlag(flags, "depth") ?? numberField(flags, "depth"),
+    radius: floatFlag(flags, "radius") ?? numberField(flags, "radius"),
+    segments: numberFlag(flags, "segments") ?? numberField(flags, "segments"),
+    sides: numberFlag(flags, "sides") ?? numberField(flags, "sides"),
+    x: floatFlag(flags, "x") ?? numberField(flags, "x"),
+    y: floatFlag(flags, "y") ?? numberField(flags, "y"),
+    z: floatFlag(flags, "z") ?? numberField(flags, "z"),
+    parent: stringFlag(flags, "parent") ?? stringField(flags, "parent")
+  });
+}
+
+function probuilderCreatePolyShapeArgs({ flags }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    points: jsonField(flags, "points", "points"),
+    extrudeHeight: floatFlag(flags, "extrude-height") ?? floatFlag(flags, "height") ?? numberField(flags, "extrudeHeight"),
+    flipNormals: boolFlag(flags, "flip-normals") ?? boolField(flags, "flipNormals"),
+    name: stringFlag(flags, "name") ?? stringField(flags, "name")
+  });
+}
+
+function probuilderTargetWithIndicesArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringField(flags, "target"),
+    faceIndices: jsonField(flags, "face-indices", "faceIndices")
+  });
+}
+
+function probuilderTargetWithOptionalIndicesArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringField(flags, "target"),
+    faceIndices: jsonField(flags, "face-indices", "faceIndices")
+  });
+}
+
+function probuilderDetachFacesArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringField(flags, "target"),
+    faceIndices: jsonField(flags, "face-indices", "faceIndices"),
+    deleteSourceFaces: boolFlag(flags, "delete-source-faces") ?? boolField(flags, "deleteSourceFaces")
+  });
+}
+
+function probuilderSelectFacesArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringField(flags, "target"),
+    direction: stringFlag(flags, "direction") ?? stringField(flags, "direction"),
+    grow: numberFlag(flags, "grow") ?? numberField(flags, "grow"),
+    flood: boolFlag(flags, "flood") ?? boolField(flags, "flood"),
+    loop: boolFlag(flags, "loop") ?? boolField(flags, "loop"),
+    ring: boolFlag(flags, "ring") ?? boolField(flags, "ring")
+  });
+}
+
+function probuilderSetFaceMaterialArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringField(flags, "target"),
+    faceIndices: jsonField(flags, "face-indices", "faceIndices"),
+    materialPath: stringFlag(flags, "material-path") ?? stringFlag(flags, "material") ?? stringField(flags, "materialPath")
+  });
+}
+
+function probuilderSetFaceColorArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringField(flags, "target"),
+    faceIndices: jsonField(flags, "face-indices", "faceIndices"),
+    r: floatFlag(flags, "r") ?? numberField(flags, "r"),
+    g: floatFlag(flags, "g") ?? numberField(flags, "g"),
+    b: floatFlag(flags, "b") ?? numberField(flags, "b"),
+    a: floatFlag(flags, "a") ?? numberField(flags, "a")
+  });
+}
+
+function probuilderSetFaceUvsArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringField(flags, "target"),
+    faceIndices: jsonField(flags, "face-indices", "faceIndices"),
+    scale: floatFlag(flags, "scale") ?? numberField(flags, "scale"),
+    offsetU: floatFlag(flags, "offset-u") ?? numberField(flags, "offsetU"),
+    offsetV: floatFlag(flags, "offset-v") ?? numberField(flags, "offsetV"),
+    rotation: floatFlag(flags, "rotation") ?? numberField(flags, "rotation"),
+    flipU: boolFlag(flags, "flip-u") ?? boolField(flags, "flipU"),
+    flipV: boolFlag(flags, "flip-v") ?? boolField(flags, "flipV")
+  });
+}
+
+function probuilderEdgeArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringField(flags, "target"),
+    edgeIndices: jsonField(flags, "edge-indices", "edgeIndices"),
+    edges: jsonField(flags, "edges", "edges"),
+    distance: floatFlag(flags, "distance") ?? numberField(flags, "distance"),
+    asGroup: boolFlag(flags, "as-group") ?? boolField(flags, "asGroup")
+  });
+}
+
+function probuilderBevelArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringField(flags, "target"),
+    edgeIndices: jsonField(flags, "edge-indices", "edgeIndices"),
+    edges: jsonField(flags, "edges", "edges"),
+    amount: floatFlag(flags, "amount") ?? numberField(flags, "amount")
+  });
+}
+
+function probuilderBridgeEdgesArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringField(flags, "target"),
+    edgeA: jsonField(flags, "edge-a", "edgeA"),
+    edgeB: jsonField(flags, "edge-b", "edgeB"),
+    allowNonManifold: boolFlag(flags, "allow-non-manifold") ?? boolField(flags, "allowNonManifold")
+  });
+}
+
+function probuilderConnectArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringField(flags, "target"),
+    edgeIndices: jsonField(flags, "edge-indices", "edgeIndices"),
+    edges: jsonField(flags, "edges", "edges"),
+    faceIndices: jsonField(flags, "face-indices", "faceIndices")
+  });
+}
+
+function probuilderMultiTargetArgs({ flags }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    targets: jsonField(flags, "targets", "targets"),
+    name: stringFlag(flags, "name") ?? stringField(flags, "name")
+  });
+}
+
+function probuilderMergeObjectsArgs({ flags }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    targets: jsonField(flags, "targets", "targets"),
+    name: stringFlag(flags, "name") ?? stringField(flags, "name"),
+    autoConvert: boolFlag(flags, "auto-convert") ?? boolField(flags, "autoConvert") ?? true
+  });
+}
+
+function probuilderCreatePolygonArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringField(flags, "target"),
+    vertexIndices: jsonField(flags, "vertex-indices", "vertexIndices"),
+    unordered: boolFlag(flags, "unordered") ?? boolField(flags, "unordered")
+  });
+}
+
+function probuilderVertexIndicesArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringField(flags, "target"),
+    vertexIndices: jsonField(flags, "vertex-indices", "vertexIndices")
+  });
+}
+
+function probuilderWeldArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringField(flags, "target"),
+    vertexIndices: jsonField(flags, "vertex-indices", "vertexIndices"),
+    radius: floatFlag(flags, "radius") ?? numberField(flags, "radius")
+  });
+}
+
+function probuilderMoveVerticesArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringField(flags, "target"),
+    vertexIndices: jsonField(flags, "vertex-indices", "vertexIndices"),
+    x: floatFlag(flags, "x") ?? numberField(flags, "x"),
+    y: floatFlag(flags, "y") ?? numberField(flags, "y"),
+    z: floatFlag(flags, "z") ?? numberField(flags, "z")
+  });
+}
+
+function probuilderInsertVertexArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringField(flags, "target"),
+    edge: jsonField(flags, "edge", "edge"),
+    faceIndex: numberFlag(flags, "face-index") ?? numberField(flags, "faceIndex"),
+    point: jsonField(flags, "point", "point"),
+    x: floatFlag(flags, "x") ?? numberField(flags, "x"),
+    y: floatFlag(flags, "y") ?? numberField(flags, "y"),
+    z: floatFlag(flags, "z") ?? numberField(flags, "z")
+  });
+}
+
+function probuilderAppendVerticesArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringField(flags, "target"),
+    edgeIndices: jsonField(flags, "edge-indices", "edgeIndices"),
+    edges: jsonField(flags, "edges", "edges"),
+    count: numberFlag(flags, "count") ?? numberField(flags, "count")
+  });
+}
+
+function probuilderMeshInfoArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringField(flags, "target"),
+    include: stringFlag(flags, "include") ?? stringField(flags, "include") ?? "summary"
+  });
+}
+
+function probuilderTargetOnlyArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringField(flags, "target")
+  });
+}
+
+function probuilderSetSmoothingArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringField(flags, "target"),
+    faceIndices: jsonField(flags, "face-indices", "faceIndices"),
+    smoothingGroup: numberFlag(flags, "smoothing-group") ?? numberField(flags, "smoothingGroup")
+  });
+}
+
+function probuilderAutoSmoothArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringField(flags, "target"),
+    angleThreshold: floatFlag(flags, "angle-threshold") ?? floatFlag(flags, "angle") ?? numberField(flags, "angleThreshold"),
+    faceIndices: jsonField(flags, "face-indices", "faceIndices")
+  });
+}
+
+function probuilderSetPivotArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    target: positionalTarget ?? stringFlag(flags, "target") ?? stringField(flags, "target"),
+    x: floatFlag(flags, "x") ?? numberField(flags, "x"),
+    y: floatFlag(flags, "y") ?? numberField(flags, "y"),
+    z: floatFlag(flags, "z") ?? numberField(flags, "z")
+  });
+}
+
+// ─── Helper functions ──────────────────────────────────────
+
+function parseJsonFlag(raw: string): unknown {
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return raw;
+  }
+}
+
+// 读取 tools run --input 中无法映射为简单 flag 的数组/对象字段。
+function structuredInput(flags: BridgeFlags): Record<string, unknown> {
+  const raw = typeof flags.__structuredInput === "string" ? flags.__structuredInput : undefined;
+  if (!raw) return {};
+  try {
+    const parsed = JSON.parse(raw);
+    return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed as Record<string, unknown> : {};
+  } catch {
+    return {};
+  }
+}
+
+// 优先使用显式 CLI flag；否则保留 --input 中的结构化 JSON 值。
+function jsonField(flags: BridgeFlags, flagName: string, fieldName: string): unknown {
+  const raw = stringFlag(flags, flagName);
+  if (raw !== undefined) return parseJsonFlag(raw);
+  return structuredInput(flags)[fieldName];
+}
+
+function stringField(flags: BridgeFlags, fieldName: string): string | undefined {
+  const value = structuredInput(flags)[fieldName];
+  return typeof value === "string" ? value : undefined;
+}
+
+function numberField(flags: BridgeFlags, fieldName: string): number | undefined {
+  const value = structuredInput(flags)[fieldName];
+  return typeof value === "number" ? value : undefined;
+}
+
+function boolField(flags: BridgeFlags, fieldName: string): boolean | undefined {
+  const value = structuredInput(flags)[fieldName];
+  return typeof value === "boolean" ? value : undefined;
+}
+
+function positionalPosition(flags: BridgeFlags): Record<string, unknown> | undefined {
+  const structuredPosition = structuredInput(flags).position;
+  if (typeof structuredPosition === "object" && structuredPosition !== null && !Array.isArray(structuredPosition)) {
+    return structuredPosition as Record<string, unknown>;
+  }
+  const x = floatFlag(flags, "x");
+  const y = floatFlag(flags, "y");
+  const z = floatFlag(flags, "z");
+  if (x !== undefined || y !== undefined || z !== undefined) {
+    return compactArgs({ x, y, z });
+  }
+  return undefined;
+}