DX-088: Generate the indexer GraphQL schema reference

[IbrahimIjai]

Context

The indexer's schema is generated by codegen and its types are gitignored
(AGENTS.md §5). A hand-written schema page would be stale within a sprint, so
this one is generated from the same source and drift-checked in CI.

Scope

• A generator producing content/reference/graphql.generated.mdx from the
  indexer's schema, with a "do not edit" banner.
• Document every type, field, query, and argument, with descriptions taken from
  schema comments so they live next to the code.
• Include example queries for the common cases: positions by account, recent
  trades, market state.
• Run indexer codegen before generating — any script compiling the indexer must
  (AGENTS.md §5).
• CI fails on drift between committed output and a fresh run.

Acceptance criteria

• Generated output matches the live schema, enforced by the CI drift check.
• Every type and field appears; count asserted against the schema.
• Example queries were executed against a local indexer and their responses
  are shown.
• The generator runs codegen first and fails clearly if it cannot.

Out of scope

• Running the indexer locally (DX-089).

---

Spec: docs/dx_1/001_docs_site.md §6 · Depends on: DX-087

[Oluwasuyi-Oluwatimilehin-Daniel]

@Oluwasuyi-Oluwatimilehin-Daniel has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hello @maintainer, I’d like to work on this issue. I have experience handling similar tasks and can start immediately. And I will deliver at the shortest possible time.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Oluwasuyi-Oluwatimilehin-Daniel to this issue.

[Oluwatomilola]

@Oluwatomilola has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

I can fix this, kindly assign.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Oluwatomilola to this issue.

[drips-wave]

Congratulations, @Oluwatomilola! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on August 31, 2026.

🧑‍💻 @Oluwatomilola: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