ultra-dex 2.2.1 → 3.2.0

package/lib/commands/init.js

@@ -7,29 +7,40 @@ import path from 'path';
 import { QUICK_START_TEMPLATE } from '../templates/quick-start.js';
 import { CONTEXT_TEMPLATE } from '../templates/context.js';
 import { validateProjectName, validateSafePath } from '../utils/validation.js';
-import { ASSETS_ROOT, ROOT_FALLBACK } from '../config/paths.js';
-import { githubBlobUrl, githubWebUrl } from '../config/urls.js';
+import { ASSETS_ROOT, ROOT_FALLBACK, LIVE_TEMPLATES_ROOT } from '../config/paths.js';
+import { githubBlobUrl } from '../config/urls.js';
 import { copyWithFallback, listWithFallback, readWithFallback } from '../utils/fallback.js';
+import { copyDirectory, pathExists } from '../utils/files.js';
+import { getRandomMessage } from '../utils/messages.js';
+
+const LIVE_STACKS = {
+  'next15-prisma-clerk': 'Next.js 15 + Prisma + Clerk',
+  'remix-supabase': 'Remix + Supabase',
+  'sveltekit-drizzle': 'SvelteKit + Drizzle',
+};
 
 export function registerInitCommand(program) {
   program
     .command('init')
-    .description('Initialize a new Ultra-Dex project')
+    .description('Initialize a new Ultra-Dex Project')
     .option('-n, --name <name>', 'Project name')
     .option('-d, --dir <directory>', 'Output directory', '.')
     .option('--preview', 'Preview files without creating them')
+    .option('--live', 'Generate a runnable scaffold')
+    .option('--stack <preset>', 'Preset: next15-prisma-clerk, remix-supabase, sveltekit-drizzle')
     .action(async (options) => {
       console.log(chalk.cyan(program.banner));
-      console.log(chalk.bold('\nWelcome to Ultra-Dex! Let\'s plan your SaaS.\n'));
+      console.log(chalk.hex('#8b5cf6').bold('\n⚡ INITIALIZING PROJECT PROTOCOL...\n'));
+      console.log(chalk.italic(chalk.gray(`"${getRandomMessage('start')}"`)));
+      console.log('');
 
       if (options.preview) {
-        console.log('\n📋 Files that would be created:\n');
+        console.log('\n📋 Project Preview (Files that would be created):\n');
         console.log('  QUICK-START.md');
         console.log('  CONTEXT.md');
         console.log('  IMPLEMENTATION-PLAN.md');
         console.log('  docs/CHECKLIST.md');
         console.log('  docs/AI-PROMPTS.md');
-        console.log('\nRun without --preview to create files.');
         return;
       }
 
@@ -39,107 +50,150 @@ export function registerInitCommand(program) {
         process.exit(1);
       }
 
+      if (options.live) {
+        const preset = options.stack || 'next15-prisma-clerk';
+        if (!LIVE_STACKS[preset]) {
+          console.log(chalk.red(`Unknown preset: ${preset}`));
+          console.log(chalk.gray(`Available presets: ${Object.keys(LIVE_STACKS).join(', ')}`));
+          process.exit(1);
+        }
+
+        const outputDir = path.resolve(options.dir);
+        if (await pathExists(outputDir, 'dir')) {
+          const existing = await fs.readdir(outputDir);
+          if (existing.length > 0) {
+            console.log(chalk.red('Target directory is not empty. Execution halted to prevent data loss.'));
+            process.exit(1);
+          }
+        }
+
+        const liveSourcePath = path.join(LIVE_TEMPLATES_ROOT, preset);
+        const fallbackLivePath = path.join(ROOT_FALLBACK, 'cli', 'assets', 'live-templates', preset);
+        let sourcePath = liveSourcePath;
+        try {
+          await fs.access(liveSourcePath);
+        } catch {
+          sourcePath = fallbackLivePath;
+        }
+
+        const spinner = ora(`Generating ${LIVE_STACKS[preset]} scaffold...`).start();
+        try {
+          await copyDirectory(sourcePath, outputDir);
+          spinner.succeed(chalk.green('Project scaffold generated successfully!'));
+          console.log(chalk.gray(`\nPreset: ${preset}`));
+          console.log(chalk.gray(`Next steps:`));
+          console.log(chalk.cyan(`  1. cd ${outputDir}`));
+          console.log(chalk.cyan('  2. npm install'));
+          console.log(chalk.cyan('  3. npm run dev\n'));
+        } catch (error) {
+          spinner.fail(chalk.red('Failed to generate project scaffold'));
+          console.error(`[init] ${error?.message ?? error}`);
+          process.exit(1);
+        }
+        return;
+      }
+
       const answers = await inquirer.prompt([
         {
           type: 'input',
           name: 'projectName',
-          message: 'What\'s your project name?',
+          message: 'What is the name of this project?',
           default: options.name || 'my-saas',
           validate: validateProjectName,
         },
         {
           type: 'input',
           name: 'ideaWhat',
-          message: 'What are you building? (1 sentence)',
-          validate: (input) => input.length > 0 || 'Please describe your idea',
+          message: 'Define the core purpose (What are you building?):',
+          validate: (input) => input.length > 0 || 'Please describe your project',
         },
         {
           type: 'input',
           name: 'ideaFor',
-          message: 'Who is it for?',
-          validate: (input) => input.length > 0 || 'Please specify your target users',
+          message: 'Target audience (Who are the users)?',
+          validate: (input) => input.length > 0 || 'Please specify your target audience',
         },
         {
           type: 'input',
           name: 'problem1',
-          message: 'Problem #1 you\'re solving:',
+          message: 'Primary problem to solve:',
           default: '',
         },
         {
           type: 'input',
           name: 'problem2',
-          message: 'Problem #2 you\'re solving:',
+          message: 'Secondary problem to solve:',
           default: '',
         },
         {
           type: 'input',
           name: 'problem3',
-          message: 'Problem #3 you\'re solving:',
+          message: 'Tertiary problem to solve:',
           default: '',
         },
         {
           type: 'input',
           name: 'feature1',
-          message: 'Critical production feature:',
+          message: 'Core feature:',
           default: '',
         },
         {
           type: 'list',
           name: 'frontend',
-          message: 'Frontend framework:',
+          message: 'Frontend Technology Stack:',
           choices: ['Next.js', 'Remix', 'SvelteKit', 'Nuxt', 'Other'],
         },
         {
           type: 'list',
           name: 'database',
-          message: 'Database:',
+          message: 'Database Infrastructure:',
           choices: ['PostgreSQL', 'Supabase', 'MongoDB', 'PlanetScale', 'Other'],
         },
         {
           type: 'list',
           name: 'auth',
-          message: 'Authentication:',
+          message: 'Authentication Provider:',
           choices: ['NextAuth', 'Clerk', 'Auth0', 'Supabase Auth', 'Other'],
         },
         {
           type: 'list',
           name: 'payments',
-          message: 'Payments:',
+          message: 'Payment Processor:',
           choices: ['Stripe', 'Lemonsqueezy', 'Paddle', 'None (free)', 'Other'],
         },
         {
           type: 'list',
           name: 'hosting',
-          message: 'Hosting:',
+          message: 'Deployment Platform:',
           choices: ['Vercel', 'Railway', 'Fly.io', 'AWS', 'Other'],
         },
         {
           type: 'confirm',
           name: 'includeCursorRules',
-          message: 'Include cursor-rules for AI assistants? (Cursor, Copilot)',
+          message: 'Install IDE intelligence protocols? (Cursor/Copilot Rules)',
           default: true,
         },
         {
           type: 'confirm',
           name: 'includeFullTemplate',
-          message: 'Copy full 34-section template locally?',
+          message: 'Include full 34-section project template?',
           default: false,
         },
         {
           type: 'confirm',
           name: 'includeDocs',
-          message: 'Copy VERIFICATION.md & AGENT-INSTRUCTIONS.md to docs/?',
+          message: 'Include project documentation standards?',
           default: true,
         },
         {
           type: 'confirm',
           name: 'includeAgents',
-          message: 'Include AI agent prompts? (.agents/ folder)',
+          message: 'Configure AI agent orchestration?',
           default: true,
         },
       ]);
 
-      const spinner = ora('Creating project files...').start();
+      const spinner = ora(getRandomMessage('loading')).start();
 
       try {
         const outputDir = path.resolve(options.dir, answers.projectName);
@@ -187,15 +241,8 @@ ${answers.ideaWhat} for ${answers.ideaFor}.
 ## Next Steps
 
 1. Open QUICK-START.md and complete the remaining sections
-2. Copy sections from the full Ultra-Dex template as needed
-3. Use the TaskFlow example as reference
-4. Start building!
-
-## Resources
-
-- [Full Template](${githubBlobUrl('@%20Ultra%20DeX/Saas%20plan/04-Imp-Template.md')})
-- [TaskFlow Example](${githubBlobUrl('@%20Ultra%20DeX/Saas%20plan/Examples/TaskFlow-Complete.md')})
-- [Methodology](${githubBlobUrl('@%20Ultra%20DeX/Saas%20plan/03-METHODOLOGY.md')})
+2. Customize the implementation plan based on your requirements
+3. Start the agent orchestration to begin development
 `;
 
         await fs.writeFile(path.join(outputDir, 'IMPLEMENTATION-PLAN.md'), planContent);
@@ -222,11 +269,11 @@ ${answers.ideaWhat} for ${answers.ideaFor}.
               await fs.mkdir(dotGithub, { recursive: true });
               await fs.writeFile(path.join(dotGithub, 'copilot-instructions.md'), coreContent);
             } catch {
-              // Core rule not available - skip Copilot setup
+              // Core rule not available
             }
           } catch {
-            console.log(chalk.red('\n  ❌ Cursor rules not found in assets or repo.'));
-            console.log(chalk.cyan('  Fetch: npx ultra-dex fetch --rules'));
+            console.log(chalk.red('\n  ✕ IDE intelligence protocols not found.'));
+            console.log(chalk.cyan('  Run: ultra-dex fetch --rules'));
           }
         }
 
@@ -236,8 +283,8 @@ ${answers.ideaWhat} for ${answers.ideaFor}.
           try {
             await copyWithFallback(templatePath, fallbackTemplatePath, path.join(outputDir, 'docs', 'MASTER-PLAN.md'));
           } catch {
-            console.log(chalk.red('\n  ❌ Full template not found in assets or repo.'));
-            console.log(chalk.cyan('  Fetch: npx ultra-dex fetch --docs'));
+            console.log(chalk.red('\n  ✕ Project template not found.'));
+            console.log(chalk.cyan('  Run: ultra-dex fetch --docs'));
           }
         }
 
@@ -250,8 +297,8 @@ ${answers.ideaWhat} for ${answers.ideaFor}.
             await copyWithFallback(verificationPath, fallbackVerificationPath, path.join(outputDir, 'docs', 'CHECKLIST.md'));
             await copyWithFallback(agentPath, fallbackAgentPath, path.join(outputDir, 'docs', 'AI-PROMPTS.md'));
           } catch {
-            console.log(chalk.red('\n  ❌ Docs not found in assets or repo.'));
-            console.log(chalk.cyan('  Fetch: npx ultra-dex fetch --docs'));
+            console.log(chalk.red('\n  ✕ Documentation standards not found.'));
+            console.log(chalk.cyan('  Run: ultra-dex fetch --docs'));
           }
         }
 
@@ -293,43 +340,44 @@ ${answers.ideaWhat} for ${answers.ideaFor}.
               path.join(agentsDir, 'README.md')
             );
           } catch {
-            console.log(chalk.red('\n  ❌ Agent prompts not found in assets or repo.'));
-            console.log(chalk.cyan('  Fetch: npx ultra-dex fetch --agents'));
+            console.log(chalk.red('\n  ✕ Agent orchestration assets not found.'));
+            console.log(chalk.cyan('  Run: ultra-dex fetch --agents'));
           }
         }
 
-        spinner.succeed(chalk.green('Project created successfully!'));
+        spinner.succeed(chalk.green('Project initialized successfully!'));
 
-        console.log('\n' + chalk.bold('Files created:'));
+        console.log('\n' + chalk.bold('Artifacts created:'));
         console.log(chalk.gray(`  ${outputDir}/`));
         console.log(chalk.gray('  ├── QUICK-START.md'));
         console.log(chalk.gray('  ├── CONTEXT.md'));
         console.log(chalk.gray('  ├── IMPLEMENTATION-PLAN.md'));
         if (answers.includeFullTemplate) {
-          console.log(chalk.gray('  ├── docs/MASTER-PLAN.md (34 sections)'));
+          console.log(chalk.gray('  ├── docs/MASTER-PLAN.md'));
         }
         if (answers.includeDocs) {
           console.log(chalk.gray('  ├── docs/CHECKLIST.md'));
           console.log(chalk.gray('  ├── docs/AI-PROMPTS.md'));
         }
         if (answers.includeCursorRules) {
-          console.log(chalk.gray('  ├── .cursor/rules/ (11 AI rule files)'));
+          console.log(chalk.gray('  ├── .cursor/rules/'));
         }
         if (answers.includeAgents) {
-          console.log(chalk.gray('  └── .agents/ (15 AI agent prompts in 6 tiers)'));
+          console.log(chalk.gray('  └── .agents/'));
         }
 
         console.log('\n' + chalk.bold('Next steps:'));
         console.log(chalk.cyan(`  1. cd ${answers.projectName}`));
-        console.log(chalk.cyan('  2. Open QUICK-START.md and complete it'));
-        console.log(chalk.cyan('  3. Start building! 🚀'));
+        console.log(chalk.cyan('  2. Open QUICK-START.md'));
+        console.log(chalk.cyan('  3. ultra-dex swarm "Analyze requirements"'));
 
-        console.log('\n' + chalk.gray('Full Ultra-Dex repo:'));
-        console.log(chalk.blue(`  ${githubWebUrl()}`));
+        console.log('\n' + chalk.hex('#8b5cf6').bold('  ✓ SYSTEM READY.'));
+        console.log('');
+        
       } catch (error) {
-        spinner.fail(chalk.red('Failed to create project'));
+        spinner.fail(chalk.red('Failed to initialize project'));
         console.error(`[init] ${error?.message ?? error}`);
         process.exit(1);
       }
     });
-}
+}

package/lib/commands/memory.js

@@ -0,0 +1,80 @@
+/**
+ * ultra-dex memory command
+ * Manage persistent memory for AI agents
+ */
+
+import chalk from 'chalk';
+import { ultraMemory } from '../mcp/memory.js';
+
+export function registerMemoryCommand(program) {
+  const memory = program
+    .command('memory')
+    .description('Manage persistent agent memory');
+
+  memory
+    .command('list')
+    .description('List all remembered facts')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+      const items = await ultraMemory.getAll();
+      
+      if (options.json) {
+        console.log(JSON.stringify(items, null, 2));
+        return;
+      }
+
+      console.log(chalk.cyan.bold('\n🧠 Ultra-Dex Persistent Memory\n'));
+      
+      if (items.length === 0) {
+        console.log(chalk.gray('  Memory is empty.'));
+        return;
+      }
+
+      items.forEach((item, i) => {
+        console.log(chalk.white(`${i + 1}. [${new Date(item.timestamp).toLocaleDateString()}] (${item.source})`));
+        console.log(chalk.gray(`   ${item.text}`));
+        if (item.tags && item.tags.length > 0) {
+          console.log(chalk.blue(`   Tags: ${item.tags.join(', ')}`));
+        }
+        console.log();
+      });
+    });
+
+  memory
+    .command('add <text>')
+    .description('Add a fact to memory')
+    .option('-t, --tags <tags>', 'Comma-separated tags')
+    .action(async (text, options) => {
+      const tags = options.tags ? options.tags.split(',').map(t => t.trim()) : [];
+      await ultraMemory.remember(text, tags, 'manual');
+      console.log(chalk.green('✅ Fact remembered.'));
+    });
+
+  memory
+    .command('search <query>')
+    .description('Search memory')
+    .action(async (query) => {
+      const results = await ultraMemory.search(query);
+      console.log(chalk.cyan.bold(`\n🔍 Search Results for "${query}":\n`));
+      
+      if (results.length === 0) {
+        console.log(chalk.gray('  No matches found.'));
+        return;
+      }
+
+      results.forEach((item, i) => {
+        console.log(chalk.white(`${i + 1}. [${new Date(item.timestamp).toLocaleDateString()}]`));
+        console.log(chalk.gray(`   ${item.text}`));
+        console.log();
+      });
+    });
+
+  memory
+    .command('clear')
+    .description('Clear all memory')
+    .option('--before <date>', 'Clear before date (ISO)')
+    .action(async (options) => {
+      await ultraMemory.clear(options.before);
+      console.log(chalk.green('✅ Memory cleared.'));
+    });
+}

package/lib/commands/plan.js

@@ -0,0 +1,82 @@
+import fs from 'fs/promises';
+import path from 'path';
+import chalk from 'chalk';
+
+export async function loadState() {
+  try {
+    const content = await fs.readFile(path.resolve(process.cwd(), '.ultra/state.json'), 'utf8');
+    return JSON.parse(content);
+  } catch (error) {
+    console.error(chalk.red('Failed to load .ultra/state.json. Is the project initialized?'));
+    return null;
+  }
+}
+
+export async function saveState(state) {
+  try {
+    await fs.mkdir(path.resolve(process.cwd(), '.ultra'), { recursive: true });
+    await fs.writeFile(
+      path.resolve(process.cwd(), '.ultra/state.json'), 
+      JSON.stringify(state, null, 2)
+    );
+    return true;
+  } catch (error) {
+    console.error(chalk.red('Failed to save state:'), error);
+    return false;
+  }
+}
+
+export function generateMarkdown(state) {
+  const { project, phases } = state;
+  let md = `# ${project.name} - Implementation Plan\n\n`;
+  md += `> **Generated by Ultra-Dex Core**\n`;
+  md += `> Version: ${project.version}\n`;
+  md += `> Mode: ${project.mode}\n\n`;
+
+  md += `## 🚀 Execution Phases\n\n`;
+
+  phases.forEach(phase => {
+    const statusIcon = phase.status === 'completed' ? '✅' : phase.status === 'in_progress' ? '🔄' : '⏳';
+    md += `### ${statusIcon} ${phase.name}\n\n`;
+    
+    if (phase.steps && phase.steps.length > 0) {
+      phase.steps.forEach(step => {
+        const stepIcon = step.status === 'completed' ? '- [x]' : '- [ ]';
+        md += `${stepIcon} **${step.id}**: ${step.task}\n`;
+      });
+    } else {
+      md += `_No steps defined for this phase._\n`;
+    }
+    md += `\n`;
+  });
+
+  md += `## 🤖 Agent Registry\n\n`;
+  if (state.agents && state.agents.registry) {
+    state.agents.registry.forEach(agent => {
+      const active = state.agents.active.includes(agent) ? '(Active)' : '';
+      md += `- ${agent} ${active}\n`;
+    });
+  }
+
+  md += `\n---\n`;
+  md += `*This file is strictly read-only. Edit .ultra/state.json to update.*`;
+
+  return md;
+}
+
+export function registerPlanCommand(program) {
+  program
+    .command('plan')
+    .description('Generate IMPLEMENTATION-PLAN.md from state.json')
+    .action(async () => {
+      const state = await loadState();
+      if (!state) return;
+
+      console.log(chalk.blue(`Generating plan for ${state.project.name}...`));
+      
+      const markdown = generateMarkdown(state);
+      await fs.writeFile(path.resolve(process.cwd(), 'IMPLEMENTATION-PLAN.md'), markdown);
+      
+      console.log(chalk.green(`✅ IMPLEMENTATION-PLAN.md generated successfully.`));
+    });
+}

package/lib/commands/review.js

@@ -10,6 +10,8 @@ import fs from 'fs/promises';
 import path from 'path';
 import { createProvider, getDefaultProvider, checkConfiguredProviders } from '../providers/index.js';
 import { SYSTEM_PROMPT, generateReviewPrompt } from '../templates/prompts/review-code.js';
+import { validateSafePath } from '../utils/validation.js';
+import { buildGraph, queryGraph, getImpactAnalysis } from '../utils/graph.js'; // Import CPG utils
 
 // File patterns to scan
 const CODE_PATTERNS = {
@@ -106,6 +108,12 @@ export function registerReviewCommand(program) {
     .action(async (options) => {
       console.log(chalk.cyan('\n🔍 Ultra-Dex Code Review\n'));
 
+      const dirValidation = validateSafePath(options.dir, 'Review directory');
+      if (dirValidation !== true) {
+        console.log(chalk.red(dirValidation));
+        process.exit(1);
+      }
+
       const reviewDir = path.resolve(options.dir);
 
       // Check for plan
@@ -120,11 +128,29 @@ export function registerReviewCommand(program) {
         return;
       }
 
-      // Get directory structure
-      const spinner = ora('Scanning codebase...').start();
+      // Get directory structure & Build Graph
+      const spinner = ora('Scanning codebase & Building Graph...').start();
       const structure = await getDirectoryStructure(reviewDir);
       const keyFiles = await findKeyFiles(reviewDir);
-      spinner.succeed('Codebase scanned');
+      
+      // GOD MODE: Build CPG
+      let graphSummary = "Graph Not Available";
+      try {
+        const graph = await buildGraph();
+        graphSummary = `
+Code Property Graph Stats:
+- Files: ${graph.nodes.filter(n => n.type === 'file').length}
+- Functions: ${graph.nodes.filter(n => n.type === 'function').length}
+- Dependencies (Edges): ${graph.edges.length}
+
+Top Dependencies:
+${graph.edges.slice(0, 10).map(e => `- ${e.source} -> ${e.target}`).join('\n')}
+        `;
+      } catch (e) {
+        // Fallback if graph fails
+      }
+
+      spinner.succeed('Codebase scanned & Graph built');
 
       if (options.quick) {
         // Quick review - just check structure
@@ -181,13 +207,16 @@ export function registerReviewCommand(program) {
 
       // Build file summary
       const filesSummary = keyFiles.map(f => `### ${f.path}\n\`\`\`\n${f.content}\n\`\`\``).join('\n\n');
+      
+      // Inject Graph Summary into context
+      const contextWithGraph = `${structure}\n\n## ARCHITECTURAL GRAPH (TRUTH)\n${graphSummary}`;
 
-      spinner.start('Analyzing code against plan...');
+      spinner.start('Analyzing code & graph against plan...');
 
       try {
         const result = await provider.generate(
           SYSTEM_PROMPT,
-          generateReviewPrompt(plan.slice(0, 15000), structure, filesSummary)
+          generateReviewPrompt(plan.slice(0, 15000), contextWithGraph, filesSummary)
         );
 
         spinner.succeed('Analysis complete');