setup

type Host struct {
	Name string
	// Detect reports whether this host is installed. Presence-based: a command
	// on PATH, or a config directory that exists. A host nobody has installed
	// is skipped, never failed — "not installed" is not an error.
	Detect func() bool
	// Where is the config path or command shown in the report.
	Where func() string
	// Config is the file this host's registration rewrites, so it can be
	// backed up first. Empty means the file does not exist yet or logos does
	// not know where it lives — a host registered through its own CLI still
	// rewrites a file, and knowing which one is the only way back from a wrong
	// --vault.
	Config func() string
	// Register points the host at this server.
	Register func(Server) (Outcome, error)
	// List reports every MCP server this host currently has registered, read
	// back rather than assumed. Nil means this host exposes no way to read
	// that back — not an error, just a question this host cannot answer.
	List func() ([]Registration, error)
	// RemoveOld removes the entry 0.4 setup registered under OldName, and
	// reports whether there was one. Nil for a host 0.4 never wired.
	RemoveOld func() (bool, error)
}

type Outcome string

type Registration struct {
	Name    string
	Command string
}

type Result struct {
	Host    string
	Outcome Outcome
	Where   string // config path or command, for the report
	// Backup is the copy of this host's config taken before it was changed,
	// empty when there was nothing to copy. Reported, because a backup nobody
	// is told about is a backup nobody uses.
	Backup string
	// CommentsOnlyInBackup is set when the original config had comments.
	// Writing it back as JSON drops them, and the backup is the one place
	// they still exist.
	CommentsOnlyInBackup bool
	Err                  error
	// Replaced is set when the entry 0.4 setup wrote under OldName was
	// removed, and ReplaceErr when that was tried and failed. Neither fails the
	// host: logos is registered either way, and the leftover is reported.
	Replaced   bool
	ReplaceErr error
}

type Server struct {
	// Bin is the absolute path to the logos binary. Absolute because a host
	// launches it from a working directory nobody chose.
	Bin  string
	Args []string
	// Env is what the host must set. LOGOS_VAULT belongs here and must be
	// absolute for the same reason Bin is.
	Env map[string]string
}