gitnexus 1.4.9 → 1.5.0

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

@@ -7,7 +7,7 @@
  */
 import fs from 'fs/promises';
 import path from 'path';
-import { initLbug, executeQuery, executeParameterized, closeLbug, isLbugReady, isWriteQuery } from '../core/lbug-adapter.js';
+import { initLbug, executeQuery, executeParameterized, closeLbug, isLbugReady, isWriteQuery, } from '../core/lbug-adapter.js';
 export { isWriteQuery };
 // Embedding imports are lazy (dynamic import) to avoid loading onnxruntime-node
 // at MCP server startup — crashes on unsupported Node ABI versions (#89)
@@ -22,25 +22,70 @@ import { listRegisteredRepos, cleanupOldKuzuFiles, } from '../../storage/repo-ma
  */
 export function isTestFilePath(filePath) {
     const p = filePath.toLowerCase().replace(/\\/g, '/');
-    return (p.includes('.test.') || p.includes('.spec.') ||
-        p.includes('__tests__/') || p.includes('__mocks__/') ||
-        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.'));
+    return (p.includes('.test.') ||
+        p.includes('.spec.') ||
+        p.includes('__tests__/') ||
+        p.includes('__mocks__/') ||
+        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 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',
-    'Namespace', 'Trait', 'Impl', 'TypeAlias', 'Const', 'Static', 'Property',
-    'Record', 'Delegate', 'Annotation', 'Constructor', 'Template', 'Module',
+    'File',
+    'Folder',
+    'Function',
+    'Class',
+    'Interface',
+    'Method',
+    'CodeElement',
+    'Community',
+    'Process',
+    'Struct',
+    'Enum',
+    'Macro',
+    'Typedef',
+    'Union',
+    'Namespace',
+    'Trait',
+    'Impl',
+    'TypeAlias',
+    'Const',
+    'Static',
+    'Property',
+    'Record',
+    'Delegate',
+    'Annotation',
+    'Constructor',
+    'Template',
+    'Module',
     'Route',
     'Tool',
 ]);
 /** Valid relation types for impact analysis filtering */
-export const VALID_RELATION_TYPES = new Set(['CALLS', 'IMPORTS', 'EXTENDS', 'IMPLEMENTS', 'HAS_METHOD', 'HAS_PROPERTY', 'OVERRIDES', 'ACCESSES', 'HANDLES_ROUTE', 'FETCHES', 'HANDLES_TOOL', 'ENTRY_POINT_OF', 'WRAPS']);
+export const VALID_RELATION_TYPES = new Set([
+    'CALLS',
+    'IMPORTS',
+    'EXTENDS',
+    'IMPLEMENTS',
+    'HAS_METHOD',
+    'HAS_PROPERTY',
+    'OVERRIDES',
+    'ACCESSES',
+    'HANDLES_ROUTE',
+    'FETCHES',
+    'HANDLES_TOOL',
+    'ENTRY_POINT_OF',
+    'WRAPS',
+]);
 /**
  * Per-relation-type confidence floor for impact analysis.
  *
@@ -187,10 +232,10 @@ export class LocalBackend {
             throw new Error('No indexed repositories. Run: gitnexus analyze');
         }
         if (repoParam) {
-            const names = [...this.repos.values()].map(h => h.name);
+            const names = [...this.repos.values()].map((h) => h.name);
             throw new Error(`Repository "${repoParam}" not found. Available: ${names.join(', ')}`);
         }
-        const names = [...this.repos.values()].map(h => h.name);
+        const names = [...this.repos.values()].map((h) => h.name);
         throw new Error(`Multiple repositories indexed. Specify which one with the "repo" parameter. Available: ${names.join(', ')}`);
     }
     /**
@@ -306,7 +351,7 @@ export class LocalBackend {
      */
     async listRepos() {
         await this.refreshRepos();
-        return [...this.repos.values()].map(h => ({
+        return [...this.repos.values()].map((h) => ({
             name: h.name,
             path: h.repoPath,
             indexedAt: h.indexedAt,
@@ -516,14 +561,14 @@ export class LocalBackend {
         }
         // Step 3: Rank processes by aggregate score + internal cohesion boost
         const rankedProcesses = Array.from(processMap.values())
-            .map(p => ({
+            .map((p) => ({
             ...p,
-            priority: p.totalScore + (p.cohesionBoost * 0.1), // cohesion as subtle ranking signal
+            priority: p.totalScore + p.cohesionBoost * 0.1, // cohesion as subtle ranking signal
         }))
             .sort((a, b) => b.priority - a.priority)
             .slice(0, processLimit);
         // Step 4: Build response
-        const processes = rankedProcesses.map(p => ({
+        const processes = rankedProcesses.map((p) => ({
             id: p.id,
             summary: p.heuristicLabel || p.label,
             priority: Math.round(p.priority * 1000) / 1000,
@@ -531,13 +576,13 @@ export class LocalBackend {
             process_type: p.processType,
             step_count: p.stepCount,
         }));
-        const processSymbols = rankedProcesses.flatMap(p => p.symbols.slice(0, maxSymbolsPerProcess).map(s => ({
+        const processSymbols = rankedProcesses.flatMap((p) => p.symbols.slice(0, maxSymbolsPerProcess).map((s) => ({
             ...s,
             // remove internal fields
         })));
         // Deduplicate process_symbols by id
         const seen = new Set();
-        const dedupedSymbols = processSymbols.filter(s => {
+        const dedupedSymbols = processSymbols.filter((s) => {
             if (seen.has(s.id))
                 return false;
             seen.add(s.id);
@@ -547,7 +592,9 @@ export class LocalBackend {
             processes,
             process_symbols: dedupedSymbols,
             definitions: definitions.slice(0, 20), // cap standalone definitions
-            ...(!ftsUsed && { warning: 'FTS extension unavailable - keyword search degraded. Run: gitnexus analyze --force to rebuild indexes.' }),
+            ...(!ftsUsed && {
+                warning: 'FTS extension unavailable - keyword search degraded. Run: gitnexus analyze --force to rebuild indexes.',
+            }),
         };
     }
     /**
@@ -563,7 +610,7 @@ export class LocalBackend {
             console.error('GitNexus: BM25/FTS search failed (FTS indexes may not exist) -', err.message);
             return { results: [], ftsUsed: false };
         }
-        const ftsUsed = bm25Results.length === 0 || (bm25Results[0]?.ftsUsed !== false);
+        const ftsUsed = bm25Results.length === 0 || bm25Results[0]?.ftsUsed !== false;
         const results = [];
         for (const bm25Result of bm25Results) {
             const fullPath = bm25Result.filePath;
@@ -681,7 +728,9 @@ export class LocalBackend {
         }
         // Block write operations (defense-in-depth — DB is already read-only)
         if (isWriteQuery(params.query)) {
-            return { error: 'Write operations (CREATE, DELETE, SET, MERGE, REMOVE, DROP, ALTER, COPY, DETACH) are not allowed. The knowledge graph is read-only.' };
+            return {
+                error: 'Write operations (CREATE, DELETE, SET, MERGE, REMOVE, DROP, ALTER, COPY, DETACH) are not allowed. The knowledge graph is read-only.',
+            };
         }
         try {
             const result = await executeQuery(repo.id, params.query);
@@ -706,14 +755,18 @@ export class LocalBackend {
             return result;
         const header = '| ' + keys.join(' | ') + ' |';
         const separator = '| ' + keys.map(() => '---').join(' | ') + ' |';
-        const dataRows = result.map((row) => '| ' + keys.map(k => {
-            const v = row[k];
-            if (v === null || v === undefined)
-                return '';
-            if (typeof v === 'object')
-                return JSON.stringify(v);
-            return String(v);
-        }).join(' | ') + ' |');
+        const dataRows = result.map((row) => '| ' +
+            keys
+                .map((k) => {
+                const v = row[k];
+                if (v === null || v === undefined)
+                    return '';
+                if (typeof v === 'object')
+                    return JSON.stringify(v);
+                return String(v);
+            })
+                .join(' | ') +
+            ' |');
         return {
             markdown: [header, separator, ...dataRows].join('\n'),
             row_count: result.length,
@@ -732,7 +785,12 @@ export class LocalBackend {
             const cohesion = c.cohesion || 0;
             const existing = groups.get(label);
             if (!existing) {
-                groups.set(label, { ids: [c.id], totalSymbols: symbols, weightedCohesion: cohesion * symbols, largest: c });
+                groups.set(label, {
+                    ids: [c.id],
+                    totalSymbols: symbols,
+                    weightedCohesion: cohesion * symbols,
+                    largest: c,
+                });
             }
             else {
                 existing.ids.push(c.id);
@@ -752,7 +810,7 @@ export class LocalBackend {
             cohesion: g.totalSymbols > 0 ? g.weightedCohesion / g.totalSymbols : 0,
             subCommunities: g.ids.length,
         }))
-            .filter(c => c.symbolCount >= 5)
+            .filter((c) => c.symbolCount >= 5)
             .sort((a, b) => b.symbolCount - a.symbolCount);
     }
     async overview(repo, params) {
@@ -914,7 +972,7 @@ export class LocalBackend {
         const sym = symbols[0];
         const symId = sym.id || sym[0];
         // Categorized incoming refs
-        let incomingRows = await executeParameterized(repo.id, `
+        const incomingRows = await executeParameterized(repo.id, `
       MATCH (caller)-[r:CodeRelation]->(n {id: $symId})
       WHERE r.type IN ['CALLS', 'IMPORTS', 'EXTENDS', 'IMPLEMENTS', 'HAS_METHOD', 'HAS_PROPERTY', 'OVERRIDES', 'ACCESSES']
       RETURN r.type AS relType, caller.id AS uid, caller.name AS name, caller.filePath AS filePath, labels(caller)[0] AS kind
@@ -940,7 +998,9 @@ export class LocalBackend {
         `, { symId });
                 isClassLike = typeCheck.length > 0;
             }
-            catch { /* not a Class/Interface node */ }
+            catch {
+                /* not a Class/Interface node */
+            }
         }
         else if (!isClassLike) {
             isClassLike = symRawType === 'Class' || symRawType === 'Interface';
@@ -1022,7 +1082,7 @@ export class LocalBackend {
             symbol: {
                 uid: sym.id || sym[0],
                 name: sym.name || sym[1],
-                kind: isClassLike ? (resolvedLabel || 'Class') : (sym.type || sym[2]),
+                kind: isClassLike ? resolvedLabel || 'Class' : sym.type || sym[2],
                 filePath: sym.filePath || sym[3],
                 startLine: sym.startLine || sym[4],
                 endLine: sym.endLine || sym[5],
@@ -1057,8 +1117,11 @@ export class LocalBackend {
             if (clusters.length === 0)
                 return { error: `Cluster '${name}' not found` };
             const rawClusters = clusters.map((c) => ({
-                id: c.id || c[0], label: c.label || c[1], heuristicLabel: c.heuristicLabel || c[2],
-                cohesion: c.cohesion || c[3], symbolCount: c.symbolCount || c[4],
+                id: c.id || c[0],
+                label: c.label || c[1],
+                heuristicLabel: c.heuristicLabel || c[2],
+                cohesion: c.cohesion || c[3],
+                symbolCount: c.symbolCount || c[4],
             }));
             let totalSymbols = 0, weightedCohesion = 0;
             for (const c of rawClusters) {
@@ -1082,7 +1145,9 @@ export class LocalBackend {
                     subCommunities: rawClusters.length,
                 },
                 members: members.map((m) => ({
-                    name: m.name || m[0], type: m.type || m[1], filePath: m.filePath || m[2],
+                    name: m.name || m[0],
+                    type: m.type || m[1],
+                    filePath: m.filePath || m[2],
                 })),
             };
         }
@@ -1104,11 +1169,17 @@ export class LocalBackend {
       `, { procId });
             return {
                 process: {
-                    id: procId, label: proc.label || proc[1], heuristicLabel: proc.heuristicLabel || proc[2],
-                    processType: proc.processType || proc[3], stepCount: proc.stepCount || proc[4],
+                    id: procId,
+                    label: proc.label || proc[1],
+                    heuristicLabel: proc.heuristicLabel || proc[2],
+                    processType: proc.processType || proc[3],
+                    stepCount: proc.stepCount || proc[4],
                 },
                 steps: steps.map((s) => ({
-                    step: s.step || s[3], name: s.name || s[0], type: s.type || s[1], filePath: s.filePath || s[2],
+                    step: s.step || s[3],
+                    name: s.name || s[0],
+                    type: s.type || s[1],
+                    filePath: s.filePath || s[2],
                 })),
             };
         }
@@ -1144,14 +1215,22 @@ export class LocalBackend {
         let changedFiles;
         try {
             const output = execFileSync('git', diffArgs, { cwd: repo.repoPath, encoding: 'utf-8' });
-            changedFiles = output.trim().split('\n').filter(f => f.length > 0);
+            changedFiles = output
+                .trim()
+                .split('\n')
+                .filter((f) => f.length > 0);
         }
         catch (err) {
             return { error: `Git diff failed: ${err.message}` };
         }
         if (changedFiles.length === 0) {
             return {
-                summary: { changed_count: 0, affected_count: 0, risk_level: 'none', message: 'No changes detected.' },
+                summary: {
+                    changed_count: 0,
+                    affected_count: 0,
+                    risk_level: 'none',
+                    message: 'No changes detected.',
+                },
                 changed_symbols: [],
                 affected_processes: [],
             };
@@ -1210,7 +1289,13 @@ export class LocalBackend {
             }
         }
         const processCount = affectedProcesses.size;
-        const risk = processCount === 0 ? 'low' : processCount <= 5 ? 'medium' : processCount <= 15 ? 'high' : 'critical';
+        const risk = processCount === 0
+            ? 'low'
+            : processCount <= 5
+                ? 'medium'
+                : processCount <= 15
+                    ? 'high'
+                    : 'critical';
         return {
             summary: {
                 changed_count: changedSymbols.length,
@@ -1298,7 +1383,9 @@ export class LocalBackend {
                 const lines = content.split('\n');
                 for (let i = 0; i < lines.length; i++) {
                     if (lines[i].includes(oldName)) {
-                        addEdit(ref.filePath, i + 1, lines[i].trim(), lines[i].replace(new RegExp(`\\b${oldName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\b`, 'g'), new_name).trim(), 'graph');
+                        addEdit(ref.filePath, i + 1, lines[i].trim(), lines[i]
+                            .replace(new RegExp(`\\b${oldName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\b`, 'g'), new_name)
+                            .trim(), 'graph');
                         graphEdits++;
                         break; // one edit per file from graph refs
                     }
@@ -1310,19 +1397,28 @@ export class LocalBackend {
         }
         // Step 3: Text search for refs the graph might have missed
         let astSearchEdits = 0;
-        const graphFiles = new Set([sym.filePath, ...allIncoming.map(r => r.filePath)].filter(Boolean));
+        const graphFiles = new Set([sym.filePath, ...allIncoming.map((r) => r.filePath)].filter(Boolean));
         // Simple text search across the repo for the old name (in files not already covered by graph)
         try {
             const { execFileSync } = await import('child_process');
             const rgArgs = [
                 '-l',
-                '--type-add', 'code:*.{ts,tsx,js,jsx,py,go,rs,java,c,h,cpp,cc,cxx,hpp,hxx,hh,cs,php,swift}',
-                '-t', 'code',
+                '--type-add',
+                'code:*.{ts,tsx,js,jsx,py,go,rs,java,c,h,cpp,cc,cxx,hpp,hxx,hh,cs,php,swift}',
+                '-t',
+                'code',
                 `\\b${oldName}\\b`,
                 '.',
             ];
-            const output = execFileSync('rg', rgArgs, { cwd: repo.repoPath, encoding: 'utf-8', timeout: 5000 });
-            const files = output.trim().split('\n').filter(f => f.length > 0);
+            const output = execFileSync('rg', rgArgs, {
+                cwd: repo.repoPath,
+                encoding: 'utf-8',
+                timeout: 5000,
+            });
+            const files = output
+                .trim()
+                .split('\n')
+                .filter((f) => f.length > 0);
             for (const file of files) {
                 const normalizedFile = file.replace(/\\/g, '/').replace(/^\.\//, '');
                 if (graphFiles.has(normalizedFile))
@@ -1399,12 +1495,12 @@ export class LocalBackend {
         const { target, direction } = params;
         const maxDepth = params.maxDepth || 3;
         const rawRelTypes = params.relationTypes && params.relationTypes.length > 0
-            ? params.relationTypes.filter(t => VALID_RELATION_TYPES.has(t))
+            ? params.relationTypes.filter((t) => VALID_RELATION_TYPES.has(t))
             : ['CALLS', 'IMPORTS', 'EXTENDS', 'IMPLEMENTS'];
         const relationTypes = rawRelTypes.length > 0 ? rawRelTypes : ['CALLS', 'IMPORTS', 'EXTENDS', 'IMPLEMENTS'];
         const includeTests = params.includeTests ?? false;
         const minConfidence = params.minConfidence ?? 0;
-        const relTypeFilter = relationTypes.map(t => `'${t}'`).join(', ');
+        const relTypeFilter = relationTypes.map((t) => `'${t}'`).join(', ');
         const confidenceFilter = minConfidence > 0 ? ` AND r.confidence >= ${minConfidence}` : '';
         // Resolve target by name, preferring Class/Interface over Constructor
         // (fix #480: Java class and constructor share the same name).
@@ -1438,7 +1534,9 @@ export class LocalBackend {
                 symType = priorityToLabel[best.priority ?? best[3]] ?? '';
             }
         }
-        catch { /* fall through to unlabeled match */ }
+        catch {
+            /* fall through to unlabeled match */
+        }
         // Fall back to unlabeled match for any other node type
         if (!sym) {
             const rows = await executeParameterized(repo.id, `
@@ -1503,7 +1601,7 @@ export class LocalBackend {
         for (let depth = 1; depth <= maxDepth && frontier.length > 0; depth++) {
             const nextFrontier = [];
             // Batch frontier nodes into a single Cypher query per depth level
-            const idList = frontier.map(id => `'${id.replace(/'/g, "''")}'`).join(', ');
+            const idList = frontier.map((id) => `'${id.replace(/'/g, "''")}'`).join(', ');
             const query = direction === 'upstream'
                 ? `MATCH (caller)-[r:CodeRelation]->(n) WHERE n.id IN [${idList}] AND r.type IN [${relTypeFilter}]${confidenceFilter} RETURN n.id AS sourceId, caller.id AS id, caller.name AS name, labels(caller)[0] AS type, caller.filePath AS filePath, r.type AS relType, r.confidence AS confidence`
                 : `MATCH (n)-[r:CodeRelation]->(callee) WHERE n.id IN [${idList}] AND r.type IN [${relTypeFilter}]${confidenceFilter} RETURN n.id AS sourceId, callee.id AS id, callee.name AS name, labels(callee)[0] AS type, callee.filePath AS filePath, r.type AS relType, r.confidence AS confidence`;
@@ -1572,7 +1670,7 @@ export class LocalBackend {
             let chunksProcessed = 0;
             for (let i = 0; i < impacted.length && chunksProcessed < MAX_CHUNKS; i += CHUNK_SIZE, chunksProcessed++) {
                 const chunk = impacted.slice(i, i + CHUNK_SIZE);
-                const ids = chunk.map(item => String(item.id ?? ''));
+                const ids = chunk.map((item) => String(item.id ?? ''));
                 try {
                     // Use parameterized list to avoid building long query strings
                     const rows = await executeParameterized(repo.id, `
@@ -1593,14 +1691,16 @@ export class LocalBackend {
                         // Normalize epName: prefer epName, fall back to other columns, and
                         // ensure we don't keep an empty string (labels(...) can return "").
                         const epNameRaw = row.epName ?? row[7] ?? row.name ?? row[1] ?? 'unknown';
-                        const epName = (typeof epNameRaw === 'string' && epNameRaw.trim().length > 0) ? epNameRaw.trim() : 'unknown';
+                        const epName = typeof epNameRaw === 'string' && epNameRaw.trim().length > 0
+                            ? epNameRaw.trim()
+                            : 'unknown';
                         // Normalize epType: labels(ep)[0] can return an empty string in
                         // some DBs (LadybugDB). Using nullish coalescing (??) preserves
                         // empty strings, which results in empty `type` values being
                         // propagated. Treat empty-string labels as missing and fall back
                         // to the next candidate or a sensible default.
                         const epTypeRaw = row.epType ?? row[8] ?? '';
-                        const epType = (typeof epTypeRaw === 'string' && epTypeRaw.trim().length > 0)
+                        const epType = typeof epTypeRaw === 'string' && epTypeRaw.trim().length > 0
                             ? epTypeRaw.trim()
                             : 'Function';
                         const epFilePath = row.epFilePath ?? row[9] ?? '';
@@ -1638,7 +1738,7 @@ export class LocalBackend {
             if (processesMissingMinStep.size > 0) {
                 try {
                     const pIds = Array.from(processesMissingMinStep);
-                    const allImpactedIds = impacted.map(it => String(it.id ?? ''));
+                    const allImpactedIds = impacted.map((it) => String(it.id ?? ''));
                     const missingRows = await executeParameterized(repo.id, `
             MATCH (s)-[r:CodeRelation {type: 'STEP_IN_PROCESS'}]->(p:Process)
             WHERE p.id IN $pIds AND s.id IN $ids
@@ -1667,7 +1767,7 @@ export class LocalBackend {
                 traversalComplete = false;
             }
             affectedProcesses = Array.from(entryPointMap.values())
-                .map(ep => ({
+                .map((ep) => ({
                 ...ep,
                 earliest_broken_step: ep.earliest_broken_step === Infinity ? null : ep.earliest_broken_step,
             }))
@@ -1741,7 +1841,7 @@ export class LocalBackend {
                 .map(([name, hits]) => ({ name, hits }))
                 .sort((a, b) => b.hits - a.hits)
                 .slice(0, 20);
-            const directModuleRows = Array.from(directModuleSet).map(name => ({ name }));
+            const directModuleRows = Array.from(directModuleSet).map((name) => ({ name }));
             // Build affectedModules in the same shape as original implementation
             const directModuleNameSet = new Set(directModuleRows.map((r) => r.name || r[0]));
             affectedModules = moduleRows.map((r) => {
@@ -1761,7 +1861,10 @@ export class LocalBackend {
         if (directCount >= 30 || processCount >= 5 || moduleCount >= 5 || impacted.length >= 200) {
             risk = 'CRITICAL';
         }
-        else if (directCount >= 15 || processCount >= 3 || moduleCount >= 3 || impacted.length >= 100) {
+        else if (directCount >= 15 ||
+            processCount >= 3 ||
+            moduleCount >= 3 ||
+            impacted.length >= 100) {
             risk = 'HIGH';
         }
         else if (directCount >= 5 || impacted.length >= 30) {
@@ -1805,7 +1908,7 @@ export class LocalBackend {
     `, params);
         // Strip wrapping quotes from DB array elements — CSV COPY stores ['key'] which
         // LadybugDB may return as "'key'" rather than "key"
-        const stripQuotes = (keys) => keys ? keys.map(k => k.replace(/^['"]|['"]$/g, '')) : null;
+        const stripQuotes = (keys) => keys ? keys.map((k) => k.replace(/^['"]|['"]$/g, '')) : null;
         const routeMap = new Map();
         for (const row of rows) {
             const id = row.routeId ?? row[0];
@@ -1818,7 +1921,15 @@ export class LocalBackend {
             const consumerFile = row.consumerFile ?? row[7];
             const fetchReason = row.fetchReason ?? row[8] ?? null;
             if (!routeMap.has(id)) {
-                routeMap.set(id, { id, name, filePath, responseKeys, errorKeys, middleware, consumers: [] });
+                routeMap.set(id, {
+                    id,
+                    name,
+                    filePath,
+                    responseKeys,
+                    errorKeys,
+                    middleware,
+                    consumers: [],
+                });
             }
             if (consumerName && consumerFile) {
                 // Parse accessed keys from reason field: "fetch-url-match|keys:data,pagination|fetches:3"
@@ -1827,7 +1938,7 @@ export class LocalBackend {
                 if (fetchReason) {
                     const keysMatch = fetchReason.match(/\|keys:([^|]+)/);
                     if (keysMatch) {
-                        accessedKeys = keysMatch[1].split(',').filter(k => k.length > 0);
+                        accessedKeys = keysMatch[1].split(',').filter((k) => k.length > 0);
                     }
                     const fetchesMatch = fetchReason.match(/\|fetches:(\d+)/);
                     if (fetchesMatch) {
@@ -1873,7 +1984,9 @@ export class LocalBackend {
                 list.push(name);
             }
         }
-        catch { /* no ENTRY_POINT_OF edges yet */ }
+        catch {
+            /* no ENTRY_POINT_OF edges yet */
+        }
         return result;
     }
     async routeMap(repo, params) {
@@ -1882,12 +1995,19 @@ export class LocalBackend {
         const queryParams = params.route ? { route: params.route } : {};
         const routes = await this.fetchRoutesWithConsumers(repo.id, routeFilter, queryParams);
         if (routes.length === 0) {
-            return { routes: [], total: 0, message: params.route ? `No routes matching "${params.route}"` : 'No routes found in this project.' };
+            return {
+                routes: [],
+                total: 0,
+                message: params.route
+                    ? `No routes matching "${params.route}"`
+                    : 'No routes found in this project.',
+            };
         }
-        const flowMap = await this.fetchLinkedFlowsBatch(repo.id, routes.map(r => r.id));
+        const flowMap = await this.fetchLinkedFlowsBatch(repo.id, routes.map((r) => r.id));
         return {
-            routes: routes.map(r => ({
-                route: r.name, handler: r.filePath,
+            routes: routes.map((r) => ({
+                route: r.name,
+                handler: r.filePath,
                 middleware: r.middleware || [],
                 consumers: r.consumers,
                 flows: flowMap.get(r.id) || [],
@@ -1901,8 +2021,10 @@ export class LocalBackend {
         const queryParams = params.route ? { route: params.route } : {};
         const allRoutes = await this.fetchRoutesWithConsumers(repo.id, routeFilter, queryParams);
         const results = allRoutes
-            .filter(r => ((r.responseKeys && r.responseKeys.length > 0) || (r.errorKeys && r.errorKeys.length > 0)) && r.consumers.length > 0)
-            .map(r => {
+            .filter((r) => ((r.responseKeys && r.responseKeys.length > 0) ||
+            (r.errorKeys && r.errorKeys.length > 0)) &&
+            r.consumers.length > 0)
+            .map((r) => {
             // Keys already normalized by fetchRoutesWithConsumers (quotes stripped)
             const responseKeys = r.responseKeys ?? [];
             const errorKeys = r.errorKeys ?? [];
@@ -1910,24 +2032,33 @@ export class LocalBackend {
             const allKnownKeys = new Set([...responseKeys, ...errorKeys]);
             // Check each consumer's accessed keys against the route's response shape
             const responseKeySet = new Set(responseKeys);
-            const consumers = r.consumers.map(c => {
+            const consumers = r.consumers.map((c) => {
                 if (!c.accessedKeys || c.accessedKeys.length === 0) {
                     return { name: c.name, filePath: c.filePath };
                 }
-                const mismatched = c.accessedKeys.filter(k => !allKnownKeys.has(k));
+                const mismatched = c.accessedKeys.filter((k) => !allKnownKeys.has(k));
                 // Keys in allKnownKeys but not in responseKeys — error-path access (e.g., .error from errorKeys)
-                const errorPathKeys = c.accessedKeys.filter(k => allKnownKeys.has(k) && !responseKeySet.has(k));
+                const errorPathKeys = c.accessedKeys.filter((k) => allKnownKeys.has(k) && !responseKeySet.has(k));
                 const isMultiFetch = (c.fetchCount ?? 1) > 1;
                 return {
                     name: c.name,
                     filePath: c.filePath,
                     accessedKeys: c.accessedKeys,
-                    ...(mismatched.length > 0 ? { mismatched, mismatchConfidence: isMultiFetch ? 'low' : 'high' } : {}),
+                    ...(mismatched.length > 0
+                        ? {
+                            mismatched,
+                            mismatchConfidence: isMultiFetch ? 'low' : 'high',
+                        }
+                        : {}),
                     ...(errorPathKeys.length > 0 ? { errorPathKeys } : {}),
-                    ...(isMultiFetch ? { attributionNote: `This file fetches ${c.fetchCount} routes — accessed keys may belong to a different route.` } : {}),
+                    ...(isMultiFetch
+                        ? {
+                            attributionNote: `This file fetches ${c.fetchCount} routes — accessed keys may belong to a different route.`,
+                        }
+                        : {}),
                 };
             });
-            const hasMismatches = consumers.some(c => 'mismatched' in c && c.mismatched.length > 0);
+            const hasMismatches = consumers.some((c) => 'mismatched' in c && c.mismatched.length > 0);
             return {
                 route: r.name,
                 handler: r.filePath,
@@ -1937,7 +2068,7 @@ export class LocalBackend {
                 ...(hasMismatches ? { status: 'MISMATCH' } : {}),
             };
         });
-        const mismatchCount = results.filter(r => r.status === 'MISMATCH').length;
+        const mismatchCount = results.filter((r) => r.status === 'MISMATCH').length;
         return {
             routes: results,
             total: results.length,
@@ -1960,7 +2091,11 @@ export class LocalBackend {
       RETURN n.id AS id, n.name AS name, n.filePath AS filePath, n.description AS description
     `, queryParams);
         if (rows.length === 0) {
-            return { tools: [], total: 0, message: params.tool ? `No tools matching "${params.tool}"` : 'No tool definitions found.' };
+            return {
+                tools: [],
+                total: 0,
+                message: params.tool ? `No tools matching "${params.tool}"` : 'No tool definitions found.',
+            };
         }
         const toolIds = rows.map((r) => r.id ?? r[0]);
         const flowMap = await this.fetchLinkedFlowsBatch(repo.id, toolIds);
@@ -1998,7 +2133,7 @@ export class LocalBackend {
             const target = params.route || params.file;
             return { error: `No routes found matching "${target}".` };
         }
-        const flowMap = await this.fetchLinkedFlowsBatch(repo.id, routes.map(r => r.id));
+        const flowMap = await this.fetchLinkedFlowsBatch(repo.id, routes.map((r) => r.id));
         // Count how many routes share the same handler file (for middleware partial detection)
         const routeCountByHandler = new Map();
         for (const r of routes) {
@@ -2006,17 +2141,21 @@ export class LocalBackend {
                 routeCountByHandler.set(r.filePath, (routeCountByHandler.get(r.filePath) ?? 0) + 1);
             }
         }
-        const results = routes.map(r => {
+        const results = routes.map((r) => {
             // Keys already normalized by fetchRoutesWithConsumers (quotes stripped)
             const responseKeys = r.responseKeys ?? [];
             const errorKeys = r.errorKeys ?? [];
             const allKnownKeys = new Set([...responseKeys, ...errorKeys]);
             // Build consumer list with mismatch detection
-            const consumers = r.consumers.map(c => ({
+            const consumers = r.consumers.map((c) => ({
                 name: c.name,
                 file: c.filePath,
                 accesses: c.accessedKeys ?? [],
-                ...(c.fetchCount && c.fetchCount > 1 ? { attributionNote: `This file fetches ${c.fetchCount} routes — accessed keys may belong to a different route.` } : {}),
+                ...(c.fetchCount && c.fetchCount > 1
+                    ? {
+                        attributionNote: `This file fetches ${c.fetchCount} routes — accessed keys may belong to a different route.`,
+                    }
+                    : {}),
             }));
             // Detect mismatches: consumer accesses keys not in response shape
             const mismatches = [];
@@ -2073,10 +2212,12 @@ export class LocalBackend {
                     error: errorKeys,
                 },
                 middleware: middlewareArr,
-                ...(middlewarePartial ? {
-                    middlewareDetection: 'partial',
-                    middlewareNote: 'Middleware captured from first HTTP method export only — other methods in this handler may use different middleware chains.',
-                } : {}),
+                ...(middlewarePartial
+                    ? {
+                        middlewareDetection: 'partial',
+                        middlewareNote: 'Middleware captured from first HTTP method export only — other methods in this handler may use different middleware chains.',
+                    }
+                    : {}),
                 consumers,
                 ...(mismatches.length > 0 ? { mismatches } : {}),
                 executionFlows: flows,
@@ -2166,8 +2307,11 @@ export class LocalBackend {
         if (clusters.length === 0)
             return { error: `Cluster '${name}' not found` };
         const rawClusters = clusters.map((c) => ({
-            id: c.id || c[0], label: c.label || c[1], heuristicLabel: c.heuristicLabel || c[2],
-            cohesion: c.cohesion || c[3], symbolCount: c.symbolCount || c[4],
+            id: c.id || c[0],
+            label: c.label || c[1],
+            heuristicLabel: c.heuristicLabel || c[2],
+            cohesion: c.cohesion || c[3],
+            symbolCount: c.symbolCount || c[4],
         }));
         let totalSymbols = 0, weightedCohesion = 0;
         for (const c of rawClusters) {
@@ -2191,7 +2335,9 @@ export class LocalBackend {
                 subCommunities: rawClusters.length,
             },
             members: members.map((m) => ({
-                name: m.name || m[0], type: m.type || m[1], filePath: m.filePath || m[2],
+                name: m.name || m[0],
+                type: m.type || m[1],
+                filePath: m.filePath || m[2],
             })),
         };
     }
@@ -2219,11 +2365,17 @@ export class LocalBackend {
     `, { procId });
         return {
             process: {
-                id: procId, label: proc.label || proc[1], heuristicLabel: proc.heuristicLabel || proc[2],
-                processType: proc.processType || proc[3], stepCount: proc.stepCount || proc[4],
+                id: procId,
+                label: proc.label || proc[1],
+                heuristicLabel: proc.heuristicLabel || proc[2],
+                processType: proc.processType || proc[3],
+                stepCount: proc.stepCount || proc[4],
             },
             steps: steps.map((s) => ({
-                step: s.step || s[3], name: s.name || s[0], type: s.type || s[1], filePath: s.filePath || s[2],
+                step: s.step || s[3],
+                name: s.name || s[0],
+                type: s.type || s[1],
+                filePath: s.filePath || s[2],
             })),
         };
     }