confluence-cli 1.0.0 → 1.2.0

package/.github/ISSUE_TEMPLATE/feedback.md

@@ -0,0 +1,37 @@
+---
+name: General Feedback
+about: Share your thoughts, suggestions, or general feedback about confluence-cli
+title: '[FEEDBACK] '
+labels: feedback, enhancement
+assignees: ''
+
+---
+
+## 📝 Your Feedback
+
+Thank you for taking the time to share your thoughts about confluence-cli!
+
+### What did you try to accomplish?
+A clear description of what you were trying to do with confluence-cli.
+
+### How was your experience?
+Tell us about your experience using the tool:
+- What worked well?
+- What was confusing or difficult?
+- What features are you missing?
+
+### Your environment
+- OS: [e.g. macOS, Windows, Linux]
+- Node.js version: [e.g. 18.17.0]
+- confluence-cli version: [e.g. 1.0.1]
+- Confluence instance: [e.g. Cloud, Server, Data Center]
+
+### Feature requests or improvements
+What would make confluence-cli more useful for you?
+
+### Additional context
+Anything else you'd like to share about your experience with confluence-cli?
+
+---
+
+💡 **Tip**: You can also join our [Discussions](https://github.com/pchuri/confluence-cli/discussions) for general questions and community chat!

package/.github/workflows/ci.yml

@@ -38,15 +38,24 @@ jobs:
     needs: [test, security]
     runs-on: ubuntu-latest
     if: github.ref == 'refs/heads/main'
+    permissions:
+      contents: write
+      issues: write
+      pull-requests: write
     
     steps:
     - uses: actions/checkout@v3
+      with:
+        fetch-depth: 0
+        token: ${{ secrets.GITHUB_TOKEN }}
     
     - name: Setup Node.js
       uses: actions/setup-node@v3
       with:
         node-version: '18'
         registry-url: 'https://registry.npmjs.org'
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
     
     - run: npm ci
     - run: npm test
@@ -55,4 +64,4 @@ jobs:
       uses: cycjimmy/semantic-release-action@v3
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/CHANGELOG.md

@@ -1,3 +1,53 @@
+# [1.2.0](https://github.com/pchuri/confluence-cli/compare/v1.1.0...v1.2.0) (2025-06-27)
+
+
+### Features
+
+* implement page creation and update capabilities ([#2](https://github.com/pchuri/confluence-cli/issues/2)) ([b814ddf](https://github.com/pchuri/confluence-cli/commit/b814ddfd056aeac83cc7eb5d8d6db47ba9c70cdf))
+
+# [1.2.0](https://github.com/pchuri/confluence-cli/compare/v1.1.0...v1.2.0) (2025-06-27)
+
+
+### Features
+
+* **page management**: add page creation and update capabilities ([NEW])
+  - `confluence create` - Create new pages with support for Markdown, HTML, and Storage formats
+  - `confluence update` - Update existing page content and titles
+  - `confluence edit` - Export page content for editing workflow
+  - Support for reading content from files or inline
+  - Markdown to Confluence Storage format conversion
+* **content formats**: support multiple input formats
+  - Markdown format with automatic conversion
+  - HTML format with Storage format wrapping
+  - Native Confluence Storage format
+* **examples**: add sample files and demo scripts for new features
+
+### Breaking Changes
+
+* None - all new features are additive
+
+# [1.1.0](https://github.com/pchuri/confluence-cli/compare/v1.0.0...v1.1.0) (2025-06-26)
+
+
+### Features
+
+* add analytics tracking to spaces command ([265e8f4](https://github.com/pchuri/confluence-cli/commit/265e8f42b5ba86fb50398e8b1fcfd1d85fcc54d9))
+* add community feedback and analytics infrastructure ([a7ff6e8](https://github.com/pchuri/confluence-cli/commit/a7ff6e87cdc92d98f3d927ee98fac9e33aedbaae))
+
+# 1.0.0 (2025-06-26)
+
+
+### Bug Fixes
+
+* add explicit permissions for GitHub Actions ([fa36b29](https://github.com/pchuri/confluence-cli/commit/fa36b2974b1261c144a415ced324383b35a938fb))
+* add NODE_AUTH_TOKEN for npm authentication ([2031314](https://github.com/pchuri/confluence-cli/commit/2031314ad01fc1d9b4f9557a3d1321a046cad8f3))
+* resolve eslint errors and npm publish warnings ([b93285e](https://github.com/pchuri/confluence-cli/commit/b93285ee098d96c8b750dbf2be5a93f28f44706c))
+
+
+### Features
+
+* initial release of confluence-cli ([ec04e06](https://github.com/pchuri/confluence-cli/commit/ec04e06bb0c785dcff84dabcafeeb60bf9e1658f))
+
 # Confluence CLI Changelog
 
 All notable changes to this project will be documented in this file.

package/README.md

@@ -8,6 +8,9 @@ A powerful command-line interface for Atlassian Confluence that allows you to re
 - 🔍 **Search** - Find pages using Confluence's powerful search
 - ℹ️ **Page info** - Get detailed information about pages
 - 🏠 **List spaces** - View all available Confluence spaces
+- ✏️ **Create pages** - Create new pages with support for Markdown, HTML, or Storage format
+- 📝 **Update pages** - Update existing page content and titles
+- 🛠️ **Edit workflow** - Export page content for editing and re-import
 - 🔧 **Easy setup** - Simple configuration with environment variables or interactive setup
 
 ## Installation
@@ -38,6 +41,16 @@ npx confluence-cli
    confluence search "my search term"
    ```
 
+4. **Create a new page:**
+   ```bash
+   confluence create "My New Page" SPACEKEY --content "Hello World!"
+   ```
+
+5. **Update a page:**
+   ```bash
+   confluence update 123456789 --content "Updated content"
+   ```
+
 ## Configuration
 
 ### Option 1: Interactive Setup
@@ -65,6 +78,79 @@ export CONFLUENCE_API_TOKEN="your-api-token"
 # Read by page ID
 confluence read 123456789
 
+# Read in HTML format
+confluence read 123456789 --format html
+
+# Read by URL
+confluence read "https://your-domain.atlassian.net/wiki/spaces/SPACE/pages/123456789/Page+Title"
+```
+
+### Create a New Page
+```bash
+# Create with inline content
+confluence create "My New Page" SPACEKEY --content "This is my page content"
+
+# Create from a file
+confluence create "Documentation" SPACEKEY --file ./content.md --format markdown
+
+# Create with HTML content
+confluence create "Rich Content" SPACEKEY --file ./content.html --format html
+
+# Create with Storage format (Confluence native)
+confluence create "Advanced Page" SPACEKEY --file ./content.xml --format storage
+```
+
+### Create a Child Page
+```bash
+# Find parent page first
+confluence find "Project Documentation" --space MYTEAM
+
+# Create child page with inline content
+confluence create-child "Meeting Notes" 123456789 --content "This is a child page"
+
+# Create child page from file
+confluence create-child "Technical Specifications" 123456789 --file ./content.md --format markdown
+
+# Create child page with HTML content
+confluence create-child "Report Summary" 123456789 --file ./content.html --format html
+```
+
+### Find Pages
+```bash
+# Find page by title
+confluence find "Project Documentation"
+
+# Find page by title in specific space
+confluence find "Project Documentation" --space MYTEAM
+```
+
+### Update an Existing Page
+```bash
+# Update content only
+confluence update 123456789 --content "Updated content"
+
+# Update content from file
+confluence update 123456789 --file ./updated-content.md --format markdown
+
+# Update both title and content
+confluence update 123456789 --title "New Title" --content "New content"
+
+# Update from HTML file
+confluence update 123456789 --file ./content.html --format html
+```
+
+### Edit Workflow
+```bash
+# Export page content for editing
+confluence edit 123456789 --output ./page-content.xml
+
+# Edit the file with your preferred editor
+vim ./page-content.xml
+
+# Update the page with your changes
+confluence update 123456789 --file ./page-content.xml --format storage
+```
+
 # Read with HTML format
 confluence read 123456789 --format html
 
@@ -91,6 +177,11 @@ confluence search "search term" --limit 5
 confluence spaces
 ```
 
+### View Usage Statistics
+```bash
+confluence stats
+```
+
 ## Commands
 
 | Command | Description | Options |
@@ -100,6 +191,7 @@ confluence spaces
 | `info <pageId>` | Get page information | - |
 | `search <query>` | Search for pages | `--limit <number>` |
 | `spaces` | List all spaces | - |
+| `stats` | View your usage statistics | - |
 
 ## Examples
 
@@ -121,6 +213,9 @@ confluence search "API documentation" --limit 3
 
 # List all spaces
 confluence spaces
+
+# View usage statistics
+confluence stats
 ```
 
 ## Development
@@ -157,7 +252,7 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ## Roadmap
 
-- [ ] Create and update pages
+- [x] **Create and update pages** ✅
 - [ ] Page templates
 - [ ] Bulk operations
 - [ ] Export pages to different formats
@@ -165,13 +260,36 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 - [ ] Page attachments management
 - [ ] Comments and reviews
 
-## Support
+## Support & Feedback
+
+### 💬 We'd love to hear from you!
 
-If you encounter any issues or have questions:
+Your feedback helps make confluence-cli better for everyone. Here's how you can share your thoughts:
 
+#### 🐛 Found a bug?
 1. Check the [Issues](https://github.com/pchuri/confluence-cli/issues) page
-2. Create a new issue if your problem isn't already reported
-3. Provide detailed information about your environment and the issue
+2. Create a new [bug report](https://github.com/pchuri/confluence-cli/issues/new?template=bug_report.md)
+
+#### 💡 Have a feature idea?
+1. Create a [feature request](https://github.com/pchuri/confluence-cli/issues/new?template=feature_request.md)
+2. Join our [Discussions](https://github.com/pchuri/confluence-cli/discussions) to chat with the community
+
+#### 📝 General feedback?
+- Share your experience with a [feedback issue](https://github.com/pchuri/confluence-cli/issues/new?template=feedback.md)
+- Rate us on [NPM](https://www.npmjs.com/package/confluence-cli)
+- Star the repo if you find it useful! ⭐
+
+#### 🤝 Want to contribute?
+Check out our [Contributing Guide](CONTRIBUTING.md) - all contributions are welcome!
+
+### 📈 Usage Analytics
+
+To help us understand how confluence-cli is being used and improve it, we collect anonymous usage statistics. This includes:
+- Command usage frequency (no personal data)
+- Error patterns (to fix bugs faster)
+- Feature adoption metrics
+
+You can opt-out anytime by setting: `export CONFLUENCE_CLI_ANALYTICS=false`
 
 ---
 

package/bin/confluence.js

@@ -4,6 +4,7 @@ const { program } = require('commander');
 const chalk = require('chalk');
 const ConfluenceClient = require('../lib/confluence-client');
 const { getConfig, initConfig } = require('../lib/config');
+const Analytics = require('../lib/analytics');
 
 program
   .name('confluence')
@@ -24,12 +25,15 @@ program
   .description('Read a Confluence page by ID or URL')
   .option('-f, --format <format>', 'Output format (html, text)', 'text')
   .action(async (pageId, options) => {
+    const analytics = new Analytics();
     try {
       const config = getConfig();
       const client = new ConfluenceClient(config);
       const content = await client.readPage(pageId, options.format);
       console.log(content);
+      analytics.track('read', true);
     } catch (error) {
+      analytics.track('read', false);
       console.error(chalk.red('Error:'), error.message);
       process.exit(1);
     }
@@ -40,6 +44,7 @@ program
   .command('info <pageId>')
   .description('Get information about a Confluence page')
   .action(async (pageId) => {
+    const analytics = new Analytics();
     try {
       const config = getConfig();
       const client = new ConfluenceClient(config);
@@ -52,7 +57,9 @@ program
       if (info.space) {
         console.log(`Space: ${chalk.green(info.space.name)} (${info.space.key})`);
       }
+      analytics.track('info', true);
     } catch (error) {
+      analytics.track('info', false);
       console.error(chalk.red('Error:'), error.message);
       process.exit(1);
     }
@@ -64,6 +71,7 @@ program
   .description('Search for Confluence pages')
   .option('-l, --limit <limit>', 'Limit number of results', '10')
   .action(async (query, options) => {
+    const analytics = new Analytics();
     try {
       const config = getConfig();
       const client = new ConfluenceClient(config);
@@ -71,6 +79,7 @@ program
       
       if (results.length === 0) {
         console.log(chalk.yellow('No results found.'));
+        analytics.track('search', true);
         return;
       }
 
@@ -81,7 +90,9 @@ program
           console.log(`   ${chalk.gray(result.excerpt)}`);
         }
       });
+      analytics.track('search', true);
     } catch (error) {
+      analytics.track('search', false);
       console.error(chalk.red('Error:'), error.message);
       process.exit(1);
     }
@@ -92,6 +103,7 @@ program
   .command('spaces')
   .description('List all Confluence spaces')
   .action(async () => {
+    const analytics = new Analytics();
     try {
       const config = getConfig();
       const client = new ConfluenceClient(config);
@@ -101,7 +113,221 @@ program
       spaces.forEach(space => {
         console.log(`${chalk.green(space.key)} - ${space.name}`);
       });
+      analytics.track('spaces', true);
     } catch (error) {
+      analytics.track('spaces', false);
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Stats command
+program
+  .command('stats')
+  .description('Show usage statistics')
+  .action(async () => {
+    try {
+      const analytics = new Analytics();
+      analytics.showStats();
+    } catch (error) {
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Create command
+program
+  .command('create <title> <spaceKey>')
+  .description('Create a new Confluence 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')
+  .action(async (title, spaceKey, options) => {
+    const analytics = new Analytics();
+    try {
+      const config = getConfig();
+      const client = new ConfluenceClient(config);
+      
+      let content = '';
+      
+      if (options.file) {
+        const fs = require('fs');
+        if (!fs.existsSync(options.file)) {
+          throw new Error(`File not found: ${options.file}`);
+        }
+        content = fs.readFileSync(options.file, 'utf8');
+      } else if (options.content) {
+        content = options.content;
+      } else {
+        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!'));
+      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})`);
+      console.log(`URL: ${chalk.gray(`https://${config.domain}/wiki${result._links.webui}`)}`);
+      
+      analytics.track('create', true);
+    } catch (error) {
+      analytics.track('create', false);
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Create child page command
+program
+  .command('create-child <title> <parentId>')
+  .description('Create a new Confluence page 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')
+  .action(async (title, parentId, options) => {
+    const analytics = new Analytics();
+    try {
+      const config = getConfig();
+      const client = new ConfluenceClient(config);
+      
+      // 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)) {
+          throw new Error(`File not found: ${options.file}`);
+        }
+        content = fs.readFileSync(options.file, 'utf8');
+      } else if (options.content) {
+        content = options.content;
+      } else {
+        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!'));
+      console.log(`Title: ${chalk.blue(result.title)}`);
+      console.log(`ID: ${chalk.blue(result.id)}`);
+      console.log(`Parent: ${chalk.blue(parentInfo.title)} (${parentId})`);
+      console.log(`Space: ${chalk.blue(result.space.name)} (${result.space.key})`);
+      console.log(`URL: ${chalk.gray(`https://${config.domain}/wiki${result._links.webui}`)}`);
+      
+      analytics.track('create_child', true);
+    } catch (error) {
+      analytics.track('create_child', false);
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Update command
+program
+  .command('update <pageId>')
+  .description('Update an existing Confluence page')
+  .option('-t, --title <title>', 'New page title (optional)')
+  .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')
+  .action(async (pageId, options) => {
+    const analytics = new Analytics();
+    try {
+      const config = getConfig();
+      const client = new ConfluenceClient(config);
+      
+      let content = '';
+      
+      if (options.file) {
+        const fs = require('fs');
+        if (!fs.existsSync(options.file)) {
+          throw new Error(`File not found: ${options.file}`);
+        }
+        content = fs.readFileSync(options.file, 'utf8');
+      } else if (options.content) {
+        content = options.content;
+      } else {
+        throw new Error('Either --file or --content option is required');
+      }
+      
+      const result = await client.updatePage(pageId, options.title, content, options.format);
+      
+      console.log(chalk.green('✅ Page updated successfully!'));
+      console.log(`Title: ${chalk.blue(result.title)}`);
+      console.log(`ID: ${chalk.blue(result.id)}`);
+      console.log(`Version: ${chalk.blue(result.version.number)}`);
+      console.log(`URL: ${chalk.gray(`https://${config.domain}/wiki${result._links.webui}`)}`);
+      
+      analytics.track('update', true);
+    } catch (error) {
+      analytics.track('update', false);
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Edit command - opens page content for editing
+program
+  .command('edit <pageId>')
+  .description('Get page content for editing')
+  .option('-o, --output <file>', 'Save content to file')
+  .action(async (pageId, options) => {
+    const analytics = new Analytics();
+    try {
+      const config = getConfig();
+      const client = new ConfluenceClient(config);
+      const pageData = await client.getPageForEdit(pageId);
+      
+      console.log(chalk.blue('Page Information:'));
+      console.log(`Title: ${chalk.green(pageData.title)}`);
+      console.log(`ID: ${chalk.green(pageData.id)}`);
+      console.log(`Version: ${chalk.green(pageData.version)}`);
+      console.log(`Space: ${chalk.green(pageData.space.name)} (${pageData.space.key})`);
+      console.log('');
+      
+      if (options.output) {
+        const fs = require('fs');
+        fs.writeFileSync(options.output, pageData.content);
+        console.log(chalk.green(`✅ Content saved to: ${options.output}`));
+        console.log(chalk.yellow('💡 Edit the file and use "confluence update" to save changes'));
+      } else {
+        console.log(chalk.blue('Page Content:'));
+        console.log(pageData.content);
+      }
+      
+      analytics.track('edit', true);
+    } catch (error) {
+      analytics.track('edit', false);
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Find page by title command
+program
+  .command('find <title>')
+  .description('Find a page by title')
+  .option('-s, --space <spaceKey>', 'Limit search to specific space')
+  .action(async (title, options) => {
+    const analytics = new Analytics();
+    try {
+      const config = getConfig();
+      const client = new ConfluenceClient(config);
+      const pageInfo = await client.findPageByTitle(title, options.space);
+      
+      console.log(chalk.blue('Page found:'));
+      console.log(`Title: ${chalk.green(pageInfo.title)}`);
+      console.log(`ID: ${chalk.green(pageInfo.id)}`);
+      console.log(`Space: ${chalk.green(pageInfo.space.name)} (${pageInfo.space.key})`);
+      console.log(`URL: ${chalk.gray(`https://${config.domain}/wiki${pageInfo.url}`)}`);
+      
+      analytics.track('find', true);
+    } catch (error) {
+      analytics.track('find', false);
       console.error(chalk.red('Error:'), error.message);
       process.exit(1);
     }

package/docs/PROMOTION.md

@@ -0,0 +1,63 @@
+# GitHub Repository Topics
+
+When setting up your GitHub repository, add these topics for better discoverability:
+
+## Suggested Topics:
+- `confluence`
+- `atlassian`
+- `cli`
+- `command-line`
+- `wiki`
+- `documentation`
+- `nodejs`
+- `javascript`
+- `api-client`
+- `automation`
+- `developer-tools`
+- `productivity`
+
+## How to add topics:
+1. Go to https://github.com/pchuri/confluence-cli
+2. Click the ⚙️ gear icon next to "About"
+3. Add the topics above in the "Topics" field
+4. Add a description: "A powerful command-line interface for Atlassian Confluence"
+5. Add website: https://www.npmjs.com/package/confluence-cli
+
+## Social Media Promotion Ideas:
+
+### Twitter/X Posts:
+```
+🚀 Just released confluence-cli v1.0! 
+
+A powerful CLI tool for @Atlassian Confluence:
+✅ Read pages from terminal
+✅ Search documentation  
+✅ List spaces
+✅ Works with environment variables
+
+Perfect for automation & DevOps workflows!
+
+#CLI #Confluence #DevTools #OpenSource
+https://github.com/pchuri/confluence-cli
+```
+
+### LinkedIn Post:
+```
+Excited to share my latest open-source project: confluence-cli! 🎉
+
+As someone who works with Confluence daily, I built this CLI tool to streamline documentation workflows. Now you can:
+
+• Read Confluence pages from your terminal
+• Search across your wiki content
+• Integrate with CI/CD pipelines
+• Automate documentation tasks
+
+Available on NPM and fully open-source. Would love your feedback!
+
+#OpenSource #CLI #Confluence #DevTools #Automation
+```
+
+### Dev.to Article Ideas:
+1. "Building a CLI Tool for Confluence: From Bash Functions to NPM Package"
+2. "How to Automate Your Documentation Workflow with Confluence CLI"
+3. "Open Source Journey: Lessons Learned Building confluence-cli"

package/examples/create-child-page-example.sh

@@ -0,0 +1,65 @@
+#!/bin/bash
+
+# 실제 Project Documentation 페이지 하위에 테스트 페이지 생성 예제
+# 이 스크립트는 일반적인 Confluence 설정에서 작동합니다.
+
+echo "🔍 Project Documentation 페이지 하위에 테스트 페이지 생성"
+echo "=============================================================="
+
+# 1단계: 부모 페이지 찾기
+echo ""
+echo "1️⃣ 부모 페이지 찾기..."
+echo "실행: confluence find \"Project Documentation\" --space MYTEAM"
+echo ""
+
+# 실제 실행할 때는 아래 주석을 해제하세요
+# confluence find "Project Documentation" --space MYTEAM
+
+echo "📝 위 명령어 결과에서 페이지 ID를 확인하세요 (예: 123456789)"
+echo ""
+
+# 2단계: 페이지 정보 확인
+echo "2️⃣ 페이지 정보 확인..."
+echo "실행: confluence info [페이지ID]"
+echo "예시: confluence info 123456789"
+echo ""
+
+# 3단계: 페이지 내용 읽기 (선택사항)
+echo "3️⃣ 페이지 내용 확인 (선택사항)..."
+echo "실행: confluence read [페이지ID] | head -20"
+echo "예시: confluence read 123456789 | head -20"
+echo ""
+
+# 4단계: 테스트 페이지 생성
+echo "4️⃣ 하위 테스트 페이지 생성..."
+echo ""
+
+# 간단한 텍스트 콘텐츠로 테스트 페이지 생성
+echo "📄 방법 1: 간단한 텍스트 콘텐츠로 생성"
+echo 'confluence create-child "Test Page - $(date +%Y%m%d)" [부모페이지ID] --content "이것은 CLI로 생성된 테스트 페이지입니다. 생성 시간: $(date)"'
+echo ""
+
+# 마크다운 파일에서 테스트 페이지 생성
+echo "📄 방법 2: 마크다운 파일에서 생성"
+echo "confluence create-child \"Test Documentation - $(date +%Y%m%d)\" [부모페이지ID] --file ./sample-page.md --format markdown"
+echo ""
+
+# HTML 콘텐츠로 생성
+echo "📄 방법 3: HTML 콘텐츠로 생성"
+echo 'confluence create-child "Test HTML Page" [부모페이지ID] --content "<h1>테스트 페이지</h1><p>이것은 <strong>HTML</strong>로 작성된 테스트 페이지입니다.</p>" --format html'
+echo ""
+
+echo "💡 실제 사용 예제:"
+echo "=============================="
+echo "# 1. 부모 페이지 ID 찾기"
+echo 'PARENT_ID=$(confluence find "Project Documentation" --space MYTEAM | grep "ID:" | cut -d" " -f2)'
+echo ""
+echo "# 2. 테스트 페이지 생성"
+echo 'confluence create-child "테스트 페이지 - $(date +%Y%m%d_%H%M)" $PARENT_ID --content "CLI 테스트용 페이지입니다."'
+echo ""
+
+echo "⚠️  주의사항:"
+echo "- confluence CLI가 올바르게 설정되어 있어야 합니다 (confluence init)"
+echo "- 해당 Confluence 인스턴스에 대한 적절한 권한이 있어야 합니다"
+echo "- 페이지 생성 권한이 있는지 확인하세요"
+echo "- 테스트 후에는 불필요한 페이지를 정리하세요"

package/examples/demo-page-management.sh

@@ -0,0 +1,68 @@
+#!/bin/bash
+
+# Confluence CLI Demo Script
+# This script demonstrates the new page creation and update features
+
+echo "🚀 Confluence CLI - Page Creation Demo"
+echo "======================================"
+
+# Note: Replace with your actual space key and ensure you have confluence-cli configured
+SPACE_KEY="MYTEAM"  # Change this to your space key
+
+echo ""
+echo "1. Creating a page from Markdown file..."
+echo "confluence create \"Sample Page from CLI\" $SPACE_KEY --file ./sample-page.md --format markdown"
+
+echo ""
+echo "2. Creating a page with inline content..."
+echo "confluence create \"Quick Note\" $SPACE_KEY --content \"This is a quick note created from the CLI\" --format storage"
+
+echo ""
+echo "3. Updating a page (replace 123456789 with actual page ID)..."
+echo "confluence update 123456789 --content \"This page has been updated via CLI\""
+
+echo ""
+echo "4. Getting page content for editing..."
+echo "confluence edit 123456789 --output ./page-backup.xml"
+
+echo ""
+echo "5. Searching for pages..."
+echo "confluence search \"CLI\""
+
+echo ""
+echo "6. Listing all spaces..."
+echo "confluence spaces"
+
+echo ""
+echo "7. Finding a page by title..."
+echo "confluence find \"Project Documentation\" --space MYTEAM"
+
+echo ""
+echo "8. Creating a child page under a parent page..."
+echo "confluence create-child \"Test Page\" 123456789 --content \"This is a test page created as a child\""
+
+echo ""
+echo "9. Creating a child page from Markdown file..."
+echo "confluence create-child \"Test Documentation\" 123456789 --file ./sample-page.md --format markdown"
+
+echo ""
+echo "💡 Tips:"
+echo "- Use --format markdown to create pages from Markdown files"
+echo "- Use --format html for HTML content"
+echo "- Use --format storage for Confluence native format"
+echo "- Always backup important pages before updating"
+echo "- Use 'confluence find' to get page IDs by title"
+echo "- Child pages inherit permissions from their parent"
+
+echo ""
+echo "📝 Edit workflow:"
+echo "1. confluence edit [pageId] --output page.xml"
+echo "2. Edit the file with your preferred editor"
+echo "3. confluence update [pageId] --file page.xml --format storage"
+
+echo ""
+echo "🔍 Finding and creating child pages workflow:"
+echo "1. confluence find \"Project Documentation\" --space MYTEAM"
+echo "2. Note the page ID from the result"
+echo "3. confluence create-child \"Meeting Notes\" [parentId] --content \"Child content\""
+echo "4. Or use: confluence create-child \"Technical Docs\" [parentId] --file ./content.md --format markdown"

package/examples/sample-page.md

@@ -0,0 +1,30 @@
+# Welcome to Confluence CLI
+
+This is a sample page created using the **Confluence CLI** tool.
+
+## Features
+
+- Easy page creation from Markdown files
+- Support for multiple content formats
+- Command-line interface for automation
+
+## Code Example
+
+```javascript
+const client = new ConfluenceClient(config);
+await client.createPage('My Page', 'SPACE', content, 'markdown');
+```
+
+## Lists
+
+1. First item
+2. Second item
+3. Third item
+
+- Bullet point one
+- Bullet point two
+- Bullet point three
+
+---
+
+*Created with ❤️ using confluence-cli*

package/lib/analytics.js

@@ -0,0 +1,87 @@
+const os = require('os');
+const path = require('path');
+const fs = require('fs');
+
+/**
+ * Simple anonymous usage analytics
+ * Helps understand which features are most used
+ */
+class Analytics {
+  constructor() {
+    this.enabled = process.env.CONFLUENCE_CLI_ANALYTICS !== 'false';
+    this.configDir = path.join(os.homedir(), '.confluence-cli');
+    this.statsFile = path.join(this.configDir, 'stats.json');
+  }
+
+  /**
+   * Track command usage (anonymous)
+   */
+  track(command, success = true) {
+    if (!this.enabled) return;
+
+    try {
+      let stats = {};
+      
+      // Read existing stats
+      if (fs.existsSync(this.statsFile)) {
+        stats = JSON.parse(fs.readFileSync(this.statsFile, 'utf8'));
+      }
+
+      // Initialize stats structure
+      if (!stats.commands) stats.commands = {};
+      if (!stats.firstUsed) stats.firstUsed = new Date().toISOString();
+      stats.lastUsed = new Date().toISOString();
+
+      // Track command usage
+      const commandKey = `${command}_${success ? 'success' : 'error'}`;
+      stats.commands[commandKey] = (stats.commands[commandKey] || 0) + 1;
+
+      // Create directory if it doesn't exist
+      if (!fs.existsSync(this.configDir)) {
+        fs.mkdirSync(this.configDir, { recursive: true });
+      }
+
+      // Save stats
+      fs.writeFileSync(this.statsFile, JSON.stringify(stats, null, 2));
+    } catch (error) {
+      // Silently fail - analytics should never break the main functionality
+    }
+  }
+
+  /**
+   * Get usage statistics
+   */
+  getStats() {
+    if (!fs.existsSync(this.statsFile)) {
+      return null;
+    }
+
+    try {
+      return JSON.parse(fs.readFileSync(this.statsFile, 'utf8'));
+    } catch (error) {
+      return null;
+    }
+  }
+
+  /**
+   * Show usage stats to user
+   */
+  showStats() {
+    const stats = this.getStats();
+    if (!stats) {
+      console.log('No usage statistics available.');
+      return;
+    }
+
+    console.log('📊 Usage Statistics:');
+    console.log(`First used: ${new Date(stats.firstUsed).toLocaleDateString()}`);
+    console.log(`Last used: ${new Date(stats.lastUsed).toLocaleDateString()}`);
+    console.log('\nCommand usage:');
+    
+    Object.entries(stats.commands).forEach(([command, count]) => {
+      console.log(`  ${command}: ${count} times`);
+    });
+  }
+}
+
+module.exports = Analytics;

package/lib/confluence-client.js

@@ -1,11 +1,13 @@
 const axios = require('axios');
 const { convert } = require('html-to-text');
+const MarkdownIt = require('markdown-it');
 
 class ConfluenceClient {
   constructor(config) {
     this.baseURL = `https://${config.domain}/rest/api`;
     this.token = config.token;
     this.domain = config.domain;
+    this.markdown = new MarkdownIt();
     
     this.client = axios.create({
       baseURL: this.baseURL,
@@ -132,6 +134,187 @@ class ConfluenceClient {
       type: space.type
     }));
   }
+
+  /**
+   * Convert markdown to Confluence storage format
+   */
+  markdownToStorage(markdown) {
+    // Convert markdown to HTML first
+    const html = this.markdown.render(markdown);
+    
+    // Basic conversion to Confluence storage format
+    // This is a simplified version - Confluence has a specific storage format
+    return `<ac:structured-macro ac:name="html">
+      <ac:parameter ac:name="atlassian-macro-output-type">BLOCK</ac:parameter>
+      <ac:plain-text-body><![CDATA[${html}]]></ac:plain-text-body>
+    </ac:structured-macro>`;
+  }
+
+  /**
+   * 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') {
+      // Wrap HTML in storage format
+      storageContent = `<ac:structured-macro ac:name="html">
+        <ac:parameter ac:name="atlassian-macro-output-type">BLOCK</ac:parameter>
+        <ac:plain-text-body><![CDATA[${content}]]></ac:plain-text-body>
+      </ac:structured-macro>`;
+    }
+
+    const pageData = {
+      type: 'page',
+      title: title,
+      space: {
+        key: spaceKey
+      },
+      body: {
+        storage: {
+          value: storageContent,
+          representation: 'storage'
+        }
+      }
+    };
+
+    const response = await this.client.post('/content', pageData);
+    return response.data;
+  }
+
+  /**
+   * 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') {
+      // Wrap HTML in storage format
+      storageContent = `<ac:structured-macro ac:name="html">
+        <ac:parameter ac:name="atlassian-macro-output-type">BLOCK</ac:parameter>
+        <ac:plain-text-body><![CDATA[${content}]]></ac:plain-text-body>
+      </ac:structured-macro>`;
+    }
+
+    const pageData = {
+      type: 'page',
+      title: title,
+      space: {
+        key: spaceKey
+      },
+      ancestors: [
+        {
+          id: parentId
+        }
+      ],
+      body: {
+        storage: {
+          value: storageContent,
+          representation: 'storage'
+        }
+      }
+    };
+
+    const response = await this.client.post('/content', pageData);
+    return response.data;
+  }
+
+  /**
+   * Update an existing Confluence page
+   */
+  async updatePage(pageId, title, content, format = 'storage') {
+    // First, get the current page to get the version number
+    const currentPage = await this.client.get(`/content/${pageId}`);
+    const currentVersion = currentPage.data.version.number;
+
+    let storageContent = content;
+    
+    if (format === 'markdown') {
+      storageContent = this.markdownToStorage(content);
+    } else if (format === 'html') {
+      // Wrap HTML in storage format
+      storageContent = `<ac:structured-macro ac:name="html">
+        <ac:parameter ac:name="atlassian-macro-output-type">BLOCK</ac:parameter>
+        <ac:plain-text-body><![CDATA[${content}]]></ac:plain-text-body>
+      </ac:structured-macro>`;
+    }
+
+    const pageData = {
+      id: pageId,
+      type: 'page',
+      title: title || currentPage.data.title,
+      space: currentPage.data.space,
+      body: {
+        storage: {
+          value: storageContent,
+          representation: 'storage'
+        }
+      },
+      version: {
+        number: currentVersion + 1
+      }
+    };
+
+    const response = await this.client.put(`/content/${pageId}`, pageData);
+    return response.data;
+  }
+
+  /**
+   * Get page content for editing
+   */
+  async getPageForEdit(pageIdOrUrl) {
+    const pageId = this.extractPageId(pageIdOrUrl);
+    
+    const response = await this.client.get(`/content/${pageId}`, {
+      params: {
+        expand: 'body.storage,version,space'
+      }
+    });
+
+    return {
+      id: response.data.id,
+      title: response.data.title,
+      content: response.data.body.storage.value,
+      version: response.data.version.number,
+      space: response.data.space
+    };
+  }
+
+  /**
+   * Search for a page by title and space
+   */
+  async findPageByTitle(title, spaceKey = null) {
+    let cql = `title = "${title}"`;
+    if (spaceKey) {
+      cql += ` AND space = "${spaceKey}"`;
+    }
+
+    const response = await this.client.get('/search', {
+      params: {
+        cql: cql,
+        limit: 1,
+        expand: 'content.space'
+      }
+    });
+
+    if (response.data.results.length === 0) {
+      throw new Error(`Page not found: "${title}"`);
+    }
+
+    const result = response.data.results[0];
+    const content = result.content || result;
+    
+    return {
+      id: content.id,
+      title: content.title,
+      space: content.space || { key: spaceKey || 'Unknown', name: 'Unknown' },
+      url: content._links?.webui || ''
+    };
+  }
 }
 
 module.exports = ConfluenceClient;

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "confluence-cli",
-  "version": "1.0.0",
-  "description": "A command-line interface for Atlassian Confluence",
+  "version": "1.2.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"
   },
   "scripts": {
     "start": "node bin/confluence.js",
@@ -22,24 +22,25 @@
   "author": "Your Name",
   "license": "MIT",
   "dependencies": {
-    "commander": "^11.1.0",
     "axios": "^1.6.2",
     "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "html-to-text": "^9.0.5",
     "inquirer": "^8.2.6",
-    "ora": "^5.4.1",
-    "html-to-text": "^9.0.5"
+    "markdown-it": "^14.1.0",
+    "ora": "^5.4.1"
   },
   "devDependencies": {
+    "@types/node": "^20.10.0",
     "eslint": "^8.55.0",
-    "jest": "^29.7.0",
-    "@types/node": "^20.10.0"
+    "jest": "^29.7.0"
   },
   "engines": {
     "node": ">=14.0.0"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/pchuri/confluence-cli.git"
+    "url": "git+https://github.com/pchuri/confluence-cli.git"
   },
   "bugs": {
     "url": "https://github.com/pchuri/confluence-cli/issues"

package/tests/confluence-client.test.js

@@ -26,4 +26,25 @@ describe('ConfluenceClient', () => {
       expect(() => client.extractPageId(displayUrl)).toThrow('Display URLs not yet supported');
     });
   });
+
+  describe('markdownToStorage', () => {
+    test('should convert markdown to Confluence storage format', () => {
+      const markdown = '# Hello World\n\nThis is a **test** page.';
+      const result = client.markdownToStorage(markdown);
+      
+      expect(result).toContain('<ac:structured-macro ac:name="html">');
+      expect(result).toContain('<h1>Hello World</h1>');
+      expect(result).toContain('<strong>test</strong>');
+    });
+  });
+
+  describe('page creation and updates', () => {
+    test('should have required methods for page management', () => {
+      expect(typeof client.createPage).toBe('function');
+      expect(typeof client.updatePage).toBe('function');
+      expect(typeof client.getPageForEdit).toBe('function');
+      expect(typeof client.createChildPage).toBe('function');
+      expect(typeof client.findPageByTitle).toBe('function');
+    });
+  });
 });