devsmind-mcp 2.4.0 → 3.0.0

package/dist/db/staging.js

@@ -34,17 +34,39 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.readStaged = readStaged;
+exports.readStagedFileEdits = readStagedFileEdits;
+exports.partitionStagedForSession = partitionStagedForSession;
+exports.clearStagedForSession = clearStagedForSession;
 exports.stageEntry = stageEntry;
+exports.stageFileEdit = stageFileEdit;
+exports.overwriteStaged = overwriteStaged;
 exports.clearStaged = clearStaged;
+exports.removeLastStagedEntry = removeLastStagedEntry;
+exports.resolveEntryId = resolveEntryId;
 exports.commitStagedChanges = commitStagedChanges;
 exports.summarizeEntriesForWorkflow = summarizeEntriesForWorkflow;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const edges_1 = require("./edges");
+const embedder_1 = require("./embedder");
 const STAGING_FILE = 'history_scratchpad.json';
 function stagingPath(devmindPath) {
     return path.join(path.resolve(devmindPath), STAGING_FILE);
 }
+function readBuffer(devmindPath) {
+    try {
+        const raw = fs.readFileSync(stagingPath(devmindPath), 'utf-8');
+        const buf = JSON.parse(raw);
+        return {
+            entries: Array.isArray(buf.entries) ? buf.entries : [],
+            file_edits: Array.isArray(buf.file_edits) ? buf.file_edits : [],
+            updated_at: buf.updated_at || new Date().toISOString()
+        };
+    }
+    catch {
+        return { entries: [], file_edits: [], updated_at: new Date().toISOString() };
+    }
+}
 /** Atomic write (temp file + rename) so an accumulating buffer is never left half-written. */
 function writeBuffer(devmindPath, buf) {
     const target = stagingPath(devmindPath);
@@ -53,21 +75,78 @@ function writeBuffer(devmindPath, buf) {
     fs.renameSync(tmp, target);
 }
 function readStaged(devmindPath) {
-    try {
-        const raw = fs.readFileSync(stagingPath(devmindPath), 'utf-8');
-        const buf = JSON.parse(raw);
-        return Array.isArray(buf.entries) ? buf.entries : [];
+    return readBuffer(devmindPath).entries;
+}
+function readStagedFileEdits(devmindPath) {
+    return readBuffer(devmindPath).file_edits;
+}
+/**
+ * An entry with no `session_id` predates this field (a buffer written before session-scoping
+ * existed) — there is no session left to ever reclaim it, so it is treated as belonging to
+ * whoever commits next rather than staying stranded in the buffer forever. Anything stamped
+ * with a DIFFERENT session's id is a genuinely different in-flight task and must not be swept
+ * up by someone else's commit.
+ */
+function belongsToSession(item, sessionId) {
+    return !item.session_id || item.session_id === sessionId;
+}
+/**
+ * Splits the shared buffer into "what this session may commit" vs. "left behind" — the fix for
+ * the multi-session bug where `commit_changes` used to flush the ENTIRE buffer regardless of who
+ * staged what, silently pulling unrelated in-flight work (sometimes from other repos entirely)
+ * into a commit and stamping it with the committing session's reasoning. A plain commit now only
+ * ever touches its own session's staged work; other sessions' entries stay staged untouched.
+ */
+function partitionStagedForSession(devmindPath, sessionId) {
+    const buf = readBuffer(devmindPath);
+    const entries = buf.entries.filter(e => belongsToSession(e, sessionId));
+    const fileEdits = buf.file_edits.filter(e => belongsToSession(e, sessionId));
+    const otherSessionsPending = (buf.entries.length - entries.length) + (buf.file_edits.length - fileEdits.length);
+    return { entries, fileEdits, otherSessionsPending };
+}
+/**
+ * Removes only this session's staged entries/file edits, leaving any other session's pending
+ * work in place — the scoped counterpart to `clearStaged`, which used to wipe the whole buffer
+ * (including work another session had not committed yet) after every commit.
+ */
+function clearStagedForSession(devmindPath, sessionId) {
+    const buf = readBuffer(devmindPath);
+    const entries = buf.entries.filter(e => !belongsToSession(e, sessionId));
+    const file_edits = buf.file_edits.filter(e => !belongsToSession(e, sessionId));
+    if (entries.length || file_edits.length) {
+        writeBuffer(devmindPath, { entries, file_edits, updated_at: new Date().toISOString() });
     }
-    catch {
-        return [];
+    else {
+        clearStaged(devmindPath);
     }
 }
-/** Appends one entry to the buffer and returns the new pending count. */
+/** Appends one entry to the buffer (stamping `staged_at`) and returns the new pending count. */
 function stageEntry(devmindPath, entry) {
-    const entries = readStaged(devmindPath);
-    entries.push(entry);
-    writeBuffer(devmindPath, { entries, updated_at: new Date().toISOString() });
-    return entries.length;
+    const buf = readBuffer(devmindPath);
+    buf.entries.push({ ...entry, staged_at: entry.staged_at || new Date().toISOString() });
+    buf.updated_at = new Date().toISOString();
+    writeBuffer(devmindPath, buf);
+    return buf.entries.length;
+}
+/** Appends one whole-file edit to the buffer (stamping `staged_at`) and returns the new pending count. */
+function stageFileEdit(devmindPath, edit) {
+    const buf = readBuffer(devmindPath);
+    buf.file_edits.push({ ...edit, staged_at: edit.staged_at || new Date().toISOString() });
+    buf.updated_at = new Date().toISOString();
+    writeBuffer(devmindPath, buf);
+    return buf.file_edits.length;
+}
+/**
+ * Replaces the buffer's entries wholesale, keeping `file_edits` untouched — used by
+ * `add_description` to persist a description written onto an already-staged entry (e.g. after
+ * a `commit_changes` rejection), since `readStaged` returns a fresh array each call and
+ * mutating it in memory has no effect until it's written back.
+ */
+function overwriteStaged(devmindPath, entries) {
+    const buf = readBuffer(devmindPath);
+    buf.entries = entries;
+    buf.updated_at = new Date().toISOString();
+    writeBuffer(devmindPath, buf);
 }
 function clearStaged(devmindPath) {
     const target = stagingPath(devmindPath);
@@ -77,7 +156,32 @@ function clearStaged(devmindPath) {
     }
     catch { /* ignore */ }
 }
-/** Resolves an entry's raw node_id to the canonical `{repo}/relpath#symbol` form. */
+/**
+ * Drops the newest staged entry for one node and returns it, or null if the node has none.
+ *
+ * Newest rather than all: the buffer can hold several edits to the same entity, and reverting is
+ * an undo of the last one. An entry removed here was never committed, so nothing else has to be
+ * unwound — there is no history row yet for it to have written.
+ */
+function removeLastStagedEntry(devmindPath, nodeId) {
+    const buf = readBuffer(devmindPath);
+    const idx = buf.entries.map(e => e.node_id).lastIndexOf(nodeId);
+    if (idx === -1)
+        return null;
+    const [removed] = buf.entries.splice(idx, 1);
+    if (buf.entries.length || buf.file_edits.length) {
+        buf.updated_at = new Date().toISOString();
+        writeBuffer(devmindPath, buf);
+    }
+    else {
+        clearStaged(devmindPath);
+    }
+    return removed;
+}
+/** Resolves an entry's raw node_id to the canonical `{repo}/relpath#symbol` form. Exported so
+ * the commit_changes gate can check "does this node already exist" using the exact same
+ * canonicalization commitStagedChanges itself uses — a mismatch there would let a node the
+ * gate thinks is new slip through uncommitted, or block one that's actually already described. */
 function resolveEntryId(db, entry) {
     if (entry.node_id.includes('#'))
         return entry.node_id;
@@ -92,14 +196,20 @@ function resolveEntryId(db, entry) {
  *            auto-creating any missing target nodes. Only the staged nodes' own outbound edges
  *            are recomputed; every other node's edges are left intact.
  *
+ * `reasoning` is ONE object covering the whole batch — every entry in one commit serves one
+ * request, so it is asked for once here rather than repeated on every staged entry. Kept as an
+ * object (not pre-formatted) all the way to `updateHistory`, since the configured-developer
+ * override only fires on the object form.
+ *
  * Idempotent: re-running the same batch yields the same graph (upsert + INSERT OR IGNORE +
  * clear-then-resolve). Callers should clear the buffer only after this returns successfully.
  */
-function commitStagedChanges(db, devmindPath, entries) {
+async function commitStagedChanges(db, devmindPath, entries, reasoning) {
     const stagedIds = [];
     const historyIds = [];
     // Pass 1 — nodes + history (+ any explicit connections the caller supplied).
     const explicitEdges = [];
+    const toEmbed = [];
     for (const entry of entries) {
         const nodeId = resolveEntryId(db, entry);
         stagedIds.push(nodeId);
@@ -110,12 +220,16 @@ function commitStagedChanges(db, devmindPath, entries) {
             name,
             type,
             file_path: entry.file_path,
-            signature: entry.signature || null
+            signature: entry.signature || null,
+            description: entry.description || null
         });
+        if (entry.description)
+            toEmbed.push({ node_id: nodeId, description: entry.description });
         const history = db.updateHistory({
             node_id: nodeId,
             code_snapshot: entry.code_snapshot,
-            reasoning: entry.reasoning,
+            code_before: entry.code_before,
+            reasoning,
             session_id: entry.session_id
         });
         historyIds.push(history.id);
@@ -124,6 +238,18 @@ function commitStagedChanges(db, devmindPath, entries) {
                 explicitEdges.push({ source: c.source_node_id || nodeId, target: c.target_node_id });
         }
     }
+    // Batched, not per-entry — this is where a STAGED description (from stage_change, or from
+    // add_description filling in a gate rejection) first has somewhere to actually store a vector.
+    // No-op (embedTextsInt8 returns null) if the optional ONNX dependency is unavailable; those
+    // nodes just fall into the `devsmind embed` queue like any other unembedded description.
+    if (toEmbed.length > 0) {
+        const vectors = await (0, embedder_1.embedTextsInt8)(toEmbed.map(t => t.description));
+        if (vectors) {
+            for (let i = 0; i < toEmbed.length; i++) {
+                db.upsertNodeVector(toEmbed[i].node_id, vectors[i], (0, embedder_1.hashDescription)(toEmbed[i].description));
+            }
+        }
+    }
     // Pass 2 — AST edge resolution for the batch (clear stale outbound edges of staged nodes first).
     const { edgesAdded, missingFilled } = (0, edges_1.resolveEdgesForNodes)(db, devmindPath, stagedIds, { clearSources: true });
     // Apply any explicit edges the caller passed, on top of AST resolution (additive).
@@ -139,13 +265,13 @@ function commitStagedChanges(db, devmindPath, entries) {
         node_ids: stagedIds
     };
 }
-/** Builds a short workflow-step summary from a batch of staged entries' `what_changed` reasoning. */
-function summarizeEntriesForWorkflow(entries) {
-    const bits = entries.map(e => {
-        if (typeof e.reasoning === 'object' && e.reasoning.what_changed)
-            return e.reasoning.what_changed;
-        return e.node_id;
-    });
+/** Builds a short workflow-step/activity summary for a commit. The commit's own `reasoning`
+ * (one object covering the whole batch) is authoritative when it has a `what_changed`; falls
+ * back to naming the staged entities for a bare-string reasoning. */
+function summarizeEntriesForWorkflow(entries, reasoning) {
+    if (typeof reasoning === 'object' && reasoning.what_changed)
+        return reasoning.what_changed;
+    const bits = entries.map(e => e.node_id);
     return bits.length === 1 ? bits[0] : `${bits.length} entities updated: ${bits.join('; ')}`;
 }
 //# sourceMappingURL=staging.js.map

package/dist/db/staging.js.map

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

package/dist/mcp/server.d.ts

@@ -1,3 +1,5 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import express from 'express';
 export declare const DEVSMIND_PORT = 4513;
 /**
  * Sent to every MCP client at connection time via the protocol's `instructions`
@@ -7,18 +9,38 @@ export declare const DEVSMIND_PORT = 4513;
  * `description` (resent every call), this is easy for a long session to lose
  * track of too, so it should carry only what's genuinely cross-cutting.
  */
-export declare const DEVSMIND_INSTRUCTIONS = "DevsMind is this team's persistent shared code memory \u2014 not a personal tool you reach for only when asked to search something. Every teammate's AI agent, in every session, reads from the SAME graph you are about to write to. There is no \"your copy.\"\n\nIf you skip recording a change, you are not skipping a formality. You are leaving the whole team's graph stale for every other AI agent that queries this code later \u2014 tomorrow, on a different task, in a different session. 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 captured this turn, it is gone forever \u2014 no reindex, no log, no git blame can recover it later.\n\nNon-negotiable workflow:\n1. Before any filesystem search or file read: call search_nodes first. It searches names/reasoning and automatically falls back to a full code-content search if nothing matches \u2014 one call covers both, never start with grep.\n2. To read one function/class: call get_node_code instead of opening the file. It parses live from disk, so it's cheaper and always current.\n3. Before touching any function's signature: call get_node_graph. Git shows you what changed; it never shows you what depends on it. Find out before you break something, not after.\n4. Before refactoring: call get_node_history. Git blame tells you who and when; it never tells you why. The actual decision context only exists here.\n5. Write EVERY file with edit_node \u2014 .ts, .vue, .css, .json, .xml, .md, anything \u2014 and never your editor's own edit/write tools. It takes file_path + old_string + new_string exactly like an ordinary edit tool and never refuses a file type; to create a file that doesn't exist yet, pass old_string: \"\" and the whole file as new_string. Because it knows where your text landed, it works out which function/class you changed and records your reasoning against it automatically: no node_id to look up, no code_snapshot to send back, and no stage_change call. It answers with every caller of what you changed. Writes landing outside any function (markup, config, an import) record nothing \u2014 normal and expected, not a failure.\n6. stage_change is now only for what no parser can read: a language with no AST support (.py, .go, .java, .cs, .rb, .php, .rs, .swift, .kt, .dart). edit_node still writes those files, and its response tells you when it couldn't trace one \u2014 so never guess. One call per node, not per file, never batched for later. On a long task, call commit_changes at natural checkpoints too (not only once at the very end) \u2014 waiting until the whole task is \"done\" is how staged work gets left uncommitted when a session runs long.\n7. Scope: the graph is source code only (functions/classes/logic). stage_change will be REJECTED for stylesheets, markup, JSON/config, docs, images, or any other non-code asset. Do not stage those files \u2014 they have no callers/callees to resolve and only bloat the graph.\n8. When you start work that might relate to a multi-session feature, call workflow_list first. If a paused workflow's description looks related to what you're about to do, ask the user whether to resume it (workflow_resume) instead of starting fresh and silently losing its decision history \u2014 git blame never shows you a paused feature's prior context, only this does.\n9. If a workflow is active, commit_changes already logs a step for you from what you staged \u2014 you do NOT need a separate workflow_add_step call for the normal case. Only call workflow_add_step directly for something a commit doesn't cover (a decision with no code change, or a pending_tasks note).";
+export declare const DEVSMIND_INSTRUCTIONS = "DevsMind is this team's persistent shared code memory \u2014 not a personal tool you reach for only when asked to search something. Every teammate's AI agent, in every session, reads from the SAME graph you are about to write to. There is no \"your copy.\"\n\nIf you skip recording a change, you are not skipping a formality. You are leaving the whole team's graph stale for every other AI agent that queries this code later \u2014 tomorrow, on a different task, in a different session. 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 captured at commit_changes this turn, it is gone forever \u2014 no reindex, no log, no git blame can recover it later.\n\nNon-negotiable workflow:\n1. Call start_session once, before your first WRITE of the conversation (edit_node/stage_change/commit_changes and the other mutating tools). It mints a session_id that every write REQUIRES \u2014 it ties a request's edits together on the local Activity log and makes them revertable as a unit \u2014 and every response echoes it back so it stays in front of you, including after a context compaction. Read-only tools (search_nodes, get_node_code, list_nodes, and the other getters) do NOT need it: search and read freely from the very first call. Never invent a session_id yourself; if a write errors saying session_id is required, start_session was skipped \u2014 call it now, then retry. If you are resuming a conversation that already called start_session earlier (visible in the reloaded history), reuse that same session_id instead of starting a new one.\n2. Before any filesystem search, grep, or file read: call search_nodes FIRST \u2014 it is now the one call for both \"find this node\" AND \"find where X lives across files\", so you should not need an external grep. Two inputs, pass either or both: a natural-language query (a real phrase \u2014 drives meaning-matching, so \"authentication\" finds a node described only as \"sign-in\") and/or pattern, a REAL regex used exactly as you'd give it to grep (e.g. \"heartRed|onLikeTap|item.liked\" \u2014 nothing is re-escaped or split for you). Pattern-only is a precision mode: exact grep + code-body matches, no semantic blur. It returns two buckets: nodes (the indexed graph \u2014 the primary answer for \"which function/class\", with a true nodes_total before the top-20 cap) and files (a real grep of every repo, or just the path scope if given \u2014 the answer for things the graph does not index: CSS, JSON, config, .env, markup, wiring like \"where is CORS configured\" or \"what mounts this middleware\" \u2014 each sample line reports which function/class it falls inside, and files_total tells you honestly whether there's more than the page shown; pass a bigger offset for the next page). Triage by each node's confidence and relevance, NOT by which name looks right to you \u2014 confidence reflects how many independent layers corroborated the hit, which your own reading of a name cannot. Lockfiles and build artifacts are excluded by default, so what comes back is real source. If the response carries a compacted field, it was trimmed to fit and says exactly what was dropped \u2014 all counts stay exact, and compact:false gets you the untrimmed payload. It only returns real evidence \u2014 genuinely-absent things come back empty with a hint; if so, retry once with a different pattern/query before concluding it is not there. Only drop to a manual grep/read if search_nodes itself says truncated, or you need full file context after it points you at the file.\n3. To read one function/class: call get_node_code instead of opening the file, and do not follow it with a file read for context \u2014 this is the ONE node-read call, not a lean summary. It already includes the file's imports, the node's own name/type/signature/description, up to 20 named callers AND callees per direction (with exact uses/used_by counts even when the lists are capped), and up to 40 other declarations from the same file (file_outline \u2014 this is how you tell \"was this renamed?\" or \"what else lives here\" without opening the file). Reach further in the SAME call instead of a second tool: graph_depth + graph_direction walks the transitive graph past the direct neighbors already included (add graph_code:true for a whole call flow's source in one round trip \u2014 if some nodes' code doesn't fit the budget they are named in graph.code_omitted_node_ids, so fetch exactly those rather than re-running blind), and history:\"full\" returns every revision with diffable edits, pageable with history_limit/history_offset. Every capped section is honest about it (*_truncated, *_hint) \u2014 a hint means more is reachable in this same call, not a dead end.\n4. Before touching any function's signature: get_node_code already includes its direct callers by name (used_by_nodes) \u2014 for the FULL transitive blast radius, pass graph_direction:\"in\" with a graph_depth of 2-3 in that same call. Git shows you what changed; it never shows you what depends on it. Find out before you break something, not after.\n5. Before refactoring: get_node_code already includes the last 3 changes' reasoning by default \u2014 for the full revision trail with diffable before/after edits, pass history:\"full\" in that same call. Git blame tells you who and when; it never tells you why. The actual decision context only exists here.\n6. Write EVERY file with edit_node \u2014 .ts, .vue, .css, .json, .xml, .md, anything \u2014 and never your editor's own edit/write tools. It takes file_path + old_string + new_string exactly like an ordinary edit tool and never refuses a file type; to create a file that doesn't exist yet, pass old_string: \"\" and the whole file as new_string. Because it knows where your text landed, it works out which function/class you changed automatically: no node_id to look up, no code_snapshot to send back, and no stage_change call. It answers with every caller of what you changed. Writes landing outside any function (markup, config, an import) get no graph node \u2014 normal and expected, not a failure \u2014 but the whole-file change is still staged for the local activity log, so commit_changes makes it revertable there like any other edit.\n7. stage_change is now only for what no parser can read: a language with no AST support (.py, .go, .java, .cs, .rb, .php, .rs, .swift, .kt, .dart). edit_node still writes those files, and its response tells you when it couldn't trace one \u2014 so never guess. One call per node, not per file, never batched for later. On a long task, call commit_changes at natural checkpoints too (not only once at the very end) \u2014 waiting until the whole task is \"done\" is how staged work gets left uncommitted when a session runs long.\n8. Scope: the graph is source code only (functions/classes/logic). stage_change will be REJECTED for stylesheets, markup, JSON/config, docs, images, or any other non-code asset. Do not stage those files \u2014 they have no callers/callees to resolve and only bloat the graph.\n9. commit_changes REQUIRES a message AND a reasoning \u2014 the call fails without either. message is the user's request, verbatim, that led to this commit; it builds a local, private, never-pushed activity log (devsmind view \u2192 Activity) grouping your work by request and letting the user revert a request as a whole. Pass the exact same text again on a later commit that's still answering the same request \u2014 that merges them into one entry instead of splitting it. reasoning (what_changed/why/goal) is ONE object covering everything staged since the last commit \u2014 a commit is one logical change, so it gets one why, recorded against every node it touches, not one per edit_node/stage_change call.\n10. commit_changes also REFUSES any batch containing a brand-NEW node with no description \u2014 a description is what makes that node findable later by a natural-language search_nodes query instead of only by its exact identifier. If edit_node or stage_change just created a node, call add_description with it (1-3 sentences of what it does and the domain concepts involved \u2014 never a restatement of the name) before commit_changes will accept it. Nothing staged is lost by the refusal; retry the same commit_changes call once it's described. Existing nodes are never gated by this \u2014 only ones new this commit.\n11. A workflow is a named log of how ONE piece of functionality grew, across many sessions \u2014 read it to learn how the code got this way. start_session tells you if there is a recent one worth continuing; otherwise, when starting work that might belong to an existing multi-session feature, call workflow_list. If a description matches, ask the user before continuing it, then workflow_bind to attach THIS session. Binding is local to you: it never moves, pauses, or steals anyone else's workflow, and two sessions can work different ones at the same time.\n12. Once bound, commit_changes logs a step for you automatically \u2014 you do NOT need workflow_add_step for ordinary code work. Call it for the thing a commit cannot express: a DECISION OR RESEARCH FINDING THAT CHANGED NO CODE (\"evaluated X, rejected it because Y\"), attaching the docs behind it via doc_paths. That is the one kind of knowledge nothing else keeps \u2014 git has the diff, history has the per-node reasoning, but neither records what was considered and rejected. If you did work while unbound, or on the wrong workflow, workflow_sync attaches it afterwards from your local activity log: it previews first and only writes when you pass confirm:true, so nothing has to be got right in the moment.\n13. commit_changes also REQUIRES a feedback object (5 fields) \u2014 this is the only channel that improves DevsMind over time, so answer it for real, not as a formality. Before writing \"none\" on any field, actually check: did anything in THIS task take an extra tool call, a guess, a re-read, or a wrong turn? There almost always is something, even on an easy task \u2014 a specific one-line answer with evidence (file:line) is far more useful than a reflexive \"none\". \"none\" is correct only when you genuinely paid attention and nothing applies. Noticed something worth reporting but aren't committing right now (or don't want to wait until you are)? Call add_feedback directly \u2014 same 5 categories, but any one or more, nothing required, no commit needed. Passing evidence (file + snippet) on a graph_problem/edge_problem gets it verified fresh at call time and marked confirmed instead of suspected.";
+/** Binds this process to one project's `.devmind` dir. Called once at server startup. */
+export declare function bindDevmindPath(devmindPath: string): void;
+/** The bound project path, or null if this server is running unbound (tests / legacy). */
+export declare function getBoundDevmindPath(): string | null;
 /**
- * Start DevsMind as an HTTP MCP server on port 4500.
- * IDEs connect via: http://localhost:4500/mcp
- *
- * Port mnemonic: devs→45 (D=4,E=5)  +  mind→13 (M=13)  =  4513
+ * Closes every cached DB connection (best-effort) and clears the cache. Normally only reached via
+ * the SIGINT/SIGTERM shutdown handlers below; exported so tests can release a fixture's cached
+ * connection between cases instead of leaking a locked `brain.db` handle until the test process exits.
  */
-export declare function runHttpMcpServer(port?: number): Promise<void>;
+export declare function cleanup(): void;
+/**
+ * Creates and wires up a DevsMind MCP Server instance.
+ * When the process is bound to one project (`bindDevmindPath`, the normal `devsmind start` path),
+ * every tool serves that brain and no `devmind_path` arg is required or advertised. Unbound (the
+ * in-process test path, or a server started with no brain to auto-detect), it falls back to the
+ * legacy behavior: each call carries `devmind_path` and opens the db from there.
+ * Exported so tests can drive tools in-process (e.g. via an InMemoryTransport pair) without
+ * binding a real port.
+ */
+export declare function createMcpServer(): Server;
+/**
+ * Builds the Express app (view UI + activity/revert APIs + the stateless /mcp endpoint) without
+ * binding a port. Exported so tests can drive it in-process via supertest; `runHttpMcpServer`
+ * below is the only caller that actually `listen()`s on it.
+ */
+export declare function createHttpApp(port?: number): express.Application;
+export declare function runHttpMcpServer(port?: number, devmindPath?: string): Promise<void>;
 /**
  * Start DevsMind as a stdio MCP server.
  * Used when an IDE manages the process directly (e.g. Cursor stdio plugin mode).
  */
-export declare function runStdioMcpServer(): void;
+export declare function runStdioMcpServer(devmindPath?: string): void;
 /** @deprecated Use runHttpMcpServer() or runStdioMcpServer() directly */
 export declare function runMcpServer(): void;