dexbot 1.6.4 → 1.6.6

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` → `2) Modify 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) | `dexbot bot` → `2) Modify bot` → `6) Adapter` → Weight |
+| Widen/tighten grid bounds by trend | [Grid Range Scaling](#grid-range-scaling) | `dexbot bot` → `2) Modify bot` → `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) | `dexbot bot` → `2) Modify bot` → `6) Adapter` flags |
 | Understand the signal pipeline or module layout | [Technical Reference](#technical-reference) | — |
 
 ## Big Picture
@@ -50,9 +50,10 @@ applies the symmetric penalty.
 
 ### 1. Enable AMA
 
-Set `gridPrice` to `ama`, `ama1`, `ama2`, `ama3`, or `ama4` in
-`profiles/bots.json` or through `dexbot bot`. Use `ama` for the pair's
-default preset.
+New bots default to `gridPrice: "ama3"`. Change it in `profiles/bots.json`
+or through `dexbot bot` to `ama`, `ama1`, `ama2`, `ama3`, or `ama4`. `ama1`
+reacts fastest, `ama4` is the slowest and steadiest (higher numbers smooth
+more), and `ama` uses the pair's default preset.
 
 `startPrice` selects the candle source:
 
@@ -64,47 +65,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 +133,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 +309,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 bot` 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 +340,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 +349,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` → `2) Modify 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
@@ -615,6 +587,9 @@ market_adapter/
 |-- inputs/
 |   |-- kibana_source.ts           Elasticsearch LP data source
 |   |-- fetch_lp_data.ts           historical LP candle exporter
+|   |-- fetch_book_data.ts         order-book candle exporter
+|   |-- kibana_feed_source.ts      MPA feed candle source
+|   |-- window_cache.ts            shared month-shard candle cache
 |   `-- fetch_cex_synthetic_data.ts  public CEX synthetic-candle seed importer
 |-- utils/
 |   |-- chain.ts                   blockchain query helpers
@@ -632,7 +607,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` → `2) Modify bot` → `6) Adapter`), which reads and
+writes this same file:
 
 ```json
 {
@@ -667,8 +644,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 +666,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 +690,7 @@ Both are configurable per bot or per market via
 {
   "globals": {
     "asymmetricBounds": {
-      "maxAsymmetryFactor": 0.35,
+      "maxAsymmetryFactor": 0.333,
       "minScaleSlots": 10
     }
   },
@@ -852,9 +832,9 @@ suppress writes via `unresolved_candle_gaps` until repaired on a future cycle.
 The adapter prunes old candles to the required AMA window and acts only on
 closed 1h candles.
 
-#### Shared Chunk Cache and Fetch Robustness
+#### Shared Month-Shard Cache and Fetch Robustness
 
-Pool, book, and feed candle fetches share one cache entry point (`runCachedWindows` in `market_adapter/inputs/window_cache.ts`): candles live in fixed calendar-month shards (`<base>.shard_YYYY-MM.json`, UTC) whose names never shift, so a run loads only the shards overlapping its requested range, queries only genuinely missing buckets plus a bounded 48h tail refresh, and rewrites only shards that gained buckets or query coverage — pure-reuse runs perform zero writes and zero deletes. Shard metas record the ranges actually queried (`meta.queriedRanges`, monotonically unioned). A missing range is pruned only when recorded query coverage genuinely covers it — the absence of local buckets alone never certifies history as empty. Partial windows merge into the run output but are never persisted. Legacy run-relative `*.chunk_*` files are still read: overlapping ones are absorbed into the shards (buckets + coverage) and retired once every bucket provably lives in a shard, while disjoint ones are never loaded and never deleted — narrow runs cannot wipe older history by construction. Every range fetch runs through `fetchRangeWithRetry` (per-range attempts + linear backoff + abort-signal timeout; the LP path keeps a 4-attempt budget), one-shot Kibana queries retry transient errors (3 attempts), paged fetchers cap at `kibanaMaxPages` (500), and bidirectional fetches tolerate a one-direction failure.
+Pool, book, and feed candle fetches share one cache entry point (`runCachedWindows` in `market_adapter/inputs/window_cache.ts`): candles live in fixed calendar-month shards (`<base>.shard_YYYY-MM.json`, UTC) whose names never shift, so a run loads only the shards overlapping its requested range, queries only genuinely missing buckets plus a bounded 48h tail refresh, and rewrites only shards that gained buckets or query coverage — pure-reuse runs perform zero writes and zero deletes. Shard metas record the ranges actually queried (`meta.queriedRanges`, monotonically unioned). A missing range is pruned only when recorded query coverage genuinely covers it — the absence of local buckets alone never certifies history as empty. Partial windows merge into the run output but are never persisted. Stable month shards are the only supported cache format; obsolete run-relative cache files are ignored. Every range fetch runs through `fetchRangeWithRetry` (per-range attempts + linear backoff + abort-signal timeout; the LP path keeps a 4-attempt budget), one-shot Kibana queries retry transient errors (3 attempts), paged fetchers cap at `kibanaMaxPages` (500), and bidirectional fetches tolerate a one-direction failure.
 
 #### AMA Warmup Window — Why Candle Length Matters
 

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
@@ -162,7 +163,7 @@ External consumers — other parts of DEXBot2 interact with modules through thes
 - **Fund-driven sizing, fill-driven boundary** — available funds set order sizing and budget allocation, not the boundary position; no forced allocations. The boundary moves only through boundary crawl on fills or spread promotion onto orders placed in the same atomic batch.
 - **Replay-safe accounting** — fill processing in `dexbot_fill_runtime.ts` uses `processed_fill_store.ts` to prevent double-counting. If the bot restarts mid-fill, it can safely replay without creating duplicate orders.
 - **Daemon-backed signing** — the credential daemon holds decrypted keys; modules never handle raw private keys. If the main bot crashes, keys stay encrypted on disk — only the small daemon process sees them.
-- **Fixed-cap batch processing** — fill batches are capped (default 4) to keep blockchain broadcasts predictable. Even if 20 fills arrive at once, they're processed in small chunks to avoid overwhelming the chain.
+- **Gap-slot batch processing** — each fill batch and broadcast is capped at the current grid's gap-slot count + 1. A queue at or below that depth is processed as one unified batch; deeper queues are chunked at the same deterministic cap.
 
 ## Related
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dexbot",
-  "version": "1.6.4",
+  "version": "1.6.6",
   "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": {
@@ -14,6 +14,7 @@
   },
   "files": [
     "dist",
+    "!dist/analysis/legacy",
     "ecosystem.config.cjs",
     "scripts/bots",
     "scripts/clean-dist.js",
@@ -40,8 +41,10 @@
     "docs/CREDENTIAL_SECURITY.md",
     "docs/GRID_RECALCULATION.md",
     "docs/GRID_RECONCILE.md",
+    "docs/GRID_PRICE_INVARIANT.md",
     "docs/LOGGING.md",
     "docs/MPA_CREDIT_USAGE.md",
+    "docs/ORDER_ENGINE_POST_1.0_RETROSPECTIVE.md",
     "docs/COPY_ON_WRITE_MASTER_PLAN.md",
     "docs/COW_INVARIANTS.md",
     "docs/FUND_MOVEMENT_AND_ACCOUNTING.md",
@@ -56,6 +59,7 @@
     "modules/README.md",
     "analysis",
     "!analysis/charts",
+    "!analysis/legacy",
     "tests/README.md",
     "CHANGELOG.md",
     "README.md",
@@ -83,11 +87,9 @@
     "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",
-    "analysis:derivatives": "npm run build && node dist/analysis/analyze_derivatives.js",
     "analysis:trade-pnl": "npm run build && node dist/analysis/trade_profitability.js",
     "analysis:grid-check": "npm run build && node dist/analysis/grid_correction_check.js",
     "analysis:resolve-accounts": "npm run build && node dist/analysis/resolve_bot_accounts.js",
@@ -96,6 +98,7 @@
     "native:ecc-invariants": "npm run build && npm run build:tests && node dist/tests/test_native_ecc.js",
     "native:corpus": "npm run build && node dist/scripts/generate_mainnet_corpus_report.js",
     "test:credit-renewal": "npm run build && node dist/scripts/test-credit-renewal.js",
+    "test:legacy": "npm run build && npm run build:tests && node dist/analysis/legacy/tests/test_derivative_chart.js && node dist/analysis/legacy/tests/test_derivative_entry_bias.js && node dist/analysis/legacy/tests/test_derivative_momentum_gate.js && node dist/analysis/legacy/tests/test_derivative_signal_trap_regression.js",
     "version:sync": "npm run build && node dist/scripts/sync-version.js",
     "version:check": "npm run build && node dist/scripts/sync-version.js --check",
     "verify:browser-bundle": "npm run build && node dist/scripts/verify-browser-bundle.js",
@@ -104,7 +107,7 @@
     "clean": "node scripts/clean-dist.js",
     "build": "tsc && chmod +x dist/dexbot.js dist/bot.js dist/unlock.js dist/pm2.js dist/credential-daemon.js",
     "build:clean": "npm run clean && npm run build",
-    "build:tests": "tsc -p tsconfig.tests.json && cp tests/package.json dist/tests/package.json && cp tests/helpers/esm_mock_hooks.mjs tests/helpers/esm_mock_loader.mjs dist/tests/helpers/",
+    "build:tests": "tsc -p tsconfig.tests.json && cp tests/package.json dist/tests/package.json && cp tests/helpers/esm_mock_hooks.mjs tests/helpers/esm_mock_loader.mjs dist/tests/helpers/ && mkdir -p dist/analysis/legacy/tests && cp analysis/legacy/tests/package.json dist/analysis/legacy/tests/package.json",
     "typecheck": "tsc --noEmit",
     "typecheck:tests": "tsc -p tsconfig.tests.json --noEmit",
     "build:watch": "tsc --watch",

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,9 +340,7 @@ 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 |
 | `npm run analysis:trade-pnl` | Trade PnL analysis from fill data |
 | `npm run ama:chart:lp-local` | Generate local LP comparison chart |
@@ -385,8 +360,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 +376,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.
@@ -417,14 +409,6 @@ npm run lp:chart -- --data <lp-export.json>
 npm run ama:chart:lp-local -- --data <lp-export.json>
 ```
 
-### Derivative Trend Analysis
-**File:** `analysis/analyze_derivatives.ts`
-**Purpose:** Generate the derivative analysis report.
-```bash
-# Generate the derivative analysis report
-npm run analysis:derivatives -- --source json --file <file.json>
-```
-
 ---
 
 ## 📚 DOCUMENTATION REFERENCES

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\` → 2) Modify 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/analysis/ama_fitting/package.json

@@ -1,12 +0,0 @@
-{
-  "name": "ama_fitting",
-  "version": "1.6.4",
-  "description": "Tools for fitting AMA parameters to market data",
-  "main": "../../dist/analysis/ama_fitting/optimizer_high_resolution.js",
-  "scripts": {
-    "optimize": "npm --prefix ../.. run build && node ../../dist/analysis/ama_fitting/optimizer_high_resolution.js",
-    "chart:lp-local": "npm --prefix ../.. run build && node ../../dist/analysis/ama_fitting/generate_unified_comparison_chart.js"
-  },
-  "dependencies": {},
-  "type": "module"
-}