@battlegrid/mcp-server 32.0.39 → 32.0.41

package/README.md

@@ -38,6 +38,45 @@ Seeing package `31.x` alongside handshake `battlegrid@33.x` — the package **be
 
 **What this changes for you:** nothing about how you call anything. Upgrading the package no longer waits on a server deploy, and a server deploy no longer strands you on a package that names the wrong contract — reconnect and the announcement follows. **Contract breaking-change notes are no longer keyed to package versions**, since a contract move is no longer a release here; the v11-and-earlier notes below are kept as history, and the live vocabulary is always discovery.
 
+## Contract history — v137.2 (the anchored VWAP family with σ bands, and week and month profiles)
+
+**Additive at v137.2: sixty-six metrics and five studies, one value withdrawn, and the metric vocabulary named once per
+schema.** v137.2 is the contract on top of v137.1. Nothing a client sends is refused that v137.1 accepted. Reconnect the
+proxy, or restart it, so discovery reads the widened vocabulary.
+
+### Widened input — new metrics and studies
+
+- **The anchored VWAP family**, each computed over the column's own timeframe as TradingView's `ta.vwap(hlc3)` computes it
+  on that chart: `VWAP_WEEK` (`vwapW`, from Monday 00:00 UTC), `VWAP_MONTH` (`vwapM`), `VWAP_TRADING_SESSION` (`vwapTs`),
+  `VWAP_ROLLING_1H`, `VWAP_ROLLING_4H` and `VWAP_ROLLING_24H` (`rvwap1h`, `rvwap4h`, `rvwap24h`), and `VWAP_SWING_HIGH`
+  and `VWAP_SWING_LOW` (`avwapSwHi`, `avwapSwLo`, anchored at the latest decided swing pivot).
+- **±1/2/3σ bands** `<LINE>_UB1..3` and `<LINE>_LB1..3` on `VWAP` and on each of the six new calendar and rolling lines
+  (42 metrics): `line ± k·σ`, with σ the volume-weighted standard deviation over the same bars. Each takes every transform
+  a price level takes, `levelInteraction` included.
+- **Week and month profiles**, summed from each period's UTC-day profiles on one grid: `WEEK_TPO_POC`/`VAH`/`VAL` and
+  `MONTH_TPO_POC`/`VAH`/`VAL` (the current period), `PRIOR_WEEK_TPO_*` and `PRIOR_MONTH_TPO_*`, and the previous
+  completed period's high and low, `PWH`/`PWL` and `PMH`/`PML`. A prior level read across its period's roll is absent.
+- **The studies** `vwap`, `weekProfile`, `priorWeek`, `monthProfile` and `priorMonth` join the vocabulary. The metric-key
+  enum widens on every input and output that carries it.
+- **Ranking.** The eight new VWAP lines rank exchange-wide by distance; the bands do not.
+
+### Changed values — the same schema serves a different number
+
+- **`VWAP` on `1d` reads null.** A UTC-day VWAP on a bar as long as the UTC day is only that bar's own typical price. On
+  every other timeframe `VWAP` is unchanged. Each anchored line is likewise absent on a timeframe whose bar is as long as
+  its anchor's period.
+
+### Schema respelling
+
+- **The metric vocabulary is one named shape, `metricKey`**, published once in each schema's root `$defs` and referenced
+  as `#/$defs/metricKey` wherever a metric is named, where it was inlined at each site. What a schema accepts does not
+  move; every authoring schema shrinks. `toolCount` stays 149.
+
+### Digest move
+
+- **`vocabularyDigest` and the authoring catalog digest move** with the sixty-six metrics and five studies. A client
+  caching vocabulary against either re-reads `list_strategy_vocabulary`.
+
 ## Contract history — v137.1 (a condition exit's evidence and slippage)
 
 **Additive at v137.1: one owner output field, and one served value moves.** v137.1 is the contract on top of v137.
@@ -60,6 +99,43 @@ output.
 - **`slippageExit` on a `CONDITION_EXIT` close** is the exit average fill less the close of the bar the exit rule fired
   on, where it was null. Every other close kind is unchanged. `toolCount` stays 149.
 
