pwn 0.5.618 → 0.5.620

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

@@ -0,0 +1,93 @@
+digraph "PWN_Mistakes_Negative_Feedback" {
+  graph [
+    label=<<B>PWN::AI::Agent::Mistakes — Negative-Feedback Loop</B><BR/><FONT POINT-SIZE="11" COLOR="#94a3b8">learn from mistakes · do NOT repeat them · cross-session · self-correcting</FONT>>,
+    labelloc=t, fontsize=20, fontname="Helvetica",
+    rankdir=TB, splines=spline, nodesep=0.6, 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 ─ ingest sources */
+  subgraph cluster_in {
+    label="Four 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"];
+  }
+  {rank=same; ToolFail; LoopFail; UserCorr; ModelRec}
+
+  /* L1 ─ fingerprint */
+  subgraph cluster_fp {
+    label="Fingerprint  (stable across sessions)"; fontcolor="#a7f3d0"; style=rounded;
+    color="#047857"; bgcolor="#022c22"; penwidth=2;
+    Norm [label="normalize_error()\nstrip paths · :LINE · 0xADDR\nport N · TIMESTAMP · UUID · pid", fillcolor="#6ee7b7"];
+    Sig  [label="signature = sha12(tool + norm)\ncount++  (cross-session)",                          fillcolor="#6ee7b7", penwidth=2];
+  }
+  {rank=same; Norm; Sig}
+
+  /* L2 ─ ledger */
+  Store [label="~/.pwn/mistakes.json\n{sig → tool·error·count·fix\n resolved·regressed·sessions}",
+         shape=cylinder, fillcolor="#fcd34d", penwidth=2];
+
+  /* L3 ─ reactions */
+  subgraph cluster_react {
+    label="Reactions inside Loop.run"; fontcolor="#ddd6fe"; style=rounded;
+    color="#6d28d9"; bgcolor="#2e1065"; penwidth=2;
+    Guard [label="guard_repeated_failure\nmax(turn, PERSISTENT count) ≥ 3\n→ trips on 1st recurrence\nin a new session", fillcolor="#c4b5fd"];
+    Hint  [label="correction_hint\nappend to failed result:\n\"seen N×, sig=…, KNOWN FIX: …\"\n→ self-correct NEXT iter",  fillcolor="#c4b5fd"];
+    Regr  [label="[REGRESSED]\nresolved sig recurs\n→ reopen + tag",                                                       fillcolor="#c4b5fd"];
+  }
+  {rank=same; Guard; Hint; Regr}
+
+  /* L4 ─ outputs */
+  subgraph cluster_out {
+    label="Injected into every future prompt"; fontcolor="#fde68a"; style=rounded;
+    color="#a16207"; bgcolor="#422006"; penwidth=2;
+    KMist [label="KNOWN MISTAKES\n✗ [sig] tool ×N [REPEATING]…", fillcolor="#fcd34d"];
+    KFix  [label="KNOWN FIXES\n✓ [sig] tool — FIX: …",            fillcolor="#fcd34d"];
+    Mem   [label="PWN::Memory :lesson\n\"AVOID X — FIX: Y\"",       fillcolor="#fcd34d"];
+  }
+  {rank=same; KMist; KFix; Mem}
+
+  Prompt [label="PromptBuilder\nsystem prompt", fillcolor="#7dd3fc", penwidth=2];
+
+  /* L0 → L1 */
+  ToolFail -> Norm [label="record()", color="#fb7185"];
+  LoopFail -> Norm [color="#fb7185"];
+  UserCorr -> Sig  [label="+ flip_last_outcome", color="#fb7185"];
+  ModelRec -> Sig  [color="#fb7185"];
+  Norm     -> Sig  [color="#34d399"];
+
+  /* L1 → L2 */
+  Sig -> Store [label="persist", color="#f59e0b", penwidth=2];
+
+  /* L2 → L3 */
+  Store -> Guard [label="count", color="#a78bfa"];
+  Store -> Hint  [label="fix?",  color="#a78bfa"];
+  Store -> Regr  [label="resolved∧recur", color="#a78bfa"];
+
+  /* L3 → L4 */
+  Guard -> KMist [color="#f59e0b"];
+  Hint  -> KFix  [style=invis];
+  Regr  -> KMist [color="#f59e0b"];
+
+  /* resolve path */
+  Resolve [label="mistakes_resolve\n(signature, fix)", fillcolor="#6ee7b7", penwidth=2];
+  {rank=same; Store; Resolve}
+  Resolve -> Store [label="resolved:true\nfix:…", color="#34d399", penwidth=2];
+  Resolve -> KFix  [color="#f59e0b"];
+  Resolve -> Mem   [label="promote", color="#f59e0b"];
+
+  /* L4 → prompt (feedback, dashed) */
+  KMist -> Prompt [label="do NOT repeat", style=dashed, color="#fb7185", constraint=false, penwidth=2];
+  KFix  -> Prompt [label="do THIS instead", style=dashed, color="#fbbf24", constraint=false, penwidth=2];
+  Mem   -> Prompt [label="MEMORY block", style=dashed, color="#fbbf24", constraint=false];
+  KMist -> Prompt [style=invis];
+  KFix  -> Prompt [style=invis];
+  Mem   -> Prompt [style=invis];
+}

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 · 45+ tools",    fillcolor="#c4b5fd"];
+    Registry [label="Registry\n10 toolsets · 52 tools",    fillcolor="#c4b5fd"];
     Swarm    [label="Swarm\npersonas · debate · bus",        fillcolor="#c4b5fd"];
