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/multi-repo-strategy.md DELETED Viewed

@@ -1,390 +0,0 @@
-# Estrategia Multi-Repositorio
-> **ES** | [EN](../../architecture/multi-repo-strategy.md) | [PT](../../pt/architecture/multi-repo-strategy.md)
----
-**Versión:** 2.1.0
-**Última actualización:** 2026-01-28
-**Estado:** Documento de Arquitectura Oficial
----
-## Tabla de Contenidos
-- [Descripción General](#descripción-general)
-- [Estructura de Repositorios](#estructura-de-repositorios)
-- [Repositorio Central (sinapse-ai)](#repositorio-central-sinapse-ai)
-- [Repositorios Squad](#repositorios-squad)
-- [Repositorio del Ecosistema MCP](#repositorio-del-ecosistema-mcp)
-- [Repositorios Privados](#repositorios-privados)
-- [Mecanismo de Sincronización](#mecanismo-de-sincronización)
-- [Distribución de Paquetes](#distribución-de-paquetes)
-- [Mejores Prácticas](#mejores-prácticas)
----
-## Descripción General
-SINAPSE v4 adopta una **estrategia multi-repositorio** para permitir el desarrollo modular, las contribuciones de la comunidad y una clara separación entre el marco fundamental, las extensiones (squads) y los componentes propietarios.
-### Objetivos de Diseño
-| Objetivo                      | Descripción                                           |
-| ----------------------------- | ----------------------------------------------------- |
-| **Modularidad**               | Los squads pueden desarrollarse y versionarse independientemente   |
-| **Comunidad**                 | Los squads de código abierto fomentan las contribuciones comunitarias  |
-| **Protección de IP**          | Los componentes propietarios permanecen en repositorios privados |
-| **Escalabilidad**             | Los equipos pueden trabajar en repositorios separados sin conflictos    |
-| **Flexibilidad de Licencias** | Los diferentes componentes pueden tener diferentes licencias      |
----
-## Estructura de Repositorios
-```
-Organización SinapseAI
-├── REPOSITORIOS PÚBLICOS
-│   ├── sinapse-ai          # Marco fundamental (MIT)
-│   ├── sinapse-squads        # Squads comunitarios (MIT)
-│   └── mcp-ecosystem      # Configuraciones MCP (Apache 2.0)
-│
-└── REPOSITORIOS PRIVADOS
-    ├── mmos               # MMOS propietario (NDA)
-    └── certified-partners # Recursos de socios (Propietario)
-```
-### Arquitectura Visual
-```
-┌─────────────────────────────────────────────────────────────────────────┐
-│                    ORGANIZACIÓN SINAPSE                                   │
-│                                                                          │
-│   REPOSITORIOS PÚBLICOS                                                  │
-│   ═══════════════════════                                                │
-│                                                                          │
-│   ┌────────────────────┐     ┌────────────────────┐                     │
-│   │  SinapseAI/         │     │  SinapseAI/         │                     │
-│   │  sinapse-ai         │     │  sinapse-squads       │                     │
-│   │  (MIT)  │◄────│  (MIT)             │                     │
-│   │                    │     │                    │                     │
-│   │  - Marco           │     │  - Squad ETL       │                     │
-│   │    Fundamental     │     │  - Squad Creator   │                     │
-│   │  - 11 Agentes Base │     │  - Squad MMOS      │                     │
-│   │  - Puertas de      │     │  - Squads          │                     │
-│   │    Calidad         │     │    Comunitarios    │                     │
-│   │  - Hub de          │     │                    │                     │
-│   │    Discusiones     │     │                    │                     │
-│   └────────────────────┘     └────────────────────┘                     │
-│            │                                                             │
-│            │ dependencia opcional                                        │
-│            ▼                                                             │
-│   ┌────────────────────┐                                                │
-│   │  SinapseAI/         │                                                │
-│   │  mcp-ecosystem     │                                                │
-│   │  (Apache 2.0)      │                                                │
-│   │                    │                                                │
-│   │  - Docker MCP      │                                                │
-│   │  - Configuraciones │                                                │
-│   │    de IDE          │                                                │
-│   │  - Presets MCP     │                                                │
-│   └────────────────────┘                                                │
-│                                                                          │
-│   REPOSITORIOS PRIVADOS                                                  │
-│   ════════════════════════                                               │
-│                                                                          │
-│   ┌────────────────────┐     ┌────────────────────┐                     │
-│   │  SinapseAI/mmos     │     │  SinapseAI/         │                     │
-│   │  (Propietario+NDA) │     │  certified-partners│                     │
-│   │                    │     │  (Propietario)     │                     │
-│   │  - Mentes MMOS     │     │  - Squads Premium  │                     │
-│   │  - ADN Mental      │     │  - Portal de Socios│                     │
-│   └────────────────────┘     └────────────────────┘                     │
-│                                                                          │
-└─────────────────────────────────────────────────────────────────────────┘
-```
----
-## Repositorio Central (sinapse-ai)
-### Propósito
-El repositorio central contiene el marco SINAPSE fundamental del que todos los proyectos dependen.
-### Contenidos
-| Directorio                   | Descripción                                             |
-| ---------------------------- | ------------------------------------------------------- |
-| `.sinapse-ai/core/`           | Fundamentos del marco (config, registry, puertas de calidad) |
-| `.sinapse-ai/development/`    | Definiciones de agentes, tareas, flujos de trabajo                     |
-| `.sinapse-ai/product/`        | Plantillas, listas de verificación, datos de PM                          |
-| `.sinapse-ai/infrastructure/` | Scripts, herramientas, integraciones                            |
-| `docs/`                      | Documentación del marco                                 |
-### Licencia
-**MIT** - Licencia permisiva para uso, modificacion y distribucion del core.
-### Paquete npm
-```bash
-npm install @sinapse/core
-```
----
-## Repositorios Squad
-### Descripción General
-Los squads son extensiones modulares que agregan capacidades especializadas a SINAPSE.
-### Repositorio sinapse-squads
-```
-sinapse-squads/
-├── etl/                    # Squad de procesamiento ETL
-│   ├── squad.yaml          # Manifiesto del squad
-│   ├── agents/             # Agentes específicos del squad
-│   ├── tasks/              # Tareas del squad
-│   └── README.md           # Documentación del squad
-│
-├── creator/                # Squad de creación de contenido
-│   ├── squad.yaml
-│   ├── agents/
-│   └── tasks/
-│
-├── mmos/                   # Squad de integración MMOS
-│   ├── squad.yaml
-│   ├── agents/
-│   └── tasks/
-│
-└── templates/              # Plantillas de creación de squad
-    └── squad-template/
-```
-### Manifiesto del Squad (squad.yaml)
-```yaml
-name: etl
-version: 1.0.0
-description: Squad de procesamiento ETL para tuberías de datos
-license: MIT
-peerDependencies:
-  '@sinapse/core': '^2.1.0'
-agents:
-  - id: data-engineer
-    extends: dev
-tasks:
-  - extract-data
-  - transform-data
-  - load-data
-exports:
-  - agents
-  - tasks
-```
-### Licencia
-**MIT** - Libertad de código abierto completa para contribuciones comunitarias.
-### Paquetes npm
-```bash
-npm install @sinapse/squad-etl
-npm install @sinapse/squad-creator
-npm install @sinapse/squad-mmos
-```
----
-## Repositorio del Ecosistema MCP
-### Propósito
-Configuraciones MCP (Model Context Protocol) centralizadas para varios IDEs y entornos.
-### Contenidos
-```
-mcp-ecosystem/
-├── docker/                 # Configuraciones Docker MCP
-│   ├── docker-compose.yml
-│   └── mcp-servers/
-│
-├── ide-configs/            # Configuraciones específicas del IDE
-│   ├── claude-code/
-│   ├── cursor/
-│   └── vscode/
-│
-└── presets/                # Paquetes MCP preconfigurados
-    ├── minimal/
-    ├── development/
-    └── enterprise/
-```
-### Licencia
-**Apache 2.0** - Licencia permisiva para máxima adopción.
-### Paquete npm
-```bash
-npm install @sinapse/mcp-presets
-```
----
-## Repositorios Privados
-### SinapseAI/mmos (Propietario + NDA)
-Contiene componentes MMOS (Mental Model Operating System) propietarios:
-- Definiciones de Mentes MMOS
-- Algoritmos de ADN Mental
-- Datos de entrenamiento propietarios
-- Personalizaciones específicas de socios
-**Acceso:** Requiere acuerdo NDA y de licencia.
-### SinapseAI/certified-partners (Propietario)
-Recursos para socios certificados de SINAPSE:
-- Implementaciones de squads premium
-- Acceso al portal de socios
-- Herramientas de soporte empresarial
-- Configuraciones de marca blanca
-**Acceso:** Requiere estado de socio certificado.
----
-## Mecanismo de Sincronización
-### Dependencias Entre Repositorios
-```
-┌──────────────┐     depende de      ┌──────────────┐
-│  sinapse-squads │ ──────────────────► │  sinapse-ai   │
-└──────────────┘                     └──────────────┘
-       │                                    │
-       │                                    │
-       │ opcional                           │ opcional
-       │                                    │
-       ▼                                    ▼
-┌──────────────┐                    ┌──────────────┐
-│mcp-ecosystem │                    │     mmos     │
-└──────────────┘                    └──────────────┘
-```
-### Compatibilidad de Versiones
-| sinapse-ai | sinapse-squads | mcp-ecosystem |
-| --------- | ----------- | ------------- |
-| ^2.1.0    | ^1.0.0      | ^1.0.0        |
-| ^3.0.0    | ^2.0.0      | ^1.x.x        |
-### Git Submodules (Opcional)
-Para proyectos que necesitan múltiples repositorios:
-```bash
-# Agregar squads como submodule
-git submodule add https://github.com/SinapseAI/sinapse-squads.git squads
-# Agregar ecosistema MCP como submodule
-git submodule add https://github.com/SinapseAI/mcp-ecosystem.git mcp
-```
-### Dependencias npm (Recomendado)
-```json
-{
-  "dependencies": {
-    "@sinapse/core": "^2.1.0",
-    "@sinapse/squad-etl": "^1.0.0",
-    "@sinapse/mcp-presets": "^1.0.0"
-  }
-}
-```
----
-## Distribución de Paquetes
-### Alcance de Paquetes npm
-| Paquete               | Registro   | Licencia       | Repositorio    |
-| --------------------- | ---------- | -------------- | ------------- |
-| `@sinapse/core`          | npm public | MIT            | sinapse-ai     |
-| `@sinapse/squad-etl`     | npm public | MIT            | sinapse-squads   |
-| `@sinapse/squad-creator` | npm public | MIT            | sinapse-squads   |
-| `@sinapse/squad-mmos`    | npm public | MIT            | sinapse-squads   |
-| `@sinapse/mcp-presets`   | npm public | Apache 2.0     | mcp-ecosystem |
-### Flujo de Publicación
-```bash
-# Desde sinapse-ai
-npm publish --access public
-# Desde sinapse-squads/etl
-cd etl && npm publish --access public
-# Desde mcp-ecosystem
-npm publish --access public
-```
----
-## Mejores Prácticas
-### Para Colaboradores del Núcleo
-1. **Cambios Atómicos** - Mantén los PRs enfocados en características o correcciones únicas
-2. **Compatibilidad Hacia Atrás** - Evita cambios disruptivos en versiones menores
-3. **Documentación** - Actualiza la documentación en el mismo PR que los cambios de código
-4. **Pruebas Entre Repositorios** - Prueba los cambios contra repositorios dependientes
-### Para Desarrolladores de Squads
-1. **Manifiesto Primero** - Define squad.yaml antes de implementar
-2. **Dependencias Entre Iguales** - Especifica los requisitos exactos de versión de sinapse-ai
-3. **Pruebas Independientes** - Los squads deben tener sus propios conjuntos de pruebas
-4. **Estándares README** - Incluye ejemplos de uso y requisitos
-### Para Consumidores de Proyectos
-1. **Bloquea Versiones** - Utiliza versiones exactas en producción
-2. **Prueba Actualizaciones** - Ejecuta el conjunto de pruebas completo después de actualizar dependencias
-3. **Monitorea Lanzamientos** - Suscribete a notificaciones de lanzamiento
-4. **Reporta Problemas** - Reporta problemas en el repositorio correcto
-### Mantenimiento del Repositorio
-| Tarea              | Frecuencia   | Responsabilidad |
-| ------------------ | ----------- | -------------- |
-| Actualización de dependencias | Semanal      | DevOps         |
-| Auditorías de seguridad    | Mensual     | DevOps         |
-| Lanzamientos de versión   | Según sea necesario   | Mantenedores    |
-| Sincronización de documentación | Por lanzamiento | Colaboradores   |
----
-## Documentos Relacionados
-- [Arquitectura de Alto Nivel](./high-level-architecture.md)
-- [Sistema de Módulos](./module-system.md)
-- [Guía de Migración v2.0 a v4.0.4](../migration/migration-guide.md)
-- [Guía de Squads](../guides/squads-guide.md)
----
-_Última actualización: 2026-01-28 | Equipo del Marco SINAPSE_