Skip to content

Integration Diagnostics

When an integration is missing or failing, ORCA Framework should diagnose the class of failure, not just say "setup is broken."

Common Diagnostic Classes

  • not configured
  • configured in the wrong platform path
  • credential missing
  • credential present but wrong scope
  • host or harness cannot use the chosen integration method
  • expected adjacent integration missing
  • unsupported workflow for this platform

High-Value Warnings

  • Expo app without EAS but asking for build or release workflow help
  • mobile subscription path using Stripe where app-store purchases are required
  • React Native push path missing APNs or FCM configuration
  • Vercel app with env assumptions not present in the project
  • Vercel deploy failing because the inferred project slug is not lowercase (see docs/deploy/vercel-guardrails.md)
  • Supabase app with no decisions on auth, storage, or RLS