autoworkflow 3.0.1 → 3.1.1

package/.claude/hooks/session-check.sh

@@ -1,58 +1,345 @@
 #!/bin/bash
 # AutoWorkflow Session Check Hook
 # Runs on: UserPromptSubmit (every user message)
-# Purpose: Check for missing files and inject instructions to Claude
+# Purpose: Initialize state, check for missing files, route tasks
+#
+# This hook implements:
+# - on:conversation_start trigger
+# - on:blueprint_missing trigger (AUTO-RUN audit)
+# - on:init_needed trigger
+# - on:task_received trigger (task classification)
 
-# Colors for output
+# Colors
 RED='\033[0;31m'
+GREEN='\033[0;32m'
 YELLOW='\033[1;33m'
-NC='\033[0m' # No Color
+CYAN='\033[0;36m'
+BOLD='\033[1m'
+DIM='\033[2m'
+NC='\033[0m'
 
-# Track if this is first message (check for state file)
-STATE_FILE=".claude/.autoworkflow-session"
+# State directory
+STATE_DIR=".claude/.autoworkflow"
+mkdir -p "$STATE_DIR"
+
+# State files
+SESSION_FILE="$STATE_DIR/session-id"
+PHASE_FILE="$STATE_DIR/phase"
+TASK_TYPE_FILE="$STATE_DIR/task-type"
+BLUEPRINT_CHECK_FILE="$STATE_DIR/blueprint-checked"
+TASK_DESCRIPTION_FILE="$STATE_DIR/task-description"
+
+# Generate session ID if new session
+init_session() {
+    if [ ! -f "$SESSION_FILE" ]; then
+        echo "$(date +%s)-$$" > "$SESSION_FILE"
+        echo "IDLE" > "$PHASE_FILE"
+        rm -f "$STATE_DIR/verify-iteration" 2>/dev/null
+        rm -f "$STATE_DIR/verify-status" 2>/dev/null
+        rm -f "$STATE_DIR/changed-files" 2>/dev/null
+        rm -f "$BLUEPRINT_CHECK_FILE" 2>/dev/null
+        rm -f "$TASK_TYPE_FILE" 2>/dev/null
+        return 0  # New session
+    fi
+    return 1  # Existing session
+}
+
+# Get current phase
+get_phase() {
+    if [ -f "$PHASE_FILE" ]; then
+        cat "$PHASE_FILE"
+    else
+        echo "IDLE"
+    fi
+}
+
+# Set phase
+set_phase() {
+    echo "$1" > "$PHASE_FILE"
+}
+
+# Check if autoworkflow package is installed but not initialized
+check_init_needed() {
+    if [ -d "node_modules/autoworkflow" ] && [ ! -f "CLAUDE.md" ]; then
+        echo ""
+        echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+        echo -e "${YELLOW}${BOLD}📦 AUTOWORKFLOW: INIT NEEDED${NC}"
+        echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+        echo ""
+        echo "AutoWorkflow package detected but not initialized."
+        echo ""
+        echo "Run: npx autoworkflow init"
+        echo ""
+        echo "This will create:"
+        echo "  - CLAUDE.md (entry point)"
+        echo "  - system/ (triggers, loops, gates)"
+        echo "  - instructions/ (workflow, rules, blueprint)"
+        echo "  - .claude/ (commands, hooks)"
+        echo ""
+        echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+        echo ""
+        return 0
+    fi
+    return 1
+}
+
+# Check for missing BLUEPRINT.md - triggers AUTO audit
+check_blueprint() {
+    # Only check once per session
+    if [ -f "$BLUEPRINT_CHECK_FILE" ]; then
+        return 0
+    fi
+
+    # Mark as checked
+    touch "$BLUEPRINT_CHECK_FILE"
+
+    if [ ! -f "instructions/BLUEPRINT.md" ]; then
+        echo ""
+        echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+        echo -e "${RED}${BOLD}⚠️  AUTOWORKFLOW TRIGGER: BLUEPRINT_MISSING${NC}"
+        echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+        echo ""
+        echo "instructions/BLUEPRINT.md does not exist."
+        echo ""
+        echo -e "${BOLD}ACTION: RUN PROJECT AUDIT IMMEDIATELY${NC}"
+        echo ""
+        echo "Do NOT ask permission to start. Just run these commands now:"
+        echo ""
+        echo -e "${CYAN}1.${NC} cat package.json | head -50     ${DIM}# Detect tech stack${NC}"
+        echo -e "${CYAN}2.${NC} ls -la                          ${DIM}# See project structure${NC}"
+        echo -e "${CYAN}3.${NC} ls src/ 2>/dev/null || ls app/  ${DIM}# Find source directory${NC}"
+        echo -e "${CYAN}4.${NC} find . -name '*.ts' -o -name '*.tsx' | head -20"
+        echo ""
+        echo "Then generate:"
+        echo "  - instructions/AI_RULES.md (tech stack, file structure)"
+        echo "  - instructions/BLUEPRINT.md (features, routes, APIs)"
+        echo ""
+        echo -e "${YELLOW}Only ask user approval to SAVE, not to start scanning.${NC}"
+        echo ""
+        echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+        echo ""
+
+        # Set phase to indicate audit is needed
+        set_phase "AUDIT_REQUIRED"
+        return 1
+    fi
+
+    # Also check for AI_RULES.md
+    if [ ! -f "instructions/AI_RULES.md" ]; then
+        echo ""
+        echo -e "${YELLOW}⚠${NC}  instructions/AI_RULES.md is missing."
+        echo "    Generate it during the project audit."
+        echo ""
+    fi
+
+    return 0
+}
+
+# Classify task type from user input
+classify_task() {
+    local input="$1"
+    local input_lower=$(echo "$input" | tr '[:upper:]' '[:lower:]')
+
+    # Query patterns (questions, not actions)
+    if echo "$input_lower" | grep -qE "^(what|how|why|where|when|which|who|can you|could you|explain|show me|find|search|list|tell me)"; then
+        echo "query"
+        return
+    fi
+
+    # Feature patterns
+    if echo "$input_lower" | grep -qE "(add|create|implement|build|new|feature|functionality|capability)"; then
+        echo "feature"
+        return
+    fi
+
+    # Fix patterns
+    if echo "$input_lower" | grep -qE "(fix|bug|broken|doesn't work|error|issue|problem|wrong|crash|fail)"; then
+        echo "fix"
+        return
+    fi
+
+    # Refactor patterns
+    if echo "$input_lower" | grep -qE "(refactor|clean up|restructure|reorganize|extract|split|merge|rename|improve)"; then
+        echo "refactor"
+        return
+    fi
+
+    # Style patterns
+    if echo "$input_lower" | grep -qE "(style|css|color|layout|design|spacing|font|responsive|mobile|ui|ux)"; then
+        echo "style"
+        return
+    fi
+
+    # Docs patterns
+    if echo "$input_lower" | grep -qE "(document|readme|comment|jsdoc|explain|describe)"; then
+        echo "docs"
+        return
+    fi
+
+    # Test patterns
+    if echo "$input_lower" | grep -qE "(test|spec|coverage|unit test|integration|e2e)"; then
+        echo "test"
+        return
+    fi
+
+    # Performance patterns
+    if echo "$input_lower" | grep -qE "(performance|optimize|speed|fast|slow|lag|memory|bundle)"; then
+        echo "perf"
+        return
+    fi
+
+    # Security patterns
+    if echo "$input_lower" | grep -qE "(security|vulnerability|auth|permission|sanitize|validate|escape|encrypt)"; then
+        echo "security"
+        return
+    fi
+
+    # Config patterns
+    if echo "$input_lower" | grep -qE "(config|setting|environment|env|setup|install|dependency)"; then
+        echo "config"
+        return
+    fi
+
+    # Default to feature for most actionable requests
+    echo "feature"
+}
+
+# Get workflow for task type
+get_workflow() {
+    local task_type="$1"
+
+    case "$task_type" in
+        feature)
+            echo "ANALYZE → PLAN → CONFIRM → IMPLEMENT → VERIFY → AUDIT → COMMIT → UPDATE"
+            ;;
+        fix)
+            echo "ANALYZE → PLAN → CONFIRM → IMPLEMENT → VERIFY → COMMIT"
+            ;;
+        refactor)
+            echo "ANALYZE → PLAN → CONFIRM → IMPLEMENT → VERIFY → AUDIT → COMMIT"
+            ;;
+        style|docs|config)
+            echo "ANALYZE → PLAN → CONFIRM → IMPLEMENT → VERIFY → COMMIT"
+            ;;
+        test)
+            echo "ANALYZE → PLAN → CONFIRM → IMPLEMENT → VERIFY → RUN_TESTS → COMMIT"
+            ;;
+        perf)
+            echo "ANALYZE → PLAN → CONFIRM → IMPLEMENT → VERIFY → AUDIT → COMMIT"
+            ;;
+        security)
+            echo "ANALYZE → PLAN → CONFIRM → IMPLEMENT → VERIFY → SECURITY_REVIEW → COMMIT"
+            ;;
+        query)
+            echo "ANALYZE → RESPOND"
+            ;;
+        *)
+            echo "ANALYZE → PLAN → CONFIRM → IMPLEMENT → VERIFY → COMMIT"
+            ;;
+    esac
+}
+
+# Check if task requires audit
+requires_audit() {
+    local task_type="$1"
+    case "$task_type" in
+        feature|refactor|perf)
+            return 0
+            ;;
+        *)
+            return 1
+            ;;
+    esac
+}
+
+# Output task classification
+output_classification() {
+    local task_type="$1"
+    local workflow=$(get_workflow "$task_type")
+
+    # Save task type to state
+    echo "$task_type" > "$TASK_TYPE_FILE"
+    set_phase "ANALYZE"
 
-# Check if BLUEPRINT.md exists
-if [ ! -f "instructions/BLUEPRINT.md" ]; then
-    echo ""
-    echo "=================================================="
-    echo "AUTOWORKFLOW TRIGGER: BLUEPRINT_MISSING"
-    echo "=================================================="
-    echo ""
-    echo "instructions/BLUEPRINT.md does not exist."
-    echo ""
-    echo "ACTION REQUIRED: Run project audit IMMEDIATELY."
-    echo "Do NOT ask permission. Just run these commands now:"
-    echo ""
-    echo "1. cat package.json (detect tech stack)"
-    echo "2. ls -la (see project structure)"
-    echo "3. find . -type d -name 'src' -o -name 'app' -o -name 'pages' | head -5"
-    echo "4. ls src/ 2>/dev/null || ls app/ 2>/dev/null || echo 'No src/app dir'"
     echo ""
-    echo "Then generate BLUEPRINT.md with discovered features."
-    echo "Only ask user approval to SAVE, not to start scanning."
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo -e "${BOLD}AUTOWORKFLOW: TASK CLASSIFIED${NC}"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
     echo ""
-    echo "=================================================="
+    echo -e "${CYAN}Type:${NC}     $task_type"
+    echo -e "${CYAN}Workflow:${NC} $workflow"
     echo ""
-fi
 
-# Check if AI_RULES.md exists
-if [ ! -f "instructions/AI_RULES.md" ]; then
-    echo ""
-    echo "WARNING: instructions/AI_RULES.md is missing."
-    echo "Generate it along with BLUEPRINT.md during audit."
-    echo ""
-fi
+    # Show required gates
+    echo -e "${CYAN}Required Gates:${NC}"
+    echo "  ☐ plan_approval_gate (user must approve)"
+    echo "  ☐ verify_gate (typecheck + lint)"
+
+    if requires_audit "$task_type"; then
+        echo "  ☐ audit_gate (UI enforcement + cycles)"
+    fi
 
-# Check if autoworkflow is in node_modules but not initialized
-if [ -d "node_modules/autoworkflow" ] && [ ! -f "CLAUDE.md" ]; then
+    echo "  ☐ pre_commit_gate (all checks)"
     echo ""
-    echo "=================================================="
-    echo "AUTOWORKFLOW TRIGGER: INIT_NEEDED"
-    echo "=================================================="
+
+    # Show current phase
+    echo -e "${CYAN}Current Phase:${NC} ANALYZE"
     echo ""
-    echo "AutoWorkflow package detected but not initialized."
-    echo "Suggest user run: npx autoworkflow init"
+
+    # Instructions for this phase
+    echo -e "${DIM}Read relevant files and understand the codebase.${NC}"
+    echo -e "${DIM}Check instructions/BLUEPRINT.md for requirements.${NC}"
     echo ""
-    echo "=================================================="
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
     echo ""
-fi
+}
+
+# Show current workflow state
+show_state() {
+    local phase=$(get_phase)
+    local task_type=""
+
+    if [ -f "$TASK_TYPE_FILE" ]; then
+        task_type=$(cat "$TASK_TYPE_FILE")
+    fi
+
+    if [ "$phase" != "IDLE" ] && [ -n "$task_type" ]; then
+        echo ""
+        echo -e "${DIM}━━━ Workflow State ━━━${NC}"
+        echo -e "${DIM}Phase: $phase | Task: $task_type${NC}"
+
+        # Show verify iteration if in verify/fix
+        if [ "$phase" = "VERIFY" ] || [ "$phase" = "FIX" ]; then
+            if [ -f "$STATE_DIR/verify-iteration" ]; then
+                local iteration=$(cat "$STATE_DIR/verify-iteration")
+                echo -e "${DIM}Verify iteration: $iteration/10${NC}"
+            fi
+        fi
+
+        echo -e "${DIM}━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        echo ""
+    fi
+}
+
+# Main execution
+main() {
+    local is_new_session=false
+
+    # Initialize session
+    if init_session; then
+        is_new_session=true
+    fi
+
+    # Check if init is needed (package installed but not set up)
+    if check_init_needed; then
+        exit 0
+    fi
+
+    # Check for missing blueprint (triggers auto-audit)
+    check_blueprint
+
+    # Show current state if not idle
+    show_state
+}
+
+main

