Function ensureDaemonRunning

src/cli/daemon-control.ts:201–229

(opts: EnsureDaemonRunningOptions)

 * This is the main entry point for auto-start behavior.
 */
export async function ensureDaemonRunning(opts: EnsureDaemonRunningOptions): Promise<void> {
  const client = new DaemonClient({ socketPath: opts.socketPath });
  const timeoutMs = opts.startupTimeoutMs ?? DEFAULT_DAEMON_STARTUP_TIMEOUT_MS;

  const isRunning = await client.isRunning();
  if (isRunning) {
    try {
      await client.status();
      return;
    } catch (error) {
      if (error instanceof DaemonVersionMismatchError) {
        await forceStopDaemon(opts.socketPath);
      } else {
        return;
      }
    }
  }

  startDaemonBackground({
    socketPath: opts.socketPath,
    workspaceRoot: opts.workspaceRoot,
    env: opts.env,
  });

  await waitForDaemonReady({
    socketPath: opts.socketPath,
    timeoutMs,
  });
}

export interface StartDaemonForegroundOptions {
  socketPath: string;