backup

type ArchiveEntry struct {
	// RelPath is the relative path inside the archive (e.g. "files/.config/foo.json").
	RelPath string
	// SourcePath is the absolute path on disk (source when creating; destination when extracting).
	SourcePath string
	// Mode is the file permission bits.
	Mode os.FileMode
}

type BackupSource string

type Manifest struct {
	ID        string          `json:"id"`
	CreatedAt time.Time       `json:"created_at"`
	RootDir   string          `json:"root_dir"`
	Entries   []ManifestEntry `json:"entries"`

	// Source identifies what operation created this backup.
	// Optional: omitted for backward-compatibility with old manifests.
	Source BackupSource `json:"source,omitempty"`

	// Description is a short human-readable note about the backup context.
	// Optional: omitted for backward-compatibility with old manifests.
	Description string `json:"description,omitempty"`

	// FileCount is the number of files that existed and were actually snapshotted.
	// Entries where Existed==false (files that did not exist at snapshot time) are
	// not counted. Optional: omitted when zero for backward-compatibility.
	FileCount int `json:"file_count,omitempty"`

	// CreatedByVersion is the teicos version that created this backup.
	// Optional: omitted when empty for backward-compatibility with old manifests.
	CreatedByVersion string `json:"created_by_version,omitempty"`

	// Pinned marks the backup as protected from retention pruning.
	// Optional: omitted when false for backward-compatibility with old manifests.
	Pinned bool `json:"pinned,omitempty"`

	// Compressed indicates the backup files are stored as a tar.gz archive.
	// Optional: omitted when false for backward-compatibility with old manifests.
	Compressed bool `json:"compressed,omitempty"`

	// Checksum is the SHA-256 composite hash of the snapshotted files, used for deduplication.
	// Optional: omitted when empty for backward-compatibility with old manifests.
	Checksum string `json:"checksum,omitempty"`
}

type ManifestEntry struct {
	OriginalPath string   `json:"original_path"`
	SnapshotPath string   `json:"snapshot_path"`
	Existed      bool     `json:"existed"`
	Mode         uint32   `json:"mode,omitempty"`
	Kind         PathKind `json:"kind,omitempty"`

	// LinkTarget is the recorded symlink target. Only set when Kind
	// is PathKindSymlinkDirectory. Restore validates that it is a safe
	// relative path (no leading '/', no '..' segments that escape).
	LinkTarget string `json:"link_target,omitempty"`
}

type PathKind string

type RestoreService struct {
	Roots []string
}

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