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
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
use clap::{Args, Subcommand};
#[derive(Subcommand, Debug)]
pub enum ArchiveAction {
/// List compact archived cases and/or direct-message archive categories.
List {
#[command(subcommand)]
target: Option<ArchiveListAction>,
},
/// Operate on a direct-message archive category.
Message {
#[command(subcommand)]
action: ArchiveMessageCommand,
},
/// Operate on an archived case.
Case {
#[command(subcommand)]
action: ArchiveCaseAction,
},
}
#[derive(Subcommand, Debug)]
pub enum ArchiveListAction {
/// List compact archived cases.
Cases,
/// List compact direct-message archive categories.
Messages,
}
#[derive(Subcommand, Debug)]
pub enum ArchiveMessageCommand {
/// Create a direct-message archive category and optionally file one message.
Create(ArchiveMessageCreateArgs),
/// File an existing message into this direct-message archive category.
Add {
/// Direct-message archive category ref: aYYYYMMDDNNN or aYYYYMMDDNNN-any-suffix.
archive_ref: String,
/// Message id to file.
message_id: String,
/// Human/agent-authored summary for this archive entry.
#[arg(long)]
summary: String,
/// Why this disposition is correct; required by default.
#[arg(long)]
reason: Option<String>,
},
/// Show archive category index and entries.
Show {
/// Direct-message archive category ref: aYYYYMMDDNNN or aYYYYMMDDNNN-any-suffix.
archive_ref: String,
},
/// Restore a direct archived message to triage.
Restore {
/// Direct-message archive category ref: aYYYYMMDDNNN or aYYYYMMDDNNN-any-suffix.
archive_ref: String,
message_id: String,
/// Why this message needs active triage again; required by default.
#[arg(long)]
reason: Option<String>,
},
/// Move a direct archived message to another archive category.
Move {
/// Source direct-message archive category ref.
archive_ref: String,
message_id: String,
/// Destination archive category ref.
new_archive_ref: String,
/// Why this category is better; required by default.
#[arg(long)]
reason: Option<String>,
},
/// Rename this archive category's human-readable name without changing its UID.
Rename {
/// Direct-message archive category ref: aYYYYMMDDNNN or aYYYYMMDDNNN-any-suffix.
archive_ref: String,
/// New human-readable archive name.
#[arg(long)]
name: String,
/// Why this name better represents the category; required by default.
#[arg(long)]
reason: Option<String>,
},
/// Set or replace one direct archive entry summary.
SetSummary {
/// Direct-message archive category ref: aYYYYMMDDNNN or aYYYYMMDDNNN-any-suffix.
archive_ref: String,
message_id: String,
#[arg(long)]
summary: String,
/// Why this summary is useful; required by default.
#[arg(long)]
reason: Option<String>,
},
/// Show or edit archive category notes.
Notes {
#[command(subcommand)]
action: ArchiveMessageNotesAction,
},
}
#[derive(Args, Debug, Clone)]
pub struct ArchiveMessageCreateArgs {
/// Human-readable archive category name used in metadata and the directory suffix.
#[arg(long)]
pub name: String,
/// Optional message to immediately file into the new archive category.
#[arg(long)]
pub message: Option<String>,
/// Required when --message is supplied.
#[arg(long)]
pub summary: Option<String>,
/// Why this archive category is being created.
#[arg(long)]
pub reason: Option<String>,
}
#[derive(Subcommand, Debug)]
pub enum ArchiveCaseAction {
/// Show the archived case.
Show {
/// Case ref: cYYYYMMDDNNN or cYYYYMMDDNNN-any-suffix.
case_ref: String,
},
/// Restore an archived case to an active case group.
Restore {
/// Case ref: cYYYYMMDDNNN or cYYYYMMDDNNN-any-suffix.
case_ref: String,
/// Active case group to restore into.
#[arg(long)]
group: String,
/// Why this case needs active attention again; required by default.
#[arg(long)]
reason: Option<String>,
},
/// Rename this archived case's human-readable name without changing its UID.
Rename {
/// Case ref: cYYYYMMDDNNN or cYYYYMMDDNNN-any-suffix.
case_ref: String,
/// New human-readable case name.
#[arg(long)]
name: String,
/// Why this name better represents the case; required by default.
#[arg(long)]
reason: Option<String>,
},
/// Show or edit archived case notes.
Notes {
#[command(subcommand)]
action: ArchiveCaseNotesAction,
},
}
#[derive(Subcommand, Debug)]
pub enum ArchiveMessageNotesAction {
/// Show notes markdown.
Show {
/// Direct-message archive category ref: aYYYYMMDDNNN or aYYYYMMDDNNN-any-suffix.
archive_ref: String,
},
/// Append text to notes markdown.
Append {
/// Direct-message archive category ref: aYYYYMMDDNNN or aYYYYMMDDNNN-any-suffix.
archive_ref: String,
/// Markdown text to append.
#[arg(long)]
text: String,
},
/// Replace notes markdown with text.
Replace {
/// Direct-message archive category ref: aYYYYMMDDNNN or aYYYYMMDDNNN-any-suffix.
archive_ref: String,
/// Markdown text to write.
#[arg(long)]
text: String,
},
}
#[derive(Subcommand, Debug)]
pub enum ArchiveCaseNotesAction {
/// Show notes markdown.
Show {
/// Case ref: cYYYYMMDDNNN or cYYYYMMDDNNN-any-suffix.
case_ref: String,
},
/// Append text to notes markdown.
Append {
/// Case ref: cYYYYMMDDNNN or cYYYYMMDDNNN-any-suffix.
case_ref: String,
/// Markdown text to append.
#[arg(long)]
text: String,
},
/// Replace notes markdown with text.
Replace {
/// Case ref: cYYYYMMDDNNN or cYYYYMMDDNNN-any-suffix.
case_ref: String,
/// Markdown text to write.
#[arg(long)]
text: String,
},
}