# 🦆 Repositorio Pichinal

[![Build Status](https://img.shields.io/badge/Build-Explicando...-yellow.svg)](https://gitea.vpsburti.com/Burtiraven2/repositorio-pichinal)
[![Curiosity Level](https://img.shields.io/badge/Curiosidad-Over_9000-red.svg)](https://gitea.vpsburti.com/Burtiraven2/repositorio-pichinal)
[![Query Loop](https://img.shields.io/badge/Loop-Explícame_Explícame-blue.svg)](https://gitea.vpsburti.com/Burtiraven2/repositorio-pichinal)
[![License](https://img.shields.io/badge/Licencia-Pichinal_v2.0-green.svg)](https://gitea.vpsburti.com/Burtiraven2/repositorio-pichinal)

> **Repositorio Pichinal** es el centro neurálgico de cómputo conversacional dedicado a la entidad biológica y técnica más curiosa del ecosistema: **Krismarc**.

---

## 🧐 ¿Qué es este repositorio?

Este proyecto recopila, optimiza y documenta el motor perpetuo impulsado por **Krismarc**, una persona con una capacidad inagotable para:
1. **Preguntar absolutamente todo** con su comando por defecto: `explícame, explícame`.
2. **Explicarte de vuelta lo que le acabas de explicar**, pero con más detalle, contexto histórico y diagramas imaginarios.

Si dejas a Krismarc 5 segundos en silencio en una llamada o sala, el demonio en segundo plano (`explicame-daemon`) se reactiva automáticamente.

---

## ⚡ Especificaciones Técnicas de Krismarc

```yaml
entidad: "Krismarc"
modo_operativo: "Pregunta-Respuesta-Explicación Recursiva"
latencia_de_pregunta: "0.02ms tras terminar tu frase"
frase_de_arranque: "Oye, pero... ¡explícame, explícame!"
nivel_de_detalle: "Hasta nivel de ensamblador y hardware cuántico"
capacidad_de_escucha: "Alta, mientras procesa la siguiente duda"
memoria_cache: "Infinita (se acuerda de lo que explicaste hace 3 años)"
```

---

## 🔄 El Ciclo de Vida (Krismarc Loop)

El sistema opera bajo una arquitectura de eventos basada en el siguiente ciclo infinito:

```text
               +-----------------------------+
               |      Alguien habla de       |
               |     cualquier concepto      |
               +--------------+--------------+
                              |
                              v
               +-----------------------------+
               |   "¡Explícame, explícame!"  | <------+
               +--------------+--------------+        |
                              |                       |
                              v                       |
               +-----------------------------+        |
               |    Recibe la explicación    |        | (Repetir ad infinitum)
               +--------------+--------------+        |
                              |                       |
                              v                       |
               +-----------------------------+        |
               |     "Ah vale... pero        |        |
               |   ¿y cómo funciona X?"      |        |
               +--------------+--------------+        |
                              |                       |
                              v                       |
               +-----------------------------+        |
               | Te explica él cómo debería  |        |
               |    hacerse en realidad      | -------+
               +-----------------------------+
```

---

## 🚀 Instalación y Despliegue

Para desplegar una instancia de Krismarc en tu servidor local:

```bash
# 1. Clonar el repositorio pichinal
git clone https://gitea.vpsburti.com/Burtiraven2/repositorio-pichinal.git

# 2. Iniciar el servicio con Docker
docker run -d \
  --name krismarc-engine \
  --restart always \
  -e CURIOSIDAD=MAXIMA \
  -e PHRASE="explicame, explicame" \
  pichinal/krismarc:latest

# 3. Comprobar los logs de preguntas
docker logs -f krismarc-engine
# Salida esperada:
# [INFO] Escuchando...
# [INPUT DETECTADO]: "El servidor usa Nginx"
# [TRIGGER]: "¡Explícame, explícame!"
```

---

## 🛠️ Comandos CLI Disponibles

| Comando | Acción |
| :--- | :--- |
| `pichinal --duda` | Lanza una ráfaga de 15 preguntas consecutivas. |
| `pichinal --explicame` | El comando estrella. Se debe ejecutar 2 veces seguidas: *«explícame, explícame»*. |
| `pichinal --masterclass` | Krismarc toma la pizarra digital y te explica la vida en 45 minutos. |
| `pichinal --callar` | **ERROR 403:** Acción no permitida por el kernel. |

---

## ❓ Preguntas Frecuentes (FAQ)

**P: ¿Qué pasa si le digo que ya se lo he explicado?**  
R: Te responderá: *«Sí, pero explícamelo otra vez para ver si lo he entendido igual que tú»*.

**P: ¿Se le agotan las preguntas alguna vez?**  
R: No. El garbage collector de Krismarc no limpia las preguntas, las apila en una cola prioritaria (`FIFO: First In, Forever Outstanding`).

**P: ¿Cuál es el significado profundo de "Pichinal"?**  
R: Si necesitas saberlo, abre una *Issue* o pídele a Krismarc: *«¡explícame, explícame!»*.

---

## 📜 Licencia

Distribuido bajo la **Licencia Pichinal Pública**:
* Puedes bifurcar (*fork*) este repositorio.
* Puedes hacerle preguntas.
* Lo único obligatorio es **explicarlo todo con pelos y señales**.