qnce-engine 0.1.0 → 1.2.1

package/dist/performance/ObjectPool.js

@@ -0,0 +1,297 @@
+"use strict";
+// S2-T1: Object Pooling for Narrative Objects
+// Generic object pool to eliminate runtime allocations and reduce GC pressure
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.poolManager = exports.PoolManager = exports.PooledAsset = exports.PooledNode = exports.PooledFlow = exports.ObjectPool = void 0;
+/**
+ * Generic Object Pool for QNCE narrative objects
+ * Reduces GC pressure by reusing objects instead of creating new ones
+ */
+class ObjectPool {
+    pool = [];
+    createFn;
+    maxSize;
+    created = 0;
+    borrowed = 0;
+    returned = 0;
+    constructor(createFn, initialSize = 10, maxSize = 100) {
+        this.createFn = createFn;
+        this.maxSize = maxSize;
+        // Pre-populate pool
+        for (let i = 0; i < initialSize; i++) {
+            const obj = this.createFn();
+            obj.setInUse(false);
+            this.pool.push(obj);
+            this.created++;
+        }
+    }
+    /**
+     * Borrow an object from the pool
+     */
+    borrow() {
+        let obj;
+        if (this.pool.length > 0) {
+            obj = this.pool.pop();
+        }
+        else {
+            // Pool exhausted, create new object
+            obj = this.createFn();
+            this.created++;
+        }
+        obj.reset();
+        obj.setInUse(true);
+        this.borrowed++;
+        return obj;
+    }
+    /**
+     * Return an object to the pool
+     */
+    return(obj) {
+        if (!obj.isInUse()) {
+            console.warn('Attempting to return object that is not in use');
+            return;
+        }
+        obj.setInUse(false);
+        this.returned++;
+        // Only return to pool if under max size
+        if (this.pool.length < this.maxSize) {
+            this.pool.push(obj);
+        }
+        // Otherwise let GC handle it (controlled disposal)
+    }
+    /**
+     * Get pool statistics for monitoring
+     */
+    getStats() {
+        return {
+            poolSize: this.pool.length,
+            maxSize: this.maxSize,
+            created: this.created,
+            borrowed: this.borrowed,
+            returned: this.returned,
+            inUse: this.borrowed - this.returned,
+            hitRate: this.borrowed > 0 ? ((this.borrowed - this.created) / this.borrowed) * 100 : 0
+        };
+    }
+    /**
+     * Clear the pool (useful for testing)
+     */
+    clear() {
+        this.pool.forEach(obj => obj.setInUse(false));
+        this.pool.length = 0;
+        this.created = 0;
+        this.borrowed = 0;
+        this.returned = 0;
+    }
+    /**
+     * Resize the pool
+     */
+    resize(newSize) {
+        if (newSize < this.pool.length) {
+            // Shrink pool
+            this.pool.splice(newSize);
+        }
+        else if (newSize > this.pool.length) {
+            // Grow pool
+            const toAdd = newSize - this.pool.length;
+            for (let i = 0; i < toAdd && this.pool.length < this.maxSize; i++) {
+                const obj = this.createFn();
+                obj.setInUse(false);
+                this.pool.push(obj);
+                this.created++;
+            }
+        }
+    }
+}
+exports.ObjectPool = ObjectPool;
+/**
+ * Pooled Flow object for narrative state management
+ */
+class PooledFlow {
+    _inUse = false;
+    nodeId = '';
+    timestamp = 0;
+    metadata = {};
+    transitions = [];
+    constructor() {
+        this.reset();
+    }
+    reset() {
+        this.nodeId = '';
+        this.timestamp = 0;
+        this.metadata = {};
+        this.transitions.length = 0;
+    }
+    isInUse() {
+        return this._inUse;
+    }
+    setInUse(inUse) {
+        this._inUse = inUse;
+    }
+    // Flow-specific methods
+    initialize(nodeId, metadata) {
+        this.nodeId = nodeId;
+        this.timestamp = performance.now();
+        if (metadata) {
+            this.metadata = { ...metadata };
+        }
+    }
+    addTransition(fromNodeId, toNodeId) {
+        this.transitions.push(`${fromNodeId}->${toNodeId}`);
+    }
+    getDuration() {
+        return performance.now() - this.timestamp;
+    }
+}
+exports.PooledFlow = PooledFlow;
+/**
+ * Pooled Node object for narrative content
+ */
+class PooledNode {
+    _inUse = false;
+    id = '';
+    text = '';
+    choices = [];
+    flags = {};
+    lastAccessed = 0;
+    constructor() {
+        this.reset();
+    }
+    reset() {
+        this.id = '';
+        this.text = '';
+        this.choices.length = 0;
+        this.flags = {};
+        this.lastAccessed = 0;
+    }
+    isInUse() {
+        return this._inUse;
+    }
+    setInUse(inUse) {
+        this._inUse = inUse;
+    }
+    // Node-specific methods
+    initialize(id, text, choices = []) {
+        this.id = id;
+        this.text = text;
+        this.choices = [...choices];
+        this.lastAccessed = performance.now();
+    }
+    touch() {
+        this.lastAccessed = performance.now();
+    }
+}
+exports.PooledNode = PooledNode;
+/**
+ * Pooled Asset object for narrative resources
+ */
+class PooledAsset {
+    _inUse = false;
+    id = '';
+    type = '';
+    data = null;
+    size = 0;
+    loaded = false;
+    constructor() {
+        this.reset();
+    }
+    reset() {
+        this.id = '';
+        this.type = '';
+        this.data = null;
+        this.size = 0;
+        this.loaded = false;
+    }
+    isInUse() {
+        return this._inUse;
+    }
+    setInUse(inUse) {
+        this._inUse = inUse;
+    }
+    // Asset-specific methods
+    initialize(id, type, data) {
+        this.id = id;
+        this.type = type;
+        this.data = data;
+        this.size = this.calculateSize(data);
+        this.loaded = true;
+    }
+    calculateSize(data) {
+        if (typeof data === 'string') {
+            return data.length * 2; // Approximate UTF-16 size
+        }
+        if (data && typeof data === 'object') {
+            return JSON.stringify(data).length * 2;
+        }
+        return 0;
+    }
+}
+exports.PooledAsset = PooledAsset;
+/**
+ * Pool Manager - Centralized management of all object pools
+ */
+class PoolManager {
+    static instance;
+    flowPool;
+    nodePool;
+    assetPool;
+    constructor() {
+        // Initialize pools with different sizes based on expected usage
+        this.flowPool = new ObjectPool(() => new PooledFlow(), 5, 50);
+        this.nodePool = new ObjectPool(() => new PooledNode(), 20, 200);
+        this.assetPool = new ObjectPool(() => new PooledAsset(), 10, 100);
+    }
+    static getInstance() {
+        if (!PoolManager.instance) {
+            PoolManager.instance = new PoolManager();
+        }
+        return PoolManager.instance;
+    }
+    // Flow pool methods
+    borrowFlow() {
+        return this.flowPool.borrow();
+    }
+    returnFlow(flow) {
+        this.flowPool.return(flow);
+    }
+    // Node pool methods
+    borrowNode() {
+        return this.nodePool.borrow();
+    }
+    returnNode(node) {
+        this.nodePool.return(node);
+    }
+    // Asset pool methods
+    borrowAsset() {
+        return this.assetPool.borrow();
+    }
+    returnAsset(asset) {
+        this.assetPool.return(asset);
+    }
+    // Statistics and monitoring
+    getAllStats() {
+        return {
+            flows: this.flowPool.getStats(),
+            nodes: this.nodePool.getStats(),
+            assets: this.assetPool.getStats()
+        };
+    }
+    // Performance monitoring
+    getGCPressureReduction() {
+        const stats = this.getAllStats();
+        const totalHitRate = (stats.flows.hitRate +
+            stats.nodes.hitRate +
+            stats.assets.hitRate) / 3;
+        return totalHitRate;
+    }
+    // Cleanup for testing
+    clearAllPools() {
+        this.flowPool.clear();
+        this.nodePool.clear();
+        this.assetPool.clear();
+    }
+}
+exports.PoolManager = PoolManager;
+// Export singleton instance
+exports.poolManager = PoolManager.getInstance();
+//# sourceMappingURL=ObjectPool.js.map

