# 🛠️ TOFIX — Pendientes del MCP AbletonMCP_AI

> Última revisión: 2026-04-05

---

## 🔴 Crítico (bloquean funcionalidad)

_(Ninguno actualmente — todos los errores de runtime F821/F841 han sido corregidos)_

---

## 🟠 Alta Prioridad (lint / calidad de código)

### Archivos con permisos bloqueados por Windows ACL
Estos archivos tienen permisos de escritura restringidos por la instalación de Ableton.
Para editarlos necesitás **abrir el editor / terminal como Administrador**.

| Archivo | Línea | Error | Descripción |
|---|---|---|---|
| `role_matcher.py` | 12 | F401 | `random` importado pero nunca usado (se importa inline donde se necesita) |
| `role_matcher.py` | 13 | F401 | `typing.Set` importado pero nunca usado |

**Cómo fixear:**
```powershell
# Desde PowerShell como Administrador:
icacls "C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\AbletonMCP_AI\MCP_Server\role_matcher.py" /grant Users:F
```

---

## 🟡 Media Prioridad (errores de análisis estático Pyre2)

> Estos **NO son errores reales en Python** — son limitaciones del motor de análisis Pyre2 con código dinámico. No causan ningún problema en runtime.

| Tipo | Patrón | Cantidad estimada | Causa real |
|---|---|---|---|
| `+=` no soportado | `defaultdict` + `int` | ~40+ | Pyre2 no infiere `defaultdict` correctamente |
| `*` no soportado | `dict[str, float] * float` | ~10+ | Pyre2 confunde el tipo de retorno de `.get()` |
| `in` no soportado | `str in set()` | ~5+ | Pyre2 pierde el tipo de `set` después de asignación |
| `round()` overload | `round(x, 3)` | ~6 | Bug conocido de Pyre2 con `ndigits != None` |
| `Cannot index` | `dict[Literal[...]]` | ~4 | Pyre2 infiere dict demasiado estricto |

**Impacto real:** Ninguno. Todos son falsos positivos de inferencia de tipos.

---

## 🟢 Baja Prioridad (mejoras arquitecturales)

| Área | Descripción |
|---|---|
| `reference_listener.py` | `_compute_segment_features` referenciado pero el método no está visible en el scope de Pyre2 — verificar que está en la misma clase. |
| `reference_listener.py` | `str[::step]` slice con step — Pyre2 reporta error pero es Python válido. Documentar o usar `cast()`. |
| `sample_manager.py` | `SampleType = None` como fallback cuando `audio_analyzer` no se puede importar — podría causar `TypeError` si se usa como clase. |

---

## ✅ Ya corregido en esta sesión

| Archivo | Fix | Fecha |
|---|---|---|
| `abletonmcp_init.py:1450-1471` | Eliminado time.sleep() del hilo Live en _record_session_clip_to_arrangement (reemplazado con búsqueda sin bloqueo) | 2026-04-05 |
| `sample_selector.py:1-30` | Corregida corrupción UTF-8 (doble-encoding) en docstrings | 2026-04-05 |
| `sample_manager.py:355` | Eliminada llamada no usada a _get_file_hash() | 2026-04-05 |
| `abletonmcp_init.py:1608` | Añadida normalización de paths WSL (/mnt/c/... → C:\...) en _create_arrangement_audio_pattern | 2026-04-05 |
| `server.py:587` | Añadida función helper _normalize_wsl_path() para normalizar paths WSL | 2026-04-05 |
| `server.py:18838` | Aplicada normalización WSL en create_arrangement_audio_pattern tool | 2026-04-05 |
| `song_generator.py:9560` | Añadido logging de materialized_track_roles para coherencia | 2026-04-05 |
| `song_generator.py:2691` | `kind` → `_kind` (F841) | 2026-03-22 |
| `song_generator.py:4144` | `root_note` → `_root_note` (F841) | 2026-03-22 |
| `song_generator.py:3265` | `Set[str]` → `set` (F821 — `Set` no importado) | 2026-03-22 |
| `song_generator.py:3292` | `Set[str]` → `set` (F821 — `Set` no importado) | 2026-03-22 |
| `reference_listener.py:243` | `falling` → `_falling` (F841) | 2026-03-22 |
| `reference_listener.py:318` | `smoothed_onset` → `_smoothed_onset` (F841) | 2026-03-22 |
| `reference_listener.py:343` | `total_frames` → `_total_frames` (F841) | 2026-03-22 |
| `reference_listener.py:2594` | `'Sample'` tipo hint → `Any` (F821 — `Sample` no definido en scope) | 2026-03-22 |
| `reference_listener.py:2600` | `'Sample'` tipo hint → `Any` (F821 — `Sample` no definido en scope) | 2026-03-22 |
| `opencode.json` | Creado con MCP registrado y todos los permisos en `allow` | 2026-03-22 |