@senpi/trading-recipe 1.0.21

package/examples/scanners-emerging-movers-v4.mjs

@@ -0,0 +1,285 @@
+/**
+ * Emerging-movers v4 — signal detection showcase
+ *
+ * Demonstrates the five signal types detected by the emerging-movers scanner
+ * using a simulated 50-token SM leaderboard that evolves over 4 scans:
+ *
+ *   Scan 1: baseline (warm-up, no signals emitted)
+ *   Scan 2: FIRST_JUMP (WIF rockets from #45 to #3),
+ *           CONTRIB_EXPLOSION (ONDO goes 4x contribution),
+ *           NEW_ENTRY_DEEP (PENDLE appears at #8)
+ *   Scan 3: IMMEDIATE_MOVER (JUP jumps 15 ranks from #28),
+ *           DEEP_CLIMBER (RENDER climbs 6 ranks from #32)
+ *   Scan 4: climb streak + multi-scan climbing for tokens that kept improving
+ *
+ * Run:
+ *   npm run build && node examples/scanners-emerging-movers-v4.mjs
+ */
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import {
+  createScannerRuntimeModule,
+  emergingMoversScanner,
+} from "../dist/scanners/index.js";
+
+// ─── Simulated SM leaderboard ───────────────────────────────────────────────
+// 50 tokens with realistic contribution and trader distributions. Specific
+// tokens are manipulated across scans to trigger each v4 signal type.
+
+function makeBaseLeaderboard() {
+  const tokens = [
+    "BTC", "ETH", "SOL", "DOGE", "PEPE", "AVAX", "LINK", "MATIC",
+    "ARB", "OP", "SUI", "APT", "INJ", "TIA", "SEI", "NEAR",
+    "FTM", "ATOM", "DOT", "ADA", "XRP", "BNB", "UNI", "AAVE",
+    "MKR", "LDO", "CRV", "SNX", "COMP", "ONDO", "WIF", "JUP",
+    "RENDER", "FET", "RNDR", "PYTH", "JTO", "STRK", "MANTA", "DYM",
+    "PIXEL", "PORTAL", "ETHFI", "W", "ENA", "BOME", "SLERF", "MEW",
+    "MYRO", "BONK",
+  ];
+
+  return tokens.map((token, i) => ({
+    token,
+    direction: "up",
+    // Contribution decreases roughly linearly; top tokens dominate
+    pctOfTopTradersGain: Math.max(0.001, 0.50 - i * 0.009),
+    traderCount: Math.max(10, 500 - i * 8),
+    tokenPriceChangePct4h: Math.max(-2, 8 - i * 0.3),
+  }));
+}
+
+/** Scan 1: Baseline snapshot. Scanner warms up (no signals emitted). */
+function scan1() {
+  return makeBaseLeaderboard();
+}
+
+/**
+ * Scan 2: Three dramatic events.
+ * - WIF (was #31, contrib 0.230) rockets to massive contribution → lands ~#3
+ * - ONDO (was #30, contrib 0.239) goes 4x contribution → CONTRIB_EXPLOSION
+ * - PENDLE (new token, wasn't in scan 1) appears with high contribution → NEW_ENTRY_DEEP
+ */
+function scan2() {
+  const board = makeBaseLeaderboard();
+
+  // WIF: was at index 30 (rank ~31). Boost contribution so it sorts to ~rank 3.
+  // Also: WIF was ranked 31 (>= firstJumpMinPrevRank=30), triggering FIRST_JUMP.
+  const wif = board.find((m) => m.token === "WIF");
+  wif.pctOfTopTradersGain = 0.48;
+  wif.traderCount = 420;
+  wif.tokenPriceChangePct4h = 15.2;
+
+  // ONDO: was at index 29 (rank ~30). 4x its contribution for CONTRIB_EXPLOSION.
+  const ondo = board.find((m) => m.token === "ONDO");
+  ondo.pctOfTopTradersGain = ondo.pctOfTopTradersGain * 4.5;
+  ondo.traderCount = 310;
+  ondo.tokenPriceChangePct4h = 9.1;
+
+  // JUP: boost in scan 2 so it lands ~rank 26–29 (between deepClimbRankThreshold
+  // and firstJumpMinPrevRank). This sets up scan 3's IMMEDIATE_MOVER — prevRank
+  // will be >= 25 (qualifies as deep) but < 30 (not deep enough for FIRST_JUMP).
+  const jup = board.find((m) => m.token === "JUP");
+  jup.pctOfTopTradersGain = 0.28;
+  jup.traderCount = 260;
+
+  // PENDLE: replace a low-ranked filler token so PENDLE appears fresh.
+  const pendle = board.findIndex((m) => m.token === "BONK");
+  board[pendle] = {
+    token: "PENDLE",
+    direction: "up",
+    pctOfTopTradersGain: 0.42,
+    traderCount: 280,
+    tokenPriceChangePct4h: 7.8,
+  };
+
+  return board;
+}
+
+/**
+ * Scan 3: Rank-based signals.
+ * - JUP jumps 15+ ranks from ~#27 → IMMEDIATE_MOVER (not FIRST_JUMP because prevRank < 30)
+ * - RENDER climbs 6 ranks from deep → DEEP_CLIMBER
+ * - PENDLE continues climbing slightly (building streak history)
+ */
+function scan3() {
+  const board = makeBaseLeaderboard();
+
+  // Keep WIF high (now a returning token, not a first jump)
+  const wif = board.find((m) => m.token === "WIF");
+  wif.pctOfTopTradersGain = 0.46;
+  wif.traderCount = 400;
+
+  // ONDO settles back a bit (no longer 4x, so no explosion this scan)
+  const ondo = board.find((m) => m.token === "ONDO");
+  ondo.pctOfTopTradersGain = 0.35;
+
+  // PENDLE still present, climbing a bit
+  const pendle = board.findIndex((m) => m.token === "BONK");
+  board[pendle] = {
+    token: "PENDLE",
+    direction: "up",
+    pctOfTopTradersGain: 0.43,
+    traderCount: 290,
+    tokenPriceChangePct4h: 6.5,
+  };
+
+  // In scan 2, JUP was at its default position (index 31, contrib ~0.221).
+  // After sorting in scan 2 (with WIF and ONDO boosted), JUP lands around rank ~27.
+  // Here we give JUP a contribution that sorts it to ~rank 10, a jump of 15+.
+  // prevRank ~27 is >= deepClimbRankThreshold (25) but < firstJumpMinPrevRank (30),
+  // so it qualifies as IMMEDIATE_MOVER, not FIRST_JUMP.
+  const jup = board.find((m) => m.token === "JUP");
+  jup.pctOfTopTradersGain = 0.44;
+  jup.traderCount = 350;
+  jup.tokenPriceChangePct4h = 11.0;
+
+  // RENDER: was at index 32 (rank ~33). Moderate boost for DEEP_CLIMBER.
+  const render = board.find((m) => m.token === "RENDER");
+  render.pctOfTopTradersGain = 0.30;
+  render.traderCount = 240;
+  render.tokenPriceChangePct4h = 5.3;
+
+  return board;
+}
+
+/**
+ * Scan 4: Sustained climbing.
+ * - RENDER continues climbing → STREAK signal
+ * - PENDLE continues climbing → multi-scan CLIMBING detection
+ */
+function scan4() {
+  const board = makeBaseLeaderboard();
+
+  // WIF, ONDO, JUP remain high but stable
+  const wif = board.find((m) => m.token === "WIF");
+  wif.pctOfTopTradersGain = 0.45;
+  const ondo = board.find((m) => m.token === "ONDO");
+  ondo.pctOfTopTradersGain = 0.34;
+  const jup = board.find((m) => m.token === "JUP");
+  jup.pctOfTopTradersGain = 0.43;
+
+  // PENDLE keeps climbing
+  const pendle = board.findIndex((m) => m.token === "BONK");
+  board[pendle] = {
+    token: "PENDLE",
+    direction: "up",
+    pctOfTopTradersGain: 0.45,
+    traderCount: 310,
+    tokenPriceChangePct4h: 8.2,
+  };
+
+  // RENDER continues improving
+  const render = board.find((m) => m.token === "RENDER");
+  render.pctOfTopTradersGain = 0.36;
+  render.traderCount = 270;
+  render.tokenPriceChangePct4h = 6.8;
+
+  return board;
+}
+
+// ─── Main ───────────────────────────────────────────────────────────────────
+
+const SCAN_DATA = [scan1, scan2, scan3, scan4];
+
+async function main() {
+  const stateDir = await mkdtemp(join(tmpdir(), "emerging-movers-v4-"));
+  let scanIndex = 0;
+
+  const module = createScannerRuntimeModule({
+    stateDir,
+    scanners: [emergingMoversScanner],
+    strategies: [
+      {
+        id: "wolf",
+        name: "Wolf Strategy",
+        scannerOverrides: {
+          "emerging-movers": {
+            config: {
+              // Production-like v4 configuration
+              topN: 50,
+              minRankJump: 5,
+              minTopTradersGain: 0.01,
+              minScansBeforeSignals: 2,
+              historyLimit: 60,
+              immediateJumpThreshold: 10,
+              deepClimbRankThreshold: 25,
+              contribExplosionMultiplier: 3.0,
+              contribAccelThreshold: 0.003,
+              minVelocityForDeepClimber: 0.0003,
+              erraticReversalThreshold: 5,
+              climbStreakScans: 3,
+              rankClimbThreshold: 3,
+              newEntryDeepMaxRank: 20,
+              newEntryMaxRank: 35,
+              firstJumpMinPrevRank: 30,
+            },
+          },
+        },
+      },
+    ],
+    providers: {
+      getSmData: async () => {
+        const data = SCAN_DATA[scanIndex]();
+        scanIndex++;
+        return data;
+      },
+    },
+  });
+
+  try {
+    for (let i = 0; i < SCAN_DATA.length; i++) {
+      const result = await module.runOnce("wolf", "emerging-movers");
+      console.log(`\n── Scan ${i + 1} ──────────────────────────────────────`);
+      console.log(`Status: ${result.status} | Scanned: ${result.scannedCount} | Signals: ${result.signals.length}`);
+
+      if (result.signals.length === 0) {
+        console.log("(warm-up scan — no signals yet)");
+        continue;
+      }
+
+      for (const signal of result.signals) {
+        const m = signal.meta;
+        console.log(
+          `  [${signal.signalType}] ${signal.asset}`,
+          `| score=${signal.score}`,
+          `| rank=#${m.rank}`,
+          `| prev=#${m.prevRank ?? "new"}`,
+          `| jump=${m.jump}`,
+          `| vel=${m.contribVelocity}`,
+        );
+        console.log(`    reasons: ${(m.reasons).join(", ")}`);
+
+        const activeFactors = Object.entries(signal.factors)
+          .filter(([, v]) => v)
+          .map(([k]) => k);
+        if (activeFactors.length > 0) {
+          console.log(`    factors: ${activeFactors.join(", ")}`);
+        }
+      }
+
+      // Print summary breakdown
+      const bd = result.summary.signalBreakdown;
+      const counts = Object.entries(bd).filter(([, v]) => v > 0);
+      if (counts.length > 0) {
+        console.log(`  summary: ${counts.map(([k, v]) => `${k}=${v}`).join(", ")}`);
+      }
+    }
+
+    // Query all persisted signals
+    const allSignals = await module.querySignals({ strategyId: "wolf", limit: 50 });
+    console.log(`\n── Total persisted signals: ${allSignals.length} ──`);
+    const byType = {};
+    for (const s of allSignals) {
+      byType[s.signalType] = (byType[s.signalType] || 0) + 1;
+    }
+    console.log("By type:", byType);
+  } finally {
+    await module.stop();
+    await rm(stateDir, { recursive: true, force: true });
+  }
+}
+
+main().catch((error) => {
+  console.error(error);
+  process.exit(1);
+});

