orca/tests/e2e/helpers/electron-launch-args.ts

import { dirname } from 'node:path'

export function getOrcaElectronLaunchArgs(mainPath: string, headful: boolean): string[] {
  // Launch through package.json so app version and resource paths match a packaged app.
  const appPath = dirname(dirname(dirname(mainPath)))
  // Isolated macOS profiles must not invoke the system keychain UI. Without
  // these Chromium switches startup can block before the first renderer target.
  const keychainArgs =
    process.platform === 'darwin' ? ['--password-store=basic', '--use-mock-keychain'] : []
  if (headful || process.platform !== 'linux') {
    return [...keychainArgs, appPath]
  }

  // Why: Ubuntu CI cannot run Electron's setuid chrome-sandbox (not root-owned
  // mode 4755 in node_modules). Playwright's electron.launch injects
  // --no-sandbox automatically; raw spawn() paths (e.g. second-instance
  // activation) must match or Chromium aborts with SIGTRAP before handshake.
  // GPU flags keep headless under Xvfb on a software path when the GPU
  // subprocess cannot initialize.
  return [
    '--no-sandbox',
    '--disable-gpu',
    '--disable-gpu-compositing',
    '--disable-gpu-sandbox',
    '--disable-dev-shm-usage',
    '--in-process-gpu',
    ...keychainArgs,
    appPath
  ]
}