name: pre-vercel-check description: Deploy gate: check:pre-vercel / check:pre-vercel:ci. Gebaseerd op scripts/pre-vercel-check.ts (actuele stappen + timing).

PRE-VERCEL CHECK SKILL

Ultieme drempel vóór release.

Wat het echt doet

npm run check:pre-vercel (repo root) → cd apps/web && npm run check:pre-vercel → tsx ../../scripts/pre-vercel-check.ts.

CI / één-commando parity (lint + TypeScript + build):

• Root: npm run check:pre-vercel:ci
• Of vanuit apps/web: npm run check:pre-vercel:ci (= PREFLIGHT_MODE=ci).

In scripts/pre-vercel-check.ts:

• Standaard: type-check → ESLint → Next.js build (check:build → next-build-with-retry.mjs). Prelude overslaan: PREFLIGHT_SKIP_FAST_CHECKS=1 (alleen build).
• PREFLIGHT_MODE=ci of strict: type-check → ESLint → agency-marketing + mail-legacy + public storefront URL + www-host literal audits → metadata:verify → build (ci forceert prelude; skip-flag geldt niet voor ci-mode).
• Los (backwards compatible / overrides met skip-flag):
  • PREFLIGHT_STRICT=true → altijd type-check
  • PREFLIGHT_LINT=true → altijd lint
• PREFLIGHT_MAIL_RELAY_VERIFY=1: vóór de Next-build verify:mail-relay-env:strict (Combell relay + auth in .env.local); faalt snel bij incomplete relay-env.
• PREFLIGHT_VOICEJAR_WEB_VITALS_FIELD=1 + DATABASE_URL: vóór de Next-build root npm run verify:voicejar-web-vitals-field:when-db (JSON aggregaat veld-Web Vitals; zie doc 33 §3c — strikte exit alleen als je VOICEJAR_WEB_VITALS_REPORT_STRICT=1 meegeeft).
• Per stap: duur in seconden in de log (OK in …s, totaal aan het eind).

Relay + CI-preflight in één: root npm run check:pre-vercel:ci:with-mail. Relay zonder CI-audits: npm run check:pre-vercel:with-mail (nog steeds standaard type-check + lint + relay-check + build).

Er wordt geen apart integrity-handshake.ts meer aangeroepen door dit script.

Build-retry: bij succes op poging 2 of 3 schrijft next-build-with-retry.mjs een console.warn recovery-regel (meetbare flakes / parallel .next).

Fast Lane

1. Tijdens iteratie: gerichte checks (npx eslint …, npm run type-check).
2. Macro vlak vóór commit: npm run check:pre-vercel (type-check + lint + Next build). Alleen webpack-build itereren: PREFLIGHT_SKIP_FAST_CHECKS=1 npm run check:pre-vercel.
3. CI of “alles in één” met audits: npm run check:pre-vercel:ci.

Verplichte richtlijnen

• 802-PUSH-AND-VALIDATE.mdc, 200-CODE-INTEGRITY.mdc, .cursorrules (PRE-FLIGHT MANDATE).
• Bij gate-failure: blocker - geen push.

Live console-audit: fix-on-fail (agent - niet alles op het eind)

Doel: bij elke Playwright-console-fout meteen root-cause fixen, één route hertesten, daarna weer volledig scannen - geen batch van tientallen failures eerst verzamelen.

1. Fail-fast draaien (stopt op eerste fout; standaard live = fast + desktop-mobile-light + 6 workers via scripts/live-console-audit-hosts.sh):
   • npm run full-check:live:fail-fast
   • Of zelf: PLAYWRIGHT_MAX_FAILURES=1 npm run full-check:live
2. Uit output halen: testtitel bevat clean console on <route> en profiel (desktop-light / mobile-light, …).
3. Fix in code/config (allowlist alleen als de fout echt verwachte ruis is - liever echte fix).
4. Hertest enkel die route (snel):

   cd apps/web && CONSOLE_AUDIT_SCOPE=extended CONSOLE_AUDIT_SPEED=fast CONSOLE_AUDIT_PROFILES=desktop-mobile-light \
     PLAYWRIGHT_BASE_URL=https://www.voices.be \
     npx playwright test tests/e2e/console-audit.spec.ts --grep 'clean console on /jouw/pad' --workers=1
   

   Pas het grep-patroon aan op het pad (speciale tekens escapen in regex waar nodig).
5. Opnieuw npm run full-check:live:fail-fast tot groen; daarna optioneel npm run full-check:live (zelfde host) voor volledige sweep zonder vroege stop.

Strengere parity met lokale full-check (langzamer): CONSOLE_AUDIT_SPEED=thorough CONSOLE_AUDIT_PROFILES=all PLAYWRIGHT_LIVE_WORKERS=2 PLAYWRIGHT_MAX_FAILURES= npm run full-check:live.