Vector safe check in

Author: MPCoreDeveloper

.github/copilot-instructions.md

@@ -2,6 +2,7 @@
 
 ## General Guidelines
 - Test programs should be located in the `tests` folder and not in the repository root.
+- All project documentation must be written in English. This includes docs, README files, technical specs, implementation plans, and code comments.
 
 ## Code Style
 - Use specific formatting rules

SharpCoreDB.sln

@@ -1,3 +1,4 @@
+
 Microsoft Visual Studio Solution File, Format Version 12.00
 # Visual Studio Version 18
 VisualStudioVersion = 18.1.11312.151
@@ -68,6 +69,8 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Snippets", "Snippets", "{53
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "RefFieldDemo", "tests\Manual\RefFieldDemo\RefFieldDemo.csproj", "{800EBE19-FE8B-EBD4-D5F7-AFB27C1755A0}"
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SharpCoreDB.VectorSearch", "src\SharpCoreDB.VectorSearch\SharpCoreDB.VectorSearch.csproj", "{5E39577A-E286-45E9-9801-E8DC8F81ED7D}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -270,6 +273,18 @@ Global
 		{800EBE19-FE8B-EBD4-D5F7-AFB27C1755A0}.Release|x64.Build.0 = Release|Any CPU
 		{800EBE19-FE8B-EBD4-D5F7-AFB27C1755A0}.Release|x86.ActiveCfg = Release|Any CPU
 		{800EBE19-FE8B-EBD4-D5F7-AFB27C1755A0}.Release|x86.Build.0 = Release|Any CPU
+		{5E39577A-E286-45E9-9801-E8DC8F81ED7D}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{5E39577A-E286-45E9-9801-E8DC8F81ED7D}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{5E39577A-E286-45E9-9801-E8DC8F81ED7D}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{5E39577A-E286-45E9-9801-E8DC8F81ED7D}.Debug|x64.Build.0 = Debug|Any CPU
+		{5E39577A-E286-45E9-9801-E8DC8F81ED7D}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{5E39577A-E286-45E9-9801-E8DC8F81ED7D}.Debug|x86.Build.0 = Debug|Any CPU
+		{5E39577A-E286-45E9-9801-E8DC8F81ED7D}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{5E39577A-E286-45E9-9801-E8DC8F81ED7D}.Release|Any CPU.Build.0 = Release|Any CPU
+		{5E39577A-E286-45E9-9801-E8DC8F81ED7D}.Release|x64.ActiveCfg = Release|Any CPU
+		{5E39577A-E286-45E9-9801-E8DC8F81ED7D}.Release|x64.Build.0 = Release|Any CPU
+		{5E39577A-E286-45E9-9801-E8DC8F81ED7D}.Release|x86.ActiveCfg = Release|Any CPU
+		{5E39577A-E286-45E9-9801-E8DC8F81ED7D}.Release|x86.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
@@ -297,6 +312,7 @@ Global
 		{A0C49171-D013-CE79-41C2-2B01E3F6E0BF} = {F4AC329D-E0EF-4EC6-A21B-DD74A344A3A5}
 		{53FBF8A2-0A92-44AD-9CD0-4FBDF7F62C9B} = {2F8A8533-DAA8-4CF9-A6C0-2F663AF7FD2E}
 		{800EBE19-FE8B-EBD4-D5F7-AFB27C1755A0} = {A1B2C3D4-E5F6-4A7B-8C9D-0E1F2A3B4C5D}
+		{5E39577A-E286-45E9-9801-E8DC8F81ED7D} = {F8B5E3A4-1C2D-4E5F-8B9A-1D2E3F4A5B6C}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {F40825F5-26A1-4E85-9D0A-B0121A7ED5F8}

docs/CHANGELOG.md

@@ -5,6 +5,39 @@ All notable changes to SharpCoreDB will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.0] - Unreleased
+
+### ✨ Added
+- **Vector Search Extension** (`SharpCoreDB.VectorSearch` NuGet package)
+  - SIMD-accelerated distance metrics: cosine, Euclidean (L2), dot product
+  - `System.Numerics.Vector<float>` auto-selects widest SIMD: AVX-512 → AVX2 → SSE2/NEON → scalar
+  - HNSW approximate nearest neighbor index with configurable M, efConstruction, efSearch
+  - Flat (brute-force) exact search index for small datasets or perfect recall
+  - Binary format for vector serialization with magic bytes, version header, and zero-copy spans
+  - Scalar quantization (float32 → uint8, 4× memory reduction)
+  - Binary quantization (float32 → 1 bit, 32× memory reduction with Hamming distance)
+  - HNSW graph persistence (serialize/deserialize for database restart)
+  - Seven SQL functions: `vec_distance_cosine`, `vec_distance_l2`, `vec_distance_dot`, `vec_from_float32`, `vec_to_json`, `vec_normalize`, `vec_dimensions`
+  - DI registration: `services.AddVectorSupport()` with configuration presets (Embedded, Standard, Enterprise)
+  - Zero overhead when not registered — all vector support is 100% optional
+- **Core: Extension Provider System**
+  - `ICustomFunctionProvider` interface for pluggable SQL functions
+  - `ICustomTypeProvider` interface for pluggable data types
+  - `DataType.Vector` enum value (stored as BLOB internally)
+  - `VECTOR(N)` column type parsing in CREATE TABLE
+  - `ColumnDefinition.Dimensions` for VECTOR(N) metadata
+  - `ITable.Metadata` extensible key-value store for optional features
+- **DDL: Vector Index Management**
+  - `CREATE VECTOR INDEX idx ON table(col) USING FLAT|HNSW`
+  - `DROP VECTOR INDEX idx ON table`
+  - Vector column type validation at index creation time
+
+### 📊 Version Info
+- **Package Version**: 1.2.0
+- **New Package**: SharpCoreDB.VectorSearch 1.2.0
+- **Target Framework**: .NET 10 / C# 14
+- **Breaking Changes**: None — 100% backward compatible
+
 ## [1.1.1] - 2026-02-08
 
 ### 🐛 Fixed