gitnexus 1.6.4-rc.33 → 1.6.4-rc.34

package/dist/core/tree-sitter/parser-loader.d.ts

@@ -1,8 +1,8 @@
 import Parser from 'tree-sitter';
 import { SupportedLanguages } from '../../_shared/index.js';
-export declare const isLanguageAvailable: (language: SupportedLanguages) => boolean;
 export declare const resolveLanguageKey: (language: SupportedLanguages, filePath?: string) => string;
-export declare const getLanguageGrammar: (language: SupportedLanguages, filePath?: string) => any;
+export declare const isLanguageAvailable: (language: SupportedLanguages, filePath?: string) => boolean;
+export declare const getLanguageGrammar: (language: SupportedLanguages, filePath?: string) => unknown;
 export declare const loadParser: () => Promise<Parser>;
 export declare const loadLanguage: (language: SupportedLanguages, filePath?: string) => Promise<void>;
 export declare const createParserForLanguage: (language: SupportedLanguages, filePath?: string) => Promise<Parser>;

package/dist/core/tree-sitter/parser-loader.js

@@ -1,84 +1,183 @@
 import Parser from 'tree-sitter';
-import JavaScript from 'tree-sitter-javascript';
-import TypeScript from 'tree-sitter-typescript';
-import Python from 'tree-sitter-python';
-import Java from 'tree-sitter-java';
-import C from 'tree-sitter-c';
-import CPP from 'tree-sitter-cpp';
-// Explicit subpath import: tree-sitter-c-sharp declares `type: "module"` with
-// `main: "bindings/node"` (no extension) and no `exports` field, which triggers
-// Node 22's DEP0151 deprecation warning on the bare-package import. Importing
-// the built entrypoint directly bypasses the deprecated ESM main-field
-// resolution. (#1013)
-import CSharp from 'tree-sitter-c-sharp/bindings/node/index.js';
-import Go from 'tree-sitter-go';
-import Rust from 'tree-sitter-rust';
-import PHP from 'tree-sitter-php';
-import Ruby from 'tree-sitter-ruby';
 import { createRequire } from 'node:module';
 import { SupportedLanguages } from '../../_shared/index.js';
-// tree-sitter-swift and tree-sitter-dart are optionalDependencies — may not be installed
 const _require = createRequire(import.meta.url);
