@vinaes/succ 1.3.19

package/dist/mcp/tools/graph.js

@@ -0,0 +1,337 @@
+/**
+ * MCP Knowledge Graph tools
+ *
+ * - succ_link: Create/manage memory links (knowledge graph)
+ * - succ_explore: Explore connected memories
+ */
+import { z } from 'zod';
+import { createMemoryLink, deleteMemoryLink, getMemoryWithLinks, findConnectedMemories, autoLinkSimilarMemories, getGraphStats, getMemoryById, LINK_RELATIONS, closeDb, } from '../../lib/storage/index.js';
+import { projectPathParam, applyProjectPath } from '../helpers.js';
+export function registerGraphTools(server) {
+    // Tool: succ_link - Create/manage memory links (knowledge graph)
+    server.tool('succ_link', 'Create or manage links between memories to build a knowledge graph. Links help track relationships between decisions, learnings, and context.', {
+        action: z
+            .enum([
+            'create',
+            'delete',
+            'show',
+            'graph',
+            'auto',
+            'enrich',
+            'proximity',
+            'communities',
+            'centrality',
+            'export',
+            'cleanup',
+        ])
+            .describe('Action: create (new link), delete (remove link), show (memory with links), graph (stats), auto (auto-link similar), enrich (LLM classify relations), proximity (co-occurrence links), communities (detect clusters), centrality (compute scores), export (Obsidian/JSON graph export), cleanup (prune weak links, enrich, connect orphans, rebuild communities + centrality)'),
+        source_id: z.number().optional().describe('Source memory ID (for create/delete/show)'),
+        target_id: z.number().optional().describe('Target memory ID (for create/delete)'),
+        relation: z
+            .enum(LINK_RELATIONS)
+            .optional()
+            .describe('Relation type: related, caused_by, leads_to, similar_to, contradicts, implements, supersedes, references'),
+        threshold: z
+            .number()
+            .optional()
+            .describe('Similarity threshold for auto-linking (default: 0.75)'),
+        project_path: projectPathParam,
+    }, async ({ action, source_id, target_id, relation, threshold, project_path }) => {
+        await applyProjectPath(project_path);
+        try {
+            switch (action) {
+                case 'create': {
+                    if (!source_id || !target_id) {
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: 'Both source_id and target_id are required to create a link.',
+                                },
+                            ],
+                        };
+                    }
+                    const result = await createMemoryLink(source_id, target_id, relation || 'related');
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: result.created
+                                    ? `Created link: memory #${source_id} --[${relation || 'related'}]--> memory #${target_id}`
+                                    : `Link already exists (id: ${result.id})`,
+                            },
+                        ],
+                    };
+                }
+                case 'delete': {
+                    if (!source_id || !target_id) {
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: 'Both source_id and target_id are required to delete a link.',
+                                },
+                            ],
+                        };
+                    }
+                    const deleted = await deleteMemoryLink(source_id, target_id, relation);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: deleted
+                                    ? `Deleted link between memory #${source_id} and #${target_id}`
+                                    : 'No matching link found.',
+                            },
+                        ],
+                    };
+                }
+                case 'show': {
+                    if (!source_id) {
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: 'source_id is required to show a memory with its links.',
+                                },
+                            ],
+                        };
+                    }
+                    const memory = await getMemoryWithLinks(source_id);
+                    if (!memory) {
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: `Memory #${source_id} not found.`,
+                                },
+                            ],
+                        };
+                    }
+                    const outLinks = memory.outgoing_links.length > 0
+                        ? memory.outgoing_links
+                            .map((l) => `  → #${l.target_id} (${l.relation})`)
+                            .join('\n')
+                        : '  (none)';
+                    const inLinks = memory.incoming_links.length > 0
+                        ? memory.incoming_links
+                            .map((l) => `  ← #${l.source_id} (${l.relation})`)
+                            .join('\n')
+                        : '  (none)';
+                    const text = `Memory #${memory.id}:
+${memory.content.substring(0, 200)}${memory.content.length > 200 ? '...' : ''}
+
+Tags: ${memory.tags.length > 0 ? memory.tags.join(', ') : '(none)'}
+Created: ${new Date(memory.created_at).toLocaleString()}
+
+Outgoing links:
+${outLinks}
+
+Incoming links:
+${inLinks}`;
+                    return {
+                        content: [{ type: 'text', text }],
+                    };
+                }
+                case 'graph': {
+                    const stats = await getGraphStats();
+                    const relationStats = Object.entries(stats.relations)
+                        .map(([r, c]) => `  ${r}: ${c}`)
+                        .join('\n') || '  (no links)';
+                    const text = `Knowledge Graph Statistics:
+
+Memories: ${stats.total_memories}
+Links: ${stats.total_links}
+Avg links/memory: ${stats.avg_links_per_memory.toFixed(2)}
+Isolated (no links): ${stats.isolated_memories}
+
+Links by relation:
+${relationStats}`;
+                    return {
+                        content: [{ type: 'text', text }],
+                    };
+                }
+                case 'auto': {
+                    const th = threshold || 0.75;
+                    const created = await autoLinkSimilarMemories(th, 3);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Auto-linked similar memories (threshold: ${th}). Created ${created} new links.`,
+                            },
+                        ],
+                    };
+                }
+                case 'enrich': {
+                    const { enrichExistingLinks } = await import('../../lib/graph/llm-relations.js');
+                    const result = await enrichExistingLinks({ batchSize: 5 });
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `LLM relation enrichment: ${result.enriched} enriched, ${result.failed} failed, ${result.skipped} skipped.`,
+                            },
+                        ],
+                    };
+                }
+                case 'proximity': {
+                    const { createProximityLinks } = await import('../../lib/graph/contextual-proximity.js');
+                    const result = await createProximityLinks({ minCooccurrence: 2 });
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Contextual proximity: ${result.created} links created, ${result.skipped} skipped (${result.total_pairs} pairs found).`,
+                            },
+                        ],
+                    };
+                }
+                case 'communities': {
+                    const { detectCommunities } = await import('../../lib/graph/community-detection.js');
+                    const result = await detectCommunities();
+                    const summary = result.communities
+                        .map((c) => `  Community ${c.id}: ${c.size} members`)
+                        .join('\n');
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Detected ${result.communities.length} communities, ${result.isolated} isolated nodes.\n${summary}`,
+                            },
+                        ],
+                    };
+                }
+                case 'centrality': {
+                    const { updateCentralityCache } = await import('../../lib/graph/centrality.js');
+                    const result = await updateCentralityCache();
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Updated centrality scores for ${result.updated} memories.`,
+                            },
+                        ],
+                    };
+                }
+                case 'export': {
+                    const { exportGraphSilent } = await import('../../lib/graph-export.js');
+                    const result = await exportGraphSilent('obsidian');
+                    if (result.memoriesExported === 0) {
+                        return {
+                            content: [{ type: 'text', text: 'No memories to export.' }],
+                        };
+                    }
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Exported ${result.memoriesExported} memories and ${result.linksExported} links to Obsidian brain vault.`,
+                            },
+                        ],
+                    };
+                }
+                case 'cleanup': {
+                    const { graphCleanup } = await import('../../lib/graph/cleanup.js');
+                    const result = await graphCleanup({
+                        pruneThreshold: threshold,
+                    });
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Graph cleanup complete:\n  Pruned: ${result.pruned}\n  Enriched: ${result.enriched}\n  Orphans connected: ${result.orphansConnected}\n  Communities: ${result.communitiesDetected}\n  Centrality updated: ${result.centralityUpdated}`,
+                            },
+                        ],
+                    };
+                }
+                default:
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'Unknown action. Use: create, delete, show, graph, auto, enrich, proximity, communities, centrality, export, or cleanup.',
+                            },
+                        ],
+                    };
+            }
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        finally {
+            closeDb();
+        }
+    });
+    // Tool: succ_explore - Explore connected memories
+    server.tool('succ_explore', 'Explore the knowledge graph starting from a memory. Find connected memories through links.', {
+        memory_id: z.number().describe('Starting memory ID'),
+        depth: z.number().optional().default(2).describe('Max traversal depth (default: 2)'),
+        project_path: projectPathParam,
+    }, async ({ memory_id, depth, project_path }) => {
+        await applyProjectPath(project_path);
+        try {
+            const connected = await findConnectedMemories(memory_id, depth);
+            if (connected.length === 0) {
+                const memory = await getMemoryById(memory_id);
+                if (!memory) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Memory #${memory_id} not found.`,
+                            },
+                        ],
+                    };
+                }
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Memory #${memory_id} has no connections within ${depth} hops.\n\nContent: ${memory.content.substring(0, 200)}...`,
+                        },
+                    ],
+                };
+            }
+            const formatted = connected
+                .map(({ memory, depth: d, path: memPath }) => {
+                const pathStr = memPath.map((id) => `#${id}`).join(' → ');
+                return `[Depth ${d}] Memory #${memory.id} (${pathStr})
+  ${memory.content.substring(0, 150)}${memory.content.length > 150 ? '...' : ''}
+  Tags: ${memory.tags.join(', ') || '(none)'}`;
+            })
+                .join('\n\n');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Found ${connected.length} connected memories from #${memory_id} (max depth: ${depth}):\n\n${formatted}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error exploring: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        finally {
+            closeDb();
+        }
+    });
+}
+//# sourceMappingURL=graph.js.map

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

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

