ableton-mcp-ai/docs/SPRINT_v0.1.3_NEXT.md

Sprint v0.1.3 - Continuacion Real Despues Del Consolidado

Fecha: 2026-03-30

Este sprint reemplaza a docs/SPRINT_v0.1.2_NEXT.md como sprint activo.

Si eres Kimi K2:

• lee este archivo despues de KIMI_K2_ACTIVE_HANDOFF.md
• no asumas que docs/CONSOLIDADO_v0.1.1_v0.1.2_PARA_CODEX.md es exacto en todo
• valida siempre contra diffs, codigo activo y runtime

Lo que se reviso

Se comparo:

• docs/CONSOLIDADO_v0.1.1_v0.1.2_PARA_CODEX.md
• git diff --stat
• git diff --name-only
• codigo activo en sample_selector.py, server.py, groove_extractor.py, abletonmcp_init.py

Lo que del consolidado si esta bien

• clear_all_tracks existe en el runtime activo y los tests ad hoc pasan
• zai_judges.py existe y esta integrado en server.py
• groove_extractor.py ahora escanea recursivamente
• temp\smoke_test_async.py existe
• sample_selector.py tiene estructuras nuevas para same-pack, section context y joint scoring

Lo que el consolidado sobrevendio o no dijo bien

1. "Codigo implementado 100%"

Eso es falso.

Hay codigo nuevo, pero no todo esta cableado al flujo real.

2. "Selector por seccion implementado"

Esto esta incompleto.

Hecho real:

• sample_selector.py tiene set_section_context()
• tiene SECTION_ROLE_PROFILES
• tiene JOINT_SCORING_GROUPS

Problema real:

• no hay llamadas desde server.py ni desde el flujo principal que seteen self._section_context
• por lo tanto, la logica por seccion y joint scoring esta mayormente muerta hoy

3. Regresion real que el consolidado no reporto

sample_selector.py quedo roto por merge:

• desaparecio el metodo _calculate_repetition_penalty
• su cuerpo quedo colgado despues de get_section_selections()
• eso podia romper el selector en runtime aunque el archivo compilara

Eso ya fue corregido en este turno.

Arreglo aplicado en este turno

Archivo:

• AbletonMCP_AI/AbletonMCP_AI/MCP_Server/sample_selector.py

Fix:

• se restauro _calculate_repetition_penalty
• se elimino el residuo muerto del merge
• se dejo el modulo otra vez consistente para scoring real

Validacion hecha:

• python test_same_pack_selection.py
• python test_clear_tracks.py
• python test_clear_messy.py
• python AbletonMCP_AI/AbletonMCP_AI/MCP_Server/tests/test_sample_selector.py
• compilacion local de los .py principales

Objetivo real de v0.1.3

Pasar de "hay estructuras nuevas" a "esas estructuras afectan la generacion real".

Tarea 1 - Cablear section-aware selection al flujo real

Problema:

• la logica por seccion existe en sample_selector.py
• pero no entra en juego en la generacion real porque nadie llama set_section_context()

Haz esto:

1. encontrar el flujo real donde se seleccionan samples por rol
2. setear section_context antes de cada bloque de seleccion
3. limpiar el contexto al terminar
4. verificar que record_section_selection() se use de verdad

Archivos probables:

• AbletonMCP_AI/AbletonMCP_AI/MCP_Server/server.py
• AbletonMCP_AI/AbletonMCP_AI/MCP_Server/sample_selector.py
• AbletonMCP_AI/AbletonMCP_AI/MCP_Server/pack_brain.py

Criterio de salida:

• logs muestran SECTION_CONTEXT y JOINT_SCORE en una generacion real
• los picks cambian por seccion, no solo por rol global

Tarea 2 - Agregar test que capture la regresion del selector

Problema:

• el archivo compilaba aunque le faltaba un metodo critico
• los tests existentes no lo detectaron

Haz esto:

1. agregar un test que llame el camino de scoring real
2. cubrir _calculate_sample_score
3. cubrir section context + joint scoring

Archivos:

• AbletonMCP_AI/AbletonMCP_AI/MCP_Server/tests/test_sample_selector.py
• o test nuevo en root si no puedes usar pytest

Criterio de salida:

• si vuelve a faltar _calculate_repetition_penalty, el test falla

Tarea 3 - Validar de verdad el camino async con Live

Problema:

• el consolidado reconoce que server.py sigue bloqueando en algunos casos
• esto sigue siendo un riesgo real

Haz esto:

1. ejecutar temp\smoke_test_async.py con Live abierto
2. probar --use-track
3. probar generate_song_async
4. revisar get_generation_job_status
5. confirmar si el bloqueo esta en job queue, transport o generacion larga

Archivos:

• temp\smoke_test_async.py
• AbletonMCP_AI/AbletonMCP_AI/MCP_Server/server.py

Criterio de salida:

• job queued
• job running
• job completed
• manifest util
• sin falsos "success"

Tarea 4 - Bajar claims inflados de la documentacion

Problema:

• el consolidado tiene verdad util, pero tambien claims demasiado fuertes

Haz esto:

1. no borres el consolidado
2. si corriges algo grande, agrega una seccion "Reality Check"
3. cambia frases tipo "100% implementado" por estado verificable

Archivo:

• docs/CONSOLIDADO_v0.1.1_v0.1.2_PARA_CODEX.md

Criterio de salida:

• la doc no promete mas de lo que el runtime demuestra

Tarea 5 - Limpiar artefactos de trabajo del repo

Problema:

• hay artefactos mezclados con codigo real
• ejemplos: scan_log.txt, diversity_memory.json, scripts temporales y tests ad hoc en root

Haz esto:

1. decidir que archivos son runtime real
2. decidir que archivos son artefactos locales
3. mover o ignorar lo que no deba versionarse

Archivos probables:

• .gitignore
• AbletonMCP_AI/.gitignore
• root del repo

Criterio de salida:

• menos ruido en git status
• menos chance de que otro agente edite el archivo equivocado

Reglas duras para este sprint

• no declares que section-aware selection funciona hasta verla en logs o runtime
• no uses solo compilacion como prueba de salud
• no confundas "codigo existe" con "codigo esta conectado"
• si un claim del consolidado contradice el diff o el runtime, gana el runtime