@vheins/local-memory-mcp 0.1.0

package/dist/test_quotes_client.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+import { MCPClient } from "./mcp/client.js";
+// Array of random quotes
+const QUOTES = [
+    "The only way to do great work is to love what you do. - Steve Jobs",
+    "In the middle of difficulty lies opportunity. - Albert Einstein",
+    "Believe you can and you're halfway there. - Theodore Roosevelt",
+    "The future belongs to those who believe in the beauty of their dreams. - Eleanor Roosevelt",
+    "You miss 100% of the shots you don't take. - Wayne Gretzky",
+    "The best way to predict the future is to create it. - Peter Drucker",
+    "Life is what happens to you while you're busy making other plans. - John Lennon",
+    "The only impossible journey is the one you never begin. - Tony Robbins",
+    "Innovation distinguishes between a leader and a follower. - Steve Jobs",
+    "The mind is everything. What you think you become. - Buddha"
+];
+// Function to generate random importance (1-5)
+function randomImportance() {
+    return Math.floor(Math.random() * 5) + 1;
+}
+async function testRandomQuotes() {
+    const client = new MCPClient();
+    try {
+        console.log("Starting MCP client...");
+        await client.start();
+        console.log("MCP client connected!");
+        console.log("\nStoring random quotes...");
+        // Store quotes
+        for (let i = 0; i < QUOTES.length; i++) {
+            const importance = randomImportance();
+            const quote = QUOTES[i];
+            try {
+                const result = await client.callTool("memory-store", {
+                    type: "code_fact",
+                    content: quote,
+                    importance: importance,
+                    scope: { repo: "quotes-test" }
+                });
+                console.log(`✓ Stored quote ${i + 1}: ${quote.substring(0, 50)}... (importance: ${importance})`);
+                console.log(`  ID: ${result.id}`);
+            }
+            catch (error) {
+                console.error(`✗ Failed to store quote ${i + 1}:`, error);
+            }
+        }
+        console.log("\nSearching for stored quotes...");
+        // Search for quotes
+        try {
+            const searchResult = await client.callTool("memory-search", {
+                query: "quotes",
+                repo: "quotes-test",
+                limit: 10
+            });
+            console.log(`Found ${searchResult.results.length} quotes:`);
+            searchResult.results.forEach((memory, index) => {
+                console.log(`${index + 1}. [${memory.importance}] ${memory.content}`);
+            });
+        }
+        catch (error) {
+            console.error("✗ Failed to search quotes:", error);
+        }
+        console.log("\nTest completed successfully! 🎉");
+    }
+    catch (error) {
+        console.error("Test failed:", error);
+    }
+    finally {
+        client.stop();
+    }
+}
+// Run the test
+testRandomQuotes();
+//# sourceMappingURL=test_quotes_client.js.map

package/dist/test_quotes_client.js.map

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

package/dist/tools/memory.delete.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+import { SQLiteStore } from "../storage/sqlite.js";
+import { VectorStore } from "../types.js";
+import { McpResponse } from "../utils/mcp-response.js";
+export declare const MemoryDeleteSchema: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+export declare function handleMemoryDelete(params: any, db: SQLiteStore, vectors: VectorStore): Promise<McpResponse>;
+//# sourceMappingURL=memory.delete.d.ts.map

package/dist/tools/memory.delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.delete.d.ts","sourceRoot":"","sources":["../../src/tools/memory.delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAqB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE1E,eAAO,MAAM,kBAAkB;;iBAE7B,CAAC;AAEH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,GAAG,EACX,EAAE,EAAE,WAAW,EACf,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,CAAC,CAuBtB"}

