@vheins/local-memory-mcp 0.19.13 → 0.19.15

package/dist/{chunk-H7BLOZB6.js → chunk-BPQ42JEQ.js}

@@ -1748,7 +1748,7 @@ var TaskEntity = class extends BaseEntity {
   handleDuplicateTaskCode(err, taskCode, repo) {
     if (isSqliteError(err) && err.code === "SQLITE_CONSTRAINT_UNIQUE") {
       throw new Error(
-        `Duplicate task_code: '${taskCode}' already exists in repository '${repo}'. The task_code must be unique within the repository.`
+        `Duplicate task_code: '${taskCode}' already exists in repository '${repo}'. The task_code must be unique within the repository. Omit task_code to auto-generate a new unique code.`
       );
     }
     throw err;
@@ -3462,10 +3462,94 @@ var RealVectorStore = class {
   }
 };
 
-// src/mcp/session.ts
+// src/mcp/prompts/loader.ts
 import fs4 from "fs";
 import path3 from "path";
 import { fileURLToPath } from "url";
+import matter from "gray-matter";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = path3.dirname(__filename);
+function findPromptDir() {
+  const candidates = [
+    // Production if chunked into dist/
+    "./prompts",
+    // Production if inlined into dist/mcp/
+    "../prompts",
+    // Dev: /src/mcp/prompts/definitions (next to loader.ts)
+    "./definitions"
+  ].map((relPath) => path3.resolve(__dirname, relPath));
+  for (const dir of candidates) {
+    if (fs4.existsSync(dir)) {
+      const files = fs4.readdirSync(dir);
+      if (files.some((f) => f.endsWith(".md"))) {
+        return dir;
+      }
+    }
+  }
+  return path3.resolve(__dirname, "./definitions");
+}
+var PROMPT_DIR = findPromptDir();
+var promptCache = /* @__PURE__ */ new Map();
+function listPromptFiles() {
+  if (!fs4.existsSync(PROMPT_DIR)) return [];
+  return fs4.readdirSync(PROMPT_DIR).filter((file) => file.endsWith(".md")).map((file) => file.replace(/\.md$/, "")).sort();
+}
+function loadPromptFromMarkdown(name) {
+  const cached = promptCache.get(name);
+  if (cached) return cached;
+  const filePath = path3.join(PROMPT_DIR, `${name}.md`);
+  if (!fs4.existsSync(filePath)) {
+    throw new Error(`Prompt file not found: ${filePath}`);
+  }
+  const fileContent = fs4.readFileSync(filePath, "utf-8");
+  const { data, content } = matter(fileContent);
+  const result = {
+    name: data.name || name,
+    description: data.description || "",
+    arguments: data.arguments || [],
+    agent: data.agent,
+    content: content.trim()
+  };
+  promptCache.set(name, result);
+  return result;
+}
+function findServerInstructionsDir() {
+  const candidates = [
+    // Production if chunked into dist/
+    "./prompts/server",
+    // Production if inlined into dist/mcp/
+    "../prompts/server",
+    // Dev: /src/mcp/prompts/server (next to loader.ts)
+    "./server"
+  ].map((relPath) => path3.resolve(__dirname, relPath));
+  for (const dir of candidates) {
+    if (fs4.existsSync(dir)) {
+      const filePath = path3.join(dir, "instructions.md");
+      if (fs4.existsSync(filePath)) {
+        return dir;
+      }
+    }
+  }
+  return path3.resolve(__dirname, "./server");
+}
+var SERVER_DIR = findServerInstructionsDir();
+var serverInstructionsCache = null;
+function loadServerInstructions() {
+  if (serverInstructionsCache !== null) return serverInstructionsCache;
+  const filePath = path3.join(SERVER_DIR, "instructions.md");
+  if (!fs4.existsSync(filePath)) {
+    throw new Error(`Server instructions file not found: ${filePath}`);
+  }
+  const fileContent = fs4.readFileSync(filePath, "utf-8");
+  const { content } = matter(fileContent);
+  serverInstructionsCache = content.trim();
+  return serverInstructionsCache;
+}
+
+// src/mcp/session.ts
+import fs5 from "fs";
+import path4 from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
 function createSessionContext() {
   return {
     roots: [],
@@ -3483,7 +3567,7 @@ function getFilesystemRoots(session) {
   for (const root of session.roots) {
     if (!root.uri.startsWith("file://")) continue;
     try {
-      resolved.push(path3.resolve(fileURLToPath(root.uri)));
+      resolved.push(path4.resolve(fileURLToPath2(root.uri)));
     } catch {
     }
   }
@@ -3492,19 +3576,19 @@ function getFilesystemRoots(session) {
 function isPathWithinRoots(targetPath, session) {
   const roots = getFilesystemRoots(session);
   if (roots.length === 0) return true;
-  const normalizedTarget = path3.resolve(targetPath);
+  const normalizedTarget = path4.resolve(targetPath);
   return roots.some((rootPath) => {
-    const relative = path3.relative(rootPath, normalizedTarget);
-    return relative === "" || !relative.startsWith("..") && !path3.isAbsolute(relative);
+    const relative = path4.relative(rootPath, normalizedTarget);
+    return relative === "" || !relative.startsWith("..") && !path4.isAbsolute(relative);
   });
 }
 function findContainingRoot(targetPath, session) {
   const roots = getFilesystemRoots(session);
   if (roots.length === 0) return null;
-  const normalizedTarget = path3.resolve(targetPath);
+  const normalizedTarget = path4.resolve(targetPath);
   for (const rootPath of roots) {
-    const relative = path3.relative(rootPath, normalizedTarget);
-    if (relative === "" || !relative.startsWith("..") && !path3.isAbsolute(relative)) {
+    const relative = path4.relative(rootPath, normalizedTarget);
+    if (relative === "" || !relative.startsWith("..") && !path4.isAbsolute(relative)) {
       return rootPath;
     }
   }
@@ -3513,20 +3597,20 @@ function findContainingRoot(targetPath, session) {
 function inferRepoFromSession(session) {
   const roots = getFilesystemRoots(session);
   if (roots.length === 1) {
-    return path3.basename(roots[0]);
+    return path4.basename(roots[0]);
   }
   if (roots.length === 0) {
     if (!session) return void 0;
     const cwd = process.cwd();
-    return path3.basename(cwd);
+    return path4.basename(cwd);
   }
   return void 0;
 }
 function inferOwnerFromGit(cwd) {
   try {
-    const gitConfigPath = path3.join(cwd, ".git", "config");
-    if (!fs4.existsSync(gitConfigPath)) return void 0;
-    const content = fs4.readFileSync(gitConfigPath, "utf-8");
+    const gitConfigPath = path4.join(cwd, ".git", "config");
+    if (!fs5.existsSync(gitConfigPath)) return void 0;
+    const content = fs5.readFileSync(gitConfigPath, "utf-8");
     const match = content.match(
       /url\s*=\s*(?:git@github\.com:|https?:\/\/github\.com\/|git:\/\/github\.com\/)([^\/\s]+)/
     );
@@ -3548,7 +3632,7 @@ function inferOwnerFromSession(session) {
     if (gitOwner) return gitOwner;
   }
   if (roots.length === 1) {
-    const parts = roots[0].split(path3.sep).filter(Boolean);
+    const parts = roots[0].split(path4.sep).filter(Boolean);
     if (parts.length >= 2) {
       return parts[parts.length - 2];
     }
@@ -3556,7 +3640,7 @@ function inferOwnerFromSession(session) {
   if (roots.length === 0) {
     if (!session) return void 0;
     const workdir = process.cwd();
-    const parts = workdir.split(path3.sep).filter(Boolean);
+    const parts = workdir.split(path4.sep).filter(Boolean);
     if (parts.length >= 2) {
       return parts[parts.length - 2];
     }
@@ -3564,90 +3648,6 @@ function inferOwnerFromSession(session) {
   return void 0;
 }
 
-// src/mcp/prompts/loader.ts
-import fs5 from "fs";
-import path4 from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
-import matter from "gray-matter";
-var __filename = fileURLToPath2(import.meta.url);
-var __dirname = path4.dirname(__filename);
-function findPromptDir() {
-  const candidates = [
-    // Production if chunked into dist/
-    "./prompts",
-    // Production if inlined into dist/mcp/
-    "../prompts",
-    // Dev: /src/mcp/prompts/definitions (next to loader.ts)
-    "./definitions"
-  ].map((relPath) => path4.resolve(__dirname, relPath));
-  for (const dir of candidates) {
-    if (fs5.existsSync(dir)) {
-      const files = fs5.readdirSync(dir);
-      if (files.some((f) => f.endsWith(".md"))) {
-        return dir;
-      }
-    }
-  }
-  return path4.resolve(__dirname, "./definitions");
-}
-var PROMPT_DIR = findPromptDir();
-var promptCache = /* @__PURE__ */ new Map();
-function listPromptFiles() {
-  if (!fs5.existsSync(PROMPT_DIR)) return [];
-  return fs5.readdirSync(PROMPT_DIR).filter((file) => file.endsWith(".md")).map((file) => file.replace(/\.md$/, "")).sort();
-}
-function loadPromptFromMarkdown(name) {
-  const cached = promptCache.get(name);
-  if (cached) return cached;
-  const filePath = path4.join(PROMPT_DIR, `${name}.md`);
-  if (!fs5.existsSync(filePath)) {
-    throw new Error(`Prompt file not found: ${filePath}`);
-  }
-  const fileContent = fs5.readFileSync(filePath, "utf-8");
-  const { data, content } = matter(fileContent);
-  const result = {
-    name: data.name || name,
-    description: data.description || "",
-    arguments: data.arguments || [],
-    agent: data.agent,
-    content: content.trim()
-  };
-  promptCache.set(name, result);
-  return result;
-}
-function findServerInstructionsDir() {
-  const candidates = [
-    // Production if chunked into dist/
-    "./prompts/server",
-    // Production if inlined into dist/mcp/
-    "../prompts/server",
-    // Dev: /src/mcp/prompts/server (next to loader.ts)
-    "./server"
-  ].map((relPath) => path4.resolve(__dirname, relPath));
-  for (const dir of candidates) {
-    if (fs5.existsSync(dir)) {
-      const filePath = path4.join(dir, "instructions.md");
-      if (fs5.existsSync(filePath)) {
-        return dir;
-      }
-    }
-  }
-  return path4.resolve(__dirname, "./server");
-}
-var SERVER_DIR = findServerInstructionsDir();
-var serverInstructionsCache = null;
-function loadServerInstructions() {
-  if (serverInstructionsCache !== null) return serverInstructionsCache;
-  const filePath = path4.join(SERVER_DIR, "instructions.md");
-  if (!fs5.existsSync(filePath)) {
-    throw new Error(`Server instructions file not found: ${filePath}`);
-  }
-  const fileContent = fs5.readFileSync(filePath, "utf-8");
-  const { content } = matter(fileContent);
-  serverInstructionsCache = content.trim();
-  return serverInstructionsCache;
-}
-
 // src/mcp/tools/definitions/memory.ts
 var MEMORY_TOOL_DEFINITIONS = [
   {
@@ -4442,7 +4442,10 @@ var TASK_TOOL_DEFINITIONS = [
           type: "string",
           description: "Repository/project name (e.g., 'local-memory-mcp'). Auto-inferred from session when omitted."
         },
-        task_code: { type: "string", description: "Unique task code (e.g. TASK-001) (Required for single task)" },
+        task_code: {
+          type: "string",
+          description: "Unique task code (e.g. TASK-001, REFACTOR-2). Optional \u2014 auto-generated as TASK-xxx if omitted."
+        },
         phase: { type: "string", description: "Project phase (Required for single task)" },
         title: {
           type: "string",
@@ -6333,164 +6336,6 @@ var TOOL_DEFINITIONS = [
   ...KG_TOOL_DEFINITIONS
 ];
 
-// src/mcp/utils/completion.ts
-var MAX_COMPLETION_VALUES = 100;
-function rankCompletionValues(candidates, input) {
-  const unique = [...new Set(candidates.filter(Boolean))];
-  const needle = input.trim().toLowerCase();
-  if (!needle) {
-    return unique.slice(0, MAX_COMPLETION_VALUES);
-  }
-  return unique.map((value) => ({ value, score: scoreCompletionValue(value, needle) })).filter((entry) => entry.score > 0).sort((a, b) => b.score - a.score || a.value.localeCompare(b.value)).map((entry) => entry.value);
-}
-function scoreCompletionValue(value, needle) {
-  const haystack = value.toLowerCase();
-  if (haystack === needle) return 100;
-  if (haystack.startsWith(needle)) return 75;
-  if (haystack.includes(needle)) return 50;
-  const compactNeedle = needle.replace(/[\s_-]+/g, "");
-  const compactHaystack = haystack.replace(/[\s_-]+/g, "");
-  if (compactNeedle && compactHaystack.includes(compactNeedle)) return 25;
-  return 0;
-}
-
-// src/mcp/utils/pagination.ts
-function encodeCursor(offset) {
-  return Buffer.from(String(offset), "utf8").toString("base64");
-}
-function decodeCursor(cursor) {
-  if (cursor === void 0 || cursor === null || cursor === "") {
-    return 0;
-  }
-  if (typeof cursor !== "string" || cursor.trim() === "") {
-    throw invalidPaginationParams("Invalid cursor");
-  }
-  let decoded;
-  try {
-    decoded = Buffer.from(cursor, "base64").toString("utf8");
-  } catch {
-    throw invalidPaginationParams("Invalid cursor");
-  }
-  if (!/^\d+$/.test(decoded)) {
-    throw invalidPaginationParams("Invalid cursor");
-  }
-  const offset = Number.parseInt(decoded, 10);
-  if (!Number.isFinite(offset) || offset < 0) {
-    throw invalidPaginationParams("Invalid cursor");
-  }
-  return offset;
-}
-function invalidPaginationParams(message) {
-  const error = new Error(message);
-  error.code = -32602;
-  return error;
-}
-
-// src/mcp/resources/index.ts
-var DEFAULT_PAGE_SIZE = 25;
-var MAX_PAGE_SIZE = 100;
-function listResources(session, params) {
-  const resources = [
-    {
-      uri: "repository://index",
-      name: "Repository Index",
-      title: "Repository Index",
-      description: "List of all known repositories with memory/task counts and last activity",
-      mimeType: "application/json",
-      annotations: {
-        audience: ["assistant"],
-        priority: 1,
-        lastModified: (/* @__PURE__ */ new Date()).toISOString()
-      }
-    },
-    {
-      uri: "session://roots",
-      name: "Session Roots",
-      title: "Session Roots",
-      description: session?.roots.length ? "Active workspace roots provided by the MCP client" : "No active workspace roots were provided by the MCP client",
-      mimeType: "application/json",
-      size: Buffer.byteLength(JSON.stringify({ roots: session?.roots ?? [] }), "utf8"),
-      annotations: {
-        audience: ["assistant"],
-        priority: 0.95,
-        lastModified: (/* @__PURE__ */ new Date()).toISOString()
-      }
-    }
-  ];
-  return paginateEntries("resources", resources, params);
-}
-function completeResourceArgument(resourceUri, argumentName, argumentValue, _contextArguments, dataSources) {
-  if (resourceUri === "repository://{name}/memories" || resourceUri === "repository://{name}/memories?search={search}&type={type}&tag={tag}" || resourceUri === "repository://{name}/tasks" || resourceUri === "repository://{name}/tasks?status={status}&priority={priority}" || resourceUri === "repository://{name}/summary" || resourceUri === "repository://{name}/actions") {
-    if (argumentName === "name") {
-      return rankCompletionValues(dataSources.repos, argumentValue);
-    }
-  }
-  if (resourceUri === "repository://{name}/memories?search={search}&type={type}&tag={tag}") {
-    if (argumentName === "tag") {
-      return rankCompletionValues(dataSources.tags, argumentValue);
-    }
-  }
-  throw invalidCompletionParams(`Unknown resource template or argument: ${resourceUri} (${argumentName})`);
-}
-function paginateEntries(key, entries, params) {
-  const limit = normalizeLimit(params?.limit);
-  const offset = decodeCursor(params?.cursor);
-  const sliced = entries.slice(offset, offset + limit);
-  const nextOffset = offset + sliced.length;
-  return {
-    [key]: sliced,
-    nextCursor: nextOffset < entries.length ? encodeCursor(nextOffset) : void 0
-  };
-}
-function normalizeLimit(limit) {
-  if (typeof limit !== "number" || !Number.isFinite(limit)) {
-    return DEFAULT_PAGE_SIZE;
-  }
-  return Math.min(MAX_PAGE_SIZE, Math.max(1, Math.trunc(limit)));
-}
-function invalidCompletionParams(message) {
-  const error = new Error(message);
-  error.code = -32602;
-  return error;
-}
-
-// src/mcp/prompts/registry.ts
-function createPromptDefinition(loaded) {
-  return {
-    name: loaded.name,
-    description: loaded.description,
-    arguments: loaded.arguments,
-    agent: loaded.agent,
-    messages: [
-      {
-        role: "user",
-        content: {
-          type: "text",
-          text: loaded.content
-        }
-      }
-    ]
-  };
-}
-var PROMPTS = {};
-var promptFiles = listPromptFiles();
-for (const name of promptFiles) {
-  try {
-    PROMPTS[name] = createPromptDefinition(loadPromptFromMarkdown(name));
-  } catch (e) {
-    logger.warn(`Failed to load prompt ${name}: ${e}`);
-  }
-}
-async function completePromptArgument(name, argName, value, contextArguments, dataSources) {
-  void name;
-  void contextArguments;
-  if (argName === "task_id") {
-    const values = dataSources.tasks.map((t) => t.id);
-    return rankCompletionValues(values, value);
-  }
-  return [];
-}
-
 // src/mcp/tools/handoff.manage.ts
 import { randomUUID as randomUUID2 } from "crypto";
 
@@ -6690,7 +6535,7 @@ var MemoryStoreSchema = z3.object({
   memories: z3.array(SingleMemorySchema).min(1).optional()
 });
 var MemoryUpdateSchema = z3.object({
-  id: z3.string().uuid().optional(),
+  id: z3.string().optional(),
   code: z3.string().max(20).optional(),
   owner: z3.string().min(1),
   repo: z3.string().min(1).transform(normalizeRepo),
@@ -6730,7 +6575,7 @@ var MemorySearchSchema = z3.object({
   structured: z3.boolean().default(false)
 });
 var MemoryAcknowledgeSchema = z3.object({
-  memory_id: z3.string().uuid().optional(),
+  memory_id: z3.string().optional(),
   code: z3.string().max(20).optional(),
   owner: z3.string().min(1),
   repo: z3.string().min(1).transform(normalizeRepo),
@@ -6750,8 +6595,8 @@ var MemoryRecapSchema = z3.object({
 var MemoryDeleteSchema = z3.object({
   owner: z3.string().min(1),
   repo: z3.string().min(1).transform(normalizeRepo),
-  id: z3.string().uuid().optional(),
-  ids: z3.array(z3.string().uuid()).min(1).optional(),
+  id: z3.string().optional(),
+  ids: z3.array(z3.string()).min(1).optional(),
   code: z3.string().max(20).optional(),
   codes: z3.array(z3.string().max(20)).min(1).optional(),
   structured: z3.boolean().default(false)
@@ -6762,7 +6607,7 @@ var MemoryDeleteSchema = z3.object({
   }
 );
 var MemoryDetailSchema = z3.object({
-  id: z3.string().uuid().optional(),
+  id: z3.string().optional(),
   code: z3.string().max(20).optional(),
   owner: z3.string().min(1),
   repo: z3.string().min(1).transform(normalizeRepo),
@@ -6899,8 +6744,8 @@ var TaskCreateInteractiveSchema = SingleTaskCreateSchema.partial().extend({
 var TaskUpdateSchema = z4.object({
   owner: z4.string().min(1),
   repo: z4.string().min(1).transform(normalizeRepo),
-  id: z4.string().uuid().optional(),
-  ids: z4.array(z4.string().uuid()).min(1).optional(),
+  id: z4.string().optional(),
+  ids: z4.array(z4.string()).min(1).optional(),
   task_code: z4.string().optional(),
   task_codes: z4.array(z4.string().min(1)).min(1).optional(),
   phase: z4.string().optional(),
@@ -6926,7 +6771,7 @@ var TaskUpdateSchema = z4.object({
 }).refine(
   (data) => data.id !== void 0 || data.ids !== void 0 || data.task_code !== void 0 || data.task_codes !== void 0,
   {
-    message: "Either 'id' (UUID), 'ids' (array of UUIDs), 'task_code' (string code like PERF-1), or 'task_codes' (array of string codes) must be provided. Note: 'ids' expects UUID format, not task codes \u2014 use 'task_code'/'task_codes' for string identifiers."
+    message: "Either 'id' (UUID), 'ids' (array of UUIDs or codes), 'task_code' (string code like PERF-1), or 'task_codes' (array of string codes) must be provided."
   }
 ).refine((data) => Object.keys(data).length > 2, {
   message: "At least one field besides repo and id/ids must be provided for update"
@@ -6955,21 +6800,21 @@ var TaskSearchSchema = z4.object({
 var TaskDeleteSchema = z4.object({
   owner: z4.string().min(1),
   repo: z4.string().min(1).transform(normalizeRepo),
-  id: z4.string().uuid().optional(),
-  ids: z4.array(z4.string().uuid()).min(1).optional(),
+  id: z4.string().optional(),
+  ids: z4.array(z4.string()).min(1).optional(),
   task_code: z4.string().optional(),
   task_codes: z4.array(z4.string().min(1)).min(1).optional(),
   structured: z4.boolean().default(false)
 }).refine(
   (data) => data.id !== void 0 || data.ids !== void 0 || data.task_code !== void 0 || data.task_codes !== void 0,
   {
-    message: "Either 'id' (UUID), 'ids' (array of UUIDs), 'task_code' (string code like PERF-1), or 'task_codes' (array of string codes) must be provided. Note: 'ids' expects UUID format, not task codes \u2014 use 'task_code'/'task_codes' for string identifiers."
+    message: "Either 'id' (UUID), 'ids' (array of UUIDs or codes), 'task_code' (string code like PERF-1), or 'task_codes' (array of string codes) must be provided."
   }
 );
 var TaskGetSchema = z4.object({
   owner: z4.string().min(1),
   repo: z4.string().min(1).transform(normalizeRepo),
-  id: z4.string().uuid().optional(),
+  id: z4.string().optional(),
   task_code: z4.string().optional(),
   task_codes: z4.array(z4.string().min(1)).min(1).optional(),
   structured: z4.boolean().default(false)
@@ -6984,7 +6829,7 @@ var HandoffCreateSchema = z5.object({
   repo: z5.string().min(1, "repo is required \u2014 provide it explicitly or configure MCP workspace roots").transform(normalizeRepo),
   from_agent: z5.string().min(1),
   to_agent: z5.string().min(1).optional(),
-  task_id: z5.string().uuid().optional(),
+  task_id: z5.string().optional(),
   task_code: z5.string().optional(),
   summary: z5.string().min(1),
   context: z5.record(z5.string(), z5.unknown()).optional(),
@@ -7016,7 +6861,7 @@ var HandoffListSchema = z5.object({
 var TaskClaimSchema = z5.object({
   owner: z5.string().min(1, "owner is required \u2014 provide it explicitly or configure MCP workspace roots"),
   repo: z5.string().min(1, "repo is required \u2014 provide it explicitly or configure MCP workspace roots").transform(normalizeRepo),
-  task_id: z5.string().uuid().optional(),
+  task_id: z5.string().optional(),
   task_code: z5.string().optional(),
   agent: z5.string().min(1),
   role: z5.string().optional(),
@@ -7039,7 +6884,7 @@ var ClaimListSchema = z5.object({
 var ClaimReleaseSchema = z5.object({
   owner: z5.string().min(1, "owner is required \u2014 provide it explicitly or configure MCP workspace roots"),
   repo: z5.string().min(1, "repo is required \u2014 provide it explicitly or configure MCP workspace roots").transform(normalizeRepo),
-  task_id: z5.string().uuid().optional(),
+  task_id: z5.string().optional(),
   task_code: z5.string().optional(),
   agent: z5.string().min(1).optional(),
   structured: z5.boolean().default(false)
@@ -7078,7 +6923,7 @@ var StandardStoreSchema = z6.object({
   message: "repo is required for repo-specific standards"
 });
 var StandardUpdateSchema = z6.object({
-  id: z6.string().uuid().optional(),
+  id: z6.string().optional(),
   code: z6.string().max(20).optional(),
   name: z6.string().min(3).max(255).optional(),
   content: z6.string().min(10).optional(),
@@ -7120,8 +6965,8 @@ var StandardSearchSchema = z6.object({
 var StandardDeleteSchema = z6.object({
   owner: z6.string().min(1),
   repo: z6.string().min(1).transform(normalizeRepo),
-  id: z6.string().uuid().optional(),
-  ids: z6.array(z6.string().uuid()).min(1).optional(),
+  id: z6.string().optional(),
+  ids: z6.array(z6.string()).min(1).optional(),
   code: z6.string().max(20).optional(),
   codes: z6.array(z6.string().max(20)).min(1).optional(),
   structured: z6.boolean().default(false)
@@ -7132,7 +6977,7 @@ var StandardDeleteSchema = z6.object({
   }
 );
 var StandardDetailSchema = z6.object({
-  id: z6.string().uuid().optional(),
+  id: z6.string().optional(),
   code: z6.string().max(20).optional(),
   owner: z6.string().min(1),
   repo: z6.string().min(1).transform(normalizeRepo),
@@ -7215,6 +7060,9 @@ var KGBackfillSchema = z8.object({
   source: z8.enum(["memories", "standards", "both"]).optional().default("both")
 });
 
+// src/mcp/utils/uuid.ts
+var UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+
 // src/mcp/tools/handoff.manage.ts
 function buildHandoffListSummary(repo, count, status, fromAgent, toAgent) {
   const parts = [`Found ${count} handoff${count === 1 ? "" : "s"} in repo "${repo}".`];
@@ -7243,6 +7091,13 @@ async function handleHandoffCreate(args, storage) {
   const validated = HandoffCreateSchema.parse(args);
   const { owner, repo, from_agent, to_agent, task_id, task_code, summary, context, expires_at, structured } = validated;
   let resolvedTaskId = task_id ?? null;
+  if (resolvedTaskId && !UUID_REGEX.test(resolvedTaskId)) {
+    const task = storage.tasks.getTaskByCode(owner, repo, resolvedTaskId);
+    if (!task) {
+      throw new Error(`Task not found: ${resolvedTaskId} in repo ${repo}`);
+    }
+    resolvedTaskId = task.id;
+  }
   if (!resolvedTaskId && task_code) {
     const task = storage.tasks.getTaskByCode(owner, repo, task_code);
     if (!task) {
@@ -7361,6 +7216,13 @@ async function handleTaskClaim(args, storage) {
   const validated = TaskClaimSchema.parse(args);
   const { owner, repo, task_id, task_code, agent, role, metadata, structured } = validated;
   let taskId = task_id;
+  if (taskId && !UUID_REGEX.test(taskId)) {
+    const task2 = storage.tasks.getTaskByCode(owner, repo, taskId);
+    if (!task2) {
+      throw new Error(`Task not found: ${taskId} in repo ${repo}`);
+    }
+    taskId = task2.id;
+  }
   let resolvedTaskCode;
   let task;
   if (taskId) {
@@ -7466,6 +7328,13 @@ async function handleClaimRelease(args, storage) {
   const validated = ClaimReleaseSchema.parse(args);
   const { owner, repo, task_id, task_code, agent, structured } = validated;
   let resolvedTaskId = task_id;
+  if (resolvedTaskId && !UUID_REGEX.test(resolvedTaskId)) {
+    const task = storage.tasks.getTaskByCode(owner, repo, resolvedTaskId);
+    if (!task) {
+      throw new Error(`Task not found: ${resolvedTaskId} in repo ${repo}`);
+    }
+    resolvedTaskId = task.id;
+  }
   let resolvedTaskCode = task_code ?? null;
   if (resolvedTaskId) {
     const task = storage.tasks.getTaskById(resolvedTaskId);
@@ -7503,6 +7372,164 @@ async function handleClaimRelease(args, storage) {
   });
 }
 
+// src/mcp/utils/completion.ts
+var MAX_COMPLETION_VALUES = 100;
+function rankCompletionValues(candidates, input) {
+  const unique = [...new Set(candidates.filter(Boolean))];
+  const needle = input.trim().toLowerCase();
+  if (!needle) {
+    return unique.slice(0, MAX_COMPLETION_VALUES);
+  }
+  return unique.map((value) => ({ value, score: scoreCompletionValue(value, needle) })).filter((entry) => entry.score > 0).sort((a, b) => b.score - a.score || a.value.localeCompare(b.value)).map((entry) => entry.value);
+}
+function scoreCompletionValue(value, needle) {
+  const haystack = value.toLowerCase();
+  if (haystack === needle) return 100;
+  if (haystack.startsWith(needle)) return 75;
+  if (haystack.includes(needle)) return 50;
+  const compactNeedle = needle.replace(/[\s_-]+/g, "");
+  const compactHaystack = haystack.replace(/[\s_-]+/g, "");
+  if (compactNeedle && compactHaystack.includes(compactNeedle)) return 25;
+  return 0;
+}
+
+// src/mcp/utils/pagination.ts
+function encodeCursor(offset) {
+  return Buffer.from(String(offset), "utf8").toString("base64");
+}
+function decodeCursor(cursor) {
+  if (cursor === void 0 || cursor === null || cursor === "") {
+    return 0;
+  }
+  if (typeof cursor !== "string" || cursor.trim() === "") {
+    throw invalidPaginationParams("Invalid cursor");
+  }
+  let decoded;
+  try {
+    decoded = Buffer.from(cursor, "base64").toString("utf8");
+  } catch {
+    throw invalidPaginationParams("Invalid cursor");
+  }
+  if (!/^\d+$/.test(decoded)) {
+    throw invalidPaginationParams("Invalid cursor");
+  }
+  const offset = Number.parseInt(decoded, 10);
+  if (!Number.isFinite(offset) || offset < 0) {
+    throw invalidPaginationParams("Invalid cursor");
+  }
+  return offset;
+}
+function invalidPaginationParams(message) {
+  const error = new Error(message);
+  error.code = -32602;
+  return error;
+}
+
+// src/mcp/prompts/registry.ts
+function createPromptDefinition(loaded) {
+  return {
+    name: loaded.name,
+    description: loaded.description,
+    arguments: loaded.arguments,
+    agent: loaded.agent,
+    messages: [
+      {
+        role: "user",
+        content: {
+          type: "text",
+          text: loaded.content
+        }
+      }
+    ]
+  };
+}
+var PROMPTS = {};
+var promptFiles = listPromptFiles();
+for (const name of promptFiles) {
+  try {
+    PROMPTS[name] = createPromptDefinition(loadPromptFromMarkdown(name));
+  } catch (e) {
+    logger.warn(`Failed to load prompt ${name}: ${e}`);
+  }
+}
+async function completePromptArgument(name, argName, value, contextArguments, dataSources) {
+  void name;
+  void contextArguments;
+  if (argName === "task_id") {
+    const values = dataSources.tasks.map((t) => t.id);
+    return rankCompletionValues(values, value);
+  }
+  return [];
+}
+
+// src/mcp/resources/index.ts
+var DEFAULT_PAGE_SIZE = 25;
+var MAX_PAGE_SIZE = 100;
+function listResources(session, params) {
+  const resources = [
+    {
+      uri: "repository://index",
+      name: "Repository Index",
+      title: "Repository Index",
+      description: "List of all known repositories with memory/task counts and last activity",
+      mimeType: "application/json",
+      annotations: {
+        audience: ["assistant"],
+        priority: 1,
+        lastModified: (/* @__PURE__ */ new Date()).toISOString()
+      }
+    },
+    {
+      uri: "session://roots",
+      name: "Session Roots",
+      title: "Session Roots",
+      description: session?.roots.length ? "Active workspace roots provided by the MCP client" : "No active workspace roots were provided by the MCP client",
+      mimeType: "application/json",
+      size: Buffer.byteLength(JSON.stringify({ roots: session?.roots ?? [] }), "utf8"),
+      annotations: {
+        audience: ["assistant"],
+        priority: 0.95,
+        lastModified: (/* @__PURE__ */ new Date()).toISOString()
+      }
+    }
+  ];
+  return paginateEntries("resources", resources, params);
+}
+function completeResourceArgument(resourceUri, argumentName, argumentValue, _contextArguments, dataSources) {
+  if (resourceUri === "repository://{name}/memories" || resourceUri === "repository://{name}/memories?search={search}&type={type}&tag={tag}" || resourceUri === "repository://{name}/tasks" || resourceUri === "repository://{name}/tasks?status={status}&priority={priority}" || resourceUri === "repository://{name}/summary" || resourceUri === "repository://{name}/actions") {
+    if (argumentName === "name") {
+      return rankCompletionValues(dataSources.repos, argumentValue);
+    }
+  }
+  if (resourceUri === "repository://{name}/memories?search={search}&type={type}&tag={tag}") {
+    if (argumentName === "tag") {
+      return rankCompletionValues(dataSources.tags, argumentValue);
+    }
+  }
+  throw invalidCompletionParams(`Unknown resource template or argument: ${resourceUri} (${argumentName})`);
+}
+function paginateEntries(key, entries, params) {
+  const limit = normalizeLimit(params?.limit);
+  const offset = decodeCursor(params?.cursor);
+  const sliced = entries.slice(offset, offset + limit);
+  const nextOffset = offset + sliced.length;
+  return {
+    [key]: sliced,
+    nextCursor: nextOffset < entries.length ? encodeCursor(nextOffset) : void 0
+  };
+}
+function normalizeLimit(limit) {
+  if (typeof limit !== "number" || !Number.isFinite(limit)) {
+    return DEFAULT_PAGE_SIZE;
+  }
+  return Math.min(MAX_PAGE_SIZE, Math.max(1, Math.trunc(limit)));
+}
+function invalidCompletionParams(message) {
+  const error = new Error(message);
+  error.code = -32602;
+  return error;
+}
+
 // src/mcp/tools/standard.shared.ts
 function toContextSlug(value) {
   return value.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
@@ -7521,30 +7548,20 @@ function buildStandardVectorText(standard) {
 }
 
 export {
-  logger,
-  addLogSink,
-  createFileSink,
-  parseRepoInput,
-  normalizeRepo,
-  SQLiteStore,
-  RealVectorStore,
-  TOOL_DEFINITIONS,
-  rankCompletionValues,
-  listResources,
-  completeResourceArgument,
+  listPromptFiles,
+  loadPromptFromMarkdown,
+  loadServerInstructions,
   createSessionContext,
   getFilesystemRoots,
   isPathWithinRoots,
   findContainingRoot,
   inferRepoFromSession,
   inferOwnerFromSession,
-  listPromptFiles,
-  loadPromptFromMarkdown,
-  loadServerInstructions,
-  PROMPTS,
-  completePromptArgument,
-  createMcpResponse,
-  getPrimaryTextContent,
+  logger,
+  addLogSink,
+  createFileSink,
+  parseRepoInput,
+  normalizeRepo,
   TaskStatusSchema,
   MemoryStoreSchema,
   MemoryUpdateSchema,
@@ -7576,6 +7593,10 @@ export {
   DeleteRelationSchema,
   DeleteObservationSchema,
   KGBackfillSchema,
+  TOOL_DEFINITIONS,
+  createMcpResponse,
+  getPrimaryTextContent,
+  UUID_REGEX,
   handleHandoffCreate,
   handleHandoffList,
   handleHandoffUpdate,
@@ -7583,5 +7604,12 @@ export {
   handleClaimList,
   handleClaimRelease,
   toContextSlug,
-  buildStandardVectorText
+  buildStandardVectorText,
+  rankCompletionValues,
+  PROMPTS,
+  completePromptArgument,
+  listResources,
+  completeResourceArgument,
+  SQLiteStore,
+  RealVectorStore
 };

package/dist/dashboard/server.js

@@ -15,7 +15,7 @@ import {
   handleTaskClaim,
   listResources,
   logger
-} from "../chunk-H7BLOZB6.js";
+} from "../chunk-BPQ42JEQ.js";
 
 // src/dashboard/server.ts
 import express from "express";

package/dist/mcp/server.js

@@ -34,6 +34,7 @@ import {
   TaskSearchSchema,
   TaskStatusSchema,
   TaskUpdateSchema,
+  UUID_REGEX,
   addLogSink,
   buildStandardVectorText,
   completePromptArgument,
@@ -61,7 +62,7 @@ import {
   parseRepoInput,
   rankCompletionValues,
   toContextSlug
-} from "../chunk-H7BLOZB6.js";
+} from "../chunk-BPQ42JEQ.js";
 
 // src/mcp/server.ts
 import { serveStdio } from "@modelcontextprotocol/server/stdio";
@@ -74,8 +75,8 @@ import path from "path";
 import { fileURLToPath } from "url";
 var __dirname = path.dirname(fileURLToPath(import.meta.url));
 var pkgVersion = "0.1.0";
-if ("0.19.13") {
-  pkgVersion = "0.19.13";
+if ("0.19.15") {
+  pkgVersion = "0.19.15";
 } else {
   let searchDir = __dirname;
   for (let i = 0; i < 5; i++) {
@@ -422,7 +423,6 @@ async function saveExtractions(content, title, owner, repo, db2) {
 }
 
 // src/mcp/tools/memory.store.ts
-var UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 function hasMetadataLikeTitle(title) {
   const normalized = title.trim();
   return /^\[[^\]]{0,200}(agent:|role:|model:|\d{4}-\d{2}-\d{2}|source_)[^\]]*\]/i.test(normalized);
@@ -657,14 +657,13 @@ async function handleMemoryStore(params, db2, vectors2) {
 }
 
 // src/mcp/tools/memory.update.ts
-var UUID_REGEX2 = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 function hasMetadataLikeTitle2(title) {
   const normalized = title.trim();
   return /^\[[^\]]{0,200}(agent:|role:|model:|\d{4}-\d{2}-\d{2}|source_)[^\]]*\]/i.test(normalized);
 }
 function resolveMemorySupersedes2(value, db2, owner, repo) {
   if (!value) return null;
-  if (UUID_REGEX2.test(value)) return value;
+  if (UUID_REGEX.test(value)) return value;
   const memory = db2.memories.getByCode(value, owner, repo);
   if (!memory) throw new Error(`supersedes: memory with code '${value}' not found`);
   return memory.id;
@@ -672,6 +671,11 @@ function resolveMemorySupersedes2(value, db2, owner, repo) {
 async function handleMemoryUpdate(params, db2, vectors2) {
   const validated = MemoryUpdateSchema.parse(params);
   let resolvedId = validated.id;
+  if (resolvedId && !UUID_REGEX.test(resolvedId)) {
+    const byCode = db2.memories.getByCode(resolvedId, validated.owner, validated.repo);
+    if (!byCode) throw new Error(`Memory not found: ${resolvedId}`);
+    resolvedId = byCode.id;
+  }
   if (!resolvedId && validated.code) {
     const byCode = db2.memories.getByCode(validated.code, validated.owner, validated.repo);
     if (!byCode) throw new Error(`Memory not found: ${validated.code}`);
@@ -1037,6 +1041,11 @@ function applyTimeFilter(memories, tunnel) {
 async function handleMemoryAcknowledge(params, db2) {
   const validated = MemoryAcknowledgeSchema.parse(params);
   let memoryId = validated.memory_id;
+  if (memoryId && !UUID_REGEX.test(memoryId)) {
+    const byCode = db2.memories.getByCode(memoryId, validated.owner, validated.repo);
+    if (!byCode) throw new Error(`Memory not found: ${memoryId}`);
+    memoryId = byCode.id;
+  }
   if (!memoryId && validated.code) {
     const byCode = db2.memories.getByCode(validated.code, validated.owner, validated.repo);
     if (!byCode) throw new Error(`Memory not found: ${validated.code}`);
@@ -1541,8 +1550,26 @@ async function handleMemoryDelete(params, db2, vectors2, onProgress) {
   const validated = MemoryDeleteSchema.parse(params);
   const { id, ids, code, codes, owner, repo, structured } = validated;
   const resolvedIds = [];
-  if (ids) resolvedIds.push(...ids);
-  if (id) resolvedIds.push(id);
+  if (ids) {
+    for (const item of ids) {
+      if (UUID_REGEX.test(item)) {
+        resolvedIds.push(item);
+      } else {
+        const entry = db2.memories.getByCode(item, owner, repo);
+        if (!entry) throw new Error(`Memory not found: ${item}`);
+        resolvedIds.push(entry.id);
+      }
+    }
+  }
+  if (id) {
+    if (!UUID_REGEX.test(id)) {
+      const entry = db2.memories.getByCode(id, owner, repo);
+      if (!entry) throw new Error(`Memory not found: ${id}`);
+      resolvedIds.push(entry.id);
+    } else {
+      resolvedIds.push(id);
+    }
+  }
   if (code) {
     const entry = db2.memories.getByCode(code, owner, repo);
     if (!entry) throw new Error(`Memory not found: ${code}`);
@@ -1573,7 +1600,7 @@ async function handleMemoryDelete(params, db2, vectors2, onProgress) {
       lastRepo = existing.scope.repo;
       deletedCodes.push(existing.code || existing.id);
       validIdsToDelete.push(targetId);
-    } else if (id) {
+    } else {
       throw new Error(`Memory not found: ${targetId}`);
     }
   }
@@ -1615,7 +1642,7 @@ async function handleMemoryDetail(args, storage) {
   const { id, code, owner, repo } = validated;
   let memory;
   if (id) {
-    memory = storage.memories.getById(id);
+    memory = UUID_REGEX.test(id) ? storage.memories.getById(id) : storage.memories.getByCode(id, owner, repo);
   } else if (code) {
     memory = storage.memories.getByCode(code, owner, repo);
   }
@@ -1645,10 +1672,9 @@ async function handleMemoryDetail(args, storage) {
 
 // src/mcp/tools/standard.store.ts
 import { randomUUID as randomUUID3 } from "crypto";
-var UUID_REGEX3 = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 function resolveStandardParentId(value, db2, owner, repo) {
   if (!value) return null;
-  if (UUID_REGEX3.test(value)) return value;
+  if (UUID_REGEX.test(value)) return value;
   const standard = db2.standards.getByCode(value, owner, repo);
   if (!standard) throw new Error(`parent_id: standard with code '${value}' not found`);
   return standard.id;
@@ -2055,10 +2081,9 @@ async function handleStandardSearch(params, db2, vectors2) {
 }
 
 // src/mcp/tools/standard.update.ts
-var UUID_REGEX4 = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 function resolveStandardParentId2(value, db2, owner, repo) {
   if (!value) return null;
-  if (UUID_REGEX4.test(value)) return value;
+  if (UUID_REGEX.test(value)) return value;
   const standard = db2.standards.getByCode(value, owner, repo);
   if (!standard) throw new Error(`parent_id: standard with code '${value}' not found`);
   return standard.id;
@@ -2066,6 +2091,11 @@ function resolveStandardParentId2(value, db2, owner, repo) {
 async function handleStandardUpdate(params, db2, vectors2) {
   const validated = StandardUpdateSchema.parse(params);
   let resolvedId = validated.id;
+  if (resolvedId && !UUID_REGEX.test(resolvedId)) {
+    const byCode = db2.standards.getByCode(resolvedId, validated.owner, validated.repo);
+    if (!byCode) throw new Error(`Coding standard not found: ${resolvedId}`);
+    resolvedId = byCode.id;
+  }
   if (!resolvedId && validated.code) {
     const byCode = db2.standards.getByCode(validated.code, validated.owner, validated.repo);
     if (!byCode) throw new Error(`Coding standard not found: ${validated.code}`);
@@ -2123,9 +2153,15 @@ async function handleStandardUpdate(params, db2, vectors2) {
 // src/mcp/tools/standard.detail.ts
 async function handleStandardDetail(args, storage) {
   const validated = StandardDetailSchema.parse(args);
-  const standard = validated.id ? storage.standards.getById(validated.id) : storage.standards.getByCode(validated.code, validated.owner, validated.repo);
+  const { id, code, owner, repo } = validated;
+  let standard;
+  if (id) {
+    standard = UUID_REGEX.test(id) ? storage.standards.getById(id) : storage.standards.getByCode(id, owner, repo);
+  } else if (code) {
+    standard = storage.standards.getByCode(code, owner, repo);
+  }
   if (!standard) {
-    const identifier = validated.id ?? validated.code;
+    const identifier = id ?? code;
     throw new Error(`Coding standard not found: ${identifier}`);
   }
   storage.standards.incrementHitCounts([standard.id]);
@@ -2159,8 +2195,26 @@ async function handleStandardDelete(params, db2, vectors2) {
   const validated = StandardDeleteSchema.parse(params);
   const { id, ids, code, codes, owner, repo, structured } = validated;
   const resolvedIds = [];
-  if (ids) resolvedIds.push(...ids);
-  if (id) resolvedIds.push(id);
+  if (ids) {
+    for (const item of ids) {
+      if (UUID_REGEX.test(item)) {
+        resolvedIds.push(item);
+      } else {
+        const entry = db2.standards.getByCode(item, owner, repo);
+        if (!entry) throw new Error(`Coding standard not found: ${item}`);
+        resolvedIds.push(entry.id);
+      }
+    }
+  }
+  if (id) {
+    if (!UUID_REGEX.test(id)) {
+      const entry = db2.standards.getByCode(id, owner, repo);
+      if (!entry) throw new Error(`Coding standard not found: ${id}`);
+      resolvedIds.push(entry.id);
+    } else {
+      resolvedIds.push(id);
+    }
+  }
   if (code) {
     const entry = db2.standards.getByCode(code, owner, repo);
     if (!entry) throw new Error(`Coding standard not found: ${code}`);
@@ -2188,7 +2242,7 @@ async function handleStandardDelete(params, db2, vectors2) {
       db2.standards.delete(targetId);
       await vectors2.remove(targetId, "standard");
       deletedCount++;
-    } else if (id) {
+    } else {
       throw new Error(`Coding standard not found: ${targetId}`);
     }
   }
@@ -2214,10 +2268,9 @@ async function handleStandardDelete(params, db2, vectors2) {
 import { randomUUID as randomUUID4 } from "crypto";
 
 // src/mcp/tools/task.helpers.ts
-var UUID_REGEX5 = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 function resolveParentId(value, owner, repo, storage, localCodeMap) {
   if (!value) return null;
-  if (UUID_REGEX5.test(value)) return value;
+  if (UUID_REGEX.test(value)) return value;
   if (localCodeMap?.has(value)) return localCodeMap.get(value);
   const parent = storage.tasks.getTaskByCode(owner, repo, value);
   if (!parent) throw new Error(`parent_id: task with code '${value}' not found in repo '${repo}'`);
@@ -2225,7 +2278,7 @@ function resolveParentId(value, owner, repo, storage, localCodeMap) {
 }
 function resolveDependsOn(value, owner, repo, storage, localCodeMap) {
   if (!value) return null;
-  if (UUID_REGEX5.test(value)) return value;
+  if (UUID_REGEX.test(value)) return value;
   if (localCodeMap?.has(value)) return localCodeMap.get(value);
   const task = storage.tasks.getTaskByCode(owner, repo, value);
   if (!task) throw new Error(`depends_on: task with code '${value}' not found in repo '${repo}'`);
@@ -2338,7 +2391,9 @@ async function handleTaskCreate(args, storage) {
         throw new Error(`Duplicate task_code in request: '${code}'`);
       }
       if (existingCodes.has(code)) {
-        throw new Error(`Duplicate task_code: '${code}' already exists in repository '${repo}'`);
+        throw new Error(
+          `Duplicate task_code: '${code}' already exists in repository '${repo}'. Omit task_code to auto-generate, or use task-list/task-search to find available codes.`
+        );
       }
       codesInRequest.add(code);
       let normalizedStatus = taskData.status || "backlog";
@@ -2419,7 +2474,9 @@ async function handleTaskCreate(args, storage) {
   let effectiveStatus = requestedStatus || "backlog";
   const resolvedCode = task_code || generateNextCode(owner ?? "", repo, "task", storage);
   if (storage.tasks.isTaskCodeDuplicate(owner, repo, resolvedCode)) {
-    throw new Error(`Duplicate task_code: '${resolvedCode}' already exists in repository '${repo}'`);
+    throw new Error(
+      `Duplicate task_code: '${resolvedCode}' already exists in repository '${repo}'. Omit task_code to auto-generate, or use task-list/task-search to find available codes.`
+    );
   }
   if (requestedStatus !== "backlog" && requestedStatus !== "pending" && requestedStatus !== void 0) {
     throw new Error("New tasks must be created with status 'backlog' or 'pending'.");
@@ -2583,12 +2640,29 @@ async function handleTaskUpdate(args, storage, vectors2) {
   const updateData = TaskUpdateSchema.parse(args);
   const { owner, repo, id, ids, comment, force, ...updates } = updateData;
   let resolvedId = id;
+  if (resolvedId && !UUID_REGEX.test(resolvedId)) {
+    const found = storage.tasks.getTaskByCode(owner, repo, resolvedId);
+    if (!found) throw new Error(`Task not found: ${resolvedId}`);
+    resolvedId = found.id;
+  }
   if (!resolvedId && !ids && updates.task_code) {
     const found = storage.tasks.getTaskByCode(owner, repo, updates.task_code);
     if (!found) throw new Error(`Task not found: ${updates.task_code}`);
     resolvedId = found.id;
   }
-  const targetIds = ids || (resolvedId ? [resolvedId] : []);
+  const resolvedIdsArray = [];
+  if (ids) {
+    for (const item of ids) {
+      if (UUID_REGEX.test(item)) {
+        resolvedIdsArray.push(item);
+      } else {
+        const task = storage.tasks.getTaskByCode(owner, repo, item);
+        if (!task) throw new Error(`Task not found: ${item}`);
+        resolvedIdsArray.push(task.id);
+      }
+    }
+  }
+  const targetIds = resolvedIdsArray.length > 0 ? resolvedIdsArray : resolvedId ? [resolvedId] : [];
   if (targetIds.length === 0) {
     throw new Error("Either 'id' or 'ids' must be provided for update");
   }
@@ -2731,8 +2805,26 @@ async function handleTaskDelete(args, storage) {
   const validated = TaskDeleteSchema.parse(args);
   const { owner, repo, id, ids, task_code } = validated;
   const resolvedIds = [];
-  if (ids) resolvedIds.push(...ids);
-  if (id) resolvedIds.push(id);
+  if (ids) {
+    for (const item of ids) {
+      if (UUID_REGEX.test(item)) {
+        resolvedIds.push(item);
+      } else {
+        const task = storage.tasks.getTaskByCode(owner, repo, item);
+        if (!task) throw new Error(`Task not found: ${item}`);
+        resolvedIds.push(task.id);
+      }
+    }
+  }
+  if (id) {
+    if (!UUID_REGEX.test(id)) {
+      const task = storage.tasks.getTaskByCode(owner, repo, id);
+      if (!task) throw new Error(`Task not found: ${id}`);
+      resolvedIds.push(task.id);
+    } else {
+      resolvedIds.push(id);
+    }
+  }
   if (task_code) {
     const task = storage.tasks.getTaskByCode(owner, repo, task_code);
     if (!task) throw new Error(`Task not found: ${task_code}`);
@@ -2768,7 +2860,7 @@ async function handleTaskGet(args, storage) {
   const { owner, repo, id, task_code, structured: isStructuredRequest } = validated;
   let task;
   if (id) {
-    task = storage.tasks.getTaskById(id);
+    task = UUID_REGEX.test(id) ? storage.tasks.getTaskById(id) : storage.tasks.getTaskByCode(owner, repo, id);
   } else if (task_code) {
     task = storage.tasks.getTaskByCode(owner, repo, task_code);
   } else {
@@ -3063,6 +3155,10 @@ async function handleDecisionLog(args, db2, vectors2) {
     tags,
     structured: validated.structured
   };
+  const conflict = await db2.memoryVectors.checkConflicts(formattedContent, owner, repo, "decision", vectors2, 0.55);
+  if (conflict) {
+    memoryStoreParams.supersedes = conflict.id;
+  }
   return handleMemoryStore(memoryStoreParams, db2, vectors2);
 }
 

package/package.json

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