ai-mind-map 1.1.0

package/dist/tools/graph-tools.js

@@ -0,0 +1,165 @@
+/**
+ * AI Mind Map — Knowledge Graph MCP Tools
+ *
+ * Registers all knowledge-graph-related tools on the MCP server.
+ * Each tool returns structured JSON data wrapped in the standard
+ * MCP text-content envelope.
+ */
+import { z } from 'zod';
+/** Simple 4-chars-per-token estimator used as default. */
+const defaultEstimator = {
+    estimate: (text) => Math.ceil(text.length / 4),
+};
+// ============================================================
+// Helpers
+// ============================================================
+/**
+ * Wrap a ToolResult in the MCP text-content format.
+ */
+function mcpText(result) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result) }],
+    };
+}
+/**
+ * Build a successful ToolResult.
+ */
+function ok(data, estimator) {
+    const serialised = JSON.stringify(data);
+    const tokens = estimator.estimate(serialised);
+    return { success: true, data, tokenCount: tokens, tokensSaved: 0 };
+}
+/**
+ * Build an error ToolResult.
+ */
+function fail(message) {
+    return { success: false, data: null, tokenCount: 0, tokensSaved: 0, message };
+}
+// ============================================================
+// Node type enum values for Zod
+// ============================================================
+const NODE_TYPES = [
+    'file', 'function', 'class', 'method', 'interface', 'type_alias',
+    'enum', 'variable', 'constant', 'module', 'namespace', 'property',
+    'constructor', 'decorator', 'route', 'component', 'hook', 'test', 'config',
+];
+// ============================================================
+// Registration
+// ============================================================
+/**
+ * Register all Knowledge Graph tools on the given MCP server.
+ *
+ * @param server   The MCP server instance.
+ * @param graph    Concrete knowledge-graph implementation.
+ * @param estimator  Optional token estimator (defaults to 4-char heuristic).
+ */
+export function registerGraphTools(server, graph, estimator = defaultEstimator) {
+    // ── mindmap_search ──────────────────────────────────────────
+    server.tool('mindmap_search', 'Search the codebase by symbol name, type, or free-text query. Returns matching nodes with their signatures.', {
+        query: z.string().describe('Search query (name, keyword, or free text)'),
+        type: z.enum(NODE_TYPES).optional().describe('Optional node-type filter'),
+        limit: z.number().int().min(1).max(100).default(20).describe('Max results to return'),
+    }, async ({ query, type, limit }) => {
+        try {
+            const nodes = graph.search(query, type, limit);
+            return mcpText(ok(nodes, estimator));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return mcpText(fail(`Search failed: ${msg}`));
+        }
+    });
+    // ── mindmap_get_structure ───────────────────────────────────
+    server.tool('mindmap_get_structure', 'Get the project architecture overview — file tree with top-level symbols per file.', {
+        depth: z
+            .number()
+            .int()
+            .min(1)
+            .max(3)
+            .default(2)
+            .describe('Directory tree depth (1-3)'),
+    }, async ({ depth }) => {
+        try {
+            const structure = graph.getStructure(depth);
+            return mcpText(ok(structure, estimator));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return mcpText(fail(`Get structure failed: ${msg}`));
+        }
+    });
+    // ── mindmap_trace_dependencies ──────────────────────────────
+    server.tool('mindmap_trace_dependencies', 'Trace the dependency chain of a symbol — who calls it, what it calls, or both.', {
+        symbolName: z.string().describe('Qualified or simple symbol name'),
+        direction: z
+            .enum(['callers', 'callees', 'both'])
+            .default('both')
+            .describe('Direction to trace'),
+        depth: z
+            .number()
+            .int()
+            .min(1)
+            .max(10)
+            .default(3)
+            .describe('Max depth of traversal'),
+    }, async ({ symbolName, direction, depth }) => {
+        try {
+            const result = graph.traceDependencies(symbolName, direction, depth);
+            return mcpText(ok(result, estimator));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return mcpText(fail(`Trace dependencies failed: ${msg}`));
+        }
+    });
+    // ── mindmap_get_signature ───────────────────────────────────
+    server.tool('mindmap_get_signature', 'Get the full signature of a function or class (parameters, return type, doc comment) — without the body.', {
+        symbolName: z.string().describe('Name of the symbol to look up'),
+        filePath: z
+            .string()
+            .optional()
+            .describe('Optional file path to disambiguate'),
+    }, async ({ symbolName, filePath }) => {
+        try {
+            const result = graph.getSignature(symbolName, filePath);
+            if (!result) {
+                return mcpText(fail(`Symbol not found: ${symbolName}`));
+            }
+            return mcpText(ok(result, estimator));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return mcpText(fail(`Get signature failed: ${msg}`));
+        }
+    });
+    // ── mindmap_find_references ─────────────────────────────────
+    server.tool('mindmap_find_references', 'Find every location where a symbol is referenced across the codebase.', {
+        symbolName: z.string().describe('Name of the symbol to find references for'),
+    }, async ({ symbolName }) => {
+        try {
+            const result = graph.findReferences(symbolName);
+            return mcpText(ok(result, estimator));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return mcpText(fail(`Find references failed: ${msg}`));
+        }
+    });
+    // ── mindmap_get_file_map ────────────────────────────────────
+    server.tool('mindmap_get_file_map', 'Get the structural map of a specific file — all symbols with their signatures, visibility, and line ranges.', {
+        filePath: z.string().describe('Relative or absolute path to the file'),
+    }, async ({ filePath }) => {
+        try {
+            const result = graph.getFileMap(filePath);
+            if (!result) {
+                return mcpText(fail(`File not found in index: ${filePath}`));
+            }
+            return mcpText(ok(result, estimator));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return mcpText(fail(`Get file map failed: ${msg}`));
+        }
+    });
+}
+//# sourceMappingURL=graph-tools.js.map

