sinapse-ai 5.0.8 → 6.0.1

package/docs/es/guides/ide-sync-guide.md

@@ -1,194 +0,0 @@
-<!--
-  Traduccion: ES
-  Original: /docs/guides/ide-sync-guide.md
-  Ultima sincronizacion: 2026-01-29
--->
-
-# Guia de Sincronizacion de IDE
-
-Sincroniza agentes, tasks, workflows y checklists de SINAPSE a traves de multiples configuraciones de IDE.
-
-## Vision General
-
-La task `*command` automatiza la sincronizacion de componentes SINAPSE a todos los directorios de IDE configurados (`.claude/`, `.cursor/`, `.gemini/`, etc.), eliminando operaciones de copia manuales.
-
-## Inicio Rapido
-
-### 1. Configuracion Inicial
-
-Copiar la plantilla a la raiz de tu proyecto:
-
-```bash
-cp .sinapse-ai/infrastructure/templates/sinapse-sync.yaml.template .sinapse-sync.yaml
-```
-
-### 2. Configurar IDEs
-
-Editar `.sinapse-sync.yaml` para habilitar tus IDEs:
-
-```yaml
-active_ides:
-  - claude # Claude Code (.claude/commands/)
-  - cursor # Cursor IDE (.cursor/rules/)
-  # - gemini    # Google Gemini (.gemini/)
-```
-
-### 3. Agregar Alias de Squads
-
-Mapear tus directorios de squads a prefijos de comandos:
-
-```yaml
-squad_aliases:
-  legal: Legal # squads/legal/ → .claude/commands/Legal/
-  copy: Copy # squads/copy/ → .claude/commands/Copy/
-  hr: HR # squads/hr/ → .claude/commands/HR/
-```
-
-## Uso
-
-### Sincronizar Componentes Individuales
-
-```bash
-# Sincronizar un agente especifico
-*command agent legal-chief
-
-# Sincronizar una task especifica
-*command task revisar-contrato
-
-# Sincronizar un workflow especifico
-*command workflow contract-review
-```
-
-### Sincronizar Squad Completo
-
-```bash
-# Sincronizar todos los componentes de un squad
-*command squad legal
-```
-
-### Sincronizar Todos los Squads
-
-```bash
-# Sincronizar todo
-*command sync-all
-```
-
-## Como Funciona
-
-```
-squads/legal/agents/legal-chief.md
-         │
-         ▼
-┌─────────────────────────────────────────────────────┐
-│                 *command sync                        │
-│                                                      │
-│  1. Leer configuracion .sinapse-sync.yaml               │
-│  2. Verificar si el componente existe en squads/     │
-│  3. Aplicar transformaciones de wrapper (si es necesario) │
-│  4. Copiar a cada destino de IDE activo              │
-│  5. Validar archivos sincronizados                   │
-│  6. Registrar operaciones                            │
-└─────────────────────────────────────────────────────┘
-         │
-         ▼
-┌──────────────────────────────────────────────────────┐
-│  .claude/commands/Legal/agents/legal-chief.md        │
-│  .cursor/rules/legal-chief.mdc                       │
-│  .gemini/agents/legal-chief.md                       │
-└──────────────────────────────────────────────────────┘
-```
-
-## Mapeos de Sincronizacion
-
-Mapeos por defecto para tipos de componentes:
-
-| ------------------ | ------ | ------ | ------ | -------- |
-| Agents             | ✅     | ✅     | ✅     | ✅       |
-| Tasks              | ✅     | -      | -      | -        |
-| Workflows          | ✅     | ✅     | -      | -        |
-| Checklists         | ✅     | -      | -      | -        |
-| Data               | ✅     | -      | -      | -        |
-
-## Wrappers
-
-Diferentes IDEs requieren diferentes formatos:
-
-### Claude (Markdown)
-
-No se necesita transformacion - los archivos se copian tal cual.
-
-### Cursor (MDC)
-
-Los archivos se envuelven con frontmatter:
-
-```yaml
----
-description: { extraido del agente }
-globs: []
-alwaysApply: false
----
-{ contenido original }
-```
-
-## Estructura de Directorios
-
-```
-tu-proyecto/
-├── .sinapse-sync.yaml           # Configuracion de sincronizacion
-├── squads/                   # Fuente de verdad
-│   └── legal/
-│       ├── config.yaml
-│       ├── agents/
-│       ├── tasks/
-│       └── checklists/
-├── .claude/
-│   └── commands/
-│       └── Legal/           # Auto-sincronizado
-│           ├── agents/
-│           ├── tasks/
-│           └── checklists/
-├── .cursor/
-│   └── rules/               # Auto-sincronizado (formato MDC)
-└── .gemini/
-    └── agents/              # Auto-sincronizado
-```
-
-## Mejores Practicas
-
-1. **Nunca editar `.claude/commands/` directamente** - Siempre editar en `squads/` y sincronizar
-2. **Usar nombres descriptivos** - Los nombres de agentes se convierten en slash commands
-3. **Mantener config.yaml actualizado** - Requerido para sincronizacion correcta
-4. **Ejecutar sync despues de cambios** - Asegurar que todos los IDEs esten sincronizados
-
-## Solucion de Problemas
-
-### Componente No Encontrado
-
-```
-Error: Component 'my-agent' not found in squads/
-```
-
-**Solucion**: Verificar que el agente existe en `squads/*/agents/my-agent.md`
-
-### Falta Alias de Squad
-
-```
-Warning: No squad alias for 'new-squad'
-```
-
-**Solucion**: Agregar el alias a `.sinapse-sync.yaml`:
-
-```yaml
-squad_aliases:
-  new-squad: NewSquad
-```
-
-### IDE No Sincroniza
-
-Verificar que el IDE esta habilitado en la seccion `active_ides`.
-
-## Relacionado
-
-- [Vision General de Squads](./squads-overview.md)
-- [Referencia de Agentes](../agent-reference-guide.md)
-- [Arquitectura SINAPSE](../core-architecture.md)

