@egentica/codemap 0.1.5

package/dist/adapters/EgenticaMcpAdapter.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Egentica MCP Adapter
+ *
+ * Bridges the standalone CodeMap library to Egentica's MCP system.
+ * Initializes CodeMap with Egentica's filesystem and configuration,
+ * then provides a compatible interface for the existing MCP operations.
+ *
+ * This adapter allows CodeMap to be used both:
+ * 1. Standalone (as an npm package)
+ * 2. Within Egentica (via MCP system)
+ */
+import { CodeMap } from '../core/CodeMap';
+import type { FileEntry, SearchRequest, SearchResponse } from '../types';
+/**
+ * MCP Adapter configuration.
+ */
+export interface McpAdapterConfig {
+    rootPath: string;
+    system: {
+        io: {
+            file: any;
+            paths: any;
+        };
+        events: any;
+    };
+    enableTimeWarp?: boolean;
+}
+/**
+ * Egentica MCP Adapter.
+ *
+ * Initializes and manages the standalone CodeMap instance
+ * for use within Egentica's MCP system.
+ */
+export declare class EgenticaMcpAdapter {
+    private config;
+    private codemap;
+    private provider;
+    constructor(config: McpAdapterConfig);
+    /**
+     * Bridge CodeMap events to Egentica EventBus.
+     */
+    private setupEventBridge;
+    /**
+     * Initialize/scan the project.
+     */
+    scan(): Promise<{
+        filesScanned: number;
+        directoriesScanned: number;
+        durationMs: number;
+    }>;
+    /**
+     * Search for files and symbols.
+     */
+    search(request: SearchRequest): SearchResponse;
+    /**
+     * Find files by name pattern.
+     */
+    findByName(pattern: string): FileEntry[];
+    /**
+     * Find files relevant to a task.
+     */
+    findRelevant(task: string, maxResults?: number): Array<{
+        file: FileEntry;
+        relevance: number;
+        reasons: string[];
+    }>;
+    /**
+     * Get file dependencies.
+     */
+    getRelated(relativePath: string): {
+        imports: FileEntry[];
+        importers: FileEntry[];
+    };
+    /**
+     * Get files that import a target.
+     */
+    findImporters(relativePath: string): FileEntry[];
+    /**
+     * Get files imported by a target.
+     */
+    findImports(relativePath: string): FileEntry[];
+    /**
+     * Traverse dependency graph.
+     */
+    traverse(startPath: string, direction: 'imports' | 'importers', maxDepth?: number): FileEntry[];
+    /**
+     * Get graph statistics.
+     */
+    getStats(): {
+        files: number;
+        directories: number;
+        symbols: number;
+        dependencies: number;
+    };
+    /**
+     * Read file.
+     */
+    readFile(path: string): Promise<string>;
+    /**
+     * Write file.
+     */
+    writeFile(path: string, content: string): Promise<void>;
+    /**
+     * Check if file exists.
+     */
+    fileExists(path: string): Promise<boolean>;
+    /**
+     * Get TimeWarp plugin (if enabled).
+     * NOTE: Commented out until TimeWarpPlugin is published.
+     */
+    getTimeWarp(): any | undefined;
+    /**
+     * Get raw CodeMap instance (for advanced usage).
+     */
+    getCodeMap(): CodeMap;
+    /**
+     * Cleanup.
+     */
+    dispose(): Promise<void>;
+}
+/**
+ * Create MCP adapter instance.
+ *
+ * @param config - Adapter configuration
+ * @returns Initialized MCP adapter
+ */
+export declare function createMcpAdapter(config: McpAdapterConfig): EgenticaMcpAdapter;
+//# sourceMappingURL=EgenticaMcpAdapter.d.ts.map

