# CLAUSES.md — Sistema de Cláusulas Ritual del Organismo 4GatosCoin

Las **Cláusulas** son reglas rituales que definen cuándo se activa un evento profundo dentro del organismo 4GatosCoin.  
Son condiciones simbólicas y técnicas que, al cumplirse, desencadenan rituales, ecos, expansiones o transformaciones del organismo.

Este documento describe cómo funcionan, cómo se registran, cómo se evalúan y cómo deben implementarse.

---

# 1. ¿Qué es una Cláusula?

Una cláusula es:

- una condición ritual  
- una regla simbólica  
- un disparador de eventos  
- un umbral narrativo  
- un mecanismo de activación  

Las cláusulas permiten que el organismo responda a patrones colectivos.

---

# 2. Componentes Técnicos

### 2.1. Modelo
Las cláusulas se registran indirectamente en:

```
models/Log.ts
models/Gesture.ts
models/OrganismoGlobal.ts
```

### 2.2. Endpoints relacionados

```
GET /api/clause-stats
```

### 2.3. Panel DevWeb3
Ubicación:

```
app/devweb3/clausulas/
```

Funciones:

- ver estado de cláusulas  
- ver activaciones  
- ver estadísticas  
- activar cláusulas manualmente (solo dev)  

---

# 3. Tipos de Cláusulas

## 3.1. Cláusulas de Gesto
Activadas por:

- repetición de un gesto  
- intensidad de ecos  
- patrones de actividad  

Ejemplo:

```
pulso_vocal ejecutado 100 veces en 10 minutos
```

---

## 3.2. Cláusulas de Energía
Activadas por:

- alcanzar umbrales energéticos  
- desbalances  
- regeneración masiva  

Ejemplo:

```
energía global > 1500
```

---

## 3.3. Cláusulas de Territorio
Activadas por:

- expansión  
- dominancia  
- zonas activas  

Ejemplo:

```
zona norte supera 20 de dominancia
```

---

## 3.4. Cláusulas Narrativas
Activadas por:

- memoria profunda  
- ecos significativos  
- anomalías  

Ejemplo:

```
eco de intensidad > 15
```

---

## 3.5. Cláusulas de Ritual
Activan rituales mayores.

Ejemplo:

```
El Grito Que Crea → activado cuando se cumplen 3 cláusulas previas
```

---

# 4. Ejemplo: *El Grito Que Crea*

El ritual fundacional del organismo se activa mediante una cláusula compuesta.

### 4.1. Condiciones típicas

- número de gestos recientes  
- intensidad de ecos  
- energía acumulada  
- participación colectiva  

### 4.2. Endpoint asociado

```
GET /api/clause-stats
```

### 4.3. Respuesta típica

```json
{
  "totalGestures": 88,
  "lastGesture": "pulso_vocal"
}
```

### 4.4. Activación
Cuando se cumplen las condiciones, se activa:

- memoria profunda  
- energía masiva  
- expansión territorial  
- avance de ciclo  

---

# 5. Flujo de una Cláusula

```
Evento → Evaluación → Cumplimiento → Activación → Registro → Memoria
```

### 5.1. Entrada
La cláusula recibe:

- gestos  
- energía  
- ecos  
- territorio  
- memoria  
- rituales  

### 5.2. Evaluación
El sistema evalúa si se cumple la condición.

### 5.3. Activación
Si se cumple, se activa un evento ritual.

### 5.4. Registro
Se registra en logs.

### 5.5. Memoria
Genera memoria profunda.

---

# 6. Relación con Otros Órganos

### 6.1. Con Rituales
Las cláusulas son el mecanismo que activa rituales.

### 6.2. Con Energía
Las cláusulas energéticas pueden iniciar ciclos.

### 6.3. Con Territorio
Las cláusulas territoriales pueden expandir zonas.

### 6.4. Con Memoria
Las cláusulas narrativas generan memoria profunda.

### 6.5. Con Temporadas
Las temporadas pueden redefinir cláusulas.

---

# 7. Ejemplo de Cláusula Completa

```json
{
  "clause": "eco_intenso",
  "condition": "eco_intensity > 15",
  "activated": true,
  "timestamp": 1700000000
}
```

---

# 8. Cómo Extender el Sistema de Cláusulas

1. Definir nueva cláusula en:
   ```
   lib/clausulas/
   ```
2. Añadir lógica en:
   ```
   app/api/clause-stats
   ```
3. Añadir UI en:
   ```
   app/devweb3/clausulas/
   ```
4. Actualizar narrativa si aplica.
5. Actualizar documentación.

---

# 9. Roadmap del Sistema de Cláusulas

- cláusulas combinatorias  
- cláusulas por temporada  
- cláusulas territoriales avanzadas  
- cláusulas rituales profundas  
- cláusulas narrativas generativas  

---

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