Um runtime puro em Python para resiliência operacional, governança térmica e proteção financeira de frotas distribuídas de agentes, entregando promoção de hot-standby em menos de 5 segundos, histerese térmica discreta, validação de afinidade de proxy em 3 níveis e circuit breaker em janela deslizante sobre portas hexagonais.
Enxames autônomos de longa duração operando sobre superfícies externas hostis colapsam quando a mortalidade de workers, o calor de rate-limit, o desvio de proxy ou tempestades de provisionamento não são contidos. O Swarm Self-Healing impõe quatro garantias determinísticas:
Elimina interrupções de vários minutos quando um agente ativo cai ou sofre banimento, mantendo um pool aquecido de Scouts em STANDBY_READY e promovendo substitutos em menos de 5 segundos.
Previne a queima irreversível de identidades através de um escore térmico limitado em [0.0, 1.0] com deltas discretos de fricção e histerese que move preventivamente agentes estressados para COOLING_DOWN em 0.78.
Bloqueia contaminação cruzada entre contas e desvios de DHCP residencial por meio de validação de afinidade de rede em 3 níveis, incluindo correspondência exata, sub-rede por ASN ou rejeição estrita antes de qualquer disparo externo.
Interrompe o dreno financeiro descontrolado de chips SIM/eSIM e proxies durante quedas sistêmicas do alvo através de um ResourceCircuitBreaker em janela deslizante que trava gastos da incubadora até revisão explícita.
Formalizados na especificação SSH-SPEC-0001 e implementados em Python 3.11+ puro sem acoplamento de I/O, com Pydantic v2 e portas hexagonais typing.Protocol.
Monitora o pool ativo em relação a target_active_count. Quando um Scout é rebaixado para BANNED ou COOLING_DOWN, o controlador promove imediatamente um agente STANDBY_READY e reabastece a reserva em background.
Contabiliza a fricção operacional discreta, como normal_turn +0.06, TurnTimeout +0.18, CaptchaOrBlock +0.35 e BanDetected → 1.0, além do resfriamento passivo de -0.08/min, impondo uma banda morta de histerese 0.35..0.78 contra oscilações de estado.
Impõe vínculo estrito 1:1 entre identidade e proxy enquanto tolera renovações legítimas de DHCP residencial dentro do mesmo ASN e prefixo /24 IPv4 ou /48 IPv6, lançando ProxyAffinityViolationError em saltos anômalos.
Rastreia falhas de banimento e provisionamento em uma janela deslizante de 600 segundos. Ao atingir 5 falhas, desarma o disjuntor para OPEN, bloqueando novos gastos automatizados até inspeção humana e chamada explícita de unlock.
Projetado como um núcleo standalone sem acoplamento de I/O que se conecta a qualquer orquestrador, ledger ou provedor de nuvem através de dois protocolos estruturais.
Zero drivers de banco ou clientes HTTP acoplados. Persistência de estado e ciclo de vida de infraestrutura são injetados estritamente via SwarmLedgerPort e ScoutProvisionerPort.
A promoção de hot standby sempre executa antes de novos provisionamentos a frio, garantindo continuidade da missão mesmo se a incubadora externa estiver degradada.
Saturação linear por partes garante heat_score ∈ [0.0, 1.0] sob rajadas arbitrárias de eventos, enquanto limiares duplos entre 0.35 e 0.78 impedem oscilações.
Distingue rotações benignas de IP do provedor dentro da mesma sub-rede /24 e ASN de sequestros reais de proxy, atualizando registros sem derrubar sessões ativas.
Validado por uma suíte pytest isolada comprovando promoção de failover em menos de 5 segundos, saturação com histerese, checagem de sub-rede em 3 níveis e bloqueio de tempestades de spawn.
A especificação formal SSH-SPEC-0001 completa, as definições de portas hexagonais e o pacote Python de referência com suíte de verificação pytest estão disponíveis sob licença permissiva MIT na organização hsnlabs.
