devsmind-mcp 3.0.0 → 4.0.1

package/dist/cli/integrations/memory.js

@@ -1,250 +1,68 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleMemory = handleMemory;
-const path = __importStar(require("path"));
-const config_1 = require("../../utils/config");
 const registry_1 = require("./registry");
 const memory_topics_1 = require("./memory-topics");
 const prompt_1 = require("./prompt");
-const MEMORY_FILE_HEADER = '<!-- Seeded by `devsmind memory` — the DevsMind team code-graph MCP server -->\n\n';
 /**
- * `devsmind memory` — seed a tool's own persistent agent-memory/skills store
- * (distinct from `devsmind rule`'s static rule file) with the workflow contract
- * carried by the MCP `instructions` field, for the handful of tools confirmed to
- * actually read back a file they didn't create themselves. For every other tool
- * this prints honest guidance instead of writing a file that might silently do
- * nothing (or get overwritten by the tool's own background job).
+ * `devsmind memory` — prints ONE natural-language block to paste into any AI chat, framed as an
+ * explicit "remember this" request. DevsMind writes nothing on your behalf.
+ *
+ * Why: research across all 9 tools DevsMind integrates with turned up the same finding stated
+ * independently in several of those tools' own docs — background/automatic memory is
+ * discretionary by design (Windsurf, Codex, and Qwen say so outright; e.g. "auto-memory is
+ * best-effort, QWEN.md is guaranteed"), while an EXPLICIT in-chat request is the one thing that
+ * reliably lands. A silently-written file never crosses that trigger at all. And 5 of the 9 tools
+ * (Cursor, VS Code/Copilot, Windsurf, Kiro, Qwen) have no file DevsMind could safely write to in
+ * the first place — hand-writing into an undocumented or auto-generated store risks corrupting
+ * it. So instead of maintaining 9 different internal file formats, this hands the user one prompt
+ * and lets each tool's own native memory feature do whatever it already does best with it.
  *
- * The contract is seeded as one file per fact where the store loads files on
- * demand (Claude Code), and as one combined document where it doesn't
- * (Antigravity Skills) — see memory-topics.ts for why.
+ * `--tool` only changes the framing line (which feature name to call out, e.g. "Cursor calls
+ * this Memories") — the prompt itself, from `renderMemoryPrompt`, is the same for everyone.
  */
 async function handleMemory(opts) {
-    const devmindDir = (0, config_1.resolveDevmindDir)(opts.path);
-    const workspaceRoot = devmindDir ? path.dirname(devmindDir) : process.cwd();
-    // Piped/redirected output or an explicit --print: print what WOULD be written and stop, the
-    // same escape hatch `devsmind rule --print` has. Without it there was no way to read the
-    // seeded contract, diff it against what's already in a store, or produce it from a script —
-    // the content existed but the only route to it was a series of interactive prompts.
-    if (opts.print || !process.stdin.isTTY || !process.stdout.isTTY) {
-        printNonInteractive(opts.tool, workspaceRoot);
-        return;
-    }
-    try {
-        const target = await (0, prompt_1.pickTarget)();
-        const mem = target.memory;
-        if (!mem.supported) {
-            const divider = '─'.repeat(70);
-            console.log(`\n${divider}`);
-            console.log(` ${target.label} — ${mem.featureName}`);
-            console.log(`${divider}\n`);
-            console.log(`⚠️  Nothing written — there's no safe way to pre-seed this.\n`);
-            console.log(mem.note);
-            console.log('');
-            return;
-        }
-        console.log(`\nℹ️  ${target.label} calls this "${mem.featureName}".`);
-        console.log(`   ${mem.note}`);
-        const mode = await (0, prompt_1.pickMode)();
-        const scope = await (0, prompt_1.pickMemoryScope)(target);
-        const docs = buildDocs(target, scope);
-        if (mode === 'manual') {
-            printManual(target.label, scope, workspaceRoot, docs, mem.pointerFile?.file);
-            return;
-        }
-        // Automatic mode.
-        const targetDir = await resolveMemoryDir(scope, target.label, workspaceRoot);
-        const merged = docs.map(doc => {
-            const filePath = path.join(targetDir, doc.file);
-            return { doc, filePath, ...(0, prompt_1.mergeRuleFile)(filePath, doc.content, 'standalone') };
-        });
-        console.log(`\n📝 Target: ${targetDir.replace(/\\/g, '/')}`);
-        if (merged.length === 1) {
-            console.log(`   ${merged[0].doc.file}  (${merged[0].existed ? 'overwrite our own file' : 'create new'})`);
-            console.log(`\nContent to be written:\n`);
-            console.log(indent(merged[0].content));
-        }
-        else {
-            const fresh = merged.filter(m => !m.existed).length;
-            console.log(`   ${merged.length} files — ${fresh} new, ${merged.length - fresh} overwritten (all DevsMind's own):\n`);
-            for (const m of merged) {
-                console.log(`   ${m.existed ? '↻' : '+'} ${m.doc.file}`);
-                if (m.doc.summary)
-                    console.log(`     ${m.doc.summary}`);
-            }
-        }
-        const indexLines = mem.pointerFile && docs.length > 1 ? memory_topics_1.MEMORY_TOPICS.map(memory_topics_1.renderIndexLine).join('\n') : null;
-        if (indexLines && mem.pointerFile) {
-            console.log(`\n   …plus an index block in ${mem.pointerFile.file} (that file is what loads every session — without it these are never found):\n`);
-            console.log(indent(indexLines));
-        }
-        const ok = await (0, prompt_1.confirmPrompt)('Write this?', true);
-        if (!ok) {
-            console.log('\nAborted — nothing written.');
-            return;
-        }
-        for (const m of merged)
-            (0, prompt_1.writeConfigFile)(m.filePath, m.content);
-        console.log(`\n✅ Seeded ${target.label}'s ${mem.featureName} — ` +
-            `${merged.length === 1 ? merged[0].filePath.replace(/\\/g, '/') : `${merged.length} files in ${targetDir.replace(/\\/g, '/')}`}`);
-        if (mem.pointerFile) {
-            const pointerPath = path.join(targetDir, mem.pointerFile.file);
-            const body = indexLines ?? singlePointerLine(docs[0].file);
-            const pointerConfirm = await (0, prompt_1.confirmPrompt)(`\nAlso write the ${indexLines ? 'index block' : 'pointer line'} into ${mem.pointerFile.file}, so this gets found ` +
-                `(it only loads "on demand" otherwise)?`, true);
-            if (pointerConfirm) {
-                const pointerMerged = (0, prompt_1.mergeRuleFile)(pointerPath, body, mem.pointerFile.style);
-                if (pointerMerged.error) {
-                    console.error(`❌ ${pointerMerged.error}`);
-                }
-                else {
-                    (0, prompt_1.writeConfigFile)(pointerPath, pointerMerged.content);
-                    console.log(`✅ ${indexLines ? 'Index' : 'Pointer'} written to ${pointerPath.replace(/\\/g, '/')}`);
-                }
-            }
-        }
-    }
-    catch (err) {
-        if (err instanceof prompt_1.CancelledError) {
-            console.log('\nCancelled.');
-            return;
-        }
-        throw err;
-    }
-}
-/** The tools that have a memory/skills store DevsMind can safely write to — the only valid `--tool` values. */
-function memoryCapableTargets() {
-    return registry_1.TARGETS.filter(t => t.memory.supported && (t.memory.scopes?.length ?? 0) > 0);
+    const target = await resolveTarget(opts);
+    if (!target)
+        return; // already reported: unknown --tool, or the interactive picker was cancelled
+    console.log(`\nℹ️  ${target.label} calls this "${target.memory.featureName}".`);
+    if (target.memory.note)
+        console.log(`   ${target.memory.note}`);
+    console.log(`\n📋 Paste this into your ${target.label} chat and ask it to remember it:\n`);
+    console.log(indent((0, memory_topics_1.renderMemoryPrompt)()));
+    console.log('');
 }
 /**
- * The `--print` / non-TTY path: resolve a target without prompting, then reuse the same manual
- * rendering the interactive flow already offers. Defaults to Claude Code's one-file-per-fact
- * shape rather than picking arbitrarily — it is the richest of the two (a store that ranks files
- * individually gets every topic separately), so it is the one worth seeing when you haven't said
- * which tool you mean. `--tool` prints exactly what that tool would receive instead.
+ * `--tool` resolves directly. Otherwise, an interactive TTY offers the same picker `devsmind
+ * rule`/`devsmind mcp` use (purely for the framing line — nothing here depends on the answer
+ * the way file placement used to); a non-interactive/piped run — or an explicit `--print` — falls
+ * back to Claude Code's framing and says so, so scripted use never blocks on a prompt.
  */
