sinapse-ai 5.0.8 → 6.0.1

package/docs/es/migration-guide.md

@@ -1,310 +0,0 @@
-<!--
-  Traduccion: ES
-  Original: /docs/en/migration-guide.md
-  Ultima sincronizacion: 2026-01-26
--->
-
-# Guia de Actualizacion de SINAPSE
-
-> 🌐 [EN](../migration-guide.md) | [PT](../pt/migration-guide.md) | **ES**
-
----
-
-Esta guia te ayuda a actualizar entre versiones de SINAPSE.
-
-## Tabla de Contenidos
-
-1. [Compatibilidad de Versiones](#compatibilidad-de-versiones)
-2. [Lista de Verificacion Pre-Actualizacion](#lista-de-verificacion-pre-actualizacion)
-3. [Procedimientos de Respaldo](#procedimientos-de-respaldo)
-4. [Proceso de Actualizacion](#proceso-de-actualizacion)
-5. [Verificacion Post-Actualizacion](#verificacion-post-actualizacion)
-6. [Procedimientos de Rollback](#procedimientos-de-rollback)
-7. [Solucion de Problemas](#solucion-de-problemas)
-
-## Compatibilidad de Versiones
-
-### Version Actual
-
-**SINAPSE v4.2.11** (Version Actual del Repositorio)
-
-### Rutas de Actualizacion
-
-| Desde Version | A Version | Tipo de Actualizacion | Dificultad |
-|---------------|-----------|----------------------|------------|
-| v4.3.x | v4.2.11 | Menor | Baja |
-| v4.0-4.2 | v4.2.11 | Menor | Media |
-| v3.x | v4.2.11 | Mayor | Alta |
-
-### Requisitos del Sistema
-
-- **Node.js**: 20.0.0 o superior (recomendado)
-- **npm**: 10.0.0 o superior
-- **Git**: 2.0.0 o superior
-- **Espacio en Disco**: 100MB minimo de espacio libre
-
-## Lista de Verificacion Pre-Actualizacion
-
-Antes de actualizar, asegurate de tener:
-
-- [ ] Respaldado tu proyecto completo
-- [ ] Documentadas las configuraciones personalizadas
-- [ ] Listados todos los agentes y workflows activos
-- [ ] Exportados cualquier dato critico
-- [ ] Probada la actualizacion en un entorno de desarrollo
-- [ ] Informado a los miembros del equipo del mantenimiento planificado
-- [ ] Revisadas las notas de version para cambios que rompen compatibilidad
-
-## Procedimientos de Respaldo
-
-### 1. Respaldo Completo del Proyecto
-
-```bash
-# Crear respaldo con fecha y hora
-tar -czf sinapse-backup-$(date +%Y%m%d-%H%M%S).tar.gz \
-  --exclude=node_modules \
-  --exclude=.git \
-  .
-
-# Mover a ubicacion segura
-mv sinapse-backup-*.tar.gz ../backups/
-```
-
-### 2. Exportar Configuracion
-
-```bash
-# Guardar configuracion actual
-cp .sinapse-ai/config.json ../backups/config-backup.json
-
-# Guardar componentes personalizados
-cp -r .sinapse-ai/agents/custom ../backups/custom-agents/
-cp -r .sinapse-ai/tasks/custom ../backups/custom-tasks/
-```
-
-### 3. Documentar Estado Actual
-
-```bash
-# Registrar version actual
-npm list sinapse-ai/core > ../backups/version-info.txt
-
-# Listar archivos personalizados
-find .sinapse-ai -name "*.custom.*" -type f > ../backups/custom-files.txt
-```
-
-## Proceso de Actualizacion
-
-### Opcion 1: Actualizacion In-Place (Recomendada)
-
-```bash
-# 1. Detener cualquier proceso en ejecucion
-# Cerrar todas las integraciones de IDE y agentes activos
-
-# 2. Actualizar a la ultima version
-npm install -g sinapse-ai@latest
-
-# 3. Ejecutar comando de actualizacion
-sinapse upgrade
-
-# 4. Verificar instalacion
-sinapse --version
-```
-
-### Opcion 2: Instalacion Limpia
-
-```bash
-# 1. Eliminar instalacion anterior
-npm uninstall -g sinapse-ai
-
-# 2. Limpiar cache
-npm cache clean --force
-
-# 3. Instalar ultima version
-npm install -g sinapse-ai@latest
-
-# 4. Reinicializar proyecto
-cd your-project
-sinapse init --upgrade
-```
-
-### Opcion 3: Actualizacion Especifica del Proyecto
-
-```bash
-# Actualizar dependencias del proyecto
-cd your-project
-npm update sinapse-ai/core
-
-# Reinstalar dependencias
-npm install
-
-# Verificar actualizacion
-npm list sinapse-ai/core
-```
-
-## Verificacion Post-Actualizacion
-
-### 1. Verificar Instalacion
-
-```bash
-# Verificar version
-sinapse --version
-
-# Verificar componentes principales
-sinapse verify --components
-
-# Probar funcionalidad basica
-sinapse test --quick
-```
-
-### 2. Probar Agentes
-
-```bash
-# Listar agentes disponibles
-sinapse list agents
-
-# Probar activacion de agente
-sinapse test agent sinapse-developer
-
-# Verificar dependencias de agentes
-sinapse verify --agents
-```
-
-### 3. Verificar Configuracion
-
-```bash
-# Validar configuracion
-sinapse config validate
-
-# Revisar log de actualizacion
-cat .sinapse-ai/logs/upgrade.log
-```
-
-### 4. Probar Workflows
-
-```bash
-# Listar workflows
-sinapse list workflows
-
-# Probar ejecucion de workflow
-sinapse test workflow basic-dev-cycle
-```
-
-## Procedimientos de Rollback
-
-Si encuentras problemas despues de actualizar:
-
-### Rollback Rapido
-
-```bash
-# Restaurar desde respaldo
-cd ..
-rm -rf current-project
-tar -xzf backups/sinapse-backup-YYYYMMDD-HHMMSS.tar.gz
-
-# Reinstalar version anterior
-npm install -g sinapse-ai@<previous-version>
-
-# Verificar rollback
-sinapse --version
-```
-
-### Rollback Selectivo
-
-```bash
-# Restaurar componentes especificos
-cp ../backups/config-backup.json .sinapse-ai/config.json
-cp -r ../backups/custom-agents/* .sinapse-ai/agents/custom/
-
-# Reinstalar dependencias
-npm install
-```
-
-## Solucion de Problemas
-
-### Problemas Comunes
-
-#### Falla la Instalacion
-
-```bash
-# Limpiar cache de npm
-npm cache clean --force
-
-# Intentar con logging detallado
-npm install -g sinapse-ai@latest --verbose
-
-# Verificar permisos de npm
-npm config get prefix
-```
-
-#### Agentes No Cargan
-
-```bash
-# Reconstruir manifiestos de agentes
-sinapse rebuild --manifests
-
-# Verificar dependencias de agentes
-sinapse verify --agents --verbose
-
-# Verificar sintaxis de agentes
-sinapse validate agents
-```
-
-#### Errores de Configuracion
-
-```bash
-# Validar configuracion
-sinapse config validate --verbose
-
-# Restablecer a valores por defecto (cuidado!)
-sinapse config reset --backup
-
-# Reparar configuracion
-sinapse config repair
-```
-
-#### Problemas de Capa de Memoria
-
-```bash
-# Reconstruir indices de memoria
-sinapse memory rebuild
-
-# Verificar integridad de memoria
-sinapse memory verify
-
-# Limpiar y reinicializar
-sinapse memory reset
-```
-
-### Obtener Ayuda
-
-Si encuentras problemas no cubiertos aqui:
-
-1. **Verificar Logs**: Revisar `.sinapse-ai/logs/upgrade.log`
-2. **GitHub Issues**: [github.com/SinapseAI/sinapse-ai/issues](https://github.com/SinapseAI/sinapse-ai/issues)
-3. **Comunidad Discord**: [discord.gg/gk8jAdXWmj](https://discord.gg/gk8jAdXWmj)
-4. **Documentacion**: [directorio docs](./getting-started.md)
-
-## Notas Especificas de Version
-
-### Actualizando a v4.2
-
-**Cambios Clave:**
-- Capacidades mejoradas del meta-agente
-- Rendimiento mejorado de la capa de memoria
-- Funciones de seguridad actualizadas
-- Proceso de instalacion simplificado
-
-**Cambios que Rompen Compatibilidad:**
-- Ninguno (compatible hacia atras con v4.0+)
-
-**Nuevas Funcionalidades:**
-- Mejoras del meta-agente `sinapse-developer`
-- Asistente de instalacion interactivo
-- Herramientas de monitoreo de rendimiento
-
-**Deprecaciones:**
-- Sintaxis de comandos legacy (aun soportada con advertencias)
-
----
-
-**Ultima Actualizacion:** 2025-08-01
-**Version Actual:** v4.2.11

package/docs/es/npx-install.md

@@ -1,193 +0,0 @@
-<!--
-  Traducción: ES
-  Original: /docs/en/npx-install.md
-  Última sincronización: 2026-01-26
--->
-
-# Guía de Instalación con NPX
-
-> 🌐 [EN](../npx-install.md) | [PT](../pt/npx-install.md) | **ES**
-
----
-
-## Descripción General
-
-SINAPSE puede instalarse via NPX para una configuración rápida sin instalación global. Esta guía cubre el uso correcto y la resolución de problemas para instalaciones basadas en NPX.
-
-## Inicio Rápido
-
-### Uso Correcto
-
-Siempre ejecute `npx sinapse-ai install` **desde el directorio de su proyecto**:
-
-```bash
-# Navegue primero a su proyecto
-cd /path/to/your/project
-
-# Luego ejecute el instalador
-npx sinapse-ai install
-```
-
-### ⚠️ Error Común
-
-**NO** ejecute el instalador desde su directorio home o ubicaciones arbitrarias:
-
-```bash
-# ❌ INCORRECTO - Fallará con error de directorio temporal NPX
-cd ~
-npx sinapse-ai install
-
-# ✅ CORRECTO - Navegue al proyecto primero
-cd ~/my-project
-npx sinapse-ai install
-```
-
-## Por Qué Esto Importa
-
-NPX ejecuta paquetes en **directorios temporales** (por ejemplo, `/private/var/folders/.../npx-xxx/` en macOS). Cuando SINAPSE se ejecuta desde estas ubicaciones temporales, no puede:
-
-- Detectar correctamente la configuración de su IDE
-- Instalar archivos en el directorio correcto del proyecto
-- Configurar correctamente las integraciones del IDE
-
-## Detección de Directorio Temporal NPX
-
-A partir de la versión 4.31.1, SINAPSE detecta automáticamente cuando está ejecutándose desde un directorio temporal NPX y muestra un mensaje de error útil:
-
-```
-⚠️  NPX Temporary Directory Detected
-
-NPX executes in a temporary directory, which prevents
-SINAPSE from detecting your IDE correctly.
-
-Solution:
-  cd /path/to/your/project
-  npx sinapse-ai install
-
-See: https://sinapse-ai.dev/docs/npx-install
-```
-
-## Pasos de Instalación
-
-### Paso 1: Navegue al Proyecto
-
-```bash
-cd /path/to/your/project
-```
-
-Su directorio de proyecto debería contener:
-- Archivos de gestión de paquetes (`package.json`, etc.)
-- Directorios de código fuente
-
-### Paso 2: Ejecute el Instalador
-
-```bash
-npx sinapse-ai install
-```
-
-### Paso 3: Siga los Prompts Interactivos
-
-El instalador le pedirá:
-1. Confirmar el directorio de instalación (debería ser el directorio actual)
-2. Seleccionar componentes a instalar (Core + Squads)
-3. Configurar integraciones del IDE
-4. Configurar la organización de documentación
-
-## Notas Específicas por Plataforma
-
-### macOS
-
-Los directorios temporales de NPX típicamente aparecen en:
-- `/private/var/folders/[hash]/T/npx-[random]/`
-- `/Users/[user]/.npm/_npx/[hash]/`
-
-SINAPSE detecta estos patrones y previene instalaciones incorrectas.
-
-### Linux
-
-Patrones de directorios temporales similares:
-- `/tmp/npx-[random]/`
-- `~/.npm/_npx/[hash]/`
-
-### Windows
-
-Los usuarios de Windows típicamente no encuentran este problema, pero patrones de detección similares aplican:
-- `%TEMP%\npx-[random]\`
-- `%APPDATA%\npm-cache\_npx\`
-
-## Resolución de Problemas
-
-### Error: "NPX Temporary Directory Detected"
-
-**Causa**: Está ejecutando el instalador desde su directorio home u otra ubicación que no es del proyecto.
-
-**Solución**:
-1. Navegue al directorio real de su proyecto:
-   ```bash
-   cd /path/to/your/actual/project
-   ```
-2. Vuelva a ejecutar el instalador:
-   ```bash
-   npx sinapse-ai install
-   ```
-
-### Directorio de Instalación Incorrecto
-
-Si el instalador pide una ruta de directorio:
-- ✅ Use `.` (directorio actual) si ya está en su proyecto
-- ✅ Proporcione la ruta absoluta a su proyecto: `/Users/you/projects/my-app`
-- ❌ No use `~` o rutas relativas que apunten fuera de su proyecto
-
-### IDE No Detectado
-
-Si su IDE no es detectado después de la instalación:
-1. Verifique que ejecutó el instalador desde el directorio correcto del proyecto
-3. Vuelva a ejecutar el instalador y seleccione manualmente su IDE
-
-## Alternativa: Instalación Global
-
-Si prefiere no usar NPX, puede instalar globalmente:
-
-```bash
-npm install -g sinapse-ai
-cd /path/to/your/project
-sinapse-ai install
-```
-
-## Detalles Técnicos
-
-### Arquitectura de Defensa en Profundidad
-
-SINAPSE v4.31.1+ implementa detección de dos capas:
-
-1. **Capa PRIMARIA** (`tools/sinapse-npx-wrapper.js`):
-   - Verifica `__dirname` (donde NPX extrae el paquete)
-   - Usa patrones regex para rutas temporales de macOS
-   - Salida temprana antes de delegación al CLI
-
-2. **Capa SECUNDARIA** (`tools/installer/bin/sinapse.js`):
-   - Verificación de respaldo usando `process.cwd()`
-   - Valida al inicio del comando install
-   - Proporciona redundancia si el wrapper es bypasseado
-
-### Patrones de Detección
-
-```javascript
-const patterns = [
-  /\/private\/var\/folders\/.*\/npx-/,  // macOS temp
-  /\/\.npm\/_npx\//                      // NPX cache
-];
-```
-
-## Soporte
-
-Para ayuda adicional:
-- GitHub Issues: https://github.com/SinapseAIinc/sinapse-ai/issues
-- Documentación: https://sinapse-ai.dev/docs
-- Referencia de Story: 2.3 - NPX Installation Context Detection
-
----
-
-**Versión**: 4.31.1+
-**Última Actualización**: 2025-10-22
-**Aplica A**: macOS (principal), Linux/Windows (detección disponible)