docs

Author: MPCoreDeveloper

README.md

@@ -31,6 +31,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Explicitly documented the remaining deferred single-file parameterized `ExecuteCompiled` disposal deadlock path.
 - **Performance test hardening**: `ColumnStore_Average_10kRecords_Under2ms` now runs 10 iterations and asserts the best (minimum) time, with an additional warmup call. This eliminates false failures caused by concurrent test execution, GC pauses, or OS scheduling jitter.
 
+## [1.7.0] - 2026-04-06
+
+### Added
+- `SharpCoreDB.Graph.Advanced` package for advanced graph analytics and GraphRAG workflows.
+- Functional package family: `SharpCoreDB.Functional`, `SharpCoreDB.Functional.Dapper`, `SharpCoreDB.Functional.EntityFrameworkCore`.
+- Expanded optional package guidance for `SharpCoreDB.EventSourcing`, `SharpCoreDB.Projections`, and `SharpCoreDB.CQRS`.
+
+### Changed
+- Ecosystem-wide package version synchronization on `1.7.0`.
+- Documentation refresh across root/docs/src package README files with per-project features and v1.7.0 changes.
+- SIMD aggregate hot loops updated to `Vector256.LoadUnsafe` pattern in columnar paths.
+
+### Fixed
+- SQL lexer/parser reliability for parameterized compiled-query execution.
+- Metadata flush/reopen reliability paths with backward-compatible metadata format handling.
+
 ## [1.6.0] - 2026-03-30
 
 ### 🎉 Major Achievement - Phase 12: GraphRAG Enhancement & Vector Search Integration COMPLETE

audit_markers.txt

@@ -0,0 +1,66 @@
+# SharpCoreDB Feature Matrix (v1.7.0)
+
+This page consolidates the major SharpCoreDB capabilities by package for quick discovery.
+
+## Core platform
+
+| Package | Purpose | Key capabilities in v1.7.0 |
+|---|---|---|
+| `SharpCoreDB` | Embedded core engine | AES-256-GCM encryption, SQL engine, ACID + WAL, indexing, FTS, SIMD optimizations, metadata durability fixes, compiled-query parser fixes |
+| `SharpCoreDB.Server` | Network server runtime | gRPC-first (HTTP/2 + HTTP/3), REST, WebSocket, JWT/RBAC, optional mTLS, multi-database hosting, health/metrics |
+| `SharpCoreDB.Client` | .NET client | ADO.NET-style commands/readers, async access, parameterized execution, server connectivity |
+
+## Data access and framework integrations
+
+| Package | Purpose | Key capabilities in v1.7.0 |
+|---|---|---|
+| `SharpCoreDB.Data.Provider` | ADO.NET provider | `DbConnection`/`DbCommand`/`DbDataReader`, transactions, parameterized queries |
+| `SharpCoreDB.EntityFrameworkCore` | EF Core provider | Provider services, query translation components, migration/update SQL generation |
+| `SharpCoreDB.Extensions` | Productivity extensions | Dapper helpers, health checks, optional FluentMigrator integration |
+| `SharpCoreDB.Provider.YesSql` | YesSql integration | Storage provider components for YesSql/Orchard-style patterns |
+| `SharpCoreDB.Serilog.Sinks` | Logging sink | Batch-oriented structured logging into SharpCoreDB |
+
+## Analytics, vector, graph, and GraphRAG
+
+| Package | Purpose | Key capabilities in v1.7.0 |
+|---|---|---|
+| `SharpCoreDB.Analytics` | Analytical SQL extension | 100+ aggregates, window functions, statistical analysis (`STDDEV`, `VARIANCE`, `PERCENTILE`, `CORRELATION`) |
+| `SharpCoreDB.VectorSearch` | Vector retrieval | HNSW indexing, SIMD distance computations, quantization, semantic search workflows |
+| `SharpCoreDB.Graph` | Graph traversal engine | BFS/DFS/bidirectional traversal, A* pathfinding, graph query helpers |
+| `SharpCoreDB.Graph.Advanced` | Advanced graph analytics + GraphRAG | Community detection, centrality metrics, subgraph analysis, graph-aware ranking, profiling and caching helpers |
+
+## Distributed and synchronization
+
+| Package | Purpose | Key capabilities in v1.7.0 |
+|---|---|---|
+| `SharpCoreDB.Distributed` | Distributed runtime components | Multi-master replication, vector clocks, streaming replication components, distributed transaction primitives |
+| `SharpCoreDB.Provider.Sync` | Dotmim.Sync provider | Sync adapter, tracking/tombstones, metadata/scope builders, provider integration for cloud/offline sync |
+
+## Event-driven optional architecture packages
+
+| Package | Purpose | Key capabilities in v1.7.0 |
+|---|---|---|
+| `SharpCoreDB.EventSourcing` | Event persistence | Append-only streams, global ordered feed, snapshots, snapshot-aware loading, upcasting hooks |
+| `SharpCoreDB.Projections` | Read model projection scaffold | Projection registration/runners, durable checkpoints, background hosted execution, OTel metrics |
+| `SharpCoreDB.CQRS` | Command/outbox scaffold | Command handlers/dispatchers, aggregate root base, in-memory/persistent outbox, retry/dead-letter workflows |
+
+## Functional package family (new in v1.7.0 line)
+
+| Package | Purpose | Key capabilities in v1.7.0 |
+|---|---|---|
+| `SharpCoreDB.Functional` | Functional façade | `Option<T>`, `Fin<T>`, `Seq<T>`, functional-first database APIs |
+| `SharpCoreDB.Functional.Dapper` | Functional Dapper adapter | Functional wrappers over Dapper read/write/query patterns |
+| `SharpCoreDB.Functional.EntityFrameworkCore` | Functional EF Core adapter | Functional wrappers over `DbContext` workflows |
+
+## Quality and compatibility summary
+
+- `1,490+` tests passing across workspace and targeted suites
+- Ecosystem package synchronization on `v1.7.0`
+- No intended breaking changes from `v1.5.0` to `v1.7.0`
+
+## Related docs
+
+- `INDEX.md`
+- `README.md`
+- `release/PHASE12_RELEASE_NOTES.md`
+- `../README.md`

