Function killProcessTree

cli/src/utils/process.ts:96–116

* Kills a process and all its descendants. * Signals are sent synchronously (children first) to work in exit handlers, * then waits asynchronously for processes to die.

(pid: number, force: boolean)

 * then waits asynchronously for processes to die.
 */
async function killProcessTree(pid: number, force: boolean): Promise<boolean> {
  // Collect all PIDs first (sync) - returns in child-first order
  const pids = collectProcessTree(pid);

  // Signal all processes synchronously (children first, then root)
  const signal = force ? 'SIGKILL' : 'SIGTERM';
  for (const p of pids) {
    try {
      process.kill(p, signal);
    } catch {
      // Process may have already exited
    }
  }

  // Wait for processes to die (async) - wait for root last
  for (const p of pids) {
    await waitForProcessToDie(p, force);
  }

  return true;
}

/**
 * Waits for a process to die, escalating to SIGKILL if SIGTERM doesn't work.