/**
 * Evidence recording for RCASD lifecycle stages.
 *
 * Records provenance evidence (files, URLs, manifests) linked to
 * lifecycle stages in SQLite.
 *
 * @task T5200
 * @epic T4798
 */
export type EvidenceType = 'file' | 'url' | 'manifest';
export interface EvidenceRecord {
    id: string;
    stageId: string;
    uri: string;
    type: EvidenceType;
    recordedAt: string;
    recordedBy?: string;
    description?: string;
}
/**
 * Record an evidence artifact linked to a lifecycle stage.
 *
 * Writes to the SQLite `lifecycle_evidence` table.
 *
 * @param epicId - Epic task ID (e.g. 'T4881')
 * @param stage - Canonical stage name (e.g. 'research')
 * @param uri - URI of the evidence artifact
 * @param type - Evidence type: 'file', 'url', or 'manifest'
 * @param options - Optional agent and description
 * @returns The created evidence record
 */
export declare function recordEvidence(epicId: string, stage: string, uri: string, type: EvidenceType, options?: {
    agent?: string;
    description?: string;
    cwd?: string;
}): Promise<EvidenceRecord>;
/**
 * Query evidence records for an epic, optionally filtered by stage.
 *
 * @param epicId - Epic task ID
 * @param stage - Optional stage name filter
 * @param cwd - Optional working directory
 * @returns Array of evidence records
 */
export declare function getEvidence(epicId: string, stage?: string, cwd?: string): Promise<EvidenceRecord[]>;
/**
 * Convenience wrapper to record a file as provenance evidence.
 *
 * Converts the file path to a URI relative to the `.cleo/` directory,
 * sets the type to 'file', and extracts a description from the filename.
 *
 * @param epicId - Epic task ID
 * @param stage - Canonical stage name
 * @param filePath - Absolute or relative path to the file
 * @param cwd - Optional working directory
 * @returns The created evidence record
 */
export declare function linkProvenance(epicId: string, stage: string, filePath: string, cwd?: string): Promise<EvidenceRecord>;
/**
 * Aggregate evidence counts per stage for an epic.
 *
 * @param epicId - Epic task ID
 * @param cwd - Optional working directory
 * @returns Array of per-stage summaries with type breakdowns
 */
export declare function getEvidenceSummary(epicId: string, cwd?: string): Promise<{
    stage: string;
    count: number;
    types: Record<EvidenceType, number>;
}[]>;
//# sourceMappingURL=evidence.d.ts.map