autosnippet 3.2.10 → 3.2.12

package/dist/lib/external/mcp/handlers/bootstrap-internal.js

@@ -0,0 +1,393 @@
+/**
+ * MCP Handlers — Bootstrap 冷启动知识库初始化 (内部 Agent 路径)
+ *
+ * ⚠️ 本文件是「内部 Agent」冷启动路径 — 由 AutoSnippet 内置的 Analyst/Producer
+ *    双 Agent AI pipeline 自动完成知识提取。需要配置 AI Provider (API Key)。
+ *
+ * 调用方:
+ *   - CLI: `asd bootstrap --knowledge`
+ *   - AgentRuntime: `bootstrapKnowledgeTool` (infrastructure.js)
+ *   - Dashboard HTTP: POST /api/bootstrap/knowledge
+ *
+ * 外部 Agent 路径（Cursor/Copilot 等 IDE Agent）请参见:
+ *   - bootstrap-external.js  — 无参数 Mission Briefing 入口
+ *   - dimension-complete.js  — 维度完成通知
+ *   外部 Agent 使用 read_file/grep_search 等原生能力自行分析代码，
+ *   不经过本文件的 Phase 5 AI pipeline。
+ *
+ * 内部 Agent 架构 (v5 + Async Fill):
+ *
+ * 同步阶段（快速返回，~1-3s）:
+ *   Phase 1   → 文件收集（SPM Target 源文件扫描）
+ *   Phase 1.5 → AST 代码结构分析（Tree-sitter）
+ *   Phase 2   → SPM 依赖关系 → knowledge_edges（模块级图谱）
+ *   Phase 3   → Guard 规则审计
+ *   Phase 4   → 构建响应骨架（filesByTarget + analysisFramework + 任务清单）
+ *
+ * 异步阶段（后台逐一填充，通过 Socket.io 推送进度）:
+ *   Phase 5   → 微观维度 × 子主题提取代码特征 → 创建 N 条 Candidate（PENDING 状态）
+ *              skillWorthy 维度仅提取内容，不创建 Candidate（避免与 Skill 重复）
+ *              anti-pattern 已移除 — 代码问题由 Guard 独立处理
+ *   Phase 5.5 → 宏观维度（architecture/code-standard/project-profile/agent-guidelines）
+ *              自动聚合为 Project Skill → 写入 AutoSnippet/skills/（不产生 Candidate）
+ *
+ * 进度推送事件（Socket.io + EventBus）:
+ *   bootstrap:started        — 骨架创建完成，携带任务清单
+ *   bootstrap:task-started   — 单个维度开始填充
+ *   bootstrap:task-completed — 单个维度填充完成
+ *   bootstrap:task-failed    — 单个维度失败
+ *   bootstrap:all-completed  — 全部维度完成（前端弹出通知）
+ *
+ * 模块结构:
+ *   bootstrap.js              ← 内部 Agent 主入口 (本文件)
+ *   bootstrap-external.js     ← 外部 Agent 主入口 (Mission Briefing)
+
+ *   bootstrap/patterns.js     ← 多语言代码模式匹配（内部 Agent 专用）
+ *   bootstrap/dimensions.js   ← 7 维度知识提取器（内部 Agent 专用）
+ *   bootstrap/projectSkills.js ← Phase 5.5 Project Skill 生成（内部 Agent 专用）
+ */
+import { getInternalAgentRequiredFields } from '#shared/FieldSpec.js';
+import { resolveProjectRoot } from '#shared/resolveProjectRoot.js';
+import { envelope } from '../envelope.js';
+import { fillDimensionsV3 } from './bootstrap/pipeline/orchestrator.js';
+import { bootstrapRefine } from './bootstrap/refine.js';
+import { runAllPhases } from './bootstrap/shared/bootstrap-phases.js';
+import { buildInternalNextSteps } from './bootstrap/shared/dimension-text.js';
+import { buildLanguageExtension, inferLang } from './LanguageExtensions.js';
+import { inferFilePriority, inferTargetRole } from './TargetClassifier.js';
+export { bootstrapRefine };
+/**
+ * bootstrapKnowledge — 一键初始化知识库 (Skill-aware)
+ *
+ * 覆盖 7 大知识维度: 项目规范、使用习惯、架构模式、代码模式、最佳实践、项目库特征、Agent开发注意事项
+ * （注意：反模式/代码问题由 Guard 独立处理，不在 Bootstrap 覆盖范围）
+ * 为每个维度自动创建 Candidate（PENDING），由内置 Analyst/Producer pipeline 分析代码。
+ *
+ * ⚠️ 本函数是内部 Agent 路径。外部 Agent 使用 bootstrap-external.js 的 Mission Briefing + dimension_complete 流程。
+ *
+ * @param {object} ctx  { container, logger }
+ * @param {object} args
+ * @param {number} [args.maxFiles=500] 最大扫描文件数
+ * @param {boolean} [args.skipGuard=false] 是否跳过 Guard 审计
+ * @param {number} [args.contentMaxLines=120] 每文件读取最大行数
+ * @param {boolean} [args.incremental=true] 是否启用增量 Bootstrap (自动检测变更, 仅重跑受影响维度)
+ */
+export async function bootstrapKnowledge(ctx, args) {
+    const t0 = Date.now();
+    const projectRoot = resolveProjectRoot(ctx.container);
+    // v5.0: 增量 Bootstrap 开关 (默认启用, 自动检测是否可增量)
+    const enableIncremental = args.incremental !== false;
+    const maxFiles = args.maxFiles || 500;
+    const skipGuard = args.skipGuard || false;
+    const contentMaxLines = args.contentMaxLines || 120;
+    const skipAsyncFill = args.skipAsyncFill || false;
+    // ═══════════════════════════════════════════════════════════
+    // Phase 1-4: 共享管线（文件收集→AST→依赖→Guard→维度解析）
+    // ═══════════════════════════════════════════════════════════
+    const phaseResults = await runAllPhases(projectRoot, ctx, {
+        maxFiles,
+        skipGuard,
+        clearOldData: true,
+        generateReport: true,
+        generateAstContext: true,
+        incremental: enableIncremental,
+        sourceTag: 'bootstrap',
+    });
+    if (phaseResults.isEmpty) {
+        return envelope({
+            success: true,
+            data: { report: phaseResults.report, message: 'No source files found, nothing to bootstrap' },
+            meta: { tool: 'autosnippet_bootstrap', responseTimeMs: Date.now() - t0 },
+        });
+    }
+    const { allFiles, allTargets, discoverer, langStats, primaryLang, astProjectSummary, astContext, depGraphData, depEdgesWritten, guardAudit, guardEngine: _guardEngine, activeDimensions, enhancementPackInfo, enhancementPatterns, enhancementGuardRules, langProfile, targetsSummary, incrementalPlan, detectedFrameworks: _detectedFrameworks, warnings: _phaseWarnings, report: phaseReport, } = phaseResults;
+    // 构建兼容的 report 对象（保持原有 API 格式）
+    const report = {
+        phases: {
+            fileCollection: {
+                discoverer: discoverer.id,
+                discovererName: discoverer.displayName,
+                targets: allTargets.length,
+                files: allFiles.length,
+                truncated: allFiles.length >= maxFiles,
+            },
+            incrementalEvaluation: incrementalPlan
+                ? {
+                    mode: incrementalPlan.mode,
+                    canIncremental: incrementalPlan.canIncremental,
+                    affectedDimensions: incrementalPlan.affectedDimensions,
+                    skippedDimensions: incrementalPlan.skippedDimensions,
+                    reason: incrementalPlan.reason,
+                    diff: incrementalPlan.diff
+                        ? {
+                            added: incrementalPlan.diff.added.length,
+                            modified: incrementalPlan.diff.modified.length,
+                            deleted: incrementalPlan.diff.deleted.length,
+                            unchanged: incrementalPlan.diff.unchanged.length,
+                            changeRatio: incrementalPlan.diff.changeRatio,
+                        }
+                        : null,
+                }
+                : undefined,
+            astAnalysis: {
+                classes: astProjectSummary?.classes?.length || 0,
+                protocols: astProjectSummary?.protocols?.length || 0,
+                categories: astProjectSummary?.categories?.length || 0,
+                patterns: Object.keys(astProjectSummary?.patternStats || {}),
+            },
+            codeEntityGraph: phaseReport?.phases?.entityGraph || {
+                entityCount: 0,
+                edgeCount: 0,
+                ms: 0,
+            },
+            callGraph: phaseReport?.phases?.callGraph
+                ? {
+                    entities: phaseReport.phases.callGraph.result?.entitiesUpserted || 0,
+                    edges: phaseReport.phases.callGraph.result?.edgesCreated || 0,
+                    ms: phaseReport.phases.callGraph.ms || 0,
+                }
+                : { entities: 0, edges: 0, ms: 0 },
+            dependencyGraph: { edgesWritten: depEdgesWritten || 0 },
+            enhancementPacks: {
+                matched: enhancementPackInfo,
+                extraDimensions: enhancementPackInfo.length,
+                guardRules: enhancementGuardRules?.length || 0,
+                patterns: enhancementPatterns?.length || 0,
+            },
+            guardAudit: {
+                totalViolations: guardAudit?.summary?.totalViolations || 0,
+                filesWithViolations: (guardAudit?.files || []).filter((f) => f.violations.length > 0).length,
+                skipped: skipGuard,
+                enhancementRulesInjected: enhancementGuardRules?.length || 0,
+            },
+        },
+        totals: {
+            files: allFiles.length,
+            graphEdges: depEdgesWritten || 0,
+            guardViolations: guardAudit?.summary?.totalViolations || 0,
+        },
+    };
+    // ═══════════════════════════════════════════════════════════
+    // Phase 4.5: 构建响应 — filesByTarget + analysisFramework
+    // ═══════════════════════════════════════════════════════════
+    const targetFileMap = {};
+    for (const f of allFiles) {
+        if (!targetFileMap[f.targetName]) {
+            targetFileMap[f.targetName] = [];
+        }
+        const lines = f.content.split('\n');
+        targetFileMap[f.targetName].push({
+            name: f.name,
+            relativePath: f.relativePath,
+            language: inferLang(f.name),
+            totalLines: lines.length,
+            priority: inferFilePriority(f.name),
+            // content 仅保留在内存中供 Phase 5 异步 pipeline 使用
+            // MCP 响应不包含文件内容（避免 1MB+ 响应导致 Cursor 无法处理）
+            content: lines.slice(0, contentMaxLines).join('\n'),
+            truncated: lines.length > contentMaxLines,
+        });
+    }
+    // 每个 target 内按 priority 排序
+    for (const tName of Object.keys(targetFileMap)) {
+        const prio = { high: 0, medium: 1, low: 2 };
+        targetFileMap[tName].sort((a, b) => (prio[a.priority] || 1) -
+            (prio[b.priority] || 1));
+    }
+    const dimensions = activeDimensions;
+    const responseData = {
+        report,
+        targets: targetsSummary ||
+            allTargets.map((t) => {
+                const name = typeof t === 'string' ? t : t.name;
+                return {
+                    name,
+                    type: t.type || 'target',
+                    packageName: t.packageName || undefined,
+                    inferredRole: inferTargetRole(name),
+                    fileCount: (targetFileMap[name] || []).length,
+                };
+            }),
+        // 响应中只返回每个 target 的高优先级文件摘要（不含 content），
+        // 避免 500+ 文件清单导致响应过大。完整文件列表保留在服务端供 Phase 5 使用。
+        filesByTarget: Object.fromEntries(Object.entries(targetFileMap).map(([target, files]) => {
+            const sorted = [...files].sort((a, b) => (Number(b.priority) || 0) - (Number(a.priority) || 0));
+            const top = sorted.slice(0, 10);
+            return [
+                target,
+                {
+                    totalFiles: files.length,
+                    topFiles: top.map(({ content, ...meta }) => meta),
+                    ...(files.length > 10 ? { truncated: true } : {}),
+                },
+            ];
+        })),
+        dependencyGraph: depGraphData
+            ? {
+                nodes: (depGraphData.nodes || []).map((n) => ({
+                    id: typeof n === 'string' ? n : n.id,
+                    label: typeof n === 'string' ? n : n.label,
+                })),
+                edges: depGraphData.edges || [],
+            }
+            : null,
+        languageStats: langStats,
+        primaryLanguage: primaryLang,
+        secondaryLanguages: langProfile.secondary,
+        isMultiLang: langProfile.isMultiLang,
+        languageExtension: buildLanguageExtension(primaryLang),
+        guardSummary: guardAudit
+            ? {
+                totalViolations: guardAudit.summary?.totalViolations || 0,
+                errors: guardAudit.summary?.errors || 0,
+                warnings: guardAudit.summary?.warnings || 0,
+            }
+            : null,
+        guardViolationFiles: guardAudit
+            ? (guardAudit.files || [])
+                .filter((f) => f.violations.length > 0)
+                .map((f) => ({
+                filePath: f.filePath,
+                violations: f.violations.map((v) => ({
+                    ruleId: v.ruleId,
+                    severity: v.severity,
+                    message: v.message,
+                    line: v.line,
+                })),
+            }))
+            : [],
+        // 9 维度分析框架（4 Skill-only + 2 dualOutput + 3 Candidate-only）
+        // 注意：anti-pattern 已移除，代码问题由 Guard 独立处理
+        analysisFramework: {
+            dimensions,
+            skillWorthyDimensions: dimensions.filter((d) => d.skillWorthy).map((d) => d.id),
+            candidateOnlyDimensions: dimensions.filter((d) => !d.skillWorthy).map((d) => d.id),
+            candidateRequiredFields: getInternalAgentRequiredFields(),
+            submissionTool: 'autosnippet_submit_knowledge_batch',
+            expectedOutput: `候选知识（微观代码维度：code-pattern/best-practice/event-and-data-flow + 语言条件扫描）+ Project Skills（宏观叙事维度：code-standard/architecture/project-profile/agent-guidelines + 语言条件扫描）— 共 ${dimensions.length} 个维度`,
+        },
+        // AST 代码结构分析上下文（供 Agent 使用）
+        astContext: astContext || null,
+        astSummary: astProjectSummary
+            ? {
+                classes: astProjectSummary.classes.length,
+                protocols: astProjectSummary.protocols.length,
+                categories: astProjectSummary.categories.length,
+                patterns: Object.keys(astProjectSummary.patternStats || {}),
+                metrics: astProjectSummary.projectMetrics
+                    ? {
+                        totalMethods: astProjectSummary.projectMetrics.totalMethods,
+                        avgMethodsPerClass: astProjectSummary.projectMetrics.avgMethodsPerClass,
+                        maxNestingDepth: astProjectSummary.projectMetrics.maxNestingDepth,
+                        complexMethods: astProjectSummary.projectMetrics.complexMethods?.length || 0,
+                        longMethods: astProjectSummary.projectMetrics.longMethods?.length || 0,
+                    }
+                    : null,
+            }
+            : null,
+        // Enhancement Pack 检测到的额外模式
+        enhancementPacks: enhancementPackInfo.length > 0
+            ? {
+                matched: enhancementPackInfo,
+                patterns: enhancementPatterns,
+                guardRules: enhancementGuardRules.length,
+            }
+            : null,
+        // 引导 Agent 下一步操作（共享文本层）
+        nextSteps: buildInternalNextSteps(dimensions),
+    };
+    // ═══════════════════════════════════════════════════════════
+    // Phase 5: 创建异步任务 — 骨架先返回，内容后填充
+    //
+    // 策略变更（v5）：
+    //   旧：同步遍历所有维度 → 提取 + 创建 Candidate → 一次性返回
+    //   新：快速创建任务清单 → 立即返回骨架 → 异步逐维度填充内容
+    //       前端通过 Socket.io 接收进度更新，卡片 loading → 完成
+    // ═══════════════════════════════════════════════════════════
+    // 构建任务定义列表
+    const taskDefs = dimensions.map((dim) => ({
+        id: dim.id,
+        meta: {
+            type: dim.skillWorthy ? 'skill' : 'candidate',
+            dimId: dim.id,
+            label: dim.label,
+            skillWorthy: !!dim.skillWorthy,
+            skillMeta: dim.skillMeta || null,
+        },
+    }));
+    // 启动 BootstrapTaskManager 会话（通过正式 DI 获取单例）
+    let bootstrapSession = null;
+    try {
+        const taskManager = ctx.container.get('bootstrapTaskManager');
+        bootstrapSession = taskManager.startSession(taskDefs);
+    }
+    catch (e) {
+        ctx.logger.warn(`[Bootstrap] BootstrapTaskManager init failed (graceful degradation): ${e instanceof Error ? e.message : String(e)}`);
+    }
+    // 立即构建骨架响应
+    responseData.bootstrapSession = bootstrapSession ? bootstrapSession.toJSON() : null;
+    responseData.bootstrapCandidates = { created: 0, failed: 0, errors: [], status: 'filling' };
+    responseData.autoSkills = { created: 0, failed: 0, skills: [], errors: [], status: 'filling' };
+    responseData.message = `Bootstrap 骨架已创建: ${allFiles.length} files, ${allTargets.length} targets, ${taskDefs.length} 个维度任务已排队，正在后台逐一填充...`;
+    // ── 异步后台填充（fire-and-forget）──
+    const fillContext = {
+        ctx,
+        dimensions,
+        allFiles,
+        targetFileMap,
+        depGraphData,
+        guardAudit,
+        langStats,
+        primaryLang,
+        astProjectSummary,
+        taskManager: (() => {
+            try {
+                return ctx.container.get('bootstrapTaskManager');
+            }
+            catch {
+                return null;
+            }
+        })(),
+        sessionId: bootstrapSession?.id || null,
+        projectRoot,
+        // v5.0: 增量 Bootstrap 计划
+        incrementalPlan,
+    };
+    // 使用 setImmediate 避免阻塞 HTTP 响应
+    // skipAsyncFill: CLI 非 --wait 模式跳过异步填充，避免进程退出后 DB 断连
+    if (!skipAsyncFill) {
+        setImmediate(() => {
+            ctx.logger.info(`[Bootstrap] Dispatching v3 AI-First pipeline`);
+            fillDimensionsV3(fillContext).catch((e) => {
+                ctx.logger.error(`[Bootstrap] Async fill (v3) failed: ${e.message}`);
+            });
+        });
+    }
+    else {
+        ctx.logger.info(`[Bootstrap] Async fill skipped (skipAsyncFill=true)`);
+    }
+    // ── SkillHooks: onBootstrapStarted (fire-and-forget) ──
+    try {
+        const skillHooks = ctx.container.get('skillHooks');
+        skillHooks
+            .run('onBootstrapComplete', {
+            filesScanned: allFiles.length,
+            targetsFound: allTargets.length,
+            candidatesCreated: 0, // 异步填充中，初始为 0
+            candidatesFailed: 0,
+            autoSkillsCreated: 0,
+            autoSkills: [],
+        }, { projectRoot: ctx.container.get('database')?.filename || '' })
+            .catch(() => { }); // fire-and-forget
+    }
+    catch {
+        /* skillHooks not available */
+    }
+    return envelope({
+        success: true,
+        data: responseData,
+        meta: { tool: 'autosnippet_bootstrap', responseTimeMs: Date.now() - t0 },
+    });
+}
+// bootstrapRefine → 已提取到 bootstrap/refine.js（通过顶部 re-export）
+//# sourceMappingURL=bootstrap-internal.js.map

