gitnexus 1.3.5 → 1.3.7

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

@@ -141,6 +141,8 @@ const EXTENSIONS = [
     '.py', '/__init__.py',
     // Java
     '.java',
+    // Kotlin
+    '.kt', '.kts',
     // C/C++
     '.c', '.h', '.cpp', '.hpp', '.cc', '.cxx', '.hxx', '.hh',
     // C#
@@ -406,19 +408,32 @@ function tryRustModulePath(modulePath, allFiles) {
     }
     return null;
 }
+/**
+ * Append .* to a Kotlin import path if the AST has a wildcard_import sibling node.
+ * Pure function — returns a new string without mutating the input.
+ */
+const appendKotlinWildcard = (importPath, importNode) => {
+    for (let i = 0; i < importNode.childCount; i++) {
+        if (importNode.child(i)?.type === 'wildcard_import') {
+            return importPath.endsWith('.*') ? importPath : `${importPath}.*`;
+        }
+    }
+    return importPath;
+};
 // ============================================================================
-// JAVA MULTI-FILE RESOLUTION
+// JVM MULTI-FILE RESOLUTION (Java + Kotlin)
 // ============================================================================
+/** Kotlin file extensions for JVM resolver reuse */
+const KOTLIN_EXTENSIONS = ['.kt', '.kts'];
 /**
- * Resolve a Java wildcard import (com.example.*) to all matching .java files.
- * Returns an array of file paths.
+ * Resolve a JVM wildcard import (com.example.*) to all matching files.
+ * Works for both Java (.java) and Kotlin (.kt, .kts).
  */
