souleyez 2.43.29__py3-none-any.whl → 3.0.0__py3-none-any.whl

souleyez/ui/tutorial.py

@@ -18,6 +18,7 @@ from souleyez.ui.tutorial_state import get_tutorial_state, TutorialStep
 def clear_screen():
     """Clear the terminal screen."""
     from souleyez.ui.design_system import DesignSystem
+
     DesignSystem.clear_screen()
 
 
@@ -29,11 +30,11 @@ def wait_for_enter(prompt="Press Enter to continue..."):
 def show_header(title, subtitle=None):
     """Display a section header."""
     click.echo()
-    click.echo(click.style("=" * 60, fg='cyan'))
-    click.echo(click.style(f"  {title}", fg='cyan', bold=True))
+    click.echo(click.style("=" * 60, fg="cyan"))
+    click.echo(click.style(f"  {title}", fg="cyan", bold=True))
     if subtitle:
-        click.echo(click.style(f"  {subtitle}", fg='white'))
-    click.echo(click.style("=" * 60, fg='cyan'))
+        click.echo(click.style(f"  {subtitle}", fg="white"))
+    click.echo(click.style("=" * 60, fg="cyan"))
     click.echo()
 
 
@@ -58,7 +59,11 @@ def run_tutorial():
     click.echo("  2. Creating your first engagement")
     click.echo("  3. Enabling auto-chaining")
     click.echo("  4. Running reconnaissance scans")
-    click.echo("  5. " + click.style("Hands-on exploration", fg='yellow') + " of the Command Center")
+    click.echo(
+        "  5. "
+        + click.style("Hands-on exploration", fg="yellow")
+        + " of the Command Center"
+    )
     click.echo()
 
     wait_for_enter()
@@ -67,17 +72,39 @@ def run_tutorial():
     clear_screen()
     show_header("Step 1: Understanding Engagements")
 
-    click.echo("An " + click.style("engagement", fg='cyan', bold=True) + " is a container for all your pentest data.")
+    click.echo(
+        "An "
+        + click.style("engagement", fg="cyan", bold=True)
+        + " is a container for all your pentest data."
+    )
     click.echo()
     click.echo("Think of it like a project folder that keeps everything organized:")
     click.echo()
-    click.echo("  • " + click.style("Hosts", fg='green') + " - Target systems you discover")
-    click.echo("  • " + click.style("Services", fg='green') + " - Open ports and running software")
-    click.echo("  • " + click.style("Findings", fg='green') + " - Vulnerabilities you find")
-    click.echo("  • " + click.style("Credentials", fg='green') + " - Usernames, passwords, keys")
-    click.echo("  • " + click.style("Evidence", fg='green') + " - Screenshots, logs, artifacts")
-    click.echo()
-    click.echo("Each engagement is " + click.style("isolated", fg='yellow') + " - data from one")
+    click.echo(
+        "  • " + click.style("Hosts", fg="green") + " - Target systems you discover"
+    )
+    click.echo(
+        "  • "
+        + click.style("Services", fg="green")
+        + " - Open ports and running software"
+    )
+    click.echo(
+        "  • " + click.style("Findings", fg="green") + " - Vulnerabilities you find"
+    )
+    click.echo(
+        "  • "
+        + click.style("Credentials", fg="green")
+        + " - Usernames, passwords, keys"
+    )
+    click.echo(
+        "  • " + click.style("Evidence", fg="green") + " - Screenshots, logs, artifacts"
+    )
+    click.echo()
+    click.echo(
+        "Each engagement is "
+        + click.style("isolated", fg="yellow")
+        + " - data from one"
+    )
     click.echo("pentest never mixes with another.")
     click.echo()
 
@@ -89,9 +116,11 @@ def run_tutorial():
 
     click.echo("Let's create a test engagement to practice with.")
     click.echo()
-    click.echo("We'll use a " + click.style("safe, legal target", fg='green', bold=True) + ":")
+    click.echo(
+        "We'll use a " + click.style("safe, legal target", fg="green", bold=True) + ":"
+    )
     click.echo()
