super-memory-pro 0.2.0

package/dist/memory/processor.js

@@ -0,0 +1,199 @@
+// ─── Memory Processor ──────────────────────────────────────────────────────
+// Orchestrator that combines extraction, storage, and search.
+// This is the primary entry point for the memory system.
+import { extractTechStack, extractDecisions, extractUserPreferences, extractPatterns, classifyContent, } from './extractor.js';
+import { storeMemories } from './store.js';
+import { searchRelevantMemories, formatMemoriesForPrompt } from './search.js';
+// ─── Constants ─────────────────────────────────────────────────────────────
+const DEFAULT_MAX_INJECTIONS = 5;
+/**
+ * Process a message: extract patterns → classify → store memories.
+ *
+ * This is the main pipeline for ingesting a message into the memory system.
+ * It runs all extractors in parallel, classifies the content, and persists
+ * everything atomically (each memory independently — partial failures are
+ * tolerated).
+ *
+ * Extraction steps:
+ * 1. Tech stack mentions → tech_stack memories
+ * 2. Decisions → decision memories
+ * 3. User preferences → user_profile memories
+ * 4. Workflow patterns → pattern memories
+ * 5. Content classification → appropriate type memory
+ *
+ * @param content  - The message text to process
+ * @param metadata - Session / project / source context
+ * @returns        - All memories created or updated
+ */
+export async function processMessage(content, metadata) {
+    if (!content || content.trim().length === 0) {
+        return [];
+    }
+    const { sessionId, projectId, source } = metadata;
+    try {
+        // Step 1: Run all extractors
+        const [techStack, decisions, preferences, patterns] = await Promise.all([
+            safeExtract(() => extractTechStack(content)),
+            safeExtract(() => extractDecisions(content)),
+            safeExtract(() => extractUserPreferences(content)),
+            safeExtract(() => extractPatterns(content)),
+        ]);
+        // Step 2: Classify content
+        const memoryType = classifyContent(content);
+        // Step 3: Build memory payloads
+        const memoryPayloads = [];
+        // 3a. Tech stack
+        if (techStack.length > 0) {
+            for (const tech of techStack) {
+                memoryPayloads.push({
+                    memory_type: 'tech_stack',
+                    project_id: projectId ?? null,
+                    session_id: sessionId ?? null,
+                    key: `tech:${tech.toLowerCase().replace(/[^a-z0-9.#]/g, '_')}`,
+                    content: `Project uses ${tech}`,
+                    importance: 4,
+                    source: source ?? 'processor',
+                    metadata: { technology: tech, extracted: true },
+                });
+            }
+        }
+        // 3b. Decisions
+        for (const d of decisions) {
+            memoryPayloads.push({
+                memory_type: 'decision',
+                project_id: projectId ?? null,
+                session_id: sessionId ?? null,
+                key: `decision:${normalizeKeyFragment(d.decision)}`,
+                content: d.decision,
+                importance: 4,
+                source: source ?? 'processor',
+                metadata: { context: d.context, extracted: true },
+            });
+        }
+        // 3c. Preferences
+        for (const pref of preferences) {
+            memoryPayloads.push({
+                memory_type: 'user_profile',
+                project_id: projectId ?? null,
+                session_id: sessionId ?? null,
+                key: `preference:${normalizeKeyFragment(pref)}`,
+                content: pref,
+                importance: 3,
+                source: source ?? 'processor',
+                metadata: { extracted: true },
+            });
+        }
+        // 3d. Patterns
+        for (const pat of patterns) {
+            memoryPayloads.push({
+                memory_type: 'pattern',
+                project_id: projectId ?? null,
+                session_id: sessionId ?? null,
+                key: `pattern:${normalizeKeyFragment(pat)}`,
+                content: pat,
+                importance: 2,
+                source: source ?? 'processor',
+                metadata: { extracted: true },
+            });
+        }
+        // 3e. Classified content — store the whole message
+        if (content.trim().length > 10) {
+            memoryPayloads.push({
+                memory_type: memoryType,
+                project_id: projectId ?? null,
+                session_id: sessionId ?? null,
+                key: `msg:${memoryType}:${createContentHash(content)}`,
+                content: content.trim(),
+                importance: 3,
+                source: source ?? 'processor',
+                metadata: {
+                    classified_as: memoryType,
+                    tech_stack: techStack,
+                    decisions_count: decisions.length,
+                    preferences_count: preferences.length,
+                    patterns_count: patterns.length,
+                },
+            });
+        }
+        // Step 4: Store all memories (parallel upsert)
+        if (memoryPayloads.length === 0)
+            return [];
+        return storeMemories(memoryPayloads);
+    }
+    catch (err) {
+        console.error('[UltraMemory] processMessage: unexpected error', err);
+        return [];
+    }
+}
+/**
+ * Get relevant context for a query as formatted prompt text.
+ *
+ * Searches the memory store for relevant records, formats them as
+ * structured markdown, and returns a string suitable for injection
+ * into an LLM system prompt.
+ *
+ * @param query   - The query to find context for
+ * @param options - Optional filters and limits
+ * @returns       - Formatted context string (empty if nothing relevant)
+ */
+export async function getContextForQuery(query, options) {
+    if (!query || query.trim().length === 0) {
+        return '';
+    }
+    const maxInjections = options?.maxInjections ?? DEFAULT_MAX_INJECTIONS;
+    try {
+        const results = await searchRelevantMemories(query, {
+            types: options?.types,
+            projectId: options?.projectId,
+            limit: maxInjections,
+            minImportance: options?.minImportance,
+        });
+        if (results.length === 0)
+            return '';
+        return formatMemoriesForPrompt(results);
+    }
+    catch (err) {
+        console.error('[UltraMemory] getContextForQuery: search failed', err);
+        return '';
+    }
+}
+// ─── Internal Helpers ──────────────────────────────────────────────────────
+/**
+ * Safely run an extractor; returns empty result on failure.
+ */
+function safeExtract(fn) {
+    try {
+        return fn();
+    }
+    catch (err) {
+        console.error('[UltraMemory] extractor failed:', err);
+        return [];
+    }
+}
+/**
+ * Create a stable content hash for deduplication keys.
+ * Uses a simple djb2 hash — not cryptographic, just good enough
+ * for stable key generation.
+ */
+function createContentHash(content) {
+    let hash = 5381;
+    const normalized = content.toLowerCase().trim();
+    for (let i = 0; i < normalized.length; i++) {
+        hash = ((hash << 5) + hash + normalized.charCodeAt(i)) & 0xffffffff;
+    }
+    return Math.abs(hash).toString(36);
+}
+/**
+ * Normalize a text fragment into a stable key suffix.
+ * Lowercases, collapses whitespace, strips special characters,
+ * and truncates to 60 chars.
+ */
+function normalizeKeyFragment(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, ' ')
+        .replace(/\s+/g, '_')
+        .replace(/^_+|_+$/g, '')
+        .slice(0, 60);
+}
+//# sourceMappingURL=processor.js.map

