do-next 0.0.0-2026.3.19

Pick your next Jira task & manage it from the terminal
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139

use serde::{Deserialize, Serialize};
use std::collections::HashMap;

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct Issue {
    pub id: String,
    pub key: String,
    pub fields: IssueFields,
    /// Which source this issue was fetched from (set after fetch).
    #[serde(skip)]
    pub source_id: Option<String>,
    /// Within-source subsource index for ordering (set after fetch).
    #[serde(skip)]
    pub subsource_idx: usize,
}

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct IssueFields {
    pub summary: String,
    pub status: StatusField,
    pub priority: Option<PriorityField>,
    pub assignee: Option<UserField>,
    pub reporter: Option<UserField>,
    pub issuetype: IssueTypeField,
    pub project: ProjectField,
    pub description: Option<serde_json::Value>,
    pub comment: Option<CommentList>,
    /// All custom fields, keyed by field ID.
    #[serde(flatten)]
    pub extra: HashMap<String, serde_json::Value>,
}

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct StatusField {
    pub id: String,
    pub name: String,
}

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct PriorityField {
    pub id: String,
    pub name: String,
}

impl PriorityField {
    /// Single-char symbol for the priority level.
    pub fn symbol(&self) -> &'static str {
        match self.name.to_lowercase().as_str() {
            "highest" | "blocker" => "↑",
            "high" | "critical" => "↗",
            "medium" | "normal" => "→",
            "low" | "minor" => "↘",
            "lowest" | "trivial" => "↓",
            _ => "·",
        }
    }
}

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct UserField {
    pub name: String,
    #[serde(rename = "displayName")]
    pub display_name: Option<String>,
    #[serde(rename = "accountId")]
    pub account_id: Option<String>,
}

impl UserField {
    pub fn display(&self) -> &str {
        self.display_name.as_deref().unwrap_or(&self.name)
    }
}

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct IssueTypeField {
    pub id: String,
    pub name: String,
}

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct ProjectField {
    pub id: String,
    pub key: String,
    pub name: String,
}

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct CommentList {
    pub comments: Vec<Comment>,
    pub total: u32,
}

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct Comment {
    pub id: String,
    pub author: UserField,
    pub body: String,
    pub created: String,
    pub updated: String,
}

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct Transition {
    pub id: String,
    pub name: String,
    pub to: StatusField,
}

/// Jira REST API search response envelope.
#[derive(Debug, Deserialize)]
pub struct SearchResponse {
    pub issues: Vec<Issue>,
    pub total: u32,
    #[serde(rename = "startAt")]
    #[allow(dead_code)]
    pub start_at: u32,
    #[serde(rename = "maxResults")]
    #[allow(dead_code)]
    pub max_results: u32,
}

/// Jira REST API transitions response envelope.
#[derive(Debug, Deserialize)]
pub struct TransitionsResponse {
    pub transitions: Vec<Transition>,
}

/// Metadata for a single Jira field (from `/rest/api/2/field`).
#[derive(Debug, Deserialize)]
pub struct FieldMeta {
    pub id: String,
    pub name: String,
}

/// A selectable option for a Jira select/array field (from editmeta `allowedValues`).
#[derive(Debug, Clone)]
pub struct FieldOption {
    pub value: String,
}