smart-claude-memory-mcp 2.1.0

package/dist/tools/search.js

@@ -0,0 +1,189 @@
+import { embed } from "../ollama.js";
+import { supabase, searchChunks, listBacklog, listArchive, } from "../supabase.js";
+import { currentProjectId } from "../project.js";
+/** Pure-number queries (e.g. "11468") -> direct SQL fetch by id. Bypasses
+ *  vector ranking, which can fail to surface a known row when its embedding
+ *  is squeezed out of top-K by stronger lexical neighbors in a 7k+ row set.
+ *  Dual-scope is enforced at the app layer: project_id IN (current, GLOBAL?). */
+const ID_PATTERN = /^\s*(\d{1,12})\s*$/;
+/** Sovereign Decision-ID handles like SCM-S15-D1 or SCM-S15-D1-GLOBAL.
+ *  Routed through metadata.context_id @> match (no vector embedding). */
+const CONTEXT_ID_PATTERN = /^\s*(SCM-S\d+-D\d+(?:-GLOBAL)?)\s*$/i;
+/** Narrow patterns for queries that unambiguously ask for the ARCHIVE. */
+const ARCHIVE_PATTERNS = [
+    /\barchive[sd]?\b/i,
+    /\bcompleted\s+tasks?\b/i,
+    /\bdone\s+tasks?\b/i,
+    /\bfinished\s+tasks?\b/i,
+    /\bpast\s+tasks?\b/i,
+];
+/** Narrow patterns for queries that ask for the ACTIVE backlog. */
+const BACKLOG_PATTERNS = [
+    /\b(active|pending|current|my|open)\s+backlog\b/i,
+    /\bbacklog\s+(tasks?|items?|list|snapshot)\b/i,
+    /^\s*backlog\s*$/i,
+    /^\s*pending\s+tasks?\s*$/i,
+    /^\s*what'?s?\s+next\??\s*$/i,
+];
+function matches(patterns, q) {
+    return patterns.some((re) => re.test(q));
+}
+function sortByPriorityThenAge(rows) {
+    return [...rows].sort((a, b) => a.priority - b.priority || Date.parse(a.created_at) - Date.parse(b.created_at));
+}
+export async function searchMemory(args) {
+    const projectId = args.project_id ?? currentProjectId;
+    const limit = args.limit ?? 5;
+    // Default behavior: dual-scope across the current project AND the reserved
+    // 'GLOBAL' bucket. Pass include_global:false to restrict to project_id only.
+    const includeGlobal = args.include_global ?? true;
+    // Precedence: id > context_id > archive > backlog > semantic.
+    //
+    // ID fallthrough — a query that is JUST a number is almost certainly a
+    // direct lookup ("show me row 11468"), not a semantic ask. Vector ranking
+    // on numeric tokens is meaningless and can hide rows whose neighbors won
+    // the cosine race. Direct SQL fetch is exact and respects dual-scope
+    // (current project_id OR 'GLOBAL' when include_global is true).
+    const idMatch = args.query.match(ID_PATTERN);
+    if (idMatch) {
+        const id = Number(idMatch[1]);
+        const projectFilter = includeGlobal
+            ? `project_id.eq.${projectId},project_id.eq.GLOBAL`
+            : `project_id.eq.${projectId}`;
+        const { data, error } = await supabase
+            .from("memory_chunks")
+            .select("id, content, file_origin, chunk_index, metadata, project_id")
+            .eq("id", id)
+            .or(projectFilter)
+            .limit(1);
+        if (error) {
+            throw new Error(`Supabase id-lookup failed: ${error.message}`);
+        }
+        const rows = (data ?? []);
+        return {
+            project_id: projectId,
+            query: args.query,
+            mode: "id",
+            include_global: includeGlobal,
+            count: rows.length,
+            results: rows.map((r) => ({
+                id: r.id,
+                content: r.content,
+                file_origin: r.file_origin,
+                chunk_index: r.chunk_index,
+                metadata: r.metadata,
+                similarity: 1.0,
+                project_id: r.project_id,
+            })),
+        };
+    }
+    // Context-ID fallthrough — Sovereign Decision IDs like "SCM-S15-D1" or
+    // "SCM-S15-D1-GLOBAL". Use metadata.context_id @> containment (uses GIN)
+    // so the lookup is exact, dual-scope-aware, and never embedding-bottlenecked.
+    const ctxMatch = args.query.match(CONTEXT_ID_PATTERN);
+    if (ctxMatch) {
+        const contextId = ctxMatch[1];
+        const projectFilter = includeGlobal
+            ? `project_id.eq.${projectId},project_id.eq.GLOBAL`
+            : `project_id.eq.${projectId}`;
+        const { data, error } = await supabase
+            .from("memory_chunks")
+            .select("id, content, file_origin, chunk_index, metadata, project_id")
+            .contains("metadata", { context_id: contextId })
+            .or(projectFilter)
+            .limit(Math.max(limit, 5));
+        if (error) {
+            throw new Error(`Supabase context_id-lookup failed: ${error.message}`);
+        }
+        const rows = (data ?? []);
+        return {
+            project_id: projectId,
+            query: args.query,
+            mode: "context_id",
+            include_global: includeGlobal,
+            count: rows.length,
+            results: rows.map((r) => ({
+                id: r.id,
+                content: r.content,
+                file_origin: r.file_origin,
+                chunk_index: r.chunk_index,
+                metadata: r.metadata,
+                similarity: 1.0,
+                project_id: r.project_id,
+            })),
+        };
+    }
+    if (matches(ARCHIVE_PATTERNS, args.query)) {
+        const rows = await listArchive(projectId, { limit: Math.max(limit, 20) });
+        const summary = rows.length === 0
+            ? "Archive is empty for this project."
+            : `${rows.length} archived task${rows.length === 1 ? "" : "s"}. Most recent: "${rows[0].title}" (archived ${rows[0].archived_at}).`;
+        return {
+            project_id: projectId,
+            query: args.query,
+            mode: "archive",
+            count: rows.length,
+            results: [],
+            archive: rows.map((t) => ({
+                id: t.id,
+                cloud_backlog_id: t.cloud_backlog_id,
+                title: t.title,
+                status: t.status,
+                priority: t.priority,
+                notes: t.notes,
+                created_at: t.created_at,
+                archived_at: t.archived_at,
+            })),
+            summary,
+        };
+    }
+    if (matches(BACKLOG_PATTERNS, args.query)) {
+        const [inProg, todo, blocked] = await Promise.all([
+            listBacklog(projectId, { status: "in_progress" }),
+            listBacklog(projectId, { status: "todo" }),
+            listBacklog(projectId, { status: "blocked" }),
+        ]);
+        const active = sortByPriorityThenAge([...inProg, ...todo, ...blocked]);
+        const top = active.slice(0, Math.max(limit, 20));
+        const head = active[0];
+        const summary = active.length === 0
+            ? "Backlog is empty for this project."
+            : `${active.length} active task${active.length === 1 ? "" : "s"}. ` +
+                `Next: [P${head.priority}] ${head.title} (${head.status}).`;
+        return {
+            project_id: projectId,
+            query: args.query,
+            mode: "backlog",
+            count: top.length,
+            results: [],
+            backlog: top.map((t) => ({
+                id: t.id,
+                title: t.title,
+                status: t.status,
+                priority: t.priority,
+                notes: t.notes,
+                created_at: t.created_at,
+            })),
+            summary,
+        };
+    }
+    // Default semantic path. Archived backlog rows are NEVER mixed into
+    // semantic results — they live in a different table and only surface via
+    // the archive-intent fast path above.
+    //
+    // `metadata_filter` (when present) flows through to match_memory_chunks's
+    // `p_metadata_filter` arg — the GIN(jsonb_path_ops) index narrows the
+    // candidate set BEFORE pgvector ranks. Project-id filtering is structural
+    // at the SQL level (first WHERE predicate) and is never relaxed.
+    const [queryVec] = await embed([args.query]);
+    const results = await searchChunks(projectId, queryVec, limit, args.min_similarity ?? 0.0, args.metadata_filter ?? null, includeGlobal);
+    return {
+        project_id: projectId,
+        query: args.query,
+        mode: "semantic",
+        include_global: includeGlobal,
+        count: results.length,
+        results,
+    };
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

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