package/docs/es/guides/installation-troubleshooting.md

@@ -1,327 +0,0 @@
-<!--
-  Traducción: ES
-  Original: /docs/en/guides/installation-troubleshooting.md
-  Última sincronización: 2026-01-26
--->
-
-# Guía de Instalación y Solución de Problemas de SINAPSE
-
-> 🌐 [EN](../../guides/installation-troubleshooting.md) | [PT](../../pt/guides/installation-troubleshooting.md) | **ES**
-
----
-
-## Inicio Rápido
-
-```bash
-npx sinapse-ai@latest
-```
-
-Este comando descarga y ejecuta la última versión del instalador de SINAPSE.
-
-## Requisitos del Sistema
-
-| Requisito | Versión Mínima | Comando de Verificación |
-|-----------|----------------|-------------------------|
-| **Node.js** | v18.0.0+ | `node --version` |
-| **npm** | v9.0.0+ | `npm --version` |
-| **npx** | (incluido con npm 5.2+) | `npx --version` |
-| **Git** | Cualquier versión reciente (opcional) | `git --version` |
-
-### Enlaces de Descarga
-
-- **Node.js**: https://nodejs.org/ (Descargar versión LTS - incluye npm y npx)
-- **Git**: https://git-scm.com/ (Opcional, pero recomendado)
-
----
-
-## Métodos de Instalación
-
-### Método 1: npx (Recomendado)
-
-```bash
-# Install in current directory
-npx sinapse-ai@latest
-
-# Install with specific version
-npx sinapse-ai@2.2.0
-
-# Show version
-npx sinapse-ai@latest --version
-
-# Show help
-npx sinapse-ai@latest --help
-```
-
-### Método 2: Desde GitHub
-
-```bash
-npx github:SinapseAI/sinapse-ai install
-```
-
-### Método 3: Instalación Global
-
-```bash
-npm install -g sinapse-ai
-sinapse-ai
-```
-
----
-
-## Herramienta de Diagnóstico
-
-Si tienes problemas de instalación, ejecuta nuestra herramienta de diagnóstico:
-
-### Windows (CMD)
-```cmd
-curl -o diagnose.cmd https://raw.githubusercontent.com/SinapseAI/sinapse-ai/main/tools/quick-diagnose.cmd && diagnose.cmd
-```
-
-### Windows (PowerShell)
-```powershell
-irm https://raw.githubusercontent.com/SinapseAI/sinapse-ai/main/tools/quick-diagnose.ps1 | iex
-```
-
-### macOS/Linux
-```bash
-curl -fsSL https://raw.githubusercontent.com/SinapseAI/sinapse-ai/main/tools/diagnose-installation.js | node
-```
-
----
-
-## Problemas Comunes y Soluciones
-
-### Problema 1: "Node.js version too old"
-
-**Error:**
-```
-error engine Unsupported engine
-error notsup Required: {"node":">=18.0.0"}
-```
-
-**Solución:**
-1. Descargar Node.js LTS desde https://nodejs.org/
-2. Instalar y reiniciar tu terminal
-3. Verificar: `node --version` (debería mostrar v18+ o v20+)
-
----
-
-### Problema 2: "npm version too old"
-
-**Error:**
-```
-npm ERR! Required: {"npm":">=9.0.0"}
-```
-
-**Solución:**
-```bash
-# Update npm globally
-npm install -g npm@latest
-
-# Verify
-npm --version
-```
-
----
-
-### Problema 3: "npx not found" o "npx command not recognized"
-
-**Causa:** La carpeta bin de npm no está en el PATH del sistema
-
-**Solución (Windows):**
-1. Encontrar el prefix de npm: `npm config get prefix`
-2. Agregar al PATH:
-   - Presionar Win+X -> Sistema -> Configuración avanzada del sistema -> Variables de entorno
-   - Editar "Path" en Variables de usuario
-   - Agregar: `C:\Users\TU_USUARIO\AppData\Roaming\npm`
-3. Reiniciar terminal
-
-**Solución (macOS/Linux):**
-```bash
-# Add to ~/.bashrc or ~/.zshrc
-export PATH="$PATH:$(npm config get prefix)/bin"
-
-# Reload
-source ~/.bashrc
-```
-
----
-
-### Problema 4: "EACCES: permission denied"
-
-**Solución (Windows):**
-Ejecutar terminal como Administrador
-
-**Solución (macOS/Linux):**
-```bash
-# Fix npm permissions (recommended)
-mkdir -p ~/.npm-global
-npm config set prefix '~/.npm-global'
-export PATH=~/.npm-global/bin:$PATH
-
-# Or use nvm (best practice)
-curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
-```
-
----
-
-### Problema 5: "ETIMEDOUT" o "ECONNREFUSED"
-
-**Causa:** Red/firewall bloqueando el registro de npm
-
-**Soluciones:**
-
-1. **Verificar registro de npm:**
-   ```bash
-   npm config get registry
-   # Should be: https://registry.npmjs.org/
-   ```
-
-2. **Restablecer registro:**
-   ```bash
-   npm config set registry https://registry.npmjs.org/
-   ```
-
-3. **Probar conectividad:**
-   ```bash
-   npm ping
-   ```
-
-4. **Detrás de proxy corporativo:**
-   ```bash
-   npm config set proxy http://proxy.company.com:8080
-   npm config set https-proxy http://proxy.company.com:8080
-   ```
-
-5. **Usar mirror (China):**
-   ```bash
-   npm config set registry https://registry.npmmirror.com
-   ```
-
----
-
-### Problema 6: "PowerShell execution policy" (Windows)
-
-**Error:**
-```
-File cannot be loaded because running scripts is disabled on this system
-```
-
-**Solución:**
-```powershell
-# Run as Administrator
-Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
-```
-
----
-
-### Problema 7: "Cannot find module" o "Missing dependencies"
-
-**Solución:**
-```bash
-# Clear npm cache
-npm cache clean --force
-
-# Remove node_modules if exists
-rm -rf node_modules
-
-# Try again
-npx sinapse-ai@latest
-```
-
----
-
-### Problema 8: "SSL/Certificate errors"
-
-**Solución:**
-```bash
-# Temporarily disable strict SSL (not recommended for production)
-npm config set strict-ssl false
-
-# Better: Update certificates
-npm config set cafile /path/to/certificate.pem
-```
-
----
-
-### Problema 9: El paquete muestra versión antigua
-
-**Causa:** Caché de npm sirviendo versión antigua
-
-**Solución:**
-```bash
-# Clear npx cache
-npx clear-npx-cache
-
-# Or force fresh download
-npx --ignore-existing sinapse-ai@latest
-
-# Or use specific version
-npx sinapse-ai@2.2.0
-```
-
----
-
-## Lista de Verificación del Entorno
-
-Ejecuta estos comandos para verificar tu entorno:
-
-```bash
-# 1. Check Node.js (need v18+)
-node --version
-
-# 2. Check npm (need v9+)
-npm --version
-
-# 3. Check npx
-npx --version
-
-# 4. Check npm registry access
-npm view sinapse-ai version
-
-# 5. Test installation
-npx sinapse-ai@latest --version
-```
-
-**Salida esperada:**
-```
-v22.x.x (or v18+/v20+)
-11.x.x (or v9+)
-11.x.x (same as npm)
-2.2.0
-2.2.0
-```
-
----
-
-## Obtener Ayuda
-
-Si sigues teniendo problemas:
-
-1. **GitHub Issues**: https://github.com/SinapseAI/sinapse-ai/issues
-2. **Ejecutar diagnósticos**: `npx sinapse-ai@latest doctor`
-3. **Verificar información del sistema**: `npx sinapse-ai@latest info`
-
-Al reportar problemas, por favor incluye:
-- Sistema operativo y versión
-- Versión de Node.js (`node --version`)
-- Versión de npm (`npm --version`)
-- Mensaje de error completo
-- Salida de la herramienta de diagnóstico
-
----
-
-## Referencia Rápida
-
-| Comando | Descripción |
-|---------|-------------|
-| `npx sinapse-ai@latest` | Instalar/ejecutar asistente |
-| `npx sinapse-ai@latest --version` | Mostrar versión |
-| `npx sinapse-ai@latest --help` | Mostrar ayuda |
-| `npx sinapse-ai@latest install` | Instalar en directorio actual |
-| `npx sinapse-ai@latest init <name>` | Crear nuevo proyecto |
-| `npx sinapse-ai@latest doctor` | Ejecutar diagnósticos |
-| `npx sinapse-ai@latest info` | Mostrar información del sistema |
-
----
-
-*Última actualización: Diciembre 2025 | SINAPSE v2.2.0*