chore: report missing Mintlify deployments

Author: HynLcc

.github/workflows/notify-teable-on-mintlify-deploy.yml

@@ -26,6 +26,9 @@ jobs:
           set -euo pipefail
           echo "Waiting for Mintlify staging deployment of $SHA"
           DEADLINE=$(( $(date +%s) + 720 ))
+          LAST_DEPLOYMENT_ID=""
+          LAST_DEPLOYMENT_STATE=""
+
           while [ "$(date +%s)" -lt "$DEADLINE" ]; do
             DEPS=$(curl -fsS -H "Authorization: Bearer $GH_TOKEN" -H "Accept: application/vnd.github+json" \
               "https://api.github.com/repos/$REPO/deployments?sha=$SHA&environment=staging&per_page=20")
@@ -36,39 +39,73 @@ jobs:
               print(d['id']); break
           ")
             if [ -n "$DID" ]; then
+              LAST_DEPLOYMENT_ID="$DID"
               STATE=$(curl -fsS -H "Authorization: Bearer $GH_TOKEN" -H "Accept: application/vnd.github+json" \
                 "https://api.github.com/repos/$REPO/deployments/$DID/statuses?per_page=1" \
                 | python3 -c "import json,sys;ss=json.load(sys.stdin);print(ss[0]['state'] if ss else '')")
+              LAST_DEPLOYMENT_STATE="$STATE"
               echo "deployment=$DID state=$STATE"
               case "$STATE" in
                 success)
                   ENV_URL=$(curl -fsS -H "Authorization: Bearer $GH_TOKEN" -H "Accept: application/vnd.github+json" \
                     "https://api.github.com/repos/$REPO/deployments/$DID/statuses?per_page=1" \
                     | python3 -c "import json,sys;ss=json.load(sys.stdin);print(ss[0].get('environment_url') or ss[0].get('target_url') or '')")
                   echo "docs_url=$ENV_URL" >> "$GITHUB_OUTPUT"
+                  echo "mintlify_status=success" >> "$GITHUB_OUTPUT"
+                  echo "mintlify_deployment_id=$DID" >> "$GITHUB_OUTPUT"
                   exit 0
                   ;;
                 failure|error)
                   echo "Mintlify deployment $DID failed: $STATE" >&2
-                  exit 1
+                  echo "mintlify_status=$STATE" >> "$GITHUB_OUTPUT"
+                  echo "mintlify_deployment_id=$DID" >> "$GITHUB_OUTPUT"
+                  exit 0
                   ;;
               esac
             fi
             sleep 15
           done
-          echo "Timed out waiting for Mintlify deployment of $SHA" >&2
-          exit 1
+
+          if [ -n "$LAST_DEPLOYMENT_ID" ]; then
+            echo "Timed out waiting for Mintlify deployment $LAST_DEPLOYMENT_ID to succeed; last state: ${LAST_DEPLOYMENT_STATE:-unknown}" >&2
+            echo "mintlify_status=deployment_timeout" >> "$GITHUB_OUTPUT"
+            echo "mintlify_deployment_id=$LAST_DEPLOYMENT_ID" >> "$GITHUB_OUTPUT"
+          else
+            echo "Timed out waiting for Mintlify to create a deployment for $SHA" >&2
+            echo "mintlify_status=deployment_not_created" >> "$GITHUB_OUTPUT"
+            echo "mintlify_deployment_id=" >> "$GITHUB_OUTPUT"
+          fi
 
       - name: Notify Teable webhook
+        if: always()
         env:
           TEABLE_WEBHOOK_URL: ${{ secrets.TEABLE_WEBHOOK_URL }}
           TEABLE_WEBHOOK_TOKEN: ${{ secrets.TEABLE_WEBHOOK_TOKEN }}
           DOCS_BRANCH: ${{ github.event.pull_request.head.ref }}
           DOCS_URL: ${{ steps.wait.outputs.docs_url }}
+          MINTLIFY_STATUS: ${{ steps.wait.outputs.mintlify_status }}
+          MINTLIFY_DEPLOYMENT_ID: ${{ steps.wait.outputs.mintlify_deployment_id }}
+          PR_NUMBER: ${{ github.event.pull_request.number }}
+          PR_URL: ${{ github.event.pull_request.html_url }}
+          MERGE_SHA: ${{ github.event.pull_request.merge_commit_sha }}
         run: |
           set -euo pipefail
           curl -fsS -X POST \
             "$TEABLE_WEBHOOK_URL" \
             -H "Authorization: Bearer $TEABLE_WEBHOOK_TOKEN" \
             -H "Content-Type: application/json" \
-            -d "$(jq -nc --arg b "$DOCS_BRANCH" --arg u "$DOCS_URL" '{docs_branch:$b, docs_url:$u}')"
+            -d "$(jq -nc \
+              --arg b "$DOCS_BRANCH" \
+              --arg u "$DOCS_URL" \
+              --arg s "$MINTLIFY_STATUS" \
+              --arg d "$MINTLIFY_DEPLOYMENT_ID" \
+              --arg p "$PR_NUMBER" \
+              --arg r "$PR_URL" \
+              --arg m "$MERGE_SHA" \
+              '{docs_branch:$b, docs_url:$u, mintlify_status:$s, mintlify_deployment_id:$d, pr_number:$p, pr_url:$r, merge_sha:$m}')"
+
+      - name: Fail if Mintlify did not deploy
+        if: steps.wait.outputs.mintlify_status != 'success'
+        run: |
+          echo "Mintlify did not deploy successfully: ${{ steps.wait.outputs.mintlify_status }}" >&2
+          exit 1