plugin

type AppContext struct {
	Config  *config.Config
	WorkDir string
	Version string

	// Refresh is called before accessing Config/WorkDir to ensure
	// they reflect the current state. Set by the App struct.
	Refresh func()
}

type ChangeDetectionProvider interface {
	Plugin
	DetectChangedModules(ctx context.Context, appCtx *AppContext, baseRef string, moduleIndex *discovery.ModuleIndex) (changed []*discovery.Module, changedFiles []string, err error)
	DetectChangedLibraries(ctx context.Context, appCtx *AppContext, baseRef string, libraryPaths []string) ([]string, error)
}

type CommandProvider interface {
	Plugin
	Commands(ctx *AppContext) []*cobra.Command
}

type CommentSection struct {
	Order   int    // Lower = rendered first
	Title   string // Section heading
	Content string // Markdown content
}

type ConfigProvider interface {
	Plugin
	ConfigKey() string
	NewConfig() any
	SetConfig(cfg any) error
	IsConfigured() bool // true if SetConfig was called with explicit config
}

type ExecutionContext struct {

	// PlanResults is the collected plan result data, available for enrichment.
	PlanResults *ci.PlanResultCollection

	// Sections holds additional markdown sections contributed by plugins.
	Sections []CommentSection

	// Data holds arbitrary typed data for inter-plugin communication.
	Data map[string]any
	// contains filtered or unexported fields
}

type FilterProvider interface {
	Plugin
	Filters(ctx *AppContext) []filter.ModuleFilter
}

type Finalizable interface {
	Plugin
	Finalize(ctx context.Context) error
}

type GeneratorProvider interface {
	Plugin
	ProviderName() string
	DetectEnv() bool
	NewGenerator(ctx *AppContext, depGraph *graph.DependencyGraph, modules []*discovery.Module) pipeline.Generator
	NewCommentService(ctx *AppContext) ci.CommentService
}

type HookPhase int

type InitContribution struct {
	PluginKey string
	Config    map[string]any
}

type InitContributor interface {
	Plugin
	InitGroup() *InitGroupSpec
	BuildInitConfig(state InitState) *InitContribution
}

type InitField struct {
	Key         string
	Title       string
	Description string
	Type        string // "string", "bool", "select"
	Default     any
	Options     []InitOption
	Placeholder string
}

type InitGroupSpec struct {
	Title    string
	Order    int
	Fields   []InitField
	ShowWhen func(InitState) bool
}

type InitOption struct {
	Label string
	Value string
}

type InitState interface {
	Get(key string) any
	Set(key string, val any)
	Provider() string
	Binary() string
}

type Initializable interface {
	Plugin
	Initialize(ctx context.Context, appCtx *AppContext) error
}

type PipelineContributor interface {
	Plugin
	PipelineContribution() *pipeline.Contribution
}

type Plugin interface {
	// Name returns a unique identifier (e.g., "gitlab", "cost", "slack").
	Name() string
	// Description returns a human-readable description.
	Description() string
}

type StateMap struct {
	// contains filtered or unexported fields
}

type SummaryContributor interface {
	Plugin
	ContributeToSummary(ctx context.Context, appCtx *AppContext, execCtx *ExecutionContext) error
}

type VersionProvider interface {
	Plugin
	VersionInfo() map[string]string
}

type WorkflowHook struct {
	Phase    HookPhase
	Priority int // Lower = runs first. Default 100.
	Fn       func(ctx context.Context, state *WorkflowState) error
}

type WorkflowHookProvider interface {
	Plugin
	WorkflowHooks() []WorkflowHook
}

type WorkflowState struct {
	// AllModules is populated after scan.
	AllModules []*discovery.Module
	// Filtered is populated after filter.
	Filtered []*discovery.Module
	// Dependencies is populated after parse.
	Dependencies map[string]*parser.ModuleDependencies
	// Graph is populated after graph build.
	Graph *graph.DependencyGraph
	// Warnings collects non-fatal issues.
	Warnings []error
}