confluence-cli 1.0.0

package/.eslintrc.js

@@ -0,0 +1,23 @@
+module.exports = {
+  env: {
+    es2021: true,
+    node: true,
+    jest: true
+  },
+  extends: [
+    'eslint:recommended'
+  ],
+  parserOptions: {
+    ecmaVersion: 12,
+    sourceType: 'module'
+  },
+  rules: {
+    'indent': ['error', 2],
+    'linebreak-style': ['error', 'unix'],
+    'quotes': ['error', 'single'],
+    'semi': ['error', 'always'],
+    'no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+    'no-console': 'off',
+    'no-process-exit': 'off'
+  }
+};

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,34 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: '[BUG] '
+labels: bug
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Run command '...'
+2. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Environment (please complete the following information):**
+ - OS: [e.g. macOS, Windows, Linux]
+ - Node.js version: [e.g. 18.17.0]
+ - confluence-cli version: [e.g. 1.0.0]
+ - Confluence version: [e.g. Cloud, Server 8.5]
+
+**Additional context**
+Add any other context about the problem here.
+
+**Error logs**
+If applicable, add error logs or stack traces.

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,26 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: '[FEATURE] '
+labels: enhancement
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Use case**
+Describe how this feature would be used and who would benefit from it.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.
+
+**Implementation suggestions**
+If you have ideas about how this could be implemented, please share them here.

package/.github/pull_request_template.md

@@ -0,0 +1,31 @@
+## Pull Request Template
+
+### Description
+Brief description of what this PR does.
+
+### Type of Change
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+- [ ] Performance improvement
+- [ ] Code refactoring
+
+### Testing
+- [ ] Tests pass locally with my changes
+- [ ] I have added tests that prove my fix is effective or that my feature works
+- [ ] New and existing unit tests pass locally with my changes
+
+### Checklist
+- [ ] My code follows the style guidelines of this project
+- [ ] I have performed a self-review of my own code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings
+- [ ] Any dependent changes have been merged and published in downstream modules
+
+### Screenshots (if applicable)
+Add screenshots to help explain your changes.
+
+### Additional Context
+Add any other context about the pull request here.

package/.github/workflows/ci.yml

@@ -0,0 +1,58 @@
+name: CI/CD
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    
+    strategy:
+      matrix:
+        node-version: [16.x, 18.x, 20.x]
+    
+    steps:
+    - uses: actions/checkout@v3
+    
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v3
+      with:
+        node-version: ${{ matrix.node-version }}
+        cache: 'npm'
+    
+    - run: npm ci
+    - run: npm run lint
+    - run: npm test
+    
+  security:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+    - name: Run npm audit
+      run: npm audit --audit-level moderate
+
+  publish:
+    needs: [test, security]
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main'
+    
+    steps:
+    - uses: actions/checkout@v3
+    
+    - name: Setup Node.js
+      uses: actions/setup-node@v3
+      with:
+        node-version: '18'
+        registry-url: 'https://registry.npmjs.org'
+    
+    - run: npm ci
+    - run: npm test
+    
+    - name: Semantic Release
+      uses: cycjimmy/semantic-release-action@v3
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.releaserc

@@ -0,0 +1,17 @@
+{
+  "branches": ["main"],
+  "plugins": [
+    "@semantic-release/commit-analyzer",
+    "@semantic-release/release-notes-generator",
+    "@semantic-release/changelog",
+    "@semantic-release/npm",
+    "@semantic-release/github",
+    [
+      "@semantic-release/git",
+      {
+        "assets": ["package.json", "CHANGELOG.md"],
+        "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
+      }
+    ]
+  ]
+}

package/CHANGELOG.md

