ultra-dex 2.2.1 → 3.2.0

package/lib/utils/graph.js

@@ -0,0 +1,108 @@
+/**
+ * Graph Utility (CPG Implementation)
+ * Manages the Code Property Graph (CPG) for architectural memory
+ */
+
+import fs from 'fs/promises';
+import path from 'path';
+import { glob } from 'glob';
+
+/**
+ * Build a simple Code Property Graph (CPG)
+ * Maps files, functions, and dependencies
+ */
+export async function buildGraph() {
+  const files = await glob('**/*.{js,ts,jsx,tsx}', { 
+    ignore: ['node_modules/**', '.git/**', 'dist/**', 'build/**'],
+    nodir: true 
+  });
+
+  const graph = {
+    nodes: [],
+    edges: [],
+    lastUpdated: new Date().toISOString()
+  };
+
+  for (const file of files) {
+    try {
+      const content = await fs.readFile(file, 'utf8');
+      const fileNode = {
+        id: file,
+        type: 'file',
+        path: file,
+        exports: [],
+        imports: []
+      };
+
+      // Naive parsing using Regex (Phase 2.1)
+      // In Phase 2.2+ this would use tree-sitter
+      
+      // Extract imports
+      const importRegex = /import\s+.*?\s+from\s+['"](.+?)['"]/g;
+      let match;
+      while ((match = importRegex.exec(content)) !== null) {
+        fileNode.imports.push(match[1]);
+        graph.edges.push({
+          source: file,
+          target: match[1],
+          type: 'depends_on'
+        });
+      }
+
+      // Extract function declarations
+      const funcRegex = /(?:export\s+)?(?:async\s+)?function\s+([a-zA-Z0-9_]+)/g;
+      while ((match = funcRegex.exec(content)) !== null) {
+        const funcName = match[1];
+        const funcId = `${file}:${funcName}`;
+        graph.nodes.push({
+          id: funcId,
+          type: 'function',
+          name: funcName,
+          parent: file
+        });
+        graph.edges.push({
+          source: funcId,
+          target: file,
+          type: 'contained_in'
+        });
+        fileNode.exports.push(funcName);
+      }
+
+      graph.nodes.push(fileNode);
+    } catch (e) {
+      // Skip files that can't be read
+    }
+  }
+
+  return graph;
+}
+
+/**
+ * Find the impact of changing a file
+ * @param {Object} graph - The CPG
+ * @param {string} filePath - The file being changed
+ */
+export function getImpactAnalysis(graph, filePath) {
+  const impactedBy = graph.edges
+    .filter(edge => edge.target === filePath || filePath.endsWith(edge.target))
+    .map(edge => edge.source);
+  
+  return [...new Set(impactedBy)];
+}
+
+/**
+ * Find structural truth (exact subgraph)
+ * @param {Object} graph - The CPG
+ * @param {string} query - Symbol name
+ */
+export function queryGraph(graph, query) {
+  return graph.nodes.filter(node => 
+    node.id.includes(query) || (node.name && node.name === query)
+  );
+}
+
+export default {
+  buildGraph,
+  getImpactAnalysis,
+  queryGraph
+};

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)];
+}

package/lib/utils/progress.js

@@ -0,0 +1,24 @@
+import chalk from 'chalk';
+import ora from 'ora';
+
+export function showProgress(tasks) {
+  const total = tasks.length;
+  console.log('');
+  console.log(chalk.hex('#8b5cf6').bold('  ⚡ EXECUTING TASKS...'));
+  console.log('');
+  
+  tasks.forEach((task, idx) => {
+    // Simple vertical list for now
+    console.log(`  ${chalk.hex('#d946ef')('►')} ${task}`);
+  });
+  console.log('');
+}
+
+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 = chalk.hex('#6366f1')('█'.repeat(filled)) + chalk.dim('░'.repeat(empty));
+  return `${bar} ${chalk.hex('#d946ef')(percentage + '%')}`;
+}

package/lib/utils/prompts.js

