storage

type BulkResult struct {
	// Processed is the number of entries processed.
	Processed int

	// Created is the number of entries created.
	Created int

	// Updated is the number of entries updated.
	Updated int

	// Skipped is the number of entries skipped.
	Skipped int

	// Errors contains any errors that occurred.
	Errors []error
}

type ConstraintViolationError struct {
	Message string
}

type DuplicateEntryError struct {
	ID string
}

type ImportMode int

type ListFilter struct {
	// Status filters by entry status (pending, promoted, expired, rejected).
	Status string

	// MinOccurrences filters entries with at least this many occurrences.
	MinOccurrences int

	// Tags filters entries containing any of these tags.
	Tags []string

	// Sprint filters entries seen in this sprint.
	Sprint string

	// Query performs full-text search on question and answer.
	Query string

	// Offset for pagination (0-based).
	Offset int

	// Limit maximum number of results (0 = no limit).
	Limit int
}

type NotFoundError struct {
	ID string
}

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

type Storage interface {

	// Create adds a new entry to storage.
	// Returns ErrDuplicateEntry if an entry with the same ID exists.
	Create(ctx context.Context, entry *tracking.Entry) error

	// Read retrieves an entry by ID.
	// Returns ErrNotFound if the entry does not exist.
	Read(ctx context.Context, id string) (*tracking.Entry, error)

	// Update modifies an existing entry.
	// Returns ErrNotFound if the entry does not exist.
	// Returns ErrConcurrentModification if the entry was modified since last read.
	Update(ctx context.Context, entry *tracking.Entry) error

	// Delete removes an entry by ID.
	// Returns ErrNotFound if the entry does not exist.
	Delete(ctx context.Context, id string) error

	// List returns entries matching the filter criteria.
	// Returns an empty slice (not nil) if no entries match.
	List(ctx context.Context, filter ListFilter) ([]tracking.Entry, error)

	// FindByQuestion searches for an entry by canonical question.
	// Returns ErrNotFound if no matching entry exists.
	FindByQuestion(ctx context.Context, question string) (*tracking.Entry, error)

	// GetByTags returns entries containing any of the specified tags.
	GetByTags(ctx context.Context, tags []string) ([]tracking.Entry, error)

	// GetBySprint returns entries seen in the specified sprint.
	GetBySprint(ctx context.Context, sprint string) ([]tracking.Entry, error)

	// BulkInsert adds multiple entries in a single transaction.
	// Returns a BulkResult with counts of created/updated/skipped entries.
	BulkInsert(ctx context.Context, entries []tracking.Entry) (*BulkResult, error)

	// BulkUpdate modifies multiple entries in a single transaction.
	BulkUpdate(ctx context.Context, entries []tracking.Entry) (*BulkResult, error)

	// BulkDelete removes multiple entries by ID in a single transaction.
	BulkDelete(ctx context.Context, ids []string) (*BulkResult, error)

	// Import loads entries with specified mode (append/overwrite/merge).
	Import(ctx context.Context, entries []tracking.Entry, mode ImportMode) (*BulkResult, error)

	// Export returns all entries matching the filter.
	Export(ctx context.Context, filter ListFilter) ([]tracking.Entry, error)

	// Vacuum performs storage optimization (e.g., SQLite VACUUM).
	// Returns the number of bytes reclaimed.
	Vacuum(ctx context.Context) (int64, error)

	// Stats returns storage statistics.
	Stats(ctx context.Context) (*StorageStats, error)

	// Backup creates a backup of the storage at the specified path.
	Backup(ctx context.Context, path string) error

	// Close releases storage resources.
	// After Close, all operations return ErrStorageClosed.
	Close() error
}

type StorageStats struct {
	// TotalEntries is the count of all entries.
	TotalEntries int

	// EntriesByStatus maps status to count.
	EntriesByStatus map[string]int

	// TotalVariants is the count of all variant questions.
	TotalVariants int

	// TotalTags is the count of unique tags.
	TotalTags int

	// TotalSprints is the count of unique sprints.
	TotalSprints int

	// StorageSize is the size in bytes (for SQLite).
	StorageSize int64

	// LastModified is the last modification timestamp.
	LastModified string
}

type StorageType string

type UnsupportedBackendError struct {
	Extension string
}

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