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

docs/SPRINT_v0.1.7_NEXT.md

@@ -0,0 +1,109 @@
+# Sprint v0.1.7 Next
+
+Fecha: `2026-03-30`
+
+Objetivo del sprint: dejar de generar “sonidos sueltos” y empezar a generar un track que conserve identidad melodica, armonica y timbrica durante toda la cancion.
+
+## Contexto obligatorio
+
+Antes de tocar codigo, leer:
+
+1. `C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\docs\REFERENCE_TRACK_EJEMPLO_ANALYSIS.md`
+2. `C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\docs\ANTHROPIC_COMPAT_PROVIDER_CHECK_2026-03-30.md`
+3. `C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\KIMI_K2_ACTIVE_HANDOFF.md`
+
+## Estado de partida verificado por Codex
+
+- `pack_brain` ya puntua palettes y ahora debe castigar conflictos armonicos `bass/music`
+- `server.py` ya persiste `musical_theme` en manifest
+- `coherence_analyzer.py` ya no debe contar el budget por suma bruta de tracks duplicados
+- `ejemplo.mp3` muestra un contrato real:
+  - repeticion alta
+  - centro tonal estable
+  - low-end dominante
+  - pocas familias sonoras
+  - cambios por energia y brillo, no por randomizacion de layers
+
+## Problema principal a resolver
+
+El sistema todavia puede generar un track con:
+
+- demasiadas capas opcionales
+- bajo y material musical compatibles “en papel” pero flojos como cancion
+- secciones que cambian demasiado de mundo sonoro
+- hooks que no se perciben como una misma idea
+
+## Trabajo del sprint
+
+### 1. Theme persistence real
+
+- Verificar que `musical_theme` no solo exista en `config`, sino que gobierne de verdad:
+  - `bass`
+  - `chords/pad`
+  - `lead/pluck`
+- Si algun rol melodico importante se genera por fuera del tema, corregirlo.
+- Dejar evidencia en manifest y logs.
+
+### 2. Hook-family scoring
+
+- Crear un score adicional que premie:
+  - reuso de contorno melodico
+  - reuso de ritmo del motivo
+  - misma familia tonal entre secciones
+- Penalizar si `lead/pluck/chords` parecen venir de ideas distintas.
+
+### 3. Section coherence hardening
+
+- Cada seccion debe ser una variacion del mismo track, no otro track.
+- Para `intro/build/drop/break/outro`, limitar cambios a:
+  - densidad
+  - brillo
+  - cantidad de capas activas
+  - version del mismo motivo
+- No permitir que `break` u `outro` cambien a una palette incompatible.
+
+### 4. Audio-layer sanity
+
+- Auditar por que se materializan demasiadas capas similares.
+- Detectar y evitar:
+  - duplicados MIDI/audio de la misma funcion sin necesidad
+  - `perc_main` y `perc_alt` con el mismo archivo
+  - varios layers vocales/fx que no agregan contraste real
+
+### 5. Reference-fit report
+
+- Crear un reporte de comparacion contra `ejemplo.mp3` con al menos:
+  - BPM
+  - key
+  - low/mid/high ratio
+  - RMS envelope general
+  - onset density
+  - motif reuse / recurrence proxy
+  - budget por slots logicos
+- Ese reporte debe decir `closer` o `farther` respecto al intento anterior.
+
+## Aceptacion minima
+
+No cerrar el sprint sin esto:
+
+1. una generacion nueva en Live
+2. manifest guardado con `musical_theme`
+3. coherence report sin conteo bruto inflado
+4. sin conflicto armonico claro entre `bass` y `music`
+5. una nota honesta de escucha tecnica sobre si el resultado ya se parece mas a `ejemplo.mp3`
+
+## No hacer en este sprint
+
+- no abrir otra integracion nueva de modelos si el problema sigue siendo musical
+- no agregar mas capas “para llenar”
+- no declarar exito por compilacion
+- no declarar exito porque el job async crea tracks
+
+## Si Z.ai falla
+
+Fallback preferido:
+
+1. `glm-5 @ DashScope`
+2. `qwen3.5-plus @ DashScope`
+
+No usar `Fireworks / kimi-k2p5-turbo` como arbitro principal mientras siga obedeciendo peor el contrato simple de salida.