confluence-cli 2.1.12 → 2.3.0

package/README.md

@@ -7,7 +7,7 @@ A powerful command-line interface for Atlassian Confluence that allows you to re
 - 📖 **Read pages** - Get page content in text or HTML format
 - 🔍 **Search** - Find pages using Confluence's powerful search
 - ℹ️ **Page info** - Get detailed information about pages
-- 🏠 **List spaces** - View all available Confluence spaces
+- 🏠 **List spaces** - View available Confluence spaces
 - ✏️ **Create pages** - Create new pages with support for Markdown, HTML, or Storage format
 - 📝 **Update pages** - Update existing page content and titles
 - 🗑️ **Delete pages** - Delete (or move to trash) pages by ID or URL
@@ -691,11 +691,11 @@ confluence stats
 | `read <pageId_or_url>` | Read page content | `--format <html\|text\|storage\|markdown>` |
 | `info <pageId_or_url>` | Get page information | `--format <text\|json>` |
 | `search <query>` | Search for pages | `--limit <number>` |
-| `spaces` | List all available spaces | |
+| `spaces` | List available spaces | `--limit <number>` |
 | `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>` |
+| `create <title> <spaceKey>` | Create a new page or folder | `--content <string>`, `--file <path>`, `--format <storage\|html\|markdown>`, `--type <page\|folder>` |
+| `create-child <title> <parentId>` | Create a child page or folder | `--content <string>`, `--file <path>`, `--format <storage\|html\|markdown>`, `--type <page\|folder>` |
 | `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>` |
 | `move <pageId_or_url> <newParentId_or_url>` | Move a page to a new parent location | `--title <string>` |
@@ -739,7 +739,7 @@ confluence info 123456789
 # Search with limit
 confluence search "API documentation" --limit 3
 
-# List all spaces
+# List spaces
 confluence spaces
 
 # Move a page to a new parent
@@ -752,6 +752,10 @@ confluence move 123456789 987654321 --title "New Title"
 confluence attachment-upload 123456789 --file ./report.pdf
 confluence attachment-delete 123456789 998877 --yes
 
+# Create a folder (no content body required)
+confluence create "Engineering Docs" MYSPACE --type folder
+confluence create-child "Sub-folder" 123456789 --type folder
+
 # View usage statistics
 confluence stats
 

package/bin/confluence.js

@@ -22,6 +22,20 @@ function assertNonEmpty(value, label) {
   }
 }
 
