agent-ide 0.2.0 → 0.4.0

package/dist/core/shared/call-hierarchy-analyzer.js

@@ -0,0 +1,328 @@
+/**
+ * Call Hierarchy Analyzer
+ * 分析函數的呼叫層次關係（incoming/outgoing）
+ */
+import * as ts from 'typescript';
+import { createSymbolFinder } from './symbol-finder.js';
+/**
+ * Call Hierarchy Analyzer
+ * 分析函數的呼叫者（incoming）和被呼叫者（outgoing）
+ */
+export class CallHierarchyAnalyzer {
+    parserRegistry;
+    fileSystem;
+    symbolFinder;
+    constructor(parserRegistry, fileSystem) {
+        this.parserRegistry = parserRegistry;
+        this.fileSystem = fileSystem;
+        this.symbolFinder = createSymbolFinder(parserRegistry, fileSystem);
+    }
+    /**
+     * 分析函數的呼叫層次
+     */
+    async analyze(functionName, projectFiles, options) {
+        // 1. 找到函數定義
+        const definition = await this.findFunctionDefinition(functionName, projectFiles);
+        if (!definition) {
+            return null;
+        }
+        return this.analyzeWithDefinition(functionName, definition.location.filePath, definition.location.range, projectFiles, options);
+    }
+    /**
+     * 使用已知的定義位置分析函數的呼叫層次
+     * 當呼叫端已經透過 IndexEngine 找到定義時使用此方法
+     */
+    async analyzeWithDefinition(functionName, definitionFile, definitionRange, projectFiles, options) {
+        const incoming = [];
+        const outgoing = [];
+        // 分析 incoming（誰呼叫了此函數）
+        if (options.direction === 'incoming' || options.direction === 'both') {
+            const incomingCalls = await this.findIncomingCalls(functionName, projectFiles, definitionFile, options.depth);
+            incoming.push(...incomingCalls);
+        }
+        // 分析 outgoing（此函數呼叫了誰）
+        if (options.direction === 'outgoing' || options.direction === 'both') {
+            const outgoingCalls = await this.findOutgoingCalls(definitionFile, functionName, definitionRange, options.depth);
+            outgoing.push(...outgoingCalls);
+        }
+        return {
+            functionName,
+            definitionFile,
+            definitionLine: definitionRange.start.line,
+            incoming,
+            outgoing
+        };
+    }
+    /**
+     * 找到函數定義
+     */
+    async findFunctionDefinition(functionName, projectFiles) {
+        for (const filePath of projectFiles) {
+            const definition = await this.symbolFinder.findDefinition(filePath, functionName);
+            if (definition && this.isFunctionSymbol(definition.symbol)) {
+                return { location: definition.symbol.location };
+            }
+        }
+        return null;
+    }
+    /**
+     * 檢查是否為函數類型的符號
+     */
+    isFunctionSymbol(symbol) {
+        // SymbolType.Function 涵蓋函數和方法
+        return symbol.type === 'function';
+    }
+    /**
+     * 找出 incoming 呼叫（誰呼叫了目標函數）
+     */
+    async findIncomingCalls(functionName, projectFiles, definitionFile, depth) {
+        const incoming = [];
+        const visited = new Set();
+        const findCallsRecursive = async (targetName, currentDepth) => {
+            if (currentDepth > depth || visited.has(targetName)) {
+                return;
+            }
+            visited.add(targetName);
+            const callSites = await this.symbolFinder.findCallSites(targetName, projectFiles);
+            for (const callSite of callSites) {
+                // 排除定義檔案中的自身呼叫（如果是遞迴）
+                if (callSite.location.filePath === definitionFile
+                    && callSite.functionName === targetName) {
+                    continue;
+                }
+                // 找出呼叫點所在的函數
+                const callerInfo = await this.findEnclosingFunction(callSite.location.filePath, callSite.location.range.start.line);
+                const context = await this.getLineContext(callSite.location.filePath, callSite.location.range.start.line);
+                incoming.push({
+                    caller: callerInfo?.name || '<anonymous>',
+                    location: callSite.location,
+                    context,
+                    callerDefinitionFile: callerInfo?.file
+                });
+                // 遞迴查找（如果深度允許）
+                if (currentDepth < depth && callerInfo?.name && callerInfo.name !== '<anonymous>') {
+                    await findCallsRecursive(callerInfo.name, currentDepth + 1);
+                }
+            }
+        };
+        await findCallsRecursive(functionName, 1);
+        return incoming;
+    }
+    /**
+     * 找出 outgoing 呼叫（目標函數呼叫了誰）
+     * @param depth 預留參數：未來可用於遞迴深度控制或效能優化
+     */
+    async findOutgoingCalls(filePath, functionName, functionRange, _depth // Reserved: 未來可實作遞迴分析或深度限制優化
+    ) {
+        const outgoing = [];
+        const visited = new Set();
+        const content = await this.readFile(filePath);
+        if (!content) {
+            return outgoing;
+        }
+        const parser = this.parserRegistry.getParser(this.getExtension(filePath));
+        if (!parser) {
+            return outgoing;
+        }
+        try {
+            const ast = await parser.parse(content, filePath);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const sourceFile = ast.tsSourceFile;
+            if (!sourceFile) {
+                return outgoing;
+            }
+            // 找到目標函數的 AST 節點
+            const functionNode = this.findFunctionNode(sourceFile, functionName, functionRange);
+            if (!functionNode || !functionNode.body) {
+                return outgoing;
+            }
+            // 遍歷函數 body 找出所有 CallExpression
+            const findCallsInNode = (node) => {
+                if (ts.isCallExpression(node)) {
+                    const callInfo = this.extractCallInfo(node, sourceFile);
+                    if (callInfo) {
+                        const key = `${callInfo.callee}:${callInfo.line}:${callInfo.column}`;
+                        if (!visited.has(key)) {
+                            visited.add(key);
+                            outgoing.push({
+                                callee: callInfo.callee,
+                                location: {
+                                    filePath,
+                                    range: {
+                                        start: { line: callInfo.line, column: callInfo.column, offset: undefined },
+                                        end: { line: callInfo.line, column: callInfo.column + callInfo.callee.length, offset: undefined }
+                                    }
+                                },
+                                context: callInfo.context,
+                                isMethodCall: callInfo.isMethodCall,
+                                receiver: callInfo.receiver
+                            });
+                        }
+                    }
+                }
+                ts.forEachChild(node, findCallsInNode);
+            };
+            findCallsInNode(functionNode.body);
+        }
+        catch {
+            // Parser 失敗，返回空結果
+        }
+        return outgoing;
+    }
+    /**
+     * 在 AST 中找到目標函數節點
+     * @param range 預留參數：未來可用於精確定位同名函數
+     */
+    findFunctionNode(sourceFile, functionName, _range // Reserved: 未來可用於區分同名但不同位置的函數
+    ) {
+        let result = null;
+        const visit = (node) => {
+            if (result) {
+                return;
+            }
+            // FunctionDeclaration
+            if (ts.isFunctionDeclaration(node) && node.name?.text === functionName) {
+                result = node;
+                return;
+            }
+            // MethodDeclaration
+            if (ts.isMethodDeclaration(node) && ts.isIdentifier(node.name) && node.name.text === functionName) {
+                result = node;
+                return;
+            }
+            // Arrow function 或 function expression 賦值給變數
+            if (ts.isVariableDeclaration(node) && ts.isIdentifier(node.name)) {
+                if (node.name.text === functionName && node.initializer) {
+                    if (ts.isArrowFunction(node.initializer)) {
+                        result = node.initializer;
+                        return;
+                    }
+                    if (ts.isFunctionExpression(node.initializer)) {
+                        result = node.initializer;
+                        return;
+                    }
+                }
+            }
+            ts.forEachChild(node, visit);
+        };
+        visit(sourceFile);
+        return result;
+    }
+    /**
+     * 提取 CallExpression 的資訊
+     */
+    extractCallInfo(node, sourceFile) {
+        const expr = node.expression;
+        let callee;
+        let isMethodCall = false;
+        let receiver;
+        if (ts.isIdentifier(expr)) {
+            callee = expr.text;
+        }
+        else if (ts.isPropertyAccessExpression(expr)) {
+            callee = expr.name.text;
+            isMethodCall = true;
+            receiver = expr.expression.getText(sourceFile);
+        }
+        else {
+            // 不支援的呼叫類型（如 computed property access）
+            return null;
+        }
+        const { line, character } = sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile));
+        const lines = sourceFile.text.split('\n');
+        const lineText = lines[line] || '';
+        return {
+            callee,
+            line: line + 1, // 轉為 1-based
+            column: character + 1,
+            context: lineText.trim(),
+            isMethodCall,
+            receiver
+        };
+    }
+    /**
+     * 找出某行所在的外層函數
+     */
+    async findEnclosingFunction(filePath, line) {
+        const content = await this.readFile(filePath);
+        if (!content) {
+            return null;
+        }
+        const parser = this.parserRegistry.getParser(this.getExtension(filePath));
+        if (!parser) {
+            return null;
+        }
+        try {
+            const ast = await parser.parse(content, filePath);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const sourceFile = ast.tsSourceFile;
+            if (!sourceFile) {
+                return null;
+            }
+            const position = sourceFile.getPositionOfLineAndCharacter(line - 1, 0);
+            let enclosingFunction = null;
+            const visit = (node) => {
+                if (position >= node.getStart(sourceFile) && position < node.getEnd()) {
+                    // FunctionDeclaration
+                    if (ts.isFunctionDeclaration(node) && node.name) {
+                        enclosingFunction = node.name.text;
+                    }
+                    // MethodDeclaration
+                    else if (ts.isMethodDeclaration(node) && ts.isIdentifier(node.name)) {
+                        enclosingFunction = node.name.text;
+                    }
+                    // Arrow function 或 function expression 賦值給變數
+                    else if (ts.isVariableDeclaration(node)
+                        && ts.isIdentifier(node.name)
+                        && node.initializer
+                        && (ts.isArrowFunction(node.initializer) || ts.isFunctionExpression(node.initializer))) {
+                        enclosingFunction = node.name.text;
+                    }
+                    ts.forEachChild(node, visit);
+                }
+            };
+            visit(sourceFile);
+            return enclosingFunction ? { name: enclosingFunction, file: filePath } : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * 取得某行的程式碼內容
+     */
+    async getLineContext(filePath, line) {
+        const content = await this.readFile(filePath);
+        if (!content) {
+            return '';
+        }
+        const lines = content.split('\n');
+        return lines[line - 1]?.trim() || '';
+    }
+    /**
+     * 讀取檔案內容
+     */
+    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;
+        }
+    }
+    /**
+     * 取得檔案副檔名
+     */
+    getExtension(filePath) {
+        const lastDot = filePath.lastIndexOf('.');
+        return lastDot >= 0 ? filePath.substring(lastDot) : '';
+    }
+}
+/**
+ * 建立 CallHierarchyAnalyzer 實例
+ */
+export function createCallHierarchyAnalyzer(parserRegistry, fileSystem) {
+    return new CallHierarchyAnalyzer(parserRegistry, fileSystem);
+}
+//# sourceMappingURL=call-hierarchy-analyzer.js.map

