TAXONOMÍA DE ARQUITECTURA DEL SISTEMA
Mapa de Navegación Arquitectónica — Orquestación entre Kernel Determinista y Motor Estocástico
Eber Cruz — Software Engineer | Proyecto C-FARARONI
Marzo 2026 · Notas de Ingeniería
Fararoni: Topología del Sistema y Flujo de Ejecución
Diagrama de Arquitectura
Haz click en la imagen para ampliar · SVG vectorial de alta resolución
Leyenda Técnica
FARARONI CORE — Motor Dual (Rabbit-Turtle)
El núcleo opera con un modelo dual de ejecución: RABBIT (Fast) para respuestas de baja latencia en comandos determinísticos y TURTLE (Expert) para tareas que requieren razonamiento profundo del LLM. El Kernel decide automáticamente qué motor activar según el nivel de complejidad del input.
Cascada de 5 Niveles (ETAPA 1-5)
El enrutamiento se estructura en 5 etapas de ejecución progresiva:
- ETAPA 1 — Shell Directo: Comandos del sistema operativo (
pwd,ls,git status) ejecutados sin intervención del LLM. - ETAPA 2 — Mapeo de Intenciones: Frases naturales ("haz el commit") traducidas determinísticamente a secuencias de shell.
- ETAPA 3 — LLM Básico: Tareas que requieren comprensión de contexto mínima, procesadas por el motor Rabbit.
- ETAPA 4 — LLM Avanzado: Refactorización y análisis complejo, procesado por el motor Turtle con herramientas.
- ETAPA 5 — Orquestación Agéntica: Tareas multi-paso coordinadas por el SWARM/HIVEMIND de agentes especializados.
Agentes Especializados (SWARM)
El ecosistema cuenta con agentes autónomos especializados que operan bajo el patrón SWARM/HIVEMIND:
| Agente | Rol | Función |
|---|---|---|
| COMMANDER | Coordinador | Orquesta la misión y asigna tareas a los demás agentes |
| STRATEGIST | Planificador | Diseña la estrategia de ejecución y especificaciones técnicas |
| BUILDER | Constructor | Implementa código y escribe tests |
| RESEARCHER | Investigador | Recopila contexto técnico y arquitectónico |
| SCOUT | Explorador | Navega el filesystem y mapea la estructura del proyecto |
| SENTINEL | Guardián | Quality assurance y validación de seguridad |
| OPERATOR | Operador | Ejecuta comandos del sistema y gestiona procesos |
| WIZARD | Especialista | Tareas de alta complejidad y self-healing |
Tríada de Protección Zero-Trust
Tres capas de defensa en profundidad protegen la integridad del código en los niveles estocásticos:
- Kill-Switch (ReflexionGuard): Detector de alucinaciones destructivas basado en métricas Jaccard/Volume. Opera en niveles DEFCON (1, 3, 5) según la severidad de la amenaza.
- Git Saga Protocol: Aislamiento transaccional mediante ramas efímeras. Cada operación del LLM ocurre en una rama desechable; solo se fusiona si pasa validación.
- Shadow Backups (SovereignJournal): Persistencia inmutable mediante Chronicle Queue. Cada estado del código se respalda antes de cualquier modificación.
Sovereign Event Bus
La comunicación interna del sistema opera sobre un Bus de Eventos Soberano con arquitectura dual:
- Chronicle Queue (Disk-based): Bus de alta persistencia para eventos críticos y journal de operaciones.
- NATS (Enterprise): Bus de baja latencia para comunicación entre micro-agentes en tiempo real.
El patrón Bus Outbox con SQLite Journal garantiza que ningún evento se pierda, incluso ante fallos del sistema.
Canales de Comunicación (Sidecars)
La arquitectura Gateway Sidecar permite integración con múltiples transportes agnósticos bajo el protocolo S.A.T.I.:
- WhatsApp Sidecar — Meta API
- Telegram Sidecar — Bot API
- Discord Sidecar — WebSocket
- iMessage Sidecar — Native macOS
El OmniChannelRouter con ChannelAccessGuard gestiona el enrutamiento por canal y la seguridad de acceso mediante Zero-Trust Allowlist.
Puntos de Entrada
El sistema expone tres interfaces de acceso:
- CLI InteractiveShell (JLine3): Terminal interactiva para control directo del Kernel vía stdin/stdout.
- REST Server (:7070): API HTTP para integración programática con clientes curl/Postman.
- Gateway Sidecar (:7071): Punto de entrada para canales de mensajería externos.
El Callback (:9999) gestiona respuestas asíncronas de los agentes hacia los adaptadores de egreso.