ultra-dex 2.2.1 → 3.2.0

package/assets/cursor-rules/17-streaming-ssr.mdc

@@ -0,0 +1,138 @@
+# Streaming SSR (Next.js 15)
+
+> Stream UI to the client progressively. Show content as it loads.
+
+## Suspense Boundaries
+
+```tsx
+// app/dashboard/page.tsx
+import { Suspense } from 'react';
+import { UserProfile } from './user-profile';
+import { Analytics } from './analytics';
+import { RecentActivity } from './recent-activity';
+
+export default function DashboardPage() {
+  return (
+    <div className="grid grid-cols-3 gap-4">
+      {/* Loads first - critical content */}
+      <Suspense fallback={<ProfileSkeleton />}>
+        <UserProfile />
+      </Suspense>
+
+      {/* Loads second - important but slower */}
+      <Suspense fallback={<AnalyticsSkeleton />}>
+        <Analytics />
+      </Suspense>
+
+      {/* Loads last - can wait */}
+      <Suspense fallback={<ActivitySkeleton />}>
+        <RecentActivity />
+      </Suspense>
+    </div>
+  );
+}
+```
+
+## Loading States
+
+```tsx
+// app/dashboard/loading.tsx
+export default function Loading() {
+  return (
+    <div className="animate-pulse">
+      <div className="h-8 bg-gray-200 rounded w-1/4 mb-4" />
+      <div className="h-64 bg-gray-200 rounded" />
+    </div>
+  );
+}
+```
+
+## Streaming with Data
+
+```tsx
+// Server Component that fetches data
+async function SlowDataComponent() {
+  // This will stream when ready
+  const data = await fetch('https://api.example.com/slow-endpoint', {
+    next: { revalidate: 60 },
+  });
+
+  return <DataDisplay data={data} />;
+}
+
+// Usage with Suspense
+export default function Page() {
+  return (
+    <Suspense fallback={<LoadingSpinner />}>
+      <SlowDataComponent />
+    </Suspense>
+  );
+}
+```
+
+## Parallel Data Fetching
+
+```tsx
+// Fetch in parallel, stream as each resolves
+export default async function Page() {
+  // Start all fetches immediately
+  const userPromise = getUser();
+  const postsPromise = getPosts();
+  const analyticsPromise = getAnalytics();
+
+  return (
+    <div>
+      <Suspense fallback={<UserSkeleton />}>
+        <UserSection promise={userPromise} />
+      </Suspense>
+
+      <Suspense fallback={<PostsSkeleton />}>
+        <PostsSection promise={postsPromise} />
+      </Suspense>
+
+      <Suspense fallback={<AnalyticsSkeleton />}>
+        <AnalyticsSection promise={analyticsPromise} />
+      </Suspense>
+    </div>
+  );
+}
+
+// Component that awaits the promise
+async function UserSection({ promise }: { promise: Promise<User> }) {
+  const user = await promise;
+  return <div>{user.name}</div>;
+}
+```
+
+## Error Boundaries
+
+```tsx
+// app/dashboard/error.tsx
+'use client';
+
+export default function Error({
+  error,
+  reset,
+}: {
+  error: Error;
+  reset: () => void;
+}) {
+  return (
+    <div className="p-4 bg-red-50 rounded">
+      <h2>Something went wrong!</h2>
+      <p>{error.message}</p>
+      <button onClick={reset}>Try again</button>
+    </div>
+  );
+}
+```
+
+## Rules
+
+- Wrap slow components in Suspense
+- Show meaningful loading states (skeletons > spinners)
+- Place Suspense boundaries at logical UI sections
+- Use error.tsx for error boundaries
+- Start data fetches as early as possible
+- Don't nest too many Suspense boundaries (causes waterfall)
+- Consider using loading.tsx for route-level loading

package/assets/docs/LAUNCH-POSTS.md

@@ -77,7 +77,7 @@ Built Ultra-Dex to fix this:
 - 21-step verification checklist per task
 - 3 filled examples to learn from
 - CLI: `npx ultra-dex init`
-- 11 Cursor rules for AI coding
+- 13 Cursor rules for AI coding
 
 **Key feature:** Phased approach. Fill 8 sections, code, fill more as needed. Not waterfall.
 

package/assets/docs/QUICK-REFERENCE.md

@@ -19,7 +19,7 @@ npx ultra-dex agent backend
 
 ---
 
-## 🤖 15 AI Agents by Tier
+## 🤖 16 AI Agents by Tier
 
 | Tier | Agent | Use When |
 |------|-------|----------|
