~/daily/work 2026-11-20 · published 2026-11-21
Uma deny list que ninguém precisa escrever
Repositórios compartilhados nunca devem conter nomes de outros projetos. A lista de nomes vem dos checkouts que você já tem na máquina, então não há nada para preencher à mão.
- harness
- neutrality
- python
- git
- ~/project/versatile-sh
Uma regra que depende de uma lista
Um repositório de equipe que amanhã deve poder ser público não pode conter o nome de um empregador, de um cliente nem do outro projeto de alguém. A proteção óbvia é uma deny list. O problema óbvio é que a própria lista é uma lista desses nomes. Commitá-la anula o propósito.
O harness já tinha o formato de uma resposta. `bin/harness_deny.py` combina três fontes, da mais forte para a mais fraca: padrões genéricos, nomes com hash e uma lista pessoal que fica fora do git. O pull request #174, de 2026-11-20, fez a terceira fonte se gerar sozinha.
Três camadas
| Camada | Onde vive | O que pega |
|---|---|---|
| Padrões genéricos | No script, versionados | Caminhos de home pessoais, endereços de e-mail, endereços IP, tokens, chaves privadas, referências a secret stores, trailers de atribuição, o formato de um documento fiscal |
| Nomes com hash | Um arquivo versionado com digests SHA-256 de palavras em minúsculas | Um nome bloqueado para todos, sem que o nome esteja escrito em lugar nenhum |
| Lista pessoal | Um arquivo no diretório de configuração do usuário, nunca commitado | Uma expressão regular por linha, sem diferenciar maiúsculas: os nomes reais desta máquina |
Um repositório pode ter um arquivo allow com uma exceção por linha, com um glob de caminho e um motivo. Os mesmos padrões são compartilhados por `bin/check`, por `bin/harvest` e pelo validador que um repositório passa antes de ficar público.
De onde vem a lista pessoal
`bin/harness_scan.py` percorre os checkouts git sob a pasta Versatile. Um checkout é nosso se o origin dele é um repositório de `versatile-sh`. Todo o resto, outra organização ou nenhum remote, é listado em um `local/repos.md` ignorado. O owner e os nomes distintivos de repositório desses remotes viram um bloco gerenciado na lista pessoal.
Palavras genéricas não podem virar padrões de bloqueio, senão todo doc que mencione um servidor seria bloqueado. O scanner carrega uma stoplist de palavras comuns de repositório (app, api, docs, backend, platform, agent e 137 palavras no total) e as descarta.
- `bin/install` e `bin/sync` rodam o scan, então um checkout novo entra na lista no próximo sync.
- O bloco é marcado como gerado e gerenciado. As linhas próprias da pessoa fora do bloco são mantidas.
- `local/repos.md` tem uma seção chamada Extra para tudo que o scan não consegue ver.
Limites
Ela só conhece o que está nesta máquina. Um cliente que não existe em nenhum checkout não está na lista, e um nome que também é uma palavra comum pode escapar da stoplist ou ser descartado por ela. Por isso os padrões genéricos e o sanitizer do harvest continuam por cima.
Não medi falsos positivos nem omissões. Um harvest que segura arquivos que não deveria, ou um que deixa passar um nome, seria a primeira evidência, e ainda não há nenhuma registrada.