import type { Repositories } from "../repositories/index.js";
import type { ProjectSnapshot } from "../types.js";
/**
 * Manages cached project scanning and snapshot generation.
 */
export declare class ProjectScanService {
    private repos;
    constructor(repos: Repositories);
    /**
     * Get the project snapshot from cache or perform a fresh scan.
     * Returns null if scanning fails (best-effort).
     */
    getOrRefresh(projectRoot: string, forceRefresh?: boolean, maxDepth?: number): ProjectSnapshot | null;
    /**
     * Build a fresh project snapshot and cache it.
     */
    buildFreshSnapshot(projectRoot: string, maxDepth?: number): ProjectSnapshot;
}
//# sourceMappingURL=project-scan.service.d.ts.map