docs(commands): trim the interaction, app, and settings reference

Merged
TH
1mo ago
+179-223

Summary

The second of three family-scoped trims of commands.md. This one covers Snapshot and inspect through Keyboard. The range drops from 8,266 to 5,397 words (โˆ’35%). Every command, flag, example, error code and recovery step is kept.

  • Wait and alerts: wait failure reasons are a list, each with what it means. Poll evidence is shorter.
  • Interactions: split into Text entry, Pointer and gestures, and Scroll. Text-entry error codes are a list with the next step for each. Scroll details point to agent-device help scroll, and scroll --until replaces a manual shell loop.
  • Retry after a failed command: reasons, including session_or_device_selector_required and session_app_required, are a list with their fixes.
  • Settings helpers: grouped by area with one shared refusal list. Internal mechanics are cut (simctl notification names, container paths, pm/appops); what the user sees is kept.
  • The pinned snapshot usage line, the predicate_failed sentence, the supported-predicates sentence, and every linked anchor are unchanged.

Companion to #3441. Each edits a different range of commands.md.

Validation

  • pnpm check:affected --run passed on e6565098d.
  • The four tests that pin commands.md text pass.
  • check:doc-prose and check:doc-links pass.
  • Docs only, so no device runs.

๐Ÿค– Generated with Claude Code