@battlegrid/mcp-server 31.1.0 → 31.2.0

package/README.md

@@ -24,6 +24,195 @@ 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 — v37 → v48.1
+
+Eleven majors reached authors while this section stopped at v36. That gap is the mechanism, not an
+oversight: since v31 a contract move needs no release here, so nothing forced a note to be written —
+and the documentation ships inside the tarball, so a note written but unpublished reaches nobody.
+Both halves are now closed by a rule keyed to the *served* contract rather than to a release of this
+package.
+
+### Changed meaning, unchanged shape
+
+- **Three tools serve different values for identical input** (47.3.0, `derive-scan-fetch-from-report`).
+  The radar scan leg now derives its timeframe fetch from the strategy's **report** rather than the
+  on-duty agent's three perception rungs, so a required condition addressing an absolute timeframe
+  outside those rungs — never evaluated at scan before — now is. No field moves; the values do:
+
+  | Tool | What moves |
+  |---|---|
+  | `preview_radar_resolution` | `conditionReach[].reachReason` goes `AGENT_TIMEFRAME` → `null` |
+  | `get_radar_activity` | `scanReachReason` moves the same way, **on new rows only** — rows already written keep what they were recorded with |
+  | `get_agent_coin_qualification` | `reachReason` moves the same way; its sibling `verdict` moves `UNMEASURABLE` → a decided verdict |
+
+  **Read the last one carefully:** a client treating `UNMEASURABLE` as "this gate is switched off"
+  will now see that gate **BLOCK**. `AGENT_TIMEFRAME` keeps its member and narrows to the one cause
+  no fetch can discharge. Nothing in the payload tells you this moved.
+
+### Rejected input — something you author is no longer accepted
+
+- **A benchmark-bound section no longer accepts crowd metrics or rank transforms** (49.0.0,
+  `fix-benchmark-legality-save-path`). On a custom section carrying a non-null `benchmarkTicker`, a
+  column whose metric is enrichment-stage (the `CROWD_*` family, `FLOW_ALIGN`, `SMART_RETAIL`,
+  `CAPTAIN_CONF`, `CONFIDENCE`, `SETTLED_AT`, the `PERP_SPOT_*` trio) is refused with
+  `REPORT_COLUMN_BENCHMARK_METRIC_UNSUPPORTED`, and one carrying a `rank` transform in either the
+  direct or the chained position with `REPORT_COLUMN_BENCHMARK_TRANSFORM_UNSUPPORTED`. Every tool
+  accepting a section array is affected, and no other byte of your body changes.
+
+  **Fix it by moving the column, not by retrying.** Both readings are defined *relative to the
+  cohort being evaluated* — a crowd reading is what this session's players did, a rank is a position
+  among the coins under evaluation — and a benchmark is deliberately outside that cohort. Neither
+  has a value there, which is why such a column could never render. Put it on an ordinary section
+  (`benchmarkTicker: null`), or drop it.
+
+  **This is a fix, not a new rule.** The restriction shipped with benchmark sections and was already
+  enforced by the column builder, by report materialization, and by `get_strategy_column_contract` —
+  so an author who checked a column against discovery first has been seeing this refusal all along.
+  What changed is that the SAVE path now asks the same question. Previously it did not, so such a
+  section persisted and then failed at every evaluation instead of at authoring.
+
+- **A custom report section no longer accepts `timeframe`** (48.0.0,
+  `remove-section-anchor-override`). The per-section anchor override is gone. Every tool accepting a
+  section array — `compile_strategy_plan`, `preview_strategy_report`, `derive_strategy_rule_view`,
+  and `apply_strategy_plan` — refuses a section carrying it: `sections[N]: Unrecognized key(s)`,
+  with no other byte of your body changing. Drop the key. A section's columns resolve against the
+  **strategy** timeframe, and a column reaches any other timeframe by pinning it on the column
+  (`timeframe: { abs: '4h' }`) — which it could always do. Relative column references
+  (`anchor`/`lower`/`regime`) are untouched, and are the point: they track the strategy.
+
+- **A custom report section requires `notes`** (43.0.0, `add-authored-section-notes`). Every tool
+  accepting a section array — `compile_strategy_plan`, `preview_strategy_report`,
+  `derive_strategy_rule_view` — refuses a section without it: `sections[N].notes: Required`, with no
+  byte of your body changing. Send explicit `null` for "no note". It is required rather than optional
+  because these payloads are a FULL REPLACE: an omitted key and an explicit `null` would be the same
+  request on the wire, so every rebuild site would silently clear a note its author wrote.
+  `benchmarkTicker` carries the same required-nullable discipline for the same reason.
+
+- **Every condition requires `clock` and `closes`** (44.0.0, `add-condition-clock`), and **`exit`**
+  arrives with them. A condition entry now carries eight keys, not five. `clock` is `"LIVE"` (the
+  previous behaviour — the forming bar) or `"CLOSE"` (settled bars); `closes` is how many consecutive
+  closed bars must read true, 1–5, and is always `1` under LIVE. No wire default, for the same
+  whole-set-replacement reason as `notes`: a defaulted key would let an unrelated re-save silently
+  un-clock an enforced money gate back to forming-bar evidence.
+
+  A `CLOSE` clock is accepted only where a closed frame can change the reading — the clause must
+  resolve from the coin's own candle series at offset 0. Frame-inert operands (perp-payload scalars,
+  published rolling changes, ranks, zone entities, regime labels, enrichment metrics, session
+  scalars) are refused with `CONDITION_CLOCK_OPERAND_ILLEGAL` naming the header and the remedy: split
+  that clause into its own LIVE condition and `conditionRef` it. `exit: true` is legal only under
+  `clock: "CLOSE"` — an exit fired on a forming bar is an intrabar exit.
+
+- **A strategy requires a seven-key `entry` object** (44.0.0 for four keys, 47.0.0 for three more —
+  `add-entry-on-close`, `add-level-trigger-execution`). Required on every CREATE, on
+  `compile_strategy_plan`, `apply_strategy_plan` and `update_intelligence_agent`. A client sending
+  44.0.0's four-key object is refused under 47 with `entry.levelSource: Required` without one byte of
+  it changing.
+
+  ```jsonc
+  "entry": {
+    "trigger": "AT_SIGNAL",          // | ON_CANDLE_CLOSE | STOP_THROUGH_LEVEL | ON_RETEST
+    "confirmTf": "4h",               // the strategy timeframe or the rung below it — nothing else
+    "closes": 1,                     // 1–5; must be 1 unless ON_CANDLE_CLOSE
+    "bandAtrMultiple": 1.0,          // > 0, and <= the platform's entry-deviation gate
+    "levelSource": "SWING_HIGH",     // | SWING_LOW | BOLLINGER_UPPER | BOLLINGER_LOWER
+    "levelOffsetAtrMultiple": 0,     // 0–2, UNSIGNED; must be 0 unless a level trigger
+    "validForBars": 4                // 1–24 of the strategy's own bars
+  }
+  ```
+
+  `AT_SIGNAL` with those values is byte-identical to pre-44 behaviour. The legality matrix runs one
+  way: all seven keys are always present, so a MEANINGFUL value under a trigger that ignores it is
+  refused rather than accepted-and-dropped — a dial never silently does nothing.
+
+- **A `strategyTimeframe` the platform does not ingest is refused** (39.0.0,
+  `move-renderer-to-rendered-section`) on `get_coin_market_context`, where it was previously
+  accepted. The number is the only signal a client gets.
+
+- **`eventType` gains `ENTRY_EXPIRED_UNCONFIRMED`** (48.1.0, `fix-entry-arming-lifecycle`) on
+  `get_radar_activity` and `get_radar_activity_summary` — an armed entry that reached its episode
+  lifetime without ever receiving a confirming close. A client holding its own closed copy of that
+  enum rejects the new member; one that switches exhaustively on it needs the branch.
+
+  `entryVoidCause` is deliberately **unchanged** and still carries exactly `BAND`, `CONDITIONS`,
+  `STRUCTURAL`. Each of those is a measurement taken *at* a close, so an episode that reached no
+  close gets its own event type rather than a fourth cause — `ENTRY_VOIDED` means "called off at the
+  close", a claim this outcome must not make.
+
+  The authoring boundary also gains a refusal with **no schema change**: a strategy declaring an
+  arming trigger whose `required` conditions read the `LIVE` clock is rejected on the existing
+  `VALIDATION_ERROR` code, naming the offending condition key. Same code, same shape, new reason —
+  so nothing in the published schema tells you it can now happen.
+
+### Removed — no alias exists
+
+- **`get_coin_market_context` is REMOVED** (40.0.0, `retire-get-coin-market-context`). Calling it
+  returns an unknown-tool error. There is deliberately **no alias**: a silent redirect would hide a
+  payload shape change from a client that never asked for one. Use `get_market_context`.
+
+- **`get_macd_heatmap` leaves the published surface** (41.0.0). Same shape of break, same absence of
+  an alias.
+
+- **`isPrimary` is removed from every published `EvaluatedSignal`** (38.0.0) — `get_signal_log`,
+  `get_public_agent_signal_log_detail`, and every other tool returning a signal scorecard. Reading it
+  now finds the key absent rather than false.
+
+### Reshaped output — the same call returns a different shape
+
+- **The normalized report section loses `timeframe`** (48.0.0, `remove-section-anchor-override`), on
+  every tool that publishes a strategy: `get_strategy`, `fork_strategy`, `archive_strategy`,
+  `restore_strategy`, `update_strategy_signal_rule`, `apply_strategy_plan`, and
+  `compile_strategy_plan`'s post-state. A strict parser rejects the shorter object; a lenient one
+  reads a section whose anchor is the strategy timeframe, which it now always is.
+
+- **`get_strategy_column_contract` renames its anchor, both ways** (48.0.0). The request field
+  `sectionTimeframe` becomes `anchorTimeframe` — same meaning, and still optional. On the response,
+  `timeframe.requiresSectionTimeframe` becomes `requiresAnchorTimeframe`, and
+  `timeframe.sectionTimeframeOverrideAllowed` is **removed**: it published whether a column could go
+  in an anchor-overridden section, and no section can be overridden. One call also stops being
+  refused — a timeframe-inert metric supplied with an anchor now compiles.
+  `REPORT_COLUMN_SECTION_TIMEFRAME_UNSUPPORTED` leaves the `authoringCode` vocabulary.
+
+- **`RenderedSection.notes` stops carrying provenance** (42.0.0, `separate-section-facts-from-read`),
+  on `preview_strategy_report`, `compile_strategy_plan` and `get_market_context`. A new REQUIRED
+  `provenance: string[]` carries it instead. A client reading provenance out of `notes` now reads an
+  author's prose, or nothing — which is a silent misread, not an error.
+
+- **`preview_strategy_report.renderedSections[]` gains `authoredNote`** (43.0.0), the author's read
+  for a custom row and `null` on a platform row. Additive, but published on a `.strict()` shape.
+
+- **`get_radar_activity` serves its evaluation curve on the FIRST PAGE ONLY** (37.0.0), and
+  `get_radar_activity_summary` is added. A client reading the curve off a later page finds it absent.
+
+### Widened enum — new members your own copy rejects
+
+- **The authorable metric vocabulary widens by 29 keys** (46.1.0, `add-indicator-catalog-coverage`):
+  Keltner (`KC_UPPER`/`KC_MID`/`KC_LOWER`), Supertrend (`ST_LINE`/`ST_DIR`), Hull (`HMA20`),
+  WaveTrend (`WT1`/`WT2`), QQE (`QQE_RSI_MA`/`QQE_STOP`), Parabolic SAR (`PSAR`), Ichimoku
+  (`ICHI_CONV`/`ICHI_BASE`/`ICHI_SPAN_A`/`ICHI_SPAN_B`/`ICHI_LAG`), Williams %R (`WILLR14`),
+  Stochastic RSI (`STOCH_RSI14`), session pivots (`PIVOT_P`/`PIVOT_R1`–`R3`/`PIVOT_S1`–`S3`), plus
+  four already-published fields that became addressable: `BB_UPPER`, `BB_LOWER`, `DI_PLUS`,
+  `DI_MINUS`.
+
+  Additive on the wire — every request you can send today is still accepted. It is called out here
+  because a client holding its own closed copy of the metric enum rejects the new members, and
+  because **an agent holding a cached belief that these are inexpressible will substitute for a
+  primitive the platform now serves**. That failure raises no error at all: the author is simply told
+  a strategy cannot be built.
+
+- **`EntryTrigger` gains `STOP_THROUGH_LEVEL` and `ON_RETEST`, and `EntryLevelSource` is published
+  for the first time** with four members (47.0.0). Additive on their own; the required keys above are
+  what make that bump a major.
+
+- **Each signal-checklist item's `measured` object gains a required `triggered` boolean** (47.2.0,
+  `fix-entry-prompt-signal-evidence`) on `get_signal_log` and `get_public_agent_signal_log_detail`,
+  on the `numeric` and `categorical` arms. Additive and MINOR — a client ignoring it is unaffected —
+  but it is named here because a client parsing that output strictly rejects the new key, and because
+  leaving 47.2 unlisted would make a reader wonder what happened to it.
+
+  The `unavailable` arm deliberately does **not** carry `triggered`: "the claim could not be joined to
+  a stored result" and "the signal did not fire" are different states, and leaving the key off that
+  arm makes conflating them a type error rather than a convention.
+
 ## Contract history — v12 → v36
 
 > **The number in this heading is a CONTRACT version, not this package's version.** The npm badge at the top
