dexbot 1.6.3 → 1.6.5

package/docs/architecture.md

@@ -59,7 +59,7 @@ graph TB
         TARGET[Strategy Engine<br/>calculateTargetGrid<br/>boundary-crawl pivot<br/>partial-fill consolidation, rotation]
         WORKGRID[WorkingGrid - COW copy<br/>all mutations here only<br/>commit to Master on confirmation]
         FILLQUEUE[Fill Queue<br/>AsyncLock + dedup 5-60 min]
-        BATCHER[Fixed-Cap Batcher<br/>queue within cap: unified batch<br/>queue above cap: chunk at cap size<br/>default cap: 4]
+        BATCHER[Fixed-Cap Batcher<br/>queue within cap: unified batch<br/>queue above cap: chunk at cap size<br/>cap = gapSlots + 1]
     end
 
     subgraph "OUTPUTS"
@@ -107,7 +107,7 @@ graph TB
 | **Immutability** | Master Grid is frozen; all changes go through a disposable WorkingGrid (Copy-on-Write) |
 | **Single Source of Truth** | Accounting engine owns all fund data; everything reads from it |
 | **Event-driven + Polling** | Fill Events (real-time) and Open-Order polling feed the same queue |
-| **Fixed-Cap Batching** | Deterministic batching with hard cap per broadcast (default 4 fills) |
+| **Fixed-Cap Batching** | Deterministic batching with hard cap per broadcast (cap = gapSlots + 1 fills) |
 | **Persistence** | Grid snapshot written after every confirmed blockchain commit |
 
 ---
@@ -377,13 +377,13 @@ The fill pipeline handles incoming filled orders efficiently through fixed-cap b
                       ↓
 ┌─────────────────────────────────────────────────────────────┐
 │             processFilledOrders() - Entry Point             │
-│    Use gap-slot batch size for deterministic batching   │
-│      Rules: <=gapSlots unified, >gapSlots chunked      │
+│    Use gap-slot batch size (gapSlots+1) for deterministic batching   │
+│      Rules: <=gapSlots+1 unified, >gapSlots+1 chunked      │
 └─────────────────────┬───────────────────────────────────────┘
                       ↓
 ┌─────────────────────────────────────────────────────────────┐
-│            Pop Batch (up to gapSlots)                     │
-│        Takes N fills from queue head (N = 1..gapSlots)     │
+│            Pop Batch (up to gapSlots+1)                     │
+│        Takes N fills from queue head (N = 1..gapSlots+1)     │
 │   Example: pops [fill1, fill2, fill3] for batch processing  │
 └─────────────────────┬───────────────────────────────────────┘
                       ↓
@@ -418,9 +418,9 @@ The fill pipeline handles incoming filled orders efficiently through fixed-cap b
 
 ### Key Properties
 
-- **Gap-Slot Batch Sizing**: Batch size is deterministic, derived from the grid gap-slot count (`DEXBot._getGapSlotBatchSize`)
-  - 1..gapSlots awaiting: single unified batch (one rebalance/broadcast cycle)
-  - more than gapSlots awaiting: repeated chunks of gapSlots (last chunk may be smaller)
+- **Gap-Slot Batch Sizing**: Batch size is deterministic, derived from the grid gap-slot count + 1 (`DEXBot._getGapSlotBatchSize`)
+  - 1..gapSlots+1 awaiting: single unified batch (one rebalance/broadcast cycle)
+  - more than gapSlots+1 awaiting: repeated chunks of gapSlots+1 (last chunk may be smaller)
 
 - **Single Rebalance Cycle**: All fills in batch processed in ONE rebalance
   - No "split across cycles" delays
@@ -916,7 +916,7 @@ graph TB
     START[Grid Update Triggered] --> CALC[Calculate Ideal Grid<br/>Based on current funds]
     CALC --> RELOAD[Force Reload Persisted Grid<br/>Ensure fresh blockchain state]
     RELOAD --> COMPARE[Compare to Persisted Grid]
