agent-ide 0.2.0 → 0.3.3

package/dist/plugins/python/tree-sitter-bridge.js

@@ -0,0 +1,267 @@
+/**
+ * tree-sitter 橋接層
+ * 負責 Parser 初始化和節點轉換
+ */
+import { Parser as TreeSitterParser, Language as TreeSitterLanguage } from 'web-tree-sitter';
+import { createRequire } from 'module';
+import path from 'path';
+import { PythonNodeKind, nodeTypeToKind, tsNodeToRange } from './types.js';
+const require = createRequire(import.meta.url);
+/** 單例 Parser 實例 */
+let parserInstance = null;
+/** Python 語言實例 */
+let pythonLanguage = null;
+/** 初始化狀態 */
+let isInitialized = false;
+let initializationPromise = null;
+/**
+ * 初始化 tree-sitter Parser
+ * 使用單例模式，確保只初始化一次
+ */
+export async function initializeParser() {
+    if (parserInstance && isInitialized) {
+        return parserInstance;
+    }
+    // 避免重複初始化
+    if (initializationPromise) {
+        await initializationPromise;
+        return parserInstance;
+    }
+    initializationPromise = (async () => {
+        await TreeSitterParser.init();
+        parserInstance = new TreeSitterParser();
+        // 載入 Python 語言 WASM
+        const wasmPath = resolveWasmPath();
+        pythonLanguage = await TreeSitterLanguage.load(wasmPath);
+        parserInstance.setLanguage(pythonLanguage);
+        isInitialized = true;
+    })();
+    await initializationPromise;
+    return parserInstance;
+}
+/**
+ * 解析 WASM 檔案路徑
+ */
+function resolveWasmPath() {
+    // 嘗試從 node_modules 解析
+    try {
+        const treeSitterPythonPath = require.resolve('tree-sitter-python');
+        const packageDir = path.dirname(treeSitterPythonPath);
+        return path.join(packageDir, 'tree-sitter-python.wasm');
+    }
+    catch {
+        // 備用路徑
+        return path.join(process.cwd(), 'node_modules', 'tree-sitter-python', 'tree-sitter-python.wasm');
+    }
+}
+/**
+ * 獲取 Parser 實例
+ * @throws 如果 Parser 未初始化
+ */
+export function getParser() {
+    if (!parserInstance || !isInitialized) {
+        throw new Error('Parser 尚未初始化，請先調用 initializeParser()');
+    }
+    return parserInstance;
+}
+/**
+ * 檢查 Parser 是否已初始化
+ */
+export function isParserInitialized() {
+    return isInitialized && parserInstance !== null;
+}
+/**
+ * 解析 Python 程式碼
+ */
+export async function parseCode(code) {
+    const parser = await initializeParser();
+    const tree = parser.parse(code);
+    if (!tree) {
+        throw new Error('解析失敗：無法解析程式碼');
+    }
+    return tree;
+}
+/**
+ * 轉換 tree-sitter Node 為 PythonASTNode
+ */
+export function convertNode(node, sourceFile) {
+    const type = node.type;
+    const range = tsNodeToRange(node);
+    const pythonKind = nodeTypeToKind(type);
+    // 提取節點屬性
+    const properties = {
+        nodeType: type,
+        isNamed: node.isNamed,
+        childCount: node.childCount,
+        namedChildCount: node.namedChildCount
+    };
+    // 提取名稱（如果存在）
+    const nameNode = node.childForFieldName('name');
+    if (nameNode) {
+        properties.name = nameNode.text;
+    }
+    // 提取型別註解（如果存在）
+    let typeAnnotation;
+    const typeNode = node.childForFieldName('type')
+        || node.childForFieldName('return_type');
+    if (typeNode) {
+        typeAnnotation = typeNode.text;
+        properties.typeAnnotation = typeAnnotation;
+    }
+    // 提取裝飾器（如果是 decorated_definition）
+    let decorators;
+    if (type === PythonNodeKind.DecoratedDefinition) {
+        decorators = extractDecorators(node);
+        if (decorators.length > 0) {
+            properties.decorators = decorators;
+        }
+    }
+    // 遞歸轉換子節點
+    const children = [];
+    for (let i = 0; i < node.namedChildCount; i++) {
+        const childNode = node.namedChild(i);
+        if (childNode) {
+            children.push(convertNode(childNode, sourceFile));
+        }
+    }
+    const astNode = {
+        type,
+        range,
+        properties,
+        children,
+        treeSitterNode: node,
+        pythonKind,
+        ...(decorators ? { decorators } : {}),
+        ...(typeAnnotation ? { typeAnnotation } : {})
+    };
+    // 設定父子關係
+    for (const child of children) {
+        child.parent = astNode;
+    }
+    return astNode;
+}
+/**
+ * 從 decorated_definition 節點提取裝飾器
+ */
+function extractDecorators(node) {
+    const decorators = [];
+    for (let i = 0; i < node.childCount; i++) {
+        const child = node.child(i);
+        if (child?.type === 'decorator') {
+            // 提取裝飾器名稱（去掉 @）
+            const decoratorText = child.text.replace(/^@/, '').trim();
+            // 只取函數名稱部分（不含參數）
+            const nameMatch = decoratorText.match(/^[\w.]+/);
+            if (nameMatch) {
+                decorators.push(nameMatch[0]);
+            }
+        }
+    }
+    return decorators;
+}
+/**
+ * 創建 PythonAST
+ */
+export function createPythonAST(tree, sourceFile, parseTime) {
+    const root = convertNode(tree.rootNode, sourceFile);
+    const nodeCount = countNodes(root);
+    const metadata = {
+        language: 'python',
+        version: '3.8+',
+        parserOptions: {},
+        parseTime,
+        nodeCount
+    };
+    return {
+        sourceFile,
+        root,
+        metadata,
+        tree
+    };
+}
+/**
+ * 計算節點總數
+ */
+function countNodes(node) {
+    let count = 1;
+    for (const child of node.children) {
+        count += countNodes(child);
+    }
+    return count;
+}
+/**
+ * 遍歷 AST 節點
+ */
+export function traverseAST(node, callback) {
+    const shouldContinue = callback(node);
+    if (shouldContinue === false) {
+        return;
+    }
+    for (const child of node.children) {
+        traverseAST(child, callback);
+    }
+}
+/**
+ * 查找特定類型的節點
+ */
+export function findNodesByKind(root, kind) {
+    const result = [];
+    traverseAST(root, (node) => {
+        if (node.pythonKind === kind) {
+            result.push(node);
+        }
+    });
+    return result;
+}
+/**
+ * 查找包含指定位置的節點
+ */
+export function findNodeAtPosition(root, line, column) {
+    let result = null;
+    traverseAST(root, (node) => {
+        const { start, end } = node.range;
+        const isInRange = ((line > start.line || (line === start.line && column >= start.column))
+            && (line < end.line || (line === end.line && column <= end.column)));
+        if (isInRange) {
+            result = node;
+        }
+    });
+    return result;
+}
+/**
+ * 獲取節點的文字內容
+ */
+export function getNodeText(node) {
+    return node.treeSitterNode.text;
+}
+/**
+ * 獲取節點的指定欄位
+ */
+export function getFieldNode(node, fieldName) {
+    const fieldNode = node.treeSitterNode.childForFieldName(fieldName);
+    if (!fieldNode) {
+        return null;
+    }
+    // 在 children 中找到對應的 PythonASTNode
+    for (const child of node.children) {
+        const pythonChild = child;
+        if (pythonChild.treeSitterNode === fieldNode) {
+            return pythonChild;
+        }
+    }
+    // 如果在 children 中找不到，可能是匿名節點，需要重新轉換
+    return convertNode(fieldNode, '');
+}
+/**
+ * 釋放 Parser 資源
+ */
+export async function disposeParser() {
+    if (parserInstance) {
+        parserInstance.delete();
+        parserInstance = null;
+    }
+    pythonLanguage = null;
+    isInitialized = false;
+    initializationPromise = null;
+}
+//# sourceMappingURL=tree-sitter-bridge.js.map

