claude-cortex 1.5.2 → 1.6.0

package/README.md

@@ -279,7 +279,17 @@ npm run watch
 
 The dashboard provides a 3D brain visualization of your memories with real-time updates.
 
-### Running the Dashboard
+### Auto-Start on Login (Recommended)
+
+```bash
+npx claude-cortex service install    # Enable auto-start
+npx claude-cortex service uninstall  # Remove auto-start
+npx claude-cortex service status     # Check status
+```
+
+Works on **macOS** (launchd), **Linux** (systemd), and **Windows** (Startup folder). The dashboard and API server will start automatically on login.
+
+### Manual Start
 
 ```bash
 # Terminal 1: Start API server

package/dist/__tests__/consolidation-merge.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Consolidation Merge Tests
+ *
+ * Tests the similarity-based clustering logic used by mergeSimilarMemories.
+ * Since the full function requires database access, we test the clustering
+ * algorithm components and similarity thresholds.
+ */
+export {};
+//# sourceMappingURL=consolidation-merge.test.d.ts.map

package/dist/__tests__/consolidation-merge.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidation-merge.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/consolidation-merge.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/__tests__/consolidation-merge.test.js

@@ -0,0 +1,137 @@
+/**
+ * Consolidation Merge Tests
+ *
+ * Tests the similarity-based clustering logic used by mergeSimilarMemories.
+ * Since the full function requires database access, we test the clustering
+ * algorithm components and similarity thresholds.
+ */
+import { describe, it, expect } from '@jest/globals';
+import { jaccardSimilarity } from '../memory/similarity.js';
+describe('mergeSimilarMemories clustering logic', () => {
+    // Simulate the clustering algorithm from mergeSimilarMemories
+    function findClusters(memories, threshold = 0.25) {
+        const clustered = new Set();
+        const clusters = [];
+        for (let i = 0; i < memories.length; i++) {
+            if (clustered.has(i))
+                continue;
+            const cluster = [i];
+            const memA = memories[i];
+            for (let j = i + 1; j < memories.length; j++) {
+                if (clustered.has(j))
+                    continue;
+                const memB = memories[j];
+                const contentSim = jaccardSimilarity(memA.content, memB.content);
+                const titleSim = jaccardSimilarity(memA.title, memB.title);
+                const combinedSim = contentSim * 0.6 + titleSim * 0.4;
+                if (combinedSim >= threshold) {
+                    cluster.push(j);
+                }
+            }
+            if (cluster.length >= 2) {
+                for (const idx of cluster)
+                    clustered.add(idx);
+                clusters.push(cluster);
+            }
+        }
+        return clusters;
+    }
+    it('should cluster related JWT memories together', () => {
+        const memories = [
+            {
+                title: 'JWT authentication token setup',
+                content: 'Set up JWT authentication token signing using RS256 algorithm in the auth service for user authentication and token validation',
+                salience: 0.6,
+            },
+            {
+                title: 'JWT authentication token expiry',
+                content: 'JWT authentication tokens expire after 24 hours with refresh token rotation for the auth service user authentication flow',
+                salience: 0.5,
+            },
+            {
+                title: 'JWT authentication token middleware',
+                content: 'Created JWT authentication token middleware that validates user tokens on every auth service API request and handles token refresh',
+                salience: 0.4,
+            },
+        ];
+        const clusters = findClusters(memories, 0.25);
+        // All 3 should be in one cluster (they share JWT/token/auth vocabulary)
+        expect(clusters.length).toBeGreaterThanOrEqual(1);
+        const biggestCluster = clusters.reduce((a, b) => (a.length > b.length ? a : b), []);
+        expect(biggestCluster.length).toBeGreaterThanOrEqual(2);
+    });
+    it('should pick highest salience memory as base', () => {
+        const memories = [
+            { title: 'JWT authentication setup', content: 'JWT authentication token signing RS256 in auth service', salience: 0.6 },
+            { title: 'JWT authentication expiry', content: 'JWT authentication token expiry 24 hours auth service', salience: 0.5 },
+            { title: 'JWT authentication middleware', content: 'JWT authentication token middleware validates auth service', salience: 0.4 },
+        ];
+        const clusters = findClusters(memories, 0.25);
+        expect(clusters.length).toBeGreaterThanOrEqual(1);
+        // Sort cluster by salience desc - index 0 (salience 0.6) should be first
+        const cluster = clusters[0];
+        const sorted = [...cluster].sort((a, b) => memories[b].salience - memories[a].salience);
+        expect(sorted[0]).toBe(0); // Highest salience is index 0
+    });
+    it('should not cluster unrelated memories', () => {
+        const memories = [
+            {
+                title: 'JWT Setup',
+                content: 'Set up JWT authentication using RS256 algorithm',
+                salience: 0.5,
+            },
+            {
+                title: 'Database Migration',
+                content: 'Migrated PostgreSQL schema to add user preferences table with JSONB columns',
+                salience: 0.5,
+            },
+        ];
+        const clusters = findClusters(memories, 0.25);
+        // These should NOT cluster - completely different topics
+        expect(clusters.length).toBe(0);
+    });
+    it('should produce correct merged content format', () => {
+        // Simulate what mergeSimilarMemories does after clustering
+        const base = {
+            title: 'JWT Setup',
+            content: 'Set up JWT authentication using RS256 algorithm for token signing in the auth service',
+        };
+        const others = [
+            {
+                title: 'JWT Token Expiry',
+                content: 'JWT tokens expire after 24 hours, refresh tokens last 30 days for the auth system',
+            },
+            {
+                title: 'JWT Middleware',
+                content: 'Created JWT middleware that validates tokens on every API request and attaches user context',
+            },
+        ];
+        const bulletPoints = others
+            .map(m => `- ${m.title}: ${m.content}`)
+            .join('\n');
+        const mergedContent = `${base.content}\n\nConsolidated context:\n${bulletPoints}`;
+        expect(mergedContent).toContain('RS256');
+        expect(mergedContent).toContain('24 hours');
+        expect(mergedContent).toContain('middleware');
+        expect(mergedContent).toContain('Consolidated context:');
+    });
+    it('should merge tags as a union', () => {
+        const tagSets = [
+            ['jwt', 'auth'],
+            ['jwt', 'expiry'],
+            ['jwt', 'middleware'],
+        ];
+        const allTags = new Set();
+        for (const tags of tagSets) {
+            for (const t of tags)
+                allTags.add(t);
+        }
+        expect([...allTags].sort()).toEqual(['auth', 'expiry', 'jwt', 'middleware']);
+    });
+    it('should cap salience at 1.0 after boost', () => {
+        const baseSalience = 0.95;
+        const newSalience = Math.min(1.0, baseSalience + 0.1);
+        expect(newSalience).toBe(1.0);
+    });
+});
+//# sourceMappingURL=consolidation-merge.test.js.map

package/dist/__tests__/consolidation-merge.test.js.map

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

package/dist/__tests__/contradictions.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Contradiction Surfacing Tests
+ *
+ * Tests that contradictions are properly included in search results
+ * and displayed in recall output.
+ */
+export {};
+//# sourceMappingURL=contradictions.test.d.ts.map

package/dist/__tests__/contradictions.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contradictions.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/contradictions.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/__tests__/contradictions.test.js

@@ -0,0 +1,78 @@
+/**
+ * Contradiction Surfacing Tests
+ *
+ * Tests that contradictions are properly included in search results
+ * and displayed in recall output.
+ */
+import { describe, it, expect } from '@jest/globals';
+import { formatRecallResult } from '../tools/recall.js';
+function makeMemory(overrides = {}) {
+    return {
+        id: 1,
+        type: 'long_term',
+        category: 'architecture',
+        title: 'Use PostgreSQL',
+        content: 'Decided to use PostgreSQL for the database',
+        project: 'test',
+        tags: [],
+        salience: 0.8,
+        accessCount: 1,
+        lastAccessed: new Date(),
+        createdAt: new Date(),
+        decayedScore: 0.7,
+        metadata: {},
+        scope: 'project',
+        transferable: false,
+        ...overrides,
+    };
+}
+describe('SearchResult contradictions field', () => {
+    it('should allow contradictions on SearchResult', () => {
+        const result = {
+            memory: makeMemory(),
+            relevanceScore: 0.9,
+            contradictions: [
+                { memoryId: 2, title: 'Use SQLite', score: 0.8 },
+            ],
+        };
+        expect(result.contradictions).toBeDefined();
+        expect(result.contradictions).toHaveLength(1);
+        expect(result.contradictions[0].memoryId).toBe(2);
+        expect(result.contradictions[0].title).toBe('Use SQLite');
+        expect(result.contradictions[0].score).toBe(0.8);
+    });
+    it('should allow SearchResult without contradictions', () => {
+        const result = {
+            memory: makeMemory(),
+            relevanceScore: 0.9,
+        };
+        expect(result.contradictions).toBeUndefined();
+    });
+});
+describe('formatRecallResult with contradictions', () => {
+    it('should show contradiction warnings in formatted output', () => {
+        const mem1 = makeMemory({ id: 1, title: 'Use PostgreSQL' });
+        const mem2 = makeMemory({ id: 2, title: 'Use SQLite' });
+        const contradictions = new Map();
+        contradictions.set(1, [{ memoryId: 2, title: 'Use SQLite', score: 0.8 }]);
+        const output = formatRecallResult({
+            success: true,
+            memories: [mem1, mem2],
+            contradictions,
+            count: 2,
+        });
+        expect(output).toContain('CONTRADICTS');
+        expect(output).toContain('"Use SQLite"');
+        expect(output).toContain('ID 2');
+    });
+    it('should not show contradiction warning for memories without contradictions', () => {
+        const mem = makeMemory({ id: 3, title: 'Some memory' });
+        const output = formatRecallResult({
+            success: true,
+            memories: [mem],
+            count: 1,
+        });
+        expect(output).not.toContain('CONTRADICTS');
+    });
+});
+//# sourceMappingURL=contradictions.test.js.map

package/dist/__tests__/contradictions.test.js.map

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

package/dist/__tests__/salience-evolution.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Salience Evolution Tests
+ *
+ * Tests that salience evolves over time based on structural importance.
+ */
+export {};
+//# sourceMappingURL=salience-evolution.test.d.ts.map

package/dist/__tests__/salience-evolution.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"salience-evolution.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/salience-evolution.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/__tests__/salience-evolution.test.js

@@ -0,0 +1,151 @@
+/**
+ * Salience Evolution Tests
+ *
+ * Tests that salience evolves over time based on structural importance.
+ */
+import { describe, it, expect, beforeAll, afterAll } from '@jest/globals';
+import Database from 'better-sqlite3';
+import path from 'path';
+import fs from 'fs';
+import os from 'os';
+describe('Salience Evolution', () => {
+    let db;
+    let dbPath;
+    beforeAll(() => {
+        // Create a temp database for testing
+        dbPath = path.join(os.tmpdir(), `claude-cortex-test-${Date.now()}.db`);
+        db = new Database(dbPath);
+        // Create minimal schema
+        db.exec(`
+      CREATE TABLE IF NOT EXISTS memories (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        type TEXT NOT NULL DEFAULT 'short_term',
+        category TEXT NOT NULL DEFAULT 'note',
+        title TEXT NOT NULL,
+        content TEXT NOT NULL,
+        project TEXT,
+        tags TEXT DEFAULT '[]',
+        salience REAL DEFAULT 0.5,
+        decayed_score REAL DEFAULT 0.5,
+        access_count INTEGER DEFAULT 0,
+        metadata TEXT DEFAULT '{}',
+        created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+        last_accessed DATETIME DEFAULT CURRENT_TIMESTAMP
+      );
+
+      CREATE TABLE IF NOT EXISTS memory_links (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        source_id INTEGER NOT NULL,
+        target_id INTEGER NOT NULL,
+        relationship TEXT NOT NULL DEFAULT 'related',
+        strength REAL DEFAULT 0.5,
+        created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+        FOREIGN KEY (source_id) REFERENCES memories(id) ON DELETE CASCADE,
+        FOREIGN KEY (target_id) REFERENCES memories(id) ON DELETE CASCADE,
+        UNIQUE(source_id, target_id, relationship)
+      );
+    `);
+    });
+    afterAll(() => {
+        db.close();
+        try {
+            fs.unlinkSync(dbPath);
+        }
+        catch { }
+    });
+    it('should boost salience of hub memories with many links', () => {
+        // Create a hub memory
+        const hubResult = db.prepare(`
+      INSERT INTO memories (type, category, title, content, salience)
+      VALUES ('long_term', 'architecture', 'Hub Memory', 'Central architecture decision', 0.5)
+    `).run();
+        const hubId = hubResult.lastInsertRowid;
+        // Create 5 linked memories
+        const linkedIds = [];
+        for (let i = 0; i < 5; i++) {
+            const r = db.prepare(`
+        INSERT INTO memories (type, category, title, content, salience)
+        VALUES ('long_term', 'note', 'Linked ${i}', 'Related content ${i}', 0.4)
+      `).run();
+            linkedIds.push(r.lastInsertRowid);
+            db.prepare(`
+        INSERT INTO memory_links (source_id, target_id, relationship, strength)
+        VALUES (?, ?, 'related', 0.5)
+      `).run(linkedIds[i], hubId);
+        }
+        const originalSalience = db.prepare('SELECT salience FROM memories WHERE id = ?').get(hubId).salience;
+        // Run evolveSalience logic inline (same as the function)
+        const hubs = db.prepare(`
+      SELECT m.id, m.salience,
+        (SELECT COUNT(*) FROM memory_links WHERE source_id = m.id OR target_id = m.id) as link_count
+      FROM memories m
+      WHERE m.type IN ('long_term', 'episodic')
+    `).all();
+        for (const hub of hubs) {
+            if (hub.link_count < 2)
+                continue;
+            const linkBonus = Math.min(0.1, Math.log2(hub.link_count) * 0.03);
+            const newSalience = Math.min(1.0, hub.salience + linkBonus);
+            if (newSalience > hub.salience) {
+                db.prepare('UPDATE memories SET salience = ? WHERE id = ?').run(newSalience, hub.id);
+            }
+        }
+        const newSalience = db.prepare('SELECT salience FROM memories WHERE id = ?').get(hubId).salience;
+        expect(newSalience).toBeGreaterThan(originalSalience);
+    });
+    it('should penalize contradicted memories', () => {
+        // Create two contradicting memories
+        const m1 = db.prepare(`
+      INSERT INTO memories (type, category, title, content, salience)
+      VALUES ('long_term', 'architecture', 'Use REST', 'We should use REST APIs', 0.6)
+    `).run();
+        const m2 = db.prepare(`
+      INSERT INTO memories (type, category, title, content, salience)
+      VALUES ('long_term', 'architecture', 'Use GraphQL', 'We should use GraphQL', 0.6)
+    `).run();
+        db.prepare(`
+      INSERT INTO memory_links (source_id, target_id, relationship, strength)
+      VALUES (?, ?, 'contradicts', 0.8)
+    `).run(m1.lastInsertRowid, m2.lastInsertRowid);
+        // Run contradiction penalty logic
+        const contradicted = db.prepare(`
+      SELECT DISTINCT source_id, target_id
+      FROM memory_links
+      WHERE relationship = 'contradicts'
+    `).all();
+        for (const pair of contradicted) {
+            for (const id of [pair.source_id, pair.target_id]) {
+                const mem = db.prepare('SELECT salience FROM memories WHERE id = ?').get(id);
+                if (mem && mem.salience > 0.3) {
+                    db.prepare('UPDATE memories SET salience = ? WHERE id = ?')
+                        .run(mem.salience - 0.02, id);
+                }
+            }
+        }
+        const s1 = db.prepare('SELECT salience FROM memories WHERE id = ?').get(m1.lastInsertRowid).salience;
+        const s2 = db.prepare('SELECT salience FROM memories WHERE id = ?').get(m2.lastInsertRowid).salience;
+        expect(s1).toBeCloseTo(0.58, 2);
+        expect(s2).toBeCloseTo(0.58, 2);
+    });
+});
+describe('Mention Count', () => {
+    it('should count keyword mentions in text', async () => {
+        const { analyzeSalienceFactors } = await import('../memory/salience.js');
+        // Text with multiple keyword matches
+        const factors = analyzeSalienceFactors({
+            title: 'Architecture fix',
+            content: 'Fixed a bug in the database schema pattern using a workaround strategy',
+        });
+        // Should match multiple keywords across categories
+        expect(factors.mentionCount).toBeGreaterThan(1);
+    });
+    it('should return at least 1 for text with no keywords', async () => {
+        const { analyzeSalienceFactors } = await import('../memory/salience.js');
+        const factors = analyzeSalienceFactors({
+            title: 'Hello',
+            content: 'Just a simple note',
+        });
+        expect(factors.mentionCount).toBeGreaterThanOrEqual(1);
+    });
+});
+//# sourceMappingURL=salience-evolution.test.js.map

package/dist/__tests__/salience-evolution.test.js.map

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