chore: debug-realtime tooling for SSE pipeline diagnostics (#20)

* chore(debug): add /debug-realtime page + bare SSE endpoint

Tijdelijke debug-tooling voor M8-acceptance op Vercel preview.

- app/api/debug/realtime-stream/route.ts — geen auth, geen filtering;
  dropt elke pg_notify-event op scrum4me_changes rauw door als SSE
- app/debug-realtime/page.tsx — open zonder login op de root, toont
  binnenkomende events in een simpele <table>

Doel: isoleren of de SSE + Postgres LISTEN-pipe op Vercel überhaupt
events laat zien, los van iron-session, productfilter of solo-store.
Als ook deze niets binnen krijgt: probleem zit in pg connection of
Vercel function lifecycle. Als deze wel events toont: probleem zit
hoger in de stack (filter, store, hook).

VERWIJDEREN voordat de PR uit draft gaat.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* chore(debug): extend /debug-realtime with stats, emit-button and filters

Bouwt de basale luister-tabel uit met diagnostische tooling om de
SSE+LISTEN-pipe stress-vrij te kunnen valideren.

Toegevoegd:
- POST /api/debug/emit-test-notify — vuurt een handmatige pg_notify
  op scrum4me_changes met een synthetic payload (debug:true) zonder
  een echte DB-UPDATE te doen. Isoleert de SSE-route van Prisma/triggers.
- DebugRealtimeClient: stats-grid (status, reconnects, total events,
  since last event met >30s rood-warning, largest gap, first-event-
  time), emit-button, reset-stats, filters op type en entity
  (incl. "debug only").
- Type/entity kolom in de tabel met kleuring per type.

Geen impact op productie- of solo-flow. Tijdelijke testtooling;
verwijderen wanneer we deze pagina niet meer nodig hebben.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* chore(debug): add Layer 2 — mini Zustand-store + dispatch toggles

Test of SSE-event → store → render-pipeline werkt buiten de Solo
Paneel context. Mirrort het patroon van solo-store maar minimaal.

- debug-store.ts: kleine Zustand-store met tasks + applyEvent +
  applyCount/skipCount-tellers
- store-panel.tsx: rendert store-state in een tabel met statuskleuring
- client.tsx: drie layer-toggles (dispatch / flushSync / startView-
  Transition) + lift dispatch in onmessage. Zo kunnen we elke
  combinatie isoleren

Bevestigd: alle drie de toggles werken op het bare /debug-realtime
endpoint. Volgende laag is Server Action revalidation.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

app/api/debug/emit-test-notify/route.ts

@@ -0,0 +1,59 @@
+// TIJDELIJKE debug-endpoint. Stuurt een handmatige pg_notify op
+// `scrum4me_changes` zonder een echte UPDATE te doen. Bedoeld om de
+// SSE-pipe te testen los van Prisma/triggers.
+//
+// VERWIJDEREN voor M8 out-of-draft.
+
+import { Client } from 'pg'
+
+export const runtime = 'nodejs'
+export const dynamic = 'force-dynamic'
+
+const CHANNEL = 'scrum4me_changes'
+
+export async function POST(request: Request) {
+  const directUrl = process.env.DIRECT_URL ?? process.env.DATABASE_URL
+  if (!directUrl) {
+    return Response.json({ error: 'DIRECT_URL/DATABASE_URL niet gezet' }, { status: 500 })
+  }
+
+  let body: unknown = null
+  try {
+    body = await request.json()
+  } catch {
+    // empty body is OK — we vullen defaults in
+  }
+
+  const overrides = (body && typeof body === 'object' ? body : {}) as Record<string, unknown>
+  const payload = {
+    op: 'U',
+    entity: 'task',
+    id: `debug-${Date.now()}`,
+    story_id: 'debug-story',
+    product_id: 'debug-product',
+    sprint_id: null,
+    assignee_id: null,
+    task_status: 'TO_DO',
+    task_sort_order: 1,
+    task_title: 'manual debug emit',
+    changed_fields: ['status'],
+    debug: true,
+    emitted_at: new Date().toISOString(),
+    ...overrides,
+  }
+
+  const client = new Client({ connectionString: directUrl })
+  try {
+    await client.connect()
+    // pg_notify met JSON-string als payload — zelfde formaat als de trigger
+    await client.query('SELECT pg_notify($1, $2)', [CHANNEL, JSON.stringify(payload)])
+    return Response.json({ ok: true, payload })
+  } catch (err) {
+    return Response.json(
+      { ok: false, error: err instanceof Error ? err.message : String(err) },
+      { status: 500 },
+    )
+  } finally {
+    try { await client.end() } catch {}
+  }
+}