Function runProcess

actions/setup/js/process_runner.cjs:68–145

* Run a command with the given arguments, transparently forwarding stdin/stdout/stderr. * Also collects combined stdout+stderr output for error pattern detection. * * The child process is spawned with `cwd` set to `process.env.GH_AW_ENGINE_CWD` when * available, falling back to `process.env.GITH

({ command, args, attempt, log, logArgs, env })

 * @returns {Promise<{exitCode: number, output: string, hasOutput: boolean, durationMs: number}>}
 */
function runProcess({ command, args, attempt, log, logArgs, env }) {
  return new Promise(resolve => {
    const startTime = Date.now();
    // Guard against the promise being settled more than once.  On some systems Node
    // emits 'close' after 'error' (or vice-versa); only the first terminal event should
    // log and resolve so callers receive a deterministic result.
    let settled = false;
    /** @param {{exitCode: number, output: string, hasOutput: boolean, durationMs: number}} result */
    function settle(result) {
      if (settled) return;
      settled = true;
      resolve(result);
    }

    const argsForLog = logArgs ?? args;
    log(`attempt ${attempt + 1}: spawning: ${command} ${argsForLog.join(" ").substring(0, 200)}`);

    const child = spawn(command, args, {
      stdio: ["inherit", "pipe", "pipe"],
      env: env ?? process.env,
      cwd: process.env.GH_AW_ENGINE_CWD || process.env.GITHUB_WORKSPACE || undefined,
    });

    log(`attempt ${attempt + 1}: process started (pid=${child.pid ?? "unknown"})`);

    let collectedOutput = "";
    let hasOutput = false;
    let stdoutBytes = 0;
    let stderrBytes = 0;

    child.stdout.on(
      "data",
      /** @param {Buffer} data */ data => {
        hasOutput = true;
        stdoutBytes += data.length;
        collectedOutput += data.toString();
        process.stdout.write(data);
      }
    );

    child.stderr.on(
      "data",
      /** @param {Buffer} data */ data => {
        hasOutput = true;
        stderrBytes += data.length;
        collectedOutput += data.toString();
        process.stderr.write(data);
      }
    );

    child.on("exit", (code, signal) => {
      log(`attempt ${attempt + 1}: process exit event` + ` exitCode=${code ?? 1}` + (signal ? ` signal=${signal}` : ""));
    });

    // Resolve on 'close', not 'exit', to ensure stdio streams are fully drained.
    child.on("close", (code, signal) => {
      const durationMs = Date.now() - startTime;
      const exitCode = code ?? 1;