features

type BranchAction int

type CommitOptions struct {
	Message    string
	Author     string // Override author (optional)
	AutoLink   bool   // Auto-link changed files to primary feature
	AllowDirty bool   // Allow commit with uncommitted changes in .fogit/
}

type CommitResult struct {
	Hash            string
	Author          *object.Signature
	Branch          string
	Features        []*fogit.Feature
	PrimaryFeature  *fogit.Feature
	ChangedFiles    []string
	LinkedFiles     []string
	NothingToCommit bool
}

type CreateOptions struct {
	Name        string
	Description string
	Type        string
	Priority    string
	Category    string
	Domain      string
	Team        string
	Epic        string
	Module      string
	Tags        []string
	Metadata    map[string]interface{}
	ParentID    string

	// Git options
	SameBranch    bool
	IsolateBranch bool
	FromCurrent   bool // Override create_branch_from, create from current branch
}

type CrossBranchFeature struct {
	Feature  *fogit.Feature
	Branch   string
	IsRemote bool
}

type CrossBranchFindResult struct {
	Feature     *fogit.Feature
	Branch      string         // Branch where feature was found
	IsRemote    bool           // True if only found on remote
	Suggestions []search.Match // Fuzzy match suggestions if not found
}

type DeleteOptions struct {
	// SkipRelationshipCleanup skips cleaning up incoming relationships from other features
	SkipRelationshipCleanup bool
}

type DeleteResult struct {
	Feature                *fogit.Feature `json:"feature" yaml:"feature"`
	CleanedUpRelationships int            `json:"cleaned_up_relationships" yaml:"cleaned_up_relationships"`
}

type FeatureCountsByState struct {
	Open       int `json:"open"`
	InProgress int `json:"in_progress"`
	Closed     int `json:"closed"`
}

type FieldDiff struct {
	Field      string `json:"field" yaml:"field"`
	OldValue   string `json:"old_value" yaml:"old_value"`
	NewValue   string `json:"new_value" yaml:"new_value"`
	ChangeType string `json:"change_type" yaml:"change_type"` // "added", "removed", "modified"
}

type FindResult struct {
	Feature     *fogit.Feature
	Suggestions []search.Match
}

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

type ImpactOptions struct {
	MaxDepth          int      // Maximum traversal depth (0 = unlimited)
	IncludeCategories []string // Categories to include (empty = use config defaults)
	ExcludeCategories []string // Categories to exclude
	AllCategories     bool     // Include all categories regardless of config
}

type ImpactResult struct {
	Feature            string            `json:"feature" yaml:"feature"`
	ImpactedFeatures   []ImpactedFeature `json:"impacted_features" yaml:"impacted_features"`
	TotalAffected      int               `json:"total_affected" yaml:"total_affected"`
	CategoriesIncluded []string          `json:"categories_included" yaml:"categories_included"`
}

type ImpactedFeature struct {
	Name         string   `json:"name" yaml:"name"`
	ID           string   `json:"id" yaml:"id"`
	Relationship string   `json:"relationship" yaml:"relationship"`
	Depth        int      `json:"depth" yaml:"depth"`
	Path         []string `json:"path" yaml:"path"`
	Warning      string   `json:"warning,omitempty" yaml:"warning,omitempty"`
}

type IncomingRelationshipSummary struct {
	SourceID   string `json:"source_id" yaml:"source_id"`
	SourceName string `json:"source_name" yaml:"source_name"`
	Type       string `json:"type" yaml:"type"`
}

type LinkOptions struct {
	GitRepo      *git.Repository // Git repository for cross-branch operations (optional)
	SourceBranch string          // Branch where source feature exists (for saving primary relationship)
	TargetBranch string          // Branch where target feature exists (for inverse relationship)
}

type MergeOptions struct {
	FeatureName string // Specific feature to close (optional, empty = all on branch)
	NoDelete    bool   // Keep branch after merge
	Squash      bool   // Squash commits
	BaseBranch  string // Target branch to merge into (default: main)
	Continue    bool   // Continue after conflict resolution
	Abort       bool   // Abort the current merge
	FogitDir    string // Path to .fogit directory (required for state management)
}

