autoworkflow 3.0.1 → 3.1.1

package/.claude/hooks/phase-transition.sh

@@ -0,0 +1,279 @@
+#!/bin/bash
+# AutoWorkflow Phase Transition Hook
+# Purpose: Enforce gates between workflow phases
+#
+# This hook implements on:phase_transition from system/triggers.md
+# and enforces gates from system/gates.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"
+
+# State files
+PHASE_FILE="$STATE_DIR/phase"
+TASK_TYPE_FILE="$STATE_DIR/task-type"
+APPROVAL_FILE="$STATE_DIR/plan-approved"
+
+# Arguments
+FROM_PHASE="$1"
+TO_PHASE="$2"
+
+# 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"
+}
+
+# Get task type
+get_task_type() {
+    if [ -f "$TASK_TYPE_FILE" ]; then
+        cat "$TASK_TYPE_FILE"
+    else
+        echo "unknown"
+    fi
+}
+
+# Check analyze gate
+check_analyze_gate() {
+    echo ""
+    echo "Checking analyze_gate..."
+
+    # For now, this is soft - relies on Claude having read files
+    echo -e "  ${GREEN}✅${NC} Relevant files should have been read"
+    echo -e "  ${GREEN}✅${NC} Existing patterns understood"
+    echo -e "  ${GREEN}✅${NC} BLUEPRINT.md checked"
+    echo ""
+    return 0
+}
+
+# Check plan approval gate
+check_plan_approval_gate() {
+    echo ""
+    echo "Checking plan_approval_gate..."
+
+    if [ -f "$APPROVAL_FILE" ]; then
+        local approval=$(cat "$APPROVAL_FILE")
+        if [ "$approval" = "approved" ]; then
+            echo -e "  ${GREEN}✅${NC} Plan has been approved"
+            return 0
+        fi
+    fi
+
+    echo -e "  ${RED}⛔${NC} Plan has NOT been approved"
+    echo ""
+    echo -e "${YELLOW}BLOCKED:${NC} User must approve the plan before implementing."
+    echo ""
+    echo "Wait for user to say 'yes', 'proceed', 'approved', etc."
+    echo ""
+    return 1
+}
+
+# Check verify gate
+check_verify_gate() {
+    echo ""
+    echo "Checking verify_gate..."
+
+    if [ -f "$STATE_DIR/verify-status" ]; then
+        local status=$(cat "$STATE_DIR/verify-status")
+        if [ "$status" = "PASSED" ]; then
+            echo -e "  ${GREEN}✅${NC} Verification passed"
+            return 0
+        fi
+    fi
+
+    echo -e "  ${RED}⛔${NC} Verification has NOT passed"
+    echo ""
+    echo -e "${YELLOW}BLOCKED:${NC} Run npm run verify and fix all errors first."
+    echo ""
+    return 1
+}
+
+# Check audit gate
+check_audit_gate() {
+    local task_type=$(get_task_type)
+
+    # Only applies to certain task types
+    case "$task_type" in
+        feature|refactor|perf)
+            ;;
+        *)
+            echo ""
+            echo -e "Skipping audit_gate (not required for task type: $task_type)"
+            return 0
+            ;;
+    esac
+
+    echo ""
+    echo "Checking audit_gate..."
+
+    if [ -f "$STATE_DIR/audit-status" ]; then
+        local status=$(cat "$STATE_DIR/audit-status")
+        if [ "$status" = "PASSED" ]; then
+            echo -e "  ${GREEN}✅${NC} Audit passed"
+            return 0
+        fi
+    fi
+
+    echo -e "  ${RED}⛔${NC} Audit has NOT passed"
+    echo ""
+    echo -e "${YELLOW}BLOCKED:${NC} Run audits before committing:"
+    echo "  npm run audit:ui"
+    echo "  npm run audit:cycles"
+    echo ""
+    return 1
+}
+
+# Transition between phases
+transition() {
+    local from="$1"
+    local to="$2"
+
+    echo ""
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo -e "${BOLD}AUTOWORKFLOW: PHASE TRANSITION${NC}"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+    echo -e "Transition: ${CYAN}$from${NC} → ${CYAN}$to${NC}"
+
+    # Check gate based on transition
+    case "$to" in
+        PLAN)
+            if ! check_analyze_gate; then
+                echo ""
+                echo -e "${RED}⛔ GATE FAILED - Cannot proceed to PLAN${NC}"
+                return 1
+            fi
+            ;;
+        IMPLEMENT)
+            if ! check_plan_approval_gate; then
+                echo ""
+                echo -e "${RED}⛔ GATE FAILED - Cannot proceed to IMPLEMENT${NC}"
+                return 1
+            fi
+            ;;
+        AUDIT)
+            if ! check_verify_gate; then
+                echo ""
+                echo -e "${RED}⛔ GATE FAILED - Cannot proceed to AUDIT${NC}"
+                return 1
+            fi
+            ;;
+        COMMIT|PRE_COMMIT)
+            if ! check_verify_gate; then
+                echo ""
+                echo -e "${RED}⛔ GATE FAILED - Cannot proceed to COMMIT${NC}"
+                return 1
+            fi
+            if ! check_audit_gate; then
+                echo ""
+                echo -e "${RED}⛔ GATE FAILED - Cannot proceed to COMMIT${NC}"
+                return 1
+            fi
+            ;;
+    esac
+
+    # Gate passed - update phase
+    set_phase "$to"
+
+    echo ""
+    echo -e "${GREEN}✅ Gate passed - Now in ${BOLD}$to${NC} phase"
+    echo ""
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+
+    return 0
+}
+
+# Record plan approval
+record_approval() {
+    echo "approved" > "$APPROVAL_FILE"
+    echo ""
+    echo -e "${GREEN}✅${NC} Plan approval recorded"
+    echo ""
+}
+
+# Record plan rejection
+record_rejection() {
+    echo "rejected" > "$APPROVAL_FILE"
+    echo ""
+    echo -e "${YELLOW}Plan rejected - returning to PLAN phase${NC}"
+    set_phase "PLAN"
+    echo ""
+}
+
+# Reset workflow state
+reset_workflow() {
+    rm -f "$STATE_DIR/session-id"
+    rm -f "$STATE_DIR/phase"
+    rm -f "$STATE_DIR/task-type"
+    rm -f "$STATE_DIR/verify-iteration"
+    rm -f "$STATE_DIR/verify-status"
+    rm -f "$STATE_DIR/audit-status"
+    rm -f "$STATE_DIR/gate-status"
+    rm -f "$STATE_DIR/gate-errors"
+    rm -f "$STATE_DIR/plan-approved"
+    rm -f "$STATE_DIR/changed-files"
+    rm -f "$STATE_DIR/blueprint-checked"
+
+    echo ""
+    echo -e "${GREEN}✅${NC} Workflow state reset"
+    echo ""
+}
+
+# Main command dispatcher
+case "$1" in
+    transition)
+        transition "$2" "$3"
+        ;;
+    approve)
+        record_approval
+        ;;
+    reject)
+        record_rejection
+        ;;
+    reset)
+        reset_workflow
+        ;;
+    status)
+        echo ""
+        echo "Current phase: $(get_phase)"
+        echo "Task type: $(get_task_type)"
+        if [ -f "$STATE_DIR/verify-iteration" ]; then
+            echo "Verify iteration: $(cat $STATE_DIR/verify-iteration)"
+        fi
+        if [ -f "$STATE_DIR/verify-status" ]; then
+            echo "Verify status: $(cat $STATE_DIR/verify-status)"
+        fi
+        if [ -f "$APPROVAL_FILE" ]; then
+            echo "Plan approval: $(cat $APPROVAL_FILE)"
+        fi
+        echo ""
+        ;;
+    *)
+        echo "Usage: phase-transition.sh <command> [args]"
+        echo ""
+        echo "Commands:"
+        echo "  transition <from> <to>  - Transition between phases"
+        echo "  approve                 - Record plan approval"
+        echo "  reject                  - Record plan rejection"
+        echo "  reset                   - Reset workflow state"
+        echo "  status                  - Show current state"
+        ;;
+esac

