@localtech/claude-code-toolkit 1.0.3 → 1.0.5

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

package/templates/.claude/hooks/pre-commit/code-quality-guardian.sh

@@ -0,0 +1,257 @@
+#!/bin/bash
+# HOOK: pre-commit-code-quality-guardian
+# DESCRIPTION: Comprehensive code quality checks before commits
+# AUTHOR: Claude Code Hooks Master
+# VERSION: 1.0.0
+# DEPENDS: node, npm, eslint, prettier, typescript
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+# Logging functions
+log_info() {
+    echo -e "${BLUE}[QUALITY]${NC} $1"
+}
+
+log_success() {
+    echo -e "${GREEN}[PASS]${NC} $1"
+}
+
+log_warn() {
+    echo -e "${YELLOW}[WARN]${NC} $1"
+}
+
+log_error() {
+    echo -e "${RED}[FAIL]${NC} $1"
+}
+
+# Timer function
+start_timer() {
+    start_time=$(date +%s)
+}
+
+end_timer() {
+    end_time=$(date +%s)
+    duration=$((end_time - start_time))
+    echo -e "${BLUE}[TIME]${NC} Completed in ${duration}s"
+}
+
+# Check if file exists and is executable
+check_dependency() {
+    if ! command -v "$1" &> /dev/null; then
+        log_error "Required dependency '$1' not found"
+        return 1
+    fi
+    return 0
+}
+
+# Get staged files for analysis
+get_staged_files() {
+    git diff --cached --name-only --diff-filter=ACM | grep -E '\.(js|ts|jsx|tsx|vue|svelte)$' || true
+}
+
+# Lint staged files
+run_linter() {
+    local files=("$@")
+    if [ ${#files[@]} -eq 0 ]; then
+        log_info "No JavaScript/TypeScript files to lint"
+        return 0
+    fi
+
+    log_info "Running ESLint on ${#files[@]} files..."
+    start_timer
+
+    if npx eslint "${files[@]}" --quiet; then
+        log_success "ESLint checks passed"
+        end_timer
+        return 0
+    else
+        log_error "ESLint found issues. Please fix them before committing."
+        log_info "Tip: Run 'npx eslint --fix' to auto-fix some issues"
+        return 1
+    fi
+}
+
+# Format staged files
+run_formatter() {
+    local files=("$@")
+    if [ ${#files[@]} -eq 0 ]; then
+        log_info "No files to format"
+        return 0
+    fi
+
+    log_info "Running Prettier on ${#files[@]} files..."
+    start_timer
+
+    if npx prettier --check "${files[@]}"; then
+        log_success "Code formatting is correct"
+        end_timer
+        return 0
+    else
+        log_error "Code formatting issues found."
+        log_info "Tip: Run 'npx prettier --write' to auto-format"
+        return 1
+    fi
+}
+
+# Type checking for TypeScript
+run_type_check() {
+    if [ -f "tsconfig.json" ]; then
+        log_info "Running TypeScript type checking..."
+        start_timer
+
+        if npx tsc --noEmit; then
+            log_success "TypeScript compilation successful"
+            end_timer
+            return 0
+        else
+            log_error "TypeScript errors found. Please fix type issues."
+            return 1
+        fi
+    else
+        log_info "No tsconfig.json found, skipping TypeScript checks"
+        return 0
+    fi
+}
+
+# Security vulnerability check
+run_security_check() {
+    log_info "Running security vulnerability check..."
+    start_timer
+
+    # Check for common security issues
+    local staged_files
+    mapfile -t staged_files < <(get_staged_files)
+
+    local has_security_issues=false
+
+    for file in "${staged_files[@]}"; do
+        # Check for console.log in production code
+        if grep -q "console\." "$file" && [[ "$file" != *".test."* ]] && [[ "$file" != *".spec."* ]]; then
+            log_warn "console statements found in $file (remove for production)"
+            has_security_issues=true
+        fi
+
+        # Check for debugger statements
+        if grep -q "debugger" "$file"; then
+            log_warn "debugger statement found in $file"
+            has_security_issues=true
+        fi
+
+        # Check for potential secrets
+        if grep -i -q "password\|secret\|token\|key" "$file" && grep -q "=" "$file"; then
+            log_warn "Potential secret exposure in $file - review carefully"
+            has_security_issues=true
+        fi
+    done
+
+    if [ "$has_security_issues" = false ]; then
+        log_success "Security check passed"
+    fi
+
+    end_timer
+    return 0  # Don't fail commit for warnings
+}
+
+# Performance check
+run_performance_check() {
+    log_info "Running basic performance checks..."
+    start_timer
+
+    local staged_files
+    mapfile -t staged_files < <(get_staged_files)
+
+    local has_performance_issues=false
+
+    for file in "${staged_files[@]}"; do
+        # Check bundle size for large files
+        local file_size
+        file_size=$(stat -f%z "$file" 2>/dev/null || stat -c%s "$file" 2>/dev/null || echo "0")
+
+        if [ "$file_size" -gt 1000000 ]; then # 1MB
+            log_warn "Large file detected: $file (${file_size} bytes)"
+            has_performance_issues=true
+        fi
+
+        # Check for inefficient patterns
+        if grep -q "for.*in.*array\|for.*in.*object" "$file"; then
+            log_warn "Potential inefficient loop in $file - consider alternatives"
+            has_performance_issues=true
+        fi
+    done
+
+    if [ "$has_performance_issues" = false ]; then
+        log_success "Performance check passed"
+    fi
+
+    end_timer
+    return 0
+}
+
+# Main execution
+main() {
+    log_info "🛡️  Claude Code Quality Guardian - Pre-commit Hook"
+    echo "=================================================="
+
+    # Check dependencies
+    local deps=("node" "npm" "npx")
+    for dep in "${deps[@]}"; do
+        if ! check_dependency "$dep"; then
+            log_error "Missing required dependency: $dep"
+            exit 1
+        fi
+    done
+
+    # Get staged files
+    local staged_files
+    mapfile -t staged_files < <(get_staged_files)
+
+    if [ ${#staged_files[@]} -eq 0 ]; then
+        log_info "No JavaScript/TypeScript files staged for commit"
+        exit 0
+    fi
+
+    log_info "Checking ${#staged_files[@]} files: ${staged_files[*]}"
+    echo
+
+    # Run all quality checks
+    local checks_passed=true
+
+    if ! run_linter "${staged_files[@]}"; then
+        checks_passed=false
+    fi
+
+    if ! run_formatter "${staged_files[@]}"; then
+        checks_passed=false
+    fi
+
+    if ! run_type_check; then
+        checks_passed=false
+    fi
+
+    run_security_check
+    run_performance_check
+
+    echo
+    if [ "$checks_passed" = true ]; then
+        log_success "🎉 All quality checks passed! Your code is ready for commit."
+        exit 0
+    else
+        log_error "❌ Quality checks failed. Please fix the issues and try again."
+        echo
+        log_info "Quick fixes:"
+        echo "  • Run 'npx eslint --fix' to auto-fix linting issues"
+        echo "  • Run 'npx prettier --write' to auto-format code"
+        echo "  • Check TypeScript errors with 'npx tsc --noEmit'"
+        exit 1
+    fi
+}
+
+# Run main function
+main "$@"