package/dist/memory/processor.js.map

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

package/dist/memory/search.d.ts

@@ -0,0 +1,35 @@
+import type { MemorySearchResult, MemoryType } from '../types.js';
+export interface SearchOptions {
+    /** Filter by specific memory types */
+    types?: MemoryType[];
+    /** Scope to a specific project */
+    projectId?: string;
+    /** Maximum results to return (default: 10) */
+    limit?: number;
+    /** Minimum importance threshold (1-5, default: 1) */
+    minImportance?: number;
+    /** Minimum relevance score threshold (0.0-1.0, default: 0) */
+    minRelevance?: number;
+}
+/**
+ * Search for memories relevant to the given query.
+ *
+ * Delegates to the DB full-text search engine and layers on client-side
+ * importance/relevance filtering. Tracks access for LRU eviction.
+ *
+ * @param query   - Natural-language search text
+ * @param options - Optional filters and limits
+ * @returns       - Ranked memory search results
+ */
+export declare function searchRelevantMemories(query: string, options?: SearchOptions): Promise<MemorySearchResult[]>;
+/**
+ * Format memories as structured text for system prompt injection.
+ *
+ * Produces clean, hierarchical markdown grouped by memory type.
+ * Each entry includes its importance level and key content.
+ *
+ * @param memories - Search results to format
+ * @returns        - Formatted markdown string (empty string if no memories)
+ */
+export declare function formatMemoriesForPrompt(memories: MemorySearchResult[]): string;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/memory/search.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKlE,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAiC/B;AA0DD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAqD9E"}

package/dist/memory/search.js

