~/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.
- adr
- architecture
- workflow
- dbos
- temporal
- ~/project/versatile-sh
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ção | Por que não |
|---|---|
| Núcleo em TypeScript sobre os SDKs de TS | o dono escolheu Go, e os SDKs de Go cobrem as mesmas primitivas |
| Temporal como padrão | quatro serviços extras e um segundo banco de dados em toda instalação desde o primeiro dia |
| Hatchet | processo de motor separado; história de versionamento não verificada |
| Um motor próprio | reimplementa 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.
| Motor | p99 por execução, sem e com | Acrescentado por chamada (p99) | Perda 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% |
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.