@@ -176,6 +365,38 @@ Nothing in the proxy changes. No configuration, no environment variable, no call
 
 ### Additive in the same span
 
+- **`get_regime_snapshot` publishes the evidence behind the verdict** (47.1.0,
+  `publish-regime-classification-evidence`). The snapshot gains `evidence`: the quantities the
+  classifier read, the gates it tested them against, the signed margin to the gate deciding whether
+  the current label survives, and the two decision facts only the classifier holds — `gateState`
+  (`cleared` / `held` / `dropped`) and `directionSource` (`di` / `ema`). Nothing narrows; a client
+  that ignores the field is unaffected.
+
+  Read `gateState` before you trust a trend label: **`held` means the ADX hysteresis buffer is
+  carrying the PREVIOUS bar's label rather than this bar re-confirming it** — a materially weaker
+  claim wearing the same word, and one no client could previously detect. `directionSource: 'ema'`
+  is the same shape of warning: the direction came from the fallback that fires precisely when the
+  DI spread is indecisive. The margin is signed so **positive always means "the current label
+  survives by this much"**, in every gate state, so it is safe to branch on its sign.
+
+  `conviction` is a BRANCH DISCRIMINATOR, not a confidence: it encodes *which* rule in the priority
+  ladder matched, not how comfortably it matched. The margins carry comfort. A client reading
+  conviction as a strength score is reading it wrong, and always was — this release just makes the
+  alternative available.
+
+- **Thirteen metric keys join the catalog** (47.1.0) — the `regime` family gains `REGIME_STATE`,
+  `REGIME_CONVICTION`, `REGIME_RUN_BARS`, `REGIME_TREND_GATE`, `REGIME_TREND_MARGIN`,
+  `REGIME_TREND_SOURCE`, `REGIME_DI_SPREAD`, `REGIME_VOL_ATR_RATIO`, `REGIME_VOL_BBW_RATIO`,
+  `REGIME_MOM_BULL_VOTES`, `REGIME_MOM_BEAR_VOTES`, `REGIME_CRASH_MARGIN` and `REGIME_CRASH_LATCH`,
+  making the composite regime and its evidence addressable in a report column or condition for the
+  first time. Only a client that switches exhaustively on `MetricKey` needs new branches.
+
+  Not a contract change, but worth knowing if you author conditions: the report grammar's regime
+  metrics now resolve from the **confirmed close** on every path. They previously resolved from the
+  forming bar when a report was rendered and the confirmed close when the scan swept, so the same
+  condition could read differently in preview than in production. Same wire shape; same bar
+  everywhere now.
+
 `27.1.0` exit-policy authoring input on `compile_strategy_plan` · `19.2.0` `get_account_state` account identity · `19.1.0` Standing Orders marker authoring · `18.4.0` `list_gate_blocks` summary groups · `18.3.0` radar maintenance pause · `18.1.0` protection geometry · `17.2.0` break-even/trailing status · `17.1.0` `get_signal_log` condition evaluation · `13.1.0` four owner-scoped read tools · `12.1.0` cross-venue spot price metrics · `11.1.0` discoverable rate limit.
 
 ## v11 and earlier — contract history (v6 → v11)
