~/studies/work 2026-11-07 · published 2026-11-21

Por que o motor durável fica atrás de um port

O registro de decisão do motor durável do nagare: dois motores atrás de uma interface, as alternativas rejeitadas, o que a escolha custou e o que as primeiras medições mostraram.

A decisão

Em 2026-11-07 o rascunho de pesquisa WF-ADR-002 propôs que o nagare alcance a durabilidade só por meio de uma interface Go, com um motor como padrão e um segundo mantido como cidadão de primeira classe. O ADR do motor foi aceito no mesmo dia. Isto é o que ele escolheu, o que recusou e o que custou.

  • O interpretador fala com um contexto durável com os hooks Step, Sleep, WaitFor, Child, Now, NewID e continue-as-new. O servidor fala com um motor com Start, Signal, Cancel e semelhantes.
  • DBOS Transact é o padrão: uma biblioteca Go sobre o mesmo Postgres, então a v1 é um binário mais Postgres.
  • Temporal é de primeira classe desde a primeira versão, mantido verde por uma suite de testes diferencial. O rascunho define um gatilho para mover a produção para ele: carga sustentada acima de 2,000 transições por segundo por cluster, multi-região active-active, ou um contrato que o exija.
  • Um motor em memória sustenta os testes unitários e as execuções a seco.

Alternativas que perderam

OpçãoPor que não
Núcleo em TypeScript sobre os SDKs de TSo dono escolheu Go, e os SDKs de Go cobrem as mesmas primitivas
Temporal como padrãoquatro serviços extras e um segundo banco de dados em toda instalação desde o primeiro dia
Hatchetprocesso de motor separado; história de versionamento não verificada
Um motor próprioreimplementa recuperação, filas, schedules e fork com menos testes

A pesquisa também descartou vários produtos pelos termos de licença para um produto vendido como serviço. Isso é uma checagem legal de adequação feita sobre as fontes datadas nas notas, não um julgamento de qualidade.

O que custa

Dois adaptadores precisam ser mantidos desde o começo, e o menor denominador comum vaza. O ADR aceito registra duas consequências que o rascunho não tinha.

  • Uma closure não pode ser uma activity do Temporal, já que activities são funções registradas com argumentos serializáveis. Por isso os passos viraram comandos nomeados: Step(key, op, args), com handlers em um registro compartilhado por todos os motores.
  • O retry nativo do motor está desligado em todo lugar. O interpretador é dono da semântica de retry, timeouts e cancelamento (ADR-0003), então cada tentativa de retry é seu próprio passo. Isso significa mais passos por nó repetido, o que o ADR aceita em nome da paridade.

A paridade em si precisa de prova. Uma suite diferencial roda cada caso em cada motor e compara eventos normalizados mais um ledger de efeitos colaterais com uma linha por chave de idempotência. Seus 26 cenários numerados cobrem fluxo de controle, tentativas, callbacks assíncronos, crash e recuperação, limites e início idempotente, além de históricos do Temporal gravados e reproduzidos contra o interpretador atual. Por decisão não há CI: quem muda o núcleo, os ports ou um motor roda a suite localmente antes de mergear, e nada obriga isso.

O que o port depois tornou barato e visível

Ter um port tornou possível um terceiro motor sem tocar no interpretador: um journal remoto atrás de um plugin, aceito em 2026-11-13. Uma funcionalidade de controle de execuções passou então a ter um custo medido em cada motor. A leitura do inbox de controle de execuções foi medida na máquina de desenvolvimento em 2026-11-13: 30 workflows de 10 chamadas stub sequenciais, comparados com e sem a leitura.

Motorp99 por execução, sem e comAcrescentado por chamada (p99)Perda de throughput
memory1.06 ms to 1.50 ms0.04 ms3.4%
DBOS1.0037 s to 1.0037 s< 0.01 ms0.0%
Temporal2.355 s to 2.353 snone0.0%
remote journal42.7 ms to 35.7 msnone-3.0%

A mesma tabela mostra o que a abstração esconde: uma execução no DBOS leva cerca de um segundo para dez chamadas stub. As notas atribuem isso ao polling de fila, que também esconde o custo da leitura. O port dá o mesmo comportamento. Não dá a mesma latência.

O critério de aceitação do rascunho era um soak com 100 kill -9 durante execuções, 0 execuções perdidas, 0 efeitos colaterais duplicados. Não encontrei registro desse soak nos arquivos que li, então não afirmo que foi executado.