dexbot 1.4.20 → 1.4.21

package/docs/LOGGING.md

@@ -309,7 +309,7 @@ Yes — each bot entry in `profiles/bots.json` accepts an optional `logging` fie
 }
 ```
 
-The per-bot `logging` is deep-merged on top of the global config from `general.settings.json`. See `modules/types.ts` (`BotLoggingOverrides`), `modules/runtime_settings.ts`, and `modules/order/manager.ts` for the wiring.
+The per-bot `logging` is deep-merged on top of the global config from `general.settings.json`. See `modules/runtime_settings.ts` for the merge logic and `modules/order/manager.ts` for where the merged config reaches the logger.
 
 **Q: What about PM2?**
 The logger auto-detects PM2 and suppresses file writes (PM2 captures stdout/stderr). File rotation is also suppressed under PM2.

package/docs/MPA_CREDIT_USAGE.md

@@ -233,7 +233,7 @@ When `maxBorrowAmountPerOperation` is set, each credit-maintenance cycle runs `_
 
 - Discovers deals whose `debtAmount` exceeds `maxBorrowAmountPerOperation`.
 - Splits each oversized deal into `ceil(debt / maxPerOp)` equal pieces via atomic repay+reborrow transactions. Total debt across the new deals is preserved; only deal granularity changes.
-- Skips a deal if any piece would fall below the offer's `min_deal_amount` (the offer is cached for the runtime lifetime, so on-chain `min_deal_amount` changes mid-split are not re-read).
+- Skips a deal if any piece would fall below the offer's `min_deal_amount` (offers are cached with a 10-minute TTL — `TIMING.OFFER_CACHE_TTL_MS` — so on-chain `min_deal_amount` changes are picked up on the next re-fetch).
 - Pauses `BLOCKCHAIN_SETTLE_DELAY_MS` between pieces; aborts on shutdown.
 - Stops once `CREDIT_DEAL_SPLIT_MAX_PIECES` pieces have been emitted in the current cycle. Remaining oversized deals are deferred to the next maintenance cycle.
 - Uses an in-process `_splitInFlight` guard so `runMaintenance` and `runCreditWatchdog` cannot start overlapping splits.
@@ -342,12 +342,12 @@ Treat this file as runtime state, not primary configuration. The source of truth
 
 - `modules/credit_runtime.ts`: debt workflow executor (Phase 0 oversized-deal splitter lives here)
 - `modules/cr_planner.ts`: MPA debt-first planner; clamps `debtDelta` by `maxBorrowAmountPerOperation`
-- `modules/types.ts`: `LendingEntryBase` — shared `mpa` / `creditOffer` type including `maxBorrowAmountPerOperation`
+- `modules/cr_planner.ts`: `DebtFirstCrPlanOptions` — planner options carrying `maxBorrowAmountPerOperation`; lending-item shapes are validated inline in `bot_settings.ts`
 - `modules/dexbot_class.ts`: runtime startup and watchdog lifecycle
 - `modules/bot_settings.ts`: `debtPolicy` validation
 - `market_adapter/README.md`: AMA pricing, grid triggers, and dynamic-weight runtime
 - `modules/credential_policy.ts`: signing constraints for credit and call-order operations
-- `tests/test_credit_runtime.ts`: credit runtime behavior coverage (including 6 oversized-deal splitter tests)
+- `tests/test_credit_runtime.ts`: credit runtime behavior coverage (including 3 oversized-deal splitter tests)
 - `tests/test_multi_asset_distribution.ts`: collateral distribution and multi-asset state coverage
 
 </details>

package/docs/README.md

@@ -2,7 +2,7 @@
 
 This directory contains the comprehensive technical documentation for the DEXBot2 trading bot. It is designed to guide developers from high-level architecture down to the nuances of fund accounting and state management.
 
-**Version context:** v1.4.17 (released).
+**Version context:** v1.4.21 (released).
 
 ---
 
