@qwickapps/qwickbrain-proxy 1.0.1 → 1.0.3

package/dist/lib/__tests__/write-queue-manager.test.js

@@ -0,0 +1,291 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { mkdtempSync, rmSync } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { createDatabase, runMigrations } from '../../db/client.js';
+import { WriteQueueManager } from '../write-queue-manager.js';
+import { QwickBrainClient } from '../qwickbrain-client.js';
+describe('WriteQueueManager', () => {
+    let tmpDir;
+    let writeQueueManager;
+    let qwickbrainClient;
+    let db;
+    beforeEach(() => {
+        // Create temporary directory for test database
+        tmpDir = mkdtempSync(join(tmpdir(), 'queue-test-'));
+        const dbResult = createDatabase(tmpDir);
+        db = dbResult.db;
+        // Run migrations to create tables
+        runMigrations(db);
+        // Create mock client
+        const config = {
+            mode: 'sse',
+            url: 'http://test.local:3000',
+        };
+        qwickbrainClient = new QwickBrainClient(config);
+        // Mock the write methods
+        vi.spyOn(qwickbrainClient, 'createDocument').mockResolvedValue();
+        vi.spyOn(qwickbrainClient, 'setMemory').mockResolvedValue();
+        vi.spyOn(qwickbrainClient, 'deleteDocument').mockResolvedValue();
+        vi.spyOn(qwickbrainClient, 'deleteMemory').mockResolvedValue();
+        writeQueueManager = new WriteQueueManager(db, qwickbrainClient);
+    });
+    afterEach(() => {
+        // Clean up temporary directory
+        rmSync(tmpDir, { recursive: true, force: true });
+        vi.restoreAllMocks();
+    });
+    describe('queueOperation', () => {
+        it('should queue a create_document operation', async () => {
+            await writeQueueManager.queueOperation('create_document', {
+                docType: 'workflow',
+                name: 'test-workflow',
+                content: 'workflow content',
+            });
+            const stats = await writeQueueManager.getQueueStats();
+            expect(stats.pending).toBe(1);
+            expect(stats.total).toBe(1);
+        });
+        it('should queue a set_memory operation', async () => {
+            await writeQueueManager.queueOperation('set_memory', {
+                name: 'test-memory',
+                content: 'memory content',
+            });
+            const stats = await writeQueueManager.getQueueStats();
+            expect(stats.pending).toBe(1);
+        });
+        it('should queue multiple operations', async () => {
+            await writeQueueManager.queueOperation('create_document', {
+                docType: 'workflow',
+                name: 'wf1',
+                content: 'content1',
+            });
+            await writeQueueManager.queueOperation('set_memory', {
+                name: 'mem1',
+                content: 'content2',
+            });
+            await writeQueueManager.queueOperation('create_document', {
+                docType: 'rule',
+                name: 'rule1',
+                content: 'content3',
+            });
+            const stats = await writeQueueManager.getQueueStats();
+            expect(stats.pending).toBe(3);
+            expect(stats.total).toBe(3);
+        });
+    });
+    describe('syncPendingOperations', () => {
+        it('should sync pending create_document operations', async () => {
+            await writeQueueManager.queueOperation('create_document', {
+                docType: 'workflow',
+                name: 'test-workflow',
+                content: 'workflow content',
+                project: 'my-project',
+                metadata: { author: 'test' },
+            });
+            const { synced, failed } = await writeQueueManager.syncPendingOperations();
+            expect(synced).toBe(1);
+            expect(failed).toBe(0);
+            expect(qwickbrainClient.createDocument).toHaveBeenCalledWith('workflow', 'test-workflow', 'workflow content', 'my-project', { author: 'test' });
+            const stats = await writeQueueManager.getQueueStats();
+            expect(stats.pending).toBe(0);
+            expect(stats.total).toBe(0); // Completed operations are cleaned up
+        });
+        it('should sync pending set_memory operations', async () => {
+            await writeQueueManager.queueOperation('set_memory', {
+                name: 'test-memory',
+                content: 'memory content',
+                project: 'my-project',
+            });
+            const { synced, failed } = await writeQueueManager.syncPendingOperations();
+            expect(synced).toBe(1);
+            expect(failed).toBe(0);
+            expect(qwickbrainClient.setMemory).toHaveBeenCalledWith('test-memory', 'memory content', 'my-project', undefined);
+        });
+        it('should sync multiple operations in order (FIFO)', async () => {
+            const callOrder = [];
+            vi.spyOn(qwickbrainClient, 'createDocument').mockImplementation(async (docType, name) => {
+                callOrder.push(`doc:${name}`);
+            });
+            vi.spyOn(qwickbrainClient, 'setMemory').mockImplementation(async (name) => {
+                callOrder.push(`mem:${name}`);
+            });
+            await writeQueueManager.queueOperation('create_document', {
+                docType: 'workflow',
+                name: 'first',
+                content: 'content',
+            });
+            await writeQueueManager.queueOperation('set_memory', {
+                name: 'second',
+                content: 'content',
+            });
+            await writeQueueManager.queueOperation('create_document', {
+                docType: 'rule',
+                name: 'third',
+                content: 'content',
+            });
+            const { synced } = await writeQueueManager.syncPendingOperations();
+            expect(synced).toBe(3);
+            expect(callOrder).toEqual(['doc:first', 'mem:second', 'doc:third']);
+        });
+        it('should handle operation failures and retry', async () => {
+            let callCount = 0;
+            vi.spyOn(qwickbrainClient, 'createDocument').mockImplementation(async () => {
+                callCount++;
+                if (callCount < 3) {
+                    throw new Error('Network error');
+                }
+            });
+            await writeQueueManager.queueOperation('create_document', {
+                docType: 'workflow',
+                name: 'test',
+                content: 'content',
+            });
+            // First sync - should fail (attempt 1)
+            let result = await writeQueueManager.syncPendingOperations();
+            expect(result.synced).toBe(0);
+            expect(result.failed).toBe(0);
+            let stats = await writeQueueManager.getQueueStats();
+            expect(stats.pending).toBe(1); // Still pending
+            // Second sync - should fail (attempt 2)
+            result = await writeQueueManager.syncPendingOperations();
+            expect(result.synced).toBe(0);
+            expect(result.failed).toBe(0);
+            // Third sync - should succeed (attempt 3)
+            result = await writeQueueManager.syncPendingOperations();
+            expect(result.synced).toBe(1);
+            expect(result.failed).toBe(0);
+            stats = await writeQueueManager.getQueueStats();
+            expect(stats.pending).toBe(0);
+        });
+        it('should mark operation as failed after max attempts', async () => {
+            vi.spyOn(qwickbrainClient, 'createDocument').mockRejectedValue(new Error('Permanent error'));
+            await writeQueueManager.queueOperation('create_document', {
+                docType: 'workflow',
+                name: 'test',
+                content: 'content',
+            });
+            // Attempt 1
+            let result = await writeQueueManager.syncPendingOperations();
+            expect(result.failed).toBe(0);
+            // Attempt 2
+            result = await writeQueueManager.syncPendingOperations();
+            expect(result.failed).toBe(0);
+            // Attempt 3 - max reached, marked as failed
+            result = await writeQueueManager.syncPendingOperations();
+            expect(result.synced).toBe(0);
+            expect(result.failed).toBe(1);
+            const stats = await writeQueueManager.getQueueStats();
+            expect(stats.pending).toBe(0);
+            expect(stats.failed).toBe(1);
+            const failedOps = await writeQueueManager.getFailedOperations();
+            expect(failedOps.length).toBe(1);
+            expect(failedOps[0].error).toContain('Permanent error');
+            expect(failedOps[0].attempts).toBe(3);
+        });
+        it('should skip sync if already syncing', async () => {
+            // Queue an operation that takes time
+            let resolveSync;
+            const syncPromise = new Promise((resolve) => {
+                resolveSync = resolve;
+            });
+            vi.spyOn(qwickbrainClient, 'createDocument').mockImplementation(async () => {
+                await syncPromise;
+            });
+            await writeQueueManager.queueOperation('create_document', {
+                docType: 'workflow',
+                name: 'test',
+                content: 'content',
+            });
+            // Start first sync (won't complete)
+            const sync1 = writeQueueManager.syncPendingOperations();
+            // Start second sync while first is running
+            const sync2 = writeQueueManager.syncPendingOperations();
+            // Second should skip
+            const result2 = await sync2;
+            expect(result2.synced).toBe(0);
+            expect(result2.failed).toBe(0);
+            // Complete first sync
+            resolveSync();
+            const result1 = await sync1;
+            expect(result1.synced).toBe(1);
+        });
+    });
+    describe('retryOperation', () => {
+        it('should reset a failed operation for retry', async () => {
+            vi.spyOn(qwickbrainClient, 'createDocument').mockRejectedValue(new Error('Error'));
+            await writeQueueManager.queueOperation('create_document', {
+                docType: 'workflow',
+                name: 'test',
+                content: 'content',
+            });
+            // Fail 3 times to mark as failed
+            await writeQueueManager.syncPendingOperations();
+            await writeQueueManager.syncPendingOperations();
+            await writeQueueManager.syncPendingOperations();
+            let stats = await writeQueueManager.getQueueStats();
+            expect(stats.failed).toBe(1);
+            const failedOps = await writeQueueManager.getFailedOperations();
+            const opId = failedOps[0].id;
+            // Fix the mock
+            vi.spyOn(qwickbrainClient, 'createDocument').mockResolvedValue();
+            // Retry the operation
+            await writeQueueManager.retryOperation(opId);
+            stats = await writeQueueManager.getQueueStats();
+            expect(stats.pending).toBe(1);
+            expect(stats.failed).toBe(0);
+            // Sync should now succeed
+            const result = await writeQueueManager.syncPendingOperations();
+            expect(result.synced).toBe(1);
+        });
+    });
+    describe('clearFailed', () => {
+        it('should clear all failed operations', async () => {
+            vi.spyOn(qwickbrainClient, 'createDocument').mockRejectedValue(new Error('Error'));
+            // Queue and fail 2 operations
+            await writeQueueManager.queueOperation('create_document', {
+                docType: 'workflow',
+                name: 'test1',
+                content: 'content',
+            });
+            await writeQueueManager.queueOperation('create_document', {
+                docType: 'rule',
+                name: 'test2',
+                content: 'content',
+            });
+            // Fail them
+            for (let i = 0; i < 3; i++) {
+                await writeQueueManager.syncPendingOperations();
+            }
+            let stats = await writeQueueManager.getQueueStats();
+            expect(stats.failed).toBe(2);
+            const cleared = await writeQueueManager.clearFailed();
+            expect(cleared).toBe(2);
+            stats = await writeQueueManager.getQueueStats();
+            expect(stats.failed).toBe(0);
+            expect(stats.total).toBe(0);
+        });
+    });
+    describe('delete operations', () => {
+        it('should sync delete_document operations', async () => {
+            await writeQueueManager.queueOperation('delete_document', {
+                docType: 'workflow',
+                name: 'test-workflow',
+                project: 'my-project',
+            });
+            const { synced } = await writeQueueManager.syncPendingOperations();
+            expect(synced).toBe(1);
+            expect(qwickbrainClient.deleteDocument).toHaveBeenCalledWith('workflow', 'test-workflow', 'my-project');
+        });
+        it('should sync delete_memory operations', async () => {
+            await writeQueueManager.queueOperation('delete_memory', {
+                name: 'test-memory',
+                project: 'my-project',
+            });
+            const { synced } = await writeQueueManager.syncPendingOperations();
+            expect(synced).toBe(1);
+            expect(qwickbrainClient.deleteMemory).toHaveBeenCalledWith('test-memory', 'my-project');
+        });
+    });
+});
+//# sourceMappingURL=write-queue-manager.test.js.map

