Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

Added (10.4.0 — Identity store, self-issued tokens, JWKS, dual scheme)

Blocos universais para apps com Identity local que emitem os próprios tokens. Ver ADR-005. Consumido pelo template ITLab.Template.Next (ADR-006, dual-scheme BFF cookie + Bearer JWKS como novo default).

• Infrastructure/EfCore/BaseIdentityDbContext<TUser,TRole> + ModelBuilderIdentityExtensions.ApplyDevPackIdentityConventions — IdentityDbContext<TUser,TRole,int> + convenções DevPack: move as 7 tabelas de Identity para um schema dedicado (default identity, configurável via IdentitySchema) sem o prefixo AspNet (identity.Users, identity.Roles, identity.UserRoles, identity.UserClaims, identity.UserLogins, identity.UserTokens, identity.RoleClaims); mapeia AuditTimestamp [Owned]; aplica query filter de soft-delete no user.
• Identity/Authentication/Bearer/ITokenService + DefaultJwtTokenService — emite access token JWT assimétrico (RSA/ECDSA) com header kid, issuer/audience de IdentityTokenOptions, TimeProvider injetado. Record AccessToken(Value, ExpiresAt).
• Identity/Authentication/Bearer/ISigningKeyProvider + EphemeralRsaSigningKeyProvider (RSA em memória, dev) + FileSigningKeyProvider (PEM em disco, prod). kid estável derivado do módulo público; PublicKeys expõe só material público.
• Identity/Authentication/Bearer/JwksDocumentBuilder — JWKS (RFC 7517) das chaves públicas (RSA/ECDSA, use=sig); nunca emite material privado.
• Identity/RefreshToken (abstract) + IRefreshTokenStore + RefreshTokenGenerator — refresh token persistido só como hash; estado de rotação (Revoke idempotente, ReplacedByTokenId) e contrato de store (add/find-active/rotate/revoke-all).
• Identity/ServiceClient (abstract) — cliente de máquina para client-credentials: ClientId, secret BCrypt (VerifySecret/HashSecret), GrantedRoles, ToClaimsIdentity.
• AppSettings/IdentityTokenOptions — Issuer/Audience/AccessTokenLifetimeMinutes/RefreshTokenLifetimeDays/SigningKeyPemPath (seção Authentication:Token).
• Identity/DevPackIdentityServiceCollectionExtensions — AddDevPackSigningKey(pemPath, isDevelopment) (ephemeral em dev, PEM em prod, falha-cedo fora de dev sem chave), AddDevPackTokenService(configuration), AddDevPackDualScheme(selector) (só o PolicyScheme Smart com ForwardDefaultSelector; AddCookie/AddJwtBearer permanecem explícitos no consumidor — ADR-001).
• Identity/IdentitySchemas.Bff + IdentitySchemas.Smart — constantes de scheme do cookie BFF e do scheme composto.
• Pacote: Microsoft.IdentityModel.JsonWebTokens 8.0.1 (pinado na versão que Microsoft.AspNetCore.Authentication.JwtBearer 10.0.1 resolve transitivamente, para unificar o grafo do consumidor sem upgrade forçado).
• Docs: Identity/README.md § Self-issued tokens & dual scheme.

Added (10.3.0 — code + namespace migration)

• ITLab.Template.DevPack.Testing (novo pacote auxiliar publicável): ship como nupkg separado.
  • WebApplicationFactoryBase<TProgram, TDbContext> — substitui DbContextOptions<TDbContext> por EF InMemory isolado, registra TestAuthenticationHandler como esquema default, expõe CreateClientWithRoles(...) e CreateAnonymousClient(), hook ConfigureAdditionalServices(IServiceCollection).
  • TestAuthenticationHandler — lê roles do header X-Test-Roles e produz ClaimsPrincipal autenticado.
  • IsolatedInMemoryProviderExtensions.UseIsolatedInMemoryProvider(string) — InMemory com IServiceProvider interno isolado, evita o erro "Services for database providers 'X', 'InMemory' have been registered".
  • CurrentUserBuilder / DateTimeProviderBuilder / ObjectArrayExtensions migrados de tests/ITLab.Template.DevPack.Testing (mesmo nome de assembly; o projeto interno foi promovido a pacote publishable).