package/dist/core/shared/call-hierarchy-analyzer.js.map

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

package/dist/core/shared/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Core 共享元件
+ * 提供跨子模組共用的工具類別和型別
+ */
+export * from './symbol-finder.js';
+export * from './call-hierarchy-analyzer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/shared/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC"}

package/dist/core/shared/index.js

@@ -0,0 +1,7 @@
+/**
+ * Core 共享元件
+ * 提供跨子模組共用的工具類別和型別
+ */
+export * from './symbol-finder.js';
+export * from './call-hierarchy-analyzer.js';
+//# sourceMappingURL=index.js.map

package/dist/core/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/shared/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC"}

package/dist/core/shared/symbol-finder.d.ts

@@ -0,0 +1,154 @@
+/**
+ * 統一的符號查找器
+ * 整合 AST 分析和文字匹配，提供跨檔案符號查找能力
+ */
+import type { Range, Location } from '../../shared/types/core.js';
+import type { Symbol } from '../../shared/types/symbol.js';
+import type { ParserRegistry } from '../../infrastructure/parser/registry.js';
+import type { IFileSystem } from '../../infrastructure/storage/file-system.interface.js';
+/**
+ * 符號引用
+ */
+export interface SymbolReference {
+    readonly symbolName: string;
+    readonly location: Location;
+    readonly type: SymbolReferenceType;
+    readonly context?: string;
+}
+/**
+ * 符號引用類型
+ */
+export declare enum SymbolReferenceType {
+    Definition = "definition",
+    Usage = "usage",
+    Import = "import",
+    Export = "export"
+}
+/**
+ * 函式呼叫點
+ */
+export interface CallSite {
+    readonly functionName: string;
+    readonly location: Location;
+    readonly arguments: readonly CallSiteArgument[];
+    readonly isMethodCall: boolean;
+    readonly receiver?: string;
+}
+/**
+ * 呼叫點參數
+ */
+export interface CallSiteArgument {
+    readonly index: number;
+    readonly name?: string;
+    readonly value: string;
+    readonly range: Range;
+}
+/**
+ * 類別成員
+ */
+export interface ClassMember {
+    readonly name: string;
+    readonly type: ClassMemberType;
+    readonly location: Location;
+    readonly modifiers: readonly string[];
+    readonly valueType?: string;
+}
+/**
+ * 類別成員類型
+ */
+export declare enum ClassMemberType {
+    Method = "method",
+    Property = "property",
+    Getter = "getter",
+    Setter = "setter",
+    Constructor = "constructor"
+}
+/**
+ * 符號定義
+ */
+export interface SymbolDefinition {
+    readonly symbol: Symbol;
+    readonly signature?: string;
+    readonly documentation?: string;
+}
+/**
+ * 符號查找器
+ */
+export declare class SymbolFinder {
+    private readonly parserRegistry;
+    private readonly fileSystem;
+    constructor(parserRegistry: ParserRegistry, fileSystem: IFileSystem);
+    /**
+     * 查找符號定義
+     */
+    findDefinition(filePath: string, symbolName: string): Promise<SymbolDefinition | null>;
+    /**
+     * 查找所有引用
+     */
+    findReferences(symbolName: string, projectFiles: readonly string[]): Promise<SymbolReference[]>;
+    /**
+     * 查找檔案中的符號引用
+     */
+    findReferencesInFile(filePath: string, symbolName: string): Promise<SymbolReference[]>;
+    /**
+     * 查找函式的所有呼叫點
+     */
+    findCallSites(functionName: string, projectFiles: readonly string[]): Promise<CallSite[]>;
+    /**
+     * 查找檔案中的函式呼叫點
+     */
+    findCallSitesInFile(filePath: string, functionName: string): Promise<CallSite[]>;
+    /**
+     * 查找類別成員
+     */
+    findClassMembers(filePath: string, className: string): Promise<ClassMember[]>;
+    /**
+     * 讀取檔案內容
+     */
+    private readFile;
+    /**
+     * 取得對應的 Parser
+     */
+    private getParser;
+    /**
+     * 取得檔案副檔名
+     */
+    private getFileExtension;
+    /**
+     * 使用文字匹配查找引用（降級方法）
+     */
+    private findReferencesByText;
+    /**
+     * 提取函式簽名
+     */
+    private extractSignature;
+    /**
+     * 提取文件註解
+     */
+    private extractDocumentation;
+    /**
+     * 提取參數字串
+     */
+    private extractArgumentsString;
+    /**
+     * 解析參數
+     */
+    private parseArguments;
+    /**
+     * 分割參數（考慮巢狀括號）
+     */
+    private splitArguments;
+    /**
+     * 符號類型轉換為成員類型
+     */
+    private symbolTypeToMemberType;
+    /**
+     * 跳脫正則表達式特殊字元
+     */
+    private escapeRegex;
+}
+/**
+ * 建立 SymbolFinder 實例
+ */
+export declare function createSymbolFinder(parserRegistry: ParserRegistry, fileSystem: IFileSystem): SymbolFinder;
+//# sourceMappingURL=symbol-finder.d.ts.map

package/dist/core/shared/symbol-finder.d.ts.map

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