@@ -144,7 +144,7 @@ This directory contains the comprehensive technical documentation for the DEXBot
 
 ### 🧭 [Evolution Report](EVOLUTION.md)
 *Project timeline and major architecture phases.*
-- **Coverage**: Historical milestones from the initial December 2025 bootstrap through the v1.4.20 stable release (grid persistence safety, dust pipeline fix, net inventory lots); credit/debt runtime and maintenance hardening are covered under Phase 5 (Mar–Jun 2026)
+- **Coverage**: Historical milestones from the initial December 2025 bootstrap through the v1.4.21 stable release (grid persistence safety, dust pipeline fix, net inventory lots); credit/debt runtime and maintenance hardening are covered under Phase 5 (Mar–Jun 2026)
 - **Focus**: Architecture evolution, release history, test growth, and documentation changes
 
 ### 🗒️ [Changelog](../CHANGELOG.md)

package/docs/WORKFLOW.md

@@ -211,7 +211,7 @@ recommended mode:
 - **Single process** — no PM2, no separate credential daemon management
 - **Auto-update** — detects new releases, builds, and restarts cleanly
 - **Crash restart** — background mode re-spawns on failure
-- **Per-bot log files** — each bot logs to `profiles/logs/<bot>.log`
+- **Per-bot log files** — each bot logs to `<profiles>/logs/<bot>.log` (`~/.config/dexbot2/profiles/logs` by default)
 - **Built-in daemon** — the credential daemon is managed internally
 
 Legacy PM2 mode (`npm run pm2:unlock`) is de-emphasized but still available.
@@ -257,7 +257,7 @@ the canonical name is preferred in scripts and docs.
 | `dexbot restart` | `restartall` | Restart the monolithic runtime (unlock mode) |
 | `dexbot delete` | — | Shut down and clean up the monolithic runtime (unlock mode) |
 | `dexbot whitelist` | `white` | Generate market adapter whitelist from AMA bot configs |
-| `dexbot clear` | — | Remove all log files from `profiles/logs/` |
+| `dexbot clear` | — | Remove all log files from the logs directory (`<profiles>/logs`) |
 
 ## NPM Scripts for Branch Synchronization
 

package/docs/architecture.md

@@ -548,12 +548,11 @@ The simplified approach prioritizes fund availability over aggressive correction
 Spread corrections respect these hard limits:
 
 ```javascript
-// In modules/constants.ts
-SPREAD_LIMITS: {
-    MIN_SPREAD_ORDERS: 2,           // Always maintain minimum gap
-    TARGET_SPREAD_PERCENT: (user-configured),  // Fixed width, no inflation
-    MAX_REPLACEMENT_SLOTS: 5,       // Conservative correction cap
-}
+// In modules/constants.ts (GRID_LIMITS)
+MIN_SPREAD_ORDERS: 2,           // Always maintain minimum gap
+
+// Spread width itself stays user-configured (`targetSpreadPercent`) — fixed, no inflation.
+// Correction count has no separate slot cap; it is bounded by the funds check below.
 
 // Each correction order must be healthy
 const minHealthySize = calculateMinOrderSize(side);
@@ -590,28 +589,31 @@ BLOCKCHAIN_FETCH_INTERVAL_MIN: 240,  // 4 hours = 240 minutes
 
 ### Implementation Flow
 
+**1. Interval startup** — `setupBlockchainFetchInterval()` in
+`modules/dexbot_maintenance_runtime.ts` starts the interval during bot initialization:
+
 ```javascript