-    click.echo("  " + click.style("vulnweb.com", fg='cyan'))
+    click.echo("  " + click.style("vulnweb.com", fg="cyan"))
     click.echo("  (Acunetix's intentionally vulnerable test domain)")
     click.echo()
 
@@ -111,14 +140,16 @@ def run_tutorial():
         # Check if tutorial engagement already exists
         existing = em.get("Tutorial Engagement")
         if existing:
-            engagement_id = existing['id']
-            click.echo(click.style("✓ Using existing Tutorial Engagement", fg='green'))
+            engagement_id = existing["id"]
+            click.echo(click.style("✓ Using existing Tutorial Engagement", fg="green"))
         else:
             engagement_id = em.create(
                 name="Tutorial Engagement",
-                description="Created by SoulEyez tutorial. Target: vulnweb.com"
+                description="Created by SoulEyez tutorial. Target: vulnweb.com",
+            )
+            click.echo(
+                click.style("✓ Created engagement: Tutorial Engagement", fg="green")
             )
-            click.echo(click.style("✓ Created engagement: Tutorial Engagement", fg='green'))
 
         # Set as current engagement
         em.set_current("Tutorial Engagement")
@@ -126,7 +157,7 @@ def run_tutorial():
         click.echo()
 
     except Exception as e:
-        click.echo(click.style(f"✗ Error creating engagement: {e}", fg='red'))
+        click.echo(click.style(f"✗ Error creating engagement: {e}", fg="red"))
         click.echo("Please check 'souleyez doctor' for issues.")
         wait_for_enter()
         return
@@ -137,13 +168,24 @@ def run_tutorial():
     clear_screen()
     show_header("Step 3: Enable Auto-Chaining")
 
-    click.echo("Before we scan, let's enable " + click.style("auto-chaining", fg='yellow', bold=True) + "!")
+    click.echo(
+        "Before we scan, let's enable "
+        + click.style("auto-chaining", fg="yellow", bold=True)
+        + "!"
+    )
     click.echo()
     click.echo("Auto-chaining is SoulEyez's killer feature:")
     click.echo()
-    click.echo("  • When recon finds a host → " + click.style("auto-queue nmap", fg='cyan'))
-    click.echo("  • When nmap finds HTTP → " + click.style("auto-queue gobuster, nikto", fg='cyan'))
-    click.echo("  • When nmap finds SSH → " + click.style("auto-queue hydra", fg='cyan'))
+    click.echo(
+        "  • When recon finds a host → " + click.style("auto-queue nmap", fg="cyan")
+    )
+    click.echo(
+        "  • When nmap finds HTTP → "
+        + click.style("auto-queue gobuster, nikto", fg="cyan")
+    )
+    click.echo(
+        "  • When nmap finds SSH → " + click.style("auto-queue hydra", fg="cyan")
+    )
     click.echo()
     click.echo("It thinks like a pentester and queues the logical next steps!")
     click.echo()
@@ -151,14 +193,19 @@ def run_tutorial():
     if click.confirm("Enable auto-chaining for this tutorial?", default=True):
         try:
             from souleyez.core.tool_chaining import ToolChaining
+
             chaining = ToolChaining()
             chaining.enable_chaining()
             click.echo()
-            click.echo(click.style("  ✓ Auto-chaining ENABLED!", fg='green', bold=True))
-            click.echo("  Mode: " + click.style("AUTO", fg='green') + " (chains execute immediately)")
+            click.echo(click.style("  ✓ Auto-chaining ENABLED!", fg="green", bold=True))
+            click.echo(
+                "  Mode: "
+                + click.style("AUTO", fg="green")
+                + " (chains execute immediately)"
+            )
             click.echo()
         except Exception as e:
-            click.echo(click.style(f"  Could not enable: {e}", fg='yellow'))
+            click.echo(click.style(f"  Could not enable: {e}", fg="yellow"))
             click.echo()
     else:
         click.echo()
@@ -171,23 +218,49 @@ def run_tutorial():
     clear_screen()
     show_header("Step 4: Running Your First Recon")
 
