agent-ide 0.2.0 → 0.4.0

package/dist/interfaces/cli/commands/change-signature.command.js

@@ -0,0 +1,290 @@
+/**
+ * Change Signature 命令
+ * 修改函式簽名並自動更新所有呼叫點
+ */
+import * as path from 'path';
+import { ChangeSignatureService, SignatureChangeType } from '../../../core/change-signature/index.js';
+import { ParserRegistry } from '../../../infrastructure/parser/registry.js';
+import { createUnifiedOutputHandler, parseOutputFormat, OutputFormat } from '../../cli/unified-output-handler.js';
+/**
+ * 設定 change-signature 命令
+ */
+export function setupChangeSignatureCommand(program, context) {
+    program
+        .command('change-signature <file> <functionName>')
+        .description('修改函式簽名並自動更新所有呼叫點')
+        .option('-p, --path <path>', '專案根目錄路徑', process.cwd())
+        .option('--add <params>', '新增參數 (格式: name:type=default@position,name2:type2)')
+        .option('--remove <params>', '移除參數 (參數名稱或索引，逗號分隔)')
+        .option('--reorder <order>', '重新排序 (參數名稱或索引，逗號分隔)')
+        .option('--rename <mapping>', '重命名參數 (格式: oldName:newName,oldName2:newName2)')
+        .option('--change-type <mapping>', '修改參數類型 (格式: name:newType,name2:newType2)')
+        .option('--dry-run', '預覽變更而不執行')
+        .option('--format <format>', '輸出格式 (diff|json|summary)', 'diff')
+        .action(async (file, functionName, options) => {
+        await handleChangeSignatureCommand(file, functionName, options, context);
+    });
+}
+/**
+ * 處理 change-signature 命令
+ */
+async function handleChangeSignatureCommand(file, functionName, options, context) {
+    const outputHandler = createUnifiedOutputHandler();
+    let format;
+    try {
+        format = parseOutputFormat(options.format, true);
+    }
+    catch {
+        outputHandler.outputError('不支援的輸出格式。可用格式: json, summary, diff', OutputFormat.Summary);
+        process.exitCode = 1;
+        return;
+    }
+    const isJsonFormat = format === OutputFormat.Json;
+    try {
+        // 解析檔案路徑
+        const filePath = path.resolve(options.path || process.cwd(), file);
+        const projectRoot = options.path || process.cwd();
+        // 解析變更操作
+        const changes = parseChanges(options);
+        if (changes.length === 0) {
+            outputHandler.outputError('請指定至少一個變更操作 (--add, --remove, --reorder, --rename, --change-type)', format);
+            process.exitCode = 1;
+            return;
+        }
+        if (!isJsonFormat) {
+            console.log(`🔧 修改函式簽名: ${functionName}`);
+            console.log(`📁 檔案: ${path.relative(process.cwd(), filePath)}`);
+        }
+        // 取得 ParserRegistry（單例）
+        const parserRegistry = ParserRegistry.getInstance();
+        // 建立服務
+        const changeSignatureService = new ChangeSignatureService(parserRegistry, context.fileSystem);
+        // 執行 Change Signature
+        const result = await changeSignatureService.changeSignature({
+            filePath,
+            functionName,
+            changes,
+            projectRoot,
+            preview: options.dryRun
+        });
+        if (result.success) {
+            if (isJsonFormat) {
+                console.log(JSON.stringify({
+                    success: true,
+                    originalSignature: formatSignatureForJson(result.originalSignature),
+                    newSignature: formatSignatureForJson(result.newSignature),
+                    definitionUpdate: {
+                        filePath: result.definitionUpdate.filePath,
+                        originalCode: result.definitionUpdate.originalCode,
+                        newCode: result.definitionUpdate.newCode
+                    },
+                    callSiteUpdates: result.callSiteUpdates.map(u => ({
+                        filePath: u.filePath,
+                        originalCode: u.originalCode,
+                        newCode: u.newCode,
+                        line: u.location.range.start.line
+                    })),
+                    executed: result.executed,
+                    stats: result.stats
+                }));
+            }
+            else if (format === OutputFormat.Diff) {
+                printDiffOutput(result, projectRoot);
+            }
+            else {
+                printSummaryOutput(result, projectRoot);
+            }
+        }
+        else {
+            outputHandler.outputError(result.error || '未知錯誤', format);
+            process.exitCode = 1;
+        }
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        outputHandler.outputError(errorMsg, format);
+        process.exitCode = 1;
+    }
+}
+/**
+ * 解析變更操作
+ */
+function parseChanges(options) {
+    const changes = [];
+    // 解析 --add 參數
+    if (options.add) {
+        const addParams = options.add.split(',');
+        for (const param of addParams) {
+            const change = parseAddParameter(param);
+            if (change) {
+                changes.push(change);
+            }
+        }
+    }
+    // 解析 --remove 參數
+    if (options.remove) {
+        const removeParams = options.remove.split(',');
+        for (const param of removeParams) {
+            const trimmed = param.trim();
+            const nameOrIndex = /^\d+$/.test(trimmed) ? parseInt(trimmed, 10) : trimmed;
+            changes.push({
+                type: SignatureChangeType.RemoveParameter,
+                parameterNameOrIndex: nameOrIndex
+            });
+        }
+    }
+    // 解析 --reorder 參數
+    if (options.reorder) {
+        const order = options.reorder.split(',').map(p => {
+            const trimmed = p.trim();
+            return /^\d+$/.test(trimmed) ? parseInt(trimmed, 10) : trimmed;
+        });
+        changes.push({
+            type: SignatureChangeType.ReorderParameters,
+            newOrder: order
+        });
+    }
+    // 解析 --rename 參數
+    if (options.rename) {
+        const mappings = options.rename.split(',');
+        for (const mapping of mappings) {
+            const [oldName, newName] = mapping.split(':').map(s => s.trim());
+            if (oldName && newName) {
+                changes.push({
+                    type: SignatureChangeType.RenameParameter,
+                    parameterNameOrIndex: oldName,
+                    newName
+                });
+            }
+        }
+    }
+    // 解析 --change-type 參數
+    if (options.changeType) {
+        const mappings = options.changeType.split(',');
+        for (const mapping of mappings) {
+            const [name, newType] = mapping.split(':').map(s => s.trim());
+            if (name && newType) {
+                changes.push({
+                    type: SignatureChangeType.ChangeParameterType,
+                    parameterNameOrIndex: name,
+                    newType
+                });
+            }
+        }
+    }
+    return changes;
+}
+/**
+ * 解析新增參數
+ * 格式: name:type=default@position
+ */
+function parseAddParameter(param) {
+    const trimmed = param.trim();
+    if (!trimmed) {
+        return null;
+    }
+    // 解析位置
+    let position = -1;
+    let paramPart = trimmed;
+    const posMatch = trimmed.match(/@(-?\d+)$/);
+    if (posMatch) {
+        position = parseInt(posMatch[1], 10);
+        paramPart = trimmed.slice(0, -posMatch[0].length);
+    }
+    // 解析預設值
+    let defaultValue;
+    let nameTypePart = paramPart;
+    const defaultMatch = paramPart.match(/=(.+)$/);
+    if (defaultMatch) {
+        defaultValue = defaultMatch[1];
+        nameTypePart = paramPart.slice(0, -defaultMatch[0].length);
+    }
+    // 解析名稱和類型
+    const [name, type] = nameTypePart.split(':').map(s => s.trim());
+    if (!name) {
+        return null;
+    }
+    return {
+        type: SignatureChangeType.AddParameter,
+        name,
+        parameterType: type || undefined,
+        defaultValue,
+        optional: !!defaultValue,
+        position,
+        callSiteValue: defaultValue
+    };
+}
+/**
+ * 格式化簽名為 JSON
+ */
+function formatSignatureForJson(signature) {
+    return {
+        name: signature.name,
+        parameters: signature.parameters.map((p) => ({
+            name: p.name,
+            type: p.type,
+            optional: p.optional,
+            defaultValue: p.defaultValue
+        })),
+        returnType: signature.returnType,
+        isMethod: signature.isMethod,
+        className: signature.className,
+        modifiers: signature.modifiers
+    };
+}
+/**
+ * 印出 diff 輸出
+ */
+function printDiffOutput(result, projectRoot) {
+    console.log('\n📝 定義變更:');
+    console.log(`--- ${path.relative(projectRoot, result.definitionUpdate.filePath)}`);
+    console.log(`+++ ${path.relative(projectRoot, result.definitionUpdate.filePath)}`);
+    console.log(`- ${result.definitionUpdate.originalCode}`);
+    console.log(`+ ${result.definitionUpdate.newCode}`);
+    if (result.callSiteUpdates.length > 0) {
+        console.log('\n📞 呼叫點變更:');
+        for (const update of result.callSiteUpdates) {
+            console.log(`\n--- ${path.relative(projectRoot, update.filePath)}:${update.location.range.start.line}`);
+            console.log(`- ${update.originalCode.trim()}`);
+            console.log(`+ ${update.newCode.trim()}`);
+        }
+    }
+    console.log('\n' + (result.executed ? '✅ 變更已執行' : '🔍 預覽模式（使用 --dry-run）'));
+    console.log(`📊 統計: ${result.stats.callSitesUpdated} 個呼叫點, ${result.stats.filesAffected} 個檔案`);
+}
+/**
+ * 印出摘要輸出
+ */
+function printSummaryOutput(result, projectRoot) {
+    console.log('\n✅ 簽名修改成功!');
+    console.log(`📝 原始: ${formatSignatureString(result.originalSignature)}`);
+    console.log(`📝 新的: ${formatSignatureString(result.newSignature)}`);
+    console.log(`📊 更新了 ${result.stats.callSitesUpdated} 個呼叫點，影響 ${result.stats.filesAffected} 個檔案`);
+    if (!result.executed) {
+        console.log('\n🔍 預覽模式 - 執行時移除 --dry-run');
+    }
+}
+/**
+ * 格式化簽名字串
+ */
+function formatSignatureString(signature) {
+    const params = signature.parameters.map((p) => {
+        let str = p.name;
+        if (p.optional && !p.defaultValue) {
+            str += '?';
+        }
+        if (p.type) {
+            str += `: ${p.type}`;
+        }
+        if (p.defaultValue) {
+            str += ` = ${p.defaultValue}`;
+        }
+        return str;
+    }).join(', ');
+    let result = `${signature.name}(${params})`;
+    if (signature.returnType) {
+        result += `: ${signature.returnType}`;
+    }
+    return result;
+}
+//# sourceMappingURL=change-signature.command.js.map

