core

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

	// EntryPointFile returns the entry point filename for this platform
	// (e.g., "CLAUDE.md" for Claude Code, "core-workflow.md" for Kiro steering)
	EntryPointFile() string

	// EntryPointDir returns the directory for the entry point
	// (e.g., "" for root, ".kiro/steering" for Kiro)
	EntryPointDir() string

	// RuleDetailsDir returns the directory for rule details
	// (e.g., ".spec-workflows" for Claude, ".kiro/spec-workflow-details" for Kiro)
	RuleDetailsDir() string

	// Generate creates platform-specific files from a Workflow
	Generate(workflow *Workflow, outputDir string) error

	// GenerateEntryPoint generates just the entry point file content
	GenerateEntryPoint(workflow *Workflow) ([]byte, error)
}

type AdapterNotFoundError struct {
	Name string
}

type GenerateConfig struct {
	// Workflow is the source workflow to generate from
	Workflow *Workflow

	// SourceRepo is the spec-workflows repository
	SourceRepo *SourceRepo

	// OutputDir is the target project directory
	OutputDir string

	// Platform is the target platform (e.g., "claude", "kiro")
	Platform string

	// Extension is an optional extension to include
	Extension string

	// CopyRuleDetails copies rule-details to output (vs symlink/reference)
	CopyRuleDetails bool

	// CopyTemplates copies templates to output
	CopyTemplates bool

	// CopyRubrics copies rubrics to output
	CopyRubrics bool
}

type GenerateError struct {
	Platform string
	Path     string
	Err      error
}

type LoadError struct {
	Path string
	Err  error
}

type NotFoundError struct {
	WorkflowID string
}

type ParseError struct {
	Path string
	Err  error
}

type Phase struct {
	// Name is the phase identifier
	Name string `json:"name" yaml:"name"`

	// SpecType is the spec type created in this phase
	SpecType string `json:"specType" yaml:"specType"`

	// Mode is the authoring mode: "interactive", "synthesis", or "reconciliation"
	Mode string `json:"mode" yaml:"mode"`

	// Sources are the spec types used as input (for synthesis mode)
	Sources []string `json:"sources,omitempty" yaml:"sources,omitempty"`

	// Gate indicates if approval is required before proceeding
	Gate bool `json:"gate,omitempty" yaml:"gate,omitempty"`
}

type SourceRepo struct {
	// Path is the local filesystem path to the repo
	Path string `json:"path" yaml:"path"`

	// Workflows maps workflow identifiers to Workflow definitions
	Workflows map[string]*Workflow `json:"workflows,omitempty" yaml:"workflows,omitempty"`
}

type Workflow struct {
	// Name is the workflow identifier (e.g., "aws-working-backwards")
	Name string `json:"name" yaml:"name"`

	// Level is the workflow level: "product" or "feature"
	Level string `json:"level" yaml:"level"`

	// Description describes the workflow purpose
	Description string `json:"description,omitempty" yaml:"description,omitempty"`

	// Trigger is the phrase that activates this workflow
	Trigger string `json:"trigger,omitempty" yaml:"trigger,omitempty"`

	// EntryPoint is the path to the core-workflow.md file
	EntryPoint string `json:"entryPoint" yaml:"entryPoint"`

	// RuleDetails is the path to the rule-details directory
	RuleDetails string `json:"ruleDetails,omitempty" yaml:"ruleDetails,omitempty"`

	// Templates is the path to the templates directory
	Templates string `json:"templates,omitempty" yaml:"templates,omitempty"`

	// Rubrics is the path to the rubrics directory
	Rubrics string `json:"rubrics,omitempty" yaml:"rubrics,omitempty"`

	// Phases defines the workflow phases in order
	Phases []Phase `json:"phases,omitempty" yaml:"phases,omitempty"`

	// Extension is an optional extension to apply
	Extension string `json:"extension,omitempty" yaml:"extension,omitempty"`
}

type WriteError struct {
	Path string
	Err  error
}