@veewo/gitnexus 1.5.2 → 1.5.4

package/dist/cli/clean.d.ts

@@ -1,8 +1,9 @@
 /**
  * Clean Command
  *
- * Removes the .gitnexus index from the current repository.
- * Also unregisters it from the global registry.
+ * Removes the GitNexus index from the current repository while preserving
+ * configuration files (e.g. sync-manifest.txt). Also unregisters the repo
+ * from the global registry.
  */
 export declare const cleanCommand: (options?: {
     force?: boolean;

package/dist/cli/clean.js

@@ -1,11 +1,32 @@
 /**
  * Clean Command
  *
- * Removes the .gitnexus index from the current repository.
- * Also unregisters it from the global registry.
+ * Removes the GitNexus index from the current repository while preserving
+ * configuration files (e.g. sync-manifest.txt). Also unregisters the repo
+ * from the global registry.
  */
 import fs from 'fs/promises';
+import path from 'path';
 import { findRepo, unregisterRepo, listRegisteredRepos } from '../storage/repo-manager.js';
+/** Files under .gitnexus/ that are configuration, not index data. */
+const PRESERVE_FILES = new Set(['sync-manifest.txt']);
+async function cleanStoragePath(storagePath) {
+    let entries;
+    try {
+        entries = await fs.readdir(storagePath);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return;
+        throw err;
+    }
+    for (const entry of entries) {
+        if (PRESERVE_FILES.has(entry))
+            continue;
+        const fullPath = path.join(storagePath, entry);
+        await fs.rm(fullPath, { recursive: true, force: true });
+    }
+}
 export const cleanCommand = async (options) => {
     // --all flag: clean all indexed repos
     if (options?.all) {
@@ -15,22 +36,22 @@ export const cleanCommand = async (options) => {
                 console.log('No indexed repositories found.');
                 return;
             }
-            console.log(`This will delete GitNexus indexes for ${entries.length} repo(s):`);
+            console.log(`This will clean GitNexus indexes for ${entries.length} repo(s):`);
             for (const entry of entries) {
                 console.log(`  - ${entry.name} (${entry.path})`);
             }
-            console.log('\nRun with --force to confirm deletion.');
+            console.log('\nRun with --force to confirm.');
             return;
         }
         const entries = await listRegisteredRepos();
         for (const entry of entries) {
             try {
-                await fs.rm(entry.storagePath, { recursive: true, force: true });
+                await cleanStoragePath(entry.storagePath);
                 await unregisterRepo(entry.path);
-                console.log(`Deleted: ${entry.name} (${entry.storagePath})`);
+                console.log(`Cleaned: ${entry.name} (${entry.storagePath})`);
             }
             catch (err) {
-                console.error(`Failed to delete ${entry.name}:`, err);
+                console.error(`Failed to clean ${entry.name}:`, err);
             }
         }
         return;
@@ -44,17 +65,17 @@ export const cleanCommand = async (options) => {
     }
     const repoName = repo.repoPath.split(/[/\\]/).pop() || repo.repoPath;
     if (!options?.force) {
-        console.log(`This will delete the GitNexus index for: ${repoName}`);
+        console.log(`This will clean the GitNexus index for: ${repoName}`);
         console.log(`   Path: ${repo.storagePath}`);
-        console.log('\nRun with --force to confirm deletion.');
+        console.log('\nRun with --force to confirm.');
         return;
     }
     try {
-        await fs.rm(repo.storagePath, { recursive: true, force: true });
+        await cleanStoragePath(repo.storagePath);
         await unregisterRepo(repo.repoPath);
-        console.log(`Deleted: ${repo.storagePath}`);
+        console.log(`Cleaned: ${repo.storagePath}`);
     }
     catch (err) {
-        console.error('Failed to delete:', err);
+        console.error('Failed to clean:', err);
     }
 };

package/dist/config/supported-languages.d.ts

@@ -11,5 +11,6 @@ export declare enum SupportedLanguages {
     Rust = "rust",
     PHP = "php",
     Kotlin = "kotlin",
-    Swift = "swift"
+    Swift = "swift",
+    GDScript = "gdscript"
 }

package/dist/config/supported-languages.js

@@ -13,4 +13,5 @@ export var SupportedLanguages;
     SupportedLanguages["PHP"] = "php";
     SupportedLanguages["Kotlin"] = "kotlin";
     SupportedLanguages["Swift"] = "swift";
+    SupportedLanguages["GDScript"] = "gdscript";
 })(SupportedLanguages || (SupportedLanguages = {}));

package/dist/core/ingestion/call-routing.js

@@ -28,6 +28,7 @@ export const callRouters = {
     [SupportedLanguages.CPlusPlus]: noRouting,
     [SupportedLanguages.C]: noRouting,
     [SupportedLanguages.Ruby]: routeRubyCall,
+    [SupportedLanguages.GDScript]: noRouting,
 };
 // ── Pre-allocated singletons for common return values ────────────────────────
 const CALL_RESULT = { kind: 'call' };

package/dist/core/ingestion/export-detection.js

@@ -212,6 +212,7 @@ const exportCheckers = {
     [SupportedLanguages.PHP]: phpExportChecker,
     [SupportedLanguages.Swift]: swiftExportChecker,
     [SupportedLanguages.Ruby]: (_node, _name) => true,
+    [SupportedLanguages.GDScript]: (_node, name) => !name.startsWith('_'),
 };
 // ============================================================================
 // Public API

package/dist/core/ingestion/parsing-processor.js