• Helpers/DocumentHelper — validação e normalização de CPF/CNPJ brasileiros: IsCpfValid, IsCnpjValid, NormalizeCpf, NormalizeCnpj. Cobre all-equal, formatação, null/empty, comprimento e mod 11. Pesos do CNPJ corretos (não copiados de CPF).
• Guards/DocumentGuards — Guard.Against.InvalidCpf e Guard.Against.InvalidCnpj retornam o valor digit-only normalizado em sucesso (compatível com inicialização de value object). Internamente delegam para DocumentHelper.
• Middleware/DevPackIdentityContextMiddleware + Extensions/ApplicationBuilderExtensions.UseDevPackIdentityContext() — bridge entre HttpContext.User e AsyncLocalCurrentUserAccessor. Sem isso, RoleBasedPermissionEvaluator recebe UserRoles = [] em produção. Mapper default extrai claims NameIdentifier/sub, Name/name/preferred_username, e Role/role. Override via overload com Func<HttpContext, UserInfo?> para layouts JWT custom.
• Extensions/ResultHttpExtensions.ToHttpResult(...) — bridge Result<T> / Result → Microsoft.AspNetCore.Http.IResult para Minimal APIs. Mapping default: Validation→400, NotFound→404, Unauthorized→403, Conflict→409, Failure/Problem→500. Aceita errorMapper opcional.
• Extensions/MinimalApiPaginatedExtensions.MapPaginatedGet<TQuery,TDto> — encapsula bind individual de pageNumber/pageSize/orderBy/order/filter/paginated, dispatcha via Mediator e renderiza com ToHttpResult. Resolve gotcha do [AsParameters] sobre PaginatedQueryBase<T>.
• Domain/AuditedSoftDeletableEntity<TKey>: ctor protected AuditedSoftDeletableEntity(TKey id) : base(id) {} — paridade com AuditedEntity<TKey>. Permite private Pedido(Guid id, ...) : base(id) sem precisar de Id = id; no corpo.
• Domain/DomainEvent.GetKeys(): XML doc com <example> de override completo (OrderApprovedEvent : DomainEvent).

Changed (10.3.0 — BREAKING namespace migration)

• Result, Result<T>, Error, ErrorType, ValidationError movidos do namespace raiz ITLab.Template.DevPack para ITLab.Template.DevPack.Core. Folder src/.../Results/ renomeado para src/.../Core/. Update consumer using directives. Marcado breaking por convenção; nenhum consumidor de produção existia no momento da release.
• DispatchDomainEventsInterceptor ctor mudou de (IPublisher publisher) para (IServiceProvider serviceProvider). Resolve IPublisher per-save via IServiceProvider.CreateAsyncScope(). Permite que o interceptor Singleton coexista com handlers Mediator Scoped (default DevPack) sem violar container validation. Regression test adicionado em tests/.../InterceptorsTests.cs.

Removed (10.3.0 — BREAKING)

• ITLab.Template.DevPack.IResult removido (sem uso real). Quem usava using IResult = ITLab.Template.DevPack.IResult; para evitar colisão com Microsoft.AspNetCore.Http.IResult pode remover o alias.

Added (10.2.4 — docs/CI)

• CLAUDE.md (raiz): prefácio "Escopo deste documento (princípio G-01)" estabelecendo onde mora cada regra (uso da biblioteca = aqui; convenções específicas do template = ITLab.Template.Next/CLAUDE.md). Seção "What NOT to do" consolida os anti-padrões mais frequentes.
• Authorization/README.md: subseção "Permissions catalogue location" canonizando Application/Common/Authorization/{Project}Permissions.cs. Subseção "Permission convention: endpoint vs command" explicita que RequireAuthorization é default e [RequiresPermission] é opt-in para regras contextuais.
• Behaviors/README.md: subseção "Validator placement convention" (validators ao lado do Command/Query + AddValidatorsFromAssembly).
• Cqrs/README.md: seção "Handler lifetime" (configurar opt.ServiceLifetime = ServiceLifetime.Scoped em AddMediator quando handlers consomem IAppDbContext); seção "Domain events" cross-link com Domain README.
• Core/README.md: tabela "Error factory methods" com mapping HTTP default (Validation→400, NotFound→404, Unauthorized→403, Conflict→409, Failure/Problem→500).
• Domain/README.md: seção "Domain events policy" (quando criar evento + handler obrigatório MSG0005 + placeholder pattern com ILogger). Esclarece IDomainEvent : Mediator.INotification.
• Identity/README.md: seção "Authentication scheme — production checklist" (JWT Bearer / Entra ID / Cookie / pipeline order incluindo app.UseDevPackIdentityContext() da 10.3.0). Nota sobre PlaceholderAuthenticationHandler ser scaffold do template, não publicado no DevPack.
• Infrastructure/EfCore/README.md: seção "EF migrations CLI" com --project + --startup-project e cross-ref ao CLAUDE.md do template.
• CI: smoke-test-convention-check via Roslyn em tools/DocsSmokeCheck/ — extrai blocos ```csharp dos READMEs de áreas e os compila contra a DLL recém-buildada do DevPack. Suporta fence ```csharp-noverify para snippets ilustrativos.
  • Baseline pragmática: snippets de "Como usar" / wiring / chamadas em corpo de método ficaram marcados como csharp-noverify por padrão, pois referenciam símbolos do consumidor (Order, services, MyAppPermissions). Blocos auto-suficientes (definições de tipo) ficam como csharp para guardar regressões — atualmente cobrem o A-02 (ICommand<T>/IQuery<T>), A-03 (class : PaginatedQueryBase<T>) e C-01 (override GetKeys()).
  • CI gate é strict (continueOnError: false). Mediator foi removido dos common usings da tool por colidir com ITLab.Template.DevPack.Cqrs; blocos que precisam dele declaram using Mediator; explicitamente.
  • CONTRIBUTING.md documenta as convenções e o checklist do autor.

