ci(docs): refresh main docs preview on push

Add a workflow that fires on docs-touching pushes to main and re-triggers Mintlify's preview for the main branch. Gives the team a persistent superdoc-main.mintlify.app URL that always reflects the current state of main, without anyone needing to open a draft PR. Production docs continue to come from docs-stable so this is purely additive.

Author: caio-pizzol

.github/workflows/refresh-main-docs-preview.yml

@@ -0,0 +1,54 @@
+# Refreshes the persistent Mintlify preview for `main` so the team can see the
+# current "next" state of the docs at superdoc-main.mintlify.app without
+# opening a draft PR. Mintlify reuses the URL per branch, so each push
+# refreshes content in place. Production docs stay on docs-stable; this is
+# unrelated to the production gate.
+name: 👀 Refresh main docs preview
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'apps/docs/**'
+      - 'packages/document-api/src/contract/**'
+      - 'scripts/generate-all.mjs'
+
+permissions:
+  contents: read
+
+concurrency:
+  group: refresh-main-docs-preview
+  cancel-in-progress: true
+
+jobs:
+  trigger-preview:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Trigger Mintlify preview for main
+        env:
+          MINTLIFY_API_KEY: ${{ secrets.MINTLIFY_API_KEY }}
+          MINTLIFY_PROJECT_ID: ${{ secrets.MINTLIFY_PROJECT_ID }}
+        run: |
+          set -euo pipefail
+          if [ -z "${MINTLIFY_API_KEY}" ] || [ -z "${MINTLIFY_PROJECT_ID}" ]; then
+            echo "MINTLIFY_API_KEY or MINTLIFY_PROJECT_ID not set; skipping."
+            exit 0
+          fi
+
+          response=$(curl -sS -X POST \
+            -H "Authorization: Bearer ${MINTLIFY_API_KEY}" \
+            -H "Content-Type: application/json" \
+            -d '{"branch": "main"}' \
+            "https://api.mintlify.com/v1/project/preview/${MINTLIFY_PROJECT_ID}")
+
+          echo "Mintlify response: ${response}"
+          preview_url=$(echo "${response}" | jq -r '.previewUrl // empty')
+
+          if [ -n "$preview_url" ]; then
+            {
+              echo "## Next docs preview refreshed"
+              echo
+              echo "URL: $preview_url"
+            } >> "$GITHUB_STEP_SUMMARY"
+          fi