Function spawnChild

scripts/guardian/shared.ts:202–221

(spec: SpawnSpec)

}

export function spawnChild(spec: SpawnSpec): ChildProcess {
  const child = spawn(resolveWindowsBin(spec.command), spec.args, {
    env: spec.env,
    stdio: spec.prefixLogs ? ['inherit', 'pipe', 'pipe'] : 'inherit',
    // On Windows the dev commands (`tsx`, `pnpm`) are `.cmd` shims in
    // node_modules/.bin. Node's spawn won't apply PATHEXT resolution to find
    // them without a shell, so a bare `spawn('tsx', …)` throws ENOENT — and a
    // Git-Bash PATH may not even carry .bin, so the command is resolved to its
    // absolute shim above. POSIX resolves the bin dir directly, so keep shell
    // off there. Args here have no spaces, so shell quoting isn't a concern.
    shell: process.platform === 'win32',
  } satisfies SpawnOptions)

  if (spec.prefixLogs) {
    const tag = `[${spec.name}] `
    child.stdout?.on('data', (buf: Buffer) => writePrefixed(process.stdout, buf, tag))
    child.stderr?.on('data', (buf: Buffer) => writePrefixed(process.stderr, buf, tag))
  }
  return child
}

/**
 * Kill a child *and its descendants*, cross-platform.