gitnexus 1.2.6 → 1.2.7

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

@@ -44,9 +44,20 @@ export class LocalBackend {
      * Returns true if at least one repo is available.
      */
     async init() {
+        await this.refreshRepos();
+        return this.repos.size > 0;
+    }
+    /**
+     * 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).
+     */
+    async refreshRepos() {
         const entries = await listRegisteredRepos({ validate: true });
+        const freshIds = new Set();
         for (const entry of entries) {
             const id = this.repoId(entry.name, entry.path);
+            freshIds.add(id);
             const storagePath = entry.storagePath;
             const kuzuPath = path.join(storagePath, 'kuzu');
             const handle = {
@@ -72,7 +83,14 @@ export class LocalBackend {
                 },
             });
         }
-        return this.repos.size > 0;
+        // Prune repos that no longer exist in the registry
+        for (const id of this.repos.keys()) {
+            if (!freshIds.has(id)) {
+                this.repos.delete(id);
+                this.contextCache.delete(id);
+                this.initializedRepos.delete(id);
+            }
+        }
     }
     /**
      * Generate a stable repo ID from name + path.
@@ -96,11 +114,36 @@ export class LocalBackend {
      * - If repoParam is given, match by name or path
      * - If only 1 repo, use it
      * - If 0 or multiple without param, throw with helpful message
+     *
+     * On a miss, re-reads the registry once in case a new repo was indexed
+     * while the MCP server was running.
      */
