tendril/cli.json at main · WickedCoding/tendril · GitHub

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
202
203
204
205
206
207
208
209
{
  "commands": [
    {
      "name": "whoami",
      "description": "Fetch and display the current JIRA user (verifies auth).",
      "parameters": []
    },
    {
      "name": "show",
      "description": "Print an issue from the local cache.",
      "parameters": [
        {
          "name": "key",
          "kind": "argument",
          "type": "str",
          "description": "JIRA issue key.",
          "optional": false
        }
      ]
    },
    {
      "name": "config init",
      "description": "Interactively write ~/.config/tendril/config.toml and store the API token.",
      "parameters": []
    },
    {
      "name": "config show",
      "description": "Print the current configuration (token is never printed).",
      "parameters": []
    },
    {
      "name": "sync issue",
      "description": "Fetch one or more JIRA issues and upsert them into the local cache.",
      "parameters": [
        {
          "name": "keys",
          "kind": "argument",
          "type": "list[str]",
          "description": "One or more JIRA issue keys.",
          "optional": false,
          "variadic": true
        }
      ]
    },
    {
      "name": "sync project",
      "description": "Fetch every issue in one or more JIRA projects into the local cache.",
      "parameters": [
        {
          "name": "project_keys",
          "kind": "argument",
          "type": "list[str]",
          "description": "One or more JIRA project keys.",
          "optional": false,
          "variadic": true
        }
      ]
    },
    {
      "name": "sync incremental",
      "description": "Refetch issues updated since the last incremental sync, across all previously synced projects.",
      "parameters": []
    },
    {
      "name": "sync link-types",
      "description": "Fetch the JIRA instance's issue link types and replace the local cache.",
      "parameters": []
    },
    {
      "name": "watchlist add",
      "description": "Add issue keys to the watchlist (idempotent).",
      "parameters": [
        {
          "name": "keys",
          "kind": "argument",
          "type": "list[str]",
          "description": "One or more JIRA issue keys.",
          "optional": false,
          "variadic": true
        },
        {
          "name": "note",
          "kind": "option",
          "flags": ["--note", "-n"],
          "type": "str",
          "description": "Optional note attached to each entry.",
          "optional": true,
          "default": null
        },
        {
          "name": "tags",
          "kind": "option",
          "flags": ["--tag", "-t"],
          "type": "list[str]",
          "description": "Optional tag applied to each key (repeat to add several).",
          "optional": true,
          "default": [],
          "variadic": true
        }
      ]
    },
    {
      "name": "watchlist remove",
      "description": "Remove issue keys from the watchlist. The cached issue rows are left alone.",
      "parameters": [
        {
          "name": "keys",
          "kind": "argument",
          "type": "list[str]",
          "description": "One or more JIRA issue keys.",
          "optional": false,
          "variadic": true
        }
      ]
    },
    {
      "name": "watchlist list",
      "description": "Print the watchlist with cached issue metadata (run `sync watchlist` to populate).",
      "parameters": []
    },
    {
      "name": "tag add",
      "description": "Add tags to a cached issue (idempotent). Tags are local — never pushed to JIRA.",
      "parameters": [
        {
          "name": "key",
          "kind": "argument",
          "type": "str",
          "description": "JIRA issue key.",
          "optional": false
        },
        {
          "name": "tags",
          "kind": "argument",
          "type": "list[str]",
          "description": "One or more tags to add.",
          "optional": false,
          "variadic": true
        }
      ]
    },
    {
      "name": "tag remove",
      "description": "Remove tags from a cached issue.",
      "parameters": [
        {
          "name": "key",
          "kind": "argument",
          "type": "str",
          "description": "JIRA issue key.",
          "optional": false
        },
        {
          "name": "tags",
          "kind": "argument",
          "type": "list[str]",
          "description": "One or more tags to remove.",
          "optional": false,
          "variadic": true
        }
      ]
    },
    {
      "name": "tag set",
      "description": "Replace the full tag set for an issue. The bulk-write an LLM would use.",
      "parameters": [
        {
          "name": "key",
          "kind": "argument",
          "type": "str",
          "description": "JIRA issue key.",
          "optional": false
        },
        {
          "name": "tags",
          "kind": "argument",
          "type": "list[str]",
          "description": "Tags to assign. Omit to clear all tags.",
          "optional": true,
          "default": null,
          "variadic": true
        }
      ]
    },
    {
      "name": "tag list",
      "description": "List tagged issues. `--json` for machine consumption (LLM pipelines).",
      "parameters": [
        {
          "name": "key",
          "kind": "argument",
          "type": "str",
          "description": "Limit to one issue key. Omit to list all tagged issues.",
          "optional": true,
          "default": null
        },
        {
          "name": "json_out",
          "kind": "option",
          "flags": ["--json"],
          "type": "bool",
          "description": "Emit machine-readable JSON.",
          "optional": true,
          "default": false
        }
      ]
    }
  ]
}