atlass 2.1.0 → 2.3.0

package/README.md

@@ -103,10 +103,26 @@ line, or the first `## Comments` or `## Attachments` in older copies.
   overwriting.
 - Confluence uploads local images referenced in the body as attachments. Jira
   update does not support image changes yet.
+- Embedded videos are set to the full width of the text column. Images keep
+  their natural size.
 - After an update, the new `updated` (and for Confluence, `version`, and `title`
   with `--title`) is written back to the frontmatter, so the file can be pushed
   again without a fresh copy.
 
+## Attach
+
+```bash
+atlass jira attach PROJ-123 screenshot.png logs.zip
+atlass confluence attach 123456 diagram.png --comment "v2 layout"
+```
+
+Uploads files as new attachments, one request per file. Every file is read
+before anything uploads, and the first failed upload stops the run. `--json`
+prints the filename, id, and size of each attachment.
+
+Jira keeps duplicate filenames side by side. Confluence refuses a filename the
+page already has, checked before any upload. `--comment` is Confluence only.
+
 ## Create
 
 ```bash
@@ -157,6 +173,7 @@ atlass confluence list --space DOCS
 `jira list` shows issues assigned to you as `KEY  Status  Age  Summary`, with
 In Progress first, then To Do, and the most recently updated at the top of each
 group. Done issues are left out; `--all` adds those updated in the last 30 days.
+`--limit` keeps the first rows of that order; without it, all are shown.
 
 `confluence list` shows the pages you starred as `ID  SPACE  Age  Title`, most
 recently updated first. `--limit` works as for search. Star or unstar a page
@@ -175,10 +192,12 @@ atlass confluence search "onboarding" --space DOCS --label runbook
 ```
 
 Jira filters on `--project`, `--assignee`, `--reporter`, `--status`, `--type`,
-`--label`, `--updated` and `--open`; Confluence on `--space`, `--label`,
-`--updated` and `--starred`. Repeating a flag matches any of its values;
-different flags must all match. `--assignee` and `--reporter` take `me`, an
-account id, or a name to look up. `--updated` takes `7d`, `2w`, `3m` or
+`--label`, `--sprint`, `--updated` and `--open`; Confluence on `--space`,
+`--label`, `--updated` and `--starred`. Repeating a flag matches any of its
+values; different flags must all match. `--assignee` and `--reporter` take `me`,
+an account id, or a name to look up. `--sprint` takes `active`, `future`, a
+sprint id, or a sprint name; names can repeat across boards, an id cannot.
+`--updated` takes `7d`, `2w`, `3m` or
 `YYYY-MM-DD`. Results sort by most recently updated and use the same columns
 as `jira list` and `confluence list`.
 
@@ -193,6 +212,19 @@ atlass confluence cql "label = runbook AND creator = currentUser()"
 to pick results interactively and copy each one, with `--out` as the target
 directory. All four work on both search commands.
 
+`--field` adds a field's value to each issue on `jira search`, `jira jql` and
+`jira list`:
+
+```bash
+atlass jira search --assignee me --status Closed --field "Story Points" --json
+```
+
+It takes a field id or a name, ignoring case, and repeats for more fields. A
+name several fields share fails and lists their ids; `atlass jira fields
+--search` finds the one you want. Each field becomes a column after the status.
+With `--json`, each issue gains a `fields` object of raw values keyed by the
+name you passed.
+
 Discovery aids for the filters:
 
 ```bash
@@ -200,6 +232,42 @@ atlass jira projects [query]
 atlass jira statuses [query] [--project PROJ]
 ```
 
+## Boards
+
+```bash
+atlass jira boards [query] [--project PROJ]
+atlass jira board <id|url|name> [--json]
+```
+
+`boards` lists every board as `ID  Type  Name  Project`, filtered by name and
+project key. Boards that span projects leave the project cell empty.
+
+`board` shows one board: the field it estimates with, its filter JQL, and each
+column's statuses with their categories. A name must match exactly, ignoring
+case; if several boards share it, use the id.
+
+## Sprints
+
+```bash
+atlass jira sprints <id|url|name> [--state active|future|closed ...] [--limit N] [--json]
+```
+
+Lists a board's sprints as `ID  State  Name  Start  End`, active only unless
+`--state` says otherwise. Active sprints come first, then future, then closed
+newest first. The board takes the same forms as `board`.
+
+## Fields
+
+```bash
+atlass jira fields [--search TEXT] [--json]
+```
+
+With no project, `fields` lists every field on the site as `ID  Name  Type`,
+sorted by name. `--search` filters by name or id, ignoring case. The type is the
+custom field's plugin type, such as `float` or `gh-sprint`, or the schema type
+for system fields. `--json` carries the full schema, plugin key included. With a
+project, `fields` shows the create form instead (see Create).
+
 ## Bitbucket
 
 `--repo` takes `workspace/slug` or a bare slug under the configured workspace,

package/dist/bitbucket.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { n as buildStandalone, r as fail } from "./build-_4VuIcqF.mjs";
+import { n as buildStandalone, r as fail } from "./build-6PhpYMjp.mjs";
 //#region src/bitbucket.ts
 buildStandalone("bitbucket").parseAsync().catch(fail);
 //#endregion