engram-mcp-server 1.2.8 → 1.2.9

package/dist/src/tools/tasks.js

@@ -1,206 +0,0 @@
-// ============================================================================
-// Engram MCP Server — Task Management Tools
-// ============================================================================
-import { z } from "zod";
-import { getDb, now, getCurrentSessionId } from "../database.js";
-import { TOOL_PREFIX } from "../constants.js";
-export function registerTaskTools(server) {
-    // ─── CREATE TASK ────────────────────────────────────────────────────
-    server.registerTool(`${TOOL_PREFIX}_create_task`, {
-        title: "Create Task",
-        description: `Create a work item that persists across sessions. Tasks ensure continuity — nothing falls through the cracks between sessions. Use for TODOs, bugs, features, or any work that needs tracking.
-
-Args:
-  - title (string): Short, descriptive task title
-  - description (string, optional): Detailed description of the work
-  - priority: "critical" | "high" | "medium" | "low" (default: "medium")
-  - status: "backlog" | "in_progress" | "blocked" | "review" (default: "backlog")
-  - assigned_files (array, optional): Files this task relates to
-  - tags (array, optional): Categorization tags
-  - blocked_by (array of numbers, optional): Task IDs that block this task
-
-Returns:
-  Task ID and confirmation.`,
-        inputSchema: {
-            title: z.string().min(3).describe("Short task title"),
-            description: z.string().optional().describe("Detailed description"),
-            priority: z.enum(["critical", "high", "medium", "low"]).default("medium"),
-            status: z.enum(["backlog", "in_progress", "blocked", "review"]).default("backlog"),
-            assigned_files: z.array(z.string()).optional().describe("Related files"),
-            tags: z.array(z.string()).optional().describe("Tags"),
-            blocked_by: z.array(z.number().int()).optional().describe("Blocking task IDs"),
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: false,
-        },
-    }, async ({ title, description, priority, status, assigned_files, tags, blocked_by }) => {
-        const db = getDb();
-        const timestamp = now();
-        const sessionId = getCurrentSessionId();
-        const result = db.prepare(`
-        INSERT INTO tasks (session_id, created_at, updated_at, title, description, status, priority, assigned_files, tags, blocked_by)
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-      `).run(sessionId, timestamp, timestamp, title, description || null, status, priority, assigned_files ? JSON.stringify(assigned_files) : null, tags ? JSON.stringify(tags) : null, blocked_by ? JSON.stringify(blocked_by) : null);
-        return {
-            content: [{
-                    type: "text",
-                    text: JSON.stringify({
-                        task_id: result.lastInsertRowid,
-                        message: `Task #${result.lastInsertRowid} created: "${title}" [${priority}/${status}]`,
-                    }, null, 2),
-                }],
-        };
-    });
-    // ─── UPDATE TASK ────────────────────────────────────────────────────
-    server.registerTool(`${TOOL_PREFIX}_update_task`, {
-        title: "Update Task",
-        description: `Update a task's status, priority, or other fields. Use when progressing, completing, or blocking tasks.
-
-Args:
-  - id (number): Task ID to update
-  - status (string, optional): New status
-  - priority (string, optional): New priority
-  - description (string, optional): Updated description
-  - blocked_by (array, optional): Updated blocking task IDs
-  - assigned_files (array, optional): Updated related files
-  - tags (array, optional): Updated tags
-
-Returns:
-  Updated task.`,
-        inputSchema: {
-            id: z.number().int().describe("Task ID"),
-            status: z.enum(["backlog", "in_progress", "blocked", "review", "done", "cancelled"]).optional(),
-            priority: z.enum(["critical", "high", "medium", "low"]).optional(),
-            description: z.string().optional(),
-            blocked_by: z.array(z.number().int()).optional(),
-            assigned_files: z.array(z.string()).optional(),
-            tags: z.array(z.string()).optional(),
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    }, async ({ id, status, priority, description, blocked_by, assigned_files, tags }) => {
-        const db = getDb();
-        const timestamp = now();
-        // Build dynamic update
-        const updates = ["updated_at = ?"];
-        const params = [timestamp];
-        if (status) {
-            updates.push("status = ?");
-            params.push(status);
-            if (status === "done" || status === "cancelled") {
-                updates.push("completed_at = ?");
-                params.push(timestamp);
-            }
-        }
-        if (priority) {
-            updates.push("priority = ?");
-            params.push(priority);
-        }
-        if (description !== undefined) {
-            updates.push("description = ?");
-            params.push(description);
-        }
-        if (blocked_by) {
-            updates.push("blocked_by = ?");
-            params.push(JSON.stringify(blocked_by));
-        }
-        if (assigned_files) {
-            updates.push("assigned_files = ?");
-            params.push(JSON.stringify(assigned_files));
-        }
-        if (tags) {
-            updates.push("tags = ?");
-            params.push(JSON.stringify(tags));
-        }
-        params.push(id);
-        const result = db.prepare(`UPDATE tasks SET ${updates.join(", ")} WHERE id = ?`).run(...params);
-        if (result.changes === 0) {
-            return { isError: true, content: [{ type: "text", text: `Task #${id} not found.` }] };
-        }
-        // If task was marked done, trigger any scheduled events waiting on it
-        let triggeredEventCount = 0;
-        if (status === "done") {
-            try {
-                const triggerResult = db.prepare(`UPDATE scheduled_events SET status = 'triggered', triggered_at = ?
-             WHERE status = 'pending' AND trigger_type = 'task_complete' AND trigger_value = ?`).run(timestamp, String(id));
-                triggeredEventCount = triggerResult.changes;
-            }
-            catch { /* scheduled_events table may not exist yet */ }
-        }
-        const updated = db.prepare("SELECT * FROM tasks WHERE id = ?").get(id);
-        const response = { ...updated };
-        if (triggeredEventCount > 0) {
-            response._triggered_events = `${triggeredEventCount} scheduled event(s) triggered by this task completion. Use engram_check_events to review.`;
-        }
-        return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] };
-    });
-    // ─── GET TASKS ──────────────────────────────────────────────────────
-    server.registerTool(`${TOOL_PREFIX}_get_tasks`, {
-        title: "Get Tasks",
-        description: `Retrieve tasks with optional filtering. Returns open tasks by default.
-
-Args:
-  - status (string, optional): Filter by status
-  - priority (string, optional): Filter by priority
-  - tag (string, optional): Filter by tag
-  - include_done (boolean, optional): Include completed/cancelled tasks (default: false)
-  - limit (number, optional): Max results (default 20)
-
-Returns:
-  Array of tasks sorted by priority then creation date.`,
-        inputSchema: {
-            status: z.enum(["backlog", "in_progress", "blocked", "review", "done", "cancelled"]).optional(),
-            priority: z.enum(["critical", "high", "medium", "low"]).optional(),
-            tag: z.string().optional(),
-            include_done: z.boolean().default(false),
-            limit: z.number().int().min(1).max(100).default(20),
-        },
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    }, async ({ status, priority, tag, include_done, limit }) => {
-        const db = getDb();
-        let query = "SELECT * FROM tasks WHERE 1=1";
-        const params = [];
-        if (!include_done) {
-            query += " AND status NOT IN ('done', 'cancelled')";
-        }
-        if (status) {
-            query += " AND status = ?";
-            params.push(status);
-        }
-        if (priority) {
-            query += " AND priority = ?";
-            params.push(priority);
-        }
-        if (tag) {
-            query += " AND EXISTS (SELECT 1 FROM json_each(tags) WHERE value = ?)";
-            params.push(tag);
-        }
-        // Sort: critical > high > medium > low, then by creation date
-        query += ` ORDER BY
-        CASE priority WHEN 'critical' THEN 0 WHEN 'high' THEN 1 WHEN 'medium' THEN 2 WHEN 'low' THEN 3 END,
-        created_at ASC
-        LIMIT ?`;
-        params.push(limit);
-        const tasks = db.prepare(query).all(...params);
-        const openCount = db.prepare("SELECT COUNT(*) as c FROM tasks WHERE status NOT IN ('done','cancelled')").get().c;
-        return {
-            content: [{
-                    type: "text",
-                    text: JSON.stringify({ total_open: openCount, returned: tasks.length, tasks }, null, 2),
-                }],
-        };
-    });
-}
-//# sourceMappingURL=tasks.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../../src/tools/tasks.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,4CAA4C;AAC5C,+EAA+E;AAG/E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9C,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,uEAAuE;IACvE,MAAM,CAAC,YAAY,CACjB,GAAG,WAAW,cAAc,EAC5B;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE;;;;;;;;;;;;4BAYS;QACtB,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC;YACrD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YACnE,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;YACzE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;YAClF,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;YACxE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;YACrD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;SAC/E;QACD,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE;QACnF,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QACnB,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC;QACxB,MAAM,SAAS,GAAG,mBAAmB,EAAE,CAAC;QAExC,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC;;;OAGzB,CAAC,CAAC,GAAG,CACJ,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EACtC,WAAW,IAAI,IAAI,EACnB,MAAM,EAAE,QAAQ,EAChB,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,EACtD,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAClC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAC/C,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,OAAO,EAAE,MAAM,CAAC,eAAe;wBAC/B,OAAO,EAAE,SAAS,MAAM,CAAC,eAAe,cAAc,KAAK,MAAM,QAAQ,IAAI,MAAM,GAAG;qBACvF,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,uEAAuE;IACvE,MAAM,CAAC,YAAY,CACjB,GAAG,WAAW,cAAc,EAC5B;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE;;;;;;;;;;;;gBAYH;QACV,WAAW,EAAE;YACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC;YACxC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE;YAC/F,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE;YAClE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAClC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;YAChD,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;YAC9C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;SACrC;QACD,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,IAAI,EAAE,EAAE,EAAE;QAChF,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QACnB,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC;QAExB,uBAAuB;QACvB,MAAM,OAAO,GAAa,CAAC,gBAAgB,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAc,CAAC,SAAS,CAAC,CAAC;QAEtC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAChD,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;gBAChD,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;gBAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;QACD,IAAI,QAAQ,EAAE,CAAC;YAAC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAAC,CAAC;QACtE,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAAC,CAAC;QAC7F,IAAI,UAAU,EAAE,CAAC;YAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QAAC,CAAC;QAC5F,IAAI,cAAc,EAAE,CAAC;YAAC,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC;QAAC,CAAC;QACxG,IAAI,IAAI,EAAE,CAAC;YAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAAC,CAAC;QAE1E,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChB,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,oBAAoB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;QAEhG,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;QACxF,CAAC;QAED,sEAAsE;QACtE,IAAI,mBAAmB,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,aAAa,GAAG,EAAE,CAAC,OAAO,CAC9B;+FACmF,CACpF,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC7B,mBAAmB,GAAG,aAAa,CAAC,OAAO,CAAC;YAC9C,CAAC;YAAC,MAAM,CAAC,CAAC,8CAA8C,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvE,MAAM,QAAQ,GAA4B,EAAE,GAAI,OAAmC,EAAE,CAAC;QACtF,IAAI,mBAAmB,GAAG,CAAC,EAAE,CAAC;YAC5B,QAAQ,CAAC,iBAAiB,GAAG,GAAG,mBAAmB,2FAA2F,CAAC;QACjJ,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAClF,CAAC,CACF,CAAC;IAEF,uEAAuE;IACvE,MAAM,CAAC,YAAY,CACjB,GAAG,WAAW,YAAY,EAC1B;QACE,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE;;;;;;;;;;wDAUqC;QAClD,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE;YAC/F,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE;YAClE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC1B,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;YACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;SACpD;QACD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,EAAE;QACvD,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QACnB,IAAI,KAAK,GAAG,+BAA+B,CAAC;QAC5C,MAAM,MAAM,GAAc,EAAE,CAAC;QAE7B,IAAI,CAAC,YAAY,EAAE,CAAC;YAAC,KAAK,IAAI,0CAA0C,CAAC;QAAC,CAAC;QAC3E,IAAI,MAAM,EAAE,CAAC;YAAC,KAAK,IAAI,iBAAiB,CAAC;YAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAAC,CAAC;QAChE,IAAI,QAAQ,EAAE,CAAC;YAAC,KAAK,IAAI,mBAAmB,CAAC;YAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAAC,CAAC;QACtE,IAAI,GAAG,EAAE,CAAC;YAAC,KAAK,IAAI,6DAA6D,CAAC;YAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAEtG,8DAA8D;QAC9D,KAAK,IAAI;;;gBAGC,CAAC;QACX,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEnB,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAA2B,CAAC;QACzE,MAAM,SAAS,GAAI,EAAE,CAAC,OAAO,CAAC,0EAA0E,CAAC,CAAC,GAAG,EAAoB,CAAC,CAAC,CAAC;QAEpI,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACxF,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/src/types.d.ts