-function resolveJavaWildcard(importPath, normalizedFileList, allFileList, index) {
+function resolveJvmWildcard(importPath, normalizedFileList, allFileList, extensions, index) {
     // "com.example.util.*" -> "com/example/util"
     const packagePath = importPath.slice(0, -2).replace(/\./g, '/');
     if (index) {
-        // Use directory index: get all .java files in this package directory
-        const candidates = index.getFilesInDir(packagePath, '.java');
+        const candidates = extensions.flatMap(ext => index.getFilesInDir(packagePath, ext));
         // Filter to only direct children (no subdirectories)
         const packageSuffix = '/' + packagePath + '/';
         return candidates.filter(f => {
@@ -435,7 +450,8 @@ function resolveJavaWildcard(importPath, normalizedFileList, allFileList, index)
     const matches = [];
     for (let i = 0; i < normalizedFileList.length; i++) {
         const normalized = normalizedFileList[i];
-        if (normalized.includes(packageSuffix) && normalized.endsWith('.java')) {
+        if (normalized.includes(packageSuffix) &&
+            extensions.some(ext => normalized.endsWith(ext))) {
             const afterPackage = normalized.substring(normalized.indexOf(packageSuffix) + packageSuffix.length);
             if (!afterPackage.includes('/')) {
                 matches.push(allFileList[i]);
@@ -445,29 +461,34 @@ function resolveJavaWildcard(importPath, normalizedFileList, allFileList, index)
     return matches;
 }
 /**
- * Try to resolve a Java static import by stripping the member name.
- * "com.example.Constants.VALUE" -> resolve "com.example.Constants"
+ * Try to resolve a JVM member/static import by stripping the member name.
+ * Java: "com.example.Constants.VALUE" -> resolve "com.example.Constants"
+ * Kotlin: "com.example.Constants.VALUE" -> resolve "com.example.Constants"
  */
-function resolveJavaStaticImport(importPath, normalizedFileList, allFileList, index) {
-    // Static imports look like: com.example.Constants.VALUE or com.example.Constants.*
-    // The last segment is a member name (field/method) if it starts with lowercase or is ALL_CAPS
+function resolveJvmMemberImport(importPath, normalizedFileList, allFileList, extensions, index) {
+    // Member imports: com.example.Constants.VALUE or com.example.Constants.*
+    // The last segment is a member name if it starts with lowercase, is ALL_CAPS, or is a wildcard
     const segments = importPath.split('.');
     if (segments.length < 3)
         return null;
     const lastSeg = segments[segments.length - 1];
-    // If last segment is a wildcard or ALL_CAPS constant or starts with lowercase, strip it
     if (lastSeg === '*' || /^[a-z]/.test(lastSeg) || /^[A-Z_]+$/.test(lastSeg)) {
         const classPath = segments.slice(0, -1).join('/');
-        const classSuffix = classPath + '.java';
-        if (index) {
-            return index.get(classSuffix) || index.getInsensitive(classSuffix) || null;
-        }
-        // Fallback: linear scan
-        const fullSuffix = '/' + classSuffix;
-        for (let i = 0; i < normalizedFileList.length; i++) {
-            if (normalizedFileList[i].endsWith(fullSuffix) ||
-                normalizedFileList[i].toLowerCase().endsWith(fullSuffix.toLowerCase())) {
-                return allFileList[i];
+        for (const ext of extensions) {
+            const classSuffix = classPath + ext;
+            if (index) {
+                const result = index.get(classSuffix) || index.getInsensitive(classSuffix);
+                if (result)
+                    return result;
+            }
+            else {
+                const fullSuffix = '/' + classSuffix;
+                for (let i = 0; i < normalizedFileList.length; i++) {
+                    if (normalizedFileList[i].endsWith(fullSuffix) ||
+                        normalizedFileList[i].toLowerCase().endsWith(fullSuffix.toLowerCase())) {
+                        return allFileList[i];
+                    }
+                }
             }
         }
     }
@@ -637,24 +658,40 @@ export const processImports = async (graph, files, astCache, importMap, onProgre
                     return;
                 }
                 // Clean path (remove quotes and angle brackets for C/C++ includes)
-                const rawImportPath = sourceNode.text.replace(/['"<>]/g, '');
+                const rawImportPath = language === SupportedLanguages.Kotlin
+                    ? appendKotlinWildcard(sourceNode.text.replace(/['"<>]/g, ''), captureMap['import'])
+                    : sourceNode.text.replace(/['"<>]/g, '');
                 totalImportsFound++;
-                // ---- Java: handle wildcards and static imports specially ----
-                if (language === SupportedLanguages.Java) {
+                // ---- JVM languages (Java + Kotlin): handle wildcards and member imports ----
+                if (language === SupportedLanguages.Java || language === SupportedLanguages.Kotlin) {
+                    const exts = language === SupportedLanguages.Java ? ['.java'] : KOTLIN_EXTENSIONS;
                     if (rawImportPath.endsWith('.*')) {
-                        const matchedFiles = resolveJavaWildcard(rawImportPath, normalizedFileList, allFileList, index);
+                        const matchedFiles = resolveJvmWildcard(rawImportPath, normalizedFileList, allFileList, exts, index);
+                        // Kotlin can import Java files in mixed codebases — try .java as fallback
+                        if (matchedFiles.length === 0 && language === SupportedLanguages.Kotlin) {
+                            const javaMatches = resolveJvmWildcard(rawImportPath, normalizedFileList, allFileList, ['.java'], index);
+                            for (const matchedFile of javaMatches) {
+                                addImportEdge(file.path, matchedFile);
+                            }
+                            if (javaMatches.length > 0)
+                                return;
+                        }
                         for (const matchedFile of matchedFiles) {
                             addImportEdge(file.path, matchedFile);
                         }
                         return; // skip single-file resolution
                     }
-                    // Try static import resolution (strip member name)
-                    const staticResolved = resolveJavaStaticImport(rawImportPath, normalizedFileList, allFileList, index);
-                    if (staticResolved) {
-                        addImportEdge(file.path, staticResolved);
+                    // Try member/static import resolution (strip member name)
+                    let memberResolved = resolveJvmMemberImport(rawImportPath, normalizedFileList, allFileList, exts, index);
+                    // Kotlin can import Java files in mixed codebases — try .java as fallback
+                    if (!memberResolved && language === SupportedLanguages.Kotlin) {
+                        memberResolved = resolveJvmMemberImport(rawImportPath, normalizedFileList, allFileList, ['.java'], index);
+                    }
+                    if (memberResolved) {
+                        addImportEdge(file.path, memberResolved);
                         return;
                     }
-                    // Fall through to normal resolution for regular Java imports
+                    // Fall through to normal resolution for regular imports
                 }
                 // ---- Go: handle package-level imports ----
                 if (language === SupportedLanguages.Go && goModule && rawImportPath.startsWith(goModule.modulePath)) {
@@ -779,19 +816,33 @@ export const processImportsFromExtracted = async (graph, files, extractedImports
                     addImportEdge(filePath, cached);
                 continue;
             }
-            // Java: handle wildcards and static imports
-            if (language === SupportedLanguages.Java) {
+            // JVM languages (Java + Kotlin): handle wildcards and member imports
+            if (language === SupportedLanguages.Java || language === SupportedLanguages.Kotlin) {
+                const exts = language === SupportedLanguages.Java ? ['.java'] : KOTLIN_EXTENSIONS;
                 if (rawImportPath.endsWith('.*')) {
-                    const matchedFiles = resolveJavaWildcard(rawImportPath, normalizedFileList, allFileList, index);
+                    const matchedFiles = resolveJvmWildcard(rawImportPath, normalizedFileList, allFileList, exts, index);
+                    // Kotlin can import Java files in mixed codebases — try .java as fallback
+                    if (matchedFiles.length === 0 && language === SupportedLanguages.Kotlin) {
+                        const javaMatches = resolveJvmWildcard(rawImportPath, normalizedFileList, allFileList, ['.java'], index);
+                        for (const matchedFile of javaMatches) {
+                            addImportEdge(filePath, matchedFile);
+                        }
+                        if (javaMatches.length > 0)
+                            continue;
+                    }
                     for (const matchedFile of matchedFiles) {
                         addImportEdge(filePath, matchedFile);
                     }
                     continue;
                 }
-                const staticResolved = resolveJavaStaticImport(rawImportPath, normalizedFileList, allFileList, index);
-                if (staticResolved) {
-                    resolveCache.set(cacheKey, staticResolved);
-                    addImportEdge(filePath, staticResolved);
+                let memberResolved = resolveJvmMemberImport(rawImportPath, normalizedFileList, allFileList, exts, index);
+                // Kotlin can import Java files in mixed codebases — try .java as fallback
+                if (!memberResolved && language === SupportedLanguages.Kotlin) {
+                    memberResolved = resolveJvmMemberImport(rawImportPath, normalizedFileList, allFileList, ['.java'], index);
+                }
+                if (memberResolved) {
+                    resolveCache.set(cacheKey, memberResolved);
+                    addImportEdge(filePath, memberResolved);
                     continue;
                 }
             }

package/dist/core/ingestion/parsing-processor.d.ts

@@ -2,13 +2,24 @@ import { KnowledgeGraph } from '../graph/types.js';
 import { SymbolTable } from './symbol-table.js';
 import { ASTCache } from './ast-cache.js';
 import { WorkerPool } from './workers/worker-pool.js';
-import type { ExtractedImport, ExtractedCall, ExtractedHeritage } from './workers/parse-worker.js';
+import type { ExtractedImport, ExtractedCall, ExtractedHeritage, ExtractedRoute } from './workers/parse-worker.js';
 export type FileProgressCallback = (current: number, total: number, filePath: string) => void;
 export interface WorkerExtractedData {
     imports: ExtractedImport[];
     calls: ExtractedCall[];
     heritage: ExtractedHeritage[];
+    routes: ExtractedRoute[];
 }
+/**
+ * Check if a symbol (function, class, etc.) is exported/public
+ * Handles all 9 supported languages with explicit logic
+ *
+ * @param node - The AST node for the symbol name
+ * @param name - The symbol name
+ * @param language - The programming language
+ * @returns true if the symbol is exported/public
+ */
+export declare const isNodeExported: (node: any, name: string, language: string) => boolean;
 export declare const processParsing: (graph: KnowledgeGraph, files: {
     path: string;
     content: string;

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

@@ -2,34 +2,34 @@ import Parser from 'tree-sitter';
 import { loadParser, loadLanguage } from '../tree-sitter/parser-loader.js';
 import { LANGUAGE_QUERIES } from './tree-sitter-queries.js';
 import { generateId } from '../../lib/utils.js';
-import { getLanguageFromFilename, yieldToEventLoop } from './utils.js';
+import { findSiblingChild, getLanguageFromFilename, yieldToEventLoop } from './utils.js';
 import { detectFrameworkFromAST } from './framework-detection.js';
+const DEFINITION_CAPTURE_KEYS = [
+    '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',
+];
 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) {
+    for (const key of DEFINITION_CAPTURE_KEYS) {
         if (captureMap[key])
             return captureMap[key];
     }
@@ -47,7 +47,7 @@ const getDefinitionNodeFromCaptures = (captureMap) => {
  * @param language - The programming language
  * @returns true if the symbol is exported/public
  */
-const isNodeExported = (node, name, language) => {
+export const isNodeExported = (node, name, language) => {
     let current = node;
     switch (language) {
         // JavaScript/TypeScript: Check for export keyword in ancestors
@@ -121,6 +121,24 @@ const isNodeExported = (node, name, language) => {
                 current = current.parent;
             }
             return false;
+        // Kotlin: Default visibility is public (unlike Java)
+        // visibility_modifier is inside modifiers, a sibling of the name node within the declaration
+        case 'kotlin':
+            while (current) {
+                if (current.parent) {
+                    const visMod = findSiblingChild(current.parent, 'modifiers', 'visibility_modifier');
+                    if (visMod) {
+                        const text = visMod.text;
+                        if (text === 'private' || text === 'internal' || text === 'protected')
+                            return false;
+                        if (text === 'public')
+                            return true;
+                    }
+                }
+                current = current.parent;
+            }
+            // No visibility modifier = public (Kotlin default)
+            return true;
         // C/C++: No native export concept at language level
         // Entry points will be detected via name patterns (main, etc.)
         case 'c':
@@ -137,6 +155,21 @@ const isNodeExported = (node, name, language) => {
                 current = current.parent;
             }
             return false;
+        // PHP: Check for visibility modifier or top-level scope
+        case 'php':
+            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;
+            }
+            return true; // Top-level functions are globally accessible
         default:
             return false;
     }
@@ -153,7 +186,7 @@ const processParsingWithWorkers = async (graph, files, symbolTable, astCache, wo
             parseableFiles.push({ path: file.path, content: file.content });
     }
     if (parseableFiles.length === 0)
-        return { imports: [], calls: [], heritage: [] };
+        return { imports: [], calls: [], heritage: [], routes: [] };
     const total = files.length;
     // Dispatch to worker pool — pool handles splitting into chunks and sub-batching
     const chunkResults = await workerPool.dispatch(parseableFiles, (filesProcessed) => {
@@ -163,6 +196,7 @@ const processParsingWithWorkers = async (graph, files, symbolTable, astCache, wo
     const allImports = [];
     const allCalls = [];
     const allHeritage = [];
+    const allRoutes = [];
     for (const result of chunkResults) {
         for (const node of result.nodes) {
             graph.addNode({
@@ -180,10 +214,11 @@ const processParsingWithWorkers = async (graph, files, symbolTable, astCache, wo
         allImports.push(...result.imports);
         allCalls.push(...result.calls);
         allHeritage.push(...result.heritage);
+        allRoutes.push(...result.routes);
     }
     // Final progress
     onFileProgress?.(total, total, 'done');
-    return { imports: allImports, calls: allCalls, heritage: allHeritage };
+    return { imports: allImports, calls: allCalls, heritage: allHeritage, routes: allRoutes };
 };
 // ============================================================================
 // Sequential fallback (original implementation)
@@ -202,7 +237,12 @@ const processParsingSequential = async (graph, files, symbolTable, astCache, onF
         // Skip very large files — they can crash tree-sitter or cause OOM
         if (file.content.length > 512 * 1024)
             continue;
-        await loadLanguage(language, file.path);
+        try {
+            await loadLanguage(language, file.path);
+        }
+        catch {
+            continue; // parser unavailable — already warned in pipeline
+        }
         let tree;
         try {
             tree = parser.parse(file.content, undefined, { bufferSize: 1024 * 256 });
@@ -239,9 +279,10 @@ const processParsingSequential = async (graph, files, symbolTable, astCache, onF
                 return;
             }
             const nameNode = captureMap['name'];
-            if (!nameNode)
+            // Synthesize name for constructors without explicit @name capture (e.g. Swift init)
+            if (!nameNode && !captureMap['definition.constructor'])
                 return;
-            const nodeName = nameNode.text;
+            const nodeName = nameNode ? nameNode.text : 'init';
             let nodeLabel = 'CodeElement';
             if (captureMap['definition.function'])
                 nodeLabel = 'Function';
@@ -287,28 +328,28 @@ const processParsingSequential = async (graph, files, symbolTable, astCache, onF
                 nodeLabel = 'Constructor';
             else if (captureMap['definition.template'])
                 nodeLabel = 'Template';
-            const nodeId = generateId(nodeLabel, `${file.path}:${nodeName}`);
+            const definitionNodeForRange = getDefinitionNodeFromCaptures(captureMap);
+            const startLine = definitionNodeForRange ? definitionNodeForRange.startPosition.row : (nameNode ? nameNode.startPosition.row : 0);
+            const nodeId = generateId(nodeLabel, `${file.path}:${nodeName}:${startLine}`);
+            const definitionNode = getDefinitionNodeFromCaptures(captureMap);
+            const frameworkHint = definitionNode
+                ? detectFrameworkFromAST(language, (definitionNode.text || '').slice(0, 300))
+                : null;
             const node = {
                 id: nodeId,
                 label: nodeLabel,
-                properties: (() => {
-                    const definitionNode = getDefinitionNodeFromCaptures(captureMap);
-                    const frameworkHint = definitionNode
-                        ? detectFrameworkFromAST(language, definitionNode.text || '')
-                        : null;
-                    return {
-                        name: nodeName,
-                        filePath: file.path,
-                        startLine: nameNode.startPosition.row,
-                        endLine: nameNode.endPosition.row,
-                        language: language,
-                        isExported: isNodeExported(nameNode, nodeName, language),
-                        ...(frameworkHint ? {
-                            astFrameworkMultiplier: frameworkHint.entryPointMultiplier,
-                            astFrameworkReason: frameworkHint.reason,
-                        } : {}),
-                    };
-                })()
+                properties: {
+                    name: nodeName,
+                    filePath: file.path,
+                    startLine: definitionNodeForRange ? definitionNodeForRange.startPosition.row : startLine,
+                    endLine: definitionNodeForRange ? definitionNodeForRange.endPosition.row : startLine,
+                    language: language,
+                    isExported: isNodeExported(nameNode || definitionNodeForRange, nodeName, language),
+                    ...(frameworkHint ? {
+                        astFrameworkMultiplier: frameworkHint.entryPointMultiplier,
+                        astFrameworkReason: frameworkHint.reason,
+                    } : {}),
+                },
             };
             graph.addNode(node);
             symbolTable.add(file.path, nodeName, nodeId, nodeLabel);

package/dist/core/ingestion/pipeline.js

@@ -2,7 +2,7 @@ import { createKnowledgeGraph } from '../graph/graph.js';
 import { processStructure } from './structure-processor.js';
 import { processParsing } from './parsing-processor.js';
 import { processImports, processImportsFromExtracted, createImportMap, buildImportResolutionContext } from './import-processor.js';
-import { processCalls, processCallsFromExtracted } from './call-processor.js';
+import { processCalls, processCallsFromExtracted, processRoutesFromExtracted } from './call-processor.js';
 import { processHeritage, processHeritageFromExtracted } from './heritage-processor.js';
 import { processCommunities } from './community-processor.js';
 import { processProcesses } from './process-processor.js';
@@ -10,6 +10,7 @@ import { createSymbolTable } from './symbol-table.js';
 import { createASTCache } from './ast-cache.js';
 import { walkRepositoryPaths, readFileContents } from './filesystem-walker.js';
 import { getLanguageFromFilename } from './utils.js';
+import { isLanguageAvailable } from '../tree-sitter/parser-loader.js';
 import { createWorkerPool } from './workers/worker-pool.js';
 const isDev = process.env.NODE_ENV === 'development';
 /** Max bytes of source content to load per parse chunk. Each chunk's source +
@@ -70,7 +71,21 @@ export const runPipelineFromRepo = async (repoPath, onProgress) => {
         // ── Phase 3+4: Chunked read + parse ────────────────────────────────
         // Group parseable files into byte-budget chunks so only ~20MB of source
         // is in memory at a time. Each chunk is: read → parse → extract → free.
-        const parseableScanned = scannedFiles.filter(f => getLanguageFromFilename(f.path));
+        const parseableScanned = scannedFiles.filter(f => {
+            const lang = getLanguageFromFilename(f.path);
+            return lang && isLanguageAvailable(lang);
+        });
+        // Warn about files skipped due to unavailable parsers
+        const skippedByLang = new Map();
+        for (const f of scannedFiles) {
+            const lang = getLanguageFromFilename(f.path);
+            if (lang && !isLanguageAvailable(lang)) {
+                skippedByLang.set(lang, (skippedByLang.get(lang) || 0) + 1);
+            }
+        }
+        for (const [lang, count] of skippedByLang) {
+            console.warn(`Skipping ${count} ${lang} file(s) — ${lang} parser not available (native binding may not have built). Try: npm rebuild tree-sitter-${lang}`);
+        }
         const totalParseable = parseableScanned.length;
         // Build byte-budget chunks
         const chunks = [];
@@ -151,6 +166,10 @@ export const runPipelineFromRepo = async (repoPath, onProgress) => {
                     if (chunkWorkerData.heritage.length > 0) {
                         await processHeritageFromExtracted(graph, chunkWorkerData.heritage, symbolTable);
                     }
+                    // Routes — resolve immediately (Laravel route→controller CALLS edges)
+                    if (chunkWorkerData.routes && chunkWorkerData.routes.length > 0) {
+                        await processRoutesFromExtracted(graph, chunkWorkerData.routes, symbolTable, importMap);
+                    }
                 }
                 else {
                     await processImports(graph, chunkFiles, astCache, importMap, undefined, repoPath, allPaths);

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

@@ -219,7 +219,6 @@ const traceFromEntryPoint = (entryId, callsEdges, config) => {
     // BFS with path tracking
     // Each queue item: [currentNodeId, pathSoFar]
     const queue = [[entryId, [entryId]]];
-    const visited = new Set();
     while (queue.length > 0 && traces.length < config.maxBranching * 3) {
         const [currentId, path] = queue.shift();
         // Get outgoing calls

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

@@ -9,5 +9,6 @@ export declare const CPP_QUERIES = "\n; Classes, Structs, Namespaces\n(class_spe
 export declare const CSHARP_QUERIES = "\n; Types\n(class_declaration name: (identifier) @name) @definition.class\n(interface_declaration name: (identifier) @name) @definition.interface\n(struct_declaration name: (identifier) @name) @definition.struct\n(enum_declaration name: (identifier) @name) @definition.enum\n(record_declaration name: (identifier) @name) @definition.record\n(delegate_declaration name: (identifier) @name) @definition.delegate\n\n; Namespaces\n(namespace_declaration name: (identifier) @name) @definition.namespace\n(namespace_declaration name: (qualified_name) @name) @definition.namespace\n\n; Methods & Properties\n(method_declaration name: (identifier) @name) @definition.method\n(local_function_statement name: (identifier) @name) @definition.function\n(constructor_declaration name: (identifier) @name) @definition.constructor\n(property_declaration name: (identifier) @name) @definition.property\n\n; Using\n(using_directive (qualified_name) @import.source) @import\n(using_directive (identifier) @import.source) @import\n\n; Calls\n(invocation_expression function: (identifier) @call.name) @call\n(invocation_expression function: (member_access_expression name: (identifier) @call.name)) @call\n\n; Heritage\n(class_declaration name: (identifier) @heritage.class\n  (base_list (simple_base_type (identifier) @heritage.extends))) @heritage\n(class_declaration name: (identifier) @heritage.class\n  (base_list (simple_base_type (generic_name (identifier) @heritage.extends)))) @heritage\n";
 export declare const RUST_QUERIES = "\n; Functions & Items\n(function_item name: (identifier) @name) @definition.function\n(struct_item name: (type_identifier) @name) @definition.struct\n(enum_item name: (type_identifier) @name) @definition.enum\n(trait_item name: (type_identifier) @name) @definition.trait\n(impl_item type: (type_identifier) @name) @definition.impl\n(mod_item name: (identifier) @name) @definition.module\n\n; Type aliases, const, static, macros\n(type_item name: (type_identifier) @name) @definition.type\n(const_item name: (identifier) @name) @definition.const\n(static_item name: (identifier) @name) @definition.static\n(macro_definition name: (identifier) @name) @definition.macro\n\n; Use statements\n(use_declaration argument: (_) @import.source) @import\n\n; Calls\n(call_expression function: (identifier) @call.name) @call\n(call_expression function: (field_expression field: (field_identifier) @call.name)) @call\n(call_expression function: (scoped_identifier name: (identifier) @call.name)) @call\n(call_expression function: (generic_function function: (identifier) @call.name)) @call\n\n; Heritage (trait implementation)\n(impl_item trait: (type_identifier) @heritage.trait type: (type_identifier) @heritage.class) @heritage\n(impl_item trait: (generic_type type: (type_identifier) @heritage.trait) type: (type_identifier) @heritage.class) @heritage\n";
 export declare const PHP_QUERIES = "\n; \u2500\u2500 Namespace \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(namespace_definition\n  name: (namespace_name) @name) @definition.namespace\n\n; \u2500\u2500 Classes \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(class_declaration\n  name: (name) @name) @definition.class\n\n; \u2500\u2500 Interfaces \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(interface_declaration\n  name: (name) @name) @definition.interface\n\n; \u2500\u2500 Traits \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(trait_declaration\n  name: (name) @name) @definition.trait\n\n; \u2500\u2500 Enums (PHP 8.1) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(enum_declaration\n  name: (name) @name) @definition.enum\n\n; \u2500\u2500 Top-level functions \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(function_definition\n  name: (name) @name) @definition.function\n\n; \u2500\u2500 Methods (including constructors) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(method_declaration\n  name: (name) @name) @definition.method\n\n; \u2500\u2500 Class properties (including Eloquent $fillable, $casts, etc.) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(property_declaration\n  (property_element\n    (variable_name\n      (name) @name))) @definition.property\n\n; \u2500\u2500 Imports: use statements \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n; Simple: use App\\Models\\User;\n(namespace_use_declaration\n  (namespace_use_clause\n    (qualified_name) @import.source)) @import\n\n; \u2500\u2500 Function/method calls \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n; Regular function call: foo()\n(function_call_expression\n  function: (name) @call.name) @call\n\n; Method call: $obj->method()\n(member_call_expression\n  name: (name) @call.name) @call\n\n; Nullsafe method call: $obj?->method()\n(nullsafe_member_call_expression\n  name: (name) @call.name) @call\n\n; Static call: Foo::bar() (php_only uses scoped_call_expression)\n(scoped_call_expression\n  name: (name) @call.name) @call\n\n; \u2500\u2500 Heritage: extends \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(class_declaration\n  name: (name) @heritage.class\n  (base_clause\n    [(name) (qualified_name)] @heritage.extends)) @heritage\n\n; \u2500\u2500 Heritage: implements \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(class_declaration\n  name: (name) @heritage.class\n  (class_interface_clause\n    [(name) (qualified_name)] @heritage.implements)) @heritage.impl\n\n; \u2500\u2500 Heritage: use trait (must capture enclosing class name) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(class_declaration\n  name: (name) @heritage.class\n  body: (declaration_list\n    (use_declaration\n      [(name) (qualified_name)] @heritage.trait))) @heritage\n";
+export declare const KOTLIN_QUERIES = "\n; \u2500\u2500 Interfaces \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n; tree-sitter-kotlin (fwcd) has no interface_declaration node type.\n; Interfaces are class_declaration nodes with an anonymous \"interface\" keyword child.\n(class_declaration\n  \"interface\"\n  (type_identifier) @name) @definition.interface\n\n; \u2500\u2500 Classes (regular, data, sealed, enum) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n; All have the anonymous \"class\" keyword child. enum class has both\n; \"enum\" and \"class\" children \u2014 the \"class\" child still matches.\n(class_declaration\n  \"class\"\n  (type_identifier) @name) @definition.class\n\n; \u2500\u2500 Object declarations (Kotlin singletons) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(object_declaration\n  (type_identifier) @name) @definition.class\n\n; \u2500\u2500 Companion objects (named only) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(companion_object\n  (type_identifier) @name) @definition.class\n\n; \u2500\u2500 Functions (top-level, member, extension) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(function_declaration\n  (simple_identifier) @name) @definition.function\n\n; \u2500\u2500 Properties \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(property_declaration\n  (variable_declaration\n    (simple_identifier) @name)) @definition.property\n\n; \u2500\u2500 Enum entries \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(enum_entry\n  (simple_identifier) @name) @definition.enum\n\n; \u2500\u2500 Type aliases \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(type_alias\n  (type_identifier) @name) @definition.type\n\n; \u2500\u2500 Imports \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(import_header\n  (identifier) @import.source) @import\n\n; \u2500\u2500 Function calls (direct) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(call_expression\n  (simple_identifier) @call.name) @call\n\n; \u2500\u2500 Method calls (via navigation: obj.method()) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(call_expression\n  (navigation_expression\n    (navigation_suffix\n      (simple_identifier) @call.name))) @call\n\n; \u2500\u2500 Constructor invocations \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(constructor_invocation\n  (user_type\n    (type_identifier) @call.name)) @call\n\n; \u2500\u2500 Infix function calls (e.g., a to b, x until y) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n(infix_expression\n  (simple_identifier) @call.name) @call\n\n; \u2500\u2500 Heritage: extends / implements via delegation_specifier \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n; Interface implementation (bare user_type): class Foo : Bar\n(class_declaration\n  (type_identifier) @heritage.class\n  (delegation_specifier\n    (user_type (type_identifier) @heritage.extends))) @heritage\n\n; Class extension (constructor_invocation): class Foo : Bar()\n(class_declaration\n  (type_identifier) @heritage.class\n  (delegation_specifier\n    (constructor_invocation\n      (user_type (type_identifier) @heritage.extends)))) @heritage\n";
 export declare const SWIFT_QUERIES = "\n; Classes\n(class_declaration \"class\" name: (type_identifier) @name) @definition.class\n\n; Structs\n(class_declaration \"struct\" name: (type_identifier) @name) @definition.struct\n\n; Enums\n(class_declaration \"enum\" name: (type_identifier) @name) @definition.enum\n\n; Extensions (mapped to class \u2014 no dedicated label in schema)\n(class_declaration \"extension\" name: (user_type (type_identifier) @name)) @definition.class\n\n; Actors\n(class_declaration \"actor\" name: (type_identifier) @name) @definition.class\n\n; Protocols (mapped to interface)\n(protocol_declaration name: (type_identifier) @name) @definition.interface\n\n; Type aliases\n(typealias_declaration name: (type_identifier) @name) @definition.type\n\n; Functions (top-level and methods)\n(function_declaration name: (simple_identifier) @name) @definition.function\n\n; Protocol method declarations\n(protocol_function_declaration name: (simple_identifier) @name) @definition.method\n\n; Initializers\n(init_declaration) @definition.constructor\n\n; Properties (stored and computed)\n(property_declaration (pattern (simple_identifier) @name)) @definition.property\n\n; Imports\n(import_declaration (identifier (simple_identifier) @import.source)) @import\n\n; Calls - direct function calls\n(call_expression (simple_identifier) @call.name) @call\n\n; Calls - member/navigation calls (obj.method())\n(call_expression (navigation_expression (navigation_suffix (simple_identifier) @call.name))) @call\n\n; Heritage - class/struct/enum inheritance and protocol conformance\n(class_declaration name: (type_identifier) @heritage.class\n  (inheritance_specifier inherits_from: (user_type (type_identifier) @heritage.extends))) @heritage\n\n; Heritage - protocol inheritance\n(protocol_declaration name: (type_identifier) @heritage.class\n  (inheritance_specifier inherits_from: (user_type (type_identifier) @heritage.extends))) @heritage\n";
 export declare const LANGUAGE_QUERIES: Record<SupportedLanguages, string>;

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

@@ -384,6 +384,85 @@ export const PHP_QUERIES = `
     (use_declaration
       [(name) (qualified_name)] @heritage.trait))) @heritage
 `;
+// Kotlin queries - works with tree-sitter-kotlin (fwcd/tree-sitter-kotlin)
+// Based on official tags.scm; functions use simple_identifier, classes use type_identifier
+export const KOTLIN_QUERIES = `
+; ── Interfaces ─────────────────────────────────────────────────────────────
+; tree-sitter-kotlin (fwcd) has no interface_declaration node type.
+; Interfaces are class_declaration nodes with an anonymous "interface" keyword child.
+(class_declaration
+  "interface"
+  (type_identifier) @name) @definition.interface
+
+; ── Classes (regular, data, sealed, enum) ────────────────────────────────
+; All have the anonymous "class" keyword child. enum class has both
+; "enum" and "class" children — the "class" child still matches.
+(class_declaration
+  "class"
+  (type_identifier) @name) @definition.class
+
+; ── Object declarations (Kotlin singletons) ──────────────────────────────
+(object_declaration
+  (type_identifier) @name) @definition.class
+
+; ── Companion objects (named only) ───────────────────────────────────────
+(companion_object
+  (type_identifier) @name) @definition.class
+
+; ── Functions (top-level, member, extension) ──────────────────────────────
+(function_declaration
+  (simple_identifier) @name) @definition.function
+
+; ── Properties ───────────────────────────────────────────────────────────
+(property_declaration
+  (variable_declaration
+    (simple_identifier) @name)) @definition.property
+
+; ── Enum entries ─────────────────────────────────────────────────────────
+(enum_entry
+  (simple_identifier) @name) @definition.enum
+
+; ── Type aliases ─────────────────────────────────────────────────────────
+(type_alias
+  (type_identifier) @name) @definition.type
+
+; ── Imports ──────────────────────────────────────────────────────────────
+(import_header
+  (identifier) @import.source) @import
+
+; ── Function calls (direct) ──────────────────────────────────────────────
+(call_expression
+  (simple_identifier) @call.name) @call
+
+; ── Method calls (via navigation: obj.method()) ──────────────────────────
+(call_expression
+  (navigation_expression
+    (navigation_suffix
+      (simple_identifier) @call.name))) @call
+
+; ── Constructor invocations ──────────────────────────────────────────────
+(constructor_invocation
+  (user_type
+    (type_identifier) @call.name)) @call
+
+; ── Infix function calls (e.g., a to b, x until y) ──────────────────────
+(infix_expression
+  (simple_identifier) @call.name) @call
+
+; ── Heritage: extends / implements via delegation_specifier ──────────────
+; Interface implementation (bare user_type): class Foo : Bar
+(class_declaration
+  (type_identifier) @heritage.class
+  (delegation_specifier
+    (user_type (type_identifier) @heritage.extends))) @heritage
+
+; Class extension (constructor_invocation): class Foo : Bar()
+(class_declaration
+  (type_identifier) @heritage.class
+  (delegation_specifier
+    (constructor_invocation
+      (user_type (type_identifier) @heritage.extends)))) @heritage
+`;
 // Swift queries - works with tree-sitter-swift
 export const SWIFT_QUERIES = `
 ; Classes
@@ -447,5 +526,6 @@ export const LANGUAGE_QUERIES = {
     [SupportedLanguages.CSharp]: CSHARP_QUERIES,
     [SupportedLanguages.Rust]: RUST_QUERIES,
     [SupportedLanguages.PHP]: PHP_QUERIES,
+    [SupportedLanguages.Kotlin]: KOTLIN_QUERIES,
     [SupportedLanguages.Swift]: SWIFT_QUERIES,
 };