stablyai/orca · error · Error

This repro harness is intentionally Windows-only.

Error message

This repro harness is intentionally Windows-only.

What it means

Thrown by the apphang repro harness when process.platform is not 'win32'. This harness reproduces a Windows-specific app-hang issue (#6874) involving WSL terminal activation and GPU acceleration, so it is deliberately non-portable.

Source

Thrown at config/scripts/repro-windows-apphang-terminal-activation.mjs:118

  --output-lines=N               Lines emitted by each terminal stress command. Default: ${defaultOutputLines}.
  --report=PATH                  Write full JSON evidence to PATH and print a compact summary to stdout.
  --distro=NAME                  WSL distro to use. Default: first non docker-desktop distro.
  --no-source-control            Do not open Source Control during the stress loop.
  --no-dead-pty-reactivate       Do not kill PTYs and revisit workspaces after initial activation.
  --keep                         Keep disposable WSL/userData fixtures after the run.`)
}

function parsePositiveInt(name, value) {
  const parsed = Number.parseInt(value ?? '', 10)
  if (!Number.isInteger(parsed) || parsed <= 0 || String(parsed) !== value) {
    throw new Error(`${name} requires a positive integer.`)
  }
  return parsed
}

async function main() {
  if (process.platform !== 'win32') {
    throw new Error('This repro harness is intentionally Windows-only.')
  }
  const args = parseArgs()
  const distros = listWslDistros()
  const distro = args.distro ?? distros[0]
  if (!distro) {
    throw new Error('No user WSL distro found. Install/enable WSL or pass --distro=NAME.')
  }
  console.log(
    `[apphang-repro] issue=https://github.com/stablyai/orca/issues/6874 distro=${distro} gpuModes=${args.gpuModes.join(',')} cycles=${args.cycles}`
  )
  const fixture = createWslFixture(distro)
  console.log(
    `[apphang-repro] fixture repo=${fixture.repoUncPath} plain=${fixture.plainUncPath} base=${fixture.baseLinuxPath}`
  )

  const results = []
  try {
    for (const gpuMode of args.gpuModes) {

View on GitHub (pinned to 1136503c6a)

Solutions

  1. Run the harness only on Windows (native or a Windows CI runner).
  2. If you need to inspect the logic without executing, read the source or run --help on any platform (the platform check is after parseArgs, so --help will still exit 0 first).
Defensive patterns

Strategy: validation

Validate before calling

if (process.platform !== 'win32') {
  throw new Error('This repro harness is intentionally Windows-only.')
}

Type guard

function isWindows() {
  return process.platform === 'win32'
}

Prevention

When it happens

Trigger: Running the script on macOS or Linux. The check happens at the very start of main(), before any args or WSL detection.

Common situations: A developer on macOS or Linux tries to run the Windows repro harness, or a CI matrix does not gate this script by OS.

Related errors


AI-assisted analysis of stablyai/orca@1136503c6a (2026-08-12). Data as JSON: /api/errors/b373e13b9b36d2be. Report an issue: GitHub.