Function handleFatalSidecarFailure

apps/desktop/src/main/index.ts:1023–1062

(error: unknown)

// here, the boot-time update check never runs (it sits after a successful
// sidecar start), so a broken app could never self-update its way out.
const handleFatalSidecarFailure = async (error: unknown) => {
  showCrashScreen();
  if (app.isPackaged) {
    // Install whatever finishes downloading by the time the user quits the
    // failure dialog; if it downloads while the dialog is open, the regular
    // 'update-downloaded' prompt offers an immediate restart instead.
    const autoInstallPlan = planFatalAutoInstallOnQuit({
      packaged: true,
      retryAfterReset: false,
    });
    if (autoInstallPlan.enableDuringFailure) autoUpdater.autoInstallOnAppQuit = true;
    void runUpdateCheck({ alertOnFail: false, trigger: "boot" });
  }
  // oxlint-disable-next-line executor/no-instanceof-error, executor/no-unknown-error-message -- boundary: sidecar startup failures arrive as plain Node errors and render in a native dialog
  const detail = error instanceof Error ? (error.stack ?? error.message) : String(error);
  const { response } = await dialog.showMessageBox({
    type: "error",
    title: "Executor failed to start",
    message: "The local Executor server crashed during startup.",
    detail: `${detail.slice(0, 1800)}\n\nFull log: ${log.transports.file.getFile().path}`,
    buttons: ["Quit", "Reset data and retry…"],
    defaultId: 0,
    cancelId: 0,
  });
  // Damaged executor state (failed migration, corrupt SQLite) makes startup
  // fail forever — updating can't fix it. Offer the move-aside reset and one
  // immediate retry. Returns true when boot should be attempted again.
  const retryAfterReset = response === 1 && (await confirmResetState());
  const autoInstallPlan = planFatalAutoInstallOnQuit({
    packaged: app.isPackaged,
    retryAfterReset,
  });
  if (retryAfterReset) {
    if (autoInstallPlan.restoreAfterRecovery) autoUpdater.autoInstallOnAppQuit = false;
    const { backupDir } = resetExecutorState();
    await announceBackup(backupDir);
    return true;
  }
  return false;
};

const installApplicationMenu = () => {
  const isMac = process.platform === "darwin";