cmp-standards 2.6.0 → 2.8.0-alpha

package/dist/cache/EmbeddingCache.d.ts

@@ -0,0 +1,109 @@
+/**
+ * @file EmbeddingCache - LRU cache for embeddings in cmp-standards v2.8
+ * @description High-performance caching layer to reduce embedding API calls
+ *
+ * Performance targets:
+ * - Cache hit: <10ms (vs 200-500ms API call)
+ * - Memory efficient with LRU eviction
+ * - Thread-safe for concurrent access
+ */
+export interface CacheEntry {
+    /** The embedding vector */
+    vector: number[];
+    /** Expiration timestamp */
+    expires: number;
+    /** Number of times this entry was accessed */
+    hits: number;
+    /** When this entry was created */
+    createdAt: number;
+    /** Last access timestamp */
+    lastAccessedAt: number;
+    /** Original text (for debugging) */
+    textHash: string;
+}
+export interface EmbeddingCacheConfig {
+    /** Maximum number of entries in cache */
+    maxSize: number;
+    /** Time-to-live in milliseconds (default: 24 hours) */
+    ttl: number;
+    /** Enable debug logging */
+    debug: boolean;
+    /** Minimum text length to cache (skip very short texts) */
+    minTextLength: number;
+}
+export interface CacheStats {
+    /** Total number of entries */
+    size: number;
+    /** Cache hit count */
+    hits: number;
+    /** Cache miss count */
+    misses: number;
+    /** Hit rate (0-1) */
+    hitRate: number;
+    /** Total memory estimate in bytes */
+    memoryEstimate: number;
+    /** Average entry age in ms */
+    avgAge: number;
+}
+export declare class EmbeddingCache {
+    private cache;
+    private config;
+    private stats;
+    constructor(config?: Partial<EmbeddingCacheConfig>);
+    /**
+     * Generate a hash key for the text
+     */
+    private hash;
+    /**
+     * Get embedding from cache if available and not expired
+     */
+    get(text: string): number[] | null;
+    /**
+     * Store embedding in cache
+     */
+    set(text: string, vector: number[]): void;
+    /**
+     * Check if text is cached (without updating access stats)
+     */
+    has(text: string): boolean;
+    /**
+     * Evict the least recently used entry
+     */
+    private evictLRU;
+    /**
+     * Remove expired entries
+     */
+    cleanup(): number;
+    /**
+     * Get cache statistics
+     */
+    getStats(): CacheStats;
+    /**
+     * Clear all entries
+     */
+    clear(): void;
+    /**
+     * Get current size
+     */
+    get size(): number;
+    /**
+     * Get all cached keys (for debugging)
+     */
+    keys(): string[];
+}
+/**
+ * Get or create the global EmbeddingCache instance
+ */
+export declare function getEmbeddingCache(config?: Partial<EmbeddingCacheConfig>): EmbeddingCache;
+/**
+ * Reset the global cache (useful for testing)
+ */
+export declare function resetEmbeddingCache(): void;
+export type EmbeddingProvider = (text: string) => Promise<number[]>;
+/**
+ * Create a cached version of an embedding function
+ * @param provider The underlying embedding provider
+ * @param config Cache configuration
+ */
+export declare function createCachedEmbedding(provider: EmbeddingProvider, config?: Partial<EmbeddingCacheConfig>): EmbeddingProvider;
+//# sourceMappingURL=EmbeddingCache.d.ts.map

package/dist/cache/EmbeddingCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmbeddingCache.d.ts","sourceRoot":"","sources":["../../src/cache/EmbeddingCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,MAAM,WAAW,UAAU;IACzB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAA;IACjB,4BAA4B;IAC5B,cAAc,EAAE,MAAM,CAAA;IACtB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAA;IACf,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAA;IACX,2BAA2B;IAC3B,KAAK,EAAE,OAAO,CAAA;IACd,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,qCAAqC;IACrC,cAAc,EAAE,MAAM,CAAA;IACtB,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAA;CACf;AAiBD,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,KAAK,CAAyB;gBAE1B,MAAM,GAAE,OAAO,CAAC,oBAAoB,CAAM;IAItD;;OAEG;IACH,OAAO,CAAC,IAAI;IAIZ;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAsClC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IA6BzC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAiB1B;;OAEG;IACH,OAAO,CAAC,QAAQ;IAsBhB;;OAEG;IACH,OAAO,IAAI,MAAM;IAkBjB;;OAEG;IACH,QAAQ,IAAI,UAAU;IAuBtB;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;CAGjB;AAQD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,cAAc,CAKxF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAK1C;AAMD,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;AAEnE;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACrC,iBAAiB,CAkBnB"}

