agent-ide 0.2.0 → 0.4.0

package/dist/infrastructure/formatters/preview-converter.js

@@ -0,0 +1,209 @@
+/**
+ * Preview 輸入轉換器
+ * 將各 Core 模組的 preview 結果轉換為統一的 PreviewInput 格式
+ */
+import { PreviewCommand } from './types.js';
+/**
+ * 從 Rename 模組的 preview 結果轉換為 PreviewInput
+ */
+export function convertRenamePreview(operations, conflicts, originalContents, options) {
+    const baseInput = convertOperationsToPreviewInput(PreviewCommand.Rename, operations, originalContents, convertRenameConflicts(conflicts));
+    return {
+        ...baseInput,
+        operationDescription: options?.oldName && options?.newName
+            ? `Renamed '${options.oldName}' to '${options.newName}'`
+            : undefined
+    };
+}
+/**
+ * 從 Move 模組的結果轉換為 PreviewInput
+ */
+export function convertMovePreview(sourceFile, targetFile, pathUpdates, originalContents) {
+    const fileChanges = [];
+    // 處理 import 更新
+    const groupedUpdates = new Map();
+    for (const update of pathUpdates) {
+        const existing = groupedUpdates.get(update.filePath) ?? [];
+        existing.push({ oldImport: update.oldImport, newImport: update.newImport, line: update.line });
+        groupedUpdates.set(update.filePath, existing);
+    }
+    for (const [filePath, updates] of groupedUpdates) {
+        const originalContent = originalContents.get(filePath) ?? '';
+        const changes = updates.map(u => ({
+            line: u.line,
+            oldContent: u.oldImport,
+            newContent: u.newImport
+        }));
+        fileChanges.push({ filePath, originalContent, changes });
+    }
+    // 從路徑提取檔名
+    const sourceFileName = sourceFile.split('/').pop() ?? sourceFile;
+    const targetFileName = targetFile.split('/').pop() ?? targetFile;
+    return {
+        command: PreviewCommand.Move,
+        success: true,
+        fileChanges,
+        operationDescription: `Moved '${sourceFileName}' to '${targetFileName}'`
+    };
+}
+/**
+ * 從 Shift 模組的結果轉換為 PreviewInput
+ */
+export function convertShiftPreview(sourceFile, targetFile, fromLine, toLine, position, sourceOriginalContent, targetOriginalContent, movedLines) {
+    const fileChanges = [];
+    const isSameFile = sourceFile === targetFile;
+    if (isSameFile) {
+        // 同檔案移動
+        const changes = [];
+        // 標記刪除的行
+        for (let line = fromLine; line <= toLine; line++) {
+            const originalLines = sourceOriginalContent.split('\n');
+            changes.push({
+                line,
+                oldContent: originalLines[line - 1] ?? '',
+                newContent: null
+            });
+        }
+        // 標記插入的行
+        const insertPosition = position > toLine ? position - (toLine - fromLine + 1) : position;
+        movedLines.forEach((content, index) => {
+            changes.push({
+                line: insertPosition + index,
+                oldContent: null,
+                newContent: content
+            });
+        });
+        fileChanges.push({
+            filePath: sourceFile,
+            originalContent: sourceOriginalContent,
+            changes
+        });
+    }
+    else {
+        // 跨檔案移動
+        // Source: 刪除行
+        const sourceChanges = [];
+        for (let line = fromLine; line <= toLine; line++) {
+            const originalLines = sourceOriginalContent.split('\n');
+            sourceChanges.push({
+                line,
+                oldContent: originalLines[line - 1] ?? '',
+                newContent: null
+            });
+        }
+        fileChanges.push({
+            filePath: sourceFile,
+            originalContent: sourceOriginalContent,
+            changes: sourceChanges
+        });
+        // Target: 插入行
+        const targetChanges = movedLines.map((content, index) => ({
+            line: position + index,
+            oldContent: null,
+            newContent: content
+        }));
+        fileChanges.push({
+            filePath: targetFile,
+            originalContent: targetOriginalContent ?? '',
+            changes: targetChanges
+        });
+    }
+    // 生成操作描述
+    const linesCount = toLine - fromLine + 1;
+    const operationDescription = isSameFile
+        ? `Moved ${linesCount} line${linesCount > 1 ? 's' : ''} within file (${fromLine}-${toLine} → ${position})`
+        : `Moved ${linesCount} line${linesCount > 1 ? 's' : ''} to '${targetFile.split('/').pop()}'`;
+    return {
+        command: PreviewCommand.Shift,
+        success: true,
+        fileChanges,
+        operationDescription
+    };
+}
+/**
+ * 從 Refactor/Extract 模組的結果轉換為 PreviewInput
+ */
+export function convertRefactorPreview(edits, filePath, originalContent, targetFileContent, targetFilePath, options) {
+    const fileChanges = [];
+    const originalLines = originalContent.split('\n');
+    // 主檔案變更
+    const changes = edits.map(edit => {
+        const startLine = edit.range.start.line;
+        const endLine = edit.range.end.line;
+        // 組合原始內容
+        const oldContent = originalLines.slice(startLine - 1, endLine).join('\n');
+        return {
+            line: startLine,
+            oldContent,
+            newContent: edit.newText
+        };
+    });
+    fileChanges.push({ filePath, originalContent, changes });
+    // 目標檔案（跨檔案提取）
+    if (targetFilePath && targetFileContent) {
+        fileChanges.push({
+            filePath: targetFilePath,
+            originalContent: '', // 新檔案
+            changes: [{
+                    line: 1,
+                    oldContent: null,
+                    newContent: targetFileContent
+                }]
+        });
+    }
+    // 生成操作描述
+    let operationDescription;
+    if (options?.functionName) {
+        operationDescription = `Extracted function '${options.functionName}'`;
+    }
+    else if (options?.action) {
+        operationDescription = options.action;
+    }
+    return {
+        command: PreviewCommand.Refactor,
+        success: true,
+        fileChanges,
+        operationDescription
+    };
+}
+/**
+ * 通用操作轉換函數
+ */
+function convertOperationsToPreviewInput(command, operations, originalContents, conflicts, errors) {
+    // 按檔案分組操作
+    const groupedOps = new Map();
+    for (const op of operations) {
+        const existing = groupedOps.get(op.filePath) ?? [];
+        existing.push(op);
+        groupedOps.set(op.filePath, existing);
+    }
+    const fileChanges = [];
+    for (const [filePath, ops] of groupedOps) {
+        const originalContent = originalContents.get(filePath) ?? '';
+        const changes = ops.map(op => ({
+            line: op.range.start.line,
+            oldContent: op.oldText,
+            newContent: op.newText
+        }));
+        fileChanges.push({ filePath, originalContent, changes });
+    }
+    return {
+        command,
+        success: true,
+        fileChanges,
+        conflicts,
+        errors
+    };
+}
+/**
+ * 轉換 rename 模組的衝突格式
+ */
+function convertRenameConflicts(conflicts) {
+    return conflicts.map(c => ({
+        type: c.type,
+        message: c.message,
+        filePath: c.location?.filePath ?? null,
+        line: c.location?.range?.start.line ?? null
+    }));
+}
+//# sourceMappingURL=preview-converter.js.map

