import type { SpecVersionDiff, VersionSummary, ComputeDiffOptions } from '../types/index.js';
/** Format a SpecVersionDiff as a human-readable +/- text block. */
export declare function formatDiffAsText(diff: SpecVersionDiff): string;
/**
 * Compute a diff between two version tags of a spec.
 * If toVersion is omitted, uses the latest version.
 * If both fromVersion and toVersion are omitted, compares latest vs penultimate.
 */
export declare function computeSpecVersionDiff(opts: ComputeDiffOptions): Promise<SpecVersionDiff>;
/**
 * List all version snapshots for a spec as VersionSummary objects.
 * Returns them in reverse chronological order (newest first).
 */
export declare function listSpecVersionHistory(dataDir: string, specId: string, limit?: number): Promise<VersionSummary[]>;
//# sourceMappingURL=spec-differ.d.ts.map