ultra-dex 1.7.3 → 2.2.0

package/lib/commands/agents.js

@@ -0,0 +1,154 @@
+import chalk from 'chalk';
+import fs from 'fs/promises';
+import path from 'path';
+import { ASSETS_ROOT, ROOT_FALLBACK } from '../config/paths.js';
+import { githubBlobUrl } from '../config/urls.js';
+
+export const AGENTS = [
+  { name: 'cto', description: 'Architecture & tech decisions', file: '1-leadership/cto.md', tier: 'Leadership' },
+  { name: 'planner', description: 'Task breakdown & planning', file: '1-leadership/planner.md', tier: 'Leadership' },
+  { name: 'research', description: 'Technology evaluation & comparison', file: '1-leadership/research.md', tier: 'Leadership' },
+  { name: 'backend', description: 'API & server logic', file: '2-development/backend.md', tier: 'Development' },
+  { name: 'database', description: 'Schema design & queries', file: '2-development/database.md', tier: 'Development' },
+  { name: 'frontend', description: 'UI & components', file: '2-development/frontend.md', tier: 'Development' },
+  { name: 'auth', description: 'Authentication & authorization', file: '3-security/auth.md', tier: 'Security' },
+  { name: 'security', description: 'Security audits & vulnerability fixes', file: '3-security/security.md', tier: 'Security' },
+  { name: 'devops', description: 'Deployment & infrastructure', file: '4-devops/devops.md', tier: 'DevOps' },
+  { name: 'debugger', description: 'Bug fixing & troubleshooting', file: '5-quality/debugger.md', tier: 'Quality' },
+  { name: 'documentation', description: 'Technical writing & docs maintenance', file: '5-quality/documentation.md', tier: 'Quality' },
+  { name: 'reviewer', description: 'Code review & quality check', file: '5-quality/reviewer.md', tier: 'Quality' },
+  { name: 'testing', description: 'QA & test automation', file: '5-quality/testing.md', tier: 'Quality' },
+  { name: 'performance', description: 'Performance optimization', file: '6-specialist/performance.md', tier: 'Specialist' },
+  { name: 'refactoring', description: 'Code quality & design patterns', file: '6-specialist/refactoring.md', tier: 'Specialist' },
+];
+
+async function readAgentPrompt(agent) {
+  const agentPath = path.join(ASSETS_ROOT, 'agents', agent.file);
+  try {
+    return await fs.readFile(agentPath, 'utf-8');
+  } catch (err) {
+    const fallbackPath = path.join(ROOT_FALLBACK, 'agents', agent.file);
+    return await fs.readFile(fallbackPath, 'utf-8');
+  }
+}
+
+export function registerAgentsCommand(program) {
+  program
+    .command('agents')
+    .description('List available AI agent prompts')
+    .action(() => {
+      console.log(chalk.bold('\n🤖 Ultra-Dex AI Agents (15 Total)\n'));
+      console.log(chalk.gray('Organized by tier for production pipeline\n'));
+
+      let currentTier = '';
+      AGENTS.forEach((agent) => {
+        if (agent.tier !== currentTier) {
+          currentTier = agent.tier;
+          console.log(chalk.bold(`\n  ${currentTier} Tier:`));
+        }
+        console.log(chalk.cyan(`    ${agent.name}`) + chalk.gray(` - ${agent.description}`));
+      });
+
+      console.log('\n' + chalk.bold('Usage:'));
+      console.log(chalk.gray('  ultra-dex agent <name>   Show agent prompt'));
+      console.log(chalk.gray('  ultra-dex agent backend  Example: show backend agent'));
+
+      console.log(`\n${chalk.gray(`Agent Index: ${githubBlobUrl('agents/00-AGENT_INDEX.md')}\n`)}`);
+    });
+
+  program
+    .command('agent <name>')
+    .description('Show a specific agent prompt')
+    .action(async (name) => {
+      const agent = AGENTS.find(a => a.name.toLowerCase() === name.toLowerCase());
+
+      if (!agent) {
+        console.log(chalk.red(`\n❌ Agent "${name}" not found.\n`));
+        console.log(chalk.gray('Available agents:'));
+        AGENTS.forEach(a => console.log(chalk.cyan(`  - ${a.name}`)));
+        console.log('\n' + chalk.gray('Run "ultra-dex agents" to see all agents.\n'));
+        process.exit(1);
+      }
+
+      try {
+        const content = await readAgentPrompt(agent);
+        console.log(chalk.bold(`\n🤖 ${agent.name.toUpperCase()} Agent\n`));
+        console.log(chalk.gray('─'.repeat(60)));
+        console.log(content);
+        console.log(chalk.gray('─'.repeat(60)));
+        console.log(chalk.bold('\n📋 Copy the above prompt and paste into your AI tool.\n'));
+      } catch (err) {
+        console.log(chalk.bold(`\n🤖 ${agent.name.toUpperCase()} Agent\n`));
+        console.log(chalk.gray('View full prompt on GitHub:'));
+        console.log(chalk.blue(`  ${githubBlobUrl(`agents/${agent.file}`)}\n`));
+      }
+    });
+}
+
+export function registerPackCommand(program) {
+  program
+    .command('pack <agent>')
+    .description('Package project context + agent prompt for any AI tool')
+    .option('-c, --clipboard', 'Copy to clipboard (requires pbcopy/xclip)')
+    .action(async (agentName, options) => {
+      const agent = AGENTS.find(a => a.name.toLowerCase() === agentName.toLowerCase());
+      if (!agent) {
+        console.log(chalk.red(`\n❌ Agent "${agentName}" not found.\n`));
+        console.log(chalk.gray('Available agents:'));
+        AGENTS.forEach(a => console.log(chalk.cyan(`  - ${a.name}`)));
+        process.exit(1);
+      }
+
+      let output = '';
+
+      try {
+        const agentPrompt = await readAgentPrompt(agent);
+        output += agentPrompt + '\n\n';
+      } catch (err) {
+        output += `# ${agent.name.toUpperCase()} Agent\n\nSee: ${githubBlobUrl(`agents/${agent.file}`)}\n\n`;
+      }
+
+      output += '---\n\n';
+
+      try {
+        const context = await fs.readFile('CONTEXT.md', 'utf-8');
+        output += '# PROJECT CONTEXT\n\n' + context + '\n\n';
+      } catch (err) {
+        output += '# PROJECT CONTEXT\n\n*No CONTEXT.md found. Run `ultra-dex init` first.*\n\n';
+      }
+
+      output += '---\n\n';
+
+      try {
+        const plan = await fs.readFile('IMPLEMENTATION-PLAN.md', 'utf-8');
+        output += '# IMPLEMENTATION PLAN\n\n' + plan + '\n';
+      } catch (err) {
+        output += '# IMPLEMENTATION PLAN\n\n*No IMPLEMENTATION-PLAN.md found. Run `ultra-dex init` first.*\n';
+      }
+
+      console.log(chalk.bold(`\n📦 Packed context for @${agent.name}\n`));
+      console.log(chalk.gray('─'.repeat(60)));
+      console.log(output);
+      console.log(chalk.gray('─'.repeat(60)));
+
+      if (options.clipboard) {
+        try {
+          const { execSync } = await import('child_process');
+          const platform = process.platform;
+          if (platform === 'darwin') {
+            execSync('pbcopy', { input: output });
+            console.log(chalk.green('\n✅ Copied to clipboard!\n'));
+          } else if (platform === 'linux') {
+            execSync('xclip -selection clipboard', { input: output });
+            console.log(chalk.green('\n✅ Copied to clipboard!\n'));
+          } else {
+            console.log(chalk.yellow('\n⚠️  Clipboard not supported on this platform. Copy manually.\n'));
+          }
+        } catch (err) {
+          console.log(chalk.yellow('\n⚠️  Could not copy to clipboard. Copy manually.\n'));
+        }
+      } else {
+        console.log(chalk.cyan('\n💡 Tip: Use --clipboard flag to copy directly\n'));
+      }
+    });
+}

