workdir

type CleanOptions struct {
	// Component is the specific component to clean (empty for all).
	Component string

	// Stack is the stack name (required when Component is specified).
	Stack string

	// All cleans all workdirs in the project.
	All bool

	// Expired cleans only workdirs whose LastAccessed is older than TTL.
	Expired bool

	// TTL is the time-to-live duration for expired cleanup (e.g., "7d", "24h", "weekly").
	// Required when Expired is true.
	TTL string

	// DryRun shows what would be cleaned without actually deleting.
	DryRun bool
}

type DefaultFileSystem struct{}

type DefaultHasher struct{}

type DefaultPathFilter struct{}

type ExpiredWorkdirInfo struct {
	// Path is the absolute path to the workdir.
	Path string
	// Name is the workdir name (e.g., "dev-vpc").
	Name string
	// LastAccessed is when the workdir was last accessed.
	LastAccessed time.Time
	// Age is how long ago the workdir was last accessed.
	Age time.Duration
}

type FileSystem interface {
	// MkdirAll creates a directory along with any necessary parents.
	MkdirAll(path string, perm fs.FileMode) error

	// RemoveAll removes path and any children it contains.
	RemoveAll(path string) error

	// Exists checks if a path exists.
	Exists(path string) bool

	// ReadFile reads the contents of a file.
	ReadFile(path string) ([]byte, error)

	// WriteFile writes data to a file with the given permissions.
	WriteFile(path string, data []byte, perm fs.FileMode) error

	// CopyDir recursively copies a directory from src to dst.
	CopyDir(src, dst string) error

	// SyncDir syncs files from src to dst using per-file checksums.
	// Only copies changed files, adds new files, and deletes removed files.
	// Skips the .atmos/ directory which contains Atmos metadata.
	// Returns true if any changes were made, false if directories were in sync.
	SyncDir(src, dst string, hasher Hasher) (bool, error)

	// Walk walks the file tree rooted at root, calling fn for each file or directory.
	Walk(root string, fn fs.WalkDirFunc) error

	// Stat returns file info for the given path.
	Stat(path string) (fs.FileInfo, error)
}

type Hasher interface {
	// HashDir computes a hash of all files in a directory.
	HashDir(path string) (string, error)

	// HashFile computes a hash of a single file.
	HashFile(path string) (string, error)
}

type PathFilter interface {
	// Match returns true if the path should be included.
	Match(path string, includedPaths, excludedPaths []string) (bool, error)
}

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

type SourceType string

type WorkdirConfig struct {
	// Enabled controls whether workdir provisioning is active.
	// Defaults to false; set provision.workdir.enabled: true to enable.
	Enabled bool `yaml:"enabled,omitempty" json:"enabled,omitempty" mapstructure:"enabled"`
}

type WorkdirMetadata struct {
	// Component is the component name.
	Component string `json:"component"`

	// Stack is the stack name (optional, for stack-specific workdirs).
	Stack string `json:"stack,omitempty"`

	// SourceType indicates the source type ("local" or "remote").
	SourceType SourceType `json:"source_type"`

	// Source is the original component source path.
	Source string `json:"source,omitempty"`

	// SourceURI is the remote source URI (for remote sources).
	SourceURI string `json:"source_uri,omitempty"`

	// SourceVersion is the remote source version (for remote sources).
	SourceVersion string `json:"source_version,omitempty"`

	// CreatedAt is when the workdir was created.
	CreatedAt time.Time `json:"created_at"`

	// UpdatedAt is when the workdir was last updated.
	UpdatedAt time.Time `json:"updated_at"`

	// LastAccessed is when the workdir was last accessed (for TTL tracking).
	LastAccessed time.Time `json:"last_accessed,omitempty"`

	// ContentHash is a hash of the source content for change detection (local sources only).
	ContentHash string `json:"content_hash,omitempty"`
}