# 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.
