Superfixer

Canon

• Rule: .cursor/rules/026-SUPERFIXER-LOOP.mdc (niet hier dupliceren; wijzigingen alleen daar + UNLOCK indien lock actief).
• Local hosts: apps/web/src/lib/system/localhost-world-dev-aliases.ts + 328-LOCAL-DEV-WORLD-HOSTS-MASTERCLASS (file slug volledig).

World-per-world

• Ja: superfix local zonder concrete URL volgt al §0e (rij-voor-rij World-plan).
• Nauwer scope: owner zegt bv. “alleen Studio” → dan alleen die host/pad uit §0e of de door owner genoemde URL; geen verplichte volledige sweep.

Console-bewijs: wat telt als “echt”

• Nut: type-check / eslint zeggen niets over hydration/chunks/runtime-console (026 §0d).
• Gate: Playwright page.on('console'|'pageerror'|5xx) op de zelfde URL die je bezoekt — zelfde allowlist als route-inventory audit (tests/e2e/console-audit-helpers.ts).
• Geen primaire gate: Cursor Simple Browser / ingebouwde tooling waar die app-code injecteert of geen betrouwbare console levert — hoogstens extra signal, geen vervanging van Playwright (325 verwijzing in 026).

Uitvoerbaar repo-pad (local)

Op jouw machine (aanbevolen)

0. Eerst uitzoomen — zie sectie hierboven (health → één smoke → dan pas breed).

1. Eén terminal — dev laten draaien (open laten):

cd <repo-root>   # map met root package.json (superfix-scripts)
npm run dev

(Poort PORT of 3000; root-script = cd apps/web && npm run dev.)

2. Tweede terminal — na groene health + één test:superfix-world-smoke op de hub: prioriteit-superfix

cd <repo-root>
npm run superfix:local-priority-consoles

3. Rapport (na afloop, ok of fail): apps/web/test-results/superfix-priority-last.md

Chunk / ReactCurrentDispatcher-ruis / 500 op /_next/static: harde reset (stopt 3000 + wist .next + webpack caches), daarna opnieuw npm run dev:

cd <repo-root>
npm run superfix:local-next

(Zelfde bedoeling als dev:clean, maar expliciet voor “MIME leeg / chunk 500”-symptomen.) Alternatief: npm run dev:clean.

(dev:clean stopt geen andere terminal — bij EADDRINUSE op 3000: dev-terminal Ctrl+C of npm run stop waar aanwezig, daarna opnieuw npm run dev.)

Agents in Cursor: zelfde volgorde; dev mag in de achtergrond i.p.v. tweede fysieke terminal. Belangrijk: niet tegelijk een Playwright-run die apps/web/.next wist terwijl die dev draait — standaard wist Playwright dat niet meer (zie apps/web/playwright.config.ts: alleen met PLAYWRIGHT_WEBSERVER_RM_NEXT=1). Preflight in de superfix-scripts gebruikt http://voices.localhost:${PORT}/ (kale 127.0.0.1 zonder etalage-Host kan in middleware blijven hangen).

Prioriteit (conversie / checkout / partner / account — eerst)

npm run superfix:local-priority-consoles

• Paden o.a. /, /cart/, /checkout/, /checkout/configurator/, /agency/contact/, /partners/, /partners/teamtel/ (concrete etalage), /partners/sample/, /partners/contact/, /account/favorieten/, /freelance/.
• Daarna optioneel de volledige world-hub sweep in dezelfde run:
  SUPERFIX_THEN_WORLD_HUBS=1 npm run superfix:local-priority-consoles

Volledige world-volgorde (026 §0e)

npm run superfix:local-world-consoles

• Stopt bij eerste Playwright-failure (console/pageerror/harde 5xx buiten allowlist).
• Overschrijf poort: PORT=3100 npm run superfix:local-world-consoles.

Triage bij ReactCurrentDispatcher / chunk-ruis op dev

• Eerst stale .next / gemixte chunks uitsluiten: npm run dev:clean (root) of root dev:clean + daarna opnieuw npm run superfix:local-world-consoles — zie 002 §31 (caching vs code) en 325 voor strakkere prod-pariteit (PLAYWRIGHT_NEXT_START=1 / full-check:prod).
• Na next build → next dev: apps/web schrijft een marker (postbuild); npm run dev wist .next automatisch vóór dev-start zodat productie-artefacten niet met dev-webpack mixen (encryption-utils / __webpack_require__).
• Dit script bewust geen allowlist voor die fout: het is een harde runtime-signalering.

Enkel één URL handmatig:

cd apps/web && \
  PLAYWRIGHT_BASE_URL=http://voices.localhost:3000 \
  SUPERFIX_GOTO_URL=http://studio.localhost:3000/ \
  npm run test:superfix-world-smoke

Agent-gedrag (kort)

• §0f: fout zichtbaar (kernregel) → fix op bron → micro-bewijs → volgende fout.
• §0b: door tot scope-af; geen owner-runner (014).
• Brede UI na wijziging: waar nodig npm run full-check:fast of test:console-audit (325).