@@ -104,8 +104,10 @@ const processParsingSequential = async (graph, files, symbolTable, astCache, onF
             skippedLanguages.set(language, (skippedLanguages.get(language) || 0) + 1);
             continue;
         }
-        // Skip files larger than the max tree-sitter buffer (32 MB)
-        if (file.content.length > TREE_SITTER_MAX_BUFFER)
+        // Skip files larger than the max tree-sitter buffer (32 MB).
+        // Use UTF-8 bytes, not JS string length, because tree-sitter buffer sizing
+        // is byte-oriented and multi-byte source can otherwise slip past the cap.
+        if (Buffer.byteLength(file.content, 'utf8') > TREE_SITTER_MAX_BUFFER)
             continue;
         try {
             await loadLanguage(language, file.path);

package/dist/core/ingestion/tree-sitter-queries.d.ts

@@ -11,5 +11,6 @@ export declare const RUST_QUERIES = "\n; Functions & Items\n(function_item name:
 export declare const PHP_QUERIES = "\n; \u2500\u2500 Namespace \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(namespace_definition\n  name: (namespace_name) @name) @definition.namespace\n\n; \u2500\u2500 Classes \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(class_declaration\n  name: (name) @name) @definition.class\n\n; \u2500\u2500 Interfaces \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(interface_declaration\n  name: (name) @name) @definition.interface\n\n; \u2500\u2500 Traits \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(trait_declaration\n  name: (name) @name) @definition.trait\n\n; \u2500\u2500 Enums (PHP 8.1) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(enum_declaration\n  name: (name) @name) @definition.enum\n\n; \u2500\u2500 Top-level functions \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(function_definition\n  name: (name) @name) @definition.function\n\n; \u2500\u2500 Methods (including constructors) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(method_declaration\n  name: (name) @name) @definition.method\n\n; \u2500\u2500 Class properties (including Eloquent $fillable, $casts, etc.) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(property_declaration\n  (property_element\n    (variable_name\n      (name) @name))) @definition.property\n\n; \u2500\u2500 Imports: use statements \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n; Simple: use App\\Models\\User;\n(namespace_use_declaration\n  (namespace_use_clause\n    (qualified_name) @import.source)) @import\n\n; \u2500\u2500 Function/method calls \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n; Regular function call: foo()\n(function_call_expression\n  function: (name) @call.name) @call\n\n; Method call: $obj->method()\n(member_call_expression\n  name: (name) @call.name) @call\n\n; Nullsafe method call: $obj?->method()\n(nullsafe_member_call_expression\n  name: (name) @call.name) @call\n\n; Static call: Foo::bar() (php_only uses scoped_call_expression)\n(scoped_call_expression\n  name: (name) @call.name) @call\n\n; Constructor call: new User()\n(object_creation_expression (name) @call.name) @call\n\n; \u2500\u2500 Heritage: extends \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(class_declaration\n  name: (name) @heritage.class\n  (base_clause\n    [(name) (qualified_name)] @heritage.extends)) @heritage\n\n; \u2500\u2500 Heritage: implements \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(class_declaration\n  name: (name) @heritage.class\n  (class_interface_clause\n    [(name) (qualified_name)] @heritage.implements)) @heritage.impl\n\n; \u2500\u2500 Heritage: use trait (must capture enclosing class name) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(class_declaration\n  name: (name) @heritage.class\n  body: (declaration_list\n    (use_declaration\n      [(name) (qualified_name)] @heritage.trait))) @heritage\n";
 export declare const RUBY_QUERIES = "\n; \u2500\u2500 Modules \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(module\n  name: (constant) @name) @definition.module\n\n; \u2500\u2500 Classes \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(class\n  name: (constant) @name) @definition.class\n\n; \u2500\u2500 Instance methods \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(method\n  name: (identifier) @name) @definition.method\n\n; \u2500\u2500 Singleton (class-level) methods \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(singleton_method\n  name: (identifier) @name) @definition.method\n\n; \u2500\u2500 All calls (require, include, attr_*, and regular calls routed in JS) \u2500\u2500\u2500\u2500\u2500\n(call\n  method: (identifier) @call.name) @call\n\n; \u2500\u2500 Bare calls without parens (identifiers at statement level are method calls) \u2500\n; NOTE: This may over-capture variable reads as calls (e.g. 'result' at\n; statement level). Ruby's grammar makes bare identifiers ambiguous \u2014 they\n; could be local variables or zero-arity method calls. Post-processing via\n; isBuiltInOrNoise and symbol resolution filtering suppresses most false\n; positives, but a variable name that coincidentally matches a method name\n; elsewhere may produce a false CALLS edge.\n(body_statement\n  (identifier) @call.name @call)\n\n; \u2500\u2500 Heritage: class < SuperClass \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(class\n  name: (constant) @heritage.class\n  superclass: (superclass\n    (constant) @heritage.extends)) @heritage\n";
 export declare const KOTLIN_QUERIES = "\n; \u2500\u2500 Interfaces \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n; tree-sitter-kotlin (fwcd) has no interface_declaration node type.\n; Interfaces are class_declaration nodes with an anonymous \"interface\" keyword child.\n(class_declaration\n  \"interface\"\n  (type_identifier) @name) @definition.interface\n\n; \u2500\u2500 Classes (regular, data, sealed, enum) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n; All have the anonymous \"class\" keyword child. enum class has both\n; \"enum\" and \"class\" children \u2014 the \"class\" child still matches.\n(class_declaration\n  \"class\"\n  (type_identifier) @name) @definition.class\n\n; \u2500\u2500 Object declarations (Kotlin singletons) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(object_declaration\n  (type_identifier) @name) @definition.class\n\n; \u2500\u2500 Companion objects (named only) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(companion_object\n  (type_identifier) @name) @definition.class\n\n; \u2500\u2500 Functions (top-level, member, extension) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(function_declaration\n  (simple_identifier) @name) @definition.function\n\n; \u2500\u2500 Properties \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(property_declaration\n  (variable_declaration\n    (simple_identifier) @name)) @definition.property\n\n; \u2500\u2500 Enum entries \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(enum_entry\n  (simple_identifier) @name) @definition.enum\n\n; \u2500\u2500 Type aliases \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(type_alias\n  (type_identifier) @name) @definition.type\n\n; \u2500\u2500 Imports \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(import_header\n  (identifier) @import.source) @import\n\n; \u2500\u2500 Function calls (direct) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(call_expression\n  (simple_identifier) @call.name) @call\n\n; \u2500\u2500 Method calls (via navigation: obj.method()) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(call_expression\n  (navigation_expression\n    (navigation_suffix\n      (simple_identifier) @call.name))) @call\n\n; \u2500\u2500 Constructor invocations \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(constructor_invocation\n  (user_type\n    (type_identifier) @call.name)) @call\n\n; \u2500\u2500 Infix function calls (e.g., a to b, x until y) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(infix_expression\n  (simple_identifier) @call.name) @call\n\n; \u2500\u2500 Heritage: extends / implements via delegation_specifier \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n; Interface implementation (bare user_type): class Foo : Bar\n(class_declaration\n  (type_identifier) @heritage.class\n  (delegation_specifier\n    (user_type (type_identifier) @heritage.extends))) @heritage\n\n; Class extension (constructor_invocation): class Foo : Bar()\n(class_declaration\n  (type_identifier) @heritage.class\n  (delegation_specifier\n    (constructor_invocation\n      (user_type (type_identifier) @heritage.extends)))) @heritage\n";
+export declare const GDSCRIPT_QUERIES = "\n; \u2500\u2500 Class Name (file-level class) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(class_name_statement\n  (name) @name) @definition.class\n\n; \u2500\u2500 Inner Class Definition \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(class_definition\n  name: (name) @name) @definition.class\n\n; \u2500\u2500 Functions & Methods \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(function_definition\n  name: (name) @name) @definition.function\n\n; \u2500\u2500 Constructor (_init) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(constructor_definition) @definition.constructor\n\n; \u2500\u2500 Constructor with name capture for symbol extraction \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(constructor_definition\n  parameters: (parameters)) @definition.constructor\n\n; \u2500\u2500 Signals \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(signal_statement\n  name: (name) @name) @definition.signal\n\n; \u2500\u2500 Enums \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(enum_definition\n  name: (name) @name) @definition.enum\n\n; \u2500\u2500 Constants \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(const_statement\n  (name) @name) @definition.const\n\n; \u2500\u2500 Extends (inheritance) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(extends_statement\n  (type (identifier) @heritage.extends)) @heritage\n\n; \u2500\u2500 Class with extends \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(class_definition\n  name: (name) @heritage.class\n  extends: (extends_statement\n    (type (identifier) @heritage.extends))) @heritage\n\n; \u2500\u2500 Preload/Load (imports) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n; Only preload(\"res://...\") and load(\"res://...\") are real imports.\n; Generic call expressions must NOT be tagged @import to avoid double-classifying\n; call sites as imports (which corrupts import resolution and call routing).\n(call\n  function: (identifier) @_preload\n  arguments: (arguments (string) @import.source)) @import\n(#eq? @_preload \"preload\")\n\n(call\n  function: (identifier) @_load\n  arguments: (arguments (string) @import.source)) @import\n(#eq? @_load \"load\")\n\n; \u2500\u2500 Function Calls \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(call\n  function: (identifier) @call.name) @call\n\n";
 export declare const SWIFT_QUERIES = "\n; Classes\n(class_declaration \"class\" name: (type_identifier) @name) @definition.class\n\n; Structs\n(class_declaration \"struct\" name: (type_identifier) @name) @definition.struct\n\n; Enums\n(class_declaration \"enum\" name: (type_identifier) @name) @definition.enum\n\n; Extensions (mapped to class \u2014 no dedicated label in schema)\n(class_declaration \"extension\" name: (user_type (type_identifier) @name)) @definition.class\n\n; Actors\n(class_declaration \"actor\" name: (type_identifier) @name) @definition.class\n\n; Protocols (mapped to interface)\n(protocol_declaration name: (type_identifier) @name) @definition.interface\n\n; Type aliases\n(typealias_declaration name: (type_identifier) @name) @definition.type\n\n; Functions (top-level and methods)\n(function_declaration name: (simple_identifier) @name) @definition.function\n\n; Protocol method declarations\n(protocol_function_declaration name: (simple_identifier) @name) @definition.method\n\n; Initializers\n(init_declaration) @definition.constructor\n\n; Properties (stored and computed)\n(property_declaration (pattern (simple_identifier) @name)) @definition.property\n\n; Imports\n(import_declaration (identifier (simple_identifier) @import.source)) @import\n\n; Calls - direct function calls\n(call_expression (simple_identifier) @call.name) @call\n\n; Calls - member/navigation calls (obj.method())\n(call_expression (navigation_expression (navigation_suffix (simple_identifier) @call.name))) @call\n\n; Heritage - class/struct/enum inheritance and protocol conformance\n(class_declaration name: (type_identifier) @heritage.class\n  (inheritance_specifier inherits_from: (user_type (type_identifier) @heritage.extends))) @heritage\n\n; Heritage - protocol inheritance\n(protocol_declaration name: (type_identifier) @heritage.class\n  (inheritance_specifier inherits_from: (user_type (type_identifier) @heritage.extends))) @heritage\n\n; Heritage - extension protocol conformance (e.g. extension Foo: SomeProtocol)\n; Extensions wrap the name in user_type unlike class/struct/enum declarations\n(class_declaration \"extension\" name: (user_type (type_identifier) @heritage.class)\n  (inheritance_specifier inherits_from: (user_type (type_identifier) @heritage.extends))) @heritage\n";
 export declare const LANGUAGE_QUERIES: Record<SupportedLanguages, string>;

package/dist/core/ingestion/tree-sitter-queries.js

@@ -615,6 +615,67 @@ export const KOTLIN_QUERIES = `
       (user_type (type_identifier) @heritage.extends)))) @heritage
 `;
 // Swift queries - works with tree-sitter-swift
+export const GDSCRIPT_QUERIES = `
+; ── Class Name (file-level class) ───────────────────────────────────────────
+(class_name_statement
+  (name) @name) @definition.class
+
+; ── Inner Class Definition ──────────────────────────────────────────────────
+(class_definition
+  name: (name) @name) @definition.class
+
+; ── Functions & Methods ─────────────────────────────────────────────────────
+(function_definition
+  name: (name) @name) @definition.function
+
+; ── Constructor (_init) ─────────────────────────────────────────────────────
+(constructor_definition) @definition.constructor
+
+; ── Constructor with name capture for symbol extraction ────────────────────
+(constructor_definition
+  parameters: (parameters)) @definition.constructor
+
+; ── Signals ─────────────────────────────────────────────────────────────────
+(signal_statement
+  name: (name) @name) @definition.signal
+
+; ── Enums ───────────────────────────────────────────────────────────────────
+(enum_definition
+  name: (name) @name) @definition.enum
+
+; ── Constants ───────────────────────────────────────────────────────────────
+(const_statement
+  (name) @name) @definition.const
+
+; ── Extends (inheritance) ───────────────────────────────────────────────────
+(extends_statement
+  (type (identifier) @heritage.extends)) @heritage
+
+; ── Class with extends ──────────────────────────────────────────────────────
+(class_definition
+  name: (name) @heritage.class
+  extends: (extends_statement
+    (type (identifier) @heritage.extends))) @heritage
+
+; ── Preload/Load (imports) ──────────────────────────────────────────────────
+; Only preload("res://...") and load("res://...") are real imports.
+; Generic call expressions must NOT be tagged @import to avoid double-classifying
+; call sites as imports (which corrupts import resolution and call routing).
+(call
+  function: (identifier) @_preload
+  arguments: (arguments (string) @import.source)) @import
+(#eq? @_preload "preload")
+
+(call
+  function: (identifier) @_load
+  arguments: (arguments (string) @import.source)) @import
+(#eq? @_load "load")
+
+; ── Function Calls ──────────────────────────────────────────────────────────
+(call
+  function: (identifier) @call.name) @call
+
+`;
 export const SWIFT_QUERIES = `
 ; Classes
 (class_declaration "class" name: (type_identifier) @name) @definition.class
@@ -685,4 +746,5 @@ export const LANGUAGE_QUERIES = {
     [SupportedLanguages.PHP]: PHP_QUERIES,
     [SupportedLanguages.Kotlin]: KOTLIN_QUERIES,
     [SupportedLanguages.Swift]: SWIFT_QUERIES,
+    [SupportedLanguages.GDScript]: GDSCRIPT_QUERIES,
 };

package/dist/core/ingestion/type-extractors/index.d.ts

@@ -17,6 +17,7 @@ export declare const typeConfigs: {
     cpp: LanguageTypeConfig;
     php: LanguageTypeConfig;
     ruby: LanguageTypeConfig;
+    gdscript: any;
 };
 export type { LanguageTypeConfig, TypeBindingExtractor, ParameterExtractor, ConstructorBindingScanner, ForLoopExtractor, PendingAssignmentExtractor, PatternBindingExtractor, } from './types.js';
 export { TYPED_PARAMETER_TYPES, extractSimpleTypeName, extractGenericTypeArgs, extractVarName, findChildByType, extractRubyConstructorAssignment } from './shared.js';

package/dist/core/ingestion/type-extractors/index.js

@@ -27,5 +27,13 @@ export const typeConfigs = {
     [SupportedLanguages.CPlusPlus]: cCppConfig,
     [SupportedLanguages.PHP]: phpConfig,
     [SupportedLanguages.Ruby]: rubyConfig,
+    [SupportedLanguages.GDScript]: {
+        declarationNodeTypes: new Set(),
+        extractDeclaration: () => null,
+        extractParameter: () => null,
+        extractConstructor: () => null,
+        extractReturnBinding: () => null,
+        extractPatternBinding: () => null,
+    },
 };
 export { TYPED_PARAMETER_TYPES, extractSimpleTypeName, extractGenericTypeArgs, extractVarName, findChildByType, extractRubyConstructorAssignment } from './shared.js';

package/dist/core/ingestion/utils.js

@@ -612,6 +612,9 @@ export const getLanguageFromFilename = (filename) => {
     // Swift (extensions)
     if (filename.endsWith('.swift'))
         return SupportedLanguages.Swift;
+    // GDScript (Godot Engine)
+    if (filename.endsWith('.gd'))
+        return SupportedLanguages.GDScript;
     return null;
 };
 const CALL_ARGUMENT_LIST_TYPES = new Set([

package/dist/core/ingestion/workers/parse-worker.js

@@ -14,20 +14,8 @@ import Ruby from 'tree-sitter-ruby';
 import { createRequire } from 'node:module';
 import { SupportedLanguages } from '../../../config/supported-languages.js';
 import { LANGUAGE_QUERIES } from '../tree-sitter-queries.js';
-import { TREE_SITTER_MAX_BUFFER } from '../constants.js';
-// tree-sitter-swift is an optionalDependency — may not be installed
+import { getTreeSitterBufferSize, TREE_SITTER_MAX_BUFFER } from '../constants.js';
 const _require = createRequire(import.meta.url);
-let Swift = null;
-try {
-    Swift = _require('tree-sitter-swift');
-}
-catch { }
-// tree-sitter-kotlin is an optionalDependency — may not be installed
-let Kotlin = null;
-try {
-    Kotlin = _require('tree-sitter-kotlin');
-}
-catch { }
 import { getLanguageFromFilename, FUNCTION_NODE_TYPES, extractFunctionName, isBuiltInOrNoise, getDefinitionNodeFromCaptures, findEnclosingClassId, extractMethodSignature, countCallArguments, inferCallForm, extractReceiverName, extractReceiverNode, CALL_EXPRESSION_TYPES, extractCallChain, } from '../utils.js';
 import { buildTypeEnv } from '../type-env.js';
 import { isNodeExported } from '../export-detection.js';
@@ -41,7 +29,7 @@ import { callRouters } from '../call-routing.js';
 // Worker-local parser + language map
 // ============================================================================
 const parser = new Parser();
-const languageMap = {
+const requiredLanguageMap = {
     [SupportedLanguages.JavaScript]: JavaScript,
     [SupportedLanguages.TypeScript]: TypeScript.typescript,
     [`${SupportedLanguages.TypeScript}:tsx`]: TypeScript.tsx,
@@ -52,10 +40,60 @@ const languageMap = {
     [SupportedLanguages.CSharp]: CSharp,
     [SupportedLanguages.Go]: Go,
     [SupportedLanguages.Rust]: Rust,
-    ...(Kotlin ? { [SupportedLanguages.Kotlin]: Kotlin } : {}),
     [SupportedLanguages.PHP]: PHP.php_only,
     [SupportedLanguages.Ruby]: Ruby,
-    ...(Swift ? { [SupportedLanguages.Swift]: Swift } : {}),
+};
+const optionalLanguagePackages = {
+    [SupportedLanguages.GDScript]: 'tree-sitter-gdscript',
+    [SupportedLanguages.Swift]: 'tree-sitter-swift',
+    [SupportedLanguages.Kotlin]: 'tree-sitter-kotlin',
+};
+const optionalLanguageCache = new Map();
+const optionalAvailabilityCache = new Map();
+const isOptionalLanguageInstalled = (language) => {
+    if (optionalAvailabilityCache.has(language)) {
+        return optionalAvailabilityCache.get(language);
+    }
+    const packageName = optionalLanguagePackages[language];
+    if (!packageName) {
+        optionalAvailabilityCache.set(language, false);
+        return false;
+    }
+    try {
+        _require.resolve(packageName);
+        optionalAvailabilityCache.set(language, true);
+        return true;
+    }
+    catch {
+        optionalAvailabilityCache.set(language, false);
+        return false;
+    }
+};
+const loadOptionalLanguage = (language) => {
+    if (optionalLanguageCache.has(language)) {
+        return optionalLanguageCache.get(language);
+    }
+    const packageName = optionalLanguagePackages[language];
+    if (!packageName) {
+        optionalLanguageCache.set(language, null);
+        return null;
+    }
+    try {
+        const grammar = _require(packageName);
+        optionalLanguageCache.set(language, grammar);
+        return grammar;
+    }
+    catch {
+        optionalLanguageCache.set(language, null);
+        optionalAvailabilityCache.set(language, false);
+        return null;
+    }
+};
+const resolveLanguage = (key, language) => {
+    if (key in requiredLanguageMap) {
+        return requiredLanguageMap[key];
+    }
+    return loadOptionalLanguage(language);
 };
 /**
  * Check if a language grammar is available in this worker.
@@ -67,13 +105,13 @@ const isLanguageAvailable = (language, filePath) => {
     const key = language === SupportedLanguages.TypeScript && filePath.endsWith('.tsx')
         ? `${language}:tsx`
         : language;
-    return key in languageMap && languageMap[key] != null;
+    return key in requiredLanguageMap || isOptionalLanguageInstalled(language);
 };
 const setLanguage = (language, filePath) => {
     const key = language === SupportedLanguages.TypeScript && filePath.endsWith('.tsx')
         ? `${language}:tsx`
         : language;
-    const lang = languageMap[key];
+    const lang = resolveLanguage(key, language);
     if (!lang)
         throw new Error(`Unsupported language: ${language}`);
     parser.setLanguage(lang);
@@ -713,27 +751,23 @@ const processFileGroup = (files, language, queryString, result, onFileProcessed)
         return;
     }
     for (const file of files) {
-        // Skip files larger than the max tree-sitter buffer (32 MB)
-        if (file.content.length > TREE_SITTER_MAX_BUFFER)
+        // Skip files larger than the max tree-sitter buffer (32 MB).
+        // tree-sitter buffer sizing is byte-oriented; JS string length undercounts
+        // UTF-8 multi-byte source and can route oversized input into native code.
+        if (Buffer.byteLength(file.content, 'utf8') > TREE_SITTER_MAX_BUFFER)
             continue;
         let tree;
         let usedRawContentFallback = false;
         try {
-            const MAX_CHUNK = 4096;
-            tree = parser.parse((index) => {
-                if (index >= file.content.length)
-                    return null;
-                return file.content.slice(index, index + MAX_CHUNK);
+            tree = parser.parse(file.content, null, {
+                bufferSize: getTreeSitterBufferSize(Buffer.byteLength(file.content, 'utf8')),
             });
         }
         catch (err) {
             if (file.rawContent && file.rawContent !== file.content) {
                 try {
-                    const MAX_CHUNK = 4096;
-                    tree = parser.parse((index) => {
-                        if (index >= file.rawContent.length)
-                            return null;
-                        return file.rawContent.slice(index, index + MAX_CHUNK);
+                    tree = parser.parse(file.rawContent, null, {
+                        bufferSize: getTreeSitterBufferSize(Buffer.byteLength(file.rawContent, 'utf8')),
                     });
                     usedRawContentFallback = true;
                 }
@@ -749,11 +783,8 @@ const processFileGroup = (files, language, queryString, result, onFileProcessed)
         }
         if (file.rawContent && file.rawContent !== file.content && tree.rootNode?.hasError) {
             try {
-                const MAX_CHUNK = 4096;
-                const rawTree = parser.parse((index) => {
-                    if (index >= file.rawContent.length)
-                        return null;
-                    return file.rawContent.slice(index, index + MAX_CHUNK);
+                const rawTree = parser.parse(file.rawContent, null, {
+                    bufferSize: getTreeSitterBufferSize(Buffer.byteLength(file.rawContent, 'utf8')),
                 });
                 if (!rawTree.rootNode?.hasError) {
                     tree = rawTree;

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

@@ -4,9 +4,13 @@ export declare const isLanguageAvailable: (language: SupportedLanguages) => bool
 export declare const loadParser: () => Promise<Parser>;
 export declare const loadLanguage: (language: SupportedLanguages, filePath?: string) => Promise<void>;
 /**
- * Parse source code using tree-sitter's chunked callback API.
- * Avoids the native binding's single-buffer size limit (< 32768 bytes)
- * that causes "Invalid argument" errors on large files.
+ * Parse source code using tree-sitter's string input path with an adaptive
+ * native buffer size.
+ *
+ * The callback input API receives byte offsets. Returning JavaScript string
+ * slices from those byte offsets is unsafe for UTF-8/multi-byte content and has
+ * caused native tree-sitter crashes in large repositories. Use the stable string
+ * input path instead and raise tree-sitter's internal buffer for large files.
  *
  * @param content - Full source file content as UTF-8 string
  * @param oldTree - Optional previous tree for incremental parsing (must call tree.edit() first)

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

@@ -12,21 +12,10 @@ import PHP from 'tree-sitter-php';
 import Ruby from 'tree-sitter-ruby';
 import { createRequire } from 'node:module';
 import { SupportedLanguages } from '../../config/supported-languages.js';
-// tree-sitter-swift is an optionalDependency — may not be installed
+import { getTreeSitterBufferSize } from '../ingestion/constants.js';
 const _require = createRequire(import.meta.url);
-let Swift = null;
-try {
-    Swift = _require('tree-sitter-swift');
-}
-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 = {
+const requiredLanguageMap = {
     [SupportedLanguages.JavaScript]: JavaScript,
     [SupportedLanguages.TypeScript]: TypeScript.typescript,
     [`${SupportedLanguages.TypeScript}:tsx`]: TypeScript.tsx,
@@ -37,12 +26,62 @@ const languageMap = {
     [SupportedLanguages.CSharp]: CSharp,
     [SupportedLanguages.Go]: Go,
     [SupportedLanguages.Rust]: Rust,
-    ...(Kotlin ? { [SupportedLanguages.Kotlin]: Kotlin } : {}),
     [SupportedLanguages.PHP]: PHP.php_only,
     [SupportedLanguages.Ruby]: Ruby,
-    ...(Swift ? { [SupportedLanguages.Swift]: Swift } : {}),
 };
-export const isLanguageAvailable = (language) => language in languageMap;
+const optionalLanguagePackages = {
+    [SupportedLanguages.GDScript]: 'tree-sitter-gdscript',
+    [SupportedLanguages.Swift]: 'tree-sitter-swift',
+    [SupportedLanguages.Kotlin]: 'tree-sitter-kotlin',
+};
+const optionalLanguageCache = new Map();
+const optionalAvailabilityCache = new Map();
+const isOptionalLanguageInstalled = (language) => {
+    if (optionalAvailabilityCache.has(language)) {
+        return optionalAvailabilityCache.get(language);
+    }
+    const packageName = optionalLanguagePackages[language];
+    if (!packageName) {
+        optionalAvailabilityCache.set(language, false);
+        return false;
+    }
+    try {
+        _require.resolve(packageName);
+        optionalAvailabilityCache.set(language, true);
+        return true;
+    }
+    catch {
+        optionalAvailabilityCache.set(language, false);
+        return false;
+    }
+};
+const loadOptionalLanguage = (language) => {
+    if (optionalLanguageCache.has(language)) {
+        return optionalLanguageCache.get(language);
+    }
+    const packageName = optionalLanguagePackages[language];
+    if (!packageName) {
+        optionalLanguageCache.set(language, null);
+        return null;
+    }
+    try {
+        const grammar = _require(packageName);
+        optionalLanguageCache.set(language, grammar);
+        return grammar;
+    }
+    catch {
+        optionalLanguageCache.set(language, null);
+        optionalAvailabilityCache.set(language, false);
+        return null;
+    }
+};
+const resolveLanguage = (key, language) => {
+    if (key in requiredLanguageMap) {
+        return requiredLanguageMap[key];
+    }
+    return loadOptionalLanguage(language);
+};
+export const isLanguageAvailable = (language) => language in requiredLanguageMap || isOptionalLanguageInstalled(language);
 export const loadParser = async () => {
     if (parser)
         return parser;
@@ -55,17 +94,20 @@ export const loadLanguage = async (language, filePath) => {
     const key = language === SupportedLanguages.TypeScript && filePath?.endsWith('.tsx')
         ? `${language}:tsx`
         : language;
-    const lang = languageMap[key];
+    const lang = resolveLanguage(key, language);
     if (!lang) {
         throw new Error(`Unsupported language: ${language}`);
     }
     parser.setLanguage(lang);
 };
-const MAX_CHUNK = 4096;
 /**
- * Parse source code using tree-sitter's chunked callback API.
- * Avoids the native binding's single-buffer size limit (< 32768 bytes)
- * that causes "Invalid argument" errors on large files.
+ * Parse source code using tree-sitter's string input path with an adaptive
+ * native buffer size.
+ *
+ * The callback input API receives byte offsets. Returning JavaScript string
+ * slices from those byte offsets is unsafe for UTF-8/multi-byte content and has
+ * caused native tree-sitter crashes in large repositories. Use the stable string
+ * input path instead and raise tree-sitter's internal buffer for large files.
  *
  * @param content - Full source file content as UTF-8 string
  * @param oldTree - Optional previous tree for incremental parsing (must call tree.edit() first)
@@ -74,9 +116,6 @@ const MAX_CHUNK = 4096;
 export const parseContent = (content, oldTree) => {
     if (!parser)
         throw new Error('Parser not initialized — call loadParser() first');
-    return parser.parse((index) => {
-        if (index >= content.length)
-            return null;
-        return content.slice(index, index + MAX_CHUNK);
-    }, oldTree);
+    const bufferSize = getTreeSitterBufferSize(Buffer.byteLength(content, 'utf8'));
+    return parser.parse(content, oldTree ?? null, { bufferSize });
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veewo/gitnexus",
-  "version": "1.5.2",
+  "version": "1.5.4",
   "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",
@@ -101,7 +101,8 @@
   },
   "optionalDependencies": {
     "tree-sitter-kotlin": "^0.3.8",
-    "tree-sitter-swift": "^0.6.0"
+    "tree-sitter-swift": "^0.6.0",
+    "tree-sitter-gdscript": "^6.1.0"
   },
   "devDependencies": {
     "@types/cli-progress": "^3.11.6",

package/skills/gitnexus-cli.md

@@ -60,35 +60,83 @@ $GN analyze
 
 Run from the project root. This parses all source files, builds the knowledge graph, writes it to `.gitnexus/`, and generates CLAUDE.md / AGENTS.md context files.
 
-| Flag                       | Effect                                                                                    |
-| -------------------------- | ----------------------------------------------------------------------------------------- |
-| `--force`                  | Force full re-index even if up to date                                                    |
-| `--embeddings`             | Enable embedding generation for semantic search (off by default)                          |
-| `--extensions <ext>`       | Limit parsing to specific file types (comma-separated, e.g., `--extensions ".cs,.meta"`) |
-| `--csharp-define-csproj <path>` | Load C# `DefineConstants` from a `.csproj` and normalize `#if/#elif/#else/#endif` before parsing |
-| `--scope-prefix <prefix>`  | Limit analysis to a path prefix (e.g., `--scope-prefix Assets/` for Unity)               |
-| `--scope-manifest <file>`  | Read scope rules from a manifest file (e.g., `.gitnexus/sync-manifest.txt`)              |
-| `--sync-manifest-policy <policy>` | Drift policy when explicit CLI values differ from manifest directives: `ask|update|keep|error` |
-| `--skills`                 | Generate repo-specific skill files from detected code communities                         |
+| Flag | Effect |
+|------|--------|
+| `--force` | Force full re-index even if up to date |
+| `--embeddings` | Enable embedding generation (off by default) |
+| `--skills` | Generate repo-specific skill files from detected communities |
 
-**Scope manifest syntax:** Non-`@` lines are path-prefix scope rules (same semantics as before). `@key=value` directives set analyze options: `@extensions=<csv>`, `@repoAlias=<name>`, `@embeddings=<true|false>`. Unknown directives fail fast.
+**Two mutually exclusive paths. Choose one per rebuild.**
 
-**Defaulting + drift guard:** If `.gitnexus/sync-manifest.txt` exists and you do not pass `--scope-manifest`/`--scope-prefix`, analyze auto-uses that file. When explicit CLI values (`--extensions`, `--repo-alias`, `--embeddings`) differ from manifest directives, CLI follows `--sync-manifest-policy` (default `ask`; non-TTY requires explicit policy).
+#### Path A: sync-manifest managed (recommended for Unity / monorepo)
 
-**When to run:** First time in a project, after major code changes, or when `gitnexus://repo/{name}/context` reports the index is stale. In Claude Code, a PostToolUse hook runs `analyze` automatically after `git commit` and `git merge`, preserving embeddings if previously generated.
+If `.gitnexus/sync-manifest.txt` exists, `analyze` **auto-uses** it when you do **not** pass `--scope-prefix` or `--scope-manifest`.
 
-**Unity projects:** Add `--extensions ".cs,.meta"` to ensure Unity asset edges (`UNITY_ASSET_GUID_REF`, `UNITY_COMPONENT_INSTANCE`) are parsed. Add `--scope-prefix Assets/` to limit scope if all code lives under `Assets/`.
+```bash
+# Unity project with an existing manifest — this is the normal rebuild command
+$GN analyze --force
+```
+
+The manifest controls scope rules, extensions, and repo alias. Example:
+
+```
+Assets/
+Packages/
+@extensions=.cs,.meta
+@repoAlias=neonspark-core
+```
+
+- Non-`@` lines = path-prefix scope rules
+- `@extensions=<csv>` = file extension filter
+- `@repoAlias=<name>` = stable repo alias
+- `@embeddings=<true|false>` = embedding toggle
+
+**Drift guard:** If you pass `--extensions` / `--repo-alias` / `--embeddings` while a manifest exists, CLI compares them. Use `--sync-manifest-policy` to control: `ask|update|keep|error` (default `ask`; non-TTY requires explicit policy).
+
+**Do not mix Path A and Path B.** Passing `--scope-prefix` or `--extensions` when a manifest exists triggers the drift guard and may error out in non-TTY environments.
+
+#### Path B: manual CLI flags (first-time or simple projects)
 
-**C# conditional-compilation projects (recommended):**
+Use when no sync-manifest exists:
 
-- Unity: pass `--csharp-define-csproj /path/to/Assembly-CSharp.csproj` (for neonspark, use `/Volumes/Shuttle/projects/neonspark/Assembly-CSharp.csproj`).
-- Non-Unity: discover candidate project files first, then pass the intended one explicitly:
+```bash
+# Unity project, first-time index
+$GN analyze --force --extensions ".cs,.meta" --scope-prefix Assets/ --repo-alias neonspark-core
+
+# Generic project
+$GN analyze --force --extensions ".ts,.tsx" --scope-prefix src/
+```
+
+| Manual flag | Effect |
+|-------------|--------|
+| `--extensions <ext>` | Comma-separated file extensions |
+| `--scope-prefix <prefix>` | Add a path prefix rule (repeatable) |
+| `--scope-manifest <file>` | Read scope rules from a manifest file |
+| `--repo-alias <name>` | Override indexed repository name |
+| `--csharp-define-csproj <path>` | Load C# `DefineConstants` from `.csproj` for `#if` normalization |
+
+**C# preprocessing (Unity):** For projects with heavy conditional compilation, add `--csharp-define-csproj /path/to/Assembly-CSharp.csproj` (neonspark: `/Volumes/Shuttle/projects/neonspark/Assembly-CSharp.csproj`). Without it, C# files are parsed raw and tree-sitter may mishandle `#if` branches.
+
+#### Rebuild recovery — when analyze hangs or crashes
+
+If `analyze --force` hangs (no progress after 5+ minutes) or crashes leaving a corrupted index:
 
 ```bash
-rg --files -g '*.csproj'
-$GN analyze --extensions ".cs" --csharp-define-csproj <picked-project>.csproj
+# 1. Clean the corrupted index (preserves sync-manifest.txt)
+$GN clean --force
+
+# 2. Rebuild
+$GN analyze --force
 ```
 
+**When to clean before rebuild:**
+- Previous run left `.gitnexus/csv/` with no `relations.csv` (crash mid-streaming)
+- `.gitnexus/lbug.wal` exists but `lbug` is tiny (LadybugDB in unrecovered state)
+- Any `analyze` run hangs indefinitely in the "Loading into LadybugDB..." phase
+- After `gitnexus clean`, always run `analyze --force` to rebuild
+
+**When to run:** First time in a project, after major code changes, or when `gitnexus://repo/{name}/context` reports the index is stale.
+
 ### status — Check index freshness
 
 ```bash
@@ -97,13 +145,13 @@ $GN status
 
 Shows whether the current repo has a GitNexus index, when it was last updated, and symbol/relationship counts. Use this to check if re-indexing is needed.
 
-### clean — Delete the index
+### clean — Delete the index (preserves config)
 
 ```bash
-$GN clean
+$GN clean --force
 ```
 
-Deletes the `.gitnexus/` directory and unregisters the repo from the global registry. Use before re-indexing if the index is corrupt or after removing GitNexus from a project.
+Removes the GitNexus index (graph, CSVs, LadybugDB) from `.gitnexus/` while **preserving `sync-manifest.txt`** and other configuration files. Use this to recover from a corrupted index before re-indexing.
 
 | Flag      | Effect                                            |
 | --------- | ------------------------------------------------- |
@@ -189,6 +237,7 @@ $GN unity-ui-trace "Assets/NEON/VeewoUI/Uxml/BarScreen/Patch/PatchItemPreview.ux
 - **"Not inside a git repository"**: Run from a directory inside a git repo
 - **Index is stale after re-analyzing**: Restart Claude Code to reload the MCP server
 - **Embeddings slow**: Omit `--embeddings` (it's off by default) or set `OPENAI_API_KEY` for faster API-based embedding
+- **`analyze --force` hangs or crashes**: Run `$GN clean --force` to remove the corrupted index (sync-manifest is preserved), then `$GN analyze --force` to rebuild. Common corruption signatures: `.gitnexus/csv/` exists but `relations.csv` is missing; `.gitnexus/lbug.wal` exists while `lbug` is only a few KB.
 
 ## Runtime-Chain Closure Guard