Skip to content

feat: index varandinha pointers on the seeder - #724

Merged
rodrigopavezi merged 4 commits into
mainfrom
feat/varandinha-index
Nov 17, 2026
Merged

rodrigopavezi merged 4 commits into
mainfrom
feat/varandinha-index

Conversation

@rodrigopavezi

Copy link
Copy Markdown
Contributor

O que muda e por quê

Segundo PR da Varandinha (fase 1), sobre feat/varandinha-records. O semeador passa a indexar os registros garden, garden-state e garden-help e responde duas rotas novas:

  • GET /index/garden/<dono>: os ponteiros da varanda (último garden e garden-state), as regas de quem segue o dono dentro da janela de 72 h, uma por vizinho por dia de Brasília, no máximo 4 por vaso e 24 no total, e as regas que o próprio dono deu. Varanda desligada ou nunca aberta não responde regas.
  • GET /index/garden/<dono>/rua[/<chave>] (Varandas da rua): as varandas abertas de quem o dono segue, 20 por página, sem nunca citar uma chave que o índice de seguidos esconde.
  • /index/profile/<autor> ganha garden (seq ou null).

O índice guarda só chaves, seqs, a data e o vaso de cada rega. O nó lê e confere cada bloco. Tetos por par, por escritor e por dono, com o relógio do semeador para liberar lugares de linhas que não podem mais ser listadas; uma rega recusada que ainda poderia ser listada deixa a resposta com complete: false. A resposta também diz complete: false enquanto o índice de seguidos do dono está incompleto.

Limitações conhecidas (baixas, deixadas para depois):

  • Contas que não seguem o dono podem ocupar os 512 lugares de escritores de uma varanda com regas recentes. A resposta passa a dizer complete: false, mas regas novas ficam de fora enquanto a janela delas durar. Exige 512 contas admitidas.
  • Dentro de um vaso, cada escritor entra antes do segundo dia de outro. Três contas seguidoras com regas datadas antes do plantio, que o leitor não conta, podem tirar da lista até 2 regas de outros dias de um vizinho honesto naquele vaso.
  • No fim da rua, o cursor next pode vir preenchido quando só restam chaves escondidas depois dele, o que indica que o dono segue ao menos uma conta que o índice de seguidos omite (sem dizer qual).
  • Uma rega datada mais de 24 h à frente do relógio do semeador que chega num teto é descartada sem marcar a varanda como cheia. Só um cliente modificado data regas no futuro.
  • given traz as 24 regas próprias mais novas; com mais de 24 na janela (o nó honesto chega no máximo a 20), o bônus de regas dadas pode mudar. Só afeta a própria varanda, que já é declarada pela pessoa.

Issue

Sem issue (parte da fase 1 da Varandinha).

Como verificar

  • npm test -w packages/core -- test/garden-index.test.js test/profile-extra-index.test.js test/engagement.test.js
  • npm test -w apps/cli -- test/seeder-index.test.js test/seed-ws.test.js
  • Detalhes e resultados em docs/verification/feat-varandinha-index.md.
  • A CI completa (lint, testes, demo) rodou neste ramo antes da sincronização com a main; depois dela, rodou no topo da pilha (feat/varandinha-app), que contém este ramo. A CI do GitHub roda neste PR.

Checklist

  • npm run lint, npm test (ou npm test -- --affected=origin/main) e npm run demo passam
  • docs/protocol.md ou docs/rpc.md atualizados, se um formato mudou
  • Entrada do changelog em docs/changelog/<branch>.md e verificação em docs/verification/<branch>.md, se houver, sem editar o CHANGELOG.md nem acrescentar seção ao docs/verification.md
  • Textos para o usuário estão em pt-BR (só as respostas do semeador; nenhum texto novo para o usuário)
  • Conferido no Android (emulador ou aparelho) e no simulador iOS antes da web/PWA, ou explicado por que não se aplica (não se aplica: sem mudança no app)
  • Nenhum segredo, chave ou dado pessoal no diff

The engagement index keeps pointers to the garden, garden-state and
garden-help blocks: the newest flag and state per owner, and the helps
addressed to an owner with their date and pot, capped per writer and
owner pair, per writer and per owner. With the seeder's clock, a writer
whose rows can no longer be listed gives its place to a new one, and a
refused help that could still be listed marks the balcony incomplete.

garden() lists helps only from writers who follow the owner, one per
writer per Brasilia day, at most 4 per pot, rows dated ahead of the
clock last, and answers nothing for a balcony that is off. gardenStreet()
pages the owner's visible follow targets whose balcony is on, and its
cursor is always a visible key.

The seeder answers GET /index/garden/<owner> and /rua[/<key>], adds
garden to the profile index, and reports complete false while the
follow index is incomplete for the owner. Protocol section 5 and 7
describe the index and the routes.
@rodrigopavezi
rodrigopavezi requested a review from a team as a code owner November 17, 2026 07:10
Base automatically changed from feat/varandinha-records to main November 17, 2026 07:33
@rodrigopavezi
rodrigopavezi merged commit 84685f4 into main Nov 17, 2026
24 checks passed
@rodrigopavezi
rodrigopavezi deleted the feat/varandinha-index branch November 17, 2026 07:33
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