ultra-dex 3.1.0 → 3.2.0

package/lib/ui/interface.js

@@ -0,0 +1,241 @@
+// Ultra-Dex CLI — Main Interface Display
+// The startup screen and interactive interface
+
+import chalk from 'chalk';
+import { theme, box, header, divider, status, table, keyHints, statusLine } from './theme.js';
+
+// ═══════════════════════════════════════════════════════════════
+// STARTUP BANNER (Like Gemini CLI's clean intro)
+// ═══════════════════════════════════════════════════════════════
+
+const logo = `
+  ██╗   ██╗██╗  ████████╗██████╗  █████╗ 
+  ██║   ██║██║  ╚══██╔══╝██╔══██╗██╔══██╗
+  ██║   ██║██║     ██║   ██████╔╝███████║
+  ██║   ██║██║     ██║   ██╔══██╗██╔══██║
+  ╚██████╔╝███████╗██║   ██║  ██║██║  ██║
+   ╚═════╝ ╚══════╝╚═╝   ╚═╝  ╚═╝╚═╝  ╚═╝
+                                  ██████╗ ███████╗██╗  ██╗
+                                  ██╔══██╗██╔════╝╚██╗██╔╝
+                                  ██║  ██║█████╗   ╚███╔╝ 
+                                  ██║  ██║██╔══╝   ██╔██╗ 
+                                  ██████╔╝███████╗██╔╝ ██╗
+                                  ╚═════╝ ╚══════╝╚═╝  ╚═╝`;
+
+export function showStartup(version = '3.1.0') {
+    console.clear();
+    console.log(theme.primary(logo));
+    console.log('');
+    console.log(theme.dim('  ─────────────────────────────────────────────────────────'));
+    console.log(`  ${theme.title('ULTRA-DEX')} ${theme.dim('v' + version)} ${theme.dim('•')} ${theme.subtitle('AI Orchestration Meta-Layer')}`);
+    console.log(theme.dim('  ─────────────────────────────────────────────────────────'));
+    console.log('');
+}
+
+// ═══════════════════════════════════════════════════════════════
+// MAIN INTERFACE (Interactive mode like Claude Code)
+// ═══════════════════════════════════════════════════════════════
+
+export function showMainInterface() {
+    showStartup();
+
+    console.log(theme.subtitle('  What would you like to do?'));
+    console.log('');
+
+    const options = [
+        [theme.primary('1'), 'generate', 'Create implementation plan from idea'],
+        [theme.primary('2'), 'build', 'Start AI-assisted development'],
+        [theme.primary('3'), 'agents', 'Browse 16 specialized agents'],
+        [theme.primary('4'), 'swarm', 'Run autonomous agent pipeline'],
+        [theme.primary('5'), 'dashboard', 'Open monitoring dashboard'],
+        [theme.primary('6'), 'serve', 'Start MCP server']
+    ];
+
+    options.forEach(([num, cmd, desc]) => {
+        console.log(`  ${num}  ${theme.accent(cmd.padEnd(12))} ${theme.dim(desc)}`);
+    });
+
+    console.log('');
+    keyHints([['q', 'quit'], ['h', 'help'], ['↑↓', 'navigate']]);
+}
+
+// ═══════════════════════════════════════════════════════════════
+// STATUS DISPLAY (Like Gemini's project status view)
+// ═══════════════════════════════════════════════════════════════
+
+export function showStatus(projectData) {
+    header('Project Status');
+    console.log('');
+
+    // Project info
+    statusLine(status.info, theme.title(projectData.name || 'Ultra-Dex Project'));
+    console.log('');
+
+    // Alignment score with bar
+    const score = projectData.score || 0;
+    const scoreColor = score >= 80 ? theme.success : score >= 50 ? theme.warning : theme.error;
+    console.log(`  ${theme.dim('Alignment')}  ${progressBar(score, 100)}`);
+    console.log('');
+
+    // Quick stats
+    table(['Metric', 'Value', 'Status'], [
+        ['Sections Complete', `${projectData.sectionsComplete || 0}/34`, score >= 70 ? status.success : status.warning],
+        ['Agents Ready', `${projectData.agentsReady || 16}/16`, status.success],
+        ['Cursor Rules', `${projectData.rulesLoaded || 13}/13`, status.success],
+        ['Last Updated', projectData.lastUpdated || 'Never', status.info]
+    ]);
+
+    console.log('');
+}
+
+// ═══════════════════════════════════════════════════════════════
+// AGENTS LIST (Clean grid view)
+// ═══════════════════════════════════════════════════════════════
+
+export function showAgentsList() {
+    header('Agents');
+    console.log('');
+
+    const agents = [
+        {
+            tier: '1-leadership', agents: [
+                { name: 'cto', icon: '🏛️', status: 'ready' },
+                { name: 'planner', icon: '📋', status: 'ready' },
+                { name: 'research', icon: '🔍', status: 'ready' }
+            ]
+        },
+        {
+            tier: '2-development', agents: [
+                { name: 'backend', icon: '⚙️', status: 'ready' },
+                { name: 'frontend', icon: '🎨', status: 'ready' },
+                { name: 'database', icon: '💾', status: 'ready' }
+            ]
+        },
+        {
+            tier: '3-security', agents: [
+                { name: 'auth', icon: '🔐', status: 'ready' },
+                { name: 'security', icon: '🛡️', status: 'ready' }
+            ]
+        },
+        {
+            tier: '4-devops', agents: [
+                { name: 'devops', icon: '🚀', status: 'ready' }
+            ]
+        },
+        {
+            tier: '5-quality', agents: [
+                { name: 'testing', icon: '🧪', status: 'ready' },
+                { name: 'docs', icon: '📖', status: 'ready' },
+                { name: 'reviewer', icon: '👀', status: 'ready' },
+                { name: 'debugger', icon: '🐛', status: 'ready' }
+            ]
+        },
+        {
+            tier: '6-specialist', agents: [
+                { name: 'performance', icon: '⚡', status: 'ready' },
+                { name: 'refactoring', icon: '♻️', status: 'ready' }
+            ]
+        }
+    ];
+
+    agents.forEach(tier => {
+        console.log(`  ${theme.dim(tier.tier)}`);
+        tier.agents.forEach(agent => {
+            const statusIcon = agent.status === 'ready' ? theme.success('●') : theme.dim('○');
+            console.log(`    ${statusIcon} ${agent.icon} ${theme.accent(agent.name)}`);
+        });
+        console.log('');
+    });
+
+    keyHints([['enter', 'select'], ['q', 'back']]);
+}
+
+// ═══════════════════════════════════════════════════════════════
+// SWARM MODE DISPLAY (Pipeline visualization)
+// ═══════════════════════════════════════════════════════════════
+
+export function showSwarmPipeline(task, agents, currentIdx = -1) {
+    header('Agent Swarm');
+    console.log('');
+    console.log(`  ${theme.dim('Task:')} ${theme.title(task)}`);
+    console.log('');
+
+    agents.forEach((agent, idx) => {
+        let icon, color;
+
+        if (idx < currentIdx) {
+            icon = status.success;
+            color = theme.success;
+        } else if (idx === currentIdx) {
+            icon = status.running;
+            color = theme.accent;
+        } else {
+            icon = status.pending;
+            color = theme.dim;
+        }
+
+        const line = idx < agents.length - 1 ? theme.dim('│') : ' ';
+        console.log(`  ${icon} ${color(agent.name)}`);
+        console.log(`  ${line}`);
+    });
+
+    if (currentIdx >= agents.length) {
+        console.log('');
+        console.log(`  ${theme.success.bold('✓ Pipeline complete')}`);
+    }
+
+    console.log('');
+}
+
+// ═══════════════════════════════════════════════════════════════
+// HELP DISPLAY
+// ═══════════════════════════════════════════════════════════════
+
+export function showHelp() {
+    header('Commands');
+    console.log('');
+
+    const commands = [
+        ['Getting Started', [
+            ['init', 'Initialize new project'],
+            ['generate <idea>', 'Create plan from idea'],
+            ['doctor', 'Check project health']
+        ]],
+        ['AI Agents', [
+            ['agents', 'List all agents'],
+            ['run <agent>', 'Run specific agent'],
+            ['swarm <task>', 'Run agent pipeline']
+        ]],
+        ['Monitoring', [
+            ['status', 'Show project status'],
+            ['dashboard', 'Open web dashboard'],
+            ['watch', 'Watch for changes']
+        ]],
+        ['Integration', [
+            ['serve', 'Start MCP server'],
+            ['config --mcp', 'Generate MCP config'],
+            ['hooks', 'Install git hooks']
+        ]]
+    ];
+
+    commands.forEach(([section, cmds]) => {
+        console.log(`  ${theme.subtitle(section)}`);
+        cmds.forEach(([cmd, desc]) => {
+            console.log(`    ${theme.accent(cmd.padEnd(18))} ${theme.dim(desc)}`);
+        });
+        console.log('');
+    });
+}
+
+// ═══════════════════════════════════════════════════════════════
+// EXPORT ALL
+// ═══════════════════════════════════════════════════════════════
+
+export default {
+    showStartup,
+    showMainInterface,
+    showStatus,
+    showAgentsList,
+    showSwarmPipeline,
+    showHelp
+};

