notify

type Alerta struct {
	Workflow    string
	RunID       string
	Status      string
	Trigger     string
	Tentativas  int
	LogicalDate *time.Time
	Erro        string

	// Passo is the node that failed. It arrives as a field of its own, and not
	// only embedded in the error text, because it is the first thing whoever is
	// on call looks for: "which step?" before "why?".
	Passo string

	// TrechoDoLog is the last few lines of that step's output, read from
	// `task_runs.log`. Without it the alert says something failed; with it the
	// alert says what failed and why, without anyone opening the screen at
	// 4am.
	TrechoDoLog string

	// The workflow's tags become the message's "Domain" and "Pipeline" fields --
	// in Kestra that came from `labels`, and it is what makes an alert
	// actionable without opening the screen.
	Tags []string

	// URLBase of the UI, for the run's direct link. Empty means no link.
	URLBase string
}

type Notificador interface {
	Falhou(ctx context.Context, a Alerta) error
}

type Slack struct {
	Webhook string
	Cliente *http.Client

	// Ambiente appears in the header ("prod", "dev"). Without it, a staging
	// alert at three in the morning is indistinguishable from a production
	// one.
	Ambiente string
}