webserver

type Deps struct {
	Jira      seams.Jira
	Git       seams.Git
	Forge     seams.Forge
	Messaging seams.Messaging
	Hooks     seams.Hooks
	Store     seams.Store
	// Tasks is what the server asks of Taskwarrior. A nil Install, or one that
	// fails, answers the task list and the snapshot's summary as not available —
	// never a 404 — and a write with a nil function is refused as unprocessable.
	Tasks seams.Tasks
	// Repositories is where the server works and any other directory read the
	// same way, and your home directory, which Taskwarrior's words can name
	// and an answer shows as ~; none leaves them naming it.
	Repositories seams.Repositories
	// Settings lists and removes the local data, and sets up a first
	// configuration file where none applies; Settings offers that only where
	// its Setup.Write is wired. The server keeps its own read of the
	// configuration, for its ETag, so it never calls Read or Save.
	Settings seams.Settings
	// Clock tells the time, for when the event stream last asked the forge.
	// Nil means the system clock.
	Clock func() time.Time

	// CheckKeys says why the terminal interface would refuse a ui.keys map,
	// or nil where it would start on it. Nil here means no map is checked.
	CheckKeys func(keys map[string]string) error
	// KeyActions is every action the terminal interface's help lists, with a
	// ui.keys map applied, its review noun and its messaging service naming
	// what the help names for them: the keys a page binds, read from the
	// terminal's own bindings. Nil lists none.
	KeyActions func(reviewNoun, messagingService string, overrides map[string]string) []seams.KeyAction
	// PaneSections is the page's section each of the terminal interface's
	// panes is shown in, in the panes' order, as the interface's key check
	// reads it. Nil lists none.
	PaneSections func() []seams.PageSection
	// Unexpected hears each failure the server answers as an internal error —
	// one no class of failure explains, or an answer that could not be
	// written — whose cause the answer leaves out, with the configuration in
	// effect when it failed: a credential taken up since the server started,
	// from a switch or a save in Settings, is that configuration's. Nil says
	// nothing.
	Unexpected func(inEffect config.Config, err error)
	// UseForgeSettings applies forge settings just saved to every forge call
	// after the save, and reports which forge the remote is on under them, so a
	// token, host or kind saved in Settings needs no restart. Nil leaves the
	// forge as it was started.
	UseForgeSettings func(settings config.Forge) forge.Kind
	// UseMessagingSettings applies messaging settings just saved to every post
	// after the save. Nil leaves messaging as it was started.
	UseMessagingSettings func(settings config.Messaging)
	// PlaceSlackCredentials keeps a Slack user token's secrets, typed into
	// Settings, where the configuration keeps them — refreshing the token once
	// and saving the pair to the macOS keychain, and answering the
	// configuration without them, or answering it unchanged where the file is
	// where they are kept. Nil writes them into the file as they came.
	PlaceSlackCredentials func(ctx context.Context, cfg config.Config) (config.Config, error)
	// KeepJiraToken keeps a Jira token typed into Settings in the macOS
	// keychain, under the item for its address, so the file saved reads it
	// from there. Nil writes it into the file as it came.
	KeepJiraToken func(ctx context.Context, service, secret string) error
	// Reach wires another directory as this one was wired, for a switch; nil
	// where switching is not offered. A setup takes the file up through it,
	// where the server works.
	Reach func(ctx context.Context, dir string) (World, error)
}

type Info struct {
	Version string
	DryRun  bool

	// ForgeKind is the forge the remote points at, resolved from the git remote
	// as the interface resolves it, so the announcement and the browser name a
	// "merge request" on GitLab and a "pull request" elsewhere — the health read
	// carries the words and the sigil to the page. The raw config kind is unset
	// for self-identifying hosts (gitlab.com), so it cannot answer this.
	ForgeKind forge.Kind

	// Repository names the repository the server runs in, as its forge path
	// or its directory, for the groups Settings keeps for it.
	Repository string

	// StreamInterval is how often the event stream re-pushes a snapshot. A zero
	// or negative value takes defaultStreamInterval.
	StreamInterval time.Duration

	// Taskwarrior is the taskwarrior settings Deps.Tasks was bound with when
	// workflow started in or switched to this directory. A change saved since
	// applies at the next start or directory switch, so while the settings in
	// effect differ the task list says so rather than a reason the new
	// settings would not give.
	Taskwarrior config.Taskwarrior
}

type World struct {
	Deps   Deps
	Config config.Config
	Info   Info
}