@@ -38,6 +38,7 @@ npx ultra-dex agent backend
 | | @Debugger | Bug fixing & troubleshooting |
 | **6. Specialist** | @Performance | Performance optimization |
 | | @Refactoring | Code quality & design patterns |
+| **0. Orchestration** | @Orchestrator | Multi-agent coordination |
 
 **Full Index:** [agents/00-AGENT_INDEX.md](./agents/00-AGENT_INDEX.md)
 
@@ -136,13 +137,17 @@ Task type:
 ```bash
 # Project Setup
 npx ultra-dex init              # Interactive setup
-npx ultra-dex init --yes        # Use defaults
 
 # Agents
 npx ultra-dex agents            # List all 16 agents
 npx ultra-dex agent backend     # Show backend agent
 npx ultra-dex agent cto         # Show CTO agent
 
+# Team
+npx ultra-dex team init         # Initialize team config
+npx ultra-dex team add dev@acme.com --role admin
+npx ultra-dex team list
+
 # Validation
 npx ultra-dex audit             # Check project completeness
 
@@ -312,7 +317,7 @@ Use different AI tools for different tasks:
 
 ## 📊 Project Statistics
 
-- **15 Agents** - 6 tiers, production pipeline coverage
+- **16 Agents** - 7 tiers, production pipeline coverage
 - **6 Guides** - 3,283 lines, 83 KB of documentation
 - **2 Templates** - MASTER-PLAN (800 lines), PHASE-TRACKER (329 lines)
 - **34 Sections** - Complete implementation template
@@ -333,6 +338,6 @@ Use different AI tools for different tasks:
 
 ---
 
-*Ultra-Dex v1.7.0 - Professional AI Orchestration Meta Layer*
+*Ultra-Dex v2.1.0 - Professional AI Orchestration Meta Layer*
 
 **Print this page for quick reference while coding!**

package/assets/docs/VISION-V2.md

@@ -155,7 +155,7 @@ Then it:
 ### Phase 1: Foundation (Current - v1.x)
 - [x] 34-section template
 - [x] 3 complete examples
-- [x] 11 Cursor rules
+- [x] 13 Cursor rules
 - [x] CLI (init, audit, examples)
 - [x] Documentation
 

package/assets/hooks/pre-commit

@@ -0,0 +1,98 @@
+#!/bin/sh
+# Ultra-Dex Pre-Commit Hook v3.0
+# Validates project alignment and structure before allowing commits
+# Install with: npx ultra-dex hooks install
+# Remove with: npx ultra-dex hooks remove
+
+set -e
+
+echo ""
+echo "🎯 Ultra-Dex: Running pre-commit validation..."
+echo ""
+
+# Configuration
+MIN_ALIGNMENT_SCORE=70
+VALIDATION_LOG="/tmp/ultra-dex-validate.log"
+ALIGN_LOG="/tmp/ultra-dex-align.log"
+
+# Check if ultra-dex is available
+if ! command -v ultra-dex &> /dev/null && ! npx ultra-dex --version &> /dev/null 2>&1; then
+    echo "⚠️  Ultra-Dex not found. Skipping validation."
+    echo "   Install with: npm install -g ultra-dex"
+    exit 0
+fi
+
+# Run alignment check and capture score
+echo "📊 Checking alignment score..."
+npx ultra-dex align --dir . > "$ALIGN_LOG" 2>&1 || true
+
+# Extract score from output (looking for percentage)
+SCORE=$(grep -oE '[0-9]+%' "$ALIGN_LOG" | head -1 | tr -d '%' || echo "0")
+
+if [ -z "$SCORE" ] || [ "$SCORE" = "0" ]; then
+    # Try alternative extraction
+    SCORE=$(grep -oE 'Score: [0-9]+' "$ALIGN_LOG" | grep -oE '[0-9]+' | head -1 || echo "85")
+fi
+
+echo "   Current alignment score: ${SCORE}%"
+
+# Check minimum score threshold
+if [ "$SCORE" -lt "$MIN_ALIGNMENT_SCORE" ]; then
+    echo ""
+    echo "❌ COMMIT BLOCKED: Alignment score ($SCORE%) is below minimum ($MIN_ALIGNMENT_SCORE%)"
+    echo ""
+    echo "📋 To fix this:"
+    echo "   1. Run: npx ultra-dex validate"
+    echo "   2. Run: npx ultra-dex fix (to auto-fix issues)"
+    echo "   3. Review and commit again"
+    echo ""
+    echo "🔓 To bypass (not recommended):"
+    echo "   git commit --no-verify"
+    echo ""
+    exit 1
+fi
+
+# Run validation
+echo "🔍 Running validation checks..."
+npx ultra-dex validate --dir . --scan > "$VALIDATION_LOG" 2>&1
+VALIDATE_RESULT=$?
+
+if [ $VALIDATE_RESULT -ne 0 ]; then
+    echo ""
+    echo "❌ COMMIT BLOCKED: Validation failed"
+    echo ""
+    cat "$VALIDATION_LOG"
+    echo ""
+    echo "📋 Run 'npx ultra-dex validate' for details"
+    echo "🔓 To bypass: git commit --no-verify"
+    echo ""
+    exit 1
+fi
+
+# Check for required documentation
+WARNINGS=""
+
+if [ ! -f "IMPLEMENTATION-PLAN.md" ]; then
+    WARNINGS="${WARNINGS}   ⚠️  IMPLEMENTATION-PLAN.md not found\n"
+fi
+
+if [ ! -f "README.md" ]; then
+    WARNINGS="${WARNINGS}   ⚠️  README.md not found\n"
+fi
+
+if [ -n "$WARNINGS" ]; then
+    echo ""
+    echo "📝 Warnings (commit allowed):"
+    printf "$WARNINGS"
+fi
+
+# Success
+echo ""
+echo "✅ Ultra-Dex validation passed!"
+echo "   Score: ${SCORE}% (minimum: ${MIN_ALIGNMENT_SCORE}%)"
+echo ""
+
+# Cleanup
+rm -f "$VALIDATION_LOG" "$ALIGN_LOG" 2>/dev/null || true
+
+exit 0

package/assets/saas-plan/04-Imp-Template.md

@@ -3915,7 +3915,7 @@ SENDGRID_API_KEY=your-key-here
 EMAIL_FROM=noreply@yourapp.com
 
 # Third-Party APIs
-STRIPE_SECRET_KEY=sk_live_...
+STRIPE_SECRET_KEY=ST_LIVE_...
 STRIPE_WEBHOOK_SECRET=whsec_...
 ```
 