Changed

• Cqrs/README.md: exemplo canônico mudou de ICommand<Result<TResponse>> para ICommand<TResponse> — o wrapping Result<> é aplicado automaticamente pela assinatura do handler. "What NOT to do" no CLAUDE.md ratifica.

• Data/README.md: exemplo canônico mudou de record ListOrdersQuery : PaginatedQueryBase<...> para class ListOrdersQuery : PaginatedQueryBase<...> — base é classe abstrata, records C# não herdam de classes não-record (CS8865/CS0115). Cross-ref a MapPaginatedGet (10.3.0).

• LLM-readable docs shipped inside the nupkg at devpack-docs/. A pasta inclui llms.txt (índice formato llmstxt.org), CLAUDE.md, DEVPACK.md, CHANGELOG.md, os 4 ADRs em adrs/, e os READMEs por área em areas/{Namespace}/README.md (preserva hierarquia — ex.: areas/Identity/MultiTenancy/README.md). Resolve no consumidor via {NuGetPackageRoot}/itlab.template.devpack/{version}/devpack-docs/.

• Empacotamento via <None Pack="true" PackagePath="devpack-docs/..."> no .csproj. Os arquivos MD reusam a fonte de verdade do repositório (sem duplicação) — editar o MD original atualiza fonte e o conteúdo do package na próxima dotnet pack.

• Tamanho adicional do nupkg: ~30 KB compridos (39 arquivos MD totalizando ~135 KB descomprimidos). Insignificante perto dos 105 KB da DLL e 385 KB do XML doc.

  Motivação: o .xml doc da DLL é referência de tipo (IntelliSense), mas falta conhecimento operacional ("quando uso X vs Y?", "qual é o padrão para Z?"). O devpack-docs/ cobre esse gap, version-pinned com a release exata do package consumido — elimina drift estrutural entre a doc e o binário.

[10.2.2] - 2026-05-02

Fixed

• ITLab.Template.DevPack.csproj: adicionada <RestoreEnablePackagePruning>false</RestoreEnablePackagePruning> no <PropertyGroup> raiz. Sem essa property, o NuGet 10.x SDK prunava a PackageReference defensiva de System.Security.Cryptography.Xml 10.0.7 (mesmo com NoWarn="NU1510") durante dotnet pack, fazendo com que o pin de segurança introduzido na 10.2.0 não chegasse ao nuspec publicado — verificado empiricamente nas releases 10.2.0 e 10.2.1, ambas sem a dependência no nuspec. A 10.2.2 carrega corretamente <dependency id="System.Security.Cryptography.Xml" version="10.0.7" /> — consumidores herdam o hardening transitivamente sem precisar de override local.
• NoWarn="NU1510" removido do <PackageReference Include="System.Security.Cryptography.Xml"> — redundante após o RestoreEnablePackagePruning=false (warning não dispara mais).

[10.2.0] - 2026-05-01

Nota de versionamento. A partir desta release, o esquema do DevPack alinha o primeiro dígito ao framework target (.NET 10 → DevPack 10.x). Esta versão é o sucessor direto da 2.1.1 — o conteúdo é o mesmo que estava sendo desenvolvido como "10.2.0" em rascunhos/relatórios, agora rotulado como 10.2.0 ("segunda minor para .NET 10"). Versões 2.x continuam disponíveis para projetos legados que ainda não migraram. Releases futuras seguirão 10.x.y enquanto a base for .NET 10; quando .NET 11 for adotado, o versionamento passa para 11.x.y.

Release temático: **auditoria com value object IANA-aware + role-based authorization

• ergonomia de DI**. Acompanhada por dois ADRs novos:

• ADR-003 — AuditTimestamp value object com timezone por timestamp.
• ADR-004 — Role-based permission resolution.

Security

