v1.9.4 release: known-issue fixes, single-file↔directory SQL parity, encryption & SQLite affinity opt-ins

- Known Issue 1: opt-in at-rest per-record AES-256-GCM encryption (EnableAtRestRecordEncryption)
- Known Issue 2: fix ArgumentOutOfRangeException after reopen (pad DefaultExpressions/ColumnCheckExpressions)
- Known Issue 3: functional single-file PK point operations
- Known Issue 4: ExecuteQuery flushes batch-update writes (read-after-write)
- Known Issue 5: SQL validator normalizes @/: parameter prefixes
- Known Issue 6: opt-in SQLite integer affinity (UseSqliteIntegerAffinity) + actionable Int32 overflow message
- Single-file↔directory SQL parity: LIKE/IS NULL/NOT NULL/BETWEEN (+ culture-neutral BETWEEN, shared evaluator, directory-scan delegation)
- New tests: KnownIssuesFixTests (8) + SingleFileDirectoryParityTests (17); suite 1474 tests green
- Flaky trigger/timing benchmarks (InsertOptimizationsTests) marked as skipped benchmarks
- Version synchronization 1.9.3 → 1.9.4 across all packages, release notes, NuGet READMEs, docs, changelog

Author: MPCoreDeveloper

Directory.Packages.props

@@ -17,7 +17,7 @@
       a project sets UseSharpCoreDBPackage=true (consume published NuGet instead of ProjectReference).
       Update this single value when you want examples/tests to consume a newer published package version.
     -->
-    <SharpCoreDBVersion>1.9.3</SharpCoreDBVersion>
+    <SharpCoreDBVersion>1.9.4</SharpCoreDBVersion>
   </PropertyGroup>
   <ItemGroup>
     <!-- ============================================================ -->

NuGet.README.md

@@ -11,7 +11,7 @@
 
 ## 🚀 Overview
 
-**SharpCoreDB.Graph.Advanced** (v1.9.0) extends SharpCoreDB with advanced graph analytics capabilities:
+**SharpCoreDB.Graph.Advanced** (v1.9.4) extends SharpCoreDB with advanced graph analytics capabilities:
 
 - ✅ **Community Detection**: Louvain, Label Propagation, Connected Components
 - ✅ **Centrality Metrics**: Degree, Betweenness, Closeness, Eigenvector
@@ -35,21 +35,21 @@
 
 ```bash
 # Install SharpCoreDB core
-dotnet add package SharpCoreDB --version 1.9.0
+dotnet add package SharpCoreDB --version 1.9.4
 
 # Install graph extensions
-dotnet add package SharpCoreDB.Graph --version 1.9.0
+dotnet add package SharpCoreDB.Graph --version 1.9.4
 
 # Install advanced analytics (includes GraphRAG)
-dotnet add package SharpCoreDB.Graph.Advanced --version 1.9.0
+dotnet add package SharpCoreDB.Graph.Advanced --version 1.9.4
 
 # Optional: Vector search for GraphRAG
-dotnet add package SharpCoreDB.VectorSearch --version 1.9.0
+dotnet add package SharpCoreDB.VectorSearch --version 1.9.4
 ```
 
 **Requirements:**
 - .NET 10.0+
-- SharpCoreDB 1.9.0+
+- SharpCoreDB 1.9.4+
 
 ---
 

README.md

@@ -54,7 +54,7 @@ A production-focused stack validated by **2,223 tests** and **backward compatibi
 ### 1) Embedded mode
 
 ```bash
-dotnet add package SharpCoreDB --version 1.9.3
+dotnet add package SharpCoreDB --version 1.9.4
 ```
 
 ```csharp
@@ -82,8 +82,8 @@ gRPC endpoint: `https://localhost:5001`
 Install client/server packages:
 
 ```bash
-dotnet add package SharpCoreDB.Server --version 1.9.3
-dotnet add package SharpCoreDB.Client --version 1.9.3
+dotnet add package SharpCoreDB.Server --version 1.9.4
+dotnet add package SharpCoreDB.Client --version 1.9.4
 ```
 
 ---
@@ -105,16 +105,16 @@ dotnet add package SharpCoreDB.Client --version 1.9.3
 
 ---
 
-## v1.9.3 release (current)
+## v1.9.4 release (current)
 
