Refresh docs and add GraphRAG coverage

Author: MPCoreDeveloper

README.md

@@ -253,11 +253,14 @@ dotnet add package SharpCoreDB.Functional.EntityFrameworkCore --version 1.7.0
 
 - Documentation hub: `docs/INDEX.md`
 - Project docs index: `docs/README.md`
+- Feature matrix: `docs/FEATURE_MATRIX_v1.7.0.md`
 - Server docs: `docs/server/README.md`
 - Server quick start: `docs/server/QUICKSTART.md`
-- Server install/config: `docs/server/INSTALLATION.md`, `docs/server/CONFIGURATION_SCHEMA.md`
-- Security hardening: `docs/server/SECURITY.md`
+- GraphRAG docs: `docs/graphrag/00_START_HERE.md`
+- EF Core provider docs: `src/SharpCoreDB.EntityFrameworkCore/README.md`, `src/SharpCoreDB.EntityFrameworkCore/USAGE.md`
+- Optional architecture packages: `src/SharpCoreDB.EventSourcing/README.md`, `src/SharpCoreDB.Projections/README.md`, `src/SharpCoreDB.CQRS/README.md`
 - Implementation audit and status: `docs/IMPLEMENTATION_AUDIT_v1.7.0.md`, `docs/PROJECT_STATUS.md`
+- Package publish/readme guidance: `nuget/README.md`, `NuGet.README.md`
 
 ---
 

docs/INDEX.md

@@ -15,18 +15,42 @@
 ## 2. Package Documentation (src)
 
 - `../src/SharpCoreDB/README.md`
+- `../src/SharpCoreDB/NuGet.README.md`
 - `../src/SharpCoreDB.Server/README.md`
+- `../src/SharpCoreDB.Server/NuGet.README.md`
 - `../src/SharpCoreDB.Client/README.md`
+- `../src/SharpCoreDB.Client/NuGet.README.md`
+- `../src/SharpCoreDB.Data.Provider/README.md`
+- `../src/SharpCoreDB.Data.Provider/NuGet.README.md`
+- `../src/SharpCoreDB.EntityFrameworkCore/README.md`
+- `../src/SharpCoreDB.EntityFrameworkCore/USAGE.md`
+- `../src/SharpCoreDB.EntityFrameworkCore/NuGet.README.md`
+- `../src/SharpCoreDB.Extensions/README.md`
+- `../src/SharpCoreDB.Extensions/NuGet.README.md`
 - `../src/SharpCoreDB.Analytics/README.md`
+- `../src/SharpCoreDB.Analytics/NuGet.README.md`
 - `../src/SharpCoreDB.VectorSearch/README.md`
+- `../src/SharpCoreDB.VectorSearch/NuGet.README.md`
 - `../src/SharpCoreDB.Graph/README.md`
+- `../src/SharpCoreDB.Graph/NuGet.README.md`
 - `../src/SharpCoreDB.Graph.Advanced/README.md`
+- `../src/SharpCoreDB.Graph.Advanced/NuGet.README.md`
 - `../src/SharpCoreDB.Distributed/README.md`
+- `../src/SharpCoreDB.Distributed/NuGet.README.md`
 - `../src/SharpCoreDB.Provider.Sync/README.md`
+- `../src/SharpCoreDB.Provider.Sync/NuGet.README.md`
 - `../src/SharpCoreDB.EventSourcing/README.md`
+- `../src/SharpCoreDB.EventSourcing/NuGet.README.md`
 - `../src/SharpCoreDB.Projections/README.md`
+- `../src/SharpCoreDB.Projections/NuGet.README.md`
 - `../src/SharpCoreDB.CQRS/README.md`
+- `../src/SharpCoreDB.CQRS/NuGet.README.md`
 - `../src/SharpCoreDB.Functional/README.md`
