souleyez 2.43.23__py3-none-any.whl → 2.43.25__py3-none-any.whl

souleyez/__init__.py

@@ -1,2 +1,2 @@
-__version__ = '2.43.23'
+__version__ = '2.43.25'
 

souleyez/docs/README.md

@@ -1,7 +1,7 @@
 # SoulEyez Documentation
 
-**Version:** 2.43.23
-**Last Updated:** January 12, 2026
+**Version:** 2.43.25
+**Last Updated:** January 13, 2026
 **Organization:** CyberSoul Security
 
 Welcome to the SoulEyez documentation! This documentation covers architecture, development, user guides, and operational information for the SoulEyez penetration testing platform.

souleyez/main.py

@@ -173,7 +173,7 @@ def _check_privileged_tools():
 
 
 @click.group()
-@click.version_option(version='2.43.23')
+@click.version_option(version='2.43.25')
 def cli():
     """SoulEyez - AI-Powered Pentesting Platform by CyberSoul Security"""
     from souleyez.log_config import init_logging

souleyez/ui/interactive.py

@@ -5607,7 +5607,8 @@ def view_job_detail(job_id: int):
     
         # Parse and display ffuf/gobuster results if available (only when not showing raw logs)
         # Also check 'no_results' status - background parser may have missed results due to timing
-        if not show_raw_logs and job.get('tool') in ['ffuf', 'gobuster'] and job.get('status') in ['done', 'completed', 'no_results', 'warning'] and log_path and os.path.exists(log_path):
+        # Also handle 'error' status to show helpful error messages
+        if not show_raw_logs and job.get('tool') in ['ffuf', 'gobuster'] and job.get('status') in ['done', 'completed', 'no_results', 'warning', 'error'] and log_path and os.path.exists(log_path):
             try:
                 if job.get('tool') == 'ffuf':
                     from souleyez.parsers.ffuf_parser import parse_ffuf
@@ -5618,8 +5619,50 @@ def view_job_detail(job_id: int):
                         log_content = f.read()
                     parsed = parse_gobuster_output(log_content, job.get('target', ''))
 
+                # Check for timeout in log
+                timed_out = 'timed out' in log_content.lower() or 'Command timed out' in log_content
+
+                # Show error summary for jobs with error status
+                if job.get('status') == 'error':
+                    click.echo(click.style("=" * 70, fg='red'))
+                    click.echo(click.style("❌ SCAN FAILED", bold=True, fg='red'))
+                    click.echo(click.style("=" * 70, fg='red'))
+                    click.echo()
+
+                    # Check if it was a timeout
+                    if timed_out:
+                        click.echo("  Scan reached timeout before completing.")
+                        click.echo()
+                        click.echo(click.style("  Possible causes:", fg='bright_black'))
+                        click.echo(click.style("    • Target is rate limiting requests", fg='bright_black'))
+                        click.echo(click.style("    • Wordlist too large for timeout window", fg='bright_black'))
+                        click.echo(click.style("    • Network latency issues", fg='bright_black'))
+                        click.echo()
+                        click.echo(click.style("  Suggestions:", fg='bright_black'))
+                        click.echo(click.style("    • Try smaller wordlist", fg='bright_black'))
+                        click.echo(click.style("    • Increase --delay between requests", fg='bright_black'))
+                        click.echo(click.style("    • Reduce threads with -t", fg='bright_black'))
+                    else:
+                        # Try to extract error message from log
+                        import re
+                        error_msg = None
+                        if 'ERROR:' in log_content:
+                            match = re.search(r'ERROR:\s*(.+?)(?:\n|$)', log_content)
+                            if match:
+                                error_msg = match.group(1).strip()
+
+                        if error_msg:
+                            click.echo(f"  Error: {error_msg}")
+                        else:
+                            click.echo("  Scan failed - see raw logs for details.")
+                            click.echo("  Press [r] to view raw logs.")
+
+                    click.echo()
+                    click.echo(click.style("=" * 70, fg='red'))
+                    click.echo()
+
                 # Show warning summary for jobs with warning status
-                if job.get('status') == 'warning':
+                elif job.get('status') == 'warning':
                     click.echo(click.style("=" * 70, fg='yellow'))
                     click.echo(click.style("⚠️  SCAN WARNING", bold=True, fg='yellow'))
                     click.echo(click.style("=" * 70, fg='yellow'))
@@ -5826,7 +5869,40 @@ def view_job_detail(job_id: int):
                         if not show_all_paths and len(status_groups[status]) > 10:
                             click.echo(f"  ... and {len(status_groups[status]) - 10} more")
                         click.echo()