package/examples/scanners-liquidation-watchdog.mjs

@@ -0,0 +1,331 @@
+/**
+ * Liquidation-watchdog scanner e2e examples.
+ *
+ * Run:  node examples/scanners-liquidation-watchdog.mjs
+ *
+ * Two scenarios:
+ *   1. Without DSL states — scanner operates with margin/liq checks only.
+ *   2. With DSL states — scanner enriches liq-distance alerts with DSL floor info.
+ */
+
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import {
+  createScannerRuntimeModule,
+  liquidationWatchdogScanner,
+} from "../dist/scanners/index.js";
+import { StateManager } from "../dist/state/index.js";
+
+// ─── Shared fixtures ────────────────────────────────────────────────────────
+
+function makeClearingHouseState({ bufferPct, positions }) {
+  // bufferPct controls how much margin room is left:
+  //   buffer = (accountValue - crossMaintenanceMargin) / accountValue * 100
+  //   → crossMaintenanceMargin = accountValue * (1 - bufferPct / 100)
+  const accountValue = 10_000;
+  const crossMaintenanceMargin = accountValue * (1 - bufferPct / 100);
+  return {
+    accountValue,
+    totalMarginUsed: crossMaintenanceMargin,
+    crossMaintenanceMargin,
+    availableBalance: accountValue - crossMaintenanceMargin,
+    positions: positions ?? [],
+  };
+}
+
+function makePosition({ asset, direction, markPrice, liqPrice, roe, marginType }) {
+  return {
+    asset,
+    direction: direction ?? "LONG",
+    size: 1,
+    entryPrice: markPrice * 0.95,
+    markPrice,
+    liquidationPrice: liqPrice ?? null,
+    unrealizedPnl: markPrice * 0.05,
+    roe: roe ?? 5,
+    leverage: 5,
+    marginType: marginType ?? "cross",
+  };
+}
+
+// ─── Scenario 1: Without DSL states ─────────────────────────────────────────
+
+async function scenarioWithoutDslStates() {
+  console.log("\n=== Scenario 1: Without DSL states ===\n");
+
+  const stateDir = await mkdtemp(join(tmpdir(), "watchdog-no-dsl-"));
+
+  // Two runs: first healthy, second critical
+  let run = 0;
+  const clearingHouseRuns = [
+    // Run 1: healthy — 80% buffer, positions far from liq
+    makeClearingHouseState({
+      bufferPct: 80,
+      positions: [
+        makePosition({ asset: "BTC", markPrice: 60000, liqPrice: 20000, roe: 12 }),
+        makePosition({ asset: "ETH", markPrice: 3000, liqPrice: 1000, roe: 8 }),
+      ],
+    }),
+    // Run 2: critical — 20% buffer, one position with bad ROE and tight liq
+    makeClearingHouseState({
+      bufferPct: 20,
+      positions: [
+        makePosition({ asset: "BTC", markPrice: 60000, liqPrice: 20000, roe: 5 }),
+        makePosition({ asset: "ETH", markPrice: 3000, liqPrice: 2700, roe: -25, marginType: "cross" }),
+      ],
+    }),
+  ];
+
+  const module = createScannerRuntimeModule({
+    stateDir,
+    scanners: [liquidationWatchdogScanner],
+    strategies: [
+      {
+        id: "wallet-001",
+        name: "Trader-A",
+        scannerOverrides: {
+          "liquidation-watchdog": {
+            config: {
+              bufferWarningPct: 50,
+              bufferCriticalPct: 30,
+              liqDistanceWarningPct: 30,
+              liqDistanceIsolatedWarningPct: 15,
+              roeDangerPct: -15,
+            },
+          },
+        },
+      },
+    ],
+    providers: {
+      getClearingHouseState: async () => clearingHouseRuns[Math.min(run, clearingHouseRuns.length - 1)],
+      getActivePositions: async () => [],
+      getInstruments: async () => [],
+      // No getDslStatesForStrategy — scanner should handle gracefully
+    },
+  });
+
+  try {
+    // Run 1: healthy
+    run = 0;
+    const result1 = await module.runOnce("wallet-001", "liquidation-watchdog");
+    console.log("Run 1 (healthy):");
+    console.log("  scannedCount:", result1.scannedCount);
+    console.log("  signals:", result1.signals.length);
+    console.log("  summary.marginBuffer:", result1.summary.marginBuffer);
+    console.log("  summary.alertCount:", result1.summary.alertCount);
+    console.log("  summary.consecutiveCleanChecks:", result1.summary.consecutiveCleanChecks);
+    console.assert(result1.signals.length === 0, "Expected 0 signals for healthy state");
+    console.assert(result1.summary.consecutiveCleanChecks === 1, "Expected 1 clean check");
+
+    // Run 2: critical buffer + tight liq + bad ROE
+    run = 1;
+    const result2 = await module.runOnce("wallet-001", "liquidation-watchdog");
+    console.log("\nRun 2 (critical):");
+    console.log("  scannedCount:", result2.scannedCount);
+    console.log("  signals:", result2.signals.length);
+    console.log("  summary.marginBuffer:", result2.summary.marginBuffer);
+    console.log("  summary.alertCount:", result2.summary.alertCount);
+    console.log("  summary.consecutiveCleanChecks:", result2.summary.consecutiveCleanChecks);
+
+    const closeSignals = result2.signals.filter((s) => s.signalType === "WATCHDOG_CLOSE");
+    const alertSignals = result2.signals.filter((s) => s.signalType === "WATCHDOG_ALERT");
+    console.log("  WATCHDOG_CLOSE signals:", closeSignals.length);
+    console.log("  WATCHDOG_ALERT signals:", alertSignals.length);
+
+    if (closeSignals.length > 0) {
+      console.log("  Close target asset:", closeSignals[0].asset, "(lowest ROE)");
+      console.log("  Close meta:", JSON.stringify(closeSignals[0].meta, null, 2));
+    }
+
+    // Verify no alert message contains "DSL floor" since no DSL states were provided
+    const allMessages = alertSignals.map((s) => s.meta.message);
+    const hasDslFloorNote = allMessages.some((m) => typeof m === "string" && m.includes("DSL floor"));
+    console.assert(!hasDslFloorNote, "Expected no DSL floor notes without dslStates provider");
+    console.assert(closeSignals.length >= 1, "Expected at least 1 WATCHDOG_CLOSE signal");
+    console.assert(closeSignals[0]?.asset === "ETH", "Expected ETH (lowest ROE) as close target");
+    console.assert(result2.summary.consecutiveCleanChecks === 0, "Expected 0 clean checks after alert");
+
+    console.log("\n  [PASS] Scenario 1 completed successfully");
+  } finally {
+    await module.stop();
+    await rm(stateDir, { recursive: true, force: true });
+  }
+}
+
+// ─── Scenario 2: With DSL states from StateManager ──────────────────────────
+
+async function scenarioWithDslStates() {
+  console.log("\n=== Scenario 2: With DSL states from StateManager ===\n");
+
+  const stateDir = await mkdtemp(join(tmpdir(), "watchdog-with-dsl-"));
+
+  // Seed the StateManager with DSL state files (as the DSL plugin would)
+  const stateManager = new StateManager(stateDir);
+
+  const baseDslState = {
+    version: 1,
+    address: "wallet-002",
+    wallet: "wallet-002",
+    dex: "",
+    highWaterPrice: 0,
+    hwTimestamp: new Date().toISOString(),
+    currentBreachCount: 0,
+    currentTierIndex: null,
+    tierFloorPrice: 0,
+    tiers: [],
+    phase1: { retraceThreshold: 5, absoluteFloor: 0, consecutiveBreachesRequired: 3 },
+    phase2: { retraceFromHW: 4, consecutiveBreachesRequired: 2 },
+    phase2TriggerTier: 0,
+    slOrderId: null,
+    lastSyncedFloorPrice: null,
+    slOrderIdUpdatedAt: null,
+    lastSlSyncError: null,
+    pendingClose: false,
+    active: true,
+    createdAt: new Date().toISOString(),
+    lastCheck: new Date().toISOString(),
+    consecutiveFetchFailures: 0,
+    tickCount: 0,
+    peakROE: 0,
+    lastError: null,
+    lastErrorAt: null,
+    closedAt: null,
+    closeReason: null,
+  };
+
+  await stateManager.setDslState("wallet-002", "BTC", "", {
+    ...baseDslState,
+    asset: "BTC",
+    direction: "LONG",
+    entryPrice: 58000,
+    size: 1,
+    leverage: 5,
+    highWaterPrice: 62000,
+    phase: 2,
+    currentTierIndex: 1,
+    tierFloorPrice: 57000,
+    floorPrice: 56500,    // DSL floor for BTC
+    lastPrice: 60000,
+    peakROE: 15,
+    tickCount: 100,
+  });
+
+  await stateManager.setDslState("wallet-002", "SOL", "", {
+    ...baseDslState,
+    asset: "SOL",
+    direction: "LONG",
+    entryPrice: 140,
+    size: 10,
+    leverage: 5,
+    highWaterPrice: 155,
+    phase: 1,
+    tierFloorPrice: 135,
+    floorPrice: 133,      // DSL floor for SOL
+    lastPrice: 150,
+    peakROE: 10,
+    tickCount: 50,
+  });
+
+  // Verify StateManager has the states
+  const loaded = stateManager.listDslStates("wallet-002");
+  console.log("  StateManager DSL states loaded:", loaded.length);
+  console.assert(loaded.length === 2, "Expected 2 DSL states in StateManager");
+
+  // Critical clearinghouse scenario
+  const clearingHouse = makeClearingHouseState({
+    bufferPct: 25, // CRITICAL
+    positions: [
+      makePosition({ asset: "BTC", markPrice: 60000, liqPrice: 54000, roe: 3 }),  // 10% liq dist
+      makePosition({ asset: "SOL", markPrice: 150, liqPrice: 130, roe: -18 }),     // ~13.3% liq dist
+    ],
+  });
+
+  // Wire getDslStatesForStrategy to read from the StateManager — same as Runtime does
+  const module = createScannerRuntimeModule({
+    stateDir,
+    scanners: [liquidationWatchdogScanner],
+    strategies: [
+      {
+        id: "wallet-002",
+        name: "Trader-B",
+        scannerOverrides: {
+          "liquidation-watchdog": {
+            config: {
+              bufferWarningPct: 50,
+              bufferCriticalPct: 30,
+              liqDistanceWarningPct: 30,
+              roeDangerPct: -15,
+            },
+          },
+        },
+      },
+    ],
+    providers: {
+      getClearingHouseState: async () => clearingHouse,
+      getActivePositions: async () => [],
+      getInstruments: async () => [],
+      getDslStatesForStrategy: async (address) => stateManager.listDslStates(address),
+    },
+  });
+
+  try {
+    const result = await module.runOnce("wallet-002", "liquidation-watchdog");
+
+    console.log("Run (critical + DSL from StateManager):");
+    console.log("  scannedCount:", result.scannedCount);
+    console.log("  signals:", result.signals.length);
+    console.log("  summary.marginBuffer:", result.summary.marginBuffer);
+    console.log("  summary.alertCount:", result.summary.alertCount);
+
+    const closeSignals = result.signals.filter((s) => s.signalType === "WATCHDOG_CLOSE");
+    const alertSignals = result.signals.filter((s) => s.signalType === "WATCHDOG_ALERT");
+    console.log("  WATCHDOG_CLOSE signals:", closeSignals.length);
+    console.log("  WATCHDOG_ALERT signals:", alertSignals.length);
+
+    if (closeSignals.length > 0) {
+      console.log("  Close target:", closeSignals[0].asset, "ROE:", closeSignals[0].meta.roe);
+    }
+
+    // Check that liq-distance alerts include DSL floor notes from StateManager
+    const liqAlertMessages = alertSignals
+      .filter((s) => typeof s.meta.message === "string" && s.meta.message.includes("Liquidation distance"))
+      .map((s) => s.meta.message);
+
+    console.log("\n  Liquidation distance alert messages:");
+    for (const msg of liqAlertMessages) {
+      console.log("    -", msg);
+    }
+
+    const hasDslFloorNote = liqAlertMessages.some((m) => m.includes("DSL floor"));
+    console.assert(hasDslFloorNote, "Expected at least one liq alert with DSL floor note");
+    console.assert(closeSignals.length >= 1, "Expected WATCHDOG_CLOSE on critical buffer");
+    console.assert(closeSignals[0]?.asset === "SOL", "Expected SOL (lowest ROE -18) as close target");
+
+    // Verify BTC alert includes DSL floor $56500.00 (from StateManager)
+    const btcAlert = liqAlertMessages.find((m) => m.includes("BTC"));
+    console.assert(btcAlert?.includes("DSL floor: $56500.00"), "Expected BTC alert to contain DSL floor $56500.00 from StateManager");
+
+    // Verify SOL alert includes DSL floor $133.00 (from StateManager)
+    const solAlert = liqAlertMessages.find((m) => m.includes("SOL"));
+    console.assert(solAlert?.includes("DSL floor: $133.00"), "Expected SOL alert to contain DSL floor $133.00 from StateManager");
+
+    console.log("\n  [PASS] Scenario 2 completed successfully");
+  } finally {
+    await module.stop();
+    await rm(stateDir, { recursive: true, force: true });
+  }
+}
+
+// ─── Main ───────────────────────────────────────────────────────────────────
+
+async function main() {
+  await scenarioWithoutDslStates();
+  await scenarioWithDslStates();
+  console.log("\nAll scenarios passed.\n");
+}
+
+main().catch((error) => {
+  console.error(error);
+  process.exit(1);
+});