agent-ide 0.2.0 → 0.3.3

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":"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"}

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

@@ -0,0 +1,63 @@
+/**
+ * 唯讀命令格式化器
+ * 提供 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;
+    /**
+     * 格式化預設摘要（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,EAOjB,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;IAetC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyB3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoCzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA0B5B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA2B7B;;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"}

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

@@ -0,0 +1,218 @@
+/**
+ * 唯讀命令格式化器
+ * 提供 json 和 summary 兩種輸出格式
+ */
+import { QueryCommand, IssueSeverity } from './query-types.js';
+/** ANSI 顏色碼 */
+const Colors = {
+    reset: '\x1b[0m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    cyan: '\x1b[36m',
+    dim: '\x1b[2m',
+    bold: '\x1b[1m'
+};
+/** 嚴重度對應的顏色和 emoji */
+const SeverityStyle = {
+    [IssueSeverity.Critical]: { color: Colors.red, emoji: '🔴' },
+    [IssueSeverity.High]: { color: Colors.red, emoji: '🟠' },
+    [IssueSeverity.Medium]: { color: Colors.yellow, emoji: '🟡' },
+    [IssueSeverity.Low]: { color: Colors.green, emoji: '🟢' }
+};
+/** 輸出格式 */
+export var QueryFormat;
+(function (QueryFormat) {
+    QueryFormat["Json"] = "json";
+    QueryFormat["Summary"] = "summary";
+})(QueryFormat || (QueryFormat = {}));
+/**
+ * 唯讀命令格式化器
+ */
+export class QueryFormatter {
+    color;
+    constructor(options = {}) {
+        this.color = options.color ?? false;
+    }
+    /**
+     * 格式化結果
+     */
+    format(result, outputFormat) {
+        if (outputFormat === QueryFormat.Json) {
+            return this.toJson(result);
+        }
+        return this.toSummary(result);
+    }
+    /**
+     * 轉換為 JSON 格式
+     */
+    toJson(result) {
+        return JSON.stringify(result, null, 2);
+    }
+    /**
+     * 轉換為 summary 格式
+     */
+    toSummary(result) {
+        switch (result.command) {
+            case QueryCommand.Search:
+                return this.formatSearchSummary(result);
+            case QueryCommand.Deps:
+                return this.formatDepsSummary(result);
+            case QueryCommand.Analyze:
+                return this.formatAnalyzeSummary(result);
+            case QueryCommand.Snapshot:
+                return this.formatSnapshotSummary(result);
+            default:
+                return this.formatDefaultSummary(result);
+        }
+    }
+    /**
+     * 格式化 Search 摘要
+     */
+    formatSearchSummary(result) {
+        const lines = [];
+        lines.push(`找到 ${result.results.length} 個結果`);
+        if (result.searchTime) {
+            lines.push(`搜尋耗時: ${result.searchTime}ms`);
+        }
+        if (result.truncated) {
+            lines.push(this.colorize('(結果已截斷)', Colors.yellow));
+        }
+        lines.push('');
+        // 列出結果
+        result.results.forEach(match => {
+            const location = match.column
+                ? `${match.filePath}:${match.line}:${match.column}`
+                : `${match.filePath}:${match.line}`;
+            lines.push(this.colorize(location, Colors.cyan));
+            lines.push(`  ${match.content}`);
+        });
+        return lines.join('\n');
+    }
+    /**
+     * 格式化 Deps 摘要
+     */
+    formatDepsSummary(result) {
+        const lines = [];
+        // 循環依賴
+        if (result.cycles && result.cycles.length > 0) {
+            lines.push(this.colorize(`發現 ${result.cycles.length} 個循環依賴`, Colors.red));
+            lines.push('');
+            result.cycles.forEach((cycle, index) => {
+                lines.push(`${index + 1}. ${cycle.cycle.join(' → ')} → ${cycle.cycle[0]}`);
+            });
+        }
+        else {
+            lines.push(this.colorize('未發現循環依賴', Colors.green));
+        }
+        // 孤立檔案
+        if (result.orphans && result.orphans.length > 0) {
+            lines.push('');
+            lines.push(`孤立檔案: ${result.orphans.length} 個`);
+            result.orphans.slice(0, 10).forEach(orphan => {
+                lines.push(`  - ${orphan}`);
+            });
+            if (result.orphans.length > 10) {
+                lines.push(`  ... 還有 ${result.orphans.length - 10} 個`);
+            }
+        }
+        // 依賴圖統計
+        if (result.graph) {
+            lines.push('');
+            lines.push(`節點數: ${result.graph.nodes.length}`);
+            lines.push(`邊數: ${result.graph.edges.length}`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * 格式化 Analyze 摘要
+     */
+    formatAnalyzeSummary(result) {
+        const lines = [];
+        lines.push(`分析類型: ${result.analyzeType}`);
+        lines.push(`成功: ${result.success ? '是' : '否'}`);
+        if (result.issues && result.issues.length > 0) {
+            lines.push(`發現 ${result.issues.length} 個問題`);
+            lines.push('');
+            result.issues.slice(0, 10).forEach(issue => {
+                const severity = issue.severity
+                    ? SeverityStyle[issue.severity].emoji
+                    : '•';
+                lines.push(`${severity} ${issue.message}`);
+                if (issue.filePath) {
+                    lines.push(`  ${this.colorize(issue.filePath, Colors.dim)}${issue.line ? `:${issue.line}` : ''}`);
+                }
+            });
+            if (result.issues.length > 10) {
+                lines.push(`... 還有 ${result.issues.length - 10} 個問題`);
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * 格式化 Snapshot 摘要
+     */
+    formatSnapshotSummary(result) {
+        const lines = [];
+        if (result.snapshotType === 'project') {
+            const snapshot = result.snapshot;
+            lines.push(`📦 專案: ${snapshot.project}`);
+            lines.push(`📁 模組數: ${Object.keys(snapshot.modules).length}`);
+            for (const [modulePath, moduleSnapshot] of Object.entries(snapshot.modules)) {
+                lines.push('');
+                lines.push(`  📂 ${modulePath}`);
+                lines.push(`     API: ${Object.keys(moduleSnapshot.api).length} classes`);
+                lines.push(`     Factories: ${Object.keys(moduleSnapshot.factories).length}`);
+                lines.push(`     Types: ${Object.keys(moduleSnapshot.types).length}`);
+            }
+        }
+        else {
+            const snapshot = result.snapshot;
+            lines.push(`📦 模組: ${snapshot.module}`);
+            lines.push(`📊 API: ${Object.keys(snapshot.api).length} classes`);
+            lines.push(`🏭 Factories: ${Object.keys(snapshot.factories).length}`);
+            lines.push(`📝 Types: ${Object.keys(snapshot.types).length}`);
+            lines.push(`🔒 Private: ${Object.keys(snapshot.private).length} classes`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * 格式化預設摘要（fallback）
+     */
+    formatDefaultSummary(result) {
+        const lines = [];
+        lines.push(`命令: ${result.command}`);
+        lines.push(`成功: ${result.success ? '是' : '否'}`);
+        if (result.summary) {
+            lines.push('');
+            lines.push('摘要:');
+            Object.entries(result.summary).forEach(([key, value]) => {
+                lines.push(`  ${key}: ${value}`);
+            });
+        }
+        if (result.issues && result.issues.length > 0) {
+            lines.push('');
+            lines.push(`問題數: ${result.issues.length}`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * 套用顏色（如果啟用）
+     */
+    colorize(text, color) {
+        if (!this.color) {
+            return text;
+        }
+        return `${color}${text}${Colors.reset}`;
+    }
+}
+/**
+ * 建立 QueryFormatter 的工廠函數
+ */
+export function createQueryFormatter(options = {}) {
+    const finalOptions = {
+        color: options.color ?? (process.stdout.isTTY ?? false)
+    };
+    return new QueryFormatter(finalOptions);
+}
+//# sourceMappingURL=query-formatter.js.map

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

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

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

@@ -0,0 +1,165 @@
+/**
+ * 唯讀命令結果型別定義
+ * 所有唯讀命令（search, analyze, deps）共用此結構
+ */
+/** 唯讀命令類型 */
+export declare enum QueryCommand {
+    Search = "search",
+    Analyze = "analyze",
+    Deps = "deps",
+    Snapshot = "snapshot"
+}
+/** 問題嚴重度 */
+export declare enum IssueSeverity {
+    Critical = "critical",
+    High = "high",
+    Medium = "medium",
+    Low = "low"
+}
+/** 通用問題項目 */
+export interface QueryIssue {
+    /** 問題類型 */
+    type: string;
+    /** 嚴重度 */
+    severity?: IssueSeverity;
+    /** 問題訊息 */
+    message: string;
+    /** 檔案路徑 */
+    filePath?: string;
+    /** 行號 */
+    line?: number;
+    /** 分數 */
+    score?: number;
+}
+/** 通用統計摘要 */
+export interface QuerySummary {
+    /** 掃描項目總數 */
+    totalScanned?: number;
+    /** 發現問題數 */
+    issuesFound?: number;
+    /** 額外統計欄位 */
+    [key: string]: unknown;
+}
+/**
+ * 唯讀命令結果基底介面
+ * 所有唯讀命令的結果都應擴展此介面
+ */
+export interface QueryResult {
+    /** 命令類型 */
+    command: QueryCommand;
+    /** 是否成功 */
+    success: boolean;
+    /** 統計摘要 */
+    summary: QuerySummary;
+    /** 問題列表 */
+    issues?: QueryIssue[];
+    /** 命令特定資料 */
+    data?: unknown;
+    /** 錯誤訊息 */
+    errors?: string[];
+}
+/** 搜尋結果項目 */
+export interface SearchMatch {
+    /** 檔案路徑 */
+    filePath: string;
+    /** 行號 */
+    line: number;
+    /** 欄位 */
+    column?: number;
+    /** 匹配內容 */
+    content: string;
+    /** 上下文 */
+    context?: string[];
+}
+/** Search 結果 */
+export interface SearchResult extends QueryResult {
+    command: QueryCommand.Search;
+    /** 搜尋結果 */
+    results: SearchMatch[];
+    /** 是否被截斷 */
+    truncated?: boolean;
+    /** 搜尋耗時（毫秒） */
+    searchTime?: number;
+}
+/** 循環依賴資訊 */
+export interface CycleInfo {
+    /** 循環路徑 */
+    cycle: string[];
+    /** 涉及檔案數 */
+    length: number;
+}
+/** 依賴圖節點 */
+export interface GraphNode {
+    /** 節點 ID（檔案路徑） */
+    id: string;
+    /** 節點標籤 */
+    label?: string;
+}
+/** 依賴圖邊 */
+export interface GraphEdge {
+    /** 來源節點 */
+    from: string;
+    /** 目標節點 */
+    to: string;
+}
+/** Deps 結果 */
+export interface DepsResult extends QueryResult {
+    command: QueryCommand.Deps;
+    /** 循環依賴 */
+    cycles?: CycleInfo[];
+    /** 依賴圖 */
+    graph?: {
+        nodes: GraphNode[];
+        edges: GraphEdge[];
+    };
+    /** 孤立檔案 */
+    orphans?: string[];
+}
+/** Analyze 分析類型 */
+export declare enum AnalyzeType {
+    Complexity = "complexity",
+    DeadCode = "dead-code",
+    BestPractices = "best-practices",
+    Patterns = "patterns",
+    Quality = "quality"
+}
+/** Analyze 結果 */
+export interface AnalyzeResult extends QueryResult {
+    command: QueryCommand.Analyze;
+    /** 分析類型 */
+    analyzeType: AnalyzeType;
+    /** 分析指標 */
+    metrics?: Record<string, unknown>;
+}
+/** 模組快照資料 */
+export interface ModuleSnapshotData {
+    /** 模組名稱 */
+    module: string;
+    /** API（class 的 public 方法） */
+    api: Record<string, Record<string, string>>;
+    /** 工廠函數 */
+    factories: Record<string, string>;
+    /** 型別定義 */
+    types: Record<string, string>;
+    /** 私有資訊 */
+    private: Record<string, {
+        fields: string[];
+        imports: string;
+    }>;
+}
+/** 專案快照資料 */
+export interface ProjectSnapshotData {
+    /** 專案名稱 */
+    project: string;
+    /** 模組快照 */
+    modules: Record<string, ModuleSnapshotData>;
+}
+/** Snapshot 結果 */
+export interface SnapshotResult extends QueryResult {
+    command: QueryCommand.Snapshot;
+    /** 快照類型 */
+    snapshotType: 'module' | 'project';
+    /** 快照資料 */
+    snapshot: ModuleSnapshotData | ProjectSnapshotData;
+}
+//# sourceMappingURL=query-types.d.ts.map