aidevops 2.52.1

package/.agent/scripts/markdown-formatter.sh

@@ -0,0 +1,338 @@
+#!/bin/bash
+# shellcheck disable=SC2034,SC2155,SC2317,SC2329,SC2016,SC2181,SC1091,SC2154,SC2015,SC2086,SC2129,SC2030,SC2031,SC2119,SC2120,SC2001,SC2162,SC2088,SC2089,SC2090,SC2029,SC2006,SC2153
+
+# Markdown Formatter Script
+# Automatically fix common Codacy markdown formatting issues
+#
+# Usage: ./markdown-formatter.sh [file|directory]
+# 
+# Common fixes applied:
+# - Add blank lines around headers
+# - Add blank lines around code blocks
+# - Add blank lines around lists
+# - Remove trailing whitespace
+# - Fix inconsistent list markers
+# - Add language specifiers to code blocks
+# - Fix header spacing
+# - Normalize emphasis markers
+#
+# Author: AI DevOps Framework
+# Version: 1.1.1
+# License: MIT
+
+# Colors for output
+readonly GREEN='\033[0;32m'
+readonly BLUE='\033[0;34m'
+readonly YELLOW='\033[1;33m'
+readonly RED='\033[0;31m'
+readonly PURPLE='\033[0;35m'
+readonly NC='\033[0m' # No Color
+
+# Common constants
+readonly ERROR_UNKNOWN_COMMAND="Unknown command:"
+# Print functions
+print_success() {
+    local message="$1"
+    echo -e "${GREEN}✅ $message${NC}"
+    return 0
+}
+
+print_info() {
+    local message="$1"
+    echo -e "${BLUE}ℹ️  $message${NC}"
+    return 0
+}
+
+print_warning() {
+    local message="$1"
+    echo -e "${YELLOW}⚠️  $message${NC}"
+    return 0
+}
+
+print_error() {
+    local message="$1"
+    echo -e "${RED}❌ $message${NC}" >&2
+    return 0
+}
+
+print_header() {
+    local message="$1"
+    echo -e "${PURPLE}📝 $message${NC}"
+    return 0
+}
+
+# Fix markdown formatting in a single file
+fix_markdown_file() {
+    local file="$1"
+    local temp_file
+    temp_file=$(mktemp)
+    local changes_made=0
+    
+    print_info "Processing: $file"
+    
+    # Create backup
+    cp "$file" "${file}.bak"
+    
+    # Apply simple, safe fixes
+    {
+        # Remove trailing whitespace
+        sed 's/[[:space:]]*$//' "$file" |
+
+        # Fix inconsistent list markers (use - for unordered lists)
+        sed 's/^[[:space:]]*\*[[:space:]]/- /' |
+        sed 's/^[[:space:]]*+[[:space:]]/- /' |
+
+        # Fix emphasis - use ** for bold, * for italic consistently
+        sed 's/__\([^_]*\)__/**\1**/g' |             # Convert __ to **
+
+        # Remove multiple consecutive blank lines (max 2)
+        awk '
+        BEGIN { blank_count = 0 }
+        /^[[:space:]]*$/ {
+            blank_count++
+            if (blank_count <= 2) print
+            next
+        }
+        { blank_count = 0; print }'
+
+    } > "$temp_file"
+    
+    # Check if changes were made
+    if ! cmp -s "$file" "$temp_file"; then
+        mv "$temp_file" "$file"
+        changes_made=1
+        print_success "Fixed formatting in: $file"
+    else
+        rm "$temp_file"
+        print_info "No changes needed: $file"
+    fi
+    
+    # Remove backup if no changes were made
+    if [[ $changes_made -eq 0 ]]; then
+        rm "${file}.bak"
+    fi
+    
+    return $changes_made
+    return 0
+}
+
+# Process directory recursively
+process_directory() {
+    local dir="$1"
+    local total_files=0
+    local changed_files=0
+
+    print_header "Processing markdown files in: $dir"
+
+    # Find all markdown files
+    while IFS= read -r -d '' file; do
+        ((total_files++))
+        if fix_markdown_file "$file"; then
+            ((changed_files++))
+        fi
+    done < <(find "$dir" -name "*.md" -type f -print0)
+
+    echo ""
+    print_info "Summary: $changed_files/$total_files files modified"
+
+    if [[ $changed_files -gt 0 ]]; then
+        print_success "Markdown formatting fixes applied successfully"
+        print_info "Backup files created with .bak extension"
+        return 0
+    else
+        print_info "No formatting issues found"
+        return 0
+    fi
+    return 0
+}
+
+# Advanced markdown fixes
+apply_advanced_fixes() {
+    local file="$1"
+    local temp_file
+    temp_file=$(mktemp)
+
+    print_info "Applying advanced fixes to: $file"
+
+    # Advanced fixes using Python-like logic with awk
+    awk '
+    BEGIN {
+        in_code_block = 0
+        prev_was_header = 0
+        prev_was_list = 0
+    }
+
+    # Track code blocks
+    /^```/ {
+        in_code_block = !in_code_block
+        print
+        next
+    }
+
+    # Skip processing inside code blocks
+    in_code_block {
+        print
+        next
+    }
+
+    # Fix table formatting
+    /\|.*\|/ {
+        # Ensure spaces around pipes in tables
+        gsub(/\|/, " | ")
+        gsub(/  \|  /, " | ")
+        gsub(/^ \| /, "| ")
+        gsub(/ \| $/, " |")
+    }
+
+    # Fix link formatting
+    {
+        # Fix spaces in link text
+        gsub(/\[\s+/, "[")
+        gsub(/\s+\]/, "]")
+
+        # Fix spaces around link URLs
+        gsub(/\]\s*\(/, "](")
+        gsub(/\(\s+/, "(")
+        gsub(/\s+\)/, ")")
+    }
+
+    # Fix emphasis spacing
+    {
+        # Remove spaces inside emphasis
+        gsub(/\*\s+/, "*")
+        gsub(/\s+\*/, "*")
+        gsub(/\*\*\s+/, "**")
+        gsub(/\s+\*\*/, "**")
+    }
+
+    # Print the line
+    { print }
+    ' "$file" > "$temp_file"
+
+    # Replace original if different
+    if ! cmp -s "$file" "$temp_file"; then
+        mv "$temp_file" "$file"
+        print_success "Applied advanced fixes to: $file"
+        return 0
+    else
+        rm "$temp_file"
+        return 1
+    fi
+    return 0
+}
+
+# Clean up backup files
+cleanup_backups() {
+    local target="${1:-.}"
+
+    print_header "Cleaning up backup files"
+
+    local backup_count
+    backup_count=$(find "$target" -name "*.md.bak" -type f | wc -l)
+
+    if [[ $backup_count -gt 0 ]]; then
+        print_info "Found $backup_count backup files"
+        read -r -p "Remove all .md.bak files? (y/N): " confirm
+
+        if [[ $confirm =~ ^[Yy]$ ]]; then
+            find "$target" -name "*.md.bak" -type f -delete
+            print_success "Removed $backup_count backup files"
+        else
+            print_info "Backup files preserved"
+        fi
+    else
+        print_info "No backup files found"
+    fi
+    return 0
+}
+
+# Show help message
+show_help() {
+    print_header "Markdown Formatter Help"
+    echo ""
+    echo "Usage: $0 [command] [target]"
+    echo ""
+    echo "Commands:"
+    echo "  format [file|dir]    - Format markdown files (default)"
+    echo "  advanced [file|dir]  - Apply advanced formatting fixes"
+    echo "  cleanup [dir]        - Remove backup files"
+    echo "  help                 - Show this help message"
+    echo ""
+    echo "Examples:"
+    echo "  $0 README.md"
+    echo "  $0 format .agent/"
+    echo "  $0 advanced ."
+    echo "  $0 cleanup"
+    echo ""
+    echo "Common fixes applied:"
+    echo "  • Add blank lines around headers, code blocks, lists"
+    echo "  • Remove trailing whitespace"
+    echo "  • Fix inconsistent list markers (use -)"
+    echo "  • Normalize emphasis markers (** for bold, * for italic)"
+    echo "  • Add language specifiers to code blocks"
+    echo "  • Fix header spacing"
+    echo "  • Remove excessive blank lines"
+    echo "  • Fix table formatting"
+    echo "  • Fix link and emphasis spacing"
+    echo ""
+    echo "Backup files (.bak) are created for all modified files."
+    return 0
+}
+
+# Main function
+main() {
+    local _arg1="$1"
+    local command="${1:-format}"
+    local target="${2:-.}"
+
+    # Handle case where first argument is a file/directory
+    if [[ -f "$_arg1" || -d "$_arg1" ]]; then
+        command="format"
+        target="$_arg1"
+    fi
+
+    case "$command" in
+        "format")
+            if [[ -f "$target" ]]; then
+                if [[ "$target" == *.md ]]; then
+                    fix_markdown_file "$target"
+                else
+                    print_error "File is not a markdown file: $target"
+                    return 1
+                fi
+            elif [[ -d "$target" ]]; then
+                process_directory "$target"
+            else
+                print_error "Target not found: $target"
+                return 1
+            fi
+            ;;
+        "advanced")
+            if [[ -f "$target" && "$target" == *.md ]]; then
+                apply_advanced_fixes "$target"
+            elif [[ -d "$target" ]]; then
+                find "$target" -name "*.md" -type f | while read -r file; do
+                    apply_advanced_fixes "$file"
+                done
+            else
+                print_error "Invalid target for advanced fixes: $target"
+                return 1
+            fi
+            ;;
+        "cleanup")
+            cleanup_backups "$target"
+            ;;
+        "help"|"--help"|"-h")
+            show_help
+            ;;
+        *)
+            print_error "$ERROR_UNKNOWN_COMMAND $command"
+            show_help
+            return 1
+            ;;
+    esac
+    return 0
+}
+
+# Execute main function with all arguments
+main "$@"

package/.agent/scripts/markdown-lint-fix.sh

@@ -0,0 +1,311 @@
+#!/bin/bash
+# shellcheck disable=SC2034,SC2155,SC2317,SC2329,SC2016,SC2181,SC1091,SC2154,SC2015,SC2086,SC2129,SC2030,SC2031,SC2119,SC2120,SC2001,SC2162,SC2088,SC2089,SC2090,SC2029,SC2006,SC2153
+
+# Markdown Lint Fix Script
+# Fix common Codacy markdown issues using markdownlint-cli
+#
+# Usage: ./markdown-lint-fix.sh [file|directory]
+#
+# Author: AI DevOps Framework
+# Version: 1.1.1
+# License: MIT
+
+# Colors for output
+readonly GREEN='\033[0;32m'
+readonly BLUE='\033[0;34m'
+readonly YELLOW='\033[1;33m'
+readonly RED='\033[0;31m'
+readonly PURPLE='\033[0;35m'
+readonly NC='\033[0m' # No Color
+
+# Common constants
+readonly ERROR_UNKNOWN_COMMAND="Unknown command:"
+# Print functions
+print_success() {
+    local message="$1"
+    echo -e "${GREEN}✅ $message${NC}"
+    return 0
+}
+
+print_info() {
+    local message="$1"
+    echo -e "${BLUE}ℹ️  $message${NC}"
+    return 0
+}
+
+print_warning() {
+    local message="$1"
+    echo -e "${YELLOW}⚠️  $message${NC}"
+    return 0
+}
+
+print_error() {
+    local message="$1"
+    echo -e "${RED}❌ $message${NC}" >&2
+    return 0
+}
+
+print_header() {
+    local message="$1"
+    echo -e "${PURPLE}📝 $message${NC}"
+    return 0
+}
+
+# Check if markdownlint-cli is installed
+check_markdownlint() {
+    if command -v markdownlint &> /dev/null; then
+        return 0
+    else
+        return 1
+    fi
+    return 0
+}
+
+# Install markdownlint-cli
+install_markdownlint() {
+    print_header "Installing markdownlint-cli"
+    
+    if command -v npm &> /dev/null; then
+        # Use --ignore-scripts to prevent execution of postinstall scripts for security
+        print_info "Installing markdownlint-cli via npm..."
+        npm install -g --ignore-scripts markdownlint-cli
+        
+        if check_markdownlint; then
+            print_success "markdownlint-cli installed successfully"
+            return 0
+        else
+            print_error "Installation failed"
+            return 1
+        fi
+    else
+        print_error "npm not found. Please install Node.js and npm first."
+        print_info "Visit: https://nodejs.org/"
+        return 1
+    fi
+    return 0
+}
+
+# Create markdownlint configuration
+create_markdownlint_config() {
+    local config_file=".markdownlint.json"
+    
+    if [[ -f "$config_file" ]]; then
+        print_info "markdownlint config already exists: $config_file"
+        return 0
+    fi
+    
+    print_info "Creating markdownlint configuration: $config_file"
+    
+    cat > "$config_file" << 'EOF'
+{
+  "default": true,
+  "MD013": {
+    "line_length": 120,
+    "code_blocks": false,
+    "tables": false
+  },
+  "MD033": {
+    "allowed_elements": ["br", "sub", "sup"]
+  },
+  "MD041": false,
+  "MD046": {
+    "style": "fenced"
+  }
+    return 0
+}
+EOF
+    
+    if [[ -f "$config_file" ]]; then
+        print_success "markdownlint configuration created"
+        return 0
+    else
+        print_error "Failed to create configuration"
+        return 1
+    fi
+}
+
+# Fix markdown files using markdownlint
+fix_markdown_with_markdownlint() {
+    local target="$1"
+    
+    print_header "Fixing Markdown Issues with markdownlint"
+    
+    # Check if markdownlint is available
+    if ! check_markdownlint; then
+        print_warning "markdownlint-cli not found"
+        read -r -p "Install markdownlint-cli? (y/N): " install_confirm
+        
+        if [[ $install_confirm =~ ^[Yy]$ ]]; then
+            if ! install_markdownlint; then
+                return 1
+            fi
+        else
+            print_info "Skipping markdownlint fixes"
+            return 0
+        fi
+    fi
+    
+    # Create config if it doesn't exist
+    create_markdownlint_config
+    
+    # Run markdownlint with fix option
+    if [[ -f "$target" ]]; then
+        print_info "Fixing: $target"
+        markdownlint --fix "$target"
+        
+        if markdownlint --fix "$target"; then
+            print_success "Fixed markdown issues in: $target"
+        else
+            print_warning "Some issues may require manual fixing in: $target"
+        fi
+    elif [[ -d "$target" ]]; then
+        print_info "Fixing all markdown files in: $target"
+        markdownlint --fix "$target/**/*.md"
+        
+        if markdownlint --fix "$target"/*.md; then
+            print_success "Fixed markdown issues in directory: $target"
+        else
+            print_warning "Some issues may require manual fixing"
+        fi
+    else
+        print_error "Target not found: $target"
+        return 1
+    fi
+    
+    return 0
+}
+
+# Manual fixes for common Codacy issues
+apply_manual_fixes() {
+    local file="$1"
+    local temp_file
+    temp_file=$(mktemp)
+    local changes_made=0
+    
+    print_info "Applying manual fixes to: $file"
+    
+    # Create backup
+    cp "$file" "${file}.bak"
+    
+    # Apply manual fixes
+    {
+        # Remove trailing whitespace
+        sed 's/[[:space:]]*$//' "$file" |
+        
+        # Fix list markers - use consistent dashes
+        sed 's/^[[:space:]]*\*[[:space:]]/- /' |
+        sed 's/^[[:space:]]*+[[:space:]]/- /' |
+        
+        # Fix emphasis markers - use ** for bold
+        sed 's/__\([^_]*\)__/**\1**/g' |
+        
+        # Remove excessive blank lines (max 2 consecutive)
+        awk '
+        BEGIN { blank_count = 0 }
+        /^[[:space:]]*$/ { 
+            blank_count++
+            if (blank_count <= 2) print
+            next
+        }
+        { blank_count = 0; print }'
+        
+    } > "$temp_file"
+    
+    # Check if changes were made
+    if ! cmp -s "$file" "$temp_file"; then
+        mv "$temp_file" "$file"
+        changes_made=1
+        print_success "Applied manual fixes to: $file"
+    else
+        rm "$temp_file"
+        print_info "No manual fixes needed: $file"
+    fi
+    
+    # Remove backup if no changes were made
+    if [[ $changes_made -eq 0 ]]; then
+        rm "${file}.bak"
+    fi
+    
+    return $changes_made
+    return 0
+}
+
+# Show help message
+show_help() {
+    print_header "Markdown Lint Fix Help"
+    echo ""
+    echo "Usage: $0 [command] [target]"
+    echo ""
+    echo "Commands:"
+    echo "  fix [file|dir]       - Fix markdown issues (default)"
+    echo "  manual [file|dir]    - Apply manual fixes only"
+    echo "  install              - Install markdownlint-cli"
+    echo "  config               - Create markdownlint configuration"
+    echo "  help                 - Show this help message"
+    echo ""
+    echo "Examples:"
+    echo "  $0 README.md"
+    echo "  $0 fix .agent/"
+    echo "  $0 manual ."
+    echo "  $0 install"
+    echo ""
+    echo "This script fixes common Codacy markdown formatting issues:"
+    echo "  • Trailing whitespace"
+    echo "  • Inconsistent list markers"
+    echo "  • Inconsistent emphasis markers"
+    echo "  • Excessive blank lines"
+    echo "  • Line length issues"
+    echo "  • Header formatting"
+    echo ""
+    echo "Requires: markdownlint-cli (will offer to install if missing)"
+    return 0
+}
+
+# Main function
+main() {
+    local _arg1="$1"
+    local command="${1:-fix}"
+    local target="${2:-.}"
+
+    # Handle case where first argument is a file/directory
+    if [[ -f "$_arg1" || -d "$_arg1" ]]; then
+        command="fix"
+        target="$_arg1"
+    fi
+
+    case "$command" in
+        "fix")
+            fix_markdown_with_markdownlint "$target"
+            ;;
+        "manual")
+            if [[ -f "$target" && "$target" == *.md ]]; then
+                apply_manual_fixes "$target"
+            elif [[ -d "$target" ]]; then
+                find "$target" -name "*.md" -type f | while read -r file; do
+                    apply_manual_fixes "$file"
+                done
+            else
+                print_error "Invalid target: $target"
+                return 1
+            fi
+            ;;
+        "install")
+            install_markdownlint
+            ;;
+        "config")
+            create_markdownlint_config
+            ;;
+        "help"|"--help"|"-h")
+            show_help
+            ;;
+        *)
+            print_error "$ERROR_UNKNOWN_COMMAND $command"
+            show_help
+            return 1
+            ;;
+    esac
+    return 0
+}
+
+# Execute main function with all arguments
+main "$@"

package/.agent/scripts/mass-fix-returns.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+# shellcheck disable=SC2034,SC2155,SC2317,SC2329,SC2016,SC2181,SC1091,SC2154,SC2015,SC2086,SC2129,SC2030,SC2031,SC2119,SC2120,SC2001,SC2162,SC2088,SC2089,SC2090,SC2029,SC2006,SC2153
+
+# Mass fix script to add return statements to all functions that need them
+# Based on SonarCloud S7682 analysis
+
+cd providers || exit
+
+# Files and their function ending line numbers that need return statements
+declare -A FILES_LINES=(
+    ["101domains-helper.sh"]="522"
+    ["closte-helper.sh"]="105 133 247"
+    ["cloudron-helper.sh"]="73 103 129 161 177 191"
+    ["code-audit-helper.sh"]="153 167 188 202 223 237 258 272 293 332 384 411"
+    ["coolify-helper.sh"]="235"
+    ["dns-helper.sh"]="90 254"
+    ["git-platforms-helper.sh"]="156 202 217 247 261 344 388 425"
+    ["hetzner-helper.sh"]="112 157"
+    ["hostinger-helper.sh"]="72 110 139"
+    ["localhost-helper.sh"]="166 189 266 328 460"
+    ["mainwp-helper.sh"]="40 55 64 84 115 126 140 160 180 200 220 241 262 286 310 330 350 371 391 412 432 483 512"
+    ["ses-helper.sh"]="338 359 383 408 442"
+)
+
+# Function to add return statement before closing brace
+add_return_statement() {
+    local file="$1"
+    local line_num="$2"
+    
+    # Check if line before closing brace already has return
+    local prev_line
+    prev_line=$((line_num - 1))
+    if ! sed -n "${prev_line}p" "$file" | grep -q "return"; then
+        echo "Adding return statement to $file at line $line_num"
+        # Insert return statement before the closing brace
+        sed -i "${prev_line}a\\    return 0" "$file"
+    else
+        echo "Return statement already exists in $file at line $line_num"
+    fi
+    return 0
+}
+
+# Process each file
+for file in "${!FILES_LINES[@]}"; do
+    if [[ -f "$file" ]]; then
+        echo "Processing $file..."
+        lines="${FILES_LINES[$file]}"
+        
+        # Process lines in reverse order to avoid line number shifts
+        for line_num in $(echo "$lines" | tr ' ' '\n' | sort -nr); do
+            add_return_statement "$file" "$line_num"
+        done
+    else
+        echo "File $file not found"
+    fi
+done
+
+echo "Mass return statement fix completed!"