notification

type ArticleEntry struct {
	Id                  string
	Title               string
	Source              string
	Link                string
	PublishedAt         string
	Category            string   // article category (one of the fixed set), empty if unset
	Tags                []string // entity tags (actors/tools/techniques/country/stakeholders), without '#'
	ImportanceScore     int
	ReadTag             string
	DuplicateGroup      string
	IsMostComprehensive bool
	HasAnalysis         bool
	AnalysisError       string // non-empty when HasAnalysis is false and a classified error is available
	Analysis            *RenderedAnalysis
}

type DigestLister func(limit int) ([]models.Digest, error)

type DiscordEmbed struct {
	Title       string              `json:"title,omitempty"`
	Description string              `json:"description,omitempty"`
	Color       int                 `json:"color,omitempty"`
	Fields      []DiscordEmbedField `json:"fields,omitempty"`
	Timestamp   string              `json:"timestamp,omitempty"`
	Footer      *DiscordEmbedFooter `json:"footer,omitempty"`
	Image       *DiscordEmbedImage  `json:"image,omitempty"`
}

type DiscordEmbedField struct {
	Name   string `json:"name"`
	Value  string `json:"value"`
	Inline bool   `json:"inline,omitempty"`
}

type DiscordEmbedFooter struct {
	Text string `json:"text"`
}

type DiscordEmbedImage struct {
	URL string `json:"url"`
}

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

type DiscordWebhookPayload struct {
	Content string         `json:"content,omitempty"`
	Embeds  []DiscordEmbed `json:"embeds,omitempty"`
}

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

type Manifest struct {
	GeneratedAt string          `json:"generated_at"`
	SourceRepo  string          `json:"source_repo"`
	Digests     []ManifestEntry `json:"digests"`
}

type ManifestEntry struct {
	Filename           string   `json:"filename"`
	StartedAt          string   `json:"started_at"`
	PeriodStart        string   `json:"period_start,omitempty"`
	TimeWindow         string   `json:"time_window"`
	ArticleCount       int      `json:"article_count"`
	MustCount          int      `json:"must_count"`
	ShouldCount        int      `json:"should_count"`
	MayCount           int      `json:"may_count"`
	OptCount           int      `json:"opt_count"`
	Provider           string   `json:"provider"`
	Model              string   `json:"model"`
	Models             []string `json:"models,omitempty"` // all unique model names across summary + article analysis
	Title              string   `json:"title,omitempty"`
	Headlines          []string `json:"headlines"`
	HeadlinePriorities []string `json:"headline_priorities,omitempty"`
	Summary            string   `json:"summary"`
}

type Notifier interface {
	SendDigest(digest models.Digest) error
}

type OverviewSection struct {
	Tag   string        // e.g. "EXEC", "01", "02"
	Title string        // section heading
	Body  template.HTML // rendered markdown body
}

type PublishProgress interface {
	Start(step, label string)                   // begin a step (spinner row)
	Update(step, label string)                  // relabel an in-flight step
	Complete(step string, ok bool, note string) // finish a step (✓ / ✗)
}

type RenderedAnalysis struct {
	ProviderType           string
	ModelName              string
	Tldr                   template.HTML
	Justification          template.HTML
	BriefOverview          template.HTML
	StandardSynthesis      template.HTML
	ComprehensiveSynthesis template.HTML
	KeyPoints              []template.HTML
	Insights               []template.HTML
	ReferencedReports      []RenderedReport
	GlossaryExplanation    template.HTML
	GlossaryTerms          []RenderedGlossaryTerm
}

type RenderedGlossaryTerm struct {
	Term       string
	Definition template.HTML
}

type RenderedReport struct {
	Title     string
	URL       string
	Publisher string
	Category  string
	Primary   bool
	Context   template.HTML
}

type TOCEntry struct {
	Id                  string
	Title               string
	Category            string // article category (one of the fixed set), empty if unset
	ImportanceScore     int
	ScoreTip            string // rubric dimension breakdown shown on hover, empty if no dimensions
	ReadTag             string
	DuplicateGroup      string
	IsMostComprehensive bool
}

type TOCGroup struct {
	Label string
	Rows  []TOCRow
}

type TOCRow struct {
	IsCluster    bool
	Entry        TOCEntry        // used when IsCluster == false
	Canonical    TOCEntry        // used when IsCluster == true: the most-comprehensive article
	Others       []TOCEntry      // used when IsCluster == true: remaining members
	Group        string          // duplicate group key, used for colour
	Detail       *ArticleEntry   // full detail for non-cluster row
	CanonDetail  *ArticleEntry   // full detail for cluster canonical
	OtherDetails []*ArticleEntry // full detail for each cluster member
}

type TagCount struct {
	Name  string
	Count int
}