qnce-engine 0.1.0 → 1.2.0

package/dist/performance/HotReloadDelta.js.map

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

package/dist/performance/ObjectPool.d.ts

@@ -0,0 +1,150 @@
+export interface Poolable {
+    reset(): void;
+    isInUse(): boolean;
+    setInUse(inUse: boolean): void;
+}
+export interface PoolableConstructor<T extends Poolable> {
+    new (): T;
+}
+/**
+ * Generic Object Pool for QNCE narrative objects
+ * Reduces GC pressure by reusing objects instead of creating new ones
+ */
+export declare class ObjectPool<T extends Poolable> {
+    private pool;
+    private createFn;
+    private maxSize;
+    private created;
+    private borrowed;
+    private returned;
+    constructor(createFn: () => T, initialSize?: number, maxSize?: number);
+    /**
+     * Borrow an object from the pool
+     */
+    borrow(): T;
+    /**
+     * Return an object to the pool
+     */
+    return(obj: T): void;
+    /**
+     * Get pool statistics for monitoring
+     */
+    getStats(): {
+        poolSize: number;
+        maxSize: number;
+        created: number;
+        borrowed: number;
+        returned: number;
+        inUse: number;
+        hitRate: number;
+    };
+    /**
+     * Clear the pool (useful for testing)
+     */
+    clear(): void;
+    /**
+     * Resize the pool
+     */
+    resize(newSize: number): void;
+}
+/**
+ * Pooled Flow object for narrative state management
+ */
+export declare class PooledFlow implements Poolable {
+    private _inUse;
+    nodeId: string;
+    timestamp: number;
+    metadata: Record<string, unknown>;
+    transitions: string[];
+    constructor();
+    reset(): void;
+    isInUse(): boolean;
+    setInUse(inUse: boolean): void;
+    initialize(nodeId: string, metadata?: Record<string, unknown>): void;
+    addTransition(fromNodeId: string, toNodeId: string): void;
+    getDuration(): number;
+}
+/**
+ * Pooled Node object for narrative content
+ */
+export declare class PooledNode implements Poolable {
+    private _inUse;
+    id: string;
+    text: string;
+    choices: unknown[];
+    flags: Record<string, unknown>;
+    lastAccessed: number;
+    constructor();
+    reset(): void;
+    isInUse(): boolean;
+    setInUse(inUse: boolean): void;
+    initialize(id: string, text: string, choices?: unknown[]): void;
+    touch(): void;
+}
+/**
+ * Pooled Asset object for narrative resources
+ */
+export declare class PooledAsset implements Poolable {
+    private _inUse;
+    id: string;
+    type: string;
+    data: unknown;
+    size: number;
+    loaded: boolean;
+    constructor();
+    reset(): void;
+    isInUse(): boolean;
+    setInUse(inUse: boolean): void;
+    initialize(id: string, type: string, data: unknown): void;
+    private calculateSize;
+}
+/**
+ * Pool Manager - Centralized management of all object pools
+ */
+export declare class PoolManager {
+    private static instance;
+    private flowPool;
+    private nodePool;
+    private assetPool;
+    private constructor();
+    static getInstance(): PoolManager;
+    borrowFlow(): PooledFlow;
+    returnFlow(flow: PooledFlow): void;
+    borrowNode(): PooledNode;
+    returnNode(node: PooledNode): void;
+    borrowAsset(): PooledAsset;
+    returnAsset(asset: PooledAsset): void;
+    getAllStats(): {
+        flows: {
+            poolSize: number;
+            maxSize: number;
+            created: number;
+            borrowed: number;
+            returned: number;
+            inUse: number;
+            hitRate: number;
+        };
+        nodes: {
+            poolSize: number;
+            maxSize: number;
+            created: number;
+            borrowed: number;
+            returned: number;
+            inUse: number;
+            hitRate: number;
+        };
+        assets: {
+            poolSize: number;
+            maxSize: number;
+            created: number;
+            borrowed: number;
+            returned: number;
+            inUse: number;
+            hitRate: number;
+        };
+    };
+    getGCPressureReduction(): number;
+    clearAllPools(): void;
+}
+export declare const poolManager: PoolManager;
+//# sourceMappingURL=ObjectPool.d.ts.map

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

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

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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"}