• Pin transitivo de System.Security.Cryptography.Xml 10.0.7. Endurece o graph contra os advisories de severidade alta GHSA-37gx-xxp4-5rgx e GHSA-w3x6-4m5h-cxqf, presentes nas versões 9.x e 10.0.0–10.0.6 do pacote — puxado transitivamente via Microsoft.AspNetCore.Identity.EntityFrameworkCore. Consumidores herdam automaticamente; o pin no Directory.Packages.props do consumidor pode ser removido (era a recomendação da Fase 1 do template ITLab.Template.Next).

  Errata pós-publicação: o nuspec dos pacotes 10.2.0 e 10.2.1 publicados não carregou esta dependência por causa de pruning automático do NuGet 10.x SDK durante dotnet pack. Resolvido em 10.2.2 via RestoreEnablePackagePruning=false (entrada dedicada no [10.2.2] abaixo). Consumidores de 10.2.0/10.2.1 devem atualizar para 10.2.2+ e remover pin defensivo local.

Removed (Breaking)

• Behaviors/NormalizeDateTimeOffsetBehavior removido. Pipeline de behaviors passa a ser Logging → Validation (Normalize não é mais registrado por AddDevPackBehaviors()). Com a migração de auditoria para AuditTimestamp (UTC + IANA), o behavior perdeu razão de existir. Projetos que precisem de normalização de fuso em campos de request devem implementar comportamento próprio na camada de aplicação.
• Attributes/NormalizeDateTimeOffsetAttribute removido. Era consumido apenas pelo behavior removido.
• Domain/IAuditable: contrato reescrito em torno de AuditTimestamp.
  • Removidas: Created (DateTimeOffset), LastModified (DateTimeOffset?), LastModifiedBy (string?), SetCreatedProperties(string, DateTimeOffset), SetUpdatedProperties(string, DateTimeOffset).
  • Adicionadas / renomeadas: CreatedAt (AuditTimestamp), UpdatedAt (AuditTimestamp?), ModifiedBy (string? — renomeado de LastModifiedBy), SetCreatedAudit(string?, AuditTimestamp), SetUpdatedAudit(string?, AuditTimestamp).
  • Atribuição de usuário preservada (CreatedBy permanece, LastModifiedBy renomeado para ModifiedBy).
• Domain/AuditedEntity / AuditedEntity<TKey>: campos públicos migrados conforme IAuditable.
• Domain/ISoftDeletable: contrato reescrito em torno de AuditTimestamp.
  • Removidas: DeletedOnUtc (DateTimeOffset?), SoftDelete(string, DateTimeOffset).
  • Adicionada / mantida: DeletedAt (AuditTimestamp?), DeletedBy (string?, mantido), SoftDelete(string?, AuditTimestamp).
• Domain/AuditedSoftDeletableEntity<TKey>: ajustado ao novo ISoftDeletable.
• Identity/BaseIdentityUser: ajustado ao novo IAuditable/ISoftDeletable. Mesmas migrações de tipo. LastModifiedBy → ModifiedBy.
• Identity/BaseIdentityRole: ajustado ao novo IAuditable. Mesmas migrações.
• Infrastructure/EfCore/Interceptors/AuditableEntityInterceptor: construtor reescrito.
  • Antes: (ICurrentUser currentUser, TimeProvider dateTime).
  • Depois: (IServiceProvider serviceProvider). Resolve ICurrentUser por chamada via IServiceProvider.CreateScope() — evita captura de scoped service em singleton interceptor. Constrói uma AuditTimestamp com DateTime.UtcNow + currentUser?.LocalTimeZone e popula CreatedBy/ModifiedBy com currentUser?.UserName.
• Infrastructure/EfCore/Interceptors/SoftDeleteInterceptor: construtor reescrito.
  • Antes: (ICurrentUser currentUser, TimeProvider dateTime).
  • Depois: (IServiceProvider serviceProvider, TimeProvider dateTime). Mesmo padrão de scope-por-chamada; preserva DeletedBy no entity via currentUser?.UserName.

Added

