Skip to content

armgit / axuse

Public Imported from GitHub
0

Accessibility-first browser & computer use for AI agents — one MCP server for every harness (Codex, Claude Code, OpenCode, Antigravity). Instruments the DOM/accessibility tree via CDP instead of screenshot loops: diffed snapshots, stable element refs, trusted input, typed errors. Zero dependencies

8.2 KB
Raw Blame
{
  "$comment": "skip-audit allowlist. Every entry maps a skip token (test title, matched by prefix) to its documented reason category. Categories: platform-windows (test only runs on Windows), tcc-screen-recording (requires a granted Screen Recording TCC permission — manual/self-hosted lane), tcc-macos-desktop (requires AXUSE_TEST_MACOS_DESKTOP=1 on macOS), live-gate-external (requires an external live service and an explicit AXUSE_TEST_LIVE_* gate), live-gate-browser (requires a browser and an explicit AXUSE_TEST_LIVE_* gate). Prune entries when tests are removed; the audit fails on stale entries.",
  "skips": {
    "desktop driver: screen_info reports a usable native coordinate space": "platform-or-gate: Windows live driver, or macOS with AXUSE_TEST_MACOS_DESKTOP=1",
    "desktop driver: budgeted screenshot of a small region": "platform-windows: Windows-only live screenshot",
    "linux desktop: driver drives a private Xvfb (input, capture, windows)": "platform-linux-xvfb: spawns a private Xvfb (sudo apt install xvfb); never touches the operator session",
    "server mode: ": "platform-linux-xvfb: the display-less Linux lane (sudo apt install xvfb + a browser); live tests force a dead DISPLAY and boot a private Xvfb — hermetic, never touches the operator session",
    "linux desktop: JPEG decodes in an independent decoder when PIL exists": "platform-linux-xvfb: spawns a private Xvfb; PIL verified when present",
    "atspi: snapshot + read round-trip on a live app (read-only)": "platform-linux-atspi: needs the session's at-spi2 registry (DBUS_SESSION_BUS_ADDRESS); bare Xvfb/CI has none — read-only, never acts",
    "atspi: action sandbox — snapshot, ax_set, ax_click on a private bus+Xvfb+GTK app": "platform-linux-gtk-sandbox: needs Xvfb + dbus-run-session + python3-gi Gtk3 (CI installs them); fully isolated private bus",
    "desktop driver: macOS screenshot is opt-in and budgeted": "tcc-screen-recording: needs AXUSE_TEST_MACOS_SCREENSHOT=1 with Screen Recording granted (manual lane)",
    "desktop driver: window discovery has stable title/pid records": "platform-or-gate: Windows live driver, or macOS with AXUSE_TEST_MACOS_DESKTOP=1",
    "macOS permission probe is non-interactive and typed": "tcc-macos-desktop: needs AXUSE_TEST_MACOS_DESKTOP=1",
    "macOS screenshot reports the typed TCC error when preflight denies access": "tcc-macos-desktop: needs AXUSE_TEST_MACOS_DESKTOP=1; body self-skips when Screen Recording is already granted",
    "macOS posted input fails typed when Accessibility preflight denies access": "tcc-macos-desktop: needs AXUSE_TEST_MACOS_DESKTOP=1; body self-skips when Accessibility is already granted",
    "macOS native event construction runs on this host without posting input": "tcc-macos-desktop: needs AXUSE_TEST_MACOS_DESKTOP=1",
    "macOS ax ops fail typed without Accessibility (live, denial path)": "tcc-macos-desktop: needs AXUSE_TEST_MACOS_DESKTOP=1; self-skips when Accessibility is granted",
    "tcc lane: granted Screen Recording + Accessibility is verified BEFORE anything runs": "tcc-manual-lane: needs AXUSE_TEST_MACOS_TCC_MANUAL=1 and a pre-granted self-hosted runner",
    "tcc lane: real screenshot succeeds and stays budgeted (granted path)": "tcc-manual-lane: needs AXUSE_TEST_MACOS_TCC_MANUAL=1 and a pre-granted self-hosted runner",
    "tcc lane: inert input event round-trips through the CGEvent tap (granted path)": "tcc-manual-lane: needs AXUSE_TEST_MACOS_TCC_MANUAL=1 and a pre-granted self-hosted runner",
    "tcc lane: wheel direction matches the browser contract under this host's scroll preference": "tcc-manual-lane: needs AXUSE_TEST_MACOS_TCC_MANUAL=1 and a pre-granted self-hosted runner",
    "tcc lane: LIVE scroll-direction pin — wheel(0,+N) scrolls OUR page down, world-visible truth": "tcc-manual-lane: needs AXUSE_TEST_MACOS_TCC_MANUAL=1 and a pre-granted self-hosted runner",
    "tcc lane: AX structure layer — snapshot + read round-trip on a real app": "tcc-manual-lane: needs AXUSE_TEST_MACOS_TCC_MANUAL=1 and a pre-granted self-hosted runner",
    "tcc lane: recovery — a denied-then-granted transition is seen without host restart": "tcc-manual-lane: needs AXUSE_TEST_MACOS_TCC_MANUAL=1 and a pre-granted self-hosted runner",
    "example plugin solves the Turnstile demo end-to-end": "live-gate-external: needs AXUSE_TEST_LIVE_CAPTCHA=1 and the public Turnstile demo",
    "captcha-pro loads and its Turnstile path solves the official demo (test keys)": "live-gate-external: needs AXUSE_TEST_LIVE_CAPTCHA=1, a vision API key, and the public demo",
    "extension bridge: install → native messaging → drive the browser": "live-gate-browser: needs an extension-capable Chromium-family browser",
    "browser flow": "live-gate-browser: needs any Chromium-family browser (auto-detect or AXUSE_BROWSER)",
    "human input: typing and clicking land as human-shaped trusted events": "live-gate-browser: needs any Chromium-family browser (headless hermetic)",
    "proxy: browser egress": "live-gate-browser: needs any Chromium-family browser (local fixture proxy — no external service)",
    "posture: the live command": "platform-linux-xvfb: the server-mode audit lane (sudo apt install xvfb + a browser)",
    "governance: the browser cap": "live-gate-browser: needs any Chromium-family browser (headless hermetic)",
    "fill: ARIA and native sliders via trusted Arrow keys": "live-gate-browser: needs any Chromium-family browser",
    "fill: foreign-tab refs fail with a hint naming the owning tab": "live-gate-browser: needs any Chromium-family browser",
    "mcp: handshake, tools/list, tools/call end-to-end": "live-gate-browser: needs any Chromium-family browser",
    "oopif: auto-attach, merged snapshot, in-frame click": "live-gate-browser: needs any Chromium-family browser",
    "A2: profile_dir is persistent — survives dispose; the ephemeral default does not": "live-gate-browser: needs any Chromium-family browser",
    "catalog: the paid shared library's own gates pass": "paid-tree: present only in the private checkout",
    "catalog: every present plugin loads with zero loader errors": "paid-tree: present only in the private checkout",
    "catalog: ": "paid-tree: per-plugin offline unit suites (private checkout)",
    "plugin ABI child suites": "paid-tree: present only in the private checkout",
    "macos darwin browser candidates": "platform-macos: darwin-only candidate table",
    "darwin extension-capable candidates exclude branded Chrome": "platform-macos: darwin-only candidate table",
    "macOS browser candidates distinguish branded Chrome from extension-capable builds": "platform-macos: darwin-only candidate table",
    "macOS native-host installer writes an executable, isolated registration": "platform-macos: darwin-only native-host installer table",
    "macOS native-host directories match each Chromium-family browser": "platform-macos: darwin-only native-host directory table",
    "macOS uninstall preserves a shared launcher while another browser remains registered": "platform-macos: darwin-only uninstall-sharing test",
    "macOS native-host launcher reaches an isolated hub": "platform-macos: darwin-only launcher-to-hub test",
    "solver catalog tool schemas stay valid and plugin tool names never shadow core tools": "paid-tree: present only in the private checkout",
    "every plugin CLI fails closed without a license": "paid-tree: present only in the private checkout",
    "every plugin CLI executes: wired, licensed-gated, JSON-honest (no stack crashes)": "paid-tree: present only in the private checkout",
    "real MCP server + real catalog: every capability tool mounts; solve signposts honestly": "paid-tree: present only in the private checkout",
    "live: ": "live-gate-browser: plugin live gate (AXUSE_TEST_LIVE_* env + fixture site; self-skips without external services/keys)",
    "live (public board)": "live-gate-external: exercises a real third-party site; opt-in only",
    "live (public playground)": "live-gate-external: exercises a real third-party site; opt-in only",
    "live E: ": "live-gate-external: challenge-handler public-demo gate; requires CHALLENGE_CF_DEMO_URL and a vision key",
    "live B/C/D": "live-gate-external: challenge-handler public demo gates; require CHALLENGE_VISION_KEY",
    "live A2": "live-gate-browser: fixture interstitial gate"
  }
}