gitnexus 1.4.1 → 1.4.6

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

@@ -1,5 +1,7 @@
 import { Worker } from 'node:worker_threads';
 import os from 'node:os';
+import fs from 'node:fs';
+import { fileURLToPath } from 'node:url';
 /**
  * Max files to send to a worker in a single postMessage.
  * Keeps structured-clone memory bounded per sub-batch.
@@ -12,6 +14,12 @@ const SUB_BATCH_TIMEOUT_MS = 30_000;
  * Create a pool of worker threads.
  */
 export const createWorkerPool = (workerUrl, poolSize) => {
+    // Validate worker script exists before spawning to prevent uncaught
+    // MODULE_NOT_FOUND crashes in worker threads (e.g. when running from src/ via vitest)
+    const workerPath = fileURLToPath(workerUrl);
+    if (!fs.existsSync(workerPath)) {
+        throw new Error(`Worker script not found: ${workerPath}`);
+    }
     const size = poolSize ?? Math.min(8, Math.max(1, os.cpus().length - 1));
     const workers = [];
     for (let i = 0; i < size; i++) {

package/dist/core/{kuzu → lbug}/csv-generator.d.ts

@@ -1,5 +1,5 @@
 /**
- * CSV Generator for KuzuDB Hybrid Schema
+ * CSV Generator for LadybugDB Hybrid Schema
  *
  * Streams CSV rows directly to disk files in a single pass over graph nodes.
  * File contents are lazy-read from disk per-node to avoid holding the entire

package/dist/core/{kuzu → lbug}/csv-generator.js

@@ -1,5 +1,5 @@
 /**
- * CSV Generator for KuzuDB Hybrid Schema
+ * CSV Generator for LadybugDB Hybrid Schema
  *
  * Streams CSV rows directly to disk files in a single pass over graph nodes.
  * File contents are lazy-read from disk per-node to avoid holding the entire
@@ -203,7 +203,8 @@ export const streamAllCSVsToDisk = async (graph, repoPath, csvDir) => {
     const functionWriter = new BufferedCSVWriter(path.join(csvDir, 'function.csv'), codeElementHeader);
     const classWriter = new BufferedCSVWriter(path.join(csvDir, 'class.csv'), codeElementHeader);
     const interfaceWriter = new BufferedCSVWriter(path.join(csvDir, 'interface.csv'), codeElementHeader);
-    const methodWriter = new BufferedCSVWriter(path.join(csvDir, 'method.csv'), codeElementHeader);
+    const methodHeader = 'id,name,filePath,startLine,endLine,isExported,content,description,parameterCount,returnType';
+    const methodWriter = new BufferedCSVWriter(path.join(csvDir, 'method.csv'), methodHeader);
     const codeElemWriter = new BufferedCSVWriter(path.join(csvDir, 'codeelement.csv'), codeElementHeader);
     const communityWriter = new BufferedCSVWriter(path.join(csvDir, 'community.csv'), 'id,label,heuristicLabel,keywords,description,enrichedBy,cohesion,symbolCount');
     const processWriter = new BufferedCSVWriter(path.join(csvDir, 'process.csv'), 'id,label,heuristicLabel,processType,stepCount,communities,entryPointId,terminalId');
@@ -219,7 +220,6 @@ export const streamAllCSVsToDisk = async (graph, repoPath, csvDir) => {
         'Function': functionWriter,
         'Class': classWriter,
         'Interface': interfaceWriter,
-        'Method': methodWriter,
         'CodeElement': codeElemWriter,
     };
     const seenFileIds = new Set();
@@ -276,8 +276,24 @@ export const streamAllCSVsToDisk = async (graph, repoPath, csvDir) => {
                 ].join(','));
                 break;
             }
+            case 'Method': {
+                const content = await extractContent(node, contentCache);
+                await methodWriter.addRow([
+                    escapeCSVField(node.id),
+                    escapeCSVField(node.properties.name || ''),
+                    escapeCSVField(node.properties.filePath || ''),
+                    escapeCSVNumber(node.properties.startLine, -1),
+                    escapeCSVNumber(node.properties.endLine, -1),
+                    node.properties.isExported ? 'true' : 'false',
+                    escapeCSVField(content),
+                    escapeCSVField(node.properties.description || ''),
+                    escapeCSVNumber(node.properties.parameterCount, 0),
+                    escapeCSVField(node.properties.returnType || ''),
+                ].join(','));
+                break;
+            }
             default: {
-                // Code element nodes (Function, Class, Interface, Method, CodeElement)
+                // Code element nodes (Function, Class, Interface, CodeElement)
                 const writer = codeWriterMap[node.label];
                 if (writer) {
                     const content = await extractContent(node, contentCache);

package/dist/core/{kuzu/kuzu-adapter.d.ts → lbug/lbug-adapter.d.ts}

@@ -1,35 +1,35 @@
-import kuzu from 'kuzu';
+import lbug from '@ladybugdb/core';
 import { KnowledgeGraph } from '../graph/types.js';
-export declare const initKuzu: (dbPath: string) => Promise<{
-    db: kuzu.Database;
-    conn: kuzu.Connection;
+export declare const initLbug: (dbPath: string) => Promise<{
+    db: lbug.Database;
+    conn: lbug.Connection;
 }>;
 /**
  * Execute multiple queries against one repo DB atomically.
  * While the callback runs, no other request can switch the active DB.
  */
-export declare const withKuzuDb: <T>(dbPath: string, operation: () => Promise<T>) => Promise<T>;
-export type KuzuProgressCallback = (message: string) => void;
-export declare const loadGraphToKuzu: (graph: KnowledgeGraph, repoPath: string, storagePath: string, onProgress?: KuzuProgressCallback) => Promise<{
+export declare const withLbugDb: <T>(dbPath: string, operation: () => Promise<T>) => Promise<T>;
+export type LbugProgressCallback = (message: string) => void;
+export declare const loadGraphToLbug: (graph: KnowledgeGraph, repoPath: string, storagePath: string, onProgress?: LbugProgressCallback) => Promise<{
     success: boolean;
     insertedRels: number;
     skippedRels: number;
     warnings: string[];
 }>;
 /**
- * Insert a single node to KuzuDB
+ * Insert a single node to LadybugDB
  * @param label - Node type (File, Function, Class, etc.)
  * @param properties - Node properties
- * @param dbPath - Path to KuzuDB database (optional if already initialized)
+ * @param dbPath - Path to LadybugDB database (optional if already initialized)
  */
-export declare const insertNodeToKuzu: (label: string, properties: Record<string, any>, dbPath?: string) => Promise<boolean>;
+export declare const insertNodeToLbug: (label: string, properties: Record<string, any>, dbPath?: string) => Promise<boolean>;
 /**
- * Batch insert multiple nodes to KuzuDB using a single connection
+ * Batch insert multiple nodes to LadybugDB using a single connection
  * @param nodes - Array of {label, properties} to insert
- * @param dbPath - Path to KuzuDB database
+ * @param dbPath - Path to LadybugDB database
  * @returns Object with success count and error count
  */
-export declare const batchInsertNodesToKuzu: (nodes: Array<{
+export declare const batchInsertNodesToLbug: (nodes: Array<{
     label: string;
     properties: Record<string, any>;
 }>, dbPath: string) => Promise<{
@@ -38,12 +38,12 @@ export declare const batchInsertNodesToKuzu: (nodes: Array<{
 }>;
 export declare const executeQuery: (cypher: string) => Promise<any[]>;
 export declare const executeWithReusedStatement: (cypher: string, paramsList: Array<Record<string, any>>) => Promise<void>;
-export declare const getKuzuStats: () => Promise<{
+export declare const getLbugStats: () => Promise<{
     nodes: number;
     edges: number;
 }>;
 /**
- * Load cached embeddings from KuzuDB before a rebuild.
+ * Load cached embeddings from LadybugDB before a rebuild.
  * Returns all embedding vectors so they can be re-inserted after the graph is reloaded,
  * avoiding expensive re-embedding of unchanged nodes.
  */
@@ -54,12 +54,12 @@ export declare const loadCachedEmbeddings: () => Promise<{
         embedding: number[];
     }>;
 }>;
-export declare const closeKuzu: () => Promise<void>;
-export declare const isKuzuReady: () => boolean;
+export declare const closeLbug: () => Promise<void>;
+export declare const isLbugReady: () => boolean;
 /**
- * Delete all nodes (and their relationships) for a specific file from KuzuDB
+ * Delete all nodes (and their relationships) for a specific file from LadybugDB
  * @param filePath - The file path to delete nodes for
- * @param dbPath - Optional path to KuzuDB for per-query connection
+ * @param dbPath - Optional path to LadybugDB for per-query connection
  * @returns Object with counts of deleted nodes
  */
 export declare const deleteNodesForFile: (filePath: string, dbPath?: string) => Promise<{

package/dist/core/{kuzu/kuzu-adapter.js → lbug/lbug-adapter.js}

@@ -2,14 +2,14 @@ import fs from 'fs/promises';
 import { createReadStream } from 'fs';
 import { createInterface } from 'readline';
 import path from 'path';
-import kuzu from 'kuzu';
+import lbug from '@ladybugdb/core';
 import { NODE_TABLES, REL_TABLE_NAME, SCHEMA_QUERIES, EMBEDDING_TABLE_NAME, } from './schema.js';
 import { streamAllCSVsToDisk } from './csv-generator.js';
 let db = null;
 let conn = null;
 let currentDbPath = null;
 let ftsLoaded = false;
-// Global session lock for operations that touch module-level kuzu globals.
+// Global session lock for operations that touch module-level lbug globals.
 // This guarantees no DB switch can happen while an operation is running.
 let sessionLock = Promise.resolve();
 const runWithSessionLock = async (operation) => {
@@ -27,27 +27,27 @@ const runWithSessionLock = async (operation) => {
     }
 };
 const normalizeCopyPath = (filePath) => filePath.replace(/\\/g, '/');
-export const initKuzu = async (dbPath) => {
-    return runWithSessionLock(() => ensureKuzuInitialized(dbPath));
+export const initLbug = async (dbPath) => {
+    return runWithSessionLock(() => ensureLbugInitialized(dbPath));
 };
 /**
  * Execute multiple queries against one repo DB atomically.
  * While the callback runs, no other request can switch the active DB.
  */
-export const withKuzuDb = async (dbPath, operation) => {
+export const withLbugDb = async (dbPath, operation) => {
     return runWithSessionLock(async () => {
-        await ensureKuzuInitialized(dbPath);
+        await ensureLbugInitialized(dbPath);
         return operation();
     });
 };
-const ensureKuzuInitialized = async (dbPath) => {
+const ensureLbugInitialized = async (dbPath) => {
     if (conn && currentDbPath === dbPath) {
         return { db, conn };
     }
-    await doInitKuzu(dbPath);
+    await doInitLbug(dbPath);
     return { db, conn };
 };
-const doInitKuzu = async (dbPath) => {
+const doInitLbug = async (dbPath) => {
     // Different database requested — close the old one first
     if (conn || db) {
         try {
@@ -65,32 +65,36 @@ const doInitKuzu = async (dbPath) => {
         currentDbPath = null;
         ftsLoaded = false;
     }
-    // kuzu v0.11 stores the database as a single file (not a directory).
-    // If the path already exists, it must be a valid kuzu database file.
+    // LadybugDB stores the database as a single file (not a directory).
+    // If the path already exists, it must be a valid LadybugDB database file.
     // Remove stale empty directories or files from older versions.
     try {
-        const stat = await fs.stat(dbPath);
-        if (stat.isDirectory()) {
-            // Old-style directory database or empty leftover - remove it
-            const files = await fs.readdir(dbPath);
-            if (files.length === 0) {
-                await fs.rmdir(dbPath);
-            }
-            else {
-                // Non-empty directory from older kuzu version - remove entire directory
-                await fs.rm(dbPath, { recursive: true, force: true });
+        const stat = await fs.lstat(dbPath);
+        if (stat.isSymbolicLink()) {
+            // Never follow symlinks — just remove the link itself
+            await fs.unlink(dbPath);
+        }
+        else if (stat.isDirectory()) {
+            // Verify path is within expected storage directory before deleting
+            const realPath = await fs.realpath(dbPath);
+            const parentDir = path.dirname(dbPath);
+            const realParent = await fs.realpath(parentDir);
+            if (!realPath.startsWith(realParent + path.sep) && realPath !== realParent) {
+                throw new Error(`Refusing to delete ${dbPath}: resolved path ${realPath} is outside storage directory`);
             }
+            // Old-style directory database or empty leftover - remove it
+            await fs.rm(dbPath, { recursive: true, force: true });
         }
-        // If it's a file, assume it's an existing kuzu database - kuzu will open it
+        // If it's a file, assume it's an existing LadybugDB database - LadybugDB will open it
     }
     catch {
-        // Path doesn't exist, which is what kuzu wants for a new database
+        // Path doesn't exist, which is what LadybugDB wants for a new database
     }
     // Ensure parent directory exists
     const parentDir = path.dirname(dbPath);
     await fs.mkdir(parentDir, { recursive: true });
-    db = new kuzu.Database(dbPath);
-    conn = new kuzu.Connection(db);
+    db = new lbug.Database(dbPath);
+    conn = new lbug.Connection(db);
     for (const schemaQuery of SCHEMA_QUERIES) {
         try {
             await conn.query(schemaQuery);
@@ -104,17 +108,11 @@ const doInitKuzu = async (dbPath) => {
         }
     }
     currentDbPath = dbPath;
-    // Pre-load FTS extension so QUERY_FTS_INDEX works immediately
-    // (without this, queryFTS and raw cypher queries using FTS would fail)
-    try {
-        await loadFTSExtension();
-    }
-    catch { /* non-fatal */ }
     return { db, conn };
 };
-export const loadGraphToKuzu = async (graph, repoPath, storagePath, onProgress) => {
+export const loadGraphToLbug = async (graph, repoPath, storagePath, onProgress) => {
     if (!conn) {
-        throw new Error('KuzuDB not initialized. Call initKuzu first.');
+        throw new Error('LadybugDB not initialized. Call initLbug first.');
     }
     const log = onProgress || (() => { });
     const csvDir = path.join(storagePath, 'csv');
@@ -128,7 +126,7 @@ export const loadGraphToKuzu = async (graph, repoPath, storagePath, onProgress)
             return 'Process';
         return nodeId.split(':')[0];
     };
-    // Bulk COPY all node CSVs (sequential — KuzuDB allows only one write txn at a time)
+    // Bulk COPY all node CSVs (sequential — LadybugDB allows only one write txn at a time)
     const nodeFiles = [...csvResult.nodeFiles.entries()];
     const totalSteps = nodeFiles.length + 1; // +1 for relationships
     let stepsDone = 0;
@@ -151,7 +149,7 @@ export const loadGraphToKuzu = async (graph, repoPath, storagePath, onProgress)
             }
         }
     }
-    // Bulk COPY relationships — split by FROM→TO label pair (KuzuDB requires it)
+    // Bulk COPY relationships — split by FROM→TO label pair (LadybugDB requires it)
     // Stream-read the relation CSV line by line to avoid exceeding V8 max string length
     let relHeader = '';
     const relsByPair = new Map();
@@ -260,10 +258,10 @@ export const loadGraphToKuzu = async (graph, repoPath, storagePath, onProgress)
     catch { }
     return { success: true, insertedRels, skippedRels, warnings };
 };
-// KuzuDB default ESCAPE is '\' (backslash), but our CSV uses RFC 4180 escaping ("" for literal quotes).
+// LadybugDB default ESCAPE is '\' (backslash), but our CSV uses RFC 4180 escaping ("" for literal quotes).
 // Source code content is full of backslashes which confuse the auto-detection.
 // We MUST explicitly set ESCAPE='"' to use RFC 4180 escaping, and disable auto_detect to prevent
-// KuzuDB from overriding our settings based on sample rows.
+// LadybugDB from overriding our settings based on sample rows.
 const COPY_CSV_OPTS = `(HEADER=true, ESCAPE='"', DELIM=',', QUOTE='"', PARALLEL=false, auto_detect=false)`;
 // Multi-language table names that were created with backticks in CODE_ELEMENT_BASE
 // and must always be referenced with backticks in queries
@@ -295,10 +293,11 @@ const fallbackRelationshipInserts = async (validRelLines, validTables, getNodeLa
                 continue;
             const confidence = parseFloat(confidenceStr) || 1.0;
             const step = parseInt(stepStr) || 0;
-            await conn.query(`
-        MATCH (a:${escapeLabel(fromLabel)} {id: '${fromId.replace(/'/g, "''")}' }),
-              (b:${escapeLabel(toLabel)} {id: '${toId.replace(/'/g, "''")}' })
-        CREATE (a)-[:${REL_TABLE_NAME} {type: '${relType}', confidence: ${confidence}, reason: '${reason.replace(/'/g, "''")}', step: ${step}}]->(b)
+            const esc = (s) => s.replace(/'/g, "''").replace(/\\/g, '\\\\').replace(/\n/g, '\\n').replace(/\r/g, '\\r');
+            await conn.query(`
+        MATCH (a:${escapeLabel(fromLabel)} {id: '${esc(fromId)}' }),
+              (b:${escapeLabel(toLabel)} {id: '${esc(toId)}' })
+        CREATE (a)-[:${REL_TABLE_NAME} {type: '${esc(relType)}', confidence: ${confidence}, reason: '${esc(reason)}', step: ${step}}]->(b)
       `);
         }
         catch {
@@ -322,6 +321,9 @@ const getCopyQuery = (table, filePath) => {
     if (table === 'Process') {
         return `COPY ${t}(id, label, heuristicLabel, processType, stepCount, communities, entryPointId, terminalId) FROM "${filePath}" ${COPY_CSV_OPTS}`;
     }
+    if (table === 'Method') {
+        return `COPY ${t}(id, name, filePath, startLine, endLine, isExported, content, description, parameterCount, returnType) 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, description) FROM "${filePath}" ${COPY_CSV_OPTS}`;
@@ -330,16 +332,16 @@ const getCopyQuery = (table, filePath) => {
     return `COPY ${t}(id, name, filePath, startLine, endLine, content, description) FROM "${filePath}" ${COPY_CSV_OPTS}`;
 };
 /**
- * Insert a single node to KuzuDB
+ * Insert a single node to LadybugDB
  * @param label - Node type (File, Function, Class, etc.)
  * @param properties - Node properties
- * @param dbPath - Path to KuzuDB database (optional if already initialized)
+ * @param dbPath - Path to LadybugDB database (optional if already initialized)
  */
-export const insertNodeToKuzu = async (label, properties, dbPath) => {
+export const insertNodeToLbug = async (label, properties, dbPath) => {
     // Use provided dbPath or fall back to module-level db
     const targetDbPath = dbPath || (db ? undefined : null);
     if (!targetDbPath && !db) {
-        throw new Error('KuzuDB not initialized. Provide dbPath or call initKuzu first.');
+        throw new Error('LadybugDB not initialized. Provide dbPath or call initLbug first.');
     }
     try {
         const escapeValue = (v) => {
@@ -348,7 +350,7 @@ export const insertNodeToKuzu = async (label, properties, dbPath) => {
             if (typeof v === 'number')
                 return String(v);
             // Escape backslashes first (for Windows paths), then single quotes
-            return `'${String(v).replace(/\\/g, '\\\\').replace(/'/g, "''")}'`;
+            return `'${String(v).replace(/\\/g, '\\\\').replace(/'/g, "''").replace(/\n/g, '\\n').replace(/\r/g, '\\r')}'`;
         };
         // Build INSERT query based on node type
         const t = escapeTableName(label);
@@ -370,8 +372,8 @@ export const insertNodeToKuzu = async (label, properties, dbPath) => {
         }
         // Use per-query connection if dbPath provided (avoids lock conflicts)
         if (targetDbPath) {
-            const tempDb = new kuzu.Database(targetDbPath);
-            const tempConn = new kuzu.Connection(tempDb);
+            const tempDb = new lbug.Database(targetDbPath);
+            const tempConn = new lbug.Connection(tempDb);
             try {
                 await tempConn.query(query);
                 return true;
@@ -401,12 +403,12 @@ export const insertNodeToKuzu = async (label, properties, dbPath) => {
     }
 };
 /**
- * Batch insert multiple nodes to KuzuDB using a single connection
+ * Batch insert multiple nodes to LadybugDB using a single connection
  * @param nodes - Array of {label, properties} to insert
- * @param dbPath - Path to KuzuDB database
+ * @param dbPath - Path to LadybugDB database
  * @returns Object with success count and error count
  */
-export const batchInsertNodesToKuzu = async (nodes, dbPath) => {
+export const batchInsertNodesToLbug = async (nodes, dbPath) => {
     if (nodes.length === 0)
         return { inserted: 0, failed: 0 };
     const escapeValue = (v) => {
@@ -414,12 +416,12 @@ export const batchInsertNodesToKuzu = async (nodes, dbPath) => {
             return 'NULL';
         if (typeof v === 'number')
             return String(v);
-        // Escape backslashes first (for Windows paths), then single quotes
-        return `'${String(v).replace(/\\/g, '\\\\').replace(/'/g, "''")}'`;
+        // Escape backslashes first (for Windows paths), then single quotes, then newlines
+        return `'${String(v).replace(/\\/g, '\\\\').replace(/'/g, "''").replace(/\n/g, '\\n').replace(/\r/g, '\\r')}'`;
     };
     // Open a single connection for all inserts
-    const tempDb = new kuzu.Database(dbPath);
-    const tempConn = new kuzu.Connection(tempDb);
+    const tempDb = new lbug.Database(dbPath);
+    const tempConn = new lbug.Connection(tempDb);
     let inserted = 0;
     let failed = 0;
     try {
@@ -465,10 +467,10 @@ export const batchInsertNodesToKuzu = async (nodes, dbPath) => {
 };
 export const executeQuery = async (cypher) => {
     if (!conn) {
-        throw new Error('KuzuDB not initialized. Call initKuzu first.');
+        throw new Error('LadybugDB not initialized. Call initLbug first.');
     }
     const queryResult = await conn.query(cypher);
-    // kuzu v0.11 uses getAll() instead of hasNext()/getNext()
+    // LadybugDB uses getAll() instead of hasNext()/getNext()
     // Query returns QueryResult for single queries, QueryResult[] for multi-statement
     const result = Array.isArray(queryResult) ? queryResult[0] : queryResult;
     const rows = await result.getAll();
@@ -476,7 +478,7 @@ export const executeQuery = async (cypher) => {
 };
 export const executeWithReusedStatement = async (cypher, paramsList) => {
     if (!conn) {
-        throw new Error('KuzuDB not initialized. Call initKuzu first.');
+        throw new Error('LadybugDB not initialized. Call initLbug first.');
     }
     if (paramsList.length === 0)
         return;
@@ -497,10 +499,10 @@ export const executeWithReusedStatement = async (cypher, paramsList) => {
             // Log the error and continue with next batch
             console.warn('Batch execution error:', e);
         }
-        // Note: kuzu 0.8.2 PreparedStatement doesn't require explicit close()
+        // Note: LadybugDB PreparedStatement doesn't require explicit close()
     }
 };
-export const getKuzuStats = async () => {
+export const getLbugStats = async () => {
     if (!conn)
         return { nodes: 0, edges: 0 };
     let totalNodes = 0;
@@ -532,7 +534,7 @@ export const getKuzuStats = async () => {
     return { nodes: totalNodes, edges: totalEdges };
 };
 /**
- * Load cached embeddings from KuzuDB before a rebuild.
+ * Load cached embeddings from LadybugDB before a rebuild.
  * Returns all embedding vectors so they can be re-inserted after the graph is reloaded,
  * avoiding expensive re-embedding of unchanged nodes.
  */
@@ -562,7 +564,7 @@ export const loadCachedEmbeddings = async () => {
     catch { /* embedding table may not exist */ }
     return { embeddingNodeIds, embeddings };
 };
-export const closeKuzu = async () => {
+export const closeLbug = async () => {
     if (conn) {
         try {
             await conn.close();
@@ -580,11 +582,11 @@ export const closeKuzu = async () => {
     currentDbPath = null;
     ftsLoaded = false;
 };
-export const isKuzuReady = () => conn !== null && db !== null;
+export const isLbugReady = () => conn !== null && db !== null;
 /**
- * Delete all nodes (and their relationships) for a specific file from KuzuDB
+ * Delete all nodes (and their relationships) for a specific file from LadybugDB
  * @param filePath - The file path to delete nodes for
- * @param dbPath - Optional path to KuzuDB for per-query connection
+ * @param dbPath - Optional path to LadybugDB for per-query connection
  * @returns Object with counts of deleted nodes
  */
 export const deleteNodesForFile = async (filePath, dbPath) => {
@@ -594,12 +596,12 @@ export const deleteNodesForFile = async (filePath, dbPath) => {
     let tempConn = null;
     let targetConn = conn;
     if (usePerQuery) {
-        tempDb = new kuzu.Database(dbPath);
-        tempConn = new kuzu.Connection(tempDb);
+        tempDb = new lbug.Database(dbPath);
+        tempConn = new lbug.Connection(tempDb);
         targetConn = tempConn;
     }
     else if (!conn) {
-        throw new Error('KuzuDB not initialized. Provide dbPath or call initKuzu first.');
+        throw new Error('LadybugDB not initialized. Provide dbPath or call initLbug first.');
     }
     try {
         let deletedNodes = 0;
@@ -664,7 +666,7 @@ export const loadFTSExtension = async () => {
     if (ftsLoaded)
         return;
     if (!conn) {
-        throw new Error('KuzuDB not initialized. Call initKuzu first.');
+        throw new Error('LadybugDB not initialized. Call initLbug first.');
     }
     try {
         await conn.query('INSTALL fts');
@@ -690,7 +692,7 @@ export const loadFTSExtension = async () => {
  */
 export const createFTSIndex = async (tableName, indexName, properties, stemmer = 'porter') => {
     if (!conn) {
-        throw new Error('KuzuDB not initialized. Call initKuzu first.');
+        throw new Error('LadybugDB not initialized. Call initLbug first.');
     }
     await loadFTSExtension();
     const propList = properties.map(p => `'${p}'`).join(', ');
@@ -715,17 +717,15 @@ export const createFTSIndex = async (tableName, indexName, properties, stemmer =
  */
 export const queryFTS = async (tableName, indexName, query, limit = 20, conjunctive = false) => {
     if (!conn) {
-        throw new Error('KuzuDB not initialized. Call initKuzu first.');
-    }
-    // Ensure FTS extension is loaded (safe to call multiple times)
-    await loadFTSExtension();
-    // Escape single quotes in query
-    const escapedQuery = query.replace(/'/g, "''");
-    const cypher = `
-    CALL QUERY_FTS_INDEX('${tableName}', '${indexName}', '${escapedQuery}', conjunctive := ${conjunctive})
-    RETURN node, score
-    ORDER BY score DESC
-    LIMIT ${limit}
+        throw new Error('LadybugDB not initialized. Call initLbug first.');
+    }
+    // Escape backslashes and single quotes to prevent Cypher injection
+    const escapedQuery = query.replace(/\\/g, '\\\\').replace(/'/g, "''");
+    const cypher = `
+    CALL QUERY_FTS_INDEX('${tableName}', '${indexName}', '${escapedQuery}', conjunctive := ${conjunctive})
+    RETURN node, score
+    ORDER BY score DESC
+    LIMIT ${limit}
   `;
     try {
         const queryResult = await conn.query(cypher);
@@ -756,7 +756,7 @@ export const queryFTS = async (tableName, indexName, query, limit = 20, conjunct
  */
 export const dropFTSIndex = async (tableName, indexName) => {
     if (!conn) {
-        throw new Error('KuzuDB not initialized. Call initKuzu first.');
+        throw new Error('LadybugDB not initialized. Call initLbug first.');
     }
     try {
         await conn.query(`CALL DROP_FTS_INDEX('${tableName}', '${indexName}')`);

package/dist/core/{kuzu → lbug}/schema.d.ts

@@ -1,5 +1,5 @@
 /**
- * KuzuDB Schema Definitions
+ * LadybugDB Schema Definitions
  *
  * Hybrid Schema:
  * - Separate node tables for each code element type (File, Function, Class, etc.)
@@ -11,7 +11,7 @@
 export declare const NODE_TABLES: readonly ["File", "Folder", "Function", "Class", "Interface", "Method", "CodeElement", "Community", "Process", "Struct", "Enum", "Macro", "Typedef", "Union", "Namespace", "Trait", "Impl", "TypeAlias", "Const", "Static", "Property", "Record", "Delegate", "Annotation", "Constructor", "Template", "Module"];
 export type NodeTableName = typeof NODE_TABLES[number];
 export declare const REL_TABLE_NAME = "CodeRelation";
-export declare const REL_TYPES: readonly ["CONTAINS", "DEFINES", "IMPORTS", "CALLS", "EXTENDS", "IMPLEMENTS", "MEMBER_OF", "STEP_IN_PROCESS"];
+export declare const REL_TYPES: readonly ["CONTAINS", "DEFINES", "IMPORTS", "CALLS", "EXTENDS", "IMPLEMENTS", "HAS_METHOD", "OVERRIDES", "MEMBER_OF", "STEP_IN_PROCESS"];
 export type RelType = typeof REL_TYPES[number];
 export declare const EMBEDDING_TABLE_NAME = "CodeEmbedding";
 export declare const FILE_SCHEMA = "\nCREATE NODE TABLE File (\n  id STRING,\n  name STRING,\n  filePath STRING,\n  content STRING,\n  PRIMARY KEY (id)\n)";
@@ -19,7 +19,7 @@ export declare const FOLDER_SCHEMA = "\nCREATE NODE TABLE Folder (\n  id STRING,
 export declare const FUNCTION_SCHEMA = "\nCREATE NODE TABLE Function (\n  id STRING,\n  name STRING,\n  filePath STRING,\n  startLine INT64,\n  endLine INT64,\n  isExported BOOLEAN,\n  content STRING,\n  description STRING,\n  PRIMARY KEY (id)\n)";
 export declare const CLASS_SCHEMA = "\nCREATE NODE TABLE Class (\n  id STRING,\n  name STRING,\n  filePath STRING,\n  startLine INT64,\n  endLine INT64,\n  isExported BOOLEAN,\n  content STRING,\n  description STRING,\n  PRIMARY KEY (id)\n)";
 export declare const INTERFACE_SCHEMA = "\nCREATE NODE TABLE Interface (\n  id STRING,\n  name STRING,\n  filePath STRING,\n  startLine INT64,\n  endLine INT64,\n  isExported BOOLEAN,\n  content STRING,\n  description STRING,\n  PRIMARY KEY (id)\n)";
-export declare const METHOD_SCHEMA = "\nCREATE NODE TABLE Method (\n  id STRING,\n  name STRING,\n  filePath STRING,\n  startLine INT64,\n  endLine INT64,\n  isExported BOOLEAN,\n  content STRING,\n  description STRING,\n  PRIMARY KEY (id)\n)";
+export declare const METHOD_SCHEMA = "\nCREATE NODE TABLE Method (\n  id STRING,\n  name STRING,\n  filePath STRING,\n  startLine INT64,\n  endLine INT64,\n  isExported BOOLEAN,\n  content STRING,\n  description STRING,\n  parameterCount INT32,\n  returnType STRING,\n  PRIMARY KEY (id)\n)";
 export declare const CODE_ELEMENT_SCHEMA = "\nCREATE NODE TABLE CodeElement (\n  id STRING,\n  name STRING,\n  filePath STRING,\n  startLine INT64,\n  endLine INT64,\n  isExported BOOLEAN,\n  content STRING,\n  description STRING,\n  PRIMARY KEY (id)\n)";
 export declare const COMMUNITY_SCHEMA = "\nCREATE NODE TABLE Community (\n  id STRING,\n  label STRING,\n  heuristicLabel STRING,\n  keywords STRING[],\n  description STRING,\n  enrichedBy STRING,\n  cohesion DOUBLE,\n  symbolCount INT32,\n  PRIMARY KEY (id)\n)";
 export declare const PROCESS_SCHEMA = "\nCREATE NODE TABLE Process (\n  id STRING,\n  label STRING,\n  heuristicLabel STRING,\n  processType STRING,\n  stepCount INT32,\n  communities STRING[],\n  entryPointId STRING,\n  terminalId STRING,\n  PRIMARY KEY (id)\n)";
@@ -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 Function TO `Const`,\n  FROM Function TO `Typedef`,\n  FROM Function TO `Union`,\n  FROM Function TO `Property`,\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 Class TO `Namespace`,\n  FROM Class TO `Typedef`,\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 Method TO `Property`,\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 `Struct`,\n  FROM `Struct` TO Class,\n  FROM `Struct` TO `Enum`,\n  FROM `Struct` TO Function,\n  FROM `Struct` TO Method,\n  FROM `Struct` TO Interface,\n  FROM `Enum` TO `Enum`,\n  FROM `Enum` TO Community,\n  FROM `Enum` TO Class,\n  FROM `Enum` TO Interface,\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 `Namespace` TO `Struct`,\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 `TypeAlias` TO Class,\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 `Constructor` TO `Property`,\n  FROM `Constructor` TO `Typedef`,\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 Function TO `Property`,\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 Class TO `Namespace`,\n  FROM Class TO `Typedef`,\n  FROM Class TO `Property`,\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 Method TO `Property`,\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 Interface TO `Property`,\n  FROM `Struct` TO Community,\n  FROM `Struct` TO `Trait`,\n  FROM `Struct` TO `Struct`,\n  FROM `Struct` TO Class,\n  FROM `Struct` TO `Enum`,\n  FROM `Struct` TO Function,\n  FROM `Struct` TO Method,\n  FROM `Struct` TO Interface,\n  FROM `Struct` TO `Constructor`,\n  FROM `Struct` TO `Property`,\n  FROM `Enum` TO `Enum`,\n  FROM `Enum` TO Community,\n  FROM `Enum` TO Class,\n  FROM `Enum` TO Interface,\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 `Namespace` TO `Struct`,\n  FROM `Trait` TO Method,\n  FROM `Trait` TO `Constructor`,\n  FROM `Trait` TO `Property`,\n  FROM `Trait` TO Community,\n  FROM `Impl` TO Method,\n  FROM `Impl` TO `Constructor`,\n  FROM `Impl` TO `Property`,\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 `TypeAlias` TO Class,\n  FROM `Const` TO Community,\n  FROM `Static` TO Community,\n  FROM `Property` TO Community,\n  FROM `Record` TO Method,\n  FROM `Record` TO `Constructor`,\n  FROM `Record` TO `Property`,\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 `Constructor` TO `Property`,\n  FROM `Constructor` TO `Typedef`,\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