+- `../src/SharpCoreDB.Functional.Dapper/README.md`
+- `../src/SharpCoreDB.Functional.EntityFrameworkCore/README.md`
+- `../src/SharpCoreDB.Identity/README.md`
+- `../src/SharpCoreDB.Serilog.Sinks/README.md`
+- `../src/SharpCoreDB.Serilog.Sinks/NuGet.README.md`
 
 ## 3. Server Documentation
 
@@ -55,6 +79,8 @@
 
 - `graphrag/00_START_HERE.md`
 - `graphrag/README.md`
+- `graphrag/GRAPH_RAG_SINGLE_SQL.md`
+- `graphrag/METRICS_AND_OBSERVABILITY_GUIDE.md`
 - `analytics/README.md`
 - `Vectors/README.md`
 - `performance/graphrag-performance-tuning.md`
@@ -68,6 +94,8 @@
 - `migration/FLUENTMIGRATOR_EMBEDDED_MODE_v1.7.0.md`
 - `migration/FLUENTMIGRATOR_SERVER_MODE_v1.7.0.md`
 
-## Canonical Documentation Rule
+## 7. Documentation Governance
 
-When duplicate or historical status/planning documents exist, the files listed in this index are the canonical references.
+- Files listed in this index are the maintained product documentation set.
+- Historical phase-design notes may remain in feature folders for background context, but they are archival references unless they also appear in this index.
+- Superseded duplicates should be removed instead of linked alongside the canonical files.

docs/README.md

@@ -10,7 +10,7 @@ This folder contains the maintained documentation set for SharpCoreDB (`v1.7.0`)
 - `IMPLEMENTATION_AUDIT_v1.7.0.md` - Repository-wide implementation audit.
 - `../README.md` - Product overview and quick start.
 
-## Core Areas
+## Maintained documentation areas
 
 - `server/` - Server operation, security, APIs, and protocols.
 - `sql/` - SQL dialect capabilities, extensions, and compatibility guidance.
@@ -23,16 +23,22 @@ This folder contains the maintained documentation set for SharpCoreDB (`v1.7.0`)
 - `sync/` - Dotmim.Sync provider usage.
 - `migration/` - Migration and interoperability guides.
 
+## Current package entry points
+
+- Core: `../src/SharpCoreDB/README.md`, `../src/SharpCoreDB/NuGet.README.md`
+- Data access: `../src/SharpCoreDB.Data.Provider/README.md`, `../src/SharpCoreDB.EntityFrameworkCore/README.md`, `../src/SharpCoreDB.EntityFrameworkCore/USAGE.md`, `../src/SharpCoreDB.Extensions/README.md`
+- Analytics and search: `../src/SharpCoreDB.Analytics/README.md`, `../src/SharpCoreDB.VectorSearch/README.md`, `../src/SharpCoreDB.Graph/README.md`, `../src/SharpCoreDB.Graph.Advanced/README.md`
+- Server and clients: `../src/SharpCoreDB.Server/README.md`, `../src/SharpCoreDB.Client/README.md`
+- Optional architecture modules: `../src/SharpCoreDB.EventSourcing/README.md`, `../src/SharpCoreDB.Projections/README.md`, `../src/SharpCoreDB.CQRS/README.md`
+- Optional functional adapters: `../src/SharpCoreDB.Functional/README.md`, `../src/SharpCoreDB.Functional.Dapper/README.md`, `../src/SharpCoreDB.Functional.EntityFrameworkCore/README.md`
+- Additional integrations: `../src/SharpCoreDB.Identity/README.md`, `../src/SharpCoreDB.Serilog.Sinks/README.md`, `../src/SharpCoreDB.Provider.Sync/README.md`
+
 ## SQL extension docs (v1.7.0)
 
 - `sql/SQL_DIALECT_EXTENSIONS_v1.7.0.md` - SharpCoreDB-specific SQL extensions including `GRAPH_RAG`, `OPTIONALLY`, and `IS SOME`/`IS NONE`.
 - `graphrag/GRAPH_RAG_SINGLE_SQL.md` - Single-statement GraphRAG SQL syntax and DI integration.
 - `functional/OPTIONALLY_SQL_OPTION_SUPPORT_v1.7.0.md` - Option<T> mapping semantics and usage patterns.
 
