# Plan estratégico — Laboratorio IA EQUIPITELLO (2026)

**Fecha:** 2026-07-12  
**Autor:** agente Cursor (análisis laboratorio multiagent)  
**Alcance:** EQUIPITELLO (`100.78.198.98`) · Servidor IA (`192.168.1.16` / `100.69.11.89`) · Bridge `:8095` · chatbot-unified · xzonassite ops

---

## 1. Visión ambiciosa (north star)

**Un control plane unificado** desde móvil (Hub PWA), Telegram y eventualmente WhatsApp, donde **múltiples agentes especializados** operan sobre:

- código (Cursor + VS Code + Serena MCP),
- infra (supervisor `:8787`, crons HTTP, F6 mirror),
- negocio (xzonas, CaptaJaus, Royal Broker, campañas chatbot),
- conocimiento (RAG híbrido, ingest Copilot/Cursor transcripts),

con **mínima intervención humana** en tareas repetitivas y **aprobación humana** solo en gates de riesgo (deploy prod, BD masiva, pagos).

---

## 2. Estado actual (julio 2026)

### 2.1 Nodos físicos

| Nodo | Rol | Stack principal |
|------|-----|-------------------|
| **EQUIPITELLO** | Dev + mirror origen + Bridge móvil | XAMPP htdocs, Node `:8095`, ALimpiezas `:8090`, Tailscale |
| **Servidor IA .16** | Lab producción lean | Docker multiagent `:8787`, RAG, HACS, Mission Control, Baileys `:3030` (según stack) |
| **SiteGround** | Prod xzonasvalencia.com | Sin SSH — solo SFTP + panel + crons HTTP |
| **Lab :9080** | Réplica BD/media xzonas | Sync cada 6h, grid, captación MVP |

### 2.2 Multiagent supervisor (fuente: `ESTADO-FASES.md`)

| Fase | Estado |
|------|--------|
| F0–F5 Mission Control | ✅ |
| F6 Mirror SMB | ⏳ SMB roto → **fallback ZIP** operativo |
| HACS colaboración | ✅ API + portal lab |
| Copilot → RAG ingest | ✅ scripts |
| Bridge F1.5 webhook misiones | ✅ |
| Captación lab MVP | ⏳ slice inicial |

**Verify remoto típico:** 31/33 GO en `:8787`.

### 2.3 Bridge móvil (`cursor-mobile-bridge`)

| Pieza | Estado jul-12 |
|-------|----------------|
| Hub `/hub` | PWA 3D v2 — apps orbit + MCP strip + comandos en `<details>` |
| Chat Mirror `/mirror` | 161 chats catalogados; fix sintaxis `mirror.js` + cache bust |
| Apps `/apps` | Carga **fast** (`?fast=1`) + health background |
| Catálogo comandos | 47 multiagent |
| Discovery htdocs | Token requerido |

### 2.4 Chatbot (`chatbot/chatbot-unified`)

| Canal | Estado |
|-------|--------|
| Telegram | Panel + bot existente — **pendiente** unificar con Bridge como control plane |
| WhatsApp Meta | Documentado (`WHATSAPP_META_PROCESS.md`) |
| WhatsApp gratis test | DRY_RUN ✅ · Evolution API ✅ integrado · Baileys self-host |
| Campañas | Panel `whatsapp_hub.php` — captación/fidelización diseñadas, no enlazadas al Hub |

### 2.5 IDE como fuente de entrenamiento

- **Cursor:** transcripts JSONL → Chat Mirror + ingest RAG (`ingest-copilot-knowledge.ps1`)
- **VS Code Copilot:** metadatos sesión (historial completo variable)
- **Serena MCP:** edición simbólica + memorias — **hub MCP** en roadmap

---

## 3. Problemas reales detectados (operador)

1. **Mirror SyntaxError** — corregido en repo; requiere reinicio bridge + `?v=20260712`.
2. **Apps lentas** — causa: `probeHealth()` secuencial ~42× timeout. Mitigación: `fast=1` + caché 90s + health async.
3. **Diseño 3D “no se nota”** — v1 era decoración CSS; v2 añade capas depth, tiles 3D con tilt, apps como entry principal en Hub.
4. **Duplicación autostart** — auditado; trays Royal Broker restaurados.
5. **SMB F6** — no bloqueante; ZIP + robocopy push alternativo.

