npm - sinapse-ai - Versions diffs - 5.0.8 → 6.0.1 - Mend

sinapse-ai 5.0.8 → 6.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (660) hide show

package/docs/es/architecture/high-level-architecture.md DELETED Viewed

@@ -1,357 +0,0 @@
-<!-- Traducción: ES | Original: /docs/en/architecture/high-level-architecture.md | Sincronización: 2026-01-26 -->
-# Arquitectura de Alto Nivel SINAPSE v4
-> 🌐 [EN](../../architecture/high-level-architecture.md) | [PT](../../pt/architecture/high-level-architecture.md) | **ES**
----
-**Versión:** 2.1.0
-**Última Actualización:** 2025-12-09
-**Estado:** Documento Oficial de Arquitectura
----
-## 📋 Tabla de Contenidos
-- [Visión General](#visión-general)
-- [Diagrama de Arquitectura](#diagrama-de-arquitectura)
-- [Arquitectura Modular](#arquitectura-modular)
-- [Estrategia Multi-Repo](#estrategia-multi-repo)
-- [Stack Tecnológico](#stack-tecnológico)
-- [Estructura de Directorios](#estructura-de-directorios)
-- [Componentes Clave](#componentes-clave)
-- [Quality Gates](#quality-gates)
----
-## Visión General
-**SINAPSE (AI Operating System)** es un framework sofisticado para orquestar agentes de IA, workers y humanos en flujos de trabajo complejos de desarrollo de software. La versión 2.1 introduce una arquitectura modular con 4 módulos, estrategia multi-repositorio y quality gates de 3 capas.
-### Capacidades Clave v4.2
-| Capacidad                     | Descripción                                                                   |
-| ----------------------------- | ----------------------------------------------------------------------------- |
-| **11 Agentes Especializados** | Dev, QA, Architect, PM, PO, SM, Analyst, Data Engineer, DevOps, UX, Master    |
-| **115+ Tareas Ejecutables**   | Creación de stories, generación de código, testing, deployment, documentación |
-| **52+ Plantillas**            | PRDs, stories, documentos de arquitectura, reglas IDE, quality gates          |
-| **Arquitectura de 4 Módulos** | Core, Development, Product, Infrastructure                                    |
-| **Quality Gates de 3 Capas**  | Pre-commit, Automatización PR, Revisión Humana                                |
-| **Estrategia Multi-Repo**     | 3 repositorios públicos + 2 privados                                          |
-| **Sistema de Squad**          | Equipos modulares de agentes IA (ETL, Creator, MMOS)                          |
----
-## Diagrama de Arquitectura
-### Arquitectura de 4 Módulos
-```
-┌─────────────────────────────────────────────────────────────────────────┐
-│                     FRAMEWORK SINAPSE v4                                 │
-│                     ═══════════════════                                 │
-│                                                                         │
-│   ┌─────────────────────────────────────────────────────────────────┐   │
-│   │                        CLI / HERRAMIENTAS                        │   │
-│   │  (sinapse agents, sinapse tasks, sinapse squads, sinapse workflow)          │   │
-│   └─────────────────────────────────────────────────────────────────┘   │
-│                                │                                        │
-│          ┌────────────────────┼────────────────────┐                   │
-│          │                    │                    │                   │
-│          ▼                    ▼                    ▼                   │
-│   ┌──────────────┐   ┌──────────────┐   ┌─────────────────┐           │
-│   │ DEVELOPMENT  │   │   PRODUCT    │   │ INFRASTRUCTURE  │           │
-│   │   MÓDULO     │   │   MÓDULO     │   │    MÓDULO       │           │
-│   │ ──────────── │   │ ──────────── │   │ ─────────────── │           │
-│   │ • 11 Agentes │   │ • 52+ Plntls │   │ • 55+ Scripts   │           │
-│   │ • 115+ Tareas│   │ • 11 Chklsts │   │ • Configs Tool  │           │
-│   │ • 7 Wrkflws  │   │ • PM Data    │   │ • Integraciones │           │
-│   │ • Dev Scripts│   │              │   │ • PM Adapters   │           │
-│   └──────┬───────┘   └──────┬───────┘   └────────┬────────┘           │
-│          │                  │                    │                     │
-│          └──────────────────┼────────────────────┘                     │
-│                             │                                          │
-│                             ▼                                          │
-│   ┌─────────────────────────────────────────────────────────────────┐   │
-│   │                      MÓDULO CORE                                 │   │
-│   │                      ═══════════                                 │   │
-│   │                                                                  │   │
-│   │   ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────┐ │   │
-│   │   │   Config    │  │  Registry   │  │    Quality Gates        │ │   │
-│   │   │   System    │  │  (Service   │  │    (3 Capas)            │ │   │
-│   │   │             │  │  Discovery) │  │                         │ │   │
-│   │   └─────────────┘  └─────────────┘  └─────────────────────────┘ │   │
-│   │                                                                  │   │
-│   │   ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────┐ │   │
-│   │   │    MCP      │  │   Session   │  │     Elicitation         │ │   │
-│   │   │   System    │  │   Manager   │  │       Engine            │ │   │
-│   │   │             │  │             │  │                         │ │   │
-│   │   └─────────────┘  └─────────────┘  └─────────────────────────┘ │   │
-│   │                                                                  │   │
-│   │   SIN DEPENDENCIAS INTERNAS (Capa de Fundación)                  │   │
-│   └─────────────────────────────────────────────────────────────────┘   │
-│                                                                         │
-└─────────────────────────────────────────────────────────────────────────┘
-```
-### Relaciones entre Módulos
-```
-┌────────────────────────────────────────────────────────────────────────┐
-│                    FLUJO DE DEPENDENCIAS DE MÓDULOS                     │
-│                                                                         │
-│                         ┌──────────────┐                                │
-│                         │  CLI/Tools   │                                │
-│                         └──────┬───────┘                                │
-│                                │                                        │
-│              ┌─────────────────┼─────────────────┐                      │
-│              │                 │                 │                      │
-│              ▼                 ▼                 ▼                      │
-│     ┌────────────────┐ ┌────────────────┐ ┌────────────────┐           │
-│     │  development/  │ │    product/    │ │infrastructure/ │           │
-│     │                │ │                │ │                │           │
-│     │  • Agentes     │ │  • Plantillas  │ │  • Scripts     │           │
-│     │  • Tareas      │ │  • Checklists  │ │  • Herramientas│           │
-│     │  • Workflows   │ │  • PM Data     │ │  • Integraciones│          │
-│     └───────┬────────┘ └───────┬────────┘ └───────┬────────┘           │
-│             │                  │                  │                     │
-│             │          depende solo de           │                     │
-│             └──────────────────┼──────────────────┘                     │
-│                                │                                        │
-│                                ▼                                        │
-│                      ┌────────────────┐                                 │
-│                      │     core/      │                                 │
-│                      │                │                                 │
-│                      │  SIN DEPEND.   │                                 │
-│                      │  INTERNAS      │                                 │
-│                      └────────────────┘                                 │
-│                                                                         │
-│   REGLAS:                                                               │
-│   • core/ no tiene dependencias internas                                │
-│   • development/, product/, infrastructure/ dependen SOLO de core/      │
-│   • Las dependencias circulares están PROHIBIDAS                        │
-│   • CLI/Tools puede acceder a cualquier módulo                          │
-│                                                                         │
-└────────────────────────────────────────────────────────────────────────┘
-```
----
-## Estrategia Multi-Repo
-### Estructura de Repositorios
-```
-┌─────────────────────────────────────────────────────────────────────────┐
-│                    ORGANIZACIÓN SINAPSE                                  │
-│                                                                         │
-│   REPOSITORIOS PÚBLICOS                                                 │
-│   ═════════════════════                                                 │
-│                                                                         │
-│   ┌────────────────────┐     ┌────────────────────┐                    │
-│   │  SinapseAI/         │     │  SinapseAI/         │                    │
-│   │  sinapse-ai         │     │  sinapse-squads       │                    │
-│   │  (MIT)  │◄────│  (MIT)             │                    │
-│   │                    │     │                    │                    │
-│   │  • Framework Core  │     │  • ETL Squad       │                    │
-│   │  • 11 Agentes Base │     │  • Creator Squad   │                    │
-│   │  • Quality Gates   │     │  • MMOS Squad      │                    │
-│   │  • Hub Discusiones │     │                    │                    │
-│   └────────────────────┘     └────────────────────┘                    │
-│            │                                                            │
-│            │ dependencia opcional                                       │
-│            ▼                                                            │
-│   ┌────────────────────┐                                               │
-│   │  SinapseAI/         │                                               │
-│   │  mcp-ecosystem     │                                               │
-│   │  (Apache 2.0)      │                                               │
-│   │                    │                                               │
-│   │  • Docker MCP      │                                               │
-│   │  • Configs IDE     │                                               │
-│   │  • MCP Presets     │                                               │
-│   └────────────────────┘                                               │
-│                                                                         │
-│   REPOSITORIOS PRIVADOS                                                 │
-│   ═════════════════════                                                 │
-│                                                                         │
-│   ┌────────────────────┐     ┌────────────────────┐                    │
-│   │  SinapseAI/mmos     │     │  SinapseAI/         │                    │
-│   │  (Proprietary+NDA) │     │  certified-partners│                    │
-│   │                    │     │  (Proprietary)     │                    │
-│   │  • MMOS Minds      │     │  • Premium Squads  │                    │
-│   │  • DNA Mental™     │     │  • Portal Partners │                    │
-│   └────────────────────┘     └────────────────────┘                    │
-│                                                                         │
-└─────────────────────────────────────────────────────────────────────────┘
-```
-### Alcance de Paquetes npm
-| Paquete               | Registry    | Licencia       |
-| --------------------- | ----------- | -------------- |
-| `@sinapse/core`          | npm público | MIT            |
-| `@sinapse/squad-etl`     | npm público | MIT            |
-| `@sinapse/squad-creator` | npm público | MIT            |
-| `@sinapse/squad-mmos`    | npm público | MIT            |
-| `@sinapse/mcp-presets`   | npm público | Apache 2.0     |
----
-## Stack Tecnológico
-| Categoría       | Tecnología            | Versión | Notas                             |
-| --------------- | --------------------- | ------- | --------------------------------- |
-| Runtime         | Node.js               | ≥18.0.0 | Plataforma para todos los scripts |
-| Lenguaje        | TypeScript/JavaScript | ES2022  | Desarrollo principal              |
-| Definición      | Markdown + YAML       | N/A     | Agentes, tareas, plantillas       |
-| Gestor Paquetes | npm                   | ≥9.0.0  | Gestión de dependencias           |
-| Quality Gates   | Husky + lint-staged   | Latest  | Hooks pre-commit                  |
-| Code Review     | CodeRabbit            | Latest  | Revisión potenciada por IA        |
-| CI/CD           | GitHub Actions        | N/A     | Workflows de automatización       |
----
-## Estructura de Directorios
-### Estructura Actual (v4)
-```
-sinapse-ai/
-├── .sinapse-ai/                    # Capa del framework
-│   ├── core/                      # Módulo core (fundación)
-│   │   ├── config/                # Gestión de configuración
-│   │   ├── registry/              # Service Discovery
-│   │   ├── quality-gates/         # Sistema QG de 3 capas
-│   │   ├── mcp/                   # Configuración global MCP
-│   │   └── session/               # Gestión de sesiones
-│   │
-│   ├── development/               # Módulo de desarrollo
-│   │   ├── agents/                # 11 definiciones de agentes
-│   │   ├── tasks/                 # 115+ definiciones de tareas
-│   │   ├── workflows/             # 7 definiciones de workflows
-│   │   └── scripts/               # Scripts de desarrollo
-│   │
-│   ├── product/                   # Módulo de producto
-│   │   ├── templates/             # 52+ plantillas
-│   │   ├── checklists/            # 11 checklists
-│   │   └── data/                  # Base de conocimiento PM
-│   │
-│   ├── infrastructure/            # Módulo de infraestructura
-│   │   ├── scripts/               # 55+ scripts de infraestructura
-│   │   ├── tools/                 # CLI, MCP, configs locales
-│   │   └── integrations/          # PM adapters
-│   │
-│   └── docs/                      # Documentación del framework
-│       └── standards/             # Documentos de estándares
-│
-├── docs/                          # Documentación del proyecto
-│   ├── stories/                   # Stories de desarrollo
-│   ├── architecture/              # Documentos de arquitectura
-│   └── epics/                     # Planificación de épicas
-│
-├── squads/                        # Implementaciones de Squad
-│   ├── etl/                       # ETL Squad
-│   ├── creator/                   # Creator Squad
-│   └── mmos-mapper/               # MMOS Squad
-│
-├── .github/                       # Automatización GitHub
-│   ├── workflows/                 # Workflows CI/CD
-│   ├── ISSUE_TEMPLATE/            # Plantillas de issues
-│   └── CODEOWNERS                 # Propiedad del código
-│
-└── .husky/                        # Git hooks (Capa 1 QG)
-```
----
-## Componentes Clave
-### Resumen de Módulos
-| Módulo             | Ruta                         | Propósito                | Contenidos Clave                    |
-| ------------------ | ---------------------------- | ------------------------ | ----------------------------------- |
-| **Core**           | `.sinapse-ai/core/`           | Fundación del framework  | Config, Registry, QG, MCP, Session  |
-| **Development**    | `.sinapse-ai/development/`    | Artefactos de desarrollo | Agentes, Tareas, Workflows, Scripts |
-| **Product**        | `.sinapse-ai/product/`        | Artefactos PM            | Plantillas, Checklists, Data        |
-| **Infrastructure** | `.sinapse-ai/infrastructure/` | Config del sistema       | Scripts, Tools, Integraciones       |
-### Sistema de Agentes
-| Agente | ID              | Arquetipo    | Responsabilidad            |
-| ------ | --------------- | ------------ | -------------------------- |
-| Dex    | `dev`           | Constructor  | Implementación de código   |
-| Quinn  | `qa`            | Guardián     | Aseguramiento de calidad   |
-| Aria   | `architect`     | Arquitecto   | Arquitectura técnica       |
-| Nova   | `po`            | Visionario   | Backlog de producto        |
-| Kai    | `pm`            | Equilibrador | Estrategia de producto     |
-| River  | `sm`            | Facilitador  | Facilitación de procesos   |
-| Zara   | `analyst`       | Explorador   | Análisis de negocio        |
-| Dara   | `data-engineer` | Arquitecto   | Ingeniería de datos        |
-| Felix  | `devops`        | Optimizador  | CI/CD y operaciones        |
-| Uma    | `ux-expert`     | Creador      | Experiencia de usuario     |
-| Pax    | `sinapse-master`   | Orquestador  | Orquestación del framework |
----
-## Quality Gates
-### Sistema de Quality Gates de 3 Capas
-```
-┌─────────────────────────────────────────────────────────────────────────┐
-│                     QUALITY GATES 3 CAPAS                               │
-│                                                                         │
-│   ┌───────────────────────────────────────────────────────────────────┐ │
-│   │ CAPA 1: PRE-COMMIT (Local)                                        │ │
-│   │ ══════════════════════════                                        │ │
-│   │ • ESLint, Prettier, TypeScript                                    │ │
-│   │ • Tests unitarios (rápidos)                                       │ │
-│   │ • Herramienta: Husky + lint-staged                                │ │
-│   │ • Bloqueante: No se puede hacer commit si falla                   │ │
-│   │ • Issues detectados: 30%                                          │ │
-│   └───────────────────────────────────────────────────────────────────┘ │
-│                                │                                        │
-│                                ▼                                        │
-│   ┌───────────────────────────────────────────────────────────────────┐ │
-│   │ CAPA 2: AUTOMATIZACIÓN PR (CI/CD)                                 │ │
-│   │ ═════════════════════════════════                                 │ │
-│   │ • Revisión IA CodeRabbit                                          │ │
-│   │ • Tests de integración, análisis de cobertura                     │ │
-│   │ • Escaneo de seguridad, benchmarks de rendimiento                 │ │
-│   │ • Herramienta: GitHub Actions + CodeRabbit                        │ │
-│   │ • Bloqueante: Checks requeridos para merge                        │ │
-│   │ • Issues detectados: +50% adicional (80% total)                   │ │
-│   └───────────────────────────────────────────────────────────────────┘ │
-│                                │                                        │
-│                                ▼                                        │
-│   ┌───────────────────────────────────────────────────────────────────┐ │
-│   │ CAPA 3: REVISIÓN HUMANA (Estratégica)                             │ │
-│   │ ═════════════════════════════════════                             │ │
-│   │ • Alineación arquitectónica                                       │ │
-│   │ • Corrección de lógica de negocio                                 │ │
-│   │ • Casos edge, calidad de documentación                            │ │
-│   │ • Herramienta: Experiencia humana                                 │ │
-│   │ • Bloqueante: Aprobación final requerida                          │ │
-│   │ • Issues detectados: 20% final (100% total)                       │ │
-│   └───────────────────────────────────────────────────────────────────┘ │
-│                                                                         │
-│   RESULTADO: 80% de issues detectados automáticamente                   │
-│           Tiempo de revisión humana: 30 min/PR (vs 2-4h en v2.0)       │
-│                                                                         │
-└─────────────────────────────────────────────────────────────────────────┘
-```
----
-## Documentos Relacionados
-- [Sistema de Módulos](./module-system.md) - Arquitectura detallada de módulos
-- [ARCHITECTURE-INDEX.md](./ARCHITECTURE-INDEX.md) - Índice completo de documentación
-- [SINAPSE-LIVRO-DE-OURO-V2.1-COMPLETE.md](../../../.sinapse-ai/docs/standards/SINAPSE-LIVRO-DE-OURO-V2.1-COMPLETE.md) - Guía completa del framework
----
-**Última Actualización:** 2025-12-09
-**Versión:** 2.1.0
-**Responsable:** @architect (Aria)

package/docs/es/architecture/introduction.md DELETED Viewed

@@ -1,21 +0,0 @@
-<!-- Traducción: ES | Original: /docs/en/architecture/introduction.md | Sincronización: 2026-01-26 -->
-# Introducción
-> 🌐 [EN](../../architecture/introduction.md) | [PT](../../pt/architecture/introduction.md) | **ES**
----
-Este documento captura el estado actual del codebase de **SINAPSE**, sirviendo como la arquitectura de referencia para el desarrollo de la **Fase 1 de SINAPSE (MVP hasta el FR4)**. Describe los patrones, componentes y tecnologías existentes sobre los cuales se construirán las nuevas funcionalidades.
-## Alcance del Documento
-Documentación completa del framework SINAPSE para servir como baseline para el MVP de SINAPSE, que incluye: Rebranding, Workflow de Setup de IDE, Capa de Memoria con LlamaIndex y el Meta-Agente `sinapse-developer`.
-## Registro de Cambios
-| Fecha | Versión | Descripción | Autor |
-| :--- | :--- | :--- | :--- |
-| 2025-07-24 | 1.0 | Generación inicial de la arquitectura base. | Winston |
-| 2025-07-24 | 2.0 | Estructura de directorios corregida basada en el input del usuario. | Winston |
-| 2025-07-24 | 3.0 | Adición de los nuevos componentes del MVP. | Winston |

package/docs/es/architecture/mcp-api-keys-management.md DELETED Viewed

@@ -1,246 +0,0 @@
-# Gestión de Claves de API MCP
-> 🌐 [EN](../../architecture/mcp-api-keys-management.md) | [PT](../../pt/architecture/mcp-api-keys-management.md) | **ES**
----
-**Versión:** 1.0.0
-**Última Actualización:** 2026-01-26
-**Estado:** Referencia Oficial
----
-## Visión General
-Este documento describe las mejores prácticas para gestionar claves de API utilizadas por servidores MCP (Model Context Protocol) en SINAPSE. La gestión adecuada de claves de API es crítica para la seguridad e integridad operacional.
----
-## Arquitectura MCP en SINAPSE
-SINAPSE utiliza Docker MCP Toolkit como la infraestructura principal de MCP:
-```
-┌─────────────────────────────────────────────────────────────┐
-│                    Arquitectura MCP                         │
-├─────────────────────────────────────────────────────────────┤
-│                                                             │
-│   Directo en Claude Code (~/.claude.json)                   │
-│   ┌─────────────────────────────────────────────────────┐   │
-│   │  playwright     → Automatización de navegador       │   │
-│   │  desktop-commander → Operaciones docker gateway     │   │
-│   └─────────────────────────────────────────────────────┘   │
-│                           │                                 │
-│                           ▼                                 │
-│   Dentro de Docker Desktop (vía docker-gateway)             │
-│   ┌─────────────────────────────────────────────────────┐   │
-│   │  EXA           → Búsqueda web, investigación        │   │
-│   │  Context7      → Documentación de librerías         │   │
-│   │  Apify         → Web scraping, extracción de datos  │   │
-│   └─────────────────────────────────────────────────────┘   │
-│                                                             │
-└─────────────────────────────────────────────────────────────┘
-```
----
-## Servidores MCP Soportados
-| Servidor MCP | Clave Requerida | Variable de Entorno | Ubicación |
-|--------------|-----------------|---------------------|-----------|
-| EXA | Sí | `EXA_API_KEY` | Docker MCP config.yaml |
-| Context7 | No | N/A | N/A |
-| Apify | Sí | `APIFY_API_TOKEN` | Docker MCP docker-mcp.yaml |
-| Playwright | No | N/A | N/A |
----
-## Métodos de Configuración
-### Método 1: Docker MCP Toolkit (Principal)
-Docker MCP Toolkit gestiona claves de API a través de sus archivos de configuración.
-**Para EXA (usa sección apiKeys):**
-Ubicación: `~/.docker/mcp/config.yaml`
-```yaml
-# ~/.docker/mcp/config.yaml
-apiKeys:
-  exa: "tu-clave-api-exa-aqui"
-```
-**Para servidores que requieren variables de entorno (Apify, etc.):**
-Ubicación: `~/.docker/mcp/catalogs/docker-mcp.yaml`
-```yaml
-# ~/.docker/mcp/catalogs/docker-mcp.yaml
-apify:
-  env:
-    - name: APIFY_API_TOKEN
-      value: 'tu-token-apify-aqui'  # Hardcode directamente (ver Problemas Conocidos)
-```
-### Método 2: Variables de Entorno
-Para desarrollo local o configuraciones sin Docker:
-```bash
-# ~/.zshrc o ~/.bashrc
-export EXA_API_KEY="tu-clave-api-exa"
-export APIFY_API_TOKEN="tu-token-apify"
-```
-### Método 3: Archivo .env del Proyecto
-Para configuración específica del proyecto:
-```bash
-# .env (agregar a .gitignore!)
-EXA_API_KEY=tu-clave-api-exa
-APIFY_API_TOKEN=tu-token-apify
-```
----
-## Gobernanza MCP en SINAPSE
-**IMPORTANTE:** Toda la gestión de infraestructura MCP es manejada EXCLUSIVAMENTE por el **Agente DevOps (@devops / Gage)**.
-| Operación | Agente | Comando |
-|-----------|--------|---------|
-| Buscar catálogo MCP | DevOps | `*search-mcp` |
-| Agregar servidor MCP | DevOps | `*add-mcp` |
-| Listar MCPs habilitados | DevOps | `*list-mcps` |
-| Remover servidor MCP | DevOps | `*remove-mcp` |
-| Configurar Docker MCP | DevOps | `*setup-mcp-docker` |
-Otros agentes (Dev, Architect, etc.) son **consumidores** de MCP, no administradores.
----
-## Mejores Prácticas de Seguridad
-### HACER
-- Almacenar claves de API en variables de entorno o archivos de config seguros
-- Agregar archivos `.env` a `.gitignore`
-- Usar claves de API diferentes para desarrollo y producción
-- Rotar claves de API periódicamente (recomendado cada 90 días)
-- Usar claves de API de solo lectura cuando no se necesita acceso de escritura
-- Monitorear uso de API para anomalías
-### NO HACER
-- Commitear claves de API al control de versiones
-- Compartir claves de API en chat o email
-- Usar claves de producción en desarrollo
-- Almacenar claves en archivos de texto plano en ubicaciones compartidas
-- Hardcodear claves en el código fuente
----
-## Problemas Conocidos
-### Bug de Secrets de Docker MCP (Dic 2025)
-**Problema:** El almacenamiento de secrets del Docker MCP Toolkit y la interpolación de templates no funcionan correctamente. Las credenciales configuradas vía `docker mcp secret set` NO se pasan a los containers.
-**Síntomas:**
-- `docker mcp tools ls` muestra "(N prompts)" en lugar de "(N tools)"
-- El servidor MCP inicia pero falla la autenticación
-- La salida verbose muestra `-e ENV_VAR` sin valores
-**Solución:** Editar `~/.docker/mcp/catalogs/docker-mcp.yaml` directamente con valores hardcodeados:
-```yaml
-# En lugar de usar referencia de secrets
-apify:
-  env:
-    - name: APIFY_API_TOKEN
-      value: 'valor-real-del-token'  # Hardcode directamente
-```
-**MCPs Afectados:** Cualquier MCP que requiera autenticación (Apify, Notion, Slack, etc.)
-**MCPs Funcionando:** EXA funciona porque su clave está en `~/.docker/mcp/config.yaml` bajo `apiKeys`
----
-## Procedimiento de Rotación de Claves
-### Paso 1: Generar Nueva Clave
-1. Inicia sesión en el dashboard del proveedor de servicio (EXA, Apify, etc.)
-2. Genera una nueva clave de API
-3. Anota la nueva clave de forma segura
-### Paso 2: Actualizar Configuración
-```bash
-# Actualizar config de Docker MCP
-vim ~/.docker/mcp/config.yaml
-# O para MCPs basados en env
-vim ~/.docker/mcp/catalogs/docker-mcp.yaml
-```
-### Paso 3: Verificar Nueva Clave
-```bash
-# Reiniciar Docker MCP (si usas Docker Desktop MCP)
-# O reiniciar Claude Code para recargar configuración
-# Probar la conexión usando @devops
-@devops *list-mcps
-```
-### Paso 4: Revocar Clave Anterior
-1. Regresa al dashboard del proveedor de servicio
-2. Revoca/elimina la clave de API anterior
-3. Verifica que la clave anterior ya no funciona
----
-## Solución de Problemas
-### Error "Autenticación fallida"
-1. Verifica que la clave de API es correcta (sin espacios extra)
-2. Verifica si la clave ha expirado
-3. Verifica si la clave tiene los permisos necesarios
-4. Verifica si se excedieron los límites de uso
-### Claves No Siendo Leídas
-1. Reinicia Claude Code o tu IDE
-2. Verifica la sintaxis del archivo de config (YAML)
-3. Verifica los permisos del archivo
-4. Para Docker MCP, verifica que Docker Desktop está corriendo
-### Herramienta MCP Muestra "prompts" en Lugar de "tools"
-Esto indica el bug de secrets. Usa la solución hardcodeada en docker-mcp.yaml.
----
-## Fuentes de Claves de API
-| Servicio | Obtener Clave de API | Documentación |
-|----------|---------------------|---------------|
-| EXA | [dashboard.exa.ai](https://dashboard.exa.ai) | [docs.exa.ai](https://docs.exa.ai) |
-| Apify | [console.apify.com](https://console.apify.com) | [docs.apify.com](https://docs.apify.com) |
----
-## Documentación Relacionada
-- [Reglas de Uso MCP](../../../.claude/rules/mcp-usage.md) - Reglas completas de gobernanza MCP
-- [Arquitectura de Alto Nivel](./high-level-architecture.md)
----
-**Mantenedor:** @devops (Gage)