-// 1. Timer started during bot initialization
-this.periodicRefreshTimer = setInterval(
-    () => this._performPeriodicRefresh(),
-    BLOCKCHAIN_FETCH_INTERVAL_MIN * 60 * 1000
-);
-
-// 2. When timer fires:
-async _performPeriodicRefresh() {
-    // Fetch latest market price
-    const latestPrice = await derivePrice('book');  // Or 'pool'
-
-    // Update internal anchor if using dynamic pricing
-    if (config.startPrice === 'book' || config.startPrice === 'pool') {
-        this.manager.startPrice = latestPrice;
-    }
-
-    // Grid remains un-affected (fund-driven during normal ops)
-    // Only used for valuation calculations and divergence checks
-}
+bot._blockchainFetchInterval = setInterval(tick, BLOCKCHAIN_FETCH_INTERVAL_MIN * 60 * 1000);
 ```
 
+**2. Tick guards** *(no lock held)*
+- Skip if shutdown has begun or a previous tick is still in flight
+- Sync market adapter watchdog config
+
+**3. Periodic work** *(under the fill-processing lock)*
+- Reset accountant recovery state
+- Refresh dynamic weight distribution
+- `fetchAccountTotals(accountId)` — refreshes balances and the valuation anchor
+- Read open orders via guarded read — truncated/empty reads defer the sync; fills are still caught by subscriptions and the next cycle
+- `synchronizeWithChain(...)` — re-aligns the grid with on-chain reality; detected fills run through the normal batched rebalance pipeline and the grid is persisted, unmatched chain orders log as surplus/divergence
+- `performPeriodicGridChecks(bot)` — maintenance checks (see [Lifecycle](LIFECYCLE.md))
+
+Grid placement remains fund-driven during normal operation; the periodic tick keeps
+balances, valuations, and open-order state fresh rather than directly moving prices.
+A per-instance override (`_blockchainFetchIntervalMin`, e.g. for shared accounts from
+the fund registry) can shorten or lengthen the interval; setting a non-positive value
+disables the loop entirely.
+
 ### When `startPrice` is Numeric
 
 If user set `startPrice: 105.5` in bots.json:
@@ -780,10 +782,10 @@ stateDiagram-v2
 
 A **phantom order** is an illegal state where an order exists as ACTIVE/PARTIAL without a corresponding blockchain `orderId`. This corrupts fund tracking and causes "doubled funds" warnings.
 
-**Why Phantoms Occur**:
-1. **Grid Resize Bug**: `Grid._updateOrdersForSide()` could force VIRTUAL → ACTIVE without blockchain confirmation
-2. **Sync Gap**: Orders without orderId could remain ACTIVE indefinitely if sync logic skipped them
-3. **No Validation**: No centralized check prevented invalid state assignments
+**Risks the Three-Layer Defense Guards Against**:
+1. **Resize State Forcing**: Grid resize forcing VIRTUAL → ACTIVE without blockchain confirmation
+2. **Sync Gaps**: Orders without `orderId` remaining ACTIVE if sync logic skips them
+3. **Unvalidated Assignment**: Invalid state assignments without a centralized check
 
 **Prevention System** (Three-Layer Defense):
 
@@ -983,7 +985,7 @@ graph TB
     SKIP --> DONE
 ```
 
-**Key Improvement (v1.0.0)**: Force reload mechanism now ensures fresh persisted grid data before comparison, preventing stale cache from causing false divergence detections.
+The force reload mechanism loads fresh persisted grid data before comparison, preventing stale cache from causing false divergence detections.
 
 ---
 
@@ -1150,9 +1152,12 @@ The system continuously monitors three mathematical invariants:
 
 ### Index Consistency
 
-- **Validation**: `validateIndices()` checks Map ↔ Set consistency
-- **Repair**: `_repairIndices()` rebuilds indices if corruption detected
-- **Defensive**: Called after critical operations
+- **Grid versioning**: `_gridVersion` is bumped on every grid mutation; the
+  `_ordersByType` / `_ordersByState` index caches invalidate automatically when the
+  version changes (no manual rebuild step)
+- **Structural checks**: tests use `assertOrdersStructurallySound()`
+  (`tests/helpers/order_test_helpers.ts`) to verify every order in the Map is non-null
+  with valid `state` and `type`
 
 ---
 
