Skip to content

feat: add varandinha garden rules and record types - #723

Merged
rodrigopavezi merged 5 commits into
mainfrom
feat/varandinha-records
Nov 17, 2026
Merged

rodrigopavezi merged 5 commits into
mainfrom
feat/varandinha-records

Conversation

@rodrigopavezi

Copy link
Copy Markdown
Contributor

O que muda e por quê

Primeiro de cinco PRs da Varandinha (fase 1). O jogo é opcional:

  • cada pessoa que entra ganha uma varanda com seis vasos;
  • planta, rega e colhe, e as plantas crescem em horas reais, no relógio de quem olha;
  • pode regar uma vez por dia a varanda de quem ela segue, e o dono vê quem regou.

Não há dinheiro, compra, pontuação, ranking, prêmio nem texto livre. Tudo fica no diário assinado de cada pessoa.

Este PR traz só as regras e os registros, sem rota, sem nó e sem tela:

  • @varanda/rpc ganha lib/garden.js, as regras puras do jogo:

    • seis plantas e seis vasos;
    • o crescimento, com bônus por rega própria, por rega recebida e por rega dada;
    • o redutor das jogadas de uma sessão e a dobra das regas recebidas e dadas;
    • a dobra da varanda e as checagens de quem escreve: uma rega por vizinho por dia de Brasília, no máximo 5 por dia, e só de quem segue o dono.

    Nada lança exceção, e cada valor é lido uma vez da própria propriedade. O nó, o semeador e o app usam este mesmo módulo nos próximos PRs.

  • packages/core/lib/records.js ganha três tipos de registro, com construtores e códigos de recusa:

    • garden (entrou ou saiu) e garden-state (os seis vasos), os dois "o mais recente vale";
    • garden-help, uma rega no diário de quem rega, endereçada ao dono.

    Leitores antigos pulam os três como malformados, sem recusar o diário.

  • docs/protocol.md §2 descreve os registros, as regras e o que fica de fora. docs/rpc.md §12 cita o módulo.

A ordem da pilha:

  1. este PR;
  2. feat/varandinha-index (índice do semeador);
  3. feat/varandinha-node (métodos RPC e nó do navegador);
  4. feat/varandinha-model (modelo do app e Vitrine);
  5. feat/varandinha-app (telas e Termos 77).

Limites, escritos também em docs/protocol.md:

  • O estado do jogo é declarado pelo próprio dono. Qualquer pessoa pode forjar a própria varanda, por isso nada no jogo ranqueia nem premia.
  • Quem rega pode antedatar a rega dentro dos dias que um plantio dura.
  • Um follow já substituído parece vivo numa espiada só.
  • Um cliente modificado pode gravar o que o nó honesto recusa. Quem lê descarta o que não passa nas regras.

Issue

Sem issue (fase 1 da Varandinha).

Como verificar

  • npm test -w packages/rpc -- test/garden.test.js
  • npm test -w packages/core -- test/records.test.js test/garden.test.js
  • Detalhes em docs/verification/feat-varandinha-records.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: nada aqui chega à pessoa usuária ainda)
  • Textos para o usuário estão em pt-BR (este PR não tem texto 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

Pure rules for the Varandinha game in @varanda/rpc (lib/garden.js):
pots, plants, growth on the reader clock, the play reducer, the help
and given folds, the balcony fold and the writer checks. Nothing
throws and every value is read once from its own data property.

Three record types in core records, with builders and reason codes:
garden and garden-state (latest-wins) and garden-help (a watering in
the helper's diary, addressed to the owner). Old readers skip them as
malformed. Protocol section 2 describes the records and the rules.
Main added the device record type. Both sides keep their record types,
with device before the three garden types in TYPES and its pin, and the
rpc.md re-export list keeps garden and the devices.changed event.
@rodrigopavezi
rodrigopavezi requested a review from a team as a code owner November 17, 2026 07:10
@rodrigopavezi
rodrigopavezi merged commit 87465f0 into main Nov 17, 2026
24 checks passed
@rodrigopavezi
rodrigopavezi deleted the feat/varandinha-records 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