package/dist/interfaces/cli/commands/change-signature.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-signature.command.js","sourceRoot":"","sources":["../../../../src/interfaces/cli/commands/change-signature.command.ts"],"names":[],"mappings":"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"}

package/dist/interfaces/cli/commands/cycles.command.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Cycles 命令
+ * 循環依賴分析（從 deps cycles 攤平而來）
+ */
+import type { Command } from 'commander';
+import type { CommandContext } from '../../cli/commands/types.js';
+/**
+ * 設定 cycles 命令
+ */
+export declare function setupCyclesCommand(program: Command, context: CommandContext): void;
+//# sourceMappingURL=cycles.command.d.ts.map

package/dist/interfaces/cli/commands/cycles.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cycles.command.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/cli/commands/cycles.command.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAQxE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CASlF"}

package/dist/interfaces/cli/commands/cycles.command.js

@@ -0,0 +1,87 @@
+/**
+ * Cycles 命令
+ * 循環依賴分析（從 deps cycles 攤平而來）
+ */
+import { DependencyAnalyzer } from '../../../core/dependency/dependency-analyzer.js';
+import { DependencyGraph } from '../../../core/dependency/dependency-graph.js';
+import { CycleDetector } from '../../../core/dependency/cycle-detector.js';
+import { QueryCommand } from '../../../infrastructure/formatters/index.js';
+import { createUnifiedOutputHandler, parseOutputFormat, OutputFormat } from '../../cli/unified-output-handler.js';
+/**
+ * 設定 cycles 命令
+ */
+export function setupCyclesCommand(program, context) {
+    program
+        .command('cycles')
+        .description('分析循環依賴')
+        .option('-p, --path <path>', '分析路徑', '.')
+        .option('--format <format>', '輸出格式 (json|summary)', 'summary')
+        .action(async (options) => {
+        await handleCyclesCommand(options, context);
+    });
+}
+/**
+ * 處理 cycles 命令
+ */
+async function handleCyclesCommand(options, context) {
+    const outputHandler = createUnifiedOutputHandler();
+    let format;
+    try {
+        format = parseOutputFormat(options.format, false);
+    }
+    catch {
+        outputHandler.outputError('不支援的輸出格式。可用格式: json, summary', OutputFormat.Summary);
+        process.exitCode = 1;
+        return;
+    }
+    if (format !== OutputFormat.Json) {
+        console.log('🔄 循環依賴分析...');
+    }
+    try {
+        const analyzePath = options.path || process.cwd();
+        // 初始化依賴分析器
+        const dependencyAnalyzer = new DependencyAnalyzer(context.fileSystem);
+        // 分析專案依賴
+        const projectDeps = await dependencyAnalyzer.analyzeProject(analyzePath);
+        // 獲取統計資訊
+        const stats = dependencyAnalyzer.getStats();
+        // 建立依賴圖
+        const graph = new DependencyGraph();
+        for (const fileDep of projectDeps.fileDependencies) {
+            graph.addNode(fileDep.filePath);
+            for (const dep of fileDep.dependencies) {
+                graph.addDependency(fileDep.filePath, dep.path);
+            }
+        }
+        // 使用 CycleDetector 檢測循環依賴
+        const cycleDetector = new CycleDetector();
+        const cycles = cycleDetector.detectCycles(graph);
+        // 轉換 cycles 為 CycleInfo
+        const cycleInfos = cycles.map(c => ({
+            cycle: [...c.cycle],
+            length: c.length
+        }));
+        const result = {
+            command: QueryCommand.Deps,
+            success: true,
+            cycles: cycleInfos,
+            summary: {
+                totalScanned: stats.totalFiles,
+                issuesFound: cycles.length,
+                totalFiles: stats.totalFiles,
+                totalDependencies: stats.totalDependencies,
+                cyclesFound: cycles.length
+            }
+        };
+        outputHandler.outputQuery(result, format);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        outputHandler.outputError(`依賴分析失敗: ${errorMessage}`, format);
+        process.exitCode = 1;
+        if (process.env.NODE_ENV !== 'test') {
+            process.exit(1);
+        }
+    }
+}
+//# sourceMappingURL=cycles.command.js.map

