signal

type DerivedMetrics struct {
	// Frustration is the weighted signal count multiplied by age.
	Frustration *float64 `json:"frustration,omitempty"`

	// Momentum is the trailing signal count over a rolling window (e.g., 30 days).
	Momentum *float64 `json:"momentum,omitempty"`

	// Reach is the count of distinct customer references contributing to a root cause.
	Reach *float64 `json:"reach,omitempty"`

	// Urgency is the case count weighted by severity.
	Urgency *float64 `json:"urgency,omitempty"`

	// ComputedAt is when these metrics were last computed.
	ComputedAt *time.Time `json:"computed_at,omitempty"`

	// Extra holds additional derived scores not covered by the well-known fields.
	Extra map[string]float64 `json:"extra,omitempty"`
}

type Signal struct {
	// ID is the unique signal identifier.
	ID string `json:"id"`

	// Type categorizes the signal source.
	Type Type `json:"type"`

	// Status is the current processing state.
	Status Status `json:"status"`

	// Source identifies the originating system.
	Source common.SourceSystem `json:"source"`

	// Domain is the functional area this signal relates to.
	Domain common.Domain `json:"domain"`

	// Severity indicates impact level.
	Severity common.Severity `json:"severity"`

	// Summary is a brief description of the signal.
	Summary string `json:"summary"`

	// Description is the full signal content.
	Description string `json:"description,omitempty"`

	// Entities are system components referenced by this signal.
	Entities []common.Entity `json:"entities,omitempty"`

	// ObservedAt is when the signal was first observed.
	ObservedAt time.Time `json:"observed_at"`

	// ReceivedAt is when the signal was received by the system.
	ReceivedAt time.Time `json:"received_at"`

	// RootCauseID links to the mapped root cause, if any.
	RootCauseID string `json:"root_cause_id,omitempty"`

	// Fingerprint is a hash for deduplication.
	Fingerprint string `json:"fingerprint,omitempty"`

	// Embedding is the vector representation for semantic similarity.
	Embedding []float32 `json:"embedding,omitempty"`

	// Metadata contains source-specific additional data.
	Metadata map[string]any `json:"metadata,omitempty"`

	// Derived holds computed metrics excluded from fingerprinting.
	Derived *DerivedMetrics `json:"derived,omitempty"`

	// Tags are user-defined labels in lower-kebab-case format.
	// Examples: "enterprise", "mobile", "auth-failure"
	Tags []common.Tag `json:"tags,omitempty" jsonschema:"pattern=^[a-z][a-z0-9]*(-[a-z0-9]+)*$"`
}

type Status string

type Type string