migrate

type CompareOptions struct {
	// Extensions to compare (e.g., []string{".html"})
	// If empty, all files are compared
	Extensions []string

	// IgnorePatterns are glob patterns to ignore
	IgnorePatterns []string
}

type CompareResult struct {
	// OldDir is the path to the old site directory
	OldDir string

	// NewDir is the path to the new site directory
	NewDir string

	// OldFiles is the list of files in the old directory
	OldFiles []string

	// NewFiles is the list of files in the new directory
	NewFiles []string

	// MissingInNew is the list of files in old but not in new
	MissingInNew []string

	// NewOnly is the list of files in new but not in old
	NewOnly []string

	// Common is the list of files present in both directories
	Common []string
}

type ConfigChange struct {
	// Type is the change type: "namespace", "rename", "transform", "remove"
	Type string

	// Path is the config path (e.g., "markata.nav")
	Path string

	// OldValue is the original value
	OldValue interface{}

	// NewValue is the migrated value
	NewValue interface{}

	// Description explains the change
	Description string
}

type FilterMigration struct {
	// Feed is the feed name this filter belongs to
	Feed string

	// Original is the original filter expression
	Original string

	// Migrated is the migrated filter expression
	Migrated string

	// Changes lists specific transformations applied
	Changes []string

	// Valid indicates if the migrated filter is valid
	Valid bool

	// Error contains any migration error
	Error string
}

type MigrationError struct {
	// Category groups related errors
	Category string

	// Message describes the error
	Message string

	// Path is the config path or file path
	Path string

	// Fatal indicates if migration cannot continue
	Fatal bool
}

type MigrationResult struct {
	// InputFile is the source config file path
	InputFile string

	// OutputFile is the target config file path
	OutputFile string

	// Changes is the list of configuration changes made
	Changes []ConfigChange

	// FilterMigrations is the list of filter expression migrations
	FilterMigrations []FilterMigration

	// Warnings is the list of non-blocking issues
	Warnings []Warning

	// Errors is the list of blocking issues
	Errors []MigrationError

	// TemplateIssues is the list of template compatibility issues
	TemplateIssues []TemplateIssue

	// MigratedConfig is the resulting configuration (as generic map)
	MigratedConfig map[string]interface{}

	// Timestamp when migration was performed
	Timestamp time.Time
}

type TemplateIssue struct {
	// File is the template file path
	File string

	// Line is the line number
	Line int

	// Issue describes the compatibility issue
	Issue string

	// Severity is "error", "warning", or "info"
	Severity string

	// Suggestion provides fix guidance
	Suggestion string
}

type TemplateVariable struct {
	Old        string
	New        string
	Deprecated bool
	Message    string
}

type Warning struct {
	// Category groups related warnings
	Category string // "config", "filter", "template", "plugin"

	// Message describes the warning
	Message string

	// Path is the config path or file path
	Path string

	// Suggestion provides actionable guidance
	Suggestion string
}