dexbot 1.1.10

package/dist/analysis/analyze_dynamic_weight.js

@@ -0,0 +1,208 @@
+#!/usr/bin/env node
+/**
+ * DYNAMIC WEIGHT RESEARCH TOOL
+ *
+ * Computes AMA slope + Kalman + Hurst + PE signals and generates an
+ * interactive HTML chart for researching dynamic weight parameters.
+ *
+ * Usage:
+ *   tsx analysis/analyze_dynamic_weight.ts \
+ *     --source json \
+ *     --file market_adapter/data/lp/<path>/<to>/<lp-candles>.json
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+const path = require('path');
+const { KalmanTrendAnalyzer } = require('./trend_detection/kalman_trend_analyzer');
+const { HurstAnalyzer } = require('./trend_detection/hurst_analyzer');
+const { PermutationEntropyAnalyzer } = require('./trend_detection/permutation_entropy_analyzer');
+const { generateHTML } = require('./trend_detection/dynamic_weight_chart_generator');
+const { createSource } = require('./price_sources');
+const { calculateAMA } = require('../market_adapter/core/strategies/ama');
+const { computeAmaSlopeWeights } = require('../market_adapter/core/strategies/ama_slope_model');
+const { MARKET_ADAPTER } = require('../modules/constants');
+const { writeChartFile } = require('./chart_utils');
+const { getCandleClose } = require('./math_utils');
+const { resolveCandleFile } = require('./bot_key_utils');
+const INTERVAL_LABEL = MARKET_ADAPTER.RUNTIME_DEFAULTS.intervalLabel;
+// AMA configuration — use AMA3 from constants (same as production)
+const AMA_CONFIG = MARKET_ADAPTER.AMAS.AMA3;
+// AMA Slope weight calculation config — use DEFAULTS from market adapter
+const AMA_WEIGHT_CONFIG = {
+    lookbackBars: MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_LOOKBACK_BARS,
+    amaMaxSlopePct: MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_MAX_SLOPE_PCT,
+    kalmanMaxSlopePct: MARKET_ADAPTER.DYNAMIC_WEIGHT_KALMAN_MAX_SLOPE_PCT,
+    neutralZonePct: MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_NEUTRAL_ZONE_PCT,
+    volatilityExponent: MARKET_ADAPTER.DYNAMIC_WEIGHT_VOLATILITY_EXPONENT,
+    volatilityScaleX: MARKET_ADAPTER.DYNAMIC_WEIGHT_VOLATILITY_SCALE_X_DEFAULT,
+    volatilityThreshold: MARKET_ADAPTER.DYNAMIC_WEIGHT_SYMMETRIC_SHIFT_THRESHOLD,
+    maxSlopeOffset: MARKET_ADAPTER.DYNAMIC_WEIGHT_ASYMMETRIC_OFFSET_CLAMP,
+    maxVolatilityOffset: MARKET_ADAPTER.DYNAMIC_WEIGHT_SYMMETRIC_SHIFT_CLAMP,
+};
+// Kalman configuration
+const KALMAN_CONFIG = {
+    rNoise: MARKET_ADAPTER.DYNAMIC_WEIGHT_KALMAN_R_NOISE_DEFAULT,
+    qTactical: MARKET_ADAPTER.DYNAMIC_WEIGHT_KALMAN_Q_TACTICAL_DEFAULT,
+    qModal: MARKET_ADAPTER.DYNAMIC_WEIGHT_KALMAN_Q_MODAL_DEFAULT,
+};
+// Regime analyzers configuration (Hurst + Permutation Entropy)
+const { HURST_CONFIG, PE_CONFIG } = MARKET_ADAPTER;
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const config = {
+        source: { type: 'market_adapter', config: { botKey: 'XRP-BTS' } },
+        chartFile: 'analysis/charts/dynamic_weight_chart.html',
+        alpha: MARKET_ADAPTER.DYNAMIC_WEIGHT_ALPHA,
+        gain: MARKET_ADAPTER.DYNAMIC_WEIGHT_GAIN,
+        dispWeight: MARKET_ADAPTER.DYNAMIC_WEIGHT_DW,
+        clipPct: MARKET_ADAPTER.DYNAMIC_WEIGHT_CLIP_PERCENTILE,
+        quiet: false,
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--source')
+            config.source.type = args[++i];
+        else if (arg === '--bot-key')
+            config.source.config.botKey = args[++i];
+        else if (arg === '--file') {
+            config.source.config.filePath = args[++i];
+            config.source.type = 'json';
+        }
+        else if (arg === '--chart')
+            config.chartFile = args[++i];
+        else if (arg === '--alpha')
+            config.alpha = parseFloat(args[++i]);
+        else if (arg === '--gain')
+            config.gain = parseFloat(args[++i]);
+        else if (arg === '--dw')
+            config.dispWeight = parseFloat(args[++i]);
+        else if (arg === '--lb')
+            config.lookbackBars = parseInt(args[++i], 10);
+        else if (arg === '--clip')
+            config.clipPct = parseFloat(args[++i]);
+        else if (arg === '--quiet')
+            config.quiet = true;
+    }
+    return config;
+}
+async function main() {
+    try {
+        const config = parseArgs();
+        const srcConfig = config.source.config;
+        if (config.source.type === 'market_adapter') {
+            const candleFile = resolveCandleFile(srcConfig.botKey, INTERVAL_LABEL);
+            if (!candleFile) {
+                throw new Error(`No candle cache file found for bot '${srcConfig.botKey}'. Use --file to specify a data file directly.`);
+            }
+            srcConfig.filePath = candleFile;
+            config.source.type = 'json';
+            if (!config.quiet)
+                console.log(`[DynamicWeight] Resolved bot '${srcConfig.botKey}' → ${path.basename(candleFile)}`);
+        }
+        const source = createSource(config.source.type, srcConfig);
+        if (!config.quiet)
+            console.log(`[DynamicWeight] Loading candles from ${source.name}...`);
+        const candles = await source.fetchCandles();
+        if (!Array.isArray(candles) || candles.length === 0) {
+            throw new Error('No candles returned from source');
+        }
+        // ── Kalman analysis ──────────────────────────────────────────────────
+        const analyzer = new KalmanTrendAnalyzer({
+            rNoise: KALMAN_CONFIG.rNoise,
+            qTactical: KALMAN_CONFIG.qTactical,
+            qModal: KALMAN_CONFIG.qModal,
+        });
+        // ── Hurst & PE analyzers ──────────────────────────────────────────────
+        const hurstAnalyzer = new HurstAnalyzer({
+            window: HURST_CONFIG.window,
+            scales: HURST_CONFIG.scales,
+        });
+        const peAnalyzer = new PermutationEntropyAnalyzer({
+            m: PE_CONFIG.m,
+            delay: PE_CONFIG.delay,
+            window: PE_CONFIG.window,
+        });
+        const allResults = [];
+        for (let i = 0; i < candles.length; i++) {
+            const { marketPrice, timestamp } = source.extractMarketPrice(candles[i]);
+            const result = analyzer.update(marketPrice);
+            const hurst = hurstAnalyzer.update(marketPrice);
+            const pe = peAnalyzer.update(marketPrice);
+            result.timestamp = timestamp;
+            result.price = marketPrice;
+            result.hurst = hurst.isReady ? hurst.hurst : null;
+            result.pe = pe.isReady ? pe.normalizedEntropy : null;
+            allResults.push(result);
+        }
+        // ── AMA weight calculation ───────────────────────────────────────────
+        const closes = candles.map(c => getCandleClose(c) ?? 0);
+        const ama3Values = calculateAMA(closes, AMA_CONFIG);
+        for (let i = 0; i < allResults.length; i++) {
+            const amaPrice = ama3Values[i] ?? null;
+            // The research chart keeps ATR out of the Kalman branch on purpose.
+            // Production applies ATR later as a separate symmetric volatility penalty.
+            const atr = 0;
+            const weightVariance = 0;
+            const weights = computeAmaSlopeWeights(ama3Values.slice(0, i + 1), weightVariance, {
+                erPeriod: AMA_CONFIG.erPeriod,
+                slowPeriod: AMA_CONFIG.slowPeriod,
+                lookbackBars: config.lookbackBars ?? AMA_WEIGHT_CONFIG.lookbackBars,
+                maxSlopePct: AMA_WEIGHT_CONFIG.amaMaxSlopePct,
+                neutralZonePct: AMA_WEIGHT_CONFIG.neutralZonePct,
+                volatilityExponent: AMA_WEIGHT_CONFIG.volatilityExponent,
+                volatilityScaleX: AMA_WEIGHT_CONFIG.volatilityScaleX,
+                volatilityThreshold: AMA_WEIGHT_CONFIG.volatilityThreshold,
+                maxSlopeOffset: AMA_WEIGHT_CONFIG.maxSlopeOffset,
+                maxVolatilityOffset: AMA_WEIGHT_CONFIG.maxVolatilityOffset,
+            });
+            allResults[i].amaPrice = amaPrice;
+            allResults[i].ama3Price = ama3Values[i] ?? null;
+            allResults[i].atr = atr;
+            allResults[i].weightVariance = weightVariance;
+            allResults[i].amaSlopePct = weights.slopePct;
+            allResults[i].amaWeightReady = weights.isReady;
+            allResults[i].amaSlopeOffset = weights.slopeOffset;
+            allResults[i].amaSymmetricDelta = weights.symmetricDelta;
+        }
+        // ── Generate chart ───────────────────────────────────────────────────
+        const html = generateHTML({
+            allResults,
+            amaConfig: AMA_CONFIG,
+            amaWeightConfig: {
+                ...AMA_WEIGHT_CONFIG,
+                lookbackBars: config.lookbackBars ?? AMA_WEIGHT_CONFIG.lookbackBars,
+            },
+            alpha: config.alpha,
+            gain: config.gain,
+            dispWeight: config.dispWeight,
+            clipPct: config.clipPct,
+            regimeSensitivity: MARKET_ADAPTER.DYNAMIC_WEIGHT_REGIME_SENSITIVITY,
+            dispScaleMinPct: config.dispScaleMinPct ?? MARKET_ADAPTER.DYNAMIC_WEIGHT_DISP_SCALE_MIN_PCT,
+            minOutputThreshold: MARKET_ADAPTER.DYNAMIC_WEIGHT_ASYMMETRIC_TREND_THRESHOLD,
+            outputClamp: MARKET_ADAPTER.DYNAMIC_WEIGHT_ASYMMETRIC_OFFSET_CLAMP,
+            marketAdapter: {
+                alpha: MARKET_ADAPTER.DYNAMIC_WEIGHT_ALPHA,
+                gain: MARKET_ADAPTER.DYNAMIC_WEIGHT_GAIN,
+                dispWeight: MARKET_ADAPTER.DYNAMIC_WEIGHT_DW,
+                clipPercentile: MARKET_ADAPTER.DYNAMIC_WEIGHT_CLIP_PERCENTILE,
+                regimeSensitivity: MARKET_ADAPTER.DYNAMIC_WEIGHT_REGIME_SENSITIVITY,
+                minOutputThreshold: MARKET_ADAPTER.DYNAMIC_WEIGHT_ASYMMETRIC_TREND_THRESHOLD,
+                outputClamp: MARKET_ADAPTER.DYNAMIC_WEIGHT_ASYMMETRIC_OFFSET_CLAMP,
+                amaLookbackBars: MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_LOOKBACK_BARS,
+                amaMaxSlopePct: MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_MAX_SLOPE_PCT,
+                kalmanMaxSlopePct: MARKET_ADAPTER.DYNAMIC_WEIGHT_KALMAN_MAX_SLOPE_PCT,
+                amaNeutralZonePct: MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_NEUTRAL_ZONE_PCT,
+                dispScaleMinPct: MARKET_ADAPTER.DYNAMIC_WEIGHT_DISP_SCALE_MIN_PCT,
+            },
+        }, 'Dynamic Weight Research Tool');
+        writeChartFile(config.chartFile, html);
+        if (!config.quiet)
+            console.log(`[DynamicWeight] ✓ Chart saved to ${config.chartFile}`);
+    }
+    catch (err) {
+        console.error(`[DynamicWeight] Error: ${err.message}`);
+        process.exit(1);
+    }
+}
+main().catch(err => { console.error(err); process.exit(1); });
+//# sourceMappingURL=analyze_dynamic_weight.js.map

package/dist/analysis/analyze_dynamic_weight.js.map

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

package/dist/analysis/analyze_kalman.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * KALMAN TREND ANALYSIS RUNNER
+ *
+ * Runs KalmanTrendAnalyzer over candle data and generates an interactive HTML chart.
+ *
+ * Usage:
+ *   tsx analysis/analyze_kalman.ts \
+ *     --source json \
+ *     --file market_adapter/data/lp/<path>/<to>/<lp-candles>.json
+ */
+export {};
+//# sourceMappingURL=analyze_kalman.d.ts.map