+const VALID_TYPES = ['page', 'folder'];
+
+function assertValidType(type) {
+  if (!VALID_TYPES.includes(type)) {
+    throw new Error(`Invalid type "${type}". Valid: ${VALID_TYPES.join(', ')}`);
+  }
+}
+
+function assertNoBodyForFolder(type, options) {
+  if (type === 'folder' && (options.file || options.content)) {
+    throw new Error('--file/--content is not allowed with --type folder (folders have no body).');
+  }
+}
+
 function handleCommandError(analytics, commandName, error) {
   analytics.track(commandName, false);
   console.error(chalk.red('Error:'), error.message);
@@ -139,13 +153,14 @@ program
 // List spaces command
 program
   .command('spaces')
-  .description('List all Confluence spaces')
-  .action(async () => {
+  .description('List Confluence spaces')
+  .option('-l, --limit <limit>', 'Limit number of results', '500')
+  .action(async (options) => {
     const analytics = new Analytics();
     try {
       const config = getConfig(getProfileName());
       const client = new ConfluenceClient(config);
-      const spaces = await client.getSpaces();
+      const spaces = await client.getSpaces(parseInt(options.limit));
       
       console.log(chalk.blue('Available spaces:'));
       spaces.forEach(space => {
@@ -218,15 +233,18 @@ program
 // Create command
 program
   .command('create <title> <spaceKey>')
-  .description('Create a new Confluence page')
+  .description('Create a new Confluence page or folder')
   .option('-f, --file <file>', 'Read content from file')
   .option('-c, --content <content>', 'Page content as string')
   .option('--format <format>', 'Content format (storage, html, markdown)', 'storage')
+  .option('--type <type>', 'Content type (page, folder)', 'page')
   .action(async (title, spaceKey, options) => {
     const analytics = new Analytics();
     try {
       assertNonEmpty(title, 'title');
       assertNonEmpty(spaceKey, 'spaceKey');
+      assertValidType(options.type);
+      assertNoBodyForFolder(options.type, options);
 
       const config = getConfig(getProfileName());
       assertWritable(config);
@@ -242,13 +260,14 @@ program
         content = fs.readFileSync(options.file, 'utf8');
       } else if (options.content) {
         content = options.content;
-      } else {
+      } else if (options.type !== 'folder') {
         throw new Error('Either --file or --content option is required');
       }
 
-      const result = await client.createPage(title, spaceKey, content, options.format);
-      
-      console.log(chalk.green('✅ Page created successfully!'));
+      const result = await client.createPage(title, spaceKey, content, options.format, options.type);
+
+      const label = options.type === 'folder' ? 'Folder' : 'Page';
+      console.log(chalk.green(`✅ ${label} created successfully!`));
       console.log(`Title: ${chalk.blue(result.title)}`);
       console.log(`ID: ${chalk.blue(result.id)}`);
       console.log(`Space: ${chalk.blue(result.space.name)} (${result.space.key})`);
@@ -263,15 +282,18 @@ program
 // Create child page command
 program
   .command('create-child <title> <parentId>')
-  .description('Create a new Confluence page as a child of another page')
+  .description('Create a new Confluence page or folder as a child of another page')
   .option('-f, --file <file>', 'Read content from file')
   .option('-c, --content <content>', 'Page content as string')
   .option('--format <format>', 'Content format (storage, html, markdown)', 'storage')
+  .option('--type <type>', 'Content type (page, folder)', 'page')
   .action(async (title, parentId, options) => {
     const analytics = new Analytics();
     try {
       assertNonEmpty(title, 'title');
       assertNonEmpty(parentId, 'parentId');
+      assertValidType(options.type);
+      assertNoBodyForFolder(options.type, options);
 
       const config = getConfig(getProfileName());
       assertWritable(config);
@@ -280,9 +302,9 @@ program
       // Get parent page info to get space key
       const parentInfo = await client.getPageInfo(parentId);
       const spaceKey = parentInfo.space.key;
-      
+
       let content = '';
-      
+
       if (options.file) {
         const fs = require('fs');
         if (!fs.existsSync(options.file)) {
@@ -291,13 +313,14 @@ program
         content = fs.readFileSync(options.file, 'utf8');
       } else if (options.content) {
         content = options.content;
-      } else {
+      } else if (options.type !== 'folder') {
         throw new Error('Either --file or --content option is required');
       }
-      
-      const result = await client.createChildPage(title, spaceKey, parentId, content, options.format);
-      
-      console.log(chalk.green('✅ Child page created successfully!'));
+
+      const result = await client.createChildPage(title, spaceKey, parentId, content, options.format, options.type);
+
+      const label = options.type === 'folder' ? 'Folder' : 'Child page';
+      console.log(chalk.green(`✅ ${label} created successfully!`));
       console.log(`Title: ${chalk.blue(result.title)}`);
       console.log(`ID: ${chalk.blue(result.id)}`);
       console.log(`Parent: ${chalk.blue(parentInfo.title)} (${parentId})`);
@@ -2083,6 +2106,8 @@ module.exports = {
     sanitizeFilename,
     assertWritable,
     assertNonEmpty,
+    assertValidType,
+    assertNoBodyForFolder,
     handleCommandError,
   },
 };

package/lib/confluence-client.js

@@ -437,12 +437,12 @@ class ConfluenceClient {
   }
 
   /**
-   * Get all spaces
+   * Get spaces
    */
-  async getSpaces() {
+  async getSpaces(limit = 500) {
     const response = await this.client.get('/space', {
       params: {
-        limit: 500
+        limit
       }
     });
 
@@ -1207,29 +1207,32 @@ class ConfluenceClient {
   /**
    * Create a new Confluence page
    */
-  async createPage(title, spaceKey, content, format = 'storage') {
-    let storageContent = content;
-    
-    if (format === 'markdown') {
-      storageContent = this.markdownToStorage(content);
-    } else if (format === 'html') {
-      // Convert HTML directly to storage format (no macro wrapper)
-      storageContent = content;
-    }
-
+  async createPage(title, spaceKey, content, format = 'storage', type = 'page') {
     const pageData = {
-      type: 'page',
+      type: type,
       title: title,
       space: {
         key: spaceKey
-      },
-      body: {
+      }
+    };
+
+    if (type !== 'folder') {
+      let storageContent = content;
+
+      if (format === 'markdown') {
+        storageContent = this.markdownToStorage(content);
+      } else if (format === 'html') {
+        // Convert HTML directly to storage format (no macro wrapper)
+        storageContent = content;
+      }
+
+      pageData.body = {
         storage: {
           value: storageContent,
           representation: 'storage'
         }
-      }
-    };
+      };
+    }
 
     const response = await this.client.post('/content', pageData);
     return response.data;
@@ -1238,18 +1241,9 @@ class ConfluenceClient {
   /**
    * Create a new Confluence page as a child of another page
    */
-  async createChildPage(title, spaceKey, parentId, content, format = 'storage') {
-    let storageContent = content;
-    
-    if (format === 'markdown') {
-      storageContent = this.markdownToStorage(content);
-    } else if (format === 'html') {
-      // Convert HTML directly to storage format (no macro wrapper)
-      storageContent = content;
-    }
-
+  async createChildPage(title, spaceKey, parentId, content, format = 'storage', type = 'page') {
     const pageData = {
-      type: 'page',
+      type: type,
       title: title,
       space: {
         key: spaceKey
@@ -1258,14 +1252,26 @@ class ConfluenceClient {
         {
           id: parentId
         }
-      ],
-      body: {
+      ]
+    };
+
+    if (type !== 'folder') {
+      let storageContent = content;
+
+      if (format === 'markdown') {
+        storageContent = this.markdownToStorage(content);
+      } else if (format === 'html') {
+        // Convert HTML directly to storage format (no macro wrapper)
+        storageContent = content;
+      }
+
+      pageData.body = {
         storage: {
           value: storageContent,
           representation: 'storage'
         }
-      }
-    };
+      };
+    }
 
     const response = await this.client.post('/content', pageData);
     return response.data;

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "confluence-cli",
-  "version": "2.1.12",
+  "version": "2.3.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "confluence-cli",
-      "version": "2.1.12",
+      "version": "2.3.0",
       "license": "MIT",
       "dependencies": {
         "axios": "^1.15.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "confluence-cli",
-  "version": "2.1.12",
+  "version": "2.3.0",
   "description": "A command-line interface for Atlassian Confluence with page creation and editing capabilities",
   "main": "index.js",
   "bin": {

package/plugins/confluence/skills/confluence/SKILL.md

@@ -221,7 +221,7 @@ confluence search --cql 'siteSearch ~ "deployment pipeline" and space = "MYSPACE
 
 ### `spaces`
 
-List all accessible Confluence spaces (key and name).
+List accessible Confluence spaces (key and name).
 
 ```sh
 confluence spaces
@@ -255,10 +255,10 @@ confluence children 123456789 --recursive --format tree --show-id
 
 ### `create <title> <spaceKey>`
 
-Create a new top-level page in a space.
+Create a new top-level page or folder in a space.
 
 ```sh
-confluence create <title> <spaceKey> [--content <string>] [--file <path>] [--format storage|html|markdown]
+confluence create <title> <spaceKey> [--content <string>] [--file <path>] [--format storage|html|markdown] [--type page|folder]
 ```
 
 | Option | Default | Description |
@@ -266,31 +266,34 @@ confluence create <title> <spaceKey> [--content <string>] [--file <path>] [--for
 | `--content` | — | Inline content string |
 | `--file` | — | Path to content file |
 | `--format` | `storage` | Content format |
+| `--type` | `page` | Content type — `page` (default) or `folder`. Folders have no body. |
 
-Either `--content` or `--file` is required.
+Either `--content` or `--file` is required for pages. Folders take no content — passing `--content` or `--file` with `--type folder` is rejected.
 
 ```sh
 confluence create "Project Overview" MYSPACE --content "# Hello" --format markdown
 confluence create "Release Notes" MYSPACE --file ./notes.md --format markdown
+confluence create "Engineering Docs" MYSPACE --type folder
 ```
 
-Outputs the new page ID and URL on success.
+Outputs the new page (or folder) ID and URL on success.
 
 ---
 
 ### `create-child <title> <parentId>`
 
-Create a child page under an existing page. Inherits the parent's space automatically.
+Create a child page or folder under an existing page. Inherits the parent's space automatically.
 
 ```sh
-confluence create-child <title> <parentId> [--content <string>] [--file <path>] [--format storage|html|markdown]
+confluence create-child <title> <parentId> [--content <string>] [--file <path>] [--format storage|html|markdown] [--type page|folder]
 ```
 
-Options are identical to `create`. Either `--content` or `--file` is required.
+Options are identical to `create`. Either `--content` or `--file` is required for pages; folders take no content.
 
 ```sh
 confluence create-child "Chapter 1" 123456789 --content "Content here" --format markdown
 confluence create-child "API Guide" 123456789 --file ./api.md --format markdown
+confluence create-child "Sub-folder" 123456789 --type folder
 ```
 
 ---