@plur-ai/mcp 0.9.10 → 0.9.12

package/dist/index.js

@@ -5,7 +5,7 @@ import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, statSy
 import { join } from "path";
 import { fileURLToPath } from "url";
 import { homedir, platform } from "os";
-var VERSION = "0.9.10";
+var VERSION = "0.9.12";
 var HELP = `plur-mcp v${VERSION} \u2014 persistent memory for AI agents
 
 Usage:
@@ -279,7 +279,7 @@ if (arg === "init") {
   process.exit(0);
 }
 if (arg === "serve" || arg === void 0) {
-  const { runStdio } = await import("./server-GRHXPO6E.js");
+  const { runStdio } = await import("./server-AZFA22VU.js");
   runStdio().catch((err) => {
     console.error("Failed to start PLUR MCP server:", err);
     process.exit(1);

package/dist/{server-GRHXPO6E.js → server-AZFA22VU.js}

@@ -14,10 +14,13 @@ import {
 import { Plur as Plur2, checkForUpdate } from "@plur-ai/core";
 
 // src/tools.ts
-import { extractMetaEngrams, validateMetaEngram, confidenceBand, generateProfile, getProfileForInjection, selectModelForOperation, getCachedUpdateCheck, minorVersionsBehind, scanForTensions, CapabilityCanary } from "@plur-ai/core";
+import { existsSync, unlinkSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+import { extractMetaEngrams, validateMetaEngram, confidenceBand, generateProfile, getProfileForInjection, selectModelForOperation, getCachedUpdateCheck, minorVersionsBehind, scanForTensions, CapabilityCanary, readProjectConfig } from "@plur-ai/core";
 
 // src/version.ts
-var VERSION = "0.9.10";
+var VERSION = "0.9.12";
 
 // src/tools.ts
 function makeHttpLlm(baseUrl, apiKey, model = "gpt-4o-mini") {
@@ -406,7 +409,7 @@ function getToolDefinitions() {
         }
         if (!args.id) throw new Error("Provide id (or list:true to list pinned)");
         const target = args.pinned ?? true;
-        const updated = plur.setPinned(args.id, target);
+        const updated = await plur.setPinnedAsync(args.id, target);
         if (!updated) throw new Error(`Engram not found: ${args.id}`);
         return {
           id: updated.id,
@@ -970,7 +973,8 @@ function getToolDefinitions() {
         type: "object",
         properties: {
           task: { type: "string", description: "What you are working on (triggers engram injection)" },
-          tags: { type: "array", items: { type: "string" }, description: "Tags to filter injected engrams" }
+          tags: { type: "array", items: { type: "string" }, description: "Tags to filter injected engrams" },
+          default_scope: { type: "string", description: "Default scope for plur_learn calls this session when no explicit scope is provided. Only set this if you want ALL engrams to route to a specific store. Usually, leave unset and pass scope per-engram based on relevance." }
         },
         required: ["task"]
       },
@@ -986,12 +990,20 @@ function getToolDefinitions() {
           outbox_result = await plur.flushOutbox();
         } catch {
         }
+        const remote_scopes = plur.getWritableRemoteScopes();
+        const projectConfig = readProjectConfig();
+        const explicit_default_scope = args.default_scope ?? null;
+        const default_scope = explicit_default_scope ?? projectConfig.scope ?? null;
+        const scope_source = explicit_default_scope ? "caller" : projectConfig.scope ? "project-config" : "none";
+        plur.setSessionScope(default_scope);
         const status = plur.status();
         const store_stats = {
           engram_count: status.engram_count,
           episode_count: status.episode_count,
           pack_count: status.pack_count
         };
+        await plur.warmRemoteCaches().catch(() => {
+        });
         let engrams = null;
         try {
           const result = await plur.injectHybrid(task, {
@@ -1040,11 +1052,31 @@ ${guide}`;
             version_warning = `Update available: PLUR v${versionCheck.current} \u2192 v${versionCheck.latest}. Run: npx @plur-ai/mcp@latest`;
           }
         }
