Function launchSimulatorApp

src/utils/simulator-steps.ts:120–141

(
  simulatorId: string,
  bundleId: string,
  executor: CommandExecutor,
  opts?: { args?: string[]; env?: Record<string, string> },
)

 * Launch an app on a simulator and return the process ID if available.
 */
export async function launchSimulatorApp(
  simulatorId: string,
  bundleId: string,
  executor: CommandExecutor,
  opts?: { args?: string[]; env?: Record<string, string> },
): Promise<LaunchStepResult> {
  log('info', `Launching app with bundle ID: ${bundleId} on simulator: ${simulatorId}`);
  const command = ['xcrun', 'simctl', 'launch', simulatorId, bundleId];
  if (opts?.args?.length) {
    command.push(...opts.args);
  }

  const execOpts = opts?.env ? { env: normalizeSimctlChildEnv(opts.env) } : undefined;
  const result = await executor(command, 'Launch App', false, execOpts);
  if (!result.success) {
    return { success: false, error: result.error ?? 'Failed to launch app' };
  }

  const pidMatch = result.output?.match(/:\s*(\d+)\s*$/);
  const processId = pidMatch ? parseInt(pidMatch[1], 10) : undefined;
  return { success: true, processId };
}

export type ProcessSpawner = (
  command: string,