chore: publish current ableton mcp ai workspace

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.

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.