confluence-cli 1.12.0 → 1.13.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [1.13.0](https://github.com/pchuri/confluence-cli/compare/v1.12.1...v1.13.0) (2026-01-08)
+
+
+### Features
+
+* add children command to list child pages ([#27](https://github.com/pchuri/confluence-cli/issues/27)) ([7e8b4ed](https://github.com/pchuri/confluence-cli/commit/7e8b4ed1b0ed69a7e1de52dfaf0c1ff36973f78b))
+
+## [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

@@ -44,12 +44,17 @@ npx confluence-cli
    confluence search "my search term"
    ```
 
-4. **Create a new page:**
+4. **List child pages:**
+   ```bash
+   confluence children 123456789
+   ```
+
+5. **Create a new page:**
    ```bash
    confluence create "My New Page" SPACEKEY --content "Hello World!"
    ```
 
-5. **Update a page:**
+6. **Update a page:**
    ```bash
    confluence update 123456789 --content "Updated content"
    ```
@@ -139,6 +144,27 @@ confluence export 123456789 --skip-attachments
 confluence spaces
 ```
 
+### List Child Pages
+```bash
+# List direct child pages
+confluence children 123456789
+
+# List all descendants recursively
+confluence children 123456789 --recursive
+
+# Display as tree structure
+confluence children 123456789 --recursive --format tree
+
+# Show page IDs and URLs
+confluence children 123456789 --show-id --show-url
+
+# Limit recursion depth
+confluence children 123456789 --recursive --max-depth 3
+
+# Output as JSON for scripting
+confluence children 123456789 --recursive --format json > children.json
+```
+
 ### Find a Page by Title
 ```bash
 # Find page by title
@@ -250,11 +276,15 @@ confluence stats
 | `search <query>` | Search for pages | `--limit <number>` |
 | `spaces` | List all available spaces | |
 | `find <title>` | Find a page by its title | `--space <spaceKey>` |
+| `children <pageId>` | List child pages of a page | `--recursive`, `--max-depth <number>`, `--format <list\|tree\|json>`, `--show-url`, `--show-id` |
 | `create <title> <spaceKey>` | Create a new page | `--content <string>`, `--file <path>`, `--format <storage\|html\|markdown>`|
 | `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,161 @@ program
     }
   });
 
-program.parse();
+// List children command
+program
+  .command('children <pageId>')
+  .description('List child pages of a Confluence page')
+  .option('-r, --recursive', 'List all descendants recursively', false)
+  .option('--max-depth <number>', 'Maximum depth for recursive listing', '10')
+  .option('--format <format>', 'Output format (list, tree, json)', 'list')
+  .option('--show-url', 'Show page URLs', false)
+  .option('--show-id', 'Show page IDs', false)
+  .action(async (pageId, options) => {
+    const analytics = new Analytics();
+    try {
+      const config = getConfig();
+      const client = new ConfluenceClient(config);
+      
+      // Extract page ID from URL if needed
+      const resolvedPageId = await client.extractPageId(pageId);
+      
+      // Get children
+      let children;
+      if (options.recursive) {
+        const maxDepth = parseInt(options.maxDepth) || 10;
+        children = await client.getAllDescendantPages(resolvedPageId, maxDepth);
+      } else {
+        children = await client.getChildPages(resolvedPageId);
+      }
+      
+      if (children.length === 0) {
+        console.log(chalk.yellow('No child pages found.'));
+        analytics.track('children', true);
+        return;
+      }
+      
+      // Format output
+      const format = options.format.toLowerCase();
+      
+      if (format === 'json') {
+        // JSON output
+        const output = {
+          pageId: resolvedPageId,
+          childCount: children.length,
+          children: children.map(page => ({
+            id: page.id,
+            title: page.title,
+            type: page.type,
+            status: page.status,
+            spaceKey: page.space?.key,
+            url: `https://${config.domain}/wiki/spaces/${page.space?.key}/pages/${page.id}`,
+            parentId: page.parentId || resolvedPageId
+          }))
+        };
+        console.log(JSON.stringify(output, null, 2));
+      } else if (format === 'tree' && options.recursive) {
+        // Tree format (only for recursive mode)
+        const pageInfo = await client.getPageInfo(resolvedPageId);
+        console.log(chalk.blue(`📁 ${pageInfo.title}`));
+        
+        // Build tree structure
+        const tree = buildTree(children, resolvedPageId);
+        printTree(tree, config, options, 1);
+        
+        console.log('');
+        console.log(chalk.gray(`Total: ${children.length} child page${children.length === 1 ? '' : 's'}`));
+      } else {
+        // List format (default)
+        console.log(chalk.blue('Child pages:'));
+        console.log('');
+        
+        children.forEach((page, index) => {
+          let output = `${index + 1}. ${chalk.green(page.title)}`;
+          
+          if (options.showId) {
+            output += ` ${chalk.gray(`(ID: ${page.id})`)}`;
+          }
+          
+          if (options.showUrl) {
+            const url = `https://${config.domain}/wiki/spaces/${page.space?.key}/pages/${page.id}`;
+            output += `\n   ${chalk.gray(url)}`;
+          }
+          
+          if (options.recursive && page.parentId && page.parentId !== resolvedPageId) {
+            output += ` ${chalk.dim('(nested)')}`;
+          }
+          
+          console.log(output);
+        });
+        
+        console.log('');
+        console.log(chalk.gray(`Total: ${children.length} child page${children.length === 1 ? '' : 's'}`));
+      }
+      
+      analytics.track('children', true);
+    } catch (error) {
+      analytics.track('children', false);
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Helper function to build tree structure
+function buildTree(pages, rootId) {
+  const tree = [];
+  const pageMap = new Map();
+  
+  // Create a map of all pages
+  pages.forEach(page => {
+    pageMap.set(page.id, { ...page, children: [] });
+  });
+  
+  // Build tree structure
+  pages.forEach(page => {
+    const node = pageMap.get(page.id);
+    const parentId = page.parentId || rootId;
+    
+    if (parentId === rootId) {
+      tree.push(node);
+    } else {
+      const parent = pageMap.get(parentId);
+      if (parent) {
+        parent.children.push(node);
+      }
+    }
+  });
+  
+  return tree;
+}
+
+// Helper function to print tree
+function printTree(nodes, config, options, depth = 1) {
+  nodes.forEach((node, index) => {
+    const isLast = index === nodes.length - 1;
+    const indent = '  '.repeat(depth - 1);
+    const prefix = isLast ? '└── ' : '├── ';
+    
+    let output = `${indent}${prefix}📄 ${chalk.green(node.title)}`;
+    
+    if (options.showId) {
+      output += ` ${chalk.gray(`(ID: ${node.id})`)}`;
+    }
+    
+    if (options.showUrl) {
+      const url = `https://${config.domain}/wiki/spaces/${node.space?.key}/pages/${node.id}`;
+      output += `\n${indent}${isLast ? '    ' : '│   '}${chalk.gray(url)}`;
+    }
+    
+    console.log(output);
+    
+    if (node.children && node.children.length > 0) {
+      printTree(node.children, config, options, depth + 1);
+    }
+  });
+}
+
+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.13.0",
   "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",