XUUnity MCP v0.3.64

Why

Two independent consumer retros showed that a capped UI tree search could report ui_node_not_found even though the requested control was simply beyond the scanned prefix. The same incomplete search could also find one candidate without proving that it was unique.

Changed

• unity_ui_click now refuses an incomplete selector search as ui_selector_search_truncated, whether the scanned prefix found zero or one candidate. It never delivers a click when absence or uniqueness is unproven.
• Direct and scenario click receipts preserve the searched target and scenes, scanned node count, match count, depth/node limits, truncation flag, and truncation reason.
• Scenario ui_click steps accept maxDepth and maxNodes, with the same 12 / 500 defaults as the direct tool. Recovery tells callers to narrow the target or scene, or deliberately raise the budget and retry.

Benefits

• Automation can distinguish a real complete-search negative from an inconclusive partial search instead of silently skipping an existing button.
• A single match from a partial tree can no longer be mistaken for a safe unique target, preventing the wrong UI element from receiving the click.

Validation

• Focused host contracts: 153/153; full host suite: 981 tests with 14 expected platform skips; public site UI: 42/42 browser checks.
• Clean local-package projects on Unity 2022.3.67f2 and 6000.0.58f2: EditMode 91/91; PlayMode 18/19 with one expected skip and no failures on each version.
• Development-system Unity 2022.3.62f3 consumer: EditMode 91/91; PlayMode 18/19 with one expected skip; original v0.3.63 pin restored.
• Primary Unity 6000.0.58f2 consumer: build-configuration compile matrix 6/6, acceptance scenario 10/10, contract scenario, both PlayMode lifecycle regressions, final health/settle checks, and project-action catalog consistency.
• Required GitHub workflows passed for the release commit; the Release Tag Gate passed for this tag. Release-version consistency, documentation freshness, public-release safety, and diff hygiene are green.

Known limitations

• A truncated selector search is not widened automatically. The caller must narrow the target or scene, or raise maxDepth / maxNodes, then retry.
• Guarded click delivery remains a uGUI capability and requires com.unity.ugui; UI Toolkit interaction is not added by this release.
• Live package validation covered macOS Unity 2022 and Unity 6000. Windows and Linux retain fixture/host coverage rather than a live UI-click run in this cycle.
• Unity Package CI remains explicitly waived because hosted runners do not have Unity license credentials. The completed local Unity matrix is the release evidence for this package change.