• Domain/AuditTimestamp — value object record (DateTime UtcDateTime, string? LocalTimeZone) que encapsula o par "instante UTC + IANA timezone". Cada propriedade de auditoria (CreatedAt, UpdatedAt, DeletedAt) carrega seu próprio AuditTimestamp — criação, atualização e deleção podem ocorrer em fusos diferentes e ficam independentemente reconstruíveis. Métodos: AuditTimestamp.Now(string? localTimeZone) e ToLocal() que devolve DateTimeOffset aplicando a timezone (fallback silencioso para UTC se a timezone for desconhecida ao runtime). Anotado com [Owned] — EF Core auto-mapeia como propriedade owned (duas colunas por padrão: {Property}_UtcDateTime e {Property}_LocalTimeZone), sem configuração manual no consumidor para o caso comum.
• Authorization/IRolePermissionResolver — contrato para resolução de permissões a partir de role names.
• Authorization/RoleBasedPermissionEvaluator — implementação default de IPermissionEvaluator que combina ICurrentUser.UserRoles + IRolePermissionResolver. Cache por-instância (Scoped lifetime).
• Authorization/DevPackAuthorizationExtensions.AddDevPackRoleBasedPermissionEvaluator<TResolver>() — registration conveniente.
• Infrastructure/EfCore/DevPackEfCoreInterceptorBuilder + extension services.AddDevPackEfCoreInterceptors() — fluent builder para registrar interceptors EF Core. Suporta .WithAuditableEntityInterceptor(), .WithSoftDeleteInterceptor(), .WithDispatchDomainEventsInterceptor() e .WithInterceptor<TInterceptor>() para customizados. Cada interceptor é registrado como singleton sob dois canais: tipo concreto (para testes) e ISaveChangesInterceptor (consumido por AddDbContext via provider.GetServices<ISaveChangesInterceptor>()). A ordem de registro é preservada e determina a ordem de execução. Forma legada de registro manual continua suportada — adição não-quebrante.
• Abstractions/UtcDateTimeProvider — implementação default de IDateTimeProvider. Todos os 11 membros do contrato resolvem para UTC (system e user-local idênticos; UserTimeZone == TimeZoneInfo.Utc). Lifetime: Singleton. Indicado para hosts sem user context (workers, batch).
• Abstractions/LocalDateTimeProvider — implementação de IDateTimeProvider que converte UTC para ICurrentUser.LocalTimeZone (IANA) para os membros UserLocal*. Membros System* usam TimeProvider.GetLocalNow() (timezone do servidor). Fallback silencioso para UTC quando a timezone do usuário é null, vazio ou desconhecida ao runtime — nunca lança exceção. Lifetime: Scoped (depende de ICurrentUser).
• Abstractions/DateTimeProviderServiceCollectionExtensions — AddDevPackUtcDateTimeProvider() (Singleton) e AddDevPackLocalDateTimeProvider() (Scoped) para registro conveniente. Pré-requisito comum: services.AddSingleton(TimeProvider.System).

Migration notes

• Leituras de auditoria: substituir entity.Created (DateTimeOffset) por entity.CreatedAt.UtcDateTime (DateTime UTC) ou entity.CreatedAt.ToLocal() (DateTimeOffset reconstruído na timezone original). Mesmo padrão para LastModified → UpdatedAt, DeletedOnUtc → DeletedAt.
• Atribuição de usuário: CreatedBy e DeletedBy mantêm nome. LastModifiedBy foi renomeado para ModifiedBy — consumidores que liam entity.LastModifiedBy devem trocar para entity.ModifiedBy.
• Migrações EF:
  • Cada propriedade de auditoria vira duas colunas: {Name}_UtcDateTime (datetime2) e {Name}_LocalTimeZone (nvarchar(64), nullable). Por exemplo, CreatedAt se torna CreatedAt_UtcDateTime + CreatedAt_LocalTimeZone. Ajuste seu schema migration.
  • Para projetos que preferem coluna única por timestamp, é possível usar builder.Property(e => e.CreatedAt).HasConversion<string>(...) em OnModelCreating — perde queryability dos campos individuais.
• AuditableEntityInterceptor registro: continua sendo services.AddScoped<AuditableEntityInterceptor>() no DI — IServiceProvider é resolvido automaticamente. Sem mudança no chamador.
• SoftDeleteInterceptor registro: idem — services.AddScoped<SoftDeleteInterceptor>(). As dependências (IServiceProvider, TimeProvider) são resolvidas pelo DI. TimeProvider.System deve estar registrado (services.AddSingleton(TimeProvider.System)).
• Pipeline de behaviors: remover qualquer registro manual de NormalizeDateTimeOffsetBehavior se aplicável; AddDevPackBehaviors() cuida do par Logging → Validation automaticamente.
• Permissões role-based: substituir implementação custom de IPermissionEvaluator por services.AddDevPackRoleBasedPermissionEvaluator<MyRolePermissionResolver>() quando o caso de uso for "permissões via roles".

[2.1.1] - 2026-05-01

Fixed

• Data/QueryFilter: o operador contains agora emite (prop != null && prop.Contains(value)) em vez de prop.Contains(value). O comportamento anterior lançava NullReferenceException em LINQ-to-Objects quando a propriedade alvo era null — limitação documentada na 2.1.0 via o teste ParseFilter_StringContains_OnNullProperty_*. Em LINQ-to-EF Core o comportamento já era silencioso (SQL absorve NULL); o fix alinha as duas trilhas de execução. Inclui o operador composto [any] contains que usa o mesmo caminho.
• tests/.../Data/QueryFilterTests.cs: o teste ParseFilter_StringContains_OnNullProperty_ThrowsNullReferenceException foi renomeado para ParseFilter_StringContains_OnNullProperty_ShouldExcludeWithoutThrowing, refletindo o comportamento corrigido. O fixture passou a manter Bob.Notes = null para exercitar a null-safety em todos os cenários de contains.

[2.1.0] - 2026-05-01

Added

