@yasserkhanorg/e2e-agents 0.3.2

package/dist/agent/report-generator.js

@@ -0,0 +1,250 @@
+"use strict";
+/**
+ * Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+ * See LICENSE.txt for license information.
+ *
+ * Report Generation Engine
+ *
+ * Generates console, markdown, and JSON reports from impact analysis results.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateReports = generateReports;
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * Generate all requested report formats
+ */
+async function generateReports(analysis, options = {}) {
+    const { console: consoleReport = true, markdown = true, json = true, outputDir = './.e2e-ai-agents/reports', } = options;
+    if (consoleReport) {
+        printConsoleReport(analysis);
+    }
+    if (markdown || json) {
+        (0, fs_1.mkdirSync)(outputDir, { recursive: true });
+    }
+    if (markdown) {
+        const mdPath = (0, path_1.join)(outputDir, `impact-${Date.now()}.md`);
+        const markdownReport = generateMarkdownReport(analysis);
+        (0, fs_1.writeFileSync)(mdPath, markdownReport);
+        console.log(`\n📄 Markdown report: ${mdPath}`);
+    }
+    if (json) {
+        const jsonPath = (0, path_1.join)(outputDir, `impact-${Date.now()}.json`);
+        (0, fs_1.writeFileSync)(jsonPath, JSON.stringify(analysis, null, 2));
+        console.log(`📊 JSON report: ${jsonPath}`);
+    }
+}
+// =============================================================================
+// CONSOLE REPORT
+// =============================================================================
+function printConsoleReport(analysis) {
+    console.log('\n═══════════════════════════════════════════════════════════════════');
+    console.log('📊 CODE IMPACT ANALYSIS REPORT');
+    console.log('═══════════════════════════════════════════════════════════════════\n');
+    // Summary
+    console.log('📈 SUMMARY');
+    console.log(`   Changed files: ${analysis.totalChanges}`);
+    console.log(`   Affected flows: ${analysis.affectedFlows.length}`);
+    console.log(`   Priority breakdown: P0=${analysis.priorityBreakdown.p0}, P1=${analysis.priorityBreakdown.p1}, P2=${analysis.priorityBreakdown.p2}`);
+    console.log(`   Test coverage: ${analysis.testCoverage.covered}/${analysis.testCoverage.total} flows have tests (${analysis.testCoverage.gaps} gaps)\n`);
+    // P0 Flows (Critical)
+    const p0Flows = analysis.affectedFlows.filter((f) => f.flow.priority === 'P0');
+    if (p0Flows.length > 0) {
+        console.log('🔴 CRITICAL (P0) FLOWS AFFECTED:');
+        p0Flows.forEach((impact) => {
+            console.log(`   • ${impact.flow.name} (${impact.flow.id})`);
+            console.log(`     Confidence: ${impact.confidence}% | Match: ${impact.matchType}`);
+            console.log(`     Existing tests: ${impact.existingTests.length} ${impact.existingTests.length > 0 ? '✓' : '✗'}`);
+            if (impact.testGaps.length > 0) {
+                console.log(`     ⚠️  Test gaps: ${impact.testGaps.slice(0, 2).join(', ')}${impact.testGaps.length > 2 ? '...' : ''}`);
+            }
+            console.log(`     Affected files: ${impact.affectedFiles.length}`);
+        });
+        console.log('');
+    }
+    // P1 Flows (High Priority)
+    const p1Flows = analysis.affectedFlows.filter((f) => f.flow.priority === 'P1');
+    if (p1Flows.length > 0) {
+        console.log('🟡 HIGH PRIORITY (P1) FLOWS AFFECTED:');
+        p1Flows.slice(0, 5).forEach((impact) => {
+            console.log(`   • ${impact.flow.name} (${impact.flow.id})`);
+            console.log(`     Tests: ${impact.existingTests.length}/${impact.affectedFiles.length} files, Gaps: ${impact.testGaps.length}`);
+        });
+        if (p1Flows.length > 5) {
+            console.log(`   ... and ${p1Flows.length - 5} more P1 flows`);
+        }
+        console.log('');
+    }
+    // Recommendations
+    if (analysis.recommendations.length > 0) {
+        console.log('💡 RECOMMENDATIONS:');
+        analysis.recommendations.forEach((rec, i) => {
+            console.log(`   ${i + 1}. ${rec}`);
+        });
+        console.log('');
+    }
+    // Action Items
+    console.log('🎯 SUGGESTED ACTIONS:');
+    if (analysis.hasP0Impact) {
+        console.log('   1. Run P0 flow tests immediately:');
+        const p0Tests = p0Flows.flatMap((f) => f.existingTests).filter((t) => t);
+        if (p0Tests.length > 0) {
+            console.log(`      npx playwright test ${p0Tests.slice(0, 3).join(' ')}`);
+            if (p0Tests.length > 3) {
+                console.log(`      ... and ${p0Tests.length - 3} more P0 tests`);
+            }
+        }
+        else {
+            console.log('      ⚠️  No existing P0 tests found - generate tests first:');
+            console.log('      npx e2e-ai-agents approve-and-generate --path <app-root> --tests-root <tests-root> --pipeline --pipeline-scenarios 3');
+        }
+    }
+    if (analysis.testCoverage.gaps > 0) {
+        console.log(`   2. Address ${analysis.testCoverage.gaps} test coverage gap(s):`);
+        const gapFlows = analysis.affectedFlows.filter((f) => f.testGaps.length > 0).slice(0, 2);
+        gapFlows.forEach(() => {
+            console.log('      npx e2e-ai-agents approve-and-generate --path <app-root> --tests-root <tests-root> --pipeline --pipeline-scenarios 3');
+        });
+        if (analysis.testCoverage.gaps > 2) {
+            console.log(`      # ... and ${analysis.testCoverage.gaps - 2} more flows with gaps`);
+        }
+    }
+    console.log('\n═══════════════════════════════════════════════════════════════════\n');
+}
+// =============================================================================
+// MARKDOWN REPORT
+// =============================================================================
+function generateMarkdownReport(analysis) {
+    const lines = [];
+    lines.push('# Code Impact Analysis Report');
+    lines.push('');
+    lines.push(`**Generated**: ${new Date(analysis.timestamp).toLocaleString()}`);
+    lines.push(`**Git Reference**: ${analysis.gitRef}`);
+    lines.push('');
+    // Risk Level Badge
+    const riskLevel = analysis.hasP0Impact
+        ? '🔴 **HIGH** (P0 flows affected)'
+        : analysis.priorityBreakdown.p1 > 0
+            ? '🟡 **MEDIUM** (P1 flows affected)'
+            : '🟢 **LOW** (Only P2 flows affected)';
+    // Executive Summary
+    lines.push('## Executive Summary');
+    lines.push('');
+    lines.push(`- **Changed files**: ${analysis.totalChanges}`);
+    lines.push(`- **Affected flows**: ${analysis.affectedFlows.length}`);
+    lines.push(`- **Priority**: P0=${analysis.priorityBreakdown.p0}, P1=${analysis.priorityBreakdown.p1}, P2=${analysis.priorityBreakdown.p2}`);
+    lines.push(`- **Test coverage**: ${analysis.testCoverage.covered}/${analysis.testCoverage.total} flows have tests (${analysis.testCoverage.gaps} gaps)`);
+    lines.push(`- **Risk level**: ${riskLevel}`);
+    lines.push('');
+    // Critical Flows
+    const p0Flows = analysis.affectedFlows.filter((f) => f.flow.priority === 'P0');
+    if (p0Flows.length > 0) {
+        lines.push('## 🔴 Critical (P0) Flows Affected');
+        lines.push('');
+        p0Flows.forEach((impact) => {
+            lines.push(`### ${impact.flow.name} (\`${impact.flow.id}\`)`);
+            lines.push('');
+            lines.push(`**Confidence**: ${impact.confidence}%`);
+            lines.push(`**Match type**: ${impact.matchType}`);
+            lines.push(`**Affected files**: ${impact.affectedFiles.length} file${impact.affectedFiles.length !== 1 ? 's' : ''}`);
+            lines.push('');
+            lines.push(`**Existing tests**: ${impact.existingTests.length > 0 ? '✓ ' + impact.existingTests.length : '✗ None'}`);
+            if (impact.existingTests.length > 0) {
+                lines.push('```');
+                impact.existingTests.slice(0, 3).forEach((test) => {
+                    lines.push(test);
+                });
+                if (impact.existingTests.length > 3) {
+                    lines.push(`... and ${impact.existingTests.length - 3} more`);
+                }
+                lines.push('```');
+            }
+            if (impact.testGaps.length > 0) {
+                lines.push('');
+                lines.push(`**Test gaps**:`);
+                impact.testGaps.slice(0, 3).forEach((gap) => {
+                    lines.push(`- ${gap}`);
+                });
+                if (impact.testGaps.length > 3) {
+                    lines.push(`- ... and ${impact.testGaps.length - 3} more`);
+                }
+            }
+            lines.push('');
+        });
+    }
+    // High Priority Flows
+    const p1Flows = analysis.affectedFlows.filter((f) => f.flow.priority === 'P1');
+    if (p1Flows.length > 0) {
+        lines.push('## 🟡 High Priority (P1) Flows Affected');
+        lines.push('');
+        lines.push('| Flow | ID | Files | Tests | Gaps |');
+        lines.push('|------|----| ------|-------|------|');
+        p1Flows.slice(0, 10).forEach((impact) => {
+            lines.push(`| ${impact.flow.name} | \`${impact.flow.id}\` | ${impact.affectedFiles.length} | ${impact.existingTests.length} | ${impact.testGaps.length} |`);
+        });
+        if (p1Flows.length > 10) {
+            lines.push(`| ... ${p1Flows.length - 10} more | ... | ... | ... | ... |`);
+        }
+        lines.push('');
+    }
+    // Recommendations
+    if (analysis.recommendations.length > 0) {
+        lines.push('## 💡 Recommendations');
+        lines.push('');
+        analysis.recommendations.forEach((rec, i) => {
+            lines.push(`${i + 1}. ${rec}`);
+        });
+        lines.push('');
+    }
+    // Action Items
+    lines.push('## 🎯 Action Items');
+    lines.push('');
+    if (analysis.hasP0Impact) {
+        lines.push('### Immediate: Run P0 Tests');
+        lines.push('');
+        const p0Tests = p0Flows.flatMap((f) => f.existingTests).filter((t) => t);
+        if (p0Tests.length > 0) {
+            lines.push('```bash');
+            lines.push(`npx playwright test ${p0Tests.slice(0, 3).join(' ')}`);
+            if (p0Tests.length > 3) {
+                lines.push(`# ... and ${p0Tests.length - 3} more P0 tests`);
+            }
+            lines.push('```');
+        }
+        else {
+            lines.push('No existing P0 tests found. Generate tests:');
+            lines.push('');
+            lines.push('```bash');
+            lines.push('npx e2e-ai-agents approve-and-generate --path <app-root> --tests-root <tests-root> --pipeline --pipeline-scenarios 3');
+            lines.push('```');
+        }
+        lines.push('');
+    }
+    if (analysis.testCoverage.gaps > 0) {
+        lines.push('### Generate Missing Tests');
+        lines.push('');
+        const gapFlows = analysis.affectedFlows.filter((f) => f.testGaps.length > 0).slice(0, 3);
+        if (gapFlows.length > 0) {
+            lines.push('```bash');
+            gapFlows.forEach(() => {
+                lines.push('npx e2e-ai-agents approve-and-generate --path <app-root> --tests-root <tests-root> --pipeline --pipeline-scenarios 3');
+            });
+            if (analysis.testCoverage.gaps > 3) {
+                lines.push(`# ... and ${analysis.testCoverage.gaps - 3} more gaps to address`);
+            }
+            lines.push('```');
+        }
+    }
+    lines.push('');
+    lines.push('---');
+    lines.push('');
+    lines.push('_This report was generated by the E2E Impact Analysis Agent. To regenerate, run: `npx e2e-ai-agents impact --path <app-root> --tests-root <tests-root>`_');
+    return lines.join('\n');
+}
+// =============================================================================
+// JSON REPORT
+// =============================================================================
+/**
+ * JSON report is generated directly in generateReports()
+ * No additional formatting needed
+ */

