ultra-dex 2.2.1 → 3.2.0

package/README.md

@@ -1,21 +1,24 @@
 # Ultra-Dex CLI
 
-> Scaffold Ultra-Dex projects from the command line, now with **AI-powered plan generation**.
+> Scaffold Ultra-Dex projects from the command line, now with **AI-powered plan generation** and **God Mode** autonomous agents.
 
-## What's New in v2.1
+## What's New in v3.2.0 (Professional Purple)
 
 ```bash
-# 🚀 Generate a complete 34-section plan with AI
-npx ultra-dex generate "A task management SaaS for remote teams"
+# 🤖 Autonomous agent swarms with parallel execution
+npx ultra-dex swarm "Build user authentication" --parallel
 
-# 🔧 Start AI-assisted development
-npx ultra-dex build --agent planner
+# 🔄 Start the Active Kernel (MCP + WebSocket + Dashboard)
+npx ultra-dex serve
 
-# 🔍 Review code against plan
-npx ultra-dex review
+# 🧠 Structural Graph Health Check
+npx ultra-dex check
 
-# 📊 Quick alignment check
-npx ultra-dex align
+# 🖥️ Live Dashboard with Brain Visualization
+npx ultra-dex dashboard
+
+# 🛠️ Self-Healing CI/CD Monitor
+npx ultra-dex ci-monitor --port 3003
 ```
 
 ## First 10 Minutes
@@ -40,206 +43,164 @@ npm install -g ultra-dex
 ultra-dex generate "Your idea"
 ```
 
-## AI Commands (v2.0+)
-
-### `generate` - AI Plan Generation
+## Scaffold Command (NEW)
 
-Generate a complete implementation plan using AI:
+Generate production-ready boilerplate instantly:
 
 ```bash
-# Basic usage
-npx ultra-dex generate "A booking platform for dog groomers"
+# List available templates
+npx ultra-dex scaffold --list
 
-# With options
-npx ultra-dex generate "idea" --provider openai --output ./my-project
+# Generate Next.js 15 + Prisma + Clerk project
+npx ultra-dex scaffold next15-prisma-clerk
 
-# Preview without calling AI
-npx ultra-dex generate "idea" --dry-run
+# Generate Remix + Supabase project
+npx ultra-dex scaffold remix-supabase
+
+# Generate SvelteKit + Drizzle project
+npx ultra-dex scaffold sveltekit-drizzle
 ```
 
-**Options:**
-| Option | Description | Default |
-|--------|-------------|---------|
-| `-p, --provider` | AI provider (claude, openai, gemini) | claude |
-| `-m, --model` | Specific model to use | provider default |
-| `-o, --output` | Output directory | current |
-| `-k, --key` | API key | env variable |
-| `--dry-run` | Show structure only | false |
+## AI Commands (God Mode)
 
-### `build` - AI-Assisted Development
+### `swarm` - Autonomous Agent Pipeline
 
-Start development with AI agents:
+Run complex task pipelines with multiple agents:
 
 ```bash
-# Interactive agent selection
-npx ultra-dex build
-
-# Specific agent
-npx ultra-dex build --agent backend --task "Create user API endpoints"
+# Build a feature with a swarm of agents
+npx ultra-dex swarm "Implement Stripe subscriptions" --parallel
 
-# Copy to clipboard for external AI
-npx ultra-dex build --agent planner --copy
+# Dry run to see the plan
+npx ultra-dex swarm "Migrate to Tailwind" --dry-run
 ```
 
-**Available Agents:**
-| Agent | Role |
-|-------|------|
-| `planner` | Break down features into atomic tasks |
-| `cto` | Architecture decisions |
-| `backend` | API endpoints and business logic |
-| `frontend` | UI components and pages |
-| `database` | Schema design and migrations |
-| `auth` | Authentication and authorization |
-| `security` | Security audit |
-| `testing` | Write and run tests |
-| `reviewer` | Code review |
-| `devops` | Deployment and CI/CD |
+### `serve` - Active Kernel
 
-### `review` - Code Review
-
-Check code alignment with plan:
+Start the MCP-compatible server for IDE integration and dashboard:
 
 ```bash
