workspace

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

type Config struct {
	// HostPath is the path on the host to mount/copy
	HostPath string

	// RemotePath is the path inside the container
	RemotePath string

	// ProjectName is used for naming volumes
	ProjectName string

	// AgentName is used for naming agent-specific volumes
	AgentName string

	IgnorePatterns []string // Patterns to exclude (snapshot: tar filtering, bind: tmpfs overlays)
}

type ConfigVolumeResult struct {
	ConfigCreated  bool
	HistoryCreated bool
}

type GitCredentialSetupResult struct {
	Mounts []mount.Mount
	Env    []string
}

type SetupMountsConfig struct {
	// Log is the logger instance for diagnostic file logging.
	Log *logger.Logger
	// ModeOverride is the CLI flag value (empty means use config default)
	ModeOverride string
	// Cfg is the config.Config interface for reading paths and constants.
	Cfg config.Config
	// ProjectName is the resolved project name for volume naming.
	// Resolved from project.ProjectManager at the command level.
	// Empty string when no project is registered.
	ProjectName string
	// AgentName is the agent name for volume naming
	AgentName string
	// WorkDir is the host working directory for workspace mounts.
	// If empty, falls back to os.Getwd() for backward compatibility.
	WorkDir string
	// ProjectRootDir is the main repository root when using a worktree.
	// If set, the .git directory will be mounted at the same absolute path
	// in the container to allow git worktree references to resolve.
	ProjectRootDir string
	// ContainerPath is the container-side mount destination for the workspace.
	// Set to the host absolute path for Claude Code /resume compatibility.
	// Must be set by callers (CreateContainer passes the resolved working directory).
	ContainerPath string
}

type SetupMountsResult struct {
	// Mounts is the list of mounts to add to the container's HostConfig.
	Mounts []mount.Mount
	// ConfigVolumeResult tracks which config volumes were newly created.
	// Used by container init orchestration to decide whether to copy host config.
	ConfigVolumeResult ConfigVolumeResult
	// WorkspaceVolumeName is the name of the workspace volume created during setup.
	// Non-empty only for snapshot mode. Used for cleanup on init failure.
	WorkspaceVolumeName string
	// ContainerPath is the resolved container-side workspace mount path.
	ContainerPath string
}

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

type Strategy interface {
	// Name returns the strategy name for logging/display
	Name() string

	// Mode returns the config mode this strategy implements
	Mode() config.Mode

	// Prepare sets up any required resources (volumes, etc.)
	Prepare(ctx context.Context, cli *docker.Client) error

	// GetMounts returns the Docker mount configuration for the workspace.
	// Returns an error if mount generation requires I/O that fails (e.g. scanning
	// for ignored directories in bind mode).
	GetMounts() ([]mount.Mount, error)

	// Cleanup removes any temporary resources
	Cleanup(ctx context.Context, cli *docker.Client) error

	// ShouldPreserve returns true if resources should be preserved on down
	ShouldPreserve() bool
}