package/dist/interfaces/cli/commands/cycles.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cycles.command.js","sourceRoot":"","sources":["../../../../src/interfaces/cli/commands/cycles.command.ts"],"names":[],"mappings":"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"}

package/dist/interfaces/cli/commands/find-references.command.d.ts

@@ -0,0 +1,11 @@
+/**
+ * find-references 命令
+ * 語義級引用搜尋，精確找出符號的定義和所有引用位置
+ */
+import type { Command } from 'commander';
+import type { CommandContext } from '../../cli/commands/types.js';
+/**
+ * 設定 find-references 命令
+ */
+export declare function setupFindReferencesCommand(program: Command, context: CommandContext): void;
+//# sourceMappingURL=find-references.command.d.ts.map

package/dist/interfaces/cli/commands/find-references.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-references.command.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/cli/commands/find-references.command.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAQxE;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAS1F"}

package/dist/interfaces/cli/commands/find-references.command.js

@@ -0,0 +1,122 @@
+/**
+ * find-references 命令
+ * 語義級引用搜尋，精確找出符號的定義和所有引用位置
+ */
+import { IndexEngine, createIndexConfig, CLI_INDEX_DEFAULTS } from '../../../core/indexing/index.js';
+import { createSymbolFinder, SymbolReferenceType } from '../../../core/shared/symbol-finder.js';
+import { ParserRegistry } from '../../../infrastructure/parser/registry.js';
+import { QueryCommand } from '../../../infrastructure/formatters/index.js';
+import { createUnifiedOutputHandler, parseOutputFormat, OutputFormat } from '../../cli/unified-output-handler.js';
+/**
+ * 設定 find-references 命令
+ */
+export function setupFindReferencesCommand(program, context) {
+    program
+        .command('find-references <symbol>')
+        .description('查找符號的定義和所有引用')
+        .option('-p, --path <path>', '專案路徑', '.')
+        .option('--format <format>', '輸出格式 (json|summary)', 'summary')
+        .action(async (symbol, options) => {
+        await handleFindReferencesCommand(symbol, options, context);
+    });
+}
+/**
+ * 處理 find-references 命令
+ */
+async function handleFindReferencesCommand(symbolName, options, context) {
+    const outputHandler = createUnifiedOutputHandler();
+    let format;
+    try {
+        format = parseOutputFormat(options.format, false);
+    }
+    catch {
+        outputHandler.outputError('不支援的輸出格式。可用格式: json, summary', OutputFormat.Summary);
+        process.exitCode = 1;
+        return;
+    }
+    if (format !== OutputFormat.Json) {
+        console.log(`🔍 查找符號引用: ${symbolName}...`);
+    }
+    const projectPath = options.path || process.cwd();
+    // 建立索引引擎
+    const indexConfig = createIndexConfig(projectPath, CLI_INDEX_DEFAULTS);
+    const indexEngine = new IndexEngine(indexConfig, context.fileSystem);
+    try {
+        // 索引專案
+        await indexEngine.indexProject(projectPath);
+        // 取得所有已索引檔案路徑
+        const indexedFiles = indexEngine.getAllIndexedFiles();
+        const filePaths = indexedFiles.map(f => f.filePath);
+        // 查找符號定義
+        const symbolResults = await indexEngine.findSymbol(symbolName);
+        let definition = null;
+        let symbolType = 'unknown';
+        if (symbolResults.length > 0) {
+            const firstResult = symbolResults[0];
+            definition = {
+                file: firstResult.symbol.location.filePath,
+                line: firstResult.symbol.location.range.start.line,
+                column: firstResult.symbol.location.range.start.column
+            };
+            symbolType = firstResult.symbol.type;
+        }
+        // 建立 SymbolFinder 查找所有引用
+        const parserRegistry = ParserRegistry.getInstance();
+        const symbolFinder = createSymbolFinder(parserRegistry, context.fileSystem);
+        const refs = await symbolFinder.findReferences(symbolName, filePaths);
+        // 轉換為輸出格式
+        const references = refs.map(ref => ({
+            file: ref.location.filePath,
+            line: ref.location.range.start.line,
+            column: ref.location.range.start.column,
+            type: mapReferenceType(ref.type),
+            context: ref.context || ''
+        }));
+        // 計算影響檔案數
+        const filesAffected = new Set(references.map(r => r.file)).size;
+        // 組裝結果
+        const result = {
+            command: QueryCommand.FindReferences,
+            success: true,
+            symbol: symbolName,
+            type: symbolType,
+            definition,
+            references,
+            summary: {
+                totalReferences: references.length,
+                filesAffected
+            }
+        };
+        outputHandler.outputQuery(result, format);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        // 區分索引錯誤和查找錯誤
+        const isIndexError = errorMessage.includes('索引')
+            || errorMessage.includes('index')
+            || errorMessage.includes('ENOENT');
+        const errorPrefix = isIndexError ? '索引專案失敗' : '查找引用失敗';
+        outputHandler.outputError(`${errorPrefix}: ${errorMessage}`, format);
+        process.exitCode = 1;
+    }
+    finally {
+        indexEngine.dispose();
+    }
+}
+/**
+ * 映射引用類型
+ */
+function mapReferenceType(type) {
+    switch (type) {
+        case SymbolReferenceType.Definition:
+            return 'definition';
+        case SymbolReferenceType.Import:
+            return 'import';
+        case SymbolReferenceType.Export:
+            return 'export';
+        case SymbolReferenceType.Usage:
+        default:
+            return 'usage';
+    }
+}
+//# sourceMappingURL=find-references.command.js.map

package/dist/interfaces/cli/commands/find-references.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-references.command.js","sourceRoot":"","sources":["../../../../src/interfaces/cli/commands/find-references.command.ts"],"names":[],"mappings":"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"}

package/dist/interfaces/cli/commands/impact.command.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Impact 命令
+ * 影響分析（從 deps impact 攤平而來）
+ */
+import type { Command } from 'commander';
+import type { CommandContext } from '../../cli/commands/types.js';
+/**
+ * 設定 impact 命令
+ */
+export declare function setupImpactCommand(program: Command, context: CommandContext): void;
+//# sourceMappingURL=impact.command.d.ts.map

package/dist/interfaces/cli/commands/impact.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact.command.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/cli/commands/impact.command.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AASxE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAUlF"}