Module vector_store 

UUID-keyed primary vector snapshots and deterministic exact cosine search.

This module owns the backend-neutral vector data contract for M19. It does not resolve public selectors or graph labels: callers supply already resolved UUID membership and publish the resulting vectors.parquet file through the shared search-publication foundation.

Structs

StoredVector

One canonical row in a vector snapshot.

VectorSearchHit

One exact cosine result before public Arrow shaping.

VectorStoreLimits

Named limits for vector persistence and exact search.

Enums

VectorUpsertChange

Whether an upsert changed primary vector data.

Constants

VECTOR_BACKEND_VERSION

Persisted Arrow/Parquet backend contract.

VECTOR_CONTRACT_VERSION

Cosine, validation, and ordering contract.

VECTOR_DATA_FILE

File stored inside one immutable vector publication.

Functions

apply_vector_upsert

Insert or replace one UUID row in canonical UUID order.

exact_cosine_search

Deterministic exhaustive cosine search over a validated snapshot.

read_vector_snapshot

Read and validate one immutable vector snapshot.

search_published_vectors

Read one published artifact and run exact cosine search.

upsert_published_vector

Atomically upsert one resolved UUID into its label/space vector snapshot.

validate_published_vectors

Validate the data file and dimension of a published vector artifact.

validate_vector

Validate a supplied or persisted vector and return its squared norm.

vector_schema

Canonical schema for one fixed vector dimension.

write_vector_snapshot

Write one complete canonical vector snapshot into a publication build dir.