# MODULAR_EXTENSIONS_PULSE.md  
### Extensiones del Pulso Global 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 el **Pulso Global** del organismo 4GatosCoin.  
El pulso es el **signo vital** del organismo.  
Refleja:

- actividad colectiva  
- energía acumulada  
- resonancia social  
- impacto de rituales  
- estado del territorio  
- fuerza narrativa  
- ritmo de seasons  

Las extensiones pueden modificar, amplificar o interpretar el pulso, siempre respetando la coherencia energética del organismo.

---

## 2. ¿Qué es el Pulso Global?

El pulso es un valor numérico dinámico que representa la **energía colectiva** del organismo.

Ejemplo:

```json
{
  "pulse": 67,
  "timestamp": 123456789
}
El pulso:

sube con actividad significativa

baja con inactividad

se estabiliza con rituales

se amplifica con seasons

se distorsiona con zonas shadowed

se calma con ecos narrativos

3. Cómo se calcula el pulso
El pulso se calcula a partir de:

✔️ 3.1. Gestos
Cada gesto aporta entre 1 y 3 unidades de pulso.

✔️ 3.2. Rituales
Los rituales colaborativos aportan más energía.

✔️ 3.3. Conexiones sociales
Cada conexión simbólica aporta resonancia.

✔️ 3.4. Actividad territorial
Zonas activas aumentan el pulso.

✔️ 3.5. Seasons
Ciertas temporadas amplifican o reducen el pulso.

✔️ 3.6. Narrativa
Ecos globales pueden modificar el pulso.

✔️ 3.7. Extensiones
Los módulos pueden añadir nuevas fuentes de energía.

4. Estados del pulso
El pulso puede estar en uno de los siguientes estados:

✔️ dormant (0–10)
El organismo está casi inactivo.

✔️ awakening (10–30)
El organismo empieza a moverse.

✔️ active (30–60)
El organismo está vivo y estable.

✔️ resonant (60–90)
El organismo vibra con fuerza.

✔️ overcharged (90–100)
El organismo está en un estado excepcional.

✔️ collapsed (0)
El organismo ha perdido energía temporalmente.

5. Hooks disponibles para extensiones del pulso
Las extensiones pueden escuchar:

Eventos energéticos
onGesture

onPointsAwarded

onStreakReached

Eventos rituales
onRitualCompleted

onRitualTriggered

Eventos sociales
onConnectionCreated

Eventos territoriales
onZoneAwakened

onTerritoryShift

Eventos globales
onSeasonChange

onGlobalPulse

Eventos narrativos
onEcho

onLoreTrigger

6. Endpoints del pulso
6.1. Consultar pulso
json
GET /api/global/pulse
6.2. Modificar pulso (solo extensiones validadas)
json
POST /api/actions/pulse
{
  "amount": 5,
  "reason": "ritual_resonancia"
}
6.3. Emitir eco del pulso
json
POST /api/actions/echo
{
  "wallet": "GLOBAL",
  "message": "El pulso se intensifica..."
}
7. Tipos de extensiones del pulso
✔️ 7.1. Extensiones amplificadoras
Aumentan el pulso en respuesta a eventos.

Ejemplo:
“Latido Amplificado” → +3 cuando se completan 10 gestos en 1 minuto.

✔️ 7.2. Extensiones estabilizadoras
Evitan que el pulso caiga demasiado rápido.

Ejemplo:
“Ritual de Calma” → reduce la caída nocturna.

✔️ 7.3. Extensiones resonantes
Aumentan el pulso cuando hay actividad social.

Ejemplo:
“Resonancia Social” → +1 por cada conexión nueva.

✔️ 7.4. Extensiones territoriales
Zonas activas modifican el pulso.

Ejemplo:
“Bosque Susurrante” → +2 cuando está en awakening.

✔️ 7.5. Extensiones estacionales
Seasons que alteran el pulso.

Ejemplo:
“Llama del Norte” → +1 por gesto energético.

✔️ 7.6. Extensiones narrativas
Ecos globales que afectan el pulso.

Ejemplo:
“El viento cambia” → +5 temporal.

✔️ 7.7. Extensiones on‑chain (futuras)
Acciones verificadas en Base pueden aumentar el pulso.

8. Ejemplos de extensiones del pulso
8.1. Extensión “Latido Amplificado”
Trigger: 20 gestos en 5 minutos

Efecto: pulso +4

Eco: “El organismo vibra con fuerza.”

8.2. Extensión “Ritual de Calma”
Trigger: pulso < 10

Efecto: pulso +2

Eco: “Una calma profunda recorre el organismo.”

8.3. Extensión “Resonancia Social”
Trigger: nueva conexión

Efecto: pulso +1

8.4. Extensión “Despertar Territorial”
Trigger: zona → awakening

Efecto: pulso +3

8.5. Extensión “Eclipse Total”
Trigger: 4 rituales Eclipse Colectivo

Efecto: pulso → 100

Estado: overcharged

8.6. Extensión “Llama del Norte”
Trigger: Season 03

Efecto: +1 por gesto energético

9. Reglas de seguridad del pulso
✔️ No se permite manipulación directa sin validación
Todo pasa por /api/actions/pulse.

✔️ No se permiten loops infinitos
El pulso no puede subir indefinidamente.

✔️ No se permite contradicción narrativa
El pulso debe reflejar el estado del organismo.

✔️ No se permite saturación
El pulso no debe cambiar cientos de veces por minuto.

✔️ No se permite toxicidad
Nada que genere ansiedad o presión social.

10. Buenas prácticas para diseñar extensiones del pulso
✔️ Mantener equilibrio
El pulso debe fluctuar, no explotar.

✔️ Mantener significado
Cada cambio debe sentirse.

✔️ Mantener coherencia
El pulso debe reflejar la vida del organismo.

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

11. Conclusión
El pulso es el latido del organismo.
Las extensiones permiten:

amplificarlo

estabilizarlo

resonarlo

transformarlo

conectarlo con seasons, territorio y rituales

El organismo está listo para nuevos latidos.
Las rutas energéticas están abiertas.