engram-mcp-server 1.2.8 → 1.2.9

package/dist/src/tools/conventions.js

@@ -1,121 +0,0 @@
-// ============================================================================
-// Engram MCP Server — Convention Tools
-// ============================================================================
-import { z } from "zod";
-import { getDb, now, getCurrentSessionId } from "../database.js";
-import { TOOL_PREFIX } from "../constants.js";
-export function registerConventionTools(server) {
-    server.registerTool(`${TOOL_PREFIX}_add_convention`, {
-        title: "Add Convention",
-        description: `Record a project convention that the agent should always follow. Conventions are surfaced during start_session and serve as persistent rules.
-
-Args:
-  - category: "naming" | "architecture" | "styling" | "testing" | "git" | "documentation" | "error_handling" | "performance" | "security" | "other"
-  - rule (string): The convention rule in clear, actionable language
-  - examples (array of strings, optional): Code or usage examples
-
-Returns:
-  Convention ID and confirmation.`,
-        inputSchema: {
-            category: z.enum(["naming", "architecture", "styling", "testing", "git", "documentation", "error_handling", "performance", "security", "other"]),
-            rule: z.string().min(5).describe("The convention rule"),
-            examples: z.array(z.string()).optional().describe("Examples of the convention in use"),
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: false,
-        },
-    }, async ({ category, rule, examples }) => {
-        const db = getDb();
-        const timestamp = now();
-        const sessionId = getCurrentSessionId();
-        const result = db.prepare("INSERT INTO conventions (session_id, timestamp, category, rule, examples) VALUES (?, ?, ?, ?, ?)").run(sessionId, timestamp, category, rule, examples ? JSON.stringify(examples) : null);
-        return {
-            content: [{
-                    type: "text",
-                    text: JSON.stringify({
-                        convention_id: result.lastInsertRowid,
-                        message: `Convention #${result.lastInsertRowid} added to [${category}].`,
-                        rule,
-                    }, null, 2),
-                }],
-        };
-    });
-    server.registerTool(`${TOOL_PREFIX}_get_conventions`, {
-        title: "Get Conventions",
-        description: `Retrieve all active project conventions. Optionally filter by category.
-
-Args:
-  - category (string, optional): Filter by convention category
-  - include_disabled (boolean, optional): Include unenforced conventions (default: false)
-
-Returns:
-  Array of conventions grouped by category.`,
-        inputSchema: {
-            category: z.enum(["naming", "architecture", "styling", "testing", "git", "documentation", "error_handling", "performance", "security", "other"]).optional(),
-            include_disabled: z.boolean().default(false),
-        },
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    }, async ({ category, include_disabled }) => {
-        const db = getDb();
-        let query = "SELECT * FROM conventions WHERE 1=1";
-        const params = [];
-        if (!include_disabled) {
-            query += " AND enforced = 1";
-        }
-        if (category) {
-            query += " AND category = ?";
-            params.push(category);
-        }
-        query += " ORDER BY category, id";
-        const conventions = db.prepare(query).all(...params);
-        const grouped = {};
-        for (const c of conventions) {
-            if (!grouped[c.category])
-                grouped[c.category] = [];
-            grouped[c.category].push(c);
-        }
-        return {
-            content: [{
-                    type: "text",
-                    text: JSON.stringify({ total: conventions.length, by_category: grouped }, null, 2),
-                }],
-        };
-    });
-    server.registerTool(`${TOOL_PREFIX}_toggle_convention`, {
-        title: "Toggle Convention",
-        description: `Enable or disable a convention. Disabled conventions are not surfaced during start_session.
-
-Args:
-  - id (number): Convention ID
-  - enforced (boolean): Whether the convention should be enforced
-
-Returns:
-  Confirmation.`,
-        inputSchema: {
-            id: z.number().int().describe("Convention ID"),
-            enforced: z.boolean().describe("Enable or disable"),
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    }, async ({ id, enforced }) => {
-        const db = getDb();
-        const result = db.prepare("UPDATE conventions SET enforced = ? WHERE id = ?").run(enforced ? 1 : 0, id);
-        if (result.changes === 0) {
-            return { isError: true, content: [{ type: "text", text: `Convention #${id} not found.` }] };
-        }
-        return { content: [{ type: "text", text: `Convention #${id} ${enforced ? "enabled" : "disabled"}.` }] };
-    });
-}
-//# sourceMappingURL=conventions.js.map

package/dist/src/tools/conventions.js.map

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

package/dist/src/tools/decisions.d.ts

@@ -1,3 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function registerDecisionTools(server: McpServer): void;
-//# sourceMappingURL=decisions.d.ts.map

package/dist/src/tools/decisions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../../../src/tools/decisions.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsJ7D"}

package/dist/src/tools/decisions.js

@@ -1,136 +0,0 @@
-// ============================================================================
-// Engram MCP Server — Architectural Decision Tools
-// ============================================================================
-import { z } from "zod";
-import { getDb, now, getCurrentSessionId } from "../database.js";
-import { TOOL_PREFIX } from "../constants.js";
-export function registerDecisionTools(server) {
-    server.registerTool(`${TOOL_PREFIX}_record_decision`, {
-        title: "Record Decision",
-        description: `Record an architectural or design decision with its rationale. These persist across all future sessions and are surfaced during start_session. Use this for any choice that future agents or sessions need to respect.
-
-Args:
-  - decision (string): The decision that was made
-  - rationale (string, optional): Why this decision was made — context, tradeoffs, alternatives considered
-  - affected_files (array of strings, optional): Files impacted by this decision
-  - tags (array of strings, optional): Categorization tags (e.g., "architecture", "database", "ui", "api")
-  - status: "active" | "experimental" (default: "active")
-  - supersedes (number, optional): ID of a previous decision this replaces
-
-Returns:
-  Decision ID and confirmation.`,
-        inputSchema: {
-            decision: z.string().min(5).describe("The decision that was made"),
-            rationale: z.string().optional().describe("Why — context, tradeoffs, alternatives considered"),
-            affected_files: z.array(z.string()).optional().describe("Files impacted by this decision"),
-            tags: z.array(z.string()).optional().describe("Tags for categorization"),
-            status: z.enum(["active", "experimental"]).default("active"),
-            supersedes: z.number().int().optional().describe("ID of a previous decision this replaces"),
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: false,
-        },
-    }, async ({ decision, rationale, affected_files, tags, status, supersedes }) => {
-        const db = getDb();
-        const timestamp = now();
-        const sessionId = getCurrentSessionId();
-        const result = db.prepare("INSERT INTO decisions (session_id, timestamp, decision, rationale, affected_files, tags, status, superseded_by) VALUES (?, ?, ?, ?, ?, ?, ?, ?)").run(sessionId, timestamp, decision, rationale || null, affected_files ? JSON.stringify(affected_files) : null, tags ? JSON.stringify(tags) : null, status, supersedes || null);
-        const newDecisionId = result.lastInsertRowid;
-        if (supersedes) {
-            db.prepare("UPDATE decisions SET status = 'superseded', superseded_by = ? WHERE id = ?")
-                .run(newDecisionId, supersedes);
-        }
-        return {
-            content: [{
-                    type: "text",
-                    text: JSON.stringify({
-                        decision_id: newDecisionId,
-                        message: `Decision #${newDecisionId} recorded${supersedes ? ` (supersedes #${supersedes})` : ""}.`,
-                        decision,
-                    }, null, 2),
-                }],
-        };
-    });
-    server.registerTool(`${TOOL_PREFIX}_get_decisions`, {
-        title: "Get Decisions",
-        description: `Retrieve recorded architectural decisions. Filter by status, tags, or affected files.
-
-Args:
-  - status (string, optional): Filter by status — "active", "superseded", "deprecated", "experimental"
-  - tag (string, optional): Filter by tag
-  - file_path (string, optional): Find decisions affecting a specific file
-  - limit (number, optional): Max results (default 20)
-
-Returns:
-  Array of decisions with rationale and metadata.`,
-        inputSchema: {
-            status: z.enum(["active", "superseded", "deprecated", "experimental"]).optional(),
-            tag: z.string().optional().describe("Filter by tag"),
-            file_path: z.string().optional().describe("Find decisions affecting this file"),
-            limit: z.number().int().min(1).max(100).default(20),
-        },
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    }, async ({ status, tag, file_path, limit }) => {
-        const db = getDb();
-        let query = "SELECT * FROM decisions WHERE 1=1";
-        const params = [];
-        if (status) {
-            query += " AND status = ?";
-            params.push(status);
-        }
-        if (tag) {
-            query += " AND EXISTS (SELECT 1 FROM json_each(tags) WHERE value = ?)";
-            params.push(tag);
-        }
-        if (file_path) {
-            query += " AND EXISTS (SELECT 1 FROM json_each(affected_files) WHERE value = ?)";
-            params.push(file_path);
-        }
-        query += " ORDER BY timestamp DESC LIMIT ?";
-        params.push(limit);
-        const decisions = db.prepare(query).all(...params);
-        return {
-            content: [{
-                    type: "text",
-                    text: JSON.stringify({ count: decisions.length, decisions }, null, 2),
-                }],
-        };
-    });
-    server.registerTool(`${TOOL_PREFIX}_update_decision`, {
-        title: "Update Decision Status",
-        description: `Update the status of an existing decision. Use to deprecate, supersede, or reactivate decisions.
-
-Args:
-  - id (number): Decision ID to update
-  - status: "active" | "superseded" | "deprecated" | "experimental"
-
-Returns:
-  Confirmation.`,
-        inputSchema: {
-            id: z.number().int().describe("Decision ID"),
-            status: z.enum(["active", "superseded", "deprecated", "experimental"]),
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    }, async ({ id, status }) => {
-        const db = getDb();
-        const result = db.prepare("UPDATE decisions SET status = ? WHERE id = ?").run(status, id);
-        if (result.changes === 0) {
-            return { isError: true, content: [{ type: "text", text: `Decision #${id} not found.` }] };
-        }
-        return { content: [{ type: "text", text: `Decision #${id} status updated to "${status}".` }] };
-    });
-}
-//# sourceMappingURL=decisions.js.map

package/dist/src/tools/decisions.js.map

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

package/dist/src/tools/export-import.d.ts

@@ -1,3 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function registerExportImportTools(server: McpServer): void;
-//# sourceMappingURL=export-import.d.ts.map

package/dist/src/tools/export-import.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"export-import.d.ts","sourceRoot":"","sources":["../../../src/tools/export-import.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+MjE"}

package/dist/src/tools/export-import.js

@@ -1,180 +0,0 @@
-// ============================================================================
-// Engram MCP Server — Export & Import Tools
-// ============================================================================
-import { z } from "zod";
-import * as fs from "fs";
-import * as path from "path";
-import { getDb, now, getProjectRoot } from "../database.js";
-import { TOOL_PREFIX, DB_DIR_NAME, SERVER_VERSION } from "../constants.js";
-export function registerExportImportTools(server) {
-    // ─── EXPORT MEMORY ──────────────────────────────────────────────────
-    server.registerTool(`${TOOL_PREFIX}_export`, {
-        title: "Export Memory",
-        description: `Export the entire memory database as a portable JSON file. Useful for backup, migration, or sharing project knowledge with teammates.
-
-Args:
-  - output_path (string, optional): Where to save the export (default: .engram/export.json)
-
-Returns:
-  Export file path and summary.`,
-        inputSchema: {
-            output_path: z.string().optional().describe("Export file path"),
-        },
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    }, async ({ output_path }) => {
-        const db = getDb();
-        const projectRoot = getProjectRoot();
-        const exportData = {
-            engram_version: SERVER_VERSION,
-            exported_at: now(),
-            project_root: projectRoot,
-            sessions: db.prepare("SELECT * FROM sessions ORDER BY id").all(),
-            changes: db.prepare("SELECT * FROM changes ORDER BY id").all(),
-            decisions: db.prepare("SELECT * FROM decisions ORDER BY id").all(),
-            file_notes: db.prepare("SELECT * FROM file_notes ORDER BY file_path").all(),
-            conventions: db.prepare("SELECT * FROM conventions ORDER BY id").all(),
-            tasks: db.prepare("SELECT * FROM tasks ORDER BY id").all(),
-            milestones: db.prepare("SELECT * FROM milestones ORDER BY id").all(),
-        };
-        const filePath = output_path || path.join(projectRoot, DB_DIR_NAME, "export.json");
-        fs.writeFileSync(filePath, JSON.stringify(exportData, null, 2));
-        return {
-            content: [{
-                    type: "text",
-                    text: JSON.stringify({
-                        exported_to: filePath,
-                        counts: {
-                            sessions: exportData.sessions.length,
-                            changes: exportData.changes.length,
-                            decisions: exportData.decisions.length,
-                            file_notes: exportData.file_notes.length,
-                            conventions: exportData.conventions.length,
-                            tasks: exportData.tasks.length,
-                            milestones: exportData.milestones.length,
-                        },
-                    }, null, 2),
-                }],
-        };
-    });
-    // ─── IMPORT MEMORY ──────────────────────────────────────────────────
-    server.registerTool(`${TOOL_PREFIX}_import`, {
-        title: "Import Memory",
-        description: `Import memory from a previously exported JSON file. Merges data into the existing database without duplicating existing records.
-
-Args:
-  - input_path (string): Path to the export JSON file
-  - dry_run (boolean, optional): Preview import without writing (default: true)
-
-Returns:
-  Import summary with counts.`,
-        inputSchema: {
-            input_path: z.string().describe("Path to export JSON file"),
-            dry_run: z.boolean().default(true).describe("Preview mode"),
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    }, async ({ input_path, dry_run }) => {
-        const projectRoot = getProjectRoot();
-        const filePath = path.isAbsolute(input_path) ? input_path : path.join(projectRoot, input_path);
-        if (!fs.existsSync(filePath)) {
-            return { isError: true, content: [{ type: "text", text: `File not found: ${filePath}` }] };
-        }
-        let importData;
-        try {
-            importData = JSON.parse(fs.readFileSync(filePath, "utf-8"));
-        }
-        catch (e) {
-            return { isError: true, content: [{ type: "text", text: `Invalid JSON: ${e}` }] };
-        }
-        const counts = {};
-        for (const key of ["sessions", "changes", "decisions", "file_notes", "conventions", "tasks", "milestones"]) {
-            counts[key] = Array.isArray(importData[key]) ? importData[key].length : 0;
-        }
-        if (dry_run) {
-            return {
-                content: [{
-                        type: "text",
-                        text: JSON.stringify({
-                            dry_run: true,
-                            would_import: counts,
-                            message: "Run with dry_run=false to execute the import.",
-                        }, null, 2),
-                    }],
-            };
-        }
-        const db = getDb();
-        const importTransaction = db.transaction(() => {
-            const sessionIdMap = new Map();
-            if (Array.isArray(importData.sessions)) {
-                for (const s of importData.sessions) {
-                    const exists = db.prepare("SELECT id FROM sessions WHERE started_at = ? AND agent_name = ?").get(s.started_at, s.agent_name || "unknown");
-                    if (!exists) {
-                        const result = db.prepare("INSERT INTO sessions (started_at, ended_at, summary, agent_name, project_root, tags) VALUES (?, ?, ?, ?, ?, ?)").run(s.started_at, s.ended_at || null, s.summary || null, s.agent_name || "unknown", s.project_root || "", s.tags || null);
-                        sessionIdMap.set(s.id, result.lastInsertRowid);
-                    }
-                    else {
-                        sessionIdMap.set(s.id, exists.id);
-                    }
-                }
-            }
-            if (Array.isArray(importData.changes)) {
-                for (const c of importData.changes) {
-                    const exists = db.prepare("SELECT id FROM changes WHERE file_path = ? AND timestamp = ? AND description = ?").get(c.file_path, c.timestamp, c.description);
-                    if (!exists) {
-                        const mappedSessionId = c.session_id ? (sessionIdMap.get(c.session_id) ?? c.session_id) : null;
-                        db.prepare("INSERT INTO changes (session_id, timestamp, file_path, change_type, description, diff_summary, impact_scope) VALUES (?, ?, ?, ?, ?, ?, ?)").run(mappedSessionId, c.timestamp, c.file_path, c.change_type, c.description, c.diff_summary || null, c.impact_scope || "local");
-                    }
-                }
-            }
-            if (Array.isArray(importData.conventions)) {
-                for (const c of importData.conventions) {
-                    const exists = db.prepare("SELECT id FROM conventions WHERE rule = ?").get(c.rule);
-                    if (!exists) {
-                        db.prepare("INSERT INTO conventions (timestamp, category, rule, examples, enforced) VALUES (?, ?, ?, ?, ?)").run(c.timestamp || now(), c.category, c.rule, c.examples || null, c.enforced ?? 1);
-                    }
-                }
-            }
-            if (Array.isArray(importData.decisions)) {
-                for (const d of importData.decisions) {
-                    const exists = db.prepare("SELECT id FROM decisions WHERE decision = ?").get(d.decision);
-                    if (!exists) {
-                        db.prepare("INSERT INTO decisions (timestamp, decision, rationale, affected_files, tags, status) VALUES (?, ?, ?, ?, ?, ?)").run(d.timestamp || now(), d.decision, d.rationale || null, d.affected_files || null, d.tags || null, d.status || "active");
-                    }
-                }
-            }
-            if (Array.isArray(importData.file_notes)) {
-                for (const f of importData.file_notes) {
-                    db.prepare(`
-              INSERT OR REPLACE INTO file_notes (file_path, purpose, dependencies, dependents, layer, last_reviewed, notes, complexity)
-              VALUES (?, ?, ?, ?, ?, ?, ?, ?)
-            `).run(f.file_path, f.purpose || null, f.dependencies || null, f.dependents || null, f.layer || null, f.last_reviewed || now(), f.notes || null, f.complexity || null);
-                }
-            }
-            if (Array.isArray(importData.milestones)) {
-                for (const m of importData.milestones) {
-                    const exists = db.prepare("SELECT id FROM milestones WHERE title = ? AND timestamp = ?").get(m.title, m.timestamp);
-                    if (!exists) {
-                        db.prepare("INSERT INTO milestones (timestamp, title, description, version, tags) VALUES (?, ?, ?, ?, ?)").run(m.timestamp || now(), m.title, m.description || null, m.version || null, m.tags || null);
-                    }
-                }
-            }
-        });
-        importTransaction();
-        return {
-            content: [{
-                    type: "text",
-                    text: JSON.stringify({ imported: counts, message: "Import complete. Duplicates were skipped." }, null, 2),
-                }],
-        };
-    });
-}
-//# sourceMappingURL=export-import.js.map

package/dist/src/tools/export-import.js.map

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

package/dist/src/tools/file-notes.d.ts

@@ -1,3 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function registerFileNoteTools(server: McpServer): void;
-//# sourceMappingURL=file-notes.d.ts.map

package/dist/src/tools/file-notes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"file-notes.d.ts","sourceRoot":"","sources":["../../../src/tools/file-notes.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyH7D"}

package/dist/src/tools/file-notes.js

@@ -1,104 +0,0 @@
-// ============================================================================
-// Engram MCP Server — File Notes Tools
-// ============================================================================
-import { z } from "zod";
-import { getDb, now, getCurrentSessionId } from "../database.js";
-import { TOOL_PREFIX } from "../constants.js";
-export function registerFileNoteTools(server) {
-    server.registerTool(`${TOOL_PREFIX}_set_file_notes`, {
-        title: "Set File Notes",
-        description: `Store persistent notes about a file: its purpose, dependencies, architectural layer, complexity, and any important details. This creates a knowledge base that eliminates the need to re-read and re-analyze files across sessions.
-
-Args:
-  - file_path (string): Relative path to the file
-  - purpose (string, optional): What this file does — its responsibility
-  - dependencies (array, optional): Files this file depends on
-  - dependents (array, optional): Files that depend on this file
-  - layer: "ui" | "viewmodel" | "domain" | "data" | "network" | "database" | "di" | "util" | "test" | "config" | "build" | "other"
-  - complexity: "trivial" | "simple" | "moderate" | "complex" | "critical"
-  - notes (string, optional): Any important context, gotchas, or warnings
-
-Returns:
-  Confirmation.`,
-        inputSchema: {
-            file_path: z.string().describe("Relative path to the file"),
-            purpose: z.string().optional().describe("What this file does"),
-            dependencies: z.array(z.string()).optional().describe("Files this depends on"),
-            dependents: z.array(z.string()).optional().describe("Files that depend on this"),
-            layer: z.enum(["ui", "viewmodel", "domain", "data", "network", "database", "di", "util", "test", "config", "build", "other"]).optional(),
-            complexity: z.enum(["trivial", "simple", "moderate", "complex", "critical"]).optional(),
-            notes: z.string().optional().describe("Important context, gotchas, warnings"),
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    }, async ({ file_path, purpose, dependencies, dependents, layer, complexity, notes }) => {
-        const db = getDb();
-        const timestamp = now();
-        const sessionId = getCurrentSessionId();
-        db.prepare(`
-        INSERT INTO file_notes (file_path, purpose, dependencies, dependents, layer, last_reviewed, last_modified_session, notes, complexity)
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
-        ON CONFLICT(file_path) DO UPDATE SET
-          purpose = COALESCE(?, purpose),
-          dependencies = COALESCE(?, dependencies),
-          dependents = COALESCE(?, dependents),
-          layer = COALESCE(?, layer),
-          last_reviewed = ?,
-          last_modified_session = COALESCE(?, last_modified_session),
-          notes = COALESCE(?, notes),
-          complexity = COALESCE(?, complexity)
-      `).run(file_path, purpose || null, dependencies ? JSON.stringify(dependencies) : null, dependents ? JSON.stringify(dependents) : null, layer || null, timestamp, sessionId, notes || null, complexity || null, 
-        // Update values
-        purpose || null, dependencies ? JSON.stringify(dependencies) : null, dependents ? JSON.stringify(dependents) : null, layer || null, timestamp, sessionId, notes || null, complexity || null);
-        return {
-            content: [{ type: "text", text: `File notes saved for ${file_path}.` }],
-        };
-    });
-    server.registerTool(`${TOOL_PREFIX}_get_file_notes`, {
-        title: "Get File Notes",
-        description: `Retrieve stored notes for one or more files. Use to quickly understand a file's purpose and context without reading it.
-
-Args:
-  - file_path (string, optional): Specific file to query
-  - layer (string, optional): Filter by architectural layer
-  - complexity (string, optional): Filter by complexity level
-
-Returns:
-  File notes with purpose, dependencies, layer, and complexity.`,
-        inputSchema: {
-            file_path: z.string().optional().describe("Specific file to query"),
-            layer: z.enum(["ui", "viewmodel", "domain", "data", "network", "database", "di", "util", "test", "config", "build", "other"]).optional(),
-            complexity: z.enum(["trivial", "simple", "moderate", "complex", "critical"]).optional(),
-        },
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    }, async ({ file_path, layer, complexity }) => {
-        const db = getDb();
-        if (file_path) {
-            const note = db.prepare("SELECT * FROM file_notes WHERE file_path = ?").get(file_path);
-            return { content: [{ type: "text", text: JSON.stringify(note || { message: "No notes found for this file." }, null, 2) }] };
-        }
-        let query = "SELECT * FROM file_notes WHERE 1=1";
-        const params = [];
-        if (layer) {
-            query += " AND layer = ?";
-            params.push(layer);
-        }
-        if (complexity) {
-            query += " AND complexity = ?";
-            params.push(complexity);
-        }
-        query += " ORDER BY file_path";
-        const notes = db.prepare(query).all(...params);
-        return { content: [{ type: "text", text: JSON.stringify({ count: notes.length, files: notes }, null, 2) }] };
-    });
-}
-//# sourceMappingURL=file-notes.js.map

package/dist/src/tools/file-notes.js.map

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

package/dist/src/tools/intelligence.d.ts

@@ -1,3 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function registerIntelligenceTools(server: McpServer): void;
-//# sourceMappingURL=intelligence.d.ts.map

package/dist/src/tools/intelligence.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"intelligence.d.ts","sourceRoot":"","sources":["../../../src/tools/intelligence.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmCpE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6ajE"}