@localtech/claude-code-toolkit 1.0.3 → 1.0.4

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 "$@"

package/templates/.claude/hooks/post-commit/smart-automations.sh

@@ -0,0 +1,249 @@
+#!/bin/bash
+# HOOK: post-commit-smart-automations
+# DESCRIPTION: Intelligent post-commit automations for documentation, notifications, and workflow optimization
+# AUTHOR: Claude Code Hooks Master
+# VERSION: 1.0.0
+
+set -e
+
+# Colors for output
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+NC='\033[0m'
+
+log_info() {
+    echo -e "${BLUE}[AUTO]${NC} $1"
+}
+
+log_success() {
+    echo -e "${GREEN}[DONE]${NC} $1"
+}
+
+log_warn() {
+    echo -e "${YELLOW}[WARN]${NC} $1"
+}
+
+# Get commit information
+get_commit_info() {
+    COMMIT_HASH=$(git rev-parse HEAD)
+    COMMIT_MSG=$(git log -1 --pretty=%B)
+    COMMIT_AUTHOR=$(git log -1 --pretty=%an)
+    COMMIT_EMAIL=$(git log -1 --pretty=%ae)
+    CHANGED_FILES=$(git diff --name-only HEAD~1)
+}
+
+# Analyze commit type and impact
+analyze_commit_impact() {
+    local commit_msg="$1"
+    local changed_files="$2"
+
+    # Determine commit type
+    if echo "$commit_msg" | grep -q -i "feat\|feature\|add"; then
+        COMMIT_TYPE="feature"
+    elif echo "$commit_msg" | grep -q -i "fix\|bug\|hotfix"; then
+        COMMIT_TYPE="fix"
+    elif echo "$commit_msg" | grep -q -i "docs\|documentation"; then
+        COMMIT_TYPE="docs"
+    elif echo "$commit_msg" | grep -q -i "test\|spec"; then
+        COMMIT_TYPE="test"
+    elif echo "$commit_msg" | grep -q -i "refactor\|style"; then
+        COMMIT_TYPE="refactor"
+    else
+        COMMIT_TYPE="other"
+    fi
+
+    # Determine impact level
+    if echo "$changed_files" | grep -q -E "(package\.json|core|config|src/index)"; then
+        IMPACT_LEVEL="high"
+    elif echo "$changed_files" | grep -q -E "(src/|components/|api/)"; then
+        IMPACT_LEVEL="medium"
+    else
+        IMPACT_LEVEL="low"
+    fi
+}
+
+# Documentation automation
+run_docs_automation() {
+    log_info "Running documentation automation..."
+
+    # Check if documentation needs updating
+    if echo "$CHANGED_FILES" | grep -q -E "\.(js|ts|py)$"; then
+        log_info "Code changes detected - checking documentation needs..."
+
+        # Trigger Claude Code documentation skill
+        if command -v claude_code_run_skill &> /dev/null; then
+            log_info "Using Claude Code documentation skill..."
+            claude_code_run_skill "professional-documentation-writer" "update-api-docs" || true
+        else
+            log_warn "Claude Code skills not available - skipping automated docs"
+        fi
+    fi
+
+    # Update README if necessary
+    if echo "$CHANGED_FILES" | grep -q -E "(README|readme)"; then
+        log_info "README changes detected - validating format..."
+        # Could add README validation here
+    fi
+
+    log_success "Documentation automation completed"
+}
+
+# Memory system integration
+update_memory_system() {
+    log_info "Updating project memory system..."
+
+    local memory_dir=".claude/memory"
+    if [ ! -d "$memory_dir" ]; then
+        log_warn "Memory system not found - skipping memory updates"
+        return 0
+    fi
+
+    # Add to decisions memory for architectural decisions
+    if echo "$COMMIT_MSG" | grep -q -i "decision\|architect\|design"; then
+        {
+            echo "## $(date '+%Y-%m-%d %H:%M:%S') - Architecture Decision"
+            echo "**Decision**: $COMMIT_MSG"
+            echo "**Files Changed**: $CHANGED_FILES"
+            echo "**Impact**: $IMPACT_LEVEL"
+            echo
+        } >> "$memory_dir/decisions.md"
+        log_success "Added to decisions memory"
+    fi
+
+    # Add to learnings memory for insights
+    if echo "$COMMIT_MSG" | grep -q -i "learn\|discover\|find\|improve"; then
+        {
+            echo "## $(date '+%Y-%m-%d %H:%M:%S') - Development Learning"
+            echo "**Insight**: $COMMIT_MSG"
+            echo "**Context**: Commit $COMMIT_HASH"
+            echo "**Files**: $CHANGED_FILES"
+            echo
+        } >> "$memory_dir/learnings.md"
+        log_success "Added to learnings memory"
+    fi
+
+    # Update context with recent changes
+    {
+        echo "## Recent Changes"
+        echo "- $(date '+%Y-%m-%d'): $COMMIT_MSG"
+        echo "  - Type: $COMMIT_TYPE, Impact: $IMPACT_LEVEL"
+        echo "  - Files: $(echo "$CHANGED_FILES" | wc -l) files changed"
+    } >> "$memory_dir/context.md"
+}
+
+# Notification system
+send_notifications() {
+    log_info "Sending notifications..."
+
+    # Skip notifications for low-impact changes
+    if [ "$IMPACT_LEVEL" = "low" ] && [ "$COMMIT_TYPE" = "other" ]; then
+        log_info "Low-impact change - skipping notifications"
+        return 0
+    fi
+
+    # In a real implementation, you would integrate with:
+    # - Slack/Discord webhooks
+    # - Email notifications
+    # - Project management tools (Jira, Linear, etc.)
+    # - CI/CD status updates
+
+    log_info "Would notify team about: $COMMIT_TYPE change ($IMPACT_LEVEL impact)"
+    log_info "Commit: $COMMIT_HASH by $COMMIT_AUTHOR"
+
+    # Example notification payload (you would send this to your notification service)
+    local notification_data="{
+        \"commit\": \"$COMMIT_HASH\",
+        \"author\": \"$COMMIT_AUTHOR\",
+        \"message\": \"$COMMIT_MSG\",
+        \"type\": \"$COMMIT_TYPE\",
+        \"impact\": \"$IMPACT_LEVEL\",
+        \"files_changed\": $(echo "$CHANGED_FILES" | wc -l)
+    }"
+
+    # For now, just log what would be sent
+    log_success "Notification prepared (integrate with your notification service)"
+}
+
+# Backup automation
+run_backup_automation() {
+    # Only backup for significant changes
+    if [ "$IMPACT_LEVEL" != "high" ]; then
+        return 0
+    fi
+
+    log_info "Running backup automation for high-impact change..."
+
+    local backup_dir=".claude/backups"
+    mkdir -p "$backup_dir"
+
+    local timestamp=$(date '+%Y%m%d_%H%M%S')
+    local backup_file="$backup_dir/backup_$timestamp.tar.gz"
+
+    # Create backup of critical files
+    if [ -d "src" ] && [ -d "package.json" ]; then
+        tar -czf "$backup_file" src/ package.json tsconfig.json 2>/dev/null || true
+        log_success "Backup created: $backup_file"
+    fi
+}
+
+# Performance monitoring
+update_performance_metrics() {
+    local metrics_file=".claude/metrics/commit-metrics.json"
+
+    mkdir -p "$(dirname "$metrics_file")"
+
+    # Calculate some basic metrics
+    local commit_size=$(echo "$CHANGED_FILES" | wc -l)
+    local test_files=$(echo "$CHANGED_FILES" | grep -c "\.test\." || echo "0")
+    local config_files=$(echo "$CHANGED_FILES" | grep -c -E "(package\.json|config|\.env)" || echo "0")
+
+    # Create/update metrics
+    local metrics="{
+        \"timestamp\": \"$(date -Iseconds)\",
+        \"commit_hash\": \"$COMMIT_HASH\",
+        \"commit_type\": \"$COMMIT_TYPE\",
+        \"impact_level\": \"$IMPACT_LEVEL\",
+        \"files_changed\": $commit_size,
+        \"test_files\": $test_files,
+        \"config_files\": $config_files,
+        \"author\": \"$COMMIT_AUTHOR\"
+    }"
+
+    echo "$metrics" >> "$metrics_file"
+    log_success "Performance metrics updated"
+}
+
+# Main execution
+main() {
+    log_info "🤖 Claude Code Smart Automations - Post-commit Hook"
+    echo "======================================================="
+
+    # Get commit information
+    get_commit_info
+
+    # Analyze commit
+    analyze_commit_impact "$COMMIT_MSG" "$CHANGED_FILES"
+
+    log_info "Commit Analysis:"
+    echo "  Type: $COMMIT_TYPE"
+    echo "  Impact: $IMPACT_LEVEL"
+    echo "  Author: $COMMIT_AUTHOR"
+    echo "  Files: $(echo "$CHANGED_FILES" | wc -l)"
+    echo
+
+    # Run automations based on commit characteristics
+    run_docs_automation
+    update_memory_system
+    send_notifications
+    run_backup_automation
+    update_performance_metrics
+
+    echo
+    log_success "🎉 All post-commit automations completed successfully!"
+    log_info "Commit $COMMIT_HASH processed and automated workflows triggered"
+}
+
+# Run main function
+main "$@"