-function printNonInteractive(toolId, workspaceRoot) {
-    const capable = memoryCapableTargets();
-    const valid = capable.map(t => t.id).join(', ');
-    let target;
-    if (toolId) {
-        target = (0, registry_1.getTarget)(toolId);
+async function resolveTarget(opts) {
+    if (opts.tool) {
+        const target = (0, registry_1.getTarget)(opts.tool);
         if (!target) {
-            console.error(`❌ Unknown tool "${toolId}". Valid values for --tool: ${valid}`);
+            console.error(`❌ Unknown tool "${opts.tool}". Valid values for --tool: ${registry_1.TARGETS.map(t => t.id).join(', ')}`);
             process.exit(1);
-            return;
+            return undefined;
         }
-        if (!target.memory.supported || !target.memory.scopes?.length) {
-            console.error(`❌ ${target.label} has no memory store DevsMind can pre-seed.\n` +
-                `   ${target.memory.note}\n` +
-                `   Tools that do: ${valid}`);
-            process.exit(1);
-            return;
-        }
-    }
-    else {
-        target = capable.find(t => t.id === 'claude-code') ?? capable[0];
-        console.log(`ℹ️  No --tool given — showing the ${target.label} shape. Others: ${valid}\n`);
-    }
-    const scope = target.memory.scopes[0];
-    printManual(target.label, scope, workspaceRoot, buildDocs(target, scope), target.memory.pointerFile?.file);
-}
-/**
- * Turn the shared topics into the file shape this particular store reads:
- * one file per topic when it ranks files individually, one combined document
- * otherwise. The tool's own `wrap` (e.g. Skills frontmatter) applies only to the
- * combined shape — per-topic files carry their own frontmatter already.
- */
-function buildDocs(target, scope) {
-    if (scope.format === 'memory-files') {
-        return memory_topics_1.MEMORY_TOPICS.map(topic => ({
-            file: `${topic.name}.md`,
-            content: (0, memory_topics_1.renderTopicFile)(topic, MEMORY_FILE_HEADER),
-            summary: topic.description,
-        }));
-    }
-    const combined = (0, memory_topics_1.renderCombined)(MEMORY_FILE_HEADER);
-    const content = scope.format === 'skill-md' && target.memory.wrap ? target.memory.wrap(combined) : combined;
-    return [{ file: scope.file ?? 'devsmind.md', content }];
-}
-/** Fallback for a single-file store whose index still wants one line pointing at it. */
-function singlePointerLine(file) {
-    return `See \`${file}\` in this folder for the DevsMind workflow contract — \`start_session\` before your ` +
-        `first write (every write call requires that session_id; reads don't), \`search_nodes\` (query and/or a ` +
-        `real-regex \`pattern\`) before any grep, \`edit_node\` for every file you write, ` +
-        `\`commit_changes\` (with \`message\`, \`reasoning\`, and \`feedback\`) before the turn ends.`;
-}
-/** Resolve the directory to write into, prompting the user to navigate when the exact path isn't knowable. */
-async function resolveMemoryDir(scope, label, workspaceRoot) {
-    if (scope.needsUserConfirmedDir) {
-        const start = (0, registry_1.resolveOsPath)(scope.dir);
-        return (0, prompt_1.pickDirectory)(start, `Navigate to the correct folder for ${label} (e.g. .../projects/<your-project-hash>/memory)`);
-    }
-    if (scope.scope === 'project') {
-        const base = await (0, prompt_1.pickDirectory)(workspaceRoot, `Where is the project root for ${label}?`);
-        return path.join(base, (0, registry_1.resolveOsPath)(scope.dir));
-    }
-    return (0, registry_1.resolveScopeFile)(scope.dir, 'global', workspaceRoot);
-}
-function printManual(label, scope, workspaceRoot, docs, pointerFile) {
-    const divider = '─'.repeat(70);
-    const dirHint = scope.needsUserConfirmedDir
-        ? `${(0, registry_1.resolveOsPath)(scope.dir)}/<your-project-hash>/...`
-        : scope.scope === 'project'
-            ? path.join(workspaceRoot, (0, registry_1.resolveOsPath)(scope.dir)).replace(/\\/g, '/')
-            : (0, registry_1.resolveOsPath)(scope.dir);
-    const dir = String(dirHint).replace(/\\/g, '/');
-    console.log(`\n${divider}`);
-    console.log(` Seed DevsMind into ${label}`);
-    console.log(`${divider}`);
-    console.log(`\n1. Create ${docs.length === 1 ? 'this file' : `these ${docs.length} files`} under:`);
-    console.log(`   ${dir}/`);
-    for (const doc of docs) {
-        console.log(`\n${divider}`);
-        console.log(` ${dir}/${doc.file}`);
-        console.log(`${divider}\n`);
-        console.log(indent(doc.content));
+        return target;
     }
-    if (pointerFile) {
-        console.log(`\n${divider}`);
-        console.log(` 2. Add to ${dir}/${pointerFile} — without this they only load "on demand" and are never found:`);
-        console.log(`${divider}\n`);
-        console.log(indent(docs.length > 1 ? memory_topics_1.MEMORY_TOPICS.map(memory_topics_1.renderIndexLine).join('\n') : singlePointerLine(docs[0].file)));
-        console.log('');
+    if (!opts.print && process.stdin.isTTY && process.stdout.isTTY) {
+        try {
+            return await (0, prompt_1.pickTarget)();
+        }
+        catch (err) {
+            if (err instanceof prompt_1.CancelledError) {
+                console.log('\nCancelled.');
+                return undefined;
+            }
+            throw err;
+        }
     }
+    const fallback = (0, registry_1.getTarget)('claude-code');
+    console.log(`ℹ️  No --tool given — showing generic phrasing (the prompt itself is identical for every tool). Others: ${registry_1.TARGETS.map(t => t.id).join(', ')}`);
+    return fallback;
 }
 function indent(text) {
     return text.split('\n').map(l => '   ' + l).join('\n');

package/dist/cli/integrations/memory.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../src/cli/integrations/memory.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,oCAwGC;AA9ID,2CAA6B;AAC7B,+CAAuD;AACvD,yCAAyG;AACzG,mDAAkG;AAClG,qCASkB;AAElB,MAAM,kBAAkB,GAAG,oFAAoF,CAAC;AAWhH;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,YAAY,CAAC,IAAuD;IACxF,MAAM,UAAU,GAAG,IAAA,0BAAiB,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAE5E,4FAA4F;IAC5F,yFAAyF;IACzF,4FAA4F;IAC5F,oFAAoF;IACpF,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAChE,mBAAmB,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QAC9C,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAA,mBAAU,GAAE,CAAC;QAClC,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC;QAE1B,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YACrD,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,+DAA+D,CAAC,CAAC;YAC7E,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,KAAK,gBAAgB,GAAG,CAAC,WAAW,IAAI,CAAC,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAE9B,MAAM,IAAI,GAAG,MAAM,IAAA,iBAAQ,GAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,MAAM,IAAA,wBAAe,EAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAEtC,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YAC7E,OAAO;QACT,CAAC;QAED,kBAAkB;QAClB,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QAE7E,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YAChD,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,IAAA,sBAAa,EAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,CAAC;QAClF,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,gBAAgB,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC;YAC1G,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;YACpD,OAAO,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,YAAY,KAAK,SAAS,MAAM,CAAC,MAAM,GAAG,KAAK,sCAAsC,CAAC,CAAC;YACtH,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;gBACvB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;gBACzD,IAAI,CAAC,CAAC,GAAG,CAAC,OAAO;oBAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;QAED,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,6BAAa,CAAC,GAAG,CAAC,+BAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7G,IAAI,UAAU,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,gCAAgC,GAAG,CAAC,WAAW,CAAC,IAAI,gFAAgF,CAAC,CAAC;YAClJ,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,EAAE,GAAG,MAAM,IAAA,sBAAa,EAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QACpD,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;YAC5C,OAAO;QACT,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,MAAM;YAAE,IAAA,wBAAe,EAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CACT,cAAc,MAAM,CAAC,KAAK,MAAM,GAAG,CAAC,WAAW,KAAK;YACpD,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,aAAa,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,CACjI,CAAC;QAEF,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;YACpB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAC/D,MAAM,IAAI,GAAG,UAAU,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC3D,MAAM,cAAc,GAAG,MAAM,IAAA,sBAAa,EACxC,oBAAoB,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,cAAc,SAAS,GAAG,CAAC,WAAW,CAAC,IAAI,uBAAuB;gBACnH,wCAAwC,EACxC,IAAI,CACL,CAAC;YACF,IAAI,cAAc,EAAE,CAAC;gBACnB,MAAM,aAAa,GAAG,IAAA,sBAAa,EAAC,WAAW,EAAE,IAAI,EAAE,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;gBAC9E,IAAI,aAAa,CAAC,KAAK,EAAE,CAAC;oBACxB,OAAO,CAAC,KAAK,CAAC,KAAK,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC5C,CAAC;qBAAM,CAAC;oBACN,IAAA,wBAAe,EAAC,WAAW,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;oBACpD,OAAO,CAAC,GAAG,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,eAAe,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;gBACrG,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,uBAAc,EAAE,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAC5B,OAAO;QACT,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,+GAA+G;AAC/G,SAAS,oBAAoB;IAC3B,OAAO,kBAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACvF,CAAC;AAED;;;;;;GAMG;AACH,SAAS,mBAAmB,CAAC,MAA0B,EAAE,aAAqB;IAC5E,MAAM,OAAO,GAAG,oBAAoB,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEhD,IAAI,MAA6B,CAAC;IAClC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,GAAG,IAAA,oBAAS,EAAC,MAAM,CAAC,CAAC;QAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,CAAC,mBAAmB,MAAM,+BAA+B,KAAK,EAAE,CAAC,CAAC;YAC/E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;YAC9D,OAAO,CAAC,KAAK,CACX,KAAK,MAAM,CAAC,KAAK,+CAA+C;gBAChE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI;gBAC5B,qBAAqB,KAAK,EAAE,CAC7B,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,aAAa,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;QACjE,OAAO,CAAC,GAAG,CAAC,qCAAqC,MAAM,CAAC,KAAK,mBAAmB,KAAK,IAAI,CAAC,CAAC;IAC7F,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAO,CAAC,CAAC,CAAC,CAAC;IACvC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AAC7G,CAAC;AAED;;;;;GAKG;AACH,SAAS,SAAS,CAAC,MAAiB,EAAE,KAAkB;IACtD,IAAI,KAAK,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;QACpC,OAAO,6BAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACjC,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,KAAK;YACxB,OAAO,EAAE,IAAA,+BAAe,EAAC,KAAK,EAAE,kBAAkB,CAAC;YACnD,OAAO,EAAE,KAAK,CAAC,WAAW;SAC3B,CAAC,CAAC,CAAC;IACN,CAAC;IAED,MAAM,QAAQ,GAAG,IAAA,8BAAc,EAAC,kBAAkB,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,KAAK,UAAU,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC5G,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,wFAAwF;AACxF,SAAS,iBAAiB,CAAC,IAAY;IACrC,OAAO,SAAS,IAAI,uFAAuF;QACzG,yGAAyG;QACzG,mFAAmF;QACnF,8FAA8F,CAAC;AACnG,CAAC;AAED,8GAA8G;AAC9G,KAAK,UAAU,gBAAgB,CAAC,KAAkB,EAAE,KAAa,EAAE,aAAqB;IACtF,IAAI,KAAK,CAAC,qBAAqB,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,IAAA,wBAAa,EAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACvC,OAAO,IAAA,sBAAa,EAClB,KAAK,EACL,sCAAsC,KAAK,iDAAiD,CAC7F,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,MAAM,IAAA,sBAAa,EAAC,aAAa,EAAE,iCAAiC,KAAK,GAAG,CAAC,CAAC;QAC3F,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAA,wBAAa,EAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,IAAA,2BAAgB,EAAC,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,WAAW,CAClB,KAAa,EACb,KAAkB,EAClB,aAAqB,EACrB,IAAkB,EAClB,WAAoB;IAEpB,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,qBAAqB;QACzC,CAAC,CAAC,GAAG,IAAA,wBAAa,EAAC,KAAK,CAAC,GAAG,CAAC,0BAA0B;QACvD,CAAC,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS;YACzB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,IAAA,wBAAa,EAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;YACxE,CAAC,CAAC,IAAA,wBAAa,EAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEhD,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAC5B,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,EAAE,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,MAAM,QAAQ,SAAS,CAAC,CAAC;IACpG,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IAE1B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,IAAI,WAAW,iEAAiE,CAAC,CAAC;QAC/G,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,6BAAa,CAAC,GAAG,CAAC,+BAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvH,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzD,CAAC"}
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../src/cli/integrations/memory.ts"],"names":[],"mappings":";;AAqBA,oCASC;AA9BD,yCAA2D;AAC3D,mDAAqD;AACrD,qCAAsD;AAEtD;;;;;;;;;;;;;;;;GAgBG;AACI,KAAK,UAAU,YAAY,CAAC,IAAuD;IACxF,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,4EAA4E;IAEjG,OAAO,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,KAAK,gBAAgB,MAAM,CAAC,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC;IAChF,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI;QAAE,OAAO,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAChE,OAAO,CAAC,GAAG,CAAC,6BAA6B,MAAM,CAAC,KAAK,oCAAoC,CAAC,CAAC;IAC3F,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAA,kCAAkB,GAAE,CAAC,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,aAAa,CAAC,IAAwC;IACnE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,MAAM,MAAM,GAAG,IAAA,oBAAS,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,CAAC,mBAAmB,IAAI,CAAC,IAAI,+BAA+B,kBAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC9G,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC/D,IAAI,CAAC;YACH,OAAO,MAAM,IAAA,mBAAU,GAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,uBAAc,EAAE,CAAC;gBAClC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;gBAC5B,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,IAAA,oBAAS,EAAC,aAAa,CAAE,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,2GAA2G,kBAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5J,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzD,CAAC"}

package/dist/cli/integrations/registry.d.ts

@@ -55,8 +55,8 @@ export interface IdeTarget {
         scopes: McpScope[];
         /** Supported transports; first is the preferred default. */
         transports: Transport[];
-        /** The value object placed under serverMap['devsmind'] for a given transport. */
-        entry: (t: Transport, ctx: EntryContext) => Record<string, unknown>;
+        /** The value object placed under serverMap['devsmind'] for a given transport and scope. */
+        entry: (t: Transport, ctx: EntryContext, scope: Scope) => Record<string, unknown>;
         /** Optional CLI one-liner installer (e.g. `claude mcp add ...`). */
         cliInstaller?: (t: Transport, ctx: EntryContext) => string;
         /** Extra guidance printed in manual mode. */
@@ -70,16 +70,19 @@ export interface IdeTarget {
         wrap?: (body: string) => string;
     };
     memory: {
-        /** False when no safe write path exists — manual guidance only, no file is ever touched. */
+        /** `devsmind memory` writes nothing for any tool (see integrations/memory.ts) — this and the
+         *  fields below are read only for their FRAMING value (the tool's own feature name + a short
+         *  caveat), not to decide whether or how to write. `scopes`/`wrap`/`pointerFile` describe a
+         *  write path that no longer exists; kept only as still-accurate research about each tool's
+         *  own store, in case a genuinely safe write target ever becomes available again. */
         supported: boolean;
         /** The tool's own name for this feature — use it verbatim in prompts, not a generic "memory". */
         featureName: string;
         scopes?: MemoryScope[];
         wrap?: (body: string) => string;
-        /** Shown (instead of writing) when supported is false, or as extra context alongside a write. */
+        /** The one-line caveat shown alongside the printed prompt. */
         note: string;
-        /** Claude Code only: also offer to append a one-line pointer into MEMORY.md so an
-         *  unreferenced topic file (loaded only "on demand") is actually discoverable. */
+        /** Unused by `devsmind memory` (see above) — retained only alongside `scopes` as research. */
         pointerFile?: {
             file: string;
             style: 'append-section';
@@ -92,18 +95,26 @@ export interface EntryContext {
     port: number;
 }
 /**
- * Standard stdio entry: the IDE spawns `devsmind start --stdio --path <devmindDir>`.
+ * Standard stdio entry: the IDE spawns `devsmind start --stdio [--path <devmindDir>]`.
  *
- * The explicit `--path` is what makes stdio binding deterministic. Unlike the HTTP server (you run
- * `devsmind start` yourself, from inside the project, so its cwd auto-detect is reliable), a stdio
- * server is spawned BY the IDE with a cwd we don't control — some spawn from the project root, some
- * from the IDE's install dir or the user's home. Baking the absolute brain path in here — which the
- * registration flow already knows (`ctx.devmindDir`) — means the process binds to the right project
- * regardless of where the IDE launched it, instead of leaning on a cwd assumption that silently
- * fails on some tools. Path may contain spaces; it's a separate argv element, so no quoting needed.
+ * `--path` is included for `project` scope only. A project-scoped config file lives inside — and
+ * so only ever serves — the one project it was written for, so baking in the absolute brain path
+ * (which the registration flow already knows via `ctx.devmindDir`) makes binding deterministic
+ * regardless of what cwd the IDE happens to spawn from.
+ *
+ * A `global` config is different: ONE file, read by every project on the machine. Baking a single
+ * project's path into it would silently point every other project at that same brain — the exact
+ * bug this scope split exists to avoid. So a global entry omits `--path` entirely and leans on the
+ * server's own auto-detect (`bindServerToProject` walks up from its cwd looking for `.devmind`),
+ * which works because the IDE spawns the stdio server from whichever workspace is actually open.
+ * If an IDE spawns from somewhere else instead (not the common case), the server starts unbound and
+ * falls back to per-call `devmind_path` — degraded, but never silently wrong.
+ *
+ * Path may contain spaces; it's a separate argv element, so no quoting needed.
  */
-export declare function stdioEntry(ctx: EntryContext): Record<string, unknown>;
-/** Standard HTTP entry: connect to the already-running server. */
+export declare function stdioEntry(ctx: EntryContext, scope: Scope): Record<string, unknown>;
+/** Standard HTTP entry: connect to the already-running server. Scope-independent — the URL never
+ *  names a project, since the server itself is single-project no matter which config points at it. */
 export declare function httpEntry(ctx: EntryContext): Record<string, unknown>;
 /** Resolve an {@link OsPath} to a concrete string for the current platform, expanding a leading `~`. */
 export declare function resolveOsPath(p: OsPath): string;

package/dist/cli/integrations/registry.js

@@ -43,20 +43,31 @@ const os = __importStar(require("os"));
 const path = __importStar(require("path"));
 // ─── Shared entry payloads ───────────────────────────────────────────────────
 /**
- * Standard stdio entry: the IDE spawns `devsmind start --stdio --path <devmindDir>`.
+ * Standard stdio entry: the IDE spawns `devsmind start --stdio [--path <devmindDir>]`.
  *
- * The explicit `--path` is what makes stdio binding deterministic. Unlike the HTTP server (you run
- * `devsmind start` yourself, from inside the project, so its cwd auto-detect is reliable), a stdio
- * server is spawned BY the IDE with a cwd we don't control — some spawn from the project root, some
- * from the IDE's install dir or the user's home. Baking the absolute brain path in here — which the
- * registration flow already knows (`ctx.devmindDir`) — means the process binds to the right project
- * regardless of where the IDE launched it, instead of leaning on a cwd assumption that silently
- * fails on some tools. Path may contain spaces; it's a separate argv element, so no quoting needed.
+ * `--path` is included for `project` scope only. A project-scoped config file lives inside — and
+ * so only ever serves — the one project it was written for, so baking in the absolute brain path
+ * (which the registration flow already knows via `ctx.devmindDir`) makes binding deterministic
+ * regardless of what cwd the IDE happens to spawn from.
+ *
+ * A `global` config is different: ONE file, read by every project on the machine. Baking a single
+ * project's path into it would silently point every other project at that same brain — the exact
+ * bug this scope split exists to avoid. So a global entry omits `--path` entirely and leans on the
+ * server's own auto-detect (`bindServerToProject` walks up from its cwd looking for `.devmind`),
+ * which works because the IDE spawns the stdio server from whichever workspace is actually open.
+ * If an IDE spawns from somewhere else instead (not the common case), the server starts unbound and
+ * falls back to per-call `devmind_path` — degraded, but never silently wrong.
+ *
+ * Path may contain spaces; it's a separate argv element, so no quoting needed.
  */
-function stdioEntry(ctx) {
-    return { command: 'devsmind', args: ['start', '--stdio', '--path', ctx.devmindDir] };
+function stdioEntry(ctx, scope) {
+    const args = ['start', '--stdio'];
+    if (scope === 'project')
+        args.push('--path', ctx.devmindDir);
+    return { command: 'devsmind', args };
 }
-/** Standard HTTP entry: connect to the already-running server. */
+/** Standard HTTP entry: connect to the already-running server. Scope-independent — the URL never
+ *  names a project, since the server itself is single-project no matter which config points at it. */
 function httpEntry(ctx) {
     return { url: `http://localhost:${ctx.port}/mcp` };
 }
@@ -85,18 +96,32 @@ function resolveScopeFile(file, scope, workspaceRoot) {
 // and some require an explicit `type`. These builders capture each tool's shape.
 const httpUrl = (ctx) => `http://localhost:${ctx.port}/mcp`;
 /** Cursor / Kiro: bare `url`, no type. */
-const entryUrl = (t, ctx) => t === 'stdio' ? stdioEntry(ctx) : { url: httpUrl(ctx) };
+const entryUrl = (t, ctx, scope) => t === 'stdio' ? stdioEntry(ctx, scope) : { url: httpUrl(ctx) };
 /** VS Code / Claude Code: explicit `type` + url. */
-const entryTyped = (t, ctx) => t === 'stdio'
-    ? { type: 'stdio', ...stdioEntry(ctx) }
+const entryTyped = (t, ctx, scope) => t === 'stdio'
+    ? { type: 'stdio', ...stdioEntry(ctx, scope) }
     : { type: 'http', url: httpUrl(ctx) };
 /** Windsurf / Antigravity: HTTP endpoint keyed as `serverUrl`. */
-const entryServerUrl = (t, ctx) => t === 'stdio' ? stdioEntry(ctx) : { serverUrl: httpUrl(ctx) };
+const entryServerUrl = (t, ctx, scope) => t === 'stdio' ? stdioEntry(ctx, scope) : { serverUrl: httpUrl(ctx) };
 /** Qwen Code: Streamable-HTTP endpoint keyed as `httpUrl`. */
-const entryHttpUrl = (t, ctx) => t === 'stdio' ? stdioEntry(ctx) : { httpUrl: httpUrl(ctx) };
+const entryHttpUrl = (t, ctx, scope) => t === 'stdio' ? stdioEntry(ctx, scope) : { httpUrl: httpUrl(ctx) };
 const cursorMdcWrap = (body) => `---\ndescription: DevsMind — Team AI Brain workspace rule\nalwaysApply: true\n---\n\n${body}\n`;
-/** Antigravity Skills format: YAML frontmatter (name + description) + markdown body. */
-const antigravitySkillWrap = (body) => `---\nname: devsmind\ndescription: DevsMind team code-graph MCP server — when and how to use it\n---\n\n${body}\n`;
+/**
+ * Skill format: YAML frontmatter (name + description) + markdown body.
+ *
+ * Shared by every target that reads `.agents/skills/` — Antigravity (IDE + CLI) and Codex all
+ * discover the SAME `.agents/skills/devsmind/SKILL.md`. One wrap, deliberately: these writes are
+ * whole-file (`standalone`), so per-tool frontmatter would mean whichever command ran last
+ * silently rewrote the others' file. Identical bytes make that collision a no-op instead.
+ */
+const skillMdWrap = (body) => `---\nname: devsmind\ndescription: DevsMind team code-graph MCP server — when and how to use it\n---\n\n${body}\n`;
+/** The one skill location all `.agents/skills/` readers share. See {@link skillMdWrap}. */
+const AGENTS_SKILL_SCOPE = {
+    scope: 'project',
+    dir: '.agents/skills/devsmind',
+    file: 'SKILL.md',
+    format: 'skill-md',
+};
 // VS Code user-profile mcp.json lives in the platform user-data dir.
 const VSCODE_GLOBAL = {
     win32: '~/AppData/Roaming/Code/User/mcp.json',
@@ -128,7 +153,7 @@ exports.TARGETS = [
         memory: {
             supported: false,
             featureName: 'Memories',
-            note: 'Cursor\'s Memories are stored in an internal, undocumented database and only save after the agent proposes one and you approve it — there is no file DevsMind can safely write to. Ask the agent to remember the DevsMind workflow in conversation (e.g. "remember to always search_nodes before grep, and stage_change + commit_changes after every change") and approve the memory Cursor proposes.',
+            note: 'Cursor\'s Memories are stored in an internal, undocumented database and only save after the agent proposes one and you approve it — there is no file DevsMind can safely write to. Ask the agent to remember the DevsMind workflow in conversation (e.g. "remember to always search_nodes before grep, and edit_node + commit_changes after every change") and approve the memory Cursor proposes.',
         },
     },
     {
@@ -195,7 +220,7 @@ exports.TARGETS = [
         memory: {
             supported: false,
             featureName: 'Knowledge / PR-comment learning',
-            note: 'Kiro has no file-based memory: its manual "Knowledge" store uses JSON + embeddings (not something safe to hand-write), and its autonomous agent\'s PR-comment-driven learning is an undocumented, AWS-internal, non-file-based store. The one thing DevsMind CAN influence — steering docs — is already handled by `devsmind rule`. To also engage the autonomous agent\'s learning, leave a PR review comment once, e.g. "always call search_nodes before grep, and stage_change + commit_changes after every change."',
+            note: 'Kiro has no file-based memory: its manual "Knowledge" store uses JSON + embeddings (not something safe to hand-write), and its autonomous agent\'s PR-comment-driven learning is an undocumented, AWS-internal, non-file-based store. The one thing DevsMind CAN influence — steering docs — is already handled by `devsmind rule`. To also engage the autonomous agent\'s learning, leave a PR review comment once, e.g. "always call search_nodes before grep, and edit_node + commit_changes after every change."',
         },
     },
     {
@@ -218,11 +243,9 @@ exports.TARGETS = [
         memory: {
             supported: true,
             featureName: 'Skills (/learn)',
-            scopes: [
-                { scope: 'project', dir: '.agents/skills/devsmind', file: 'SKILL.md', format: 'skill-md' },
-            ],
-            wrap: antigravitySkillWrap,
-            note: 'Antigravity discovers skills by scanning .agents/skills/ for any SKILL.md — same mechanism whether it was created via /learn or placed here directly.',
+            scopes: [AGENTS_SKILL_SCOPE],
+            wrap: skillMdWrap,
+            note: 'Antigravity discovers skills by scanning .agents/skills/ for any SKILL.md — same mechanism whether it was created via /learn or placed here directly. Codex reads this same file.',
         },
     },
     // ── CLI tools ───────────────────────────────────────────────────────────────
@@ -233,6 +256,11 @@ exports.TARGETS = [
         mcp: {
             scopes: [
                 { scope: 'project', file: '.mcp.json', format: 'json', serverMapPath: ['mcpServers'] },
+                // User-scope entries live at the TOP LEVEL of ~/.claude.json under `mcpServers` — not
+                // nested under that file's `projects` map (that's "local" scope, which this registry
+                // doesn't model). Same JSON shape as project scope, so the generic merge/write path
+                // handles it unchanged; confirmed against Claude Code's own MCP quickstart docs.
+                { scope: 'global', file: '~/.claude.json', format: 'json', serverMapPath: ['mcpServers'] },
             ],
             transports: ['stdio', 'http'],
             entry: entryTyped,
@@ -250,8 +278,7 @@ exports.TARGETS = [
             scopes: [
                 { scope: 'global', dir: '~/.claude/projects', format: 'memory-files', needsUserConfirmedDir: true },
             ],
-            note: 'One file per fact, not one big file: MEMORY.md\'s first 200 lines/25KB load every session automatically, while topic files load only "on demand" — ranked by each file\'s own `description` frontmatter. Split that way, an editing task pulls in the edit_node rule without also dragging in indexing and CLI trivia. An index line per topic is appended to MEMORY.md so they get found at all.',
-            pointerFile: { file: 'MEMORY.md', style: 'append-section' },
+            note: 'Auto Memory saves reliably from an EXPLICIT in-chat request ("remember this") — that\'s exactly what the prompt below is. A silently-written file never triggers that path at all, which is why `devsmind memory` no longer writes one.',
         },
     },
     {
@@ -274,10 +301,8 @@ exports.TARGETS = [
         memory: {
             supported: true,
             featureName: 'Skills (/learn)',
-            scopes: [
-                { scope: 'project', dir: '.agents/skills/devsmind', file: 'SKILL.md', format: 'skill-md' },
-            ],
-            wrap: antigravitySkillWrap,
+            scopes: [AGENTS_SKILL_SCOPE],
+            wrap: skillMdWrap,
             note: 'Same Skills mechanism as the Antigravity IDE — the CLI\'s /skills command browses this same .agents/skills/ directory.',
         },
     },
@@ -302,9 +327,16 @@ exports.TARGETS = [
             style: 'append-section',
         },
         memory: {
-            supported: false,
-            featureName: 'Memories',
-            note: 'Codex\'s own docs explicitly warn: "these files are treated as generated state... don\'t rely on editing them by hand." A background consolidation job periodically regenerates ~/.codex/memories/MEMORY.md and memory_summary.md, so a manual write would likely just get overwritten. Nothing is written here — let Codex build this on its own over real sessions.',
+            supported: true,
+            featureName: 'Skills',
+            scopes: [AGENTS_SKILL_SCOPE],
+            wrap: skillMdWrap,
+            // Codex has two stores and only one of them is ours to write. `~/.codex/memories/` is
+            // generated state its own docs warn against hand-editing ("don't rely on editing them by
+            // hand") and a background job regenerates — untouched, here and everywhere else. Skills are
+            // the human-authored surface, and Codex scans the same `.agents/skills/` directory
+            // Antigravity does, so this is one file serving both tools rather than a new integration.
+            note: 'Codex discovers skills by scanning .agents/skills/ for any SKILL.md — the same file Antigravity reads, so seeding once covers both. Codex\'s own ~/.codex/memories/ is generated state and is never touched. Pair this with `devsmind rule` (AGENTS.md): a skill loads only when the task matches its description, while AGENTS.md is read every turn.',
         },
     },
     {