confluence-cli 1.0.0 → 1.1.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
@@ -56,3 +65,4 @@ jobs:
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/CHANGELOG.md

@@ -1,3 +1,25 @@
+# [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

@@ -91,6 +91,11 @@ confluence search "search term" --limit 5
 confluence spaces
 ```
 
+### View Usage Statistics
+```bash
+confluence stats
+```
+
 ## Commands
 
 | Command | Description | Options |
@@ -100,6 +105,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 +127,9 @@ confluence search "API documentation" --limit 3
 
 # List all spaces
 confluence spaces
+
+# View usage statistics
+confluence stats
 ```
 
 ## Development
@@ -165,13 +174,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,6 +113,22 @@ 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);

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/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/package.json

@@ -1,10 +1,10 @@
 {
   "name": "confluence-cli",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "A command-line interface for Atlassian Confluence",
   "main": "index.js",
   "bin": {
-    "confluence": "./bin/index.js"
+    "confluence": "bin/index.js"
   },
   "scripts": {
     "start": "node bin/confluence.js",
@@ -39,7 +39,7 @@
   },
   "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"