AurumCode v2.0.0

Primeira release do AurumCode atual: a revisão de pull request virou um gate
de conformidade que escreve para gente ler, verifica o que o modelo afirma
antes de publicar e falha fechado quando não consegue decidir.

Entregue

Camadas de política e padrões, analistas com ferramentas

• Camada de padrões de engenharia: segundo repositório central (--padroes; standards_repository no workflow) com skills e analistas abaixo da política; config.yml com seção é recusado; parecer e auditoria nomeiam a camada.
• Analistas (--perfis/review.profiles) deliberam com as mesmas ferramentas da passada única, num teto somado por revisão; o terminal diz o motivo real quando nada é oferecido e a auditoria registra as rodadas por analista.
• Publicação recusada por permissão (401/403): o diagnóstico nomeia a permissão que o token precisa (pull-requests: write ou statuses: write) e onde declará-la, mantendo a resposta do GitHub.
• Dados de análise publicados como pre-release e cópias com mais de 7 dias apagadas pelo workflow diário (mínimo de 3 mantidas; só analysis-data/*); terminal sem "(s)": singular e plural pelo catálogo pt-BR/en.

Parecer da pull request

• A decisão abre o comentário num aviso nativo do GitHub (Aprovado, Aprovado
  com observações, Bloqueado ou Inconclusivo), lida do gate declarado em
  .aurumcode/config.yml; depois "Corrigir antes do merge" com um item por
  problema, observações em uma linha, resumo e o resto recolhido em
  "Detalhes da revisão". Sem elogio, sem emoji, no máximo três limitações e
  três testes propostos; testes afetados aparecem contados.
• Um parecer por PR, editado a cada rodada; comentário na linha só para o que
  bloqueia, com sugestão aplicável também no modo comments; comentário já
  resolvido é marcado em vez de repetido; eco de scanner publicado uma vez.
• O status aurumcode/review e o código de saída do --pr seguem o gate
  declarado: achado que o gate não reprova não conta como grave. O --base
  local abre com a mesma decisão.
• Com review.language: pt-BR, parecer, status do gate, terminal e MCP saem
  em pt-BR (motivo de inconclusivo em frase, com o código entre colchetes);
  auditoria e SARIF não mudam de idioma. Achado sem prova descartado deixa o
  título em "nenhum problema comprovado".
• O parecer, a auditoria e o SARIF mostram a versão do AurumCode que revisou.

Análise por time

• Analistas por time (review.profiles, .aurumcode/profiles.yml) no local, no
  MCP e na revisão da PR: uma passada do modelo por analista (segurança embutido;
  padrões, QA ou outro do time), lida da base; o achado diz quem o encontrou.

Confiança no que o modelo diz

• Todo achado do modelo é verificado contra o código revisado, os bloqueantes
  primeiro; refutado com citação literal sai do parecer e fica na auditoria;
  confirmado, incerto, citação inexistente, erro ou teto mantêm o bloqueio
  (review.verification: enabled, max_calls).
• A última rodada da deliberação pede o parecer com a evidência já reunida em
  vez de terminar sem resposta; ignore limita também o escopo dos scanners;
  regra de segurança com forma de código (SQL, XSS, injeção de comando) não
  olha .txt/.log/.md; achado da passagem de segurança já traz a
  correção da regra.
• gate.triage vale model: o modelo pesa a evidência das regras, contestar
  exige justificativa e resposta degradada nunca rebaixa. A redação antes do
  prompt não mutila código; o catálogo não dispara em literal nem em prosa.
• Contexto: o modelo lê e busca arquivos da revisão em qualquer linguagem,
  fontes MCP configuradas, trechos de impacto e o alcance da parte vulnerável
  de uma dependência; status do CI separado da inferência do modelo.

Provedores de modelo

• Provedor reserva: LLM_FALLBACK_<n>_PROVIDER|_BASE_URL|_API_KEY|_MODEL
  (até 5), tentados em ordem quando o principal falha, com a troca anunciada;
  todos falhando, a revisão falha fechada. O workflow reutilizável aceita duas
  reservas (fallback_1_*, fallback_2_*).

Dependências

• Cada dependência alterada é checada no OSV em qualquer ecossistema, com gate
  dependencies.fail_on, exceção por CVE e licença; pacote malicioso ou
  typosquat reprova; aurumcode dependencies agendado publica SARIF. Nível
  de fail_on ilegível ou lista vazia falha fechado.

Changelog obrigatório

• aurumcode changelog --base <sha> reprova a PR sem entrada útil em
  Unreleased (changelog_check.mode: required; suggest só sugere); ao
  reprovar, a entrada sugerida vai ao log, ao resumo do job e ao parecer.
  PR aberta por bot não reprova (changelog_check.bots, padrão suggest).

Realimentação da política

• aurumcode realimentacao abre uma única PR no repositório da política com
  propostas citando falsos positivos, achados corrigidos e /aurum perdeu;
  nada é aplicado sem merge humano.

Documentação e operação

• Demonstração demo/do-zero em três repositórios (segurança, engenharia e o serviço): PR bloqueada pelas três camadas, o serviço não afrouxa a segurança, correção aprovada; tutorial executável camadas.
• Política central em repositório privado ou interno: secret opcional AURUMCODE_POLICY_TOKEN (só leitura) nos workflows de revisão e changelog.
• Tutoriais executáveis por capacidade, com saídas gravadas e conferidas no CI; site com busca e navegação por capacidade; docs de changelog e de auditoria/SARIF reescritas.
• Guias com proteção de branch, secrets do Dependabot, precedência da política central, versões fixadas e como saber que há versão nova.

Limites

• Sem benchmark com modelos reais: a qualidade do parecer foi conferida em
  casos gravados, não medida em escala; a taxa de pareceres inconclusivos
  também não é medida.
• Custo por revisão não é medido automaticamente e não há guia de qual
  modelo basta para cada tipo de repositório.
• Sem chave de modelo, o gate local roda só a parte determinística (segredos,
  SAST, vet, changelog) e termina em quality_skipped.
• xBOM: CBOM e Build BOM existem, sem AIBOM; xBOM não é critério do gate.
• O parecer não avisa quando existe versão mais nova: quem fixa @v2.0.0
  acompanha as releases do repositório.

Migração do v1

• As tags v1.x são do produto anterior e não recebem este conteúdo. No
  workflow do repositório, troque a referência de
  Mpaape/AurumCode/.github/workflows/review.yml (@main ou @v1...) por
  @v2.0.0; @main recebe toda mudança sem aviso.
• Secrets de Actions LLM_API_KEY e LLM_BASE_URL (serviço compatível com
  OpenAI); opcionais a variável LLM_MODEL, o input fallback_1_provider e
  os secrets LLM_FALLBACK_1_API_KEY e LLM_FALLBACK_1_BASE_URL.
• .aurumcode/config.yml na branch base declara o gate (gate.fail_on,
  gate.inconclusive, quality_gates.scanners, dependencies.fail_on,
  changelog_check.mode) e as skills de convenção em .aurumcode/skills/;
  sem o arquivo, o review só orienta.
• Não existem mais o gerador de docs de terceiros, os extratores, o runtime
  Jekyll e o resumo Mermaid do --base.