package/dist/lib/__tests__/write-queue-manager.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-queue-manager.test.js","sourceRoot":"","sources":["../../../src/lib/__tests__/write-queue-manager.test.ts"],"names":[],"mappings":"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"}

package/dist/lib/cache-manager.d.ts

@@ -3,22 +3,51 @@ import type { Config } from '../types/config.js';
 interface CachedItem<T> {
     data: T;
     cachedAt: Date;
-    expiresAt: Date;
     age: number;
-    isExpired: boolean;
 }
 export declare class CacheManager {
     private db;
     private config;
+    private maxDynamicCacheSize;
     constructor(db: DB, config: Config['cache']);
-    private getTTL;
+    /**
+     * Get current size of dynamic tier cache (excludes critical tier)
+     */
+    private getDynamicCacheSize;
+    /**
+     * Evict LRU entries from dynamic tier to free up space
+     * NEVER touches critical tier
+     */
+    private evictLRU;
+    /**
+     * Ensure sufficient cache space
+     * Critical items bypass this check
+     */
+    private ensureCacheSize;
     getDocument(docType: string, name: string, project?: string): Promise<CachedItem<any> | null>;
     setDocument(docType: string, name: string, content: string, project?: string, metadata?: Record<string, unknown>): Promise<void>;
     getMemory(name: string, project?: string): Promise<CachedItem<any> | null>;
     setMemory(name: string, content: string, project?: string, metadata?: Record<string, unknown>): Promise<void>;
-    cleanupExpiredEntries(): Promise<{
-        documentsDeleted: number;
-        memoriesDeleted: number;
+    /**
+     * Invalidate a document from cache (for SSE-based cache invalidation)
+     */
+    invalidateDocument(docType: string, name: string, project?: string): Promise<void>;
+    /**
+     * Invalidate a memory from cache (for SSE-based cache invalidation)
+     */
+    invalidateMemory(name: string, project?: string): Promise<void>;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): Promise<{
+        criticalSize: number;
+        criticalCount: number;
+        dynamicSize: number;
+        dynamicCount: number;
+        totalSize: number;
+        totalCount: number;
+        memorySize: number;
+        memoryCount: number;
     }>;
 }
 export {};

