jev-cua

# Jev Cua: Guarded General Mac Computer Use + Fastpath

`jev-cua` is a local Codex/Waku plugin for app-agnostic Mac computer use. It can launch an exact installed app, inspect Accessibility state, return in-memory screenshots, target visually through opaque grids, click, type non-secret text, press bounded keys, invoke exact menu items, and scroll. The optional compiled path remains available for faster reviewed browser workflows.

```text
general task -> exact app/window -> Accessibility actions when available
                               -> screenshot + opaque visual targeting fallback
             -> one opaque action -> approval when consequential
             -> fresh rebind + exact postcondition -> repeat

repetitive task -> optional Jev workflow recommendation -> local validation
                -> compiled adapter -> deterministic action -> exact postcondition
```

This release does not establish a “1000x” speedup; that still requires end-to-end measurement. It does replace the old Accessibility-only prototype with a usable general Mac path while retaining deterministic verification and at-most-once execution.

## General Mac computer use

- `jev_cua_native_start` returns opaque refs for installed apps. A stopped app is marked `launchable` only when it has an exact installed path; `jev_cua_native_launch_app` accepts only that ref, passes no URL or arguments, launches in the background, and independently verifies the resulting process identity.
- Accessibility observation publishes prebound AXPress, `set_value`, synthetic `type_text`, safe navigation keys, approval-gated Return/Space/Delete, bounded scrolling, and exact menu leaves with display-only breadcrumbs. The Apple and application menus, power/session commands, force quit, quit/close commands, unsafe men