agent-ide 0.2.0 → 0.4.0

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

@@ -0,0 +1,258 @@
+/**
+ * Rename 命令
+ * 重新命名程式碼元素
+ */
+import * as path from 'path';
+import { IndexEngine } from '../../../core/indexing/index-engine.js';
+import { createIndexConfig } from '../../../core/indexing/types.js';
+import { RenameEngine } from '../../../core/rename/rename-engine.js';
+import { ParserRegistry } from '../../../infrastructure/parser/registry.js';
+import { convertRenamePreview } from '../../../infrastructure/formatters/index.js';
+import { createUnifiedOutputHandler, parseOutputFormat, OutputFormat } from '../../cli/unified-output-handler.js';
+/**
+ * 設定 rename 命令
+ */
+export function setupRenameCommand(program, context) {
+    program
+        .command('rename')
+        .description('重新命名程式碼元素')
+        .option('-t, --type <type>', '符號類型 (variable|function|class|interface)', 'variable')
+        .option('-s, --symbol <name>', '要重新命名的符號')
+        .option('-f, --from <name>', '原始名稱（--symbol 的別名）')
+        .option('-n, --new-name <name>', '新名稱')
+        .option('-o, --to <name>', '新名稱（--new-name 的別名）')
+        .option('-p, --path <path>', '檔案或目錄路徑', '.')
+        .option('--dry-run', '預覽變更而不執行')
+        .option('--format <format>', '輸出格式 (diff|json|summary)', 'diff')
+        .action(async (options) => {
+        await handleRenameCommand(options, context);
+    });
+}
+/**
+ * 處理 rename 命令
+ */
+async function handleRenameCommand(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 from = options.symbol || options.from;
+    const to = options.newName || options.to;
+    const isJsonFormat = format === OutputFormat.Json;
+    if (!from || !to) {
+        outputHandler.outputError('必須指定符號名稱和新名稱。使用方式: agent-ide rename --symbol <name> --new-name <name>', format, 'rename');
+        process.exitCode = 1;
+        if (process.env.NODE_ENV !== 'test') {
+            process.exit(1);
+        }
+        return;
+    }
+    // 如果 from 和 to 相同，直接返回成功但無操作
+    if (from === to) {
+        if (isJsonFormat) {
+            console.log(JSON.stringify({
+                command: 'rename',
+                success: true,
+                files: [],
+                summary: { totalFiles: 0, totalChanges: 0, additions: 0, deletions: 0 },
+                operations: 0,
+                affectedFiles: 0,
+                operationDescription: `No changes needed: '${from}' is already named '${to}'`
+            }));
+        }
+        else {
+            console.log(`   沒有變更需要：'${from}' 已經是 '${to}'`);
+        }
+        return;
+    }
+    if (!isJsonFormat) {
+        console.log(`   重新命名 ${from}   ${to}`);
+    }
+    try {
+        let workspacePath = options.path || process.cwd();
+        // 如果路徑指向檔案，取其所在目錄
+        const isFile = await context.fileSystem.isFile(workspacePath);
+        if (isFile) {
+            workspacePath = path.dirname(workspacePath);
+            // 往上查找專案根目錄（包含 package.json、.git 等）
+            let currentDir = workspacePath;
+            while (currentDir !== path.dirname(currentDir)) {
+                const hasPackageJson = await context.fileSystem.exists(path.join(currentDir, 'package.json'));
+                const hasGit = await context.fileSystem.exists(path.join(currentDir, '.git'));
+                const hasSwiftPackage = await context.fileSystem.exists(path.join(currentDir, 'Package.swift'));
+                if (hasPackageJson || hasGit || hasSwiftPackage) {
+                    workspacePath = currentDir;
+                    break;
+                }
+                currentDir = path.dirname(currentDir);
+            }
+        }
+        // 初始化索引引擎（每次都重新索引以確保資料是最新的）
+        const config = createIndexConfig(workspacePath, {
+            includeExtensions: ['.ts', '.tsx', '.js', '.jsx', '.swift', '.py'],
+            excludePatterns: ['node_modules/**', '*.test.*']
+        });
+        const indexEngine = new IndexEngine(config, context.fileSystem);
+        try {
+            await indexEngine.indexProject(workspacePath);
+            // 初始化重新命名引擎（傳入 fileSystem）
+            const renameEngine = new RenameEngine(undefined, context.fileSystem);
+            // 1. 查找符號
+            if (!isJsonFormat) {
+                console.log(`   查找符號 "${from}"...`);
+            }
+            const searchResults = await indexEngine.findSymbol(from);
+            if (searchResults.length === 0) {
+                outputHandler.outputError(`找不到符號 "${from}"`, format, 'rename');
+                process.exitCode = 1;
+                return;
+            }
+            if (searchResults.length > 1 && !isJsonFormat) {
+                console.log('   找到多個符號，使用第一個:');
+                searchResults.forEach((result, index) => {
+                    console.log(`   ${index + 1}. ${result.symbol.name} 在 ${result.symbol.location.filePath}:${result.symbol.location.range.start.line}`);
+                });
+            }
+            const targetSymbol = searchResults[0].symbol;
+            // 2. Dry-run 預覽變更
+            if (options.dryRun) {
+                try {
+                    const allProjectFiles = await getAllProjectFiles(workspacePath, context);
+                    const preview = await renameEngine.previewRename({
+                        symbol: targetSymbol,
+                        newName: to,
+                        filePaths: allProjectFiles
+                    });
+                    // 讀取受影響檔案的原始內容
+                    const originalContents = new Map();
+                    for (const filePath of preview.affectedFiles) {
+                        try {
+                            const content = await context.fileSystem.readFile(filePath, 'utf-8');
+                            originalContents.set(filePath, content);
+                        }
+                        catch {
+                            // 忽略無法讀取的檔案
+                        }
+                    }
+                    // 轉換為統一的 PreviewInput 格式
+                    const previewInput = convertRenamePreview(preview.operations, preview.conflicts, originalContents, { oldName: from, newName: to });
+                    // 使用統一輸出處理器
+                    outputHandler.outputMutation(previewInput, format);
+                    return;
+                }
+                catch (previewError) {
+                    const errorMsg = previewError instanceof Error ? previewError.message : String(previewError);
+                    outputHandler.outputError(`預覽失敗: ${errorMsg}`, format, 'rename');
+                    process.exitCode = 1;
+                    return;
+                }
+            }
+            // 3. 執行重新命名（處理跨檔案引用）
+            if (!isJsonFormat) {
+                console.log('   執行重新命名...');
+            }
+            // 取得所有專案檔案（使用與 preview 相同的邏輯）
+            const allProjectFiles = await getAllProjectFiles(workspacePath, context);
+            // 先預覽變更
+            const preview = await renameEngine.previewRename({
+                symbol: targetSymbol,
+                newName: to,
+                filePaths: allProjectFiles
+            });
+            // 讀取受影響檔案的原始內容（用於輸出）
+            const originalContents = new Map();
+            for (const filePath of preview.affectedFiles) {
+                try {
+                    const content = await context.fileSystem.readFile(filePath, 'utf-8');
+                    originalContents.set(filePath, content);
+                }
+                catch {
+                    // 忽略無法讀取的檔案
+                }
+            }
+            // 使用 renameEngine 執行重新命名
+            const renameResult = await renameEngine.rename({
+                symbol: targetSymbol,
+                newName: to,
+                filePaths: allProjectFiles
+            });
+            if (renameResult.success) {
+                // 轉換為統一的 PreviewInput 格式並輸出
+                const previewInput = convertRenamePreview(preview.operations, preview.conflicts, originalContents, { oldName: from, newName: to });
+                outputHandler.outputMutation(previewInput, format);
+            }
+            else {
+                const errorMsg = renameResult.errors?.join(', ') || '重新命名失敗';
+                outputHandler.outputError(errorMsg, format, 'rename');
+                process.exitCode = 1;
+            }
+        }
+        finally {
+            indexEngine.dispose();
+        }
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        outputHandler.outputError(`重新命名失敗: ${errorMsg}`, format, 'rename');
+        process.exitCode = 1;
+    }
+}
+/**
+ * 取得所有專案檔案
+ */
+async function getAllProjectFiles(projectPath, context) {
+    const files = [];
+    // 從 ParserRegistry 獲取所有支援的副檔名
+    const registry = ParserRegistry.getInstance();
+    const allowedExtensions = registry.getSupportedExtensions();
+    const excludePatterns = ['node_modules', 'dist', '.git', 'coverage'];
+    // 檢查路徑是檔案還是目錄
+    try {
+        const isFile = await context.fileSystem.isFile(projectPath);
+        if (isFile) {
+            // 如果是單一檔案，直接返回
+            if (allowedExtensions.some(ext => projectPath.endsWith(ext))) {
+                return [projectPath];
+            }
+            return [];
+        }
+    }
+    catch {
+        // 路徑不存在
+        return [];
+    }
+    async function walkDir(dir) {
+        try {
+            const entries = await context.fileSystem.readDirectory(dir);
+            for (const entry of entries) {
+                const fullPath = entry.path;
+                if (entry.isDirectory) {
+                    // 跳過排除的目錄
+                    if (excludePatterns.some(pattern => entry.name.includes(pattern))) {
+                        continue;
+                    }
+                    await walkDir(fullPath);
+                }
+                else if (entry.isFile) {
+                    // 只包含支援的副檔名
+                    if (allowedExtensions.some(ext => entry.name.endsWith(ext))) {
+                        files.push(fullPath);
+                    }
+                }
+            }
+        }
+        catch {
+            // 忽略無法存取的目錄
+        }
+    }
+    await walkDir(projectPath);
+    return files;
+}
+//# sourceMappingURL=rename.command.js.map

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

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

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