audit_markers_filtered.txt

@@ -6,70 +6,67 @@
 
 - `../README.md`
 - `README.md`
+- `FEATURE_MATRIX_v1.7.0.md`
 - `PROJECT_STATUS.md`
 - `IMPLEMENTATION_AUDIT_v1.7.0.md`
 - `OPEN_ITEMS_v1.7.0.md`
 - `release/PHASE12_RELEASE_NOTES.md`
 
-## 2. Server Documentation
+## 2. Package Documentation (src)
 
+- `../src/SharpCoreDB/README.md`
+- `../src/SharpCoreDB.Server/README.md`
+- `../src/SharpCoreDB.Client/README.md`
+- `../src/SharpCoreDB.Analytics/README.md`
+- `../src/SharpCoreDB.VectorSearch/README.md`
+- `../src/SharpCoreDB.Graph/README.md`
+- `../src/SharpCoreDB.Graph.Advanced/README.md`
+- `../src/SharpCoreDB.Distributed/README.md`
+- `../src/SharpCoreDB.Provider.Sync/README.md`
+- `../src/SharpCoreDB.EventSourcing/README.md`
+- `../src/SharpCoreDB.Projections/README.md`
+- `../src/SharpCoreDB.CQRS/README.md`
+- `../src/SharpCoreDB.Functional/README.md`
+
+## 3. Server Documentation
+
+- `server/README.md`
 - `server/QUICKSTART.md`
 - `server/INSTALLATION.md`
 - `server/CLIENT_GUIDE.md`
 - `server/ADMIN_TOOLING_GUIDE.md`
-- `server/ODBC_JDBC_STRATEGY.md`
 - `server/REST_API.md`
 - `server/BINARY_PROTOCOL_SPEC.md`
 - `server/CONFIGURATION_SCHEMA.md`
 - `server/SECURITY.md`
 - `server/SYSTEM_DATABASES_SECURITY.md`
-- `server/EVENT_SOURCING_RFC.md`
-- `server/EVENT_STREAM_MODEL_FINAL.md`
 
