~/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.

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

CamadaOnde viveO que pega
Padrões genéricosNo script, versionadosCaminhos 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 hashUm arquivo versionado com digests SHA-256 de palavras em minúsculasUm nome bloqueado para todos, sem que o nome esteja escrito em lugar nenhum
Lista pessoalUm arquivo no diretório de configuração do usuário, nunca commitadoUma 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.