specmem-hardwicksoftware 3.5.99

package/dist/startup/startupIndexing.js

@@ -0,0 +1,463 @@
+/**
+ * startupIndexing.ts - Automatic Indexing on MCP Server Startup
+ *
+ * FIXES THE PROBLEM: When MCP server starts, it doesn't automatically index
+ * the codebase or extract sessions. This module provides:
+ *
+ * 1. Check if codebase is indexed (or stale)
+ * 2. Check if sessions are extracted (or new ones exist)
+ * 3. Trigger background indexing/extraction when needed
+ * 4. Report progress in server logs
+ *
+ * Everything is ready when  starts, not on-demand!
+ */
+import { logger } from '../utils/logger.js';
+import { getDatabase } from '../database.js';
+import { getCodebaseIndexer } from '../codebase/codebaseIndexer.js';
+import { createSessionParser } from '../claude-sessions/sessionParser.js';
+import { getProjectContext, getProjectPathForInsert } from '../services/ProjectContext.js';
+import { loadCodebaseConfig } from '../config.js';
+const indexingStateByProject = new Map();
+function getIndexingState(projectPath) {
+    const key = projectPath || process.env['SPECMEM_PROJECT_PATH'] || '/';
+    if (!indexingStateByProject.has(key)) {
+        indexingStateByProject.set(key, {
+            indexingInProgress: false,
+            sessionExtractionInProgress: false,
+            lastIndexingCheck: null,
+            lastSessionExtractionCheck: null,
+            codebaseRetryCount: 0,
+            sessionRetryCount: 0
+        });
+    }
+    return indexingStateByProject.get(key);
+}
+// HIGH-24 FIX: Retry configuration for background indexing
+const RETRY_CONFIG = {
+    maxRetries: 3,
+    initialDelayMs: 1000, // 1 second
+    maxDelayMs: 30000, // 30 seconds
+    backoffMultiplier: 2
+};
+/**
+ * HIGH-24 FIX: Execute with exponential backoff retry
+ * Prevents silent failures and provides proper retry mechanism
+ */
+async function executeWithRetry(operation, operationName, retryCountRef, maxRetries = RETRY_CONFIG.maxRetries) {
+    let lastError = null;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            retryCountRef.count = attempt;
+            if (attempt > 0) {
+                const delay = Math.min(RETRY_CONFIG.initialDelayMs * Math.pow(RETRY_CONFIG.backoffMultiplier, attempt - 1), RETRY_CONFIG.maxDelayMs);
+                logger.info({ attempt, delay, operationName }, `Retry attempt ${attempt}/${maxRetries} after ${delay}ms`);
+                await new Promise(resolve => setTimeout(resolve, delay));
+            }
+            const result = await operation();
+            if (attempt > 0) {
+                logger.info({ attempt, operationName }, `${operationName} succeeded after ${attempt} retries`);
+            }
+            retryCountRef.count = 0;
+            return result;
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err : new Error(String(err));
+            logger.warn({ err: lastError, attempt, maxRetries, operationName }, `${operationName} failed (attempt ${attempt + 1}/${maxRetries + 1})`);
+        }
+    }
+    logger.error({ err: lastError, operationName, attempts: maxRetries + 1 }, `${operationName} failed after ${maxRetries + 1} attempts`);
+    retryCountRef.count = 0;
+    return null;
+}
+/**
+ * Check if codebase has been indexed for this project
+ * Returns stats about the current index state
+ */
+export async function checkCodebaseIndexStatus(db) {
+    const projectPath = getProjectContext().getProjectPath();
+    try {
+        // Count indexed files for this project
+        const result = await db.query(`SELECT COUNT(*)::TEXT as count, MAX(last_indexed) as max_indexed
+       FROM codebase_files
+       WHERE project_path = $1`, [projectPath]);
+        const fileCount = parseInt(result.rows[0]?.count || '0', 10);
+        const lastIndexed = result.rows[0]?.max_indexed || null;
+        // Check if index is stale (older than 24 hours)
+        const isStale = lastIndexed
+            ? (Date.now() - new Date(lastIndexed).getTime()) > 24 * 60 * 60 * 1000
+            : true;
+        const isIndexed = fileCount > 0;
+        const needsReindex = !isIndexed || isStale;
+        logger.info({
+            projectPath,
+            fileCount,
+            lastIndexed: lastIndexed?.toISOString() || 'never',
+            isIndexed,
+            isStale,
+            needsReindex
+        }, 'Codebase index status check');
+        return { isIndexed, fileCount, lastIndexed, needsReindex };
+    }
+    catch (error) {
+        logger.warn({ error, projectPath }, 'Failed to check codebase index status');
+        return { isIndexed: false, fileCount: 0, lastIndexed: null, needsReindex: true };
+    }
+}
+/**
+ * Check if  sessions have been extracted
+ * Returns stats about extracted sessions
+ */
+export async function checkSessionExtractionStatus(db) {
+    const projectPath = getProjectContext().getProjectPath();
+    try {
+        // Count sessions for this project with claude-session tag
+        const result = await db.query(`SELECT COUNT(*)::TEXT as count, MAX(created_at) as max_created
+       FROM memories
+       WHERE 'claude-session' = ANY(tags)
+         AND project_path = $1`, [projectPath]);
+        const sessionCount = parseInt(result.rows[0]?.count || '0', 10);
+        const lastExtraction = result.rows[0]?.max_created || null;
+        // Check if extraction is stale (older than 1 hour) or never done
+        const isStale = lastExtraction
+            ? (Date.now() - new Date(lastExtraction).getTime()) > 60 * 60 * 1000
+            : true;
+        const hasExtractedSessions = sessionCount > 0;
+        const needsExtraction = !hasExtractedSessions || isStale;
+        logger.info({
+            projectPath,
+            sessionCount,
+            lastExtraction: lastExtraction?.toISOString() || 'never',
+            hasExtractedSessions,
+            isStale,
+            needsExtraction
+        }, 'Session extraction status check');
+        return { hasExtractedSessions, sessionCount, lastExtraction, needsExtraction };
+    }
+    catch (error) {
+        logger.warn({ error, projectPath }, 'Failed to check session extraction status');
+        return { hasExtractedSessions: false, sessionCount: 0, lastExtraction: null, needsExtraction: true };
+    }
+}
+/**
+ * Trigger background codebase indexing
+ * Runs asynchronously and logs progress
+ */
+export async function triggerBackgroundIndexing(embeddingProvider, options = {}) {
+    const state = getIndexingState();
+    if (state.indexingInProgress) {
+        logger.info('Background indexing already in progress, skipping');
+        return;
+    }
+    const codebaseConfig = loadCodebaseConfig();
+    if (!codebaseConfig.enabled) {
+        logger.debug('Codebase indexer disabled, skipping background indexing');
+        return;
+    }
+    state.indexingInProgress = true;
+    state.lastIndexingCheck = new Date();
+    try {
+        const db = getDatabase();
+        // Check if indexing is needed
+        if (!options.force) {
+            const status = await checkCodebaseIndexStatus(db);
+            if (!status.needsReindex) {
+                logger.info({
+                    fileCount: status.fileCount,
+                    lastIndexed: status.lastIndexed
+                }, 'Codebase already indexed and up-to-date, skipping background indexing');
+                state.indexingInProgress = false;
+                return;
+            }
+        }
+        if (!options.silent) {
+            logger.info('Starting background codebase indexing...');
+            // Write to stderr for visibility in  Code CLI
+            process.stderr.write('[SpecMem] Starting background codebase indexing...\n');
+        }
+        // Import caching provider to wrap embedding provider
+        const { CachingEmbeddingProvider } = await import('../mcp/toolRegistry.js');
+        const cachingProvider = new CachingEmbeddingProvider(embeddingProvider);
+        // Get or create indexer
+        const indexer = getCodebaseIndexer({
+            codebasePath: codebaseConfig.codebasePath,
+            excludePatterns: codebaseConfig.excludePatterns,
+            watchForChanges: false, // Don't start watcher during background indexing
+            generateEmbeddings: true
+        }, cachingProvider, db);
+        // Run the parallel scan (optimized for speed)
+        const startTime = Date.now();
+        const stats = await indexer.initialize();
+        const duration = Date.now() - startTime;
+        if (!options.silent) {
+            const msg = `[SpecMem] Codebase indexed: ${stats.totalFiles} files, ${stats.totalLines} lines in ${Math.round(duration / 1000)}s`;
+            logger.info({
+                totalFiles: stats.totalFiles,
+                totalLines: stats.totalLines,
+                durationMs: duration,
+                filesWithEmbeddings: stats.filesWithEmbeddings
+            }, 'Background codebase indexing complete');
+            process.stderr.write(msg + '\n');
+        }
+    }
+    catch (error) {
+        logger.error({ error }, 'Background codebase indexing failed');
+        if (!options.silent) {
+            process.stderr.write(`[SpecMem] Codebase indexing failed: ${error instanceof Error ? error.message : String(error)}\n`);
+        }
+    }
+    finally {
+        state.indexingInProgress = false;
+    }
+}
+/**
+ * Trigger background session extraction
+ * Extracts  Code sessions asynchronously
+ */
+export async function triggerBackgroundSessionExtraction(embeddingProvider, options = {}) {
+    const state = getIndexingState();
+    if (state.sessionExtractionInProgress) {
+        logger.info('Session extraction already in progress, skipping');
+        return;
+    }
+    // Check if session watcher is enabled
+    const sessionWatcherEnabled = process.env['SPECMEM_SESSION_WATCHER_ENABLED'] !== 'false' &&
+        process.env['SPECMEM_SESSION_WATCHER_ENABLED'] !== '0';
+    if (!sessionWatcherEnabled) {
+        logger.debug('Session watcher disabled, skipping background extraction');
+        return;
+    }
+    state.sessionExtractionInProgress = true;
+    state.lastSessionExtractionCheck = new Date();
+    try {
+        const db = getDatabase();
+        // Check if extraction is needed
+        if (!options.force) {
+            const status = await checkSessionExtractionStatus(db);
+            if (!status.needsExtraction) {
+                logger.info({
+                    sessionCount: status.sessionCount,
+                    lastExtraction: status.lastExtraction
+                }, 'Sessions already extracted and recent, skipping background extraction');
+                state.sessionExtractionInProgress = false;
+                return;
+            }
+        }
+        if (!options.silent) {
+            logger.info('Starting background session extraction...');
+            process.stderr.write('[SpecMem] Starting background session extraction...\n');
+        }
+        const startTime = Date.now();
+        const mode = options.mode || 'new';
+        // Create session parser
+        const parser = createSessionParser();
+        // Get sessions based on mode
+        let sessions;
+        if (mode === 'all' || options.force) {
+            sessions = await parser.parseAllSessions();
+        }
+        else {
+            const lastTimestamp = await parser.getLastProcessedTimestamp(db);
+            sessions = await parser.parseNewEntries(lastTimestamp);
+        }
+        if (sessions.length === 0) {
+            if (!options.silent) {
+                logger.info('No new sessions to extract');
+                process.stderr.write('[SpecMem] No new sessions to extract\n');
+            }
+            state.sessionExtractionInProgress = false;
+            return;
+        }
+        // Convert to memory params
+        const memoryParams = parser.convertToMemoryParams(sessions, {
+            importance: 'medium',
+            additionalTags: []
+        });
+        // Get existing entryIds to avoid duplicates
+        const existingResult = await db.query(`SELECT metadata->>'entryId' as entry_id
+       FROM memories
+       WHERE 'claude-session' = ANY(tags)`);
+        const existingIds = new Set(existingResult.rows.map(r => r.entry_id).filter(Boolean));
+        // Filter out already-extracted entries
+        const newMemories = memoryParams.filter(m => {
+            const entryId = m.metadata?.entryId;
+            return !entryId || !existingIds.has(entryId);
+        });
+        if (newMemories.length === 0) {
+            if (!options.silent) {
+                logger.info('All sessions already extracted');
+                process.stderr.write('[SpecMem] All sessions already extracted\n');
+            }
+            state.sessionExtractionInProgress = false;
+            return;
+        }
+        // Store memories in batches - larger batches with batch embedding API
+        // Task #38 FIX: Wrap batch operations in transactions to prevent partial failures
+        const BATCH_SIZE = 100;
+        let stored = 0;
+        let failed = 0;
+        for (let i = 0; i < newMemories.length; i += BATCH_SIZE) {
+            const batch = newMemories.slice(i, i + BATCH_SIZE);
+            const texts = batch.map(m => m.content);
+            // Generate embeddings using BATCH API - 5-10x faster!
+            // FIX: Add timeout to prevent hanging if embedding server isn't ready
+            // FIX: Increased from 30s to 60s to allow time for model loading on first request
+            const EMBEDDING_TIMEOUT_MS = 60000; // 60 second timeout per batch
+            let embeddings;
+            try {
+                const embeddingPromise = embeddingProvider.generateEmbeddingsBatch
+                    ? embeddingProvider.generateEmbeddingsBatch(texts)
+                    : Promise.all(texts.map(t => embeddingProvider.generateEmbedding(t)));
+                // Race against timeout
+                embeddings = await Promise.race([
+                    embeddingPromise,
+                    new Promise((_, reject) => setTimeout(() => reject(new Error('Embedding timeout - server may not be ready')), EMBEDDING_TIMEOUT_MS))
+                ]);
+            }
+            catch (batchError) {
+                const isTimeout = batchError instanceof Error && batchError.message.includes('timeout');
+                if (isTimeout) {
+                    // Embedding server not ready - skip this batch but don't fail silently
+                    logger.warn({ batchIndex: Math.floor(i / BATCH_SIZE), batchSize: batch.length }, 'Embedding timeout - server not ready, skipping batch. Will retry on next startup.');
+                    failed += batch.length;
+                    continue; // Skip to next batch instead of blocking forever
+                }
+                logger.warn({ error: batchError }, 'Batch embedding failed, trying individual with timeout');
+                try {
+                    // Try individual calls with timeout
+                    embeddings = await Promise.race([
+                        Promise.all(texts.map(t => embeddingProvider.generateEmbedding(t))),
+                        new Promise((_, reject) => setTimeout(() => reject(new Error('Individual embedding timeout')), EMBEDDING_TIMEOUT_MS * 2))
+                    ]);
+                }
+                catch (individualError) {
+                    logger.warn({ error: individualError }, 'Individual embedding also failed/timed out, skipping batch');
+                    failed += batch.length;
+                    continue;
+                }
+            }
+            // Task #38 FIX: Insert memories with embeddings inside a transaction
+            // This ensures either ALL memories in the batch are stored or NONE (atomic)
+            const projectPathForInsert = getProjectPathForInsert();
+            try {
+                const batchStored = await db.transaction(async (client) => {
+                    let batchCount = 0;
+                    for (let j = 0; j < batch.length; j++) {
+                        const memory = batch[j];
+                        const embedding = embeddings[j];
+                        await client.query(`INSERT INTO memories (
+                id, content, embedding, memory_type, importance, tags, metadata,
+                project_path, created_at, updated_at
+              ) VALUES (
+                gen_random_uuid(), $1, $2, $3, $4, $5, $6,
+                $7, NOW(), NOW()
+              )`, [
+                            memory.content,
+                            JSON.stringify(embedding),
+                            memory.memoryType || 'episodic',
+                            memory.importance || 'medium',
+                            memory.tags || [],
+                            JSON.stringify(memory.metadata || {}),
+                            projectPathForInsert
+                        ]);
+                        batchCount++;
+                    }
+                    return batchCount;
+                });
+                stored += batchStored;
+            }
+            catch (error) {
+                // Entire batch failed - transaction rolled back, DB is consistent
+                logger.warn({ error, batchSize: batch.length, batchIndex: Math.floor(i / BATCH_SIZE) }, 'Failed to store session memory batch - transaction rolled back');
+                failed += batch.length;
+            }
+            // Progress update
+            const progress = Math.min(i + BATCH_SIZE, newMemories.length);
+            if (!options.silent && progress % 100 === 0) {
+                process.stderr.write('[SpecMem] Session extraction progress: ' + progress + '/' + newMemories.length + '\n');
+            }
+        }
+        const duration = Date.now() - startTime;
+        if (!options.silent) {
+            const msg = `[SpecMem] Sessions extracted: ${stored} stored, ${failed} failed in ${Math.round(duration / 1000)}s`;
+            logger.info({
+                stored,
+                failed,
+                total: newMemories.length,
+                durationMs: duration
+            }, 'Background session extraction complete');
+            process.stderr.write(msg + '\n');
+        }
+    }
+    catch (error) {
+        logger.error({ error }, 'Background session extraction failed');
+        if (!options.silent) {
+            process.stderr.write(`[SpecMem] Session extraction failed: ${error instanceof Error ? error.message : String(error)}\n`);
+        }
+    }
+    finally {
+        state.sessionExtractionInProgress = false;
+    }
+}
+/**
+ * Run startup indexing checks and trigger background tasks
+ * This is called from main() after MCP connection is established
+ */
+export async function runStartupIndexing(embeddingProvider, options = {}) {
+    logger.info('Running startup indexing checks...');
+    process.stderr.write('[SpecMem] Checking if indexing needed...\n');
+    const db = getDatabase();
+    const result = {
+        codebaseStatus: { wasIndexed: false, triggeredIndexing: false },
+        sessionStatus: { wasExtracted: false, triggeredExtraction: false }
+    };
+    // Check and trigger codebase indexing
+    if (!options.skipCodebase) {
+        const codebaseStatus = await checkCodebaseIndexStatus(db);
+        result.codebaseStatus.wasIndexed = codebaseStatus.isIndexed;
+        if (codebaseStatus.needsReindex || options.force) {
+            result.codebaseStatus.triggeredIndexing = true;
+            // HIGH-24 FIX: Run in background with retry mechanism instead of fire-and-forget
+            // Use setImmediate to not block the startup flow, but track with retry
+            setImmediate(() => {
+                const retryRef = { count: 0 };
+                executeWithRetry(() => triggerBackgroundIndexing(embeddingProvider, { force: options.force }), 'Background codebase indexing', retryRef).catch(err => {
+                    logger.error({ err }, 'Background codebase indexing failed after all retries');
+                });
+            });
+        }
+    }
+    // Check and trigger session extraction
+    if (!options.skipSessions) {
+        const sessionStatus = await checkSessionExtractionStatus(db);
+        result.sessionStatus.wasExtracted = sessionStatus.hasExtractedSessions;
+        if (sessionStatus.needsExtraction || options.force) {
+            result.sessionStatus.triggeredExtraction = true;
+            // HIGH-24 FIX: Run in background with retry mechanism instead of fire-and-forget
+            // Use setImmediate to not block the startup flow, but track with retry
+            setImmediate(() => {
+                const retryRef = { count: 0 };
+                executeWithRetry(() => triggerBackgroundSessionExtraction(embeddingProvider, { force: options.force }), 'Background session extraction', retryRef).catch(err => {
+                    logger.error({ err }, 'Background session extraction failed after all retries');
+                });
+            });
+        }
+    }
+    logger.info({
+        codebase: result.codebaseStatus,
+        sessions: result.sessionStatus
+    }, 'Startup indexing checks complete');
+    return result;
+}
+/**
+ * Get current indexing status for dashboard/status queries
+ */
+export function getIndexingStatus(projectPath) {
+    const state = getIndexingState(projectPath);
+    return {
+        codebaseIndexing: state.indexingInProgress,
+        sessionExtraction: state.sessionExtractionInProgress,
+        lastCodebaseCheck: state.lastIndexingCheck,
+        lastSessionCheck: state.lastSessionExtractionCheck
+    };
+}
+//# sourceMappingURL=startupIndexing.js.map

