Add UITK click support for V3 smoke

Author: kihiku

docs/ref/ai-quickstart.md

@@ -23,7 +23,7 @@ Open (or restart) the Unity Editor after running this command. For contributor w
 
 ```bash
 unityctl init --project "/path/to/unity/project" --source /path/to/unityctl/src/Unityctl.Plugin
-unityctl init --project "/path/to/unity/project" --source "https://github.com/Jason-hub-star/unityctl.git?path=/src/Unityctl.Plugin#v0.3.5"
+unityctl init --project "/path/to/unity/project" --source "https://github.com/Jason-hub-star/unityctl.git?path=/src/Unityctl.Plugin#v0.3.6"
 ```
 
 ### 3. Verify
@@ -112,7 +112,7 @@ For small artifact-first verification bundles, `workflow verify` now supports `p
 For UGUI interactions beyond toggle/input, use `ui scroll`, `ui slider-set`, `ui dropdown-set` to set ScrollRect/Slider/Dropdown values deterministically.
 For URP/HDRP projects, `volume list/get/get-overrides/set-override` and `renderer-feature list` inspect and modify Volume overrides via Reflection (no hard dependency on URP/HDRP).
 For Cinemachine, `cinemachine list/get/set-property` supports both 2.x and 3.x with runtime auto-detection.
-For UI Toolkit, `uitk find/get/set-value` queries and modifies UIDocument elements at runtime.
+For UI Toolkit, `uitk find/get/set-value/click` queries and interacts with UIDocument elements at runtime.
 For animation workflows, `animation list-clips/get-clip/get-controller/add-curve` inspect and edit AnimationClips and AnimatorControllers.
 For profiling, `profiler get-stats/start/stop` provides memory and performance statistics (full rendering stats require Play Mode).
 

docs/ref/getting-started.md

@@ -79,7 +79,7 @@ If you need a contributor-style source install instead, you can still do one of
 
 ```bash
 unityctl init --project /path/to/unity/project --source /path/to/unityctl/src/Unityctl.Plugin
-unityctl init --project /path/to/unity/project --source "https://github.com/Jason-hub-star/unityctl.git?path=/src/Unityctl.Plugin#v0.3.5"
+unityctl init --project /path/to/unity/project --source "https://github.com/Jason-hub-star/unityctl.git?path=/src/Unityctl.Plugin#v0.3.6"
 ```
 
 When switching away from an older `file:` install, first run:
@@ -398,9 +398,12 @@ unityctl uitk set-value --project /path/to/project --name "myTextField" --value
 
 # Or set by locator
 unityctl uitk set-value --project /path/to/project --locator "MainHud::root/1:TextField#Name" --value "hello" --json
+
+# Click a Button-like UITK element in Play Mode
+unityctl uitk click --project /path/to/project --name "myButton" --mode play --json
 ```
 
-`uitk find`, `uitk get`, and `uitk set-value` now share the same resolver. Prefer the returned `locator` when multiple elements share the same `name`.
+`uitk find`, `uitk get`, `uitk set-value`, and `uitk click` share the same resolver. Prefer the returned `locator` when multiple elements share the same `name`.
 
 ### Script Management
 

docs/ref/phase-roadmap.md

@@ -73,7 +73,7 @@ Phase C  — Profiler Commands (get-stats/start/stop 3개 명령) ✅ 완료
 Phase I-1 — UGUI Enhancement (ui-scroll/slider-set/dropdown-set 3개 명령) ✅ 완료
 Phase D  — Volume/PostProcessing (volume 4개 + renderer-feature 1개 = 5개 명령, Reflection) ✅ 완료
 Phase E  — Cinemachine (list/get/set-property 3개 명령, 2.x/3.x auto-detect) ✅ 완료