• tests/.../Helpers/PermissionsGeneratorTests.cs: 18 testes cobrindo BuildDictionary (classe plana, hierárquica, vazia, campos não-string), GenerateJson (outputs indented), GenerateTypeScriptUnion (flatten recursivo, filtro de empty values, default type name), GenerateTypeScriptShape (objeto literal, hierarquia, default name) e Generate (dispatch para cada modo).
• tests/.../Identity/MultiTenancy/TenantResolverTests.cs: 7 testes cobrindo o pipeline de contributors — sem contributors (Unresolved), resolução por TenantIdOrName, resolução por Handled flag, short-circuit do primeiro contributor que resolve, fallback para o segundo quando o primeiro não resolve, propagação de exceções e ordem de execução.
• tests/.../Data/QueryFilterTests.cs: 30 testes cobrindo todos os operadores DSL (eq, ne, gt, lt, ge, le, contains, in, [any] contains), composição com and/or, parênteses, propriedades aninhadas via dot notation, comparação contra null em propriedades nullable, e validação de inputs inválidos (formato, operador desconhecido, property inexistente). Inclui também um teste explícito que documenta uma limitação conhecida — ver seção abaixo.

Known limitations (documented by tests)

• Data/QueryFilter emite prop.Contains(value) sem null-guard. Em LINQ-to-Objects (uso in-memory ou em testes) isso lança NullReferenceException quando a propriedade tem valor null. Em LINQ-to-EF Core o comportamento é silencioso — o SQL gerado absorve NULL corretamente. Comportamento documentado no teste ParseFilter_StringContains_OnNullProperty_ThrowsNullReferenceException. Fix candidato (em release futura): emitir (prop != null && prop.Contains(value)) para alinhar comportamento in-memory e database.

[2.0.2] - 2026-05-01

Added

• Guards/ nova área dedicada com namespace ITLab.Template.DevPack.Guards. As classes ObjectGuards, DateTimeOffsetGuards e DateOnlyGuards foram extraídas de Extensions/GuardExtensions.cs (que era arquivo único com três classes coabitando) para arquivos individuais sob a nova pasta. Guards/README.md documenta a área seguindo o padrão das demais. DateOnlyGuards passa a estar documentada — não havia entrada anterior em README algum.

Changed

• (Breaking, cosmético) Namespace dos guards mudou de ITLab.Template.DevPack.Extensions para ITLab.Template.DevPack.Guards. Consumidores externos precisam adicionar using ITLab.Template.DevPack.Guards; em arquivos que usem Guard.Against.NotEqual(...), Guard.Against.MustBeQuarterHourRounded(...), Guard.Against.NotFirstDayOfMonth(...) etc. Aceito como patch pelo mesmo critério aplicado em 2.0.1: DevPack ainda não tem consumidores externos; correção pré-publicação ampla.
• (Breaking, cosmético) NameValue.cs movido da raiz de src/ para Dtos/NameValue.cs; namespace atualizado de ITLab.Template.DevPack para ITLab.Template.DevPack.Dtos. Mesma justificativa do bullet anterior. Dtos/README.md agora lista NameValue e NameValue<T>.
• Helpers/README.md: corrigidos EPermissionsGeneratorType modos (Json/TsUnion/TsShape em vez de Flat/Hierarchical/FlatWithPrefix), exemplo de PermissionsGenerator reescrito sobre Generate(...) real, e adicionada nota explicando que DateTimeOffsetHelper coabita em DateTimeHelper.cs (mesmo namespace Helpers).
• Dtos/README.md: tabela de Componentes ampliada para listar OptionDto<TValue>, OptionDto<TValue, TAdditional>, GenericKeyValueDto<TValue> e GenericKeyValueDto<TValue, TAdditional> (anteriormente omitidos), além de separar BaseKeyValueDto em variantes <TValue> e <TValue, TAdditional>. Anotada a divergência arquivo↔classe ScheduledJobConfig × ScheduledJobConfiguration.cs.
• Notifications/README.md: snippet sinaliza explicitamente que INotificationService é contrato do consumidor, não do DevPack; adicionado bullet em "O que NÃO faz".
• Identity/MultiTenancy/README.md: snippet final reescrito — currentUser.SetTenant(...) não existe; adapter de aplicação do tenant (claim, accessor custom, etc.) é responsabilidade do consumidor.
• Infrastructure/README.md e Infrastructure/EfCore/README.md: nota de navegação destacando que são containers para sub-namespaces, com link direto para o nível com conteúdo real.
• Extensions/README.md: removidas entradas de ObjectGuards e DateTimeOffsetGuards da tabela de Componentes (movidas para Guards/); nota cross-reference adicionada.
• DEVPACK.md: nova entrada para ITLab.Template.DevPack.Guards no mapa de namespaces.
• README.md raiz: inventário de READMEs reflete Guards/README.md.