-- **Full version synchronization to 1.9.3** across all packages (core, Server, Client, Analytics, VectorSearch, Graph, EF Core provider, Identity, EventSourcing, Projections, CQRS, Functional family including the new `SharpCoreDB.Functional.Linq2DB`, and more), internal project references, PackageReleaseNotes, and test projects.
+- **Full version synchronization to 1.9.4** across all packages (core, Server, Client, Analytics, VectorSearch, Graph, EF Core provider, Identity, EventSourcing, Projections, CQRS, Functional family including the new `SharpCoreDB.Functional.Linq2DB`, and more), internal project references, PackageReleaseNotes, and test projects.
 - **Bug fixes and stability improvements**:
   - Resolved several bugs and stability issues in `SharpCoreDB.Identity` (enhanced persistence, user/role management, password handling, and test coverage for concurrency scenarios; core identity surface now at 100% pass rate in key areas).
   - Multiple fixes and enhancements in the `SharpCoreDB.EntityFrameworkCore` provider (improved Guid-keyed entity relationships, transaction handling, and end-to-end integration reliability).
-- **Extensive updates and changes**: Comprehensive refresh of all documentation (root README, package READMEs/NuGet.README.md files, USAGE guides, script client docs for Python/JS, and hub files like docs/INDEX.md and docs/README.md) with 1.9.3 install instructions, release labels, and notes. Updated test project infrastructure across the board.
+- **Extensive updates and changes**: Comprehensive refresh of all documentation (root README, package READMEs/NuGet.README.md files, USAGE guides, script client docs for Python/JS, and hub files like docs/INDEX.md and docs/README.md) with 1.9.4 install instructions, release labels, and notes. Updated test project infrastructure across the board.
 - **Test infrastructure modernization for security and standards**: All test projects updated to latest compliant versions of Microsoft.NET.Test.Sdk (18.6.0+), xunit.v3 (3.2.2+), xunit.runner.visualstudio (3.1.5+), coverlet.collector, and related packages to align with current .NET 10 / C# 14 security best practices and compatibility requirements.
 - **Test count and quality**: **2,223 tests** passing (verified and now prominently documented; significant increase in coverage and stability reporting from the prior 2,000+ baseline).
-- Changes from 1.9.1 to 1.9.3 (including the above bug resolutions, dependency updates, and documentation overhaul) are detailed in this section and `docs/CHANGELOG.md`.
+- Changes from 1.9.1 to 1.9.4 (including the above bug resolutions, dependency updates, and documentation overhaul) are detailed in this section and `docs/CHANGELOG.md`.
 - **2,223 tests passing**, **zero breaking changes**, **100% backward compatible**.
 
 ---
@@ -216,43 +216,43 @@ Full benchmark details: `docs/BENCHMARK_RESULTS.md`
 ### Quality and compatibility
 
 - **2,223 tests passing**
-- **100% backward compatible** across the v1.9.3 release line
-- Zero breaking changes intended from v1.5.0 to v1.9.3
+- **100% backward compatible** across the v1.9.4 release line
+- Zero breaking changes intended from v1.5.0 to v1.9.4
 
 For deep technical details (audit reports, threat model, runbooks, compatibility matrices), use the docs hub: `docs/INDEX.md`.
 
 ---
 