-Phase I-2 — UI Toolkit (uitk-find/get/set-value 3개 명령, runtime capability) ✅ 완료
+Phase I-2 — UI Toolkit (uitk-find/get/set-value/click 4개 명령, runtime capability) ✅ 완료
 Marketplace — mcp.so + PulseMCP 등록 ✅ 완료
 ```
 
@@ -123,7 +123,7 @@ Marketplace — mcp.so + PulseMCP 등록 ✅ 완료
 | **Phase I-1: UGUI Enhancement** | ui-scroll (ScrollRect), slider-set (Slider), dropdown-set (Dropdown), PrefabGuard+UndoScope | — |
 | **Phase D: Volume/PostProcessing** | volume-list/get/set-override/get-overrides (Reflection, no URP/HDRP hard dep), renderer-feature-list | — |
 | **Phase E: Cinemachine** | cinemachine-list/get/set-property, 2.x/3.x auto-detect, SerializedObject property editing | — |
-| **Phase I-2: UI Toolkit** | uitk-find/get/set-value, runtime UIDocument capability check, element tree traversal | — |
+| **Phase I-2: UI Toolkit** | uitk-find/get/set-value/click, runtime UIDocument capability check, element tree traversal | — |
 | **Marketplace** | mcp.so + PulseMCP 등록 완료 | — |
 
 ---

docs/status/PHASE-EXECUTION-BOARD.md

@@ -48,7 +48,7 @@
 | Phase I-1: UGUI Enhancement | ui-scroll/slider-set/dropdown-set (3개 명령) | P1 | Done | docs/ref/phase-roadmap.md | 2026-03-20 |
 | Phase D: Volume/PostProcessing | volume-list/get/set-override/get-overrides + renderer-feature-list (5개 명령, Reflection) | P1 | Done | docs/ref/phase-roadmap.md | 2026-03-20 |
 | Phase E: Cinemachine | cinemachine-list/get/set-property (3개 명령, 2.x/3.x auto-detect) | P2 | Done | docs/ref/phase-roadmap.md | 2026-03-20 |
-| Phase I-2: UI Toolkit | uitk-find/get/set-value (3개 명령, runtime capability check) | P2 | Done | docs/ref/phase-roadmap.md | 2026-03-20 |
+| Phase I-2: UI Toolkit | uitk-find/get/set-value/click (4개 명령, runtime capability check) | P2 | Done | docs/ref/phase-roadmap.md | 2026-03-20 |
 | Marketplace Registration | mcp.so + PulseMCP 등록 | P0 | Done | — | 2026-03-20 |
 | MCP Prompts | create_game_scene/debug_game/iterate_gameplay/setup_project (4개 AI 워크플로우) | P1 | Done | docs/ref/phase-roadmap.md | 2026-03-20 |
 | CLI Feedback Fixes | prefab-instantiate + asset copy 외부 경로 + IPC 30초 메시지 타임아웃 (CLI-012/014/000) | P0 | Done | docs/status/FEATURE-BACKLOG.md | 2026-03-20 |

docs/status/PROJECT-STATUS.md

@@ -45,7 +45,7 @@
 - **Phase I-1: UGUI Enhancement (ui-scroll/slider-set/dropdown-set — 3개 명령)**: 구현 완료
 - **Phase D: Volume/PostProcessing (volume-list/get/set-override/get-overrides, renderer-feature-list — 5개 명령)**: 구현 완료
 - **Phase E: Cinemachine (cinemachine-list/get/set-property — 3개 명령, capability gating)**: 구현 완료
-- **Phase I-2: UI Toolkit (uitk-find/get/set-value — 3개 명령, runtime capability check)**: 구현 완료
+- **Phase I-2: UI Toolkit (uitk-find/get/set-value/click — 4개 명령, runtime capability check)**: 구현 완료
 
 - **MCP Prompts (create_game_scene, debug_game, iterate_gameplay, setup_project — 4개 AI 워크플로우 프롬프트)**: 구현 완료
 - **CLI Feedback Fixes (CLI-012 prefab-instantiate, CLI-014 asset copy 외부 경로, CLI-000 IPC 30초 메시지 타임아웃)**: 구현 완료. Unity 6 라이브 테스트 통과.
@@ -55,7 +55,7 @@
 - **CLI Enhancement (profiler rendering stats + component add --name + component enable/disable + profiler --detailed)**: 구현 완료. Unity 6 라이브 테스트 통과. 755 테스트 통과.
 - **Real-World UX Hardening (`await-ready` interactive gating, headless process classification, `exec` parser hardening, UITK locator resolver, scene dirty policy)**: 구현 완료. `My project` 기준 라이브 검증/통합 테스트 통과.
 
-**전체 Phase 완료. 총 84개 write allowlist 명령, 159개 CLI 명령 (+2 component enable/disable), 12개 MCP 도구 (33→12 통합), 4개 MCP 프롬프트.**
+**전체 Phase 완료. 총 85개 write allowlist 명령, 160개 CLI 명령 (+2 component enable/disable), 12개 MCP 도구 (33→12 통합), 4개 MCP 프롬프트.**
 
 ## Real-World UX Hardening 라이브 검증 (My project, 2026-04-06)
 
@@ -76,7 +76,7 @@
   - Windows 프로세스 탐지에서 `headless` vs `interactive`를 구분한다.
   - `await-ready`는 interactive Editor가 없으면 IPC-ready를 기다리지 않는다.
   - `exec --code`는 `Type.Member`, `Type.Member = value`, `Type.Method(args...)` 미니 DSL로 정식화했다.
-  - `uitk find/get/set-value`는 공통 locator resolver를 쓴다.
+  - `uitk find/get/set-value/click`은 공통 locator resolver를 쓴다.
   - `scene open/create`는 `dirtyPolicy=fail|save|discard`를 지원한다.
 
 ## Visual Verification v2 Phase 1 라이브 검증 (My project, Unity 6000.0.64f1)

src/Unityctl.Cli/Commands/UitkCommand.cs

@@ -24,6 +24,13 @@ public static void SetValue(string project, string value, string? name = null, s
         CommandRunner.Execute(project, request, json);
     }
 
+    public static void Click(string project, string? name = null, string? locator = null, string mode = "auto", bool json = false)
+    {
+        var request = CreateClickRequest(name, locator, mode);
+        var exitCode = UiCommand.ExecuteInteractiveAsync(project, request, json).GetAwaiter().GetResult();
+        Environment.Exit(exitCode);
+    }
+
     internal static CommandRequest CreateFindRequest(string? name, string? className, string? type, int? limit)
     {
         var parameters = new JsonObject();
@@ -79,4 +86,25 @@ internal static CommandRequest CreateSetValueRequest(string value, string? name
             Parameters = parameters
         };
     }
+
+    internal static CommandRequest CreateClickRequest(string? name = null, string? locator = null, string mode = "auto")
+    {
+        if (string.IsNullOrWhiteSpace(name) && string.IsNullOrWhiteSpace(locator))
+            throw new ArgumentException("name or locator must not be empty");
+
+        var parameters = new JsonObject
+        {
+            ["mode"] = UiCommand.ParseInteractionMode(mode, nameof(mode))
+        };
+        if (!string.IsNullOrWhiteSpace(name))
+            parameters["name"] = name;
+        if (!string.IsNullOrWhiteSpace(locator))
+            parameters["locator"] = locator;
+
+        return new CommandRequest
+        {
+            Command = WellKnownCommands.UitkClick,
+            Parameters = parameters
+        };
+    }
 }

src/Unityctl.Cli/Program.cs

@@ -523,6 +523,9 @@
 app.Add("uitk set-value", (string project, string value, string? name = null, string? locator = null, bool json = false) =>
     UitkCommand.SetValue(project, value, name, locator, json));
 
+app.Add("uitk click", (string project, string? name = null, string? locator = null, string mode = "auto", bool json = false) =>
+    UitkCommand.Click(project, name, locator, mode, json));
+
 // Cinemachine — Phase E
 app.Add("cinemachine list", (string project, bool includeInactive = false, bool json = false) =>
     CinemachineCommand.List(project, includeInactive, json));

src/Unityctl.Mcp/Prompts/GameWorkflowPrompts.cs

@@ -155,7 +155,7 @@ 2. Confirm Unity Editor is open with the target project
             ## Step 2: Install Plugin
             3. unityctl_run(command="init") with parameters:
                - project: "/path/to/unity/project"
-               - source: "https://github.com/Jason-hub-star/unityctl.git?path=/src/Unityctl.Plugin#v0.3.5"
+               - source: "https://github.com/Jason-hub-star/unityctl.git?path=/src/Unityctl.Plugin#v0.3.6"
             4. Restart Unity Editor (or wait for domain reload)
 
             ## Step 3: Verify

src/Unityctl.Mcp/Tools/RunTool.cs

@@ -104,6 +104,7 @@ internal sealed class RunTool(CommandExecutor executor)
         WellKnownCommands.ScriptableObjectSetProperty,
         // UI Toolkit — Phase I-2
         WellKnownCommands.UitkSetValue,
+        WellKnownCommands.UitkClick,
         // Cinemachine — Phase E
         WellKnownCommands.CinemachineSetProperty,
         // Volume/PostProcessing — Phase D

src/Unityctl.Plugin/Editor/Commands/PingHandler.cs

@@ -11,7 +11,7 @@ public CommandResponse Execute(CommandRequest request)
         {
             var data = new JObject
             {
-                ["version"] = "0.3.5",
+                ["version"] = "0.3.6",
 #if UNITY_EDITOR
                 ["unityVersion"] = UnityEngine.Application.unityVersion
 #endif