@su-record/vibe 2.5.11 → 2.5.13

package/dist/tools/analytics/getUsageAnalytics.js

@@ -0,0 +1,246 @@
+// v2.0 - Get usage analytics and telemetry
+import { MemoryManager } from '../../lib/MemoryManager.js';
+export const getUsageAnalyticsDefinition = {
+    name: 'get_usage_analytics',
+    description: `도구 사용 분석 및 통계를 조회합니다.
+
+키워드: 분석, 통계, 사용량, analytics, statistics, usage
+
+**제공 정보:**
+- 메모리 사용 통계
+- 카테고리별 분포
+- 시간별 사용 패턴
+- 그래프 관계 통계
+
+사용 예시:
+- "사용 통계 보여줘"
+- "메모리 분석"`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            type: {
+                type: 'string',
+                description: '분석 유형',
+                enum: ['memory', 'graph', 'all']
+            },
+            timeRange: {
+                type: 'string',
+                description: '시간 범위',
+                enum: ['1d', '7d', '30d', 'all']
+            },
+            detailed: {
+                type: 'boolean',
+                description: '상세 정보 포함 여부 (기본값: false)'
+            }
+        }
+    },
+    annotations: {
+        title: 'Get Usage Analytics',
+        audience: ['user', 'assistant'],
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false
+    }
+};
+export async function getUsageAnalytics(args) {
+    try {
+        const { type = 'all', timeRange = 'all', detailed = false } = args;
+        const memoryManager = MemoryManager.getInstance();
+        let output = '## Hi-AI 사용 분석\n\n';
+        // Memory statistics
+        if (type === 'memory' || type === 'all') {
+            output += await generateMemoryStats(memoryManager, timeRange, detailed);
+        }
+        // Graph statistics
+        if (type === 'graph' || type === 'all') {
+            output += await generateGraphStats(memoryManager, detailed);
+        }
+        // System info
+        output += `---\n### 시스템 정보\n\n`;
+        output += `- **Hi-AI 버전**: 2.0.0\n`;
+        output += `- **분석 시간**: ${new Date().toLocaleString('ko-KR')}\n`;
+        output += `- **시간 범위**: ${getTimeRangeLabel(timeRange)}\n`;
+        return {
+            content: [{
+                    type: 'text',
+                    text: output
+                }]
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `✗ 분석 오류: ${error instanceof Error ? error.message : '알 수 없는 오류'}`
+                }]
+        };
+    }
+}
+async function generateMemoryStats(memoryManager, timeRange, detailed) {
+    const stats = memoryManager.getStats();
+    const allMemories = memoryManager.list();
+    let output = '### 메모리 통계\n\n';
+    output += `- **총 메모리 수**: ${stats.total}개\n`;
+    output += `- **카테고리 수**: ${Object.keys(stats.byCategory).length}개\n\n`;
+    // Category distribution
+    output += `#### 카테고리별 분포\n\n`;
+    const sortedCategories = Object.entries(stats.byCategory)
+        .sort((a, b) => b[1] - a[1]);
+    for (const [category, count] of sortedCategories) {
+        const percentage = ((count / stats.total) * 100).toFixed(1);
+        const bar = '█'.repeat(Math.round(count / stats.total * 20));
+        output += `- **${category}**: ${count}개 (${percentage}%) ${bar}\n`;
+    }
+    output += '\n';
+    // Time analysis
+    if (allMemories.length > 0) {
+        output += `#### 시간 분석\n\n`;
+        const now = new Date();
+        const filterDate = getFilterDate(timeRange);
+        const recentMemories = filterDate
+            ? allMemories.filter(m => new Date(m.timestamp) >= filterDate)
+            : allMemories;
+        // Group by day
+        const byDay = {};
+        for (const memory of recentMemories) {
+            const day = memory.timestamp.substring(0, 10);
+            byDay[day] = (byDay[day] || 0) + 1;
+        }
+        const sortedDays = Object.entries(byDay)
+            .sort((a, b) => b[0].localeCompare(a[0]))
+            .slice(0, 7);
+        if (sortedDays.length > 0) {
+            output += `**최근 일별 활동**:\n`;
+            for (const [day, count] of sortedDays) {
+                const bar = '▓'.repeat(Math.min(count, 20));
+                output += `- ${day}: ${count}개 ${bar}\n`;
+            }
+            output += '\n';
+        }
+        // Priority distribution
+        const priorityCounts = {};
+        for (const memory of allMemories) {
+            const priority = memory.priority || 0;
+            priorityCounts[priority] = (priorityCounts[priority] || 0) + 1;
+        }
+        if (Object.keys(priorityCounts).length > 1) {
+            output += `**우선순위 분포**:\n`;
+            for (const [priority, count] of Object.entries(priorityCounts).sort((a, b) => Number(b[0]) - Number(a[0]))) {
+                output += `- 우선순위 ${priority}: ${count}개\n`;
+            }
+            output += '\n';
+        }
+    }
+    // Detailed info
+    if (detailed && allMemories.length > 0) {
+        output += `#### 상세 정보\n\n`;
+        // Most recently accessed
+        const byAccess = [...allMemories]
+            .sort((a, b) => new Date(b.lastAccessed).getTime() - new Date(a.lastAccessed).getTime())
+            .slice(0, 5);
+        output += `**최근 접근한 메모리**:\n`;
+        for (const memory of byAccess) {
+            output += `- \`${memory.key}\` (${formatDate(memory.lastAccessed)})\n`;
+        }
+        output += '\n';
+        // Oldest memories
+        const oldest = [...allMemories]
+            .sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime())
+            .slice(0, 5);
+        output += `**가장 오래된 메모리**:\n`;
+        for (const memory of oldest) {
+            output += `- \`${memory.key}\` (${formatDate(memory.timestamp)})\n`;
+        }
+        output += '\n';
+    }
+    return output;
+}
+async function generateGraphStats(memoryManager, detailed) {
+    const graph = memoryManager.getMemoryGraph();
+    let output = '### 지식 그래프 통계\n\n';
+    output += `- **노드 수**: ${graph.nodes.length}개\n`;
+    output += `- **관계 수**: ${graph.edges.length}개\n`;
+    output += `- **클러스터 수**: ${graph.clusters.length}개\n\n`;
+    if (graph.edges.length > 0) {
+        // Relation type distribution
+        const relationTypes = {};
+        for (const edge of graph.edges) {
+            relationTypes[edge.relationType] = (relationTypes[edge.relationType] || 0) + 1;
+        }
+        output += `#### 관계 유형 분포\n\n`;
+        for (const [type, count] of Object.entries(relationTypes).sort((a, b) => b[1] - a[1])) {
+            output += `- **${type}**: ${count}개\n`;
+        }
+        output += '\n';
+        // Average connections per node
+        const avgConnections = (graph.edges.length * 2 / graph.nodes.length).toFixed(2);
+        output += `- **평균 연결 수**: ${avgConnections}개/노드\n`;
+        // Most connected nodes
+        const connectionCount = {};
+        for (const edge of graph.edges) {
+            connectionCount[edge.sourceKey] = (connectionCount[edge.sourceKey] || 0) + 1;
+            connectionCount[edge.targetKey] = (connectionCount[edge.targetKey] || 0) + 1;
+        }
+        const topConnected = Object.entries(connectionCount)
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 5);
+        if (topConnected.length > 0) {
+            output += `\n**가장 많이 연결된 노드**:\n`;
+            for (const [key, count] of topConnected) {
+                output += `- \`${key}\`: ${count}개 연결\n`;
+            }
+            output += '\n';
+        }
+    }
+    // Cluster info
+    if (graph.clusters.length > 0 && detailed) {
+        output += `#### 클러스터 상세\n\n`;
+        for (let i = 0; i < Math.min(graph.clusters.length, 5); i++) {
+            const cluster = graph.clusters[i];
+            output += `**클러스터 ${i + 1}** (${cluster.length}개 노드):\n`;
+            output += `- ${cluster.slice(0, 5).join(', ')}`;
+            if (cluster.length > 5) {
+                output += ` ... 외 ${cluster.length - 5}개`;
+            }
+            output += '\n';
+        }
+        output += '\n';
+    }
+    return output;
+}
+function getFilterDate(timeRange) {
+    const now = new Date();
+    switch (timeRange) {
+        case '1d':
+            return new Date(now.getTime() - 24 * 60 * 60 * 1000);
+        case '7d':
+            return new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);
+        case '30d':
+            return new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);
+        default:
+            return null;
+    }
+}
+function getTimeRangeLabel(timeRange) {
+    switch (timeRange) {
+        case '1d':
+            return '최근 24시간';
+        case '7d':
+            return '최근 7일';
+        case '30d':
+            return '최근 30일';
+        default:
+            return '전체';
+    }
+}
+function formatDate(dateString) {
+    try {
+        const date = new Date(dateString);
+        return date.toLocaleDateString('ko-KR');
+    }
+    catch { /* ignore: optional operation */
+        return dateString;
+    }
+}
+//# sourceMappingURL=getUsageAnalytics.js.map

