postgres

type Index struct {
	// contains filtered or unexported fields
}

type OptionFunc func(opts *Options)

type Options struct {
	// EmbeddingsModel identifies the embeddings model; snapshots generated
	// with a different model are rejected on restore.
	EmbeddingsModel string
	// VectorSize is the dimension of the pgvector column. Larger embeddings
	// are truncated then re-normalized (matryoshka-style).
	VectorSize int
	// MaxWords bounds the size of the chunks sent to the embeddings model.
	MaxWords int
	// TextSearchConfig is the regconfig used when language detection is
	// inconclusive (default "simple").
	TextSearchConfig string
	// EFSearchFactor multiplies a query's limit to size the HNSW result heap
	// (hnsw.ef_search). Raising it trades vector search latency for recall;
	// lowering it to 1 keeps the heap at the strict minimum. Defaults to
	// DefaultEFSearchFactor.
	EFSearchFactor int
	// RankNormalization is the third argument of ts_rank, a bit mask deciding
	// how the score accounts for document length. PostgreSQL's default of 0
	// means *no* length normalization at all: a long chunk accumulates matches
	// and outranks a short, precise one, where BM25 would have divided by
	// length. See RankNormalization* for the flags.
	RankNormalization int
	// SimpleConfigUnion keeps the historical tsvector construction, which
	// unions the detected language's tsvector with the 'simple' one, both when
	// indexing and when querying:
	//
	//	to_tsvector('english', …) || to_tsvector('simple', …)
	//
	// It buys recall — an unstemmed query term still matches — at a ranking
	// cost that is easy to miss: a word whose stem equals its surface form
	// contributes one lexeme, a word with irregular morphology contributes two,
	// so ts_rank silently weighs irregular words double. Defaults to true, the
	// behaviour every existing index was built with.
	SimpleConfigUnion bool
}

type SnapshottedMetadata struct {
	Model      string
	VectorSize int
}

type SnapshottedRecord struct {
	Source     string
	SectionID  string
	ChunkIndex int
	Content    string
	Lang       string
	// Embedding is the pgvector text literal ("[0.1,...]"), empty when the
	// chunk has no embedding.
	Embedding   string
	Collections []string
}