Seguir la letra mientras suena la canción

[Isma-L154]

!lyrics respondía con la canción entera de golpe — Rap God son 7.936
caracteres y llegaban en tres mensajes. Y era estática: no decía nada de por
dónde iba la canción.

Ahora es un solo mensaje que sigue la música, estilo karaoke.

427 tests (antes 411).

Cómo se ve

🎤 BbY WOW — KAROL G
　¿Terapia pa qué? ¿Pa qué sacarte del pecho
　Si ni queriendo yo me olvido de ti?
**▶ ¿Arreglo de qué? Yo quiero estar pecho a pecho**
　Como la noche en la que te conocí
　Hoy te vi, las ganas siguen ahí
[0:20 / 3:46]

El mismo mensaje se va editando solo mientras suena, y al pasar a la siguiente
canción carga su letra y sigue. Se detiene con el botón ⏹, con !stop, al
vaciarse la cola o si el player muere.

De dónde salen los tiempos

Genius no tiene marcas de tiempo, así que no puede hacer esto.
LRCLIB sí: gratis, sin API key, cuerpos LRC con marcas
[mm:ss.xx]. Lo comprobé contra la música que este bot reproduce de verdad
antes de construir nada — KAROL G, Bad Bunny, Queen y Eminem, todas
sincronizadas.

Las consultas mandan también la duración, que es lo que evita emparejar con
una versión en directo cuyos tiempos no cuadran con el audio que suena. Genius se
queda como respaldo para lo que LRCLIB no tenga.

Rendimiento

Dos decisiones tomadas por la caja pequeña donde corre:

• No sondea. El seguidor calcula cuándo empieza la línea siguiente y duerme
  hasta ahí, con tope de 2 s para notar pausas y saltos. Medido en el servidor:
  0,018 s de CPU en 12 segundos siguiendo la canción = 0,15% de un núcleo.
• Sin caché. Llegué a diseñarla y la quité: el seguidor solo recarga cuando
  player.current cambia de identidad, y loop track reproduce el mismo
  objeto. Nunca se habría leído.

Las ediciones van limitadas — Discord permite unas 5 por 5 s por canal y una
canción rápida cambia de línea más a menudo. El primer umbral que probé, 2,5 s,
lo cazó un test como incorrecto: al estar por encima del tope de despertar de
2 s, retrasaba cada cambio de línea normal un despertar entero, cosa que en una
letra se ve a simple vista. Quedó en 1,5 s, y hay un test que afirma que las dos
constantes mantienen ese orden.

Los efectos de velocidad habrían roto la sincronía

nightcore va a 1,25x mientras elapsed cuenta reloj de pared: la canción
avanza un cuarto más rápido que el reloj y la letra se iría desviando más cada
minuto. Así que Effect gana un campo rate, el player expone una position
que lo tiene en cuenta, y —porque un rate declarado que no case con su filtro
es peor que ninguno— un test lo mide contra FFmpeg real en vez de fiarse del
número:

assert speed_factor(effect.filter, 44100) == pytest.approx(effect.rate, rel=0.05)

El camino estático también se arregla

Es a donde caen las canciones sin tiempos, así que importa: un mensaje con
botones ◀ ▶ en lugar de varios. Y las páginas ahora cortan entre líneas —
la versión anterior troceaba cada 4000 caracteres exactos y partía palabras por
la mitad.

Dos bugs que salieron al probar contra lo real

• lyrics_api.fetch recibía un argumento loop, y el cog le pasaba
  self.bot.loop — que lanza excepción si el gateway aún no está levantado.
  El parámetro no hacía falta: dentro de una corutina get_running_loop() ya es
  la respuesta. Eliminado.
• Un payload puede traer tiempos y no traer copia en texto plano, lo que
  habría pintado una página vacía en !lyrics <busqueda>. Ahora las palabras se
  derivan de las líneas con marca.

Tests

El parser y el renderizador son funciones puras y cargan con los casos
incómodos: varias marcas en una línea ([00:10][01:20] estribillo), metadatos
[ar:], marcas desordenadas, y un hueco instrumental que debe seguir siendo un
hueco en vez de dejar la línea anterior puesta durante todo el break.

El seguidor va con un reloj guionizado, así que sus tests corren en microsegundos
y ninguno toca Discord ni la red.

Cómo probarlo

pytest       # 427

Verificado de extremo a extremo en el servidor contra el LRCLIB real: 69 líneas
para BbY WOW, la ventana correcta en cada posición, el respaldo de Genius
funcionando sin gateway, el seguidor parándose solo al destruir el player, y
ninguna sesión de aiohttp ni tarea pendiente al cerrar.

En Discord, tras desplegar:

1. !play <algo con letra> → !lyrics — un mensaje que se mueve con la canción.
2. Deja que termine y entre la siguiente — el mismo mensaje debe cambiar de letra.
3. !nightcore mientras sigue — la letra debe seguir cuadrando, no adelantarse.
4. Pulsa ⏹ — deja de moverse y se queda la última ventana.
5. !lyrics Rap God — un mensaje con ◀ ▶, no tres seguidos.
6. !lyrics zxqwvasd — "Couldn't find lyrics", sin traza.
7. !stop con el seguidor activo — debe pararse solo en menos de 2 s.

El diseño está en docs/superpowers/specs/2026-09-12-synced-lyrics-design.md.