perp-cli 0.9.8 → 0.12.0

package/skills/perp-cli/references/commands.md

@@ -69,7 +69,11 @@ perp --json trade market <SYM> buy <SIZE> --split   # split via market command f
 perp --json trade market <SYM> buy <SIZE> --split --max-slippage 0.5
 ```
 
-## Funds (Deposit, Withdraw, Transfer, Bridge)
+## Funds (Deposit, Withdraw, Transfer, Bridge, Rebalance)
+
+All fund movement lives under `perp funds`.
+
+### Exchange in/out
 ```bash
 perp --json funds deposit pacifica <AMOUNT>
 perp --json funds deposit hyperliquid <AMOUNT>
@@ -79,19 +83,26 @@ perp --json funds deposit lighter info                      # all Lighter deposi
 perp --json funds withdraw pacifica <AMOUNT>
 perp --json funds withdraw hyperliquid <AMOUNT>
 perp --json funds withdraw lighter <AMOUNT>
-perp --json funds transfer <AMOUNT> <ADDRESS>     # HL internal transfer (instant)
-perp --json funds bridge --from <CHAIN> --to <CHAIN> --amount <AMT> --recipient <ADDR>  # CCTP bridge
-perp --json funds bridge-status --hash <HASH>     # check CCTP bridge status
-perp --json funds info                            # combined deposit & withdrawal info
+perp --json funds transfer <AMOUNT> <ADDRESS>               # HL internal transfer (instant)
+perp --json funds info                                      # combined routes & limits
+```
+
+### Cross-chain bridge (multi-provider router: cctp / relay / debridge — auto-cheapest)
+```bash
+perp --json funds bridge chains                   # supported chains
+perp --json funds bridge quote --from <CHAIN> --to <CHAIN> --amount <AMT>
+perp --json funds bridge send --from <CHAIN> --to <CHAIN> --amount <AMT>           # auto-cheapest
+perp --json funds bridge send --from <CHAIN> --to <CHAIN> --amount <AMT> --provider cctp
+perp --json funds bridge exchange --from <EX> --to <EX> --amount <AMT>             # between exchanges
+perp --json funds bridge status <ORDER_ID>
 ```
 
-## Bridge (Cross-chain USDC)
+### Inter-exchange rebalance (orchestrated withdraw → bridge → deposit)
 ```bash
-perp --json bridge chains                   # supported chains
-perp --json bridge quote --from <CHAIN> --to <CHAIN> --amount <AMT>
-perp --json bridge send --from <CHAIN> --to <CHAIN> --amount <AMT>
-perp --json bridge exchange --from <EX> --to <EX> --amount <AMT>
-perp --json bridge status <ORDER_ID>
+perp --json funds rebalance check                            # balances across exchanges
+perp --json funds rebalance plan                             # compute optimal moves
+perp --json funds rebalance execute --auto-bridge            # withdraw → bridge → deposit
+perp --json funds rebalance execute --withdraw-only          # only withdraw, manual rest
 ```
 
 ## Arbitrage
@@ -137,7 +148,6 @@ perp --json risk liquidation-distance       # % distance from liquidation for AL
 perp --json risk limits                     # view current risk limits
 perp --json risk limits --min-liq-distance 30 --max-leverage 5  # set risk limits
 perp --json risk check --notional 1000 --leverage 3  # pre-trade risk check
-perp --json agent ping                      # exchange connectivity & latency
 perp --json history summary                 # trading performance
 perp --json history pnl                     # P&L breakdown by exchange
 perp --json history funding                 # funding payment aggregation
@@ -148,24 +158,34 @@ perp --json history perf --period summary   # performance summary stats
 perp --json history list                    # execution audit trail
 ```
 
