feat!(mac): add ui screens + text clawdis-mac

docs/clawdis-mac.md

@@ -63,16 +63,17 @@ struct Response { ok: Bool; message?: String; payload?: Data }
 - XPCListener actor: routes Request → managers; logs via OSLog.
 
 ## CLI (`clawdis-mac`)
-- Subcommands (JSON out, non-zero exit on failure):
+- Subcommands (text by default; `--json` for machine output; non-zero exit on failure):
   - `notify --title --body [--sound] [--priority passive|active|timeSensitive] [--delivery system|overlay|auto]`
   - `ensure-permissions --cap accessibility --cap screenRecording [--interactive]`
   - `screenshot [--display-id N | --window-id N] [--out path]`
+  - `ui screens`
   - `run -- cmd args... [--cwd] [--env KEY=VAL] [--timeout 30] [--needs-screen-recording]`
   - `status`
 - Sounds: supply any macOS alert name with `--sound` per notification; omit the flag to use the system default. There is no longer a persisted “default sound” in the app UI.
 - Priority: `timeSensitive` is best-effort and falls back to `active` unless the app is signed with the Time Sensitive Notifications entitlement.
 - Delivery: `overlay` and `auto` show an in-app toast panel (bypasses Notification Center/Focus).
-- Internals: builds Request, connects via AsyncXPCConnection, prints Response as JSON to stdout.
+- Internals: builds a `ClawdisIPC.Request`, sends it to the running app over the local control socket, and prints text by default (or JSON with `--json`).
 
 ## Integration with clawdis/Clawdis (Node/TS)
 - Add helper module that shells to `clawdis-mac`:

docs/mac/peekaboo.md

@@ -47,7 +47,7 @@ Change `clawdis-mac` to default to human text output:
 
 This applies globally, not only `ui` commands.
 
-Note (current state as of 2025-12-13): `clawdis-mac` prints JSON by default. This is a planned behavior change.
+Note (current state as of 2025-12-13): `clawdis-mac` prints text by default; use `--json` for structured output.
 
 ### Timeouts
 Default timeout for UI actions: **10 seconds** end-to-end (CLI already defaults to 10s).