pwn 0.5.621 → 0.5.626

data/documentation/diagrams/dot/extrospection-world-awareness.dot

@@ -1,6 +1,6 @@
 digraph "PWN_Extrospection" {
   graph [
-    label=<<B>PWN::AI::Agent::Extrospection — World Awareness</B><BR/><FONT POINT-SIZE="11" COLOR="#94a3b8">snapshot · drift · observe · intel · watch · verify · correlate  —  host · net · toolchain · repo · env · rf · web</FONT>>,
+    label=<<B>PWN::AI::Agent::Extrospection — On-demand sensing + ambient baseline</B><BR/><FONT POINT-SIZE="11" COLOR="#94a3b8">PRIMARY: intel · verify · watch · rf_tune · osint · serial · telecomm · packet · vision · voice · observe  ·  SECONDARY: snapshot/drift (AUTO_SECTIONS=host/repo/env)</FONT>>,
     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
@@ -16,13 +16,19 @@ digraph "PWN_Extrospection" {
     color="#b91c1c"; bgcolor="#450a0a";
     Host  [label="host\nuname · distro · arch",       fillcolor="#fda4af"];
     Net   [label="net\ninterfaces · listening ports", fillcolor="#fda4af"];
-    Tool  [label="toolchain\nnmap · burp · msf · git", fillcolor="#fda4af"];
+    Tool  [label="toolchain (presence)\nnmap/git (safe --ver)\nburp/msf/gqrx PATH only", fillcolor="#fda4af"];
     Repo  [label="repo · env\nHEAD · dirty · ruby/gem", fillcolor="#fda4af"];
     RFhw  [label="rf  📡\nrtl-sdr · hackrf · flipper\ngqrx sock · serial devs", fillcolor="#fda4af"];
     Web   [label="web  🌐\nanchors · targets\nrendered DOM · TLS cert", fillcolor="#fda4af"];
     Feeds [label="intel feeds\nNVD · CIRCL · Exploit-DB", fillcolor="#fda4af"];
+    OSINT [label="osint  🕵️\nphone · FCC · patent\nIP/ASN · CT · person", fillcolor="#fda4af"];
+    Serial[label="serial  🔌\nttyUSB/ACM · by-id\nUART / AT modem", fillcolor="#fda4af"];
+    Telco [label="telecomm  ☎️\nBareSIP · SIP ports\nPSTN / VoIP", fillcolor="#fda4af"];
+    Pkt   [label="packet  📦\ntshark · tcpdump\npcap summarise", fillcolor="#fda4af"];
+    Vis   [label="vision  👁\ntesseract OCR\nzbar QR/barcode", fillcolor="#fda4af"];
+    Voice [label="voice  🔊\nespeak TTS · whisper STT\nsox / festival", fillcolor="#fda4af"];
   }
-  {rank=same; Host; Net; Tool; Repo; RFhw; Web; Feeds}
+  {rank=same; Host; Net; Tool; Repo; RFhw; Web; Feeds; OSINT; Serial; Telco; Pkt; Vis; Voice}
 
   /* col 0.5 ─ transport */
   TB [label="PWN::Plugins::\nTransparentBrowser\n:headless (→ :rest fallback)",
@@ -32,15 +38,22 @@ digraph "PWN_Extrospection" {
   subgraph cluster_eng {
     label="Extrospection Engine"; fontcolor="#fde68a"; style=rounded;
     color="#a16207"; bgcolor="#422006"; penwidth=2;
-    Snap  [label="extro_snapshot\nprobe_host/net/toolchain\nprobe_repo/env/rf/web", fillcolor="#fcd34d"];
+    Snap  [label="extro_snapshot\nprobe_host/net/toolchain/repo/env\nrf/web/osint/serial/telecomm\npacket/vision/voice\n(auto = host/repo/env only)", fillcolor="#fcd34d"];
     Drift [label="extro_drift\ndelta vs baseline",     fillcolor="#fcd34d"];
-    Obs   [label="extro_observe\nrecon · vuln · intel\ntarget · network · env · rf · web", fillcolor="#fcd34d"];
+    Obs   [label="extro_observe\nrecon · vuln · intel · target\nnetwork · env · rf · web\nosint · serial · telecomm\npacket · vision · voice", fillcolor="#fcd34d"];
     Intel [label="extro_intel\nCVE / exploit lookup",  fillcolor="#fcd34d"];
     Watch [label="extro_watch\nrender → DOM SHA-256\nscreenshot · TLS fp", fillcolor="#fcd34d"];
     Verify[label="extro_verify\n:cve · :version · :doc · :generic\n→ :confirmed | :refuted | :unknown", fillcolor="#fcd34d", penwidth=2];
+    RFTune[label="extro_rf_tune  📡\ntune GQRX · demod · strength\nRDS PI/PS/RadioText → now_playing", fillcolor="#fcd34d", penwidth=2];
+    OsintT[label="extro_osint  🕵️\npublic APIs aggregate\nphone · FCC · patent · person", fillcolor="#fcd34d", penwidth=2];
+    SerT  [label="extro_serial  🔌\nopen · payload · drain\nPWN::Plugins::Serial", fillcolor="#fcd34d", penwidth=2];
+    TelT  [label="extro_telecomm  ☎️\nBareSIP status/dial\ninventory SIP", fillcolor="#fcd34d", penwidth=2];
+    PktT  [label="extro_packet  📦\ncapture · summarise pcap\ntshark/PacketFu", fillcolor="#fcd34d", penwidth=2];
+    VisT  [label="extro_vision  👁\nOCR · barcode/QR", fillcolor="#fcd34d", penwidth=2];
+    VoxT  [label="extro_voice  🔊\nTTS · STT · inventory", fillcolor="#fcd34d", penwidth=2];
     Corr  [label="extro_correlate\njoin with Learning\n+ Mistakes + Memory", fillcolor="#fcd34d", penwidth=2];
   }
-  {rank=same; Snap; Drift; Obs; Intel; Watch; Verify; Corr}
+  {rank=same; Snap; Drift; Obs; Intel; Watch; Verify; RFTune; OsintT; SerT; TelT; PktT; VisT; VoxT; Corr}
 
   /* col 2 ─ store + prompt + feedback sinks */
   Store  [label="~/.pwn/\nextrospection.json", shape=cylinder, fillcolor="#fcd34d"];
@@ -55,6 +68,7 @@ digraph "PWN_Extrospection" {
   Tool  -> Drift [color="#fb7185"];
   Repo  -> Drift [color="#fb7185"];
   RFhw  -> Obs   [label="probe_rf", color="#fb7185"];
+  RFhw  -> RFTune[label="tune · RDS", color="#fb7185", penwidth=2];
   Feeds -> Intel [color="#fb7185"];
 
   Web   -> TB    [color="#fb7185"];
@@ -68,6 +82,19 @@ digraph "PWN_Extrospection" {
   Intel -> Store [label="record:true", color="#f59e0b"];
   Watch -> Store [label="category::web", color="#f59e0b"];
   Watch -> Shots [color="#f59e0b"];
+  RFTune-> Store [label="category::rf\nnow_playing", color="#f59e0b", penwidth=2];
+  OSINT -> OsintT[label="public APIs", color="#fb7185", penwidth=2];
+  Serial-> SerT  [label="UART I/O", color="#fb7185", penwidth=2];
+  Telco -> TelT  [label="SIP/HTTP", color="#fb7185", penwidth=2];
+  Pkt   -> PktT  [label="capture", color="#fb7185", penwidth=2];
+  Vis   -> VisT  [label="OCR", color="#fb7185", penwidth=2];
+  Voice -> VoxT  [label="TTS/STT", color="#fb7185", penwidth=2];
+  OsintT-> Store [label="category::osint", color="#f59e0b", penwidth=2];
+  SerT  -> Store [label="category::serial", color="#f59e0b"];
+  TelT  -> Store [label="category::telecomm", color="#f59e0b"];
+  PktT  -> Store [label="category::packet", color="#f59e0b"];
+  VisT  -> Store [label="category::vision", color="#f59e0b"];
+  VoxT  -> Store [label="category::voice", color="#f59e0b"];
   Verify-> Mist  [label=":refuted", color="#fb7185", penwidth=2];
   Verify-> Store [label=":confirmed\n:intel obs (ttl 30d)", color="#f59e0b"];
   Verify-> Mem   [label="revalidate_memory\nmark stale :fact", color="#a78bfa", style=dashed];

data/documentation/diagrams/dot/hardware-hacking.dot

@@ -26,7 +26,9 @@ digraph "PWN_Hardware" {
     MSR    [label="MSR206",             fillcolor="#6ee7b7"];
     Adb    [label="Android (adb)",      fillcolor="#6ee7b7"];
     Sip    [label="BareSIP · Voice",    fillcolor="#6ee7b7"];
-    Sdr    [label="SDR::GQRX · Flipper",fillcolor="#6ee7b7"];
+    Sdr    [label="SDR::GQRX · Flipper\nDecoder::* (run_iq)",fillcolor="#6ee7b7"];
+    FfiSdr [label="FFI::RTLSdr · HackRF\nAdalmPluto · SoapySDR\nVolk · Liquid · FFTW",fillcolor="#34d399"];
+    Sdr -> FfiSdr;
   }
   subgraph cluster_out {
     label="Analysis"; fontcolor="#ddd6fe"; style=rounded;

data/documentation/diagrams/dot/memory-skills-detailed.dot

@@ -29,8 +29,9 @@ digraph "PWN_MemorySkills" {
     Flrn [label="learning.jsonl\noutcome log",               shape=cylinder, fillcolor="#fcd34d"];
     Fses [label="sessions/*.jsonl\ntranscripts",              shape=cylinder, fillcolor="#fcd34d"];
     Fmis [label="mistakes.json\nsig → count · fix · regressed", shape=cylinder, fillcolor="#fcd34d"];
+    Fext [label="extrospection.json\nsnapshot · rf · web · obs", shape=cylinder, fillcolor="#fcd34d"];
   }
-  {rank=same; Fmem; Fskl; Flrn; Fses; Fmis}
+  {rank=same; Fmem; Fskl; Flrn; Fses; Fmis; Fext}
 
   subgraph cluster_read {
     label="Read-Side / Injection"; fontcolor="#ddd6fe"; style=rounded;
@@ -43,7 +44,7 @@ digraph "PWN_MemorySkills" {
   }
   {rank=same; Rec; Skv; Out; Sesv; Mlst}
 
-  Prompt [label="PromptBuilder\nMEMORY + SKILLS + LEARNING\n+ KNOWN MISTAKES / KNOWN FIXES", fillcolor="#7dd3fc", penwidth=2];
+  Prompt [label="PromptBuilder\nMEMORY + SKILLS + LEARNING\n+ KNOWN MISTAKES / FIXES\n+ METRICS + EXTROSPECTION", fillcolor="#7dd3fc", penwidth=2];
 
   Rem  -> Fmem [color="#f59e0b"];
   Skc  -> Fskl [color="#f59e0b"];
@@ -67,5 +68,6 @@ digraph "PWN_MemorySkills" {
 
   ReVal [label="Extrospection.verify\nrevalidate_memory (cron)\nbrowser-backed GC", fillcolor="#fcd34d"];
   ReVal -> Fmem [label="[UNVERIFIED yyyy-mm-dd]\nprefix stale :fact", color="#fb7185", style=dashed, penwidth=2];
+  ReVal -> Fext [label=":confirmed → :intel obs\n:refuted → observe stale", color="#f59e0b", style=dashed];
   Fmem  -> ReVal [label=":fact w/ CVE|ver|URL", style=dashed, color="#94a3b8", constraint=false];
 }

data/documentation/diagrams/dot/mistakes-negative-feedback.dot

@@ -12,14 +12,15 @@ digraph "PWN_Mistakes_Negative_Feedback" {
 
   /* L0 ─ ingest sources */
   subgraph cluster_in {
-    label="Four ingest paths"; fontcolor="#fecaca"; style="rounded,dashed";
+    label="Five ingest paths"; fontcolor="#fecaca"; style="rounded,dashed";
     color="#b91c1c"; bgcolor="#450a0a";
     ToolFail [label=":tool\nDispatch → success:false",           fillcolor="#fda4af"];
     LoopFail [label=":loop\niteration budget exhausted",          fillcolor="#fda4af"];
     UserCorr [label=":user_correction\n\"no that's wrong\" / \"still broken\"", fillcolor="#fda4af"];
     ModelRec [label=":model\nmistakes_record(tool, error)",       fillcolor="#fda4af"];
+    Verify  [label=":model (proactive)\nextro_verify → :refuted\n(browser-caught assumption)", fillcolor="#fda4af", penwidth=2];
   }
-  {rank=same; ToolFail; LoopFail; UserCorr; ModelRec}
+  {rank=same; ToolFail; LoopFail; UserCorr; ModelRec; Verify}
 
   /* L1 ─ fingerprint */
   subgraph cluster_fp {
@@ -61,6 +62,7 @@ digraph "PWN_Mistakes_Negative_Feedback" {
   LoopFail -> Norm [color="#fb7185"];
   UserCorr -> Sig  [label="+ flip_last_outcome", color="#fb7185"];
   ModelRec -> Sig  [color="#fb7185"];
+  Verify   -> Sig  [label="assumption", color="#fb7185", penwidth=2];
   Norm     -> Sig  [color="#34d399"];
 
   /* L1 → L2 */

data/documentation/diagrams/dot/overall-pwn-architecture.dot

@@ -37,9 +37,9 @@ digraph "PWN_Overall_Architecture" {
     label="PWN::AI::Agent"; fontcolor="#ddd6fe";
     style=rounded; color="#6d28d9"; bgcolor="#2e1065"; penwidth=2;
     Loop     [label="Loop\nplan → dispatch → observe",      fillcolor="#c4b5fd"];
-    Registry [label="Registry\n10 toolsets · 54 tools",    fillcolor="#c4b5fd"];
+    Registry [label="Registry\n10 toolsets · 55 tools",    fillcolor="#c4b5fd"];
     Swarm    [label="Swarm\npersonas · debate · bus",        fillcolor="#c4b5fd"];
-    Prompt   [label="PromptBuilder\nMEMORY · SKILLS\nMISTAKES · EXTRO",fillcolor="#c4b5fd"];
+    Prompt   [label="PromptBuilder\nMEMORY · SKILLS · LEARNING\nMISTAKES · METRICS · EXTRO",fillcolor="#c4b5fd"];
   }
   {rank=same; Loop; Registry; Swarm; Prompt}
 
@@ -67,7 +67,7 @@ digraph "PWN_Overall_Architecture" {
     Learn    [label="learning.jsonl",     shape=cylinder, fillcolor="#fcd34d"];
     Metrics  [label="metrics.json",       shape=cylinder, fillcolor="#fcd34d"];
     MistF    [label="mistakes.json",      shape=cylinder, fillcolor="#fcd34d"];
-    Extro    [label="extrospection.json\n+ rf + web snapshot", shape=cylinder, fillcolor="#fcd34d"];
+    Extro    [label="extrospection.json\nrf · web · observations", shape=cylinder, fillcolor="#fcd34d"];
     Sessions [label="sessions/*.jsonl",   shape=cylinder, fillcolor="#fcd34d"];
     SwarmB   [label="swarm/*/bus.jsonl",  shape=cylinder, fillcolor="#fcd34d"];
     CronF    [label="cron/jobs.yml",      shape=cylinder, fillcolor="#fcd34d"];

data/documentation/diagrams/dot/persistence-filesystem.dot

@@ -18,8 +18,8 @@ digraph "PWN_Persistence" {
   lrn  [label="learning.jsonl\ntask outcomes"];
   mis  [label="mistakes.json\nfailure fingerprints · fixes\n[REPEATING] · [REGRESSED]"];
   met  [label="metrics.json\nper-tool telemetry"];
-  ext  [label="extrospection.json\nhost snapshot + rf + web\n+ observations"];
-  ews  [label="extrospection/web/*.png\nheadless screenshots"];
+  ext  [label="extrospection.json\nsnapshot (host/net/tc/repo/env/rf/web)\n+ previous + observations[]"];
+  ews  [label="extrospection/web/*.png\nprobe_web / extro_watch shots"];
   ses  [label="sessions/*.jsonl\ntranscripts"];
   crn  [label="cron/jobs.yml\nscheduled jobs + logs"];
   agt  [label="agents.yml\npersona registry"];
@@ -27,5 +27,5 @@ digraph "PWN_Persistence" {
   hist [label="~/.pwn_history\nREPL history"];
 
   Root->cfg; Root->mem; Root->skl; Root->lrn; Root->mis; Root->met; Root->ext;
-  Root->ses; Root->crn; Root->agt; Root->swm; Root->hist;
+  Root->ews; Root->ses; Root->crn; Root->agt; Root->swm; Root->hist;
 }

data/documentation/diagrams/dot/pwn-ai-feedback-learning-loop.dot

@@ -37,11 +37,12 @@ digraph "PWN_AI_Feedback_Learning_Loop" {
   subgraph cluster_extro {
     label="EXTROSPECTION  (world)"; fontcolor="#fde68a";
     style=rounded; color="#a16207"; bgcolor="#422006"; penwidth=2;
-    Snapshot  [label="snapshot · drift\nhost/net/toolchain\nrepo/env/rf/web", fillcolor="#fcd34d"];
+    Snapshot  [label="snapshot · drift\nhost/net/toolchain\nrepo/env/rf/web\n(AUTO_SECTIONS=host/repo/env)", fillcolor="#fcd34d"];
     Observe   [label="observe · intel · watch\nrecon · CVE · web DOM",             fillcolor="#fcd34d"];
     Verify    [label="verify (browser)\nfact-check own claims\nrevalidate_memory", fillcolor="#fcd34d", penwidth=2];
+    RFTune    [label="rf_tune  📡\ntune GQRX · demod\nRDS → now_playing",           fillcolor="#fcd34d", penwidth=2];
   }
-  {rank=same; Metrics; Learning; Mistakes; Snapshot; Observe; Verify}
+  {rank=same; Metrics; Learning; Mistakes; Snapshot; Observe; Verify; RFTune}
 
   /* L3 ─ correlate */
   Correlate [label="extro_correlate()\n\"I did it wrong\"  vs  \"the world changed\"",
@@ -71,15 +72,17 @@ digraph "PWN_AI_Feedback_Learning_Loop" {
 
   /* L1 → L2 */
   Dispatch -> Metrics  [label="record()", color="#34d399"];
-  Result   -> Learning [label="auto_reflect", color="#34d399"];
+  Result   -> Learning [label="auto_introspect", color="#34d399"];
   Dispatch -> Mistakes [label="on failure\nrecord()", color="#fb7185", penwidth=2];
   User     -> Mistakes [label="\"that's wrong\"\ncheck_user_correction", color="#fb7185",
                         style=dashed, constraint=false];
   Dispatch -> Snapshot [label="probe", color="#f59e0b"];
-  Result   -> Observe  [label="auto_extrospect", color="#f59e0b"];
+  Result   -> Observe  [label="auto_extrospect\n(AUTO_SECTIONS only)", color="#f59e0b"];
   World    -> Snapshot [color="#fb7185", constraint=false];
   World    -> Observe  [color="#fb7185", constraint=false];
   World    -> Verify   [label="TransparentBrowser\n:headless", color="#38bdf8", constraint=false, penwidth=2];
+  World    -> RFTune   [label="GQRX remote\n:7356 + SDR", color="#fb7185", constraint=false, penwidth=2];
+  Dispatch -> Observe  [label="sense tools\nverify/watch/rf_tune/intel", color="#f59e0b", style=dashed, constraint=false];
 
   /* L2 → L3 */
   Metrics  -> Correlate [color="#34d399"];
@@ -88,6 +91,7 @@ digraph "PWN_AI_Feedback_Learning_Loop" {
   Snapshot -> Correlate [color="#f59e0b"];
   Observe  -> Correlate [color="#f59e0b"];
   Verify   -> Correlate [color="#f59e0b"];
+  RFTune   -> Correlate [color="#f59e0b"];
 
   /* L3 → L4 */
   Correlate -> Fmet [style=invis];
@@ -98,7 +102,9 @@ digraph "PWN_AI_Feedback_Learning_Loop" {
   Learning  -> Fmem [label="lesson", color="#94a3b8"];
   Learning  -> Fskl [label="skill",  color="#94a3b8"];
   Observe   -> Fext [color="#94a3b8"];
+  RFTune    -> Fext [label=":rf obs\nttl 300s", color="#94a3b8"];
   Verify    -> Fmis [label=":refuted →\nassumption mistake", color="#fb7185", penwidth=2];
+  Verify    -> Mistakes [label=":refuted", color="#fb7185", style=dashed, constraint=false];
   Verify    -> Fmem [label="mark stale\n[UNVERIFIED]", color="#a78bfa", style=dashed];
   Verify    -> Fext [label=":confirmed\n:intel obs", color="#94a3b8"];
 

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

@@ -1,8 +1,8 @@
 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 · Decoder::* (20 protocols)</FONT>>,
+    label=<<B>PWN::SDR — Software-Defined Radio &amp; RF Hacking</B><BR/><FONT POINT-SIZE="11" COLOR="#94a3b8">GQRX · FlipperZero · RFIDler · FrequencyAllocation · Decoder::* (20) · FFI::{Volk,Liquid,FFTW,HackRF,RTLSdr,SoapySDR}</FONT>>,
     labelloc=t, fontsize=20, fontname="Helvetica",
-    rankdir=LR, splines=spline, nodesep=0.45, ranksep=1.2,
+    rankdir=LR, splines=spline, nodesep=0.45, ranksep=1.1,
     bgcolor="#0f172a", fontcolor="#e2e8f0", pad=0.6, newrank=true
   ];
   node [fontname="Helvetica", fontsize=10, style="filled,rounded",
@@ -15,33 +15,56 @@ digraph "PWN_SDR" {
   subgraph cluster_hw {
     label="Hardware"; fontcolor="#a7f3d0"; style=rounded;
     color="#047857"; bgcolor="#022c22";
-    SDRhw   [label="RTL-SDR / HackRF\n(via GQRX / SoapySDR)", fillcolor="#6ee7b7"];
-    Flipper [label="SDR::FlipperZero",                        fillcolor="#6ee7b7"];
-    RFID    [label="SDR::RFIDler\nSonMicroRFID",              fillcolor="#6ee7b7"];
+    SDRhw   [label="RTL-SDR / HackRF / Airspy\n(via GQRX / SoapySDR / FFI)", fillcolor="#6ee7b7"];
+    Flipper [label="SDR::FlipperZero", fillcolor="#6ee7b7"];
+    RFID    [label="SDR::RFIDler\nSonMicroRFID", fillcolor="#6ee7b7"];
+  }
+  subgraph cluster_ffi {
+    label="PWN::FFI native backends"; fontcolor="#bae6fd"; style=rounded;
+    color="#0369a1"; bgcolor="#0c4a6e";
+    Volk   [label="FFI::Volk\nSIMD s16→f32 · accumulate", fillcolor="#7dd3fc"];
+    Liquid [label="FFI::Liquid\nfreqdem · msresamp · FIR", fillcolor="#7dd3fc"];
+    FFTW   [label="FFI::FFTW\nrfft · cfft · power-dB", fillcolor="#7dd3fc"];
+    Front  [label="FFI::{HackRF,RTLSdr,SoapySDR}\ninventory · raw I/Q", fillcolor="#7dd3fc"];
   }
   subgraph cluster_ctrl {
     label="Control · Scan"; fontcolor="#fde68a"; style=rounded;
     color="#a16207"; bgcolor="#422006";
-    GQRX  [label="SDR::GQRX\nremote control\nspectrum snapshot\n(median floor · DC null)", fillcolor="#fcd34d"];
-    Freq  [label="SDR::FrequencyAllocation\nband lookup",                                   fillcolor="#fcd34d"];
-    Scan  [label="bin/pwn_gqrx_scanner\n--fft-scan · iterative\n--min-snr-db · --avg",       fillcolor="#fcd34d"];
+    GQRX  [label="SDR::GQRX\nremote control\nspectrum + FFT geometry\n(RAW panorama · plan-param refine)", fillcolor="#fcd34d"];
+    Freq  [label="SDR::FrequencyAllocation\nband lookup\nplan_bw · precision", fillcolor="#fcd34d"];
+    Scan  [label="bin/pwn_gqrx_scanner\n--fft-scan · iterative\n--min-snr-db · --no-refine", fillcolor="#fcd34d"];
   }
   subgraph cluster_dec {
-    label="Decode · Record"; fontcolor="#ddd6fe"; style=rounded;
+    label="Decode · Sense · Record"; fontcolor="#ddd6fe"; style=rounded;
     color="#6d28d9"; bgcolor="#2e1065";
+    DSP [label="Decoder::DSP\npure-Ruby + FFI accel\n(unpack · resample · FSK)", fillcolor="#c4b5fd"];
     Dec [label="SDR::Decoder::*\nADSB · APT · BT · DECT · GPS\nGSM · Iridium · LoRa · LTE\nMorse · P25 · POCSAG/FLEX\nRDS · RFID · rtl_433 · RTTY\nWiFi · ZigBee", fillcolor="#c4b5fd"];
-    Obs [label="extro_observe\ncategory: :rf\nrecord signal intel", fillcolor="#c4b5fd"];
+    Obs [label="extro_observe\ncategory: :rf", fillcolor="#c4b5fd"];
     Xrf [label="extro_snapshot :rf\nprobe_rf → hw inventory", fillcolor="#c4b5fd"];
+    Tune[label="extro_rf_tune  📡\ntune · demod · strength\nRDS.sample → now_playing", fillcolor="#c4b5fd", penwidth=2];
   }
 
   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"];
+  SDRhw -> Front [color="#38bdf8"];
+  SDRhw -> GQRX  [color="#f59e0b"];
+  Front -> Volk   [style=dashed, color="#38bdf8"];
+  Front -> Liquid [style=dashed, color="#38bdf8"];
+  Front -> FFTW   [style=dashed, color="#38bdf8"];
+  Volk   -> DSP [color="#a78bfa"];
+  Liquid -> DSP [color="#a78bfa"];
+  FFTW   -> DSP [color="#a78bfa"];
+  GQRX -> DSP [color="#a78bfa"];
+  GQRX -> Tune [label="remote :7356", color="#f59e0b", penwidth=2];
+  DSP  -> Dec [color="#a78bfa"];
   Freq -> Dec [color="#a78bfa"];
-  Scan -> Obs [color="#a78bfa"];
-  SDRhw -> Xrf [style=dashed, color="#fbbf24", constraint=false];
+  Flipper -> Freq [color="#f59e0b"];
+  RFID  -> Scan [color="#f59e0b"];
+  Freq  -> Scan [label="plan_bw/step", color="#f59e0b"];
+  Scan  -> Obs  [color="#a78bfa"];
+  Front -> Xrf  [style=dashed, color="#fbbf24", constraint=false];
+  Dec   -> Obs  [style=dashed, color="#c4b5fd"];
+  Tune  -> Obs  [label="category::rf\nttl 300s", color="#a78bfa", penwidth=2];
+  Tune  -> Dec  [label="RDS.sample", style=dashed, color="#c4b5fd"];
 }

data/documentation/diagrams/driver-framework.svg

@@ -9,31 +9,31 @@
 <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="Helvetica,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="Helvetica,sans-Serif" font-size="11.00" fill="#94a3b8">52 shipped drivers · thin CLI over PWN::Plugins</text>
+<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="Helvetica,sans-Serif" font-size="20.00" fill="#a7f3d0">Driver Body</text>
+<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="Helvetica,sans-Serif" font-size="20.00" fill="#ddd6fe">Output</text>
+<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>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="Helvetica,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="Helvetica,sans-Serif" font-size="10.00" fill="#0f172a"> &#160;&#160;&#160;&#45;t https://target &#45;o out/</text>
+<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>
 <!-- Opt -->
 <g id="node2" class="node">
 <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="Helvetica,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="Helvetica,sans-Serif" font-size="10.00" fill="#0f172a">ARGV → opts{}</text>
+<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>
 <!-- Sh&#45;&gt;Opt -->
 <g id="edge1" class="edge">
@@ -45,7 +45,7 @@
 <g id="node3" class="node">
 <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="Helvetica,sans-Serif" font-size="10.00" fill="#0f172a">require &#39;pwn&#39;</text>
+<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>
 <!-- Sh&#45;&gt;Req -->
 <g id="edge2" class="edge">
@@ -57,7 +57,7 @@
 <g id="node4" class="node">
 <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="Helvetica,sans-Serif" font-size="10.00" fill="#0f172a">PWN::Plugins::X.method(opts)</text>
+<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">
@@ -75,7 +75,7 @@
 <g id="node5" class="node">
 <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="Helvetica,sans-Serif" font-size="10.00" fill="#0f172a">STDOUT / STDERR</text>
+<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>
 <!-- Call&#45;&gt;Std -->
 <g id="edge5" class="edge">
@@ -87,7 +87,7 @@
 <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="Helvetica,sans-Serif" font-size="10.00" fill="#0f172a">PWN::Reports</text>
+<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">
@@ -99,7 +99,7 @@
 <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="Helvetica,sans-Serif" font-size="10.00" fill="#0f172a">exit code</text>
+<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">