Kogoshvili.Temporal

A suite of static-analysis tooling and libraries for the Temporal .NET SDK. It catches non-deterministic code and SDK feature-misuse in your workflows before they hit production replay bugs, and ships libraries for building and operating Temporal workers.

Packages

Two tools, one rule engine:

• Kogoshvili.Temporal.Analyzers — a Roslyn analyzer package that plugs into dotnet build, Visual Studio, and Rider.
• Kogoshvili.Temporal.Cli — a standalone CLI (dotnet tool, invoked as temporal-sharp) for CI pipelines: analyze, map, history, docs, and preset.

Six libraries for building and operating Temporal workers:

• Kogoshvili.Temporal.Hosting — a generic-host worker starter: config binding, convention-based workflow/activity auto-discovery, a shared DataConverter (encryption + claim-check), metrics, and a test-server toggle.
• Kogoshvili.Temporal.Codec — composable payload codecs (AES-GCM encryption, claim-check offloading, ordered chains, per-field Secret<T> encryption).
• Kogoshvili.Temporal.CodecServer — a ready-made HTTP codec server for the Web UI/CLI, with JWT-bearer and OAuth2 authorization-code auth.
• Kogoshvili.Temporal.Cloud — Azure/AWS credential resolution, Blob/S3 claim-check stores, and TLS certificate sources (Key Vault / Secrets Manager).
• Kogoshvili.Temporal.Configuration — shared connection config (loads a TemporalClient from appsettings.json / Temporal__* env vars).
• Kogoshvili.Temporal.Testing — a replay/regression harness built on WorkflowReplayer.

See RULES.md for the full rule catalog, and samples/ for runnable demos of the hosting starter and codec server.

Templates

Install project templates for a ready-to-run start:

dotnet new install Kogoshvili.Temporal.Templates
dotnet new temporal-codec-server -o MyCodecServer   # a codec server for the Web UI/CLI

See templates/ for the full template catalog.

Install

dotnet add package Kogoshvili.Temporal.Analyzers   # analyzer, via NuGet
dotnet tool install -g Kogoshvili.Temporal.Cli     # CLI, invoked as `temporal-sharp`

Each package has its own README covering its configuration and usage — see the links above.

License

MIT

---

Not affiliated with or endorsed by Temporal Technologies.