autosnippet 3.2.9 → 3.2.11

package/dist/lib/domain/knowledge/KnowledgeEntry.d.ts

@@ -0,0 +1,297 @@
+import type { Guard } from './values/Constraints.js';
+import { Constraints, Content, Quality, Reasoning, Relations, Stats } from './values/index.js';
+export interface KnowledgeEntryProps {
+    id?: string;
+    title?: string;
+    description?: string;
+    lifecycle?: string;
+    lifecycleHistory?: Array<{
+        from: string;
+        to: string;
+        at: number;
+    }>;
+    autoApprovable?: boolean;
+    language?: string;
+    category?: string;
+    knowledgeType?: string;
+    kind?: string;
+    complexity?: string;
+    scope?: string;
+    difficulty?: string | null;
+    tags?: string[];
+    trigger?: string;
+    topicHint?: string;
+    whenClause?: string;
+    doClause?: string;
+    dontClause?: string;
+    coreCode?: string;
+    usageGuide?: string;
+    content?: unknown;
+    relations?: unknown;
+    constraints?: unknown;
+    reasoning?: unknown;
+    quality?: unknown;
+    stats?: unknown;
+    headers?: string[];
+    headerPaths?: string[];
+    moduleName?: string;
+    includeHeaders?: boolean;
+    agentNotes?: string | null;
+    aiInsight?: string | null;
+    reviewedBy?: string | null;
+    reviewedAt?: number | null;
+    rejectionReason?: string | null;
+    source?: string;
+    sourceFile?: string | null;
+    sourceCandidateId?: string | null;
+    createdBy?: string;
+    createdAt?: number;
+    updatedAt?: number;
+    publishedAt?: number | null;
+    publishedBy?: string | null;
+    [key: string]: unknown;
+}
+export declare class KnowledgeEntry {
+    id: string;
+    title: string;
+    description: string;
+    lifecycle: string;
+    lifecycleHistory: Array<{
+        from: string;
+        to: string;
+        at: number;
+    }>;
+    autoApprovable: boolean;
+    language: string;
+    category: string;
+    knowledgeType: string;
+    kind: string;
+    complexity: string;
+    scope: string;
+    difficulty: string | null;
+    tags: string[];
+    trigger: string;
+    topicHint: string;
+    whenClause: string;
+    doClause: string;
+    dontClause: string;
+    coreCode: string;
+    usageGuide: string;
+    content: Content;
+    relations: Relations;
+    constraints: Constraints;
+    reasoning: Reasoning;
+    quality: Quality;
+    stats: Stats;
+    headers: string[];
+    headerPaths: string[];
+    moduleName: string;
+    includeHeaders: boolean;
+    agentNotes: string | null;
+    aiInsight: string | null;
+    reviewedBy: string | null;
+    reviewedAt: number | null;
+    rejectionReason: string | null;
+    source: string;
+    sourceFile: string | null;
+    sourceCandidateId: string | null;
+    createdBy: string;
+    createdAt: number;
+    updatedAt: number;
+    publishedAt: number | null;
+    publishedBy: string | null;
+    constructor(props?: KnowledgeEntryProps);
+    /**
+     * 发布 (pending → active)
+     * @param {string} publisher
+     * @returns {{ success: boolean, error?: string }}
+     */
+    publish(publisher: string): {
+        success: boolean;
+        error?: string;
+    };
+    /**
+     * 弃用 (pending|active → deprecated)
+     * @param {string} reason
+     * @returns {{ success: boolean, error?: string }}
+     */
+    deprecate(reason: string): {
+        success: boolean;
+        error?: string;
+    };
+    /**
+     * 重新激活 (deprecated → pending)
+     * @returns {{ success: boolean, error?: string }}
+     */
+    reactivate(): {
+        success: boolean;
+        error?: string;
+    };
+    /**
+     * 是否处于候选阶段
+     * @returns {boolean}
+     */
+    isCandidate(): boolean;
+    /**
+     * 是否可被 Guard/Search/Export 消费
+     * @returns {boolean}
+     */
+    isActive(): boolean;
+    /**
+     * 是否为 Guard 规则类型
+     * @returns {boolean}
+     */
+    isRule(): boolean;
+    /**
+     * 内容是否有效
+     * @returns {boolean}
+     */
+    isValid(): boolean;
+    /**
+     * 返回此 Entry 中可被 GuardCheckEngine 消费的规则列表
+     * @returns {Array<Object>}
+     */
+    getGuardRules(): ({
+        id: string;
+        type: string;
+        name: string;
+        message: string;
+        pattern: string | null;
+        languages: string[];
+        severity: "error" | "info" | "warning";
+        source: string;
+        fixSuggestion: string | null;
+    } | {
+        id: string;
+        type: string;
+        name: string;
+        message: string;
+        astQuery: Record<string, unknown> | null;
+        languages: {}[];
+        severity: "error" | "info" | "warning";
+        source: string;
+        fixSuggestion: string | null;
+    })[];
+    /** 系统内部标签前缀 — 内部元数据，不应暴露给最终用户 */
+    static SYSTEM_TAG_PREFIXES: string[];
+    /** 判断是否为系统内部标签 */
+    static isSystemTag(tag: string): boolean;
+    /**
+     * Domain → JSON (camelCase 直出，全链路统一)
+     * 注意: tags 保留原始值（含系统标签），对外 API 使用 sanitizeForAPI() 过滤
+     */
+    toJSON(): {
+        id: string;
+        title: string;
+        description: string;
+        lifecycle: string;
+        lifecycleHistory: {
+            from: string;
+            to: string;
+            at: number;
+        }[];
+        autoApprovable: boolean;
+        language: string;
+        category: string;
+        kind: string;
+        knowledgeType: string;
+        complexity: string;
+        scope: string;
+        difficulty: string | null;
+        tags: string[];
+        trigger: string;
+        topicHint: string;
+        whenClause: string;
+        doClause: string;
+        dontClause: string;
+        coreCode: string;
+        usageGuide: string;
+        content: {
+            pattern: string;
+            markdown: string;
+            rationale: string;
+            steps: {
+                title?: string;
+                description?: string;
+                code?: string;
+            }[];
+            codeChanges: {
+                file: string;
+                before: string;
+                after: string;
+                explanation: string;
+            }[];
+            verification: {
+                method?: string;
+                expected_result?: string;
+                test_code?: string;
+            } | null;
+        };
+        relations: {
+            [x: string]: import("./values/Relations.js").RelationEntry[];
+        };
+        constraints: {
+            guards: Guard[];
+            boundaries: string[];
+            preconditions: string[];
+            sideEffects: string[];
+        };
+        reasoning: {
+            whyStandard: string;
+            sources: string[];
+            confidence: number;
+            qualitySignals: Record<string, number>;
+            alternatives: string[];
+        };
+        quality: {
+            completeness: number;
+            adaptation: number;
+            documentation: number;
+            overall: number;
+            grade: string;
+        };
+        stats: {
+            views: number;
+            adoptions: number;
+            applications: number;
+            guardHits: number;
+            searchHits: number;
+            authority: number;
+        };
+        headers: string[];
+        headerPaths: string[];
+        moduleName: string;
+        includeHeaders: boolean;
+        agentNotes: string | null;
+        aiInsight: string | null;
+        reviewedBy: string | null;
+        reviewedAt: number | null;
+        rejectionReason: string | null;
+        source: string;
+        sourceFile: string | null;
+        sourceCandidateId: string | null;
+        createdBy: string;
+        createdAt: number;
+        updatedAt: number;
+        publishedAt: number | null;
+        publishedBy: string | null;
+    };
+    /**
+     * JSON → Domain (camelCase 直入)
+     * @param {Object} data
+     * @returns {KnowledgeEntry}
+     */
+    static fromJSON(data: unknown): KnowledgeEntry;
+    /**
+     * @param {string} to
+     * @returns {{ success: boolean, error?: string }}
+     */
+    _transition(to: string): {
+        success: boolean;
+        error?: string;
+    };
+    /** @returns {number} */
+    _now(): number;
+}
+export default KnowledgeEntry;
+//# sourceMappingURL=KnowledgeEntry.d.ts.map

