moltengine-cli 0.1.0 → 0.1.2

package/README.md

@@ -43,26 +43,26 @@ source ~/.bashrc
 
 ```bash
 # Show tenant information
-moltengine whoami
+moltctl whoami
 
 # Check status
-moltengine status
+moltctl status
 
 # List deployments
-moltengine deployments
+moltctl deployments
 
 # Show help
-moltengine help
+moltctl help
 ```
 
 ## Commands
 
 | Command | Description |
 |---------|-------------|
-| `moltengine whoami` | Show current tenant information |
-| `moltengine status` | Show tenant status and deployment info |
-| `moltengine deployments` | List recent deployments |
-| `moltengine help` | Show help message |
+| `moltctl whoami` | Show current tenant information |
+| `moltctl status` | Show tenant status and deployment info |
+| `moltctl deployments` | List recent deployments |
+| `moltctl help` | Show help message |
 
 ## Environment Variables
 
@@ -75,7 +75,7 @@ moltengine help
 
 Your API key is displayed on the success page after completing checkout at [moltengine.com](https://moltengine.com).
 
-If you've lost your API key, contact support@moltengine.com.
+If you've lost your API key, contact support@mg.moltengine.com.
 
 ## Development
 
@@ -92,7 +92,7 @@ npm start -- status
 
 # Link for local development
 npm link
-moltengine status
+moltctl status
 ```
 
 ## Publishing (Maintainers)
@@ -115,5 +115,5 @@ MIT
 
 ## Support
 
-- Email: support@moltengine.com
+- Email: support@mg.moltengine.com
 - Docs: https://docs.moltengine.com

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "moltengine-cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "CLI for Moltengine - The WP Engine for AI Agents",
   "type": "module",
   "license": "MIT",
@@ -22,20 +22,25 @@
     "cli"
   ],
   "bin": {
-    "moltengine": "src/moltengine.js"
+    "moltctl": "src/moltengine.js"
   },
   "files": [
     "src/**/*"
   ],
   "scripts": {
     "start": "node src/moltengine.js",
-    "test": "node src/moltengine.js --help",
-    "prepublishOnly": "npm test"
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:help": "node src/moltengine.js --help",
+    "prepublishOnly": "npm run test:help"
   },
   "dependencies": {
     "undici": "^6.21.0"
   },
   "engines": {
     "node": ">=20"
+  },
+  "devDependencies": {
+    "vitest": "^4.0.18"
   }
 }

package/src/__tests__/utils.test.js

@@ -0,0 +1,218 @@
+import { describe, it, expect } from 'vitest';
+import {
+  colors,
+  formatDate,
+  formatStatus,
+  stripColors,
+  isValidApiKey,
+  isValidUrl,
+  parseArgs
+} from '../utils.js';
+
+describe('CLI Utils', () => {
+  describe('colors', () => {
+    it('should have all required color codes', () => {
+      expect(colors.reset).toBeDefined();
+      expect(colors.bold).toBeDefined();
+      expect(colors.primary).toBeDefined();
+      expect(colors.accent).toBeDefined();
+      expect(colors.success).toBeDefined();
+      expect(colors.error).toBeDefined();
+      expect(colors.warning).toBeDefined();
+      expect(colors.info).toBeDefined();
+      expect(colors.muted).toBeDefined();
+    });
+
+    it('should have valid ANSI escape sequences', () => {
+      expect(colors.reset).toBe('\x1b[0m');
+      expect(colors.bold).toBe('\x1b[1m');
+      expect(colors.success).toBe('\x1b[32m');
+      expect(colors.error).toBe('\x1b[31m');
+    });
+  });
+
+  describe('formatDate', () => {
+    it('should return N/A for null', () => {
+      expect(formatDate(null)).toBe('N/A');
+    });
+
+    it('should return N/A for undefined', () => {
+      expect(formatDate(undefined)).toBe('N/A');
+    });
+
+    it('should return N/A for empty string', () => {
+      expect(formatDate('')).toBe('N/A');
+    });
+
+    it('should format valid ISO date string', () => {
+      const result = formatDate('2024-01-15T12:30:00Z');
+      // Result depends on locale, but should contain date parts
+      expect(result).not.toBe('N/A');
+      expect(result.length).toBeGreaterThan(5);
+    });
+
+    it('should handle date-only strings', () => {
+      const result = formatDate('2024-01-15');
+      expect(result).not.toBe('N/A');
+    });
+  });
+
+  describe('formatStatus', () => {
+    it('should color active status green', () => {
+      const result = formatStatus('active');
+      expect(result).toContain(colors.success);
+      expect(result).toContain('active');
+      expect(result).toContain(colors.reset);
+    });
+
+    it('should color pending status yellow', () => {
+      const result = formatStatus('pending');
+      expect(result).toContain(colors.warning);
+    });
+
+    it('should color failed status red', () => {
+      const result = formatStatus('failed');
+      expect(result).toContain(colors.error);
+    });
+
+    it('should color running status accent', () => {
+      const result = formatStatus('running');
+      expect(result).toContain(colors.accent);
+    });
+
+    it('should handle case-insensitive status', () => {
+      const result = formatStatus('ACTIVE');
+      expect(result).toContain(colors.success);
+    });
+
+    it('should handle null status', () => {
+      const result = formatStatus(null);
+      expect(result).toContain(colors.reset);
+    });
+
+    it('should handle unknown status', () => {
+      const result = formatStatus('unknown-status');
+      expect(result).toContain('unknown-status');
+    });
+  });
+
+  describe('stripColors', () => {
+    it('should remove ANSI color codes', () => {
+      const colored = `${colors.success}Hello${colors.reset}`;
+      expect(stripColors(colored)).toBe('Hello');
+    });
+
+    it('should handle multiple color codes', () => {
+      const colored = `${colors.bold}${colors.primary}Test${colors.reset}`;
+      expect(stripColors(colored)).toBe('Test');
+    });
+
+    it('should return plain string unchanged', () => {
+      expect(stripColors('Hello World')).toBe('Hello World');
+    });
+
+    it('should handle empty string', () => {
+      expect(stripColors('')).toBe('');
+    });
+  });
+
+  describe('isValidApiKey', () => {
+    it('should return true for valid 48-char hex key', () => {
+      const validKey = 'a'.repeat(48);
+      expect(isValidApiKey(validKey)).toBe(true);
+    });
+
+    it('should return true for mixed case hex', () => {
+      const validKey = 'aAbBcCdDeEfF'.repeat(4);
+      expect(isValidApiKey(validKey)).toBe(true);
+    });
+
+    it('should return false for too short key', () => {
+      expect(isValidApiKey('abc123')).toBe(false);
+    });
+
+    it('should return false for too long key', () => {
+      expect(isValidApiKey('a'.repeat(50))).toBe(false);
+    });
+
+    it('should return false for non-hex characters', () => {
+      const invalidKey = 'g'.repeat(48);
+      expect(isValidApiKey(invalidKey)).toBe(false);
+    });
+
+    it('should return false for null', () => {
+      expect(isValidApiKey(null)).toBe(false);
+    });
+
+    it('should return false for undefined', () => {
+      expect(isValidApiKey(undefined)).toBe(false);
+    });
+
+    it('should return false for empty string', () => {
+      expect(isValidApiKey('')).toBe(false);
+    });
+  });
+
+  describe('isValidUrl', () => {
+    it('should return true for valid http URL', () => {
+      expect(isValidUrl('http://localhost:8080')).toBe(true);
+    });
+
+    it('should return true for valid https URL', () => {
+      expect(isValidUrl('https://api.moltengine.com')).toBe(true);
+    });
+
+    it('should return true for URL with path', () => {
+      expect(isValidUrl('https://api.moltengine.com/v1/tenants')).toBe(true);
+    });
+
+    it('should return false for invalid URL', () => {
+      expect(isValidUrl('not-a-url')).toBe(false);
+    });
+
+    it('should return false for empty string', () => {
+      expect(isValidUrl('')).toBe(false);
+    });
+  });
+
+  describe('parseArgs', () => {
+    it('should parse command from argv', () => {
+      const result = parseArgs(['node', 'moltengine.js', 'status']);
+      expect(result.command).toBe('status');
+    });
+
+    it('should default to help when no command', () => {
+      const result = parseArgs(['node', 'moltengine.js']);
+      expect(result.command).toBe('help');
+    });
+
+    it('should parse positional arguments', () => {
+      const result = parseArgs(['node', 'moltengine.js', 'deploy', 'app1', 'app2']);
+      expect(result.command).toBe('deploy');
+      expect(result.args).toEqual(['app1', 'app2']);
+    });
+
+    it('should parse long flags', () => {
+      const result = parseArgs(['node', 'moltengine.js', 'status', '--verbose']);
+      expect(result.flags.verbose).toBe(true);
+    });
+
+    it('should parse long flags with values', () => {
+      const result = parseArgs(['node', 'moltengine.js', 'deploy', '--env=production']);
+      expect(result.flags.env).toBe('production');
+    });
+
+    it('should parse short flags', () => {
+      const result = parseArgs(['node', 'moltengine.js', 'status', '-v']);
+      expect(result.flags.v).toBe(true);
+    });
+
+    it('should handle mixed args and flags', () => {
+      const result = parseArgs(['node', 'moltengine.js', 'deploy', 'app1', '--force', '-v']);
+      expect(result.command).toBe('deploy');
+      expect(result.args).toEqual(['app1']);
+      expect(result.flags.force).toBe(true);
+      expect(result.flags.v).toBe(true);
+    });
+  });
+});

package/src/moltengine.js

@@ -6,11 +6,30 @@ import { request } from "undici";
 const API_URL = process.env.MOLTENGINE_API || "http://localhost:8080";
 const TENANT_KEY = process.env.MOLT_TENANT_KEY || "";
 
-// ANSI colors
+// ============================================================================
+// BRAND COLORS (ANSI 24-bit RGB)
+// Derived from elegant-luxury theme
+// ============================================================================
+
 const colors = {
   reset: "\x1b[0m",
   bold: "\x1b[1m",
   dim: "\x1b[2m",
+  italic: "\x1b[3m",
+  underline: "\x1b[4m",
+  
+  // Brand colors (24-bit RGB)
+  primary: "\x1b[38;2;194;65;12m",      // #c2410c - terracotta
+  accent: "\x1b[38;2;234;88;12m",       // #ea580c - bright orange
+  
+  // Semantic colors
+  success: "\x1b[32m",                   // Green
+  warning: "\x1b[33m",                   // Yellow
+  error: "\x1b[31m",                     // Red
+  info: "\x1b[36m",                      // Cyan
+  muted: "\x1b[90m",                     // Gray
+  
+  // Legacy aliases
   green: "\x1b[32m",
   yellow: "\x1b[33m",
   red: "\x1b[31m",
@@ -18,6 +37,29 @@ const colors = {
   blue: "\x1b[34m"
 };
 
+// ============================================================================
+// ASCII ART LOGO
+// ============================================================================
+
+const ASCII_LOGO = `
+${colors.primary}  __  __       _ _                   _            
+ |  \\/  | ___ | | |_ ___ _ __   __ _(_)_ __   ___ 
+ | |\\/| |/ _ \\| | __/ _ \\ '_ \\ / _\` | | '_ \\ / _ \\
+ | |  | | (_) | | ||  __/ | | | (_| | | | | |  __/
+ |_|  |_|\\___/|_|\\__\\___|_| |_|\\__, |_|_| |_|\\___|
+                               |___/              ${colors.reset}
+`;
+
+const ASCII_LOGO_COMPACT = `
+${colors.primary} ╔╦╗╔═╗╦ ╔╦╗╔═╗╔╗╔╔═╗╦╔╗╔╔═╗
+ ║║║║ ║║  ║ ║╣ ║║║║ ╦║║║║║╣ 
+ ╩ ╩╚═╝╩═╝╩ ╚═╝╝╚╝╚═╝╩╝╚╝╚═╝${colors.reset}
+`;
+
+// ============================================================================
+// OUTPUT HELPERS
+// ============================================================================
+
 /**
  * Print colored output
  */
@@ -25,14 +67,41 @@ function print(message, color = "") {
   console.log(color ? `${color}${message}${colors.reset}` : message);
 }
 
+/**
+ * Print branded header
+ */
+function printHeader(title) {
+  console.log();
+  print(title, colors.bold);
+  print("─".repeat(40), colors.muted);
+}
+
 /**
  * Print error and exit
  */
 function error(message) {
-  print(`Error: ${message}`, colors.red);
+  print(`✗ Error: ${message}`, colors.error);
   process.exit(1);
 }
 
+/**
+ * Print success message
+ */
+function success(message) {
+  print(`✓ ${message}`, colors.success);
+}
+
+/**
+ * Print info message
+ */
+function info(message) {
+  print(`→ ${message}`, colors.info);
+}
+
+// ============================================================================
+// API CLIENT
+// ============================================================================
+
 /**
  * Make an authenticated GET request
  */
@@ -68,6 +137,10 @@ async function apiGet(path) {
   }
 }
 
+// ============================================================================
+// FORMATTERS
+// ============================================================================
+
 /**
  * Format a date string
  */
@@ -81,16 +154,16 @@ function formatDate(dateStr) {
  */
 function formatStatus(status) {
   const statusColors = {
-    active: colors.green,
-    pending: colors.yellow,
-    inactive: colors.dim,
-    past_due: colors.red,
-    canceled: colors.red,
-    suspended: colors.red,
-    succeeded: colors.green,
-    running: colors.cyan,
-    queued: colors.yellow,
-    failed: colors.red
+    active: colors.success,
+    pending: colors.warning,
+    inactive: colors.muted,
+    past_due: colors.error,
+    canceled: colors.error,
+    suspended: colors.error,
+    succeeded: colors.success,
+    running: colors.accent,
+    queued: colors.warning,
+    failed: colors.error
   };
   
   const color = statusColors[status?.toLowerCase()] || colors.reset;
@@ -102,36 +175,40 @@ function formatStatus(status) {
 // ============================================================================
 
 /**
- * Display help
+ * Display help with branding
  */
 function showHelp() {
-  console.log(`
-${colors.bold}moltengine${colors.reset} - Moltengine CLI
-
-${colors.bold}USAGE${colors.reset}
-  moltengine <command> [options]
-
-${colors.bold}COMMANDS${colors.reset}
-  whoami       Show current tenant information
-  status       Show tenant status and deployment info
-  deployments  List recent deployments
-  help         Show this help message
-
-${colors.bold}ENVIRONMENT${colors.reset}
-  MOLTENGINE_API   API URL (default: http://localhost:8080)
-  MOLT_TENANT_KEY  Your tenant API key (required)
-
-${colors.bold}EXAMPLES${colors.reset}
-  # Set up environment
-  export MOLTENGINE_API="https://api.moltengine.io"
-  export MOLT_TENANT_KEY="your-tenant-key-here"
-
-  # Check your tenant info
-  moltengine whoami
-
-  # Check status
-  moltengine status
-`);
+  console.log(ASCII_LOGO);
+  console.log(`${colors.muted}Secure Clawd. Without Fear.${colors.reset}`);
+  console.log();
+  
+  print("USAGE", colors.bold);
+  console.log(`  ${colors.primary}moltctl${colors.reset} <command> [options]`);
+  console.log();
+  
+  print("COMMANDS", colors.bold);
+  console.log(`  ${colors.accent}whoami${colors.reset}       Show current tenant information`);
+  console.log(`  ${colors.accent}status${colors.reset}       Show tenant status and deployment info`);
+  console.log(`  ${colors.accent}deployments${colors.reset}  List recent deployments`);
+  console.log(`  ${colors.accent}help${colors.reset}         Show this help message`);
+  console.log();
+  
+  print("ENVIRONMENT", colors.bold);
+  console.log(`  ${colors.muted}MOLTENGINE_API${colors.reset}   API URL (default: http://localhost:8080)`);
+  console.log(`  ${colors.muted}MOLT_TENANT_KEY${colors.reset}  Your tenant API key (required)`);
+  console.log();
+  
+  print("EXAMPLES", colors.bold);
+  console.log(`  ${colors.muted}# Set up environment${colors.reset}`);
+  console.log(`  export MOLTENGINE_API="https://api.moltengine.com"`);
+  console.log(`  export MOLT_TENANT_KEY="your-tenant-key-here"`);
+  console.log();
+  console.log(`  ${colors.muted}# Check your tenant info${colors.reset}`);
+  console.log(`  ${colors.primary}moltctl${colors.reset} whoami`);
+  console.log();
+  console.log(`  ${colors.muted}# Check status${colors.reset}`);
+  console.log(`  ${colors.primary}moltctl${colors.reset} status`);
+  console.log();
 }
 
 /**
@@ -140,16 +217,14 @@ ${colors.bold}EXAMPLES${colors.reset}
 async function cmdWhoami() {
   const data = await apiGet("/tenant/me");
   
-  console.log(`
-${colors.bold}Tenant Information${colors.reset}
-${"─".repeat(40)}
-  ${colors.dim}ID:${colors.reset}       ${data.tenantId}
-  ${colors.dim}Name:${colors.reset}     ${data.name}
-  ${colors.dim}Email:${colors.reset}    ${data.email}
-  ${colors.dim}Status:${colors.reset}   ${formatStatus(data.status)}
-  ${colors.dim}FQDN:${colors.reset}     ${data.fqdn || "(not configured)"}
-  ${colors.dim}Created:${colors.reset}  ${formatDate(data.createdAt)}
-`);
+  printHeader("Tenant Information");
+  console.log(`  ${colors.muted}ID:${colors.reset}       ${data.tenantId}`);
+  console.log(`  ${colors.muted}Name:${colors.reset}     ${data.name}`);
+  console.log(`  ${colors.muted}Email:${colors.reset}    ${data.email}`);
+  console.log(`  ${colors.muted}Status:${colors.reset}   ${formatStatus(data.status)}`);
+  console.log(`  ${colors.muted}FQDN:${colors.reset}     ${data.fqdn || "(not configured)"}`);
+  console.log(`  ${colors.muted}Created:${colors.reset}  ${formatDate(data.createdAt)}`);
+  console.log();
 }
 
 /**
@@ -158,36 +233,37 @@ ${"─".repeat(40)}
 async function cmdStatus() {
   const data = await apiGet("/tenant/me");
   
-  print(`\n${colors.bold}Moltengine Status${colors.reset}`);
-  print("─".repeat(40));
+  console.log(ASCII_LOGO_COMPACT);
+  printHeader("Runtime Status");
   
   // Status line
   const statusIcon = data.status === "active" ? "●" : "○";
-  const statusColor = data.status === "active" ? colors.green : colors.yellow;
-  print(`  Status: ${statusColor}${statusIcon} ${data.status}${colors.reset}`);
+  const statusColor = data.status === "active" ? colors.success : colors.warning;
+  console.log(`  ${colors.muted}Status:${colors.reset}   ${statusColor}${statusIcon} ${data.status}${colors.reset}`);
   
   // FQDN
   if (data.fqdn) {
-    print(`  URL: ${colors.cyan}https://${data.fqdn}${colors.reset}`);
+    console.log(`  ${colors.muted}URL:${colors.reset}      ${colors.accent}https://${data.fqdn}${colors.reset}`);
   } else {
-    print(`  URL: ${colors.dim}(provisioning...)${colors.reset}`);
+    console.log(`  ${colors.muted}URL:${colors.reset}      ${colors.muted}(provisioning...)${colors.reset}`);
   }
   
   // Last provisioned
-  print(`  Last Deployed: ${formatDate(data.lastProvisioned)}`);
+  console.log(`  ${colors.muted}Deployed:${colors.reset} ${formatDate(data.lastProvisioned)}`);
   
   // Error (if any)
   if (data.lastError) {
-    print(`  ${colors.red}Error: ${data.lastError}${colors.reset}`);
+    console.log(`  ${colors.error}Error:    ${data.lastError}${colors.reset}`);
   }
   
   console.log();
   
   // Show connection info if active
   if (data.status === "active" && data.fqdn) {
-    print(`${colors.bold}Connect to your Moltbot:${colors.reset}`);
-    print(`  Dashboard: ${colors.cyan}https://${data.fqdn}${colors.reset}`);
-    print(`  Gateway:   ${colors.cyan}https://${data.fqdn}:18789${colors.reset}`);
+    print("Connection Info", colors.bold);
+    print("─".repeat(40), colors.muted);
+    console.log(`  ${colors.muted}Dashboard:${colors.reset} ${colors.accent}https://${data.fqdn}${colors.reset}`);
+    console.log(`  ${colors.muted}Gateway:${colors.reset}   ${colors.accent}https://${data.fqdn}:18789${colors.reset}`);
     console.log();
   }
 }
@@ -198,11 +274,10 @@ async function cmdStatus() {
 async function cmdDeployments() {
   const data = await apiGet("/tenant/deployments");
   
-  print(`\n${colors.bold}Recent Deployments${colors.reset}`);
-  print("─".repeat(60));
+  printHeader("Recent Deployments");
   
   if (!data.deployments || data.deployments.length === 0) {
-    print("  No deployments found");
+    console.log(`  ${colors.muted}No deployments found${colors.reset}`);
     console.log();
     return;
   }
@@ -210,9 +285,9 @@ async function cmdDeployments() {
   for (const dep of data.deployments) {
     const date = formatDate(dep.created_at);
     const status = formatStatus(dep.status);
-    print(`  ${colors.dim}[${date}]${colors.reset} ${dep.kind} - ${status}`);
+    console.log(`  ${colors.muted}[${date}]${colors.reset} ${dep.kind} - ${status}`);
     if (dep.error) {
-      print(`    ${colors.red}Error: ${dep.error.substring(0, 60)}...${colors.reset}`);
+      console.log(`    ${colors.error}Error: ${dep.error.substring(0, 60)}...${colors.reset}`);
     }
   }
   
@@ -231,6 +306,11 @@ async function main() {
     process.exit(0);
   }
   
+  // Show compact logo for commands
+  if (command !== "help") {
+    console.log();
+  }
+  
   switch (command) {
     case "whoami":
       await cmdWhoami();
@@ -245,8 +325,8 @@ async function main() {
       break;
       
     default:
-      print(`Unknown command: ${command}`, colors.red);
-      print(`Run 'moltengine help' for usage information`);
+      print(`Unknown command: ${command}`, colors.error);
+      print(`Run 'moltctl help' for usage information`, colors.muted);
       process.exit(1);
   }
 }

package/src/utils.js

@@ -0,0 +1,148 @@
+/**
+ * CLI Utility Functions
+ * Extracted for testability
+ */
+
+// ============================================================================
+// BRAND COLORS (ANSI 24-bit RGB)
+// ============================================================================
+
+export const colors = {
+  reset: "\x1b[0m",
+  bold: "\x1b[1m",
+  dim: "\x1b[2m",
+  italic: "\x1b[3m",
+  underline: "\x1b[4m",
+  
+  // Brand colors (24-bit RGB)
+  primary: "\x1b[38;2;194;65;12m",      // #c2410c - terracotta
+  accent: "\x1b[38;2;234;88;12m",       // #ea580c - bright orange
+  
+  // Semantic colors
+  success: "\x1b[32m",                   // Green
+  warning: "\x1b[33m",                   // Yellow
+  error: "\x1b[31m",                     // Red
+  info: "\x1b[36m",                      // Cyan
+  muted: "\x1b[90m",                     // Gray
+  
+  // Legacy aliases
+  green: "\x1b[32m",
+  yellow: "\x1b[33m",
+  red: "\x1b[31m",
+  cyan: "\x1b[36m",
+  blue: "\x1b[34m"
+};
+
+// ============================================================================
+// FORMATTERS
+// ============================================================================
+
+/**
+ * Format a date string for display
+ * @param {string|null|undefined} dateStr - ISO date string
+ * @returns {string} Formatted date or "N/A"
+ */
+export function formatDate(dateStr) {
+  if (!dateStr) return "N/A";
+  return new Date(dateStr).toLocaleString();
+}
+
+/**
+ * Format status with color
+ * @param {string|null|undefined} status - Status string
+ * @returns {string} Colored status string
+ */
+export function formatStatus(status) {
+  const statusColors = {
+    active: colors.success,
+    pending: colors.warning,
+    inactive: colors.muted,
+    past_due: colors.error,
+    canceled: colors.error,
+    suspended: colors.error,
+    succeeded: colors.success,
+    running: colors.accent,
+    queued: colors.warning,
+    failed: colors.error
+  };
+  
+  const color = statusColors[status?.toLowerCase()] || colors.reset;
+  return `${color}${status}${colors.reset}`;
+}
+
+/**
+ * Strip ANSI color codes from a string
+ * @param {string} str - String with potential ANSI codes
+ * @returns {string} Plain string without colors
+ */
+export function stripColors(str) {
+  // eslint-disable-next-line no-control-regex
+  return str.replace(/\x1b\[[0-9;]*m/g, '');
+}
+
+// ============================================================================
+// VALIDATORS
+// ============================================================================
+
+/**
+ * Check if a string looks like a valid API key
+ * @param {string} key - Potential API key
+ * @returns {boolean}
+ */
+export function isValidApiKey(key) {
+  if (!key || typeof key !== 'string') return false;
+  // Moltengine API keys are 48 character hex strings
+  return /^[a-f0-9]{48}$/i.test(key);
+}
+
+/**
+ * Check if a URL is valid
+ * @param {string} url - URL to validate
+ * @returns {boolean}
+ */
+export function isValidUrl(url) {
+  try {
+    new URL(url);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// ============================================================================
+// PARSERS
+// ============================================================================
+
+/**
+ * Parse command line arguments
+ * @param {string[]} argv - process.argv
+ * @returns {{ command: string, args: string[], flags: object }}
+ */
+export function parseArgs(argv) {
+  const [, , command, ...rest] = argv;
+  const args = [];
+  const flags = {};
+  
+  for (const arg of rest) {
+    if (arg.startsWith('--')) {
+      const [key, value] = arg.slice(2).split('=');
+      flags[key] = value ?? true;
+    } else if (arg.startsWith('-')) {
+      flags[arg.slice(1)] = true;
+    } else {
+      args.push(arg);
+    }
+  }
+  
+  return { command: command || 'help', args, flags };
+}
+
+export default {
+  colors,
+  formatDate,
+  formatStatus,
+  stripColors,
+  isValidApiKey,
+  isValidUrl,
+  parseArgs
+};