gitnexus 1.4.10 → 1.5.1

package/dist/config/supported-languages.d.ts

@@ -1,47 +1,13 @@
 /**
+ * Re-export SupportedLanguages from gitnexus-shared (single source of truth).
+ *
  * HOW TO ADD A NEW LANGUAGE:
  *
- * 1. Add the enum member below (e.g., Scala = 'scala')
+ * 1. Add the enum member in gitnexus-shared/src/languages.ts
  * 2. Run `tsc --noEmit` — compiler errors guide you to every dispatch table
- * 3. Use this checklist for each file:
- *
- *    FILE                              | WHAT TO ADD                              | DEFAULT (simple languages)
- *    ----------------------------------|------------------------------------------|---------------------------
- *    tree-sitter-queries.ts            | Query string + LANGUAGE_QUERIES entry    | (required)
- *    export-detection.ts               | ExportChecker function + table entry     | (required)
- *    import-resolvers/<lang>.ts        | Exported resolve<Lang>Import function    | resolveStandard(...)
- *    call-routing.ts                   | CallRouter function (or noRouting)       | noRouting
- *    entry-point-scoring.ts            | ENTRY_POINT_PATTERNS entry               | []
- *    framework-detection.ts            | AST_FRAMEWORK_PATTERNS entry             | []
- *    type-extractors/<lang>.ts         | New file + index.ts import               | (required)
- *    resolvers/<lang>.ts               | Resolver file (if non-standard)          | (only if resolveStandard insufficient)
- *    named-bindings/<lang>.ts          | Extractor (if named imports)             | (only if language has named imports)
- *
- * 4. Also check these files for language-specific if-checks (no compile-time guard):
- *    - mro-processor.ts (MRO strategy selection)
- *    - heritage-processor.ts (extends/implements handling)
- *    - parse-worker.ts (AST edge cases)
- *    - parsing-processor.ts (node label normalization)
- *
- * 5. Add tree-sitter-<lang> to package.json dependencies
- * 6. Add file extension mapping in utils.ts getLanguageFromFilename()
- * 7. Run full test suite
+ * 3. Use the checklist in each ingestion file for what to add
+ * 4. Add tree-sitter-<lang> to gitnexus/package.json dependencies
+ * 5. Add file extension mapping in utils.ts getLanguageFromFilename()
+ * 6. Run full test suite
  */
-export declare enum SupportedLanguages {
-    JavaScript = "javascript",
-    TypeScript = "typescript",
-    Python = "python",
-    Java = "java",
-    C = "c",
-    CPlusPlus = "cpp",
-    CSharp = "csharp",
-    Go = "go",
-    Ruby = "ruby",
-    Rust = "rust",
-    PHP = "php",
-    Kotlin = "kotlin",
-    Swift = "swift",
-    Dart = "dart",
-    /** Standalone regex processor — no tree-sitter, no LanguageProvider. */
-    Cobol = "cobol"
-}
+export { SupportedLanguages } from 'gitnexus-shared';

package/dist/config/supported-languages.js

@@ -1,48 +1,13 @@
 /**
+ * Re-export SupportedLanguages from gitnexus-shared (single source of truth).
+ *
  * HOW TO ADD A NEW LANGUAGE:
  *
- * 1. Add the enum member below (e.g., Scala = 'scala')
+ * 1. Add the enum member in gitnexus-shared/src/languages.ts
  * 2. Run `tsc --noEmit` — compiler errors guide you to every dispatch table
- * 3. Use this checklist for each file:
- *
- *    FILE                              | WHAT TO ADD                              | DEFAULT (simple languages)
- *    ----------------------------------|------------------------------------------|---------------------------
- *    tree-sitter-queries.ts            | Query string + LANGUAGE_QUERIES entry    | (required)
- *    export-detection.ts               | ExportChecker function + table entry     | (required)
- *    import-resolvers/<lang>.ts        | Exported resolve<Lang>Import function    | resolveStandard(...)
- *    call-routing.ts                   | CallRouter function (or noRouting)       | noRouting
- *    entry-point-scoring.ts            | ENTRY_POINT_PATTERNS entry               | []
- *    framework-detection.ts            | AST_FRAMEWORK_PATTERNS entry             | []
- *    type-extractors/<lang>.ts         | New file + index.ts import               | (required)
- *    resolvers/<lang>.ts               | Resolver file (if non-standard)          | (only if resolveStandard insufficient)
- *    named-bindings/<lang>.ts          | Extractor (if named imports)             | (only if language has named imports)
- *
- * 4. Also check these files for language-specific if-checks (no compile-time guard):
- *    - mro-processor.ts (MRO strategy selection)
- *    - heritage-processor.ts (extends/implements handling)
- *    - parse-worker.ts (AST edge cases)
- *    - parsing-processor.ts (node label normalization)
- *
- * 5. Add tree-sitter-<lang> to package.json dependencies
- * 6. Add file extension mapping in utils.ts getLanguageFromFilename()
- * 7. Run full test suite
+ * 3. Use the checklist in each ingestion file for what to add
+ * 4. Add tree-sitter-<lang> to gitnexus/package.json dependencies
+ * 5. Add file extension mapping in utils.ts getLanguageFromFilename()
+ * 6. Run full test suite
  */
