models

type CapturedMemory struct {
	Content    string     `json:"content"`
	Type       MemoryType `json:"type"`
	Confidence float64    `json:"confidence"`
	Tags       []string   `json:"tags"`
}

type CollectionStats struct {
	TotalMemories int64            `json:"total_memories"`
	ByType        map[string]int64 `json:"by_type"`
	ByScope       map[string]int64 `json:"by_scope"`

	// Health metrics
	OldestMemory       *time.Time       `json:"oldest_memory,omitempty"`
	NewestMemory       *time.Time       `json:"newest_memory,omitempty"`
	TopAccessed        []MemoryPreview  `json:"top_accessed,omitempty"`
	ReinforcementTiers map[string]int64 `json:"reinforcement_tiers,omitempty"`
	ActiveConflicts    int64            `json:"active_conflicts"`
	PendingTTLExpiry   int64            `json:"pending_ttl_expiry"`
	StorageEstimate    int64            `json:"storage_estimate_bytes"`
}

type ConflictStatus string

type Entity struct {
	ID        string         `json:"id"`
	Name      string         `json:"name"`
	Type      EntityType     `json:"type"`
	Aliases   []string       `json:"aliases,omitempty"`
	MemoryIDs []string       `json:"memory_ids,omitempty"`
	CreatedAt time.Time      `json:"created_at"`
	UpdatedAt time.Time      `json:"updated_at"`
	Metadata  map[string]any `json:"metadata,omitempty"`

	// Graph integration fields (v0.5.0)
	Project       string    `json:"project,omitempty"`
	Summary       string    `json:"summary,omitempty"`
	NameEmbedding []float32 `json:"name_embedding,omitempty"`
	CommunityID   string    `json:"community_id,omitempty"`
}

type EntityType string

type Episode struct {
	UUID         string    `json:"uuid"`
	SessionID    string    `json:"session_id"`
	UserMsg      string    `json:"user_msg"`
	AssistantMsg string    `json:"assistant_msg"`
	CapturedAt   time.Time `json:"captured_at"`
	// MemoryIDs are the Memory UUIDs derived from this episode via blob extraction.
	MemoryIDs []string `json:"memory_ids,omitempty"`
	// FactIDs are the Fact IDs (RELATES_TO edge IDs) extracted from this episode.
	FactIDs []string `json:"fact_ids,omitempty"`
}

type Fact struct {
	ID             string    `json:"id"`
	SourceEntityID string    `json:"source_entity_id"`
	TargetEntityID string    `json:"target_entity_id"`
	RelationType   string    `json:"relation_type"`
	Fact           string    `json:"fact"`
	FactEmbedding  []float32 `json:"fact_embedding,omitempty"`

	// Bi-temporal fields: system time vs world time
	CreatedAt time.Time  `json:"created_at"`
	ExpiredAt *time.Time `json:"expired_at,omitempty"`
	ValidAt   *time.Time `json:"valid_at,omitempty"`
	InvalidAt *time.Time `json:"invalid_at,omitempty"`

	// Provenance
	SourceMemoryIDs []string `json:"source_memory_ids,omitempty"`
	Episodes        []string `json:"episodes,omitempty"`
	Confidence      float64  `json:"confidence"`
}

type Memory struct {
	ID         string           `json:"id"`
	Type       MemoryType       `json:"type"`
	Scope      MemoryScope      `json:"scope"`
	Visibility MemoryVisibility `json:"visibility"`
	Content    string           `json:"content"`
	Confidence float64          `json:"confidence"`
	Source     string           `json:"source"`
	Tags       []string         `json:"tags"`
	Project    string           `json:"project,omitempty"`
	// UserID is the owner of this memory. Empty string means unscoped (legacy/shared).
	UserID       string    `json:"user_id,omitempty" db:"user_id"`
	TTLSeconds   int64     `json:"ttl_seconds,omitempty"`
	CreatedAt    time.Time `json:"created_at"`
	UpdatedAt    time.Time `json:"updated_at"`
	LastAccessed time.Time `json:"last_accessed"`
	AccessCount  int64     `json:"access_count"`

	// ReinforcedAt is the last time this memory's confidence was boosted
	// because a similar memory was captured again.
	ReinforcedAt time.Time `json:"reinforced_at,omitempty"`

	// ReinforcedCount is how many times this memory has been reinforced.
	ReinforcedCount int `json:"reinforced_count,omitempty"`

	Metadata     map[string]any `json:"metadata,omitempty"`
	SupersedesID string         `json:"supersedes_id,omitempty"` // ID of memory this replaces
	ValidUntil   time.Time      `json:"valid_until,omitempty"`   // zero = never expires

	// ValidFrom is when this memory version became the current truth.
	// Set to CreatedAt on first write. Immutable after initial store.
	ValidFrom time.Time `json:"valid_from,omitempty"`

	// ValidTo is set when this memory is superseded by a newer version or contradicted.
	// Zero/nil = currently valid.
	ValidTo *time.Time `json:"valid_to,omitempty"`

	// IsCurrentVersion is derived (not stored): ValidTo == nil.
	// Used for display only.
	IsCurrentVersion bool `json:"is_current_version,omitempty"`

	// ConflictGroupID links memories that contradict each other.
	// All memories in a conflict group share the same non-empty UUID.
	ConflictGroupID string `json:"conflict_group_id,omitempty"`

	// ConflictStatus tracks resolution: "" (no conflict), "active" (unresolved), "resolved".
	ConflictStatus ConflictStatus `json:"conflict_status,omitempty"`
}

type MemoryPreview struct {
	ID          string `json:"id"`
	Content     string `json:"content"`
	AccessCount int64  `json:"access_count"`
}

type MemoryScope string

type MemoryType string

type MemoryVisibility string

type RecallResult struct {
	Memory              Memory  `json:"memory"`
	SimilarityScore     float64 `json:"similarity_score"`
	RecencyScore        float64 `json:"recency_score"`
	FrequencyScore      float64 `json:"frequency_score"`
	TypeBoost           float64 `json:"type_boost"`
	ScopeBoost          float64 `json:"scope_boost"`
	ConfidenceScore     float64 `json:"confidence_score"`
	ReinforcementScore  float64 `json:"reinforcement_score"`
	TagAffinityScore    float64 `json:"tag_affinity_score"`
	SupersessionPenalty float64 `json:"supersession_penalty"`
	ConflictPenalty     float64 `json:"conflict_penalty"`
	FinalScore          float64 `json:"final_score"`
}

type SearchResult struct {
	Memory Memory  `json:"memory"`
	Score  float64 `json:"score"`
}