~/daily/work 2026-11-13 · published 2026-11-21
hakoniwa, 2026-11-13: plugins y executors
Un devlog de un día en la historia del engine de tests: adopción del plugin kit compartido, enrutamiento de leases por runner, un executor port, archivado de evidencia por eventos y un executor de referencia ejecutado en k6 real.
- hakoniwa
- plugins
- devlog
- k6
- ~/project/versatile-sh
El día en un párrafo
Después del día 9, la historia de hakoniwa está tranquila: 3 commits sin merge el día 10, ninguno el 11 ni el 12, y luego 38 commits sin merge el 13. Casi todos son de un mismo tema. El engine deja de ser lo único que puede ejecutar un test y aprende a entregar un intento a otro.
Secuencia
- 1Adoptar el plugin kitEl primer commit del día adopta el plugin kit compartido: plugin ports, suites de conformance, un archivo de adapters, discovery y una CLI conform. Una segunda tanda añadió helpers de env, claves de config integradas y una marca de embedded para los ports. El kit se actualizó tres veces durante el día a medida que llegaban sus propias correcciones.
- 2Catálogo de eventos y webhooksEl engine sirve su catálogo de eventos y entrega su outbox mediante un sink Standard Webhooks. Lo entrante pasó a la misma forma en inbox v2: CloudEvents de Standard Webhooks, listas de aceptación, ordering keys y resultados de intento bajo un grant.
- 3Enrutar por runner, registrar la confianzaLos leases se enrutan por los runners que declara un worker, y cada ejecución registra una clase de confianza. Commits posteriores hicieron visible la inanición, acotaron las declaraciones de runner y cancelaron las ejecuciones en cola que ningún executor puede ejecutar.
- 4Ingerir resultados reportadosUn reporte de resultados puede convertirse en una ejecución terminada de confianza reported. La evidencia queda ligada al principal que la ingirió, y en producción los resultados reportados quedan detrás de un archivo de adapters revisado y reconocido.
- 5Control y API en vivoUn log público de eventos de ejecución, retryRun, watchRun, watchControl y listExecutors, con SDKs regenerados.
- 6Executor port y protocolo de intentoUn binding de plugin del protocolo de intento, juzgado por intento según el conjunto de capacidades del titular y no la unión de todos los titulares. Luego un binding de eventos en su propia ruta, con grants emitidos en la entrega.
- 7Un executor de referencia en k6 realUn executor k6 y un dialecto k6, con un test de aceptación sobre cuatro bindings. Los ejemplos se ejecutaron después en k6 real, sobre gRPC, incluido el camino de stop.
Dos detalles que vale la pena conservar
Conjuntos de capacidades por intento. Un commit titulado Judge each attempt by the holder's capability set, not the union cambió la regla: un intento se comprueba contra el executor que lo ejecutaría, y no contra todo lo que todos los executors conectados pueden hacer juntos. La unión es incorrecta cuando ningún executor individual tiene el conjunto completo.
Solicitudes obsoletas. Varios commits tratan del mismo riesgo: una solicitud de intento que llega después de que el intento siguió adelante. Las correcciones juzgan el accept en la llegada, no emiten grant para un intento obsoleto, cuentan y registran esas solicitudes, y hacen idempotente un accept repetido. Una versión ausente nunca se considera obsoleta.
El mismo día, en la puerta de al lado
El commit que añade el tier de store embebido y el ADR mapeado del store con forma de comando es consecuencia de un estudio de latencia ejecutado ese día. El estudio encontró que poner una transacción de base de datos detrás de una sesión de plugin no pasa un gate de latencia. Es el tema de otro post, A plugin hop that did not pay for itself.