import type { BoardDaemonHandle } from "./board/daemon.js";
export type DaemonPidFile = {
    pid: number;
    port: number;
    startedAt: string;
};
export declare function daemonPidPath(repoRoot: string): string;
/**
 * Phase 2 lifecycle: a single-instance guard. If a live daemon already holds
 * the pid file, returns its port without starting a second server. Otherwise
 * starts the board daemon in-process and writes the pid file.
 */
export declare function ensureBoardRunning(repoRoot: string, opts?: {
    port?: number;
    open?: boolean;
    scheduler?: boolean;
}): Promise<{
    port: number;
    url: string;
    started: boolean;
    handle?: BoardDaemonHandle;
}>;