@@ -0,0 +1,170 @@
+// ─── Memory Search & Prompt Formatting ─────────────────────────────────────
+// Retrieves relevant memories and formats them for LLM prompt injection.
+import { searchMemories, recordMemoryAccess } from '../db/queries.js';
+/**
+ * Search for memories relevant to the given query.
+ *
+ * Delegates to the DB full-text search engine and layers on client-side
+ * importance/relevance filtering. Tracks access for LRU eviction.
+ *
+ * @param query   - Natural-language search text
+ * @param options - Optional filters and limits
+ * @returns       - Ranked memory search results
+ */
+export async function searchRelevantMemories(query, options) {
+    if (!query || query.trim().length === 0) {
+        return [];
+    }
+    const results = await searchMemories({
+        query: query.trim(),
+        types: options?.types,
+        project_id: options?.projectId,
+        limit: (options?.limit ?? 10) * 2, // Fetch extra for post-filtering
+        offset: 0,
+    });
+    // Apply client-side filters
+    let filtered = results;
+    if (options?.minImportance !== undefined && options.minImportance > 1) {
+        filtered = filtered.filter((r) => r.memory.importance >= options.minImportance);
+    }
+    if (options?.minRelevance !== undefined && options.minRelevance > 0) {
+        filtered = filtered.filter((r) => r.relevance >= options.minRelevance);
+    }
+    // Respect limit exactly
+    const limited = filtered.slice(0, options?.limit ?? 10);
+    // Track access for LRU without blocking the response
+    if (limited.length > 0) {
+        trackMemoryAccess(limited).catch(() => { });
+    }
+    return limited;
+}
+function groupByType(memories) {
+    const grouped = {
+        tech_stack: [],
+        decision: [],
+        user_profile: [],
+        pattern: [],
+        project_context: [],
+        explicit: [],
+        session: [],
+        other: [],
+    };
+    for (const m of memories) {
+        switch (m.memory.memory_type) {
+            case 'tech_stack':
+                grouped.tech_stack.push(m);
+                break;
+            case 'decision':
+                grouped.decision.push(m);
+                break;
+            case 'user_profile':
+                grouped.user_profile.push(m);
+                break;
+            case 'pattern':
+                grouped.pattern.push(m);
+                break;
+            case 'project_context':
+                grouped.project_context.push(m);
+                break;
+            case 'explicit':
+                grouped.explicit.push(m);
+                break;
+            case 'session':
+                grouped.session.push(m);
+                break;
+            default:
+                grouped.other.push(m);
+                break;
+        }
+    }
+    return grouped;
+}
+/** Type label for display in prompt injection text. */
+const TYPE_LABELS = {
+    tech_stack: 'Tech Stack',
+    decision: 'Decisions',
+    user_profile: 'User Preferences',
+    pattern: 'Workflow Patterns',
+    project_context: 'Project Context',
+    explicit: 'Saved Notes',
+    session: 'Session History',
+    other: 'Other Context',
+};
+/**
+ * Format memories as structured text for system prompt injection.
+ *
+ * Produces clean, hierarchical markdown grouped by memory type.
+ * Each entry includes its importance level and key content.
+ *
+ * @param memories - Search results to format
+ * @returns        - Formatted markdown string (empty string if no memories)
+ */
+export function formatMemoriesForPrompt(memories) {
+    if (memories.length === 0)
+        return '';
+    const grouped = groupByType(memories);
+    const sections = ['## Relevant Context'];
+    // Ordered groups by relevance/importance
+    const groupOrder = [
+        'explicit',
+        'tech_stack',
+        'decision',
+        'user_profile',
+        'project_context',
+        'pattern',
+        'session',
+        'other',
+    ];
+    for (const key of groupOrder) {
+        const items = grouped[key];
+        if (items.length === 0)
+            continue;
+        const label = TYPE_LABELS[key] ?? key;
+        sections.push('');
+        sections.push(`### ${label}`);
+        if (key === 'tech_stack') {
+            // Compact inline format for tech
+            const techList = items
+                .map((r) => r.memory.content || r.memory.key.replace(/^tech:/, ''))
+                .filter(Boolean);
+            sections.push(techList.map((t) => `- ${t}`).join('\n'));
+        }
+        else if (key === 'decision') {
+            for (const item of items) {
+                const mem = item.memory;
+                const imp = importanceBadge(mem.importance);
+                const val = mem.value;
+                const ctx = val?.context;
+                sections.push(`- ${mem.content}${imp}`);
+                if (ctx) {
+                    sections.push(`  - Context: ${ctx}`);
+                }
+            }
+        }
+        else {
+            for (const item of items) {
+                const mem = item.memory;
+                const imp = importanceBadge(mem.importance);
+                sections.push(`- ${mem.content}${imp}`);
+            }
+        }
+    }
+    return sections.join('\n');
+}
+// ─── Internal Helpers ──────────────────────────────────────────────────────
+/** Format importance as a human-readable badge. */
+function importanceBadge(level) {
+    if (level >= 5)
+        return ' *(high importance)*';
+    if (level >= 4)
+        return '';
+    if (level <= 2)
+        return ' *(minor)*';
+    return '';
+}
+/** Non-blocking access tracking for LRU. */
+async function trackMemoryAccess(results) {
+    const ids = results.map((r) => r.memory.id);
+    await Promise.allSettled(ids.map((id) => recordMemoryAccess(id)));
+}
+//# sourceMappingURL=search.js.map

