refactor: make browser actions ref-only

docs/browser.md

@@ -167,16 +167,14 @@ Inspection:
 - `clawdis browser screenshot`
 - `clawdis browser screenshot --full-page`
 - `clawdis browser screenshot --ref 12`
+- `clawdis browser snapshot`
 - `clawdis browser snapshot --format aria --limit 200`
-- `clawdis browser snapshot --format ai`
 
 Actions:
 - `clawdis browser navigate https://example.com`
 - `clawdis browser resize 1280 720`
 - `clawdis browser click 12 --double`
-- `clawdis browser click --selector 'button.save'`
 - `clawdis browser type 23 "hello" --submit`
-- `clawdis browser type --selector "input[name=q]" "hello"`
 - `clawdis browser press Enter`
 - `clawdis browser hover 44`
 - `clawdis browser drag 10 11`
@@ -186,14 +184,15 @@ Actions:
 - `clawdis browser dialog --accept`
 - `clawdis browser wait --text "Done"`
 - `clawdis browser evaluate --fn '(el) => el.textContent' --ref 7`
+- `clawdis browser evaluate --fn "document.querySelector('.my-class').click()"`
 - `clawdis browser console --level error`
 - `clawdis browser pdf`
 
 Notes:
 - `upload` and `dialog` are **arming** calls; run them before the click/press that triggers the chooser/dialog.
 - The arm default timeout is **2 minutes** (clamped to max 2 minutes); pass `timeoutMs` if you need shorter.
-- `snapshot --format ai` returns AI snapshot markup used for ref-based actions.
-- `click`/`type` accept `--selector` to target CSS selectors instead of AI refs.
+- `snapshot` defaults to `ai`; `aria` returns an accessibility tree for debugging.
+- `click`/`type` require `ref` from `snapshot --format ai`; use `evaluate` for rare CSS selector one-offs.
 
 ## Security & privacy notes