aidevops 2.52.1 → 2.53.2

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

@@ -1,338 +0,0 @@
-#!/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

@@ -1,311 +0,0 @@
-#!/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

@@ -1,58 +0,0 @@
-#!/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!"