Removed

• Extensions/GuardExtensions.cs: substituído por três arquivos sob Guards/.
• src/ITLab.Template.DevPack/NameValue.cs da raiz: movido para Dtos/.
• Directory.Packages.props: removidas pinagens dead de ClosedXML e SendGrid (pacotes haviam sido removidos do .csproj em 2.0.0).
• tests/ITLab.Template.DevPack.Tests/Inspector.cs: teste exploratório com try/catch silencioso. Tinha um [Fact] FinalInspect que sempre passava sem assertions úteis (carregava Asp.Versioning.Http em try { } catch { }). Sua remoção reduz a contagem de testes em 1 (de 458 para 457) — sem perda de cobertura efetiva, já que o teste não verificava nada.
• script.cs na raiz do repositório: código exploratório referenciando pacotes removidos (Swashbuckle.AspNetCore, Asp.Versioning.ApiExplorer). Não estava em qualquer slnx/csproj.
• docs/devpack-inventory.md interno (snapshot pré-Fase 0): conteúdo substituído por pointer ao inventário canônico mantido fora do repositório do DevPack.

[2.0.1] - 2026-05-01

Changed (Breaking)

• Namespace ITLab.Template.DevPack.Mediator renomeado para ITLab.Template.DevPack.Cqrs. A pasta src/ITLab.Template.DevPack/Mediator/ foi movida para src/ITLab.Template.DevPack/Cqrs/. Nenhum tipo público teve nome alterado (ICommand, IQuery, ICommandHandler, IQueryHandler, INotificationEvent, IMediatorHandler, MediatorHandler).

  Motivação: o nome anterior colidia visualmente com o namespace raiz Mediator (martinothamar). Quando um arquivo do consumidor importava ambos, o IntelliSense mostrava dois ICommand/IQuery/INotification (um nosso, um da biblioteca), gerando ambiguidade prejudicial — especialmente para agentes de IA. A escolha alternativa "Messaging" foi descartada porque o DevPack já tem uma pasta Messaging/ reservada para integração com message broker (Service Bus). O termo "Cqrs" é específico, idiomático e sem colisão. Veja docs/adrs/002-rename-mediator-to-cqrs.md.

  Migração: substituir using ITLab.Template.DevPack.Mediator; por using ITLab.Template.DevPack.Cqrs; em todos os arquivos do consumidor. Não há mudança em assinaturas, comportamento ou dependências.

Changed

• DEVPACK.md, CLAUDE.md, README.md raiz e Cqrs/README.md atualizados para refletir o novo nome de namespace e a ausência de colisão com Mediator (martinothamar).
• Messaging/README.md reescrito: o anterior foi sobrescrito durante a tentativa intermediária de renomeação que conflitou com a pasta existente; o conteúdo novo segue o mesmo padrão das outras áreas e descreve EMessageDisposition, MessageHandlingResult e MessagingErrors.

Fixed

• Helpers/DomainEventHelper.TrySetTenantId: removido type check tautológico (is not IDomainEvent) e variável local de nome enganoso (multiTenantEntity), herdados de copy-paste do gêmeo EntityHelper.TrySetTenantId(IEntity). O comportamento funcional permanece idêntico — o código sempre executou o caminho feliz; a estrutura apenas escondia um null guard sob pattern matching desnecessário, gerando confusão sobre a intenção do método. Adicionado null check explícito via ArgumentNullException.ThrowIfNull e cobertura em DomainEventHelperTests (4 cenários: contexto sem usuário, tenant igual, tenant diferente, argumento nulo).

[2.0.0] — Phase 0 — Foundational refactor

This release replaces the foundational libraries to align the DevPack with the state-of-the-art .NET 10 stack. Each substitution is a clean cut: the previous library is removed entirely. There is no transition window. Consumers must migrate in one step.

Added

• Mediator.Abstractions 3.0.2 (Mediator by martinothamar) replaces MediatR. Source-generated CQRS dispatch with ValueTask everywhere.
• Authorization/ directory: new policy-based permission system.
  • IPermissionEvaluator — agnostic permission resolution contract.
  • PermissionAuthorizationRequirement, PermissionAuthorizationHandler, PermissionAuthorizationPolicyProvider — ASP.NET Core authorization plumbing for dynamic permission policies (RequireAuthorization("Pedidos.Create")).
  • RequiresPermissionAttribute — declarative permission marker for Commands and Queries (multiple form an AND).
  • AuthorizationBehavior<TRequest, TResponse> — mediator pipeline behavior that enforces [RequiresPermission] before the handler runs, with per-type reflection cache.
  • DevPackAuthorizationExtensions.AddDevPackAuthorization() — DI registration helper.
