gitnexus 1.3.11 → 1.4.0

package/dist/core/ingestion/entry-point-scoring.js

@@ -10,6 +10,7 @@
  * This module is language-agnostic - language-specific patterns are defined per language.
  */
 import { detectFrameworkFromPath } from './framework-detection.js';
+import { SupportedLanguages } from '../../config/supported-languages.js';
 // ============================================================================
 // NAME PATTERNS - All 9 supported languages
 // ============================================================================
@@ -34,65 +35,112 @@ const ENTRY_POINT_PATTERNS = {
         /^emit[A-Z]/, // emitEvent
     ],
     // JavaScript/TypeScript
-    'javascript': [
+    [SupportedLanguages.JavaScript]: [
         /^use[A-Z]/, // React hooks (useEffect, etc.)
     ],
-    'typescript': [
+    [SupportedLanguages.TypeScript]: [
         /^use[A-Z]/, // React hooks
     ],
     // Python
-    'python': [
+    [SupportedLanguages.Python]: [
         /^app$/, // Flask/FastAPI app
         /^(get|post|put|delete|patch)_/i, // REST conventions
         /^api_/, // API functions
         /^view_/, // Django views
     ],
     // Java
-    'java': [
+    [SupportedLanguages.Java]: [
         /^do[A-Z]/, // doGet, doPost (Servlets)
         /^create[A-Z]/, // Factory patterns
         /^build[A-Z]/, // Builder patterns
         /Service$/, // UserService
     ],
     // C#
-    'csharp': [
-        /^(Get|Post|Put|Delete)/, // ASP.NET conventions
+    [SupportedLanguages.CSharp]: [
+        /^(Get|Post|Put|Delete|Patch)/, // ASP.NET action methods
         /Action$/, // MVC actions
-        /^On[A-Z]/, // Event handlers
+        /^On[A-Z]/, // Event handlers / Blazor lifecycle
         /Async$/, // Async entry points
+        /^Configure$/, // Startup.Configure
+        /^ConfigureServices$/, // Startup.ConfigureServices
+        /^Handle$/, // MediatR / generic handler
+        /^Execute$/, // Command pattern
+        /^Invoke$/, // Middleware Invoke
+        /^Map[A-Z]/, // Minimal API MapGet, MapPost
+        /Service$/, // Service classes
+        /^Seed/, // Database seeding
     ],
     // Go
-    'go': [
+    [SupportedLanguages.Go]: [
         /Handler$/, // http.Handler pattern
         /^Serve/, // ServeHTTP
         /^New[A-Z]/, // Constructor pattern (returns new instance)
         /^Make[A-Z]/, // Make functions
     ],
     // Rust
-    'rust': [
+    [SupportedLanguages.Rust]: [
         /^(get|post|put|delete)_handler$/i,
         /^handle_/, // handle_request
         /^new$/, // Constructor pattern
         /^run$/, // run entry point
         /^spawn/, // Async spawn
     ],
-    // C - explicit main() boost (critical for C programs)
-    'c': [
+    // C - explicit main() boost plus common C entry point conventions
+    [SupportedLanguages.C]: [
         /^main$/, // THE entry point
-        /^init_/, // Initialization functions
-        /^start_/, // Start functions
-        /^run_/, // Run functions
+        /^init_/, // init_server, init_client
+        /_init$/, // module_init, server_init
+        /^start_/, // start_server
+        /_start$/, // thread_start
+        /^run_/, // run_loop
+        /_run$/, // event_run
+        /^stop_/, // stop_server
+        /_stop$/, // service_stop
+        /^open_/, // open_connection
+        /_open$/, // file_open
+        /^close_/, // close_connection
+        /_close$/, // socket_close
+        /^create_/, // create_session
+        /_create$/, // object_create
+        /^destroy_/, // destroy_session
+        /_destroy$/, // object_destroy
+        /^handle_/, // handle_request
+        /_handler$/, // signal_handler
+        /_callback$/, // event_callback
+        /^cmd_/, // tmux: cmd_new_window, cmd_attach_session
+        /^server_/, // server_start, server_loop
+        /^client_/, // client_connect
+        /^session_/, // session_create
+        /^window_/, // window_resize (tmux)
+        /^key_/, // key_press
+        /^input_/, // input_parse
+        /^output_/, // output_write
+        /^notify_/, // notify_client
+        /^control_/, // control_start
     ],
-    // C++ - same as C plus class patterns
-    'cpp': [
+    // C++ - same as C plus OOP/template patterns
+    [SupportedLanguages.CPlusPlus]: [
         /^main$/, // THE entry point
         /^init_/,
+        /_init$/,
         /^Create[A-Z]/, // Factory patterns
+        /^create_/,
         /^Run$/, // Run methods
+        /^run$/,
         /^Start$/, // Start methods
+        /^start$/,
+        /^handle_/,
+        /_handler$/,
+        /_callback$/,
+        /^OnEvent/, // Event callbacks
+        /^on_/,
+        /::Run$/, // Class::Run
+        /::Start$/, // Class::Start
+        /::Init$/, // Class::Init
+        /::Execute$/, // Class::Execute
     ],
     // Swift / iOS
-    'swift': [
+    [SupportedLanguages.Swift]: [
         /^viewDidLoad$/, // UIKit lifecycle
         /^viewWillAppear$/, // UIKit lifecycle
         /^viewDidAppear$/, // UIKit lifecycle
@@ -111,7 +159,7 @@ const ENTRY_POINT_PATTERNS = {
         /^makeBody$/, // SwiftUI ViewModifier
     ],
     // PHP / Laravel
-    'php': [
+    [SupportedLanguages.PHP]: [
         /Controller$/, // UserController (class name convention)
         /^handle$/, // Job::handle(), Listener::handle()
         /^execute$/, // Command::execute()
@@ -131,6 +179,14 @@ const ENTRY_POINT_PATTERNS = {
         /^delete$/, // Repository::delete()
     ],
 };
+/** Pre-computed merged patterns (universal + language-specific) to avoid per-call array allocation. */
+const MERGED_ENTRY_POINT_PATTERNS = {};
+const UNIVERSAL_PATTERNS = ENTRY_POINT_PATTERNS['*'] || [];
+for (const [lang, patterns] of Object.entries(ENTRY_POINT_PATTERNS)) {
+    if (lang === '*')
+        continue;
+    MERGED_ENTRY_POINT_PATTERNS[lang] = [...UNIVERSAL_PATTERNS, ...patterns];
+}
 // ============================================================================
 // UTILITY PATTERNS - Functions that should be penalized
 // ============================================================================
@@ -196,9 +252,7 @@ export function calculateEntryPointScore(name, language, isExported, callerCount
     }
     else {
         // Check positive patterns
-        const universalPatterns = ENTRY_POINT_PATTERNS['*'] || [];
-        const langPatterns = ENTRY_POINT_PATTERNS[language] || [];
-        const allPatterns = [...universalPatterns, ...langPatterns];
+        const allPatterns = MERGED_ENTRY_POINT_PATTERNS[language] || UNIVERSAL_PATTERNS;
         if (allPatterns.some(p => p.test(name))) {
             nameMultiplier = 1.5; // Bonus for matching entry point pattern
             reasons.push('entry-pattern');
@@ -253,8 +307,13 @@ export function isTestFile(filePath) {
         p.endsWith('test.swift') ||
         p.includes('uitests/') ||
         // C# test patterns
+        p.endsWith('tests.cs') ||
+        p.endsWith('test.cs') ||
         p.includes('.tests/') ||
-        p.includes('tests.cs') ||
+        p.includes('.test/') ||
+        p.includes('.integrationtests/') ||
+        p.includes('.unittests/') ||
+        p.includes('/testproject/') ||
         // PHP/Laravel test patterns
         p.endsWith('test.php') ||
         p.endsWith('spec.php') ||

package/dist/core/ingestion/export-detection.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Export Detection
+ *
+ * Determines whether a symbol (function, class, etc.) is exported/public
+ * in its language. This is a pure function — safe for use in worker threads.
+ *
+ * Shared between parse-worker.ts (worker pool) and parsing-processor.ts (sequential fallback).
+ */
+import { SyntaxNode } from './utils.js';
+import { SupportedLanguages } from '../../config/supported-languages.js';
+/**
+ * Check if a tree-sitter node is exported/public in its language.
+ * @param node - The tree-sitter AST node
+ * @param name - The symbol name
+ * @param language - The programming language
+ * @returns true if the symbol is exported/public
+ */
+export declare const isNodeExported: (node: SyntaxNode, name: string, language: SupportedLanguages) => boolean;

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

@@ -0,0 +1,230 @@
+/**
+ * Export Detection
+ *
+ * Determines whether a symbol (function, class, etc.) is exported/public
+ * in its language. This is a pure function — safe for use in worker threads.
+ *
+ * Shared between parse-worker.ts (worker pool) and parsing-processor.ts (sequential fallback).
+ */
+import { findSiblingChild } from './utils.js';
+import { SupportedLanguages } from '../../config/supported-languages.js';
+// ============================================================================
+// Per-language export checkers
+// ============================================================================
+/** JS/TS: walk ancestors looking for export_statement or export_specifier. */
+const tsExportChecker = (node, _name) => {
+    let current = node;
+    while (current) {
+        const type = current.type;
+        if (type === 'export_statement' ||
+            type === 'export_specifier' ||
+            (type === 'lexical_declaration' && current.parent?.type === 'export_statement')) {
+            return true;
+        }
+        // Fallback: check if node text starts with 'export ' for edge cases
+        if (current.text?.startsWith('export ')) {
+            return true;
+        }
+        current = current.parent;
+    }
+    return false;
+};
+/** Python: public if no leading underscore (convention). */
+const pythonExportChecker = (_node, name) => !name.startsWith('_');
+/** Java: check for 'public' modifier — modifiers are siblings of the name node, not parents. */
+const javaExportChecker = (node, _name) => {
+    let current = node;
+    while (current) {
+        if (current.parent) {
+            const parent = current.parent;
+            for (let i = 0; i < parent.childCount; i++) {
+                const child = parent.child(i);
+                if (child?.type === 'modifiers' && child.text?.includes('public')) {
+                    return true;
+                }
+            }
+            if (parent.type === 'method_declaration' || parent.type === 'constructor_declaration') {
+                if (parent.text?.trimStart().startsWith('public')) {
+                    return true;
+                }
+            }
+        }
+        current = current.parent;
+    }
+    return false;
+};
+/** C# declaration node types for sibling modifier scanning. */
+const CSHARP_DECL_TYPES = new Set([
+    'method_declaration', 'local_function_statement', 'constructor_declaration',
+    'class_declaration', 'interface_declaration', 'struct_declaration',
+    'enum_declaration', 'record_declaration', 'record_struct_declaration',
+    'record_class_declaration', 'delegate_declaration',
+    'property_declaration', 'field_declaration', 'event_declaration',
+    'namespace_declaration', 'file_scoped_namespace_declaration',
+]);
+/**
+ * C#: modifier nodes are SIBLINGS of the name node inside the declaration.
+ * Walk up to the declaration node, then scan its direct children.
+ */
+const csharpExportChecker = (node, _name) => {
+    let current = node;
+    while (current) {
+        if (CSHARP_DECL_TYPES.has(current.type)) {
+            for (let i = 0; i < current.childCount; i++) {
+                const child = current.child(i);
+                if (child?.type === 'modifier' && child.text === 'public')
+                    return true;
+            }
+            return false;
+        }
+        current = current.parent;
+    }
+    return false;
+};
+/** Go: uppercase first letter = exported. */
+const goExportChecker = (_node, name) => {
+    if (name.length === 0)
+        return false;
+    const first = name[0];
+    return first === first.toUpperCase() && first !== first.toLowerCase();
+};
+/** Rust declaration node types for sibling visibility_modifier scanning. */
+const RUST_DECL_TYPES = new Set([
+    'function_item', 'struct_item', 'enum_item', 'trait_item', 'impl_item',
+    'union_item', 'type_item', 'const_item', 'static_item', 'mod_item',
+    'use_declaration', 'associated_type', 'function_signature_item',
+]);
+/**
+ * Rust: visibility_modifier is a SIBLING of the name node within the declaration node
+ * (function_item, struct_item, etc.), not a parent. Walk up to the declaration node,
+ * then scan its direct children.
+ */
+const rustExportChecker = (node, _name) => {
+    let current = node;
+    while (current) {
+        if (RUST_DECL_TYPES.has(current.type)) {
+            for (let i = 0; i < current.childCount; i++) {
+                const child = current.child(i);
+                if (child?.type === 'visibility_modifier' && child.text?.startsWith('pub'))
+                    return true;
+            }
+            return false;
+        }
+        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.
+ */
+const kotlinExportChecker = (node, _name) => {
+    let current = node;
+    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++: functions without 'static' storage class have external linkage by default,
+ * making them globally accessible (equivalent to exported). Only functions explicitly
+ * marked 'static' are file-scoped (not exported). C++ anonymous namespaces
+ * (namespace { ... }) also give internal linkage.
+ */
+const cCppExportChecker = (node, _name) => {
+    let cur = node;
+    while (cur) {
+        if (cur.type === 'function_definition' || cur.type === 'declaration') {
+            // Check for 'static' storage class specifier as a direct child node.
+            // This avoids reading the full function text (which can be very large).
+            for (let i = 0; i < cur.childCount; i++) {
+                const child = cur.child(i);
+                if (child?.type === 'storage_class_specifier' && child.text === 'static')
+                    return false;
+            }
+        }
+        // C++ anonymous namespace: namespace_definition with no name child = internal linkage
+        if (cur.type === 'namespace_definition') {
+            const hasName = cur.childForFieldName?.('name');
+            if (!hasName)
+                return false;
+        }
+        cur = cur.parent;
+    }
+    return true; // Top-level C/C++ functions default to external linkage
+};
+/** PHP: check for visibility modifier or top-level scope. */
+const phpExportChecker = (node, _name) => {
+    let current = node;
+    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 are globally accessible
+    return true;
+};
+/** Swift: check for 'public' or 'open' access modifiers. */
+const swiftExportChecker = (node, _name) => {
+    let current = node;
+    while (current) {
+        if (current.type === 'modifiers' || current.type === 'visibility_modifier') {
+            const text = current.text || '';
+            if (text.includes('public') || text.includes('open'))
+                return true;
+        }
+        current = current.parent;
+    }
+    return false;
+};
+// ============================================================================
+// Exhaustive dispatch table — satisfies enforces all SupportedLanguages are covered
+// ============================================================================
+const exportCheckers = {
+    [SupportedLanguages.JavaScript]: tsExportChecker,
+    [SupportedLanguages.TypeScript]: tsExportChecker,
+    [SupportedLanguages.Python]: pythonExportChecker,
+    [SupportedLanguages.Java]: javaExportChecker,
+    [SupportedLanguages.CSharp]: csharpExportChecker,
+    [SupportedLanguages.Go]: goExportChecker,
+    [SupportedLanguages.Rust]: rustExportChecker,
+    [SupportedLanguages.Kotlin]: kotlinExportChecker,
+    [SupportedLanguages.C]: cCppExportChecker,
+    [SupportedLanguages.CPlusPlus]: cCppExportChecker,
+    [SupportedLanguages.PHP]: phpExportChecker,
+    [SupportedLanguages.Swift]: swiftExportChecker,
+};
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Check if a tree-sitter node is exported/public in its language.
+ * @param node - The tree-sitter AST node
+ * @param name - The symbol name
+ * @param language - The programming language
+ * @returns true if the symbol is exported/public
+ */
+export const isNodeExported = (node, name, language) => {
+    const checker = exportCheckers[language];
+    if (!checker)
+        return false;
+    return checker(node, name);
+};

package/dist/core/ingestion/framework-detection.d.ts

@@ -33,6 +33,9 @@ export declare const FRAMEWORK_AST_PATTERNS: {
     spring: string[];
     jaxrs: string[];
     aspnet: string[];
+    signalr: string[];
+    blazor: string[];
+    efcore: string[];
     'go-http': string[];
     laravel: string[];
     actix: string[];
@@ -42,9 +45,10 @@ export declare const FRAMEWORK_AST_PATTERNS: {
     swiftui: string[];
     combine: string[];
 };
+import { SupportedLanguages } from '../../config/supported-languages.js';
 /**
  * Detect framework entry points from AST definition text (decorators/annotations/attributes).
  * Returns null if no known pattern is found.
  * Note: callers should slice definitionText to ~300 chars since annotations appear at the start.
  */
-export declare function detectFrameworkFromAST(language: string, definitionText: string): FrameworkHint | null;
+export declare function detectFrameworkFromAST(language: SupportedLanguages, definitionText: string): FrameworkHint | null;

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

@@ -140,6 +140,29 @@ export function detectFrameworkFromPath(filePath) {
     if (p.endsWith('controller.cs')) {
         return { framework: 'aspnet', entryPointMultiplier: 3.0, reason: 'aspnet-controller-file' };
     }
+    // ASP.NET Services
+    if ((p.includes('/services/') || p.includes('/service/')) && p.endsWith('.cs')) {
+        return { framework: 'aspnet', entryPointMultiplier: 1.8, reason: 'aspnet-service' };
+    }
+    // ASP.NET Middleware
+    if (p.includes('/middleware/') && p.endsWith('.cs')) {
+        return { framework: 'aspnet', entryPointMultiplier: 2.5, reason: 'aspnet-middleware' };
+    }
+    // SignalR Hubs
+    if (p.includes('/hubs/') && p.endsWith('.cs')) {
+        return { framework: 'signalr', entryPointMultiplier: 2.5, reason: 'signalr-hub' };
+    }
+    if (p.endsWith('hub.cs')) {
+        return { framework: 'signalr', entryPointMultiplier: 2.5, reason: 'signalr-hub-file' };
+    }
+    // Minimal API / Program.cs / Startup.cs
+    if (p.endsWith('/program.cs') || p.endsWith('/startup.cs')) {
+        return { framework: 'aspnet', entryPointMultiplier: 3.0, reason: 'aspnet-entry' };
+    }
+    // Background services / Hosted services
+    if ((p.includes('/backgroundservices/') || p.includes('/hostedservices/')) && p.endsWith('.cs')) {
+        return { framework: 'aspnet', entryPointMultiplier: 2.0, reason: 'aspnet-background-service' };
+    }
     // Blazor pages
     if (p.includes('/pages/') && p.endsWith('.razor')) {
         return { framework: 'blazor', entryPointMultiplier: 2.5, reason: 'blazor-page' };
@@ -296,7 +319,11 @@ export const FRAMEWORK_AST_PATTERNS = {
     'spring': ['@RestController', '@Controller', '@GetMapping', '@PostMapping', '@RequestMapping'],
     'jaxrs': ['@Path', '@GET', '@POST', '@PUT', '@DELETE'],
     // C# attributes
-    'aspnet': ['[ApiController]', '[HttpGet]', '[HttpPost]', '[Route]'],
+    'aspnet': ['[ApiController]', '[HttpGet]', '[HttpPost]', '[HttpPut]', '[HttpDelete]',
+        '[Route]', '[Authorize]', '[AllowAnonymous]'],
+    'signalr': ['[HubMethodName]', ': Hub', ': Hub<'],
+    'blazor': ['@page', '[Parameter]', '@inject'],
+    'efcore': ['DbContext', 'DbSet<', 'OnModelCreating'],
     // Go patterns (function signatures)
     'go-http': ['http.Handler', 'http.HandlerFunc', 'ServeHTTP'],
     // PHP/Laravel
@@ -311,31 +338,35 @@ export const FRAMEWORK_AST_PATTERNS = {
     'swiftui': ['@main', 'WindowGroup', 'ContentView', '@StateObject', '@ObservedObject'],
     'combine': ['sink', 'assign', 'Publisher', 'Subscriber'],
 };
+import { SupportedLanguages } from '../../config/supported-languages.js';
 const AST_FRAMEWORK_PATTERNS_BY_LANGUAGE = {
-    javascript: [
+    [SupportedLanguages.JavaScript]: [
         { framework: 'nestjs', entryPointMultiplier: 3.2, reason: 'nestjs-decorator', patterns: FRAMEWORK_AST_PATTERNS.nestjs },
     ],
-    typescript: [
+    [SupportedLanguages.TypeScript]: [
         { framework: 'nestjs', entryPointMultiplier: 3.2, reason: 'nestjs-decorator', patterns: FRAMEWORK_AST_PATTERNS.nestjs },
     ],
-    python: [
+    [SupportedLanguages.Python]: [
         { framework: 'fastapi', entryPointMultiplier: 3.0, reason: 'fastapi-decorator', patterns: FRAMEWORK_AST_PATTERNS.fastapi },
         { framework: 'flask', entryPointMultiplier: 2.8, reason: 'flask-decorator', patterns: FRAMEWORK_AST_PATTERNS.flask },
     ],
-    java: [
+    [SupportedLanguages.Java]: [
         { framework: 'spring', entryPointMultiplier: 3.2, reason: 'spring-annotation', patterns: FRAMEWORK_AST_PATTERNS.spring },
         { framework: 'jaxrs', entryPointMultiplier: 3.0, reason: 'jaxrs-annotation', patterns: FRAMEWORK_AST_PATTERNS.jaxrs },
     ],
-    kotlin: [
+    [SupportedLanguages.Kotlin]: [
         { framework: 'spring-kotlin', entryPointMultiplier: 3.2, reason: 'spring-kotlin-annotation', patterns: FRAMEWORK_AST_PATTERNS.spring },
         { framework: 'jaxrs', entryPointMultiplier: 3.0, reason: 'jaxrs-annotation', patterns: FRAMEWORK_AST_PATTERNS.jaxrs },
         { framework: 'ktor', entryPointMultiplier: 2.8, reason: 'ktor-routing', patterns: ['routing', 'embeddedServer', 'Application.module'] },
         { framework: 'android-kotlin', entryPointMultiplier: 2.5, reason: 'android-annotation', patterns: ['@AndroidEntryPoint', 'AppCompatActivity', 'Fragment('] },
     ],
-    csharp: [
+    [SupportedLanguages.CSharp]: [
         { framework: 'aspnet', entryPointMultiplier: 3.2, reason: 'aspnet-attribute', patterns: FRAMEWORK_AST_PATTERNS.aspnet },
+        { framework: 'signalr', entryPointMultiplier: 2.8, reason: 'signalr-attribute', patterns: FRAMEWORK_AST_PATTERNS.signalr },
+        { framework: 'blazor', entryPointMultiplier: 2.5, reason: 'blazor-attribute', patterns: FRAMEWORK_AST_PATTERNS.blazor },
+        { framework: 'efcore', entryPointMultiplier: 2.0, reason: 'efcore-pattern', patterns: FRAMEWORK_AST_PATTERNS.efcore },
     ],
-    php: [
+    [SupportedLanguages.PHP]: [
         { framework: 'laravel', entryPointMultiplier: 3.0, reason: 'php-route-attribute', patterns: FRAMEWORK_AST_PATTERNS.laravel },
     ],
 };

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

@@ -2,19 +2,28 @@
  * Heritage Processor
  *
  * Extracts class inheritance relationships:
- * - EXTENDS: Class extends another Class (TS, JS, Python)
- * - IMPLEMENTS: Class implements an Interface (TS only)
+ * - EXTENDS: Class extends another Class (TS, JS, Python, C#, C++)
+ * - IMPLEMENTS: Class implements an Interface (TS, C#, Java, Kotlin, PHP)
+ *
+ * Languages like C# use a single `base_list` for both class and interface parents.
+ * We resolve the correct edge type by checking the symbol table: if the parent is
+ * registered as an Interface, we emit IMPLEMENTS; otherwise EXTENDS. For unresolved
+ * external symbols, the fallback heuristic is language-gated:
+ *   - C# / Java: apply the `I[A-Z]` naming convention (e.g. IDisposable → IMPLEMENTS)
+ *   - Swift: default to IMPLEMENTS (protocol conformance is more common than class inheritance)
+ *   - All other languages: default to EXTENDS
  */
 import { KnowledgeGraph } from '../graph/types.js';
 import { ASTCache } from './ast-cache.js';
 import { SymbolTable } from './symbol-table.js';
 import type { ExtractedHeritage } from './workers/parse-worker.js';
+import type { ImportMap, PackageMap } from './import-processor.js';
 export declare const processHeritage: (graph: KnowledgeGraph, files: {
     path: string;
     content: string;
-}[], astCache: ASTCache, symbolTable: SymbolTable, onProgress?: (current: number, total: number) => void) => Promise<void>;
+}[], astCache: ASTCache, symbolTable: SymbolTable, importMap: ImportMap, packageMap?: PackageMap, onProgress?: (current: number, total: number) => void) => Promise<void>;
 /**
  * Fast path: resolve pre-extracted heritage from workers.
  * No AST parsing — workers already extracted className + parentName + kind.
  */
-export declare const processHeritageFromExtracted: (graph: KnowledgeGraph, extractedHeritage: ExtractedHeritage[], symbolTable: SymbolTable, onProgress?: (current: number, total: number) => void) => Promise<void>;
+export declare const processHeritageFromExtracted: (graph: KnowledgeGraph, extractedHeritage: ExtractedHeritage[], symbolTable: SymbolTable, importMap: ImportMap, packageMap?: PackageMap, onProgress?: (current: number, total: number) => void) => Promise<void>;