hedgequantx 2.9.235 → 2.9.237

package/dist/lib/m/s1-models.js

@@ -1,168 +1,373 @@
 /**
- * Mathematical Models for HQX Ultra Scalping
- * @module lib/m/s1-models
+ * =============================================================================
+ * HFT-GRADE MATHEMATICAL MODELS FOR HQX ULTRA SCALPING
+ * =============================================================================
+ * 
+ * ZERO-ALLOCATION DESIGN:
+ * - No array.slice() in hot paths
+ * - No array.reduce() with closures
+ * - No Math.pow() - use multiplication
+ * - Pre-computed lookup tables for regime detection
+ * - In-place calculations with index ranges
  * 
  * 6 Mathematical Models:
- * 1. Z-Score Mean Reversion
- * 2. VPIN (Volume-Synchronized Probability of Informed Trading)
- * 3. Kyle's Lambda (Price Impact / Liquidity)
- * 4. Kalman Filter (Signal Extraction)
- * 5. Volatility Regime Detection
- * 6. Order Flow Imbalance (OFI)
+ * 1. Z-Score Mean Reversion (30% weight)
+ * 2. VPIN - Volume-Synchronized Probability of Informed Trading (15%)
+ * 3. Kyle's Lambda - Price Impact / Liquidity (10%)
+ * 4. Kalman Filter - Signal Extraction (15%)
+ * 5. Volatility Regime Detection (10%)
+ * 6. Order Flow Imbalance - OFI (20%)
+ * 
+ * BACKTEST VALIDATED: $2,012,373.75 / 146,685 trades / 71.1% WR
  */
 
+'use strict';
+
+// =============================================================================
+// PRE-ALLOCATED REGIME PARAMETERS (avoid object creation)
+// =============================================================================
+
+const REGIME_LOW = Object.freeze({
+  stopMultiplier: 0.8,
+  targetMultiplier: 0.9,
+  zscoreThreshold: 1.2,
+  confidenceBonus: 0.05
+});
+
+const REGIME_NORMAL = Object.freeze({
+  stopMultiplier: 1.0,
+  targetMultiplier: 1.0,
+  zscoreThreshold: 1.5,
+  confidenceBonus: 0.0
+});
+
+const REGIME_HIGH = Object.freeze({
+  stopMultiplier: 1.3,
+  targetMultiplier: 1.2,
+  zscoreThreshold: 2.0,
+  confidenceBonus: -0.05
+});
+
+// Pre-allocated result object for Kalman filter (reused)
+const _kalmanResult = {
+  state: { estimate: 0, errorCovariance: 1.0 },
+  estimate: 0
+};
+
+// Pre-allocated regime result (reused)
+const _regimeResult = {
+  regime: 'normal',
+  params: REGIME_NORMAL
+};
+
+// =============================================================================
+// MODEL 1: Z-SCORE MEAN REVERSION (HFT-OPTIMIZED)
+// =============================================================================
+
 /**
- * MODEL 1: Z-SCORE MEAN REVERSION
- * @param {number[]} prices - Price array
- * @param {number} window - Lookback window
+ * Compute Z-Score with zero intermediate array allocations
+ * Uses in-place calculation with index arithmetic
+ * 
+ * @param {number[]} prices - Price buffer (circular or linear)
+ * @param {number} length - Actual number of valid prices
+ * @param {number} window - Lookback window (default 50)
  * @returns {number} Z-Score value
  */
 function computeZScore(prices, window = 50) {
-  if (prices.length < window) return 0;
-  const recentPrices = prices.slice(-window);
-  const mean = recentPrices.reduce((a, b) => a + b, 0) / window;
-  const variance = recentPrices.reduce((sum, p) => sum + Math.pow(p - mean, 2), 0) / window;
-  const std = Math.sqrt(variance);
+  const length = prices.length;
+  if (length === 0) return 0;
+
+  const currentPrice = prices[length - 1];
+  
+  // Determine effective window
+  const n = length < window ? length : window;
+  const startIdx = length - n;
+  
+  // Single-pass mean calculation (no slice, no reduce)
+  let sum = 0;
+  let sumSq = 0;
+  for (let i = startIdx; i < length; i++) {
+    const p = prices[i];
+    sum += p;
+    sumSq += p * p;  // Faster than Math.pow(p, 2)
+  }
+  
+  const mean = sum / n;
+  const variance = (sumSq / n) - (mean * mean);
+  
+  // Blend cumulative and rolling std if enough data (like Python backtest)
+  let std;
+  if (length >= 100) {
+    const cumulativeStd = Math.sqrt(Math.max(0, variance));
+    
+    // Calculate rolling std over last 100 prices (in-place)
+    const rollingStart = length - 100;
+    let rollingSum = 0;
+    for (let i = rollingStart; i < length; i++) {
+      rollingSum += prices[i];
+    }
+    const rollingMean = rollingSum / 100;
+    
+    let rollingVarSum = 0;
+    for (let i = rollingStart; i < length; i++) {
+      const diff = prices[i] - rollingMean;
+      rollingVarSum += diff * diff;
+    }
+    const rollingStd = Math.sqrt(rollingVarSum / 100);
+    
+    // Blend: 30% cumulative, 70% rolling (matches Python)
+    std = cumulativeStd * 0.3 + rollingStd * 0.7;
+  } else {
+    std = Math.sqrt(Math.max(0, variance));
+  }
+
   if (std < 0.0001) return 0;
-  return (prices[prices.length - 1] - mean) / std;
+  return (currentPrice - mean) / std;
 }
 
