midas-mcp 3.2.0 → 3.4.0

package/dist/monitoring.js

@@ -0,0 +1,258 @@
+/**
+ * Production Monitoring Integration
+ *
+ * Provides hooks for:
+ * - Error tracking (Sentry)
+ * - Observability (OpenTelemetry)
+ * - Custom metrics
+ *
+ * These are optional integrations - if the libraries aren't installed,
+ * the hooks gracefully degrade to no-ops.
+ */
+import { logger } from './logger.js';
+// ============================================================================
+// SENTRY INTEGRATION
+// ============================================================================
+let sentryClient = null;
+let sentryInitialized = false;
+/**
+ * Initialize Sentry if SENTRY_DSN is set
+ *
+ * Sentry cost estimate (free tier):
+ * - 5,000 errors/month free
+ * - 10,000 performance samples/month free
+ * - Beyond free: ~$0.000029 per error
+ *
+ * MAX MONTHLY COST: ~$15 at 500k errors (extreme case)
+ * Expected: $0 (well under free tier for dev tools)
+ */
+export function initSentry() {
+    if (sentryInitialized)
+        return !!sentryClient;
+    sentryInitialized = true;
+    const dsn = process.env.SENTRY_DSN;
+    if (!dsn) {
+        logger.debug('Sentry not configured (no SENTRY_DSN)');
+        return false;
+    }
+    try {
+        // Dynamic import to avoid requiring Sentry as a dependency
+        // Users can install @sentry/node if they want this feature
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        import('@sentry/node').then((Sentry) => {
+            const S = Sentry;
+            S.init({
+                dsn,
+                environment: process.env.NODE_ENV || 'development',
+                release: process.env.npm_package_version,
+                tracesSampleRate: 0.1,
+                enabled: process.env.NODE_ENV === 'production' || process.env.SENTRY_ENABLED === 'true',
+                maxBreadcrumbs: 50,
+            });
+            sentryClient = Sentry;
+            logger.info('Sentry initialized');
+        }).catch(() => {
+            logger.debug('Sentry package not installed');
+        });
+        return true;
+    }
+    catch {
+        logger.debug('Sentry initialization failed');
+        return false;
+    }
+}
+/**
+ * Capture an error with context
+ */
+export function captureError(error, context) {
+    logger.error('Error captured', { error: error.message, ...context });
+    if (!sentryClient)
+        return;
+    try {
+        const S = sentryClient;
+        S.withScope((scope) => {
+            if (context?.phase)
+                scope.setTag('phase', context.phase);
+            if (context?.step)
+                scope.setTag('step', context.step);
+            if (context?.tool)
+                scope.setTag('tool', context.tool);
+            if (context?.projectPath)
+                scope.setContext('project', { path: context.projectPath });
+            if (context?.extra)
+                scope.setExtras(context.extra);
+            S.captureException(error);
+        });
+    }
+    catch {
+        // Silently fail - monitoring should never break the app
+    }
+}
+/**
+ * Add a breadcrumb for debugging context
+ */
+export function addBreadcrumb(message, category, data) {
+    if (!sentryClient)
+        return;
+    try {
+        const S = sentryClient;
+        S.addBreadcrumb({
+            message,
+            category,
+            data,
+            level: 'info',
+        });
+    }
+    catch {
+        // Silently fail
+    }
+}
+// ============================================================================
+// OPENTELEMETRY INTEGRATION
+// ============================================================================
+let otelMeter = null;
+let otelInitialized = false;
+// Metric counters (created lazily)
+let analysisCounter = null;
+let tokenCounter = null;
+let latencyHistogram = null;
+/**
+ * Initialize OpenTelemetry metrics if OTEL_EXPORTER_OTLP_ENDPOINT is set
+ *
+ * OpenTelemetry is free (self-hosted) or pay-per-use with vendors:
+ * - Datadog: ~$0.10 per million custom metrics
+ * - Grafana Cloud: 10k series free, then ~$8/1k series
+ * - Self-hosted: Infrastructure costs only
+ *
+ * MAX MONTHLY COST: ~$10 at typical usage
+ */
+export function initOpenTelemetry() {
+    if (otelInitialized)
+        return !!otelMeter;
+    otelInitialized = true;
+    const endpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
+    if (!endpoint) {
+        logger.debug('OpenTelemetry not configured (no OTEL_EXPORTER_OTLP_ENDPOINT)');
+        return false;
+    }
+    try {
+        // Dynamic import to avoid requiring OTel as a dependency
+        import('@opentelemetry/api').then((api) => {
+            const otelApi = api;
+            otelMeter = otelApi.metrics.getMeter('midas-mcp');
+            // Create counters
+            const meter = otelMeter;
+            analysisCounter = meter.createCounter('midas.analysis.count', {
+                description: 'Number of project analyses',
+            });
+            tokenCounter = meter.createCounter('midas.tokens.total', {
+                description: 'Total tokens consumed',
+            });
+            latencyHistogram = meter.createHistogram('midas.analysis.latency', {
+                description: 'Analysis latency in milliseconds',
+                unit: 'ms',
+            });
+            logger.info('OpenTelemetry metrics initialized');
+        }).catch(() => {
+            logger.debug('OpenTelemetry package not installed');
+        });
+        return true;
+    }
+    catch {
+        logger.debug('OpenTelemetry initialization failed');
+        return false;
+    }
+}
+/**
+ * Record an analysis event
+ */
+export function recordAnalysis(latencyMs, tags) {
+    if (!otelMeter || !analysisCounter || !latencyHistogram)
+        return;
+    try {
+        const counter = analysisCounter;
+        const histogram = latencyHistogram;
+        const attributes = {
+            provider: tags?.provider || 'unknown',
+            phase: tags?.phase || 'unknown',
+            cached: String(tags?.cached ?? false),
+        };
+        counter.add(1, attributes);
+        histogram.record(latencyMs, attributes);
+    }
+    catch {
+        // Silently fail
+    }
+}
+/**
+ * Record token usage
+ */
+export function recordTokens(inputTokens, outputTokens, tags) {
+    if (!otelMeter || !tokenCounter)
+        return;
+    try {
+        const counter = tokenCounter;
+        const attributes = {
+            provider: tags?.provider || 'unknown',
+            type: 'input',
+        };
+        counter.add(inputTokens, attributes);
+        counter.add(outputTokens, { ...attributes, type: 'output' });
+    }
+    catch {
+        // Silently fail
+    }
+}
+// ============================================================================
+// UNIFIED MONITORING INTERFACE
+// ============================================================================
+/**
+ * Initialize all monitoring integrations
+ * Call this once at startup
+ */
+export function initMonitoring() {
+    const sentry = initSentry();
+    const otel = initOpenTelemetry();
+    if (sentry || otel) {
+        logger.info('Monitoring initialized', { sentry, otel });
+    }
+    return { sentry, otel };
+}
+/**
+ * Wrap an async function with error tracking
+ */
+export function withErrorTracking(fn, context) {
+    return fn().catch((error) => {
+        captureError(error, context);
+        throw error;
+    });
+}
+/**
+ * Create a timed operation for metrics
+ */
+export function startTimer() {
+    const start = Date.now();
+    return {
+        end(tags) {
+            const latency = Date.now() - start;
+            recordAnalysis(latency, tags);
+            return latency;
+        },
+    };
+}
+/**
+ * Health check for monitoring systems
+ */
+export function getMonitoringHealth() {
+    return {
+        sentry: {
+            initialized: sentryInitialized,
+            configured: !!sentryClient,
+        },
+        otel: {
+            initialized: otelInitialized,
+            configured: !!otelMeter,
+        },
+    };
+}
+//# sourceMappingURL=monitoring.js.map