package/dist/memory/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/memory/search.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,yEAAyE;AAGzE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAiBtE;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAAa,EACb,OAAuB;IAEvB,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC;QACnC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;QACnB,KAAK,EAAE,OAAO,EAAE,KAAK;QACrB,UAAU,EAAE,OAAO,EAAE,SAAS;QAC9B,KAAK,EAAE,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,iCAAiC;QACpE,MAAM,EAAE,CAAC;KACV,CAAC,CAAC;IAEH,4BAA4B;IAC5B,IAAI,QAAQ,GAAG,OAAO,CAAC;IAEvB,IAAI,OAAO,EAAE,aAAa,KAAK,SAAS,IAAI,OAAO,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;QACtE,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,IAAI,OAAO,CAAC,aAAc,CAAC,CAAC;IACnF,CAAC;IAED,IAAI,OAAO,EAAE,YAAY,KAAK,SAAS,IAAI,OAAO,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;QACpE,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,OAAO,CAAC,YAAa,CAAC,CAAC;IAC1E,CAAC;IAED,wBAAwB;IACxB,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IAExD,qDAAqD;IACrD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,iBAAiB,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAsB,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAkBD,SAAS,WAAW,CAAC,QAA8B;IACjD,MAAM,OAAO,GAAoB;QAC/B,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,EAAE;QAChB,OAAO,EAAE,EAAE;QACX,eAAe,EAAE,EAAE;QACnB,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,EAAE;KACV,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,QAAQ,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YAC7B,KAAK,YAAY;gBAAK,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAAC,MAAM;YACxD,KAAK,UAAU;gBAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAAC,MAAM;YACtD,KAAK,cAAc;gBAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAAC,MAAM;YAC1D,KAAK,SAAS;gBAAQ,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAAC,MAAM;YACrD,KAAK,iBAAiB;gBAAE,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAAC,MAAM;YAC/D,KAAK,UAAU;gBAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAAC,MAAM;YACtD,KAAK,SAAS;gBAAQ,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAAC,MAAM;YACrD;gBAAsB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAAC,MAAM;QACrD,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,uDAAuD;AACvD,MAAM,WAAW,GAA2B;IAC1C,UAAU,EAAE,YAAY;IACxB,QAAQ,EAAE,WAAW;IACrB,YAAY,EAAE,kBAAkB;IAChC,OAAO,EAAE,mBAAmB;IAC5B,eAAe,EAAE,iBAAiB;IAClC,QAAQ,EAAE,aAAa;IACvB,OAAO,EAAE,iBAAiB;IAC1B,KAAK,EAAE,eAAe;CACvB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAA8B;IACpE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAErC,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAa,CAAC,qBAAqB,CAAC,CAAC;IAEnD,yCAAyC;IACzC,MAAM,UAAU,GAA8B;QAC5C,UAAU;QACV,YAAY;QACZ,UAAU;QACV,cAAc;QACd,iBAAiB;QACjB,SAAS;QACT,SAAS;QACT,OAAO;KACR,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEjC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;QACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC;QAE9B,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;YACzB,iCAAiC;YACjC,MAAM,QAAQ,GAAG,KAAK;iBACnB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;iBAClE,MAAM,CAAC,OAAO,CAAC,CAAC;YACnB,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1D,CAAC;aAAM,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;YAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;gBACxB,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBAC5C,MAAM,GAAG,GAAG,GAAG,CAAC,KAA4C,CAAC;gBAC7D,MAAM,GAAG,GAAG,GAAG,EAAE,OAA6B,CAAC;gBAC/C,QAAQ,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,CAAC;gBACxC,IAAI,GAAG,EAAE,CAAC;oBACR,QAAQ,CAAC,IAAI,CAAC,gBAAgB,GAAG,EAAE,CAAC,CAAC;gBACvC,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;gBACxB,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBAC5C,QAAQ,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,8EAA8E;AAE9E,mDAAmD;AACnD,SAAS,eAAe,CAAC,KAAa;IACpC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,sBAAsB,CAAC;IAC9C,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAC1B,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,YAAY,CAAC;IACpC,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,4CAA4C;AAC5C,KAAK,UAAU,iBAAiB,CAAC,OAA6B;IAC5D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC5C,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/memory/store.d.ts

