managers

type FileChange struct {
	// Path is the file to write (relative to Input.Dir or absolute).
	Path string
	// Old is the current content (nil when the file does not exist).
	Old []byte
	// New is the desired content.
	New []byte
}

type Input struct {
	// Config is the Atmos configuration.
	Config *schema.AtmosConfiguration
	// Track is the effective version track.
	Track string
	// Entries are the track's effective entries (policy applied).
	Entries map[string]manager.EffectiveEntry
	// Refs are the locked version references by entry name.
	Refs map[string]manager.VersionRef
	// Dir is the root directory globs are resolved from.
	Dir string
	// Paths are the glob patterns to scan (the manager's defaults when empty).
	Paths []string
	// Options carries manager-specific settings from the file rule.
	Options map[string]any
	// Render is the template engine (used by the template manager).
	Render RenderFunc
}

type Manager interface {
	// Name returns the manager's registry name.
	Name() string
	// DefaultPaths returns the glob patterns scanned when no file rule
	// configures paths (empty means the manager only runs when configured).
	DefaultPaths() []string
	// Plan returns the file changes needed to match the locked versions.
	Plan(ctx context.Context, in *Input) ([]FileChange, error)
}

type PlannedChange struct {
	Manager string
	FileChange
}

type RenderFunc = manager.RenderFunc

type RunOptions struct {
	// Config is the Atmos configuration.
	Config *schema.AtmosConfiguration
	// Track selects the version track ("" means the configured default).
	Track string
	// Dir is the root directory ("" means the current directory).
	Dir string
	// Only limits the run to the named managers (empty means all).
	Only []string
	// Render is the template engine for the template manager.
	Render RenderFunc
}