feat: automate OpenAPI spec sync with endpoint filtering (#132)

Adds `scripts/sync-openapi.ts` that fetches upstream `openapi.json` from
js-recall main and filters it for public docs.

## Filtering approach

Uses **tag-based filtering** to exclude internal endpoints. Operations
tagged with blocked tags are removed, and paths that become empty after
filtering are excluded entirely.

### Blocked tags
- `Admin` - admin endpoints
- `User` - user dashboard endpoints  
- `NFL` - NFL prediction game endpoints

## Implementation details

- Uses `@apidevtools/swagger-parser` for robust OpenAPI spec parsing and
validation
- Source URL configured via `OPENAPI_SOURCE_URL` environment variable
- Filters at the operation level, preserving path metadata for remaining
operations

## Build pipeline

`build:openapi` now runs sync → generate → prettier in sequence.

Author: derrekcoleman

.env.example

@@ -1,3 +1,4 @@
 OPENAI_API_KEY=your_openai_api_key # Only used for generating embeddings or AI search
 NEXT_PUBLIC_SITE_URL=https://docs.recall.network # Only for production
-NEXT_PUBLIC_GA_ID=your_google_analytics_id # Only for production
+NEXT_PUBLIC_GA_ID=your_google_analytics_id # Only for production
+OPENAPI_SOURCE_URL=https://raw.githubusercontent.com/recallnet/js-recall/main/apps/api/openapi/openapi.json # Used by sync-openapi script

docs/reference/endpoints/agent.mdx

@@ -1,6 +1,6 @@
 ---
 title: Agent
-description: Agent management endpoints for a single agent to interact with
+description: Agent management endpoints
 full: true
 _openapi:
   toc: []

docs/reference/endpoints/agents.mdx

@@ -1,6 +1,6 @@
 ---
 title: Auth
-description: Authentication endpoints for verifying agent wallet ownership
+description: Authentication endpoints
 full: true
 _openapi:
   toc: []

docs/reference/endpoints/arenas.mdx

@@ -1,13 +1,16 @@
 ---
 title: Competition
-description: Get information about or interact with a competition
+description: Competition endpoints
 full: true
 _openapi:
   toc: []
   structuredData:
     headings: []
     contents:
       - content: Get all competitions
+      - content: >-
+          Get the competition rules including trading constraints, rate limits, and formulas for a
+          specific competition
       - content: >-
           Get detailed information about a specific competition including all metadata
       - content: >-
@@ -20,9 +23,6 @@ _openapi:
 
           while preserving historical participation data. Note: Cannot leave competitions that have
           already ended.
-      - content: >-
-          Get the competition rules including trading constraints, rate limits, and formulas for a
-          specific competition
       - content: Get the timeline for all agents in a competition
       - content: >-
           Get all trades for a specific competition. Only available for paper trading competitions.
@@ -50,11 +50,11 @@ _openapi:
   document={"specs/competitions.json"}
   operations={[
     { path: "/api/competitions", method: "get" },
+    { path: "/api/competitions/{competitionId}/rules", method: "get" },
     { path: "/api/competitions/{competitionId}", method: "get" },
     { path: "/api/competitions/{competitionId}/agents", method: "get" },
     { path: "/api/competitions/{competitionId}/agents/{agentId}", method: "post" },
     { path: "/api/competitions/{competitionId}/agents/{agentId}", method: "delete" },
-    { path: "/api/competitions/{competitionId}/rules", method: "get" },
     { path: "/api/competitions/{competitionId}/timeline", method: "get" },
     { path: "/api/competitions/{competitionId}/trades", method: "get" },
     { path: "/api/competitions/{competitionId}/agents/{agentId}/trades", method: "get" },

docs/reference/endpoints/auth.mdx

@@ -1,6 +1,6 @@
 ---
 title: Health
-description: Health check endpoints to ensure the API is running
+description: Health check endpoints
 full: true
 _openapi:
   toc: []

docs/reference/endpoints/competition.mdx

@@ -1,6 +1,6 @@
 ---
 title: Price
-description: Price information endpoints for fetching token prices
+description: Price information endpoints
 full: true
 _openapi:
   method: GET

docs/reference/endpoints/health.mdx

@@ -1,6 +1,6 @@
 ---
 title: Trade
-description: Trading endpoints for executing trades as part of a competition
+description: Trading endpoints
 full: true
 _openapi:
   toc: []