package/dist/lib/cache-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache-manager.d.ts","sourceRoot":"","sources":["../../src/lib/cache-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAE1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,UAAU,UAAU,CAAC,CAAC;IACpB,IAAI,EAAE,CAAC,CAAC;IACR,QAAQ,EAAE,IAAI,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,YAAY;IAErB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,MAAM;gBADN,EAAE,EAAE,EAAE,EACN,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC;IAGjC,OAAO,CAAC,MAAM;IAUR,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAuC7F,WAAW,CACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC;IAiCV,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAqC1E,SAAS,CACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC;IA+BV,qBAAqB,IAAI,OAAO,CAAC;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC;CAoB9F"}
+{"version":3,"file":"cache-manager.d.ts","sourceRoot":"","sources":["../../src/lib/cache-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAE1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAKjD,UAAU,UAAU,CAAC,CAAC;IACpB,IAAI,EAAE,CAAC,CAAC;IACR,QAAQ,EAAE,IAAI,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qBAAa,YAAY;IAIrB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,MAAM;IAJhB,OAAO,CAAC,mBAAmB,CAAS;gBAG1B,EAAE,EAAE,EAAE,EACN,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC;IAMjC;;OAEG;YACW,mBAAmB;IASjC;;;OAGG;YACW,QAAQ;IAuCtB;;;OAGG;YACW,eAAe;IAkBvB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAwC7F,WAAW,CACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC;IAmCV,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAsC1E,SAAS,CACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC;IAgChB;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBxF;;OAEG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAerE;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC;QAC7B,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CA6CH"}

package/dist/lib/cache-manager.js

@@ -1,19 +1,82 @@
-import { eq, and, lte } from 'drizzle-orm';
+import { eq, and, sql } from 'drizzle-orm';
 import { documents, memories } from '../db/schema.js';
+// Critical document types - never evicted, not counted toward storage limit
+const CRITICAL_DOC_TYPES = ['workflow', 'rule', 'agent', 'template'];
 export class CacheManager {
     db;
     config;
+    maxDynamicCacheSize; // Storage limit for dynamic tier only (bytes)
     constructor(db, config) {
         this.db = db;
         this.config = config;
+        // Default to 100MB if not configured
+        this.maxDynamicCacheSize = config.maxCacheSizeBytes || 100 * 1024 * 1024;
     }
-    getTTL(operation) {
-        const ttlMap = {
-            get_workflow: this.config.ttl.workflows,
-            get_document: this.config.ttl.documents,
-            get_memory: this.config.ttl.memories,
-        };
-        return ttlMap[operation] || 0;
+    /**
+     * Get current size of dynamic tier cache (excludes critical tier)
+     */
+    async getDynamicCacheSize() {
+        const result = await this.db
+            .select({ total: sql `COALESCE(sum(${documents.sizeBytes}), 0) + COALESCE((SELECT sum(${memories.sizeBytes}) FROM ${memories}), 0)` })
+            .from(documents)
+            .where(eq(documents.isCritical, false));
+        return result[0]?.total || 0;
+    }
+    /**
+     * Evict LRU entries from dynamic tier to free up space
+     * NEVER touches critical tier
+     */
+    async evictLRU(bytesToFree) {
+        let freed = 0;
+        // Evict from documents (dynamic tier only)
+        const docCandidates = await this.db
+            .select()
+            .from(documents)
+            .where(eq(documents.isCritical, false))
+            .orderBy(documents.lastAccessedAt) // ASC = oldest first
+            .limit(100);
+        for (const doc of docCandidates) {
+            if (freed >= bytesToFree)
+                break;
+            await this.db.delete(documents).where(eq(documents.id, doc.id));
+            freed += doc.sizeBytes;
+            console.error(`LRU evicted document: ${doc.docType}:${doc.name} (${doc.sizeBytes} bytes)`);
+        }
+        // Evict from memories if needed
+        if (freed < bytesToFree) {
+            const memCandidates = await this.db
+                .select()
+                .from(memories)
+                .orderBy(memories.lastAccessedAt) // ASC = oldest first
+                .limit(100);
+            for (const mem of memCandidates) {
+                if (freed >= bytesToFree)
+                    break;
+                await this.db.delete(memories).where(eq(memories.id, mem.id));
+                freed += mem.sizeBytes;
+                console.error(`LRU evicted memory: ${mem.name} (${mem.sizeBytes} bytes)`);
+            }
+        }
+        console.error(`LRU eviction complete: freed ${freed} bytes`);
+    }
+    /**
+     * Ensure sufficient cache space
+     * Critical items bypass this check
+     */
+    async ensureCacheSize(requiredBytes, isCritical) {
+        // Critical files bypass storage limit check
+        if (isCritical) {
+            return;
+        }
+        // Only count dynamic tier toward storage limit
+        const currentSize = await this.getDynamicCacheSize();
+        if (currentSize + requiredBytes <= this.maxDynamicCacheSize) {
+            return;
+        }
+        // Evict LRU entries from dynamic tier only
+        const toEvict = currentSize + requiredBytes - this.maxDynamicCacheSize;
+        console.error(`Cache size limit reached: ${currentSize} + ${requiredBytes} > ${this.maxDynamicCacheSize}, evicting ${toEvict} bytes`);
+        await this.evictLRU(toEvict);
     }
     async getDocument(docType, name, project) {
         const projectValue = project || '';
@@ -25,10 +88,12 @@ export class CacheManager {
         if (!cached) {
             return null;
         }
+        // Update last accessed timestamp for LRU tracking
         const now = new Date();
+        await this.db.update(documents)
+            .set({ lastAccessedAt: now })
+            .where(eq(documents.id, cached.id));
         const age = Math.floor((now.getTime() - cached.cachedAt.getTime()) / 1000);
-        // Fix: Compare timestamp values explicitly to avoid Date comparison issues
-        const isExpired = now.getTime() > cached.expiresAt.getTime();
         return {
             data: {
                 name: cached.name,
@@ -38,18 +103,16 @@ export class CacheManager {
                 metadata: cached.metadata ? JSON.parse(cached.metadata) : {},
             },
             cachedAt: cached.cachedAt,
-            expiresAt: cached.expiresAt,
             age,
-            isExpired,
         };
     }
     async setDocument(docType, name, content, project, metadata) {
         const now = new Date();
-        const ttl = this.getTTL('get_document');
-        const expiresAt = new Date(now.getTime() + ttl * 1000);
-        // Use empty string instead of null for project to make unique constraint work
-        // SQLite treats NULL as distinct values in unique constraints
         const projectValue = project || '';
+        const isCritical = CRITICAL_DOC_TYPES.includes(docType);
+        const sizeBytes = Buffer.byteLength(content, 'utf8');
+        // Ensure space available (skips check if critical)
+        await this.ensureCacheSize(sizeBytes, isCritical);
         await this.db
             .insert(documents)
             .values({
@@ -59,7 +122,9 @@ export class CacheManager {
             content,
             metadata: metadata ? JSON.stringify(metadata) : null,
             cachedAt: now,
-            expiresAt,
+            lastAccessedAt: now,
+            isCritical,
+            sizeBytes,
             synced: true,
         })
             .onConflictDoUpdate({
@@ -67,8 +132,8 @@ export class CacheManager {
             set: {
                 content,
                 metadata: metadata ? JSON.stringify(metadata) : null,
-                cachedAt: now,
-                expiresAt,
+                lastAccessedAt: now,
+                sizeBytes,
                 synced: true,
             },
         });
@@ -83,10 +148,12 @@ export class CacheManager {
         if (!cached) {
             return null;
         }
+        // Update last accessed timestamp for LRU tracking
         const now = new Date();
+        await this.db.update(memories)
+            .set({ lastAccessedAt: now })
+            .where(eq(memories.id, cached.id));
         const age = Math.floor((now.getTime() - cached.cachedAt.getTime()) / 1000);
-        // Fix: Compare timestamp values explicitly to avoid Date comparison issues
-        const isExpired = now.getTime() > cached.expiresAt.getTime();
         return {
             data: {
                 name: cached.name,
@@ -95,17 +162,15 @@ export class CacheManager {
                 metadata: cached.metadata ? JSON.parse(cached.metadata) : {},
             },
             cachedAt: cached.cachedAt,
-            expiresAt: cached.expiresAt,
             age,
-            isExpired,
         };
     }
     async setMemory(name, content, project, metadata) {
         const now = new Date();
-        const ttl = this.getTTL('get_memory');
-        const expiresAt = new Date(now.getTime() + ttl * 1000);
-        // Use empty string instead of null for project to make unique constraint work
         const projectValue = project || '';
+        const sizeBytes = Buffer.byteLength(content, 'utf8');
+        // Memories are always dynamic tier (not critical)
+        await this.ensureCacheSize(sizeBytes, false);
         await this.db
             .insert(memories)
             .values({
@@ -114,7 +179,8 @@ export class CacheManager {
             content,
             metadata: metadata ? JSON.stringify(metadata) : null,
             cachedAt: now,
-            expiresAt,
+            lastAccessedAt: now,
+            sizeBytes,
             synced: true,
         })
             .onConflictDoUpdate({
@@ -122,27 +188,74 @@ export class CacheManager {
             set: {
                 content,
                 metadata: metadata ? JSON.stringify(metadata) : null,
-                cachedAt: now,
-                expiresAt,
+                lastAccessedAt: now,
+                sizeBytes,
                 synced: true,
             },
         });
     }
-    async cleanupExpiredEntries() {
-        const now = new Date();
-        // Delete expired documents (use lte to include items expiring exactly now)
-        const deletedDocs = await this.db
+    /**
+     * Invalidate a document from cache (for SSE-based cache invalidation)
+     */
+    async invalidateDocument(docType, name, project) {
+        const projectValue = project || '';
+        await this.db
             .delete(documents)
-            .where(lte(documents.expiresAt, now))
-            .returning({ id: documents.id });
-        // Delete expired memories (use lte to include items expiring exactly now)
-        const deletedMems = await this.db
+            .where(and(eq(documents.docType, docType), eq(documents.name, name), eq(documents.project, projectValue)));
+        console.error(`Cache invalidated: ${docType}:${name}`);
+    }
+    /**
+     * Invalidate a memory from cache (for SSE-based cache invalidation)
+     */
+    async invalidateMemory(name, project) {
+        const projectValue = project || '';
+        await this.db
             .delete(memories)
-            .where(lte(memories.expiresAt, now))
-            .returning({ id: memories.id });
+            .where(and(eq(memories.name, name), eq(memories.project, projectValue)));
+        console.error(`Cache invalidated: memory:${name}`);
+    }
+    /**
+     * Get cache statistics
+     */
+    async getCacheStats() {
+        // Critical documents
+        const criticalResult = await this.db
+            .select({
+            size: sql `COALESCE(sum(${documents.sizeBytes}), 0)`,
+            count: sql `count(*)`
+        })
+            .from(documents)
+            .where(eq(documents.isCritical, true));
+        // Dynamic documents
+        const dynamicResult = await this.db
+            .select({
+            size: sql `COALESCE(sum(${documents.sizeBytes}), 0)`,
+            count: sql `count(*)`
+        })
+            .from(documents)
+            .where(eq(documents.isCritical, false));
+        // Memories
+        const memoryResult = await this.db
+            .select({
+            size: sql `COALESCE(sum(${memories.sizeBytes}), 0)`,
+            count: sql `count(*)`
+        })
+            .from(memories);
+        const criticalSize = criticalResult[0]?.size || 0;
+        const criticalCount = criticalResult[0]?.count || 0;
+        const dynamicSize = dynamicResult[0]?.size || 0;
+        const dynamicCount = dynamicResult[0]?.count || 0;
+        const memorySize = memoryResult[0]?.size || 0;
+        const memoryCount = memoryResult[0]?.count || 0;
         return {
-            documentsDeleted: deletedDocs.length,
-            memoriesDeleted: deletedMems.length,
+            criticalSize,
+            criticalCount,
+            dynamicSize: dynamicSize + memorySize,
+            dynamicCount: dynamicCount + memoryCount,
+            totalSize: criticalSize + dynamicSize + memorySize,
+            totalCount: criticalCount + dynamicCount + memoryCount,
+            memorySize,
+            memoryCount,
         };
     }
 }