Funcionalidade workspaces - BrunodosSantosVaz/big-bang GitHub Wiki

Isolamento das IAs

Funcionalidade BB-F-030 · requisito RF-BB-030 · versão documentada 2.0.1 · código 24f19ac8ad23e0307ce8797a264012fc0832bb2b.

Finalidade

Criar worktree próprio somente depois de confirmar posse da tarefa e guardar recibos em metadados Git.

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 sessão vencedora, branch e remotes; criar pasta isolada; registrar receipt com sessão e issue; recuperar a evidência local ao operar. Na v3 a pasta própria aceita os prefixos test/, feature/, docs/, fix/ e hotfix/; um bug sem branch ganha fix/<n>-<slug> a partir da main.

Validações

Código não é escrito na pasta compartilhada de outra IA; recibos de sessão não são commitados no sistema.

Alternativas e erros

Branch ausente, posse não confirmada ou pasta incompatível impede isolamento; não apaga mudanças de terceiros.

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: Criar worktree próprio somente depois de confirmar posse da tarefa e guardar recibos em metadados Git. 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.

workspaces.py

Implementação revisada.

Símbolo Linha
git 11
_update_local 18
_bug_branch 35
isolate 53
receipt 78

Cenários e rastreabilidade

Requisitos · Matriz de rastreabilidade · Referência CLI

Fontes rastreadas

⚠️ **GitHub.com Fallback** ⚠️