package/dist/cache/EmbeddingCache.js

@@ -0,0 +1,239 @@
+/**
+ * @file EmbeddingCache - LRU cache for embeddings in cmp-standards v2.8
+ * @description High-performance caching layer to reduce embedding API calls
+ *
+ * Performance targets:
+ * - Cache hit: <10ms (vs 200-500ms API call)
+ * - Memory efficient with LRU eviction
+ * - Thread-safe for concurrent access
+ */
+import { createHash } from 'crypto';
+// =============================================================================
+// Configuration
+// =============================================================================
+const DEFAULT_CONFIG = {
+    maxSize: 1000,
+    ttl: 24 * 60 * 60 * 1000, // 24 hours
+    debug: false,
+    minTextLength: 10,
+};
+// =============================================================================
+// EmbeddingCache Implementation
+// =============================================================================
+export class EmbeddingCache {
+    cache = new Map();
+    config;
+    stats = { hits: 0, misses: 0 };
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Generate a hash key for the text
+     */
+    hash(text) {
+        return createHash('md5').update(text.trim().toLowerCase()).digest('hex');
+    }
+    /**
+     * Get embedding from cache if available and not expired
+     */
+    get(text) {
+        if (text.length < this.config.minTextLength) {
+            return null;
+        }
+        const key = this.hash(text);
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.stats.misses++;
+            if (this.config.debug) {
+                console.log(`[EmbeddingCache] MISS: ${key.substring(0, 8)}...`);
+            }
+            return null;
+        }
+        // Check expiration
+        if (Date.now() > entry.expires) {
+            this.cache.delete(key);
+            this.stats.misses++;
+            if (this.config.debug) {
+                console.log(`[EmbeddingCache] EXPIRED: ${key.substring(0, 8)}...`);
+            }
+            return null;
+        }
+        // Update access stats
+        entry.hits++;
+        entry.lastAccessedAt = Date.now();
+        this.stats.hits++;
+        if (this.config.debug) {
+            console.log(`[EmbeddingCache] HIT: ${key.substring(0, 8)}... (${entry.hits} hits)`);
+        }
+        return entry.vector;
+    }
+    /**
+     * Store embedding in cache
+     */
+    set(text, vector) {
+        if (text.length < this.config.minTextLength) {
+            return;
+        }
+        // Evict if at capacity
+        if (this.cache.size >= this.config.maxSize) {
+            this.evictLRU();
+        }
+        const key = this.hash(text);
+        const now = Date.now();
+        const entry = {
+            vector,
+            expires: now + this.config.ttl,
+            hits: 0,
+            createdAt: now,
+            lastAccessedAt: now,
+            textHash: key,
+        };
+        this.cache.set(key, entry);
+        if (this.config.debug) {
+            console.log(`[EmbeddingCache] SET: ${key.substring(0, 8)}... (size: ${this.cache.size})`);
+        }
+    }
+    /**
+     * Check if text is cached (without updating access stats)
+     */
+    has(text) {
+        if (text.length < this.config.minTextLength) {
+            return false;
+        }
+        const key = this.hash(text);
+        const entry = this.cache.get(key);
+        if (!entry)
+            return false;
+        if (Date.now() > entry.expires) {
+            this.cache.delete(key);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Evict the least recently used entry
+     */
+    evictLRU() {
+        let oldestKey = '';
+        let oldestAccess = Infinity;
+        for (const [key, entry] of this.cache) {
+            // Combine last access time with hit count for eviction decision
+            // Lower score = more likely to evict
+            const score = entry.lastAccessedAt + (entry.hits * 1000);
+            if (score < oldestAccess) {
+                oldestAccess = score;
+                oldestKey = key;
+            }
+        }
+        if (oldestKey) {
+            this.cache.delete(oldestKey);
+            if (this.config.debug) {
+                console.log(`[EmbeddingCache] EVICT: ${oldestKey.substring(0, 8)}...`);
+            }
+        }
+    }
+    /**
+     * Remove expired entries
+     */
+    cleanup() {
+        const now = Date.now();
+        let removed = 0;
+        for (const [key, entry] of this.cache) {
+            if (now > entry.expires) {
+                this.cache.delete(key);
+                removed++;
+            }
+        }
+        if (this.config.debug && removed > 0) {
+            console.log(`[EmbeddingCache] CLEANUP: Removed ${removed} expired entries`);
+        }
+        return removed;
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        const now = Date.now();
+        let totalAge = 0;
+        let memoryEstimate = 0;
+        for (const entry of this.cache.values()) {
+            totalAge += now - entry.createdAt;
+            // Estimate: 4 bytes per float * vector length + overhead
+            memoryEstimate += entry.vector.length * 4 + 100;
+        }
+        const totalRequests = this.stats.hits + this.stats.misses;
+        return {
+            size: this.cache.size,
+            hits: this.stats.hits,
+            misses: this.stats.misses,
+            hitRate: totalRequests > 0 ? this.stats.hits / totalRequests : 0,
+            memoryEstimate,
+            avgAge: this.cache.size > 0 ? totalAge / this.cache.size : 0,
+        };
+    }
+    /**
+     * Clear all entries
+     */
+    clear() {
+        this.cache.clear();
+        this.stats = { hits: 0, misses: 0 };
+        if (this.config.debug) {
+            console.log('[EmbeddingCache] CLEARED');
+        }
+    }
+    /**
+     * Get current size
+     */
+    get size() {
+        return this.cache.size;
+    }
+    /**
+     * Get all cached keys (for debugging)
+     */
+    keys() {
+        return Array.from(this.cache.keys());
+    }
+}
+// =============================================================================
+// Singleton Instance
+// =============================================================================
+let globalCache = null;
+/**
+ * Get or create the global EmbeddingCache instance
+ */
+export function getEmbeddingCache(config) {
+    if (!globalCache) {
+        globalCache = new EmbeddingCache(config);
+    }
+    return globalCache;
+}
+/**
+ * Reset the global cache (useful for testing)
+ */
+export function resetEmbeddingCache() {
+    if (globalCache) {
+        globalCache.clear();
+    }
+    globalCache = null;
+}
+/**
+ * Create a cached version of an embedding function
+ * @param provider The underlying embedding provider
+ * @param config Cache configuration
+ */
+export function createCachedEmbedding(provider, config) {
+    const cache = getEmbeddingCache(config);
+    return async (text) => {
+        // Try cache first
+        const cached = cache.get(text);
+        if (cached) {
+            return cached;
+        }
+        // Call provider
+        const vector = await provider(text);
+        // Cache result
+        cache.set(text, vector);
+        return vector;
+    };
+}
+//# sourceMappingURL=EmbeddingCache.js.map

package/dist/cache/EmbeddingCache.js.map

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

package/dist/cache/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @file Cache Module - cmp-standards v2.8
+ * @description High-performance caching for embeddings and other expensive operations
+ */
+export { EmbeddingCache, EmbeddingCacheConfig, CacheEntry, CacheStats, getEmbeddingCache, resetEmbeddingCache, createCachedEmbedding, EmbeddingProvider, } from './EmbeddingCache.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,qBAAqB,CAAA"}

package/dist/cache/index.js

@@ -0,0 +1,6 @@
+/**
+ * @file Cache Module - cmp-standards v2.8
+ * @description High-performance caching for embeddings and other expensive operations
+ */
+export { EmbeddingCache, getEmbeddingCache, resetEmbeddingCache, createCachedEmbedding, } from './EmbeddingCache.js';
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,cAAc,EAId,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,GAEtB,MAAM,qBAAqB,CAAA"}

package/dist/db/turso-client.js

@@ -60,16 +60,16 @@ export async function setupTursoSchema() {
     try {
         const db = getTurso();
         // Tabla principal de items (similar a DEV_Items en MySQL)
-        await db.execute(`
-      CREATE TABLE IF NOT EXISTS items (
-        id TEXT PRIMARY KEY,
-        type TEXT NOT NULL,
-        status TEXT NOT NULL DEFAULT 'pending',
-        system TEXT NOT NULL,
-        content TEXT NOT NULL,
-        created_at TEXT NOT NULL DEFAULT (datetime('now')),
-        updated_at TEXT NOT NULL DEFAULT (datetime('now'))
-      )
+        await db.execute(`
+      CREATE TABLE IF NOT EXISTS items (
+        id TEXT PRIMARY KEY,
+        type TEXT NOT NULL,
+        status TEXT NOT NULL DEFAULT 'pending',
+        system TEXT NOT NULL,
+        content TEXT NOT NULL,
+        created_at TEXT NOT NULL DEFAULT (datetime('now')),
+        updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+      )
     `);
         // Índices para queries comunes
         await db.execute(`CREATE INDEX IF NOT EXISTS idx_items_type ON items(type)`);
@@ -95,7 +95,7 @@ export async function create(type, system, content, status = 'pending') {
         const id = ulid();
         const now = new Date().toISOString();
         await db.execute({
-            sql: `INSERT INTO items (id, type, status, system, content, created_at, updated_at)
+            sql: `INSERT INTO items (id, type, status, system, content, created_at, updated_at)
             VALUES (?, ?, ?, ?, ?, ?, ?)`,
             args: [id, type, status, system, JSON.stringify(content), now, now]
         });

package/dist/eslint/rules/no-async-useeffect.js

@@ -14,12 +14,12 @@ const rule = {
         },
         messages: {
             noAsyncUseEffect: 'useEffect callback cannot be async. Create an inner async function and call it.',
-            suggestion: `
-useEffect(() => {
-  const fetchData = async () => {
-    // your async code
-  };
-  fetchData();
+            suggestion: `
+useEffect(() => {
+  const fetchData = async () => {
+    // your async code
+  };
+  fetchData();
 }, []);`,
         },
         schema: [],

package/dist/events/EventBus.d.ts

@@ -0,0 +1,87 @@
+/**
+ * @file EventBus - In-memory event bus for cmp-standards v2.8
+ * @description Decoupled event-driven architecture for expert panel orchestration
+ *
+ * Features:
+ * - Type-safe event publishing and subscribing
+ * - Parallel handler execution with Promise.allSettled
+ * - Event history for debugging
+ * - Handler timeout protection
+ * - Correlation ID tracking for request tracing
+ */
+import { Event, EventType, EventHandler } from './types.js';
+export interface EventBusConfig {
+    /** Maximum events to keep in history */
+    historyLimit: number;
+    /** Handler execution timeout in ms */
+    handlerTimeout: number;
+    /** Enable debug logging */
+    debug: boolean;
+}
+export declare class EventBus {
+    private handlers;
+    private history;
+    private config;
+    constructor(config?: Partial<EventBusConfig>);
+    /**
+     * Subscribe to an event type
+     * @returns Unsubscribe function
+     */
+    subscribe<T extends EventType>(eventType: T, handler: EventHandler<Extract<Event, {
+        type: T;
+    }>>): () => void;
+    /**
+     * Publish an event to all subscribers
+     * Handlers are executed in parallel with timeout protection
+     */
+    publish<T extends Event>(event: T): Promise<{
+        success: boolean;
+        handlerResults: PromiseSettledResult<void>[];
+        duration: number;
+    }>;
+    /**
+     * Publish and wait for all handlers, throwing on any failure
+     */
+    publishStrict<T extends Event>(event: T): Promise<void>;
+    /**
+     * Execute handler with timeout protection
+     */
+    private executeWithTimeout;
+    /**
+     * Add event to history with limit enforcement
+     */
+    private addToHistory;
+    /**
+     * Get event history, optionally filtered by type
+     */
+    getHistory(type?: EventType): Event[];
+    /**
+     * Get events by correlation ID (for request tracing)
+     */
+    getByCorrelationId(correlationId: string): Event[];
+    /**
+     * Clear all handlers and history
+     */
+    clear(): void;
+    /**
+     * Get handler count for a specific event type
+     */
+    getHandlerCount(type: EventType): number;
+    /**
+     * Check if there are any handlers for an event type
+     */
+    hasHandlers(type: EventType): boolean;
+}
+/**
+ * Get or create the global EventBus instance
+ */
+export declare function getEventBus(config?: Partial<EventBusConfig>): EventBus;
+/**
+ * Reset the global EventBus (useful for testing)
+ */
+export declare function resetEventBus(): void;
+/**
+ * Create and publish an event in one call
+ */
+export declare function emitEvent(eventData: Omit<Event, 'metadata'>, source: string, correlationId?: string): Promise<void>;
+//# sourceMappingURL=EventBus.d.ts.map

package/dist/events/EventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.d.ts","sourceRoot":"","sources":["../../src/events/EventBus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,KAAK,EACL,SAAS,EACT,YAAY,EAGb,MAAM,YAAY,CAAA;AAMnB,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAA;IACpB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAA;IACtB,2BAA2B;IAC3B,KAAK,EAAE,OAAO,CAAA;CACf;AAYD,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM;IAIhD;;;OAGG;IACH,SAAS,CAAC,CAAC,SAAS,SAAS,EAC3B,SAAS,EAAE,CAAC,EACZ,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC,GACjD,MAAM,IAAI;IAyBb;;;OAGG;IACG,OAAO,CAAC,CAAC,SAAS,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC;QAChD,OAAO,EAAE,OAAO,CAAA;QAChB,cAAc,EAAE,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAA;QAC5C,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAC;IA+CF;;OAEG;IACG,aAAa,CAAC,CAAC,SAAS,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAe7D;;OAEG;YACW,kBAAkB;IAqBhC;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,UAAU,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,KAAK,EAAE;IAKrC;;OAEG;IACH,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,KAAK,EAAE;IAMlD;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM;IAIxC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO;CAGtC;AAQD;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,QAAQ,CAKtE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAMD;;GAEG;AACH,wBAAsB,SAAS,CAC7B,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,EAClC,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CAQf"}