-let Swift = null;
-try {
-    Swift = _require('tree-sitter-swift');
-}
-catch { }
-let Dart = null;
-try {
-    Dart = _require('tree-sitter-dart');
-}
-catch { }
-// tree-sitter-kotlin is an optionalDependency — may not be installed
-let Kotlin = null;
-try {
-    Kotlin = _require('tree-sitter-kotlin');
-}
-catch { }
-let parser = null;
-const languageMap = {
-    [SupportedLanguages.JavaScript]: JavaScript,
-    [SupportedLanguages.TypeScript]: TypeScript.typescript,
-    [`${SupportedLanguages.TypeScript}:tsx`]: TypeScript.tsx,
-    [SupportedLanguages.Python]: Python,
-    [SupportedLanguages.Java]: Java,
-    [SupportedLanguages.C]: C,
-    [SupportedLanguages.CPlusPlus]: CPP,
-    [SupportedLanguages.CSharp]: CSharp,
-    [SupportedLanguages.Go]: Go,
-    [SupportedLanguages.Rust]: Rust,
-    ...(Kotlin ? { [SupportedLanguages.Kotlin]: Kotlin } : {}),
-    [SupportedLanguages.PHP]: PHP.php_only,
-    [SupportedLanguages.Ruby]: Ruby,
-    [SupportedLanguages.Vue]: TypeScript.typescript,
-    ...(Dart ? { [SupportedLanguages.Dart]: Dart } : {}),
-    ...(Swift ? { [SupportedLanguages.Swift]: Swift } : {}),
+const ISSUES_URL = 'https://github.com/abhigyanpatwari/GitNexus/issues';
+const SOURCES = {
+    [SupportedLanguages.JavaScript]: {
+        load: () => _require('tree-sitter-javascript'),
+        unavailableNote: 'JavaScript parsing requires `tree-sitter-javascript`. ' +
+            'Check that the package and its native binding installed cleanly (`npm ci`).',
+    },
+    [SupportedLanguages.TypeScript]: {
+        load: () => _require('tree-sitter-typescript').typescript,
+        unavailableNote: 'TypeScript parsing requires `tree-sitter-typescript`. ' +
+            'Check that the package and its native binding installed cleanly (`npm ci`).',
+    },
+    [`${SupportedLanguages.TypeScript}:tsx`]: {
+        load: () => _require('tree-sitter-typescript').tsx,
+        unavailableNote: 'TSX parsing requires `tree-sitter-typescript` (re-uses the same native binding as TS).',
+    },
+    [SupportedLanguages.Python]: {
+        load: () => _require('tree-sitter-python'),
+        unavailableNote: 'Python parsing requires `tree-sitter-python`. Check the install and native binding.',
+    },
+    [SupportedLanguages.Java]: {
+        load: () => _require('tree-sitter-java'),
+        unavailableNote: 'Java parsing requires `tree-sitter-java`. Check the install and native binding.',
+    },
+    // tree-sitter-c-sharp declares `type: "module"` with `main: "bindings/node"`
+    // (no extension) and no `exports` field, which triggers Node 22's DEP0151
+    // deprecation warning on the bare-package import. The explicit subpath
+    // bypasses the deprecated ESM main-field resolution. (#1013)
+    [SupportedLanguages.CSharp]: {
+        load: () => _require('tree-sitter-c-sharp/bindings/node/index.js'),
+        unavailableNote: 'C# parsing requires `tree-sitter-c-sharp/bindings/node/index.js`. ' +
+            `If the subpath is missing, see ${ISSUES_URL}/1013.`,
+    },
+    [SupportedLanguages.CPlusPlus]: {
+        load: () => _require('tree-sitter-cpp'),
+        unavailableNote: 'C++ parsing requires `tree-sitter-cpp`. Check the install and native binding.',
+    },
+    [SupportedLanguages.Go]: {
+        load: () => _require('tree-sitter-go'),
+        unavailableNote: 'Go parsing requires `tree-sitter-go`. Check the install and native binding.',
+    },
+    [SupportedLanguages.Rust]: {
+        load: () => _require('tree-sitter-rust'),
+        unavailableNote: 'Rust parsing requires `tree-sitter-rust`. Check the install and native binding.',
+    },
+    [SupportedLanguages.PHP]: {
+        load: () => _require('tree-sitter-php').php_only,
+        unavailableNote: 'PHP parsing requires `tree-sitter-php` (the `php_only` export). ' +
+            'Check the install and native binding.',
+    },
+    [SupportedLanguages.Ruby]: {
+        load: () => _require('tree-sitter-ruby'),
+        unavailableNote: 'Ruby parsing requires `tree-sitter-ruby`. Check the install and native binding.',
+    },
+    [SupportedLanguages.Vue]: {
+        load: () => _require('tree-sitter-typescript').typescript,
+        unavailableNote: 'Vue parsing piggybacks on `tree-sitter-typescript`. Check the install and native binding.',
+    },
+    // tree-sitter-c is a required dependency, but its native binding has
+    // historically been ABI-incompatible with the bundled tree-sitter@0.21.1
+    // runtime on some platforms (#1242, #858). Loading it through the
+    // optional machinery turns a would-be segfault into a clean degradation
+    // while preserving every other language's analysis. Severity is pinned
+    // to `error` because the package is in `dependencies`: a failure here
+    // is always an install/platform problem the user needs to see, never an
+    // expected "user opted out" condition like Swift/Dart/Kotlin.
+    [SupportedLanguages.C]: {
+        load: () => _require('tree-sitter-c'),
+        optional: true,
+        severity: 'error',
+        unavailableNote: 'C parsing disabled: `tree-sitter-c` could not be loaded. ' +
+            'This package is in `dependencies` and prebuilds ship for all supported ' +
+            'platforms (win32/darwin/linux x64+arm64, Node 18/20/22), so this ' +
+            'usually indicates a corrupted install, an unsupported Node version, ' +
+            'or a native ABI mismatch with the bundled tree-sitter runtime. ' +
+            'Try `npm rebuild tree-sitter-c` or reinstalling, then re-run analyze. ' +
+            `If the failure persists, file details at ${ISSUES_URL}/1242.`,
+    },
+    // optionalDependencies — may be absent on platforms without prebuilds
+    // or when users skip optional installs.
+    [SupportedLanguages.Swift]: {
+        load: () => _require('tree-sitter-swift'),
+        optional: true,
+        unavailableNote: 'Swift parsing disabled: vendored `tree-sitter-swift` (under ' +
+            '`gitnexus/vendor/tree-sitter-swift`) failed to load. ' +
+            'Likely cause: no prebuilt `.node` for this platform/architecture. ' +
+            `See ${ISSUES_URL}/1130.`,
+    },
+    [SupportedLanguages.Dart]: {
+        load: () => _require('tree-sitter-dart'),
+        optional: true,
+        unavailableNote: 'Dart parsing disabled: vendored `tree-sitter-dart` (under ' +
+            '`gitnexus/vendor/tree-sitter-dart`) failed to load. ' +
+            'Likely cause: native compile failed at install (missing python3/make/g++). ' +
+            `See ${ISSUES_URL}/1125.`,
+    },
+    [SupportedLanguages.Kotlin]: {
+        load: () => _require('tree-sitter-kotlin'),
+        optional: true,
+        unavailableNote: 'Kotlin parsing disabled: `tree-sitter-kotlin` is an optionalDependency ' +
+            'and is not installed (or its native binding failed to build).',
+    },
+};
+const loadCache = new Map();
+const logged = new Set();
+const logFailure = (key, result) => {
+    if (result.ok === true)
+        return;
+    if (logged.has(key))
+        return;
+    logged.add(key);
+    const message = `[gitnexus] ${result.note} (${result.error.message})`;
+    if (result.severity === 'error')
+        console.error(message);
+    else
+        console.warn(message);
 };
-export const isLanguageAvailable = (language) => language in languageMap;
 export const resolveLanguageKey = (language, filePath) => language === SupportedLanguages.TypeScript && filePath?.endsWith('.tsx')
     ? `${language}:tsx`
     : language;
-export const getLanguageGrammar = (language, filePath) => {
-    const key = resolveLanguageKey(language, filePath);
-    const lang = languageMap[key];
-    if (!lang) {
-        throw new Error(`Unsupported language: ${language}`);
+const loadGrammar = (key) => {
+    const cached = loadCache.get(key);
+    if (cached)
+        return cached;
+    const source = SOURCES[key];
+    if (!source) {
+        const result = {
+            ok: false,
+            error: new Error(`Unsupported language: ${key}`),
+            note: `No grammar registered for language key \`${key}\`. Add a row to SOURCES.`,
+            fatal: true,
+            severity: 'error',
+        };
+        loadCache.set(key, result);
+        return result;
+    }
+    let result;
+    try {
+        result = { ok: true, grammar: source.load() };
+    }
+    catch (err) {
+        const fatal = !source.optional;
+        result = {
+            ok: false,
+            error: err,
+            note: source.unavailableNote,
+            fatal,
+            severity: source.severity ?? (fatal ? 'error' : 'warn'),
+        };
     }
-    return lang;
+    loadCache.set(key, result);
+    if (result.ok === false)
+        logFailure(key, result);
+    return result;
 };
-export const loadParser = async () => {
-    if (parser)
-        return parser;
-    parser = new Parser();
-    return parser;
+export const isLanguageAvailable = (language, filePath) => loadGrammar(resolveLanguageKey(language, filePath)).ok;
+export const getLanguageGrammar = (language, filePath) => {
+    const key = resolveLanguageKey(language, filePath);
+    const result = loadGrammar(key);
+    if (result.ok === true)
+        return result.grammar;
+    // Fatal failures throw the original underlying error (preserving stack)
+    // after the note has been logged. Optional failures fall through to the
+    // standard "Unsupported language" message that callers already handle.
+    if (result.fatal)
+        throw result.error;
+    throw new Error(`Unsupported language: ${language}`);
 };
+let sharedParser = null;
+export const loadParser = async () => (sharedParser ??= new Parser());
 export const loadLanguage = async (language, filePath) => {
-    if (!parser)
-        await loadParser();
+    const parser = await loadParser();
     parser.setLanguage(getLanguageGrammar(language, filePath));
 };
 export const createParserForLanguage = async (language, filePath) => {
-    const freshParser = new Parser();
-    freshParser.setLanguage(getLanguageGrammar(language, filePath));
-    return freshParser;
+    const parser = new Parser();
+    parser.setLanguage(getLanguageGrammar(language, filePath));
+    return parser;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitnexus",
-  "version": "1.6.4-rc.33",
+  "version": "1.6.4-rc.34",
   "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",
@@ -72,9 +72,9 @@
     "onnxruntime-node": "^1.24.0",
     "pandemonium": "^2.4.0",
     "tree-sitter": "^0.21.1",
-    "tree-sitter-c": "0.23.2",
+    "tree-sitter-c": "0.21.4",
     "tree-sitter-c-sharp": "0.23.1",
-    "tree-sitter-cpp": "^0.23.4",
+    "tree-sitter-cpp": "0.23.2",
     "tree-sitter-go": "^0.23.0",
     "tree-sitter-java": "^0.23.5",
     "tree-sitter-javascript": "^0.23.0",
@@ -109,8 +109,7 @@
   "overrides": {
     "@huggingface/transformers": {
       "onnxruntime-node": "$onnxruntime-node"
-    },
-    "tree-sitter-c": "0.23.2"
+    }
   },
   "engines": {
     "node": ">=20.0.0"