-## Automated Strategies (bot — 19 strategies)
+## Automated Strategies (strategy — 19 algorithms + nested scripted plans)
 ```bash
-perp --json bot list-strategies                              # list all 19 strategies
-perp --json bot run <STRATEGY> [SYMBOL]                      # run any registered strategy
-perp --json bot run funding-auto                             # multi-exchange funding arb (no symbol needed)
-perp --json bot apex [SYMBOL]                                # APEX autonomous orchestrator (Radar+Pulse+Guard)
-perp --json bot reflect                                      # trading performance analysis (win rate, fees, PnL)
-perp --json bot preset-list                                  # list strategy presets
-perp --json bot preset <NAME> [SYMBOL]                       # run from preset
-perp --json bot twap <SYMBOL> <SIDE> <SIZE> <DURATION>       # TWAP execution
-perp --json bot grid <SYMBOL> --range <PCT> --grids <N> --size <USD>
-perp --json bot dca <SYMBOL> <SIDE> <AMOUNT> <INTERVAL>
-perp --json bot trailing-stop <SYMBOL>                       # trailing stop with callback %
-perp --json bot funding-arb                                  # auto funding arb
-perp --json bot quick-grid <SYMBOL>                          # quick grid bot
-perp --json bot quick-arb                                    # quick arb bot
-perp --json jobs list                                        # list running jobs
-perp --json jobs stop <ID>                                   # stop a job
+perp --json strategy list-strategies                         # list all 19 strategies
+perp --json strategy run <STRATEGY> [SYMBOL]                 # run any registered strategy
+perp --json strategy run funding-auto                        # multi-exchange funding arb (no symbol needed)
+perp --json strategy apex [SYMBOL]                           # APEX autonomous orchestrator (Radar+Pulse+Guard)
+perp --json strategy reflect                                 # trading performance analysis (win rate, fees, PnL)
+perp --json strategy preset-list                             # list strategy presets
+perp --json strategy preset <NAME> [SYMBOL]                  # run from preset
+perp --json strategy twap <SYMBOL> <SIDE> <SIZE> <DURATION>  # TWAP execution
+perp --json strategy grid <SYMBOL> --range <PCT> --grids <N> --size <USD>
+perp --json strategy dca <SYMBOL> <SIDE> <AMOUNT> <INTERVAL>
+perp --json strategy trailing-stop <SYMBOL>                  # trailing stop with callback %
+perp --json strategy funding-arb                             # auto funding arb
+perp --json strategy quick-grid <SYMBOL>                     # quick grid bot
+perp --json strategy quick-arb                               # quick arb bot
+
+# Scripted execution plans (one-shot multi-step)
+perp --json strategy plan example                            # show plan format
+perp --json strategy plan validate <FILE>                    # validate plan
+perp --json strategy plan execute <FILE> --dry-run           # dry-run plan
+
+# Background process supervisor (tmux)
+perp --json background list                                  # list running jobs
+perp --json background stop <ID>                             # stop a job
+perp --json background logs <ID>                             # view job logs
+perp --json background remove <ID>                           # remove a job entry
+perp --json background clean                                 # remove all stopped/done jobs
 ```
 
 ### Available Strategies
@@ -175,10 +195,11 @@ Arbitrage: `funding-arb`, `funding-auto`, `basis-arb`
 Infrastructure: `hedge-agent`, `rfq-agent`, `claude-agent`
 Classic: `grid`, `dca`, `twap`, `apex`
 
-## Command Discovery
+## Agent Wallet Management
 ```bash
-perp schema                       # Full CLI schema as JSON
-perp agent capabilities           # High-level capability list
-perp agent plan "<goal>"          # Suggest command sequence for a goal
-perp agent ping                   # Health check all exchanges
+perp wallet agent approve <exchange> [--master <name>]   # Register an agent wallet
+perp wallet agent list [exchange]                        # List registered agents
+perp wallet agent revoke <exchange> <agentName>          # Revoke an agent
+perp wallet agent rotate <exchange> [agentName]          # Revoke + re-approve same name
+perp wallet agent verify [exchange] [agentName]          # Verify via DEX query API
 ```

package/skills/perp-cli/scripts/preflight.sh

@@ -41,12 +41,12 @@ else
   add_check "wallet" "fail" "No wallet configured — run: perp wallet set <exchange> <key>"
 fi
 