package/dist/agent/report.d.ts

@@ -0,0 +1,81 @@
+import type { AgentConfig } from './config.js';
+import type { FlowImpact } from './analysis.js';
+import type { FlowCoverage } from './tests.js';
+import type { DataTestIdSuggestion } from './selectors.js';
+import type { GapTestSuggestion } from './gap_suggestions.js';
+export interface ReportData {
+    mode: 'impact' | 'gap';
+    changedFiles: string[];
+    flows: FlowImpact[];
+    coverage: FlowCoverage[];
+    gaps: FlowImpact[];
+    dataTestIds: DataTestIdSuggestion[];
+    testSuggestions?: GapTestSuggestion[];
+    suggestedNewTests?: GapTestSuggestion[];
+    framework: string;
+    testPatterns: string[];
+    specPDF?: string;
+    warnings: string[];
+    flowCatalog?: string;
+    recommendedTests?: string[];
+    impactModel?: {
+        schemaVersion: '1.0.0';
+        flowMapping: 'catalog' | 'heuristic';
+        testMapping: 'catalog' | 'traceability' | 'heuristic';
+        confidenceClass: 'high' | 'medium' | 'low';
+        traceability?: {
+            source: 'manifest';
+            enabled: boolean;
+            manifestPath: string;
+            manifestFound: boolean;
+            manifestTests: number;
+            manifestEdges: number;
+            matchedFlows: number;
+            totalFlows: number;
+            matchedTests: number;
+            coverageRatio: number;
+        };
+        dependencyGraph?: {
+            source: 'static-dependency-graph';
+            enabled: boolean;
+            seedFiles: number;
+            expandedFiles: number;
+            analyzedFiles: number;
+            analyzedEdges: number;
+            maxDepth: number;
+            truncated: boolean;
+        };
+        subsystemRisk?: {
+            source: 'map';
+            enabled: boolean;
+            mapPath: string;
+            mapFound: boolean;
+            rulesLoaded: number;
+            filesMatched: number;
+            ruleMatches: number;
+            boostedFlows: number;
+        };
+    };
+    pipeline?: {
+        runner: string;
+        results: Array<{
+            flowId: string;
+            flowName: string;
+            generatedDir: string;
+            generateStatus: string;
+            healStatus?: string;
+            error?: string;
+        }>;
+        warnings: string[];
+    };
+    applied?: {
+        patchedFiles: string[];
+        generatedTests: string[];
+        skippedTests: string[];
+    };
+}
+export declare function writeReport(appRoot: string, config: AgentConfig, data: ReportData): {
+    markdownPath: string;
+    jsonPath: string;
+};
+//# sourceMappingURL=report.d.ts.map

