fix(generator): stop re-injecting self-hosted Trading group on auto-publish (2.49.6)

ENDPOINT_GROUPS in scripts/generate-mintlify-docs.js was manufacturing
a parallel 'Trading' + 'Orders & Positions' group from openapi.json on
every release auto-publish, producing duplicate sidebar groups with
'Local Only' badges alongside the canonical hosted groups. Removed the
matchers and added the self-hosted Group A opIds to HIDDEN_OPERATIONS.
Cleaned the two stale duplicate groups left behind in docs.json by the
2.49.5 auto-publish.

Author: realfishsam

changelog.md

@@ -2,6 +2,15 @@
 
 All notable changes to this project will be documented in this file.
 
+## [2.49.6] - 2026-06-09
+
+Generator-side hotfix for a regression introduced by the v2.49.5 auto-publish: the `generate:mintlify` step (`scripts/generate-mintlify-docs.js`, run by `.github/workflows/publish.yml` on every release tag) was re-injecting self-hosted Group A endpoints as a duplicate `"Trading"` group (with `"Local Only"` badges) into `docs.json`'s API Reference tab, sitting alongside the canonical hosted `"Trading"` group that this release line had just renamed and cleaned up. Result: every release pushed two same-named groups into the rendered sidebar.
+
+### Fixed
+
+- **`scripts/generate-mintlify-docs.js`**: Removed the hardcoded `"Trading"` and `"Orders & Positions"` entries from the `ENDPOINT_GROUPS` matcher array — the generator no longer manufactures those groups from the self-hosted `openapi.json`. Added the matching self-hosted operation ids (`createOrder`, `buildOrder`, `submitOrder`, `cancelOrder`, `editOrder`, `fetchOrder`, `fetchOpenOrders`, `fetchClosedOrders`, `fetchAllOrders`, `fetchMyTrades`, `fetchPositions`, `fetchBalance`, `fetchOrderHistory`) to the `HIDDEN_OPERATIONS` set so they don't fall through to the `"Other"` bucket either. Net effect: the next auto-publish keeps the manually-curated hosted `"Trading"` + `"Orders & Positions"` groups (rendered from `openapi-hosted-trading.json`) and never re-adds the self-hosted equivalents. Self-hosters who want the full reference still consume `openapi.json` directly or reach it via `/guides/self-hosted`.
+- **`docs/docs.json`**: Removed two stale duplicate groups (`"Trading (Hosted)"`, `"Orders & Positions (Hosted)"`) that the 2.49.5 auto-publish had left behind after the rename. The generator is now idempotent — regenerating produces a stable group list.
+
 ## [2.49.5] - 2026-06-09
 
 Sidebar cleanup: drop "(Hosted)" suffixes everywhere and hide the parallel self-hosted Group A reference. The hosted endpoints are now the only Group A surface in the sidebar; the API reference reads as "Trading → Create Order" instead of "Trading (Hosted) → Create Order (Hosted)."

docs/docs.json

@@ -171,29 +171,6 @@
             ],
             "openapi": "api-reference/openapi.json"
           },
-          {
-            "group": "Trading",
-            "pages": [
-              "POST /api/{exchange}/createOrder",
-              "POST /api/{exchange}/buildOrder",
-              "POST /api/{exchange}/submitOrder",
-              "POST /api/{exchange}/cancelOrder"
-            ],
-            "openapi": "api-reference/openapi.json"
-          },
-          {
-            "group": "Orders & Positions",
-            "pages": [
-              "GET /api/{exchange}/fetchOrder",
-              "GET /api/{exchange}/fetchOpenOrders",
-              "GET /api/{exchange}/fetchMyTrades",
-              "GET /api/{exchange}/fetchClosedOrders",
-              "GET /api/{exchange}/fetchAllOrders",
-              "GET /api/{exchange}/fetchPositions",
-              "GET /api/{exchange}/fetchBalance"
-            ],
-            "openapi": "api-reference/openapi.json"
-          },
           {
             "group": "Realtime",
             "pages": [
@@ -248,27 +225,6 @@
               "GET /v0/user/{address}/balances"
             ]
           },
-          {
-            "group": "Trading (Hosted)",
-            "openapi": "api-reference/openapi-hosted-trading.json",
-            "pages": [
-              "POST /v0/trade/create-order",
-              "POST /v0/trade/build-order",
-              "POST /v0/trade/submit-order",
-              "POST /v0/orders/cancel/build"
-            ]
-          },
-          {
-            "group": "Orders & Positions (Hosted)",
-            "openapi": "api-reference/openapi-hosted-trading.json",
-            "pages": [
-              "GET /v0/orders/{order_id}",
-              "GET /v0/orders/open",
-              "GET /v0/user/{address}/trades",
-              "GET /v0/user/{address}/positions",
-              "GET /v0/user/{address}/balances"
-            ]
-          },
           {
             "group": "Enterprise",
             "openapi": "api-reference/openapi-hosted.json",

scripts/generate-mintlify-docs.js

@@ -162,20 +162,13 @@ const ENDPOINT_GROUPS = [
                 opId
             ),
     },
-    {
-        name: 'Trading',
-        match: (opId) =>
-            /^(createOrder|buildOrder|submitOrder|cancelOrder|editOrder)$/.test(
-                opId
-            ),
-    },
-    {
-        name: 'Orders & Positions',
-        match: (opId) =>
-            /^(fetchOrder|fetchOpenOrders|fetchClosedOrders|fetchAllOrders|fetchMyTrades|fetchPositions|fetchBalance|fetchOrderHistory)$/.test(
-                opId
-            ),
-    },
+    // "Trading" and "Orders & Positions" groups are intentionally NOT
+    // generated from the self-hosted openapi.json spec. The canonical
+    // surfaces for those endpoints are the hosted groups in docs.json
+    // (preserved via the `otherExternalGroups` path below) which render
+    // from openapi-hosted-trading.json. Auto-generating the self-hosted
+    // equivalents here would produce two same-named groups in the API
+    // Reference sidebar (one with "Local Only" badges, one without).
     {
         name: 'Realtime',
         match: (opId) => /^(watch|unwatch)/.test(opId),
@@ -225,6 +218,27 @@ const HIDDEN_OPERATIONS = new Set([
     'fetchEventMatches',
     'fetchMarketMatches',
     'testDummyMethod',
+    // Self-hosted Group A endpoints (`/api/{exchange}/createOrder`, etc.)
+    // are intentionally hidden from the auto-generated sidebar. The
+    // canonical "Trading" + "Orders & Positions" surfaces are the hosted
+    // groups in docs.json that render from openapi-hosted-trading.json.
+    // Auto-generating self-hosted equivalents would produce two same-named
+    // groups (one with "Local Only" badges, one without). Self-hosters
+    // still get the spec at docs/api-reference/openapi.json and reach the
+    // endpoints via /guides/self-hosted.
+    'createOrder',
+    'buildOrder',
+    'submitOrder',
+    'cancelOrder',
+    'editOrder',
+    'fetchOrder',
+    'fetchOpenOrders',
+    'fetchClosedOrders',
+    'fetchAllOrders',
+    'fetchMyTrades',
+    'fetchPositions',
+    'fetchBalance',
+    'fetchOrderHistory',
 ]);
 
 // Convert an operationId to its expected MDX file path (docs-relative,