/**
 * GitMem Cache Service
 *
 * File-based cache for GitMem MCP operations.
 * Caches search results to avoid repeated ww-mcp calls.
 *
 * Design: docs/systems/gitmem-caching.md
 *
 */
declare const TTL: {
    readonly SCAR_SEARCH: number;
    readonly DECISIONS: number;
    readonly WINS: number;
    readonly SESSIONS: number;
    readonly SCAR_USAGE: number;
};
/**
 * Cache statistics
 */
export interface CacheStats {
    resultCount: number;
    resultBytes: number;
    oldestEntry: Date | null;
    hitRate?: number;
}
/**
 * CacheService class
 *
 * Provides file-based caching for GitMem operations.
 * Designed for graceful degradation - cache failures never block operations.
 */
export declare class CacheService {
    private cacheDir;
    private resultsDir;
    private enabled;
    private hits;
    private misses;
    constructor(cacheDir?: string);
    /**
     * Initialize cache directories
     */
    private init;
    /**
     * Check if cache is enabled and working
     */
    isEnabled(): boolean;
    /**
     * Disable cache (for testing or on errors)
     */
    disable(): void;
    /**
     * Generate cache key for scar search
     */
    scarSearchKey(query: string, project: string, matchCount: number): string;
    /**
     * Generate cache key for decisions
     */
    decisionsKey(project: string, limit: number): string;
    /**
     * Generate cache key for wins
     */
    winsKey(project: string, limit: number): string;
    /**
     * Get cached result
     */
    getResult<T>(key: string): Promise<{
        data: T;
        age_ms: number;
    } | null>;
    /**
     * Set cached result
     */
    setResult<T>(key: string, data: T, ttlMs: number): Promise<void>;
    /**
     * Convenience method: get or fetch scar search results
     */
    getOrFetchScarSearch<T>(query: string, project: string, matchCount: number, fetcher: () => Promise<T>): Promise<{
        data: T;
        cache_hit: boolean;
        cache_age_ms?: number;
    }>;
    /**
     * Convenience method: get or fetch decisions
     */
    getOrFetchDecisions<T>(project: string, limit: number, fetcher: () => Promise<T>): Promise<{
        data: T;
        cache_hit: boolean;
        cache_age_ms?: number;
    }>;
    /**
     * Convenience method: get or fetch wins
     */
    getOrFetchWins<T>(project: string, limit: number, fetcher: () => Promise<T>): Promise<{
        data: T;
        cache_hit: boolean;
        cache_age_ms?: number;
    }>;
    /**
     * Generate cache key for sessions (analytics)
     */
    sessionsKey(project: string, days: number, agent?: string): string;
    /**
     * Generate cache key for scar usage (analytics)
     */
    scarUsageKey(project: string, days: number, agent?: string): string;
    /**
     * Convenience method: get or fetch sessions
     */
    getOrFetchSessions<T>(project: string, days: number, agent: string | undefined, fetcher: () => Promise<T>): Promise<{
        data: T;
        cache_hit: boolean;
        cache_age_ms?: number;
    }>;
    /**
     * Convenience method: get or fetch scar usage
     */
    getOrFetchScarUsage<T>(project: string, days: number, agent: string | undefined, fetcher: () => Promise<T>): Promise<{
        data: T;
        cache_hit: boolean;
        cache_age_ms?: number;
    }>;
    /**
     * Clean up expired entries
     */
    cleanup(): Promise<number>;
    /**
     * Clear all cached data
     */
    clear(): Promise<void>;
    /**
     * Get cache statistics
     */
    getStats(): Promise<CacheStats>;
    /**
     * Convert cache key to safe filename
     */
    private keyToFilename;
}
/**
 * Get the cache service singleton
 */
export declare function getCache(): CacheService;
/**
 * Reset cache instance (for testing)
 */
export declare function resetCache(): void;
export { TTL };
//# sourceMappingURL=cache.d.ts.map