Function onExit

apps/desktop/src/main/sidecar.ts:348–390

(code: number | null, signal: NodeJS.Signals | null)

    };

    const onExit = (code: number | null, signal: NodeJS.Signals | null) => {
      if (resolved) {
        // Post-boot exit. Expected when we stopped it ourselves (quit, restart,
        // update) and when something outside the app interrupted it — the child
        // shares Electron's process group, so a group-wide SIGINT reaches it
        // directly and surfaces as code 130. Only the rest is a crash under a
        // live window, reported upstream with the stderr tail.
        const classification = classifySidecarExit({
          code,
          signal,
          stoppedByUs: expectedExits.has(child),
          appQuitting: isAppQuitting(),
        });
        if (classification.kind === "managed-stop") {
          sidecarLog.info(`exited (code=${code} signal=${signal}) — ${classification.reason}`);
          return;
        }
        if (classification.kind === "external-shutdown") {
          // The server really is gone, so the window still has to say so; it
          // just wasn't a crash, so nothing is reported.
          sidecarLog.info(
            `Sidecar shut down by ${classification.reason} (code=${code} signal=${signal})`,
          );
          unexpectedExitListener?.({ reported: false });
          return;
        }
        const message = `Sidecar exited unexpectedly (code=${code} signal=${signal})`;
        sidecarLog.error(message);
        reportSidecarCrash(message, stderrBuffer);
        unexpectedExitListener?.({ reported: true });
        return;
      }
      if (rejected) return;
      // Detect bind failure — the Node listener prints either "EADDRINUSE" or
      // "address already in use" on stderr before exiting non-zero.
      if (/EADDRINUSE|address already in use/i.test(stderrBuffer)) {
        reject(new SidecarPortInUseError(settings.port));
        return;
      }
      const message = `Sidecar exited before ready (code=${code} signal=${signal}). Stderr:\n${stderrBuffer}`;
      // oxlint-disable-next-line executor/no-error-constructor -- boundary: sidecar boot failure surfaces here as a rejected start promise
      reject(new Error(message));
    };

    child.stdout?.on("data", onStdout);
    child.stderr?.on("data", onStderr);