---

## 4. Arquitectura objetivo (multi-servidor)

```mermaid
flowchart TB
  subgraph control [Control Plane]
    Hub[Bridge Hub PWA :8095]
    TG[Telegram Bot]
    WA[WhatsApp Evolution/Baileys]
  end

  subgraph equip [EQUIPITELLO]
    Cursor[Cursor IDE]
    VSCode[VS Code]
    Bridge[Node Bridge]
    Htdocs[htdocs projects]
  end

  subgraph ia [Servidor IA .16]
    Sup[Supervisor :8787]
    RAG[RAG / Vector]
    MC[Mission Control]
    Agents[Agentes especializados]
  end

  subgraph mcp [MCP Layer]
    Serena[Serena user-serena]
    OSS[MCP OSS catalog]
  end

  Hub --> Bridge
  TG --> Bridge
  WA --> chatbot[chatbot-unified]
  chatbot --> Bridge
  Bridge --> Sup
  Bridge --> Htdocs
  Cursor --> Bridge
  VSCode --> Bridge
  Serena --> Cursor
  Sup --> RAG
  Sup --> Agents
  Agents --> MC
```

### Principios multi-servidor

1. **Un token bridge** (`X-Bridge-Token`) para EQUIPITELLO; **supervisor token** para `:8787`.
2. **Nuevo servidor** = registrar en `equipitello-apps.json` + Tailscale + agente worker que pull misiones de cola central.
3. **No duplicar** stacks pesados (Ollama, RAG master) — un **nodo knowledge** primario, réplicas read-only opcionales.
4. **F6 / git** como sync código; **RAG ingest** como sync conocimiento (distinto ciclo).

---

## 5. Roadmap por fases

### Fase A — Estabilización (1–2 semanas) ← **AHORA**

- [x] Fix mirror.js + favicon bridge
- [x] Launcher fast + health background
- [x] Hub 3D v2 con apps orbit
- [ ] Reinicio bridge en EQUIPITELLO + verificación móvil usuario
- [ ] Telegram: comandos `/hub`, `/mirror`, `/run`, `/status` vía webhook bridge
- [ ] Documentar catálogo MCP en Hub (enlace a panel o markdown servido)

### Fase B — Control plane Telegram (2–4 semanas)

- Refactor `chatbot-unified` bot → **API adapter** hacia `8095/api/hub/run` y `/api/chat-mirror/feed`
- Menús inline: proyectos, apps online, últimas misiones supervisor
- Notificaciones push: misión completada (F1.5 ya existe en supervisor → extender a Telegram)
- VS Code: comando workspace "Enviar sesión a lab" → ingest RAG

### Fase C — WhatsApp captación (paralelo, 2–4 semanas)

**No existe "cuenta WhatsApp Business 100% gratis ilimitada" oficial.** Opciones reales:

| Opción | Uso |
|--------|-----|
| `WHATSAPP_DRY_RUN=true` | Dev campañas sin coste |
| Meta Cloud API tier gratis | ~1000 conv/mes, 5 testers sin verificar negocio |
| **Evolution API** (recomendado lab) | QR con número secundario, Tailscale, Apache 2.0 |
| Baileys `:3030` en servidor | Ya en stack; integrar con `EvolutionWhatsAppProvider.php` |

Pasos:

1. Desplegar Evolution en Tailscale (doc existente `WHATSAPP_FREE_TESTING.md`)
2. Enlazar Hub card → `chatbot-unified/panel/whatsapp_hub.php` (lab/prod según env)
3. Campañas captación xzonas + Royal Broker con opt-in (`whatsapp_consents`)
4. Webhook unificado chatbot ↔ supervisor para leads → `lab_commercial_leads`

### Fase D — Multi-agente autónomo (1–3 meses)