@@ -1278,7 +1283,7 @@ tsx tests/test_dexbot_credit_wiring.ts
 
 3. **Verify invariants**
    ```javascript
-   expect(manager.validateIndices()).toBe(true);
+   assertOrdersStructurallySound(manager);  // Order Map structurally valid
    expect(chainTotal === chainFree + chainCommitted).toBe(true);
    ```
 
@@ -1382,7 +1387,7 @@ The strategy engine has been significantly strengthened with improvements to fun
 - Before executing batch order placements, available funds are validated
 - Prevents insufficient fund errors during large rotation cycles
 - Uses atomic check-and-deduct pattern for safety
-- Located in: `modules/order/strategy.ts` - `rebalanceSideRobust()`
+- Located in: `modules/dexbot_cow_runtime.ts` - `validateOperationFunds()`
 
 **2. Dust Partial Handling**
 - Improved dust detection algorithm prevents false positives
@@ -1408,9 +1413,9 @@ The strategy engine has been significantly strengthened with improvements to fun
 - Located in: `modules/order/manager.ts` - `processFilledOrders()`
 
 **6. Precision Spread Management (Logarithmic Logic)**
-- **Discrete Step Tracking**: Replaced the legacy linear multiplier (`SPREAD_WIDENING_MULTIPLIER`) with a discrete 1-slot logarithmic buffer. This ensures correction triggers exactly when the market moves by one full increment.
-- **Center-Gap Awareness**: Refined the grid initialization math to account for the "Center Gap" naturally created during symmetric centering. This reduces the initial spread by ~0.5% (one full increment) compared to the previous version.
-- **Collision-Free Safety**: Increased `MIN_SPREAD_FACTOR` to 2.1 to ensure that the security minimum (2 spread orders) never conflicts with the spread correction threshold, even at micro-spread configurations.
+- **Discrete Step Tracking**: A discrete 1-slot logarithmic buffer ensures correction triggers exactly when the market moves by one full increment.
+- **Center-Gap Awareness**: Grid initialization math accounts for the "Center Gap" naturally created during symmetric centering, reducing the initial spread by ~0.5% (one full increment).
+- **Collision-Free Safety**: `MIN_SPREAD_FACTOR` of 2.1 ensures that the security minimum (2 spread orders) never conflicts with the spread correction threshold, even at micro-spread configurations.
 
 ### Related Documentation
 

package/docs/developer_guide.md

