Function start

src/tools/browser/process-registry.ts:83–139

(opts: StartOptions)

}

export async function start(opts: StartOptions): Promise<ProcessInfo> {
  const existing = processes.get(opts.name);
  if (existing && existing.exitCode === null) {
    if (opts.replace) {
      await stop(opts.name);
    } else {
      throw new DevServerError(`Process '${opts.name}' is already running (pid ${existing.pid}). Pass replace=true to restart it.`);
    }
  }
  // Use shell: true so things like "npm run dev" and "php -S localhost:8000 -t public" work as-is.
  const child = spawn(opts.command, {
    cwd: opts.cwd ?? process.cwd(),
    env: { ...process.env, ...(opts.env ?? {}) },
    shell: true,
    detached: false,
    stdio: ['pipe', 'pipe', 'pipe'],
  });

  if (!child.pid) {
    throw new DevServerError(`Failed to spawn '${opts.command}'`);
  }

  const proc: ManagedProcess = {
    name: opts.name,
    command: opts.command,
    cwd: opts.cwd ?? process.cwd(),
    startedAt: Date.now(),
    pid: child.pid,
    child,
    stdout: '',
    stderr: '',
    combined: '',
    exitCode: null,
    exitSignal: null,
  };
  child.stdout?.on('data', (data: Buffer) => {
    const str = data.toString('utf-8');
    proc.stdout = appendCapped(proc.stdout, str);
    proc.combined = appendCapped(proc.combined, str);
  });
  child.stderr?.on('data', (data: Buffer) => {
    const str = data.toString('utf-8');
    proc.stderr = appendCapped(proc.stderr, str);
    proc.combined = appendCapped(proc.combined, str);
  });
  child.on('exit', (code, signal) => {
    proc.exitCode = code;
    proc.exitSignal = signal;
    logger.info(`Process '${opts.name}' exited`, { pid: proc.pid, code, signal });
  });
  child.on('error', (err) => {
    logger.warn(`Process '${opts.name}' error`, { err: err.message });
  });
  processes.set(opts.name, proc);
  logger.info(`Started process '${opts.name}'`, { pid: child.pid, command: opts.command });
  return infoFor(proc);
}