package/dist/adapters/EgenticaMcpAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EgenticaMcpAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/EgenticaMcpAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAM1C,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAyDzE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QACN,EAAE,EAAE;YACF,IAAI,EAAE,GAAG,CAAC;YACV,KAAK,EAAE,GAAG,CAAC;SACZ,CAAC;QACF,MAAM,EAAE,GAAG,CAAC;KACb,CAAC;IACF,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;GAKG;AACH,qBAAa,kBAAkB;IAKjB,OAAO,CAAC,MAAM;IAJ1B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,QAAQ,CAA6B;gBAGzB,MAAM,EAAE,gBAAgB;IA0B5C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA4BxB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAIF;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc;IAI9C;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE;IAIxC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;QACrD,IAAI,EAAE,SAAS,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IAIF;;OAEG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG;QAChC,OAAO,EAAE,SAAS,EAAE,CAAC;QACrB,SAAS,EAAE,SAAS,EAAE,CAAC;KACxB;IAID;;OAEG;IACH,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE;IAIhD;;OAEG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE;IAI9C;;OAEG;IACH,QAAQ,CACN,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,SAAS,GAAG,WAAW,EAClC,QAAQ,CAAC,EAAE,MAAM,GAChB,SAAS,EAAE;IAId;;OAEG;IACH,QAAQ,IAAI;QACV,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;KACtB;IAID;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI7C;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIhD;;;OAGG;IACH,WAAW,IAAI,GAAG,GAAG,SAAS;IAK9B;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,kBAAkB,CAE7E"}

package/dist/adapters/EgenticaMcpAdapter.js

