fix(providers): name the simulator HID helper in the fold refusal hints

[thymikee]

Summary

Follow-up to the review on #2821. Since #2762, fold builds a small HID helper and runs it with simctl spawn inside a foldable iPhone simulator on the daemon host (packages/platform-apple/src/foldable/simulator-hid.ts). It no longer goes through Xcode Device Hub. The Limrun and WebDriver refusal hints still said Device Hub, so they now name what fold actually needs:

fold runs a HID helper through simctl spawn inside a foldable iPhone simulator on the daemon host; a Limrun session has no such simulator.

Refusal reasons and codes are unchanged (unsupported-provider-mode). Five comments that still described fold as using Device Hub were also reworded: the FoldCommandResult doc in contracts, Android and web runtime tests, and two provider-scenario integration comments. 7 files, comment and hint text only.

git grep -i "device hub" now finds only:

• ADR 0025 and CHANGELOG, which are historical;
• docs and help text that say Device Hub is not required;
• references to Device Hub's preset names and the angles measured from them.

Validation

At 96a901b01, pnpm check:affected --run passed: 17 checks, including 121 files / 814 tests. No test pins the hint text: provider tests compare against the constants, and the integration test matches /fold/. This changes no runtime behavior, so no device run applies.

An adversarial review found three issues, all fixed here:

• the Android comment wrongly claimed no adb surface can pose a hinge;
• the first hint wording was vague;
• an integration comment claimed a check the test doesn't make.

🤖 Generated with Claude Code

[github-actions]

Size Report

Metric	Base	Current	Diff
Installed (including dependencies)	4.80 MB	4.80 MB	+73 B
Package (unpacked)	4.80 MB	4.80 MB	+73 B
Package (download)	1.44 MB	1.44 MB	+41 B

Startup median (7 runs, lower is better):

Scenario	Base	Current	Diff
CLI --version	30.7 ms	32.8 ms	+2.0 ms
CLI --help	85.2 ms	90.8 ms	+5.6 ms

[thymikee]

Reviewed at 96a901b. This changes only hint text and comments: the fold refusal hints in contracts, limrun and webdriver now name the simulator HID helper. The refusal reason and availability are unchanged, and the tests match on /fold/, not on the exact hint, so no caller depends on the old wording.

Checks were still running at review time.

[github-actions]

PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-09-24 09:35 UTC