ChokaQ 0.1.0-preview.1 Release Notes

This is the first public NuGet preview of ChokaQ.

Package Shape

Install target for consumers:

ChokaQ

The top-level package is the only package a normal application should install. It depends directly or transitively on these runtime packages:

• ChokaQ.Abstractions
• ChokaQ.Core
• ChokaQ.Storage.SqlServer
• ChokaQ.TheDeck

This keeps the user install experience centered on one package while preserving the repository's internal engineering boundaries.

Guarantees

• At-least-once execution, not exactly-once external side effects.
• SQL Server mode is the durable production path.
• Worker-owned state transitions protect against stale finalization.
• Fetched abandoned work can return to Pending.
• Processing zombies move to DLQ for operator review.
• Retry attempts and retry wall-clock lifetime are enforced separately.
• Type keys are persisted message-contract names.
• Payload and metadata limits are validated before storage mutation.
• Idempotency middleware uses claim-state semantics for active duplicate keys.

Preview Limitations

• In-memory mode is non-durable and process-local.
• In-memory mode can leave orphaned Hot rows after process crash.
• In-memory restart can resurrect a row before channel requeue; failures are logged/reported but not recovered across process restart.
• Adaptive autoscaling is guidance only.
• Typed idempotency result replay is not included.
• Public retry strategy plugins and per-queue retry lifetime overrides are deferred.

Validation Gates

Required before publish:

dotnet build ChokaQ.sln --no-restore
dotnet test ChokaQ.sln --no-restore --filter "FullyQualifiedName!~Integration"
dotnet test ChokaQ.sln --no-restore --filter "Category=Integration"
npm --prefix docs run docs:build
dotnet pack src\ChokaQ.Abstractions\ChokaQ.Abstractions.csproj --configuration Release --no-restore -o artifacts\packages
dotnet pack src\ChokaQ.Core\ChokaQ.Core.csproj --configuration Release --no-restore -o artifacts\packages
dotnet pack src\ChokaQ.Storage.SqlServer\ChokaQ.Storage.SqlServer.csproj --configuration Release --no-restore -o artifacts\packages
dotnet pack src\ChokaQ.TheDeck\ChokaQ.TheDeck.csproj --configuration Release --no-restore -o artifacts\packages
dotnet pack src\ChokaQ\ChokaQ.csproj --configuration Release --no-restore -o artifacts\packages

The package-consumer smoke is samples/ChokaQ.Sample.NuGetLab. It installs ChokaQ from a NuGet feed without source project references and runs a SQL-backed lab that exercises The Deck, health checks, idempotency, delayed jobs, retry/failure paths, queue controls, and worker scaling.

Operator Documentation

The preview docs include operator-facing pages that explain how to interpret ChokaQ's signals:

• SLOs And Alerts defines default objectives, alert candidates, metric usage, dashboard panels, and environment-specific threshold tuning.
• Operations Runbooks walks through queue lag, DLQ spikes, worker-health failures, SQL storage failures, throttled dependencies, payload defects, bulk recovery, and state-transition conflicts.
• Local NuGet Lab documents the package-consumer smoke app and the scenarios used to validate the top-level ChokaQ package.