import type { ReportDocument, ReportIndexCard } from '../types/index.js';
export declare function isCanonicalReportId(value: unknown): value is string;
/**
 * Parse a persisted report at every storage boundary. Canonical report files
 * are the source of truth; index cards must never relax this contract.
 */
export declare function parseReportDocument(value: unknown, fallbackId: string, expectedId?: string): ReportDocument | null;
/**
 * Validate a lightweight report discovery card. The card is still only a
 * pointer: consumers must parse `path` through `parseReportDocument` before use.
 */
export declare function parseReportIndexCard(value: unknown): ReportIndexCard | null;