refactor(partitioning)!: type lifecycle events

[thomhurst]

Summary

• replace object-typed partition notifications with typed PartitionCreatedEvent and PartitionEvictedEvent payloads
• add key/result-aware PartitionedShieldOptions variants and update DI registration
• rename the idle eviction reason and metric tag to Expiration
• migrate tests, samples, docs, benchmarks, and generated API metadata

Validation

• dotnet build Kevlar.slnx -c Release --no-restore
• Kevlar.Tests net10.0: 1275 passed
• Kevlar.Tests net8.0: 1241 passed
• scripts/Verify-ApiDocs.ps1
• scripts/Verify-Docs.ps1
• scripts/Verify-DocSnippets.ps1 (199 snippets, with and without implicit usings)
• npm run build

Closes #327

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 4f048070-f077-4506-94dc-3edde23219c3

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}