backup

type AutoRecoveryResult struct {
	// Recovered indicates if recovery was performed
	Recovered bool `json:"recovered"`
	// RepairedDatabases lists databases salvaged in place without backup rollback.
	RepairedDatabases []string `json:"repaired_databases,omitempty"`
	// RepairDetails describes how each repaired database was salvaged.
	RepairDetails map[string]DatabaseRepairDetail `json:"repair_details,omitempty"`
	// BackupID is the ID of the backup used for recovery
	BackupID string `json:"backup_id,omitempty"`
	// BackupTime is the timestamp of the backup used
	BackupTime time.Time `json:"backup_time,omitempty"`
	// Error contains any error message
	Error string `json:"error,omitempty"`
	// FilesRecovered is the number of files recovered
	FilesRecovered int `json:"files_recovered,omitempty"`
	// DatabasesChecked lists the databases that were checked
	DatabasesChecked []string `json:"databases_checked,omitempty"`
	// CorruptedDatabases lists the databases that were found corrupted
	CorruptedDatabases []string `json:"corrupted_databases,omitempty"`
}

type BackupInfo struct {
	ID        string    `json:"id"`
	CreatedAt time.Time `json:"created_at"`
	SizeBytes int64     `json:"size_bytes"`
	Path      string    `json:"path"`
	Type      string    `json:"type"` // full, config, data
	// CreatedBy indicates who created this backup: manual, auto, checkpoint.
	CreatedBy string   `json:"created_by,omitempty"`
	Checksum  string   `json:"checksum"`
	Version   string   `json:"version"`
	Files     []string `json:"files"`
	// IsCheckpoint marks backups created automatically before restore.
	IsCheckpoint bool `json:"is_checkpoint,omitempty"`
	// CheckpointReason indicates why the checkpoint was created.
	CheckpointReason string `json:"checkpoint_reason,omitempty"`
}

type BackupSource string

type BackupType string

type CompatibilityResult struct {
	BackupVersion     string   `json:"backup_version"`
	CurrentVersion    string   `json:"current_version"`
	Compatible        bool     `json:"compatible"`
	RequiresMigration bool     `json:"requires_migration"`
	MigrationsNeeded  int      `json:"migrations_needed"`
	MigrationVersions []string `json:"migration_versions,omitempty"`
	Message           string   `json:"message"`
}

type Config struct {
	Enabled            bool          `yaml:"enabled"`
	Schedule           string        `yaml:"schedule"` // cron expression
	RetentionDays      int           `yaml:"retention_days"`
	Path               string        `yaml:"path"`
	SkillsPath         string        `yaml:"skills_path"`
	AutoBackup         bool          `yaml:"auto_backup"`
	AutoBackupInterval time.Duration `yaml:"auto_backup_interval"`
	AutoBackupOnChange bool          `yaml:"auto_backup_on_change"`
	ChangePollInterval time.Duration `yaml:"change_poll_interval"`
	ChangeDebounce     time.Duration `yaml:"change_debounce"`
}

type CreateRequest struct {
	Type string `json:"type"` // full, config, data
}

type DatabaseRepairDetail struct {
	Method        string `json:"method"`
	PartialImport bool   `json:"partial_import,omitempty"`
	Warning       string `json:"warning,omitempty"`
}

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

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

type Migration struct {
	Version     string                                      `json:"version"`
	Description string                                      `json:"description"`
	Up          func(ctx context.Context, m *Manager) error `json:"-"`
	Down        func(ctx context.Context, m *Manager) error `json:"-"`
}

type MigrationHistory struct {
	CurrentVersion string            `json:"current_version"`
	Migrations     []MigrationRecord `json:"migrations"`
}

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

type MigrationRecord struct {
	Version   string `json:"version"`
	AppliedAt string `json:"applied_at"`
	Success   bool   `json:"success"`
}

type MigrationResult struct {
	Success         bool     `json:"success"`
	Message         string   `json:"message"`
	MigrationsRun   int      `json:"migrations_run"`
	MigrationsTotal int      `json:"migrations_total"`
	AppliedVersions []string `json:"applied_versions"`
	Errors          []string `json:"errors,omitempty"`
}

type PendingRestore struct {
	BackupID   string `json:"backup_id"`
	BackupPath string `json:"backup_path"`
	StagingDir string `json:"staging_dir"`
	CreatedAt  string `json:"created_at"`
}

type Progress struct {
	InProgress     bool      `json:"in_progress"`
	Operation      string    `json:"operation"` // "backup" or "restore"
	ProgressPct    int       `json:"progress"`  // 0-100
	CurrentFile    string    `json:"current_file"`
	FilesProcessed int       `json:"files_processed"`
	TotalFiles     int       `json:"total_files"`
	BytesProcessed int64     `json:"bytes_processed"`
	TotalBytes     int64     `json:"total_bytes"`
	StartedAt      time.Time `json:"started_at"`
	Error          string    `json:"error,omitempty"`
}

type ProgressResponse struct {
	InProgress     bool   `json:"in_progress"`
	Operation      string `json:"operation"` // "backup" or "restore"
	Progress       int    `json:"progress"`  // 0-100
	CurrentFile    string `json:"current_file"`
	FilesProcessed int    `json:"files_processed"`
	TotalFiles     int    `json:"total_files"`
	BytesProcessed int64  `json:"bytes_processed"`
	TotalBytes     int64  `json:"total_bytes"`
	StartedAt      string `json:"started_at"`
	Error          string `json:"error,omitempty"`
}

type RestoreOptions struct {
	// OverwriteExisting overwrites existing files
	OverwriteExisting bool
	// RestoreConfig restores configuration files
	RestoreConfig bool
	// RestoreData restores data files
	RestoreData bool
	// RestoreSkills restores skills files
	RestoreSkills bool
	// CreateCheckpoint creates a full backup before restore.
	CreateCheckpoint bool
	// CheckpointReason tags the pre-restore checkpoint metadata.
	CheckpointReason string
	// DryRun only validates without actually restoring
	DryRun bool
	// SkipVerify skips checksum verification
	// Security: This option is deprecated and will log a warning.
	// Checksum verification is critical for detecting tampered backups.
	SkipVerify bool
	// RequireRestart if true, stages the restore for next restart instead of immediate restore
	// This is the recommended approach for hot recovery to avoid database lock issues
	RequireRestart bool
}

type RestoreRequest struct {
	Force            bool  `json:"force"`                       // Skip checksum verification
	RequireRestart   *bool `json:"require_restart,omitempty"`   // Default true for DB-safe restore
	CreateCheckpoint *bool `json:"create_checkpoint,omitempty"` // Default true
	AutoRestart      *bool `json:"auto_restart,omitempty"`      // Default true when require_restart=true
}

type RestoreResult struct {
	Success          bool     `json:"success"`
	FilesRestored    int      `json:"files_restored"`
	FilesSkipped     int      `json:"files_skipped"`
	CheckpointID     string   `json:"checkpoint_id,omitempty"`
	CheckpointAt     string   `json:"checkpoint_at,omitempty"`
	CheckpointReason string   `json:"checkpoint_reason,omitempty"`
	Errors           []string `json:"errors,omitempty"`
}

type RestoreWithMigrationResult struct {
	Success         bool                 `json:"success"`
	Message         string               `json:"message"`
	Compatibility   *CompatibilityResult `json:"compatibility"`
	RestoreResult   *RestoreResult       `json:"restore_result,omitempty"`
	MigrationResult *MigrationResult     `json:"migration_result,omitempty"`
}