confluence-cli 1.12.0 → 1.12.1

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [1.12.1](https://github.com/pchuri/confluence-cli/compare/v1.12.0...v1.12.1) (2025-12-31)
+
+
+### Bug Fixes
+
+* align README with CLI behavior ([#26](https://github.com/pchuri/confluence-cli/issues/26)) ([b24c7cf](https://github.com/pchuri/confluence-cli/commit/b24c7cf4a645383812a1cb7239b1db41ded77f8d))
+
 # [1.12.0](https://github.com/pchuri/confluence-cli/compare/v1.11.1...v1.12.0) (2025-12-31)
 
 

package/README.md

@@ -254,7 +254,10 @@ confluence stats
 | `create-child <title> <parentId>` | Create a child page | `--content <string>`, `--file <path>`, `--format <storage\|html\|markdown>` |
 | `copy-tree <sourcePageId> <targetParentId> [newTitle]` | Copy page tree with all children | `--max-depth <number>`, `--exclude <patterns>`, `--delay-ms <ms>`, `--copy-suffix <text>`, `--dry-run`, `--fail-on-error`, `--quiet` |
 | `update <pageId>` | Update a page's title or content | `--title <string>`, `--content <string>`, `--file <path>`, `--format <storage\|html\|markdown>` |
+| `delete <pageId_or_url>` | Delete a page by ID or URL | `--yes` |
 | `edit <pageId>` | Export page content for editing | `--output <file>` |
+| `attachments <pageId_or_url>` | List or download attachments for a page | `--limit <number>`, `--pattern <glob>`, `--download`, `--dest <directory>` |
+| `export <pageId_or_url>` | Export a page to a directory with its attachments | `--format <html\|text\|markdown>`, `--dest <directory>`, `--file <filename>`, `--attachments-dir <name>`, `--pattern <glob>`, `--referenced-only`, `--skip-attachments` |
 | `stats` | View your usage statistics | |
 
 ## Examples

package/bin/confluence.js

@@ -475,6 +475,7 @@ program
   .option('--file <filename>', 'Content filename (default: page.<ext>)')
   .option('--attachments-dir <name>', 'Subdirectory for attachments', 'attachments')
   .option('--pattern <glob>', 'Filter attachments by filename (e.g., "*.png")')
+  .option('--referenced-only', 'Download only attachments referenced in the page content')
   .option('--skip-attachments', 'Do not download attachments')
   .action(async (pageId, options) => {
     const analytics = new Analytics();
@@ -489,9 +490,14 @@ program
       const contentExt = formatExt[format] || 'txt';
 
       const pageInfo = await client.getPageInfo(pageId);
-      // Read page with attachment extraction enabled
-      const content = await client.readPage(pageId, format, { extractReferencedAttachments: true });
-      const referencedAttachments = client._referencedAttachments || new Set();
+      const content = await client.readPage(
+        pageId,
+        format,
+        options.referencedOnly ? { extractReferencedAttachments: true } : {}
+      );
+      const referencedAttachments = options.referencedOnly
+        ? (client._referencedAttachments || new Set())
+        : null;
 
       const baseDir = path.resolve(options.dest || '.');
       const folderName = sanitizeTitle(pageInfo.title || 'page');
@@ -510,13 +516,13 @@ program
         const pattern = options.pattern ? options.pattern.trim() : null;
         const allAttachments = await client.getAllAttachments(pageId);
         
-        // Filter: only referenced attachments (unless pattern is specified, then use pattern)
         let filtered;
         if (pattern) {
           filtered = allAttachments.filter(att => client.matchesPattern(att.title, pattern));
+        } else if (options.referencedOnly) {
+          filtered = allAttachments.filter(att => referencedAttachments?.has(att.title));
         } else {
-          // Only download attachments that are referenced in the page content
-          filtered = allAttachments.filter(att => referencedAttachments.has(att.title));
+          filtered = allAttachments;
         }
 
         if (filtered.length === 0) {
@@ -700,4 +706,8 @@ program
     }
   });
 
-program.parse();
+if (process.argv.length <= 2) {
+  program.help({ error: false });
+}
+
+program.parse(process.argv);

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "confluence-cli",
-  "version": "1.12.0",
+  "version": "1.12.1",
   "description": "A command-line interface for Atlassian Confluence with page creation and editing capabilities",
   "main": "index.js",
   "bin": {
-    "confluence": "bin/index.js"
+    "confluence": "bin/index.js",
+    "confluence-cli": "bin/index.js"
   },
   "scripts": {
     "start": "node bin/confluence.js",