Higiene do repositório

O controle de versão do DispatchAtlas contém fonte, testes, configuração, documentação, e metadados reproduzíveis escritos à mão. Os produtos de execução local permanecem fora do Git a menos que uma política os promova explicitamente a fonte.

🧹 Política de saída gerada

Dados de experimento gerados, pontos de verificação, pacotes de resultados, relatórios de cobertura, saída de compilação de docs, artefatos de pacote, e candidatos de lançamento são ignorados por padrão. Eles são regenerados a partir da fonte e registrados via proveniência quando gates posteriores os promovem.

Arquivos gerados rastreados requerem:

• Um dono de fonte.
• Um comando de regeneração.
• Uma justificativa de retenção.
• Um caminho de revisão para saída obsoleta.

🗃️ Política de cache

Caches locais de Python, Ruff, mypy, pytest, cobertura, compilações de documentação, e ambientes virtuais são ignorados. CI pode cachear dependências, mas as chaves de cache devem derivar de lockfiles e entradas de fluxo de trabalho.

🔬 Política de saída de experimento local

As execuções de experimento local escrevem nas camadas de saída ignoradas do espaço de trabalho de experimentos — resultados de execução, registros, pontos de verificação, e pacotes de evidência, conforme dispostos no README do próprio espaço de trabalho — ao lado de outros locais de scratch ignorados como outputs/ ou artifacts/. A evidência de pesquisa final é produzida via comandos validados de campanha e análise antes de qualquer uso público.

📋 Regras de retenção de artefatos