ultra-dex 3.1.0 → 3.3.0

package/README.md

@@ -2,23 +2,23 @@
 
 > Scaffold Ultra-Dex projects from the command line, now with **AI-powered plan generation** and **God Mode** autonomous agents.
 
-## What's New in v2.2+ (God Mode)
+## What's New in v3.2.0 (Professional Purple)
 
 ```bash
-# 🤖 Autonomous feature implementation (Plan -> Code -> Verify)
-npx ultra-dex auto-implement "Add Stripe checkout"
+# 🤖 Autonomous agent swarms with parallel execution
+npx ultra-dex swarm "Build user authentication" --parallel
 
-# 🔄 Real-time State & Graph Synchronization
-npx ultra-dex sync --push --target ./s3-bucket
-
-# 🛡️ Self-Healing CI/CD Monitor
-npx ultra-dex ci-monitor --port 3003
+# 🔄 Start the Active Kernel (MCP + WebSocket + Dashboard)
+npx ultra-dex serve
 
 # 🧠 Structural Graph Health Check
 npx ultra-dex check
 
 # 🖥️ Live Dashboard with Brain Visualization
 npx ultra-dex dashboard
+
+# 🛠️ Self-Healing CI/CD Monitor
+npx ultra-dex ci-monitor --port 3003
 ```
 
 ## First 10 Minutes
@@ -43,53 +43,61 @@ npm install -g ultra-dex
 ultra-dex generate "Your idea"
 ```
 
-## AI Commands (God Mode)
+## Scaffold Command (NEW)
 
-### `auto-implement` - Autonomous Engineer
-
-Fully autonomous feature implementation loop:
+Generate production-ready boilerplate instantly:
 
 ```bash
-# Implement a feature from scratch
-npx ultra-dex auto-implement "Create a user profile page with Avatar upload"
+# List available templates
+npx ultra-dex scaffold --list
+
+# Generate Next.js 15 + Prisma + Clerk project
+npx ultra-dex scaffold next15-prisma-clerk
+
+# Generate Remix + Supabase project
+npx ultra-dex scaffold remix-supabase
 
-# Preview the plan without coding
-npx ultra-dex auto-implement "Migrate to Tailwind" --dry-run
+# Generate SvelteKit + Drizzle project
+npx ultra-dex scaffold sveltekit-drizzle
 ```
 
-**How it works:**
-1. **Structural Analysis:** Scans the Code Property Graph (CPG) for impact.
-2. **Planning:** @Planner breaks down the task.
-3. **Execution:** @Backend/@Frontend implement the code.
-4. **Verification:** @Testing verifies the changes.
+## AI Commands (God Mode)
 
-### `sync` - State Synchronization
+### `swarm` - Autonomous Agent Pipeline
 
-Keep your project's "Brain" (Context + Graph) in sync across devices:
+Run complex task pipelines with multiple agents:
 
 ```bash
-# Push state to a shared location
-npx ultra-dex sync --push --target ./shared-drive
+# Build a feature with a swarm of agents
+npx ultra-dex swarm "Implement Stripe subscriptions" --parallel
 
-# Pull state from a shared location
-npx ultra-dex sync --pull --target ./shared-drive
+# Dry run to see the plan
+npx ultra-dex swarm "Migrate to Tailwind" --dry-run
 ```
 
-### `ci-monitor` - Self-Healing CI/CD
+### `serve` - Active Kernel
 
-Listen for build failures and automatically fix them:
+Start the MCP-compatible server for IDE integration and dashboard:
 
 ```bash
-npx ultra-dex ci-monitor --port 3003
+npx ultra-dex serve
+```
+
+### `auto-implement` - Autonomous Engineer
+
+Fully autonomous feature implementation loop:
+
+```bash
+# Implement a feature from scratch
+npx ultra-dex auto-implement "Create a user profile page with Avatar upload"
 ```
-*Configure your CI provider (GitHub Actions) to send webhooks to this port.*
 
 ### `watch` - Real-time Daemon
 
-Keep the Code Property Graph updated as you code:
+Keep the project state and Code Property Graph updated as you code:
 
 ```bash
