Enable device workflow by default and unify physical device deploy

[maatheusgois-dd]

Summary

• Add device to default MCP workflows so agents see physical device tools without toggle-workflow device on
• Extend bazel_ios_build_and_run with platform: device plus deviceId/deviceName, sharing deploy logic with bazel_ios_device_build_and_run
• Add bazel_ios_device_get_app_path, session defaults for device fields, and structured install-failure responses with retry hints
• Improve bazel_ios_health with devicectl connectivity, codesigning identity count, workspace env warnings, and both UDID formats in list_devices

Scope

• MCP server/tools
• CLI commands or parsers
• Bazel build/test/discovery
• Simulator workflows
• Physical device workflows
• UI automation, screenshots, video, logs, or deep links
• LLDB debugging
• macOS, tvOS, watchOS, or visionOS workflows
• Swift Package Manager
• Daemon, session defaults, config, doctor, or setup
• Project scaffolding
• Docs, examples, or agent skills
• CI, release, packaging, or dependencies

Validation

• npm run lint
• npm run typecheck
• npm test
• npm run build
• npx vitest --run --coverage
• Manual MCP validation with Cursor or another MCP client
• Manual CLI validation with xcodebazelmcp ...
• Bazel workspace validation against a real Apple target
• Simulator validation
• Physical device validation

Compatibility

• Adds, removes, or renames MCP tools
• Changes CLI flags, command output, exit codes, or streaming behavior
• Changes config files, environment variables, defaults, or profiles
• Changes generated project scaffolding
• Changes package contents, dependencies, Node support, or release behavior
• Requires updates to docs, README, manifests, schemas, or skills
• No compatibility impact

Notes For Reviewers

Default advertised tools increase from 38 → 52 (device workflow + bazel_ios_device_get_app_path).

New shared deploy path: src/core/device-deploy.ts (deployBuiltAppToDevice). On install failure after a successful build, tools return structured { build: "ok", appPath, bundleId, retryTools } plus mapped errors for locked/untrusted/signing cases.

Example device run after this lands:

bazel_ios_health
bazel_ios_build_and_run target=//app:MyApp platform=device deviceName="My iPhone" streaming=true

Follow-ups not in this PR: bazel_ios_device_preflight, Bazel server lock detection, rules_xcodeproj output path fixes, monorepo skill updates.

Made with Cursor

[codecov]

Codecov Report

❌ Patch coverage is 22.81369% with 203 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
src/core/device-deploy.ts	5.55%	85 Missing ⚠️
src/tools/handlers/session.ts	7.40%	50 Missing ⚠️
src/tools/handlers/device.ts	35.29%	22 Missing ⚠️
src/tools/streaming.ts	4.54%	21 Missing ⚠️
src/tools/handlers/build.ts	42.85%	12 Missing ⚠️
src/core/devices.ts	76.66%	6 Missing and 1 partial ⚠️
src/runtime/config.ts	25.00%	6 Missing ⚠️

📢 Thoughts on this report? Let us know!