Files
archived-orca/tests/AGENTS.md
T
Neil a16afc4e67 refactor(e2e): group journeys by feature and repair browser recovery (#43628)
* refactor(e2e): group journeys and fixtures by feature ownership

* refactor(e2e): consolidate remaining Playwright owner imports

* test(ci): stop copying retired route modules into fixtures

* fix(browser): preserve one-shot follow intent across equal snapshots

* refactor(settings): colocate commit message defaults with source control

* test(browser): await page registration and focus the concrete page

* fix(browser): keep viewport recovery progressing during incompatible frames

* fix(browser): wait for stale helper exit before replacement commands
2026-11-17 11:44:44 -08:00

1.1 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 may explicitly present windows on their isolated hosted-CI Xvfb displays. 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.