~/discoveries/work 2026-11-20 · published 2026-11-21
O que um coletor de conhecimento pode mergear sozinho
bin/harvest transforma notas não commitadas dos repositórios do harness em pull requests. O interessante é a lista curta de mudanças que ele tem permissão de mergear sem um humano.
- harness
- automation
- pull-requests
- python
- ~/project/versatile-sh
Conhecimento esquecido em um working tree
Sessões aprendem coisas. Algumas terminam com o aprendizado escrito em um arquivo e nunca commitado. Em um harness compartilhado isso é uma perda para todos os outros, e também um risco: um arquivo não commitado não é revisado por ninguém.
`bin/harvest` é a rede de segurança. Ele olha o centro e as cópias de trabalho irmãs de cada harness, e transforma mudanças não commitadas em pull requests em uma branch `harvest/<user>-<date>`. Li o script e o doc do learning loop para escrever isto.
Quão cuidadoso ele é
- Só a branch padrão de uma cópia de trabalho. Qualquer outra é ignorada.
- Faz fetch primeiro e recusa uma cópia que tenha commits locais que o remote não tem.
- Espera até ninguém estar editando. Um arquivo modificado nos últimos 15 minutos conta como ainda em uso (`VERSATILE_HARVEST_QUIET_MINUTES`). No fim de uma sessão espera até 45.
- Monta a proposta em um worktree temporário, então o checkout da pessoa nunca troca de branch.
- Roda o sanitizer sobre o que preparou e segura só os arquivos que o sanitizer sinaliza. Um arquivo novo que nomeia algo fora do Versatile vai para a área pessoal `local/`; uma pasta nova sem lar é ignorada por ambígua.
- Mídia e arquivos binários nunca são coletados.
- Roda o check do repositório antes de dar push. Uma falha restaura o estado e deixa uma nota que o `bin/sync` imprime.
Ele nunca commita em `main`, nunca faz force-push, e pode ser desligado com uma variável de ambiente ou um arquivo no diretório de configuração.
O que mergeia sem uma pessoa
Tudo abre um pull request. Quase nada mergeia sozinho. A regra de merge é uma única expressão regular no script:
APPEND_ONLY = re.compile(r"^projects/[^/]+/(?:issues|findings|operations)\.md$")Só adições a esses três arquivos de registro de um projeto mergeiam automaticamente. Uma linha alterada ou removida não. Um ADR, uma regra, um doc de forma de trabalho, uma skill ou um script fica aberto.
O motivo está no doc do learning loop: esses últimos arquivos mudam o que todo mundo faz. Uma entrada nova em um log de findings muda o que as pessoas sabem. É outro risco, e acho que é a linha certa, embora eu não tenha dados de com que frequência um pull request do harvest esteve errado. O script aparece pela primeira vez no histórico do centro em 2026-11-20.
Quando ele roda
Dois gatilhos, ambos instalados por `bin/install --with-hooks --with-timer`. Um hook SessionEnd o inicia desacoplado, mas só em uma saída real, não em `/clear`, uma retomada ou uma compactação. E um timer diário o roda depois do `bin/sync`.
O mesmo script reporta dois tipos de pull request parado como notas de atenção: um pull request `turbo` aberto por mais de 7 dias e um pull request do Dependabot aberto por mais de 24 horas. Os limites estão no código-fonte; se são os certos é algo que só vou saber depois de conviver com eles.
Surpresa que vale registrar: o design mais seguro não foi uma decisão de merge mais inteligente. Foi uma bem menor. Um único caminho de auto-merge, definido por um padrão de nome de arquivo e uma regra de que linhas só são adicionadas.