npm - @vheins/local-memory-mcp - Versions diffs - 0.7.2 → 0.7.3 - Mend

@vheins/local-memory-mcp 0.7.2 → 0.7.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/dist/{chunk-J4O2HJ2K.js → chunk-ZCK6RZFX.js} +48 -11
package/dist/dashboard/public/assets/{index-CRhOgOlp.js → index-Bd8FKzVy.js} +2 -2
package/dist/dashboard/public/index.html +1 -1
package/dist/dashboard/server.js +54 -24
package/dist/mcp/server.js +55 -29
package/dist/prompts/export-task-to-github.md +61 -0
package/dist/prompts/import-github-issues.md +8 -3
package/package.json +2 -1

package/dist/dashboard/public/index.html CHANGED Viewed

@@ -8,7 +8,7 @@
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
   <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700;800&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
-  <script type="module" crossorigin src="/assets/index-CRhOgOlp.js"></script>
+  <script type="module" crossorigin src="/assets/index-Bd8FKzVy.js"></script>
   <link rel="stylesheet" crossorigin href="/assets/index-Bd7v94SO.css">
 </head>
 <body>

package/dist/dashboard/server.js CHANGED Viewed

@@ -6,7 +6,7 @@ import {
   TOOL_DEFINITIONS,
   listResources,
   logger
-} from "../chunk-J4O2HJ2K.js";
+} from "../chunk-ZCK6RZFX.js";
 // src/dashboard/server.ts
 import express from "express";
@@ -252,15 +252,25 @@ function condenseRecentActions(actions, limit) {
 var __dirname2 = path2.dirname(fileURLToPath2(import.meta.url));
 var pkg = { version: "0.0.0" };
 try {
-  const pkgPath = path2.join(__dirname2, "../../../package.json");
-  if (fs2.existsSync(pkgPath)) {
+  let currentDir = __dirname2;
+  let pkgPath = "";
+  while (currentDir !== path2.parse(currentDir).root) {
+    const checkPath = path2.join(currentDir, "package.json");
+    if (fs2.existsSync(checkPath)) {
+      pkgPath = checkPath;
+      break;
+    }
+    currentDir = path2.dirname(currentDir);
+  }
+  if (pkgPath) {
     const data = JSON.parse(fs2.readFileSync(pkgPath, "utf8"));
     if (data.version) pkg.version = data.version;
   }
 } catch {
 }
 var SystemController = class {
-  static getHealth(req, res) {
+  static async getHealth(req, res) {
+    await db.refresh();
     const stats = db.system.getGlobalStats();
     const health = {
       connected: mcpClient.isConnected(),
@@ -272,8 +282,9 @@ var SystemController = class {
     };
     res.json(jsonApiRes(health, "health"));
   }
-  static getRepos(req, res) {
+  static async getRepos(req, res) {
     try {
+      await db.refresh();
       const repos = db.system.listRepoNavigation();
       res.json(
         jsonApiRes(
@@ -286,8 +297,9 @@ var SystemController = class {
       res.status(500).json(jsonApiError(message));
     }
   }
-  static getStats(req, res) {
+  static async getStats(req, res) {
     try {
+      await db.refresh();
       const repo = req.query.repo;
       if (!repo) return res.status(400).json(jsonApiError("repo is required", 400));
       const stats = db.system.getDashboardStats(repo);
@@ -297,8 +309,9 @@ var SystemController = class {
       res.status(500).json(jsonApiError(message));
     }
   }
-  static getRecentActions(req, res) {
+  static async getRecentActions(req, res) {
     try {
+      await db.refresh();
       const repo = req.query.repo;
       const pageSize = Math.min(50, Math.max(1, parseInt(req.query.pageSize) || 10));
       const page = Math.max(1, parseInt(req.query.page) || 1);
@@ -344,8 +357,9 @@ var SystemController = class {
     const caps = { tools, resources, prompts };
     res.json(jsonApiRes(caps, "capability"));
   }
-  static getExport(req, res) {
+  static async getExport(req, res) {
     try {
+      await db.refresh();
       const { repo } = req.query;
       if (!repo) return res.status(400).json(jsonApiError("repo is required", 400));
       const memories = db.memories.getAllMemoriesWithStats(repo);
@@ -406,8 +420,9 @@ import { Router as Router2 } from "express";
 // src/dashboard/controllers/MemoriesController.ts
 import { randomUUID } from "crypto";
 var MemoriesController = class {
-  static list(req, res) {
+  static async list(req, res) {
     try {
+      await db.refresh();
       const query = req.query;
       const { repo, type, search, minImportance, maxImportance, sortBy, sortOrder } = query;
       const page = Math.max(1, parseInt(query.page || "1", 10));
@@ -439,8 +454,9 @@ var MemoriesController = class {
       res.status(500).json(jsonApiError(message));
     }
   }
-  static get(req, res) {
+  static async get(req, res) {
     try {
+      await db.refresh();
       const memory = db.memories.getByIdWithStats(req.params.id);
       if (!memory) throw new Error("Memory not found");
       db.actions.logAction("read", memory.scope.repo, { memoryId: memory.id, resultCount: 1 });
@@ -450,8 +466,9 @@ var MemoriesController = class {
       res.status(404).json(jsonApiError(message, 404));
     }
   }
-  static create(req, res) {
+  static async create(req, res) {
     try {
+      await db.refresh();
       const attributes = getAttributes(req);
       const { repo, type, content } = attributes;
       if (!repo || !type || !content) return res.status(400).json(jsonApiError("Required fields missing", 400));
@@ -470,8 +487,9 @@ var MemoriesController = class {
       res.status(500).json(jsonApiError(message));
     }
   }
-  static update(req, res) {
+  static async update(req, res) {
     try {
+      await db.refresh();
       const { id } = req.params;
       const existing = db.memories.getByIdWithStats ? db.memories.getByIdWithStats(id) : db.memories.getById(id);
       if (!existing) return res.status(404).json(jsonApiError("Memory not found", 404));
@@ -496,8 +514,9 @@ var MemoriesController = class {
       res.status(500).json(jsonApiError(message));
     }
   }
-  static delete(req, res) {
+  static async delete(req, res) {
     try {
+      await db.refresh();
       const { id } = req.params;
       const existing = db.memories.getByIdWithStats ? db.memories.getByIdWithStats(id) : db.memories.getById(id);
       if (!existing) return res.status(404).json(jsonApiError("Memory not found", 404));
@@ -509,8 +528,9 @@ var MemoriesController = class {
       res.status(500).json(jsonApiError(message));
     }
   }
-  static bulkCreate(req, res) {
+  static async bulkCreate(req, res) {
     try {
+      await db.refresh();
       const { items, repo } = getAttributes(req);
       if (!Array.isArray(items) || !repo)
         return res.status(400).json(jsonApiError("Invalid payload: requires 'items' array and 'repo'", 400));
@@ -529,8 +549,9 @@ var MemoriesController = class {
       res.status(500).json(jsonApiError(message));
     }
   }
-  static bulkAction(req, res) {
+  static async bulkAction(req, res) {
     try {
+      await db.refresh();
       const { action, ids, updates } = getAttributes(req);
       if (!Array.isArray(ids) || !action)
         return res.status(400).json(jsonApiError("Invalid payload: requires 'ids' array and 'action'", 400));
@@ -576,8 +597,9 @@ import { Router as Router3 } from "express";
 // src/dashboard/controllers/TasksController.ts
 import { randomUUID as randomUUID2 } from "crypto";
 var TasksController = class {
-  static list(req, res) {
+  static async list(req, res) {
     try {
+      await db.refresh();
       const query = req.query;
       const { repo, status, search } = query;
       const page = Math.max(1, parseInt(req.query.page || "1", 10));
@@ -607,8 +629,9 @@ var TasksController = class {
       res.status(500).json(jsonApiError(message));
     }
   }
-  static get(req, res) {
+  static async get(req, res) {
     try {
+      await db.refresh();
       const task = db.tasks.getTaskById(req.params.id);
       if (!task) throw new Error("Task not found");
       db.actions.logAction("read", task.repo, { taskId: task.id });
@@ -618,8 +641,9 @@ var TasksController = class {
       res.status(404).json(jsonApiError(message, 404));
     }
   }
-  static create(req, res) {
+  static async create(req, res) {
     try {
+      await db.refresh();
       const attributes = getAttributes(req);
       const { repo, task_code, title } = attributes;
       if (!repo || !task_code || !title) return res.status(400).json(jsonApiError("Required fields missing", 400));
@@ -639,8 +663,9 @@ var TasksController = class {
       res.status(500).json(jsonApiError(message));
     }
   }
-  static update(req, res) {
+  static async update(req, res) {
     try {
+      await db.refresh();
       const { id } = req.params;
       const attributes = getAttributes(req);
       const existingTask = db.tasks.getTaskById(id);
@@ -683,8 +708,9 @@ var TasksController = class {
       res.status(500).json(jsonApiError(message));
     }
   }
-  static delete(req, res) {
+  static async delete(req, res) {
     try {
+      await db.refresh();
       const { id } = req.params;
       const task = db.tasks.getTaskById(id);
       if (!task) return res.status(404).json(jsonApiError("Task not found", 404));
@@ -696,8 +722,9 @@ var TasksController = class {
       res.status(500).json(jsonApiError(message));
     }
   }
-  static bulkCreate(req, res) {
+  static async bulkCreate(req, res) {
     try {
+      await db.refresh();
       const { items, repo } = getAttributes(req);
       if (!Array.isArray(items) || !repo)
         return res.status(400).json(jsonApiError("Invalid payload: requires 'items' array and 'repo'", 400));
@@ -717,8 +744,9 @@ var TasksController = class {
       res.status(500).json(jsonApiError(message));
     }
   }
-  static getTimeStats(req, res) {
+  static async getTimeStats(req, res) {
     try {
+      await db.refresh();
       const { repo } = req.query;
       if (!repo) return res.status(400).json(jsonApiError("repo is required", 400));
       const stats = {
@@ -745,8 +773,9 @@ var TasksController = class {
       res.status(500).json(jsonApiError(message));
     }
   }
-  static updateComment(req, res) {
+  static async updateComment(req, res) {
     try {
+      await db.refresh();
       const { id } = req.params;
       const { comment } = getAttributes(req);
       const existingComment = db.tasks.getTaskCommentById(id);
@@ -758,8 +787,9 @@ var TasksController = class {
       res.status(500).json(jsonApiError(message));
     }
   }
-  static deleteComment(req, res) {
+  static async deleteComment(req, res) {
     try {
+      await db.refresh();
       const { id } = req.params;
       db.tasks.deleteTaskComment(id);
       res.json(jsonApiRes({ message: "Deleted" }, "status"));

package/dist/mcp/server.js CHANGED Viewed

@@ -42,7 +42,7 @@ import {
   setLogLevel,
   updateSessionFromInitialize,
   updateSessionRoots
-} from "../chunk-J4O2HJ2K.js";
+} from "../chunk-ZCK6RZFX.js";
 // src/mcp/server.ts
 import readline from "readline";
@@ -214,7 +214,7 @@ function createMcpResponse(data, summary, options) {
     resourceLinks,
     structuredContentPathHint,
     contentSummary,
-    includeSerializedStructuredContent = "auto"
+    includeSerializedStructuredContent = true
   } = options || {};
   void includeSerializedStructuredContent;
   let finalData = data;
@@ -239,12 +239,12 @@ function createMcpResponse(data, summary, options) {
     }
   }
   const content = [];
-  if (contentSummary?.trim().length) {
+  if (contentSummary && contentSummary.trim().length > 0) {
     content.push({
       type: "text",
       text: contentSummary.trim()
     });
-  } else if (summary.trim().length > 0) {
+  } else if (summary && summary.trim().length > 0) {
     const pointerText = structuredContentPathHint ? `Read structuredContent.${structuredContentPathHint} for details.` : `Read structuredContent for machine-readable results.`;
     content.push({
       type: "text",
@@ -264,6 +264,9 @@ function createMcpResponse(data, summary, options) {
     structuredContent: finalData,
     isError: false
   };
+  if (includeSerializedStructuredContent === false) {
+    delete response.structuredContent;
+  }
   response.content = content;
   return response;
 }
@@ -622,23 +625,21 @@ async function handleMemorySearch(params, db2, vectors2) {
     memoriesByType[typeLabel].push(m);
   }
   let contentSummary;
-  if (!validated.structured) {
-    if (paginatedResults.length > 0) {
-      const parts = [];
-      for (const [memType, items] of Object.entries(memoriesByType)) {
-        parts.push(`${capitalize(memType)}:`);
-        parts.push("- code|importance|title");
-        for (const m of items) {
-          const code = m.code || "-";
-          parts.push(`- ${code}|${m.importance}|${m.title}`);
-        }
-        parts.push("");
+  if (paginatedResults.length > 0) {
+    const parts = [];
+    for (const [memType, items] of Object.entries(memoriesByType)) {
+      parts.push(`${capitalize(memType)}:`);
+      parts.push("- code|importance|title");
+      for (const m of items) {
+        const code = m.code || "-";
+        parts.push(`- ${code}|${m.importance}|${m.title}`);
       }
-      parts.push("Use memory-detail with memory_id (or code) for full content.");
-      contentSummary = parts.join("\n").trim();
-    } else {
-      contentSummary = `No memories found for "${validated.query}" in repo "${validated.repo}".`;
+      parts.push("");
     }
+    parts.push("Use memory-detail with memory_id (or code) for full content.");
+    contentSummary = parts.join("\n").trim();
+  } else {
+    contentSummary = `No memories found for "${validated.query}" in repo "${validated.repo}".`;
   }
   const structuredData = {
     schema: "memory-search",
@@ -652,9 +653,10 @@ async function handleMemorySearch(params, db2, vectors2) {
       rows
     }
   };
-  return createMcpResponse(structuredData, contentSummary || "", {
+  return createMcpResponse(structuredData, contentSummary || `Found ${total} memories for "${validated.query}".`, {
     contentSummary,
-    includeSerializedStructuredContent: false
+    structuredContentPathHint: "results",
+    includeSerializedStructuredContent: validated.structured
   });
 }
 function capitalize(str) {
@@ -769,7 +771,7 @@ async function handleMemoryRecap(params, db2) {
   };
   return createMcpResponse(structuredData, contentSummary || "", {
     contentSummary,
-    includeSerializedStructuredContent: false
+    includeSerializedStructuredContent: validated.structured
   });
 }
 function capitalize2(str) {
@@ -940,7 +942,7 @@ async function handleTaskList(args, storage) {
   }
   return createMcpResponse(structuredData, contentSummary || "", {
     contentSummary,
-    includeSerializedStructuredContent: false
+    includeSerializedStructuredContent: isStructuredRequest
   });
 }
 async function handleTaskCreate(args, storage) {
@@ -977,6 +979,11 @@ async function handleTaskCreate(args, storage) {
         }
       }
       const statusTimestamps2 = deriveTaskStatusTimestamps(normalizedStatus, now2);
+      const tags2 = [...taskData.tags || []];
+      const phaseTag2 = `phase:${taskData.phase}`;
+      if (!tags2.includes(phaseTag2)) {
+        tags2.push(phaseTag2);
+      }
       const task2 = {
         id: randomUUID2(),
         repo,
@@ -995,7 +1002,7 @@ async function handleTaskCreate(args, storage) {
         finished_at: statusTimestamps2.finished_at,
         canceled_at: statusTimestamps2.canceled_at,
         est_tokens: taskData.est_tokens ?? 0,
-        tags: taskData.tags || [],
+        tags: tags2,
         metadata: taskData.metadata || {},
         parent_id: taskData.parent_id || null,
         depends_on: taskData.depends_on || null
@@ -1042,6 +1049,11 @@ async function handleTaskCreate(args, storage) {
   const taskId = randomUUID2();
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const statusTimestamps = deriveTaskStatusTimestamps(status || "backlog", now);
+  const finalTags = [...singleTask.tags || []];
+  const phaseTag = `phase:${phase}`;
+  if (!finalTags.includes(phaseTag)) {
+    finalTags.push(phaseTag);
+  }
   const task = {
     id: taskId,
     repo,
@@ -1060,7 +1072,7 @@ async function handleTaskCreate(args, storage) {
     finished_at: statusTimestamps.finished_at,
     canceled_at: statusTimestamps.canceled_at,
     est_tokens: est_tokens ?? 0,
-    tags: tags || [],
+    tags: finalTags,
     metadata: metadata || {},
     parent_id: parent_id || null,
     depends_on: depends_on || null
@@ -1200,7 +1212,8 @@ async function handleTaskUpdate(args, storage, vectors2) {
       if (!comment || comment.trim() === "") {
         throw new Error("comment is required when changing task status");
       }
-      if ((existingTask.status === "backlog" || existingTask.status === "pending" || existingTask.status === "blocked") && updates.status === "completed") {
+      const isStartable = existingTask.status === "backlog" || existingTask.status === "pending" || existingTask.status === "blocked";
+      if (isStartable && updates.status === "completed") {
         throw new Error(
           `Cannot transition task ${targetId} from '${existingTask.status}' directly to 'completed'. Must be 'in_progress' first.`
         );
@@ -1213,6 +1226,18 @@ async function handleTaskUpdate(args, storage, vectors2) {
       throw new Error(`Duplicate task_code: '${updates.task_code}' already exists`);
     }
     const finalUpdates = { ...updates };
+    if (updates.phase !== void 0 || updates.tags !== void 0) {
+      let currentTags = updates.tags || existingTask.tags || [];
+      currentTags = currentTags.filter((t) => !t.startsWith("phase:"));
+      const finalPhase = updates.phase !== void 0 ? updates.phase : existingTask.phase;
+      if (finalPhase) {
+        const phaseTag = `phase:${finalPhase}`;
+        if (!currentTags.includes(phaseTag)) {
+          currentTags.push(phaseTag);
+        }
+      }
+      finalUpdates.tags = currentTags;
+    }
     if (updates.status === "completed") finalUpdates.finished_at = now;
     else if (updates.status === "canceled") finalUpdates.canceled_at = now;
     else if (updates.status === "in_progress" && existingTask.status !== "in_progress")
@@ -1591,7 +1616,8 @@ async function handleMemoryAcknowledge(params, db2) {
 // src/mcp/tools/memory.detail.ts
 async function handleMemoryDetail(args, storage) {
-  const { id, code } = MemoryDetailSchema.parse(args);
+  const validated = MemoryDetailSchema.parse(args);
+  const { id, code } = validated;
   let memory;
   if (id) {
     memory = storage.memories.getById(id);
@@ -1618,7 +1644,7 @@ async function handleMemoryDetail(args, storage) {
   const content = lines.join("\n");
   return createMcpResponse(memory, content, {
     contentSummary: content,
-    includeSerializedStructuredContent: false
+    includeSerializedStructuredContent: validated.structured
   });
 }
@@ -1670,7 +1696,7 @@ async function handleTaskGet(args, storage) {
   };
   return createMcpResponse(structuredData, contentSummary || "", {
     contentSummary,
-    includeSerializedStructuredContent: false
+    includeSerializedStructuredContent: isStructuredRequest
   });
 }

package/dist/prompts/export-task-to-github.md ADDED Viewed

@@ -0,0 +1,61 @@
+---
+name: export-task-to-github
+description: Guide for exporting local tasks from Local Memory MCP to GitHub Issues
+arguments:
+  - name: owner
+    description: GitHub repository owner (e.g., 'vheins')
+    required: true
+  - name: repo
+    description: GitHub repository name (e.g., 'local-memory-mcp')
+    required: true
+  - name: task_id
+    description: Unique ID of the local task to export
+    required: true
+agent: Integration Architect
+---
+# Skill: export-task-to-github
+## Purpose
+You are an **Integration Architect**. Your goal is to export a specific local task from our `local-memory-mcp` system into a high-quality **GitHub Issue**.
+## Instructions
+### 1. Task Retrieval (MANDATORY)
+1.  **Fetch Task Details**: Call `local-memory-mcp` MCP tool `task-detail` using the provided `task_id`.
+2.  **Verify Content**: Ensure the task has a clear title and description. If information is missing, use `memory-search` to find related context.
+### 2. GitHub Sync & Conflict Check
+1.  **Search Existing Issues**: Use `github-mcp-server`'s `search_issues` tool. Search for the local `task_code` (e.g., "FEAT-123") or similar keywords in the target repository.
+2.  **Avoid Duplicates**: If a Github issue for this task already exists, do NOT create a new one. Instead, update the local task with the existing Github issue URL in metadata.
+### 3. Issue Creation
+If no duplicate is found, create the GitHub issue using `github-mcp-server`'s `issue_write` (method: 'create'):
+-   **Title**: Use the local task title exactly.
+-   **Body**: Use the local task description exactly.
+-   **Metadata**: Include the local `task_code` and `task_id` at the bottom of the body for traceability.
+-   **Initial Comment**: If the local task has existing comments, post them as the first comment on the newly created GitHub issue using `add_issue_comment`.
+### 4. Linkage & Cleanup
+1.  **Update Local Task**: Once the GitHub issue is created, get the Issue Number and URL.
+2.  **Task Update**: Use `local-memory-mcp` tool `task-update` to:
+    -   Add the GitHub URL to `metadata`.
+    -   Add a comment stating "Exported to GitHub Issue #{{number}}".
+### 5. Confirmation
+Provide the link to the newly created (or existing) GitHub issue.
+---
+### ✅ ALLOWED OUTPUT (STRICT)
+Your output MUST ONLY consist of calls to:
+- `mcp_local-memory_task-detail`
+- `mcp_local-memory_task-update`
+- `mcp_github-mcp-server_search_issues`
+- `mcp_github-mcp-server_issue_write`
+- `mcp_github-mcp-server_add_issue_comment`
+**❌ DO NOT:**
+- Output explanations or narrative text during execution.
+- Modify the original title or description of the task when exporting.
+- Create duplicate issues.

package/dist/prompts/import-github-issues.md CHANGED Viewed

@@ -13,11 +13,16 @@ Please follow these steps:
 2. **Review Existing Tasks**: Call `local-memory-mcp` MCP tools `task-list` for the current repository to identify tasks already imported.
 3. **Map and Create**: For each relevant issue that hasn't been imported yet:
    - Use 'task-manage' with action='create'.
+   - **MANDATORY**: Keep the original GitHub **title** and **description** exactly as they are. Do NOT summarize or modify them.
    - Set 'task_code' to 'GH-{{issue_number}}' (e.g., GH-123).
    - Set 'title' to the issue title.
-   - Set 'description' to the issue body (abbreviate if extremely long).
+   - Set 'description' to the issue body.
    - Map GitHub labels to 'tags' if applicable.
    - Default 'phase' to 'backlog' or 'triage'.
    - Set 'metadata' to include the original GitHub URL.
-4. **Avoid Duplicates**: Do not import issues that already have a corresponding 'GH-{{number}}' task code in our system.
-5. **Confirmation**: Provide a summary of how many tasks were successfully created.
+4. **Import Comments**: If the issue has comments:
+   - Use `github-mcp-server`'s `issue_read` tool with `method='get_comments'` to fetch all comments.
+   - For each comment, add it to the created task using the `task-update` tool, appending it to the `comments` array or adding a specific comment metadata.
+5. **Avoid Duplicates**: Do not import issues that already have a corresponding 'GH-{{number}}' task code in our system.
+6. **Confirmation**: Provide a summary of how many tasks were successfully created.

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
 	"name": "@vheins/local-memory-mcp",
-	"version": "0.7.2",
+	"version": "0.7.3",
 	"description": "MCP Local Memory Service for coding copilot agents",
 	"mcpName": "io.github.vheins/local-memory-mcp",
 	"type": "module",
@@ -38,6 +38,7 @@
 		"both": "npm run start & npm run dashboard",
 		"test": "vitest --run",
 		"test:watch": "vitest",
+		"type-check": "tsc --noEmit && svelte-check --tsconfig ./src/dashboard/ui/tsconfig.json",
 		"lint": "eslint . --ext .ts,.svelte",
 		"lint:fix": "eslint . --ext .ts,.svelte --fix",
 		"format": "prettier --write \"src/**/*.{ts,js,svelte}\""