-# 3. Exchange connectivity
-HEALTH_OUT=$($PERP --json agent ping 2>/dev/null || echo '{"ok":false}')
+# 3. Exchange connectivity (proxy via unauthenticated market prices fetch)
+HEALTH_OUT=$($PERP --json market prices 2>/dev/null || echo '{"ok":false}')
 if echo "$HEALTH_OUT" | grep -q '"ok":true'; then
-  add_check "connectivity" "pass" "Exchanges reachable"
+  add_check "connectivity" "pass" "Exchange reachable"
 else
-  add_check "connectivity" "warn" "Some exchanges unreachable"
+  add_check "connectivity" "warn" "Exchange unreachable"
 fi
 
 # 4. Portfolio & balances

package/skills/perp-cli/scripts/spot-perp-scan.sh

@@ -38,8 +38,8 @@ fi
 # 2. Run appropriate scan
 SCAN_RESULT=$($PERP --json arb scan --mode "$MODE" --min "$MIN_SPREAD" 2>/dev/null || echo '{"ok":false}')
 
-# 3. Get exchange health for context
-HEALTH=$($PERP --json agent ping 2>/dev/null || echo '{"ok":false}')
+# 3. Get exchange health for context (proxy via market prices fetch)
+HEALTH=$($PERP --json market prices 2>/dev/null || echo '{"ok":false}')
 
 if $JSON_MODE; then
   cat <<EOF

package/dist/__tests__/alert-logic.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/__tests__/alert-logic.test.js

@@ -1,107 +0,0 @@
-import { describe, it, expect } from "vitest";
-/**
- * Tests for the alert price merging logic (extracted from alert.ts).
- * Validates the fix for the price map key inconsistency bug.
- */
-function mergePrices(pacData, hlData) {
-    const map = new Map();
-    if (pacData) {
-        for (const p of pacData) {
-            map.set(`pac:${p.symbol}`, Number(p.mark));
-        }
-    }
-    if (hlData) {
-        for (const [symbol, price] of Object.entries(hlData)) {
-            map.set(`hl:${symbol}`, Number(price));
-        }
-    }
-    // Merge into bare symbol keys: prefer pac price, fallback to hl
-    const allSymbols = new Set();
-    for (const k of map.keys()) {
-        if (k.includes(":"))
-            allSymbols.add(k.split(":")[1]);
-    }
-    for (const sym of allSymbols) {
-        const pacPrice = map.get(`pac:${sym}`);
-        const hlPrice = map.get(`hl:${sym}`);
-        map.set(sym, pacPrice ?? hlPrice ?? 0);
-    }
-    return map;
-}
-describe("Alert price merging", () => {
-    it("prefers Pacifica price when both available", () => {
-        const map = mergePrices([{ symbol: "BTC", mark: "100000" }], { BTC: "99900" });
-        expect(map.get("BTC")).toBe(100000);
-        expect(map.get("pac:BTC")).toBe(100000);
-        expect(map.get("hl:BTC")).toBe(99900);
-    });
-    it("falls back to HL price when pac unavailable", () => {
-        const map = mergePrices(null, { ETH: "3500" });
-        expect(map.get("ETH")).toBe(3500);
-        expect(map.has("pac:ETH")).toBe(false);
-        expect(map.get("hl:ETH")).toBe(3500);
-    });
-    it("handles Pacifica-only symbols", () => {
-        const map = mergePrices([{ symbol: "SOL", mark: "150" }], {});
-        expect(map.get("SOL")).toBe(150);
-    });
-    it("handles empty data", () => {
-        const map = mergePrices(null, null);
-        expect(map.size).toBe(0);
-    });
-    it("handles multiple symbols from both sources", () => {
-        const map = mergePrices([
-            { symbol: "BTC", mark: "100000" },
-            { symbol: "ETH", mark: "3500" },
-        ], {
-            BTC: "99900",
-            ETH: "3490",
-            SOL: "150",
-        });
-        // Pac preferred for BTC and ETH
-        expect(map.get("BTC")).toBe(100000);
-        expect(map.get("ETH")).toBe(3500);
-        // HL-only for SOL
-        expect(map.get("SOL")).toBe(150);
-    });
-    it("bare symbol key is always set (no orphaned prefixed keys)", () => {
-        const map = mergePrices([{ symbol: "DOGE", mark: "0.15" }], { DOGE: "0.14", ARB: "1.20" });
-        // Every symbol with a prefixed key should have a bare key
-        for (const k of map.keys()) {
-            if (k.includes(":")) {
-                const bare = k.split(":")[1];
-                expect(map.has(bare)).toBe(true);
-            }
-        }
-    });
-});
-describe("Alert trigger conditions", () => {
-    it("fires price above alert", () => {
-        const currentPrice = 105000;
-        const threshold = 100000;
-        const condition = "above";
-        expect(condition === "above" && currentPrice >= threshold).toBe(true);
-    });
-    it("does NOT fire price above when below", () => {
-        const currentPrice = 95000;
-        const threshold = 100000;
-        const condition = "above";
-        expect(condition === "above" && currentPrice >= threshold).toBe(false);
-    });
-    it("fires price below alert", () => {
-        const currentPrice = 95000;
-        const threshold = 100000;
-        const condition = "below";
-        expect(condition === "below" && currentPrice <= threshold).toBe(true);
-    });
-    it("fires funding spread alert", () => {
-        const spread = 35; // annual %
-        const alertThreshold = 30;
-        expect(spread >= alertThreshold).toBe(true);
-    });
-    it("does NOT fire funding spread below threshold", () => {
-        const spread = 25;
-        const alertThreshold = 30;
-        expect(spread >= alertThreshold).toBe(false);
-    });
-});

