test: cover execution overload contracts

[thomhurst]

Summary

• enumerate all 22 public execution overloads across Shield, Shield, and Task adapters
• enforce one shared contract for empty/non-empty pipelines, synchronous/deferred completion, synchronous/faulted failures, and outcome boundaries
• verify exact-once boundary invocation, caller-token identity, pre/mid-flight cancellation, unchanged state identity, original exception instance/stack, and exact null-guard parameter names
• make reflection fail when a future public execution overload is not added to the explicit contract catalog
• document the execution-overload contract

Closes #16

Validation

• dotnet build Kevlar.slnx -c Release (0 warnings)
• dotnet run --project tests/Kevlar.Tests -c Release --no-build -- --timeout 5m (345 passed)
• full unit suite repeated 10 times (all passed)
• dotnet run --project tests/Kevlar.IntegrationTests -c Release --no-build -- --timeout 5m (16 passed)
• dotnet run --project tests/Kevlar.Analyzers.Tests -c Release --no-build -- --timeout 5m (19 passed)
• dotnet run --project tests/Kevlar.NetStandard.Tests -c Release --no-build -- --timeout 5m (1 passed)
• npm run build from docs/

[coderabbitai]

Warning

Review limit reached

@thomhurst, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 21 seconds

Limit details: You’ve used all 10 included reviews currently available.

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

Wait for the limit to reset, then comment @coderabbitai review or push new commits to the PR.

An organization admin can change what happens after included review limits in Billing.

How do review limits work?

CodeRabbit enforces per-developer PR review limits within each organization.

For paid Pro and Pro+ reviews, CodeRabbit uses a developer's included PR review attempts over the past 7 days to set the current hourly allowance. At typical activity levels, the full plan allowance applies. Higher sustained activity can lower the allowance until earlier attempts leave the 7-day window.

Please refer docs for additional details.

Review details

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 2a20f617-11f1-4bb0-bd19-504eb46d3cb4

📥 Commits

Reviewing files that changed from the base of the PR and between e540c19 and 10f06ca.

📒 Files selected for processing (2)

• docs/docs/executing.md
• tests/Kevlar.Tests/ExecutionOverloadContractTests.cs

---

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

[greptile-apps]

Greptile Summary

This PR documents the execution-overload contract and adds comprehensive contract tests across typed and untyped shields, synchronous and asynchronous execution, state-passing overloads, and Task adapters.

• Catalogs all 22 public execution overloads and detects uncatalogued additions through reflection.
• Verifies success, deferred completion, failure, cancellation, state identity, null guards, and outcome behavior.
• Qualifies exception and cancellation identity guarantees for timeout and hedging strategies.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains; the previous documentation issue is addressed by limiting identity preservation to empty or pass-through execution and explicitly documenting linked tokens and timeout exception transformation.

Important Files Changed

Filename	Overview
docs/docs/executing.md	Documents overload guarantees while correctly distinguishing pass-through behavior from timeout and hedging transformations.
tests/Kevlar.Tests/ExecutionOverloadContractTests.cs	Adds broad reflection-backed contract coverage for all public execution overloads and their boundary behavior.

_{Reviews (2): Last reviewed commit: "docs: qualify execution parity" | Re-trigger Greptile}