gitnexus 1.6.6-rc.24 → 1.6.6-rc.26

package/dist/cli/eval-server.d.ts

@@ -35,7 +35,9 @@ export interface EvalServerOptions {
 }
 /**
  * Validate the --host value. Accepts IPv4, IPv6, or "localhost".
- * Returns the normalised host string, or null if invalid.
+ * Returns the host string unchanged, or null if invalid.
+ * "localhost" is passed through so the OS resolves it to the correct loopback
+ * address (127.0.0.1 or ::1) at bind time rather than forcing IPv4.
  */
 export declare function validateHost(raw: string): string | null;
 export declare function formatQueryResult(result: any): string;

package/dist/cli/eval-server.js

@@ -36,11 +36,13 @@ import { logger } from '../core/logger.js';
 import { cliInfo, cliWarn, cliError } from './cli-message.js';
 /**
  * Validate the --host value. Accepts IPv4, IPv6, or "localhost".
- * Returns the normalised host string, or null if invalid.
+ * Returns the host string unchanged, or null if invalid.
+ * "localhost" is passed through so the OS resolves it to the correct loopback
+ * address (127.0.0.1 or ::1) at bind time rather than forcing IPv4.
  */
 export function validateHost(raw) {
     if (raw === 'localhost')
-        return '127.0.0.1';
+        return raw;
     if (isIPv4(raw) || isIPv6(raw))
         return raw;
     return null;
@@ -395,11 +397,13 @@ export async function evalServerCommand(options) {
                 `    2. Use a different port: gitnexus eval-server --port 4849\n`, { code: err.code, port, host });
         }
         else if (err.code === 'EADDRNOTAVAIL') {
-            const isIPv6Host = isIPv6(host);
+            // "localhost" may resolve to ::1 on IPv6-only systems; treat it as
+            // potentially IPv6 so the user gets the right diagnostic hint.
+            const isIPv6Host = isIPv6(host) || host === 'localhost';
             cliError(`\nGitNexus eval-server failed to start:\n` +
                 `  Address ${host} is not available on this machine.\n\n` +
                 (isIPv6Host
-                    ? `  IPv6 address ${host} is not reachable — IPv6 may be disabled on this system or container.\n` +
+                    ? `  Address ${host} resolved but is not reachable — IPv6 may be disabled, or the loopback interface may be unavailable.\n` +
                         `  Docker containers and many CI environments disable IPv6 by default.\n\n`
                     : `  The --host value must be an IP assigned to a local network interface.\n` +
                         `  Run \`ip addr\` (Linux) or \`ipconfig\` (Windows) to list available addresses.\n\n`) +
@@ -426,10 +430,19 @@ export async function evalServerCommand(options) {
         // Plain-text banner for the human watching stderr; structured record
         // for log aggregation (split into two so the user sees a real banner
         // not `{"level":30,"msg":"...","port":4747,"endpoints":[...]}`).
-        // Use server.address().port so --port 0 (OS-assigned) emits the real port.
+        // Use server.address() so the banner and READY signal reflect what the OS
+        // actually bound to, not the input host string. This matters when "localhost"
+        // is passed: the OS may resolve it to ::1 on some systems.
         const addr = server.address();
-        const boundPort = typeof addr === 'object' && addr !== null ? addr.port : port;
-        const displayHost = host.includes(':') ? `[${host}]` : host;
+        // server.listen callback only fires after a successful TCP bind, so
+        // server.address() is guaranteed to return an AddressInfo object here.
+        if (typeof addr !== 'object' || addr === null) {
+            cliError(`\nGitNexus eval-server: unexpected server.address() value after bind: ${JSON.stringify(addr)}\n`);
+            process.exit(1);
+        }
+        const boundPort = addr.port;
+        const boundAddress = addr.address;
+        const displayHost = boundAddress.includes(':') ? `[${boundAddress}]` : boundAddress;
         const bannerLines = [
             `GitNexus eval-server: listening on http://${displayHost}:${boundPort}`,
             `  POST /tool/query    — search execution flows`,
@@ -457,8 +470,7 @@ export async function evalServerCommand(options) {
         });
         try {
             // Use fd 1 directly — LadybugDB captures process.stdout (#324)
-            const readyHost = host.includes(':') ? `[${host}]` : host;
-            writeSync(1, `GITNEXUS_EVAL_SERVER_READY:${readyHost}:${boundPort}\n`);
+            writeSync(1, `GITNEXUS_EVAL_SERVER_READY:${displayHost}:${boundPort}\n`);
         }
         catch {
             // stdout may not be available (e.g., broken pipe)

package/dist/core/group/extractors/http-route-extractor.d.ts

@@ -18,4 +18,5 @@ export declare class HttpRouteExtractor implements ContractExtractor {
     private extractConsumersGraph;
     private extractConsumersSourceScan;
     private dedupeContracts;
+    private mergeGraphAndSourceContracts;
 }

package/dist/core/group/extractors/http-route-extractor.js

@@ -15,12 +15,14 @@ import { getPluginForFile, HTTP_SCAN_GLOB } from './http-patterns/index.js';
  *    the preferred path because the graph has richer symbol metadata
  *    (real uids, class/method structure, etc.).
  *
- * 2. **Source-scan fallback (Strategy B)** — parse files directly with
- *    the per-language plugin registry in `./http-patterns/`. Used when
- *    the graph has no routes/fetches for this repo (e.g. a repo that
- *    hasn't been indexed yet, or whose indexer doesn't know the
- *    framework). Each plugin owns its tree-sitter grammar and query
- *    sources — this orchestrator imports NO grammars or query strings.
+ * 2. **Source-scan supplement (Strategy B)** — parse files directly with
+ *    the per-language plugin registry in `./http-patterns/`. Used to
+ *    fill gaps when graph extraction only covers part of a polyglot repo
+ *    (e.g. Java graph routes plus Go source-scan routes). Graph entries
+ *    remain authoritative for duplicate contract IDs because they carry
+ *    richer symbol metadata. Each plugin owns its tree-sitter grammar
+ *    and query sources — this orchestrator imports NO grammars or query
+ *    strings.
  *
  * Adding a new language for Strategy B is a one-file edit in
  * `http-patterns/index.ts`: register a new `HttpLanguagePlugin` and
@@ -175,13 +177,11 @@ export class HttpRouteExtractor {
             return scannedFiles;
         };
         const graphProviders = dbExecutor != null ? await this.extractProvidersGraph(dbExecutor, getDetections) : [];
-        const providers = graphProviders.length > 0
-            ? graphProviders
-            : this.extractProvidersSourceScan(await getScannedFiles(), getDetections);
+        // Source scan always runs to capture routes in languages/files not covered
+        // by graph edges; the glob and per-file parse results are cached above.
+        const providers = this.mergeGraphAndSourceContracts(graphProviders, this.extractProvidersSourceScan(await getScannedFiles(), getDetections));
         const graphConsumers = dbExecutor != null ? await this.extractConsumersGraph(dbExecutor, getDetections) : [];
-        const consumers = graphConsumers.length > 0
-            ? graphConsumers
-            : this.extractConsumersSourceScan(await getScannedFiles(), getDetections);
+        const consumers = this.mergeGraphAndSourceContracts(graphConsumers, this.extractConsumersSourceScan(await getScannedFiles(), getDetections));
         return [...providers, ...consumers];
     }
     async scanFiles(repoPath) {
@@ -427,4 +427,15 @@ export class HttpRouteExtractor {
         }
         return out;
     }
+    mergeGraphAndSourceContracts(graphContracts, sourceContracts) {
+        const seenContractIds = new Set(graphContracts.map((c) => c.contractId));
+        const out = [...graphContracts];
+        for (const contract of sourceContracts) {
+            if (seenContractIds.has(contract.contractId))
+                continue;
+            seenContractIds.add(contract.contractId);
+            out.push(contract);
+        }
+        return out;
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitnexus",
-  "version": "1.6.6-rc.24",
+  "version": "1.6.6-rc.26",
   "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",