+## Contract history — v137 (TradingView's indicator math, Stoch RSI %K/%D, and a spread in points)
+
+**MAJOR at v137: one metric key is retired into two, a unit joins every unit enum, and served indicator values move to
+TradingView's calculation.** v137 is the contract on top of v136.1. Reconnect the proxy, or restart it, so discovery
+reads the new vocabulary.
+
+### Refused input — `STOCH_RSI14` is retired
+
+- **`STOCH_RSI14` (`stochRSI14`, one 0–1 position) is replaced by `STOCH_RSI_K` and `STOCH_RSI_D`** (`stochRsiK`,
+  `stochRsiD`, study `stochRsi`): TradingView's Stoch RSI %K and %D (14, 14, 3, 3) on 0–100, with Stochastic %K's zone
+  vocabulary and rank ordering. A request naming `STOCH_RSI14` is refused. No stored strategy named it.
+
+### Widened output enum — the `points` unit
+
+- **Every unit enum gains `points`**: a difference of two 0–100 or percent readings, rendered ` pts` with its natural
+  sign. A client validating responses against a cached schema refuses a `points` column until it re-reads discovery.
+
+### Changed values — the same schema serves a different number
+
+- **DI+ and DI− read 0–100**, where they read a 0–1 ratio, so the regime's DI vote can clear its 5-point gate:
+  `REGIME_TREND_SOURCE` can read `di spread`. ADX follows TradingView's `ta.dmi` on ties and its seed.
+- **The Ichimoku spans and lagging close sit one bar earlier**: TradingView's displacement 26, plotted 25 bars ahead.
+- **Parabolic SAR follows TradingView's `ta.sar` on a flip.** %R, CCI, Stochastic and Stoch RSI read null over a flat
+  window, where they read a bound; Stochastic %D counts a %K of 0.
+- **A `spread` over a comparable unit is a difference.** An oscillator, a percent, a ratio, a share, a count or a USD
+  notional reads `base − operand` in its difference unit (`points` for an oscillator or a percent), where it read the
+  signed % gap; a zero operand reads a value where it read null. A price-like base keeps the % gap. Sign rules (`gt 0`,
+  a cross of 0) keep their meaning.
+- **`REGIME_DI_SPREAD` reads in `points` at 2 dp** and equals the `DIplus14_DIminus14_spread` column. It is no longer
+  offered a spread operand. The ranked `BUY_PRES_CB × spread(BUY_PRES_BN)` set ranks the difference its column reads.
+  `toolCount` stays 149.
+
+### Digest move
+
+- **`vocabularyDigest` and the authoring catalog digest move.** A client caching vocabulary against either re-reads
+  `list_strategy_vocabulary`.
+
 ## Contract history — v136.1 (spot facts per bar: each venue's close and buy share, the composite's flow, and Bybit)
 
 **Additive at v136.1: six metrics and a study, and served values move.** v136.1 is the contract on top of v136.

package/dist/index.d.ts

@@ -47,7 +47,7 @@ import { Client, StreamableHTTPClientTransport } from '@modelcontextprotocol/cli
  * being asked. Move it for a change to THIS package — a proxy fix, a dependency bump, a docs
  * correction. Never move it to track the server.
  */
