dexbot 1.4.23 → 1.4.25

package/CHANGELOG.md

@@ -2,6 +2,53 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.4.25] - 2026-09-02 - Genesis-Frozen Price-Slot Determinism, Self-Trade & Fill-Guard Hardening, Grid Orphan & Recovery Hardening
+
+### 2026-08-29
+
+- **Fix(grid)**: restore strict ERROR diagnostics by fixing hidden fund-invariant and precision failures — re-enables strict diagnostics that were masked by NaN fund-invariant comparisons and float precision drift; fixes fund-invariant tolerance fallback, amount precision helpers, and related silent-failure paths so ERROR logs fire correctly (`modules/order/accounting.ts`, `modules/order/utils/math.ts`, `modules/constants.ts`, etc.).
+- **Fix(gap-band)**: enforce gap-band invariant across COW plan, sync, reconcile and recovery (P1–P5) — introduces authoritative gap-band checks that reject placements violating the reserved gap, validates gap-band geometry in COW planning, sync adoption, startup reconcile and recovery persistence so boundaries cannot drift into the forbidden band (`modules/order/grid.ts`, `modules/order/utils/math.ts`, `modules/dexbot_cow_runtime.ts`, `modules/order/sync_engine.ts`, `modules/order/grid_reconcile*.ts`, `modules/dexbot_state_recovery.ts`).
+- **Fix(grid)**: prevent same-slot re-placement and truncation-drop orphans after COW commit — guards against re-creating an order on a slot that was just committed and against truncation-ambiguous reads dropping live orphans; keeps slot provenance across COW commit so placed orders are not re-issued or lost on a truncated read (`modules/dexbot_cow_runtime.ts`, `modules/order/sync_engine.ts`, `modules/order/grid_reconcile_internal.ts`).
+- **Fix(grid)**: make chain evidence authoritative and remove destructive gap-band cancellation — cancels that swept the gap band based on stale local state are removed; chain-observed orders are the sole authority for gap/rail membership and gap-band sweeps are no longer triggered from local-only evidence (`modules/order/grid_reconcile*.ts`, `modules/order/sync_engine.ts`).
+- **Fix(grid)**: heal and prevent sized-orphan phantom orders in spread and COW commit — spread-correction and COW commit paths that left VIRTUAL slots with `size>0` and no `orderId` (sized orphans causing 2.02% vs 3.04% spread divergence) are healed on reload (virtual-size zeroing with `createUncertain` preservation) and prevented at commit (or­phan exclusion from sizing denominator, durable markers) (`modules/order/grid.ts`, `modules/order/manager.ts`, `modules/account_orders.ts`, `modules/dexbot_cow_runtime.ts`).
+
+### 2026-08-30
+
+- **Fix(recovery)**: stop recovery re-anchoring and make orphan adoption durable — structural resync no longer re-anchors to the latest AMA center (state repair only); orphan adoption widened with `ORPHAN_ADOPTION_TOLERANCE_MULTIPLIER` (×4) on empty slots, reconcile prefers in-place price updates over pre-emptive cancels, and boundary/slot persistence is hardened (`modules/dexbot_maintenance_runtime.ts`, `modules/order/sync_engine.ts`, `modules/order/grid_reconcile.ts`, `modules/constants.ts`).
+- **Fix(engine)**: harden order engine against orphan-cascade failure modes — closes four unvalidated local-state paths (stale-slot fill price poisoning the anchor, off-market placement, phantom virtualization from empty reads, blind unknown-fill proceed credit) via broadcast orphan gates, anchor outlier rejection, price-sanity clamp, suspect empty-read guard (3 confirms), adoption retry, and durable `createUncertain` markers; placement now wrapped in `startBroadcasting` so fill-driven rebalances cannot duplicate plans (`modules/order/grid_reconcile.ts`, `modules/order/manager.ts`, `modules/dexbot_maintenance_runtime.ts`, `modules/constants.ts`, `modules/order/utils/order.ts`, `modules/dexbot_fill_runtime.ts`, `modules/dexbot_cow_runtime.ts`).
+- **Fix(maintenance)**: make trigger reset reliable — skip idle gate, drain stalled fills, repair infeasible boundaries — trigger-file resets now execute immediately (`skipIdle`), fill queues deferred by `batchInFlight`/`recoverySyncInFlight` are drained on pipeline clear via `_onBroadcastRegionEnd` (wired at both `OrderManager` creation sites), and `NO_FEASIBLE_BOUNDARY` (overlapping BUY/SELL inside gap) escalates to a minimal cancel ladder so placements resume instead of freezing in adoption-only mode (`modules/dexbot_maintenance_runtime.ts`, `modules/order/manager.ts`, `modules/dexbot_startup_runtime.ts`, `modules/order/utils/math.ts`, `modules/order/grid_reconcile*.ts`).
+- **Docs**: consolidate orphan-fix plans and add grid monotonicity gate — four test-branch incident/plan docs merged into `docs/CONSOLIDATED_ORPHAN_FIX_SUMMARY.md` (LANDED/REVERTED/SUPERSEDED annotated) and new `npm run analysis:grid-check` (`analysis/grid_correction_check.ts`) validates consecutive same-direction fills are monotonic (sell rising / buy falling) via Kibana `fill_order` history (`analysis/*`, `docs/*`, `modules/constants.ts`).
+
+### 2026-08-31
+
+- **Fix(launcher)**: ensure bot detection within 5min and correct disable/enable active check — new `TIMING.BOTS_CONFIG_POLL_INTERVAL_MS` (5min) decouples fingerprint polling from the heavy 240min chain fetch so new/reenabled bots are observed within 5min; `dexbot.ts` `setBotActiveState` now treats `undefined` as active (`active !== false`) fixing `enable all` churn on implicit-active bots (`modules/constants.ts`, `modules/dexbot_maintenance_runtime.ts`, `modules/dexbot_class.ts`, `modules/dexbot_startup_runtime.ts`, `dexbot.ts`).
+- **Fix(security)**: close shutdown race that wiped live signing tokens — `_shutdownImpl` no longer nulls `botHmacSecret` while deferred SAFE-REBALANCE continuations are pending; tokens are wiped only on process `exit` via `registerExitWipe`; `SOURCE_AUTH_DENIED` retries re-read `daemon-policies.json`, `OrderManager` gains `_shuttingDown`/`_awaitBroadcastIdle` abort, and monolithic mode retries failed bot startups bounded (3×30s) (`modules/dexbot_class.ts`, `modules/graceful_shutdown.ts`, `modules/key_store.ts`, `modules/order/manager.ts`, `modules/dexbot_fill_runtime.ts`, `modules/dexbot_cow_runtime.ts`, `dexbot.ts`).
+- **Fix(grid)**: block self-trading grid placements across all broadcast paths — adds tolerance-widened crossing guard (`findCrossedOrder` in `modules/order/utils/math.ts`, `buildCrossingCandidates` merging master/pending/chain) to COW CREATE/rotation NOT-FOUND fallback and to startup reconcile/relocation/price-correction paths; rotation now uses swept-band exclusion instead of stale slot-type rotation that caused chunked-broadcast self-fills (`modules/dexbot_cow_runtime.ts`, `modules/order/utils/math.ts`, `modules/order/grid_reconcile_internal.ts`, `modules/order/utils/order.ts`, `modules/order/strategy.ts`).
+- **Fix(fill)**: restore main fill queue handling stalled by broadcasting gate — removes `isBroadcastingActive` from `consumeFillQueue` defer gate (already serialized by `_fillProcessingLock`/stale-plan guard; defer had no reschedule and starved the queue during chunked broadcasts) and drains deferred fills when `_batchInFlight`/`_recoverySyncInFlight` clears (`modules/dexbot_fill_runtime.ts`, `modules/dexbot_maintenance_runtime.ts`, `modules/dexbot_class.ts`).
+- **Fix(grid)**: re-price duplicate-price grid stragglers instead of cancelling them — burst re-anchor that left multiple BUYs at the same level (e.g. 902.08089 ×2, 894.01113 ×3) and self-filled is now fixed by re-pricing stragglers to the next unique ladder step away from market (clamped to `[minPrice,maxPrice]`, preserving `orderId`/`size`) via `correctOrderPriceOnChain` UPDATEs instead of virtualize→cancel; adds whole-burst swept-band caching and asymmetric multi-sell-sweep buy exclusion for chunked and unified bursts (`modules/order/strategy.ts`, `modules/dexbot_class.ts`, `tests/test_grid_robustness.ts`).
+
+### 2026-09-01
+
+- **Fix(engine)**: revert anchor divergence and boundary-evidence, restore last-fill guard — removes `MarketAnchor`/`BOUNDARY-EVIDENCE`/`BAND-EXCLUSION` paths that drifted from self-trade fills and cancelled stranded orders, restores `deriveTargetBoundary`/`snapRail` grid-dedupe and seeds `LAST-FILL-GUARD` from book at startup/post-fill to block BUY above last filled BUY and SELL below last filled SELL with cross-guard per-type collision checks (`modules/constants.ts`, `modules/order/utils/order.ts`, `modules/order/strategy.ts`, `modules/order/grid_reconcile.ts`, `modules/dexbot_class.ts`, `modules/order/manager.ts`, `modules/dexbot_cow_runtime.ts`).
+- **Fix(grid)**: close duplicate-order incident class from trigger-reset phantom empty read — a trigger reset that observed a single 0-order lagging-node read rebuilt over a live order and queued the wrong duplicate for cancel (books 0.5626 vs chain 0.5626+0.6659). Fix: trigger `GRID-RESYNC` empty reads now require a 2s confirming re-read (`SYNC_EMPTY_READ_CONFIRM_DELAY_MS`), rotation/plan UPDATEs clamp or skip growing PARTIAL slots above booked remaining size, Pass 1 size-consistency tiebreak rebinds a slot to the same-price chain order matching booked size (exact), and `updateOrdersOnChainBatchCOW` drains pending price corrections before planning (`modules/dexbot_maintenance_runtime.ts`, `modules/constants.ts`, `modules/dexbot_cow_runtime.ts`, `modules/order/sync_engine.ts`, `modules/order/manager.ts`).
+- **Fix(g guard)**: last-fill guard pivot ± halfIncrement (BUY < pivot*(1-half), SELL > pivot*(1+half)) — replaces dual-pivot + tolerance with single global pivot (most recent fill) ± half grid increment (e.g. i=0.5% @1000 → BUY<997.5, SELL>1002.5); fixes SELL 1013>1001 after BUY 1001 being wrongly blocked and closes half-step profit hole; spread-correction bypass retained (`modules/order/manager.ts`, `modules/dexbot_cow_runtime.ts`).
+
+### 2026-09-02
+
+- **Feat(genesis)**: implement genesis-frozen price-slot determinism (Phase 1–2, log mode) — `slot-N` becomes the single source of truth (`price = genesis.priceLevels[N]`); adds `GridGenesis`/`hashPriceLevels`/`priceLevelsForGenesis`/`priceForSlot`/`slotIndexForPrice` (binary search, lower-wins tie)/`priceSlotEqual` (int equality)/`buildGenesisFromPriceLevels`/`assertSlotPriceInvariant`, canonical `parseSlotIndex` (`modules/order/utils/slot.ts`), `createOrderGrid` dedup+genesis build, `loadGrid` genesis validation/canonical re-sort/type re-assignment via `parseSlotIndex` with legacy migration, `account_orders`/`working_grid`/`system`/`startup`/`recovery` genesis threading, and `GRID_PRICE_SLOT_DETERMINISM_PLAN.md` (`modules/order/utils/math.ts`, `modules/order/grid.ts`, `modules/account_orders.ts`, `modules/order/working_grid.ts`, `modules/order/utils/system.ts`, `modules/dexbot_startup_runtime.ts`, `modules/dexbot_state_recovery.ts`, `modules/order/grid_reconcile.ts`, `docs/*`, `tests/test_grid_price_slot_invariant.ts`).
+- **Feat(genesis)**: complete genesis-frozen price-slot determinism (phases 3–9) — replaces all tolerance-based price matching with `slotId` equality / `priceSlotEqual`; sync engine Pass 2 adopts by nearest slot via `slotIndexForPrice` with `isSlotInRail` gap check and VIRTUAL/free slot bind; COW guards `hasSlotPriceCollision`/`validateCreateTargetSlots` use `priceSlotEqual`; fill/grid/rail paths (`isSlotInRail` fail-closed, `chainOrderMatchesSlot`, `hasDuplicatePriceLevel`, `grid_reconcile` cleanup) unified on genesis; legacy tolerance retained only for no-genesis migration (`modules/order/sync_engine.ts`, `modules/dexbot_cow_runtime.ts`, `modules/order/utils/validate.ts`, `modules/dexbot_fill_runtime.ts`, `modules/order/*`, `tests/*` 12 suites).
+- **Feat(editor)**: add Range quality legend with tiered coloring — `RANGE_QUALITY` thresholds (`GREEN_MIN 2.0` wide / `YELLOW_MIN 1.55` efficient / `ORANGE_MIN 1.45` tight / `RED_MAX 1.45` suicidal `<1.45x`) drive a pre-entry legend and live `colorRangeValueByQuality` in `askNumberOrMultiplier`/`askMaxPrice` and summary Pair display (cyan) (`modules/constants.ts`, `modules/account_bots.ts`).
+- **Feat(whitelist)**: add scoped `--bot` overwrite with validation and warnings — `dexbot white --bot <botKey>` overwrites only the targeted whitelist key (merge preserves unknown flags like `derivativeSignals`) while additive-only behavior is preserved without `--bot`; `parseOptions` now collects `botKeys` (`--bot`/`--bot-key`/`--botKey`, `=` and comma forms, repeatable) with missing/flag-like validation (throws, main prints usage and exits 1), `buildWhitelist` filters to targeted keys and warns when `--bot` target not found or has non-AMA `gridPrice` (`scripts/generate_market_adapter_whitelist.ts`, `dexbot.ts`, `docs/*`, `tests/test_market_adapter_fixes.ts`).
+- **Fix(editor)**: align Range quality wording — legend `≤1.35x: suizidal` → `<1.45x: suizidal` to match `getRangeQuality` (`<1.45x` red, `1.45x–1.55x` orange) and make `RANGE_QUALITY.RED_MAX` authoritative (`modules/constants.ts`, `modules/account_bots.ts`).
+
+## [1.4.24] - 2026-08-28 - Native Fill Gap Recovery, Eager Coalesced Retry, LP Collateral Offer-First Pricing
+
+### 2026-08-28
+
+- **Fix(native-client)**: recover dropped fills after subscription notice gaps — **core engine fix** for the 2026-08-28 crash burst (24 and 38 fills dropped, Fund invariant violation SELL / oversell). `handleNotice` advanced `lastDeliveredHistoryId` to the max op id present in the notice (including non-fill ops like `limit_order_create`), so any fill whose `1.11.x` id fell between the old cursor and that max was skipped by the strictly-newer-than-cursor `get_account_history` scan and lost forever; reconnect/poll did not arm recovery and the history merge left entries unsorted so the cursor could land on a gap entry. The fix: `handleNotice` now advances only to the max `fillMatchesAccount` id for that subscription and arms `_gapRecovery` for the next coalesced `processObjects`; `fetchFillHistoryEntries` gains a `lookbackOps` window (`NATIVE_CLIENT.SUBSCRIPTIONS.HISTORY_GAP_LOOKBACK_OPS = 2000` per-account `1.11.x` slots) that lowers `stop` to `cursor-lookback-1` inclusive (core `api.cpp:443` stop is exclusive) and skips entries below the lookback floor — so `[lookbackStop, head]` is re-covered with re-delivery safe via downstream history-id dedup; `processObjects` consumes `_gapRecovery` with a single inclusive lookback+tail scan, sorts oldest-first, and only clears the flag after a successful fetch (retry on throw/timeout); `resubscribeEntry`/`resubscribeAll` arm `_gapRecovery` unconditionally on reconnect; `startFillPolling` no longer arms every 60s tick (avoids ~80 pages/min steady-state cost); new `decrementObjectIdBy` helper and defensive sorting added (`modules/bitshares-native/subscriptions.ts`, `modules/constants.ts`, new `tests/test_fill_gap_recovery.ts` reproducing 5095..5099 gap with cursor 5000→6002 and asserting recovery).
+- **Fix(native-client)**: eager gap recovery without waiting for poll — the initial gap fix armed `_gapRecovery` but recovery was only consumed by the next non-fill notice coalesce (250ms) or the 60s fill poll, leaving up to a 60s correctness window in the quiet-after-gap case where the burst gap (5095..5099 dropped, cursor 5000→6002) could still cause inventory drift before the lightweight 15min/240min open-orders syncs. Now `_gapRecovery` is armed only when the cursor gap exceeds one op (`gap = latest - oldCursor > 1`, so sequential 5000→5001 skips the scan while burst 5000→6002 arms it, avoiding a 40-page scan on every sequential fill) and an eager coalesced lookback is scheduled via `pendingScans`/`_processingHistory` for each armed sub (fires in ~250ms `NOTICE_COALESCE_MS`, unref timer, coalesced per burst, respects in-flight scans); `processObjects` pollution is avoided by skipping poll when `_processingHistory` is true, with poll retained only as a safety-net fallback — cost is one 40-page window per gap event, not per poll, retry-safe via history-id dedup (`modules/bitshares-native/subscriptions.ts`, `tests/test_fill_gap_recovery.ts` tightened to eager-only path without a second no-fill notice).
+- **Fix(credit-runtime)**: prefer offer map over pool for LP collateral pricing — the hourly `live credit offer price unavailable` warn fired for LP share collateral where pool derivation failed for the debt denomination (e.g. pool requires pricing an underlying reserve with no market) even though the offer's `acceptable_collateral` listed the LP explicitly; the LP-exclusive branch ran before the offer-map lookup and returned `cached-offer` on pool miss, shadowing the live offer and logging both the pool derivation failure and the cached-offer warn on every hourly collateral distribution call, with redundant asset resolution and stale line-number refs. `_resolveCreditConversionRate` now tries the offer map (live-offer / owned-offer) first and only falls back to `deriveLiquidityPoolTokenValue` when the offer has no entry for the debt/collateral pair; pool fallback is gated on `!cachedIsFresh` to avoid hourly `deriveLiquidityPoolTokenValue` failures when a fresh cached rate exists; already-resolved `debtAsset`/`collateralAsset` are reused instead of re-resolving for the pool path; early cached return on owned-offer miss is replaced by fall-through so genuine LP-no-offer pairs still reach the pool fallback (`modules/credit_runtime.ts`).
+
 ## [1.4.23] - 2026-08-28 - Even AMA Ladder, BTS Fee-Carve Fix, Price-Bound Rejection, TradingView Axis, Doc Realignment
 
 ### 2026-08-26