@@ -0,0 +1,32 @@
+import type pg from 'pg';
+import type { MemoryCreate, MemoryRecord } from '../types.js';
+/**
+ * Store a memory record with automatic deduplication.
+ *
+ * Uses `createMemory` from queries.ts which performs an upsert on
+ * `(memory_type, project_id, key)`. When no explicit `key` is given,
+ * one is generated from the content to enable stable deduplication.
+ *
+ * @param data  - Memory data to persist
+ * @param pool  - Optional pg.Pool for transaction support
+ * @returns     - The stored/updated MemoryRecord
+ */
+export declare function storeMemory(data: MemoryCreate, pool?: pg.Pool): Promise<MemoryRecord>;
+/**
+ * Store multiple memory records in parallel.
+ * Each entry is independently upserted — a failure in one does not
+ * affect the others.
+ *
+ * @param data  - Array of memory data to persist
+ * @returns     - Array of stored MemoryRecords
+ */
+export declare function storeMemories(data: MemoryCreate[]): Promise<MemoryRecord[]>;
+/**
+ * Convenience: store tech-stack entries with the correct type and key prefix.
+ */
+export declare function storeTechStack(technologies: string[], metadata: {
+    projectId?: string;
+    sessionId?: string;
+    source?: string;
+}): Promise<MemoryRecord[]>;
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/memory/store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAc,MAAM,aAAa,CAAC;AAgC1E;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,YAAY,EAClB,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,GACb,OAAO,CAAC,YAAY,CAAC,CAsCvB;AAID;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAejF;AAID;;GAEG;AACH,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EAAE,EACtB,QAAQ,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACpE,OAAO,CAAC,YAAY,EAAE,CAAC,CAezB"}

package/dist/memory/store.js

