Troubleshooting
Run doctor first:
npx prodverdict doctor --format agent
Access contract
| Symptom | Fix |
|---|---|
STRIPE_SECRET_KEY required | Set read-only Stripe key in env or GitHub secrets |
DATABASE_URL required | Set read-only Postgres URL |
CONNECTOR_ERROR on DB | Use a read-only DB role; verify network from CI |
| Wrong findings / no users | Check users_table and columns in prodverdict.yml |
| Paddle app | Use source_of_truth: paddle and PADDLE_API_KEY |
Config contract
| Symptom | Fix |
|---|---|
| Missing env in CI | Add secret to GitHub Actions / Vercel; update .env.example |
| False positives | Add var names to ignore_vars in config contract |
General
| Symptom | Fix |
|---|---|
| Exit code 2 | Invalid prodverdict.yml — run npx prodverdict validate |
Exit code 1 with --strict | WARN findings treated as fail — fix medium findings or drop --strict |
| Fixture mode | Use --fixtures for demos without live credentials |