feat: run devicekit-ios

[kvs-coder]

Summary by CodeRabbit

• New Features

  • DeviceKit support for iOS real devices: start DeviceKit from the CLI to enable XCUITest-based automation, with automatic port forwarding for HTTP control and H.264 streaming. CLI shows discovered HTTP/stream ports and keeps the process running until stopped.

• Documentation

  • README updated with DeviceKit usage, example commands, JSON port output, and platform notes for using DeviceKit or a manual WebDriverAgent alternative.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Walkthrough

Adds DeviceKit support for iOS real devices across docs, CLI, commands, device layer, and JSON-RPC server routing to start a DeviceKit session with port forwarding and an XCUITest runner.

Changes

Cohort / File(s)	Summary
Documentation README.md	Adds a DeviceKit (iOS Real Devices) Usage section with example mobilecli devicekit start commands, sample JSON port output, and updated platform notes explaining DeviceKit vs manual WebDriverAgent alternatives.
CLI cli/devicekit.go	New CLI group devicekit with start subcommand; builds DeviceKitStartRequest, calls command, prints JSON response, blocks until SIGINT/SIGTERM, and adds --device flag.
Commands / API commands/devicekit.go	Adds DeviceKitStartRequest, DeviceKitStartResponse, and DeviceKitStartCommand to locate an iOS device, invoke StartDeviceKit, and return HTTP/stream ports and a message or error.
Device layer devices/ios.go	Adds DeviceKitInfo and (*IOSDevice) StartDeviceKit() to create tunnel/port-forwarding, discover local ports, launch an XCUITest runner; renames LaunchWda → LaunchTestRunner; adds findAvailablePortInRange.
Server / RPC server/server.go, server/dispatch.go	Adds DeviceKitStartParams and handleDeviceKitStart; registers "devicekit_start" in the method registry to accept params, invoke DeviceKitStartCommand, and return port info or error.

Possibly related PRs

• refactor: refactored all handlers into a callback map #144 — Related to the dispatch registry refactor that this PR extends by adding the devicekit_start entry and handler.
• fix: was missing tunnel when listing apps on iOS #140 — Related iOS device tunnel/startup changes in devices/ios.go that intersect with StartDeviceKit and the LaunchWda→LaunchTestRunner refactor.
• mobile-next/mobilecli#... — (included for completeness) another PR touching device startup/tunneling may overlap; review for conflicts in devices/ios.go.

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 37.50% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'feat: run devicekit-ios' clearly and concisely summarizes the primary change—adding the ability to run DeviceKit on iOS devices.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[gmegidish]

Oops, merged the branch that inherits from this one. So changes already made to main.