Repository navigation
Open
Labels
dificuldade:grandeUma semana ou mais; vale dividir em sub-issuesUma semana ou mais; vale dividir em sub-issuessensível:segurançaMexe em chaves, certificados ou superfície de ataque; revisão reforçadaMexe em chaves, certificados ou superfície de ataque; revisão reforçadatipo:funcionalidadeFuncionalidade novaFuncionalidade novaárea:protocoloProtocolo e núcleo do nó (packages/core)Protocolo e núcleo do nó (packages/core)área:rpcContrato JSON entre interface e nó (packages/rpc)Contrato JSON entre interface e nó (packages/rpc)
Milestone
Description
Contexto
Registros têm conjuntos exatos de chaves (campo novo vira malformed) e desde o #115 o main aceita certificados v1 e v2, mas um leitor anterior ao #115 só aceita v1 e responde malformed a um certificado v2. Leitores pulam registros inválidos sem renumerar, então tipos novos são ignorados por leitores antigos; falta a regra escrita, a versão mínima para recursos de segurança e a migração.
Já feito
Atualizado em 26/10/2026 a partir dos PRs mergeados até #120.
- feat: link Google accounts on the server, issue certificates automatically and add @usernames #115 criou o certificado de membro v2 (
ageBand: unchecked,method: google):validateCertShape,verifyCertecertForKeyaceitam v1 ou v2 e v1 não mudou (docs/protocol.md:191,docs/protocol.md:216-248,packages/core/lib/cert.js:227-245(construtor v2),packages/core/lib/cert.js:428-449). - feat: link Google accounts on the server, issue certificates automatically and add @usernames #115 e feat: photos and GIFs in posts, follows on every device, stay signed in and an end-user shell #119 documentaram que leitores antigos pulam registros de tipo desconhecido ou com chaves a mais sem rejeitar o diário e sem renumerar (
docs/protocol.md:123-126; tipos atuais empackages/core/lib/records.js:199); feat: photos and GIFs in posts, follows on every device, stay signed in and an end-user shell #119 testa, com o leitor atual, que o feed pula posts de mídia inválidos sem derrubar o diário (packages/web-member/test/e2e-media.test.js:431-460). Isso não é um teste com um leitor antigo. - feat: link Google accounts on the server, issue certificates automatically and add @usernames #115 documentou que nós de antes do v2 respondem
malformeda qualquer certificado v2 e precisam atualizar antes (docs/verification.md:789). - feat: link Google accounts on the server, issue certificates automatically and add @usernames #115 testou de ponta a ponta o certificado v2 (forma e leitura em
log.read), a admissão e a recuperação porsync, e um seguidor com certificado v1 que sincroniza o diário v2 (apps/cli/test/account-e2e.test.js:359,apps/cli/test/account-e2e.test.js:369-403,apps/cli/test/account-e2e.test.js:407-424). - feat: block accounts and revoke issuers through a signed blocklist enforced by every node #116 documentou a resposta a uma chave de emissor vazada e disse que a reemissão dos certificados antigos não está implementada (
docs/protocol.md:374).
Atualizado em 30/10/2026 a partir dos PRs mergeados até #222.
- feat: delete posts and profile versions with a signed tombstone #218 documentou a regra "leitor antigo pula o
delete": para apps, CLIs e semeadores de antes da exclusão,deleteé um tipo desconhecido, o bloco é pulado comomalformede o diário nunca é rejeitado por isso (docs/protocol.md:141). - feat: let members set a profile picture #201 gravou a foto de perfil num par de registros compatível com leitores antigos e documentou o efeito neles (
docs/protocol.md:138,docs/protocol.md:1238).
Atualizado em 05/11/2026 a partir dos PRs mergeados até #346.
- feat: add public groups #241: o
moderation.jsondo serviço de conta passa av: 2; apps e semeadores antigos tratamgroup-joincomo registro desconhecido e não veem os grupos. - feat: make communities contain their groups #293: grupos e comunidades passam ao protocolo v2, e os v1 são descartados dos semeadores e dos aparelhos, sem volta (protótipo).
- feat: show likes and reposts in avisos over notices/3 #314: os avisos de curtida e republicação entram num canal novo,
varanda/notices/3, ao lado de v1 e v2, porque emnotices/2um item de tipo desconhecido invalida a página inteira. - feat: add page diaries to the protocol and the member nodes #332: oito registros novos
page-*para as Páginas; umdeletenunca vale sobre eles. Leitores antigos não veem a mudança de chave nem o encerramento da página, emod blockcobre.
Falta
- Escrever a política por tipo de registro numa seção de versionamento do protocol.md; hoje a regra está espalhada (
docs/protocol.md:123-126, e agora também a dodeletee a do avatar). Incluir tambémgroup-join, os registrospage-*e omoderation.jsonv2 (feat: add public groups #241, feat: add page diaries to the protocol and the member nodes #332). - Recusa explícita: um leitor sem suporte a v2 hoje só diz
malformed(docs/verification.md:789); definir versão mínima e uma resposta própria. Odeletetambém não tem versão mínima: o leitor antigo só o pula. - Reemissão de certificados antigos depois de revogar um emissor, não implementada (
docs/protocol.md:374). Certificados v1 de identidades piloto seguem v1 mesmo após vincular a conta Google (docs/app.md:95). - Consolidar no protocol.md a regra de subir
VarandaWebNode.versionquando o nó do navegador mudar de forma incompatível: hoje ela está só no verification.md (docs/verification.md:721) e o app recusa uma versão diferente da esperada (apps/app/src/client/browser.js:33-35; versão empackages/web-member/web/node.js:594). - Migração recuperável dos dados locais: não existe; a volta do deploy não desfaz mudanças de formato (
README.md:535). - Matriz de compatibilidade com leitores antigos: há testes de certificado v2 em log e sync (feat: link Google accounts on the server, issue certificates automatically and add @usernames #115), mas nenhum roda um leitor anterior ao feat: link Google accounts on the server, issue certificates automatically and add @usernames #115 sobre um diário v2, nem um leitor anterior à exclusão sobre um diário com
delete, nem cobre a regra geral de registros desconhecidos em log e sync. A matriz também precisa cobrirgroup-joinepage-*com um leitor antigo. - Registrar como regra a decisão de feat: show likes and reposts in avisos over notices/3 #314: quando um tipo desconhecido invalidaria a resposta de um canal (como em
notices/2), o tipo novo entra num canal novo em vez de mudar o antigo.
Escopo
- Regra por tipo de registro: tipo ou campo desconhecido é pulado, nunca descarta o diário
- Versão mínima e negociação para certificado v2 e para a exclusão assinada
- Migração recuperável dos dados locais sem reescrever o bloco 0
- Testes de leitura v1 e v2 em feed, log e sync; seção de versionamento no protocol.md
Critérios de aceite
- Um leitor v1 pula um registro v2 e mantém o diário (parcial: o feed atual pula posts de mídia inválidos, feat: photos and GIFs in posts, follows on every device, stay signed in and an end-user shell #119; falta teste com um leitor antigo e a regra geral escrita; a regra para
deletee avatar está documentada em feat: delete posts and profile versions with a signed tombstone #218 e feat: let members set a profile picture #201) - Um leitor incompatível com o certificado v2 recebe recusa explícita (parcial: v2 hoje devolve
malformed, sem recusa explícita (feat: link Google accounts on the server, issue certificates automatically and add @usernames #115)) - Migração interrompida retoma sem perder identidade nem renumerar
Fontes
docs/protocol.md:92docs/protocol.md:96docs/protocol.md:622packages/core/lib/records.js:108packages/core/lib/cert.js:10-11packages/core/lib/cert.js:114docs/rpc.md:11docs/protocol.md:123-126docs/protocol.md:216-248docs/protocol.md:374packages/core/lib/records.js:199packages/web-member/test/e2e-media.test.js:431-460- PR Varanda-org/varanda#241
- PR Varanda-org/varanda#293
- PR Varanda-org/varanda#314
- PR Varanda-org/varanda#332
Fase: Fase 1 — Piloto 18+ · Dificuldade: grande · sensível à segurança
Metadata
Metadata
Assignees
Labels
dificuldade:grandeUma semana ou mais; vale dividir em sub-issuesUma semana ou mais; vale dividir em sub-issuessensível:segurançaMexe em chaves, certificados ou superfície de ataque; revisão reforçadaMexe em chaves, certificados ou superfície de ataque; revisão reforçadatipo:funcionalidadeFuncionalidade novaFuncionalidade novaárea:protocoloProtocolo e núcleo do nó (packages/core)Protocolo e núcleo do nó (packages/core)área:rpcContrato JSON entre interface e nó (packages/rpc)Contrato JSON entre interface e nó (packages/rpc)
Type
Projects
- StatusShow more project fieldsTodo
Activity
rodrigopavezi commentedon Oct 26, 2026
Atualizei a descrição: o que #115 e #119 entregaram está em Já feito; a política escrita, a recusa explícita, a migração e a reemissão de certificados estão em Falta.