@vheins/local-memory-mcp 0.7.2 → 0.7.4

package/dist/mcp/server.js

@@ -42,7 +42,7 @@ import {
   setLogLevel,
   updateSessionFromInitialize,
   updateSessionRoots
-} from "../chunk-J4O2HJ2K.js";
+} from "../chunk-BSASVWKJ.js";
 
 // src/mcp/server.ts
 import readline from "readline";
@@ -214,7 +214,7 @@ function createMcpResponse(data, summary, options) {
     resourceLinks,
     structuredContentPathHint,
     contentSummary,
-    includeSerializedStructuredContent = "auto"
+    includeSerializedStructuredContent = false
   } = 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;
 }
@@ -408,11 +411,12 @@ async function handleMemoryStore(params, db2, vectors2) {
     {
       contentSummary: `Stored [${entry.code}] "${entry.title}" in repo "${entry.scope.repo}".`,
       structuredContentPathHint: "code",
+      includeSerializedStructuredContent: validated.structured,
       resourceLinks: [
         {
           uri: `memory://${entry.id}`,
           name: entry.title,
-          description: `Stored memory in repo ${entry.scope.repo}`,
+          description: `Stored memory [${entry.code}] in repo ${entry.scope.repo}`,
           mimeType: "application/json",
           annotations: {
             audience: ["assistant"],
@@ -486,11 +490,12 @@ async function handleMemoryUpdate(params, db2, vectors2) {
     `Updated memory ${validated.id} in repo "${existing.scope.repo}". Fields: ${Object.keys(updates).join(", ") || "none"}.`,
     {
       structuredContentPathHint: "updatedFields",
+      includeSerializedStructuredContent: validated.structured,
       resourceLinks: [
         {
           uri: `memory://${validated.id}`,
           name: existing.title || validated.id,
-          description: `Updated memory in repo ${existing.scope.repo}`,
+          description: `Updated memory [${existing.code}] in repo ${existing.scope.repo}`,
           mimeType: "application/json",
           annotations: {
             audience: ["assistant"],
@@ -622,23 +627,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 +655,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) {
@@ -673,7 +677,7 @@ async function handleMemorySummarize(params, db2) {
 ${fullSummary}`;
   return createMcpResponse(null, content, {
     contentSummary: content,
-    includeSerializedStructuredContent: false
+    includeSerializedStructuredContent: validated.structured
   });
 }
 
@@ -769,7 +773,7 @@ async function handleMemoryRecap(params, db2) {
   };
   return createMcpResponse(structuredData, contentSummary || "", {
     contentSummary,
-    includeSerializedStructuredContent: false
+    includeSerializedStructuredContent: validated.structured
   });
 }
 function capitalize2(str) {
@@ -900,7 +904,7 @@ async function handleTaskList(args, storage) {
     query,
     limit,
     offset,
-    structured: isStructuredRequest
+    structured: isStructuredRequest = false
   } = validated;
   let statuses = [];
   if (status !== "all") {
@@ -940,7 +944,19 @@ async function handleTaskList(args, storage) {
   }
   return createMcpResponse(structuredData, contentSummary || "", {
     contentSummary,
-    includeSerializedStructuredContent: false
+    includeSerializedStructuredContent: isStructuredRequest,
+    resourceLinks: [
+      {
+        uri: `repository://${encodeURIComponent(repo)}/tasks`,
+        name: `Task Index (${repo})`,
+        description: `Repository task index for ${repo}`,
+        mimeType: "application/json",
+        annotations: {
+          audience: ["assistant"],
+          priority: 0.6
+        }
+      }
+    ]
   });
 }
 async function handleTaskCreate(args, storage) {
@@ -977,6 +993,11 @@ async function handleTaskCreate(args, storage) {
         }
       }
       const statusTimestamps2 = deriveTaskStatusTimestamps(normalizedStatus, now2);
+      const tags = [...taskData.tags || []];
+      const phaseTag2 = `phase:${taskData.phase}`;
+      if (!tags.includes(phaseTag2)) {
+        tags.push(phaseTag2);
+      }
       const task2 = {
         id: randomUUID2(),
         repo,
@@ -995,17 +1016,52 @@ 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,
         metadata: taskData.metadata || {},
         parent_id: taskData.parent_id || null,
         depends_on: taskData.depends_on || null
       };
       storage.tasks.insertTask(task2);
       createdTasks.push(task2.task_code);
+      task2._temp_id = task2.id;
     }
+    const resourceLinks = bulkTasks.slice(0, 10).map((t) => {
+      const taskCode = t.task_code;
+      const taskId2 = t._temp_id;
+      return {
+        uri: `task://${taskId2}`,
+        name: `Task [${taskCode}]`,
+        description: `Created task [${taskCode}] in repo ${repo}`,
+        mimeType: "application/json",
+        annotations: {
+          audience: ["assistant"],
+          priority: 0.9
+        }
+      };
+    });
+    resourceLinks.push({
+      uri: `repository://${encodeURIComponent(repo)}/tasks`,
+      name: `Task Index (${repo})`,
+      description: `Repository task index for ${repo}`,
+      mimeType: "application/json",
+      annotations: {
+        audience: ["assistant"],
+        priority: 0.6
+      }
+    });
     return createMcpResponse(
       { success: true, repo, createdCount: bulkTasks.length, taskCodes: createdTasks },
-      `Created ${bulkTasks.length} tasks in repo "${repo}".`
+      `Created ${bulkTasks.length} tasks in repo "${repo}".`,
+      {
+        includeSerializedStructuredContent: parsed.structured || false,
+        resourceLinks: resourceLinks.map((link) => ({
+          ...link,
+          annotations: {
+            ...link.annotations,
+            audience: link.annotations.audience
+          }
+        }))
+      }
     );
   }
   const {
@@ -1018,7 +1074,6 @@ async function handleTaskCreate(args, storage) {
     agent,
     role,
     doc_path,
-    tags,
     metadata,
     parent_id,
     depends_on,
@@ -1042,6 +1097,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 +1120,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
@@ -1078,7 +1138,32 @@ async function handleTaskCreate(args, storage) {
       priority: task.priority,
       depends_on: task.depends_on
     },
-    `Created task [${task.task_code}] ${task.title} in repo "${task.repo}" with status "${task.status}".`
+    `Created task [${task.task_code}] ${task.title} in repo "${task.repo}" with status "${task.status}".`,
+    {
+      includeSerializedStructuredContent: parsed.structured || false,
+      resourceLinks: [
+        {
+          uri: `task://${task.id}`,
+          name: `Task [${task.task_code}]`,
+          description: `Created task [${task.task_code}] in repo ${task.repo}`,
+          mimeType: "application/json",
+          annotations: {
+            audience: ["assistant"],
+            priority: 0.9
+          }
+        },
+        {
+          uri: `repository://${encodeURIComponent(task.repo)}/tasks`,
+          name: `Task Index (${task.repo})`,
+          description: `Repository task index for ${task.repo}`,
+          mimeType: "application/json",
+          annotations: {
+            audience: ["assistant"],
+            priority: 0.6
+          }
+        }
+      ]
+    }
   );
 }
 async function handleTaskCreateInteractive(args, storage, options = {}) {
@@ -1187,6 +1272,7 @@ async function handleTaskUpdate(args, storage, vectors2) {
     throw new Error("Either 'id' or 'ids' must be provided for update");
   }
   let updatedCount = 0;
+  const updatedTasks = [];
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const isStatusChangingGlobal = updates.status !== void 0;
   for (const targetId of targetIds) {
@@ -1200,7 +1286,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 +1300,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")
@@ -1235,8 +1334,29 @@ async function handleTaskUpdate(args, storage, vectors2) {
     if (updates.status === "completed" && existingTask.status !== "completed") {
       await archiveTaskToMemory(targetId, repo, storage, vectors2);
     }
+    updatedTasks.push({ id: targetId, code: updates.task_code || existingTask.task_code });
     updatedCount++;
   }
+  const resourceLinks = updatedTasks.slice(0, 10).map((t) => ({
+    uri: `task://${t.id}`,
+    name: `Task [${t.code}]`,
+    description: `Updated task [${t.code}] in repo ${repo}`,
+    mimeType: "application/json",
+    annotations: {
+      audience: ["assistant"],
+      priority: 0.9
+    }
+  }));
+  resourceLinks.push({
+    uri: `repository://${encodeURIComponent(repo)}/tasks`,
+    name: `Task Index (${repo})`,
+    description: `Repository task index for ${repo}`,
+    mimeType: "application/json",
+    annotations: {
+      audience: ["assistant"],
+      priority: 0.6
+    }
+  });
   return createMcpResponse(
     {
       success: true,
@@ -1247,11 +1367,22 @@ async function handleTaskUpdate(args, storage, vectors2) {
       updatedCount,
       updatedFields: Object.keys(updates)
     },
-    `Updated ${updatedCount} task(s) in repo "${repo}".`
+    `Updated ${updatedCount} task(s) in repo "${repo}".`,
+    {
+      includeSerializedStructuredContent: updateData.structured,
+      resourceLinks: resourceLinks.map((link) => ({
+        ...link,
+        annotations: {
+          ...link.annotations,
+          audience: link.annotations.audience
+        }
+      }))
+    }
   );
 }
 async function handleTaskDelete(args, storage) {
-  const { repo, id, ids } = TaskDeleteSchema.parse(args);
+  const validated = TaskDeleteSchema.parse(args);
+  const { repo, id, ids } = validated;
   const targetIds = ids || (id ? [id] : []);
   if (targetIds.length === 0) {
     throw new Error("Either 'id' or 'ids' must be provided for deletion");
@@ -1267,7 +1398,22 @@ async function handleTaskDelete(args, storage) {
       repo,
       deletedCount: targetIds.length
     },
-    `Deleted ${targetIds.length} task(s) from repo "${repo}".`
+    `Deleted ${targetIds.length} task(s) from repo "${repo}".`,
+    {
+      includeSerializedStructuredContent: validated.structured,
+      resourceLinks: [
+        {
+          uri: `repository://${encodeURIComponent(repo)}/tasks`,
+          name: `Task Index (${repo})`,
+          description: `Repository task index for ${repo}`,
+          mimeType: "application/json",
+          annotations: {
+            audience: ["assistant"],
+            priority: 0.6
+          }
+        }
+      ]
+    }
   );
 }
 
@@ -1381,7 +1527,8 @@ ${contextBlock || "No additional context provided."}`
     },
     `Synthesized answer for "${validated.objective}" using repository "${repo}".`,
     {
-      structuredContentPathHint: "answer"
+      structuredContentPathHint: "answer",
+      includeSerializedStructuredContent: validated.structured
     }
   );
 }
@@ -1503,12 +1650,14 @@ async function executeSamplingTool(toolName, rawInput, db2, vectors2) {
 
 // src/mcp/tools/memory.delete.ts
 async function handleMemoryDelete(params, db2, vectors2, onProgress) {
-  const { id, ids, repo } = MemoryDeleteSchema.parse(params);
+  const validated = MemoryDeleteSchema.parse(params);
+  const { id, ids, repo, structured } = validated;
   const targetIds = ids || (id ? [id] : []);
   if (targetIds.length === 0) {
     throw new Error("Either 'id' or 'ids' must be provided for deletion");
   }
   let deletedCount = 0;
+  const deletedCodes = [];
   let lastRepo = repo || "unknown";
   const total = targetIds.length;
   let progress = 0;
@@ -1519,6 +1668,7 @@ async function handleMemoryDelete(params, db2, vectors2, onProgress) {
     const existing = db2.memories.getById(targetId);
     if (existing) {
       lastRepo = existing.scope.repo;
+      deletedCodes.push(existing.code || existing.id);
       db2.memories.delete(targetId);
       await vectors2.remove(targetId);
       deletedCount++;
@@ -1537,11 +1687,13 @@ async function handleMemoryDelete(params, db2, vectors2, onProgress) {
       id: id || void 0,
       ids: ids || void 0,
       repo: lastRepo,
-      deletedCount
+      deletedCount,
+      deletedCodes: deletedCount > 10 ? [...deletedCodes.slice(0, 10), "..."] : deletedCodes
     },
-    `Deleted ${deletedCount} memory entry(ies) from repo "${lastRepo}".`,
+    `Deleted ${deletedCount} memory entry(ies) ${deletedCount > 0 ? `([${deletedCodes.slice(0, 10).join(", ")}${deletedCount > 10 ? ", ..." : ""}]) ` : ""}from repo "${lastRepo}".`,
     {
       structuredContentPathHint: "deletedCount",
+      includeSerializedStructuredContent: structured,
       resourceLinks: [
         {
           uri: `repository://${encodeURIComponent(lastRepo)}/memories`,
@@ -1582,16 +1734,18 @@ async function handleMemoryAcknowledge(params, db2) {
       id: memory.id,
       status: validated.status
     },
-    `Acknowledged memory ${memory.id} as "${validated.status}".`,
+    `Acknowledged memory [${memory.code}] as "${validated.status}".`,
     {
-      structuredContentPathHint: "status"
+      structuredContentPathHint: "status",
+      includeSerializedStructuredContent: validated.structured
     }
   );
 }
 
 // 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 +1772,7 @@ async function handleMemoryDetail(args, storage) {
   const content = lines.join("\n");
   return createMcpResponse(memory, content, {
     contentSummary: content,
-    includeSerializedStructuredContent: false
+    includeSerializedStructuredContent: validated.structured
   });
 }
 
@@ -1670,7 +1824,7 @@ async function handleTaskGet(args, storage) {
   };
   return createMcpResponse(structuredData, contentSummary || "", {
     contentSummary,
-    includeSerializedStructuredContent: false
+    includeSerializedStructuredContent: isStructuredRequest
   });
 }
 

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

@@ -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

@@ -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

@@ -1,6 +1,6 @@
 {
 	"name": "@vheins/local-memory-mcp",
-	"version": "0.7.2",
+	"version": "0.7.4",
 	"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}\""