@orchestree/cli 2.1.0

package/src/index.d.ts

@@ -0,0 +1,221 @@
+/**
+ * Orchestree CLI - TypeScript Declarations
+ */
+
+/**
+ * Color codes for terminal output
+ */
+export interface Colors {
+  reset: string;
+  bright: string;
+  dim: string;
+  cyan: string;
+  green: string;
+  yellow: string;
+  red: string;
+  blue: string;
+  magenta: string;
+}
+
+/**
+ * CLI configuration object
+ */
+export interface CLIConfig {
+  authenticated?: boolean;
+  workspace?: string;
+  userId?: string;
+  debug?: boolean;
+  [key: string]: any;
+}
+
+/**
+ * Parsed command-line arguments
+ */
+export interface ParsedArgs {
+  command: string | null;
+  subcommand: string | null;
+  args: string[];
+  flags: Record<string, string | boolean>;
+}
+
+/**
+ * Context passed to command handlers
+ */
+export interface CommandContext {
+  cli: OrchestreeCLI;
+  flags: Record<string, string | boolean>;
+  args: string[];
+  verbose: boolean;
+  json: boolean;
+}
+
+/**
+ * Command handler function type
+ */
+export type CommandHandler = (subcommand: string | null, context: CommandContext) => Promise<void>;
+
+/**
+ * Main CLI class
+ */
+export class OrchestreeCLI {
+  version: string;
+  config: CLIConfig;
+
+  constructor();
+
+  /**
+   * Get the CLI version
+   */
+  getVersion(): string;
+
+  /**
+   * Load configuration from disk
+   */
+  loadConfig(): CLIConfig;
+
+  /**
+   * Save configuration to disk
+   */
+  saveConfig(): void;
+
+  /**
+   * Log a message with optional color
+   */
+  log(message: string, color?: keyof Colors): void;
+
+  /**
+   * Log an error message
+   */
+  error(message: string): void;
+
+  /**
+   * Log a success message
+   */
+  success(message: string): void;
+
+  /**
+   * Log an info message
+   */
+  info(message: string): void;
+
+  /**
+   * Log a warning message
+   */
+  warn(message: string): void;
+
+  /**
+   * Display the welcome banner
+   */
+  showBanner(): void;
+
+  /**
+   * Display the help menu
+   */
+  showHelp(): void;
+
+  /**
+   * Display the version
+   */
+  showVersion(): void;
+
+  /**
+   * Parse command-line arguments
+   */
+  parseArgs(argv: string[]): ParsedArgs;
+
+  /**
+   * Run the CLI with given arguments
+   */
+  run(argv: string[]): Promise<void>;
+}
+
+/**
+ * Authentication commands
+ * - login: Log in to your Orchestree account
+ * - logout: Log out from Orchestree
+ * - status: Check authentication status
+ */
+export const auth: CommandHandler;
+
+/**
+ * Workspace commands
+ * - list: List all workspaces
+ * - create <name>: Create a new workspace
+ * - switch <name>: Switch to a workspace
+ */
+export const workspace: CommandHandler;
+
+/**
+ * Module management commands
+ * - list: List all available modules
+ * - enable <name>: Enable a module
+ * - status: Show module status
+ * - health: Check module health
+ */
+export const modules: CommandHandler;
+
+/**
+ * Conductor workflow commands
+ * - workflows: List automation workflows
+ * - run <workflow>: Run a workflow
+ * - logs: View workflow logs
+ */
+export const conductor: CommandHandler;
+
+/**
+ * Social media publishing commands
+ * - post <content>: Post to social media
+ * - schedule: Schedule a post
+ * - analytics: View social analytics
+ */
+export const social: CommandHandler;
+
+/**
+ * Code generation commands
+ * - generate: Generate code with AI
+ * - review: AI code review
+ * - docs: Generate documentation
+ */
+export const codenza: CommandHandler;
+
+/**
+ * Brand studio commands
+ * - create: Create branded assets
+ * - brand-kit: Manage brand kit
+ */
+export const forge: CommandHandler;
+
+/**
+ * Module enhancement command
+ * - enhance <module>: Enhance any Orchestree module
+ */
+export const enhance: CommandHandler;
+
+/**
+ * Code scaffolding commands
+ * - api-endpoint: Create API endpoint scaffold
+ * - new-module: Create new module scaffold
+ */
+export const scaffold: CommandHandler;
+
+/**
+ * Audit command for system and code quality
+ * - --type ui|code|security|all
+ * - --module <name>
+ */
+export const audit: CommandHandler;
+
+/**
+ * Test runner command
+ */
+export const test: CommandHandler;
+
+/**
+ * Development commands
+ * - serve: Start development server
+ * - deploy: Deploy to staging
+ * - logs: View server logs
+ */
+export const dev: CommandHandler;
+
+export default OrchestreeCLI;

