ultra-dex 2.2.1 → 3.1.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 v2.2+ (God Mode)
 
 ```bash
-# 🚀 Generate a complete 34-section plan with AI
-npx ultra-dex generate "A task management SaaS for remote teams"
+# 🤖 Autonomous feature implementation (Plan -> Code -> Verify)
+npx ultra-dex auto-implement "Add Stripe checkout"
 
-# 🔧 Start AI-assisted development
-npx ultra-dex build --agent planner
+# 🔄 Real-time State & Graph Synchronization
+npx ultra-dex sync --push --target ./s3-bucket
 
-# 🔍 Review code against plan
-npx ultra-dex review
+# 🛡️ Self-Healing CI/CD Monitor
+npx ultra-dex ci-monitor --port 3003
 
-# 📊 Quick alignment check
-npx ultra-dex align
+# 🧠 Structural Graph Health Check
+npx ultra-dex check
+
+# 🖥️ Live Dashboard with Brain Visualization
+npx ultra-dex dashboard
 ```
 
 ## First 10 Minutes
@@ -40,164 +43,134 @@ npm install -g ultra-dex
 ultra-dex generate "Your idea"
 ```
 
-## AI Commands (v2.0+)
+## AI Commands (God Mode)
 
-### `generate` - AI Plan Generation
+### `auto-implement` - Autonomous Engineer
 
-Generate a complete implementation plan using AI:
+Fully autonomous feature implementation loop:
 
 ```bash
-# Basic usage
-npx ultra-dex generate "A booking platform for dog groomers"
+# Implement a feature from scratch
+npx ultra-dex auto-implement "Create a user profile page with Avatar upload"
 
-# With options
-npx ultra-dex generate "idea" --provider openai --output ./my-project
-
-# Preview without calling AI
-npx ultra-dex generate "idea" --dry-run
+# Preview the plan without coding
+npx ultra-dex auto-implement "Migrate to Tailwind" --dry-run
 ```
 
-**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 |
+**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.
 
-### `build` - AI-Assisted Development
+### `sync` - State Synchronization
 
-Start development with AI agents:
+Keep your project's "Brain" (Context + Graph) in sync across devices:
 
 ```bash
-# Interactive agent selection
-npx ultra-dex build
+# Push state to a shared location
+npx ultra-dex sync --push --target ./shared-drive
 
-# Specific agent
-npx ultra-dex build --agent backend --task "Create user API endpoints"
-
-# Copy to clipboard for external AI
-npx ultra-dex build --agent planner --copy
+# Pull state from a shared location
+npx ultra-dex sync --pull --target ./shared-drive
 ```
 
-**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 |
+### `ci-monitor` - Self-Healing CI/CD
 
-### `review` - Code Review
-
-Check code alignment with plan:
+Listen for build failures and automatically fix them:
 
 ```bash
-npx ultra-dex review
-npx ultra-dex review --dir ./src
+npx ultra-dex ci-monitor --port 3003
 ```
+*Configure your CI provider (GitHub Actions) to send webhooks to this port.*
 
-### `align` - Quick Score
+### `watch` - Real-time Daemon
 
-Get alignment score instantly:
+Keep the Code Property Graph updated as you code:
 
 ```bash
-npx ultra-dex align
-npx ultra-dex align --json  # Machine-readable output
+npx ultra-dex watch
 ```
 
-**Environment Variables:**
-```bash
-ANTHROPIC_API_KEY=sk-ant-...  # Claude (recommended)
-OPENAI_API_KEY=sk-...         # OpenAI
-GOOGLE_AI_KEY=...             # Gemini
-```
+## Core Commands
 
-### `init`
+### `generate` - AI Plan Generation
 
-Interactive project setup:
+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 build --agent 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=router # Use "router" for hybrid local/cloud intelligence
 ```
 
-### Other Commands
+## All Commands
 
 | Command | Description |
 |---------|-------------|
+| `generate` | Generate full SaaS plan from idea |
+| `auto-implement` | **(NEW)** Autonomously implement a feature |
+| `build` | Interactive AI agent development loop |
+| `review` | Review code against plan (Graph-Aware) |
+| `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 |
-| `init --preview` | Preview files without creating them |
-| `init --live` | Generate a runnable scaffold |
 | `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 |
+| `team` | Team collaboration (local) |
 | `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 |
+| `serve` | Serve context (MCP-compatible) |
 
 ## Example: AI Generation
 
@@ -210,21 +183,10 @@ $ npx ultra-dex generate "A booking platform for dog groomers"
 
 📝 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)
+   Tokens used: 42,350 tokens
    Actual cost: $0.52
 
 📦 Project: GroomBook
@@ -232,13 +194,7 @@ $ npx ultra-dex generate "A booking platform for dog groomers"
 ✓ 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
+✓ Created .ultra/state.json (GOD MODE ACTIVE)
 ```
 
 ## Links

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/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

@@ -7,13 +7,38 @@ 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';
 
 const program = new Command();
 program.banner = banner;
@@ -21,19 +46,85 @@ program.banner = banner;
 program
   .name('ultra-dex')
   .description('CLI for Ultra-Dex SaaS Implementation Framework')
-  .version('2.1.0');
+  .version('3.1.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);
 
-program.parse();
+program.parse();