devsmind-mcp 2.1.1 → 2.2.2

package/dist/cli/integrations/registry.js

@@ -0,0 +1,330 @@
+"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.TARGETS = void 0;
+exports.stdioEntry = stdioEntry;
+exports.httpEntry = httpEntry;
+exports.resolveOsPath = resolveOsPath;
+exports.resolveScopeFile = resolveScopeFile;
+exports.getTarget = getTarget;
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+// ─── Shared entry payloads ───────────────────────────────────────────────────
+/** Standard stdio entry: the IDE spawns `devsmind start --stdio`. */
+function stdioEntry() {
+    return { command: 'devsmind', args: ['start', '--stdio'] };
+}
+/** Standard HTTP entry: connect to the already-running server. */
+function httpEntry(ctx) {
+    return { url: `http://localhost:${ctx.port}/mcp` };
+}
+// ─── OS-aware path resolution ────────────────────────────────────────────────
+/** Resolve an {@link OsPath} to a concrete string for the current platform, expanding a leading `~`. */
+function resolveOsPath(p) {
+    const raw = typeof p === 'string' ? p : p[process.platform] ?? p.linux;
+    if (raw.startsWith('~')) {
+        return path.join(os.homedir(), raw.slice(1));
+    }
+    return raw;
+}
+/**
+ * Resolve the absolute file path for a config/rule scope.
+ * Project scopes are joined onto `workspaceRoot`; global scopes are absolute.
+ */
+function resolveScopeFile(file, scope, workspaceRoot) {
+    const resolved = resolveOsPath(file);
+    if (scope === 'project') {
+        return path.isAbsolute(resolved) ? resolved : path.join(workspaceRoot, resolved);
+    }
+    return path.resolve(resolved);
+}
+// ─── Transport-specific entry helpers ────────────────────────────────────────
+// Different tools key the HTTP endpoint differently (url / serverUrl / httpUrl)
+// 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() : { url: httpUrl(ctx) };
+/** VS Code / Claude Code: explicit `type` + url. */
+const entryTyped = (t, ctx) => t === 'stdio'
+    ? { type: 'stdio', ...stdioEntry() }
+    : { type: 'http', url: httpUrl(ctx) };
+/** Windsurf / Antigravity: HTTP endpoint keyed as `serverUrl`. */
+const entryServerUrl = (t, ctx) => t === 'stdio' ? stdioEntry() : { serverUrl: httpUrl(ctx) };
+/** Qwen Code: Streamable-HTTP endpoint keyed as `httpUrl`. */
+const entryHttpUrl = (t, ctx) => t === 'stdio' ? stdioEntry() : { 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`;
+// VS Code user-profile mcp.json lives in the platform user-data dir.
+const VSCODE_GLOBAL = {
+    win32: '~/AppData/Roaming/Code/User/mcp.json',
+    darwin: '~/Library/Application Support/Code/User/mcp.json',
+    linux: '~/.config/Code/User/mcp.json',
+};
+// ─── The registry ────────────────────────────────────────────────────────────
+// IDEs first, then CLIs, for the picker menu. Each tool's HTTP-key quirk and
+// rules location are encoded here — the rest of the code is tool-agnostic.
+exports.TARGETS = [
+    // ── IDEs ──────────────────────────────────────────────────────────────────
+    {
+        id: 'cursor',
+        label: 'Cursor',
+        kind: 'ide',
+        mcp: {
+            scopes: [
+                { scope: 'project', file: '.cursor/mcp.json', format: 'json', serverMapPath: ['mcpServers'] },
+                { scope: 'global', file: '~/.cursor/mcp.json', format: 'json', serverMapPath: ['mcpServers'] },
+            ],
+            transports: ['stdio', 'http'],
+            entry: entryUrl,
+        },
+        rules: {
+            scopes: [{ scope: 'project', file: '.cursor/rules/devsmind.mdc' }],
+            style: 'standalone',
+            wrap: cursorMdcWrap,
+        },
+        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.',
+        },
+    },
+    {
+        id: 'vscode',
+        label: 'VS Code (GitHub Copilot)',
+        kind: 'ide',
+        mcp: {
+            scopes: [
+                { scope: 'project', file: '.vscode/mcp.json', format: 'json', serverMapPath: ['servers'] },
+                { scope: 'global', file: VSCODE_GLOBAL, format: 'json', serverMapPath: ['servers'] },
+            ],
+            transports: ['stdio', 'http'],
+            entry: entryTyped,
+            note: 'VS Code uses the "servers" key (not "mcpServers").',
+        },
+        rules: {
+            scopes: [{ scope: 'project', file: '.github/copilot-instructions.md' }],
+            style: 'append-section',
+        },
+        memory: {
+            supported: false,
+            featureName: 'Copilot Memory',
+            note: 'Copilot Memory has no documented write API and its file format has changed shape multiple times through 2026 — writing into it directly risks corrupting it. It should pick up the DevsMind workflow itself after a few real sessions using the tools; check what it has learned with the "Chat: Show Memory Files" command.',
+        },
+    },
+    {
+        id: 'windsurf',
+        label: 'Windsurf (Cascade)',
+        kind: 'ide',
+        mcp: {
+            scopes: [
+                { scope: 'global', file: '~/.codeium/windsurf/mcp_config.json', format: 'json', serverMapPath: ['mcpServers'] },
+            ],
+            transports: ['stdio', 'http'],
+            entry: entryServerUrl,
+            note: 'Windsurf keys the remote endpoint as "serverUrl". Config is global-only.',
+        },
+        rules: {
+            scopes: [{ scope: 'project', file: '.windsurf/rules/devsmind.md' }],
+            style: 'standalone',
+        },
+        memory: {
+            supported: false,
+            featureName: 'Cascade Memories',
+            note: 'Cascade Memories are stored at ~/.codeium/windsurf/memories/, keyed per-workspace by a mechanism Windsurf doesn\'t document — there\'s no confirmed evidence a manually-placed file there is ever discovered. Ask Cascade directly to "create a memory of the DevsMind workflow" and it will generate one through its own supported path.',
+        },
+    },
+    {
+        id: 'kiro',
+        label: 'Kiro',
+        kind: 'ide',
+        mcp: {
+            scopes: [
+                { scope: 'project', file: '.kiro/settings/mcp.json', format: 'json', serverMapPath: ['mcpServers'] },
+                { scope: 'global', file: '~/.kiro/settings/mcp.json', format: 'json', serverMapPath: ['mcpServers'] },
+            ],
+            transports: ['stdio', 'http'],
+            entry: entryUrl,
+        },
+        rules: {
+            scopes: [{ scope: 'project', file: '.kiro/steering/devsmind.md' }],
+            style: 'standalone',
+        },
+        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."',
+        },
+    },
+    {
+        id: 'antigravity',
+        label: 'Google Antigravity (IDE)',
+        kind: 'ide',
+        mcp: {
+            scopes: [
+                { scope: 'global', file: '~/.gemini/config/mcp_config.json', format: 'json', serverMapPath: ['mcpServers'] },
+                { scope: 'project', file: '.agents/mcp_config.json', format: 'json', serverMapPath: ['mcpServers'] },
+            ],
+            transports: ['stdio', 'http'],
+            entry: entryServerUrl,
+            note: 'Antigravity keys the remote endpoint as "serverUrl".',
+        },
+        rules: {
+            scopes: [{ scope: 'project', file: 'AGENTS.md' }],
+            style: 'append-section',
+        },
+        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.',
+        },
+    },
+    // ── CLI tools ───────────────────────────────────────────────────────────────
+    {
+        id: 'claude-code',
+        label: 'Claude Code (claude CLI / IDE extension)',
+        kind: 'cli',
+        mcp: {
+            scopes: [
+                { scope: 'project', file: '.mcp.json', format: 'json', serverMapPath: ['mcpServers'] },
+            ],
+            transports: ['stdio', 'http'],
+            entry: entryTyped,
+            cliInstaller: (t, ctx) => t === 'stdio'
+                ? 'claude mcp add --transport stdio devsmind -- devsmind start --stdio'
+                : `claude mcp add --transport http devsmind ${httpUrl(ctx)}`,
+        },
+        rules: {
+            scopes: [{ scope: 'project', file: 'CLAUDE.md' }],
+            style: 'append-section',
+        },
+        memory: {
+            supported: true,
+            featureName: 'Auto Memory',
+            scopes: [
+                { scope: 'global', dir: '~/.claude/projects', file: 'devsmind.md', format: 'markdown', needsUserConfirmedDir: true },
+            ],
+            note: 'MEMORY.md\'s first 200 lines/25KB load every session automatically; topic files like devsmind.md load only "on demand", so a one-line pointer is also appended into MEMORY.md so it actually gets found.',
+            pointerFile: { file: 'MEMORY.md', style: 'append-section' },
+        },
+    },
+    {
+        id: 'antigravity-cli',
+        label: 'Antigravity CLI',
+        kind: 'cli',
+        mcp: {
+            scopes: [
+                { scope: 'project', file: '.agents/mcp_config.json', format: 'json', serverMapPath: ['mcpServers'] },
+                { scope: 'global', file: '~/.gemini/config/mcp_config.json', format: 'json', serverMapPath: ['mcpServers'] },
+            ],
+            transports: ['stdio', 'http'],
+            entry: entryServerUrl,
+            note: 'Shares config with the Antigravity IDE; keys the remote endpoint as "serverUrl".',
+        },
+        rules: {
+            scopes: [{ scope: 'project', file: 'AGENTS.md' }],
+            style: 'append-section',
+        },
+        memory: {
+            supported: true,
+            featureName: 'Skills (/learn)',
+            scopes: [
+                { scope: 'project', dir: '.agents/skills/devsmind', file: 'SKILL.md', format: 'skill-md' },
+            ],
+            wrap: antigravitySkillWrap,
+            note: 'Same Skills mechanism as the Antigravity IDE — the CLI\'s /skills command browses this same .agents/skills/ directory.',
+        },
+    },
+    {
+        id: 'codex',
+        label: 'OpenAI Codex CLI',
+        kind: 'cli',
+        mcp: {
+            scopes: [
+                { scope: 'global', file: '~/.codex/config.toml', format: 'toml', serverMapPath: ['mcp_servers'] },
+                { scope: 'project', file: '.codex/config.toml', format: 'toml', serverMapPath: ['mcp_servers'] },
+            ],
+            transports: ['stdio', 'http'],
+            entry: entryUrl,
+            cliInstaller: (t) => t === 'stdio'
+                ? 'codex mcp add devsmind -- devsmind start --stdio'
+                : '# Codex: add the [mcp_servers.devsmind] url entry to ~/.codex/config.toml (no CLI flag for remote)',
+            note: 'Codex config is TOML. Remote (url) servers must be added by editing config.toml.',
+        },
+        rules: {
+            scopes: [{ scope: 'project', file: 'AGENTS.md' }],
+            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.',
+        },
+    },
+    {
+        id: 'qwen',
+        label: 'Qwen Code CLI',
+        kind: 'cli',
+        mcp: {
+            scopes: [
+                { scope: 'project', file: '.qwen/settings.json', format: 'json', serverMapPath: ['mcpServers'] },
+                { scope: 'global', file: '~/.qwen/settings.json', format: 'json', serverMapPath: ['mcpServers'] },
+            ],
+            transports: ['stdio', 'http'],
+            entry: entryHttpUrl,
+            cliInstaller: (t, ctx) => t === 'stdio'
+                ? 'qwen mcp add devsmind devsmind start --stdio'
+                : `qwen mcp add --transport http devsmind ${httpUrl(ctx)}`,
+            note: 'Qwen keys the Streamable-HTTP endpoint as "httpUrl".',
+        },
+        rules: {
+            scopes: [{ scope: 'project', file: 'QWEN.md' }],
+            style: 'append-section',
+        },
+        memory: {
+            supported: false,
+            featureName: 'Memory (background) / QWEN.md',
+            note: 'QWEN.md itself is confirmed safe to write to, but that\'s already the exact file `devsmind rule` places its block in for Qwen — no separate action needed. The newer, separate ~/.qwen/projects/<project>/memory/ background auto-memory directory has the same undocumented, auto-generated pattern as Codex\'s Memories, with no source confirming a manually-placed file survives — nothing is written there.',
+        },
+    },
+];
+function getTarget(id) {
+    return exports.TARGETS.find(t => t.id === id);
+}
+//# sourceMappingURL=registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/cli/integrations/registry.ts"],"names":[],"mappings":"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"}

package/dist/cli/rule.d.ts

@@ -1,3 +1,16 @@
+import { DevMindConfig } from '../utils/config';
+/**
+ * Build the ready-to-paste DevsMind workspace rule from a project's config.
+ * Pure string builder — no I/O — so it can be printed or written to a file.
+ */
+export declare function buildRule(config: DevMindConfig, devmindDir: string): string;
+/**
+ * `devsmind rule` — print the workspace rule and, interactively, help place it
+ * in the chosen tool's native rules file (manual snippet or automatic write).
+ * Falls back to plain printing when piped/non-TTY or when `--print` is passed,
+ * preserving `devsmind rule > file` usage.
+ */
 export declare function handleRule(opts: {
     path?: string;
-}): void;
+    print?: boolean;
+}): Promise<void>;

package/dist/cli/rule.js

@@ -33,46 +33,19 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildRule = buildRule;
 exports.handleRule = handleRule;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-function findDevmindDir(startDir) {
-    let current = path.resolve(startDir);
-    while (true) {
-        const candidate = path.join(current, '.devmind');
-        if (fs.existsSync(path.join(candidate, 'config.json'))) {
-            return candidate;
-        }
-        const parent = path.dirname(current);
-        if (parent === current)
-            return null;
-        current = parent;
-    }
-}
-function handleRule(opts) {
-    const cwd = process.cwd();
-    let devmindDir;
-    if (opts.path) {
-        const resolved = path.resolve(opts.path);
-        devmindDir = fs.existsSync(path.join(resolved, 'config.json')) ? resolved : null;
-    }
-    else {
-        devmindDir = findDevmindDir(cwd);
-    }
-    if (!devmindDir) {
-        console.error(`❌ No .devmind directory found.\n` +
-            `   Run from inside a DevsMind brain folder, or pass --path <devmind_path>.`);
-        process.exit(1);
-    }
-    const configPath = path.join(devmindDir, 'config.json');
-    let config;
-    try {
-        config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-    }
-    catch {
-        console.error(`❌ Failed to read config.json at ${configPath}`);
-        process.exit(1);
-    }
+const config_1 = require("../utils/config");
+const prompt_1 = require("./integrations/prompt");
+const registry_1 = require("./integrations/registry");
+const scanner_1 = require("../utils/scanner");
+/**
+ * Build the ready-to-paste DevsMind workspace rule from a project's config.
+ * Pure string builder — no I/O — so it can be printed or written to a file.
+ */
+function buildRule(config, devmindDir) {
     const projectName = config.project_name;
     const mode = config.mode;
     const notes = config.notes;
@@ -95,10 +68,19 @@ function handleRule(opts) {
         `**Repos**: ${repoLines}`,
         notes ? `**Notes**: ${notes}` : '',
         '',
+        '### 🧠 What DevsMind Actually Is — Read This First',
+        '',
+        'This is NOT a normal tool you reach for only when asked to search something. DevsMind is the **persistent shared brain for this entire team** — every teammate\'s AI agent, in every session, reads from the exact same graph you are about to write to. There is no "your copy" vs "their copy."',
+        '',
+        `**If you skip ${bt}stage_change${bt} + ${bt}commit_changes${bt}, you are not skipping a formality.** You are leaving the graph stale for every other developer's AI agent that queries this code later — tomorrow, next week, on a completely different task. And the reasoning behind your change (why it was made, what ticket drove it, what was broken before, what you tried and rejected) exists **only in this conversation, right now**. It is not in the diff. It is not in the commit message. If it isn't recorded this turn, it is gone forever — no reindex, no log, no ${bt}git blame${bt} can ever recover it.`,
+        '',
+        `* ${bt}get_node_graph${bt} fills the gap git can't: git shows you WHAT lines changed, never what depends on them. This gives you the live call graph instantly — every caller, every callee — so you find out what breaks BEFORE you change a signature, not after a teammate hits the bug.`,
+        `* ${bt}get_node_history${bt} fills a different gap: git blame tells you WHO and WHEN. It never tells you WHY. The actual decision — what was tried, what was rejected, what ticket demanded this, what was broken before — only exists here, written by whichever AI agent made the change. Skip it before refactoring and you risk silently re-breaking a bug that was already fixed once, or undoing a decision that had a reason you never saw.`,
+        '',
         '### ⚠️ CRITICAL PRE-FLIGHT CHECK & FEW-SHOT EXAMPLE',
         '',
         'Before executing any filesystem search or reading any file contents, you MUST perform this check:',
-        `1. **Am I searching for code/modules/features?** -> You MUST use ${bt}search_nodes${bt} or ${bt}search_code${bt} first. DO NOT start with grep or native filesystem search.`,
+        `1. **Am I searching for code/modules/features?** -> You MUST use ${bt}search_nodes${bt} first — it searches names/reasoning AND falls back to full code-content search automatically if nothing matches, in the SAME call. DO NOT start with grep or native filesystem search.`,
         `2. **Am I reading a source file?** -> You MUST call ${bt}get_node_code${bt} instead. It returns that one function/class parsed live from the file, not the whole file — far cheaper. Only read the raw file if the node genuinely isn't in the graph.`,
         `3. **Am I tracing how something flows through the code?** -> You MUST call ${bt}get_node_graph${bt} with ${bt}direction: "out"${bt} and ${bt}include_code: true${bt}. This returns the entry point PLUS everything it transitively calls, each with its source, in ONE call. Do NOT chain ${bt}get_node_code${bt} calls one function at a time — that wastes a chat turn per function.`,
         '',
@@ -118,8 +100,7 @@ function handleRule(opts) {
         '',
         '| Situation | Tool |',
         '|-----------|------|',
-        `| Searching for a module, feature, or concept | ${bt}search_nodes${bt} |`,
-        `| Searching for specific code fragments, variables, or regex patterns | ${bt}search_code${bt} |`,
+        `| Searching for a module, feature, concept, code fragment, variable, or regex pattern | ${bt}search_nodes${bt} (name/reasoning match, auto-falls-back to code-content search) |`,
         `| Want to list/discover all nodes for a component or directory | ${bt}list_nodes${bt} |`,
         `| Need to read the code of ONE specific function/class | ${bt}get_node_code${bt} |`,
         `| Tracing a request/feature/flow through MULTIPLE functions | ${bt}get_node_graph${bt} with ${bt}direction:"out"${bt} + ${bt}include_code:true${bt} (ONE call — never chain ${bt}get_node_code${bt}) |`,
@@ -131,32 +112,33 @@ function handleRule(opts) {
         '',
         '### ⚠️ MANDATORY: Record Every Code Change in the Graph',
         '',
-        'This is NOT optional. Whenever you add, modify, rename, or delete code, you MUST record it in the graph in the SAME turn — before you consider the task done. An answer that changed code but did not update the graph is INCOMPLETE.',
+        'This is NOT optional. Whenever you add, modify, rename, or delete code, you MUST record it in the graph in the SAME turn — before you consider the task done. An answer that changed code but did not update the graph is INCOMPLETE: the code changed, but every other developer\'s AI agent querying this project still sees the old version and none of the reasoning behind the new one.',
         '',
-        `1. **For ANY change (one file or many):** call ${bt}stage_change${bt} EXACTLY ONCE for EVERY function/class/entity you touched — pass its ${bt}node_id${bt}, ${bt}file_path${bt}, ${bt}code_snapshot${bt}, and ${bt}reasoning${bt}. You do NOT reason about connections. When every touched entity is staged, call ${bt}commit_changes${bt} EXACTLY ONCE.`,
-        `2. **⚠️ ${bt}commit_changes${bt} IS REQUIRED.** Staging alone writes NOTHING to the graph. If you call ${bt}stage_change${bt} and forget ${bt}commit_changes${bt}, all your work is lost and the run is wasted. NEVER end your turn with un-committed staged changes.`,
-        `3. **Do NOT hand-manage edges.** ${bt}commit_changes${bt} resolves all connections from the code via AST automatically. Never try to reason about or pass connections yourself.`,
-        `4. **Do NOT print node/history data as text instead of calling the tools.** Printing does not write to the graph and wastes the turn.`,
+        `**Scope — this applies to source code only.** ${bt}stage_change${bt} models functions/classes/logic entities and will be REJECTED for anything outside: ${Array.from(scanner_1.INDEXABLE_EXTENSIONS).sort().join(', ')}. Do NOT stage stylesheets (${bt}.css${bt}/${bt}.scss${bt}/${bt}.less${bt}), markup, JSON/config, docs, images, or other non-code assets — they have no callers/callees to resolve and only bloat the graph with dead-end nodes. If a file's extension isn't in that list, skip it; do not retry.`,
+        '',
+        `1. **For ANY change (one file or many):** call ${bt}stage_change${bt} EXACTLY ONCE for EVERY function/class/entity you touched — pass its ${bt}node_id${bt}, ${bt}file_path${bt}, ${bt}code_snapshot${bt}, and ${bt}reasoning${bt}. You do NOT reason about connections. The ${bt}reasoning${bt} you write is the whole point — it's the only place "why" ever gets recorded, and it only exists if you write it down right now. When every touched entity is staged, call ${bt}commit_changes${bt} EXACTLY ONCE.`,
+        `2. **⚠️ ${bt}commit_changes${bt} IS REQUIRED.** Staging alone writes NOTHING to the graph — it just buffers to a local file no one else will ever read. If you call ${bt}stage_change${bt} and forget ${bt}commit_changes${bt}, the reasoning you just wrote is stranded and effectively lost: the next session (yours or a teammate's) starts from a graph that never learned about this change. NEVER end your turn with un-committed staged changes.`,
+        `3. **Do NOT hand-manage edges.** ${bt}commit_changes${bt} resolves all connections from the code via AST automatically. Never try to reason about or pass connections yourself — a hand-guessed edge is more likely wrong than one resolved from the actual code.`,
+        `4. **Do NOT print node/history data as text instead of calling the tools.** Printing looks like you did the work, but writes nothing to the graph — the next session sees no trace this ever happened.`,
         '',
         '### Critical Rules',
         '',
-        `1. **Never guess dependencies** — call ${bt}get_node_graph${bt} before touching any function signature.`,
-        `2. **Always read history first** — call ${bt}get_node_history${bt} before refactoring to understand past decisions.`,
-        `3. **No deletions** — never delete nodes. Use ${bt}deprecate_node${bt} to preserve history.`,
+        `1. **Never guess dependencies** — call ${bt}get_node_graph${bt} before touching any function signature. Git shows you what a diff changed; it never shows you what else calls this function and would silently break. Guessing here is how a "small" change becomes a production incident someone else has to debug without knowing why you touched this.`,
+        `2. **Always read history first** — call ${bt}get_node_history${bt} before refactoring to understand past decisions. Skipping this risks re-introducing a bug that was already fixed once, or undoing a decision that had a reason you can't see from the code alone.`,
+        `3. **No deletions** — never delete nodes. Use ${bt}deprecate_node${bt} to preserve history, so the reasoning behind code that's no longer active isn't lost the moment it's removed.`,
         `4. **Resurrecting nodes** — calling ${bt}stage_change${bt} on a deprecated node automatically re-activates it on the next ${bt}commit_changes${bt}.`,
-        `5. **Search before grep** — use ${bt}search_nodes${bt} or ${bt}search_code${bt} before any filesystem search. If no nodes are found using ${bt}search_nodes${bt}, use the ${bt}list_nodes${bt} tool to see all available nodes in the graph.`,
-        `6. **Read code through the graph, not the filesystem** — call ${bt}get_node_code${bt} instead of opening a source file. It parses the node live from disk and returns only that entity, so it is always current AND far cheaper than reading the whole file. If the node isn't in the graph at all, read the file, then ${bt}stage_change${bt} + ${bt}commit_changes${bt} to add it.`,
-        `7. **Fix drift when the tools report it** — if ${bt}get_node_code${bt} returns ${bt}snapshot_outdated: true${bt}, the graph has fallen behind the code on disk. Re-record that node with ${bt}stage_change${bt} + ${bt}commit_changes${bt}. If it returns ${bt}source: "cached"${bt}, the symbol could NOT be found in its file — it was likely renamed, moved, or deleted, so the code you got may be wrong. Verify against the file, then ${bt}rename_node${bt} or ${bt}deprecate_node${bt} as appropriate.`,
+        `5. **Search before grep** — use ${bt}search_nodes${bt} before any filesystem search; it tries identifiers first and automatically falls back to a full code-content search if nothing matches, so one call covers both cases. A raw grep finds text; it can't tell you the reasoning already recorded behind that code, which is the whole reason to check here first. If it still finds nothing, use the ${bt}list_nodes${bt} tool to see all available nodes in the graph.`,
+        `6. **Read code through the graph, not the filesystem** — call ${bt}get_node_code${bt} instead of opening a source file. It parses the node live from disk and returns only that entity, so it is always current AND far cheaper than reading the whole file. Reading the raw file instead means the graph has no way to know you looked, so any drift between what's recorded and what's on disk goes unnoticed. If the node isn't in the graph at all, read the file, then ${bt}stage_change${bt} + ${bt}commit_changes${bt} to add it.`,
+        `7. **Fix drift when the tools report it** — if ${bt}get_node_code${bt} returns ${bt}snapshot_outdated: true${bt}, the graph has fallen behind the code on disk. Re-record that node with ${bt}stage_change${bt} + ${bt}commit_changes${bt}. If it returns ${bt}source: "cached"${bt}, the symbol could NOT be found in its file — it was likely renamed, moved, or deleted, so the code you got may be wrong. Verify against the file, then ${bt}rename_node${bt} or ${bt}deprecate_node${bt} as appropriate. Ignoring a drift signal means everyone after you keeps trusting a record you already know is wrong.`,
         `8. **No external scripts for indexing** — When indexing a repository, NEVER write or run external scripts (like Python, Bash, or Node.js) to automate or lazy load indexing. You must perform the indexing natively step-by-step in the chat using the designated tools: ${bt}index_start${bt}, ${bt}index_checkpoint${bt}, ${bt}index_continue${bt}, and ${bt}index_complete${bt}. This ensures progress is tracked in the SQLite scratchpad database and allows indexing to be safely resumed across chat sessions if context limits are hit.`,
         `9. **Continuous Indexing** — Once you start the codebase indexing process, do not stop, pause, or ask for user confirmation between checkpoints. Keep executing and indexing files continuously until the workspace is fully indexed, or until the chat session's context token limit is reached.`,
-        `10. **Grow-as-you-go Graph Maintenance (MANDATORY)** — DevsMind is a living code graph and keeping it in sync is a hard requirement, not a nicety. At the end of EVERY task or message where code was added, modified, renamed, or deleted, you MUST record it per the "MANDATORY: Record Every Code Change" section above — ${bt}stage_change${bt} per touched entity then ${bt}commit_changes${bt} once. NEVER finish a turn with un-committed staged changes. If you notice deprecated/stale nodes, clean them up with ${bt}deprecate_node${bt} or ${bt}rename_node${bt}. Do not let the graph go stale.`,
+        `10. **Grow-as-you-go Graph Maintenance (MANDATORY)** — DevsMind is a living code graph and keeping it in sync is a hard requirement, not a nicety. At the end of EVERY task or message where code was added, modified, renamed, or deleted, you MUST record it per the "MANDATORY: Record Every Code Change" section above — ${bt}stage_change${bt} per touched entity then ${bt}commit_changes${bt} once. NEVER finish a turn with un-committed staged changes. If you notice deprecated/stale nodes, clean them up with ${bt}deprecate_node${bt} or ${bt}rename_node${bt}. A graph that's allowed to go stale stops being worth checking at all — every skipped update is one more reason for the next agent to distrust what's here and fall back to guessing.`,
         '',
         '### Available Tools',
         '',
         '| Tool | Use when |',
         '|------|----------|',
-        `| ${bt}search_nodes${bt} | Find nodes by name, keyword, or reasoning text |`,
-        `| ${bt}search_code${bt} | Regex or string search over cached codebase code snapshots |`,
+        `| ${bt}search_nodes${bt} | Find code by name, keyword, or reasoning text — auto-falls-back to a regex/string code-content search if nothing matches |`,
         `| ${bt}list_nodes${bt} | List nodes in the graph with optional filters (type, file path, etc.) |`,
         `| ${bt}get_node_summary${bt} | Get file location, connection count, history count for a node |`,
         `| ${bt}get_node_code${bt} | Get ONE node's current source, parsed live from its file (use instead of reading the file) |`,
@@ -176,7 +158,9 @@ function handleRule(opts) {
         '',
         '> All tool argument schemas are exposed automatically by the MCP server.'
     ];
-    const rule = lines.filter(l => l !== null).join('\n');
+    return lines.filter(l => l !== null).join('\n');
+}
+function printRuleBanner(rule, projectName, tip) {
     const divider = '═'.repeat(70);
     console.log(`\n${divider}`);
     console.log(` DevsMind Workspace Rule — "${projectName}"`);
@@ -184,8 +168,86 @@ function handleRule(opts) {
     console.log(`${divider}\n`);
     console.log(rule);
     console.log(`\n${divider}`);
-    console.log(` 💡 Tip: save this to .agents/AGENTS.md in your workspace root`);
-    console.log(`    or paste directly into your IDE's AI rules/instructions panel.`);
+    if (tip) {
+        console.log(tip);
+    }
+    else {
+        console.log(` 💡 Tip: save this to .agents/AGENTS.md in your workspace root`);
+        console.log(`    or paste directly into your IDE's AI rules/instructions panel.`);
+    }
     console.log(`${divider}\n`);
 }
+/**
+ * `devsmind rule` — print the workspace rule and, interactively, help place it
+ * in the chosen tool's native rules file (manual snippet or automatic write).
+ * Falls back to plain printing when piped/non-TTY or when `--print` is passed,
+ * preserving `devsmind rule > file` usage.
+ */
+async function handleRule(opts) {
+    const devmindDir = (0, config_1.resolveDevmindDir)(opts.path);
+    if (!devmindDir) {
+        console.error(`❌ No .devmind directory found.\n` +
+            `   Run from inside a DevsMind brain folder, or pass --path <devmind_path>.`);
+        process.exit(1);
+    }
+    const configPath = path.join(devmindDir, 'config.json');
+    let config;
+    try {
+        config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+    }
+    catch {
+        console.error(`❌ Failed to read config.json at ${configPath}`);
+        process.exit(1);
+        return;
+    }
+    const rule = buildRule(config, devmindDir);
+    const projectName = config.project_name;
+    // Backward-compat: piped/redirected output or explicit --print → plain print.
+    if (opts.print || !process.stdout.isTTY) {
+        printRuleBanner(rule, projectName);
+        return;
+    }
+    const workspaceRoot = path.dirname(devmindDir);
+    try {
+        const target = await (0, prompt_1.pickTarget)();
+        const mode = await (0, prompt_1.pickMode)();
+        if (mode === 'manual') {
+            const scope = target.rules.scopes[0];
+            const file = (0, registry_1.resolveScopeFile)(scope.file, scope.scope, workspaceRoot);
+            const noteFrontmatter = target.rules.wrap
+                ? '\n    (this file needs frontmatter — automatic mode adds it for you)'
+                : '';
+            printRuleBanner(rule, projectName, ` 💡 Save this to ${file.replace(/\\/g, '/')}${noteFrontmatter}`);
+            return;
+        }
+        // Automatic mode.
+        const scope = await (0, prompt_1.pickRuleScope)(target);
+        let filePath;
+        if (scope.scope === 'project') {
+            const base = await (0, prompt_1.pickDirectory)(workspaceRoot, `Where is the project root for ${target.label}?`);
+            filePath = path.join(base, (0, registry_1.resolveOsPath)(scope.file));
+        }
+        else {
+            filePath = (0, registry_1.resolveScopeFile)(scope.file, 'global', workspaceRoot);
+        }
+        const merged = (0, prompt_1.mergeRuleFile)(filePath, rule, target.rules.style, target.rules.wrap);
+        console.log(`\n📝 Target: ${filePath.replace(/\\/g, '/')}  (${merged.existed ? (target.rules.style === 'append-section' ? 'merge DevsMind block into existing' : 'overwrite dedicated file') : 'create new'})`);
+        console.log(`\n${target.rules.style === 'append-section' ? 'The DevsMind block to be written:' : 'File contents to be written:'}\n`);
+        console.log(merged.preview.split('\n').map(l => '   ' + l).join('\n'));
+        const ok = await (0, prompt_1.confirmPrompt)('Write this?', true);
+        if (!ok) {
+            console.log('\nAborted — nothing written.');
+            return;
+        }
+        (0, prompt_1.writeConfigFile)(filePath, merged.content);
+        console.log(`\n✅ DevsMind rule written to ${filePath.replace(/\\/g, '/')} for ${target.label}.`);
+    }
+    catch (err) {
+        if (err instanceof prompt_1.CancelledError) {
+            console.log('\nCancelled.');
+            return;
+        }
+        throw err;
+    }
+}
 //# sourceMappingURL=rule.js.map