-                
+
+                # No paths found - show helpful no_results summary
+                elif job.get('status') in ['no_results', 'done', 'completed'] and not job.get('status') == 'error':
+                    click.echo(click.style("=" * 70, fg='cyan'))
+                    click.echo(click.style("GOBUSTER SCAN RESULTS", bold=True, fg='cyan'))
+                    click.echo(click.style("=" * 70, fg='cyan'))
+                    click.echo()
+                    click.echo("  No paths discovered.")
+                    click.echo()
+
+                    # Extract wordlist name from args
+                    args = job.get('args', [])
+                    for i, arg in enumerate(args):
+                        if arg == '-w' and i + 1 < len(args):
+                            import os
+                            wordlist = os.path.basename(args[i + 1])
+                            click.echo(f"  Wordlist: {wordlist}")
+                            break
+
+                    # Extract extensions
+                    for i, arg in enumerate(args):
+                        if arg == '-x' and i + 1 < len(args):
+                            click.echo(f"  Extensions: {args[i + 1]}")
+                            break
+
+                    click.echo()
+                    click.echo(click.style("  This could mean:", fg='bright_black'))
+                    click.echo(click.style("    • Target has good security (no exposed paths)", fg='bright_black'))
+                    click.echo(click.style("    • Try a different/larger wordlist", fg='bright_black'))
+                    click.echo(click.style("    • Target may be blocking automated requests", fg='bright_black'))
+                    click.echo()
+                    click.echo(click.style("=" * 70, fg='cyan'))
+                    click.echo()
+
             except Exception as e:
                 # Silently fail - not critical
                 pass
@@ -7391,6 +7467,113 @@ def view_job_detail(job_id: int):
                 # Silently fail - not critical
                 pass
 
+        # =================================================================
+        # GENERIC STATUS HANDLERS (fallbacks for tools without custom handlers)
+        # =================================================================
+
+        # Tools with custom error handlers (don't show generic for these)
+        tools_with_error_handlers = ['gobuster', 'ffuf']
+
+        # Tools with custom warning handlers
+        tools_with_warning_handlers = ['gobuster', 'ffuf']
+
+        # Tools with custom no_results handlers
+        tools_with_no_results_handlers = [
+            'ffuf', 'gobuster', 'sqlmap', 'wpscan', 'dnsrecon', 'nuclei',
+            'theharvester', 'nikto', 'whois', 'crackmapexec', 'smbmap',
+            'enum4linux', 'hydra', 'searchsploit', 'http_fingerprint'
+        ]
+
+        current_tool = job.get('tool', '')
+        current_status = job.get('status', '')
+
+        # Generic ERROR handler
+        if current_status == 'error' and current_tool not in tools_with_error_handlers:
+            tool_name = current_tool.upper().replace('_', ' ') if current_tool else 'UNKNOWN'
+            click.echo()
+            click.echo(click.style("=" * 70, fg='red'))
+            click.echo(click.style(f"[ERROR] {tool_name} SCAN FAILED", bold=True, fg='red'))
+            click.echo(click.style("=" * 70, fg='red'))
+            click.echo()
+
+            # Try to extract error message from log
+            error_msg = None
+            if log_path and os.path.exists(log_path):
+                try:
+                    with open(log_path, 'r', encoding='utf-8', errors='replace') as f:
+                        log_text = f.read()
+
+                    if 'Connection refused' in log_text:
+                        error_msg = "Connection refused - target may be down or port closed"
+                    elif 'timed out' in log_text.lower() or 'timeout' in log_text.lower():
+                        error_msg = "Command timed out - target may be slow or unresponsive"
+                    elif 'Permission denied' in log_text:
+                        error_msg = "Permission denied - may need elevated privileges"
+                    elif 'not found' in log_text.lower() and 'command' in log_text.lower():
+                        error_msg = "Tool not found - check installation"
+                    elif 'ERROR:' in log_text:
+                        match = re.search(r'ERROR:\s*(.+?)(?:\n|$)', log_text)
+                        if match:
+                            error_msg = match.group(1).strip()[:100]
+                except:
+                    pass
+
+            if error_msg:
+                click.echo(f"  {error_msg}")
+            else:
+                click.echo("  Scan failed - see raw logs for details (press 'r')")
+
+            click.echo()
+            click.echo(click.style("=" * 70, fg='red'))
+            click.echo()
+
+        # Generic WARNING handler
+        elif current_status == 'warning' and current_tool not in tools_with_warning_handlers:
+            tool_name = current_tool.upper().replace('_', ' ') if current_tool else 'UNKNOWN'
+            click.echo()
+            click.echo(click.style("=" * 70, fg='yellow'))
+            click.echo(click.style(f"[WARNING] {tool_name} SCAN COMPLETED WITH ISSUES", bold=True, fg='yellow'))
+            click.echo(click.style("=" * 70, fg='yellow'))
+            click.echo()
+            click.echo("  Scan completed but encountered problems.")
+            click.echo("  Press 'r' to view raw logs for details.")
+            click.echo()
+            click.echo(click.style("=" * 70, fg='yellow'))
+            click.echo()
+
+        # Generic KILLED handler (no tools have custom killed handlers)
+        elif current_status == 'killed':
+            tool_name = current_tool.upper().replace('_', ' ') if current_tool else 'UNKNOWN'
+            click.echo()
+            click.echo(click.style("=" * 70, fg='magenta'))
+            click.echo(click.style(f"[KILLED] {tool_name} SCAN TERMINATED", bold=True, fg='magenta'))
+            click.echo(click.style("=" * 70, fg='magenta'))
+            click.echo()
+            click.echo("  Scan was manually stopped by user.")
+            if log_path and os.path.exists(log_path):
+                click.echo("  Partial results may be available in raw logs (press 'r').")
+            click.echo()
+            click.echo(click.style("=" * 70, fg='magenta'))
+            click.echo()
+
+        # Generic NO_RESULTS handler (for tools without custom handlers)
+        elif current_status == 'no_results' and current_tool not in tools_with_no_results_handlers:
+            tool_name = current_tool.upper().replace('_', ' ') if current_tool else 'UNKNOWN'
+            click.echo()
+            click.echo(click.style("=" * 70, fg='cyan'))
+            click.echo(click.style(f"{tool_name} RESULTS", bold=True, fg='cyan'))
+            click.echo(click.style("=" * 70, fg='cyan'))
+            click.echo()
+            click.echo("  No results found.")
+            click.echo()
+            click.echo(click.style("  This could mean:", fg='bright_black'))
+            click.echo(click.style("    - Target is not vulnerable to this check", fg='bright_black'))
+            click.echo(click.style("    - Service/port is not available", fg='bright_black'))
+            click.echo(click.style("    - Different scan options may yield results", fg='bright_black'))
+            click.echo()
+            click.echo(click.style("=" * 70, fg='cyan'))
+            click.echo()
+
         click.echo()
 
         # Actions menu

