cccmemory 1.8.0

package/dist/cache/QueryCache.js

@@ -0,0 +1,294 @@
+/**
+ * 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;
+ * ```
+ */
+/**
+ * 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 class QueryCache {
+    cache;
+    config;
+    stats = {
+        hits: 0,
+        misses: 0,
+        evictions: 0,
+    };
+    /**
+     * 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 = {}) {
+        // Default configuration
+        this.config = {
+            maxSize: config.maxSize ?? 100,
+            ttlMs: config.ttlMs ?? 300000, // 5 minutes default
+        };
+        // Validate configuration
+        if (this.config.maxSize <= 0) {
+            throw new Error("maxSize must be greater than 0");
+        }
+        if (this.config.ttlMs <= 0) {
+            throw new Error("ttlMs must be greater than 0");
+        }
+        this.cache = new Map();
+    }
+    /**
+     * 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(key, value) {
+        // Remove old entry if exists (to update position)
+        if (this.cache.has(key)) {
+            this.cache.delete(key);
+        }
+        // Evict LRU entry if at capacity
+        if (this.cache.size >= this.config.maxSize) {
+            const firstKey = this.cache.keys().next().value;
+            if (firstKey !== undefined) {
+                this.cache.delete(firstKey);
+                this.stats.evictions++;
+            }
+        }
+        // Add new entry at end (most recently used)
+        this.cache.set(key, {
+            value: value,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * 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(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.stats.misses++;
+            return undefined;
+        }
+        // Check if expired
+        if (this.isExpired(entry)) {
+            this.cache.delete(key);
+            this.stats.misses++;
+            return undefined;
+        }
+        // Move to end (most recently used)
+        this.cache.delete(key);
+        this.cache.set(key, entry);
+        this.stats.hits++;
+        return entry.value;
+    }
+    /**
+     * 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) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return false;
+        }
+        // Check if expired
+        if (this.isExpired(entry)) {
+            this.cache.delete(key);
+            return false;
+        }
+        // Move to end (most recently used)
+        this.cache.delete(key);
+        this.cache.set(key, entry);
+        return true;
+    }
+    /**
+     * 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) {
+        this.cache.delete(key);
+    }
+    /**
+     * Clear all entries from the cache.
+     *
+     * Resets the cache but preserves statistics.
+     *
+     * @example
+     * ```typescript
+     * cache.clear(); // Remove all cached data
+     * ```
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Get current cache size.
+     *
+     * @returns Number of entries in cache
+     *
+     * @example
+     * ```typescript
+     * console.log(`Cache contains ${cache.size()} entries`);
+     * ```
+     */
+    size() {
+        // Clean up expired entries first
+        this.cleanupExpired();
+        return this.cache.size;
+    }
+    /**
+     * 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() {
+        const totalRequests = this.stats.hits + this.stats.misses;
+        const hitRate = totalRequests > 0 ? this.stats.hits / totalRequests : 0;
+        return {
+            hits: this.stats.hits,
+            misses: this.stats.misses,
+            evictions: this.stats.evictions,
+            hitRate,
+            size: this.cache.size,
+            maxSize: this.config.maxSize,
+        };
+    }
+    /**
+     * Reset statistics counters.
+     *
+     * Clears hit/miss/eviction counts but preserves cached data.
+     *
+     * @example
+     * ```typescript
+     * cache.resetStats(); // Start fresh statistics
+     * ```
+     */
+    resetStats() {
+        this.stats = {
+            hits: 0,
+            misses: 0,
+            evictions: 0,
+        };
+    }
+    /**
+     * Check if an entry has expired based on TTL.
+     *
+     * @param entry - Cache entry to check
+     * @returns True if entry is expired
+     * @internal
+     */
+    isExpired(entry) {
+        const age = Date.now() - entry.timestamp;
+        return age > this.config.ttlMs;
+    }
+    /**
+     * Remove all expired entries from the cache.
+     *
+     * Called automatically by size() to keep cache clean.
+     *
+     * @internal
+     */
+    cleanupExpired() {
+        const keysToDelete = [];
+        for (const [key, entry] of this.cache.entries()) {
+            if (this.isExpired(entry)) {
+                keysToDelete.push(key);
+            }
+        }
+        for (const key of keysToDelete) {
+            this.cache.delete(key);
+        }
+    }
+}
+//# sourceMappingURL=QueryCache.js.map

package/dist/cache/QueryCache.js.map

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

package/dist/cli/commands.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Command execution and parsing for CLI
+ */
+import { ToolHandlers } from "../tools/ToolHandlers.js";
+/**
+ * Execute a command
+ */
+export declare function executeCommand(input: string, handlers: ToolHandlers): Promise<string | null>;
+//# sourceMappingURL=commands.d.ts.map

package/dist/cli/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAkExD;;GAEG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqLxB"}