@vheins/local-memory-mcp 0.4.8 → 0.4.11

package/dist/tests/e2e.test.js

@@ -0,0 +1,250 @@
+import { describe, it, expect, beforeEach, vi } from "vitest";
+import { createRouter } from "../router.js";
+import { SQLiteStore } from "../storage/sqlite.js";
+import { RealVectorStore } from "../storage/vectors.js";
+// Global configuration for heavy AI tests
+vi.setConfig({ testTimeout: 90000 });
+describe("MCP Local Memory - High-Complexity E2E Scenarios", () => {
+    let db;
+    let vectors;
+    let router;
+    const REPO = "enterprise-app-v2";
+    beforeEach(() => {
+        db = new SQLiteStore(":memory:");
+        vectors = new RealVectorStore(db);
+        router = createRouter(db, vectors);
+    });
+    /**
+     * SCENARIO 1: Semantic Precision & Ranking
+     * Test if the system can distinguish between closely related topics.
+     */
+    it("should maintain high precision ranking among related but distinct technical concepts", async () => {
+        const memories = [
+            { title: "Primary Database", content: "We use SQLite for local persistence to ensure local-first capability." },
+            { title: "Cache Layer", content: "Redis is used for session management and fast lookups." },
+            { title: "Database Migration", content: "Run 'npm run migrate' to update the SQLite schema safely." },
+            { title: "Backup Policy", content: "Hourly snapshots of the .db file are stored in the backups folder." },
+            { title: "External API Integration", content: "The system connects to Postgres only for reporting services." }
+        ];
+        for (const m of memories) {
+            await router("tools/call", {
+                name: "memory-store",
+                arguments: {
+                    type: "decision",
+                    title: m.title,
+                    content: m.content,
+                    importance: 4,
+                    scope: { repo: REPO },
+                    agent: "test-agent",
+                    model: "test-model"
+                }
+            });
+        }
+        // QUERY: "How do I update the database?" 
+        // EXPECT: "Database Migration" should be Top Match, not "Primary Database"
+        const searchRes = await router("tools/call", {
+            name: "memory-search",
+            arguments: { query: "How do I update the database schema?", repo: REPO }
+        });
+        const textOutput = searchRes.content[0].text;
+        expect(textOutput).toContain("Database Migration");
+        // Validate JSON ordering
+        const results = searchRes.data.results;
+        expect(results[0].title).toBe("Database Migration");
+        expect(results.length).toBeGreaterThan(1); // Should find related db facts too but lower
+    });
+    /**
+     * SCENARIO 2: The Correction & Learning Loop
+     * Agent makes a mistake -> Stores it -> Learns -> Replaces it with a pattern.
+     */
+    it("should guide the agent away from past mistakes using supersedes and status", async () => {
+        // 1. Store a mistake
+        const mistakeRes = await router("tools/call", {
+            name: "memory-store",
+            arguments: {
+                type: "mistake",
+                title: "Large File Upload Failure",
+                content: "Don't use fs.readFileSync for large files, it causes OOM errors.",
+                importance: 5,
+                scope: { repo: REPO },
+                agent: "test-agent",
+                model: "test-model"
+            }
+        });
+        const mistakeId = mistakeRes.data.id;
+        // 2. Store the correct pattern that replaces the mistake
+        await router("tools/call", {
+            name: "memory-store",
+            arguments: {
+                type: "pattern",
+                title: "Streaming File Upload",
+                content: "Always use streams (fs.createReadStream) for files > 10MB.",
+                importance: 5,
+                scope: { repo: REPO },
+                agent: "test-agent",
+                model: "test-model",
+                supersedes: mistakeId
+            }
+        });
+        // 3. Search for "file upload"
+        const searchRes = await router("tools/call", {
+            name: "memory-search",
+            arguments: { query: "How to handle file uploads?", repo: REPO }
+        });
+        // EXPECT: Mistake is archived and NOT in search results by default
+        expect(searchRes.content[0].text).toContain("Streaming File Upload");
+        expect(searchRes.content[0].text).not.toContain("Large File Upload Failure");
+        const results = searchRes.data.results;
+        expect(results.some((r) => r.id === mistakeId)).toBe(false);
+        // 4. Audit: Verify we can still find the mistake if we EXPLICITLY ask for archived
+        const auditRes = await router("tools/call", {
+            name: "memory-search",
+            arguments: { query: "file upload", repo: REPO, include_archived: true }
+        });
+        expect(auditRes.data.results.some((r) => r.id === mistakeId)).toBe(true);
+    });
+    /**
+     * SCENARIO 3: Workspace-Aware Context Nuance
+     * Boost based on folder depth and language extensions.
+     */
+    it("should provide relevant boost when working in deep subdirectories", async () => {
+        // Memory A: Global
+        await router("tools/call", {
+            name: "memory-store",
+            arguments: {
+                type: "code_fact",
+                title: "Global Logging",
+                content: "Use logger.info for all modules.",
+                importance: 2,
+                scope: { repo: REPO },
+                agent: "test-agent",
+                model: "test-model"
+            }
+        });
+        // Memory B: Auth Specific
+        await router("tools/call", {
+            name: "memory-store",
+            arguments: {
+                type: "code_fact",
+                title: "Auth Security Audit",
+                content: "Auth module requires PII masking in logs.",
+                importance: 5,
+                scope: { repo: REPO, folder: "src/auth" },
+                agent: "test-agent",
+                model: "test-model"
+            }
+        });
+        // Working in a deep auth file
+        const searchRes = await router("tools/call", {
+            name: "memory-search",
+            arguments: {
+                query: "How to log data?",
+                repo: REPO,
+                current_file_path: "src/auth/services/ldap/provider.ts"
+            }
+        });
+        // EXPECT: Auth Specific memory should be the Top Match despite the query being generic "log"
+        expect(searchRes.content[0].text).toContain("Auth Security Audit");
+    });
+    /**
+     * SCENARIO 4: Bulk Operations & Pagination Integrity
+     */
+    it("should handle large volumes of memories and maintain pagination integrity", async () => {
+        // Store 15 memories about different microservices
+        for (let i = 1; i <= 15; i++) {
+            await router("tools/call", {
+                name: "memory-store",
+                arguments: {
+                    type: "code_fact",
+                    title: `Service ${i} Specs`,
+                    content: `Documentation for microservice number ${i} in our mesh network.`,
+                    importance: 3,
+                    scope: { repo: "cloud-infra" },
+                    agent: "test-agent",
+                    model: "test-model"
+                }
+            });
+        }
+        // Call memory-recap (which uses pagination)
+        const recapRes = await router("tools/call", {
+            name: "memory-recap",
+            arguments: { repo: "cloud-infra", limit: 5, offset: 0 }
+        });
+        // Based on memory-recap implementation
+        expect(recapRes.content[0].text).toContain("cloud-infra");
+        // Check Resource Pagination via URI
+        const resourceRes = await router("resources/read", {
+            uri: "memory://index?repo=cloud-infra"
+        });
+        const entries = JSON.parse(resourceRes.contents[0].text);
+        expect(entries.length).toBeLessThanOrEqual(20); // Default limit in resource.read is 20
+    });
+    /**
+     * SCENARIO 5: Semantic Conflict Denial (Deep Overlap)
+     */
+    it("should strictly deny near-duplicate decisions to prevent prompt bloat", async () => {
+        const originalContent = "We use TailwindCSS for styling all components.";
+        await router("tools/call", {
+            name: "memory-store",
+            arguments: {
+                type: "decision",
+                title: "Styling Standard",
+                content: originalContent,
+                importance: 3,
+                scope: { repo: REPO },
+                agent: "test-agent",
+                model: "test-model"
+            }
+        });
+        // Try to store almost the same thing with a different title
+        const duplicateRes = await router("tools/call", {
+            name: "memory-store",
+            arguments: {
+                type: "decision",
+                title: "CSS Rule",
+                content: "Use Tailwind CSS for styling our UI components.", // Subtly different but semantically identical
+                importance: 3,
+                scope: { repo: REPO },
+                agent: "test-agent",
+                model: "test-model"
+            }
+        });
+        expect(duplicateRes.content[0].text).toContain("conflict");
+        expect(duplicateRes.content[0].text).toContain("Hint:");
+        expect(duplicateRes.content[0].text).toContain("memory-delete");
+        expect(db.getTotalCount(REPO)).toBe(1); // Should still be 1
+    });
+    /**
+     * SCENARIO 6: Cross-Project Knowledge Sharing (Tech-Stack Affinity)
+     * Repository A has Filament knowledge. Repository B (new) should access it via tags.
+     */
+    it("should share knowledge across projects using tech-stack affinity tags", async () => {
+        // 1. Store Filament best practice in Repo A
+        await router("tools/call", {
+            name: "memory-store",
+            arguments: {
+                type: "pattern",
+                title: "Filament Custom Action",
+                content: "Always use ->requiresConfirmation() for destructive actions in Filament.",
+                importance: 5,
+                scope: { repo: "project-a" },
+                agent: "test-agent",
+                model: "test-model",
+                tags: ["filament", "laravel"]
+            }
+        });
+        // 2. Search in Repo B (which is empty) with "filament" tag
+        const searchRes = await router("tools/call", {
+            name: "memory-search",
+            arguments: {
+                query: "how to make safe actions?",
+                repo: "project-b",
+                current_tags: ["filament"]
+            }
+        });
+        // EXPECT: Should find the "Filament Custom Action" from Project A
+        expect(searchRes.content[0].text).toContain("Filament Custom Action");
+        expect(searchRes.data.results[0].scope.repo).toBe("project-a");
+    });
+});
+//# sourceMappingURL=e2e.test.js.map

