From 8b64616fd6eed83b18e6bdd370af820a8ee65e8f Mon Sep 17 00:00:00 2001
From: zhenghaoz <zhangzhenghao@hotmail.com>
Date: Mon, 24 Aug 2026 22:31:26 +0800
Subject: [PATCH] refactor(core): align layout with zvec

---
 collection.go                                                   | 2 +-
 collection_test.go                                              | 2 +-
 internal/core/{refiner.go => algorithm/basic_refiner.go}        | 0
 .../core/{refiner_test.go => algorithm/basic_refiner_test.go}   | 0
 internal/core/{kmeans.go => algorithm/cluster_algorithm.go}     | 0
 .../{kmeans_test.go => algorithm/cluster_algorithm_test.go}     | 0
 internal/core/{diskann.go => algorithm/diskann_algorithm.go}    | 0
 .../{diskann_test.go => algorithm/diskann_algorithm_test.go}    | 0
 internal/core/{ => algorithm}/diskann_example_test.go           | 2 +-
 .../core/{diskann_io.go => algorithm/diskann_file_reader.go}    | 0
 internal/core/{diskann_cache.go => algorithm/diskann_holder.go} | 0
 .../{diskann_storage.go => algorithm/diskann_index_format.go}   | 0
 .../diskann_index_format_test.go}                               | 0
 internal/core/{ => algorithm}/diskann_quantized.go              | 0
 internal/core/{ => algorithm}/diskann_quantized_test.go         | 0
 internal/core/{ => algorithm}/diskann_storage_example_test.go   | 2 +-
 internal/core/{ => algorithm}/file_mode_test.go                 | 0
 internal/core/{flat.go => algorithm/flat_algorithm.go}          | 0
 .../core/{flat_test.go => algorithm/flat_algorithm_test.go}     | 0
 internal/core/{hnsw.go => algorithm/hnsw_algorithm.go}          | 0
 .../core/{hnsw_test.go => algorithm/hnsw_algorithm_test.go}     | 0
 internal/core/{hnsw_parallel.go => algorithm/hnsw_builder.go}   | 0
 .../core/{group_by_hnsw.go => algorithm/hnsw_group_searcher.go} | 0
 .../hnsw_group_searcher_test.go}                                | 0
 .../{hnsw_quantized.go => algorithm/hnsw_quantized_searcher.go} | 0
 .../core/{hnsw_rabitq.go => algorithm/hnsw_rabitq_algorithm.go} | 0
 internal/core/{ => algorithm}/hnsw_rabitq_example_test.go       | 2 +-
 internal/core/{ => algorithm}/hnsw_rabitq_test.go               | 0
 .../core/{hnsw_sparse.go => algorithm/hnsw_sparse_algorithm.go} | 0
 internal/core/{ => algorithm}/hnsw_sparse_test.go               | 0
 internal/core/{hnsw_prefetch.go => algorithm/hnsw_utility.go}   | 0
 .../core/{hnsw_visited.go => algorithm/hnsw_visit_filter.go}    | 0
 .../hnsw_visit_filter_test.go}                                  | 0
 internal/core/{query.go => algorithm/index_flow.go}             | 0
 internal/core/{query_test.go => algorithm/index_flow_test.go}   | 0
 .../core/{quantization.go => algorithm/integer_quantizer.go}    | 0
 .../integer_quantizer_test.go}                                  | 0
 internal/core/{ivf.go => algorithm/ivf_algorithm.go}            | 0
 internal/core/{ivf_test.go => algorithm/ivf_algorithm_test.go}  | 0
 .../{ivf_quantized.go => algorithm/ivf_quantized_searcher.go}   | 0
 internal/core/{ => algorithm}/pq_example_test.go                | 2 +-
 internal/core/{pq.go => algorithm/pq_quantizer.go}              | 0
 internal/core/{pq_test.go => algorithm/pq_quantizer_test.go}    | 0
 .../quantized_flat_searcher.go}                                 | 0
 .../quantized_flat_searcher_test.go}                            | 0
 internal/core/{rabitq.go => algorithm/rabitq_converter.go}      | 0
 .../core/{rabitq_test.go => algorithm/rabitq_converter_test.go} | 0
 internal/core/{ => algorithm}/rabitq_example_test.go            | 2 +-
 .../core/{rabitq_quantize.go => algorithm/rabitq_reformer.go}   | 0
 internal/core/{rotation.go => algorithm/rotator.go}             | 0
 internal/core/{rotation_test.go => algorithm/rotator_test.go}   | 0
 internal/core/{ => algorithm}/sparse_refiner.go                 | 0
 internal/core/{ => algorithm}/sparse_refiner_test.go            | 0
 internal/core/{topk.go => algorithm/topk_result_builder.go}     | 0
 .../{topk_test.go => algorithm/topk_result_builder_test.go}     | 0
 internal/core/{vamana.go => algorithm/vamana_algorithm.go}      | 0
 .../core/{vamana_test.go => algorithm/vamana_algorithm_test.go} | 0
 internal/core/{ => algorithm}/vamana_example_test.go            | 2 +-
 .../vamana_quantized_searcher.go}                               | 0
 reranker_weighted.go                                            | 2 +-
 60 files changed, 9 insertions(+), 9 deletions(-)
 rename internal/core/{refiner.go => algorithm/basic_refiner.go} (100%)
 rename internal/core/{refiner_test.go => algorithm/basic_refiner_test.go} (100%)
 rename internal/core/{kmeans.go => algorithm/cluster_algorithm.go} (100%)
 rename internal/core/{kmeans_test.go => algorithm/cluster_algorithm_test.go} (100%)
 rename internal/core/{diskann.go => algorithm/diskann_algorithm.go} (100%)
 rename internal/core/{diskann_test.go => algorithm/diskann_algorithm_test.go} (100%)
 rename internal/core/{ => algorithm}/diskann_example_test.go (96%)
 rename internal/core/{diskann_io.go => algorithm/diskann_file_reader.go} (100%)
 rename internal/core/{diskann_cache.go => algorithm/diskann_holder.go} (100%)
 rename internal/core/{diskann_storage.go => algorithm/diskann_index_format.go} (100%)
 rename internal/core/{diskann_storage_test.go => algorithm/diskann_index_format_test.go} (100%)
 rename internal/core/{ => algorithm}/diskann_quantized.go (100%)
 rename internal/core/{ => algorithm}/diskann_quantized_test.go (100%)
 rename internal/core/{ => algorithm}/diskann_storage_example_test.go (94%)
 rename internal/core/{ => algorithm}/file_mode_test.go (100%)
 rename internal/core/{flat.go => algorithm/flat_algorithm.go} (100%)
 rename internal/core/{flat_test.go => algorithm/flat_algorithm_test.go} (100%)
 rename internal/core/{hnsw.go => algorithm/hnsw_algorithm.go} (100%)
 rename internal/core/{hnsw_test.go => algorithm/hnsw_algorithm_test.go} (100%)
 rename internal/core/{hnsw_parallel.go => algorithm/hnsw_builder.go} (100%)
 rename internal/core/{group_by_hnsw.go => algorithm/hnsw_group_searcher.go} (100%)
 rename internal/core/{group_by_hnsw_test.go => algorithm/hnsw_group_searcher_test.go} (100%)
 rename internal/core/{hnsw_quantized.go => algorithm/hnsw_quantized_searcher.go} (100%)
 rename internal/core/{hnsw_rabitq.go => algorithm/hnsw_rabitq_algorithm.go} (100%)
 rename internal/core/{ => algorithm}/hnsw_rabitq_example_test.go (97%)
 rename internal/core/{ => algorithm}/hnsw_rabitq_test.go (100%)
 rename internal/core/{hnsw_sparse.go => algorithm/hnsw_sparse_algorithm.go} (100%)
 rename internal/core/{ => algorithm}/hnsw_sparse_test.go (100%)
 rename internal/core/{hnsw_prefetch.go => algorithm/hnsw_utility.go} (100%)
 rename internal/core/{hnsw_visited.go => algorithm/hnsw_visit_filter.go} (100%)
 rename internal/core/{hnsw_visited_test.go => algorithm/hnsw_visit_filter_test.go} (100%)
 rename internal/core/{query.go => algorithm/index_flow.go} (100%)
 rename internal/core/{query_test.go => algorithm/index_flow_test.go} (100%)
 rename internal/core/{quantization.go => algorithm/integer_quantizer.go} (100%)
 rename internal/core/{quantization_test.go => algorithm/integer_quantizer_test.go} (100%)
 rename internal/core/{ivf.go => algorithm/ivf_algorithm.go} (100%)
 rename internal/core/{ivf_test.go => algorithm/ivf_algorithm_test.go} (100%)
 rename internal/core/{ivf_quantized.go => algorithm/ivf_quantized_searcher.go} (100%)
 rename internal/core/{ => algorithm}/pq_example_test.go (95%)
 rename internal/core/{pq.go => algorithm/pq_quantizer.go} (100%)
 rename internal/core/{pq_test.go => algorithm/pq_quantizer_test.go} (100%)
 rename internal/core/{quantized_index.go => algorithm/quantized_flat_searcher.go} (100%)
 rename internal/core/{quantized_index_test.go => algorithm/quantized_flat_searcher_test.go} (100%)
 rename internal/core/{rabitq.go => algorithm/rabitq_converter.go} (100%)
 rename internal/core/{rabitq_test.go => algorithm/rabitq_converter_test.go} (100%)
 rename internal/core/{ => algorithm}/rabitq_example_test.go (96%)
 rename internal/core/{rabitq_quantize.go => algorithm/rabitq_reformer.go} (100%)
 rename internal/core/{rotation.go => algorithm/rotator.go} (100%)
 rename internal/core/{rotation_test.go => algorithm/rotator_test.go} (100%)
 rename internal/core/{ => algorithm}/sparse_refiner.go (100%)
 rename internal/core/{ => algorithm}/sparse_refiner_test.go (100%)
 rename internal/core/{topk.go => algorithm/topk_result_builder.go} (100%)
 rename internal/core/{topk_test.go => algorithm/topk_result_builder_test.go} (100%)
 rename internal/core/{vamana.go => algorithm/vamana_algorithm.go} (100%)
 rename internal/core/{vamana_test.go => algorithm/vamana_algorithm_test.go} (100%)
 rename internal/core/{ => algorithm}/vamana_example_test.go (96%)
 rename internal/core/{vamana_quantized.go => algorithm/vamana_quantized_searcher.go} (100%)