package/dist/__tests__/arb-auto-3dex.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/__tests__/arb-auto-3dex.test.js

@@ -1,397 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { computeNetSpread, computeRoundTripCostPct, getNextSettlement, isNearSettlement, isSpreadReversed, } from "../commands/arb-auto.js";
-/**
- * Mirrors the direction logic in arb-auto.ts:
- * Sort all available exchange rates by hourly-normalized rate.
- * Long on the lowest-rate exchange, short on the highest.
- */
-function determine3DexDirection(snap) {
-    return {
-        longExchange: snap.longExch,
-        shortExchange: snap.shortExch,
-    };
-}
-/**
- * Mirrors the funding accumulation logic in arb-auto:
- * Estimate funding collected based on rate differential and elapsed time.
- */
-function accumulateFunding(pos, current, nowMs) {
-    const elapsedHours = (nowMs - pos.lastCheckTime) / (1000 * 60 * 60);
-    const notional = parseFloat(pos.size) * current.markPrice;
-    const rateFor = (e) => e === "pacifica" ? current.pacRate : e === "hyperliquid" ? current.hlRate : current.ltRate;
-    const longHourly = rateFor(pos.longExchange) / 1; // all exchanges are hourly
-    const shortHourly = rateFor(pos.shortExchange) / 1; // all exchanges are hourly
-    const hourlyIncome = (shortHourly - longHourly) * notional;
-    return hourlyIncome * elapsedHours;
-}
-// ──────────────────────────────────────────────
-// 3-DEX direction
-// ──────────────────────────────────────────────
-describe("3-DEX direction determination", () => {
-    it("uses longExch/shortExch from snapshot (all 3 available)", () => {
-        const snap = {
-            symbol: "BTC",
-            pacRate: 0.0006, // pac = 0.0006/hr
-            hlRate: 0.0003, // hl = 0.0003/hr
-            ltRate: 0.0002, // lt = 0.0002/hr (lowest!)
-            spread: 240.9,
-            longExch: "lighter",
-            shortExch: "pacifica",
-            markPrice: 60000,
-            pacMarkPrice: 0, hlMarkPrice: 0, ltMarkPrice: 0,
-        };
-        const { longExchange, shortExchange } = determine3DexDirection(snap);
-        expect(longExchange).toBe("lighter");
-        expect(shortExchange).toBe("pacifica");
-    });
-    it("handles pac vs hl only (lighter missing)", () => {
-        const snap = {
-            symbol: "ETH",
-            pacRate: 0.002, // pac = 0.002/hr (highest)
-            hlRate: 0.00005, // hl = 0.00005/hr (lowest)
-            ltRate: 0, // no lighter
-            spread: 175.2,
-            longExch: "hyperliquid",
-            shortExch: "pacifica",
-            markPrice: 3000,
-            pacMarkPrice: 0, hlMarkPrice: 0, ltMarkPrice: 0,
-        };
-        const { longExchange, shortExchange } = determine3DexDirection(snap);
-        expect(longExchange).toBe("hyperliquid");
-        expect(shortExchange).toBe("pacifica");
-    });
-    it("handles lighter vs pac when HL missing", () => {
-        const snap = {
-            symbol: "SOL",
-            pacRate: 0.0001,
-            hlRate: 0,
-            ltRate: 0.001,
-            spread: 98.55,
-            longExch: "pacifica",
-            shortExch: "lighter",
-            markPrice: 150,
-            pacMarkPrice: 0, hlMarkPrice: 0, ltMarkPrice: 0,
-        };
-        const { longExchange, shortExchange } = determine3DexDirection(snap);
-        expect(longExchange).toBe("pacifica");
-        expect(shortExchange).toBe("lighter");
-    });
-});
-// ──────────────────────────────────────────────
-// Funding accumulation
-// ──────────────────────────────────────────────
-describe("Funding accumulation tracking", () => {
-    const baseTime = Date.now();
-    it("accumulates positive income when spread is favorable", () => {
-        const pos = {
-            symbol: "BTC",
-            longExchange: "hyperliquid", // low funding
-            shortExchange: "pacifica", // high funding
-            size: "0.1",
-            entrySpread: 50,
-            entryTime: new Date().toISOString(),
-            entryMarkPrice: 60000,
-            accumulatedFundingUsd: 0,
-            lastCheckTime: baseTime,
-        };
-        const snap = {
-            symbol: "BTC",
-            pacRate: 0.000125, // pac = 0.000125/hr (all hourly now)
-            hlRate: 0.00005, // hl = 0.00005/hr
-            ltRate: 0,
-            spread: 65.7,
-            longExch: "hyperliquid",
-            shortExch: "pacifica",
-            markPrice: 60000,
-            pacMarkPrice: 0, hlMarkPrice: 0, ltMarkPrice: 0,
-        };
-        // 1 hour elapsed
-        const income = accumulateFunding(pos, snap, baseTime + 3600_000);
-        // shortHourly = 0.000125
-        // longHourly = 0.00005
-        // diff = 0.000125 - 0.00005 = 0.000075
-        // notional = 0.1 * 60000 = 6000
-        // income = 0.000075 * 6000 * 1 = $0.45/hr
-        expect(income).toBeCloseTo(0.45, 2);
-    });
-    it("returns zero income when no time elapsed", () => {
-        const pos = {
-            symbol: "ETH",
-            longExchange: "lighter",
-            shortExchange: "pacifica",
-            size: "1",
-            entrySpread: 30,
-            entryTime: new Date().toISOString(),
-            entryMarkPrice: 3000,
-            accumulatedFundingUsd: 0,
-            lastCheckTime: baseTime,
-        };
-        const snap = {
-            symbol: "ETH",
-            pacRate: 0.0005, // all hourly now
-            hlRate: 0.0001,
-            ltRate: 0.0001,
-            spread: 43.8,
-            longExch: "lighter",
-            shortExch: "pacifica",
-            markPrice: 3000,
-            pacMarkPrice: 0, hlMarkPrice: 0, ltMarkPrice: 0,
-        };
-        const income = accumulateFunding(pos, snap, baseTime); // same time
-        expect(income).toBe(0);
-    });
-    it("scales with elapsed time", () => {
-        const pos = {
-            symbol: "BTC",
-            longExchange: "hyperliquid",
-            shortExchange: "pacifica",
-            size: "0.1",
-            entrySpread: 50,
-            entryTime: new Date().toISOString(),
-            entryMarkPrice: 60000,
-            accumulatedFundingUsd: 0,
-            lastCheckTime: baseTime,
-        };
-        const snap = {
-            symbol: "BTC",
-            pacRate: 0.000125,
-            hlRate: 0.00005,
-            ltRate: 0,
-            spread: 65.7,
-            longExch: "hyperliquid",
-            shortExch: "pacifica",
-            markPrice: 60000,
-            pacMarkPrice: 0, hlMarkPrice: 0, ltMarkPrice: 0,
-        };
-        const income1h = accumulateFunding(pos, snap, baseTime + 3600_000);
-        const income24h = accumulateFunding(pos, snap, baseTime + 24 * 3600_000);
-        expect(income24h).toBeCloseTo(income1h * 24, 2);
-    });
-    it("can produce negative income if spread reverses", () => {
-        const pos = {
-            symbol: "BTC",
-            longExchange: "pacifica", // originally was low
-            shortExchange: "hyperliquid", // originally was high
-            size: "0.1",
-            entrySpread: 20,
-            entryTime: new Date().toISOString(),
-            entryMarkPrice: 60000,
-            accumulatedFundingUsd: 0,
-            lastCheckTime: baseTime,
-        };
-        // Now PAC rate is HIGHER than HL — bad for our direction
-        const snap = {
-            symbol: "BTC",
-            pacRate: 0.00025, // pac now high: 0.00025/hr
-            hlRate: 0.00001, // hl now low: 0.00001/hr
-            ltRate: 0,
-            spread: 218.3,
-            longExch: "hyperliquid",
-            shortExch: "pacifica",
-            markPrice: 60000,
-            pacMarkPrice: 0, hlMarkPrice: 0, ltMarkPrice: 0,
-        };
-        const income = accumulateFunding(pos, snap, baseTime + 3600_000);
-        // shortHourly (HL) = 0.00001
-        // longHourly (PAC) = 0.00025
-        // diff = 0.00001 - 0.00025 = -0.00024
-        // notional = 6000
-        // income = -0.00024 * 6000 * 1 = -$1.44
-        expect(income).toBeLessThan(0);
-    });
-});
-// ──────────────────────────────────────────────
-// Entry/exit conditions with 3 DEXs
-// ──────────────────────────────────────────────
-describe("3-DEX entry/exit conditions", () => {
-    const minSpread = 30;
-    const closeSpread = 5;
-    it("enters when any 2-exchange spread exceeds threshold", () => {
-        // Only PAC and LT available, but spread is large
-        const absSpread = 45;
-        expect(absSpread >= minSpread).toBe(true);
-    });
-    it("closes when best available spread drops below close threshold", () => {
-        const currentSpread = 3;
-        expect(currentSpread <= closeSpread).toBe(true);
-    });
-    it("does not enter if max positions reached", () => {
-        const maxPositions = 3;
-        const openPositions = 3;
-        expect(openPositions >= maxPositions).toBe(true);
-    });
-    it("skips symbol already in open positions", () => {
-        const openPositions = [{
-                symbol: "BTC",
-                longExchange: "hyperliquid",
-                shortExchange: "pacifica",
-                size: "0.1",
-                entrySpread: 40,
-                entryTime: new Date().toISOString(),
-                entryMarkPrice: 60000,
-                accumulatedFundingUsd: 0.5,
-                lastCheckTime: Date.now(),
-            }];
-        const alreadyOpen = openPositions.some(p => p.symbol === "BTC");
-        expect(alreadyOpen).toBe(true);
-    });
-});
-// ──────────────────────────────────────────────
-// Net spread calculation
-// ──────────────────────────────────────────────
-describe("computeNetSpread", () => {
-    it("correctly deducts annualized round-trip cost from gross spread", () => {
-        // gross=30%, hold=7d, roundTrip=0.14% → net = 30 - (0.14/7*365) = 30 - 7.3 = 22.7
-        const net = computeNetSpread(30, 7, 0.14);
-        expect(net).toBeCloseTo(22.7, 1);
-    });
-    it("returns gross spread when costs are zero", () => {
-        const net = computeNetSpread(50, 7, 0);
-        expect(net).toBe(50);
-    });
-    it("can produce negative net spread when costs exceed gross", () => {
-        // gross=5%, hold=1d, roundTrip=0.14% → net = 5 - (0.14*365) = 5 - 51.1 = -46.1
-        const net = computeNetSpread(5, 1, 0.14);
-        expect(net).toBeLessThan(0);
-    });
-    it("longer hold periods reduce annualized cost impact", () => {
-        const net7d = computeNetSpread(30, 7, 0.14);
-        const net30d = computeNetSpread(30, 30, 0.14);
-        expect(net30d).toBeGreaterThan(net7d);
-    });
-    it("includes bridge cost in net spread calculation", () => {
-        // Without bridge cost
-        const netNoBridge = computeNetSpread(30, 7, 0.14, 0, 100);
-        // With $0.50 bridge cost, $100 position
-        // bridgeRoundTripPct = (0.5 * 2 / 100) * 100 = 1%
-        // bridgeAnnualized = (1/7) * 365 = 52.14%
-        const netWithBridge = computeNetSpread(30, 7, 0.14, 0.5, 100);
-        expect(netWithBridge).toBeLessThan(netNoBridge);
-        // Difference should be the annualized bridge cost
-        const bridgeDiff = netNoBridge - netWithBridge;
-        expect(bridgeDiff).toBeCloseTo(52.14, 0);
-    });
-    it("bridge cost impact scales inversely with position size", () => {
-        const netSmall = computeNetSpread(30, 7, 0.14, 0.5, 50); // $50 position
-        const netLarge = computeNetSpread(30, 7, 0.14, 0.5, 500); // $500 position
-        // Larger positions dilute bridge cost
-        expect(netLarge).toBeGreaterThan(netSmall);
-    });
-});
-describe("computeRoundTripCostPct", () => {
-    it("computes round-trip cost for same-fee exchanges", () => {
-        // 2 × (0.035% + 0.035%) + 2 × 0.05% = 0.24%
-        const cost = computeRoundTripCostPct("hyperliquid", "pacifica", 0.05);
-        expect(cost).toBeCloseTo(0.24, 4);
-    });
-    it("uses default slippage of 0.05%", () => {
-        const cost = computeRoundTripCostPct("hyperliquid", "lighter");
-        // 2 × (0.035% + 0.035%) + 2 × 0.05% = 0.24%
-        expect(cost).toBeCloseTo(0.24, 4);
-    });
-    it("handles custom slippage", () => {
-        const cost = computeRoundTripCostPct("hyperliquid", "pacifica", 0.1);
-        // 2 × (0.035% + 0.035%) + 2 × 0.1% = 0.34%
-        expect(cost).toBeCloseTo(0.34, 4);
-    });
-});
-// ──────────────────────────────────────────────
-// Spread reversal detection
-// ──────────────────────────────────────────────
-describe("Spread reversal detection", () => {
-    it("detects reversal when long exchange rate exceeds short", () => {
-        const snap = {
-            symbol: "BTC",
-            pacRate: 0.0001, // PAC low (was short, now low)
-            hlRate: 0.0005, // HL high (was long, now high)
-            ltRate: 0,
-            spread: 30,
-            longExch: "pacifica",
-            shortExch: "hyperliquid",
-            markPrice: 60000,
-            pacMarkPrice: 0, hlMarkPrice: 0, ltMarkPrice: 0,
-        };
-        // Position: long HL, short PAC — but now HL hourly (0.0005) > PAC hourly (0.0001)
-        const reversed = isSpreadReversed("hyperliquid", "pacifica", snap);
-        expect(reversed).toBe(true);
-    });
-    it("does not flag reversal when spread is still favorable", () => {
-        const snap = {
-            symbol: "BTC",
-            pacRate: 0.001, // PAC high (0.001/hr)
-            hlRate: 0.00005, // HL low (0.00005/hr)
-            ltRate: 0,
-            spread: 65.7,
-            longExch: "hyperliquid",
-            shortExch: "pacifica",
-            markPrice: 60000,
-            pacMarkPrice: 0, hlMarkPrice: 0, ltMarkPrice: 0,
-        };
-        // Position: long HL, short PAC — HL hourly (0.00005) < PAC hourly (0.001) → no reversal
-        const reversed = isSpreadReversed("hyperliquid", "pacifica", snap);
-        expect(reversed).toBe(false);
-    });
-    it("handles lighter vs pacifica reversal", () => {
-        const snap = {
-            symbol: "SOL",
-            pacRate: 0.0001, // PAC hourly = 0.0001
-            hlRate: 0,
-            ltRate: 0.0016, // LT 8h rate, hourly = 0.0016/8 = 0.0002
-            spread: 10,
-            longExch: "pacifica",
-            shortExch: "lighter",
-            markPrice: 150,
-            pacMarkPrice: 0, hlMarkPrice: 0, ltMarkPrice: 0,
-        };
-        // Position: long LT, short PAC — LT hourly (0.0002) > PAC hourly (0.0001) → reversed
-        const reversed = isSpreadReversed("lighter", "pacifica", snap);
-        expect(reversed).toBe(true);
-    });
-});
-// ──────────────────────────────────────────────
-// Settlement timing awareness
-// ──────────────────────────────────────────────
-describe("Settlement timing awareness", () => {
-    it("getNextSettlement returns next hour for HL", () => {
-        // At 14:30 UTC, next HL settlement is at 15:00 UTC
-        const now = new Date("2025-01-15T14:30:00Z");
-        const next = getNextSettlement("hyperliquid", now);
-        expect(next.getUTCHours()).toBe(15);
-        expect(next.getUTCMinutes()).toBe(0);
-    });
-    it("getNextSettlement returns next hour for PAC (hourly like HL)", () => {
-        // At 06:00 UTC, next PAC settlement is at 07:00 UTC
-        const now = new Date("2025-01-15T06:30:00Z");
-        const next = getNextSettlement("pacifica", now);
-        expect(next.getUTCHours()).toBe(7);
-    });
-    it("getNextSettlement wraps to next day for PAC when at 23:xx", () => {
-        // At 23:30 UTC, next PAC settlement is at 00:00 next day
-        const now = new Date("2025-01-15T23:30:00Z");
-        const next = getNextSettlement("pacifica", now);
-        expect(next.getUTCHours()).toBe(0);
-        expect(next.getUTCDate()).toBe(16);
-    });
-    it("isNearSettlement blocks entry within 5 minutes of settlement", () => {
-        // 3 minutes before 08:00 UTC settlement — all exchanges settle hourly now
-        const now = new Date("2025-01-15T07:57:00Z");
-        const result = isNearSettlement("lighter", "pacifica", 5, now);
-        expect(result.blocked).toBe(true);
-        // Both lighter and pacifica settle at 08:00, lighter checked first
-        expect(result.exchange).toBe("lighter");
-        expect(result.minutesUntil).toBeLessThanOrEqual(5);
-    });
-    it("isNearSettlement allows entry far from settlement", () => {
-        // 30 minutes past the hour — next settlement is 30 min away
-        const now = new Date("2025-01-15T15:30:00Z");
-        const result = isNearSettlement("lighter", "pacifica", 5, now);
-        expect(result.blocked).toBe(false);
-    });
-    it("isNearSettlement checks both exchanges", () => {
-        // 2 minutes before hourly HL settlement
-        const now = new Date("2025-01-15T14:58:00Z");
-        const result = isNearSettlement("hyperliquid", "pacifica", 5, now);
-        expect(result.blocked).toBe(true);
-        expect(result.exchange).toBe("hyperliquid");
-    });
-});