Function migrateToBackground

src/node/services/backgroundProcessExecutor.ts:381–412

(
  execStream: ExecStream,
  options: MigrateOptions,
  bgOutputDir: string
)

 * @param bgOutputDir Base directory for output files
 */
export async function migrateToBackground(
  execStream: ExecStream,
  options: MigrateOptions,
  bgOutputDir: string
): Promise<MigrateResult> {
  // Use shared path computation (path.join for local filesystem)
  const { outputDir, outputPath } = computeOutputPaths(
    bgOutputDir,
    options.workspaceId,
    options.processId
  );

  try {
    // Create output directory
    await fs.mkdir(outputDir, { recursive: true });

    // Write existing output to unified output.log
    await fs.writeFile(outputPath, options.existingOutput.join("\n") + "\n");

    // Create handle that will continue writing to file
    const handle = new MigratedBackgroundHandle(execStream, outputDir, outputPath);

    // Start consuming remaining output in background
    handle.startConsuming();

    return { success: true, handle, outputDir };
  } catch (error) {
    const errorMessage = errorMsg(error);
    log.debug(`migrateToBackground: Error: ${errorMessage}`);
    return { success: false, error: `Failed to migrate process: ${errorMessage}` };
  }
}

/**
 * Handle for a migrated foreground process.