gitnexus 1.1.5 → 1.1.6

package/dist/cli/ai-context.js

@@ -33,7 +33,7 @@ This project is indexed as **${projectName}** by GitNexus, providing AI agents w
 | Clusters | ${clusterCount} |
 | Processes | ${stats.processes || 0} |
 
-> **Staleness:** If the index is out of date, run \`gitnexus_analyze({repo: "${projectName}"})\` to refresh. The \`gitnexus://repo/${projectName}/context\` resource will warn you when the index is stale.
+> **Staleness:** If the index is out of date, run \`npx gitnexus analyze\` in the terminal to refresh. The \`gitnexus://repo/${projectName}/context\` resource will warn you when the index is stale.
 
 ## Quick Start
 
@@ -66,7 +66,8 @@ This project is indexed as **${projectName}** by GitNexus, providing AI agents w
 | \`explore\` | Deep dive on symbol/cluster/process | Detailed investigation |
 | \`impact\` | Blast radius analysis | Before making changes |
 | \`cypher\` | Raw graph queries | Complex analysis |
-| \`analyze\` | Re-index repository | When index is stale or after major code changes |
+
+> **Re-indexing:** To refresh a stale index, run \`npx gitnexus analyze\` in the terminal. Use \`--force\` only to rebuild from scratch. This is a CLI command, not an MCP tool.
 
 > **Multi-repo:** When multiple repos are indexed, pass \`repo: "${projectName}"\` to target this project.
 

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

@@ -81,7 +81,6 @@ export declare class LocalBackend {
     private overview;
     private explore;
     private impact;
-    private analyze;
     disconnect(): Promise<void>;
 }
 export {};

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

@@ -8,9 +8,11 @@
 import path from 'path';
 import { initKuzu, executeQuery, closeKuzu, isKuzuReady } from '../core/kuzu-adapter.js';
 import { embedQuery, getEmbeddingDims, disposeEmbedder } from '../core/embedder.js';
-import { isGitRepo, getCurrentCommit } from '../../storage/git.js';
-import { getStoragePaths as getRepoStoragePaths, saveMeta as saveRepoMeta, loadMeta as loadRepoMeta, addToGitignore, listRegisteredRepos, registerRepo, } from '../../storage/repo-manager.js';
-import { generateAIContextFiles } from '../../cli/ai-context.js';
+// git utilities available if needed
+// import { isGitRepo, getCurrentCommit, getGitRoot } from '../../storage/git.js';
+import { listRegisteredRepos, } from '../../storage/repo-manager.js';
+// AI context generation is CLI-only (gitnexus analyze)
+// import { generateAIContextFiles } from '../../cli/ai-context.js';
 /**
  * Quick test-file detection for filtering impact results.
  * Matches common test file patterns across all supported languages.
@@ -175,8 +177,6 @@ export class LocalBackend {
                 return this.explore(repo, params);
             case 'impact':
                 return this.impact(repo, params);
-            case 'analyze':
-                return this.analyze(repo, params);
             default:
                 throw new Error(`Unknown tool: ${method}`);
         }
@@ -255,10 +255,12 @@ export class LocalBackend {
                 }
             }
             // Add relationships if depth is 'full' and we have a node ID
+            // Only include connections with actual name/path data (skip MEMBER_OF, STEP_IN_PROCESS noise)
             if (depth === 'full' && result.nodeId) {
                 try {
                     const relQuery = `
             MATCH (n {id: '${result.nodeId.replace(/'/g, "''")}'})-[r:CodeRelation]->(m)
