Sync: Complete project state with all MEGA SPRINT V1-V3 features and Codex stubs

docs/TODO.md

@@ -0,0 +1,34 @@
+# TODO
+
+## Alta prioridad
+
+- Implementar backoff, retry y cache local para los jueces Z.ai.
+- Endurecer seleccion de `atmos_fx`, `vocal_shot`, `fill_fx` y `snare_roll` con reglas por duracion, folder family y contexto seccional.
+- Dejar `generate_song` completamente no bloqueante para clientes MCP y reducir el uso de operaciones largas en una sola respuesta.
+- Crear una limpieza de sesion confiable:
+  - nuevo set o reset real
+  - borrado limpio de tracks
+  - reinicio consistente de scenes
+
+## Produccion musical
+
+- Mejorar el motor ritmico de dembow con extraccion real de groove desde loops de referencia.
+- Hacer render corto + critica + reroll por seccion.
+- Usar scoring de parejas `bass + music + vocal + fx`, no solo ranking por rol individual.
+- Unificar mejor la seleccion de atmosfera con el mismo pack musical principal.
+
+## Runtime Ableton
+
+- Implementar una capa real de automatizacion de volumen, filtros y reverb en el runtime.
+- Limpiar respuestas viejas del transporte para `start_playback` y comandos parecidos.
+- Consolidar `abletonmcp_init.py` y `abletonmcp_runtime.py` para no duplicar fixes.
+
+## Repo y DX
+
+- Reemplazar configs absolutas por ejemplos templatable donde convenga.
+- Agregar tests para:
+  - `pack_brain`
+  - jobs async
+  - scoring de libreria
+  - persistencia de manifests
+- Documentar instalacion desde cero en una maquina sin estado previo.