package/dist/infrastructure/formatters/preview-converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-converter.js","sourceRoot":"","sources":["../../../src/infrastructure/formatters/preview-converter.ts"],"names":[],"mappings":"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"}

package/dist/infrastructure/formatters/preview-formatter.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Preview 格式化器
+ * 將 PreviewResult 轉換為 diff 或 json 格式輸出
+ */
+import { PreviewFormat, type PreviewFormatterOptions, type PreviewResult, type PreviewInput } from './types.js';
+/**
+ * Preview 格式化器
+ * 統一處理所有命令的 dry-run 輸出
+ */
+export declare class PreviewFormatter {
+    private readonly contextLines;
+    private readonly color;
+    constructor(options?: Partial<PreviewFormatterOptions>);
+    /**
+     * 從原始輸入資料生成 PreviewResult
+     */
+    createPreview(input: PreviewInput): PreviewResult;
+    /**
+     * 格式化 PreviewResult 為指定格式
+     */
+    format(result: PreviewResult, outputFormat?: PreviewFormat): string;
+    /**
+     * 轉換為 unified diff 格式
+     */
+    toDiff(result: PreviewResult): string;
+    /**
+     * 轉換為 JSON 格式（含上下文）
+     */
+    toJson(result: PreviewResult): string;
+    /**
+     * 轉換為 summary 格式
+     * 統計 + 每個檔案的簡短變更描述
+     */
+    toSummary(result: PreviewResult): string;
+    /**
+     * 格式化單一檔案的 diff
+     */
+    private formatFileDiff;
+    /**
+     * 格式化單一 hunk
+     */
+    private formatHunk;
+    /**
+     * 格式化單一變更行
+     */
+    private formatChangeLine;
+    /**
+     * 格式化摘要行
+     */
+    private formatSummary;
+    /**
+     * 套用顏色（如果啟用）
+     */
+    private colorize;
+}
+/**
+ * 建立 PreviewFormatter 的工廠函數
+ * 根據終端機環境自動決定是否啟用顏色
+ */
+export declare function createPreviewFormatter(options?: Partial<PreviewFormatterOptions>): PreviewFormatter;
+//# sourceMappingURL=preview-formatter.d.ts.map

