Add documentation and examples for GraphQL run command

Add comprehensive examples showing different ways to use the
'mina internal graphql run' command:

- Simple query execution from command line
- Query input from stdin (for piping from other commands)
- Query input from file (for complex .graphql files)
- Query with variables (for parameterized queries)
- Query execution on remote nodes (via --node flag)

The documentation explains all three input methods and their
combinations with optional flags for variables and custom endpoints.

Author: dannywillems

website/docs/developers/graphql-api.md

@@ -93,7 +93,12 @@ MutationSendZkapp from
 GraphqlList from "!!raw-loader!./scripts/cli/graphql-list.sh"; import
 GraphqlInspect from "!!raw-loader!./scripts/cli/graphql-inspect.sh"; import
 GraphqlInspectRemote from
-"!!raw-loader!./scripts/cli/graphql-inspect-remote.sh";
+"!!raw-loader!./scripts/cli/graphql-inspect-remote.sh"; import GraphqlRunSimple
+from "!!raw-loader!./scripts/cli/graphql-run-simple.sh"; import GraphqlRunStdin
+from "!!raw-loader!./scripts/cli/graphql-run-stdin.sh"; import GraphqlRunFile
+from "!!raw-loader!./scripts/cli/graphql-run-file.sh"; import
+GraphqlRunVariables from "!!raw-loader!./scripts/cli/graphql-run-variables.sh";
+import GraphqlRunRemote from "!!raw-loader!./scripts/cli/graphql-run-remote.sh";
 
 # GraphQL API Reference
 
@@ -775,6 +780,60 @@ To inspect an endpoint on a remote node:
   {GraphqlInspectRemote}
 </CodeBlock>
 
+#### Run GraphQL Queries
+
+Execute arbitrary GraphQL queries directly from the CLI:
+
+##### Simple query
+
+<CodeBlock language="bash" title="website/docs/developers/scripts/cli/graphql-run-simple.sh">
+  {GraphqlRunSimple}
+</CodeBlock>
+
+This executes the query and returns the formatted JSON response.
+
+##### Query from stdin
+
+<CodeBlock language="bash" title="website/docs/developers/scripts/cli/graphql-run-stdin.sh">
+  {GraphqlRunStdin}
+</CodeBlock>
+
+Useful for piping queries from other commands or scripts.
+
+##### Query from file
+
+<CodeBlock language="bash" title="website/docs/developers/scripts/cli/graphql-run-file.sh">
+  {GraphqlRunFile}
+</CodeBlock>
+
+Convenient for complex queries stored in `.graphql` files.
+
+##### Query with variables
+
+<CodeBlock language="bash" title="website/docs/developers/scripts/cli/graphql-run-variables.sh">
+  {GraphqlRunVariables}
+</CodeBlock>
+
+Variables must be provided as a JSON object. This allows parameterized queries
+for dynamic values.
+
+##### Query remote node
+
+<CodeBlock language="bash" title="website/docs/developers/scripts/cli/graphql-run-remote.sh">
+  {GraphqlRunRemote}
+</CodeBlock>
+
+The `run` command supports three input methods:
+
+- **Command line argument**: Pass the query directly as an argument
+- **Standard input**: Pipe or redirect queries from stdin
+- **File input**: Use `-f` flag to read from a `.graphql` file
+
+You can combine any input method with:
+
+- `-v` or `--variables`: Pass variables as JSON string
+- `--node`: Specify a custom GraphQL endpoint URL
+
 These tools are particularly useful for:
 
 - Learning available endpoints without reading documentation

website/docs/developers/scripts/cli/graphql-run-file.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+# Execute a GraphQL query from a file
+mina internal graphql run -f query.graphql

website/docs/developers/scripts/cli/graphql-run-remote.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+# Execute a GraphQL query on a remote node
+mina internal graphql run \
+  'query { syncStatus }' \
+  --node http://remote-node:3000/graphql

website/docs/developers/scripts/cli/graphql-run-simple.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+# Execute a simple GraphQL query
+mina internal graphql run 'query { syncStatus }'

website/docs/developers/scripts/cli/graphql-run-stdin.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+# Execute a GraphQL query from stdin
+echo 'query { version }' | mina internal graphql run

website/docs/developers/scripts/cli/graphql-run-variables.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+# Execute a GraphQL query with variables
+mina internal graphql run \
+  'query($maxLen: Int!) { bestChain(maxLength: $maxLen) { stateHash } }' \
+  -v '{"maxLen": 5}'