Verificação da instalação

Funcionalidade BB-F-027 · requisito RF-BB-027 · versão documentada 2.0.1 · código 4c10eb3217364a0e0688895ea8a3636896521dfb.

Finalidade

Detectar adulteração, geração fora de sincronia e workflows que violam as regras do framework.

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

Conferir VERSION e CHECKSUMS, reconstruir o plano esperado e validar conteúdo gerado, dependências da stack e regras dos workflows.

Validações

A camada instalada e os arquivos gerados precisam coincidir com suas fontes; público consulta a stack canônica.

Alternativas e erros

Diferenças e Actions fora dos controles são listadas e produzem falha; verificar não corrige silenciosamente conteúdo.

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 adulteração, geração fora de sincronia e workflows que violam as regras do framework. 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.

verify.py

Implementação revisada.

Símbolo	Linha
run	17
_stack_dependencies	36
_workflows	55

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

Fontes rastreadas

• .bigbang/bb/verify.py