+// =============================================================================
+// MODEL 2: VPIN - Volume-Synchronized Probability of Informed Trading
+// =============================================================================
+
 /**
- * MODEL 2: VPIN
- * @param {Array<{buy: number, sell: number}>} volumes - Volume data
- * @param {number} vpinWindow - VPIN window size
+ * Compute VPIN with in-place calculation
+ * @param {Array<{buy: number, sell: number}>} volumes - Volume tuples
+ * @param {number} vpinWindow - Window size
  * @returns {number} VPIN value (0-1)
  */
 function computeVPIN(volumes, vpinWindow = 50) {
-  if (volumes.length < vpinWindow) return 0.5;
-  const recent = volumes.slice(-vpinWindow);
-  let totalBuy = 0, totalSell = 0;
-  for (const v of recent) { totalBuy += v.buy; totalSell += v.sell; }
+  const length = volumes.length;
+  if (length < vpinWindow) return 0.5;
+  
+  const startIdx = length - vpinWindow;
+  let totalBuy = 0;
+  let totalSell = 0;
+  
+  // Single-pass accumulation (no slice)
+  for (let i = startIdx; i < length; i++) {
+    const v = volumes[i];
+    totalBuy += v.buy;
+    totalSell += v.sell;
+  }
+  
   const total = totalBuy + totalSell;
   if (total < 1) return 0.5;
-  return Math.abs(totalBuy - totalSell) / total;
+  
+  // Absolute imbalance ratio
+  const imbalance = totalBuy - totalSell;
+  return (imbalance < 0 ? -imbalance : imbalance) / total;
 }
 
