import type { GapEntry, AppendGapEntryInput, GapsLogChainResult } from '../types/gap.js';
/**
 * Canonical serialisation of a gap entry (stable key order, excluding `sha`).
 */
export declare function canonicalGapEntry(entry: Omit<GapEntry, 'sha'>): string;
/**
 * Compute the SHA-256 of the canonical gap entry serialisation.
 */
export declare function computeGapEntrySha(entry: Omit<GapEntry, 'sha'>): string;
/**
 * Append a gap entry to the project's gaps log.
 * Writes are serialized per file to preserve hash-chain integrity.
 */
export declare function appendGapEntry(input: AppendGapEntryInput): Promise<GapEntry>;
/**
 * Read all gap entries from the project's gaps log.
 * Returns an empty array if the file does not exist.
 */
export declare function readGapsLog(projectId: string): Promise<GapEntry[]>;
/**
 * Verify the hash chain of the gaps log for a given project.
 * Returns validation result with the index of the first broken entry (if any).
 */
export declare function verifyGapsLogChain(projectId: string): Promise<GapsLogChainResult>;
//# sourceMappingURL=gaps-log.d.ts.map