autoworkflow 3.1.5 → 3.6.0

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

@@ -0,0 +1,221 @@
+#!/bin/bash
+# AutoWorkflow Pre-Edit Hook
+# Runs on: PreToolUse for Write/Edit tools
+# Purpose: Enforce plan approval before implementation
+#
+# This hook implements the plan_approval_gate enforcement
+# It BLOCKS Write/Edit operations if plan hasn't been approved
+
+# 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"
+
+# State files
+PHASE_FILE="$STATE_DIR/phase"
+TASK_TYPE_FILE="$STATE_DIR/task-type"
+PLAN_APPROVED_FILE="$STATE_DIR/plan-approved"
+SUGGESTIONS_SHOWN_FILE="$STATE_DIR/suggestions-shown"
+CURRENT_TURN_EDITS_FILE="$STATE_DIR/current-turn-edits"
+SELECTED_ITEMS_FILE="$STATE_DIR/selected-items"
+
+# Get current phase
+get_phase() {
+    if [ -f "$PHASE_FILE" ]; then
+        cat "$PHASE_FILE"
+    else
+        echo "IDLE"
+    fi
+}
+
+# Get task type
+get_task_type() {
+    if [ -f "$TASK_TYPE_FILE" ]; then
+        cat "$TASK_TYPE_FILE"
+    else
+        echo "unknown"
+    fi
+}
+
+# Check if plan is approved
+is_plan_approved() {
+    if [ -f "$PLAN_APPROVED_FILE" ]; then
+        local status=$(cat "$PLAN_APPROVED_FILE")
+        [ "$status" = "true" ] && return 0
+    fi
+    return 1
+}
+
+# Check if suggestions were shown (for feature tasks)
+suggestions_shown() {
+    if [ -f "$SUGGESTIONS_SHOWN_FILE" ]; then
+        local status=$(cat "$SUGGESTIONS_SHOWN_FILE")
+        [ "$status" = "true" ] && return 0
+    fi
+    return 1
+}
+
+# Get number of edits in current turn
+get_turn_edit_count() {
+    if [ -f "$CURRENT_TURN_EDITS_FILE" ]; then
+        cat "$CURRENT_TURN_EDITS_FILE"
+    else
+        echo "0"
+    fi
+}
+
+# Increment turn edit count
+increment_turn_edits() {
+    local current=$(get_turn_edit_count)
+    local next=$((current + 1))
+    echo "$next" > "$CURRENT_TURN_EDITS_FILE"
+    echo "$next"
+}
+
+# Check if user has selected items to implement
+has_selected_items() {
+    if [ -f "$SELECTED_ITEMS_FILE" ]; then
+        local content=$(cat "$SELECTED_ITEMS_FILE")
+        [ -n "$content" ] && return 0
+    fi
+    return 1
+}
+
+# Check if task type requires approval
+requires_approval() {
+    local task_type="$1"
+    case "$task_type" in
+        # These task types require plan approval
+        feature|fix|refactor|perf|security|test)
+            return 0
+            ;;
+        # These can proceed without explicit approval
+        docs|style|config|query)
+            return 1
+            ;;
+        # Unknown defaults to requiring approval
+        *)
+            return 0
+            ;;
+    esac
+}
+
+# Main check
+main() {
+    local phase=$(get_phase)
+    local task_type=$(get_task_type)
+
+    # Skip check if no task is active
+    if [ "$phase" = "IDLE" ]; then
+        exit 0
+    fi
+
+    # Skip check for task types that don't require approval
+    if ! requires_approval "$task_type"; then
+        exit 0
+    fi
+
+    # Skip check if already in IMPLEMENT or later phases
+    case "$phase" in
+        IMPLEMENT|VERIFY|FIX|AUDIT|PRE_COMMIT|COMMIT|UPDATE)
+            # Already past approval, allow edits
+            exit 0
+            ;;
+    esac
+
+    # Check if we're in a pre-approval phase
+    if [ "$phase" = "ANALYZE" ] || [ "$phase" = "PLAN" ]; then
+        if ! is_plan_approved; then
+            echo ""
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo -e "${RED}${BOLD}⛔ AUTOWORKFLOW: PLAN APPROVAL REQUIRED${NC}"
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo ""
+            echo -e "${CYAN}Current Phase:${NC} $phase"
+            echo -e "${CYAN}Task Type:${NC}    $task_type"
+            echo -e "${CYAN}Plan Approved:${NC} NO"
+            echo ""
+            echo "Cannot edit files before plan approval."
+            echo ""
+            echo -e "${BOLD}Required workflow:${NC}"
+            echo "  1. Complete ANALYZE phase (read relevant files)"
+            echo "  2. Present PLAN with suggestions"
+            echo "  3. Wait for user approval"
+            echo "  4. THEN implement"
+            echo ""
+            echo -e "${DIM}To approve, user must say: yes, proceed, approved, go ahead${NC}"
+            echo ""
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo ""
+
+            # Exit with error to BLOCK the edit
+            exit 1
+        fi
+    fi
+
+    # CHECK: Suggestions must be shown for feature tasks before implementing
+    if [ "$task_type" = "feature" ] && [ "$phase" = "IMPLEMENT" ]; then
+        if ! suggestions_shown; then
+            echo ""
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo -e "${RED}${BOLD}⛔ AUTOWORKFLOW: SUGGESTIONS REQUIRED${NC}"
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo ""
+            echo -e "${CYAN}Task Type:${NC} feature"
+            echo ""
+            echo "For feature tasks, you MUST show 3-tier suggestions first:"
+            echo ""
+            echo "  🔴 Required    - Must implement"
+            echo "  🟡 Recommended - Should implement"
+            echo "  🟢 Optional    - Nice to have"
+            echo ""
+            echo "Show suggestions, let user select items, THEN implement."
+            echo ""
+            echo -e "${DIM}To mark suggestions shown: echo 'true' > $SUGGESTIONS_SHOWN_FILE${NC}"
+            echo ""
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo ""
+            exit 1
+        fi
+    fi
+
+    # CHECK: One fix at a time (max 1 edit per turn in FIX phase)
+    if [ "$phase" = "FIX" ]; then
+        local edit_count=$(get_turn_edit_count)
+        if [ "$edit_count" -ge 1 ]; then
+            echo ""
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo -e "${YELLOW}${BOLD}⚠ AUTOWORKFLOW: ONE FIX AT A TIME${NC}"
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo ""
+            echo -e "${CYAN}Edits this turn:${NC} $edit_count"
+            echo ""
+            echo "Fix ONE issue at a time, then verify."
+            echo ""
+            echo "This ensures:"
+            echo "  1. Easier to track what changed"
+            echo "  2. Errors caught early"
+            echo "  3. User can review incrementally"
+            echo ""
+            echo "Wait for verification to complete before next fix."
+            echo ""
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo ""
+            exit 1
+        fi
+        # Track this edit
+        increment_turn_edits > /dev/null
+    fi
+
+    # All checks passed, allow edit
+    exit 0
+}
+
+main

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