-## 3. Storage and Engine Internals
+## 4. Storage and Engine Internals
 
 - `scdb/README.md`
 - `scdb/README_INDEX.md`
 - `scdb/PRODUCTION_GUIDE.md`
 - `serialization/README.md`
 - `serialization/SERIALIZATION_AND_STORAGE_GUIDE.md`
-- `serialization/SERIALIZATION_FAQ.md`
-- `serialization/BINARY_FORMAT_VISUAL_REFERENCE.md`
 - `storage/QUICK_REFERENCE_v1.7.0.md`
 - `storage/METADATA_IMPROVEMENTS_v1.7.0.md`
 
-## 4. GraphRAG and Analytics
+## 5. GraphRAG, Vector, and Analytics
 
 - `graphrag/00_START_HERE.md`
 - `graphrag/README.md`
-- `graphrag/LINQ_API_GUIDE.md`
-- `graphrag/EF_CORE_COMPLETE_GUIDE.md`
-- `graphrag/CUSTOM_HEURISTICS_GUIDE.md`
-- `graphrag/METRICS_AND_OBSERVABILITY_GUIDE.md`
 - `analytics/README.md`
-- `analytics/TUTORIAL.md`
+- `Vectors/README.md`
+- `performance/graphrag-performance-tuning.md`
 
-## 5. Distributed, Sync, and Migration
+## 6. Distributed, Sync, and Migration
 
 - `distributed/README.md`
 - `sync/README.md`
-- `sync/CHANGELOG.md`
 - `migration/README.md`
+- `migration/MIGRATION_GUIDE.md`
 - `migration/FLUENTMIGRATOR_EMBEDDED_MODE_v1.7.0.md`
 - `migration/FLUENTMIGRATOR_SERVER_MODE_v1.7.0.md`
-- `migration/MIGRATION_GUIDE.md`
-- `migration/SQLITE_VECTORS_TO_SHARPCORE.md`
-
-## 6. Additional References
-
-- `cqrs/README.md`
-- `cqrs/QUICKSTART.md`
-- `features/advanced-graphrag.md`
-- `features/graphrag-enhancement.md`
-- `api/SharpCoreDB.Graph.Advanced.API.md`
-- `performance/graphrag-performance-tuning.md`
-- `proposals/README.md`
-- `proposals/ADR_FLUENTMIGRATOR_PACKAGE_PLACEMENT_v1.7.0.md`
 
 ## Canonical Documentation Rule
 

docs/CHANGELOG.md

@@ -1,28 +1,31 @@
 # SharpCoreDB Documentation
 
-This folder contains the maintained documentation set for SharpCoreDB.
+This folder contains the maintained documentation set for SharpCoreDB (`v1.7.0`).
 
 ## Start Here
 
 - `INDEX.md` - Canonical documentation index.
-- `PROJECT_STATUS.md` - Current product status for v1.7.0.
-- `IMPLEMENTATION_AUDIT_v1.7.0.md` - Repository-wide implementation completeness audit.
-- `OPEN_ITEMS_v1.7.0.md` - Repository-wide open points and follow-up tracker.
-- `../README.md` - Project overview, features, and installation.
-- `release/PHASE12_RELEASE_NOTES.md` - Latest release notes.
+- `FEATURE_MATRIX_v1.7.0.md` - Consolidated feature coverage by package.
+- `PROJECT_STATUS.md` - Current project status.
+- `IMPLEMENTATION_AUDIT_v1.7.0.md` - Repository-wide implementation audit.
+- `../README.md` - Product overview and quick start.
 
 ## Core Areas
 
-- `server/` - Server operation, security, API, and protocol docs.
-- `scdb/` - SCDB format and production guidance.
-- `serialization/` - Binary format and storage serialization details.
-- `distributed/` - Distributed and replication documentation.
-- `sync/` - Sync provider guidance and changelog.
-- `graphrag/` - GraphRAG usage and technical guides.
-- `analytics/` - Analytics feature documentation.
-- `migration/` - Migration guides.
-- `proposals/` - Active proposal documents.
+- `server/` - Server operation, security, APIs, and protocols.
+- `scdb/` - Storage engine and SCDB guidance.
+- `serialization/` - Binary format and serialization internals.
+- `analytics/` - Analytics capabilities and usage.
+- `Vectors/` - Vector search and semantic retrieval.
+- `graphrag/` - GraphRAG and advanced graph workflows.
+- `distributed/` - Distributed architecture components.
+- `sync/` - Dotmim.Sync provider usage.
+- `migration/` - Migration and interoperability guides.
+
+## Package Documentation
+
+Per-package docs are maintained in `src/*/README.md` and `src/*/NuGet.README.md`, aligned to `v1.7.0`.
 
 ## Cleanup Policy
 
