specmem-hardwicksoftware 3.5.99

package/dist/trace/tools/findSimilarBugs.d.ts

@@ -0,0 +1,112 @@
+/**
+ * findSimilarBugs.ts - MCP Tool for Bug Pattern Matching
+ *
+ * yo this tool is the BUG HISTORIAN fr fr
+ * shows you similar issues that happened before
+ * and how they were fixed
+ *
+ * why solve the same bug twice when you can learn from history
+ */
+import { MCPTool } from '../../mcp/toolRegistry.js';
+/**
+ * Input parameters for find_similar_bugs tool
+ */
+interface FindSimilarBugsInput {
+    errorMessage?: string;
+    errorType?: string;
+    keywords?: string[];
+    filePath?: string;
+    limit?: number;
+    recordBug?: boolean;
+    resolution?: string;
+}
+/**
+ * Output from find_similar_bugs tool
+ */
+interface FindSimilarBugsOutput {
+    success: boolean;
+    similarBugs: Array<{
+        errorType: string;
+        errorSignature: string;
+        occurrenceCount: number;
+        commonFiles: string[];
+        commonKeywords: string[];
+        resolutionStats: {
+            totalResolved: number;
+            avgResolutionTimeMs: number;
+            commonSolutions: string[];
+        };
+        lastOccurrence: string;
+    }>;
+    suggestedSolutions: string[];
+    commonRootCauseFiles: string[];
+    message: string;
+}
+/**
+ * FindSimilarBugs MCP Tool
+ *
+ * Searches for similar bug patterns in history
+ * Shows how similar issues were resolved before
+ *
+ * Use this when:
+ * - You encounter a recurring bug
+ * - You want to see if this issue happened before
+ * - You need resolution strategies for similar problems
+ */
+export declare class FindSimilarBugs implements MCPTool<FindSimilarBugsInput, FindSimilarBugsOutput> {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            errorMessage: {
+                type: string;
+                description: string;
+            };
+            errorType: {
+                type: string;
+                description: string;
+            };
+            keywords: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            filePath: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            recordBug: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            resolution: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    execute(params: FindSimilarBugsInput): Promise<FindSimilarBugsOutput>;
+    /**
+     * Record a new bug pattern
+     */
+    private recordBugPattern;
+    /**
+     * Search bugs by associated file
+     */
+    private searchBugsByFile;
+    /**
+     * Deduplicate bugs by error signature
+     */
+    private deduplicateBugs;
+}
+export default FindSimilarBugs;
+//# sourceMappingURL=findSimilarBugs.d.ts.map

package/dist/trace/tools/findSimilarBugs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findSimilarBugs.d.ts","sourceRoot":"","sources":["../../../src/trace/tools/findSimilarBugs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAIpD;;GAEG;AACH,UAAU,oBAAoB;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,UAAU,qBAAqB;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,KAAK,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,eAAe,EAAE;YACf,aAAa,EAAE,MAAM,CAAC;YACtB,mBAAmB,EAAE,MAAM,CAAC;YAC5B,eAAe,EAAE,MAAM,EAAE,CAAC;SAC3B,CAAC;QACF,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;IACH,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,eAAgB,YAAW,OAAO,CAAC,oBAAoB,EAAE,qBAAqB,CAAC;IAC1F,IAAI,SAAuB;IAE3B,WAAW,SAYY;IAEvB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAmCT;IAEI,OAAO,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA4H3E;;OAEG;YACW,gBAAgB;IA0B9B;;OAEG;YACW,gBAAgB;IAM9B;;OAEG;IACH,OAAO,CAAC,eAAe;CAaxB;AAED,eAAe,eAAe,CAAC"}

package/dist/trace/tools/findSimilarBugs.js