package/dist/startup/startupIndexing.js.map

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

package/dist/startup/validation.d.ts

@@ -0,0 +1,89 @@
+/**
+ * SpecMem Startup Validation
+ *
+ * Pre-flight checks to catch issues early before MCP transport connects.
+ * Validates:
+ * - Socket directories exist and are writable
+ * - Database connection works
+ * - Required environment variables are set
+ *
+ * CRITICAL: These checks must be FAST (< 100ms total) to not delay MCP connection.
+ * Heavy validation (like DB schema checks) is deferred to after transport connects.
+ */
+export declare const EXIT_CODES: {
+    readonly SUCCESS: 0;
+    readonly GENERAL_ERROR: 1;
+    readonly ENV_VAR_MISSING: 2;
+    readonly SOCKET_DIR_ERROR: 3;
+    readonly SOCKET_DIR_NOT_WRITABLE: 4;
+    readonly DATABASE_CONNECTION_ERROR: 5;
+    readonly DATABASE_EXTENSION_ERROR: 6;
+    readonly CONFIG_ERROR: 7;
+    readonly PERMISSION_ERROR: 8;
+};
+export type ExitCode = typeof EXIT_CODES[keyof typeof EXIT_CODES];
+export interface ValidationError {
+    code: ExitCode;
+    message: string;
+    details?: string;
+    suggestion?: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: string[];
+    duration: number;
+}
+export interface ValidationOptions {
+    /** Check socket directories (fast) */
+    checkSocketDirs?: boolean;
+    /** Check environment variables (fast) */
+    checkEnvVars?: boolean;
+    /** Check database connection (slower, ~1-3s) */
+    checkDatabase?: boolean;
+    /** Check database extensions (requires DB connection) */
+    checkDatabaseExtensions?: boolean;
+    /** Timeout for database connection check in ms */
+    dbTimeoutMs?: number;
+    /** Log validation progress to startup log */
+    logProgress?: boolean;
+}
+/**
+ * Validate database credentials format and existence.
+ * Fail fast with clear error if credentials are invalid format.
+ *
+ * TASK #21 FIX: Early validation of DB creds before connection attempt.
+ * Exported for use by DatabaseManager and other modules that need early validation.
+ */
+export declare function validateDatabaseCredentials(): {
+    errors: ValidationError[];
+    warnings: string[];
+};
+/**
+ * Run pre-flight validation checks before MCP transport connects.
+ *
+ * @param options Validation options
+ * @returns Validation result with any errors and warnings
+ */
+export declare function runStartupValidation(options?: ValidationOptions): Promise<ValidationResult>;
+/**
+ * Format validation errors for console output.
+ * Uses colors and clear formatting for readability.
+ */
+export declare function formatValidationErrors(result: ValidationResult): string;
+/**
+ * Run validation and exit if errors are found.
+ * Used for blocking validation before MCP connects.
+ */
+export declare function validateOrExit(options?: ValidationOptions): Promise<void>;
+/**
+ * Quick validation that doesn't block startup.
+ * Returns result for logging/monitoring without exiting.
+ */
+export declare function quickValidation(): Promise<ValidationResult>;
+/**
+ * Full validation including database.
+ * Use after MCP transport is connected.
+ */
+export declare function fullValidation(): Promise<ValidationResult>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/startup/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/startup/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,eAAO,MAAM,UAAU;;;;;;;;;;CAUb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,OAAO,UAAU,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAMlE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,yCAAyC;IACzC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gDAAgD;IAChD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yDAAyD;IACzD,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AA4ED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,IAAI;IAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAiF/F;AA6SD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAuD3B;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAkDvE;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+B/E;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAOjE;AAED;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAShE"}