-    resolveRepo(repoParam) {
+    async resolveRepo(repoParam) {
+        const result = this.resolveRepoFromCache(repoParam);
+        if (result)
+            return result;
+        // Miss — refresh registry and try once more
+        await this.refreshRepos();
+        const retried = this.resolveRepoFromCache(repoParam);
+        if (retried)
+            return retried;
+        // Still no match — throw with helpful message
         if (this.repos.size === 0) {
             throw new Error('No indexed repositories. Run: gitnexus analyze');
         }
+        if (repoParam) {
+            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);
+        throw new Error(`Multiple repositories indexed. Specify which one with the "repo" parameter. Available: ${names.join(', ')}`);
+    }
+    /**
+     * Try to resolve a repo from the in-memory cache. Returns null on miss.
+     */
+    resolveRepoFromCache(repoParam) {
+        if (this.repos.size === 0)
+            return null;
         if (repoParam) {
             const paramLower = repoParam.toLowerCase();
             // Match by id
@@ -122,14 +165,12 @@ export class LocalBackend {
                 if (handle.name.toLowerCase().includes(paramLower))
                     return handle;
             }
-            const names = [...this.repos.values()].map(h => h.name);
-            throw new Error(`Repository "${repoParam}" not found. Available: ${names.join(', ')}`);
+            return null;
         }
         if (this.repos.size === 1) {
             return this.repos.values().next().value;
         }
-        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(', ')}`);
+        return null; // Multiple repos, no param — ambiguous
     }
     // ─── Lazy KuzuDB Init ────────────────────────────────────────────
     async ensureInitialized(repoId) {
@@ -164,8 +205,11 @@ export class LocalBackend {
     }
     /**
      * List all registered repos with their metadata.
+     * Re-reads the global registry so newly indexed repos are discovered
+     * without restarting the MCP server.
      */
-    listRepos() {
+    async listRepos() {
+        await this.refreshRepos();
         return [...this.repos.values()].map(h => ({
             name: h.name,
             path: h.repoPath,
@@ -179,8 +223,8 @@ export class LocalBackend {
         if (method === 'list_repos') {
             return this.listRepos();
         }
-        // Resolve repo from optional param
-        const repo = this.resolveRepo(params?.repo);
+        // Resolve repo from optional param (re-reads registry on miss)
+        const repo = await this.resolveRepo(params?.repo);
         switch (method) {
             case 'query':
                 return this.query(repo, params);
@@ -276,19 +320,19 @@ export class LocalBackend {
             // Find processes this symbol participates in
             let processRows = [];
             try {
-                processRows = await executeQuery(repo.id, `
-          MATCH (n {id: '${escaped}'})-[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 executeQuery(repo.id, `
+          MATCH (n {id: '${escaped}'})-[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
         `);
             }
             catch { /* symbol might not be in any process */ }
             // Get cluster cohesion as internal ranking signal (never exposed)
             let cohesion = 0;
             try {
-                const cohesionRows = await executeQuery(repo.id, `
-          MATCH (n {id: '${escaped}'})-[:CodeRelation {type: 'MEMBER_OF'}]->(c:Community)
-          RETURN c.cohesion AS cohesion
-          LIMIT 1
+                const cohesionRows = await executeQuery(repo.id, `
+          MATCH (n {id: '${escaped}'})-[:CodeRelation {type: 'MEMBER_OF'}]->(c:Community)
+          RETURN c.cohesion AS cohesion
+          LIMIT 1
         `);
                 if (cohesionRows.length > 0) {
                     cohesion = (cohesionRows[0].cohesion ?? cohesionRows[0][0]) || 0;
@@ -299,9 +343,9 @@ export class LocalBackend {
             let content;
             if (includeContent) {
                 try {
-                    const contentRows = await executeQuery(repo.id, `
-            MATCH (n {id: '${escaped}'})
-            RETURN n.content AS content
+                    const contentRows = await executeQuery(repo.id, `
+            MATCH (n {id: '${escaped}'})
+            RETURN n.content AS content
           `);
                     if (contentRows.length > 0) {
                         content = contentRows[0].content ?? contentRows[0][0];
@@ -406,11 +450,11 @@ export class LocalBackend {
         for (const bm25Result of bm25Results) {
             const fullPath = bm25Result.filePath;
             try {
-                const symbolQuery = `
-          MATCH (n) 
-          WHERE n.filePath = '${fullPath.replace(/'/g, "''")}'
-          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 symbolQuery = `
+          MATCH (n) 
+          WHERE n.filePath = '${fullPath.replace(/'/g, "''")}'
+          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 executeQuery(repo.id, symbolQuery);
                 if (symbols.length > 0) {
@@ -456,14 +500,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)
@@ -568,11 +612,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],
@@ -589,11 +633,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],
@@ -624,10 +668,10 @@ export class LocalBackend {
         let symbols;
         if (uid) {
             const escaped = uid.replace(/'/g, "''");
-            symbols = await executeQuery(repo.id, `
-        MATCH (n {id: '${escaped}'})
-        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 executeQuery(repo.id, `
+        MATCH (n {id: '${escaped}'})
+        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
       `);
         }
         else {
@@ -644,10 +688,10 @@ export class LocalBackend {
             else {
                 whereClause = `WHERE n.name = '${escaped}'`;
             }
-            symbols = await executeQuery(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 executeQuery(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
       `);
         }
         if (symbols.length === 0) {
@@ -671,25 +715,25 @@ export class LocalBackend {
         const sym = symbols[0];
         const symId = (sym.id || sym[0]).replace(/'/g, "''");
         // Categorized incoming refs
-        const incomingRows = await executeQuery(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 executeQuery(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
     `);
         // Categorized outgoing refs
-        const outgoingRows = await executeQuery(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 executeQuery(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
     `);
         // Process participation
         let processRows = [];
         try {
-            processRows = await executeQuery(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 executeQuery(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
       `);
         }
         catch { /* no process info */ }
@@ -743,10 +787,10 @@ export class LocalBackend {
         }
         if (type === 'cluster') {
             const escaped = name.replace(/'/g, "''");
-            const clusterQuery = `
-        MATCH (c:Community)
-        WHERE c.label = '${escaped}' OR c.heuristicLabel = '${escaped}'
-        RETURN c.id AS id, c.label AS label, c.heuristicLabel AS heuristicLabel, c.cohesion AS cohesion, c.symbolCount AS symbolCount
+            const clusterQuery = `
+        MATCH (c:Community)
+        WHERE c.label = '${escaped}' OR c.heuristicLabel = '${escaped}'
+        RETURN c.id AS id, c.label AS label, c.heuristicLabel AS heuristicLabel, c.cohesion AS cohesion, c.symbolCount AS symbolCount
       `;
             const clusters = await executeQuery(repo.id, clusterQuery);
             if (clusters.length === 0)
@@ -761,11 +805,11 @@ export class LocalBackend {
                 totalSymbols += s;
                 weightedCohesion += (c.cohesion || 0) * s;
             }
-            const members = await executeQuery(repo.id, `
-        MATCH (n)-[:CodeRelation {type: 'MEMBER_OF'}]->(c:Community)
-        WHERE c.label = '${escaped}' OR c.heuristicLabel = '${escaped}'
-        RETURN DISTINCT n.name AS name, labels(n)[0] AS type, n.filePath AS filePath
-        LIMIT 30
+            const members = await executeQuery(repo.id, `
+        MATCH (n)-[:CodeRelation {type: 'MEMBER_OF'}]->(c:Community)
+        WHERE c.label = '${escaped}' OR c.heuristicLabel = '${escaped}'
+        RETURN DISTINCT n.name AS name, labels(n)[0] AS type, n.filePath AS filePath
+        LIMIT 30
       `);
             return {
                 cluster: {
@@ -782,20 +826,20 @@ export class LocalBackend {
             };
         }
         if (type === 'process') {
-            const processes = await executeQuery(repo.id, `
-        MATCH (p:Process)
-        WHERE p.label = '${name.replace(/'/g, "''")}' OR p.heuristicLabel = '${name.replace(/'/g, "''")}'
-        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 executeQuery(repo.id, `
+        MATCH (p:Process)
+        WHERE p.label = '${name.replace(/'/g, "''")}' OR p.heuristicLabel = '${name.replace(/'/g, "''")}'
+        RETURN p.id AS id, p.label AS label, p.heuristicLabel AS heuristicLabel, p.processType AS processType, p.stepCount AS stepCount
+        LIMIT 1
       `);
             if (processes.length === 0)
                 return { error: `Process '${name}' not found` };
             const proc = processes[0];
             const procId = proc.id || proc[0];
-            const steps = await executeQuery(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 executeQuery(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
       `);
             return {
                 process: {
@@ -856,10 +900,10 @@ export class LocalBackend {
         for (const file of changedFiles) {
             const escaped = file.replace(/\\/g, '/').replace(/'/g, "''");
             try {
-                const symbols = await executeQuery(repo.id, `
-          MATCH (n) WHERE n.filePath CONTAINS '${escaped}'
-          RETURN n.id AS id, n.name AS name, labels(n)[0] AS type, n.filePath AS filePath
-          LIMIT 20
+                const symbols = await executeQuery(repo.id, `
+          MATCH (n) WHERE n.filePath CONTAINS '${escaped}'
+          RETURN n.id AS id, n.name AS name, labels(n)[0] AS type, n.filePath AS filePath
+          LIMIT 20
         `);
                 for (const sym of symbols) {
                     changedSymbols.push({
@@ -878,9 +922,9 @@ export class LocalBackend {
         for (const sym of changedSymbols) {
             const escaped = sym.id.replace(/'/g, "''");
             try {
-                const procs = await executeQuery(repo.id, `
-          MATCH (n {id: '${escaped}'})-[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 executeQuery(repo.id, `
+          MATCH (n {id: '${escaped}'})-[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
         `);
                 for (const proc of procs) {
                     const pid = proc.pid || proc[0];
@@ -1055,11 +1099,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 targetQuery = `
-      MATCH (n)
-      WHERE n.name = '${target.replace(/'/g, "''")}'
-      RETURN n.id AS id, n.name AS name, labels(n)[0] AS type, n.filePath AS filePath
-      LIMIT 1
+        const targetQuery = `
+      MATCH (n)
+      WHERE n.name = '${target.replace(/'/g, "''")}'
+      RETURN n.id AS id, n.name AS name, labels(n)[0] AS type, n.filePath AS filePath
+      LIMIT 1
     `;
         const targets = await executeQuery(repo.id, targetQuery);
         if (targets.length === 0)
@@ -1125,15 +1169,15 @@ export class LocalBackend {
      * Used by getClustersResource — avoids legacy overview() dispatch.
      */
     async queryClusters(repoName, limit = 100) {
-        const repo = this.resolveRepo(repoName);
+        const repo = await this.resolveRepo(repoName);
         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],
@@ -1153,14 +1197,14 @@ export class LocalBackend {
      * Used by getProcessesResource — avoids legacy overview() dispatch.
      */
     async queryProcesses(repoName, limit = 50) {
-        const repo = this.resolveRepo(repoName);
+        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) => ({
@@ -1181,13 +1225,13 @@ export class LocalBackend {
      * Used by getClusterDetailResource.
      */
     async queryClusterDetail(name, repoName) {
-        const repo = this.resolveRepo(repoName);
+        const repo = await this.resolveRepo(repoName);
         await this.ensureInitialized(repo.id);
         const escaped = name.replace(/'/g, "''");
-        const clusterQuery = `
-      MATCH (c:Community)
-      WHERE c.label = '${escaped}' OR c.heuristicLabel = '${escaped}'
-      RETURN c.id AS id, c.label AS label, c.heuristicLabel AS heuristicLabel, c.cohesion AS cohesion, c.symbolCount AS symbolCount
+        const clusterQuery = `
+      MATCH (c:Community)
+      WHERE c.label = '${escaped}' OR c.heuristicLabel = '${escaped}'
+      RETURN c.id AS id, c.label AS label, c.heuristicLabel AS heuristicLabel, c.cohesion AS cohesion, c.symbolCount AS symbolCount
     `;
         const clusters = await executeQuery(repo.id, clusterQuery);
         if (clusters.length === 0)
@@ -1202,11 +1246,11 @@ export class LocalBackend {
             totalSymbols += s;
             weightedCohesion += (c.cohesion || 0) * s;
         }
-        const members = await executeQuery(repo.id, `
-      MATCH (n)-[:CodeRelation {type: 'MEMBER_OF'}]->(c:Community)
-      WHERE c.label = '${escaped}' OR c.heuristicLabel = '${escaped}'
-      RETURN DISTINCT n.name AS name, labels(n)[0] AS type, n.filePath AS filePath
-      LIMIT 30
+        const members = await executeQuery(repo.id, `
+      MATCH (n)-[:CodeRelation {type: 'MEMBER_OF'}]->(c:Community)
+      WHERE c.label = '${escaped}' OR c.heuristicLabel = '${escaped}'
+      RETURN DISTINCT n.name AS name, labels(n)[0] AS type, n.filePath AS filePath
+      LIMIT 30
     `);
         return {
             cluster: {
@@ -1227,23 +1271,23 @@ export class LocalBackend {
      * Used by getProcessDetailResource.
      */
     async queryProcessDetail(name, repoName) {
-        const repo = this.resolveRepo(repoName);
+        const repo = await this.resolveRepo(repoName);
         await this.ensureInitialized(repo.id);
         const escaped = name.replace(/'/g, "''");
-        const processes = await executeQuery(repo.id, `
-      MATCH (p:Process)
-      WHERE p.label = '${escaped}' OR p.heuristicLabel = '${escaped}'
-      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 executeQuery(repo.id, `
+      MATCH (p:Process)
+      WHERE p.label = '${escaped}' OR p.heuristicLabel = '${escaped}'
+      RETURN p.id AS id, p.label AS label, p.heuristicLabel AS heuristicLabel, p.processType AS processType, p.stepCount AS stepCount
+      LIMIT 1
     `);
         if (processes.length === 0)
             return { error: `Process '${name}' not found` };
         const proc = processes[0];
         const procId = proc.id || proc[0];
-        const steps = await executeQuery(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 executeQuery(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
     `);
         return {
             process: {

package/dist/mcp/resources.js

@@ -125,8 +125,8 @@ export async function readResource(uri, backend) {
 /**
  * Repos resource — list all indexed repositories
  */
-function getReposResource(backend) {
-    const repos = backend.listRepos();
+async function getReposResource(backend) {
+    const repos = await backend.listRepos();
     if (repos.length === 0) {
         return 'repos: []\n# No repositories indexed. Run: gitnexus analyze';
     }
@@ -154,7 +154,7 @@ function getReposResource(backend) {
  */
 async function getContextResource(backend, repoName) {
     // Resolve repo
-    const repo = backend.resolveRepo(repoName);
+    const repo = await backend.resolveRepo(repoName);
     const repoId = repo.name.toLowerCase();
     const context = backend.getContext(repoId) || backend.getContext();
     if (!context) {
@@ -256,48 +256,48 @@ async function getProcessesResource(backend, repoName) {
  * Schema resource — graph structure for Cypher queries
  */
 function getSchemaResource() {
-    return `# GitNexus Graph Schema
-
-nodes:
-  - File: Source code files
-  - Folder: Directory containers
-  - Function: Functions and arrow functions
-  - Class: Class definitions
-  - Interface: Interface/type definitions
-  - Method: Class methods
-  - CodeElement: Catch-all for other code elements
-  - Community: Auto-detected functional area (Leiden algorithm)
-  - Process: Execution flow trace
-
-additional_node_types: "Multi-language: Struct, Enum, Macro, Typedef, Union, Namespace, Trait, Impl, TypeAlias, Const, Static, Property, Record, Delegate, Annotation, Constructor, Template, Module (use backticks in queries: \`Struct\`, \`Enum\`, etc.)"
-
-relationships:
-  - CONTAINS: File/Folder contains child
-  - DEFINES: File defines a symbol
-  - CALLS: Function/method invocation
-  - IMPORTS: Module imports
-  - EXTENDS: Class inheritance
-  - IMPLEMENTS: Interface implementation
-  - MEMBER_OF: Symbol belongs to community
-  - STEP_IN_PROCESS: Symbol is step N in process
-
-relationship_table: "All relationships use a single CodeRelation table with a 'type' property. Properties: type (STRING), confidence (DOUBLE), reason (STRING), step (INT32)"
-
-example_queries:
-  find_callers: |
-    MATCH (caller)-[:CodeRelation {type: 'CALLS'}]->(f:Function {name: "myFunc"})
-    RETURN caller.name, caller.filePath
-  
-  find_community_members: |
-    MATCH (s)-[:CodeRelation {type: 'MEMBER_OF'}]->(c:Community)
-    WHERE c.heuristicLabel = "Auth"
-    RETURN s.name, labels(s)[0] AS type
-  
-  trace_process: |
-    MATCH (s)-[r:CodeRelation {type: 'STEP_IN_PROCESS'}]->(p:Process)
-    WHERE p.heuristicLabel = "LoginFlow"
-    RETURN s.name, r.step
-    ORDER BY r.step
+    return `# GitNexus Graph Schema
+
+nodes:
+  - File: Source code files
+  - Folder: Directory containers
+  - Function: Functions and arrow functions
+  - Class: Class definitions
+  - Interface: Interface/type definitions
+  - Method: Class methods
+  - CodeElement: Catch-all for other code elements
+  - Community: Auto-detected functional area (Leiden algorithm)
+  - Process: Execution flow trace
+
+additional_node_types: "Multi-language: Struct, Enum, Macro, Typedef, Union, Namespace, Trait, Impl, TypeAlias, Const, Static, Property, Record, Delegate, Annotation, Constructor, Template, Module (use backticks in queries: \`Struct\`, \`Enum\`, etc.)"
+
+relationships:
+  - CONTAINS: File/Folder contains child
+  - DEFINES: File defines a symbol
+  - CALLS: Function/method invocation
+  - IMPORTS: Module imports
+  - EXTENDS: Class inheritance
+  - IMPLEMENTS: Interface implementation
+  - MEMBER_OF: Symbol belongs to community
+  - STEP_IN_PROCESS: Symbol is step N in process
+
+relationship_table: "All relationships use a single CodeRelation table with a 'type' property. Properties: type (STRING), confidence (DOUBLE), reason (STRING), step (INT32)"
+
+example_queries:
+  find_callers: |
+    MATCH (caller)-[:CodeRelation {type: 'CALLS'}]->(f:Function {name: "myFunc"})
+    RETURN caller.name, caller.filePath
+  
+  find_community_members: |
+    MATCH (s)-[:CodeRelation {type: 'MEMBER_OF'}]->(c:Community)
+    WHERE c.heuristicLabel = "Auth"
+    RETURN s.name, labels(s)[0] AS type
+  
+  trace_process: |
+    MATCH (s)-[r:CodeRelation {type: 'STEP_IN_PROCESS'}]->(p:Process)
+    WHERE p.heuristicLabel = "LoginFlow"
+    RETURN s.name, r.step
+    ORDER BY r.step
 `;
 }
 /**
@@ -370,7 +370,7 @@ async function getProcessDetailResource(name, backend, repoName) {
  * Useful for `gitnexus setup` onboarding or dynamic content injection.
  */
 async function getSetupResource(backend) {
-    const repos = backend.listRepos();
+    const repos = await backend.listRepos();
     if (repos.length === 0) {
         return '# GitNexus\n\nNo repositories indexed. Run: `npx gitnexus analyze` in a repository.';
     }