setup

type Agent struct {
	Name           string
	DisplayName    string
	ProjectRootDir string
	GlobalRootDir  string
	Universal      bool
	Detected       bool
}

type AssetOrigin string

type AssetRef struct {
	Origin          AssetOrigin
	Name            string
	ExtensionName   string
	ExtensionSource string
	ManifestPath    string
	ResolvedPath    string
}

type CatalogAssetKind string

type CatalogConflict struct {
	Kind       CatalogAssetKind
	Name       string
	Resolution CatalogConflictResolution
	Winner     AssetRef
	Ignored    AssetRef
}

type CatalogConflictResolution string

type EffectiveCatalog struct {
	Skills         []Skill
	ReusableAgents []ReusableAgent
	Conflicts      []CatalogConflict
}

type ExtensionFailureItem struct {
	Pack SkillPackSource
	FailureItem
}

type ExtensionInstallConfig struct {
	ResolverOptions

	Packs      []SkillPackSource
	AgentNames []string
	Global     bool
	Mode       InstallMode
}

type ExtensionPreviewItem struct {
	Pack SkillPackSource
	PreviewItem
}

type ExtensionResult struct {
	Global     bool
	Mode       InstallMode
	Successful []ExtensionSuccessItem
	Failed     []ExtensionFailureItem
}

type ExtensionReusableAgentSource struct {
	ExtensionName   string
	ExtensionSource string
	ManifestPath    string
	Pattern         string
	ResolvedPath    string
	SourceFS        fs.FS
	SourceDir       string
}

type ExtensionSuccessItem struct {
	Pack SkillPackSource
	SuccessItem
}

type ExtensionVerifiedSkill struct {
	Pack SkillPackSource
	VerifiedSkill
}

type ExtensionVerifyConfig struct {
	ResolverOptions

	Packs     []SkillPackSource
	AgentName string
	ScopeHint InstallScope
}

type ExtensionVerifyResult struct {
	Agent  Agent
	Scope  InstallScope
	Mode   InstallMode
	Skills []ExtensionVerifiedSkill
}

type FailureItem struct {
	Skill Skill
	Agent Agent
	Path  string
	Mode  InstallMode
	Error string
}

type InstallConfig struct {
	Bundle fs.FS

	ResolverOptions

	SkillNames []string
	AgentNames []string
	Global     bool
	Mode       InstallMode
}

type InstallMode string

type InstallScope string

type PreviewItem struct {
	Skill         Skill
	Agent         Agent
	CanonicalPath string
	TargetPath    string
	WillOverwrite bool
}

type ResolverOptions struct {
	CWD             string
	HomeDir         string
	XDGConfigHome   string
	CodeXHome       string
	ClaudeConfigDir string
}

type Result struct {
	Global     bool
	Mode       InstallMode
	Successful []SuccessItem
	Failed     []FailureItem

	ReusableAgentsSuccessful []ReusableAgentSuccessItem
	ReusableAgentsFailed     []ReusableAgentFailureItem
}

type ReusableAgent struct {
	Name        string
	Title       string
	Description string
	Directory   string
	Origin      AssetOrigin

	ExtensionName   string
	ExtensionSource string
	ManifestPath    string
	ResolvedPath    string
	SourceFS        fs.FS
	SourceDir       string
}

type ReusableAgentFailureItem struct {
	ReusableAgent ReusableAgent
	Path          string
	Error         string
}

type ReusableAgentInstallConfig struct {
	ResolverOptions

	ReusableAgents []ReusableAgent
	Global         bool
}

type ReusableAgentPreviewItem struct {
	ReusableAgent ReusableAgent
	TargetPath    string
	WillOverwrite bool
}

type ReusableAgentSuccessItem struct {
	ReusableAgent ReusableAgent
	Path          string
}

type ReusableAgentVerifyConfig struct {
	ResolverOptions

	ReusableAgents []ReusableAgent
	ScopeHint      InstallScope
}

type ReusableAgentVerifyResult struct {
	Scope  InstallScope
	Agents []VerifiedReusableAgent
}

type Skill struct {
	Name        string
	Description string
	Directory   string
	Origin      AssetOrigin

	ExtensionName   string
	ExtensionSource string
	ManifestPath    string
	ResolvedPath    string
	SourceFS        fs.FS
	SourceDir       string
}

type SkillDrift struct {
	MissingFiles []string
	ExtraFiles   []string
	ChangedFiles []string
	Reason       string
}

type SkillPackSource struct {
	ExtensionName   string
	ExtensionSource string
	ManifestPath    string
	Pattern         string
	ResolvedPath    string
	SourceFS        fs.FS
	SourceDir       string
}

type SkillsCatalogEntry struct {
	Name        string      `json:"name"`
	Description string      `json:"description,omitempty"`
	Directory   string      `json:"directory"`
	Tier        string      `json:"tier"`
	Origin      AssetOrigin `json:"origin"`
}

type SuccessItem struct {
	Skill         Skill
	Agent         Agent
	Path          string
	CanonicalPath string
	Mode          InstallMode
	SymlinkFailed bool
}

type VerifiedReusableAgent struct {
	ReusableAgent ReusableAgent
	TargetPath    string
	ResolvedPath  string
	State         VerifyState
	Drift         SkillDrift
}

type VerifiedSkill struct {
	Skill         Skill
	CanonicalPath string
	TargetPath    string
	ResolvedPath  string
	State         VerifyState
	Drift         SkillDrift
}

type VerifyConfig struct {
	Bundle fs.FS

	ResolverOptions

	AgentName  string
	SkillNames []string
}

type VerifyResult struct {
	Agent  Agent
	Scope  InstallScope
	Mode   InstallMode
	Skills []VerifiedSkill
}

type VerifyState string