-npx ultra-dex watch
+npx ultra-dex watch --interval 1000
 ```
 
 ## Core Commands
@@ -115,7 +123,7 @@ Start development with AI agents (Interactive Mode):
 npx ultra-dex build
 
 # Specific agent
-npx ultra-dex build --agent backend --task "Create user API endpoints"
+npx ultra-dex run backend --task "Create user API endpoints"
 ```
 
 ### `review` - Graph-Aware Code Review
@@ -148,54 +156,51 @@ npx ultra-dex check
 ANTHROPIC_API_KEY=sk-ant-...  # Claude (recommended for complex tasks)
 OPENAI_API_KEY=sk-...         # OpenAI
 GOOGLE_AI_KEY=...             # Gemini
-ULTRA_DEX_DEFAULT_PROVIDER=router # Use "router" for hybrid local/cloud intelligence
+ULTRA_DEX_DEFAULT_PROVIDER=claude # Default AI provider
 ```
 
-## All Commands
+## All Commands (38+)
 
 | Command | Description |
 |---------|-------------|
+| `init` | Initialize a new project |
+| `scaffold` | **NEW** Generate production boilerplate |
 | `generate` | Generate full SaaS plan from idea |
-| `auto-implement` | **(NEW)** Autonomously implement a feature |
+| `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 (Graph-Aware) |
+| `review` | Review code against plan |
 | `align` | Quick alignment score |
-| `sync` | **(NEW)** Sync project state across devices |
-| `check` | **(NEW)** Verify repository health |
-| `watch` | **(NEW)** Real-time graph synchronization daemon |
-| `ci-monitor` | **(NEW)** Self-healing CI/CD webhook listener |
-| `dashboard` | Start the JARVIS web dashboard |
-| `init` | Initialize a new project |
 | `audit` | Audit project for completeness |
-| `agents` | List AI agents |
-| `team` | Team collaboration (local) |
-| `fetch` | Download assets for offline |
-| `serve` | Serve context (MCP-compatible) |
-
-## 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"
-
-...
-
-✅ All 34 sections generated
-   Tokens used: 42,350 tokens
-   Actual cost: $0.52
-
-📦 Project: GroomBook
-
-✓ Created ./IMPLEMENTATION-PLAN.md
-✓ Created ./QUICK-START.md
-✓ Created ./CONTEXT.md
-✓ Created .ultra/state.json (GOD MODE ACTIVE)
-```
+| `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
 
@@ -206,4 +211,4 @@ $ npx ultra-dex generate "A booking platform for dog groomers"
 
 ## License
 
-MIT
+MIT

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

package/assets/code-patterns/prisma-schema.prisma

