import type { PackageConfig } from "./config.js";
export interface RepoMeta {
    commitHash: string;
    updatedAt: string;
}
/**
 * Check whether the cache for a repo is fresh (matches the given commit hash).
 */
export declare function isFresh(cacheDir: string, repoName: string, currentHash: string): Promise<boolean>;
/**
 * Read the cached repo metadata (commit hash + updatedAt). Returns undefined if no cache exists.
 */
export declare function readRepoMeta(cacheDir: string, repoName: string): Promise<RepoMeta | undefined>;
/**
 * Read the cached commit hash for a repo. Returns undefined if no cache exists.
 */
export declare function readCachedHash(cacheDir: string, repoName: string): Promise<string | undefined>;
/**
 * Record that a repo's cache is now up to date at the given commit.
 */
export declare function markFresh(cacheDir: string, repoName: string, commitHash: string): Promise<void>;
/**
 * Invalidate cache for a repo: delete its meta file and all package cache dirs
 * that belong to it.
 */
export declare function invalidate(cacheDir: string, repoName: string, packages: readonly PackageConfig[]): Promise<void>;
/**
 * Write a package's overview markdown to its cache directory.
 */
export declare function writeOverview(pkg: PackageConfig, content: string): Promise<void>;
/**
 * Read a package's cached overview markdown. Returns undefined if not cached.
 */
export declare function readOverview(pkg: PackageConfig): Promise<string | undefined>;
/**
 * Write a stripped .cs signature file to a package's cache.
 * `relPath` is the repo-relative path (e.g. "src/MyLib/Class1.cs").
 */
export declare function writeSignature(pkg: PackageConfig, relPath: string, content: string): Promise<void>;
/**
 * Read all cached signature files for a package.
 * Returns an array of { filePath, content } sorted by path.
 */
export declare function readSignatures(pkg: PackageConfig): Promise<Array<{
    filePath: string;
    content: string;
}>>;
/**
 * Write a package's symbol index to its cache directory (atomic).
 */
export declare function writeIndex(pkg: PackageConfig, content: string): Promise<void>;
/**
 * Read a package's cached symbol index. Returns undefined if not cached.
 */
export declare function readIndex(pkg: PackageConfig): Promise<string | undefined>;
//# sourceMappingURL=cacheManager.d.ts.map