Reference Implementation Architecture
The reference SHALL, on a Postgres-backed deployment where the vector (pgvector) extension is available, persist semantic-index embeddings in semanticsearchblob.embedding as pgvector vector values rather than JSONB float arrays, and SHALL answer semantic index queries with the database's cosine-distance operator (embedding <=> query ORDER BY … LIMIT k) supported by an HNSW index over the production embedding dimensionality, rather than fetching candidate embeddings and computing distances in process.
reference-implementation-architecture