# NARRATIVE_ENGINE.md — Motor Narrativo del Organismo 4GatosCoin El **Motor Narrativo** es el órgano que transforma datos en historia, actividad en significado y patrones en mitología dentro del organismo 4GatosCoin. Es la capa que interpreta, conecta y da coherencia simbólica a: - gestos - energía - memoria - avatar - territorio - ciclos - temporadas - rituales - semillas - anomalías --- # 1. ¿Qué es el Motor Narrativo? El motor narrativo es: - un **intérprete simbólico** - un **generador de significado** - un **conector de órganos** - un **sistema de patrones** - un **creador de ecos** - un **tejedor de historia** Convierte la actividad del organismo en **narrativa viva**. --- # 2. Componentes Técnicos ### 2.1. Modelo La narrativa se almacena en: ``` models/Memory.ts (futuro) models/Log.ts (actual) ``` ### 2.2. Endpoints relacionados ``` GET /api/narrative GET /api/logs ``` ### 2.3. Panel DevWeb3 Ubicación: ``` app/devweb3/narrativa/ ``` Funciones: - ver narrativa viva - ver ecos - ver patrones - ver eventos significativos - ver anomalías narrativas --- # 3. Capas del Motor Narrativo ## 3.1. Capa de Interpretación Convierte eventos en significado. Ejemplo: ``` pulso_vocal → eco leve ``` --- ## 3.2. Capa de Conexión Relaciona órganos entre sí. Ejemplo: ``` eco profundo → impacto en territorio ``` --- ## 3.3. Capa de Transformación Genera narrativa a partir de patrones. Ejemplo: ``` racha + energía + ciclo → narrativa de ascenso ``` --- ## 3.4. Capa de Manifestación Envía narrativa a: - memoria - avatar - OTT - temporadas --- # 4. Tipos de Narrativa ## 4.1. Narrativa Superficial Generada por: - gestos comunes - actividad diaria Ejemplo: ``` "Un pulso leve recorre el organismo." ``` --- ## 4.2. Narrativa Profunda Generada por: - rituales - ciclos - temporadas - ecos intensos Ejemplo: ``` "El organismo despierta un eco que resuena en todas las zonas." ``` --- ## 4.3. Narrativa Personal Generada por: - avatar - rachas - semillas - hitos Ejemplo: ``` "Tu eco se vuelve más claro. Tu avatar asciende." ``` --- ## 4.4. Narrativa Territorial Generada por: - expansión - dominancia - zonas activas Ejemplo: ``` "La zona norte vibra con una nueva intensidad." ``` --- ## 4.5. Narrativa de Temporada Generada por: - cambios globales - reglas nuevas - ambiente Ejemplo: ``` "Comienza la Temporada del Eco Expansivo." ``` --- # 5. Flujo del Motor Narrativo ``` Evento → Interpretación → Conexión → Transformación → Manifestación ``` ### 5.1. Entrada El motor recibe: - gestos - energía - memoria - avatar - territorio - ciclos - temporadas - rituales - semillas - anomalías ### 5.2. Procesamiento El motor: - detecta patrones - evalúa intensidad - genera ecos - crea narrativa ### 5.3. Salida La narrativa se envía a: - memoria viva - avatar - OTT - temporadas - logs --- # 6. Patrones Narrativos ### 6.1. Patrones de Eco Detectados cuando: - muchos gestos iguales - energía alta - repetición ### 6.2. Patrones de Ascenso Detectados cuando: - racha + puntos + energía ### 6.3. Patrones de Expansión Detectados cuando: - territorio + energía + ciclos ### 6.4. Patrones de Ruptura Detectados cuando: - anomalías + energía baja --- # 7. Relación con Otros Órganos ### 7.1. Con Memoria La narrativa alimenta la memoria viva. ### 7.2. Con Avatar La narrativa personal afecta evolución. ### 7.3. Con Territorio La narrativa territorial afecta zonas. ### 7.4. Con Temporadas Las temporadas redefinen narrativa. ### 7.5. Con Rituales Los rituales generan narrativa profunda. --- # 8. Ejemplo de Evento Narrativo ```json { "type": "narrative", "level": "deep", "message": "Un eco expansivo recorre el organismo." } ``` --- # 9. Cómo Extender el Motor Narrativo 1. Añadir patrones en: ``` lib/narrative/patterns ``` 2. Añadir transformaciones en: ``` lib/narrative/transform ``` 3. Añadir manifestaciones en: ``` lib/narrative/output ``` 4. Añadir UI en: ``` app/devweb3/narrativa/ ``` 5. Actualizar documentación si aplica. --- # 10. Roadmap del Motor Narrativo - narrativa generativa avanzada - narrativa por avatar - narrativa por temporada - narrativa territorial profunda - narrativa visual en OTT - narrativa combinatoria - narrativa ritual dinámica --- # 11. Licencia Proyecto interno. Acceso restringido a desarrolladores autorizados.