@graphmemory/server 1.1.0 → 1.2.0

package/dist/api/tools/tasks/find-linked-tasks.js

@@ -10,7 +10,7 @@ function register(server, mgr) {
             'Use get_task to fetch full content of a returned task.',
         inputSchema: {
             targetId: zod_1.z.string().describe('Target node ID in the external graph'),
-            targetGraph: zod_1.z.enum(['docs', 'code', 'files', 'knowledge'])
+            targetGraph: zod_1.z.enum(['docs', 'code', 'files', 'knowledge', 'skills'])
                 .describe('Which graph the target belongs to'),
             kind: zod_1.z.string().optional().describe('Filter by relation kind. If omitted, returns all relations.'),
             projectId: zod_1.z.string().optional().describe('Project ID that the target node belongs to. Defaults to the current project.'),

package/dist/cli/index.js

@@ -13,55 +13,22 @@ const multi_config_1 = require("../lib/multi-config");
 const jwt_1 = require("../lib/jwt");
 const project_manager_1 = require("../lib/project-manager");
 const embedder_1 = require("../lib/embedder");
-const docs_1 = require("../graphs/docs");
-const code_1 = require("../graphs/code");
-const knowledge_1 = require("../graphs/knowledge");
-const file_index_1 = require("../graphs/file-index");
-const task_1 = require("../graphs/task");
-const skill_1 = require("../graphs/skill");
 const index_1 = require("../api/index");
-const indexer_1 = require("../cli/indexer");
-const watcher_1 = require("../lib/watcher");
 const program = new commander_1.Command();
 program
     .name('graphmemory')
     .description('MCP server for semantic graph memory from markdown docs and source code')
-    .version('1.1.0');
+    .version('1.2.0');
 const parseIntArg = (v) => parseInt(v, 10);
 // ---------------------------------------------------------------------------
-// Helper: resolve a single project from YAML config + --project flag
+// Helper: load config from file, or fall back to default (cwd as single project)
 // ---------------------------------------------------------------------------
-function resolveProject(configPath, projectId) {
-    const mc = (0, multi_config_1.loadMultiConfig)(configPath);
-    const ids = Array.from(mc.projects.keys());
-    if (ids.length === 0) {
-        process.stderr.write('[cli] No projects defined in config\n');
-        process.exit(1);
-    }
-    const id = projectId ?? ids[0];
-    const project = mc.projects.get(id);
-    if (!project) {
-        process.stderr.write(`[cli] Project "${id}" not found in config. Available: ${ids.join(', ')}\n`);
-        process.exit(1);
+function loadConfigOrDefault(configPath) {
+    if (fs_1.default.existsSync(configPath)) {
+        return (0, multi_config_1.loadMultiConfig)(configPath);
     }
-    return { id, project, server: mc.server };
-}
-async function loadAllModels(projectId, config, modelsDir) {
-    for (const gn of multi_config_1.GRAPH_NAMES) {
-        if (!config.graphConfigs[gn].enabled)
-            continue;
-        await (0, embedder_1.loadModel)(config.graphConfigs[gn].model, config.graphConfigs[gn].embedding, modelsDir, `${projectId}:${gn}`);
-    }
-}
-function buildEmbedFns(projectId) {
-    const pair = (gn) => ({
-        document: (q) => (0, embedder_1.embed)(q, '', `${projectId}:${gn}`),
-        query: (q) => (0, embedder_1.embedQuery)(q, `${projectId}:${gn}`),
-    });
-    return {
-        docs: pair('docs'), code: pair('code'), knowledge: pair('knowledge'),
-        tasks: pair('tasks'), files: pair('files'), skills: pair('skills'),
-    };
+    process.stderr.write(`[cli] Config "${configPath}" not found, using current directory as project\n`);
+    return (0, multi_config_1.defaultConfig)(process.cwd());
 }
 // ---------------------------------------------------------------------------
 // Command: index — scan one project and exit
@@ -74,7 +41,7 @@ program
     .option('--reindex', 'Discard persisted graphs and re-index from scratch')
     .action((opts) => {
     (async () => {
-        const mc = (0, multi_config_1.loadMultiConfig)(opts.config);
+        const mc = loadConfigOrDefault(opts.config);
         const reindex = !!opts.reindex;
         if (reindex)
             process.stderr.write('[index] Re-indexing from scratch\n');
@@ -139,172 +106,6 @@ program
     });
 });
 // ---------------------------------------------------------------------------
-// Command: mcp — single-project stdio mode
-// ---------------------------------------------------------------------------
-program
-    .command('mcp')
-    .description('Index one project (or workspace), keep watching for changes, and start MCP server on stdio')
-    .option('--config <path>', 'Path to graph-memory.yaml', 'graph-memory.yaml')
-    .option('--project <id>', 'Project ID (defaults to first project)')
-    .option('--workspace <id>', 'Workspace ID (loads all workspace projects with shared graphs)')
-    .option('--reindex', 'Discard persisted graphs and re-index from scratch')
-    .action(async (opts) => {
-    // Workspace mode: load all projects in the workspace with shared graphs
-    if (opts.workspace) {
-        const mc = (0, multi_config_1.loadMultiConfig)(opts.config);
-        const wsConfig = mc.workspaces.get(opts.workspace);
-        if (!wsConfig) {
-            process.stderr.write(`[mcp] Workspace "${opts.workspace}" not found in config. Available: ${Array.from(mc.workspaces.keys()).join(', ')}\n`);
-            process.exit(1);
-        }
-        const fresh = !!opts.reindex;
-        if (fresh)
-            process.stderr.write(`[mcp] Re-indexing workspace "${opts.workspace}" from scratch\n`);
-        const manager = new project_manager_1.ProjectManager(mc.server);
-        await manager.addWorkspace(opts.workspace, wsConfig, fresh);
-        for (const projId of wsConfig.projects) {
-            const projConfig = mc.projects.get(projId);
-            if (!projConfig) {
-                process.stderr.write(`[mcp] Project "${projId}" referenced by workspace not found\n`);
-                process.exit(1);
-            }
-            await manager.addProject(projId, projConfig, fresh, opts.workspace);
-        }
-        // Use specified project (or first) for stdio server
-        const targetId = opts.project ?? wsConfig.projects[0];
-        if (!wsConfig.projects.includes(targetId)) {
-            process.stderr.write(`[mcp] Project "${targetId}" is not part of workspace "${opts.workspace}"\n`);
-            process.exit(1);
-        }
-        const instance = manager.getProject(targetId);
-        const sessionCtx = {
-            projectId: targetId,
-            workspaceId: opts.workspace,
-            workspaceProjects: wsConfig.projects,
-        };
-        await (0, index_1.startStdioServer)(instance.docGraph, instance.codeGraph, instance.knowledgeGraph, instance.fileIndexGraph, instance.taskGraph, instance.embedFns, instance.config.projectDir, instance.skillGraph, sessionCtx);
-        // Load models and index in background
-        (async () => {
-            await manager.loadWorkspaceModels(opts.workspace);
-            for (const projId of wsConfig.projects) {
-                await manager.loadModels(projId);
-                await manager.startIndexing(projId);
-            }
-            await manager.startWorkspaceMirror(opts.workspace);
-            process.stderr.write(`[mcp] Workspace "${opts.workspace}" fully indexed\n`);
-        })().catch((err) => {
-            process.stderr.write(`[mcp] Workspace indexer error: ${err}\n`);
-        });
-        let shuttingDown = false;
-        async function shutdown() {
-            if (shuttingDown) {
-                process.stderr.write('[mcp] Force exit\n');
-                process.exit(1);
-            }
-            shuttingDown = true;
-            process.stderr.write('[mcp] Shutting down...\n');
-            const forceTimer = setTimeout(() => { process.stderr.write('[mcp] Shutdown timeout, force exit\n'); process.exit(1); }, 5000);
-            try {
-                await manager.shutdown();
-            }
-            catch { /* ignore */ }
-            clearTimeout(forceTimer);
-            // Let event loop drain naturally — avoids ONNX global thread pool destructor crash on macOS
-        }
-        process.on('SIGINT', () => { void shutdown(); });
-        process.on('SIGTERM', () => { void shutdown(); });
-        return;
-    }
-    const { id, project, server } = resolveProject(opts.config, opts.project);
-    const projectDir = path_1.default.resolve(project.projectDir);
-    const fresh = !!opts.reindex;
-    if (fresh)
-        process.stderr.write(`[mcp] Re-indexing project "${id}" from scratch\n`);
-    const gc = project.graphConfigs;
-    // Load persisted graphs (or create fresh ones if reindexing / model changed) and start MCP server immediately
-    const docGraph = gc.docs.enabled ? (0, docs_1.loadGraph)(project.graphMemory, fresh, (0, multi_config_1.embeddingFingerprint)(gc.docs.model)) : undefined;
-    const codeGraph = gc.code.enabled ? (0, code_1.loadCodeGraph)(project.graphMemory, fresh, (0, multi_config_1.embeddingFingerprint)(gc.code.model)) : undefined;
-    const knowledgeGraph = gc.knowledge.enabled ? (0, knowledge_1.loadKnowledgeGraph)(project.graphMemory, fresh, (0, multi_config_1.embeddingFingerprint)(gc.knowledge.model)) : undefined;
-    const fileIndexGraph = gc.files.enabled ? (0, file_index_1.loadFileIndexGraph)(project.graphMemory, fresh, (0, multi_config_1.embeddingFingerprint)(gc.files.model)) : undefined;
-    const taskGraph = gc.tasks.enabled ? (0, task_1.loadTaskGraph)(project.graphMemory, fresh, (0, multi_config_1.embeddingFingerprint)(gc.tasks.model)) : undefined;
-    const skillGraph = gc.skills.enabled ? (0, skill_1.loadSkillGraph)(project.graphMemory, fresh, (0, multi_config_1.embeddingFingerprint)(gc.skills.model)) : undefined;
-    const embedFns = buildEmbedFns(id);
-    const sessionCtx = { projectId: id };
-    await (0, index_1.startStdioServer)(docGraph, codeGraph, knowledgeGraph, fileIndexGraph, taskGraph, embedFns, project.projectDir, skillGraph, sessionCtx);
-    // Load models and start watcher in the background
-    let watcher;
-    let indexer;
-    async function startIndexing() {
-        await loadAllModels(id, project, server.modelsDir);
-        indexer = (0, indexer_1.createProjectIndexer)(docGraph, codeGraph, {
-            projectId: id,
-            projectDir,
-            docsInclude: gc.docs.enabled ? gc.docs.include : undefined,
-            docsExclude: gc.docs.exclude,
-            codeInclude: gc.code.enabled ? gc.code.include : undefined,
-            codeExclude: gc.code.exclude,
-            filesExclude: gc.files.exclude,
-            chunkDepth: project.chunkDepth,
-            maxFileSize: project.maxFileSize,
-            docsModelName: `${id}:docs`,
-            codeModelName: `${id}:code`,
-            filesModelName: `${id}:files`,
-        }, knowledgeGraph, fileIndexGraph, taskGraph, skillGraph);
-        watcher = indexer.watch();
-        await watcher.whenReady;
-        await indexer.drain();
-        if (docGraph) {
-            (0, docs_1.saveGraph)(docGraph, project.graphMemory, (0, multi_config_1.embeddingFingerprint)(gc.docs.model));
-            process.stderr.write(`[mcp] Docs indexed. ${docGraph.order} nodes, ${docGraph.size} edges.\n`);
-        }
-        if (codeGraph) {
-            (0, code_1.saveCodeGraph)(codeGraph, project.graphMemory, (0, multi_config_1.embeddingFingerprint)(gc.code.model));
-            process.stderr.write(`[mcp] Code indexed. ${codeGraph.order} nodes, ${codeGraph.size} edges.\n`);
-        }
-        if (fileIndexGraph) {
-            (0, file_index_1.saveFileIndexGraph)(fileIndexGraph, project.graphMemory, (0, multi_config_1.embeddingFingerprint)(gc.files.model));
-            process.stderr.write(`[mcp] File index done. ${fileIndexGraph.order} nodes, ${fileIndexGraph.size} edges.\n`);
-        }
-    }
-    startIndexing().catch((err) => {
-        process.stderr.write(`[mcp] Indexer error: ${err}\n`);
-    });
-    let shuttingDown = false;
-    async function shutdown() {
-        if (shuttingDown) {
-            process.stderr.write('[mcp] Force exit\n');
-            process.exit(1);
-        }
-        shuttingDown = true;
-        process.stderr.write('[mcp] Shutting down...\n');
-        const forceTimer = setTimeout(() => {
-            process.stderr.write('[mcp] Shutdown timeout, force exit\n');
-            process.exit(1);
-        }, 5000);
-        try {
-            if (watcher)
-                await watcher.close();
-            if (indexer)
-                await indexer.drain();
-            if (docGraph)
-                (0, docs_1.saveGraph)(docGraph, project.graphMemory, (0, multi_config_1.embeddingFingerprint)(gc.docs.model));
-            if (codeGraph)
-                (0, code_1.saveCodeGraph)(codeGraph, project.graphMemory, (0, multi_config_1.embeddingFingerprint)(gc.code.model));
-            if (knowledgeGraph)
-                (0, knowledge_1.saveKnowledgeGraph)(knowledgeGraph, project.graphMemory, (0, multi_config_1.embeddingFingerprint)(gc.knowledge.model));
-            if (fileIndexGraph)
-                (0, file_index_1.saveFileIndexGraph)(fileIndexGraph, project.graphMemory, (0, multi_config_1.embeddingFingerprint)(gc.files.model));
-            if (taskGraph)
-                (0, task_1.saveTaskGraph)(taskGraph, project.graphMemory, (0, multi_config_1.embeddingFingerprint)(gc.tasks.model));
-        }
-        catch { /* ignore */ }
-        clearTimeout(forceTimer);
-        // Let event loop drain naturally — avoids ONNX global thread pool destructor crash on macOS
-    }
-    process.on('SIGINT', () => { void shutdown(); });
-    process.on('SIGTERM', () => { void shutdown(); });
-});
-// ---------------------------------------------------------------------------
 // Command: serve — multi-project HTTP mode
 // ---------------------------------------------------------------------------
 program
@@ -315,7 +116,7 @@ program
     .option('--port <n>', 'HTTP server port', parseIntArg)
     .option('--reindex', 'Discard persisted graphs and re-index from scratch')
     .action(async (opts) => {
-    const mc = (0, multi_config_1.loadMultiConfig)(opts.config);
+    const mc = loadConfigOrDefault(opts.config);
     const host = opts.host ?? mc.server.host;
     const port = opts.port ?? mc.server.port;
     const sessionTimeoutMs = mc.server.sessionTimeout * 1000;
@@ -403,58 +204,6 @@ program
     initProjects().catch((err) => {
         process.stderr.write(`[serve] Init error: ${err}\n`);
     });
-    // Watch YAML config for hot-reload
-    let reloading = false;
-    const configWatcher = (0, watcher_1.startWatcher)(path_1.default.dirname(path_1.default.resolve(opts.config)), {
-        onAdd: () => { },
-        onChange: async (f) => {
-            if (path_1.default.resolve(f) !== path_1.default.resolve(opts.config))
-                return;
-            if (reloading)
-                return;
-            reloading = true;
-            try {
-                process.stderr.write('[serve] Config changed, reloading...\n');
-                const newMc = (0, multi_config_1.loadMultiConfig)(opts.config);
-                const currentIds = new Set(manager.listProjects());
-                const newIds = new Set(newMc.projects.keys());
-                // Remove projects no longer in config
-                for (const id of currentIds) {
-                    if (!newIds.has(id)) {
-                        await manager.removeProject(id);
-                    }
-                }
-                // Add new projects
-                for (const [id, config] of newMc.projects) {
-                    if (!currentIds.has(id)) {
-                        await manager.addProject(id, config);
-                        await manager.loadModels(id);
-                        await manager.startIndexing(id);
-                    }
-                }
-                // Re-add changed projects
-                for (const [id, config] of newMc.projects) {
-                    if (currentIds.has(id)) {
-                        const existing = manager.getProject(id);
-                        if (existing && JSON.stringify(existing.config) !== JSON.stringify(config)) {
-                            await manager.removeProject(id);
-                            await manager.addProject(id, config);
-                            await manager.loadModels(id);
-                            await manager.startIndexing(id);
-                        }
-                    }
-                }
-                process.stderr.write('[serve] Config reload complete\n');
-            }
-            catch (err) {
-                process.stderr.write(`[serve] Config reload error: ${err}\n`);
-            }
-            finally {
-                reloading = false;
-            }
-        },
-        onUnlink: () => { },
-    }, path_1.default.basename(opts.config));
     let shuttingDown = false;
     async function shutdown() {
         if (shuttingDown) {
@@ -475,7 +224,6 @@ program
                 socket.destroy();
             }
             openSockets.clear();
-            await configWatcher.close();
             await manager.shutdown();
         }
         catch { /* ignore */ }

package/dist/cli/indexer.js

@@ -226,7 +226,7 @@ function createProjectIndexer(docGraph, codeGraph, config, knowledgeGraph, fileI
     function scan() {
         function walk(dir) {
             for (const entry of fs_1.default.readdirSync(dir, { withFileTypes: true })) {
-                if (entry.name.startsWith('.'))
+                if (entry.name.startsWith('.') || watcher_1.ALWAYS_IGNORED.has(entry.name))
                     continue;
                 const full = path_1.default.join(dir, entry.name);
                 if (entry.isDirectory()) {

package/dist/graphs/file-index.js

@@ -121,6 +121,9 @@ function cleanEmptyDirs(graph, dir) {
         return;
     if (graph.getNodeAttribute(dir, 'kind') !== 'directory')
         return;
+    // Never remove root
+    if (dir === '.')
+        return;
     // Count outgoing `contains` edges
     const children = graph.outDegree(dir);
     if (children > 0)
@@ -128,9 +131,6 @@ function cleanEmptyDirs(graph, dir) {
     // No children — remove this directory
     const parent = graph.getNodeAttribute(dir, 'directory');
     graph.dropNode(dir);
-    // Don't remove root
-    if (dir === '.')
-        return;
     cleanEmptyDirs(graph, parent);
 }
 /**

package/dist/graphs/manager-types.js

@@ -16,7 +16,7 @@ class VersionConflictError extends Error {
     }
 }
 exports.VersionConflictError = VersionConflictError;
-/** No-op context for tests and single-project stdio mode. */
+/** No-op context for tests. */
 function noopContext(projectId = '') {
     return {
         markDirty: () => { },

package/dist/lib/file-mirror.js

@@ -422,14 +422,14 @@ function deleteMirrorDir(dir, id) {
 // ---------------------------------------------------------------------------
 // Attachment file helpers (paths now go through attachments/ subdir)
 // ---------------------------------------------------------------------------
-/** Sanitize a filename: strip path separators, .., and null bytes. */
+/** Sanitize a filename: extract basename, strip null bytes and path traversal. */
 function sanitizeFilename(name) {
-    const sanitized = name
-        .replace(/\0/g, '')
-        .replace(/\.\./g, '')
-        .replace(/[/\\]/g, '')
-        .trim();
-    return sanitized; // empty string is a valid return — callers must check
+    // Normalize backslashes to forward slashes (path.basename on Unix doesn't treat \ as separator)
+    const base = path.basename(name.replace(/\0/g, '').replace(/\\/g, '/')).trim();
+    // Reject pure traversal names
+    if (base === '.' || base === '..')
+        return '';
+    return base;
 }
 /** Write an attachment file to the entity's attachments/ subdirectory. */
 function writeAttachment(baseDir, entityId, filename, data) {

package/dist/lib/frontmatter.js

@@ -8,9 +8,10 @@ function serializeMarkdown(frontmatter, body) {
     return `---\n${yamlStr}\n---\n\n${body}\n`;
 }
 function parseMarkdown(raw) {
-    const match = raw.match(/^---\n([\s\S]*?)\n---\n\n?([\s\S]*)$/);
+    const normalized = raw.replace(/\r\n/g, '\n');
+    const match = normalized.match(/^---\n([\s\S]*?)\n---\n\n?([\s\S]*)$/);
     if (!match)
-        return { frontmatter: {}, body: raw };
+        return { frontmatter: {}, body: normalized };
     const frontmatter = (0, yaml_1.parse)(match[1], { maxAliasCount: 10 }) ?? {};
     const body = match[2].replace(/\n$/, '');
     return { frontmatter, body };

package/dist/lib/mirror-watcher.js

@@ -51,6 +51,7 @@ const frontmatter_1 = require("./frontmatter");
  * this tracker lets us detect our own writes and skip them.
  */
 class MirrorWriteTracker {
+    /** Map from filePath → { mtimeMs (for comparison), recordedAt (for eviction) } */
     recentWrites = new Map();
     static STALE_MS = 10_000; // entries older than 10s are stale
     static MAX_ENTRIES = 10_000;
@@ -59,7 +60,7 @@ class MirrorWriteTracker {
         try {
             const stat = fs.statSync(filePath, { throwIfNoEntry: false });
             if (stat)
-                this.recentWrites.set(filePath, stat.mtimeMs);
+                this.recentWrites.set(filePath, { mtimeMs: stat.mtimeMs, recordedAt: Date.now() });
         }
         catch { /* ignore */ }
         // Prevent unbounded growth — evict stale entries periodically
@@ -75,7 +76,7 @@ class MirrorWriteTracker {
             const stat = fs.statSync(filePath, { throwIfNoEntry: false });
             if (!stat)
                 return false;
-            if (Math.abs(stat.mtimeMs - recorded) < 100) {
+            if (Math.abs(stat.mtimeMs - recorded.mtimeMs) < 100) {
                 this.recentWrites.delete(filePath);
                 return true;
             }
@@ -86,8 +87,8 @@ class MirrorWriteTracker {
     }
     evictStale() {
         const now = Date.now();
-        for (const [filePath, mtime] of this.recentWrites) {
-            if (now - mtime > MirrorWriteTracker.STALE_MS)
+        for (const [filePath, entry] of this.recentWrites) {
+            if (now - entry.recordedAt > MirrorWriteTracker.STALE_MS)
                 this.recentWrites.delete(filePath);
         }
     }

package/dist/lib/multi-config.js

@@ -7,6 +7,7 @@ exports.GRAPH_NAMES = void 0;
 exports.embeddingFingerprint = embeddingFingerprint;
 exports.formatAuthor = formatAuthor;
 exports.loadMultiConfig = loadMultiConfig;
+exports.defaultConfig = defaultConfig;
 const fs_1 = __importDefault(require("fs"));
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
@@ -163,6 +164,7 @@ const MODEL_DEFAULTS = {
     name: 'Xenova/bge-m3',
     pooling: 'cls',
     normalize: true,
+    dtype: 'q8',
     queryPrefix: '',
     documentPrefix: '',
 };
@@ -391,3 +393,55 @@ function loadMultiConfig(yamlPath) {
     }
     return { author: globalAuthor, server, users, projects, workspaces };
 }
+/**
+ * Build a default MultiConfig for a single project rooted at `projectDir`.
+ * Used when no config file is found — zero-config startup.
+ */
+function defaultConfig(projectDir) {
+    const absDir = path_1.default.resolve(projectDir);
+    const id = path_1.default.basename(absDir);
+    const server = {
+        host: SERVER_DEFAULTS.host,
+        port: SERVER_DEFAULTS.port,
+        sessionTimeout: SERVER_DEFAULTS.sessionTimeout,
+        modelsDir: path_1.default.resolve(SERVER_DEFAULTS.modelsDir),
+        model: MODEL_DEFAULTS,
+        embedding: EMBEDDING_DEFAULTS,
+        defaultAccess: SERVER_DEFAULTS.defaultAccess,
+        accessTokenTtl: SERVER_DEFAULTS.accessTokenTtl,
+        refreshTokenTtl: SERVER_DEFAULTS.refreshTokenTtl,
+        rateLimit: RATE_LIMIT_DEFAULTS,
+        maxFileSize: SERVER_DEFAULTS.maxFileSize,
+        exclude: [...SERVER_DEFAULTS.exclude],
+    };
+    const graphConfigs = {};
+    for (const gn of exports.GRAPH_NAMES) {
+        graphConfigs[gn] = {
+            enabled: true,
+            include: gn === 'docs' ? PROJECT_DEFAULTS.docsInclude : gn === 'code' ? PROJECT_DEFAULTS.codeInclude : undefined,
+            exclude: [...server.exclude],
+            model: MODEL_DEFAULTS,
+            embedding: EMBEDDING_DEFAULTS,
+        };
+    }
+    const project = {
+        projectDir: absDir,
+        graphMemory: path_1.default.join(absDir, '.graph-memory'),
+        exclude: [...server.exclude],
+        chunkDepth: PROJECT_DEFAULTS.chunkDepth,
+        maxFileSize: server.maxFileSize,
+        model: MODEL_DEFAULTS,
+        embedding: EMBEDDING_DEFAULTS,
+        graphConfigs,
+        author: AUTHOR_DEFAULT,
+    };
+    const projects = new Map();
+    projects.set(id, project);
+    return {
+        author: AUTHOR_DEFAULT,
+        server,
+        users: {},
+        projects,
+        workspaces: new Map(),
+    };
+}

package/dist/lib/parsers/languages/registry.js

@@ -46,6 +46,8 @@ async function loadLanguage(entry) {
 function isLanguageSupported(languageName) {
     return languages.has(languageName);
 }
+/** Reusable parser per language (avoids WASM memory leak from creating Parser on every call). */
+const parsers = new Map();
 /** Parse source code with the appropriate language grammar. Returns root node or null. */
 async function parseSource(code, languageName) {
     const entry = languages.get(languageName);
@@ -53,8 +55,12 @@ async function parseSource(code, languageName) {
         return null;
     await initParser();
     const lang = await loadLanguage(entry);
-    const parser = new _wts.Parser();
-    parser.setLanguage(lang);
+    let parser = parsers.get(languageName);
+    if (!parser) {
+        parser = new _wts.Parser();
+        parser.setLanguage(lang);
+        parsers.set(languageName, parser);
+    }
     const tree = parser.parse(code);
     return tree?.rootNode ?? null;
 }

package/dist/lib/parsers/languages/typescript.js

@@ -26,12 +26,8 @@ function buildBody(node, docComment) {
     }
     return node.text ?? '';
 }
-/** Build a signature that includes the JSDoc first line if present. */
-function buildFullSignature(node, docComment) {
-    if (docComment) {
-        const firstDocLine = docComment.split('\n')[0].trim();
-        return firstDocLine;
-    }
+/** Build a signature: always use the code declaration, not JSDoc. */
+function buildFullSignature(node, _docComment) {
     return buildSignature(node);
 }
 /** Check if a node is inside an export_statement. */

package/dist/lib/watcher.js

@@ -3,12 +3,18 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALWAYS_IGNORED = void 0;
 exports.startWatcher = startWatcher;
 const chokidar_1 = __importDefault(require("chokidar"));
 const micromatch_1 = __importDefault(require("micromatch"));
 const path_1 = __importDefault(require("path"));
-/** Directories that are always excluded from watching (heavy, never useful). */
-const ALWAYS_IGNORED = ['.git', 'node_modules', '.next', '.nuxt', '.turbo', 'dist', 'build', '.graph-memory', '.notes', '.tasks', '.skills'];
+/** Directory basenames that are always excluded from watching and scanning at any nesting level. */
+exports.ALWAYS_IGNORED = new Set([
+    'node_modules', '.git', '.hg', '.svn',
+    '.next', '.nuxt', '.turbo',
+    'dist', 'build',
+    '.graph-memory', '.notes', '.tasks', '.skills',
+]);
 // chokidar 5: watch the directory directly — glob patterns don't fire 'add' for existing files
 function startWatcher(dir, handlers, pattern = '**/*.md', excludePatterns) {
     const matches = (filePath) => {
@@ -17,17 +23,19 @@ function startWatcher(dir, handlers, pattern = '**/*.md', excludePatterns) {
             return false;
         return micromatch_1.default.isMatch(rel, pattern);
     };
-    // chokidar 5 `ignored` accepts a function — use micromatch for glob exclude patterns
-    // plus always skip heavy directories (.git, node_modules, etc.)
-    const alwaysIgnoredSet = new Set(ALWAYS_IGNORED.map(d => path_1.default.join(dir, d)));
     const ignored = (filePath) => {
-        // Always ignore heavy directories by exact basename match
-        if (alwaysIgnoredSet.has(filePath))
+        const basename = path_1.default.basename(filePath);
+        // Skip dotfiles and dotdirs (hidden) at any level — except the watched root itself
+        if (basename.startsWith('.') && filePath !== dir)
             return true;
-        // User-defined exclude patterns (glob-based)
+        // Always-ignored directories by basename at any nesting level
+        if (exports.ALWAYS_IGNORED.has(basename))
+            return true;
+        // User-defined exclude patterns (glob-based) — only prune directories, not individual files.
+        // File-level filtering is handled by matches() + dispatchAdd per-graph excludes.
         if (excludePatterns && excludePatterns.length > 0) {
             const rel = path_1.default.relative(dir, filePath);
-            if (micromatch_1.default.isMatch(rel, excludePatterns))
+            if (micromatch_1.default.isMatch(rel + '/x', excludePatterns))
                 return true;
         }
         return false;