smart-claude-memory-mcp 2.1.0

package/dist/tools/hygiene.js

@@ -0,0 +1,309 @@
+import { readFile, stat } from "node:fs/promises";
+import { basename, dirname, extname, join } from "node:path";
+export const HARD_LIMIT = 750;
+// ─── exclusion list ──────────────────────────────────────────────────────
+// Auto-generated files that should never be subject to the line limit.
+const EXCLUDE_EXACT_BASENAMES = new Set([
+    "types.ts", // Supabase-generated types
+]);
+const EXCLUDE_SUFFIXES = [
+    ".arb", // Dart/Flutter localization bundles
+    ".l10n.dart", // Flutter l10n outputs
+    ".g.dart", // build_runner generated
+    ".freezed.dart", // freezed generated
+];
+export function isExcluded(path) {
+    const name = basename(path);
+    if (EXCLUDE_EXACT_BASENAMES.has(name))
+        return true;
+    for (const suf of EXCLUDE_SUFFIXES) {
+        if (name.toLowerCase().endsWith(suf))
+            return true;
+    }
+    return false;
+}
+const LANG_PARSERS = {
+    ts: parseTypeScriptLike,
+    tsx: parseTypeScriptLike,
+    js: parseTypeScriptLike,
+    jsx: parseTypeScriptLike,
+    py: parsePython,
+    dart: parseDart,
+};
+function extLang(path) {
+    return extname(path).replace(/^\./, "").toLowerCase();
+}
+function parseTypeScriptLike(text) {
+    const lines = text.split(/\r?\n/);
+    const re = /^(export\s+)?(default\s+)?(async\s+)?(function|class|const|let|var|type|interface|enum)\s+([A-Za-z_$][\w$]*)/;
+    const raw = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (/^\s/.test(line))
+            continue;
+        const m = line.match(re);
+        if (m) {
+            const kindRaw = m[4];
+            const kind = kindRaw === "function" || kindRaw === "class" || kindRaw === "type" ||
+                kindRaw === "interface" || kindRaw === "const" || kindRaw === "enum"
+                ? kindRaw
+                : "other";
+            raw.push({ name: m[5], kind, exported: !!m[1], start_line: i + 1 });
+        }
+    }
+    return finishSymbols(raw, lines.length);
+}
+function parsePython(text) {
+    const lines = text.split(/\r?\n/);
+    const re = /^(class|def|async\s+def)\s+([A-Za-z_][\w]*)/;
+    const raw = [];
+    for (let i = 0; i < lines.length; i++) {
+        if (/^\s/.test(lines[i]))
+            continue;
+        const m = lines[i].match(re);
+        if (m) {
+            raw.push({
+                name: m[2],
+                kind: m[1].startsWith("class") ? "class" : "function",
+                exported: true,
+                start_line: i + 1,
+            });
+        }
+    }
+    return finishSymbols(raw, lines.length);
+}
+function parseDart(text) {
+    const lines = text.split(/\r?\n/);
+    const re = /^(?:abstract\s+|final\s+|sealed\s+|mixin\s+|extension\s+)?(class|enum|mixin|typedef)\s+([A-Za-z_][\w]*)/;
+    const fnRe = /^(?:static\s+|final\s+|const\s+)?(?:[\w<>?,\s]+\s+)?([A-Za-z_][\w]*)\s*\(/;
+    const raw = [];
+    for (let i = 0; i < lines.length; i++) {
+        if (/^\s/.test(lines[i]))
+            continue;
+        const line = lines[i];
+        const mCls = line.match(re);
+        if (mCls) {
+            raw.push({
+                name: mCls[2],
+                kind: mCls[1] === "class" || mCls[1] === "mixin" ? "class" : "type",
+                exported: true,
+                start_line: i + 1,
+            });
+            continue;
+        }
+        const mFn = line.match(fnRe);
+        if (mFn && !["if", "for", "while", "switch", "return"].includes(mFn[1])) {
+            raw.push({ name: mFn[1], kind: "function", exported: true, start_line: i + 1 });
+        }
+    }
+    return finishSymbols(raw, lines.length);
+}
+function finishSymbols(raw, totalLines) {
+    return raw.map((s, i) => {
+        const end = i + 1 < raw.length ? raw[i + 1].start_line - 1 : totalLines;
+        return {
+            ...s,
+            end_line: end,
+            lines: end - s.start_line + 1,
+            bucket: classifyBucket(s.name, s.kind),
+        };
+    });
+}
+function classifyBucket(name, kind) {
+    if (kind === "type" || kind === "interface" || kind === "enum")
+        return "types";
+    const lower = name.toLowerCase();
+    if (/(util|helper|format|parse|normalize|validate|convert|serialize|deserialize|transform|assert|sanitize)/.test(lower)) {
+        return "utils";
+    }
+    if (/(service|manager|controller|handler|repository|store|provider|client|gateway|adapter)/.test(lower)) {
+        return "service";
+    }
+    return "main";
+}
+export function planRefactor(path, text) {
+    const currentLines = text.split(/\r?\n/).length;
+    const splitCount = Math.max(2, Math.ceil(currentLines / HARD_LIMIT));
+    const target = HARD_LIMIT;
+    const lang = extLang(path);
+    const parser = LANG_PARSERS[lang];
+    const base = basename(path, extname(path));
+    const dir = dirname(path);
+    const ext = extname(path);
+    if (!parser) {
+        return {
+            needed: true,
+            current_lines: currentLines,
+            target_limit: target,
+            split_count: splitCount,
+            suggested_files: [],
+            imports_to_add: [],
+            notes: [
+                `No symbol parser for '${lang}' files — provide the split plan manually.`,
+                `Target: split ${currentLines}-line file into ~${splitCount} files, each ≤ ${target} lines.`,
+            ],
+        };
+    }
+    const symbols = parser(text);
+    if (symbols.length === 0) {
+        return {
+            needed: true,
+            current_lines: currentLines,
+            target_limit: target,
+            split_count: splitCount,
+            suggested_files: [],
+            imports_to_add: [],
+            notes: [
+                `Parser found no top-level symbols in ${basename(path)}. Likely a monolithic script — split by logical sections manually.`,
+            ],
+        };
+    }
+    // Group by bucket, then further subdivide any bucket exceeding the limit.
+    const buckets = { main: [], types: [], utils: [], service: [] };
+    for (const s of symbols)
+        buckets[s.bucket].push(s);
+    const parts = [];
+    const bucketOrder = ["main", "service", "utils", "types"];
+    for (const b of bucketOrder) {
+        const group = buckets[b];
+        if (group.length === 0)
+            continue;
+        let current = [];
+        let running = 0;
+        for (const s of group) {
+            if (running + s.lines > target && current.length > 0) {
+                parts.push({ role: b, symbols: current, lines: running });
+                current = [];
+                running = 0;
+            }
+            current.push(s);
+            running += s.lines;
+        }
+        if (current.length > 0)
+            parts.push({ role: b, symbols: current, lines: running });
+    }
+    // Ensure at least splitCount parts. If heuristic produced fewer, sub-divide the biggest.
+    while (parts.length < splitCount) {
+        const biggest = parts
+            .map((p, i) => ({ i, size: p.lines, count: p.symbols.length }))
+            .filter((x) => x.count > 1)
+            .sort((a, b) => b.size - a.size)[0];
+        if (!biggest)
+            break;
+        const half = Math.floor(parts[biggest.i].symbols.length / 2);
+        const left = parts[biggest.i].symbols.slice(0, half);
+        const right = parts[biggest.i].symbols.slice(half);
+        const leftLines = left.reduce((s, x) => s + x.lines, 0);
+        const rightLines = right.reduce((s, x) => s + x.lines, 0);
+        parts.splice(biggest.i, 1, { role: parts[biggest.i].role, symbols: left, lines: leftLines }, { role: parts[biggest.i].role, symbols: right, lines: rightLines });
+    }
+    const roleCounts = { main: 0, types: 0, utils: 0, service: 0 };
+    const suggested = parts.map((p) => {
+        roleCounts[p.role] += 1;
+        const n = roleCounts[p.role];
+        const suffix = p.role === "main" ? "" : `.${p.role}`;
+        const indexTag = n > 1 ? `.${n}` : "";
+        const fileName = `${base}${suffix}${indexTag}${ext}`;
+        return {
+            path: join(dir, fileName).replace(/\\/g, "/"),
+            role: p.role,
+            contains: p.symbols.map((s) => s.name),
+            estimated_lines: p.lines,
+        };
+    });
+    const mainFile = suggested.find((s) => s.role === "main") ?? suggested[0];
+    const importsToAdd = suggested
+        .filter((s) => s !== mainFile)
+        .map((s) => {
+        const names = s.contains.slice(0, 6).join(", ") + (s.contains.length > 6 ? ", ..." : "");
+        const rel = "./" + basename(s.path, ext);
+        return `In ${basename(mainFile.path)}: import { ${names} } from "${rel}";`;
+    });
+    const notes = [
+        `Heuristic split by name: types → *.types.*, utils/helpers → *.utils.*, service-layer → *.service.*.`,
+        `Cross-file references inside the original are not computed — review and add imports between split files as needed.`,
+        `Target: ${splitCount} files, each ≤ ${target} lines. Heuristic produced ${parts.length}.`,
+    ];
+    return {
+        needed: true,
+        current_lines: currentLines,
+        target_limit: target,
+        split_count: splitCount,
+        suggested_files: suggested,
+        imports_to_add: importsToAdd,
+        notes,
+    };
+}
+export async function checkCodeHygiene(args) {
+    const limit = HARD_LIMIT;
+    const summary = { ok: 0, grandfathered: 0, excluded: 0, over: 0, missing: 0 };
+    const files = await Promise.all(args.paths.map(async (p) => {
+        const name = basename(p);
+        try {
+            await stat(p);
+        }
+        catch {
+            summary.missing++;
+            return {
+                path: p,
+                name,
+                exists: false,
+                lines: 0,
+                over_limit: false,
+                grandfathered: false,
+                excluded: false,
+                split_count: 0,
+                status: "missing",
+            };
+        }
+        if (isExcluded(p)) {
+            summary.excluded++;
+            return {
+                path: p,
+                name,
+                exists: true,
+                lines: 0,
+                over_limit: false,
+                grandfathered: false,
+                excluded: true,
+                split_count: 0,
+                status: "excluded",
+            };
+        }
+        const text = await readFile(p, "utf8");
+        const lines = text.split(/\r?\n/).length;
+        const overLimit = lines > limit;
+        const splitCount = overLimit ? Math.max(2, Math.ceil(lines / limit)) : 1;
+        if (overLimit) {
+            summary.grandfathered++;
+            summary.over++;
+            const plan = planRefactor(p, text);
+            return {
+                path: p,
+                name,
+                exists: true,
+                lines,
+                over_limit: true,
+                grandfathered: true,
+                excluded: false,
+                split_count: splitCount,
+                status: "grandfathered",
+                refactor_plan: plan,
+            };
+        }
+        summary.ok++;
+        return {
+            path: p,
+            name,
+            exists: true,
+            lines,
+            over_limit: false,
+            grandfathered: false,
+            excluded: false,
+            split_count: 1,
+            status: "ok",
+        };
+    }));
+    return { limit, files, summary };
+}
+//# sourceMappingURL=hygiene.js.map

package/dist/tools/hygiene.js.map

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

package/dist/tools/image.js

@@ -0,0 +1,107 @@
+import { readFile, stat, rm, mkdtemp } from "node:fs/promises";
+import { resolve, extname, join, basename } from "node:path";
+import { tmpdir } from "node:os";
+import { execFileSync } from "node:child_process";
+import { captionImage, embed } from "../ollama.js";
+import { upsertChunks, md5 } from "../supabase.js";
+import { currentProjectId } from "../project.js";
+// Formats Moondream's llama.cpp runner accepts natively.
+const NATIVE_IMAGE_EXTS = new Set([".png", ".jpg", ".jpeg"]);
+const MAGIC_TABLE = [
+    { hex: "89504e47", ext: ".png" },
+    { hex: "ffd8ff", ext: ".jpg" },
+    { hex: "52494646", ext: ".webp" }, // also matches other RIFF containers; good enough for vision files
+    { hex: "47494638", ext: ".gif" },
+    { hex: "424d", ext: ".bmp" },
+];
+async function detectFormat(path) {
+    const extHint = extname(path).toLowerCase();
+    if (NATIVE_IMAGE_EXTS.has(extHint))
+        return extHint;
+    // Magic-number sniff — defends against mislabeled extensions.
+    const buf = await readFile(path);
+    const head = buf.subarray(0, 12).toString("hex");
+    for (const { hex, ext } of MAGIC_TABLE) {
+        if (head.startsWith(hex))
+            return ext;
+    }
+    return extHint || ".bin";
+}
+/**
+ * Convert any raster image to PNG via ffmpeg. Returns both the output PNG
+ * path AND the unique mkdtemp directory so the caller can wipe the whole
+ * directory in one recursive rm — no orphaned temp dirs.
+ */
+async function convertToPng(src) {
+    const dir = await mkdtemp(join(tmpdir(), "claude-mem-img-"));
+    const dest = join(dir, `${basename(src, extname(src))}.png`);
+    try {
+        execFileSync("ffmpeg", ["-hide_banner", "-loglevel", "error", "-y", "-i", src, "-frames:v", "1", dest], { stdio: "pipe" });
+    }
+    catch (e) {
+        await rm(dir, { recursive: true, force: true }).catch(() => { });
+        throw new Error(`ffmpeg conversion of ${basename(src)} → png failed: ${e.message}. ` +
+            "Install ffmpeg and ensure it's on PATH, or pass a PNG/JPEG directly.");
+    }
+    return { path: dest, tempDir: dir };
+}
+export async function indexImage(args) {
+    const projectId = args.project_id ?? currentProjectId;
+    const abs = resolve(args.image_path);
+    const info = await stat(abs);
+    if (!info.isFile())
+        throw new Error(`Not a file: ${abs}`);
+    const fmt = await detectFormat(abs);
+    let toCaption = abs;
+    let tempDirToClean = null;
+    let convertedFrom = null;
+    if (!NATIVE_IMAGE_EXTS.has(fmt)) {
+        convertedFrom = fmt;
+        const converted = await convertToPng(abs);
+        toCaption = converted.path;
+        tempDirToClean = converted.tempDir;
+    }
+    try {
+        const caption = await captionImage(toCaption, args.caption_prompt, {
+            model: args.vision_model,
+        });
+        if (!caption.trim())
+            throw new Error("Vision model returned an empty caption.");
+        const [vec] = await embed([caption]);
+        const fileHash = md5(caption);
+        await upsertChunks(projectId, [
+            {
+                content: caption,
+                file_origin: abs,
+                chunk_index: 0,
+                embedding: vec,
+                file_hash: fileHash,
+                metadata: {
+                    type: "image",
+                    image_path: abs,
+                    bytes: info.size,
+                    caption_chars: caption.length,
+                    source_format: fmt,
+                    converted_from: convertedFrom,
+                },
+            },
+        ]);
+        return {
+            action: "index_image",
+            project_id: projectId,
+            image_path: abs,
+            source_format: fmt,
+            converted_to_png: convertedFrom !== null,
+            caption_chars: caption.length,
+            caption_preview: caption.slice(0, 300),
+        };
+    }
+    finally {
+        // Total Surgical Wipe — delete the unique mkdtemp directory recursively,
+        // which also removes the PNG inside. No orphaned temp artefacts.
+        if (tempDirToClean) {
+            await rm(tempDirToClean, { recursive: true, force: true }).catch(() => { });
+        }
+    }
+}
+//# sourceMappingURL=image.js.map

package/dist/tools/image.js.map

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

package/dist/tools/list-global-patterns.js

@@ -0,0 +1,101 @@
+// MCP tool: list_global_patterns
+//
+// Browse-only enumeration of the reserved 'GLOBAL' Knowledge Vault.
+// Pure SQL — no embedding work, no Ollama call. See ARCHITECTURE.md §4.3.1
+// for the spec and acceptance criteria.
+//
+// Task 5: real SELECT against memory_chunks WHERE project_id='GLOBAL',
+// optional jsonb @> filter via supabase-js `.contains()` (hits the
+// GIN(jsonb_path_ops) index from migration 007), ORDER BY updated_at
+// DESC, id DESC, paginated via inclusive `.range()`.
+//
+// NOTE on the recency column: memory_chunks has NO `created_at` column —
+// `updated_at` is the only recency signal (set on insert via
+// `default now()` and on upsert via the helper). We physically ORDER BY
+// `updated_at` but surface it under the `created_at` response field to
+// keep the public tool contract stable.
+import { z } from "zod";
+import { metadataFilterSchema } from "./shared-schemas.js";
+import { supabase } from "../supabase.js";
+export const listGlobalPatternsInputShape = {
+    metadata_filter: metadataFilterSchema,
+    limit: z
+        .number()
+        .int()
+        .positive()
+        .max(50)
+        .optional()
+        .describe("Maximum rows to return. Default 10, hard cap 50 (mirrors search_memory)."),
+    offset: z
+        .number()
+        .int()
+        .nonnegative()
+        .optional()
+        .describe("Pagination offset. Default 0."),
+    include_content: z
+        .boolean()
+        .optional()
+        .describe("When true, each row includes the full `content` field; otherwise only a content_preview (≤120 chars) is returned. Default false (tiered output)."),
+};
+const MAX_LIMIT = 50;
+const DEFAULT_LIMIT = 10;
+const PREVIEW_CHARS = 120;
+const GLOBAL_PROJECT_ID = "GLOBAL";
+export async function listGlobalPatterns(args) {
+    const limit = Math.min(args.limit ?? DEFAULT_LIMIT, MAX_LIMIT);
+    const offset = args.offset ?? 0;
+    const includeContent = args.include_content ?? false;
+    let query = supabase
+        .from("memory_chunks")
+        .select("id, content, metadata, file_origin, updated_at", {
+        count: "exact",
+    })
+        .eq("project_id", GLOBAL_PROJECT_ID)
+        .order("updated_at", { ascending: false })
+        .order("id", { ascending: false })
+        .range(offset, offset + limit - 1);
+    if (args.metadata_filter && Object.keys(args.metadata_filter).length > 0) {
+        // @>-style JSONB containment: Supabase JS exposes this via the
+        // `contains` operator. Hits the existing GIN(jsonb_path_ops) index on
+        // memory_chunks.metadata.
+        query = query.contains("metadata", args.metadata_filter);
+    }
+    const { data, error, count } = await query;
+    if (error) {
+        throw new Error(`list_global_patterns SELECT failed: ${error.message}`);
+    }
+    const rows = (data ?? []).map((r) => {
+        const metadata = (r.metadata ?? {});
+        const content = (r.content ?? "");
+        const preview = content.length <= PREVIEW_CHARS
+            ? content
+            : `${content.slice(0, PREVIEW_CHARS)}…`;
+        const row = {
+            id: r.id,
+            type: typeof metadata.type === "string" ? metadata.type : null,
+            global_rationale: typeof metadata.global_rationale === "string"
+                ? metadata.global_rationale
+                : null,
+            created_at: r.updated_at,
+            file_origin: (r.file_origin ?? ""),
+            content_preview: preview,
+        };
+        if (includeContent) {
+            row.content = content;
+        }
+        return row;
+    });
+    const total = count ?? rows.length;
+    const summary = total === 0
+        ? "GLOBAL vault is empty."
+        : `Returned ${rows.length} of ${total} GLOBAL row(s).`;
+    return {
+        project_id: "GLOBAL",
+        count: total,
+        results: rows,
+        limit,
+        offset,
+        summary,
+    };
+}
+//# sourceMappingURL=list-global-patterns.js.map

package/dist/tools/list-global-patterns.js.map

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