aidevops 2.52.1

package/.agent/scripts/efficient-return-fix.sh

@@ -0,0 +1,92 @@
+#!/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
+
+# Efficient script to add return statements to functions that need them
+# Based on SonarCloud S7682 analysis
+
+cd providers || exit
+
+# Function to add return statement to a specific line
+add_return_to_line() {
+    local file="$1"
+    local line_num="$2"
+    
+    if [[ -f "$file" ]]; then
+        # Check if line before closing brace already has return
+        local prev_line
+        prev_line=$((line_num - 1))
+        local line_content
+        line_content=$(sed -n "${prev_line}p" "$file")
+        
+        if [[ ! "$line_content" =~ return ]]; then
+            echo "Adding return statement to $file at line $line_num"
+            # Use perl for more reliable in-place editing
+            perl -i -pe "if (\$. == $prev_line) { \$_ .= \"    return 0\n\" }" "$file"
+        else
+            echo "Return statement already exists in $file at line $line_num"
+        fi
+    else
+        echo "File $file not found"
+    fi
+    return 0
+}
+
+# Process mainwp-helper.sh (most issues)
+echo "Processing mainwp-helper.sh..."
+for line in 64 84 115 126 140 160 180 200 220 241 262 286 310 330 350 371 391 412 432 483 512; do
+    add_return_to_line "mainwp-helper.sh" "$line"
+done
+
+# Process code-audit-helper.sh (13+ issues)
+echo "Processing code-audit-helper.sh..."
+for line in 188 202 223 237 258 272 293 332 384 411; do
+    add_return_to_line "code-audit-helper.sh" "$line"
+done
+
+# Process localhost-helper.sh (remaining issues)
+echo "Processing localhost-helper.sh..."
+for line in 166 189 266 328 460; do
+    add_return_to_line "localhost-helper.sh" "$line"
+done
+
+# Process cloudron-helper.sh (remaining issues)
+echo "Processing cloudron-helper.sh..."
+for line in 103 129 161 177 191; do
+    add_return_to_line "cloudron-helper.sh" "$line"
+done
+
+# Process remaining files
+echo "Processing git-platforms-helper.sh..."
+for line in 156 202 217 247 261 344 388 425; do
+    add_return_to_line "git-platforms-helper.sh" "$line"
+done
+
+echo "Processing ses-helper.sh..."
+for line in 338 359 383 408 442; do
+    add_return_to_line "ses-helper.sh" "$line"
+done
+
+echo "Processing hetzner-helper.sh..."
+for line in 112 157; do
+    add_return_to_line "hetzner-helper.sh" "$line"
+done
+
+echo "Processing hostinger-helper.sh..."
+for line in 72 110 139; do
+    add_return_to_line "hostinger-helper.sh" "$line"
+done
+
+echo "Processing closte-helper.sh..."
+for line in 105 133 247; do
+    add_return_to_line "closte-helper.sh" "$line"
+done
+
+echo "Processing coolify-helper.sh..."
+add_return_to_line "coolify-helper.sh" "235"
+
+echo "Processing dns-helper.sh..."
+for line in 90 254; do
+    add_return_to_line "dns-helper.sh" "$line"
+done
+
+echo "Efficient return statement fix completed!"

package/.agent/scripts/extract-opencode-prompts.sh

