claude-code-toolkit 1.0.7

package/templates/.claude/hooks/custom/intelligent-workflows.sh

@@ -0,0 +1,336 @@
+#!/bin/bash
+# HOOK: custom-intelligent-workflows
+# DESCRIPTION: AI-powered workflow automation based on file changes and project context
+# AUTHOR: Claude Code Hooks Master
+# VERSION: 1.0.0
+# TRIGGER: Manual execution or integration with file watchers
+
+set -e
+
+# Colors and logging
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+PURPLE='\033[0;35m'
+NC='\033[0m'
+
+log_info() {
+    echo -e "${BLUE}[AI]${NC} $1"
+}
+
+log_success() {
+    echo -e "${GREEN}[SUCCESS]${NC} $1"
+}
+
+log_warn() {
+    echo -e "${YELLOW}[WARN]${NC} $1"
+}
+
+log_error() {
+    echo -e "${RED}[ERROR]${NC} $1"
+}
+
+log_ai() {
+    echo -e "${PURPLE}[🤖]${NC} $1"
+}
+
+# Analyze file changes and determine appropriate actions
+analyze_changes() {
+    log_ai "Analyzing recent file changes..."
+
+    # Get recent changes (last commit or staged files)
+    local changed_files
+    if git diff --cached --name-only | head -1 > /dev/null 2>&1; then
+        # Staged changes
+        mapfile -t changed_files < <(git diff --cached --name-only)
+    else
+        # Last commit changes
+        mapfile -t changed_files < <(git diff --name-only HEAD~1 2>/dev/null || git ls-files)
+    fi
+
+    # Categorize changes
+    local categories=("ui" "api" "config" "docs" "tests" "security" "performance")
+    declare -A change_types
+
+    for category in "${categories[@]}"; do
+        change_types[$category]=0
+    done
+
+    for file in "${changed_files[@]}"; do
+        case $file in
+            *component*|*ui/*|*screen/*|*view/*)
+                ((change_types[ui]++))
+                ;;
+            *api/*|*service/*|*endpoint/*)
+                ((change_types[api]++))
+                ;;
+            *config*|*.env*|package.json|tsconfig.json)
+                ((change_types[config]++))
+                ;;
+            *README*|*.md|docs/*)
+                ((change_types[docs]++))
+                ;;
+            *.test.*|*.spec.*|test/*)
+                ((change_types[tests]++))
+                ;;
+            *auth/*|*security/*|*encrypt*)
+                ((change_types[security]++))
+                ;;
+            *performance*|*optimize*|*cache*)
+                ((change_types[performance]++))
+                ;;
+        esac
+    done
+
+    # Determine primary change type
+    local max_changes=0
+    local primary_type="general"
+
+    for category in "${!change_types[@]}"; do
+        if [ "${change_types[$category]}" -gt "$max_changes" ]; then
+            max_changes=${change_types[$category]}
+            primary_type=$category
+        fi
+    done
+
+    echo "$primary_type"
+}
+
+# Trigger appropriate Claude Code agents based on change type
+trigger_agents() {
+    local change_type="$1"
+
+    log_ai "Triggering specialized agents for $change_type changes..."
+
+    case $change_type in
+        ui)
+            log_info "UI changes detected - triggering mobile UI specialist"
+            if command -v claude_code_run_agent &> /dev/null; then
+                claude_code_run_agent "mobile-ui-specialist" "review-ui-consistency" || true
+            fi
+            ;;
+
+        security)
+            log_info "Security changes detected - triggering code reviewer"
+            if command -v claude_code_run_agent &> /dev/null; then
+                claude_code_run_agent "code-reviewer" "security-audit" || true
+            fi
+            ;;
+
+        api)
+            log_info "API changes detected - triggering documentation agent"
+            if command -v claude_code_run_agent &> /dev/null; then
+                claude_code_run_agent "doc-writer" "update-api-docs" || true
+            fi
+            ;;
+
+        tests)
+            log_info "Test changes detected - triggering testing agent"
+            if command -v claude_code_run_agent &> /dev/null; then
+                claude_code_run_agent "test-generator" "validate-test-coverage" || true
+            fi
+            ;;
+
+        config)
+            log_info "Configuration changes detected - triggering code reviewer"
+            if command -v claude_code_run_agent &> /dev/null; then
+                claude_code_run_agent "code-reviewer" "config-review" || true
+            fi
+            ;;
+
+        docs)
+            log_info "Documentation changes detected - triggering documentation agent"
+            if command -v claude_code_run_agent &> /dev/null; then
+                claude_code_run_agent "doc-writer" "validate-docs" || true
+            fi
+            ;;
+    esac
+}
+
+# Intelligent documentation updates
+smart_docs_update() {
+    local change_type="$1"
+
+    log_ai "Analyzing documentation needs..."
+
+    case $change_type in
+        api)
+            log_info "API changes - checking if README API section needs updates"
+            # Check if API documentation is outdated
+            ;;
+
+        ui)
+            log_info "UI changes - considering component documentation updates"
+            # Check component documentation
+            ;;
+
+        config)
+            log_info "Config changes - updating configuration documentation"
+            # Update config docs
+            ;;
+    esac
+}
+
+# Performance monitoring and optimization suggestions
+performance_intelligence() {
+    log_ai "Analyzing performance implications..."
+
+    # Check for potential performance issues
+    local perf_issues=()
+
+    # Large files
+    local large_files
+    mapfile -t large_files < <(find . -name "*.js" -o -name "*.ts" -o -name "*.jsx" -o -name "*.tsx" | xargs ls -lh | awk '$5 > 500000 {print $9}' | head -3)
+    if [ ${#large_files[@]} -gt 0 ]; then
+        perf_issues+=("Large files detected: ${large_files[*]}")
+    fi
+
+    # Inefficient patterns
+    if git grep -q "for.*in.*array" -- "*.js" "*.ts" "*.jsx" "*.tsx" 2>/dev/null; then
+        perf_issues+=("Inefficient array iteration patterns found")
+    fi
+
+    # Bundle analysis (if applicable)
+    if [ -f "package.json" ] && grep -q "webpack\|parcel\|vite" package.json; then
+        perf_issues+=("Consider bundle size analysis")
+    fi
+
+    if [ ${#perf_issues[@]} -gt 0 ]; then
+        log_warn "Performance considerations:"
+        for issue in "${perf_issues[@]}"; do
+            echo "  • $issue"
+        done
+
+        # Suggest Claude Code agent
+        if command -v claude_code_run_agent &> /dev/null; then
+            claude_code_run_agent "debugger" "performance-review" || true
+        fi
+    else
+        log_success "No performance concerns detected"
+    fi
+}
+
+# Learning and memory integration
+update_project_memory() {
+    log_ai "Updating project learning memory..."
+
+    local memory_dir=".claude/memory"
+    if [ ! -d "$memory_dir" ]; then
+        log_warn "Memory system not found - skipping learning updates"
+        return 0
+    fi
+
+    # Analyze patterns in recent changes
+    local recent_patterns
+    recent_patterns=$(git log --oneline -10 | grep -o -E "(feat|fix|refactor|docs|style|test)" | sort | uniq -c | sort -nr)
+
+    if echo "$recent_patterns" | grep -q "feat"; then
+        echo "## $(date) - Feature Development Pattern" >> "$memory_dir/learnings.md"
+        echo "**Pattern**: High feature development activity detected" >> "$memory_dir/learnings.md"
+        echo "**Context**: Recent commits show active feature development" >> "$memory_dir/learnings.md"
+        echo "**Suggestion**: Consider integration testing for new features" >> "$memory_dir/learnings.md"
+        echo >> "$memory_dir/learnings.md"
+    fi
+
+    log_success "Project memory updated with recent patterns"
+}
+
+# Predictive suggestions
+predictive_suggestions() {
+    log_ai "Generating predictive development suggestions..."
+
+    local suggestions=()
+
+    # Based on current changes, predict next likely steps
+    if git diff --name-only | grep -q "component.*test"; then
+        suggestions+=("Consider adding integration tests for the new component")
+    fi
+
+    if git diff --name-only | grep -q "api.*route"; then
+        suggestions+=("Don't forget to update API documentation")
+        suggestions+=("Consider adding request/response validation")
+    fi
+
+    if git diff --name-only | grep -q "config"; then
+        suggestions+=("Test configuration changes across different environments")
+    fi
+
+    if [ ${#suggestions[@]} -gt 0 ]; then
+        log_info "🤖 Predictive suggestions for next steps:"
+        for suggestion in "${suggestions[@]}"; do
+            echo "  • $suggestion"
+        done
+    fi
+}
+
+# Workflow optimization
+optimize_workflow() {
+    log_ai "Analyzing workflow optimization opportunities..."
+
+    # Check for repeated patterns that could be automated
+    local repeated_actions
+    repeated_actions=$(git log --oneline -20 | grep -o -E "(add|update|fix|refactor)" | sort | uniq -c | awk '$1 > 3 {print $2}')
+
+    if [ -n "$repeated_actions" ]; then
+        log_info "🔄 Detected repetitive actions that could be automated:"
+        echo "$repeated_actions" | while read -r action; do
+            echo "  • Frequent '$action' operations - consider creating a custom hook"
+        done
+    fi
+
+    # Suggest improvements based on commit patterns
+    if git log --oneline -10 | grep -q "WIP\|temp\|fix.*later"; then
+        log_warn "Frequent WIP commits detected - consider feature branches"
+    fi
+
+    if git log --oneline -10 | grep -q "merge.*conflict"; then
+        log_warn "Merge conflicts detected - consider smaller, focused commits"
+    fi
+}
+
+# Main execution
+main() {
+    log_ai "🧠 Claude Code Intelligent Workflows - Custom Hook"
+    echo "======================================================"
+
+    # Analyze changes
+    local change_type
+    change_type=$(analyze_changes)
+
+    log_info "Primary change type detected: $change_type"
+    echo
+
+    # Execute intelligent automations
+    trigger_agents "$change_type"
+    smart_docs_update "$change_type"
+    performance_intelligence
+    update_project_memory
+    predictive_suggestions
+    optimize_workflow
+
+    echo
+    log_success "🎉 Intelligent workflow analysis completed!"
+    log_ai "All automations triggered based on your code changes"
+}
+
+# Allow manual execution
+if [ "${1:-}" = "--manual" ]; then
+    log_info "Manual execution requested"
+    main
+elif [ "${1:-}" = "--help" ]; then
+    echo "Intelligent Workflows Hook"
+    echo "Usage: $0 [--manual] [--help]"
+    echo ""
+    echo "This hook analyzes code changes and triggers intelligent automations:"
+    echo "  - Agent triggering based on change types"
+    echo "  - Smart documentation updates"
+    echo "  - Performance analysis"
+    echo "  - Memory system updates"
+    echo "  - Predictive suggestions"
+    echo "  - Workflow optimization"
+    exit 0
+else
+    # Auto-execution mode (would be called by file watchers or CI)
+    main
+fi

package/templates/.claude/hooks/hook-manager.sh

@@ -0,0 +1,300 @@
+#!/bin/bash
+# HOOK: hook-manager
+# DESCRIPTION: Central hook management and orchestration system
+# AUTHOR: Claude Code Hooks Master
+# VERSION: 1.0.0
+
+set -e
+
+# Colors and logging
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+PURPLE='\033[0;35m'
+NC='\033[0m'
+
+log_info() {
+    echo -e "${BLUE}[HOOKS]${NC} $1"
+}
+
+log_success() {
+    echo -e "${GREEN}[SUCCESS]${NC} $1"
+}
+
+log_warn() {
+    echo -e "${YELLOW}[WARN]${NC} $1"
+}
+
+log_error() {
+    echo -e "${RED}[ERROR]${NC} $1"
+}
+
+log_ai() {
+    echo -e "${PURPLE}[🤖]${NC} $1"
+}
+
+# Hook configuration
+HOOK_DIR=".claude/hooks"
+declare -A HOOK_TYPES=(
+    ["pre-commit"]="code-quality-guardian.sh"
+    ["post-commit"]="smart-automations.sh"
+    ["pre-push"]="deployment-guardian.sh"
+    ["custom"]="intelligent-workflows.sh"
+)
+
+# Make hooks executable
+setup_hooks() {
+    log_info "Setting up Claude Code hooks..."
+
+    for hook_type in "${!HOOK_TYPES[@]}"; do
+        local hook_file="$HOOK_DIR/$hook_type/${HOOK_TYPES[$hook_type]}"
+
+        if [ -f "$hook_file" ]; then
+            chmod +x "$hook_file"
+            log_success "Made $hook_type hook executable"
+        else
+            log_warn "Hook file not found: $hook_file"
+        fi
+    done
+
+    log_success "Hook setup completed"
+}
+
+# Install git hooks
+install_git_hooks() {
+    log_info "Installing Git hooks integration..."
+
+    local git_hooks_dir=".git/hooks"
+    if [ ! -d "$git_hooks_dir" ]; then
+        log_error "Git repository not found - cannot install hooks"
+        return 1
+    fi
+
+    # Create pre-commit hook
+    cat > "$git_hooks_dir/pre-commit" << 'EOF'
+#!/bin/bash
+# Claude Code Pre-commit Hook
+
+# Get the directory where this script is located
+HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/../../.claude/hooks"
+PRE_COMMIT_HOOK="$HOOK_DIR/pre-commit/code-quality-guardian.sh"
+
+if [ -x "$PRE_COMMIT_HOOK" ]; then
+    echo "Running Claude Code pre-commit quality checks..."
+    if ! "$PRE_COMMIT_HOOK"; then
+        echo "Pre-commit checks failed. Please fix issues and try again."
+        exit 1
+    fi
+else
+    echo "Warning: Claude Code pre-commit hook not found or not executable"
+fi
+EOF
+
+    # Create post-commit hook
+    cat > "$git_hooks_dir/post-commit" << 'EOF'
+#!/bin/bash
+# Claude Code Post-commit Hook
+
+HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/../../.claude/hooks"
+POST_COMMIT_HOOK="$HOOK_DIR/post-commit/smart-automations.sh"
+
+if [ -x "$POST_COMMIT_HOOK" ]; then
+    echo "Running Claude Code post-commit automations..."
+    "$POST_COMMIT_HOOK" &
+else
+    echo "Warning: Claude Code post-commit hook not found"
+fi
+EOF
+
+    # Create pre-push hook
+    cat > "$git_hooks_dir/pre-push" << 'EOF'
+#!/bin/bash
+# Claude Code Pre-push Hook
+
+HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/../../.claude/hooks"
+PRE_PUSH_HOOK="$HOOK_DIR/pre-push/deployment-guardian.sh"
+
+if [ -x "$PRE_PUSH_HOOK" ]; then
+    echo "Running Claude Code pre-push deployment checks..."
+    if ! "$PRE_PUSH_HOOK"; then
+        echo "Pre-push checks failed. Please fix issues and try again."
+        exit 1
+    fi
+else
+    echo "Warning: Claude Code pre-push hook not found or not executable"
+fi
+EOF
+
+    # Make git hooks executable
+    chmod +x "$git_hooks_dir/pre-commit"
+    chmod +x "$git_hooks_dir/post-commit"
+    chmod +x "$git_hooks_dir/pre-push"
+
+    log_success "Git hooks installed successfully"
+    log_info "Hooks will now run automatically on git operations"
+}
+
+# Test all hooks
+test_hooks() {
+    log_info "Testing all Claude Code hooks..."
+
+    local test_results=()
+
+    for hook_type in "${!HOOK_TYPES[@]}"; do
+        local hook_file="$HOOK_DIR/$hook_type/${HOOK_TYPES[$hook_type]}"
+
+        if [ -f "$hook_file" ]; then
+            log_info "Testing $hook_type hook..."
+
+            # Basic syntax check
+            if bash -n "$hook_file" 2>/dev/null; then
+                log_success "$hook_type hook syntax is valid"
+                test_results+=("$hook_type: PASS")
+            else
+                log_error "$hook_type hook has syntax errors"
+                test_results+=("$hook_type: FAIL - Syntax Error")
+            fi
+
+            # Check if executable
+            if [ -x "$hook_file" ]; then
+                log_success "$hook_type hook is executable"
+            else
+                log_warn "$hook_type hook is not executable"
+            fi
+        else
+            log_error "$hook_type hook file not found: $hook_file"
+            test_results+=("$hook_type: FAIL - Missing")
+        fi
+    done
+
+    echo
+    log_info "Hook Test Results:"
+    for result in "${test_results[@]}"; do
+        echo "  $result"
+    done
+
+    # Check for failures
+    if echo "${test_results[@]}" | grep -q "FAIL"; then
+        log_error "Some hooks have issues - please fix before using"
+        return 1
+    else
+        log_success "All hooks are properly configured!"
+    fi
+}
+
+# Run specific hook manually
+run_hook() {
+    local hook_type="$1"
+
+    if [ -z "$hook_type" ]; then
+        log_error "Please specify a hook type to run"
+        echo "Available hooks: ${!HOOK_TYPES[*]}"
+        return 1
+    fi
+
+    if [ -z "${HOOK_TYPES[$hook_type]}" ]; then
+        log_error "Unknown hook type: $hook_type"
+        echo "Available hooks: ${!HOOK_TYPES[*]}"
+        return 1
+    fi
+
+    local hook_file="$HOOK_DIR/$hook_type/${HOOK_TYPES[$hook_type]}"
+
+    if [ ! -f "$hook_file" ]; then
+        log_error "Hook file not found: $hook_file"
+        return 1
+    fi
+
+    if [ ! -x "$hook_file" ]; then
+        log_error "Hook file is not executable: $hook_file"
+        return 1
+    fi
+
+    log_info "Running $hook_type hook manually..."
+    "$hook_file"
+}
+
+# Show hook status
+status() {
+    log_info "Claude Code Hooks Status"
+    echo "=========================="
+
+    for hook_type in "${!HOOK_TYPES[@]}"; do
+        local hook_file="$HOOK_DIR/$hook_type/${HOOK_TYPES[$hook_type]}"
+
+        echo
+        echo "$hook_type hook:"
+        echo "  File: $hook_file"
+
+        if [ -f "$hook_file" ]; then
+            echo "  Status: ✅ Exists"
+
+            if [ -x "$hook_file" ]; then
+                echo "  Executable: ✅ Yes"
+            else
+                echo "  Executable: ❌ No"
+            fi
+
+            # Check git hook integration
+            local git_hook=".git/hooks/$hook_type"
+            if [ -x "$git_hook" ] && [ -f "$git_hook" ]; then
+                echo "  Git Integration: ✅ Installed"
+            else
+                echo "  Git Integration: ❌ Not installed"
+            fi
+        else
+            echo "  Status: ❌ Missing"
+        fi
+    done
+
+    echo
+    log_info "Quick Actions:"
+    echo "  Setup hooks: $0 setup"
+    echo "  Install git hooks: $0 install"
+    echo "  Test hooks: $0 test"
+    echo "  Run hook: $0 run <hook-type>"
+}
+
+# Main command dispatcher
+main() {
+    case "${1:-}" in
+        setup)
+            setup_hooks
+            ;;
+        install)
+            install_git_hooks
+            ;;
+        test)
+            test_hooks
+            ;;
+        run)
+            run_hook "$2"
+            ;;
+        status|"")
+            status
+            ;;
+        help|--help|-h)
+            echo "Claude Code Hooks Manager"
+            echo "Usage: $0 <command> [options]"
+            echo ""
+            echo "Commands:"
+            echo "  setup     - Make all hooks executable"
+            echo "  install   - Install git hooks integration"
+            echo "  test      - Test all hooks for issues"
+            echo "  run <type> - Run specific hook manually"
+            echo "  status     - Show hooks status (default)"
+            echo "  help       - Show this help"
+            echo ""
+            echo "Hook Types: ${!HOOK_TYPES[*]}"
+            ;;
+        *)
+            log_error "Unknown command: $1"
+            echo "Run '$0 help' for usage information"
+            exit 1
+            ;;
+    esac
+}
+
+# Run main function
+main "$@"