package/dist/analysis/analyze_kalman.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze_kalman.d.ts","sourceRoot":"","sources":["../../analysis/analyze_kalman.ts"],"names":[],"mappings":";AAEA;;;;;;;;;GASG"}

package/dist/analysis/analyze_kalman.js

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+/**
+ * KALMAN TREND ANALYSIS RUNNER
+ *
+ * Runs KalmanTrendAnalyzer over candle data and generates an interactive HTML chart.
+ *
+ * Usage:
+ *   tsx analysis/analyze_kalman.ts \
+ *     --source json \
+ *     --file market_adapter/data/lp/<path>/<to>/<lp-candles>.json
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+const path = require('path');
+const { PATHS } = require('../modules/paths');
+const { KalmanTrendAnalyzer } = require('./trend_detection/kalman_trend_analyzer');
+const { generateHTML } = require('./trend_detection/kalman_chart_generator');
+const { createSource } = require('./price_sources');
+const { calculateAMA } = require('../market_adapter/core/strategies/ama');
+const { computeATR, getCandleClose } = require('./math_utils');
+const { writeChartFile } = require('./chart_utils');
+// Mirror ama_slope_model.ts defaults for a fair comparison
+const AMA_ER_PERIOD = 10;
+const AMA_FAST = 2;
+const AMA_SLOW = 30;
+const LOOKBACK_BARS = 72;
+const NEUTRAL_ZONE = 0.15;
+const MAX_SLOPE_PCT = 3.0;
+const MAX_SLOPE_OFFSET = 0.5;
+const ATR_PERIOD = 14;
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const config = {
+        source: { type: 'market_adapter', config: { botKey: 'XRP-BTS' } },
+        rNoise: 0.05,
+        qNoise: 0.005,
+        chartFile: 'analysis/charts/kalman_chart.html',
+        quiet: false,
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--source')
+            config.source.type = args[++i];
+        else if (arg === '--bot-key')
+            config.source.config.botKey = args[++i];
+        else if (arg === '--file') {
+            config.source.config.filePath = args[++i];
+            config.source.type = 'json';
+        }
+        else if (arg === '--r')
+            config.rNoise = parseFloat(args[++i]);
+        else if (arg === '--q')
+            config.qNoise = parseFloat(args[++i]);
+        else if (arg === '--chart')
+            config.chartFile = args[++i];
+        else if (arg === '--quiet')
+            config.quiet = true;
+    }
+    return config;
+}
+async function main() {
+    const config = parseArgs();
+    try {
+        const srcConfig = config.source.config;
+        if (config.source.type === 'market_adapter' && !srcConfig.stateDir) {
+            srcConfig.stateDir = PATHS.MARKET_ADAPTER.STATE_DIR;
+        }
+        const source = createSource(config.source.type, srcConfig);
+        if (!config.quiet)
+            console.log(`[Kalman] Loading candles from ${source.name}...`);
+        const candles = await source.fetchCandles();
+        if (!Array.isArray(candles) || candles.length === 0) {
+            throw new Error('No candles returned from source');
+        }
+        // ── Kalman analysis ──────────────────────────────────────────────────
+        const analyzer = new KalmanTrendAnalyzer({
+            rNoise: config.rNoise,
+            qNoise: config.qNoise
+        });
+        const allResults = [];
+        for (let i = 0; i < candles.length; i++) {
+            const { marketPrice, timestamp } = source.extractMarketPrice(candles[i]);
+            const result = analyzer.update(marketPrice);
+            result.timestamp = timestamp;
+            allResults.push(result);
+        }
+        // ── AMA weight offset (for comparison panel) ─────────────────────────
+        const closes = candles.map(c => getCandleClose(c) ?? 0);
+        const amaValues = calculateAMA(closes, { erPeriod: AMA_ER_PERIOD, fastPeriod: AMA_FAST, slowPeriod: AMA_SLOW });
+        const atrs = computeATR(candles, ATR_PERIOD);
+        const warmup = AMA_ER_PERIOD + LOOKBACK_BARS + 1;
+        for (let i = 0; i < allResults.length; i++) {
+            if (i < warmup) {
+                allResults[i].amaWeightOffset = null;
+                continue;
+            }
+            const last = amaValues[i];
+            const past = amaValues[i - LOOKBACK_BARS];
+            if (!last || !past || past === 0) {
+                allResults[i].amaWeightOffset = null;
+                continue;
+            }
+            const slopePct = (last - past) / past * 100;
+            if (Math.abs(slopePct) < NEUTRAL_ZONE) {
+                allResults[i].amaWeightOffset = 0;
+            }
+            else {
+                allResults[i].amaWeightOffset = Math.max(-MAX_SLOPE_OFFSET, Math.min(MAX_SLOPE_OFFSET, (slopePct / MAX_SLOPE_PCT) * MAX_SLOPE_OFFSET));
+            }
+        }
+        // ── Generate chart ───────────────────────────────────────────────────
+        const html = generateHTML({ allResults }, 'Kalman Trend Analysis');
+        writeChartFile(config.chartFile, html);
+        if (!config.quiet)
+            console.log(`[Kalman] ✓ Chart saved to ${config.chartFile}`);
+    }
+    catch (err) {
+        console.error(`[Kalman] Error: ${err.message}`);
+        process.exit(1);
+    }
+}
+main().catch(err => { console.error(err); process.exit(1); });
+//# sourceMappingURL=analyze_kalman.js.map

package/dist/analysis/analyze_kalman.js.map

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

package/dist/analysis/analyze_regime.d.ts

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * REGIME ANALYSIS TOOL
+ *
+ * Computes Hurst Exponent and Permutation Entropy over historical candle data.
+ *
+ *   Hurst H > 0.55 = trending (persistent)  → trust trend-following signals
+ *   Hurst H ≈ 0.50 = random walk            → no edge, stay flat
+ *   Hurst H < 0.45 = mean-reverting         → suppress or invert trend signals
+ *
+ *   Norm. PE < 0.60 = structured            → signals are reliable
+ *   Norm. PE > 0.85 = noise                 → no exploitable structure
+ *
+ * Usage:
+ *   tsx analysis/analyze_regime.ts \
+ *     --source json \
+ *     --file market_adapter/data/lp/<path>/<to>/<lp-candles>.json
+ */
+export {};
+//# sourceMappingURL=analyze_regime.d.ts.map

