fix: register Hunch in ExchangeParam enum so it surfaces in docs

The 2.51.0 Hunch adapter was wired into the runtime but `hunch` was
missing from the ExchangeParam enum in generate-openapi.js. That enum
is the source of truth for venues.mdx, openapi.yaml, and COMPLIANCE.md
generation, so Hunch was invisible on pmxt.dev/docs/concepts/venues.

- generate-openapi.js: add `hunch` to ExchangeParam enum
- generate-compliance.js: add `hunch` to EXCHANGE_ORDER
- README: add Hunch to supported-exchanges row
- regenerated openapi.yaml, openapi.json, venues.mdx (18 venues),
  COMPLIANCE.md (Hunch 15/20)
- changelog: 2.51.1

Author: realfishsam

changelog.md

@@ -2,6 +2,16 @@
 
 All notable changes to this project will be documented in this file.
 
+## [2.51.1] - 2026-06-23
+
+Followup to the Hunch venue ship in 2.51.0: the adapter was wired into the runtime (factory, registry, exports) but `hunch` was missing from the `ExchangeParam` enum in `core/scripts/generate-openapi.js`. That enum is the source of truth for `docs/concepts/venues.mdx` (auto-generated), the OpenAPI path enum, and `COMPLIANCE.md`, so Hunch was invisible on pmxt.dev/docs/concepts/venues and absent from the compliance matrix.
+
+### Fixed
+
+- **`core/scripts/generate-openapi.js` — added `hunch` to the `ExchangeParam` enum.** Regenerated `core/src/server/openapi.yaml`, `docs/api-reference/openapi.json`, and `docs/concepts/venues.mdx` (now 18 venues).
+- **`core/scripts/generate-compliance.js` — added `hunch` to `EXCHANGE_ORDER`.** Regenerated `core/COMPLIANCE.md` (Hunch: 15/20 methods supported).
+- **`README.md` — added Hunch to the supported-exchanges row.**
+
 ## [2.51.0] - 2026-06-22
 
 New venue: **Hunch** (parimutuel prediction market on Base, x402 settlement). And a full assertion-based audit of the Hyperliquid SDK surface (both Python + TS) caught ten silent bugs that prior "did the call throw?" smoke tests had hidden — several since the venue was added. Read paths now have behavioral assertions on shape AND values; trading paths are verified end-to-end against a live mainnet wallet. Final HL state: every no-creds method behaviorally green in both SDKs (43/43 assertions), credentialed reads cross-checked vs HL raw API (open orders: 7/7 exact match; user trades: 2000/2000 match; synthesized closed orders: 104/104 match), and the full createOrder → openOrders → cancelOrder → openOrders-empty lifecycle proven live.

core/COMPLIANCE.md

@@ -8,69 +8,32 @@ This document details the feature support and compliance status for each exchang
 
 ## Functions Status
 
