Files
orca/tests/AGENTS.md
Kelvin Amoaba 5a14019c15 test(browser): check on Windows that agent browser input leaves the user's app in front (#42194)
* test(browser): measure agent input focus on the Windows desktop

* test(browser): show Orca inactive before the Windows holder takes the foreground

* test(browser): name the foreground window in Windows holder replies

* test(browser): lift the foreground lock before the Windows holder takes the foreground

* test(browser): run the Windows agent focus check from a dispatch-only workflow

* test(browser): skip the Windows focus checks before launch off hosted runners

* test(browser): harden the Windows focus holder and its dispatch workflow
2026-11-14 00:00:31 +00:00

1.4 KiB

Automated App Launches

  • Set ORCA_BACKGROUND_LAUNCH=1 for all tests and agent-launched apps. Use orca-app.ts / orca-restart.ts; raw electron.launch() calls must pass the env explicitly.
  • Keep windows hidden and drive renderers through Playwright CDP. Never reveal windows, steal focus, or activate the app on the user's desktop. @headful is for tests requiring real pixels; it does not authorize foreground activation. Never set ORCA_E2E_FOREGROUND=1 on the desktop.
  • Run native-focus and visible-window tests only on an isolated display or CI.
  • Rebuild modified launch-policy code before launching; stale wrappers are unsafe.
  • Only the terminal perf and native IBus fixtures, and the guarded native browser image-focus test, may explicitly present windows on their isolated hosted-CI Xvfb displays, and the guarded Windows agent focus test on the hosted Windows CI desktop. Preserve their guards and keep ORCA_BACKGROUND_LAUNCH=1; do not generalize these exceptions to other fixtures or production launch policy. Background terminal panes stay hidden.
  • The browser image-focus test also permits an isolated Docker Xvfb display, with ORCA_E2E_BROWSER_NATIVE_XVFB=1; desktop runs must skip it.