Funcionalidade names - BrunodosSantosVaz/big-bang GitHub Wiki

Tabela de nomes da v3

Funcionalidade BB-F-049 · requisito RF-BB-049 · versão documentada 3.0.1 · código 371a61ae5c993f6ba3fde76e77f91e64f0bf9c42.

Finalidade

Manter numa única tabela a correspondência entre os identificadores da v2, em português, e os da v3, em inglês, para que nenhum nome legado seja escrito em dois lugares e a atualização não quebre projetos existentes (ADR-0024).

Atores

Módulos da CLI, leitura do bigbang.toml, decisões do dono, hooks do Claude Code e, nas próximas etapas, a esteira v3 e a migração guiada.

Pré-condições

Nenhuma: o módulo é puro, não lê arquivos nem rede, e é importado pelo restante do pacote bb e pelos hooks.

Fluxo principal

Consultar key_to_v3/key_to_legacy para chaves do bigbang.toml, value_to_v3/value_to_legacy para valores-identificadores, cli_name/cli_option para registrar comandos e opções com aliases, label/label_dialect para labels e as tabelas de branches, workflows, checks, ambiente, segredos e variáveis.

As chaves de configuração do alvo personalizado também usam a tabela central: script_publicar, script_migrar, script_saude, script_voltar e variaveis_personalizado têm os equivalentes em inglês definidos ali. Não há chave de segredos para o alvo, pois os scripts do projeto não recebem segredos.

Validações

Cada chave legada faz ida e volta; cada valor traduzido volta ao original; cada comando legado tem exatamente um nome v3; chaves só da v3 (board.model, board.number, board.labels, workflow.model) não têm nome legado.

Alternativas e erros

Nome desconhecido volta sem tradução, para que a validação estrita do bigbang.toml ou do argparse aponte o erro com o nome que a pessoa escreveu; nada é inventado.

Permissões

Nenhuma permissão é concedida: a tabela apenas traduz nomes, sem tocar em arquivos, labels ou no GitHub.

Resultados

Configuração, CLI, decisões e hooks respondem nos dois idiomas com uma única fonte de verdade, base da migração por partes descrita no ADR-0024.

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.

names.py

Implementação revisada.

Símbolo Linha
cli_name 103
cli_option 109
is_build_key 171
key_to_v3 175
key_to_legacy 184
value_to_v3 202
value_to_legacy 206
label_dialect 214
label 220

Cenários e rastreabilidade

Requisitos · Matriz de rastreabilidade · Referência CLI

Fontes rastreadas