config

type ApplicationConfig struct {
	// Application holds the application-level metadata and workflow references.
	Application ApplicationInfo `json:"application" yaml:"application"`
	// ConfigDir is the directory of the application config file, used for resolving relative paths.
	ConfigDir string `json:"-" yaml:"-"`
}

type ApplicationInfo struct {
	// Name is the application name.
	Name string `json:"name" yaml:"name"`
	// Workflows lists the workflow config files that make up this application.
	Workflows []WorkflowRef `json:"workflows" yaml:"workflows"`
}

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

type ConfigChangeEvent struct {
	Source  string
	OldHash string
	NewHash string
	Config  *WorkflowConfig
	Time    time.Time
}

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

type ConfigSource interface {
	// Load retrieves the current configuration.
	Load(ctx context.Context) (*WorkflowConfig, error)

	// Hash returns a content-addressable hash of the current config.
	// Used for change detection without full deserialization.
	Hash(ctx context.Context) (string, error)

	// Name returns a human-readable identifier for this source.
	Name() string
}

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

type DBConfigStore interface {
	GetConfigDocument(ctx context.Context, key string) ([]byte, error)
	GetConfigDocumentHash(ctx context.Context, key string) (string, error)
	PutConfigDocument(ctx context.Context, key string, data []byte) error
}

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

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

type DatabaseSourceOption func(*DatabaseSource)

type ExternalPluginDecl struct {
	// Name is the plugin name as registered in the plugin registry.
	Name string `json:"name" yaml:"name"`
	// Version is an optional version specifier forwarded to wfctl plugin install
	// as name@version. Simple constraints (>=, ^, ~) are stripped to extract the
	// version; compound constraints fall back to installing the latest.
	// Used only when AutoFetch is true.
	Version string `json:"version,omitempty" yaml:"version,omitempty"`
	// AutoFetch controls whether the engine should download the plugin
	// automatically if it is not found in the local plugin directory.
	AutoFetch bool `json:"autoFetch,omitempty" yaml:"autoFetch,omitempty"`
}

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

type InfraResourceConfig struct {
	Name     string         `json:"name" yaml:"name"`
	Type     string         `json:"type" yaml:"type"`
	Provider string         `json:"provider" yaml:"provider"`
	Config   map[string]any `json:"config,omitempty" yaml:"config,omitempty"`
}

type InfrastructureConfig struct {
	Resources []InfraResourceConfig `json:"resources" yaml:"resources"`
}

type ModuleConfig struct {
	Name      string            `json:"name" yaml:"name"`
	Type      string            `json:"type" yaml:"type"`
	Config    map[string]any    `json:"config,omitempty" yaml:"config,omitempty"`
	DependsOn []string          `json:"dependsOn,omitempty" yaml:"dependsOn,omitempty"`
	Branches  map[string]string `json:"branches,omitempty" yaml:"branches,omitempty"`
}

type ModuleConfigChange struct {
	Name      string
	OldConfig map[string]any
	NewConfig map[string]any
}

type ModuleConfigDiff struct {
	Added     []ModuleConfig       // modules in new but not old
	Removed   []ModuleConfig       // modules in old but not new
	Modified  []ModuleConfigChange // modules present in both with different config
	Unchanged []string             // module names with no config change
}

type ModuleReconfigurer interface {
	// ReconfigureModules applies new configuration to specific running modules.
	// Returns the names of any modules that could not be reconfigured in-place
	// (requiring a full reload) and any hard error.
	ReconfigureModules(ctx context.Context, changes []ModuleConfigChange) (failedModules []string, err error)
}

type PipelineConfig struct {
	Trigger      PipelineTriggerConfig `json:"trigger" yaml:"trigger"`
	Steps        []PipelineStepConfig  `json:"steps" yaml:"steps"`
	OnError      string                `json:"on_error,omitempty" yaml:"on_error,omitempty"`
	Timeout      string                `json:"timeout,omitempty" yaml:"timeout,omitempty"`
	Compensation []PipelineStepConfig  `json:"compensation,omitempty" yaml:"compensation,omitempty"`
}

type PipelineStepConfig struct {
	Name    string         `json:"name" yaml:"name"`
	Type    string         `json:"type" yaml:"type"`
	Config  map[string]any `json:"config,omitempty" yaml:"config,omitempty"`
	OnError string         `json:"on_error,omitempty" yaml:"on_error,omitempty"`
	Timeout string         `json:"timeout,omitempty" yaml:"timeout,omitempty"`
}

type PipelineTriggerConfig struct {
	Type   string         `json:"type" yaml:"type"`
	Config map[string]any `json:"config,omitempty" yaml:"config,omitempty"`
}

type PluginRequirement struct {
	Name    string `json:"name" yaml:"name"`
	Version string `json:"version,omitempty" yaml:"version,omitempty"`
}

type PluginsConfig struct {
	// External lists external plugins that the engine should discover and load.
	External []ExternalPluginDecl `json:"external,omitempty" yaml:"external,omitempty"`
}

type RequiresConfig struct {
	Capabilities []string            `json:"capabilities,omitempty" yaml:"capabilities,omitempty"`
	Plugins      []PluginRequirement `json:"plugins,omitempty" yaml:"plugins,omitempty"`
}

type SidecarConfig struct {
	Name      string         `json:"name" yaml:"name"`
	Type      string         `json:"type" yaml:"type"`
	Config    map[string]any `json:"config,omitempty" yaml:"config,omitempty"`
	DependsOn []string       `json:"dependsOn,omitempty" yaml:"dependsOn,omitempty"`
}

type WatcherOption func(*ConfigWatcher)

type WorkflowConfig struct {
	Imports        []string              `json:"imports,omitempty" yaml:"imports,omitempty"`
	Modules        []ModuleConfig        `json:"modules" yaml:"modules"`
	Workflows      map[string]any        `json:"workflows" yaml:"workflows"`
	Triggers       map[string]any        `json:"triggers" yaml:"triggers"`
	Pipelines      map[string]any        `json:"pipelines,omitempty" yaml:"pipelines,omitempty"`
	Platform       map[string]any        `json:"platform,omitempty" yaml:"platform,omitempty"`
	Requires       *RequiresConfig       `json:"requires,omitempty" yaml:"requires,omitempty"`
	Plugins        *PluginsConfig        `json:"plugins,omitempty" yaml:"plugins,omitempty"`
	Sidecars       []SidecarConfig       `json:"sidecars,omitempty" yaml:"sidecars,omitempty"`
	Infrastructure *InfrastructureConfig `json:"infrastructure,omitempty" yaml:"infrastructure,omitempty"`
	ConfigDir      string                `json:"-" yaml:"-"` // directory containing the config file, used for relative path resolution
}

type WorkflowRef struct {
	// File is the path to the workflow YAML config file (relative to the application config).
	File string `json:"file" yaml:"file"`
	// Name is an optional override for the workflow's name within the application namespace.
	// If empty, the filename stem (without extension) is used.
	Name string `json:"name,omitempty" yaml:"name,omitempty"`
}