package/.claude/settings.json

@@ -12,7 +12,7 @@
           {
             "type": "command",
             "command": "./.claude/hooks/session-check.sh",
-            "timeout": 5,
+            "timeout": 10,
             "statusMessage": "Checking project state..."
           }
         ]
@@ -24,7 +24,9 @@
         "hooks": [
           {
             "type": "command",
-            "command": "./.claude/hooks/post-edit.sh"
+            "command": "./.claude/hooks/post-edit.sh",
+            "timeout": 120,
+            "statusMessage": "Running verification..."
           }
         ]
       }
@@ -35,7 +37,9 @@
         "hooks": [
           {
             "type": "command",
-            "command": "./.claude/hooks/pre-commit-check.sh"
+            "command": "./.claude/hooks/pre-tool-router.sh \"$TOOL_INPUT\"",
+            "timeout": 300,
+            "statusMessage": "Checking workflow gates..."
           }
         ]
       }
@@ -43,16 +47,54 @@
   },
 
   "instructions": [
-    "WORKFLOW: Follow ANALYZE → PLAN → CONFIRM → IMPLEMENT → VERIFY → AUDIT → COMMIT for all tasks",
-    "SESSION START: If instructions/BLUEPRINT.md missing, immediately scan codebase and generate it. Do not ask to start - only ask to save.",
-    "AFTER CODE CHANGES: Run 'npm run verify' automatically. If errors exist, fix them and re-verify until passing.",
-    "BEFORE COMMIT: Block if TODO/FIXME/console.log found in changes. Require conventional commit format: type(scope): description",
-    "UI ENFORCEMENT: Every backend endpoint/API must have a corresponding UI component. No orphan features allowed.",
-    "PLAN GATE: Always wait for user approval before implementing. Show plan with suggestions first.",
-    "BLUEPRINT UPDATE: After adding new features/routes/APIs, update instructions/BLUEPRINT.md",
-    "Read instructions/AI_RULES.md for project-specific coding standards",
-    "Read system/router.md to classify task type",
-    "Read system/gates.md for blocking rules"
+    "## WORKFLOW ENFORCEMENT",
+    "",
+    "You MUST follow this workflow for ALL tasks:",
+    "",
+    "### Phase Flow",
+    "```",
+    "ANALYZE → PLAN → CONFIRM → IMPLEMENT → VERIFY → AUDIT → COMMIT → UPDATE",
+    "```",
+    "",
+    "### Auto-Triggers (Hooks enforce these)",
+    "1. **SESSION START**: If instructions/BLUEPRINT.md missing → AUTO-RUN audit (no permission needed)",
+    "2. **AFTER CODE CHANGES**: Run `npm run verify` automatically. Fix errors until passing (max 10 iterations)",
+    "3. **BEFORE COMMIT**: All 7 gates must pass or commit is BLOCKED:",
+    "   - TypeScript errors = 0",
+    "   - ESLint warnings = 0",
+    "   - No TODO/FIXME in changes",
+    "   - No console.log in changes",
+    "   - No orphan features (audit:ui)",
+    "   - No circular deps (audit:cycles)",
+    "   - Conventional commit format: type(scope): description",
+    "",
+    "### Blocking Gates",
+    "- **plan_approval_gate**: WAIT for user approval before implementing",
+    "- **verify_gate**: Code must pass typecheck + lint",
+    "- **audit_gate**: No orphan features, no cycles (for features/refactors)",
+    "- **pre_commit_gate**: All checks must pass",
+    "",
+    "### Task Types (from system/router.md)",
+    "| Type | Workflow | Audit? |",
+    "|------|----------|--------|",
+    "| feature | Full (all phases) | Yes |",
+    "| fix | Standard (no audit) | No |",
+    "| refactor | Full with audit | Yes |",
+    "| docs | Simple | No |",
+    "| query | Analyze → Respond | No |",
+    "",
+    "### Required Files",
+    "- Read instructions/AI_RULES.md for coding standards",
+    "- Read instructions/BLUEPRINT.md for project state",
+    "- Read system/router.md to classify task type",
+    "- Read system/gates.md for blocking rules",
+    "",
+    "### State Tracking",
+    "Check .claude/.autoworkflow/ for current workflow state:",
+    "- phase: Current phase (ANALYZE, PLAN, etc.)",
+    "- task-type: Classified task type",
+    "- verify-iteration: Current verify loop count",
+    "- gate-status: Last gate check result"
   ],
 
   "workflow": {
@@ -77,7 +119,7 @@
     },
     "pre_commit": {
       "blocking": true,
-      "checks": ["No TODO/FIXME", "No console.log", "Conventional commit format"]
+      "checks": ["TypeScript", "ESLint", "No TODO/FIXME", "No console.log", "UI Enforcement", "Circular Deps", "Commit Format"]
     }
   },
 
