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

docs/KNOWN_ISSUES.md

@@ -0,0 +1,33 @@
+# Known Issues
+
+## Criticos
+
+- `generate_song` desde algunos clientes MCP puede expirar por timeout aunque Live termine la generacion.
+  Mitigacion: usar `generate_song_async` y consultar `get_generation_job_status`.
+
+- La libreria privada `libreria/reggaeton` no viaja con el repo.
+  Impacto: otra maquina sin esa libreria no va a reproducir el mismo resultado.
+
+- Los jueces Z.ai pueden responder `429 Too Many Requests`.
+  Mitigacion: el sistema cae a heuristicas locales, pero el ranking final puede perder calidad.
+
+## Importantes
+
+- `clear_all_tracks` devuelve un error blando al intentar borrar el ultimo track, aunque en la practica deja el set casi limpio.
+- La capa de automatizacion en `generate_song` quedo mas estable, pero el runtime de Live todavia no tiene una capa robusta de escritura de automatizaciones complejas.
+- El modo hibrido con dispositivos Max for Live cae a fallback si faltan:
+  - `AbletonMCP_SamplerPro.amxd`
+  - `AbletonMCP_Engine.amxd`
+
+- Algunas respuestas del runtime siguen siendo inconsistentes:
+  - `start_playback` puede reportar un estado viejo aunque `get_session_info` ya muestre `is_playing=true`.
+
+## Calidad musical
+
+- La seleccion de `atmos_fx`, `vocal_shot` y algunos FX de transicion todavia necesita mas restricciones para quedar consistentemente dentro del mismo universo sonoro.
+- La generacion actual mejora mucho con la libreria local del usuario, pero no reemplaza curaduria humana.
+- El sistema genera mejor alrededor de las zonas BPM/key realmente presentes en la libreria. Si se fuerza una tonalidad ajena al material disponible, la coherencia baja.
+
+## Publicacion
+
+- Hay scripts, configs y wrappers con paths absolutos de Windows. Son utiles para esta instalacion, pero para otras maquinas hay que adaptarlos.