playbooks

type CopyError struct {
	// Path is the file path where the error occurred
	Path string

	// Err is the underlying error
	Err error

	// IsWarning indicates if this is a non-fatal warning
	IsWarning bool
}

type CopyOptions struct {
	// DryRun if true, shows what would be copied without actually copying
	DryRun bool

	// Overwrite if true, overwrites existing files in the destination
	// Default is false (skip existing files)
	Overwrite bool

	// SkipExisting if true, skips existing files (default behavior)
	// Ignored if Overwrite is true
	SkipExisting bool

	// Verbose if true, prints each file being copied
	Verbose bool

	// Framework filters templates by framework type (optional)
	// If set, only templates matching this framework are copied
	Framework string

	// AgentTargetDir specifies where to copy commands and skills (e.g., ".agents")
	// If empty, defaults to ".claude"
	// When multi-agent mode is enabled, this should be set to ".agents"
	AgentTargetDir string
}

type CopyResult struct {
	// FilesCopied is the count of files successfully copied
	FilesCopied int

	// FilesSkipped is the count of files skipped (already existed)
	FilesSkipped int

	// FilesMerged is the count of files merged (sentinel-based)
	FilesMerged int

	// Errors is a list of errors encountered during copying
	Errors []CopyError

	// Duration is how long the copy operation took
	Duration time.Duration
}

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

type Playbook struct {
	// Name is the unique identifier for this playbook (e.g., "specledger")
	Name string `yaml:"name"`

	// Description explains what this playbook provides to users
	Description string `yaml:"description"`

	// Framework is the SDD framework type (optional, for future use)
	Framework string `yaml:"framework,omitempty"`

	// Version is the playbook version (semantic versioning recommended)
	Version string `yaml:"version"`

	// Path is the relative path within the templates folder
	Path string `yaml:"path"`

	// Patterns are glob patterns for files to include (optional, defaults to all files)
	// If empty, all files in Path are included.
	Patterns []string `yaml:"patterns,omitempty"`

	// Structure describes the folder structure that this playbook creates
	// These are files/directories copied to the project root
	Structure []string `yaml:"structure,omitempty"`

	// Protected lists files that should not be overwritten during template updates
	// These are user-specific files that should be preserved
	Protected []string `yaml:"protected,omitempty"`

	// Mergeable lists files that should be merged (sentinel-based) instead of copied
	Mergeable []string `yaml:"mergeable,omitempty"`

	// PostScript is the path to a script to run after copying (e.g., "init.sh")
	// The script is executed from the embedded FS, not copied to the target
	PostScript string `yaml:"post_script,omitempty"`

	// Commands are AI commands to copy to .claude/commands/
	Commands []PlaybookItem `yaml:"commands,omitempty"`

	// Skills are AI skills to copy to .claude/skills/
	Skills []PlaybookItem `yaml:"skills,omitempty"`
}

type PlaybookItem struct {
	// Name is the identifier for this item
	Name string `yaml:"name"`

	// Path is the relative path within the playbook
	Path string `yaml:"path"`

	// Description explains what this item provides
	Description string `yaml:"description,omitempty"`
}

type PlaybookManifest struct {
	// Version is the manifest format version
	Version string

	// Playbooks is the list of available playbooks
	Playbooks []Playbook
}

type PlaybookSource interface {
	// List returns all available playbooks from this source.
	List() ([]Playbook, error)

	// Copy copies the specified playbook to the destination directory.
	// The name parameter must match a playbook name from List().
	// Options control the copy behavior (overwrite, skip, etc.).
	Copy(name string, destDir string, opts CopyOptions) (*CopyResult, error)

	// Exists checks if a playbook with the given name exists in this source.
	Exists(name string) bool
}

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