-| Category | Function | Polymarket | Kalshi | Limitless | Probable | Baozi | Myriad | Opinion | Metaculus |
-| :--- | :--- | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: |
-| **Market Data** | `fetchMarkets` | Y | Y | Y | Y | Y | Y | Y | Y |
-|  | `fetchEvents` | Y | Y | Y | Y | Y | Y | Y | Y |
-|  | `fetchMarket` | Y | Y | Y | Y | Y | Y | Y | Y |
-|  | `fetchEvent` | Y | Y | Y | Y | Y | Y | Y | Y |
-| **Public Data** | `fetchOHLCV` | Y | Y | Y | Y | Y | Y | Y | - |
-|  | `fetchOrderBook` | Y | Y | Y | Y | Y | Y | Y | - |
-|  | `fetchTrades` | Y | Y | Y | Y | Y | Y | - | - |
-| **Private Data** | `fetchBalance` | Y | Y | Y | Y | Y | Y | - | - |
-|  | `fetchPositions` | Y | Y | Y | Y | Y | Y | Y | - |
-|  | `fetchMyTrades` | Y | Y | Y | Y | - | Y | Y | - |
-| **Trading** | `createOrder` | Y | Y | Y | Y | Y | Y | Y | Y |
-|  | `cancelOrder` | Y | Y | Y | Y | Y | - | Y | Y |
-|  | `fetchOrder` | Y | Y | Y | Y | Y | - | Y | - |
-|  | `fetchOpenOrders` | Y | Y | Y | Y | Y | Y | Y | - |
-|  | `fetchClosedOrders` | - | Y | Y | - | - | - | Y | - |
-|  | `fetchAllOrders` | - | Y | Y | - | - | - | Y | - |
-| **Calculations** | `getExecutionPrice` | Y | Y | Y | Y | Y | Y | Y | - |
-|  | `getExecutionPriceDetailed` | Y | Y | Y | Y | Y | Y | Y | - |
-| **Real-time** | `watchOrderBook` | Y | Y | Y | Y | Y | Y | Y | - |
-|  | `watchTrades` | Y | Y | Y | - | - | Y | Y | - |
+| Category | Function | Polymarket | Kalshi | Limitless | Probable | Baozi | Myriad | Opinion | Metaculus | Hunch |
+| :--- | :--- | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: |
+| **Market Data** | `fetchMarkets` | Y | Y | Y | Y | Y | Y | Y | Y | Y |
+|  | `fetchEvents` | Y | Y | Y | Y | Y | Y | Y | Y | Y |
+|  | `fetchMarket` | Y | Y | Y | Y | Y | Y | Y | Y | Y |
+|  | `fetchEvent` | Y | Y | Y | Y | Y | Y | Y | Y | Y |
+| **Public Data** | `fetchOHLCV` | Y | Y | Y | Y | Y | Y | Y | - | Y |
+|  | `fetchOrderBook` | Y | Y | Y | Y | Y | Y | Y | - | Y |
+|  | `fetchTrades` | Y | Y | Y | Y | Y | Y | - | - | Y |
+| **Private Data** | `fetchBalance` | Y | Y | Y | Y | Y | Y | - | - | Y |
+|  | `fetchPositions` | Y | Y | Y | Y | Y | Y | Y | - | Y |
+|  | `fetchMyTrades` | Y | Y | Y | Y | - | Y | Y | - | - |
+| **Trading** | `createOrder` | Y | Y | Y | Y | Y | Y | Y | Y | Y |
+|  | `cancelOrder` | Y | Y | Y | Y | Y | - | Y | Y | - |
+|  | `fetchOrder` | Y | Y | Y | Y | Y | - | Y | - | - |
+|  | `fetchOpenOrders` | Y | Y | Y | Y | Y | Y | Y | - | Y |
+|  | `fetchClosedOrders` | - | Y | Y | - | - | - | Y | - | - |
+|  | `fetchAllOrders` | - | Y | Y | - | - | - | Y | - | - |
+| **Calculations** | `getExecutionPrice` | Y | Y | Y | Y | Y | Y | Y | - | Y |
+|  | `getExecutionPriceDetailed` | Y | Y | Y | Y | Y | Y | Y | - | Y |
+| **Real-time** | `watchOrderBook` | Y | Y | Y | Y | Y | Y | Y | - | Y |
+|  | `watchTrades` | Y | Y | Y | - | - | Y | Y | - | Y |
 
 ## Legend
 - **Y** - Supported
 - **-** - Not supported
