harness

type AgentInfo struct {
	Name   string                // "Claude Code"
	ID     string                // "claude"
	Detect func() bool           // returns true if the agent is installed
	Checks func() []*StatusCheck // cheap health checks gating setup wizard behavior

	// FindBinary returns the agent's executable path, or "" when it is not on
	// disk. Setup reads it to decide whether a "binary not found" remediation
	// applies; nil means the agent has no executable to look for.
	FindBinary func() string

	// Diagnostics returns the full doctor check suite, including checks that
	// are too slow or noisy for the wizard (e.g. version comparisons).
	// When nil, doctor falls back to Checks.
	Diagnostics func(ctx context.Context) []*StatusCheck
}

type SkillAgent struct {
	Name    string // "Grok"
	ID      string // "grok"; the `basecamp setup <id>` subcommand and BASECAMP_SETUP_AGENT value
	HomeEnv string // "GROK_HOME"; overrides HomeDir when set
	HomeDir string // ".grok"; under the user's home directory
	Binary  string // "grok"; the executable's name
}

type StalePlugin struct {
	Key    string
	Scopes []string // empty = unknown, fall back to unscoped uninstall
}

type StatusCheck struct {
	Name    string `json:"name"`
	Status  string `json:"status"` // "pass", "warn", "fail"
	Message string `json:"message"`
	Hint    string `json:"hint,omitempty"`
}