atlass 2.0.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.
 

package/dist/bitbucket.mjs

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