core

type Capability struct {
	// Metadata
	Name        string `json:"name"`        // Unique identifier (e.g., "golangci-lint")
	Description string `json:"description"` // Brief description

	// Content
	Instructions string `json:"instructions"` // Full instructions/prompt for the capability

	// Execution
	Command     string   `json:"command,omitempty"`      // CLI command to execute
	CommandArgs []string `json:"command_args,omitempty"` // Default command arguments

	// Triggers (for skill invocation)
	Triggers []string `json:"triggers,omitempty"` // Keywords that invoke this capability

	// Dependencies
	Dependencies []string `json:"dependencies,omitempty"` // Required CLI tools

	// Error Handling Guidance
	ErrorHandling *ErrorHandlingGuide `json:"error_handling,omitempty"` // How to handle errors

	// Common Fixes
	CommonFixes []CommonFix `json:"common_fixes,omitempty"` // Known issues and fixes

	// Language/Platform
	Language string `json:"language,omitempty"` // Target language (e.g., "go", "typescript")
	Platform string `json:"platform,omitempty"` // Target platform (e.g., "all", "darwin")

	// Validation
	Required        bool   `json:"required"`                    // If true, failure blocks release
	SuccessPattern  string `json:"success_pattern,omitempty"`   // Regex pattern indicating success
	FailurePattern  string `json:"failure_pattern,omitempty"`   // Regex pattern indicating failure
	ExitCodeSuccess []int  `json:"exit_code_success,omitempty"` // Exit codes indicating success (default: [0])
}

type CapabilitySet struct {
	Name         string        `json:"name"`
	Description  string        `json:"description"`
	Language     string        `json:"language,omitempty"`
	Capabilities []*Capability `json:"capabilities"`
}

type CommonFix struct {
	Issue       string `json:"issue"`       // Lint rule or error pattern (e.g., "G306", "errcheck")
	Description string `json:"description"` // What the issue is
	Before      string `json:"before"`      // Code before fix
	After       string `json:"after"`       // Code after fix
}

type ErrorHandlingGuide struct {
	// Priority order for handling errors
	Priorities []ErrorPriority `json:"priorities"`

	// Reference packages for error handling
	References []PackageReference `json:"references,omitempty"`
}

type ErrorPriority struct {
	Level       int    `json:"level"`       // Priority level (1 = highest)
	Name        string `json:"name"`        // Priority name (e.g., "Panic", "Return Error")
	Description string `json:"description"` // When to use this priority
	Example     string `json:"example"`     // Code example
}

type PackageReference struct {
	Package     string `json:"package"`     // Import path
	Description string `json:"description"` // What this package provides
	Usage       string `json:"usage"`       // Example usage
}