~/daily/work 2026-11-13 · published 2026-11-21
hakoniwa, 2026-11-13: plugins e executors
Um devlog de um dia na história do engine de testes: adoção do plugin kit compartilhado, roteamento de leases por runner, um executor port, arquivamento de evidência por eventos e um executor de referência rodando em k6 real.
- hakoniwa
- plugins
- devlog
- k6
- ~/project/versatile-sh
O dia em um parágrafo
Depois do dia 9, o histórico do hakoniwa fica quieto: 3 commits sem merge no dia 10, nenhum no 11 nem no 12, e depois 38 commits sem merge no dia 13. Quase todos de um mesmo tema. O engine deixa de ser a única coisa que pode rodar um teste e aprende a entregar uma tentativa para outro.
Sequência
- 1Adotar o plugin kitO primeiro commit do dia adota o plugin kit compartilhado: plugin ports, suítes de conformance, um arquivo de adapters, discovery e uma CLI conform. Uma segunda leva adicionou helpers de env, chaves de config embutidas e uma marcação de embedded para os ports. O kit foi atualizado três vezes durante o dia conforme suas próprias correções entravam.
- 2Catálogo de eventos e webhooksO engine serve seu catálogo de eventos e entrega seu outbox por um sink Standard Webhooks. O que entra passou para o mesmo formato no inbox v2: CloudEvents do Standard Webhooks, listas de aceitação, ordering keys e resultados de tentativa sob um grant.
- 3Rotear por runner, registrar a confiançaOs leases são roteados pelos runners que um worker declara, e cada execução registra uma classe de confiança. Commits posteriores tornaram a starvation visível, limitaram as declarações de runner e cancelaram execuções na fila que nenhum executor consegue rodar.
- 4Ingerir resultados reportadosUm relatório de resultados pode virar uma execução finalizada de confiança reported. A evidência fica atrelada ao principal que a ingeriu, e em produção os resultados reportados ficam atrás de um arquivo de adapters revisado e reconhecido.
- 5Controle e API ao vivoUm log público de eventos de execução, retryRun, watchRun, watchControl e listExecutors, com SDKs regenerados.
- 6Executor port e protocolo de tentativaUm binding de plugin do protocolo de tentativa, julgado por tentativa pelo conjunto de capacidades do titular e não pela união de todos os titulares. Depois um binding de eventos em rota própria, com grants emitidos na entrega.
- 7Um executor de referência em k6 realUm executor k6 e um dialeto k6, com um teste de aceitação sobre quatro bindings. Os exemplos foram então rodados em k6 real, sobre gRPC, incluindo o caminho de stop.
Dois detalhes que valem guardar
Conjuntos de capacidades por tentativa. Um commit intitulado Judge each attempt by the holder's capability set, not the union mudou a regra: uma tentativa é verificada contra o executor que a rodaria, e não contra tudo que todos os executors conectados conseguem fazer juntos. A união está errada quando nenhum executor sozinho tem o conjunto inteiro.
Requisições obsoletas. Vários commits tratam do mesmo risco: uma requisição de tentativa que chega depois que a tentativa já avançou. As correções julgam o accept na chegada, não emitem grant para uma tentativa obsoleta, contam e registram essas requisições, e tornam idempotente um accept repetido. Uma versão ausente nunca é considerada obsoleta.
No mesmo dia, ao lado
O commit que adiciona o tier de store embutido e o ADR mapeado do store em formato de comando é consequência de um estudo de latência rodado naquele dia. O estudo descobriu que colocar uma transação de banco de dados atrás de uma sessão de plugin reprova em um gate de latência. É o assunto de outro post, A plugin hop that did not pay for itself.