package/dist/agent/report.d.ts.map

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

package/dist/agent/report.js

@@ -0,0 +1,147 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeReport = writeReport;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const flags_js_1 = require("./flags.js");
+function formatFlow(flow) {
+    const reasonText = flow.reasons.length > 0 ? flow.reasons.join('; ') : 'No specific reasons';
+    const audienceText = flow.audience && flow.audience.length > 0 ? `\n  Audience: ${flow.audience.join(', ')}` : '';
+    const flagsText = flow.flags && flow.flags.length > 0 ? `\n  Flags: ${(0, flags_js_1.formatFlags)(flow.flags)}` : '';
+    const blastText = flow.blastRadius ? `\n  Blast radius: ${flow.blastRadius.summary}` : '';
+    return `- [${flow.priority}] ${flow.name} (${flow.id})\n  Score: ${flow.score}\n  Reasons: ${reasonText}\n  Files: ${flow.files.join(', ')}${audienceText}${flagsText}${blastText}`;
+}
+function formatGap(flow) {
+    return `- [${flow.priority}] ${flow.name} (${flow.id})`;
+}
+function formatSuggestion(suggestion) {
+    return `- ${suggestion.file}:${suggestion.line} -> ${suggestion.testId}\n  ${suggestion.snippet}`;
+}
+function formatTestSuggestion(suggestion) {
+    const source = suggestion.sourceFiles.length > 0 ? suggestion.sourceFiles.join(', ') : 'N/A';
+    return `- [${suggestion.priority}] ${suggestion.flowName} (${suggestion.flowId})\n  Path: ${suggestion.suggestedTestPath}\n  Source files: ${source}\n  Why: ${suggestion.rationale}`;
+}
+function flowCounts(flows) {
+    return flows.reduce((acc, flow) => {
+        if (flow.priority === 'P0')
+            acc.p0 += 1;
+        else if (flow.priority === 'P1')
+            acc.p1 += 1;
+        else
+            acc.p2 += 1;
+        return acc;
+    }, { p0: 0, p1: 0, p2: 0 });
+}
+function writeReport(appRoot, config, data) {
+    const specsDir = (0, path_1.join)(appRoot, config.artifacts.specsDir);
+    const baseDir = (0, path_1.join)(appRoot, '.e2e-ai-agents');
+    if (config.artifacts.mode !== 'none') {
+        (0, fs_1.mkdirSync)(specsDir, { recursive: true });
+    }
+    (0, fs_1.mkdirSync)(baseDir, { recursive: true });
+    const counts = flowCounts(data.flows);
+    const markdownLines = [];
+    markdownLines.push(`# ${data.mode === 'impact' ? 'Impact Analysis' : 'Gap Analysis'} Report`);
+    markdownLines.push('');
+    markdownLines.push(`Framework: ${data.framework}`);
+    markdownLines.push(`Test Patterns: ${data.testPatterns.join(', ') || 'None'}`);
+    if (data.flowCatalog) {
+        markdownLines.push(`Flow Catalog: ${data.flowCatalog}`);
+    }
+    if (data.impactModel) {
+        markdownLines.push(`Impact Model: flow=${data.impactModel.flowMapping} test=${data.impactModel.testMapping} confidence=${data.impactModel.confidenceClass}`);
+        if (data.impactModel.traceability) {
+            const traceability = data.impactModel.traceability;
+            markdownLines.push(`Traceability: enabled=${traceability.enabled} manifestFound=${traceability.manifestFound} matchedFlows=${traceability.matchedFlows}/${traceability.totalFlows} matchedTests=${traceability.matchedTests} coverageRatio=${traceability.coverageRatio}`);
+        }
+        if (data.impactModel.dependencyGraph) {
+            const graph = data.impactModel.dependencyGraph;
+            markdownLines.push(`Dependency Graph: enabled=${graph.enabled} seeds=${graph.seedFiles} expanded=${graph.expandedFiles} files=${graph.analyzedFiles} edges=${graph.analyzedEdges} depth=${graph.maxDepth}${graph.truncated ? ' (truncated)' : ''}`);
+        }
+        if (data.impactModel.subsystemRisk) {
+            const subsystemRisk = data.impactModel.subsystemRisk;
+            markdownLines.push(`Subsystem Risk: enabled=${subsystemRisk.enabled} mapFound=${subsystemRisk.mapFound} rules=${subsystemRisk.rulesLoaded} filesMatched=${subsystemRisk.filesMatched} ruleMatches=${subsystemRisk.ruleMatches} boostedFlows=${subsystemRisk.boostedFlows}`);
+        }
+    }
+    markdownLines.push(`Changed Files: ${data.changedFiles.length}`);
+    markdownLines.push(`Flows: P0=${counts.p0} P1=${counts.p1} P2=${counts.p2}`);
+    if (data.specPDF) {
+        markdownLines.push(`Spec PDF: ${data.specPDF}`);
+    }
+    if (data.warnings.length > 0) {
+        markdownLines.push('');
+        markdownLines.push('Warnings:');
+        markdownLines.push(...data.warnings.map((warning) => `- ${warning}`));
+    }
+    if (data.flows.length > 0) {
+        markdownLines.push('');
+        markdownLines.push('Impacted Flows:');
+        markdownLines.push(...data.flows.map(formatFlow));
+    }
+    if (data.gaps.length > 0) {
+        markdownLines.push('');
+        markdownLines.push('Coverage Gaps (P0/P1 without tests):');
+        markdownLines.push(...data.gaps.map(formatGap));
+    }
+    if (data.recommendedTests && data.recommendedTests.length > 0) {
+        markdownLines.push('');
+        markdownLines.push('Recommended Tests to Run:');
+        markdownLines.push(...data.recommendedTests.map((test) => `- ${test}`));
+    }
+    if (data.pipeline) {
+        markdownLines.push('');
+        markdownLines.push('Pipeline Results:');
+        markdownLines.push(`- Runner: ${data.pipeline.runner}`);
+        for (const result of data.pipeline.results) {
+            const status = result.healStatus ? `${result.generateStatus}/${result.healStatus}` : result.generateStatus;
+            markdownLines.push(`- ${result.flowId} (${result.flowName}): ${status} -> ${result.generatedDir}`);
+            if (result.error) {
+                markdownLines.push(`  Error: ${result.error}`);
+            }
+        }
+        if (data.pipeline.warnings.length > 0) {
+            markdownLines.push('Pipeline warnings:');
+            markdownLines.push(...data.pipeline.warnings.map((warning) => `- ${warning}`));
+        }
+    }
+    if (data.dataTestIds.length > 0) {
+        markdownLines.push('');
+        markdownLines.push('data-testid Suggestions:');
+        markdownLines.push(...data.dataTestIds.map(formatSuggestion));
+    }
+    if (data.testSuggestions && data.testSuggestions.length > 0) {
+        markdownLines.push('');
+        markdownLines.push('Suggested New Tests (Actionable):');
+        markdownLines.push(...data.testSuggestions.map(formatTestSuggestion));
+    }
+    if (data.applied) {
+        markdownLines.push('');
+        markdownLines.push('Applied Changes:');
+        if (data.applied.patchedFiles.length > 0) {
+            markdownLines.push(`- Patched files: ${data.applied.patchedFiles.join(', ')}`);
+        }
+        if (data.applied.generatedTests.length > 0) {
+            markdownLines.push(`- Generated tests: ${data.applied.generatedTests.join(', ')}`);
+        }
+        if (data.applied.skippedTests.length > 0) {
+            markdownLines.push(`- Skipped test files: ${data.applied.skippedTests.join(', ')}`);
+        }
+    }
+    const markdownContent = markdownLines.join('\n');
+    const reportName = data.mode === 'impact' ? 'impact-plan.md' : 'gap-report.md';
+    const markdownPath = (0, path_1.join)(specsDir, reportName);
+    if (config.artifacts.mode !== 'none') {
+        (0, fs_1.writeFileSync)(markdownPath, markdownContent, 'utf-8');
+    }
+    const jsonPath = (0, path_1.join)(baseDir, data.mode === 'impact' ? 'impact.json' : 'gap.json');
+    const jsonData = data.mode === 'gap'
+        ? {
+            ...data,
+            suggestedNewTests: data.suggestedNewTests || data.testSuggestions || [],
+        }
+        : data;
+    (0, fs_1.writeFileSync)(jsonPath, JSON.stringify(jsonData, null, 2), 'utf-8');
+    return { markdownPath, jsonPath };
+}

package/dist/agent/runner.d.ts

@@ -0,0 +1,7 @@
+import type { AgentConfig } from './config.js';
+export interface RunOptions {
+    apply: boolean;
+}
+export declare function runImpact(_config: AgentConfig, _options: RunOptions): Promise<void>;
+export declare function runGap(_config: AgentConfig, _options: RunOptions): Promise<void>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/agent/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/agent/runner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,aAAa,CAAC;AA6M7C,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA4LzF;AAED,wBAAsB,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA4LtF"}