-export declare const PACKAGE_VERSION = "32.0.39";
+export declare const PACKAGE_VERSION = "32.0.41";
 export declare const DEFAULT_URL = "https://mcp.battlegrid.trade/mcp";
 export interface EnvConfig {
     apiKeys: string[];

package/dist/index.js

@@ -49,7 +49,7 @@ import { Client, SdkHttpError, StreamableHTTPClientTransport } from '@modelconte
  * being asked. Move it for a change to THIS package — a proxy fix, a dependency bump, a docs
  * correction. Never move it to track the server.
  */
-export const PACKAGE_VERSION = '32.0.39';
+export const PACKAGE_VERSION = '32.0.41';
 export const DEFAULT_URL = 'https://mcp.battlegrid.trade/mcp';
 const MAX_RETRIES = 3;
 const RETRY_DELAYS_MS = [2000, 4000, 8000];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@battlegrid/mcp-server",
-  "version": "32.0.39",
+  "version": "32.0.41",
   "description": "BattleGrid MCP server — play crypto prediction games from AI agents",
   "type": "module",
   "main": "dist/index.js",

package/skills/EXPORT.json

@@ -1,6 +1,6 @@
 {
   "generator": "battlegrid-app/server/scripts/export-mcp-skills.mjs",
-  "contractVersion": "136.1.0",
+  "contractVersion": "137.2.0",
   "files": {
     "battlegrid-agent-management/SKILL.md": "91d1be4de1e33d54e1852c970af66ad176068fd16c30b4326e49053b7a35eb32",
     "battlegrid-agent-management/references/agent-stage-examples.md": "dffcc353d61dfc7b5bb6a2b3077fc6bf8c760a34c287cafb3b59b99306f24195",
@@ -18,7 +18,7 @@
     "battlegrid-strategy-examples/SKILL.md": "cbbc7a7271aaa9f530a11d91511f4bf35a9632aa3ab67ecd996975c65ae72625",
     "battlegrid-strategy-examples/references/playbooks.md": "59996c37eea08e7ce398e49304171939e55c968400a1603597d6737faf9e1771",
     "battlegrid-strategy-examples/references/recipes.md": "e1fbd1a3d1b2ef1408fef8642032c3e131954aedec6bdcefa3af6a655948e392",
-    "battlegrid-strategy-examples/references/tradingview-ports.md": "00f2ba287ff8fadf356273f61ad19630cceb3a706018c2088be40570ff1a899d",
+    "battlegrid-strategy-examples/references/tradingview-ports.md": "bc63e26b16458fd17b7bc567541fc9889ee857b444ccb2d3f011545635758d8f",
     "battlegrid-trade-analysis/SKILL.md": "140d847f24e98845736d4f0c2e72b318a4d235413f72f072d2fe6d0daa5f64db",
     "battlegrid-trade-proposal/SKILL.md": "bf8f3794478cdecc989020bd775c3c91744f72b440b1a90f88f6700c9a61ca24"
   }

package/skills/battlegrid-strategy-examples/references/tradingview-ports.md

@@ -61,7 +61,9 @@ rules about the columns themselves, not about porting — they live in the skill
   column, never as the substitute for the gate.
 - **VWAP reversion** → `dist_VWAP` band + `dist_VWAP_rank_far lte 5` for board-relative
   stretch; required `NOT [ADX14_state in ["trending","extreme"]]` veto; scalp geometry +
-  aggressive timeDecay (VWAP anchors daily at 00:00 UTC).
+  aggressive timeDecay (`VWAP` anchors daily at 00:00 UTC; `VWAP_WEEK`, `VWAP_MONTH`, `VWAP_TRADING_SESSION` and
+  the rolling `VWAP_ROLLING_1H`/`4H`/`24H` are the other anchors, each with ±1/2/3σ bands `_UB<k>`/`_LB<k>` — a
+  band-touch entry reads `CLOSE × spread(VWAP_LB2)` rather than a hand-computed σ).
 - **Donchian / Turtle breakout** (`close > ta.highest(high, 20)[1]`) → `dist_donchianHiPrior20 crossesAbove 0`
   over `DONCHIAN_UPPER_PRIOR × distance` (the breakout bar; `dist_donchianHiPrior20 gt 0` holds on every
   close of the run) + `RVOL20 gte 1.5`; turtle exits = trend preset (trail from 1R, giveback 50). Mirror with
@@ -117,8 +119,8 @@ rules about the columns themselves, not about porting — they live in the skill
   `MACD_LINE × crossDetect`, and the signal-line cross is `MACD_HIST × crossDetect`, the histogram being
   line minus signal), the 15-bar rate of change (`ROC15`), the Donchian break memory
   (`DONCHIAN_BROKEN_HI`/`DONCHIAN_BROKEN_LO`), daily pivots
-  (`PIVOT_P`/`PIVOT_R1`–`R3`/`PIVOT_S1`–`S3`), Williams %R (`WILLR14`), Stochastic RSI
-  (`STOCH_RSI14`), the TTM squeeze (`KC_SQUEEZE`), Connors RSI-2 (`RSI2`), the 8/9/21/50 EMAs
+  (`PIVOT_P`/`PIVOT_R1`–`R3`/`PIVOT_S1`–`S3`), Williams %R (`WILLR14`), Stoch RSI
+  (`STOCH_RSI_K`/`STOCH_RSI_D` — TradingView's "Stoch RSI" %K and %D at 3, 3, 14, 14, on 0–100), the TTM squeeze (`KC_SQUEEZE`), Connors RSI-2 (`RSI2`), the 8/9/21/50 EMAs
   (`EMA8`/`EMA9`/`EMA21`/`EMA50` — `ta.ema(close, 8)` is `EMA8`, its distance `dist_EMA8`), literal
   previous-UTC-day levels (`PDH`/`PDL`/`PDO`), fractal swing structure
   (`SWING_FRACTAL_HIGH`/`SWING_FRACTAL_LOW`/`SWING_FRACTAL_LABEL`, the prior pivots