-    Prompt   [label="PromptBuilder\nMEMORY · SKILLS · EXTRO",fillcolor="#c4b5fd"];
+    Prompt   [label="PromptBuilder\nMEMORY · SKILLS\nMISTAKES · EXTRO",fillcolor="#c4b5fd"];
   }
   {rank=same; Loop; Registry; Swarm; Prompt}
 
@@ -51,7 +51,7 @@ digraph "PWN_Overall_Architecture" {
     SAST    [label="SAST\n48 rules",          fillcolor="#6ee7b7"];
     WWW     [label="WWW\n21 site drivers",    fillcolor="#6ee7b7"];
     AWS     [label="AWS\n90 services",        fillcolor="#6ee7b7"];
-    SDR     [label="SDR\nGQRX · Flipper · RFID", fillcolor="#6ee7b7"];
+    SDR     [label="SDR\nGQRX · Flipper · RFID\nDecoder::* (20)", fillcolor="#6ee7b7"];
     Chain   [label="Blockchain\nBTC · ETH",   fillcolor="#6ee7b7"];
     Bounty  [label="Bounty\nlifecycle replay", fillcolor="#6ee7b7"];
     Reports [label="Reports\nHTML · JSON",    fillcolor="#6ee7b7"];
@@ -66,12 +66,13 @@ digraph "PWN_Overall_Architecture" {
     Skills   [label="skills/*.md",        shape=cylinder, fillcolor="#fcd34d"];
     Learn    [label="learning.jsonl",     shape=cylinder, fillcolor="#fcd34d"];
     Metrics  [label="metrics.json",       shape=cylinder, fillcolor="#fcd34d"];
-    Extro    [label="extrospection.json", shape=cylinder, fillcolor="#fcd34d"];
+    MistF    [label="mistakes.json",      shape=cylinder, fillcolor="#fcd34d"];
+    Extro    [label="extrospection.json\n+ rf snapshot", 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"];
   }
-  {rank=same; Memory; Skills; Learn; Metrics; Extro; Sessions; SwarmB; CronF}
+  {rank=same; Memory; Skills; Learn; Metrics; MistF; Extro; Sessions; SwarmB; CronF}
 
   /* ── L0 → L1 ── */
   User -> REPL   [color="#38bdf8"];
@@ -102,6 +103,7 @@ digraph "PWN_Overall_Architecture" {
   SAST    -> Skills   [color="#f59e0b"];
   WWW     -> Learn    [color="#f59e0b"];
   AWS     -> Metrics  [color="#f59e0b"];
+  SDR     -> MistF    [style=invis];
   SDR     -> Extro    [color="#f59e0b"];
   Chain   -> Sessions [color="#f59e0b"];
   Bounty  -> SwarmB   [color="#f59e0b"];

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

@@ -16,14 +16,15 @@ digraph "PWN_Persistence" {
   mem  [label="memory.json\nfacts · prefs · lessons · env"];
   skl  [label="skills/*.md\nreusable procedures + refs"];
   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 + observations"];
+  ext  [label="extrospection.json\nhost snapshot + rf + observations"];
   ses  [label="sessions/*.jsonl\ntranscripts"];
   crn  [label="cron/jobs.yml\nscheduled jobs + logs"];
   agt  [label="agents.yml\npersona registry"];
   swm  [label="swarm/<id>/bus.jsonl\nmulti-agent chat"];
   hist [label="~/.pwn_history\nREPL history"];
 
-  Root->cfg; Root->mem; Root->skl; Root->lrn; Root->met; Root->ext;
+  Root->cfg; Root->mem; Root->skl; Root->lrn; Root->mis; Root->met; Root->ext;
   Root->ses; Root->crn; Root->agt; Root->swm; Root->hist;
 }

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

@@ -1,6 +1,6 @@
 digraph "PWN_AI_Feedback_Learning_Loop" {
   graph [
-    label=<<B>pwn-ai — Closed Self-Improvement Loop</B><BR/><FONT POINT-SIZE="11" COLOR="#94a3b8">Introspection (self)  ⟷  Extrospection (world)</FONT>>,
+    label=<<B>pwn-ai — Closed Self-Improvement Loop</B><BR/><FONT POINT-SIZE="11" COLOR="#94a3b8">Introspection (self)  ⟷  Extrospection (world)  ·  Mistakes (negative feedback)</FONT>>,
     labelloc=t, fontsize=20, fontname="Helvetica",
     rankdir=TB, splines=spline, nodesep=0.6, ranksep=1.0,
     bgcolor="#0f172a", fontcolor="#e2e8f0", pad=0.6, newrank=true, compound=true
@@ -13,7 +13,7 @@ digraph "PWN_AI_Feedback_Learning_Loop" {
   /* L0 ─ actors */
   User  [label="👤  Researcher", fillcolor="#7dd3fc"];
   LLM   [label="🤖  LLM Provider", fillcolor="#c4b5fd"];
-  World [label="🌍  Host · Net · Repo\nToolchain · Intel feeds", fillcolor="#fda4af"];
+  World [label="🌍  Host · Net · Repo\nToolchain · RF · Intel", fillcolor="#fda4af"];
   {rank=same; User; LLM; World}
 
   /* L1 ─ agent core */
@@ -26,20 +26,21 @@ digraph "PWN_AI_Feedback_Learning_Loop" {
   }
   {rank=same; Prompt; Dispatch; Result}
 
-  /* L2 ─ dual engines */
+  /* L2 ─ triple engines */
   subgraph cluster_intro {
     label="INTROSPECTION  (self)"; fontcolor="#a7f3d0";
     style=rounded; color="#047857"; bgcolor="#022c22"; penwidth=2;
     Metrics  [label="Metrics\nper-tool success · avg ms", fillcolor="#6ee7b7"];
     Learning [label="Learning\nnote_outcome · reflect\nconsolidate · distill_skill", fillcolor="#6ee7b7"];
+    Mistakes [label="Mistakes\nrecord · resolve\nguard · correction_hint\n[REPEATING] · [REGRESSED]", fillcolor="#6ee7b7", penwidth=2];
   }
   subgraph cluster_extro {
     label="EXTROSPECTION  (world)"; fontcolor="#fde68a";
     style=rounded; color="#a16207"; bgcolor="#422006"; penwidth=2;
-    Snapshot  [label="snapshot · drift\nhost/net/toolchain/repo", fillcolor="#fcd34d"];
-    Observe   [label="observe · intel\nrecon facts · CVE feed",   fillcolor="#fcd34d"];
+    Snapshot  [label="snapshot · drift\nhost/net/toolchain\nrepo/env/rf", fillcolor="#fcd34d"];
+    Observe   [label="observe · intel\nrecon facts · CVE feed",           fillcolor="#fcd34d"];
   }
-  {rank=same; Metrics; Learning; Snapshot; Observe}
+  {rank=same; Metrics; Learning; Mistakes; Snapshot; Observe}
 
   /* L3 ─ correlate */
   Correlate [label="extro_correlate()\n\"I did it wrong\"  vs  \"the world changed\"",
@@ -51,11 +52,12 @@ digraph "PWN_AI_Feedback_Learning_Loop" {
     style="rounded,dashed"; color="#334155"; bgcolor="#1e293b";
     Fmet [label="metrics.json",       shape=cylinder, fillcolor="#fcd34d"];
     Flrn [label="learning.jsonl",     shape=cylinder, fillcolor="#fcd34d"];
+    Fmis [label="mistakes.json",      shape=cylinder, fillcolor="#fcd34d"];
     Fmem [label="memory.json",        shape=cylinder, fillcolor="#fcd34d"];
     Fskl [label="skills/*.md",         shape=cylinder, fillcolor="#fcd34d"];
     Fext [label="extrospection.json", shape=cylinder, fillcolor="#fcd34d"];
   }
-  {rank=same; Fmet; Flrn; Fmem; Fskl; Fext}
+  {rank=same; Fmet; Flrn; Fmis; Fmem; Fskl; Fext}
 
   /* L0 → L1 */
   User -> Prompt   [label="task", color="#38bdf8", penwidth=2];
@@ -69,6 +71,9 @@ digraph "PWN_AI_Feedback_Learning_Loop" {
   /* L1 → L2 */
   Dispatch -> Metrics  [label="record()", color="#34d399"];
   Result   -> Learning [label="auto_reflect", 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"];
   World    -> Snapshot [color="#fb7185", constraint=false];
@@ -77,6 +82,7 @@ digraph "PWN_AI_Feedback_Learning_Loop" {
   /* L2 → L3 */
   Metrics  -> Correlate [color="#34d399"];
   Learning -> Correlate [color="#34d399"];
+  Mistakes -> Correlate [color="#34d399"];
   Snapshot -> Correlate [color="#f59e0b"];
   Observe  -> Correlate [color="#f59e0b"];
 
@@ -84,6 +90,8 @@ digraph "PWN_AI_Feedback_Learning_Loop" {
   Correlate -> Fmet [style=invis];
   Metrics   -> Fmet [color="#94a3b8"];
   Learning  -> Flrn [color="#94a3b8"];
+  Mistakes  -> Fmis [color="#94a3b8"];
+  Mistakes  -> Fmem [label="resolve→lesson", color="#94a3b8"];
   Learning  -> Fmem [label="lesson", color="#94a3b8"];
   Learning  -> Fskl [label="skill",  color="#94a3b8"];
   Observe   -> Fext [color="#94a3b8"];
@@ -91,7 +99,11 @@ digraph "PWN_AI_Feedback_Learning_Loop" {
   /* feedback (dashed, non-constraining) */
   Fmem -> Prompt [label="MEMORY block",  style=dashed, color="#fbbf24", constraint=false];
   Fskl -> Prompt [label="SKILLS block",  style=dashed, color="#fbbf24", constraint=false];
+  Fmis -> Prompt [label="KNOWN MISTAKES\n+ KNOWN FIXES", style=dashed, color="#fb7185",
+                  constraint=false, penwidth=2];
   Fext -> Prompt [label="EXTRO block",   style=dashed, color="#fbbf24", constraint=false];
+  Mistakes -> Dispatch [label="correction_hint\n(inline, next iter)", style=dashed,
+                        color="#fb7185", constraint=false, penwidth=2];
   Correlate -> Prompt [label="findings → next run", style=dashed, color="#fb7185",
                        constraint=false, penwidth=2];
   Result -> User [label="answer", color="#38bdf8", constraint=false, penwidth=2];

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

@@ -1,6 +1,6 @@
 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>>,
+    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>>,
     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
@@ -15,22 +15,23 @@ digraph "PWN_SDR" {
   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"];
+    SDRhw   [label="RTL-SDR / HackRF\n(via GQRX / SoapySDR)", fillcolor="#6ee7b7"];
+    Flipper [label="SDR::FlipperZero",                        fillcolor="#6ee7b7"];
+    RFID    [label="SDR::RFIDler\nSonMicroRFID",              fillcolor="#6ee7b7"];
   }
   subgraph cluster_ctrl {
-    label="Control"; fontcolor="#fde68a"; style=rounded;
+    label="Control · Scan"; 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"];
+    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"];
   }
   subgraph cluster_dec {
-    label="Decode"; fontcolor="#ddd6fe"; style=rounded;
+    label="Decode · Record"; 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"];
+    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"];
+    Xrf [label="extro_snapshot :rf\nprobe_rf → hw inventory", fillcolor="#c4b5fd"];
   }
 
   RF -> SDRhw   [color="#fb7185"];
@@ -42,4 +43,5 @@ digraph "PWN_SDR" {
   GQRX -> Dec [color="#a78bfa"];
   Freq -> Dec [color="#a78bfa"];
   Scan -> Obs [color="#a78bfa"];
+  SDRhw -> Xrf [style=dashed, color="#fbbf24", constraint=false];
 }