@@ -0,0 +1,35 @@
+# Confluence CLI Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2025-06-26
+
+### Added
+- Initial release of Confluence CLI
+- Read Confluence pages by ID or URL
+- Search functionality with customizable limits
+- Page information display
+- List all Confluence spaces
+- Interactive configuration setup
+- Environment variable support
+- HTML and text output formats
+- Comprehensive README with examples
+- MIT License
+
+### Features
+- `confluence init` - Interactive configuration setup
+- `confluence read <pageId>` - Read page content with format options
+- `confluence info <pageId>` - Display page information
+- `confluence search <query>` - Search pages with optional limit
+- `confluence spaces` - List all available spaces
+
+### Dependencies
+- commander for CLI framework
+- axios for HTTP requests
+- chalk for colored output
+- inquirer for interactive prompts
+- html-to-text for content conversion
+- ora for loading indicators

package/CONTRIBUTING.md

@@ -0,0 +1,220 @@
+# Contributing to Confluence CLI
+
+Thank you for your interest in contributing to Confluence CLI! This document provides guidelines and information about contributing to this project.
+
+## Table of Contents
+
+- [Code of Conduct](#code-of-conduct)
+- [Getting Started](#getting-started)
+- [Development Setup](#development-setup)
+- [Making Changes](#making-changes)
+- [Testing](#testing)
+- [Submitting Changes](#submitting-changes)
+- [Coding Standards](#coding-standards)
+
+## Code of Conduct
+
+This project adheres to a code of conduct. By participating, you are expected to uphold this code. Please be respectful and considerate in all interactions.
+
+## Getting Started
+
+1. Fork the repository on GitHub
+2. Clone your fork locally
+3. Create a branch for your changes
+4. Make your changes
+5. Test your changes
+6. Submit a pull request
+
+## Development Setup
+
+```bash
+# Clone your fork
+git clone https://github.com/your-username/confluence-cli.git
+cd confluence-cli
+
+# Install dependencies
+npm install
+
+# Set up your test environment
+export CONFLUENCE_DOMAIN="your-test-domain.atlassian.net"
+export CONFLUENCE_API_TOKEN="your-test-token"
+
+# Test the CLI locally
+node bin/confluence.js --help
+```
+
+## Making Changes
+
+### Branch Naming
+
+Use descriptive branch names:
+- `feature/add-page-creation` - for new features
+- `fix/search-pagination` - for bug fixes
+- `docs/update-readme` - for documentation updates
+- `refactor/client-architecture` - for refactoring
+
+### Commit Messages
+
+Write clear, descriptive commit messages:
+```
+feat: add page creation functionality
+
+- Add create command to CLI
+- Implement createPage method in client
+- Add tests for page creation
+- Update README with new command
+```
+
+Use conventional commit format:
+- `feat:` - new features
+- `fix:` - bug fixes
+- `docs:` - documentation changes
+- `style:` - formatting changes
+- `refactor:` - code refactoring
+- `test:` - adding tests
+- `chore:` - maintenance tasks
+
+## Testing
+
+```bash
+# Run all tests
+npm test
+
+# Run tests in watch mode
+npm run test:watch
+
+# Check test coverage
+npm run test:coverage
+
+# Manual testing
+node bin/confluence.js read 123456789
+```
+
+### Test Guidelines
+
+- Write tests for new functionality
+- Ensure existing tests pass
+- Aim for good test coverage
+- Use descriptive test names
+- Mock external API calls
+
+## Submitting Changes
+
+1. **Push your changes** to your fork
+2. **Create a pull request** against the main branch
+3. **Fill out the PR template** with:
+   - Description of changes
+   - Type of change (bug fix, feature, etc.)
+   - Testing performed
+   - Screenshots (if applicable)
+
+### Pull Request Guidelines
+
+- Keep PRs focused and atomic
+- Include tests for new functionality
+- Update documentation as needed
+- Ensure CI passes
+- Request review from maintainers
+
+## Coding Standards
+
+### JavaScript Style
+
+- Use ES6+ features when appropriate
+- Follow existing code style
+- Use meaningful variable names
+- Add comments for complex logic
+- Keep functions small and focused
+
+### File Structure
+
+```
+bin/                 # CLI entry points
+lib/                 # Core library code
+  ├── confluence-client.js
+  ├── config.js
+  └── utils.js
+tests/               # Test files
+docs/                # Additional documentation
+```
+
+### Error Handling
+
+- Always handle errors gracefully
+- Provide helpful error messages
+- Use appropriate exit codes
+- Log errors appropriately
+
+### Documentation
+
+- Update README for new features
+- Add JSDoc comments for functions
+- Update CHANGELOG for releases
+- Include usage examples
+
+## Feature Requests
+
+Before implementing major features:
+
+1. **Check existing issues** to avoid duplication
+2. **Create an issue** to discuss the feature
+3. **Get maintainer feedback** before starting work
+4. **Follow the agreed approach** in implementation
+
+## Bug Reports
+
+When reporting bugs:
+
+1. **Check existing issues** first
+2. **Provide reproduction steps**
+3. **Include environment details**:
+   - Node.js version
+   - OS and version
+   - CLI version
+4. **Share error messages** and logs
+
+## Development Tips
+
+### Local Testing
+
+```bash
+# Test against your Confluence instance
+export CONFLUENCE_DOMAIN="your-domain.atlassian.net"
+export CONFLUENCE_API_TOKEN="your-token"
+
+# Test commands
+node bin/confluence.js spaces
+node bin/confluence.js search "test"
+node bin/confluence.js read 123456789
+```
+
+### Debugging
+
+```bash
+# Enable debug mode
+DEBUG=confluence-cli node bin/confluence.js read 123456789
+
+# Use Node.js debugger
+node --inspect-brk bin/confluence.js read 123456789
+```
+
+## Release Process
+
+For maintainers:
+
+1. Update version in `package.json`
+2. Update `CHANGELOG.md`
+3. Create git tag
+4. Push to npm
+5. Create GitHub release
+
+## Questions?
+
+If you have questions about contributing:
+
+1. Check existing documentation
+2. Search closed issues
+3. Ask in a new issue
+4. Contact maintainers
+
+Thank you for contributing to Confluence CLI! 🚀

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Confluence CLI Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,178 @@
+# Confluence CLI
+
+A powerful command-line interface for Atlassian Confluence that allows you to read, search, and manage your Confluence content from the terminal.
+
+## Features
+
+- 📖 **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
+- 🔧 **Easy setup** - Simple configuration with environment variables or interactive setup
+
+## Installation
+
+```bash
+npm install -g confluence-cli
+```
+
+Or run directly with npx:
+```bash
+npx confluence-cli
+```
+
+## Quick Start
+
+1. **Initialize configuration:**
+   ```bash
+   confluence init
+   ```
+
+2. **Read a page:**
+   ```bash
+   confluence read 123456789
+   ```
+
+3. **Search for pages:**
+   ```bash
+   confluence search "my search term"
+   ```
+
+## Configuration
+
+### Option 1: Interactive Setup
+```bash
+confluence init
+```
+
+### Option 2: Environment Variables
+```bash
+export CONFLUENCE_DOMAIN="your-domain.atlassian.net"
+export CONFLUENCE_API_TOKEN="your-api-token"
+```
+
+### Getting Your API Token
+
+1. Go to [Atlassian Account Settings](https://id.atlassian.com/manage-profile/security/api-tokens)
+2. Click "Create API token"
+3. Give it a label (e.g., "confluence-cli")
+4. Copy the generated token
+
+## Usage
+
+### Read a Page
+```bash
+# Read by page ID
+confluence read 123456789
+
+# Read with HTML format
+confluence read 123456789 --format html
+
+# Read by URL (with pageId parameter)
+confluence read "https://yourcompany.atlassian.net/wiki/spaces/SPACE/pages/123456789/Page+Title"
+```
+
+### Get Page Information
+```bash
+confluence info 123456789
+```
+
+### Search Pages
+```bash
+# Basic search
+confluence search "search term"
+
+# Limit results
+confluence search "search term" --limit 5
+```
+
+### List Spaces
+```bash
+confluence spaces
+```
+
+## Commands
+
+| Command | Description | Options |
+|---------|-------------|---------|
+| `init` | Initialize CLI configuration | - |
+| `read <pageId>` | Read page content | `--format <html\|text>` |
+| `info <pageId>` | Get page information | - |
+| `search <query>` | Search for pages | `--limit <number>` |
+| `spaces` | List all spaces | - |
+
+## Examples
+
+```bash
+# Setup
+confluence init
+
+# Read a page as text
+confluence read 123456789
+
+# Read a page as HTML
+confluence read 123456789 --format html
+
+# Get page details
+confluence info 123456789
+
+# Search with limit
+confluence search "API documentation" --limit 3
+
+# List all spaces
+confluence spaces
+```
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/pchuri/confluence-cli.git
+cd confluence-cli
+
+# Install dependencies
+npm install
+
+# Run locally
+npm start -- --help
+
+# Run tests
+npm test
+
+# Lint code
+npm run lint
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Roadmap
+
+- [ ] Create and update pages
+- [ ] Page templates
+- [ ] Bulk operations
+- [ ] Export pages to different formats
+- [ ] Integration with other Atlassian tools (Jira)
+- [ ] Page attachments management
+- [ ] Comments and reviews
+
+## Support
+
+If you encounter any issues or have questions:
+
+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
+
+---
+
+Made with ❤️ for the Confluence community

package/bin/confluence.js

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+
+const { program } = require('commander');
+const chalk = require('chalk');
+const ConfluenceClient = require('../lib/confluence-client');
+const { getConfig, initConfig } = require('../lib/config');
+
+program
+  .name('confluence')
+  .description('CLI tool for Atlassian Confluence')
+  .version('1.0.0');
+
+// Init command
+program
+  .command('init')
+  .description('Initialize Confluence CLI configuration')
+  .action(async () => {
+    await initConfig();
+  });
+
+// Read command
+program
+  .command('read <pageId>')
+  .description('Read a Confluence page by ID or URL')
+  .option('-f, --format <format>', 'Output format (html, text)', 'text')
+  .action(async (pageId, options) => {
+    try {
+      const config = getConfig();
+      const client = new ConfluenceClient(config);
+      const content = await client.readPage(pageId, options.format);
+      console.log(content);
+    } catch (error) {
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Info command
+program
+  .command('info <pageId>')
+  .description('Get information about a Confluence page')
+  .action(async (pageId) => {
+    try {
+      const config = getConfig();
+      const client = new ConfluenceClient(config);
+      const info = await client.getPageInfo(pageId);
+      console.log(chalk.blue('Page Information:'));
+      console.log(`Title: ${chalk.green(info.title)}`);
+      console.log(`ID: ${chalk.green(info.id)}`);
+      console.log(`Type: ${chalk.green(info.type)}`);
+      console.log(`Status: ${chalk.green(info.status)}`);
+      if (info.space) {
+        console.log(`Space: ${chalk.green(info.space.name)} (${info.space.key})`);
+      }
+    } catch (error) {
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Search command
+program
+  .command('search <query>')
+  .description('Search for Confluence pages')
+  .option('-l, --limit <limit>', 'Limit number of results', '10')
+  .action(async (query, options) => {
+    try {
+      const config = getConfig();
+      const client = new ConfluenceClient(config);
+      const results = await client.search(query, parseInt(options.limit));
+      
+      if (results.length === 0) {
+        console.log(chalk.yellow('No results found.'));
+        return;
+      }
+
+      console.log(chalk.blue(`Found ${results.length} results:`));
+      results.forEach((result, index) => {
+        console.log(`${index + 1}. ${chalk.green(result.title)} (ID: ${result.id})`);
+        if (result.excerpt) {
+          console.log(`   ${chalk.gray(result.excerpt)}`);
+        }
+      });
+    } catch (error) {
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// List spaces command
+program
+  .command('spaces')
+  .description('List all Confluence spaces')
+  .action(async () => {
+    try {
+      const config = getConfig();
+      const client = new ConfluenceClient(config);
+      const spaces = await client.getSpaces();
+      
+      console.log(chalk.blue('Available spaces:'));
+      spaces.forEach(space => {
+        console.log(`${chalk.green(space.key)} - ${space.name}`);
+      });
+    } catch (error) {
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+program.parse();

package/bin/index.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * confluence-cli
+ * A powerful command-line interface for Atlassian Confluence
+ * 
+ * @author Your Name
+ * @license MIT
+ */
+
+'use strict';
+
+// Make sure we're using a supported Node.js version
+const nodeVersion = process.version;
+const requiredVersion = '14.0.0';
+
+if (!nodeVersion.startsWith('v') || 
+    parseInt(nodeVersion.slice(1).split('.')[0]) < parseInt(requiredVersion.split('.')[0])) {
+  console.error(`Error: Node.js ${requiredVersion} or higher is required. You are using ${nodeVersion}.`);
+  process.exit(1);
+}
+
+// Load the main CLI application
+require('./confluence.js');

package/examples/demo.sh

@@ -0,0 +1,43 @@
+#!/bin/bash
+
+# Example script showing how to use confluence-cli
+
+echo "🚀 Confluence CLI Examples"
+echo "========================="
+
+# Check if confluence command is available
+if ! command -v confluence &> /dev/null; then
+    echo "❌ confluence command not found. Please install confluence-cli first:"
+    echo "   npm install -g confluence-cli"
+    exit 1
+fi
+
+echo ""
+echo "📋 Listing all spaces..."
+confluence spaces
+
+echo ""
+echo "🔍 Searching for 'API' documentation..."
+confluence search "API" --limit 5
+
+echo ""
+echo "ℹ️  Getting information about a specific page..."
+# Replace this with an actual page ID from your Confluence
+read -p "Enter a page ID to get info: " PAGE_ID
+if [ ! -z "$PAGE_ID" ]; then
+    confluence info "$PAGE_ID"
+    
+    echo ""
+    read -p "Do you want to read this page? (y/N): " READ_PAGE
+    if [ "$READ_PAGE" = "y" ] || [ "$READ_PAGE" = "Y" ]; then
+        echo ""
+        echo "📖 Reading page content..."
+        confluence read "$PAGE_ID" | head -20
+        echo ""
+        echo "(Showing first 20 lines only)"
+    fi
+fi
+
+echo ""
+echo "✅ Examples completed!"
+echo "💡 Run 'confluence --help' for more commands"

package/jest.config.js

@@ -0,0 +1,13 @@
+module.exports = {
+  testEnvironment: 'node',
+  collectCoverageFrom: [
+    'lib/**/*.js',
+    'bin/**/*.js',
+    '!node_modules/**'
+  ],
+  coverageDirectory: 'coverage',
+  coverageReporters: ['text', 'lcov', 'html'],
+  testMatch: [
+    '**/tests/**/*.test.js'
+  ]
+};

package/lib/config.js

@@ -0,0 +1,96 @@
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const inquirer = require('inquirer');
+const chalk = require('chalk');
+
+const CONFIG_DIR = path.join(os.homedir(), '.confluence-cli');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+
+/**
+ * Initialize configuration
+ */
+async function initConfig() {
+  console.log(chalk.blue('🚀 Confluence CLI Configuration'));
+  console.log('Please provide your Confluence connection details:\n');
+
+  const answers = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'domain',
+      message: 'Confluence domain (e.g., yourcompany.atlassian.net):',
+      validate: (input) => {
+        if (!input.trim()) {
+          return 'Domain is required';
+        }
+        return true;
+      }
+    },
+    {
+      type: 'password',
+      name: 'token',
+      message: 'API Token:',
+      validate: (input) => {
+        if (!input.trim()) {
+          return 'API Token is required';
+        }
+        return true;
+      }
+    }
+  ]);
+
+  // Create config directory if it doesn't exist
+  if (!fs.existsSync(CONFIG_DIR)) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+
+  // Save configuration
+  const config = {
+    domain: answers.domain.trim(),
+    token: answers.token.trim()
+  };
+
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+  
+  console.log(chalk.green('✅ Configuration saved successfully!'));
+  console.log(`Config file location: ${chalk.gray(CONFIG_FILE)}`);
+  console.log(chalk.yellow('\n💡 Tip: You can regenerate this config anytime by running "confluence init"'));
+}
+
+/**
+ * Get configuration
+ */
+function getConfig() {
+  // First check for environment variables
+  const envDomain = process.env.CONFLUENCE_DOMAIN || process.env.CONFLUENCE_HOST;
+  const envToken = process.env.CONFLUENCE_API_TOKEN;
+
+  if (envDomain && envToken) {
+    return {
+      domain: envDomain,
+      token: envToken
+    };
+  }
+
+  // Check for config file
+  if (!fs.existsSync(CONFIG_FILE)) {
+    console.error(chalk.red('❌ No configuration found!'));
+    console.log(chalk.yellow('Please run "confluence init" to set up your configuration.'));
+    console.log(chalk.gray('Or set environment variables: CONFLUENCE_DOMAIN and CONFLUENCE_API_TOKEN'));
+    process.exit(1);
+  }
+
+  try {
+    const config = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'));
+    return config;
+  } catch (error) {
+    console.error(chalk.red('❌ Error reading configuration file:'), error.message);
+    console.log(chalk.yellow('Please run "confluence init" to recreate your configuration.'));
+    process.exit(1);
+  }
+}
+
+module.exports = {
+  initConfig,
+  getConfig
+};

package/lib/confluence-client.js

@@ -0,0 +1,137 @@
+const axios = require('axios');
+const { convert } = require('html-to-text');
+
+class ConfluenceClient {
+  constructor(config) {
+    this.baseURL = `https://${config.domain}/rest/api`;
+    this.token = config.token;
+    this.domain = config.domain;
+    
+    this.client = axios.create({
+      baseURL: this.baseURL,
+      headers: {
+        'Authorization': `Bearer ${this.token}`,
+        'Content-Type': 'application/json'
+      }
+    });
+  }
+
+  /**
+   * Extract page ID from URL or return the ID if it's already a number
+   */
+  extractPageId(pageIdOrUrl) {
+    if (typeof pageIdOrUrl === 'number' || /^\d+$/.test(pageIdOrUrl)) {
+      return pageIdOrUrl;
+    }
+
+    // Check if it's a Confluence URL
+    if (pageIdOrUrl.includes(this.domain)) {
+      // Extract pageId from URL parameter
+      const pageIdMatch = pageIdOrUrl.match(/pageId=(\d+)/);
+      if (pageIdMatch) {
+        return pageIdMatch[1];
+      }
+      
+      // Handle display URLs - would need to search by space and title
+      const displayMatch = pageIdOrUrl.match(/\/display\/([^/]+)\/(.+)/);
+      if (displayMatch) {
+        throw new Error('Display URLs not yet supported. Please use page ID or viewpage URL with pageId parameter.');
+      }
+    }
+
+    return pageIdOrUrl;
+  }
+
+  /**
+   * Read a Confluence page content
+   */
+  async readPage(pageIdOrUrl, format = 'text') {
+    const pageId = this.extractPageId(pageIdOrUrl);
+    
+    const response = await this.client.get(`/content/${pageId}`, {
+      params: {
+        expand: 'body.storage'
+      }
+    });
+
+    const htmlContent = response.data.body.storage.value;
+    
+    if (format === 'html') {
+      return htmlContent;
+    }
+    
+    // Convert HTML to text
+    return convert(htmlContent, {
+      wordwrap: 80,
+      selectors: [
+        { selector: 'h1', options: { uppercase: false } },
+        { selector: 'h2', options: { uppercase: false } },
+        { selector: 'h3', options: { uppercase: false } },
+        { selector: 'table', options: { uppercaseHeaderCells: false } }
+      ]
+    });
+  }
+
+  /**
+   * Get page information
+   */
+  async getPageInfo(pageIdOrUrl) {
+    const pageId = this.extractPageId(pageIdOrUrl);
+    
+    const response = await this.client.get(`/content/${pageId}`, {
+      params: {
+        expand: 'space'
+      }
+    });
+
+    return {
+      title: response.data.title,
+      id: response.data.id,
+      type: response.data.type,
+      status: response.data.status,
+      space: response.data.space
+    };
+  }
+
+  /**
+   * Search for pages
+   */
+  async search(query, limit = 10) {
+    const response = await this.client.get('/search', {
+      params: {
+        cql: `text ~ "${query}"`,
+        limit: limit
+      }
+    });
+
+    return response.data.results.map(result => {
+      // Handle different result structures
+      const content = result.content || result;
+      return {
+        id: content.id || 'Unknown',
+        title: content.title || 'Untitled',
+        type: content.type || 'Unknown',
+        excerpt: result.excerpt || content.excerpt || ''
+      };
+    }).filter(item => item.id !== 'Unknown'); // Filter out items without valid IDs
+  }
+
+  /**
+   * Get all spaces
+   */
+  async getSpaces() {
+    const response = await this.client.get('/space', {
+      params: {
+        limit: 500
+      }
+    });
+
+    return response.data.results.map(space => ({
+      key: space.key,
+      name: space.name,
+      type: space.type
+    }));
+  }
+}
+
+module.exports = ConfluenceClient;

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "confluence-cli",
+  "version": "1.0.0",
+  "description": "A command-line interface for Atlassian Confluence",
+  "main": "index.js",
+  "bin": {
+    "confluence": "./bin/index.js"
+  },
+  "scripts": {
+    "start": "node bin/confluence.js",
+    "test": "jest",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix"
+  },
+  "keywords": [
+    "confluence",
+    "atlassian",
+    "cli",
+    "wiki",
+    "documentation"
+  ],
+  "author": "Your Name",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^11.1.0",
+    "axios": "^1.6.2",
+    "chalk": "^4.1.2",
+    "inquirer": "^8.2.6",
+    "ora": "^5.4.1",
+    "html-to-text": "^9.0.5"
+  },
+  "devDependencies": {
+    "eslint": "^8.55.0",
+    "jest": "^29.7.0",
+    "@types/node": "^20.10.0"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pchuri/confluence-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/pchuri/confluence-cli/issues"
+  },
+  "homepage": "https://github.com/pchuri/confluence-cli#readme"
+}

package/tests/confluence-client.test.js

@@ -0,0 +1,29 @@
+const ConfluenceClient = require('../lib/confluence-client');
+
+describe('ConfluenceClient', () => {
+  let client;
+  
+  beforeEach(() => {
+    client = new ConfluenceClient({
+      domain: 'test.atlassian.net',
+      token: 'test-token'
+    });
+  });
+
+  describe('extractPageId', () => {
+    test('should return numeric page ID as is', () => {
+      expect(client.extractPageId('123456789')).toBe('123456789');
+      expect(client.extractPageId(123456789)).toBe(123456789);
+    });
+
+    test('should extract page ID from URL with pageId parameter', () => {
+      const url = 'https://test.atlassian.net/wiki/spaces/TEST/pages/123456789/Page+Title';
+      expect(client.extractPageId(url + '?pageId=987654321')).toBe('987654321');
+    });
+
+    test('should throw error for display URLs', () => {
+      const displayUrl = 'https://test.atlassian.net/display/TEST/Page+Title';
+      expect(() => client.extractPageId(displayUrl)).toThrow('Display URLs not yet supported');
+    });
+  });
+});