feat(engine): auto-free disk space with retention + hard cap

[jodacame]

Qué hace

En modo disco, el espacio ya no se llena: lo que deja de ser necesario se borra, y la carpeta de descargas queda acotada por un tope configurable (el análogo en disco del ring buffer de RAM).

Política (internal/engine/janitor.go)

• retire() — torrent que ya no se necesita:
  • Privado → borrado inmediato (su ratio/tiempo del tracker ya fue su ventana).
  • Público → se saca de activos pero se conserva en disco con PendingDeleteAt = ahora + gracia; si el espectador vuelve, reanuda al instante desde los archivos retenidos.
• Loop janitor (cada 30 s): borra lo pendiente cuando pasa la ventana; si se supera Disk.MaxGB, desaloja lo más viejo primero (el tope duro manda sobre la gracia).
• Nunca toca lo que se está viendo (readers>0) ni lo que seedea hacia un objetivo vivo.

Disparadores conectados

Evento	Antes	Ahora
Seed cumple ratio/tiempo	Drop (dejaba archivo)	→ retire (deleteAfterSeed)
Fin de reproducción / idle en disco	Drop (dejaba archivo)	→ retire (deleteAfterPlayback)
Re-añadir un torrent pendiente	—	rescate: limpia el flag y reanuda

Guardas de seguridad (borrado automático)

• Rechaza nombre vacío (evita borrar toda la carpeta) y path traversal por nombre malicioso (safeDataPath).
• Borra solo records en modo disco.
• El borrado manual "con archivos" pasa por la misma guarda.

Ajustes (en Settings, editables en la UI — no env)

disk.maxGB, disk.graceMinutes, disk.deleteAfterSeed, disk.deleteAfterPlayback. TorrentRecord gana PendingDeleteAt.

Verificación

• Tests nuevos: guardas de safeDataPath (rechaza ../../etc y vacío), dirSize, orden de evictKey, deleteRecordFiles. Backend go build+vet+test en verde; frontend tsc+vite build OK.
• En vivo (contenedor modo disco): boot OK, GET/PUT /api/settings exponen y persisten el bloque disk, maxGB=-3 normaliza a 0, sin panics, janitor corriendo.

Nota de garantía

Con esto: se conserva solo lo activo o con seed vivo; lo demás se limpia (con colchón de gracia para reanudar sin re-descargar); y el disco nunca supera disk.maxGB.

🤖 Generated with Claude Code