feat: update vector search parameters and improve documentation

- Changed `overquery_factor` to `ef_search` in multiple examples and tests for clarity and consistency.
- Updated README and test documentation to reflect the increase in test coverage from 277 to 282 passed tests.
- Enhanced error handling for `ef_search` values in vector index operations.
- Improved comments and descriptions in the core and vector modules for better understanding of parameters.

Author: tae898

.github/workflows/test-python-examples.yml

@@ -367,7 +367,7 @@ jobs:
                   echo ""
                   continue
                 fi
-                example_args="--backend arcadedb_sql --dataset stackoverflow-tiny --db-path $db_path --overquery-factors 1 --k 10 --query-limit 100 --query-runs 1 --query-order fixed --threads 1 --mem-limit 2g --run-label ci12_arcadedb_sql"
+                example_args="--backend arcadedb_sql --dataset stackoverflow-tiny --db-path $db_path --ef-search-values 100 --k 10 --query-limit 100 --query-runs 1 --query-order fixed --threads 1 --mem-limit 2g --run-label ci12_arcadedb_sql"
                 example_name="$example (vector search, arcadedb_sql backend, minimal)"
                 timeout_duration=1200
                 example_jvm_args=""

bindings/python/README.md

@@ -2,7 +2,7 @@
 
 Native Python bindings for ArcadeDB - the multi-model database that supports Graph, Document, Key/Value, Search Engine, Time Series, and Vector models.
 
-**Status**: ✅ Production Ready | **Tests**: 277 Passed Across 27 Test Files | **Platforms**: 4 Supported
+**Status**: ✅ Production Ready | **Tests**: 282 Passed | **Platforms**: 4 Supported
 
 ---
 
@@ -92,7 +92,7 @@ Import: `import arcadedb_embedded as arcadedb`
 
 ## 🧪 Testing
 
-**Status**: 277 passed across 27 test files
+**Status**: 282 passed
 
 ```bash
 # Run all tests

bindings/python/examples/11_vector_index_build.py

@@ -1931,10 +1931,12 @@ def main() -> None:
         args.run_label = args.run_label.strip().replace("/", "-").replace(" ", "_")
     if args.jvm_heap_fraction <= 0 or args.jvm_heap_fraction > 1:
         parser.error("--jvm-heap-fraction must be > 0 and <= 1")
-    args.qdrant_image = resolve_qdrant_image(args.qdrant_image)
-    args.milvus_compose_version = resolve_milvus_compose_version(
-        args.milvus_compose_version
-    )
+    if args.backend == "qdrant":
+        args.qdrant_image = resolve_qdrant_image(args.qdrant_image)
+    if args.backend == "milvus":
+        args.milvus_compose_version = resolve_milvus_compose_version(
+            args.milvus_compose_version
+        )
     if args.backend == "pgvector" and args.docker_image == "python:3.12-slim":
         args.docker_image = resolve_latest_pgvector_image()
     configure_reproducibility(args.seed)