@vheins/local-memory-mcp 0.10.1 → 0.10.3

package/dist/{chunk-Z6FENX4V.js → chunk-HXADESDJ.js}

@@ -1,14 +1,92 @@
 // src/mcp/capabilities.ts
-import { fileURLToPath } from "url";
+import { fileURLToPath as fileURLToPath2 } from "url";
+import path2 from "path";
+
+// src/mcp/prompts/loader.ts
+import fs from "fs";
 import path from "path";
-var __dirname = path.dirname(fileURLToPath(import.meta.url));
+import { fileURLToPath } from "url";
+import matter from "gray-matter";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = path.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) => path.resolve(__dirname, relPath));
+  for (const dir of candidates) {
+    if (fs.existsSync(dir)) {
+      const files = fs.readdirSync(dir);
+      if (files.some((f) => f.endsWith(".md"))) {
+        return dir;
+      }
+    }
+  }
+  return path.resolve(__dirname, "./definitions");
+}
+var PROMPT_DIR = findPromptDir();
+function listPromptFiles() {
+  if (!fs.existsSync(PROMPT_DIR)) return [];
+  return fs.readdirSync(PROMPT_DIR).filter((file) => file.endsWith(".md")).map((file) => file.replace(/\.md$/, "")).sort();
+}
+function loadPromptFromMarkdown(name) {
+  const filePath = path.join(PROMPT_DIR, `${name}.md`);
+  if (!fs.existsSync(filePath)) {
+    throw new Error(`Prompt file not found: ${filePath}`);
+  }
+  const fileContent = fs.readFileSync(filePath, "utf-8");
+  const { data, content } = matter(fileContent);
+  return {
+    name: data.name || name,
+    description: data.description || "",
+    arguments: data.arguments || [],
+    agent: data.agent,
+    content: content.trim()
+  };
+}
+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) => path.resolve(__dirname, relPath));
+  for (const dir of candidates) {
+    if (fs.existsSync(dir)) {
+      const filePath = path.join(dir, "instructions.md");
+      if (fs.existsSync(filePath)) {
+        return dir;
+      }
+    }
+  }
+  return path.resolve(__dirname, "./server");
+}
+var SERVER_DIR = findServerInstructionsDir();
+function loadServerInstructions() {
+  const filePath = path.join(SERVER_DIR, "instructions.md");
+  if (!fs.existsSync(filePath)) {
+    throw new Error(`Server instructions file not found: ${filePath}`);
+  }
+  const fileContent = fs.readFileSync(filePath, "utf-8");
+  const { content } = matter(fileContent);
+  return content.trim();
+}
+
+// src/mcp/capabilities.ts
+var __dirname2 = path2.dirname(fileURLToPath2(import.meta.url));
 var pkgVersion = "0.1.0";
