feat(core): add CallerInfo and CalleeInfo types for relationship tracking

Add types to support call graph extraction:
- CallerInfo: name, file, line for functions that call this component
- CalleeInfo: name, file (optional), line for functions this component calls
- Add callees field to DocumentMetadata
- Export new types from scanner module
- Update document preparation to include callees

Note: Callers are computed at query time via reverse lookup of callees.

Part of #80

Author: prosdev

packages/core/src/indexer/utils/documents.ts

@@ -41,6 +41,7 @@ export function prepareDocumentsForEmbedding(documents: Document[]): EmbeddingDo
       docstring: doc.metadata.docstring,
       snippet: doc.metadata.snippet,
       imports: doc.metadata.imports,
+      callees: doc.metadata.callees,
     },
   }));
 }
@@ -76,6 +77,7 @@ export function prepareDocumentForEmbedding(doc: Document): EmbeddingDocument {
       docstring: doc.metadata.docstring,
       snippet: doc.metadata.snippet,
       imports: doc.metadata.imports,
+      callees: doc.metadata.callees,
     },
   };
 }

packages/core/src/scanner/index.ts

@@ -3,6 +3,8 @@
 export { MarkdownScanner } from './markdown';
 export { ScannerRegistry } from './registry';
 export type {
+  CalleeInfo,
+  CallerInfo,
   Document,
   DocumentMetadata,
   DocumentType,

packages/core/src/scanner/types.ts

@@ -9,6 +9,30 @@ export type DocumentType =
   | 'method'
   | 'documentation';
 
+/**
+ * Information about a function/method that calls this component
+ */
+export interface CallerInfo {
+  /** Name of the calling function/method */
+  name: string;
+  /** File path where the call originates */
+  file: string;
+  /** Line number of the call site */
+  line: number;
+}
+
+/**
+ * Information about a function/method called by this component
+ */
+export interface CalleeInfo {
+  /** Name of the called function/method */
+  name: string;
+  /** File path of the called function (if resolved) */
+  file?: string;
+  /** Line number of the call within this component */
+  line: number;
+}
+
 export interface Document {
   id: string; // Unique identifier: file:name:line
   text: string; // Text to embed (for vector search)
@@ -29,6 +53,10 @@ export interface DocumentMetadata {
   snippet?: string; // Actual code content (truncated if large)
   imports?: string[]; // File-level imports (module specifiers)
 
+  // Relationship data (call graph)
+  callees?: CalleeInfo[]; // Functions/methods this component calls
+  // Note: callers are computed at query time via reverse lookup
+
   // Extensible for future use
   custom?: Record<string, unknown>;
 }

packages/core/src/vector/types.ts

@@ -2,7 +2,7 @@
  * Vector storage and embedding types
  */
 
-import type { DocumentType } from '../scanner/types';
+import type { CalleeInfo, DocumentType } from '../scanner/types';
 
 /**
  * Document to be embedded and stored
@@ -33,6 +33,7 @@ export interface SearchResultMetadata {
   docstring?: string; // Documentation comment
   snippet?: string; // Actual code content (truncated if large)
   imports?: string[]; // File-level imports (module specifiers)
+  callees?: CalleeInfo[]; // Functions/methods this component calls
   // Allow additional custom fields for extensibility (e.g., GitHub indexer uses 'document')
   [key: string]: unknown;
 }