# Reporte técnico — Reparación de extensiones/herramientas y recomendaciones

Fecha: 2026-07-18
Workspace: `ClaudeCodeSystemsPremium.code-workspace` (multi-root)

## 1) Cambios aplicados automáticamente (hechos)

### 1.1 Sincronización cloud desactivada (trabajo local)
Se aplicó en `ClaudeCodeSystemsPremium.code-workspace`:

- `chat.sessionSync.enabled: false`
- `github.copilot.chat.localIndex.enabled: true`

**Efecto:** las consultas históricas quedan orientadas a índice local, no cloud.

**Verificación ejecutada:** consulta de sesiones devolvió `source: local` con `5` sesiones indexadas.

---

### 1.2 Serena MCP reparado según documentación oficial
Se corrigió la entrada MCP `oraios/serena` en `ClaudeCodeSystemsPremium.code-workspace`:

- Se eliminó el argumento inválido `serena@latest` dentro de `args`.
- Se fijó runtime `uvx -p 3.13`.
- Se dejó comando oficial de arranque: `serena start-mcp-server`.
- Se cambió contexto a `--context vscode`.
- Se añadió activación por workspace: `--project ${workspaceFolder}`.

**Base oficial usada:**
- https://oraios.github.io/serena/02-usage/030_clients.html (VSCode)
- https://oraios.github.io/serena/02-usage/020_running.html (`start-mcp-server`, args)
- https://oraios.github.io/serena/02-usage/050_configuration.html (contextos)

---

### 1.3 ESLint estabilizado (evitar error “Could not find config file” sobre workspace)
Se aplicó en `ClaudeCodeSystemsPremium.code-workspace`:

- `eslint.validate` restringido a lenguajes JS/TS/UI (`javascript`, `typescript`, `vue`, `svelte`, etc.).
- `eslint.workingDirectories: [{ "mode": "auto" }]`.

**Efecto:** reduce intentos de ESLint fuera de proyectos JS/TS con configuración válida.

---

### 1.4 Git: detener escaneo continuo cuando no hay repo raíz
Se aplicó en `ClaudeCodeSystemsPremium.code-workspace`:

- `git.autoRepositoryDetection: false`
- `git.openRepositoryInParentFolders: "never"`

**Efecto:** se elimina ruido constante de `git rev-parse --show-toplevel` en carpetas sin `.git`.

**Importante:** Git sigue usable manualmente (abrir repos concretos cuando lo necesites).

---

### 1.5 Desactivado texto predictivo de Copilot (para reducir consumo y ruido)
Se aplicó en `ClaudeCodeSystemsPremium.code-workspace`:

- `editor.inlineSuggest.enabled: false`
- `github.copilot.inlineSuggest.enable: false`
- `github.copilot.nextEditSuggestions.enabled: false`

**Efecto:** se desactiva experiencia de texto predictivo/inline. Mantienes chat y herramientas.

---

## 2) Diagnóstico técnico verificado

### 2.1 BestAmigo / Ollama
Se verificó en máquina local:

- Endpoint `http://127.0.0.1:11434/v1/models` -> **conexión rechazada**.
- Resultado: el proveedor `Ollama` en BestAmigo falla por servicio no levantado.

**Conclusión:** el log reportado de BestAmigo es consistente con un Ollama caído/no instalado.

### 2.2 Codex 401 Unauthorized
Se verificó:

- Existe `C:\Users\Paterna\.codex\auth.json`.
- El error `401 /wham/usage` indica token/sesión inválida o expirada en backend.

**Conclusión:** es un problema de autenticación de cuenta/sesión, no de código del workspace.

### 2.3 Warnings del Extension Host (quickfix kind / i18n Modify/Review)
Estos warnings provienen del comportamiento interno de extensiones concretas (`copilot-chat`, `saoudrizwan.claude-dev`) y no de tu código.

**Conclusión:** no se “corrigen” desde proyecto salvo mitigación por actualización/desactivación/aislamiento de extensiones conflictivas.

---

## 3) Acciones manuales recomendadas (no automatizables por seguridad/entorno)

### 3.1 BestAmigo (elegir una)
1. **Levantar Ollama** para mantener ese provider.
2. O deshabilitar provider `Ollama` en configuración de BestAmigo para evitar errores de health check.

### 3.2 Codex 401
1. Reautenticar sesión de Codex (logout/login).
2. Si persiste, borrar credenciales cacheadas de Codex y volver a iniciar sesión.

### 3.3 Host warnings
1. Actualizar extensiones afectadas.
2. Si continúan: deshabilitar temporalmente `saoudrizwan.claude-dev` para confirmar origen del warning de quickfix.

---