+// =============================================================================
+// MODEL 3: KYLE'S LAMBDA - Price Impact / Liquidity
+// =============================================================================
+
 /**
- * MODEL 3: KYLE'S LAMBDA
+ * Compute Kyle's Lambda with zero array allocation
  * @param {Array} bars - Bar data
  * @returns {number} Kyle's Lambda value
  */
 function computeKyleLambda(bars) {
-  if (bars.length < 20) return 0;
-  const recent = bars.slice(-20);
-  const priceChanges = [], vols = [];
-  for (let i = 1; i < recent.length; i++) {
-    priceChanges.push(recent[i].close - recent[i - 1].close);
-    vols.push(recent[i].volume);
+  const length = bars.length;
+  if (length < 20) return 0;
+  
+  const startIdx = length - 20;
+  const n = 19; // price changes = bars - 1
+  
+  // First pass: compute means
+  let sumP = 0;
+  let sumV = 0;
+  for (let i = startIdx + 1; i < length; i++) {
+    sumP += bars[i].close - bars[i - 1].close;
+    sumV += bars[i].volume;
   }
-  const meanP = priceChanges.reduce((a, b) => a + b, 0) / priceChanges.length;
-  const meanV = vols.reduce((a, b) => a + b, 0) / vols.length;
-  let cov = 0, varV = 0;
-  for (let i = 0; i < priceChanges.length; i++) {
-    cov += (priceChanges[i] - meanP) * (vols[i] - meanV);
-    varV += Math.pow(vols[i] - meanV, 2);
+  const meanP = sumP / n;
+  const meanV = sumV / n;
+  
+  // Second pass: compute covariance and variance
+  let cov = 0;
+  let varV = 0;
+  for (let i = startIdx + 1; i < length; i++) {
+    const pDiff = (bars[i].close - bars[i - 1].close) - meanP;
+    const vDiff = bars[i].volume - meanV;
+    cov += pDiff * vDiff;
+    varV += vDiff * vDiff;
   }
-  cov /= priceChanges.length;
-  varV /= priceChanges.length;
+  
+  cov /= n;
+  varV /= n;
+  
   if (varV < 0.0001) return 0;
-  return Math.abs(cov / varV);
+  
+  const lambda = cov / varV;
+  return lambda < 0 ? -lambda : lambda;
 }
 
+// =============================================================================
+// MODEL 4: KALMAN FILTER - Signal Extraction
+// =============================================================================
+
 /**
- * MODEL 4: KALMAN FILTER
+ * Apply Kalman filter update (reuses pre-allocated result object)
  * @param {Object} state - {estimate, errorCovariance}
  * @param {number} measurement - New measurement
- * @param {number} processNoise - Process noise
- * @param {number} measurementNoise - Measurement noise
- * @returns {Object} Updated state and estimate
+ * @param {number} processNoise - Q parameter
+ * @param {number} measurementNoise - R parameter
+ * @returns {Object} Updated state and estimate (REUSED OBJECT - do not store reference)
  */
 function applyKalmanFilter(state, measurement, processNoise = 0.01, measurementNoise = 0.1) {
   if (!state || state.estimate === 0) {
-    return {
-      state: { estimate: measurement, errorCovariance: 1.0 },
-      estimate: measurement
-    };
+    // Initialize filter
+    _kalmanResult.state.estimate = measurement;
+    _kalmanResult.state.errorCovariance = 1.0;
+    _kalmanResult.estimate = measurement;
+    return _kalmanResult;
   }
+  
+  // Predict step
   const predictedEstimate = state.estimate;
   const predictedCovariance = state.errorCovariance + processNoise;
+  
+  // Update step
   const kalmanGain = predictedCovariance / (predictedCovariance + measurementNoise);
   const newEstimate = predictedEstimate + kalmanGain * (measurement - predictedEstimate);
   const newCovariance = (1 - kalmanGain) * predictedCovariance;
-  return {
-    state: { estimate: newEstimate, errorCovariance: newCovariance },
-    estimate: newEstimate
-  };
+  
+  // Reuse result object
+  _kalmanResult.state.estimate = newEstimate;
+  _kalmanResult.state.errorCovariance = newCovariance;
+  _kalmanResult.estimate = newEstimate;
+  
+  return _kalmanResult;
 }
 
 /**
- * Calculate ATR
+ * Create new Kalman state (call once per contract, not in hot path)
+ * @returns {Object}
+ */
+function createKalmanState() {
+  return { estimate: 0, errorCovariance: 1.0 };
+}
+
+// =============================================================================
+// ATR CALCULATION
+// =============================================================================
+
+/**
+ * Calculate ATR with in-place computation
  * @param {Array} bars - Bar data
  * @param {number} period - ATR period
  * @returns {number} ATR value
  */
 function calculateATR(bars, period = 14) {
-  if (bars.length < period + 1) return 2.5;
-  const trValues = [];
-  for (let i = bars.length - period; i < bars.length; i++) {
+  const length = bars.length;
+  if (length < period + 1) return 2.5; // Default for insufficient data
+  
+  let sum = 0;
+  for (let i = length - period; i < length; i++) {
     const bar = bars[i];
     const prevClose = bars[i - 1].close;
-    const tr = Math.max(bar.high - bar.low, Math.abs(bar.high - prevClose), Math.abs(bar.low - prevClose));
-    trValues.push(tr);
+    
+    // True Range = max(H-L, |H-prevC|, |L-prevC|)
+    const hl = bar.high - bar.low;
+    const hc = bar.high - prevClose;
+    const lc = bar.low - prevClose;
+    const absHc = hc < 0 ? -hc : hc;
+    const absLc = lc < 0 ? -lc : lc;
+    
+    // Branchless max of 3 values
+    let tr = hl;
+    if (absHc > tr) tr = absHc;
+    if (absLc > tr) tr = absLc;
+    
+    sum += tr;
   }
-  return trValues.reduce((a, b) => a + b, 0) / trValues.length;
+  
+  return sum / period;
 }
 
+// =============================================================================
+// MODEL 5: VOLATILITY REGIME DETECTION
+// =============================================================================
+
 /**
- * MODEL 5: VOLATILITY REGIME
- * @param {Array} atrHistory - ATR history
- * @param {number} currentATR - Current ATR
- * @returns {Object} Regime and parameters
+ * Detect volatility regime with pre-allocated result
+ * @param {number[]} atrHistory - ATR history buffer
+ * @param {number} currentATR - Current ATR value
+ * @returns {Object} Regime result (REUSED OBJECT - do not store reference)
  */
 function detectVolatilityRegime(atrHistory, currentATR) {
+  const length = atrHistory.length;
+  
+  // Calculate percentile (in-place counting)
   let atrPercentile = 0.5;
-  if (atrHistory.length >= 20) {
-    atrPercentile = atrHistory.filter(a => a <= currentATR).length / atrHistory.length;
+  if (length >= 20) {
+    let count = 0;
+    for (let i = 0; i < length; i++) {
+      if (atrHistory[i] <= currentATR) count++;
+    }
+    atrPercentile = count / length;
   }
 
-  let regime, params;
+  // Assign pre-allocated regime params (no object creation)
   if (atrPercentile < 0.25) {
-    regime = 'low';
-    params = { stopMultiplier: 0.8, targetMultiplier: 0.9, zscoreThreshold: 1.2, confidenceBonus: 0.05 };
+    _regimeResult.regime = 'low';
+    _regimeResult.params = REGIME_LOW;
   } else if (atrPercentile < 0.75) {
-    regime = 'normal';
-    params = { stopMultiplier: 1.0, targetMultiplier: 1.0, zscoreThreshold: 1.5, confidenceBonus: 0.0 };
+    _regimeResult.regime = 'normal';
+    _regimeResult.params = REGIME_NORMAL;
   } else {
-    regime = 'high';
-    params = { stopMultiplier: 1.3, targetMultiplier: 1.2, zscoreThreshold: 2.0, confidenceBonus: -0.05 };
+    _regimeResult.regime = 'high';
+    _regimeResult.params = REGIME_HIGH;
   }
-  return { regime, params };
+  
+  return _regimeResult;
 }
 
+// =============================================================================
+// MODEL 6: ORDER FLOW IMBALANCE (OFI)
+// =============================================================================
+
 /**
- * MODEL 6: ORDER FLOW IMBALANCE
+ * Compute Order Flow Imbalance with in-place calculation
  * @param {Array} bars - Bar data
  * @param {number} ofiLookback - Lookback period
  * @returns {number} OFI value (-1 to 1)
  */
 function computeOrderFlowImbalance(bars, ofiLookback = 20) {
-  if (bars.length < ofiLookback) return 0;
-  const recent = bars.slice(-ofiLookback);
-  let buyPressure = 0, sellPressure = 0;
-  for (const bar of recent) {
+  const length = bars.length;
+  if (length < ofiLookback) return 0;
+  
+  const startIdx = length - ofiLookback;
+  let buyPressure = 0;
+  let sellPressure = 0;
+  
+  for (let i = startIdx; i < length; i++) {
+    const bar = bars[i];
     const range = bar.high - bar.low;
+    
     if (range > 0) {
+      // Close position within range (0 = at low, 1 = at high)
       const closePos = (bar.close - bar.low) / range;
-      buyPressure += closePos * bar.volume;
-      sellPressure += (1 - closePos) * bar.volume;
+      const volume = bar.volume;
+      
+      buyPressure += closePos * volume;
+      sellPressure += (1 - closePos) * volume;
     }
   }
+  
   const total = buyPressure + sellPressure;
   if (total < 1) return 0;
+  
   return (buyPressure - sellPressure) / total;
 }
 
+// =============================================================================
+// EXPORTS
+// =============================================================================
+
 module.exports = {
+  // Core models
   computeZScore,
   computeVPIN,
   computeKyleLambda,
@@ -170,4 +375,12 @@ module.exports = {
   calculateATR,
   detectVolatilityRegime,
   computeOrderFlowImbalance,
+  
+  // State factory (call once per contract initialization)
+  createKalmanState,
+  
+  // Pre-allocated regime params (for reference only)
+  REGIME_LOW,
+  REGIME_NORMAL,
+  REGIME_HIGH,
 };

package/dist/lib/m/ultra-scalping.js

@@ -4,28 +4,27 @@
  * =============================================================================
  * 6 Mathematical Models with 4-Layer Trailing Stop System
  *
- * BACKTEST RESULTS (162 tests, V4):
- * - Net P&L: $195,272.52
- * - Win Rate: 86.3%
- * - Profit Factor: 34.44
- * - Sharpe: 1.29
- * - Tests Passed: 150/162 (92.6%)
+ * BACKTEST RESULTS (Jan 2020 - Nov 2025, 1667 files):
+ * - Net P&L: $2,012,373.75
+ * - Trades: 146,685
+ * - Win Rate: 71.1%
+ * - Avg P&L/Trade: $13.72
+ * - Exit Types: Z-Score 79.3%, Stops 11.5%, Trails 5.8%, Targets 3.4%
  *
- * MATHEMATICAL MODELS:
- * 1. Z-Score Mean Reversion (Entry: |Z| > threshold, Exit: |Z| < 0.5)
- * 2. VPIN (Volume-Synchronized Probability of Informed Trading)
- * 3. Kyle's Lambda (Price Impact / Liquidity Measurement)
- * 4. Kalman Filter (Signal Extraction from Noise)
- * 5. Volatility Regime Detection (Low/Normal/High adaptive)
- * 6. Order Flow Imbalance (OFI) - Directional Bias Confirmation
+ * MATHEMATICAL MODELS (Weighted Composite):
+ * 1. Z-Score Mean Reversion (30%) - Entry: |Z| > 2.5, Exit: |Z| < 0.5
+ * 2. VPIN (15%) - Volume-Synchronized Probability of Informed Trading
+ * 3. Kyle's Lambda (10%) - Price Impact / Liquidity Measurement
+ * 4. Kalman Filter (15%) - Signal Extraction from Noise
+ * 5. Volatility Regime Detection (10%) - ATR percentile
+ * 6. Order Flow Imbalance OFI (20%) - Directional Bias Confirmation
  *
- * KEY PARAMETERS:
+ * KEY PARAMETERS (BACKTEST VALIDATED):
  * - Stop: 8 ticks = $40
  * - Target: 16 ticks = $80
- * - R:R = 1:2
- * - Trailing: 50% profit lock
- * 
- * SOURCE: /root/HQX-Dev/hqx_tg/src/algo/strategy/hqx-ultra-scalping.strategy.ts
+ * - BE: 4 ticks
+ * - Trail: 50% profit lock
+ * - Z-Score Entry: >2.5 | Exit: <0.5
  */
 
 'use strict';
@@ -80,8 +79,8 @@ class HQXUltraScalpingStrategy extends EventEmitter {
     this.tickSize = 0.25;
     this.tickValue = 5.0;
 
-    // === Model Parameters (from V4 backtest) ===
-    this.zscoreEntryThreshold = 1.5;  // Adaptive per regime
+    // === Model Parameters (BACKTEST VALIDATED - $2,012,373.75) ===
+    this.zscoreEntryThreshold = 2.5;  // BACKTEST: Z-Score Entry >2.5
     this.zscoreExitThreshold = 0.5;
     this.vpinWindow = 50;
     this.vpinToxicThreshold = 0.7;
@@ -90,7 +89,7 @@ class HQXUltraScalpingStrategy extends EventEmitter {
     this.volatilityLookback = 100;
     this.ofiLookback = 20;
 
-    // === Trade Parameters (from V4 backtest) ===
+    // === Trade Parameters (BACKTEST VALIDATED) ===
     this.baseStopTicks = 8;     // $40
     this.baseTargetTicks = 16;  // $80
     this.breakevenTicks = 4;    // Move to BE at +4 ticks

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hedgequantx",
-  "version": "2.9.235",
+  "version": "2.9.237",
   "description": "HedgeQuantX - Prop Futures Trading CLI",
   "main": "src/app.js",
   "bin": {
@@ -47,6 +47,7 @@
     "src/api/",
     "src/config/",
     "src/lib/data.js",
+    "src/lib/hft/",
     "src/lib/smart-logs*.js",
     "src/lib/smart-logs-messages/",
     "src/lib/m/index.js",

package/src/lib/hft/index.js

@@ -0,0 +1,648 @@
+/**
+ * =============================================================================
+ * HFT-GRADE INFRASTRUCTURE
+ * =============================================================================
+ * Ultra-low latency primitives for high-frequency trading
+ * 
+ * Components:
+ * - ObjectPool: Zero-allocation object reuse
+ * - CircularBuffer: O(1) fixed-size buffer operations
+ * - FastMath: Optimized math operations
+ * - TimestampCache: Cached time operations
+ * - FieldDecoder: Pre-indexed protobuf decoding
+ * 
+ * Design Principles:
+ * - ZERO allocations in hot paths
+ * - Pre-computed lookup tables
+ * - Branch prediction optimization
+ * - Cache-friendly data structures
+ */
+
+'use strict';
+
+// =============================================================================
+// OBJECT POOL - Zero-allocation object reuse
+// =============================================================================
+
+/**
+ * High-performance object pool for hot path allocation avoidance
+ * @template T
+ */
+class ObjectPool {
+  /**
+   * @param {() => T} factory - Function to create new objects
+   * @param {(obj: T) => void} reset - Function to reset object state
+   * @param {number} initialSize - Initial pool size
+   */
+  constructor(factory, reset, initialSize = 128) {
+    this.factory = factory;
+    this.reset = reset;
+    this.pool = new Array(initialSize);
+    this.index = initialSize;
+    
+    // Pre-allocate all objects
+    for (let i = 0; i < initialSize; i++) {
+      this.pool[i] = factory();
+    }
+  }
+
+  /**
+   * Acquire object from pool (O(1), zero allocation if pool not empty)
+   * @returns {T}
+   */
+  acquire() {
+    if (this.index > 0) {
+      return this.pool[--this.index];
+    }
+    // Pool exhausted - create new (should be rare in well-tuned system)
+    return this.factory();
+  }
+
+  /**
+   * Release object back to pool (O(1))
+   * @param {T} obj
+   */
+  release(obj) {
+    this.reset(obj);
+    if (this.index < this.pool.length) {
+      this.pool[this.index++] = obj;
+    }
+    // If pool full, object is discarded (GC will collect)
+  }
+
+  /**
+   * Get current pool size
+   * @returns {number}
+   */
+  get available() {
+    return this.index;
+  }
+
+  /**
+   * Pre-warm pool to full capacity
+   */
+  prewarm() {
+    while (this.index < this.pool.length) {
+      this.pool[this.index++] = this.factory();
+    }
+  }
+}
+
+// =============================================================================
+// CIRCULAR BUFFER - O(1) fixed-size buffer
+// =============================================================================
+
+/**
+ * Lock-free circular buffer for time-series data
+ * Eliminates O(n) shift() operations
+ * @template T
+ */
+class CircularBuffer {
+  /**
+   * @param {number} capacity - Fixed buffer capacity
+   */
+  constructor(capacity) {
+    this.buffer = new Array(capacity);
+    this.capacity = capacity;
+    this.head = 0;      // Read position
+    this.tail = 0;      // Write position
+    this.length = 0;
+  }
+
+  /**
+   * Add item to buffer (O(1), overwrites oldest if full)
+   * @param {T} item
+   */
+  push(item) {
+    this.buffer[this.tail] = item;
+    this.tail = (this.tail + 1) % this.capacity;
+    
+    if (this.length < this.capacity) {
+      this.length++;
+    } else {
+      // Buffer full - advance head (overwrite oldest)
+      this.head = (this.head + 1) % this.capacity;
+    }
+  }
+
+  /**
+   * Get item at logical index (O(1))
+   * @param {number} index - 0 = oldest, length-1 = newest
+   * @returns {T}
+   */
+  get(index) {
+    if (index < 0 || index >= this.length) return undefined;
+    return this.buffer[(this.head + index) % this.capacity];
+  }
+
+  /**
+   * Get most recent item (O(1))
+   * @returns {T}
+   */
+  last() {
+    if (this.length === 0) return undefined;
+    return this.buffer[(this.tail - 1 + this.capacity) % this.capacity];
+  }
+
+  /**
+   * Get oldest item (O(1))
+   * @returns {T}
+   */
+  first() {
+    if (this.length === 0) return undefined;
+    return this.buffer[this.head];
+  }
+
+  /**
+   * Iterate over all items (oldest to newest)
+   * @param {(item: T, index: number) => void} fn
+   */
+  forEach(fn) {
+    for (let i = 0; i < this.length; i++) {
+      fn(this.buffer[(this.head + i) % this.capacity], i);
+    }
+  }
+
+  /**
+   * Reduce over all items
+   * @template U
+   * @param {(acc: U, item: T, index: number) => U} fn
+   * @param {U} initial
+   * @returns {U}
+   */
+  reduce(fn, initial) {
+    let acc = initial;
+    for (let i = 0; i < this.length; i++) {
+      acc = fn(acc, this.buffer[(this.head + i) % this.capacity], i);
+    }
+    return acc;
+  }
+
+  /**
+   * Get slice of recent items (newest N items)
+   * @param {number} count
+   * @returns {T[]}
+   */
+  recent(count) {
+    const n = Math.min(count, this.length);
+    const result = new Array(n);
+    const start = (this.tail - n + this.capacity) % this.capacity;
+    for (let i = 0; i < n; i++) {
+      result[i] = this.buffer[(start + i) % this.capacity];
+    }
+    return result;
+  }
+
+  /**
+   * Clear buffer (O(1))
+   */
+  clear() {
+    this.head = 0;
+    this.tail = 0;
+    this.length = 0;
+  }
+
+  /**
+   * Check if buffer is full
+   * @returns {boolean}
+   */
+  isFull() {
+    return this.length === this.capacity;
+  }
+}
+
+// =============================================================================
+// TYPED CIRCULAR BUFFER - For numeric data (Float64)
+// =============================================================================
+
+/**
+ * Typed circular buffer using Float64Array for numeric time-series
+ * More cache-friendly than generic CircularBuffer for numbers
+ */
+class Float64CircularBuffer {
+  /**
+   * @param {number} capacity
+   */
+  constructor(capacity) {
+    this.buffer = new Float64Array(capacity);
+    this.capacity = capacity;
+    this.head = 0;
+    this.tail = 0;
+    this.length = 0;
+    
+    // Pre-computed values for statistics
+    this._sum = 0;
+    this._sumSq = 0;
+  }
+
+  /**
+   * Add value with running statistics (O(1))
+   * @param {number} value
+   */
+  push(value) {
+    if (this.length === this.capacity) {
+      // Remove oldest value from running stats
+      const oldest = this.buffer[this.head];
+      this._sum -= oldest;
+      this._sumSq -= oldest * oldest;
+      this.head = (this.head + 1) % this.capacity;
+    } else {
+      this.length++;
+    }
+    
+    // Add new value
+    this.buffer[this.tail] = value;
+    this._sum += value;
+    this._sumSq += value * value;
+    this.tail = (this.tail + 1) % this.capacity;
+  }
+
+  /**
+   * Get mean (O(1) - pre-computed)
+   * @returns {number}
+   */
+  mean() {
+    return this.length > 0 ? this._sum / this.length : 0;
+  }
+
+  /**
+   * Get variance (O(1) - pre-computed)
+   * @returns {number}
+   */
+  variance() {
+    if (this.length < 2) return 0;
+    const mean = this._sum / this.length;
+    return (this._sumSq / this.length) - (mean * mean);
+  }
+
+  /**
+   * Get standard deviation (O(1))
+   * @returns {number}
+   */
+  std() {
+    return Math.sqrt(Math.max(0, this.variance()));
+  }
+
+  /**
+   * Get value at index
+   * @param {number} index
+   * @returns {number}
+   */
+  get(index) {
+    if (index < 0 || index >= this.length) return NaN;
+    return this.buffer[(this.head + index) % this.capacity];
+  }
+
+  /**
+   * Get most recent value
+   * @returns {number}
+   */
+  last() {
+    if (this.length === 0) return NaN;
+    return this.buffer[(this.tail - 1 + this.capacity) % this.capacity];
+  }
+
+  /**
+   * Get min value (O(n) but rarely needed in hot path)
+   * @returns {number}
+   */
+  min() {
+    if (this.length === 0) return NaN;
+    let min = this.buffer[this.head];
+    for (let i = 1; i < this.length; i++) {
+      const val = this.buffer[(this.head + i) % this.capacity];
+      if (val < min) min = val;
+    }
+    return min;
+  }
+
+  /**
+   * Get max value
+   * @returns {number}
+   */
+  max() {
+    if (this.length === 0) return NaN;
+    let max = this.buffer[this.head];
+    for (let i = 1; i < this.length; i++) {
+      const val = this.buffer[(this.head + i) % this.capacity];
+      if (val > max) max = val;
+    }
+    return max;
+  }
+
+  clear() {
+    this.head = 0;
+    this.tail = 0;
+    this.length = 0;
+    this._sum = 0;
+    this._sumSq = 0;
+  }
+}
+
+// =============================================================================
+// FAST MATH - Optimized math operations
+// =============================================================================
+
+const FastMath = {
+  /**
+   * Fast square (faster than Math.pow(x, 2))
+   * @param {number} x
+   * @returns {number}
+   */
+  square: (x) => x * x,
+
+  /**
+   * Clamp value between min and max (branchless)
+   * @param {number} value
+   * @param {number} min
+   * @param {number} max
+   * @returns {number}
+   */
+  clamp: (value, min, max) => Math.max(min, Math.min(max, value)),
+
+  /**
+   * Linear interpolation
+   * @param {number} a
+   * @param {number} b
+   * @param {number} t - 0 to 1
+   * @returns {number}
+   */
+  lerp: (a, b, t) => a + (b - a) * t,
+
+  /**
+   * Sign function (-1, 0, 1)
+   * @param {number} x
+   * @returns {number}
+   */
+  sign: (x) => (x > 0) - (x < 0),
+
+  /**
+   * Fast approximate inverse square root (for non-critical paths)
+   * @param {number} x
+   * @returns {number}
+   */
+  invSqrt: (x) => 1 / Math.sqrt(x),
+
+  /**
+   * Round to tick size
+   * @param {number} price
+   * @param {number} tickSize
+   * @returns {number}
+   */
+  roundToTick: (price, tickSize) => Math.round(price / tickSize) * tickSize,
+
+  /**
+   * Calculate ticks between prices
+   * @param {number} price1
+   * @param {number} price2
+   * @param {number} tickSize
+   * @returns {number}
+   */
+  ticksBetween: (price1, price2, tickSize) => Math.round((price1 - price2) / tickSize),
+};
+
+// =============================================================================
+// TIMESTAMP CACHE - Reduce Date.now() calls
+// =============================================================================
+
+/**
+ * Cached timestamp provider to reduce Date.now() calls in hot paths
+ * Updates at configurable interval
+ */
+class TimestampCache {
+  constructor(updateIntervalMs = 1) {
+    this._now = Date.now();
+    this._hrTime = process.hrtime.bigint();
+    this._interval = null;
+    this._updateInterval = updateIntervalMs;
+  }
+
+  /**
+   * Start automatic updates
+   */
+  start() {
+    if (this._interval) return;
+    this._interval = setInterval(() => {
+      this._now = Date.now();
+      this._hrTime = process.hrtime.bigint();
+    }, this._updateInterval);
+    this._interval.unref(); // Don't prevent process exit
+  }
+
+  /**
+   * Stop automatic updates
+   */
+  stop() {
+    if (this._interval) {
+      clearInterval(this._interval);
+      this._interval = null;
+    }
+  }
+
+  /**
+   * Get cached timestamp (ms)
+   * @returns {number}
+   */
+  now() {
+    return this._now;
+  }
+
+  /**
+   * Get high-resolution timestamp (ns)
+   * @returns {bigint}
+   */
+  hrNow() {
+    return this._hrTime;
+  }
+
+  /**
+   * Force update (use sparingly)
+   */
+  update() {
+    this._now = Date.now();
+    this._hrTime = process.hrtime.bigint();
+  }
+}
+
+// =============================================================================
+// PRE-ALLOCATED STRUCTURES
+// =============================================================================
+
+/**
+ * Pre-allocated bar structure for tick aggregation
+ */
+function createBarStruct() {
+  return {
+    timestamp: 0,
+    open: 0,
+    high: 0,
+    low: 0,
+    close: 0,
+    volume: 0,
+    delta: 0,
+    tickCount: 0,
+  };
+}
+
+/**
+ * Reset bar struct for reuse
+ * @param {Object} bar
+ */
+function resetBarStruct(bar) {
+  bar.timestamp = 0;
+  bar.open = 0;
+  bar.high = -Infinity;
+  bar.low = Infinity;
+  bar.close = 0;
+  bar.volume = 0;
+  bar.delta = 0;
+  bar.tickCount = 0;
+}
+
+/**
+ * Pre-allocated signal structure
+ */
+function createSignalStruct() {
+  return {
+    id: '',
+    timestamp: 0,
+    symbol: '',
+    contractId: '',
+    side: 0,
+    direction: '',
+    strategy: '',
+    strength: 0,
+    edge: 0,
+    confidence: 0,
+    entry: 0,
+    entryPrice: 0,
+    stopLoss: 0,
+    takeProfit: 0,
+    riskReward: 0,
+    stopTicks: 0,
+    targetTicks: 0,
+    breakevenTicks: 0,
+    trailTriggerTicks: 0,
+    trailDistanceTicks: 0,
+    regime: '',
+    zscore: 0,
+    vpin: 0,
+    ofi: 0,
+    kyleLambda: 0,
+    kalmanEstimate: 0,
+    expires: 0,
+  };
+}
+
+/**
+ * Reset signal struct for reuse
+ * @param {Object} signal
+ */
+function resetSignalStruct(signal) {
+  signal.id = '';
+  signal.timestamp = 0;
+  signal.symbol = '';
+  signal.contractId = '';
+  signal.side = 0;
+  signal.direction = '';
+  signal.strategy = '';
+  signal.strength = 0;
+  signal.edge = 0;
+  signal.confidence = 0;
+  signal.entry = 0;
+  signal.entryPrice = 0;
+  signal.stopLoss = 0;
+  signal.takeProfit = 0;
+  signal.riskReward = 0;
+  signal.stopTicks = 0;
+  signal.targetTicks = 0;
+  signal.breakevenTicks = 0;
+  signal.trailTriggerTicks = 0;
+  signal.trailDistanceTicks = 0;
+  signal.regime = '';
+  signal.zscore = 0;
+  signal.vpin = 0;
+  signal.ofi = 0;
+  signal.kyleLambda = 0;
+  signal.kalmanEstimate = 0;
+  signal.expires = 0;
+}
+
+/**
+ * Pre-allocated trade result structure
+ */
+function createTradeStruct() {
+  return {
+    id: '',
+    entryTime: 0,
+    exitTime: 0,
+    direction: 0,
+    entryPrice: 0,
+    exitPrice: 0,
+    quantity: 0,
+    grossPnl: 0,
+    netPnl: 0,
+    commission: 0,
+    slippage: 0,
+    exitReason: '',
+    duration: 0,
+  };
+}
+
+function resetTradeStruct(trade) {
+  trade.id = '';
+  trade.entryTime = 0;
+  trade.exitTime = 0;
+  trade.direction = 0;
+  trade.entryPrice = 0;
+  trade.exitPrice = 0;
+  trade.quantity = 0;
+  trade.grossPnl = 0;
+  trade.netPnl = 0;
+  trade.commission = 0;
+  trade.slippage = 0;
+  trade.exitReason = '';
+  trade.duration = 0;
+}
+
+// =============================================================================
+// SINGLETON INSTANCES
+// =============================================================================
+
+// Global timestamp cache (start on import)
+const timestampCache = new TimestampCache(1);
+timestampCache.start();
+
+// Pre-created object pools
+const barPool = new ObjectPool(createBarStruct, resetBarStruct, 256);
+const signalPool = new ObjectPool(createSignalStruct, resetSignalStruct, 64);
+const tradePool = new ObjectPool(createTradeStruct, resetTradeStruct, 128);
+
+// =============================================================================
+// EXPORTS
+// =============================================================================
+
+module.exports = {
+  // Classes
+  ObjectPool,
+  CircularBuffer,
+  Float64CircularBuffer,
+  TimestampCache,
+  
+  // Fast math utilities
+  FastMath,
+  
+  // Struct factories
+  createBarStruct,
+  resetBarStruct,
+  createSignalStruct,
+  resetSignalStruct,
+  createTradeStruct,
+  resetTradeStruct,
+  
+  // Singleton pools
+  barPool,
+  signalPool,
+  tradePool,
+  timestampCache,
+};

package/dist/lib/m/mod1.js

@@ -1 +0,0 @@
-'use strict';require('bytenode');module.exports=require('./mod1.jsc');

package/dist/lib/m/mod2.js

@@ -1 +0,0 @@
-'use strict';require('bytenode');module.exports=require('./mod2.jsc');