Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions .github/pullfrog/review.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
Revise o diff do PR como revisor de código. Leia AGENTS.md e os contratos/ADRs
afetados. Responda em português do Brasil, preservando nomes de código e comandos.

Priorize achados reproduzíveis nas linhas alteradas, com impacto, condição que
dispara o problema e correção sugerida. Confira especialmente:

- Leitores e exportadores: ordem, proveniência, omissões, limites, privacidade e
exportação básica sem chamada a modelo, mesmo com a origem indisponível.
- Pacotes e Git: hashes, caminhos seguros, base/checkout exatos, alterações locais
explícitas e ausência de publicação implícita de código.
- Workspace/TUI/PTY: permissões negadas por padrão em falhas, isolamento de
projeto/perfil, interrupção, retomada e restauração do terminal.
- Testes e documentação: casos de falha relevantes; distinguir fixture sintética,
ensaio humano e prova com agente real. Não tratar teste automatizado como
validação manual ou funcionalidade planejada como entregue.

Evite sugestões de estilo, refatorações fora do escopo e riscos hipotéticos sem
um caminho concreto de falha. Se não houver achados acionáveis, diga isso.
17 changes: 17 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,23 @@ mantenedor, podem ocorrer depois sem impedir implementações testadas automatic

O corpo deve conter problema e resultado, escopo, validação, revisão e limitações relevantes. Preferir uma explicação curta e concreta. Manter título e descrição atualizados com a implementação final.

### Revisão automática com Pullfrog

O Pullfrog revisa PRs novos e novos commits. O texto versionado em
[`.github/pullfrog/review.md`](.github/pullfrog/review.md) é a cópia versionada das
instruções de `prompts.review`. O workflow não lê esse arquivo automaticamente.
Após alterá-lo e integrar o PR, sincronizar a configuração externa com:

```sh
npx --yes pullfrog@latest config set prompts.review --file .github/pullfrog/review.md --repo lippdev/memory-bee
npx --yes pullfrog@latest config get prompts.review --repo lippdev/memory-bee
```

O Pullfrog é uma revisão automatizada; seu parecer não substitui autorrevisão,
testes, ensaios humanos nem aprovação independente. O workflow gerado em
`.github/workflows/pullfrog.yml` é administrado pelo serviço; ajustar as
instruções pela configuração acima, sem editar os gatilhos no YAML.

## Dados e exportações

Não versionar conversas reais, credenciais ou pacotes de usuários. Usar fixtures sintéticas. Exportações devem ficar fora do repositório ou em `exports/`, ignorado pelo Git. Uma exportação de contexto não autoriza commit, push ou publicação do código do usuário.
Expand Down
21 changes: 21 additions & 0 deletions docs/EXECUTION.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,27 @@
- Próximo recorte de implementação: #29, seguido da prova de permissões #30;
os ensaios P0 #25–#26 podem avançar em paralelo quando o mantenedor os fizer.

## Revisão automática de PRs — 2026-09-25

- Pullfrog já estava ativo para PRs novos e novos commits; configuração inicial
tinha `prompts.review` vazio, aprovação automática e auto-merge desligados.
- Instruções específicas de revisão foram versionadas em
[`.github/pullfrog/review.md`](../.github/pullfrog/review.md). O procedimento
de sincronização está no [guia de contribuição](../CONTRIBUTING.md), e o
ensaio humano permanece pendente no item 53 do [roteiro](MANUAL_TESTS.md).
- `npx --yes pullfrog@latest config set prompts.review --file
.github/pullfrog/review.md --repo lippdev/memory-bee` retornou `updated`; `get`
devolveu o texto completo. O primeiro parecer no PR #49 veio em português e
apontou ambiguidade na explicação da sincronização; o texto foi corrigido.
A revisão incremental no commit `e542f2a` confirmou a correção sem novos
achados. CI Linux passou; o primeiro job macOS falhou por timeout no teste
sintético de PTY e passou no rerun do mesmo commit. A intermitência foi
registrada na [issue #50](https://github.com/lippdev/memory-bee/issues/50).
O ensaio de rascunho do item 53 segue pendente. Isso não altera o status das
etapas do produto.
Autorrevisão documental; Pullfrog é revisor automatizado, não revisão humana
independente.

## Revisão de sequência — orientação do mantenedor

Em 2026-09-24, o mantenedor pediu continuidade das implementações e deixou os
Expand Down
15 changes: 15 additions & 0 deletions docs/MANUAL_TESTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -901,3 +901,18 @@ ensaio humano. Exportação integrada e perfis reais ainda pendentes.
| Item novo | Estado | Evidência manual |
|---|---|---|
| 52: UI Bee sobre Claude real oculto, ferramentas, permissões e retomada | Pendente | — |

## 53. Revisão do Pullfrog em PR (pendente)

Após integrar `.github/pullfrog/review.md` e sincronizar `prompts.review` pelo
comando em `CONTRIBUTING.md`, abrir um PR pequeno com uma mudança revisável.
Conferir no PR que o check `pullfrog` termina e que há parecer em português,
com referência a um risco concreto quando existir. Enviar um novo commit ao PR
e conferir a revisão incremental. Testar um PR de rascunho: a revisão automática
deve aguardar a marcação como pronto. Um parecer sem achados não prova que todos
os comportamentos foram testados. Anotar links dos PRs/runs e qualquer falha;
não contar esta seção como executada pelo resultado de CI deste ajuste.

| Item novo | Estado | Evidência manual |
|---|---|---|
| 53: revisão inicial, incremental e rascunho | Pendente | — |
Loading