@veewo/gitnexus 1.4.9-rc → 1.4.9

package/dist/cli/ai-context.js

@@ -36,13 +36,12 @@ function generateGitNexusContent(projectName, stats, skillScope, cliPackageSpec,
     return `${GITNEXUS_START_MARKER}
 # GitNexus MCP
 
-This project is indexed by GitNexus as **${projectName}** (${stats.nodes || 0} symbols, ${stats.edges || 0} relationships, ${stats.processes || 0} execution flows).
-
 ## Always Start Here
 
 1. **Read \`gitnexus://repo/{name}/context\`** — codebase overview + check index freshness
 2. **Match your task to a skill below** and **read that skill file**
 3. **Follow the skill's workflow and checklist**
+4. **Follow config/state file rules:** \`docs/gitnexus-config-files.md\`
 
 > If step 1 warns the index is stale, ask user whether to rebuild index via \`gitnexus analyze\` when local CLI exists; otherwise resolve the pinned npx package spec from \`~/.gitnexus/config.json\` (\`cliPackageSpec\` first, then \`cliVersion\`) and run \`${reindexCmd}\` with that exact package spec (it reuses previous analyze scope/options by default; add \`--no-reuse-options\` to reset). If user declines, explicitly warn that retrieval may not reflect current codebase. For build/analyze/test commands, use a 10-30 minute timeout; on failure/timeout, report exact tool output and do not auto-retry or silently fall back to glob/grep.
 

package/dist/cli/analyze.js

@@ -360,9 +360,10 @@ export const analyzeCommand = async (inputPath, options) => {
             embeddings: embeddingCount,
         },
     };
+    const registeredRepo = await registerRepo(repoPath, meta, { repoAlias });
+    meta.repoId = registeredRepo.name;
     await saveMeta(storagePath, meta);
     await persistUnityParitySeed(storagePath, pipelineRuntime.unityResult?.paritySeed);
-    const registeredRepo = await registerRepo(repoPath, meta, { repoAlias });
     await addToGitignore(repoPath);
     const projectName = path.basename(repoPath);
     let aggregatedClusterCount = 0;

package/dist/cli/repo-manager-alias.test.js

@@ -43,6 +43,7 @@ test('saveMeta/loadMeta persists analyzeOptions for future re-index reuse', asyn
     const storagePath = path.join(tmpDir, '.gitnexus');
     await saveMeta(storagePath, {
         repoPath: tmpDir,
+        repoId: 'neonspark-v1-subset',
         lastCommit: 'abc1234',
         indexedAt: '2026-03-12T00:00:00.000Z',
         analyzeOptions: {
@@ -60,4 +61,5 @@ test('saveMeta/loadMeta persists analyzeOptions for future re-index reuse', asyn
         repoAlias: 'neonspark-v1-subset',
         embeddings: true,
     });
+    assert.equal(meta?.repoId, 'neonspark-v1-subset');
 });

package/dist/cli/tool.js

@@ -15,7 +15,10 @@
  * See the output() function for details (#324).
  */
 import { writeSync } from 'node:fs';
+import path from 'node:path';
 import { LocalBackend } from '../mcp/local/local-backend.js';
+import { getGitRoot } from '../storage/git.js';
+import { getStoragePaths, listRegisteredRepos, loadMeta } from '../storage/repo-manager.js';
 let _backend = null;
 async function getBackend() {
     if (_backend)
@@ -59,12 +62,29 @@ function isUnityUiTraceGoal(value) {
 function isUnityUiSelectorMode(value) {
     return value === 'strict' || value === 'balanced';
 }
+async function resolveRepoOption(explicitRepo) {
+    if (explicitRepo?.trim())
+        return explicitRepo.trim();
+    const gitRoot = getGitRoot(process.cwd());
+    if (!gitRoot)
+        return undefined;
+    const { storagePath } = getStoragePaths(gitRoot);
+    const meta = await loadMeta(storagePath);
+    const repoId = typeof meta?.repoId === 'string' ? meta.repoId.trim() : '';
+    if (repoId)
+        return repoId;
+    // Backward compatibility for indexes created before repoId persisted in meta.json.
+    const entries = await listRegisteredRepos({ validate: false });
+    const matched = entries.find((entry) => path.resolve(entry.path) === gitRoot);
+    return matched?.name || undefined;
+}
 export async function queryCommand(queryText, options) {
     if (!queryText?.trim()) {
         console.error('Usage: gitnexus query <search_query>');
         process.exit(1);
     }
     const backend = await getBackend();
+    const repo = await resolveRepoOption(options?.repo);
     const result = await backend.callTool('query', {
         query: queryText,
         task_context: options?.context,
@@ -74,7 +94,7 @@ export async function queryCommand(queryText, options) {
         scope_preset: options?.scopePreset,
         unity_resources: options?.unityResources,
         unity_hydration_mode: options?.unityHydration,
-        repo: options?.repo,
+        repo,
     });
     output(result);
 }
@@ -84,6 +104,7 @@ export async function contextCommand(name, options) {
         process.exit(1);
     }
     const backend = await getBackend();
+    const repo = await resolveRepoOption(options?.repo);
     const result = await backend.callTool('context', {
         name: name || undefined,
         uid: options?.uid,
@@ -91,7 +112,7 @@ export async function contextCommand(name, options) {
         include_content: options?.content ?? false,
         unity_resources: options?.unityResources,
         unity_hydration_mode: options?.unityHydration,
-        repo: options?.repo,
+        repo,
     });
     output(result);
 }
@@ -102,6 +123,7 @@ export async function impactCommand(target, options) {
     }
     try {
         const backend = await getBackend();
+        const repo = await resolveRepoOption(options?.repo);
         const result = await backend.callTool('impact', {
             target,
             target_uid: options?.uid,
@@ -110,7 +132,7 @@ export async function impactCommand(target, options) {
             maxDepth: options?.depth ? parseInt(options.depth, 10) : undefined,
             minConfidence: options?.minConfidence ? parseFloat(options.minConfidence) : undefined,
             includeTests: options?.includeTests ?? false,
-            repo: options?.repo,
+            repo,
         });
         output(result);
     }
@@ -131,9 +153,10 @@ export async function cypherCommand(query, options) {
         process.exit(1);
     }
     const backend = await getBackend();
+    const repo = await resolveRepoOption(options?.repo);
     const result = await backend.callTool('cypher', {
         query,
-        repo: options?.repo,
+        repo,
     });
     output(result);
 }
@@ -153,11 +176,12 @@ export async function unityUiTraceCommand(target, options, deps) {
         process.exit(1);
     }
     const backend = deps?.backend || await getBackend();
+    const repo = await resolveRepoOption(options?.repo);
     const result = await backend.callTool('unity_ui_trace', {
         target,
         goal,
         selector_mode: selectorMode,
-        repo: options?.repo,
+        repo,
     });
     (deps?.output || output)(result);
 }

package/dist/storage/repo-manager.d.ts

@@ -7,6 +7,7 @@
  */
 export interface RepoMeta {
     repoPath: string;
+    repoId?: string;
     lastCommit: string;
     indexedAt: string;
     analyzeOptions?: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veewo/gitnexus",
-  "version": "1.4.9-rc",
+  "version": "1.4.9",
   "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",