## 4) Recomendación de extensiones óptimas para tu área de trabajo

Tu workspace mezcla Python (Serena), Node/TS (SillyTavern Launcher) y herramientas IA locales.

### 4.1 Núcleo de calidad y DX
- `ms-python.python`
- `charliermarsh.ruff`
- `ms-python.vscode-pylance`
- `dbaeumer.vscode-eslint`
- `esbenp.prettier-vscode`
- `eamodio.gitlens`

### 4.2 JS/TS + backend Node
- `ms-vscode.vscode-typescript-next` (opcional, si quieres TS nightly)
- `usernamehw.errorlens`
- `ms-azuretools.vscode-docker`

### 4.3 YAML/JSON/DevOps
- `redhat.vscode-yaml`
- `tamasfe.even-better-toml`

### 4.4 IA / MCP (manteniendo enfoque productivo)
- Mantener **Copilot Chat** + Serena MCP.
- Evitar solapamientos de varias extensiones-agent activas a la vez (reduce conflictos de code actions y ruido de logs).

---

## 5) Estado final por punto solicitado

- ESLint: **reparado/mitigado** a nivel workspace.
- Serena MCP: **reparado** según doc oficial.
- BestAmigo: **diagnosticado**; pendiente decisión (levantar Ollama o deshabilitar provider).
- Codex 401: **diagnosticado**; pendiente reautenticación.
- Git escaneo continuo: **reparado** (desactivado auto-detection global del workspace).
- Host extension warnings: **diagnosticado**; mitigación propuesta.
- Texto predictivo Copilot: **desactivado**.

---

## 6) Siguiente paso recomendado

Cuando confirmes, puedo preparar una **configuración de extensiones por perfil** (Modo Trabajo / Modo IA / Modo Ligero) para activar/desactivar paquetes en bloque y evitar conflictos entre agentes.

---

## 7) Integración en servidor IA `.16` (fase ejecutada)

Se ejecutó integración **sin alterar el core actual** del laboratorio (todo aditivo):

### 7.1 Verificación remota del stack

Script usado: `ops/multiagent-supervisor/deploy/scripts/verify-remote-ai.ps1`

Resultado repetido: **42/43 checks OK (core OK)**.

Servicios confirmados activos:
- Supervisor `:8787`
- Lab Portal `:8088`
- Mission Control `:8090`
- Portainer `:9002/9443`
- Dozzle `:9999`
- Ollama `:11434` con modelos cargados
- Qdrant `:6333`
- Agent Platform API/UI `:4190/:8092`
- BestAmigo `:4173` (providers: Ollama+Groq+OpenRouter+PuterJWT)

RAG por proyecto: confirmado para `xzonassite`, `cursor-mobile-bridge`, `captajaus`, `crm-royalbroker`, etc.

### 7.2 Ajuste aplicado para robustecer IDE host

Archivo actualizado:
- `xzonassite/ops/multiagent-supervisor/deploy/scripts/start-equipitello-ide-server.ps1`

Mejora añadida:
- Si no existe `node.exe` en servidor, ahora intenta **fallback Docker** (`xzonas-equipitello-ide`) en `:4180`.

### 7.3 Acciones remotas ejecutadas

- `remote-start-lab-ia-services.ps1`
- `open-firewall-equipitello-ide-server.ps1`
- `start-equipitello-ide-server.ps1`
- `deploy-equipitello-ide-server16.ps1 -StartRemote`

### 7.4 Único bloqueo vigente

`equipitello_ide` sigue en timeout (1 check fallando) por una combinación de:

1. **Node ausente en servidor** (confirmado en log histórico), y
2. ejecución remota vía `schtasks` sin feedback confiable, mientras **WinRM no puede establecer sesión** desde este host sin TrustedHosts elevado.

Esto no afecta al núcleo del laboratorio (core sigue en verde), pero sí al endpoint host `:4180`.

### 7.5 Estado final técnico

- Laboratorio IA remoto: **operativo y aprovechando Ollama en servidor**.
- Integración de `cursor-mobile-bridge` y `ops` con RAG/stack remoto: **activa**.
- Pendiente únicamente estabilizar `equipitello_ide :4180` en servidor con ejecución remota administrada (WinRM/TrustedHosts elevado o intervención directa en servidor).

---

## 8) Fallos concretos del prompt original que también quedan recogidos

### 8.1 Serena “difuminado”

Problema original:
- El bloque MCP de Serena incluía `serena@latest` dentro de `args`, lo que no coincide con la forma recomendada por la documentación.

Corrección ya aplicada en el workspace:
- Se corrigió la entrada MCP hacia `serena start-mcp-server` con `--context vscode` y `--project ${workspaceFolder}`.