diff --git a/collection.go b/collection.go
index bf27019..5556fb1 100644
--- a/collection.go
+++ b/collection.go
@@ -38,7 +38,7 @@ import (
 	"github.com/gorse-io/xvec/internal/ailego/io"
 	"github.com/gorse-io/xvec/internal/ailego/parallel"
 	"github.com/gorse-io/xvec/internal/ailego/utility"
-	"github.com/gorse-io/xvec/internal/core"
+	"github.com/gorse-io/xvec/internal/core/algorithm"
 	"github.com/gorse-io/xvec/internal/db"
 	"github.com/gorse-io/xvec/internal/db/index/column/fts_column"
 	"github.com/gorse-io/xvec/internal/db/index/column/fts_column/tokenizer"
diff --git a/collection_test.go b/collection_test.go
index 36ddddd..ed7cfed 100644
--- a/collection_test.go
+++ b/collection_test.go
@@ -32,7 +32,7 @@ import (
 
 	"github.com/gofrs/flock"
 	"github.com/gorse-io/xvec/internal/ailego/math"
-	"github.com/gorse-io/xvec/internal/core"
+	"github.com/gorse-io/xvec/internal/core/algorithm"
 	"github.com/gorse-io/xvec/internal/db"
 	"github.com/gorse-io/xvec/internal/db/index/column/fts_column/tokenizer"
 	"github.com/gorse-io/xvec/internal/db/index/common"
diff --git a/internal/core/refiner.go b/internal/core/algorithm/basic_refiner.go
similarity index 100%
rename from internal/core/refiner.go
rename to internal/core/algorithm/basic_refiner.go
diff --git a/internal/core/refiner_test.go b/internal/core/algorithm/basic_refiner_test.go
similarity index 100%
rename from internal/core/refiner_test.go
rename to internal/core/algorithm/basic_refiner_test.go
diff --git a/internal/core/kmeans.go b/internal/core/algorithm/cluster_algorithm.go
similarity index 100%
rename from internal/core/kmeans.go
rename to internal/core/algorithm/cluster_algorithm.go
diff --git a/internal/core/kmeans_test.go b/internal/core/algorithm/cluster_algorithm_test.go
similarity index 100%
rename from internal/core/kmeans_test.go
rename to internal/core/algorithm/cluster_algorithm_test.go
diff --git a/internal/core/diskann.go b/internal/core/algorithm/diskann_algorithm.go
similarity index 100%
rename from internal/core/diskann.go
rename to internal/core/algorithm/diskann_algorithm.go
diff --git a/internal/core/diskann_test.go b/internal/core/algorithm/diskann_algorithm_test.go
similarity index 100%
rename from internal/core/diskann_test.go
rename to internal/core/algorithm/diskann_algorithm_test.go
diff --git a/internal/core/diskann_example_test.go b/internal/core/algorithm/diskann_example_test.go
similarity index 96%
rename from internal/core/diskann_example_test.go
rename to internal/core/algorithm/diskann_example_test.go
index f5a99b0..1552306 100644
--- a/internal/core/diskann_example_test.go
+++ b/internal/core/algorithm/diskann_example_test.go
@@ -18,7 +18,7 @@ import (
 	"context"
 	"fmt"
 
-	"github.com/gorse-io/xvec/internal/core"
+	"github.com/gorse-io/xvec/internal/core/algorithm"
 )
 
 func ExampleDiskANNIndex() {
diff --git a/internal/core/diskann_io.go b/internal/core/algorithm/diskann_file_reader.go
similarity index 100%
rename from internal/core/diskann_io.go
rename to internal/core/algorithm/diskann_file_reader.go
diff --git a/internal/core/diskann_cache.go b/internal/core/algorithm/diskann_holder.go
similarity index 100%
rename from internal/core/diskann_cache.go
rename to internal/core/algorithm/diskann_holder.go
diff --git a/internal/core/diskann_storage.go b/internal/core/algorithm/diskann_index_format.go
similarity index 100%
rename from internal/core/diskann_storage.go
rename to internal/core/algorithm/diskann_index_format.go
diff --git a/internal/core/diskann_storage_test.go b/internal/core/algorithm/diskann_index_format_test.go
similarity index 100%
rename from internal/core/diskann_storage_test.go
rename to internal/core/algorithm/diskann_index_format_test.go
diff --git a/internal/core/diskann_quantized.go b/internal/core/algorithm/diskann_quantized.go
similarity index 100%
rename from internal/core/diskann_quantized.go
rename to internal/core/algorithm/diskann_quantized.go
diff --git a/internal/core/diskann_quantized_test.go b/internal/core/algorithm/diskann_quantized_test.go
similarity index 100%
rename from internal/core/diskann_quantized_test.go
rename to internal/core/algorithm/diskann_quantized_test.go
diff --git a/internal/core/diskann_storage_example_test.go b/internal/core/algorithm/diskann_storage_example_test.go
similarity index 94%
rename from internal/core/diskann_storage_example_test.go
rename to internal/core/algorithm/diskann_storage_example_test.go
index b864d8e..2f5abdc 100644
--- a/internal/core/diskann_storage_example_test.go
+++ b/internal/core/algorithm/diskann_storage_example_test.go
@@ -17,7 +17,7 @@ package core_test
 import (
 	"fmt"
 
-	"github.com/gorse-io/xvec/internal/core"
+	"github.com/gorse-io/xvec/internal/core/algorithm"
 )
 
 func ExampleNewDiskANNLayout() {
diff --git a/internal/core/file_mode_test.go b/internal/core/algorithm/file_mode_test.go
similarity index 100%
rename from internal/core/file_mode_test.go
rename to internal/core/algorithm/file_mode_test.go
diff --git a/internal/core/flat.go b/internal/core/algorithm/flat_algorithm.go
similarity index 100%
rename from internal/core/flat.go
rename to internal/core/algorithm/flat_algorithm.go
diff --git a/internal/core/flat_test.go b/internal/core/algorithm/flat_algorithm_test.go
similarity index 100%
rename from internal/core/flat_test.go
rename to internal/core/algorithm/flat_algorithm_test.go
diff --git a/internal/core/hnsw.go b/internal/core/algorithm/hnsw_algorithm.go
similarity index 100%
rename from internal/core/hnsw.go
rename to internal/core/algorithm/hnsw_algorithm.go
diff --git a/internal/core/hnsw_test.go b/internal/core/algorithm/hnsw_algorithm_test.go
similarity index 100%
rename from internal/core/hnsw_test.go
rename to internal/core/algorithm/hnsw_algorithm_test.go
diff --git a/internal/core/hnsw_parallel.go b/internal/core/algorithm/hnsw_builder.go
similarity index 100%
rename from internal/core/hnsw_parallel.go
rename to internal/core/algorithm/hnsw_builder.go
diff --git a/internal/core/group_by_hnsw.go b/internal/core/algorithm/hnsw_group_searcher.go
similarity index 100%
rename from internal/core/group_by_hnsw.go
rename to internal/core/algorithm/hnsw_group_searcher.go
diff --git a/internal/core/group_by_hnsw_test.go b/internal/core/algorithm/hnsw_group_searcher_test.go
similarity index 100%
rename from internal/core/group_by_hnsw_test.go
rename to internal/core/algorithm/hnsw_group_searcher_test.go
diff --git a/internal/core/hnsw_quantized.go b/internal/core/algorithm/hnsw_quantized_searcher.go
similarity index 100%
rename from internal/core/hnsw_quantized.go
rename to internal/core/algorithm/hnsw_quantized_searcher.go
diff --git a/internal/core/hnsw_rabitq.go b/internal/core/algorithm/hnsw_rabitq_algorithm.go
similarity index 100%
rename from internal/core/hnsw_rabitq.go
rename to internal/core/algorithm/hnsw_rabitq_algorithm.go
diff --git a/internal/core/hnsw_rabitq_example_test.go b/internal/core/algorithm/hnsw_rabitq_example_test.go
similarity index 97%
rename from internal/core/hnsw_rabitq_example_test.go
rename to internal/core/algorithm/hnsw_rabitq_example_test.go
index c4ca5ae..469a706 100644
--- a/internal/core/hnsw_rabitq_example_test.go
+++ b/internal/core/algorithm/hnsw_rabitq_example_test.go
@@ -18,7 +18,7 @@ import (
 	"context"
 	"fmt"
 
-	"github.com/gorse-io/xvec/internal/core"
+	"github.com/gorse-io/xvec/internal/core/algorithm"
 )
 
 func ExampleHNSWRaBitQBuilder() {
diff --git a/internal/core/hnsw_rabitq_test.go b/internal/core/algorithm/hnsw_rabitq_test.go
similarity index 100%
rename from internal/core/hnsw_rabitq_test.go
rename to internal/core/algorithm/hnsw_rabitq_test.go
diff --git a/internal/core/hnsw_sparse.go b/internal/core/algorithm/hnsw_sparse_algorithm.go
similarity index 100%
rename from internal/core/hnsw_sparse.go
rename to internal/core/algorithm/hnsw_sparse_algorithm.go
diff --git a/internal/core/hnsw_sparse_test.go b/internal/core/algorithm/hnsw_sparse_test.go
similarity index 100%
rename from internal/core/hnsw_sparse_test.go
rename to internal/core/algorithm/hnsw_sparse_test.go
diff --git a/internal/core/hnsw_prefetch.go b/internal/core/algorithm/hnsw_utility.go
similarity index 100%
rename from internal/core/hnsw_prefetch.go
rename to internal/core/algorithm/hnsw_utility.go
diff --git a/internal/core/hnsw_visited.go b/internal/core/algorithm/hnsw_visit_filter.go
similarity index 100%
rename from internal/core/hnsw_visited.go
rename to internal/core/algorithm/hnsw_visit_filter.go
diff --git a/internal/core/hnsw_visited_test.go b/internal/core/algorithm/hnsw_visit_filter_test.go
similarity index 100%
rename from internal/core/hnsw_visited_test.go
rename to internal/core/algorithm/hnsw_visit_filter_test.go
diff --git a/internal/core/query.go b/internal/core/algorithm/index_flow.go
similarity index 100%
rename from internal/core/query.go
rename to internal/core/algorithm/index_flow.go
diff --git a/internal/core/query_test.go b/internal/core/algorithm/index_flow_test.go
similarity index 100%
rename from internal/core/query_test.go
rename to internal/core/algorithm/index_flow_test.go
diff --git a/internal/core/quantization.go b/internal/core/algorithm/integer_quantizer.go
similarity index 100%
rename from internal/core/quantization.go
rename to internal/core/algorithm/integer_quantizer.go
diff --git a/internal/core/quantization_test.go b/internal/core/algorithm/integer_quantizer_test.go
similarity index 100%
rename from internal/core/quantization_test.go
rename to internal/core/algorithm/integer_quantizer_test.go
diff --git a/internal/core/ivf.go b/internal/core/algorithm/ivf_algorithm.go
similarity index 100%
rename from internal/core/ivf.go
rename to internal/core/algorithm/ivf_algorithm.go
diff --git a/internal/core/ivf_test.go b/internal/core/algorithm/ivf_algorithm_test.go
similarity index 100%
rename from internal/core/ivf_test.go
rename to internal/core/algorithm/ivf_algorithm_test.go
diff --git a/internal/core/ivf_quantized.go b/internal/core/algorithm/ivf_quantized_searcher.go
similarity index 100%
rename from internal/core/ivf_quantized.go
rename to internal/core/algorithm/ivf_quantized_searcher.go
diff --git a/internal/core/pq_example_test.go b/internal/core/algorithm/pq_example_test.go
similarity index 95%
rename from internal/core/pq_example_test.go
rename to internal/core/algorithm/pq_example_test.go
index 624f9fb..35aac12 100644
--- a/internal/core/pq_example_test.go
+++ b/internal/core/algorithm/pq_example_test.go
@@ -18,7 +18,7 @@ import (
 	"context"
 	"fmt"
 
-	"github.com/gorse-io/xvec/internal/core"
+	"github.com/gorse-io/xvec/internal/core/algorithm"
 )
 
 func ExampleTrainPQ() {
diff --git a/internal/core/pq.go b/internal/core/algorithm/pq_quantizer.go
similarity index 100%
rename from internal/core/pq.go
rename to internal/core/algorithm/pq_quantizer.go
diff --git a/internal/core/pq_test.go b/internal/core/algorithm/pq_quantizer_test.go
similarity index 100%
rename from internal/core/pq_test.go
rename to internal/core/algorithm/pq_quantizer_test.go
diff --git a/internal/core/quantized_index.go b/internal/core/algorithm/quantized_flat_searcher.go
similarity index 100%
rename from internal/core/quantized_index.go
rename to internal/core/algorithm/quantized_flat_searcher.go
diff --git a/internal/core/quantized_index_test.go b/internal/core/algorithm/quantized_flat_searcher_test.go
similarity index 100%
rename from internal/core/quantized_index_test.go
rename to internal/core/algorithm/quantized_flat_searcher_test.go
diff --git a/internal/core/rabitq.go b/internal/core/algorithm/rabitq_converter.go
similarity index 100%
rename from internal/core/rabitq.go
rename to internal/core/algorithm/rabitq_converter.go
diff --git a/internal/core/rabitq_test.go b/internal/core/algorithm/rabitq_converter_test.go
similarity index 100%
rename from internal/core/rabitq_test.go
rename to internal/core/algorithm/rabitq_converter_test.go
diff --git a/internal/core/rabitq_example_test.go b/internal/core/algorithm/rabitq_example_test.go
similarity index 96%
rename from internal/core/rabitq_example_test.go
rename to internal/core/algorithm/rabitq_example_test.go
index 08fac25..a0f3817 100644
--- a/internal/core/rabitq_example_test.go
+++ b/internal/core/algorithm/rabitq_example_test.go
@@ -18,7 +18,7 @@ import (
 	"context"
 	"fmt"
 
-	"github.com/gorse-io/xvec/internal/core"
+	"github.com/gorse-io/xvec/internal/core/algorithm"
 )
 
 func ExampleTrainRaBitQ() {
diff --git a/internal/core/rabitq_quantize.go b/internal/core/algorithm/rabitq_reformer.go
similarity index 100%
rename from internal/core/rabitq_quantize.go
rename to internal/core/algorithm/rabitq_reformer.go
diff --git a/internal/core/rotation.go b/internal/core/algorithm/rotator.go
similarity index 100%
rename from internal/core/rotation.go
rename to internal/core/algorithm/rotator.go
diff --git a/internal/core/rotation_test.go b/internal/core/algorithm/rotator_test.go
similarity index 100%
rename from internal/core/rotation_test.go
rename to internal/core/algorithm/rotator_test.go
diff --git a/internal/core/sparse_refiner.go b/internal/core/algorithm/sparse_refiner.go
similarity index 100%
rename from internal/core/sparse_refiner.go
rename to internal/core/algorithm/sparse_refiner.go
diff --git a/internal/core/sparse_refiner_test.go b/internal/core/algorithm/sparse_refiner_test.go
similarity index 100%
rename from internal/core/sparse_refiner_test.go
rename to internal/core/algorithm/sparse_refiner_test.go
diff --git a/internal/core/topk.go b/internal/core/algorithm/topk_result_builder.go
similarity index 100%
rename from internal/core/topk.go
rename to internal/core/algorithm/topk_result_builder.go
diff --git a/internal/core/topk_test.go b/internal/core/algorithm/topk_result_builder_test.go
similarity index 100%
rename from internal/core/topk_test.go
rename to internal/core/algorithm/topk_result_builder_test.go
diff --git a/internal/core/vamana.go b/internal/core/algorithm/vamana_algorithm.go
similarity index 100%
rename from internal/core/vamana.go
rename to internal/core/algorithm/vamana_algorithm.go
diff --git a/internal/core/vamana_test.go b/internal/core/algorithm/vamana_algorithm_test.go
similarity index 100%
rename from internal/core/vamana_test.go
rename to internal/core/algorithm/vamana_algorithm_test.go
diff --git a/internal/core/vamana_example_test.go b/internal/core/algorithm/vamana_example_test.go
similarity index 96%
rename from internal/core/vamana_example_test.go
rename to internal/core/algorithm/vamana_example_test.go
index fb91904..5b64b28 100644
--- a/internal/core/vamana_example_test.go
+++ b/internal/core/algorithm/vamana_example_test.go
@@ -18,7 +18,7 @@ import (
 	"context"
 	"fmt"
 
-	"github.com/gorse-io/xvec/internal/core"
+	"github.com/gorse-io/xvec/internal/core/algorithm"
 )
 
 func ExampleVamanaBuilder() {
diff --git a/internal/core/vamana_quantized.go b/internal/core/algorithm/vamana_quantized_searcher.go
similarity index 100%
rename from internal/core/vamana_quantized.go
rename to internal/core/algorithm/vamana_quantized_searcher.go
diff --git a/reranker_weighted.go b/reranker_weighted.go
index 66308bf..5efc9ff 100644
--- a/reranker_weighted.go
+++ b/reranker_weighted.go
@@ -18,7 +18,7 @@ import (
 	"context"
 	"math"
 
-	"github.com/gorse-io/xvec/internal/core"
+	"github.com/gorse-io/xvec/internal/core/algorithm"
 )
 
 // WeightedReranker normalizes each branch score according to its field metric,