project-memory-mcp 0.1.0

package/dist/hooks/extractors.js

@@ -0,0 +1,318 @@
+/**
+ * Heuristic extractors that pull structured facts from Claude Code transcript lines.
+ * Each extractor receives an array of parsed JSONL objects (the delta) and returns
+ * candidate memory items: { type, title, content, tags }.
+ */
+// ── helpers ──────────────────────────────────────────────────────────────────
+const RE_VERSION = /\b(node|npm|python|pip|ruby|go|java|rustc|cargo|bun|deno|pnpm|yarn)\s+(-v|--version|version)\b/i;
+const RE_VERSION_OUTPUT = /v?\d+\.\d+\.\d+/;
+const RE_COMMIT = /git\s+commit\s.*?-m\s+["'](.+?)["']/;
+const RE_NPM_INSTALL = /\b(npm|yarn|pnpm|bun)\s+(install|add|i)\s+(\S+)/;
+const RE_PIP_INSTALL = /\b(pip|pip3)\s+install\s+(\S+)/;
+const RE_CARGO_ADD = /\bcargo\s+add\s+(\S+)/;
+/**
+ * Extract the role and content from a transcript JSONL line.
+ * Claude Code transcript lines wrap messages in various ways:
+ *   - Top-level: { type: "assistant", message: { role, content } }
+ *   - Progress:  { type: "progress", data: { message: { type, message: { role, content } } } }
+ *   - Simple:    { role, content }  (fallback)
+ */
+function normalizeRole(role) {
+    if (!role)
+        return role;
+    if (role === "model")
+        return "assistant";
+    return role;
+}
+function normalizeContent(content, parts) {
+    if (Array.isArray(content))
+        return content;
+    if (typeof content === "string")
+        return content;
+    if (Array.isArray(parts)) {
+        return parts
+            .map((p) => {
+            if (typeof p === "string")
+                return p;
+            if (typeof p?.text === "string")
+                return p.text;
+            return "";
+        })
+            .filter(Boolean)
+            .join("");
+    }
+    return null;
+}
+function unwrap(line) {
+    // Direct message lines (type: "assistant" | "user")
+    if (line.message?.role) {
+        const content = normalizeContent(line.message.content, line.message.parts);
+        if (content !== null) {
+            return { role: normalizeRole(line.message.role), content };
+        }
+    }
+    // Lines with type but no message wrapper (type: "assistant" | "user" with direct content)
+    if ((line.type === "assistant" || line.type === "user") && line.content !== undefined) {
+        const content = normalizeContent(line.content, line.parts);
+        if (content !== null) {
+            return { role: normalizeRole(line.type), content };
+        }
+    }
+    // Progress lines (subagent tool calls/results)
+    if (line.type === "progress" && line.data?.message?.message) {
+        const inner = line.data.message.message;
+        if (inner.role && inner.content) {
+            const content = normalizeContent(inner.content, inner.parts);
+            if (content !== null) {
+                return { role: normalizeRole(inner.role), content };
+            }
+        }
+    }
+    // Fallback: already unwrapped
+    if (line.role) {
+        const content = normalizeContent(line.content, line.parts);
+        if (content !== null) {
+            return { role: normalizeRole(line.role), content };
+        }
+    }
+    return null;
+}
+function bashToolCalls(lines) {
+    const results = [];
+    for (const line of lines) {
+        const msg = unwrap(line);
+        if (!msg || msg.role !== "assistant")
+            continue;
+        const content = Array.isArray(msg.content) ? msg.content : [];
+        for (const block of content) {
+            if (block.type !== "tool_use" || block.name !== "Bash")
+                continue;
+            results.push({ id: block.id, command: block.input?.command ?? "" });
+        }
+    }
+    return results;
+}
+function toolResults(lines) {
+    const results = [];
+    for (const line of lines) {
+        const msg = unwrap(line);
+        if (!msg || msg.role !== "user")
+            continue;
+        const content = Array.isArray(msg.content) ? msg.content : [];
+        for (const block of content) {
+            if (block.type === "tool_result") {
+                results.push({ toolUseId: block.tool_use_id, text: block.content ?? "" });
+            }
+        }
+    }
+    return results;
+}
+function resultForId(resultMap, id) {
+    return resultMap.get(id) ?? "";
+}
+// ── Extractor 1: Bash tool facts ─────────────────────────────────────────────
+export function extractFromBashTools(lines) {
+    const items = [];
+    const calls = bashToolCalls(lines);
+    const resMap = new Map();
+    for (const r of toolResults(lines)) {
+        resMap.set(r.toolUseId, r.text);
+    }
+    for (const call of calls) {
+        const cmd = call.command;
+        const output = resultForId(resMap, call.id);
+        // Version detection
+        if (RE_VERSION.test(cmd)) {
+            const match = (typeof output === "string" ? output : "").match(RE_VERSION_OUTPUT);
+            if (match) {
+                const tool = cmd.match(RE_VERSION)?.[1] ?? "unknown";
+                items.push({
+                    type: "fact",
+                    title: `${tool} version: ${match[0]}`,
+                    content: `Detected via \`${cmd.trim()}\``,
+                    tags: ["version", "environment"],
+                });
+            }
+        }
+        // Commit messages
+        const commitMatch = cmd.match(RE_COMMIT);
+        if (commitMatch) {
+            items.push({
+                type: "note",
+                title: `Commit: ${commitMatch[1].slice(0, 120)}`,
+                content: `Full command: ${cmd.trim().slice(0, 300)}`,
+                tags: ["commit"],
+            });
+        }
+        // npm / yarn / pnpm / bun install
+        const npmMatch = cmd.match(RE_NPM_INSTALL);
+        if (npmMatch) {
+            const pkg = npmMatch[3].replace(/^['"]|['"]$/g, "");
+            if (pkg && !pkg.startsWith("-")) {
+                items.push({
+                    type: "fact",
+                    title: `Added dependency: ${pkg}`,
+                    content: `Installed via \`${cmd.trim().slice(0, 200)}\``,
+                    tags: ["dependency"],
+                });
+            }
+        }
+        // pip install
+        const pipMatch = cmd.match(RE_PIP_INSTALL);
+        if (pipMatch) {
+            const pkg = pipMatch[2].replace(/^['"]|['"]$/g, "");
+            if (pkg && !pkg.startsWith("-")) {
+                items.push({
+                    type: "fact",
+                    title: `Added dependency: ${pkg}`,
+                    content: `Installed via \`${cmd.trim().slice(0, 200)}\``,
+                    tags: ["dependency"],
+                });
+            }
+        }
+        // cargo add
+        const cargoMatch = cmd.match(RE_CARGO_ADD);
+        if (cargoMatch) {
+            items.push({
+                type: "fact",
+                title: `Added dependency: ${cargoMatch[1]}`,
+                content: `Installed via \`${cmd.trim().slice(0, 200)}\``,
+                tags: ["dependency"],
+            });
+        }
+    }
+    return items;
+}
+// ── Extractor 2: Error resolutions ───────────────────────────────────────────
+export function extractErrorResolutions(lines) {
+    const items = [];
+    const calls = bashToolCalls(lines);
+    const resMap = new Map();
+    for (const r of toolResults(lines)) {
+        resMap.set(r.toolUseId, r.text);
+    }
+    // Track errors then look for subsequent success on similar commands
+    const errors = [];
+    for (const call of calls) {
+        const output = resultForId(resMap, call.id);
+        const outStr = typeof output === "string" ? output : JSON.stringify(output ?? "");
+        // Heuristic: non-zero exit or common error strings
+        const isError = /exit code [1-9]|error:|ERR!|FAIL|fatal:/i.test(outStr);
+        const isSuccess = !isError && outStr.length > 0;
+        if (isError) {
+            const summary = outStr.slice(0, 150).split("\n")[0];
+            errors.push({ command: call.command, summary });
+        }
+        else if (isSuccess && errors.length > 0) {
+            // Check if this success relates to a prior error (same base command)
+            const baseCmd = call.command.split(/\s+/)[0];
+            const related = errors.find((e) => e.command.split(/\s+/)[0] === baseCmd);
+            if (related) {
+                items.push({
+                    type: "fact",
+                    title: `Resolved: ${related.summary.slice(0, 100)}`,
+                    content: `Error in \`${related.command.slice(0, 120)}\` was resolved by \`${call.command.slice(0, 120)}\``,
+                    tags: ["error-resolution"],
+                });
+                // Remove the matched error
+                const idx = errors.indexOf(related);
+                errors.splice(idx, 1);
+            }
+        }
+    }
+    return items;
+}
+// ── Extractor 3: File change summary ─────────────────────────────────────────
+export function extractFileChanges(lines) {
+    const files = new Set();
+    for (const line of lines) {
+        const msg = unwrap(line);
+        if (!msg || msg.role !== "assistant")
+            continue;
+        const content = Array.isArray(msg.content) ? msg.content : [];
+        for (const block of content) {
+            if (block.type !== "tool_use")
+                continue;
+            if (block.name === "Write" || block.name === "Edit") {
+                const fp = block.input?.file_path ?? block.input?.path ?? "";
+                if (fp)
+                    files.add(fp);
+            }
+        }
+    }
+    if (files.size === 0)
+        return [];
+    const fileList = [...files].sort();
+    return [
+        {
+            type: "note",
+            title: `Files modified this session (${fileList.length})`,
+            content: fileList.join(", "),
+            tags: ["file-changes"],
+        },
+    ];
+}
+// ── Extractor 4: Decisions / constraints / architecture from assistant text ──
+const DECISION_PATTERNS = [
+    { re: /\b(decided to|switched from|switched to|chose|migrated)\b/i, type: "decision" },
+    { re: /\b(always|never|must not|must|do not)\b/i, type: "constraint" },
+    { re: /\b(the architecture|pattern is|structure|design)\b/i, type: "architecture" },
+    { re: /\b(uses \S+ v\d+\.\d+|running on|installed)\b/i, type: "fact" },
+];
+function extractTextFromContent(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return "";
+    return content
+        .filter((block) => block.type === "text" && typeof block.text === "string")
+        .map((block) => block.text)
+        .join(" ");
+}
+function splitSentences(text) {
+    return text
+        .split(/(?<=[.!?])\s+/)
+        .map((s) => s.trim())
+        .filter((s) => s.length > 10);
+}
+export function extractDecisionsFromText(lines) {
+    const items = [];
+    const seen = new Set();
+    for (const line of lines) {
+        const msg = unwrap(line);
+        if (!msg || msg.role !== "assistant")
+            continue;
+        const text = extractTextFromContent(msg.content);
+        if (!text)
+            continue;
+        for (const sentence of splitSentences(text)) {
+            for (const { re, type } of DECISION_PATTERNS) {
+                if (!re.test(sentence))
+                    continue;
+                const title = sentence.length > 100 ? sentence.slice(0, 100) + "…" : sentence;
+                const key = `${type}:${title}`;
+                if (seen.has(key))
+                    break;
+                seen.add(key);
+                items.push({
+                    type,
+                    title,
+                    content: sentence.slice(0, 500),
+                    tags: [type],
+                });
+                break; // one match per sentence
+            }
+        }
+    }
+    return items;
+}
+// ── Orchestrator ─────────────────────────────────────────────────────────────
+export function extractAll(lines) {
+    return [
+        ...extractFromBashTools(lines),
+        ...extractErrorResolutions(lines),
+        ...extractFileChanges(lines),
+        ...extractDecisionsFromText(lines),
+    ];
+}
+//# sourceMappingURL=extractors.js.map

package/dist/hooks/extractors.js.map

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

package/dist/scripts/test-hooks.js

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+/**
+ * End-to-end sanity tests for Claude/Gemini/Codex hook chain.
+ * Creates a small transcript, runs each hook entrypoint, and reports results.
+ */
+import { spawn } from "node:child_process";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+const ROOT = process.cwd();
+const TMP_DIR = "/tmp";
+const TRANSCRIPT = join(TMP_DIR, "pm-hook-test.jsonl");
+const CURSOR = join(ROOT, ".ai", ".auto-save-cursor.json");
+const MEMORY = join(ROOT, ".ai", "memory.json");
+function now() {
+    return new Date().toISOString();
+}
+async function ensureAiDir() {
+    await mkdir(join(ROOT, ".ai"), { recursive: true });
+}
+async function writeTranscript() {
+    const lines = [
+        {
+            type: "assistant",
+            message: {
+                role: "assistant",
+                content: [{ type: "tool_use", name: "Bash", id: "1", input: { command: "node -v" } }],
+            },
+        },
+        {
+            type: "user",
+            content: [{ type: "tool_result", tool_use_id: "1", content: "v20.11.0" }],
+        },
+        {
+            type: "assistant",
+            message: { role: "assistant", content: "Done." },
+        },
+    ];
+    const raw = lines.map((l) => JSON.stringify(l)).join("\n");
+    await writeFile(TRANSCRIPT, raw);
+}
+async function readMemory() {
+    const raw = await readFile(MEMORY, "utf8");
+    return JSON.parse(raw);
+}
+async function readCursor() {
+    const raw = await readFile(CURSOR, "utf8");
+    return JSON.parse(raw);
+}
+function runNode(scriptPath, input, env = {}) {
+    return new Promise((resolve) => {
+        const child = spawn("node", [scriptPath], {
+            stdio: ["pipe", "pipe", "pipe"],
+            env: { ...process.env, ...env },
+        });
+        let stderr = "";
+        child.stderr.on("data", (d) => (stderr += d.toString("utf8")));
+        child.stdin.write(input);
+        child.stdin.end();
+        child.on("close", (code) => resolve({ code, stderr }));
+    });
+}
+async function runClaude() {
+    const payload = JSON.stringify({
+        session_id: `claude-test-${now()}`,
+        transcript_path: TRANSCRIPT,
+        cwd: ROOT,
+    });
+    return runNode(join(ROOT, "dist", "hooks", "auto-save.js"), payload, {
+        CLAUDE_PROJECT_DIR: ROOT,
+    });
+}
+async function runGemini() {
+    const payload = JSON.stringify({
+        session_id: `gemini-test-${now()}`,
+        transcript_path: TRANSCRIPT,
+        cwd: ROOT,
+    });
+    return runNode(join(ROOT, "dist", "hooks", "auto-save.js"), payload, {
+        GEMINI_PROJECT_DIR: ROOT,
+    });
+}
+async function runCodex() {
+    const payload = JSON.stringify({
+        session_id: `codex-test-${now()}`,
+        cwd: ROOT,
+        history_path: TRANSCRIPT,
+    });
+    return runNode(join(ROOT, "dist", "hooks", "codex-notify.js"), payload);
+}
+function printResult(name, ok, details = "") {
+    const status = ok ? "PASS" : "FAIL";
+    const line = `${status} ${name}${details ? ` - ${details}` : ""}`;
+    process.stdout.write(line + "\n");
+}
+async function main() {
+    await ensureAiDir();
+    await writeTranscript();
+    const claude = await runClaude();
+    const cursorAfterClaude = await readCursor();
+    printResult("Claude hook", claude.code === 0 &&
+        cursorAfterClaude.sessionId?.startsWith("claude-test-") &&
+        cursorAfterClaude.lastLineIndex === 2, claude.code !== 0 ? `exit ${claude.code}` : "cursor not updated");
+    const gemini = await runGemini();
+    const cursorAfterGemini = await readCursor();
+    printResult("Gemini hook", gemini.code === 0 &&
+        cursorAfterGemini.sessionId?.startsWith("gemini-test-") &&
+        cursorAfterGemini.lastLineIndex === 2, gemini.code !== 0 ? `exit ${gemini.code}` : "cursor not updated");
+    const codex = await runCodex();
+    const cursorAfterCodex = await readCursor();
+    printResult("Codex hook", codex.code === 0 &&
+        cursorAfterCodex.sessionId?.startsWith("codex-test-") &&
+        cursorAfterCodex.lastLineIndex === 2, codex.code !== 0 ? `exit ${codex.code}` : "cursor not updated");
+    if (claude.stderr)
+        printResult("Claude stderr", false, claude.stderr.trim());
+    if (gemini.stderr)
+        printResult("Gemini stderr", false, gemini.stderr.trim());
+    if (codex.stderr)
+        printResult("Codex stderr", false, codex.stderr.trim());
+    // Touch cursor to show it's created
+    try {
+        await readFile(CURSOR, "utf8");
+        printResult("Cursor file", true, CURSOR);
+    }
+    catch {
+        printResult("Cursor file", false, "missing");
+    }
+    try {
+        const data = await readMemory();
+        const found = data.items.some((i) => (i.tags ?? []).includes("auto-hook") &&
+            typeof i.title === "string" &&
+            i.title.toLowerCase().includes("node version"));
+        printResult("Auto-hook item", found, found ? "node version" : "missing");
+    }
+    catch {
+        printResult("Auto-hook item", false, "memory read failed");
+    }
+}
+main().catch((err) => {
+    printResult("Test runner", false, err?.message || "unknown error");
+    process.exit(1);
+});
+//# sourceMappingURL=test-hooks.js.map

package/dist/scripts/test-hooks.js.map

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

package/dist/server.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+/**
+ * Project Memory MCP Server (JSON backend) + setup utilities.
+ */
+import process from "node:process";
+import { main } from "./src/main.js";
+import { log } from "./src/logger.js";
+async function run() {
+    const [, , rawCommand] = process.argv;
+    const command = rawCommand?.toLowerCase();
+    if (!command || command === "serve") {
+        await main();
+        return;
+    }
+    if (command === "setup" || command === "configure") {
+        const { runSetup } = await import("./src/setup.js");
+        const exitCode = await runSetup(process.argv.slice(3));
+        if (typeof exitCode === "number" && exitCode !== 0) {
+            process.exitCode = exitCode;
+        }
+        return;
+    }
+    if (command === "help" || command === "--help" || command === "-h") {
+        printUsage();
+        return;
+    }
+    log(`unknown command "${rawCommand}".`);
+    printUsage();
+    process.exitCode = 1;
+}
+function printUsage() {
+    console.log(`
+Usage:
+  project-memory-mcp               Start the MCP server (default)
+  project-memory-mcp serve         Explicitly start the MCP server
+  project-memory-mcp setup [...]   Run the interactive CLI configuration wizard
+  project-memory-mcp help          Show this message
+`.trim());
+}
+run().catch((err) => {
+    log("fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../server.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAEtC,KAAK,UAAU,GAAG;IAChB,MAAM,CAAC,EAAE,AAAD,EAAG,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IACtC,MAAM,OAAO,GAAG,UAAU,EAAE,WAAW,EAAE,CAAC;IAE1C,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACpC,MAAM,IAAI,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IAED,IAAI,OAAO,KAAK,OAAO,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;QACnD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACvD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;YACnD,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC9B,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACnE,UAAU,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IAED,GAAG,CAAC,oBAAoB,UAAU,IAAI,CAAC,CAAC;IACxC,UAAU,EAAE,CAAC;IACb,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,CAAC,GAAG,CAAC;;;;;;CAMb,CAAC,IAAI,EAAE,CAAC,CAAC;AACV,CAAC;AAED,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAClB,GAAG,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACzB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/src/config.js

@@ -0,0 +1,29 @@
+export const CONFIG = {
+    serverName: "project-memory",
+    serverVersion: "0.1.0",
+    defaultRelMemoryPath: ".ai/memory.json",
+    lockTimeoutMs: 2500,
+    lockRetryDelayMs: 50,
+    lockRetryBackoff: 1.25,
+    maxLockRetryDelayMs: 250,
+    maxContentSnippetChars: 280,
+    autoCompact: {
+        enabled: true,
+        maxItems: 400,
+        archiveRelPath: ".ai/memory-archive.json",
+        summaryTitle: "Archived context (auto)",
+        summaryTag: "archive",
+        summaryMaxEntries: 20,
+        growthThreshold: 50,
+    },
+};
+export const ALLOWED_TYPES = new Set([
+    "note",
+    "decision",
+    "fact",
+    "constraint",
+    "todo",
+    "architecture",
+    "glossary",
+]);
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAwBA,MAAM,CAAC,MAAM,MAAM,GAAW;IAC5B,UAAU,EAAE,gBAAgB;IAC5B,aAAa,EAAE,OAAO;IACtB,oBAAoB,EAAE,iBAAiB;IACvC,aAAa,EAAE,IAAI;IACnB,gBAAgB,EAAE,EAAE;IACpB,gBAAgB,EAAE,IAAI;IACtB,mBAAmB,EAAE,GAAG;IACxB,sBAAsB,EAAE,GAAG;IAC3B,WAAW,EAAE;QACX,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,GAAG;QACb,cAAc,EAAE,yBAAyB;QACzC,YAAY,EAAE,yBAAyB;QACvC,UAAU,EAAE,SAAS;QACrB,iBAAiB,EAAE,EAAE;QACrB,eAAe,EAAE,EAAE;KACpB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAa;IAC/C,MAAM;IACN,UAAU;IACV,MAAM;IACN,YAAY;IACZ,MAAM;IACN,cAAc;IACd,UAAU;CACX,CAAC,CAAC"}

package/dist/src/domain.js

@@ -0,0 +1,52 @@
+import crypto from "node:crypto";
+import { ALLOWED_TYPES, CONFIG } from "./config.js";
+export function normalizeTags(tags) {
+    const arr = Array.isArray(tags) ? tags : [];
+    const norm = arr
+        .map((t) => String(t || "").trim().toLowerCase())
+        .filter(Boolean);
+    return Array.from(new Set(norm)).slice(0, 20);
+}
+export function safeSnippet(text, maxChars = CONFIG.maxContentSnippetChars) {
+    const s = String(text ?? "");
+    const trimmed = s.replace(/\s+/g, " ").trim();
+    if (trimmed.length <= maxChars)
+        return trimmed;
+    return `${trimmed.slice(0, maxChars - 1)}…`;
+}
+export function scoreItem(item, queryTokens, tagTokens) {
+    const hay = `${item.title || ""} ${item.content || ""}`.toLowerCase();
+    let score = 0;
+    for (const t of queryTokens) {
+        if (!t)
+            continue;
+        if (hay.includes(t))
+            score += 3;
+    }
+    const itemTags = new Set(normalizeTags(item.tags));
+    for (const t of tagTokens) {
+        if (itemTags.has(t))
+            score += 4;
+    }
+    if (item.pinned)
+        score += 2;
+    return score;
+}
+export function tokenize(s) {
+    return String(s || "")
+        .toLowerCase()
+        .split(/[^a-z0-9_\-]+/i)
+        .map((x) => x.trim())
+        .filter((x) => x.length >= 2)
+        .slice(0, 40);
+}
+export function newId(prefix) {
+    // short, stable-ish id for CLI readability
+    const id = crypto.randomUUID().replace(/-/g, "").slice(0, 12);
+    return `${prefix}_${id}`;
+}
+export function validateType(type) {
+    const t = String(type || "note").toLowerCase().trim();
+    return ALLOWED_TYPES.has(t) ? t : "note";
+}
+//# sourceMappingURL=domain.js.map

package/dist/src/domain.js.map

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

package/dist/src/logger.js

@@ -0,0 +1,5 @@
+export function log(...args) {
+    // STDERR only (required for MCP stdio servers).
+    console.error("[project-memory]", ...args);
+}
+//# sourceMappingURL=logger.js.map

package/dist/src/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG,CAAC,GAAG,IAAe;IACpC,gDAAgD;IAChD,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,GAAG,IAAI,CAAC,CAAC;AAC7C,CAAC"}