{souleyez-2.43.23.dist-info → souleyez-2.43.25.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: souleyez
-Version: 2.43.23
+Version: 2.43.25
 Summary: AI-Powered Penetration Testing Platform with 40+ integrated tools
 Author-email: CyberSoul Security <contact@cybersoulsecurity.com>
 Maintainer-email: CyberSoul Security <contact@cybersoulsecurity.com>

{souleyez-2.43.23.dist-info → souleyez-2.43.25.dist-info}/RECORD

@@ -1,10 +1,10 @@
-souleyez/__init__.py,sha256=_O0zQDjjfN2p0SJ7vxTMimFsacmNRt7DRcREfGCtzsA,25
+souleyez/__init__.py,sha256=kkVflZUny39WoQMSEYDaJB4UzaEi_k65c5ZHSYiR29k,25
 souleyez/config.py,sha256=av357I3GYRWAklv8Dto-9-5Db699Wq5znez7zo7241Q,11595
 souleyez/devtools.py,sha256=rptmUY4a5eVvYjdEc6273MSagL-D9xibPOFgohVqUno,3508
 souleyez/feature_flags.py,sha256=mo6YAq07lc6sR3lEFKmIwTKxXZ2JPxwa5X97uR_mu50,4642
 souleyez/history.py,sha256=gzs5I_j-3OigIP6yfmBChdqxaFmyUIxvTpzWUPe_Q6c,2853
 souleyez/log_config.py,sha256=MMhPAJOqgXDfuE-xm5g0RxAfWndcmbhFHvIEMm1a_Wo,5830
-souleyez/main.py,sha256=BISz7PzhK03R7UTB-0Cnozk3kVOx0ctBxtZdg4bCo78,129101
+souleyez/main.py,sha256=V3QTWgRFMu4eSDGK-ul1EQIGP3z0S8gDZTNNdg53ieU,129101
 souleyez/scanner.py,sha256=U3IWHRrJ5aQ32dSHiVAHB60w1R_z0E0QxfM99msYNlw,3124
 souleyez/security.py,sha256=S84m1QmnKz_6NgH2I6IBIAorMHxRPNYVFSnks5xjihQ,2479
 souleyez/ui.py,sha256=15pfsqoDPnojAqr5S0TZHJE2ZkSHzkHpNVfVvsRj66A,34301
@@ -104,7 +104,7 @@ souleyez/detection/__init__.py,sha256=QIhvXjFdjrquQ6A0VQ7GZQkK_EXB59t8Dv9PKXhEUe
 souleyez/detection/attack_signatures.py,sha256=akgWwiIkh6WYnghCuLhRV0y6FS0SQ0caGF8tZUc49oA,6965
 souleyez/detection/mitre_mappings.py,sha256=xejE80YK-g8kKaeQoo-vBl8P3t8RTTItbfN0NaVZw6s,20558
 souleyez/detection/validator.py,sha256=-AJ7QSJ3-6jFKLnPG_Rc34IXyF4JPyI82BFUgTA9zw0,15641
-souleyez/docs/README.md,sha256=1IbE4JAOBBHmIvSu9AiYaiXllUTR4kYFYexCGDEQy84,7188
+souleyez/docs/README.md,sha256=TKl_YboET7lXCrehA6JG4YdG7dHlJnOt8cJ2Pcf-4go,7188
 souleyez/docs/api-reference/cli-commands.md,sha256=lTLFnILN3YRVdqCaag7WgsYXfDGglb1TuPexkxDsVdE,12917
 souleyez/docs/api-reference/engagement-api.md,sha256=nd-EvQMtiJrobg2bzFEADp853HP1Uhb9dmgok0_-neE,11672
 souleyez/docs/api-reference/integration-guide.md,sha256=c96uX79ukHyYotLa54wZ20Kx-EUZnrKegTeGkfLD-pw,16285
@@ -347,7 +347,7 @@ souleyez/ui/export_view.py,sha256=0nQvVsKk7FU4uRzSfJ_qBZh_Lfn8hgGA2rbJ5bNg5-Y,65
 souleyez/ui/gap_analysis_view.py,sha256=AytAOEBq010wwo9hne1TE-uJpY_xicjLrFANbvN3r3w,30727
 souleyez/ui/help_system.py,sha256=nKGxLaMi-TKYs6xudTyw_tZqBb1cGFEuYYh6N-MAsJE,16648
 souleyez/ui/intelligence_view.py,sha256=VeAQ-3mANRnLIVpRqocL3JV0HUmJtADdxDeC5lzQhE0,32168
-souleyez/ui/interactive.py,sha256=x2THKw7npsTYEhK6qy7r-yor_uP2NtMdXjuGXTu0ANU,1423390
+souleyez/ui/interactive.py,sha256=zC1TxRvaumvdfCMoaGrIq-inqezTLeQSwUUEf9UeSdY,1433095
 souleyez/ui/interactive_selector.py,sha256=6A51fgmFRnemBY0aCPHIhK2Rpba16NjSGKLzC0Q5vI8,16407
 souleyez/ui/log_formatter.py,sha256=akhIkYoO_cCaKxS1V5N3iPmIrHzgsU7pmsedx70s9TI,3845
 souleyez/ui/menu_components.py,sha256=N8zq2QXGmfaLJ08l53MMYt1y-5LRWgpZH6r8nXHonj8,3519
@@ -371,9 +371,9 @@ souleyez/ui/wazuh_vulns_view.py,sha256=3vJJEmrjgS2wD6EDB7ZV7WxgytBHTm-1WqNDjp7lV
 souleyez/ui/wordlist_browser.py,sha256=iQ2YYxrVo8FGCfM-Bc0teVBijSAbd2rjbSQ2hOE7eiY,16110
 souleyez/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 souleyez/utils/tool_checker.py,sha256=YzNajZpFyKJA5fp0Kq_gQ0YnKb7J1BaKJSZ8vP-IWj8,30868
-souleyez-2.43.23.dist-info/licenses/LICENSE,sha256=J7vDD5QMF4w2oSDm35eBgosATE70ah1M40u9W4EpTZs,1090
-souleyez-2.43.23.dist-info/METADATA,sha256=KU_fLA17aF-ze8k-cCoWGoyKBlLrRT6WlE6_SOBfXdE,10427
-souleyez-2.43.23.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-souleyez-2.43.23.dist-info/entry_points.txt,sha256=bN5W1dhjDZJl3TKclMjRpfQvGPmyrJLwwDuCj_X39HE,48
-souleyez-2.43.23.dist-info/top_level.txt,sha256=afAMzS9p4lcdBNxhGo6jl3ipQE9HUvvNIPOdjtPjr_Q,9
-souleyez-2.43.23.dist-info/RECORD,,
+souleyez-2.43.25.dist-info/licenses/LICENSE,sha256=J7vDD5QMF4w2oSDm35eBgosATE70ah1M40u9W4EpTZs,1090
+souleyez-2.43.25.dist-info/METADATA,sha256=zVv-wa2kHANcyU9-r17em543pZvz8NiS4BDRoMZ9DCo,10427
+souleyez-2.43.25.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+souleyez-2.43.25.dist-info/entry_points.txt,sha256=bN5W1dhjDZJl3TKclMjRpfQvGPmyrJLwwDuCj_X39HE,48
+souleyez-2.43.25.dist-info/top_level.txt,sha256=afAMzS9p4lcdBNxhGo6jl3ipQE9HUvvNIPOdjtPjr_Q,9
+souleyez-2.43.25.dist-info/RECORD,,