type MergeResult struct {
	ClosedFeatures   []*fogit.Feature
	Branch           string // Original feature branch
	BaseBranch       string // Target branch merged into
	IsMainBranch     bool   // Was already on main (trunk-based)
	NoDelete         bool   // Keep branch flag
	BranchDeleted    bool   // Whether branch was deleted
	MergePerformed   bool   // Whether Git merge was performed
	ConflictDetected bool   // Whether merge had conflicts (needs resolution)
	Aborted          bool   // Whether merge was aborted
}

type MergeState struct {
	FeatureBranch string   `yaml:"feature_branch"`
	BaseBranch    string   `yaml:"base_branch"`
	FeatureIDs    []string `yaml:"feature_ids"`
	NoDelete      bool     `yaml:"no_delete"`
	Squash        bool     `yaml:"squash"`
	ConflictFiles []string `yaml:"conflict_files,omitempty"`
}

type RecentChange struct {
	FeatureName string    `json:"feature_name"`
	FeatureID   string    `json:"feature_id"`
	State       string    `json:"state"`
	ModifiedAt  time.Time `json:"modified_at"`
}

type RecursiveRelationship struct {
	SourceID   string   `json:"source_id" yaml:"source_id"`
	SourceName string   `json:"source_name" yaml:"source_name"`
	TargetID   string   `json:"target_id" yaml:"target_id"`
	TargetName string   `json:"target_name" yaml:"target_name"`
	Type       string   `json:"type" yaml:"type"`
	Depth      int      `json:"depth" yaml:"depth"`
	Path       []string `json:"path" yaml:"path"`
}

type RelationshipCategoryDeleteOptions struct {
	MoveTypesTo string // Move types to this category (empty = no move)
	Cascade     bool   // Delete category and all its types
	Force       bool   // Delete category only, types become uncategorized
}

type RelationshipCategoryDeleteResult struct {
	CategoryName    string
	AffectedTypes   []string
	MovedTypesCount int
	DeletedTypes    int
	DeletedRelCount int
	RequiresConfirm bool
	ConfirmMessage  string
}

type RelationshipCategoryInUseError struct {
	CategoryName  string
	AffectedTypes []string
}

type RelationshipCategoryUpdateOptions struct {
	NewName         string // Rename the category (empty = no rename)
	KeepOldAsAlias  bool   // Add old name as alias when renaming
	Description     string // New description
	SetDescription  bool   // Whether to set description
	AllowCycles     *bool  // Set allow cycles (nil = no change)
	CycleDetection  string // Cycle detection mode (empty = no change)
	IncludeInImpact *bool  // Include in impact analysis (nil = no change)
}

type RelationshipCategoryUpdateResult struct {
	Renamed        bool
	OldName        string
	NewName        string
	TypesUpdated   int
	KeptOldAsAlias bool
}

type RelationshipStatus struct {
	TotalRelationships int            `json:"total_relationships"`
	ByType             map[string]int `json:"by_type"`
	ByCategory         map[string]int `json:"by_category"`
}

type RelationshipTypeDeleteOptions struct {
	MigrateTo string // Migrate relationships to this type (empty = no migration)
	Cascade   bool   // Delete all relationships using this type
	Force     bool   // Delete type only, leave relationships orphaned
}

type RelationshipTypeDeleteResult struct {
	TypeName        string
	InverseType     string
	AffectedRels    []string // Human-readable list of affected relationships
	MigratedCount   int
	DeletedRelCount int
	RequiresConfirm bool
	ConfirmMessage  string
}

type RelationshipTypeInUseError struct {
	TypeName     string
	AffectedRels []string
}