@@ -0,0 +1,112 @@
+// ─── Memory Storage ────────────────────────────────────────────────────────
+// Stores extracted memories with deduplication via upsert.
+import { createMemory } from '../db/queries.js';
+// ─── Key Generation ────────────────────────────────────────────────────────
+/**
+ * Generate a stable deduplication key from content.
+ * Keys are normalised so identical or semantically similar content
+ * produces the same key, enabling upsert deduplication.
+ */
+function generateKey(content, type) {
+    const prefix = type ? `${type}:` : '';
+    // Lowercase, collapse whitespace, strip special chars
+    const normalized = content
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, ' ')
+        .replace(/\s+/g, '_')
+        .replace(/^_+|_+$/g, '')
+        .slice(0, 80);
+    if (!normalized) {
+        // Fallback: use a short timestamp-based key
+        return `${prefix}entry_${Date.now()}`;
+    }
+    return `${prefix}${normalized}`;
+}
+// ─── Single Store ──────────────────────────────────────────────────────────
+/**
+ * Store a memory record with automatic deduplication.
+ *
+ * Uses `createMemory` from queries.ts which performs an upsert on
+ * `(memory_type, project_id, key)`. When no explicit `key` is given,
+ * one is generated from the content to enable stable deduplication.
+ *
+ * @param data  - Memory data to persist
+ * @param pool  - Optional pg.Pool for transaction support
+ * @returns     - The stored/updated MemoryRecord
+ */
+export async function storeMemory(data, pool) {
+    // Ensure required fields
+    const memoryType = data.memory_type;
+    const key = data.key?.trim() || generateKey(data.content, memoryType);
+    // If a pool was provided, use it directly; otherwise queries.ts manages
+    // its own pool via getPool().
+    if (pool) {
+        const result = await pool.query(`INSERT INTO memories (memory_type, project_id, session_id, key, value, content, importance, source, metadata)
+       VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9)
+       ON CONFLICT (memory_type, project_id, key)
+       DO UPDATE SET
+         content = EXCLUDED.content,
+         importance = GREATEST(memories.importance, EXCLUDED.importance),
+         value = memories.value || EXCLUDED.value,
+         updated_at = NOW()
+       RETURNING *`, [
+            memoryType,
+            data.project_id ?? null,
+            data.session_id ?? null,
+            key,
+            JSON.stringify(data.value ?? {}),
+            data.content,
+            data.importance ?? 3,
+            data.source ?? 'auto',
+            JSON.stringify(data.metadata ?? {}),
+        ]);
+        return result.rows[0];
+    }
+    // No pool provided — delegate to queries.ts
+    return createMemory({
+        ...data,
+        key,
+    });
+}
+// ─── Batch Store ───────────────────────────────────────────────────────────
+/**
+ * Store multiple memory records in parallel.
+ * Each entry is independently upserted — a failure in one does not
+ * affect the others.
+ *
+ * @param data  - Array of memory data to persist
+ * @returns     - Array of stored MemoryRecords
+ */
+export async function storeMemories(data) {
+    if (data.length === 0)
+        return [];
+    const results = await Promise.allSettled(data.map((d) => storeMemory(d)));
+    return results.reduce((acc, r) => {
+        if (r.status === 'fulfilled') {
+            acc.push(r.value);
+        }
+        else {
+            console.error('[UltraMemory] storeMemories: failed to store memory', r.reason);
+        }
+        return acc;
+    }, []);
+}
+// ─── Tech-Stack Specific Store ─────────────────────────────────────────────
+/**
+ * Convenience: store tech-stack entries with the correct type and key prefix.
+ */
+export async function storeTechStack(technologies, metadata) {
+    if (technologies.length === 0)
+        return [];
+    return storeMemories(technologies.map((tech) => ({
+        memory_type: 'tech_stack',
+        project_id: metadata.projectId ?? null,
+        session_id: metadata.sessionId ?? null,
+        key: `tech:${tech.toLowerCase().replace(/[^a-z0-9.#]/g, '_')}`,
+        content: `Project uses ${tech}`,
+        importance: 4,
+        source: metadata.source ?? 'extractor',
+        metadata: { technology: tech, extracted: true },
+    })));
+}
+//# sourceMappingURL=store.js.map

package/dist/memory/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/memory/store.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,2DAA2D;AAI3D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,8EAA8E;AAE9E;;;;GAIG;AACH,SAAS,WAAW,CAAC,OAAe,EAAE,IAAiB;IACrD,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAEtC,sDAAsD;IACtD,MAAM,UAAU,GAAG,OAAO;SACvB,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEhB,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,4CAA4C;QAC5C,OAAO,GAAG,MAAM,SAAS,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IACxC,CAAC;IAED,OAAO,GAAG,MAAM,GAAG,UAAU,EAAE,CAAC;AAClC,CAAC;AAED,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAkB,EAClB,IAAc;IAEd,yBAAyB;IACzB,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAEtE,wEAAwE;IACxE,8BAA8B;IAC9B,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAC7B;;;;;;;;mBAQa,EACb;YACE,UAAU;YACV,IAAI,CAAC,UAAU,IAAI,IAAI;YACvB,IAAI,CAAC,UAAU,IAAI,IAAI;YACvB,GAAG;YACH,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YAChC,IAAI,CAAC,OAAO;YACZ,IAAI,CAAC,UAAU,IAAI,CAAC;YACpB,IAAI,CAAC,MAAM,IAAI,MAAM;YACrB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;SACpC,CACF,CAAC;QACF,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC;IACzB,CAAC;IAED,4CAA4C;IAC5C,OAAO,YAAY,CAAC;QAClB,GAAG,IAAI;QACP,GAAG;KACJ,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAoB;IACtD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAChC,CAAC;IAEF,OAAO,OAAO,CAAC,MAAM,CAAiB,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QAC/C,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAC7B,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,qDAAqD,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;QACjF,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC;AAED,8EAA8E;AAE9E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,YAAsB,EACtB,QAAqE;IAErE,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEzC,OAAO,aAAa,CAClB,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,WAAW,EAAE,YAA0B;QACvC,UAAU,EAAE,QAAQ,CAAC,SAAS,IAAI,IAAI;QACtC,UAAU,EAAE,QAAQ,CAAC,SAAS,IAAI,IAAI;QACtC,GAAG,EAAE,QAAQ,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,EAAE;QAC9D,OAAO,EAAE,gBAAgB,IAAI,EAAE;QAC/B,UAAU,EAAE,CAAC;QACb,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,WAAW;QACtC,QAAQ,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;KAChD,CAAC,CAAC,CACJ,CAAC;AACJ,CAAC"}