+            WHERE r.type IN ['CALLS', 'IMPORTS', 'DEFINES', 'EXTENDS', 'IMPLEMENTS']
             RETURN r.type AS type, m.name AS targetName, m.filePath AS targetPath
             LIMIT 5
           `;
@@ -490,15 +492,19 @@ export class LocalBackend {
         await this.ensureInitialized(repo.id);
         const { name, type } = params;
         if (type === 'symbol') {
-            const symbolQuery = `
-        MATCH (n)
-        WHERE n.name = '${name.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 1
-      `;
+            // If name contains a path separator or ':', treat it as a qualified lookup
+            const isQualified = name.includes('/') || name.includes(':');
+            const symbolQuery = isQualified
+                ? `MATCH (n) WHERE n.id = '${name.replace(/'/g, "''")}' OR (n.name = '${name.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 5`
+                : `MATCH (n) WHERE n.name = '${name.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 5`;
             const symbols = await executeQuery(repo.id, symbolQuery);
             if (symbols.length === 0)
                 return { error: `Symbol '${name}' not found` };
+            // Use the first match for detailed exploration
             const sym = symbols[0];
             const symId = sym.id || sym[0];
             const callersQuery = `
@@ -519,7 +525,7 @@ export class LocalBackend {
         LIMIT 1
       `;
             const communities = await executeQuery(repo.id, communityQuery);
-            return {
+            const result = {
                 symbol: {
                     id: symId,
                     name: sym.name || sym[1],
@@ -535,6 +541,16 @@ export class LocalBackend {
                     heuristicLabel: communities[0].heuristicLabel || communities[0][1],
                 } : null,
             };
+            // If multiple symbols share the same name, show alternatives so the agent can disambiguate
+            if (symbols.length > 1) {
+                result.alternatives = symbols.slice(1).map((s) => ({
+                    id: s.id || s[0],
+                    type: s.type || s[2],
+                    filePath: s.filePath || s[3],
+                }));
+                result.hint = `Multiple symbols named '${name}' found. Showing details for ${result.symbol.filePath}. Use the full node ID to explore a specific alternative.`;
+            }
+            return result;
         }
         if (type === 'cluster') {
             const escaped = name.replace(/'/g, "''");
@@ -694,121 +710,6 @@ export class LocalBackend {
             byDepth: grouped,
         };
     }
-    async analyze(repo, params) {
-        let repoPath;
-        if (params.path) {
-            repoPath = path.resolve(params.path);
-        }
-        else {
-            repoPath = repo.repoPath;
-        }
-        if (!isGitRepo(repoPath)) {
-            return { error: 'Not a git repository' };
-        }
-        const { storagePath, kuzuPath } = getRepoStoragePaths(repoPath);
-        const currentCommit = getCurrentCommit(repoPath);
-        const existingMeta = await loadRepoMeta(storagePath);
-        if (existingMeta && !params.force && existingMeta.lastCommit === currentCommit) {
-            return { status: 'up_to_date', message: 'Repository already up to date.' };
-        }
-        // Close this repo's MCP connection before pipeline takes over
-        await closeKuzu(repo.id);
-        this.initializedRepos.delete(repo.id);
-        try {
-            const { runPipelineFromRepo } = await import('../../core/ingestion/pipeline.js');
-            const coreKuzu = await import('../../core/kuzu/kuzu-adapter.js');
-            console.error('GitNexus: Running indexing pipeline...');
-            const pipelineResult = await runPipelineFromRepo(repoPath, (progress) => {
-                if (progress.percent % 20 === 0) {
-                    console.error(`GitNexus: ${progress.phase} ${progress.percent}%`);
-                }
-            });
-            console.error('GitNexus: Loading graph into KuzuDB...');
-            await coreKuzu.initKuzu(kuzuPath);
-            await coreKuzu.loadGraphToKuzu(pipelineResult.graph, pipelineResult.fileContents, storagePath);
-            console.error('GitNexus: Creating FTS indexes...');
-            try {
-                await coreKuzu.createFTSIndex('File', 'file_fts', ['name', 'content']);
-                await coreKuzu.createFTSIndex('Function', 'function_fts', ['name', 'content']);
-                await coreKuzu.createFTSIndex('Class', 'class_fts', ['name', 'content']);
-                await coreKuzu.createFTSIndex('Method', 'method_fts', ['name', 'content']);
-            }
-            catch (e) {
-                console.error('GitNexus: Some FTS indexes may not have been created:', e.message);
-            }
-            if (!params.skipEmbeddings) {
-                try {
-                    console.error('GitNexus: Generating embeddings...');
-                    const { runEmbeddingPipeline } = await import('../../core/embeddings/embedding-pipeline.js');
-                    await runEmbeddingPipeline(coreKuzu.executeQuery, coreKuzu.executeWithReusedStatement, (progress) => {
-                        if (progress.percent % 25 === 0) {
-                            console.error(`GitNexus: Embeddings ${progress.percent}%`);
-                        }
-                    });
-                }
-                catch (e) {
-                    console.error('GitNexus: Embedding generation failed (non-fatal):', e.message);
-                }
-            }
-            const stats = await coreKuzu.getKuzuStats();
-            const newMeta = {
-                repoPath,
-                lastCommit: currentCommit,
-                indexedAt: new Date().toISOString(),
-                stats: {
-                    files: pipelineResult.fileContents.size,
-                    nodes: stats.nodes,
-                    edges: stats.edges,
-                    communities: pipelineResult.communityResult?.stats.totalCommunities,
-                    processes: pipelineResult.processResult?.stats.totalProcesses,
-                },
-            };
-            await saveRepoMeta(storagePath, newMeta);
-            await addToGitignore(repoPath);
-            // Register in global registry
-            await registerRepo(repoPath, newMeta);
-            const projectName = path.basename(repoPath);
-            await generateAIContextFiles(repoPath, storagePath, projectName, {
-                files: pipelineResult.fileContents.size,
-                nodes: stats.nodes,
-                edges: stats.edges,
-                communities: pipelineResult.communityResult?.stats.totalCommunities,
-                processes: pipelineResult.processResult?.stats.totalProcesses,
-            });
-            await coreKuzu.closeKuzu();
-            // Update in-memory state
-            const handle = {
-                id: repo.id,
-                name: projectName,
-                repoPath,
-                storagePath,
-                kuzuPath,
-                indexedAt: newMeta.indexedAt,
-                lastCommit: newMeta.lastCommit,
-                stats: newMeta.stats,
-            };
-            this.repos.set(repo.id, handle);
-            this.contextCache.set(repo.id, {
-                projectName,
-                stats: {
-                    fileCount: newMeta.stats.files || 0,
-                    functionCount: newMeta.stats.nodes || 0,
-                    communityCount: newMeta.stats.communities || 0,
-                    processCount: newMeta.stats.processes || 0,
-                },
-            });
-            console.error('GitNexus: Indexing complete!');
-            return {
-                status: 'success',
-                message: `Repository indexed successfully.`,
-                stats: newMeta.stats,
-            };
-        }
-        catch (e) {
-            console.error('GitNexus: Indexing failed:', e.message);
-            return { error: `Indexing failed: ${e.message}` };
-        }
-    }
     async disconnect() {
         await closeKuzu(); // close all connections
         await disposeEmbedder();

package/dist/mcp/resources.js

@@ -132,7 +132,6 @@ function getReposResource(backend) {
         if (repo.stats) {
             lines.push(`    files: ${repo.stats.files || 0}`);
             lines.push(`    symbols: ${repo.stats.nodes || 0}`);
-            lines.push(`    clusters: ${repo.stats.communities || 0}`);
             lines.push(`    processes: ${repo.stats.processes || 0}`);
         }
     }
@@ -158,6 +157,15 @@ async function getContextResource(backend, repoName) {
     const repoPath = repo.repoPath;
     const lastCommit = repo.lastCommit || 'HEAD';
     const staleness = repoPath ? checkStaleness(repoPath, lastCommit) : { isStale: false, commitsBehind: 0 };
+    // Get aggregated cluster count (matches what overview/clusters resource shows)
+    let clusterCount = context.stats.communityCount;
+    try {
+        const overview = await backend.callTool('overview', { showClusters: true, showProcesses: false, limit: 100, repo: repoName });
+        if (overview.clusters) {
+            clusterCount = overview.clusters.length;
+        }
+    }
+    catch { /* fall back to raw count */ }
     const lines = [
         `project: ${context.projectName}`,
     ];
@@ -169,7 +177,7 @@ async function getContextResource(backend, repoName) {
     lines.push('stats:');
     lines.push(`  files: ${context.stats.fileCount}`);
     lines.push(`  symbols: ${context.stats.functionCount}`);
-    lines.push(`  clusters: ${context.stats.communityCount}`);
+    lines.push(`  clusters: ${clusterCount}`);
     lines.push(`  processes: ${context.stats.processCount}`);
     lines.push('');
     lines.push('tools_available:');
@@ -179,7 +187,8 @@ async function getContextResource(backend, repoName) {
     lines.push('  - impact: Blast radius analysis');
     lines.push('  - overview: List all clusters and processes');
     lines.push('  - cypher: Raw graph queries');
-    lines.push('  - analyze: Re-index to update stale data');
+    lines.push('');
+    lines.push('re_index: Run `npx gitnexus analyze` in terminal if data is stale');
     lines.push('');
     lines.push('resources_available:');
     lines.push('  - gitnexus://repos: All indexed repositories');

package/dist/mcp/tools.js

@@ -20,37 +20,6 @@ on other tools (search, explore, impact, etc.) to target the correct one.`,
             required: [],
         },
     },
-    {
-        name: 'analyze',
-        description: `Index or re-index a repository. Runs the full pipeline in-process.
-
-Creates .gitnexus/ in repo root with:
-- Knowledge graph (functions, classes, calls, imports)
-- Full-text search indexes
-- Community detection (Leiden)
-- Process tracing
-- Embeddings for semantic search
-
-Also registers the repo in the global registry so the MCP server can serve it.
-
-Run this when:
-- First time using GitNexus on a repo
-- After major code changes
-- When staleness warning appears in gitnexus://context
-- When 'not indexed' error appears
-
-Note: This may take 30-120 seconds for large repos.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                path: { type: 'string', description: 'Repo path (default: current directory)' },
-                force: { type: 'boolean', description: 'Re-index even if exists', default: false },
-                skipEmbeddings: { type: 'boolean', description: 'Skip embedding generation (faster)', default: false },
-                repo: { type: 'string', description: 'Repository name or path. Omit if only one repo is indexed.' },
-            },
-            required: [],
-        },
-    },
     {
         name: 'search',
         description: `Hybrid search (keyword + semantic) across the codebase.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitnexus",
-  "version": "1.1.5",
+  "version": "1.1.6",
   "description": "Graph-powered code intelligence for AI agents. Index any codebase, query via MCP or CLI.",
   "author": "Abhigyan Patwari",
   "license": "PolyForm-Noncommercial-1.0.0",

package/skills/debugging.md

@@ -8,7 +8,7 @@ description: Trace bugs through call chains using knowledge graph
 ## Quick Start
 ```
 0. READ gitnexus://repos                          → Discover indexed repos
-1. If "Index is stale" → gitnexus_analyze({repo: "my-app"})
+1. If "Index is stale" → run `npx gitnexus analyze` in terminal
 2. gitnexus_search({query: "...", repo: "my-app"})  → Find code related to error
 3. gitnexus_explore({name, type: "symbol", repo: "my-app"}) → Get callers and callees
 4. READ gitnexus://repo/my-app/process/{name}      → Trace execution flow

package/skills/exploring.md

@@ -8,7 +8,7 @@ description: Navigate unfamiliar code using GitNexus knowledge graph
 ## Quick Start
 ```
 0. READ gitnexus://repos            → Discover indexed repos (use repo param if multiple)
-1. If "Index is stale" → gitnexus_analyze({repo: "my-app"})
+1. If "Index is stale" → run `npx gitnexus analyze` in terminal
 2. READ gitnexus://repo/{name}/context        → Get codebase overview (~150 tokens)
 3. READ gitnexus://repo/{name}/clusters       → See all functional clusters
 4. READ gitnexus://repo/{name}/cluster/{name} → Deep dive on specific cluster

package/skills/impact-analysis.md

@@ -8,7 +8,7 @@ description: Analyze blast radius before making code changes
 ## Quick Start
 ```
 0. READ gitnexus://repos                                    → Discover indexed repos
-1. If "Index is stale" → gitnexus_analyze({repo: "my-app"})
+1. If "Index is stale" → run `npx gitnexus analyze` in terminal
 2. gitnexus_impact({target, direction: "upstream", repo: "my-app"}) → What depends on this
 3. READ gitnexus://repo/my-app/clusters                     → Check affected areas
 4. READ gitnexus://repo/my-app/processes                    → Affected execution flows

package/skills/refactoring.md

@@ -8,7 +8,7 @@ description: Plan safe refactors using blast radius and dependency mapping
 ## Quick Start
 ```
 0. READ gitnexus://repos                                    → Discover indexed repos
-1. If "Index is stale" → gitnexus_analyze({repo: "my-app"})
+1. If "Index is stale" → run `npx gitnexus analyze` in terminal
 2. gitnexus_impact({target, direction: "upstream", repo: "my-app"}) → Map all dependents
 3. READ gitnexus://repo/my-app/schema                       → Understand graph structure
 4. gitnexus_cypher({query: "...", repo: "my-app"})           → Find all references