agent-ide 0.2.0 → 0.4.0

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

@@ -0,0 +1,349 @@
+/**
+ * 唯讀命令格式化器
+ * 提供 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);
+            case QueryCommand.FindReferences:
+                return this.formatFindReferencesSummary(result);
+            case QueryCommand.CallHierarchy:
+                return this.formatCallHierarchySummary(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.impact) {
+            lines.push('');
+            lines.push(`📊 影響分析: ${result.impact.targetFile}`);
+            lines.push(`   依賴此檔案: ${result.impact.dependents.length} 個`);
+            lines.push(`   被此檔案依賴: ${result.impact.dependencies.length} 個`);
+            if (result.impact.dependents.length > 0) {
+                lines.push('   依賴者:');
+                result.impact.dependents.slice(0, 5).forEach(dep => {
+                    lines.push(`     - ${dep}`);
+                });
+                if (result.impact.dependents.length > 5) {
+                    lines.push(`     ... 還有 ${result.impact.dependents.length - 5} 個`);
+                }
+            }
+        }
+        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');
+    }
+    /**
+     * 格式化 FindReferences 摘要
+     */
+    formatFindReferencesSummary(result) {
+        const lines = [];
+        // 標題
+        lines.push(`🔍 符號: ${result.symbol} (${result.type})`);
+        // 定義位置
+        if (result.definition) {
+            const defLoc = `${result.definition.file}:${result.definition.line}:${result.definition.column}`;
+            lines.push(`📍 定義: ${this.colorize(defLoc, Colors.cyan)}`);
+        }
+        else {
+            lines.push(this.colorize('⚠️  找不到定義位置', Colors.yellow));
+        }
+        // 統計
+        const filesAffected = new Set(result.references.map(r => r.file)).size;
+        lines.push('');
+        lines.push(`📊 找到 ${result.references.length} 個引用（${filesAffected} 個檔案）`);
+        // 引用列表（按檔案分組）
+        if (result.references.length > 0) {
+            lines.push('');
+            lines.push('引用列表:');
+            const byFile = this.groupReferencesByFile(result.references);
+            for (const [file, refs] of byFile) {
+                lines.push(`  ${this.colorize(file, Colors.cyan)}`);
+                refs.slice(0, 10).forEach(ref => {
+                    const typeIcon = this.getReferenceTypeIcon(ref.type);
+                    lines.push(`    ${typeIcon} L${ref.line}: ${ref.context.trim()}`);
+                });
+                if (refs.length > 10) {
+                    lines.push(`    ... 還有 ${refs.length - 10} 個引用`);
+                }
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * 按檔案分組引用
+     */
+    groupReferencesByFile(references) {
+        const byFile = new Map();
+        references.forEach(ref => {
+            const list = byFile.get(ref.file) || [];
+            list.push(ref);
+            byFile.set(ref.file, list);
+        });
+        return byFile;
+    }
+    /**
+     * 取得引用類型圖示
+     */
+    getReferenceTypeIcon(type) {
+        switch (type) {
+            case 'definition': return '📌';
+            case 'import': return '📥';
+            case 'export': return '📤';
+            case 'usage':
+            default: return '📞';
+        }
+    }
+    /**
+     * 格式化 CallHierarchy 摘要
+     */
+    formatCallHierarchySummary(result) {
+        const lines = [];
+        // 標題與定義位置
+        lines.push(`📞 函數呼叫層次: ${result.function}`);
+        const defLoc = result.definitionLine
+            ? `${result.file}:${result.definitionLine}`
+            : result.file;
+        lines.push(`📍 定義位置: ${this.colorize(defLoc, Colors.cyan)}`);
+        lines.push(`🔍 分析方向: ${result.direction}, 深度: ${result.depth}`);
+        lines.push('');
+        // Incoming（誰呼叫我）
+        if (result.direction === 'incoming' || result.direction === 'both') {
+            lines.push(`📥 呼叫者 (Incoming): ${result.incoming.length} 個`);
+            if (result.incoming.length > 0) {
+                const grouped = this.groupCallsByFile(result.incoming, 'caller');
+                for (const [file, items] of grouped) {
+                    lines.push(`  ${this.colorize(file, Colors.cyan)}`);
+                    items.slice(0, 10).forEach(item => {
+                        lines.push(`    ⬅️  ${item.caller} (L${item.line})`);
+                    });
+                    if (items.length > 10) {
+                        lines.push(`    ... 還有 ${items.length - 10} 個呼叫者`);
+                    }
+                }
+            }
+            lines.push('');
+        }
+        // Outgoing（我呼叫誰）
+        if (result.direction === 'outgoing' || result.direction === 'both') {
+            lines.push(`📤 被呼叫者 (Outgoing): ${result.outgoing.length} 個`);
+            if (result.outgoing.length > 0) {
+                const grouped = this.groupCallsByFile(result.outgoing, 'callee');
+                for (const [file, items] of grouped) {
+                    lines.push(`  ${this.colorize(file, Colors.cyan)}`);
+                    items.slice(0, 10).forEach(item => {
+                        lines.push(`    ➡️  ${item.callee} (L${item.line})`);
+                    });
+                    if (items.length > 10) {
+                        lines.push(`    ... 還有 ${items.length - 10} 個被呼叫者`);
+                    }
+                }
+            }
+            lines.push('');
+        }
+        // 統計
+        const uniqueFiles = new Set([
+            ...result.incoming.map(i => i.file),
+            ...result.outgoing.map(o => o.file)
+        ]).size;
+        lines.push(`📊 統計: ${result.incoming.length} incoming, ${result.outgoing.length} outgoing, ${uniqueFiles} 個檔案`);
+        return lines.join('\n');
+    }
+    /**
+     * 按檔案分組呼叫項目
+     */
+    groupCallsByFile(items, _nameKey) {
+        const byFile = new Map();
+        items.forEach(item => {
+            const list = byFile.get(item.file) || [];
+            list.push(item);
+            byFile.set(item.file, list);
+        });
+        return byFile;
+    }
+    /**
+     * 格式化預設摘要（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,238 @@
+/**
+ * 唯讀命令結果型別定義
+ * 所有唯讀命令（search, analyze, deps）共用此結構
+ */
+/** 唯讀命令類型 */
+export declare enum QueryCommand {
+    Search = "search",
+    Analyze = "analyze",
+    Deps = "deps",
+    Snapshot = "snapshot",
+    FindReferences = "find-references",
+    CallHierarchy = "call-hierarchy"
+}
+/** 問題嚴重度 */
+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 ImpactInfo {
+    /** 目標檔案 */
+    targetFile: string;
+    /** 依賴此檔案的檔案 */
+    dependents: string[];
+    /** 此檔案依賴的檔案 */
+    dependencies: string[];
+    /** 總影響數 */
+    totalAffected: number;
+}
+/** Deps 結果 */
+export interface DepsResult extends QueryResult {
+    command: QueryCommand.Deps;
+    /** 循環依賴 */
+    cycles: CycleInfo[];
+    /** 影響分析 */
+    impact?: ImpactInfo;
+}
+/** Analyze 分析類型 */
+export declare enum AnalyzeType {
+    Complexity = "complexity",
+    DeadCode = "dead-code"
+}
+/** 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;
+}
+/** 引用類型 */
+export type ReferenceType = 'definition' | 'usage' | 'import' | 'export';
+/** 引用項目 */
+export interface ReferenceItem {
+    /** 檔案路徑 */
+    file: string;
+    /** 行號 */
+    line: number;
+    /** 欄位 */
+    column?: number;
+    /** 引用類型 */
+    type: ReferenceType;
+    /** 上下文程式碼片段 */
+    context: string;
+}
+/** 符號定義位置 */
+export interface DefinitionLocation {
+    /** 檔案路徑 */
+    file: string;
+    /** 行號 */
+    line: number;
+    /** 欄位 */
+    column: number;
+}
+/** FindReferences 結果 */
+export interface FindReferencesResult extends QueryResult {
+    command: QueryCommand.FindReferences;
+    /** 符號名稱 */
+    symbol: string;
+    /** 符號類型 */
+    type: string;
+    /** 定義位置（找不到時為 null） */
+    definition: DefinitionLocation | null;
+    /** 所有引用 */
+    references: ReferenceItem[];
+}
+/** 呼叫層次分析方向 */
+export type CallHierarchyDirection = 'incoming' | 'outgoing' | 'both';
+/** 呼叫者項目（誰呼叫了目標函數） */
+export interface IncomingCallItem {
+    /** 呼叫者函數名稱 */
+    caller: string;
+    /** 呼叫點所在檔案 */
+    file: string;
+    /** 呼叫點行號 */
+    line: number;
+    /** 呼叫點欄位 */
+    column?: number;
+    /** 程式碼上下文 */
+    context?: string;
+}
+/** 被呼叫者項目（目標函數呼叫了誰） */
+export interface OutgoingCallItem {
+    /** 被呼叫的函數名稱 */
+    callee: string;
+    /** 被呼叫函數所在檔案 */
+    file: string;
+    /** 呼叫點行號 */
+    line: number;
+    /** 呼叫點欄位 */
+    column?: number;
+    /** 程式碼上下文 */
+    context?: string;
+}
+/** CallHierarchy 結果 */
+export interface CallHierarchyResult extends QueryResult {
+    command: QueryCommand.CallHierarchy;
+    /** 目標函數名稱 */
+    function: string;
+    /** 目標函數定義所在檔案 */
+    file: string;
+    /** 目標函數定義行號 */
+    definitionLine?: number;
+    /** 分析方向 */
+    direction: CallHierarchyDirection;
+    /** 分析深度 */
+    depth: number;
+    /** 呼叫者列表（誰呼叫了此函數） */
+    incoming: IncomingCallItem[];
+    /** 被呼叫者列表（此函數呼叫了誰） */
+    outgoing: OutgoingCallItem[];
+}
+//# sourceMappingURL=query-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-types.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/formatters/query-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,aAAa;AACb,oBAAY,YAAY;IACtB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,cAAc,oBAAoB;IAClC,aAAa,mBAAmB;CACjC;AAED,YAAY;AACZ,oBAAY,aAAa;IACvB,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,GAAG,QAAQ;CACZ;AAED,aAAa;AACb,MAAM,WAAW,UAAU;IACzB,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU;IACV,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS;IACT,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,aAAa;AACb,MAAM,WAAW,YAAY;IAC3B,aAAa;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW;IACX,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW;IACX,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW;IACX,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,aAAa;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW;IACX,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAID,aAAa;AACb,MAAM,WAAW,WAAW;IAC1B,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS;IACT,IAAI,EAAE,MAAM,CAAC;IACb,SAAS;IACT,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU;IACV,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,gBAAgB;AAChB,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC;IAC7B,WAAW;IACX,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,YAAY;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,aAAa;AACb,MAAM,WAAW,SAAS;IACxB,WAAW;IACX,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,aAAa;AACb,MAAM,WAAW,UAAU;IACzB,WAAW;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW;IACX,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,cAAc;AACd,MAAM,WAAW,UAAW,SAAQ,WAAW;IAC7C,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC;IAC3B,WAAW;IACX,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,WAAW;IACX,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,mBAAmB;AACnB,oBAAY,WAAW;IACrB,UAAU,eAAe;IACzB,QAAQ,cAAc;CACvB;AAED,iBAAiB;AACjB,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC;IAC9B,WAAW;IACX,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW;IACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAID,aAAa;AACb,MAAM,WAAW,kBAAkB;IACjC,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5C,WAAW;IACX,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,WAAW;IACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,WAAW;IACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChE;AAED,aAAa;AACb,MAAM,WAAW,mBAAmB;IAClC,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CAC7C;AAED,kBAAkB;AAClB,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC;IAC/B,WAAW;IACX,YAAY,EAAE,QAAQ,GAAG,SAAS,CAAC;IACnC,WAAW;IACX,QAAQ,EAAE,kBAAkB,GAAG,mBAAmB,CAAC;CACpD;AAID,WAAW;AACX,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzE,WAAW;AACX,MAAM,WAAW,aAAa;IAC5B,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS;IACT,IAAI,EAAE,MAAM,CAAC;IACb,SAAS;IACT,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,IAAI,EAAE,aAAa,CAAC;IACpB,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,aAAa;AACb,MAAM,WAAW,kBAAkB;IACjC,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS;IACT,IAAI,EAAE,MAAM,CAAC;IACb,SAAS;IACT,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAwB;AACxB,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD,OAAO,EAAE,YAAY,CAAC,cAAc,CAAC;IACrC,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,UAAU,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACtC,WAAW;IACX,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B;AAID,eAAe;AACf,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;AAEtE,sBAAsB;AACtB,MAAM,WAAW,gBAAgB;IAC/B,cAAc;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,uBAAuB;AACvB,MAAM,WAAW,gBAAgB;IAC/B,eAAe;IACf,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,uBAAuB;AACvB,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD,OAAO,EAAE,YAAY,CAAC,aAAa,CAAC;IACpC,aAAa;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW;IACX,SAAS,EAAE,sBAAsB,CAAC;IAClC,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,sBAAsB;IACtB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B"}

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

@@ -0,0 +1,29 @@
+/**
+ * 唯讀命令結果型別定義
+ * 所有唯讀命令（search, analyze, deps）共用此結構
+ */
+/** 唯讀命令類型 */
+export var QueryCommand;
+(function (QueryCommand) {
+    QueryCommand["Search"] = "search";
+    QueryCommand["Analyze"] = "analyze";
+    QueryCommand["Deps"] = "deps";
+    QueryCommand["Snapshot"] = "snapshot";
+    QueryCommand["FindReferences"] = "find-references";
+    QueryCommand["CallHierarchy"] = "call-hierarchy";
+})(QueryCommand || (QueryCommand = {}));
+/** 問題嚴重度 */
+export var IssueSeverity;
+(function (IssueSeverity) {
+    IssueSeverity["Critical"] = "critical";
+    IssueSeverity["High"] = "high";
+    IssueSeverity["Medium"] = "medium";
+    IssueSeverity["Low"] = "low";
+})(IssueSeverity || (IssueSeverity = {}));
+/** Analyze 分析類型 */
+export var AnalyzeType;
+(function (AnalyzeType) {
+    AnalyzeType["Complexity"] = "complexity";
+    AnalyzeType["DeadCode"] = "dead-code";
+})(AnalyzeType || (AnalyzeType = {}));
+//# sourceMappingURL=query-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-types.js","sourceRoot":"","sources":["../../../src/infrastructure/formatters/query-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,aAAa;AACb,MAAM,CAAN,IAAY,YAOX;AAPD,WAAY,YAAY;IACtB,iCAAiB,CAAA;IACjB,mCAAmB,CAAA;IACnB,6BAAa,CAAA;IACb,qCAAqB,CAAA;IACrB,kDAAkC,CAAA;IAClC,gDAAgC,CAAA;AAClC,CAAC,EAPW,YAAY,KAAZ,YAAY,QAOvB;AAED,YAAY;AACZ,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,sCAAqB,CAAA;IACrB,8BAAa,CAAA;IACb,kCAAiB,CAAA;IACjB,4BAAW,CAAA;AACb,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB;AAuGD,mBAAmB;AACnB,MAAM,CAAN,IAAY,WAGX;AAHD,WAAY,WAAW;IACrB,wCAAyB,CAAA;IACzB,qCAAsB,CAAA;AACxB,CAAC,EAHW,WAAW,KAAX,WAAW,QAGtB"}