agent-ide 0.1.10 → 0.3.3

package/dist/plugins/typescript/analyzers/unused-symbol-detector.js

@@ -0,0 +1,152 @@
+/**
+ * TypeScript 未使用符號檢測器
+ * 檢測未使用的變數、函式、類別
+ */
+import { SymbolType, ReferenceType } from '../../../shared/types/index.js';
+/**
+ * 未使用符號檢測器
+ */
+export class UnusedSymbolDetector {
+    /**
+     * 檢測未使用的符號
+     * @param ast TypeScript AST 物件
+     * @param allSymbols 所有符號列表
+     * @param findReferences 查找引用的函式（從 parser 傳入）
+     * @returns 未使用的符號列表
+     */
+    async detect(ast, allSymbols, findReferences) {
+        const unused = [];
+        // 優化：提早過濾，只對需要檢測的符號建立 reference map
+        const symbolsToCheck = allSymbols.filter(symbol => {
+            // 跳過已匯出的符號
+            if (this.isExported(symbol)) {
+                return false;
+            }
+            // 跳過函式參數
+            if (this.isParameter(symbol)) {
+                return false;
+            }
+            // 跳過 public/protected 類別成員
+            if (this.isPublicOrProtectedMember(symbol)) {
+                return false;
+            }
+            return true;
+        });
+        // 只對需要檢測的符號建立 reference map
+        const referenceMap = await this.buildReferenceMap(ast, symbolsToCheck, findReferences);
+        for (const symbol of symbolsToCheck) {
+            // 從映射表中查找引用（O(1)）
+            const references = referenceMap.get(symbol.name) || [];
+            // 過濾出實際使用（非定義）的引用
+            const usageReferences = references.filter(ref => ref.type === ReferenceType.Usage);
+            if (usageReferences.length === 0) {
+                unused.push({
+                    type: this.mapSymbolType(symbol.type),
+                    name: symbol.name,
+                    location: {
+                        filePath: symbol.location.filePath,
+                        line: symbol.location.range.start.line,
+                        column: symbol.location.range.start.column
+                    },
+                    confidence: this.calculateConfidence(references),
+                    reason: `${this.mapSymbolType(symbol.type)} '${symbol.name}' 已宣告但從未使用`
+                });
+            }
+        }
+        return unused;
+    }
+    /**
+     * 建立引用映射表（批次處理）
+     * 優化：使用 Promise.all 並行處理多個符號
+     */
+    async buildReferenceMap(ast, symbols, findReferences) {
+        const referenceMap = new Map();
+        // 如果符號數量很少，直接處理
+        if (symbols.length === 0) {
+            return referenceMap;
+        }
+        // 增加批次大小以提升效能
+        const batchSize = 50;
+        for (let i = 0; i < symbols.length; i += batchSize) {
+            const batch = symbols.slice(i, i + batchSize);
+            // 批次並行處理
+            await Promise.all(batch.map(async (symbol) => {
+                try {
+                    const references = await findReferences(ast, symbol);
+                    referenceMap.set(symbol.name, references);
+                }
+                catch (error) {
+                    // 查找失敗時記錄空引用
+                    referenceMap.set(symbol.name, []);
+                }
+            }));
+        }
+        return referenceMap;
+    }
+    /**
+     * 檢查符號是否已匯出
+     */
+    isExported(symbol) {
+        return symbol.modifiers?.includes('export') || false;
+    }
+    /**
+     * 檢查是否為函式參數
+     */
+    isParameter(symbol) {
+        // 檢查 scope，如果 parent 是 function 且符號在參數位置，就是參數
+        if (symbol.scope?.type === 'function') {
+            // 簡化判斷：如果符號類型是 Variable 且在 function scope 內，可能是參數或局部變數
+            // 更準確的判斷需要檢查 AST 節點類型
+            return false; // 暫時保守處理，不跳過任何符號
+        }
+        return false;
+    }
+    /**
+     * 檢查是否為 public 或 protected 類別成員
+     * 這些成員可能被子類別或外部程式碼使用，單檔案模式無法檢測
+     */
+    isPublicOrProtectedMember(symbol) {
+        const modifiers = symbol.modifiers || [];
+        // 如果有 public 或 protected 修飾符
+        if (modifiers.includes('public') || modifiers.includes('protected')) {
+            return true;
+        }
+        // 檢查 scope：如果是類別成員（scope.parent.type === 'class'），且沒有 private 修飾符，預設就是 public
+        if (symbol.scope?.parent?.type === 'class' && !modifiers.includes('private')) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * 映射符號類型到 UnusedCode 類型
+     */
+    mapSymbolType(symbolType) {
+        switch (symbolType) {
+            case SymbolType.Function:
+                return 'function';
+            case SymbolType.Class:
+                return 'class';
+            case SymbolType.Variable:
+            case SymbolType.Constant:
+                return 'variable';
+            default:
+                return 'variable';
+        }
+    }
+    /**
+     * 計算檢測置信度
+     */
+    calculateConfidence(references) {
+        // 如果完全沒有引用（連定義都不算），置信度最高
+        if (references.length === 0) {
+            return 1.0;
+        }
+        // 如果只有定義引用，沒有使用引用
+        const usageRefs = references.filter((ref) => ref.type === ReferenceType.Usage);
+        if (usageRefs.length === 0) {
+            return 0.95;
+        }
+        return 0.9;
+    }
+}
+//# sourceMappingURL=unused-symbol-detector.js.map

package/dist/plugins/typescript/analyzers/unused-symbol-detector.js.map

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

package/dist/plugins/typescript/parser.d.ts

@@ -130,5 +130,46 @@ export declare class TypeScriptParser implements ParserPlugin, Disposable {
      * 檢查符號是否被遮蔽
      */
     private isShadowed;
+    /**
+     * 檢測未使用的符號
+     */
+    detectUnusedSymbols(ast: AST, allSymbols: Symbol[]): Promise<import('../../infrastructure/parser/analysis-types.js').UnusedCode[]>;
+    /**
+     * 分析程式碼複雜度
+     */
+    analyzeComplexity(code: string, ast: AST): Promise<import('../../infrastructure/parser/analysis-types.js').ComplexityMetrics>;
+    /**
+     * 提取程式碼片段（用於重複代碼檢測）
+     */
+    extractCodeFragments(code: string, filePath: string): Promise<import('../../infrastructure/parser/analysis-types.js').CodeFragment[]>;
+    private extractTopLevelComments;
+    private extractMethods;
+    private extractConstants;
+    private extractConfigObjects;
+    private tokenizeCode;
+    /**
+     * 檢測樣板模式
+     */
+    detectPatterns(code: string, ast: AST): Promise<import('../../infrastructure/parser/analysis-types.js').PatternMatch[]>;
+    /**
+     * 檢查型別安全問題
+     */
+    checkTypeSafety(code: string, ast: AST): Promise<import('../../infrastructure/parser/analysis-types.js').TypeSafetyIssue[]>;
+    /**
+     * 檢查錯誤處理問題
+     */
+    checkErrorHandling(code: string, ast: AST): Promise<import('../../infrastructure/parser/analysis-types.js').ErrorHandlingIssue[]>;
+    /**
+     * 檢查安全性問題
+     */
+    checkSecurity(code: string, ast: AST): Promise<import('../../infrastructure/parser/analysis-types.js').SecurityIssue[]>;
+    /**
+     * 檢查命名規範問題
+     */
+    checkNamingConventions(symbols: Symbol[], filePath: string): Promise<import('../../infrastructure/parser/analysis-types.js').NamingIssue[]>;
+    /**
+     * 判斷檔案是否為測試檔案
+     */
+    isTestFile(filePath: string): boolean;
 }
 //# sourceMappingURL=parser.d.ts.map

package/dist/plugins/typescript/parser.d.ts.map

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

package/dist/plugins/typescript/parser.js

@@ -6,8 +6,8 @@ import * as ts from 'typescript';
 import { createValidationSuccess, createValidationFailure, createCodeEdit, createDefinition, createUsage } from '../../infrastructure/parser/index.js';
 import { createAST, createASTMetadata, ReferenceType, SymbolType } from '../../shared/types/index.js';
 import { DEFAULT_COMPILER_OPTIONS, TypeScriptParseError, createTypeScriptASTNode, createParseError, tsPositionToPosition, positionToTsPosition, tsNodeToRange, isValidIdentifier } from './types.js';
-import { createSymbolExtractor } from './symbol-extractor.js';
-import { createDependencyAnalyzer } from './dependency-analyzer.js';
+import { createSymbolExtractor } from '../typescript/symbol-extractor.js';
+import { createDependencyAnalyzer } from '../typescript/dependency-analyzer.js';
 import { MemoryMonitor } from '../../shared/utils/memory-monitor.js';
 /**
  * TypeScript Parser 實作
@@ -533,7 +533,11 @@ export class TypeScriptParser {
                 return true;
             }
         }
-        // 3. 對於變數、函式和方法，使用作用域檢查
+        // 3. 檢查是否在同一個檔案中
+        if (node.getSourceFile() !== symbolIdentifier.getSourceFile()) {
+            return false;
+        }
+        // 4. 對於變數、函式和方法，使用作用域檢查
         const symbolScope = this.getScopeContainer(symbolIdentifier);
         const nodeScope = this.getScopeContainer(node);
         // 檢查是否在相同作用域或符號的子作用域內
@@ -543,6 +547,11 @@ export class TypeScriptParser {
                 return true;
             }
         }
+        // 5. 對於頂層函式和變數，放寬檢查條件
+        // 如果符號在頂層作用域（SourceFile），則同一檔案中所有同名標識符都可能是引用
+        if (ts.isSourceFile(symbolScope) && !this.isShadowed(node, symbolIdentifier)) {
+            return true;
+        }
         return false;
     }
     getIdentifierFromSymbolNode(node) {
@@ -973,5 +982,341 @@ export class TypeScriptParser {
         }
         return false;
     }
+    // ===== 新增：程式碼分析方法 =====
+    /**
+     * 檢測未使用的符號
+     */
+    async detectUnusedSymbols(ast, allSymbols) {
+        const { UnusedSymbolDetector } = await import('./analyzers/unused-symbol-detector.js');
+        const detector = new UnusedSymbolDetector();
+        return detector.detect(ast, allSymbols, this.findReferences.bind(this));
+    }
+    /**
+     * 分析程式碼複雜度
+     */
+    async analyzeComplexity(code, ast) {
+        const { ComplexityAnalyzer } = await import('./analyzers/complexity-analyzer.js');
+        const analyzer = new ComplexityAnalyzer();
+        return analyzer.analyze(code, ast);
+    }
+    /**
+     * 提取程式碼片段（用於重複代碼檢測）
+     */
+    async extractCodeFragments(code, filePath) {
+        const fragments = [];
+        // 1. 提取頂層註解
+        const commentFragments = await this.extractTopLevelComments(code, filePath);
+        fragments.push(...commentFragments);
+        // 2. 提取方法
+        const methodFragments = await this.extractMethods(code, filePath);
+        fragments.push(...methodFragments);
+        // 3. 提取常數定義
+        const constantFragments = await this.extractConstants(code, filePath);
+        fragments.push(...constantFragments);
+        // 4. 提取配置物件
+        const configFragments = await this.extractConfigObjects(code, filePath);
+        fragments.push(...configFragments);
+        return fragments;
+    }
+    async extractTopLevelComments(code, filePath) {
+        const { createHash } = await import('crypto');
+        const fragments = [];
+        const lines = code.split('\n');
+        let commentStart = -1;
+        let inBlockComment = false;
+        for (let i = 0; i < Math.min(50, lines.length); i++) {
+            const line = lines[i].trim();
+            if ((line.startsWith('/**') || line.startsWith('/*')) && commentStart === -1) {
+                commentStart = i;
+                inBlockComment = true;
+            }
+            if (inBlockComment && line.includes('*/')) {
+                const commentEnd = i;
+                const commentCode = lines.slice(commentStart, commentEnd + 1).join('\n');
+                const lineCount = commentEnd - commentStart + 1;
+                if (lineCount >= 3) {
+                    fragments.push({
+                        type: 'comment',
+                        code: commentCode,
+                        tokens: this.tokenizeCode(commentCode, true),
+                        location: { filePath, startLine: commentStart + 1, endLine: commentEnd + 1 },
+                        hash: createHash('md5').update(commentCode).digest('hex')
+                    });
+                }
+                commentStart = -1;
+                inBlockComment = false;
+            }
+            // 遇到非註解行就停止
+            if (!inBlockComment && line && !line.startsWith('//') && !line.startsWith('*')) {
+                break;
+            }
+        }
+        return fragments;
+    }
+    async extractMethods(code, filePath) {
+        const { createHash } = await import('crypto');
+        const fragments = [];
+        const lines = code.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // 匹配方法定義
+            if (/(async\s+)?(function\s+\w+|const\s+\w+\s*=\s*(async\s+)?\([^)]*\)\s*=>|\w+\s*\([^)]*\)\s*{)/.test(line)) {
+                let braceCount = (line.match(/{/g) || []).length - (line.match(/}/g) || []).length;
+                let endLine = i;
+                // 找到方法結尾
+                for (let j = i + 1; j < lines.length && braceCount > 0; j++) {
+                    braceCount += (lines[j].match(/{/g) || []).length;
+                    braceCount -= (lines[j].match(/}/g) || []).length;
+                    endLine = j;
+                }
+                if (endLine > i && (endLine - i + 1) >= 3) {
+                    const methodCode = lines.slice(i, endLine + 1).join('\n');
+                    fragments.push({
+                        type: 'method',
+                        code: methodCode,
+                        tokens: this.tokenizeCode(methodCode, false),
+                        location: { filePath, startLine: i + 1, endLine: endLine + 1 },
+                        hash: createHash('md5').update(methodCode).digest('hex')
+                    });
+                }
+            }
+        }
+        return fragments;
+    }
+    async extractConstants(code, filePath) {
+        const { createHash } = await import('crypto');
+        const fragments = [];
+        const lines = code.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // 匹配 export const XXX = { ... }
+            if (/export\s+const\s+\w+\s*=\s*{/.test(line)) {
+                let braceCount = 1;
+                let endLine = i;
+                for (let j = i + 1; j < lines.length && braceCount > 0; j++) {
+                    braceCount += (lines[j].match(/{/g) || []).length;
+                    braceCount -= (lines[j].match(/}/g) || []).length;
+                    endLine = j;
+                }
+                if (endLine > i && (endLine - i + 1) >= 3) {
+                    const constantCode = lines.slice(i, endLine + 1).join('\n');
+                    fragments.push({
+                        type: 'constant',
+                        code: constantCode,
+                        tokens: this.tokenizeCode(constantCode, false),
+                        location: { filePath, startLine: i + 1, endLine: endLine + 1 },
+                        hash: createHash('md5').update(constantCode).digest('hex')
+                    });
+                }
+            }
+        }
+        return fragments;
+    }
+    async extractConfigObjects(code, filePath) {
+        const { createHash } = await import('crypto');
+        const fragments = [];
+        const lines = code.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // 匹配配置物件模式
+            if (/config|Config|options|Options/.test(line) && /{/.test(line)) {
+                let braceCount = (line.match(/{/g) || []).length - (line.match(/}/g) || []).length;
+                let endLine = i;
+                for (let j = i + 1; j < lines.length && braceCount > 0; j++) {
+                    braceCount += (lines[j].match(/{/g) || []).length;
+                    braceCount -= (lines[j].match(/}/g) || []).length;
+                    endLine = j;
+                }
+                if (endLine > i && (endLine - i + 1) >= 3) {
+                    const configCode = lines.slice(i, endLine + 1).join('\n');
+                    fragments.push({
+                        type: 'config',
+                        code: configCode,
+                        tokens: this.tokenizeCode(configCode, false),
+                        location: { filePath, startLine: i + 1, endLine: endLine + 1 },
+                        hash: createHash('md5').update(configCode).digest('hex')
+                    });
+                }
+            }
+        }
+        return fragments;
+    }
+    tokenizeCode(code, includeComments) {
+        if (includeComments) {
+            return code.split(/\s+/).filter(t => t.length > 0);
+        }
+        // 移除註解
+        const withoutComments = code
+            .replace(/\/\*[\s\S]*?\*\//g, '')
+            .replace(/\/\/.*/g, '');
+        return withoutComments.split(/\s+/).filter(t => t.length > 0);
+    }
+    /**
+     * 檢測樣板模式
+     */
+    async detectPatterns(code, ast) {
+        const { PatternDetector, PatternType } = await import('./analyzers/pattern-detector.js');
+        const detector = new PatternDetector();
+        const groups = await detector.detectAll([ast.sourceFile]);
+        const patterns = [];
+        for (const [type, group] of groups.entries()) {
+            patterns.push({
+                pattern: type,
+                type: 'boilerplate',
+                locations: group.instances.map(instance => ({
+                    filePath: instance.file,
+                    startLine: instance.startLine,
+                    endLine: instance.endLine
+                })),
+                count: group.count,
+                severity: group.count > 10 ? 'high' : group.count > 5 ? 'medium' : 'low',
+                suggestion: group.recommendation
+            });
+        }
+        return patterns;
+    }
+    /**
+     * 檢查型別安全問題
+     */
+    async checkTypeSafety(code, ast) {
+        const { TypeSafetyChecker } = await import('./analyzers/type-safety-checker.js');
+        const checker = new TypeSafetyChecker();
+        const result = await checker.check([ast.sourceFile], process.cwd());
+        const issues = [];
+        // any 型別使用
+        for (let i = 0; i < result.anyTypeCount; i++) {
+            issues.push({
+                type: 'any-type',
+                location: { filePath: ast.sourceFile, line: 0, column: 0 },
+                message: '使用了 any 型別，降低型別安全性',
+                severity: 'warning'
+            });
+        }
+        // @ts-ignore 指令
+        for (let i = 0; i < result.tsIgnoreCount; i++) {
+            issues.push({
+                type: 'ignore-directive',
+                location: { filePath: ast.sourceFile, line: 0, column: 0 },
+                message: '使用了 @ts-ignore 忽略型別檢查',
+                severity: 'warning'
+            });
+        }
+        // as any 轉型
+        for (let i = 0; i < result.asAnyCount; i++) {
+            issues.push({
+                type: 'unsafe-cast',
+                location: { filePath: ast.sourceFile, line: 0, column: 0 },
+                message: '使用了 as any 強制轉型',
+                severity: 'error'
+            });
+        }
+        return issues;
+    }
+    /**
+     * 檢查錯誤處理問題
+     */
+    async checkErrorHandling(code, ast) {
+        const issues = [];
+        const lines = code.split('\n');
+        // 檢測空 catch 區塊
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            if (/catch\s*\([^)]*\)\s*\{\s*\}/.test(line)) {
+                issues.push({
+                    type: 'empty-catch',
+                    location: { filePath: ast.sourceFile, line: i + 1, column: 0 },
+                    message: '空的 catch 區塊，應該處理錯誤或記錄日誌',
+                    severity: 'warning'
+                });
+            }
+            // 檢測靜默吞錯（catch 內只有註解）
+            if (/catch\s*\([^)]*\)\s*\{[^}]*\/\/\s*(ignore|skip|TODO)[^}]*\}/.test(line)) {
+                issues.push({
+                    type: 'silent-error',
+                    location: { filePath: ast.sourceFile, line: i + 1, column: 0 },
+                    message: 'catch 區塊靜默吞錯，只有註解沒有實際處理',
+                    severity: 'warning'
+                });
+            }
+        }
+        return issues;
+    }
+    /**
+     * 檢查安全性問題
+     */
+    async checkSecurity(code, ast) {
+        const issues = [];
+        const lines = code.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // 檢測硬編碼密碼
+            if (/(password|passwd|pwd|secret|apiKey|token)\s*[:=]\s*['"][^'"]{3,}['"]/.test(line) &&
+                !/(process\.env|config\.|import)/.test(line)) {
+                issues.push({
+                    type: 'hardcoded-secret',
+                    location: { filePath: ast.sourceFile, line: i + 1, column: 0 },
+                    message: '硬編碼的密碼或密鑰，應使用環境變數',
+                    severity: 'critical'
+                });
+            }
+            // 檢測 eval 使用
+            if (/\beval\s*\(/.test(line)) {
+                issues.push({
+                    type: 'unsafe-eval',
+                    location: { filePath: ast.sourceFile, line: i + 1, column: 0 },
+                    message: '使用 eval 可能導致代碼注入風險',
+                    severity: 'high'
+                });
+            }
+            // 檢測 innerHTML
+            if (/\.innerHTML\s*=/.test(line) && !/(DOMPurify|sanitize)/.test(line)) {
+                issues.push({
+                    type: 'xss-vulnerability',
+                    location: { filePath: ast.sourceFile, line: i + 1, column: 0 },
+                    message: '直接設定 innerHTML 可能導致 XSS 攻擊',
+                    severity: 'medium'
+                });
+            }
+        }
+        return issues;
+    }
+    /**
+     * 檢查命名規範問題
+     */
+    async checkNamingConventions(symbols, filePath) {
+        const issues = [];
+        for (const symbol of symbols) {
+            // 檢測底線開頭變數（JavaScript/TypeScript 規範不建議）
+            if (symbol.name.startsWith('_') && symbol.type === SymbolType.Variable) {
+                issues.push({
+                    type: 'invalid-naming',
+                    symbolName: symbol.name,
+                    symbolType: symbol.type,
+                    location: {
+                        filePath,
+                        line: symbol.location.range.start.line,
+                        column: symbol.location.range.start.column
+                    },
+                    message: `變數 "${symbol.name}" 以底線開頭，違反命名規範`
+                });
+            }
+            // 檢測常數未使用大寫（如果標記為 const）
+            if (symbol.modifiers?.includes('const') &&
+                symbol.type === SymbolType.Variable &&
+                !/^[A-Z_]+$/.test(symbol.name) &&
+                symbol.name.length > 1) {
+                // 這是建議性質，不一定要強制
+            }
+        }
+        return issues;
+    }
+    /**
+     * 判斷檔案是否為測試檔案
+     */
+    isTestFile(filePath) {
+        return /\.(test|spec)\.(ts|tsx)$/.test(filePath) ||
+            filePath.includes('/__tests__/') ||
+            filePath.includes('/__mocks__/');
+    }
 }
 //# sourceMappingURL=parser.js.map