@intranefr/superbackend 1.6.7 → 1.7.8

package/autochangelog-cli/README.md

@@ -0,0 +1,266 @@
+# AutoChangelog CLI
+
+Agent-friendly command-line interface for the AutoChangelog platform.
+
+## Features
+
+- **Authentication Management**: Secure GitHub authentication with token management
+- **Project Management**: Create, list, update, and delete projects
+- **Repository Management**: Add, list, update, and remove repositories
+- **Changelog Generation**: Generate changelogs with customizable options
+- **Statistics & Utilities**: System info, health checks, and usage statistics
+- **Agent-Friendly**: JSON output, error handling, and structured responses
+
+## Installation
+
+```bash
+npm install -g autochangelog-cli
+```
+
+## Quick Start
+
+### Authentication
+
+First, authenticate with GitHub:
+
+```bash
+autochangelog auth login
+```
+
+### Create a Project
+
+```bash
+autochangelog project create --name "My Project" --plan free
+```
+
+### Add a Repository
+
+```bash
+autochangelog repo add --project-id <project-id> --repo "owner/repo-name"
+```
+
+### Generate a Changelog
+
+```bash
+autochangelog changelog generate --project-id <project-id> --repo "owner/repo-name" --format markdown
+```
+
+## Commands
+
+### Authentication
+
+```bash
+# Login with GitHub
+autochangelog auth login
+
+# Check authentication status
+autochangelog auth status
+
+# Get current token
+autochangelog auth token
+
+# Logout
+autochangelog auth logout
+```
+
+### Projects
+
+```bash
+# Create a new project
+autochangelog project create --name "Project Name" --plan free
+
+# List all projects
+autochangelog project list
+
+# Get project details
+autochangelog project get <project-id>
+
+# Update a project
+autochangelog project update <project-id> --name "New Name"
+
+# Delete a project
+autochangelog project delete <project-id>
+```
+
+### Repositories
+
+```bash
+# Add a repository to a project
+autochangelog repo add --project-id <project-id> --repo "owner/repo-name"
+
+# List repositories for a project
+autochangelog repo list --project-id <project-id>
+
+# Get repository details
+autochangelog repo get <repo-id>
+
+# Update a repository
+autochangelog repo update <repo-id> --private true
+
+# Remove a repository
+autochangelog repo remove <repo-id>
+```
+
+### Changelogs
+
+```bash
+# Generate a changelog
+autochangelog changelog generate --project-id <project-id> --repo "owner/repo-name" --format markdown
+
+# List changelogs for a project
+autochangelog changelog list --project-id <project-id>
+
+# Get changelog details
+autochangelog changelog get <changelog-id>
+
+# Update a changelog
+autochangelog changelog update <changelog-id> --public true
+
+# Delete a changelog
+autochangelog changelog delete <changelog-id>
+```
+
+### Statistics
+
+```bash
+# Show system information
+autochangelog stats system
+
+# Check system health
+autochangelog stats health
+
+# Show project statistics
+autochangelog stats project <project-id> --detailed
+
+# Show usage statistics
+autochangelog stats usage
+```
+
+## Options
+
+### Global Options
+
+- `--json`: Output in JSON format (default in non-TTY)
+- `--verbose`: Enable verbose logging
+- `--no-color`: Disable colored output
+- `--config <path>`: Path to config file
+- `--timeout <ms>`: Request timeout in milliseconds
+
+### Authentication Options
+
+- `--token <token>`: GitHub personal access token
+- `--scopes <scopes>`: Required scopes (default: repo,user)
+
+### Project Options
+
+- `--name <name>`: Project name
+- `--plan <plan>`: Project plan (free, pro, enterprise)
+- `--description <desc>`: Project description
+
+### Repository Options
+
+- `--repo <repo>`: Repository in format "owner/repo-name"
+- `--private <bool>`: Whether repository is private
+- `--sync <bool>`: Whether to sync repository
+
+### Changelog Options
+
+- `--format <format>`: Output format (markdown, json, html)
+- `--public <bool>`: Whether changelog is public
+- `--template <template>`: Custom template name
+- `--from <date>`: Start date for changelog
+- `--to <date>`: End date for changelog
+
+## Configuration
+
+The CLI stores configuration in `~/.autochangelog/config.json`:
+
+```json
+{
+  "github_token": "ghp_...",
+  "api_base_url": "https://api.autochangelog.com",
+  "timeout": 30000,
+  "default_format": "markdown"
+}
+```
+
+## Environment Variables
+
+- `AUTOCHANGELOG_API_URL`: API base URL
+- `AUTOCHANGELOG_GITHUB_TOKEN`: GitHub token
+- `AUTOCHANGELOG_CONFIG_PATH`: Config file path
+- `AUTOCHANGELOG_CACHE_PATH`: Cache directory path
+
+## Error Handling
+
+The CLI provides structured error responses:
+
+```json
+{
+  "error": {
+    "message": "Authentication failed",
+    "type": "authentication_failed",
+    "code": 401,
+    "details": {
+      "stack": "..."
+    },
+    "suggestions": [
+      "Check your GitHub token",
+      "Run 'autochangelog auth login'"
+    ],
+    "recoverable": true,
+    "retry_after": null
+  }
+}
+```
+
+## JSON Output
+
+For automation and scripting, use the `--json` flag:
+
+```bash
+autochangelog project list --json
+```
+
+## Development
+
+### Running from Source
+
+```bash
+cd autochangelog-cli
+npm install
+node bin/autochangelog --help
+```
+
+### Testing
+
+```bash
+npm test
+```
+
+### Building
+
+```bash
+npm run build
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests for new functionality
+5. Run the test suite
+6. Submit a pull request
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Support
+
+For support and questions:
+
+- Create an issue on GitHub
+- Check the documentation
+- Contact the development team

package/autochangelog-cli/bin/autochangelog

@@ -0,0 +1,120 @@
+#!/usr/bin/env node
+
+/**
+ * AutoChangelog CLI Entry Point
+ * Agent-friendly command-line interface for AutoChangelog platform
+ */
+
+// Ensure we're using the correct Node.js version
+const { engines } = require('../package.json');
+const semver = require('semver');
+
+if (!semver.satisfies(process.version, engines.node)) {
+  console.error(`❌ Node.js ${engines.node} is required. You are using ${process.version}`);
+  process.exit(1);
+}
+
+// Import CLI framework
+const { program } = require('commander');
+const chalk = require('chalk');
+const path = require('path');
+
+// Import CLI modules
+const { setupGlobalOptions, handleGlobalErrors } = require('../src/cli/utils/config');
+const { setupOutput } = require('../src/cli/utils/output');
+const { setupLogger } = require('../src/cli/utils/logger');
+
+// Import command modules
+const authCommands = require('../src/cli/commands/auth');
+const projectCommands = require('../src/cli/commands/project');
+const repoCommands = require('../src/cli/commands/repo');
+const changelogCommands = require('../src/cli/commands/changelog');
+const statsCommands = require('../src/cli/commands/stats');
+
+// Setup global configuration
+const logger = setupLogger();
+const output = setupOutput();
+
+// Handle global errors
+handleGlobalErrors(logger);
+
+// Setup program
+program
+  .name('autochangelog')
+  .description('Agent-friendly CLI for AutoChangelog platform')
+  .version(require('../package.json').version)
+  .option('--json', 'Output in JSON format (default in non-TTY)')
+  .option('--verbose', 'Enable verbose logging')
+  .option('--no-color', 'Disable colored output')
+  .option('--config <path>', 'Path to config file')
+  .option('--timeout <ms>', 'Request timeout in milliseconds', parseInt)
+  .hook('preAction', (thisCommand) => {
+    // Apply global options to all commands
+    const options = thisCommand.opts();
+    
+    if (options.json !== undefined) {
+      output.setJsonMode(options.json);
+    }
+    
+    if (options.verbose) {
+      logger.level = 'debug';
+    }
+    
+    if (options.noColor) {
+      chalk.level = 0;
+    }
+    
+    if (options.timeout) {
+      process.env.REQUEST_TIMEOUT = options.timeout.toString();
+    }
+  });
+
+// Setup commands
+authCommands(program);
+projectCommands(program);
+repoCommands(program);
+changelogCommands(program);
+statsCommands(program);
+
+// Setup help
+program.configureHelp({
+  sortSubcommands: true,
+  subcommandTerm: (cmd) => cmd.name() + (cmd.alias() ? '|' + cmd.alias() : ''),
+});
+
+// Handle unknown commands
+program.on('command:*', (operands) => {
+  logger.error(`❌ Unknown command: ${operands[0]}`);
+  logger.info(`Use ${chalk.cyan('autochangelog --help')} to see available commands`);
+  process.exit(1);
+});
+
+// Handle version command
+program.on('option:version', () => {
+  if (output.isJsonMode()) {
+    console.log(JSON.stringify({
+      version: program.version(),
+      node: process.version,
+      platform: process.platform,
+      arch: process.arch
+    }));
+  } else {
+    console.log(chalk.cyan(`AutoChangelog CLI v${program.version()}`));
+    console.log(chalk.gray(`Node.js: ${process.version}`));
+    console.log(chalk.gray(`Platform: ${process.platform} ${process.arch}`));
+  }
+  process.exit(0);
+});
+
+// Parse arguments and run
+try {
+  program.parse();
+  
+  // If no command provided, show help
+  if (!program.args.length && !program.commands.find(cmd => cmd._name === program.args[0])) {
+    program.outputHelp();
+  }
+} catch (error) {
+  logger.error('❌ CLI execution failed:', error);
+  process.exit(1);
+}

package/autochangelog-cli/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "autochangelog-cli",
+  "version": "1.0.0",
+  "description": "Agent-friendly CLI for AutoChangelog platform",
+  "main": "src/cli/index.js",
+  "bin": {
+    "autochangelog": "bin/autochangelog"
+  },
+  "scripts": {
+    "start": "node bin/autochangelog",
+    "dev": "node --inspect bin/autochangelog",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "cli",
+    "autochangelog",
+    "github",
+    "changelog",
+    "agent-friendly",
+    "devops"
+  ],
+  "author": "AutoChangelog Team",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^11.0.0",
+    "dotenv": "^16.3.1",
+    "winston": "^3.10.0",
+    "axios": "^1.5.0",
+    "simple-git": "^3.19.1",
+    "conventional-commits-parser": "^5.0.0",
+    "mongoose": "^7.5.0",
+    "jsonwebtoken": "^9.0.2",
+    "bcryptjs": "^2.4.3",
+    "chalk": "^4.1.2",
+    "ora": "^8.0.1",
+    "inquirer": "^9.2.7",
+    "fs-extra": "^11.1.1",
+    "path": "^0.12.7"
+  },
+  "devDependencies": {
+    "nodemon": "^3.0.1"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}