core

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

	// GeneratePowerDir creates a complete power directory structure.
	// Returns the paths of all created files.
	GeneratePowerDir(power *Power, outputDir string) ([]string, error)

	// ParsePowerDir reads a power directory and returns a canonical Power.
	ParsePowerDir(dir string) (*Power, error)
}

type GenerateError struct {
	Format  string
	Path    string
	Message string
	Err     error
}

type Hook struct {
	// Name is the hook identifier.
	Name string `json:"name" yaml:"name"`

	// Event is the trigger event (e.g., "pre-commit", "on-save").
	Event string `json:"event" yaml:"event"`

	// Command is the action to execute.
	Command string `json:"command,omitempty" yaml:"command,omitempty"`

	// Prompt is the AI prompt to execute.
	Prompt string `json:"prompt,omitempty" yaml:"prompt,omitempty"`

	// Condition determines when the hook runs.
	Condition string `json:"condition,omitempty" yaml:"condition,omitempty"`
}

type MCPServer struct {
	// Command is the executable to launch for stdio servers.
	Command string `json:"command,omitempty" yaml:"command,omitempty"`

	// Args are command-line arguments for the server.
	Args []string `json:"args,omitempty" yaml:"args,omitempty"`

	// Env contains environment variables for the server process.
	// Use ${VAR_NAME} syntax for user-provided values.
	Env map[string]string `json:"env,omitempty" yaml:"env,omitempty"`

	// URL is the endpoint for remote HTTP/SSE servers.
	URL string `json:"url,omitempty" yaml:"url,omitempty"`

	// Description explains what tools this server provides.
	Description string `json:"description,omitempty" yaml:"description,omitempty"`
}

type ParseError struct {
	Format string
	Path   string
	Err    error
}

type Power struct {
	// Name is the unique identifier for the power (e.g., "prdtool").
	Name string `json:"name" yaml:"name"`

	// DisplayName is the user-facing title (e.g., "PRD Tool").
	DisplayName string `json:"displayName,omitempty" yaml:"displayName,omitempty"`

	// Description explains what the power provides.
	Description string `json:"description,omitempty" yaml:"description,omitempty"`

	// Version is the semantic version (e.g., "1.0.0").
	Version string `json:"version,omitempty" yaml:"version,omitempty"`

	// Keywords trigger power activation when mentioned in conversation.
	// These should be developer-relevant terms (e.g., "database", "auth").
	Keywords []string `json:"keywords,omitempty" yaml:"keywords,omitempty"`

	// MCPServers defines the MCP server configurations for this power.
	MCPServers map[string]MCPServer `json:"mcpServers,omitempty" yaml:"mcpServers,omitempty"`

	// Onboarding contains setup instructions run when the power is first activated.
	// This can include dependency checks, configuration steps, and hook creation.
	Onboarding string `json:"onboarding,omitempty" yaml:"onboarding,omitempty"`

	// Instructions are the main steering content for the power.
	// For simple powers, this contains all guidance.
	Instructions string `json:"instructions,omitempty" yaml:"instructions,omitempty"`

	// SteeringFiles maps workflow names to steering file paths.
	// These are loaded conditionally based on the current task.
	SteeringFiles map[string]SteeringFile `json:"steeringFiles,omitempty" yaml:"steeringFiles,omitempty"`

	// Hooks defines automation triggers for IDE events.
	Hooks []Hook `json:"hooks,omitempty" yaml:"hooks,omitempty"`

	// Repository is the GitHub URL for distribution.
	Repository string `json:"repository,omitempty" yaml:"repository,omitempty"`

	// Author is the power creator.
	Author string `json:"author,omitempty" yaml:"author,omitempty"`

	// License specifies the distribution license.
	License string `json:"license,omitempty" yaml:"license,omitempty"`
}

type SteeringFile struct {
	// Path is the relative path to the steering file.
	Path string `json:"path" yaml:"path"`

	// Keywords trigger loading of this specific steering file.
	Keywords []string `json:"keywords,omitempty" yaml:"keywords,omitempty"`

	// Description explains when this steering file is used.
	Description string `json:"description,omitempty" yaml:"description,omitempty"`

	// Content is the inline steering content (alternative to Path).
	Content string `json:"content,omitempty" yaml:"content,omitempty"`
}

type ValidationError struct {
	Field   string
	Message string
}