fix: add retry logic to artifact search to handle race conditions (#317)

Added exponential backoff retry logic to the determine-artifact.sh script
to handle race conditions where the Publish workflow starts before GitHub's
API has indexed the completed Main workflow run.

Changes:
- Retry up to 5 times with increasing delays (5s, 10s, 15s, 20s, 25s)
- Total retry window of ~75 seconds
- Clear logging of retry attempts

This fixes the issue where releases fail because:
1. Main workflow creates GitHub release
2. Release event triggers Publish workflow immediately
3. Publish workflow queries for Main workflow run
4. GitHub API hasn't yet indexed the just-completed workflow
5. Query returns empty results even though workflow succeeded

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude <[email protected]>

Author: sapientpants

.changeset/fix-artifact-search-retry.md

@@ -0,0 +1,10 @@
+---
+'sonarqube-mcp-server': patch
+---
+
+Fix race condition in artifact determination script
+
+- Add retry logic with exponential backoff to determine-artifact.sh
+- Wait up to 5 attempts with increasing delays (5s, 10s, 15s, 20s, 25s)
+- Fixes race condition where Publish workflow starts before Main workflow is indexed by GitHub API
+- Total retry window: ~75 seconds, giving GitHub's API time to index completed workflow runs

.github/scripts/determine-artifact.sh

@@ -115,24 +115,44 @@ PARENT_SHA=$(echo "$PARENT_BODY" | jq -r '.parents[0].sha')
 echo "📌 Parent commit (build trigger): $PARENT_SHA"
 
 # Find the workflow run that created the release artifacts
+# Retry with exponential backoff to handle race conditions
 RUNS_API_URL="https://api.github.com/repos/$REPO/actions/runs?head_sha=$PARENT_SHA&status=success&event=push"
 echo "🔍 Searching for successful workflow runs for parent commit $PARENT_SHA"
 
-RUNS_RESPONSE=$(curl -s -H "Authorization: Bearer $GITHUB_TOKEN" -w "\n%{http_code}" $RUNS_API_URL)
-RUNS_BODY=$(echo "$RUNS_RESPONSE" | head -n -1)
-RUNS_STATUS=$(echo "$RUNS_RESPONSE" | tail -n 1)
+MAX_RETRIES=5
+RETRY_COUNT=0
+MAIN_RUN=""
 
-if [ "$RUNS_STATUS" != "200" ]; then
-  echo "❌ Failed to fetch workflow runs with status $RUNS_STATUS"
-  echo "Response: $RUNS_BODY"
-  exit 1
-fi
+while [ $RETRY_COUNT -lt $MAX_RETRIES ] && [ -z "$MAIN_RUN" ]; do
+  if [ $RETRY_COUNT -gt 0 ]; then
+    WAIT_TIME=$((5 * RETRY_COUNT))
+    echo "⏳ Waiting ${WAIT_TIME}s before retry $RETRY_COUNT/$MAX_RETRIES..."
+    sleep $WAIT_TIME
+  fi
+
+  RUNS_RESPONSE=$(curl -s -H "Authorization: Bearer $GITHUB_TOKEN" -w "\n%{http_code}" $RUNS_API_URL)
+  RUNS_BODY=$(echo "$RUNS_RESPONSE" | head -n -1)
+  RUNS_STATUS=$(echo "$RUNS_RESPONSE" | tail -n 1)
+
+  if [ "$RUNS_STATUS" != "200" ]; then
+    echo "❌ Failed to fetch workflow runs with status $RUNS_STATUS"
+    echo "Response: $RUNS_BODY"
+    exit 1
+  fi
+
+  # Find the Main workflow run
+  MAIN_RUN=$(echo "$RUNS_BODY" | jq -r '.workflow_runs[] | select(.name == "Main") | {id: .id, created_at: .created_at}')
 
-# Find the Main workflow run
-MAIN_RUN=$(echo "$RUNS_BODY" | jq -r '.workflow_runs[] | select(.name == "Main") | {id: .id, created_at: .created_at}')
+  if [ -z "$MAIN_RUN" ]; then
+    RETRY_COUNT=$((RETRY_COUNT + 1))
+    if [ $RETRY_COUNT -lt $MAX_RETRIES ]; then
+      echo "⚠️  Main workflow not found yet (attempt $RETRY_COUNT/$MAX_RETRIES)"
+    fi
+  fi
+done
 
 if [ -z "$MAIN_RUN" ]; then
-  echo "❌ No successful Main workflow run found for parent commit $PARENT_SHA"
+  echo "❌ No successful Main workflow run found for parent commit $PARENT_SHA after $MAX_RETRIES attempts"
   echo "Available runs:"
   echo "$RUNS_BODY" | jq -r '.workflow_runs[] | "\(.name): \(.id) (\(.status))"'
   exit 1