alert

type Alert struct {
	ID       types.AlertID     `json:"id"`
	TicketID types.TicketID    `json:"ticket_id"`
	Schema   types.AlertSchema `json:"schema"`
	Data     any               `json:"data"`
	Status   AlertStatus       `json:"status"`

	// Topic is the namespace for domain knowledge (defaults to Schema if not set by policy)
	Topic types.KnowledgeTopic `json:"topic"`

	Metadata

	CreatedAt      time.Time          `json:"created_at"`
	SlackThread    *slack.Thread      `json:"slack_thread"`
	SlackMessageID string             `json:"slack_message_id"`
	Embedding      firestore.Vector32 `json:"-"`
	TagIDs         map[string]bool    `json:"tag_ids"`
}

type AlertListRepository interface {
	BatchGetAlerts(ctx context.Context, alertIDs []types.AlertID) (Alerts, error)
}

type AlertStatus string

type AlertThrottle struct {
	// Buckets maps time bucket keys (e.g. "2026-03-24T14:05") to the count of alerts processed in that bucket.
	Buckets    map[string]int `json:"buckets"`
	NotifiedAt time.Time      `json:"notified_at"`
}

type Alerts []*Alert

type Attribute struct {
	Key   string `json:"key"`
	Value string `json:"value"`
	Link  string `json:"link"`
	Auto  bool   `json:"auto"`
}

type Finding struct {
	Severity       types.AlertSeverity `json:"severity"`
	Summary        string              `json:"summary"`
	Reason         string              `json:"reason"`
	Recommendation string              `json:"recommendation"`
}

type GenAIConfig struct {
	Prompt string                   `json:"prompt"` // Prompt template file name
	Format types.GenAIContentFormat `json:"format"` // Response format: "text" | "json" (default: "text")
}

type GenAIResponse struct {
	Data   any                      `json:"data"`   // Raw response data
	Format types.GenAIContentFormat `json:"format"` // Response format for formatting
}

type List struct {
	ID             types.AlertListID `json:"id"`
	AlertIDs       []types.AlertID   `json:"alert_ids"`
	SlackThread    *slack.Thread     `json:"slack_thread"`
	SlackMessageID string            `json:"slack_message_id"`
	Status         ListStatus        `json:"status"`
	CreatedAt      time.Time         `json:"created_at"`
	CreatedBy      *slack.User       `json:"created_by"`

	Metadata
	Embedding firestore.Vector32 `json:"-"`
	// contains filtered or unexported fields
}

type ListStatus string

type Metadata struct {
	Title             string       `json:"title"`
	Description       string       `json:"description"`
	Attributes        []Attribute  `json:"attributes"`
	TitleSource       types.Source `json:"title_source"`
	DescriptionSource types.Source `json:"description_source"`
	// Tags field is used temporarily during policy processing to pass tag names
	// These are converted to TagIDs and not persisted in this field
	Tags []string `json:"tags,omitempty"`
	// Channel field specifies target Slack channel for alert notification
	// Set by action policy evaluation
	Channel string `json:"channel,omitempty"`
}

type QueryOutput struct {
	Alerts []Metadata `json:"alerts"`
}

type QueuedAlert struct {
	ID        types.QueuedAlertID `json:"id"`
	Schema    types.AlertSchema   `json:"schema"`
	Data      any                 `json:"data"`
	Title     string              `json:"title"`
	CreatedAt time.Time           `json:"created_at"`
	Channel   string              `json:"channel"`
}

type ReprocessBatchJob struct {
	ID             types.ReprocessBatchJobID `json:"id"`
	Status         types.ReprocessJobStatus  `json:"status"`
	TotalCount     int                       `json:"total_count"`
	CompletedCount int                       `json:"completed_count"`
	FailedCount    int                       `json:"failed_count"`
	CreatedAt      time.Time                 `json:"created_at"`
	UpdatedAt      time.Time                 `json:"updated_at"`
}

type ReprocessJob struct {
	ID            types.ReprocessJobID     `json:"id"`
	QueuedAlertID types.QueuedAlertID      `json:"queued_alert_id"`
	Status        types.ReprocessJobStatus `json:"status"`
	Error         string                   `json:"error,omitempty"`
	CreatedAt     time.Time                `json:"created_at"`
	UpdatedAt     time.Time                `json:"updated_at"`
}

type ThrottleResult struct {
	Allowed      bool // true if the alert can be processed
	ShouldNotify bool // true if a Slack @channel notification should be sent
}