agent-ide 0.1.0

package/dist/core/indexing/file-watcher.js

@@ -0,0 +1,280 @@
+/**
+ * 檔案監控器實作
+ * 監控檔案系統變更並觸發增量索引更新
+ */
+import { EventEmitter } from 'events';
+import * as fs from 'fs/promises';
+/**
+ * 檔案監控器類別
+ * 監控檔案系統變更並自動更新索引
+ */
+export class FileWatcher extends EventEmitter {
+    indexEngine;
+    watcher = null;
+    isWatching = false;
+    isPaused = false;
+    pendingChanges = new Map();
+    debounceTimer = null;
+    debounceTime;
+    constructor(indexEngine, options) {
+        super();
+        this.indexEngine = indexEngine;
+        this.debounceTime = options?.debounceTime ?? 300; // 300ms debounce
+    }
+    /**
+     * 開始監控檔案變更
+     */
+    async start() {
+        if (this.isWatching) {
+            return;
+        }
+        const config = this.indexEngine.getConfig();
+        try {
+            // 使用原生 fs.watch，在實際環境中可能需要使用 chokidar 等更強大的監控庫
+            const { watch } = await import('fs');
+            this.watcher = watch(config.workspacePath, { recursive: true }, (eventType, filename) => {
+                if (!filename || this.isPaused) {
+                    return;
+                }
+                const filePath = `${config.workspacePath}/${filename}`;
+                // 判斷變更類型
+                let changeType = 'change';
+                if (eventType === 'rename') {
+                    // 需要進一步檢查是新增還是刪除
+                    fs.access(filePath)
+                        .then(() => {
+                        changeType = 'add';
+                        this.queueChange(filePath, changeType);
+                    })
+                        .catch(() => {
+                        changeType = 'unlink';
+                        this.queueChange(filePath, changeType);
+                    });
+                }
+                else {
+                    this.queueChange(filePath, changeType);
+                }
+            });
+            this.isWatching = true;
+            this.emit('started');
+        }
+        catch (error) {
+            this.emit('error', new Error(`啟動檔案監控失敗: ${error}`));
+            throw error;
+        }
+    }
+    /**
+     * 停止監控檔案變更
+     */
+    async stop() {
+        if (!this.isWatching) {
+            return;
+        }
+        if (this.watcher) {
+            this.watcher.close();
+            this.watcher = null;
+        }
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = null;
+        }
+        // 處理剩餘的變更
+        await this.processPendingChanges();
+        this.isWatching = false;
+        this.emit('stopped');
+    }
+    /**
+     * 暫停監控
+     */
+    pause() {
+        this.isPaused = true;
+        this.emit('paused');
+    }
+    /**
+     * 恢復監控
+     */
+    resume() {
+        this.isPaused = false;
+        this.emit('resumed');
+    }
+    /**
+     * 手動處理檔案變更事件
+     */
+    async handleFileChange(filePath, changeType) {
+        // 如果暫停中，不處理事件
+        if (this.isPaused) {
+            return;
+        }
+        const event = {
+            filePath,
+            type: changeType,
+            timestamp: new Date()
+        };
+        try {
+            await this.processFileChange(filePath, changeType);
+            event.error = undefined;
+            this.emit('fileChanged', event);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : '未知錯誤';
+            event.error = errorMessage;
+            this.emit('error', new Error(`處理檔案變更失敗 ${filePath}: ${errorMessage}`));
+            this.emit('fileChanged', event);
+        }
+    }
+    /**
+     * 批次處理檔案變更
+     */
+    async handleBatchChanges(changes, options) {
+        const maxConcurrency = options?.maxConcurrency ?? 4;
+        const chunks = this.createChunks(changes, maxConcurrency);
+        for (const chunk of chunks) {
+            const promises = chunk.map(change => this.handleFileChange(change.filePath, change.type));
+            await Promise.allSettled(promises);
+        }
+    }
+    /**
+     * 將變更加入佇列（帶防抖動）
+     */
+    queueChange(filePath, changeType) {
+        // 檢查檔案是否應該被索引
+        const config = this.indexEngine.getConfig();
+        if (!this.shouldProcessFile(filePath, config)) {
+            return;
+        }
+        // 更新待處理變更
+        this.pendingChanges.set(filePath, { filePath, type: changeType });
+        // 重設防抖動計時器
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+        }
+        this.debounceTimer = setTimeout(() => {
+            this.processPendingChanges();
+        }, this.debounceTime);
+    }
+    /**
+     * 處理待處理的變更
+     */
+    async processPendingChanges() {
+        if (this.pendingChanges.size === 0) {
+            return;
+        }
+        const changes = Array.from(this.pendingChanges.values());
+        this.pendingChanges.clear();
+        await this.handleBatchChanges(changes);
+    }
+    /**
+     * 處理單一檔案變更
+     */
+    async processFileChange(filePath, changeType) {
+        switch (changeType) {
+            case 'add':
+            case 'change':
+                try {
+                    // 檢查檔案是否存在
+                    await fs.access(filePath);
+                    if (this.indexEngine.isIndexed(filePath)) {
+                        await this.indexEngine.updateFile(filePath);
+                    }
+                    else {
+                        await this.indexEngine.indexFile(filePath);
+                    }
+                }
+                catch (error) {
+                    // 如果是 change 事件但檔案不存在，拋出錯誤
+                    if (changeType === 'change') {
+                        throw new Error(`檔案不存在: ${filePath}`);
+                    }
+                    // 對於 add 事件，檔案可能在處理過程中被刪除
+                    if (this.indexEngine.isIndexed(filePath)) {
+                        await this.indexEngine.removeFile(filePath);
+                    }
+                }
+                break;
+            case 'unlink':
+                if (this.indexEngine.isIndexed(filePath)) {
+                    await this.indexEngine.removeFile(filePath);
+                }
+                break;
+            case 'addDir':
+                // 新增目錄時，索引其中的檔案
+                try {
+                    await this.indexEngine.indexDirectory(filePath);
+                }
+                catch (error) {
+                    // 目錄可能不存在或無法存取
+                }
+                break;
+            case 'unlinkDir':
+                // 刪除目錄時，移除其中所有檔案的索引
+                const allFiles = this.indexEngine.getAllIndexedFiles();
+                const filesToRemove = allFiles.filter(f => f.filePath.startsWith(filePath + '/'));
+                for (const file of filesToRemove) {
+                    await this.indexEngine.removeFile(file.filePath);
+                }
+                break;
+            default:
+                throw new Error(`不支援的檔案變更類型: ${changeType}`);
+        }
+    }
+    /**
+     * 檢查檔案是否應該被處理
+     */
+    shouldProcessFile(filePath, config) {
+        // 檢查副檔名
+        const extension = filePath.substring(filePath.lastIndexOf('.'));
+        if (!config.includeExtensions.includes(extension)) {
+            return false;
+        }
+        // 檢查排除模式
+        for (const pattern of config.excludePatterns) {
+            if (this.matchesPattern(filePath, pattern)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * 簡單的檔案模式匹配
+     */
+    matchesPattern(filePath, pattern) {
+        // 簡化實作，實際環境中可能需要更強大的 glob 匹配
+        const regexPattern = pattern
+            .replace(/\*\*/g, '.*')
+            .replace(/\*/g, '[^/]*')
+            .replace(/\?/g, '.');
+        const regex = new RegExp(regexPattern);
+        return regex.test(filePath);
+    }
+    /**
+     * 將陣列分割成指定大小的塊
+     */
+    createChunks(array, chunkSize) {
+        const chunks = [];
+        for (let i = 0; i < array.length; i += chunkSize) {
+            chunks.push(array.slice(i, i + chunkSize));
+        }
+        return chunks;
+    }
+    /**
+     * 取得監控狀態
+     */
+    getStatus() {
+        return {
+            isWatching: this.isWatching,
+            isPaused: this.isPaused,
+            pendingChangesCount: this.pendingChanges.size
+        };
+    }
+    /**
+     * 強制處理所有待處理的變更
+     */
+    async flush() {
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = null;
+        }
+        await this.processPendingChanges();
+    }
+}
+//# sourceMappingURL=file-watcher.js.map

package/dist/core/indexing/file-watcher.js.map

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

package/dist/core/indexing/index-engine.d.ts

@@ -0,0 +1,120 @@
+/**
+ * 索引引擎實作
+ * 程式碼索引系統的核心引擎，協調檔案索引和符號索引
+ */
+import type { Symbol, SymbolType } from '../../shared/types/index.js';
+import type { IndexConfig, IndexStats, FileInfo, SymbolSearchResult, SearchOptions } from './types.js';
+/**
+ * 索引引擎類別
+ * 協調檔案索引、符號索引和解析器的核心引擎
+ */
+export declare class IndexEngine {
+    private readonly config;
+    private readonly fileIndex;
+    private readonly symbolIndex;
+    private readonly parserRegistry;
+    private _disposed;
+    private _indexed;
+    constructor(config: IndexConfig);
+    /**
+     * 驗證配置
+     */
+    private validateConfig;
+    /**
+     * 索引整個專案
+     */
+    indexProject(projectPath?: string | any): Promise<void>;
+    /**
+     * 索引目錄
+     */
+    indexDirectory(dirPath: string): Promise<void>;
+    /**
+     * 索引單一檔案
+     */
+    indexFile(filePath: string): Promise<void>;
+    /**
+     * 更新檔案索引
+     */
+    updateFile(filePath: string): Promise<void>;
+    /**
+     * 移除檔案索引
+     */
+    removeFile(filePath: string): Promise<void>;
+    /**
+     * 根據名稱查找符號
+     */
+    findSymbol(name: string, options?: SearchOptions): Promise<SymbolSearchResult[]>;
+    /**
+     * 根據類型查找符號
+     */
+    findSymbolByType(type: SymbolType, options?: SearchOptions): Promise<SymbolSearchResult[]>;
+    /**
+     * 模糊搜尋符號
+     */
+    searchSymbols(pattern: string, options?: SearchOptions): Promise<SymbolSearchResult[]>;
+    /**
+     * 根據副檔名查找檔案
+     */
+    findFilesByExtension(ext: string): readonly FileInfo[];
+    /**
+     * 檢查檔案是否已被索引
+     */
+    isIndexed(filePath: string): boolean;
+    /**
+     * 取得索引統計資訊
+     */
+    getStats(): Promise<IndexStats>;
+    /**
+     * 取得配置
+     */
+    getConfig(): IndexConfig;
+    /**
+     * 清空所有索引
+     */
+    clear(): Promise<void>;
+    /**
+     * 批次索引檔案
+     */
+    private batchIndexFiles;
+    /**
+     * 從檔案統計資訊建立 FileInfo
+     */
+    private createFileInfoFromStat;
+    /**
+     * 根據副檔名判斷語言
+     */
+    private getLanguageFromExtension;
+    /**
+     * 檢查檔案是否需要重新索引
+     */
+    needsReindexing(filePath: string): Promise<boolean>;
+    /**
+     * 取得檔案的解析錯誤
+     */
+    getFileParseErrors(filePath: string): readonly string[];
+    /**
+     * 檢查檔案是否有解析錯誤
+     */
+    hasFileParseErrors(filePath: string): boolean;
+    /**
+     * 取得所有已索引的檔案
+     */
+    getAllIndexedFiles(): readonly FileInfo[];
+    /**
+     * 根據語言查找檔案
+     */
+    findFilesByLanguage(language: string): readonly FileInfo[];
+    /**
+     * 取得檔案的所有符號
+     */
+    getFileSymbols(filePath: string): Promise<readonly Symbol[]>;
+    /**
+     * 釋放資源
+     */
+    dispose(): void;
+    /**
+     * 檢查索引是否已被釋放或尚未建立
+     */
+    private checkDisposed;
+}
+//# sourceMappingURL=index-engine.d.ts.map

package/dist/core/indexing/index-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-engine.d.ts","sourceRoot":"","sources":["../../../src/core/indexing/index-engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,QAAQ,EACR,kBAAkB,EAClB,aAAa,EAGd,MAAM,YAAY,CAAC;AAYpB;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,WAAW;IAkB/B;;OAEG;IACH,OAAO,CAAC,cAAc;IAoCtB;;OAEG;IACG,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAmC7D;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4CpD;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqDhD;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBjD;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjD;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAiBtF;;OAEG;IACG,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAIhG;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAI5F;;OAEG;IACH,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,QAAQ,EAAE;IAItD;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIpC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;IA+BrC;;OAEG;IACH,SAAS,IAAI,WAAW;IAIxB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;YACW,eAAe;IAgD7B;;OAEG;YACW,sBAAsB;IAkBpC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAqBhC;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUzD;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE;IAIvD;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI7C;;OAEG;IACH,kBAAkB,IAAI,SAAS,QAAQ,EAAE;IAIzC;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,QAAQ,EAAE;IAI1D;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC;IAIlE;;OAEG;IACH,OAAO,IAAI,IAAI;IAQf;;OAEG;IACH,OAAO,CAAC,aAAa;CAKtB"}