@plur-ai/mcp 0.9.11 → 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.11";
+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-FHZHOMM5.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-FHZHOMM5.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.11";
+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
@@ -1130,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,
@@ -1451,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",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plur-ai/mcp",
-  "version": "0.9.11",
+  "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.11"
+    "@plur-ai/core": "0.9.12"
   },
   "devDependencies": {
     "@types/node": "^25.5.0"