@@ -0,0 +1,47 @@
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import gradient from 'gradient-string';
+
+export async function selectAgent() {
+  const agents = [
+    { name: '🏛️  CTO - Architecture decisions', value: 'cto' },
+    { name: '📋  Planner - Task breakdown', value: 'planner' },
+    { name: '🔧  Backend - API & server', value: 'backend' },
+    { name: '🎨  Frontend - UI components', value: 'frontend' },
+    { name: '💾  Database - Schema & queries', value: 'database' },
+    { name: '🔐  Auth - Authentication', value: 'auth' },
+    { name: '🛡️  Security - Security review', value: 'security' },
+    { name: '📝  Testing - Write tests', value: 'testing' },
+    { name: '📖  Docs - Documentation', value: 'documentation' },
+    { name: '👀  Reviewer - Code review', value: 'reviewer' }
+  ];
+  const { agent } = await inquirer.prompt([{
+    type: 'list',
+    name: 'agent',
+    message: gradient(['#6366f1', '#8b5cf6'])('Select an agent:'),
+    choices: agents,
+    pageSize: 12
+  }]);
+  
+  return agent;
+}
+
+export async function confirmAction(message) {
+  const { confirm } = await inquirer.prompt([{
+    type: 'confirm',
+    name: 'confirm',
+    message: chalk.yellow(message),
+    default: false
+  }]);
+  return confirm;
+}
+
+export async function inputText(message, defaultValue = '') {
+  const { value } = await inquirer.prompt([{
+    type: 'input',
+    name: 'value',
+    message: chalk.cyan(message),
+    default: defaultValue
+  }]);
+  return value;
+}

package/lib/utils/spinners.js

@@ -0,0 +1,46 @@
+import ora from 'ora';
+import chalk from 'chalk';
+
+const spinnerFrames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+
+export function createSpinner(text) {
+  return ora({
+    text: chalk.cyan(text),
+    spinner: {
+      interval: 80,
+      frames: spinnerFrames
+    },
+    color: 'magenta'
+  });
+}
+
+export function success(text) {
+  return ora().succeed(chalk.green(text));
+}
+
+export function fail(text) {
+  return ora().fail(chalk.red(text));
+}
+
+export function info(text) {
+  return ora().info(chalk.blue(text));
+}
+
+export function warn(text) {
+  return ora().warn(chalk.yellow(text));
+}
+
+// Task list with progress
+export async function runTasks(tasks) {
+  for (const task of tasks) {
+    const spinner = createSpinner(task.title);
+    spinner.start();
+    try {
+      await task.fn();
+      spinner.succeed(chalk.green(task.title));
+    } catch (error) {
+      spinner.fail(chalk.red(`${task.title}: ${error.message}`));
+      throw error;
+    }
+  }
+}

package/lib/utils/status.js

@@ -0,0 +1,31 @@
+import chalk from 'chalk';
+import figures from 'figures';
+
+export const icons = {
+  success: chalk.hex('#22c55e')(figures.tick),
+  error: chalk.hex('#ef4444')(figures.cross),
+  warning: chalk.hex('#f59e0b')(figures.warning),
+  info: chalk.hex('#6366f1')(figures.info),
+  pending: chalk.hex('#6b7280')(figures.circle),
+  running: chalk.hex('#d946ef')(figures.play),
+  pointer: chalk.hex('#8b5cf6')(figures.pointer),
+  bullet: chalk.dim(figures.bullet)
+};
+
+export function showInfinityStatus() {
+  // Deprecated function, kept for compatibility if called elsewhere but showing nothing or simple status
+}
+
+export function statusLine(icon, text) {
+  console.log(`  ${icon} ${text}`);
+}
+
+export function header(text) {
+  console.log('');
+  console.log(chalk.bold.hex('#8b5cf6')(`  ${text}`));
+  console.log(chalk.dim('  ' + '─'.repeat(50)));
+}
+
+export function separator() {
+  console.log('');
+}

package/lib/utils/tables.js

