/** workspace path → epoch ms of the last COMPLETED index. */
export type CodeIndexCursor = Record<string, number>;
export declare function readCursor(): CodeIndexCursor;
/** Record a COMPLETED index. Never called for a failure — see the header. */
export declare function noteIndexed(workspace: string, now?: number): void;
/**
 * Order workspaces least-recently-indexed first, so a sweep that keeps getting
 * interrupted still eventually covers everything.
 *
 * Never-indexed workspaces sort before indexed ones — a repo the collector has
 * never looked at is more valuable than refreshing one done an hour ago. Ties
 * keep the caller's order, which is recency, so a first run behaves exactly as
 * it did before this existed.
 */
export declare function orderByStaleness(workspaces: string[], cursor?: CodeIndexCursor): string[];
/** Drop entries for paths that are no longer candidates. */
export declare function pruneCursor(known: string[]): void;
//# sourceMappingURL=code-index-cursor.d.ts.map