Adicionar configuração de policies e regra de TargetFramework

[rodri-oliveira-dev]

Objetivo

Adicionar configuração versionada mínima de policies e implementar uma primeira rule de TargetFramework sobre o núcleo criado na #28.

Escopo

• definir extensão compatível da configuração existente ou arquivo apropriado;
• permitir habilitar/configurar policies explicitamente;
• implementar uma rule simples de TargetFramework suportado/permitido;
• validar configuração e produzir erro estruturado para config inválida;
• manter zero-config sem aplicação de policy;
• adicionar testes de parsing e avaliação.

Fora de escopo

• integração CLI/output final;
• GitHub Action;
• várias rules adicionais;
• dependências arquiteturais proibidas.

Definition of Ready (DoR)

BLOCKED até o trabalho da #28 estar concluído na branch compartilhada do Grupo 4.

• Núcleo da policy engine da Criar núcleo desacoplado da policy engine #28 implementado na branch compartilhada.
• Testes do núcleo passando na mesma branch.

Definition of Done (DoD)

• Configuração de policy é versionada e validada.
• Zero-config mantém comportamento atual e não executa policy implicitamente.
• A rule de TargetFramework possui código estável e severidade default documentada.
• A rule usa apenas o contrato normalizado, sem acesso direto a MSBuild.
• A semântica para projeto single-target está definida e testada.
• A semântica para projeto multi-target está definida e testada.
• O comportamento para TargetFramework ausente/desconhecido está definido e testado.
• O escopo do finding (projeto ou repositório) está explicitamente definido.
• Findings usam código/severidade estruturados do núcleo.
• Config inválida possui diagnóstico/erro determinístico.
• A ordenação de findings é determinística.
• Testes cobrem habilitado, desabilitado, match, violation, multi-target e config inválida.
• Documentação técnica mínima da configuração e da semântica da rule existe.
• Build, testes e quality gates relevantes passam.
• Alterações desta issue estão na branch compartilhada do Grupo 4.
• Nenhum PR separado foi aberto para esta issue.

Relação com a roadmap

Grupo 4 da #150 — etapa posterior à #28 e anterior à #158. A issue não abre PR próprio; será fechada pelo PR único do Grupo 4.

[rodri-oliveira-dev]

Implementação da #157 concluída na branch compartilhada do Grupo 4.

• branch: feat/issue-28-policy-engine
• head: c1f864e8ba58a02d89ea02db6f5a5de69e4a1f60
• base: main@11e02aa26c6ff11d6ba635d3dcb0a3ce20dcc702

Configuração versionada

A configuração existente foi evoluída de forma compatível:

• schema de configuração 1 continua aceito para exclusões e overrides de classificação;
• schema 2 é a versão corrente e adiciona policies;
• usar policies com schema 1 gera DRI1013 com reason estável policies-require-config-schema-2;
• propriedades desconhecidas continuam rejeitadas pelo parser atual.

Exemplo:

{
  "schemaVersion": "2",
  "policies": {
    "targetFramework": {
      "enabled": true,
      "allowed": ["net8.0", "net10.0"],
      "severity": "error"
    }
  }
}

TargetFramework policy

Implementada TargetFrameworkPolicyRule no Core:

• código estável: DRP0001;
• severidade default: error;
• severidades configuráveis: warning ou error;
• usa somente ProjectInspection.TargetFrameworks normalizado;
• finding possui escopo de projeto;
• single-target permitido: sem finding;
• single-target não permitido: um finding;
• multi-target: um finding por projeto quando qualquer TFM estiver fora da allowlist;
• contexto inclui TFMs permitidos, observados e não permitidos;
• projeto sem TFM conhecido não recebe violation fabricada;
• projetos/findings são ordenados deterministicamente pelo path relativo.

Zero-config / enablement

• sem arquivo de configuração: nenhuma policy;
• sem policies: nenhuma policy;
• targetFramework.enabled: false: nenhuma rule registrada;
• enabled é obrigatório quando o bloco da rule existe;
• allowed precisa possuir ao menos um TFM válido quando a rule estiver habilitada.

Config inválida

DRI1013 continua sendo o diagnóstico estruturado de configuração. Foram adicionados reasons determinísticos para:

• policies-require-config-schema-2;
• target-framework-policy-enabled-required;
• target-framework-policy-allowed-required;
• invalid-target-framework-policy-allowed;
• invalid-target-framework-policy-severity.

A documentação EN/PT-BR de configuração e diagnostics foi atualizada.

Testes adicionados

Cobertura inclui:

• zero-config;
• policy habilitada;
• policy desabilitada;
• parsing da configuração;
• match;
• violation;
• severidade warning;
• single-target;
• multi-target;
• TargetFramework ausente;
• ordem determinística entre projetos;
• configurações inválidas e reasons estáveis.

Nenhum PR separado foi aberto. A branch está 4 commits à frente da main, 0 atrás, e não existe PR associado, conforme a regra do Grupo 4.

Quality gates

O ambiente disponível nesta execução não possui dotnet e também não possui acesso de rede/DNS para clonar o repositório. Os workflows do repositório não disparam por push nesta branch e o conector disponível não expõe workflow_dispatch, portanto não foi possível executar build/test/CI neste estágio. Os gates automatizados deverão rodar no PR único do Grupo 4.

A issue permanece aberta para ser fechada pelo PR final da #159. Com o trabalho desta etapa concluído na branch compartilhada, a #158 está liberada para implementação.