web

type Check struct {
	Text string `json:"text"`
	Done bool   `json:"done"`
}

type Epic struct {
	Name        string `json:"name"`
	Title       string `json:"title"`
	Description string `json:"description"`
	Body        string `json:"body"`
	Text        string `json:"text"`
	Done        int    `json:"done"`
	// Signoff counts the tickets waiting in the signoff lane for a person to
	// accept them; they are not in Done.
	Signoff int      `json:"signoff"`
	Total   int      `json:"total"`
	Tickets []Ticket `json:"tickets"`
	// Closed is an epic 'jaira epic close' closed: it takes a ticket only
	// with force, and the page hides it unless asked to show it.
	Closed bool `json:"closed"`
}

type EpicEdit struct {
	Title       *string     `json:"title"`
	Description *string     `json:"description"`
	Body        *string     `json:"body"`
	Base        *EpicFields `json:"base"`
}

type EpicFields struct {
	Title       string `json:"title"`
	Description string `json:"description"`
	Body        string `json:"body"`
}

type Lane struct {
	ID   string `json:"id"`
	Name string `json:"name"`
	Kind string `json:"kind"`
}

type Note struct {
	At     time.Time `json:"at"`
	Author string    `json:"author"`
	Text   string    `json:"text"`
}

type Rejection struct {
	Kind string    `json:"kind"`
	Why  string    `json:"why"`
	By   string    `json:"by,omitzero"`
	At   time.Time `json:"at,omitzero"`
}

type Server struct {
	Source Source
	// Fetch brings the remote's refs into this clone; Push sends what Assign
	// queued. Either may be nil on a board with no remote.
	Fetch func() error
	Push  func() error
	// Log records every error answer, failed fetch or push, and panic, with
	// its time and cause. nil records nothing.
	Log *log.Logger
	// contains filtered or unexported fields
}

type Source interface {
	Epics() ([]Epic, error)
	// Unassigned is the open tickets in no epic; with all set, every ticket
	// in no epic that ever was — finished, logged and archived ones too.
	Unassigned(all bool) ([]Ticket, error)
	Ticket(id string) (TicketDetail, error)
	Lanes() ([]Lane, error)
	CreateEpic(name, title, description string) error
	SetEpic(name string, edit EpicEdit) error
	// Assign puts a ticket into epic; with from set it takes it out of that
	// epic as well, which is a move. A closed epic refuses it with
	// ErrConflict unless force is set, and stays closed when it is.
	Assign(epic, from, ticketID string, force bool) error
	Unassign(epic, ticketID string) error
	// SetClosed closes an epic or opens it again. Closing one that still
	// counts an unfinished ticket is refused with ErrConflict unless force
	// is set.
	SetClosed(epic string, closed, force bool) error
}

type Sync struct {
	LastFetch  time.Time `json:"last_fetch,omitzero"`
	FetchError string    `json:"fetch_error,omitzero"`
	LastPush   time.Time `json:"last_push,omitzero"`
	PushError  string    `json:"push_error,omitzero"`
}

type Ticket struct {
	ID     string `json:"id"`
	Handle string `json:"handle"`
	Title  string `json:"title"`
	Lane   string `json:"lane"`
	Done   bool   `json:"done"`
	// Direct is false for a ticket that belongs to an epic only because it
	// follows, or is a child of, one of its members.
	Direct bool `json:"direct"`
	// Place is where the ticket lies: board, ref, logbook or archive. A
	// filed ticket is shown, never dragged.
	Place string `json:"place"`
	// The fields the page filters by.
	Goal      string    `json:"goal,omitzero"`
	Tags      []string  `json:"tags,omitempty"`
	Creator   string    `json:"creator,omitzero"`
	Assignee  string    `json:"assignee,omitzero"`
	UpdatedBy string    `json:"updated_by,omitzero"`
	CreatedAt time.Time `json:"created_at,omitzero"`
	UpdatedAt time.Time `json:"updated_at,omitzero"`
	// FiledAt is the day it left the board: the logbook folder's date, or
	// for the archive the day it was rejected. Zero when nobody knows.
	FiledAt time.Time `json:"filed_at,omitzero"`
	// Rejected is the kind of no, for a ticket 'jaira reject' archived.
	Rejected string `json:"rejected,omitzero"`
	// RejectedWhy is the reason 'jaira reject' gave, shown on the card.
	RejectedWhy string `json:"rejected_why,omitzero"`
	// BehindRef says the ticket file in this checkout is older than the
	// ticket's ref, and what the page shows is the ref.
	BehindRef bool `json:"behind_ref,omitzero"`
}

type TicketDetail struct {
	ID      string  `json:"id"`
	Handle  string  `json:"handle"`
	Title   string  `json:"title"`
	Lane    string  `json:"lane"`
	Place   string  `json:"place"`
	Goal    string  `json:"goal"`
	Context string  `json:"context"`
	DoD     []Check `json:"dod"`
	Notes   []Note  `json:"notes"`
	// Rejected is nil for a ticket that was never rejected.
	Rejected *Rejection `json:"rejected,omitempty"`
	// BehindRef: as on Ticket.
	BehindRef bool `json:"behind_ref,omitzero"`
}