@vheins/local-memory-mcp 0.13.0 → 0.13.2

package/dist/{chunk-RHDBF7HU.js → chunk-O4B6AFYU.js}

@@ -81,8 +81,8 @@ function loadServerInstructions() {
 // src/mcp/capabilities.ts
 var __dirname2 = path2.dirname(fileURLToPath2(import.meta.url));
 var pkgVersion = "0.1.0";
-if ("0.13.0") {
-  pkgVersion = "0.13.0";
+if ("0.13.2") {
+  pkgVersion = "0.13.2";
 } else {
   let searchDir = __dirname2;
   for (let i = 0; i < 5; i++) {
@@ -3206,7 +3206,8 @@ var MemoryStoreSchema = z.object({
   structured: z.boolean().default(false)
 });
 var MemoryUpdateSchema = z.object({
-  id: z.string().uuid(),
+  id: z.string().uuid().optional(),
+  code: z.string().max(20).optional(),
   type: MemoryTypeSchema.optional(),
   title: z.string().min(3).max(255).optional(),
   content: z.string().min(10).optional(),
@@ -3220,6 +3221,8 @@ var MemoryUpdateSchema = z.object({
   is_global: z.boolean().optional(),
   completed_at: z.string().optional(),
   structured: z.boolean().default(false)
+}).refine((data) => data.id !== void 0 || data.code !== void 0, {
+  message: "Either id or code must be provided"
 }).refine(
   (data) => data.type !== void 0 || data.content !== void 0 || data.title !== void 0 || data.importance !== void 0 || data.status !== void 0 || data.supersedes !== void 0 || data.tags !== void 0 || data.metadata !== void 0 || data.is_global !== void 0 || data.agent !== void 0 || data.role !== void 0 || data.completed_at !== void 0,
   { message: "At least one field must be provided for update" }
@@ -3240,10 +3243,13 @@ var MemorySearchSchema = z.object({
   structured: z.boolean().default(false)
 });
 var MemoryAcknowledgeSchema = z.object({
-  memory_id: z.string().uuid(),
+  memory_id: z.string().uuid().optional(),
+  code: z.string().max(20).optional(),
   status: z.enum(["used", "irrelevant", "contradictory"]),
   application_context: z.string().min(10).optional(),
   structured: z.boolean().default(false)
+}).refine((data) => data.memory_id !== void 0 || data.code !== void 0, {
+  message: "Either memory_id or code must be provided"
 });
 var MemoryRecapSchema = z.object({
   repo: z.string().min(1).transform(normalizeRepo),
@@ -3255,9 +3261,11 @@ var MemoryDeleteSchema = z.object({
   repo: z.string().min(1).transform(normalizeRepo).optional(),
   id: z.string().uuid().optional(),
   ids: z.array(z.string().uuid()).min(1).optional(),
+  code: z.string().max(20).optional(),
+  codes: z.array(z.string().max(20)).min(1).optional(),
   structured: z.boolean().default(false)
-}).refine((data) => data.id !== void 0 || data.ids !== void 0, {
-  message: "Either 'id' or 'ids' must be provided for deletion"
+}).refine((data) => data.id !== void 0 || data.ids !== void 0 || data.code !== void 0 || data.codes !== void 0, {
+  message: "Either 'id', 'ids', 'code', or 'codes' must be provided for deletion"
 });
 var MemorySummarizeSchema = z.object({
   repo: z.string().min(1).transform(normalizeRepo),
@@ -3374,9 +3382,10 @@ var TaskDeleteSchema = z.object({
   repo: z.string().min(1).transform(normalizeRepo),
   id: z.string().uuid().optional(),
   ids: z.array(z.string().uuid()).min(1).optional(),
+  task_code: z.string().optional(),
   structured: z.boolean().default(false)
-}).refine((data) => data.id !== void 0 || data.ids !== void 0, {
-  message: "Either 'id' or 'ids' must be provided for deletion"
+}).refine((data) => data.id !== void 0 || data.ids !== void 0 || data.task_code !== void 0, {
+  message: "Either 'id', 'ids', or 'task_code' must be provided for deletion"
 });
 var MemoryDetailSchema = z.object({
   id: z.string().uuid().optional(),
@@ -3396,9 +3405,11 @@ var StandardDeleteSchema = z.object({
   repo: z.string().min(1).transform(normalizeRepo).optional(),
   id: z.string().uuid().optional(),
   ids: z.array(z.string().uuid()).min(1).optional(),
+  code: z.string().max(20).optional(),
+  codes: z.array(z.string().max(20)).min(1).optional(),
   structured: z.boolean().default(false)
-}).refine((data) => data.id !== void 0 || data.ids !== void 0, {
-  message: "Either 'id' or 'ids' must be provided for deletion"
+}).refine((data) => data.id !== void 0 || data.ids !== void 0 || data.code !== void 0 || data.codes !== void 0, {
+  message: "Either 'id', 'ids', 'code', or 'codes' must be provided for deletion"
 });
 var TaskGetSchema = z.object({
   repo: z.string().min(1).transform(normalizeRepo),
@@ -3494,7 +3505,8 @@ var StandardStoreSchema = z.object({
   message: "repo is required for repo-specific standards"
 });
 var StandardUpdateSchema = z.object({
-  id: z.string().uuid(),
+  id: z.string().uuid().optional(),
+  code: z.string().max(20).optional(),
   name: z.string().min(3).max(255).optional(),
   content: z.string().min(10).optional(),
   parent_id: z.string().uuid().nullable().optional(),
@@ -3509,6 +3521,8 @@ var StandardUpdateSchema = z.object({
   agent: z.string().optional(),
   model: z.string().optional(),
   structured: z.boolean().default(false)
+}).refine((data) => data.id !== void 0 || data.code !== void 0, {
+  message: "Either id or code must be provided"
 }).refine(
   (data) => data.name !== void 0 || data.content !== void 0 || data.parent_id !== void 0 || data.context !== void 0 || data.version !== void 0 || data.language !== void 0 || data.stack !== void 0 || data.repo !== void 0 || data.is_global !== void 0 || data.tags !== void 0 || data.metadata !== void 0 || data.agent !== void 0 || data.model !== void 0,
   { message: "At least one field must be provided for update" }
@@ -3781,12 +3795,13 @@ var TOOL_DEFINITIONS = [
     inputSchema: {
       type: "object",
       properties: {
-        memory_id: { type: "string", format: "uuid" },
+        memory_id: { type: "string", format: "uuid", description: "Memory entry ID. Optional if code is provided." },
+        code: { type: "string", maxLength: 20, description: "Short memory code. Optional if memory_id is provided." },
         status: { type: "string", enum: ["used", "irrelevant", "contradictory"] },
         application_context: { type: "string", minLength: 10 },
         structured: { type: "boolean", default: false, description: "If true, returns structured JSON result." }
       },
-      required: ["memory_id", "status"]
+      required: ["status"]
     },
     outputSchema: {
       type: "object",
@@ -3811,7 +3826,8 @@ var TOOL_DEFINITIONS = [
     inputSchema: {
       type: "object",
       properties: {
-        id: { type: "string", format: "uuid" },
+        id: { type: "string", format: "uuid", description: "Memory entry ID. Optional if code is provided." },
+        code: { type: "string", maxLength: 20, description: "Short memory code. Optional if id is provided." },
         type: {
           type: "string",
           enum: ["code_fact", "decision", "mistake", "pattern", "task_archive"]
@@ -3832,21 +3848,21 @@ var TOOL_DEFINITIONS = [
           default: false,
           description: "If true, returns structured JSON of the updated memory."
         }
-      },
-      required: ["id"]
+      }
     },
     outputSchema: {
       type: "object",
       properties: {
         success: { type: "boolean" },
         id: { type: "string" },
+        code: { type: "string" },
         repo: { type: "string" },
         updatedFields: {
           type: "array",
           items: { type: "string" }
         }
       },
-      required: ["success", "id", "repo", "updatedFields"]
+      required: ["success", "repo", "updatedFields"]
     }
   },
   {
@@ -3976,13 +3992,20 @@ var TOOL_DEFINITIONS = [
       type: "object",
       properties: {
         repo: { type: "string", description: "Repository name (optional for single id)" },
-        id: { type: "string", format: "uuid", description: "Memory entry ID to delete" },
+        id: { type: "string", format: "uuid", description: "Memory entry ID to delete. Optional if code is provided." },
         ids: {
           type: "array",
           items: { type: "string", format: "uuid" },
           minItems: 1,
           description: "Array of memory IDs to delete"
         },
+        code: { type: "string", maxLength: 20, description: "Short memory code. Optional if id is provided." },
+        codes: {
+          type: "array",
+          items: { type: "string", maxLength: 20 },
+          minItems: 1,
+          description: "Array of memory codes to delete"
+        },
         structured: { type: "boolean", default: false, description: "If true, returns structured JSON result." }
       }
     },
@@ -3991,7 +4014,9 @@ var TOOL_DEFINITIONS = [
       properties: {
         success: { type: "boolean" },
         id: { type: "string" },
+        code: { type: "string" },
         ids: { type: "array", items: { type: "string" } },
+        codes: { type: "array", items: { type: "string" } },
         repo: { type: "string" },
         deletedCount: { type: "number" }
       },
@@ -4012,13 +4037,20 @@ var TOOL_DEFINITIONS = [
       type: "object",
       properties: {
         repo: { type: "string", description: "Repository name (optional for single id)" },
-        id: { type: "string", format: "uuid", description: "Coding standard ID to delete" },
+        id: { type: "string", format: "uuid", description: "Coding standard ID to delete. Optional if code is provided." },
         ids: {
           type: "array",
           items: { type: "string", format: "uuid" },
           minItems: 1,
           description: "Array of coding standard IDs to delete"
         },
+        code: { type: "string", maxLength: 20, description: "Short standard code. Optional if id is provided." },
+        codes: {
+          type: "array",
+          items: { type: "string", maxLength: 20 },
+          minItems: 1,
+          description: "Array of standard codes to delete"
+        },
         structured: { type: "boolean", default: false, description: "If true, returns structured JSON result." }
       }
     },
@@ -4027,7 +4059,9 @@ var TOOL_DEFINITIONS = [
       properties: {
         success: { type: "boolean" },
         id: { type: "string" },
+        code: { type: "string" },
         ids: { type: "array", items: { type: "string" } },
+        codes: { type: "array", items: { type: "string" } },
         repo: { type: "string" },
         deletedCount: { type: "number" }
       },
@@ -4306,8 +4340,9 @@ var TOOL_DEFINITIONS = [
       type: "object",
       properties: {
         repo: { type: "string", description: "Repository name" },
-        id: { type: "string", format: "uuid", description: "Task ID (for single deletion)" },
+        id: { type: "string", format: "uuid", description: "Task ID (for single deletion). Optional if task_code is provided." },
         ids: { type: "array", items: { type: "string", format: "uuid" }, description: "Task IDs (for bulk deletion)" },
+        task_code: { type: "string", description: "Task code (e.g. TASK-001). Optional if id is provided." },
         structured: { type: "boolean", default: false, description: "If true, returns structured JSON result." }
       },
       required: ["repo"]
@@ -4317,6 +4352,7 @@ var TOOL_DEFINITIONS = [
       properties: {
         success: { type: "boolean" },
         id: { type: "string" },
+        task_code: { type: "string" },
         ids: { type: "array", items: { type: "string" } },
         repo: { type: "string" },
         deletedCount: { type: "number" }
@@ -4762,7 +4798,8 @@ var TOOL_DEFINITIONS = [
     inputSchema: {
       type: "object",
       properties: {
-        id: { type: "string", description: "Standard ID to update" },
+        id: { type: "string", format: "uuid", description: "Standard ID to update. Optional if code is provided." },
+        code: { type: "string", maxLength: 20, description: "Short standard code. Optional if id is provided." },
         name: { type: "string", minLength: 3, maxLength: 255 },
         content: { type: "string", minLength: 10 },
         parent_id: { type: "string", format: "uuid", nullable: true },
@@ -4777,8 +4814,7 @@ var TOOL_DEFINITIONS = [
         agent: { type: "string" },
         model: { type: "string" },
         structured: { type: "boolean", default: false }
-      },
-      required: ["id"]
+      }
     },
     outputSchema: {
       type: "object",

package/dist/dashboard/server.js

@@ -10,7 +10,7 @@ import {
   createFileSink,
   listResources,
   logger
-} from "../chunk-RHDBF7HU.js";
+} from "../chunk-O4B6AFYU.js";
 
 // src/dashboard/server.ts
 import express from "express";
@@ -744,7 +744,9 @@ var TasksController = class {
           toolArgs.est_tokens = existingTask.est_tokens || 0;
         }
         if (toolArgs.commit_id === void 0) {
-          toolArgs.commit_id = existingTask.commit_id || null;
+          if (existingTask.commit_id) {
+            toolArgs.commit_id = existingTask.commit_id;
+          }
         }
         if (toolArgs.changed_files === void 0) {
           toolArgs.changed_files = existingTask.changed_files || [];

package/dist/mcp/server.js

@@ -57,7 +57,7 @@ import {
   toContextSlug,
   updateSessionFromInitialize,
   updateSessionRoots
-} from "../chunk-RHDBF7HU.js";
+} from "../chunk-O4B6AFYU.js";
 
 // src/mcp/server.ts
 import readline from "readline";
@@ -416,9 +416,17 @@ function hasMetadataLikeTitle2(title) {
 }
 async function handleMemoryUpdate(params, db2, vectors2) {
   const validated = MemoryUpdateSchema.parse(params);
-  const existing = db2.memories.getById(validated.id);
+  let resolvedId = validated.id;
+  if (!resolvedId && validated.code) {
+    const byCode = db2.memories.getByCode(validated.code);
+    if (!byCode) throw new Error(`Memory not found: ${validated.code}`);
+    resolvedId = byCode.id;
+  } else if (!resolvedId) {
+    throw new Error("Either id or code must be provided");
+  }
+  const existing = db2.memories.getById(resolvedId);
   if (!existing) {
-    throw new Error(`Memory not found: ${validated.id}`);
+    throw new Error(`Memory not found: ${resolvedId}`);
   }
   const repoFilter = params?.repo || params?.scope?.repo;
   if (repoFilter && repoFilter !== existing.scope.repo) {
@@ -444,20 +452,21 @@ async function handleMemoryUpdate(params, db2, vectors2) {
   if (validated.metadata !== void 0) updates.metadata = validated.metadata;
   if (validated.is_global !== void 0) updates.is_global = validated.is_global;
   if (validated.completed_at !== void 0) updates.completed_at = validated.completed_at;
-  db2.memories.update(validated.id, updates);
+  db2.memories.update(resolvedId, updates);
   if (validated.content !== void 0) {
-    await vectors2.upsert(validated.id, validated.content);
+    await vectors2.upsert(resolvedId, validated.content);
   }
-  db2.actions.logAction("update", existing.scope.repo, { memoryId: validated.id, resultCount: 1 });
-  logger.info("[Tool] memory.update", { repo: existing.scope.repo, id: validated.id, fields: Object.keys(updates) });
+  db2.actions.logAction("update", existing.scope.repo, { memoryId: resolvedId, resultCount: 1 });
+  logger.info("[Tool] memory.update", { repo: existing.scope.repo, id: resolvedId, fields: Object.keys(updates) });
   return createMcpResponse(
     {
       success: true,
-      id: validated.id,
+      id: resolvedId,
+      code: existing.code,
       repo: existing.scope.repo,
       updatedFields: Object.keys(updates)
     },
-    `Updated memory ${validated.id} in repo "${existing.scope.repo}". Fields: ${Object.keys(updates).join(", ") || "none"}.`,
+    `Updated memory ${resolvedId} in repo "${existing.scope.repo}". Fields: ${Object.keys(updates).join(", ") || "none"}.`,
     {
       structuredContentPathHint: "updatedFields",
       includeSerializedStructuredContent: validated.structured
@@ -1306,11 +1315,19 @@ async function handleTaskUpdate(args, storage, vectors2) {
 }
 async function handleTaskDelete(args, storage) {
   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");
+  const { repo, id, ids, task_code } = validated;
+  const resolvedIds = [];
+  if (ids) resolvedIds.push(...ids);
+  if (id) resolvedIds.push(id);
+  if (task_code) {
+    const task = storage.tasks.getTaskByCode(repo, task_code);
+    if (!task) throw new Error(`Task not found: ${task_code}`);
+    resolvedIds.push(task.id);
   }
+  if (resolvedIds.length === 0) {
+    throw new Error("Either 'id', 'ids', or 'task_code' must be provided for deletion");
+  }
+  const targetIds = resolvedIds;
   for (const targetId of targetIds) {
     storage.tasks.deleteTask(targetId);
   }
@@ -1561,11 +1578,26 @@ async function executeSamplingTool(toolName, rawInput, db2, vectors2) {
 // src/mcp/tools/memory.delete.ts
 async function handleMemoryDelete(params, db2, vectors2, onProgress) {
   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");
-  }
+  const { id, ids, code, codes, repo, structured } = validated;
+  const resolvedIds = [];
+  if (ids) resolvedIds.push(...ids);
+  if (id) resolvedIds.push(id);
+  if (code) {
+    const entry = db2.memories.getByCode(code);
+    if (!entry) throw new Error(`Memory not found: ${code}`);
+    resolvedIds.push(entry.id);
+  }
+  if (codes) {
+    for (const c of codes) {
+      const entry = db2.memories.getByCode(c);
+      if (!entry) throw new Error(`Memory not found: ${c}`);
+      resolvedIds.push(entry.id);
+    }
+  }
+  if (resolvedIds.length === 0) {
+    throw new Error("Either 'id', 'ids', 'code', or 'codes' must be provided for deletion");
+  }
+  const targetIds = resolvedIds;
   let deletedCount = 0;
   const deletedCodes = [];
   let lastRepo = repo || "unknown";
@@ -1611,9 +1643,17 @@ async function handleMemoryDelete(params, db2, vectors2, onProgress) {
 // src/mcp/tools/memory.acknowledge.ts
 async function handleMemoryAcknowledge(params, db2) {
   const validated = MemoryAcknowledgeSchema.parse(params);
-  const memory = db2.memories.getById(validated.memory_id);
+  let memoryId = validated.memory_id;
+  if (!memoryId && validated.code) {
+    const byCode = db2.memories.getByCode(validated.code);
+    if (!byCode) throw new Error(`Memory not found: ${validated.code}`);
+    memoryId = byCode.id;
+  } else if (!memoryId) {
+    throw new Error("Either memory_id or code must be provided");
+  }
+  const memory = db2.memories.getById(memoryId);
   if (!memory) {
-    throw new Error(`Memory with ID ${validated.memory_id} not found.`);
+    throw new Error(`Memory with ID ${memoryId} not found.`);
   }
   if (validated.status === "used") {
     db2.memories.incrementRecallCount(memory.id);
@@ -2252,9 +2292,17 @@ async function handleStandardSearch(params, db2, vectors2) {
 // src/mcp/tools/standard.update.ts
 async function handleStandardUpdate(params, db2, vectors2) {
   const validated = StandardUpdateSchema.parse(params);
-  const existing = db2.standards.getById(validated.id);
+  let resolvedId = validated.id;
+  if (!resolvedId && validated.code) {
+    const byCode = db2.standards.getByCode(validated.code);
+    if (!byCode) throw new Error(`Coding standard not found: ${validated.code}`);
+    resolvedId = byCode.id;
+  } else if (!resolvedId) {
+    throw new Error("Either id or code must be provided");
+  }
+  const existing = db2.standards.getById(resolvedId);
   if (!existing) {
-    throw new Error(`Coding standard not found: ${validated.id}`);
+    throw new Error(`Coding standard not found: ${resolvedId}`);
   }
   const updates = {};
   if (validated.name !== void 0) updates.title = validated.name;
@@ -2270,26 +2318,27 @@ async function handleStandardUpdate(params, db2, vectors2) {
   if (validated.metadata !== void 0) updates.metadata = validated.metadata;
   if (validated.agent !== void 0) updates.agent = validated.agent;
   if (validated.model !== void 0) updates.model = validated.model;
-  db2.standards.update(validated.id, updates);
+  db2.standards.update(resolvedId, updates);
   const merged = {
     ...existing,
     ...updates,
     updated_at: (/* @__PURE__ */ new Date()).toISOString()
   };
   if (validated.name !== void 0 || validated.content !== void 0 || validated.context !== void 0 || validated.version !== void 0 || validated.language !== void 0 || validated.stack !== void 0 || validated.tags !== void 0 || validated.metadata !== void 0) {
-    await vectors2.upsert(validated.id, buildStandardVectorText(merged), "standard");
+    await vectors2.upsert(resolvedId, buildStandardVectorText(merged), "standard");
   }
   logger.info("[Tool] standard.update - updated coding standard", {
-    standardId: validated.id,
+    standardId: resolvedId,
     fields: Object.keys(updates)
   });
   return createMcpResponse(
     {
       success: true,
-      id: validated.id,
+      id: resolvedId,
+      code: existing.code,
       updatedFields: Object.keys(updates)
     },
-    `Updated coding standard ${validated.id}. Fields: ${Object.keys(updates).join(", ") || "none"}.`,
+    `Updated coding standard ${resolvedId}. Fields: ${Object.keys(updates).join(", ") || "none"}.`,
     {
       structuredContentPathHint: "updatedFields",
       includeSerializedStructuredContent: true
@@ -2334,11 +2383,26 @@ async function handleStandardDetail(args, storage) {
 // src/mcp/tools/standard.delete.ts
 async function handleStandardDelete(params, db2, vectors2) {
   const validated = StandardDeleteSchema.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");
-  }
+  const { id, ids, code, codes, repo, structured } = validated;
+  const resolvedIds = [];
+  if (ids) resolvedIds.push(...ids);
+  if (id) resolvedIds.push(id);
+  if (code) {
+    const entry = db2.standards.getByCode(code);
+    if (!entry) throw new Error(`Coding standard not found: ${code}`);
+    resolvedIds.push(entry.id);
+  }
+  if (codes) {
+    for (const c of codes) {
+      const entry = db2.standards.getByCode(c);
+      if (!entry) throw new Error(`Coding standard not found: ${c}`);
+      resolvedIds.push(entry.id);
+    }
+  }
+  if (resolvedIds.length === 0) {
+    throw new Error("Either 'id', 'ids', 'code', or 'codes' must be provided for deletion");
+  }
+  const targetIds = resolvedIds;
   let deletedCount = 0;
   const deletedTitles = [];
   let lastRepo = repo || "unknown";

package/dist/prompts/task-memory-executor.md

@@ -94,7 +94,13 @@ agent: Task Executor
    - **Link Dependencies**: Set parent task's `depends_on` to the new blocker-fix task (parent waits for fix before retry)
    - **Skip Creation** (if external): Log that blocker is external, keep task status as `blocked`, no automatic task created.
 
-11. **Repeat**: Claim next task from `task-list`.
+11. **Loop**: Follow `~/.agents/AGENTS.md` → **CONTINUOUS EXECUTION MODE**:
+    - `task-list` (pending) → claim next
+    - If empty → promote backlog → loop
+    - If backlog empty → check stale in_progress → loop
+    - If stale empty → check handoff → loop
+    - **Only then → STOP**
+    - **Violation = incomplete execution**
 
 ## 3. BACKLOG MAINTENANCE
 If active queue is empty:

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vheins/local-memory-mcp",
-	"version": "0.13.0",
+	"version": "0.13.2",
 	"description": "MCP Local Memory Service for coding copilot agents",
 	"mcpName": "io.github.vheins/local-memory-mcp",
 	"type": "module",