package/lib/ui/spinners.js

@@ -0,0 +1,116 @@
+// Ultra-Dex CLI — Spinner & Loading Animations
+// Professional loading states like Gemini CLI
+
+import chalk from 'chalk';
+import ora from 'ora';
+import { theme } from './theme.js';
+
+// ═══════════════════════════════════════════════════════════════
+// CUSTOM SPINNER (Matrix-style green)
+// ═══════════════════════════════════════════════════════════════
+
+const doomsdaySpinner = {
+    interval: 80,
+    frames: [
+        '▰▱▱▱▱▱▱',
+        '▰▰▱▱▱▱▱',
+        '▰▰▰▱▱▱▱',
+        '▰▰▰▰▱▱▱',
+        '▰▰▰▰▰▱▱',
+        '▰▰▰▰▰▰▱',
+        '▰▰▰▰▰▰▰',
+        '▱▰▰▰▰▰▰',
+        '▱▱▰▰▰▰▰',
+        '▱▱▱▰▰▰▰',
+        '▱▱▱▱▰▰▰',
+        '▱▱▱▱▱▰▰',
+        '▱▱▱▱▱▱▰'
+    ]
+};
+
+const dotSpinner = {
+    interval: 80,
+    frames: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏']
+};
+
+const pulseSpinner = {
+    interval: 100,
+    frames: ['●', '◉', '○', '◉']
+};
+
+// ═══════════════════════════════════════════════════════════════
+// SPINNER FACTORY
+// ═══════════════════════════════════════════════════════════════
+
+export function createSpinner(text, type = 'default') {
+    const spinnerType = type === 'progress' ? doomsdaySpinner :
+        type === 'pulse' ? pulseSpinner : dotSpinner;
+
+    return ora({
+        text: theme.dim(text),
+        spinner: spinnerType,
+        color: 'green'
+    });
+}
+
+export function startLoading(text) {
+    const spinner = createSpinner(text);
+    spinner.start();
+    return spinner;
+}
+
+export function succeed(spinner, text) {
+    spinner.succeed(theme.success(text));
+}
+
+export function fail(spinner, text) {
+    spinner.fail(theme.error(text));
+}
+
+// ═══════════════════════════════════════════════════════════════
+// TASK LIST (Like Gemini's multi-step tasks)
+// ═══════════════════════════════════════════════════════════════
+
+export async function runTaskList(tasks) {
+    console.log('');
+
+    for (let i = 0; i < tasks.length; i++) {
+        const task = tasks[i];
+        const spinner = createSpinner(task.title, 'progress');
+        spinner.start();
+
+        try {
+            await task.fn();
+            spinner.succeed(theme.success(task.title));
+        } catch (error) {
+            spinner.fail(theme.error(`${task.title}: ${error.message}`));
+            throw error;
+        }
+    }
+
+    console.log('');
+}
+
+// ═══════════════════════════════════════════════════════════════
+// TYPING EFFECT (Like AI typing response)
+// ═══════════════════════════════════════════════════════════════
+
+export async function typeText(text, speed = 20) {
+    for (const char of text) {
+        process.stdout.write(theme.primary(char));
+        await new Promise(r => setTimeout(r, speed));
+    }
+    console.log('');
+}
+
+// ═══════════════════════════════════════════════════════════════
+// COUNTDOWN
+// ═══════════════════════════════════════════════════════════════
+
+export async function countdown(seconds, message) {
+    for (let i = seconds; i > 0; i--) {
+        process.stdout.write(`\r  ${theme.accent(i)} ${theme.dim(message)}`);
+        await new Promise(r => setTimeout(r, 1000));
+    }
+    process.stdout.write('\r' + ' '.repeat(60) + '\r');
+}