package/dist/monitoring.js.map

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

package/dist/prompts/grow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grow.d.ts","sourceRoot":"","sources":["../../src/prompts/grow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2J3D"}
+{"version":3,"file":"grow.d.ts","sourceRoot":"","sources":["../../src/prompts/grow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyR3D"}

package/dist/prompts/grow.js

@@ -1,7 +1,34 @@
 import { z } from 'zod';
 export function registerGrowPrompts(server) {
-    // User feedback analysis
-    server.prompt('analyze_feedback', 'Analyze user feedback to identify patterns and priorities', { feedback: z.string().describe('User feedback to analyze (paste reviews, comments, tickets)') }, (args) => ({
+    // MONITOR step - Production health tracking
+    server.prompt('production_health', 'Review production health metrics and error rates', { errorLogs: z.string().optional().describe('Paste recent error logs or metrics') }, (args) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Analyze production health:
+
+${args.errorLogs ? `Recent data:\n${args.errorLogs}\n\n---` : ''}
+
+Check:
+1. **Error rates** - What's breaking? Frequency? Patterns?
+2. **Latency** - p50, p95, p99 response times
+3. **Uptime** - Any outages? Duration?
+4. **Resources** - CPU, memory, disk usage trends
+
+For each issue:
+- Severity (critical/high/medium/low)
+- Affected users/requests
+- Recommended action
+
+Output a health report with priorities.`,
+                },
+            },
+        ],
+    }));
+    // COLLECT step - Gather feedback
+    server.prompt('collect_feedback', 'Analyze user feedback to identify patterns', { feedback: z.string().describe('User feedback to analyze (paste reviews, comments, tickets)') }, (args) => ({
         messages: [
             {
                 role: 'user',
@@ -13,90 +40,171 @@ ${args.feedback}
 
 ---
 
-1. **Categorize** each piece of feedback:
+1. **Categorize** each piece:
    - Bug report
    - Feature request
-   - UX issue
+   - UX friction
    - Performance complaint
    - Praise
 
-2. **Identify patterns** - What themes appear multiple times?
+2. **Identify patterns** - Themes appearing multiple times
 
-3. **Prioritize** using impact vs effort matrix:
-   - Quick wins (low effort, high impact)
-   - Major projects (high effort, high impact)
-   - Nice to haves (low effort, low impact)
-   - Avoid (high effort, low impact)
+3. **Extract quotes** - Most impactful user statements
 
-4. **Recommend** top 3 actions for next iteration.`,
+4. **Sentiment** - Overall positive/negative/neutral breakdown
+
+Output a feedback summary with key insights.`,
                 },
             },
         ],
     }));
-    // Metrics review
-    server.prompt('metrics_review', 'Review product metrics to identify opportunities', { metrics: z.string().optional().describe('Key metrics data if available') }, (args) => ({
+    // TRIAGE step - Prioritize issues
+    server.prompt('triage_bugs', 'Prioritize bugs and issues by impact and effort', { issues: z.string().describe('List of bugs/issues to triage') }, (args) => ({
         messages: [
             {
                 role: 'user',
                 content: {
                     type: 'text',
-                    text: `Review product metrics and health:
+                    text: `Triage these issues:
 
-${args.metrics ? `Data:\n${args.metrics}\n\n---` : ''}
+${args.issues}
 
-Analyze (or help me set up tracking for):
+---
 
-1. **Acquisition** - How users find us
-2. **Activation** - First value moment
-3. **Retention** - Users coming back
-4. **Revenue** - Monetization health
-5. **Referral** - Viral coefficient
+For each issue, determine:
+1. **Impact** (1-5): Users affected, severity, revenue impact
+2. **Effort** (1-5): Complexity, risk, dependencies
+3. **Urgency**: Is it getting worse?
 
-For each stage:
-- What's the current state?
-- What's the bottleneck?
-- What's one experiment to try?
+Then categorize:
+- **P0 Critical**: Fix immediately (blocking users, security, data loss)
+- **P1 High**: Fix this sprint (major functionality broken)
+- **P2 Medium**: Schedule soon (degraded experience)
+- **P3 Low**: Backlog (minor annoyance)
 
-Provide specific, actionable recommendations.`,
+Output a prioritized list with recommended order.`,
                 },
             },
         ],
     }));
-    // Iteration planning
-    server.prompt('plan_iteration', 'Plan the next development iteration based on learnings', {}, () => ({
+    // RETROSPECT step - Review the cycle
+    server.prompt('sprint_retro', 'Conduct a sprint/cycle retrospective', {
+        accomplishments: z.string().optional().describe('What was shipped'),
+        issues: z.string().optional().describe('Problems encountered'),
+    }, (args) => ({
         messages: [
             {
                 role: 'user',
                 content: {
                     type: 'text',
-                    text: `Plan the next iteration:
+                    text: `Sprint retrospective:
+
+${args.accomplishments ? `Shipped:\n${args.accomplishments}\n` : ''}
+${args.issues ? `Issues:\n${args.issues}\n` : ''}
+---
+
+Guide me through:
+
+1. **What worked well?**
+   - Processes that helped
+   - Tools that saved time
+   - Team dynamics that clicked
+
+2. **What didn't work?**
+   - Blockers we hit
+   - Time wasted on
+   - Communication gaps
+
+3. **What surprised us?**
+   - Unexpected wins
+   - Hidden complexity
+   - User behavior we didn't expect
+
+4. **Action items**
+   - One thing to START doing
+   - One thing to STOP doing
+   - One thing to CONTINUE doing
+
+Output concrete action items for next cycle.`,
+                },
+            },
+        ],
+    }));
+    // PLAN_NEXT step - Scope next iteration
+    server.prompt('plan_next_cycle', 'Plan the next development cycle with clear scope', { learnings: z.string().optional().describe('Key learnings from retro') }, (args) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Plan next cycle:
+
+${args.learnings ? `Learnings:\n${args.learnings}\n\n---` : ''}
+
+Define:
+
+1. **Hypothesis**
+   - What are we testing?
+   - What do we believe will happen?
+   - How will we validate?
+
+2. **Scope**
+   - Single most important thing to build
+   - Explicit non-goals (what we WON'T do)
+   - Minimum viable version
+
+3. **Success metrics**
+   - How do we measure success?
+   - Target numbers
+   - Timeline
+
+4. **Risks**
+   - What could go wrong?
+   - Mitigation strategies
+   - Kill criteria (when to pivot)
+
+Output a one-page cycle plan.`,
+                },
+            },
+        ],
+    }));
+    // LOOP step - Return to PLAN with context
+    server.prompt('cycle_handoff', 'Prepare context for next PLAN phase', {}, () => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Prepare for next PLAN phase:
+
+Create handoff document:
 
-1. **Retrospective**
-   - What worked well last iteration?
-   - What didn't work?
-   - What did we learn?
+1. **Context summary**
+   - What was built this cycle
+   - Current state of the product
+   - Active users/usage metrics
 
-2. **Scope Definition**
-   - What's the single most important thing to build next?
-   - What's explicitly OUT of scope?
-   - What's the hypothesis we're testing?
+2. **Lessons learned**
+   - Technical decisions that worked/didn't
+   - Process improvements needed
+   - Knowledge to preserve
 
-3. **Success Criteria**
-   - How will we know this succeeded?
-   - What metrics will we track?
-   - What's the minimum viable version?
+3. **Carry forward**
+   - Unresolved bugs (prioritized)
+   - Feature requests (prioritized)
+   - Technical debt to address
 
-4. **Return to Plan Phase**
-   - Update brainlift with new learnings
-   - Revise PRD for next feature
-   - Create new gameplan
+4. **Brainlift updates**
+   - New edge knowledge gained
+   - Updated constraints
+   - Revised assumptions
 
-Output a clear plan I can execute.`,
+Output a handoff doc ready to inform the next PLAN phase.`,
                 },
             },
         ],
     }));
-    // Performance optimization
+    // Performance optimization (keep existing)
     server.prompt('optimize_performance', 'Identify and fix performance bottlenecks', { area: z.string().optional().describe('Specific area to optimize (frontend/backend/db)') }, (args) => ({
         messages: [
             {

package/dist/prompts/grow.js.map

@@ -1 +1 @@
-{"version":3,"file":"grow.js","sourceRoot":"","sources":["../../src/prompts/grow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,yBAAyB;IACzB,MAAM,CAAC,MAAM,CACX,kBAAkB,EAClB,2DAA2D,EAC3D,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC,EAAE,EAChG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACT,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;EAEhB,IAAI,CAAC,QAAQ;;;;;;;;;;;;;;;;;;;mDAmBoC;iBACxC;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,iBAAiB;IACjB,MAAM,CAAC,MAAM,CACX,gBAAgB,EAChB,kDAAkD,EAClD,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC,EAAE,EAC5E,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACT,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;EAEhB,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;8CAeP;iBACnC;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,qBAAqB;IACrB,MAAM,CAAC,MAAM,CACX,gBAAgB,EAChB,wDAAwD,EACxD,EAAE,EACF,GAAG,EAAE,CAAC,CAAC;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;mCAsBiB;iBACxB;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,2BAA2B;IAC3B,MAAM,CAAC,MAAM,CACX,sBAAsB,EACtB,0CAA0C,EAC1C,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC,EAAE,EAC3F,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACT,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,uBAAuB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;yDAuBnB;iBAC9C;aACF;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"grow.js","sourceRoot":"","sources":["../../src/prompts/grow.ts"],"names":[],"mappings":"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"}

package/dist/providers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAwC,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAGpF,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,UAAU,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAkCD;;GAEG;AACH,wBAAsB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CA4B3F;AA0PD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAEjE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAGxC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,UAAU,GAAG;IAC7D,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,CAaA"}
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAwC,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAKpF,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,UAAU,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAkCD;;GAEG;AACH,wBAAsB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CA4B3F;AAyTD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAEjE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAGxC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,UAAU,GAAG;IAC7D,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,CAaA"}