qnce-engine 0.1.0 → 1.2.0

package/README.md

@@ -2,20 +2,56 @@
 
 **Quantum Narrative Convergence Engine** - A framework-agnostic TypeScript library for creating interactive narrative experiences with quantum-inspired mechanics.
 
+> **🚀 NEW in v1.2.0:** Advanced Branching API with AI integration, dynamic content management, and comprehensive analytics. Plus enterprise-grade performance optimization.
+
 ## Core Concepts
 
 - **Superposition:** Multiple narrative outcomes exist simultaneously until a choice is made
 - **Collapse:** Player choices "collapse" the narrative to a specific path, updating state and flags
 - **Entanglement:** Early decisions affect later outcomes, enabling complex, interconnected stories
 
+## ✨ Advanced Features (v1.2.0)
+
+### 🌿 Advanced Branching System
+- **Multi-path narratives** with conditional logic and flag-based branching
+- **AI-driven content generation** for dynamic story expansion
+- **Real-time branch insertion/removal** for live content updates
+- **Comprehensive analytics** for narrative optimization
+
+### ⚡ Performance Infrastructure
+- **🏊‍♂️ Object Pooling:** 90%+ allocation reduction, eliminating GC pressure
+- **🧵 Background Processing:** Non-blocking cache preloading and telemetry writes  
+- **🔥 Hot-Reload:** <3.5ms live story updates with delta patching
+- **📊 Real-time Profiling:** Comprehensive event instrumentation and analysis
+- **🖥️ Live Monitoring:** `qnce-perf` CLI dashboard with performance alerts
+
+### Performance Dashboard
+```bash
+# Real-time performance monitoring
+qnce-perf dashboard
+
+# Live monitoring with updates
+qnce-perf live 1000
+
+# Export performance data
+qnce-perf export > performance-report.json
+```
+
+**[📚 Complete Performance Guide →](docs/PERFORMANCE.md)**
+
 ## Installation
 
 ```bash
 npm install qnce-engine
+
+# Global CLI installation for performance monitoring
+npm install -g qnce-engine
 ```
 
 ## Quick Start
 
+### Basic Usage
+
 ```typescript
 import { createQNCEEngine, DEMO_STORY } from 'qnce-engine';
 
@@ -40,6 +76,190 @@ const flags = engine.getFlags();
 console.log('Current flags:', flags);
 ```
 