package/dist/tools/graph-tools.js.map

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

package/dist/tools/memory-tools.d.ts

@@ -0,0 +1,62 @@
+/**
+ * AI Mind Map — Memory MCP Tools
+ *
+ * Registers all memory-related tools on the MCP server.
+ * Covers both episodic memories and architectural decisions.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Memory, MemoryCategory, Decision, SessionSummary } from '../types.js';
+/**
+ * Minimal interface expected of the Memory Store subsystem.
+ */
+export interface IMemoryStore {
+    /** Retrieve memories matching a query, ranked by importance. */
+    recall(query: string, category?: MemoryCategory, limit?: number): Memory[];
+    /** Store a new memory. Returns the created memory. */
+    remember(params: {
+        content: string;
+        category: MemoryCategory;
+        tags: string[];
+        relatedFiles: string[];
+        importance?: number;
+        sessionId: string;
+        source: 'agent' | 'user' | 'auto';
+    }): Memory;
+    /** Retrieve architectural decisions. */
+    getDecisions(params: {
+        status?: 'active' | 'all';
+        query?: string;
+    }): Decision[];
+    /** Record a new decision. Returns the created decision. */
+    decide(params: {
+        title: string;
+        description: string;
+        rationale: string;
+        alternatives: string[];
+        consequences: string[];
+        relatedFiles: string[];
+        tags: string[];
+        decidedBy: string;
+    }): Decision;
+    /** Get summaries of previous AI sessions, most recent first. */
+    getSessionSummaries(count: number): SessionSummary[];
+}
+/**
+ * Provides the current session ID for tagging new memories.
+ */
+export interface ISessionProvider {
+    currentSessionId(): string;
+}
+export interface ITokenEstimator {
+    estimate(text: string): number;
+}
+/**
+ * Register all Memory tools on the given MCP server.
+ *
+ * @param server    The MCP server instance.
+ * @param store     Concrete memory-store implementation.
+ * @param session   Provides the current session ID.
+ * @param estimator Optional token estimator.
+ */
+export declare function registerMemoryTools(server: McpServer, store: IMemoryStore, session: ISessionProvider, estimator?: ITokenEstimator): void;
+//# sourceMappingURL=memory-tools.d.ts.map