package/dist/tools/memory.delete.js

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import { createMcpResponse } from "../utils/mcp-response.js";
+export const MemoryDeleteSchema = z.object({
+    id: z.string().uuid()
+});
+export async function handleMemoryDelete(params, db, vectors) {
+    // Validate input
+    const validated = MemoryDeleteSchema.parse(params);
+    // Check if memory exists
+    const existing = db.getById(validated.id);
+    if (!existing) {
+        throw new Error(`Memory not found: ${validated.id}`);
+    }
+    // Delete from SQLite
+    db.delete(validated.id);
+    // Delete from vector store
+    await vectors.remove(validated.id);
+    // Log the delete action
+    db.logAction('delete', existing.scope.repo, { memoryId: validated.id, resultCount: 1 });
+    return createMcpResponse({ success: true }, `Deleted memory ${validated.id.slice(0, 8)}...`);
+}
+//# sourceMappingURL=memory.delete.js.map

package/dist/tools/memory.delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.delete.js","sourceRoot":"","sources":["../../src/tools/memory.delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,iBAAiB,EAAe,MAAM,0BAA0B,CAAC;AAE1E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAW,EACX,EAAe,EACf,OAAoB;IAEpB,iBAAiB;IACjB,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAEnD,yBAAyB;IACzB,MAAM,QAAQ,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,qBAAqB,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,qBAAqB;IACrB,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAExB,2BAA2B;IAC3B,MAAM,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAEnC,wBAAwB;IACxB,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC;IAExF,OAAO,iBAAiB,CACtB,EAAE,OAAO,EAAE,IAAI,EAAE,EACjB,kBAAkB,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAChD,CAAC;AACJ,CAAC"}

package/dist/tools/memory.recap.d.ts

@@ -0,0 +1,4 @@
+import { SQLiteStore } from "../storage/sqlite.js";
+import { McpResponse } from "../utils/mcp-response.js";
+export declare function handleMemoryRecap(params: any, db: SQLiteStore): Promise<McpResponse>;
+//# sourceMappingURL=memory.recap.d.ts.map

package/dist/tools/memory.recap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.recap.d.ts","sourceRoot":"","sources":["../../src/tools/memory.recap.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAqB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE1E,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,GAAG,EACX,EAAE,EAAE,WAAW,GACd,OAAO,CAAC,WAAW,CAAC,CAqDtB"}

package/dist/tools/memory.recap.js

@@ -0,0 +1,42 @@
+import { MemoryRecapSchema } from "./schemas.js";
+import { createMcpResponse } from "../utils/mcp-response.js";
+export async function handleMemoryRecap(params, db) {
+    // Validate input
+    const validated = MemoryRecapSchema.parse(params);
+    // Get total count for pagination metadata
+    const total = db.getTotalCount(validated.repo);
+    // Get recent memories using public API (no type-unsafe cast)
+    const rows = db.getRecentMemories(validated.repo, validated.limit, validated.offset);
+    if (rows.length === 0) {
+        return createMcpResponse({
+            repo: validated.repo,
+            count: 0,
+            total,
+            offset: validated.offset,
+            memories: [],
+            message: `No memories found for repo: ${validated.repo}`
+        }, `No memories for repo "${validated.repo}"`);
+    }
+    // Format memories for recap
+    const formattedMemories = rows.map((row, index) => ({
+        number: validated.offset + index + 1,
+        id: row.id,
+        type: row.type,
+        importance: row.importance,
+        preview: row.content.substring(0, 100) + (row.content.length > 100 ? "..." : ""),
+        created_at: row.created_at
+    }));
+    // Create summary text
+    const summary = formattedMemories
+        .map((m) => `${m.number}. [${m.type.toUpperCase()}] (importance: ${m.importance}) ${m.preview}`)
+        .join("\n");
+    return createMcpResponse({
+        repo: validated.repo,
+        count: rows.length,
+        total,
+        offset: validated.offset,
+        memories: formattedMemories,
+        summary: `Recent ${rows.length} memories:\n\n${summary}`
+    }, `Retrieved ${rows.length} memories for repo "${validated.repo}"`);
+}
+//# sourceMappingURL=memory.recap.js.map

