autoworkflow 3.0.1 → 3.1.0

package/.claude/hooks/audit-runner.sh

@@ -0,0 +1,191 @@
+#!/bin/bash
+# AutoWorkflow Audit Runner
+# Purpose: Run all audit checks and track results
+#
+# This hook implements audit_loop from system/loops.md
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+BOLD='\033[1m'
+DIM='\033[2m'
+NC='\033[0m'
+
+# State directory
+STATE_DIR=".claude/.autoworkflow"
+mkdir -p "$STATE_DIR"
+
+# Configuration
+MAX_ITERATIONS=5
+AUDIT_ITERATION_FILE="$STATE_DIR/audit-iteration"
+AUDIT_STATUS_FILE="$STATE_DIR/audit-status"
+
+# Get current iteration
+get_iteration() {
+    if [ -f "$AUDIT_ITERATION_FILE" ]; then
+        cat "$AUDIT_ITERATION_FILE"
+    else
+        echo "0"
+    fi
+}
+
+# Increment iteration
+increment_iteration() {
+    local current=$(get_iteration)
+    local next=$((current + 1))
+    echo "$next" > "$AUDIT_ITERATION_FILE"
+    echo "$next"
+}
+
+# Reset iteration
+reset_iteration() {
+    echo "0" > "$AUDIT_ITERATION_FILE"
+}
+
+# Print header
+print_header() {
+    local iteration=$(get_iteration)
+    echo ""
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo -e "${BOLD}AUTOWORKFLOW: AUDIT LOOP${NC} ${DIM}(Iteration $iteration/$MAX_ITERATIONS)${NC}"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+}
+
+# Run UI enforcement check
+run_ui_check() {
+    echo -e "${CYAN}[1/2]${NC} UI Enforcement Check"
+
+    if [ -f "package.json" ] && grep -q '"audit:ui"' package.json 2>/dev/null; then
+        echo -e "      Command: npm run audit:ui"
+        echo ""
+
+        local output=$(npm run audit:ui 2>&1)
+        local exit_code=$?
+
+        if [ $exit_code -eq 0 ] && ! echo "$output" | grep -qi "orphan\|missing\|error"; then
+            echo -e "      Result: ${GREEN}✅ PASSED${NC}"
+            echo ""
+            return 0
+        else
+            echo -e "      Result: ${RED}⛔ FAILED${NC}"
+            echo ""
+            echo "      Orphan features detected:"
+            echo "$output" | grep -iE "orphan|missing|error" | while read -r line; do
+                echo "        → $line"
+            done
+            echo ""
+            return 1
+        fi
+    else
+        echo -e "      ${YELLOW}⚠${NC} No audit:ui script found - skipping"
+        echo ""
+        return 0
+    fi
+}
+
+# Run circular dependency check
+run_cycle_check() {
+    echo -e "${CYAN}[2/2]${NC} Circular Dependencies Check"
+
+    if [ -f "package.json" ] && grep -q '"audit:cycles"' package.json 2>/dev/null; then
+        echo -e "      Command: npm run audit:cycles"
+        echo ""
+
+        local output=$(npm run audit:cycles 2>&1)
+        local exit_code=$?
+
+        if [ $exit_code -eq 0 ] && ! echo "$output" | grep -qi "circular\|cycle"; then
+            echo -e "      Result: ${GREEN}✅ PASSED${NC}"
+            echo ""
+            return 0
+        else
+            echo -e "      Result: ${RED}⛔ FAILED${NC}"
+            echo ""
+            echo "      Circular dependencies found:"
+            echo "$output" | grep -iE "circular|cycle" | while read -r line; do
+                echo "        → $line"
+            done
+            echo ""
+            return 1
+        fi
+    else
+        echo -e "      ${YELLOW}⚠${NC} No audit:cycles script found - skipping"
+        echo ""
+        return 0
+    fi
+}
+
+# Main execution
+main() {
+    local iteration=$(increment_iteration)
+
+    # Check max iterations
+    if [ "$iteration" -gt "$MAX_ITERATIONS" ]; then
+        echo ""
+        echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+        echo -e "${RED}${BOLD}⛔ MAX AUDIT ITERATIONS REACHED${NC}"
+        echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+        echo ""
+        echo "Audit has failed $MAX_ITERATIONS times."
+        echo "Manual intervention required."
+        echo ""
+        echo "BLOCKED" > "$AUDIT_STATUS_FILE"
+        exit 1
+    fi
+
+    print_header
+
+    local ui_pass=true
+    local cycle_pass=true
+
+    # Run checks
+    if ! run_ui_check; then
+        ui_pass=false
+    fi
+
+    if ! run_cycle_check; then
+        cycle_pass=false
+    fi
+
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+    if [ "$ui_pass" = true ] && [ "$cycle_pass" = true ]; then
+        echo -e "${GREEN}${BOLD}✅ ALL AUDITS PASSED${NC}"
+        echo ""
+        echo "Ready to proceed to COMMIT."
+        echo ""
+
+        reset_iteration
+        echo "PASSED" > "$AUDIT_STATUS_FILE"
+
+        # Update phase
+        echo "PRE_COMMIT" > "$STATE_DIR/phase"
+
+        exit 0
+    else
+        echo -e "${RED}${BOLD}⛔ AUDIT FAILED${NC} ${DIM}(Iteration $iteration/$MAX_ITERATIONS)${NC}"
+        echo ""
+
+        if [ "$ui_pass" = false ]; then
+            echo "  ☐ Fix orphan features (add missing UI)"
+        fi
+
+        if [ "$cycle_pass" = false ]; then
+            echo "  ☐ Resolve circular dependencies"
+        fi
+
+        echo ""
+        echo "Fix the issues above and run audit again."
+        echo -e "${DIM}Remaining attempts: $((MAX_ITERATIONS - iteration))${NC}"
+        echo ""
+
+        echo "FAILED" > "$AUDIT_STATUS_FILE"
+
+        exit 1
+    fi
+}
+
+main