@@ -28,6 +28,80 @@ 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"
+PLAN_APPROVED_FILE="$STATE_DIR/plan-approved"
+CHANGED_FILES_FILE="$STATE_DIR/changed-files"
+SESSION_RESUMED_FILE="$STATE_DIR/session-resumed"
+CURRENT_TURN_EDITS_FILE="$STATE_DIR/current-turn-edits"
+SUGGESTIONS_SHOWN_FILE="$STATE_DIR/suggestions-shown"
+
+# Check for resumable session state
+check_session_resume() {
+    # Only show resume prompt once per session
+    if [ -f "$SESSION_RESUMED_FILE" ]; then
+        return 1
+    fi
+
+    # Check if there's a previous session with active state
+    if [ -f "$PHASE_FILE" ]; then
+        local phase=$(cat "$PHASE_FILE")
+
+        # Only prompt for non-idle, non-complete states
+        if [ "$phase" != "IDLE" ] && [ "$phase" != "" ] && [ "$phase" != "COMMIT" ]; then
+            local task_type=""
+            local verify_iter="0"
+            local plan_approved="false"
+            local changed_count="0"
+
+            [ -f "$TASK_TYPE_FILE" ] && task_type=$(cat "$TASK_TYPE_FILE")
+            [ -f "$STATE_DIR/verify-iteration" ] && verify_iter=$(cat "$STATE_DIR/verify-iteration")
+            [ -f "$PLAN_APPROVED_FILE" ] && plan_approved=$(cat "$PLAN_APPROVED_FILE")
+            [ -f "$CHANGED_FILES_FILE" ] && changed_count=$(wc -l < "$CHANGED_FILES_FILE" 2>/dev/null | tr -d ' ')
+
+            echo ""
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo -e "${CYAN}${BOLD}📍 AUTOWORKFLOW: SESSION RESUME${NC}"
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo ""
+            echo -e "${BOLD}Previous session state detected:${NC}"
+            echo ""
+            echo -e "  ${CYAN}Phase:${NC}           $phase"
+            [ -n "$task_type" ] && echo -e "  ${CYAN}Task type:${NC}       $task_type"
+            echo -e "  ${CYAN}Plan approved:${NC}   $plan_approved"
+            echo -e "  ${CYAN}Verify attempts:${NC} $verify_iter/10"
+            [ "$changed_count" -gt 0 ] 2>/dev/null && echo -e "  ${CYAN}Changed files:${NC}   $changed_count"
+            echo ""
+
+            # Show changed files if any
+            if [ -f "$CHANGED_FILES_FILE" ] && [ "$changed_count" -gt 0 ] 2>/dev/null; then
+                echo -e "${DIM}Pending changes:${NC}"
+                head -5 "$CHANGED_FILES_FILE" | while read file; do
+                    echo -e "  ${DIM}- $file${NC}"
+                done
+                [ "$changed_count" -gt 5 ] 2>/dev/null && echo -e "  ${DIM}... and $((changed_count - 5)) more${NC}"
+                echo ""
+            fi
+
+            # Show workflow position
+            local workflow=$(get_workflow "$task_type")
+            echo -e "${DIM}Workflow: $workflow${NC}"
+            echo -e "${DIM}          ↑ Current: $phase${NC}"
+            echo ""
+
+            echo "Continue from $phase phase, or start fresh?"
+            echo ""
+            echo -e "${DIM}(Say 'continue' to resume, or describe new task to start fresh)${NC}"
+            echo ""
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo ""
+
+            # Mark that we've shown the resume prompt
+            touch "$SESSION_RESUMED_FILE"
+            return 0
+        fi
+    fi
+
+    return 1
+}
 
 # Generate session ID if new session
 init_session() {
@@ -39,6 +113,8 @@ init_session() {
         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
+        rm -f "$PLAN_APPROVED_FILE" 2>/dev/null
+        rm -f "$SESSION_RESUMED_FILE" 2>/dev/null
         return 0  # New session
     fi
     return 1  # Existing session
@@ -321,6 +397,12 @@ show_state() {
     fi
 }
 
+# Reset turn-based state (called each user turn)
+reset_turn_state() {
+    # Reset edit counter for this turn
+    echo "0" > "$CURRENT_TURN_EDITS_FILE"
+}
+
 # Main execution
 main() {
     local is_new_session=false
@@ -330,11 +412,19 @@ main() {
         is_new_session=true
     fi
 
+    # Reset turn state on each user message
+    reset_turn_state
+
     # Check if init is needed (package installed but not set up)
     if check_init_needed; then
         exit 0
     fi
 
+    # Check for session resume (only on existing sessions)
+    if [ "$is_new_session" = false ]; then
+        check_session_resume
+    fi
+
     # Check for missing blueprint (triggers auto-audit)
     check_blueprint
 

package/.claude/settings.json

@@ -18,6 +18,30 @@
         ]
       }
     ],
+    "PreToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "./.claude/hooks/pre-edit.sh",
+            "timeout": 5,
+            "statusMessage": "Checking plan approval..."
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "./.claude/hooks/pre-tool-router.sh \"$TOOL_INPUT\"",
+            "timeout": 300,
+            "statusMessage": "Checking workflow gates..."
+          }
+        ]
+      }
+    ],
     "PostToolUse": [
       {
         "matcher": "Write|Edit",
@@ -29,17 +53,15 @@
             "statusMessage": "Running verification..."
           }
         ]
