Function waitForDaemonReady

src/cli/daemon-control.ts:162–186

(opts: WaitForDaemonReadyOptions)

 * Throws if the daemon doesn't respond within the timeout.
 */
export async function waitForDaemonReady(opts: WaitForDaemonReadyOptions): Promise<void> {
  const client = new DaemonClient({
    socketPath: opts.socketPath,
    timeout: Math.min(opts.timeoutMs, 2000), // Short timeout for each status check
  });

  const pollInterval = opts.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
  const startTime = Date.now();

  while (Date.now() - startTime < opts.timeoutMs) {
    try {
      // Use status() to confirm protocol handler is ready (not just connect)
      await client.status();
      return; // Success
    } catch {
      // Not ready yet, wait and retry
      await new Promise((resolve) => setTimeout(resolve, pollInterval));
    }
  }

  throw new Error(
    `Daemon failed to start within ${opts.timeoutMs}ms. ` +
      `Check if another daemon is running or if there are permission issues.`,
  );
}

export interface EnsureDaemonRunningOptions {
  socketPath: string;