Document comprehensive PHP optimizer bug analysis in REFDB_FORMAT.txt

Added detailed bug analysis section documenting:
- 8 bugs found by comprehensive analysis agent
- CRITICAL domain detection bug (fixed)
- 2 HIGH priority bugs (bc dependency, memory usage logic)
- 3 MEDIUM priority bugs (missing parameters, empty checks)
- 2 LOW priority bugs (dead code)

Analysis performed on php-detector.sh, php-analyzer.sh, php-optimizer.sh

REFDB_FORMAT.txt

@@ -1274,6 +1274,80 @@ files_modified:
 
 commit: "0cfbba2"
 
+[UPDATE_2025_12_03_DOMAIN_DETECTION_BUG]
+# CRITICAL bug fix - PHP optimizer showing 0 domains
+
+comprehensive_analysis_findings:
+  agent_used: "general-purpose subagent"
+  files_analyzed: "php-detector.sh, php-analyzer.sh, php-optimizer.sh, user-manager.sh"
+  bugs_found: 8
+  severity_breakdown: "1 CRITICAL, 2 HIGH, 3 MEDIUM, 2 LOW"
+
+critical_bug_fixed:
+  file: "lib/user-manager.sh"
+  function: "get_cpanel_user_domains()"
+  lines: "254, 258"
+
+  problem: |
+    grep -F ": ${username}" /etc/trueuserdomains | grep -F "$username\$"
+    - grep -F means 'fixed string match' (NO REGEX)
+    - Pattern "$username\$" was looking for literal backslash-dollar character
+    - Since no lines contain literal "\$", function returned NOTHING
+
+  fix: |
+    grep -F ": ${username}" /etc/trueuserdomains | grep "${username}$"
+    - Removed -F from second grep (enable regex mode)
+    - Now $ correctly matches end-of-line
+
+  impact:
+    before_fix: "0 domains analyzed, 0MB memory shown, ALL features broken"
+    after_fix: "Domains detected correctly, script functional"
+
+  commit: "f389d82"
+
+remaining_high_priority_bugs:
+  bug_1:
+    severity: "HIGH"
+    file: "lib/php-analyzer.sh"
+    lines: "138, 391, 394, 395, 425, 479, 621"
+    issue: "Uses bc command for floating point math - not installed on all systems"
+    fix: "Replace with bash integer arithmetic: [ \"\${hit_rate%%.*}\" -lt 90 ]"
+
+  bug_2:
+    severity: "HIGH"
+    file: "lib/php-detector.sh + lib/php-analyzer.sh"
+    function: "get_fpm_memory_usage() + calculate_memory_per_process()"
+    lines: "php-detector.sh:273, php-analyzer.sh:202-211"
+    issue: "get_fpm_memory_usage returns single value, but caller expects 'avg_kb|total_mb' format"
+    fix: "Rewrite get_fpm_memory_usage to calculate and return both values"
+
+medium_priority_bugs:
+  bug_3:
+    file: "php-analyzer.sh"
+    line: 536
+    issue: "detect_php_version_for_domain called with 1 param, needs 2 (domain, username)"
+
+  bug_4:
+    file: "php-optimizer.sh"
+    line: 113
+    issue: "Same as bug_3 - missing username parameter"
+
+  bug_5:
+    file: "php-optimizer.sh"
+    lines: "407, 472"
+    issue: "Missing empty checks before numeric comparisons"
+
+low_priority_bugs:
+  bug_6:
+    file: "php-optimizer.sh"
+    lines: "1050-1055"
+    issue: "Dead code - backup_array populated in loop then overwritten by mapfile"
+
+testing_status:
+  before_fixes: "Script loaded but showed 0 domains, 0 memory usage"
+  after_critical_fix: "Domains now detected, ready for functional testing"
+  next_step: "Fix remaining bugs then test all 9 menu options"
+
 [END]
 # This file is the primary developer reference document.
 # README.md is for end users, this file is for developers.