+        if (scope_source === "project-config") {
+          guide += `
+
+Auto-detected project scope: "${default_scope}" (from .plur.yaml in the current project). plur_learn calls without an explicit scope will be tagged with this scope, keeping this project's knowledge separate from your other projects. Pass scope: "global" only for genuinely cross-project knowledge (general coding conventions, language gotchas, tool quirks).`;
+        } else if (scope_source === "none") {
+          guide += `
+
+\u26A0\uFE0F No project scope detected. plur_learn calls without explicit scope will be tagged "global" and will appear in EVERY project's future sessions. To avoid context bleed across projects, create a .plur.yaml in this project's root with: scope: "project:<your-project-name>"`;
+        }
+        if (remote_scopes.length > 0) {
+          const scopeList = remote_scopes.map((s) => `"${s.scope}"`).join(", ");
+          guide += default_scope ? `
+
+Session default scope is set to "${default_scope}". To route an engram to a remote enterprise store instead, pass scope explicitly to plur_learn (available remote scopes: ${scopeList}).` : `
+
+Remote store scopes available: ${scopeList}. When an engram is relevant to the team (engineering patterns, architecture decisions, project conventions), set scope to the matching remote scope in plur_learn. Personal preferences, local project details, and corrections specific to your workflow should stay at default scope (local).`;
+        }
         return {
           session_id,
           engrams: engrams ?? [],
           store_stats,
           guide,
+          // Remote scope routing info (#229)
+          ...remote_scopes.length > 0 ? { remote_scopes } : {},
+          ...default_scope ? { default_scope, scope_source } : {},
           // Ask LLM to check back — MCP can't push, but we can request a follow-up
           follow_up: store_stats.engram_count === 0 ? "This is a fresh store with 0 engrams. After your first exchange with the user, review what you learned and call plur_learn for any corrections, preferences, or patterns. Build the memory from this session." : void 0,
           // On fresh install, suggest hook setup for reliable injection
@@ -1082,14 +1114,21 @@ Include at least one engram_suggestion if ANYTHING was learned. An empty suggest
           engram_suggestions: {
             type: "array",
             items: {
-              type: "object",
-              properties: {
-                statement: { type: "string", description: "A concise, reusable assertion. Write it as advice to your future self." },
-                type: { type: "string", enum: ["behavioral", "terminological", "procedural", "architectural"] }
-              },
-              required: ["statement"]
+              // Prefer {statement, type} objects. Bare strings are tolerated
+              // and treated as {statement: <string>} (issue #231).
+              anyOf: [
+                { type: "string" },
+                {
+                  type: "object",
+                  properties: {
+                    statement: { type: "string", description: "A concise, reusable assertion. Write it as advice to your future self." },
+                    type: { type: "string", enum: ["behavioral", "terminological", "procedural", "architectural"] }
+                  },
+                  required: ["statement"]
+                }
+              ]
             },
-            description: "Learnings from this session. Review the conversation for corrections, preferences, patterns, and technical facts before calling."
+            description: 'Learnings from this session. Preferred shape is {statement: "...", type?: "..."}; bare strings are also accepted and treated as the statement. Review the conversation for corrections, preferences, patterns, and technical facts before calling.'
           }
         },
         required: ["summary", "engram_suggestions"]
@@ -1099,9 +1138,23 @@ Include at least one engram_suggestion if ANYTHING was learned. An empty suggest
         const session_id = args.session_id;
         const suggestions = args.engram_suggestions;
         let engrams_created = 0;
-        if (suggestions?.length) {
-          for (const s of suggestions) {
-            plur.learn(s.statement, { type: s.type });
+        if (Array.isArray(suggestions) && suggestions.length) {
+          for (let i = 0; i < suggestions.length; i++) {
+            const s = suggestions[i];
+            let statement;
+            let type;
+            if (typeof s === "string") {
+              statement = s;
+            } else if (s && typeof s === "object") {
+              statement = s.statement;
+              type = s.type;
+            }
+            if (typeof statement !== "string" || statement.length === 0) {
+              throw new Error(
+                `engram_suggestions[${i}] must be a string or {statement: string, type?: string}, got ${typeof s}`
+              );
+            }
+            plur.learn(statement, { type });
             engrams_created++;
           }
         }
@@ -1109,6 +1162,19 @@ Include at least one engram_suggestion if ANYTHING was learned. An empty suggest
           session_id,
           channel: "mcp"
         });