package/dist/tools/memory.recap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.recap.js","sourceRoot":"","sources":["../../src/tools/memory.recap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAe,MAAM,0BAA0B,CAAC;AAE1E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAW,EACX,EAAe;IAEf,iBAAiB;IACjB,MAAM,SAAS,GAAG,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAElD,0CAA0C;IAC1C,MAAM,KAAK,GAAG,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAE/C,6DAA6D;IAC7D,MAAM,IAAI,GAAG,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAErF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,iBAAiB,CACtB;YACE,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,KAAK,EAAE,CAAC;YACR,KAAK;YACL,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,QAAQ,EAAE,EAAE;YACZ,OAAO,EAAE,+BAA+B,SAAS,CAAC,IAAI,EAAE;SACzD,EACD,yBAAyB,SAAS,CAAC,IAAI,GAAG,CAC3C,CAAC;IACJ,CAAC;IAED,4BAA4B;IAC5B,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAClD,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,KAAK,GAAG,CAAC;QACpC,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,UAAU,EAAE,GAAG,CAAC,UAAU;KAC3B,CAAC,CAAC,CAAC;IAEJ,sBAAsB;IACtB,MAAM,OAAO,GAAG,iBAAiB;SAC9B,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,GAAG,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,OAAO,EAAE,CACtF;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,iBAAiB,CACtB;QACE,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,KAAK,EAAE,IAAI,CAAC,MAAM;QAClB,KAAK;QACL,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,QAAQ,EAAE,iBAAiB;QAC3B,OAAO,EAAE,UAAU,IAAI,CAAC,MAAM,iBAAiB,OAAO,EAAE;KACzD,EACD,aAAa,IAAI,CAAC,MAAM,uBAAuB,SAAS,CAAC,IAAI,GAAG,CACjE,CAAC;AACJ,CAAC"}

package/dist/tools/memory.search.d.ts

@@ -0,0 +1,5 @@
+import { SQLiteStore } from "../storage/sqlite.js";
+import { VectorStore } from "../types.js";
+import { McpResponse } from "../utils/mcp-response.js";
+export declare function handleMemorySearch(params: any, db: SQLiteStore, vectors: VectorStore): Promise<McpResponse>;
+//# sourceMappingURL=memory.search.d.ts.map

package/dist/tools/memory.search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.search.d.ts","sourceRoot":"","sources":["../../src/tools/memory.search.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAe,MAAM,aAAa,CAAC;AAIvD,OAAO,EAAqB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAwB1E,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,GAAG,EACX,EAAE,EAAE,WAAW,EACf,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,CAAC,CAiNtB"}

package/dist/tools/memory.search.js

