Files
dtic-DIIAA/servicios/nexxa/germen.md
T
a60758875d
Tests ADN / test (push) Canceled after 0s
feat(nexxa): NEXXA versionada en dtic-DIIAA (1.3.0): pools por individuo mente/red, API por rol y gestión desde nexxa-web
- Base: código de producción de srvv-nexxa (1.2.1), importado y verificado por hash (P335/F3)
- Pools por individuo (lib_pools): mente y red, mezclan proveedores, keys compartidas o exclusivas
- API: /disponible/mente|red y /estado por rol, pool_vacio explícito, /pools (CRUD admin), liberar admin
- Revertir el agotada propio + motivo y quién la agotó (de P334/F4)
- nexxa-web: sección Pools, motivo y botón Liberar, provider libre con sugerencias, escape de texto externo
- Convención REG002: lib_*, cli_*, tool_humo_pool; contratos externos con su nombre
- Suite local sobre copia aislada: humo HTTP, pools, revertir; servidor_prueba para mirar la web

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Co-Authored-By: GEMMA <noreply@gemma.dtic>
2026-10-04 16:42:13 -03:00

152 lines
7.1 KiB
Markdown

# 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