Function installService

apps/cli/src/main.ts:2899–3017

(port: number, commandName: string, boot = false)

};

const installService = (port: number, commandName: string, boot = false) =>
  Effect.gen(function* () {
    const command = `${cliPrefix} ${commandName}`;
    if (isDevMode) {
      return yield* Effect.fail(
        new Error(
          [
            `\`${command}\` requires the compiled \`executor\` binary so the OS can run it directly.`,
            `In a dev checkout, run \`${cliPrefix} daemon run --foreground\` instead.`,
          ].join("\n"),
        ),
      );
    }

    const backend = getServiceBackend();

    // `--boot` only means something on Windows (a boot/S4U Scheduled Task). The
    // launchd/systemd backends silently ignore the descriptor field, so warn
    // rather than let a macOS/Linux caller believe it took effect.
    if (boot && backend.platform !== "win32") {
      console.warn(
        `Note: --boot is a Windows-only option and has no effect on ${process.platform}; installing the standard login-based service.`,
      );
    }

    if (!backend.automated) {
      // Unsupported platforms surface their manual steps via the install error.
      yield* backend.install({
        executablePath: process.execPath,
        port,
        version: CLI_VERSION,
        boot,
      });
      return;
    }

    const status = yield* backend.status();
    const active = yield* readActiveLocalServerManifest().pipe(Effect.orElseSucceed(() => null));
    const plan = planServiceInstall({
      registered: status.registered,
      running: status.running,
      activeKind: active?.kind ?? null,
      activePid: active?.pid ?? null,
      servicePid: status.pid,
      activeVersion: active?.owner.version ?? null,
      activeExecutablePath: active?.owner.executablePath ?? null,
      activePort: active ? portFromOrigin(active.connection.origin) : null,
      requestedPort: port,
      currentVersion: CLI_VERSION,
      currentExecutablePath: process.execPath,
    });

    if (plan === "noop") {
      const where = active ? ` at ${active.connection.origin} (pid ${active.pid})` : "";
      console.log(`Executor background service is already running${where}.`);
      console.log(`Open it in your browser, already signed in, with:  ${cliPrefix} web`);
      return;
    }