ChokaQ 0.1.0-preview.1 Release Notes

Это первая public NuGet preview версия ChokaQ.

Package Shape

Install target для consumers:

ChokaQ

Top-level package - единственный package, который normal application should install. Он directly или transitively depends on runtime packages:

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

Это держит user install experience вокруг одного package, сохраняя internal engineering boundaries repository.

Guarantees

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

Preview Limitations

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

Package-consumer smoke - samples/ChokaQ.Sample.NuGetLab. Он installs ChokaQ из NuGet feed без source project references и запускает SQL-backed lab, проверяющий The Deck, health checks, idempotency, delayed jobs, retry/failure paths, queue controls и worker scaling.

Operator Documentation

Preview docs include operator-facing pages, объясняющие how to interpret ChokaQ signals:

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