feat(engagement): engagement_sessions reading-session model (#178)

[Piedra-1988]

Cierra #178 (I-F-N04-02-01).

Qué hace

Reemplaza el modelo (user_id, post_id)/link_clicked de ADR-001 por el modelo por sesión de lectura de la EPIC-N04: 1 fila por session_id con focused_seconds, max_scroll_pct y state (viewed → skimmed → read). Alinea el servidor con el cliente ya mergeado (#173).

Cambios

• supabase/migrations/20260710000000_replace_engagement_sessions_n04_schema.sql — dropea la tabla anterior y recrea engagement_sessions: session_id PK, FK post_id/user_id on delete cascade, CHECK en focused_seconds (>=0) y max_scroll_pct (0..1), enum engagement_state, 4 índices, trigger updated_at (reutiliza public.set_updated_at()), enable RLS + grant select.
• supabase/tests/rls/schema_engagement_sessions.sql — tests pgTAP (estructura, constraints, upsert por session_id, cascades de post y perfil).
• supabase/tests/rls/rls_engagement_sessions.sql — reemplazado por test de default-deny (policies reales en EPIC-S00).
• docs/adr/0003-engagement-reading-sessions.md — ADR nuevo (Aceptado; supersedes ADR-001); docs/adr/0001-engagement.md marcado como superseded.
• lib/database.types.ts — esquema de engagement_sessions + enum engagement_state actualizados.

Verificación

• pnpm supabase:test:rls → db reset aplica la migración + 19 ficheros pgTAP, 144 tests, Result: PASS.
• pnpm typecheck ✅ · pnpm lint ✅ (0 warnings).

Alcance y dependencias

• Alcance: solo tabla + enable RLS + tests SQL. Policies RLS → EPIC-S00 / I-F-S00-04-05. Edge Function → I-F-N04-02-02 — Edge Function track-engagement (UPSERT + transición viewed/engaged/clicked) #179.
• ⚠️ La migración dropea la tabla anterior → la Edge Function track-engagement actual (link_clicked, N03-04) queda rota hasta I-F-N04-02-02 — Edge Function track-engagement (UPSERT + transición viewed/engaged/clicked) #179 (on conflict (user_id, post_id) sobre columnas inexistentes).
• FK user_id → profiles(id) (literal de I-F-N04-02-01 — Tabla engagement_sessions (1 fila por session_id) con columnas link_clicked y status #178, requerido por el cascade de perfil): guarda profiles.id, no auth.uid(). I-F-N04-02-02 — Edge Function track-engagement (UPSERT + transición viewed/engaged/clicked) #179 y EPIC-S00 deben mapear auth.uid() → profiles.id.
• supabase gen types --local está bloqueado en el entorno (CLI v2.106 exige login), así que database.types.ts se actualizó a mano con la forma que generaría el CLI.

AC (#178)

• Migración up probada en local
• UPSERT on conflict (session_id) do update
• Constraints rechazan inválidos (max_scroll_pct = 1.5)
• Cascade al borrar post
• Cascade al borrar perfil
• RLS habilitado (default-deny; policies en EPIC-S00)
• Tests SQL de constraints en CI

🤖 Generated with Claude Code

[Piedra-1988]

✅ CI en verde — fallo de Markdown Lint resuelto

El único job en rojo era Markdown Lint (ADRs) (pnpm lint:md, markdownlint-cli2): 3 errores MD032/blanks-around-lists en docs/adr/0003-engagement-reading-sessions.md (líneas 54, 64, 69) — listas sin línea en blanco antes.

Fix (ddd67b4): añadida la línea en blanco previa a cada una de las tres listas. Verificado en local (pnpm lint:md → 0 errores). El resto de checks no se vieron afectados (cambio solo-markdown).

Estado de checks tras el fix

Check	Estado
Markdown Lint (ADRs)	✅ pass
Lint	✅ pass
TypeScript	✅ pass
Tests (Jest)	✅ pass
RLS Tests (Supabase)	✅ pass
Integration Tests (Supabase)	✅ pass

Toda la suite en verde; PR lista para revisión/merge.