@@ -0,0 +1,192 @@
+import { MemorySearchSchema } from "./schemas.js";
+import { normalize } from "../utils/normalize.js";
+import { handleMemoryRecap } from "./memory.recap.js";
+import { logger } from "../utils/logger.js";
+import { createMcpResponse } from "../utils/mcp-response.js";
+import { expandQuery } from "../utils/query-expander.js";
+// Hybrid search configuration — weights when vector store is active
+const HYBRID_WEIGHTS_VECTOR = {
+    similarity: 0.6,
+    vector: 0.3,
+    importance: 0.1
+};
+// Weights when vector store returns no results (normalized to sum = 1.0)
+const HYBRID_WEIGHTS_NO_VECTOR = {
+    similarity: 0.85,
+    importance: 0.15
+};
+export async function handleMemorySearch(params, db, vectors) {
+    // Validate input
+    const validated = MemorySearchSchema.parse(params);
+    // STEP 0: Pre-search recap — only if includeRecap === true
+    let recapContext = "";
+    if (validated.includeRecap) {
+        try {
+            const recapResult = await handleMemoryRecap({ repo: validated.repo, limit: 20 }, db);
+            // Find text content that contains JSON data
+            const textContent = recapResult.content.find((c) => c.type === "text" && c.text);
+            if (textContent && textContent.type === "text") {
+                try {
+                    const recapData = JSON.parse(textContent.text);
+                    if (recapData.summary) {
+                        recapContext = recapData.summary;
+                    }
+                }
+                catch {
+                    // Not JSON, might be plain text summary
+                    recapContext = textContent.text;
+                }
+            }
+        }
+        catch (error) {
+            logger.error("Failed to get recap context", { error: String(error) });
+            // Continue anyway - recap is optional
+        }
+    }
+    // Expand query using prompt intent
+    const searchQuery = expandQuery(validated.query, validated.prompt);
+    // STEP 1: Repo filter (HARD) + Lightweight similarity scoring
+    const similarityResults = db.searchBySimilarity(searchQuery, validated.repo, validated.limit * 3 // Get more candidates for vector re-ranking
+    );
+    let candidates;
+    if (similarityResults.length > 0 && similarityResults[0].similarity > 0.1) {
+        // Use similarity results as candidates
+        candidates = similarityResults.map((result) => ({
+            memory: {
+                id: result.id,
+                type: result.type,
+                title: result.title,
+                content: result.content,
+                importance: result.importance,
+                scope: result.scope,
+                created_at: result.created_at,
+                updated_at: result.updated_at,
+                hit_count: result.hit_count,
+                recall_count: result.recall_count,
+                last_used_at: result.last_used_at,
+                expires_at: result.expires_at,
+            },
+            similarityScore: result.similarity
+        }));
+    }
+    else {
+        // Fallback: keyword search as candidates
+        const allResults = db.searchByRepo(validated.repo, {
+            types: validated.types,
+            minImportance: validated.minImportance,
+            limit: validated.limit * 3
+        });
+        const normalized = normalize(searchQuery);
+        const queryWords = normalized.split(/\s+/).filter(w => w.length > 2);
+        const filtered = allResults.filter((entry) => {
+            const normalizedContent = normalize(entry.content);
+            return queryWords.some(word => normalizedContent.includes(word));
+        });
+        const memoriesToUse = filtered.length > 0 ? filtered : allResults;
+        candidates = memoriesToUse.map(memory => ({
+            memory,
+            similarityScore: 0.5 // Default similarity for keyword matches
+        }));
+    }
+    // STEP 2: OPTIONAL vector similarity re-rank (only on top candidates)
+    let scoredMemories;
+    try {
+        // Attempt vector search on candidates (if available)
+        const vectorResults = await vectors.search(searchQuery, candidates.length);
+        if (vectorResults.length > 0) {
+            // Create a map of memory ID to vector score
+            const vectorScoreMap = new Map();
+            for (const vr of vectorResults) {
+                vectorScoreMap.set(vr.id, vr.score);
+            }
+            // Combine scores using hybrid formula (vector active: 0.6 + 0.3 + 0.1 = 1.0)
+            scoredMemories = candidates.map(({ memory, similarityScore }) => {
+                const vectorScore = vectorScoreMap.get(memory.id) || 0;
+                const importanceBoost = memory.importance / 5;
+                const finalScore = (similarityScore * HYBRID_WEIGHTS_VECTOR.similarity) +
+                    (vectorScore * HYBRID_WEIGHTS_VECTOR.vector) +
+                    (importanceBoost * HYBRID_WEIGHTS_VECTOR.importance);
+                return {
+                    memory,
+                    similarityScore,
+                    vectorScore,
+                    importanceBoost,
+                    finalScore
+                };
+            });
+        }
+        else {
+            // No vector results — use similarity-only ranking (0.85 + 0.15 = 1.0)
+            scoredMemories = candidates.map(({ memory, similarityScore }) => {
+                const importanceBoost = memory.importance / 5;
+                const finalScore = (similarityScore * HYBRID_WEIGHTS_NO_VECTOR.similarity) +
+                    (importanceBoost * HYBRID_WEIGHTS_NO_VECTOR.importance);
+                return {
+                    memory,
+                    similarityScore,
+                    vectorScore: 0,
+                    importanceBoost,
+                    finalScore
+                };
+            });
+        }
+    }
+    catch (error) {
+        // Vector search failed — gracefully degrade to similarity-only
+        logger.warn("Vector search failed, using similarity-only", { error: String(error) });
+        scoredMemories = candidates.map(({ memory, similarityScore }) => {
+            const importanceBoost = memory.importance / 5;
+            const finalScore = (similarityScore * HYBRID_WEIGHTS_NO_VECTOR.similarity) +
+                (importanceBoost * HYBRID_WEIGHTS_NO_VECTOR.importance);
+            return {
+                memory,
+                similarityScore,
+                vectorScore: 0,
+                importanceBoost,
+                finalScore
+            };
+        });
+    }
+    // STEP 3: Sort by final score and take top results
+    scoredMemories.sort((a, b) => b.finalScore - a.finalScore);
+    const results = scoredMemories
+        .slice(0, validated.limit)
+        .map(sm => sm.memory);
+    // STEP 4: Increment hit_count for returned memories
+    for (const memory of results) {
+        db.incrementHitCount(memory.id);
+    }
+    // STEP 5: Log the query for recent queries feature
+    db.logAction('search', validated.repo, { query: validated.query, resultCount: results.length });
+    const resultData = {
+        query: validated.query,
+        prompt: validated.prompt || null,
+        results,
+        matchReason: validated.prompt
+            ? `Results ranked by relevance to "${validated.query}" with context: ${validated.prompt}`
+            : `Results ranked by relevance to "${validated.query}"`,
+        recapContext: recapContext ? `Recent memories context:\n${recapContext}` : undefined
+    };
+    const firstResult = results[0];
+    const resultName = firstResult?.title
+        ? `${firstResult.type} - ${firstResult.title}`
+        : (firstResult ? `${firstResult.type} - ${firstResult.content.substring(0, 40)}...` : `Found ${results.length} results`);
+    return createMcpResponse(resultData, `Found ${results.length} memories matching "${validated.query}"`, {
+        query: validated.query,
+        results: results.map(r => ({
+            id: r.id,
+            type: r.type,
+            title: r.title,
+            content: r.content,
+            importance: r.importance,
+            scope: r.scope,
+            created_at: r.created_at,
+            updated_at: r.updated_at,
+            hit_count: r.hit_count,
+            recall_count: r.recall_count,
+            last_used_at: r.last_used_at,
+            expires_at: r.expires_at
+        }))
+    });
+}
+//# sourceMappingURL=memory.search.js.map