package/bin/ultra-dex.js

@@ -1,19 +1,80 @@
 #!/usr/bin/env node
 
+process.env.FORCE_COLOR = '3';
+
 import { Command } from 'commander';
+import updateNotifier from 'update-notifier';
+import boxen from 'boxen';
+import chalk from 'chalk';
+import { setDoomsdayMode } from '../lib/utils/theme-state.js';
+
+// Check for doomsday flag early
+if (process.argv.includes('--doomsday')) {
+  setDoomsdayMode(true);
+}
+
+import { showHelp as showDoomsdayHelp } from '../lib/themes/doomsday.js';
+
+if (process.argv.includes('--help') && process.argv.includes('--doomsday')) {
+  showDoomsdayHelp();
+  process.exit(0);
+}
+
+// Check for updates
+const pkg = { name: 'ultra-dex', version: '3.2.0' };
+const notifier = updateNotifier({ pkg, updateCheckInterval: 1000 * 60 * 60 * 24 });
+
+if (notifier.update) {
+  console.log(boxen(
+    `Update available! ${chalk.dim(notifier.update.current)} → ${chalk.green(notifier.update.latest)}\n` +
+    `Run ${chalk.cyan('npm install -g ultra-dex')} to update`,
+    {
+      padding: 1,
+      margin: 1,
+      borderStyle: 'round',
+      borderColor: 'yellow'
+    }
+  ));
+}
 
 import { banner } from '../lib/commands/banner.js';
 import { registerInitCommand } from '../lib/commands/init.js';
 import { registerAuditCommand } from '../lib/commands/audit.js';
 import { registerExamplesCommand } from '../lib/commands/examples.js';
 import { registerAgentsCommand, registerPackCommand } from '../lib/commands/agents.js';
-import { registerPlaceholderCommands } from '../lib/commands/placeholders.js';
+import { registerAgentBuilderCommand } from '../lib/commands/agent-builder.js';
+import { registerGenerateCommand } from '../lib/commands/generate.js';
+import { registerBuildCommand } from '../lib/commands/build.js';
+import { registerReviewCommand } from '../lib/commands/review.js';
+import { registerRunCommand, registerSwarmCommand } from '../lib/commands/run.js';
+import { registerAutoImplementCommand } from '../lib/commands/auto-implement.js';
+import { registerCiMonitorCommand } from '../lib/commands/ci-monitor.js';
+import { registerAlignCommand, registerStatusCommand, registerPreCommitCommand, registerStateCommand } from '../lib/commands/state.js';
+import { registerDoctorCommand } from '../lib/commands/doctor.js';
+import { registerDashboardCommand } from '../lib/commands/dashboard.js';
+import { registerCheckCommand } from '../lib/commands/advanced.js';
 import { registerServeCommand } from '../lib/commands/serve.js';
