Skip to content

migration-guide.md

Latest commit

 

History

History
310 lines (216 loc) · 6.53 KB

migration-guide.md

File metadata and controls

310 lines (216 loc) · 6.53 KB
Raw

Guia de Actualizacion de Synkra AIOX

🌐 EN | PT | ES

Esta guia te ayuda a actualizar entre versiones de Synkra AIOX.

Tabla de Contenidos

  1. Compatibilidad de Versiones
  2. Lista de Verificacion Pre-Actualizacion
  3. Procedimientos de Respaldo
  4. Proceso de Actualizacion
  5. Verificacion Post-Actualizacion
  6. Procedimientos de Rollback
  7. Solucion de Problemas

Compatibilidad de Versiones

Version Actual

Synkra AIOX 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

# Crear respaldo con fecha y hora
tar -czf aiox-backup-$(date +%Y%m%d-%H%M%S).tar.gz \
  --exclude=node_modules \
  --exclude=.git \
  .

# Mover a ubicacion segura
mv aiox-backup-*.tar.gz ../backups/

2. Exportar Configuracion

# Guardar configuracion actual
cp .aiox-core/config.json ../backups/config-backup.json

# Guardar componentes personalizados
cp -r .aiox-core/agents/custom ../backups/custom-agents/
cp -r .aiox-core/tasks/custom ../backups/custom-tasks/

3. Documentar Estado Actual

# Registrar version actual
npm list aiox-core/core > ../backups/version-info.txt

# Listar archivos personalizados
find .aiox-core -name "*.custom.*" -type f > ../backups/custom-files.txt

Proceso de Actualizacion

Opcion 1: Actualizacion In-Place (Recomendada)

# 1. Detener cualquier proceso en ejecucion
# Cerrar todas las integraciones de IDE y agentes activos

# 2. Actualizar a la ultima version
npm install -g aiox-core@latest

# 3. Ejecutar comando de actualizacion
aiox upgrade

# 4. Verificar instalacion
aiox --version

Opcion 2: Instalacion Limpia

# 1. Eliminar instalacion anterior
npm uninstall -g aiox-core

# 2. Limpiar cache
npm cache clean --force

# 3. Instalar ultima version
npm install -g aiox-core@latest

# 4. Reinicializar proyecto
cd your-project
aiox init --upgrade

Opcion 3: Actualizacion Especifica del Proyecto

# Actualizar dependencias del proyecto
cd your-project
npm update aiox-core/core

# Reinstalar dependencias
npm install

# Verificar actualizacion
npm list aiox-core/core

Verificacion Post-Actualizacion

1. Verificar Instalacion

# Verificar version
aiox --version

# Verificar componentes principales
aiox verify --components

# Probar funcionalidad basica
aiox test --quick

2. Probar Agentes

# Listar agentes disponibles
aiox list agents

# Probar activacion de agente
aiox test agent aiox-developer

# Verificar dependencias de agentes
aiox verify --agents

3. Verificar Configuracion

# Validar configuracion
aiox config validate

# Revisar log de actualizacion
cat .aiox-core/logs/upgrade.log

4. Probar Workflows

# Listar workflows
aiox list workflows

# Probar ejecucion de workflow
aiox test workflow basic-dev-cycle

Procedimientos de Rollback

Si encuentras problemas despues de actualizar:

Rollback Rapido

# Restaurar desde respaldo
cd ..
rm -rf current-project
tar -xzf backups/aiox-backup-YYYYMMDD-HHMMSS.tar.gz

# Reinstalar version anterior
npm install -g aiox-core@<previous-version>

# Verificar rollback
aiox --version

Rollback Selectivo

# Restaurar componentes especificos
cp ../backups/config-backup.json .aiox-core/config.json
cp -r ../backups/custom-agents/* .aiox-core/agents/custom/

# Reinstalar dependencias
npm install

Solucion de Problemas

Problemas Comunes

Falla la Instalacion

# Limpiar cache de npm
npm cache clean --force

# Intentar con logging detallado
npm install -g aiox-core@latest --verbose

# Verificar permisos de npm
npm config get prefix

Agentes No Cargan

# Reconstruir manifiestos de agentes
aiox rebuild --manifests

# Verificar dependencias de agentes
aiox verify --agents --verbose

# Verificar sintaxis de agentes
aiox validate agents

Errores de Configuracion

# Validar configuracion
aiox config validate --verbose

# Restablecer a valores por defecto (cuidado!)
aiox config reset --backup

# Reparar configuracion
aiox config repair

Problemas de Capa de Memoria

# Reconstruir indices de memoria
aiox memory rebuild

# Verificar integridad de memoria
aiox memory verify

# Limpiar y reinicializar
aiox memory reset

Obtener Ayuda

Si encuentras problemas no cubiertos aqui:

  1. Verificar Logs: Revisar .aiox-core/logs/upgrade.log
  2. GitHub Issues: github.com/SynkraAI/aiox-core/issues
  3. Comunidad Discord: discord.gg/gk8jAdXWmj
  4. Documentacion: directorio docs

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 aiox-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