Funcionalidade checksums - BrunodosSantosVaz/big-bang GitHub Wiki
Integridade do framework
Funcionalidade BB-F-003 · requisito RF-BB-003 · versão documentada 2.0.1 · código 9c73feb3e357a1216011eaf64bf4b5d944827087.
Finalidade
Detectar alterações não autorizadas na camada .bigbang e gerar o inventário de integridade do pacote.
Atores
Pessoa responsável pelo projeto, IA com posse confirmada e automações explicitamente autorizadas.
Pré-condições
Repositório e raiz corretos, versão instalada e configuração compatível. Para operações de escrita, exige-se autorização vigente, branch adequada e acesso ao recurso envolvido; consultas não conferem permissão adicional.
Fluxo principal
Listar os arquivos da camada, normalizar CRLF para LF, calcular SHA-256 e comparar com CHECKSUMS.
Validações
O hash da mesma fonte é igual em checkout Windows ou Linux; a lista acompanha todos os arquivos aplicáveis.
Alternativas e erros
Arquivo ausente, hash diferente ou conteúdo inesperado é apresentado como problema de integridade.
Permissões
Leitura usa permissões mínimas do repositório. Operações locais respeitam a posse e worktree; escrita no GitHub exige acesso explícito. Esta funcionalidade não concede novas permissões a visitantes nem substitui decisões exigidas pelo fluxo.
Resultados
Resultado esperado: Detectar alterações não autorizadas na camada .bigbang e gerar o inventário de integridade do pacote. O retorno e os arquivos afetados são conferidos pelos cenários rastreados abaixo; falha impede considerar a operação concluída.
Referência da implementação
Os símbolos abaixo compõem o inventário real do módulo, incluindo auxiliares internos; não representam APIs públicas independentes.
checksums.py
| Símbolo | Linha |
|---|---|
file_hash |
16 |
framework_files |
26 |
compute |
40 |
write |
44 |
_parse |
51 |
problems |
60 |
Cenários e rastreabilidade
.bigbang/tests/test_bb_verificar.py:test_template_limpo_passa.bigbang/tests/test_bb_verificar.py:test_editar_bloco_gerado_do_agents_md_reprova.bigbang/tests/test_bb_verificar.py:test_editar_secao_do_projeto_no_agents_md_passa.bigbang/tests/test_bb_verificar.py:test_editar_arquivo_gerado_da_esteira_reprova.bigbang/tests/test_bb_verificar.py:test_apagar_ou_sobrar_gerado_reprova.bigbang/tests/test_bb_verificar.py:test_editar_bloco_do_stack_md_reprova.bigbang/tests/test_bb_verificar.py:test_stack_md_sem_tabela_de_dependencias_reprova.bigbang/tests/test_bb_verificar.py:test_editar_framework_reprova.bigbang/tests/test_bb_verificar.py:test_arquivo_a_mais_no_framework_reprova.bigbang/tests/test_bb_verificar.py:test_readme_e_licenca_movidos_pelo_init_passam.bigbang/tests/test_bb_verificar.py:test_crlf_do_windows_passa.bigbang/tests/test_bb_verificar.py:test_bigbang_toml_invalido_reprova.bigbang/tests/test_bb_verificar.py:test_workflow_fora_das_regras_reprova.bigbang/tests/test_bb_verificar.py:test_codigos_de_saida_do_cli.bigbang/tests/test_bb_verificar.py:test_aceita_workflow_certo.bigbang/tests/test_bb_verificar.py:test_recusa_cada_erro.bigbang/tests/test_bb_verificar.py:test_pull_request_target_sem_checkout_do_pr_passa
Requisitos · Matriz de rastreabilidade · Referência CLI