core

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

	// FileExtension returns the file extension for this format (e.g., ".md", ".toml").
	FileExtension() string

	// DefaultDir returns the default directory name for commands.
	DefaultDir() string

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

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

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

	// WriteFile writes canonical Command to path.
	WriteFile(cmd *Command, path string) error
}

type Argument struct {
	Name        string `json:"name"`
	Type        string `json:"type"`                  // string, number, boolean
	Required    bool   `json:"required,omitempty"`    // If true, argument is required
	Default     string `json:"default,omitempty"`     // Default value
	Pattern     string `json:"pattern,omitempty"`     // Regex validation pattern
	Hint        string `json:"hint,omitempty"`        // User-facing hint
	Description string `json:"description,omitempty"` // Detailed description
}

type Command struct {
	// Metadata
	Name        string `json:"name"`
	Description string `json:"description"`

	// Arguments
	Arguments []Argument `json:"arguments,omitempty"`

	// Content
	Instructions string `json:"instructions"` // The prompt/instructions content

	// Process steps (for documentation)
	Process []string `json:"process,omitempty"`

	// Dependencies required to run this command
	Dependencies []string `json:"dependencies,omitempty"`

	// Examples of usage
	Examples []Example `json:"examples,omitempty"`
}

type Example struct {
	Description string `json:"description,omitempty"`
	Input       string `json:"input"`
	Output      string `json:"output,omitempty"`
}

type MarshalError struct {
	Format string
	Err    error
}

type ParseError struct {
	Format string
	Path   string
	Err    error
}

type ReadError struct {
	Path string
	Err  error
}

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

type WriteError struct {
	Path string
	Err  error
}