@@ -79,7 +79,7 @@ A **phantom order** is an order in ACTIVE/PARTIAL state WITHOUT a valid `orderId
 
 | Term | Meaning |
 |------|---------|
-| **Fixed-Cap Batch Fill Processing** | Groups fills with a hard cap using `MAX_FILL_BATCH_SIZE` (default 4): `<= cap` uses one unified batch; `> cap` chunks at cap size. In the documented 29-fill Feb 7 crash scenario, this reduces the estimated divergence window from ~90s to ~24s; see [`FUND_MOVEMENT_AND_ACCOUNTING.md`](FUND_MOVEMENT_AND_ACCOUNTING.md#14-fill-batch-processing--cache-fund-timeline). |
+| **Fixed-Cap Batch Fill Processing** | Groups fills with a hard cap using `MAX_FILL_BATCH_SIZE` (default 4): `<= cap` uses one unified batch; `> cap` chunks at cap size. In the documented 29-fill Feb 7 crash scenario, this reduces the estimated divergence window from ~90s to ~24s; see [`FUND_MOVEMENT_AND_ACCOUNTING.md`](FUND_MOVEMENT_AND_ACCOUNTING.md#15-fill-batch-processing--timeline). |
 | **Recovery Retry System** | Count+time-based retry mechanism with periodic reset. Replaces one-shot `_recoveryAttempted` flag. Max 5 attempts per episode with 60s minimum interval between retries. |
 | **Orphan-Fill Deduplication** | Map+TTL-based tracking of stale-cleaned order IDs to prevent double-crediting. Delayed orphan fill events are still blocked by checking `_staleCleanedOrderIds`. |
 
@@ -226,9 +226,7 @@ If you see prices like `0.000795` when expecting `1350`:
 
 ## Precision & Quantization Best Practices
 
-**Problem**: Floating-point arithmetic accumulates rounding errors over many calculations. After repeated price derivations, fund allocations, and order sizing, float values drift from their true blockchain precision.
-
-**Solution**: Use centralized quantization utilities from `modules/order/utils/math.ts` to eliminate accumulation.
+Floating-point arithmetic accumulates rounding errors across repeated price derivations, fund allocations, and order sizing. Always use the centralized quantization utilities in `modules/order/utils/math.ts` to eliminate accumulation.
 
 ### When to Quantize
 
@@ -304,7 +302,7 @@ _updateOrder(order, context, { skipAccounting, fee })
 // COW rebalance pipeline
 performSafeRebalance(fills, excludeIds)       // Entry point; delegates to COW
 _applySafeRebalanceCOW(fills, excludeIds)     // Creates WorkingGrid, runs planning
-_reconcileGridCOW(targetGrid, boundary, wg)   // Computes delta against working copy
+_workingGrid.buildDelta(masterGrid)          // Computes actions vs master (utils/order.ts buildDelta)
 _commitWorkingGrid(workingGrid, indexes, boundary, { skipRecalc }) // Atomic swap: working → master
 
 // COW state tracking
@@ -630,8 +628,9 @@ if (isOrderHealthy(order, minHealthySize)) {
 #### `getPrecisionSlack(precision, factor)`
 ```javascript
 // Calculate float comparison tolerance for given precision