package/lib/ui/theme.js

@@ -0,0 +1,183 @@
+// Ultra-Dex CLI — Professional Purple Theme
+// This file provides the visual styling for the CLI
+
+import chalk from 'chalk';
+import gradient from 'gradient-string';
+
+// ═══════════════════════════════════════════════════════════════
+// PROFESSIONAL PURPLE COLOR PALETTE
+// ═══════════════════════════════════════════════════════════════
+
+export const themeColors = {
+  primary: '#6366f1',     // Indigo
+  secondary: '#8b5cf6',   // Purple
+  accent: '#d946ef',      // Pink
+  success: '#22c55e',     // Green
+  warning: '#f59e0b',     // Amber
+  error: '#ef4444',       // Red
+  dim: '#6b7280',         // Gray
+  muted: '#4b5563'        // Darker Gray
+};
+
+export const ultraGradient = gradient(['#6366f1', '#8b5cf6', '#d946ef']);
+
+export const theme = {
+    // Primary brand colors
+    primary: chalk.hex(themeColors.primary),
+    secondary: chalk.hex(themeColors.secondary),
+    accent: chalk.hex(themeColors.accent),
+
+    // Status colors
+    success: chalk.hex(themeColors.success),
+    error: chalk.hex(themeColors.error),
+    warning: chalk.hex(themeColors.warning),
+    info: chalk.hex(themeColors.primary),
+
+    // Text styles
+    title: chalk.hex(themeColors.secondary).bold,
+    subtitle: chalk.hex(themeColors.primary),
+    dim: chalk.hex(themeColors.dim),
+    muted: chalk.hex(themeColors.muted),
+
+    // Special
+    highlight: chalk.hex(themeColors.secondary).inverse,
+    link: chalk.hex(themeColors.primary).underline,
+    code: chalk.hex(themeColors.accent),
+};
+
+// ═══════════════════════════════════════════════════════════════
+// STYLED COMPONENTS
+// ═══════════════════════════════════════════════════════════════
+
+export function box(content, title = '') {
+    const width = 60;
+    const border = theme.secondary;
+
+    const top = border('╭' + '─'.repeat(width - 2) + '╮');
+    const bottom = border('╰' + '─'.repeat(width - 2) + '╯');
+    const side = border('│');
+
+    const lines = content.split('\n');
+    const paddedLines = lines.map(line => {
+        const padding = width - 4 - stripAnsi(line).length;
+        return `${side} ${line}${' '.repeat(Math.max(0, padding))} ${side}`;
+    });
+
+    let titleBar = '';
+    if (title) {
+        const titlePadding = Math.floor((width - 4 - title.length) / 2);
+        titleBar = border('│') + ' '.repeat(titlePadding) + theme.title(title) + ' '.repeat(width - 4 - titlePadding - title.length) + border('│') + '\n';
+        titleBar += border('├' + '─'.repeat(width - 2) + '┤') + '\n';
+    }
+
+    return top + '\n' + titleBar + paddedLines.join('\n') + '\n' + bottom;
+}
+
+export function divider(char = '─', width = 60) {
+    return theme.dim(char.repeat(width));
+}
+
+export function header(text) {
+    console.log('');
+    console.log(theme.title(`  ${text}`));
+    console.log(theme.dim('  ' + '─'.repeat(56)));
+}
+
+export function subheader(text) {
+    console.log(theme.subtitle(`  ${text}`));
+}
+
+// ═══════════════════════════════════════════════════════════════
+// STATUS INDICATORS
+// ═══════════════════════════════════════════════════════════════
+
+export const status = {
+    success: theme.success('✓'),
+    error: theme.error('✗'),
+    warning: theme.warning('⚠'),
+    info: theme.info('ℹ'),
+    pending: theme.dim('○'),
+    running: theme.accent('◉'),
+    arrow: theme.primary('→'),
+    bullet: theme.dim('•'),
+};
+
+export function statusLine(icon, text, detail = '') {
+    const detailText = detail ? theme.dim(` · ${detail}`) : '';
+    console.log(`  ${icon} ${text}${detailText}`);
+}
+
+// ═══════════════════════════════════════════════════════════════
+// TABLE STYLING
+// ═══════════════════════════════════════════════════════════════
+
+export function table(headers, rows) {
+    const colWidths = headers.map((h, i) => {
+        const maxRow = Math.max(...rows.map(r => String(r[i] || '').length));
+        return Math.max(h.length, maxRow) + 2;
+    });
+
+    const border = theme.dim;
+
+    // Top border
+    console.log(border('  ┌' + colWidths.map(w => '─'.repeat(w)).join('┬') + '┐'));
+
+    // Header row
+    const headerRow = headers.map((h, i) => theme.title(h.padEnd(colWidths[i] - 2))).join(border(' │ '));
+    console.log(border('  │ ') + headerRow + border(' │'));
+
+    // Header separator
+    console.log(border('  ├' + colWidths.map(w => '─'.repeat(w)).join('┼') + '┤'));
+
+    // Data rows
+    rows.forEach(row => {
+        const rowText = row.map((cell, i) => String(cell || '').padEnd(colWidths[i] - 2)).join(border(' │ '));
+        console.log(border('  │ ') + rowText + border(' │'));
+    });
+
+    // Bottom border
+    console.log(border('  └' + colWidths.map(w => '─'.repeat(w)).join('┴') + '┘'));
+}
+
+// ═══════════════════════════════════════════════════════════════
+// PROGRESS & LOADING
+// ═══════════════════════════════════════════════════════════════
+
+export function progressBar(current, total, width = 40) {
+    const percentage = Math.round((current / total) * 100);
+    const filled = Math.round((current / total) * width);
+    const empty = width - filled;
+
+    const bar = theme.primary('█'.repeat(filled)) + theme.dim('░'.repeat(empty));
+    return `${bar} ${theme.accent(percentage + '%')}`;
+}
+
+export function loadingDots() {
+    const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+    let i = 0;
+    return setInterval(() => {
+        process.stdout.write(`\r  ${theme.accent(frames[i])} `);
+        i = (i + 1) % frames.length;
+    }, 80);
+}
+
+// ═══════════════════════════════════════════════════════════════
+// KEYBOARD HINTS
+// ═══════════════════════════════════════════════════════════════
+
+export function keyHints(hints) {
+    const formattedHints = hints.map(([key, action]) =>
+        `${theme.highlight(` ${key} `)} ${theme.dim(action)}`
+    ).join('  ');
+
+    console.log('');
+    console.log(`  ${formattedHints}`);
+}
+
+// ═══════════════════════════════════════════════════════════════
+// HELPER
+// ═══════════════════════════════════════════════════════════════
+
+function stripAnsi(str) {
+    return str.replace(/\x1b\[[0-9;]*m/g, '');
+}

package/lib/utils/agents.js

@@ -0,0 +1,32 @@
+// cli/lib/utils/agents.js
+export const agents = {
+  // Leadership Tier
+  cto: { name: 'Chief Architect', emoji: '📐', tagline: 'Defining system architecture' },
+  planner: { name: 'Product Planner', emoji: '📋', tagline: 'breaking down requirements' },
+  research: { name: 'Research Analyst', emoji: '🔍', tagline: 'Analyzing patterns' },
+  
+  // Development Tier
+  backend: { name: 'Backend Engineer', emoji: '⚙️', tagline: 'Building API services' },
+  frontend: { name: 'Frontend Engineer', emoji: '🎨', tagline: 'Crafting user interfaces' },
+  database: { name: 'Data Architect', emoji: '💾', tagline: 'Optimizing schema' },
+  
+  // Security Tier
+  auth: { name: 'Security Engineer', emoji: '🔒', tagline: 'Securing access' },
+  security: { name: 'Security Auditor', emoji: '🛡️', tagline: 'Auditing vulnerabilities' },
+  
+  // DevOps Tier
+  devops: { name: 'DevOps Engineer', emoji: '🚀', tagline: 'Managing deployment' },
+  
+  // Quality Tier
+  testing: { name: 'QA Engineer', emoji: '🧪', tagline: 'Ensuring quality' },
+  documentation: { name: 'Tech Writer', emoji: '📝', tagline: 'Documenting systems' },
+  reviewer: { name: 'Code Reviewer', emoji: '👀', tagline: 'Reviewing code quality' },
+  debugger: { name: 'Debug Specialist', emoji: '🐛', tagline: 'Resolving issues' },
+  
+  // Specialist Tier
+  performance: { name: 'Performance Engineer', emoji: '⚡', tagline: 'Optimizing speed' },
+  refactoring: { name: 'Refactoring Specialist', emoji: '♻️', tagline: 'Improving code structure' }
+};
+
+// For compatibility if swarm.js imports avengersAgents
+export const avengersAgents = agents;

package/lib/utils/help.js

@@ -0,0 +1,64 @@
+import chalk from 'chalk';
+import gradient from 'gradient-string';
+import { isDoomsdayMode } from './theme-state.js';
+import { showHelp as showDoomsdayHelp } from '../themes/doomsday.js';
+
+const ultraGradient = gradient(['#6366f1', '#8b5cf6', '#d946ef']);
+
+export function showHelp() {
+  if (isDoomsdayMode()) {
+    return showDoomsdayHelp();
+  }
+
+  console.log('');
+  console.log(ultraGradient('  ═══════════════════════════════════════════════'));
+  console.log(ultraGradient('  ║        U L T R A - D E X  :  O R C H E S T R A T I O N'));
+  console.log(ultraGradient('  ═══════════════════════════════════════════════'));
+  console.log('');
+  
+  const sections = [
+    {
+      title: '🚀 PROJECT SETUP',
+      commands: [
+        ['init', 'Initialize new project'],
+        ['generate', 'Generate implementation plan'],
+        ['swarm', 'Run agent pipeline']
+      ]
+    },
+    {
+      title: '🛡️ QUALITY & DEFENSE',
+      commands: [
+        ['review', 'Run code review'],
+        ['validate', 'Check project integrity'],
+        ['hooks', 'Install git hooks']
+      ]
+    },
+    {
+      title: '⚡ ACTIVE KERNEL',
+      commands: [
+        ['serve', 'Start MCP server & dashboard'],
+        ['dashboard', 'Open web dashboard'],
+        ['agents', 'List available agents']
+      ]
+    },
+    {
+      title: '📦 DEPLOYMENT',
+      commands: [
+        ['build', 'Execute next task'],
+        ['deploy', 'Deploy application'],
+        ['doctor', 'System diagnostics']
+      ]
+    }
+  ];
+  
+  sections.forEach(section => {
+    console.log(`  ${chalk.hex('#8b5cf6').bold(section.title)}`);
+    section.commands.forEach(([cmd, desc]) => {
+      console.log(`    ${chalk.hex('#6366f1')(cmd.padEnd(16))} ${chalk.dim(desc)}`);
+    });
+    console.log('');
+  });
+  
+  console.log(chalk.dim('  "AI Orchestration Meta-Layer for Professional SaaS Development"'));
+  console.log('');
+}

package/lib/utils/messages.js

@@ -0,0 +1,35 @@
+// cli/lib/utils/messages.js
+export const professionalMessages = {
+  start: [
+    "AI Orchestration initialized. Ready for mission.",
+    "Analyzing project graph for optimal path...",
+    "System check complete. Starting task execution.",
+    "Leveraging 16 specialized agents for development."
+  ],
+  
+  success: [
+    "✓ Task completed successfully. Alignment verified.",
+    "✓ System integrity confirmed. Code merged.",
+    "✓ Orchestration successful. Results saved.",
+    "✓ Professional SaaS standards achieved."
+  ],
+  
+  error: [
+    "✕ Task failed. Analyzing logs for recovery...",
+    "✕ System anomaly detected. Diagnostic required.",
+    "✕ Orchestration interrupted. Please check configuration.",
+    "✕ Quality gate failed. Refactoring recommended."
+  ],
+  
+  loading: [
+    "Initializing agent pipeline...",
+    "Scanning project context...",
+    "Optimizing orchestration logic...",
+    "Verifying system state..."
+  ]
+};
+
+export function getRandomMessage(type) {
+  const messages = professionalMessages[type];
+  return messages[Math.floor(Math.random() * messages.length)];
+}