package/dist/lib/domain/knowledge/KnowledgeEntry.d.ts.map

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

package/dist/lib/domain/knowledge/KnowledgeEntry.js

@@ -0,0 +1,315 @@
+import { v4 as uuidv4 } from 'uuid';
+import { inferKind, isCandidate as isLifecycleCandidate, isValidTransition, Lifecycle, normalizeLifecycle, } from './Lifecycle.js';
+import { Constraints, Content, Quality, Reasoning, Relations, Stats } from './values/index.js';
+export class KnowledgeEntry {
+    // Identification
+    id;
+    title;
+    description;
+    // Lifecycle
+    lifecycle;
+    lifecycleHistory;
+    autoApprovable;
+    // Language & Classification
+    language;
+    category;
+    knowledgeType;
+    kind;
+    complexity;
+    scope;
+    difficulty;
+    tags;
+    // Cursor delivery fields
+    trigger;
+    topicHint;
+    whenClause;
+    doClause;
+    dontClause;
+    coreCode;
+    usageGuide;
+    // Value objects
+    content;
+    relations;
+    constraints;
+    reasoning;
+    quality;
+    stats;
+    // Code headers (ObjC/Swift)
+    headers;
+    headerPaths;
+    moduleName;
+    includeHeaders;
+    // AI
+    agentNotes;
+    aiInsight;
+    // Review
+    reviewedBy;
+    reviewedAt;
+    rejectionReason;
+    // Source
+    source;
+    sourceFile;
+    sourceCandidateId;
+    // Timestamps
+    createdBy;
+    createdAt;
+    updatedAt;
+    publishedAt;
+    publishedBy;
+    constructor(props = {}) {
+        // ── 标识 ──
+        this.id = props.id || uuidv4();
+        this.title = props.title || '';
+        this.description = props.description || '';
+        // ── 生命周期 ──
+        this.lifecycle = normalizeLifecycle(props.lifecycle || Lifecycle.PENDING);
+        this.lifecycleHistory = props.lifecycleHistory || [];
+        this.autoApprovable = props.autoApprovable ?? false;
+        // ── 语言与分类 ──
+        this.language = props.language || '';
+        this.category = props.category || '';
+        this.knowledgeType = props.knowledgeType || 'code-pattern';
+        this.kind = props.kind || inferKind(this.knowledgeType);
+        this.complexity = props.complexity || 'intermediate';
+        this.scope = props.scope || 'universal';
+        this.difficulty = props.difficulty || null;
+        this.tags = props.tags || [];
+        // ── Cursor 交付字段（AI 直接产出）──
+        this.trigger = props.trigger || '';
+        this.topicHint = props.topicHint || '';
+        this.whenClause = props.whenClause || '';
+        this.doClause = props.doClause || '';
+        this.dontClause = props.dontClause || '';
+        this.coreCode = props.coreCode || '';
+        this.usageGuide = props.usageGuide || '';
+        // ── 值对象 ──
+        this.content = Content.from(props.content);
+        this.relations = Relations.from(props.relations);
+        this.constraints = Constraints.from(props.constraints);
+        this.reasoning = Reasoning.from(props.reasoning);
+        this.quality = Quality.from(props.quality);
+        this.stats = Stats.from(props.stats);
+        // ── 代码头文件 (ObjC/Swift) ──
+        this.headers = props.headers || [];
+        this.headerPaths = props.headerPaths || [];
+        this.moduleName = props.moduleName || '';
+        this.includeHeaders = props.includeHeaders ?? false;
+        // ── AI 润色 ──
+        this.agentNotes = props.agentNotes || null;
+        this.aiInsight = props.aiInsight || null;
+        // ── 审核 ──
+        this.reviewedBy = props.reviewedBy || null;
+        this.reviewedAt = props.reviewedAt || null;
+        this.rejectionReason = props.rejectionReason || null;
+        // ── 来源 ──
+        this.source = props.source || 'manual';
+        this.sourceFile = props.sourceFile || null;
+        this.sourceCandidateId = props.sourceCandidateId || null;
+        // ── 时间 ──
+        this.createdBy = props.createdBy || 'system';
+        this.createdAt = props.createdAt || Math.floor(Date.now() / 1000);
+        this.updatedAt = props.updatedAt || Math.floor(Date.now() / 1000);
+        this.publishedAt = props.publishedAt || null;
+        this.publishedBy = props.publishedBy || null;
+    }
+    /* ═══ 生命周期操作 ═══════════════════════════════════ */
+    /**
+     * 发布 (pending → active)
+     * @param {string} publisher
+     * @returns {{ success: boolean, error?: string }}
+     */
+    publish(publisher) {
+        if (!this.isValid()) {
+            return { success: false, error: '内容不完整，无法发布' };
+        }
+        const result = this._transition(Lifecycle.ACTIVE);
+        if (result.success) {
+            this.publishedAt = this._now();
+            this.publishedBy = publisher;
+        }
+        return result;
+    }
+    /**
+     * 弃用 (pending|active → deprecated)
+     * @param {string} reason
+     * @returns {{ success: boolean, error?: string }}
+     */
+    deprecate(reason) {
+        const result = this._transition(Lifecycle.DEPRECATED);
+        if (result.success) {
+            this.rejectionReason = reason;
+        }
+        return result;
+    }
+    /**
+     * 重新激活 (deprecated → pending)
+     * @returns {{ success: boolean, error?: string }}
+     */
+    reactivate() {
+        const result = this._transition(Lifecycle.PENDING);
+        if (result.success) {
+            this.rejectionReason = null;
+        }
+        return result;
+    }
+    /* ═══ 谓词 ═══════════════════════════════════════════ */
+    /**
+     * 是否处于候选阶段
+     * @returns {boolean}
+     */
+    isCandidate() {
+        return isLifecycleCandidate(this.lifecycle);
+    }
+    /**
+     * 是否可被 Guard/Search/Export 消费
+     * @returns {boolean}
+     */
+    isActive() {
+        return this.lifecycle === Lifecycle.ACTIVE;
+    }
+    /**
+     * 是否为 Guard 规则类型
+     * @returns {boolean}
+     */
+    isRule() {
+        return this.kind === 'rule';
+    }
+    /**
+     * 内容是否有效
+     * @returns {boolean}
+     */
+    isValid() {
+        return !!(this.title?.trim() && this.content.hasContent());
+    }
+    /* ═══ Guard 消费 ═══════════════════════════════════ */
+    /**
+     * 返回此 Entry 中可被 GuardCheckEngine 消费的规则列表
+     * @returns {Array<Object>}
+     */
+    getGuardRules() {
+        if (!this.isActive() || !this.isRule()) {
+            return [];
+        }
+        const regexRules = this.constraints.getRegexGuards().map((g) => ({
+            id: g.id || this.id,
+            type: 'regex',
+            name: g.message || this.title,
+            message: g.message || this.description || this.title,
+            pattern: g.pattern,
+            languages: this.language ? [this.language] : [],
+            severity: g.severity || 'warning',
+            source: 'knowledge_entry',
+            fixSuggestion: g.fix_suggestion || null,
+        }));
+        const astRules = this.constraints.getAstGuards().map((g) => ({
+            id: g.id || `${this.id}:ast`,
+            type: 'ast',
+            name: g.message || this.title,
+            message: g.message,
+            astQuery: g.ast_query,
+            languages: g.ast_query?.language ? [g.ast_query.language] : [],
+            severity: g.severity || 'warning',
+            source: 'knowledge_entry',
+            fixSuggestion: g.fix_suggestion || null,
+        }));
+        return [...regexRules, ...astRules];
+    }
+    /* ═══ 系统标签 ═══════════════════════════════════ */
+    /** 系统内部标签前缀 — 内部元数据，不应暴露给最终用户 */
+    static SYSTEM_TAG_PREFIXES = ['dimension:', 'bootstrap:', 'internal:', 'system:'];
+    /** 判断是否为系统内部标签 */
+    static isSystemTag(tag) {
+        return KnowledgeEntry.SYSTEM_TAG_PREFIXES.some((p) => tag.startsWith(p));
+    }
+    /* ═══ 序列化 ═══════════════════════════════════════ */
+    /**
+     * Domain → JSON (camelCase 直出，全链路统一)
+     * 注意: tags 保留原始值（含系统标签），对外 API 使用 sanitizeForAPI() 过滤
+     */
+    toJSON() {
+        return {
+            id: this.id,
+            title: this.title,
+            description: this.description,
+            lifecycle: this.lifecycle,
+            lifecycleHistory: this.lifecycleHistory,
+            autoApprovable: this.autoApprovable,
+            language: this.language,
+            category: this.category,
+            kind: this.kind,
+            knowledgeType: this.knowledgeType,
+            complexity: this.complexity,
+            scope: this.scope,
+            difficulty: this.difficulty,
+            tags: this.tags,
+            trigger: this.trigger,
+            topicHint: this.topicHint,
+            whenClause: this.whenClause,
+            doClause: this.doClause,
+            dontClause: this.dontClause,
+            coreCode: this.coreCode,
+            usageGuide: this.usageGuide,
+            content: this.content.toJSON(),
+            relations: this.relations.toJSON(),
+            constraints: this.constraints.toJSON(),
+            reasoning: this.reasoning.toJSON(),
+            quality: this.quality.toJSON(),
+            stats: this.stats.toJSON(),
+            headers: this.headers,
+            headerPaths: this.headerPaths,
+            moduleName: this.moduleName,
+            includeHeaders: this.includeHeaders,
+            agentNotes: this.agentNotes,
+            aiInsight: this.aiInsight,
+            reviewedBy: this.reviewedBy,
+            reviewedAt: this.reviewedAt,
+            rejectionReason: this.rejectionReason,
+            source: this.source,
+            sourceFile: this.sourceFile,
+            sourceCandidateId: this.sourceCandidateId,
+            createdBy: this.createdBy,
+            createdAt: this.createdAt,
+            updatedAt: this.updatedAt,
+            publishedAt: this.publishedAt,
+            publishedBy: this.publishedBy,
+        };
+    }
+    /**
+     * JSON → Domain (camelCase 直入)
+     * @param {Object} data
+     * @returns {KnowledgeEntry}
+     */
+    static fromJSON(data) {
+        if (!data) {
+            return new KnowledgeEntry();
+        }
+        return new KnowledgeEntry(data);
+    }
+    /* ═══ 私有 ═══════════════════════════════════════════ */
+    /**
+     * @param {string} to
+     * @returns {{ success: boolean, error?: string }}
+     */
+    _transition(to) {
+        if (!isValidTransition(this.lifecycle, to)) {
+            return {
+                success: false,
+                error: `Invalid lifecycle transition: ${this.lifecycle} → ${to}`,
+            };
+        }
+        this.lifecycleHistory.push({
+            from: this.lifecycle,
+            to,
+            at: this._now(),
+        });
+        this.lifecycle = to;
+        this.updatedAt = this._now();
+        return { success: true };
+    }
+    /** @returns {number} */
+    _now() {
+        return Math.floor(Date.now() / 1000);
+    }
+}
+export default KnowledgeEntry;
+//# sourceMappingURL=KnowledgeEntry.js.map

