gitnexus 1.6.12-rc.32 → 1.6.12-rc.33

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

@@ -497,6 +497,23 @@ export declare class LocalBackend {
      *   - `remoteUrl`: the canonical origin URL recorded at index time.
      */
     listRepos(): Promise<RepoListing[]>;
+    /**
+     * Lightweight registry count for schema-introspection callers that only
+     * need to know "one repo or many?" without paying the full staleness fan-out
+     * cost that listRepos() incurs. Uses the same validated registry
+     * `refreshRepos` / `selectToolRepository` see (`validate: true` prunes
+     * entries whose metadata is provably gone) so tools/list cannot advertise a
+     * multi-repo schema for ENOENT ghosts. No git processes are spawned.
+     */
+    countRepos(): Promise<number>;
+    /**
+     * In-memory validated registry size after the last `refreshRepos` / init /
+     * `selectToolRepository` refresh. `countRepos()` does not populate this map.
+     * Schema introspection uses this after a refreshed cwd probe so cardinality
+     * and the probe share one snapshot — without putting `refreshRepos()` (and
+     * its kuzu cleanup) on the 0–1 `countRepos` path.
+     */
+    cachedRepoCount(): number;
     /**
      * Paginated view over {@link listRepos} for the `list_repos` MCP tool (#2119).
      *

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

@@ -1841,6 +1841,28 @@ export class LocalBackend {
             };
         });
     }
+    /**
+     * Lightweight registry count for schema-introspection callers that only
+     * need to know "one repo or many?" without paying the full staleness fan-out
+     * cost that listRepos() incurs. Uses the same validated registry
+     * `refreshRepos` / `selectToolRepository` see (`validate: true` prunes
+     * entries whose metadata is provably gone) so tools/list cannot advertise a
+     * multi-repo schema for ENOENT ghosts. No git processes are spawned.
+     */
+    async countRepos() {
+        const entries = await listRegisteredRepos({ validate: true });
+        return entries.length;
+    }
+    /**
+     * In-memory validated registry size after the last `refreshRepos` / init /
+     * `selectToolRepository` refresh. `countRepos()` does not populate this map.
+     * Schema introspection uses this after a refreshed cwd probe so cardinality
+     * and the probe share one snapshot — without putting `refreshRepos()` (and
+     * its kuzu cleanup) on the 0–1 `countRepos` path.
+     */
+    cachedRepoCount() {
+        return this.repos.size;
+    }
     /**
      * Paginated view over {@link listRepos} for the `list_repos` MCP tool (#2119).
      *

package/dist/mcp/repository-policy.js

@@ -148,26 +148,28 @@ export class McpRepositoryPolicy {
                 mutatingRequiresRepo: requiresRepo,
             };
         }
-        // One fresh listing supplies both schema decisions. Besides keeping the
-        // advertised contract internally consistent, this avoids doing two full
-        // per-repo staleness fan-outs for every tools/list request.
-        const visibleRepos = await this.listAllowedRepos(backend);
-        if (visibleRepos.length <= 1) {
+        // Validated registry cardinality only — no listRepos() staleness git.
+        // The 0–1 arm stays a cheap countRepos() (no refreshRepos / kuzu cleanup).
+        const repoCount = await backend.countRepos();
+        if (repoCount <= 1) {
             return { readOnlyRequiresRepo: false, mutatingRequiresRepo: false };
         }
         try {
-            // listAllowedRepos() refreshed this backend immediately above. Resolve
-            // against that exact cache snapshot instead of racing another registry
-            // read; only read-only schemas may advertise the cwd-derived default.
+            // countRepos() does not refresh the backend; this cwd probe must.
             await backend.selectToolRepository(undefined, undefined, {
                 allowCwdDefault: true,
-                refreshRegistry: false,
+                refreshRegistry: true,
             });
-            return { readOnlyRequiresRepo: false, mutatingRequiresRepo: true };
         }
         catch {
             return { readOnlyRequiresRepo: true, mutatingRequiresRepo: true };
         }
+        // The probe just refreshed. If that snapshot is now a singleton, match the
+        // <=1 arm rather than advertising a split mutating-only schema.
+        if (backend.cachedRepoCount() <= 1) {
+            return { readOnlyRequiresRepo: false, mutatingRequiresRepo: false };
+        }
+        return { readOnlyRequiresRepo: false, mutatingRequiresRepo: true };
     }
     async listReposPage(backend, params) {
         const { limit, offset } = parseListReposPagination(params, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitnexus",
-  "version": "1.6.12-rc.32",
+  "version": "1.6.12-rc.33",
   "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",