import { CachedResolvedSource, CachedRepoProfile, CachedTaskBrief, DocManifest, SyncState, SyncStateEntry } from '../shared/types';
export declare class StorageService {
    resolveRoot(rootDir?: string): string;
    resolvePath(rootDir: string | undefined, ...segments: string[]): string;
    toRelativePath(rootDir: string, absolutePath: string): string;
    resolveManifestPath(rootDir: string, manifestPath: string): string;
    ensureDir(targetPath: string): Promise<void>;
    removeDir(dirPath: string): Promise<void>;
    exists(targetPath: string): Promise<boolean>;
    readText(targetPath: string): Promise<string | undefined>;
    writeText(targetPath: string, content: string): Promise<void>;
    readJson<T>(targetPath: string, fallback: T): Promise<T>;
    writeJson(targetPath: string, value: unknown): Promise<void>;
    createContentHash(content: string): string;
    listManifestPaths(rootDir?: string): Promise<string[]>;
    readManifest(manifestPath: string): Promise<DocManifest | undefined>;
    readSyncState(rootDir?: string): Promise<SyncState>;
    readResolvedSources(rootDir?: string): Promise<Record<string, CachedResolvedSource>>;
    writeResolvedSources(rootDir: string | undefined, sources: Record<string, CachedResolvedSource>): Promise<void>;
    upsertResolvedSource(rootDir: string | undefined, source: CachedResolvedSource): Promise<void>;
    readRetrievalCache(rootDir?: string): Promise<Record<string, CachedTaskBrief>>;
    writeRetrievalCache(rootDir: string | undefined, cache: Record<string, CachedTaskBrief>): Promise<void>;
    upsertTaskBrief(rootDir: string | undefined, entry: CachedTaskBrief): Promise<void>;
    readRepoProfiles(rootDir?: string): Promise<Record<string, CachedRepoProfile>>;
    writeRepoProfiles(rootDir: string | undefined, profiles: Record<string, CachedRepoProfile>): Promise<void>;
    upsertRepoProfile(rootDir: string | undefined, entry: CachedRepoProfile): Promise<void>;
    writeSyncState(rootDir: string | undefined, state: SyncState): Promise<void>;
    upsertSyncStateEntry(rootDir: string | undefined, nextEntry: SyncStateEntry): Promise<void>;
    listDirectories(dirPath: string): Promise<string[]>;
    listFilesRecursively(dirPath: string, options?: {
        extensions?: string[];
        ignoreDirs?: string[];
        limit?: number;
    }): Promise<string[]>;
    private walkForManifests;
}