Skip to content

fix: refuse recovery store writes without the lock and prune idle tombstones - #741

Open
rodrigopavezi wants to merge 1 commit into
mainfrom
fix/recovery-store-lock-fence
Open

rodrigopavezi wants to merge 1 commit into
mainfrom
fix/recovery-store-lock-fence

Conversation

@rodrigopavezi

Copy link
Copy Markdown
Contributor

O que muda e por quê

Dois ajustes no recovery.json (passkeys extras e código de recuperação), depois do #735:

  • Um processo que perdeu a trava do diretório não grava mais o arquivo. A gravação pergunta à trava de novo logo antes de trocar o arquivo, depois de escrever e sincronizar o temporário. Para este arquivo, a trava só conta como do processo enquanto tem o token dele e o horário de modificação tem menos de 20 s (a janela de 30 s menos um heartbeat de 10 s), porque um processo cujo heartbeat atrasou pode estar sendo substituído. Antes, um processo parado no meio da gravação por mais de 30 s ainda trocava o arquivo ao voltar: apagava do disco o que o novo serviço já tinha confirmado, ou deixava gravado um pedido que ele próprio respondeu como indisponível. Agora o arquivo e a memória ficam como estavam e o pedido responde 503.
  • A remoção de 30 dias vale também sem novas gravações. As marcas de remoção só eram descartadas quando alguém gravava. O heal(), que já roda a cada 10 s, agora descarta as que passaram de 30 dias e grava o arquivo.

Sem mudança de formato nem de rota. O texto dos Termos e da Política não muda: a Política já fala em 30 dias.

Issue

Parte da #444.

Como verificar

  • node apps/cli/test/recovery-store.test.js
  • node apps/cli/test/account.test.js
  • node apps/cli/test/account-recovery.test.js
  • node packages/core/test/store.test.js
  • Detalhes, com os testes que falham sem a correção, em docs/verification/fix-recovery-store-lock-fence.md.

Na rodada local de npm test -- --affected=origin/main (855 arquivos), dois arquivos estouraram o tempo, nenhum deles ligado ao que mudou: apps/cli/test/update.test.js passou sozinho (73/73 testes, 1901/1901 asserções); em packages/core/test/private-member-3.test.js, "fake bans from an unadmitted writer never inflate a rotation" passou dos 30 s, também sozinho e também numa árvore da main sem esta mudança (a CI da main em 0f7cadc passou).

Checklist

  • npm run lint e npm run demo passam; npm test -- --affected=origin/main passa, salvo dois estouros de tempo descritos acima
  • docs/protocol.md atualizado (regra da trava e da remoção no recovery.json)
  • Entrada do changelog em docs/changelog/fix-recovery-store-lock-fence.md e verificação em docs/verification/fix-recovery-store-lock-fence.md, sem editar o CHANGELOG.md nem acrescentar seção ao docs/verification.md
  • Textos para o usuário estão em pt-BR
  • Conferência no Android e no iOS não se aplica: a mudança é só no serviço de conta
  • Nenhum segredo, chave ou dado pessoal no diff

…bstones

The recovery store now asks the service lock again right before the
rename, after the temporary file is written and synced, so a process that
no longer holds the store lock leaves recovery.json and its memory as they
were. For this store the lock counts as held only while it carries this
process's token and its mtime is younger than the stale window minus one
heartbeat (20 s), since a holder whose heartbeat fell behind may be in the
middle of a takeover.

heal() also runs the 30-day tombstone removal when memory holds an
expired tombstone, so the removal holds on a store that gets no writes.

Part of #444
@rodrigopavezi
rodrigopavezi requested a review from a team as a code owner November 17, 2026 12:48

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant