issue

type AssignOptions struct {
	Factory  *factory.Factory
	KeyOrID  string // positional arg: issue key
	UserArg  string // positional arg: user (display name, account ID, or @me)
	Unassign bool   // --unassign
}

type CreateOptions struct {
	Factory *factory.Factory

	Project     string   // --project (or default.project config)
	Type        string   // --type
	Summary     string   // --summary
	Description string   // --description (Markdown)
	BodyFile    string   // --body-file (file path or "-" for stdin)
	Assignee    string   // --assignee
	Priority    string   // --priority
	Labels      []string // --labels
	Parent      string   // --parent
	Fields      []string // --field (repeatable, key=value)
}

type DeleteOptions struct {
	Factory *factory.Factory
	KeyOrID string // positional arg: issue key
	Yes     bool   // --yes/-y confirmation flag
}

type EditOptions struct {
	Factory *factory.Factory

	KeyOrID      string   // positional arg
	Summary      string   // --summary
	Description  string   // --description (Markdown)
	BodyFile     string   // --body-file
	Assignee     string   // --assignee
	Priority     string   // --priority
	Parent       string   // --parent (set-only; removal not supported)
	Labels       []string // --labels (replaces all)
	AddLabels    []string // --add-labels (delta add)
	RemoveLabels []string // --remove-labels (delta remove)
	Fields       []string // --field (repeatable, key=value)
	// contains filtered or unexported fields
}

type ExportOptions struct {
	Factory *factory.Factory

	Project      string // --project (falls back to default.project)
	JQL          string // --jql (overrides --project)
	OutputDir    string // --output-dir (default ".")
	Limit        int    // --limit (0 = all)
	Tree         bool   // --tree (hierarchical layout)
	NoProjectDir bool   // --no-project-dir (skip project directory in output path)
	Fields       string // --fields (comma-separated custom field names)
}

type ImportOptions struct {
	Factory *factory.Factory

	Files []string // positional args: file paths
	Dir   string   // --dir: import all .md files from directory
	Force bool     // --force: overwrite on conflict
	Map   string   // --map: jira-sync.yaml field-map for hub-style frontmatter
}

type ListOptions struct {
	Factory *factory.Factory

	Project  string   // --project (falls back to default.project)
	Assignee string   // --assignee (@me supported)
	Status   string   // --status
	Type     string   // --type
	Label    string   // --label
	Sprint   string   // --sprint (active, future, or sprint name)
	JQL      string   // --jql (overrides all filter flags)
	Sort     string   // --sort (field name for ORDER BY)
	Order    string   // --order (asc/desc, default: desc)
	Fields   []string // --fields (controls returned/displayed fields)
	Limit    int      // --limit
	Offset   int      // --offset
	NoPager  bool     // --no-pager
}

type MoveOptions struct {
	Factory      *factory.Factory
	KeyOrID      string // positional arg: issue key
	TargetStatus string // positional arg: target status name
	Resolution   string // --resolution (e.g., "Fixed", "Won't Fix")
	Comment      string // --comment (Markdown → ADF)
}

type PullOptions struct {
	Factory *factory.Factory
	Files   []string
	Dir     string
	Map     string
}

type ReconcileOptions struct {
	Factory *factory.Factory

	Dir          string // --dir: markdown directory
	Epic         string // --epic: scope to children of this epic
	Project      string // --project: scope to all issues in project
	JQL          string // --jql: raw JQL query (overrides --epic and --project)
	Action       string // --action: list, close, delete
	TargetStatus string // --target-status: status for close action
	Yes          bool   // --yes: skip confirmation
	Map          string // --map: read jira_key from hub-style frontmatter
}

type TransitionsOptions struct {
	Factory *factory.Factory
	KeyOrID string // positional arg: issue key
}

type ViewOptions struct {
	Factory *factory.Factory
	KeyOrID string
	Fields  []string // --fields filter
	NoPager bool     // --no-pager

	Comments bool // --comments
	Web      bool // --web

	// BrowserOpen is the function used to open a URL in the browser.
	// Defaults to browser.OpenURL; overridden in tests.
	BrowserOpen func(string) error
}