-    COMPARE --> RMS[Calculate RMS Divergence<br/>For PARTIAL orders only]
+    COMPARE --> RMS[Calculate RMS Divergence<br/>ACTIVE + VIRTUAL orders per side]
 
     RMS --> CHECK{RMS > Threshold?}
     CHECK -->|Yes| UPDATE[Update Grid Sizes<br/>Trigger rebalance]
@@ -1043,28 +1043,17 @@ graph LR
 
 The system has been optimized to use a "memory-driven" model for order updates, eliminating redundant blockchain API calls during normal operation.
 
-### Key Changes
-
-**1. Raw Order Cache (`rawOnChain`)**
-- Grid slots now store exact blockchain order representations (integers/satoshis) in a `rawOnChain` cache
-- **Birth**: Cache populated immediately after successful order placement using broadcasted arguments
-- **Partial Fills**: Cache updated in-place via integer subtraction (subtracting filled satoshis from `for_sale`)
-- **Updates/Rotations**: Cache refreshed with adjusted integers returned by build process
-
-**2. Eliminated Redundant API Calls**
-- Removed all `readOpenOrders()` calls from `_buildSizeUpdateOps()` and `_buildRotationOps()`
-- Removed `computeVirtualOpenOrders()` logic that was redundantly fetching entire account state
-- The bot now trusts its internal state, backed by real-time fill listener, to build transactions
-
-**3. Refactored `buildUpdateOrderOp()`**
-- Updated to support optional `cachedOrder` parameter
-- Allows callers to bypass blockchain queries if they have raw state in memory
-- Returns `finalInts` along with operation data for local tracking
-
-**4. Self-Healing Resilience**
-- Maintains "State Recovery Sync" fallback
-- If a memory-driven transaction fails, bot catches error and performs a full refresh
-- Ensures internal ledger stays synchronized with BitShares blockchain
+### How it works
+
+- **Raw order cache (`rawOnChain`):** each grid slot stores the exact blockchain order integers
+  (satoshis) — seeded from broadcast arguments on placement, updated in place on partial fills,
+  and refreshed on updates/rotations.
+- **Chain-free planning:** size updates and rotations build their operations from the cache;
+  only placements and recovery syncs query the blockchain.
+- **`buildUpdateOrderOp(cachedOrder?)`:** accepts an optional cached order and returns
+  `finalInts` alongside the operation for local tracking.
+- **Self-healing:** a failed memory-driven transaction triggers a full state-recovery sync so the
+  internal ledger stays consistent with the chain.
 
 ### Benefits
 - **Faster reaction time**: No waiting for blockchain queries during order updates

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 |
 |------|---------|
-| **Gap-Slot Batch Fill Processing** | Groups fills using the grid gap-slot count as batch size (`DEXBot._getGapSlotBatchSize`): `<= gapSlots` uses one unified batch; `> gapSlots` chunks at gapSlots. 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). |
+| **Gap-Slot Batch Fill Processing** | Groups fills using the grid gap-slot count + 1 as batch size (`DEXBot._getGapSlotBatchSize`): `<= gapSlots + 1` uses one unified batch; `> gapSlots + 1` chunks at `gapSlots + 1`. 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`. |
 
@@ -171,8 +171,8 @@ A **phantom order** is an order in ACTIVE/PARTIAL state WITHOUT a valid `orderId
 | **Atomic Check-and-Deduct** | Verify funds + deduct in single operation |
 | **Divergence Detection** | Comparing ideal grid vs. persisted grid |
 | **Invariant Verification** | Checking fund accounting consistency |