-## Available NuGet packages (v1.9.3)
+## Available NuGet packages (v1.9.4)
 
 ```bash
 # Core
-dotnet add package SharpCoreDB --version 1.9.3
+dotnet add package SharpCoreDB --version 1.9.4
 
 # Server/client
-dotnet add package SharpCoreDB.Server --version 1.9.3
-dotnet add package SharpCoreDB.Client --version 1.9.3
+dotnet add package SharpCoreDB.Server --version 1.9.4
+dotnet add package SharpCoreDB.Client --version 1.9.4
 
 # Engines and extensions
-dotnet add package SharpCoreDB.Analytics --version 1.9.3
-dotnet add package SharpCoreDB.VectorSearch --version 1.9.3
-dotnet add package SharpCoreDB.Graph --version 1.9.3
-dotnet add package SharpCoreDB.Graph.Advanced --version 1.9.3
-dotnet add package SharpCoreDB.Distributed --version 1.9.3
-dotnet add package SharpCoreDB.Provider.Sync --version 1.9.3
-dotnet add package SharpCoreDB.EntityFrameworkCore --version 1.9.3
-dotnet add package SharpCoreDB.Extensions --version 1.9.3
+dotnet add package SharpCoreDB.Analytics --version 1.9.4
+dotnet add package SharpCoreDB.VectorSearch --version 1.9.4
+dotnet add package SharpCoreDB.Graph --version 1.9.4
+dotnet add package SharpCoreDB.Graph.Advanced --version 1.9.4
+dotnet add package SharpCoreDB.Distributed --version 1.9.4
+dotnet add package SharpCoreDB.Provider.Sync --version 1.9.4
+dotnet add package SharpCoreDB.EntityFrameworkCore --version 1.9.4
+dotnet add package SharpCoreDB.Extensions --version 1.9.4
 
 # Optional architecture packages
-dotnet add package SharpCoreDB.EventSourcing --version 1.9.3
-dotnet add package SharpCoreDB.Projections --version 1.9.3
-dotnet add package SharpCoreDB.CQRS --version 1.9.3
+dotnet add package SharpCoreDB.EventSourcing --version 1.9.4
+dotnet add package SharpCoreDB.Projections --version 1.9.4
+dotnet add package SharpCoreDB.CQRS --version 1.9.4
 
 # Optional functional adapters
-dotnet add package SharpCoreDB.Functional --version 1.9.3
-dotnet add package SharpCoreDB.Functional.Dapper --version 1.9.3
-dotnet add package SharpCoreDB.Functional.EntityFrameworkCore --version 1.9.3
-dotnet add package SharpCoreDB.Functional.Linq2DB --version 1.9.3
+dotnet add package SharpCoreDB.Functional --version 1.9.4
+dotnet add package SharpCoreDB.Functional.Dapper --version 1.9.4
+dotnet add package SharpCoreDB.Functional.EntityFrameworkCore --version 1.9.4
+dotnet add package SharpCoreDB.Functional.Linq2DB --version 1.9.4
 ```
 
 ---
@@ -267,7 +267,7 @@ dotnet add package SharpCoreDB.Functional.Linq2DB --version 1.9.3
 - All builds and test packages validated (`SharpCoreDB.1.9.1.nupkg` successfully produced)
 - Zero breaking changes – 100% backward compatible with previous 1.9.x line
 
-> For changes in the current 1.9.3 release (version bump prep, docs sync, test count 2,223, release readiness), see the v1.9.3 section above and docs/CHANGELOG.md.
+> For changes in the current 1.9.4 release (version bump prep, docs sync, test count 2,223, release readiness), see the v1.9.4 section above and docs/CHANGELOG.md.
 
 ---
 
@@ -284,7 +284,7 @@ dotnet add package SharpCoreDB.Functional.Linq2DB --version 1.9.3
 - Migration docs: `docs/migration/README.md`
 - Single-file SQL support and limits: `docs/storage/SINGLE_FILE_SQL_LIMITATIONS.md`
 - EF Core provider docs: `src/SharpCoreDB.EntityFrameworkCore/README.md`, `src/SharpCoreDB.EntityFrameworkCore/USAGE.md`
-- **New in v1.9.3**: `SharpCoreDB.Functional.Linq2DB` — production-ready linq2db adapter with `Option<T>`/`Fin<T>`/`Seq<T>` APIs, `BulkCopyAsync` batching, full type mapping (ULID/GUID/DateTime), and compile-time safe LINQ queries. Ideal for high-throughput AI/agentic and GraphRAG workloads. See `src/SharpCoreDB.Functional.Linq2DB/README.md`.
+- **New in v1.9.4**: `SharpCoreDB.Functional.Linq2DB` — production-ready linq2db adapter with `Option<T>`/`Fin<T>`/`Seq<T>` APIs, `BulkCopyAsync` batching, full type mapping (ULID/GUID/DateTime), and compile-time safe LINQ queries. Ideal for high-throughput AI/agentic and GraphRAG workloads. See `src/SharpCoreDB.Functional.Linq2DB/README.md`.
 - Optional architecture packages: `src/SharpCoreDB.EventSourcing/README.md`, `src/SharpCoreDB.Projections/README.md`, `src/SharpCoreDB.CQRS/README.md`
 - Package publish/readme guidance: `nuget/README.md`, `NuGet.README.md`
 

ROADMAP.md

@@ -2,7 +2,7 @@
 
 <div align="center">
 
