docs: cover browser controls in CLI contract

Merged
BL
11d ago
+16-1

Summary

The CLI migration contract now covers shipped browser controls for React grab, DevTools, focus and design modes, zoom, history clearing, and console/error lists. Eight no-socket help probes pin their public command forms so later help changes are visible to the contract test.

Fixes #15707.

Testing

  • python -X utf8 scripts/check-cli-contract-verbs.py passed: 219 dispatched verbs covered.
  • tests/test_cli_contract_help.py parsed all 235 probes; the eight new browser help needles matched the current CLI help source. Executable probes require a built macOS CLI and were not run locally.
  • python -X utf8 scripts/localize_changes.py passed: no changed translation keys and zero catalog parity errors.
  • python -X utf8 scripts/verify-local.py passed its selected feature-flag policy check; Swift syntax was skipped because no Swift files changed.
  • git diff origin/main..HEAD --check passed.

Prepared with AI assistance.

Changelog

none


View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.


Summary by cubic

Documents shipped browser control commands in the CLI migration contract, closing #15707.

  • Adds contract rows for React grab, DevTools, focus mode, design mode, zoom, forced history clearing, and the split console/error list and clear forms.
  • Pins eight no-socket help probes via cmux help browser (not browser --help, which prints only the short usage) so future help output changes are caught by the contract test.

Summary by CodeRabbit

  • Documentation
    • Updated CLI guidance for browser inspection and control commands, including React-grab, DevTools, focus and design modes, zoom, and forced history clearing.
    • Clarified that console and error inspection use separate list and clear subcommands for a selected surface, replacing the combined browser command forms.
    • Added no-socket help probes for browser commands, including the console and error subcommands.