package/.claude/hooks/blueprint-generator.sh

@@ -0,0 +1,253 @@
+#!/bin/bash
+# AutoWorkflow Blueprint Generator
+# Purpose: Auto-scan project and generate BLUEPRINT.md
+#
+# This hook implements on:blueprint_missing trigger from system/triggers.md
+# It runs AUTOMATICALLY without asking permission to start
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+BOLD='\033[1m'
+DIM='\033[2m'
+NC='\033[0m'
+
+# State directory
+STATE_DIR=".claude/.autoworkflow"
+mkdir -p "$STATE_DIR"
+
+# Output file
+SCAN_OUTPUT="$STATE_DIR/project-scan.txt"
+
+print_header() {
+    echo ""
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo -e "${BOLD}AUTOWORKFLOW: PROJECT AUDIT${NC}"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+    echo "Scanning project to generate BLUEPRINT.md..."
+    echo ""
+}
+
+# Detect tech stack from package.json
+detect_tech_stack() {
+    echo -e "${CYAN}[1/6]${NC} Detecting tech stack..."
+
+    if [ -f "package.json" ]; then
+        echo "  Found: package.json"
+
+        # Detect framework
+        if grep -q '"next"' package.json 2>/dev/null; then
+            echo "  Framework: Next.js"
+        elif grep -q '"react"' package.json 2>/dev/null; then
+            echo "  Framework: React"
+        elif grep -q '"vue"' package.json 2>/dev/null; then
+            echo "  Framework: Vue"
+        elif grep -q '"svelte"' package.json 2>/dev/null; then
+            echo "  Framework: Svelte"
+        elif grep -q '"express"' package.json 2>/dev/null; then
+            echo "  Framework: Express"
+        fi
+
+        # Detect styling
+        if grep -q '"tailwindcss"' package.json 2>/dev/null; then
+            echo "  Styling: Tailwind CSS"
+        elif grep -q '"styled-components"' package.json 2>/dev/null; then
+            echo "  Styling: styled-components"
+        elif grep -q '"@emotion"' package.json 2>/dev/null; then
+            echo "  Styling: Emotion"
+        fi
+
+        # Detect database
+        if grep -q '"prisma"' package.json 2>/dev/null; then
+            echo "  Database: Prisma"
+        elif grep -q '"mongoose"' package.json 2>/dev/null; then
+            echo "  Database: MongoDB (Mongoose)"
+        elif grep -q '"pg"' package.json 2>/dev/null; then
+            echo "  Database: PostgreSQL"
+        fi
+
+        # Detect TypeScript
+        if grep -q '"typescript"' package.json 2>/dev/null; then
+            echo "  Language: TypeScript"
+        fi
+
+        echo ""
+    else
+        echo "  No package.json found"
+        echo ""
+    fi
+}
+
+# Scan project structure
+scan_structure() {
+    echo -e "${CYAN}[2/6]${NC} Scanning project structure..."
+
+    # Find source directory
+    if [ -d "src" ]; then
+        echo "  Source: src/"
+        ls -1 src/ 2>/dev/null | head -10 | while read -r item; do
+            echo "    - $item"
+        done
+    elif [ -d "app" ]; then
+        echo "  Source: app/"
+        ls -1 app/ 2>/dev/null | head -10 | while read -r item; do
+            echo "    - $item"
+        done
+    fi
+
+    echo ""
+}
+
+# Scan for routes/pages
+scan_routes() {
+    echo -e "${CYAN}[3/6]${NC} Scanning routes..."
+
+    local found=false
+
+    # Next.js app router
+    if [ -d "src/app" ] || [ -d "app" ]; then
+        local app_dir="app"
+        [ -d "src/app" ] && app_dir="src/app"
+
+        echo "  Next.js App Router detected"
+        find "$app_dir" -name "page.tsx" -o -name "page.js" 2>/dev/null | head -20 | while read -r page; do
+            local route=$(dirname "$page" | sed "s|$app_dir||" | sed 's|^/||')
+            [ -z "$route" ] && route="/"
+            echo "    → /$route"
+        done
+        found=true
+    fi
+
+    # Next.js pages router
+    if [ -d "src/pages" ] || [ -d "pages" ]; then
+        local pages_dir="pages"
+        [ -d "src/pages" ] && pages_dir="src/pages"
+
+        echo "  Next.js Pages Router detected"
+        find "$pages_dir" -name "*.tsx" -o -name "*.js" 2>/dev/null | grep -v "_app\|_document\|api" | head -20 | while read -r page; do
+            local route=$(echo "$page" | sed "s|$pages_dir||" | sed 's|\.tsx$||' | sed 's|\.js$||' | sed 's|/index$||')
+            [ -z "$route" ] && route="/"
+            echo "    → $route"
+        done
+        found=true
+    fi
+
+    if [ "$found" = false ]; then
+        echo "  No standard route structure detected"
+    fi
+
+    echo ""
+}
+
+# Scan for components
+scan_components() {
+    echo -e "${CYAN}[4/6]${NC} Scanning components..."
+
+    local comp_dir=""
+    [ -d "src/components" ] && comp_dir="src/components"
+    [ -d "components" ] && comp_dir="components"
+
+    if [ -n "$comp_dir" ]; then
+        local count=$(find "$comp_dir" -name "*.tsx" -o -name "*.jsx" 2>/dev/null | wc -l | tr -d ' ')
+        echo "  Found: $count component(s) in $comp_dir/"
+
+        find "$comp_dir" -name "*.tsx" -o -name "*.jsx" 2>/dev/null | head -15 | while read -r comp; do
+            local name=$(basename "$comp" | sed 's|\.tsx$||' | sed 's|\.jsx$||')
+            echo "    - $name"
+        done
+    else
+        echo "  No components directory found"
+    fi
+
+    echo ""
+}
+
+# Scan for API endpoints
+scan_api() {
+    echo -e "${CYAN}[5/6]${NC} Scanning API endpoints..."
+
+    local api_dir=""
+    [ -d "src/app/api" ] && api_dir="src/app/api"
+    [ -d "app/api" ] && api_dir="app/api"
+    [ -d "src/pages/api" ] && api_dir="src/pages/api"
+    [ -d "pages/api" ] && api_dir="pages/api"
+
+    if [ -n "$api_dir" ]; then
+        echo "  API directory: $api_dir/"
+
+        find "$api_dir" -name "route.ts" -o -name "route.js" -o -name "*.ts" -o -name "*.js" 2>/dev/null | head -20 | while read -r api; do
+            local endpoint=$(dirname "$api" | sed "s|$api_dir||")
+            [ -z "$endpoint" ] && endpoint="/"
+            echo "    → /api$endpoint"
+        done
+    else
+        echo "  No API directory found"
+    fi
+
+    echo ""
+}
+
+# Scan for hooks
+scan_hooks() {
+    echo -e "${CYAN}[6/6]${NC} Scanning custom hooks..."
+
+    local hooks_dir=""
+    [ -d "src/hooks" ] && hooks_dir="src/hooks"
+    [ -d "hooks" ] && hooks_dir="hooks"
+
+    if [ -n "$hooks_dir" ]; then
+        local count=$(find "$hooks_dir" -name "use*.ts" -o -name "use*.tsx" 2>/dev/null | wc -l | tr -d ' ')
+        echo "  Found: $count hook(s) in $hooks_dir/"
+
+        find "$hooks_dir" -name "use*.ts" -o -name "use*.tsx" 2>/dev/null | head -10 | while read -r hook; do
+            local name=$(basename "$hook" | sed 's|\.tsx$||' | sed 's|\.ts$||')
+            echo "    - $name"
+        done
+    else
+        echo "  No hooks directory found"
+    fi
+
+    echo ""
+}
+
+# Generate summary
+generate_summary() {
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo -e "${GREEN}${BOLD}🔍 AUDIT COMPLETE${NC}"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+    echo "Based on this scan, I will generate:"
+    echo ""
+    echo "  📄 instructions/AI_RULES.md"
+    echo "     - Tech Stack section (detected above)"
+    echo "     - File Structure section"
+    echo ""
+    echo "  📘 instructions/BLUEPRINT.md"
+    echo "     - Features table (routes + components + APIs)"
+    echo "     - Routes section"
+    echo "     - API endpoints section"
+    echo ""
+    echo -e "${YELLOW}${BOLD}Should I save these files?${NC} (yes/no/edit first)"
+    echo ""
+}
+
+# Main execution
+main() {
+    print_header
+
+    # Run all scans
+    detect_tech_stack
+    scan_structure
+    scan_routes
+    scan_components
+    scan_api
+    scan_hooks
+
+    # Generate summary
+    generate_summary
+}
+
+main