workspace

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

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

type HistoryMode string

type Manifest struct {
	// Strategy is the name of the strategy used
	Strategy string `json:"strategy"`

	// Source is the origin of the workspace content
	Source string `json:"source"`

	// Ref is the git reference that was checked out
	Ref string `json:"ref,omitempty"`

	// HeadSHA is the commit SHA of the workspace
	HeadSHA string `json:"head_sha,omitempty"`

	// CreatedAt is the timestamp when the workspace was prepared
	CreatedAt time.Time `json:"created_at"`

	// HasHistory indicates whether git history is available
	HasHistory bool `json:"has_history"`

	// IsShallow indicates whether the git repository is shallow
	IsShallow bool `json:"is_shallow"`

	// Notes contains any additional information
	Notes []string `json:"notes,omitempty"`
}

type PrepareRequest struct {
	// Source is the origin of the workspace content
	// Examples: local path "/path/to/repo", remote URL "https://github.com/owner/repo.git"
	Source string

	// Ref is the git reference to checkout (branch, tag, or SHA)
	// Examples: "main", "v1.0.0", "abc123def", "" (HEAD)
	Ref string

	// Dest is the host directory where the workspace will be created
	// This directory will be mounted into the container at /holon/workspace
	Dest string

	// History specifies how much git history to include
	History HistoryMode

	// Submodules specifies how to handle git submodules
	Submodules SubmoduleMode

	// CleanDest indicates whether to clean the destination directory before preparation
	// If true, any existing content at Dest will be removed
	CleanDest bool
}

type PrepareResult struct {
	// Strategy is the name of the strategy that handled this request
	Strategy string `json:"strategy"`

	// Source is the origin that was used
	Source string `json:"source"`

	// Ref is the git reference that was checked out
	Ref string `json:"ref"`

	// HeadSHA is the commit SHA of the workspace after preparation
	HeadSHA string `json:"head_sha"`

	// CreatedAt is the timestamp when preparation completed
	CreatedAt time.Time `json:"created_at"`

	// HasHistory indicates whether git history is available
	HasHistory bool `json:"has_history"`

	// IsShallow indicates whether the git repository is shallow
	IsShallow bool `json:"is_shallow"`

	// Notes contains any additional information about the preparation
	Notes []string `json:"notes,omitempty"`
}

type Preparer interface {
	// Prepare creates a workspace directory at Dest with the requested content
	Prepare(ctx context.Context, req PrepareRequest) (PrepareResult, error)

	// Name returns the strategy name (e.g., "git-clone", "snapshot", "existing")
	Name() string

	// Validate checks if the request is valid for this preparer
	// Returns nil if valid, or an error describing what's invalid
	Validate(req PrepareRequest) error

	// Cleanup performs any necessary cleanup after workspace use
	// For most strategies, this is a simple directory removal
	// Returns an error if cleanup fails
	Cleanup(dest string) error
}

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

type SubmoduleMode string