atlass 1.9.0 → 1.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -44,12 +44,19 @@ atlass bitbucket logout
44
44
  ```bash
45
45
  atlass jira view PROJ-123
46
46
  atlass jira view https://acme.atlassian.net/browse/PROJ-123
47
+ atlass confluence view 123456
48
+ atlass confluence view https://acme.atlassian.net/wiki/spaces/DEV/pages/123456/Title
47
49
  ```
48
50
 
49
- Prints the issue to the terminal: fields, description, the last five comments
50
- (`--all-comments` for all of them), and attachment names. The status is colored
51
- by category and the Markdown is syntax highlighted, code blocks included; color
52
- turns off automatically when piping, or with `NO_COLOR`, leaving plain Markdown.
51
+ Prints the issue or page to the terminal: fields, the body, the last five
52
+ comments (`--all-comments` for all of them), and attachment names. The Jira
53
+ status is colored by category and the Markdown is syntax highlighted, code
54
+ blocks included; color turns off automatically when piping, or with `NO_COLOR`,
55
+ leaving plain Markdown.
56
+
57
+ Output taller than the terminal goes through a pager, `$PAGER` or `less`, with
58
+ `LESS=FRX` unless you have set `LESS` yourself. Pass `--no-pager` to print
59
+ directly. Piped output is never paged.
53
60
 
54
61
  ## Copy
55
62
 
@@ -90,18 +97,49 @@ body sent is everything between the H1 and `## Comments`.
90
97
  - Confluence uploads local images referenced in the body as attachments. Jira
91
98
  update does not support image changes yet.
92
99
 
100
+ ## Create
101
+
102
+ ```bash
103
+ atlass jira create # prompts for everything
104
+ atlass jira create BSC Bug --summary "Login loops" --priority High --label auth
105
+ atlass jira create BSC Task -s "Rotate keys" --description-file notes.md --assignee me
106
+ atlass jira create BSC Defect -s "..." --component API --field severity=S2 --dry-run
107
+ atlass jira fields BSC # issue types you can create
108
+ atlass jira fields BSC Defect # the create form for one type
109
+ ```
110
+
111
+ With no field flags on a terminal, `create` walks through the create screen:
112
+ required fields, a pick list of optional ones, then a review and confirm.
113
+ Multi-line fields open `$EDITOR` for Markdown.
114
+
115
+ Any field flag, `--no-input`, or a non-terminal switches to strict mode:
116
+ nothing is prompted, and the command fails before creating anything if a
117
+ required field is missing, a value is not allowed, or a field is not on the
118
+ create screen. `--field NAME=VALUE` takes the display name or id. Multi-value
119
+ fields take commas or repeated flags; cascading selects take `Parent > Child`;
120
+ assignees take `me`, an account id, or a name matching one assignable user.
121
+
122
+ `--dry-run` prints the resolved payload. `--json` prints the created key, id,
123
+ and URL. `jira fields` shows what each field expects.
124
+
93
125
  ## List
94
126
 
95
127
  ```bash
96
128
  atlass jira list
97
129
  atlass jira list --project PROJ
98
130
  atlass jira list --all
131
+ atlass confluence list
132
+ atlass confluence list --space DOCS
99
133
  ```
100
134
 
101
- Lists issues assigned to you as `KEY Status Age Summary`, with In Progress
102
- first, then To Do, and the most recently updated at the top of each group. Done
103
- issues are left out; `--all` adds those updated in the last 30 days. `--json`
104
- and `--copy` work as for search.
135
+ `jira list` shows issues assigned to you as `KEY Status Age Summary`, with
136
+ In Progress first, then To Do, and the most recently updated at the top of each
137
+ group. Done issues are left out; `--all` adds those updated in the last 30 days.
138
+
139
+ `confluence list` shows the pages you starred as `ID SPACE Age Title`, most
140
+ recently updated first. `--limit` works as for search.
141
+
142
+ For both, `--json` and `--copy` work as for search.
105
143
 
106
144
  ## Search
107
145
 
@@ -113,10 +151,11 @@ atlass confluence search "onboarding" --space DOCS
113
151
  atlass confluence search --cql "label = runbook ORDER BY created DESC"
114
152
  ```
115
153
 
116
- Filters combine with AND and sort by most recently updated. `--jql` and `--cql`
117
- replace the friendly filters. `--limit` defaults to 25, max 100. `--json` prints
118
- machine output. Add `--copy` to pick results interactively and copy each one,
119
- with `--out` as the target directory.
154
+ Filters combine with AND and sort by most recently updated. Rows use the same
155
+ columns as `jira list` and `confluence list`. `--jql` and `--cql` replace the
156
+ friendly filters. `--limit` defaults to 25, max 100. `--json` prints machine
157
+ output. Add `--copy` to pick results interactively and copy each one, with
158
+ `--out` as the target directory.
120
159
 
121
160
  Discovery aids for the filters:
122
161
 
@@ -1,5 +1,5 @@
1
1
  #!/usr/bin/env node
2
- import { n as buildStandalone, r as fail } from "./build-DhED0Zw_.mjs";
2
+ import { n as buildStandalone, r as fail } from "./build-wKtbjBhd.mjs";
3
3
  //#region src/bitbucket.ts
4
4
  buildStandalone("bitbucket").parseAsync().catch(fail);
5
5
  //#endregion