-    click.echo("Now let's run " + click.style("passive reconnaissance", fg='cyan', bold=True) + "!")
-    click.echo()
-    click.echo("We'll use " + click.style("theHarvester", fg='green', bold=True) + " to search URLScan.io")
+    click.echo(
+        "Now let's run "
+        + click.style("passive reconnaissance", fg="cyan", bold=True)
+        + "!"
+    )
+    click.echo()
+    click.echo(
+        "We'll use "
+        + click.style("theHarvester", fg="green", bold=True)
+        + " to search URLScan.io"
+    )
     click.echo("for emails, subdomains, and IPs related to our target.")
     click.echo()
-    click.echo("With " + click.style("auto-chaining ON", fg='yellow', bold=True) + ", when theHarvester finds hosts:")
-    click.echo("  → " + click.style("whois", fg='cyan') + " and " + click.style("dnsrecon", fg='cyan') + " will auto-queue")
-    click.echo("  → Found web servers trigger " + click.style("nmap", fg='cyan') + " scans")
+    click.echo(
+        "With "
+        + click.style("auto-chaining ON", fg="yellow", bold=True)
+        + ", when theHarvester finds hosts:"
+    )
+    click.echo(
+        "  → "
+        + click.style("whois", fg="cyan")
+        + " and "
+        + click.style("dnsrecon", fg="cyan")
+        + " will auto-queue"
+    )
+    click.echo(
+        "  → Found web servers trigger " + click.style("nmap", fg="cyan") + " scans"
+    )
     click.echo("  → And so on... SoulEyez chains tools intelligently!")
     click.echo()
 
     target_domain = "vulnweb.com"
 
-    queue_scan = click.confirm(f"Queue theHarvester against {target_domain}?", default=True)
+    queue_scan = click.confirm(
+        f"Queue theHarvester against {target_domain}?", default=True
+    )
     if queue_scan:
         click.echo()
-        click.echo(click.style("  ✓ Scan will start when you enter the Command Center!", fg='green'))
+        click.echo(
+            click.style(
+                "  ✓ Scan will start when you enter the Command Center!", fg="green"
+            )
+        )
         click.echo()
     else:
         click.echo()
@@ -200,21 +273,41 @@ def run_tutorial():
     clear_screen()
     show_header("Step 5: Entering the Command Center")
 
-    click.echo("Now for the " + click.style("hands-on", fg='yellow', bold=True) + " part!")
+    click.echo(
+        "Now for the " + click.style("hands-on", fg="yellow", bold=True) + " part!"
+    )
     click.echo()
-    click.echo("We're about to launch you into the " + click.style("Command Center", fg='cyan', bold=True) + " (dashboard).")
+    click.echo(
+        "We're about to launch you into the "
+        + click.style("Command Center", fg="cyan", bold=True)
+        + " (dashboard)."
+    )
     click.echo()
-    click.echo("The tutorial will continue there with " + click.style("interactive hints", fg='green') + ":")
+    click.echo(
+        "The tutorial will continue there with "
+        + click.style("interactive hints", fg="green")
+        + ":"
+    )
     click.echo()
     click.echo("  • You'll see your queued scans running")
     click.echo("  • Hints will guide you to explore different views")
     click.echo("  • Press the highlighted keys to navigate")
     click.echo()
     click.echo(click.style("Quick reference for the Command Center:", bold=True))
-    click.echo("  " + click.style("[j]", fg='yellow') + " Jobs queue    - See running scans")
-    click.echo("  " + click.style("[h]", fg='yellow') + " Hosts view    - See discovered targets")
-    click.echo("  " + click.style("[f]", fg='yellow') + " Findings      - See vulnerabilities")
-    click.echo("  " + click.style("[q]", fg='yellow') + " Quit          - Exit dashboard")
+    click.echo(
+        "  " + click.style("[j]", fg="yellow") + " Jobs queue    - See running scans"
+    )
+    click.echo(
+        "  "
+        + click.style("[h]", fg="yellow")
+        + " Hosts view    - See discovered targets"
+    )
+    click.echo(
+        "  " + click.style("[f]", fg="yellow") + " Findings      - See vulnerabilities"
+    )
+    click.echo(
+        "  " + click.style("[q]", fg="yellow") + " Quit          - Exit dashboard"
+    )
     click.echo()
 
     if click.confirm("Ready to enter the Command Center?", default=True):
