# MEMORY_SYSTEM.md — Sistema de Memoria Viva del Organismo 4GatosCoin

La **Memoria Viva** es el órgano narrativo del ecosistema 4GatosCoin.  
Registra eventos significativos, ecos, gestos especiales, rituales, ciclos y transformaciones del organismo.

Es la capa que convierte datos en **historia**, acciones en **ecos**, y actividad en **narrativa**.

---

# 1. ¿Qué es la Memoria Viva?

La memoria es un registro estructurado de:

- gestos significativos  
- eventos rituales  
- hitos del usuario  
- cambios del organismo global  
- ciclos completados  
- temporadas  
- ecos narrativos  
- anomalías  
- silencios rituales  

La memoria permite que el organismo:

- recuerde  
- evolucione  
- genere narrativa  
- reaccione a patrones  
- construya identidad  

---

# 2. Componentes Técnicos

### 2.1. Modelos
Actualmente la memoria se registra en:

```
models/Log.ts
```

Futuro:

```
models/Memory.ts
```

### 2.2. Endpoints relacionados
- `/api/logs`
- `/api/gesture` (genera memoria)
- `/api/ritual` (genera memoria profunda)
- `/api/clause-stats` (memoria ritual específica)

### 2.3. Panel DevWeb3
Ubicación:

```
app/devweb3/memoria/
```

Funciones:

- ver memoria viva  
- filtrar por tipo  
- ver ecos  
- ver eventos rituales  
- ver anomalías  
- ver hitos  

---

# 3. Tipos de Memoria

La memoria se clasifica en capas:

## 3.1. Memoria Superficial
Generada por:

- gestos comunes  
- actividad diaria  
- puntos  
- energía  

Ejemplo:

```json
{
  "type": "gesture",
  "wallet": "0x123...",
  "gesture": "pulso_vocal"
}
```

---

## 3.2. Memoria Profunda
Generada por:

- rituales  
- gestos especiales  
- ciclos completados  
- eventos globales  

Ejemplo:

```json
{
  "type": "ritual",
  "ritual": "elgritoquecrea",
  "participants": 88
}
```

---

## 3.3. Memoria de Ecos
Los ecos son repeticiones narrativas que surgen cuando:

- muchos usuarios ejecutan el mismo gesto  
- se activa un patrón  
- se repite un evento  

Ejemplo:

```json
{
  "type": "eco",
  "gesture": "pulso_vocal",
  "intensity": 12
}
```

---

## 3.4. Memoria de Silencio
Generada por gestos como:

- `pause`
- `reflection`

Ejemplo:

```json
{
  "type": "silencio",
  "depth": 4
}
```

---

## 3.5. Memoria de Anomalías
Registra eventos inesperados:

- ráfagas de gestos  
- actividad fuera de patrón  
- errores rituales  
- desbalances de energía  

Ejemplo:

```json
{
  "type": "anomaly",
  "description": "burst of 200 gestures in 10 seconds"
}
```

---

# 4. Flujo de Memoria

```
Gesto → Registro → Clasificación → Impacto → Narrativa → Ecos → Temporadas
```

### 4.1. Entrada
La memoria recibe:

- gestos  
- rituales  
- ciclos  
- energía  
- territorio  
- temporadas  

### 4.2. Clasificación
La memoria decide si el evento es:

- superficial  
- profundo  
- eco  
- silencio  
- anomalía  

### 4.3. Impacto
La memoria puede afectar:

- narrativa  
- visualización OTT  
- avatar individual  
- reglas de temporada  
- hitos  

---

# 5. Relación con Otros Órganos

### 5.1. Con Gestos
Cada gesto genera memoria.

### 5.2. Con Puntos
Los hitos de puntos generan memoria profunda.

### 5.3. Con Energía
Cambios bruscos generan ecos o anomalías.

### 5.4. Con Territorio
Expansiones generan memoria narrativa.

### 5.5. Con Ciclos
Cada ciclo completado genera un evento de memoria.

### 5.6. Con Temporadas
Las temporadas redefinen cómo se interpreta la memoria.

---

# 6. Ejemplos de Eventos de Memoria

### 6.1. Gesto común
```json
{
  "type": "gesture",
  "wallet": "0xabc...",
  "gesture": "pulso_vocal"
}
```

### 6.2. Eco
```json
{
  "type": "eco",
  "gesture": "pulso_vocal",
  "intensity": 20
}
```

### 6.3. Ritual
```json
{
  "type": "ritual",
  "ritual": "elgritoquecrea",
  "participants": 120
}
```

### 6.4. Ciclo completado
```json
{
  "type": "cycle",
  "cycle": 12
}
```

### 6.5. Temporada activada
```json
{
  "type": "season",
  "season": 3
}
```

---

# 7. Cómo Extender la Memoria

1. Crear nuevo tipo en:
   ```
   types/Memory.ts
   ```
2. Añadir lógica en:
   ```
   app/api/logs
   ```
3. Añadir UI en:
   ```
   app/devweb3/memoria/
   ```
4. Añadir reglas en:
   ```
   lib/memory/
   ```
5. Actualizar documentación si aplica.

---

# 8. Roadmap del Sistema de Memoria

- `Memory.ts` como modelo dedicado  
- ecos combinatorios  
- memoria por avatar individual  
- memoria global visualizable en OTT  
- memoria profunda por temporadas  
- narrativa generativa basada en patrones  

---

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