agent-ide 0.5.1 → 0.7.0

package/dist/core/dead-code/dead-code-detector.js

@@ -0,0 +1,256 @@
+/**
+ * Dead Code 檢測器
+ * 使用 find-references 判斷未使用的符號
+ */
+import { createSymbolFinder, SymbolReferenceType } from '../shared/symbol-finder.js';
+import { DEFAULT_DEAD_CODE_OPTIONS } from './types.js';
+/**
+ * Dead Code 檢測器
+ */
+export class DeadCodeDetector {
+    indexEngine;
+    parserRegistry;
+    fileSystem;
+    options;
+    constructor(indexEngine, parserRegistry, fileSystem, options) {
+        this.indexEngine = indexEngine;
+        this.parserRegistry = parserRegistry;
+        this.fileSystem = fileSystem;
+        this.options = { ...DEFAULT_DEAD_CODE_OPTIONS, ...options };
+    }
+    /**
+     * 執行 Dead Code 檢測
+     */
+    async detect() {
+        const startTime = Date.now();
+        try {
+            // 取得所有已索引檔案
+            const indexedFiles = this.indexEngine.getAllIndexedFiles();
+            const filePaths = indexedFiles.map(f => f.filePath);
+            // 收集所有符號
+            const { symbols: allSymbols, skippedFiles } = await this.collectAllSymbols(filePaths);
+            // 過濾要檢測的符號類型
+            const targetSymbols = allSymbols.filter(s => this.options.symbolTypes.includes(s.type));
+            // 建立 SymbolFinder
+            const symbolFinder = createSymbolFinder(this.parserRegistry, this.fileSystem);
+            // 檢測每個符號的引用
+            const deadItems = [];
+            for (const symbol of targetSymbols) {
+                // 排除模式檢查
+                if (this.shouldExclude(symbol)) {
+                    continue;
+                }
+                // 查找引用
+                const references = await symbolFinder.findReferences(symbol.name, filePaths);
+                // 分析引用：過濾掉定義位置本身
+                const symbolLine = symbol.location.range.start.line;
+                const symbolFile = symbol.location.filePath;
+                const usageRefs = references.filter(ref => {
+                    // 排除定義位置（同檔案，±1 行容錯）
+                    const isSameLocation = ref.location.filePath === symbolFile
+                        && Math.abs(ref.location.range.start.line - symbolLine) <= 1;
+                    if (isSameLocation) {
+                        return false;
+                    }
+                    // 只計算 usage 類型
+                    return ref.type === SymbolReferenceType.Usage;
+                });
+                const hasExport = symbol.modifiers.includes('export');
+                // 判斷是否為 dead code
+                if (usageRefs.length === 0) {
+                    // 沒有使用引用
+                    if (hasExport && !this.options.includeExports) {
+                        // export 的符號，可能被外部使用，跳過
+                        continue;
+                    }
+                    const confidence = this.calculateConfidence(symbol, references.length, hasExport);
+                    if (confidence >= this.options.minConfidence) {
+                        deadItems.push({
+                            name: symbol.name,
+                            type: symbol.type,
+                            location: symbol.location,
+                            confidence,
+                            reason: this.generateReason(symbol, hasExport, references.length)
+                        });
+                    }
+                }
+            }
+            // 計算統計
+            const stats = this.calculateStats(targetSymbols.length, deadItems, startTime, skippedFiles);
+            return {
+                success: true,
+                items: deadItems,
+                stats
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                items: [],
+                stats: {
+                    totalSymbols: 0,
+                    deadCodeCount: 0,
+                    byType: {},
+                    filesAffected: 0,
+                    scanTime: Date.now() - startTime,
+                    skippedFiles: 0
+                },
+                error: error instanceof Error ? error.message : String(error)
+            };
+        }
+    }
+    /**
+       * 收集所有符號
+       */
+    async collectAllSymbols(filePaths) {
+        const allSymbols = [];
+        let skippedFiles = 0;
+        for (const filePath of filePaths) {
+            const parser = this.getParser(filePath);
+            if (!parser) {
+                continue;
+            }
+            try {
+                const content = await this.readFile(filePath);
+                if (!content) {
+                    continue;
+                }
+                const ast = await parser.parse(content, filePath);
+                const symbols = await parser.extractSymbols(ast);
+                allSymbols.push(...symbols);
+            }
+            catch (error) {
+                skippedFiles++;
+                // 非測試環境記錄警告
+                if (process.env.NODE_ENV !== 'test') {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    console.warn(`⚠️  跳過檔案 ${filePath}: ${errorMessage}`);
+                }
+            }
+        }
+        return { symbols: allSymbols, skippedFiles };
+    }
+    /**
+     * 判斷是否應排除
+     */
+    shouldExclude(symbol) {
+        // 排除建構子
+        if (symbol.name === 'constructor') {
+            return true;
+        }
+        // 排除名稱模式
+        for (const pattern of this.options.excludePatterns) {
+            if (symbol.name === pattern || symbol.name.toLowerCase() === pattern.toLowerCase()) {
+                return true;
+            }
+            // 支援 glob 模式
+            if (pattern.includes('*')) {
+                const regex = new RegExp('^' + pattern.replace(/\*/g, '.*') + '$');
+                if (regex.test(symbol.name)) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+    /**
+     * 計算信心程度
+     */
+    calculateConfidence(symbol, totalRefs, hasExport) {
+        let confidence = 1.0;
+        // 有定義引用但無使用引用，信心較高
+        if (totalRefs > 0) {
+            confidence = 0.95;
+        }
+        // export 的符號信心較低（可能被外部使用）
+        if (hasExport) {
+            confidence *= 0.7;
+        }
+        // 私有符號信心較高
+        if (symbol.modifiers.includes('private')) {
+            confidence = Math.min(confidence * 1.1, 1.0);
+        }
+        return Math.round(confidence * 100) / 100;
+    }
+    /**
+     * 產生原因說明
+     */
+    generateReason(symbol, hasExport, totalRefs) {
+        const typeLabel = this.getTypeLabel(symbol.type);
+        if (totalRefs === 0) {
+            return `${typeLabel} '${symbol.name}' 沒有任何引用`;
+        }
+        if (hasExport) {
+            return `${typeLabel} '${symbol.name}' 已 export 但在專案內無使用引用`;
+        }
+        return `${typeLabel} '${symbol.name}' 只有定義，無使用引用`;
+    }
+    /**
+     * 取得類型標籤
+     */
+    getTypeLabel(type) {
+        const labels = {
+            function: '函式',
+            class: '類別',
+            variable: '變數',
+            interface: '介面',
+            type: '型別',
+            property: '屬性',
+            method: '方法',
+            enum: '列舉',
+            constant: '常數'
+        };
+        return labels[type] || type;
+    }
+    /**
+     * 計算統計
+     */
+    calculateStats(totalSymbols, deadItems, startTime, skippedFiles) {
+        const byType = {};
+        for (const item of deadItems) {
+            byType[item.type] = (byType[item.type] || 0) + 1;
+        }
+        const filesAffected = new Set(deadItems.map(item => item.location.filePath)).size;
+        return {
+            totalSymbols,
+            deadCodeCount: deadItems.length,
+            byType,
+            filesAffected,
+            scanTime: Date.now() - startTime,
+            skippedFiles
+        };
+    }
+    /**
+     * 取得 Parser
+     */
+    getParser(filePath) {
+        const extension = this.getFileExtension(filePath);
+        return this.parserRegistry.getParser(extension);
+    }
+    /**
+     * 取得副檔名
+     */
+    getFileExtension(filePath) {
+        const lastDot = filePath.lastIndexOf('.');
+        return lastDot >= 0 ? filePath.substring(lastDot) : '';
+    }
+    /**
+     * 讀取檔案
+     */
+    async readFile(filePath) {
+        try {
+            const content = await this.fileSystem.readFile(filePath, 'utf-8');
+            return typeof content === 'string' ? content : content.toString('utf-8');
+        }
+        catch {
+            return null;
+        }
+    }
+}
+/**
+ * 建立 DeadCodeDetector 實例
+ */
+export function createDeadCodeDetector(indexEngine, parserRegistry, fileSystem, options) {
+    return new DeadCodeDetector(indexEngine, parserRegistry, fileSystem, options);
+}
+//# sourceMappingURL=dead-code-detector.js.map

package/dist/core/dead-code/dead-code-detector.js.map

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

package/dist/core/dead-code/dead-code-remover.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Dead Code 刪除器
+ * 負責刪除未使用的程式碼並清理相關 import
+ */
+import type { IFileSystem } from '../../infrastructure/storage/file-system.interface.js';
+import type { ParserRegistry } from '../../infrastructure/parser/registry.js';
+import type { DeadCodeItem, DeadCodeRemovalOptions, DeadCodeRemovalPreview, DeadCodeRemovalResult } from './types.js';
+/**
+ * Dead Code 刪除器
+ */
+export declare class DeadCodeRemover {
+    private readonly fileSystem;
+    private readonly parserRegistry;
+    private readonly options;
+    private readonly fileCache;
+    private readonly symbolFinder;
+    constructor(fileSystem: IFileSystem, parserRegistry: ParserRegistry, options?: DeadCodeRemovalOptions);
+    /**
+     * 預覽刪除操作
+     */
+    preview(deadCodeItems: readonly DeadCodeItem[]): Promise<DeadCodeRemovalPreview>;
+    /**
+     * 執行刪除（非 dry-run 時）
+     */
+    execute(preview: DeadCodeRemovalPreview): Promise<DeadCodeRemovalResult>;
+    /**
+     * 過濾符合刪除條件的項目
+     */
+    private filterItems;
+    /**
+     * 產生刪除操作
+     */
+    private generateRemovalOperations;
+    /**
+     * 分析需要清理的 import
+     * 支援部分清理：當 import { A, B, C } 中只有部分符號未使用時，保留其他符號
+     */
+    private analyzeImportCleanups;
+    /**
+     * 產生部分清理後的 import 語句
+     * 支援：純 named import、混合 default + named import
+     */
+    private generatePartialImport;
+    /**
+     * 解析 import 語句（以語句為單位）
+     * 支援 named import, default import, namespace import, 多行 import
+     */
+    private parseImportStatements;
+    /**
+     * 解析單行或合併後的 import 語句
+     */
+    private parseImportStatementLine;
+    /**
+     * 解析 named import 中的符號
+     */
+    private parseNamedSymbols;
+    /**
+     * 檢查 import 是否仍被使用
+     * 使用 SymbolFinder.findReferencesInFile 進行語義分析
+     */
+    private isImportStillUsed;
+    /**
+     * 移除註解和字串，用於準確檢測符號使用
+     */
+    private removeCommentsAndStrings;
+    /**
+     * 擴展範圍至完整宣告（包含前導註解和空行）
+     * 使用清理後的內容進行括號匹配，避免字串/註解中的括號干擾
+     */
+    private expandRangeToFullDeclaration;
+    /**
+     * 移除單行中的註解和字串（用於括號匹配）
+     */
+    private removeCommentsAndStringsFromLine;
+    /**
+     * 提取程式碼
+     */
+    private extractCode;
+    /**
+     * 按檔案分組操作（去重相同 range）
+     */
+    private groupOperationsByFile;
+    /**
+     * 套用檔案操作
+     */
+    private applyFileOperations;
+    /**
+     * 清理連續空行
+     */
+    private cleanupEmptyLines;
+    /**
+     * 計算統計摘要
+     */
+    private calculateSummary;
+    /**
+     * 收集影響的檔案
+     */
+    private collectAffectedFiles;
+    /**
+     * 建立空的預覽結果
+     */
+    private createEmptyPreview;
+    /**
+     * 建立空的統計摘要
+     */
+    private createEmptySummary;
+    /**
+     * 讀取檔案
+     */
+    private readFile;
+    /**
+     * 寫入檔案
+     */
+    private writeFile;
+    /**
+     * 檢查檔案路徑是否匹配排除模式
+     * 支援 glob 模式（如 *.test.ts、**\/__tests__/**）和簡單字串匹配
+     */
+    private matchesExcludePattern;
+    /**
+     * 逸出正則表達式特殊字符
+     */
+    private escapeRegex;
+    /**
+     * 清除快取
+     */
+    clearCache(): void;
+}
+/**
+ * 建立 DeadCodeRemover 實例
+ */
+export declare function createDeadCodeRemover(fileSystem: IFileSystem, parserRegistry: ParserRegistry, options?: DeadCodeRemovalOptions): DeadCodeRemover;
+//# sourceMappingURL=dead-code-remover.d.ts.map

package/dist/core/dead-code/dead-code-remover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-code-remover.d.ts","sourceRoot":"","sources":["../../../src/core/dead-code/dead-code-remover.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAC;AACpF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,KAAK,EACV,YAAY,EACZ,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EAKtB,MAAM,YAAY,CAAC;AA6CpB;;GAEG;AACH,qBAAa,eAAe;IAMxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc;IANjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;gBAGzB,UAAU,EAAE,WAAW,EACvB,cAAc,EAAE,cAAc,EAC/C,OAAO,CAAC,EAAE,sBAAsB;IAMlC;;OAEG;IACG,OAAO,CAAC,aAAa,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA+CtF;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAkC9E;;OAEG;IACH,OAAO,CAAC,WAAW;IAkCnB;;OAEG;YACW,yBAAyB;IAmCvC;;;OAGG;YACW,qBAAqB;IAyEnC;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAkD7B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAuD7B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAgEhC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqBzB;;;OAGG;YACW,iBAAiB;IA2B/B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAqBhC;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IA2FpC;;OAEG;IACH,OAAO,CAAC,gCAAgC;IAsBxC;;OAEG;IACH,OAAO,CAAC,WAAW;IA0BnB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA4C7B;;OAEG;YACW,mBAAmB;IAyEjC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiCxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;YACW,QAAQ;IAiBtB;;OAEG;YACW,SAAS;IAKvB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,WAAW,EACvB,cAAc,EAAE,cAAc,EAC9B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,eAAe,CAEjB"}