-      }
-    ],
-    "PreToolUse": [
+      },
       {
         "matcher": "Bash",
         "hooks": [
           {
             "type": "command",
-            "command": "./.claude/hooks/pre-tool-router.sh \"$TOOL_INPUT\"",
-            "timeout": 300,
-            "statusMessage": "Checking workflow gates..."
+            "command": "./.claude/hooks/post-bash-router.sh \"$TOOL_INPUT\"",
+            "timeout": 30,
+            "statusMessage": "Checking post-command actions..."
           }
         ]
       }
@@ -56,6 +78,34 @@
     "ANALYZE → PLAN → CONFIRM → IMPLEMENT → VERIFY → AUDIT → COMMIT → UPDATE",
     "```",
     "",
+    "### CRITICAL: ONE FIX AT A TIME RULE",
+    "**This is NON-NEGOTIABLE and applies to ALL projects (TypeScript, PHP, Python, Go, Rust, etc.):**",
+    "",
+    "1. **NEVER batch multiple fixes** - Fix ONE issue, verify, then move to next",
+    "2. **MUST show 3-tier suggestions FIRST** before any fix:",
+    "   - 🔴 Required (must fix)",
+    "   - 🟡 Recommended (should fix)",
+    "   - 🟢 Optional (nice to have)",
+    "3. **MUST WAIT for user to select** which items to implement",
+    "4. **After user selects**, implement ONE item at a time",
+    "5. **Verify after EACH fix** before moving to the next",
+    "",
+    "❌ WRONG: 'I found 14 issues, let me fix them all'",
+    "✅ RIGHT: 'I found 14 issues. Here are my suggestions: [show tiers]. Which would you like me to fix first?'",
+    "",
+    "",
+    "### Skill Loading (CRITICAL)",
+    "When executing ANY command from .claude/commands/:",
+    "1. Read the command's YAML frontmatter",
+    "2. Check for `skills_required` array",
+    "3. For EACH skill listed, READ the file from `.claude/skills/` BEFORE executing",
+    "4. Apply the knowledge from skills during command execution",
+    "",
+    "Example: `/audit` has `skills_required: [security.md, code-review.md]`",
+    "→ Read `.claude/skills/security.md` first",
+    "→ Read `.claude/skills/code-review.md` second",
+    "→ THEN execute the audit with this knowledge loaded",
+    "",
     "### 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)",

package/.claude/settings.local.json

@@ -11,7 +11,11 @@
       "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:*)"
+      "Bash(git commit:*)",
+      "Bash(unzip:*)",
+      "Bash(node:*)",
+      "Bash(echo:*)",
+      "Bash(ls:*)"
     ]
   }
 }