@@ -0,0 +1,218 @@
+"use strict";
+/**
+ * Egentica MCP Adapter
+ *
+ * Bridges the standalone CodeMap library to Egentica's MCP system.
+ * Initializes CodeMap with Egentica's filesystem and configuration,
+ * then provides a compatible interface for the existing MCP operations.
+ *
+ * This adapter allows CodeMap to be used both:
+ * 1. Standalone (as an npm package)
+ * 2. Within Egentica (via MCP system)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EgenticaMcpAdapter = void 0;
+exports.createMcpAdapter = createMcpAdapter;
+const CodeMap_1 = require("../core/CodeMap");
+/**
+ * Egentica-specific filesystem provider.
+ * Wraps Egentica's IO system to implement FileSystemProvider.
+ */
+class EgenticaFileSystemProvider {
+    ioFile;
+    constructor(ioFile // System.io.file
+    ) {
+        this.ioFile = ioFile;
+    }
+    async read(path) {
+        return await this.ioFile.read(path);
+    }
+    async write(path, content) {
+        await this.ioFile.write(path, content);
+    }
+    async exists(path) {
+        return await this.ioFile.exists(path);
+    }
+    async readdir(path) {
+        return await this.ioFile.readdir(path);
+    }
+    async stat(path) {
+        const stats = await this.ioFile.stat(path);
+        return {
+            isDirectory: stats.isDirectory(),
+            size: stats.size,
+            mtime: stats.mtimeMs
+        };
+    }
+    async remove(path) {
+        await this.ioFile.remove(path);
+    }
+    async rename(oldPath, newPath) {
+        await this.ioFile.rename(oldPath, newPath);
+    }
+    async mkdir(path) {
+        await this.ioFile.mkdir(path, { recursive: true });
+    }
+    async rmdir(path, options) {
+        await this.ioFile.rmdir(path, options);
+    }
+}
+/**
+ * Egentica MCP Adapter.
+ *
+ * Initializes and manages the standalone CodeMap instance
+ * for use within Egentica's MCP system.
+ */
+class EgenticaMcpAdapter {
+    config;
+    codemap;
+    provider;
+    // private timewarp?: TimeWarpPlugin;  // Commented out until plugin is published
+    constructor(config) {
+        this.config = config;
+        // Create filesystem provider
+        this.provider = new EgenticaFileSystemProvider(config.system.io.file);
+        // Initialize CodeMap
+        this.codemap = new CodeMap_1.CodeMap({
+            rootPath: config.rootPath,
+            provider: this.provider
+        });
+        // NOTE: Plugin registration commented out until plugins are published
+        // this.codemap.registerPlugin(TypeScriptParser);
+        // this.codemap.registerPlugin(VueParser);
+        // NOTE: TimeWarp registration commented out until plugin is published
+        // if (config.enableTimeWarp) {
+        //   this.timewarp = new TimeWarpPlugin({ provider: this.provider });
+        //   this.codemap.registerPlugin(this.timewarp);
+        // }
+        // Hook CodeMap events into Egentica EventBus
+        this.setupEventBridge();
+    }
+    /**
+     * Bridge CodeMap events to Egentica EventBus.
+     */
+    setupEventBridge() {
+        const eventBus = this.config.system.events;
+        // Scan events
+        this.codemap.on('scan:start', (payload) => {
+            eventBus.emit('codemap:scan:start', payload);
+        });
+        this.codemap.on('scan:file', (payload) => {
+            eventBus.emit('codemap:scan:file', payload);
+        });
+        this.codemap.on('scan:complete', (payload) => {
+            eventBus.emit('codemap:scan:complete', payload);
+        });
+        // File events
+        this.codemap.on('file:write:before', (payload) => {
+            eventBus.emit('codemap:file:write:before', payload);
+        });
+        this.codemap.on('file:write:after', (payload) => {
+            eventBus.emit('codemap:file:write:after', payload);
+        });
+    }
+    // ── Public API (compatible with existing MCP operations) ────────────────────
+    /**
+     * Initialize/scan the project.
+     */
+    async scan() {
+        return await this.codemap.scan();
+    }
+    /**
+     * Search for files and symbols.
+     */
+    search(request) {
+        return this.codemap.query.search(request);
+    }
+    /**
+     * Find files by name pattern.
+     */
+    findByName(pattern) {
+        return this.codemap.query.findByName(pattern);
+    }
+    /**
+     * Find files relevant to a task.
+     */
+    findRelevant(task, maxResults) {
+        return this.codemap.query.findRelevant(task, maxResults);
+    }
+    /**
+     * Get file dependencies.
+     */
+    getRelated(relativePath) {
+        return this.codemap.query.getRelated(relativePath);
+    }
+    /**
+     * Get files that import a target.
+     */
+    findImporters(relativePath) {
+        return this.codemap.query.findImporters(relativePath);
+    }
+    /**
+     * Get files imported by a target.
+     */
+    findImports(relativePath) {
+        return this.codemap.query.findImports(relativePath);
+    }
+    /**
+     * Traverse dependency graph.
+     */
+    traverse(startPath, direction, maxDepth) {
+        return this.codemap.query.traverse(startPath, direction, maxDepth);
+    }
+    /**
+     * Get graph statistics.
+     */
+    getStats() {
+        return this.codemap.getStats();
+    }
+    /**
+     * Read file.
+     */
+    async readFile(path) {
+        return await this.codemap.fs.read(path);
+    }
+    /**
+     * Write file.
+     */
+    async writeFile(path, content) {
+        await this.codemap.fs.write(path, content);
+    }
+    /**
+     * Check if file exists.
+     */
+    async fileExists(path) {
+        return await this.codemap.fs.exists(path);
+    }
+    /**
+     * Get TimeWarp plugin (if enabled).
+     * NOTE: Commented out until TimeWarpPlugin is published.
+     */
+    getTimeWarp() {
+        // return this.timewarp;
+        return undefined;
+    }
+    /**
+     * Get raw CodeMap instance (for advanced usage).
+     */
+    getCodeMap() {
+        return this.codemap;
+    }
+    /**
+     * Cleanup.
+     */
+    async dispose() {
+        await this.codemap.dispose();
+    }
+}
+exports.EgenticaMcpAdapter = EgenticaMcpAdapter;
+/**
+ * Create MCP adapter instance.
+ *
+ * @param config - Adapter configuration
+ * @returns Initialized MCP adapter
+ */
+function createMcpAdapter(config) {
+    return new EgenticaMcpAdapter(config);
+}
+//# sourceMappingURL=EgenticaMcpAdapter.js.map

