@vheins/local-memory-mcp 0.17.0 → 0.18.0

package/dist/{chunk-SITVJ6EA.js → chunk-YVPDPZXG.js}

@@ -81,8 +81,8 @@ function loadServerInstructions() {
 // src/mcp/capabilities.ts
 var __dirname2 = path2.dirname(fileURLToPath2(import.meta.url));
 var pkgVersion = "0.1.0";
-if ("0.17.0") {
-  pkgVersion = "0.17.0";
+if ("0.18.0") {
+  pkgVersion = "0.18.0";
 } else {
   let searchDir = __dirname2;
   for (let i = 0; i < 5; i++) {
@@ -3487,6 +3487,16 @@ function inferRepoFromSession(session) {
   }
   return void 0;
 }
+function inferOwnerFromSession(session) {
+  const roots = getFilesystemRoots(session);
+  if (roots.length === 1) {
+    const parts = roots[0].split(path5.sep).filter(Boolean);
+    if (parts.length >= 2) {
+      return parts[parts.length - 2];
+    }
+  }
+  return void 0;
+}
 
 // src/mcp/tools/schemas.ts
 import { z } from "zod";
@@ -3991,7 +4001,8 @@ var TOOL_DEFINITIONS = [
     inputSchema: {
       type: "object",
       properties: {
-        repo: { type: "string", description: "Repository name. Optional when a single MCP root is active." },
+        owner: { type: "string", description: "Organization/namespace (e.g., GitHub org or username)" },
+        repo: { type: "string", description: "Repository/project name. Optional when a single MCP root is active." },
         objective: { type: "string", minLength: 5, description: "Question or synthesis objective." },
         current_file_path: {
           type: "string",
@@ -4008,7 +4019,7 @@ var TOOL_DEFINITIONS = [
         max_tokens: { type: "number", minimum: 128, maximum: 4e3, default: 1200 },
         structured: { type: "boolean", default: false, description: "If true, returns structured JSON results." }
       },
-      required: ["objective"]
+      required: ["owner", "objective"]
     },
     outputSchema: {
       type: "object",
@@ -4037,6 +4048,10 @@ var TOOL_DEFINITIONS = [
     inputSchema: {
       type: "object",
       properties: {
+        owner: {
+          type: "string",
+          description: "Organization/namespace (e.g., GitHub org or username)"
+        },
         repo: {
           type: "string",
           description: "Repository name. Optional when it can be inferred from MCP roots or elicited from the user."
@@ -4171,12 +4186,13 @@ var TOOL_DEFINITIONS = [
         scope: {
           type: "object",
           properties: {
-            repo: { type: "string", description: "Repository name" },
-            branch: { type: "string" },
-            folder: { type: "string" },
-            language: { type: "string" }
+            owner: { type: "string", description: "Organization/namespace (e.g., GitHub org or username)" },
+            repo: { type: "string", description: "Repository/project name" },
+            branch: { type: "string", description: "Git branch this memory relates to" },
+            folder: { type: "string", description: "Subdirectory within the repo" },
+            language: { type: "string", description: "Programming language (e.g., 'typescript', 'python')" }
           },
-          required: ["repo"]
+          required: ["owner", "repo"]
         },
         tags: {
           type: "array",
@@ -4191,7 +4207,11 @@ var TOOL_DEFINITIONS = [
           type: "boolean",
           description: "If true, this memory is shared across all repositories"
         },
-        ttlDays: { type: "number", minimum: 1 },
+        ttlDays: {
+          type: "number",
+          minimum: 1,
+          description: "Time-to-live in days. After this period, the memory expires."
+        },
         supersedes: {
           type: "string",
           description: "Optional memory ID (UUID) or memory code to supersede. Resolved before storing."
@@ -4201,29 +4221,34 @@ var TOOL_DEFINITIONS = [
           items: {
             type: "object",
             properties: {
-              type: { type: "string", enum: ["code_fact", "decision", "mistake", "pattern", "task_archive"] },
-              title: { type: "string", minLength: 3, maxLength: 100 },
-              content: { type: "string", minLength: 10 },
-              importance: { type: "number", minimum: 1, maximum: 5 },
-              agent: { type: "string" },
-              role: { type: "string", default: "unknown" },
-              model: { type: "string" },
+              type: {
+                type: "string",
+                enum: ["code_fact", "decision", "mistake", "pattern", "task_archive"],
+                description: "Type of durable knowledge being stored"
+              },
+              title: { type: "string", minLength: 3, maxLength: 100, description: "Short human-readable title" },
+              content: { type: "string", minLength: 10, description: "The memory content" },
+              importance: { type: "number", minimum: 1, maximum: 5, description: "Importance score (1-5)" },
+              agent: { type: "string", description: "Name of the agent creating this memory" },
+              role: { type: "string", default: "unknown", description: "Role of the agent creating this memory" },
+              model: { type: "string", description: "AI model used by the agent" },
               scope: {
                 type: "object",
                 properties: {
-                  repo: { type: "string" },
-                  branch: { type: "string" },
-                  folder: { type: "string" },
-                  language: { type: "string" }
+                  owner: { type: "string", description: "Organization/namespace (e.g., GitHub org or username)" },
+                  repo: { type: "string", description: "Repository/project name" },
+                  branch: { type: "string", description: "Git branch this memory relates to" },
+                  folder: { type: "string", description: "Subdirectory within the repo" },
+                  language: { type: "string", description: "Programming language" }
                 },
-                required: ["repo"]
+                required: ["owner", "repo"]
               },
-              code: { type: "string" },
-              ttlDays: { type: "number", minimum: 1 },
-              supersedes: { type: "string" },
-              tags: { type: "array", items: { type: "string" } },
-              metadata: { type: "object" },
-              is_global: { type: "boolean", default: false }
+              code: { type: "string", description: "Optional custom code. Auto-generated if omitted." },
+              ttlDays: { type: "number", minimum: 1, description: "Time-to-live in days" },
+              supersedes: { type: "string", description: "UUID or code of a memory this entry replaces" },
+              tags: { type: "array", items: { type: "string" }, description: "Technology stack tags" },
+              metadata: { type: "object", description: "Structured metadata for non-title context" },
+              is_global: { type: "boolean", default: false, description: "If true, shared across all repositories" }
             },
             required: ["type", "title", "content", "importance", "agent", "model", "scope"]
           },
@@ -4345,9 +4370,14 @@ var TOOL_DEFINITIONS = [
     inputSchema: {
       type: "object",
       properties: {
-        query: { type: "string", minLength: 3 },
-        prompt: { type: "string" },
-        repo: { type: "string" },
+        query: {
+          type: "string",
+          minLength: 3,
+          description: "Search keyword to match against memory titles and content"
+        },
+        prompt: { type: "string", description: "Natural language prompt for semantic search" },
+        owner: { type: "string", description: "Organization/namespace (e.g., GitHub org or username)" },
+        repo: { type: "string", description: "Repository/project name" },
         current_tags: {
           type: "array",
           items: { type: "string" },
@@ -4358,21 +4388,27 @@ var TOOL_DEFINITIONS = [
           items: {
             type: "string",
             enum: ["code_fact", "decision", "mistake", "pattern", "task_archive"]
-          }
+          },
+          description: "Filter by memory type(s)"
         },
-        minImportance: { type: "number", minimum: 1, maximum: 5 },
+        minImportance: { type: "number", minimum: 1, maximum: 5, description: "Minimum importance threshold (1-5)" },
         limit: { type: "number", minimum: 1, maximum: 100, default: 5 },
         offset: { type: "number", minimum: 0, default: 0 },
         includeRecap: { type: "boolean", default: false },
-        current_file_path: { type: "string" },
-        include_archived: { type: "boolean", default: false },
+        current_file_path: { type: "string", description: "Absolute file path for workspace-local grounding" },
+        include_archived: {
+          type: "boolean",
+          default: false,
+          description: "Include archived/expired memories in results"
+        },
         scope: {
           type: "object",
           properties: {
-            repo: { type: "string" },
-            branch: { type: "string" },
-            folder: { type: "string" },
-            language: { type: "string" }
+            owner: { type: "string", description: "Organization/namespace (e.g., GitHub org or username)" },
+            repo: { type: "string", description: "Repository/project name" },
+            branch: { type: "string", description: "Git branch filter" },
+            folder: { type: "string", description: "Subdirectory filter" },
+            language: { type: "string", description: "Programming language filter" }
           }
         },
         structured: {
@@ -4381,7 +4417,7 @@ var TOOL_DEFINITIONS = [
           description: "If true, returns structured JSON without the text content summary."
         }
       },
-      required: ["query", "repo"]
+      required: ["owner", "query", "repo"]
     },
     outputSchema: {
       type: "object",
@@ -4424,7 +4460,8 @@ var TOOL_DEFINITIONS = [
     inputSchema: {
       type: "object",
       properties: {
-        repo: { type: "string", description: "Repository name" },
+        owner: { type: "string", description: "Organization/namespace (e.g., GitHub org or username)" },
+        repo: { type: "string", description: "Repository/project name" },
         signals: {
           type: "array",
           items: { type: "string", maxLength: 200 },
@@ -4433,7 +4470,7 @@ var TOOL_DEFINITIONS = [
         },
         structured: { type: "boolean", default: false, description: "If true, returns structured JSON of the summary." }
       },
-      required: ["repo", "signals"]
+      required: ["owner", "repo", "signals"]
     },
     outputSchema: {
       type: "object",
@@ -4552,7 +4589,8 @@ var TOOL_DEFINITIONS = [
     inputSchema: {
       type: "object",
       properties: {
-        repo: { type: "string", description: "Repository name (required)" },
+        owner: { type: "string", description: "Organization/namespace (e.g., GitHub org or username)" },
+        repo: { type: "string", description: "Repository/project name (required)" },
         limit: {
           type: "number",
           minimum: 1,
@@ -4572,7 +4610,7 @@ var TOOL_DEFINITIONS = [
           description: "If true, returns structured JSON without the text content summary."
         }
       },
-      required: ["repo"]
+      required: ["owner", "repo"]
     },
     outputSchema: {
       type: "object",
@@ -4625,7 +4663,8 @@ var TOOL_DEFINITIONS = [
     inputSchema: {
       type: "object",
       properties: {
-        repo: { type: "string", description: "Repository name" },
+        owner: { type: "string", description: "Organization/namespace (e.g., GitHub org or username)" },
+        repo: { type: "string", description: "Repository/project name" },
         task_code: { type: "string", description: "Unique task code (e.g. TASK-001) (Required for single task)" },
         phase: { type: "string", description: "Project phase (Required for single task)" },
         title: {
@@ -4651,11 +4690,11 @@ var TOOL_DEFINITIONS = [
           default: 3,
           description: "Task priority where 1=Low, 2=Normal, 3=Medium, 4=High, 5=Critical."
         },
-        agent: { type: "string" },
-        role: { type: "string" },
-        doc_path: { type: "string" },
-        tags: { type: "array", items: { type: "string" } },
-        metadata: { type: "object" },
+        agent: { type: "string", description: "Agent assigned to this task" },
+        role: { type: "string", description: "Role of the assigned agent" },
+        doc_path: { type: "string", description: "Path to related documentation file" },
+        tags: { type: "array", items: { type: "string" }, description: "Tags for categorization" },
+        metadata: { type: "object", description: "Structured metadata for additional context" },
         parent_id: {
           type: "string",
           description: "Optional parent task ID (UUID) or parent task code (e.g. TASK-001). Resolved to UUID before storing."
@@ -4670,14 +4709,14 @@ var TOOL_DEFINITIONS = [
           items: {
             type: "object",
             properties: {
-              task_code: { type: "string" },
-              phase: { type: "string" },
-              title: { type: "string", minLength: 3, maxLength: 100 },
+              task_code: { type: "string", description: "Unique task code (e.g. TASK-001)" },
+              phase: { type: "string", description: "Project phase" },
+              title: { type: "string", minLength: 3, maxLength: 100, description: "Task objective" },
               description: {
                 type: "string",
                 description: "Detailed description. MUST follow format: 1. Context & Analysis, 2. Step & Implementation, 3. Acceptance & Verification"
               },
-              status: { type: "string", enum: ["backlog", "pending"], default: "backlog" },
+              status: { type: "string", enum: ["backlog", "pending"], default: "backlog", description: "Task status" },
               priority: {
                 type: "number",
                 minimum: 1,
@@ -4685,11 +4724,11 @@ var TOOL_DEFINITIONS = [
                 default: 3,
                 description: "Task priority where 1=Low, 2=Normal, 3=Medium, 4=High, 5=Critical."
               },
-              agent: { type: "string" },
-              role: { type: "string" },
-              doc_path: { type: "string" },
-              tags: { type: "array", items: { type: "string" } },
-              metadata: { type: "object" },
+              agent: { type: "string", description: "Agent assigned to this task" },
+              role: { type: "string", description: "Role of the assigned agent" },
+              doc_path: { type: "string", description: "Path to related documentation file" },
+              tags: { type: "array", items: { type: "string" }, description: "Tags for categorization" },
+              metadata: { type: "object", description: "Structured metadata for additional context" },
               parent_id: {
                 type: "string",
                 description: "Optional parent task ID (UUID) or parent task code (e.g. TASK-001). Resolved to UUID before storing."
@@ -4706,7 +4745,7 @@ var TOOL_DEFINITIONS = [
         },
         structured: { type: "boolean", default: false, description: "If true, returns structured JSON result." }
       },
-      required: ["repo"]
+      required: ["owner", "repo"]
     },
     outputSchema: {
       type: "object",
@@ -4866,9 +4905,10 @@ var TOOL_DEFINITIONS = [
     inputSchema: {
       type: "object",
       properties: {
+        owner: { type: "string", description: "Organization/namespace (e.g., GitHub org or username)" },
         repo: {
           type: "string",
-          description: "Repository name (required)"
+          description: "Repository/project name (required)"
         },
         status: {
           type: "string",
@@ -4902,7 +4942,7 @@ var TOOL_DEFINITIONS = [
           description: "If true, returns structured JSON without the text content summary."
         }
       },
-      required: ["repo"]
+      required: ["owner", "repo"]
     },
     outputSchema: {
       type: "object",
@@ -4942,7 +4982,8 @@ var TOOL_DEFINITIONS = [
     inputSchema: {
       type: "object",
       properties: {
-        repo: { type: "string", description: "Repository name" },
+        owner: { type: "string", description: "Organization/namespace (e.g., GitHub org or username)" },
+        repo: { type: "string", description: "Repository/project name" },
         query: {
           type: "string",
           minLength: 1,
@@ -4955,7 +4996,7 @@ var TOOL_DEFINITIONS = [
         offset: { type: "number", minimum: 0, default: 0 },
         structured: { type: "boolean", default: false, description: "If true, returns structured JSON result." }
       },
-      required: ["repo", "query"]
+      required: ["owner", "repo", "query"]
     },
     outputSchema: {
       type: "object",
@@ -4999,7 +5040,8 @@ var TOOL_DEFINITIONS = [
     inputSchema: {
       type: "object",
       properties: {
-        repo: { type: "string", description: "Repository name" },
+        owner: { type: "string", description: "Organization/namespace (e.g., GitHub org or username)" },
+        repo: { type: "string", description: "Repository/project name" },
         from_agent: { type: "string", description: "Agent creating the handoff" },
         to_agent: { type: "string", description: "Optional target agent" },
         task_id: { type: "string", format: "uuid", description: "Optional task id to associate" },
@@ -5012,7 +5054,7 @@ var TOOL_DEFINITIONS = [
         expires_at: { type: "string", description: "Optional expiration timestamp" },
         structured: { type: "boolean", default: false }
       },
-      required: ["repo", "from_agent", "summary"]
+      required: ["owner", "repo", "from_agent", "summary"]
     },
     outputSchema: {
       type: "object",
@@ -5073,7 +5115,8 @@ var TOOL_DEFINITIONS = [
     inputSchema: {
       type: "object",
       properties: {
-        repo: { type: "string", description: "Repository name" },
+        owner: { type: "string", description: "Organization/namespace (e.g., GitHub org or username)" },
+        repo: { type: "string", description: "Repository/project name" },
         status: { type: "string", enum: ["pending", "accepted", "rejected", "expired"] },
         from_agent: { type: "string" },
         to_agent: { type: "string" },
@@ -5081,7 +5124,7 @@ var TOOL_DEFINITIONS = [
         offset: { type: "number", minimum: 0, default: 0 },
         structured: { type: "boolean", default: false }
       },
-      required: ["repo"]
+      required: ["owner", "repo"]
     },
     outputSchema: {
       type: "object",
@@ -5122,7 +5165,8 @@ var TOOL_DEFINITIONS = [
     inputSchema: {
       type: "object",
       properties: {
-        repo: { type: "string", description: "Repository name" },
+        owner: { type: "string", description: "Organization/namespace (e.g., GitHub org or username)" },
+        repo: { type: "string", description: "Repository/project name" },
         task_id: {
           type: "string",
           format: "uuid",
@@ -5134,7 +5178,7 @@ var TOOL_DEFINITIONS = [
         metadata: { type: "object", description: "Optional claim metadata" },
         structured: { type: "boolean", default: false }
       },
-      required: ["repo", "agent"]
+      required: ["owner", "repo", "agent"]
     },
     outputSchema: {
       type: "object",
@@ -5165,14 +5209,15 @@ var TOOL_DEFINITIONS = [
     inputSchema: {
       type: "object",
       properties: {
-        repo: { type: "string", description: "Repository name" },
+        owner: { type: "string", description: "Organization/namespace (e.g., GitHub org or username)" },
+        repo: { type: "string", description: "Repository/project name" },
         agent: { type: "string", description: "Optional agent filter" },
         active_only: { type: "boolean", description: "When true, return only unreleased claims" },
         limit: { type: "number", minimum: 1, maximum: 100, default: 20 },
         offset: { type: "number", minimum: 0, default: 0 },
         structured: { type: "boolean", default: false }
       },
-      required: ["repo"]
+      required: ["owner", "repo"]
     },
     outputSchema: {
       type: "object",
@@ -5950,12 +5995,14 @@ async function getPrompt(name, args = {}, db, session) {
     throw new Error(`Prompt not found: ${name}`);
   }
   const inferredRepo = inferRepoFromSession(session);
+  const inferredOwner = inferOwnerFromSession(session);
   const messages = prompt.messages.map((m) => {
     let text = m.content.text;
     for (const [key, value] of Object.entries(args)) {
       text = text.replace(new RegExp(`\\{{${key}\\}}`, "g"), value);
     }
     text = text.replace(/{{current_repo}}/g, inferredRepo || "unknown-repo");
+    text = text.replace(/{{current_owner}}/g, inferredOwner || "unknown-owner");
     return {
       ...m,
       content: {
@@ -6397,6 +6444,7 @@ export {
   addLogSink,
   LOG_LEVEL_VALUES,
   createFileSink,
+  parseRepoInput,
   normalizeRepo,
   SQLiteStore,
   RealVectorStore,
@@ -6436,6 +6484,7 @@ export {
   isPathWithinRoots,
   findContainingRoot,
   inferRepoFromSession,
+  inferOwnerFromSession,
   PROMPTS,
   listPrompts,
   getPrompt,

package/dist/dashboard/server.js

@@ -16,7 +16,7 @@ import {
   handleTaskClaim,
   listResources,
   logger
-} from "../chunk-SITVJ6EA.js";
+} from "../chunk-YVPDPZXG.js";
 
 // src/dashboard/server.ts
 import express from "express";

package/dist/mcp/server.js

@@ -48,6 +48,7 @@ import {
   handleHandoffList,
   handleHandoffUpdate,
   handleTaskClaim,
+  inferOwnerFromSession,
   inferRepoFromSession,
   isPathWithinRoots,
   listPrompts,
@@ -55,12 +56,13 @@ import {
   listResources,
   logger,
   normalizeRepo,
+  parseRepoInput,
   readResource,
   setLogLevel,
   toContextSlug,
   updateSessionFromInitialize,
   updateSessionRoots
-} from "../chunk-SITVJ6EA.js";
+} from "../chunk-YVPDPZXG.js";
 
 // src/mcp/server.ts
 import readline from "readline";
@@ -2804,6 +2806,29 @@ function normalizeToolArguments(args, session2) {
   if (scope && !scope.repo) {
     scope.repo = nextArgs.repo ?? inferRepoFromSession(session2);
   }
+  if (!nextArgs.owner) {
+    const repoVal2 = nextArgs.repo || "";
+    const parsed = parseRepoInput(repoVal2, void 0);
+    nextArgs.owner = parsed.owner || inferOwnerFromSession(session2) || "";
+  }
+  if (scope && !scope.owner) {
+    const repoVal2 = scope.repo || nextArgs.repo || "";
+    const parsed = parseRepoInput(repoVal2, void 0);
+    scope.owner = parsed.owner || nextArgs.owner || inferOwnerFromSession(session2) || "";
+  }
+  const ownerVal = nextArgs.owner || inferOwnerFromSession(session2) || "";
+  const repoVal = nextArgs.repo || inferRepoFromSession(session2) || "";
+  const memories = nextArgs.memories;
+  if (memories) {
+    for (const mem of memories) {
+      const memScope = mem.scope;
+      if (memScope) {
+        if (!memScope.owner)
+          memScope.owner = ownerVal || parseRepoInput(memScope.repo || repoVal, void 0).owner || "";
+        if (!memScope.repo) memScope.repo = repoVal;
+      }
+    }
+  }
   if (typeof nextArgs.current_file_path === "string" && scope) {
     const containingRoot = path2.isAbsolute(nextArgs.current_file_path) ? findContainingRoot(nextArgs.current_file_path, session2) : null;
     if (containingRoot) {

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

@@ -65,4 +65,4 @@ If you refuse, return exactly:
 }
 ```
 
-Path: {{path}} Repo: {{current_repo}}
+Path: {{path}} Owner: {{current_owner}} Repo: {{current_repo}}

package/dist/prompts/csl-scrapper.md

@@ -70,4 +70,4 @@ If you refuse, return exactly:
 }
 ```
 
-Source: {{source_url}} Repo: {{current_repo}}
+Source: {{source_url}} Owner: {{current_owner}} Repo: {{current_repo}}

package/dist/prompts/server/instructions.md

@@ -5,6 +5,15 @@ description: Main instructions for the MCP server
 
 Local Memory MCP — persistent memory, task coordination, and coding standards for AI agents.
 
+## Data Scoping
+
+All data (memories, tasks, handoffs, claims) is scoped by **owner/repo**:
+
+- **owner** = organization/namespace (e.g., GitHub org, username)
+- **repo** = project/repository name
+
+Pass both `owner` and `repo` whenever a tool requires them. The `owner/repo` pair forms the unique data boundary.
+
 ## Session Start Mode
 
 Entry=orient → hydrate → ready Guard: S(N) req S(N-1)✅

package/package.json

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