gitnexus 1.4.10 → 1.5.0

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,