autoworkflow 3.8.4 → 3.9.0

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

@@ -53,6 +53,48 @@ get_task_type() {
     fi
 }
 
+# Reflection prompts (Serena-inspired)
+# These prompt Claude to self-assess before proceeding
+output_reflection_prompt() {
+    local phase="$1"
+
+    echo ""
+    echo -e "${CYAN}━━━ REFLECTION CHECK ━━━${NC}"
+
+    case "$phase" in
+        PLAN)
+            echo -e "${DIM}Before proceeding to PLAN, verify:${NC}"
+            echo "  • Have you read ALL relevant files?"
+            echo "  • Do you understand the existing patterns?"
+            echo "  • Have you checked BLUEPRINT.md for requirements?"
+            echo "  • Are there edge cases you haven't considered?"
+            ;;
+        IMPLEMENT)
+            echo -e "${DIM}Before proceeding to IMPLEMENT, verify:${NC}"
+            echo "  • Does this plan match the original request?"
+            echo "  • Have you considered all affected files?"
+            echo "  • Are there simpler alternatives?"
+            echo "  • Will this introduce breaking changes?"
+            ;;
+        VERIFY)
+            echo -e "${DIM}Before proceeding to VERIFY, verify:${NC}"
+            echo "  • Is the implementation complete?"
+            echo "  • Have you handled all edge cases?"
+            echo "  • Are there TODO/FIXME comments left?"
+            echo "  • Did you test the happy path mentally?"
+            ;;
+        COMMIT)
+            echo -e "${DIM}Before proceeding to COMMIT, verify:${NC}"
+            echo "  • Is this work truly complete?"
+            echo "  • Would you be confident shipping this?"
+            echo "  • Have you updated BLUEPRINT.md if needed?"
+            echo "  • Does the commit message accurately describe changes?"
+            ;;
+    esac
+    echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo ""
+}
+
 # Check analyze gate
 check_analyze_gate() {
     echo ""
@@ -198,6 +240,10 @@ transition() {
     echo ""
     echo -e "${GREEN}✅ Gate passed - Now in ${BOLD}$to${NC} phase"
     echo ""
+
+    # Output reflection prompt for the new phase
+    output_reflection_prompt "$to"
+
     echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
     echo ""
 
@@ -240,6 +286,133 @@ reset_workflow() {
     echo ""
 }
 
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# MEMORY SYSTEM (Serena-inspired)
+# Persistent context that survives across sessions
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+MEMORY_DIR="$STATE_DIR/memories"
+mkdir -p "$MEMORY_DIR"
+
+# Save a memory (key-value with optional category)
+save_memory() {
+    local category="$1"
+    local key="$2"
+    local value="$3"
+    local timestamp=$(date +"%Y-%m-%d %H:%M:%S")
+
+    local memory_file="$MEMORY_DIR/${category}.md"
+
+    # Create file with header if it doesn't exist
+    if [ ! -f "$memory_file" ]; then
+        cat > "$memory_file" << EOF
+# ${category^} Memory
+
+> Auto-generated memory store. Add entries as you work.
+
+---
+
+EOF
+    fi
+
+    # Append new memory entry
+    cat >> "$memory_file" << EOF
+## $key
+*Recorded: $timestamp*
+
+$value
+
+---
+
+EOF
+
+    echo -e "${GREEN}✅${NC} Memory saved: $category/$key"
+}
+
+# Read memories for a category
+read_memories() {
+    local category="$1"
+    local memory_file="$MEMORY_DIR/${category}.md"
+
+    if [ -f "$memory_file" ]; then
+        cat "$memory_file"
+    else
+        echo "No memories found for category: $category"
+    fi
+}
+
+# List all memory categories
+list_memories() {
+    echo ""
+    echo -e "${CYAN}Available Memory Categories:${NC}"
+    echo ""
+
+    if [ -d "$MEMORY_DIR" ]; then
+        for file in "$MEMORY_DIR"/*.md; do
+            if [ -f "$file" ]; then
+                local category=$(basename "$file" .md)
+                local count=$(grep -c "^## " "$file" 2>/dev/null || echo "0")
+                echo "  - $category ($count entries)"
+            fi
+        done
+    else
+        echo "  No memories stored yet."
+    fi
+    echo ""
+}
+
+# Save context for session continuity
+save_context() {
+    local task_description="$1"
+    local current_phase=$(get_phase)
+    local task_type=$(get_task_type)
+    local timestamp=$(date +"%Y-%m-%d %H:%M:%S")
+
+    local context_file="$MEMORY_DIR/context.md"
+
+    cat > "$context_file" << EOF
+# Session Context
+
+> Last updated: $timestamp
+
+## Current State
+- **Phase:** $current_phase
+- **Task Type:** $task_type
+- **Description:** $task_description
+
+## What Was Done
+<!-- Claude should update this section as work progresses -->
+
+## What Remains
+<!-- Claude should update this section -->
+
+## Key Decisions Made
+<!-- Document important choices and their rationale -->
+
+## Files Modified
+$(cat "$STATE_DIR/changed-files" 2>/dev/null || echo "None yet")
+
+---
+
+*Use this context to resume work in a new session.*
+EOF
+
+    echo -e "${GREEN}✅${NC} Context saved for session continuity"
+}
+
+# Load context summary
+load_context() {
+    local context_file="$MEMORY_DIR/context.md"
+
+    if [ -f "$context_file" ]; then
+        echo ""
+        echo -e "${CYAN}━━━ PREVIOUS SESSION CONTEXT ━━━${NC}"
+        cat "$context_file"
+        echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        echo ""
+    fi
+}
+
 # Main command dispatcher
 case "$1" in
     transition)
@@ -269,6 +442,25 @@ case "$1" in
         fi
         echo ""
         ;;
+    # Memory commands (Serena-inspired)
+    memory-save)
+        save_memory "$2" "$3" "$4"
+        ;;
+    memory-read)
+        read_memories "$2"
+        ;;
+    memory-list)
+        list_memories
+        ;;
+    context-save)
+        save_context "$2"
+        ;;
+    context-load)
+        load_context
+        ;;
+    reflect)
+        output_reflection_prompt "$2"
+        ;;
     *)
         echo "Usage: phase-transition.sh <command> [args]"
         echo ""
@@ -278,5 +470,13 @@ case "$1" in
         echo "  reject                  - Record plan rejection"
         echo "  reset                   - Reset workflow state"
         echo "  status                  - Show current state"
+        echo ""
+        echo "Memory Commands (Serena-inspired):"
+        echo "  memory-save <category> <key> <value>  - Save a memory"
+        echo "  memory-read <category>                - Read memories"
+        echo "  memory-list                           - List all categories"
+        echo "  context-save <description>            - Save session context"
+        echo "  context-load                          - Load previous context"
+        echo "  reflect <phase>                       - Show reflection prompts"
         ;;
 esac

package/.claude/hooks/pre-tool-router.sh

@@ -1,12 +1,21 @@
 #!/bin/bash
 # AutoWorkflow Pre-Tool Router
 # Runs on: PreToolUse for Bash tool
-# Purpose: Route commands to appropriate checks
+# Purpose: Route commands to appropriate checks + Mode restrictions (Serena-inspired)
 #
 # This router determines what checks to run based on the command being executed
+# It also enforces task-type-aware restrictions (similar to Serena's mode switching)
 
 TOOL_INPUT="$1"
 
+# Colors
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+BOLD='\033[1m'
+DIM='\033[2m'
+NC='\033[0m'
+
 # Project directory (use env var if set, otherwise current directory)
 PROJECT_DIR="${CLAUDE_PROJECT_DIR:-.}"
 
@@ -14,6 +23,135 @@ PROJECT_DIR="${CLAUDE_PROJECT_DIR:-.}"
 STATE_DIR="$PROJECT_DIR/.claude/.autoworkflow"
 mkdir -p "$STATE_DIR"
 
+# Get current task type
+get_task_type() {
+    if [ -f "$STATE_DIR/task-type" ]; then
+        cat "$STATE_DIR/task-type"
+    else
+        echo "unknown"
+    fi
+}
+
+# Get current phase
+get_phase() {
+    if [ -f "$STATE_DIR/phase" ]; then
+        cat "$STATE_DIR/phase"
+    else
+        echo "IDLE"
+    fi
+}
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# MODE RESTRICTIONS (Serena-inspired)
+# Different task types have different allowed operations
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+# Check if command creates new files
+is_file_creation() {
+    echo "$TOOL_INPUT" | grep -qE "(touch|mkdir|>|tee|cp.*-r)"
+}
+
+# Check if command modifies package dependencies
+is_dependency_change() {
+    echo "$TOOL_INPUT" | grep -qE "(npm install|yarn add|pnpm add|pip install|go get)"
+}
+
+# Check if command runs database migrations
+is_migration() {
+    echo "$TOOL_INPUT" | grep -qE "(migrate|prisma.*push|prisma.*migrate|alembic)"
+}
+
+# Check mode restrictions based on task type
+check_mode_restrictions() {
+    local task_type=$(get_task_type)
+    local phase=$(get_phase)
+
+    case "$task_type" in
+        docs)
+            # Docs mode: Only allow documentation-related operations
+            if is_file_creation && ! echo "$TOOL_INPUT" | grep -qE "\.(md|txt|rst)"; then
+                echo ""
+                echo -e "${YELLOW}━━━ MODE RESTRICTION: docs ━━━${NC}"
+                echo ""
+                echo -e "Task type is ${BOLD}docs${NC} - creating non-documentation files requires approval."
+                echo -e "Command: ${DIM}$TOOL_INPUT${NC}"
+                echo ""
+                echo "If this is intentional, confirm with the user."
+                echo ""
+                # Warn but don't block
+            fi
+            ;;
+        fix)
+            # Fix mode: Warn on new file creation (fixes usually modify existing files)
+            if is_file_creation; then
+                echo ""
+                echo -e "${YELLOW}━━━ MODE RESTRICTION: fix ━━━${NC}"
+                echo ""
+                echo -e "Task type is ${BOLD}fix${NC} - creating new files is unusual for bug fixes."
+                echo -e "Command: ${DIM}$TOOL_INPUT${NC}"
+                echo ""
+                echo "Consider: Is this truly a fix, or should this be classified as a feature?"
+                echo ""
+            fi
+            if is_dependency_change; then
+                echo ""
+                echo -e "${YELLOW}━━━ MODE RESTRICTION: fix ━━━${NC}"
+                echo ""
+                echo -e "Task type is ${BOLD}fix${NC} - adding dependencies for a fix is unusual."
+                echo -e "Command: ${DIM}$TOOL_INPUT${NC}"
+                echo ""
+                echo "Confirm this dependency is necessary for the fix."
+                echo ""
+            fi
+            ;;
+        refactor)
+            # Refactor mode: Warn on behavior-changing operations
+            if is_migration; then
+                echo ""
+                echo -e "${YELLOW}━━━ MODE RESTRICTION: refactor ━━━${NC}"
+                echo ""
+                echo -e "Task type is ${BOLD}refactor${NC} - migrations may change behavior."
+                echo -e "Command: ${DIM}$TOOL_INPUT${NC}"
+                echo ""
+                echo "Refactoring should preserve existing behavior."
+                echo "Confirm this migration is safe."
+                echo ""
+            fi
+            ;;
+        query)
+            # Query mode: Read-only, warn on any modifications
+            if is_file_creation || is_dependency_change || is_migration; then
+                echo ""
+                echo -e "${YELLOW}━━━ MODE RESTRICTION: query ━━━${NC}"
+                echo ""
+                echo -e "Task type is ${BOLD}query${NC} - this should be read-only."
+                echo -e "Command: ${DIM}$TOOL_INPUT${NC}"
+                echo ""
+                echo "Queries should not modify the codebase."
+                echo "If modifications are needed, reclassify the task."
+                echo ""
+            fi
+            ;;
+    esac
+
+    # Phase-based restrictions
+    if [ "$phase" = "ANALYZE" ] || [ "$phase" = "PLAN" ]; then
+        if is_file_creation || is_dependency_change; then
+            echo ""
+            echo -e "${YELLOW}━━━ PHASE RESTRICTION ━━━${NC}"
+            echo ""
+            echo -e "Current phase is ${BOLD}$phase${NC} - modifications should wait for IMPLEMENT phase."
+            echo -e "Command: ${DIM}$TOOL_INPUT${NC}"
+            echo ""
+            echo "Complete planning and get approval before making changes."
+            echo ""
+        fi
+    fi
+}
+
+# Run mode restriction checks
+check_mode_restrictions
+
 # Check if this is a git commit command
 is_git_commit() {
     echo "$TOOL_INPUT" | grep -qE "git\s+commit|git\s+.*commit"

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

@@ -5,7 +5,7 @@
 #
 # This hook implements:
 # - on:conversation_start trigger
-# - on:blueprint_missing trigger (AUTO-RUN audit)
+# - on:blueprint_missing trigger (prompt user for documentation)
 # - on:init_needed trigger
 # - on:task_received trigger (task classification)
 
@@ -37,6 +37,41 @@ SESSION_RESUMED_FILE="$STATE_DIR/session-resumed"
 CURRENT_TURN_EDITS_FILE="$STATE_DIR/current-turn-edits"
 SUGGESTIONS_SHOWN_FILE="$STATE_DIR/suggestions-shown"
 
+# Memory system (Serena-inspired)
+MEMORY_DIR="$STATE_DIR/memories"
+CONTEXT_FILE="$MEMORY_DIR/context.md"
+
+# Load previous context if available (Serena-inspired)
+load_previous_context() {
+    if [ -f "$CONTEXT_FILE" ]; then
+        echo ""
+        echo -e "${CYAN}━━━ PREVIOUS SESSION CONTEXT ━━━${NC}"
+        echo ""
+        # Extract key sections from context file
+        if grep -q "## What Was Done" "$CONTEXT_FILE"; then
+            echo -e "${BOLD}What Was Done:${NC}"
+            sed -n '/## What Was Done/,/## /p' "$CONTEXT_FILE" | head -10 | tail -n +2
+            echo ""
+        fi
+        if grep -q "## What Remains" "$CONTEXT_FILE"; then
+            echo -e "${BOLD}What Remains:${NC}"
+            sed -n '/## What Remains/,/## /p' "$CONTEXT_FILE" | head -10 | tail -n +2
+            echo ""
+        fi
+        if grep -q "## Key Decisions Made" "$CONTEXT_FILE"; then
+            echo -e "${BOLD}Key Decisions:${NC}"
+            sed -n '/## Key Decisions Made/,/## /p' "$CONTEXT_FILE" | head -5 | tail -n +2
+            echo ""
+        fi
+        echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        echo ""
+        echo -e "${DIM}Full context: .claude/.autoworkflow/memories/context.md${NC}"
+        echo ""
+        return 0
+    fi
+    return 1
+}
+
 # Check for resumable session state
 check_session_resume() {
     # Only show resume prompt once per session
@@ -97,6 +132,9 @@ check_session_resume() {
             echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
             echo ""
 
+            # Load previous context if available
+            load_previous_context
+
             # Mark that we've shown the resume prompt
             touch "$SESSION_RESUMED_FILE"
             return 0
@@ -162,7 +200,7 @@ check_init_needed() {
     return 1
 }
 
-# Check for missing BLUEPRINT.md - triggers AUTO audit
+# Check for project documentation - ask user to provide their docs
 check_blueprint() {
     # Only check once per session
     if [ -f "$BLUEPRINT_CHECK_FILE" ]; then
@@ -175,31 +213,47 @@ check_blueprint() {
     if [ ! -f "instructions/BLUEPRINT.md" ]; then
         echo ""
         echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-        echo -e "${RED}${BOLD}⚠️  AUTOWORKFLOW TRIGGER: BLUEPRINT_MISSING${NC}"
+        echo -e "${YELLOW}${BOLD}📋 AUTOWORKFLOW: PROJECT DOCUMENTATION NEEDED${NC}"
         echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
         echo ""
-        echo "instructions/BLUEPRINT.md does not exist."
+        echo "No project documentation found."
         echo ""
-        echo -e "${BOLD}ACTION: RUN PROJECT AUDIT IMMEDIATELY${NC}"
+        echo -e "${BOLD}Please provide your project documentation:${NC}"
         echo ""
-        echo "Do NOT ask permission to start. Just run these commands now:"
+        echo "  ${CYAN}Option 1:${NC} Point to existing docs"
+        echo "    • PRD (Product Requirements Document)"
+        echo "    • Specification document"
+        echo "    • Userflow document"
+        echo "    • Implementation guide"
+        echo "    • Any design/architecture docs"
         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 "  ${CYAN}Option 2:${NC} Describe your project"
+        echo "    • What does this project do?"
+        echo "    • What are the main features?"
+        echo "    • What's the tech stack?"
         echo ""
-        echo "Then generate:"
-        echo "  - instructions/AI_RULES.md (tech stack, file structure)"
-        echo "  - instructions/BLUEPRINT.md (features, routes, APIs)"
+        echo "  ${CYAN}Option 3:${NC} Interactive"
+        echo "    • Say: \"Help me define my project\""
+        echo "    • I'll ask questions to understand your project"
         echo ""
-        echo -e "${YELLOW}Only ask user approval to SAVE, not to start scanning.${NC}"
+        echo -e "${DIM}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        echo ""
+        echo -e "${BOLD}When you provide documentation:${NC}"
+        echo ""
+        echo "  Your document = ${GREEN}SINGLE SOURCE OF TRUTH${NC}"
+        echo ""
+        echo "  • I will read and understand it"
+        echo "  • I will reference it for all tasks"
+        echo "  • No transformation or format conversion"
+        echo ""
+        echo -e "${DIM}Your document structure is preserved exactly as-is.${NC}"
+        echo -e "${DIM}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
         echo ""
         echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
         echo ""
 
-        # Set phase to indicate audit is needed
-        set_phase "AUDIT_REQUIRED"
+        # Set phase to indicate documentation is needed
+        set_phase "DOCS_REQUIRED"
         return 1
     fi
 
@@ -367,7 +421,9 @@ output_classification() {
 
     # 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 -e "${DIM}Reference user's documentation for requirements.${NC}"
+    echo ""
+    echo -e "${DIM}💡 Tip: Use 'phase-transition.sh memory-save decisions <key> <value>' to record decisions.${NC}"
     echo ""
     echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
     echo ""
@@ -428,7 +484,7 @@ main() {
         check_session_resume
     fi
 
-    # Check for missing blueprint (triggers auto-audit)
+    # Check for missing blueprint (prompts user for documentation)
     check_blueprint
 
     # Show current state if not idle

package/.claude/settings.json

@@ -107,7 +107,7 @@
     "→ 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)",
+    "1. **SESSION START**: If no documentation provided → Prompt user for project documentation",
     "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",
@@ -135,7 +135,7 @@
     "",
     "### Required Files",
     "- Read instructions/AI_RULES.md for coding standards",
-    "- Read instructions/BLUEPRINT.md for project state",
+    "- Reference user's documentation (single source of truth)",
     "- Read system/router.md to classify task type",
     "- Read system/gates.md for blocking rules",
     "",

package/.claude/settings.local.json

@@ -19,7 +19,13 @@
       "Bash(npm view:*)",
       "Bash(env)",
       "Bash(npx autoworkflow update)",
-      "Bash(grep:*)"
+      "Bash(grep:*)",
+      "WebFetch(domain:github.com)",
+      "WebFetch(domain:medium.com)",
+      "WebFetch(domain:apidog.com)",
+      "WebFetch(domain:mcpservers.org)",
+      "WebFetch(domain:oraios.github.io)",
+      "Bash(bash:*)"
     ]
   }
 }