qnce-engine 0.1.0 → 1.2.0

package/dist/performance/PerfReporter.js

@@ -0,0 +1,281 @@
+"use strict";
+// S2-T4: Profiler Event Instrumentation
+// PerfReporter for batched performance event collection and reporting
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.perf = exports.PerfReporter = void 0;
+exports.getPerfReporter = getPerfReporter;
+exports.shutdownPerfReporter = shutdownPerfReporter;
+/**
+ * PerfReporter - Batched performance event collection and analysis
+ * Designed to work off main thread for minimal performance impact
+ */
+class PerfReporter {
+    events = [];
+    config;
+    flushTimer = null;
+    startTime;
+    activeSpans = new Map();
+    constructor(config = {}) {
+        this.config = {
+            batchSize: config.batchSize || 100,
+            flushInterval: config.flushInterval || 5000, // 5 seconds
+            enableBackgroundFlush: config.enableBackgroundFlush !== false,
+            maxEventHistory: config.maxEventHistory || 1000,
+            enableConsoleOutput: config.enableConsoleOutput || false
+        };
+        this.startTime = performance.now();
+        if (this.config.enableBackgroundFlush) {
+            this.startFlushTimer();
+        }
+    }
+    /**
+     * Record a performance event
+     */
+    record(type, metadata = {}, category = 'engine') {
+        const event = {
+            id: this.generateEventId(),
+            type,
+            timestamp: performance.now(),
+            metadata,
+            category
+        };
+        this.events.push(event);
+        if (this.config.enableConsoleOutput) {
+            console.log(`[PERF] ${type}:`, metadata);
+        }
+        // Auto-flush if batch size reached
+        if (this.events.length >= this.config.batchSize) {
+            this.flush();
+        }
+        return event.id;
+    }
+    /**
+     * Start a performance span (for measuring duration)
+     */
+    startSpan(type, metadata = {}, category = 'engine') {
+        const spanId = this.generateEventId();
+        const event = {
+            id: spanId,
+            type,
+            timestamp: performance.now(),
+            metadata: { ...metadata, spanStart: true },
+            category
+        };
+        this.activeSpans.set(spanId, event);
+        return spanId;
+    }
+    /**
+     * End a performance span and record the complete event
+     */
+    endSpan(spanId, additionalMetadata = {}) {
+        const startEvent = this.activeSpans.get(spanId);
+        if (!startEvent) {
+            console.warn(`[PERF] Span ${spanId} not found`);
+            return;
+        }
+        const endTime = performance.now();
+        const duration = endTime - startEvent.timestamp;
+        const completeEvent = {
+            ...startEvent,
+            duration,
+            metadata: {
+                ...startEvent.metadata,
+                ...additionalMetadata,
+                spanEnd: true
+            }
+        };
+        this.events.push(completeEvent);
+        this.activeSpans.delete(spanId);
+        if (this.config.enableConsoleOutput) {
+            console.log(`[PERF] ${startEvent.type} completed in ${duration.toFixed(2)}ms`);
+        }
+        // Auto-flush if batch size reached
+        if (this.events.length >= this.config.batchSize) {
+            this.flush();
+        }
+    }
+    /**
+     * Record flow start event (S2-T4 requirement)
+     */
+    recordFlowStart(nodeId, metadata = {}) {
+        return this.startSpan('flow-start', { nodeId, ...metadata }, 'engine');
+    }
+    /**
+     * Record flow completion event (S2-T4 requirement)
+     */
+    recordFlowComplete(spanId, nextNodeId, metadata = {}) {
+        this.endSpan(spanId, { nextNodeId, ...metadata });
+    }
+    /**
+     * Record cache hit event (S2-T4 requirement)
+     */
+    recordCacheHit(cacheKey, metadata = {}) {
+        return this.record('cache-hit', { cacheKey, ...metadata }, 'cache');
+    }
+    /**
+     * Record cache miss event (S2-T4 requirement)
+     */
+    recordCacheMiss(cacheKey, metadata = {}) {
+        return this.record('cache-miss', { cacheKey, ...metadata }, 'cache');
+    }
+    /**
+     * Record hot-reload start event (S2-T4 requirement)
+     */
+    recordHotReloadStart(deltaSize, metadata = {}) {
+        return this.startSpan('hot-reload-start', { deltaSize, ...metadata }, 'hot-reload');
+    }
+    /**
+     * Record hot-reload completion event (S2-T4 requirement)
+     */
+    recordHotReloadEnd(spanId, success, metadata = {}) {
+        this.endSpan(spanId, { success, ...metadata });
+    }
+    /**
+     * Generate performance summary for CLI dashboard
+     */
+    summary() {
+        const now = performance.now();
+        const eventsByType = {};
+        const durationsByType = {};
+        let cacheHits = 0;
+        let cacheMisses = 0;
+        let hotReloads = [];
+        // Analyze events
+        for (const event of this.events) {
+            // Count events by type
+            eventsByType[event.type] = (eventsByType[event.type] || 0) + 1;
+            // Collect durations
+            if (event.duration !== undefined) {
+                if (!durationsByType[event.type]) {
+                    durationsByType[event.type] = [];
+                }
+                durationsByType[event.type].push(event.duration);
+            }
+            // Cache metrics
+            if (event.type === 'cache-hit')
+                cacheHits++;
+            if (event.type === 'cache-miss')
+                cacheMisses++;
+            // Hot-reload metrics
+            if (event.type === 'hot-reload-start' && event.duration !== undefined) {
+                hotReloads.push(event.duration);
+            }
+        }
+        // Calculate averages, mins, maxs
+        const avgDurations = {};
+        const maxDurations = {};
+        const minDurations = {};
+        for (const [type, durations] of Object.entries(durationsByType)) {
+            if (durations.length > 0) {
+                avgDurations[type] = durations.reduce((sum, d) => sum + d, 0) / durations.length;
+                maxDurations[type] = Math.max(...durations);
+                minDurations[type] = Math.min(...durations);
+            }
+        }
+        // Cache hit rate
+        const totalCacheEvents = cacheHits + cacheMisses;
+        const cacheHitRate = totalCacheEvents > 0 ? (cacheHits / totalCacheEvents) * 100 : 0;
+        // Hot-reload performance
+        const hotReloadPerformance = {
+            avgTime: hotReloads.length > 0 ? hotReloads.reduce((sum, d) => sum + d, 0) / hotReloads.length : 0,
+            maxTime: hotReloads.length > 0 ? Math.max(...hotReloads) : 0,
+            totalReloads: hotReloads.length
+        };
+        return {
+            totalEvents: this.events.length,
+            eventsByType,
+            avgDurations,
+            maxDurations,
+            minDurations,
+            cacheHitRate,
+            hotReloadPerformance,
+            timeRange: {
+                start: this.startTime,
+                end: now,
+                duration: now - this.startTime
+            }
+        };
+    }
+    /**
+     * Get raw events for detailed analysis
+     */
+    getEvents() {
+        return [...this.events];
+    }
+    /**
+     * Clear event history
+     */
+    clear() {
+        this.events.length = 0;
+        this.activeSpans.clear();
+        this.startTime = performance.now();
+    }
+    /**
+     * Flush events to background processing
+     */
+    flush() {
+        if (this.events.length === 0)
+            return;
+        // TODO: Body - integrate with ThreadPool for background processing
+        // For now, just maintain event history with size limit
+        if (this.events.length > this.config.maxEventHistory) {
+            const excess = this.events.length - this.config.maxEventHistory;
+            this.events.splice(0, excess);
+        }
+        if (this.config.enableConsoleOutput) {
+            console.log(`[PERF] Flushed ${this.events.length} events`);
+        }
+    }
+    /**
+     * Start automatic flush timer
+     */
+    startFlushTimer() {
+        this.flushTimer = setInterval(() => {
+            this.flush();
+        }, this.config.flushInterval);
+    }
+    /**
+     * Stop automatic flush timer
+     */
+    stopFlushTimer() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+    }
+    /**
+     * Generate unique event ID
+     */
+    generateEventId() {
+        return `perf-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+    }
+}
+exports.PerfReporter = PerfReporter;
+// Singleton instance for global access
+let globalPerfReporter = null;
+function getPerfReporter(config) {
+    if (!globalPerfReporter) {
+        globalPerfReporter = new PerfReporter(config);
+    }
+    return globalPerfReporter;
+}
+function shutdownPerfReporter() {
+    if (globalPerfReporter) {
+        globalPerfReporter.stopFlushTimer();
+        globalPerfReporter.flush();
+        globalPerfReporter = null;
+    }
+}
+// Convenience functions for common operations
+exports.perf = {
+    flowStart: (nodeId, metadata) => getPerfReporter().recordFlowStart(nodeId, metadata),
+    flowComplete: (spanId, nextNodeId, metadata) => getPerfReporter().recordFlowComplete(spanId, nextNodeId, metadata),
+    cacheHit: (cacheKey, metadata) => getPerfReporter().recordCacheHit(cacheKey, metadata),
+    cacheMiss: (cacheKey, metadata) => getPerfReporter().recordCacheMiss(cacheKey, metadata),
+    hotReloadStart: (deltaSize, metadata) => getPerfReporter().recordHotReloadStart(deltaSize, metadata),
+    hotReloadEnd: (spanId, success, metadata) => getPerfReporter().recordHotReloadEnd(spanId, success, metadata),
+    record: (type, metadata, category) => getPerfReporter().record(type, metadata, category),
+    summary: () => getPerfReporter().summary(),
+    clear: () => getPerfReporter().clear()
+};
+//# sourceMappingURL=PerfReporter.js.map

package/dist/performance/PerfReporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerfReporter.js","sourceRoot":"","sources":["../../src/performance/PerfReporter.ts"],"names":[],"mappings":";AAAA,wCAAwC;AACxC,sEAAsE;;;AA6UtE,0CAKC;AAED,oDAMC;AApTD;;;GAGG;AACH,MAAa,YAAY;IACf,MAAM,GAAgB,EAAE,CAAC;IACzB,MAAM,CAAqB;IAC3B,UAAU,GAAQ,IAAI,CAAC;IACvB,SAAS,CAAS;IAClB,WAAW,GAA2B,IAAI,GAAG,EAAE,CAAC;IAExD,YAAY,SAAsC,EAAE;QAClD,IAAI,CAAC,MAAM,GAAG;YACZ,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,GAAG;YAClC,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,IAAI,EAAE,YAAY;YACzD,qBAAqB,EAAE,MAAM,CAAC,qBAAqB,KAAK,KAAK;YAC7D,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,IAAI;YAC/C,mBAAmB,EAAE,MAAM,CAAC,mBAAmB,IAAI,KAAK;SACzD,CAAC;QAEF,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAEnC,IAAI,IAAI,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC;YACtC,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,IAAuB,EACvB,WAAoC,EAAE,EACtC,WAAkC,QAAQ;QAE1C,MAAM,KAAK,GAAc;YACvB,EAAE,EAAE,IAAI,CAAC,eAAe,EAAE;YAC1B,IAAI;YACJ,SAAS,EAAE,WAAW,CAAC,GAAG,EAAE;YAC5B,QAAQ;YACR,QAAQ;SACT,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAExB,IAAI,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC3C,CAAC;QAED,mCAAmC;QACnC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAChD,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;QAED,OAAO,KAAK,CAAC,EAAE,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,SAAS,CACP,IAAuB,EACvB,WAAoC,EAAE,EACtC,WAAkC,QAAQ;QAE1C,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACtC,MAAM,KAAK,GAAc;YACvB,EAAE,EAAE,MAAM;YACV,IAAI;YACJ,SAAS,EAAE,WAAW,CAAC,GAAG,EAAE;YAC5B,QAAQ,EAAE,EAAE,GAAG,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE;YAC1C,QAAQ;SACT,CAAC;QAEF,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACpC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,MAAc,EAAE,qBAA8C,EAAE;QACtE,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,eAAe,MAAM,YAAY,CAAC,CAAC;YAChD,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC;QAEhD,MAAM,aAAa,GAAc;YAC/B,GAAG,UAAU;YACb,QAAQ;YACR,QAAQ,EAAE;gBACR,GAAG,UAAU,CAAC,QAAQ;gBACtB,GAAG,kBAAkB;gBACrB,OAAO,EAAE,IAAI;aACd;SACF,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAChC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAEhC,IAAI,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,UAAU,UAAU,CAAC,IAAI,iBAAiB,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACjF,CAAC;QAED,mCAAmC;QACnC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAChD,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,MAAc,EAAE,WAAoC,EAAE;QACpE,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,EAAE,QAAQ,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,MAAc,EAAE,UAAkB,EAAE,WAAoC,EAAE;QAC3F,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,QAAgB,EAAE,WAAoC,EAAE;QACrE,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,QAAgB,EAAE,WAAoC,EAAE;QACtE,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,SAAiB,EAAE,WAAoC,EAAE;QAC5E,OAAO,IAAI,CAAC,SAAS,CAAC,kBAAkB,EAAE,EAAE,SAAS,EAAE,GAAG,QAAQ,EAAE,EAAE,YAAY,CAAC,CAAC;IACtF,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,MAAc,EAAE,OAAgB,EAAE,WAAoC,EAAE;QACzF,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,OAAO;QACL,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAC9B,MAAM,YAAY,GAA2B,EAAE,CAAC;QAChD,MAAM,eAAe,GAA6B,EAAE,CAAC;QAErD,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,UAAU,GAAa,EAAE,CAAC;QAE9B,iBAAiB;QACjB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,uBAAuB;YACvB,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAE/D,oBAAoB;YACpB,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACjC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBACjC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACnC,CAAC;gBACD,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACnD,CAAC;YAED,gBAAgB;YAChB,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;gBAAE,SAAS,EAAE,CAAC;YAC5C,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;gBAAE,WAAW,EAAE,CAAC;YAE/C,qBAAqB;YACrB,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACtE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAED,iCAAiC;QACjC,MAAM,YAAY,GAA2B,EAAE,CAAC;QAChD,MAAM,YAAY,GAA2B,EAAE,CAAC;QAChD,MAAM,YAAY,GAA2B,EAAE,CAAC;QAEhD,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;YAChE,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,YAAY,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC;gBACjF,YAAY,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;gBAC5C,YAAY,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QAED,iBAAiB;QACjB,MAAM,gBAAgB,GAAG,SAAS,GAAG,WAAW,CAAC;QACjD,MAAM,YAAY,GAAG,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,gBAAgB,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAErF,yBAAyB;QACzB,MAAM,oBAAoB,GAAG;YAC3B,OAAO,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAClG,OAAO,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5D,YAAY,EAAE,UAAU,CAAC,MAAM;SAChC,CAAC;QAEF,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAC/B,YAAY;YACZ,YAAY;YACZ,YAAY;YACZ,YAAY;YACZ,YAAY;YACZ,oBAAoB;YACpB,SAAS,EAAE;gBACT,KAAK,EAAE,IAAI,CAAC,SAAS;gBACrB,GAAG,EAAE,GAAG;gBACR,QAAQ,EAAE,GAAG,GAAG,IAAI,CAAC,SAAS;aAC/B;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAErC,mEAAmE;QACnE,uDAAuD;QACvD,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YACrD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC;YAChE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAChC,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,CAAC,MAAM,CAAC,MAAM,SAAS,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED;;OAEG;IACK,eAAe;QACrB,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE;YACjC,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC;IACH,CAAC;IAED;;OAEG;IACK,eAAe;QACrB,OAAO,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IACzE,CAAC;CACF;AA9RD,oCA8RC;AAED,uCAAuC;AACvC,IAAI,kBAAkB,GAAwB,IAAI,CAAC;AAEnD,SAAgB,eAAe,CAAC,MAAoC;IAClE,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,kBAAkB,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,SAAgB,oBAAoB;IAClC,IAAI,kBAAkB,EAAE,CAAC;QACvB,kBAAkB,CAAC,cAAc,EAAE,CAAC;QACpC,kBAAkB,CAAC,KAAK,EAAE,CAAC;QAC3B,kBAAkB,GAAG,IAAI,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,8CAA8C;AACjC,QAAA,IAAI,GAAG;IAClB,SAAS,EAAE,CAAC,MAAc,EAAE,QAAkC,EAAE,EAAE,CAChE,eAAe,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC;IAErD,YAAY,EAAE,CAAC,MAAc,EAAE,UAAkB,EAAE,QAAkC,EAAE,EAAE,CACvF,eAAe,EAAE,CAAC,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC;IAEpE,QAAQ,EAAE,CAAC,QAAgB,EAAE,QAAkC,EAAE,EAAE,CACjE,eAAe,EAAE,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAEtD,SAAS,EAAE,CAAC,QAAgB,EAAE,QAAkC,EAAE,EAAE,CAClE,eAAe,EAAE,CAAC,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAEvD,cAAc,EAAE,CAAC,SAAiB,EAAE,QAAkC,EAAE,EAAE,CACxE,eAAe,EAAE,CAAC,oBAAoB,CAAC,SAAS,EAAE,QAAQ,CAAC;IAE7D,YAAY,EAAE,CAAC,MAAc,EAAE,OAAgB,EAAE,QAAkC,EAAE,EAAE,CACrF,eAAe,EAAE,CAAC,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC;IAEjE,MAAM,EAAE,CAAC,IAAuB,EAAE,QAAkC,EAAE,QAAgC,EAAE,EAAE,CACxG,eAAe,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAEpD,OAAO,EAAE,GAAG,EAAE,CAAC,eAAe,EAAE,CAAC,OAAO,EAAE;IAE1C,KAAK,EAAE,GAAG,EAAE,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE;CACvC,CAAC"}

package/dist/performance/ThreadPool.d.ts

@@ -0,0 +1,107 @@
+export interface QnceJob {
+    id: string;
+    type: 'cache-load' | 'telemetry-write' | 'hot-reload-prep' | 'asset-process';
+    priority: 'low' | 'normal' | 'high';
+    payload: unknown;
+    timestamp: number;
+    resolve: (result: unknown) => void;
+    reject: (error: Error) => void;
+}
+export interface ThreadPoolConfig {
+    maxWorkers: number;
+    queueLimit: number;
+    idleTimeout: number;
+    enableProfiling: boolean;
+}
+export interface ThreadPoolStats {
+    activeWorkers: number;
+    queuedJobs: number;
+    completedJobs: number;
+    failedJobs: number;
+    avgExecutionTime: number;
+    workerUtilization: number;
+}
+/**
+ * QnceThreadPool - Background job processing for QNCE engine
+ * Handles cache operations, telemetry, and other non-blocking tasks
+ */
+export declare class QnceThreadPool {
+    private workers;
+    private jobQueue;
+    private activeJobs;
+    private config;
+    private stats;
+    private isShuttingDown;
+    constructor(config?: Partial<ThreadPoolConfig>);
+    /**
+     * Submit job for background processing
+     */
+    submitJob<T = unknown>(type: QnceJob['type'], payload: unknown, priority?: QnceJob['priority']): Promise<T>;
+    /**
+     * Cache load operation (S2-T2 primary use case)
+     */
+    loadFromCache(cacheKey: string, loader: () => Promise<unknown>): Promise<unknown>;
+    /**
+     * Telemetry write operation (S2-T2 primary use case)
+     */
+    writeTelemetry(eventData: unknown): Promise<void>;
+    /**
+     * Hot-reload preparation (integration with S2-T3)
+     */
+    prepareHotReload(deltaData: unknown): Promise<unknown>;
+    /**
+     * Get current thread pool statistics
+     */
+    getStats(): ThreadPoolStats;
+    /**
+     * Graceful shutdown of thread pool
+     */
+    shutdown(timeoutMs?: number): Promise<void>;
+    /**
+     * Initialize worker threads based on environment
+     */
+    private initializeWorkers;
+    /**
+     * Web Workers for browser environment
+     */
+    private initializeWebWorkers;
+    /**
+     * Node.js worker_threads (placeholder - would need actual implementation)
+     */
+    private initializeNodeWorkers;
+    /**
+     * Fallback simulation for testing/development
+     */
+    private initializeFallbackWorkers;
+    /**
+     * Generate Web Worker code for browser execution
+     */
+    private generateWebWorkerCode;
+    /**
+     * Setup worker message handlers
+     */
+    private setupWorkerHandlers;
+    /**
+     * Handle worker completion messages
+     */
+    private handleWorkerMessage;
+    /**
+     * Handle worker errors
+     */
+    private handleWorkerError;
+    /**
+     * Process job queue by assigning jobs to available workers
+     */
+    private processQueue;
+    /**
+     * Find insertion index for job based on priority
+     */
+    private findInsertionIndex;
+    /**
+     * Update execution time statistics
+     */
+    private updateExecutionTimeStats;
+}
+export declare function getThreadPool(config?: Partial<ThreadPoolConfig>): QnceThreadPool;
+export declare function shutdownThreadPool(): Promise<void>;
+//# sourceMappingURL=ThreadPool.d.ts.map

package/dist/performance/ThreadPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadPool.d.ts","sourceRoot":"","sources":["../../src/performance/ThreadPool.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,eAAe,CAAC;IAC7E,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,cAAc,CAAS;gBAEnB,MAAM,GAAE,OAAO,CAAC,gBAAgB,CAAM;IAoBlD;;OAEG;IACG,SAAS,CAAC,CAAC,GAAG,OAAO,EACzB,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,EACrB,OAAO,EAAE,OAAO,EAChB,QAAQ,GAAE,OAAO,CAAC,UAAU,CAAY,GACvC,OAAO,CAAC,CAAC,CAAC;IA+Bb;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvF;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD;;OAEG;IACG,gBAAgB,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5D;;OAEG;IACH,QAAQ,IAAI,eAAe;IAI3B;;OAEG;IACG,QAAQ,CAAC,SAAS,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB/C;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAezB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAiB5B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAM7B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA0BjC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAwE7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAK3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAwB3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,YAAY;IAsBpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,wBAAwB;CAQjC;AAKD,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,cAAc,CAKhF;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAOlD"}