-if ("0.10.1") {
-  pkgVersion = "0.10.1";
+if ("0.10.3") {
+  pkgVersion = "0.10.3";
 } else {
-  let searchDir = __dirname;
+  let searchDir = __dirname2;
   for (let i = 0; i < 5; i++) {
-    const candidate = path.join(searchDir, "package.json");
+    const candidate = path2.join(searchDir, "package.json");
     try {
       if (fs.existsSync(candidate)) {
         const pkg = JSON.parse(fs.readFileSync(candidate, "utf8"));
@@ -19,57 +97,14 @@ if ("0.10.1") {
       }
     } catch {
     }
-    searchDir = path.dirname(searchDir);
+    searchDir = path2.dirname(searchDir);
   }
 }
 var MCP_PROTOCOL_VERSION = "2025-03-26";
-var SERVER_INSTRUCTIONS = `
-Local Memory MCP \u2014 persistent memory, task coordination, and coding standards for AI agents.
-
-## When to use this server
-Use at the START of every session and before any implementation work:
-1. Call \`task-list\` to sync active/pending tasks for the current repository.
-2. Call \`handoff-list\` to check pending context transfers. Close stale handoffs with \`handoff-update\`.
-3. Call \`memory-search\` and \`memory-synthesize\` to hydrate architectural context before coding.
-4. Call \`standard-search\` before any code edit, test edit, refactor, migration, or implementation decision. This is mandatory even for small tasks; use the task intent, affected files, inferred language, stack, and repo as filters. If no relevant standards are returned, continue and state that no applicable standards were found.
-
-## Core Workflows
-
-**Memory**: \`memory-search\` \u2192 \`memory-detail\` \u2192 \`memory-store\` / \`memory-update\`
-- Store only durable knowledge (architecture, patterns, decisions, fixes).
-- Use \`memory-acknowledge\` after generating code from memory results.
-- Global scope only for cross-repo rules; prefer repo-specific scope.
-
-**Tasks**: \`task-list\` \u2192 \`task-claim\` \u2192 \`task-update\` (in_progress \u2192 completed)
-- Register planned steps via \`task-create\` before execution.
-- Never skip intermediate \`in_progress\` state before \`completed\`.
-- Completing a task auto-releases claims and expires linked handoffs.
-
-**Standards**: \`standard-search\` \u2192 \`standard-store\`
-- \`standard-search\` is the pre-implementation gate for code, tests, refactors, migrations, and implementation decisions.
-- One rule per entry. Treat as normative implementation contracts, not docs summaries.
-
-**Handoffs/Claims**: \`handoff-list\` \u2192 \`handoff-create\` / \`handoff-update\` | \`task-claim\` / \`claim-release\`
-- Create handoffs only for unfinished work with concrete next owner or next steps.
-- Do NOT create handoffs as completion summaries \u2014 put those on \`task-update\` comments.
-
-## Available Prompts (invoke as slash commands)
-- \`session-planner\` \u2014 orient and plan at session start
-- \`task-memory-executor\` \u2014 execute tasks with memory and standard enforcement
-- \`senior-code-review\` \u2014 full code review against stored standards
-- \`memory-guided-review\` \u2014 review using project memory as context
-- \`architecture-design\` \u2014 architectural planning and ADR generation
-- \`technical-planning\` \u2014 feature planning with task decomposition
-- \`root-cause-analysis\` \u2014 structured bug / incident investigation
-- \`fix-suggestion\` \u2014 propose and validate fixes
-- \`security-triage\` \u2014 security risk assessment
-- \`learning-retrospective\` \u2014 capture lessons and update memory
-- \`documentation-sync\` \u2014 sync docs with current codebase state
-- \`project-briefing\` \u2014 generate repository briefing from memory
-`.trim();
+var SERVER_INSTRUCTIONS = loadServerInstructions();
 var CAPABILITIES = {
   serverInfo: {
-    name: "mcp-memory-local",
+    name: "local-memory-mcp",
     version: pkgVersion,
     instructions: SERVER_INSTRUCTIONS
   },
@@ -90,7 +125,7 @@ var CAPABILITIES = {
 };
 
 // src/mcp/utils/logger.ts
-import fs from "fs";
+import fs2 from "fs";
 var LEVELS = {
   debug: 0,
   info: 1,
@@ -210,11 +245,11 @@ function addLogSink(sink) {
 }
 var LOG_LEVEL_VALUES = Object.keys(LEVELS);
 function createFileSink(logDir, maxFiles = 5) {
-  fs.mkdirSync(logDir, { recursive: true });
-  const existing = fs.readdirSync(logDir).filter((f) => f.startsWith("mcp-") && f.endsWith(".log")).sort();
+  fs2.mkdirSync(logDir, { recursive: true });
+  const existing = fs2.readdirSync(logDir).filter((f) => f.startsWith("mcp-") && f.endsWith(".log")).sort();
   while (existing.length >= maxFiles) {
     try {
-      fs.unlinkSync(`${logDir}/${existing.shift()}`);
+      fs2.unlinkSync(`${logDir}/${existing.shift()}`);
     } catch {
     }
   }
@@ -224,7 +259,7 @@ function createFileSink(logDir, maxFiles = 5) {
     const line = `${(/* @__PURE__ */ new Date()).toISOString()} [${payload.level.toUpperCase()}] [pid:${process.pid}] ${JSON.stringify(payload.data)}
 `;
     try {
-      fs.appendFileSync(logFile, line);
+      fs2.appendFileSync(logFile, line);
     } catch {
     }
   };
@@ -232,8 +267,8 @@ function createFileSink(logDir, maxFiles = 5) {
 
 // src/mcp/storage/sqlite.ts
 import Database from "better-sqlite3";
-import path3 from "path";
-import fs3 from "fs";
+import path4 from "path";
+import fs4 from "fs";
 import os from "os";
 
 // src/mcp/storage/migrations.ts
@@ -2725,8 +2760,8 @@ var HandoffEntity = class extends BaseEntity {
 
 // src/mcp/storage/write-lock.ts
 import lockfile from "proper-lockfile";
-import path2 from "path";
-import fs2 from "fs";
+import path3 from "path";
+import fs3 from "fs";
 var LOCK_STALE_MS = 3e4;
 var LOCK_RETRY_DELAY_MS = 200;
 var LOCK_RETRY_COUNT = 250;
@@ -2735,9 +2770,9 @@ var WriteLock = class {
   locked = false;
   constructor(dbPath) {
     this.lockTarget = dbPath;
-    if (!fs2.existsSync(dbPath)) {
-      fs2.mkdirSync(path2.dirname(dbPath), { recursive: true });
-      fs2.writeFileSync(dbPath, "");
+    if (!fs3.existsSync(dbPath)) {
+      fs3.mkdirSync(path3.dirname(dbPath), { recursive: true });
+      fs3.writeFileSync(dbPath, "");
     }
   }
   /**
@@ -2789,13 +2824,13 @@ var WriteLock = class {
 // src/mcp/storage/sqlite.ts
 function resolveDbPath() {
   if (process.env.MEMORY_DB_PATH) return process.env.MEMORY_DB_PATH;
-  const standardConfigDir = process.platform === "win32" ? path3.join(os.homedir(), ".local-memory-mcp") : process.platform === "darwin" ? path3.join(os.homedir(), "Library", "Application Support", "local-memory-mcp") : path3.join(os.homedir(), ".config", "local-memory-mcp");
-  const standardPath = path3.join(standardConfigDir, "memory.db");
-  if (fs3.existsSync(standardPath)) return standardPath;
-  const legacyPath = path3.join(os.homedir(), ".config", "local-memory-mcp", "memory.db");
-  if (fs3.existsSync(legacyPath)) return legacyPath;
-  const localCwdFile = path3.join(process.cwd(), "storage", "memory.db");
-  if (fs3.existsSync(localCwdFile)) return localCwdFile;
+  const standardConfigDir = process.platform === "win32" ? path4.join(os.homedir(), ".local-memory-mcp") : process.platform === "darwin" ? path4.join(os.homedir(), "Library", "Application Support", "local-memory-mcp") : path4.join(os.homedir(), ".config", "local-memory-mcp");
+  const standardPath = path4.join(standardConfigDir, "memory.db");
+  if (fs4.existsSync(standardPath)) return standardPath;
+  const legacyPath = path4.join(os.homedir(), ".config", "local-memory-mcp", "memory.db");
+  if (fs4.existsSync(legacyPath)) return legacyPath;
+  const localCwdFile = path4.join(process.cwd(), "storage", "memory.db");
+  if (fs4.existsSync(localCwdFile)) return localCwdFile;
   return standardPath;
 }
 var DB_PATH = resolveDbPath();
@@ -2814,9 +2849,9 @@ var SQLiteStore = class _SQLiteStore {
     const finalPath = dbPath ?? DB_PATH;
     this.dbPathInstance = finalPath;
     if (finalPath !== ":memory:") {
-      const dbDir = path3.dirname(finalPath);
-      if (!fs3.existsSync(dbDir)) {
-        fs3.mkdirSync(dbDir, { recursive: true });
+      const dbDir = path4.dirname(finalPath);
+      if (!fs4.existsSync(dbDir)) {
+        fs4.mkdirSync(dbDir, { recursive: true });
       }
     }
     this.db = new Database(finalPath);
@@ -2871,12 +2906,12 @@ var SQLiteStore = class _SQLiteStore {
    */
   _attemptRecovery(dbPath) {
     const backupPath = dbPath + ".backup";
-    if (fs3.existsSync(backupPath)) {
+    if (fs4.existsSync(backupPath)) {
       logger.warn("[SQLiteStore] Attempting recovery from backup", { backupPath });
       try {
         const corruptPath = `${dbPath}.corrupt_${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "").slice(0, 15)}`;
-        fs3.copyFileSync(dbPath, corruptPath);
-        fs3.copyFileSync(backupPath, dbPath);
+        fs4.copyFileSync(dbPath, corruptPath);
+        fs4.copyFileSync(backupPath, dbPath);
         logger.warn("[SQLiteStore] Recovery successful. Corrupt file saved to", { corruptPath });
       } catch (err) {
         logger.error("[SQLiteStore] Recovery failed", { error: String(err) });
@@ -2894,7 +2929,7 @@ var SQLiteStore = class _SQLiteStore {
     try {
       this.db.pragma("wal_checkpoint(PASSIVE)");
       const backupPath = this.dbPathInstance + ".backup";
-      fs3.copyFileSync(this.dbPathInstance, backupPath);
+      fs4.copyFileSync(this.dbPathInstance, backupPath);
     } catch (err) {
       logger.warn("[SQLiteStore] Backup failed", { error: String(err) });
     }
@@ -3017,8 +3052,8 @@ var RealVectorStore = class {
 };
 
 // src/mcp/session.ts
-import path4 from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
+import path5 from "path";
+import { fileURLToPath as fileURLToPath3 } from "url";
 function createSessionContext() {
   return {
     roots: [],
@@ -3083,7 +3118,7 @@ function getFilesystemRoots(session) {
   for (const root of session.roots) {
     if (!root.uri.startsWith("file://")) continue;
     try {
-      resolved.push(path4.resolve(fileURLToPath2(root.uri)));
+      resolved.push(path5.resolve(fileURLToPath3(root.uri)));
     } catch {
     }
   }
@@ -3092,19 +3127,19 @@ function getFilesystemRoots(session) {
 function isPathWithinRoots(targetPath, session) {
   const roots = getFilesystemRoots(session);
   if (roots.length === 0) return true;
-  const normalizedTarget = path4.resolve(targetPath);
+  const normalizedTarget = path5.resolve(targetPath);
   return roots.some((rootPath) => {
-    const relative = path4.relative(rootPath, normalizedTarget);
-    return relative === "" || !relative.startsWith("..") && !path4.isAbsolute(relative);
+    const relative = path5.relative(rootPath, normalizedTarget);
+    return relative === "" || !relative.startsWith("..") && !path5.isAbsolute(relative);
   });
 }
 function findContainingRoot(targetPath, session) {
   const roots = getFilesystemRoots(session);
   if (roots.length === 0) return null;
-  const normalizedTarget = path4.resolve(targetPath);
+  const normalizedTarget = path5.resolve(targetPath);
   for (const rootPath of roots) {
-    const relative = path4.relative(rootPath, normalizedTarget);
-    if (relative === "" || !relative.startsWith("..") && !path4.isAbsolute(relative)) {
+    const relative = path5.relative(rootPath, normalizedTarget);
+    if (relative === "" || !relative.startsWith("..") && !path5.isAbsolute(relative)) {
       return rootPath;
     }
   }
@@ -3113,7 +3148,7 @@ function findContainingRoot(targetPath, session) {
 function inferRepoFromSession(session) {
   const roots = getFilesystemRoots(session);
   if (roots.length === 1) {
-    return path4.basename(roots[0]);
+    return path5.basename(roots[0]);
   }
   return void 0;
 }
@@ -3228,7 +3263,7 @@ var SingleTaskCreateSchema = z.object({
   doc_path: z.string().optional(),
   tags: z.array(z.string()).optional(),
   metadata: z.record(z.string(), z.any()).optional(),
-  parent_id: z.string().uuid().optional(),
+  parent_id: z.string().optional(),
   depends_on: z.string().uuid().optional(),
   est_tokens: z.number().int().min(0).optional()
 });
@@ -3246,7 +3281,7 @@ var TaskCreateSchema = z.object({
   doc_path: z.string().optional(),
   tags: z.array(z.string()).optional(),
   metadata: z.record(z.string(), z.any()).optional(),
-  parent_id: z.string().uuid().optional(),
+  parent_id: z.string().optional(),
   depends_on: z.string().uuid().optional(),
   est_tokens: z.number().int().min(0).optional(),
   // Allow bulk tasks
@@ -3280,7 +3315,7 @@ var TaskUpdateSchema = z.object({
   doc_path: z.string().optional(),
   tags: z.array(z.string()).optional(),
   metadata: z.record(z.string(), z.any()).optional(),
-  parent_id: z.string().uuid().optional(),
+  parent_id: z.string().optional(),
   depends_on: z.string().uuid().optional(),
   est_tokens: z.number().int().min(0).optional(),
   force: z.boolean().optional(),
@@ -4080,7 +4115,7 @@ var TOOL_DEFINITIONS = [
         doc_path: { type: "string" },
         tags: { type: "array", items: { type: "string" } },
         metadata: { type: "object" },
-        parent_id: { type: "string", format: "uuid" },
+        parent_id: { type: "string", description: "Optional parent task ID (UUID) or parent task code (e.g. TASK-001). Resolved to UUID before storing." },
         depends_on: { type: "string", format: "uuid" },
         est_tokens: { type: "number", minimum: 0, description: "Estimated tokens budget for this task" },
         tasks: {
@@ -4105,7 +4140,7 @@ var TOOL_DEFINITIONS = [
               doc_path: { type: "string" },
               tags: { type: "array", items: { type: "string" } },
               metadata: { type: "object" },
-              parent_id: { type: "string", format: "uuid" },
+              parent_id: { type: "string", description: "Optional parent task ID (UUID) or parent task code (e.g. TASK-001). Resolved to UUID before storing." },
               depends_on: { type: "string", format: "uuid" },
               est_tokens: { type: "number", minimum: 0 }
             },
@@ -4174,7 +4209,7 @@ var TOOL_DEFINITIONS = [
         doc_path: { type: "string" },
         tags: { type: "array", items: { type: "string" } },
         metadata: { type: "object" },
-        parent_id: { type: "string", format: "uuid" },
+        parent_id: { type: "string", description: "Optional parent task ID (UUID) or parent task code (e.g. TASK-001). Resolved to UUID before storing." },
         depends_on: { type: "string", format: "uuid" },
         est_tokens: {
           type: "number",
@@ -4253,7 +4288,7 @@ var TOOL_DEFINITIONS = [
       properties: {
         repo: {
           type: "string",
-          description: "Repository name"
+          description: "Repository name (required)"
         },
         status: {
           type: "string",
@@ -5208,53 +5243,6 @@ function invalidCompletionParams(message) {
   return error;
 }
 
-// src/mcp/prompts/loader.ts
-import fs4 from "fs";
-import path5 from "path";
-import { fileURLToPath as fileURLToPath3 } from "url";
-import matter from "gray-matter";
-var __filename = fileURLToPath3(import.meta.url);
-var __dirname2 = path5.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) => path5.resolve(__dirname2, 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 path5.resolve(__dirname2, "./definitions");
-}
-var PROMPT_DIR = findPromptDir();
-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 filePath = path5.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);
-  return {
-    name: data.name || name,
-    description: data.description || "",
-    arguments: data.arguments || [],
-    agent: data.agent,
-    content: content.trim()
-  };
-}
-
 // src/mcp/prompts/registry.ts
 function createPromptDefinition(loaded) {
   return {

package/dist/dashboard/server.js

@@ -10,7 +10,7 @@ import {
   createFileSink,
   listResources,
   logger
-} from "../chunk-Z6FENX4V.js";
+} from "../chunk-HXADESDJ.js";
 
 // src/dashboard/server.ts
 import express from "express";

package/dist/mcp/server.js

@@ -57,7 +57,7 @@ import {
   toContextSlug,
   updateSessionFromInitialize,
   updateSessionRoots
-} from "../chunk-Z6FENX4V.js";
+} from "../chunk-HXADESDJ.js";
 
 // src/mcp/server.ts
 import readline from "readline";
@@ -739,6 +739,14 @@ function capitalize2(str) {
 
 // src/mcp/tools/task.manage.ts
 import { randomUUID as randomUUID2 } from "crypto";
+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 resolveParentId(value, repo, storage) {
+  if (!value) return null;
+  if (UUID_REGEX.test(value)) return value;
+  const parent = storage.tasks.getTaskByCode(repo, value);
+  if (!parent) throw new Error(`parent_id: task with code '${value}' not found in repo '${repo}'`);
+  return parent.id;
+}
 function describeTaskListFilter(status) {
   if (!status) return "active";
   if (status === "all") return "all";
@@ -932,7 +940,7 @@ async function handleTaskCreate(args, storage) {
       if (normalizedStatus === "pending") {
         if (initialStats.todo + pendingInRequestCount >= 10) {
           throw new Error(
-            `Cannot create task '${taskData.task_code}' as 'pending'. Maximum of 10 pending tasks reached.`
+            `Cannot create task '${taskData.task_code}' as 'pending'. Maximum of 10 pending tasks reached. Please use status 'backlog' for new tasks instead.`
           );
         }
       }
@@ -962,7 +970,7 @@ async function handleTaskCreate(args, storage) {
         est_tokens: taskData.est_tokens ?? 0,
         tags,
         metadata: taskData.metadata || {},
-        parent_id: taskData.parent_id || null,
+        parent_id: resolveParentId(taskData.parent_id, repo, storage),
         depends_on: taskData.depends_on || null
       };
       storage.tasks.insertTask(task2);
@@ -1005,7 +1013,7 @@ async function handleTaskCreate(args, storage) {
   if (status === "pending") {
     const stats = storage.tasks.getTaskStats(repo);
     if (stats.todo >= 10) {
-      throw new Error(`Cannot create task as 'pending'. Maximum of 10 pending tasks reached.`);
+      throw new Error(`Cannot create task as 'pending'. Maximum of 10 pending tasks reached. Please use status 'backlog' for new tasks instead.`);
     }
   }
   const taskId = randomUUID2();
@@ -1036,7 +1044,7 @@ async function handleTaskCreate(args, storage) {
     est_tokens: est_tokens ?? 0,
     tags: finalTags,
     metadata: metadata || {},
-    parent_id: parent_id || null,
+    parent_id: resolveParentId(parent_id, repo, storage),
     depends_on: depends_on || null
   };
   storage.tasks.insertTask(task);
@@ -1202,6 +1210,9 @@ async function handleTaskUpdate(args, storage, vectors2) {
       throw new Error(`Duplicate task_code: '${updates.task_code}' already exists`);
     }
     const finalUpdates = { ...updates };
+    if (updates.parent_id !== void 0) {
+      finalUpdates.parent_id = resolveParentId(updates.parent_id, repo, storage);
+    }
     if (updates.phase !== void 0 || updates.tags !== void 0) {
       let currentTags = updates.tags || existingTask.tags || [];
       currentTags = currentTags.filter((t) => !t.startsWith("phase:"));

package/dist/prompts/architecture-design.md

@@ -3,17 +3,21 @@ name: architecture-design
 description: Plan system architecture, component layout, and data flow
 arguments:
   - name: tech_stack
-    description: Technology stack
-    required: true
+    description: Technology stack. Optional — auto-detected from repo package files, language, and active task tags if omitted.
+    required: false
   - name: requirements
-    description: Key requirements
-    required: true
+    description: Key requirements. Optional — inferred from active task description, pending handoff, or recent conversation if omitted.
+    required: false
 agent: System Architect
 ---
-Design system architecture for repository.
+## 0. CONTEXT RESOLUTION
+- **tech_stack**: If provided, use directly. If omitted — detect from package.json, pyproject.toml, Gemfile, or repo file extensions.
+- **requirements**: If provided, use directly. If omitted — extract from active `in_progress` task description, pending handoff context, or recent conversation.
 
-Stack: {{tech_stack}}
-Requirements: {{requirements}}
+Design system architecture for the active repository.
+
+Stack: (resolved above)
+Requirements: (resolved above)
 
 Output:
 1. **Component Diagram**: Blocks & responsibilities.

package/dist/prompts/create-task.md

@@ -3,11 +3,10 @@ name: create-task
 description: Create structured, atomic tasks in Local Memory MCP.
 arguments:
   - name: instruction
-    description: Directive to analyze and break into tasks.
-    required: true
+    description: Directive to analyze and break into tasks. Optional — derived from active task, pending handoff, or recent conversation if omitted.
+    required: false
 agent: Task Planner
 ---
-# Skill: create-task (Task Creation Orchestrator)
 
 ## 🚫 FORBIDDEN: NON-EXECUTION
 DO NOT edit/create/delete files, run commands, or implement code.

package/dist/prompts/csl-from-docs.md

@@ -3,14 +3,15 @@ name: csl-from-docs
 description: Create atomic CSL coding standards entries from a local file or directory path.
 arguments:
   - name: path
-    description: Local path (file or directory) containing documentation or standards.
-    required: true
+    description: Local path (file or directory) containing documentation or standards. Optional — defaults to docs/, README, or prompts definitions directory of the active repo if omitted.
+    required: false
 agent: Documentation Processor
 ---
-Fetch and convert local documentation from the provided path into atomic CSL (Coding Standards Library) entries for the coding_standards entity.
+## 0. CONTEXT RESOLUTION
+- **path**: If provided, use directly. If omitted — default to `docs/`, `README.md`, or `src/mcp/prompts/definitions/` in the active repo root.
+- **current_repo**: Auto-detect from git remote or active workspace context.
 
-Path: {{path}}
-Current repo: {{current_repo}}
+Fetch and convert local documentation from the resolved path into atomic CSL (Coding Standards Library) entries.
 
 Goal:
 - Analyze the provided path.

package/dist/prompts/csl-scrapper.md

@@ -3,14 +3,15 @@ name: csl-scrapper
 description: Scrape trusted documentation from a URL into atomic CSL coding standards entries.
 arguments:
   - name: source_url
-    description: Canonical URL for the documentation source to scrape.
-    required: true
+    description: Canonical URL for the documentation source to scrape. Optional — if omitted, use the most recently referenced URL from conversation context.
+    required: false
 agent: Documentation Scraper
 ---
-Fetch and convert trusted documentation from the provided URL into atomic CSL (Coding Standards Library) entries for the coding_standards entity.
+## 0. CONTEXT RESOLUTION
+- **source_url**: Use `{{source_url}}` if provided. If omitted — extract from the most recently mentioned URL in conversation context or active task description.
+- **current_repo**: Auto-detect from git remote or active workspace context.
 
-Source URL: {{source_url}}
-Current repo: {{current_repo}}
+Fetch and convert trusted documentation from the resolved URL into atomic CSL (Coding Standards Library) entries.
 
 Goal:
 - Use the web_fetch tool (if available) to retrieve the content of the provided Source URL.

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

@@ -2,35 +2,32 @@
 name: export-task-to-github
 description: Export local tasks to GitHub Issues
 arguments:
-  - name: owner
-    description: GitHub repo owner
-    required: true
-  - name: repo
-    description: GitHub repo name
-    required: true
   - name: task_id
-    description: Local task ID
-    required: true
+    description: Local task ID. Optional — if omitted, all tasks in the active repo are exported.
+    required: false
 agent: Integration Architect
 ---
-# Skill: export-task-to-github
 
-## 1. RETRIEVE
-1.  **Fetch**: Call `task-detail` for `task_id`.
-2.  **Verify**: Ensure title/description exist. Use `memory-search` for gaps.
+## 1. IDENTIFY ACTIVE PROJECT
+1.  **Detect**: Get repo name and owner from git remote (e.g. `git remote get-url origin`) or active workspace context. Parse `owner` and `repo` from the remote URL automatically.
+2.  **Verify**: Confirm the detected `owner`/`repo` before proceeding.
 
-## 2. SYNC CHECK
-1.  **Search**: Use `search_issues` for `task_code`.
+## 2. RETRIEVE
+1.  **Scope**: If `task_id` provided — fetch that single task via `task-detail`. If omitted — call `task-list` (status: `pending,in_progress,completed`) to get all tasks in the active repo, then process each.
+2.  **Verify**: Ensure title/description exist per task. Use `memory-search` for gaps.
+
+## 3. SYNC CHECK
+1.  **Search**: Use `search_issues` for `task_code` scoped to detected `owner`/`repo`.
 2.  **De-duplicate**: If issue exists, update local task `metadata` with URL. DO NOT re-create.
 
-## 3. CREATE ISSUE
+## 4. CREATE ISSUE
 If new:
--   **Write**: Use `issue_write` (method: 'create').
+-   **Write**: Use `issue_write` (method: 'create') with detected `owner`/`repo`.
 -   **Content**: Match local title/body exactly.
 -   **Traceability**: Append `task_code` and `task_id` to body.
 -   **Comments**: Post local comments via `add_issue_comment`.
 
-## 4. LINK
+## 5. LINK
 -   **Update**: Call `task-update`.
 -   **Metadata**: Add GitHub URL.
 -   **Comment**: "Exported to GitHub Issue #X".

package/dist/prompts/fix-suggestion.md

@@ -3,21 +3,24 @@ name: fix-suggestion
 description: Targeted fix with before/after code and test case.
 arguments:
   - name: tech_stack
-    description: Target tech stack.
-    required: true
+    description: Target tech stack. Optional — inferred from repo/context if omitted.
+    required: false
   - name: bug_description
-    description: Bug behavior.
-    required: true
+    description: Bug behavior. Optional — inferred from active conversation or task context if omitted.
+    required: false
   - name: root_cause
-    description: Identified root cause.
-    required: true
+    description: Identified root cause. Optional — inferred from recent error/log context if omitted.
+    required: false
 agent: Debugging Expert
 ---
-Provide precise, minimal fix for confirmed bug.
 
-Stack: {{tech_stack}}
-Bug: {{bug_description}}
-Cause: {{root_cause}}
+## 0. CONTEXT RESOLUTION
+Resolve missing arguments from available context before proceeding:
+- **tech_stack**: Detect from repo language, package files, or active task tags. Fallback: ask agent to infer from open files.
+- **bug_description**: Extract from active task description, recent conversation, or error logs. Fallback: describe observable broken behavior.
+- **root_cause**: Extract from recent analysis, error traces, or `memory-search` results. Fallback: state "unknown — investigation required".
+
+Provide precise, minimal fix for confirmed bug.
 
 Output:
 1. **Explanation**: Why it happens & how fix works.

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

@@ -4,7 +4,6 @@ description: Import GitHub Issues as local tasks.
 arguments: []
 agent: Integration Scout
 ---
-# Skill: import-github-issues
 
 ## 1. FETCH
 -   **Primary**: Use `github-mcp-server` to list open issues.

package/dist/prompts/learning-retrospective.md

@@ -3,11 +3,15 @@ name: learning-retrospective
 description: Harvest knowledge from completed work.
 arguments:
   - name: task_id
-    description: ID of completed task.
+    description: ID or code of completed task. Optional — defaults to most recently completed task in the active repo.
     required: false
 agent: Knowledge Harvester
 ---
-Extract durable knowledge from task {{task_id}} for repository.
+## 0. CONTEXT RESOLUTION
+1. **Repo**: Auto-detect from git remote or active workspace context. All MCP calls MUST be scoped to this repo.
+2. **Task**: If `task_id` provided — use it directly. If omitted — call `task-list` (status: `completed`, limit: 1, ordered by updated_at desc) to get the most recently completed task.
+
+Extract durable knowledge from the resolved task for the active repository.
 
 Identify and `memory-store`:
 1. **Mistakes**: Hard-to-find bugs or environment quirks.

package/dist/prompts/memory-guided-review.md

@@ -3,11 +3,14 @@ name: memory-guided-review
 description: Review code for compliance with stored decisions.
 arguments:
   - name: file_path
-    description: File to review.
-    required: true
+    description: File to review. Optional — if omitted, review the currently open/active file in the workspace, or all recently modified files.
+    required: false
 agent: Code Auditor
 ---
-Audit {{file_path}} against stored project knowledge.
+## 0. CONTEXT RESOLUTION
+- **file_path**: If provided, use it. If omitted — use the currently active/open file from workspace context, or list recently modified files via git and process them.
+
+Audit the resolved file(s) against stored project knowledge.
 
 Steps:
 1. **Search Memory**: Call `memory-search` using `current_file_path='{{file_path}}'`.

package/dist/prompts/review-and-audit.md

@@ -3,17 +3,20 @@ name: review-and-audit
 description: Audit documentation against implementation; generate local tasks for gaps.
 arguments:
   - name: target
-    description: Module, feature, or component to audit.
+    description: Module, feature, or component to audit. Optional — if omitted, audits all available documentation against the full implementation.
     required: false
 agent: Quality Auditor
 ---
-# Skill: review-and-audit (Audit Agent)
+
+## 0. CONTEXT RESOLUTION
+- **Target**: If `target` provided — scope audit to that module/feature/component. If omitted — **fallback**: audit ALL existing documentation (README, docs/, prompts, schemas) against the full codebase implementation. Enumerate each doc file and compare with corresponding source.
+- **Repo**: Auto-detect from git remote or active workspace context.
 
 ## 1. ANALYSIS
-1. **Sequential Discovery**: Explore docs and code sequentially. NO parallel sub-agents.
-2. **UX Audit**: Use `chrome-dev-tools` for visual, navigation, and responsiveness checks.
+1. **Discovery**: Explore docs and code. Coding sub-agents MAY be used for parallel file reading if the agent supports sub-agents. `chrome-devtools-mcp` MCP tools (direct tool calls) are **ALLOWED**. **FORBIDDEN**: spawning a `browser_subagent` — do NOT invoke the `browser_subagent` tool here. Distinction: MCP tool call = allowed; spawned browser agent process = forbidden.
+2. **UX Audit**: If target involves UI and the audit explicitly requires visual inspection, note it as a separate task — do NOT block the audit on it.
 3. **Reference Audit**: Check current tool/prompt/resource definitions through code or the dashboard Reference flow.
-4. **Compare**: Match docs + code findings against live UI to find gaps/misalignments.
+4. **Compare**: Match docs + code findings to find gaps/misalignments.
 
 ## 🚫 FORBIDDEN: NON-EXECUTION
 DO NOT edit/create/delete files, run commands, or implement code.

package/dist/prompts/review-and-post-issue.md

@@ -3,22 +3,25 @@ name: review-and-post-issue
 description: Audit documentation against implementation; generate GitHub issues for gaps.
 arguments:
   - name: owner
-    description: GitHub repo owner.
-    required: true
+    description: GitHub repo owner. Optional — auto-detected from git remote if omitted.
+    required: false
   - name: repo
-    description: GitHub repo name.
-    required: true
+    description: GitHub repo name. Optional — auto-detected from git remote if omitted.
+    required: false
   - name: target
-    description: Module, feature, or component to audit.
+    description: Module, feature, or component to audit. Optional — if omitted, audits all documentation against the full implementation.
     required: false
 agent: Quality Auditor
 ---
-# Skill: review-and-post-issue (Audit Agent)
+
+## 0. CONTEXT RESOLUTION
+1. **Owner/Repo**: Auto-detect from `git remote get-url origin` or active workspace context. Parse `owner` and `repo` from the remote URL. Verify before proceeding.
+2. **Target**: If `target` provided — scope to that module/feature. If omitted — **fallback**: audit ALL existing documentation against the full codebase.
 
 ## 1. ANALYSIS
-1. **Sequential Discovery**: Explore docs and code sequentially. NO parallel sub-agents.
-2. **UX Audit**: If applicable, use `chrome-dev-tools` for visual, navigation, and responsiveness checks.
-3. **Compare**: Match findings against live UI to find gaps/misalignments.
+1. **Discovery**: Explore docs and code. Coding sub-agents MAY be used for parallel reading if the agent supports sub-agents. **FORBIDDEN: browser sub-agents**.
+2. **UX Audit**: If the target involves UI, note it as a separate GitHub issue — do NOT block audit on visual inspection.
+3. **Compare**: Match docs + code findings to identify gaps/misalignments.
 
 ## 🚫 FORBIDDEN: NON-EXECUTION
 DO NOT edit/create/delete files, run commands, or implement code.

package/dist/prompts/root-cause-analysis.md

@@ -3,21 +3,22 @@ name: root-cause-analysis
 description: 5-Why analysis to trace bug origins.
 arguments:
   - name: tech_stack
-    description: Target tech stack.
-    required: true
+    description: Target tech stack. Optional — auto-detected from repo/context if omitted.
+    required: false
   - name: bug_description
-    description: Bug behavior.
-    required: true
+    description: Bug behavior. Optional — inferred from active task or recent conversation if omitted.
+    required: false
   - name: symptoms
     description: Logs, errors, metrics.
     required: false
 agent: Diagnostic Lead
 ---
-Conduct root cause analysis for repository bug.
+## 0. CONTEXT RESOLUTION
+- **tech_stack**: If provided, use directly. If omitted — detect from repo package files or active task tags.
+- **bug_description**: If provided, use directly. If omitted — extract from active task description or recent error/log context.
+- **symptoms**: Optional. Use if provided; otherwise infer from available logs or error traces.
 
-Stack: {{tech_stack}}
-Bug: {{bug_description}}
-Symptoms: {{symptoms}}
+Conduct root cause analysis for the active repository bug.
 
 Output:
 1. **Symptom**: Technical problem restatement.

package/dist/prompts/security-triage.md

@@ -3,21 +3,22 @@ name: security-triage
 description: Assess vulnerability exploitability and prioritize fix.
 arguments:
   - name: tech_stack
-    description: App stack.
-    required: true
+    description: App stack. Optional — auto-detected from repo/context if omitted.
+    required: false
   - name: vulnerability_report
-    description: Report details (CVE, SAST).
-    required: true
+    description: Report details (CVE, SAST). Optional — extracted from active task description or recent conversation if omitted.
+    required: false
   - name: codebase_context
     description: Usage context.
     required: false
 agent: Security Engineer
 ---
-Triage vulnerability for repository.
+## 0. CONTEXT RESOLUTION
+- **tech_stack**: If provided, use directly. If omitted — detect from repo package files, language, or active task tags.
+- **vulnerability_report**: If provided, use directly. If omitted — extract from active task description, recent conversation, or attached SAST output.
+- **codebase_context**: Optional. Use if provided.
 
-Stack: {{tech_stack}}
-Report: {{vulnerability_report}}
-Context: {{codebase_context}}
+Triage the resolved vulnerability for the active repository.
 
 Output:
 1. **Classification**: Type, CVE, CVSS, vector.

package/dist/prompts/senior-code-review.md

@@ -3,17 +3,18 @@ name: senior-code-review
 description: Comprehensive production-readiness evaluation.
 arguments:
   - name: tech_stack
-    description: Tech stack.
-    required: true
+    description: Tech stack. Optional — auto-detected from repo package files, language, or active task tags if omitted.
+    required: false
   - name: context
     description: Production context (SLA, data, conventions).
     required: false
 agent: Principal Reviewer
 ---
-Perform production-readiness review for repository.
+## 0. CONTEXT RESOLUTION
+- **tech_stack**: If provided, use directly. If omitted — detect from repo package files or language.
+- **context**: Optional. Use if provided; otherwise infer from task description or recent conversation.
 
-Stack: {{tech_stack}}
-Context: {{context}}
+Perform production-readiness review for the active repository.
 
 Audit Dimensions:
 1. **Errors**: Completeness & patterns.

package/dist/prompts/server/instructions.md

@@ -0,0 +1,46 @@
+---
+name: server-instructions
+description: Main instructions for the MCP server
+---
+Local Memory MCP — persistent memory, task coordination, and coding standards for AI agents.
+
+## When to use this server
+Use at the START of every session and before any implementation work:
+1. Call `task-list` to sync active/pending tasks for the current repository.
+2. Call `handoff-list` to check pending context transfers. Close stale handoffs with `handoff-update`.
+3. Call `memory-search` and `memory-synthesize` to hydrate architectural context before coding.
+4. Call `standard-search` before any code edit, test edit, refactor, migration, or implementation decision. This is mandatory even for small tasks; use the task intent, affected files, inferred language, stack, and repo as filters. If no relevant standards are returned, continue and state that no applicable standards were found.
+
+## Core Workflows
+
+**Memory**: `memory-search` → `memory-detail` → `memory-store` / `memory-update`
+- Store only durable knowledge (architecture, patterns, decisions, fixes).
+- Use `memory-acknowledge` after generating code from memory results.
+- Global scope only for cross-repo rules; prefer repo-specific scope.
+
+**Tasks**: `task-list` → `task-claim` → `task-update` (in_progress → completed)
+- Register planned steps via `task-create` before execution.
+- Never skip intermediate `in_progress` state before `completed`.
+- Completing a task auto-releases claims and expires linked handoffs.
+
+**Standards**: `standard-search` → `standard-store`
+- `standard-search` is the pre-implementation gate for code, tests, refactors, migrations, and implementation decisions.
+- One rule per entry. Treat as normative implementation contracts, not docs summaries.
+
+**Handoffs/Claims**: `handoff-list` → `handoff-create` / `handoff-update` | `task-claim` / `claim-release`
+- Create handoffs only for unfinished work with concrete next owner or next steps.
+- Do NOT create handoffs as completion summaries — put those on `task-update` comments.
+
+## Available Prompts (invoke as slash commands)
+- `session-planner` — orient and plan at session start
+- `task-memory-executor` — execute tasks with memory and standard enforcement
+- `senior-code-review` — full code review against stored standards
+- `memory-guided-review` — review using project memory as context
+- `architecture-design` — architectural planning and ADR generation
+- `technical-planning` — feature planning with task decomposition
+- `root-cause-analysis` — structured bug / incident investigation
+- `fix-suggestion` — propose and validate fixes
+- `security-triage` — security risk assessment
+- `learning-retrospective` — capture lessons and update memory
+- `documentation-sync` — sync docs with current codebase state
+- `project-briefing` — generate repository briefing from memory

package/dist/prompts/session-planner.md

@@ -3,11 +3,14 @@ name: session-planner
 description: Break objective into atomic tasks.
 arguments:
   - name: objective
-    description: High-level session goal.
-    required: true
+    description: High-level session goal. Optional — inferred from active task, recent conversation, or pending handoff if omitted.
+    required: false
 agent: Strategy Lead
 ---
-Plan execution for: '{{objective}}'.
+## 0. CONTEXT RESOLUTION
+- **objective**: If provided, use directly. If omitted — extract from the active `in_progress` task description, the most recent pending handoff, or the last user request in conversation context.
+
+Plan execution for the resolved objective.
 
 Steps:
 1. **Orient**: Call `task-list` to avoid duplicate active/backlog work.

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

@@ -4,7 +4,6 @@ description: Sequentially execute pending tasks for current repository.
 arguments: []
 agent: Task Executor
 ---
-# Skill: task-memory-executor
 
 ## 1. SYNC & FILTER
 1. **Identify**: Get repo name (git/context).

package/dist/prompts/tech-affinity-scout.md

@@ -3,11 +3,14 @@ name: tech-affinity-scout
 description: Scout best practices from similar tech projects.
 arguments:
   - name: tags
-    description: CSV tech tags (e.g., 'react, tailwind').
-    required: true
+    description: CSV tech tags (e.g., 'react, tailwind'). Optional — auto-detected from repo package files, file extensions, or active task tags if omitted.
+    required: false
 agent: Tech Scout
 ---
-Scout for relevant knowledge using tags: [{{tags}}].
+## 0. CONTEXT RESOLUTION
+- **tags**: If provided, use directly. If omitted — detect from repo package files, file extensions, or active task tags.
+
+Scout for relevant knowledge using detected/provided tags.
 
 Steps:
 1. **Search**: Call `memory-search` with `current_tags=[{{tags}}]`.

package/dist/prompts/technical-planning.md

@@ -3,11 +3,14 @@ name: technical-planning
 description: Technical blueprint for new feature/product.
 arguments:
   - name: objective
-    description: High-level goal.
-    required: true
+    description: High-level goal. Optional — inferred from active task description, pending handoff, or recent conversation if omitted.
+    required: false
 agent: Technical Architect
 ---
-Create technical blueprint for: '{{objective}}'.
+## 0. CONTEXT RESOLUTION
+- **objective**: If provided, use directly. If omitted — extract from the active `in_progress` task description, the most recent pending handoff summary, or the last user instruction in conversation context.
+
+Create technical blueprint for the resolved objective.
 
 Cover:
 1. **Tech Stack**: Selected/confirmed technologies.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vheins/local-memory-mcp",
-	"version": "0.10.1",
+	"version": "0.10.3",
 	"description": "MCP Local Memory Service for coding copilot agents",
 	"mcpName": "io.github.vheins/local-memory-mcp",
 	"type": "module",
@@ -14,7 +14,8 @@
 		"dist",
 		"bin",
 		"storage/.gitkeep",
-		"dist/prompts/definitions"
+		"dist/prompts/definitions",
+		"dist/prompts/server"
 	],
 	"repository": {
 		"type": "git",
@@ -27,7 +28,7 @@
 	"author": "Muhammad Rheza Alfin <m.rheza.alfin@gmail.com>",
 	"license": "MIT",
 	"scripts": {
-		"build": "rm -rf dist && npm run dashboard:build && tsup --config tsup.config.ts && mkdir -p bin && cp -r src/mcp/prompts/definitions dist/prompts/ && printf \"#!/usr/bin/env node\\nimport '../dist/dashboard/server.js';\\n\" > bin/mcp-memory-dashboard.js && shx chmod +x dist/mcp/server.js dist/dashboard/server.js bin/mcp-memory-server.js bin/mcp-memory-dashboard.js",
+		"build": "rm -rf dist && npm run dashboard:build && tsup --config tsup.config.ts && mkdir -p bin && cp -r src/mcp/prompts/definitions dist/prompts/ && cp -r src/mcp/prompts/server dist/prompts/ && printf \"#!/usr/bin/env node\\nimport '../dist/dashboard/server.js';\\n\" > bin/mcp-memory-dashboard.js && shx chmod +x dist/mcp/server.js dist/dashboard/server.js bin/mcp-memory-server.js bin/mcp-memory-dashboard.js",
 		"dashboard:build": "vite build --config src/dashboard/ui/vite.config.ts",
 		"dashboard:dev": "vite dev --config src/dashboard/ui/vite.config.ts",
 		"prepare": "npm run build",