claude-memory-store 0.1.0

package/dist/atlas/indexes.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createIndexes = createIndexes;
+exports.createVectorSearchIndex = createVectorSearchIndex;
+const COLLECTION_NAME = 'claude_memory';
+async function createIndexes(db) {
+    const collection = db.collection(COLLECTION_NAME);
+    // Working memory: query by project, sorted by date
+    await collection.createIndex({ type: 1, project_id: 1, session_date: -1 }, { name: 'idx_working_memory' });
+    // Project metadata: query by project
+    await collection.createIndex({ type: 1, project_id: 1 }, { name: 'idx_project_memory' });
+    // Developer metadata: query by developer
+    await collection.createIndex({ type: 1, developer_id: 1 }, { name: 'idx_developer_memory' });
+    // Dedup for project-scoped items (architecture, pattern, avoid)
+    await collection.createIndex({ type: 1, project_id: 1, content: 1 }, {
+        name: 'idx_project_item_dedup',
+        unique: true,
+        partialFilterExpression: {
+            type: { $in: ['architecture', 'pattern', 'avoid'] },
+            content: { $exists: true },
+        },
+    });
+    // Dedup for developer-scoped items (preference, style, dev_default, dev_avoid)
+    await collection.createIndex({ type: 1, developer_id: 1, content: 1 }, {
+        name: 'idx_developer_item_dedup',
+        unique: true,
+        partialFilterExpression: {
+            type: { $in: ['preference', 'style', 'dev_default', 'dev_avoid'] },
+            content: { $exists: true },
+        },
+    });
+    // last_accessed index for TTL cleanup queries
+    await collection.createIndex({ last_accessed: 1 }, { name: 'idx_last_accessed' });
+    // Thread queries by project + status
+    await collection.createIndex({ type: 1, project_id: 1, status: 1 }, {
+        name: 'idx_threads',
+        partialFilterExpression: { type: 'thread' },
+    });
+    // Command queries by project + trigger
+    await collection.createIndex({ type: 1, project_id: 1, trigger: 1 }, {
+        name: 'idx_commands',
+        partialFilterExpression: { type: 'command' },
+    });
+}
+async function createVectorSearchIndex(db) {
+    const collection = db.collection(COLLECTION_NAME);
+    try {
+        // Standard vector index on the `embedding` field.
+        // Embeddings are generated locally via all-MiniLM-L6-v2 (384 dimensions)
+        // before document insertion. No external API keys needed.
+        await collection.createSearchIndex({
+            name: 'memory_semantic',
+            type: 'vectorSearch',
+            definition: {
+                fields: [
+                    {
+                        type: 'vector',
+                        path: 'embedding',
+                        numDimensions: 384,
+                        similarity: 'cosine',
+                    },
+                    {
+                        type: 'filter',
+                        path: 'project_id',
+                    },
+                ],
+            },
+        });
+    }
+    catch (err) {
+        // Index may already exist — that's fine
+        if (err?.codeName !== 'IndexAlreadyExists' && !err?.message?.includes('already exists')) {
+            // Log but don't fail — vector search requires Atlas M10+
+            console.log('Note: Vector search index creation skipped (requires Atlas M10+).');
+        }
+    }
+}
+//# sourceMappingURL=indexes.js.map

