Function ensureFixtureForeground

scripts/integration/cli.mjs:896–1003

(label, options = {})

}

async function ensureFixtureForeground(label, options = {}) {
  const recoveryCount = options.recoveryCount ?? 0;
  const maxRecoveries = options.maxLaunchRecoveries ?? 1;
  let launchError = null;
  let launchVerifyError = null;
  try {
    await retrySimdeckJson(
      cliArgs(["launch", simulatorUDID, fixtureBundleId]),
      label,
      {
        attempts: options.launchAttempts ?? 1,
        delayMs: options.launchDelayMs ?? 5_000,
        timeoutMs: options.launchTimeoutMs ?? 180_000,
      },
    );
  } catch (error) {
    launchError = error;
    logStep(`${label}: launch command reported ${summarizeError(error)}`);
  }

  try {
    return await verifyUi(label, {
      expectFixture: true,
      attempts: options.verifyAttempts ?? (launchError === null ? 10 : 2),
      delayMs: options.verifyDelayMs ?? 1_000,
      waitTimeoutMs:
        options.waitTimeoutMs ?? (launchError === null ? 10_000 : 1_000),
    });
  } catch (verifyError) {
    launchVerifyError = verifyError;
    if (
      shouldRecycleSimulatorForFixtureLaunch({
        launchError,
        verifyError: launchVerifyError,
        recoveryCount,
        maxRecoveries,
      })
    ) {
      return recycleFixtureLaunchAndRetry(label, {
        ...options,
        reason: activationRecoveryReason({ launchError }),
      });
    }
    logStep(`${label}: opening fixture URL after launch verification failed`);
  }

  let urlError = null;
  try {
    await retrySimdeckJson(
      cliArgs(["open-url", simulatorUDID, fixtureUrl]),
      `${label} fixture URL fallback`,
      {
        attempts: 2,
        delayMs: 2_000,
        timeoutMs: 180_000,
      },
    );
    return await verifyUi(label, {