-export var SupportedLanguages;
-(function (SupportedLanguages) {
-    SupportedLanguages["JavaScript"] = "javascript";
-    SupportedLanguages["TypeScript"] = "typescript";
-    SupportedLanguages["Python"] = "python";
-    SupportedLanguages["Java"] = "java";
-    SupportedLanguages["C"] = "c";
-    SupportedLanguages["CPlusPlus"] = "cpp";
-    SupportedLanguages["CSharp"] = "csharp";
-    SupportedLanguages["Go"] = "go";
-    SupportedLanguages["Ruby"] = "ruby";
-    SupportedLanguages["Rust"] = "rust";
-    SupportedLanguages["PHP"] = "php";
-    SupportedLanguages["Kotlin"] = "kotlin";
-    SupportedLanguages["Swift"] = "swift";
-    SupportedLanguages["Dart"] = "dart";
-    /** Standalone regex processor — no tree-sitter, no LanguageProvider. */
-    SupportedLanguages["Cobol"] = "cobol";
-})(SupportedLanguages || (SupportedLanguages = {}));
+export { SupportedLanguages } from 'gitnexus-shared';

package/dist/core/augmentation/engine.js

@@ -114,16 +114,20 @@ export async function augment(pattern, cwd) {
                     });
                 }
             }
-            catch { /* skip */ }
+            catch {
+                /* skip */
+            }
         }
         if (symbolMatches.length === 0)
             return '';
         // Step 3: Batch-fetch callers/callees/processes/cohesion for top matches
         // Uses batched WHERE n.id IN [...] queries instead of per-symbol queries
-        const uniqueSymbols = symbolMatches.slice(0, 5).filter((sym, i, arr) => arr.findIndex(s => s.nodeId === sym.nodeId) === i);
+        const uniqueSymbols = symbolMatches
+            .slice(0, 5)
+            .filter((sym, i, arr) => arr.findIndex((s) => s.nodeId === sym.nodeId) === i);
         if (uniqueSymbols.length === 0)
             return '';
-        const idList = uniqueSymbols.map(s => `'${s.nodeId.replace(/'/g, "''")}'`).join(', ');
+        const idList = uniqueSymbols.map((s) => `'${s.nodeId.replace(/'/g, "''")}'`).join(', ');
         // Batch fetch callers
         const callersMap = new Map();
         try {
@@ -143,7 +147,9 @@ export async function augment(pattern, cwd) {
                 }
             }
         }
-        catch { /* skip */ }
+        catch {
+            /* skip */
+        }
         // Batch fetch callees
         const calleesMap = new Map();
         try {
@@ -163,7 +169,9 @@ export async function augment(pattern, cwd) {
                 }
             }
         }
-        catch { /* skip */ }
+        catch {
+            /* skip */
+        }
         // Batch fetch processes
         const processesMap = new Map();
         try {
@@ -184,7 +192,9 @@ export async function augment(pattern, cwd) {
                 }
             }
         }
-        catch { /* skip */ }
+        catch {
+            /* skip */
+        }
         // Batch fetch cohesion
         const cohesionMap = new Map();
         try {
@@ -200,7 +210,9 @@ export async function augment(pattern, cwd) {
                     cohesionMap.set(nid, coh);
             }
         }