+### Performance Mode (Recommended for Production)
+
+```typescript
+import { createQNCEEngine, DEMO_STORY } from 'qnce-engine';
+
+// Enable performance optimizations
+const engine = createQNCEEngine(DEMO_STORY, {}, true, {
+  maxWorkers: 4,
+  enableProfiling: true
+});
+
+// Background cache preloading happens automatically
+// Object pooling reduces memory allocations by 90%+
+// Performance events are collected for monitoring
+
+// Get performance statistics
+const poolStats = engine.getPoolStats();
+console.log(`Pool efficiency: ${poolStats.flow.hitRate}%`);
+```
+
+### Live Performance Monitoring
+
+```bash
+# Real-time performance dashboard
+qnce-perf dashboard
+
+# Live monitoring with updates every 2 seconds  
+qnce-perf live
+
+# Export performance data
+qnce-perf export > performance-report.json
+```
+
+## 🌿 Advanced Branching & AI Integration
+
+### Basic Branching
+
+```typescript
+import { createQNCEEngine, createBranchingEngine } from 'qnce-engine';
+
+// Create core engine
+const engine = createQNCEEngine(storyData);
+
+// Enable advanced branching
+const branchingEngine = engine.enableBranching(advancedStoryData);
+
+// Evaluate available branches
+const branches = await branchingEngine.evaluateAvailableBranches();
+console.log(`Available paths: ${branches.length}`);
+
+// Execute a narrative branch
+await branchingEngine.executeBranch(branches[0].id);
+```
+
+### AI-Driven Content Generation
+
+```typescript
+// Set AI context for personalized content
+branchingEngine.setAIContext({
+  playerProfile: {
+    playStyle: 'explorer',
+    preferences: { adventure: 0.8, mystery: 0.6 },
+    historicalChoices: ['brave-path', 'investigate-clue']
+  },
+  narrativeContext: {
+    currentTone: 'mysterious',
+    thematicElements: ['exploration', 'discovery'],
+    plotTension: 0.7
+  }
+});
+
+// Generate AI-enhanced branches
+const aiBranches = await branchingEngine.generateAIBranches(3);
+console.log('AI-generated options:', aiBranches.map(b => b.displayText));
+```
+
+### Dynamic Content Management
+
+```typescript
+// Insert new branch at runtime
+const dynamicBranch = {
+  type: 'insert',
+  branchId: 'special-event',
+  targetLocation: { chapterId: 'main', nodeId: 'crossroads' },
+  payload: {
+    name: 'Special Event',
+    branchOptions: [{
+      id: 'event-choice',
+      displayText: 'Investigate the mysterious sound',
+      flagEffects: { event_discovered: true }
+    }]
+  }
+};
+
+await branchingEngine.insertDynamicBranch(dynamicBranch);
+
+// Remove branch when no longer needed
+await branchingEngine.removeDynamicBranch('special-event');
+```
+
+### Analytics & Monitoring
+
+```typescript
+// Get branching analytics
+const analytics = branchingEngine.getBranchingAnalytics();
+console.log(`Branches traversed: ${analytics.totalBranchesTraversed}`);
+console.log(`Popular choices: ${analytics.mostPopularBranches}`);
+
+// Export comprehensive data
+const exportData = branchingEngine.exportBranchingData();
+// Contains: story structure, session data, player behavior, performance metrics
+```
+
+### Live Performance Monitoring
+
+```bash
+# Real-time performance dashboard
+qnce-perf dashboard
+
+# Live monitoring with updates every 2 seconds  
+qnce-perf live
+
+# Export performance data
+qnce-perf export > performance-report.json
+```
+
+## 🚀 Performance Guide
+
+QNCE v1.2.0-sprint2 includes advanced performance infrastructure for production applications.
+
+### Performance Benchmarks
+
+| Feature | Performance Gain | Impact |
+|---------|-----------------|--------|
+| Object Pooling | 90%+ allocation reduction | Eliminates GC hitches |
+| Hot-Reload | 68% improvement (3.35ms) | Near-instant story updates |
+| Background Processing | Non-blocking operations | Smooth user experience |
+| Performance Monitoring | Real-time metrics | Production visibility |
+
+### CLI Performance Dashboard
+
+```bash
+# Install CLI globally
+npm install -g qnce-engine
+
+# Real-time performance monitoring
+qnce-perf live
+
+# Performance dashboard output:
+🚀 QNCE Performance Dashboard
+=====================================
+📊 Session Duration: 45.2s
+🔢 Total Events: 1,247
+
+💾 Cache Performance:
+   ✅ Hit Rate: 92.3% (threshold: 80%)
+   ✅ Avg Cache Time: 0.8ms (threshold: 50ms)
+
+🔥 Hot-Reload Performance:
+   ⚠️ Avg Time: 3.35ms (threshold: 2ms)
+   📊 Max Time: 4.1ms
+   🔄 Total Reloads: 12
+
+🧵 ThreadPool Status:
+   📊 Completed Jobs: 445
+   ⏳ Queued Jobs: 3
+   🏃 Active Workers: 2
+```
+
+### Performance Mode Usage
+
+```typescript
+// Enable all performance optimizations
+const engine = createQNCEEngine(storyData, {}, true, {
+  maxWorkers: 4,           // Background processing
+  enableProfiling: true    // Performance monitoring
+});
+
+// Object pooling and background caching happen automatically
+// Monitor performance in real-time with CLI dashboard
+```
+
+**📖 Complete Performance Guide:** [docs/PERFORMANCE_GUIDE.md](docs/PERFORMANCE_GUIDE.md)
+
 ## Core API
 
 ### QNCEEngine Class
@@ -190,6 +410,34 @@ async function playStory() {
 }
 ```
 
+## 📚 Examples & Demos
+
+The repository includes comprehensive examples demonstrating all features:
+
+### 🚀 Quickstart Example
+- **File:** `examples/branching-quickstart.ts`
+- **Features:** Basic branching, AI integration, dynamic operations
+- **Run:** `npm run build && node dist/examples/branching-quickstart.js`
+
+### 🎭 Advanced Demo
+- **File:** `examples/branching-advanced-demo.ts` 
+- **Features:** Complex narrative flows, conditional branching, analytics
+- **Story:** "The Mysterious Library" - Interactive mystery with multiple paths
+
+### 🧪 Validation Scripts
+- **Real-world testing:** `scripts/validation-real-world.ts`
+- **Comprehensive testing:** `scripts/validation-comprehensive.ts`
+
+```bash
+# Run the quickstart example
+npm run build
+node dist/examples/branching-quickstart.js
+
+# Run validation tests
+npm run build
+node dist/scripts/validation-real-world.js
+```
+
 ## Development
 
 ```bash

