Function spawnProcess

src/node/services/backgroundProcessExecutor.ts:117–207

(
  runtime: Runtime,
  script: string,
  options: SpawnOptions
)

 * @param options Spawn options
 */
export async function spawnProcess(
  runtime: Runtime,
  script: string,
  options: SpawnOptions
): Promise<SpawnResult> {
  log.debug(`BackgroundProcessExecutor.spawnProcess: Spawning in ${options.cwd}`);

  // Get temp directory from runtime (absolute path, runtime-agnostic)
  const tempDir = await runtime.tempDir();
  const bgOutputDir = `${tempDir}/${BG_OUTPUT_SUBDIR}`;

  // Use shell-safe quoting for paths (handles spaces, special chars)
  const quotePath = quotePathForShell;

  // Verify working directory exists
  const cwdCheck = await execBuffered(runtime, `cd ${quotePath(options.cwd)}`, {
    cwd: FALLBACK_CWD,
    timeout: 10,
  });
  if (cwdCheck.exitCode !== 0) {
    return { success: false, error: `Working directory does not exist: ${options.cwd}` };
  }

  // Compute output paths (unified output.log instead of separate stdout/stderr)
  const { outputDir, outputPath, exitCodePath } = computeOutputPaths(
    bgOutputDir,
    options.workspaceId,
    options.processId
  );

  // Create output directory and empty file
  try {
    await runtime.ensureDir(outputDir);
    await writeFileString(runtime, outputPath, "");
  } catch (error) {
    return {
      success: false,
      error: `Failed to create output directory: ${errorMsg(error)}`,
    };
  }

  // Build wrapper script (same for all runtimes now that paths are absolute)
  // Note: buildWrapperScript handles quoting internally via shellQuote
  const wrapperScript = buildWrapperScript({
    exitCodePath,
    cwd: options.cwd,
    env: { ...options.env, ...NON_INTERACTIVE_ENV_VARS },
    script,
  });

  const spawnCommand = buildSpawnCommand({
    wrapperScript,
    outputPath,
    quotePath,
  });

  try {
    // No timeout - the spawn command backgrounds the process and returns immediately