@@ -0,0 +1,41 @@
+import Table from 'cli-table3';
+import chalk from 'chalk';
+import gradient from 'gradient-string';
+
+export function createTable(headers, rows) {
+  const table = new Table({
+    head: headers.map(h => gradient(['#6366f1', '#8b5cf6'])(h)),
+    chars: {
+      'top': '─', 'top-mid': '┬', 'top-left': '╭', 'top-right': '╮',
+      'bottom': '─', 'bottom-mid': '┴', 'bottom-left': '╰', 'bottom-right': '╯',
+      'left': '│', 'left-mid': '├', 'mid': '─', 'mid-mid': '┼',
+      'right': '│', 'right-mid': '┤', 'middle': '│'
+    },
+    style: {
+      head: ['magenta'],
+      border: ['dim']
+    }
+  });
+  
+  rows.forEach(row => table.push(row));
+  return table.toString();
+}
+
+export function showAgentsTable(agents) {
+  const headers = ['Tier', 'Agent', 'Status'];
+  const rows = agents.map(a => [
+    chalk.dim(a.tier || 'N/A'),
+    chalk.cyan(a.name),
+    a.status === 'ready' ? chalk.green('●') : chalk.yellow('○')
+  ]);
+  console.log(createTable(headers, rows));
+}
+
+export function showCommandsTable(commands) {
+  const headers = ['Command', 'Description'];
+  const rows = commands.map(c => [
+    chalk.cyan(c.name),
+    chalk.dim(c.description)
+  ]);
+  console.log(createTable(headers, rows));
+}

package/lib/utils/theme-state.js

@@ -0,0 +1,9 @@
+export let isDoomsday = false;
+
+export function setDoomsdayMode(enabled) {
+  isDoomsday = enabled;
+}
+
+export function isDoomsdayMode() {
+  return isDoomsday;
+}

package/lib/utils/version-display.js

@@ -0,0 +1,32 @@
+import boxen from 'boxen';
+import chalk from 'chalk';
+import gradient from 'gradient-string';
+
+export function showVersionCard() {
+  const version = '3.1.0';
+  const ultra = gradient(['#6366f1', '#8b5cf6'])('Ultra-Dex');
+  
+  console.log(boxen(
+    `${ultra} ${chalk.dim('v')}${chalk.bold.white(version)}
+
+` +
+    `${chalk.cyan('◆')} AI Orchestration Meta-Layer
+` +
+    `${chalk.magenta('◆')} 35 Commands • 16 Agents
+` +
+    `${chalk.yellow('◆')} MCP Server • Swarm Mode
+
+` +
+    `${chalk.dim('npm install -g ultra-dex')}
+` +
+    `${chalk.dim('github.com/Srujan0798/Ultra-Dex')}`,
+    {
+      padding: 1,
+      margin: 1,
+      borderStyle: 'double',
+      borderColor: '#8b5cf6',
+      title: '🪐 Ultra-Dex',
+      titleAlignment: 'center'
+    }
+  ));
+}

package/package.json

@@ -1,20 +1,18 @@
 {
   "name": "ultra-dex",
-  "version": "2.2.1",
-  "description": "CLI for Ultra-Dex SaaS Implementation Framework with AI-Powered Plan Generation, Build Mode, and Code Review",
+  "version": "3.2.0",
+  "description": "AI Orchestration Meta-Layer for SaaS Development",
   "keywords": [
-    "saas",
-    "template",
-    "implementation",
-    "planning",
-    "startup",
-    "framework",
     "ai",
+    "orchestration",
+    "saas",
+    "mcp",
+    "langchain",
     "claude",
     "openai",
     "gemini",
-    "orchestration",
-    "mcp"
+    "agents",
+    "swarm"
   ],
   "author": "Srujan Sai Karna",
   "license": "MIT",
@@ -36,15 +34,35 @@
     "node": ">=18"
   },
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "boxen": "^7.1.1",
     "chalk": "^5.3.0",
+    "cli-table3": "^0.6.5",
     "commander": "^11.1.0",
+    "figures": "^6.1.0",
+    "glob": "^10.5.0",
+    "gradient-string": "^2.0.2",
+    "ink": "^4.4.1",
+    "ink-spinner": "^5.0.0",
     "inquirer": "^9.2.12",
-    "ora": "^8.0.1"
+    "listr2": "^8.3.3",
+    "ora": "^8.0.1",
+    "terminal-link": "^3.0.0",
+    "update-notifier": "^7.3.1",
+    "ws": "^8.19.0",
+    "zod": "^3.25.76"
+  },
+  "scripts": {
+    "test": "node --test test/*.test.js",
+    "lint": "eslint lib bin --fix"
   },
   "optionalDependencies": {
     "@anthropic-ai/sdk": "^0.30.0",
-    "openai": "^4.70.0",
     "@google/generative-ai": "^0.21.0",
-    "dotenv": "^16.4.5"
+    "dotenv": "^16.4.5",
+    "openai": "^4.70.0"
+  },
+  "devDependencies": {
+    "eslint": "^8.57.0"
   }
 }