package/dist/atlas/indexes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexes.js","sourceRoot":"","sources":["../../src/atlas/indexes.ts"],"names":[],"mappings":";;AAIA,sCAsEC;AAED,0DAgCC;AA1GD,MAAM,eAAe,GAAG,eAAe,CAAC;AAEjC,KAAK,UAAU,aAAa,CAAC,EAAM;IACxC,MAAM,UAAU,GAAG,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;IAElD,mDAAmD;IACnD,MAAM,UAAU,CAAC,WAAW,CAC1B,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,EAAE,EAC5C,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAC/B,CAAC;IAEF,qCAAqC;IACrC,MAAM,UAAU,CAAC,WAAW,CAC1B,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,EAC1B,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAC/B,CAAC;IAEF,yCAAyC;IACzC,MAAM,UAAU,CAAC,WAAW,CAC1B,EAAE,IAAI,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,EAC5B,EAAE,IAAI,EAAE,sBAAsB,EAAE,CACjC,CAAC;IAEF,gEAAgE;IAChE,MAAM,UAAU,CAAC,WAAW,CAC1B,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,EACtC;QACE,IAAI,EAAE,wBAAwB;QAC9B,MAAM,EAAE,IAAI;QACZ,uBAAuB,EAAE;YACvB,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,cAAc,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE;YACnD,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;SAC3B;KACF,CACF,CAAC;IAEF,+EAA+E;IAC/E,MAAM,UAAU,CAAC,WAAW,CAC1B,EAAE,IAAI,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,EACxC;QACE,IAAI,EAAE,0BAA0B;QAChC,MAAM,EAAE,IAAI;QACZ,uBAAuB,EAAE;YACvB,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,CAAC,EAAE;YAClE,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;SAC3B;KACF,CACF,CAAC;IAEF,8CAA8C;IAC9C,MAAM,UAAU,CAAC,WAAW,CAC1B,EAAE,aAAa,EAAE,CAAC,EAAE,EACpB,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAC9B,CAAC;IAEF,qCAAqC;IACrC,MAAM,UAAU,CAAC,WAAW,CAC1B,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EACrC;QACE,IAAI,EAAE,aAAa;QACnB,uBAAuB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC5C,CACF,CAAC;IAEF,uCAAuC;IACvC,MAAM,UAAU,CAAC,WAAW,CAC1B,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,EACtC;QACE,IAAI,EAAE,cAAc;QACpB,uBAAuB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;KAC7C,CACF,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,uBAAuB,CAAC,EAAM;IAClD,MAAM,UAAU,GAAG,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;IAElD,IAAI,CAAC;QACH,kDAAkD;QAClD,yEAAyE;QACzE,0DAA0D;QAC1D,MAAM,UAAU,CAAC,iBAAiB,CAAC;YACjC,IAAI,EAAE,iBAAiB;YACvB,IAAI,EAAE,cAAc;YACpB,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN;wBACE,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,WAAW;wBACjB,aAAa,EAAE,GAAG;wBAClB,UAAU,EAAE,QAAQ;qBACrB;oBACD;wBACE,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,YAAY;qBACnB;iBACF;aACF;SACF,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,wCAAwC;QACxC,IAAI,GAAG,EAAE,QAAQ,KAAK,oBAAoB,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACxF,yDAAyD;YACzD,OAAO,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/atlas/vector.d.ts

@@ -0,0 +1,17 @@
+import type { MemoryDocument } from '../types.js';
+export interface VectorSearchResult {
+    type: string;
+    content: string;
+    score: number;
+    document: MemoryDocument;
+}
+/**
+ * Semantic vector search — the only search method.
+ *
+ * Generates an embedding for the query locally (all-MiniLM-L6-v2, 384 dims),
+ * then runs $vectorSearch against Atlas. Requires M10+ with vector index.
+ *
+ * Returns results scored by cosine similarity (>= 0.5 threshold).
+ */
+export declare function search(query: string, projectId: string, limit?: number): Promise<VectorSearchResult[]>;
+//# sourceMappingURL=vector.d.ts.map

package/dist/atlas/vector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector.d.ts","sourceRoot":"","sources":["../../src/atlas/vector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAiBD;;;;;;;GAOG;AACH,wBAAsB,MAAM,CAC1B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,MAAU,GAChB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAsC/B"}

