gitnexus 1.3.2 → 1.3.4

package/dist/core/ingestion/utils.js

@@ -40,5 +40,11 @@ export const getLanguageFromFilename = (filename) => {
     // Rust
     if (filename.endsWith('.rs'))
         return SupportedLanguages.Rust;
+    // PHP (all common extensions)
+    if (filename.endsWith('.php') || filename.endsWith('.phtml') ||
+        filename.endsWith('.php3') || filename.endsWith('.php4') ||
+        filename.endsWith('.php5') || filename.endsWith('.php8')) {
+        return SupportedLanguages.PHP;
+    }
     return null;
 };

package/dist/core/ingestion/workers/parse-worker.d.ts

@@ -8,6 +8,9 @@ interface ParsedNode {
         endLine: number;
         language: string;
         isExported: boolean;
+        astFrameworkMultiplier?: number;
+        astFrameworkReason?: string;
+        description?: string;
     };
 }
 interface ParsedRelationship {

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

@@ -9,9 +9,11 @@ import CPP from 'tree-sitter-cpp';
 import CSharp from 'tree-sitter-c-sharp';
 import Go from 'tree-sitter-go';
 import Rust from 'tree-sitter-rust';
+import PHP from 'tree-sitter-php';
 import { SupportedLanguages } from '../../../config/supported-languages.js';
 import { LANGUAGE_QUERIES } from '../tree-sitter-queries.js';
 import { getLanguageFromFilename } from '../utils.js';
+import { detectFrameworkFromAST } from '../framework-detection.js';
 import { generateId } from '../../../lib/utils.js';
 // ============================================================================
 // Worker-local parser + language map
@@ -28,6 +30,7 @@ const languageMap = {
     [SupportedLanguages.CSharp]: CSharp,
     [SupportedLanguages.Go]: Go,
     [SupportedLanguages.Rust]: Rust,
+    [SupportedLanguages.PHP]: PHP.php_only,
 };
 const setLanguage = (language, filePath) => {
     const key = language === SupportedLanguages.TypeScript && filePath.endsWith('.tsx')
@@ -106,6 +109,23 @@ const isNodeExported = (node, name, language) => {
         case 'c':
         case 'cpp':
             return false;
+        case 'php':
+            // Top-level classes/interfaces/traits are always accessible
+            // Methods/properties are exported only if they have 'public' modifier
+            while (current) {
+                if (current.type === 'class_declaration' ||
+                    current.type === 'interface_declaration' ||
+                    current.type === 'trait_declaration' ||
+                    current.type === 'enum_declaration') {
+                    return true;
+                }
+                if (current.type === 'visibility_modifier') {
+                    return current.text === 'public';
+                }
+                current = current.parent;
+            }
+            // Top-level functions (no parent class) are globally accessible
+            return true;
         default:
             return false;
     }
@@ -119,6 +139,7 @@ const FUNCTION_NODE_TYPES = new Set([
     'function_definition', 'async_function_declaration', 'async_arrow_function',
     'method_declaration', 'constructor_declaration',
     'local_function_statement', 'function_item', 'impl_item',
+    'anonymous_function_creation_expression', // PHP anonymous functions
 ]);
 /** Walk up AST to find enclosing function, return its generateId or null for top-level */
 const findEnclosingFunctionId = (node, filePath) => {
@@ -216,6 +237,23 @@ const BUILT_INS = new Set([
     'mutex_lock', 'mutex_unlock', 'mutex_init',
     'kfree', 'kmalloc', 'kzalloc', 'kcalloc', 'krealloc', 'kvmalloc', 'kvfree',
     'get', 'put',
+    // PHP built-ins
+    'echo', 'isset', 'empty', 'unset', 'list', 'array', 'compact', 'extract',
+    'count', 'strlen', 'strpos', 'strrpos', 'substr', 'strtolower', 'strtoupper', 'trim',
+    'ltrim', 'rtrim', 'str_replace', 'str_contains', 'str_starts_with', 'str_ends_with',
+    'sprintf', 'vsprintf', 'printf', 'number_format',
+    'array_map', 'array_filter', 'array_reduce', 'array_push', 'array_pop', 'array_shift',
+    'array_unshift', 'array_slice', 'array_splice', 'array_merge', 'array_keys', 'array_values',
+    'array_key_exists', 'in_array', 'array_search', 'array_unique', 'usort', 'rsort',
+    'json_encode', 'json_decode', 'serialize', 'unserialize',
+    'intval', 'floatval', 'strval', 'boolval', 'is_null', 'is_string', 'is_int', 'is_array',
+    'is_object', 'is_numeric', 'is_bool', 'is_float',
+    'var_dump', 'print_r', 'var_export',
+    'date', 'time', 'strtotime', 'mktime', 'microtime',
+    'file_exists', 'file_get_contents', 'file_put_contents', 'is_file', 'is_dir',
+    'preg_match', 'preg_match_all', 'preg_replace', 'preg_split',
+    'header', 'session_start', 'session_destroy', 'ob_start', 'ob_end_clean', 'ob_get_clean',
+    'dd', 'dump',
 ]);
 // ============================================================================
 // Label detection from capture map
@@ -272,6 +310,37 @@ const getLabelFromCaptures = (captureMap) => {
         return 'Template';
     return 'CodeElement';
 };
+const getDefinitionNodeFromCaptures = (captureMap) => {
+    const definitionKeys = [
+        'definition.function',
+        'definition.class',
+        'definition.interface',
+        'definition.method',
+        'definition.struct',
+        'definition.enum',
+        'definition.namespace',
+        'definition.module',
+        'definition.trait',
+        'definition.impl',
+        'definition.type',
+        'definition.const',
+        'definition.static',
+        'definition.typedef',
+        'definition.macro',
+        'definition.union',
+        'definition.property',
+        'definition.record',
+        'definition.delegate',
+        'definition.annotation',
+        'definition.constructor',
+        'definition.template',
+    ];
+    for (const key of definitionKeys) {
+        if (captureMap[key])
+            return captureMap[key];
+    }
+    return null;
+};
 // ============================================================================
 // Process a batch of files
 // ============================================================================
@@ -341,6 +410,110 @@ const processBatch = (files, onProgress) => {
     }
     return result;
 };
+// ============================================================================
+// PHP Eloquent metadata extraction
+// ============================================================================
+/** Eloquent model properties whose array values are worth indexing */
+const ELOQUENT_ARRAY_PROPS = new Set(['fillable', 'casts', 'hidden', 'guarded', 'with', 'appends']);
+/** Eloquent relationship method names */
+const ELOQUENT_RELATIONS = new Set([
+    'hasMany', 'hasOne', 'belongsTo', 'belongsToMany',
+    'morphTo', 'morphMany', 'morphOne', 'morphToMany', 'morphedByMany',
+    'hasManyThrough', 'hasOneThrough',
+]);
+function findDescendant(node, type) {
+    if (node.type === type)
+        return node;
+    for (const child of (node.children ?? [])) {
+        const found = findDescendant(child, type);
+        if (found)
+            return found;
+    }
+    return null;
+}
+function extractStringContent(node) {
+    if (!node)
+        return null;
+    const content = node.children?.find((c) => c.type === 'string_content');
+    if (content)
+        return content.text;
+    if (node.type === 'string_content')
+        return node.text;
+    return null;
+}
+/**
+ * For a PHP property_declaration node, extract array values as a description string.
+ * Returns null if not an Eloquent model property or no array values found.
+ */
+function extractPhpPropertyDescription(propName, propDeclNode) {
+    if (!ELOQUENT_ARRAY_PROPS.has(propName))
+        return null;
+    const arrayNode = findDescendant(propDeclNode, 'array_creation_expression');
+    if (!arrayNode)
+        return null;
+    const items = [];
+    for (const child of (arrayNode.children ?? [])) {
+        if (child.type !== 'array_element_initializer')
+            continue;
+        const children = child.children ?? [];
+        const arrowIdx = children.findIndex((c) => c.type === '=>');
+        if (arrowIdx !== -1) {
+            // key => value pair (used in $casts)
+            const key = extractStringContent(children[arrowIdx - 1]);
+            const val = extractStringContent(children[arrowIdx + 1]);
+            if (key && val)
+                items.push(`${key}:${val}`);
+        }
+        else {
+            // Simple value (used in $fillable, $hidden, etc.)
+            const val = extractStringContent(children[0]);
+            if (val)
+                items.push(val);
+        }
+    }
+    return items.length > 0 ? items.join(', ') : null;
+}
+/**
+ * For a PHP method_declaration node, detect if it defines an Eloquent relationship.
+ * Returns description like "hasMany(Post)" or null.
+ */
+function extractEloquentRelationDescription(methodNode) {
+    function findRelationCall(node) {
+        if (node.type === 'member_call_expression') {
+            const children = node.children ?? [];
+            const objectNode = children.find((c) => c.type === 'variable_name' && c.text === '$this');
+            const nameNode = children.find((c) => c.type === 'name');
+            if (objectNode && nameNode && ELOQUENT_RELATIONS.has(nameNode.text))
+                return node;
+        }
+        for (const child of (node.children ?? [])) {
+            const found = findRelationCall(child);
+            if (found)
+                return found;
+        }
+        return null;
+    }
+    const callNode = findRelationCall(methodNode);
+    if (!callNode)
+        return null;
+    const relType = callNode.children?.find((c) => c.type === 'name')?.text;
+    const argsNode = callNode.children?.find((c) => c.type === 'arguments');
+    let targetModel = null;
+    if (argsNode) {
+        const firstArg = argsNode.children?.find((c) => c.type === 'argument');
+        if (firstArg) {
+            const classConstant = firstArg.children?.find((c) => c.type === 'class_constant_access_expression');
+            if (classConstant) {
+                targetModel = classConstant.children?.find((c) => c.type === 'name')?.text ?? null;
+            }
+        }
+    }
+    if (relType && targetModel)
+        return `${relType}(${targetModel})`;
+    if (relType)
+        return relType;
+    return null;
+}
 const processFileGroup = (files, language, queryString, result, onFileProcessed) => {
     let query;
     try {
@@ -352,7 +525,7 @@ const processFileGroup = (files, language, queryString, result, onFileProcessed)
     }
     for (const file of files) {
         // Skip very large files — they can crash tree-sitter or cause OOM
-        if (file.content.length > 2 * 1024 * 1024)
+        if (file.content.length > 512 * 1024)
             continue;
         let tree;
         try {
@@ -435,6 +608,19 @@ const processFileGroup = (files, language, queryString, result, onFileProcessed)
             const nameNode = captureMap['name'];
             const nodeName = nameNode.text;
             const nodeId = generateId(nodeLabel, `${file.path}:${nodeName}`);
+            let description;
+            if (language === SupportedLanguages.PHP) {
+                if (nodeLabel === 'Property' && captureMap['definition.property']) {
+                    description = extractPhpPropertyDescription(nodeName, captureMap['definition.property']) ?? undefined;
+                }
+                else if (nodeLabel === 'Method' && captureMap['definition.method']) {
+                    description = extractEloquentRelationDescription(captureMap['definition.method']) ?? undefined;
+                }
+            }
+            const definitionNode = getDefinitionNodeFromCaptures(captureMap);
+            const frameworkHint = definitionNode
+                ? detectFrameworkFromAST(language, definitionNode.text || '')
+                : null;
             result.nodes.push({
                 id: nodeId,
                 label: nodeLabel,
@@ -445,6 +631,11 @@ const processFileGroup = (files, language, queryString, result, onFileProcessed)
                     endLine: nameNode.endPosition.row,
                     language: language,
                     isExported: isNodeExported(nameNode, nodeName, language),
+                    ...(frameworkHint ? {
+                        astFrameworkMultiplier: frameworkHint.entryPointMultiplier,
+                        astFrameworkReason: frameworkHint.reason,
+                    } : {}),
+                    ...(description !== undefined ? { description } : {}),
                 },
             });
             result.symbols.push({

package/dist/core/kuzu/csv-generator.js

@@ -185,7 +185,7 @@ export const streamAllCSVsToDisk = async (graph, repoPath, csvDir) => {
     // Create writers for every node type up-front
     const fileWriter = new BufferedCSVWriter(path.join(csvDir, 'file.csv'), 'id,name,filePath,content');
     const folderWriter = new BufferedCSVWriter(path.join(csvDir, 'folder.csv'), 'id,name,filePath');
-    const codeElementHeader = 'id,name,filePath,startLine,endLine,isExported,content';
+    const codeElementHeader = 'id,name,filePath,startLine,endLine,isExported,content,description';
     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);
@@ -194,7 +194,7 @@ export const streamAllCSVsToDisk = async (graph, repoPath, csvDir) => {
     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');
     // Multi-language node types share the same CSV shape (no isExported column)
-    const multiLangHeader = 'id,name,filePath,startLine,endLine,content';
+    const multiLangHeader = 'id,name,filePath,startLine,endLine,content,description';
     const MULTI_LANG_TYPES = ['Struct', 'Enum', 'Macro', 'Typedef', 'Union', 'Namespace', 'Trait', 'Impl',
         'TypeAlias', 'Const', 'Static', 'Property', 'Record', 'Delegate', 'Annotation', 'Constructor', 'Template', 'Module'];
     const multiLangWriters = new Map();
@@ -275,6 +275,7 @@ export const streamAllCSVsToDisk = async (graph, repoPath, csvDir) => {
                         escapeCSVNumber(node.properties.endLine, -1),
                         node.properties.isExported ? 'true' : 'false',
                         escapeCSVField(content),
+                        escapeCSVField(node.properties.description || ''),
                     ].join(','));
                 }
                 else {
@@ -289,6 +290,7 @@ export const streamAllCSVsToDisk = async (graph, repoPath, csvDir) => {
                             escapeCSVNumber(node.properties.startLine, -1),
                             escapeCSVNumber(node.properties.endLine, -1),
                             escapeCSVField(content),
+                            escapeCSVField(node.properties.description || ''),
                         ].join(','));
                     }
                 }

package/dist/core/kuzu/kuzu-adapter.d.ts

@@ -4,6 +4,11 @@ export declare const initKuzu: (dbPath: string) => Promise<{
     db: kuzu.Database;
     conn: kuzu.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<{
     success: boolean;
@@ -61,6 +66,10 @@ export declare const deleteNodesForFile: (filePath: string, dbPath?: string) =>
     deletedNodes: number;
 }>;
 export declare const getEmbeddingTableName: () => string;
+/**
+ * Load the FTS extension (required before using FTS functions).
+ * Safe to call multiple times — tracks loaded state via module-level ftsLoaded.
+ */
 export declare const loadFTSExtension: () => Promise<void>;
 /**
  * Create a full-text search index on a table

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

@@ -7,10 +7,64 @@ import { NODE_TABLES, REL_TABLE_NAME, SCHEMA_QUERIES, EMBEDDING_TABLE_NAME, } fr
 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.
+// This guarantees no DB switch can happen while an operation is running.
+let sessionLock = Promise.resolve();
+const runWithSessionLock = async (operation) => {
+    const previous = sessionLock;
+    let release = null;
+    sessionLock = new Promise(resolve => {
+        release = resolve;
+    });
+    await previous;
+    try {
+        return await operation();
+    }
+    finally {
+        release?.();
+    }
+};
 const normalizeCopyPath = (filePath) => filePath.replace(/\\/g, '/');
 export const initKuzu = async (dbPath) => {
-    if (conn)
+    return runWithSessionLock(() => ensureKuzuInitialized(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) => {
+    return runWithSessionLock(async () => {
+        await ensureKuzuInitialized(dbPath);
+        return operation();
+    });
+};
+const ensureKuzuInitialized = async (dbPath) => {
+    if (conn && currentDbPath === dbPath) {
         return { db, conn };
+    }
+    await doInitKuzu(dbPath);
+    return { db, conn };
+};
+const doInitKuzu = async (dbPath) => {
+    // Different database requested — close the old one first
+    if (conn || db) {
+        try {
+            if (conn)
+                await conn.close();
+        }
+        catch { }
+        try {
+            if (db)
+                await db.close();
+        }
+        catch { }
+        conn = null;
+        db = null;
+        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.
     // Remove stale empty directories or files from older versions.
@@ -49,6 +103,7 @@ export const initKuzu = async (dbPath) => {
             }
         }
     }
+    currentDbPath = dbPath;
     return { db, conn };
 };
 export const loadGraphToKuzu = async (graph, repoPath, storagePath, onProgress) => {
@@ -263,10 +318,10 @@ const getCopyQuery = (table, filePath) => {
     }
     // 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}`;
+        return `COPY ${t}(id, name, filePath, startLine, endLine, isExported, content, description) 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}`;
+    return `COPY ${t}(id, name, filePath, startLine, endLine, content, description) FROM "${filePath}" ${COPY_CSV_OPTS}`;
 };
 /**
  * Insert a single node to KuzuDB
@@ -299,11 +354,13 @@ export const insertNodeToKuzu = async (label, properties, dbPath) => {
             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 || '')}})`;
+            const descPart = properties.description ? `, description: ${escapeValue(properties.description)}` : '';
+            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 || '')}${descPart}})`;
         }
         else {
             // 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 || '')}})`;
+            const descPart = properties.description ? `, description: ${escapeValue(properties.description)}` : '';
+            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 || '')}${descPart}})`;
         }
         // Use per-query connection if dbPath provided (avoids lock conflicts)
         if (targetDbPath) {
@@ -372,10 +429,12 @@ export const batchInsertNodesToKuzu = async (nodes, dbPath) => {
                     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 || '')}`;
+                    const descPart = properties.description ? `, n.description = ${escapeValue(properties.description)}` : '';
+                    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 || '')}${descPart}`;
                 }
                 else {
-                    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 || '')}`;
+                    const descPart = properties.description ? `, n.description = ${escapeValue(properties.description)}` : '';
+                    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 || '')}${descPart}`;
                 }
                 await tempConn.query(query);
                 inserted++;
@@ -512,6 +571,7 @@ export const closeKuzu = async () => {
         catch { }
         db = null;
     }
+    currentDbPath = null;
     ftsLoaded = false;
 };
 export const isKuzuReady = () => conn !== null && db !== null;
@@ -592,9 +652,8 @@ export const getEmbeddingTableName = () => EMBEDDING_TABLE_NAME;
 // ============================================================================
 /**
  * Load the FTS extension (required before using FTS functions).
- * Safe to call multiple times — tracks loaded state.
+ * Safe to call multiple times — tracks loaded state via module-level ftsLoaded.
  */
-let ftsLoaded = false;
 export const loadFTSExtension = async () => {
     if (ftsLoaded)
         return;

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

@@ -16,11 +16,11 @@ 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)";
 export declare const FOLDER_SCHEMA = "\nCREATE NODE TABLE Folder (\n  id STRING,\n  name STRING,\n  filePath STRING,\n  PRIMARY KEY (id)\n)";
-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  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  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  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  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  PRIMARY KEY (id)\n)";
+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 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)";
 export declare const STRUCT_SCHEMA: string;
@@ -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 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 `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 `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 `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 `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 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 `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 `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 `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

@@ -54,6 +54,7 @@ CREATE NODE TABLE Function (
   endLine INT64,
   isExported BOOLEAN,
   content STRING,
+  description STRING,
   PRIMARY KEY (id)
 )`;
 export const CLASS_SCHEMA = `
@@ -65,6 +66,7 @@ CREATE NODE TABLE Class (
   endLine INT64,
   isExported BOOLEAN,
   content STRING,
+  description STRING,
   PRIMARY KEY (id)
 )`;
 export const INTERFACE_SCHEMA = `
@@ -76,6 +78,7 @@ CREATE NODE TABLE Interface (
   endLine INT64,
   isExported BOOLEAN,
   content STRING,
+  description STRING,
   PRIMARY KEY (id)
 )`;
 export const METHOD_SCHEMA = `
@@ -87,6 +90,7 @@ CREATE NODE TABLE Method (
   endLine INT64,
   isExported BOOLEAN,
   content STRING,
+  description STRING,
   PRIMARY KEY (id)
 )`;
 export const CODE_ELEMENT_SCHEMA = `
@@ -98,6 +102,7 @@ CREATE NODE TABLE CodeElement (
   endLine INT64,
   isExported BOOLEAN,
   content STRING,
+  description STRING,
   PRIMARY KEY (id)
 )`;
 // ============================================================================
@@ -134,6 +139,7 @@ CREATE NODE TABLE Process (
 // MULTI-LANGUAGE NODE TABLE SCHEMAS
 // ============================================================================
 // Generic code element with startLine/endLine for C, C++, Rust, Go, Java, C#
+// description: optional metadata (e.g. Eloquent $fillable fields, relationship targets)
 const CODE_ELEMENT_BASE = (name) => `
 CREATE NODE TABLE \`${name}\` (
   id STRING,
@@ -142,6 +148,7 @@ CREATE NODE TABLE \`${name}\` (
   startLine INT64,
   endLine INT64,
   content STRING,
+  description STRING,
   PRIMARY KEY (id)
 )`;
 export const STRUCT_SCHEMA = CODE_ELEMENT_BASE('Struct');
@@ -243,6 +250,7 @@ CREATE REL TABLE ${REL_TABLE_NAME} (
   FROM Method TO \`Impl\`,
   FROM Method TO Interface,
   FROM Method TO \`Constructor\`,
+  FROM Method TO \`Property\`,
   FROM \`Template\` TO \`Template\`,
   FROM \`Template\` TO Function,
   FROM \`Template\` TO Method,

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

@@ -8,6 +8,7 @@ import CPP from 'tree-sitter-cpp';
 import CSharp from 'tree-sitter-c-sharp';
 import Go from 'tree-sitter-go';
 import Rust from 'tree-sitter-rust';
+import PHP from 'tree-sitter-php';
 import { SupportedLanguages } from '../../config/supported-languages.js';
 let parser = null;
 const languageMap = {
@@ -21,6 +22,7 @@ const languageMap = {
     [SupportedLanguages.CSharp]: CSharp,
     [SupportedLanguages.Go]: Go,
     [SupportedLanguages.Rust]: Rust,
+    [SupportedLanguages.PHP]: PHP.php_only,
 };
 export const loadParser = async () => {
     if (parser)

package/dist/core/wiki/generator.js

@@ -11,7 +11,7 @@
  */
 import fs from 'fs/promises';
 import path from 'path';
-import { execSync } from 'child_process';
+import { execSync, execFileSync } from 'child_process';
 import { initWikiDb, closeWikiDb, getFilesWithExports, getAllFiles, getIntraModuleCallEdges, getInterModuleCallEdges, getProcessesForFiles, getAllProcesses, getInterModuleEdgesForOverview, } from './graph-queries.js';
 import { generateHTMLViewer } from './html-viewer.js';
 import { callLLM, estimateTokens, } from './llm-client.js';
@@ -561,7 +561,7 @@ export class WikiGenerator {
     }
     getChangedFiles(fromCommit, toCommit) {
         try {
-            const output = execSync(`git diff ${fromCommit}..${toCommit} --name-only`, { cwd: this.repoPath }).toString().trim();
+            const output = execFileSync('git', ['diff', `${fromCommit}..${toCommit}`, '--name-only'], { cwd: this.repoPath }).toString().trim();
             return output ? output.split('\n').filter(Boolean) : [];
         }
         catch {