Tests ADN / test (push) Canceled after 0s
- 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>
152 lines
7.1 KiB
Markdown
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
|