@@ -0,0 +1,68 @@
+/**
+ * Snapshot 命令
+ * 產生模組快照供 AI 理解
+ */
+import * as path from 'path';
+import { SnapshotGenerator, isProjectSnapshot } from '../../../core/snapshot/index.js';
+import { createUnifiedOutputHandler, parseOutputFormat, OutputFormat } from '../../cli/unified-output-handler.js';
+import { QueryCommand } from '../../../infrastructure/formatters/query-types.js';
+/**
+ * 設定 snapshot 命令
+ */
+export function setupSnapshotCommand(program, context) {
+    program
+        .command('snapshot')
+        .description('產生模組快照供 AI 理解')
+        .option('-p, --path <path>', '目標路徑', '.')
+        .option('--format <format>', '輸出格式 (json|summary)', 'json')
+        .action(async (options) => {
+        await handleSnapshotCommand(options, context);
+    });
+}
+/**
+ * 處理 snapshot 命令
+ */
+async function handleSnapshotCommand(options, context) {
+    const outputHandler = createUnifiedOutputHandler();
+    let format;
+    try {
+        format = parseOutputFormat(options.format, false);
+    }
+    catch {
+        outputHandler.outputError('不支援的輸出格式。可用格式: json, summary', OutputFormat.Summary);
+        process.exitCode = 1;
+        return;
+    }
+    const targetPath = path.resolve(options.path);
+    // 檢查路徑是否存在
+    const exists = await context.fileSystem.exists(targetPath);
+    if (!exists) {
+        outputHandler.outputError(`路徑不存在: ${targetPath}`, format);
+        process.exitCode = 1;
+        return;
+    }
+    try {
+        const generator = new SnapshotGenerator(context.fileSystem);
+        const rawResult = await generator.generate(targetPath);
+        // 建構 SnapshotResult
+        const isProject = isProjectSnapshot(rawResult);
+        const result = {
+            command: QueryCommand.Snapshot,
+            success: true,
+            summary: {
+                totalScanned: isProject
+                    ? Object.keys(rawResult.modules).length
+                    : 1
+            },
+            snapshotType: isProject ? 'project' : 'module',
+            snapshot: rawResult
+        };
+        outputHandler.outputQuery(result, format);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : '未知錯誤';
+        outputHandler.outputError(`產生快照失敗: ${message}`, format);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=snapshot.command.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.command.js","sourceRoot":"","sources":["../../../../src/interfaces/cli/commands/snapshot.command.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AACxH,OAAO,EAAE,YAAY,EAA0E,MAAM,2CAA2C,CAAC;AASjJ;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAgB,EAAE,OAAuB;IAC5E,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,eAAe,CAAC;SAC5B,MAAM,CAAC,mBAAmB,EAAE,MAAM,EAAE,GAAG,CAAC;SACxC,MAAM,CAAC,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,CAAC;SAC1D,MAAM,CAAC,KAAK,EAAE,OAAwB,EAAE,EAAE;QACzC,MAAM,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,qBAAqB,CAAC,OAAwB,EAAE,OAAuB;IACpF,MAAM,aAAa,GAAG,0BAA0B,EAAE,CAAC;IACnD,IAAI,MAAoB,CAAC;IAEzB,IAAI,CAAC;QACH,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,aAAa,CAAC,WAAW,CAAC,8BAA8B,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;QAChF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C,WAAW;IACX,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC3D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,aAAa,CAAC,WAAW,CAAC,UAAU,UAAU,EAAE,EAAE,MAAM,CAAC,CAAC;QAC1D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,iBAAiB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC5D,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAEvD,oBAAoB;QACpB,MAAM,SAAS,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAmB;YAC7B,OAAO,EAAE,YAAY,CAAC,QAAQ;YAC9B,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP,YAAY,EAAE,SAAS;oBACrB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,MAAM;oBACvC,CAAC,CAAC,CAAC;aACN;YACD,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;YAC9C,QAAQ,EAAE,SAAqD;SAChE,CAAC;QAEF,aAAa,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;QAChE,aAAa,CAAC,WAAW,CAAC,WAAW,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;QACxD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/interfaces/cli/commands/types.d.ts

@@ -0,0 +1,18 @@
+/**
+ * CLI 命令共用型別定義
+ */
+import type { Command } from 'commander';
+import type { IFileSystem } from '../../../infrastructure/storage/index.js';
+/**
+ * 命令共用 Context
+ * 包含所有命令可能需要的共用依賴
+ */
+export interface CommandContext {
+    /** 檔案系統實例 */
+    readonly fileSystem: IFileSystem;
+}
+/**
+ * 命令設定函數簽章
+ */
+export type CommandSetup = (program: Command, context: CommandContext) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/interfaces/cli/commands/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/cli/commands/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAEpE;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,aAAa;IACb,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC"}

package/dist/interfaces/cli/commands/types.js

@@ -0,0 +1,5 @@
+/**
+ * CLI 命令共用型別定義
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/interfaces/cli/commands/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/interfaces/cli/commands/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/interfaces/cli/index.d.ts

@@ -2,6 +2,6 @@
 /**
  * CLI 入口點
  */
-import { AgentIdeCLI } from './cli.js';
+import { AgentIdeCLI } from '../cli/cli.js';
 export { AgentIdeCLI };
 //# sourceMappingURL=index.d.ts.map

package/dist/interfaces/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interfaces/cli/index.ts"],"names":[],"mappings":";AAEA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAkBvC,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interfaces/cli/index.ts"],"names":[],"mappings":";AAEA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAkBrD,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/interfaces/cli/index.js

@@ -2,7 +2,7 @@
 /**
  * CLI 入口點
  */
-import { AgentIdeCLI } from './cli.js';
+import { AgentIdeCLI } from '../cli/cli.js';
 // 啟動 CLI
 async function main() {
     const cli = new AgentIdeCLI();

package/dist/interfaces/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interfaces/cli/index.ts"],"names":[],"mappings":";AAEA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,SAAS;AACT,KAAK,UAAU,IAAI;IACjB,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC3E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,gBAAgB;AAChB,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,IAAI,EAAE,CAAC;AACT,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interfaces/cli/index.ts"],"names":[],"mappings":";AAEA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,SAAS;AACT,KAAK,UAAU,IAAI;IACjB,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC3E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,gBAAgB;AAChB,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,IAAI,EAAE,CAAC;AACT,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/interfaces/cli/preview-output-handler.d.ts

@@ -0,0 +1,53 @@
+/**
+ * CLI Preview 輸出處理器
+ * 統一處理所有支援 dry-run 命令的輸出
+ */
+import { type PreviewResult, type PreviewInput } from '../../infrastructure/formatters/index.js';
+/** CLI 輸出格式選項 */
+export declare enum OutputFormatOption {
+    Diff = "diff",
+    Json = "json",
+    Summary = "summary"
+}
+/** 輸出選項 */
+export interface PreviewOutputOptions {
+    /** 輸出格式 */
+    format: OutputFormatOption;
+    /** 是否啟用顏色 */
+    color?: boolean;
+    /** 上下文行數 */
+    contextLines?: number;
+}
+/**
+ * Preview 輸出處理器
+ * 統一處理 dry-run 和實際執行的輸出
+ */
+export declare class PreviewOutputHandler {
+    private readonly formatter;
+    constructor(options?: Partial<PreviewOutputOptions>);
+    /**
+     * 從 PreviewInput 生成並輸出 PreviewResult
+     */
+    output(input: PreviewInput, format: OutputFormatOption): void;
+    /**
+     * 直接輸出 PreviewResult
+     */
+    outputResult(result: PreviewResult, format: OutputFormatOption): void;
+    /**
+     * 取得 PreviewResult（不輸出）
+     */
+    createResult(input: PreviewInput): PreviewResult;
+    /**
+     * 格式化為字串（不輸出）
+     */
+    formatResult(result: PreviewResult, format: OutputFormatOption): string;
+    /**
+     * CLI format 選項映射到 PreviewFormat
+     */
+    private mapFormat;
+}
+/**
+ * 建立 PreviewOutputHandler 的工廠函數
+ */
+export declare function createOutputHandler(options?: Partial<PreviewOutputOptions>): PreviewOutputHandler;
+//# sourceMappingURL=preview-output-handler.d.ts.map

package/dist/interfaces/cli/preview-output-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-output-handler.d.ts","sourceRoot":"","sources":["../../../src/interfaces/cli/preview-output-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,0CAA0C,CAAC;AAElD,iBAAiB;AACjB,oBAAY,kBAAkB;IAC5B,IAAI,SAAS;IACb,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAED,WAAW;AACX,MAAM,WAAW,oBAAoB;IACnC,WAAW;IACX,MAAM,EAAE,kBAAkB,CAAC;IAC3B,aAAa;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAEf,OAAO,GAAE,OAAO,CAAC,oBAAoB,CAAM;IAOvD;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAK7D;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAKrE;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa;IAIhD;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,kBAAkB,GAAG,MAAM;IAKvE;;OAEG;IACH,OAAO,CAAC,SAAS;CAWlB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,oBAAoB,CAEjG"}

package/dist/interfaces/cli/preview-output-handler.js

@@ -0,0 +1,73 @@
+/**
+ * CLI Preview 輸出處理器
+ * 統一處理所有支援 dry-run 命令的輸出
+ */
+import { createPreviewFormatter, PreviewFormat } from '../../infrastructure/formatters/index.js';
+/** CLI 輸出格式選項 */
+export var OutputFormatOption;
+(function (OutputFormatOption) {
+    OutputFormatOption["Diff"] = "diff";
+    OutputFormatOption["Json"] = "json";
+    OutputFormatOption["Summary"] = "summary";
+})(OutputFormatOption || (OutputFormatOption = {}));
+/**
+ * Preview 輸出處理器
+ * 統一處理 dry-run 和實際執行的輸出
+ */
+export class PreviewOutputHandler {
+    formatter;
+    constructor(options = {}) {
+        this.formatter = createPreviewFormatter({
+            contextLines: options.contextLines ?? 3,
+            color: options.color ?? (process.stdout.isTTY ?? false)
+        });
+    }
+    /**
+     * 從 PreviewInput 生成並輸出 PreviewResult
+     */
+    output(input, format) {
+        const result = this.formatter.createPreview(input);
+        this.outputResult(result, format);
+    }
+    /**
+     * 直接輸出 PreviewResult
+     */
+    outputResult(result, format) {
+        const outputFormat = this.mapFormat(format);
+        console.log(this.formatter.format(result, outputFormat));
+    }
+    /**
+     * 取得 PreviewResult（不輸出）
+     */
+    createResult(input) {
+        return this.formatter.createPreview(input);
+    }
+    /**
+     * 格式化為字串（不輸出）
+     */
+    formatResult(result, format) {
+        const outputFormat = this.mapFormat(format);
+        return this.formatter.format(result, outputFormat);
+    }
+    /**
+     * CLI format 選項映射到 PreviewFormat
+     */
+    mapFormat(format) {
+        switch (format) {
+            case OutputFormatOption.Json:
+                return PreviewFormat.Json;
+            case OutputFormatOption.Summary:
+                return PreviewFormat.Summary;
+            case OutputFormatOption.Diff:
+            default:
+                return PreviewFormat.Diff;
+        }
+    }
+}
+/**
+ * 建立 PreviewOutputHandler 的工廠函數
+ */
+export function createOutputHandler(options) {
+    return new PreviewOutputHandler(options);
+}
+//# sourceMappingURL=preview-output-handler.js.map

package/dist/interfaces/cli/preview-output-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-output-handler.js","sourceRoot":"","sources":["../../../src/interfaces/cli/preview-output-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,sBAAsB,EACtB,aAAa,EAGd,MAAM,0CAA0C,CAAC;AAElD,iBAAiB;AACjB,MAAM,CAAN,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC5B,mCAAa,CAAA;IACb,mCAAa,CAAA;IACb,yCAAmB,CAAA;AACrB,CAAC,EAJW,kBAAkB,KAAlB,kBAAkB,QAI7B;AAYD;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IACd,SAAS,CAAC;IAE3B,YAAY,UAAyC,EAAE;QACrD,IAAI,CAAC,SAAS,GAAG,sBAAsB,CAAC;YACtC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,CAAC;YACvC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,KAAK,CAAC;SACxD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAmB,EAAE,MAA0B;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACnD,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,MAAqB,EAAE,MAA0B;QAC5D,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,KAAmB;QAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,MAAqB,EAAE,MAA0B;QAC5D,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACK,SAAS,CAAC,MAA0B;QAC1C,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,kBAAkB,CAAC,IAAI;gBAC1B,OAAO,aAAa,CAAC,IAAI,CAAC;YAC5B,KAAK,kBAAkB,CAAC,OAAO;gBAC7B,OAAO,aAAa,CAAC,OAAO,CAAC;YAC/B,KAAK,kBAAkB,CAAC,IAAI,CAAC;YAC7B;gBACE,OAAO,aAAa,CAAC,IAAI,CAAC;QAC9B,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAuC;IACzE,OAAO,IAAI,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC"}

package/dist/interfaces/cli/unified-output-handler.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 統一輸出處理器
+ * 整合變更類（PreviewFormatter）和唯讀類（QueryFormatter）的輸出處理
+ */
+import { type PreviewResult, type PreviewInput } from '../../infrastructure/formatters/index.js';
+import type { QueryResult } from '../../infrastructure/formatters/query-types.js';
+/** 統一輸出格式 */
+export declare enum OutputFormat {
+    /** JSON 格式（機器可讀） */
+    Json = "json",
+    /** 摘要格式（人類可讀） */
+    Summary = "summary",
+    /** Diff 格式（僅變更類命令） */
+    Diff = "diff"
+}
+/** 輸出處理器選項 */
+export interface UnifiedOutputOptions {
+    /** 是否啟用顏色 */
+    color?: boolean;
+    /** 上下文行數（僅變更類命令） */
+    contextLines?: number;
+}
+/**
+ * 統一輸出處理器
+ * 處理所有 CLI 命令的輸出
+ */
+export declare class UnifiedOutputHandler {
+    private readonly previewFormatter;
+    private readonly queryFormatter;
+    constructor(options?: UnifiedOutputOptions);
+    /**
+     * 從 PreviewInput 生成並輸出變更類結果
+     */
+    outputMutation(input: PreviewInput, format: OutputFormat): void;
+    /**
+     * 直接輸出變更類結果
+     */
+    outputMutationResult(result: PreviewResult, format: OutputFormat): void;
+    /**
+     * 格式化變更類結果（不輸出）
+     */
+    formatMutationResult(result: PreviewResult, format: OutputFormat): string;
+    /**
+     * 建立變更類結果（不輸出）
+     */
+    createMutationResult(input: PreviewInput): PreviewResult;
+    /**
+     * 輸出唯讀類結果
+     */
+    outputQuery(result: QueryResult, format: OutputFormat): void;
+    /**
+     * 格式化唯讀類結果（不輸出）
+     */
+    formatQueryResult(result: QueryResult, format: OutputFormat): string;
+    /**
+     * 輸出錯誤
+     * JSON 格式輸出到 stdout（機器可讀），其他格式輸出到 stderr
+     * @param command 可選的命令名稱，JSON 輸出時會包含此欄位
+     */
+    outputError(error: Error | string, format: OutputFormat, command?: string): void;
+    /**
+     * 映射 OutputFormat 到 PreviewFormat
+     */
+    private mapToPreviewFormat;
+    /**
+     * 映射 OutputFormat 到 QueryFormat
+     */
+    private mapToQueryFormat;
+}
+/**
+ * 建立 UnifiedOutputHandler 的工廠函數
+ */
+export declare function createUnifiedOutputHandler(options?: UnifiedOutputOptions): UnifiedOutputHandler;
+/**
+ * 解析 format 字串為 OutputFormat
+ * @throws Error 如果格式無效
+ */
+export declare function parseOutputFormat(format: string, allowDiff?: boolean): OutputFormat;
+//# sourceMappingURL=unified-output-handler.d.ts.map

package/dist/interfaces/cli/unified-output-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified-output-handler.d.ts","sourceRoot":"","sources":["../../../src/interfaces/cli/unified-output-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,0CAA0C,CAAC;AAKlD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAE7E,aAAa;AACb,oBAAY,YAAY;IACtB,oBAAoB;IACpB,IAAI,SAAS;IACb,iBAAiB;IACjB,OAAO,YAAY;IACnB,sBAAsB;IACtB,IAAI,SAAS;CACd;AAED,cAAc;AACd,MAAM,WAAW,oBAAoB;IACnC,aAAa;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oBAAoB;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAEpB,OAAO,GAAE,oBAAyB;IAa9C;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAK/D;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAIvE;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM;IAKzE;;OAEG;IACH,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa;IAMxD;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAI5D;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM;IAOpE;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAmBhF;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAUzB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,oBAAoB,CAE/F;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,UAAO,GAAG,YAAY,CAchF"}