@@ -120,6 +162,9 @@
     "noOrphanFeatures": true,
     "noCircularDependencies": true,
     "conventionalCommits": true,
-    "readBeforeWrite": true
+    "readBeforeWrite": true,
+    "planBeforeImplement": true,
+    "verifyAfterImplement": true,
+    "auditBeforeCommit": true
   }
 }

package/.claude/settings.local.json

@@ -6,7 +6,12 @@
       "Bash(npm version:*)",
       "Bash(node bin/cli.js:*)",
       "Bash(npm pkg:*)",
-      "Bash(wc:*)"
+      "Bash(wc:*)",
+      "Bash(chmod:*)",
+      "Bash(npm run typecheck:*)",
+      "Bash(git add:*)",
+      "Bash(git commit -m \"$\\(cat <<''EOF''\nfeat\\(hooks\\): implement full auto-trigger system with blocking gates\n\n- Add 7 new hook scripts for workflow automation:\n  - session-check.sh: Init, blueprint check, task classification\n  - post-edit.sh: Auto-verify with loop tracking \\(max 10 iterations\\)\n  - pre-tool-router.sh: Route Bash commands to appropriate checks\n  - pre-commit-check.sh: All 7 gate checks with blocking \\(exit 1\\)\n  - phase-transition.sh: State management and gate enforcement\n  - audit-runner.sh: UI enforcement + circular dependency checks\n  - blueprint-generator.sh: Auto-scan project structure\n\n- Pre-commit gate now checks:\n  - TypeScript errors\n  - ESLint warnings\n  - TODO/FIXME comments\n  - console.log statements\n  - Orphan features \\(UI enforcement\\)\n  - Circular dependencies\n  - Conventional commit format\n\n- State tracking in .claude/.autoworkflow/:\n  - phase, task-type, verify-iteration, audit-iteration\n  - verify-status, audit-status, plan-approved\n\n- Updated CLAUDE.md files with:\n  - Slash commands table\n  - Hook files reference\n  - Hook integration section\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\nEOF\n\\)\")",
+      "Bash(git commit:*)"
     ]
   }
 }