-| **Batch Processing** | Grouping multiple fills into a single rebalance cycle instead of one-at-a-time. Gap-slot sizing: `<= gapSlots` unified, otherwise chunked at gapSlots. |
-| **Gap-Slot Batch Sizing** | Deterministic chunking model with the grid gap-slot count as the per-broadcast bound. Keeps throughput high while avoiding tier-lookup complexity. |
+| **Batch Processing** | Grouping multiple fills into a single rebalance cycle instead of one-at-a-time. Gap-slot sizing: `<= gapSlots + 1` unified, otherwise chunked at `gapSlots + 1`. |
+| **Gap-Slot Batch Sizing** | Deterministic chunking model with the grid gap-slot count + 1 as the per-broadcast bound. Keeps throughput high while avoiding tier-lookup complexity. |
 | **Stale-Order Recovery** | Fast-path recovery for single-operation batches that encounter stale orders on-chain. Executes cleanup without full state sync. |
 | **Orphan-Fill Prevention** | Deduplication mechanism that prevents double-crediting fills from stale-cleaned orders using timestamp-based ID tracking (TTL pruning). |
 
@@ -1559,6 +1559,7 @@ console.log('Locked?', manager.isOrderLocked(order.id));
 - `modules/node_manager.ts` - Multi-node health checking and failover
 - `modules/fund_registry.ts` - Shared-account fund registry with cross-bot invariants
 - `modules/settings_merge.ts` - Consolidated settings merge (single source of truth)
+- `modules/bot_defaults.ts` - Central bot-defaults seeder (draft/entry/runtime-config modes); single source for how `DEFAULT_CONFIG` is applied
 - `modules/chain_orders.ts` - Blockchain order operations
 - `modules/account_orders.ts` - Account order queries
 

package/market_adapter/README.md

@@ -21,13 +21,13 @@ The live signal layer for AMA-priced bots. It reads candles, computes the AMA ce
 
 | If you want to… | Read this | Key command |
 |-----------------|-----------|-------------|
