Prepare Esiur 3.1.0 package release and validate solution builds

.github/workflows/ci.yml

@@ -34,7 +34,7 @@ jobs:
         shell: pwsh
         run: |
           dotnet pack Tools/Esiur.CLI/Esiur.CLI.csproj --configuration Release --no-build --no-restore --output artifacts/nuget
-          dotnet tool install Esiur.CLI --version 3.0.0 --tool-path artifacts/tool --add-source artifacts/nuget
+          dotnet tool install Esiur.CLI --version 3.1.0 --tool-path artifacts/tool --add-source artifacts/nuget
           & ./artifacts/tool/esiur.exe version
           & ./artifacts/tool/esiur.exe --help
 

CHANGELOG.md

@@ -0,0 +1,28 @@
+# Release notes
+
+## 3.1.0
+
+- Add generation/revision cursors, resource journals, historical subscriptions,
+  and reconnect replay for live properties and events.
+- Improve dynamic resource/type definition handling and concurrent attachment
+  behavior, with cross-runtime conformance coverage.
+- Negotiate and enforce remote parser, allocation, collection, metadata-depth,
+  and encrypted-record limits.
+- Add opt-in EP connection diagnostics for traffic, queues, and resource state.
+- Standardize the default EP port at 51018 when no explicit port is supplied.
+- Update the ASP.NET Core adapter and add journal support to EntityCore.
+- Release the adapters, stores, and CLI as 3.1.0 with an Esiur 3.1.0 dependency;
+  previously published 3.0.x packages are not overwritten.
+- Correct the standalone example's endpoint display and exclude nested/stale
+  build outputs when building with an external artifacts directory.
+
+### Compatibility and publishing
+
+Use matching 3.1 runtimes when using journals, replay, or negotiated limits.
+Keep explicit endpoint ports where an installation does not use port 51018.
+Existing .NET target frameworks are unchanged.
+
+Publish `Esiur.3.1.0.nupkg` first, then `Esiur.AspNetCore`,
+`Esiur.Stores.EntityCore`, `Esiur.Stores.MongoDB`, and `Esiur.CLI` 3.1.0.
+The core security/cryptography project and test/example projects are not
+standalone NuGet products.

Directory.Build.props

@@ -1,4 +1,9 @@
 <Project>
+  <PropertyGroup>
+    <!-- Keep stale and nested SDK outputs out of source globs, including when
+         a release uses an artifacts path outside the checkout. -->
+    <DefaultItemExcludes>$(DefaultItemExcludes);**/bin/**;**/obj/**</DefaultItemExcludes>
+  </PropertyGroup>
   <!-- Test and example executables are repository assets, not NuGet products. -->
   <PropertyGroup Condition="$([System.String]::Copy('$(MSBuildProjectDirectory)').StartsWith('$(MSBuildThisFileDirectory)Tests')) Or $([System.String]::Copy('$(MSBuildProjectDirectory)').StartsWith('$(MSBuildThisFileDirectory)Examples'))">
     <IsPackable>false</IsPackable>

Examples/StandaloneWebServer/Program.cs

@@ -86,7 +86,7 @@ internal class Program
         // Start your server
         await wh.Open();
 
-        Console.WriteLine($"Running on http://localhost:8888/?epPort={epPort}");
+        Console.WriteLine($"Running on http://localhost:8888/?epPort={esiurServer.Port}");
 
     }
 }

Integrations/Esiur.AspNetCore/Esiur.AspNetCore.csproj

@@ -5,7 +5,7 @@
 		<Copyright>Ahmed Kh. Zamil</Copyright>
 		<PackageProjectUrl>https://www.esiur.com</PackageProjectUrl>
 		<GeneratePackageOnBuild>true</GeneratePackageOnBuild>
-		<Version>3.0.0</Version>
+		<Version>3.1.0</Version>
 		<Authors>Ahmed Kh. Zamil</Authors>
 		<Company>Esiur Foundation</Company>
 

README.md

@@ -50,13 +50,13 @@ newer toolchain, such as .NET SDK 8 or newer. Building this repository requires
 For an ASP.NET Core service:
 
 ```shell
-dotnet add package Esiur.AspNetCore --version 3.0.0
+dotnet add package Esiur.AspNetCore --version 3.1.0
 ```
 
 For the standalone runtime or a client:
 
 ```shell
-dotnet add package Esiur --version 3.0.1
+dotnet add package Esiur --version 3.1.0
 ```
 
 ## Define a resource
@@ -326,7 +326,7 @@ case-sensitive; v3 does not negotiate legacy aliases.
 with EF Core 10.
 
 ```shell
-dotnet add package Esiur.Stores.EntityCore --version 3.0.0
+dotnet add package Esiur.Stores.EntityCore --version 3.1.0
 dotnet add package Microsoft.EntityFrameworkCore.Sqlite --version 10.0.10
 ```
 

Stores/Esiur.Stores.EntityCore/Esiur.Stores.EntityCore.csproj

@@ -9,7 +9,7 @@
     <Product>Esiur Entity Framework Extension</Product>
     <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
     <PackageId>Esiur.Stores.EntityCore</PackageId>
-    <Version>3.0.0</Version>
+    <Version>3.1.0</Version>
 	<PackageReadmeFile>README.md</PackageReadmeFile>
 	<LangVersion>latest</LangVersion>
 	<PackageLicenseExpression>MIT</PackageLicenseExpression>

Stores/Esiur.Stores.EntityCore/README.md

@@ -6,7 +6,7 @@ with Entity Framework Core 10. Version 3.0 targets .NET 10.
 ## Installation
 
 ```shell
-dotnet add package Esiur.Stores.EntityCore --version 3.0.0
+dotnet add package Esiur.Stores.EntityCore --version 3.1.0
 dotnet add package Microsoft.EntityFrameworkCore.Sqlite --version 10.0.10
 ```
 

Stores/Esiur.Stores.MongoDB/Esiur.Stores.MongoDB.csproj

@@ -10,7 +10,7 @@
     <PackageProjectUrl>http://www.esiur.com</PackageProjectUrl>
     <RepositoryUrl>https://github.com/esiur/esiur-dotnet/</RepositoryUrl>
     <GeneratePackageOnBuild>True</GeneratePackageOnBuild>
-    <Version>3.0.0</Version>
+    <Version>3.1.0</Version>
     <PackageId>Esiur.Stores.MongoDB</PackageId>
 	<LangVersion>latest</LangVersion>
 	<PackageLicenseExpression>MIT</PackageLicenseExpression>

Tools/Esiur.CLI/CliApplication.cs

@@ -109,7 +109,7 @@ public sealed class CliApplication
     {
         EnsureEmpty(tokens);
         var assembly = typeof(CliApplication).Assembly.GetName();
-        await output.WriteLineAsync($"Esiur CLI {assembly.Version?.ToString(3) ?? "3.0.0"}");
+        await output.WriteLineAsync($"Esiur CLI {assembly.Version?.ToString(3) ?? "3.1.0"}");
         return ExitCodes.Success;
     }
 

Tools/Esiur.CLI/Esiur.CLI.csproj

@@ -3,7 +3,7 @@
   <PropertyGroup>
 	<Description>Esiur command-line tool</Description>
 	<Copyright>Ahmed Kh. Zamil</Copyright>
-	<Version>3.0.0</Version>
+	<Version>3.1.0</Version>
 	<PackageId>Esiur.CLI</PackageId>
 	<Authors>Ahmed Kh. Zamil</Authors>
 	<Company>Esiur Foundation</Company>