vercel-build-doctor

name	vercel-build-doctor
description	Diagnose Synthex Vercel production build failures from the actual build logs, not guesses. Pulls the failed deployment's logs via the Vercel REST API, classifies the failure against a known-error table (OOM/exit 137, type-check, schema drift, module-not-found, function-size, timeout), and applies the proven fix. Use whenever a Vercel deploy shows "failure"/ERROR, the GitHub "Vercel – synthex" check is red, or someone says "we're still getting Vercel errors".
type	reference-skill
context	fork

Vercel Build Doctor

Synthex deploys to two Vercel projects under team unite-group: synthex (production) and synthex-sandbox. The GitHub commit status Vercel – synthex is the production gate. When it is red, the live site does not update. Never guess the cause — read the actual build log first.

Step 1 — Find the failed deployment

The Vercel CLI is often scoped to the wrong account (vercel projects ls returns nothing for unite-group). Use the GitHub commit status to get the deployment URL, then the REST API for logs.

# Which Vercel deploys failed, across recent main commits:
for sha in $(git log --format=%H -8 origin/main); do
   
  gh api repos/CleanExpo/Synthex/commits//status \
    | python3 -c