tracker

type Action int

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 Category string

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 CredResult struct {
	Spec      CredSpec
	Available map[string]string // suffix → value, for env vars that are set
	Missing   []string          // suffixes that are not set
	Complete  bool              // true if all required vars are set
}

type CredSpec struct {
	Kind      string   // "jira", "github", etc.
	EnvPrefix string   // "JIRA", "GITHUB", etc.
	Required  []string // env var suffixes: ["KEY", "USER"] for Jira, ["TOKEN"] for GitHub
	Label     string   // Human-readable name
	HelpURL   string   // Where to generate tokens
}

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

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

type DestructiveEntry struct {
	Timestamp string `json:"timestamp"`
	Operation string `json:"operation"`        // "DeleteIssue", "EditIssue", "TransitionIssue"
	Tracker   string `json:"tracker"`          // instance name
	Kind      string `json:"kind"`             // "jira", "linear", etc.
	Key       string `json:"key"`              // issue key
	Detail    string `json:"detail,omitempty"` // e.g. target status for transition, changed fields for edit
	Error     string `json:"error,omitempty"`
}

type DestructiveNotifier interface {
	NotifyDestructive(ctx context.Context, entry DestructiveEntry) // no error return -- fire-and-forget
}

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

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 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
	Role        string   // "pm", "engineering", or empty (inferred from kind)
	Safe        bool     // when true, destructive operations (deletes) are blocked
	Projects    []string // projects to index (e.g. ["KAN", "INFRA"])
	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"`
	StatusType  Category  `json:"status_type,omitempty"` // semantic bucket, see Category
	Priority    string    `json:"priority"`
	Assignee    string    `json:"assignee"`
	Reporter    string    `json:"reporter"`
	Description string    `json:"description"`          // markdown
	URL         string    `json:"url,omitempty"`        // web URL for opening in browser
	UpdatedAt   time.Time `json:"updated_at"`           // last modification timestamp
	ParentKey   string    `json:"parent_key,omitempty"` // parent issue key (subtask support)
	Labels      []string  `json:"labels,omitempty"`     // tags/labels on the issue
}

type ListOptions struct {
	Project      string
	MaxResults   int
	IncludeAll   bool      // when false, only open/active issues are returned
	UpdatedSince time.Time // when non-zero, only return issues updated after this time
}

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

type ParsedURL struct {
	Kind    string // "jira", "github", "gitlab", "linear", "azuredevops", "shortcut"
	BaseURL string // API-compatible base URL (e.g., "https://amazingcto.atlassian.net")
	Key     string // issue key in CLI format (e.g., "HUM-4", "owner/repo#42")
	Org     string // Azure DevOps org or Shortcut org slug
}

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

type PolicyConfig struct {
	Block   []string `mapstructure:"block"`
	Confirm []string `mapstructure:"confirm"`
}

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

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"`
	Category Category `json:"type,omitempty"` // JSON key stays "type" for wire compatibility
}

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

type TrackerStatus struct {
	Name     string   // config entry name, e.g. "work", "amazingcto"
	Kind     string   // tracker kind, e.g. "linear", "jira"
	Label    string   // human-readable name, e.g. "Linear", "Jira"
	Working  bool     // true when all required credentials are present (and not vault refs)
	VaultRef bool     // true when credentials are vault references (e.g. 1pw://) — unverified
	Missing  []string // env var names for missing credentials (empty when Working)
}

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