package/lib/commands/audit.js

@@ -0,0 +1,135 @@
+import chalk from 'chalk';
+import fs from 'fs/promises';
+import path from 'path';
+import { validateSafePath } from '../utils/validation.js';
+import { githubWebUrl } from '../config/urls.js';
+
+export function registerAuditCommand(program) {
+  program
+    .command('audit')
+    .description('Audit your Ultra-Dex project for completeness')
+    .option('-d, --dir <directory>', 'Project directory to audit', '.')
+    .action(async (options) => {
+      console.log(chalk.cyan('\n🔍 Ultra-Dex Project Audit\n'));
+
+      const dirValidation = validateSafePath(options.dir, 'Project directory');
+      if (dirValidation !== true) {
+        console.log(chalk.red(dirValidation));
+        process.exit(1);
+      }
+
+      const projectDir = path.resolve(options.dir);
+      let score = 0;
+      let maxScore = 0;
+      const results = [];
+
+      async function checkFile(filePath, description, points) {
+        maxScore += points;
+        try {
+          const content = await fs.readFile(path.join(projectDir, filePath), 'utf-8');
+          if (content.length > 50) {
+            score += points;
+            results.push({ status: '✅', item: description, points: `+${points}` });
+            return content;
+          } else {
+            results.push({ status: '⚠️', item: `${description} (empty/too short)`, points: '0' });
+            return null;
+          }
+        } catch {
+          results.push({ status: '❌', item: `${description} (missing)`, points: '0' });
+          return null;
+        }
+      }
+
+      function hasSection(content, sectionName, points) {
+        maxScore += points;
+        if (content && content.toLowerCase().includes(sectionName.toLowerCase())) {
+          score += points;
+          results.push({ status: '✅', item: `Has ${sectionName}`, points: `+${points}` });
+          return true;
+        } else {
+          results.push({ status: '❌', item: `Missing ${sectionName}`, points: '0' });
+          return false;
+        }
+      }
+
+      console.log(chalk.bold('Checking project files...\n'));
+
+      const quickStart = await checkFile('QUICK-START.md', 'QUICK-START.md', 10);
+      await checkFile('CONTEXT.md', 'CONTEXT.md', 5);
+      const implPlan = await checkFile('IMPLEMENTATION-PLAN.md', 'IMPLEMENTATION-PLAN.md', 5);
+      await checkFile('04-Imp-Template.md', '04-Imp-Template.md', 10);
+      await checkFile('README.md', 'README.md', 5);
+
+      if (quickStart) {
+        hasSection(quickStart, 'idea', 5);
+        hasSection(quickStart, 'problem', 5);
+        hasSection(quickStart, 'mvp', 5);
+        hasSection(quickStart, 'tech stack', 10);
+        hasSection(quickStart, 'feature', 5);
+      }
+
+      if (implPlan) {
+        hasSection(implPlan, 'database', 5);
+        hasSection(implPlan, 'api', 5);
+        hasSection(implPlan, 'auth', 5);
+      }
+
+      try {
+        await fs.access(path.join(projectDir, 'docs'));
+        score += 5;
+        maxScore += 5;
+        results.push({ status: '✅', item: 'docs/ folder exists', points: '+5' });
+      } catch {
+        maxScore += 5;
+        results.push({ status: '⚠️', item: 'docs/ folder (optional)', points: '0' });
+      }
+
+      console.log(chalk.bold('Audit Results:\n'));
+      results.forEach(r => {
+        const statusColor = r.status === '✅' ? chalk.green : r.status === '❌' ? chalk.red : chalk.yellow;
+        console.log(`  ${statusColor(r.status)} ${r.item} ${chalk.gray(r.points)}`);
+      });
+
+      const percentage = Math.round((score / maxScore) * 100);
+
+      console.log('\n' + chalk.bold('─'.repeat(50)));
+      console.log(chalk.bold(`\nScore: ${score}/${maxScore} (${percentage}%)\n`));
+
+      let grade, gradeColor, message;
+      if (percentage >= 90) {
+        grade = 'A';
+        gradeColor = chalk.green;
+        message = 'Excellent! Your project is well-documented.';
+      } else if (percentage >= 75) {
+        grade = 'B';
+        gradeColor = chalk.green;
+        message = 'Good! A few more sections would help.';
+      } else if (percentage >= 60) {
+        grade = 'C';
+        gradeColor = chalk.yellow;
+        message = 'Fair. Consider filling more sections before coding.';
+      } else if (percentage >= 40) {
+        grade = 'D';
+        gradeColor = chalk.yellow;
+        message = 'Needs work. Use QUICK-START.md to define your project.';
+      } else {
+        grade = 'F';
+        gradeColor = chalk.red;
+        message = 'Run "npx ultra-dex init" to get started properly.';
+      }
+
+      console.log(gradeColor(`Grade: ${grade}`));
+      console.log(chalk.gray(message));
+
+      const missing = results.filter(r => r.status === '❌');
+      if (missing.length > 0) {
+        console.log(chalk.bold('\n📋 To improve your score:\n'));
+        missing.slice(0, 5).forEach(m => {
+          console.log(chalk.cyan(`  → Add ${m.item.replace(' (missing)', '')}`));
+        });
+      }
+
+      console.log(`\n${chalk.gray(`Learn more: ${githubWebUrl()}`)}\n`);
+    });
+}