package/dist/cli/audit.js

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
-import { readFileSync } from 'fs';
-import { loadStoryData } from '../engine/core.js';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = require("fs");
+const core_js_1 = require("../engine/core.js");
 /**
  * QNCE Audit CLI Tool
  * Validates narrative structure and checks for loops, dead ends, etc.
@@ -8,8 +10,8 @@ import { loadStoryData } from '../engine/core.js';
 function auditStory(filePath) {
     try {
         console.log(`🔍 Auditing QNCE story: ${filePath}`);
-        const jsonData = JSON.parse(readFileSync(filePath, 'utf-8'));
-        const storyData = loadStoryData(jsonData);
+        const jsonData = JSON.parse((0, fs_1.readFileSync)(filePath, 'utf-8'));
+        const storyData = (0, core_js_1.loadStoryData)(jsonData);
         // Basic validation
         console.log(`📖 Story contains ${storyData.nodes.length} nodes`);
         console.log(`🚀 Initial node: ${storyData.initialNodeId}`);

package/dist/cli/audit.js.map

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

package/dist/cli/init.js

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
-import { writeFileSync, mkdirSync } from 'fs';
-import { join } from 'path';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = require("fs");
+const path_1 = require("path");
 /**
  * QNCE Init CLI Tool
  * Scaffolds a new QNCE story project
@@ -9,7 +11,7 @@ function initProject(projectName) {
     try {
         console.log(`🚀 Initializing QNCE project: ${projectName}`);
         // Create project directory
-        mkdirSync(projectName, { recursive: true });
+        (0, fs_1.mkdirSync)(projectName, { recursive: true });
         // Create basic story template
         const storyTemplate = {
             initialNodeId: 'start',
@@ -49,8 +51,8 @@ function initProject(projectName) {
             ]
         };
         // Write story file
-        const storyPath = join(projectName, 'story.json');
-        writeFileSync(storyPath, JSON.stringify(storyTemplate, null, 2));
+        const storyPath = (0, path_1.join)(projectName, 'story.json');
+        (0, fs_1.writeFileSync)(storyPath, JSON.stringify(storyTemplate, null, 2));
         // Create package.json
         const packageJson = {
             name: projectName,
@@ -64,8 +66,8 @@ function initProject(projectName) {
                 'qnce-engine': '^0.1.0'
             }
         };
-        const packagePath = join(projectName, 'package.json');
-        writeFileSync(packagePath, JSON.stringify(packageJson, null, 2));
+        const packagePath = (0, path_1.join)(projectName, 'package.json');
+        (0, fs_1.writeFileSync)(packagePath, JSON.stringify(packageJson, null, 2));
         // Create README
         const readme = `# ${projectName}
 
@@ -108,8 +110,8 @@ console.log(currentNode.text);
 
 Happy storytelling!
 `;
-        const readmePath = join(projectName, 'README.md');
-        writeFileSync(readmePath, readme);
+        const readmePath = (0, path_1.join)(projectName, 'README.md');
+        (0, fs_1.writeFileSync)(readmePath, readme);
         console.log(`✅ Project created successfully!`);
         console.log(`📁 Files created:`);
         console.log(`   - ${storyPath}`);

package/dist/cli/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":";;;AAEA,2BAA8C;AAC9C,+BAA4B;AAE5B;;;GAGG;AAEH,SAAS,WAAW,CAAC,WAAmB;IACtC,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,iCAAiC,WAAW,EAAE,CAAC,CAAC;QAE5D,2BAA2B;QAC3B,IAAA,cAAS,EAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE5C,8BAA8B;QAC9B,MAAM,aAAa,GAAG;YACpB,aAAa,EAAE,OAAO;YACtB,KAAK,EAAE;gBACL;oBACE,EAAE,EAAE,OAAO;oBACX,IAAI,EAAE,oDAAoD;oBAC1D,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,UAAU;4BAChB,UAAU,EAAE,QAAQ;4BACpB,WAAW,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;yBAC/B;qBACF;iBACF;gBACD;oBACE,EAAE,EAAE,QAAQ;oBACZ,IAAI,EAAE,wEAAwE;oBAC9E,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,kBAAkB;4BACxB,UAAU,EAAE,KAAK;4BACjB,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE;yBACrC;wBACD;4BACE,IAAI,EAAE,kBAAkB;4BACxB,UAAU,EAAE,OAAO;4BACnB,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;yBAChC;qBACF;iBACF;gBACD;oBACE,EAAE,EAAE,KAAK;oBACT,IAAI,EAAE,0DAA0D;oBAChE,OAAO,EAAE,EAAE;iBACZ;aACF;SACF,CAAC;QAEF,mBAAmB;QACnB,MAAM,SAAS,GAAG,IAAA,WAAI,EAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QAClD,IAAA,kBAAa,EAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAEjE,sBAAsB;QACtB,MAAM,WAAW,GAAG;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,OAAO;YAChB,WAAW,EAAE,8BAA8B;YAC3C,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE;gBACP,KAAK,EAAE,uBAAuB;aAC/B;YACD,YAAY,EAAE;gBACZ,aAAa,EAAE,QAAQ;aACxB;SACF,CAAC;QAEF,MAAM,WAAW,GAAG,IAAA,WAAI,EAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QACtD,IAAA,kBAAa,EAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAEjE,gBAAgB;QAChB,MAAM,MAAM,GAAG,KAAK,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwClC,CAAC;QAEE,MAAM,UAAU,GAAG,IAAA,WAAI,EAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAClD,IAAA,kBAAa,EAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAElC,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,QAAQ,SAAS,EAAE,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,QAAQ,WAAW,EAAE,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,QAAQ,UAAU,EAAE,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAElC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,kBAAkB;AAClB,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpC,IAAI,CAAC,WAAW,EAAE,CAAC;IACjB,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,WAAW,CAAC,WAAW,CAAC,CAAC"}

package/dist/cli/perf.d.ts

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+/**
+ * S2-T5: CLI Performance Dashboard
+ * QNCE Performance Monitor CLI Tool - Real-time profiler metrics and threshold alerts
+ */
+interface PerformanceThresholds {
+    maxCacheHitTime: number;
+    minCacheHitRate: number;
+    maxHotReloadTime: number;
+    maxStateTransitionTime: number;
+    maxEventBacklog: number;
+}
+/**
+ * Display comprehensive performance dashboard
+ */
+declare function displayDashboard(thresholds?: PerformanceThresholds): void;
+/**
+ * Live monitor mode - continuously update performance metrics
+ */
+declare function startLiveMonitor(intervalMs?: number, thresholds?: PerformanceThresholds): void;
+/**
+ * Export performance summary as JSON
+ */
+declare function exportSummary(): void;
+/**
+ * Reset performance counters
+ */
+declare function resetCounters(): void;
+export { displayDashboard, startLiveMonitor, exportSummary, resetCounters };
+//# sourceMappingURL=perf.d.ts.map