-Obsolete phase-status, kickoff, completion, and superseded planning documents are removed during documentation maintenance. Historical snapshots are not used as canonical product docs.
+Obsolete phase-status, kickoff, and superseded planning docs are removed during maintenance. Historical snapshots are not canonical product docs.

docs/FEATURE_MATRIX_v1.7.0.md

@@ -1,11 +1,17 @@
 # 🔍 SharpCoreDB Vector Search & Storage
 
-> **Status:** ✅ **PRODUCTION READY** — v1.1.2+  
+> **Status:** ✅ **PRODUCTION READY** — v1.7.0  
 > **Module:** `SharpCoreDB.VectorSearch` (optional, separate NuGet)  
-> **Features:** HNSW indexes, quantization, distance metrics  
+> **Features:** HNSW indexes, quantization, distance metrics, GraphRAG integration paths  
 > **Performance:** 50-100x faster than SQLite vector search  
 > **Requirements:** .NET 10, C# 14  
-> **Breaking Changes:** None — 100% backward compatible
+> **Breaking Changes:** None — backward compatible
+
+## v1.7.0 changes
+
+- Package/docs synchronized to `v1.7.0`
+- Vector workflows aligned with `SharpCoreDB.Graph.Advanced` GraphRAG guidance
+- Inherits core metadata/parser reliability improvements from SharpCoreDB v1.7.0
 
 ---
 
@@ -67,11 +73,11 @@ This is the foundation for:
 ### 1. Install the Package
 
 ```bash
-# Core database (you already have this)
-dotnet add package SharpCoreDB --version 1.1.2
+# Core database
+dotnet add package SharpCoreDB --version 1.7.0
 
-# Vector search extension (optional)
-dotnet add package SharpCoreDB.VectorSearch
+# Vector search extension
+dotnet add package SharpCoreDB.VectorSearch --version 1.7.0
 ```
 
 ### 2. Register Vector Search

docs/INDEX.md

@@ -1,8 +1,14 @@
 # SharpCoreDB Analytics Engine
 
-**Version:** 1.3.5 (Phase 9.2)  
+**Version:** 1.7.0  
 **Status:** Production Ready ✅
 
+## v1.7.0 changes
+
+- Package line synchronized to `v1.7.0`
+- Analytics docs aligned with the current 100+ aggregate + window-function scope
+- Inherits core reliability improvements from SharpCoreDB v1.7.0 (metadata/parser paths)
+
 ## Overview
 
 The SharpCoreDB Analytics Engine provides high-performance data aggregation, windowing, and statistical analysis capabilities. Phase 9 includes two major releases:
@@ -26,7 +32,7 @@ The SharpCoreDB Analytics Engine provides high-performance data aggregation, win
 ### Installation
 
 ```bash
-dotnet add package SharpCoreDB.Analytics --version 1.3.5
+dotnet add package SharpCoreDB.Analytics --version 1.7.0
 ```
 
 ### Basic Aggregation

docs/README.md

@@ -1,6 +1,6 @@
 # Analytics Engine - Complete Tutorial
 
-**Version:** 1.3.5 (Phase 9.2)
+**Version:** 1.7.0
 
 ## Table of Contents
 
@@ -23,8 +23,8 @@ Create a new console application:
 ```bash
 dotnet new console -n AnalyticsDemo
 cd AnalyticsDemo
-dotnet add package SharpCoreDB --version 1.3.5
-dotnet add package SharpCoreDB.Analytics --version 1.3.5
+dotnet add package SharpCoreDB --version 1.7.0
+dotnet add package SharpCoreDB.Analytics --version 1.7.0
 ```
 
 ### Dependency Injection Setup