souleyez 2.43.2__tar.gz → 2.43.8__tar.gz

{souleyez-2.43.2/souleyez.egg-info → souleyez-2.43.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: souleyez
-Version: 2.43.2
+Version: 2.43.8
 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.2 → souleyez-2.43.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "souleyez"
-version = "2.43.2"
+version = "2.43.8"
 description = "AI-Powered Penetration Testing Platform with 40+ integrated tools"
 readme = "README.md"
 license = {text = "MIT"}

souleyez-2.43.8/souleyez/__init__.py

@@ -0,0 +1,2 @@
+__version__ = '2.43.8'
+

{souleyez-2.43.2 → souleyez-2.43.8}/souleyez/docs/README.md

@@ -1,7 +1,7 @@
 # SoulEyez Documentation
 
-**Version:** 2.43.2
-**Last Updated:** January 11, 2026
+**Version:** 2.43.8
+**Last Updated:** January 12, 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-2.43.2 → souleyez-2.43.8}/souleyez/engine/result_handler.py

@@ -3285,9 +3285,12 @@ def parse_http_fingerprint_job(engagement_id: int, log_path: str, job: Dict[str,
         # Get tool recommendations
         recommendations = get_tool_recommendations(parsed)
 
-        # Determine status
+        # Determine status and build summary
+        summary_parts = []
+
         if parsed.get('error'):
             status = STATUS_ERROR
+            summary_parts.append(f"Error: {parsed.get('error')}")
         elif parsed.get('managed_hosting') or parsed.get('waf') or parsed.get('cdn'):
             status = STATUS_DONE  # Found useful info
         elif parsed.get('server'):
@@ -3295,11 +3298,31 @@ def parse_http_fingerprint_job(engagement_id: int, log_path: str, job: Dict[str,
         else:
             status = STATUS_NO_RESULTS
 
+        # Build summary for successful scans
+        if not parsed.get('error'):
+            if parsed.get('server'):
+                summary_parts.append(f"Server: {parsed.get('server')}")
+            if parsed.get('managed_hosting'):
+                summary_parts.append(f"Platform: {parsed.get('managed_hosting')}")
+            if parsed.get('waf'):
+                summary_parts.append(f"WAF: {', '.join(parsed.get('waf', []))}")
+            if parsed.get('cdn'):
+                summary_parts.append(f"CDN: {', '.join(parsed.get('cdn', []))}")
+            if parsed.get('technologies'):
+                techs = parsed.get('technologies', [])
+                if len(techs) <= 3:
+                    summary_parts.append(f"Tech: {', '.join(techs)}")
+                else:
+                    summary_parts.append(f"Tech: {', '.join(techs[:3])} +{len(techs)-3} more")
+
+        summary = ' | '.join(summary_parts) if summary_parts else 'No fingerprint data detected'
+
         return {
             'tool': 'http_fingerprint',
             'status': status,
             'target': target,
             'target_host': target_host,
+            'summary': summary,
             # Core fingerprint data
             'server': parsed.get('server'),
             'managed_hosting': parsed.get('managed_hosting'),

{souleyez-2.43.2 → souleyez-2.43.8}/souleyez/main.py

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

{souleyez-2.43.2 → souleyez-2.43.8}/souleyez/storage/engagements.py

@@ -125,8 +125,12 @@ class EngagementManager:
             # File contains invalid data, reset to default
             pass
 
-        # Reset to default engagement
-        default_id = self.create("default", "Default engagement")
+        # Reset to default engagement - use existing or create new
+        default_eng = self.get("default")
+        if default_eng:
+            default_id = default_eng['id']
+        else:
+            default_id = self.create("default", "Default engagement")
         self.set_current("default")
         return self.get_by_id(default_id)
 

{souleyez-2.43.2 → souleyez-2.43.8}/souleyez/ui/dashboard.py

@@ -1392,9 +1392,20 @@ def render_active_jobs(width: int, engagement_id: Optional[int] = None):
             if engagement_id is not None and job_eng_id != engagement_id:
                 warning = click.style(" [!other]", fg='red')
 
-            job_line = f"  [{jid:>3}] {tool:<10} {target:<30} {status_str:<18} {elapsed}{warning}"
+            # Check for scope warnings
+            job_warnings = job.get('metadata', {}).get('warnings', [])
+            scope_warning = any('SCOPE' in w for w in job_warnings)
+            scope_indicator = click.style("⚠ ", fg='yellow') if scope_warning else ""
+
+            job_line = f"  [{jid:>3}] {scope_indicator}{tool:<10} {target:<30} {status_str:<18} {elapsed}{warning}"
             lines.append(job_line)
 
+            # Show scope warning details on next line if present
+            if scope_warning:
+                for w in job_warnings:
+                    if 'SCOPE' in w:
+                        lines.append(click.style(f"        └─ {w}", fg='yellow'))
+
     return lines
 
 

{souleyez-2.43.2 → souleyez-2.43.8}/souleyez/ui/interactive.py

@@ -17,6 +17,7 @@ from rich.table import Table
 from souleyez.ui.design_system import DesignSystem
 from souleyez.engine.loader import discover_plugins
 from souleyez.engine.background import enqueue_job, list_jobs, get_job
+from souleyez.security.scope_validator import ScopeViolationError
 from souleyez.storage.engagements import EngagementManager
 from souleyez.storage.hosts import HostManager
 from souleyez.storage.findings import FindingsManager
@@ -3955,19 +3956,29 @@ def launch_job(job_params: Dict[str, Any]) -> Optional[int]:
             click.echo()
 
             job_ids = []
+            blocked_targets = []
             for t in targets:
-                job_id = enqueue_job(
-                    tool=tool_name,
-                    target=t,
-                    args=args,
-                    label=label,
-                    metadata=metadata if metadata else None
-                )
-                job_ids.append(job_id)
-                click.echo(click.style(f"✓ Job #{job_id} enqueued for {t}", fg='green'))
+                try:
+                    job_id = enqueue_job(
+                        tool=tool_name,
+                        target=t,
+                        args=args,
+                        label=label,
+                        metadata=metadata if metadata else None
+                    )
+                    job_ids.append(job_id)
+                    click.echo(click.style(f"✓ Job #{job_id} enqueued for {t}", fg='green'))
+                except ScopeViolationError:
+                    blocked_targets.append(t)
+                    click.echo(click.style(f"✗ BLOCKED (out of scope): {t}", fg='red', bold=True))
 
             click.echo()
-            click.echo(click.style(f"✓ {len(job_ids)} jobs enqueued successfully!", fg='green', bold=True))
+            if blocked_targets:
+                click.echo(click.style(f"⚠ {len(blocked_targets)} targets blocked (out of scope)", fg='yellow', bold=True))
+            if job_ids:
+                click.echo(click.style(f"✓ {len(job_ids)} jobs enqueued successfully!", fg='green', bold=True))
+            else:
+                click.echo(click.style("✗ No jobs created - all targets blocked", fg='red', bold=True))
             click.echo(f"Tool: {tool_name}")
             if label:
                 click.echo(f"Label: {label}")
@@ -3998,6 +4009,15 @@ def launch_job(job_params: Dict[str, Any]) -> Optional[int]:
 
             return job_id  # Return the job_id
 
+    except ScopeViolationError as e:
+        click.echo()
+        click.echo(click.style("✗ JOB BLOCKED - OUT OF SCOPE", fg='red', bold=True))
+        click.echo(click.style(f"  Target: {job_params.get('target', 'unknown')}", fg='red'))
+        click.echo(click.style(f"  Reason: {e}", fg='yellow'))
+        click.echo()
+        click.echo(click.style("  Scope enforcement is set to 'block' for this engagement.", fg='cyan'))
+        click.echo(click.style("  Use 'souleyez scope' to view or modify scope settings.", fg='cyan'))
+        return None
     except Exception as e:
         click.echo(click.style(f"✗ Error enqueueing job: {e}", fg='red'))
         return None
@@ -4599,6 +4619,12 @@ def view_jobs_menu():
             rule_id = job.get('rule_id') or job.get('metadata', {}).get('rule_id')
             rule_display = f"#{rule_id}" if rule_id else '-'
 
+            # Check for scope warnings
+            job_warnings = job.get('metadata', {}).get('warnings', [])
+            scope_warning = any('SCOPE' in w for w in job_warnings)
+            if scope_warning:
+                target = f"[yellow]⚠[/yellow] {target}"
+
             # Checkbox based on selection
             checkbox = '●' if job_id_int in selected_jobs else '○'
             table.add_row(checkbox, jid, status_display, tool, target, label, parent_display, rule_display)
@@ -5048,6 +5074,7 @@ def _view_ai_suggestions(engagement_id: int):
                 # Accept all suggestions
                 if click.confirm(f"  Queue all {len(suggestions)} AI suggestions?", default=True):
                     queued = 0
+                    blocked = 0
                     for sug in suggestions:
                         try:
                             job_id = enqueue_job(
@@ -5059,12 +5086,17 @@ def _view_ai_suggestions(engagement_id: int):
                             )
                             if job_id:
                                 queued += 1
+                        except ScopeViolationError:
+                            blocked += 1
+                            click.echo(click.style(f"  ✗ BLOCKED: {sug['target']} (out of scope)", fg='red'))
                         except Exception as e:
                             pass
 
                     # Mark all as approved
                     _mark_suggestions_approved(engagement_id, [s for s in suggestions])
-                    click.echo(click.style(f"\n  ✓ Queued {queued} job(s)", fg='green'))
+                    if blocked:
+                        click.echo(click.style(f"\n  ⚠ {blocked} job(s) blocked (out of scope)", fg='yellow'))
+                    click.echo(click.style(f"  ✓ Queued {queued} job(s)", fg='green'))
                     click.pause()
                     return
                 continue
@@ -5147,6 +5179,11 @@ def _view_suggestion_detail(engagement_id: int, suggestion: dict, all_suggestion
                 )
                 _mark_suggestions_approved(engagement_id, [suggestion])
                 click.echo(click.style(f"\n  ✓ Queued job #{job_id}", fg='green'))
+            except ScopeViolationError as e:
+                click.echo()
+                click.echo(click.style("  ✗ JOB BLOCKED - OUT OF SCOPE", fg='red', bold=True))
+                click.echo(click.style(f"    Target: {suggestion['target']}", fg='red'))
+                click.echo(click.style(f"    Reason: {e}", fg='yellow'))
             except Exception as e:
                 click.echo(click.style(f"\n  ✗ Failed to queue: {e}", fg='red'))
             click.pause()
@@ -5435,6 +5472,13 @@ def view_job_detail(job_id: int):
         else:
             click.echo(f"Reason:  Manual (created by user)")
 
+        # Show scope warnings if any
+        warnings = metadata.get('warnings', [])
+        if warnings:
+            click.echo()
+            for warning in warnings:
+                click.echo(click.style(f"  ⚠ {warning}", fg='yellow', bold=True))
+
         if job.get('pid'):
             click.echo(f"PID:     {click.style(str(job['pid']), fg='cyan')}")
 

{souleyez-2.43.2 → souleyez-2.43.8}/souleyez/ui/tutorial.py

@@ -355,14 +355,15 @@ def _cleanup_tutorial_data():
                 except Exception:
                     pass
 
-        # Delete the engagement if it exists
+        # Reset current engagement BEFORE deleting tutorial engagement
+        # (otherwise get_current() will fail trying to load deleted engagement)
         if tutorial_eng:
-            em.delete("Tutorial Engagement")
+            current = em.get_current()
+            if current and current.get('id') == tutorial_eng['id']:
+                em.set_current("default")
 
-        # Clear current engagement if it was the tutorial
-        current = em.get_current()
-        if current and current.get('name') == 'Tutorial Engagement':
-            em.set_current(None)
+            # Now safe to delete the tutorial engagement
+            em.delete("Tutorial Engagement")
 
     except Exception as e:
         click.echo(click.style(f"  Note: Could not fully clean up: {e}", fg='yellow'))

{souleyez-2.43.2 → souleyez-2.43.8}/souleyez/utils/tool_checker.py

@@ -320,8 +320,8 @@ EXTERNAL_TOOLS = {
         },
         'responder': {
             'command': 'responder',
-            'install_kali': 'sudo apt install responder && sudo pip install aioquic',
-            'install_ubuntu': 'sudo git clone https://github.com/lgandx/Responder.git /opt/Responder && sudo pip install -r /opt/Responder/requirements.txt aioquic && sudo ln -sf /opt/Responder/Responder.py /usr/local/bin/responder',
+            'install_kali': 'sudo apt install responder && sudo pip install --break-system-packages --ignore-installed aioquic',
+            'install_ubuntu': 'sudo git clone https://github.com/lgandx/Responder.git /opt/Responder && sudo pip install --break-system-packages --ignore-installed -r /opt/Responder/requirements.txt aioquic && sudo ln -sf /opt/Responder/Responder.py /usr/local/bin/responder',
             'install_method': 'kali_only',
             'description': 'LLMNR, NBT-NS and MDNS poisoner',
             'needs_sudo': True  # Required for network poisoning

{souleyez-2.43.2 → souleyez-2.43.8/souleyez.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: souleyez
-Version: 2.43.2
+Version: 2.43.8
 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.2/souleyez/__init__.py

@@ -1,2 +0,0 @@
-__version__ = '2.43.2'
-