package/dist/lib/external/mcp/handlers/bootstrap-internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-internal.js","sourceRoot":"","sources":["../../../../../lib/external/mcp/handlers/bootstrap-internal.ts"],"names":[],"mappings":"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"}

package/dist/lib/external/mcp/handlers/browse.d.ts

@@ -0,0 +1,151 @@
+/**
+ * MCP Handlers — 知识浏览类 (V3: 使用 knowledgeService)
+ * listByKind, listRecipes, getRecipe, recipeInsights, confirmUsage
+ *
+ * 投影原则：只交付 Agent 可操作的信号，不交付内部运营/审计数据。
+ *   - _projectItem   → list 列表摘要（精简 ~10 字段）
+ *   - _projectForAgent → get 详情（去除噪音 ~25 字段）
+ */
+import type { BrowseGetArgs, BrowseListArgs, ConfirmUsageArgs, McpContext } from './types.js';
+export declare function listByKind(ctx: McpContext, kind: string, args: BrowseListArgs): Promise<{
+    success: boolean;
+    errorCode: string | null;
+    message: string;
+    data: {
+        kind: string;
+        count: any;
+        total: any;
+        items: any;
+    } | null;
+    meta: {
+        source?: string | undefined;
+        responseTimeMs?: number | undefined;
+        version: string;
+        tool?: string | undefined;
+    };
+}>;
+export declare function listRecipes(ctx: McpContext, args: BrowseListArgs): Promise<{
+    success: boolean;
+    errorCode: string | null;
+    message: string;
+    data: {
+        count: any;
+        total: any;
+        items: any;
+    } | null;
+    meta: {
+        source?: string | undefined;
+        responseTimeMs?: number | undefined;
+        version: string;
+        tool?: string | undefined;
+    };
+}>;
+export declare function getRecipe(ctx: McpContext, args: BrowseGetArgs): Promise<{
+    success: boolean;
+    errorCode: string | null;
+    message: string;
+    data: {
+        id: string;
+        title: string;
+        description: string | undefined;
+        trigger: string;
+        kind: string | undefined;
+        language: string | undefined;
+        category: string | undefined;
+        knowledgeType: string | undefined;
+        complexity: string | undefined;
+        tags: string[] | undefined;
+        whenClause: string | undefined;
+        doClause: string | undefined;
+        dontClause: string | undefined;
+        coreCode: string | undefined;
+        content: {
+            steps?: unknown[] | undefined;
+            rationale?: string | undefined;
+            markdown?: string | undefined;
+            pattern?: string | undefined;
+        } | undefined;
+        headers: string[] | undefined;
+        reasoning: {
+            confidence?: number | undefined;
+            whyStandard?: string | undefined;
+        } | undefined;
+        relations: Record<string, unknown[]> | undefined;
+        constraints: {
+            sideEffects?: unknown[] | undefined;
+            guards?: unknown[] | undefined;
+        } | undefined;
+    } | null;
+    meta: {
+        source?: string | undefined;
+        responseTimeMs?: number | undefined;
+        version: string;
+        tool?: string | undefined;
+    };
+}>;
+export declare function recipeInsights(ctx: McpContext, args: BrowseGetArgs): Promise<{
+    success: boolean;
+    errorCode: string | null;
+    message: string;
+    data: {
+        id: any;
+        title: any;
+        trigger: any;
+        kind: any;
+        lifecycle: any;
+        language: any;
+        category: any;
+        knowledgeType: any;
+        quality: {
+            overall: any;
+            completeness: any;
+            adaptation: any;
+            documentation: any;
+        };
+        stats: {
+            adoptions: any;
+            applications: any;
+            guardHits: any;
+            views: any;
+            searchHits: any;
+        };
+        content: {
+            hasPattern: boolean;
+            hasRationale: boolean;
+            hasMarkdown: boolean;
+            stepsCount: any;
+            codeChangesCount: any;
+        };
+        relations: Record<string, number>;
+        constraints: Record<string, unknown[]>;
+        tags: any;
+        complexity: any;
+        scope: any;
+        createdBy: any;
+        createdAt: any;
+        updatedAt: any;
+    } | null;
+    meta: {
+        source?: string | undefined;
+        responseTimeMs?: number | undefined;
+        version: string;
+        tool?: string | undefined;
+    };
+}>;
+export declare function confirmUsage(ctx: McpContext, args: ConfirmUsageArgs): Promise<{
+    success: boolean;
+    errorCode: string | null;
+    message: string;
+    data: {
+        recipeId: string;
+        usageType: string;
+        feedback: string | null;
+    } | null;
+    meta: {
+        source?: string | undefined;
+        responseTimeMs?: number | undefined;
+        version: string;
+        tool?: string | undefined;
+    };
+}>;
+//# sourceMappingURL=browse.d.ts.map

package/dist/lib/external/mcp/handlers/browse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse.d.ts","sourceRoot":"","sources":["../../../../../lib/external/mcp/handlers/browse.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,gBAAgB,EAEhB,UAAU,EACX,MAAM,YAAY,CAAC;AAuIpB,wBAAsB,UAAU,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc;;;;;;;;;;;;;;;;GAgBnF;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc;;;;;;;;;;;;;;;GA4BtE;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAanE;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuExE;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,gBAAgB;;;;;;;;;;;;;;;GAkCzE"}