import type { LineageEvent, LineageEventType } from "./lineage-contract.js";
export declare function newLineageEventId(): string;
export declare function appendLineageEvent(workspacePath: string, input: {
    eventType: LineageEventType;
    recommendationTaskId: string;
    evidenceKey: string;
    payload: LineageEvent["payload"];
    eventId?: string;
    timestamp?: string;
}): Promise<LineageEvent>;
export declare function readLineageEvents(workspacePath: string): Promise<LineageEvent[]>;
/** Reconstruct rec → dec → app chain for a recommendation task id (deterministic sort by timestamp). */
export declare function queryLineageChain(workspacePath: string, recommendationTaskId: string): Promise<{
    events: LineageEvent[];
    byType: Record<LineageEventType, LineageEvent[]>;
}>;