-## Package Documentation
-
-Per-package docs are maintained in `src/*/README.md` and `src/*/NuGet.README.md`, aligned to `v1.7.0`.
-
-## Cleanup Policy
+## Cleanup policy
 
-Obsolete phase-status, kickoff, and superseded planning docs are removed during maintenance. Historical snapshots are not canonical product docs.
+Obsolete phase-status, kickoff, duplicate, and superseded planning docs are removed during maintenance. Historical snapshots are not canonical product docs unless they are explicitly linked from `INDEX.md`.

docs/graphrag/00_START_HERE.md

@@ -4,31 +4,34 @@ This page is the entry point for active GraphRAG documentation (`v1.7.0`).
 
 ## v1.7.0 focus
 
-- `SharpCoreDB.Graph.Advanced` is the primary advanced graph analytics + GraphRAG package
-- Pair with `SharpCoreDB.Graph` for traversal/pathfinding and `SharpCoreDB.VectorSearch` for semantic retrieval
-- See `../FEATURE_MATRIX_v1.7.0.md` for package-level capability mapping
+- `SharpCoreDB.Graph.Advanced` is the primary advanced graph analytics + GraphRAG package.
+- Pair it with `SharpCoreDB.Graph` for traversal/pathfinding and `SharpCoreDB.VectorSearch` for semantic retrieval.
+- Use `../FEATURE_MATRIX_v1.7.0.md` for package-level capability mapping across the full ecosystem.
 
-## Recommended Reading Order
+## Recommended reading order
 
-1. `LINQ_API_GUIDE.md` - Practical API-first usage.
-2. `EF_CORE_COMPLETE_GUIDE.md` - End-to-end EF Core integration guide.
-3. `CUSTOM_HEURISTICS_GUIDE.md` - Heuristic extension patterns.
-4. `METRICS_AND_OBSERVABILITY_GUIDE.md` - Telemetry and operational visibility.
-5. `QUERY_PLAN_CACHING.md` - Query planning and caching behavior.
-6. `README.md` - GraphRAG area overview.
+1. `README.md` - Current package and capability overview.
+2. `GRAPH_RAG_SINGLE_SQL.md` - Single-statement GraphRAG SQL workflow.
+3. `LINQ_API_GUIDE.md` - API-first usage for graph traversal and integration patterns.
+4. `EF_CORE_COMPLETE_GUIDE.md` - End-to-end EF Core integration guidance.
+5. `CUSTOM_HEURISTICS_GUIDE.md` - Heuristic extension patterns.
+6. `METRICS_AND_OBSERVABILITY_GUIDE.md` - Telemetry and operational visibility.
+7. `QUERY_PLAN_CACHING.md` - Query planning and caching behavior.
 
-## Technical Background
+## Validation and testing
+
+- `EF_CORE_TEST_DOCUMENTATION.md`
+- `EF_CORE_DOCUMENTATION_INDEX.md`
+
+## Archival technical background
+
+The following phase-design notes are retained only for historical design context and are not the maintained starting point for feature documentation:
 
 - `PHASE4_DESIGN.md`
 - `PHASE5_1_FEATURE_GUIDE.md`
 - `PHASE6_DESIGN.md`
 - `PHASE6_3_DESIGN.md`
 
-## Validation and Testing
-
-- `EF_CORE_TEST_DOCUMENTATION.md`
-- `EF_CORE_DOCUMENTATION_INDEX.md`
-
 ## Notes
 
-Historical kickoff/progress/completion snapshots were removed as obsolete and are no longer part of the maintained documentation path.
+Historical kickoff, status, and duplicate progress notes should be removed during documentation maintenance instead of being added to the canonical reading path.