snapshot

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

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

type ArchiveOptions struct {
	// UseGitignore enables parsing .gitignore files to exclude matching paths.
	UseGitignore bool
	// Additional specifies extra patterns to exclude (gitignore syntax).
	Additional []string
	// IncludeGit keeps the .git directory in the archive instead of skipping
	// it. Volume mode sets this so agent commits made inside the container
	// survive snapshot extraction. Defaults to false (bind-mode behavior),
	// which always excludes .git.
	IncludeGit bool
}

type Backend interface {
	// Name returns the backend identifier (e.g., "apfs", "zfs", "archive").
	Name() string

	// Create creates a snapshot of the workspace and returns its native reference.
	Create(workspacePath string, id string) (nativeRef string, err error)

	// Restore restores a snapshot to the workspace (in-place).
	Restore(workspacePath string, nativeRef string) error

	// RestoreTo restores a snapshot to a different directory.
	RestoreTo(nativeRef string, destPath string) error

	// Delete removes a snapshot.
	Delete(nativeRef string) error

	// List returns all snapshots for a workspace.
	List(workspacePath string) ([]string, error)
}

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

type EngineOptions struct {
	// UseGitignore enables parsing .gitignore files to exclude matching paths.
	UseGitignore bool
	// Additional specifies extra patterns to exclude (gitignore syntax).
	Additional []string
	// ForceBackend forces a specific backend: BackendArchive or BackendAPFS.
	ForceBackend string
	// IncludeGit keeps the .git directory in archive snapshots. Volume mode
	// sets this so agent commits survive extraction; default false preserves
	// bind-mode behavior (always exclude .git).
	IncludeGit bool
}

type Metadata struct {
	ID        string    `json:"id"`
	Type      Type      `json:"type"`
	Label     string    `json:"label,omitempty"`
	Backend   string    `json:"backend"`
	CreatedAt time.Time `json:"created_at"`
	SizeDelta *int64    `json:"size_delta,omitempty"`
	NativeRef string    `json:"native_ref,omitempty"`
}

type Type string