import type { GraphEdge, GraphNode, WikiGraph } from "./graph-index.js";
export declare const GRAPH_CHECKPOINT_SCHEMA_VERSION = 3;
export declare const GRAPH_BUILDER_VERSION = "wiki-graph-v3";
export interface GraphCheckpointWriteLimits {
    maxSnapshotBytes?: number;
    maxJournalBytes?: number;
    maxNodes?: number;
    maxEdges?: number;
    maxWarnings?: number;
}
export type GraphCheckpointWriteBoundsReason = "snapshot_bytes" | "journal_bytes" | "node_limit" | "edge_limit" | "warning_limit" | "payload_invalid";
export declare class GraphCheckpointBoundsError extends Error {
    readonly reason: GraphCheckpointWriteBoundsReason;
    readonly code = "graph_checkpoint_bounds_exceeded";
    constructor(reason: GraphCheckpointWriteBoundsReason);
}
export interface GraphDeltaInput {
    removedNodeIds: readonly string[];
    upsertNodes: readonly GraphNode[];
    removedEdges: readonly GraphEdge[];
    upsertEdges: readonly GraphEdge[];
    warningPatches: ReadonlyArray<{
        path: string;
        warnings: readonly string[];
    }>;
}
export type GraphCheckpointFallbackReason = "none" | "force_rebuild" | "graph_missing" | "graph_v2_migration" | "checkpoint_directory_symlink" | "checkpoint_directory_not_directory" | "graph_symlink" | "graph_not_regular" | "graph_oversized" | "graph_malformed" | "graph_schema_mismatch" | "graph_builder_mismatch" | "graph_checksum_mismatch" | "graph_bounds_invalid" | "graph_revision_mismatch" | "graph_journal_without_snapshot" | "graph_journal_symlink" | "graph_journal_oversized" | "graph_journal_malformed" | "graph_journal_lineage_mismatch";
export type GraphCheckpointRead = {
    kind: "v3";
    graph: WikiGraph;
    inputCorpusRevision: string;
    deltaCount: number;
    deltaBytes: number;
    artifactToken: string;
    fallbackReason: "none";
} | {
    kind: "legacy";
    graph: WikiGraph;
    fallbackReason: "graph_v2_migration";
} | {
    kind: "empty";
    fallbackReason: GraphCheckpointFallbackReason;
};
export declare function graphDeltaFile(wikiRoot: string): string;
export declare function graphArtifactToken(wikiRoot: string): Promise<string>;
export declare function readGraphCheckpoint(wikiRoot: string): Promise<GraphCheckpointRead>;
export declare function serializeGraphCheckpoint(graph: WikiGraph, inputCorpusRevision: string, writeLimits?: GraphCheckpointWriteLimits): string;
export declare function serializeGraphDelta(baseRevision: string, newRevision: string, input: GraphDeltaInput, writeLimits?: GraphCheckpointWriteLimits): string;
//# sourceMappingURL=graph-checkpoint.d.ts.map