gitnexus 1.4.1 → 1.4.6

package/dist/mcp/local/local-backend.js

@@ -3,16 +3,16 @@
  *
  * Provides tool implementations using local .gitnexus/ indexes.
  * Supports multiple indexed repositories via a global registry.
- * KuzuDB connections are opened lazily per repo on first query.
+ * LadybugDB connections are opened lazily per repo on first query.
  */
 import fs from 'fs/promises';
 import path from 'path';
-import { initKuzu, executeQuery, executeParameterized, closeKuzu, isKuzuReady } from '../core/kuzu-adapter.js';
+import { initLbug, executeQuery, executeParameterized, closeLbug, isLbugReady } from '../core/lbug-adapter.js';
 // Embedding imports are lazy (dynamic import) to avoid loading onnxruntime-node
 // at MCP server startup — crashes on unsupported Node ABI versions (#89)
 // git utilities available if needed
 // import { isGitRepo, getCurrentCommit, getGitRoot } from '../../storage/git.js';
-import { listRegisteredRepos, } from '../../storage/repo-manager.js';
+import { listRegisteredRepos, cleanupOldKuzuFiles, } from '../../storage/repo-manager.js';
 // AI context generation is CLI-only (gitnexus analyze)
 // import { generateAIContextFiles } from '../../cli/ai-context.js';
 /**
@@ -26,9 +26,10 @@ export function isTestFilePath(filePath) {
         p.includes('/test/') || p.includes('/tests/') ||
         p.includes('/testing/') || p.includes('/fixtures/') ||
         p.endsWith('_test.go') || p.endsWith('_test.py') ||
+        p.endsWith('_spec.rb') || p.endsWith('_test.rb') || p.includes('/spec/') ||
         p.includes('/test_') || p.includes('/conftest.'));
 }
-/** Valid KuzuDB node labels for safe Cypher query construction */
+/** Valid LadybugDB node labels for safe Cypher query construction */
 export const VALID_NODE_LABELS = new Set([
     'File', 'Folder', 'Function', 'Class', 'Interface', 'Method', 'CodeElement',
     'Community', 'Process', 'Struct', 'Enum', 'Macro', 'Typedef', 'Union',
@@ -36,7 +37,7 @@ export const VALID_NODE_LABELS = new Set([
     'Record', 'Delegate', 'Annotation', 'Constructor', 'Template', 'Module',
 ]);
 /** Valid relation types for impact analysis filtering */
-export const VALID_RELATION_TYPES = new Set(['CALLS', 'IMPORTS', 'EXTENDS', 'IMPLEMENTS']);
+export const VALID_RELATION_TYPES = new Set(['CALLS', 'IMPORTS', 'EXTENDS', 'IMPLEMENTS', 'HAS_METHOD', 'OVERRIDES']);
 /** Regex to detect write operations in user-supplied Cypher queries */
 export const CYPHER_WRITE_RE = /\b(CREATE|DELETE|SET|MERGE|REMOVE|DROP|ALTER|COPY|DETACH)\b/i;
 /** Check if a Cypher query contains write operations */
@@ -64,7 +65,7 @@ export class LocalBackend {
     /**
      * Re-read the global registry and update the in-memory repo map.
      * New repos are added, existing repos are updated, removed repos are pruned.
-     * KuzuDB connections for removed repos are NOT closed (they idle-timeout naturally).
+     * LadybugDB connections for removed repos are NOT closed (they idle-timeout naturally).
      */
     async refreshRepos() {
         const entries = await listRegisteredRepos({ validate: true });
@@ -73,19 +74,25 @@ export class LocalBackend {
             const id = this.repoId(entry.name, entry.path);
             freshIds.add(id);
             const storagePath = entry.storagePath;
-            const kuzuPath = path.join(storagePath, 'kuzu');
+            const lbugPath = path.join(storagePath, 'lbug');
+            // Clean up any leftover KuzuDB files from before the LadybugDB migration.
+            // If kuzu exists but lbug doesn't, warn so the user knows to re-analyze.
+            const kuzu = await cleanupOldKuzuFiles(storagePath);
+            if (kuzu.found && kuzu.needsReindex) {
+                console.error(`GitNexus: "${entry.name}" has a stale KuzuDB index. Run: gitnexus analyze ${entry.path}`);
+            }
             const handle = {
                 id,
                 name: entry.name,
                 repoPath: entry.path,
                 storagePath,
-                kuzuPath,
+                lbugPath,
                 indexedAt: entry.indexedAt,
                 lastCommit: entry.lastCommit,
                 stats: entry.stats,
             };
             this.repos.set(id, handle);
-            // Build lightweight context (no KuzuDB needed)
+            // Build lightweight context (no LadybugDB needed)
             const s = entry.stats || {};
             this.contextCache.set(id, {
                 projectName: entry.name,
@@ -186,16 +193,16 @@ export class LocalBackend {
         }
         return null; // Multiple repos, no param — ambiguous
     }
-    // ─── Lazy KuzuDB Init ────────────────────────────────────────────
+    // ─── Lazy LadybugDB Init ────────────────────────────────────────────
     async ensureInitialized(repoId) {
         // Always check the actual pool — the idle timer may have evicted the connection
-        if (this.initializedRepos.has(repoId) && isKuzuReady(repoId))
+        if (this.initializedRepos.has(repoId) && isLbugReady(repoId))
             return;
         const handle = this.repos.get(repoId);
         if (!handle)
             throw new Error(`Unknown repo: ${repoId}`);
         try {
-            await initKuzu(repoId, handle.kuzuPath);
+            await initLbug(repoId, handle.lbugPath);
             this.initializedRepos.add(repoId);
         }
         catch (err) {
@@ -335,9 +342,9 @@ export class LocalBackend {
             // Find processes this symbol participates in
             let processRows = [];
             try {
-                processRows = await executeParameterized(repo.id, `
-          MATCH (n {id: $nodeId})-[r:CodeRelation {type: 'STEP_IN_PROCESS'}]->(p:Process)
-          RETURN p.id AS pid, p.label AS label, p.heuristicLabel AS heuristicLabel, p.processType AS processType, p.stepCount AS stepCount, r.step AS step
+                processRows = await executeParameterized(repo.id, `
+          MATCH (n {id: $nodeId})-[r:CodeRelation {type: 'STEP_IN_PROCESS'}]->(p:Process)
+          RETURN p.id AS pid, p.label AS label, p.heuristicLabel AS heuristicLabel, p.processType AS processType, p.stepCount AS stepCount, r.step AS step
         `, { nodeId: sym.nodeId });
             }
             catch (e) {
@@ -347,10 +354,10 @@ export class LocalBackend {
             let cohesion = 0;
             let module;
             try {
-                const cohesionRows = await executeParameterized(repo.id, `
-          MATCH (n {id: $nodeId})-[:CodeRelation {type: 'MEMBER_OF'}]->(c:Community)
-          RETURN c.cohesion AS cohesion, c.heuristicLabel AS module
-          LIMIT 1
+                const cohesionRows = await executeParameterized(repo.id, `
+          MATCH (n {id: $nodeId})-[:CodeRelation {type: 'MEMBER_OF'}]->(c:Community)
+          RETURN c.cohesion AS cohesion, c.heuristicLabel AS module
+          LIMIT 1
         `, { nodeId: sym.nodeId });
                 if (cohesionRows.length > 0) {
                     cohesion = (cohesionRows[0].cohesion ?? cohesionRows[0][0]) || 0;
@@ -364,9 +371,9 @@ export class LocalBackend {
             let content;
             if (includeContent) {
                 try {
-                    const contentRows = await executeParameterized(repo.id, `
-            MATCH (n {id: $nodeId})
-            RETURN n.content AS content
+                    const contentRows = await executeParameterized(repo.id, `
+            MATCH (n {id: $nodeId})
+            RETURN n.content AS content
           `, { nodeId: sym.nodeId });
                     if (contentRows.length > 0) {
                         content = contentRows[0].content ?? contentRows[0][0];
@@ -458,13 +465,13 @@ export class LocalBackend {
         };
     }
     /**
-     * BM25 keyword search helper - uses KuzuDB FTS for always-fresh results
+     * BM25 keyword search helper - uses LadybugDB FTS for always-fresh results
      */
     async bm25Search(repo, query, limit) {
-        const { searchFTSFromKuzu } = await import('../../core/search/bm25-index.js');
+        const { searchFTSFromLbug } = await import('../../core/search/bm25-index.js');
         let bm25Results;
         try {
-            bm25Results = await searchFTSFromKuzu(query, limit, repo.id);
+            bm25Results = await searchFTSFromLbug(query, limit, repo.id);
         }
         catch (err) {
             console.error('GitNexus: BM25/FTS search failed (FTS indexes may not exist) -', err.message);
@@ -474,11 +481,11 @@ export class LocalBackend {
         for (const bm25Result of bm25Results) {
             const fullPath = bm25Result.filePath;
             try {
-                const symbols = await executeParameterized(repo.id, `
-          MATCH (n)
-          WHERE n.filePath = $filePath
-          RETURN n.id AS id, n.name AS name, labels(n)[0] AS type, n.filePath AS filePath, n.startLine AS startLine, n.endLine AS endLine
-          LIMIT 3
+                const symbols = await executeParameterized(repo.id, `
+          MATCH (n)
+          WHERE n.filePath = $filePath
+          RETURN n.id AS id, n.name AS name, labels(n)[0] AS type, n.filePath AS filePath, n.startLine AS startLine, n.endLine AS endLine
+          LIMIT 3
         `, { filePath: fullPath });
                 if (symbols.length > 0) {
                     for (const sym of symbols) {
@@ -528,14 +535,14 @@ export class LocalBackend {
             const queryVec = await embedQuery(query);
             const dims = getEmbeddingDims();
             const queryVecStr = `[${queryVec.join(',')}]`;
-            const vectorQuery = `
-        CALL QUERY_VECTOR_INDEX('CodeEmbedding', 'code_embedding_idx', 
-          CAST(${queryVecStr} AS FLOAT[${dims}]), ${limit})
-        YIELD node AS emb, distance
-        WITH emb, distance
-        WHERE distance < 0.6
-        RETURN emb.nodeId AS nodeId, distance
-        ORDER BY distance
+            const vectorQuery = `
+        CALL QUERY_VECTOR_INDEX('CodeEmbedding', 'code_embedding_idx', 
+          CAST(${queryVecStr} AS FLOAT[${dims}]), ${limit})
+        YIELD node AS emb, distance
+        WITH emb, distance
+        WHERE distance < 0.6
+        RETURN emb.nodeId AS nodeId, distance
+        ORDER BY distance
       `;
             const embResults = await executeQuery(repo.id, vectorQuery);
             if (embResults.length === 0)
@@ -582,8 +589,8 @@ export class LocalBackend {
     }
     async cypher(repo, params) {
         await this.ensureInitialized(repo.id);
-        if (!isKuzuReady(repo.id)) {
-            return { error: 'KuzuDB not ready. Index may be corrupted.' };
+        if (!isLbugReady(repo.id)) {
+            return { error: 'LadybugDB not ready. Index may be corrupted.' };
         }
         // Block write operations (defense-in-depth — DB is already read-only)
         if (CYPHER_WRITE_RE.test(params.query)) {
@@ -628,7 +635,7 @@ export class LocalBackend {
     /**
      * Aggregate same-named clusters: group by heuristicLabel, sum symbols,
      * weighted-average cohesion, filter out tiny clusters (<5 symbols).
-     * Raw communities stay intact in KuzuDB for Cypher queries.
+     * Raw communities stay intact in LadybugDB for Cypher queries.
      */
     aggregateClusters(clusters) {
         const groups = new Map();
@@ -675,11 +682,11 @@ export class LocalBackend {
             try {
                 // Fetch more raw communities than the display limit so aggregation has enough data
                 const rawLimit = Math.max(limit * 5, 200);
-                const clusters = await executeQuery(repo.id, `
-          MATCH (c:Community)
-          RETURN c.id AS id, c.label AS label, c.heuristicLabel AS heuristicLabel, c.cohesion AS cohesion, c.symbolCount AS symbolCount
-          ORDER BY c.symbolCount DESC
-          LIMIT ${rawLimit}
+                const clusters = await executeQuery(repo.id, `
+          MATCH (c:Community)
+          RETURN c.id AS id, c.label AS label, c.heuristicLabel AS heuristicLabel, c.cohesion AS cohesion, c.symbolCount AS symbolCount
+          ORDER BY c.symbolCount DESC
+          LIMIT ${rawLimit}
         `);
                 const rawClusters = clusters.map((c) => ({
                     id: c.id || c[0],
@@ -696,11 +703,11 @@ export class LocalBackend {
         }
         if (params.showProcesses !== false) {
             try {
-                const processes = await executeQuery(repo.id, `
-          MATCH (p:Process)
-          RETURN p.id AS id, p.label AS label, p.heuristicLabel AS heuristicLabel, p.processType AS processType, p.stepCount AS stepCount
-          ORDER BY p.stepCount DESC
-          LIMIT ${limit}
+                const processes = await executeQuery(repo.id, `
+          MATCH (p:Process)
+          RETURN p.id AS id, p.label AS label, p.heuristicLabel AS heuristicLabel, p.processType AS processType, p.stepCount AS stepCount
+          ORDER BY p.stepCount DESC
+          LIMIT ${limit}
         `);
                 result.processes = processes.map((p) => ({
                     id: p.id || p[0],
@@ -730,10 +737,10 @@ export class LocalBackend {
         // Step 1: Find the symbol
         let symbols;
         if (uid) {
-            symbols = await executeParameterized(repo.id, `
-        MATCH (n {id: $uid})
-        RETURN n.id AS id, n.name AS name, labels(n)[0] AS type, n.filePath AS filePath, n.startLine AS startLine, n.endLine AS endLine${include_content ? ', n.content AS content' : ''}
-        LIMIT 1
+            symbols = await executeParameterized(repo.id, `
+        MATCH (n {id: $uid})
+        RETURN n.id AS id, n.name AS name, labels(n)[0] AS type, n.filePath AS filePath, n.startLine AS startLine, n.endLine AS endLine${include_content ? ', n.content AS content' : ''}
+        LIMIT 1
       `, { uid });
         }
         else {
@@ -752,10 +759,10 @@ export class LocalBackend {
                 whereClause = `WHERE n.name = $symName`;
                 queryParams = { symName: name };
             }
-            symbols = await executeParameterized(repo.id, `
-        MATCH (n) ${whereClause}
-        RETURN n.id AS id, n.name AS name, labels(n)[0] AS type, n.filePath AS filePath, n.startLine AS startLine, n.endLine AS endLine${include_content ? ', n.content AS content' : ''}
-        LIMIT 10
+            symbols = await executeParameterized(repo.id, `
+        MATCH (n) ${whereClause}
+        RETURN n.id AS id, n.name AS name, labels(n)[0] AS type, n.filePath AS filePath, n.startLine AS startLine, n.endLine AS endLine${include_content ? ', n.content AS content' : ''}
+        LIMIT 10
       `, queryParams);
         }
         if (symbols.length === 0) {
@@ -779,25 +786,25 @@ export class LocalBackend {
         const sym = symbols[0];
         const symId = sym.id || sym[0];
         // Categorized incoming refs
-        const incomingRows = await executeParameterized(repo.id, `
-      MATCH (caller)-[r:CodeRelation]->(n {id: $symId})
-      WHERE r.type IN ['CALLS', 'IMPORTS', 'EXTENDS', 'IMPLEMENTS']
-      RETURN r.type AS relType, caller.id AS uid, caller.name AS name, caller.filePath AS filePath, labels(caller)[0] AS kind
-      LIMIT 30
+        const incomingRows = await executeParameterized(repo.id, `
+      MATCH (caller)-[r:CodeRelation]->(n {id: $symId})
+      WHERE r.type IN ['CALLS', 'IMPORTS', 'EXTENDS', 'IMPLEMENTS']
+      RETURN r.type AS relType, caller.id AS uid, caller.name AS name, caller.filePath AS filePath, labels(caller)[0] AS kind
+      LIMIT 30
     `, { symId });
         // Categorized outgoing refs
-        const outgoingRows = await executeParameterized(repo.id, `
-      MATCH (n {id: $symId})-[r:CodeRelation]->(target)
-      WHERE r.type IN ['CALLS', 'IMPORTS', 'EXTENDS', 'IMPLEMENTS']
-      RETURN r.type AS relType, target.id AS uid, target.name AS name, target.filePath AS filePath, labels(target)[0] AS kind
-      LIMIT 30
+        const outgoingRows = await executeParameterized(repo.id, `
+      MATCH (n {id: $symId})-[r:CodeRelation]->(target)
+      WHERE r.type IN ['CALLS', 'IMPORTS', 'EXTENDS', 'IMPLEMENTS']
+      RETURN r.type AS relType, target.id AS uid, target.name AS name, target.filePath AS filePath, labels(target)[0] AS kind
+      LIMIT 30
     `, { symId });
         // Process participation
         let processRows = [];
         try {
-            processRows = await executeParameterized(repo.id, `
-        MATCH (n {id: $symId})-[r:CodeRelation {type: 'STEP_IN_PROCESS'}]->(p:Process)
-        RETURN p.id AS pid, p.heuristicLabel AS label, r.step AS step, p.stepCount AS stepCount
+            processRows = await executeParameterized(repo.id, `
+        MATCH (n {id: $symId})-[r:CodeRelation {type: 'STEP_IN_PROCESS'}]->(p:Process)
+        RETURN p.id AS pid, p.heuristicLabel AS label, r.step AS step, p.stepCount AS stepCount
       `, { symId });
         }
         catch (e) {
@@ -852,10 +859,10 @@ export class LocalBackend {
             return this.context(repo, { name });
         }
         if (type === 'cluster') {
-            const clusters = await executeParameterized(repo.id, `
-        MATCH (c:Community)
-        WHERE c.label = $clusterName OR c.heuristicLabel = $clusterName
-        RETURN c.id AS id, c.label AS label, c.heuristicLabel AS heuristicLabel, c.cohesion AS cohesion, c.symbolCount AS symbolCount
+            const clusters = await executeParameterized(repo.id, `
+        MATCH (c:Community)
+        WHERE c.label = $clusterName OR c.heuristicLabel = $clusterName
+        RETURN c.id AS id, c.label AS label, c.heuristicLabel AS heuristicLabel, c.cohesion AS cohesion, c.symbolCount AS symbolCount
       `, { clusterName: name });
             if (clusters.length === 0)
                 return { error: `Cluster '${name}' not found` };
@@ -869,11 +876,11 @@ export class LocalBackend {
                 totalSymbols += s;
                 weightedCohesion += (c.cohesion || 0) * s;
             }
-            const members = await executeParameterized(repo.id, `
-        MATCH (n)-[:CodeRelation {type: 'MEMBER_OF'}]->(c:Community)
-        WHERE c.label = $clusterName OR c.heuristicLabel = $clusterName
-        RETURN DISTINCT n.name AS name, labels(n)[0] AS type, n.filePath AS filePath
-        LIMIT 30
+            const members = await executeParameterized(repo.id, `
+        MATCH (n)-[:CodeRelation {type: 'MEMBER_OF'}]->(c:Community)
+        WHERE c.label = $clusterName OR c.heuristicLabel = $clusterName
+        RETURN DISTINCT n.name AS name, labels(n)[0] AS type, n.filePath AS filePath
+        LIMIT 30
       `, { clusterName: name });
             return {
                 cluster: {
@@ -890,20 +897,20 @@ export class LocalBackend {
             };
         }
         if (type === 'process') {
-            const processes = await executeParameterized(repo.id, `
-        MATCH (p:Process)
-        WHERE p.label = $processName OR p.heuristicLabel = $processName
-        RETURN p.id AS id, p.label AS label, p.heuristicLabel AS heuristicLabel, p.processType AS processType, p.stepCount AS stepCount
-        LIMIT 1
+            const processes = await executeParameterized(repo.id, `
+        MATCH (p:Process)
+        WHERE p.label = $processName OR p.heuristicLabel = $processName
+        RETURN p.id AS id, p.label AS label, p.heuristicLabel AS heuristicLabel, p.processType AS processType, p.stepCount AS stepCount
+        LIMIT 1
       `, { processName: name });
             if (processes.length === 0)
                 return { error: `Process '${name}' not found` };
             const proc = processes[0];
             const procId = proc.id || proc[0];
-            const steps = await executeParameterized(repo.id, `
-        MATCH (n)-[r:CodeRelation {type: 'STEP_IN_PROCESS'}]->(p {id: $procId})
-        RETURN n.name AS name, labels(n)[0] AS type, n.filePath AS filePath, r.step AS step
-        ORDER BY r.step
+            const steps = await executeParameterized(repo.id, `
+        MATCH (n)-[r:CodeRelation {type: 'STEP_IN_PROCESS'}]->(p {id: $procId})
+        RETURN n.name AS name, labels(n)[0] AS type, n.filePath AS filePath, r.step AS step
+        ORDER BY r.step
       `, { procId });
             return {
                 process: {
@@ -964,10 +971,10 @@ export class LocalBackend {
         for (const file of changedFiles) {
             const normalizedFile = file.replace(/\\/g, '/');
             try {
-                const symbols = await executeParameterized(repo.id, `
-          MATCH (n) WHERE n.filePath CONTAINS $filePath
-          RETURN n.id AS id, n.name AS name, labels(n)[0] AS type, n.filePath AS filePath
-          LIMIT 20
+                const symbols = await executeParameterized(repo.id, `
+          MATCH (n) WHERE n.filePath CONTAINS $filePath
+          RETURN n.id AS id, n.name AS name, labels(n)[0] AS type, n.filePath AS filePath
+          LIMIT 20
         `, { filePath: normalizedFile });
                 for (const sym of symbols) {
                     changedSymbols.push({
@@ -987,9 +994,9 @@ export class LocalBackend {
         const affectedProcesses = new Map();
         for (const sym of changedSymbols) {
             try {
-                const procs = await executeParameterized(repo.id, `
-          MATCH (n {id: $nodeId})-[r:CodeRelation {type: 'STEP_IN_PROCESS'}]->(p:Process)
-          RETURN p.id AS pid, p.heuristicLabel AS label, p.processType AS processType, p.stepCount AS stepCount, r.step AS step
+                const procs = await executeParameterized(repo.id, `
+          MATCH (n {id: $nodeId})-[r:CodeRelation {type: 'STEP_IN_PROCESS'}]->(p:Process)
+          RETURN p.id AS pid, p.heuristicLabel AS label, p.processType AS processType, p.stepCount AS stepCount, r.step AS step
         `, { nodeId: sym.id });
                 for (const proc of procs) {
                     const pid = proc.pid || proc[0];
@@ -1182,6 +1189,22 @@ export class LocalBackend {
         };
     }
     async impact(repo, params) {
+        try {
+            return await this._impactImpl(repo, params);
+        }
+        catch (err) {
+            // Return structured error instead of crashing (#321)
+            return {
+                error: (err instanceof Error ? err.message : String(err)) || 'Impact analysis failed',
+                target: { name: params.target },
+                direction: params.direction,
+                impactedCount: 0,
+                risk: 'UNKNOWN',
+                suggestion: 'The graph query failed — try gitnexus context <symbol> as a fallback',
+            };
+        }
+    }
+    async _impactImpl(repo, params) {
         await this.ensureInitialized(repo.id);
         const { target, direction } = params;
         const maxDepth = params.maxDepth || 3;
@@ -1193,11 +1216,11 @@ export class LocalBackend {
         const minConfidence = params.minConfidence ?? 0;
         const relTypeFilter = relationTypes.map(t => `'${t}'`).join(', ');
         const confidenceFilter = minConfidence > 0 ? ` AND r.confidence >= ${minConfidence}` : '';
-        const targets = await executeParameterized(repo.id, `
-      MATCH (n)
-      WHERE n.name = $targetName
-      RETURN n.id AS id, n.name AS name, labels(n)[0] AS type, n.filePath AS filePath
-      LIMIT 1
+        const targets = await executeParameterized(repo.id, `
+      MATCH (n)
+      WHERE n.name = $targetName
+      RETURN n.id AS id, n.name AS name, labels(n)[0] AS type, n.filePath AS filePath
+      LIMIT 1
     `, { targetName: target });
         if (targets.length === 0)
             return { error: `Target '${target}' not found` };
@@ -1206,6 +1229,7 @@ export class LocalBackend {
         const impacted = [];
         const visited = new Set([symId]);
         let frontier = [symId];
+        let traversalComplete = true;
         for (let depth = 1; depth <= maxDepth && frontier.length > 0; depth++) {
             const nextFrontier = [];
             // Batch frontier nodes into a single Cypher query per depth level
@@ -1237,6 +1261,10 @@ export class LocalBackend {
             }
             catch (e) {
                 logQueryError('impact:depth-traversal', e);
+                // Break out of depth loop on query failure but return partial results
+                // collected so far, rather than silently swallowing the error (#321)
+                traversalComplete = false;
+                break;
             }
             frontier = nextFrontier;
         }
@@ -1255,24 +1283,24 @@ export class LocalBackend {
             const d1Ids = (grouped[1] || []).map((i) => `'${i.id.replace(/'/g, "''")}'`).join(', ');
             // Affected processes: which execution flows are broken and at which step
             const [processRows, moduleRows, directModuleRows] = await Promise.all([
-                executeQuery(repo.id, `
-          MATCH (s)-[r:CodeRelation {type: 'STEP_IN_PROCESS'}]->(p:Process)
-          WHERE s.id IN [${allIds}]
-          RETURN p.heuristicLabel AS name, COUNT(DISTINCT s.id) AS hits, MIN(r.step) AS minStep, p.stepCount AS stepCount
-          ORDER BY hits DESC
-          LIMIT 20
+                executeQuery(repo.id, `
+          MATCH (s)-[r:CodeRelation {type: 'STEP_IN_PROCESS'}]->(p:Process)
+          WHERE s.id IN [${allIds}]
+          RETURN p.heuristicLabel AS name, COUNT(DISTINCT s.id) AS hits, MIN(r.step) AS minStep, p.stepCount AS stepCount
+          ORDER BY hits DESC
+          LIMIT 20
         `).catch(() => []),
-                executeQuery(repo.id, `
-          MATCH (s)-[:CodeRelation {type: 'MEMBER_OF'}]->(c:Community)
-          WHERE s.id IN [${allIds}]
-          RETURN c.heuristicLabel AS name, COUNT(DISTINCT s.id) AS hits
-          ORDER BY hits DESC
-          LIMIT 20
+                executeQuery(repo.id, `
+          MATCH (s)-[:CodeRelation {type: 'MEMBER_OF'}]->(c:Community)
+          WHERE s.id IN [${allIds}]
+          RETURN c.heuristicLabel AS name, COUNT(DISTINCT s.id) AS hits
+          ORDER BY hits DESC
+          LIMIT 20
         `).catch(() => []),
-                d1Ids ? executeQuery(repo.id, `
-          MATCH (s)-[:CodeRelation {type: 'MEMBER_OF'}]->(c:Community)
-          WHERE s.id IN [${d1Ids}]
-          RETURN DISTINCT c.heuristicLabel AS name
+                d1Ids ? executeQuery(repo.id, `
+          MATCH (s)-[:CodeRelation {type: 'MEMBER_OF'}]->(c:Community)
+          WHERE s.id IN [${d1Ids}]
+          RETURN DISTINCT c.heuristicLabel AS name
         `).catch(() => []) : Promise.resolve([]),
             ]);
             affectedProcesses = processRows.map((r) => ({
@@ -1314,6 +1342,7 @@ export class LocalBackend {
             direction,
             impactedCount: impacted.length,
             risk,
+            ...(!traversalComplete && { partial: true }),
             summary: {
                 direct: directCount,
                 processes_affected: processCount,
@@ -1334,11 +1363,11 @@ export class LocalBackend {
         await this.ensureInitialized(repo.id);
         try {
             const rawLimit = Math.max(limit * 5, 200);
-            const clusters = await executeQuery(repo.id, `
-        MATCH (c:Community)
-        RETURN c.id AS id, c.label AS label, c.heuristicLabel AS heuristicLabel, c.cohesion AS cohesion, c.symbolCount AS symbolCount
-        ORDER BY c.symbolCount DESC
-        LIMIT ${rawLimit}
+            const clusters = await executeQuery(repo.id, `
+        MATCH (c:Community)
+        RETURN c.id AS id, c.label AS label, c.heuristicLabel AS heuristicLabel, c.cohesion AS cohesion, c.symbolCount AS symbolCount
+        ORDER BY c.symbolCount DESC
+        LIMIT ${rawLimit}
       `);
             const rawClusters = clusters.map((c) => ({
                 id: c.id || c[0],
@@ -1361,11 +1390,11 @@ export class LocalBackend {
         const repo = await this.resolveRepo(repoName);
         await this.ensureInitialized(repo.id);
         try {
-            const processes = await executeQuery(repo.id, `
-        MATCH (p:Process)
-        RETURN p.id AS id, p.label AS label, p.heuristicLabel AS heuristicLabel, p.processType AS processType, p.stepCount AS stepCount
-        ORDER BY p.stepCount DESC
-        LIMIT ${limit}
+            const processes = await executeQuery(repo.id, `
+        MATCH (p:Process)
+        RETURN p.id AS id, p.label AS label, p.heuristicLabel AS heuristicLabel, p.processType AS processType, p.stepCount AS stepCount
+        ORDER BY p.stepCount DESC
+        LIMIT ${limit}
       `);
             return {
                 processes: processes.map((p) => ({
@@ -1388,10 +1417,10 @@ export class LocalBackend {
     async queryClusterDetail(name, repoName) {
         const repo = await this.resolveRepo(repoName);
         await this.ensureInitialized(repo.id);
-        const clusters = await executeParameterized(repo.id, `
-      MATCH (c:Community)
-      WHERE c.label = $clusterName OR c.heuristicLabel = $clusterName
-      RETURN c.id AS id, c.label AS label, c.heuristicLabel AS heuristicLabel, c.cohesion AS cohesion, c.symbolCount AS symbolCount
+        const clusters = await executeParameterized(repo.id, `
+      MATCH (c:Community)
+      WHERE c.label = $clusterName OR c.heuristicLabel = $clusterName
+      RETURN c.id AS id, c.label AS label, c.heuristicLabel AS heuristicLabel, c.cohesion AS cohesion, c.symbolCount AS symbolCount
     `, { clusterName: name });
         if (clusters.length === 0)
             return { error: `Cluster '${name}' not found` };
@@ -1405,11 +1434,11 @@ export class LocalBackend {
             totalSymbols += s;
             weightedCohesion += (c.cohesion || 0) * s;
         }
-        const members = await executeParameterized(repo.id, `
-      MATCH (n)-[:CodeRelation {type: 'MEMBER_OF'}]->(c:Community)
-      WHERE c.label = $clusterName OR c.heuristicLabel = $clusterName
-      RETURN DISTINCT n.name AS name, labels(n)[0] AS type, n.filePath AS filePath
-      LIMIT 30
+        const members = await executeParameterized(repo.id, `
+      MATCH (n)-[:CodeRelation {type: 'MEMBER_OF'}]->(c:Community)
+      WHERE c.label = $clusterName OR c.heuristicLabel = $clusterName
+      RETURN DISTINCT n.name AS name, labels(n)[0] AS type, n.filePath AS filePath
+      LIMIT 30
     `, { clusterName: name });
         return {
             cluster: {
@@ -1432,20 +1461,20 @@ export class LocalBackend {
     async queryProcessDetail(name, repoName) {
         const repo = await this.resolveRepo(repoName);
         await this.ensureInitialized(repo.id);
-        const processes = await executeParameterized(repo.id, `
-      MATCH (p:Process)
-      WHERE p.label = $processName OR p.heuristicLabel = $processName
-      RETURN p.id AS id, p.label AS label, p.heuristicLabel AS heuristicLabel, p.processType AS processType, p.stepCount AS stepCount
-      LIMIT 1
+        const processes = await executeParameterized(repo.id, `
+      MATCH (p:Process)
+      WHERE p.label = $processName OR p.heuristicLabel = $processName
+      RETURN p.id AS id, p.label AS label, p.heuristicLabel AS heuristicLabel, p.processType AS processType, p.stepCount AS stepCount
+      LIMIT 1
     `, { processName: name });
         if (processes.length === 0)
             return { error: `Process '${name}' not found` };
         const proc = processes[0];
         const procId = proc.id || proc[0];
-        const steps = await executeParameterized(repo.id, `
-      MATCH (n)-[r:CodeRelation {type: 'STEP_IN_PROCESS'}]->(p {id: $procId})
-      RETURN n.name AS name, labels(n)[0] AS type, n.filePath AS filePath, r.step AS step
-      ORDER BY r.step
+        const steps = await executeParameterized(repo.id, `
+      MATCH (n)-[r:CodeRelation {type: 'STEP_IN_PROCESS'}]->(p {id: $procId})
+      RETURN n.name AS name, labels(n)[0] AS type, n.filePath AS filePath, r.step AS step
+      ORDER BY r.step
     `, { procId });
         return {
             process: {
@@ -1458,7 +1487,7 @@ export class LocalBackend {
         };
     }
     async disconnect() {
-        await closeKuzu(); // close all connections
+        await closeLbug(); // close all connections
         // Note: we intentionally do NOT call disposeEmbedder() here.
         // ONNX Runtime's native cleanup segfaults on macOS and some Linux configs,
         // and importing the embedder module on Node v24+ crashes if onnxruntime