package/dist/analysis/analyze_regime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze_regime.d.ts","sourceRoot":"","sources":["../../analysis/analyze_regime.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/analysis/analyze_regime.js

@@ -0,0 +1,139 @@
+#!/usr/bin/env node
+/**
+ * REGIME ANALYSIS TOOL
+ *
+ * Computes Hurst Exponent and Permutation Entropy over historical candle data.
+ *
+ *   Hurst H > 0.55 = trending (persistent)  → trust trend-following signals
+ *   Hurst H ≈ 0.50 = random walk            → no edge, stay flat
+ *   Hurst H < 0.45 = mean-reverting         → suppress or invert trend signals
+ *
+ *   Norm. PE < 0.60 = structured            → signals are reliable
+ *   Norm. PE > 0.85 = noise                 → no exploitable structure
+ *
+ * Usage:
+ *   tsx analysis/analyze_regime.ts \
+ *     --source json \
+ *     --file market_adapter/data/lp/<path>/<to>/<lp-candles>.json
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+const path = require('path');
+const { PATHS } = require('../modules/paths');
+const { MARKET_ADAPTER } = require('../modules/constants');
+const HURST_CONFIG = MARKET_ADAPTER.HURST_CONFIG;
+const PE_CONFIG = MARKET_ADAPTER.PE_CONFIG;
+const { HurstAnalyzer } = require('./trend_detection/hurst_analyzer');
+const { PermutationEntropyAnalyzer } = require('./trend_detection/permutation_entropy_analyzer');
+const { generateRegimeHTML } = require('./trend_detection/regime_chart_generator');
+const { createSource } = require('./price_sources');
+const { calculateAMA } = require('../market_adapter/core/strategies/ama');
+const { writeChartFile } = require('./chart_utils');
+const { getCandleClose } = require('./math_utils');
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const config = {
+        source: { type: 'market_adapter', config: { botKey: 'XRP-BTS' } },
+        chartFile: 'analysis/charts/regime_chart.html',
+        hurstWindow: HURST_CONFIG.window,
+        peWindow: PE_CONFIG.window,
+        peM: PE_CONFIG.m,
+        quiet: false,
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--source')
+            config.source.type = args[++i];
+        else if (arg === '--bot-key')
+            config.source.config.botKey = args[++i];
+        else if (arg === '--file') {
+            config.source.config.filePath = args[++i];
+            config.source.type = 'json';
+        }
+        else if (arg === '--chart')
+            config.chartFile = args[++i];
+        else if (arg === '--hurst-window')
+            config.hurstWindow = parseInt(args[++i], 10);
+        else if (arg === '--pe-window')
+            config.peWindow = parseInt(args[++i], 10);
+        else if (arg === '--pe-m')
+            config.peM = parseInt(args[++i], 10);
+        else if (arg === '--quiet')
+            config.quiet = true;
+    }
+    return config;
+}
+async function main() {
+    const config = parseArgs();
+    try {
+        const srcConfig = config.source.config;
+        if (config.source.type === 'market_adapter' && !srcConfig.stateDir) {
+            srcConfig.stateDir = PATHS.MARKET_ADAPTER.STATE_DIR;
+        }
+        const source = createSource(config.source.type, srcConfig);
+        if (!config.quiet)
+            console.log(`[Regime] Loading candles from ${source.name}...`);
+        const candles = await source.fetchCandles();
+        if (!Array.isArray(candles) || candles.length === 0) {
+            throw new Error('No candles returned from source');
+        }
+        // ── Regime analyzers ─────────────────────────────────────────────────
+        const hurstAnalyzer = new HurstAnalyzer({
+            window: config.hurstWindow,
+            scales: HURST_CONFIG.scales,
+        });
+        const peAnalyzer = new PermutationEntropyAnalyzer({
+            m: config.peM,
+            delay: PE_CONFIG.delay,
+            window: config.peWindow,
+        });
+        const allResults = [];
+        for (let i = 0; i < candles.length; i++) {
+            const { marketPrice, timestamp } = source.extractMarketPrice(candles[i]);
+            const hurst = hurstAnalyzer.update(marketPrice);
+            const pe = peAnalyzer.update(marketPrice);
+            allResults.push({
+                timestamp,
+                price: marketPrice,
+                hurst: hurst.hurst,
+                hurstRegime: hurst.regime,
+                hurstRegimeStrength: hurst.regimeStrength,
+                hurstReady: hurst.isReady,
+                normalizedEntropy: pe.normalizedEntropy,
+                entropy: pe.entropy,
+                peRegime: pe.regime,
+                peRegimeStrength: pe.regimeStrength,
+                peReady: pe.isReady,
+            });
+        }
+        // ── AMA3 overlay for price panel ─────────────────────────────────────
+        const closes = candles.map(c => getCandleClose(c) ?? 0);
+        const ama3Values = calculateAMA(closes, MARKET_ADAPTER.AMAS.AMA3);
+        for (let i = 0; i < allResults.length; i++) {
+            allResults[i].ama3Price = ama3Values[i] ?? null;
+        }
+        // ── Print tail summary ───────────────────────────────────────────────
+        if (!config.quiet) {
+            const last = allResults[allResults.length - 1];
+            console.log(`[Regime] ${candles.length} bars processed`);
+            console.log(`[Regime] Last bar:`);
+            console.log(`         Hurst H=${last.hurst}  regime=${last.hurstRegime}`);
+            console.log(`         PE    e=${last.normalizedEntropy}  regime=${last.peRegime}`);
+        }
+        // ── Generate chart ───────────────────────────────────────────────────
+        const html = generateRegimeHTML({
+            allResults,
+            hurstConfig: { window: config.hurstWindow, scales: HURST_CONFIG.scales },
+            peConfig: { m: config.peM, window: config.peWindow },
+        }, 'Regime Analysis \u2014 Hurst \u00b7 Permutation Entropy');
+        writeChartFile(config.chartFile, html);
+        if (!config.quiet)
+            console.log(`[Regime] \u2713 Chart saved to ${config.chartFile}`);
+    }
+    catch (err) {
+        console.error(`[Regime] Error: ${err.message}`);
+        process.exit(1);
+    }
+}
+main().catch(err => { console.error(err); process.exit(1); });
+//# sourceMappingURL=analyze_regime.js.map

package/dist/analysis/analyze_regime.js.map

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

package/dist/analysis/analyze_regime_windows.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * REGIME WINDOW OPTIMIZER
+ *
+ * Grid-searches optimal Hurst and Permutation Entropy window sizes to maximize
+ * regime quality — a composite score of stability, directional accuracy, and
+ * information content.
+ *
+ * Scoring:
+ *   - regimeStability: mean duration (bars) before regime switches
+ *   - entropyDefect: penalty for being stuck in the "random" band (H 0.45–0.55)
+ *
+ * Usage:
+ *   tsx analysis/analyze_regime_windows.ts \
+ *     --source json \
+ *     --file market_adapter/data/lp/<path>/<to>/<lp-candles>.json
+ */
+export {};
+//# sourceMappingURL=analyze_regime_windows.d.ts.map

package/dist/analysis/analyze_regime_windows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze_regime_windows.d.ts","sourceRoot":"","sources":["../../analysis/analyze_regime_windows.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;GAeG"}