~/studies/work 2026-11-07 · published 2026-11-21
Por qué el motor durable queda detrás de un port
El registro de decisión del motor durable de nagare: dos motores detrás de una interfaz, las alternativas rechazadas, lo que costó la elección y lo que mostraron las primeras mediciones.
- adr
- architecture
- workflow
- dbos
- temporal
- ~/project/versatile-sh
La decisión
El 2026-11-07 el borrador de investigación WF-ADR-002 propuso que nagare alcance la durabilidad solo a través de una interfaz de Go, con un motor por defecto y un segundo mantenido como ciudadano de primera clase. El ADR del motor se aceptó el mismo día. Esto es lo que eligió, lo que rechazó y lo que costó.
- El intérprete habla con un contexto durable con los hooks Step, Sleep, WaitFor, Child, Now, NewID y continue-as-new. El servidor habla con un motor con Start, Signal, Cancel y similares.
- DBOS Transact es el valor por defecto: una librería de Go sobre el mismo Postgres, de modo que v1 es un binario más Postgres.
- Temporal es de primera clase desde la primera versión, mantenido en verde por una suite de tests diferencial. El borrador fija un disparador para pasar producción a él: carga sostenida por encima de 2,000 transiciones por segundo por cluster, multi-región active-active, o un contrato que lo exija.
- Un motor en memoria respalda los tests unitarios y las ejecuciones en seco.
Alternativas que perdieron
| Opción | Por qué no |
|---|---|
| Núcleo en TypeScript sobre los SDK de TS | el dueño eligió Go, y los SDK de Go cubren las mismas primitivas |
| Temporal como valor por defecto | cuatro servicios extra y una segunda base de datos en cada instalación desde el primer día |
| Hatchet | proceso de motor separado; la historia de versionado sin verificar |
| Un motor propio | reimplementa recuperación, colas, schedules y fork con menos pruebas |
La investigación también descartó varios productos por sus términos de licencia para un producto vendido como servicio. Eso es una verificación legal de ajuste hecha sobre las fuentes fechadas en las notas, no un juicio de calidad.
Qué cuesta
Hay que mantener dos adaptadores desde el comienzo, y el mínimo común denominador se filtra. El ADR aceptado registra dos consecuencias que el borrador no tenía.
- Una closure no puede ser una activity de Temporal, ya que las activities son funciones registradas con argumentos serializables. Por eso los pasos pasaron a ser comandos con nombre: Step(key, op, args), con handlers en un registro compartido por todos los motores.
- El retry nativo del motor está apagado en todos lados. El intérprete es dueño de la semántica de retry, timeouts y cancelación (ADR-0003), así que cada intento de retry es su propio paso. Eso significa más pasos por nodo reintentado, lo que el ADR acepta por paridad.
La paridad misma necesita prueba. Una suite diferencial ejecuta cada caso en cada motor y compara eventos normalizados más un ledger de efectos secundarios con una fila por clave de idempotencia. Sus 26 escenarios numerados cubren flujo de control, reintentos, callbacks asíncronos, crash y recuperación, límites e inicio idempotente, además de historiales de Temporal grabados y reproducidos contra el intérprete actual. Por decisión no hay CI: quien cambia el núcleo, los ports o un motor corre la suite localmente antes de mergear, y nada lo obliga.
Lo que el port abarató y volvió visible después
Tener un port hizo posible un tercer motor sin tocar el intérprete: un journal remoto detrás de un plugin, aceptado el 2026-11-13. Una función de control de ejecuciones tuvo entonces un costo medido en cada motor. La lectura del inbox de control de ejecuciones se midió en la máquina de desarrollo el 2026-11-13: 30 workflows de 10 llamadas stub secuenciales, comparados con y sin la lectura.
| Motor | p99 por ejecución, sin y con | Agregado por llamada (p99) | Pérdida de throughput |
|---|---|---|---|
| memory | 1.06 ms to 1.50 ms | 0.04 ms | 3.4% |
| DBOS | 1.0037 s to 1.0037 s | < 0.01 ms | 0.0% |
| Temporal | 2.355 s to 2.353 s | none | 0.0% |
| remote journal | 42.7 ms to 35.7 ms | none | -3.0% |
La misma tabla muestra lo que la abstracción esconde: una ejecución en DBOS toma cerca de un segundo para diez llamadas stub. Las notas lo atribuyen a su polling de cola, que también esconde el costo de la lectura. El port da el mismo comportamiento. No da la misma latencia.
El criterio de aceptación del borrador era un soak con 100 kill -9 durante ejecuciones, 0 ejecuciones perdidas, 0 efectos secundarios duplicados. No encontré un registro de ese soak en los archivos que leí, así que no afirmo que se haya ejecutado.