@@ -0,0 +1,128 @@
+#!/bin/bash
+# =============================================================================
+# Extract OpenCode Prompts from Binary
+# =============================================================================
+# Extracts embedded prompts from the OpenCode binary for use by aidevops agents.
+# This ensures our agents stay in sync with OpenCode updates.
+#
+# Usage: ./extract-opencode-prompts.sh
+# Output: ~/.aidevops/cache/opencode-prompts/
+# =============================================================================
+
+set -euo pipefail
+
+# Colors
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+# shellcheck disable=SC2034  # RED reserved for future error messages
+RED='\033[0;31m'
+NC='\033[0m'
+
+CACHE_DIR="$HOME/.aidevops/cache/opencode-prompts"
+OPENCODE_BIN=""
+
+# Find OpenCode binary
+find_opencode_binary() {
+    local locations=(
+        "$HOME/.bun/install/global/node_modules/opencode-darwin-arm64/bin/opencode"
+        "$HOME/.bun/install/global/node_modules/opencode-darwin-x64/bin/opencode"
+        "$HOME/.bun/install/global/node_modules/opencode-linux-x64/bin/opencode"
+        "$HOME/.bun/install/global/node_modules/opencode-linux-arm64/bin/opencode"
+        "/usr/local/bin/opencode"
+        "$HOME/.local/bin/opencode"
+    )
+    
+    for loc in "${locations[@]}"; do
+        if [[ -f "$loc" ]]; then
+            OPENCODE_BIN="$loc"
+            return 0
+        fi
+    done
+    
+    # Try which as fallback
+    if command -v opencode &>/dev/null; then
+        local bin_path
+        bin_path=$(which opencode)
+        # Follow symlinks to find actual binary
+        if [[ -L "$bin_path" ]]; then
+            bin_path=$(readlink -f "$bin_path" 2>/dev/null || readlink "$bin_path")
+        fi
+        if [[ -f "$bin_path" ]]; then
+            OPENCODE_BIN="$bin_path"
+            return 0
+        fi
+    fi
+    
+    return 1
+}
+
+# Extract a specific prompt by variable name
+# Usage: extract_prompt "plan_default" "plan.txt"
+extract_prompt() {
+    local var_name="$1"
+    local output_file="$2"
+    local start_marker="var ${var_name} = \`"
+    
+    # Extract content between backticks
+    strings "$OPENCODE_BIN" | \
+        grep -A 500 "^${start_marker}" | \
+        head -n 100 | \
+        sed "s/^${start_marker}//" | \
+        sed '/^var init_/q' | \
+        sed '/^var init_/d' | \
+        sed 's/`$//' \
+        > "$CACHE_DIR/$output_file"
+    
+    # Verify extraction worked
+    if [[ -s "$CACHE_DIR/$output_file" ]]; then
+        echo -e "  ${GREEN}✓${NC} Extracted $output_file"
+        return 0
+    else
+        echo -e "  ${YELLOW}⚠${NC} Failed to extract $output_file"
+        return 1
+    fi
+}
+
+# Get OpenCode version
+get_opencode_version() {
+    if command -v opencode &>/dev/null; then
+        opencode --version 2>/dev/null || echo "unknown"
+    else
+        echo "unknown"
+    fi
+}
+
+main() {
+    echo -e "${BLUE}Extracting OpenCode prompts...${NC}"
+    
+    # Find binary
+    if ! find_opencode_binary; then
+        echo -e "${YELLOW}Warning: OpenCode binary not found. Skipping prompt extraction.${NC}"
+        echo -e "${YELLOW}Install OpenCode with: bun install -g opencode-ai${NC}"
+        return 0
+    fi
+    
+    echo -e "  Found binary: $OPENCODE_BIN"
+    
+    # Create cache directory
+    mkdir -p "$CACHE_DIR"
+    
+    # Get version for tracking
+    local version
+    version=$(get_opencode_version)
+    echo "$version" > "$CACHE_DIR/version.txt"
+    echo -e "  OpenCode version: $version"
+    
+    # Extract prompts
+    extract_prompt "plan_default" "plan-reminder.txt" || true
+    extract_prompt "build_switch_default" "build-switch.txt" || true
+    extract_prompt "max_steps_default" "max-steps.txt" || true
+    
+    # Record extraction timestamp
+    date -u +"%Y-%m-%dT%H:%M:%SZ" > "$CACHE_DIR/extracted-at.txt"
+    
+    echo -e "${GREEN}Done!${NC} Prompts cached in $CACHE_DIR"
+}
+
+main "$@"

