settings

type Settings struct {
	// Remote is where ticket refs are pushed and fetched. Empty means origin.
	Remote string `json:"remote,omitempty"`

	// Notify turns the desktop notification for an assignment off. It is
	// phrased as the negative so that the zero value — a file that does not
	// mention it, or no file at all — leaves notifications on: the feature was
	// asked for, and a default that silently withholds it would answer the
	// request with nothing.
	NotifyOff bool `json:"notify-off,omitempty"`

	// Hook is a script called when a ticket moves or is claimed, for immediate
	// delivery through whatever the user already uses (a Slack webhook,
	// ntfy.sh, Telegram). jaira only calls it and brings no dependency of its
	// own; an empty value calls nothing.
	Hook string `json:"hook,omitempty"`

	// LandingBranches are the branches whose contents mean a ticket has
	// arrived: filed away in one of them, it is finished for everybody and its
	// ref has done its job.
	//
	// A list with globs rather than one "main branch", because there is no
	// answer to what the important branch is called — main, master, develop, a
	// release line — and a list turns a guess into a setting. Empty falls back
	// to the remote's own HEAD, and if that cannot be resolved either, nothing
	// is ever removed.
	LandingBranches []string `json:"landing-branches,omitempty"`

	// SnapshotBranch holds the board as files, as a backup for whoever clones
	// for the first time and has no refs yet. Empty means jaira/board.
	SnapshotBranch string `json:"snapshot-branch,omitempty"`

	// SnapshotEvery is how old the backup may get, as a duration ("72h").
	// Empty means three days: every participant's clone holds the refs, so the
	// board survives any one machine, and this is for the slow cases only.
	SnapshotEvery string `json:"snapshot-every,omitempty"`

	// FetchEvery is how often the ticket refs are brought up to date in the
	// background, as a duration ("10m"). Empty means ten minutes.
	//
	// One setting for the CLI and the board alike. They used to disagree — the
	// board had its own hard-wired minute — and somebody who changed this would
	// have found the board carrying on at its own pace.
	FetchEvery string `json:"fetch-every,omitempty"`

	// LandingGrace is how long a finished ticket may go without arriving in a
	// landing branch before jaira mentions it, as a duration ("72h"). Empty
	// means three days.
	LandingGrace string `json:"landing-grace,omitempty"`
}