From 8b5607d73cdf28a5c08765438aa6b5019adb9a0a Mon Sep 17 00:00:00 2001
From: Christopher Jolly <chris-jolly_au@hotmail.com>
Date: Wed, 19 Aug 2026 17:58:14 +0800
Subject: [PATCH 1/3] Docs and packaging for the EF Core 11 line

Version moves to 11.0.0-alpha.1, following the same step taken at the start of
the 9.x and 10.x lines: <major>.0.0 with the alpha label, progressing through
beta, rc and rtm from there. It was still on 10.0.1-servicing, so packages were
being produced under the previous line's version while depending on EF Core 11.

The readme is now packed into all four packages and referenced by
PackageReadmeFile, so nuget.org shows the full page - compatibility matrix,
requirements, getting started - rather than the one-line description. Its links
and badges are already absolute, so they render there.

README gains an 11.0.x row and moves 10.0.x to supported. CLAUDE.md records the
current version, that the tests are on xunit v3, and the matching AssemblyVersion
for a local EF Core build.

Also corrects EntityFramworkCore -> EntityFrameworkCore in the Jet.Data package
description.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 CLAUDE.md                                  | 4 ++--
 Directory.Build.props                      | 4 ++++
 Version.props                              | 6 +++---
 docs/README.md                             | 3 ++-
 src/EFCore.Jet.Data/EFCore.Jet.Data.csproj | 2 +-
 5 files changed, 12 insertions(+), 7 deletions(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index 7dc73268..262345dc 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -6,7 +6,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 EntityFrameworkCore.Jet is an EF Core provider for Microsoft Jet/ACE databases (Microsoft Access `.mdb`/`.accdb` files). It runs **Windows only** and bridges EF Core to the Access database engine via either ODBC or OLE DB.
 
-Current version: `10.0.x` targeting EF Core 10 and `net10.0`.
+Current version: `11.0.x` targeting EF Core 11 and `net11.0`. The test projects use **xunit v3**.
 
 ## Build
 
@@ -18,7 +18,7 @@ Assemblies are **strong-name signed** using `Key.snk`. `TreatWarningsAsErrors=Tr
 
 ### Local EFCore Repository (optional)
 
-To develop against a local EF Core build instead of NuGet packages, copy `Development.props.sample` to `Development.props` and set `LocalEFCoreRepository` to your EF Core checkout. That local build must be compiled with `AssemblyVersion=10.0.0.0` to avoid binding conflicts.
+To develop against a local EF Core build instead of NuGet packages, copy `Development.props.sample` to `Development.props` and set `LocalEFCoreRepository` to your EF Core checkout. That local build must be compiled with `AssemblyVersion=11.0.0.0` to avoid binding conflicts.
 
 ## Tests
 
diff --git a/Directory.Build.props b/Directory.Build.props
index 4a1c5c2b..a8c271f5 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -15,6 +15,7 @@
     <!-- <PackageReleaseNotes>TODO</PackageReleaseNotes> -->
     <PackageTags>Entity Framework Core;Entity Framework Core;entity-framework-core;Jet;ACE;Access;MS Access;msaccess;EF;EFCore;EF Core;EntityFrameworkCore</PackageTags>
     <PackageLicenseExpression>MIT</PackageLicenseExpression>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
     <PackageProjectUrl>https://github.com/CirrusRedOrg/EntityFrameworkCore.Jet</PackageProjectUrl>
     <!-- <PackageIconUrl>TODO</PackageIconUrl> -->
     <!-- <PackageIcon>packageIcon.png</PackageIcon> -->
@@ -32,6 +33,9 @@
   </PropertyGroup>
 
   <ItemGroup>
+    <!-- Shown as the package description on nuget.org. Packed for every package; non-packable
+         projects simply ignore it. -->
+    <None Include="$(MSBuildThisFileDirectory)docs\README.md" Pack="true" PackagePath="\" Visible="false" />
     <EmbeddedResource Include="**\*.rd.xml" />
     <!-- <None Include="$(PackageIconFullPath)" Pack="true" PackagePath="\"/> -->
   </ItemGroup>
diff --git a/Version.props b/Version.props
index cf38442b..90881e7a 100644
--- a/Version.props
+++ b/Version.props
@@ -15,9 +15,9 @@
             Bump-up to the next iteration immediately after a release, so that subsequent daily builds are named
             correctly.
         -->
-		<VersionPrefix>10.0.1</VersionPrefix>
-		<PreReleaseVersionLabel>servicing</PreReleaseVersionLabel>
-		<PreReleaseVersionIteration>0</PreReleaseVersionIteration>
+		<VersionPrefix>11.0.0</VersionPrefix>
+		<PreReleaseVersionLabel>alpha</PreReleaseVersionLabel>
+		<PreReleaseVersionIteration>1</PreReleaseVersionIteration>
 
 		<!--
             The following properties will automatically be set by CI builds when appropriate:
diff --git a/docs/README.md b/docs/README.md
index 1a9d9f3a..2aaef368 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -10,7 +10,8 @@
 
 | EntityFrameworkCore.Jet Version | Entity Framework Core Version | .NET | Notes |
 | ------------- | ------------- | ------------- | ------------- |
-| 10.0.x | 10.0.x | 10.0+ | Current development line |
+| 11.0.x | 11.0.x | 11.0+ | Current development line |
+| 10.0.x | 10.0.x | 10.0+ | Supported |
 | 9.0.x | 9.0.x | 9.0+ | Supported |
 | 8.0.x | 8.0.x | 8.0+ | Alpha 2 onwards is compatible with EF Core RTM |
 | 7.0.x | 7.0.x | 6.0+ |
diff --git a/src/EFCore.Jet.Data/EFCore.Jet.Data.csproj b/src/EFCore.Jet.Data/EFCore.Jet.Data.csproj
index c9bb4850..a0b5a14c 100644
--- a/src/EFCore.Jet.Data/EFCore.Jet.Data.csproj
+++ b/src/EFCore.Jet.Data/EFCore.Jet.Data.csproj
@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
 	<PropertyGroup>
-		<Description>Jet/ACE data provider for .NET used by EntityFramworkCore.Jet (Microsoft Access MDB/ACCDB files).</Description>
+		<Description>Jet/ACE data provider for .NET used by EntityFrameworkCore.Jet (Microsoft Access MDB/ACCDB files).</Description>
 		<TargetFramework>$(JetTargetFramework)</TargetFramework>
 		<Platforms>AnyCPU;x86;x64</Platforms>
 		<AssemblyName>EntityFrameworkCore.Jet.Data</AssemblyName>

From bd032f83b26c2ffa3b28c45676f83c28b7adef4d Mon Sep 17 00:00:00 2001
From: Christopher Jolly <chris-jolly_au@hotmail.com>
Date: Wed, 19 Aug 2026 18:16:12 +0800
Subject: [PATCH 2/3] LibRed docs: record the ACE-verified conversion and date
 semantics

functions.md lists behavioural detail like "Round (banker's)" and "Weekday
(Sunday = 1)"; these belong with them.

Type conversion: a Boolean converts as VARIANT_BOOL, so CInt/CLng/CSng/CDbl/CCur
yield -1 and CByte overflows. CStr renders a Double at 15 significant digits and
a Single at 7, and a Boolean as "-1" - the expression service's answer, where the
VBA runtime proper says "True". CBool accepts numeric strings. CDec has no ACE
equivalent at all, so it carries no parity contract.

Conventions: dates compare by OLE Automation serial rather than chronologically,
which below the epoch puts later times first, because IndexKeyEncoder writes that
same serial as the index key and a seek and a scan must agree.

Both point at the probes that establish them.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 src/LibRed/docs/functions.md | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/src/LibRed/docs/functions.md b/src/LibRed/docs/functions.md
index a7fd1b8c..2c34e940 100644
--- a/src/LibRed/docs/functions.md
+++ b/src/LibRed/docs/functions.md
@@ -17,7 +17,11 @@ scope** (a column reference throws "Column not found" — a default is row-blind
 **Conventions.** All functions **propagate NULL** (a NULL argument yields NULL) unless noted; string
 positions are **1-based**; string comparisons default to **case-insensitive** (Access "Option Compare
 Database" = Text) and take an optional compare argument. Values follow VBA sign/rounding conventions
-(`CInt`/`CLng`/`CByte` use banker's rounding).
+(`CInt`/`CLng`/`CByte` use banker's rounding). **Dates compare by their OLE Automation serial**, not
+chronologically: below the 1899-12-30 epoch the day count goes negative while the time fraction stays
+positive, so 1899-12-29 06:00 is -1.25 and 18:00 is -1.75 and ACE orders the later time first. LibRed
+matches that, because `IndexKeyEncoder` writes the same serial as the index key and the two paths must
+agree (see `AcePreEpochDateProbeTest`). Date *functions* are unaffected — they work in date space.
 
 > **Two expression services — what "ACE has it" means.** Access has (1) the **Jet/ACE OLE DB Expression
 > Service (JES)**, the built-in set the ACE OLE DB provider carries **standalone**, and (2) the **Access
@@ -34,7 +38,15 @@ Database" = Text) and take an optional compare argument. Values follow VBA sign/
 ## Scalar functions
 
 **Type conversion** — `CBool` `CByte` `CInt` `CLng` `CSng` `CDbl` `CCur` `CDec` `CStr` `CDate` `CVar`
-(`CVar` is a pass-through — LibRed has no distinct Variant type; `CCur` rounds to 4 dp).
+(`CVar` is a pass-through — LibRed has no distinct Variant type; `CCur` rounds to 4 dp). A **Boolean**
+converts as VARIANT_BOOL, so True is **-1**, not 1 — `CInt`/`CLng`/`CSng`/`CDbl`/`CCur` all yield -1, and
+`CByte` overflows because a byte cannot hold it. `CStr` renders a Double at **15 significant digits** and a
+Single at **7** (the OA/VB convention, not .NET's shortest round-trippable form), and a Boolean as `"-1"` —
+note that is the Jet Expression Service's answer, where the VBA runtime proper would say `"True"`. `CBool`
+accepts a numeric string (`"-1"`) and a non-integral number. `CDec` has **no ACE equivalent** — the
+expression service has no such function — so it is a LibRed extension with no parity contract; `CCur` is
+ACE's route to a decimal. (All verified against ACE in
+`LibRed.Core.Tests.AceVbaConversionProbeTest`.)
 
 **Math** — `Abs` `Sgn` `Int` (floor, toward −∞) `Fix` (truncate, toward zero) `Round` (banker's) `Sqr`
 `Exp` `Log` (natural) `Sin` `Cos` `Tan` `Atn` `Rnd` `Timer`.

From 91c498315cf78880170875ce78406287fb5b4da7 Mon Sep 17 00:00:00 2001
From: Christopher Jolly <chris-jolly_au@hotmail.com>
Date: Thu, 20 Aug 2026 23:15:33 +0800
Subject: [PATCH 3/3] README: point at LibRed

Describes what it is and what it removes - Windows-only and driver-bitness
matching - and says plainly that it is in development and not published as a
package, so nobody goes looking for it on nuget.org.

Placed after Fluent API rather than beside Packages: it is supplementary, and
does not belong between "install this" and "configure it". Links are absolute
because this file is also the NuGet readme, where relative paths do not resolve.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 docs/README.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/docs/README.md b/docs/README.md
index 2aaef368..ddb526f7 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -111,6 +111,18 @@ Examples are:
 * `UseIdentityColumn` -> `UseJetIdentityColumn`
 * `UseIdentityColumns` -> `UseJetIdentityColumns`
 
+## LibRed - native managed engine (in development)
+
+[LibRed](https://github.com/CirrusRedOrg/EntityFrameworkCore.Jet/blob/master/src/LibRed/README.md) is a
+from-scratch, fully managed implementation of the Jet/ACE engine that lives in this repository. It reads and
+writes `MDB`/`ACCDB` files **directly** - no ODBC, OLE DB, DAO or ADOX - so it removes both the Windows-only
+requirement and the need to match your process architecture to an installed Access driver.
+
+It reads and writes real database files, runs SQL end to end, and an EF Core `DbContext` round-trips through
+it today. It is still in development and is **not published as a NuGet package**; the on-disk format it
+depends on is documented and verified in
+[`src/LibRed/docs/format/`](https://github.com/CirrusRedOrg/EntityFrameworkCore.Jet/blob/master/src/LibRed/docs/format/README.md).
+
 ## Further information
 
 More information can be found on our [Wiki](https://www.github.com/CirrusRedOrg/EntityFrameworkCore.Jet/wiki).