package/src/index.js

@@ -0,0 +1,279 @@
+#!/usr/bin/env node
+
+/**
+ * Orchestree CLI - Main Entry Point
+ * Handles command parsing, dispatch, and top-level configuration
+ */
+
+const fs = require('fs');
+const path = require('path');
+const commands = require('./commands');
+
+// ANSI color codes for terminal output
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  dim: '\x1b[2m',
+  cyan: '\x1b[36m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  blue: '\x1b[34m',
+  magenta: '\x1b[35m',
+};
+
+class OrchestreeCLI {
+  constructor() {
+    this.version = this.getVersion();
+    this.config = this.loadConfig();
+  }
+
+  getVersion() {
+    try {
+      const packageJson = require('../package.json');
+      return packageJson.version;
+    } catch {
+      return '2.1.0';
+    }
+  }
+
+  loadConfig() {
+    const configPath = path.join(process.env.HOME || process.env.USERPROFILE || '~', '.orchestree');
+    try {
+      if (fs.existsSync(configPath)) {
+        return JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+      }
+    } catch (error) {
+      // Config file doesn't exist or is invalid, that's OK
+    }
+    return {};
+  }
+
+  saveConfig() {
+    const configPath = path.join(process.env.HOME || process.env.USERPROFILE || '~', '.orchestree');
+    try {
+      fs.writeFileSync(configPath, JSON.stringify(this.config, null, 2), 'utf-8');
+    } catch (error) {
+      this.error(`Failed to save config: ${error.message}`);
+    }
+  }
+
+  log(message, color = 'reset') {
+    console.log(`${colors[color]}${message}${colors.reset}`);
+  }
+
+  error(message) {
+    console.error(`${colors.red}✖ Error: ${message}${colors.reset}`);
+  }
+
+  success(message) {
+    console.log(`${colors.green}✓ ${message}${colors.reset}`);
+  }
+
+  info(message) {
+    console.log(`${colors.cyan}ℹ ${message}${colors.reset}`);
+  }
+
+  warn(message) {
+    console.log(`${colors.yellow}⚠ ${message}${colors.reset}`);
+  }
+
+  showBanner() {
+    this.log('', 'reset');
+    this.log('  ╔═══════════════════════════════════════╗', 'cyan');
+    this.log('  ║                                       ║', 'cyan');
+    this.log('  ║    🚀  ORCHESTREE CLI v' + this.version.padEnd(20) + '║', 'cyan');
+    this.log('  ║    Intelligent Automation Platform     ║', 'cyan');
+    this.log('  ║                                       ║', 'cyan');
+    this.log('  ╚═══════════════════════════════════════╝', 'cyan');
+    this.log('', 'reset');
+  }
+
+  showHelp() {
+    this.showBanner();
+    this.log(`${colors.bright}Usage:${colors.reset}`, 'reset');
+    this.log('  orchestree <command> [options]', 'reset');
+    this.log('', 'reset');
+
+    this.log(`${colors.bright}Commands:${colors.reset}`, 'reset');
+    this.log('', 'reset');
+
+    this.log('  Authentication:', 'blue');
+    this.log('    auth login                 Log in to your Orchestree account', 'reset');
+    this.log('    auth logout                Log out from Orchestree', 'reset');
+    this.log('    auth status                Check authentication status', 'reset');
+    this.log('', 'reset');
+
+    this.log('  Workspace:', 'blue');
+    this.log('    workspace list             List all workspaces', 'reset');
+    this.log('    workspace create <name>    Create a new workspace', 'reset');
+    this.log('    workspace switch <name>    Switch to a workspace', 'reset');
+    this.log('', 'reset');
+
+    this.log('  Modules:', 'blue');
+    this.log('    modules list               List all available modules', 'reset');
+    this.log('    modules enable <name>      Enable a module', 'reset');
+    this.log('    modules status             Show module status', 'reset');
+    this.log('    modules health             Check module health', 'reset');
+    this.log('', 'reset');
+
+    this.log('  Conductor (Workflows):', 'blue');
+    this.log('    conductor workflows        List automation workflows', 'reset');
+    this.log('    conductor run <workflow>   Run a workflow', 'reset');
+    this.log('    conductor logs             View workflow logs', 'reset');
+    this.log('', 'reset');
+
+    this.log('  Social (Publishing):', 'blue');
+    this.log('    social post <content>      Post to social media', 'reset');
+    this.log('    social schedule            Schedule a post', 'reset');
+    this.log('    social analytics           View social analytics', 'reset');
+    this.log('', 'reset');
+
+    this.log('  Codenza (Code Generation):', 'blue');
+    this.log('    codenza generate           Generate code', 'reset');
+    this.log('    codenza review             AI code review', 'reset');
+    this.log('    codenza docs               Generate documentation', 'reset');
+    this.log('', 'reset');
+
+    this.log('  Forge (Brand Studio):', 'blue');
+    this.log('    forge create               Create branded assets', 'reset');
+    this.log('    forge brand-kit            Manage brand kit', 'reset');
+    this.log('', 'reset');
+
+    this.log('  Enhance (Module Optimization):', 'blue');
+    this.log('    enhance [module]           Enhance any Orchestree module', 'reset');
+    this.log('', 'reset');
+
+    this.log('  Development:', 'blue');
+    this.log('    scaffold api-endpoint      Create API endpoint scaffold', 'reset');
+    this.log('    scaffold new-module        Create new module scaffold', 'reset');
+    this.log('    audit [options]            Audit system & code quality', 'reset');
+    this.log('    test                       Run tests', 'reset');
+    this.log('    dev serve                  Start development server', 'reset');
+    this.log('    dev deploy                 Deploy to staging', 'reset');
+    this.log('    dev logs                   View server logs', 'reset');
+    this.log('', 'reset');
+
+    this.log(`${colors.bright}Options:${colors.reset}`, 'reset');
+    this.log('  -h, --help                Display this help menu', 'reset');
+    this.log('  -v, --version             Show version number', 'reset');
+    this.log('  --verbose                 Enable verbose logging', 'reset');
+    this.log('  --json                    Output as JSON', 'reset');
+    this.log('', 'reset');
+
+    this.log(`${colors.bright}Examples:${colors.reset}`, 'reset');
+    this.log('  orchestree auth login', 'reset');
+    this.log('  orchestree workspace create my-workspace', 'reset');
+    this.log('  orchestree modules list', 'reset');
+    this.log('  orchestree conductor run daily-sync', 'reset');
+    this.log('  orchestree enhance social', 'reset');
+    this.log('  orchestree dev serve', 'reset');
+    this.log('', 'reset');
+  }
+
+  showVersion() {
+    this.log(`Orchestree CLI v${this.version}`, 'cyan');
+  }
+
+  parseArgs(argv) {
+    const args = argv.slice(2);
+    const parsed = {
+      command: null,
+      subcommand: null,
+      args: [],
+      flags: {},
+    };
+
+    let i = 0;
+    while (i < args.length) {
+      const arg = args[i];
+
+      if (arg.startsWith('--')) {
+        const key = arg.slice(2);
+        const next = args[i + 1];
+        if (next && !next.startsWith('-')) {
+          parsed.flags[key] = next;
+          i += 2;
+        } else {
+          parsed.flags[key] = true;
+          i += 1;
+        }
+      } else if (arg.startsWith('-') && arg !== '-') {
+        const key = arg.slice(1);
+        parsed.flags[key] = true;
+        i += 1;
+      } else if (!parsed.command) {
+        parsed.command = arg;
+        i += 1;
+      } else if (!parsed.subcommand) {
+        parsed.subcommand = arg;
+        i += 1;
+      } else {
+        parsed.args.push(arg);
+        i += 1;
+      }
+    }
+
+    return parsed;
+  }
+
+  async run(argv) {
+    const parsed = this.parseArgs(argv);
+
+    // Handle global flags
+    if (parsed.flags.h || parsed.flags.help) {
+      this.showHelp();
+      process.exit(0);
+    }
+
+    if (parsed.flags.v || parsed.flags.version) {
+      this.showVersion();
+      process.exit(0);
+    }
+
+    // If no command, show help
+    if (!parsed.command) {
+      this.showHelp();
+      process.exit(0);
+    }
+
+    try {
+      // Dispatch to command handler
+      const handler = commands[parsed.command];
+
+      if (!handler) {
+        this.error(`Unknown command: ${parsed.command}`);
+        this.log('\nRun "orchestree --help" for available commands', 'dim');
+        process.exit(1);
+      }
+
+      // Pass context to handler
+      const context = {
+        cli: this,
+        flags: parsed.flags,
+        args: parsed.args,
+        verbose: parsed.flags.verbose || parsed.flags.V,
+        json: parsed.flags.json,
+      };
+
+      await handler(parsed.subcommand, context);
+    } catch (error) {
+      this.error(error.message);
+      if (this.config.debug) {
+        console.error(error);
+      }
+      process.exit(1);
+    }
+  }
+}
+
+// Main entry point
+if (require.main === module) {
+  const cli = new OrchestreeCLI();
+  cli.run(process.argv).catch((error) => {
+    console.error(error);
+    process.exit(1);
+  });
+}
+
+module.exports = OrchestreeCLI;