gitnexus 1.6.6-rc.23 → 1.6.6-rc.25

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/ingestion/filesystem-walker.js

@@ -48,12 +48,30 @@ export const walkRepositoryPaths = async (repoPath, onProgress) => {
     }
     if (skippedLarge > 0) {
         const isDefault = maxFileSizeBytes === DEFAULT_MAX_FILE_SIZE_BYTES;
+        const isOverrideUnset = !process.env.GITNEXUS_MAX_FILE_SIZE;
         const suffix = isDefault ? ', likely generated/vendored' : '';
         logger.warn(`  Skipped ${skippedLarge} large files (>${maxFileSizeBytes / 1024}KB${suffix})`);
-        if (isVerboseIngestionEnabled()) {
-            for (const p of skippedLargePaths) {
-                logger.warn(`  - ${p}`);
-            }
+        // Always show at least the first few paths so users can diagnose why
+        // edges are missing from a specific file (issue #1659). The full list is
+        // gated behind GITNEXUS_VERBOSE=1 to avoid flooding output on repos with
+        // many generated/vendored blobs. Sort before slicing so the preview is
+        // stable across runs (fs.stat callbacks race within each batch).
+        skippedLargePaths.sort();
+        const SKIPPED_PREVIEW_CAP = 5;
+        const showAll = isVerboseIngestionEnabled() || skippedLargePaths.length <= SKIPPED_PREVIEW_CAP;
+        const preview = showAll ? skippedLargePaths : skippedLargePaths.slice(0, SKIPPED_PREVIEW_CAP);
+        for (const p of preview) {
+            logger.warn(`  - ${p}`);
+        }
+        if (!showAll) {
+            const remaining = skippedLargePaths.length - SKIPPED_PREVIEW_CAP;
+            logger.warn(`  ...and ${remaining} more (set GITNEXUS_VERBOSE=1 to list them all)`);
+        }
+        // Only hint about the env var when the user has not set it at all. An
+        // explicit GITNEXUS_MAX_FILE_SIZE=512 happens to resolve to the same
+        // bytes as the default but the operator clearly already knows the knob.
+        if (isDefault && isOverrideUnset) {
+            logger.warn(`  Set GITNEXUS_MAX_FILE_SIZE=<KB> to include files above the default cap.`);
         }
     }
     return entries;

package/package.json

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