Skip to content

ci: upgrade Claude orchestrator to v2.1.0 — graceful API unavailability skip#35336

Merged
sfreudenthaler merged 1 commit intomainfrom
feat/35328-graceful-claude-api-skip
Apr 15, 2026
Merged

ci: upgrade Claude orchestrator to v2.1.0 — graceful API unavailability skip#35336
sfreudenthaler merged 1 commit intomainfrom
feat/35328-graceful-claude-api-skip

Conversation

@sfreudenthaler
Copy link
Copy Markdown
Member

Summary

  • Bump ai-workflows reference from v2.0.0v2.1.0 in ai_claude-orchestrator.yml
  • v2.1.0 adds pre-flight Anthropic API availability check + runtime error triage

Problem

When the Claude service has an outage, all PR pipelines fail with:

API Error: 500 {"type":"error","error":{"type":"api_error","message":"Internal server error"}} · check status.claude.com

Example blocked run: https://github.com/dotCMS/core/actions/runs/24461196854

What changed in v2.1.0 (ai-workflows)

Pre-flight check (Layer 1):

  • Calls GET /v1/models before running claude-code-action (15s timeout, 2 retries)
  • 5xx or network failure → available=false → skip Claude step gracefully with ::warning::
  • 401/403/429 or other codes → proceed so the action surfaces the specific error

Runtime protection (Layer 2):

  • continue-on-error: true on the Claude step
  • Post-execution step re-checks the API if Claude failed
  • API available after failure → re-fail the job ("legitimate error")
  • API unavailable after failure → skip gracefully ("service degradation")

Test

Validated in dotCMS#460 (also updated to v2.1.0):

  • Pre-flight check correctly identifies API availability
  • Legitimate errors still surface and fail the job (correct)
  • Service outage path is code-correct (pre-flight would skip before Claude runs)

Fixes #35328

Bump ai-workflows from v2.0.0 to v2.1.0. The new version adds:
- Pre-flight check of the Anthropic API before running claude-code-action
- Graceful skip with warning when API returns 5xx or is unreachable
- Belt-and-suspenders: continue-on-error + post-check distinguishes
  service outages from legitimate failures

Fixes #35328

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@sfreudenthaler sfreudenthaler added this pull request to the merge queue Apr 15, 2026
Merged via the queue into main with commit fc12f6b Apr 15, 2026
26 of 28 checks passed
@sfreudenthaler sfreudenthaler deleted the feat/35328-graceful-claude-api-skip branch April 15, 2026 19:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Area : CI/CD PR changes GitHub Actions/workflows

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

CI/CD: Skip Claude AI Orchestrator step when Claude service is unavailable

2 participants