@nahisaho/musubix-codegraph 2.3.0

package/dist/codegraph.js

@@ -0,0 +1,429 @@
+/**
+ * @nahisaho/musubix-codegraph - CodeGraph Facade
+ *
+ * Main entry point for code graph analysis
+ *
+ * @packageDocumentation
+ * @module @nahisaho/musubix-codegraph
+ *
+ * @see REQ-CG-API-001
+ * @see REQ-CG-API-002
+ * @see REQ-CG-API-003
+ * @see DES-CG-001
+ */
+import { DEFAULT_CODEGRAPH_OPTIONS } from './types.js';
+import { CodeGraphEventEmitter } from './events/index.js';
+/**
+ * CodeGraph - Main facade for code graph analysis
+ *
+ * Provides a unified API for:
+ * - AST parsing and entity extraction
+ * - Graph construction and querying
+ * - Dependency and call graph analysis
+ * - GraphRAG-based semantic search
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const codeGraph = new CodeGraph({ storage: 'memory' });
+ * await codeGraph.index('/path/to/repo');
+ *
+ * const deps = await codeGraph.findDependencies('UserService');
+ * const callers = await codeGraph.findCallers('authenticate');
+ * const results = await codeGraph.globalSearch('authentication');
+ * ```
+ *
+ * @see REQ-CG-API-001 - Library as standalone
+ * @see REQ-CG-API-002 - Programmatic API
+ */
+export class CodeGraph extends CodeGraphEventEmitter {
+    options;
+    storage = null;
+    initialized = false;
+    /**
+     * Create a new CodeGraph instance
+     *
+     * @param options - Configuration options
+     */
+    constructor(options = {}) {
+        super();
+        this.options = {
+            ...options,
+            parser: { ...DEFAULT_CODEGRAPH_OPTIONS.parser, ...options.parser },
+            graph: { ...DEFAULT_CODEGRAPH_OPTIONS.graph, ...options.graph },
+            indexer: { ...DEFAULT_CODEGRAPH_OPTIONS.indexer, ...options.indexer },
+            graphrag: { ...DEFAULT_CODEGRAPH_OPTIONS.graphrag, ...options.graphrag },
+        };
+    }
+    // =========================================================================
+    // Event handler shortcuts
+    // =========================================================================
+    /**
+     * Register a handler for indexing start events
+     */
+    onIndexingStart(handler) {
+        this.on('indexing:start', (data) => handler(data.path));
+        return this;
+    }
+    /**
+     * Register a handler for indexing complete events
+     */
+    onIndexingComplete(handler) {
+        this.on('indexing:complete', handler);
+        return this;
+    }
+    /**
+     * Register a handler for indexing progress events
+     */
+    onIndexingProgress(handler) {
+        this.on('indexing:progress', (data) => handler(data.processed, data.total, data.currentFile));
+        return this;
+    }
+    /**
+     * Register a handler for indexing error events
+     */
+    onIndexingError(handler) {
+        this.on('indexing:error', (data) => handler(data.error, data.file));
+        return this;
+    }
+    /**
+     * Register a handler for query start events
+     */
+    onQueryStart(handler) {
+        this.on('query:start', (data) => handler(data.query));
+        return this;
+    }
+    /**
+     * Register a handler for query complete events
+     */
+    onQueryComplete(handler) {
+        this.on('query:complete', (data) => handler(data.result, data.durationMs));
+        return this;
+    }
+    /**
+     * Initialize the CodeGraph instance
+     *
+     * @internal
+     */
+    async ensureInitialized() {
+        if (this.initialized)
+            return;
+        // Initialize storage
+        this.storage = await this.createStorage();
+        await this.storage.initialize();
+        this.initialized = true;
+    }
+    /**
+     * Create storage adapter based on options
+     *
+     * @internal
+     */
+    async createStorage() {
+        const storageOption = this.options.storage ?? 'memory';
+        if (typeof storageOption === 'object') {
+            // Custom storage adapter provided
+            return storageOption;
+        }
+        // Lazy import storage implementations
+        switch (storageOption) {
+            case 'memory': {
+                const { MemoryStorage } = await import('./storage/memory-storage.js');
+                return new MemoryStorage();
+            }
+            case 'sqlite': {
+                const { SQLiteStorage } = await import('./storage/sqlite-storage.js');
+                return new SQLiteStorage(this.options.sqlitePath ?? '.codegraph/index.db');
+            }
+            default:
+                throw new Error(`Unknown storage type: ${storageOption}`);
+        }
+    }
+    // =========================================================================
+    // Indexing Methods
+    // =========================================================================
+    /**
+     * Index a repository or directory
+     *
+     * @param path - Path to repository or directory
+     * @returns Index result with statistics
+     *
+     * @see REQ-CG-IDX-001
+     *
+     * @example
+     * ```typescript
+     * const result = await codeGraph.index('/path/to/repo');
+     * console.log(`Indexed ${result.entitiesIndexed} entities`);
+     * ```
+     */
+    async index(path) {
+        await this.ensureInitialized();
+        this.emitIndexingStart(path);
+        try {
+            const { Indexer } = await import('./indexer/index.js');
+            const { ASTParser } = await import('./parser/index.js');
+            const { GraphEngine } = await import('./graph/index.js');
+            const parser = new ASTParser(this.options.parser);
+            const graph = new GraphEngine(this.storage, this.options.graph);
+            const indexer = new Indexer(parser, graph, this.options.indexer);
+            // Set up progress tracking
+            indexer.onProgress((progress) => {
+                this.emitIndexingProgress(progress.processed, progress.total, progress.currentFile);
+            });
+            const result = await indexer.indexRepository(path);
+            this.emitIndexingComplete(result);
+            return result;
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            this.emitIndexingError(err);
+            throw err;
+        }
+    }
+    /**
+     * Reindex a repository (clear and index fresh)
+     *
+     * @param path - Path to repository or directory
+     * @returns Index result with statistics
+     */
+    async reindex(path) {
+        await this.ensureInitialized();
+        await this.storage.clear();
+        return this.index(path);
+    }
+    // =========================================================================
+    // Query Methods
+    // =========================================================================
+    /**
+     * Query the code graph
+     *
+     * @param query - Search query string or query object
+     * @returns Query result with matching entities
+     *
+     * @see REQ-CG-GRF-003
+     */
+    async query(query) {
+        await this.ensureInitialized();
+        const graphQuery = typeof query === 'string'
+            ? { textSearch: query }
+            : query;
+        this.emitQueryStart(graphQuery);
+        const startTime = Date.now();
+        const { GraphEngine } = await import('./graph/index.js');
+        const graph = new GraphEngine(this.storage, this.options.graph);
+        const result = await graph.query(graphQuery);
+        const durationMs = Date.now() - startTime;
+        this.emitQueryComplete(result, durationMs);
+        return result;
+    }
+    /**
+     * Find dependencies of an entity
+     *
+     * @param entityName - Name or ID of the entity
+     * @param options - Dependency analysis options
+     * @returns List of dependent entities
+     *
+     * @see REQ-CG-GRF-004
+     */
+    async findDependencies(entityName, options) {
+        await this.ensureInitialized();
+        const { GraphEngine } = await import('./graph/index.js');
+        const graph = new GraphEngine(this.storage, this.options.graph);
+        return graph.findDependencies(entityName, options?.depth ?? 3);
+    }
+    /**
+     * Find callers of a function or method
+     *
+     * @param entityName - Name or ID of the function/method
+     * @returns List of call paths
+     *
+     * @see REQ-CG-GRF-005
+     */
+    async findCallers(entityName) {
+        await this.ensureInitialized();
+        const { GraphEngine } = await import('./graph/index.js');
+        const graph = new GraphEngine(this.storage, this.options.graph);
+        return graph.findCallers(entityName);
+    }
+    /**
+     * Find callees of a function or method
+     *
+     * @param entityName - Name or ID of the function/method
+     * @returns List of call paths
+     *
+     * @see REQ-CG-GRF-005
+     */
+    async findCallees(entityName) {
+        await this.ensureInitialized();
+        const { GraphEngine } = await import('./graph/index.js');
+        const graph = new GraphEngine(this.storage, this.options.graph);
+        return graph.findCallees(entityName);
+    }
+    /**
+     * Find implementations of an interface
+     *
+     * @param interfaceName - Name or ID of the interface
+     * @returns List of implementing entities
+     */
+    async findImplementations(interfaceName) {
+        await this.ensureInitialized();
+        const { GraphEngine } = await import('./graph/index.js');
+        const graph = new GraphEngine(this.storage, this.options.graph);
+        return graph.findImplementations(interfaceName);
+    }
+    /**
+     * Analyze module structure
+     *
+     * @param path - Path to module/file
+     * @returns Module analysis result
+     */
+    async analyzeModule(path) {
+        await this.ensureInitialized();
+        const { GraphEngine } = await import('./graph/index.js');
+        const graph = new GraphEngine(this.storage, this.options.graph);
+        return graph.analyzeModule(path);
+    }
+    // =========================================================================
+    // Code Retrieval Methods
+    // =========================================================================
+    /**
+     * Get source code snippet for an entity
+     *
+     * @param entityId - Entity ID
+     * @returns Code snippet with context
+     */
+    async getSnippet(entityId) {
+        await this.ensureInitialized();
+        const entity = await this.storage.getEntity(entityId);
+        if (!entity) {
+            throw new Error(`Entity not found: ${entityId}`);
+        }
+        return {
+            entityId,
+            code: entity.sourceCode ?? '',
+            language: entity.language ?? 'typescript',
+            filePath: entity.filePath ?? '',
+            startLine: entity.startLine ?? 0,
+            endLine: entity.endLine ?? 0,
+        };
+    }
+    /**
+     * Get file structure overview
+     *
+     * @param path - File path
+     * @returns File structure with entities
+     */
+    async getFileStructure(path) {
+        await this.ensureInitialized();
+        const entities = await this.storage.queryEntities({
+            filePath: path,
+        });
+        const imports = entities.filter(e => e.type === 'import');
+        const exports = entities.filter(e => e.type === 'export');
+        return {
+            filePath: path,
+            language: entities[0]?.language ?? 'typescript',
+            entities,
+            linesOfCode: Math.max(...entities.map(e => e.endLine ?? 0), 0),
+            importCount: imports.length,
+            exportCount: exports.length,
+        };
+    }
+    // =========================================================================
+    // GraphRAG Methods
+    // =========================================================================
+    /**
+     * Global search across all code communities
+     *
+     * @param query - Search query
+     * @param options - Search options
+     * @returns Search results with relevance scores
+     *
+     * @see REQ-CG-RAG-002
+     */
+    async globalSearch(query, options) {
+        await this.ensureInitialized();
+        const { GraphRAGSearch } = await import('./graphrag/index.js');
+        const { GraphEngine } = await import('./graph/index.js');
+        const graph = new GraphEngine(this.storage, this.options.graph);
+        const search = new GraphRAGSearch(graph, this.options.graphrag);
+        return search.globalSearch(query, options);
+    }
+    /**
+     * Local search in entity neighborhood
+     *
+     * @param entityName - Entity name or ID
+     * @param options - Search options
+     * @returns Search results from entity neighborhood
+     *
+     * @see REQ-CG-RAG-003
+     */
+    async localSearch(entityName, options) {
+        await this.ensureInitialized();
+        const { GraphRAGSearch } = await import('./graphrag/index.js');
+        const { GraphEngine } = await import('./graph/index.js');
+        const graph = new GraphEngine(this.storage, this.options.graph);
+        const search = new GraphRAGSearch(graph, this.options.graphrag);
+        return search.localSearch(entityName, options);
+    }
+    // =========================================================================
+    // Statistics Methods
+    // =========================================================================
+    /**
+     * Get graph statistics
+     *
+     * @returns Graph statistics
+     */
+    async getStats() {
+        await this.ensureInitialized();
+        const storageStats = await this.storage.getStats();
+        // Get entity type distribution
+        const entities = await this.storage.queryEntities({});
+        const entitiesByType = {};
+        const languages = new Set();
+        for (const entity of entities) {
+            entitiesByType[entity.type] = (entitiesByType[entity.type] ?? 0) + 1;
+            if (entity.language) {
+                languages.add(entity.language);
+            }
+        }
+        return {
+            entityCount: storageStats.entityCount,
+            relationCount: storageStats.relationCount,
+            fileCount: storageStats.fileCount,
+            communityCount: 0, // Will be populated by GraphRAG
+            entitiesByType: entitiesByType,
+            relationsByType: {},
+            languages: Array.from(languages),
+        };
+    }
+    // =========================================================================
+    // Lifecycle Methods
+    // =========================================================================
+    /**
+     * Close the CodeGraph instance and release resources
+     */
+    async close() {
+        if (this.storage) {
+            await this.storage.close();
+            this.storage = null;
+        }
+        this.initialized = false;
+        this.removeAllListeners();
+    }
+    /**
+     * Check if instance is initialized
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+}
+/**
+ * Create a new CodeGraph instance
+ *
+ * @param options - Configuration options
+ * @returns CodeGraph instance
+ */
+export function createCodeGraph(options) {
+    return new CodeGraph(options);
+}
+//# sourceMappingURL=codegraph.js.map

package/dist/codegraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegraph.js","sourceRoot":"","sources":["../src/codegraph.ts"],"names":[],"mappings":"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"}

package/dist/events/event-emitter.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @nahisaho/musubix-codegraph - Event System
+ *
+ * Type-safe event emitter for CodeGraph events
+ *
+ * @packageDocumentation
+ * @module @nahisaho/musubix-codegraph/events
+ *
+ * @see REQ-CG-API-006
+ * @see DES-CG-001
+ */
+import type { CodeGraphEvents } from '../types.js';
+/**
+ * Type-safe event emitter for CodeGraph
+ *
+ * @example
+ * ```typescript
+ * const emitter = new TypedEventEmitter<CodeGraphEvents>();
+ *
+ * emitter.on('indexing:progress', (data) => {
+ *   console.log(`Progress: ${data.processed}/${data.total}`);
+ * });
+ *
+ * emitter.emit('indexing:progress', { processed: 10, total: 100, currentFile: 'src/index.ts' });
+ * ```
+ */
+export declare class TypedEventEmitter<TEvents extends Record<string, unknown>> {
+    private emitter;
+    constructor();
+    /**
+     * Register an event listener
+     */
+    on<K extends keyof TEvents>(event: K, listener: (data: TEvents[K]) => void): this;
+    /**
+     * Register a one-time event listener
+     */
+    once<K extends keyof TEvents>(event: K, listener: (data: TEvents[K]) => void): this;
+    /**
+     * Remove an event listener
+     */
+    off<K extends keyof TEvents>(event: K, listener: (data: TEvents[K]) => void): this;
+    /**
+     * Remove all listeners for an event
+     */
+    removeAllListeners<K extends keyof TEvents>(event?: K): this;
+    /**
+     * Emit an event
+     */
+    emit<K extends keyof TEvents>(event: K, data: TEvents[K]): boolean;
+    /**
+     * Get listener count for an event
+     */
+    listenerCount<K extends keyof TEvents>(event: K): number;
+    /**
+     * Get all listeners for an event
+     */
+    listeners<K extends keyof TEvents>(event: K): ((data: TEvents[K]) => void)[];
+    /**
+     * Wait for an event (Promise-based)
+     */
+    waitFor<K extends keyof TEvents>(event: K, timeout?: number): Promise<TEvents[K]>;
+}
+/**
+ * CodeGraph event emitter with pre-defined event types
+ */
+export declare class CodeGraphEventEmitter extends TypedEventEmitter<CodeGraphEvents> {
+    /**
+     * Emit indexing start event
+     */
+    emitIndexingStart(path: string): void;
+    /**
+     * Emit indexing progress event
+     */
+    emitIndexingProgress(processed: number, total: number, currentFile: string): void;
+    /**
+     * Emit indexing complete event
+     */
+    emitIndexingComplete(result: CodeGraphEvents['indexing:complete']): void;
+    /**
+     * Emit indexing error event
+     */
+    emitIndexingError(error: Error, file?: string): void;
+    /**
+     * Emit query start event
+     */
+    emitQueryStart(query: CodeGraphEvents['query:start']['query']): void;
+    /**
+     * Emit query complete event
+     */
+    emitQueryComplete(result: CodeGraphEvents['query:complete']['result'], durationMs: number): void;
+}
+export declare function createEventEmitter(): CodeGraphEventEmitter;
+//# sourceMappingURL=event-emitter.d.ts.map

package/dist/events/event-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitter.d.ts","sourceRoot":"","sources":["../../src/events/event-emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;;;;;;;;;GAaG;AACH,qBAAa,iBAAiB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACpE,OAAO,CAAC,OAAO,CAAe;;IAQ9B;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAKjF;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAKnF;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAKlF;;OAEG;IACH,kBAAkB,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI;IAS5D;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO;IAIlE;;OAEG;IACH,aAAa,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM;IAIxD;;OAEG;IACH,SAAS,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE;IAI5E;;OAEG;IACH,OAAO,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CAqBlF;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,iBAAiB,CAAC,eAAe,CAAC;IAC3E;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIrC;;OAEG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAIjF;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,eAAe,CAAC,mBAAmB,CAAC,GAAG,IAAI;IAIxE;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAIpD;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,GAAG,IAAI;IAIpE;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,eAAe,CAAC,gBAAgB,CAAC,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;CAGjG;AAGD,wBAAgB,kBAAkB,IAAI,qBAAqB,CAE1D"}

package/dist/events/event-emitter.js

@@ -0,0 +1,152 @@
+/**
+ * @nahisaho/musubix-codegraph - Event System
+ *
+ * Type-safe event emitter for CodeGraph events
+ *
+ * @packageDocumentation
+ * @module @nahisaho/musubix-codegraph/events
+ *
+ * @see REQ-CG-API-006
+ * @see DES-CG-001
+ */
+import { EventEmitter } from 'events';
+/**
+ * Type-safe event emitter for CodeGraph
+ *
+ * @example
+ * ```typescript
+ * const emitter = new TypedEventEmitter<CodeGraphEvents>();
+ *
+ * emitter.on('indexing:progress', (data) => {
+ *   console.log(`Progress: ${data.processed}/${data.total}`);
+ * });
+ *
+ * emitter.emit('indexing:progress', { processed: 10, total: 100, currentFile: 'src/index.ts' });
+ * ```
+ */
+export class TypedEventEmitter {
+    emitter;
+    constructor() {
+        this.emitter = new EventEmitter();
+        // Increase max listeners for complex applications
+        this.emitter.setMaxListeners(50);
+    }
+    /**
+     * Register an event listener
+     */
+    on(event, listener) {
+        this.emitter.on(event, listener);
+        return this;
+    }
+    /**
+     * Register a one-time event listener
+     */
+    once(event, listener) {
+        this.emitter.once(event, listener);
+        return this;
+    }
+    /**
+     * Remove an event listener
+     */
+    off(event, listener) {
+        this.emitter.off(event, listener);
+        return this;
+    }
+    /**
+     * Remove all listeners for an event
+     */
+    removeAllListeners(event) {
+        if (event) {
+            this.emitter.removeAllListeners(event);
+        }
+        else {
+            this.emitter.removeAllListeners();
+        }
+        return this;
+    }
+    /**
+     * Emit an event
+     */
+    emit(event, data) {
+        return this.emitter.emit(event, data);
+    }
+    /**
+     * Get listener count for an event
+     */
+    listenerCount(event) {
+        return this.emitter.listenerCount(event);
+    }
+    /**
+     * Get all listeners for an event
+     */
+    listeners(event) {
+        return this.emitter.listeners(event);
+    }
+    /**
+     * Wait for an event (Promise-based)
+     */
+    waitFor(event, timeout) {
+        return new Promise((resolve, reject) => {
+            let timeoutId;
+            const listener = (data) => {
+                if (timeoutId) {
+                    clearTimeout(timeoutId);
+                }
+                resolve(data);
+            };
+            this.once(event, listener);
+            if (timeout) {
+                timeoutId = setTimeout(() => {
+                    this.off(event, listener);
+                    reject(new Error(`Timeout waiting for event: ${String(event)}`));
+                }, timeout);
+            }
+        });
+    }
+}
+/**
+ * CodeGraph event emitter with pre-defined event types
+ */
+export class CodeGraphEventEmitter extends TypedEventEmitter {
+    /**
+     * Emit indexing start event
+     */
+    emitIndexingStart(path) {
+        this.emit('indexing:start', { path, timestamp: new Date() });
+    }
+    /**
+     * Emit indexing progress event
+     */
+    emitIndexingProgress(processed, total, currentFile) {
+        this.emit('indexing:progress', { processed, total, currentFile });
+    }
+    /**
+     * Emit indexing complete event
+     */
+    emitIndexingComplete(result) {
+        this.emit('indexing:complete', result);
+    }
+    /**
+     * Emit indexing error event
+     */
+    emitIndexingError(error, file) {
+        this.emit('indexing:error', { error, file });
+    }
+    /**
+     * Emit query start event
+     */
+    emitQueryStart(query) {
+        this.emit('query:start', { query });
+    }
+    /**
+     * Emit query complete event
+     */
+    emitQueryComplete(result, durationMs) {
+        this.emit('query:complete', { result, durationMs });
+    }
+}
+// Export default instance factory
+export function createEventEmitter() {
+    return new CodeGraphEventEmitter();
+}
+//# sourceMappingURL=event-emitter.js.map