@@ -226,29 +319,35 @@ def run_tutorial():
         if queue_scan:
             try:
                 from souleyez.engine.background import enqueue_job
+
                 click.echo()
                 click.echo("Starting scan...")
                 job_id = enqueue_job(
-                    tool='theharvester',
+                    tool="theharvester",
                     target=target_domain,
-                    args=['-b', 'urlscan', '-l', '500'],
-                    label='tutorial-recon',
-                    engagement_id=engagement_id
+                    args=["-b", "urlscan", "-l", "500"],
+                    label="tutorial-recon",
+                    engagement_id=engagement_id,
+                )
+                click.echo(
+                    click.style(f"  ✓ theHarvester queued (Job #{job_id})", fg="green")
                 )
-                click.echo(click.style(f"  ✓ theHarvester queued (Job #{job_id})", fg='green'))
             except Exception as e:
-                click.echo(click.style(f"  Note: Could not queue scan: {e}", fg='yellow'))
+                click.echo(
+                    click.style(f"  Note: Could not queue scan: {e}", fg="yellow")
+                )
 
         click.echo()
-        click.echo(click.style("Launching Command Center...", fg='cyan'))
+        click.echo(click.style("Launching Command Center...", fg="cyan"))
         time.sleep(1)
 
         # Launch the dashboard with tutorial mode active
         try:
             from souleyez.ui.dashboard import run_dashboard
+
             run_dashboard()
         except Exception as e:
-            click.echo(click.style(f"Could not launch dashboard: {e}", fg='red'))
+            click.echo(click.style(f"Could not launch dashboard: {e}", fg="red"))
             click.echo("You can launch it manually with: souleyez dashboard")
 
         # After dashboard exits, show completion
@@ -256,7 +355,7 @@ def run_tutorial():
     else:
         click.echo()
         click.echo("No problem! You can explore the Command Center anytime with:")
-        click.echo(click.style("  souleyez dashboard", fg='cyan'))
+        click.echo(click.style("  souleyez dashboard", fg="cyan"))
         click.echo()
         _show_tutorial_complete()
 
@@ -270,7 +369,11 @@ def _show_tutorial_complete():
     clear_screen()
     show_header("Tutorial Complete!")
 
-    click.echo(click.style("You're ready to start pentesting with SoulEyez!", fg='green', bold=True))
+    click.echo(
+        click.style(
+            "You're ready to start pentesting with SoulEyez!", fg="green", bold=True
+        )
+    )
     click.echo()
     click.echo("What you learned:")
     click.echo("  ✓ Engagements organize your pentest data")
@@ -280,21 +383,38 @@ def _show_tutorial_complete():
     click.echo()
     click.echo(click.style("Quick reference:", bold=True))
     click.echo()
-    click.echo("  " + click.style("souleyez dashboard", fg='cyan') + "    - Real-time Command Center")
-    click.echo("  " + click.style("souleyez interactive", fg='cyan') + "  - Menu-driven interface")
-    click.echo("  " + click.style("souleyez setup", fg='cyan') + "        - Install pentest tools")
-    click.echo("  " + click.style("souleyez doctor", fg='cyan') + "       - Diagnose issues")
+    click.echo(
+        "  "
+        + click.style("souleyez dashboard", fg="cyan")
+        + "    - Real-time Command Center"
+    )
+    click.echo(
+        "  "
+        + click.style("souleyez interactive", fg="cyan")
+        + "  - Menu-driven interface"
+    )
+    click.echo(
+        "  "
+        + click.style("souleyez setup", fg="cyan")
+        + "        - Install pentest tools"
+    )
+    click.echo(
+        "  " + click.style("souleyez doctor", fg="cyan") + "       - Diagnose issues"
+    )
     click.echo()
     click.echo(click.style("Practice targets (safe & legal):", bold=True))
     click.echo("  • vulnweb.com subdomains (Acunetix)")
     click.echo("  • demo.owasp-juice.shop (OWASP)")
     click.echo()