+        try {
+          const plurDir = process.env.PLUR_PATH ?? join(homedir(), ".plur");
+          const sessionsDir = join(plurDir, "sessions");
+          const keys = [session_id, process.env.CLAUDE_SESSION_ID, String(process.ppid)].filter(Boolean).map((k) => k.replace(/[^a-zA-Z0-9_-]/g, "").slice(0, 64));
+          for (const key of keys) {
+            const cp = join(sessionsDir, `${key}.checkpoint.json`);
+            if (existsSync(cp)) {
+              unlinkSync(cp);
+              break;
+            }
+          }
+        } catch {
+        }
         const status = plur.status();
         return {
           engrams_created,
@@ -1160,7 +1226,7 @@ Include at least one engram_suggestion if ANYTHING was learned. An empty suggest
       annotations: { title: "List stores", readOnlyHint: true, idempotentHint: true },
       inputSchema: { type: "object", properties: {} },
       handler: async (_args, plur) => {
-        const stores = plur.listStores();
+        const stores = await plur.listStoresAsync();
         const outboxCount = plur.outboxCount();
         return {
           stores,
@@ -1430,9 +1496,9 @@ Include at least one engram_suggestion if ANYTHING was learned. An empty suggest
         if (filterType) {
           engrams = engrams.filter((e) => e.type === filterType);
         }
-        const { homedir } = await import("os");
-        const { join } = await import("path");
-        const outputDir = args.output_dir || join(homedir(), "plur-packs", name);
+        const { homedir: homedir2 } = await import("os");
+        const { join: join2 } = await import("path");
+        const outputDir = args.output_dir || join2(homedir2(), "plur-packs", name);
         const result = plur.exportPack(engrams, outputDir, {
           name,
           version: "1.0.0",
@@ -1641,6 +1707,31 @@ Use \`scope\` to namespace engrams per project:
 
 Override with \`PLUR_PATH\` environment variable.
 `;
+function jsonSchemaPropToZod(prop) {
+  if (!prop || typeof prop !== "object") return z.unknown();
+  const variants = prop.anyOf ?? prop.oneOf;
+  if (Array.isArray(variants) && variants.length > 0) {
+    const zodVariants = variants.map(jsonSchemaPropToZod);
+    if (zodVariants.length === 1) return zodVariants[0];
+    return z.union(zodVariants);
+  }
+  if (prop.type === "string") return prop.enum ? z.enum(prop.enum) : z.string();
+  if (prop.type === "number" || prop.type === "integer") return z.number();
+  if (prop.type === "boolean") return z.boolean();
+  if (prop.type === "array") {
+    const itemSchema = prop.items ? jsonSchemaPropToZod(prop.items) : z.unknown();
+    return z.array(itemSchema);
+  }
+  if (prop.type === "object" && prop.properties) {
+    const shape = {};
+    for (const [k, p] of Object.entries(prop.properties)) {
+      const field = jsonSchemaPropToZod(p);
+      shape[k] = prop.required?.includes(k) ? field : field.optional();
+    }
+    return z.object(shape).passthrough();
+  }
+  return z.unknown();
+}
 async function createServer(plur) {
   const instance = plur ?? new Plur2();
   const tools = getToolDefinitions();
@@ -1683,12 +1774,7 @@ async function createServer(plur) {
       if (schema?.properties) {
         const shape = {};
         for (const [key, prop] of Object.entries(schema.properties)) {
-          let field;
-          if (prop.type === "string") field = prop.enum ? z.enum(prop.enum) : z.string();
-          else if (prop.type === "number") field = z.number();
-          else if (prop.type === "boolean") field = z.boolean();
-          else if (prop.type === "array") field = z.array(z.unknown());
-          else field = z.unknown();
+          const field = jsonSchemaPropToZod(prop);
           shape[key] = schema.required?.includes(key) ? field : field.optional();
         }
         const parsed = z.object(shape).passthrough().safeParse(args);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plur-ai/mcp",
-  "version": "0.9.10",
+  "version": "0.9.12",
   "type": "module",
   "bin": {
     "plur-mcp": "dist/index.js"
@@ -13,7 +13,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",
     "zod": "^3.23.0",
-    "@plur-ai/core": "0.9.10"
+    "@plur-ai/core": "0.9.12"
   },
   "devDependencies": {
     "@types/node": "^25.5.0"