package/dist/lib/domain/knowledge/KnowledgeEntry.js.map

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

package/dist/lib/domain/knowledge/KnowledgeRepository.d.ts

@@ -0,0 +1,36 @@
+import type KnowledgeEntry from './KnowledgeEntry.js';
+export interface PaginationOptions {
+    page?: number;
+    pageSize?: number;
+}
+export interface PaginatedResult {
+    data: KnowledgeEntry[];
+    pagination: Record<string, unknown>;
+}
+/**
+ * KnowledgeRepository — 统一知识实体仓储接口
+ *
+ * 替代 CandidateRepository + RecipeRepository。
+ * 实现类见 lib/repository/knowledge/KnowledgeRepository.impl.js
+ */
+export declare class KnowledgeRepository {
+    create(entry: KnowledgeEntry): Promise<KnowledgeEntry>;
+    findById(id: string): Promise<KnowledgeEntry | null>;
+    findWithPagination(filters?: Record<string, unknown>, options?: PaginationOptions & {
+        orderBy?: string;
+        order?: string;
+    }): Promise<PaginatedResult>;
+    findByLifecycle(lifecycle: string, pagination?: PaginationOptions): Promise<PaginatedResult>;
+    findByKind(kind: string, options?: PaginationOptions & {
+        lifecycle?: string;
+    }): Promise<PaginatedResult>;
+    findActiveRules(): Promise<KnowledgeEntry[]>;
+    findByLanguage(language: string, pagination?: PaginationOptions): Promise<PaginatedResult>;
+    findByCategory(category: string, pagination?: PaginationOptions): Promise<PaginatedResult>;
+    search(keyword: string, pagination?: PaginationOptions): Promise<PaginatedResult>;
+    update(id: string, updates: Record<string, unknown>): Promise<KnowledgeEntry>;
+    delete(id: string): Promise<boolean>;
+    getStats(): Promise<Record<string, unknown>>;
+}
+export default KnowledgeRepository;
+//# sourceMappingURL=KnowledgeRepository.d.ts.map

package/dist/lib/domain/knowledge/KnowledgeRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnowledgeRepository.d.ts","sourceRoot":"","sources":["../../../../lib/domain/knowledge/KnowledgeRepository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED;;;;;GAKG;AACH,qBAAa,mBAAmB;IACxB,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAItD,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAIpD,kBAAkB,CACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,CAAC,EAAE,iBAAiB,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACjE,OAAO,CAAC,eAAe,CAAC;IAIrB,eAAe,CACnB,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,iBAAiB,GAC7B,OAAO,CAAC,eAAe,CAAC;IAIrB,UAAU,CACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,iBAAiB,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACnD,OAAO,CAAC,eAAe,CAAC;IAIrB,eAAe,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAI5C,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IAI1F,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IAI1F,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IAIjF,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;IAI7E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAGnD;AAED,eAAe,mBAAmB,CAAC"}