-    click.echo(click.style("⚠️  NEVER scan systems without permission!", fg='red', bold=True))
+    click.echo(
+        click.style("⚠️  NEVER scan systems without permission!", fg="red", bold=True)
+    )
     click.echo()
 
     # Always disable auto-chaining (it's a PRO feature, tutorial enabled for demo)
     try:
         from souleyez.core.tool_chaining import ToolChaining
+
         chaining = ToolChaining()
         chaining.disable_chaining()
     except Exception:
@@ -304,16 +424,27 @@ def _show_tutorial_complete():
     click.echo()
     if click.confirm("Clean up tutorial engagement and jobs?", default=True):
         _cleanup_tutorial_data()
-        click.echo(click.style("  ✓ Tutorial data cleaned up!", fg='green'))
+        click.echo(click.style("  ✓ Tutorial data cleaned up!", fg="green"))
     else:
-        click.echo("Tutorial engagement kept. Check results with: " + click.style("souleyez interactive", fg='cyan'))
+        click.echo(
+            "Tutorial engagement kept. Check results with: "
+            + click.style("souleyez interactive", fg="cyan")
+        )
 
     click.echo()
     click.echo("Need help?")
-    click.echo("  • In-app: Press " + click.style("[?]", fg='yellow') + " for contextual help")
-    click.echo("  • Full docs: " + click.style("souleyez interactive", fg='cyan') + " → Settings → " + click.style("[h]", fg='yellow') + " Help Center")
+    click.echo(
+        "  • In-app: Press " + click.style("[?]", fg="yellow") + " for contextual help"
+    )
+    click.echo(
+        "  • Full docs: "
+        + click.style("souleyez interactive", fg="cyan")
+        + " → Settings → "
+        + click.style("[h]", fg="yellow")
+        + " Help Center"
+    )
     click.echo()
-    click.echo(click.style("Happy hacking! 🎯", fg='cyan', bold=True))
+    click.echo(click.style("Happy hacking! 🎯", fg="cyan", bold=True))
     click.echo()
 
     wait_for_enter("Press Enter to exit tutorial...")
@@ -337,21 +468,20 @@ def _cleanup_tutorial_data():
 
         # Find tutorial engagement
         tutorial_eng = em.get("Tutorial Engagement")
-        engagement_id = tutorial_eng['id'] if tutorial_eng else None
+        engagement_id = tutorial_eng["id"] if tutorial_eng else None
 
         # Delete all tutorial jobs (by label OR by engagement_id)
         all_jobs = list_jobs(limit=500)
         for job in all_jobs:
