Funcionalidade wiki_links - BrunodosSantosVaz/big-bang GitHub Wiki

Navegação da Wiki

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

Finalidade

Garantir Home, navegação, páginas, imagens e âncoras internas válidas antes de concluir documentação.

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

Ler Markdown fora de cercas de código, resolver links Markdown, HTML e WikiLinks, conferir destino, extensões e âncoras no snapshot. Em badges Markdown aninhados, verifica imagem e destino externo do badge separadamente, evitando aceitar página ou âncora inexistente.

Validações

Links absolutos da própria Wiki também são internos; symlinks e caminhos que saem da pasta são recusados.

Alternativas e erros

Imagem ausente, página inexistente ou cerca aberta bloqueia publicação; links externos têm revisão separada.

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: Garantir Home, navegação, páginas, imagens e âncoras internas válidas antes de concluir documentação. 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.

wiki_links.py

Implementação revisada.

Símbolo Linha
_closing_parenthesis 13
_destination 41
markdown_targets 50
_target 70
problems 87

Cenários e rastreabilidade

Requisitos · Matriz de rastreabilidade · Referência CLI

Fontes rastreadas

Regressão de badges · 2.0.1

Os testes reproduziram destinos externos de badges para páginas e âncoras ausentes antes da correção. Outra regressão confirmou o problema com parênteses no URL da imagem ou no título, incluindo caminhos locais escapados e delimitados por <...>. O parser agora acompanha parênteses balanceados, escapes e títulos; confere a imagem e o destino externo separadamente. Badges válidos continuam aceitos e imagens ausentes continuam bloqueando publicação. Nenhuma prosa é executada nem dependência foi acrescentada.

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