scoring

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

type EffectivenessResult struct {
	ObservationID int64   `json:"observation_id"`
	Injections    int     `json:"injections"`
	Successes     int     `json:"successes"`
	Effectiveness float64 `json:"effectiveness"`
	MinData       bool    `json:"min_data"` // true when injections >= 10
}

type ObservationStore interface {
	GetObservationsNeedingScoreUpdate(ctx context.Context, threshold time.Duration, limit int) ([]*models.Observation, error)
	UpdateImportanceScores(ctx context.Context, scores map[int64]float64) error
	GetConceptWeights(ctx context.Context) (map[string]float64, error)
}

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

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

type RelevanceComponents struct {
	DecayFactor      float64 `json:"decay_factor"`
	AccessFactor     float64 `json:"access_factor"`
	RelationFactor   float64 `json:"relation_factor"`
	ImportanceFactor float64 `json:"importance_factor"`
	ConfidenceFactor float64 `json:"confidence_factor"`
	FinalRelevance   float64 `json:"final_relevance"`
}

type RelevanceConfig struct {
	// BaseDecayRate controls how fast relevance drops with age (default 0.1).
	BaseDecayRate float64 `json:"base_decay_rate"`
	// AccessDecayRate controls the access recency weight (default 0.05).
	AccessDecayRate float64 `json:"access_decay_rate"`
	// RelationWeight scales the relation count bonus (default 0.3).
	RelationWeight float64 `json:"relation_weight"`
	// MinRelevance is the floor value for relevance scores (default 0.001).
	MinRelevance float64 `json:"min_relevance"`
}

type RelevanceParams struct {
	// AgeDays is the number of days since the observation was created.
	AgeDays float64
	// AccessRecencyDays is days since last retrieval. If never accessed, use AgeDays.
	AccessRecencyDays float64
	// RelationCount is the total number of inbound + outbound relations.
	RelationCount int
	// ImportanceScore is the existing importance score (typically 0-2 range).
	ImportanceScore float64
	// AvgRelConfidence is the average confidence of this observation's relations (default 0.5).
	AvgRelConfidence float64
}

type ScoreComponents struct {
	TypeWeight           float64 `json:"type_weight"`
	RecencyDecay         float64 `json:"recency_decay"`
	SourcePenalty        float64 `json:"source_penalty"`
	CoreScore            float64 `json:"core_score"`
	FeedbackContrib      float64 `json:"feedback_contrib"`
	ConceptContrib       float64 `json:"concept_contrib"`
	RetrievalContrib     float64 `json:"retrieval_contrib"`
	UtilityContrib       float64 `json:"utility_contrib"`
	EffectivenessContrib float64 `json:"effectiveness_contrib"`
	FinalScore           float64 `json:"final_score"`
	AgeDays              float64 `json:"age_days"`
}

type Stats struct {
	Running     bool          `json:"running"`
	Interval    time.Duration `json:"interval"`
	BatchSize   int           `json:"batch_size"`
	HalfLife    float64       `json:"half_life_days"`
	MinScore    float64       `json:"min_score"`
	ConceptsLen int           `json:"concepts_count"`
}