add hnsw-rabitq

Author: egolearner

.github/ISSUE_TEMPLATE/benchmark.yml

@@ -0,0 +1,49 @@
+name: Benchmarking
+description: Add, update, or fix benchmark cases for zvec
+title: "[Benchmark]: "
+labels: ["benchmark"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Use this for benchmark-related work: new test cases, CI integration, or performance regression tracking.
+  
+  - type: input
+    id: benchmark_type
+    attributes:
+      label: Benchmark Type
+      description: e.g., filtered search, batch insert, recall@k, ARM64 vs x86
+    validations:
+      required: true
+  
+  - type: textarea
+    id: goal
+    attributes:
+      label: Goal
+      description: What performance aspect are you measuring or improving?
+    validations:
+      required: true
+  
+  - type: textarea
+    id: methodology
+    attributes:
+      label: Methodology
+      description: Dataset, query size, hardware, metrics (latency, throughput, memory)
+    validations:
+      required: true
+  
+  - type: textarea
+    id: baseline
+    attributes:
+      label: Baseline (if applicable)
+      description: Current performance numbers or competing systems for comparison.
+    validations:
+      required: false
+  
+  - type: textarea
+    id: ci_integration
+    attributes:
+      label: CI Integration Plan
+      description: Should this run in CI? How often?
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/config.yml

@@ -1,9 +1,9 @@
 blank_issues_enabled: false
 contact_links:
   - name: Documentation
-    url: https://github.com/your-org/zvec#readme
-    about: Check the README, build guide, and API docs first.
+    url: https://zvec.org/en/
+    about: Check the quickstart, build guide, and API docs first.
 
   - name: Python API Examples
-    url: https://github.com/your-org/zvec/tree/main/examples
+    url: https://zvec.org/en/docs/quickstart/
     about: See working usage examples.

.github/ISSUE_TEMPLATE/enhancement.yml

@@ -0,0 +1,41 @@
+name: Enhancement
+description: Improve an existing feature or component
+title: "[Enhance]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        This template is for improving existing functionality (e.g., performance, usability, robustness).
+  
+  - type: input
+    id: component
+    attributes:
+      label: Affected Component
+      description: e.g., HNSW index, buffer manager, Python API
+    validations:
+      required: true
+  
+  - type: textarea
+    id: current
+    attributes:
+      label: Current Behavior
+      description: What is the current state and its limitations?
+    validations:
+      required: true
+  
+  - type: textarea
+    id: desired
+    attributes:
+      label: Desired Improvement
+      description: What should be improved and how?
+    validations:
+      required: true
+  
+  - type: textarea
+    id: impact
+    attributes:
+      label: Impact
+      description: How will this benefit users? (e.g., faster queries, lower memory, easier integration)
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -1,7 +1,7 @@
 name: Feature Request
 description: Suggest a new feature or improvement (e.g., better memory control, new query option)
 title: "[Feature]: "
-labels: ["enhancement"]
+labels: ["feature"]
 body:
   - type: markdown
     attributes:

.github/ISSUE_TEMPLATE/integration.yml

@@ -0,0 +1,36 @@
+name: Ecosystem Integration
+description: Integrate zvec with external frameworks (e.g., LangChain, LlamaIndex)
+title: "[Integration]: "
+labels: ["integration"]
+body:
+  - type: input
+    id: framework
+    attributes:
+      label: Target Framework
+      description: e.g., LangChain, LlamaIndex, Haystack
+    validations:
+      required: true
+  
+  - type: textarea
+    id: motivation
+    attributes:
+      label: Motivation
+      description: Why integrate with this framework? Who benefits?
+    validations:
+      required: true
+  
+  - type: textarea
+    id: interface
+    attributes:
+      label: Required Interface
+      description: What adapter or interface must be implemented? (e.g., VectorStore base class)
+    validations:
+      required: true
+  
+  - type: textarea
+    id: reference
+    attributes:
+      label: Reference Implementations
+      description: Links to similar integrations in other vector DBs.
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/profiling.yml

@@ -0,0 +1,41 @@
+name: Profiling / Investigation
+description: Profile performance, compatibility, or behavior in a specific scenario
+title: "[Profile]: "
+labels: ["profile"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Use this for tasks like performance profiling, architecture compatibility checks, or feasibility studies.
+  
+  - type: input
+    id: scenario
+    attributes:
+      label: Target Scenario
+      description: e.g., ARM64 deployment, high-concurrency load, large dataset ingestion
+    validations:
+      required: true
+  
+  - type: textarea
+    id: objective
+    attributes:
+      label: Objective
+      description: What do you want to learn or validate?
+    validations:
+      required: true
+  
+  - type: textarea
+    id: methodology
+    attributes:
+      label: Proposed Methodology
+      description: How will you conduct the investigation? (tools, metrics, test data)
+    validations:
+      required: true
+  
+  - type: textarea
+    id: expected_outcome
+    attributes:
+      label: Expected Outcome
+      description: What deliverables are expected? (e.g., report, optimization PR, benchmark results)
+    validations:
+      required: true

.github/workflows/linux_x64_docker_ci.yml

@@ -3,8 +3,13 @@ name: Zvec LinuxX64 CI
 on:
   push:
     branches: [ "main" ]
+    paths-ignore:
+      - '**.md'
+  merge_group:
   pull_request:
     branches: [ "main" ]
+    paths-ignore:
+      - '**.md'
   workflow_dispatch:
 
 concurrency:
@@ -59,8 +64,9 @@ jobs:
           git config --global --add safe.directory "$CLEAN_WORKSPACE"
           git clone --recursive "https://x-access-token:${GITHUB_TOKEN}@github.com/${GITHUB_REPOSITORY}.git" .
 
-          if [ -n "${{ github.event.pull_request.head.sha }}" ]; then
-            git checkout "${{ github.event.pull_request.head.sha }}"
+          if [ -n "${{ github.event.number }}" ]; then
+            git fetch origin "pull/${{ github.event.number }}/head"
+            git checkout FETCH_HEAD
           else
             git checkout "${{ github.sha }}"
           fi
@@ -115,7 +121,8 @@ jobs:
           
           CMAKE_GENERATOR="Unix Makefiles" \
           CMAKE_BUILD_PARALLEL_LEVEL="$NPROC" \
-          pip install -v .
+          pip install -v . \
+            --config-settings='cmake.define.BUILD_TOOLS="ON"'
         shell: bash
 
       - name: Run Python Tests with Coverage

.github/workflows/mac_arm64_ci.yml

@@ -3,8 +3,13 @@ name: Zvec MacArm64 CI
 on:
   push:
     branches: [ "main" ]
+    paths-ignore:
+      - '**.md'
+  merge_group:
   pull_request:
     branches: [ "main" ]
+    paths-ignore:
+      - '**.md'
   workflow_dispatch:
 
 concurrency:
@@ -62,8 +67,9 @@ jobs:
           git config --global --add safe.directory "$CLEAN_WORKSPACE"
           git clone --recursive "https://x-access-token:${GITHUB_TOKEN}@github.com/${GITHUB_REPOSITORY}.git" .
 
-          if [ -n "${{ github.event.pull_request.head.sha }}" ]; then
-            git checkout "${{ github.event.pull_request.head.sha }}"
+          if [ -n "${{ github.event.number }}" ]; then
+            git fetch origin "pull/${{ github.event.number }}/head"
+            git checkout FETCH_HEAD
           else
             git checkout "${{ github.sha }}"
           fi
@@ -83,7 +89,8 @@ jobs:
           
           CMAKE_GENERATOR="Unix Makefiles" \
           CMAKE_BUILD_PARALLEL_LEVEL="$NPROC" \
-          pip install -v .
+          pip install -v . \
+            --config-settings='cmake.define.BUILD_TOOLS="ON"'
         shell: bash
 
       - name: Run Python Tests with Coverage
@@ -96,4 +103,4 @@ jobs:
         run: |
           cd "$CLEAN_WORKSPACE/build"
           make unittest -j 16
-        shell: bash
+        shell: bash

.gitignore

@@ -1,7 +1,7 @@
 .*
 *~
 bazel-*
-/*build*
+build*
 bin/*
 lib/*
 var/*

CMakeLists.txt

@@ -19,6 +19,7 @@ message(STATUS "PROJECT_ROOT_DIR = ${PROJECT_ROOT_DIR}")
 
 include(${PROJECT_ROOT_DIR}/cmake/bazel.cmake)
 
+include_directories(${PROJECT_ROOT_DIR}/src/include)
 include_directories(${PROJECT_ROOT_DIR}/src)
 
 option(BUILD_PYTHON_BINDINGS "Build Python bindings using pybind11" OFF)
@@ -33,7 +34,7 @@ cc_directories(tests)
 
 if(BUILD_TOOLS)
     cc_directories(tools)
-endif ()
+endif()
 
 git_version(GIT_SRCS_VER ${PROJECT_ROOT_DIR})
 set(CPACK_PACKAGE_VERSION ${GIT_SRCS_VER})