package/lib/commands/banner.js

@@ -0,0 +1,21 @@
+export const banner = `
+╔═══════════════════════════════════════════════════════════╗
+║                                                           ║
+║   ██╗   ██╗██╗  ████████╗██████╗  █████╗                 ║
+║   ██║   ██║██║  ╚══██╔══╝██╔══██╗██╔══██╗                ║
+║   ██║   ██║██║     ██║   ██████╔╝███████║                ║
+║   ██║   ██║██║     ██║   ██╔══██╗██╔══██║                ║
+║   ╚██████╔╝███████╗██║   ██║  ██║██║  ██║                ║
+║    ╚═════╝ ╚══════╝╚═╝   ╚═╝  ╚═╝╚═╝  ╚═╝                ║
+║                                                           ║
+║   ██████╗ ███████╗██╗  ██╗                               ║
+║   ██╔══██╗██╔════╝╚██╗██╔╝                               ║
+║   ██║  ██║█████╗   ╚███╔╝                                ║
+║   ██║  ██║██╔══╝   ██╔██╗                                ║
+║   ██████╔╝███████╗██╔╝ ██╗                               ║
+║   ╚═════╝ ╚══════╝╚═╝  ╚═╝                               ║
+║                                                           ║
+║   From Idea to Production-Ready SaaS                      ║
+║                                                           ║
+╚═══════════════════════════════════════════════════════════╝
+`;

