NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet, #1326 most downloaded on NuGet
Foundational helpers and command line support used by JasperFx and the Critter Stack projects
Latest stable
2.102.0
Last release 13 days ago
09 Nov 2026
Ships on a steady schedule
a new release about every 8 days
Most releases are documented
notes for 52 of the last 60 stable releases
3 versions withdrawn
withdrawn after publishing
127 years old
276 releases · first in 1900
Drag across the ruler to compare, or tap a release to open it.
Sorry, catching up on changes. This release was a random collection of source generator or code generation issues found in combination w/ a JasperFx c
Sorry, catching up on changes. This release was a random collection of source generator or code generation issues found in combination w/ a JasperFx client codebase after the big Wolverine 6.0 release
Full Changelog: https://github.com/JasperFx/jasperfx/compare/2.0.0...V2.2.1
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
The foundational release for the Critter Stack 2026 wave. JasperFx 2.0 is the shared base that Marten 9, Wolverine 6, Polecat 4, and Weasel 9 build on
The foundational release for the Critter Stack 2026 wave. JasperFx 2.0 is the shared base that Marten 9, Wolverine 6, Polecat 4, and Weasel 9 build on.
| Package | Version |
|---|---|
JasperFx |
2.0.0 |
JasperFx.Events |
2.0.0 |
JasperFx.Events.SourceGenerator |
2.0.0 |
JasperFx.SourceGenerator |
2.0.0 |
JasperFx.SourceGeneration |
2.0.0 |
JasperFx.RuntimeCompiler |
5.0.0 (5.x line — the active continuation of the 4.x lineage; separate from the foundation 2.0.x line) |
JasperFx and JasperFx.Events ship IsAotCompatible=true with annotated reflective surfaces.JasperFx.RuntimeCompiler package via the new ITypeLoader abstraction. Apps publishing in Static TypeLoadMode omit it and the trimmer drops Roslyn entirely.JasperFx.Events.SourceGenerator (aggregate projection dispatch — FEC-free), JasperFx.SourceGenerator (OptionsDescription without reflection), JasperFx.SourceGeneration (CLI command discovery without assembly scanning).docs/codegen/aot.md.GenericFactoryCache delegate caching for per-type generic instantiation hot paths.GenerationRules.Clone + deterministic codegen ordering (byte-stable pre-generated output).JasperFx.Events — IProjectionDistributor / IProjectionSet / IProjectionDatabase, the Solo / SingleTenant / MultiTenanted distributor concretes, IAdvisoryLock, and projection lifecycle/sharding contracts — so Marten 9 and Polecat 4 converge on a single definition.net9.0;net10.0 (net8.0 dropped). Source-generator projects target netstandard2.0.Master plans: #215 (JasperFx 2.0) and #216 (JasperFx.Events 2.0) — both complete.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Update NUKE to version 10 and Spectre.Console to 0.55.0 by @lahma in https://github.com/JasperFx/jasperfx/pull/184
Full Changelog: https://github.com/JasperFx/jasperfx/compare/JasperFx.1.24.1...JasperFx.Events.1.28.1
JasperFx.Events 1.29.0: per-message metadata on side-effect PublishMessage by @jeremydmiller in https://github.com/JasperFx/jasperfx/pull/186
Full Changelog: https://github.com/JasperFx/jasperfx/compare/JasperFx.Events.1.28.1...JasperFx.1.28
Nothing published for this version
Avoid vulnerable System.Text.Json 8.0.0-8.0.4 by @dmytro-pryvedeniuk in https://github.com/JasperFx/jasperfx/pull/171
Full Changelog: https://github.com/JasperFx/jasperfx/compare/JasperFx.1.21.1.JasperFx.Events.1.24.1...JasperFx.Events.1.26
Released April 2026.
JasperFx.Descriptors[DescribeAsConfigurationState] — show whether a property was configuredFor properties whose value is opaque or sensitive but whose configured-ness
is diagnostically meaningful, apply this attribute to render the property as
either "Configured" (when the value is non-null) or "Default" (when the
value is null).
[DescribeAsConfigurationState]
public Func<IWolverineRuntime, AWSCredentials>? CredentialSource { get; set; }
In the rendered OptionsDescription the property shows as a plain Text value
of "Configured" or "Default" rather than as a raw delegate pointer, which
is uninformative at best and misleading at worst.
This is the preferred rendering for delegate-valued hooks such as credential providers, naming selectors, and customization callbacks that are either present or absent.
None. The new attribute is purely additive — properties without it continue through the existing reflection rules.
Extends the OptionsDescription rendering system so that downstream Critter Stack projects can describe complex properties (policies, rule sets, subscr
Released April 2026.
Extends the OptionsDescription rendering system so that downstream Critter Stack
projects can describe complex properties (policies, rule sets, subscriptions) as
a human-readable StringArray rather than falling back to a raw ToString() or
being skipped entirely.
JasperFx.DescriptorsIOptionsValueAsStringArray — opt-in string array renderingA complex type that implements this interface controls how it appears in an
OptionsValue. The returned strings are joined for display and retained as the
raw value so consumers can render each entry individually.
public interface IOptionsValueAsStringArray
{
IReadOnlyList<string> ToOptionsValueStrings();
}
OptionsValue.WriteValue now checks for this interface after the built-in
Uri/TimeSpan/Type/Assembly branches and before the generic ToString()
fallback. The resulting OptionsValue has Type = PropertyType.StringArray and
a RawValue of string[].
Use this when your type is essentially a collection of human-readable items (failure rules, subscription lists, filter chains) and you want each entry to be individually inspectable without polluting the type with extra child descriptions.
[DescribeAsStringArray] — attribute-driven string array renderingFor cases where you don't own the type (or the enumerable itself doesn't warrant
its own dedicated interface), apply [DescribeAsStringArray] to any enumerable
property. OptionsDescription.readProperties will call ToString() on each
element and produce a single OptionsValue of type StringArray.
[DescribeAsStringArray]
public IReadOnlyList<Subscription> TopicSubscriptions => _subscriptions;
Without this attribute, non-string enumerable properties are skipped by the reflection walker.
None. Both additions are purely additive:
IOptionsValueAsStringArray continue through the existing
ToString() fallback in OptionsValue.WriteValue.[DescribeAsStringArray] continue to be skipped when their
type is a non-string enumerable.Fix missing null check in TryBuildPlan for unresolvable dependencies — When the DefaultValuePlan support was added in 1.24.0, a null check (dependenci
dependencies.Any(x => x == null)) was accidentally removed from the dependency validation in ConstructorPlan.TryBuildPlan. This caused handlers with unresolvable interface dependencies (not registered in DI) to throw ArgumentOutOfRangeException: Missing dependencies instead of being gracefully handled as InvalidPlan. This broke Wolverine's Marten and EF Core test suites. (#183)The JasperFx.SourceGeneration package now includes InputParserGenerator, a companion to the existing CommandDiscoveryGenerator. It generates optimized
The JasperFx.SourceGeneration package now includes InputParserGenerator, a companion to the existing CommandDiscoveryGenerator. It generates optimized ITokenHandler lists per input model type, eliminating runtime reflection from command parsing.
Benchmark Results (Apple M5 Max, .NET 9.0):
| Benchmark | Reflection | Generated | Speedup |
|---|---|---|---|
| BuildHandlers(DescribeInput) | 3,067 ns / 2,369 B | 0.86 ns / 0 B | ~3,600x |
| BuildHandlers(ResourceInput) | 8,508 ns / 11,698 B | 0.93 ns / 0 B | ~9,200x |
Generated handlers use pre-computed FlagAliases, direct property assignment delegates, and inlined type converters. Falls back to reflection-based parsing when no generated parser exists.
Types with default-valued constructor parameters (e.g., MyDbContext(DbContextOptions options, bool isUnfiltered = false)) now resolve correctly in the ServiceContainer. Previously, primitive parameters with defaults were rejected by ConstructorPlan even though they don't need DI resolution.
The check-env command now discovers and runs all registered IHealthCheck implementations automatically. Health check results map to: Healthy=success, Degraded=success (with warning), Unhealthy=failure. New CheckEnvironmentHealthCheck<T>() extension method for explicit registration.
New IDaemonWakeup and IHighWaterWakeup interfaces allow the async daemon's polling loop to be awakened immediately when new events are appended (e.g., via database notifications), instead of relying solely on periodic polling. Default behavior unchanged. Contributed by @thuijer.
| Package | Version |
|---|---|
| JasperFx | 1.24.0 |
| JasperFx.Events | 1.27.0 |
| JasperFx.SourceGeneration | 1.1.0 |
| JasperFx.SourceGenerator | 1.1.0 |
| JasperFx.Events.SourceGenerator | 1.5.0 |
| JasperFx.RuntimeCompiler | 4.4.0 (unchanged) |
Full Changelog: https://github.com/JasperFx/jasperfx/compare/JasperFx.Events.1.23...JasperFx.1.24
Nothing published for this version
Changes for CritterWatch by @jeremydmiller in https://github.com/JasperFx/jasperfx/pull/161
Full Changelog: https://github.com/JasperFx/jasperfx/compare/JasperFx.Events.1.22...JasperFx.Events.1.23
Fix EnrichEventsAsync override rejected with conventional Apply/Create by @marcpiechura in https://github.com/JasperFx/jasperfx/pull/159
Full Changelog: https://github.com/JasperFx/jasperfx/compare/JasperFx.1.20...JasperFx.Events.1.22
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Make composite projections play well with multi-tenancy by @erdtsieck in https://github.com/JasperFx/jasperfx/pull/148
Full Changelog: https://github.com/JasperFx/jasperfx/compare/JasperFx.Events.1.18...JasperFx.Events.1.21
Fix Wolverine distribution for versioned composite projections by @erdtsieck in https://github.com/JasperFx/jasperfx/pull/157
Full Changelog: https://github.com/JasperFx/jasperfx/compare/JasperFx.Events.1.21...JasperFx.1.20
Nothing published for this version
Timeout and improved visibility into failures with CatchUpAsync by @jeremydmiller in https://github.com/JasperFx/jasperfx/pull/147
Full Changelog: https://github.com/JasperFx/jasperfx/compare/V1.17...JasperFx.Events.1.18
Nothing published for this version
Nothing published for this version
Change for Marten to override slicer creation by @jeremydmiller in https://github.com/JasperFx/jasperfx/pull/139
Full Changelog: https://github.com/JasperFx/jasperfx/compare/V1.14...V1.17
Nothing published for this version
Nothing published for this version
Tearing down progression state after rebuilding Inline projections. B… by @jeremydmiller in https://github.com/JasperFx/jasperfx/pull/134
Full Changelog: https://github.com/JasperFx/jasperfx/compare/V1.13.0...V1.14
Support for explicitly overriding event metadata on an event by event basis by @jeremydmiller in https://github.com/JasperFx/jasperfx/pull/96
Full Changelog: https://github.com/JasperFx/jasperfx/compare/V1.4.0...V1.13.0
Nothing published for this version
Ensure metadata applies to immutable live aggregations by @Hawxy in https://github.com/JasperFx/jasperfx/pull/113
Full Changelog: https://github.com/JasperFx/jasperfx/compare/JasperFx.1.9.0...JasperFx.1.11.3
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Changes originating with CritterWatch work by @jeremydmiller in https://github.com/JasperFx/jasperfx/pull/111
Full Changelog: https://github.com/JasperFx/jasperfx/compare/JasperFx.1.7.0...JasperFx.Events.1.10
New codegen functionality for Wolverine to be able to specify that *some* services can be pulled from a scoped container
Full Changelog: https://github.com/JasperFx/jasperfx/compare/JasperFx.Events.1.10...JasperFx.1.9.0
New codegen functionality for Wolverine to be able to specify that some services can be pulled from a scoped container
Full Changelog: https://github.com/JasperFx/jasperfx/compare/JasperFx.Events.1.7.3...JasperFx.Events.1.9.0
Nothing published for this version
Nothing published for this version
Critter Watch related changes, new Introduced IMethodPreCompilationPolicy concept by @jeremydmiller in https://github.com/JasperFx/jasperfx/pull/109
Full Changelog: https://github.com/JasperFx/jasperfx/compare/JasperFx.Events.1.9.0...JasperFx.1.7.0
Nothing published for this version
Alternative event naming styles. JasperFx.Events 1.5 by @jeremydmiller in https://github.com/JasperFx/jasperfx/pull/97
Full Changelog: https://github.com/JasperFx/jasperfx/compare/Events.1.4...Events.1.6
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Support for explicitly overriding event metadata on an event by event basis by @jeremydmiller in https://github.com/JasperFx/jasperfx/pull/96
Full Changelog: https://github.com/JasperFx/jasperfx/compare/V1.4.0...Events.1.4
Full Changelog: https://github.com/JasperFx/jasperfx/compare/V1.3.1...V1.4.0
Fix DiagnosticSource binary compatibility with Lambda runtimes. by @Hawxy in https://github.com/JasperFx/jasperfx/pull/87
Full Changelog: https://github.com/JasperFx/jasperfx/compare/V1.2.2...V1.3.1
Nothing published for this version
One column per quarter.