-npx ultra-dex review
-npx ultra-dex review --dir ./src
+npx ultra-dex serve
 ```
 
-### `align` - Quick Score
+### `auto-implement` - Autonomous Engineer
 
-Get alignment score instantly:
+Fully autonomous feature implementation loop:
 
 ```bash
-npx ultra-dex align
-npx ultra-dex align --json  # Machine-readable output
+# Implement a feature from scratch
+npx ultra-dex auto-implement "Create a user profile page with Avatar upload"
 ```
 
-**Environment Variables:**
+### `watch` - Real-time Daemon
+
+Keep the project state and Code Property Graph updated as you code:
+
 ```bash
-ANTHROPIC_API_KEY=sk-ant-...  # Claude (recommended)
-OPENAI_API_KEY=sk-...         # OpenAI
-GOOGLE_AI_KEY=...             # Gemini
+npx ultra-dex watch --interval 1000
 ```
 
-### `init`
+## Core Commands
 
-Interactive project setup:
+### `generate` - AI Plan Generation
+
+Generate a complete implementation plan using AI:
 
 ```bash
-npx ultra-dex init
+# Basic usage
+npx ultra-dex generate "A booking platform for dog groomers"
+
+# With options
+npx ultra-dex generate "idea" --provider openai --output ./my-project
 ```
 
-Generate a runnable scaffold:
+### `build` - AI-Assisted Development
 
-```bash
-npx ultra-dex init --live --stack next15-prisma-clerk
-```
+Start development with AI agents (Interactive Mode):
 
-Presets: `next15-prisma-clerk`, `remix-supabase`, `sveltekit-drizzle`.
+```bash
+# Interactive agent selection
+npx ultra-dex build
 
-**Options (init):**
-| Option | Description |
-|--------|-------------|
-| `-n, --name <name>` | Project name (skips prompt) |
-| `-d, --dir <directory>` | Output directory (default: current) |
-| `--preview` | Preview files without creating them |
-| `--live` | Generate a runnable scaffold |
-| `--stack <preset>` | Preset: next15-prisma-clerk, remix-supabase, sveltekit-drizzle |
+# Specific agent
+npx ultra-dex run backend --task "Create user API endpoints"
+```
 
-### `audit`
+### `review` - Graph-Aware Code Review
 
-Check project completeness:
+Audit code against the plan using structural graph analysis:
 
 ```bash
-npx ultra-dex audit
+npx ultra-dex review
 ```
 
-### `agents`
+### `align` - Quick Score
 
-List and use AI agent prompts:
+Get alignment score (Files + Plan + Graph Integrity):
 
 ```bash
-npx ultra-dex agents           # List all agents
-npx ultra-dex agent backend    # Show specific agent
+npx ultra-dex align
 ```
 
-### `fetch`
+### `check` - System Health
 
-Download assets for offline use:
+Verify repository health and graph consistency:
 
 ```bash
-npx ultra-dex fetch
-npx ultra-dex fetch --agents --rules
+npx ultra-dex check
 ```
 
-### `serve`
-
-Serve context (MCP-compatible):
+## Environment Variables
 
 ```bash