package/dist/adapters/EgenticaMcpAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EgenticaMcpAdapter.js","sourceRoot":"","sources":["../../src/adapters/EgenticaMcpAdapter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AA0RH,4CAEC;AA1RD,6CAA0C;AAQ1C;;;GAGG;AACH,MAAM,0BAA0B;IAEpB;IADV,YACU,MAAW,CAAE,iBAAiB;;QAA9B,WAAM,GAAN,MAAM,CAAK;IAClB,CAAC;IAEJ,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,OAAe;QACvC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY;QACxB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY;QAKrB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,OAAO;YACL,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE;YAChC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,OAAO;SACrB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,OAAe;QAC3C,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,OAAiC;QACzD,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;CACF;AAiBD;;;;;GAKG;AACH,MAAa,kBAAkB;IAKT;IAJZ,OAAO,CAAU;IACjB,QAAQ,CAA6B;IAC7C,iFAAiF;IAEjF,YAAoB,MAAwB;QAAxB,WAAM,GAAN,MAAM,CAAkB;QAC1C,6BAA6B;QAC7B,IAAI,CAAC,QAAQ,GAAG,IAAI,0BAA0B,CAC5C,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CACtB,CAAC;QAEF,qBAAqB;QACrB,IAAI,CAAC,OAAO,GAAG,IAAI,iBAAO,CAAC;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QAEH,sEAAsE;QACtE,iDAAiD;QACjD,0CAA0C;QAE1C,sEAAsE;QACtE,+BAA+B;QAC/B,qEAAqE;QACrE,gDAAgD;QAChD,IAAI;QAEJ,6CAA6C;QAC7C,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,gBAAgB;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;QAE3C,cAAc;QACd,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE;YACxC,QAAQ,CAAC,IAAI,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,EAAE;YACvC,QAAQ,CAAC,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,OAAO,EAAE,EAAE;YAC3C,QAAQ,CAAC,IAAI,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QAEH,cAAc;QACd,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,OAAO,EAAE,EAAE;YAC/C,QAAQ,CAAC,IAAI,CAAC,2BAA2B,EAAE,OAAO,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,kBAAkB,EAAE,CAAC,OAAO,EAAE,EAAE;YAC9C,QAAQ,CAAC,IAAI,CAAC,0BAA0B,EAAE,OAAO,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,+EAA+E;IAE/E;;OAEG;IACH,KAAK,CAAC,IAAI;QAKR,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAsB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,OAAe;QACxB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,IAAY,EAAE,UAAmB;QAK5C,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,YAAoB;QAI7B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,YAAoB;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,YAAoB;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,QAAQ,CACN,SAAiB,EACjB,SAAkC,EAClC,QAAiB;QAEjB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,QAAQ;QAMN,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,IAAY,EAAE,OAAe;QAC3C,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,IAAY;QAC3B,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,wBAAwB;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IAC/B,CAAC;CACF;AA5LD,gDA4LC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,MAAwB;IACvD,OAAO,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC"}

package/dist/assist/AssistEngine.d.ts

@@ -0,0 +1,107 @@
+/**
+ * AssistEngine - Goal-driven file discovery with experience-powered scoring.
+ *
+ * The main entry point for the assist system. Orchestrates:
+ * - Query processing
+ * - Candidate discovery
+ * - Multi-phase scoring (via AssistScorer)
+ * - Usage metadata management
+ *
+ * @example
+ * ```typescript
+ * const engine = new AssistEngine(queryEngine, aggregator, config);
+ *
+ * // Discover files for a goal
+ * const result = await engine.discover('make cards draggable');
+ * // → { targets: [...], topConfidence: 0.92, suggestions: [...] }
+ *
+ * // Add usage metadata
+ * await engine.addUsage('TaskCard.vue', [
+ *   'make cards draggable',
+ *   'add drag handles'
+ * ]);
+ *
+ * // List usages
+ * const usages = await engine.listUsages('TaskCard.vue');
+ * ```
+ */
+import type { AssistResult } from '../types';
+import type { FileEntry } from '../types';
+import { type AssistScorerConfig } from './AssistScorer';
+import { PatternAggregator } from './PatternAggregator';
+/**
+ * QueryEngine interface (will be implemented separately).
+ * For now, this is a placeholder.
+ */
+export interface QueryEngine {
+    findRelevant(task: string, maxResults?: number): Promise<FileEntry[]>;
+}
+/**
+ * AssistEngine configuration.
+ */
+export interface AssistEngineConfig extends AssistScorerConfig {
+    /** Maximum candidates to score */
+    maxCandidates?: number;
+    /** Minimum confidence threshold */
+    minConfidence?: number;
+}
+export declare class AssistEngine {
+    private queryEngine;
+    private aggregator;
+    private config;
+    private scorer;
+    constructor(queryEngine: QueryEngine | null, aggregator: PatternAggregator | null, config?: AssistEngineConfig);
+    /**
+     * Discover files for a goal.
+     *
+     * @param goal - Goal description
+     * @returns Assist result with ranked candidates
+     */
+    discover(goal: string): Promise<AssistResult>;
+    /**
+     * Add usage metadata for a file.
+     *
+     * @param target - File path
+     * @param usages - Usage phrases
+     * @returns Updated metadata
+     */
+    addUsage(target: string, usages: string[]): Promise<any>;
+    /**
+     * List usage metadata for a file.
+     *
+     * @param target - File path
+     * @returns Usage metadata or null
+     */
+    listUsages(target: string): Promise<any>;
+    /**
+     * Remove usage metadata.
+     *
+     * @param target - File path
+     */
+    removeUsage(target: string): Promise<void>;
+    /**
+     * Get query history for a file.
+     *
+     * @param target - File path
+     * @returns Array of queries that led to this file
+     */
+    getQueryHistory(target: string): Promise<{
+        query: string;
+        timestamp: string;
+    }[]>;
+    /**
+     * Get candidate files for scoring.
+     *
+     * @param goal - Goal query
+     * @returns Array of file candidates
+     */
+    private getCandidates;
+    /**
+     * Generate helpful suggestions for the user.
+     *
+     * @param results - Scored results
+     * @returns Array of suggestions
+     */
+    private generateSuggestions;
+}
+//# sourceMappingURL=AssistEngine.d.ts.map

