memory

type Chunk struct {
	ID        string    `json:"id"`
	Source    string    `json:"source"` // relative file path
	Content   string    `json:"content"`
	LineStart int       `json:"line_start"`
	LineEnd   int       `json:"line_end"`
	CreatedAt time.Time `json:"created_at"`
}

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

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

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

type IndexedChunk struct {
	Chunk  Chunk     `json:"chunk"`
	Vector []float32 `json:"vector"`
}

type Logger interface {
	Info(msg string, fields map[string]any)
	Warn(msg string, fields map[string]any)
	Error(msg string, fields map[string]any)
	Debug(msg string, fields map[string]any)
}

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

type ManagerConfig struct {
	MemoryDir    string       // root directory for memory files
	Embedder     llm.Embedder // nil = keyword-only mode
	Logger       Logger
	SearchConfig SearchConfig
}

type SearchConfig struct {
	VectorWeight  float64       // weight for vector similarity (default: 0.7)
	KeywordWeight float64       // weight for keyword overlap (default: 0.3)
	DecayHalfLife time.Duration // temporal decay half-life (default: 7 days)
	DecayEnabled  bool          // whether to apply temporal decay (default: true)
	TopK          int           // max results to return (default: 10)
}

type SearchResult struct {
	Chunk Chunk   `json:"chunk"`
	Score float64 `json:"score"`
}

type VectorStore interface {
	// Index adds or updates chunks with their embedding vectors.
	Index(ctx context.Context, chunks []IndexedChunk) error
	// Search returns the top-k most similar chunks to the query vector.
	Search(ctx context.Context, queryVector []float32, k int) ([]SearchResult, error)
	// DeleteBySource removes all chunks from a given source file.
	DeleteBySource(ctx context.Context, sourceFile string) error
	// Count returns the total number of indexed chunks.
	Count() int
	// Close flushes any pending writes and releases resources.
	Close() error
}