type RelationshipTypeUpdateOptions struct {
	NewName        string   // Rename the type (empty = no rename)
	RenameInverse  string   // New name for inverse type (only when renaming)
	KeepOldAsAlias bool     // Add old name as alias when renaming
	Category       string   // New category (empty = no change)
	Inverse        string   // New inverse type (empty = no change)
	Description    string   // New description (empty = no change)
	SetDescription bool     // Whether to set description (allows empty string)
	Bidirectional  *bool    // Set bidirectional (nil = no change)
	AddAliases     []string // Aliases to add
	RemoveAliases  []string // Aliases to remove
}

type RelationshipTypeUpdateResult struct {
	Renamed         bool
	OldName         string
	NewName         string
	OldInverse      string
	NewInverse      string
	UpdatedRelCount int
	KeptOldAsAlias  bool
	InverseRenamed  bool
}

type RelationshipWithSource struct {
	SourceID   string
	SourceName string
	Relation   fogit.Relationship
}

type RepoStats struct {
	TotalFeatures   int
	ByState         map[fogit.State]int
	ByPriority      map[fogit.Priority]int
	ByType          map[string]int
	ByCategory      map[string]int
	ByDomain        map[string]int
	ByTeam          map[string]int
	ByEpic          map[string]int
	TotalTags       int
	UniqueTags      map[string]int
	TotalFiles      int
	AvgAge          time.Duration
	AvgRelations    float64
	TotalRelations  int
	ByRelationType  map[string]int // Count by relationship type
	ByRelationCat   map[string]int // Count by relationship category
	ImpactRelations int            // Count of relationships in categories with include_in_impact: true
}

type RepositoryStatus struct {
	Name          string `json:"name"`
	Version       string `json:"version"`
	TotalFeatures int    `json:"total_features"`
	TotalFiles    int    `json:"total_files"`
}

type StatusOptions struct {
	RecentChangeWindow time.Duration // How far back to look for recent changes
	RecentChangeLimit  int           // Maximum number of recent changes to include
}

type StatusReport struct {
	Repository        RepositoryStatus     `json:"repository"`
	CurrentBranch     string               `json:"current_branch"`
	FeatureCounts     FeatureCountsByState `json:"feature_counts"`
	RecentChanges     []RecentChange       `json:"recent_changes"`
	RelationshipStats RelationshipStatus   `json:"relationship_stats"`
	FeaturesOnBranch  []string             `json:"features_on_branch,omitempty"`
}

type SwitchOptions struct {
	Identifier string // Feature name, ID, or partial match
	FogitDir   string // Path to .fogit directory
}

type SwitchResult struct {
	Feature            *fogit.Feature
	PreviousBranch     string
	TargetBranch       string
	AlreadyOnBranch    bool
	IsTrunkBased       bool
	FoundOnOtherBranch string         // Non-empty if feature was found on a different branch
	Suggestions        []search.Match // Fuzzy match suggestions if not found
}

type TraversalOptions struct {
	Direction string   // "incoming", "outgoing", or "both"
	Types     []string // Relationship types to include (empty = all)
	MaxDepth  int      // Maximum traversal depth (0 = unlimited)
}

type TraversalResult struct {
	Feature       *fogit.Feature          `json:"feature" yaml:"feature"`
	Relationships []RecursiveRelationship `json:"relationships" yaml:"relationships"`
	MaxDepth      int                     `json:"max_depth" yaml:"max_depth"`
	Direction     string                  `json:"direction" yaml:"direction"`
	Types         []string                `json:"types,omitempty" yaml:"types,omitempty"`
	Total         int                     `json:"total" yaml:"total"`
}

type UpdateOptions struct {
	Name        *string
	Description *string
	State       *string
	Priority    *string
	Type        *string
	Category    *string
	Domain      *string
	Team        *string
	Epic        *string
	Module      *string
	Metadata    map[string]interface{}
}

type VersionDiff struct {
	FeatureID      string      `json:"feature_id" yaml:"feature_id"`
	FeatureName    string      `json:"feature_name" yaml:"feature_name"`
	Version1       string      `json:"version1" yaml:"version1"`
	Version2       string      `json:"version2" yaml:"version2"`
	Changes        []FieldDiff `json:"changes" yaml:"changes"`
	HasDifferences bool        `json:"has_differences" yaml:"has_differences"`
}