package/dist/tools/memory.search.js.map

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

package/dist/tools/memory.search.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memory.search.test.d.ts.map

package/dist/tools/memory.search.test.d.ts.map

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

package/dist/tools/memory.search.test.js

@@ -0,0 +1,181 @@
+import { describe, it, expect } from "vitest";
+import * as fc from "fast-check";
+// ─── Property 2: Recap conditional ───────────────────────────────────────────
+// Feature: memory-mcp-optimization, Property 2: Recap conditional
+// We test the weight constants directly by importing them from the module.
+// For Property 2 we need to verify the conditional recap call logic.
+// We do this by extracting the logic into a testable helper and verifying
+// the branching behaviour with fast-check.
+/**
+ * Mirrors the weight selection logic from memory.search.ts.
+ * Returns the weights object that would be used given whether vector results
+ * are present or not.
+ */
+function selectWeights(vectorResultsEmpty) {
+    if (vectorResultsEmpty) {
+        return { similarity: 0.85, importance: 0.15 };
+    }
+    return { similarity: 0.6, vector: 0.3, importance: 0.1 };
+}
+/**
+ * Mirrors the recap-call decision from memory.search.ts.
+ * Returns true if handleMemoryRecap should be called.
+ */
+function shouldCallRecap(includeRecap) {
+    return includeRecap === true;
+}
+// ─── Property 2 tests ────────────────────────────────────────────────────────
+describe("Property 2: Recap dipanggil jika dan hanya jika includeRecap = true", () => {
+    // Feature: memory-mcp-optimization, Property 2: Recap conditional
+    // Validates: Requirements 2.1, 2.2, 2.3
+    it("should NOT call recap when includeRecap is false or absent", () => {
+        fc.assert(fc.property(fc.oneof(fc.constant(false), fc.constant(undefined)), (includeRecap) => {
+            expect(shouldCallRecap(includeRecap)).toBe(false);
+        }), { numRuns: 100 });
+    });
+    it("should call recap when includeRecap is true", () => {
+        fc.assert(fc.property(fc.constant(true), (includeRecap) => {
+            expect(shouldCallRecap(includeRecap)).toBe(true);
+        }), { numRuns: 100 });
+    });
+    it("recap is called if and only if includeRecap === true (combined property)", () => {
+        fc.assert(fc.property(fc.oneof(fc.constant(true), fc.constant(false), fc.constant(undefined)), (includeRecap) => {
+            const called = shouldCallRecap(includeRecap);
+            // The iff condition: called ↔ (includeRecap === true)
+            expect(called).toBe(includeRecap === true);
+        }), { numRuns: 200 });
+    });
+});
+// ─── Property 3: Hybrid score weights sum to 1.0 ─────────────────────────────
+describe("Property 3: Total bobot Hybrid Score selalu = 1.0", () => {
+    // Feature: memory-mcp-optimization, Property 3: Hybrid score weights sum to 1.0
+    // Validates: Requirements 3.1, 3.2, 3.4
+    it("weights sum to 1.0 when vector store is empty (no vector results)", () => {
+        fc.assert(fc.property(fc.constant(true), // vectorResultsEmpty = true
+        (vectorResultsEmpty) => {
+            const weights = selectWeights(vectorResultsEmpty);
+            const sum = weights.similarity + (weights.vector ?? 0) + weights.importance;
+            expect(Math.abs(sum - 1.0)).toBeLessThan(1e-10);
+        }), { numRuns: 100 });
+    });
+    it("weights sum to 1.0 when vector store is active (has vector results)", () => {
+        fc.assert(fc.property(fc.constant(false), // vectorResultsEmpty = false
+        (vectorResultsEmpty) => {
+            const weights = selectWeights(vectorResultsEmpty);
+            const sum = weights.similarity + (weights.vector ?? 0) + weights.importance;
+            expect(Math.abs(sum - 1.0)).toBeLessThan(1e-10);
+        }), { numRuns: 100 });
+    });
+    it("weights always sum to 1.0 for both vector conditions", () => {
+        fc.assert(fc.property(fc.boolean(), // arbitrary vectorResultsEmpty flag
+        (vectorResultsEmpty) => {
+            const weights = selectWeights(vectorResultsEmpty);
+            const sum = weights.similarity + (weights.vector ?? 0) + weights.importance;
+            expect(Math.abs(sum - 1.0)).toBeLessThan(1e-10);
+        }), { numRuns: 200 });
+    });
+    it("vector-active weights are exactly 0.6 + 0.3 + 0.1 = 1.0", () => {
+        const weights = selectWeights(false);
+        expect(weights.similarity).toBe(0.6);
+        expect(weights.vector).toBe(0.3);
+        expect(weights.importance).toBe(0.1);
+        expect(weights.similarity + (weights.vector ?? 0) + weights.importance).toBeCloseTo(1.0, 10);
+    });
+    it("vector-empty weights are exactly 0.85 + 0.15 = 1.0", () => {
+        const weights = selectWeights(true);
+        expect(weights.similarity).toBe(0.85);
+        expect(weights.vector).toBeUndefined();
+        expect(weights.importance).toBe(0.15);
+        expect(weights.similarity + weights.importance).toBe(1.0);
+    });
+});
+// ─── Prompt parameter tests ─────────────────────────────────────────────────
+describe("Property: prompt parameter in memory-search", () => {
+    it("prompt is optional - search works without prompt", () => {
+        const params = {
+            query: "database orm",
+            repo: "test-repo",
+            limit: 5
+        };
+        // If prompt is not provided, searchQuery should equal query
+        const hasPrompt = 'prompt' in params && params.prompt;
+        const searchQuery = hasPrompt
+            ? `${params.query} ${params.prompt}`
+            : params.query;
+        expect(searchQuery).toBe("database orm");
+    });
+    it("prompt is combined with query when provided", () => {
+        const params = {
+            query: "database orm",
+            prompt: "I need user authentication",
+            repo: "test-repo",
+            limit: 5
+        };
+        const searchQuery = params.prompt
+            ? `${params.query} ${params.prompt}`
+            : params.query;
+        expect(searchQuery).toBe("database orm I need user authentication");
+    });
+    it("prompt can be empty string - treated as no prompt (empty string is falsy)", () => {
+        const params = {
+            query: "database orm",
+            prompt: "",
+            repo: "test-repo",
+            limit: 5
+        };
+        // Empty string is falsy in JS, so it uses just query
+        const searchQuery = params.prompt
+            ? `${params.query} ${params.prompt}`
+            : params.query;
+        expect(searchQuery).toBe("database orm");
+    });
+    it("matchReason includes prompt when provided", () => {
+        const query = "database orm";
+        const prompt = "user authentication context";
+        const matchReason = prompt
+            ? `Results ranked by relevance to "${query}" with context: ${prompt}`
+            : `Results ranked by relevance to "${query}"`;
+        expect(matchReason).toContain("database orm");
+        expect(matchReason).toContain("user authentication context");
+        expect(matchReason).toContain("with context:");
+    });
+    it("matchReason does not include prompt when not provided", () => {
+        const query = "database orm";
+        const prompt = undefined;
+        const matchReason = prompt
+            ? `Results ranked by relevance to "${query}" with context: ${prompt}`
+            : `Results ranked by relevance to "${query}"`;
+        expect(matchReason).toBe(`Results ranked by relevance to "${query}"`);
+        expect(matchReason).not.toContain("with context:");
+    });
+    it("property: searchQuery combines query and prompt consistently", () => {
+        fc.assert(fc.property(fc.string({ minLength: 3, maxLength: 50 }), fc.string({ minLength: 1, maxLength: 100 }), (query, prompt) => {
+            const searchQuery = `${query} ${prompt}`;
+            // Search query should always start with the original query
+            expect(searchQuery.startsWith(query)).toBe(true);
+            // Search query should contain the prompt
+            expect(searchQuery.includes(prompt)).toBe(true);
+            // There should be exactly one space between query and prompt
+            expect(searchQuery).toBe(`${query} ${prompt}`);
+        }), { numRuns: 50 });
+    });
+    it("property: matchReason format is correct with and without prompt", () => {
+        fc.assert(fc.property(fc.string({ minLength: 1, maxLength: 30 }), fc.option(fc.string({ minLength: 1, maxLength: 50 })), (query, prompt) => {
+            const matchReason = prompt
+                ? `Results ranked by relevance to "${query}" with context: ${prompt}`
+                : `Results ranked by relevance to "${query}"`;
+            // Should always contain the query
+            expect(matchReason).toContain(query);
+            if (prompt) {
+                // Should contain "with context:" when prompt exists
+                expect(matchReason).toContain("with context:");
+                expect(matchReason).toContain(prompt);
+            }
+            else {
+                // Should NOT contain "with context:" when prompt is absent
+                expect(matchReason).not.toContain("with context:");
+            }
+        }), { numRuns: 50 });
+    });
+});
+//# sourceMappingURL=memory.search.test.js.map

package/dist/tools/memory.search.test.js.map

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

package/dist/tools/memory.store.d.ts

@@ -0,0 +1,5 @@
+import { SQLiteStore } from "../storage/sqlite.js";
+import { VectorStore } from "../types.js";
+import { McpResponse } from "../utils/mcp-response.js";
+export declare function handleMemoryStore(params: any, db: SQLiteStore, vectors: VectorStore): Promise<McpResponse>;
+//# sourceMappingURL=memory.store.d.ts.map

package/dist/tools/memory.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.store.d.ts","sourceRoot":"","sources":["../../src/tools/memory.store.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAe,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAqB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE1E,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,GAAG,EACX,EAAE,EAAE,WAAW,EACf,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,CAAC,CA4CtB"}