feat: Implement senior audio injection with 5 fallback methods
- Add _cmd_create_arrangement_audio_pattern with 5-method fallback chain - Method 1: track.insert_arrangement_clip() [Live 12+] - Method 2: track.create_audio_clip() [Live 11+] - Method 3: arrangement_clips.add_new_clip() [Live 12+] - Method 4: Session->duplicate_clip_to_arrangement [Legacy] - Method 5: Session->Recording [Universal] - Add _cmd_duplicate_clip_to_arrangement for session-to-arrangement workflow - Update skills documentation - Verified: 3 clips created at positions [0, 4, 8] in Arrangement View Closes: Audio injection in Arrangement View
This commit is contained in:
OpenCode Agent
261
docs/sprint_4_bloque_B.md
Normal file
261
docs/sprint_4_bloque_B.md
Normal file
@@ -0,0 +1,261 @@
|
||||
# SPRINT 4 — BLOQUE B: TESTING END-TO-END, INTEGRACIÓN Y WORKFLOW DE PRODUCCIÓN (T051-T100)
|
||||
|
||||
> **Fecha**: 2026-04-11
|
||||
> **Estado Sprint 4-A**: ✅ COMPLETO — Verificación post-ejecución, Browser API, Arrangement, Diagnóstico, Robustez
|
||||
> **Objetivo Sprint 4-B**: Que TODO funcione end-to-end con Ableton abierto y real
|
||||
> **Revisión**: Qwen
|
||||
|
||||
---
|
||||
|
||||
## CONTEXTO
|
||||
|
||||
Sprint 4-A agregó verificación, diagnóstico y robustez. Ahora sabemos EXACTAMENTE qué funciona y qué no.
|
||||
El Bloque B se enfoca en:
|
||||
|
||||
1. **Testing real** — ejecutar cada tool con Ableton abierto y verificar que se vea en la UI
|
||||
2. **Integración completa** — conectar engines del Sprint 3 (song_generator, pattern_library, mixing_engine) con handlers del Sprint 4-A
|
||||
3. **Workflow de producción** — pipeline completo de una canción de reggaeton profesional
|
||||
|
||||
---
|
||||
|
||||
## FASE B1: TESTING END-TO-END (T051-T065)
|
||||
|
||||
### Objetivo: Cada tool nueva debe probarse con Ableton abierto
|
||||
|
||||
**T051** — Test `ping` → Verificar que responde instantáneamente (< 100ms)
|
||||
**T052** — Test `health_check` → Score debe ser 5/5 con Ableton corriendo
|
||||
**T053** — Test `get_system_diagnostics` → Debe retornar versión de Live, estado del browser, sesión
|
||||
**T054** — Test `get_live_version` → Debe retornar "12.x.x"
|
||||
**T055** — Test `test_browser_connection` → Debe listar secciones disponibles
|
||||
**T056** — Test `scan_browser_section("instruments", depth=1)` → Debe retornar lista de instruments
|
||||
**T057** — Test `get_track_details(0)` → Debe retornar snapshot del primer track
|
||||
**T058** — Test `get_device_parameters(track_index, device_index)` → Debe listar parámetros de un device
|
||||
**T059** — Test `set_device_parameter()` → Debe cambiar un parámetro y verificar el cambio
|
||||
**T060** — Test `get_clip_notes()` → Debe leer notas de un clip MIDI existente
|
||||
**T061** — Test `show_arrangement_view()` → Debe cambiar la vista de Ableton a Arrangement
|
||||
**T062** — Test `show_session_view()` → Debe cambiar la vista de Ableton a Session
|
||||
**T063** — Test `set_arrangement_position(bar=0)` → Debe mover el playhead al inicio
|
||||
**T064** — Test `loop_arrangement_region(0, 8)` → Debe crear un loop de 8 bars
|
||||
**T065** — Test `test_sample_loading()` con sample real → Debe reportar qué métodos funcionan
|
||||
|
||||
---
|
||||
|
||||
## FASE B2: INTEGRACIÓN ENGINES → HANDLERS (T066-T080)
|
||||
|
||||
### Objetivo: Los engines del Sprint 3 deben usarse en handlers reales
|
||||
|
||||
**T066** — `_cmd_generate_full_song()` debe usar `ReggaetonGenerator.generate()`:
|
||||
- Generar config con `song_generator.py`
|
||||
- Para cada track en config:
|
||||
- Crear track en Ableton
|
||||
- Generar notas con `pattern_library.py`
|
||||
- Crear clips y escribir notas
|
||||
- Verificar con `_verify_clip_has_audio()`
|
||||
|
||||
**T067** — `_cmd_generate_dembow_clip()` debe usar `DembowPatterns.get_kick_pattern()`:
|
||||
- Obtener pattern real de `pattern_library.py`
|
||||
- Crear clip en Ableton
|
||||
- Escribir notas del pattern
|
||||
- Verificar notas escritas
|
||||
|
||||
**T068** — `_cmd_generate_bass_clip()` debe usar `BassPatterns.get_bass_line()`:
|
||||
- Obtener línea de bass de `pattern_library.py`
|
||||
- Crear clip y escribir notas
|
||||
- Verificar
|
||||
|
||||
**T069** — `_cmd_generate_chords_clip()` debe usar `ChordProgressions`:
|
||||
- Obtener progresión de acordes
|
||||
- Generar notas de acordes con voicings
|
||||
- Escribir en clip
|
||||
- Verificar
|
||||
|
||||
**T070** — `_cmd_generate_melody_clip()` debe usar `MelodyGenerator.generate_melody()`:
|
||||
- Generar melodía con escala detectada
|
||||
- Crear clip y escribir notas
|
||||
- Verificar
|
||||
|
||||
**T071** — `_cmd_apply_human_feel()` debe usar `HumanFeel.apply_all_humanization()`:
|
||||
- Leer notas existentes del clip
|
||||
- Aplicar micro-timing, velocity variation
|
||||
- Re-escribir notas
|
||||
- Verificar cambios
|
||||
|
||||
**T072** — `_cmd_add_percussion_fills()` debe usar `PercussionLibrary`:
|
||||
- Obtener fills de `pattern_library.py`
|
||||
- Crear clips de fills en posiciones de transición
|
||||
- Verificar
|
||||
|
||||
**T073** — `_cmd_create_bus_track()` debe usar `BusManager` de `mixing_engine.py`:
|
||||
- Crear bus con configuración profesional
|
||||
- Verificar que el track existe
|
||||
- Retornar track_index
|
||||
|
||||
**T074** — `_cmd_route_track_to_bus()` debe usar `BusManager.route_track_to_bus()`:
|
||||
- Routear track al bus correcto
|
||||
- Verificar routing
|
||||
- Retornar confirmación
|
||||
|
||||
**T075** — `_cmd_configure_eq()` debe usar `EQConfiguration.get_preset()`:
|
||||
- Insertar EQ Eight si no existe
|
||||
- Configurar con preset apropiado
|
||||
- Verificar parámetros
|
||||
|
||||
**T076** — `_cmd_configure_compressor()` debe usar `CompressionSettings`:
|
||||
- Insertar Compressor si no existe
|
||||
- Configurar con preset
|
||||
- Verificar
|
||||
|
||||
**T077** — `_cmd_setup_sidechain()` debe usar `CompressionSettings` + `BusManager`:
|
||||
- Insertar Compressor en target
|
||||
- Configurar sidechain desde kick
|
||||
- Verificar `sidechain_active`
|
||||
|
||||
**T078** — `_cmd_apply_master_chain()` debe usar `MasterChain.apply_master_chain()`:
|
||||
- Insertar cadena completa: EQ → Comp → Sat → Limiter
|
||||
- Configurar con preset (club/streaming/radio)
|
||||
- Verificar cada device
|
||||
|
||||
**T079** — `_cmd_auto_gain_staging()` debe usar `GainStaging.auto_gain_staging()`:
|
||||
- Ajustar volúmenes de todos los tracks
|
||||
- Verificar headroom
|
||||
- Retornar niveles aplicados
|
||||
|
||||
**T080** — `_cmd_full_quality_check()` debe usar `MixQualityChecker.run_quality_check()`:
|
||||
- Analizar clipping, phase, frequency balance
|
||||
- Retornar score y sugerencias
|
||||
|
||||
---
|
||||
|
||||
## FASE B3: WORKFLOW DE PRODUCCIÓN COMPLETO (T081-T095)
|
||||
|
||||
### Objetivo: Un pipeline completo de análisis → generación → mezcla → export
|
||||
|
||||
**T081** — `_cmd_analyze_library()`:
|
||||
- Ejecutar análisis espectral de 511 samples
|
||||
- Generar `.features_cache.json`
|
||||
- Retornar estadísticas completas
|
||||
|
||||
**T082** — `_cmd_build_embeddings_index()`:
|
||||
- Crear embeddings de 511 samples
|
||||
- Guardar `.embeddings_index.json`
|
||||
- Retornar dimensiones y count
|
||||
|
||||
**T083** — `_cmd_get_similar_samples(sample_path, top_n=10)`:
|
||||
- Buscar samples similares por distancia coseno
|
||||
- Retornar ranking con similitudes
|
||||
|
||||
**T084** — `_cmd_find_samples_like_audio(audio_path, top_n=20)`:
|
||||
- Analizar archivo de referencia
|
||||
- Encontrar samples similares en librería
|
||||
- Retornar matches con scores
|
||||
|
||||
**T085** — `_cmd_get_user_sound_profile()`:
|
||||
- Cargar perfil desde `.user_sound_profile.json`
|
||||
- Retornar BPM, key, timbre preferidos
|
||||
|
||||
**T086** — `_cmd_get_recommended_samples(role, count=5)`:
|
||||
- Usar perfil del usuario para recomendar
|
||||
- Retornar samples por rol
|
||||
|
||||
**T087** — `_cmd_generate_from_reference(reference_audio_path)`:
|
||||
- Analizar referencia
|
||||
- Seleccionar samples similares
|
||||
- Generar track completo con samples reales
|
||||
- Configurar buses y mezcla
|
||||
- Retornar resumen completo
|
||||
|
||||
**T088** — `_cmd_produce_reggaeton(bpm, key, style, structure)`:
|
||||
- Pipeline completo:
|
||||
1. Seleccionar samples con `get_recommended_samples()`
|
||||
2. Generar config con `ReggaetonGenerator`
|
||||
3. Crear tracks en Ableton
|
||||
4. Generar clips con patterns reales
|
||||
5. Configurar buses y routing
|
||||
6. Aplicar mezcla automática
|
||||
7. Configurar sidechain
|
||||
- Retornar resumen completo con verificación
|
||||
|
||||
**T089** — `_cmd_produce_arrangement(bpm, key, style, structure)`:
|
||||
- Como T088 pero en Arrangement View
|
||||
- Clips posicionados en tiempo
|
||||
- Automatización incluida
|
||||
|
||||
**T090** — `_cmd_complete_production(bpm, key, style, output_dir)`:
|
||||
- Pipeline T088 + renderizado
|
||||
- Exportar stems + full mix
|
||||
- Generar release notes
|
||||
- Retornar paths de archivos
|
||||
|
||||
**T091** — `_cmd_batch_produce(count, style, bpm_range, key_range)`:
|
||||
- Generar múltiples canciones
|
||||
- Variación automática
|
||||
- Cada una única
|
||||
|
||||
**T092** — `_cmd_export_stems(output_dir)`:
|
||||
- Renderizar cada bus como stem
|
||||
- Drums, Bass, Music, FX stems
|
||||
- Guardar en directorio
|
||||
|
||||
**T093** — `_cmd_render_full_mix(output_path)`:
|
||||
- Renderizar mezcla completa
|
||||
- WAV 24-bit/44.1kHz
|
||||
- Con mastering aplicado
|
||||
|
||||
**T094** — `_cmd_render_instrumental(output_path)`:
|
||||
- Mutear melodías/vocals
|
||||
- Renderizar solo drums + bass
|
||||
|
||||
**T095** — `_cmd_generate_release_notes()`:
|
||||
- Generar notas de release
|
||||
- BPM, key, structure
|
||||
- Samples usados
|
||||
- Mixing notes
|
||||
- Loudness stats
|
||||
|
||||
---
|
||||
|
||||
## FASE B4: DOCUMENTACIÓN Y UX (T096-T100)
|
||||
|
||||
**T096** — Crear `docs/GUIA_DE_USO.md`:
|
||||
- Lista completa de 118+ tools
|
||||
- Descripción de cada una
|
||||
- Ejemplos de uso
|
||||
- Orden recomendado para producción
|
||||
|
||||
**T097** — Crear `docs/WORKFLOW_REGGAETON.md`:
|
||||
- Pipeline paso a paso para producir reggaeton
|
||||
- Desde análisis de librería hasta export final
|
||||
- Screenshots descriptivos
|
||||
|
||||
**T098** — Crear `docs/TROUBLESHOOTING.md`:
|
||||
- Problemas comunes y soluciones
|
||||
- Cómo diagnosticar con `health_check()` y `get_system_diagnostics()`
|
||||
- Qué hacer si Ableton no responde
|
||||
|
||||
**T099** — Tool MCP `help()` → Retorna lista de tools con descripción breve
|
||||
**T100** — Tool MCP `get_workflow_status()` → Retorna estado actual del proyecto
|
||||
|
||||
---
|
||||
|
||||
## ARCHIVOS A MODIFICAR
|
||||
|
||||
| Archivo | Cambios |
|
||||
|---------|---------|
|
||||
| `AbletonMCP_AI/__init__.py` | +30 handlers nuevos (workflow completo) |
|
||||
| `mcp_server/server.py` | +15 tools MCP nuevas |
|
||||
| `docs/GUIA_DE_USO.md` | Nuevo - Documentación completa |
|
||||
| `docs/WORKFLOW_REGGAETON.md` | Nuevo - Pipeline de producción |
|
||||
| `docs/TROUBLESHOOTING.md` | Nuevo - Diagnóstico |
|
||||
|
||||
## RESTRICCIONES
|
||||
|
||||
1. **Compilar después de cada archivo**: `python -m py_compile "<path>"`
|
||||
2. **NO tocar `libreria/`** - solo lectura
|
||||
3. **Cada handler debe verificar POST-ejecución** (usar patterns del Sprint 4-A)
|
||||
4. **Mantener compatibilidad** con 118 tools existentes
|
||||
5. **Paths absolutos de Windows** en todo
|
||||
|
||||
---
|
||||
|
||||
**Cuando termines, avisale a Qwen.**
|
||||
Él va a: compilar, probar con Ableton, arreglar bugs, y verificar end-to-end.
|
||||
Reference in New Issue
Block a user