hedgequantx 2.9.206 → 2.9.208

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hedgequantx",
-  "version": "2.9.206",
+  "version": "2.9.208",
   "description": "HedgeQuantX - Prop Futures Trading CLI",
   "main": "src/app.js",
   "bin": {

package/src/lib/smart-logs-engine.js

@@ -38,6 +38,11 @@ class SmartLogsEngine {
     this.counter = 0;
     this.lastState = null;
     this.lastLogTime = 0;
+    // QUANT-specific state tracking for event detection
+    this.lastZRegime = null;      // 'extreme' | 'high' | 'building' | 'neutral'
+    this.lastBias = null;         // 'bullish' | 'bearish' | 'neutral'
+    this.lastVpinToxic = false;   // true if VPIN > 0.6
+    this.warmupLogged = false;    // Track if we logged warmup milestones
   }
 
   setSymbol(s) { this.symbolCode = s; }
@@ -169,74 +174,87 @@ class SmartLogsEngine {
     const events = this._detectEvents(state, this.lastState);
     this.lastState = { ...state };
 
-    // For QUANT strategy: ALWAYS use rich QUANT-specific smart-logs with metrics
-    // HQX Scalping is TICK-BASED, not bar-based - use tickCount for display
+    // For QUANT strategy: EVENT-DRIVEN logs based on regime changes
+    // Uses the same smart-logs system as HQX-2B for consistency
     if (this.strategyId === 'ultra-scalping') {
-      const timeSinceLastLog = now - this.lastLogTime;
-      const ticks = state.tickCount || state.bars || 0;  // Prefer tickCount for scalping
+      const ticks = state.tickCount || state.bars || 0;
+      const absZ = Math.abs(zScore);
+      const vpinToxic = vpin > 0.6;
       
-      // Log every 5 seconds with quant metrics
-      if (timeSinceLastLog >= CONFIG.LOG_INTERVAL_SECONDS * 1000) {
-        this.lastLogTime = now;
-        
-        // Still warming up (need ~250 ticks for QUANT models to stabilize)
-        if (ticks < 250) {
-          const d = { sym, ticks, price };
-          return {
-            type: 'system',
-            message: QUANT.building(d),
-            logToSession: this.counter % CONFIG.SESSION_LOG_INTERVAL === 0
-          };
-        }
-        
-        // Ready - use rich QUANT context messages
-        // Determine market context from QUANT metrics
-        // zScore: mean reversion indicator (-3 to +3)
-        // vpin: toxicity 0-1 (higher = more informed trading)
-        // ofi: order flow imbalance -1 to +1 (positive = buying pressure)
-        const absZ = Math.abs(zScore);
-        const ofiAbs = Math.abs(ofi);
-        const zScoreAbs = absZ.toFixed(1);
-        const vpinPct = (vpin * 100).toFixed(0);
-        const ofiPct = (ofi > 0 ? '+' : '') + (ofi * 100).toFixed(0) + '%';
-        
-        // Build data object for QUANT message pools
-        const d = { 
-          sym, price, 
-          zScore: zScore.toFixed(1), 
-          zScoreAbs, 
-          rawZScore: zScore,
-          vpin: vpinPct, 
-          ofi: ofiPct, 
-          ticks
+      // Determine current regimes
+      const zRegime = absZ >= 2.0 ? 'extreme' : absZ >= 1.5 ? 'high' : absZ >= 1.0 ? 'building' : 'neutral';
+      const bias = ofi > 0.15 ? 'bullish' : ofi < -0.15 ? 'bearish' : 'neutral';
+      
+      let event = null;
+      let logType = 'analysis';
+      let message = null;
+      
+      // EVENT 1: Warmup complete (only log once at 250 ticks)
+      if (ticks >= 250 && !this.warmupLogged) {
+        this.warmupLogged = true;
+        event = 'warmup_complete';
+        message = `[${sym}] QUANT models ready | ${ticks} ticks processed`;
+        logType = 'system';
+      }
+      // EVENT 2: Z-Score regime change (significant threshold crossing)
+      else if (this.lastZRegime !== null && zRegime !== this.lastZRegime) {
+        event = 'z_regime_change';
+        // Use smartLogs.getLiveAnalysisLog for varied contextual messages
+        const liveState = {
+          trend: bias,
+          bars: ticks,
+          swings: absZ >= 1.0 ? 1 : 0,
+          zones: absZ >= 1.5 ? 1 : 0,
+          nearZone: absZ >= 1.5,
+          setupForming: absZ >= 2.0,
         };
+        const baseMsg = smartLogs.getLiveAnalysisLog(liveState);
         
-        let logType = 'analysis';
-        let message;
-        
-        if (absZ >= 2.0) {
-          // Strong signal zone - use bull/bear messages
+        if (zRegime === 'extreme') {
           logType = 'signal';
-          message = zScore < 0 ? QUANT.bull(d) : QUANT.bear(d);
-        } else if (absZ >= 1.5) {
-          // Approaching threshold - use ready messages
+          const dir = zScore < 0 ? 'LONG' : 'SHORT';
+          message = `[${sym}] ${price} | Z: ${zScore.toFixed(1)}σ | ${dir} edge | ${baseMsg}`;
+        } else if (zRegime === 'high') {
           logType = 'signal';
-          message = QUANT.ready(d);
-        } else if (absZ >= 1.0 || ofiAbs >= 0.2) {
-          // Building edge - use zones messages
-          message = QUANT.zones(d);
+          message = `[${sym}] ${price} | Z: ${zScore.toFixed(1)}σ | ${baseMsg}`;
+        } else if (zRegime === 'building') {
+          message = `[${sym}] ${price} | Z building (${zScore.toFixed(1)}σ) | ${baseMsg}`;
         } else {
-          // Normal market - use neutral messages
-          message = QUANT.neutral(d);
+          message = `[${sym}] ${price} | Z normalized | ${baseMsg}`;
         }
-        
+      }
+      // EVENT 3: Bias flip (bullish ↔ bearish) - significant directional change
+      else if (this.lastBias !== null && bias !== this.lastBias && bias !== 'neutral' && this.lastBias !== 'neutral') {
+        event = 'bias_flip';
+        const arrow = bias === 'bullish' ? chalk.green('▲') : chalk.red('▼');
+        message = `[${sym}] ${arrow} Flow flip: ${this.lastBias} → ${bias} | OFI: ${(ofi * 100).toFixed(0)}%`;
+      }
+      // EVENT 4: VPIN toxicity threshold crossing
+      else if (this.lastVpinToxic !== null && vpinToxic !== this.lastVpinToxic) {
+        event = 'vpin_change';
+        if (vpinToxic) {
+          message = `[${sym}] ${price} | VPIN elevated (${(vpin * 100).toFixed(0)}%) - informed flow`;
+          logType = 'risk';
+        } else {
+          message = `[${sym}] ${price} | VPIN normalized (${(vpin * 100).toFixed(0)}%) - clean flow`;
+        }
+      }
+      
+      // Update state tracking
+      this.lastZRegime = zRegime;
+      this.lastBias = bias;
+      this.lastVpinToxic = vpinToxic;
+      
+      // Only return if we have an event
+      if (event && message) {
         return { 
           type: logType, 
           message,
-          logToSession: this.counter % CONFIG.SESSION_LOG_INTERVAL === 0 
+          logToSession: event === 'z_regime_change' || event === 'bias_flip'
         };
       }
-      return null;
+      
+      return null; // No event = silence
     }
 
     // HQX-2B strategy: event-based logging
@@ -257,6 +275,11 @@ class SmartLogsEngine {
     this.lastState = null; 
     this.counter = 0; 
     this.lastLogTime = 0;
+    // Reset QUANT tracking
+    this.lastZRegime = null;
+    this.lastBias = null;
+    this.lastVpinToxic = false;
+    this.warmupLogged = false;
   }
 }