package/dist/assist/AssistEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssistEngine.d.ts","sourceRoot":"","sources":["../../src/assist/AssistEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EACV,YAAY,EAEb,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAgB,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;CACvE;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,kCAAkC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,mCAAmC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,YAAY;IAIrB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,MAAM;IALhB,OAAO,CAAC,MAAM,CAAe;gBAGnB,WAAW,EAAE,WAAW,GAAG,IAAI,EAC/B,UAAU,EAAE,iBAAiB,GAAG,IAAI,EACpC,MAAM,GAAE,kBAAuB;IAKzC;;;;;OAKG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA6BnD;;;;;;OAMG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;IAU/C;;;;;OAKG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM;IAS/B;;;;OAIG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM;IAchC;;;;;OAKG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM;eAQJ,MAAM;mBAAa,MAAM;;IAgBzD;;;;;OAKG;YACW,aAAa;IAW3B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;CAgC5B"}

package/dist/assist/AssistEngine.js

@@ -0,0 +1,188 @@
+"use strict";
+/**
+ * AssistEngine - Goal-driven file discovery with experience-powered scoring.
+ *
+ * The main entry point for the assist system. Orchestrates:
+ * - Query processing
+ * - Candidate discovery
+ * - Multi-phase scoring (via AssistScorer)
+ * - Usage metadata management
+ *
+ * @example
+ * ```typescript
+ * const engine = new AssistEngine(queryEngine, aggregator, config);
+ *
+ * // Discover files for a goal
+ * const result = await engine.discover('make cards draggable');
+ * // → { targets: [...], topConfidence: 0.92, suggestions: [...] }
+ *
+ * // Add usage metadata
+ * await engine.addUsage('TaskCard.vue', [
+ *   'make cards draggable',
+ *   'add drag handles'
+ * ]);
+ *
+ * // List usages
+ * const usages = await engine.listUsages('TaskCard.vue');
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssistEngine = void 0;
+const AssistScorer_1 = require("./AssistScorer");
+class AssistEngine {
+    queryEngine;
+    aggregator;
+    config;
+    scorer;
+    constructor(queryEngine, aggregator, config = {}) {
+        this.queryEngine = queryEngine;
+        this.aggregator = aggregator;
+        this.config = config;
+        this.scorer = new AssistScorer_1.AssistScorer(aggregator, config);
+    }
+    /**
+     * Discover files for a goal.
+     *
+     * @param goal - Goal description
+     * @returns Assist result with ranked candidates
+     */
+    async discover(goal) {
+        // Get initial candidates from query engine
+        const candidates = await this.getCandidates(goal);
+        if (candidates.length === 0) {
+            return {
+                targets: [],
+                topConfidence: 0,
+                suggestions: ['Try a different query or add usage metadata to files']
+            };
+        }
+        // Score candidates
+        const scored = await this.scorer.score(goal, candidates);
+        // Filter by minimum confidence
+        const minConfidence = this.config.minConfidence || 0.1;
+        const filtered = scored.filter(c => c.confidence >= minConfidence);
+        // Generate suggestions
+        const suggestions = this.generateSuggestions(filtered);
+        return {
+            targets: filtered,
+            topConfidence: filtered[0]?.confidence || 0,
+            suggestions: suggestions.length > 0 ? suggestions : undefined
+        };
+    }
+    /**
+     * Add usage metadata for a file.
+     *
+     * @param target - File path
+     * @param usages - Usage phrases
+     * @returns Updated metadata
+     */
+    async addUsage(target, usages) {
+        if (!this.aggregator) {
+            throw new Error('Aggregator not available for usage metadata');
+        }
+        // Delegate to aggregator's store
+        const store = this.aggregator.store;
+        return store.addUsages(target, usages);
+    }
+    /**
+     * List usage metadata for a file.
+     *
+     * @param target - File path
+     * @returns Usage metadata or null
+     */
+    async listUsages(target) {
+        if (!this.aggregator) {
+            throw new Error('Aggregator not available for usage metadata');
+        }
+        const store = this.aggregator.store;
+        return store.getUsageMetadata(target);
+    }
+    /**
+     * Remove usage metadata.
+     *
+     * @param target - File path
+     */
+    async removeUsage(target) {
+        if (!this.aggregator) {
+            throw new Error('Aggregator not available for usage metadata');
+        }
+        const store = this.aggregator.store;
+        await store.setUsageMetadata({
+            target,
+            usages: [],
+            registeredAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString()
+        });
+    }
+    /**
+     * Get query history for a file.
+     *
+     * @param target - File path
+     * @returns Array of queries that led to this file
+     */
+    async getQueryHistory(target) {
+        if (!this.aggregator) {
+            throw new Error('Aggregator not available for query history');
+        }
+        const store = this.aggregator.store;
+        const journeys = await store.getJourneysForFile(target);
+        const queries = [];
+        for (const journey of journeys) {
+            for (const step of journey.searchPath) {
+                queries.push({
+                    query: step.query,
+                    timestamp: step.timestamp
+                });
+            }
+        }
+        return queries;
+    }
+    // ── Private Helpers ────────────────────────────────────────────────────────
+    /**
+     * Get candidate files for scoring.
+     *
+     * @param goal - Goal query
+     * @returns Array of file candidates
+     */
+    async getCandidates(goal) {
+        if (!this.queryEngine) {
+            // No query engine - return empty
+            // In the future, could fall back to usage metadata search
+            return [];
+        }
+        const maxCandidates = this.config.maxCandidates || 20;
+        return this.queryEngine.findRelevant(goal, maxCandidates);
+    }
+    /**
+     * Generate helpful suggestions for the user.
+     *
+     * @param results - Scored results
+     * @returns Array of suggestions
+     */
+    generateSuggestions(results) {
+        const suggestions = [];
+        // Low confidence top result
+        if (results.length > 0 && results[0].confidence < 0.5) {
+            suggestions.push('Low confidence match - consider refining your query');
+        }
+        // No usage metadata for top results
+        if (results.length > 0 && this.aggregator) {
+            const topFile = results[0].file;
+            const hasUsageBoost = results[0].reasons.some(r => r.includes('usage metadata'));
+            if (!hasUsageBoost) {
+                suggestions.push(`Consider adding usage metadata to ${topFile} for better future discovery`);
+            }
+        }
+        // Too many candidates with similar scores
+        if (results.length >= 3) {
+            const top3 = results.slice(0, 3);
+            const scoreDiff = top3[0].confidence - top3[2].confidence;
+            if (scoreDiff < 0.1) {
+                suggestions.push('Multiple similar matches - try a more specific query');
+            }
+        }
+        return suggestions;
+    }
+}
+exports.AssistEngine = AssistEngine;
+//# sourceMappingURL=AssistEngine.js.map

package/dist/assist/AssistEngine.js.map

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