-| Enable AMA pricing for a bot | [Quick Start](#quick-start) | `dexbot white` |
+| Enable AMA pricing for a bot | [Quick Start](#quick-start) | `dexbot bot` → `6) Adapter` |
 | Change how often the grid rebuilds | [Trigger Threshold](#trigger-threshold) | edit `AMA_DELTA_THRESHOLD_PERCENT` |
-| Tune buy/sell weight bias | [Asymmetric Weight Shift](#asymmetric-weight-shift) | whitelist `dynamicWeight: true` |
-| Widen/tighten grid bounds by trend | [Grid Range Scaling](#grid-range-scaling) | whitelist `asymmetricBounds: true` |
+| Tune buy/sell weight bias | [Asymmetric Weight Shift](#asymmetric-weight-shift) | `6) Adapter` → Weight |
+| Widen/tighten grid bounds by trend | [Grid Range Scaling](#grid-range-scaling) | `6) Adapter` → Range |
 | Override settings for one pair or bot | [Settings and Overrides](#settings-and-overrides) | edit `profiles/market_adapter_settings.json` |
 | Run the adapter standalone or test dry-run | [Live Writes and Dry-Run](#live-writes-and-dry-run) | `node dist/market_adapter/market_adapter.js --dryRun` |
-| Debug a bot not being processed | [Troubleshooting](#troubleshooting) | `dexbot white` |
+| Debug a bot not being processed | [Troubleshooting](#troubleshooting) | `6) Adapter` flags |
 | Understand the signal pipeline or module layout | [Technical Reference](#technical-reference) | — |
 
 ## Big Picture
@@ -64,47 +64,23 @@ default preset.
 
 When fetching candles (`pool` or `book`), the adapter requires a full historical window. The oldest `erPeriod` candles are used for an initial SMA (Simple Moving Average) warmup phase to seed the AMA and establish the first Efficiency Ratio (ER) calculation. See [AMA Warmup Window](#ama-warmup-window--why-candle-length-matters) for technical details.
 
-### 2. Whitelist Live Writes
+### 2. Enable Live Writes
 
-Generate the whitelist from AMA-enabled bots. Without a whitelist entry, the
-adapter still computes state, but live grid snapshots and recalc triggers stay
-in dry-run mode.
+Open the bot editor — `dexbot bot` → `2) Modify bot` → pick the bot →
+`6) Adapter` — and set the three per-bot flags:
 
-```bash
-dexbot white
-```
-
-This writes `profiles/market_adapter_whitelist.json`, where each bot's AMA,
-dynamic-weight, and range-scaling flags can be inspected or adjusted.
-
-By default, newly generated entries whitelist AMA pricing only, keeping both
-dynamic weights and range scaling (asymmetric bounds) disabled. To opt newly
-generated entries into dynamic weights:
-
-```bash
-dexbot white --dynamic-weight
-```
-
-To opt newly generated entries into range scaling:
+| Flag | Whitelist key | Effect |
+|------|---------------|--------|
+| **Price** | `ama` | Allows live `dynamicgrid.json` and recalc-trigger writes. Without it the adapter still computes state, but live output stays in dry-run. |
+| **Weight** | `dynamicWeight` | Opt-in dynamic buy/sell weights. |
+| **Range** | `asymmetricBounds` | Opt-in AMA-slope range scaling. |
 
-```bash
-dexbot white --asymmetric-bounds
-```
-
-To overwrite an existing entry (existing entries are otherwise preserved):
-
-```bash
-dexbot white --dynamic-weight --bot <botKey>
-dexbot white --asymmetric-bounds --bot <botKey>
-```
-
-`--bot` implies overwrite for that key only; without it, `dexbot white` only adds missing bots.
-
-Remove stale whitelist entries (bots no longer in `bots.json`):
-
-```bash
-dexbot white --prune
-```
+The flags are stored per bot in `profiles/market_adapter_whitelist.json`;
+re-open the section any time to inspect or change them. Boolean prompts
+accept `y`/`yes`/`true` and `n`/`no`/`false`; Enter keeps the current value.
+Renaming a bot carries its flags to the new key, deleting a bot removes its
+entry, and all-off flags are saved as an explicit `false` entry so the flags
+never silently fall back to defaults.
 
 ### 3. Start DEXBot2
 
@@ -156,10 +132,8 @@ whitelist gate:
 
 This is separate from dynamic buy/sell weighting. Both grid-range effects are
 enabled only when `asymmetricBounds: true` is set in
-`profiles/market_adapter_whitelist.json`. Range scaling is opt-in: `dexbot white`
-generates AMA-only entries by default, so enable it with
-`dexbot white --asymmetric-bounds` (new bots) or
-`dexbot white --asymmetric-bounds --bot <botKey>` (existing entry).
+`profiles/market_adapter_whitelist.json`. Range scaling is opt-in: enable it
+per bot with `dexbot bot` → `2) Modify bot` → `6) Adapter` → **Range**.
 
 Technical formula and tuning details are in
 [Grid Range Scaling Model](#grid-range-scaling-model).
@@ -334,11 +308,8 @@ Dry-run log lines include `[DRY RUN]` or `[suppressed, dry-run]`.
 
 | Task | Command |
 |------|---------|
-| Generate whitelist | `dexbot white` |
-| Opt new whitelist entries into dynamic weights | `dexbot white --dynamic-weight` |
-| Opt new whitelist entries into range scaling | `dexbot white --asymmetric-bounds` |
-| Overwrite existing entry for a specific bot | `dexbot white --dynamic-weight --bot <botKey>` \| `dexbot white --asymmetric-bounds --bot <botKey>` |
-| Prune stale whitelist entries (bots removed from bots.json) | `dexbot white --prune` |
+| Enable/inspect Price, Weight, Range for a bot | `dexbot bot` → `2) Modify bot` → `6) Adapter` |
+| Remove a deleted bot's entry | Automatic — `dexbot bot` → `3) Delete` also drops its whitelist key |
 | Probe public CEX availability | `node dist/market_adapter/inputs/fetch_cex_synthetic_data.js --exchange auto --check-only` |
 | Seed synthetic cross candles | `node dist/market_adapter/inputs/fetch_cex_synthetic_data.js --exchange auto --bot-key <bot-key>` |
 | Run one adapter cycle | `node dist/market_adapter/market_adapter.js --once` |
@@ -368,7 +339,7 @@ match the bot's eventual `botKey`.
 ### Bot is not processed
 
 - Confirm `gridPrice` is `ama`, `ama1`, `ama2`, `ama3`, or `ama4`.
-- Regenerate the whitelist with `dexbot white`.
+- Open `dexbot bot` → `2) Modify bot` → `6) Adapter` and confirm **Price** is `true`.
 - Confirm the expected `botKey` exists in `profiles/market_adapter_whitelist.json`.
 - If `startPrice` is numeric, the adapter will not fetch pool/book candles for that bot. Use `startPrice` only for a fixed anchor in that case; `gridPrice` remains a separate grid setting.
 
@@ -377,7 +348,7 @@ match the bot's eventual `botKey`.
 - Check `lastDeltaPercent` vs `thresholdPercent`.
 - Check `staleData` and `staleAgeHours`.
 - **Confirm the bot is whitelisted.** Non-whitelisted bots only log and do not write triggers.
-- Confirm the bot's whitelist entry has `"ama": true`.
+- Confirm the bot's whitelist entry has `"ama": true` (`dexbot bot` → `6) Adapter` shows it as **Price**).
 - Run `node dist/market_adapter/market_adapter.js --once --deltaPercent <lower-value>` for a one-cycle threshold test.
 
 ### Trigger fires too often
@@ -632,7 +603,9 @@ market_adapter/
 
 ### Whitelist Semantics
 
-`profiles/market_adapter_whitelist.json` controls live writes:
+`profiles/market_adapter_whitelist.json` controls live writes. It is edited
+per bot in the bot editor (`dexbot bot` → `6) Adapter`), which reads and
+writes this same file:
 
 ```json
 {
@@ -667,8 +640,11 @@ AMA slope -> live market/start-price offset, capped at half spread
 
 During a grid rebuild, the bot loads the latest dynamic grid snapshot and uses
 the AMA slope diagnostics to tilt the configured `minPrice` and `maxPrice`
-around the AMA center. An uptrend widens the upper bound and tightens the lower
-bound; a downtrend widens the lower bound and tightens the upper bound.
+around the AMA center. A reciprocal (log-symmetric) tilt scales both bounds by
+the same factor: an uptrend shifts the whole band up by `1 + asymmetry`, a
+downtrend shifts it down by `1 / (1 + asymmetry)`. The trend side therefore
+extends while the opposite side tightens toward the center, while total log
+width (and slot count) is preserved.
 
 The same `asymmetricBounds` whitelist also enables `gridPriceOffsetPct`: a
 slope-ratio offset applied only to the live `startPrice` used for initial
@@ -686,15 +662,15 @@ slopeOffset = slope normalized to the configured dynamic-weight slope cap
 asymmetry = min(|slopeOffset| / maxSlopeOffset, 1) × maxAsymmetryFactor
 
 Downtrend: minPrice = center / (M × (1 + asymmetry))
-           maxPrice = center × (M × (1 - asymmetry))
+           maxPrice = (center × M) / (1 + asymmetry)
 
 Uptrend:   maxPrice = center × (M × (1 + asymmetry))
-           minPrice = center / (M × (1 - asymmetry))
+           minPrice = (center / M) × (1 + asymmetry)
 
 Neutral:   symmetric bounds (asymmetry = 0)
 ```
 
-`ASYMMETRIC_BOUNDS_MAX_ASYMMETRY_FACTOR` defaults to `0.35`; `0` disables the
+`ASYMMETRIC_BOUNDS_MAX_ASYMMETRY_FACTOR` defaults to `0.333`; `0` disables the
 tilt. `ASYMMETRIC_BOUNDS_MIN_SCALE_SLOTS` defaults to `10` and sets the minimum
 number of price levels the *tightened* side of a range-scaled grid must keep
 between the grid center and its bound (measured in `incrementPercent` steps);
@@ -710,7 +686,7 @@ Both are configurable per bot or per market via
 {
   "globals": {
     "asymmetricBounds": {
-      "maxAsymmetryFactor": 0.35,
+      "maxAsymmetryFactor": 0.333,
       "minScaleSlots": 10
     }
   },

package/modules/README.md

@@ -8,7 +8,7 @@ Everything below covers bot lifecycle, order management, blockchain connectivity
 
 If you're new to the codebase, read these files in order (~20 minutes):
 
-1. **`constants.ts`** — all tuning parameters and defaults live here; gives you a map of the system's knobs
+1. **`constants.ts`** — all tuning parameters and defaults live here; gives you a map of the system's knobs, and `buildDefaultGeneralSettings()` builds the canonical default `general.settings.json` document (first-run, editor fallback, local-overrides merge all share it)
 2. **`dexbot_class.ts`** — the top-level orchestrator; shows how bot startup, fill processing, and maintenance connect
 3. **`order/manager.ts`** — the central controller for the grid; read the constructor and `_applySafeRebalanceCOW()`
 4. **`order/grid.ts`** — how the geometric grid is generated and sized
@@ -36,6 +36,7 @@ modules/
 ├── credential_policy.ts           signing policy validation
 ├── credential_session_cache.ts    encrypted session cache
 ├── constants.ts                   central config and tuning params
+├── bot_defaults.ts                bot defaults seeder (draft/entry/runtime-config modes)
 ├── config.ts                      load-time process.env snapshot
 ├── env.ts                         isBrowser/hasProcess detection
 ├── runtime.ts                     process abstraction singleton

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dexbot",
-  "version": "1.6.3",
+  "version": "1.6.5",
   "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": {
@@ -83,7 +83,6 @@
     "pdev": "bash scripts/pdev.sh",
     "ptest": "bash scripts/ptest.sh",
     "lp:chart": "npm run build && node dist/scripts/generate_lp_chart.js",
-    "market-adapter:whitelist": "npm run build && node dist/scripts/generate_market_adapter_whitelist.js",
     "market-adapter:fetch-cex-synthetic": "npm run build && node dist/market_adapter/inputs/fetch_cex_synthetic_data.js",
     "analysis:tradingview": "npm run build && node dist/analysis/tradingview/analyze_tradingview.js",
     "ama:chart:lp-local": "npm run build && node dist/analysis/ama_fitting/generate_unified_comparison_chart.js",

package/scripts/README.md

@@ -93,29 +93,6 @@ bash scripts/reset-settings.sh
 node dist/scripts/validate_bots.js
 ```
 
-### Market Adapter Whitelist Generation
-**File:** `generate_market_adapter_whitelist.ts`
-**Purpose:** Generate `profiles/market_adapter_whitelist.json` from bots whose `gridPrice` uses AMA mode.
-```bash
-# Add missing AMA bots from profiles/bots.json to profiles/market_adapter_whitelist.json.
-# Existing entries are preserved; new entries enable AMA only and leave dynamicWeight and range scaling disabled.
-dexbot white
-
-# Add missing AMA bots with dynamicWeight enabled for newly generated entries
-dexbot white --dynamic-weight
-
-# Add missing AMA bots with range scaling (asymmetricBounds) enabled for newly generated entries
-dexbot white --asymmetric-bounds
-
-# Overwrite existing entry for a specific bot (implies overwrite for that key only; other bots unchanged)
-dexbot white --dynamic-weight --bot <botKey>
-dexbot white --asymmetric-bounds --bot <botKey>
-
-# Remove whitelist entries for bots no longer in profiles/bots.json
-dexbot white --prune
-
-```
-
 ### Grid Divergence Audit
 **File:** `divergence-calc.ts`
 **Purpose:** Measure the "drift" between in-memory grid and disk state using RMS divergence metric.
@@ -363,7 +340,6 @@ The following scripts allow you to call `dexbot` commands directly from the `scr
 ### Analysis
 | Command | Purpose |
 |:---|:---|
-| `npm run market-adapter:whitelist` | Generate/update whitelist from AMA-configured bots |
 | `npm run market-adapter:fetch-cex-synthetic` | Fetch CEX synthetic data for market adapter |
 | `npm run analysis:derivatives` | Derivative analysis report |
 | `npm run analysis:tradingview` | TradingView-style chart export |
@@ -385,8 +361,10 @@ The following scripts allow you to call `dexbot` commands directly from the `scr
 
 ## 📈 CHART GENERATION
 
+`dexbot tv` and `dexbot dw` share ONE fetch pipeline ([`chart_command.ts`](chart_command.ts)): identical target resolution, source routing, cached candle chunks, and temp-file handoff — only the renderer registration (`RENDERERS` table) differs.
+
 ### TradingView (`dexbot tv`)
-**File:** `tv.ts`
+**File:** `tv.ts` (thin entry; shared pipeline: `chart_command.ts`)
 **Purpose:** One-step TradingView-style 1h chart for a bot (with AMA + order overlay), pool, or pair. Fetches candles in monthly Kibana chunks (pool-first with order-book fallback; `--feed` for MPA price-feed history), then renders via `analysis/tradingview/`. Bot charts pick up the order overlay from `profiles/orders/<botKey>.json` automatically.
 **Output:** `analysis/charts/tv_<bot|pool_<id>|<a>_<b>>_1h_<N>m.html` (`_feed` suffix for feed charts)
 ```bash
@@ -399,6 +377,21 @@ dexbot tv TOKENA/TOKENB --month 1 --chart analysis/charts/custom.html
 dexbot tv BTS/HONEST.USD --feed --month 1
 ```
 
+### Dynamic Weight (`dexbot dw`) — advanced
+**File:** `dw.ts` (thin entry; shared pipeline: `chart_command.ts`)
+**Purpose:** Identical one-step pipeline to `dexbot tv` (same targets, `--month`, `--feed/--pool/--book`, same cached monthly candle chunks) — the only difference is the renderer: it writes the dynamic-weight research chart via `analysis/analyze_dynamic_weight.ts` (AMA slope + Kalman blend, Hurst/PE regime gate) instead of a TradingView chart. For weight-tuning research, not general charting.
+**Output:** `analysis/charts/dw_<bot|pool_<id>|<a>_<b>>_1h_<N>m.html` (`_feed` suffix for feed charts)
+```bash
+# Bot chart (default: 3 months)
+dexbot dw <bot>
+# Pool or pair, custom window
+dexbot dw 133 --month 6
+dexbot dw TOKENA/TOKENB --month 1 --chart analysis/charts/custom.html
+# MPA price-feed history instead of market candles (opt-in)
+dexbot dw BTS/HONEST.USD --feed --month 1
+```
+Research knobs (`--alpha`, `--gain`, `--dw`, `--lb`, `--clip`) stay on the analyzer itself — call `node dist/analysis/analyze_dynamic_weight.js` directly for parameter sweeps (see `analysis/README.md`).
+
 ### LP Chart
 **File:** `generate_lp_chart.ts`
 **Purpose:** Generate the standard uPlot LP chart output.

package/scripts/git-viewer.sh

@@ -44,7 +44,7 @@ check_dependencies() {
         elif command -v dnf &> /dev/null; then
             sudo dnf install -y "${missing_packages[@]}"
         elif command -v pacman &> /dev/null; then
-            sudo pacman -S --noconfirm "${missing_packages[@]}"
+            sudo pacman -Syu --noconfirm "${missing_packages[@]}"
         else
             echo "Warning: Could not detect package manager. Please install manually: ${missing_packages[@]}"
             echo "  apt-get: sudo apt-get install ${missing_packages[*]}"

package/scripts/reset-settings.sh

@@ -108,7 +108,7 @@ if [ "$REMAINING" -eq 0 ]; then
     log_info ""
     log_info "Next steps:"
     log_info "- Re-run \`dexbot bot\` to recreate general settings if needed"
-    log_info "- Re-run \`npm run market-adapter:whitelist\` if your AMA bot set changed"
+    log_info "- Re-open \`dexbot bot\` → 6) Adapter if your AMA bot set changed"
     log_info "- Re-fit market profiles only if you want custom AMA presets again"
 else
     log_warning "Cleanup incomplete. Remaining settings files: $REMAINING"

package/tests/README.md

@@ -88,7 +88,7 @@ Interactive tools and performance benchmarks (not part of CI).
 
 ### Edge Cases & Regression
 Tests targeting specific bugs, race conditions, and failure modes.
-*Examples:* `test_critical_bug_fixes.ts`, `test_race_condition_fixes_batch1.ts`, `test_patch17_invariants.ts`, `test_shutdown_reentrancy.ts`, `test_multifill_opposite_partial.ts`
+*Examples:* `test_critical_bug_fixes.ts`, `test_race_condition_fixes_batch1.ts`, `test_patch17_invariants.ts`, `test_shutdown_reentrancy.ts`, `test_multifill_opposite_partial.ts`, `test_correction_queue_staleness.ts`, `test_spread_pure_fund_driven.ts`, `test_sync_lock_id_verification.ts`
 
 ### Utilities & Helpers
 Shared utility functions, precision handling, chain helpers.
@@ -120,6 +120,15 @@ Shared utility functions, precision handling, chain helpers.
 
 **Reference:** [docs/FUND_MOVEMENT_AND_ACCOUNTING.md](../docs/FUND_MOVEMENT_AND_ACCOUNTING.md)
 
+### Grid-Price Invariant & Hold Guards
+- Every emitted order's price must equal its slot's genesis level (`priceForSlot(idx, genesis)`); off-grid emissions are blocked, not counted
+- The guard itself plus the live batch wiring, escalation thresholds, and per-order stranded-hold clocks are each pinned and mutation-tested
+- Adoption keeps the slot's own level; `loadGrid` repairs a pre-existing off-grid slot price
+
+**Reference:** [docs/GRID_PRICE_INVARIANT.md](../docs/GRID_PRICE_INVARIANT.md)
+
+**Examples:** `test_grid_price_invariant_guard.ts`, `test_grid_price_invariant_wiring.ts`, `test_grid_price_slot_invariant.ts`, `test_final_pivot_gate.ts`, `test_hold_and_center_guards.ts`, `test_sync_out_of_grid_defer.ts`
+
 ---
 
 ## Documentation References

package/dist/scripts/generate_market_adapter_whitelist.d.ts

@@ -1,15 +0,0 @@
-declare function isAmaGridPrice(value: any): boolean;
-declare function parseOptions(argv: string[]): {
-    dynamicWeight: boolean;
-    asymmetricBounds: boolean;
-    prune: boolean;
-    botKeys: string[];
-};
-declare function loadExistingWhitelist(): any;
-declare function buildWhitelist(bots: any, existingWhitelist?: any, options?: ReturnType<typeof parseOptions>): {
-    whitelist: {
-        [k: string]: any;
-    };
-};
-export { isAmaGridPrice, parseOptions, loadExistingWhitelist, buildWhitelist };
-//# sourceMappingURL=generate_market_adapter_whitelist.d.ts.map

package/dist/scripts/generate_market_adapter_whitelist.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"generate_market_adapter_whitelist.d.ts","sourceRoot":"","sources":["../../scripts/generate_market_adapter_whitelist.ts"],"names":[],"mappings":"AAqBA,iBAAS,cAAc,CAAC,KAAK,EAAE,GAAG,WAGjC;AAED,iBAAS,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE;;;;;EAmDnC;AAED,iBAAS,qBAAqB,QAwB7B;AAED,iBAAS,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,iBAAiB,GAAE,GAAQ,EAAE,OAAO,GAAE,UAAU,CAAC,OAAO,YAAY,CAA8B;;;;EA6DpI;AAyBD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,qBAAqB,EAAE,cAAc,EAAE,CAAA"}