-        catch { /* skip */ }
+        catch {
+            /* skip */
+        }
         // Assemble enriched results
         const enriched = [];
         for (const sym of uniqueSymbols) {

package/dist/core/embeddings/embedder.js

@@ -125,8 +125,8 @@ export const initEmbedder = async (onProgress, config = {}, forceDevice) => {
     // Probe for CUDA first — ONNX Runtime crashes (uncatchable native error)
     // if we attempt CUDA without the required shared libraries
     const isWindows = process.platform === 'win32';
-    const gpuDevice = isWindows ? 'dml' : (isCudaAvailable() ? 'cuda' : 'cpu');
-    let requestedDevice = forceDevice || (finalConfig.device === 'auto' ? gpuDevice : finalConfig.device);
+    const gpuDevice = isWindows ? 'dml' : isCudaAvailable() ? 'cuda' : 'cpu';
+    const requestedDevice = forceDevice || (finalConfig.device === 'auto' ? gpuDevice : finalConfig.device);
     initPromise = (async () => {
         try {
             // Configure transformers.js environment
@@ -135,19 +135,21 @@ export const initEmbedder = async (onProgress, config = {}, forceDevice) => {
             if (isDev) {
                 console.log(`🧠 Loading embedding model: ${finalConfig.modelId}`);
             }
-            const progressCallback = onProgress ? (data) => {
-                const progress = {
-                    status: data.status || 'progress',
-                    file: data.file,
-                    progress: data.progress,
-                    loaded: data.loaded,
-                    total: data.total,
-                };
-                onProgress(progress);
-            } : undefined;
+            const progressCallback = onProgress
+                ? (data) => {
+                    const progress = {
+                        status: data.status || 'progress',
+                        file: data.file,
+                        progress: data.progress,
+                        loaded: data.loaded,
+                        total: data.total,
+                    };
+                    onProgress(progress);
+                }
+                : undefined;
             // Try GPU first if auto, fall back to CPU
             // Windows: dml (DirectML/DirectX12), Linux: cuda
-            const devicesToTry = (requestedDevice === 'dml' || requestedDevice === 'cuda')
+            const devicesToTry = requestedDevice === 'dml' || requestedDevice === 'cuda'
                 ? [requestedDevice, 'cpu']
                 : [requestedDevice];
             for (const device of devicesToTry) {
@@ -172,8 +174,10 @@ export const initEmbedder = async (onProgress, config = {}, forceDevice) => {
                     });
                     currentDevice = device;
                     if (isDev) {
-                        const label = device === 'dml' ? 'GPU (DirectML/DirectX12)'
-                            : device === 'cuda' ? 'GPU (CUDA)'
+                        const label = device === 'dml'
+                            ? 'GPU (DirectML/DirectX12)'
+                            : device === 'cuda'
+                                ? 'GPU (CUDA)'
                                 : device.toUpperCase();
                         console.log(`✅ Using ${label} backend`);
                         console.log('✅ Embedding model loaded successfully');

package/dist/core/embeddings/embedding-pipeline.js

@@ -8,7 +8,7 @@
  * 4. Update LadybugDB with embeddings
  * 5. Create vector index for semantic search
  */
-import { initEmbedder, embedBatch, embedText, embeddingToArray, isEmbedderReady } from './embedder.js';
+import { initEmbedder, embedBatch, embedText, embeddingToArray, isEmbedderReady, } from './embedder.js';
 import { generateBatchEmbeddingTexts } from './text-generator.js';
 import { DEFAULT_EMBEDDING_CONFIG, EMBEDDABLE_LABELS, } from './types.js';
 const isDev = process.env.NODE_ENV === 'development';
@@ -69,7 +69,7 @@ const queryEmbeddableNodes = async (executeQuery) => {
 const batchInsertEmbeddings = async (executeWithReusedStatement, updates) => {
     // INSERT into separate embedding table - much more memory efficient!
     const cypher = `CREATE (e:CodeEmbedding {nodeId: $nodeId, embedding: $embedding})`;
-    const paramsList = updates.map(u => ({ nodeId: u.id, embedding: u.embedding }));
+    const paramsList = updates.map((u) => ({ nodeId: u.id, embedding: u.embedding }));
     await executeWithReusedStatement(cypher, paramsList);
 };
 /**
@@ -144,7 +144,7 @@ export const runEmbeddingPipeline = async (executeQuery, executeWithReusedStatem
         // Incremental mode: filter out nodes that already have embeddings
         if (skipNodeIds && skipNodeIds.size > 0) {
             const beforeCount = nodes.length;
-            nodes = nodes.filter(n => !skipNodeIds.has(n.id));
+            nodes = nodes.filter((n) => !skipNodeIds.has(n.id));
             if (isDev) {
                 console.log(`📦 Incremental embeddings: ${beforeCount} total, ${skipNodeIds.size} cached, ${nodes.length} to embed`);
             }
@@ -190,7 +190,7 @@ export const runEmbeddingPipeline = async (executeQuery, executeWithReusedStatem
             await batchInsertEmbeddings(executeWithReusedStatement, updates);
             processedNodes += batch.length;
             // Report progress (20-90% for embedding phase)
-            const embeddingProgress = 20 + ((processedNodes / totalNodes) * 70);
+            const embeddingProgress = 20 + (processedNodes / totalNodes) * 70;
             onProgress({
                 phase: 'embedding',
                 percent: Math.round(embeddingProgress),
@@ -282,7 +282,7 @@ export const semanticSearch = async (executeQuery, query, k = 10, maxDistance =
     // Batch-fetch metadata per label
     const results = [];
     for (const [label, items] of byLabel) {
-        const idList = items.map(i => `'${i.nodeId.replace(/'/g, "''")}'`).join(', ');
+        const idList = items.map((i) => `'${i.nodeId.replace(/'/g, "''")}'`).join(', ');
         try {
             let nodeQuery;
             if (label === 'File') {
@@ -344,7 +344,7 @@ export const semanticSearchWithContext = async (executeQuery, query, k = 5, _hop
     // For multi-table schema, just return semantic search results
     // Graph traversal is complex with separate tables - use execute_vector_cypher instead
     const results = await semanticSearch(executeQuery, query, k, 0.5);
-    return results.map(r => ({
+    return results.map((r) => ({
         matchId: r.nodeId,
         matchName: r.name,
         matchLabel: r.label,

package/dist/core/embeddings/http-client.js

@@ -75,7 +75,7 @@ const httpEmbedBatch = async (url, batch, model, apiKey, batchIndex = 0, attempt
             signal: AbortSignal.timeout(HTTP_TIMEOUT_MS),
             headers: {
                 'Content-Type': 'application/json',
-                'Authorization': `Bearer ${apiKey}`,
+                Authorization: `Bearer ${apiKey}`,
             },
             body: JSON.stringify({ input: batch, model }),
         });
@@ -90,7 +90,7 @@ const httpEmbedBatch = async (url, batch, model, apiKey, batchIndex = 0, attempt
         // DNS, connection errors — retry with backoff
         if (attempt < HTTP_MAX_RETRIES) {
             const delay = HTTP_RETRY_BACKOFF_MS * (attempt + 1);
-            await new Promise(r => setTimeout(r, delay));
+            await new Promise((r) => setTimeout(r, delay));
             return httpEmbedBatch(url, batch, model, apiKey, batchIndex, attempt + 1);
         }
         const reason = err instanceof Error ? err.message : String(err);
@@ -100,7 +100,7 @@ const httpEmbedBatch = async (url, batch, model, apiKey, batchIndex = 0, attempt
         const status = resp.status;
         if ((status === 429 || status >= 500) && attempt < HTTP_MAX_RETRIES) {
             const delay = HTTP_RETRY_BACKOFF_MS * (attempt + 1);
-            await new Promise(r => setTimeout(r, delay));
+            await new Promise((r) => setTimeout(r, delay));
             return httpEmbedBatch(url, batch, model, apiKey, batchIndex, attempt + 1);
         }
         throw new Error(`Embedding endpoint returned ${status} (${safeUrl(url)}, batch ${batchIndex})`);

package/dist/core/embeddings/text-generator.js

@@ -40,25 +40,22 @@ const truncateContent = (content, maxLength) => {
  * Removes excessive whitespace while preserving structure
  */
 const cleanContent = (content) => {
-    return content
+    return (content
         // Normalize line endings
         .replace(/\r\n/g, '\n')
         // Remove excessive blank lines (more than 2)
         .replace(/\n{3,}/g, '\n\n')
         // Trim each line
         .split('\n')
-        .map(line => line.trimEnd())
+        .map((line) => line.trimEnd())
         .join('\n')
-        .trim();
+        .trim());
 };
 /**
  * Generate embedding text for a Function node
  */
 const generateFunctionText = (node, maxSnippetLength) => {
-    const parts = [
-        `Function: ${node.name}`,
-        `File: ${getFileName(node.filePath)}`,
-    ];
+    const parts = [`Function: ${node.name}`, `File: ${getFileName(node.filePath)}`];
     const dir = getDirectory(node.filePath);
     if (dir) {
         parts.push(`Directory: ${dir}`);
@@ -74,10 +71,7 @@ const generateFunctionText = (node, maxSnippetLength) => {
  * Generate embedding text for a Class node
  */
 const generateClassText = (node, maxSnippetLength) => {
-    const parts = [
-        `Class: ${node.name}`,
-        `File: ${getFileName(node.filePath)}`,
-    ];
+    const parts = [`Class: ${node.name}`, `File: ${getFileName(node.filePath)}`];
     const dir = getDirectory(node.filePath);
     if (dir) {
         parts.push(`Directory: ${dir}`);
@@ -93,10 +87,7 @@ const generateClassText = (node, maxSnippetLength) => {
  * Generate embedding text for a Method node
  */
 const generateMethodText = (node, maxSnippetLength) => {
-    const parts = [
-        `Method: ${node.name}`,
-        `File: ${getFileName(node.filePath)}`,
-    ];
+    const parts = [`Method: ${node.name}`, `File: ${getFileName(node.filePath)}`];
     const dir = getDirectory(node.filePath);
     if (dir) {
         parts.push(`Directory: ${dir}`);
@@ -112,10 +103,7 @@ const generateMethodText = (node, maxSnippetLength) => {
  * Generate embedding text for an Interface node
  */
 const generateInterfaceText = (node, maxSnippetLength) => {
-    const parts = [
-        `Interface: ${node.name}`,
-        `File: ${getFileName(node.filePath)}`,
-    ];
+    const parts = [`Interface: ${node.name}`, `File: ${getFileName(node.filePath)}`];
     const dir = getDirectory(node.filePath);
     if (dir) {
         parts.push(`Directory: ${dir}`);
@@ -132,10 +120,7 @@ const generateInterfaceText = (node, maxSnippetLength) => {
  * Uses file name and first N characters of content
  */
 const generateFileText = (node, maxSnippetLength) => {
-    const parts = [
-        `File: ${node.name}`,
-        `Path: ${node.filePath}`,
-    ];
+    const parts = [`File: ${node.name}`, `Path: ${node.filePath}`];
     if (node.content) {
         const cleanedContent = cleanContent(node.content);
         // For files, use a shorter snippet since they can be very long
@@ -178,5 +163,5 @@ export const generateEmbeddingText = (node, config = {}) => {
  * @returns Array of texts in the same order as input nodes
  */
 export const generateBatchEmbeddingTexts = (nodes, config = {}) => {
-    return nodes.map(node => generateEmbeddingText(node, config));
+    return nodes.map((node) => generateEmbeddingText(node, config));
 };

package/dist/core/embeddings/types.d.ts

@@ -8,7 +8,7 @@
  * These are code elements that benefit from semantic matching
  */
 export declare const EMBEDDABLE_LABELS: readonly ["Function", "Class", "Method", "Interface", "File"];
-export type EmbeddableLabel = typeof EMBEDDABLE_LABELS[number];
+export type EmbeddableLabel = (typeof EMBEDDABLE_LABELS)[number];
 /**
  * Check if a label should be embedded
  */

package/dist/core/embeddings/types.js

@@ -7,13 +7,7 @@
  * Node labels that should be embedded for semantic search
  * These are code elements that benefit from semantic matching
  */
-export const EMBEDDABLE_LABELS = [
-    'Function',
-    'Class',
-    'Method',
-    'Interface',
-    'File',
-];
+export const EMBEDDABLE_LABELS = ['Function', 'Class', 'Method', 'Interface', 'File'];
 /**
  * Check if a label should be embedded
  */

package/dist/core/graph/graph.js

@@ -55,8 +55,12 @@ export const createKnowledgeGraph = () => {
         },
         iterNodes: () => nodeMap.values(),
         iterRelationships: () => relationshipMap.values(),
-        forEachNode(fn) { nodeMap.forEach(fn); },
-        forEachRelationship(fn) { relationshipMap.forEach(fn); },
+        forEachNode(fn) {
+            nodeMap.forEach(fn);
+        },
+        forEachRelationship(fn) {
+            relationshipMap.forEach(fn);
+        },
         getNode: (id) => nodeMap.get(id),
         // O(1) count getters - avoid creating arrays just for length
         get nodeCount() {

package/dist/core/graph/types.d.ts

@@ -1,69 +1,19 @@
-export type NodeLabel = 'Project' | 'Package' | 'Module' | 'Folder' | 'File' | 'Class' | 'Function' | 'Method' | 'Variable' | 'Interface' | 'Enum' | 'Decorator' | 'Import' | 'Type' | 'CodeElement' | 'Community' | 'Process' | 'Struct' | 'Macro' | 'Typedef' | 'Union' | 'Namespace' | 'Trait' | 'Impl' | 'TypeAlias' | 'Const' | 'Static' | 'Property' | 'Record' | 'Delegate' | 'Annotation' | 'Constructor' | 'Template' | 'Section' | 'Route' | 'Tool';
-import { SupportedLanguages } from '../../config/supported-languages.js';
-export type NodeProperties = {
-    name: string;
-    filePath: string;
-    startLine?: number;
-    endLine?: number;
-    language?: SupportedLanguages;
-    isExported?: boolean;
-    astFrameworkMultiplier?: number;
-    astFrameworkReason?: string;
-    heuristicLabel?: string;
-    cohesion?: number;
-    symbolCount?: number;
-    keywords?: string[];
-    description?: string;
-    enrichedBy?: 'heuristic' | 'llm';
-    processType?: 'intra_community' | 'cross_community';
-    stepCount?: number;
-    communities?: string[];
-    entryPointId?: string;
-    terminalId?: string;
-    entryPointScore?: number;
-    entryPointReason?: string;
-    parameterCount?: number;
-    level?: number;
-    returnType?: string;
-    declaredType?: string;
-    visibility?: string;
-    isStatic?: boolean;
-    isReadonly?: boolean;
-    responseKeys?: string[];
-    errorKeys?: string[];
-    middleware?: string[];
-};
-export type RelationshipType = 'CONTAINS' | 'CALLS' | 'INHERITS' | 'OVERRIDES' | 'IMPORTS' | 'USES' | 'DEFINES' | 'DECORATES' | 'IMPLEMENTS' | 'EXTENDS' | 'HAS_METHOD' | 'HAS_PROPERTY' | 'ACCESSES' | 'MEMBER_OF' | 'STEP_IN_PROCESS' | 'HANDLES_ROUTE' | 'FETCHES' | 'HANDLES_TOOL' | 'ENTRY_POINT_OF' | 'WRAPS' | 'QUERIES';
-export interface GraphNode {
-    id: string;
-    label: NodeLabel;
-    properties: NodeProperties;
-}
-export interface GraphRelationship {
-    id: string;
-    sourceId: string;
-    targetId: string;
-    type: RelationshipType;
-    /** Confidence score 0-1 (1.0 = certain, lower = uncertain resolution) */
-    confidence: number;
-    /** Semantics are edge-type-dependent: CALLS uses resolution tier, ACCESSES uses 'read'/'write', OVERRIDES uses MRO reason */
-    reason: string;
-    /** Step number for STEP_IN_PROCESS relationships (1-indexed) */
-    step?: number;
-}
+/**
+ * CLI-specific graph types.
+ *
+ * Shared types (NodeLabel, GraphNode, etc.) should be imported
+ * directly from 'gitnexus-shared' at call sites.
+ *
+ * This file only defines the CLI's KnowledgeGraph with mutation methods.
+ */
+import type { GraphNode, GraphRelationship } from 'gitnexus-shared';
 export interface KnowledgeGraph {
-    /** Returns a full array copy — prefer iterNodes() for iteration */
     nodes: GraphNode[];
-    /** Returns a full array copy — prefer iterRelationships() for iteration */
     relationships: GraphRelationship[];
-    /** Zero-copy iterator over nodes */
     iterNodes: () => IterableIterator<GraphNode>;
-    /** Zero-copy iterator over relationships */
     iterRelationships: () => IterableIterator<GraphRelationship>;
-    /** Zero-copy forEach — avoids iterator protocol overhead in hot loops */
     forEachNode: (fn: (node: GraphNode) => void) => void;
     forEachRelationship: (fn: (rel: GraphRelationship) => void) => void;
-    /** Lookup a single node by id — O(1) */
     getNode: (id: string) => GraphNode | undefined;
     nodeCount: number;
     relationshipCount: number;

package/dist/core/ingestion/ast-cache.js

@@ -14,7 +14,7 @@ export const createASTCache = (maxSize = 50) => {
             catch (e) {
                 console.warn('Failed to delete tree from WASM memory', e);
             }
-        }
+        },
     });
     return {
         get: (filePath) => {
@@ -29,7 +29,7 @@ export const createASTCache = (maxSize = 50) => {
         },
         stats: () => ({
             size: cache.size,
-            maxSize: effectiveMax
-        })
+            maxSize: effectiveMax,
+        }),
     };
 };

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

@@ -42,6 +42,24 @@ export declare function seedCrossFileReceiverTypes(calls: ExtractedCall[], named
 }>>, exportedTypeMap: ReadonlyMap<string, ReadonlyMap<string, string>>): {
     enrichedCount: number;
 };
+/** Maps interface/abstract-class name → set of file paths of direct implementors. */
+export type ImplementorMap = ReadonlyMap<string, ReadonlySet<string>>;
+/**
+ * Build an ImplementorMap from extracted heritage data.
+ * Only direct `implements` relationships are tracked (transitive not needed for
+ * the common Java/Kotlin/C# interface dispatch pattern).
+ * `extends` is ignored — dispatch keyed on abstract class bases is not modeled here.
+ */
+/**
+ * Maps interface name → file paths of classes that implement it (direct only).
+ * When `ctx` is set, `kind: 'extends'` rows are classified like heritage-processor
+ * (C#/Java base_list: class vs interface parents share one capture name).
+ */
+export declare const buildImplementorMap: (heritage: readonly ExtractedHeritage[], ctx?: ResolutionContext) => Map<string, Set<string>>;
+/**
+ * Merge a chunk's implementor map into the global accumulator.
+ */
+export declare const mergeImplementorMaps: (target: Map<string, Set<string>>, source: ReadonlyMap<string, ReadonlySet<string>>) => void;
 export declare const processCalls: (graph: KnowledgeGraph, files: {
     path: string;
     content: string;
@@ -52,12 +70,12 @@ importedBindingsMap?: ReadonlyMap<string, ReadonlyMap<string, string>>,
  *  Consulted ONLY when SymbolTable has no unambiguous match (local-first principle). */
 importedReturnTypesMap?: ReadonlyMap<string, ReadonlyMap<string, string>>, 
 /** Phase 14 E3: cross-file RAW return types for for-loop element extraction. Keyed by filePath → Map<calleeName, rawReturnType>. */
-importedRawReturnTypesMap?: ReadonlyMap<string, ReadonlyMap<string, string>>) => Promise<ExtractedHeritage[]>;
+importedRawReturnTypesMap?: ReadonlyMap<string, ReadonlyMap<string, string>>, implementorMap?: ImplementorMap) => Promise<ExtractedHeritage[]>;
 /**
  * Fast path: resolve pre-extracted call sites from workers.
  * No AST parsing — workers already extracted calledName + sourceId.
  */
-export declare const processCallsFromExtracted: (graph: KnowledgeGraph, extractedCalls: ExtractedCall[], ctx: ResolutionContext, onProgress?: (current: number, total: number) => void, constructorBindings?: FileConstructorBindings[]) => Promise<void>;
+export declare const processCallsFromExtracted: (graph: KnowledgeGraph, extractedCalls: ExtractedCall[], ctx: ResolutionContext, onProgress?: (current: number, total: number) => void, constructorBindings?: FileConstructorBindings[], implementorMap?: ImplementorMap) => Promise<void>;
 /**
  * Resolve pre-extracted field write assignments to ACCESSES {reason: 'write'} edges.
  * Accepts optional constructorBindings for return-type-aware receiver inference,