@@ -484,7 +705,7 @@ Tools, prompts, and resources are **discovered live** from the connected server
 
 - **The announced contract is relayed, not declared.** The proxy reads the upstream server's identity from the handshake it just completed and re-announces it verbatim to the local client. A local client therefore always reads the contract it will actually reach, and the package version is free to mean only what it should: this proxy's own code. **There is no pairing rule to keep, and no publish-time deploy gate** — a released package makes no claim about the server, so there is no ordering between a release here and a deploy there. This replaces the `MAJOR.MINOR` pairing that held through v11; see [v12](#v12--the-announced-contract-is-read-from-the-server-not-declared-here).
 - **Fails closed, never falls back.** If a connected server announced no `serverInfo` — a protocol violation, since it is required in a successful `initialize` result — the proxy refuses to start rather than substituting its own version. There is no honest number to announce in that case, and announcing a dishonest one silently is the failure this design removes.
-- **Rediscover after a server cutover.** Package publication does not refresh a running proxy's cached startup snapshot. Restart/reconnect the proxy and re-run `tools/list`, `prompts/list`, and `resources/list` after the server deploys.
+- **Rediscover after a server cutover.** The proxy resolves its catalog on first use and then caches it for the life of the process; a resolution that *failed* is retried on the next request, but a server deploy is never noticed. Package publication does not refresh it either. Restart/reconnect the proxy and re-run `tools/list`, `prompts/list`, and `resources/list` after the server deploys.
 - **Restart after key rotation.** API keys are read once at process startup; rotate a key, then restart the proxy.
 
 | Version | Changes |
@@ -577,7 +798,7 @@ Also confirm npm's Trusted Publisher for `@battlegrid/mcp-server` is GitHub Acti
 
 Two things do still need doing, neither of them a release:
 
-- **Reconnect** to pick up the new contract — the announcement and the capability snapshot are both read once at startup (see [Rediscovery & versioning](#rediscovery--versioning)).
+- **Reconnect** to pick up the new contract — the announcement is read once from the handshake at startup, and the capability snapshot is resolved on first use and cached thereafter (see [Rediscovery & versioning](#rediscovery--versioning)).
 - **Document the break** where the contract is documented, in `battlegrid-app`. Contract breaking-change notes are no longer keyed to package versions in this README, because a contract move is no longer a release here.
 
 ### Verify publication

package/dist/index.d.ts

@@ -37,7 +37,7 @@
  */
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
-import { type Implementation } from '@modelcontextprotocol/sdk/types.js';
+import { type Implementation, type Prompt, type Resource } from '@modelcontextprotocol/sdk/types.js';
 /**
  * This package's own version — the proxy's code, and nothing else.
  *
@@ -49,7 +49,7 @@ import { type Implementation } from '@modelcontextprotocol/sdk/types.js';
  * 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 = "31.1.0";
+export declare const PACKAGE_VERSION = "31.2.0";
 export declare const DEFAULT_URL = "https://mcp.battlegrid.trade/mcp";
 export interface EnvConfig {
     apiKeys: string[];
@@ -106,26 +106,73 @@ export declare function injectAccountParam(tools: ToolDefinition[], accountNames
  */
 export declare function announcedIdentityOf(serverInfo: Implementation | undefined): Implementation;
 export interface CreateProxyServerOptions {
-    /** Discovered account identities (index 0 is the primary key used for capability discovery). */
-    identities: AccountIdentity[];
-    /** Connect (or reuse) a remote MCP client for a given API key. Called once per key, lazily. */
+    /**
+     * The operator's FIRST configured key — used for the announcing handshake, the prompt and
+     * resource surfaces, and single-account routing. Deliberately not derived from whichever
+     * identity lookups happened to succeed: that made a mistyped first key silently promote the
+     * second, relocating every unqualified call to a different account.
+     */
+    primaryKey: string;
+    /**
+     * Whether a tool call must name an account. Derived from the CONFIGURED key count, so the guard
+     * is armed before any network call. Deriving it from resolved identities would let a transient
+     * identity failure convert a multi-account proxy into a single-account one and route an
+     * unqualified money-moving call to the primary.
+     */
+    isMultiAccount: boolean;
+    /** Connect (or reuse) a remote MCP client for a given API key. */
     connect: (apiKey: string) => Promise<Client>;
+    /** Resolve account identities. Awaited lazily, on the first request that needs the catalog. */
+    resolveIdentities: () => Promise<AccountIdentity[]>;
 }
-export interface ProxyServer {
-    server: Server;
+/**
+ * Everything the catalog resolution produces, resolved together as one shared value.
+ *
+ * The account selector published on every tool schema and the membership check applied to an
+ * incoming call are one rule at two altitudes, so `accountNames` and `keyByAccount` are members
+ * here rather than re-derived at each handler.
+ */
+export interface ProxyCatalog {
+    identities: AccountIdentity[];
+    accountNames: string[];
+    keyByAccount: Map<string, string>;
+    tools: ToolDefinition[];
+    prompts: Prompt[];
+    resources: Resource[];
+}
+/**
+ * What a completed warm-up reports back to `main()`, which owns every startup diagnostic.
+ *
+ * Carries `accountNames` as well as the counts because the account-roster line is the only surface
+ * naming which accounts actually resolved — the signal a dangling primary or a silent single-account
+ * collapse would otherwise hide.
+ */
+export interface WarmSummary {
+    accountNames: string[];
     toolCount: number;
     promptCount: number;
     resourceCount: number;
-    isMultiAccount: boolean;
-    accountNames: string[];
+}
+export interface ProxyServer {
+    server: Server;
     /** The upstream identity relayed downstream — the contract a local client will actually reach. */
     announced: Implementation;
+    /**
+     * Resolve the catalog, returning its counts. Returns the SAME memoized resolution a request
+     * triggers — it starts nothing of its own, so warm-up and a first request never resolve twice.
+     */
+    warm: () => Promise<WarmSummary>;
 }
 /**
- * Build the local stdio-facing MCP server that proxies to the remote BattleGrid
- * server. Discovers remote capabilities through the primary client, augments
- * tools with the `account` enum when multiple accounts resolved, and wires
- * strip-only-account routing to a lazily-populated per-key client pool.
+ * Build the local stdio-facing MCP server that proxies to the remote BattleGrid server.
+ *
+ * ORDERING IS THE POINT. Exactly one upstream operation happens here: the handshake that yields the
+ * identity this proxy relays. `serverInfo` is captured by the SDK at `Server` construction and read
+ * when `initialize` is answered, with no setter, so relaying the upstream's identity verbatim makes
+ * one round trip inherent. Everything else — identity discovery and the three catalog calls —
+ * resolves lazily, after the caller has bound the transport, because none of it is needed to answer
+ * `initialize` and every unit of work placed ahead of the bind is paid by every client on every
+ * start.
  */
 export declare function createProxyServer(options: CreateProxyServerOptions): Promise<ProxyServer>;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,EAOL,KAAK,cAAc,EACpB,MAAM,oCAAoC,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,WAAW,CAAC;AACxC,eAAO,MAAM,WAAW,qCAAqC,CAAC;AAM9D,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAID,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CA+B9E;AAID,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,EAAE,CAAC,CA6C5B;AA6DD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,CAgBpG;AAID;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,cAAc,GAAG,SAAS,GAAG,cAAc,CAS1F;AAID,MAAM,WAAW,wBAAwB;IACvC,gGAAgG;IAChG,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,+FAA+F;IAC/F,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,kGAAkG;IAClG,SAAS,EAAE,cAAc,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC,CAmI/F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -52,10 +52,16 @@ import { ListToolsRequestSchema, CallToolRequestSchema, ListPromptsRequestSchema
  * 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 = '31.1.0';
+export const PACKAGE_VERSION = '31.2.0';
 export const DEFAULT_URL = 'https://mcp.battlegrid.trade/mcp';
 const MAX_RETRIES = 3;
 const RETRY_DELAYS_MS = [2000, 4000, 8000];
+// One rule, two expressions. Asserted here so the delay table genuinely bounds the attempt count,
+// which is what lets connectWithRetry index it without a fallback.
+if (RETRY_DELAYS_MS.length !== MAX_RETRIES) {
+    throw new Error(`Retry budget disagrees with itself: MAX_RETRIES=${MAX_RETRIES} but RETRY_DELAYS_MS carries ` +
+        `${RETRY_DELAYS_MS.length} delays. Reconcile them at their declaration.`);
+}
 // --- Environment validation (exported for testing) ---
 export function validateEnv(env) {
     const apiUrl = env.BATTLEGRID_API_URL || DEFAULT_URL;
@@ -133,7 +139,8 @@ function isAuthError(error) {
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
-async function connectWithRetry(client, transport, apiUrl) {
+async function connectWithRetry(client, transport, apiUrl, apiKey) {
+    const keyPrefix = apiKey.substring(0, 12);
     for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
         try {
             await client.connect(transport);
@@ -146,7 +153,7 @@ async function connectWithRetry(client, transport, apiUrl) {
                 : undefined;
             const errorMessage = error instanceof Error ? error.message : String(error);
             if (isAuthError(error)) {
-                throw new Error(`Authentication failed (HTTP ${errorCode ?? 'unknown'}): ${errorMessage}\n` +
+                throw new Error(`Authentication failed for key ${keyPrefix} (HTTP ${errorCode ?? 'unknown'}): ${errorMessage}\n` +
                     'This means the server rejected your API key. Possible causes:\n' +
                     '  1. Key was revoked (a new key invalidates all previous keys)\n' +
                     '  2. Key was corrupted during copy-paste\n' +
@@ -154,12 +161,13 @@ async function connectWithRetry(client, transport, apiUrl) {
                     'Create a new key at: https://battlegrid.trade → Profile → MCP tab');
             }
             if (attempt === MAX_RETRIES) {
-                throw new Error(`Cannot connect to BattleGrid server at ${apiUrl} after ${MAX_RETRIES + 1} attempts.\n` +
+                throw new Error(`Cannot connect to BattleGrid server at ${apiUrl} with key ${keyPrefix} after ` +
+                    `${MAX_RETRIES + 1} attempts.\n` +
                     `Last error: ${errorMessage}\n` +
                     `Check your internet connection or verify the server is running.\n` +
                     `Health check: ${apiUrl.replace('/mcp', '')}/health`);
             }
-            const delay = RETRY_DELAYS_MS[attempt] ?? 8000;
+            const delay = RETRY_DELAYS_MS[attempt];
             process.stderr.write(`Connection attempt ${attempt + 1} failed (${errorMessage}), retrying in ${delay / 1000}s...\n`);
             await sleep(delay);
         }
@@ -222,64 +230,153 @@ export function announcedIdentityOf(serverInfo) {
     return serverInfo;
 }
 /**
- * Build the local stdio-facing MCP server that proxies to the remote BattleGrid
- * server. Discovers remote capabilities through the primary client, augments
- * tools with the `account` enum when multiple accounts resolved, and wires
- * strip-only-account routing to a lazily-populated per-key client pool.
+ * Build the local stdio-facing MCP server that proxies to the remote BattleGrid server.
+ *
+ * ORDERING IS THE POINT. Exactly one upstream operation happens here: the handshake that yields the
+ * identity this proxy relays. `serverInfo` is captured by the SDK at `Server` construction and read
+ * when `initialize` is answered, with no setter, so relaying the upstream's identity verbatim makes
+ * one round trip inherent. Everything else — identity discovery and the three catalog calls —
+ * resolves lazily, after the caller has bound the transport, because none of it is needed to answer
+ * `initialize` and every unit of work placed ahead of the bind is paid by every client on every
+ * start.
  */
 export async function createProxyServer(options) {
-    const { identities, connect } = options;
-    const isMultiAccount = identities.length > 1;
-    const accountNames = identities.map(id => id.username);
-    // Build lookup: username → apiKey
-    const keyByAccount = new Map();
-    for (const id of identities) {
-        keyByAccount.set(id.username, id.apiKey);
-    }
-    // Primary client (first key) is used for capability discovery and non-tool proxying.
-    const primaryKey = identities[0].apiKey;
+    const { primaryKey, isMultiAccount, connect, resolveIdentities } = options;
+    // The one retained pre-bind round trip.
     const primaryClient = await connect(primaryKey);
     // What this proxy announces downstream is what the upstream just announced to it — read here,
     // from the completed handshake, so it can never be a stale constant.
     const announced = announcedIdentityOf(primaryClient.getServerVersion());
-    // Discover remote capabilities
-    const [toolsResult, promptsResult, resourcesResult] = await Promise.all([
-        primaryClient.listTools(),
-        primaryClient.listPrompts(),
-        primaryClient.listResources(),
-    ]);
-    // Augment tools with account parameter if multi-account
-    const exposedTools = isMultiAccount
-        ? injectAccountParam(toolsResult.tools, accountNames)
-        : toolsResult.tools;
-    // Create local stdio server, announcing the upstream's identity rather than one of our own.
+    // `listChanged` is declared HERE and can never be added later: registerCapabilities throws once a
+    // transport is connected, and a client only registers list-changed handlers for capabilities the
+    // server advertised. Without it, a client whose first tools/list failed holds an empty catalog for
+    // the life of the process — the symptom this lazy catalog exists to remove, made silent.
     const localServer = new Server(announced, {
         capabilities: {
-            tools: {},
-            prompts: {},
-            resources: {},
+            tools: { listChanged: true },
+            prompts: { listChanged: true },
+            resources: { listChanged: true },
         },
     });
-    // Keep a pool of remote clients keyed by API key for routing
+    // Pool of PROMISES, not clients: concurrent callers for one key share one in-flight connect
+    // rather than each building a transport that is never closed. A rejection is removed so the next
+    // caller retries.
     const clientPool = new Map();
-    clientPool.set(primaryKey, primaryClient);
-    async function getClientForKey(apiKey) {
+    clientPool.set(primaryKey, Promise.resolve(primaryClient));
+    function getClientForKey(apiKey) {
         const existing = clientPool.get(apiKey);
         if (existing)
             return existing;
-        const client = await connect(apiKey);
-        clientPool.set(apiKey, client);
-        return client;
+        const pending = connect(apiKey);
+        clientPool.set(apiKey, pending);
+        pending.catch(() => {
+            if (clientPool.get(apiKey) === pending)
+                clientPool.delete(apiKey);
+        });
+        return pending;
+    }
+    let catalogMemo = null;
+    let servedCatalogError = false;
+    async function announceListsChanged() {
+        try {
+            await Promise.all([
+                localServer.sendToolListChanged(),
+                localServer.sendPromptListChanged(),
+                localServer.sendResourceListChanged(),
+            ]);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            process.stderr.write(`Warning: could not notify client that the catalog recovered: ${message}\n`);
+        }
+    }
+    async function buildCatalog() {
+        const identities = await resolveIdentities();
+        // The declared primary must be in the resolved roster. Identity discovery is a single unretried
+        // request while the handshake retries three times, so a primary can complete the handshake and
+        // still be missing here — which would serve prompts and resources as an account that appears in
+        // no selector and no log line.
+        if (!identities.some((identity) => identity.apiKey === primaryKey)) {
+            throw new Error(`Primary key (${primaryKey.substring(0, 12)}) is absent from the resolved account roster, ` +
+                'so every call routed to it would execute as an account this proxy never resolved.');
+        }
+        const accountNames = identities.map((identity) => identity.username);
+        const keyByAccount = new Map();
+        for (const identity of identities) {
+            if (keyByAccount.has(identity.username)) {
+                throw new Error(`Two configured accounts resolved to the display name "${identity.username}", so an ` +
+                    'account selection cannot name one of them unambiguously.');
+            }
+            keyByAccount.set(identity.username, identity.apiKey);
+        }
+        const [toolsResult, promptsResult, resourcesResult] = await Promise.all([
+            primaryClient.listTools(),
+            primaryClient.listPrompts(),
+            primaryClient.listResources(),
+        ]);
+        const discovered = toolsResult.tools;
+        return {
+            identities,
+            accountNames,
+            keyByAccount,
+            tools: isMultiAccount ? injectAccountParam(discovered, accountNames) : discovered,
+            prompts: promptsResult.prompts,
+            resources: resourcesResult.resources,
+        };
+    }
+    /**
+     * The catalog, resolved at most once and shared by every caller.
+     *
+     * The clear-on-failure is identity-guarded deliberately. The obvious shape — an async IIFE whose
+     * inner catch nulls the memo — poisons it permanently when the body throws before its first
+     * `await`: that catch runs during the synchronous prefix and the outer assignment then
+     * re-installs the rejected promise. Guarding on identity is correct for both timings and also
+     * cannot discard a newer resolution another request installed.
+     */
+    function resolveCatalog() {
+        const existing = catalogMemo;
+        if (existing)
+            return existing;
+        const pending = buildCatalog();
+        catalogMemo = pending;
+        pending.catch(() => {
+            if (catalogMemo === pending)
+                catalogMemo = null;
+        });
+        void pending.then(() => {
+            if (!servedCatalogError)
+                return;
+            servedCatalogError = false;
+            void announceListsChanged();
+        }, () => undefined);
+        return pending;
+    }
+    /** Resolve the catalog, remembering that a failure was served so a later recovery can be announced. */
+    async function catalogOrThrow() {
+        try {
+            return await resolveCatalog();
+        }
+        catch (error) {
+            servedCatalogError = true;
+            throw error;
+        }
     }
     // --- Proxy: tools ---
-    localServer.setRequestHandler(ListToolsRequestSchema, async () => ({
-        tools: exposedTools,
-    }));
+    // Throws on rejection: ListToolsResult carries only `tools`, so the tools/call in-band
+    // `{content, isError}` shape would ship as a SUCCESSFUL result that fails the client's own parse.
+    // The SDK maps a thrown handler error to a proper JSON-RPC error.
+    localServer.setRequestHandler(ListToolsRequestSchema, async () => {
+        const catalog = await catalogOrThrow();
+        return { tools: catalog.tools };
+    });
     localServer.setRequestHandler(CallToolRequestSchema, async (request) => {
         try {
             let targetKey = primaryKey;
             const args = { ...request.params.arguments };
+            // Read from the constructor option, never from the catalog: the guard must be armed even
+            // while the account set is still unknown.
             if (isMultiAccount) {
+                const { keyByAccount, accountNames } = await catalogOrThrow();
                 const selectedAccount = args.account;
                 if (!selectedAccount || !keyByAccount.has(selectedAccount)) {
                     return {
@@ -308,9 +405,10 @@ export async function createProxyServer(options) {
         }
     });
     // --- Proxy: prompts ---
-    localServer.setRequestHandler(ListPromptsRequestSchema, async () => ({
-        prompts: promptsResult.prompts,
-    }));
+    localServer.setRequestHandler(ListPromptsRequestSchema, async () => {
+        const catalog = await catalogOrThrow();
+        return { prompts: catalog.prompts };
+    });
     localServer.setRequestHandler(GetPromptRequestSchema, async (request) => {
         return await primaryClient.getPrompt({
             name: request.params.name,
@@ -318,9 +416,10 @@ export async function createProxyServer(options) {
         });
     });
     // --- Proxy: resources ---
-    localServer.setRequestHandler(ListResourcesRequestSchema, async () => ({
-        resources: resourcesResult.resources,
-    }));
+    localServer.setRequestHandler(ListResourcesRequestSchema, async () => {
+        const catalog = await catalogOrThrow();
+        return { resources: catalog.resources };
+    });
     localServer.setRequestHandler(ReadResourceRequestSchema, async (request) => {
         return await primaryClient.readResource({
             uri: request.params.uri,
@@ -328,12 +427,16 @@ export async function createProxyServer(options) {
     });
     return {
         server: localServer,
-        toolCount: toolsResult.tools.length,
-        promptCount: promptsResult.prompts.length,
-        resourceCount: resourcesResult.resources.length,
-        isMultiAccount,
-        accountNames,
         announced,
+        warm: async () => {
+            const catalog = await resolveCatalog();
+            return {
+                accountNames: catalog.accountNames,
+                toolCount: catalog.tools.length,
+                promptCount: catalog.prompts.length,
+                resourceCount: catalog.resources.length,
+            };
+        },
     };
 }
 // --- Main ---
@@ -352,27 +455,25 @@ async function main() {
         const hashPrefix = createHash('sha256').update(key).digest('hex').substring(0, 16);
         process.stderr.write(`BattleGrid MCP: Key #${i + 1} prefix=${key.substring(0, 12)} hashPrefix=${hashPrefix} len=${key.length}\n`);
     }
-    // Discover identities for all keys
-    let identities;
-    try {
-        identities = await discoverIdentities(config.apiKeys, config.apiUrl);
-    }
-    catch (error) {
-        process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}\n`);
-        process.exit(1);
-    }
-    process.stderr.write(`BattleGrid MCP: ${identities.length} account(s) discovered — ${identities.map(id => id.username).join(', ')}\n`);
-    // Lazily connect a remote MCP client per API key, with retry + auth diagnostics.
+    // Connect a remote MCP client for a given API key, with retry + auth diagnostics.
     const connect = async (apiKey) => {
         const transport = new StreamableHTTPClientTransport(new URL(config.apiUrl), { requestInit: { headers: { Authorization: `Bearer ${apiKey}` } } });
         // Upstream is told which proxy build is calling — the one question PACKAGE_VERSION answers.
         const client = new Client({ name: 'battlegrid-proxy', version: PACKAGE_VERSION }, { capabilities: {} });
-        await connectWithRetry(client, transport, config.apiUrl);
+        await connectWithRetry(client, transport, config.apiUrl, apiKey);
         return client;
     };
     let proxy;
     try {
-        proxy = await createProxyServer({ identities, connect });
+        proxy = await createProxyServer({
+            // The operator's declared first key, chosen before discovery so an unreachable one fails
+            // loudly here instead of silently promoting the second.
+            primaryKey: config.apiKeys[0],
+            // Armed by configuration, so a later identity failure cannot stand the account guard down.
+            isMultiAccount: config.apiKeys.length > 1,
+            connect,
+            resolveIdentities: () => discoverIdentities(config.apiKeys, config.apiUrl),
+        });
     }
     catch (error) {
         process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}\n`);
@@ -383,11 +484,25 @@ async function main() {
     // unnoticed for ten days.
     process.stderr.write(`BattleGrid MCP: announcing ${proxy.announced.name}@${proxy.announced.version} ` +
         `(server contract, read from the upstream handshake) — proxy ${PACKAGE_VERSION}\n`);
-    process.stderr.write(`BattleGrid MCP: ${proxy.toolCount} tools, ${proxy.promptCount} prompts, ${proxy.resourceCount} resources\n`);
-    // --- Start stdio transport ---
+    // --- Start stdio transport, BEFORE any catalog work ---
+    //
+    // Everything above is the single upstream handshake the relayed serverInfo requires. From here the
+    // process answers `initialize`; identity discovery and the three catalog calls happen behind it.
     const stdioTransport = new StdioServerTransport();
     await proxy.server.connect(stdioTransport);
     process.stderr.write('BattleGrid MCP server running on stdio\n');
+    // Warm the catalog so the first tools/list joins an in-flight resolution rather than starting one.
+    // Deliberately NOT awaited, and the rejection handler is the whole of the guarantee that a
+    // background failure cannot kill a process that has already answered `initialize`. The failure is
+    // reported and absorbed; the next request that needs the catalog retries it.
+    void proxy.warm().then((summary) => {
+        process.stderr.write(`BattleGrid MCP: ${summary.accountNames.length} account(s) discovered — ${summary.accountNames.join(', ')}\n`);
+        process.stderr.write(`BattleGrid MCP: ${summary.toolCount} tools, ${summary.promptCount} prompts, ${summary.resourceCount} resources\n`);
+    }, (error) => {
+        const message = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`Warning: catalog warm-up failed (${message}). The proxy is connected; the next request ` +
+            'that needs the catalog will retry it.\n');
+    });
 }
 // Only run when executed directly (not when imported for testing)
 const isDirectExecution = process.argv[1] &&

package/dist/index.js.map

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

package/package.json

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

package/skills/battlegrid-strategy-studio/SKILL.md

@@ -88,14 +88,22 @@ values instead of the evaluated coin's — the standard way to gate a whole book
 regime. `benchmarkTicker` is required-nullable on every custom section: send `null` for an
 ordinary section, never omit it.
 
+A bound section takes **indicator** columns only. Crowd/session metrics (the `CROWD_*` family,
+`FLOW_ALIGN`, `SMART_RETAIL`, `CAPTAIN_CONF`, `CONFIDENCE`, `SETTLED_AT`, `PERP_SPOT_*`) and any
+`rank` transform are refused there (contract 49), because both are defined relative to the cohort
+being evaluated and a benchmark sits outside it — a crowd reading is what this session's players
+did, a rank is a position among the coins under evaluation. Neither has a value for BTC-as-yardstick.
+Put those columns on an ordinary section and `conditionRef` across.
+
 Budgets are served by discovery (validated today: 32 sections, 32 custom columns, 8 distinct
 timeframes, 16 conditions, 16 clauses, 16k estimated report tokens). `preview_strategy_report`
 echoes your usage against each cap.
 
 ## Conditions — deterministic logic over your own report
 
-Each condition: `{ conditionKey, name, definition, verdict, required }` — all five required;
-`verdict` and `required` have no defaults.
+Each condition: `{ conditionKey, name, definition, verdict, required, exit, clock, closes }` —
+all eight required, no defaults. The conditions axis saves by whole-set replacement, so an omitted
+key would silently un-clock a money gate on the next unrelated edit rather than be refused.
 
 - **Clauses** compare one column: numeric/rank headers take `lt|lte|gte|gt|between`;
   classification/direction/event headers take `is|in` with the column's exact vocabulary
@@ -106,8 +114,11 @@ Each condition: `{ conditionKey, name, definition, verdict, required }` — all
   rejected, forward references are legal.
 - **Column addressing**: `{sectionKey, header}`. `sectionKey: null` is authoring sugar for a
   header unique across the whole report; a duplicated header (e.g. `ADX` in two sections) must
-  be section-qualified. To reference your own custom sections at CREATE time, mint the
-  `custom:<uuid>` sectionKey yourself and reuse it in the clauses.
+  be section-qualified. On a **CREATE you omit `sectionKey` entirely** — the server derives it
+  from the section itself, so the same submitted section yields the same key on every compile, and
+  minting a `custom:<uuid>` yourself is refused. On an UPDATE or RESTORE, send back the keys
+  `get_strategy` returned. To qualify a duplicated header, read the key from a preview's
+  `conditionColumns` or from the candidates a `CONDITION_COLUMN_AMBIGUOUS` refusal offers.
 - **Verdict**: `UP` | `DOWN` | `NEITHER` on deciding conditions, explicit `null` on building
   blocks. Declaration order is precedence: the first TRUE condition with a non-null verdict
   decides the coin's verdict. Put the more specific carrier first.
@@ -116,6 +127,48 @@ Each condition: `{ conditionKey, name, definition, verdict, required }` — all
   use it for liquidity floors, regime vetoes, and "never fight the HTF" rules.
 - Evaluation is three-valued: `UNRESOLVED` (missing input) is never collapsed to FALSE, and
   outcomes read from a still-forming bar are marked provisional.
+- **The evidence clock.** `clock: "LIVE"` reads the forming bar; `clock: "CLOSE"` reads settled
+  bars, and `closes` (1–5) is how many consecutive closed bars must read TRUE — always `1` under
+  LIVE, which has exactly one frame. A CLOSE clock is legal **only** over a header resolved from
+  the coin's own candle series at offset 0; frame-inert operands (perp-payload scalars, published
+  rolling changes, ranks, zone entities, regime labels, enrichment metrics, session scalars) are
+  refused with `CONDITION_CLOCK_OPERAND_ILLEGAL`. The remedy is a split, not a re-clock: move that
+  clause into its own LIVE condition and `conditionRef` it.
+- **The exit role.** `exit: true` makes a settled TRUE reading close open positions its verdict
+  opposes — UP exits SHORTs, DOWN exits LONGs, a `NEITHER` or `null` verdict exits both. Legal only
+  under `clock: "CLOSE"`, because an exit fired on a forming bar is an intrabar exit. Orthogonal to
+  `required`: the two act on disjoint lifecycles, pre-entry versus open.
+
+## Entry — when, and where, an entry is taken
+
+`{ trigger, confirmTf, closes, bandAtrMultiple, levelSource, levelOffsetAtrMultiple, validForBars }`
+— all seven required on every CREATE, no defaults. Replaced WHOLE on save, so an omitted key
+reverts an author's discipline silently rather than being refused.
+
+| `trigger` | What it does |
+|---|---|
+| `AT_SIGNAL` | Fire on the qualification flip, at whatever bar is on the tape. The platform's flat wall-clock entry window applies. |
+| `ON_CANDLE_CLOSE` | The flip ARMS the pair; entry is taken only after a `confirmTf` close that still reads the conditions true and has not displaced beyond the band. |
+| `STOP_THROUGH_LEVEL` | A TRIGGER order rests at the level ± offset; the exchange book is the watcher. |
+| `ON_RETEST` | A LIMIT order rests at the broken level. Not filling is a correct outcome, not a failure. |
+
+- `confirmTf` — exactly two values are legal: the strategy's own timeframe and the rung below it
+  (one only, at the ladder floor). Not the authorable main-candle set.
+- `closes` — 1–5 consecutive confirming closes. Must be `1` under any trigger but `ON_CANDLE_CLOSE`.
+- `bandAtrMultiple` — the veto width. The entry is VOIDED when the confirming close moved at or
+  beyond that many ATR against the armed verdict. Strictly `> 0` (zero voids on any adverse move,
+  which is a filter, not "off"), and at or below the platform's own entry-deviation gate — read it
+  from `get_trading_config_catalog`.
+- `levelSource` — `SWING_HIGH` | `SWING_LOW` | `BOLLINGER_UPPER` | `BOLLINGER_LOWER`, resolved once
+  at decision time.
+- `levelOffsetAtrMultiple` — 0–2, UNSIGNED. Direction is implied by the trigger and the verdict, so
+  a signed value would invert the trigger's meaning. Must be `0` under a non-level trigger.
+- `validForBars` — 1–24 of the strategy's OWN bars, not minutes: a 1h setup waiting for a retest has
+  not failed after fifteen minutes.
+
+The legality matrix runs **one way**: all seven keys are always present, so the question is never
+"is it set" but "is it set to something that MEANS anything under this trigger". Leave a dial at its
+inert value rather than setting one the platform will ignore.
 
 ## Signal weights — the scorecard is a weighted average, budget it
 

package/skills/battlegrid-strategy-studio/references/recipes.md

@@ -54,10 +54,16 @@ before any billing or LLM call:
 
 ```json
 { "conditionKey": "NO_EVENT_RISK", "name": "No liquidation tape", "verdict": null, "required": true,
+  "exit": false, "clock": "LIVE", "closes": 1,
   "definition": { "kind": "group", "op": "NOT", "members": [
     { "kind": "clause", "column": { "sectionKey": null, "header": "oiRegime" }, "op": "is", "label": "long liquidation" } ] } }
 ```
 
+All eight keys are required on every condition — `exit`, `clock` and `closes` included. `clock`
+selects the evidence frame (`LIVE` reads the forming bar, `CLOSE` reads settled bars) and `closes`
+(1–5) is how many consecutive closed bars must hold; `closes` is always `1` under `LIVE`. `exit:
+true` closes open positions the verdict opposes and is legal only under `clock: "CLOSE"`.
+
 **Quorum (N_OF).** Robust confirmation instead of a brittle ALL:
 
 ```json
@@ -72,11 +78,42 @@ directional carriers; the first TRUE carrier **in declaration order** decides
 most-specific first.
 
 **Benchmark gate.** Read regime off a `benchmarkTicker` section (all rows are the benchmark's
-values) and `conditionRef` it from every carrier — one place to flip the book risk-on/off.
+values) and `conditionRef` it from every carrier — one place to flip the book risk-on/off. Keep that
+section to indicators: crowd/session metrics and `rank` transforms are refused on a bound section
+(contract 49) — rank the coins on an ordinary section and `conditionRef` the two together.
 
 **Required-count trap.** `required: true` at `allocation: 0` on a *signal rule* is rejected
 (contract 34). A required *condition* is independent of signal weights — the two gates stack.
 
+## Entry discipline recipes
+
+The `entry` object is required on every CREATE, all seven keys, no defaults.
+
+| Intent | Object |
+|---|---|
+| Today's behaviour, unchanged | `{ "trigger": "AT_SIGNAL", "confirmTf": "<strategy tf>", "closes": 1, "bandAtrMultiple": 1.0, "levelSource": "SWING_HIGH", "levelOffsetAtrMultiple": 0, "validForBars": 4 }` |
+| Wait for the bar to close, skip a runaway | `{ "trigger": "ON_CANDLE_CLOSE", "confirmTf": "<strategy tf>", "closes": 1, "bandAtrMultiple": 1.0, … }` |
+| Two-close confirmation on the lower rung | `{ "trigger": "ON_CANDLE_CLOSE", "confirmTf": "<lower rung>", "closes": 2, "bandAtrMultiple": 0.75, … }` |
+| Break of the swing high, half an ATR through | `{ "trigger": "STOP_THROUGH_LEVEL", "levelSource": "SWING_HIGH", "levelOffsetAtrMultiple": 0.5, "validForBars": 8, "closes": 1, … }` |
+| Buy the retest of the broken level | `{ "trigger": "ON_RETEST", "levelSource": "SWING_HIGH", "levelOffsetAtrMultiple": 0, "validForBars": 12, "closes": 1, … }` |
+
+Bounds: `closes` 1–5 and `1` unless `ON_CANDLE_CLOSE`; `bandAtrMultiple` > 0 and ≤ the platform's
+`defaultMaxEntryDeviationAtrMultiple`; `levelOffsetAtrMultiple` 0–2 unsigned and `0` unless a level
+trigger; `validForBars` 1–24. `confirmTf` is the strategy timeframe or the rung below it, nothing
+else. A meaningful value under a trigger that ignores it is REFUSED, not ignored — that is
+deliberate, so a dial never silently does nothing.
+
+## Custom section shape
+
+`{ kind, sectionKey, title, benchmarkTicker, notes, columns }`. `benchmarkTicker` and
+`notes` are **required-nullable** — send explicit `null` rather than omitting them, because the
+section is rebuilt whole on save and an omitted key clears the value. **Omit `sectionKey` on a
+CREATE**: the server derives it from the section.
+
+A section carries **no `timeframe`** (48.0.0). Its relative columns resolve against the strategy
+timeframe; a column reaches any other timeframe by pinning it — `timeframe: { abs: '4h' }` on the
+column, which it could always do.
+
 ## Weight matrices (rules)
 
 **Conviction pyramid (default).** 1–2 × Critical (the thesis signals, usually `required`),
@@ -107,6 +144,10 @@ send the full replacement object. Examples validated as canonical defaults: `vol
 | Swing breakout (4h) | 0.75 – 1.75 | 2 | 1R | 1.2R, giveback 35, buffer 0.3 | off |
 | Swing trend (4h) | 1.0 – 2.5 | 2 | 1R | 1.5R, giveback 45–55, buffer 0.3 | off |
 
+Post-entry invalidation: `decisionInvalidationExitEnabled: true` closes a filled position when a
+**closed** strategy-timeframe candle finishes beyond the decision's invalidation level, reduce-only.
+Bar-close only — the protective stop still owns intrabar moves.
+
 Bounds to respect (validated): break-even trigger 0.5–2R; trailing trigger 0–2R step 0.01
 (0 = trail from entry); giveback 25–55%; buffer 0.01–1%; grace ≥ interval; stop-band floor <
 ceiling ≤ the 3×ATR structural cap; RR within the catalog's served range (0.5–3 today). Wider

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

@@ -37,8 +37,8 @@ closes while stops, trailing, and time decay keep managing the position intraday
 
 | TradingView script | Verdict | Port anchor |
 |---|---|---|
-| Squeeze Momentum [LazyBear] / TTM Squeeze | Process port (Keltner not in catalog — substitute named) | `bbWidthPct` + rank, `bollinger_squeeze`, momentum trajectory |
-| Supertrend / UT Bot Alerts | Split port: entry substitute + **native stop engine** | `EMA5_13`, `MAalign`, position-management trailing |
+| Squeeze Momentum [LazyBear] / TTM Squeeze | **Direct port** — Keltner is native | `BB_UPPER spread KC_UPPER`, `BB_LOWER spread KC_LOWER`, `bollinger_squeeze` |
+| Supertrend / UT Bot Alerts | **Direct port** for the state; flip still substituted | `ST_LINE`, `ST_DIR`, `EMA5_13` for the flip, position-management trailing |
 | Chandelier Exit | Direct port of the *mechanism* | trailing from entry (`trailingTriggerR: 0`) |
 | MACD + 200 MA filter | Direct process port | `MACD_cross`, `dist_SMA200`, `macd_bull_cross` |
 | Golden / Death Cross | Direct process port | `SMA50_SMA200_spread` + `_trend` |
@@ -46,7 +46,7 @@ closes while stops, trailing, and time decay keep managing the position intraday
 | VWAP reversion | Direct process port | `dist_VWAP`, `dist_VWAP_rank_far` |
 | Donchian / Turtle breakout | Process port (N-bar channel → swing structure) | `zone`, `dist_swingHi`, `sr_resistance_break` |
 | ICT/SMC: FVG + Order Blocks | Direct process port of the zone logic | `STRUCT_ZONES` columns + `structure_*` signals |
-| WaveTrend, QQE, Hull Suite, Ichimoku, Parabolic SAR, Keltner | **Not expressible** — say so; nearest neighbors below | — |
+| WaveTrend, QQE, Hull Suite, Ichimoku, Parabolic SAR, Keltner | **All native since contract 46.1** — port directly | `WT1`/`WT2`, `QQE_RSI_MA`/`QQE_STOP`, `HMA20`, `ICHI_*`, `PSAR`, `KC_*` |
 
 ---
 
@@ -55,7 +55,10 @@ closes while stops, trailing, and time decay keep managing the position intraday
 **Source process.** Squeeze ON while Bollinger Bands sit inside Keltner Channels (volatility
 coiled); wait; when the squeeze releases, enter in the direction of the momentum histogram.
 
-**Port.** Keltner Channels are not in the catalog, so squeeze detection substitutes
+**Port.** Keltner Channels are native (`KC_UPPER`/`KC_MID`/`KC_LOWER`), so the squeeze is the
+source's own definition: `BB_UPPER spread KC_UPPER` negative AND `BB_LOWER spread KC_LOWER`
+positive is bands-inside-Keltner. The board-relative proxy below remains serviceable but is no
+longer the only option — it substitutes
 *cross-sectional and absolute* Bollinger compression — a stricter, universe-aware read:
 `bbWidthPct_rank_lo lte 10` AND `ADX lt 20` as the `SQUEEZE_ON` building block. Momentum
 direction comes from the MACD histogram trajectory (`MACD_now gt 0` with `MACD_trend rising`
@@ -75,7 +78,10 @@ Pine script simulates with a plotted line, position management executes: enable
 `trailingTriggerR: 0` (trail from entry — the Supertrend/UT Bot behavior), `giveback` as the
 ATR-offset analog (30–40 tight like factor-2 Supertrend, 45–55 loose like factor-3), plus the
 stop band (`minStopLossAtrMultiple`/`max…`) bounding the initial distance. The *flip entry*
-has no direct equivalent (no supertrend metric) — the named substitute is a trend-state change:
+is native: `ST_DIR` carries the direction and `ST_LINE` the plotted stop. **`ST_DIR` is a
+persisting state, not a flip event** — it reads the same on every bar of a trend, so the FLIP
+itself still needs an event column beside it. The named substitute for the flip is a trend-state
+change:
 `MAalign is "bullish"` (state) with the `EMA5_13 is "Bullish"` cross event as the trigger, and
 `ma_ema_bull_cross` / `ma_ema_aligned_bull` Critical/Important-required in `rules`. Say the
 substitution out loud when presenting the strategy.
@@ -139,7 +145,8 @@ the book out of single-name traps. Rules: `ma_sma200_above` 3 required, `ma_ema_
 **Source process.** In an uptrend (close > 200 SMA), buy panic dips (RSI(2) < 10); exit fast
 (cross of the 5-period average / a few bars).
 
-**Port — named substitute.** The catalog carries no RSI(2); `RSI7` is the fastest RSI series
+**Port — named substitute.** The catalog carries `RSI14` and `RSI7` only, so there is no `RSI2`;
+`RSI7` is the fastest RSI series
 and `lte 10` on it is a rarer, deeper panic — state that trade-off rather than hiding it.
 `DIP_BUY` verdict UP = `dist_SMA200 gt 0` (ref a required `ABOVE_200`) AND `RSI7 lte 10`.
 Rules: `rsi_oversold` 3 required `{"threshold": 25}` (RSI14 gate tuned toward the fast-dip
@@ -193,22 +200,36 @@ quorum (`N_OF(2)`: `buyPres gte 0.55`, `RVOL gte 1.2`, `closeChg gt 0`). Rules:
 `structure_fvg_approach` / `structure_ob_approach` 3/2 required (their `proximityPct` params
 are the "in the zone" dial), `structure_zone_confluence` 2, `sr_at_support` 2. Stops: tight
 band (0.5–1.5 ATR) — the zone's far edge is the invalidation, and the studio places stops by
-ATR/structure natively. **Not expressible, say so:** liquidity sweeps, displacement legs,
+ATR/structure natively. **A grammar limit, not a missing metric** — a clause compares one column
+against a literal, so an ordered sequence of events has no expressible form at all: liquidity
+sweeps, displacement legs,
 killzone clocks, and Turtle-Soup false-break sequencing (ordering between events is outside
 the grammar) — offer this zone-reaction port as the nearest expressible neighbor, labelled.
 
-## Not expressible — and the honest nearest neighbor
+## Now native — do not substitute for these
 
-| Script | Missing primitive | Nearest expressible neighbor |
+WaveTrend (`WT1`/`WT2`), QQE (`QQE_RSI_MA`/`QQE_STOP`), Hull (`HMA20`), Ichimoku
+(`ICHI_CONV`/`ICHI_BASE`/`ICHI_SPAN_A`/`ICHI_SPAN_B`/`ICHI_LAG`), Parabolic SAR (`PSAR`), Keltner
+(`KC_UPPER`/`KC_MID`/`KC_LOWER`), daily pivots (`PIVOT_P`/`PIVOT_R1`–`R3`/`PIVOT_S1`–`S3`),
+Williams %R (`WILLR14`), Stochastic RSI (`STOCH_RSI14`), Bollinger boundaries
+(`BB_UPPER`/`BB_LOWER`), ADX components (`DI_PLUS`/`DI_MINUS`). All arrived with contract 46.1 —
+every one of them was listed as inexpressible in this file before it.
+
+## Not expressible — the catalog keys this needs
+
+The one section where a claim that the catalog LACKS something may live, and every row names the key
+it denies so the claim stays checkable. A claim about the grammar's SHAPE (a clause compares one
+column against a literal; `distance` rejects an `offset`) is permanent and belongs in prose above.
+A claim that a metric is absent belongs here, or nowhere.
+
+| Script / primitive | Key the catalog would need | Nearest expressible neighbour |
 |---|---|---|
-| WaveTrend [LazyBear] | WT oscillator | `STOCH_K`/`STOCH_D` zones + crosses (`stoch_*` signals) |
-| QQE / QQE MOD | smoothed-RSI ATR bands | `RSI7` trajectory + `rsi_*` signals with tuned thresholds |
-| Hull Suite | Hull MA | `EMA5/13/20` ribbon (`MAalign`, EMA spread trend) |
-| Ichimoku | cloud spans | `MAalign` + `SMA50_SMA200_spread` + `zones_htf_*` levels |
-| Parabolic SAR | SAR dots | trailing stop from entry (`trailingTriggerR: 0`) |
-| Keltner Channels | ATR envelope | `bbWidthPct` compression + `atrPct` band logic |
-| Pivot Points (daily) | session pivots | `VWAP` + `swingHi`/`swingLo` distances |
-| Previous-day / previous-week high-low (PDH/PDL) | offset-able levels (`distance` takes no `offset`; clauses are column-vs-literal) | daily swing structure: `zone_1d is "breakout high"`, `dist_swingHi_1d` / `dist_swingLo_1d` |
+| RSI-2 (Connors) | `RSI2` | `RSI7 lte 10` as a named fast-dip substitute |
+
+**PDH/PDL** stays inexpressible for a different reason, and the distinction matters: `distance`
+rejects an `offset` and a clause never compares two columns, so the *grammar* has no form for it.
+No metric would fix that. Use the daily swing structure (`zone_1d`, `dist_swingHi_1d`) and name the
+substitution.
 
 Never compile a "port" of these under the source's name without the substitution note — a
 player who asked for WaveTrend and silently got Stochastic has no way to learn otherwise.