package/dist/performance/ObjectPool.js.map

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

package/dist/performance/PerfReporter.d.ts

@@ -0,0 +1,123 @@
+export interface PerfEvent {
+    id: string;
+    type: 'flow-start' | 'flow-complete' | 'cache-hit' | 'cache-miss' | 'hot-reload-start' | 'hot-reload-end' | 'state-transition' | 'custom';
+    timestamp: number;
+    duration?: number;
+    metadata: Record<string, unknown>;
+    category: 'engine' | 'cache' | 'hot-reload' | 'user' | 'system';
+}
+export interface PerfSummary {
+    totalEvents: number;
+    eventsByType: Record<string, number>;
+    avgDurations: Record<string, number>;
+    maxDurations: Record<string, number>;
+    minDurations: Record<string, number>;
+    cacheHitRate: number;
+    hotReloadPerformance: {
+        avgTime: number;
+        maxTime: number;
+        totalReloads: number;
+    };
+    timeRange: {
+        start: number;
+        end: number;
+        duration: number;
+    };
+}
+export interface PerfReporterConfig {
+    batchSize: number;
+    flushInterval: number;
+    enableBackgroundFlush: boolean;
+    maxEventHistory: number;
+    enableConsoleOutput: boolean;
+}
+/**
+ * PerfReporter - Batched performance event collection and analysis
+ * Designed to work off main thread for minimal performance impact
+ */
+export declare class PerfReporter {
+    private events;
+    private config;
+    private flushTimer;
+    private startTime;
+    private activeSpans;
+    constructor(config?: Partial<PerfReporterConfig>);
+    /**
+     * Record a performance event
+     */
+    record(type: PerfEvent['type'], metadata?: Record<string, unknown>, category?: PerfEvent['category']): string;
+    /**
+     * Start a performance span (for measuring duration)
+     */
+    startSpan(type: PerfEvent['type'], metadata?: Record<string, unknown>, category?: PerfEvent['category']): string;
+    /**
+     * End a performance span and record the complete event
+     */
+    endSpan(spanId: string, additionalMetadata?: Record<string, unknown>): void;
+    /**
+     * Record flow start event (S2-T4 requirement)
+     */
+    recordFlowStart(nodeId: string, metadata?: Record<string, unknown>): string;
+    /**
+     * Record flow completion event (S2-T4 requirement)
+     */
+    recordFlowComplete(spanId: string, nextNodeId: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Record cache hit event (S2-T4 requirement)
+     */
+    recordCacheHit(cacheKey: string, metadata?: Record<string, unknown>): string;
+    /**
+     * Record cache miss event (S2-T4 requirement)
+     */
+    recordCacheMiss(cacheKey: string, metadata?: Record<string, unknown>): string;
+    /**
+     * Record hot-reload start event (S2-T4 requirement)
+     */
+    recordHotReloadStart(deltaSize: number, metadata?: Record<string, unknown>): string;
+    /**
+     * Record hot-reload completion event (S2-T4 requirement)
+     */
+    recordHotReloadEnd(spanId: string, success: boolean, metadata?: Record<string, unknown>): void;
+    /**
+     * Generate performance summary for CLI dashboard
+     */
+    summary(): PerfSummary;
+    /**
+     * Get raw events for detailed analysis
+     */
+    getEvents(): PerfEvent[];
+    /**
+     * Clear event history
+     */
+    clear(): void;
+    /**
+     * Flush events to background processing
+     */
+    flush(): void;
+    /**
+     * Start automatic flush timer
+     */
+    private startFlushTimer;
+    /**
+     * Stop automatic flush timer
+     */
+    stopFlushTimer(): void;
+    /**
+     * Generate unique event ID
+     */
+    private generateEventId;
+}
+export declare function getPerfReporter(config?: Partial<PerfReporterConfig>): PerfReporter;
+export declare function shutdownPerfReporter(): void;
+export declare const perf: {
+    flowStart: (nodeId: string, metadata?: Record<string, unknown>) => string;
+    flowComplete: (spanId: string, nextNodeId: string, metadata?: Record<string, unknown>) => void;
+    cacheHit: (cacheKey: string, metadata?: Record<string, unknown>) => string;
+    cacheMiss: (cacheKey: string, metadata?: Record<string, unknown>) => string;
+    hotReloadStart: (deltaSize: number, metadata?: Record<string, unknown>) => string;
+    hotReloadEnd: (spanId: string, success: boolean, metadata?: Record<string, unknown>) => void;
+    record: (type: PerfEvent["type"], metadata?: Record<string, unknown>, category?: PerfEvent["category"]) => string;
+    summary: () => PerfSummary;
+    clear: () => void;
+};
+//# sourceMappingURL=PerfReporter.d.ts.map

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

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