agent-ide 0.1.10 → 0.3.3

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

@@ -0,0 +1,409 @@
+/**
+ * Search 命令
+ * 搜尋程式碼
+ */
+import * as path from 'path';
+import { IndexEngine } from '../../../core/indexing/index-engine.js';
+import { SearchService } from '../../../core/search/service.js';
+import { createIndexConfig } from '../../../core/indexing/types.js';
+import { QueryCommand } from '../../../infrastructure/formatters/index.js';
+import { createUnifiedOutputHandler, parseOutputFormat, OutputFormat } from '../../cli/unified-output-handler.js';
+/**
+ * 設定 search 命令
+ */
+export function setupSearchCommand(program, context) {
+    program
+        .command('search')
+        .description('搜尋程式碼')
+        .argument('[query]', '搜尋查詢字串（簡化語法，等同於 text 搜尋）')
+        .option('-t, --type <type>', '搜尋類型 (text|regex|fuzzy|symbol|function|class|protocol|variable|enum)', 'text')
+        .option('-p, --path <path>', '搜尋路徑', '.')
+        .option('-e, --extensions <exts>', '檔案副檔名', '.ts,.js,.tsx,.jsx,.swift,.py')
+        .option('-l, --limit <num>', '結果數量限制', '50')
+        .option('-c, --context <lines>', '上下文行數', '2')
+        .option('--case-sensitive', '大小寫敏感')
+        .option('--case-insensitive', '大小寫不敏感')
+        .option('--whole-word', '全字匹配')
+        .option('--multiline', '多行匹配')
+        .option('--include <patterns>', '包含模式')
+        .option('--exclude <patterns>', '排除模式', 'node_modules/**,*.test.*')
+        .option('--format <format>', '輸出格式 (json|summary)', 'summary')
+        .option('-q, --query <name>', '搜尋查詢字串')
+        .option('--pattern <pattern>', '符號名稱模式（用於 structural 搜尋）')
+        .option('--regex', '使用正則表達式')
+        .option('--file-pattern <pattern>', '檔案模式過濾')
+        .option('--with-attribute <attr>', '過濾帶有特定屬性的符號')
+        .option('--with-modifier <mod>', '過濾帶有特定修飾符的符號')
+        .option('--implements <protocol>', '過濾實作特定協定的類別')
+        .option('--extends <class>', '過濾繼承特定類別的子類別')
+        .action(async (queryOrSubcommand, options) => {
+        await handleSearchAction(queryOrSubcommand, options, context);
+    });
+}
+/**
+ * 處理 search 動作
+ */
+async function handleSearchAction(queryOrSubcommand, 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 (!queryOrSubcommand || queryOrSubcommand.trim() === '') {
+        const errorResult = {
+            command: QueryCommand.Search,
+            success: false,
+            results: [],
+            summary: { totalScanned: 0, issuesFound: 0 },
+            errors: ['請提供搜尋查詢或子命令。使用方式: agent-ide search <query>']
+        };
+        outputHandler.outputQuery(errorResult, format);
+        process.exitCode = 1;
+        if (process.env.NODE_ENV !== 'test') {
+            process.exit(1);
+        }
+        return;
+    }
+    // 判斷是子命令還是查詢字串
+    const knownSubcommands = ['text', 'symbol', 'structural'];
+    const isSubcommand = knownSubcommands.includes(queryOrSubcommand);
+    if (isSubcommand) {
+        // 使用子命令語法
+        if (queryOrSubcommand === 'symbol') {
+            await handleSymbolSearchCommand(options, context, format, outputHandler);
+        }
+        else if (queryOrSubcommand === 'text') {
+            await handleTextSearchCommand(options, context, format, outputHandler);
+        }
+        else if (queryOrSubcommand === 'structural') {
+            await handleStructuralSearchCommand(options, context, format, outputHandler);
+        }
+    }
+    else {
+        // 簡化語法：直接使用查詢字串
+        await handleSearchCommand(queryOrSubcommand, options, context, format, outputHandler);
+    }
+}
+/**
+ * 處理搜尋命令
+ */
+async function handleSearchCommand(query, options, context, format, outputHandler) {
+    if (format !== OutputFormat.Json) {
+        console.log(`🔍 搜尋: "${query}"`);
+    }
+    try {
+        // 初始化搜尋服務
+        const searchService = new SearchService(context.fileSystem);
+        // 建構搜尋選項
+        const searchOptions = buildSearchOptions(options);
+        // 根據搜尋類型建立查詢
+        const searchQuery = {
+            type: 'text',
+            query,
+            options: searchOptions
+        };
+        // 執行搜尋
+        const startTime = Date.now();
+        const coreResult = await searchService.searchText(searchQuery);
+        const searchTime = Date.now() - startTime;
+        // 轉換為 SearchResult
+        const matches = coreResult.matches.map((m) => ({
+            filePath: formatFilePath(m.file),
+            line: m.line,
+            column: m.column,
+            content: m.content,
+            context: m.context ? [...(m.context.before ?? []), ...(m.context.after ?? [])] : undefined
+        }));
+        const result = {
+            command: QueryCommand.Search,
+            success: true,
+            results: matches,
+            truncated: coreResult.truncated,
+            searchTime,
+            summary: {
+                totalScanned: matches.length,
+                issuesFound: matches.length
+            }
+        };
+        outputHandler.outputQuery(result, format);
+    }
+    catch (error) {
+        handleError(error, format);
+    }
+}
+/**
+ * 建構搜尋選項
+ */
+function buildSearchOptions(options) {
+    let includeFiles = options.include ? options.include.split(',') : undefined;
+    const excludeFiles = options.exclude ? options.exclude.split(',') : undefined;
+    // --file-pattern 參數轉換為 includeFiles
+    if (options.filePattern) {
+        includeFiles = [options.filePattern];
+    }
+    // --extensions 參數轉換為 includeFiles（副檔名過濾）
+    if (options.extensions && !includeFiles) {
+        const extensions = options.extensions.split(',').map(ext => ext.trim());
+        includeFiles = extensions.map(ext => `**/*${ext}`);
+    }
+    return {
+        scope: {
+            type: 'directory',
+            path: path.resolve(options.path),
+            recursive: true
+        },
+        maxResults: parseInt(options.limit),
+        caseSensitive: options.caseInsensitive ? false : (options.caseSensitive || false),
+        wholeWord: options.wholeWord || false,
+        regex: options.regex || options.type === 'regex',
+        fuzzy: options.type === 'fuzzy',
+        multiline: options.multiline || false,
+        showContext: parseInt(options.context) > 0,
+        contextLines: parseInt(options.context),
+        includeFiles,
+        excludeFiles,
+        timeout: 30000
+    };
+}
+/**
+ * 格式化檔案路徑（顯示相對路徑）
+ */
+function formatFilePath(filePath) {
+    const cwd = process.cwd();
+    const relativePath = path.relative(cwd, filePath);
+    return relativePath.startsWith('..') ? filePath : relativePath;
+}
+/**
+ * 處理文字搜尋命令
+ */
+async function handleTextSearchCommand(options, context, format, outputHandler) {
+    const query = options.query;
+    if (!query) {
+        const errorResult = {
+            command: QueryCommand.Search,
+            success: false,
+            results: [],
+            summary: { totalScanned: 0, issuesFound: 0 },
+            errors: ['文字搜尋需要指定 --query 參數']
+        };
+        outputHandler.outputQuery(errorResult, format);
+        process.exitCode = 1;
+        if (process.env.NODE_ENV !== 'test') {
+            process.exit(1);
+        }
+        return;
+    }
+    await handleSearchCommand(query, options, context, format, outputHandler);
+}
+/**
+ * 處理結構化搜尋命令
+ */
+async function handleStructuralSearchCommand(options, context, format, outputHandler) {
+    const pattern = options.pattern;
+    const type = options.type;
+    if (!type) {
+        const errorResult = {
+            command: QueryCommand.Search,
+            success: false,
+            results: [],
+            summary: { totalScanned: 0, issuesFound: 0 },
+            errors: ['結構化搜尋需要指定 --type 參數']
+        };
+        outputHandler.outputQuery(errorResult, format);
+        process.exitCode = 1;
+        if (process.env.NODE_ENV !== 'test') {
+            process.exit(1);
+        }
+        return;
+    }
+    if (format !== OutputFormat.Json) {
+        console.log(`🔍 結構化搜尋: ${type}${pattern ? ` (pattern: ${pattern})` : ''}`);
+    }
+    try {
+        const searchPath = path.resolve(options.path || process.cwd());
+        // 初始化索引引擎
+        const config = createIndexConfig(searchPath, {
+            includeExtensions: ['.ts', '.tsx', '.js', '.jsx', '.swift', '.py'],
+            excludePatterns: ['node_modules/**', '*.test.*', 'dist/**']
+        });
+        const indexEngine = new IndexEngine(config, context.fileSystem);
+        // 建立索引
+        if (format !== OutputFormat.Json) {
+            console.log('   正在建立索引...');
+        }
+        await indexEngine.indexProject(searchPath);
+        // 獲取所有符號
+        const allSymbols = await indexEngine.getAllSymbols();
+        // 過濾符號
+        let filteredSymbols = allSymbols.filter(symbolResult => {
+            const symbol = symbolResult.symbol;
+            // 過濾檔案模式
+            if (options.filePattern) {
+                const regex = new RegExp(options.filePattern.replace(/\*/g, '.*').replace(/\?/g, '.'));
+                if (!regex.test(symbol.location.filePath)) {
+                    return false;
+                }
+            }
+            // 過濾符號類型
+            if (type && symbol.type !== type) {
+                return false;
+            }
+            // 過濾符號名稱模式
+            if (pattern) {
+                const regex = new RegExp(pattern.replace(/\*/g, '.*').replace(/\?/g, '.'));
+                if (!regex.test(symbol.name)) {
+                    return false;
+                }
+            }
+            // 過濾屬性
+            if (options.withAttribute) {
+                if (!symbol.attributes?.includes(options.withAttribute)) {
+                    return false;
+                }
+            }
+            // 過濾修飾符
+            if (options.withModifier) {
+                if (!symbol.modifiers?.includes(options.withModifier)) {
+                    return false;
+                }
+            }
+            // 過濾實作的協定
+            if (options.implements) {
+                if (!symbol.implements?.includes(options.implements)) {
+                    return false;
+                }
+            }
+            // 過濾繼承的類別
+            if (options.extends && symbol.superclass !== options.extends) {
+                return false;
+            }
+            return true;
+        });
+        // 應用 limit
+        const limit = options.limit ? parseInt(options.limit) : 50;
+        const truncated = filteredSymbols.length > limit;
+        if (truncated) {
+            filteredSymbols = filteredSymbols.slice(0, limit);
+        }
+        // 轉換為 SearchMatch
+        const matches = filteredSymbols.map(r => ({
+            filePath: formatFilePath(r.symbol.location.filePath),
+            line: r.symbol.location.range.start.line,
+            column: r.symbol.location.range.start.column,
+            content: `${r.symbol.type}: ${r.symbol.name}`
+        }));
+        const result = {
+            command: QueryCommand.Search,
+            success: true,
+            results: matches,
+            truncated,
+            summary: {
+                totalScanned: allSymbols.length,
+                issuesFound: matches.length
+            }
+        };
+        outputHandler.outputQuery(result, format);
+    }
+    catch (error) {
+        handleError(error, format);
+    }
+}
+/**
+ * 處理符號搜尋命令
+ */
+async function handleSymbolSearchCommand(options, context, format, outputHandler) {
+    const symbolName = options.query;
+    if (!symbolName) {
+        const errorResult = {
+            command: QueryCommand.Search,
+            success: false,
+            results: [],
+            summary: { totalScanned: 0, issuesFound: 0 },
+            errors: ['符號搜尋需要指定 --query 參數']
+        };
+        outputHandler.outputQuery(errorResult, format);
+        process.exitCode = 1;
+        if (process.env.NODE_ENV !== 'test') {
+            process.exit(1);
+        }
+        return;
+    }
+    if (format !== OutputFormat.Json) {
+        console.log(`🔍 搜尋符號: "${symbolName}"`);
+    }
+    try {
+        const searchPath = path.resolve(options.path || process.cwd());
+        // 初始化索引引擎
+        const config = createIndexConfig(searchPath, {
+            includeExtensions: ['.ts', '.tsx', '.js', '.jsx', '.swift', '.py'],
+            excludePatterns: ['node_modules/**', '*.test.*', 'dist/**']
+        });
+        const indexEngine = new IndexEngine(config, context.fileSystem);
+        // 建立索引
+        if (format !== OutputFormat.Json) {
+            console.log('   正在建立索引...');
+        }
+        await indexEngine.indexProject(searchPath);
+        // 搜尋符號
+        let results;
+        if (symbolName.includes('*') || symbolName.includes('?')) {
+            const allSymbols = await indexEngine.getAllSymbols();
+            const pattern = symbolName.replace(/\*/g, '.*').replace(/\?/g, '.');
+            const regex = new RegExp(`^${pattern}$`);
+            results = allSymbols.filter(r => regex.test(r.symbol.name));
+        }
+        else {
+            results = await indexEngine.findSymbol(symbolName);
+        }
+        // 應用 limit
+        const limit = options.limit ? parseInt(options.limit) : 50;
+        const truncated = results.length > limit;
+        if (truncated) {
+            results = results.slice(0, limit);
+        }
+        // 轉換為 SearchMatch
+        const matches = results.map(r => ({
+            filePath: formatFilePath(r.symbol.location.filePath),
+            line: r.symbol.location.range.start.line,
+            column: r.symbol.location.range.start.column,
+            content: `${r.symbol.type}: ${r.symbol.name}`
+        }));
+        const result = {
+            command: QueryCommand.Search,
+            success: true,
+            results: matches,
+            truncated,
+            summary: {
+                totalScanned: results.length,
+                issuesFound: matches.length
+            }
+        };
+        outputHandler.outputQuery(result, format);
+    }
+    catch (error) {
+        handleError(error, format);
+    }
+}
+/**
+ * 處理錯誤
+ */
+function handleError(error, format) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    if (format === OutputFormat.Json) {
+        console.error(JSON.stringify({ error: errorMessage }));
+    }
+    else {
+        console.error('\n❌ 搜尋失敗:', errorMessage);
+    }
+    process.exitCode = 1;
+    if (process.env.NODE_ENV !== 'test') {
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=search.command.js.map

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * Shift 命令
+ * 移動檔案中的指定行到目標位置
+ */
+import type { Command } from 'commander';
+import type { CommandContext } from '../../cli/commands/types.js';
+/**
+ * 設定 shift 命令
+ */
+export declare function setupShiftCommand(program: Command, context: CommandContext): void;
+//# sourceMappingURL=shift.command.d.ts.map

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

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

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

@@ -0,0 +1,143 @@
+/**
+ * Shift 命令
+ * 移動檔案中的指定行到目標位置
+ */
+import * as path from 'path';
+import { ShiftService } from '../../../core/transform/location/shift/shift-service.js';
+import { convertShiftPreview } from '../../../infrastructure/formatters/index.js';
+import { createUnifiedOutputHandler, parseOutputFormat, OutputFormat } from '../../cli/unified-output-handler.js';
+/**
+ * 設定 shift 命令
+ */
+export function setupShiftCommand(program, context) {
+    program
+        .command('shift <file>')
+        .description('移動檔案中的指定行到目標位置')
+        .requiredOption('--from <number>', '起始行號（1-based，包含）')
+        .requiredOption('--to <number>', '結束行號（1-based，包含）')
+        .requiredOption('--position <number>', '目標位置行號（1-based，插入到此行之前）')
+        .option('--target <file>', '目標檔案路徑（選填，預設為來源檔案）')
+        .option('-p, --path <path>', '專案根目錄路徑', process.cwd())
+        .option('--dry-run', '預覽變更而不執行')
+        .option('--format <format>', '輸出格式 (diff|json|summary)', 'diff')
+        .action(async (file, options) => {
+        await handleShiftCommand(file, options, context);
+    });
+}
+/**
+ * 處理 shift 命令
+ */
+async function handleShiftCommand(file, 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 fromLine = parseInt(options.from, 10);
+        const toLine = parseInt(options.to, 10);
+        const position = parseInt(options.position, 10);
+        // 驗證參數
+        if (isNaN(fromLine) || isNaN(toLine) || isNaN(position)) {
+            outputError('行號和位置必須為有效數字', isJsonFormat);
+            return;
+        }
+        // 解析檔案路徑（支援相對路徑）
+        const sourceFile = path.resolve(options.path || process.cwd(), file);
+        const targetFile = options.target ? path.resolve(options.path || process.cwd(), options.target) : undefined;
+        if (!isJsonFormat) {
+            const targetDesc = targetFile ? ` → ${path.basename(targetFile)}` : '（同檔案內）';
+            console.log(`✂️  移動行 ${fromLine}-${toLine} 到位置 ${position}${targetDesc}`);
+        }
+        // 建立服務（每次使用 context 的 fileSystem 確保測試隔離）
+        const shiftService = new ShiftService(context.fileSystem);
+        // 執行行移動操作
+        const shiftOptions = {
+            sourceFile,
+            fromLine,
+            toLine,
+            targetFile,
+            position,
+            preview: options.dryRun,
+            projectRoot: options.path || process.cwd()
+        };
+        const result = await shiftService.shift(shiftOptions);
+        if (result.success) {
+            if (options.dryRun) {
+                await handleDryRunOutput(sourceFile, targetFile, result, fromLine, toLine, position, format, outputHandler, context);
+            }
+            else {
+                printSuccess(result, isJsonFormat);
+            }
+        }
+        else {
+            outputError(result.error || '未知錯誤', isJsonFormat);
+        }
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        outputError(errorMsg, isJsonFormat);
+    }
+}
+/**
+ * 處理 dry-run 輸出
+ */
+async function handleDryRunOutput(sourceFile, targetFile, result, fromLine, toLine, position, format, outputHandler, context) {
+    // 讀取原始檔案內容
+    const sourceOriginalContent = await context.fileSystem.readFile(sourceFile, 'utf-8');
+    const targetOriginalContent = targetFile && targetFile !== sourceFile
+        ? await context.fileSystem.readFile(targetFile, 'utf-8').catch(() => null)
+        : null;
+    // 轉換為統一的 PreviewInput 格式
+    const previewInput = convertShiftPreview(sourceFile, result.targetFile, fromLine, toLine, position, sourceOriginalContent, targetOriginalContent, result.movedLines || []);
+    // 使用統一輸出處理器
+    outputHandler.outputMutation(previewInput, format);
+}
+/**
+ * 印出成功訊息
+ */
+function printSuccess(result, isJsonFormat) {
+    if (isJsonFormat) {
+        console.log(JSON.stringify({
+            success: true,
+            operationType: result.operationType,
+            sourceFile: result.sourceFile,
+            targetFile: result.targetFile,
+            fromLine: result.fromLine,
+            toLine: result.toLine,
+            position: result.position,
+            linesCount: result.linesCount,
+            executed: result.executed,
+            message: result.message
+        }, null, 2));
+    }
+    else {
+        console.log('✅ 行移動成功!');
+        console.log(`📊 統計: 移動了 ${result.linesCount} 行`);
+        console.log(`📝 來源檔案: ${path.relative(process.cwd(), result.sourceFile)}`);
+        console.log(`📝 目標檔案: ${path.relative(process.cwd(), result.targetFile)}`);
+    }
+}
+/**
+ * 輸出錯誤
+ */
+function outputError(message, isJsonFormat) {
+    if (isJsonFormat) {
+        console.log(JSON.stringify({ success: false, error: message }, null, 2));
+    }
+    else {
+        console.error(`❌ ${message}`);
+    }
+    process.exitCode = 1;
+    if (process.env.NODE_ENV !== 'test') {
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=shift.command.js.map

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * Snapshot 命令
+ * 產生模組快照供 AI 理解
+ */
+import type { Command } from 'commander';
+import type { CommandContext } from '../../cli/commands/types.js';
+/**
+ * 設定 snapshot 命令
+ */
+export declare function setupSnapshotCommand(program: Command, context: CommandContext): void;
+//# sourceMappingURL=snapshot.command.d.ts.map

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

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