-npx ultra-dex serve --port 3001
+ANTHROPIC_API_KEY=sk-ant-...  # Claude (recommended for complex tasks)
+OPENAI_API_KEY=sk-...         # OpenAI
+GOOGLE_AI_KEY=...             # Gemini
+ULTRA_DEX_DEFAULT_PROVIDER=claude # Default AI provider
 ```
 
-### Other Commands
+## All Commands (38+)
 
 | Command | Description |
 |---------|-------------|
 | `init` | Initialize a new project |
-| `init --preview` | Preview files without creating them |
-| `init --live` | Generate a runnable scaffold |
+| `scaffold` | **NEW** Generate production boilerplate |
+| `generate` | Generate full SaaS plan from idea |
+| `swarm` | Run autonomous agent pipeline |
+| `auto-implement` | Autonomously implement a feature |
+| `serve` | Start the Active Kernel (MCP + Dashboard) |
+| `watch` | Auto-update state on file changes |
+| `build` | Interactive AI agent development loop |
+| `review` | Review code against plan |
+| `align` | Quick alignment score |
 | `audit` | Audit project for completeness |
-| `examples` | List available examples |
-| `agents` | List AI agents |
-| `agent <name>` | Show specific agent prompt |
-| `hooks` | Set up git pre-commit hooks |
-| `fetch` | Download assets for offline |
-| `serve` | Serve context over HTTP |
-| `validate` | Validate project structure |
-| `workflow <feature>` | Show workflow for a feature |
-| `suggest` | Get AI agent suggestions |
-| `--help` | Show help |
-| `--version` | Show version |
-
-## Example: AI Generation
-
-```bash
-$ npx ultra-dex generate "A booking platform for dog groomers"
-
-🚀 Ultra-Dex AI Plan Generator
-
-✔ AI modules loaded
-
-📝 Idea: "A booking platform for dog groomers"
-
-✓ Using Claude (Anthropic) (claude-sonnet-4-20250514)
-
-📊 Estimated Generation:
-   Input tokens:  ~2,650
-   Output tokens: ~40,000
-   Estimated cost: ~$0.45
-
-? Proceed with generation? Yes
-
-⚡ Generating 34-section implementation plan...
-
-✔ Generation complete!
-
-✅ All 34 sections generated
-   Tokens used: 42,350 tokens (2,650 in / 39,700 out)
-   Actual cost: $0.52
-
-📦 Project: GroomBook
-
-✓ Created ./IMPLEMENTATION-PLAN.md
-✓ Created ./QUICK-START.md
-✓ Created ./CONTEXT.md
-
-🎉 Generation complete!
-
-Next steps:
-  1. Review IMPLEMENTATION-PLAN.md
-  2. Customize sections as needed
-  3. Start building with: npx ultra-dex init
-```
+| `validate` | Validate project against 21-step framework |
+| `check` | Verify repository health |
+| `doctor` | Diagnose project issues |
+| `dashboard` | Start the local web dashboard |
+| `sync` | Sync project state across devices |
+| `fetch` | Download assets for offline use |
+| `hooks` | Manage Git hooks |
+| `export` | Export project context |
+| `upgrade` | Check for CLI updates |
+| `config` | Manage CLI and editor configuration |
+| `agents` | List available AI agents |
+| `agent` | Show specific agent prompt |
+| `workflow` | Show specific production workflow |
+| `suggest` | Get AI-powered task suggestions |
+| `plan` | Generate or update implementation plan |
+| `fix` | Automatically fix project issues |
+| `team` | Team collaboration commands |
+| `memory` | Manage long-term agent memory |
+| `verify` | Run executable verification |
+| `ci-monitor` | Self-healing CI/CD listener |
+| `status` | Show project and kernel status |
+| `pre-commit` | Run pre-commit checks |
+| `state` | Manage machine-readable state |
+| `examples` | Access reference workflows |
+| `pack` | Bundle agents and rules |
+| `run` | Execute agent task |
+| `diff` | Compare plan vs implemented code |
 
 ## Links
 
@@ -250,4 +211,4 @@ Next steps:
 
 ## License
 
-MIT
+MIT

package/assets/agents/00-AGENT_INDEX.md

@@ -1,6 +1,6 @@
 # Ultra-Dex Agent Index
 
-Quick reference for all 15 production agents organized by tier.
+Quick reference for all 16 production agents organized by tier.
 
 ---
 

package/assets/code-patterns/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 });
+}
+*/