incident

type FactSink interface {
	AppendFact(ctx context.Context, f journal.Fact) error
}

type Incident struct {
	Fingerprint string
	Project     string
	Kind        Kind
	Message     string
	FirstSeen   time.Time
	LastSeen    time.Time
	Occurrences int
	Regressions int
	Status      Status
	Mints       []Mint
}

type Kind string

type Mint struct {
	TaskID     string `json:"taskID"`
	SourceSeq  int64  `json:"sourceSeq"`
	Regression bool   `json:"regression"`
	Priority   int    `json:"priority"`
	// Outcome is the minted task's terminal state folded from its own
	// lifecycle facts: "" while running, "completed", or "dead".
	Outcome string `json:"outcome"`
	// DoneSeq is the Seq of the terminal fact (ordering evidence for the
	// regression rule).
	DoneSeq int64 `json:"doneSeq,omitempty"`
}

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

type PolicyConfig struct {
	// Log receives mint failures and skips. nil logs nothing.
	Log *slog.Logger
	// PageSize bounds one fact-stream page; 0 selects the default.
	PageSize int
	// FirstPriority mints first-occurrence fix tasks; 0 selects the default.
	FirstPriority int
	// RegressionPriority mints regression fix tasks; 0 selects the default.
	RegressionPriority int
	// MaxAttempts bounds minted fix tasks; 0 selects the default.
	MaxAttempts int
}

type PolicyStats struct {
	// Facts is the number of facts consumed.
	Facts int
	// TasksMinted counts fix tasks enqueued (dedup converges replays).
	TasksMinted int
	// Occurrences counts error.observed facts delivered (storms included).
	Occurrences int
	// Regressions counts observations that reopened a terminal incident.
	Regressions int
	// Known counts deliveries whose fix task was already minted (replay or
	// in-flight mint).
	Known int
	// Skipped counts facts that could not yield a mint (bad detail, foreign
	// shape) — the incident stays open and the next occurrence re-arms. A
	// refused MINT is not counted here: it aborts the sweep before the
	// checkpoint so the observation redelivers.
	Skipped int
}

type RecordResult struct {
	// Incident is the incident stream identity ("incident:<fingerprint>").
	Incident string `json:"incident"`
}

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

type Report struct {
	// Project is the repo (or logical owner) the error belongs to and the
	// unit the minted fix task's Project/Repo derive from. Required.
	Project string `json:"project"`
	// Kind selects client or server. Empty defaults to server.
	Kind Kind `json:"kind"`
	// Message is the error message (exception text or panic value).
	Message string `json:"message"`
	// Stack is the raw stack (minified frames are fine; the agent resolves
	// source maps from the pinned Release in-repo).
	Stack string `json:"stack,omitempty"`
	// Release is the commit SHA (or version) the error was observed on.
	Release string `json:"release,omitempty"`
	// Route is the route pattern (server) or path (client), not the raw
	// URL — query strings never enter the journal.
	Route string `json:"route,omitempty"`
	// Method is the HTTP method, server errors only.
	Method string `json:"method,omitempty"`
	// TraceURL is a deep link to the full trace in the observability stack
	// (SigNoz) — the query surface; this pipeline is the action surface.
	TraceURL string `json:"traceUrl,omitempty"`
	// SessionID correlates reports from one browser session.
	SessionID string `json:"sessionId,omitempty"`
	// Breadcrumbs are the last user actions/requests before the error.
	Breadcrumbs []string `json:"breadcrumbs,omitempty"`
	// OccurredAt is the observation time (zero = recording time).
	OccurredAt time.Time `json:"occurredAt"`
}

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

type Status string