projecta-rrr 1.6.0 → 1.6.1

package/README.md

@@ -219,6 +219,63 @@ If you choose a non-default provider, RRR asks for a reason and records it in De
 
 These are allowed but require explicit justification: Firebase, Supabase, Auth0, Vercel, PlanetScale.
 
+### MCP Auto-Setup
+
+RRR includes an MCP registry that maps your selected providers to their MCP servers. After `/rrr:new-project` generates your `MVP_FEATURES.yml`:
+
+```bash
+npm run mcp:setup
+```
+
+This reads your feature selections and outputs the MCP configuration for Claude Code. Only MCPs you actually need get installed.
+
+| Feature | MCP Server |
+|---------|------------|
+| Database (Neon) | `@neondatabase/mcp-server-neon` |
+| Payments (Stripe) | `@stripe/mcp` |
+| Analytics (PostHog) | `@anthropic/mcp-posthog` |
+| Voice (Deepgram) | `@deepgram/mcp-server` |
+| Browser (Browserbase) | `@anthropic/mcp-browserbase` |
+| Sandbox (E2B) | `@e2b/mcp-server` |
+| Storage (R2) | `@cloudflare/mcp-server-r2` |
+
+**Always included:** Context7 (docs), GitHub, Filesystem, Sequential Thinking.
+
+### Pushpa Mode (Autopilot)
+
+Run phases overnight while you sleep. Pushpa Mode is an unattended runner that plans and executes phases sequentially, skipping any that require human verification.
+
+```bash
+bash scripts/pushpa-mode.sh
+# or
+npm run pushpa
+```
+
+**What it does:**
+1. Preflights required API keys based on your `MVP_FEATURES.yml`
+2. Iterates through phases in order
+3. Plans any phase that doesn't have a plan yet
+4. Executes phases automatically
+5. **Skips** phases marked with `HITL_REQUIRED: true` (human verification needed)
+6. Generates a morning report at `.planning/PUSHPA_REPORT.md`
+
+**Prerequisites:**
+- Run `/rrr:new-project` first (project must be initialized)
+- Set all required API keys (script will check and warn)
+- Recommend enabling YOLO mode in `.planning/config.json`
+
+**Where outputs live:**
+- Report: `.planning/PUSHPA_REPORT.md`
+- Logs: `.planning/logs/pushpa_*.log`
+
+**HITL Convention:**
+Plans that require human verification should include one of these markers:
+- `HITL_REQUIRED: true` (canonical)
+- `HUMAN_VERIFICATION_REQUIRED`
+- `MANUAL_VERIFICATION`
+
+Pushpa Mode will skip these phases and record them in the report for manual follow-up.
+
 ---
 
 ## How It Works

package/bin/install.js

@@ -301,7 +301,26 @@ function finishInstall(settingsPath, settings, statuslineCommand, notifyCommand,
   writeSettings(settingsPath, settings);
 
   console.log(`
-  ${green}Done!${reset} Launch Claude Code and run ${cyan}/rrr:help${reset}.
+  ${green}Done!${reset}
+
+  ${yellow}If you installed from inside Claude Code:${reset}
+  Type ${cyan}exit${reset} and restart ${cyan}claude${reset} so it reloads commands.
+
+  ${yellow}Pick your start command:${reset}
+
+  ${cyan}New/empty folder (greenfield)${reset}
+    /rrr:new-project
+    (bootstraps Next.js/TS baseline if folder is empty)
+
+  ${cyan}Existing repo (brownfield)${reset}
+    /rrr:new-project
+    (brownfield-safe; won't overwrite or restructure your repo)
+
+  ${cyan}RRR already initialized${reset}
+    /rrr:progress
+    (if .planning/STATE.md exists)
+
+  Run ${cyan}/rrr:help${reset} anytime to see all commands.
 `);
 }
 

package/commands/rrr/help.md