package/.agent/scripts/find-missing-returns.sh

@@ -0,0 +1,113 @@
+#!/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
+
+# Find Functions Missing Return Statements
+# Identify functions that need return statements for S7682 compliance
+#
+# Author: AI DevOps Framework
+# Version: 1.1.1
+
+# Colors for output
+readonly BLUE='\033[0;34m'
+readonly RED='\033[0;31m'
+readonly NC='\033[0m'
+
+print_info() {
+    local _arg1="$1"
+    echo -e "${BLUE}ℹ️  $_arg1${NC}"
+    return 0
+}
+
+print_error() {
+    local _arg1="$1"
+    echo -e "${RED}❌ $_arg1${NC}"
+    return 0
+}
+
+# Find functions missing return statements in a file
+find_missing_returns_in_file() {
+    local file="$1"
+
+    print_info "Analyzing: $file"
+    
+    # Extract function definitions and check for return statements
+    awk '
+    BEGIN {
+        in_function = 0
+        function_name = ""
+        function_content = ""
+        brace_count = 0
+    }
+    
+    # Function start
+    /^[a-zA-Z_][a-zA-Z0-9_]*\(\)[[:space:]]*\{/ {
+        if (in_function) {
+            # Previous function ended without proper closing
+            if (function_content !~ /return[[:space:]]+[0-9]+/ && 
+                function_content !~ /return[[:space:]]+\$/ &&
+                function_content !~ /return[[:space:]]*$/ &&
+                function_content !~ /exit[[:space:]]+[0-9]+/) {
+                print "Missing return: " function_name
+            }
+        }
+        
+        in_function = 1
+        function_name = $1
+        gsub(/\(\).*/, "", function_name)
+        function_content = ""
+        brace_count = 1
+        next
+    }
+    
+    # Inside function
+    in_function == 1 {
+        function_content = function_content "\n" $0
+        
+        # Count braces
+        brace_count += gsub(/\{/, "&")
+        brace_count -= gsub(/\}/, "&")
+        
+        # Function ends
+        if (brace_count == 0) {
+            if (function_content !~ /return[[:space:]]+[0-9]+/ && 
+                function_content !~ /return[[:space:]]+\$/ &&
+                function_content !~ /return[[:space:]]*$/ &&
+                function_content !~ /exit[[:space:]]+[0-9]+/) {
+                print "Missing return: " function_name
+            }
+            in_function = 0
+            function_name = ""
+            function_content = ""
+        }
+    }
+    
+    END {
+        # Handle case where file ends while in function
+        if (in_function && function_content !~ /return[[:space:]]+[0-9]+/ && 
+            function_content !~ /return[[:space:]]*$/ &&
+            function_content !~ /exit[[:space:]]+[0-9]+/) {
+            print "Missing return: " function_name
+        }
+    }
+    ' "$file"
+    return 0
+}
+
+# Main execution
+main() {
+    local target="${1:-.}"
+    
+    if [[ -f "$target" && "$target" == *.sh ]]; then
+        find_missing_returns_in_file "$target"
+    elif [[ -d "$target" ]]; then
+        find "$target" -name "*.sh" -type f | while read -r file; do
+            find_missing_returns_in_file "$file"
+        done
+    else
+        print_error "Invalid target: $target"
+        return 1
+    fi
+    return 0
+}
+
+main "$@"

package/.agent/scripts/fix-auth-headers.sh

@@ -0,0 +1,104 @@
+#!/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
+
+# Fix Authorization Header String Literals
+# Replace repeated "Authorization: Bearer" patterns with constants
+#
+# Author: AI DevOps Framework
+# Version: 1.1.1
+
+# Colors for output
+readonly GREEN='\033[0;32m'
+readonly BLUE='\033[0;34m'
+readonly NC='\033[0m'
+
+print_success() {
+    local _arg1="$1"
+    echo -e "${GREEN}✅ $_arg1${NC}"
+    return 0
+}
+
+print_info() {
+    local _arg1="$1"
+    echo -e "${BLUE}ℹ️  $_arg1${NC}"
+    return 0
+}
+
+# Fix Authorization header in a file
+fix_auth_header_in_file() {
+    local file="$1"
+    local count
+    count=$(grep -c "Authorization: Bearer" "$file" 2>/dev/null || echo "0")
+    
+    if [[ $count -ge 3 ]]; then
+        print_info "Fixing $count Authorization header occurrences in: $file"
+        
+        # Add constant if not present
+        if ! grep -q "AUTH_BEARER_PREFIX" "$file"; then
+            # Find where to insert the constant (after CONTENT_TYPE_JSON or after colors)
+            if grep -q "readonly CONTENT_TYPE_JSON" "$file"; then
+                sed -i '' '/readonly CONTENT_TYPE_JSON/a\
+readonly AUTH_BEARER_PREFIX="Authorization: Bearer"
+' "$file"
+            elif grep -q "NC=.*No Color" "$file"; then
+                sed -i '' '/NC=.*No Color/a\
+\
+# Common constants\
+readonly AUTH_BEARER_PREFIX="Authorization: Bearer"
+' "$file"
+            elif grep -q "readonly.*NC=" "$file"; then
+                sed -i '' '/readonly.*NC=/a\
+\
+# Common constants\
+readonly AUTH_BEARER_PREFIX="Authorization: Bearer"
+' "$file"
+            fi
+        fi
+        
+        # Replace occurrences - handle different patterns
+        sed -i '' "s/\"Authorization: Bearer \\\$api_token\"/\"\$AUTH_BEARER_PREFIX \$api_token\"/g" "$file"
+        sed -i '' "s/\"Authorization: Bearer \\\${api_token}\"/\"\$AUTH_BEARER_PREFIX \${api_token}\"/g" "$file"
+        sed -i '' "s/\"Authorization: Bearer \\\$token\"/\"\$AUTH_BEARER_PREFIX \$token\"/g" "$file"
+        sed -i '' "s/\"Authorization: Bearer \\\${token}\"/\"\$AUTH_BEARER_PREFIX \${token}\"/g" "$file"
+        
+        # Verify
+        local new_count
+        new_count=$(grep -c "Authorization: Bearer" "$file" 2>/dev/null || echo "0")
+        local const_count
+        const_count=$(grep -c "AUTH_BEARER_PREFIX" "$file" 2>/dev/null || echo "0")
+        
+        if [[ $new_count -eq 1 && $const_count -gt 1 ]]; then
+            print_success "Fixed $file: $count → 1 definition + $((const_count-1)) usages"
+            return 0
+        else
+            print_info "Partial fix in $file: $new_count literals remaining, $const_count constant usages"
+            return 1
+        fi
+    else
+        print_info "Skipping $file: only $count occurrences (need 3+)"
+        return 1
+    fi
+    return 0
+}
+
+# Main execution
+main() {
+    print_info "Fixing Authorization header string literals in provider files..."
+    
+    local files_fixed=0
+    local files_processed=0
+    
+    for file in .agent/scripts/*.sh; do
+        if [[ -f "$file" ]]; then
+            ((files_processed++))
+            if fix_auth_header_in_file "$file"; then
+                ((files_fixed++))
+            fi
+        fi
+    done
+    
+    print_success "Summary: $files_fixed/$files_processed files fixed"
+    return 0
+}
+
+main "$@"

package/.agent/scripts/fix-common-strings.sh

@@ -0,0 +1,254 @@
+#!/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
+
+# Common String Literals Fix Script
+# Fix the most common repeated string literals for SonarCloud S1192 compliance
+#
+# Usage: ./fix-common-strings.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
+
+# 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 common repeated strings in a file
+fix_common_strings_in_file() {
+    local file="$1"
+    local backup_file="${file}.backup"
+    local temp_file
+    temp_file=$(mktemp)
+    local changes_made=0
+    
+    print_info "Processing: $file"
+    
+    # Create backup
+    cp "$file" "$backup_file"
+    
+    # Check if file needs constants section
+    local needs_constants=false
+    
+    # Check for common repeated strings
+    if grep -q "Content-Type: application/json" "$file" && \
+       [[ $(grep -c "Content-Type: application/json" "$file") -ge 3 ]]; then
+        needs_constants=true
+    fi
+    
+    if grep -q "Authorization: Bearer" "$file" && \
+       [[ $(grep -c "Authorization: Bearer" "$file") -ge 3 ]]; then
+        needs_constants=true
+    fi
+    
+    if grep -q "Unknown command:" "$file" && \
+       [[ $(grep -c "Unknown command:" "$file") -ge 3 ]]; then
+        needs_constants=true
+    fi
+    
+    if [[ "$needs_constants" == "true" ]]; then
+        # Add constants section if not present
+        if ! grep -q "# HTTP constants" "$file" && ! grep -q "# Common constants" "$file"; then
+            # Find a good place to insert constants (after colors, before functions)
+            awk '
+            BEGIN { constants_added = 0 }
+            /^readonly.*NC=/ && !constants_added {
+                print $0
+                print ""
+                print "# Common constants"
+                constants_added = 1
+                next
+            }
+            /^# Print functions/ && !constants_added {
+                print "# Common constants"
+                print ""
+                print $0
+                constants_added = 1
+                next
+            }
+            { print }
+            ' "$file" > "$temp_file"
+            mv "$temp_file" "$file"
+        fi
+        
+        # Add specific constants and replace strings
+        
+        # Content-Type header
+        local content_type_count
+        content_type_count=$(grep -c "Content-Type: application/json" "$file" 2>/dev/null || echo "0")
+        if [[ $content_type_count -ge 3 ]]; then
+            if ! grep -q "readonly.*CONTENT_TYPE_JSON" "$file"; then
+                sed -i '/# Common constants/a readonly CONTENT_TYPE_JSON="Content-Type: application/json"' "$file"
+                changes_made=1
+            fi
+            sed -i 's/"Content-Type: application\/json"/$CONTENT_TYPE_JSON/g' "$file"
+            print_success "Replaced $content_type_count occurrences of Content-Type header"
+        fi
+        
+        # Authorization header pattern
+        local auth_count
+        auth_count=$(grep -c "Authorization: Bearer" "$file" 2>/dev/null || echo "0")
+        if [[ "$auth_count" -ge 3 ]]; then
+            if ! grep -q "readonly.*AUTH_BEARER_PREFIX" "$file"; then
+                sed -i '/# Common constants/a readonly AUTH_BEARER_PREFIX="Authorization: Bearer"' "$file"
+                changes_made=1
+            fi
+            sed -i 's|"Authorization: Bearer \([^"]*\)"|"$AUTH_BEARER_PREFIX \1"|g' "$file"
+            print_success "Replaced $auth_count occurrences of Authorization header"
+        fi
+
+        # Unknown command message
+        local unknown_cmd_count
+        unknown_cmd_count=$(grep -c "Unknown command:" "$file" 2>/dev/null || echo "0")
+        if [[ "$unknown_cmd_count" -ge 3 ]]; then
+            if ! grep -q "readonly.*ERROR_UNKNOWN_COMMAND" "$file"; then
+                sed -i '/# Common constants/a readonly ERROR_UNKNOWN_COMMAND="Unknown command:"' "$file"
+                changes_made=1
+            fi
+            sed -i 's|"Unknown command: \$command"|"$ERROR_UNKNOWN_COMMAND $command"|g' "$file"
+            print_success "Replaced $unknown_cmd_count occurrences of unknown command message"
+        fi
+        
+        # Help message
+        local help_count
+        help_count=$(grep -c "help.*- Show this help message" "$file" 2>/dev/null || echo "0")
+        if [[ "$help_count" -ge 3 ]]; then
+            if ! grep -q "readonly.*HELP_MESSAGE" "$file"; then
+                sed -i '/# Common constants/a readonly HELP_MESSAGE_SUFFIX="- Show this help message"' "$file"
+                changes_made=1
+            fi
+            sed -i 's|"  help[[:space:]]*- Show this help message"|"  help                 - $HELP_MESSAGE_SUFFIX"|g' "$file"
+            print_success "Replaced $help_count occurrences of help message"
+        fi
+
+        # Usage message
+        local usage_count
+        usage_count=$(grep -c "Usage: \\$0" "$file" 2>/dev/null || echo "0")
+        if [[ "$usage_count" -ge 3 ]]; then
+            if ! grep -q "readonly.*USAGE_PREFIX" "$file"; then
+                sed -i '/# Common constants/a readonly USAGE_PREFIX="Usage:"' "$file"
+                changes_made=1
+            fi
+            sed -i 's|"Usage: \\$0"|"$USAGE_PREFIX $0"|g' "$file"
+            print_success "Replaced $usage_count occurrences of usage message"
+        fi
+    fi
+    
+    if [[ $changes_made -gt 0 ]]; then
+        print_success "Fixed repeated strings in: $file"
+        return 0
+    else
+        rm "$backup_file"
+        print_info "No repeated strings requiring fixes in: $file"
+        return 1
+    fi
+    return 0
+}
+
+# Process directory for common string fixes
+process_directory_common_strings() {
+    local target_dir="${1:-.}"
+
+    print_header "Fixing Common Repeated Strings in: $target_dir"
+
+    local files_processed=0
+    local files_modified=0
+
+    find "$target_dir" -name "*.sh" -type f | while read -r file; do
+        ((files_processed++))
+        if fix_common_strings_in_file "$file"; then
+            ((files_modified++))
+        fi
+    done
+
+    print_info "Summary: $files_modified/$files_processed files modified"
+    return 0
+}
+
+# Show help message
+show_help() {
+    print_header "Common String Literals Fix Help"
+    echo ""
+    echo "Usage: $0 [target]"
+    echo ""
+    echo "Examples:"
+    echo "  $0 .agent/scripts/"
+    echo "  $0 setup.sh"
+    echo "  $0 ."
+    echo ""
+    echo "This script addresses SonarCloud S1192 violations by fixing the most common repeated strings:"
+    echo ""
+    echo "Fixed patterns:"
+    echo "  • \"Content-Type: application/json\" → \$CONTENT_TYPE_JSON"
+    echo "  • \"Authorization: Bearer\" → \$AUTH_BEARER_PREFIX"
+    echo "  • \"Unknown command:\" → \$ERROR_UNKNOWN_COMMAND"
+    echo "  • \"Usage: \\$0\" → \\$USAGE_PREFIX"
+    echo "  • Help messages → \$HELP_MESSAGE_SUFFIX"
+    echo ""
+    echo "Requirements:"
+    echo "  • String must appear 3+ times in the same file"
+    echo "  • Constants are added to existing or new constants section"
+    echo "  • Backup files (.backup) are created for all modified files"
+    echo ""
+    echo "This targets the highest-impact repeated strings for maximum S1192 compliance improvement."
+    return 0
+}
+
+# Main function
+main() {
+    local target="${1:-.}"
+
+    if [[ "$target" == "help" || "$target" == "--help" || "$target" == "-h" ]]; then
+        show_help
+        return 0
+    fi
+
+    if [[ -f "$target" && "$target" == *.sh ]]; then
+        fix_common_strings_in_file "$target"
+    elif [[ -d "$target" ]]; then
+        process_directory_common_strings "$target"
+    else
+        print_error "Invalid target: $target"
+        print_info "Use: $0 help for usage information"
+        return 1
+    fi
+    return 0
+}
+
+# Execute main function with all arguments
+main "$@"