dexbot 1.3.3 → 1.4.1

package/dist/analysis/trend_detection/derivative_analyzer.js

@@ -1,903 +0,0 @@
-"use strict";
-const { roundTo } = require('../../modules/utils/math_utils');
-'use strict';
-/**
- * Derivative Analyzer
- *
- * Trend detection from the sign (and magnitude) of the slow SMA derivative.
- *
- * The analyzer intentionally stays narrow:
- *   - SMA for direction / regime
- *   - MACD for momentum
- *   - RSI for exhaustion and counter-trend filtering
- */
-// ─── Simple Moving Average ───────────────────────────────────────────────────
-class SMA {
-    period;
-    values;
-    constructor(period) {
-        this.period = period;
-        this.values = [];
-    }
-    update(price) {
-        this.values.push(price);
-        if (this.values.length > this.period)
-            this.values.shift();
-        if (this.values.length < this.period)
-            return null;
-        return this.values.reduce((a, b) => a + b, 0) / this.period;
-    }
-    isReady() { return this.values.length >= this.period; }
-    reset(period) { this.period = period; this.values = []; }
-}
-// ─── Exponential Moving Average ──────────────────────────────────────────────
-class EMA {
-    period;
-    multiplier;
-    value;
-    count;
-    _sum;
-    constructor(period) {
-        this.period = period;
-        this.multiplier = 2 / (period + 1);
-        this.value = null;
-        this.count = 0;
-        this._sum = 0;
-    }
-    update(price) {
-        this.count++;
-        if (this.count < this.period) {
-            this._sum += price;
-            return null;
-        }
-        if (this.count === this.period) {
-            this._sum += price;
-            this.value = this._sum / this.period;
-            return this.value;
-        }
-        this.value = price * this.multiplier + this.value * (1 - this.multiplier);
-        return this.value;
-    }
-    isReady() { return this.count >= this.period; }
-    reset(period) {
-        this.period = period ?? this.period;
-        this.multiplier = 2 / (this.period + 1);
-        this.value = null;
-        this.count = 0;
-        this._sum = 0;
-    }
-}
-// ─── MACD ─────────────────────────────────────────────────────────────────────
-class MACD {
-    fastPeriod;
-    slowPeriod;
-    signalPeriod;
-    fastEma;
-    slowEma;
-    signalEma;
-    /**
-     * Moving Average Convergence Divergence
-     * macdLine  = EMA(fast) - EMA(slow)
-     * signal    = EMA(signalPeriod) of macdLine
-     * histogram = macdLine - signal
-     */
-    constructor(fastPeriod = 12, slowPeriod = 26, signalPeriod = 9) {
-        this.fastPeriod = fastPeriod;
-        this.slowPeriod = slowPeriod;
-        this.signalPeriod = signalPeriod;
-        this.fastEma = new EMA(fastPeriod);
-        this.slowEma = new EMA(slowPeriod);
-        this.signalEma = new EMA(signalPeriod);
-    }
-    update(price) {
-        const fast = this.fastEma.update(price);
-        const slow = this.slowEma.update(price);
-        if (fast === null || slow === null)
-            return null;
-        const macdLine = fast - slow;
-        const signal = this.signalEma.update(macdLine);
-        if (signal === null)
-            return null;
-        return { macd: macdLine, signal, histogram: macdLine - signal };
-    }
-    isReady() { return this.slowEma.isReady() && this.signalEma.isReady(); }
-    reset(fastPeriod, slowPeriod, signalPeriod) {
-        this.fastPeriod = fastPeriod ?? this.fastPeriod;
-        this.slowPeriod = slowPeriod ?? this.slowPeriod;
-        this.signalPeriod = signalPeriod ?? this.signalPeriod;
-        this.fastEma.reset(this.fastPeriod);
-        this.slowEma.reset(this.slowPeriod);
-        this.signalEma.reset(this.signalPeriod);
-    }
-}
-// ─── RSI ──────────────────────────────────────────────────────────────────────
-class RSI {
-    period;
-    count;
-    prevPrice;
-    avgGain;
-    avgLoss;
-    /**
-     * Relative Strength Index (Wilder smoothing)
-     * Overbought > 70, Oversold < 30
-     */
-    constructor(period = 14) {
-        this.period = period;
-        this.count = 0;
-        this.prevPrice = null;
-        this.avgGain = 0;
-        this.avgLoss = 0;
-    }
-    update(price) {
-        if (this.prevPrice === null) {
-            this.prevPrice = price;
-            return null;
-        }
-        const change = price - this.prevPrice;
-        this.prevPrice = price;
-        const gain = change > 0 ? change : 0;
-        const loss = change < 0 ? -change : 0;
-        this.count++;
-        if (this.count < this.period) {
-            this.avgGain += gain;
-            this.avgLoss += loss;
-            return null;
-        }
-        if (this.count === this.period) {
-            this.avgGain = (this.avgGain + gain) / this.period;
-            this.avgLoss = (this.avgLoss + loss) / this.period;
-        }
-        else {
-            this.avgGain = (this.avgGain * (this.period - 1) + gain) / this.period;
-            this.avgLoss = (this.avgLoss * (this.period - 1) + loss) / this.period;
-        }
-        if (this.avgLoss === 0)
-            return 100;
-        return 100 - (100 / (1 + this.avgGain / this.avgLoss));
-    }
-    isReady() { return this.count >= this.period; }
-    reset(period) {
-        this.period = period ?? this.period;
-        this.count = 0;
-        this.prevPrice = null;
-        this.avgGain = 0;
-        this.avgLoss = 0;
-    }
-}
-class DerivativeAnalyzer {
-    minBarsForConfirmation;
-    slowSmaPeriod;
-    sma;
-    fastSmaPeriod;
-    fastSma;
-    macdConfig;
-    macd;
-    currMacd;
-    prevMacd;
-    rsiPeriod;
-    rsi;
-    currRsi;
-    prevRsi;
-    interpConfirmBars;
-    interpHoldBars;
-    rsiOverboughtLevel;
-    rsiOversoldLevel;
-    rsiBullThreshold;
-    rsiBearThreshold;
-    macdMinHist;
-    fastSmaCommitmentBars;
-    trendFilterEnabled;
-    trendFilterMinBars;
-    momentumGateEnabled;
-    momentumGateMinBars;
-    momentumGateRsiZone;
-    barsInMacdDivergence;
-    barsInRsiDivergence;
-    priceRegimeGateEnabled;
-    priceRegimeMinDistancePct;
-    prevRawInterp;
-    barsInRawInterp;
-    currInterpretation;
-    currInterpretationRaw;
-    pendingInterp;
-    pendingInterpBars;
-    entryBias;
-    isBullWeakEntry;
-    isBullConfirmation;
-    isLateBullWithoutWeak;
-    isBearWeakEntry;
-    isBearConfirmation;
-    isLateBearWithoutWeak;
-    bullEntrySetupActive;
-    bullEntrySetupConfirmed;
-    bearEntrySetupActive;
-    bearEntrySetupConfirmed;
-    prevSma;
-    currSma;
-    prevFastSma;
-    currFastSma;
-    prevPrice;
-    currPrice;
-    prevRawSmaTrend;
-    barsInSmaTrend;
-    prevRawFastSmaTrend;
-    barsInFastSmaTrend;
-    barsAboveFastSma;
-    barsBelowFastSma;
-    updateCount;
-    constructor(config = {}) {
-        this.minBarsForConfirmation = config.minBarsForConfirmation || 3;
-        // SMA (slow)
-        this.slowSmaPeriod = config.slowSmaPeriod ?? 500;
-        this.sma = this.slowSmaPeriod ? new SMA(this.slowSmaPeriod) : null;
-        // SMA (fast)
-        this.fastSmaPeriod = config.fastSmaPeriod ?? 100;
-        this.fastSma = this.fastSmaPeriod ? new SMA(this.fastSmaPeriod) : null;
-        // MACD
-        this.macdConfig = {
-            fastPeriod: config.macdFastPeriod ?? 12,
-            slowPeriod: config.macdSlowPeriod ?? 26,
-            signalPeriod: config.macdSignalPeriod ?? 9,
-        };
-        this.macd = new MACD(this.macdConfig.fastPeriod, this.macdConfig.slowPeriod, this.macdConfig.signalPeriod);
-        this.currMacd = null;
-        this.prevMacd = null;
-        // RSI
-        this.rsiPeriod = config.rsiPeriod ?? 14;
-        this.rsi = new RSI(this.rsiPeriod);
-        this.currRsi = null;
-        this.prevRsi = null;
-        // Interpretation state
-        this.interpConfirmBars = config.interpConfirmBars ?? 3;
-        this.interpHoldBars = config.interpHoldBars ?? 0;
-        this.rsiOverboughtLevel = config.rsiOverboughtLevel ?? 70;
-        this.rsiOversoldLevel = config.rsiOversoldLevel ?? 30;
-        this.rsiBullThreshold = config.rsiBullThreshold ?? 55;
-        this.rsiBearThreshold = config.rsiBearThreshold ?? 45;
-        this.macdMinHist = config.macdMinHist ?? 0;
-        this.fastSmaCommitmentBars = config.fastSmaCommitmentBars ?? 2;
-        this.trendFilterEnabled = config.trendFilterEnabled ?? false;
-        this.trendFilterMinBars = config.trendFilterMinBars ?? 3;
-        this.momentumGateEnabled = config.momentumGateEnabled ?? false;
-        this.momentumGateMinBars = config.momentumGateMinBars ?? 3;
-        this.momentumGateRsiZone = config.momentumGateRsiZone ?? 35;
-        this.barsInMacdDivergence = 0;
-        this.barsInRsiDivergence = 0;
-        this.priceRegimeGateEnabled = config.priceRegimeGateEnabled ?? true;
-        this.priceRegimeMinDistancePct = config.priceRegimeMinDistancePct ?? 0.35;
-        this.prevRawInterp = null;
-        this.barsInRawInterp = 0;
-        this.currInterpretation = 'NEUTRAL';
-        this.currInterpretationRaw = 'NEUTRAL';
-        this.pendingInterp = null;
-        this.pendingInterpBars = 0;
-        this.entryBias = 'NONE';
-        this.isBullWeakEntry = false;
-        this.isBullConfirmation = false;
-        this.isLateBullWithoutWeak = false;
-        this.isBearWeakEntry = false;
-        this.isBearConfirmation = false;
-        this.isLateBearWithoutWeak = false;
-        this.bullEntrySetupActive = false;
-        this.bullEntrySetupConfirmed = false;
-        this.bearEntrySetupActive = false;
-        this.bearEntrySetupConfirmed = false;
-        // Previous / current SMA values (for derivative)
-        this.prevSma = null;
-        this.currSma = null;
-        this.prevFastSma = null;
-        this.currFastSma = null;
-        this.prevPrice = null;
-        this.currPrice = null;
-        // Independent trend states
-        this.prevRawSmaTrend = null;
-        this.barsInSmaTrend = 0;
-        this.prevRawFastSmaTrend = null;
-        this.barsInFastSmaTrend = 0;
-        this.barsAboveFastSma = 0;
-        this.barsBelowFastSma = 0;
-        this.updateCount = 0;
-    }
-    update(price, timestamp = null) {
-        if (!Number.isFinite(price) || price <= 0) {
-            throw new Error('price must be a positive finite number');
-        }
-        // Update current price at the start of the bar (before interpretation)
-        this.prevPrice = this.currPrice;
-        this.currPrice = price;
-        // SMA (slow)
-        if (this.sma) {
-            this.prevSma = this.currSma;
-            this.currSma = this.sma.update(price);
-        }
-        // SMA (fast)
-        if (this.fastSma) {
-            this.prevFastSma = this.currFastSma;
-            this.currFastSma = this.fastSma.update(price);
-        }
-        // MACD — normalized as % of price so scale is comparable across all price levels
-        if (this.macd) {
-            this.prevMacd = this.currMacd;
-            const raw = this.macd.update(price);
-            if (raw !== null && price > 0) {
-                this.currMacd = {
-                    macd: (raw.macd / price) * 100,
-                    signal: (raw.signal / price) * 100,
-                    histogram: (raw.histogram / price) * 100,
-                };
-            }
-            else {
-                this.currMacd = null;
-            }
-        }
-        // RSI
-        if (this.rsi) {
-            this.prevRsi = this.currRsi;
-            this.currRsi = this.rsi.update(price);
-        }
-        // Advance momentum divergence counters (for Momentum Gate optimization)
-        this._advanceMomentumDivergence();
-        // Fast-SMA commitment tracking: price vs fast MA position
-        this._advancePriceFastSmaPosition();
-        // Interpretation (computed after MACD + RSI are updated)
-        if (this.macd || this.rsi) {
-            const prevInterpretation = this.currInterpretation;
-            this._resetEntryBias();
-            let rawInterp = this.trendFilterEnabled
-                ? this._applyTrendFilter(this._computeInterpretation())
-                : this._computeInterpretation();
-            // Opt 13 — Post-filter MACD line gate (bull/bear trap suppression)
-            // The MACD line is the authoritative momentum regime indicator:
-            //   line > threshold → bullish regime; line < -threshold → bearish regime.
-            // Any signal that contradicts the confirmed regime is suppressed to NEUTRAL.
-            // This ignores marginal crossings at ~0 and ensures signals only start when
-            // momentum is clearly confirmed.
-            if (this.macd && this.currMacd !== null) {
-                const threshold = this.macdMinHist || 0.02;
-                if ((rawInterp === 'BEAR' || rawInterp === 'BEAR_WEAK') && this.currMacd.macd > -threshold)
-                    rawInterp = 'NEUTRAL';
-                if ((rawInterp === 'BULL' || rawInterp === 'BULL_WEAK') && this.currMacd.macd < threshold)
-                    rawInterp = 'NEUTRAL';
-            }
-            this.currInterpretationRaw = rawInterp;
-            // BULL/BEAR require confirmation bars; other states are immediate
-            if (rawInterp === 'BULL' || rawInterp === 'BEAR') {
-                // Check if fast-SMA commitment is met (required before counting confirmation)
-                let fastSmaPassesCommitment = true;
-                if (this.fastSma && this.currFastSma !== null && this.currPrice !== null) {
-                    if (rawInterp === 'BULL') {
-                        fastSmaPassesCommitment = this.barsAboveFastSma >= this.fastSmaCommitmentBars;
-                    }
-                    else if (rawInterp === 'BEAR') {
-                        fastSmaPassesCommitment = this.barsBelowFastSma >= this.fastSmaCommitmentBars;
-                    }
-                }
-                // Only count confirmation bars if the fast-SMA commitment passes
-                if (fastSmaPassesCommitment) {
-                    if (rawInterp === this.prevRawInterp) {
-                        this.barsInRawInterp++;
-                    }
-                    else {
-                        this.prevRawInterp = rawInterp;
-                        this.barsInRawInterp = 1;
-                    }
-                }
-                else {
-                    // Commitment not met — reset confirmation counter
-                    this.prevRawInterp = rawInterp === 'BULL' ? 'BEAR' : 'BULL';
-                    this.barsInRawInterp = 0;
-                }
-                const confirmed = this.barsInRawInterp >= this.interpConfirmBars
-                    ? rawInterp : 'NEUTRAL';
-                this._applyWithHysteresis(confirmed);
-            }
-            else {
-                this.prevRawInterp = rawInterp;
-                this.barsInRawInterp = 0;
-                this._applyWithHysteresis(rawInterp);
-            }
-            this._advanceEntryBias(prevInterpretation);
-        }
-        this.updateCount++;
-        // Update trend states
-        const smaRaw = this._rawSmaTrend();
-        const fastSmaRaw = this._rawFastSmaTrend();
-        this._advanceTrend(smaRaw, 'Sma');
-        this._advanceTrend(fastSmaRaw, 'FastSma');
-        const result = this.getAnalysis();
-        if (timestamp !== null)
-            result.timestamp = timestamp;
-        return result;
-    }
-    _advanceTrend(raw, key) {
-        const prevKey = `prevRaw${key}Trend`;
-        const barsKey = `barsIn${key}Trend`;
-        if (raw !== this[prevKey]) {
-            this[prevKey] = raw;
-            this[barsKey] = 1;
-        }
-        else {
-            this[barsKey]++;
-        }
-    }
-    // ── Derivative signs ───────────────────────────────────────
-    _rawSmaTrend() {
-        if (!this.sma || this.prevSma === null || this.currSma === null)
-            return 'NEUTRAL';
-        if (this.currSma > this.prevSma)
-            return 'UP';
-        if (this.currSma < this.prevSma)
-            return 'DOWN';
-        return 'NEUTRAL';
-    }
-    _rawFastSmaTrend() {
-        if (!this.fastSma || this.prevFastSma === null || this.currFastSma === null)
-            return 'NEUTRAL';
-        if (this.currFastSma > this.prevFastSma)
-            return 'UP';
-        if (this.currFastSma < this.prevFastSma)
-            return 'DOWN';
-        return 'NEUTRAL';
-    }
-    _advancePriceFastSmaPosition() {
-        if (!this.fastSma || this.currFastSma === null || this.currPrice === null) {
-            this.barsAboveFastSma = 0;
-            this.barsBelowFastSma = 0;
-            return;
-        }
-        if (this.currPrice > this.currFastSma) {
-            this.barsAboveFastSma++;
-            this.barsBelowFastSma = 0;
-        }
-        else {
-            this.barsBelowFastSma++;
-            this.barsAboveFastSma = 0;
-        }
-    }
-    _advanceMomentumDivergence() {
-        if (!this.momentumGateEnabled || !this.macd || !this.rsi || !this.sma)
-            return;
-        if (this.currMacd === null || this.currRsi === null)
-            return;
-        const slowDir = this._rawSmaTrend();
-        if (slowDir === 'NEUTRAL') {
-            this.barsInMacdDivergence = 0;
-            this.barsInRsiDivergence = 0;
-            return;
-        }
-        const macdOpposes = (slowDir === 'UP' && this.currMacd.histogram < -this.macdMinHist) ||
-            (slowDir === 'DOWN' && this.currMacd.histogram > this.macdMinHist);
-        const rsiOpposes = (slowDir === 'UP' && this.currRsi < this.momentumGateRsiZone) ||
-            (slowDir === 'DOWN' && this.currRsi > (100 - this.momentumGateRsiZone));
-        this.barsInMacdDivergence = macdOpposes ? this.barsInMacdDivergence + 1 : 0;
-        this.barsInRsiDivergence = rsiOpposes ? this.barsInRsiDivergence + 1 : 0;
-    }
-    // ── Trend filter ─────────────────────────────────────────
-    _applyTrendFilter(interp) {
-        // OB/OS are exit signals — not suppressed by trend direction
-        if (interp === 'OVERBOUGHT' || interp === 'OVERSOLD')
-            return interp;
-        // Compute fast MA direction and sustained bars count
-        let fastDir, fastBarsInDir;
-        if (this.fastSma) {
-            fastDir = this._rawFastSmaTrend();
-            fastBarsInDir = (fastDir === this.prevRawFastSmaTrend ? this.barsInFastSmaTrend + 1 : 1);
-        }
-        else if (this.sma) {
-            fastDir = this._rawSmaTrend();
-            fastBarsInDir = (fastDir === this.prevRawSmaTrend ? this.barsInSmaTrend + 1 : 1);
-        }
-        else {
-            return interp;
-        }
-        if (fastDir === 'NEUTRAL')
-            return interp;
-        // Primary gate: fast MA sustained in opposite direction → suppress to NEUTRAL
-        let suppressedByTrendFilter = false;
-        if (fastBarsInDir >= this.trendFilterMinBars) {
-            if (fastDir === 'UP' && (interp === 'BEAR' || interp === 'BEAR_WEAK')) {
-                interp = 'NEUTRAL';
-                suppressedByTrendFilter = true;
-            }
-            if (fastDir === 'DOWN' && (interp === 'BULL' || interp === 'BULL_WEAK')) {
-                interp = 'NEUTRAL';
-                suppressedByTrendFilter = true;
-            }
-        }
-        // Momentum Gate (Opt 11): if MACD + RSI both diverge from SMA(500) for
-        // >= momentumGateMinBars, allow signal through as WEAK instead of suppressing to NEUTRAL.
-        if (suppressedByTrendFilter && this.momentumGateEnabled && this.sma) {
-            const slowDir = this._rawSmaTrend();
-            const macdConf = this.barsInMacdDivergence >= this.momentumGateMinBars;
-            const rsiConf = this.barsInRsiDivergence >= this.momentumGateMinBars;
-            if (macdConf && rsiConf && slowDir !== 'NEUTRAL') {
-                if (slowDir === 'UP' && (this.currMacd?.histogram ?? 0) < -this.macdMinHist) {
-                    interp = 'BEAR_WEAK';
-                }
-                if (slowDir === 'DOWN' && (this.currMacd?.histogram ?? 0) > this.macdMinHist) {
-                    interp = 'BULL_WEAK';
-                }
-            }
-        }
-        // Macro regime gate: when fastSMA and SMA(slow) are both present and disagree,
-        // cap full BULL/BEAR to WEAK — a short-term dip/bounce against the macro trend
-        // does not warrant a confirmed directional signal.
-        if (this._violatesMacroDisagreeGate(interp, fastDir)) {
-            if (interp === 'BULL')
-                return 'BULL_WEAK';
-            if (interp === 'BEAR')
-                return 'BEAR_WEAK';
-        }
-        // Fast-SMA commitment gate — price vs fast MA cross-check (N-bar commitment required)
-        if (this.fastSma && this.currFastSma !== null && this.currPrice !== null) {
-            if (interp === 'BULL' && this.barsAboveFastSma < this.fastSmaCommitmentBars)
-                return 'BULL_WEAK';
-            if (interp === 'BEAR' && this.barsBelowFastSma < this.fastSmaCommitmentBars)
-                return 'BEAR_WEAK';
-        }
-        // Opt 12 — MACD Line & Histogram regime check
-        if (this.macd && this.currMacd !== null) {
-            if (interp === 'BULL' && this.currMacd.macd <= 0)
-                return 'BULL_WEAK';
-            if (interp === 'BEAR' && this.currMacd.macd >= 0)
-                return 'BEAR_WEAK';
-            if (interp === 'BEAR' && this.currMacd.histogram > 0)
-                return 'BEAR_WEAK';
-        }
-        // Macro price regime gate: require a minimum clearance beyond slow SMA.
-        if (this._violatesPriceRegimeGate(interp))
-            return 'NEUTRAL';
-        return interp;
-    }
-    // ── Hysteresis ────────────────────────────────────────────
-    _applyWithHysteresis(newInterp) {
-        // OB/OS are exit signals — always immediate, bypass hold
-        if (newInterp === 'OVERBOUGHT' || newInterp === 'OVERSOLD') {
-            this.currInterpretation = newInterp;
-            this.pendingInterp = null;
-            this.pendingInterpBars = 0;
-            return;
-        }
-        const curr = this.currInterpretation;
-        const isDowngrade = (curr === 'BULL' && newInterp !== 'BULL')
-            || (curr === 'BEAR' && newInterp !== 'BEAR');
-        // Hard regime gates define when a confirmed signal is no longer valid at all.
-        // In those cases hysteresis must not keep a stale BULL/BEAR alive after invalidation.
-        const hardInvalidation = this._isHardInvalidation(curr);
-        if (!isDowngrade || this.interpHoldBars <= 0 || hardInvalidation) {
-            this.currInterpretation = newInterp;
-            this.pendingInterp = null;
-            this.pendingInterpBars = 0;
-            return;
-        }
-        // Debounce the downgrade — must hold for interpHoldBars bars
-        if (newInterp === this.pendingInterp) {
-            this.pendingInterpBars++;
-            if (this.pendingInterpBars >= this.interpHoldBars) {
-                this.currInterpretation = newInterp;
-                this.pendingInterp = null;
-                this.pendingInterpBars = 0;
-            }
-        }
-        else {
-            this.pendingInterp = newInterp;
-            this.pendingInterpBars = 1;
-        }
-    }
-    _resetEntryBias() {
-        this.entryBias = 'NONE';
-        this.isBullWeakEntry = false;
-        this.isBullConfirmation = false;
-        this.isLateBullWithoutWeak = false;
-        this.isBearWeakEntry = false;
-        this.isBearConfirmation = false;
-        this.isLateBearWithoutWeak = false;
-    }
-    _advanceEntryBias(prevInterpretation) {
-        const curr = this.currInterpretation;
-        const slowDir = this._rawSmaTrend();
-        const fastDir = this.fastSma ? this._rawFastSmaTrend() : slowDir;
-        const prevBullish = prevInterpretation === 'BULL' || prevInterpretation === 'BULL_WEAK';
-        const currBullish = curr === 'BULL' || curr === 'BULL_WEAK';
-        const prevBearish = prevInterpretation === 'BEAR' || prevInterpretation === 'BEAR_WEAK';
-        const currBearish = curr === 'BEAR' || curr === 'BEAR_WEAK';
-        const bullMacroAligned = slowDir === 'UP';
-        const bearMacroAligned = slowDir === 'DOWN';
-        const bullEntryAligned = bullMacroAligned && fastDir === 'UP';
-        const bearEntryAligned = bearMacroAligned && fastDir === 'DOWN';
-        if (!currBullish) {
-            this.bullEntrySetupActive = false;
-            this.bullEntrySetupConfirmed = false;
-        }
-        // Keep weak bullish states visible on the chart, but do not emit long
-        // entry events until both slow and fast SMA trends are aligned up.
-        if (!bullEntryAligned) {
-            this.bullEntrySetupActive = false;
-            this.bullEntrySetupConfirmed = false;
-        }
-        else if (curr === 'BULL_WEAK' && (!prevBullish || !this.bullEntrySetupActive)) {
-            this.bullEntrySetupActive = true;
-            this.bullEntrySetupConfirmed = false;
-            this.entryBias = 'EARLY_LONG';
-            this.isBullWeakEntry = true;
-            return;
-        }
-        if (curr === 'BULL' && prevInterpretation !== 'BULL') {
-            if (this.bullEntrySetupActive && !this.bullEntrySetupConfirmed) {
-                this.bullEntrySetupConfirmed = true;
-                this.entryBias = 'CONFIRM_LONG';
-                this.isBullConfirmation = true;
-            }
-        }
-        if (!currBearish) {
-            this.bearEntrySetupActive = false;
-            this.bearEntrySetupConfirmed = false;
-        }
-        // Keep weak bearish states visible on the chart, but do not emit short
-        // entry events until both slow and fast SMA trends are aligned down.
-        if (!bearEntryAligned) {
-            this.bearEntrySetupActive = false;
-            this.bearEntrySetupConfirmed = false;
-            return;
-        }
-        if (curr === 'BEAR_WEAK' && (!prevBearish || !this.bearEntrySetupActive)) {
-            this.bearEntrySetupActive = true;
-            this.bearEntrySetupConfirmed = false;
-            this.entryBias = 'EARLY_SHORT';
-            this.isBearWeakEntry = true;
-            return;
-        }
-        if (curr === 'BEAR' && prevInterpretation !== 'BEAR') {
-            if (this.bearEntrySetupActive && !this.bearEntrySetupConfirmed) {
-                this.bearEntrySetupConfirmed = true;
-                this.entryBias = 'CONFIRM_SHORT';
-                this.isBearConfirmation = true;
-            }
-        }
-    }
-    _isHardInvalidation(interp) {
-        if (interp !== 'BULL' && interp !== 'BEAR')
-            return false;
-        if (this.macd && this.currMacd !== null) {
-            const threshold = this.macdMinHist || 0.02;
-            if (interp === 'BULL' && this.currMacd.macd < threshold)
-                return true;
-            if (interp === 'BEAR' && this.currMacd.macd > -threshold)
-                return true;
-        }
-        if (this._violatesMacroDisagreeGate(interp))
-            return true;
-        if (this._violatesPriceRegimeGate(interp))
-            return true;
-        return false;
-    }
-    _violatesMacroDisagreeGate(interp, fastDirOverride = null) {
-        if (!this.trendFilterEnabled || !this.fastSma || !this.sma)
-            return false;
-        if (interp !== 'BULL' && interp !== 'BEAR')
-            return false;
-        const fastDir = fastDirOverride ?? this._rawFastSmaTrend();
-        const slowDir = this._rawSmaTrend();
-        const slowBarsInDir = (slowDir === this.prevRawSmaTrend ? this.barsInSmaTrend + 1 : 1);
-        if (fastDir === 'NEUTRAL' || slowDir === 'NEUTRAL')
-            return false;
-        if (slowBarsInDir < this.trendFilterMinBars)
-            return false;
-        if (fastDir === slowDir)
-            return false;
-        return fastDir !== slowDir;
-    }
-    _violatesPriceRegimeGate(interp) {
-        if (!this.priceRegimeGateEnabled || !this.sma || this.currSma === null || this.currPrice === null) {
-            return false;
-        }
-        if (!['BULL', 'BULL_WEAK', 'BEAR', 'BEAR_WEAK'].includes(interp))
-            return false;
-        const distanceMultiplier = this.priceRegimeMinDistancePct / 100;
-        const bullFloor = this.currSma * (1 + distanceMultiplier);
-        const bearCeiling = this.currSma * (1 - distanceMultiplier);
-        if ((interp === 'BULL' || interp === 'BULL_WEAK') && this.currPrice < bullFloor)
-            return true;
-        if ((interp === 'BEAR' || interp === 'BEAR_WEAK') && this.currPrice > bearCeiling)
-            return true;
-        return false;
-    }
-    // ── Interpretation ────────────────────────────────────────
-    _computeInterpretation() {
-        const hist = this.currMacd?.histogram ?? null;
-        const macdLine = this.currMacd?.macd ?? null;
-        const macdSig = this.currMacd?.signal ?? null;
-        const prevHist = this.prevMacd?.histogram ?? null;
-        const prevMacdLine = this.prevMacd?.macd ?? null;
-        const rsi = this.currRsi;
-        if (hist === null && rsi === null)
-            return 'NEUTRAL';
-        // 1. MACD histogram sign with minimum magnitude filter
-        const histBull = hist !== null && hist > this.macdMinHist;
-        const histBear = hist !== null && hist < -this.macdMinHist;
-        // 2. MACD histogram momentum
-        const histMom = (hist !== null && prevHist !== null) ? hist - prevHist : null;
-        const histWeakeningBull = histBull && histMom !== null && histMom < 0;
-        const histWeakeningBear = histBear && histMom !== null && histMom > 0;
-        // 3. MACD zero-line position
-        const macdAboveZero = macdLine !== null && macdLine > 0;
-        const macdBelowZero = macdLine !== null && macdLine < 0;
-        // 5. MACD line slope — is the MACD line itself rising or falling?
-        const macdLineSlope = (macdLine !== null && prevMacdLine !== null) ? macdLine - prevMacdLine : null;
-        const macdLineRising = macdLineSlope !== null && macdLineSlope > 0;
-        const macdLineFalling = macdLineSlope !== null && macdLineSlope < 0;
-        // 6. RSI extremes (highest priority — exit signals)
-        const rsiOverbought = rsi !== null && rsi > this.rsiOverboughtLevel;
-        const rsiOversold = rsi !== null && rsi < this.rsiOversoldLevel;
-        // 7. RSI direction — rising or falling?
-        const rsiSlope = (rsi !== null && this.prevRsi !== null) ? rsi - this.prevRsi : null;
-        const rsiRising = rsiSlope !== null && rsiSlope > 0;
-        const rsiFalling = rsiSlope !== null && rsiSlope < 0;
-        // 8. RSI counter-trend: in opposing zone AND not recovering (direction confirms divergence)
-        const rsiCounterBull = rsi !== null && rsi < this.rsiBearThreshold && !rsiRising;
-        const rsiCounterBear = rsi !== null && rsi > this.rsiBullThreshold && !rsiFalling;
-        // Base signal driven by MACD histogram (RSI no longer hard-gates)
-        let raw = 'NEUTRAL';
-        if (histBull)
-            raw = 'BULL';
-        if (histBear)
-            raw = 'BEAR';
-        // RSI extreme exit — override immediately
-        if (raw === 'BULL' && rsiOverbought)
-            return 'OVERBOUGHT';
-        if (raw === 'BEAR' && rsiOversold)
-            return 'OVERSOLD';
-        // Weak conditions:
-        //   histFading:  histogram shrinking AND MACD line not supporting (any zero position)
-        //   dualWeak:    histogram positive but MACD line still on wrong side of zero AND not recovering
-        //   rsiCounter:  RSI in counter-trend territory AND direction confirms (standalone)
-        //
-        // Note: histogram = MACD line − Signal line, so macdBelowSignal is always false when
-        // histBull is true. Signal line crossover is not a valid structural check here.
-        const histFadingBull = histWeakeningBull && !macdLineRising;
-        const histFadingBear = histWeakeningBear && !macdLineFalling;
-        const dualWeakBull = histBull && macdBelowZero && !macdLineRising;
-        const dualWeakBear = histBear && macdAboveZero && !macdLineFalling;
-        const bullWeak = histFadingBull || dualWeakBull || rsiCounterBull;
-        const bearWeak = histFadingBear || dualWeakBear || rsiCounterBear;
-        if (raw === 'BULL' && bullWeak)
-            return 'BULL_WEAK';
-        if (raw === 'BEAR' && bearWeak)
-            return 'BEAR_WEAK';
-        return raw;
-    }
-    // ── Analysis ───────────────────────────────────────────────
-    getAnalysis() {
-        const warmupNeeded = Math.max(this.sma ? this.slowSmaPeriod : 0, this.fastSma ? this.fastSmaPeriod : 0, this.macd ? this.macdConfig.slowPeriod + this.macdConfig.signalPeriod : 0, this.rsi ? this.rsiPeriod + 1 : 0);
-        if (this.updateCount < warmupNeeded) {
-            return {
-                isReady: false,
-                reason: `Warming up: ${this.updateCount}/${warmupNeeded} candles`,
-                trend: 'NEUTRAL', confidence: 0, isConfirmed: false,
-                ...this._emptySignals(),
-                price: this.currPrice, updateCount: this.updateCount,
-            };
-        }
-        const smaRaw = this._rawSmaTrend();
-        const fastSmaRaw = this._rawFastSmaTrend();
-        const smaConf = this._conf(smaRaw, this.barsInSmaTrend);
-        const fastSmaConf = this._conf(fastSmaRaw, this.barsInFastSmaTrend);
-        const smaConfirmed = smaRaw !== 'NEUTRAL' && this.barsInSmaTrend >= this.minBarsForConfirmation;
-        const fastSmaConfirmed = fastSmaRaw !== 'NEUTRAL' && this.barsInFastSmaTrend >= this.minBarsForConfirmation;
-        // Primary: fastSMA > SMA
-        const primary = this.fastSma ? fastSmaRaw : smaRaw;
-        const primConf = this.fastSma ? fastSmaConf : smaConf;
-        const primConfirm = this.fastSma ? fastSmaConfirmed : smaConfirmed;
-        return {
-            isReady: true,
-            trend: primConfirm ? primary : 'NEUTRAL',
-            confidence: primConf,
-            isConfirmed: primConfirm,
-            rawTrend: primary,
-            barsInTrend: this.fastSma ? this.barsInFastSmaTrend : this.barsInSmaTrend,
-            // SMA (slow)
-            smaRawTrend: smaRaw,
-            smaTrend: smaConfirmed ? smaRaw : 'NEUTRAL',
-            smaBarsInTrend: this.barsInSmaTrend,
-            smaConfidence: smaConf,
-            // SMA (fast)
-            fastSmaRawTrend: fastSmaRaw,
-            fastSmaTrend: fastSmaConfirmed ? fastSmaRaw : 'NEUTRAL',
-            fastSmaBarsInTrend: this.barsInFastSmaTrend,
-            fastSmaConfidence: fastSmaConf,
-            fastSmaValue: this.currFastSma !== null ? roundTo(this.currFastSma, 1e6) : null,
-            // MACD
-            macdLine: this.currMacd ? roundTo(this.currMacd.macd, 1e8) : null,
-            macdSignal: this.currMacd ? roundTo(this.currMacd.signal, 1e8) : null,
-            macdHistogram: this.currMacd ? roundTo(this.currMacd.histogram, 1e8) : null,
-            macdTrend: this.currMacd
-                ? (this.currMacd.histogram > 0 ? 'BULL' : this.currMacd.histogram < 0 ? 'BEAR' : 'NEUTRAL')
-                : null,
-            // RSI
-            rsi: this.currRsi !== null ? roundTo(this.currRsi, 100) : null,
-            rsiZone: this.currRsi !== null
-                ? (this.currRsi > this.rsiOverboughtLevel ? 'OVERBOUGHT' : this.currRsi < this.rsiOversoldLevel ? 'OVERSOLD' : 'NEUTRAL')
-                : null,
-            // Combined interpretation
-            interpretation: this.currInterpretation,
-            interpretationRaw: this.currInterpretationRaw,
-            interpretationBars: this.barsInRawInterp,
-            entryBias: this.entryBias,
-            isBullWeakEntry: this.isBullWeakEntry,
-            isBullConfirmation: this.isBullConfirmation,
-            isLateBullWithoutWeak: this.isLateBullWithoutWeak,
-            isBearWeakEntry: this.isBearWeakEntry,
-            isBearConfirmation: this.isBearConfirmation,
-            isLateBearWithoutWeak: this.isLateBearWithoutWeak,
-            // Values
-            price: this.currPrice,
-            slowSma: this.currSma !== null ? roundTo(this.currSma, 1e6) : null,
-            updateCount: this.updateCount,
-        };
-    }
-    _conf(raw, bars) {
-        return raw !== 'NEUTRAL' ? Math.min(100, Math.round((bars / 20) * 100)) : 0;
-    }
-    _emptySignals() {
-        return {
-            smaRawTrend: 'NEUTRAL', smaTrend: 'NEUTRAL', smaBarsInTrend: 0, smaConfidence: 0,
-            fastSmaRawTrend: 'NEUTRAL', fastSmaTrend: 'NEUTRAL', fastSmaBarsInTrend: 0, fastSmaConfidence: 0, fastSmaValue: null,
-            slowSma: null,
-            macdLine: null, macdSignal: null, macdHistogram: null, macdTrend: null,
-            rsi: null, rsiZone: null,
-            interpretation: 'NEUTRAL', interpretationRaw: 'NEUTRAL', interpretationBars: 0,
-            entryBias: 'NONE',
-            isBullWeakEntry: false,
-            isBullConfirmation: false,
-            isLateBullWithoutWeak: false,
-            isBearWeakEntry: false,
-            isBearConfirmation: false,
-            isLateBearWithoutWeak: false,
-        };
-    }
-    reset() {
-        if (this.sma)
-            this.sma.reset(this.slowSmaPeriod);
-        if (this.fastSma)
-            this.fastSma.reset(this.fastSmaPeriod);
-        if (this.macd)
-            this.macd.reset(this.macdConfig.fastPeriod, this.macdConfig.slowPeriod, this.macdConfig.signalPeriod);
-        if (this.rsi)
-            this.rsi.reset(this.rsiPeriod);
-        this.currMacd = null;
-        this.prevMacd = null;
-        this.currRsi = null;
-        this.prevRawInterp = null;
-        this.barsInRawInterp = 0;
-        this.currInterpretation = 'NEUTRAL';
-        this.currInterpretationRaw = 'NEUTRAL';
-        this.pendingInterp = null;
-        this.pendingInterpBars = 0;
-        this.entryBias = 'NONE';
-        this.isBullWeakEntry = false;
-        this.isBullConfirmation = false;
-        this.isLateBullWithoutWeak = false;
-        this.isBearWeakEntry = false;
-        this.isBearConfirmation = false;
-        this.isLateBearWithoutWeak = false;
-        this.bullEntrySetupActive = false;
-        this.bullEntrySetupConfirmed = false;
-        this.bearEntrySetupActive = false;
-        this.bearEntrySetupConfirmed = false;
-        this.prevSma = null;
-        this.currSma = null;
-        this.prevFastSma = null;
-        this.currFastSma = null;
-        this.currPrice = null;
-        this.prevRawSmaTrend = null;
-        this.barsInSmaTrend = 0;
-        this.prevRawFastSmaTrend = null;
-        this.barsInFastSmaTrend = 0;
-        this.barsAboveFastSma = 0;
-        this.barsBelowFastSma = 0;
-        this.updateCount = 0;
-    }
-    getUpdateCount() { return this.updateCount; }
-}
-module.exports = { DerivativeAnalyzer };
-//# sourceMappingURL=derivative_analyzer.js.map