tui

type LockWizardConfig struct {
	LockPath string
	Skills   []LockWizardSkill
	Phases   LockWizardPhases
}

type LockWizardOutcome struct {
	Cancelled bool // user quit before approving: zero writes (CodeCancelled)
	NoAgents  bool // nothing to select: zero writes (CodeUnsupportedAgent)
	Executed  bool
	AgentIDs  []string
	Result    app.InstallFromLockResult
	Err       error
}

type LockWizardPhases struct {
	Agents  func(context.Context) ([]app.AgentChoice, error)
	Execute func(context.Context, []string) (app.InstallFromLockResult, error)
}

type LockWizardSkill struct {
	Name   string
	Source string
	// Agents is the entry's currently recorded gskill.agents (nil for a raw,
	// unmanaged entry), used to compute the kept/added/removed plan the
	// preview screen shows before the user confirms (spec 013 FR-006).
	Agents []string
}

type Session struct {
	Source         string
	SourceAnswered bool

	Selected       []discovery.DiscoveredSkill
	SkillsAnswered bool

	// Requested version pin (one of Version/RefSpec/Commit), plus a display
	// label for the preview.
	Version         string
	RefSpec         string
	Commit          string
	VersionLabel    string
	VersionAnswered bool

	AgentIDs       []string
	AgentsAnswered bool

	// ApprovalAnswered maps --yes: the approval step auto-approves a
	// conflict-free plan (it never bypasses a conflicted one, FR-016).
	ApprovalAnswered bool
}

type SkillItem struct {
	ID          string
	DisplayName string
	Description string
	RepoPath    string
	Valid       bool
	// InvalidReason is the first error-severity diagnostic for an invalid
	// skill, shown when the cursor is on its row (FR-011).
	InvalidReason string
}

type SkillRow struct {
	Name     string
	Version  string
	Source   string
	Status   string
	Markdown string // SKILL.md content for the preview pane
}

type Theme struct {
	Title    lipgloss.Style // step/screen headings
	Subtitle lipgloss.Style // secondary heading line
	Accent   lipgloss.Style // source names, counts, selections
	Hint     lipgloss.Style // keyboard hint footers
	Cursor   lipgloss.Style // the "❯" row cursor
	Selected lipgloss.Style // chosen items / active option
	Invalid  lipgloss.Style // non-selectable rows
	Success  lipgloss.Style // confirmation lines
	Warning  lipgloss.Style // degraded notes, warnings
	Error    lipgloss.Style // failures, conflicts
	Badge    lipgloss.Style // step-position badge ("step 2/6")

	Border      lipgloss.Style // panel borders
	TableHeader lipgloss.Style // column header rows
}

type WizardConfig struct {
	Session Session
	Phases  WizardPhases
	// SourceSuggestions are configured sources offered as a pick list on the
	// source step (US5), above the free-form input.
	SourceSuggestions []string
}

type WizardOutcome struct {
	Cancelled bool
	Executed  bool
	Result    app.AddResult
	Err       error
}

type WizardPhases struct {
	Discover func(context.Context) (app.DiscoverResult, error)
	Versions func(context.Context) (app.VersionList, error)
	Agents   func(context.Context) ([]app.AgentChoice, error)
	Plan     func(context.Context, *Session) (app.InstallPlan, error)
	Execute  func(context.Context, app.InstallPlan, func(app.ProgressEvent)) (app.AddResult, error)
	// ValidateSource vets typed source input on the source step (US5).
	ValidateSource func(string) error
	// ResolveSelection, when set, resolves flag-given skill selectors against
	// the discovery result; the selection step is then skipped (FR-004).
	ResolveSelection func(context.Context, app.DiscoverResult) ([]discovery.DiscoveredSkill, error)
	// SourceChosen, when set, is called with the source accepted on the
	// source step, before discovery starts — the CLI's phase closures read
	// the chosen source through it (US5).
	SourceChosen func(string)
}