claude-conversation-memory-mcp 0.6.0 → 1.0.0

package/dist/ConversationMemory.d.ts

@@ -1,16 +1,64 @@
 /**
- * Main Orchestrator - Coordinates all components
+ * Main Orchestrator - Coordinates all components for conversation memory indexing and retrieval.
+ *
+ * ConversationMemory is the primary interface for the conversation-memory-mcp system.
+ * It orchestrates parsing, storage, extraction, and search of Claude Code conversation history.
+ *
+ * @example
+ * ```typescript
+ * const memory = new ConversationMemory();
+ * await memory.indexConversations({
+ *   projectPath: '/path/to/project',
+ *   enableGitIntegration: true
+ * });
+ * ```
  */
 import { ConversationStorage } from "./storage/ConversationStorage.js";
 import { SemanticSearch } from "./search/SemanticSearch.js";
+/**
+ * Configuration options for indexing conversations.
+ */
 export interface IndexOptions {
+    /** Absolute path to the project directory to index */
     projectPath: string;
+    /** Optional: Index only a specific session ID instead of all sessions */
     sessionId?: string;
+    /**
+     * Whether to include thinking blocks in the index.
+     * Thinking blocks can be large and are excluded by default.
+     * @default false
+     */
     includeThinking?: boolean;
+    /**
+     * Enable git integration to link commits to conversations.
+     * Requires the project to be a git repository.
+     * @default true
+     */
     enableGitIntegration?: boolean;
+    /**
+     * Exclude MCP tool conversations from indexing.
+     * - `false`: Index all conversations (default)
+     * - `'self-only'`: Exclude only conversation-memory MCP conversations (prevents self-referential loops)
+     * - `'all-mcp'` or `true`: Exclude all MCP tool conversations
+     * @default false
+     */
     excludeMcpConversations?: boolean | 'self-only' | 'all-mcp';
+    /**
+     * List of specific MCP server names to exclude.
+     * More granular than `excludeMcpConversations`.
+     * @example ['conversation-memory', 'code-graph-rag']
+     */
     excludeMcpServers?: string[];
 }
