238 lines
4.8 KiB
Markdown
238 lines
4.8 KiB
Markdown
# KIMI K2 Active Handoff
|
|
|
|
## Contexto del Proyecto - Sprint Granular v0.1.40
|
|
|
|
**Fecha:** 2026-04-05
|
|
**Version:** Granular v0.1.40
|
|
**Estado:** ProduccionLista
|
|
|
|
---
|
|
|
|
## Resumen del Sprint Granular
|
|
|
|
El Sprint Granular complet exitosamente las tareas de testing y documentacion (T185-T200), incluyendo:
|
|
|
|
-Testing completo de modulos nuevos
|
|
- Documentacion actualizada
|
|
- Validacion integral del sistema
|
|
- Entrega final aprobada
|
|
|
|
---
|
|
|
|
## Estructura del Proyecto
|
|
|
|
### Directorio Raiz
|
|
|
|
```
|
|
C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\
|
|
```
|
|
|
|
### Archivos Clave
|
|
|
|
| Archivo | Funcion |
|
|
|---------|---------|
|
|
| `AGENTS.md` | Comandos y paths activos |
|
|
| `CLAUDE.md` | Contexto canonico del proyecto |
|
|
| `mcp_wrapper.py` | Wrapper MCP para transporte |
|
|
| `abletonmcp_init.py` | Inicializacion del Remote Script |
|
|
| `opencode.json` | Configuracion de MCP |
|
|
|
|
### Directorio MCP_Server
|
|
|
|
```
|
|
AbletonMCP_AI\AbletonMCP_AI\MCP_Server\
|
|
├── server.py # Servidor MCP principal
|
|
├── spectral_engine.py # Analisis espectral (T018-T043)
|
|
├── arrangement_intelligence.py # Logica de arrangement (T086-T094)
|
|
├── melody_generator.py # Generacion melodica (T121-T135)
|
|
├── song_generator.py # Generacion de canciones
|
|
├── reference_listener.py # Escucha de referencias
|
|
├── human_feel.py # Humanizacion y groove
|
|
├── bus_routing_fix.py # Correccion de routing
|
|
└── tests/ # Tests unitarios
|
|
```
|
|
|
|
---
|
|
|
|
## Modulos Activos
|
|
|
|
### server.py
|
|
|
|
Servidor MCP principal con todas las herramientas publicas.
|
|
|
|
**Tareas relevantes:**
|
|
- T072-T077: FX automation
|
|
- T079-T087: Gain staging
|
|
- T101-T106: Bus routing
|
|
|
|
### spectral_engine.py
|
|
|
|
Motor de analisis espectral para seleccion timbrica.
|
|
|
|
**Tareas implementadas:** T018-T043
|
|
|
|
**Funcionalidades:**
|
|
- Analisis de centroide espectral
|
|
- Calculo de MFCC
|
|
- Busqueda de samples similares
|
|
- Clusters timbricos
|
|
|
|
### arrangement_intelligence.py
|
|
|
|
Logica de arrangement para estructuras profesionales.
|
|
|
|
**Tareas implementadas:** T086-T094
|
|
|
|
**Funcionalidades:**
|
|
- Estructura reggaeton 95 BPM
|
|
- Mute throws
|
|
- Energy curve checker
|
|
|
|
### melody_generator.py
|
|
|
|
Generacion procedural de melodias.
|
|
|
|
**Tareas implementadas:** T121-T135
|
|
|
|
**Funcionalidades:**
|
|
- Escalas y tonalidades
|
|
- Progresiones de acordes
|
|
- Contorno melodico
|
|
|
|
---
|
|
|
|
## Tests
|
|
|
|
### Ubicacion
|
|
|
|
```
|
|
AbletonMCP_AI\AbletonMCP_AI\MCP_Server\tests\
|
|
```
|
|
|
|
### Tests Principales
|
|
|
|
| Test | Funcion |
|
|
|------|---------|
|
|
| `test_runtime_truth.py` | Comportamiento MCP |
|
|
| `test_spectral_integration.py` | Tests spectral engine |
|
|
| `test_arrangement_intelligence.py` | Tests arrangement |
|
|
| `test_gain_staging.py` | Tests gain staging |
|
|
| `test_melody_generator.py` | Tests melodia |
|
|
|
|
### Ejecutar Tests
|
|
|
|
```powershell
|
|
python -m pytest "AbletonMCP_AI\AbletonMCP_AI\MCP_Server\tests" -v
|
|
```
|
|
|
|
---
|
|
|
|
## Comandos de Trabajo
|
|
|
|
### Compilar
|
|
|
|
```powershell
|
|
python -m compileall "C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\AbletonMCP_AI"
|
|
```
|
|
|
|
### Verificar MCP
|
|
|
|
```powershell
|
|
opencode mcp list --print-logs
|
|
netstat -an | findstr 9877
|
|
```
|
|
|
|
### Ver Logs de Ableton
|
|
|
|
```powershell
|
|
Get-Content "C:\Users\ren\AppData\Roaming\Ableton\Live 12.0.15\Preferences\Log.txt" -Tail 120
|
|
```
|
|
|
|
---
|
|
|
|
## Proyecto Actual
|
|
|
|
### Target
|
|
|
|
```
|
|
C:\Users\ren\Desktop\song Project\song.als
|
|
```
|
|
|
|
### Workflow Actual
|
|
|
|
1. Editar proyecto abierto existente
|
|
2. Mejorar coherencia y continuidad
|
|
3. Reducir huecos de silencio
|
|
4. Mantener material armonico vivo
|
|
|
|
---
|
|
|
|
## Reglas Importantes
|
|
|
|
### Capas del Sistema
|
|
|
|
1. **MCP transport** (`server.py`, `mcp_wrapper.py`)
|
|
2. **Socket protocol** (`abletonmcp_runtime.py`)
|
|
3. **Live API** (`abletonmcp_init.py`,objetos Live)
|
|
|
|
### Orden de Confianza
|
|
|
|
1. Estado actual de Live
|
|
2. Respuestas MCP
|
|
3. Log de Ableton
|
|
4. Codigo
|
|
5. Reportes antiguos
|
|
|
|
### Anti-Patrones
|
|
|
|
- No parchar archivos obsoletos
|
|
- No confiar en reports sin verificar en Live
|
|
- No cerrar sprints solo con documentacion
|
|
- No forzar "piano" como direccion sonora
|
|
|
|
---
|
|
|
|
## Estado Actual
|
|
|
|
### Funcional
|
|
|
|
- [x] MCP conectando correctamente
|
|
- [x] Generacion de tracks
|
|
- [x] Generacion de canciones
|
|
- [x] Clips MIDI y Audio
|
|
- [x] Routing de buses
|
|
- [x] Gain staging
|
|
- [x] FX automation
|
|
|
|
### Pendientes
|
|
|
|
- [ ] Optimizacion de cache espectral
|
|
- [ ] Integracion avanzada con reference_listener
|
|
- [ ] Generacion de melodias con ML
|
|
|
|
---
|
|
|
|
## Contacto
|
|
|
|
- **Technical Lead:** Sprint Granular Team
|
|
- **Documentation:** AbletonMCP-AI Team
|
|
- **Project Root:** `C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts`
|
|
|
|
---
|
|
|
|
## Archivos de Referencia Rapida
|
|
|
|
- `CLAUDE.md` - Leer primero
|
|
- `AGENTS.md` - Paths y comandos
|
|
- `docs/ROADMAP.md` - Roadmap del proyecto
|
|
- `docs/READY_CHECKLIST.md` - Checklist de validacion
|
|
|
|
---
|
|
|
|
**Handoff Date:** 2026-04-05
|
|
**Sprint:** GRANULAR-PART2
|
|
**Version:** v0.1.40
|
|
|
|
---
|
|
|
|
*Maintained by: AbletonMCP-AI Team* |