models

type BuildProgress struct {
	Type     BuildProgressType
	Platform string // e.g., "linux/amd64", "windows/arm64"
	Asset    string // e.g., "matecommit_version_linux_x86_64.tar.gz"
	Current  int    // Current item being processed
	Total    int    // Total items to process
	Error    error  // Error if Type is BuildProgressError
}

type BuildProgressType string

type ChangeSeverity string

type CodeAnalysis struct {
	ChangesOverview string
	PrimaryPurpose  string
	TechnicalImpact string
}

type CodeExample struct {
	Title       string // Example title
	Description string // Short description
	Code        string // Example code
	Language    string // Language (bash, go, etc.)
}

type Commit struct {
	Hash    string
	Author  string
	Email   string
	Date    string
	Message string
}

type CommitInfo struct {
	Files         []string
	Diff          string
	TicketInfo    *TicketInfo
	IssueInfo     *Issue
	RecentHistory string
}

type CommitSuggestion struct {
	CommitTitle          string
	Explanation          string
	Files                []string
	CodeAnalysis         CodeAnalysis
	RequirementsAnalysis RequirementsAnalysis
	Usage                *TokenUsage
}

type Comparison struct {
	Feature string // Feature name
	Before  string // Previous state
	After   string // New state
}

type CriteriaStatus string

type DependencyChange struct {
	Name       string               // Package name (e.g.: "github.com/user/repo", "react")
	OldVersion string               // Previous version (empty if Type == DependencyAdded)
	NewVersion string               // New version (empty if Type == DependencyRemoved)
	Type       DependencyChangeType // Change type
	Manager    string               // Manager: "go.mod", "package.json", "Cargo.toml", etc.
	Severity   ChangeSeverity       // Severity: major/minor/patch to detect breaking changes
	IsDirect   bool                 // true = direct dependency, false = dev/indirect
}

type DependencyChangeType string

type DiffAnalysis struct {
	// HasGoFiles indicates if the diff includes .go files
	HasGoFiles bool

	// HasTestFiles indicates if the diff includes test files
	HasTestFiles bool

	// HasDocFiles indicates if the diff includes documentation files
	HasDocFiles bool

	// HasConfigFiles indicates if the diff includes configuration files
	HasConfigFiles bool

	// HasUIFiles indicates if the diff includes UI files (CSS, HTML, JSX, etc)
	HasUIFiles bool

	// Keywords contains keywords found in the diff (fix, feat, refactor, etc)
	Keywords map[string]bool
}

type FileChange struct {
	Path      string
	Additions int
	Deletions int
}

type FileStatistics struct {
	FilesChanged int
	Insertions   int
	Deletions    int
	TopFiles     []FileChange
}

type FormAttributes struct {
	Label       string   `yaml:"label"`
	Description string   `yaml:"description,omitempty"`
	Placeholder string   `yaml:"placeholder,omitempty"`
	Value       string   `yaml:"value,omitempty"`   // For 'markdown' type elements
	Options     []string `yaml:"options,omitempty"` // For dropdowns
	Multiple    bool     `yaml:"multiple,omitempty"`
}

type FormValidations struct {
	Required bool `yaml:"required,omitempty"`
}

type GitChange struct {
	Path   string
	Status string
}

type Issue struct {
	ID          int
	Number      int
	Title       string
	Description string
	State       string
	Labels      []string
	Author      string
	URL         string
	Criteria    []string
}

type IssueFormItem struct {
	Type        string          `yaml:"type"`
	ID          string          `yaml:"id,omitempty"`
	Attributes  FormAttributes  `yaml:"attributes,omitempty"`
	Validations FormValidations `yaml:"validations,omitempty"`
}

type IssueGenerationRequest struct {
	// Description is the manual description provided by the user (optional)
	Description string

	// Diff contains local git changes (optional)
	Diff string

	// ChangedFiles is the list of modified files (optional)
	ChangedFiles []string

	// Hint is additional context provided by the user to guide generation (optional)
	Hint string

	// Language is the language for content generation (e.g.: "es", "en")
	Language string

	// Template is the project's issue template to guide generation (optional)
	Template *IssueTemplate

	// AvailableLabels is the list of labels available in the repository (optional)
	AvailableLabels []string
}