Estado:
- **Corregido en el workspace**.

### 8.2 ESLint

Problema original:
- `Calculating config file ... failed. Could not find config file.` al inspeccionar el `.code-workspace`.

Corrección ya aplicada:
- Se limitaron directorios/lenguajes válidos y se forzó working directories automático.

Estado:
- **Mitigado en el workspace**.

### 8.3 BestAmigo

Problema original:
- Health check de Ollama fallando (`fetch failed`) en el primer log.

Diagnóstico actual:
- El laboratorio del servidor `.16` sí tiene Ollama operativo y BestAmigo responde sano.

Estado:
- **Resuelto en servidor**.

### 8.4 Codex

Problema original:
- `401 Unauthorized` en `/wham/usage`.

Diagnóstico actual:
- Es un problema de autenticación/sesión de Codex, no del workspace.

Estado:
- **Pendiente reautenticación**.

### 8.5 Git

Problema original:
- `fatal: not a git repository` por auto-detección/escaneo innecesario.

Corrección ya aplicada:
- Se desactivó auto repository detection y la apertura en padres.

Estado:
- **Mitigado en workspace**.

### 8.6 Host de extensiones

Problema original:
- Warnings de `quickfix`/`refactor.*` y mensajes i18n `Modify`/`Review`.

Diagnóstico actual:
- Son warnings de las extensiones instaladas (`copilot-chat`, `claude-dev`) y del propio host; no proceden del código del repo.

Estado:
- **Pendiente decidir si actualizar o aislar extensiones**.

### 8.7 Resumen operativo de lo que falta

- **Serena:** corregido en el workspace.
- **ESLint:** mitigado.
- **BestAmigo:** resuelto.
- **Codex:** pendiente de login.
- **Git:** mitigado.
- **Host de extensión:** pendientes warnings de extensión, no de código.
- **equipitello_ide:** sigue siendo el único servicio funcionalmente no cerrado al 100%.

---

## 9) Cierre local de equipitello + nueva herramienta de verificación

### 9.1 Cierre local de BestAmigo / equipitello

Acciones ejecutadas en este equipo:

- Se desactivó la extensión local `bestamigo.puter-agent`.
- Se detuvo el proceso local escuchando en `:4173`.
- Se reinició `cursor-mobile-bridge` para cargar cambios.

Verificación:

- `:4173` **ya no** escucha localmente.
- `:8095` (bridge) sigue **activo**.

### 9.2 Texto predictivo y aviso WSL

Se reforzó la desactivación de texto predictivo en:

- `ClaudeCodeSystemsPremium.code-workspace`
- `C:\Users\Paterna\AppData\Roaming\Code\User\settings.json`

Además se aplicó mitigación explícita para el popup de WSL:

- `terminal.integrated.useWslProfiles = false`
- perfil por defecto forzado a `PowerShell`
- perfil de automatización forzado a `pwsh.exe`

### 9.3 Herramienta nueva creada dentro de `cursor-mobile-bridge`

Se creó un panel nuevo:

- URL: `http://127.0.0.1:8095/lab-checker`

Archivos creados:

- `cursor-mobile-bridge/static/lab-checker/index.html`
- `cursor-mobile-bridge/static/lab-checker/style.css`
- `cursor-mobile-bridge/static/lab-checker/app.js`

Y se integró en el servidor del bridge:

- `cursor-mobile-bridge/server.js`

### 9.4 Qué comprueba `lab-checker`

- Bridge `/health`
- bootstrap del bridge
- launcher apps
- estado IDE local/remoto
- estado de `equipitello`
- estado del servidor IA remoto
- auditoría de configuración
- Serena en `xzonassite`
- Serena en `cursor-mobile-bridge`
- registro / segmentación AI
- catálogos Hub / IA Ops / equipitello
- Ollama local
- Telegram bridge

### 9.5 Serena en servidor `.16` — estado real

**No**: Serena todavía **no está alojada como servicio dedicado en `.16`**.

Estado actual real:

- Serena está operativo **localmente** vía MCP del workspace / bridge.
- El laboratorio remoto `.16` sí tiene supervisor, RAG, BestAmigo, Ollama y paneles IA.
- El nuevo `lab-checker` incluye un bloque **Serena Control Center** que deja visible esta diferencia.

### 9.6 Aprendizaje / segmentación / entrenamiento continuo

Implementado hoy de forma realista:

- segmentación por proyecto en RAG
- memorias `.serena`
- knowledge files por proyecto
- registro AI por proyecto

Pendiente para una fase posterior:

- desplegar Serena como servicio remoto dedicado en `.16`
- exponer health / control remoto propio de Serena
- construir panel completo de administración Serena server-side