queries

type CatchupDelta struct {
	Since        time.Time
	Sessions     []SearchResult
	ClosedIssues []types.Issue
	StateChanges []types.BranchState
}

type CooccurrenceNode struct {
	Name  string
	Count int
}

type EntityGraph struct {
	Nodes []EntityNode
}

type EntityNode struct {
	ID           string
	Name         string
	Relationship string
	Depth        int
	Path         string
}

type PathStep struct {
	EntityName   string
	SessionID    string
	SessionTitle string
}

type ProximityWarning struct {
	State        types.LifecycleState
	ScopeType    types.ScopeType
	ScopeRef     string
	ShortReason  string
	FullReasonID string
}

type ResolvedEntity struct {
	ID   string
	Name string
}

type SearchOptions struct {
	Query         string
	Author        string
	CurrentBranch string
	Limit         int
	Strict        bool // If true, only BM25 on sessions, no expansion
	TextOnly      bool // If true, only BM25, no entity lookup
	Preview       bool // If true, show first 3 lines instead of snippet
	Explain       bool // If true, show score breakdown
}

type SearchResponse struct {
	Results         []SearchResult
	RelatedEntities []string
	Strategy        string // e.g. "exact", "hybrid", "fallback"
}

type SearchResult struct {
	ID        string  `json:"id"`
	Title     string  `json:"title"`
	Date      string  `json:"date"`
	Narrative string  `json:"narrative"` // Snippet or Preview
	Score     float64 `json:"score"`
	Reason    string  `json:"reason"` // e.g. "text match", "entity:Modal"

	// Explanation fields (for --explain)
	BM25         float64 `json:"bm25"`
	PhraseBonus  float64 `json:"phrase_bonus"`
	NearBonus    float64 `json:"near_bonus"`
	EntityBonus  float64 `json:"entity_bonus"`
	RecencyBonus float64 `json:"recency_bonus"`

	IsLowConfidence bool `json:"is_low_confidence"`

	// Lifecycle fields
	LifecycleStatus types.LifecycleState `json:"lifecycle_status"`
	StatusReason    string               `json:"status_reason"`
	IsValidated     bool                 `json:"is_validated"`
	Branch          string               `json:"branch"`
}

type Suggestion struct {
	Name     string
	Distance int    // -1 if not applicable
	Type     string // "exact", "typo", "fuzzy"
}