-// Returns: 10^(-precision) * factor (typically factor = 0.001 = 0.1%)
-const slack = getPrecisionSlack(5, 0.001);  // Returns 0.00001 * 0.001 = 0.00000001
+// Location: modules/order/utils/math.ts
+// Returns: factor * quantumForPrecision(precision) (factor defaults to 2)
+const slack = getPrecisionSlack(5);  // Returns 2 * 10^-5 = 0.00002
 
 // Use case: Floating-point safe comparisons
 if (Math.abs(order.size - expected) <= slack) {
@@ -907,7 +906,7 @@ convention marker — AsyncLock does not enforce it at runtime.
 - Divergence checks (Level 1) nest inside fill processing
 - Sync operations (Level 2) are acquired before grid mutations — the timeout-protected lock is inner, so a stuck sync releases the outer lock
 - Grid mutations (Level 3) and fund operations (Level 4) are innermost
-- All paths follow the same order — the historical `gridLockAlreadyHeld` workaround flag has been eliminated
+- All paths follow the same order
 
 **`adjustTotalBalance` Locking Contract** (v1.4.7):
 
@@ -1240,11 +1239,9 @@ manager.accountant._verifyFundInvariants(
 
 **2. Index Consistency Check**
 ```javascript
-// Periodically
-const isValid = manager.validateIndices();
-if (!isValid) {
-    manager._repairIndices();
-}
+// Index caches invalidate automatically via _gridVersion bumps — no manual
+// validation/repair API exists. For structural checks (e.g. in tests):
+assertOrdersStructurallySound(manager);  // tests/helpers/order_test_helpers.ts
 ```
 
 **3. Grid Diagnostics**
@@ -1499,9 +1496,10 @@ manager.logger.logFundsStatus(manager, 'CONTEXT');
 console.log(manager.getMetrics());
 ```
 
-### Validate Indices
+### Check Order Map Integrity
 ```javascript
-const isValid = manager.validateIndices();
+// Structural check (tests); index caches self-invalidate via _gridVersion
+assertOrdersStructurallySound(manager);
 ```
 
 ### Check Specific Order
@@ -1705,7 +1703,7 @@ console.log(' - Testing [action] updates [fund pool]...');
     // Assert
     const finalFunds = manager.funds[poolName][side];
     assert.strictEqual(finalFunds, expectedValue);
-    assert.strictEqual(manager.validateIndices(), true);  // Indices OK?
+    assertOrdersStructurallySound(manager);  // Order Map structurally sound?
 }
 ```
 
@@ -1774,7 +1772,7 @@ try {
     // Perform operation
     await fundDependentOperation();
     // Check state consistency
-    assert.strictEqual(manager.validateIndices(), true);
+    assertOrdersStructurallySound(manager);
 } finally {
     manager.unlockOrders(['order-1']);
 }
@@ -1833,7 +1831,7 @@ manager.orders.forEach(order => {
 });
 
 // 4. Check index consistency
-console.log('Indices valid?', manager.validateIndices());
+assertOrdersStructurallySound(manager);  // throws if any order entry is corrupt
 
 // 5. Examine specific fund pool
 console.log('Virtual buy:', manager.funds.virtual.buy);

package/market_adapter/README.md

@@ -573,7 +573,6 @@ market_adapter/
 |-- ama_signal_runner.ts           one-cycle JSON signal CLI
 |-- candle_utils.ts                candle transforms, gap detection, pruning
 |-- interval_utils.ts              shared interval label helpers
-|-- merge_lp_data.ts               candle export merge utility
 |-- lp_chart_core.ts               chart HTML renderer
 |-- lp_chart_strategy_loader.ts    AMA strategy/profile resolver for charts
 |-- lp_chart_runner.ts             LP chart orchestration
@@ -612,7 +611,6 @@ market_adapter/
 |   |-- data_discovery.ts          data directory auto-discovery
 |   |-- atomic_write.ts            atomic file write utility
 |   |-- dynamic_grid_snapshot.ts   dynamic grid snapshot helpers
-|   `-- paths.ts                   path resolution helpers
 |-- data/                          runtime candle caches and exports
 `-- state/                         runtime state, centers, and lock file
 ```

package/modules/README.md

@@ -127,7 +127,8 @@ modules/
 └── utils/
     ├── base58check.ts             Base58Check encoding
     ├── build_dir.ts               BUILD_DIR constant helper
-    └── errors.ts                  getErrorMessage helper
+    ├── errors.ts                  getErrorMessage helper
+    └── sanitize_key.ts            shared sanitizeKey helper
 ```
 
 ## Key Relationships

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dexbot",
-  "version": "1.4.20",
+  "version": "1.4.21",
   "description": "The first open source trading bot with zero runtime dependencies and a fully adaptive market making strategy.",
   "main": "dist/modules/dexbot_class.js",
   "exports": {

package/scripts/README.md

@@ -413,7 +413,7 @@ alias dbd='node dist/scripts/divergence-calc.js'
 **Monitor live updates while running a script:**
 ```bash
 # Tail the update log in a separate pane
-tail -f profiles/logs/update.log
+tail -f <profiles>/logs/dexbot-update.log
 ```
 
 **Run a specific bot dry-run from the CLI:**

package/claw/openclaw.plugin.json

@@ -1,13 +0,0 @@
-{
-  "id": "bitshares-claw",
-  "name": "BitShares Claw",
-  "description": "Native BitShares and DEXBot2 tools from the DEXBot2 claw integration",
-  "skills": [
-    "./runtimes/openclaw-plugin/skills"
-  ],
-  "configSchema": {
-    "type": "object",
-    "additionalProperties": false,
-    "properties": {}
-  }
-}

package/dist/market_adapter/merge_lp_data.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=merge_lp_data.d.ts.map

package/dist/market_adapter/merge_lp_data.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"merge_lp_data.d.ts","sourceRoot":"","sources":["../../market_adapter/merge_lp_data.ts"],"names":[],"mappings":""}

package/dist/market_adapter/merge_lp_data.js

@@ -1,125 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-/**
- * MERGE LP DATA FILES
- *
- * Merges two JSON files produced by fetch_lp_data.ts into one,
- * deduplicating candles by timestamp and sorting chronologically.
- *
- * Both files must have the same pool ID, interval, and asset pair.
- *
- * Usage:
- *   tsx market_adapter/merge_lp_data.ts <file1> <file2> --out <output>
- *
- * Example (2-year 1h dataset):
- *   tsx market_adapter/inputs/fetch_lp_data.ts --pool <poolId> --precA <precA> --precB <precB> --interval 1h --start 2024-03-06 --end 2025-03-06 --out market_adapter/data/lp/<pair>/lp_pool_<poolId>_1h_part1.json
- *   tsx market_adapter/inputs/fetch_lp_data.ts --pool <poolId> --precA <precA> --precB <precB> --interval 1h --start 2025-03-06 --end 2026-03-06 --out market_adapter/data/lp/<pair>/lp_pool_<poolId>_1h_part2.json
- *   tsx market_adapter/merge_lp_data.ts \
- *     market_adapter/data/lp/<pair>/lp_pool_<poolId>_1h_part1.json \
- *     market_adapter/data/lp/<pair>/lp_pool_<poolId>_1h_part2.json \
- *     --out market_adapter/data/lp/<pair>/lp_pool_<poolId>_1h.json
- */
-import { path } from '../modules/path_api.js';
-import { getStorage } from '../modules/storage/index.js';
-import { mergeCandles } from './candle_utils.js';
-import { getErrorMessage } from '../modules/utils/errors.js';
-const storage = getStorage();
-const { ensureDir, readJSON, writeJSON } = storage;
-// ─── CLI ──────────────────────────────────────────────────────────────────────
-function parseArgs() {
-    const args = process.argv.slice(2);
-    const files = [];
-    let out = null;
-    for (let i = 0; i < args.length; i++) {
-        if (args[i] === '--out' && args[i + 1]) {
-            out = args[++i];
-        }
-        else if (!args[i].startsWith('--')) {
-            files.push(args[i]);
-        }
-    }
-    if (files.length !== 2) {
-        console.error('Usage: merge_lp_data.ts <file1> <file2> --out <output>');
-        process.exit(1);
-    }
-    return { files, out };
-}
-// ─── Validation ───────────────────────────────────────────────────────────────
-function validate(a, b) {
-    if (a.meta.pool !== b.meta.pool) {
-        throw new Error(`Pool mismatch: ${a.meta.pool} vs ${b.meta.pool}`);
-    }
-    if (a.meta.intervalSeconds !== b.meta.intervalSeconds) {
-        throw new Error(`Interval mismatch: ${a.meta.intervalSeconds}s vs ${b.meta.intervalSeconds}s`);
-    }
-    if (a.meta.assetA.id !== b.meta.assetA.id || a.meta.assetB.id !== b.meta.assetB.id) {
-        throw new Error(`Asset pair mismatch:\n` +
-            `  file1: ${a.meta.assetA.id} / ${a.meta.assetB.id}\n` +
-            `  file2: ${b.meta.assetA.id} / ${b.meta.assetB.id}`);
-    }
-    if (a.meta.assetA.precision !== b.meta.assetA.precision || a.meta.assetB.precision !== b.meta.assetB.precision) {
-        throw new Error(`Precision mismatch:\n` +
-            `  file1: precA=${a.meta.assetA.precision} precB=${a.meta.assetB.precision}\n` +
-            `  file2: precA=${b.meta.assetA.precision} precB=${b.meta.assetB.precision}`);
-    }
-}
-// ─── Merge ────────────────────────────────────────────────────────────────────
-// ─── Main ─────────────────────────────────────────────────────────────────────
-function run() {
-    const { files, out } = parseArgs();
-    console.log('');
-    console.log('══════════════════════════════════════════════');
-    console.log(' LP Data Merger');
-    console.log('══════════════════════════════════════════════');
-    const [dataA, dataB] = files.map((f, i) => {
-        const resolved = path.resolve(f);
-        if (!storage.exists(resolved))
-            throw new Error(`File not found: ${resolved}`);
-        const parsed = readJSON(resolved);
-        console.log(`  file${i + 1}: ${path.relative(process.cwd(), resolved)}  (${parsed.candles.length} candles)`);
-        return parsed;
-    });
-    validate(dataA, dataB);
-    const merged = mergeCandles(dataA.candles, dataB.candles, {
-        onCollision: (existing, incoming) => incoming[5] > existing[5] ? incoming : existing,
-    });
-    const firstTs = new Date(merged[0][0]).toISOString();
-    const lastTs = new Date(merged[merged.length - 1][0]).toISOString();
-    console.log('');
-    console.log(`  file1 range: ${new Date(dataA.candles[0][0]).toISOString()} → ${new Date(dataA.candles[dataA.candles.length - 1][0]).toISOString()}`);
-    console.log(`  file2 range: ${new Date(dataB.candles[0][0]).toISOString()} → ${new Date(dataB.candles[dataB.candles.length - 1][0]).toISOString()}`);
-    console.log(`  merged:      ${firstTs} → ${lastTs}  (${merged.length} candles)`);
-    // Overlap check
-    const bTimestamps = new Set(dataB.candles.map((c) => c[0]));
-    const overlapCount = dataA.candles.filter((c) => bTimestamps.has(c[0])).length;
-    if (overlapCount > 0) {
-        console.log(`  overlap:     ${overlapCount} candles (deduplicated, higher-volume kept)`);
-    }
-    const output = {
-        meta: {
-            ...dataA.meta,
-            fetchedAt: new Date().toISOString(),
-            mergedFrom: files.map(f => path.relative(process.cwd(), path.resolve(f))),
-            candleCount: merged.length,
-            lookbackHours: Math.round((merged[merged.length - 1][0] - merged[0][0]) / 3600000),
-        },
-        candles: merged,
-    };
-    const outPath = out
-        ? path.resolve(out)
-        : path.join(path.dirname(path.resolve(files[1])), path.basename(files[1]));
-    ensureDir(path.dirname(outPath));
-    writeJSON(outPath, output);
-    const kb = (storage.stat(outPath).size / 1024).toFixed(1);
-    console.log('');
-    console.log(`  Saved: ${path.relative(process.cwd(), outPath)}  (${kb} KB)`);
-    console.log('');
-}
-try {
-    run();
-}
-catch (e) {
-    console.error('\n[error]', getErrorMessage(e));
-    process.exit(1);
-}
-//# sourceMappingURL=merge_lp_data.js.map

package/dist/market_adapter/merge_lp_data.js.map

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

package/dist/market_adapter/utils/paths.d.ts

@@ -1,3 +0,0 @@
-declare const PROJECT_ROOT: string;
-export { PROJECT_ROOT };
-//# sourceMappingURL=paths.d.ts.map

package/dist/market_adapter/utils/paths.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../market_adapter/utils/paths.ts"],"names":[],"mappings":"AAIA,QAAA,MAAM,YAAY,QAAqB,CAAC;AAExC,OAAO,EAAE,YAAY,EAAE,CAAA"}

package/dist/market_adapter/utils/paths.js

@@ -1,5 +0,0 @@
-import { PATHS } from '../../modules/paths.js';
-'use strict';
-const PROJECT_ROOT = PATHS.PROJECT_ROOT;
-export { PROJECT_ROOT };
-//# sourceMappingURL=paths.js.map

package/dist/market_adapter/utils/paths.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../market_adapter/utils/paths.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,YAAY,CAAC;AAEb,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;AAExC,OAAO,EAAE,YAAY,EAAE,CAAA"}