core

type Adapter interface {
	// Name returns the adapter identifier (e.g., "claude", "gemini").
	Name() string

	// DefaultPaths returns default file paths for this tool's plugin manifest.
	DefaultPaths() []string

	// Parse converts tool-specific bytes to canonical Plugin.
	Parse(data []byte) (*Plugin, error)

	// Marshal converts canonical Plugin to tool-specific bytes.
	Marshal(plugin *Plugin) ([]byte, error)

	// ReadFile reads from path and returns canonical Plugin.
	ReadFile(path string) (*Plugin, error)

	// WriteFile writes canonical Plugin to path.
	WriteFile(plugin *Plugin, path string) error

	// WritePlugin writes the complete plugin structure to the given directory.
	// This includes the manifest file and any referenced component directories.
	WritePlugin(plugin *Plugin, dir string) error
}

type Dependency struct {
	Name     string `json:"name"`
	Command  string `json:"command,omitempty"`  // CLI command to check availability
	Optional bool   `json:"optional,omitempty"` // If true, missing dependency is a warning
}

type MCPServer struct {
	Command string            `json:"command"`
	Args    []string          `json:"args,omitempty"`
	Cwd     string            `json:"cwd,omitempty"`
	Env     map[string]string `json:"env,omitempty"`
}

type MarshalError struct {
	Format string
	Err    error
}

type ParseError struct {
	Format string
	Path   string
	Err    error
}

type Plugin struct {
	// Metadata
	Name        string `json:"name"`
	Version     string `json:"version"`
	Description string `json:"description"`
	Author      string `json:"author,omitempty"`
	License     string `json:"license,omitempty"`
	Repository  string `json:"repository,omitempty"`
	Homepage    string `json:"homepage,omitempty"`

	// Components - paths to spec files
	Commands string `json:"commands,omitempty"` // Directory containing command specs
	Skills   string `json:"skills,omitempty"`   // Directory containing skill specs
	Agents   string `json:"agents,omitempty"`   // Directory containing agent specs
	Hooks    string `json:"hooks,omitempty"`    // Path to hooks spec file

	// Context file content
	Context string `json:"context,omitempty"` // System prompt / context content

	// Dependencies
	Dependencies []Dependency `json:"dependencies,omitempty"`

	// MCP Servers (used by Gemini extensions)
	MCPServers map[string]MCPServer `json:"mcp_servers,omitempty"`
}

type ReadError struct {
	Path string
	Err  error
}

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

type ValidationError struct {
	Field   string
	Message string
}

type WriteError struct {
	Path string
	Err  error
}