-            is_tutorial_job = (
-                job.get('label') == 'tutorial-recon' or
-                (engagement_id and job.get('engagement_id') == engagement_id)
+            is_tutorial_job = job.get("label") == "tutorial-recon" or (
+                engagement_id and job.get("engagement_id") == engagement_id
             )
             if is_tutorial_job:
                 try:
                     # Kill if running, then delete
-                    if job.get('status') in ('running', 'queued'):
-                        kill_job(job['id'])
-                    delete_job(job['id'])
+                    if job.get("status") in ("running", "queued"):
+                        kill_job(job["id"])
+                    delete_job(job["id"])
                 except Exception:
                     pass
 
@@ -359,15 +489,15 @@ def _cleanup_tutorial_data():
         # (otherwise get_current() will fail trying to load deleted engagement)
         if tutorial_eng:
             current = em.get_current()
-            if current and current.get('id') == tutorial_eng['id']:
+            if current and current.get("id") == tutorial_eng["id"]:
                 em.set_current("default")
 
             # 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'))
+        click.echo(click.style(f"  Note: Could not fully clean up: {e}", fg="yellow"))
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     run_tutorial()

souleyez/ui/tutorial_state.py

@@ -13,22 +13,23 @@ import json
 
 class TutorialStep(Enum):
     """Tutorial steps in order."""
-    INACTIVE = auto()           # Tutorial not running
-    WELCOME = auto()            # Welcome screen
-    ENGAGEMENT_EXPLAIN = auto() # Explaining engagements
+
+    INACTIVE = auto()  # Tutorial not running
+    WELCOME = auto()  # Welcome screen
+    ENGAGEMENT_EXPLAIN = auto()  # Explaining engagements
     ENGAGEMENT_CREATE = auto()  # Creating first engagement
-    AUTOCHAIN_ENABLE = auto()   # Enabling auto-chaining
-    SCANS_QUEUE = auto()        # Queuing recon scans
-    DASHBOARD_INTRO = auto()    # Entered dashboard for first time
-    VIEW_JOBS = auto()          # Hint: press [j] for jobs
-    IN_JOB_QUEUE = auto()       # User is in job queue
-    VIEW_OSINT = auto()         # Hint: press [o] for OSINT
-    IN_OSINT_VIEW = auto()      # User is viewing OSINT
-    VIEW_HOSTS = auto()         # Hint: press [h] for hosts
-    IN_HOSTS_VIEW = auto()      # User is viewing hosts
-    VIEW_JOB_DETAILS = auto()   # Hint: press [j] again for job details
-    IN_JOB_DETAILS = auto()     # User viewing job details (interactive mode)
-    COMPLETE = auto()           # Tutorial complete
+    AUTOCHAIN_ENABLE = auto()  # Enabling auto-chaining
+    SCANS_QUEUE = auto()  # Queuing recon scans
+    DASHBOARD_INTRO = auto()  # Entered dashboard for first time
+    VIEW_JOBS = auto()  # Hint: press [j] for jobs
+    IN_JOB_QUEUE = auto()  # User is in job queue
+    VIEW_OSINT = auto()  # Hint: press [o] for OSINT
+    IN_OSINT_VIEW = auto()  # User is viewing OSINT
+    VIEW_HOSTS = auto()  # Hint: press [h] for hosts
+    IN_HOSTS_VIEW = auto()  # User is viewing hosts
+    VIEW_JOB_DETAILS = auto()  # Hint: press [j] again for job details
+    IN_JOB_DETAILS = auto()  # User viewing job details (interactive mode)
+    COMPLETE = auto()  # Tutorial complete
 
 
 # Hints for each step when user is in the dashboard
@@ -36,27 +37,27 @@ DASHBOARD_HINTS: Dict[TutorialStep, Dict[str, str]] = {
     TutorialStep.DASHBOARD_INTRO: {
         "title": "Welcome to the Command Center!",
         "hint": "This is your mission control - active jobs, stats, and recommendations.",
-        "action": "Press Enter to continue the tutorial..."
+        "action": "Press Enter to continue the tutorial...",
     },
     TutorialStep.VIEW_JOBS: {
         "title": "Check Your Queued Scans",
         "hint": "Your recon scans are now running! Let's check them out.",
-        "action": "Press [j] to open the Job Queue"
+        "action": "Press [j] to open the Job Queue",
     },
     TutorialStep.VIEW_OSINT: {
         "title": "View OSINT Discoveries",
         "hint": "Passive recon found domains, emails, IPs and more. Let's explore!",
-        "action": "Press [o] to open the OSINT view"
+        "action": "Press [o] to open the OSINT view",
     },
     TutorialStep.VIEW_HOSTS: {
         "title": "View Discovered Hosts",
         "hint": "As scans complete, hosts will appear here.",
-        "action": "Press [h] to open the Hosts view"
+        "action": "Press [h] to open the Hosts view",
     },
     TutorialStep.VIEW_JOB_DETAILS: {
         "title": "View Job Details",
         "hint": "Now let's learn to inspect individual scan results!",
-        "action": "Press [j] to go back to the Job Queue"
+        "action": "Press [j] to go back to the Job Queue",
     },
 }
 
@@ -65,15 +66,15 @@ JOB_QUEUE_HINTS: Dict[TutorialStep, Dict[str, str]] = {
     TutorialStep.IN_JOB_QUEUE: {
         "title": "This is the Job Queue",
         "hint": "Here you can see all queued, running, and completed scans.\n"
-               "  • White = queued  • Yellow = running  • Green = completed  • Red = failed\n"
-               "  With auto-chaining ON, new jobs will auto-queue based on findings!",
-        "action": "Press [q] to go back, then try [o] for OSINT"
+        "  • White = queued  • Yellow = running  • Green = completed  • Red = failed\n"
+        "  With auto-chaining ON, new jobs will auto-queue based on findings!",
+        "action": "Press [q] to go back, then try [o] for OSINT",
     },
     TutorialStep.IN_JOB_DETAILS: {
         "title": "View Job Details",
         "hint": "Type a job number to see its full output and results.\n"
-               "  Or press [i] for interactive mode with more options.",
-        "action": "Press [q] when done to complete the tutorial!"
+        "  Or press [i] for interactive mode with more options.",
+        "action": "Press [q] when done to complete the tutorial!",
     },
 }
 
@@ -82,9 +83,9 @@ OSINT_HINTS: Dict[TutorialStep, Dict[str, str]] = {
     TutorialStep.IN_OSINT_VIEW: {
         "title": "This is the OSINT View",
         "hint": "Passive recon discovered domains, emails, IPs and more.\n"
-               "  This data came from theHarvester, whois, and dnsrecon.\n"
-               "  No packets were sent to the target - all public sources!",
-        "action": "Press [q] to go back, then try [h] for Hosts"
+        "  This data came from theHarvester, whois, and dnsrecon.\n"
+        "  No packets were sent to the target - all public sources!",
+        "action": "Press [q] to go back, then try [h] for Hosts",
     },
 }
 
@@ -93,8 +94,8 @@ HOSTS_HINTS: Dict[TutorialStep, Dict[str, str]] = {
     TutorialStep.IN_HOSTS_VIEW: {
         "title": "This is the Hosts View",
         "hint": "As your scans discover targets, they appear here.\n"
-               "  Each host shows its IP, hostname, and discovered services.",
-        "action": "Press [q] to go back, then [j] for Job Details"
+        "  Each host shows its IP, hostname, and discovered services.",
+        "action": "Press [q] to go back, then [j] for Job Details",
     },
 }
 
@@ -113,10 +114,10 @@ class TutorialState:
                 show_hint(hint)
     """
 
-    _instance: Optional['TutorialState'] = None
-    STATE_FILE = Path.home() / '.souleyez' / '.tutorial_state.json'
+    _instance: Optional["TutorialState"] = None
+    STATE_FILE = Path.home() / ".souleyez" / ".tutorial_state.json"
 
-    def __new__(cls) -> 'TutorialState':
+    def __new__(cls) -> "TutorialState":
         if cls._instance is None:
             cls._instance = super().__new__(cls)
             cls._instance._initialized = False
@@ -136,20 +137,19 @@ class TutorialState:
             try:
                 with open(self.STATE_FILE) as f:
                     data = json.load(f)
-                    step_name = data.get('step', 'INACTIVE')
+                    step_name = data.get("step", "INACTIVE")
                     self.current_step = TutorialStep[step_name]
-                    self.engagement_id = data.get('engagement_id')
+                    self.engagement_id = data.get("engagement_id")
             except (json.JSONDecodeError, KeyError, FileNotFoundError):
                 self.current_step = TutorialStep.INACTIVE
 
     def _save_state(self):
         """Save tutorial state to file."""
         self.STATE_FILE.parent.mkdir(parents=True, exist_ok=True)
-        with open(self.STATE_FILE, 'w') as f:
-            json.dump({
-                'step': self.current_step.name,
-                'engagement_id': self.engagement_id
-            }, f)
+        with open(self.STATE_FILE, "w") as f:
+            json.dump(
+                {"step": self.current_step.name, "engagement_id": self.engagement_id}, f
+            )
 
     def start(self, engagement_id: Optional[int] = None):
         """Start the tutorial."""