package/dist/infrastructure/formatters/preview-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-formatter.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/formatters/preview-formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEL,aAAa,EACb,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAIlB,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;AAYpB;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;gBAEpB,OAAO,GAAE,OAAO,CAAC,uBAAuB,CAAM;IAK1D;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa;IAIjD;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,YAAY,GAAE,aAAkC,GAAG,MAAM;IAavF;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM;IAiCrC;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM;IAIrC;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM;IAiDxC;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,OAAO,CAAC,UAAU;IAclB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;OAEG;IACH,OAAO,CAAC,QAAQ;CAMjB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAAG,gBAAgB,CAMvG"}

package/dist/infrastructure/formatters/preview-formatter.js

@@ -0,0 +1,208 @@
+/**
+ * Preview 格式化器
+ * 將 PreviewResult 轉換為 diff 或 json 格式輸出
+ */
+import { ChangeLineType, PreviewFormat } from './types.js';
+import { generatePreviewResult } from '../formatters/diff-generator.js';
+/** ANSI 顏色碼 */
+const Colors = {
+    reset: '\x1b[0m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    cyan: '\x1b[36m',
+    dim: '\x1b[2m'
+};
+/**
+ * Preview 格式化器
+ * 統一處理所有命令的 dry-run 輸出
+ */
+export class PreviewFormatter {
+    contextLines;
+    color;
+    constructor(options = {}) {
+        this.contextLines = options.contextLines ?? 3;
+        this.color = options.color ?? false;
+    }
+    /**
+     * 從原始輸入資料生成 PreviewResult
+     */
+    createPreview(input) {
+        return generatePreviewResult(input, this.contextLines);
+    }
+    /**
+     * 格式化 PreviewResult 為指定格式
+     */
+    format(result, outputFormat = PreviewFormat.Diff) {
+        switch (outputFormat) {
+            case PreviewFormat.Diff:
+                return this.toDiff(result);
+            case PreviewFormat.Json:
+                return this.toJson(result);
+            case PreviewFormat.Summary:
+                return this.toSummary(result);
+            default:
+                return this.toDiff(result);
+        }
+    }
+    /**
+     * 轉換為 unified diff 格式
+     */
+    toDiff(result) {
+        const lines = [];
+        // 檔案變更
+        result.files.forEach(file => {
+            lines.push(...this.formatFileDiff(file));
+            lines.push(''); // 檔案之間空行
+        });
+        // 摘要
+        lines.push(this.formatSummary(result));
+        // 衝突警告
+        if (result.conflicts && result.conflicts.length > 0) {
+            lines.push('');
+            lines.push(this.colorize('Conflicts:', Colors.red));
+            result.conflicts.forEach(conflict => {
+                lines.push(this.colorize(`  - ${conflict.message}`, Colors.red));
+            });
+        }
+        // 錯誤訊息
+        if (result.errors && result.errors.length > 0) {
+            lines.push('');
+            lines.push(this.colorize('Errors:', Colors.red));
+            result.errors.forEach(error => {
+                lines.push(this.colorize(`  - ${error}`, Colors.red));
+            });
+        }
+        return lines.join('\n');
+    }
+    /**
+     * 轉換為 JSON 格式（含上下文）
+     */
+    toJson(result) {
+        return JSON.stringify(result, null, 2);
+    }
+    /**
+     * 轉換為 summary 格式
+     * 統計 + 每個檔案的簡短變更描述
+     */
+    toSummary(result) {
+        const lines = [];
+        // 操作描述
+        if (result.operationDescription) {
+            lines.push(result.operationDescription);
+            lines.push('');
+        }
+        // 統計摘要
+        const { summary } = result;
+        const addPart = this.colorize(`+${summary.additions}`, Colors.green);
+        const delPart = this.colorize(`-${summary.deletions}`, Colors.red);
+        lines.push(`Files: ${summary.totalFiles}`);
+        lines.push(`Changes: ${summary.totalChanges} (${addPart} ${delPart})`);
+        // 檔案變更列表
+        if (result.fileSummaries && result.fileSummaries.length > 0) {
+            lines.push('');
+            lines.push('Files:');
+            result.fileSummaries.forEach(fs => {
+                const stats = this.colorize(`+${fs.additions}`, Colors.green)
+                    + ' '
+                    + this.colorize(`-${fs.deletions}`, Colors.red);
+                lines.push(`  ${fs.filePath}: ${fs.changeType} (${stats})`);
+            });
+        }
+        // 衝突警告
+        if (result.conflicts && result.conflicts.length > 0) {
+            lines.push('');
+            lines.push(this.colorize('Conflicts:', Colors.red));
+            result.conflicts.forEach(conflict => {
+                lines.push(this.colorize(`  - ${conflict.message}`, Colors.red));
+            });
+        }
+        // 錯誤訊息
+        if (result.errors && result.errors.length > 0) {
+            lines.push('');
+            lines.push(this.colorize('Errors:', Colors.red));
+            result.errors.forEach(error => {
+                lines.push(this.colorize(`  - ${error}`, Colors.red));
+            });
+        }
+        return lines.join('\n');
+    }
+    /**
+     * 格式化單一檔案的 diff
+     */
+    formatFileDiff(file) {
+        const lines = [];
+        // 檔案 header
+        lines.push(this.colorize(`--- a/${file.filePath}`, Colors.dim));
+        lines.push(this.colorize(`+++ b/${file.filePath}`, Colors.dim));
+        // Hunks
+        file.hunks.forEach(hunk => {
+            lines.push(...this.formatHunk(hunk));
+        });
+        return lines;
+    }
+    /**
+     * 格式化單一 hunk
+     */
+    formatHunk(hunk) {
+        const lines = [];
+        // Hunk header
+        lines.push(this.colorize(hunk.header, Colors.cyan));
+        // 變更行
+        hunk.lines.forEach(line => {
+            lines.push(this.formatChangeLine(line));
+        });
+        return lines;
+    }
+    /**
+     * 格式化單一變更行
+     */
+    formatChangeLine(line) {
+        switch (line.type) {
+            case ChangeLineType.Add:
+                return this.colorize(`+${line.content}`, Colors.green);
+            case ChangeLineType.Delete:
+                return this.colorize(`-${line.content}`, Colors.red);
+            case ChangeLineType.Context:
+                return ` ${line.content}`;
+            default:
+                return ` ${line.content}`;
+        }
+    }
+    /**
+     * 格式化摘要行
+     */
+    formatSummary(result) {
+        const { summary } = result;
+        const parts = [
+            `${summary.totalFiles} file${summary.totalFiles !== 1 ? 's' : ''}`,
+            `${summary.totalChanges} change${summary.totalChanges !== 1 ? 's' : ''}`
+        ];
+        if (summary.additions > 0 || summary.deletions > 0) {
+            const addPart = this.colorize(`+${summary.additions}`, Colors.green);
+            const delPart = this.colorize(`-${summary.deletions}`, Colors.red);
+            parts.push(`(${addPart} ${delPart})`);
+        }
+        return `Summary: ${parts.join(', ')}`;
+    }
+    /**
+     * 套用顏色（如果啟用）
+     */
+    colorize(text, color) {
+        if (!this.color) {
+            return text;
+        }
+        return `${color}${text}${Colors.reset}`;
+    }
+}
+/**
+ * 建立 PreviewFormatter 的工廠函數
+ * 根據終端機環境自動決定是否啟用顏色
+ */
+export function createPreviewFormatter(options = {}) {
+    const finalOptions = {
+        contextLines: options.contextLines ?? 3,
+        color: options.color ?? (process.stdout.isTTY ?? false)
+    };
+    return new PreviewFormatter(finalOptions);
+}
+//# sourceMappingURL=preview-formatter.js.map

package/dist/infrastructure/formatters/preview-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-formatter.js","sourceRoot":"","sources":["../../../src/infrastructure/formatters/preview-formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,cAAc,EACd,aAAa,EAOd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AAErF,eAAe;AACf,MAAM,MAAM,GAAG;IACb,KAAK,EAAE,SAAS;IAChB,GAAG,EAAE,UAAU;IACf,KAAK,EAAE,UAAU;IACjB,IAAI,EAAE,UAAU;IAChB,GAAG,EAAE,SAAS;CACN,CAAC;AAEX;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IACV,YAAY,CAAS;IACrB,KAAK,CAAU;IAEhC,YAAY,UAA4C,EAAE;QACxD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,KAAmB;QAC/B,OAAO,qBAAqB,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAqB,EAAE,eAA8B,aAAa,CAAC,IAAI;QAC5E,QAAQ,YAAY,EAAE,CAAC;YACrB,KAAK,aAAa,CAAC,IAAI;gBACrB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC7B,KAAK,aAAa,CAAC,IAAI;gBACrB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC7B,KAAK,aAAa,CAAC,OAAO;gBACxB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAChC;gBACE,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAqB;QAC1B,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,OAAO;QACP,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YAC1B,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;QAC3B,CAAC,CAAC,CAAC;QAEH,KAAK;QACL,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;QAEvC,OAAO;QACP,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACpD,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAClC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,QAAQ,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACnE,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO;QACP,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACjD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;gBAC5B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,KAAK,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACxD,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAqB;QAC1B,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,MAAqB;QAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,OAAO;QACP,IAAI,MAAM,CAAC,oBAAoB,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,OAAO;QACP,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,SAAS,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QACrE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,SAAS,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;QACnE,KAAK,CAAC,IAAI,CAAC,UAAU,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,YAAY,KAAK,OAAO,IAAI,OAAO,GAAG,CAAC,CAAC;QAEvE,SAAS;QACT,IAAI,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACrB,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE;gBAChC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC;sBACzD,GAAG;sBACH,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;gBAClD,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,QAAQ,KAAK,EAAE,CAAC,UAAU,KAAK,KAAK,GAAG,CAAC,CAAC;YAC9D,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO;QACP,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACpD,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAClC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,QAAQ,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACnE,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO;QACP,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACjD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;gBAC5B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,KAAK,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACxD,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,IAAgB;QACrC,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,YAAY;QACZ,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,IAAI,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAChE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,IAAI,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAEhE,QAAQ;QACR,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YACxB,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,IAAc;QAC/B,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,cAAc;QACd,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAEpD,MAAM;QACN,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YACxB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,IAAgB;QACvC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,cAAc,CAAC,GAAG;gBACrB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YACzD,KAAK,cAAc,CAAC,MAAM;gBACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;YACvD,KAAK,cAAc,CAAC,OAAO;gBACzB,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC5B;gBACE,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,MAAqB;QACzC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QAC3B,MAAM,KAAK,GAAG;YACZ,GAAG,OAAO,CAAC,UAAU,QAAQ,OAAO,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAClE,GAAG,OAAO,CAAC,YAAY,UAAU,OAAO,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;SACzE,CAAC;QAEF,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;YACnD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,SAAS,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YACrE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,SAAS,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;YACnE,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,OAAO,GAAG,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,YAAY,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACxC,CAAC;IAED;;OAEG;IACK,QAAQ,CAAC,IAAY,EAAE,KAAa;QAC1C,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,GAAG,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;IAC1C,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAA4C,EAAE;IACnF,MAAM,YAAY,GAAqC;QACrD,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,CAAC;QACvC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,KAAK,CAAC;KACxD,CAAC;IACF,OAAO,IAAI,gBAAgB,CAAC,YAAY,CAAC,CAAC;AAC5C,CAAC"}

package/dist/infrastructure/formatters/query-formatter.d.ts

@@ -0,0 +1,83 @@
+/**
+ * 唯讀命令格式化器
+ * 提供 json 和 summary 兩種輸出格式
+ */
+import { type QueryResult } from './query-types.js';
+/** QueryFormatter 選項 */
+export interface QueryFormatterOptions {
+    /** 是否啟用顏色輸出 */
+    color: boolean;
+}
+/** 輸出格式 */
+export declare enum QueryFormat {
+    Json = "json",
+    Summary = "summary"
+}
+/**
+ * 唯讀命令格式化器
+ */
+export declare class QueryFormatter {
+    private readonly color;
+    constructor(options?: Partial<QueryFormatterOptions>);
+    /**
+     * 格式化結果
+     */
+    format(result: QueryResult, outputFormat: QueryFormat): string;
+    /**
+     * 轉換為 JSON 格式
+     */
+    toJson(result: QueryResult): string;
+    /**
+     * 轉換為 summary 格式
+     */
+    toSummary(result: QueryResult): string;
+    /**
+     * 格式化 Search 摘要
+     */
+    private formatSearchSummary;
+    /**
+     * 格式化 Deps 摘要
+     */
+    private formatDepsSummary;
+    /**
+     * 格式化 Analyze 摘要
+     */
+    private formatAnalyzeSummary;
+    /**
+     * 格式化 Snapshot 摘要
+     */
+    private formatSnapshotSummary;
+    /**
+     * 格式化 FindReferences 摘要
+     */
+    private formatFindReferencesSummary;
+    /**
+     * 按檔案分組引用
+     */
+    private groupReferencesByFile;
+    /**
+     * 取得引用類型圖示
+     */
+    private getReferenceTypeIcon;
+    /**
+     * 格式化 CallHierarchy 摘要
+     */
+    private formatCallHierarchySummary;
+    /**
+     * 按檔案分組呼叫項目
+     */
+    private groupCallsByFile;
+    /**
+     * 格式化預設摘要（fallback）
+     */
+    private formatDefaultSummary;
+    /**
+     * 套用顏色（如果啟用）
+     */
+    private colorize;
+}
+/**
+ * 建立 QueryFormatter 的工廠函數
+ */
+export declare function createQueryFormatter(options?: Partial<QueryFormatterOptions>): QueryFormatter;
+//# sourceMappingURL=query-formatter.d.ts.map

package/dist/infrastructure/formatters/query-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-formatter.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/formatters/query-formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGL,KAAK,WAAW,EAYjB,MAAM,kBAAkB,CAAC;AAqB1B,wBAAwB;AACxB,MAAM,WAAW,qBAAqB;IACpC,eAAe;IACf,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,WAAW;AACX,oBAAY,WAAW;IACrB,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;gBAEpB,OAAO,GAAE,OAAO,CAAC,qBAAqB,CAAM;IAIxD;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,GAAG,MAAM;IAO9D;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM;IAInC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM;IAmBtC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyB3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkCzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA0B5B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA2B7B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAyCnC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAU7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA0DlC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAsB5B;;OAEG;IACH,OAAO,CAAC,QAAQ;CAIjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,OAAO,CAAC,qBAAqB,CAAM,GAAG,cAAc,CAKjG"}