# MODULAR_EXTENSIONS_NARRATIVE.md  
### Extensiones de la Narrativa Viva del Organismo 4GatosCoin  
### Versión 1.0 — 2 de enero 2026

---

## 1. Propósito del documento

Este documento define cómo crear extensiones que interactúan con la **Narrativa Viva** del organismo 4GatosCoin.  
La narrativa no es un texto estático:  
es un **órgano vivo**, un tejido simbólico que:

- responde a gestos  
- se altera con rituales  
- muta con seasons  
- despierta zonas del territorio  
- transforma el avatar  
- amplifica el pulso  
- genera ecos  
- registra eventos significativos  

Las extensiones narrativas permiten expandir el lore del organismo sin romper su coherencia.

---

## 2. ¿Qué es la Narrativa Viva?

La narrativa es un **sistema simbólico dinámico** compuesto por:

### ✔️ 2.1. Ecos  
Mensajes rituales emitidos por usuarios o por el organismo.

### ✔️ 2.2. Triggers narrativos  
Eventos que activan cambios en el lore.

### ✔️ 2.3. Ciclos narrativos  
Arcos que se desarrollan a lo largo de seasons.

### ✔️ 2.4. Registros de memoria  
Eventos significativos archivados en la memoria viva.

### ✔️ 2.5. Estados narrativos  
Condiciones globales que afectan al organismo.

### ✔️ 2.6. Mutaciones simbólicas  
Cambios profundos en territorio, avatar o pulso.

---

## 3. Componentes narrativos

---

### ✔️ 3.1. Ecos  
Un eco es un mensaje simbólico.

Ejemplo:

```json
{
  "wallet": "GLOBAL",
  "message": "El viento cambia..."
}
✔️ 3.2. Triggers narrativos
Eventos que activan cambios.

Ejemplo:

json
{
  "trigger": "onRitualCompleted",
  "ritual": "eclipse_colectivo"
}
✔️ 3.3. Ciclos narrativos
Arcos que se desarrollan en varias etapas.

Ejemplo:

Etapa 1: “El Despertar”

Etapa 2: “El Latido”

Etapa 3: “La Llama del Norte”

✔️ 3.4. Estados narrativos
Condiciones globales.

Ejemplo:

json
{
  "state": "shadow_over_territory"
}
✔️ 3.5. Memoria viva
Registro de eventos significativos.

Ejemplo:

json
{
  "event": "first_eclipse",
  "timestamp": 123456789
}
4. Hooks disponibles para extensiones narrativas
Las extensiones pueden escuchar:

Eventos energéticos
onGesture

onPointsAwarded

Eventos rituales
onRitualCompleted

onRitualTriggered

Eventos territoriales
onZoneAwakened

onTerritoryShift

Eventos globales
onSeasonChange

onGlobalPulse

Eventos sociales
onConnectionCreated

Eventos narrativos
onEcho

onLoreTrigger

5. Endpoints narrativos
5.1. Emitir eco
json
POST /api/actions/echo
{
  "wallet": "GLOBAL",
  "message": "La sombra se mueve..."
}
5.2. Activar trigger narrativo
json
POST /api/actions/narrative/trigger
{
  "type": "shadow_rises"
}
5.3. Registrar evento en memoria viva
json
POST /api/actions/narrative/memory
{
  "event": "first_resonance",
  "payload": { "wallet": "0x123..." }
}
5.4. Consultar narrativa activa
json
GET /api/global/narrative
6. Tipos de extensiones narrativas
✔️ 6.1. Extensiones de ecos
Añaden nuevos tipos de mensajes rituales.

Ejemplo:
“El bosque murmura tu nombre.”

✔️ 6.2. Extensiones de triggers
Activan cambios narrativos basados en eventos.

Ejemplo:
“Cuando el pulso supere 80, activa ‘Llama del Norte’.”

✔️ 6.3. Extensiones de ciclos narrativos
Añaden nuevas etapas al lore.

Ejemplo:
“Ciclo del Eclipse Total.”

✔️ 6.4. Extensiones de memoria viva
Registran eventos significativos.

Ejemplo:
“Primer ritual de resonancia.”

✔️ 6.5. Extensiones de estados narrativos
Cambian el estado global del organismo.

Ejemplo:
“shadow_over_territory”

✔️ 6.6. Extensiones de mutación simbólica
Transforman territorio, avatar o pulso.

Ejemplo:
“El territorio entra en estado ‘resonant’.”

7. Ejemplos de extensiones narrativas
7.1. Eco “El Viento Cambia”
Trigger: pulso > 50

Acción: eco global

Efecto: territorio → awakening

7.2. Trigger “Sombra Ascendente”
Trigger: 3 rituales Eclipse Colectivo

Acción: estado narrativo → shadow_over_territory

7.3. Ciclo “La Llama del Norte”
Etapa 1: pulso > 100

Etapa 2: Season 03

Etapa 3: avatar → ignited

7.4. Memoria “Primer Despertar”
Trigger: primera zona awakening

Acción: registrar evento en memoria viva

7.5. Mutación “Eclipse Total”
Trigger: 4 rituales Eclipse Colectivo

Acción: territorio → shadowed

Acción: pulso → 100

Acción: eco global

8. Reglas de seguridad narrativa
✔️ No se permite contradicción del lore
La narrativa es soberana.

✔️ No se permite contenido tóxico
Nada agresivo, violento o degradante.

✔️ No se permite saturación
Los ecos deben ser significativos.

✔️ No se permite manipulación emocional
La narrativa debe ser ritual, no coercitiva.

✔️ No se permite romper el pulso
Los ecos no pueden otorgar puntos sin validación.

✔️ No se permite exposición sensible
Nada que revele datos privados.

9. Buenas prácticas para diseñar narrativa
✔️ Mantener coherencia simbólica
El tono debe ser poético, ritual, vivo.

✔️ Mantener impacto
Cada eco debe sentirse.

✔️ Mantener modularidad
Cada extensión debe poder activarse o desactivarse sin romper el lore.

✔️ Mantener resonancia
La narrativa debe conectar con territorio, avatar y seasons.

10. Conclusión
La narrativa es el alma del organismo.
Las extensiones permiten:

nuevos ecos

nuevos ciclos

nuevos estados

nuevas mutaciones

nuevas memorias

nuevas resonancias

El organismo está listo para nuevas historias.
Las rutas narrativas están abiertas.