ultra-dex 3.1.0 → 3.2.0

package/lib/commands/state.js

@@ -4,9 +4,7 @@
  */
 
 import chalk from 'chalk';
-import ora from 'ora';
 import fs from 'fs/promises';
-import { watch as fsWatch } from 'fs';
 import path from 'path';
 import { validateSafePath } from '../utils/validation.js';
 import { buildGraph } from '../utils/graph.js';
@@ -34,19 +32,16 @@ export async function saveState(state) {
 }
 
 export async function computeState() {
-  // Try to load existing state first to check schema
   const existing = await loadState();
-  if (existing && existing.project?.mode === 'GOD_MODE') {
-    // In God Mode, we update the timestamp
+  if (existing && existing.project?.mode === 'ULTRA_MODE') {
     existing.updatedAt = new Date().toISOString();
     return existing;
   }
 
-  // Legacy computation logic
   const state = {
-    version: '2.4.0',
+    version: '3.2.0',
     updatedAt: new Date().toISOString(),
-    project: { name: path.basename(process.cwd()) },
+    project: { name: path.basename(process.cwd()), mode: 'ULTRA_MODE' },
     files: {},
     sections: { total: 34, completed: 0, list: [] },
     score: 0
@@ -73,7 +68,7 @@ export async function computeState() {
   } catch { /* no plan */ }
 
   const fileScore = Object.values(state.files).filter(f => f.exists).length / coreFiles.length * 40;
-  const sectionScore = state.sections.completed / state.sections.total * 60;
+  const sectionScore = Math.min(state.sections.completed / state.sections.total * 60, 60);
   state.score = Math.round(fileScore + sectionScore);
 
   return state;
@@ -92,10 +87,8 @@ export function registerAlignCommand(program) {
     .option('--strict', 'Exit with error if score < 70')
     .option('--json', 'Output as JSON')
     .action(async (options) => {
-      // 1. Compute Base State
       const state = await computeState();
       
-      // 2. Compute Graph Score (God Mode)
       let graphScore = 0;
       let graphStats = { nodes: 0, edges: 0 };
       
@@ -103,9 +96,6 @@ export function registerAlignCommand(program) {
         const graph = await buildGraph();
         graphStats = { nodes: graph.nodes.length, edges: graph.edges.length };
         
-        // Simple heuristic: A healthy project has nodes and edges
-        // 10+ nodes = 20 points
-        // 10+ edges = 20 points
         const nodesPoints = Math.min(graph.nodes.length * 2, 20);
         const edgesPoints = Math.min(graph.edges.length * 2, 20);
         graphScore = nodesPoints + edgesPoints;
@@ -113,14 +103,12 @@ export function registerAlignCommand(program) {
         // Graph failed
       }
 
-      // 3. Combine Scores
-      // Legacy score (files/plan) is 60% weight, Graph is 40%
       const totalScore = Math.min(Math.round((state.score * 0.6) + graphScore), 100);
 
       if (options.json) {
-        console.log(JSON.stringify({ 
+        console.log(JSON.stringify({
             score: totalScore, 
-            legacyScore: state.score,
+            documentationScore: state.score,
             graphScore,
             graphStats,
             files: Object.values(state.files).filter(f => f.exists).length, 
@@ -129,7 +117,7 @@ export function registerAlignCommand(program) {
       } else {
         const icon = totalScore >= 80 ? '✅' : totalScore >= 50 ? '⚠️' : '❌';
         console.log(`${icon} Alignment: ${totalScore}/100`);
-        console.log(chalk.gray(`   • Plan/Docs: ${state.score}/100`));
+        console.log(chalk.gray(`   • Documentation: ${state.score}/100`));
         console.log(chalk.gray(`   • Code Graph: ${graphScore}/40 (Nodes: ${graphStats.nodes}, Edges: ${graphStats.edges})`));
       }
       
@@ -153,7 +141,7 @@ export function registerStatusCommand(program) {
 
       let state = await loadState();
       if (!state) {
-        console.log(chalk.yellow('\n⚠️  No .ultra/state.json found. Generating...\n'));
+        console.log(chalk.yellow('\nℹ️  Initializing project state...\n'));
         state = await computeState();
         await saveState(state);
       }
@@ -166,13 +154,12 @@ export function registerStatusCommand(program) {
       console.log(chalk.bold('\n📊 Ultra-Dex Status\n'));
       console.log(chalk.gray('─'.repeat(50)));
       
-      if (state.project?.mode === 'GOD_MODE') {
-          // Render God Mode Status
-          console.log(chalk.cyan(`  MODE: ${state.project.mode}`));
-          console.log(chalk.gray(`  Version: ${state.project.version}`));
+      if (state.phases) {
+          console.log(chalk.cyan(`  MODE: ${state.project?.mode || 'ULTRA_MODE'}`));
+          console.log(chalk.gray(`  Version: ${state.project?.version || state.version}`));
           console.log(chalk.gray('─'.repeat(50)));
           
-          console.log(chalk.bold('\n🚀 Phases:'));
+          console.log(chalk.bold('\n🚀 Implementation Phases:'));
           state.phases.forEach(phase => {
               const icon = phase.status === 'completed' ? '✅' : phase.status === 'in_progress' ? '🔄' : '⏳';
               console.log(`  ${icon} ${chalk.bold(phase.name)}`);
@@ -183,31 +170,32 @@ export function registerStatusCommand(program) {
               console.log('');
           });
 
-          console.log(chalk.bold('🤖 Agents:'));
-          state.agents.registry.forEach(agent => {
-              const active = state.agents.active.includes(agent) ? chalk.green('(Active)') : '';
-              console.log(`  • @${agent} ${active}`);
-          });
+          if (state.agents) {
+            console.log(chalk.bold('🤖 Orchestration Agents:'));
+            state.agents.registry?.forEach(agent => {
+                const active = state.agents.active?.includes(agent) ? chalk.green('(Active)') : '';
+                console.log(`  • @${agent} ${active}`);
+            });
+          }
 
       } else {
-          // Render Legacy Status
           const scoreColor = state.score >= 80 ? 'green' : state.score >= 50 ? 'yellow' : 'red';
           console.log(chalk[scoreColor](`  Score: ${state.score}/100`));
           console.log(chalk.gray(`  Updated: ${state.updatedAt}`));
           console.log(chalk.gray('─'.repeat(50)));
 
-          console.log(chalk.bold('\n📁 Files:'));
+          console.log(chalk.bold('\n📁 Documentation Files:'));
           if (state.files) {
             Object.entries(state.files).forEach(([name, info]) => {
-                const icon = info.exists ? chalk.green('✓') : chalk.red('✗');
+                const icon = info.exists ? chalk.green('✓') : chalk.red('✕');
                 const size = info.exists ? chalk.gray(` (${info.size} bytes)`) : '';
                 console.log(`  ${icon} ${name}${size}`);
             });
           }
 
-          console.log(chalk.bold('\n📝 Sections:'));
-          console.log(`  ${state.sections.completed}/${state.sections.total} documented`);
-          if (state.sections.list.length > 0) {
+          console.log(chalk.bold('\n📝 Implementation Sections:'));
+          console.log(`  ${state.sections.completed}/${state.sections.total} completed`);
+          if (state.sections.list?.length > 0) {
             const recent = state.sections.list.slice(-3);
             recent.forEach(s => console.log(chalk.gray(`    ${s.number}. ${s.title}`)));
             if (state.sections.list.length > 3) {
@@ -220,19 +208,15 @@ export function registerStatusCommand(program) {
 }
 
 export function registerWatchCommand(program) {
-    // This is now handled by watch.js, but keeping here for legacy imports if any. 
-    // In God Mode, watch.js replaces this.
-    // The bin/ultra-dex.js uses watch.js, so this might be dead code or overwritten.
-    // I will leave it as is or update it to be safe.
     program
-    .command('watch-legacy') // Rename to avoid conflict if both registered
+    .command('watch-legacy')
     .action(() => console.log("Use 'ultra-dex watch' instead."));
 }
 
 export function registerPreCommitCommand(program) {
   program
     .command('pre-commit')
-    .description('Pre-commit hook - verify before commit')
+    .description('Pre-commit hook - verify standards before commit')
     .option('--install', 'Install git pre-commit hook')
     .option('--scan', 'Include deep code quality scan in hook')
     .option('--ai', 'Run AI-powered quality review on staged changes')
@@ -254,7 +238,7 @@ export function registerPreCommitCommand(program) {
 # Ultra-Dex pre-commit hook
 npx ultra-dex align --strict${scanCmd}${aiCmd}
 if [ $? -ne 0 ]; then
-  echo "❌ Ultra-Dex quality gate failed."
+  echo "✕ Ultra-Dex quality gate failed."
   echo "   Run 'ultra-dex review' or 'ultra-dex validate --scan' for details."
   exit 1
 fi
@@ -262,22 +246,20 @@ fi
         try {
           await fs.mkdir(path.dirname(hookPath), { recursive: true });
           await fs.writeFile(hookPath, hookScript, { mode: 0o755 });
-          console.log(chalk.green('✅ Pre-commit hook installed!'));
+          console.log(chalk.green('✓ Pre-commit hook installed!'));
           console.log(chalk.gray('   Commits will be blocked if alignment score < 70 or AI review fails.'));
         } catch (e) {
-          console.log(chalk.red('❌ Failed to install hook: ' + e.message));
+          console.log(chalk.red('✕ Failed to install hook: ' + e.message));
         }
         return;
       }
       
       const state = await loadState();
       
-      // AI Quality Gate (God Mode)
       if (options.ai) {
-          const spinner = (await import('ora')).default('🤖 AI Quality Gate: Reviewing staged changes...').start();
+          const spinner = (await import('ora')).default('🤖 AI Quality Review: Analyzing staged changes...').start();
           try {
               const { execSync } = await import('child_process');
-              // Get staged changes
               const staged = execSync('git diff --cached --name-only', { encoding: 'utf8' }).split('\n').filter(Boolean);
               if (staged.length === 0) {
                   spinner.succeed('No staged changes to review.');
@@ -291,28 +273,23 @@ fi
               const reviewResult = await runAgentLoop('reviewer', `Review these staged files for architectural violations (e.g. missing validation, security risks):\n${staged.join('\n')}`, provider, { state });
 
               if (reviewResult.toLowerCase().includes('reject') || reviewResult.toLowerCase().includes('blocking violation')) {
-                  spinner.fail('AI Quality Gate: REJECTED');
-                  console.log(chalk.red('\nviolations found:'));
+                  spinner.fail('Quality Gate: REJECTED');
+                  console.log(chalk.red('\nViolations found:'));
                   console.log(reviewResult);
                   process.exit(1);
               }
-              spinner.succeed('AI Quality Gate: PASSED');
+              spinner.succeed('Quality Gate: PASSED');
           } catch (e) {
-              spinner.warn('AI Quality Gate skipped: ' + e.message);
+              spinner.warn('Quality Gate skipped: ' + e.message);
           }
       }
 
-      if (state && state.project?.mode === 'GOD_MODE') {
-          console.log(chalk.green(`✅ Alignment OK: GOD MODE ACTIVE`));
-          return;
-      }
-
       if (state && state.score < 70) {
-        console.log(chalk.red(`❌ BLOCKED: Alignment score ${state.score}/100 (required: 70)`));
+        console.log(chalk.red(`✕ BLOCKED: Alignment score ${state.score}/100 (required: 70)`));
         console.log(chalk.yellow('   Run `ultra-dex review` for detailed analysis.'));
         process.exit(1);
       } else {
-        console.log(chalk.green(`✅ Alignment OK: ${state ? state.score : 'N/A'}/100`));
+        console.log(chalk.green(`✓ Alignment verified: ${state ? state.score : 'N/A'}/100`));
       }
     });
 }
@@ -320,25 +297,21 @@ fi
 export function registerStateCommand(program) {
   program
     .command('state')
-    .description('Manage .ultra/state.json')
-    .option('--init', 'Initialize .ultra directory')
-    .option('--refresh', 'Refresh state from files')
+    .description('Manage project state')
+    .option('--init', 'Initialize state directory')
+    .option('--refresh', 'Refresh state from documentation')
     .action(async (options) => {
       if (options.init || options.refresh) {
         const state = await computeState();
         await saveState(state);
-        console.log(chalk.green('✅ State updated'));
-        if (state.project?.mode === 'GOD_MODE') {
-             console.log(chalk.gray(`   Mode: GOD_MODE`));
-        } else {
-             console.log(chalk.gray(`   Score: ${state.score}/100`));
-        }
+        console.log(chalk.green('✓ Project state updated'));
+        console.log(chalk.gray(`   Score: ${state.score}/100`));
         return;
       }
 
       const state = await loadState();
       if (!state) {
-        console.log(chalk.yellow('No .ultra/state.json found. Run `ultra-dex state --init`'));
+        console.log(chalk.yellow('No state file found. Run `ultra-dex state --init`'));
         return;
       }
       console.log(JSON.stringify(state, null, 2));
@@ -351,4 +324,4 @@ export default {
   registerWatchCommand,
   registerPreCommitCommand,
   registerStateCommand,
-};
+};

package/lib/commands/swarm.js

@@ -8,6 +8,9 @@ import { join } from 'path';
 import { glob } from 'glob';
 import { projectGraph } from '../mcp/graph.js';
 import { updateState, loadState, saveState } from './state.js';
+import { agents } from '../utils/agents.js';
+import { isDoomsdayMode } from '../utils/theme-state.js';
+import { showSwarmAssemble as showDoomsdaySwarm } from '../themes/doomsday.js';
 
 const AGENT_PIPELINE = [
   { name: 'planner', description: 'Break down task into steps', tier: '1-planning' },
@@ -20,6 +23,25 @@ const AGENT_PIPELINE = [
   { name: 'reviewer', description: 'Code review', tier: '4-quality' }
 ];
 
+export function showSwarmAssemble(activeAgents) {
+  if (isDoomsdayMode()) {
+    return showDoomsdaySwarm(activeAgents);
+  }
+
+  console.log('');
+  console.log(chalk.hex('#8b5cf6').bold('  ⚡ AGENT PIPELINE INITIALIZED'));
+  console.log('');
+  
+  activeAgents.forEach((agentInfo) => {
+    const agent = agents[agentInfo.name];
+    if (agent) {
+      console.log(`  ${agent.emoji} ${chalk.hex('#6366f1').bold(agent.name)}`);
+      console.log(`     ${chalk.dim('"' + agent.tagline + '"')}`);
+      console.log('');
+    }
+  });
+}
+
 async function runAgent(agent, task, context, previousOutput, provider) {
   const agentPrompt = await loadAgentPrompt(agent.name);
   const prompt = `
@@ -67,7 +89,7 @@ async function writeSwarmLog(logDir, task, results, stats) {
 }
 
 export async function swarmCommand(task, options) {
-  console.log(chalk.cyan.bold('\n🐝 Ultra-Dex Swarm Mode v3.0\n'));
+  console.log(chalk.cyan.bold('\n🐝 Ultra-Dex Swarm Mode\n'));
   console.log(chalk.white(`Task: "${task}"\n`));
 
   const startTime = Date.now();
@@ -78,12 +100,12 @@ export async function swarmCommand(task, options) {
       console.log(`  ${i + 1}. @${agent.name} - ${agent.description} [${agent.tier}]`);
     });
     if (options.parallel) {
-      console.log(chalk.blue('\nℹ️  Parallel execution enabled for 2-implementation tier'));
+      console.log(chalk.blue('\nℹ️  Parallel execution enabled for implementation tier'));
     }
     return;
   }
 
-  // Load context & Graph (God Mode)
+  // Load context & Graph
   const contextPath = join(process.cwd(), 'CONTEXT.md');
   const planPath = join(process.cwd(), 'IMPLEMENTATION-PLAN.md');
   
@@ -108,7 +130,7 @@ export async function swarmCommand(task, options) {
   // Get AI provider
   const provider = getProvider();
   if (!provider) {
-    console.log(chalk.red('No AI provider configured. Set ANTHROPIC_API_KEY, OPENAI_API_KEY, or GOOGLE_AI_KEY'));
+    console.log(chalk.red('No AI provider configured. Set ANTHROPIC_API_KEY, OPENAI_API_KEY, or GEMINI_API_KEY'));
     return;
   }
 
@@ -116,7 +138,7 @@ export async function swarmCommand(task, options) {
   const logDir = await ensureLogDirectory();
 
   // Update State to indicate Swarm is running
-  const state = await loadState() || { project: { mode: 'GOD_MODE' }, agents: { active: [] } };
+  const state = await loadState() || { project: { mode: 'ULTRA_MODE' }, agents: { active: [] } };
   state.agents = state.agents || { active: [] };
   state.updatedAt = new Date().toISOString();
   await saveState(state);
@@ -126,7 +148,7 @@ export async function swarmCommand(task, options) {
   const agentResults = [];
   const agentTimings = {};
   
-  // Define execution tiers (sorted by tier number)
+  // Define execution tiers
   const executionTiers = options.parallel 
     ? [
         { name: '1-Planning', agents: AGENT_PIPELINE.filter(a => a.tier === '1-planning'), parallel: false },
@@ -144,7 +166,7 @@ export async function swarmCommand(task, options) {
     }
 
     if (tier.parallel) {
-      // Parallel Execution for implementation tier
+      // Parallel Execution
       const tierStart = Date.now();
       const promises = tier.agents.map(async (agent) => {
         const agentStart = Date.now();
@@ -263,7 +285,7 @@ export async function swarmCommand(task, options) {
   });
   console.log(chalk.gray(`\n  Log saved: ${logPath}`));
 
-  console.log(chalk.green.bold('\n✅ Swarm complete!\n'));
+  console.log(chalk.green.bold('\n✅ Swarm execution complete!\n'));
 }
 
 async function loadAgentPrompt(name) {
@@ -281,4 +303,4 @@ async function loadAgentPrompt(name) {
   }
 
   return `You are the @${name} agent.`;
-}
+}

package/lib/config/theme.js

@@ -0,0 +1,47 @@
+import chalk from 'chalk';
+
+export const themes = {
+  default: {
+    primary: '#6366f1',
+    secondary: '#8b5cf6',
+    accent: '#d946ef',
+    success: '#22c55e',
+    warning: '#eab308',
+    error: '#ef4444',
+    dim: '#6b7280'
+  },
+  ocean: {
+    primary: '#0ea5e9',
+    secondary: '#06b6d4',
+    accent: '#14b8a6',
+    success: '#22c55e',
+    warning: '#f59e0b',
+    error: '#f43f5e',
+    dim: '#64748b'
+  },
+  forest: {
+    primary: '#22c55e',
+    secondary: '#10b981',
+    accent: '#14b8a6',
+    success: '#22c55e',
+    warning: '#eab308',
+    error: '#ef4444',
+    dim: '#6b7280'
+  }
+};
+
+let currentTheme = themes.default;
+
+export function getTheme() {
+  return currentTheme;
+}
+
+export function setTheme(name) {
+  if (themes[name]) {
+    currentTheme = themes[name];
+  }
+}
+
+export function styled(type, text) {
+  return chalk.hex(currentTheme[type])(text);
+}

package/lib/templates/code/clerk-middleware.ts

@@ -0,0 +1,138 @@
+// Ultra-Dex Production Pattern: Clerk Middleware
+// Copy to middleware.ts in your Next.js root
+
+import { clerkMiddleware, createRouteMatcher } from '@clerk/nextjs/server';
+import { NextResponse } from 'next/server';
+
+// =============================================================================
+// ROUTE MATCHERS
+// =============================================================================
+
+// Public routes - accessible without authentication
+const isPublicRoute = createRouteMatcher([
+  '/',
+  '/sign-in(.*)',
+  '/sign-up(.*)',
+  '/api/webhooks(.*)',
+  '/pricing',
+  '/about',
+  '/blog(.*)',
+]);
+
+// Admin routes - require admin role
+const isAdminRoute = createRouteMatcher([
+  '/admin(.*)',
+  '/api/admin(.*)',
+]);
+
+// API routes that need special handling
+const isApiRoute = createRouteMatcher(['/api(.*)']);
+
+// =============================================================================
+// MIDDLEWARE
+// =============================================================================
+
+export default clerkMiddleware(async (auth, req) => {
+  const { userId, sessionClaims } = await auth();
+
+  // Allow public routes
+  if (isPublicRoute(req)) {
+    return NextResponse.next();
+  }
+
+  // Protect all non-public routes
+  if (!userId) {
+    const signInUrl = new URL('/sign-in', req.url);
+    signInUrl.searchParams.set('redirect_url', req.url);
+    return NextResponse.redirect(signInUrl);
+  }
+
+  // Check admin routes
+  if (isAdminRoute(req)) {
+    const role = sessionClaims?.metadata?.role as string | undefined;
+
+    if (role !== 'admin' && role !== 'super_admin') {
+      return NextResponse.redirect(new URL('/unauthorized', req.url));
+    }
+  }
+
+  // Add user info to headers for API routes
+  if (isApiRoute(req)) {
+    const requestHeaders = new Headers(req.headers);
+    requestHeaders.set('x-user-id', userId);
+
+    return NextResponse.next({
+      request: {
+        headers: requestHeaders,
+      },
+    });
+  }
+
+  return NextResponse.next();
+});
+
+export const config = {
+  matcher: [
+    // Skip Next.js internals and static files
+    '/((?!_next|[^?]*\\.(?:html?|css|js(?!on)|jpe?g|webp|png|gif|svg|ttf|woff2?|ico|csv|docx?|xlsx?|zip|webmanifest)).*)',
+    // Always run for API routes
+    '/(api|trpc)(.*)',
+  ],
+};
+
+// =============================================================================
+// USAGE EXAMPLES
+// =============================================================================
+
+/*
+// In a Server Component - get current user:
+
+import { auth, currentUser } from '@clerk/nextjs/server';
+
+export default async function DashboardPage() {
+  const { userId } = await auth();
+  const user = await currentUser();
+
+  if (!userId) {
+    redirect('/sign-in');
+  }
+
+  return <div>Welcome, {user?.firstName}!</div>;
+}
+
+// In a Client Component - use hooks:
+
+'use client';
+
+import { useUser, useAuth } from '@clerk/nextjs';
+
+export function UserProfile() {
+  const { user, isLoaded } = useUser();
+  const { signOut } = useAuth();
+
+  if (!isLoaded) return <div>Loading...</div>;
+
+  return (
+    <div>
+      <p>Hello, {user?.firstName}</p>
+      <button onClick={() => signOut()}>Sign Out</button>
+    </div>
+  );
+}
+
+// In an API Route:
+
+import { auth } from '@clerk/nextjs/server';
+import { NextResponse } from 'next/server';
+
+export async function GET() {
+  const { userId } = await auth();
+
+  if (!userId) {
+    return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+  }
+
+  // Your logic here
+  return NextResponse.json({ userId });
+}
+*/