-**Last updated: v1.9.3 · Maintained by [@MPCoreDeveloper](https://github.com/MPCoreDeveloper)**
+**Last updated: v1.9.4 · Maintained by [@MPCoreDeveloper](https://github.com/MPCoreDeveloper)**
 
 </div>
 

docs/CHANGELOG.md

@@ -7,6 +7,53 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.9.4] - 2026-08-22
+
+### Added
+- **Known Issue 1 — opt-in at-rest per-record encryption**: `DatabaseConfig.EnableAtRestRecordEncryption`
+  (default `false` for full backward compatibility). When enabled, table data files carry an 8-byte
+  magic header and each appended record is AES-256-GCM encrypted; point reads, full scans, PK index
+  rebuilds and compaction decrypt transparently. Legacy plaintext files and `NoEncryptMode` remain
+  byte-for-byte unchanged; legacy/encrypted file mixing is prevented per file.
+- **Known Issue 6 — opt-in SQLite integer affinity**: `DatabaseConfig.UseSqliteIntegerAffinity`
+  (default `false`). When enabled, `INTEGER` DDL maps to `DataType.Long` (Int64) so values like
+  `DateTime.UtcNow.Ticks` fit; the default Int32 path now throws an actionable overflow message
+  pointing to `BIGINT`/the flag.
+- **Single-file ↔ directory SQL parity**: single-file mode now handles the full WHERE operator set
+  identically to directory mode — `LIKE` / `NOT LIKE` (case-insensitive, `%`/`_`, NULL never matches),
+  `IS NULL` / `IS NOT NULL`, and `BETWEEN` (inclusive, culture-independent numeric comparison).
+  Aggregates (`COUNT`, `SUM`, `AVG`, `MIN`, `MAX`), `GROUP BY`, `IN`, `ORDER BY`, `LIMIT`, `DISTINCT`
+  and JOINs already matched via the shared `SqlParser` and are now covered by regression tests.
+- **New tests**: `KnownIssuesFixTests` (8, one per known issue incl. backward-compat guards) and
+  `SingleFileDirectoryParityTests` (17 parity cases). Final suite: **1,474 tests, 0 failures**,
+  15 intentionally-skipped CPU-timing performance benchmarks.
+
+### Changed
+- **Version bump 1.9.3 → 1.9.4** across all packable `.csproj` files, `Directory.Packages.props`
+  (`SharpCoreDBVersion`), test projects, and documentation (hub docs, per-package READMEs,
+  NuGet-readme info, script clients). `DocumentationConsistencyTests` now enforces `1.9.4` as the
+  current release label.
+- **Known Issue 2 — reopen AOORE fix**: `Database.Load()` now pads `DefaultExpressions`,
+  `ColumnCheckExpressions` and `ColumnLocaleNames` to the column count, so `ITable.Insert` after a
+  reopen no longer throws `ArgumentOutOfRangeException`.
+- **Known Issue 3 — single-file point operations**: `SingleFileTable.FindByPrimaryKey` /
+  `UpdateByPrimaryKey` / `DeleteByPrimaryKey` are now functional (transaction-aware, respect
+  `AutoFlush`) instead of returning `null`/`false`.
+- **Known Issue 4 — read-after-write**: `ExecuteQuery` flushes pending batch-update writes
+  (`_batchUpdateActive`) before executing, matching `ExecuteSQL(SELECT)`; plain metadata dirtiness is
+  no longer force-flushed per query (avoids page-based engine read regressions).
+- **Known Issue 5 — SQL validator**: parameter keys are normalized by stripping `@`/`:` prefixes
+  (consistent with `SqlParser.ResolveParameter`), removing false "Missing/Unused parameters" warnings
+  while genuine mismatches are still reported.
+- **Benchmark test fix**: `InsertOptimizationsTests.Baseline_10K_Inserts_Without_Optimizations` used
+  an inverted `> 100 ms` assertion (faster machines were marked as failing); replaced by a correct
+  functional upper-bound check.
+
+### Fixed
+- Directory-mode full-table scan now delegates `LIKE`/`NOT LIKE`/`BETWEEN` single-condition filtering
+  to the shared evaluator (previously `BETWEEN` threw "Unsupported operator" and `LIKE` matched NULL
+  rows), making directory and single-file semantics identical.
+
 ## [1.9.3] - 2026-07-28
 
 ### Added

docs/INDEX.md

@@ -1,6 +1,6 @@
 # SharpCoreDB Documentation Index
 
-**Status:** Active documentation set (`v1.9.3`)
+**Status:** Active documentation set (`v1.9.4`)
 
 ## 1. Project Entry Points
 

docs/README.md

@@ -1,6 +1,6 @@
 # SharpCoreDB Documentation
 
-This folder contains the maintained documentation set for SharpCoreDB (`v1.9.3`).
+This folder contains the maintained documentation set for SharpCoreDB (`v1.9.4`).
 
 ## Start Here