Retornos estáveis

Funcionalidade BB-F-012 · requisito RF-BB-012 · versão documentada 2.0.1 · código 9c73feb3e357a1216011eaf64bf4b5d944827087.

Finalidade

Diferenciar sucesso, uso incorreto, configuração inválida e falhas externas para que scripts não interpretem erro como entrega.

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

BbError carrega mensagem e código; a CLI captura falhas esperadas e devolve o código correspondente ao chamador.

Validações

Os códigos 0 a 7 permanecem estáveis; somente 0 representa sucesso.

Alternativas e erros

Exceções inesperadas usam o código 1; integrações externas reprovadas usam diagnóstico em português.

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: Diferenciar sucesso, uso incorreto, configuração inválida e falhas externas para que scripts não interpretem erro como entrega. 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.

errors.py

Implementação revisada.

Símbolo	Linha
BbError	13
__init__	16

Cenários e rastreabilidade

• .bigbang/tests/test_bb_config.py:test_exemplo_valido
• .bigbang/tests/test_bb_config.py:test_compilado_valido_sem_secao_deploy
• .bigbang/tests/test_bb_config.py:test_chaves_opcionais_do_deploy
• .bigbang/tests/test_bb_config.py:test_recusa_chave_e_secao_desconhecidas
• .bigbang/tests/test_bb_config.py:test_recusa_chave_obrigatoria_ausente
• .bigbang/tests/test_bb_config.py:test_secao_do_perfil_ativo_e_obrigatoria
• .bigbang/tests/test_bb_config.py:test_build_de_cada_sistema
• .bigbang/tests/test_bb_config.py:test_alvo_conforme_o_perfil
• .bigbang/tests/test_bb_config.py:test_esquema_de_alvos_e_extensivel_capacidades_sao_do_gerador
• .bigbang/tests/test_bb_config.py:test_publico_exige_licenca
• .bigbang/tests/test_bb_config.py:test_tipos
• .bigbang/tests/test_bb_config.py:test_versao_igual_ao_framework
• .bigbang/tests/test_bb_config.py:test_repositorio_do_dono
• .bigbang/tests/test_bb_config.py:test_valores
• .bigbang/tests/test_bb_config.py:test_codigos_de_saida
• .bigbang/tests/test_bb_config.py:test_config_invalida
• .bigbang/tests/test_bb_config.py:test_toml_quebrado

Requisitos · Matriz de rastreabilidade · Referência CLI

Fontes rastreadas

• .bigbang/bb/errors.py