agent-ide 0.1.10 → 0.3.3

package/dist/plugins/python/analyzers/naming-checker.js

@@ -0,0 +1,220 @@
+/**
+ * Python 命名規範檢查器
+ * 檢查 PEP8 命名規範
+ */
+import { SymbolType } from '../../../shared/types/index.js';
+import { NAMING_PATTERNS } from '../types.js';
+/**
+ * Python 命名規範檢查器類別
+ */
+export class PythonNamingChecker {
+    /**
+     * 檢查命名規範問題
+     */
+    check(symbols, filePath) {
+        const issues = [];
+        for (const symbol of symbols) {
+            const issue = this.checkSymbolNaming(symbol, filePath);
+            if (issue) {
+                issues.push(issue);
+            }
+        }
+        return issues;
+    }
+    /**
+     * 檢查單個符號的命名
+     */
+    checkSymbolNaming(symbol, filePath) {
+        const { name, type } = symbol;
+        // 跳過特殊名稱
+        if (this.isSpecialName(name)) {
+            return null;
+        }
+        // 根據符號類型檢查命名
+        switch (type) {
+            case SymbolType.Class:
+                return this.checkClassName(symbol, filePath);
+            case SymbolType.Function:
+                return this.checkFunctionName(symbol, filePath);
+            case SymbolType.Variable:
+                return this.checkVariableName(symbol, filePath);
+            case SymbolType.Constant:
+                return this.checkConstantName(symbol, filePath);
+            case SymbolType.Module:
+                return this.checkModuleName(symbol, filePath);
+            default:
+                return null;
+        }
+    }
+    /**
+     * 檢查類別名稱（應為 PascalCase）
+     */
+    checkClassName(symbol, filePath) {
+        const { name } = symbol;
+        if (!NAMING_PATTERNS.pascalCase.test(name)) {
+            return {
+                type: 'invalid-naming',
+                symbolName: name,
+                symbolType: 'class',
+                location: {
+                    filePath,
+                    line: symbol.location.range.start.line,
+                    column: symbol.location.range.start.column
+                },
+                message: `類別名稱 '${name}' 應使用 PascalCase`,
+                suggestedName: this.toPascalCase(name)
+            };
+        }
+        return null;
+    }
+    /**
+     * 檢查函式名稱（應為 snake_case）
+     */
+    checkFunctionName(symbol, filePath) {
+        const { name } = symbol;
+        // 私有方法可以用 _開頭
+        if (name.startsWith('_')) {
+            const privateName = name.substring(1);
+            if (privateName.startsWith('_')) {
+                // __dunder__ 方法
+                return null;
+            }
+            if (!NAMING_PATTERNS.snakeCase.test(privateName) && privateName.length > 0) {
+                return {
+                    type: 'invalid-naming',
+                    symbolName: name,
+                    symbolType: 'function',
+                    location: {
+                        filePath,
+                        line: symbol.location.range.start.line,
+                        column: symbol.location.range.start.column
+                    },
+                    message: `私有函式名稱 '${name}' 應使用 _snake_case`,
+                    suggestedName: '_' + this.toSnakeCase(privateName)
+                };
+            }
+            return null;
+        }
+        if (!NAMING_PATTERNS.snakeCase.test(name)) {
+            return {
+                type: 'invalid-naming',
+                symbolName: name,
+                symbolType: 'function',
+                location: {
+                    filePath,
+                    line: symbol.location.range.start.line,
+                    column: symbol.location.range.start.column
+                },
+                message: `函式名稱 '${name}' 應使用 snake_case`,
+                suggestedName: this.toSnakeCase(name)
+            };
+        }
+        return null;
+    }
+    /**
+     * 檢查變數名稱（應為 snake_case）
+     */
+    checkVariableName(symbol, filePath) {
+        const { name } = symbol;
+        // 跳過單字母變數（迴圈變數）
+        if (name.length === 1) {
+            return null;
+        }
+        // 私有變數
+        if (name.startsWith('_') && !name.startsWith('__')) {
+            return null;
+        }
+        // 檢查是否為常量（全大寫）
+        if (NAMING_PATTERNS.upperSnakeCase.test(name)) {
+            return null;
+        }
+        if (!NAMING_PATTERNS.snakeCase.test(name)) {
+            return {
+                type: 'invalid-naming',
+                symbolName: name,
+                symbolType: 'variable',
+                location: {
+                    filePath,
+                    line: symbol.location.range.start.line,
+                    column: symbol.location.range.start.column
+                },
+                message: `變數名稱 '${name}' 應使用 snake_case`,
+                suggestedName: this.toSnakeCase(name)
+            };
+        }
+        return null;
+    }
+    /**
+     * 檢查常量名稱（應為 UPPER_SNAKE_CASE）
+     */
+    checkConstantName(symbol, filePath) {
+        const { name } = symbol;
+        if (!NAMING_PATTERNS.upperSnakeCase.test(name)) {
+            return {
+                type: 'invalid-naming',
+                symbolName: name,
+                symbolType: 'constant',
+                location: {
+                    filePath,
+                    line: symbol.location.range.start.line,
+                    column: symbol.location.range.start.column
+                },
+                message: `常量名稱 '${name}' 應使用 UPPER_SNAKE_CASE`,
+                suggestedName: this.toUpperSnakeCase(name)
+            };
+        }
+        return null;
+    }
+    /**
+     * 檢查模組名稱（應為 snake_case）
+     */
+    checkModuleName(symbol, filePath) {
+        // 模組名稱檢查通常基於檔案名稱，這裡跳過
+        return null;
+    }
+    /**
+     * 判斷是否為特殊名稱
+     */
+    isSpecialName(name) {
+        // __dunder__ 方法
+        if (name.startsWith('__') && name.endsWith('__')) {
+            return true;
+        }
+        // 常見的簡短變數名
+        const shortNames = new Set(['i', 'j', 'k', 'n', 'x', 'y', 'z', 'e', 'f', 'fd', 'id']);
+        if (shortNames.has(name)) {
+            return true;
+        }
+        // self, cls
+        if (name === 'self' || name === 'cls') {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * 轉換為 PascalCase
+     */
+    toPascalCase(name) {
+        return name
+            .split(/[_\s-]+/)
+            .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+            .join('');
+    }
+    /**
+     * 轉換為 snake_case
+     */
+    toSnakeCase(name) {
+        return name
+            .replace(/([A-Z])/g, '_$1')
+            .toLowerCase()
+            .replace(/^_/, '')
+            .replace(/__+/g, '_');
+    }
+    /**
+     * 轉換為 UPPER_SNAKE_CASE
+     */
+    toUpperSnakeCase(name) {
+        return this.toSnakeCase(name).toUpperCase();
+    }
+}
+//# sourceMappingURL=naming-checker.js.map

package/dist/plugins/python/analyzers/naming-checker.js.map

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

package/dist/plugins/python/analyzers/pattern-detector.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Python 設計模式檢測器
+ * 檢測 Singleton、Factory、Decorator 等模式
+ */
+import type { PatternMatch } from '../../../infrastructure/parser/analysis-types.js';
+import { type PythonAST } from '../types.js';
+/**
+ * Python 設計模式檢測器類別
+ */
+export declare class PythonPatternDetector {
+    /**
+     * 檢測設計模式
+     */
+    detect(code: string, ast: PythonAST): PatternMatch[];
+    /**
+     * 檢測 Singleton 模式
+     */
+    private detectSingleton;
+    /**
+     * 檢測 Factory 模式
+     */
+    private detectFactory;
+    /**
+     * 檢測 Decorator 模式
+     */
+    private detectDecorator;
+    /**
+     * 檢測反模式
+     */
+    private detectAntiPatterns;
+    /**
+     * 檢測 God Class
+     */
+    private detectGodClass;
+    /**
+     * 檢測過長的函式
+     */
+    private detectLongFunction;
+    /**
+     * 檢測過深的巢狀
+     */
+    private detectDeepNesting;
+}
+//# sourceMappingURL=pattern-detector.d.ts.map

package/dist/plugins/python/analyzers/pattern-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-detector.d.ts","sourceRoot":"","sources":["../../../../src/plugins/python/analyzers/pattern-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EAAE,KAAK,SAAS,EAAsC,MAAM,aAAa,CAAC;AAGjF;;GAEG;AACH,qBAAa,qBAAqB;IAChC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,YAAY,EAAE;IAkBpD;;OAEG;IACH,OAAO,CAAC,eAAe;IAgCvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAsCrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAwBvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAiCtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgC1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAyC1B"}

package/dist/plugins/python/analyzers/pattern-detector.js

@@ -0,0 +1,222 @@
+/**
+ * Python 設計模式檢測器
+ * 檢測 Singleton、Factory、Decorator 等模式
+ */
+import { PythonNodeKind } from '../types.js';
+import { traverseAST } from '../tree-sitter-bridge.js';
+/**
+ * Python 設計模式檢測器類別
+ */
+export class PythonPatternDetector {
+    /**
+     * 檢測設計模式
+     */
+    detect(code, ast) {
+        const patterns = [];
+        // 檢測 Singleton 模式
+        this.detectSingleton(ast, patterns);
+        // 檢測 Factory 模式
+        this.detectFactory(ast, patterns);
+        // 檢測 Decorator 模式
+        this.detectDecorator(ast, patterns);
+        // 檢測反模式
+        this.detectAntiPatterns(ast, patterns);
+        return patterns;
+    }
+    /**
+     * 檢測 Singleton 模式
+     */
+    detectSingleton(ast, patterns) {
+        traverseAST(ast.root, (node) => {
+            if (node.pythonKind === PythonNodeKind.ClassDefinition) {
+                const classText = node.treeSitterNode.text;
+                // 檢查常見的 Singleton 實作方式
+                const isSingleton = (classText.includes('_instance')
+                    && (classText.includes('__new__') || classText.includes('__call__'))) || (classText.includes('@singleton'));
+                if (isSingleton) {
+                    const nameNode = node.treeSitterNode.childForFieldName('name');
+                    patterns.push({
+                        pattern: 'Singleton',
+                        type: 'design-pattern',
+                        locations: [{
+                                filePath: ast.sourceFile,
+                                startLine: node.range.start.line,
+                                endLine: node.range.end.line
+                            }],
+                        count: 1,
+                        severity: 'low',
+                        suggestion: '確保 Singleton 是否真的必要，考慮使用依賴注入'
+                    });
+                }
+            }
+        });
+    }
+    /**
+     * 檢測 Factory 模式
+     */
+    detectFactory(ast, patterns) {
+        const factoryLocations = [];
+        traverseAST(ast.root, (node) => {
+            if (node.pythonKind === PythonNodeKind.FunctionDefinition
+                || node.pythonKind === PythonNodeKind.ClassDefinition) {
+                const nameNode = node.treeSitterNode.childForFieldName('name');
+                const name = nameNode?.text || '';
+                // 檢查命名是否包含 Factory 或 create
+                if (name.toLowerCase().includes('factory')
+                    || name.toLowerCase().startsWith('create_')
+                    || name.toLowerCase().startsWith('make_')
+                    || name.toLowerCase().startsWith('build_')) {
+                    factoryLocations.push({
+                        filePath: ast.sourceFile,
+                        startLine: node.range.start.line,
+                        endLine: node.range.end.line
+                    });
+                }
+            }
+        });
+        if (factoryLocations.length > 0) {
+            patterns.push({
+                pattern: 'Factory',
+                type: 'design-pattern',
+                locations: factoryLocations,
+                count: factoryLocations.length,
+                severity: 'low'
+            });
+        }
+    }
+    /**
+     * 檢測 Decorator 模式
+     */
+    detectDecorator(ast, patterns) {
+        const decoratorLocations = [];
+        traverseAST(ast.root, (node) => {
+            if (node.pythonKind === PythonNodeKind.DecoratedDefinition) {
+                decoratorLocations.push({
+                    filePath: ast.sourceFile,
+                    startLine: node.range.start.line,
+                    endLine: node.range.end.line
+                });
+            }
+        });
+        if (decoratorLocations.length > 0) {
+            patterns.push({
+                pattern: 'Decorator',
+                type: 'design-pattern',
+                locations: decoratorLocations,
+                count: decoratorLocations.length,
+                severity: 'low'
+            });
+        }
+    }
+    /**
+     * 檢測反模式
+     */
+    detectAntiPatterns(ast, patterns) {
+        // 檢測 God Class（過多方法的類別）
+        this.detectGodClass(ast, patterns);
+        // 檢測過長的函式
+        this.detectLongFunction(ast, patterns);
+        // 檢測過深的巢狀
+        this.detectDeepNesting(ast, patterns);
+    }
+    /**
+     * 檢測 God Class
+     */
+    detectGodClass(ast, patterns) {
+        traverseAST(ast.root, (node) => {
+            if (node.pythonKind === PythonNodeKind.ClassDefinition) {
+                let methodCount = 0;
+                traverseAST(node, (child) => {
+                    if (child.pythonKind === PythonNodeKind.FunctionDefinition
+                        || child.pythonKind === PythonNodeKind.AsyncFunctionDefinition) {
+                        methodCount++;
+                    }
+                });
+                if (methodCount > 20) {
+                    const nameNode = node.treeSitterNode.childForFieldName('name');
+                    patterns.push({
+                        pattern: 'God Class',
+                        type: 'anti-pattern',
+                        locations: [{
+                                filePath: ast.sourceFile,
+                                startLine: node.range.start.line,
+                                endLine: node.range.end.line
+                            }],
+                        count: 1,
+                        severity: 'high',
+                        suggestion: `類別 '${nameNode?.text}' 有 ${methodCount} 個方法，考慮拆分成更小的類別`
+                    });
+                }
+            }
+        });
+    }
+    /**
+     * 檢測過長的函式
+     */
+    detectLongFunction(ast, patterns) {
+        const longFunctionLocations = [];
+        traverseAST(ast.root, (node) => {
+            if (node.pythonKind === PythonNodeKind.FunctionDefinition
+                || node.pythonKind === PythonNodeKind.AsyncFunctionDefinition) {
+                const lineCount = node.range.end.line - node.range.start.line + 1;
+                if (lineCount > 50) {
+                    longFunctionLocations.push({
+                        filePath: ast.sourceFile,
+                        startLine: node.range.start.line,
+                        endLine: node.range.end.line
+                    });
+                }
+            }
+        });
+        if (longFunctionLocations.length > 0) {
+            patterns.push({
+                pattern: 'Long Function',
+                type: 'anti-pattern',
+                locations: longFunctionLocations,
+                count: longFunctionLocations.length,
+                severity: 'medium',
+                suggestion: '函式超過 50 行，考慮拆分成更小的函式'
+            });
+        }
+    }
+    /**
+     * 檢測過深的巢狀
+     */
+    detectDeepNesting(ast, patterns) {
+        const deepNestingLocations = [];
+        const checkNestingDepth = (node, depth) => {
+            const nestingNodes = new Set([
+                PythonNodeKind.IfStatement,
+                PythonNodeKind.ForStatement,
+                PythonNodeKind.WhileStatement,
+                PythonNodeKind.TryStatement,
+                PythonNodeKind.WithStatement
+            ]);
+            if (nestingNodes.has(node.pythonKind)) {
+                depth++;
+                if (depth > 4) {
+                    deepNestingLocations.push({
+                        filePath: ast.sourceFile,
+                        startLine: node.range.start.line,
+                        endLine: node.range.end.line
+                    });
+                }
+            }
+            for (const child of node.children) {
+                checkNestingDepth(child, depth);
+            }
+        };
+        checkNestingDepth(ast.root, 0);
+        if (deepNestingLocations.length > 0) {
+            patterns.push({
+                pattern: 'Deep Nesting',
+                type: 'anti-pattern',
+                locations: deepNestingLocations,
+                count: deepNestingLocations.length,
+                severity: 'medium',
+                suggestion: '巢狀層級超過 4 層，考慮使用 early return 或提取函式'
+            });
+        }
+    }
+}
+//# sourceMappingURL=pattern-detector.js.map

package/dist/plugins/python/analyzers/pattern-detector.js.map

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

package/dist/plugins/python/analyzers/security-checker.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Python 安全性檢查器
+ * 檢查 eval()、exec()、SQL injection 等安全問題
+ */
+import type { SecurityIssue } from '../../../infrastructure/parser/analysis-types.js';
+import { type PythonAST } from '../types.js';
+/**
+ * Python 安全性檢查器類別
+ */
+export declare class PythonSecurityChecker {
+    /**
+     * 檢查安全性問題
+     */
+    check(code: string, ast: PythonAST): SecurityIssue[];
+    /**
+     * 檢查危險函數調用
+     */
+    private checkDangerousFunctions;
+    /**
+     * 檢查危險的屬性調用
+     */
+    private checkDangerousAttributeCall;
+    /**
+     * 檢查硬編碼密碼
+     */
+    private checkHardcodedSecrets;
+    /**
+     * 檢查 SQL injection
+     */
+    private checkSQLInjection;
+    /**
+     * 檢查不安全的 pickle 使用
+     */
+    private checkUnsafePickle;
+    /**
+     * 檢查 shell injection
+     */
+    private checkShellInjection;
+    /**
+     * 檢查字串是否包含格式化
+     */
+    private containsStringFormatting;
+    /**
+     * 檢查是否有 shell=True 參數
+     */
+    private hasShellTrue;
+    /**
+     * 獲取危險函數的嚴重程度
+     */
+    private getDangerousFunctionSeverity;
+    /**
+     * 獲取危險函數的建議
+     */
+    private getDangerousFunctionRecommendation;
+}
+//# sourceMappingURL=security-checker.d.ts.map

package/dist/plugins/python/analyzers/security-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security-checker.d.ts","sourceRoot":"","sources":["../../../../src/plugins/python/analyzers/security-checker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,EAAE,KAAK,SAAS,EAAuF,MAAM,aAAa,CAAC;AAGlI;;GAEG;AACH,qBAAa,qBAAqB;IAChC;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,aAAa,EAAE;IAqBpD;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA+B/B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IA6CnC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAoC7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkCzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiC3B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAwBhC;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACH,OAAO,CAAC,4BAA4B;IASpC;;OAEG;IACH,OAAO,CAAC,kCAAkC;CAY3C"}