package/dist/tests/e2e.test.js.map

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

package/dist/tests/index.test.d.ts

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

package/dist/tests/index.test.d.ts.map

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

package/dist/tests/index.test.js

@@ -0,0 +1,185 @@
+// Feature: memory-mcp-optimization, Property 19: memory://index filter repo
+import { describe, it, expect } from "vitest";
+import * as fc from "fast-check";
+import { SQLiteStore } from "../storage/sqlite.js";
+import { readResource, listResourceTemplates, listResources } from "../resources/index.js";
+import { createSessionContext, updateSessionRoots } from "../mcp/session.js";
+function makeEntry(id, repo) {
+    return {
+        id,
+        type: "code_fact",
+        title: `Memory ${id}`,
+        content: `Content for memory ${id} in repo ${repo}`,
+        importance: 3,
+        agent: "test-agent",
+        role: "unknown",
+        model: "test-model",
+        scope: { repo },
+        created_at: new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+        completed_at: null,
+        hit_count: 0,
+        recall_count: 0,
+        last_used_at: null,
+        expires_at: null,
+        supersedes: null,
+        status: "active",
+        tags: [],
+        metadata: {},
+        is_global: false,
+    };
+}
+describe("readResource memory://index", () => {
+    it("returns recent entries when no repo filter", () => {
+        const db = new SQLiteStore(":memory:");
+        db.insert(makeEntry("id-1", "repo-a"));
+        db.insert(makeEntry("id-2", "repo-b"));
+        const result = readResource("memory://index", db);
+        const entries = JSON.parse(result.contents[0].text);
+        expect(entries.length).toBeGreaterThan(0);
+        db.close();
+    });
+    it("returns only entries for the specified repo when ?repo=X is given", () => {
+        const db = new SQLiteStore(":memory:");
+        db.insert(makeEntry("id-a1", "repo-alpha"));
+        db.insert(makeEntry("id-a2", "repo-alpha"));
+        db.insert(makeEntry("id-b1", "repo-beta"));
+        const result = readResource("memory://index?repo=repo-alpha", db);
+        const entries = JSON.parse(result.contents[0].text);
+        expect(entries.length).toBeGreaterThan(0);
+        for (const entry of entries) {
+            expect(entry.scope.repo).toBe("repo-alpha");
+        }
+        db.close();
+    });
+    it("returns empty array when repo has no entries", () => {
+        const db = new SQLiteStore(":memory:");
+        db.insert(makeEntry("id-1", "repo-a"));
+        const result = readResource("memory://index?repo=nonexistent", db);
+        const entries = JSON.parse(result.contents[0].text);
+        expect(entries).toEqual([]);
+        db.close();
+    });
+    /**
+     * Property 19: memory://index dengan filter repo mengembalikan subset yang benar
+     * Validates: Requirements 19.1, 19.3
+     */
+    it("Property 19: all returned entries have repo === queried repo", () => {
+        fc.assert(fc.property(
+        // Generate 2-4 distinct repo names
+        fc.uniqueArray(fc.stringMatching(/^[a-z][a-z0-9-]{2,8}$/), { minLength: 2, maxLength: 4 }), 
+        // Generate 1-5 memories per repo
+        fc.integer({ min: 1, max: 5 }), (repos, memoriesPerRepo) => {
+            const db = new SQLiteStore(":memory:");
+            // Insert memories for each repo
+            let counter = 0;
+            for (const repo of repos) {
+                for (let i = 0; i < memoriesPerRepo; i++) {
+                    db.insert(makeEntry(`id-${counter++}`, repo));
+                }
+            }
+            // Query with the first repo as filter
+            const targetRepo = repos[0];
+            const result = readResource(`memory://index?repo=${targetRepo}`, db);
+            const entries = JSON.parse(result.contents[0].text);
+            // All returned entries must belong to targetRepo
+            const allMatch = entries.every((e) => e.scope.repo === targetRepo);
+            db.close();
+            return allMatch;
+        }), { numRuns: 100 });
+    });
+    it("Property 19 (no filter): returns entries from all repos", () => {
+        fc.assert(fc.property(fc.uniqueArray(fc.stringMatching(/^[a-z][a-z0-9-]{2,8}$/), { minLength: 2, maxLength: 3 }), (repos) => {
+            const db = new SQLiteStore(":memory:");
+            for (const repo of repos) {
+                db.insert(makeEntry(`id-${repo}`, repo));
+            }
+            const result = readResource("memory://index", db);
+            const entries = JSON.parse(result.contents[0].text);
+            // Without filter, should return entries (listRecent returns id/type/repo)
+            expect(entries.length).toBeGreaterThan(0);
+            db.close();
+            return true;
+        }), { numRuns: 100 });
+    });
+});
+describe("MCP resource templates and session resources", () => {
+    it("supports resource list pagination with nextCursor", () => {
+        const session = createSessionContext();
+        const firstPage = listResources(session, { limit: 2 });
+        const secondPage = listResources(session, { limit: 2, cursor: firstPage.nextCursor });
+        expect(firstPage.resources).toHaveLength(2);
+        expect(firstPage.nextCursor).toBeTruthy();
+        expect(secondPage.resources).toHaveLength(1);
+    });
+    it("supports resource template pagination with nextCursor", () => {
+        const firstPage = listResourceTemplates({ limit: 2 });
+        const secondPage = listResourceTemplates({ limit: 2, cursor: firstPage.nextCursor });
+        const secondTemplates = secondPage.resourceTemplates;
+        expect(firstPage.resourceTemplates).toHaveLength(2);
+        expect(firstPage.nextCursor).toBeTruthy();
+        expect(secondTemplates.length).toBeGreaterThan(0);
+    });
+    it("rejects invalid cursors for resources/list with MCP invalid params error", () => {
+        const session = createSessionContext();
+        expect(() => listResources(session, { cursor: "%%%not-base64%%%" })).toThrowError(/Invalid cursor/);
+        try {
+            listResources(session, { cursor: "%%%not-base64%%%" });
+        }
+        catch (error) {
+            expect(error.code).toBe(-32602);
+        }
+    });
+    it("rejects invalid cursors for resources/templates/list with MCP invalid params error", () => {
+        expect(() => listResourceTemplates({ cursor: "%%%not-base64%%%" })).toThrowError(/Invalid cursor/);
+        try {
+            listResourceTemplates({ cursor: "%%%not-base64%%%" });
+        }
+        catch (error) {
+            expect(error.code).toBe(-32602);
+        }
+    });
+    it("lists parameterized resources via resources/templates/list", () => {
+        const result = listResourceTemplates();
+        const templates = result.resourceTemplates.map((entry) => entry.uriTemplate);
+        expect(templates).toContain("memory://index?repo={repo}");
+        expect(templates).toContain("tasks://current?repo={repo}");
+        expect(templates).toContain("memory://search/{base64_query}?repo={repo}");
+    });
+    it("returns active session roots as a concrete resource", () => {
+        const db = new SQLiteStore(":memory:");
+        const session = createSessionContext();
+        updateSessionRoots(session, [
+            { uri: "file:///workspace/project-a", name: "project-a" },
+            { uri: "file:///workspace/project-b" },
+        ]);
+        const result = readResource("session://roots", db, session);
+        const payload = JSON.parse(result.contents[0].text);
+        expect(payload.roots).toHaveLength(2);
+        expect(payload.roots[0].name).toBe("project-a");
+        db.close();
+    });
+    it("adds annotations and size metadata to concrete resource content", () => {
+        const db = new SQLiteStore(":memory:");
+        const result = readResource("memory://summary/repo-a", db);
+        const content = result.contents[0];
+        expect(content.annotations.priority).toBeGreaterThan(0.5);
+        expect(content.size).toBeGreaterThan(0);
+        db.close();
+    });
+    it("throws MCP resource not found error code for unknown resources", () => {
+        const db = new SQLiteStore(":memory:");
+        expect(() => readResource("memory://missing/resource", db)).toThrowError(/Unknown resource URI/);
+        try {
+            readResource("memory://missing/resource", db);
+        }
+        catch (error) {
+            expect(error.code).toBe(-32002);
+            expect(error.data.uri).toBe("memory://missing/resource");
+        }
+        finally {
+            db.close();
+        }
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/tests/index.test.js.map

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

package/dist/tests/logger.test.d.ts

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

package/dist/tests/logger.test.d.ts.map

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

package/dist/tests/logger.test.js

@@ -0,0 +1,104 @@
+// Feature: memory-mcp-optimization
+// Property 20: StructuredLogger output adalah JSON valid dengan field wajib
+// Validates: Requirements 21.1, 21.2
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import * as fc from "fast-check";
+describe("Property 20: StructuredLogger output adalah JSON valid dengan field wajib", () => {
+    let stderrOutput = [];
+    let stderrSpy;
+    beforeEach(() => {
+        stderrOutput = [];
+        stderrSpy = vi.spyOn(process.stderr, "write").mockImplementation((chunk) => {
+            stderrOutput.push(typeof chunk === "string" ? chunk : chunk.toString());
+            return true;
+        });
+        // Reset LOG_LEVEL to ensure all levels are logged
+        process.env.LOG_LEVEL = "debug";
+    });
+    afterEach(() => {
+        stderrSpy.mockRestore();
+        delete process.env.LOG_LEVEL;
+    });
+    it("each log call produces valid JSON output with required fields", async () => {
+        // Re-import logger after setting LOG_LEVEL
+        const { logger } = await import("../utils/logger.js?t=" + Date.now());
+        fc.assert(fc.property(fc.oneof(fc.constant("debug"), fc.constant("info"), fc.constant("warning"), fc.constant("error")), fc.string({ minLength: 1, maxLength: 100 }), (level, message) => {
+            stderrOutput = [];
+            logger[level](message);
+            expect(stderrOutput.length).toBeGreaterThanOrEqual(1);
+            const lastOutput = stderrOutput[stderrOutput.length - 1];
+            // Must be text with timestamp, level, and message
+            expect(lastOutput).toMatch(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z \[.*?\] /);
+            // Extract parts
+            const match = lastOutput.match(/^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z) \[\s*(.*?)\s*\] ([\s\S]*)$/);
+            expect(match).not.toBeNull();
+            if (match) {
+                const [, timestamp, parsedLevel, messageWithCtx] = match;
+                // level must match
+                expect(parsedLevel.toLowerCase()).toBe(level);
+                // message must start with the original message
+                expect(messageWithCtx.startsWith(message)).toBe(true);
+                // timestamp must be ISO 8601
+                const ts = new Date(timestamp);
+                expect(isNaN(ts.getTime())).toBe(false);
+            }
+        }), { numRuns: 100 });
+    });
+    it("log output with context includes context field", async () => {
+        const { logger } = await import("../utils/logger.js?t=" + Date.now() + "ctx");
+        stderrOutput = [];
+        logger.info("test message", { key: "value", count: 42 });
+        expect(stderrOutput.length).toBeGreaterThanOrEqual(1);
+        const lastOutput = stderrOutput[stderrOutput.length - 1];
+        expect(lastOutput).toContain('{"key":"value","count":42}');
+    });
+    it("log output without context does not include context field", async () => {
+        const { logger } = await import("../utils/logger.js?t=" + Date.now() + "noctx");
+        stderrOutput = [];
+        logger.info("no context message");
+        expect(stderrOutput.length).toBeGreaterThanOrEqual(1);
+        const lastOutput = stderrOutput[stderrOutput.length - 1];
+        expect(lastOutput.trim()).not.toMatch(/\{.*\}/);
+    });
+    it("all four log levels produce valid JSON with correct level field", async () => {
+        const { logger } = await import("../utils/logger.js?t=" + Date.now() + "levels");
+        const levels = ["debug", "info", "warning", "error"];
+        for (const level of levels) {
+            stderrOutput = [];
+            if (level === "warning") {
+                logger.warning(`test ${level} message`);
+            }
+            else {
+                logger[level](`test ${level} message`);
+            }
+            expect(stderrOutput.length).toBeGreaterThanOrEqual(1);
+            const lastOutput = stderrOutput[stderrOutput.length - 1];
+            expect(lastOutput).toMatch(new RegExp(`\\[\\s*${level.toUpperCase()}\\s*\\]`));
+            expect(lastOutput).toContain(`test ${level} message`);
+        }
+    });
+    it("warn alias normalizes to warning", async () => {
+        const { logger } = await import("../utils/logger.js?t=" + Date.now() + "warnalias");
+        stderrOutput = [];
+        logger.warn("legacy warning");
+        expect(stderrOutput.length).toBeGreaterThanOrEqual(1);
+        const lastOutput = stderrOutput[stderrOutput.length - 1];
+        expect(lastOutput).toMatch(/\[\s*WARNING\s*\]/);
+    });
+    it("emits structured payloads to registered log sinks", async () => {
+        const module = await import("../utils/logger.js?t=" + Date.now() + "sink");
+        const sink = vi.fn();
+        module.addLogSink(sink);
+        module.logger.notice("[Server] Configuration updated", { source: "test" });
+        expect(sink).toHaveBeenCalledWith({
+            level: "notice",
+            logger: "server",
+            data: {
+                message: "[Server] Configuration updated",
+                source: "test",
+            },
+        });
+        module.clearLogSinks();
+    });
+});
+//# sourceMappingURL=logger.test.js.map

package/dist/tests/logger.test.js.map

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

package/dist/tests/memory.bulk.test.d.ts

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

package/dist/tests/memory.bulk.test.d.ts.map

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