package/dist/cli/perf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perf.d.ts","sourceRoot":"","sources":["../../src/cli/perf.ts"],"names":[],"mappings":";AAKA;;;GAGG;AAEH,UAAU,qBAAqB;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;CACzB;AAUD;;GAEG;AACH,iBAAS,gBAAgB,CAAC,UAAU,GAAE,qBAA0C,GAAG,IAAI,CA4DtF;AAiDD;;GAEG;AACH,iBAAS,gBAAgB,CAAC,UAAU,GAAE,MAAa,EAAE,UAAU,GAAE,qBAA0C,GAAG,IAAI,CAmBjH;AAED;;GAEG;AACH,iBAAS,aAAa,IAAI,IAAI,CAY7B;AAED;;GAEG;AACH,iBAAS,aAAa,IAAI,IAAI,CAG7B;AA6ED,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC"}

package/dist/cli/perf.js

@@ -0,0 +1,219 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.displayDashboard = displayDashboard;
+exports.startLiveMonitor = startLiveMonitor;
+exports.exportSummary = exportSummary;
+exports.resetCounters = resetCounters;
+const PerfReporter_js_1 = require("../performance/PerfReporter.js");
+const ThreadPool_js_1 = require("../performance/ThreadPool.js");
+const DEFAULT_THRESHOLDS = {
+    maxCacheHitTime: 50, // 50ms max for cache operations
+    minCacheHitRate: 80, // 80% minimum cache hit rate
+    maxHotReloadTime: 2, // 2ms max for hot-reload (S2-T3 target)
+    maxStateTransitionTime: 10, // 10ms max for state transitions
+    maxEventBacklog: 1000 // Max 1000 events in backlog
+};
+/**
+ * Display comprehensive performance dashboard
+ */
+function displayDashboard(thresholds = DEFAULT_THRESHOLDS) {
+    console.log('\n🚀 QNCE Performance Dashboard');
+    console.log('=====================================');
+    const summary = PerfReporter_js_1.perf.summary();
+    const threadPool = (0, ThreadPool_js_1.getThreadPool)();
+    // Header with time range
+    const durationSeconds = (summary.timeRange.duration / 1000).toFixed(2);
+    console.log(`📊 Session Duration: ${durationSeconds}s`);
+    console.log(`🔢 Total Events: ${summary.totalEvents}`);
+    console.log('');
+    // Event breakdown
+    console.log('📈 Event Breakdown:');
+    for (const [type, count] of Object.entries(summary.eventsByType)) {
+        const avg = summary.avgDurations[type]?.toFixed(2) || 'N/A';
+        const max = summary.maxDurations[type]?.toFixed(2) || 'N/A';
+        console.log(`   ${type.padEnd(20)} ${count.toString().padStart(6)} events (avg: ${avg}ms, max: ${max}ms)`);
+    }
+    console.log('');
+    // Cache Performance
+    console.log('💾 Cache Performance:');
+    const cacheStatus = summary.cacheHitRate >= thresholds.minCacheHitRate ? '✅' : '⚠️';
+    console.log(`   ${cacheStatus} Hit Rate: ${summary.cacheHitRate.toFixed(1)}% (threshold: ${thresholds.minCacheHitRate}%)`);
+    const cacheTime = summary.avgDurations['cache-hit'] || 0;
+    const cacheTimeStatus = cacheTime <= thresholds.maxCacheHitTime ? '✅' : '⚠️';
+    console.log(`   ${cacheTimeStatus} Avg Cache Time: ${cacheTime.toFixed(2)}ms (threshold: ${thresholds.maxCacheHitTime}ms)`);
+    console.log('');
+    // Hot-Reload Performance (S2-T3 metrics)
+    console.log('🔥 Hot-Reload Performance:');
+    const { avgTime, maxTime, totalReloads } = summary.hotReloadPerformance;
+    const hotReloadStatus = avgTime <= thresholds.maxHotReloadTime ? '✅' : '⚠️';
+    console.log(`   ${hotReloadStatus} Avg Time: ${avgTime.toFixed(2)}ms (threshold: ${thresholds.maxHotReloadTime}ms)`);
+    console.log(`   📊 Max Time: ${maxTime.toFixed(2)}ms`);
+    console.log(`   🔄 Total Reloads: ${totalReloads}`);
+    console.log('');
+    // State Transition Performance
+    console.log('🔄 State Transitions:');
+    const stateTime = summary.avgDurations['state-transition'] || 0;
+    const stateStatus = stateTime <= thresholds.maxStateTransitionTime ? '✅' : '⚠️';
+    console.log(`   ${stateStatus} Avg Time: ${stateTime.toFixed(2)}ms (threshold: ${thresholds.maxStateTransitionTime}ms)`);
+    console.log('');
+    // ThreadPool Status (S2-T2 metrics)
+    console.log('🧵 ThreadPool Status:');
+    const stats = threadPool.getStats();
+    console.log(`   📊 Completed Jobs: ${stats.completedJobs}`);
+    console.log(`   ⏳ Queued Jobs: ${stats.queuedJobs}`);
+    console.log(`   🏃 Active Workers: ${stats.activeWorkers}`);
+    console.log(`   🕒 Avg Execution Time: ${stats.avgExecutionTime.toFixed(2)}ms`);
+    console.log(`   📈 Worker Utilization: ${stats.workerUtilization.toFixed(1)}%`);
+    console.log('');
+    // Performance Alerts
+    displayAlerts(summary, thresholds, stats);
+}
+/**
+ * Display performance threshold alerts
+ */
+function displayAlerts(summary, thresholds, threadStats) {
+    console.log('🚨 Performance Alerts:');
+    const alerts = [];
+    // Cache alerts
+    if (summary.cacheHitRate < thresholds.minCacheHitRate) {
+        alerts.push(`Low cache hit rate: ${summary.cacheHitRate.toFixed(1)}% < ${thresholds.minCacheHitRate}%`);
+    }
+    const cacheTime = summary.avgDurations['cache-hit'] || 0;
+    if (cacheTime > thresholds.maxCacheHitTime) {
+        alerts.push(`Slow cache operations: ${cacheTime.toFixed(2)}ms > ${thresholds.maxCacheHitTime}ms`);
+    }
+    // Hot-reload alerts (S2-T3 compliance)
+    if (summary.hotReloadPerformance.avgTime > thresholds.maxHotReloadTime) {
+        alerts.push(`Hot-reload exceeds target: ${summary.hotReloadPerformance.avgTime.toFixed(2)}ms > ${thresholds.maxHotReloadTime}ms`);
+    }
+    // State transition alerts
+    const stateTime = summary.avgDurations['state-transition'] || 0;
+    if (stateTime > thresholds.maxStateTransitionTime) {
+        alerts.push(`Slow state transitions: ${stateTime.toFixed(2)}ms > ${thresholds.maxStateTransitionTime}ms`);
+    }
+    // Event backlog alerts
+    if (summary.totalEvents > thresholds.maxEventBacklog) {
+        alerts.push(`High event backlog: ${summary.totalEvents} > ${thresholds.maxEventBacklog}`);
+    }
+    // ThreadPool alerts
+    if (threadStats.queuedJobs > 10) {
+        alerts.push(`High queued job count: ${threadStats.queuedJobs} jobs`);
+    }
+    if (alerts.length === 0) {
+        console.log('   ✅ All systems performing within thresholds');
+    }
+    else {
+        alerts.forEach(alert => console.log(`   ⚠️  ${alert}`));
+    }
+    console.log('');
+}
+/**
+ * Live monitor mode - continuously update performance metrics
+ */
+function startLiveMonitor(intervalMs = 2000, thresholds = DEFAULT_THRESHOLDS) {
+    console.log(`🔴 Starting live performance monitor (${intervalMs}ms interval)`);
+    console.log('Press Ctrl+C to stop');
+    const interval = setInterval(() => {
+        // Clear screen
+        console.clear();
+        displayDashboard(thresholds);
+        // Show live timestamp
+        console.log(`🕒 Last updated: ${new Date().toLocaleTimeString()}`);
+    }, intervalMs);
+    // Handle graceful shutdown
+    process.on('SIGINT', () => {
+        clearInterval(interval);
+        console.log('\n👋 Live monitor stopped');
+        process.exit(0);
+    });
+}
+/**
+ * Export performance summary as JSON
+ */
+function exportSummary() {
+    const summary = PerfReporter_js_1.perf.summary();
+    const threadStats = (0, ThreadPool_js_1.getThreadPool)().getStats();
+    const report = {
+        timestamp: new Date().toISOString(),
+        performanceSummary: summary,
+        threadPoolStats: threadStats,
+        thresholds: DEFAULT_THRESHOLDS
+    };
+    console.log(JSON.stringify(report, null, 2));
+}
+/**
+ * Reset performance counters
+ */
+function resetCounters() {
+    (0, PerfReporter_js_1.getPerfReporter)().clear();
+    console.log('✅ Performance counters reset');
+}
+/**
+ * Main CLI entry point
+ */
+function main() {
+    const args = process.argv.slice(2);
+    const command = args[0] || 'dashboard';
+    switch (command) {
+        case 'dashboard':
+        case 'dash':
+            displayDashboard();
+            break;
+        case 'live':
+        case 'monitor':
+            const interval = parseInt(args[1]) || 2000;
+            startLiveMonitor(interval);
+            break;
+        case 'export':
+        case 'json':
+            exportSummary();
+            break;
+        case 'reset':
+        case 'clear':
+            resetCounters();
+            break;
+        case 'help':
+        case '--help':
+        case '-h':
+            console.log(`
+🚀 QNCE Performance CLI
+
+Usage: qnce-perf [command] [options]
+
+Commands:
+  dashboard, dash     Show performance dashboard (default)
+  live, monitor       Start live monitoring mode
+  export, json        Export performance data as JSON
+  reset, clear        Reset performance counters
+  help               Show this help
+
+Options:
+  --interval <ms>     Monitoring interval for live mode (default: 2000ms)
+
+Examples:
+  qnce-perf dashboard
+  qnce-perf live 1000
+  qnce-perf export > performance-report.json
+  qnce-perf reset
+
+Performance Thresholds:
+  Cache Hit Time:      < 50ms
+  Cache Hit Rate:      > 80%
+  Hot-Reload Time:     < 2ms  (S2-T3 target)
+  State Transition:    < 10ms
+  Event Backlog:       < 1000 events
+      `);
+            break;
+        default:
+            console.error(`❌ Unknown command: ${command}`);
+            console.log('Run "qnce-perf help" for usage information');
+            process.exit(1);
+    }
+}
+// Run if called directly (ES module compatible)
+const isMainModule = require.main === module;
+if (isMainModule) {
+    main();
+}
+//# sourceMappingURL=perf.js.map

package/dist/cli/perf.js.map

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