gitnexus 1.2.6 → 1.2.8

package/dist/core/search/hybrid-search.js

@@ -98,9 +98,9 @@ export const formatHybridResults = (results) => {
         const location = r.startLine ? ` (lines ${r.startLine}-${r.endLine})` : '';
         const label = r.label ? `${r.label}: ` : 'File: ';
         const name = r.name || r.filePath.split('/').pop() || r.filePath;
-        return `[${i + 1}] ${label}${name}
-    File: ${r.filePath}${location}
-    Found by: ${sources}
+        return `[${i + 1}] ${label}${name}
+    File: ${r.filePath}${location}
+    Found by: ${sources}
     Relevance: ${r.score.toFixed(4)}`;
     });
     return `Found ${results.length} results:\n\n${formatted.join('\n\n')}`;

package/dist/core/wiki/graph-queries.js

@@ -22,11 +22,11 @@ export async function closeWikiDb() {
  * Get all source files with their exported symbol names and types.
  */
 export async function getFilesWithExports() {
-    const rows = await executeQuery(REPO_ID, `
-    MATCH (f:File)-[:CodeRelation {type: 'DEFINES'}]->(n)
-    WHERE n.isExported = true
-    RETURN f.filePath AS filePath, n.name AS name, labels(n)[0] AS type
-    ORDER BY f.filePath
+    const rows = await executeQuery(REPO_ID, `
+    MATCH (f:File)-[:CodeRelation {type: 'DEFINES'}]->(n)
+    WHERE n.isExported = true
+    RETURN f.filePath AS filePath, n.name AS name, labels(n)[0] AS type
+    ORDER BY f.filePath
   `);
     const fileMap = new Map();
     for (const row of rows) {
@@ -46,10 +46,10 @@ export async function getFilesWithExports() {
  * Get all files tracked in the graph (including those with no exports).
  */
 export async function getAllFiles() {
-    const rows = await executeQuery(REPO_ID, `
-    MATCH (f:File)
-    RETURN f.filePath AS filePath
-    ORDER BY f.filePath
+    const rows = await executeQuery(REPO_ID, `
+    MATCH (f:File)
+    RETURN f.filePath AS filePath
+    ORDER BY f.filePath
   `);
     return rows.map(r => r.filePath || r[0]);
 }
@@ -57,11 +57,11 @@ export async function getAllFiles() {
  * Get inter-file call edges (calls between different files).
  */
 export async function getInterFileCallEdges() {
-    const rows = await executeQuery(REPO_ID, `
-    MATCH (a)-[:CodeRelation {type: 'CALLS'}]->(b)
-    WHERE a.filePath <> b.filePath
-    RETURN DISTINCT a.filePath AS fromFile, a.name AS fromName,
-           b.filePath AS toFile, b.name AS toName
+    const rows = await executeQuery(REPO_ID, `
+    MATCH (a)-[:CodeRelation {type: 'CALLS'}]->(b)
+    WHERE a.filePath <> b.filePath
+    RETURN DISTINCT a.filePath AS fromFile, a.name AS fromName,
+           b.filePath AS toFile, b.name AS toName
   `);
     return rows.map(r => ({
         fromFile: r.fromFile || r[0],
@@ -77,11 +77,11 @@ export async function getIntraModuleCallEdges(filePaths) {
     if (filePaths.length === 0)
         return [];
     const fileList = filePaths.map(f => `'${f.replace(/'/g, "''")}'`).join(', ');
-    const rows = await executeQuery(REPO_ID, `
-    MATCH (a)-[:CodeRelation {type: 'CALLS'}]->(b)
-    WHERE a.filePath IN [${fileList}] AND b.filePath IN [${fileList}]
-    RETURN DISTINCT a.filePath AS fromFile, a.name AS fromName,
-           b.filePath AS toFile, b.name AS toName
+    const rows = await executeQuery(REPO_ID, `
+    MATCH (a)-[:CodeRelation {type: 'CALLS'}]->(b)
+    WHERE a.filePath IN [${fileList}] AND b.filePath IN [${fileList}]
+    RETURN DISTINCT a.filePath AS fromFile, a.name AS fromName,
+           b.filePath AS toFile, b.name AS toName
   `);
     return rows.map(r => ({
         fromFile: r.fromFile || r[0],
@@ -97,19 +97,19 @@ export async function getInterModuleCallEdges(filePaths) {
     if (filePaths.length === 0)
         return { outgoing: [], incoming: [] };
     const fileList = filePaths.map(f => `'${f.replace(/'/g, "''")}'`).join(', ');
-    const outRows = await executeQuery(REPO_ID, `
-    MATCH (a)-[:CodeRelation {type: 'CALLS'}]->(b)
-    WHERE a.filePath IN [${fileList}] AND NOT b.filePath IN [${fileList}]
-    RETURN DISTINCT a.filePath AS fromFile, a.name AS fromName,
-           b.filePath AS toFile, b.name AS toName
-    LIMIT 30
+    const outRows = await executeQuery(REPO_ID, `
+    MATCH (a)-[:CodeRelation {type: 'CALLS'}]->(b)
+    WHERE a.filePath IN [${fileList}] AND NOT b.filePath IN [${fileList}]
+    RETURN DISTINCT a.filePath AS fromFile, a.name AS fromName,
+           b.filePath AS toFile, b.name AS toName
+    LIMIT 30
   `);
-    const inRows = await executeQuery(REPO_ID, `
-    MATCH (a)-[:CodeRelation {type: 'CALLS'}]->(b)
-    WHERE NOT a.filePath IN [${fileList}] AND b.filePath IN [${fileList}]
-    RETURN DISTINCT a.filePath AS fromFile, a.name AS fromName,
-           b.filePath AS toFile, b.name AS toName
-    LIMIT 30
+    const inRows = await executeQuery(REPO_ID, `
+    MATCH (a)-[:CodeRelation {type: 'CALLS'}]->(b)
+    WHERE NOT a.filePath IN [${fileList}] AND b.filePath IN [${fileList}]
+    RETURN DISTINCT a.filePath AS fromFile, a.name AS fromName,
+           b.filePath AS toFile, b.name AS toName
+    LIMIT 30
   `);
     return {
         outgoing: outRows.map(r => ({
@@ -135,13 +135,13 @@ export async function getProcessesForFiles(filePaths, limit = 5) {
         return [];
     const fileList = filePaths.map(f => `'${f.replace(/'/g, "''")}'`).join(', ');
     // Find processes that have steps in the given files
-    const procRows = await executeQuery(REPO_ID, `
-    MATCH (s)-[r:CodeRelation {type: 'STEP_IN_PROCESS'}]->(p:Process)
-    WHERE s.filePath IN [${fileList}]
-    RETURN DISTINCT p.id AS id, p.heuristicLabel AS label,
-           p.processType AS type, p.stepCount AS stepCount
-    ORDER BY stepCount DESC
-    LIMIT ${limit}
+    const procRows = await executeQuery(REPO_ID, `
+    MATCH (s)-[r:CodeRelation {type: 'STEP_IN_PROCESS'}]->(p:Process)
+    WHERE s.filePath IN [${fileList}]
+    RETURN DISTINCT p.id AS id, p.heuristicLabel AS label,
+           p.processType AS type, p.stepCount AS stepCount
+    ORDER BY stepCount DESC
+    LIMIT ${limit}
   `);
     const processes = [];
     for (const row of procRows) {
@@ -150,10 +150,10 @@ export async function getProcessesForFiles(filePaths, limit = 5) {
         const type = row.type || row[2] || 'unknown';
         const stepCount = row.stepCount || row[3] || 0;
         // Get the full step trace for this process
-        const stepRows = await executeQuery(REPO_ID, `
-      MATCH (s)-[r:CodeRelation {type: 'STEP_IN_PROCESS'}]->(p:Process {id: '${procId.replace(/'/g, "''")}'})
-      RETURN s.name AS name, s.filePath AS filePath, labels(s)[0] AS type, r.step AS step
-      ORDER BY r.step
+        const stepRows = await executeQuery(REPO_ID, `
+      MATCH (s)-[r:CodeRelation {type: 'STEP_IN_PROCESS'}]->(p:Process {id: '${procId.replace(/'/g, "''")}'})
+      RETURN s.name AS name, s.filePath AS filePath, labels(s)[0] AS type, r.step AS step
+      ORDER BY r.step
     `);
         processes.push({
             id: procId,
@@ -174,12 +174,12 @@ export async function getProcessesForFiles(filePaths, limit = 5) {
  * Get all processes in the graph (for overview page).
  */
 export async function getAllProcesses(limit = 20) {
-    const procRows = await executeQuery(REPO_ID, `
-    MATCH (p:Process)
-    RETURN p.id AS id, p.heuristicLabel AS label,
-           p.processType AS type, p.stepCount AS stepCount
-    ORDER BY stepCount DESC
-    LIMIT ${limit}
+    const procRows = await executeQuery(REPO_ID, `
+    MATCH (p:Process)
+    RETURN p.id AS id, p.heuristicLabel AS label,
+           p.processType AS type, p.stepCount AS stepCount
+    ORDER BY stepCount DESC
+    LIMIT ${limit}
   `);
     const processes = [];
     for (const row of procRows) {
@@ -187,10 +187,10 @@ export async function getAllProcesses(limit = 20) {
         const label = row.label || row[1] || procId;
         const type = row.type || row[2] || 'unknown';
         const stepCount = row.stepCount || row[3] || 0;
-        const stepRows = await executeQuery(REPO_ID, `
-      MATCH (s)-[r:CodeRelation {type: 'STEP_IN_PROCESS'}]->(p:Process {id: '${procId.replace(/'/g, "''")}'})
-      RETURN s.name AS name, s.filePath AS filePath, labels(s)[0] AS type, r.step AS step
-      ORDER BY r.step
+        const stepRows = await executeQuery(REPO_ID, `
+      MATCH (s)-[r:CodeRelation {type: 'STEP_IN_PROCESS'}]->(p:Process {id: '${procId.replace(/'/g, "''")}'})
+      RETURN s.name AS name, s.filePath AS filePath, labels(s)[0] AS type, r.step AS step
+      ORDER BY r.step
     `);
         processes.push({
             id: procId,

package/dist/core/wiki/prompts.js

@@ -5,98 +5,98 @@
  * Templates use {{PLACEHOLDER}} substitution.
  */
 // ─── Grouping Prompt ──────────────────────────────────────────────────
-export const GROUPING_SYSTEM_PROMPT = `You are a documentation architect. Given a list of source files with their exported symbols, group them into logical documentation modules.
-
-Rules:
-- Each module should represent a cohesive feature, layer, or domain
-- Every file must appear in exactly one module
-- Module names should be human-readable (e.g. "Authentication", "Database Layer", "API Routes")
-- Aim for 5-15 modules for a typical project. Fewer for small projects, more for large ones
-- Group by functionality, not by file type or directory structure alone
+export const GROUPING_SYSTEM_PROMPT = `You are a documentation architect. Given a list of source files with their exported symbols, group them into logical documentation modules.
+
+Rules:
+- Each module should represent a cohesive feature, layer, or domain
+- Every file must appear in exactly one module
+- Module names should be human-readable (e.g. "Authentication", "Database Layer", "API Routes")
+- Aim for 5-15 modules for a typical project. Fewer for small projects, more for large ones
+- Group by functionality, not by file type or directory structure alone
 - Do NOT create modules for tests, configs, or non-source files`;
-export const GROUPING_USER_PROMPT = `Group these source files into documentation modules.
-
-**Files and their exports:**
-{{FILE_LIST}}
-
-**Directory structure:**
-{{DIRECTORY_TREE}}
-
-Respond with ONLY a JSON object mapping module names to file path arrays. No markdown, no explanation.
-Example format:
-{
-  "Authentication": ["src/auth/login.ts", "src/auth/session.ts"],
-  "Database": ["src/db/connection.ts", "src/db/models.ts"]
+export const GROUPING_USER_PROMPT = `Group these source files into documentation modules.
+
+**Files and their exports:**
+{{FILE_LIST}}
+
+**Directory structure:**
+{{DIRECTORY_TREE}}
+
+Respond with ONLY a JSON object mapping module names to file path arrays. No markdown, no explanation.
+Example format:
+{
+  "Authentication": ["src/auth/login.ts", "src/auth/session.ts"],
+  "Database": ["src/db/connection.ts", "src/db/models.ts"]
 }`;
 // ─── Leaf Module Prompt ───────────────────────────────────────────────
-export const MODULE_SYSTEM_PROMPT = `You are a technical documentation writer. Write clear, developer-focused documentation for a code module.
-
-Rules:
-- Reference actual function names, class names, and code patterns — do NOT invent APIs
-- Use the call graph and execution flow data for accuracy, but do NOT mechanically list every edge
-- Include Mermaid diagrams only when they genuinely help understanding. Keep them small (5-10 nodes max)
-- Structure the document however makes sense for this module — there is no mandatory format
+export const MODULE_SYSTEM_PROMPT = `You are a technical documentation writer. Write clear, developer-focused documentation for a code module.
+
+Rules:
+- Reference actual function names, class names, and code patterns — do NOT invent APIs
+- Use the call graph and execution flow data for accuracy, but do NOT mechanically list every edge
+- Include Mermaid diagrams only when they genuinely help understanding. Keep them small (5-10 nodes max)
+- Structure the document however makes sense for this module — there is no mandatory format
 - Write for a developer who needs to understand and contribute to this code`;
-export const MODULE_USER_PROMPT = `Write documentation for the **{{MODULE_NAME}}** module.
-
-## Source Code
-
-{{SOURCE_CODE}}
-
-## Call Graph & Execution Flows (reference for accuracy)
-
-Internal calls: {{INTRA_CALLS}}
-Outgoing calls: {{OUTGOING_CALLS}}
-Incoming calls: {{INCOMING_CALLS}}
-Execution flows: {{PROCESSES}}
-
----
-
+export const MODULE_USER_PROMPT = `Write documentation for the **{{MODULE_NAME}}** module.
+
+## Source Code
+
+{{SOURCE_CODE}}
+
+## Call Graph & Execution Flows (reference for accuracy)
+
+Internal calls: {{INTRA_CALLS}}
+Outgoing calls: {{OUTGOING_CALLS}}
+Incoming calls: {{INCOMING_CALLS}}
+Execution flows: {{PROCESSES}}
+
+---
+
 Write comprehensive documentation for this module. Cover its purpose, how it works, its key components, and how it connects to the rest of the codebase. Use whatever structure best fits this module — you decide the sections and headings. Include a Mermaid diagram only if it genuinely clarifies the architecture.`;
 // ─── Parent Module Prompt ─────────────────────────────────────────────
-export const PARENT_SYSTEM_PROMPT = `You are a technical documentation writer. Write a summary page for a module that contains sub-modules. Synthesize the children's documentation — do not re-read source code.
-
-Rules:
-- Reference actual components from the child modules
-- Focus on how the sub-modules work together, not repeating their individual docs
-- Keep it concise — the reader can click through to child pages for detail
+export const PARENT_SYSTEM_PROMPT = `You are a technical documentation writer. Write a summary page for a module that contains sub-modules. Synthesize the children's documentation — do not re-read source code.
+
+Rules:
+- Reference actual components from the child modules
+- Focus on how the sub-modules work together, not repeating their individual docs
+- Keep it concise — the reader can click through to child pages for detail
 - Include a Mermaid diagram only if it genuinely clarifies how the sub-modules relate`;
-export const PARENT_USER_PROMPT = `Write documentation for the **{{MODULE_NAME}}** module, which contains these sub-modules:
-
-{{CHILDREN_DOCS}}
-
-Cross-module calls: {{CROSS_MODULE_CALLS}}
-Shared execution flows: {{CROSS_PROCESSES}}
-
----
-
+export const PARENT_USER_PROMPT = `Write documentation for the **{{MODULE_NAME}}** module, which contains these sub-modules:
+
+{{CHILDREN_DOCS}}
+
+Cross-module calls: {{CROSS_MODULE_CALLS}}
+Shared execution flows: {{CROSS_PROCESSES}}
+
+---
+
 Write a concise overview of this module group. Explain its purpose, how the sub-modules fit together, and the key workflows that span them. Link to sub-module pages (e.g. \`[Sub-module Name](sub-module-slug.md)\`) rather than repeating their content. Use whatever structure fits best.`;
 // ─── Overview Prompt ──────────────────────────────────────────────────
-export const OVERVIEW_SYSTEM_PROMPT = `You are a technical documentation writer. Write the top-level overview page for a repository wiki. This is the first page a new developer sees.
-
-Rules:
-- Be clear and welcoming — this is the entry point to the entire codebase
-- Reference actual module names so readers can navigate to their docs
-- Include a high-level Mermaid architecture diagram showing only the most important modules and their relationships (max 10 nodes). A new dev should grasp it in 10 seconds
-- Do NOT create module index tables or list every module with descriptions — just link to module pages naturally within the text
+export const OVERVIEW_SYSTEM_PROMPT = `You are a technical documentation writer. Write the top-level overview page for a repository wiki. This is the first page a new developer sees.
+
+Rules:
+- Be clear and welcoming — this is the entry point to the entire codebase
+- Reference actual module names so readers can navigate to their docs
+- Include a high-level Mermaid architecture diagram showing only the most important modules and their relationships (max 10 nodes). A new dev should grasp it in 10 seconds
+- Do NOT create module index tables or list every module with descriptions — just link to module pages naturally within the text
 - Use the inter-module edges and execution flow data for accuracy, but do NOT dump them raw`;
-export const OVERVIEW_USER_PROMPT = `Write the overview page for this repository's wiki.
-
-## Project Info
-
-{{PROJECT_INFO}}
-
-## Module Summaries
-
-{{MODULE_SUMMARIES}}
-
-## Reference Data (for accuracy — do not reproduce verbatim)
-
-Inter-module call edges: {{MODULE_EDGES}}
-Key system flows: {{TOP_PROCESSES}}
-
----
-
+export const OVERVIEW_USER_PROMPT = `Write the overview page for this repository's wiki.
+
+## Project Info
+
+{{PROJECT_INFO}}
+
+## Module Summaries
+
+{{MODULE_SUMMARIES}}
+
+## Reference Data (for accuracy — do not reproduce verbatim)
+
+Inter-module call edges: {{MODULE_EDGES}}
+Key system flows: {{TOP_PROCESSES}}
+
+---
+
 Write a clear overview of this project: what it does, how it's architected, and the key end-to-end flows. Include a simple Mermaid architecture diagram (max 10 nodes, big-picture only). Link to module pages (e.g. \`[Module Name](module-slug.md)\`) naturally in the text rather than listing them in a table. If project config was provided, include brief setup instructions. Structure the page however reads best.`;
 // ─── Template Substitution Helper ─────────────────────────────────────
 /**

package/dist/mcp/local/local-backend.d.ts

@@ -34,6 +34,12 @@ export declare class LocalBackend {
      * Returns true if at least one repo is available.
      */
     init(): Promise<boolean>;
+    /**
+     * 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).
+     */
+    private refreshRepos;
     /**
      * Generate a stable repo ID from name + path.
      * If names collide, append a hash of the path.
@@ -44,8 +50,15 @@ export declare 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?: string): RepoHandle;
+    resolveRepo(repoParam?: string): Promise<RepoHandle>;
+    /**
+     * Try to resolve a repo from the in-memory cache. Returns null on miss.
+     */
+    private resolveRepoFromCache;
     private ensureInitialized;
     /**
      * Get context for a specific repo (or the single repo if only one).
@@ -53,14 +66,16 @@ export declare class LocalBackend {
     getContext(repoId?: string): CodebaseContext | null;
     /**
      * List all registered repos with their metadata.
+     * Re-reads the global registry so newly indexed repos are discovered
+     * without restarting the MCP server.
      */
-    listRepos(): Array<{
+    listRepos(): Promise<Array<{
         name: string;
         path: string;
         indexedAt: string;
         lastCommit: string;
         stats?: any;
-    }>;
+    }>>;
     callTool(method: string, params: any): Promise<any>;
     /**
      * Query tool — process-grouped search.

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);
@@ -1125,7 +1169,7 @@ 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);
@@ -1153,7 +1197,7 @@ 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, `
@@ -1181,7 +1225,7 @@ 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 = `
@@ -1227,7 +1271,7 @@ 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, `

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) {
@@ -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.';
     }