package/dist/plugins/python/tree-sitter-bridge.js.map

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

package/dist/plugins/python/types.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Python Parser 特定型別定義
+ */
+import type { AST, ASTNode, Position, Range } from '../../shared/types/index.js';
+import { SymbolType } from '../../shared/types/index.js';
+import type { Node as TreeSitterNode, Tree as TreeSitterTree, Point as TreeSitterPoint } from 'web-tree-sitter';
+/**
+ * Python AST 節點類型（對應 tree-sitter-python）
+ */
+export declare enum PythonNodeKind {
+    Module = "module",
+    ClassDefinition = "class_definition",
+    FunctionDefinition = "function_definition",
+    AsyncFunctionDefinition = "async_function_definition",
+    DecoratedDefinition = "decorated_definition",
+    Decorator = "decorator",
+    ImportStatement = "import_statement",
+    ImportFromStatement = "import_from_statement",
+    Assignment = "assignment",
+    AugmentedAssignment = "augmented_assignment",
+    AnnotatedAssignment = "annotated_assignment",
+    GlobalStatement = "global_statement",
+    NonlocalStatement = "nonlocal_statement",
+    ExpressionStatement = "expression_statement",
+    ReturnStatement = "return_statement",
+    PassStatement = "pass_statement",
+    BreakStatement = "break_statement",
+    ContinueStatement = "continue_statement",
+    RaiseStatement = "raise_statement",
+    AssertStatement = "assert_statement",
+    DeleteStatement = "delete_statement",
+    PrintStatement = "print_statement",
+    IfStatement = "if_statement",
+    ElifClause = "elif_clause",
+    ElseClause = "else_clause",
+    ForStatement = "for_statement",
+    WhileStatement = "while_statement",
+    TryStatement = "try_statement",
+    ExceptClause = "except_clause",
+    FinallyClause = "finally_clause",
+    WithStatement = "with_statement",
+    AsyncForStatement = "async_for_statement",
+    AsyncWithStatement = "async_with_statement",
+    MatchStatement = "match_statement",
+    CaseClause = "case_clause",
+    CasePattern = "case_pattern",
+    BinaryOperator = "binary_operator",
+    UnaryOperator = "unary_operator",
+    BooleanOperator = "boolean_operator",
+    ComparisonOperator = "comparison_operator",
+    ConditionalExpression = "conditional_expression",
+    LambdaExpression = "lambda",
+    Call = "call",
+    Attribute = "attribute",
+    Subscript = "subscript",
+    Slice = "slice",
+    List = "list",
+    Dictionary = "dictionary",
+    Set = "set",
+    Tuple = "tuple",
+    ListComprehension = "list_comprehension",
+    DictionaryComprehension = "dictionary_comprehension",
+    SetComprehension = "set_comprehension",
+    GeneratorExpression = "generator_expression",
+    Identifier = "identifier",
+    Integer = "integer",
+    Float = "float",
+    String = "string",
+    ConcatenatedString = "concatenated_string",
+    True = "true",
+    False = "false",
+    None = "none",
+    Comment = "comment",
+    Parameters = "parameters",
+    Parameter = "parameter",
+    DefaultParameter = "default_parameter",
+    TypedParameter = "typed_parameter",
+    TypedDefaultParameter = "typed_default_parameter",
+    ListSplatPattern = "list_splat_pattern",
+    DictionarySplatPattern = "dictionary_splat_pattern",
+    KeywordArgument = "keyword_argument",
+    Type = "type",
+    Block = "block",
+    ArgumentList = "argument_list",
+    DottedName = "dotted_name",
+    AliasedImport = "aliased_import",
+    WildcardImport = "wildcard_import",
+    RelativeImport = "relative_import",
+    ImportPrefix = "import_prefix"
+}
+/**
+ * Python AST 節點包裝器
+ */
+export interface PythonASTNode extends ASTNode {
+    /** tree-sitter 原始節點 */
+    readonly treeSitterNode: TreeSitterNode;
+    /** Python 節點類型 */
+    readonly pythonKind: PythonNodeKind;
+    /** 裝飾器列表（如果有） */
+    readonly decorators?: readonly string[];
+    /** 型別註解（如果有） */
+    readonly typeAnnotation?: string;
+}
+/**
+ * Python AST 包裝器
+ */
+export interface PythonAST extends AST {
+    readonly root: PythonASTNode;
+    /** tree-sitter 解析樹 */
+    readonly tree: TreeSitterTree;
+}
+/**
+ * Python 符號類型映射
+ */
+export declare const PYTHON_SYMBOL_TYPE_MAP: Partial<Record<PythonNodeKind, SymbolType>>;
+/**
+ * 控制流節點複雜度權重（用於複雜度分析）
+ */
+export declare const COMPLEXITY_WEIGHTS: Partial<Record<PythonNodeKind, number>>;
+/**
+ * 位置轉換：tree-sitter Point → Position
+ */
+export declare function tsPointToPosition(point: TreeSitterPoint, offset: number): Position;
+/**
+ * 範圍轉換：tree-sitter Node → Range
+ */
+export declare function tsNodeToRange(node: TreeSitterNode): Range;
+/**
+ * 節點類型字串轉 PythonNodeKind
+ */
+export declare function nodeTypeToKind(type: string): PythonNodeKind;
+/**
+ * 檢查路徑是否為相對導入
+ */
+export declare function isRelativePath(path: string): boolean;
+/**
+ * 驗證 Python 識別符名稱
+ */
+export declare function isValidPythonIdentifier(name: string): boolean;
+/**
+ * Python 解析錯誤類別
+ */
+export declare class PythonParseError extends Error {
+    readonly filePath?: string | undefined;
+    readonly position?: Position | undefined;
+    constructor(message: string, filePath?: string | undefined, position?: Position | undefined);
+}
+/**
+ * 創建解析錯誤
+ */
+export declare function createParseError(message: string, filePath?: string, position?: Position): PythonParseError;
+/**
+ * Python 常用內建函數（用於安全檢查）
+ */
+export declare const DANGEROUS_FUNCTIONS: Set<string>;
+/**
+ * Python 安全性相關模組
+ */
+export declare const SECURITY_SENSITIVE_MODULES: Set<string>;
+/**
+ * PEP8 命名規範模式
+ */
+export declare const NAMING_PATTERNS: {
+    /** snake_case：變數、函式、方法 */
+    snakeCase: RegExp;
+    /** UPPER_SNAKE_CASE：常量 */
+    upperSnakeCase: RegExp;
+    /** PascalCase：類別 */
+    pascalCase: RegExp;
+    /** _private：私有成員 */
+    privatePrefix: RegExp;
+    /** __dunder__：特殊方法 */
+    dunderPattern: RegExp;
+};
+/**
+ * 檢查是否為測試檔案
+ */
+export declare function isPythonTestFile(filePath: string): boolean;
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/python/types.d.ts.map

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