control

type ActivityDay struct {
	Date  string `json:"date"`
	Count int    `json:"count"`
}

type BuildOut struct {
	Number     int64  `json:"number"`
	Job        string `json:"job"`
	Status     string `json:"status"`
	SHA        string `json:"sha"`
	Ref        string `json:"ref"`
	CreatedAt  string `json:"created_at"`
	FinishedAt string `json:"finished_at,omitempty"`
}

type CheckOut struct {
	Context   string `json:"context"`
	State     string `json:"state"`
	URL       string `json:"url,omitempty"`
	UpdatedAt string `json:"updated_at"`
	Duration  string `json:"duration,omitempty"` // CI checks only, once finished
}

type Command struct {
	Path []string // e.g. ["keys", "add"]
	// Summary is one line of prose: what the command does, no argument
	// syntax. Usage is the argument syntax, opening with the command path.
	// help renders them separately, so neither may carry the other's job.
	Summary    string
	Usage      string
	ReadsStdin bool
	ReadOnly   bool // safe for read-scoped API tokens
	SSHOnly    bool // refused over the HTTP API (credential minting)
	Run        func(c *Ctx, args []string) int
}

type CommitOut struct {
	SHA     string `json:"sha"`
	Subject string `json:"subject"`
}

type Created struct {
	Number int64 `json:"number"`
}

type Ctx struct {
	User   store.User
	Scope  string // scope of the key that authenticated this session
	Store  *store.Store
	Cfg    config.Config
	Stdin  io.Reader
	Stdout io.Writer
	Stderr io.Writer
	JSON   bool
	// ViaAPI marks requests arriving over the HTTP token API. Some
	// commands (token management) are SSH-only: an API token must never
	// mint further credentials.
	ViaAPI bool
	// ReadOnly is set for read-scoped API tokens.
	ReadOnly bool
	// Source identifies the credential behind this session for the audit
	// log: an SSH key fingerprint, or "api" for token requests.
	Source string
}

type DashboardBuild struct {
	Repo       string `json:"repo"`
	Number     int64  `json:"number"`
	Job        string `json:"job"`
	Status     string `json:"status"`
	SHA        string `json:"sha"`
	Ref        string `json:"ref"`
	CreatedAt  string `json:"created_at"`
	FinishedAt string `json:"finished_at,omitempty"`
}

type DashboardItem struct {
	Repo      string `json:"repo"`
	Number    int64  `json:"number"`
	Title     string `json:"title"`
	Author    string `json:"author"`
	State     string `json:"state"`
	UpdatedAt string `json:"updated_at"`
}

type DashboardOut struct {
	Reviews  []DashboardItem  `json:"review_queue"`
	Assigned []DashboardItem  `json:"assigned_issues"`
	MRs      []DashboardItem  `json:"open_mrs"`
	Issues   []DashboardItem  `json:"open_issues"`
	Pinned   []PinnedOut      `json:"pinned"`
	Activity []FeedOut        `json:"recent_activity"`
	Builds   []DashboardBuild `json:"builds"`
	// Unread is the notification inbox badge, so a client showing one
	// does not need a second read to fill it.
	Unread int        `json:"unread"`
	Server *ServerOut `json:"server,omitempty"`
	// Queues is admin-only: every background worker's backlog and
	// failures, the operator's view of what is stuck.
	Queues *store.Queues `json:"queues,omitempty"`
}

type FeedOut struct {
	ID        int64           `json:"id"`
	Repo      string          `json:"repo"`
	Actor     string          `json:"actor,omitempty"`
	Kind      string          `json:"kind"`
	Data      json.RawMessage `json:"data,omitempty"`
	CreatedAt string          `json:"created_at"`
}

type IssueShow struct {
	Comments []commentOut `json:"comments,omitempty"`
	// contains filtered or unexported fields
}

type IssueTemplate struct {
	Name string `json:"name"`
	Body string `json:"body"`
}

type JobOut struct {
	Name     string `json:"name"`
	Schedule string `json:"schedule,omitempty"`
	Tags     string `json:"tags,omitempty"`
}

type MRCreated struct {
	Number    int64     `json:"number"`
	HeadSHA   string    `json:"head_sha"`
	StackedOn *stackRef `json:"stacked_on,omitempty"`
}

type MRShow struct {
	Checks            []CheckOut   `json:"checks,omitempty"`
	Combined          string       `json:"checks_combined,omitempty"`
	UnresolvedThreads int          `json:"unresolved_threads,omitempty"`
	Commits           []CommitOut  `json:"commits,omitempty"`
	Comments          []commentOut `json:"comments,omitempty"`
	Reviews           []ReviewOut  `json:"reviews,omitempty"`
	// contains filtered or unexported fields
}

type PinnedOut struct {
	Path        string `json:"path"`
	Visibility  string `json:"visibility"`
	Description string `json:"description,omitempty"`
	Archived    bool   `json:"archived,omitempty"`
}

type ProfileMember struct {
	Name string `json:"name"`
	Role string `json:"role,omitempty"`
}

type ProfileOut struct {
	Name        string `json:"name"`
	Kind        string `json:"kind"`
	Description string `json:"description,omitempty"`
	Website     string `json:"website,omitempty"`
	// About is long-form markdown, rendered by the web between the
	// header and the activity graph.
	About       string              `json:"about,omitempty"`
	AboutFormat string              `json:"about_format,omitempty"`
	Links       []store.ProfileLink `json:"links,omitempty"`
	// The rest is what a profile page shows: who they work with, what
	// they own that you can see, and how active they have been. The web
	// read these straight out of the store, which kept them off every
	// other surface.
	Orgs     []ProfileMember `json:"orgs,omitempty"`    // for a user
	Members  []ProfileMember `json:"members,omitempty"` // for an org
	Repos    []ProfileRepo   `json:"repos"`
	Activity []ActivityDay   `json:"activity,omitempty"`
	// ActivityTotal counts the same window the days cover.
	ActivityTotal int `json:"activity_total"`
}

type ProfileRepo struct {
	Path          string   `json:"path"`
	Visibility    string   `json:"visibility"`
	Description   string   `json:"description,omitempty"`
	DefaultBranch string   `json:"default_branch"`
	Topics        []string `json:"topics,omitempty"`
	License       string   `json:"license,omitempty"`
	Updated       string   `json:"updated,omitempty"`
	Archived      bool     `json:"archived,omitempty"`
}

type ReviewOut struct {
	Reviewer string `json:"reviewer"`
	Verdict  string `json:"verdict"`
	Stale    bool   `json:"stale"`
	// Counts reports whether this verdict decides the merge gates. A
	// reader may review a public merge request; only someone who can
	// write to the repository decides whether it merges. Without this the
	// page would show an approval the gate ignores, and the difference
	// would be invisible until a merge was refused (#147).
	Counts    bool   `json:"counts"`
	CreatedAt string `json:"created_at"`
}

type RevisionOut struct {
	N         int    `json:"n"` // 1 is the first push
	SHA       string `json:"sha"`
	BaseSHA   string `json:"base_sha,omitempty"`
	CreatedAt string `json:"created_at"`
	Current   bool   `json:"current,omitempty"`
}

type SearchResult struct {
	Kind      string `json:"kind"` // repo, issue, or mr
	Repo      string `json:"repo"`
	Number    int64  `json:"number,omitempty"`
	Title     string `json:"title"`
	Author    string `json:"author,omitempty"`
	State     string `json:"state,omitempty"`
	UpdatedAt string `json:"updated_at,omitempty"`
}

type ServerOut struct {
	Commit string `json:"commit"`
}