package/lib/commands/build.js

@@ -0,0 +1,214 @@
+/**
+ * ultra-dex build command
+ * Auto-loads context and starts AI-assisted development
+ */
+
+import chalk from 'chalk';
+import ora from 'ora';
+import inquirer from 'inquirer';
+import fs from 'fs/promises';
+import path from 'path';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+
+const execAsync = promisify(exec);
+
+// Agent configurations
+const AGENTS = {
+  planner: { name: '@Planner', tier: 'Leadership', task: 'Break down features into atomic tasks' },
+  cto: { name: '@CTO', tier: 'Leadership', task: 'Architecture decisions' },
+  backend: { name: '@Backend', tier: 'Development', task: 'API endpoints and business logic' },
+  frontend: { name: '@Frontend', tier: 'Development', task: 'UI components and pages' },
+  database: { name: '@Database', tier: 'Development', task: 'Schema design and migrations' },
+  auth: { name: '@Auth', tier: 'Security', task: 'Authentication and authorization' },
+  security: { name: '@Security', tier: 'Security', task: 'Security audit' },
+  testing: { name: '@Testing', tier: 'Quality', task: 'Write and run tests' },
+  reviewer: { name: '@Reviewer', tier: 'Quality', task: 'Code review' },
+  devops: { name: '@DevOps', tier: 'DevOps', task: 'Deployment and CI/CD' },
+};
+
+async function readFileSafe(filePath) {
+  try {
+    return await fs.readFile(filePath, 'utf-8');
+  } catch {
+    return null;
+  }
+}
+
+async function fileExists(filePath) {
+  try {
+    await fs.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export function registerBuildCommand(program) {
+  program
+    .command('build')
+    .description('Start AI-assisted development with auto-loaded context')
+    .option('-a, --agent <agent>', 'Agent to use (planner, backend, frontend, etc.)')
+    .option('-t, --task <task>', 'Specific task to work on')
+    .option('--copy', 'Copy prompt to clipboard instead of displaying')
+    .option('--cursor', 'Open in Cursor IDE')
+    .action(async (options) => {
+      console.log(chalk.cyan('\n🔧 Ultra-Dex Build Mode\n'));
+
+      // Check for required files
+      const hasContext = await fileExists('CONTEXT.md');
+      const hasPlan = await fileExists('IMPLEMENTATION-PLAN.md');
+      const hasQuickStart = await fileExists('QUICK-START.md');
+
+      if (!hasContext && !hasPlan) {
+        console.log(chalk.yellow('⚠️  No Ultra-Dex project found in current directory.\n'));
+        console.log(chalk.white('Run one of these first:'));
+        console.log(chalk.gray('  npx ultra-dex init      # Create from template'));
+        console.log(chalk.gray('  npx ultra-dex generate  # Generate from idea\n'));
+        return;
+      }
+
+      // Load context files
+      const spinner = ora('Loading project context...').start();
+
+      const context = await readFileSafe('CONTEXT.md');
+      const plan = await readFileSafe('IMPLEMENTATION-PLAN.md');
+      const quickStart = await readFileSafe('QUICK-START.md');
+
+      spinner.succeed('Context loaded');
+
+      // Select agent if not provided
+      let agent = options.agent;
+      if (!agent) {
+        const { selectedAgent } = await inquirer.prompt([
+          {
+            type: 'list',
+            name: 'selectedAgent',
+            message: 'Select an agent:',
+            choices: [
+              new inquirer.Separator('── Leadership ──'),
+              { name: '📋 @Planner - Break down tasks', value: 'planner' },
+              { name: '🏗️  @CTO - Architecture decisions', value: 'cto' },
+              new inquirer.Separator('── Development ──'),
+              { name: '⚙️  @Backend - API endpoints', value: 'backend' },
+              { name: '🎨 @Frontend - UI components', value: 'frontend' },
+              { name: '🗄️  @Database - Schema design', value: 'database' },
+              new inquirer.Separator('── Security ──'),
+              { name: '🔐 @Auth - Authentication', value: 'auth' },
+              { name: '🛡️  @Security - Security audit', value: 'security' },
+              new inquirer.Separator('── Quality ──'),
+              { name: '🧪 @Testing - Write tests', value: 'testing' },
+              { name: '👁️  @Reviewer - Code review', value: 'reviewer' },
+              new inquirer.Separator('── DevOps ──'),
+              { name: '🚀 @DevOps - Deployment', value: 'devops' },
+            ],
+          },
+        ]);
+        agent = selectedAgent;
+      }
+
+      const agentConfig = AGENTS[agent];
+      if (!agentConfig) {
+        console.log(chalk.red(`Unknown agent: ${agent}`));
+        console.log(chalk.gray(`Available: ${Object.keys(AGENTS).join(', ')}`));
+        return;
+      }
+
+      // Get task if not provided
+      let task = options.task;
+      if (!task) {
+        const { taskInput } = await inquirer.prompt([
+          {
+            type: 'input',
+            name: 'taskInput',
+            message: `What should ${agentConfig.name} do?`,
+            default: agentConfig.task,
+          },
+        ]);
+        task = taskInput;
+      }
+
+      // Build the prompt
+      const contextSection = context ? `## Project Context\n${context}\n` : '';
+      const planSection = plan ? `## Implementation Plan (Summary)\n${plan.slice(0, 8000)}...\n[Full plan in IMPLEMENTATION-PLAN.md]\n` : '';
+
+      const prompt = `# ${agentConfig.name} Agent Session
+
+You are acting as ${agentConfig.name} for this project.
+
+${contextSection}
+${planSection}
+
+## Your Task
+${task}
+
+## Instructions
+1. Read the context and plan carefully
+2. Focus ONLY on your assigned task
+3. Follow Ultra-Dex 21-step verification for any code changes
+4. Document your work in a way the next agent can continue
+
+## Output Format
+- For code: Include full file paths and production-ready code
+- For plans: Use atomic tasks (4-9 hours each)
+- For reviews: Use severity levels (critical, warning, info)
+
+Begin working on: ${task}
+`;
+
+      // Output the prompt
+      console.log(chalk.green(`\n✅ ${agentConfig.name} prompt ready\n`));
+
+      if (options.copy) {
+        // Copy to clipboard
+        try {
+          const platform = process.platform;
+          if (platform === 'darwin') {
+            await execAsync(`echo ${JSON.stringify(prompt)} | pbcopy`);
+          } else if (platform === 'linux') {
+            await execAsync(`echo ${JSON.stringify(prompt)} | xclip -selection clipboard`);
+          } else if (platform === 'win32') {
+            await execAsync(`echo ${JSON.stringify(prompt)} | clip`);
+          }
+          console.log(chalk.cyan('📋 Prompt copied to clipboard!'));
+          console.log(chalk.gray('Paste into your AI tool (Cursor, Claude, ChatGPT)\n'));
+        } catch {
+          console.log(chalk.yellow('Could not copy to clipboard. Displaying prompt instead:\n'));
+          console.log(chalk.gray('─'.repeat(60)));
+          console.log(prompt);
+          console.log(chalk.gray('─'.repeat(60)));
+        }
+      } else if (options.cursor) {
+        // Save prompt and open Cursor
+        const promptPath = path.join('.ultra-dex', 'current-prompt.md');
+        await fs.mkdir('.ultra-dex', { recursive: true });
+        await fs.writeFile(promptPath, prompt);
+
+        console.log(chalk.gray(`Prompt saved to: ${promptPath}`));
+        console.log(chalk.cyan('Opening Cursor...\n'));
+
+        try {
+          await execAsync('cursor .');
+        } catch {
+          console.log(chalk.yellow('Could not open Cursor. Is it installed?'));
+          console.log(chalk.gray('Install: https://cursor.sh'));
+        }
+      } else {
+        // Display the prompt
+        console.log(chalk.gray('─'.repeat(60)));
+        console.log(prompt);
+        console.log(chalk.gray('─'.repeat(60)));
+
+        console.log(chalk.cyan('\n📋 Copy this prompt into your AI tool'));
+        console.log(chalk.gray('Or use --copy to copy to clipboard\n'));
+      }
+
+      // Show next steps
+      console.log(chalk.white('Tips:'));
+      console.log(chalk.gray('  • Paste the prompt into Cursor, Claude, or ChatGPT'));
+      console.log(chalk.gray('  • Use "npx ultra-dex serve" for MCP-compatible context'));
+      console.log(chalk.gray('  • Run "npx ultra-dex review" after making changes\n'));
+    });
+}
+
+export default { registerBuildCommand };

package/lib/commands/examples.js

@@ -0,0 +1,34 @@
+import chalk from 'chalk';
+import { githubBlobUrl } from '../config/urls.js';
+
+export function registerExamplesCommand(program) {
+  program
+    .command('examples')
+    .description('List available examples')
+    .action(() => {
+      console.log(chalk.bold('\nAvailable Ultra-Dex Examples:\n'));
+
+      const examples = [
+        {
+          name: 'TaskFlow',
+          type: 'Task Management',
+          url: githubBlobUrl('@%20Ultra%20DeX/Saas%20plan/Examples/TaskFlow-Complete.md'),
+        },
+        {
+          name: 'InvoiceFlow',
+          type: 'Invoicing',
+          url: githubBlobUrl('@%20Ultra%20DeX/Saas%20plan/Examples/InvoiceFlow-Complete.md'),
+        },
+        {
+          name: 'HabitStack',
+          type: 'Habit Tracking',
+          url: githubBlobUrl('@%20Ultra%20DeX/Saas%20plan/Examples/HabitStack-Complete.md'),
+        },
+      ];
+
+      examples.forEach((ex, i) => {
+        console.log(chalk.cyan(`${i + 1}. ${ex.name}`) + chalk.gray(` (${ex.type})`));
+        console.log(chalk.gray(`   ${ex.url}\n`));
+      });
+    });
+}