package/.claude/hooks/post-edit.sh

@@ -1,21 +1,225 @@
 #!/bin/bash
 # AutoWorkflow Post-Edit Hook
 # Runs on: PostToolUse for Write/Edit tools
-# Purpose: Remind Claude to run verification after code changes
+# Purpose: Auto-run verification with loop tracking
+#
+# This hook implements verify_loop from system/loops.md
+# It tracks iterations and enforces the verify_gate
 
-# Get the tool that was used (passed as argument or environment)
-TOOL_NAME="${1:-unknown}"
+set -e
 
-# Only trigger for code file changes
-case "$TOOL_NAME" in
-    Write|Edit)
+# 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=10
+VERIFY_ITERATION_FILE="$STATE_DIR/verify-iteration"
+VERIFY_STATUS_FILE="$STATE_DIR/verify-status"
+CHANGED_FILES_FILE="$STATE_DIR/changed-files"
+PHASE_FILE="$STATE_DIR/phase"
+
+# Get current iteration count
+get_iteration() {
+    if [ -f "$VERIFY_ITERATION_FILE" ]; then
+        cat "$VERIFY_ITERATION_FILE"
+    else
+        echo "0"
+    fi
+}
+
+# Increment iteration
+increment_iteration() {
+    local current=$(get_iteration)
+    local next=$((current + 1))
+    echo "$next" > "$VERIFY_ITERATION_FILE"
+    echo "$next"
+}
+
+# Reset iteration counter
+reset_iteration() {
+    echo "0" > "$VERIFY_ITERATION_FILE"
+}
+
+# Track changed file
+track_file() {
+    local file="$1"
+    if [ -n "$file" ]; then
+        echo "$file" >> "$CHANGED_FILES_FILE"
+        # Remove duplicates
+        if [ -f "$CHANGED_FILES_FILE" ]; then
+            sort -u "$CHANGED_FILES_FILE" -o "$CHANGED_FILES_FILE"
+        fi
+    fi
+}
+
+# Get current phase
+get_phase() {
+    if [ -f "$PHASE_FILE" ]; then
+        cat "$PHASE_FILE"
+    else
+        echo "UNKNOWN"
+    fi
+}
+
+# Set phase
+set_phase() {
+    echo "$1" > "$PHASE_FILE"
+}
+
+# Print header
+print_header() {
+    local iteration=$(get_iteration)
+    echo ""
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo -e "${BOLD}AUTOWORKFLOW: VERIFY LOOP${NC} ${DIM}(Iteration $iteration/$MAX_ITERATIONS)${NC}"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+}
+
+# Run verification
+run_verify() {
+    local has_verify=false
+    local has_typecheck=false
+    local has_lint=false
+
+    # Check what scripts are available
+    if [ -f "package.json" ]; then
+        grep -q '"verify"' package.json 2>/dev/null && has_verify=true
+        grep -q '"typecheck"' package.json 2>/dev/null && has_typecheck=true
+        grep -q '"lint"' package.json 2>/dev/null && has_lint=true
+    fi
+
+    if [ "$has_verify" = true ]; then
+        echo -e "${CYAN}Running:${NC} npm run verify"
+        echo ""
+        if npm run verify 2>&1; then
+            return 0
+        else
+            return 1
+        fi
+    elif [ "$has_typecheck" = true ] || [ "$has_lint" = true ]; then
+        local exit_code=0
+
+        if [ "$has_typecheck" = true ]; then
+            echo -e "${CYAN}Running:${NC} npm run typecheck"
+            if ! npm run typecheck 2>&1; then
+                exit_code=1
+            fi
+        fi
+
+        if [ "$has_lint" = true ]; then
+            echo ""
+            echo -e "${CYAN}Running:${NC} npm run lint"
+            if ! npm run lint 2>&1; then
+                exit_code=1
+            fi
+        fi
+
+        return $exit_code
+    else
+        echo -e "${YELLOW}⚠${NC} No verify/typecheck/lint scripts found in package.json"
+        echo "  Skipping verification."
+        return 0
+    fi
+}
+
+# Main execution
+main() {
+    local current_phase=$(get_phase)
+
+    # Track that we're in VERIFY phase
+    set_phase "VERIFY"
+
+    # Get current iteration and increment
+    local iteration=$(increment_iteration)
+
+    # Check if we've exceeded max iterations
+    if [ "$iteration" -gt "$MAX_ITERATIONS" ]; then
+        echo ""
+        echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+        echo -e "${RED}${BOLD}⛔ MAX ITERATIONS REACHED${NC}"
+        echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
         echo ""
-        echo "--------------------------------------------------"
-        echo "AUTOWORKFLOW: File modified"
-        echo "--------------------------------------------------"
-        echo "After completing all changes, run: npm run verify"
-        echo "Fix any errors before proceeding to commit."
-        echo "--------------------------------------------------"
+        echo "Verification has failed $MAX_ITERATIONS times."
+        echo "Manual intervention required."
         echo ""
-        ;;
-esac
+        echo "Options:"
+        echo "  1. Fix remaining errors manually"
+        echo "  2. Reset counter: rm $VERIFY_ITERATION_FILE"
+        echo ""
+        echo "BLOCKED" > "$VERIFY_STATUS_FILE"
+        # Don't exit with error - let Claude continue but report the issue
+        exit 0
+    fi
+
+    print_header
+
+    # Run verification
+    echo "Checking TypeScript + ESLint..."
+    echo ""
+
+    if run_verify; then
+        echo ""
+        echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+        echo -e "${GREEN}${BOLD}✅ VERIFICATION PASSED${NC}"
+        echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+        echo ""
+
+        # Reset iteration counter on success
+        reset_iteration
+
+        # Update status
+        echo "PASSED" > "$VERIFY_STATUS_FILE"
+
+        # Check if this was a feature/refactor that needs audit
+        local task_type=""
+        if [ -f "$STATE_DIR/task-type" ]; then
+            task_type=$(cat "$STATE_DIR/task-type")
+        fi
+
+        if [ "$task_type" = "feature" ] || [ "$task_type" = "refactor" ]; then
+            echo "Task type: $task_type → AUDIT phase required"
+            echo ""
+            echo "Next: Run audits before commit"
+            echo "  npm run audit:ui"
+            echo "  npm run audit:cycles"
+            set_phase "AUDIT"
+        else
+            echo "Ready to proceed to COMMIT."
+            set_phase "PRE_COMMIT"
+        fi
+        echo ""
+
+    else
+        echo ""
+        echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+        echo -e "${RED}${BOLD}❌ VERIFICATION FAILED${NC} ${DIM}(Iteration $iteration/$MAX_ITERATIONS)${NC}"
+        echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+        echo ""
+
+        # Update status
+        echo "FAILED" > "$VERIFY_STATUS_FILE"
+        echo "$iteration" > "$VERIFY_ITERATION_FILE"
+
+        echo "Fix the errors above and save the file."
+        echo "Verification will re-run automatically."
+        echo ""
+        echo -e "${DIM}Remaining attempts: $((MAX_ITERATIONS - iteration))${NC}"
+        echo ""
+
+        # Enter FIX phase
+        set_phase "FIX"
+    fi
+}
+
+main