type IssueGenerationResult struct {
	// Title is the generated title for the issue
	Title string

	// Description is the full generated description for the issue
	Description string

	// Labels are the suggested labels for the issue
	Labels []string

	// Assignees are the suggested assignees for the issue
	Assignees []string

	// Usage contains metadata on token usage by the AI
	Usage *TokenUsage
}

type IssueTemplate struct {
	// YAML frontmatter metadata
	Name        string   `yaml:"name"`
	About       string   `yaml:"about,omitempty"`
	Description string   `yaml:"description,omitempty"`
	Title       string   `yaml:"title"`
	Labels      []string `yaml:"labels"`
	Assignees   []string `yaml:"assignees,omitempty"`

	// Template content
	// For .md: Markdown string
	// For .yml (GitHub Issue Forms): strict typed list of form items
	Body        []IssueFormItem `yaml:"body,omitempty"`
	BodyContent string          `yaml:"-"` // For backward compatibility with .md

	// Path to the template file
	FilePath string `yaml:"-"`
}

type PRData struct {
	ID            int
	Title         string
	Creator       string
	Commits       []Commit
	Diff          string
	BranchName    string
	RelatedIssues []Issue
	Description   string
	Labels        []string
}

type PRSummary struct {
	Title  string
	Body   string
	Labels []string
	Usage  *TokenUsage
}

type ProgressData struct {
	Issues   []string
	PRNumber int
	Count    int
	Title    string
	Number   int
	IsAuto   bool
	Error    string
}

type ProgressEvent struct {
	Type    ProgressEventType
	Message string
	Data    *ProgressData
}

type ProgressEventType string

type PullRequest struct {
	Number      int
	Title       string
	Description string
	Author      string
	Labels      []string
	URL         string
}

type Release struct {
	Version         string
	PreviousVersion string
	Title           string
	Summary         string
	Date            time.Time
	Features        []ReleaseItem
	BugFixes        []ReleaseItem
	Breaking        []ReleaseItem
	Documentation   []ReleaseItem
	Improvements    []ReleaseItem
	Other           []ReleaseItem
	AllCommits      []Commit
	VersionBump     VersionBump
	ClosedIssues    []Issue
	MergedPRs       []PullRequest
	Contributors    []string
	NewContributors []string
	Dependencies    []DependencyChange
	FileStats       FileStatistics
}

type ReleaseItem struct {
	Type        string // feat, fix, docs, etc
	Scope       string
	Description string
	Breaking    bool
	CommitHash  string
	PRNumber    string // if it has an associated PR
}

type ReleaseNotes struct {
	Title           string
	Summary         string
	Highlights      []string
	Sections        []ReleaseNotesSection
	Changelog       string
	Recommended     VersionBump
	QuickStart      string
	Examples        []CodeExample
	BreakingChanges []string
	Comparisons     []Comparison
	Links           map[string]string
	Usage           *TokenUsage
}

type ReleaseNotesSection struct {
	Title string
	Items []string
}

type RequirementsAnalysis struct {
	CriteriaStatus         CriteriaStatus
	MissingCriteria        []string
	CompletedIndices       []int
	ImprovementSuggestions []string
}

type TemplateMetadata struct {
	Name     string
	About    string
	FilePath string
}

type TicketInfo struct {
	TicketID    string   `json:"ticket_id"`
	TicketTitle string   `json:"ticket_title"`
	TitleDesc   string   `json:"title_desc"`
	Criteria    []string `json:"criteria"`
}

type TokenUsage struct {
	InputTokens  int     `json:"input_tokens"`
	OutputTokens int     `json:"output_tokens"`
	TotalTokens  int     `json:"total_tokens"`
	CostUSD      float64 `json:"cost_usd,omitempty"`
	Model        string  `json:"model,omitempty"`
	CacheHit     bool    `json:"cache_hit,omitempty"`
	DurationMs   int64   `json:"duration_ms,omitempty"`
}

type VCSRelease struct {
	TagName string
	Name    string
	Body    string
	Draft   bool
	URL     string
}

type VersionBump string