package/dist/atlas/vector.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.search = search;
+const client_js_1 = require("./client.js");
+const embeddings_js_1 = require("./embeddings.js");
+/**
+ * Touch last_accessed on returned documents to renew TTL.
+ * Fire-and-forget — don't block search results.
+ */
+async function touchLastAccessed(docIds) {
+    if (docIds.length === 0)
+        return;
+    const collection = await (0, client_js_1.getCollection)();
+    collection
+        .updateMany({ _id: { $in: docIds } }, { $set: { last_accessed: new Date() } })
+        .catch(() => { }); // Fire and forget
+}
+/**
+ * Semantic vector search — the only search method.
+ *
+ * Generates an embedding for the query locally (all-MiniLM-L6-v2, 384 dims),
+ * then runs $vectorSearch against Atlas. Requires M10+ with vector index.
+ *
+ * Returns results scored by cosine similarity (>= 0.5 threshold).
+ */
+async function search(query, projectId, limit = 5) {
+    const collection = await (0, client_js_1.getCollection)();
+    const queryEmbedding = await (0, embeddings_js_1.generateEmbedding)(query);
+    const results = await collection
+        .aggregate([
+        {
+            $vectorSearch: {
+                index: 'memory_semantic',
+                path: 'embedding',
+                queryVector: queryEmbedding,
+                numCandidates: 20,
+                limit,
+                filter: { project_id: projectId },
+            },
+        },
+        {
+            $addFields: {
+                score: { $meta: 'vectorSearchScore' },
+            },
+        },
+        {
+            $match: { score: { $gte: 0.5 } },
+        },
+    ])
+        .toArray();
+    // Renew TTL on accessed documents
+    const ids = results.map((r) => r._id).filter(Boolean);
+    touchLastAccessed(ids);
+    return results.map((doc) => ({
+        type: doc.type,
+        content: doc.searchable_text || doc.content || '',
+        score: doc.score,
+        document: doc,
+    }));
+}
+//# sourceMappingURL=vector.js.map

package/dist/atlas/vector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector.js","sourceRoot":"","sources":["../../src/atlas/vector.ts"],"names":[],"mappings":";;AAkCA,wBA0CC;AA5ED,2CAA4C;AAC5C,mDAAoD;AAUpD;;;GAGG;AACH,KAAK,UAAU,iBAAiB,CAAC,MAAa;IAC5C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAChC,MAAM,UAAU,GAAG,MAAM,IAAA,yBAAa,GAAE,CAAC;IACzC,UAAU;SACP,UAAU,CACT,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EACxB,EAAE,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,IAAI,EAAE,EAAE,EAAE,CACxC;SACA,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,kBAAkB;AACxC,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,MAAM,CAC1B,KAAa,EACb,SAAiB,EACjB,QAAgB,CAAC;IAEjB,MAAM,UAAU,GAAG,MAAM,IAAA,yBAAa,GAAE,CAAC;IAEzC,MAAM,cAAc,GAAG,MAAM,IAAA,iCAAiB,EAAC,KAAK,CAAC,CAAC;IAEtD,MAAM,OAAO,GAAG,MAAM,UAAU;SAC7B,SAAS,CAAC;QACT;YACE,aAAa,EAAE;gBACb,KAAK,EAAE,iBAAiB;gBACxB,IAAI,EAAE,WAAW;gBACjB,WAAW,EAAE,cAAc;gBAC3B,aAAa,EAAE,EAAE;gBACjB,KAAK;gBACL,MAAM,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE;aAClC;SACF;QACD;YACE,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE;aACtC;SACF;QACD;YACE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;SACjC;KACF,CAAC;SACD,OAAO,EAAE,CAAC;IAEb,kCAAkC;IAClC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACtD,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAEvB,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC3B,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE;QACjD,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,QAAQ,EAAE,GAAgC;KAC3C,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/bin/claude-memory.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=claude-memory.d.ts.map

package/dist/bin/claude-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-memory.d.ts","sourceRoot":"","sources":["../../src/bin/claude-memory.ts"],"names":[],"mappings":""}