-- **E** - Emulated (backed by a non-native mechanism)
-
-> NOTE: the grid above is regenerated by `generate:compliance` from
-> `core/src/exchanges/*/index.ts`. The Hunch column below is documented inline
-> until the next regeneration picks it up.
-
-## Hunch
-
-Hunch is a **parimutuel** prediction market on **Base** (USDC). Markets are
-pool-based — there is no CLOB and no AMM curve; prices are *implied odds*.
-Settlement is **x402 / EIP-3009 `transferWithAuthorization`** (the bettor's
-wallet signs a USDC authorization; the relayer sponsors gas). Identity is
-keyless — the wallet IS the account, so reads need no API key.
-
-| Category | Function | Hunch | Notes |
-| :--- | :--- | :---: | :--- |
-| **Market Data** | `fetchMarkets` | Y | `GET /api/agent/v1/markets` |
-|  | `fetchEvents` | Y | No event tier — each market wrapped as a single-market event |
-|  | `fetchMarket` | Y | `GET /api/agent/v1/markets/{id}` |
-|  | `fetchEvent` | Y | Synthetic single-market event |
-| **Public Data** | `fetchOHLCV` | Y | From research `oddsHistory` (flat candles) |
-|  | `fetchOrderBook` | E | Emulated: single level at the implied price, pool as depth |
-|  | `fetchTrades` | Y | research `oddsHistory` as the public tape |
-| **Private Data** | `fetchBalance` | Y | `GET .../wallet/{address}/readiness` → USDC balance |
-|  | `fetchPositions` | Y | `GET /api/agent/v1/positions?wallet=` |
-|  | `fetchMyTrades` | - | Not exposed (use `fetchPositions` / proof) |
-| **Trading** | `createOrder` | Y | Self-hosted Base **x402** money path; **market orders only** |
-|  | `cancelOrder` | - | Parimutuel pool — bets cannot be cancelled |
-|  | `fetchOrder` | - | Parimutuel — no resting orders |
-|  | `fetchOpenOrders` | Y | Always `[]` (no resting orders) |
-| **Real-time** | `watchOrderBook` | E | Poll-based emulation |
-|  | `watchTrades` | E | Poll-based emulation |
-
-`createOrder` accepts only `side: 'buy'` and `type: 'market'`; `outcomeId`
-encodes the Hunch side as `"{marketId}:{side}"` where `side` is `yes`/`no` for
-binary markets or the parimutuel bucket key for N-way ladder / date-window
-markets. Bets above the $10 "simple tier" first fetch a price-locked quote.
 
 ## Compliance Policy
 - **Failure over Warning**: Tests must fail if no relevant data (markets, events, candles) is found. This ensures that we catch API breakages or unexpected empty responses.
@@ -89,7 +52,4 @@ MYRIAD_API_KEY=...
 MYRIAD_WALLET_ADDRESS=0x...
 # Metaculus (required for API access — unauthenticated requests return 403)
 METACULUS_API_TOKEN=...
-# Hunch (reads are keyless; privateKey signs the x402 USDC payment on Base)
-HUNCH_PRIVATE_KEY=0x...
-HUNCH_WALLET_ADDRESS=0x...   # optional; derived from HUNCH_PRIVATE_KEY when absent
 ```

core/scripts/generate-compliance.js

@@ -23,7 +23,7 @@ const METHOD_CATEGORIES = [
 ];
 
 // Exchange display order (skip kalshi-demo since it inherits Kalshi fully)
-const EXCHANGE_ORDER = ['polymarket', 'kalshi', 'limitless', 'probable', 'baozi', 'myriad', 'opinion', 'metaculus'];
+const EXCHANGE_ORDER = ['polymarket', 'kalshi', 'limitless', 'probable', 'baozi', 'myriad', 'opinion', 'metaculus', 'hunch'];
 
 function toDisplayName(slug) {
     return slug.split('-').map(p => p.charAt(0).toUpperCase() + p.slice(1)).join('');

core/scripts/generate-openapi.js

@@ -2462,7 +2462,7 @@ function buildSpec(methodSpecs) {
           name: 'exchange',
           schema: {
             type: 'string',
-            enum: ['polymarket', 'kalshi', 'kalshi-demo', 'limitless', 'probable', 'baozi', 'myriad', 'opinion', 'metaculus', 'smarkets', 'polymarket_us', 'gemini-titan', 'hyperliquid', 'suibets', 'rain', 'mock', 'router'],
+            enum: ['polymarket', 'kalshi', 'kalshi-demo', 'limitless', 'probable', 'baozi', 'myriad', 'opinion', 'metaculus', 'smarkets', 'polymarket_us', 'gemini-titan', 'hyperliquid', 'suibets', 'rain', 'hunch', 'mock', 'router'],
           },
           required: true,
           description: 'The prediction market exchange to target.',

core/src/server/openapi.yaml

@@ -2911,6 +2911,7 @@ components:
           - hyperliquid
           - suibets
           - rain
+          - hunch
           - mock
           - router
       required: true