package/dist/mcp/tools/indexing.d.ts

@@ -0,0 +1,12 @@
+/**
+ * MCP Indexing tools
+ *
+ * - succ_index_file: Index a single documentation file
+ * - succ_analyze_file: Analyze a source file and generate documentation
+ * - succ_index_code_file: Index a single source code file
+ * - succ_reindex: Detect and fix stale/deleted index entries
+ * - succ_symbols: Extract AST symbols from a source file
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerIndexingTools(server: McpServer): void;
+//# sourceMappingURL=indexing.d.ts.map

package/dist/mcp/tools/indexing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexing.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/indexing.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,QA2TtD"}

package/dist/mcp/tools/indexing.js

@@ -0,0 +1,289 @@
+/**
+ * MCP Indexing tools
+ *
+ * - succ_index_file: Index a single documentation file
+ * - succ_analyze_file: Analyze a source file and generate documentation
+ * - succ_index_code_file: Index a single source code file
+ * - succ_reindex: Detect and fix stale/deleted index entries
+ * - succ_symbols: Extract AST symbols from a source file
+ */
+import { z } from 'zod';
+import { analyzeFile } from '../../commands/analyze.js';
+import { projectPathParam, applyProjectPath } from '../helpers.js';
+export function registerIndexingTools(server) {
+    // Tool: succ_index_file - Index a single documentation file
+    server.tool('succ_index_file', 'Index a single file for semantic search. Faster than full reindex for small changes. Embedding modes (configured via config.json): local (Transformers.js, default), openrouter (cloud API), custom (Ollama/LM Studio/llama.cpp).', {
+        file: z.string().describe('Path to the file to index'),
+        force: z.boolean().optional().default(false).describe('Force reindex even if unchanged'),
+        project_path: projectPathParam,
+    }, async ({ file, force, project_path }) => {
+        await applyProjectPath(project_path);
+        try {
+            const { indexDocFile } = await import('../../commands/index.js');
+            const result = await indexDocFile(file, { force });
+            if (!result.success) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: result.error || 'Failed to index file',
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            if (result.skipped) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Skipped: ${result.reason}`,
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Indexed: ${file} (${result.chunks} chunks)`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error indexing file: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // Tool: succ_analyze_file - Analyze a single file and generate documentation
+    server.tool('succ_analyze_file', 'Analyze a single source file and generate documentation in brain vault. Modes: claude (CLI with Haiku), local (Ollama/LM Studio), openrouter (cloud API). Check succ_status first - if analyze daemon is running, it handles this automatically.', {
+        file: z.string().describe('Path to the file to analyze'),
+        mode: z
+            .enum(['claude', 'api'])
+            .optional()
+            .describe('claude = Claude CLI (Haiku), api = any OpenAI-compatible endpoint (default: from config)'),
+        project_path: projectPathParam,
+    }, async ({ file, mode, project_path }) => {
+        await applyProjectPath(project_path);
+        try {
+            const result = await analyzeFile(file, { mode });
+            if (result.success) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Analyzed: ${file}\nOutput: ${result.outputPath}`,
+                        },
+                    ],
+                };
+            }
+            else {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error analyzing file: ${result.error}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error analyzing file: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // Tool: succ_index_code_file - Index a single code file
+    server.tool('succ_index_code_file', 'Index a single source code file for semantic search. Faster than full index-code for small changes. Embedding modes (configured via config.json): local (Transformers.js, default), openrouter (cloud API), custom (Ollama/LM Studio/llama.cpp).', {
+        file: z.string().describe('Path to the code file to index'),
+        force: z.boolean().optional().default(false).describe('Force reindex even if unchanged'),
+        project_path: projectPathParam,
+    }, async ({ file, force, project_path }) => {
+        await applyProjectPath(project_path);
+        try {
+            const { indexCodeFile } = await import('../../commands/index-code.js');
+            const result = await indexCodeFile(file, { force });
+            if (!result.success) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: result.error || 'Failed to index file',
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            if (result.skipped) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Skipped: ${result.reason}`,
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Indexed: ${file} (${result.chunks} chunks)`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error indexing code file: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // Tool: succ_reindex - Detect and fix stale/deleted index entries
+    server.tool('succ_reindex', 'Detect stale (modified) and deleted files in the index, then re-index stale files and clean up deleted entries. Uses mtime + hash comparison for efficient detection.', {
+        project_path: projectPathParam,
+    }, async ({ project_path }) => {
+        await applyProjectPath(project_path);
+        try {
+            const { getProjectRoot } = await import('../../lib/config.js');
+            const { reindexFiles } = await import('../../commands/reindex.js');
+            const projectRoot = getProjectRoot();
+            const result = await reindexFiles(projectRoot);
+            if (result.reindexed === 0 && result.cleaned === 0 && result.errors === 0) {
+                return {
+                    content: [
+                        { type: 'text', text: `All ${result.total} indexed files are up to date.` },
+                    ],
+                };
+            }
+            const lines = [...result.details];
+            if (result.reindexed > 0)
+                lines.push(`Reindexed: ${result.reindexed}`);
+            if (result.cleaned > 0)
+                lines.push(`Cleaned: ${result.cleaned} deleted entries`);
+            if (result.errors > 0)
+                lines.push(`Errors: ${result.errors}`);
+            return {
+                content: [{ type: 'text', text: lines.join('\n') }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error during reindex: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // Tool: succ_symbols - Extract AST symbols from a source file using tree-sitter
+    server.tool('succ_symbols', 'Extract functions, classes, interfaces, and type definitions from a source file using tree-sitter AST parsing. Returns symbol names, types, signatures, and line numbers. Supports 13 languages: TypeScript, JavaScript, Python, Go, Rust, Java, Kotlin, C, C++, C#, PHP, Ruby, Swift.', {
+        file: z.string().describe('Path to the source file to extract symbols from'),
+        type: z
+            .enum(['all', 'function', 'method', 'class', 'interface', 'type_alias'])
+            .optional()
+            .default('all')
+            .describe('Filter by symbol type (default: all)'),
+        project_path: projectPathParam,
+    }, async ({ file, type, project_path }) => {
+        await applyProjectPath(project_path);
+        try {
+            const fs = await import('fs');
+            const path = await import('path');
+            const absolutePath = path.default.resolve(file);
+            if (!fs.default.existsSync(absolutePath)) {
+                return {
+                    content: [{ type: 'text', text: `File not found: ${file}` }],
+                    isError: true,
+                };
+            }
+            const content = fs.default.readFileSync(absolutePath, 'utf-8');
+            const { parseCode } = await import('../../lib/tree-sitter/parser.js');
+            const { extractSymbols } = await import('../../lib/tree-sitter/extractor.js');
+            const { getLanguageForExtension } = await import('../../lib/tree-sitter/types.js');
+            const ext = absolutePath.split('.').pop() || '';
+            const language = getLanguageForExtension(ext);
+            if (!language) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Unsupported language for extension .${ext}. Supported: ts, js, py, go, rs, java, kt, c, cpp, cs, php, rb, swift`,
+                        },
+                    ],
+                };
+            }
+            const tree = await parseCode(content, language);
+            if (!tree) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Failed to parse ${file} — tree-sitter grammar not available for ${language}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            try {
+                let symbols = await extractSymbols(tree, content, language);
+                if (type !== 'all') {
+                    symbols = symbols.filter((s) => s.type === type);
+                }
+                if (symbols.length === 0) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `No ${type === 'all' ? '' : type + ' '}symbols found in ${file}`,
+                            },
+                        ],
+                    };
+                }
+                const lines = symbols.map((s) => {
+                    const sig = s.signature ? `: ${s.signature}` : '';
+                    const doc = s.docComment ? ` — ${s.docComment.split('\n')[0]}` : '';
+                    return `  ${s.type} **${s.name}**${sig} (L${s.startRow + 1}-${s.endRow + 1})${doc}`;
+                });
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `${symbols.length} symbols in ${file} (${language}):\n\n${lines.join('\n')}`,
+                        },
+                    ],
+                };
+            }
+            finally {
+                tree.delete();
+            }
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error extracting symbols: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=indexing.js.map