feat(nexxa): NEXXA versionada en dtic-DIIAA (1.3.0): pools por individuo mente/red, API por rol y gestión desde nexxa-web
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>
This commit is contained in:
Ricardo Monla
2026-10-04 16:42:13 -03:00
co-authored by Claude Opus 5.5 GEMMA
parent 50ac0d0fdf
commit a60758875d
31 changed files with 5653 additions and 0 deletions
+106
View File
@@ -0,0 +1,106 @@
# frozen_string_literal: true
# pools_test.rb — Pools por individuo (P335/Fase 4). Corre sobre una COPIA de organismo/ en un directorio temporal:
# registro.json/pools.json de prueba, nunca los reales. ruby servicios/nexxa/test/pools_test.rb
require 'minitest/autorun'
require 'tmpdir'
require 'fileutils'
DIR_PRUEBA = Dir.mktmpdir('nexxa-pools')
Dir[File.expand_path('../organismo/*.rb', __dir__)].each { |f| FileUtils.cp(f, DIR_PRUEBA) }
require File.join(DIR_PRUEBA, 'lib_registro')
require File.join(DIR_PRUEBA, 'lib_pools')
Minitest.after_run { FileUtils.rm_rf(DIR_PRUEBA) }
class PoolsTest < Minitest::Test
R = Nexxa::Registro
P = Nexxa::Pools
def setup
FileUtils.rm_f([R::STATE_FILE, P::STATE_FILE])
pasado = (Time.now - 3600).iso8601(3)
key = ->(p, i, extra = {}) { { 'provider' => p, 'identificador' => i, 'disponible_desde' => pasado, 'reset_segundos' => 86_400 }.merge(extra) }
R.guardar('keys' => [key.('gemini', 'g-01', 'ultimo_uso' => (Time.now - 60).iso8601(3)),
key.('deepseek', 'd-01', 'ultimo_uso' => (Time.now - 600).iso8601(3)),
key.('gemini', 'g-red'),
key.('gemini', 'g-off', 'activo' => false)])
end
def asignar(ind, rol, p, i) = P.asignar(individuo: ind, rol: rol, provider: p, identificador: i)
def test_pool_mezcla_proveedores_y_da_la_menos_usada
asignar('gemma', 'mente', 'gemini', 'g-01')
asignar('gemma', 'mente', 'deepseek', 'd-01')
k = R.disponible_en(P.refs('gemma', 'mente'))
assert_equal %w[deepseek d-01], [k['provider'], k['identificador']]
end
def test_red_separada_de_mente_y_compartida_entre_individuos
asignar('gemma', 'mente', 'gemini', 'g-01')
asignar('gemma', 'red', 'gemini', 'g-red')
asignar('peggy', 'red', 'gemini', 'g-red')
assert_equal 'g-red', R.disponible_en(P.refs('gemma', 'red'))['identificador']
assert_equal [{ 'individuo' => 'gemma', 'rol' => 'red' }, { 'individuo' => 'peggy', 'rol' => 'red' }],
P.de_key('gemini', 'g-red')
end
def test_asignar_es_idempotente_y_valida
2.times { asignar('gemma', 'mente', 'gemini', 'g-01') }
assert_equal ['gemini/g-01'], P.refs('gemma', 'mente')
assert_raises(RuntimeError) { asignar('gemma', 'otro', 'gemini', 'g-01') }
assert_raises(RuntimeError) { asignar('gemma', 'mente', 'gemini', 'no-existe') }
end
def test_desactivada_o_reservada_no_se_da_y_proxima_responde
asignar('gemma', 'mente', 'gemini', 'g-off')
assert_nil R.disponible_en(P.refs('gemma', 'mente'))
assert_nil R.proxima_en(P.refs('gemma', 'mente'))
asignar('gemma', 'mente', 'gemini', 'g-01')
R.reservar(provider: 'gemini', identificador: 'g-01', individuo: 'gemma')
assert_nil R.disponible_en(P.refs('gemma', 'mente'))
assert_equal 'g-01', R.proxima_en(P.refs('gemma', 'mente'))['identificador']
end
def test_quitar_y_olvidar_no_dejan_refs_colgadas
asignar('gemma', 'mente', 'gemini', 'g-01')
asignar('peggy', 'red', 'gemini', 'g-01')
assert P.quitar(individuo: 'gemma', rol: 'mente', provider: 'gemini', identificador: 'g-01')
refute P.quitar(individuo: 'gemma', rol: 'mente', provider: 'gemini', identificador: 'g-01')
assert P.olvidar_key(provider: 'gemini', identificador: 'g-01')
assert_equal({ 'individuos' => {} }, P.leer)
assert_equal '600', format('%o', File.stat(P::STATE_FILE).mode & 0o777)
end
def test_pool_vacio_no_cae_al_provider
assert_nil R.disponible_en(P.refs('nadie', 'mente'))
assert P.pool_vacio?('nadie', 'mente')
assert_nil P.disponible('nadie', 'mente')
end
# --- Fase 5: selección por nombre (rol o provider) y estado
def test_nombre_rol_usa_el_pool_y_nombre_provider_sigue_igual
asignar('gemma', 'mente', 'deepseek', 'd-01')
assert_equal 'd-01', P.disponible('gemma', 'mente')['identificador']
assert_equal 'gemini', P.disponible('gemma', 'gemini')['provider'] # compatibilidad: por provider, sin pools
refute P.pool_vacio?('gemma', 'gemini')
refute P.rol?('gemini')
end
def test_estado_por_rol_trae_provider_motivo_y_quien
asignar('gemma', 'mente', 'gemini', 'g-01')
asignar('gemma', 'mente', 'deepseek', 'd-01')
R.reservar(provider: 'gemini', identificador: 'g-01', individuo: 'gemma')
R.reportar(provider: 'gemini', identificador: 'g-01', individuo: 'gemma', estado: 'agotada', motivo: 'cuota diaria')
filas = P.estado('gemma', 'mente').to_h { |f| [f['identificador'], f] }
assert_equal %w[d-01 g-01], filas.keys.sort
assert_equal %w[agotada gemini gemma cuota\ diaria],
filas['g-01'].values_at('estado', 'provider', 'agotada_por', 'motivo')
assert_equal 'disponible', filas['d-01']['estado']
assert_equal 'deepseek', P.disponible('gemma', 'mente')['provider']
end
def test_con_estado_para_la_web
asignar('gemma', 'red', 'gemini', 'g-red')
assert_equal ['g-red'], P.con_estado.dig('gemma', 'red').map { |f| f['identificador'] }
end
end