tracker

type Assigner interface {
	AssignIssue(ctx context.Context, key string, userID string) error
}

type AuditEntry struct {
	Timestamp  string `json:"timestamp"`
	Operation  string `json:"operation"`
	Tracker    string `json:"tracker"`
	Kind       string `json:"kind"`
	Key        string `json:"key"`
	DurationMs int64  `json:"duration_ms"`
	Error      string `json:"error,omitempty"`
}

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

type Comment struct {
	ID      string
	Author  string
	Body    string // markdown
	Created time.Time
}

type Commenter interface {
	ListComments(ctx context.Context, issueKey string) ([]Comment, error)
	AddComment(ctx context.Context, issueKey string, body string) (*Comment, error)
}

type Creator interface {
	CreateIssue(ctx context.Context, issue *Issue) (*Issue, error)
}

type CurrentUserGetter interface {
	GetCurrentUser(ctx context.Context) (string, error)
}

type Deleter interface {
	DeleteIssue(ctx context.Context, key string) error
}

type EditOptions struct {
	Title       *string
	Description *string
}

type Editor interface {
	EditIssue(ctx context.Context, key string, opts EditOptions) (*Issue, error)
}

type FindResult struct {
	Provider string `json:"provider"`
	Project  string `json:"project"`
	Key      string `json:"key"`
}

type Getter interface {
	GetIssue(ctx context.Context, key string) (*Issue, error)
}

type HTTPDoer interface {
	Do(req *http.Request) (*http.Response, error)
}

type Instance struct {
	Name        string // config entry name ("work", "personal"), empty for CLI-flag instances
	Kind        string // "jira", "github", "linear"
	URL         string // display URL
	User        string // display user (Jira only)
	Description string // optional human-readable description of what this tracker is for
	Safe        bool   // when true, destructive operations (deletes) are blocked
	Provider    Provider
}

type Issue struct {
	Key         string `json:"key"`
	Project     string `json:"project"` // project key, e.g. "KAN"
	Type        string `json:"type"`    // issue type, e.g. "Task", "Bug"
	Title       string `json:"title"`
	Status      string `json:"status"`
	Priority    string `json:"priority"`
	Assignee    string `json:"assignee"`
	Reporter    string `json:"reporter"`
	Description string `json:"description"` // markdown
}

type ListOptions struct {
	Project    string
	MaxResults int
	IncludeAll bool // when false, only open/active issues are returned
}

type Lister interface {
	ListIssues(ctx context.Context, opts ListOptions) ([]Issue, error)
}

type Provider interface {
	Lister
	Getter
	Creator
	Commenter
	Deleter
	Transitioner
	Assigner
	CurrentUserGetter
	Editor
	StatusLister
}

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

type Status struct {
	Name string `json:"name"`
	Type string `json:"type,omitempty"` // "unstarted", "started", "done", "closed", or ""
}

type StatusLister interface {
	ListStatuses(ctx context.Context, key string) ([]Status, error)
}

type Transitioner interface {
	TransitionIssue(ctx context.Context, key string, targetStatus string) error
}