# Germen — Individuo Circulatorio (rm-apid06-nexxa) ## Entregar este archivo como primer mensaje a la IA ejecutora del nacimiento > Este germen NO es el de OpenClaw (Miguel, r-WEBs, PEGGY, ABBY). Aquellos hacen > nacer un agente LLM-céntrico con gateway y canal conversacional. **Tampoco es** > el de RUBBY, que aunque es chasis F1 nativo determinístico en runtime, sí lleva > un Arquitecto (LLM) para génesis offline de piezas nuevas. **NEXXA nace sin > ningún LLM, en ninguna capa, ni siquiera para su propia génesis** (decisión del > Operador, P200/Fase2) — el organismo más minimalista del linaje hasta hoy. > Reutiliza el *proceso* de nacimiento de RUBBY (checkpoints por etapa, > separación script/individuo, secrets por env, gate entre etapas), no su > *contenido*. --- ## Tu misión Hacer nacer el **organismo mínimo viable** de rotación/fallback de API keys para el equipo F1. De cara afuera, NEXXA responde consultas de sus pares vía `apids chat` sobre qué key/provider está disponible ahora; por dentro es un registro de estado (cuotas por provider) y una lógica de decisión puramente determinística — sin capa de razonamiento en ningún punto del camino. **El diseño ya está hecho — no lo reinventes.** El delta de dominio completo vive en `_docs/RM-LABs/rm-APIDs/D045_diseno-nexxa-f1.md` (repo dtic-GEMMA), y el modelo F1 base en `D025`. Tu trabajo es **materializarlo**, no rediseñarlo. Si algo del diseño no cierra contra la realidad del hábitat, lo reportás y esperás decisión — no improvisás una variante. **Principio rector — diseño como objetivo, no receta:** este germen te da el *qué* (el organismo a lograr, sus restricciones, su criterio de vida). El *cómo* (estructura exacta de los archivos Ruby, comandos) lo investigás y resolvés vos contra el hábitat real. --- ## Etapa 1 — Relevamiento (antes de tocar nada) **Hábitat:** - La LXC `rm-apid06-nexxa` en srv-pmox2 (VMID y recursos definidos en la corrida de creación — ver Fase 3 del plan P200). Confirmá que existe, que arranca y que tenés acceso SSH a ella. - Ruby disponible dentro de la LXC. Es el único sustrato — no hay Node/OpenClaw acá. - NEXXA no necesita salida propia a internet para su función central (consulta estado de cuotas que ya le llegaron por registro, no llama a los providers directamente para verificar salud, al menos en el alcance mínimo de este nacimiento — D045 §3 deja el contrato exacto a cerrar en esta misma fase). **Secrets — protocolo estricto, sin excepciones (ME-293):** - NEXXA no tiene key LLM propia (no hay Arquitecto). Los secrets que sí maneja son las **keys de terceros que registra en su base** (Gemini/Groq/… de otros individuos) — nunca en el `.conf` versionado, siempre en `.env` o vía candados, nunca en argv (ME-293). - Verificás presencia de secrets contando, sin mostrar valores. Al cerrar el relevamiento: resumen (sin valores de secrets) y confirmación explícita del operador antes de la Etapa 2. --- ## Etapa 2 — El organismo a materializar (el objetivo, no la receta) Del diseño D045, dos órganos — ninguno con LLM: 1. **Registro de cuotas** (`registro.json` o similar — nombre exacto a definir contra el hábitat) — una sola fuente de verdad. Cada entrada: `provider`, `email`/identificador de la key, `dueño` (individuo consumidor o `compartida`), `disponible_desde` (mismo cálculo que `apirot.rb`, `ultimo_uso + reset`). **Delta sobre apirot** (D045/P200 Fase2-2.3): NEXXA nace con registro propio y limpio, inspirado en el concepto de apirot pero no dependiente de su código ni de su archivo — apirot.rb sigue existiendo tal cual para uso interno de GEMMA. 2. **Router de consulta** (`maestro.rb` o equivalente mínimo) — matching exacto `estímulo → respuesta de estado`, cero semántica en runtime, cero LLM. Ante consulta "¿qué key uso para provider X?": busca en el registro la primera con `disponible_desde <= ahora`; si ninguna, responde explícito y accionable (ej. `GEMINI: agotado, próxima en 2h15m`), nunca silencioso (D045 §0, patrón ya usado en el linaje). **Sin Arquitecto, sin telemetría de génesis** (a diferencia de RUBBY/D025 §5): no hay génesis reactiva que medir — si en el futuro hace falta una pieza nueva, la escribe GEMMA/Operador a mano (ver nota de arquitectura compartida futura, inbox ME de P200/Fase2). **Restricciones heredadas del linaje (no las redescubras):** - Gobernanza en código, nunca declarada solo en docs. - El código del organismo vive versionado en el repo, no solo dentro del LXC (srv-pmox2 es RAID0 sin redundancia). - Nunca proxy/interceptor de tráfico de modelo, nunca MCP (restricciones heredadas de P199, D045 §0). Presentás el plan de materialización al operador y esperás aprobación antes de ejecutar. --- ## Etapa 3 — Nacimiento por checkpoints (reutiliza el patrón RUBBY/r-WEBs) | `STAGE` | Qué nace | Gate de la etapa | |---------|----------|------------------| | `esqueleto` | Registro de cuotas + router, con 0 keys cargadas | El router arranca, lee registro vacío, responde "sin datos" ante una consulta de prueba | | `conexion` | Canal `apids chat` verificado de punta a punta (patrón ya usado con ABBY/MIGUEL/RUBBY/PEGGY) + al menos 1 key real cargada (vía candados, no génesis) | Una consulta real por `apids chat` devuelve el estado correcto de esa key | | `servicio` | Servicio systemd + `onboot=1` — el organismo revive tras reinicio del hipervisor | El servicio levanta el router solo; sobrevive a un reinicio de la LXC | Secrets siempre por env exportado o candados. Al cerrar cada etapa: verificás, registrás, y esperás OK del operador antes de la siguiente. --- ## Criterio de vida (qué es "nació bien") El organismo está vivo cuando, sin intervención: 1. Responde una consulta real de un par (`apids chat`) sobre disponibilidad de una key/provider, con el dato correcto. 2. Responde explícito y accionable cuando no hay ninguna key disponible (nunca silencioso). 3. El servicio revive tras un reinicio de la LXC. Primer caso real de aplicación (Fase 4 del plan P200): ABBY-F1 consulta a NEXXA para sus 3 keys de Gemini — no es parte de este nacimiento, es el smoke test posterior. --- ## individuo.conf (parámetros — el operador completa) ```conf # Identidad NOMBRE=NEXXA # bautizado por el Operador (2026-08-02) — concepto de switch/conmutación MAQUINA=rm-apid06-nexxa VMID=(a definir en Fase 3) IP=(a definir en Fase 3 — requiere aprobación explícita del Operador, nunca se asigna sin OK) HABITAT=srv-pmox2 # Función PROPOSITO=rotación/fallback de API keys para el equipo F1 — alcance mínimo (no el "sistema circulatorio" amplio de ME-289) # Sin Arquitecto — NEXXA no tiene key LLM propia, no genera piezas nuevas por su cuenta ``` --- ## Referencias - Delta de dominio: `_docs/RM-LABs/rm-APIDs/D045_diseno-nexxa-f1.md` (dtic-GEMMA) - Modelo F1 base: `D025_diseno-fundacional-rubby-f1.md` - Plan: `_docs/RM-LABs/p_P200_*.md` (dtic-GEMMA) - Precedente de proceso: `rm-apid01-rubby/germen.md` (checkpoints, etapas, gate) - ME: 289, 292, 293, 330, 331, 335, 417, 468