pwn 0.5.615 → 0.5.617

data/documentation/diagrams/dot/reverse-engineering-flow.dot

@@ -1,21 +1,43 @@
-digraph "PWN Reverse Engineering Flow" {
-  rankdir=TB;
-  node [shape=box, style=rounded, fontname="Arial", fontsize=9];
+digraph "PWN_RE" {
+  graph [
+    label=<<B>Reverse Engineering &amp; Binary Exploitation</B><BR/><FONT POINT-SIZE="11" COLOR="#94a3b8">pwn-asm · Assembly · XXD · FFI · Radare2 banners</FONT>>,
+    labelloc=t, fontsize=20, fontname="Helvetica",
+    rankdir=LR, splines=spline, nodesep=0.45, ranksep=1.2,
+    bgcolor="#0f172a", fontcolor="#e2e8f0", pad=0.6, newrank=true
+  ];
+  node [fontname="Helvetica", fontsize=10, style="filled,rounded",
+        shape=box, penwidth=1.3, color="#334155", fontcolor="#0f172a"];
+  edge [fontname="Helvetica", fontsize=9, color="#94a3b8",
+        fontcolor="#cbd5e1", penwidth=1.3, arrowsize=0.8];
 
-  Binary [label="Binary / Firmware\n(ELF, PE, APK,\nSerial devices)", shape=box];
-  RE [label="RE Tools\n(XXD, Assembly,\nStrings, objdump,\nRadare/Ghidra via shell)"];
-  PWNRE [label="PWN::Plugins::\nAssembly, XXD,\nSerial, BusPirate"];
-  Analysis [label="Analysis\n(Deobfuscate, patch,\nidentify vulns)", shape=ellipse];
-  FuzzRE [label="Targeted Fuzzing"];
-  ExploitRE [label="Craft Exploit\n(ROP, shellcode)"];
-  Test [label="Validate in REPL"];
+  Bin [label="🔎  Binary / Firmware", fillcolor="#7dd3fc"];
 
-  Binary -> RE;
-  RE -> PWNRE;
-  PWNRE -> Analysis;
-  Analysis -> FuzzRE;
-  Analysis -> ExploitRE;
-  FuzzRE -> ExploitRE;
-  ExploitRE -> Test;
-  Test -> Binary [label="re-analyze"];
+  subgraph cluster_static {
+    label="Static"; fontcolor="#a7f3d0"; style=rounded;
+    color="#047857"; bgcolor="#022c22";
+    XXD  [label="Plugins::XXD\nhex dump / patch", fillcolor="#6ee7b7"];
+    BDBA [label="BlackDuckBinaryAnalysis\nSBOM · CVE match", fillcolor="#6ee7b7"];
+  }
+  subgraph cluster_disasm {
+    label="Disassemble"; fontcolor="#fde68a"; style=rounded;
+    color="#a16207"; bgcolor="#422006";
+    Asm    [label="Plugins::Assembly\nopcodes ↔ asm\nmulti-arch", fillcolor="#fcd34d"];
+    PwnAsm [label="pwn-asm REPL\nmultiline shellcode",             fillcolor="#fcd34d"];
+  }
+  subgraph cluster_dyn {
+    label="Dynamic"; fontcolor="#fecaca"; style=rounded;
+    color="#b91c1c"; bgcolor="#450a0a";
+    FFI  [label="PWN::FFI::Stdio\nnative calls",   fillcolor="#fda4af"];
+    Fuzz [label="Plugins::Fuzz\ntargeted crashes",  fillcolor="#fda4af"];
+  }
+  Xpl [label="Exploit PoC\nMetasploit module", fillcolor="#c4b5fd"];
+
+  Bin -> XXD  [color="#38bdf8"];
+  Bin -> BDBA [color="#38bdf8"];
+  XXD  -> Asm    [color="#f59e0b"];
+  BDBA -> PwnAsm [color="#f59e0b"];
+  Asm    -> FFI  [color="#fb7185"];
+  PwnAsm -> Fuzz [color="#fb7185"];
+  FFI  -> Xpl [color="#a78bfa"];
+  Fuzz -> Xpl [color="#a78bfa"];
 }

data/documentation/diagrams/dot/sdr-radio-flow.dot

@@ -0,0 +1,45 @@
+digraph "PWN_SDR" {
+  graph [
+    label=<<B>PWN::SDR — Software-Defined Radio &amp; RF Hacking</B><BR/><FONT POINT-SIZE="11" COLOR="#94a3b8">GQRX · FlipperZero · RFIDler · SonMicro · FrequencyAllocation</FONT>>,
+    labelloc=t, fontsize=20, fontname="Helvetica",
+    rankdir=LR, splines=spline, nodesep=0.45, ranksep=1.2,
+    bgcolor="#0f172a", fontcolor="#e2e8f0", pad=0.6, newrank=true
+  ];
+  node [fontname="Helvetica", fontsize=10, style="filled,rounded",
+        shape=box, penwidth=1.3, color="#334155", fontcolor="#0f172a"];
+  edge [fontname="Helvetica", fontsize=9, color="#94a3b8",
+        fontcolor="#cbd5e1", penwidth=1.3, arrowsize=0.8];
+
+  RF [label="📡  RF Spectrum", fillcolor="#fda4af"];
+
+  subgraph cluster_hw {
+    label="Hardware"; fontcolor="#a7f3d0"; style=rounded;
+    color="#047857"; bgcolor="#022c22";
+    SDRhw   [label="RTL-SDR / HackRF\n(via GQRX)",   fillcolor="#6ee7b7"];
+    Flipper [label="SDR::FlipperZero",               fillcolor="#6ee7b7"];
+    RFID    [label="SDR::RFIDler\nSonMicroRFID",     fillcolor="#6ee7b7"];
+  }
+  subgraph cluster_ctrl {
+    label="Control"; fontcolor="#fde68a"; style=rounded;
+    color="#a16207"; bgcolor="#422006";
+    GQRX  [label="SDR::GQRX\nremote control · scan\nspectrum snapshot", fillcolor="#fcd34d"];
+    Freq  [label="SDR::FrequencyAllocation\nband lookup",               fillcolor="#fcd34d"];
+    Scan  [label="bin/pwn_gqrx_scanner\nfast · iterative",               fillcolor="#fcd34d"];
+  }
+  subgraph cluster_dec {
+    label="Decode"; fontcolor="#ddd6fe"; style=rounded;
+    color="#6d28d9"; bgcolor="#2e1065";
+    Dec [label="SDR::Decoder::*\ndemod · protocol",  fillcolor="#c4b5fd"];
+    Obs [label="extro_observe\nrecord signal intel", fillcolor="#c4b5fd"];
+  }
+
+  RF -> SDRhw   [color="#fb7185"];
+  RF -> Flipper [color="#fb7185"];
+  RF -> RFID    [color="#fb7185"];
+  SDRhw   -> GQRX [color="#f59e0b"];
+  Flipper -> Freq [color="#f59e0b"];
+  RFID    -> Scan [color="#f59e0b"];
+  GQRX -> Dec [color="#a78bfa"];
+  Freq -> Dec [color="#a78bfa"];
+  Scan -> Obs [color="#a78bfa"];
+}

data/documentation/diagrams/dot/sessions-cron-automation.dot

@@ -1,17 +1,44 @@
-digraph "PWN Sessions, Cron & Scheduled Automation" {
-  rankdir=TB;
-  node [shape=box, style=rounded, fontname="Arial", fontsize=9];
+digraph "PWN_SessionsCron" {
+  graph [
+    label=<<B>Sessions ↔ Cron ↔ Swarm — Cross-Session Continuity</B>>,
+    labelloc=t, fontsize=20, fontname="Helvetica",
+    rankdir=LR, splines=spline, nodesep=0.5, ranksep=1.3,
+    bgcolor="#0f172a", fontcolor="#e2e8f0", pad=0.6, newrank=true
+  ];
+  node [fontname="Helvetica", fontsize=10, style="filled,rounded",
+        shape=box, penwidth=1.3, color="#334155", fontcolor="#0f172a"];
+  edge [fontname="Helvetica", fontsize=9, color="#94a3b8",
+        fontcolor="#cbd5e1", penwidth=1.3, arrowsize=0.8];
 
-  Agent [label="pwn-ai Agent / REPL"];
-  Sessions [label="PWN::Sessions\n(record/replay,\ntranscripts)", shape=cylinder, fillcolor=lightyellow];
-  Cron [label="PWN::Cron\n(scheduled tasks)", shape=ellipse, fillcolor=lightcoral];
-  Drivers [label="Drivers &\nBin Scripts"];
-  Memory [label="PWN::Memory", shape=cylinder, fillcolor=lightyellow];
+  Now [label="pwn-ai\n(interactive turn)", fillcolor="#7dd3fc"];
 
-  Agent -> Sessions [label="save / load"];
-  Cron -> Drivers [label="invoke on schedule"];
-  Cron -> Agent [label="run autonomous pwn-ai jobs"];
-  Drivers -> Agent [label="orchestrate"];
-  Sessions -> Memory [label="persist key facts"];
-  Memory -> Cron [label="use recalled context\nfor jobs"];
+  subgraph cluster_p {
+    label="~/.pwn/"; fontcolor="#fde68a"; style=rounded;
+    color="#a16207"; bgcolor="#422006";
+    Sess  [label="sessions/<id>.jsonl", shape=cylinder, fillcolor="#fcd34d"];
+    Cron  [label="cron/jobs.yml",       shape=cylinder, fillcolor="#fcd34d"];
+    Swarm [label="swarm/<id>/bus.jsonl",shape=cylinder, fillcolor="#fcd34d"];
+  }
+  {rank=same; Sess; Cron; Swarm}
+
+  subgraph cluster_later {
+    label="Later / Elsewhere"; fontcolor="#ddd6fe"; style=rounded;
+    color="#6d28d9"; bgcolor="#2e1065";
+    Reflect [label="learning_reflect\n(session_id)",   fillcolor="#c4b5fd"];
+    Fire    [label="crontab → PWN::Cron.run",           fillcolor="#c4b5fd"];
+    Resume  [label="agent_debate\n(swarm_id: ...)",     fillcolor="#c4b5fd"];
+  }
+  {rank=same; Reflect; Fire; Resume}
+
+  Next [label="Next pwn-ai session\ncontext restored", fillcolor="#7dd3fc"];
+
+  Now -> Sess  [label="append", color="#f59e0b"];
+  Now -> Cron  [label="cron_create", color="#f59e0b"];
+  Now -> Swarm [label="agent_ask", color="#f59e0b"];
+  Sess  -> Reflect [color="#a78bfa"];
+  Cron  -> Fire    [color="#a78bfa"];
+  Swarm -> Resume  [color="#a78bfa"];
+  Reflect -> Next [color="#38bdf8"];
+  Fire    -> Next [color="#38bdf8"];
+  Resume  -> Next [color="#38bdf8"];
 }

data/documentation/diagrams/dot/swarm-multi-agent.dot

@@ -0,0 +1,70 @@
+digraph "PWN_Swarm" {
+  graph [
+    label=<<B>PWN::AI::Agent::Swarm — Native Multi-Agent Orchestration</B><BR/><FONT POINT-SIZE="11" COLOR="#94a3b8">personas · ask · debate · broadcast · shared bus (no daemon)</FONT>>,
+    labelloc=t, fontsize=20, fontname="Helvetica",
+    rankdir=TB, splines=spline, nodesep=0.65, ranksep=1.0,
+    bgcolor="#0f172a", fontcolor="#e2e8f0", pad=0.6, newrank=true, compound=true
+  ];
+  node [fontname="Helvetica", fontsize=11, style="filled,rounded",
+        shape=box, penwidth=1.4, color="#334155", fontcolor="#0f172a"];
+  edge [fontname="Helvetica", fontsize=9, color="#94a3b8",
+        fontcolor="#cbd5e1", penwidth=1.3, arrowsize=0.8];
+
+  /* L0 ─ orchestrator */
+  Orchestrator [label="👤  Orchestrator\n(you, in pwn-ai)", fillcolor="#7dd3fc"];
+
+  /* L1 ─ swarm verbs */
+  subgraph cluster_verbs {
+    label="Swarm Verbs  (toolset: swarm)"; fontcolor="#ddd6fe";
+    style=rounded; color="#6d28d9"; bgcolor="#2e1065"; penwidth=2;
+    Spawn     [label="agent_spawn\ndefine persona",          fillcolor="#c4b5fd"];
+    Ask       [label="agent_ask\n1 turn → 1 persona",         fillcolor="#c4b5fd"];
+    Debate    [label="agent_debate\nround-robin critique",    fillcolor="#c4b5fd"];
+    Broadcast [label="agent_broadcast\nfan-out ensemble",     fillcolor="#c4b5fd"];
+  }
+  {rank=same; Spawn; Ask; Debate; Broadcast}
+
+  /* L2 ─ personas */
+  subgraph cluster_personas {
+    label="Personas  (each = full PWN::AI::Agent::Loop)"; fontcolor="#a7f3d0";
+    style=rounded; color="#047857"; bgcolor="#022c22"; penwidth=2;
+    Red   [label="🔴  red_team\nengine: grok\ntoolsets: terminal,pwn",     fillcolor="#6ee7b7"];
+    Blue  [label="🔵  blue_team\nengine: anthropic\ntoolsets: pwn,extro",  fillcolor="#6ee7b7"];
+    Recon [label="🛰  recon\nengine: ollama\ntoolsets: terminal,memory",  fillcolor="#6ee7b7"];
+    Xpl   [label="💥  exploit_dev\nengine: openai\ntoolsets: pwn,skills",  fillcolor="#6ee7b7"];
+  }
+  {rank=same; Red; Blue; Recon; Xpl}
+
+  /* L3 ─ shared state */
+  subgraph cluster_state {
+    label="Shared State  ~/.pwn/"; fontcolor="#fde68a";
+    style=rounded; color="#a16207"; bgcolor="#422006"; penwidth=2;
+    Agents [label="agents.yml\npersona registry",         shape=cylinder, fillcolor="#fcd34d"];
+    Bus    [label="swarm/<id>/bus.jsonl\nappend-only chat", shape=cylinder, fillcolor="#fcd34d"];
+    Pmap   [label="swarm/<id>/personas.json\nname → session_id", shape=cylinder, fillcolor="#fcd34d"];
+    Sess   [label="sessions/*.jsonl\nper-persona transcript",     shape=cylinder, fillcolor="#fcd34d"];
+  }
+  {rank=same; Agents; Bus; Pmap; Sess}
+
+  /* edges */
+  Orchestrator -> Spawn     [color="#38bdf8"];
+  Orchestrator -> Ask       [color="#38bdf8"];
+  Orchestrator -> Debate    [color="#38bdf8", penwidth=2];
+  Orchestrator -> Broadcast [color="#38bdf8"];
+
+  Spawn     -> Red   [style=invis];
+  Ask       -> Red   [color="#34d399"];
+  Debate    -> Blue  [color="#34d399"];
+  Debate    -> Recon [color="#34d399"];
+  Broadcast -> Xpl   [color="#34d399"];
+
+  Red   -> Agents [style=invis];
+  Red   -> Bus  [label="append reply", color="#f59e0b"];
+  Blue  -> Bus  [color="#f59e0b"];
+  Recon -> Pmap [color="#f59e0b"];
+  Xpl   -> Sess [color="#f59e0b"];
+
+  Spawn -> Agents [label="write", color="#f59e0b", constraint=false];
+  Bus   -> Debate [label="tail → context", style=dashed, color="#fbbf24", constraint=false];
+  Bus   -> Orchestrator [label="swarm_bus()", style=dashed, color="#38bdf8", constraint=false];
+}

data/documentation/diagrams/dot/web-application-testing.dot

@@ -1,27 +1,49 @@
-digraph "Web Application Testing with PWN" {
-  rankdir=TB;
-  node [shape=box, style=rounded, fontname="Arial", fontsize=9];
-  edge [fontsize=8];
+digraph "PWN_Web" {
+  graph [
+    label=<<B>Web Application Testing</B><BR/><FONT POINT-SIZE="11" COLOR="#94a3b8">TransparentBrowser → BurpSuite (preferred) → SAST → Reports</FONT>>,
+    labelloc=t, fontsize=20, fontname="Helvetica",
+    rankdir=LR, splines=spline, nodesep=0.45, ranksep=1.2,
+    bgcolor="#0f172a", fontcolor="#e2e8f0", pad=0.6, newrank=true
+  ];
+  node [fontname="Helvetica", fontsize=10, style="filled,rounded",
+        shape=box, penwidth=1.3, color="#334155", fontcolor="#0f172a"];
+  edge [fontname="Helvetica", fontsize=9, color="#94a3b8",
+        fontcolor="#cbd5e1", penwidth=1.3, arrowsize=0.8];
 
-  App [label="Web App\n(URL, API, SPA)", shape=box];
+  Target [label="🌐  Web App\nURL / API", fillcolor="#fda4af"];
 
-  Proxy [label="Proxy Interception\n(BurpSuite (preferred),\nZaproxy)", shape=ellipse, fillcolor=lightblue];
-  Spider [label="Spider / Crawl\n(TransparentBrowser,\nSpider plugin)"];
-  ActiveScan [label="Active Scans\n(Burp active, ZAP active,\npwn_*_active_scan)"];
-  Manual [label="Manual + Assisted\n(URI Buster, XSS vectors,\nchar encodings, web_cache)"];
-  API [label="API Testing\n(OpenAPI, JSONPathify,\nGraphQL introspection)"];
-  AuthWeb [label="Auth & Session\n(OAuth2, BasicAuth,\nJWT handling)"];
-  Findings [label="Web Vulns\n(XSS, SQLi, IDOR,\nCache deception, etc.)", shape=box];
-  ReportWeb [label="PWN Reports"];
+  subgraph cluster_drive {
+    label="Drive Traffic"; fontcolor="#a7f3d0"; style=rounded;
+    color="#047857"; bgcolor="#022c22";
+    TB     [label="TransparentBrowser\nheadless · watir · devtools", fillcolor="#6ee7b7"];
+    Spider [label="Plugins::Spider\nURI buster",                     fillcolor="#6ee7b7"];
+    WWW    [label="PWN::WWW::*\n21 site drivers",                    fillcolor="#6ee7b7"];
+  }
+  subgraph cluster_proxy {
+    label="Intercept + Scan"; fontcolor="#fde68a"; style=rounded;
+    color="#a16207"; bgcolor="#422006";
+    Burp [label="BurpSuite  ⭐\nactive · passive · REST", fillcolor="#fcd34d", penwidth=2];
+    Zap  [label="Zaproxy\n(fallback)",                    fillcolor="#fcd34d"];
+  }
+  subgraph cluster_deep {
+    label="Deep Analysis"; fontcolor="#ddd6fe"; style=rounded;
+    color="#6d28d9"; bgcolor="#2e1065";
+    SAST [label="PWN::SAST\n48 rules on source",     fillcolor="#c4b5fd"];
+    XSS  [label="pwn_xss_dom_vectors\nweb_cache_deception", fillcolor="#c4b5fd"];
+    API  [label="Plugins::OpenAPI\nGraphQL introspection",  fillcolor="#c4b5fd"];
+  }
+  Report [label="PWN::Reports\nDefectDojo import", fillcolor="#7dd3fc"];
 
-  App -> Proxy;
-  Proxy -> Spider;
-  Spider -> ActiveScan;
-  ActiveScan -> Manual;
-  Manual -> API;
-  API -> AuthWeb;
-  AuthWeb -> Findings;
-  Findings -> ReportWeb;
-
-  Proxy -> Findings [label="intercept & modify"];
+  Target -> TB     [color="#fb7185"];
+  Target -> Spider [color="#fb7185"];
+  Target -> WWW    [color="#fb7185"];
+  TB     -> Burp   [label="proxy 127.0.0.1:8080", color="#f59e0b", penwidth=2];
+  Spider -> Burp   [color="#f59e0b"];
+  WWW    -> Zap    [color="#f59e0b"];
+  Burp   -> SAST   [color="#a78bfa"];
+  Burp   -> XSS    [color="#a78bfa"];
+  Zap    -> API    [color="#a78bfa"];
+  SAST   -> Report [color="#38bdf8"];
+  XSS    -> Report [color="#38bdf8"];
+  API    -> Report [color="#38bdf8"];
 }

data/documentation/diagrams/dot/zero-day-research-flow.dot

@@ -1,27 +1,49 @@
-digraph "PWN Zero-Day Research Workflow" {
-  rankdir=TB;
-  node [shape=box, style=rounded, fontname="Arial", fontsize=9];
-  edge [fontsize=8];
+digraph "PWN_ZeroDay" {
+  graph [
+    label=<<B>Zero-Day Research Lifecycle with PWN</B><BR/><FONT POINT-SIZE="11" COLOR="#94a3b8">attack surface → hypothesis → prove → weaponise → disclose</FONT>>,
+    labelloc=t, fontsize=20, fontname="Helvetica",
+    rankdir=LR, splines=spline, nodesep=0.45, ranksep=1.2,
+    bgcolor="#0f172a", fontcolor="#e2e8f0", pad=0.6, newrank=true
+  ];
+  node [fontname="Helvetica", fontsize=10, style="filled,rounded",
+        shape=box, penwidth=1.3, color="#334155", fontcolor="#0f172a"];
+  edge [fontname="Helvetica", fontsize=9, color="#94a3b8",
+        fontcolor="#cbd5e1", penwidth=1.3, arrowsize=0.8];
 
-  Target [label="Target Research\n(Binary, Firmware,\nProtocol, Web App)", shape=box];
-  RE [label="Reverse Engineering\n+ Static Analysis"];
-  SAST [label="PWN::SAST + Custom"];
-  Fuzz [label="Fuzzing + Protocol\nAnalysis"];
-  Dyn [label="Dynamic Analysis\n(REPL + Debug)"];
-  Memory [label="PWN Memory\n(historical vulns,\nreferences)", shape=cylinder];
-  Skill [label="Skills (prior\nzero-day patterns)", shape=cylinder];
-  Exploit [label="Exploit Dev\n& Validation"];
-  Disclose [label="Responsible Disclosure\n& Fix (Reports,\nHackerOne, etc.)"];
+  Surface [label="Attack Surface\nOpenAPI · Shodan · Git", fillcolor="#7dd3fc"];
 
-  Target -> RE;
-  Target -> SAST;
-  RE -> Fuzz;
-  SAST -> Fuzz;
-  Fuzz -> Dyn;
-  RE -> Dyn;
-  Memory -> RE [label="recall past findings"];
-  Skill -> Exploit [label="apply patterns"];
-  Dyn -> Exploit;
-  Exploit -> Disclose;
-  Disclose -> Memory [label="remember disclosure"];
+  subgraph cluster_hyp {
+    label="Hypothesise"; fontcolor="#a7f3d0"; style=rounded;
+    color="#047857"; bgcolor="#022c22";
+    SAST [label="PWN::SAST\ntaint patterns", fillcolor="#6ee7b7"];
+    AI   [label="pwn-ai\nAgent::VulnGen",    fillcolor="#6ee7b7"];
+  }
+  subgraph cluster_prove {
+    label="Prove"; fontcolor="#fde68a"; style=rounded;
+    color="#a16207"; bgcolor="#422006";
+    Fuzz [label="Fuzz · Sock\nPacket",        fillcolor="#fcd34d"];
+    TB   [label="TransparentBrowser\nBurp replay", fillcolor="#fcd34d"];
+  }
+  subgraph cluster_weapon {
+    label="Weaponise"; fontcolor="#fecaca"; style=rounded;
+    color="#b91c1c"; bgcolor="#450a0a";
+    Asm [label="Assembly\npwn-asm shellcode", fillcolor="#fda4af"];
+    MSF [label="Metasploit\nmodule",           fillcolor="#fda4af"];
+  }
+  subgraph cluster_disc {
+    label="Disclose"; fontcolor="#ddd6fe"; style=rounded;
+    color="#6d28d9"; bgcolor="#2e1065";
+    H1  [label="HackerOne\nBugCrowd · Synack",  fillcolor="#c4b5fd"];
+    Rep [label="Reports · Skills\ndistill_skill", fillcolor="#c4b5fd"];
+  }
+
+  Surface -> SAST [color="#38bdf8"];
+  Surface -> AI   [color="#38bdf8"];
+  SAST -> Fuzz [color="#f59e0b"];
+  AI   -> TB   [color="#f59e0b"];
+  Fuzz -> Asm  [color="#fb7185"];
+  TB   -> MSF  [color="#fb7185"];
+  Asm  -> H1   [color="#a78bfa"];
+  MSF  -> Rep  [color="#a78bfa"];
+  Rep  -> AI   [label="lesson → next hunt", style=dashed, color="#fbbf24", constraint=false];
 }

data/documentation/diagrams/driver-framework.svg

@@ -3,88 +3,109 @@
  "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
 <!-- Generated by graphviz version 14.1.2 (0)
  -->
-<!-- Title: PWN Driver Framework Pages: 1 -->
-<svg width="682pt" height="98pt"
- viewBox="0.00 0.00 682.00 98.00" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
-<g id="graph0" class="graph" transform="scale(1 1) rotate(0) translate(4 94)">
-<title>PWN Driver Framework</title>
-<polygon fill="white" stroke="none" points="-4,4 -4,-94 678,-94 678,4 -4,4"/>
-<!-- Parser -->
+<!-- Title: PWN_Driver Pages: 1 -->
+<svg width="728pt" height="440pt"
+ viewBox="0.00 0.00 728.00 440.00" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+<g id="graph0" class="graph" transform="scale(1 1) rotate(0) translate(43.2 397.2)">
+<title>PWN_Driver</title>
+<polygon fill="#0f172a" stroke="none" points="-43.2,43.2 -43.2,-397.2 684.45,-397.2 684.45,43.2 -43.2,43.2"/>
+<text xml:space="preserve" text-anchor="start" x="184.88" y="-332" font-family="sans-Serif" font-weight="bold" font-size="20.00" fill="#e2e8f0">Driver Anatomy — bin/pwn_*</text>
+<text xml:space="preserve" text-anchor="start" x="206.25" y="-320.55" font-family="sans-Serif" font-size="11.00" fill="#94a3b8">52 shipped drivers · thin CLI over PWN::Plugins</text>
+<g id="clust1" class="cluster">
+<title>cluster_d</title>
+<path fill="#022c22" stroke="#047857" d="M276,-8C276,-8 419,-8 419,-8 425,-8 431,-14 431,-20 431,-20 431,-223 431,-223 431,-229 425,-235 419,-235 419,-235 276,-235 276,-235 270,-235 264,-229 264,-223 264,-223 264,-20 264,-20 264,-14 270,-8 276,-8"/>
+<text xml:space="preserve" text-anchor="middle" x="347.5" y="-212" font-family="sans-Serif" font-size="20.00" fill="#a7f3d0">Driver Body</text>
+</g>
+<g id="clust3" class="cluster">
+<title>cluster_o</title>
+<path fill="#2e1065" stroke="#6d28d9" d="M521,-80C521,-80 621.25,-80 621.25,-80 627.25,-80 633.25,-86 633.25,-92 633.25,-92 633.25,-295 633.25,-295 633.25,-301 627.25,-307 621.25,-307 621.25,-307 521,-307 521,-307 515,-307 509,-301 509,-295 509,-295 509,-92 509,-92 509,-86 515,-80 521,-80"/>
+<text xml:space="preserve" text-anchor="middle" x="571.12" y="-284" font-family="sans-Serif" font-size="20.00" fill="#ddd6fe">Output</text>
+</g>
+<!-- Sh -->
 <g id="node1" class="node">
-<title>Parser</title>
-<path fill="none" stroke="black" d="M114.25,-63C114.25,-63 12,-63 12,-63 6,-63 0,-57 0,-51 0,-51 0,-39 0,-39 0,-33 6,-27 12,-27 12,-27 114.25,-27 114.25,-27 120.25,-27 126.25,-33 126.25,-39 126.25,-39 126.25,-51 126.25,-51 126.25,-57 120.25,-63 114.25,-63"/>
-<text xml:space="preserve" text-anchor="middle" x="63.12" y="-46.95" font-family="Arial" font-size="9.00">PWN::Driver::Parser</text>
-<text xml:space="preserve" text-anchor="middle" x="63.12" y="-36.45" font-family="Arial" font-size="9.00">(OptionParser + auto_opts)</text>
+<title>Sh</title>
+<path fill="#7dd3fc" stroke="#334155" stroke-width="1.3" d="M166,-88C166,-88 12,-88 12,-88 6,-88 0,-82 0,-76 0,-76 0,-64 0,-64 0,-58 6,-52 12,-52 12,-52 166,-52 166,-52 172,-52 178,-58 178,-64 178,-64 178,-76 178,-76 178,-82 172,-88 166,-88"/>
+<text xml:space="preserve" text-anchor="middle" x="89" y="-72.5" font-family="sans-Serif" font-size="10.00" fill="#0f172a">$ pwn_burp_suite_pro_active_scan \ </text>
+<text xml:space="preserve" text-anchor="middle" x="89" y="-60.5" font-family="sans-Serif" font-size="10.00" fill="#0f172a"> &#160;&#160;&#160;&#45;t https://target &#45;o out/</text>
 </g>
-<!-- Script -->
+<!-- Opt -->
 <g id="node2" class="node">
-<title>Script</title>
-<path fill="none" stroke="black" d="M255.5,-63C255.5,-63 174.25,-63 174.25,-63 168.25,-63 162.25,-57 162.25,-51 162.25,-51 162.25,-39 162.25,-39 162.25,-33 168.25,-27 174.25,-27 174.25,-27 255.5,-27 255.5,-27 261.5,-27 267.5,-33 267.5,-39 267.5,-39 267.5,-51 267.5,-51 267.5,-57 261.5,-63 255.5,-63"/>
-<text xml:space="preserve" text-anchor="middle" x="214.88" y="-46.95" font-family="Arial" font-size="9.00">Driver Script</text>
-<text xml:space="preserve" text-anchor="middle" x="214.88" y="-36.45" font-family="Arial" font-size="9.00">(bin/pwn_* or custom)</text>
+<title>Opt</title>
+<path fill="#6ee7b7" stroke="#334155" stroke-width="1.3" d="M378,-52C378,-52 317,-52 317,-52 311,-52 305,-46 305,-40 305,-40 305,-28 305,-28 305,-22 311,-16 317,-16 317,-16 378,-16 378,-16 384,-16 390,-22 390,-28 390,-28 390,-40 390,-40 390,-46 384,-52 378,-52"/>
+<text xml:space="preserve" text-anchor="middle" x="347.5" y="-36.5" font-family="sans-Serif" font-size="10.00" fill="#0f172a">OptionParser</text>
+<text xml:space="preserve" text-anchor="middle" x="347.5" y="-24.5" font-family="sans-Serif" font-size="10.00" fill="#0f172a">ARGV → opts{}</text>
 </g>
-<!-- Parser&#45;&gt;Script -->
-<g id="edge2" class="edge">
-<title>Parser&#45;&gt;Script</title>
-<path fill="none" stroke="black" d="M126.33,-38.34C134.42,-38.23 142.7,-38.22 150.8,-38.33"/>
-<polygon fill="black" stroke="black" points="150.5,-41.82 160.57,-38.51 150.64,-34.82 150.5,-41.82"/>
-</g>
-<!-- Script&#45;&gt;Parser -->
+<!-- Sh&#45;&gt;Opt -->
 <g id="edge1" class="edge">
-<title>Script&#45;&gt;Parser</title>
-<path fill="none" stroke="black" d="M162.08,-51.46C154.16,-51.66 145.85,-51.76 137.57,-51.75"/>
-<polygon fill="black" stroke="black" points="137.87,-48.25 127.85,-51.67 137.82,-55.25 137.87,-48.25"/>
+<title>Sh&#45;&gt;Opt</title>
+<path fill="none" stroke="#38bdf8" stroke-width="1.3" d="M178.63,-57.56C217.51,-52.1 261.78,-45.89 295.09,-41.22"/>
+<polygon fill="#38bdf8" stroke="#38bdf8" stroke-width="1.3" points="295.14,-44.04 302.67,-40.15 294.36,-38.49 295.14,-44.04"/>
 </g>
-<!-- PWNLoad -->
+<!-- Req -->
 <g id="node3" class="node">
-<title>PWNLoad</title>
-<path fill="none" stroke="black" d="M392.62,-90C392.62,-90 335.38,-90 335.38,-90 329.38,-90 323.38,-84 323.38,-78 323.38,-78 323.38,-66 323.38,-66 323.38,-60 329.38,-54 335.38,-54 335.38,-54 392.62,-54 392.62,-54 398.62,-54 404.62,-60 404.62,-66 404.62,-66 404.62,-78 404.62,-78 404.62,-84 398.62,-90 392.62,-90"/>
-<text xml:space="preserve" text-anchor="middle" x="364" y="-73.95" font-family="Arial" font-size="9.00">require &#39;pwn&#39;</text>
-<text xml:space="preserve" text-anchor="middle" x="364" y="-63.45" font-family="Arial" font-size="9.00">Full namespace</text>
+<title>Req</title>
+<path fill="#6ee7b7" stroke="#334155" stroke-width="1.3" d="M370.88,-124C370.88,-124 324.12,-124 324.12,-124 318.12,-124 312.12,-118 312.12,-112 312.12,-112 312.12,-100 312.12,-100 312.12,-94 318.12,-88 324.12,-88 324.12,-88 370.88,-88 370.88,-88 376.88,-88 382.88,-94 382.88,-100 382.88,-100 382.88,-112 382.88,-112 382.88,-118 376.88,-124 370.88,-124"/>
+<text xml:space="preserve" text-anchor="middle" x="347.5" y="-102.5" font-family="sans-Serif" font-size="10.00" fill="#0f172a">require &#39;pwn&#39;</text>
 </g>
-<!-- Script&#45;&gt;PWNLoad -->
-<g id="edge3" class="edge">
-<title>Script&#45;&gt;PWNLoad</title>
-<path fill="none" stroke="black" d="M267.75,-54.52C282.11,-57.15 297.68,-60.01 311.99,-62.64"/>
-<polygon fill="black" stroke="black" points="311.2,-66.05 321.66,-64.41 312.46,-59.17 311.2,-66.05"/>
-</g>
-<!-- standalone | cron | pwn&#45;ai -->
-<g id="node6" class="node">
-<title>standalone | cron | pwn&#45;ai</title>
-<path fill="none" stroke="black" d="M412.5,-36C412.5,-36 315.5,-36 315.5,-36 309.5,-36 303.5,-30 303.5,-24 303.5,-24 303.5,-12 303.5,-12 303.5,-6 309.5,0 315.5,0 315.5,0 412.5,0 412.5,0 418.5,0 424.5,-6 424.5,-12 424.5,-12 424.5,-24 424.5,-24 424.5,-30 418.5,-36 412.5,-36"/>
-<text xml:space="preserve" text-anchor="middle" x="364" y="-14.7" font-family="Arial" font-size="9.00">standalone | cron | pwn&#45;ai</text>
-</g>
-<!-- Script&#45;&gt;standalone | cron | pwn&#45;ai -->
-<g id="edge6" class="edge">
-<title>Script&#45;&gt;standalone | cron | pwn&#45;ai</title>
-<path fill="none" stroke="black" d="M267.75,-35.48C275.59,-34.04 283.81,-32.53 291.97,-31.03"/>
-<polygon fill="black" stroke="black" points="292.36,-34.52 301.56,-29.27 291.09,-27.64 292.36,-34.52"/>
+<!-- Sh&#45;&gt;Req -->
+<g id="edge2" class="edge">
+<title>Sh&#45;&gt;Req</title>
+<path fill="none" stroke="#38bdf8" stroke-width="1.3" d="M178.63,-82.44C220.28,-88.28 268.11,-95 302.03,-99.76"/>
+<polygon fill="#38bdf8" stroke="#38bdf8" stroke-width="1.3" points="301.39,-102.5 309.7,-100.84 302.17,-96.95 301.39,-102.5"/>
 </g>
-<!-- Orchestrate -->
+<!-- Call -->
 <g id="node4" class="node">
-<title>Orchestrate</title>
-<path fill="none" stroke="black" d="M550.75,-90C550.75,-90 472.5,-90 472.5,-90 466.5,-90 460.5,-84 460.5,-78 460.5,-78 460.5,-66 460.5,-66 460.5,-60 466.5,-54 472.5,-54 472.5,-54 550.75,-54 550.75,-54 556.75,-54 562.75,-60 562.75,-66 562.75,-66 562.75,-78 562.75,-78 562.75,-84 556.75,-90 550.75,-90"/>
-<text xml:space="preserve" text-anchor="middle" x="511.62" y="-73.95" font-family="Arial" font-size="9.00">Orchestration Logic</text>
-<text xml:space="preserve" text-anchor="middle" x="511.62" y="-63.45" font-family="Arial" font-size="9.00">(plugins + AI + loops)</text>
+<title>Call</title>
+<path fill="#6ee7b7" stroke="#334155" stroke-width="1.3" d="M411,-196C411,-196 284,-196 284,-196 278,-196 272,-190 272,-184 272,-184 272,-172 272,-172 272,-166 278,-160 284,-160 284,-160 411,-160 411,-160 417,-160 423,-166 423,-172 423,-172 423,-184 423,-184 423,-190 417,-196 411,-196"/>
+<text xml:space="preserve" text-anchor="middle" x="347.5" y="-174.5" font-family="sans-Serif" font-size="10.00" fill="#0f172a">PWN::Plugins::X.method(opts)</text>
+</g>
+<!-- Opt&#45;&gt;Call -->
+<g id="edge3" class="edge">
+<title>Opt&#45;&gt;Call</title>
+<path fill="none" stroke="#34d399" stroke-width="1.3" d="M304.47,-40.03C275.53,-46.57 239.42,-60.1 221,-88 212.18,-101.35 212.18,-110.65 221,-124 231.03,-139.19 246.3,-150.12 262.8,-157.98"/>
+<polygon fill="#34d399" stroke="#34d399" stroke-width="1.3" points="261.27,-160.36 269.72,-161.02 263.53,-155.24 261.27,-160.36"/>
 </g>
-<!-- PWNLoad&#45;&gt;Orchestrate -->
+<!-- Req&#45;&gt;Call -->
 <g id="edge4" class="edge">
-<title>PWNLoad&#45;&gt;Orchestrate</title>
-<path fill="none" stroke="black" d="M404.79,-72C418.42,-72 433.99,-72 448.93,-72"/>
-<polygon fill="black" stroke="black" points="448.68,-75.5 458.68,-72 448.68,-68.5 448.68,-75.5"/>
+<title>Req&#45;&gt;Call</title>
+<path fill="none" stroke="#34d399" stroke-width="1.3" d="M347.5,-124.56C347.5,-132.96 347.5,-141.37 347.5,-149.77"/>
+<polygon fill="#34d399" stroke="#34d399" stroke-width="1.3" points="344.7,-149.66 347.5,-157.66 350.3,-149.66 344.7,-149.66"/>
 </g>
-<!-- Outputs -->
+<!-- Std -->
 <g id="node5" class="node">
-<title>Outputs</title>
-<path fill="none" stroke="black" d="M662,-90C662,-90 610.75,-90 610.75,-90 604.75,-90 598.75,-84 598.75,-78 598.75,-78 598.75,-66 598.75,-66 598.75,-60 604.75,-54 610.75,-54 610.75,-54 662,-54 662,-54 668,-54 674,-60 674,-66 674,-66 674,-78 674,-78 674,-84 668,-90 662,-90"/>
-<text xml:space="preserve" text-anchor="middle" x="636.38" y="-73.95" font-family="Arial" font-size="9.00">Reports, Logs,</text>
-<text xml:space="preserve" text-anchor="middle" x="636.38" y="-63.45" font-family="Arial" font-size="9.00">Findings</text>
+<title>Std</title>
+<path fill="#c4b5fd" stroke="#334155" stroke-width="1.3" d="M613.25,-124C613.25,-124 529,-124 529,-124 523,-124 517,-118 517,-112 517,-112 517,-100 517,-100 517,-94 523,-88 529,-88 529,-88 613.25,-88 613.25,-88 619.25,-88 625.25,-94 625.25,-100 625.25,-100 625.25,-112 625.25,-112 625.25,-118 619.25,-124 613.25,-124"/>
+<text xml:space="preserve" text-anchor="middle" x="571.12" y="-102.5" font-family="sans-Serif" font-size="10.00" fill="#0f172a">STDOUT / STDERR</text>
 </g>
-<!-- Orchestrate&#45;&gt;Outputs -->
+<!-- Call&#45;&gt;Std -->
 <g id="edge5" class="edge">
-<title>Orchestrate&#45;&gt;Outputs</title>
-<path fill="none" stroke="black" d="M562.91,-72C570.91,-72 579.18,-72 587.14,-72"/>
-<polygon fill="black" stroke="black" points="587,-75.5 597,-72 587,-68.5 587,-75.5"/>
+<title>Call&#45;&gt;Std</title>
+<path fill="none" stroke="#a78bfa" stroke-width="1.3" d="M405.86,-159.36C436.91,-149.28 475.33,-136.8 507.2,-126.44"/>
+<polygon fill="#a78bfa" stroke="#a78bfa" stroke-width="1.3" points="507.82,-129.19 514.56,-124.05 506.09,-123.86 507.82,-129.19"/>
+</g>
+<!-- Rep -->
+<g id="node6" class="node">
+<title>Rep</title>
+<path fill="#c4b5fd" stroke="#334155" stroke-width="1.3" d="M599.38,-196C599.38,-196 542.88,-196 542.88,-196 536.88,-196 530.88,-190 530.88,-184 530.88,-184 530.88,-172 530.88,-172 530.88,-166 536.88,-160 542.88,-160 542.88,-160 599.38,-160 599.38,-160 605.38,-160 611.38,-166 611.38,-172 611.38,-172 611.38,-184 611.38,-184 611.38,-190 605.38,-196 599.38,-196"/>
+<text xml:space="preserve" text-anchor="middle" x="571.12" y="-174.5" font-family="sans-Serif" font-size="10.00" fill="#0f172a">PWN::Reports</text>
+</g>
+<!-- Call&#45;&gt;Rep -->
+<g id="edge6" class="edge">
+<title>Call&#45;&gt;Rep</title>
+<path fill="none" stroke="#a78bfa" stroke-width="1.3" d="M423.53,-178C455.55,-178 492.02,-178 520.58,-178"/>
+<polygon fill="#a78bfa" stroke="#a78bfa" stroke-width="1.3" points="520.37,-180.8 528.37,-178 520.37,-175.2 520.37,-180.8"/>
+</g>
+<!-- Ex -->
+<g id="node7" class="node">
+<title>Ex</title>
+<path fill="#c4b5fd" stroke="#334155" stroke-width="1.3" d="M587,-268C587,-268 555.25,-268 555.25,-268 549.25,-268 543.25,-262 543.25,-256 543.25,-256 543.25,-244 543.25,-244 543.25,-238 549.25,-232 555.25,-232 555.25,-232 587,-232 587,-232 593,-232 599,-238 599,-244 599,-244 599,-256 599,-256 599,-262 593,-268 587,-268"/>
+<text xml:space="preserve" text-anchor="middle" x="571.12" y="-246.5" font-family="sans-Serif" font-size="10.00" fill="#0f172a">exit code</text>
+</g>
+<!-- Call&#45;&gt;Ex -->
+<g id="edge7" class="edge">
+<title>Call&#45;&gt;Ex</title>
+<path fill="none" stroke="#a78bfa" stroke-width="1.3" d="M405.86,-196.64C446.07,-209.7 498.63,-226.77 533.34,-238.05"/>
+<polygon fill="#a78bfa" stroke="#a78bfa" stroke-width="1.3" points="532.28,-240.65 540.76,-240.46 534.01,-235.32 532.28,-240.65"/>
 </g>
 </g>
 </svg>