@@ -1,170 +0,0 @@
-export interface SessionRow {
-    id: number;
-    started_at: string;
-    ended_at: string | null;
-    summary: string | null;
-    agent_name: string;
-    project_root: string;
-    tags: string | null;
-    parent_session_id: number | null;
-}
-export interface ChangeRow {
-    id: number;
-    session_id: number | null;
-    timestamp: string;
-    file_path: string;
-    change_type: ChangeType;
-    description: string;
-    diff_summary: string | null;
-    impact_scope: ImpactScope;
-}
-export interface DecisionRow {
-    id: number;
-    session_id: number | null;
-    timestamp: string;
-    decision: string;
-    rationale: string | null;
-    affected_files: string | null;
-    tags: string | null;
-    status: DecisionStatus;
-    superseded_by: number | null;
-}
-export interface FileNoteRow {
-    file_path: string;
-    purpose: string | null;
-    dependencies: string | null;
-    dependents: string | null;
-    layer: ArchLayer | null;
-    last_reviewed: string | null;
-    last_modified_session: number | null;
-    notes: string | null;
-    complexity: Complexity | null;
-}
-export interface ConventionRow {
-    id: number;
-    session_id: number | null;
-    timestamp: string;
-    category: ConventionCategory;
-    rule: string;
-    examples: string | null;
-    enforced: boolean;
-}
-export interface TaskRow {
-    id: number;
-    session_id: number | null;
-    created_at: string;
-    updated_at: string;
-    title: string;
-    description: string | null;
-    status: TaskStatus;
-    priority: TaskPriority;
-    assigned_files: string | null;
-    tags: string | null;
-    completed_at: string | null;
-    blocked_by: string | null;
-}
-export interface SnapshotRow {
-    key: string;
-    value: string;
-    updated_at: string;
-    ttl_minutes: number | null;
-}
-export interface MilestoneRow {
-    id: number;
-    session_id: number | null;
-    timestamp: string;
-    title: string;
-    description: string | null;
-    version: string | null;
-    tags: string | null;
-}
-export interface ScheduledEventRow {
-    id: number;
-    session_id: number | null;
-    created_at: string;
-    title: string;
-    description: string | null;
-    trigger_type: EventTriggerType;
-    trigger_value: string | null;
-    status: EventStatus;
-    triggered_at: string | null;
-    acknowledged_at: string | null;
-    requires_approval: number;
-    action_summary: string | null;
-    action_data: string | null;
-    priority: TaskPriority;
-    tags: string | null;
-    recurrence: EventRecurrence | null;
-}
-export type ChangeType = "created" | "modified" | "deleted" | "refactored" | "renamed" | "moved" | "config_changed";
-export type ImpactScope = "local" | "module" | "cross_module" | "global";
-export type DecisionStatus = "active" | "superseded" | "deprecated" | "experimental";
-export type ArchLayer = "ui" | "viewmodel" | "domain" | "data" | "network" | "database" | "di" | "util" | "test" | "config" | "build" | "other";
-export type Complexity = "trivial" | "simple" | "moderate" | "complex" | "critical";
-export type ConventionCategory = "naming" | "architecture" | "styling" | "testing" | "git" | "documentation" | "error_handling" | "performance" | "security" | "other";
-export type TaskStatus = "backlog" | "in_progress" | "blocked" | "review" | "done" | "cancelled";
-export type TaskPriority = "critical" | "high" | "medium" | "low";
-export type EventTriggerType = "next_session" | "datetime" | "task_complete" | "manual";
-export type EventStatus = "pending" | "triggered" | "acknowledged" | "executed" | "cancelled" | "snoozed";
-export type EventRecurrence = "once" | "every_session" | "daily" | "weekly";
-export interface SessionContext {
-    session_id: number;
-    previous_session: {
-        id: number;
-        summary: string | null;
-        ended_at: string | null;
-        agent: string;
-    } | null;
-    changes_since_last: {
-        recorded: ChangeRow[];
-        git_log: string;
-    };
-    active_decisions: DecisionRow[];
-    active_conventions: ConventionRow[];
-    open_tasks: TaskRow[];
-    project_snapshot_age_minutes: number | null;
-    message: string;
-}
-export interface ProjectSnapshot {
-    project_root: string;
-    file_tree: string[];
-    total_files: number;
-    file_notes: FileNoteRow[];
-    recent_decisions: DecisionRow[];
-    active_conventions: ConventionRow[];
-    layer_distribution: Record<string, number>;
-    generated_at: string;
-}
-export interface MemoryStats {
-    total_sessions: number;
-    total_changes: number;
-    total_decisions: number;
-    total_file_notes: number;
-    total_conventions: number;
-    total_tasks: number;
-    total_milestones: number;
-    oldest_session: string | null;
-    newest_session: string | null;
-    most_changed_files: Array<{
-        file_path: string;
-        change_count: number;
-    }>;
-    database_size_kb: number;
-}
-export interface CompactionResult {
-    sessions_compacted: number;
-    changes_summarized: number;
-    storage_freed_kb: number;
-}
-export interface ConfigRow {
-    key: string;
-    value: string;
-    updated_at: string;
-}
-export interface BackupInfo {
-    path: string;
-    size_kb: number;
-    created_at: string;
-    database_version: number;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

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

package/dist/src/types.js

@@ -1,5 +0,0 @@
-// ============================================================================
-// Engram MCP Server — Type Definitions
-// ============================================================================
-export {};
-//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,uCAAuC;AACvC,+EAA+E"}

package/dist/src/utils.d.ts

@@ -1,58 +0,0 @@
-import type { ArchLayer } from "./types.js";
-/**
- * Auto-detect the project root by walking up from cwd looking for marker files.
- */
-export declare function findProjectRoot(startDir?: string): string;
-/**
- * Scan the project file tree, respecting exclusions and depth limits.
- */
-export declare function scanFileTree(rootDir: string, maxDepth?: number, maxEntries?: number): string[];
-/**
- * Detect the architectural layer of a file based on its path.
- */
-export declare function detectLayer(filePath: string): ArchLayer;
-/**
- * Run a git command in the project root. Returns empty string on failure.
- */
-export declare function gitCommand(projectRoot: string, command: string): string;
-/**
- * Check if the project is a git repository.
- */
-export declare function isGitRepo(projectRoot: string): boolean;
-/**
- * Get git log since a given timestamp.
- */
-export declare function getGitLogSince(projectRoot: string, since: string, limit?: number): string;
-/**
- * Get git diff stat (files changed, insertions, deletions).
- */
-export declare function getGitDiffStat(projectRoot: string, since: string): string;
-/**
- * Get files changed in git since a timestamp.
- */
-export declare function getGitFilesChanged(projectRoot: string, since: string): string[];
-/**
- * Get the current git branch name.
- */
-export declare function getGitBranch(projectRoot: string): string;
-/**
- * Get the latest git commit hash (short).
- */
-export declare function getGitHead(projectRoot: string): string;
-/**
- * Safely parse a JSON string, returning a default value on failure.
- */
-export declare function safeJsonParse<T>(json: string | null | undefined, fallback: T): T;
-/**
- * Format a response as either JSON or Markdown.
- */
-export declare function formatResponse(data: unknown, format?: "json" | "markdown"): string;
-/**
- * Calculate minutes between now and a given ISO timestamp.
- */
-export declare function minutesSince(isoTimestamp: string): number;
-/**
- * Truncate a string to a max length with ellipsis.
- */
-export declare function truncate(str: string, maxLength: number): string;
-//# sourceMappingURL=utils.d.ts.map

package/dist/src/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAkBzD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAA4B,EACtC,UAAU,GAAE,MAA8B,GACzC,MAAM,EAAE,CAiDV;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAUvD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAUvE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,MAAM,CAK7F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAO/E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAOhF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,GAAE,MAAM,GAAG,UAAmB,GAAG,MAAM,CAM1F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG/D"}

package/dist/src/utils.js

@@ -1,190 +0,0 @@
-// ============================================================================
-// Engram MCP Server — Utilities
-// ============================================================================
-import { execSync } from "child_process";
-import * as fs from "fs";
-import * as path from "path";
-import { EXCLUDED_DIRS, LAYER_PATTERNS, MAX_FILE_TREE_DEPTH, MAX_FILE_TREE_ENTRIES, PROJECT_MARKERS, } from "./constants.js";
-/**
- * Auto-detect the project root by walking up from cwd looking for marker files.
- */
-export function findProjectRoot(startDir) {
-    // 1. Explicit env var
-    if (process.env.ENGRAM_PROJECT_ROOT)
-        return process.env.ENGRAM_PROJECT_ROOT;
-    if (process.env.PROJECT_ROOT)
-        return process.env.PROJECT_ROOT;
-    // 2. Walk up directory tree
-    let dir = startDir || process.cwd();
-    while (dir !== path.dirname(dir)) {
-        for (const marker of PROJECT_MARKERS) {
-            if (fs.existsSync(path.join(dir, marker))) {
-                return dir;
-            }
-        }
-        dir = path.dirname(dir);
-    }
-    // 3. Fallback to cwd
-    return process.cwd();
-}
-/**
- * Scan the project file tree, respecting exclusions and depth limits.
- */
-export function scanFileTree(rootDir, maxDepth = MAX_FILE_TREE_DEPTH, maxEntries = MAX_FILE_TREE_ENTRIES) {
-    const files = [];
-    // Merge .engramignore entries with the default exclusion set
-    const exclusions = new Set(EXCLUDED_DIRS);
-    try {
-        const ignorePath = path.join(rootDir, ".engramignore");
-        if (fs.existsSync(ignorePath)) {
-            const lines = fs.readFileSync(ignorePath, "utf-8").split("\n");
-            for (const line of lines) {
-                const trimmed = line.trim();
-                if (trimmed && !trimmed.startsWith("#")) {
-                    exclusions.add(trimmed.replace(/\/$/, "")); // Strip trailing slash
-                }
-            }
-        }
-    }
-    catch { /* .engramignore is optional */ }
-    function walk(dir, depth) {
-        if (depth > maxDepth || files.length >= maxEntries)
-            return;
-        let entries;
-        try {
-            entries = fs.readdirSync(dir, { withFileTypes: true });
-        }
-        catch {
-            return;
-        }
-        // Sort for deterministic output
-        entries.sort((a, b) => a.name.localeCompare(b.name));
-        for (const entry of entries) {
-            if (files.length >= maxEntries)
-                break;
-            if (entry.name.startsWith(".") && entry.isDirectory())
-                continue;
-            if (entry.isDirectory()) {
-                if (exclusions.has(entry.name))
-                    continue;
-                const subPath = path.relative(rootDir, path.join(dir, entry.name));
-                files.push(subPath + "/");
-                walk(path.join(dir, entry.name), depth + 1);
-            }
-            else {
-                const relPath = path.relative(rootDir, path.join(dir, entry.name));
-                files.push(relPath);
-            }
-        }
-    }
-    walk(rootDir, 0);
-    return files;
-}
-/**
- * Detect the architectural layer of a file based on its path.
- */
-export function detectLayer(filePath) {
-    const normalized = "/" + filePath.replace(/\\/g, "/");
-    for (const [layer, patterns] of Object.entries(LAYER_PATTERNS)) {
-        for (const pattern of patterns) {
-            if (pattern.test(normalized)) {
-                return layer;
-            }
-        }
-    }
-    return "other";
-}
-/**
- * Run a git command in the project root. Returns empty string on failure.
- */
-export function gitCommand(projectRoot, command) {
-    try {
-        return execSync(`cd "${projectRoot}" && git ${command}`, {
-            encoding: "utf-8",
-            timeout: 10000,
-            stdio: ["pipe", "pipe", "pipe"],
-        }).trim();
-    }
-    catch {
-        return "";
-    }
-}
-/**
- * Check if the project is a git repository.
- */
-export function isGitRepo(projectRoot) {
-    return fs.existsSync(path.join(projectRoot, ".git"));
-}
-/**
- * Get git log since a given timestamp.
- */
-export function getGitLogSince(projectRoot, since, limit = 50) {
-    return gitCommand(projectRoot, `log --name-status --since="${since}" --pretty=format:"[%h] %s (%ar)" -${limit}`);
-}
-/**
- * Get git diff stat (files changed, insertions, deletions).
- */
-export function getGitDiffStat(projectRoot, since) {
-    return gitCommand(projectRoot, `diff --stat HEAD@{${since}} 2>/dev/null`);
-}
-/**
- * Get files changed in git since a timestamp.
- */
-export function getGitFilesChanged(projectRoot, since) {
-    const result = gitCommand(projectRoot, `log --name-only --since="${since}" --pretty=format:"" 2>/dev/null`);
-    if (!result)
-        return [];
-    return [...new Set(result.split("\n").filter(Boolean))];
-}
-/**
- * Get the current git branch name.
- */
-export function getGitBranch(projectRoot) {
-    return gitCommand(projectRoot, "rev-parse --abbrev-ref HEAD");
-}
-/**
- * Get the latest git commit hash (short).
- */
-export function getGitHead(projectRoot) {
-    return gitCommand(projectRoot, "rev-parse --short HEAD");
-}
-/**
- * Safely parse a JSON string, returning a default value on failure.
- */
-export function safeJsonParse(json, fallback) {
-    if (!json)
-        return fallback;
-    try {
-        return JSON.parse(json);
-    }
-    catch {
-        return fallback;
-    }
-}
-/**
- * Format a response as either JSON or Markdown.
- */
-export function formatResponse(data, format = "json") {
-    if (format === "json") {
-        return JSON.stringify(data, null, 2);
-    }
-    // For markdown, we just pretty-print JSON in a code block
-    return "```json\n" + JSON.stringify(data, null, 2) + "\n```";
-}
-/**
- * Calculate minutes between now and a given ISO timestamp.
- */
-export function minutesSince(isoTimestamp) {
-    const then = new Date(isoTimestamp).getTime();
-    const diff = Date.now() - then;
-    return Math.floor(diff / 60000);
-}
-/**
- * Truncate a string to a max length with ellipsis.
- */
-export function truncate(str, maxLength) {
-    if (str.length <= maxLength)
-        return str;
-    return str.slice(0, maxLength - 3) + "...";
-}
-//# sourceMappingURL=utils.js.map