knowledge

type ConfidenceUpdate struct {
	PatternID       string  `json:"pattern_id"`
	NewConfidence   float64 `json:"new_confidence"`
	ConfidenceDelta float64 `json:"confidence_delta"`
	UpdateReason    string  `json:"update_reason,omitempty"`
}

type ConfirmRequest struct {
	PatternID string                 `json:"pattern_id"`
	Success   bool                   `json:"success"`
	UserID    string                 `json:"user_id,omitempty"`
	ProjectID string                 `json:"project_id,omitempty"`
	SessionID string                 `json:"session_id,omitempty"`
	ErrorMsg  string                 `json:"error_msg,omitempty"`
	Solution  string                 `json:"solution,omitempty"`
	Feedback  string                 `json:"feedback,omitempty"`
	TimeToFix time.Duration          `json:"time_to_fix,omitempty"`
	Metadata  map[string]interface{} `json:"metadata,omitempty"`
}

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

type Memory struct {
	ID        string                 `json:"id"`
	Content   string                 `json:"content"`
	Type      string                 `json:"type"`
	Metadata  map[string]interface{} `json:"metadata"`
	Timestamp time.Time              `json:"timestamp"`
	Score     float64                `json:"score"`
	UserID    string                 `json:"user_id,omitempty"`    // User who created this memory
	ProjectID string                 `json:"project_id,omitempty"` // Project scope
	SessionID string                 `json:"session_id,omitempty"` // Session scope
}

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

type Pattern struct {
	ID             string  `json:"id"`
	ErrorType      string  `json:"error_type"`
	ErrorSignature string  `json:"error_signature"`
	Solution       string  `json:"solution"`
	Confidence     float64 `json:"confidence"`
	SuccessRate    float64 `json:"success_rate"`
	Occurrences    int     `json:"occurrences"`
}

type PromoteRequest struct {
	MemoryID   string                 `json:"memory_id"`
	FromScope  string                 `json:"from_scope"` // "session", "project", "user"
	ToScope    string                 `json:"to_scope"`   // "project", "user", "global"
	UserID     string                 `json:"user_id,omitempty"`
	ProjectID  string                 `json:"project_id,omitempty"`
	Confidence float64                `json:"confidence"`
	Feedback   string                 `json:"feedback,omitempty"`
	Metadata   map[string]interface{} `json:"metadata,omitempty"`
}

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

type SearchQuery struct {
	Text      string
	Type      string
	UserID    string // User-specific search
	ProjectID string
	SessionID string
	StartTime time.Time
	EndTime   time.Time
	MinScore  float64
	Fuzzy     bool
	Limit     int
	Offset    int
	SortBy    string
	SortDesc  bool
}

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

type Store interface {
	// Store saves a new memory and returns its unique ID.
	Store(ctx context.Context, content string, memType string, metadata map[string]interface{}) (string, error)

	// StoreWithScope saves a memory with project and session scope.
	StoreWithScope(ctx context.Context, content string, memType string, metadata map[string]interface{}, projectID, sessionID string) (string, error)

	// StoreForUser saves a memory associated with a specific user (long-term personalization)
	StoreForUser(ctx context.Context, userID, content string, memType string, metadata map[string]interface{}) (string, error)

	// Query searches for relevant memories based on a query string.
	Query(ctx context.Context, query string, limit int) ([]Memory, error)

	// QueryWithScope searches memories within a specific project/session scope.
	QueryWithScope(ctx context.Context, query string, limit int, projectID, sessionID string) ([]Memory, error)

	// QueryUserMemories searches memories for a specific user
	QueryUserMemories(ctx context.Context, userID, query string, limit int) ([]Memory, error)

	// GetPatterns retrieves memories of type "pattern".
	GetPatterns(ctx context.Context, errorType string) ([]Memory, error)

	// GetProjectPatterns retrieves patterns specific to a project.
	GetProjectPatterns(ctx context.Context, projectID, errorType string) ([]Memory, error)

	// GetUserPatterns retrieves patterns learned by a specific user
	GetUserPatterns(ctx context.Context, userID, errorType string) ([]Memory, error)

	// SuggestFix suggests a fix based on historical patterns.
	SuggestFix(ctx context.Context, errorMsg string) (string, error)

	// SuggestFixForUser suggests a fix based on user's personal patterns
	SuggestFixForUser(ctx context.Context, userID, errorMsg string) (string, error)

	// SimilaritySearch finds memories similar to the given text
	SimilaritySearch(ctx context.Context, text string, limit int) ([]Memory, error)

	// GetStats returns aggregated statistics about stored memories
	GetStats(ctx context.Context, projectID string) (map[string]interface{}, error)

	// GetUserStats returns statistics about a user's memories
	GetUserStats(ctx context.Context, userID string) (map[string]interface{}, error)

	// BatchUpdateConfidence updates confidence scores for multiple patterns in a single transaction
	BatchUpdateConfidence(ctx context.Context, updates []ConfidenceUpdate) error

	// GetPatternConfidence retrieves the current confidence score for a pattern
	GetPatternConfidence(ctx context.Context, patternID string) (float64, error)

	// GetPatternsForCalibration retrieves patterns that are eligible for calibration
	GetPatternsForCalibration(ctx context.Context, projectID string, batchSize int) ([]Memory, error)

	// GetPatternFeedbackCounts retrieves feedback statistics for a pattern
	GetPatternFeedbackCounts(ctx context.Context, patternID string) (confirmed, failed int, err error)

	// Close cleans up any resources used by the store.
	Close() error
}