• Authorization/README.md — full area documentation with usage example, dual endpoint+behavior convention, naming convention.
• Behaviors/DevPackBehaviorsExtensions.cs and AddDevPackBehaviors() extension — registers the trio Logging → Validation → Normalize in the recommended order.

Changed

• Mediator/ICommand, ICommand<TResponse>, ICommandHandler<...>, IQuery<TResponse>, IQueryHandler<TQuery, TResponse>, INotificationEvent, IMediatorHandler, MediatorHandler rewritten on top of Mediator (martinothamar). Public type names preserved.
• Breaking: handler Handle signatures now return ValueTask<TResponse> instead of Task<TResponse>. Pipeline next delegate is now MessageHandlerDelegate<TMessage, TResponse> taking (message, ct) instead of RequestHandlerDelegate<TResponse> taking ().
• Breaking: IMediatorHandler.PublishEvent<T> returns ValueTask instead of Task and accepts a CancellationToken parameter.
• Breaking: MediatorHandler constructor takes Mediator.IPublisher instead of MediatR.IMediator.
• Domain/IDomainEvent now extends Mediator.INotification instead of MediatR.INotification. Public surface preserved.
• Infrastructure/EfCore/Interceptors/DispatchDomainEventsInterceptor constructor takes Mediator.IPublisher. DispatchDomainEvents returns ValueTask and accepts a CancellationToken.
• Behaviors/ValidationPipelineBehavior, RequestLoggingPipelineBehavior, NormalizeDateTimeOffsetBehavior rewritten on top of Mediator.IPipelineBehavior<,>. Behavior semantics preserved.
• CoreConsts.cs moved to CoreConsts/CoreConsts.cs to align with the per-area subdirectory convention; namespace unchanged.
• Identity/README.md: added BaseIdentityUser, BaseIdentityRole, CurrentUserExtensions, and IdentityProviderName to the Componentes table.
• Data/README.md: added QueryFilter to the Componentes table and a usage example.
• PackageTags: replaced mediatr with mediator.

Removed

• MediatR NuGet dependency.
• MediatR.Contracts NuGet dependency.
• MagicMapper NuGet dependency. The DevPack no longer ships any mapping infrastructure; products use Mapperly or hand-written extension methods.
• Data/GroupConverter<T> (the AutoMapper.ITypeConverter adapter for grouped query results). It was not consumed by GroupableList<T> — server-side grouping is implemented in GroupableList<T> via reflection over dynamic LINQ projections.
• Data/GroupKey.SplitGroup constant — only consumed by the removed GroupConverter<T>.
• Swagger/ directory and the ConfigureSwaggerOptions and SwaggerDefaultValuesFilter types. Consumers must migrate to Microsoft.AspNetCore.OpenApi and a UI of choice (e.g. Scalar.AspNetCore).
• Extensions/SwaggerExtensions.cs and the UseSwaggerAndUI helper: replaced by direct MapOpenApi() / MapScalarApiReference() calls in consumer projects.
• Swashbuckle.AspNetCore NuGet dependency.
• Asp.Versioning.Mvc and Asp.Versioning.Mvc.ApiExplorer NuGet dependencies. Consumers needing API versioning on Minimal APIs can install Asp.Versioning.Http directly.
• ClosedXML NuGet dependency: no public types or internal usage found; removed to reduce package footprint.
• SendGrid NuGet dependency: no public types or internal usage found; removed to reduce package footprint.

Migration notes for consumers

• Replace using MediatR; with using Mediator; in endpoint code that injects the mediator. Handler files and command/query records use using ITLab.Template.DevPack.Cqrs; (renamed from .Mediator in 2.0.1) for the wrappers.
• Replace services.AddMediatR(typeof(...)) with services.AddMediator(opt => opt.Namespace = "MyApp.Mediator";) from the Mediator.SourceGenerator package (added in the consumer project, not in the DevPack).
• Replace services.AddSingleton(typeof(IPipelineBehavior<,>), typeof(...)) calls with services.AddDevPackBehaviors().
• Replace Task<TResponse> handler return types with ValueTask<TResponse>.
• Adapt pipeline behavior implementations to IPipelineBehavior<TMessage, TResponse> from Mediator namespace, with where TMessage : IMessage constraint and MessageHandlerDelegate<TMessage, TResponse> for the next delegate.
• For mapping, replace AutoMapper/MagicMapper usage with Mapperly ([Mapper] partial classes) or hand-written extension methods.
• For OpenAPI, replace services.AddSwaggerGen() / app.UseSwagger() / app.UseSwaggerUI() with services.AddOpenApi() / app.MapOpenApi() / app.MapScalarApiReference() (the latter requires the Scalar.AspNetCore NuGet package).
• For permissions, register IPermissionEvaluator (your implementation) and call services.AddDevPackAuthorization().

[1.0.0] - 2026-04-23

Added

• Initial release