package/dist/server/index.d.ts

@@ -0,0 +1,16 @@
+import { type Express } from 'express';
+import type { PluginConfig } from '../types.js';
+/**
+ * Create and start the Ultra Memory HTTP API server.
+ *
+ * @param config - Plugin configuration (DB, server host/port, etc.)
+ * @returns `{ app, url, close }` — the Express app, its listening URL,
+ *          and an async `close()` function for graceful shutdown.
+ */
+export declare function createServer(config: PluginConfig): Promise<{
+    app: Express;
+    url: string;
+    close: () => Promise<void>;
+}>;
+export type { CreateMemoryInput, SearchQueryInput, UpdateMemoryInput } from './schemas.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAEhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMhD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CA4CpE;AAGD,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,49 @@
+import express from 'express';
+import { getPool, closePool } from '../db/connection.js';
+import { healthRouter } from './routes/health.js';
+import { memoryRouter } from './routes/memory.js';
+import { errorHandler } from './middleware/error-handler.js';
+/**
+ * Create and start the Ultra Memory HTTP API server.
+ *
+ * @param config - Plugin configuration (DB, server host/port, etc.)
+ * @returns `{ app, url, close }` — the Express app, its listening URL,
+ *          and an async `close()` function for graceful shutdown.
+ */
+export async function createServer(config) {
+    // Initialise the database connection pool before accepting requests
+    getPool(config);
+    const app = express();
+    // ── Global middleware ────────────────────────────────────────────────
+    app.use(express.json());
+    // ── Routes ──────────────────────────────────────────────────────────
+    app.use('/', healthRouter);
+    app.use('/api', memoryRouter);
+    // ── Error handler (must be last) ────────────────────────────────────
+    app.use(errorHandler);
+    // ── Start listening ─────────────────────────────────────────────────
+    const host = config.server.host;
+    const port = config.server.port;
+    let server;
+    const url = await new Promise((resolve, reject) => {
+        server = app.listen(port, host, () => {
+            const addr = server.address();
+            const actualPort = addr && typeof addr === 'object' ? addr.port : port;
+            const serverUrl = `http://${host}:${actualPort}`;
+            console.log(`[UltraMemory] Memory server listening on ${serverUrl}`);
+            resolve(serverUrl);
+        });
+        server.on('error', (err) => {
+            reject(err);
+        });
+    });
+    return {
+        app,
+        url,
+        close: async () => {
+            server.close();
+            await closePool();
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,OAAyB,MAAM,SAAS,CAAC;AAGhD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAoB;IAEpB,oEAAoE;IACpE,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhB,MAAM,GAAG,GAAY,OAAO,EAAE,CAAC;IAE/B,wEAAwE;IACxE,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAExB,uEAAuE;IACvE,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAC3B,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAE9B,uEAAuE;IACvE,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAEtB,uEAAuE;IACvE,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;IAChC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;IAEhC,IAAI,MAAc,CAAC;IAEnB,MAAM,GAAG,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxD,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE;YACnC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YAC9B,MAAM,UAAU,GACd,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;YACtD,MAAM,SAAS,GAAG,UAAU,IAAI,IAAI,UAAU,EAAE,CAAC;YACjD,OAAO,CAAC,GAAG,CAAC,4CAA4C,SAAS,EAAE,CAAC,CAAC;YACrE,OAAO,CAAC,SAAS,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;YAChC,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,GAAG;QACH,GAAG;QACH,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,SAAS,EAAE,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC"}