package/dist/tools/analytics/getUsageAnalytics.js.map

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

package/dist/tools/analytics/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Analytics Tools - 사용 분석
+ */
+export { getUsageAnalytics } from './getUsageAnalytics.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/analytics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/analytics/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/tools/analytics/index.js

@@ -0,0 +1,5 @@
+/**
+ * Analytics Tools - 사용 분석
+ */
+export { getUsageAnalytics } from './getUsageAnalytics.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/analytics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/analytics/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/tools/convention/analyzeComplexity.test.js

@@ -4,10 +4,10 @@ import { analyzeComplexity } from './analyzeComplexity.js';
 describe('analyzeComplexity', () => {
     describe('code analysis', () => {
         it('should analyze simple code', async () => {
-            const code = `
-function add(a, b) {
-  return a + b;
-}
+            const code = `
+function add(a, b) {
+  return a + b;
+}
 `;
             const result = await analyzeComplexity({ code });
             expect(result.content).toBeDefined();
@@ -15,70 +15,70 @@ function add(a, b) {
             expect(result.content[0].text).toContain('Complexity');
         });
         it('should detect high cyclomatic complexity', async () => {
-            const code = `
-function complex(a, b, c, d) {
-  if (a > 0) {
-    if (b > 0) {
-      if (c > 0) {
-        if (d > 0) {
-          for (let i = 0; i < 10; i++) {
-            while (true) {
-              switch (i) {
-                case 1: break;
-                case 2: break;
-                case 3: break;
-              }
-              break;
-            }
-          }
-        }
-      }
-    }
-  }
-}
+            const code = `
+function complex(a, b, c, d) {
+  if (a > 0) {
+    if (b > 0) {
+      if (c > 0) {
+        if (d > 0) {
+          for (let i = 0; i < 10; i++) {
+            while (true) {
+              switch (i) {
+                case 1: break;
+                case 2: break;
+                case 3: break;
+              }
+              break;
+            }
+          }
+        }
+      }
+    }
+  }
+}
 `;
             const result = await analyzeComplexity({ code });
             expect(result.content[0].text).toContain('Complexity');
             // High complexity code should have lower score or issues
         });
         it('should calculate cyclomatic metrics only', async () => {
-            const code = `
-function test() {
-  if (true) return 1;
-  return 0;
-}
+            const code = `
+function test() {
+  if (true) return 1;
+  return 0;
+}
 `;
             const result = await analyzeComplexity({ code, metrics: 'cyclomatic' });
             expect(result.content[0].text).toContain('Complexity');
         });
         it('should calculate cognitive metrics only', async () => {
-            const code = `
-function test() {
-  if (true) {
-    for (let i = 0; i < 10; i++) {
-      console.log(i);
-    }
-  }
-}
+            const code = `
+function test() {
+  if (true) {
+    for (let i = 0; i < 10; i++) {
+      console.log(i);
+    }
+  }
+}
 `;
             const result = await analyzeComplexity({ code, metrics: 'cognitive' });
             expect(result.content[0].text).toContain('Complexity');
         });
         it('should calculate halstead metrics only', async () => {
-            const code = `
-const x = 1 + 2 * 3 - 4 / 5;
+            const code = `
+const x = 1 + 2 * 3 - 4 / 5;
 `;
             const result = await analyzeComplexity({ code, metrics: 'halstead' });
             expect(result.content[0].text).toContain('Complexity');
         });
         it('should calculate all metrics', async () => {
-            const code = `
-function calculate(a, b) {
-  if (a > b) {
-    return a - b;
-  }
-  return b - a;
-}
+            const code = `
+function calculate(a, b) {
+  if (a > b) {
+    return a - b;
+  }
+  return b - a;
+}
 `;
             const result = await analyzeComplexity({ code, metrics: 'all' });
             expect(result.content[0].text).toContain('Complexity');
@@ -102,18 +102,18 @@ function calculate(a, b) {
     });
     describe('Python code detection', () => {
         it('should detect and analyze Python code', async () => {
-            const pythonCode = `
-def calculate(a, b):
-    if a > b:
-        return a - b
-    return b - a
-
-class Calculator:
-    def __init__(self):
-        self.value = 0
-
-    def add(self, x):
-        self.value += x
+            const pythonCode = `
+def calculate(a, b):
+    if a > b:
+        return a - b
+    return b - a
+
+class Calculator:
+    def __init__(self):
+        self.value = 0
+
+    def add(self, x):
+        self.value += x
 `;
             const result = await analyzeComplexity({ code: pythonCode });
             expect(result.content[0].text).toContain('Python');
@@ -121,34 +121,34 @@ class Calculator:
     });
     describe('score calculation', () => {
         it('should give high score for simple code', async () => {
-            const simpleCode = `
-function simple() {
-  return 42;
-}
+            const simpleCode = `
+function simple() {
+  return 42;
+}
 `;
             const result = await analyzeComplexity({ code: simpleCode });
             // Simple code should have good score
             expect(result.content[0].text).toContain('Score');
         });
         it('should give lower score for complex code', async () => {
-            const complexCode = `
-function veryComplex(a, b, c, d, e, f, g, h) {
-  if (a && b || c && d || e && f || g && h) {
-    for (let i = 0; i < 10; i++) {
-      for (let j = 0; j < 10; j++) {
-        if (i > j) {
-          switch (i) {
-            case 1: break;
-            case 2: break;
-            case 3: break;
-            case 4: break;
-            case 5: break;
-          }
-        }
-      }
-    }
-  }
-}
+            const complexCode = `
+function veryComplex(a, b, c, d, e, f, g, h) {
+  if (a && b || c && d || e && f || g && h) {
+    for (let i = 0; i < 10; i++) {
+      for (let j = 0; j < 10; j++) {
+        if (i > j) {
+          switch (i) {
+            case 1: break;
+            case 2: break;
+            case 3: break;
+            case 4: break;
+            case 5: break;
+          }
+        }
+      }
+    }
+  }
+}
 `;
             const result = await analyzeComplexity({ code: complexCode });
             expect(result.content[0].text).toContain('Score');
@@ -157,46 +157,46 @@ function veryComplex(a, b, c, d, e, f, g, h) {
     });
     describe('TypeScript code analysis', () => {
         it('should analyze TypeScript code', async () => {
-            const tsCode = `
-interface User {
-  name: string;
-  age: number;
-}
-
-function greet(user: User): string {
-  if (user.age > 18) {
-    return \`Hello, \${user.name}!\`;
-  }
-  return 'Hello!';
-}
+            const tsCode = `
+interface User {
+  name: string;
+  age: number;
+}
+
+function greet(user: User): string {
+  if (user.age > 18) {
+    return \`Hello, \${user.name}!\`;
+  }
+  return 'Hello!';
+}
 `;
             const result = await analyzeComplexity({ code: tsCode });
             expect(result.content[0].text).toContain('Complexity');
         });
         it('should handle class definitions', async () => {
             // Use explicit TypeScript syntax that won't be mistaken for Python
-            const tsCode = `
-// TypeScript class
-export class Calculator {
-  private value: number = 0;
-
-  public add(x: number): this {
-    this.value += x;
-    return this;
-  }
-
-  public subtract(x: number): this {
-    if (x > this.value) {
-      throw new Error('Cannot be negative');
-    }
-    this.value -= x;
-    return this;
-  }
-
-  public getValue(): number {
-    return this.value;
-  }
-}
+            const tsCode = `
+// TypeScript class
+export class Calculator {
+  private value: number = 0;
+
+  public add(x: number): this {
+    this.value += x;
+    return this;
+  }
+
+  public subtract(x: number): this {
+    if (x > this.value) {
+      throw new Error('Cannot be negative');
+    }
+    this.value -= x;
+    return this;
+  }
+
+  public getValue(): number {
+    return this.value;
+  }
+}
 `;
             const result = await analyzeComplexity({ code: tsCode });
             // Should analyze as TypeScript, not Python

package/dist/tools/convention/getCodingGuide.d.ts

@@ -0,0 +1,7 @@
+import { ToolResult, ToolDefinition } from '../../types/tool.js';
+export declare const getCodingGuideDefinition: ToolDefinition;
+export declare function getCodingGuide(args: {
+    name: string;
+    category?: string;
+}): Promise<ToolResult>;
+//# sourceMappingURL=getCodingGuide.d.ts.map

package/dist/tools/convention/getCodingGuide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCodingGuide.d.ts","sourceRoot":"","sources":["../../../src/tools/convention/getCodingGuide.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAsCjE,eAAO,MAAM,wBAAwB,EAAE,cAmBtC,CAAC;AAEF,wBAAsB,cAAc,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAmBnG"}

package/dist/tools/convention/getCodingGuide.js

@@ -0,0 +1,69 @@
+// Convention management tool - completely independent
+import { promises as fs } from 'fs';
+import path from 'path';
+const GUIDES_DIR = path.join(process.cwd(), 'guides');
+const GUIDES_FILE = path.join(GUIDES_DIR, 'coding_guides.json');
+async function ensureGuidesDir() {
+    try {
+        await fs.access(GUIDES_DIR);
+    }
+    catch { /* ignore: optional operation */
+        await fs.mkdir(GUIDES_DIR, { recursive: true });
+    }
+}
+async function loadGuides() {
+    try {
+        await ensureGuidesDir();
+        const data = await fs.readFile(GUIDES_FILE, 'utf-8');
+        return JSON.parse(data);
+    }
+    catch { /* ignore: optional operation */
+        return [];
+    }
+}
+async function findGuide(name) {
+    const guides = await loadGuides();
+    return guides.find(g => g.name === name);
+}
+export const getCodingGuideDefinition = {
+    name: 'get_coding_guide',
+    description: '가이드|규칙|컨벤션|guide|rules|convention|standards|best practices - Get coding guide',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            name: { type: 'string', description: 'Guide name to retrieve' },
+            category: { type: 'string', description: 'Guide category' }
+        },
+        required: ['name']
+    },
+    annotations: {
+        title: 'Get Coding Guide',
+        audience: ['user', 'assistant'],
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false
+    }
+};
+export async function getCodingGuide(args) {
+    const { name: guideName, category: guideCategory } = args;
+    try {
+        const guide = await findGuide(guideName);
+        if (guide) {
+            return {
+                content: [{ type: 'text', text: `Guide: ${guide.name}\nCategory: ${guide.category}\n\n${guide.content}\n\nTags: ${guide.tags.join(', ')} | Updated: ${guide.lastUpdated}` }]
+            };
+        }
+        else {
+            return {
+                content: [{ type: 'text', text: `Guide not found: "${guideName}". Use list_coding_guides to see available guides.` }]
+            };
+        }
+    }
+    catch (error) {
+        return {
+            content: [{ type: 'text', text: `Error retrieving guide: ${error instanceof Error ? error.message : 'Unknown error'}` }]
+        };
+    }
+}
+//# sourceMappingURL=getCodingGuide.js.map

package/dist/tools/convention/getCodingGuide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCodingGuide.js","sourceRoot":"","sources":["../../../src/tools/convention/getCodingGuide.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAEtD,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AAaxB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;AACtD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;AAEhE,KAAK,UAAU,eAAe;IAC5B,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC,CAAC,gCAAgC;QACxC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU;IACvB,IAAI,CAAC;QACH,MAAM,eAAe,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC,CAAC,gCAAgC;QACxC,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAY;IACnC,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAClC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,MAAM,wBAAwB,GAAmB;IACtD,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,+EAA+E;IAC5F,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;YAC/D,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;SAC5D;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,WAAW,EAAE;QACX,KAAK,EAAE,kBAAkB;QACzB,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC;QAC/B,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACrB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAyC;IAC5E,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IAE1D,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,KAAK,EAAE,CAAC;YACV,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,CAAC,IAAI,eAAe,KAAK,CAAC,QAAQ,OAAO,KAAK,CAAC,OAAO,aAAa,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;aAC7K,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,SAAS,oDAAoD,EAAE,CAAC;aACtH,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,2BAA2B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,EAAE,CAAC;SACzH,CAAC;IACJ,CAAC;AACH,CAAC"}