@@ -19,6 +19,20 @@ Output ONLY the reference content below. Do NOT add:
 
 **RRR** creates hierarchical project plans optimized for solo agentic development with Claude Code. Built by [Projecta.ai](https://projecta.ai).
 
+## Getting Started
+
+**After install/update:** If you installed from inside Claude Code, type `exit` and restart `claude` so it reloads commands.
+
+**Pick your start command:**
+
+| Scenario | Command |
+|----------|---------|
+| New/empty folder (greenfield) | `/rrr:new-project` — bootstraps Next.js/TS baseline if folder is empty |
+| Existing repo (brownfield) | `/rrr:new-project` — brownfield-safe; won't overwrite your repo |
+| RRR already initialized | `/rrr:progress` — if `.planning/STATE.md` exists |
+
+**MVP Definition of Done at Projecta:** local demo runs + tests pass.
+
 ## Quick Start
 
 1. `/rrr:new-project` - Initialize project (includes research, requirements, roadmap)
@@ -381,6 +395,27 @@ Change anytime by editing `.planning/config.json`
 
 That's it! `/rrr:new-project` handles everything from bootstrap to roadmap.
 
+**Overnight mode: Pushpa Mode**
+
+Run phases unattended while you sleep:
+
+```
+bash scripts/pushpa-mode.sh
+# or
+npm run pushpa
+```
+
+Prerequisites:
+1. Run `/rrr:new-project` first
+2. Set all required API keys (based on your MVP_FEATURES.yml)
+3. Recommend enabling YOLO mode in config.json
+
+Pushpa Mode will:
+- Plan and execute phases sequentially
+- Skip phases marked with `HITL_REQUIRED: true`
+- Generate report at `.planning/PUSHPA_REPORT.md`
+- Log everything to `.planning/logs/`
+
 **Bootstrap only (no planning):**
 
 ```

package/commands/rrr/new-project.md

@@ -350,15 +350,17 @@ Use AskUserQuestion:
 - header: "Preset"
 - question: "Start with a use-case preset? This pre-configures capabilities."
 - options:
+  - "saas-dashboard (Recommended)" — SaaS with Clerk + Neon + optional Stripe (DEFAULT)
   - "landing-waitlist" — Landing page + email capture (no auth, no db)
-  - "saas-dashboard" — SaaS with Clerk + Neon + optional Stripe
   - "api-admin" — API backend + admin panel (Neon, optional auth)
   - "voice-agent" — Voice AI agent (Deepgram + full agent stack)
-  - "None" — Configure capabilities manually (Recommended for custom)
+  - "Custom" — Configure capabilities manually
 
 **If preset selected:** Load preset defaults, skip to Step 3 (confirm/override).
 
-**If "None":** Continue to Step 2.
+**If "Custom":** Continue to Step 2.
+
+**DEFAULT BEHAVIOR:** If user selects nothing or skips, assume `saas-dashboard` preset (Neon + Clerk + Render + optional Stripe).
 
 ### Step 2: Capability Questionnaire
 
@@ -496,6 +498,10 @@ Deviations: [count or "None"]
 
 File: .planning/MVP_FEATURES.yml
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+💡 To configure MCP servers for your stack:
+   npm run mcp:setup
+   (Reads MVP_FEATURES.yml and installs required MCPs)
 ```
 
 Continue to Phase 3.
@@ -1272,6 +1278,16 @@ Present completion with next steps:
 
 <sub>`/clear` first → fresh context window</sub>
 
+───────────────────────────────────────────────────────────────
+
+## 🔌 MCP Setup (Optional)
+
+Configure Claude Code with MCP servers for your selected stack:
+
+`npm run mcp:setup`
+
+<sub>Reads MVP_FEATURES.yml and outputs MCP configuration</sub>
+
 ───────────────────────────────────────────────────────────────
 ```
 

package/mcp.registry.json

@@ -0,0 +1,128 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "description": "MCP server registry - maps providers to their Claude MCP installation commands",
+  "version": "1.0.0",
+
+  "servers": {
+    "neon": {
+      "name": "Neon MCP Server",
+      "description": "PostgreSQL database operations via Neon",
+      "command": "npx -y @neondatabase/mcp-server-neon",
+      "envRequired": ["NEON_API_KEY"],
+      "featureKeys": ["db:neon", "database"],
+      "docs": "https://neon.tech/docs/ai/mcp"
+    },
+
+    "stripe": {
+      "name": "Stripe MCP Server",
+      "description": "Payment processing and subscription management",
+      "command": "npx -y @stripe/mcp",
+      "envRequired": ["STRIPE_SECRET_KEY"],
+      "featureKeys": ["payments:stripe", "payments"],
+      "docs": "https://docs.stripe.com/mcp"
+    },
+
+    "posthog": {
+      "name": "PostHog MCP Server",
+      "description": "Product analytics and feature flags",
+      "command": "npx -y @anthropic/mcp-posthog",
+      "envRequired": ["POSTHOG_API_KEY", "POSTHOG_PROJECT_ID"],
+      "featureKeys": ["analytics:posthog", "analytics"],
+      "docs": "https://posthog.com/docs/mcp"
+    },
+
+    "deepgram": {
+      "name": "Deepgram MCP Server",
+      "description": "Voice-to-text and text-to-speech",
+      "command": "npx -y @deepgram/mcp-server",
+      "envRequired": ["DEEPGRAM_API_KEY"],
+      "featureKeys": ["voice:deepgram", "voice"],
+      "docs": "https://developers.deepgram.com/docs/mcp"
+    },
+
+    "browserbase": {
+      "name": "Browserbase MCP Server",
+      "description": "Headless browser automation",
+      "command": "npx -y @anthropic/mcp-browserbase",
+      "envRequired": ["BROWSERBASE_API_KEY", "BROWSERBASE_PROJECT_ID"],
+      "featureKeys": ["browserAutomation:browserbase", "browser"],
+      "docs": "https://docs.browserbase.com/mcp"
+    },
+
+    "e2b": {
+      "name": "E2B MCP Server",
+      "description": "Code execution sandbox",
+      "command": "npx -y @e2b/mcp-server",
+      "envRequired": ["E2B_API_KEY"],
+      "featureKeys": ["sandbox:e2b", "sandbox"],
+      "docs": "https://e2b.dev/docs/mcp"
+    },
+
+    "cloudflare-r2": {
+      "name": "Cloudflare R2 MCP Server",
+      "description": "S3-compatible object storage",
+      "command": "npx -y @cloudflare/mcp-server-r2",
+      "envRequired": ["CLOUDFLARE_ACCOUNT_ID", "R2_ACCESS_KEY_ID", "R2_SECRET_ACCESS_KEY"],
+      "featureKeys": ["objectStorage:r2", "storage"],
+      "docs": "https://developers.cloudflare.com/r2/mcp"
+    },
+
+    "context7": {
+      "name": "Context7 MCP Server",
+      "description": "Documentation lookup and library references",
+      "command": "npx -y @upstash/context7-mcp",
+      "envRequired": [],
+      "featureKeys": ["docs", "context"],
+      "docs": "https://context7.dev",
+      "alwaysInclude": true
+    },
+
+    "resend": {
+      "name": "Resend MCP Server",
+      "description": "Transactional email sending",
+      "command": "npx -y @resend/mcp-server",
+      "envRequired": ["RESEND_API_KEY"],
+      "featureKeys": ["email:resend", "email"],
+      "docs": "https://resend.com/docs/mcp"
+    },
+
+    "github": {
+      "name": "GitHub MCP Server",
+      "description": "GitHub repository operations",
+      "command": "npx -y @modelcontextprotocol/server-github",
+      "envRequired": ["GITHUB_PERSONAL_ACCESS_TOKEN"],
+      "featureKeys": ["github", "vcs"],
+      "docs": "https://modelcontextprotocol.io/docs/servers/github",
+      "alwaysInclude": true
+    },
+
+    "filesystem": {
+      "name": "Filesystem MCP Server",
+      "description": "Local filesystem operations",
+      "command": "npx -y @modelcontextprotocol/server-filesystem",
+      "envRequired": [],
+      "featureKeys": ["filesystem"],
+      "docs": "https://modelcontextprotocol.io/docs/servers/filesystem",
+      "alwaysInclude": true
+    },
+
+    "sequential-thinking": {
+      "name": "Sequential Thinking MCP Server",
+      "description": "Enhanced reasoning and chain-of-thought",
+      "command": "npx -y @modelcontextprotocol/server-sequential-thinking",
+      "envRequired": [],
+      "featureKeys": ["reasoning"],
+      "docs": "https://modelcontextprotocol.io/docs/servers/sequential-thinking",
+      "alwaysInclude": true
+    }
+  },
+
+  "presetMappings": {
+    "saas-dashboard": ["neon", "context7", "github", "filesystem", "sequential-thinking"],
+    "landing-waitlist": ["context7", "github", "filesystem", "sequential-thinking"],
+    "api-admin": ["neon", "context7", "github", "filesystem", "sequential-thinking"],
+    "voice-agent": ["neon", "deepgram", "e2b", "context7", "github", "filesystem", "sequential-thinking"]
+  },
+
+  "defaultServers": ["context7", "github", "filesystem", "sequential-thinking"]
+}

package/package.json

@@ -1,16 +1,23 @@
 {
   "name": "projecta-rrr",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "description": "A meta-prompting, context engineering and spec-driven development system for Claude Code by Projecta.ai",
   "bin": {
     "projecta-rrr": "bin/install.js"
   },
+  "scripts": {
+    "mcp:setup": "bash scripts/mcp-setup.sh",
+    "pushpa": "bash scripts/pushpa-mode.sh"
+  },
   "files": [
     "bin",
     "commands",
     "rrr",
     "agents",
-    "hooks"
+    "hooks",
+    "scripts",
+    "mcp.registry.json",
+    "projecta.defaults.json"
   ],
   "keywords": [
     "claude",

package/projecta.defaults.json

@@ -0,0 +1,32 @@
+{
+  "framework": "nextjs-app-router",
+  "language": "typescript",
+  "packageManager": "npm",
+  "ui": {
+    "styling": "tailwind",
+    "componentSystem": "shadcn-ui"
+  },
+  "testing": {
+    "unit": "vitest",
+    "e2e": "playwright"
+  },
+  "preferredProviders": {
+    "db": ["neon"],
+    "auth": ["clerk", "neon-auth"],
+    "authDefault": "clerk",
+    "deploy": ["render"],
+    "payments": ["stripe"],
+    "objectStorage": ["r2"],
+    "analytics": ["posthog"],
+    "voice": ["deepgram"],
+    "agents": ["mastra"],
+    "agentAuth": ["authdev"],
+    "agentMail": ["agentmail"],
+    "sandbox": ["e2b"],
+    "browserAutomation": ["browserbase"]
+  },
+  "discouragedProviders": {
+    "list": ["firebase", "supabase", "auth0", "vercel", "planetscale"],
+    "note": "These providers are discouraged but allowed with explicit reason recorded in Deviation Notes"
+  }
+}

package/rrr/presets/saas-dashboard.yml

@@ -1,7 +1,9 @@
-# SaaS Dashboard Preset
+# SaaS Dashboard Preset (DEFAULT)
 # Auth + database required, payments optional
+# This is the Projecta default preset - used when user skips selection
 
 name: saas-dashboard
+default: true
 description: SaaS application with authentication, database, and optional payments
 
 stack:
@@ -70,6 +72,10 @@ database:
     - users (synced from Clerk)
     - user_data (application-specific)
 
+# MCP servers auto-installed based on integrations
+mcp_servers:
+  - neon  # Required for database
+
 done_criteria:
   - User can sign up and sign in
   - Dashboard only accessible when authenticated

package/scripts/mcp-setup.sh

@@ -0,0 +1,224 @@
+#!/bin/bash
+#
+# MCP Setup Script for Projecta RRR
+# Reads MVP_FEATURES.yml and generates MCP server configuration
+#
+
+set -e
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+echo ""
+echo -e "${CYAN}╔══════════════════════════════════════════╗${NC}"
+echo -e "${CYAN}║    Projecta RRR - MCP Setup              ║${NC}"
+echo -e "${CYAN}╚══════════════════════════════════════════╝${NC}"
+echo ""
+
+# Find the RRR installation directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+RRR_DIR="$(dirname "$SCRIPT_DIR")"
+
+# Check if we're in a project with .planning
+PROJECT_DIR="$(pwd)"
+FEATURES_FILE="$PROJECT_DIR/.planning/MVP_FEATURES.yml"
+REGISTRY_FILE="$RRR_DIR/mcp.registry.json"
+
+# Verify registry exists
+if [ ! -f "$REGISTRY_FILE" ]; then
+    echo -e "${RED}Error: MCP registry not found at $REGISTRY_FILE${NC}"
+    exit 1
+fi
+
+# Determine which MCPs to include
+MCP_SERVERS=()
+
+# Always include default servers
+DEFAULT_SERVERS=$(cat "$REGISTRY_FILE" | grep -A1000 '"defaultServers"' | grep -o '"[^"]*"' | tr -d '"' | head -10)
+for server in $DEFAULT_SERVERS; do
+    if [ "$server" != "defaultServers" ] && [ "$server" != "[" ] && [ "$server" != "]" ]; then
+        MCP_SERVERS+=("$server")
+    fi
+done
+
+# Check if MVP_FEATURES.yml exists
+if [ -f "$FEATURES_FILE" ]; then
+    echo -e "${GREEN}Found MVP_FEATURES.yml${NC}"
+    echo ""
+
+    # Extract preset if specified
+    PRESET=$(grep "^preset:" "$FEATURES_FILE" 2>/dev/null | cut -d: -f2 | tr -d ' ' || echo "")
+
+    if [ -n "$PRESET" ]; then
+        echo -e "Preset: ${CYAN}$PRESET${NC}"
+
+        # Get servers for this preset from registry
+        PRESET_SERVERS=$(cat "$REGISTRY_FILE" | grep -A10 "\"$PRESET\":" | grep -o '"[^"]*"' | tr -d '"' | grep -v "$PRESET" | head -10)
+        for server in $PRESET_SERVERS; do
+            if [[ ! " ${MCP_SERVERS[*]} " =~ " ${server} " ]]; then
+                MCP_SERVERS+=("$server")
+            fi
+        done
+    fi
+
+    # Check for specific feature selections
+    # Database
+    if grep -q "db:" "$FEATURES_FILE" 2>/dev/null; then
+        DB=$(grep "db:" "$FEATURES_FILE" | cut -d: -f2 | tr -d ' ')
+        if [ "$DB" = "neon" ]; then
+            if [[ ! " ${MCP_SERVERS[*]} " =~ " neon " ]]; then
+                MCP_SERVERS+=("neon")
+            fi
+        fi
+    fi
+
+    # Payments
+    if grep -q "payments:" "$FEATURES_FILE" 2>/dev/null; then
+        PAYMENTS=$(grep "payments:" "$FEATURES_FILE" | cut -d: -f2 | tr -d ' ')
+        if [ "$PAYMENTS" = "stripe" ]; then
+            if [[ ! " ${MCP_SERVERS[*]} " =~ " stripe " ]]; then
+                MCP_SERVERS+=("stripe")
+            fi
+        fi
+    fi
+
+    # Voice
+    if grep -q "voice:" "$FEATURES_FILE" 2>/dev/null; then
+        VOICE=$(grep "voice:" "$FEATURES_FILE" | cut -d: -f2 | tr -d ' ')
+        if [ "$VOICE" = "deepgram" ]; then
+            if [[ ! " ${MCP_SERVERS[*]} " =~ " deepgram " ]]; then
+                MCP_SERVERS+=("deepgram")
+            fi
+        fi
+    fi
+
+    # Analytics
+    if grep -q "analytics:" "$FEATURES_FILE" 2>/dev/null; then
+        ANALYTICS=$(grep "analytics:" "$FEATURES_FILE" | cut -d: -f2 | tr -d ' ')
+        if [ "$ANALYTICS" = "posthog" ]; then
+            if [[ ! " ${MCP_SERVERS[*]} " =~ " posthog " ]]; then
+                MCP_SERVERS+=("posthog")
+            fi
+        fi
+    fi
+
+    # Browser automation
+    if grep -q "browserAutomation:" "$FEATURES_FILE" 2>/dev/null; then
+        BROWSER=$(grep "browserAutomation:" "$FEATURES_FILE" | cut -d: -f2 | tr -d ' ')
+        if [ "$BROWSER" = "browserbase" ]; then
+            if [[ ! " ${MCP_SERVERS[*]} " =~ " browserbase " ]]; then
+                MCP_SERVERS+=("browserbase")
+            fi
+        fi
+    fi
+
+    # Sandbox
+    if grep -q "sandbox:" "$FEATURES_FILE" 2>/dev/null; then
+        SANDBOX=$(grep "sandbox:" "$FEATURES_FILE" | cut -d: -f2 | tr -d ' ')
+        if [ "$SANDBOX" = "e2b" ]; then
+            if [[ ! " ${MCP_SERVERS[*]} " =~ " e2b " ]]; then
+                MCP_SERVERS+=("e2b")
+            fi
+        fi
+    fi
+
+    # Object storage
+    if grep -q "objectStorage:" "$FEATURES_FILE" 2>/dev/null; then
+        STORAGE=$(grep "objectStorage:" "$FEATURES_FILE" | cut -d: -f2 | tr -d ' ')
+        if [ "$STORAGE" = "r2" ]; then
+            if [[ ! " ${MCP_SERVERS[*]} " =~ " cloudflare-r2 " ]]; then
+                MCP_SERVERS+=("cloudflare-r2")
+            fi
+        fi
+    fi
+
+    # Email
+    if grep -q "email:" "$FEATURES_FILE" 2>/dev/null; then
+        EMAIL=$(grep "email:" "$FEATURES_FILE" | cut -d: -f2 | tr -d ' ')
+        if [ "$EMAIL" = "resend" ]; then
+            if [[ ! " ${MCP_SERVERS[*]} " =~ " resend " ]]; then
+                MCP_SERVERS+=("resend")
+            fi
+        fi
+    fi
+else
+    echo -e "${YELLOW}No MVP_FEATURES.yml found - using SaaS default preset${NC}"
+    echo ""
+    # Add neon for SaaS default
+    MCP_SERVERS+=("neon")
+fi
+
+echo ""
+echo -e "${GREEN}MCP Servers for your stack:${NC}"
+echo "─────────────────────────────"
+
+# Output the MCP configuration
+for server in "${MCP_SERVERS[@]}"; do
+    # Get server details from registry
+    SERVER_NAME=$(cat "$REGISTRY_FILE" | grep -A5 "\"$server\":" | grep '"name"' | cut -d'"' -f4)
+    SERVER_CMD=$(cat "$REGISTRY_FILE" | grep -A5 "\"$server\":" | grep '"command"' | cut -d'"' -f4)
+
+    if [ -n "$SERVER_CMD" ]; then
+        echo -e "  ${CYAN}$server${NC}: $SERVER_NAME"
+        echo -e "    Command: ${YELLOW}$SERVER_CMD${NC}"
+    fi
+done
+
+echo ""
+echo "─────────────────────────────"
+echo ""
+echo -e "${GREEN}To configure Claude Code with these MCPs:${NC}"
+echo ""
+echo "1. Open Claude Code settings:"
+echo -e "   ${CYAN}claude config${NC}"
+echo ""
+echo "2. Add MCP servers manually, or add to your ~/.claude/settings.json:"
+echo ""
+
+# Generate JSON snippet
+echo -e "${YELLOW}{"
+echo '  "mcpServers": {'
+
+FIRST=true
+for server in "${MCP_SERVERS[@]}"; do
+    SERVER_CMD=$(cat "$REGISTRY_FILE" | grep -A5 "\"$server\":" | grep '"command"' | cut -d'"' -f4)
+    if [ -n "$SERVER_CMD" ]; then
+        if [ "$FIRST" = true ]; then
+            FIRST=false
+        else
+            echo ","
+        fi
+        # Extract the package name from the npx command
+        PKG_NAME=$(echo "$SERVER_CMD" | sed 's/npx -y //')
+        echo -n "    \"$server\": {"
+        echo -n "\"command\": \"npx\", \"args\": [\"-y\", \"$PKG_NAME\"]"
+        echo -n "}"
+    fi
+done
+
+echo ""
+echo '  }'
+echo -e "}${NC}"
+echo ""
+
+# List required environment variables
+echo -e "${GREEN}Required environment variables:${NC}"
+echo "─────────────────────────────"
+
+for server in "${MCP_SERVERS[@]}"; do
+    ENV_VARS=$(cat "$REGISTRY_FILE" | grep -A10 "\"$server\":" | grep -A5 '"envRequired"' | grep -o '"[A-Z_]*"' | tr -d '"')
+    if [ -n "$ENV_VARS" ]; then
+        echo -e "  ${CYAN}$server${NC}:"
+        for var in $ENV_VARS; do
+            echo "    - $var"
+        done
+    fi
+done
+
+echo ""
+echo -e "${GREEN}Done!${NC} Add the environment variables to your .env file."
+echo ""

package/scripts/pushpa-mode.sh

@@ -0,0 +1,639 @@
+#!/bin/bash
+#
+# Pushpa Mode - Unattended Overnight Runner for RRR
+# Runs plan+execute phases sequentially, skipping HITL-marked phases
+#
+# Usage: bash scripts/pushpa-mode.sh
+#
+# Requirements:
+# - MVP_FEATURES.yml must exist (.planning/MVP_FEATURES.yml)
+# - Required API keys must be set based on your feature selections
+# - Claude Code must be installed and configured
+#
+
+set -euo pipefail
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Configuration
+# ═══════════════════════════════════════════════════════════════════════════════
+
+PLANNING_DIR=".planning"
+PHASES_DIR="$PLANNING_DIR/phases"
+LOGS_DIR="$PLANNING_DIR/logs"
+FEATURES_FILE="$PLANNING_DIR/MVP_FEATURES.yml"
+STATE_FILE="$PLANNING_DIR/STATE.md"
+ROADMAP_FILE="$PLANNING_DIR/ROADMAP.md"
+REPORT_FILE="$PLANNING_DIR/PUSHPA_REPORT.md"
+
+# HITL markers that indicate human verification required
+HITL_MARKERS=("HITL_REQUIRED: true" "HUMAN_VERIFICATION_REQUIRED" "MANUAL_VERIFICATION")
+
+# Polling configuration
+POLL_INTERVAL=10  # seconds between checks
+MAX_POLL_ATTEMPTS=360  # 1 hour max wait (360 * 10s)
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+BOLD='\033[1m'
+NC='\033[0m'
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Logging
+# ═══════════════════════════════════════════════════════════════════════════════
+
+LOG_FILE=""
+START_TIME=""
+
+setup_logging() {
+    mkdir -p "$LOGS_DIR"
+    START_TIME=$(date +%Y%m%d_%H%M%S)
+    LOG_FILE="$LOGS_DIR/pushpa_${START_TIME}.log"
+    touch "$LOG_FILE"
+}
+
+log() {
+    local level="$1"
+    local message="$2"
+    local timestamp=$(date '+%Y-%m-%d %H:%M:%S')
+    echo "[$timestamp] [$level] $message" >> "$LOG_FILE"
+
+    case "$level" in
+        INFO)  echo -e "${CYAN}[$level]${NC} $message" ;;
+        OK)    echo -e "${GREEN}[$level]${NC} $message" ;;
+        WARN)  echo -e "${YELLOW}[$level]${NC} $message" ;;
+        ERROR) echo -e "${RED}[$level]${NC} $message" ;;
+        SKIP)  echo -e "${YELLOW}[SKIP]${NC} $message" ;;
+        *)     echo "[$level] $message" ;;
+    esac
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Banner
+# ═══════════════════════════════════════════════════════════════════════════════
+
+print_banner() {
+    echo ""
+    echo -e "${BOLD}${CYAN}"
+    echo "╔═══════════════════════════════════════════════════════════════╗"
+    echo "║                                                               ║"
+    echo "║   ██████╗ ██╗   ██╗███████╗██╗  ██╗██████╗  █████╗            ║"
+    echo "║   ██╔══██╗██║   ██║██╔════╝██║  ██║██╔══██╗██╔══██╗           ║"
+    echo "║   ██████╔╝██║   ██║███████╗███████║██████╔╝███████║           ║"
+    echo "║   ██╔═══╝ ██║   ██║╚════██║██╔══██║██╔═══╝ ██╔══██║           ║"
+    echo "║   ██║     ╚██████╔╝███████║██║  ██║██║     ██║  ██║           ║"
+    echo "║   ╚═╝      ╚═════╝ ╚══════╝╚═╝  ╚═╝╚═╝     ╚═╝  ╚═╝           ║"
+    echo "║                                                               ║"
+    echo "║              RRR Overnight Autopilot Runner                   ║"
+    echo "║                                                               ║"
+    echo "╚═══════════════════════════════════════════════════════════════╝"
+    echo -e "${NC}"
+    echo ""
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Preflight Checks
+# ═══════════════════════════════════════════════════════════════════════════════
+
+check_claude_installed() {
+    if ! command -v claude &> /dev/null; then
+        log ERROR "Claude Code CLI not found. Install it first: https://claude.ai/code"
+        exit 1
+    fi
+    log OK "Claude Code CLI found"
+}
+
+check_mvp_features() {
+    if [ ! -f "$FEATURES_FILE" ]; then
+        echo ""
+        echo -e "${RED}═══════════════════════════════════════════════════════════════${NC}"
+        echo -e "${RED}  ERROR: MVP_FEATURES.yml not found${NC}"
+        echo -e "${RED}═══════════════════════════════════════════════════════════════${NC}"
+        echo ""
+        echo "Pushpa Mode requires a configured project with feature selections."
+        echo ""
+        echo "To get started:"
+        echo "  1. Run: /rrr:new-project"
+        echo "  2. Complete the questionnaire and capability selection"
+        echo "  3. Set required API keys (see below)"
+        echo "  4. Run: bash scripts/pushpa-mode.sh"
+        echo ""
+        exit 1
+    fi
+    log OK "MVP_FEATURES.yml found"
+}
+
+check_planning_exists() {
+    if [ ! -d "$PLANNING_DIR" ]; then
+        log WARN "No .planning directory found"
+        return 1
+    fi
+
+    if [ ! -f "$ROADMAP_FILE" ]; then
+        log WARN "No ROADMAP.md found"
+        return 1
+    fi
+
+    log OK "Planning directory and roadmap found"
+    return 0
+}
+
+# Check required environment variables based on MVP_FEATURES.yml
+check_env_vars() {
+    local missing_vars=()
+    local features_content=$(cat "$FEATURES_FILE" 2>/dev/null || echo "")
+
+    log INFO "Checking required environment variables..."
+
+    # Neon (database)
+    if echo "$features_content" | grep -q "db:.*neon\|db: neon"; then
+        [ -z "${NEON_API_KEY:-}" ] && missing_vars+=("NEON_API_KEY")
+        [ -z "${DATABASE_URL:-}" ] && missing_vars+=("DATABASE_URL")
+    fi
+
+    # Clerk (auth)
+    if echo "$features_content" | grep -q "auth:.*clerk\|auth: clerk"; then
+        [ -z "${CLERK_SECRET_KEY:-}" ] && missing_vars+=("CLERK_SECRET_KEY")
+        [ -z "${NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY:-}" ] && missing_vars+=("NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY")
+    fi
+
+    # Stripe (payments)
+    if echo "$features_content" | grep -q "payments:.*stripe\|payments: stripe"; then
+        [ -z "${STRIPE_SECRET_KEY:-}" ] && missing_vars+=("STRIPE_SECRET_KEY")
+        [ -z "${NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY:-}" ] && missing_vars+=("NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY (optional)")
+    fi
+
+    # Cloudflare R2 (storage)
+    if echo "$features_content" | grep -q "object_storage:.*r2\|objectStorage:.*r2"; then
+        [ -z "${CLOUDFLARE_ACCOUNT_ID:-}" ] && missing_vars+=("CLOUDFLARE_ACCOUNT_ID")
+        [ -z "${R2_ACCESS_KEY_ID:-}" ] && missing_vars+=("R2_ACCESS_KEY_ID")
+        [ -z "${R2_SECRET_ACCESS_KEY:-}" ] && missing_vars+=("R2_SECRET_ACCESS_KEY")
+    fi
+
+    # Deepgram (voice)
+    if echo "$features_content" | grep -q "voice:.*deepgram\|voice: deepgram"; then
+        [ -z "${DEEPGRAM_API_KEY:-}" ] && missing_vars+=("DEEPGRAM_API_KEY")
+    fi
+
+    # PostHog (analytics)
+    if echo "$features_content" | grep -q "analytics:.*posthog\|analytics: posthog"; then
+        [ -z "${NEXT_PUBLIC_POSTHOG_KEY:-}" ] && missing_vars+=("NEXT_PUBLIC_POSTHOG_KEY")
+        [ -z "${NEXT_PUBLIC_POSTHOG_HOST:-}" ] && missing_vars+=("NEXT_PUBLIC_POSTHOG_HOST")
+    fi
+
+    # E2B (sandbox)
+    if echo "$features_content" | grep -q "sandbox:.*e2b\|sandbox: e2b"; then
+        [ -z "${E2B_API_KEY:-}" ] && missing_vars+=("E2B_API_KEY")
+    fi
+
+    # Browserbase
+    if echo "$features_content" | grep -q "browser.*browserbase\|browserbase"; then
+        [ -z "${BROWSERBASE_API_KEY:-}" ] && missing_vars+=("BROWSERBASE_API_KEY")
+        [ -z "${BROWSERBASE_PROJECT_ID:-}" ] && missing_vars+=("BROWSERBASE_PROJECT_ID")
+    fi
+
+    if [ ${#missing_vars[@]} -gt 0 ]; then
+        echo ""
+        echo -e "${YELLOW}═══════════════════════════════════════════════════════════════${NC}"
+        echo -e "${YELLOW}  WARNING: Missing environment variables${NC}"
+        echo -e "${YELLOW}═══════════════════════════════════════════════════════════════${NC}"
+        echo ""
+        echo "Based on your MVP_FEATURES.yml, these variables should be set:"
+        echo ""
+        for var in "${missing_vars[@]}"; do
+            echo -e "  ${RED}✗${NC} $var"
+        done
+        echo ""
+        echo "Set them in your environment or .env file before running Pushpa Mode."
+        echo ""
+        echo "Example:"
+        echo "  export NEON_API_KEY=your_key_here"
+        echo "  # or"
+        echo "  source .env"
+        echo ""
+
+        read -p "Continue anyway? (y/N) " -n 1 -r
+        echo
+        if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+            log ERROR "Aborted due to missing environment variables"
+            exit 1
+        fi
+        log WARN "Continuing with missing environment variables (user override)"
+    else
+        log OK "All required environment variables are set"
+    fi
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Phase Discovery
+# ═══════════════════════════════════════════════════════════════════════════════
+
+# Get list of phases from ROADMAP.md
+get_phases() {
+    if [ ! -f "$ROADMAP_FILE" ]; then
+        echo ""
+        return
+    fi
+
+    # Extract phase numbers from ROADMAP.md
+    # Looks for patterns like "## Phase 1:" or "### Phase 1:" or "| 1 |"
+    grep -oE "Phase [0-9]+(\.[0-9]+)?" "$ROADMAP_FILE" 2>/dev/null | \
+        grep -oE "[0-9]+(\.[0-9]+)?" | \
+        sort -t. -k1,1n -k2,2n | \
+        uniq
+}
+
+# Check if phase has a plan
+phase_has_plan() {
+    local phase="$1"
+    local phase_padded=$(printf "%02d" "${phase%%.*}")
+
+    # Look for plan files in the phase directory
+    local plan_files=$(find "$PHASES_DIR" -path "*/${phase_padded}*/*-PLAN.md" -type f 2>/dev/null | head -1)
+
+    if [ -n "$plan_files" ]; then
+        return 0
+    fi
+    return 1
+}
+
+# Get plan files for a phase
+get_phase_plans() {
+    local phase="$1"
+    local phase_padded=$(printf "%02d" "${phase%%.*}")
+
+    find "$PHASES_DIR" -path "*/${phase_padded}*/*-PLAN.md" -type f 2>/dev/null | sort
+}
+
+# Check if phase plan contains HITL marker
+phase_requires_hitl() {
+    local phase="$1"
+    local plan_files=$(get_phase_plans "$phase")
+
+    if [ -z "$plan_files" ]; then
+        return 1  # No plan, no HITL
+    fi
+
+    for plan_file in $plan_files; do
+        for marker in "${HITL_MARKERS[@]}"; do
+            if grep -q "$marker" "$plan_file" 2>/dev/null; then
+                log INFO "Found HITL marker '$marker' in $plan_file"
+                return 0
+            fi
+        done
+    done
+
+    return 1
+}
+
+# Check if milestone is complete
+is_milestone_complete() {
+    local completion_markers=("MVP COMPLETE" "MILESTONE COMPLETE" "ALL PHASES COMPLETE" "100%")
+
+    for marker in "${completion_markers[@]}"; do
+        if grep -qi "$marker" "$STATE_FILE" 2>/dev/null; then
+            return 0
+        fi
+        if grep -qi "$marker" "$ROADMAP_FILE" 2>/dev/null; then
+            return 0
+        fi
+    done
+
+    return 1
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Execution
+# ═══════════════════════════════════════════════════════════════════════════════
+
+# Run a Claude Code command
+run_claude_command() {
+    local command="$1"
+    local description="$2"
+
+    log INFO "Running: $command"
+    log INFO "Description: $description"
+
+    # Run claude with the command, capturing output
+    local output_file="$LOGS_DIR/claude_${START_TIME}_$(date +%s).log"
+
+    if claude -p "$command" >> "$output_file" 2>&1; then
+        log OK "Command completed successfully"
+        return 0
+    else
+        log ERROR "Command failed. Check $output_file for details"
+        return 1
+    fi
+}
+
+# Wait for plan files to appear
+wait_for_plan() {
+    local phase="$1"
+    local attempts=0
+
+    log INFO "Waiting for plan files for Phase $phase..."
+
+    while [ $attempts -lt $MAX_POLL_ATTEMPTS ]; do
+        if phase_has_plan "$phase"; then
+            log OK "Plan files found for Phase $phase"
+            return 0
+        fi
+
+        sleep $POLL_INTERVAL
+        ((attempts++))
+
+        if [ $((attempts % 6)) -eq 0 ]; then
+            log INFO "Still waiting for plan files... (${attempts}/${MAX_POLL_ATTEMPTS})"
+        fi
+    done
+
+    log ERROR "Timeout waiting for plan files for Phase $phase"
+    return 1
+}
+
+# Plan a phase
+plan_phase() {
+    local phase="$1"
+
+    log INFO "Planning Phase $phase..."
+
+    if ! run_claude_command "/rrr:plan-phase $phase" "Create plan for Phase $phase"; then
+        log ERROR "Failed to plan Phase $phase"
+        return 1
+    fi
+
+    # Wait for plan files to appear
+    if ! wait_for_plan "$phase"; then
+        return 1
+    fi
+
+    return 0
+}
+
+# Execute a phase
+execute_phase() {
+    local phase="$1"
+
+    log INFO "Executing Phase $phase..."
+
+    if ! run_claude_command "/rrr:execute-phase $phase" "Execute Phase $phase"; then
+        log ERROR "Failed to execute Phase $phase"
+        return 1
+    fi
+
+    log OK "Phase $phase execution complete"
+    return 0
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Report Generation
+# ═══════════════════════════════════════════════════════════════════════════════
+
+# Phase tracking arrays
+declare -a PLANNED_PHASES=()
+declare -a EXECUTED_PHASES=()
+declare -a SKIPPED_PHASES=()
+declare -a FAILED_PHASES=()
+
+init_report() {
+    cat > "$REPORT_FILE" << EOF
+# Pushpa Mode Report
+
+**Started:** $(date '+%Y-%m-%d %H:%M:%S')
+**Log File:** $LOG_FILE
+
+---
+
+## Summary
+
+| Metric | Count |
+|--------|-------|
+| Phases Planned | — |
+| Phases Executed | — |
+| Phases Skipped (HITL) | — |
+| Phases Failed | — |
+
+---
+
+## Phase Details
+
+EOF
+}
+
+update_report() {
+    local end_time=$(date '+%Y-%m-%d %H:%M:%S')
+
+    cat > "$REPORT_FILE" << EOF
+# Pushpa Mode Report
+
+**Started:** $(date -d "@$(($(date +%s) - SECONDS))" '+%Y-%m-%d %H:%M:%S' 2>/dev/null || echo "$(date '+%Y-%m-%d %H:%M:%S')")
+**Completed:** $end_time
+**Duration:** $((SECONDS / 60)) minutes
+**Log File:** $LOG_FILE
+
+---
+
+## Summary
+
+| Metric | Count |
+|--------|-------|
+| Phases Planned | ${#PLANNED_PHASES[@]} |
+| Phases Executed | ${#EXECUTED_PHASES[@]} |
+| Phases Skipped (HITL) | ${#SKIPPED_PHASES[@]} |
+| Phases Failed | ${#FAILED_PHASES[@]} |
+
+---
+
+## Phase Details
+
+EOF
+
+    if [ ${#EXECUTED_PHASES[@]} -gt 0 ]; then
+        echo "### Executed" >> "$REPORT_FILE"
+        for phase in "${EXECUTED_PHASES[@]}"; do
+            echo "- Phase $phase ✓" >> "$REPORT_FILE"
+        done
+        echo "" >> "$REPORT_FILE"
+    fi
+
+    if [ ${#SKIPPED_PHASES[@]} -gt 0 ]; then
+        echo "### Skipped (HITL Required)" >> "$REPORT_FILE"
+        echo "" >> "$REPORT_FILE"
+        echo "These phases require human verification and were skipped:" >> "$REPORT_FILE"
+        echo "" >> "$REPORT_FILE"
+        for phase in "${SKIPPED_PHASES[@]}"; do
+            echo "- Phase $phase — **HITL_REQUIRED**" >> "$REPORT_FILE"
+        done
+        echo "" >> "$REPORT_FILE"
+        echo "> Run these phases manually with \`/rrr:execute-phase N\` after verification." >> "$REPORT_FILE"
+        echo "" >> "$REPORT_FILE"
+    fi
+
+    if [ ${#FAILED_PHASES[@]} -gt 0 ]; then
+        echo "### Failed" >> "$REPORT_FILE"
+        echo "" >> "$REPORT_FILE"
+        echo "These phases encountered errors:" >> "$REPORT_FILE"
+        echo "" >> "$REPORT_FILE"
+        for phase in "${FAILED_PHASES[@]}"; do
+            echo "- Phase $phase ✗" >> "$REPORT_FILE"
+        done
+        echo "" >> "$REPORT_FILE"
+        echo "> Check logs at \`$LOGS_DIR/\` for details." >> "$REPORT_FILE"
+        echo "" >> "$REPORT_FILE"
+    fi
+
+    echo "---" >> "$REPORT_FILE"
+    echo "" >> "$REPORT_FILE"
+    echo "*Generated by Pushpa Mode*" >> "$REPORT_FILE"
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Main
+# ═══════════════════════════════════════════════════════════════════════════════
+
+main() {
+    print_banner
+    setup_logging
+
+    log INFO "Pushpa Mode starting..."
+    log INFO "Working directory: $(pwd)"
+
+    # Preflight checks
+    echo -e "${BOLD}Preflight Checks${NC}"
+    echo "─────────────────────────────────────────"
+
+    check_claude_installed
+    check_mvp_features
+    check_env_vars
+
+    # Check if planning exists, run new-project if not
+    if ! check_planning_exists; then
+        log WARN "Planning not initialized. Running /rrr:new-project..."
+        echo ""
+        echo -e "${YELLOW}Planning not found. Please run /rrr:new-project first.${NC}"
+        echo ""
+        echo "Pushpa Mode requires:"
+        echo "  1. .planning/ROADMAP.md (phases defined)"
+        echo "  2. .planning/MVP_FEATURES.yml (feature selections)"
+        echo ""
+        echo "Run /rrr:new-project interactively to set up your project,"
+        echo "then run Pushpa Mode again."
+        exit 1
+    fi
+
+    echo ""
+    echo -e "${GREEN}All preflight checks passed!${NC}"
+    echo ""
+
+    # Check if already complete
+    if is_milestone_complete; then
+        log OK "Milestone is already complete!"
+        echo -e "${GREEN}Milestone is already complete. Nothing to do.${NC}"
+        exit 0
+    fi
+
+    # Get phases
+    local phases=$(get_phases)
+
+    if [ -z "$phases" ]; then
+        log ERROR "No phases found in ROADMAP.md"
+        exit 1
+    fi
+
+    log INFO "Found phases: $(echo $phases | tr '\n' ' ')"
+
+    # Initialize report
+    init_report
+
+    echo -e "${BOLD}Starting Execution${NC}"
+    echo "─────────────────────────────────────────"
+    echo ""
+
+    # Process each phase
+    for phase in $phases; do
+        echo ""
+        echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        echo -e "${CYAN}  Phase $phase${NC}"
+        echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+
+        # Check if plan exists
+        if ! phase_has_plan "$phase"; then
+            log INFO "No plan found for Phase $phase, creating..."
+
+            if plan_phase "$phase"; then
+                PLANNED_PHASES+=("$phase")
+            else
+                log ERROR "Failed to create plan for Phase $phase"
+                FAILED_PHASES+=("$phase")
+                continue
+            fi
+        else
+            log OK "Plan already exists for Phase $phase"
+        fi
+
+        # Check for HITL marker
+        if phase_requires_hitl "$phase"; then
+            log SKIP "Phase $phase requires human verification (HITL_REQUIRED)"
+            echo -e "${YELLOW}  ⚠ Skipping - Human verification required${NC}"
+            SKIPPED_PHASES+=("$phase")
+            continue
+        fi
+
+        # Execute phase
+        if execute_phase "$phase"; then
+            EXECUTED_PHASES+=("$phase")
+            echo -e "${GREEN}  ✓ Phase $phase complete${NC}"
+        else
+            FAILED_PHASES+=("$phase")
+            echo -e "${RED}  ✗ Phase $phase failed${NC}"
+        fi
+
+        # Check if milestone became complete
+        if is_milestone_complete; then
+            log OK "Milestone complete!"
+            break
+        fi
+    done
+
+    # Generate final report
+    update_report
+
+    echo ""
+    echo -e "${BOLD}═══════════════════════════════════════════════════════════════${NC}"
+    echo -e "${BOLD}  Pushpa Mode Complete${NC}"
+    echo -e "${BOLD}═══════════════════════════════════════════════════════════════${NC}"
+    echo ""
+    echo "Results:"
+    echo "  Planned:  ${#PLANNED_PHASES[@]} phases"
+    echo "  Executed: ${#EXECUTED_PHASES[@]} phases"
+    echo "  Skipped:  ${#SKIPPED_PHASES[@]} phases (HITL required)"
+    echo "  Failed:   ${#FAILED_PHASES[@]} phases"
+    echo ""
+    echo "Report: $REPORT_FILE"
+    echo "Logs:   $LOG_FILE"
+    echo ""
+
+    if [ ${#SKIPPED_PHASES[@]} -gt 0 ]; then
+        echo -e "${YELLOW}HITL phases to complete manually:${NC}"
+        for phase in "${SKIPPED_PHASES[@]}"; do
+            echo "  /rrr:execute-phase $phase"
+        done
+        echo ""
+    fi
+
+    if [ ${#FAILED_PHASES[@]} -gt 0 ]; then
+        echo -e "${RED}Failed phases to investigate:${NC}"
+        for phase in "${FAILED_PHASES[@]}"; do
+            echo "  Phase $phase"
+        done
+        echo ""
+        exit 1
+    fi
+
+    log OK "Pushpa Mode finished successfully"
+}
+
+# Run main
+main "$@"