@@ -0,0 +1,224 @@
+// Ultra-Dex Production Pattern: Full Prisma Schema
+// Copy to prisma/schema.prisma
+
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+}
+
+// =============================================================================
+// CORE MODELS
+// =============================================================================
+
+model User {
+  id        String   @id @default(cuid())
+  clerkId   String   @unique
+  email     String   @unique
+  name      String?
+  imageUrl  String?
+  role      UserRole @default(USER)
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  // Relations
+  organizationMemberships OrganizationMember[]
+  createdOrganizations    Organization[]       @relation("OrganizationCreator")
+  projects                Project[]
+  comments                Comment[]
+  activityLogs            ActivityLog[]
+
+  @@index([clerkId])
+  @@index([email])
+  @@map("users")
+}
+
+enum UserRole {
+  USER
+  ADMIN
+  SUPER_ADMIN
+}
+
+// =============================================================================
+// MULTI-TENANCY MODELS
+// =============================================================================
+
+model Organization {
+  id        String   @id @default(cuid())
+  name      String
+  slug      String   @unique
+  logo      String?
+  plan      Plan     @default(FREE)
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  // Relations
+  creatorId String
+  creator   User                 @relation("OrganizationCreator", fields: [creatorId], references: [id])
+  members   OrganizationMember[]
+  projects  Project[]
+  invoices  Invoice[]
+
+  @@index([slug])
+  @@map("organizations")
+}
+
+model OrganizationMember {
+  id             String         @id @default(cuid())
+  role           MemberRole     @default(MEMBER)
+  joinedAt       DateTime       @default(now())
+  organizationId String
+  organization   Organization   @relation(fields: [organizationId], references: [id], onDelete: Cascade)
+  userId         String
+  user           User           @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([organizationId, userId])
+  @@map("organization_members")
+}
+
+enum MemberRole {
+  OWNER
+  ADMIN
+  MEMBER
+  VIEWER
+}
+
+enum Plan {
+  FREE
+  PRO
+  ENTERPRISE
+}
+
+// =============================================================================
+// PROJECT MODELS
+// =============================================================================
+
+model Project {
+  id             String       @id @default(cuid())
+  name           String
+  description    String?
+  status         ProjectStatus @default(ACTIVE)
+  createdAt      DateTime     @default(now())
+  updatedAt      DateTime     @updatedAt
+
+  // Relations
+  organizationId String
+  organization   Organization @relation(fields: [organizationId], references: [id], onDelete: Cascade)
+  ownerId        String
+  owner          User         @relation(fields: [ownerId], references: [id])
+  tasks          Task[]
+  comments       Comment[]
+
+  @@index([organizationId])
+  @@map("projects")
+}
+
+enum ProjectStatus {
+  ACTIVE
+  ARCHIVED
+  COMPLETED
+}
+
+model Task {
+  id          String     @id @default(cuid())
+  title       String
+  description String?
+  status      TaskStatus @default(TODO)
+  priority    Priority   @default(MEDIUM)
+  dueDate     DateTime?
+  createdAt   DateTime   @default(now())
+  updatedAt   DateTime   @updatedAt
+
+  // Relations
+  projectId String
+  project   Project   @relation(fields: [projectId], references: [id], onDelete: Cascade)
+  comments  Comment[]
+
+  @@index([projectId])
+  @@index([status])
+  @@map("tasks")
+}
+
+enum TaskStatus {
+  TODO
+  IN_PROGRESS
+  IN_REVIEW
+  DONE
+}
+
+enum Priority {
+  LOW
+  MEDIUM
+  HIGH
+  URGENT
+}
+
+model Comment {
+  id        String   @id @default(cuid())
+  content   String
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  // Relations
+  authorId  String
+  author    User     @relation(fields: [authorId], references: [id])
+  projectId String?
+  project   Project? @relation(fields: [projectId], references: [id], onDelete: Cascade)
+  taskId    String?
+  task      Task?    @relation(fields: [taskId], references: [id], onDelete: Cascade)
+
+  @@map("comments")
+}
+
+// =============================================================================
+// BILLING MODELS
+// =============================================================================
+
+model Invoice {
+  id             String        @id @default(cuid())
+  stripeId       String        @unique
+  amount         Int
+  currency       String        @default("usd")
+  status         InvoiceStatus @default(PENDING)
+  paidAt         DateTime?
+  createdAt      DateTime      @default(now())
+
+  // Relations
+  organizationId String
+  organization   Organization @relation(fields: [organizationId], references: [id])
+
+  @@index([organizationId])
+  @@map("invoices")
+}
+
+enum InvoiceStatus {
+  PENDING
+  PAID
+  FAILED
+  REFUNDED
+}
+
+// =============================================================================
+// AUDIT LOG
+// =============================================================================
+
+model ActivityLog {
+  id        String   @id @default(cuid())
+  action    String
+  entity    String
+  entityId  String
+  metadata  Json?
+  createdAt DateTime @default(now())
+
+  // Relations
+  userId String
+  user   User   @relation(fields: [userId], references: [id])
+
+  @@index([userId])
+  @@index([entity, entityId])
+  @@index([createdAt])
+  @@map("activity_logs")
+}