/**
 * Returns the default path where Claude Code saves /insight reports.
 */
export declare function getDefaultReportPath(): string;
export interface DetectResult {
    path: string;
    source: 'argument' | 'auto-detected';
}
/**
 * Detects the insight report file to analyze.
 *
 * If `fileArg` is provided, resolves and validates it.
 * Otherwise, checks the default report path.
 * Throws with actionable guidance when no report is found.
 */
export declare function detectReport(fileArg?: string): DetectResult;
/**
 * Wait for a report file to appear at the given path.
 * Uses fs.watch on the parent directory with a polling fallback.
 * Resolves with the file path when found, rejects on timeout.
 */
export declare function waitForReport(targetPath: string, timeoutMs: number): Promise<string>;