+/**
+ * Main orchestrator for conversation memory operations.
+ *
+ * Coordinates parsing, storage, extraction, and search across:
+ * - Conversation parsing from JSONL files
+ * - Decision, mistake, and requirement extraction
+ * - Git commit integration
+ * - Semantic search with embeddings
+ */
 export declare class ConversationMemory {
     private sqliteManager;
     private storage;
@@ -21,7 +69,39 @@ export declare class ConversationMemory {
     private semanticSearch;
     constructor();
     /**
-     * Index conversations for a project
+     * Index conversations for a project.
+     *
+     * This is the main entry point for processing conversation history.
+     * It performs the following operations:
+     * 1. Parse conversation JSONL files from the project
+     * 2. Store conversations, messages, and tool interactions
+     * 3. Extract decisions, mistakes, and requirements
+     * 4. Link git commits (if enabled)
+     * 5. Generate semantic embeddings for search
+     *
+     * @param options - Configuration options for indexing
+     * @returns Result object containing:
+     * - `embeddings_generated`: Whether embeddings were successfully generated
+     * - `embedding_error`: Error message if embedding generation failed
+     * - `indexed_folders`: List of folders that were indexed
+     * - `database_path`: Path to the SQLite database
+     *
+     * @throws {Error} If project path doesn't exist or conversation files can't be parsed
+     *
+     * @example
+     * ```typescript
+     * const result = await memory.indexConversations({
+     *   projectPath: '/Users/me/my-project',
+     *   enableGitIntegration: true,
+     *   excludeMcpConversations: 'self-only'
+     * });
+     *
+     * if (result.embeddings_generated) {
+     *   console.log('Indexed folders:', result.indexed_folders);
+     * } else {
+     *   console.warn('Embeddings failed:', result.embedding_error);
+     * }
+     * ```
      */
     indexConversations(options: IndexOptions): Promise<{
         embeddings_generated: boolean;
@@ -30,15 +110,55 @@ export declare class ConversationMemory {
         database_path?: string;
     }>;
     /**
-     * Search conversations
+     * Search conversations using natural language query.
+     *
+     * Uses semantic search with embeddings if available, otherwise falls back to full-text search.
+     *
+     * @param query - Natural language search query
+     * @param limit - Maximum number of results to return (default: 10)
+     * @returns Array of search results with messages, conversations, and similarity scores
+     *
+     * @example
+     * ```typescript
+     * const results = await memory.search('authentication bug fix', 5);
+     * results.forEach(r => {
+     *   console.log(`${r.similarity}: ${r.snippet}`);
+     * });
+     * ```
      */
     search(query: string, limit?: number): Promise<import("./search/SemanticSearch.js").SearchResult[]>;
     /**
-     * Search decisions
+     * Search for decisions using natural language query.
+     *
+     * Searches through extracted decisions to find relevant architectural choices and technical decisions.
+     *
+     * @param query - Natural language search query
+     * @param limit - Maximum number of results to return (default: 10)
+     * @returns Array of decision search results with similarity scores
+     *
+     * @example
+     * ```typescript
+     * const decisions = await memory.searchDecisions('database choice', 3);
+     * decisions.forEach(d => {
+     *   console.log(`Decision: ${d.decision.decision_text}`);
+     *   console.log(`Rationale: ${d.decision.rationale}`);
+     * });
+     * ```
      */
     searchDecisions(query: string, limit?: number): Promise<import("./search/SemanticSearch.js").DecisionSearchResult[]>;
     /**
-     * Get file timeline
+     * Get the timeline of changes for a specific file.
+     *
+     * Returns all edits, commits, and related conversations for a file across its history.
+     *
+     * @param filePath - Path to the file (relative to project root)
+     * @returns Timeline of file changes with conversations and commits
+     *
+     * @example
+     * ```typescript
+     * const timeline = memory.getFileTimeline('src/index.ts');
+     * console.log(`${timeline.length} changes to this file`);
+     * ```
      */
     getFileTimeline(filePath: string): {
         file_path: string;
@@ -47,7 +167,16 @@ export declare class ConversationMemory {
         decisions: import("./parsers/DecisionExtractor.js").Decision[];
     };
     /**
-     * Get statistics
+     * Get statistics about the indexed conversation data.
+     *
+     * @returns Object containing counts for conversations, messages, decisions, mistakes, and commits
+     *
+     * @example
+     * ```typescript
+     * const stats = memory.getStats();
+     * console.log(`Indexed ${stats.conversations.count} conversations`);
+     * console.log(`Extracted ${stats.decisions.count} decisions`);
+     * ```
      */
     getStats(): {
         conversations: {
@@ -67,16 +196,28 @@ export declare class ConversationMemory {
         };
     };
     /**
-     * Get storage instance
+     * Get the underlying storage instance for direct database access.
+     *
+     * Use with caution - prefer using the high-level methods when possible.
+     *
+     * @returns ConversationStorage instance
+     * @internal
      */
     getStorage(): ConversationStorage;
     /**
-     * Get semantic search instance
+     * Get the semantic search instance for advanced search operations.
+     *
+     * @returns SemanticSearch instance
+     * @internal
      */
     getSemanticSearch(): SemanticSearch;
     /**
-     * Filter MCP conversations from parse results
-     * Strategy: Filter at MESSAGE level, not conversation level
+     * Filter MCP conversations from parse results.
+     *
+     * Implements the exclusion logic for MCP tool conversations to prevent
+     * self-referential loops and reduce noise in the index.
+     *
+     * Strategy: Filter at MESSAGE level, not conversation level.
      * - Keep all conversations
      * - Exclude only messages that invoke specified MCP tools and their responses
      */

package/dist/ConversationMemory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConversationMemory.d.ts","sourceRoot":"","sources":["../src/ConversationMemory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAMvE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,uBAAuB,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC;IAC5D,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,qBAAqB,CAAwB;IACrD,OAAO,CAAC,cAAc,CAAiB;;IAYvC;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;QACvD,oBAAoB,EAAE,OAAO,CAAC;QAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IA8GF;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW;IAI9C;;OAEG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW;IAIvD;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM;;;;;;IAIhC;;OAEG;IACH,QAAQ;;;;;;;;;;;;;;;;;IAIR;;OAEG;IACH,UAAU;IAIV;;OAEG;IACH,iBAAiB;IAIjB;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;CAqE/B"}
+{"version":3,"file":"ConversationMemory.d.ts","sourceRoot":"","sources":["../src/ConversationMemory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAMvE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IAEpB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC;IAE5D;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,qBAAqB,CAAwB;IACrD,OAAO,CAAC,cAAc,CAAiB;;IAiBvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACG,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;QACvD,oBAAoB,EAAE,OAAO,CAAC;QAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IA8GF;;;;;;;;;;;;;;;;OAgBG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW;IAI9C;;;;;;;;;;;;;;;;;OAiBG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW;IAIvD;;;;;;;;;;;;;OAaG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM;;;;;;IAIhC;;;;;;;;;;;OAWG;IACH,QAAQ;;;;;;;;;;;;;;;;;IAIR;;;;;;;OAOG;IACH,UAAU;IAIV;;;;;OAKG;IACH,iBAAiB;IAIjB;;;;;;;;;OASG;IACH,OAAO,CAAC,sBAAsB;CAqE/B"}

package/dist/ConversationMemory.js

@@ -1,5 +1,17 @@
 /**
- * Main Orchestrator - Coordinates all components
+ * Main Orchestrator - Coordinates all components for conversation memory indexing and retrieval.
+ *
+ * ConversationMemory is the primary interface for the conversation-memory-mcp system.
+ * It orchestrates parsing, storage, extraction, and search of Claude Code conversation history.
+ *
+ * @example
+ * ```typescript
+ * const memory = new ConversationMemory();
+ * await memory.indexConversations({
+ *   projectPath: '/path/to/project',
+ *   enableGitIntegration: true
+ * });
+ * ```
  */
 import { getSQLiteManager } from "./storage/SQLiteManager.js";
 import { ConversationStorage } from "./storage/ConversationStorage.js";
@@ -9,6 +21,15 @@ import { MistakeExtractor } from "./parsers/MistakeExtractor.js";
 import { GitIntegrator } from "./parsers/GitIntegrator.js";
 import { RequirementsExtractor } from "./parsers/RequirementsExtractor.js";
 import { SemanticSearch } from "./search/SemanticSearch.js";
+/**
+ * Main orchestrator for conversation memory operations.
+ *
+ * Coordinates parsing, storage, extraction, and search across:
+ * - Conversation parsing from JSONL files
+ * - Decision, mistake, and requirement extraction
+ * - Git commit integration
+ * - Semantic search with embeddings
+ */
 export class ConversationMemory {
     sqliteManager;
     storage;
@@ -20,6 +41,9 @@ export class ConversationMemory {
     constructor() {
         this.sqliteManager = getSQLiteManager();
         this.storage = new ConversationStorage(this.sqliteManager);
+        // Enable caching by default for better performance
+        // Cache up to 100 query results for 5 minutes
+        this.storage.enableCache({ maxSize: 100, ttlMs: 300000 });
         this.parser = new ConversationParser();
         this.decisionExtractor = new DecisionExtractor();
         this.mistakeExtractor = new MistakeExtractor();
@@ -27,7 +51,39 @@ export class ConversationMemory {
         this.semanticSearch = new SemanticSearch(this.sqliteManager);
     }
     /**
-     * Index conversations for a project
+     * Index conversations for a project.
+     *
+     * This is the main entry point for processing conversation history.
+     * It performs the following operations:
+     * 1. Parse conversation JSONL files from the project
+     * 2. Store conversations, messages, and tool interactions
+     * 3. Extract decisions, mistakes, and requirements
+     * 4. Link git commits (if enabled)
+     * 5. Generate semantic embeddings for search
+     *
+     * @param options - Configuration options for indexing
+     * @returns Result object containing:
+     * - `embeddings_generated`: Whether embeddings were successfully generated
+     * - `embedding_error`: Error message if embedding generation failed
+     * - `indexed_folders`: List of folders that were indexed
+     * - `database_path`: Path to the SQLite database
+     *
+     * @throws {Error} If project path doesn't exist or conversation files can't be parsed
+     *
+     * @example
+     * ```typescript
+     * const result = await memory.indexConversations({
+     *   projectPath: '/Users/me/my-project',
+     *   enableGitIntegration: true,
+     *   excludeMcpConversations: 'self-only'
+     * });
+     *
+     * if (result.embeddings_generated) {
+     *   console.log('Indexed folders:', result.indexed_folders);
+     * } else {
+     *   console.warn('Embeddings failed:', result.embedding_error);
+     * }
+     * ```
      */
     async indexConversations(options) {
         console.log("\n=== Indexing Conversations ===");
@@ -114,44 +170,105 @@ export class ConversationMemory {
         };
     }
     /**
-     * Search conversations
+     * Search conversations using natural language query.
+     *
+     * Uses semantic search with embeddings if available, otherwise falls back to full-text search.
+     *
+     * @param query - Natural language search query
+     * @param limit - Maximum number of results to return (default: 10)
+     * @returns Array of search results with messages, conversations, and similarity scores
+     *
+     * @example
+     * ```typescript
+     * const results = await memory.search('authentication bug fix', 5);
+     * results.forEach(r => {
+     *   console.log(`${r.similarity}: ${r.snippet}`);
+     * });
+     * ```
      */
     async search(query, limit = 10) {
         return this.semanticSearch.searchConversations(query, limit);
     }
     /**
-     * Search decisions
+     * Search for decisions using natural language query.
+     *
+     * Searches through extracted decisions to find relevant architectural choices and technical decisions.
+     *
+     * @param query - Natural language search query
+     * @param limit - Maximum number of results to return (default: 10)
+     * @returns Array of decision search results with similarity scores
+     *
+     * @example
+     * ```typescript
+     * const decisions = await memory.searchDecisions('database choice', 3);
+     * decisions.forEach(d => {
+     *   console.log(`Decision: ${d.decision.decision_text}`);
+     *   console.log(`Rationale: ${d.decision.rationale}`);
+     * });
+     * ```
      */
     async searchDecisions(query, limit = 10) {
         return this.semanticSearch.searchDecisions(query, limit);
     }
     /**
-     * Get file timeline
+     * Get the timeline of changes for a specific file.
+     *
+     * Returns all edits, commits, and related conversations for a file across its history.
+     *
+     * @param filePath - Path to the file (relative to project root)
+     * @returns Timeline of file changes with conversations and commits
+     *
+     * @example
+     * ```typescript
+     * const timeline = memory.getFileTimeline('src/index.ts');
+     * console.log(`${timeline.length} changes to this file`);
+     * ```
      */
     getFileTimeline(filePath) {
         return this.storage.getFileTimeline(filePath);
     }
     /**
-     * Get statistics
+     * Get statistics about the indexed conversation data.
+     *
+     * @returns Object containing counts for conversations, messages, decisions, mistakes, and commits
+     *
+     * @example
+     * ```typescript
+     * const stats = memory.getStats();
+     * console.log(`Indexed ${stats.conversations.count} conversations`);
+     * console.log(`Extracted ${stats.decisions.count} decisions`);
+     * ```
      */
     getStats() {
         return this.storage.getStats();
     }
     /**
-     * Get storage instance
+     * Get the underlying storage instance for direct database access.
+     *
+     * Use with caution - prefer using the high-level methods when possible.
+     *
+     * @returns ConversationStorage instance
+     * @internal
      */
     getStorage() {
         return this.storage;
     }
     /**
-     * Get semantic search instance
+     * Get the semantic search instance for advanced search operations.
+     *
+     * @returns SemanticSearch instance
+     * @internal
      */
     getSemanticSearch() {
         return this.semanticSearch;
     }
     /**
-     * Filter MCP conversations from parse results
-     * Strategy: Filter at MESSAGE level, not conversation level
+     * Filter MCP conversations from parse results.
+     *
+     * Implements the exclusion logic for MCP tool conversations to prevent
+     * self-referential loops and reduce noise in the index.
+     *
+     * Strategy: Filter at MESSAGE level, not conversation level.
      * - Keep all conversations
      * - Exclude only messages that invoke specified MCP tools and their responses
      */

package/dist/ConversationMemory.js.map

@@ -1 +1 @@
-{"version":3,"file":"ConversationMemory.js","sourceRoot":"","sources":["../src/ConversationMemory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ConversationMemory.js","sourceRoot":"","sources":["../src/ConversationMemory.ts"],"names":[],"mappings":"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"}

package/dist/cache/QueryCache.d.ts

@@ -0,0 +1,215 @@
+/**
+ * QueryCache - LRU cache for database query results
+ *
+ * Provides an in-memory caching layer with:
+ * - LRU (Least Recently Used) eviction policy
+ * - TTL (Time To Live) for automatic expiration
+ * - Cache statistics (hits, misses, evictions, hit rate)
+ * - Smart invalidation support
+ *
+ * Use this to cache expensive database queries like conversation searches,
+ * file timelines, and decision lookups.
+ *
+ * @example
+ * ```typescript
+ * const cache = new QueryCache({ maxSize: 100, ttlMs: 60000 });
+ *
+ * // Store query result
+ * cache.set('conversations:all', conversations);
+ *
+ * // Retrieve from cache
+ * const cached = cache.get('conversations:all');
+ * if (cached) {
+ *   return cached; // Cache hit
+ * }
+ *
+ * // Cache miss - query database
+ * const result = await queryDatabase();
+ * cache.set('conversations:all', result);
+ * return result;
+ * ```
+ */
+/**
+ * Configuration options for QueryCache
+ */
+export interface QueryCacheConfig {
+    /** Maximum number of entries to store */
+    maxSize: number;
+    /** Time to live in milliseconds before entries expire */
+    ttlMs: number;
+}
+/**
+ * Cache statistics for monitoring
+ */
+export interface CacheStats {
+    /** Number of cache hits */
+    hits: number;
+    /** Number of cache misses */
+    misses: number;
+    /** Number of entries evicted */
+    evictions: number;
+    /** Cache hit rate (0-1) */
+    hitRate: number;
+    /** Current cache size */
+    size: number;
+    /** Maximum cache size */
+    maxSize: number;
+}
+/**
+ * LRU cache with TTL support for database query results.
+ *
+ * Uses a Map for O(1) access and maintains LRU order by moving
+ * accessed entries to the end of the Map.
+ */
+export declare class QueryCache {
+    private cache;
+    private readonly config;
+    private stats;
+    /**
+     * Create a new QueryCache.
+     *
+     * @param config - Cache configuration
+     * @throws {Error} If configuration is invalid
+     *
+     * @example
+     * ```typescript
+     * // Create cache with 100 entries, 1 minute TTL
+     * const cache = new QueryCache({ maxSize: 100, ttlMs: 60000 });
+     * ```
+     */
+    constructor(config?: Partial<QueryCacheConfig>);
+    /**
+     * Store a value in the cache.
+     *
+     * If the key already exists, updates the value and resets TTL.
+     * If cache is full, evicts the least recently used entry.
+     *
+     * @param key - Cache key
+     * @param value - Value to cache
+     *
+     * @example
+     * ```typescript
+     * cache.set('user:123', { id: 123, name: 'Alice' });
+     * ```
+     */
+    set<T>(key: string, value: T): void;
+    /**
+     * Retrieve a value from the cache.
+     *
+     * Returns undefined if key doesn't exist or entry has expired.
+     * Updates access order (moves entry to end as most recently used).
+     *
+     * @param key - Cache key
+     * @returns Cached value or undefined
+     *
+     * @example
+     * ```typescript
+     * const user = cache.get<User>('user:123');
+     * if (user) {
+     *   console.log('Cache hit:', user.name);
+     * } else {
+     *   console.log('Cache miss');
+     * }
+     * ```
+     */
+    get<T>(key: string): T | undefined;
+    /**
+     * Check if a key exists in the cache.
+     *
+     * Returns false if key doesn't exist or entry has expired.
+     * Updates access order (moves entry to end as most recently used).
+     *
+     * @param key - Cache key
+     * @returns True if key exists and not expired
+     *
+     * @example
+     * ```typescript
+     * if (cache.has('user:123')) {
+     *   const user = cache.get('user:123');
+     * }
+     * ```
+     */
+    has(key: string): boolean;
+    /**
+     * Delete a key from the cache.
+     *
+     * Does nothing if key doesn't exist.
+     *
+     * @param key - Cache key to delete
+     *
+     * @example
+     * ```typescript
+     * cache.delete('user:123');
+     * ```
+     */
+    delete(key: string): void;
+    /**
+     * Clear all entries from the cache.
+     *
+     * Resets the cache but preserves statistics.
+     *
+     * @example
+     * ```typescript
+     * cache.clear(); // Remove all cached data
+     * ```
+     */
+    clear(): void;
+    /**
+     * Get current cache size.
+     *
+     * @returns Number of entries in cache
+     *
+     * @example
+     * ```typescript
+     * console.log(`Cache contains ${cache.size()} entries`);
+     * ```
+     */
+    size(): number;
+    /**
+     * Get cache statistics.
+     *
+     * Provides insight into cache performance:
+     * - Hit/miss counts
+     * - Hit rate percentage
+     * - Eviction count
+     * - Current size
+     *
+     * @returns Cache statistics object
+     *
+     * @example
+     * ```typescript
+     * const stats = cache.getStats();
+     * console.log(`Hit rate: ${(stats.hitRate * 100).toFixed(1)}%`);
+     * console.log(`Evictions: ${stats.evictions}`);
+     * ```
+     */
+    getStats(): CacheStats;
+    /**
+     * Reset statistics counters.
+     *
+     * Clears hit/miss/eviction counts but preserves cached data.
+     *
+     * @example
+     * ```typescript
+     * cache.resetStats(); // Start fresh statistics
+     * ```
+     */
+    resetStats(): void;
+    /**
+     * Check if an entry has expired based on TTL.
+     *
+     * @param entry - Cache entry to check
+     * @returns True if entry is expired
+     * @internal
+     */
+    private isExpired;
+    /**
+     * Remove all expired entries from the cache.
+     *
+     * Called automatically by size() to keep cache clean.
+     *
+     * @internal
+     */
+    private cleanupExpired;
+}
+//# sourceMappingURL=QueryCache.d.ts.map

package/dist/cache/QueryCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryCache.d.ts","sourceRoot":"","sources":["../../src/cache/QueryCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;CACf;AAYD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,KAAK,CAIX;IAEF;;;;;;;;;;;OAWG;gBACS,MAAM,GAAE,OAAO,CAAC,gBAAgB,CAAM;IAkBlD;;;;;;;;;;;;;OAaG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAsBnC;;;;;;;;;;;;;;;;;;OAkBG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAuBlC;;;;;;;;;;;;;;;OAeG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAoBzB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB;;;;;;;;;OASG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;;;;;OASG;IACH,IAAI,IAAI,MAAM;IAMd;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,IAAI,UAAU;IActB;;;;;;;;;OASG;IACH,UAAU,IAAI,IAAI;IAQlB;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;IAKjB;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;CAavB"}