Funcionalidade encerramento - BrunodosSantosVaz/big-bang GitHub Wiki

Encerramento e faxina

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

Finalidade

Encerrar sprints e releases sem abandonar branches e sem apagar trabalho ainda não integrado.

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

Confirmar tag e Release estáveis, integração em main/develop e issues resolvidas; fechar milestone e mover cards; listar sobras; apagar somente branches terminadas que satisfaçam os bloqueios.

Validações

main, develop, dependabot e tags são preservados; posse ativa, PR aberto, branch divergente ou CI ausente impede exclusão.

Alternativas e erros

Faxina inconclusiva reporta bloqueio; FAXINA_EXIGIR_LIMPA impede declarar sprint encerrada com sobras injustificadas.

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: Encerrar sprints e releases sem abandonar branches e sem apagar trabalho ainda não integrado. 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.

Cenários e rastreabilidade

Requisitos · Matriz de rastreabilidade · Referência CLI