# INCIDENT_RESPONSE.md — Protocolo de Respuesta a Incidentes (4GatosCoin)

Este documento define el protocolo oficial para responder a incidentes críticos dentro del organismo 4GatosCoin.  
Su objetivo es minimizar impacto, restaurar estabilidad, proteger el estado global y mantener coherencia narrativa.

---

# 1. Objetivos del Protocolo

- detectar incidentes rápidamente  
- aislar órganos afectados  
- evitar propagación  
- restaurar estado global  
- registrar el incidente  
- comunicar al equipo  
- prevenir recurrencia  

---

# 2. Tipos de Incidentes

| Tipo | Ejemplo |
|------|---------|
| Energía | picos imposibles, energía negativa |
| Gestos | loops, ráfagas, duplicación |
| Territorio | dominancia corrupta, zonas desincronizadas |
| Ciclos | umbrales rotos, ciclos saltados |
| Temporadas | reglas incoherentes, transiciones fallidas |
| Rituales | activación incorrecta, impacto descontrolado |
| Narrativa | ecos incoherentes, loops narrativos |
| Semillas | rarezas imposibles, duplicación |
| Latido | ritmo fuera de rango |
| API | endpoints caídos |
| Base de datos | desconexiones, corrupción |
| OTT | desincronización visual |

---

# 3. Flujo de Respuesta a Incidentes

```
Detección → Clasificación → Aislamiento → Restauración → Validación → Comunicación → Prevención
```

---

# 4. Detección del Incidente

El incidente puede detectarse por:

- sistema failsafe  
- logs  
- panel DevWeb3  
- OTT  
- anomalías narrativas  
- alertas técnicas  
- comportamiento inesperado  

Registrar inmediatamente:

- hora  
- órgano afectado  
- síntoma  
- impacto visible  

---

# 5. Clasificación del Incidente

Clasificar según severidad:

### 5.1. Nivel 1 — Menor
- impacto limitado  
- no afecta estado global  
- no afecta narrativa  

### 5.2. Nivel 2 — Moderado
- afecta un órgano  
- requiere aislamiento  
- requiere restauración parcial  

### 5.3. Nivel 3 — Crítico
- afecta múltiples órganos  
- afecta estado global  
- requiere restauración completa  

### 5.4. Nivel 4 — Catastrófico
- corrupción de datos  
- caída total del organismo  
- requiere rollback completo  

---

# 6. Aislamiento del Incidente

Usar:

```
lib/failsafe/isolate.ts
```

Aislar:

- energía  
- territorio  
- narrativa  
- avatar  
- rituales  
- temporadas  

El organismo entra en **modo seguro**.

---

# 7. Restauración

Dependiendo del incidente:

## 7.1. Restauración de Estado Global
Usar snapshot más reciente:

```
snapshots/globalState/
```

## 7.2. Restauración de Base de Datos
Usar backup:

```
backups/daily/
backups/hourly/
backups/emergency/
```

## 7.3. Restauración de Territorio
Restaurar dominancia y zonas.

## 7.4. Restauración de Narrativa
Restaurar ecos, silencios y anomalías.

## 7.5. Restauración de Rituales
Desactivar rituales activos y restaurar estado previo.

---

# 8. Validación

Después de restaurar:

- validar energía  
- validar territorio  
- validar narrativa  
- validar ciclos  
- validar temporada  
- validar latido  
- validar OTT  
- validar panel DevWeb3  

---

# 9. Comunicación del Incidente

El equipo core debe recibir:

- descripción del incidente  
- órgano afectado  
- impacto  
- acciones tomadas  
- estado actual  
- pasos siguientes  

Formato recomendado:

```
INCIDENTE #XYZ
Fecha:
Órgano afectado:
Descripción:
Impacto:
Acciones tomadas:
Estado actual:
Riesgos:
Próximos pasos:
```

---

# 10. Prevención

Después de resolver el incidente:

- actualizar tests  
- actualizar failsafe  
- actualizar documentación  
- actualizar reglas  
- actualizar narrativa  
- revisar migraciones  
- revisar despliegues  

---

# 11. Roles Durante un Incidente

| Rol | Acción |
|------|--------|
| Operador Técnico | aislar, restaurar, validar |
| Auditor del Organismo | registrar, analizar, documentar |
| Maestro de Rituales | desactivar rituales si es necesario |
| Custodio del Latido | validar ritmo y OTT |
| Operador Narrativo | restaurar coherencia narrativa |
| Arquitecto del Ciclo | validar ciclos y temporadas |

---

# 12. Ejemplos de Incidentes y Respuestas

## 12.1. Pico de Energía
```
energía = 9999
```
Respuesta:

- aislar energía  
- restaurar snapshot  
- registrar incidente  
- activar modo seguro  

---

## 12.2. Loop de Gestos
```
200 gestos en 5 segundos
```
Respuesta:

- bloquear gestos  
- aislar órgano  
- registrar incidente  

---

## 12.3. Territorio Corrupto
```
dominancia < 0 o > 100
```
Respuesta:

- restaurar snapshot territorial  
- validar narrativa territorial  

---

# 13. Roadmap del Sistema de Incidentes

- respuesta automática avanzada  
- análisis predictivo  
- correlación narrativa‑técnica  
- incidentes territoriales dinámicos  
- incidentes rituales combinatorios  

---

# 14. Licencia
Proyecto interno.  
Acceso restringido a desarrolladores autorizados.