| Agente | Responsabilidad |
|--------|-----------------|
| **dev-fullstack** | Cursor/Bridge — código PHP/JS |
| **seo-growth** | Ya en HACS — keywords, captación |
| **ops-sre** | Health daily, verify-remote-ai, crons |
| **rag-librarian** | Ingest transcripts, dedup, index |
| **reviewer** | Bugbot/security pre-deploy |
| **campaign** | Telegram/WhatsApp nurturing |

Orquestación: `MultiAgentOrchestrator` en supervisor + cola misiones F1.4.

### Fase E — Nuevos servidores (3–6 meses)

1. **Plantilla Terraform/Ansible** (o scripts PS1 existentes) para nodo worker
2. Registro automático: heartbeat → supervisor → aparece en Hub apps
3. **Edge opcional:** VPS barato solo para Evolution WhatsApp + webhook (aislar riesgo Baileys)
4. VS Code Server / code-server en nodo dedicado entrenamiento (opcional)

### Fase F — MCP Hub (continuo)

Catálogo OSS prioritario (ver `docs/cursorCHATagent/MCP_OPEN_SOURCE_CATALOGO.md`):

- **Serena** — código simbólico (ya activo)
- **filesystem / git** — repos
- **postgres/mysql** — lab BD (solo LAN)
- **browser** — QA visual
- **slack/telegram** — notificaciones

UI Hub: sección MCP con estado, versión, toggle enable/disable por proyecto.

---

## 6. WhatsApp “gratuito” — expectativas honestas

- **Meta no regala** campañas marketing masivas; el tier gratis es conversacional limitado.
- **Evolution + número secundario** es el camino open source más usado en foros/GitHub para **lab**.
- **Riesgo:** ban si spam; usar opt-in, DRY_RUN en dev, número no personal.
- **Implementación ya en repo:** `chatbot-unified/docs/WHATSAPP_FREE_TESTING.md`, `EvolutionWhatsAppProvider.php`.

---

## 7. VS Code + Cursor como gemelos de aprendizaje

| Fuente | Destino |
|--------|---------|
| Cursor transcripts | Chat Mirror → RAG ingest |
| VS Code Copilot metadata | Mirror (parcial) → ampliar parser |
| Commits / PRs | Mission webhook → supervisor |
| Panel herramientas xzonas | Informes `XZONAS_AGENT_REPORT` → RAG |

Acción: mantener **VS Code abierto** en EQUIPITELLO para proyectos no-Cursor (Royal Broker tray, scripts PS1).

---

## 8. KPIs de éxito

| KPI | Objetivo 6 meses |
|-----|------------------|
| Tiempo carga Hub apps | < 500 ms perceived (fast path) |
| Chats mirror indexados | > 200, 4 fuentes separadas |
| Misiones autónomas / semana | > 20 con < 5% rollback |
| Leads captación vía WhatsApp lab | pipeline medible |
| Verify supervisor | 33/33 estable |
| Deploy prod xzonas | 100% con OK humano documentado |

---

## 9. Próximas acciones inmediatas (operador)

1. **Reiniciar bridge:** `powershell -File C:\xampp\htdocs\cursor-mobile-bridge\cursor-bridge-manager.ps1 -Restart`
2. **Probar móvil:** `http://100.78.198.98:8095/hub` — apps deben aparecer al instante
3. **Probar mirror:** `/mirror` — sin error consola
4. **Purgar caché** Safari/Chrome si persiste JS antiguo
5. **WhatsApp lab:** seguir `chatbot-unified/docs/WHATSAPP_FREE_TESTING.md` sección Evolution

---

## 10. Referencias

- `xzonassite/ops/multiagent-supervisor/deploy/ESTADO-FASES.md`
- `xzonassite/ops/multiagent-supervisor/docs/_organizado/01-roadmap-planificacion/PLAN-IMPLEMENTACION-AGENTOS-100.md`
- `chatbot/chatbot-unified/docs/WHATSAPP_FREE_TESTING.md`
- `cursor-mobile-bridge/tools/hub-verify.mjs`
- `docs/cursorCHATagent/MCP_OPEN_SOURCE_CATALOGO.md`