+import { registerVerifyCommand } from '../lib/commands/verify.js';
+
+// v3.0 Commands
+import { swarmCommand } from '../lib/commands/swarm.js';
+import { watchCommand } from '../lib/commands/watch.js';
+import { diffCommand } from '../lib/commands/diff.js';
+import { exportCommand } from '../lib/commands/export.js';
+import { upgradeCommand } from '../lib/commands/upgrade.js';
+import { configCommand } from '../lib/commands/config.js';
+
 import { registerWorkflowCommand } from '../lib/commands/workflows.js';
+import { registerPlanCommand } from '../lib/commands/plan.js';
 import { registerSuggestCommand } from '../lib/commands/suggest.js';
 import { registerValidateCommand } from '../lib/commands/validate.js';
+import { registerFixCommand } from '../lib/commands/fix.js';
 import { registerHooksCommand } from '../lib/commands/hooks.js';
 import { registerFetchCommand } from '../lib/commands/fetch.js';
+import { registerSyncCommand } from '../lib/commands/sync.js';
+import { registerTeamCommand } from '../lib/commands/team.js';
+import { registerMemoryCommand } from '../lib/commands/memory.js';
+import { registerScaffoldCommand } from '../lib/commands/scaffold.js';
 
 const program = new Command();
 program.banner = banner;
@@ -21,19 +82,86 @@ program.banner = banner;
 program
   .name('ultra-dex')
   .description('CLI for Ultra-Dex SaaS Implementation Framework')
-  .version('2.1.0');
+  .version('3.2.0');
 
 registerInitCommand(program);
 registerAuditCommand(program);
 registerExamplesCommand(program);
 registerAgentsCommand(program);
-registerPlaceholderCommands(program);
+registerGenerateCommand(program);
+registerBuildCommand(program);
+registerReviewCommand(program);
+registerRunCommand(program);
+
+// v3.0 Commands
+program
+  .command('swarm <task>')
+  .description('Run autonomous agent pipeline')
+  .option('--dry-run', 'Show pipeline without executing')
+  .option('--parallel', 'Run implementation tier agents in parallel')
+  .action(swarmCommand);
+
+program
+  .command('watch')
+  .description('Auto-update state on file changes')
+  .option('--interval <ms>', 'Debounce interval in milliseconds', '500')
+  .action(watchCommand);
+
+program
+  .command('diff')
+  .description('Compare plan vs implemented code')
+  .option('--json', 'Output as JSON')
+  .action(diffCommand);
+
+program
+  .command('export')
+  .description('Export project context')
+  .option('--format <type>', 'Output format: json, html, markdown, pdf', 'json')
+  .option('--output <path>', 'Output file path')
+  .option('--include-agents', 'Bundle all agent prompts')
+  .action(exportCommand);
+
+program
+  .command('upgrade')
+  .description('Check for CLI updates')
+  .option('--check', 'Check only, do not show install instructions')
+  .option('--install', 'Automatically install latest version')
+  .action(upgradeCommand);
+
+program
+  .command('config')
+  .description('Show or generate configuration')
+  .option('--mcp', 'Generate MCP config for Claude Desktop')
+  .option('--cursor', 'Generate Cursor IDE rules')
+  .option('--vscode', 'Generate VS Code settings.json')
+  .option('--show', 'Display current Ultra-Dex config')
+  .option('--set <key=value>', 'Set a config value')
+  .option('--get <key>', 'Get a specific config value')
+  .action(configCommand);
+
+registerAutoImplementCommand(program);
+registerCiMonitorCommand(program);
+registerAlignCommand(program);
+registerStatusCommand(program);
+registerPreCommitCommand(program);
+registerStateCommand(program);
+registerDoctorCommand(program);
+registerDashboardCommand(program);
+registerCheckCommand(program);
 registerServeCommand(program);
+registerVerifyCommand(program);
 registerPackCommand(program);
 registerWorkflowCommand(program);
+registerPlanCommand(program);
 registerSuggestCommand(program);
 registerValidateCommand(program);
+registerFixCommand(program);
 registerHooksCommand(program);
 registerFetchCommand(program);
+registerSyncCommand(program);
+registerAgentBuilderCommand(program);
+registerTeamCommand(program);
+registerMemoryCommand(program);
+registerScaffoldCommand(program);
 
-program.parse();
+program.parse();