feat: um comando para ver a ferramenta funcionando

[lvcas-dotcom]

O demo

$ docker compose -f demo/compose.yaml up

Sobe um Postgres descartável, carrega um schema que quase não declara a própria integridade, e imprime o relatório. Nada do usuário envolvido, e o banco morre com o contêiner. Testado ponta a ponta.

A imagem no topo do README é saída real renderizada em SVG, não screenshot — screenshot ninguém versiona, envelhece calado, e não se regrava sem a mesma máquina e a mesma fonte. scripts/termsvg.go lê os bytes que a ferramenta emite, escapes inclusive, e make demo-svg regenera. O gerador é Go com //go:build ignore: roda por go run, não entra no binário e não traz dependência.

O SQL do demo passa a ter uma cópia só — docs/DEMO.md carregava a segunda.

Dois defeitos que só a gravação revelou

A seção de detecção saía com o cabeçalho vazio. A auditoria de eficiência (#22) acrescentou uma dimensão — o nome que o schema dá às próprias chaves primárias — e a incluiu em Empty(). O renderizador do terminal não foi junto. Num schema cuja única convenção detectada fosse essa, o relatório abria DETECTED — conventions read from the schema itself, desenhava a régua, e não listava nada.

O teste percorre as quatro dimensões e falha se alguma contar como evidência sem aparecer. Verificado por mutação.

O alvo carimbava a versão da árvore de trabalho. A gravação saía com v0.1.2-16-g837ec2a-dirty, que conta ao leitor sobre o checkout do mantenedor em vez de sobre o banco dele. Agora constrói na última tag — o que exigiu tornar LDFLAGS recursivo, porque com := ele já estava expandido antes de a variável do alvo existir.

Nenhum dos dois é pego por leitura de código. O primeiro precisa de um schema com uma forma específica; o segundo só existe quando alguém roda.

Verificação

• go test ./... verde, golangci-lint zero issues, make release-check nos três estágios
• docker compose -f demo/compose.yaml up roda até o fim e sai com código 0
• Imagem e bloco de texto do README vêm da mesma captura — mesma duração, mesma versão

Para olhar com os próprios olhos

Vale abrir o assets/demo.svg renderizado e a pré-visualização do README. É a única parte que não dá para verificar por teste: se a fonte monoespaçada do navegador tiver largura diferente da assumida, as colunas da tabela desalinham.