package/README.md

@@ -178,6 +178,7 @@ Keep the default settings first, and tune these:
    This writes `market_adapter_whitelist.json` in the profiles directory. New AMA bots get AMA
    live writes and range scaling. Use `dexbot white --dynamic-weight` for
    newly generated dynamic-weight entries; existing entries are preserved.
+   To overwrite an existing bot: `dexbot white --dynamic-weight --bot <botKey>`.
 
 6. **Start DEXBot2** with `dexbot start`.
 

package/analysis/README.md

@@ -21,6 +21,7 @@ Tools that inspect DEXBot trading behavior and the market data it operates on. O
 | Tool | Ask this when… | One-line command |
 |------|----------------|------------------|
 | [`trade_profitability.ts`](#trade-profitability-analyzer-trade_profitabilityts) | "Is my bot making money?" — PnL, R-multiples, drawdown | `npm run analysis:trade-pnl -- <account-id>` |
+| [`grid_correction_check.ts`](#grid-correction-check-grid_correction_checkts) | "Is my grid placing orders monotonically?" — sell/buy price inversion detector | `npm run analysis:grid-check -- --bot-key <bot-key>` |
 | [`analyze_risk_profile.ts`](#risk-profile-analyzer-analyze_risk_profilets) | "How wide should my Safe Range clamps be?" | `node dist/analysis/analyze_risk_profile.js --bot-key <bot-key>` |
 | [`analyze_trade_heatmap.ts`](#trade-heatmap-analyze_trade_heatmapts) | "Where did trade volume cluster vs the AMA?" | `node dist/analysis/analyze_trade_heatmap.js --bot-key <bot-key>` |
 | [`tradingview/analyze_tradingview.ts`](#tradingview-chart-tradingviewanalyze_tradingviewts) | "Just give me a candle chart" | `npm run analysis:tradingview -- --source market_adapter --bot-key <bot-key>` |
@@ -219,6 +220,49 @@ node dist/analysis/trade_profitability.js 1.2.123456 \
 
 </details>
 
+### Grid Correction Check (`grid_correction_check.ts`)
+
+Validates grid discipline from the same Kibana fill pipeline as `trade_profitability.ts`: two consecutive same-direction fills on a pair must be monotonic — sell prices rising, buy prices falling (equal is OK). An inversion means the bot placed an order below its own previous sell (or above its own previous buy), e.g. an orphaned order filling outside grid accounting. Used as the external regression gate for the orphan-fix plans in `docs/CONSOLIDATED_ORPHAN_FIX_SUMMARY.md`.
+
+**Pipeline:** Kibana `fill_order` query (paginated `search_after`) → on-chain asset precision resolution → buy/sell classification → chronological sort → per-order aggregation (multi-fill orders collapsed to weighted-avg price by default) → consecutive same-direction pair comparison → violation report with daily histogram.
+
+```bash
+# Per-order aggregated check (default), last 7 days
+npm run analysis:grid-check -- --bot-key <bot-key> --hours 168
+
+# 30 days, JSON + CSV export of violations
+npm run analysis:grid-check -- --bot-key <bot-key> --hours 720 --json out.json --csv out.csv
+
+# Raw fill granularity instead of per-order aggregation
+npm run analysis:grid-check -- --bot-key <bot-key> --per-fill --hours 168
+
+# Forgive small adverse moves within 0.1%
+npm run analysis:grid-check -- --bot-key <bot-key> --hours 168 --tolerance 0.1
+```
+
+Exit code `0` = pass, `2` = violations found, `1` = fatal error. Bot keys resolve via `profiles/bots.json` (`--list-bots` to enumerate); the account defaults to the bot's `preferredAccount` and can be overridden with `--account <1.2.x|name>`.
+
+<details><summary>Options (click to expand)</summary>
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--bot-key <key>` | — | Bot key or name from `profiles/bots.json` (required) |
+| `--hours <n>` | `168` | Lookback hours from now |
+| `--start <iso>` / `--end <iso>` | — | Absolute time window |
+| `--account <id>` | bot `preferredAccount` | Override account ID or name |
+| `--lookup` | off | Resolve account name to 1.2.x via BitShares node |
+| `--node <url>` | first built-in node | Node for account/asset resolution |
+| `--per-fill` | off | Check at fill granularity instead of per-order aggregated |
+| `--include-cross-pair` | off | Also check consecutive fills across different pairs |
+| `--tolerance <pct>` | `0` | Adverse price move (%) forgiven before flagging |
+| `--json <file>` / `--csv <file>` | — | Export violations |
+| `--verbose` | off | Print the full trade sequence |
+| `--list-bots` | — | List available bot keys and exit |
+
+</details>
+
+**Notes:** strict sat-level comparison is the ground truth (`--tolerance` only forgives small inversions); multi-fill orders are collapsed to a weighted-average price for the default per-order mode, so a single order's partial fills at identical prices never count as inversions.
+
 ## Charts & Visualization
 
 ### Trade Heatmap (`analyze_trade_heatmap.ts`)
@@ -445,6 +489,7 @@ These npm scripts wrap common analysis runners:
 |--------|---------|
 | `npm run analysis:tradingview` | `node dist/analysis/tradingview/analyze_tradingview.js` |
 | `npm run analysis:trade-pnl` | `node dist/analysis/trade_profitability.js` |
+| `npm run analysis:grid-check` | `node dist/analysis/grid_correction_check.js` |
 | `npm run analysis:derivatives` | `node dist/analysis/analyze_derivatives.js` (legacy SMA/MACD/RSI layer, reference only) |
 | `npm run ama:chart:lp-local` | `node dist/analysis/ama_fitting/generate_unified_comparison_chart.js` (chart also auto-generated by optimizer) |
 
@@ -457,6 +502,9 @@ npm run analysis:tradingview -- --source market_adapter --bot-key <bot-key>
 # Trade PnL
 npm run analysis:trade-pnl -- 1.2.123456 --hours 720
 
+# Grid correction check (monotonicity regression gate)
+npm run analysis:grid-check -- --bot-key <bot-key> --hours 168
+
 # File-based
 npm run analysis:tradingview -- --file market_adapter/data/market_adapter_<bot-key>_1h.json
 npm run ama:chart:lp-local -- --data market_adapter/data/lp/<pair>/lp_pool_<id>_<interval>.json
@@ -465,4 +513,5 @@ npm run ama:chart:lp-local -- --data market_adapter/data/lp/<pair>/lp_pool_<id>_
 ## Related Docs
 
 - [Market Adapter](../market_adapter/README.md) — live AMA pricing, grid triggers, dynamic weights, and recalc triggers
+- [Consolidated Orphan-Fix Summary](../docs/CONSOLIDATED_ORPHAN_FIX_SUMMARY.md) — orphan/gap-band root-cause plans; `grid_correction_check` is their regression gate
 - [DEXBot2 Tuning Cheat Sheet](../claw/docs/DEXBOT2_TUNING_CHEAT_SHEET.md) — grid tuning reference for live bots

package/analysis/ama_fitting/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ama_fitting",
-  "version": "1.4.23",
+  "version": "1.4.25",
   "description": "Tools for fitting AMA parameters to market data",
   "main": "../../dist/analysis/ama_fitting/optimizer_high_resolution.js",
   "scripts": {