suggest

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

type ActorStats struct {
	Actor      string         `json:"actor"`
	Total      int            `json:"total"`
	ByAction   map[string]int `json:"byAction"`
	Works      int            `json:"works"`
	ActiveDays int            `json:"activeDays"`
	First      time.Time      `json:"first"`
	Last       time.Time      `json:"last"`
	Sessions   []Session      `json:"sessions"`
}

type AuditEntry struct {
	WorkID string    `json:"workId,omitempty"`
	At     time.Time `json:"at"`
	Action string    `json:"action"` // REVIEW_APPROVE, REVIEW_REJECT, MANUAL_TERM, FOLK_ACCEPT, FOLK_BLOCK, PUBLISH_*
	Actor  string    `json:"actor"`
	Terms  []string  `json:"terms,omitempty"` // "<scheme>:<id>"
	Note   string    `json:"note,omitempty"`
	ETag   string    `json:"etag,omitempty"` // grain etag for publish events
}

type Caps struct {
	PerDay  int
	PerHour int
	// SupporterTTL ages dedup markers off; rate counters use fixed short TTLs.
	SupporterTTL time.Duration
}

type Decision struct {
	WorkID  string        `json:"workId"`
	Term    vocab.TermRef `json:"term"`
	Type    SuggType      `json:"type"`
	Approve bool          `json:"approve"`
	// SubstituteTerm, when set on an approval, records that the reviewer
	// slid to a neighbouring vocabulary term instead of the suggested one.
	SubstituteTerm *vocab.TermRef `json:"substituteTerm,omitempty"`
	Note           string         `json:"note,omitempty"`
	// Tombstone on a rejection also blocks future re-suggestions of the pair.
	Tombstone bool `json:"tombstone,omitempty"`
}

type FolkStatus string

type FolkTerm struct {
	Term      string     `json:"term"` // normalized text = identity
	Status    FolkStatus `json:"status"`
	CreatedAt time.Time  `json:"createdAt"`
	// UseCount tracks how many suggestions cite the term (moderation signal).
	UseCount int `json:"useCount"`
}

type MonthStats struct {
	Month    string         `json:"month"`
	Total    int            `json:"total"`
	Actors   int            `json:"actors"`
	Works    int            `json:"works"`
	ByAction map[string]int `json:"byAction"`
	PerActor []ActorStats   `json:"perActor"`
}

type Promotion struct {
	Tag        string        `json:"tag"` // normalized (vocab.NormalizeFolk)
	Term       vocab.TermRef `json:"term"`
	Status     Status        `json:"status"` // PENDING -> APPROVED / REJECTED
	ProposedBy string        `json:"proposedBy"`
	CreatedAt  time.Time     `json:"createdAt"`
	DecidedBy  string        `json:"decidedBy,omitempty"`
	DecidedAt  time.Time     `json:"decidedAt,omitzero"`
	// Works counts the rewrites at execution (stamped by the publisher).
	Works int `json:"works,omitempty"`
}

type Provenance string

type QueuePage struct {
	Items  []Suggestion `json:"items"`
	Cursor string       `json:"cursor,omitempty"`
}

type QueueQuery struct {
	Status     Status // default PENDING
	Scheme     string
	Provenance Provenance
	Type       SuggType
	Limit      int    // default 50
	Cursor     string // opaque; from a prior QueuePage
}

type Reason string

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

type Session struct {
	Start   time.Time `json:"start"`
	End     time.Time `json:"end"`
	Actions int       `json:"actions"`
	Works   int       `json:"works"`
}

type Status string

type SubmitInput struct {
	WorkID        string
	Term          vocab.TermRef
	Type          SuggType
	Reason        Reason // REMOVE only
	SupporterHash string
	WorkTitle     string
	SourceRef     string
}

type SubmitResult struct {
	// Duplicate is true when this supporter already voiced this exact
	// (work, term, type) -- the call is an idempotent no-op.
	Duplicate bool
	// Disputed is true when the pair now has both ADD and REMOVE pressure.
	Disputed bool
	// FolkProposed is true when the submission's novel folksonomy term
	// entered the PROPOSED lifecycle (held for moderation).
	FolkProposed bool
}

type SuggType string

type Suggestion struct {
	WorkID         string         `json:"workId"`
	Term           vocab.TermRef  `json:"term"`
	Type           SuggType       `json:"type"`
	Status         Status         `json:"status"`
	SupporterCount int            `json:"supporterCount"`
	ReasonCounts   map[Reason]int `json:"reasonCounts,omitempty"`
	Provenance     Provenance     `json:"provenance"`
	Confidence     float64        `json:"confidence,omitempty"`
	WorkTitle      string         `json:"workTitle,omitempty"`
	SourceRef      string         `json:"sourceRef,omitempty"`
	// Note carries a concern's freetext (TypeConcern only).
	Note           string    `json:"note,omitempty"`
	CreatedAt      time.Time `json:"createdAt"`
	LastActivityAt time.Time `json:"lastActivityAt"`
	ReviewedAt     time.Time `json:"reviewedAt,omitzero"`
	ReviewedBy     string    `json:"reviewedBy,omitempty"`
	ReviewNote     string    `json:"reviewNote,omitempty"`
	// SubstituteTerm is set when the reviewer approved a neighbouring term
	// instead of the suggested one; the publisher writes the substitute.
	SubstituteTerm *vocab.TermRef `json:"substituteTerm,omitempty"`
	PublishedAt    time.Time      `json:"publishedAt,omitzero"`
	// PublishedETag is the grain ETag that carried the change into the
	// graph (the git-commit-SHA analog for the S3 grain store).
	PublishedETag string `json:"publishedEtag,omitempty"`
}