gitnexus 1.2.9 → 1.3.0

package/dist/core/kuzu/kuzu-adapter.js

@@ -1,8 +1,10 @@
 import fs from 'fs/promises';
+import { createReadStream } from 'fs';
+import { createInterface } from 'readline';
 import path from 'path';
 import kuzu from 'kuzu';
 import { NODE_TABLES, REL_TABLE_NAME, SCHEMA_QUERIES, EMBEDDING_TABLE_NAME, } from './schema.js';
-import { generateAllCSVs } from './csv-generator.js';
+import { streamAllCSVsToDisk } from './csv-generator.js';
 let db = null;
 let conn = null;
 const normalizeCopyPath = (filePath) => filePath.replace(/\\/g, '/');
@@ -49,26 +51,14 @@ export const initKuzu = async (dbPath) => {
     }
     return { db, conn };
 };
-export const loadGraphToKuzu = async (graph, fileContents, storagePath, onProgress) => {
+export const loadGraphToKuzu = async (graph, repoPath, storagePath, onProgress) => {
     if (!conn) {
         throw new Error('KuzuDB not initialized. Call initKuzu first.');
     }
     const log = onProgress || (() => { });
-    const csvData = generateAllCSVs(graph, fileContents);
     const csvDir = path.join(storagePath, 'csv');
-    await fs.mkdir(csvDir, { recursive: true });
-    log('Generating CSVs...');
-    const nodeFiles = [];
-    for (const [tableName, csv] of csvData.nodes.entries()) {
-        const rowCount = csv.split('\n').length - 1;
-        if (rowCount <= 0)
-            continue;
-        const filePath = path.join(csvDir, `${tableName.toLowerCase()}.csv`);
-        await fs.writeFile(filePath, csv, 'utf-8');
-        nodeFiles.push({ table: tableName, path: filePath, rows: rowCount });
-    }
-    // Write relationship CSV to disk for bulk COPY
-    const relCsvPath = path.join(csvDir, 'relations.csv');
+    log('Streaming CSVs to disk...');
+    const csvResult = await streamAllCSVsToDisk(graph, repoPath, csvDir);
     const validTables = new Set(NODE_TABLES);
     const getNodeLabel = (nodeId) => {
         if (nodeId.startsWith('comm_'))
@@ -77,35 +67,14 @@ export const loadGraphToKuzu = async (graph, fileContents, storagePath, onProgre
             return 'Process';
         return nodeId.split(':')[0];
     };
-    const relLines = csvData.relCSV.split('\n');
-    const relHeader = relLines[0];
-    const validRelLines = [relHeader];
-    let skippedRels = 0;
-    for (let i = 1; i < relLines.length; i++) {
-        const line = relLines[i];
-        if (!line.trim())
-            continue;
-        const match = line.match(/"([^"]*)","([^"]*)"/);
-        if (!match) {
-            skippedRels++;
-            continue;
-        }
-        const fromLabel = getNodeLabel(match[1]);
-        const toLabel = getNodeLabel(match[2]);
-        if (!validTables.has(fromLabel) || !validTables.has(toLabel)) {
-            skippedRels++;
-            continue;
-        }
-        validRelLines.push(line);
-    }
-    await fs.writeFile(relCsvPath, validRelLines.join('\n'), 'utf-8');
-    // Bulk COPY all node CSVs
+    // Bulk COPY all node CSVs (sequential — KuzuDB allows only one write txn at a time)
+    const nodeFiles = [...csvResult.nodeFiles.entries()];
     const totalSteps = nodeFiles.length + 1; // +1 for relationships
     let stepsDone = 0;
-    for (const { table, path: filePath, rows } of nodeFiles) {
+    for (const [table, { csvPath, rows }] of nodeFiles) {
         stepsDone++;
         log(`Loading nodes ${stepsDone}/${totalSteps}: ${table} (${rows.toLocaleString()} rows)`);
-        const normalizedPath = normalizeCopyPath(filePath);
+        const normalizedPath = normalizeCopyPath(csvPath);
         const copyQuery = getCopyQuery(table, normalizedPath);
         try {
             await conn.query(copyQuery);
@@ -122,17 +91,33 @@ export const loadGraphToKuzu = async (graph, fileContents, storagePath, onProgre
         }
     }
     // Bulk COPY relationships — split by FROM→TO label pair (KuzuDB requires it)
-    const insertedRels = validRelLines.length - 1;
-    const warnings = [];
-    if (insertedRels > 0) {
-        const relsByPair = new Map();
-        for (let i = 1; i < validRelLines.length; i++) {
-            const line = validRelLines[i];
+    // Stream-read the relation CSV line by line to avoid exceeding V8 max string length
+    let relHeader = '';
+    const relsByPair = new Map();
+    let skippedRels = 0;
+    let totalValidRels = 0;
+    await new Promise((resolve, reject) => {
+        const rl = createInterface({ input: createReadStream(csvResult.relCsvPath, 'utf-8'), crlfDelay: Infinity });
+        let isFirst = true;
+        rl.on('line', (line) => {
+            if (isFirst) {
+                relHeader = line;
+                isFirst = false;
+                return;
+            }
+            if (!line.trim())
+                return;
             const match = line.match(/"([^"]*)","([^"]*)"/);
-            if (!match)
-                continue;
+            if (!match) {
+                skippedRels++;
+                return;
+            }
             const fromLabel = getNodeLabel(match[1]);
             const toLabel = getNodeLabel(match[2]);
+            if (!validTables.has(fromLabel) || !validTables.has(toLabel)) {
+                skippedRels++;
+                return;
+            }
             const pairKey = `${fromLabel}|${toLabel}`;
             let list = relsByPair.get(pairKey);
             if (!list) {
@@ -140,7 +125,14 @@ export const loadGraphToKuzu = async (graph, fileContents, storagePath, onProgre
                 relsByPair.set(pairKey, list);
             }
             list.push(line);
-        }
+            totalValidRels++;
+        });
+        rl.on('close', resolve);
+        rl.on('error', reject);
+    });
+    const insertedRels = totalValidRels;
+    const warnings = [];
+    if (insertedRels > 0) {
         log(`Loading edges: ${insertedRels.toLocaleString()} across ${relsByPair.size} types`);
         let pairIdx = 0;
         let failedPairEdges = 0;
@@ -182,12 +174,12 @@ export const loadGraphToKuzu = async (graph, fileContents, storagePath, onProgre
     }
     // Cleanup all CSVs
     try {
-        await fs.unlink(relCsvPath);
+        await fs.unlink(csvResult.relCsvPath);
     }
     catch { }
-    for (const { path: filePath } of nodeFiles) {
+    for (const [, { csvPath }] of csvResult.nodeFiles) {
         try {
-            await fs.unlink(filePath);
+            await fs.unlink(csvPath);
         }
         catch { }
     }
@@ -253,6 +245,8 @@ const fallbackRelationshipInserts = async (validRelLines, validTables, getNodeLa
         }
     }
 };
+/** Tables with isExported column (TypeScript/JS-native types) */
+const TABLES_WITH_EXPORTED = new Set(['Function', 'Class', 'Interface', 'Method', 'CodeElement']);
 const getCopyQuery = (table, filePath) => {
     const t = escapeTableName(table);
     if (table === 'File') {
@@ -267,8 +261,12 @@ const getCopyQuery = (table, filePath) => {
     if (table === 'Process') {
         return `COPY ${t}(id, label, heuristicLabel, processType, stepCount, communities, entryPointId, terminalId) FROM "${filePath}" ${COPY_CSV_OPTS}`;
     }
-    // Code element tables (Function, Class, Interface, Method, CodeElement, and multi-language)
-    return `COPY ${t}(id, name, filePath, startLine, endLine, isExported, content) FROM "${filePath}" ${COPY_CSV_OPTS}`;
+    // TypeScript/JS code element tables have isExported; multi-language tables do not
+    if (TABLES_WITH_EXPORTED.has(table)) {
+        return `COPY ${t}(id, name, filePath, startLine, endLine, isExported, content) FROM "${filePath}" ${COPY_CSV_OPTS}`;
+    }
+    // Multi-language tables (Struct, Impl, Trait, Macro, etc.)
+    return `COPY ${t}(id, name, filePath, startLine, endLine, content) FROM "${filePath}" ${COPY_CSV_OPTS}`;
 };
 /**
  * Insert a single node to KuzuDB
@@ -292,6 +290,7 @@ export const insertNodeToKuzu = async (label, properties, dbPath) => {
             return `'${String(v).replace(/\\/g, '\\\\').replace(/'/g, "''")}'`;
         };
         // Build INSERT query based on node type
+        const t = escapeTableName(label);
         let query;
         if (label === 'File') {
             query = `CREATE (n:File {id: ${escapeValue(properties.id)}, name: ${escapeValue(properties.name)}, filePath: ${escapeValue(properties.filePath)}, content: ${escapeValue(properties.content || '')}})`;
@@ -299,9 +298,12 @@ export const insertNodeToKuzu = async (label, properties, dbPath) => {
         else if (label === 'Folder') {
             query = `CREATE (n:Folder {id: ${escapeValue(properties.id)}, name: ${escapeValue(properties.name)}, filePath: ${escapeValue(properties.filePath)}})`;
         }
+        else if (TABLES_WITH_EXPORTED.has(label)) {
+            query = `CREATE (n:${t} {id: ${escapeValue(properties.id)}, name: ${escapeValue(properties.name)}, filePath: ${escapeValue(properties.filePath)}, startLine: ${properties.startLine || 0}, endLine: ${properties.endLine || 0}, isExported: ${!!properties.isExported}, content: ${escapeValue(properties.content || '')}})`;
+        }
         else {
-            // Function, Class, Method, Interface, etc. - standard code element schema
-            query = `CREATE (n:${label} {id: ${escapeValue(properties.id)}, name: ${escapeValue(properties.name)}, filePath: ${escapeValue(properties.filePath)}, startLine: ${properties.startLine || 0}, endLine: ${properties.endLine || 0}, content: ${escapeValue(properties.content || '')}})`;
+            // Multi-language tables (Struct, Impl, Trait, Macro, etc.) — no isExported
+            query = `CREATE (n:${t} {id: ${escapeValue(properties.id)}, name: ${escapeValue(properties.name)}, filePath: ${escapeValue(properties.filePath)}, startLine: ${properties.startLine || 0}, endLine: ${properties.endLine || 0}, content: ${escapeValue(properties.content || '')}})`;
         }
         // Use per-query connection if dbPath provided (avoids lock conflicts)
         if (targetDbPath) {
@@ -362,14 +364,18 @@ export const batchInsertNodesToKuzu = async (nodes, dbPath) => {
             try {
                 let query;
                 // Use MERGE instead of CREATE for upsert behavior (handles duplicates gracefully)
+                const t = escapeTableName(label);
                 if (label === 'File') {
                     query = `MERGE (n:File {id: ${escapeValue(properties.id)}}) SET n.name = ${escapeValue(properties.name)}, n.filePath = ${escapeValue(properties.filePath)}, n.content = ${escapeValue(properties.content || '')}`;
                 }
                 else if (label === 'Folder') {
                     query = `MERGE (n:Folder {id: ${escapeValue(properties.id)}}) SET n.name = ${escapeValue(properties.name)}, n.filePath = ${escapeValue(properties.filePath)}`;
                 }
+                else if (TABLES_WITH_EXPORTED.has(label)) {
+                    query = `MERGE (n:${t} {id: ${escapeValue(properties.id)}}) SET n.name = ${escapeValue(properties.name)}, n.filePath = ${escapeValue(properties.filePath)}, n.startLine = ${properties.startLine || 0}, n.endLine = ${properties.endLine || 0}, n.isExported = ${!!properties.isExported}, n.content = ${escapeValue(properties.content || '')}`;
+                }
                 else {
-                    query = `MERGE (n:${label} {id: ${escapeValue(properties.id)}}) SET n.name = ${escapeValue(properties.name)}, n.filePath = ${escapeValue(properties.filePath)}, n.startLine = ${properties.startLine || 0}, n.endLine = ${properties.endLine || 0}, n.content = ${escapeValue(properties.content || '')}`;
+                    query = `MERGE (n:${t} {id: ${escapeValue(properties.id)}}) SET n.name = ${escapeValue(properties.name)}, n.filePath = ${escapeValue(properties.filePath)}, n.startLine = ${properties.startLine || 0}, n.endLine = ${properties.endLine || 0}, n.content = ${escapeValue(properties.content || '')}`;
                 }
                 await tempConn.query(query);
                 inserted++;
@@ -435,7 +441,7 @@ export const getKuzuStats = async () => {
     let totalNodes = 0;
     for (const tableName of NODE_TABLES) {
         try {
-            const queryResult = await conn.query(`MATCH (n:${tableName}) RETURN count(n) AS cnt`);
+            const queryResult = await conn.query(`MATCH (n:${escapeTableName(tableName)}) RETURN count(n) AS cnt`);
             const nodeResult = Array.isArray(queryResult) ? queryResult[0] : queryResult;
             const nodeRows = await nodeResult.getAll();
             if (nodeRows.length > 0) {
@@ -506,6 +512,7 @@ export const closeKuzu = async () => {
         catch { }
         db = null;
     }
+    ftsLoaded = false;
 };
 export const isKuzuReady = () => conn !== null && db !== null;
 /**
@@ -539,13 +546,14 @@ export const deleteNodesForFile = async (filePath, dbPath) => {
                 continue;
             try {
                 // First count how many we'll delete
-                const countResult = await targetConn.query(`MATCH (n:${tableName}) WHERE n.filePath = '${escapedPath}' RETURN count(n) AS cnt`);
+                const tn = escapeTableName(tableName);
+                const countResult = await targetConn.query(`MATCH (n:${tn}) WHERE n.filePath = '${escapedPath}' RETURN count(n) AS cnt`);
                 const result = Array.isArray(countResult) ? countResult[0] : countResult;
                 const rows = await result.getAll();
                 const count = Number(rows[0]?.cnt ?? rows[0]?.[0] ?? 0);
                 if (count > 0) {
                     // Delete nodes (and implicitly their relationships via DETACH)
-                    await targetConn.query(`MATCH (n:${tableName}) WHERE n.filePath = '${escapedPath}' DETACH DELETE n`);
+                    await targetConn.query(`MATCH (n:${tn}) WHERE n.filePath = '${escapedPath}' DETACH DELETE n`);
                     deletedNodes += count;
                 }
             }
@@ -583,9 +591,13 @@ export const getEmbeddingTableName = () => EMBEDDING_TABLE_NAME;
 // Full-Text Search (FTS) Functions
 // ============================================================================
 /**
- * Load the FTS extension (required before using FTS functions)
+ * Load the FTS extension (required before using FTS functions).
+ * Safe to call multiple times — tracks loaded state.
  */
+let ftsLoaded = false;
 export const loadFTSExtension = async () => {
+    if (ftsLoaded)
+        return;
     if (!conn) {
         throw new Error('KuzuDB not initialized. Call initKuzu first.');
     }
@@ -596,6 +608,7 @@ export const loadFTSExtension = async () => {
     catch {
         // Extension may already be loaded
     }
+    ftsLoaded = true;
 };
 /**
  * Create a full-text search index on a table
@@ -615,7 +628,6 @@ export const createFTSIndex = async (tableName, indexName, properties, stemmer =
         await conn.query(query);
     }
     catch (e) {
-        // Index may already exist
         if (!e.message?.includes('already exists')) {
             throw e;
         }

package/dist/core/kuzu/schema.d.ts

@@ -41,7 +41,7 @@ export declare const ANNOTATION_SCHEMA: string;
 export declare const CONSTRUCTOR_SCHEMA: string;
 export declare const TEMPLATE_SCHEMA: string;
 export declare const MODULE_SCHEMA: string;
-export declare const RELATION_SCHEMA = "\nCREATE REL TABLE CodeRelation (\n  FROM File TO File,\n  FROM File TO Folder,\n  FROM File TO Function,\n  FROM File TO Class,\n  FROM File TO Interface,\n  FROM File TO Method,\n  FROM File TO CodeElement,\n  FROM File TO `Struct`,\n  FROM File TO `Enum`,\n  FROM File TO `Macro`,\n  FROM File TO `Typedef`,\n  FROM File TO `Union`,\n  FROM File TO `Namespace`,\n  FROM File TO `Trait`,\n  FROM File TO `Impl`,\n  FROM File TO `TypeAlias`,\n  FROM File TO `Const`,\n  FROM File TO `Static`,\n  FROM File TO `Property`,\n  FROM File TO `Record`,\n  FROM File TO `Delegate`,\n  FROM File TO `Annotation`,\n  FROM File TO `Constructor`,\n  FROM File TO `Template`,\n  FROM File TO `Module`,\n  FROM Folder TO Folder,\n  FROM Folder TO File,\n  FROM Function TO Function,\n  FROM Function TO Method,\n  FROM Function TO Class,\n  FROM Function TO Community,\n  FROM Function TO `Macro`,\n  FROM Function TO `Struct`,\n  FROM Function TO `Template`,\n  FROM Function TO `Enum`,\n  FROM Function TO `Namespace`,\n  FROM Function TO `TypeAlias`,\n  FROM Function TO `Module`,\n  FROM Function TO `Impl`,\n  FROM Function TO Interface,\n  FROM Function TO `Constructor`,\n  FROM Class TO Method,\n  FROM Class TO Function,\n  FROM Class TO Class,\n  FROM Class TO Interface,\n  FROM Class TO Community,\n  FROM Class TO `Template`,\n  FROM Class TO `TypeAlias`,\n  FROM Class TO `Struct`,\n  FROM Class TO `Enum`,\n  FROM Class TO `Annotation`,\n  FROM Class TO `Constructor`,\n  FROM Method TO Function,\n  FROM Method TO Method,\n  FROM Method TO Class,\n  FROM Method TO Community,\n  FROM Method TO `Template`,\n  FROM Method TO `Struct`,\n  FROM Method TO `TypeAlias`,\n  FROM Method TO `Enum`,\n  FROM Method TO `Macro`,\n  FROM Method TO `Namespace`,\n  FROM Method TO `Module`,\n  FROM Method TO `Impl`,\n  FROM Method TO Interface,\n  FROM Method TO `Constructor`,\n  FROM `Template` TO `Template`,\n  FROM `Template` TO Function,\n  FROM `Template` TO Method,\n  FROM `Template` TO Class,\n  FROM `Template` TO `Struct`,\n  FROM `Template` TO `TypeAlias`,\n  FROM `Template` TO `Enum`,\n  FROM `Template` TO `Macro`,\n  FROM `Template` TO Interface,\n  FROM `Template` TO `Constructor`,\n  FROM `Module` TO `Module`,\n  FROM CodeElement TO Community,\n  FROM Interface TO Community,\n  FROM Interface TO Function,\n  FROM Interface TO Method,\n  FROM Interface TO Class,\n  FROM Interface TO Interface,\n  FROM Interface TO `TypeAlias`,\n  FROM Interface TO `Struct`,\n  FROM Interface TO `Constructor`,\n  FROM `Struct` TO Community,\n  FROM `Struct` TO `Trait`,\n  FROM `Struct` TO Function,\n  FROM `Struct` TO Method,\n  FROM `Enum` TO Community,\n  FROM `Macro` TO Community,\n  FROM `Macro` TO Function,\n  FROM `Macro` TO Method,\n  FROM `Module` TO Function,\n  FROM `Module` TO Method,\n  FROM `Typedef` TO Community,\n  FROM `Union` TO Community,\n  FROM `Namespace` TO Community,\n  FROM `Trait` TO Community,\n  FROM `Impl` TO Community,\n  FROM `Impl` TO `Trait`,\n  FROM `TypeAlias` TO Community,\n  FROM `Const` TO Community,\n  FROM `Static` TO Community,\n  FROM `Property` TO Community,\n  FROM `Record` TO Community,\n  FROM `Delegate` TO Community,\n  FROM `Annotation` TO Community,\n  FROM `Constructor` TO Community,\n  FROM `Constructor` TO Interface,\n  FROM `Constructor` TO Class,\n  FROM `Constructor` TO Method,\n  FROM `Constructor` TO Function,\n  FROM `Constructor` TO `Constructor`,\n  FROM `Constructor` TO `Struct`,\n  FROM `Constructor` TO `Macro`,\n  FROM `Constructor` TO `Template`,\n  FROM `Constructor` TO `TypeAlias`,\n  FROM `Constructor` TO `Enum`,\n  FROM `Constructor` TO `Annotation`,\n  FROM `Constructor` TO `Impl`,\n  FROM `Constructor` TO `Namespace`,\n  FROM `Constructor` TO `Module`,\n  FROM `Template` TO Community,\n  FROM `Module` TO Community,\n  FROM Function TO Process,\n  FROM Method TO Process,\n  FROM Class TO Process,\n  FROM Interface TO Process,\n  FROM `Struct` TO Process,\n  FROM `Constructor` TO Process,\n  FROM `Module` TO Process,\n  FROM `Macro` TO Process,\n  FROM `Impl` TO Process,\n  FROM `Typedef` TO Process,\n  FROM `TypeAlias` TO Process,\n  FROM `Enum` TO Process,\n  FROM `Union` TO Process,\n  FROM `Namespace` TO Process,\n  FROM `Trait` TO Process,\n  FROM `Const` TO Process,\n  FROM `Static` TO Process,\n  FROM `Property` TO Process,\n  FROM `Record` TO Process,\n  FROM `Delegate` TO Process,\n  FROM `Annotation` TO Process,\n  FROM `Template` TO Process,\n  FROM CodeElement TO Process,\n  type STRING,\n  confidence DOUBLE,\n  reason STRING,\n  step INT32\n)";
+export declare const RELATION_SCHEMA = "\nCREATE REL TABLE CodeRelation (\n  FROM File TO File,\n  FROM File TO Folder,\n  FROM File TO Function,\n  FROM File TO Class,\n  FROM File TO Interface,\n  FROM File TO Method,\n  FROM File TO CodeElement,\n  FROM File TO `Struct`,\n  FROM File TO `Enum`,\n  FROM File TO `Macro`,\n  FROM File TO `Typedef`,\n  FROM File TO `Union`,\n  FROM File TO `Namespace`,\n  FROM File TO `Trait`,\n  FROM File TO `Impl`,\n  FROM File TO `TypeAlias`,\n  FROM File TO `Const`,\n  FROM File TO `Static`,\n  FROM File TO `Property`,\n  FROM File TO `Record`,\n  FROM File TO `Delegate`,\n  FROM File TO `Annotation`,\n  FROM File TO `Constructor`,\n  FROM File TO `Template`,\n  FROM File TO `Module`,\n  FROM Folder TO Folder,\n  FROM Folder TO File,\n  FROM Function TO Function,\n  FROM Function TO Method,\n  FROM Function TO Class,\n  FROM Function TO Community,\n  FROM Function TO `Macro`,\n  FROM Function TO `Struct`,\n  FROM Function TO `Template`,\n  FROM Function TO `Enum`,\n  FROM Function TO `Namespace`,\n  FROM Function TO `TypeAlias`,\n  FROM Function TO `Module`,\n  FROM Function TO `Impl`,\n  FROM Function TO Interface,\n  FROM Function TO `Constructor`,\n  FROM Function TO `Const`,\n  FROM Function TO `Typedef`,\n  FROM Function TO `Union`,\n  FROM Class TO Method,\n  FROM Class TO Function,\n  FROM Class TO Class,\n  FROM Class TO Interface,\n  FROM Class TO Community,\n  FROM Class TO `Template`,\n  FROM Class TO `TypeAlias`,\n  FROM Class TO `Struct`,\n  FROM Class TO `Enum`,\n  FROM Class TO `Annotation`,\n  FROM Class TO `Constructor`,\n  FROM Class TO `Trait`,\n  FROM Class TO `Macro`,\n  FROM Class TO `Impl`,\n  FROM Class TO `Union`,\n  FROM Method TO Function,\n  FROM Method TO Method,\n  FROM Method TO Class,\n  FROM Method TO Community,\n  FROM Method TO `Template`,\n  FROM Method TO `Struct`,\n  FROM Method TO `TypeAlias`,\n  FROM Method TO `Enum`,\n  FROM Method TO `Macro`,\n  FROM Method TO `Namespace`,\n  FROM Method TO `Module`,\n  FROM Method TO `Impl`,\n  FROM Method TO Interface,\n  FROM Method TO `Constructor`,\n  FROM `Template` TO `Template`,\n  FROM `Template` TO Function,\n  FROM `Template` TO Method,\n  FROM `Template` TO Class,\n  FROM `Template` TO `Struct`,\n  FROM `Template` TO `TypeAlias`,\n  FROM `Template` TO `Enum`,\n  FROM `Template` TO `Macro`,\n  FROM `Template` TO Interface,\n  FROM `Template` TO `Constructor`,\n  FROM `Module` TO `Module`,\n  FROM CodeElement TO Community,\n  FROM Interface TO Community,\n  FROM Interface TO Function,\n  FROM Interface TO Method,\n  FROM Interface TO Class,\n  FROM Interface TO Interface,\n  FROM Interface TO `TypeAlias`,\n  FROM Interface TO `Struct`,\n  FROM Interface TO `Constructor`,\n  FROM `Struct` TO Community,\n  FROM `Struct` TO `Trait`,\n  FROM `Struct` TO Function,\n  FROM `Struct` TO Method,\n  FROM `Enum` TO Community,\n  FROM `Macro` TO Community,\n  FROM `Macro` TO Function,\n  FROM `Macro` TO Method,\n  FROM `Module` TO Function,\n  FROM `Module` TO Method,\n  FROM `Typedef` TO Community,\n  FROM `Union` TO Community,\n  FROM `Namespace` TO Community,\n  FROM `Trait` TO Community,\n  FROM `Impl` TO Community,\n  FROM `Impl` TO `Trait`,\n  FROM `Impl` TO `Struct`,\n  FROM `Impl` TO `Impl`,\n  FROM `TypeAlias` TO Community,\n  FROM `TypeAlias` TO `Trait`,\n  FROM `Const` TO Community,\n  FROM `Static` TO Community,\n  FROM `Property` TO Community,\n  FROM `Record` TO Community,\n  FROM `Delegate` TO Community,\n  FROM `Annotation` TO Community,\n  FROM `Constructor` TO Community,\n  FROM `Constructor` TO Interface,\n  FROM `Constructor` TO Class,\n  FROM `Constructor` TO Method,\n  FROM `Constructor` TO Function,\n  FROM `Constructor` TO `Constructor`,\n  FROM `Constructor` TO `Struct`,\n  FROM `Constructor` TO `Macro`,\n  FROM `Constructor` TO `Template`,\n  FROM `Constructor` TO `TypeAlias`,\n  FROM `Constructor` TO `Enum`,\n  FROM `Constructor` TO `Annotation`,\n  FROM `Constructor` TO `Impl`,\n  FROM `Constructor` TO `Namespace`,\n  FROM `Constructor` TO `Module`,\n  FROM `Template` TO Community,\n  FROM `Module` TO Community,\n  FROM Function TO Process,\n  FROM Method TO Process,\n  FROM Class TO Process,\n  FROM Interface TO Process,\n  FROM `Struct` TO Process,\n  FROM `Constructor` TO Process,\n  FROM `Module` TO Process,\n  FROM `Macro` TO Process,\n  FROM `Impl` TO Process,\n  FROM `Typedef` TO Process,\n  FROM `TypeAlias` TO Process,\n  FROM `Enum` TO Process,\n  FROM `Union` TO Process,\n  FROM `Namespace` TO Process,\n  FROM `Trait` TO Process,\n  FROM `Const` TO Process,\n  FROM `Static` TO Process,\n  FROM `Property` TO Process,\n  FROM `Record` TO Process,\n  FROM `Delegate` TO Process,\n  FROM `Annotation` TO Process,\n  FROM `Template` TO Process,\n  FROM CodeElement TO Process,\n  type STRING,\n  confidence DOUBLE,\n  reason STRING,\n  step INT32\n)";
 export declare const EMBEDDING_SCHEMA = "\nCREATE NODE TABLE CodeEmbedding (\n  nodeId STRING,\n  embedding FLOAT[384],\n  PRIMARY KEY (nodeId)\n)";
 /**
  * Create vector index for semantic search

package/dist/core/kuzu/schema.js

@@ -209,6 +209,9 @@ CREATE REL TABLE ${REL_TABLE_NAME} (
   FROM Function TO \`Impl\`,
   FROM Function TO Interface,
   FROM Function TO \`Constructor\`,
+  FROM Function TO \`Const\`,
+  FROM Function TO \`Typedef\`,
+  FROM Function TO \`Union\`,
   FROM Class TO Method,
   FROM Class TO Function,
   FROM Class TO Class,
@@ -220,6 +223,10 @@ CREATE REL TABLE ${REL_TABLE_NAME} (
   FROM Class TO \`Enum\`,
   FROM Class TO \`Annotation\`,
   FROM Class TO \`Constructor\`,
+  FROM Class TO \`Trait\`,
+  FROM Class TO \`Macro\`,
+  FROM Class TO \`Impl\`,
+  FROM Class TO \`Union\`,
   FROM Method TO Function,
   FROM Method TO Method,
   FROM Method TO Class,
@@ -270,7 +277,10 @@ CREATE REL TABLE ${REL_TABLE_NAME} (
   FROM \`Trait\` TO Community,
   FROM \`Impl\` TO Community,
   FROM \`Impl\` TO \`Trait\`,
+  FROM \`Impl\` TO \`Struct\`,
+  FROM \`Impl\` TO \`Impl\`,
   FROM \`TypeAlias\` TO Community,
+  FROM \`TypeAlias\` TO \`Trait\`,
   FROM \`Const\` TO Community,
   FROM \`Static\` TO Community,
   FROM \`Property\` TO Community,

package/dist/types/pipeline.d.ts

@@ -15,14 +15,18 @@ export interface PipelineProgress {
 }
 export interface PipelineResult {
     graph: KnowledgeGraph;
-    fileContents: Map<string, string>;
+    /** Absolute path to the repo root — used for lazy file reads during KuzuDB loading */
+    repoPath: string;
+    /** Total files scanned (for stats) */
+    totalFileCount: number;
     communityResult?: CommunityDetectionResult;
     processResult?: ProcessDetectionResult;
 }
 export interface SerializablePipelineResult {
     nodes: GraphNode[];
     relationships: GraphRelationship[];
-    fileContents: Record<string, string>;
+    repoPath: string;
+    totalFileCount: number;
 }
 export declare const serializePipelineResult: (result: PipelineResult) => SerializablePipelineResult;
 export declare const deserializePipelineResult: (serialized: SerializablePipelineResult, createGraph: () => KnowledgeGraph) => PipelineResult;

package/dist/types/pipeline.js

@@ -1,8 +1,9 @@
 // Helper to convert PipelineResult to serializable format
 export const serializePipelineResult = (result) => ({
-    nodes: result.graph.nodes,
-    relationships: result.graph.relationships,
-    fileContents: Object.fromEntries(result.fileContents),
+    nodes: [...result.graph.iterNodes()],
+    relationships: [...result.graph.iterRelationships()],
+    repoPath: result.repoPath,
+    totalFileCount: result.totalFileCount,
 });
 // Helper to reconstruct from serializable format (used in main thread)
 export const deserializePipelineResult = (serialized, createGraph) => {
@@ -11,6 +12,7 @@ export const deserializePipelineResult = (serialized, createGraph) => {
     serialized.relationships.forEach(rel => graph.addRelationship(rel));
     return {
         graph,
-        fileContents: new Map(Object.entries(serialized.fileContents)),
+        repoPath: serialized.repoPath,
+        totalFileCount: serialized.totalFileCount,
     };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitnexus",
-  "version": "1.2.9",
+  "version": "1.3.0",
   "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",