Skip to content

Improve Unity command discovery and preflight - #12

Draft
niqibiao wants to merge 1 commit into
mainfrom
codex/command-routing-optimization
Draft

Improve Unity command discovery and preflight#12
niqibiao wants to merge 1 commit into
mainfrom
codex/command-routing-optimization

Conversation

@niqibiao

@niqibiao niqibiao commented Jul 24, 2026

Copy link
Copy Markdown
Owner

Summary

  • add a committed contract manifest for all 59 built-in Unity actions, grouped into 7 agent-facing domains and core/advanced/control-plane visibility tiers
  • add offline, filtered command discovery and fail-closed preflight validation for recognized built-ins and batches while preserving custom-command pass-through
  • reject malformed batch argument shapes while preserving the existing args/argsJson transport precedence
  • hide the 2 non-verifiable UI commands from default discovery, tighten retry/timeout safety, and simplify the skill/docs around command-first routing
  • keep public compatibility wording at Unity 2022

Why

The previous flow exposed the full command registry and deferred malformed or ambiguous requests to Unity. That increased routing ambiguity and allowed avoidable no-ops or partial mutations. The new committed contracts make the default discovery surface smaller and reject invalid arguments, selectors, mutation sentinels, session requirements, and unsafe ranges before HTTP dispatch.

Self-comparison effect

On the local 89-case offline routing proxy, strict micro accuracy improved from 71.9% to 100% (+28.1 percentage points). The improvement came from route, payload, and exposure-policy accuracy; activation classification remained 20/20 before and after, so this PR does not claim an activation-recall lift. A guarded run launched through UnityStart.cmd also completed 12/12 live Unity tasks with independent read-back and cleanup.

The local test files, comparison reports, and first-round research artifacts are intentionally not included in this PR.

Checks

  • local regression suite — 46 passed
  • live Unity contract run — 12/12 tasks passed; 59 calls across 27 routes; live registry matched all 59 committed IDs
  • git diff --check

@niqibiao
niqibiao force-pushed the codex/command-routing-optimization branch from 025b2e0 to c169627 Compare July 24, 2026 15:50
@niqibiao
niqibiao force-pushed the codex/command-routing-optimization branch from c169627 to 3d9b337 Compare July 24, 2026 16:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant