Skip to content

feat: add the garden methods to the browser node - #725

Merged
rodrigopavezi merged 3 commits into
mainfrom
feat/varandinha-node
Nov 17, 2026
Merged

rodrigopavezi merged 3 commits into
mainfrom
feat/varandinha-node

Conversation

@rodrigopavezi

Copy link
Copy Markdown
Contributor

O que muda e por quê

Terceiro PR da Varandinha (fase 1), sobre feat/varandinha-index. Liga o jogo ao nó do navegador:

  • @varanda/rpc ganha garden.set, garden.state, garden.play e garden.help (docs/rpc.md 5.157 a 5.160). Nenhum recebe data nem texto livre: o nó escolhe cada data.
  • Nó do navegador: lê a própria varanda do próprio diário; entra e sai do jogo (sair apaga primeiro os garden-state e garden-help próprios e grava o garden desligado por último, então uma saída interrompida continua ligada); grava uma sessão de jogo como um só garden-state, com as regras de lib/garden.js; e só grava uma rega depois das checagens: não é a própria varanda, o jogo de quem rega está ligado, a pessoa não está bloqueada, quem rega segue o dono, uma rega por varanda por dia de Brasília, no máximo 5 por dia. Depois confere o garden e o garden-state do dono pelos ponteiros do semeador e uma espiada, e recusa (semeador indisponível) quando algo não confere. Nada é reenviado.
  • Nó do core: responde os quatro métodos com o mesmo USAGE das outras leituras sob demanda, sem escrever nada.

Limitações conhecidas (baixas):

  • Os limites diários (6 jogadas, 5 regas) moram nos registros da própria pessoa e usam o relógio dela. Sair e entrar de novo, ou uma saída que caiu depois de apagar os registros, zera as contagens do dia. Quem lê continua contando no máximo uma rega por vizinho por varanda por dia, então isso só mexe na própria varanda, que já é declarada pela pessoa.
  • garden.play aceita a colheita com o limite mais generoso de regas recebidas (3 por vaso), porque as regas ficam no diário dos vizinhos. Sem cesta nem pontuação, uma colheita adiantada não ganha nada.
  • garden.help repete o padrão de scrap.write: fechar a sessão durante a conferência no semeador (até 12 s) não cancela a escrita que vem depois.
  • O teste de ponta a ponta não cobre uma página como to (exige o serviço de conta). A checagem é a mesma de scrap.write.

Issue

Sem issue (parte da fase 1 da Varandinha).

Como verificar

  • npm test -w packages/rpc -- test/methods.test.js
  • npm test -w packages/core -- test/engagement-session.test.js
  • npm test -w packages/web-member -- test/garden.test.js test/garden-e2e.test.js (Node 20.19 ou mais novo)
  • Detalhes e resultados em docs/verification/feat-varandinha-node.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 (só verificação: sem tela, nada chega à pessoa usuária ainda)
  • Textos para o usuário estão em pt-BR (as recusas novas de docs/rpc.md 5.157 a 5.160)
  • 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 rpc contract gains garden.set, garden.state, garden.play and
garden.help (rpc.md 5.156 to 5.159). None takes a date or free text:
the node sets every date.

The browser node reads the own balcony from the own diary, joins and
leaves the game (leaving tombstones every own garden-state and
garden-help first and writes the off flag last, so a leave cut short
still reads as on), saves one play session as one garden-state through
the shared rules, and writes a help only after its own checks: not
self, own game on, the helper follows the owner, one help per balcony
per Brasilia day, at most 5 a day. It then reads the owner's flag and
state through the seeder pointers and one peek, and fails closed when
anything is unverified. Nothing is retried.

The core node answers the four methods with the same USAGE refusal as
the other on-demand reads.
Main took docs/rpc.md 5.156 for dm.historyCopy, so the garden sections
move to 5.157 to 5.160, with every reference (methods.js, the web
session and member-ops, the e2e test and the verification file). The
method pins and the writes-need-the-key list keep both sides.
@rodrigopavezi
rodrigopavezi requested a review from a team as a code owner November 17, 2026 07:11
Base automatically changed from feat/varandinha-index to main November 17, 2026 07:33
@rodrigopavezi
rodrigopavezi merged commit 14bf761 into main Nov 17, 2026
24 checks passed
@rodrigopavezi
rodrigopavezi deleted the feat/varandinha-node branch November 17, 2026 07:37
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