import type { ObservationCache } from "./observation-cache.js";
import type { FileSystem } from "../ports/filesystem.js";
export interface KnowledgeFileEntry {
    readonly path: string;
    readonly symbols: readonly string[];
    readonly readCount: number;
    readonly lastReadAt: string;
    readonly stale: boolean;
}
export interface KnowledgeMapResult {
    readonly totalFiles: number;
    readonly totalSymbols: number;
    readonly files: readonly KnowledgeFileEntry[];
    readonly staleFiles: readonly string[];
    readonly directoryCoverage: Readonly<Record<string, number>>;
}
export interface KnowledgeMapOptions {
    readonly cache: ObservationCache;
    readonly fs: FileSystem;
    readonly projectRoot: string;
}
/**
 * Build a knowledge map from the current observation cache.
 *
 * For each observed file, checks whether the file has changed on disk
 * since it was last read (staleness). Aggregates symbols and directory
 * coverage.
 */
export declare function buildKnowledgeMap(options: KnowledgeMapOptions): Promise<KnowledgeMapResult>;
//# sourceMappingURL=knowledge-map.d.ts.map