Funcionalidade status - BrunodosSantosVaz/big-bang GitHub Wiki
Status e flags
Funcionalidade BB-F-023 · requisito RF-BB-023 · versão documentada 2.0.1 · código 9c73feb3e357a1216011eaf64bf4b5d944827087.
Finalidade
Mostrar posses e flags de leitura e sinalizar tarefas abandonadas somente pela automação específica.
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
Consultar sessões, última atividade e flags; produzir relatório da situação; a operação explícita de marcar vencidas aplica labels de recuperação.
Validações
Consulta de status não toma posse nem altera decisões do dono; expiração usa dados do GitHub.
Alternativas e erros
Acesso indisponível ou configuração inválida não vira relatório de tudo concluí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: Mostrar posses e flags de leitura e sinalizar tarefas abandonadas somente pela automação específica. 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.
status.py
| Símbolo | Linha |
|---|---|
possessions |
10 |
mark_stale |
24 |
_date |
41 |
flags |
47 |
report |
84 |
Cenários e rastreabilidade
.bigbang/tests/test_status_posses.py:test_status_le_so_e_marcacao_e_idempotente.bigbang/tests/test_status_posses.py:test_push_renova_mesmo_quando_commit_foi_escrito_antes.bigbang/tests/test_status_posses.py:test_push_concorrente_com_liberacao_nao_reabre_sessao.bigbang/tests/test_status_posses.py:test_push_entre_conferencia_e_marcacao_nao_deixa_label_parada.bigbang/tests/test_status_posses.py:test_push_durante_retomada_preserva_a_sessao_renovada.bigbang/tests/test_status_posses.py:test_forcar_exige_ordem_e_posse_vencida.bigbang/tests/test_status_posses.py:test_sem_nome_valido_nao_deve_revogar_a_posse.bigbang/tests/test_status_posses.py:test_bb_status_e_somente_leitura.bigbang/tests/test_status_posses.py:test_vencida_producao_antiga_e_ativa.bigbang/tests/test_status_posses.py:test_flag_invalida_nao_desaparece_do_relatorio.bigbang/tests/test_status_posses.py:test_merge_libera_label_e_preserva_comentario
Requisitos · Matriz de rastreabilidade · Referência CLI