types

type BlockedIssue struct {
	Issue
	BlockedByCount int      `json:"blocked_by_count"`
	BlockedBy      []string `json:"blocked_by"`
}

type Comment struct {
	ID          int64       `json:"id"`
	IssueID     string      `json:"issue_id"`
	Author      string      `json:"author"`
	Text        string      `json:"text"`
	CommentType CommentType `json:"comment_type"`
	CreatedAt   time.Time   `json:"created_at"`
	UpdatedAt   time.Time   `json:"updated_at"`
}

type CommentType string

type Dependency struct {
	IssueID     string         `json:"issue_id"`
	DependsOnID string         `json:"depends_on_id"`
	Type        DependencyType `json:"type"`
	CreatedAt   time.Time      `json:"created_at"`
	CreatedBy   string         `json:"created_by,omitempty"`
}

type DependencyType string

type Event struct {
	ID        int64     `json:"id"`
	IssueID   string    `json:"issue_id"`
	EventType EventType `json:"event_type"`
	Actor     string    `json:"actor"`
	OldValue  *string   `json:"old_value,omitempty"`
	NewValue  *string   `json:"new_value,omitempty"`
	Comment   *string   `json:"comment,omitempty"`
	CreatedAt time.Time `json:"created_at"`
}

type EventType string

type Issue struct {
	// Core Identification
	ID          string `json:"id"`
	WorkspaceID string `json:"workspace_id"`
	ParentID    string `json:"parent_id,omitempty"` // For hierarchical child IDs (e.g., parent-id.1)

	// Issue Content
	Title       string `json:"title"`
	Description string `json:"description,omitempty"`

	// Status & Workflow
	Status    Status    `json:"status"`
	Priority  int       `json:"priority"` // 0 (critical) - 4 (backlog)
	Rank      int       `json:"rank"`     // 0 = unranked (sorts last), 1+ = lower rank = work on first
	IssueType IssueType `json:"issue_type"`

	// Assignment
	Assignee string `json:"assignee,omitempty"`

	// Timestamps
	CreatedAt   time.Time  `json:"created_at"`
	UpdatedAt   time.Time  `json:"updated_at"`
	ClosedAt    *time.Time `json:"closed_at,omitempty"`
	CloseReason string     `json:"close_reason,omitempty"`

	// External Integration
	ExternalRef string `json:"external_ref,omitempty"` // e.g., "gh-9", "jira-ABC"

	// Relational Data (populated for detail views)
	Labels       []string      `json:"labels,omitempty"`
	Dependencies []*Dependency `json:"dependencies,omitempty"`
	Comments     []*Comment    `json:"comments,omitempty"`
}

type IssueDetails struct {
	Issue
	Labels       []string      `json:"labels,omitempty"`
	Dependencies []*Dependency `json:"dependencies,omitempty"`
	Dependents   []*Dependency `json:"dependents,omitempty"`
	Comments     []*Comment    `json:"comments,omitempty"`
	PlanContext  *PlanContext  `json:"plan_context,omitempty"`
}

type IssueFilter struct {
	WorkspaceID string     // Required: filter by workspace
	Status      *Status    // Filter by status
	Priority    *int       // Filter by priority
	IssueType   *IssueType // Filter by issue type
	Assignee    *string    // Filter by assignee
	Labels      []string   // AND semantics: issue must have ALL these labels
	ParentID    string     // Filter by parent issue (via parent-child dependency)
	Query       string     // Full-text search in title/description
	IDs         []string   // Filter by specific issue IDs
	Limit       int        // Maximum results to return
	Offset      int        // Pagination offset
}

type IssueType string

type Label struct {
	Name        string `json:"name"`
	Color       string `json:"color,omitempty"`
	Description string `json:"description,omitempty"`
}

type OpenChildrenError struct {
	IssueID  string  // The issue that cannot be closed
	Children []Issue // The open child issues
}

type Plan struct {
	ID          string    `json:"id"` // plan.xxxxx format
	WorkspaceID string    `json:"workspace_id"`
	Title       string    `json:"title"`
	Content     string    `json:"content"`
	CreatedAt   time.Time `json:"created_at"`
	UpdatedAt   time.Time `json:"updated_at"`
	// LinkedIssues contains issue IDs linked to this plan (populated on detail views)
	LinkedIssues []string `json:"linked_issues,omitempty"`
}

type PlanContext struct {
	// InlinePlan is a plan comment directly on this issue
	InlinePlan *Comment `json:"inline_plan,omitempty"`
	// ParentPlan is a plan inherited from a parent issue
	ParentPlan *Comment `json:"parent_plan,omitempty"`
	// ParentIssueID is the ID of the parent issue if ParentPlan is set
	ParentIssueID string `json:"parent_issue_id,omitempty"`
	// SharedPlans are standalone plans linked to this issue
	SharedPlans []*Plan `json:"shared_plans,omitempty"`
}

type SortPolicy string

type Statistics struct {
	WorkspaceID      string  `json:"workspace_id"`
	TotalIssues      int     `json:"total_issues"`
	OpenIssues       int     `json:"open_issues"`
	InProgressIssues int     `json:"in_progress_issues"`
	ClosedIssues     int     `json:"closed_issues"`
	BlockedIssues    int     `json:"blocked_issues"`
	DeferredIssues   int     `json:"deferred_issues"`
	ReadyIssues      int     `json:"ready_issues"`
	AvgLeadTimeHours float64 `json:"avg_lead_time_hours,omitempty"`
}

type Status string

type WorkFilter struct {
	WorkspaceID string     // Required: filter by workspace
	Status      *Status    // Filter by status
	IssueType   *IssueType // Filter by issue type
	Priority    *int       // Filter by priority
	Assignee    *string    // Filter by assignee
	Unassigned  bool       // Filter for unassigned issues
	Labels      []string   // AND semantics
	SortPolicy  SortPolicy // Sort policy: hybrid (default), priority, oldest
	Limit       int        // Maximum results
}

type Workspace struct {
	ID          string    `json:"id"`             // Short hash ID (e.g., "ws-a1b2")
	Name        string    `json:"name"`           // Display name
	Path        string    `json:"path,omitempty"` // Optional: associated directory path
	Description string    `json:"description,omitempty"`
	Prefix      string    `json:"prefix"` // Issue ID prefix (e.g., "bd")
	CreatedAt   time.Time `json:"created_at"`
	UpdatedAt   time.Time `json:"updated_at"`
}