atlass 1.14.0 → 2.1.0

package/README.md

@@ -72,9 +72,10 @@ Writes `PROJ-123.md` or `123456-title-slug.md` to the current directory, with
 attachments in a sibling `<name>.assets/` folder. Pass `--out` with a directory
 or file path to write elsewhere. Existing files are overwritten.
 
-Each file has YAML frontmatter, an H1, the body as Markdown, a `## Comments`
-section, and an `## Attachments` section. Inline images link to the local copy
-when they can be matched to an attachment.
+Each file has YAML frontmatter, an H1, the body as Markdown, then a
+`<!-- atlass:generated -->` line followed by the `## Comments` and
+`## Attachments` sections. Inline images link to the local copy when they can be
+matched to an attachment.
 
 ## Update
 
@@ -88,8 +89,13 @@ atlass confluence update file.md --title      # also push the H1 as the title
 atlass confluence update file.md -m "fix typo"
 ```
 
-Both accept `--dry-run` to preview and `--force` to skip the checks below. The
-body sent is everything between the H1 and `## Comments`.
+Both accept `--dry-run` to preview and `--force` to skip the checks below. A
+Confluence dry run also prints a diff of the body against the server. A dry run
+exits 1 when the real update would refuse, or would need to ask and cannot
+because there is no terminal or `--no-input` is set.
+
+The body sent is everything between the H1 and the `<!-- atlass:generated -->`
+line, or the first `## Comments` or `## Attachments` in older copies.
 
 - The update aborts if the issue or page changed on the server since the copy.
 - Panels, macros, expands, and layouts were flattened on copy and cannot be
@@ -97,6 +103,9 @@ body sent is everything between the H1 and `## Comments`.
   overwriting.
 - Confluence uploads local images referenced in the body as attachments. Jira
   update does not support image changes yet.
+- 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.
 
 ## Create
 
@@ -123,6 +132,18 @@ assignees take `me`, an account id, or a name matching one assignable user.
 `--dry-run` prints the resolved payload. `--json` prints the created key, id,
 and URL. `jira fields` shows what each field expects.
 
+```bash
+atlass confluence create notes.md --space DEV
+atlass confluence create notes.md --space DEV --parent 123456 --star
+```
+
+`confluence create` publishes a Markdown file as a new page. The title is the
+H1, or `title` in the frontmatter. The space comes from `--space` or `space` in
+the frontmatter, and the page goes under the space homepage unless `--parent`
+names another page. Local images are uploaded as attachments. The file then gets
+the same frontmatter as a copy, so `update` works on it straight away.
+`--dry-run` previews and exits 1 if the create would be refused.
+
 ## List
 
 ```bash
@@ -138,7 +159,9 @@ 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.
 
 `confluence list` shows the pages you starred as `ID  SPACE  Age  Title`, most
-recently updated first. `--limit` works as for search.
+recently updated first. `--limit` works as for search. Star or unstar a page
+with `atlass confluence star <page>` or `unstar <page>`, where `<page>` is an
+id, a URL, or a copied `.md` file.
 
 For both, `--json` and `--copy` work as for search.
 
@@ -146,17 +169,29 @@ For both, `--json` and `--copy` work as for search.
 
 ```bash
 atlass jira search "safari login"
-atlass jira search --project PROJ --assignee me --status "In Progress"
-atlass jira search --jql "project = PROJ AND labels = regression"
-atlass confluence search "onboarding" --space DOCS
-atlass confluence search --cql "label = runbook ORDER BY created DESC"
+atlass jira search --project PROJ --assignee me --open
+atlass jira search --status "In Progress" --status "In Review" --updated 2w
+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
+`YYYY-MM-DD`. Results sort by most recently updated and use the same columns
+as `jira list` and `confluence list`.
+
+For anything the filters do not cover, write the query yourself:
+
+```bash
+atlass jira jql "project = PROJ AND labels = regression ORDER BY created DESC"
+atlass confluence cql "label = runbook AND creator = currentUser()"
 ```
 
-Filters combine with AND and sort by most recently updated. Rows use the same
-columns as `jira list` and `confluence list`. `--jql` and `--cql` replace the
-friendly filters. `--limit` defaults to 25, max 100. `--json` prints machine
-output. Add `--copy` to pick results interactively and copy each one, with
-`--out` as the target directory.
+`--limit` defaults to 25, max 100. `--json` prints machine output. Add `--copy`
+to pick results interactively and copy each one, with `--out` as the target
+directory. All four work on both search commands.
 
 Discovery aids for the filters:
 

package/dist/bitbucket.mjs

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