@vheins/local-memory-mcp 0.1.0

package/dist/utils/mcp-response.js.map

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

package/dist/utils/normalize.d.ts

@@ -0,0 +1,4 @@
+export declare const STOPWORDS: ReadonlySet<string>;
+export declare function normalize(text: string): string;
+export declare function tokenize(text: string): string[];
+//# sourceMappingURL=normalize.d.ts.map

package/dist/utils/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/utils/normalize.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,SAAS,EAAE,WAAW,CAAC,MAAM,CAiCxC,CAAC;AAEH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO9C;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAI/C"}

package/dist/utils/normalize.js

@@ -0,0 +1,51 @@
+// Normalization layer for text processing
+// Requirements: 4.1, 5.1, 17.4
+// Combined English + Indonesian stopwords (all lowercase, no duplicates)
+export const STOPWORDS = new Set([
+    // English stopwords
+    "a", "an", "the", "and", "or", "but", "in", "on", "at", "to", "for",
+    "of", "with", "by", "from", "up", "about", "into", "through", "during",
+    "is", "are", "was", "were", "be", "been", "being", "have", "has", "had",
+    "do", "does", "did", "will", "would", "could", "should", "may", "might",
+    "shall", "can", "need", "dare", "ought", "used",
+    "i", "me", "my", "myself", "we", "our", "ours", "ourselves",
+    "you", "your", "yours", "yourself", "yourselves",
+    "he", "him", "his", "himself", "she", "her", "hers", "herself",
+    "it", "its", "itself", "they", "them", "their", "theirs", "themselves",
+    "what", "which", "who", "whom", "this", "that", "these", "those",
+    "am", "if", "then", "else", "when", "where", "why", "how",
+    "all", "both", "each", "few", "more", "most", "other", "some", "such",
+    "no", "not", "only", "same", "so", "than", "too", "very",
+    "just", "because", "as", "until", "while", "although", "though",
+    "after", "before", "since", "between", "out", "off", "over", "under",
+    "again", "further", "once", "here", "there", "any", "also",
+    // Indonesian stopwords
+    "yang", "dan", "di", "ke", "dari", "ini", "itu", "dengan", "untuk",
+    "pada", "adalah", "dalam", "tidak", "akan", "juga", "ada", "saya",
+    "kita", "kami", "mereka", "dia", "ia", "anda", "kamu", "aku",
+    "bisa", "dapat", "harus", "sudah", "telah", "sedang", "masih",
+    "lebih", "sangat", "paling", "hanya", "jika", "kalau", "karena",
+    "sehingga", "namun", "tetapi", "tapi", "atau", "maupun", "bahwa",
+    "oleh", "seperti", "antara", "setelah", "sebelum", "ketika", "saat",
+    "semua", "setiap", "beberapa", "banyak", "sedikit", "lain", "lainnya",
+    "tersebut", "nya", "pun", "lah", "kah", "dah",
+    "agar", "supaya", "maka", "meski", "walaupun", "meskipun",
+    "selain", "selama", "sejak", "hingga", "sampai", "tentang",
+    "terhadap", "melalui", "tanpa", "bagi", "atas", "bawah",
+    "depan", "belakang", "kiri", "kanan", "sini", "sana", "situ",
+    "begitu", "begini", "demikian", "hal", "cara", "waktu", "tempat",
+]);
+export function normalize(text) {
+    return text
+        .toLowerCase()
+        // Keep alphanumeric characters and spaces, including Unicode letters (for Indonesian, etc.)
+        .replace(/[^\w\s\u00C0-\u017F]/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+export function tokenize(text) {
+    return normalize(text)
+        .split(" ")
+        .filter((token) => token.length > 0 && !STOPWORDS.has(token));
+}
+//# sourceMappingURL=normalize.js.map

package/dist/utils/normalize.js.map

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

package/dist/utils/normalize.test.d.ts

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

package/dist/utils/normalize.test.d.ts.map

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

package/dist/utils/normalize.test.js

@@ -0,0 +1,159 @@
+// Feature: memory-mcp-optimization
+// Unit + Property tests for normalize(), tokenize(), and STOPWORDS
+// Requirements: 5.4, 5.5, 17.3, 17.4, 17.7
+import { describe, it, expect } from "vitest";
+import * as fc from "fast-check";
+import { normalize, tokenize, STOPWORDS } from "./normalize.js";
+// ─── Unit Tests: normalize() ─────────────────────────────────────────────────
+describe("normalize() — unit tests", () => {
+    it("converts text to lowercase", () => {
+        expect(normalize("Hello World")).toBe("hello world");
+        expect(normalize("TYPESCRIPT")).toBe("typescript");
+        expect(normalize("CamelCase")).toBe("camelcase");
+    });
+    it("trims leading and trailing whitespace", () => {
+        expect(normalize("  hello  ")).toBe("hello");
+        expect(normalize("\t  text  \n")).toBe("text");
+    });
+    it("replaces special characters with spaces", () => {
+        const result = normalize("hello!world@test#value");
+        // Special chars replaced by spaces, then collapsed
+        expect(result).not.toContain("!");
+        expect(result).not.toContain("@");
+        expect(result).not.toContain("#");
+    });
+    it("collapses multiple spaces into one", () => {
+        expect(normalize("hello   world")).toBe("hello world");
+        expect(normalize("a  b  c")).toBe("a b c");
+    });
+    it("handles empty string", () => {
+        expect(normalize("")).toBe("");
+    });
+    it("handles string with only special characters", () => {
+        expect(normalize("!!!@@@###")).toBe("");
+    });
+    it("preserves alphanumeric characters", () => {
+        expect(normalize("abc123")).toBe("abc123");
+    });
+});
+// ─── Unit Tests: tokenize() ──────────────────────────────────────────────────
+describe("tokenize() — unit tests", () => {
+    it("removes stopwords from output", () => {
+        const tokens = tokenize("the quick brown fox");
+        expect(tokens).not.toContain("the");
+        expect(tokens).toContain("quick");
+        expect(tokens).toContain("brown");
+        expect(tokens).toContain("fox");
+    });
+    it("removes short words (length <= 0 after normalize)", () => {
+        // tokenize filters tokens with length > 0 and not in STOPWORDS
+        const tokens = tokenize("a b c hello");
+        // "a", "b", "c" are stopwords or single chars
+        expect(tokens).toContain("hello");
+    });
+    it("returns empty array for all-stopword input", () => {
+        const tokens = tokenize("the and or but");
+        expect(tokens).toEqual([]);
+    });
+    it("handles empty string", () => {
+        expect(tokenize("")).toEqual([]);
+    });
+    it("normalizes before tokenizing (lowercase, trim)", () => {
+        const tokens1 = tokenize("TypeScript");
+        const tokens2 = tokenize("typescript");
+        expect(tokens1).toEqual(tokens2);
+    });
+    it("removes Indonesian stopwords", () => {
+        const tokens = tokenize("yang dan di ke dari ini itu coding");
+        expect(tokens).not.toContain("yang");
+        expect(tokens).not.toContain("dan");
+        expect(tokens).toContain("coding");
+    });
+});
+// ─── Property 4: Tokenisasi konsisten antara SQLiteStore dan StubVectorStore ──
+// Feature: memory-mcp-optimization, Property 4: Tokenisasi konsisten
+// Validates: Requirements 4.4, 5.2, 5.3
+describe("Property 4: Tokenisasi konsisten antara SQLiteStore dan StubVectorStore", () => {
+    it("tokenize() is deterministic — same input always produces same output", () => {
+        fc.assert(fc.property(fc.string({ minLength: 0, maxLength: 100 }), (text) => {
+            // Both SQLiteStore and StubVectorStore use tokenize() from normalize.ts
+            // So testing tokenize() determinism validates consistency between them
+            const result1 = tokenize(text);
+            const result2 = tokenize(text);
+            expect(result1).toEqual(result2);
+        }), { numRuns: 200 });
+    });
+    it("tokenize() output is a subset of normalize() tokens", () => {
+        fc.assert(fc.property(fc.string({ minLength: 0, maxLength: 100 }), (text) => {
+            const normalized = normalize(text);
+            const allTokens = normalized.split(" ").filter((t) => t.length > 0);
+            const filtered = tokenize(text);
+            // Every token in filtered must appear in allTokens
+            for (const token of filtered) {
+                expect(allTokens).toContain(token);
+            }
+        }), { numRuns: 200 });
+    });
+});
+// ─── Property 5: normalize() idempoten ganda ─────────────────────────────────
+// Feature: memory-mcp-optimization, Property 5: normalize() idempoten ganda
+// Validates: Requirements 5.4, 5.5
+describe("Property 5: normalize() idempoten ganda", () => {
+    it("normalize(normalize(text)) === normalize(text) for 100+ random inputs", () => {
+        fc.assert(fc.property(fc.string({ minLength: 0, maxLength: 200 }), (text) => {
+            const once = normalize(text);
+            const twice = normalize(once);
+            expect(twice).toBe(once);
+        }), { numRuns: 200 });
+    });
+    it("normalize is idempotent for specific edge cases", () => {
+        const cases = [
+            "",
+            "   ",
+            "Hello World!",
+            "UPPERCASE",
+            "already normalized",
+            "multiple   spaces",
+            "special!@#chars",
+            "123numbers456",
+        ];
+        for (const text of cases) {
+            const once = normalize(text);
+            const twice = normalize(once);
+            expect(twice).toBe(once);
+        }
+    });
+});
+// ─── Property 21: Stopword list tidak mengandung duplikat ────────────────────
+// Feature: memory-mcp-optimization, Property 21: Stopword no duplicates
+// Validates: Requirement 17.4
+describe("Property 21: Stopword list tidak mengandung duplikat", () => {
+    it("STOPWORDS has no duplicate entries", () => {
+        // Since STOPWORDS is a Set, duplicates are automatically removed.
+        // We verify the source array (before Set construction) has no duplicates
+        // by checking that Set size equals the number of unique entries.
+        // The Set itself guarantees uniqueness, so we verify the exported Set is consistent.
+        const stopwordsArray = Array.from(STOPWORDS);
+        const uniqueSet = new Set(stopwordsArray);
+        expect(uniqueSet.size).toBe(stopwordsArray.length);
+    });
+    it("all STOPWORDS entries are lowercase strings", () => {
+        for (const word of STOPWORDS) {
+            expect(typeof word).toBe("string");
+            expect(word).toBe(word.toLowerCase());
+        }
+    });
+    it("STOPWORDS is non-empty", () => {
+        expect(STOPWORDS.size).toBeGreaterThan(0);
+    });
+    it("property: no string appears more than once in STOPWORDS", () => {
+        // This is a structural property — verified once (not random inputs needed)
+        // since STOPWORDS is a constant Set
+        const seen = new Set();
+        for (const word of STOPWORDS) {
+            expect(seen.has(word)).toBe(false);
+            seen.add(word);
+        }
+    });
+});
+//# sourceMappingURL=normalize.test.js.map

package/dist/utils/normalize.test.js.map

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

package/dist/utils/query-expander.d.ts

@@ -0,0 +1,2 @@
+export declare function expandQuery(query: string, prompt?: string): string;
+//# sourceMappingURL=query-expander.d.ts.map

package/dist/utils/query-expander.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-expander.d.ts","sourceRoot":"","sources":["../../src/utils/query-expander.ts"],"names":[],"mappings":"AA4CA,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAelE"}

package/dist/utils/query-expander.js

@@ -0,0 +1,50 @@
+import { tokenize, normalize } from "./normalize.js";
+const KEYWORD_EXPANSION = {
+    database: ["sql", "orm", "query", "migration", "schema", "postgresql", "mysql"],
+    auth: ["authentication", "login", "password", "jwt", "token", "session", "oauth"],
+    login: ["auth", "authentication", "password", "jwt", "session", "credential"],
+    api: ["rest", "endpoint", "controller", "route", "request", "response"],
+    test: ["testing", "unit", "integration", "vitest", "jest", "mock"],
+    model: ["entity", "schema", "relation", "eloquent", "migration"],
+    frontend: ["ui", "react", "vue", "component", "tailwind", "css"],
+    backend: ["server", "api", "controller", "service", "database"],
+    security: ["encryption", "hash", "csrf", "xss", "sanitize", "validation"],
+    performance: ["cache", "optimization", "index", "query", "lazy", "eager"],
+    deployment: ["docker", "nginx", "ci", "cd", "pipeline", "deploy"],
+};
+function expandKeyword(keyword) {
+    const normalized = normalize(keyword).toLowerCase();
+    return KEYWORD_EXPANSION[normalized] || [];
+}
+function extractIntentKeywords(prompt) {
+    const tokens = tokenize(prompt);
+    const important = tokens.filter((t) => {
+        if (t.length < 3)
+            return false;
+        const stopWords = [
+            "need", "want", "how", "what", "when", "where", "why",
+            "using", "with", "implement", "create", "build", "make",
+            "have", "get", "find", "look", "search", "trying",
+        ];
+        return !stopWords.includes(t);
+    });
+    const expanded = [];
+    for (const token of important) {
+        expanded.push(token);
+        const expansions = expandKeyword(token);
+        expanded.push(...expansions);
+    }
+    return [...new Set(expanded)];
+}
+export function expandQuery(query, prompt) {
+    const normalizedQuery = normalize(query);
+    const queryTokens = normalizedQuery.split(/\s+/).filter((t) => t.length > 0);
+    if (!prompt) {
+        return queryTokens.join(" ");
+    }
+    const intentKeywords = extractIntentKeywords(prompt);
+    const combined = new Set([...queryTokens, ...intentKeywords]);
+    const result = Array.from(combined).slice(0, 10).join(" ");
+    return result.length > 3 ? result : queryTokens.join(" ");
+}
+//# sourceMappingURL=query-expander.js.map

package/dist/utils/query-expander.js.map

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

package/dist/utils/query-expander.test.d.ts

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

package/dist/utils/query-expander.test.d.ts.map

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

package/dist/utils/query-expander.test.js

@@ -0,0 +1,35 @@
+import { describe, it, expect } from "vitest";
+import { expandQuery } from "../utils/query-expander.js";
+describe("expandQuery", () => {
+    it("returns original query when no prompt provided", () => {
+        expect(expandQuery("database")).toBe("database");
+        expect(expandQuery("api endpoint")).toBe("api endpoint");
+    });
+    it("expands query with prompt keywords", () => {
+        const result = expandQuery("database", "user authentication implementation");
+        expect(result).toContain("database");
+        expect(result).toContain("user");
+        expect(result).toContain("auth");
+    });
+    it("expands known keywords", () => {
+        const result = expandQuery("auth", "login system");
+        expect(result).toContain("auth");
+        expect(result).toContain("login");
+        expect(result).toContain("password");
+    });
+    it("limits to 10 keywords", () => {
+        const result = expandQuery("api", "building a rest endpoint with controller and route handling");
+        const words = result.split(" ");
+        expect(words.length).toBeLessThanOrEqual(10);
+    });
+    it("removes duplicates", () => {
+        const result = expandQuery("database", "database query optimization");
+        const words = result.split(" ");
+        const unique = new Set(words);
+        expect(words.length).toBe(unique.size);
+    });
+    it("handles empty prompt gracefully", () => {
+        expect(expandQuery("test", "")).toBe("test");
+    });
+});
+//# sourceMappingURL=query-expander.test.js.map

package/dist/utils/query-expander.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-expander.test.js","sourceRoot":"","sources":["../../src/utils/query-expander.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjD,MAAM,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,EAAE,oCAAoC,CAAC,CAAC;QAC7E,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,6DAA6D,CAAC,CAAC;QACjG,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAC5B,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,EAAE,6BAA6B,CAAC,CAAC;QACtE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/docs/PRD.md

@@ -0,0 +1,199 @@
+# PRD – MCP Local Memory Service
+
+## TL;DR
+
+Membangun **MCP Local Memory Service** berbasis Node.js yang menyediakan *long-term, high-signal memory* untuk coding copilot & antigravity agent. Sistem ini menyimpan keputusan, fakta kode, kesalahan, dan pola penting menggunakan SQLite + vector similarity search, sehingga agent tetap konsisten, tidak mengulang kesalahan, dan tahan terhadap typo / variasi query.
+
+---
+
+## Problem Statement
+
+Coding copilot dan agent saat ini:
+- Mudah kehilangan konteks keputusan sebelumnya
+- Mengulang kesalahan yang sama
+- Overfit ke prompt terakhir (*gravity problem*)
+- Lemah terhadap typo atau phrasing berbeda
+
+Tanpa memory terstruktur, agent terasa "pintar sesaat" tapi tidak reliable untuk penggunaan jangka panjang.
+
+---
+
+## Goals
+
+### Business Goals
+- Meningkatkan kualitas dan konsistensi output coding copilot
+- Mengurangi user correction berulang
+- Menjadikan agent usable untuk long-running projects
+
+### User Goals
+- Agent mengingat keputusan & constraint penting
+- Agent tidak mengulang kesalahan lama
+- Agent tetap relevan walau prompt berubah atau typo
+
+### Non-Goals
+- Bukan chat history logger
+- Bukan audit trail
+- Tidak mendukung distributed / cloud sync (local-first)
+
+---
+
+## Target Users
+- Developer menggunakan coding copilot lokal
+- Power user / engineer yang menginginkan agent “punya ingatan”
+- Pengguna MCP-based agent system
+
+---
+
+## User Stories
+1. **Sebagai developer**, saya ingin agent mengingat keputusan arsitektur agar tidak perlu menjelaskannya berulang kali.
+2. **Sebagai developer**, saya ingin agent tidak mengulang kesalahan yang sudah saya koreksi sebelumnya.
+3. **Sebagai developer**, saya ingin agent tetap menemukan memory relevan walau saya salah ketik atau pakai istilah berbeda.
+4. **Sebagai agent**, saya ingin memory yang ringkas dan relevan agar tidak membanjiri prompt.
+
+---
+
+## Memory Types (Core Concept)
+
+### 1. code_fact
+Fakta stabil tentang codebase.
+*Contoh:*
+- Project pakai clean architecture
+- Semua API pakai zod validation
+
+### 2. decision
+Keputusan desain atau arsitektur.
+*Contoh:*
+- Tidak menggunakan ORM
+- Menggunakan raw SQL demi performa
+
+### 3. mistake
+Kesalahan yang tidak boleh diulang.
+*Contoh:*
+- Jangan pakai default export
+- Jangan gunakan `any` di domain layer
+
+### 4. pattern
+Pola kode atau konvensi yang sering dipakai.
+*Contoh:*
+- Struktur handler
+- Pola error handling
+
+---
+
+## User Experience (End-to-End Flow)
+
+### 1. Normal Interaction
+1. User meminta agent generate / modify code
+2. Agent membaca project summary (jika ada)
+3. Agent mencari memory relevan via semantic search
+4. Memory terpilih diinjeksi ke prompt
+5. Agent menghasilkan code sesuai constraint
+
+### 2. Memory Creation Flow
+1. User memberi constraint / koreksi penting
+2. Agent mendeteksi sinyal *memory-worthy*
+3. Agent menyimpan memory via MCP tool
+4. Agent (opsional) update project summary
+
+---
+
+## Narrative (Executive Story)
+
+Bayangkan seorang developer bekerja di codebase selama berminggu-minggu. Ia sudah menetapkan aturan: arsitektur tertentu, larangan tertentu, dan pola kode yang disepakati.
+
+Tanpa memory, setiap hari agent kembali seperti "intern baru" — pintar, tapi lupa segalanya.
+
+Dengan **MCP Local Memory Service**, agent berubah menjadi rekan tim yang belajar:
+- Mengingat keputusan
+- Menghindari kesalahan lama
+- Berpikir di level arsitektur
+
+Ini bukan soal membuat agent lebih pintar — tapi membuatnya lebih dapat dipercaya.
+
+---
+
+## Functional Requirements
+
+### Memory Storage
+- Menyimpan memory bertipe: `code_fact`, `decision`, `mistake`, `pattern`
+- Mendukung metadata scope (repo, language, folder)
+- Mendukung importance score (1–5)
+
+### Memory Retrieval
+- Semantic similarity search (vector-based)
+- Tahan typo & variasi bahasa
+- Mendukung filtering by type, scope, importance
+
+### Memory Summary
+- Ringkasan high-level per repo
+- Digunakan sebagai *antigravity anchor*
+
+---
+
+## MCP Interface
+
+### Resources
+- `memory://entries`
+- `memory://summary`
+
+### Tools
+- `memory.search`
+- `memory.store`
+- `memory.summarize`
+
+Agent tidak mengetahui detail database atau vector engine.
+
+---
+
+## Success Metrics
+
+### Quantitative
+- Penurunan jumlah user correction berulang
+- Peningkatan reuse memory dalam prompt
+- Latency memory search < 100ms (local)
+
+### Qualitative
+- Agent terasa konsisten
+- Agent tidak mengulang kesalahan lama
+- User trust meningkat
+
+---
+
+## Technical Considerations
+- Node.js MCP server
+- SQLite sebagai primary storage
+- Vector similarity via sqlite extension atau embedded index
+- Local embedding model (via Ollama / llama.cpp)
+- Normalization layer untuk typo handling
+
+---
+
+## Milestones & Sequencing
+1. MCP contract & interface definition (XX weeks)
+2. SQLite schema + vector indexing (XX weeks)
+3. Memory search & ranking logic (XX weeks)
+4. Agent prompt integration (XX weeks)
+5. Heuristic-based auto memory rules (XX weeks)
+
+---
+
+## Risks & Mitigations
+- **Risk: Memory pollution**
+  - *Mitigasi:* strict store rules + importance threshold
+- **Risk: Prompt bloat**
+  - *Mitigasi:* limit memory injection + summary usage
+- **Risk: Overfitting memory**
+  - *Mitigasi:* relevance threshold + scope filtering
+
+---
+
+## Open Questions
+- Perlu manual memory deletion UI?
+- Perlu memory versioning?
+- Perlu cross-repo inference di masa depan?
+
+---
+
+## Final Take
+Produk ini bukan tentang database atau vector search.
+Ini tentang mendisiplinkan ingatan agent agar ia benar-benar berguna untuk kerja nyata.