package/dist/tools/memory-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-tools.d.ts","sourceRoot":"","sources":["../../src/tools/memory-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EACV,MAAM,EACN,cAAc,EACd,QAAQ,EACR,cAAc,EAEf,MAAM,aAAa,CAAC;AAMrB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE3E,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,cAAc,CAAC;QACzB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;KACnC,GAAG,MAAM,CAAC;IAEX,wCAAwC;IACxC,YAAY,CAAC,MAAM,EAAE;QACnB,MAAM,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,QAAQ,EAAE,CAAC;IAEf,2DAA2D;IAC3D,MAAM,CAAC,MAAM,EAAE;QACb,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,QAAQ,CAAC;IAEb,gEAAgE;IAChE,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,IAAI,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC;AA+CD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,gBAAgB,EACzB,SAAS,GAAE,eAAkC,GAC5C,IAAI,CAuLN"}

package/dist/tools/memory-tools.js

@@ -0,0 +1,195 @@
+/**
+ * AI Mind Map — Memory MCP Tools
+ *
+ * Registers all memory-related tools on the MCP server.
+ * Covers both episodic memories and architectural decisions.
+ */
+import { z } from 'zod';
+const defaultEstimator = {
+    estimate: (text) => Math.ceil(text.length / 4),
+};
+// ============================================================
+// Memory category enum for Zod
+// ============================================================
+const MEMORY_CATEGORIES = [
+    'architecture',
+    'convention',
+    'decision',
+    'gotcha',
+    'dependency',
+    'workflow',
+    'context',
+    'preference',
+    'lesson_learned',
+    'todo',
+];
+// ============================================================
+// Helpers
+// ============================================================
+function mcpText(result) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result) }],
+    };
+}
+function ok(data, estimator) {
+    const serialised = JSON.stringify(data);
+    const tokens = estimator.estimate(serialised);
+    return { success: true, data, tokenCount: tokens, tokensSaved: 0 };
+}
+function fail(message) {
+    return { success: false, data: null, tokenCount: 0, tokensSaved: 0, message };
+}
+// ============================================================
+// Registration
+// ============================================================
+/**
+ * Register all Memory tools on the given MCP server.
+ *
+ * @param server    The MCP server instance.
+ * @param store     Concrete memory-store implementation.
+ * @param session   Provides the current session ID.
+ * @param estimator Optional token estimator.
+ */
+export function registerMemoryTools(server, store, session, estimator = defaultEstimator) {
+    // ── mindmap_recall ──────────────────────────────────────────
+    server.tool('mindmap_recall', 'Retrieve relevant memories for the current task, ranked by importance.', {
+        query: z.string().describe('Describe what you need to recall'),
+        category: z
+            .enum(MEMORY_CATEGORIES)
+            .optional()
+            .describe('Optional category filter'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(50)
+            .default(10)
+            .describe('Max memories to return'),
+    }, async ({ query, category, limit }) => {
+        try {
+            const memories = store.recall(query, category, limit);
+            return mcpText(ok(memories, estimator));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return mcpText(fail(`Recall failed: ${msg}`));
+        }
+    });
+    // ── mindmap_remember ────────────────────────────────────────
+    server.tool('mindmap_remember', 'Store an important fact, decision, or convention for future reference.', {
+        content: z.string().min(1).describe('The fact or insight to remember'),
+        category: z.enum(MEMORY_CATEGORIES).describe('Memory category'),
+        tags: z.array(z.string()).describe('Tags for retrieval'),
+        relatedFiles: z
+            .array(z.string())
+            .describe('File paths this memory relates to'),
+        importance: z
+            .number()
+            .min(0)
+            .max(1)
+            .optional()
+            .describe('Importance score 0-1 (default: auto-calculated)'),
+    }, async ({ content, category, tags, relatedFiles, importance }) => {
+        try {
+            const memory = store.remember({
+                content,
+                category,
+                tags,
+                relatedFiles,
+                importance,
+                sessionId: session.currentSessionId(),
+                source: 'agent',
+            });
+            return mcpText(ok({
+                id: memory.id,
+                message: 'Memory stored successfully',
+                category: memory.category,
+                importance: memory.importance,
+            }, estimator));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return mcpText(fail(`Remember failed: ${msg}`));
+        }
+    });
+    // ── mindmap_get_decisions ───────────────────────────────────
+    server.tool('mindmap_get_decisions', 'Retrieve architectural and technical decisions. Useful for understanding why things were built a certain way.', {
+        status: z
+            .enum(['active', 'all'])
+            .optional()
+            .default('active')
+            .describe("Filter by status: 'active' (default) or 'all'"),
+        query: z
+            .string()
+            .optional()
+            .describe('Optional search query to filter decisions'),
+    }, async ({ status, query }) => {
+        try {
+            const decisions = store.getDecisions({ status, query });
+            return mcpText(ok(decisions, estimator));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return mcpText(fail(`Get decisions failed: ${msg}`));
+        }
+    });
+    // ── mindmap_decide ──────────────────────────────────────────
+    server.tool('mindmap_decide', 'Record a new architectural or technical decision with rationale, alternatives, and consequences.', {
+        title: z.string().min(1).describe('Short title for the decision'),
+        description: z.string().min(1).describe('Detailed description'),
+        rationale: z.string().min(1).describe('Why this option was chosen'),
+        alternatives: z
+            .array(z.string())
+            .describe('Other options that were considered'),
+        consequences: z
+            .array(z.string())
+            .describe('Known trade-offs or downstream effects'),
+        relatedFiles: z
+            .array(z.string())
+            .describe('Files affected by this decision'),
+        tags: z.array(z.string()).describe('Tags for retrieval'),
+    }, async ({ title, description, rationale, alternatives, consequences, relatedFiles, tags, }) => {
+        try {
+            const decision = store.decide({
+                title,
+                description,
+                rationale,
+                alternatives,
+                consequences,
+                relatedFiles,
+                tags,
+                decidedBy: session.currentSessionId(),
+            });
+            return mcpText(ok({
+                id: decision.id,
+                message: 'Decision recorded successfully',
+                title: decision.title,
+                status: decision.status,
+            }, estimator));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return mcpText(fail(`Decide failed: ${msg}`));
+        }
+    });
+    // ── mindmap_session_summary ─────────────────────────────────
+    server.tool('mindmap_session_summary', 'Get summaries of previous AI sessions — what was done, what changed, and what was decided.', {
+        count: z
+            .number()
+            .int()
+            .min(1)
+            .max(20)
+            .default(3)
+            .describe('Number of recent sessions to return'),
+    }, async ({ count }) => {
+        try {
+            const summaries = store.getSessionSummaries(count);
+            return mcpText(ok(summaries, estimator));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return mcpText(fail(`Session summary failed: ${msg}`));
+        }
+    });
+}
+//# sourceMappingURL=memory-tools.js.map

package/dist/tools/memory-tools.js.map

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

package/dist/tools/smart-tools.d.ts

@@ -0,0 +1,23 @@
+/**
+ * AI Mind Map — Smart MCP Tools
+ *
+ * The "never read files again" toolkit. These tools aggregate multiple
+ * data sources into single, rich responses so the AI never needs to
+ * chain tool calls or fall back to reading raw files.
+ *
+ * Tools:
+ *   - mindmap_explain     — Complete intelligence on any symbol in 1 call
+ *   - mindmap_git_changes — Git-aware symbol-level change detection
+ *   - mindmap_smart_search — Rich contextual search with full details
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { MindMapConfig } from '../types.js';
+import { KnowledgeGraph } from '../knowledge-graph/graph.js';
+export interface ITokenEstimator {
+    estimate(text: string): number;
+}
+/**
+ * Register Smart tools — the "never read files" toolkit.
+ */
+export declare function registerSmartTools(server: McpServer, graph: KnowledgeGraph, config: MindMapConfig, estimator?: ITokenEstimator): void;
+//# sourceMappingURL=smart-tools.d.ts.map

package/dist/tools/smart-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-tools.d.ts","sourceRoot":"","sources":["../../src/tools/smart-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAc,aAAa,EAAwB,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAO7D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC;AAmDD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,aAAa,EACrB,SAAS,GAAE,eAAkC,GAC5C,IAAI,CA2fN"}