@@ -0,0 +1,216 @@
+/**
+ * findSimilarBugs.ts - MCP Tool for Bug Pattern Matching
+ *
+ * yo this tool is the BUG HISTORIAN fr fr
+ * shows you similar issues that happened before
+ * and how they were fixed
+ *
+ * why solve the same bug twice when you can learn from history
+ */
+import { getTraceExploreSystem } from '../traceExploreSystem.js';
+import { logger } from '../../utils/logger.js';
+/**
+ * FindSimilarBugs MCP Tool
+ *
+ * Searches for similar bug patterns in history
+ * Shows how similar issues were resolved before
+ *
+ * Use this when:
+ * - You encounter a recurring bug
+ * - You want to see if this issue happened before
+ * - You need resolution strategies for similar problems
+ */
+export class FindSimilarBugs {
+    name = 'find_similar_bugs';
+    description = `Finds similar bugs from history and shows how they were resolved.
+
+Use this to learn from past issues and avoid re-solving the same problems.
+Search by:
+- Error message or type
+- Keywords related to the issue
+- File path where the bug occurred
+
+Returns:
+- Similar past bugs
+- How they were resolved
+- Common files involved
+- Resolution statistics`;
+    inputSchema = {
+        type: 'object',
+        properties: {
+            errorMessage: {
+                type: 'string',
+                description: 'The error message to search for'
+            },
+            errorType: {
+                type: 'string',
+                description: 'Error type to search for (e.g., TypeError, SyntaxError)'
+            },
+            keywords: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Keywords to search for in bug patterns'
+            },
+            filePath: {
+                type: 'string',
+                description: 'File path to find bugs associated with'
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of results (default: 10)',
+                default: 10
+            },
+            recordBug: {
+                type: 'boolean',
+                description: 'Set to true to record this as a new bug pattern',
+                default: false
+            },
+            resolution: {
+                type: 'string',
+                description: 'Resolution description (when recording a bug)'
+            }
+        }
+    };
+    async execute(params) {
+        const startTime = Date.now();
+        const limit = params.limit ?? 10;
+        try {
+            const traceSystem = getTraceExploreSystem();
+            await traceSystem.initialize();
+            // Build search query
+            const searchText = [
+                params.errorMessage,
+                params.errorType,
+                ...(params.keywords || []),
+                params.filePath
+            ].filter(Boolean).join(' ');
+            if (!searchText && !params.recordBug) {
+                return {
+                    success: false,
+                    similarBugs: [],
+                    suggestedSolutions: [],
+                    commonRootCauseFiles: [],
+                    message: 'Provide at least one of: errorMessage, errorType, keywords, or filePath'
+                };
+            }
+            // If recording a bug, handle that first
+            if (params.recordBug && params.errorMessage) {
+                await this.recordBugPattern(params.errorMessage, params.errorType, params.keywords || [], params.filePath ? [params.filePath] : [], params.resolution);
+                return {
+                    success: true,
+                    similarBugs: [],
+                    suggestedSolutions: [],
+                    commonRootCauseFiles: params.filePath ? [params.filePath] : [],
+                    message: `Bug pattern recorded. This will help identify similar issues in the future.`
+                };
+            }
+            // Search for similar bugs using trace system
+            const traceResult = await traceSystem.traceError(searchText || '', undefined);
+            const similarBugs = traceResult.similarBugs;
+            // Also search by file path if provided
+            let fileRelatedBugs = [];
+            if (params.filePath) {
+                fileRelatedBugs = await this.searchBugsByFile(params.filePath);
+            }
+            // Combine and deduplicate
+            const allBugs = this.deduplicateBugs([...similarBugs, ...fileRelatedBugs]);
+            const limitedBugs = allBugs.slice(0, limit);
+            // Extract suggested solutions
+            const suggestedSolutions = new Set();
+            const commonFiles = new Set();
+            for (const bug of limitedBugs) {
+                for (const solution of bug.resolutionStats.commonSolutions) {
+                    suggestedSolutions.add(solution);
+                }
+                for (const file of bug.commonFiles) {
+                    commonFiles.add(file);
+                }
+            }
+            // Also get solutions from traces
+            for (const solution of traceResult.previousSolutions) {
+                suggestedSolutions.add(solution.description);
+                for (const file of solution.filesModified) {
+                    commonFiles.add(file);
+                }
+            }
+            const duration = Date.now() - startTime;
+            logger.info({
+                searchText: searchText?.slice(0, 50),
+                bugsFound: limitedBugs.length,
+                solutionsFound: suggestedSolutions.size,
+                duration
+            }, 'find_similar_bugs completed');
+            return {
+                success: true,
+                similarBugs: limitedBugs.map(bug => ({
+                    errorType: bug.errorType,
+                    errorSignature: bug.errorSignature,
+                    occurrenceCount: bug.occurrenceCount,
+                    commonFiles: bug.commonFiles,
+                    commonKeywords: bug.commonKeywords,
+                    resolutionStats: {
+                        totalResolved: bug.resolutionStats.totalResolved,
+                        avgResolutionTimeMs: bug.resolutionStats.avgResolutionTimeMs,
+                        commonSolutions: bug.resolutionStats.commonSolutions
+                    },
+                    lastOccurrence: bug.lastOccurrenceAt?.toISOString() || 'unknown'
+                })),
+                suggestedSolutions: Array.from(suggestedSolutions).slice(0, 10),
+                commonRootCauseFiles: Array.from(commonFiles).slice(0, 20),
+                message: limitedBugs.length > 0
+                    ? `Found ${limitedBugs.length} similar bugs. Check suggested solutions and common files.`
+                    : 'No similar bugs found. This might be a new type of issue.'
+            };
+        }
+        catch (error) {
+            logger.error({ error }, 'find_similar_bugs failed');
+            return {
+                success: false,
+                similarBugs: [],
+                suggestedSolutions: [],
+                commonRootCauseFiles: [],
+                message: `Search failed: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    /**
+     * Record a new bug pattern
+     */
+    async recordBugPattern(errorMessage, errorType, keywords = [], files = [], resolution) {
+        const traceSystem = getTraceExploreSystem();
+        // Record as trace with solution
+        await traceSystem.recordTrace(errorMessage, undefined, files, resolution ? {
+            id: crypto.randomUUID(),
+            description: resolution,
+            codeChange: '',
+            filesModified: files,
+            successRate: 1.0,
+            appliedCount: 1,
+            createdAt: new Date()
+        } : undefined);
+    }
+    /**
+     * Search bugs by associated file
+     */
+    async searchBugsByFile(filePath) {
+        // This would query the database for bugs associated with the file
+        // For now, return empty - actual implementation would query bug_patterns table
+        return [];
+    }
+    /**
+     * Deduplicate bugs by error signature
+     */
+    deduplicateBugs(bugs) {
+        const seen = new Set();
+        const unique = [];
+        for (const bug of bugs) {
+            if (!seen.has(bug.errorSignature)) {
+                seen.add(bug.errorSignature);
+                unique.push(bug);
+            }
+        }
+        return unique;
+    }
+}
+export default FindSimilarBugs;
+//# sourceMappingURL=findSimilarBugs.js.map

package/dist/trace/tools/findSimilarBugs.js.map

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

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

@@ -0,0 +1,22 @@
+/**
+ * Trace/Explore Tools Index
+ *
+ * Exports all the trace and explore MCP tools
+ * These tools reduce 's search overhead by 80%+
+ */
+export { TraceError, default as TraceErrorTool } from './traceError.js';
+export { ExploreDependencies, default as ExploreDependenciesTool } from './exploreDependencies.js';
+export { FindSimilarBugs, default as FindSimilarBugsTool } from './findSimilarBugs.js';
+export { AnalyzeImpact, default as AnalyzeImpactTool } from './analyzeImpact.js';
+export { SmartExplore, default as SmartExploreTool } from './smartExplore.js';
+import { MCPTool } from '../../mcp/toolRegistry.js';
+/**
+ * Create all trace/explore tools
+ */
+export declare function createTraceExploreTools(): MCPTool[];
+/**
+ * Tool names for reference
+ */
+export declare const TRACE_EXPLORE_TOOL_NAMES: readonly ["trace_error", "explore_dependencies", "find_similar_bugs", "analyze_impact", "smart_explore"];
+export type TraceExploreToolName = typeof TRACE_EXPLORE_TOOL_NAMES[number];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/trace/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnG,OAAO,EAAE,eAAe,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAO9E,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEpD;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,EAAE,CAQnD;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,0GAM3B,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAC"}

package/dist/trace/tools/index.js

@@ -0,0 +1,39 @@
+/**
+ * Trace/Explore Tools Index
+ *
+ * Exports all the trace and explore MCP tools
+ * These tools reduce 's search overhead by 80%+
+ */
+export { TraceError, default as TraceErrorTool } from './traceError.js';
+export { ExploreDependencies, default as ExploreDependenciesTool } from './exploreDependencies.js';
+export { FindSimilarBugs, default as FindSimilarBugsTool } from './findSimilarBugs.js';
+export { AnalyzeImpact, default as AnalyzeImpactTool } from './analyzeImpact.js';
+export { SmartExplore, default as SmartExploreTool } from './smartExplore.js';
+import { TraceError } from './traceError.js';
+import { ExploreDependencies } from './exploreDependencies.js';
+import { FindSimilarBugs } from './findSimilarBugs.js';
+import { AnalyzeImpact } from './analyzeImpact.js';
+import { SmartExplore } from './smartExplore.js';
+/**
+ * Create all trace/explore tools
+ */
+export function createTraceExploreTools() {
+    return [
+        new TraceError(),
+        new ExploreDependencies(),
+        new FindSimilarBugs(),
+        new AnalyzeImpact(),
+        new SmartExplore()
+    ];
+}
+/**
+ * Tool names for reference
+ */
+export const TRACE_EXPLORE_TOOL_NAMES = [
+    'trace_error',
+    'explore_dependencies',
+    'find_similar_bugs',
+    'analyze_impact',
+    'smart_explore'
+];
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/trace/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnG,OAAO,EAAE,eAAe,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE9E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,IAAI,UAAU,EAAE;QAChB,IAAI,mBAAmB,EAAE;QACzB,IAAI,eAAe,EAAE;QACrB,IAAI,aAAa,EAAE;QACnB,IAAI,YAAY,EAAE;KACnB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,aAAa;IACb,sBAAsB;IACtB,mBAAmB;IACnB,gBAAgB;IAChB,eAAe;CACP,CAAC"}

package/dist/trace/tools/smartExplore.d.ts

@@ -0,0 +1,126 @@
+/**
+ * smartExplore.ts - MCP Tool for Intelligent Code Exploration
+ *
+ * yo this is the ULTIMATE SEARCH fr fr
+ * combines all the smart stuff:
+ * - cached search patterns
+ * - past successful searches
+ * - code access patterns
+ * - error-to-solution mappings
+ *
+ * reduces 's need for full codebase searches by 80%+
+ */
+import { MCPTool } from '../../mcp/toolRegistry.js';
+/**
+ * Input parameters for smart_explore tool
+ */
+interface SmartExploreInput {
+    query: string;
+    context?: 'error' | 'feature' | 'refactor' | 'debug' | 'general';
+    fileTypes?: string[];
+    modules?: string[];
+    limit?: number;
+    useCache?: boolean;
+}
+/**
+ * Output from smart_explore tool
+ */
+interface SmartExploreOutput {
+    success: boolean;
+    query: string;
+    relevantFiles: string[];
+    cacheHit: boolean;
+    searchReductionPercent: number;
+    suggestions: Array<{
+        file: string;
+        reason: string;
+        confidence: number;
+    }>;
+    relatedSearches: string[];
+    metrics: {
+        totalFilesSearched: number;
+        cacheHitRate: number;
+        avgSearchReduction: number;
+    };
+    message: string;
+}
+/**
+ * SmartExplore MCP Tool
+ *
+ * The intelligent search that learns from past searches
+ * Much smarter than grep - uses:
+ * - Cached search patterns
+ * - Error-to-file mappings
+ * - Code access patterns
+ * - Semantic similarity
+ *
+ * Use this as your FIRST search tool - it often finds what you need
+ * without scanning the entire codebase
+ */
+export declare class SmartExplore implements MCPTool<SmartExploreInput, SmartExploreOutput> {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            context: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            fileTypes: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            modules: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            useCache: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+        };
+        required: string[];
+    };
+    execute(params: SmartExploreInput): Promise<SmartExploreOutput>;
+    /**
+     * Search using context-specific strategies
+     */
+    private searchByContext;
+    /**
+     * Search for feature-related files
+     */
+    private searchFeatureFiles;
+    /**
+     * Search for refactoring candidates
+     */
+    private searchRefactorCandidates;
+    /**
+     * Find related searches from history
+     */
+    private findRelatedSearches;
+    /**
+     * Build summary message
+     */
+    private buildMessage;
+}
+export default SmartExplore;
+//# sourceMappingURL=smartExplore.d.ts.map

package/dist/trace/tools/smartExplore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smartExplore.d.ts","sourceRoot":"","sources":["../../../src/trace/tools/smartExplore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAIpD;;GAEG;AACH,UAAU,iBAAiB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;IACjE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,UAAU,kBAAkB;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,WAAW,EAAE,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE;QACP,kBAAkB,EAAE,MAAM,CAAC;QAC3B,YAAY,EAAE,MAAM,CAAC;QACrB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAa,YAAW,OAAO,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;IACjF,IAAI,SAAmB;IAEvB,WAAW,SAeoB;IAE/B,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAmCT;IAEI,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqGrE;;OAEG;YACW,eAAe;IAkG7B;;OAEG;YACW,kBAAkB;IA8BhC;;OAEG;YACW,wBAAwB;IAStC;;OAEG;YACW,mBAAmB;IAMjC;;OAEG;IACH,OAAO,CAAC,YAAY;CAWrB;AAED,eAAe,YAAY,CAAC"}