pwn 0.5.668 → 0.5.670

data/documentation/diagrams/dot/ai-integration-tool-calling.dot

@@ -1,6 +1,6 @@
 digraph "PWN_AI_Integration" {
   graph [
-    label=<<B>PWN::AI - Multi-Provider LLM Integration</B><BR/><FONT POINT-SIZE="11" COLOR="#94a3b8">one Agent Loop · five interchangeable engines</FONT>>,
+    label=<<B>PWN::AI - Multi-Provider LLM Integration</B><BR/><FONT POINT-SIZE="11" COLOR="#94a3b8">one Agent Loop · six interchangeable engines</FONT>>,
     labelloc=t, fontsize=20, fontname="Helvetica",
     rankdir=LR, splines=spline, nodesep=0.45, ranksep=1.3,
     bgcolor="#0f172a", fontcolor="#e2e8f0", pad=0.6, newrank=true
@@ -20,8 +20,9 @@ digraph "PWN_AI_Integration" {
     Grok      [label="Grok\nOAuth device flow", fillcolor="#c4b5fd"];
     Gemini    [label="Gemini",           fillcolor="#c4b5fd"];
     Ollama    [label="Ollama (local)\n/api/chat  num_ctx · keep_alive\n/api/embed → MemoryIndex",  fillcolor="#c4b5fd"];
+    OpenWebUI [label="Open WebUI\ngateway JWT\n/api/v1/chat + /ollama", fillcolor="#c4b5fd"];
   }
-  {rank=same; OpenAI; Anthropic; Grok; Gemini; Ollama}
+  {rank=same; OpenAI; Anthropic; Grok; Gemini; Ollama; OpenWebUI}
 
   subgraph cluster_api {
     label="Provider APIs"; fontcolor="#fecaca"; style="rounded,dashed";
@@ -31,8 +32,9 @@ digraph "PWN_AI_Integration" {
     A3 [label="api.x.ai\nauth.x.ai", fillcolor="#fda4af"];
     A4 [label="generativelanguage\n.googleapis.com", fillcolor="#fda4af"];
     A5 [label="localhost:11434",   fillcolor="#fda4af"];
+    A6 [label="Open WebUI host\n/api/v1 + /ollama", fillcolor="#fda4af"];
   }
-  {rank=same; A1; A2; A3; A4; A5}
+  {rank=same; A1; A2; A3; A4; A5; A6}
 
   Cfg [label="PWN::Config\n~/.pwn/pwn.yaml\nactive · key · oauth\nprompt_budget · reflect_engine\nplan_first · tool_router · escalation", shape=cylinder, fillcolor="#fcd34d"];
 
@@ -41,11 +43,13 @@ digraph "PWN_AI_Integration" {
   Loop -> Grok      [color="#a78bfa"];
   Loop -> Gemini    [color="#a78bfa"];
   Loop -> Ollama    [color="#a78bfa"];
+  Loop -> OpenWebUI [color="#a78bfa"];
   OpenAI    -> A1 [color="#fb7185"];
   Anthropic -> A2 [color="#fb7185"];
   Grok      -> A3 [color="#fb7185"];
   Gemini    -> A4 [color="#fb7185"];
   Ollama    -> A5 [color="#fb7185"];
+  OpenWebUI -> A6 [color="#fb7185"];
   Cfg -> Loop [label="active engine", style=dashed, color="#fbbf24", constraint=false];
   Loop -> Anthropic [label="reflect_engine\n(teacher-student)", style=dashed, color="#fbbf24", constraint=false];
 }

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

@@ -13,7 +13,7 @@ digraph "PWN_MemorySkills" {
   subgraph cluster_write {
     label="Write-Side Tools"; fontcolor="#a7f3d0"; style=rounded;
     color="#047857"; bgcolor="#022c22";
-    Rem    [label="memory_remember\nkey · value · category",   fillcolor="#6ee7b7"];
+    Rem    [label="memory_remember · lean\nkey · value · category",   fillcolor="#6ee7b7"];
     Skc    [label="skill_create\nskill_add_reference",           fillcolor="#6ee7b7"];
     Note   [label="learning_note_outcome\nlearning_reflect",     fillcolor="#6ee7b7"];
     Dist   [label="learning_distill_skill\n(session → skill)",   fillcolor="#6ee7b7"];
@@ -30,7 +30,7 @@ digraph "PWN_MemorySkills" {
     Fidx [label="memory.idx\nembedding index\n(sha → vec)", shape=cylinder, fillcolor="#fcd34d"];
     Fskl [label="skills/<n>/SKILL.md\nYAML front-matter refs",       shape=cylinder, fillcolor="#fcd34d"];
     Flrn [label="learning.jsonl\noutcome log",               shape=cylinder, fillcolor="#fcd34d"];
-    Fses [label="sessions/*.jsonl\ntranscripts",              shape=cylinder, fillcolor="#fcd34d"];
+    Fses [label="sessions/*.jsonl\ntranscripts (+ lean)",      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"];
     Fftn [label="finetune/*.jsonl\nShareGPT / OpenAI / DPO", shape=cylinder, fillcolor="#fcd34d"];

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

@@ -16,7 +16,7 @@ digraph "PWN_Overall_Architecture" {
     color="#334155"; bgcolor="#1e293b";
     User   [label="👤  Researcher\nRed Team · Bug Hunter", fillcolor="#7dd3fc"];
     CI     [label="⚙️  CI / CD\nHeadless pipelines",       fillcolor="#7dd3fc"];
-    LLM    [label="🤖  LLM Providers\nOpenAI · Anthropic\nGrok · Gemini · Ollama", fillcolor="#c4b5fd"];
+    LLM    [label="🤖  LLM Providers\nOpenAI · Anthropic · Grok\nGemini · Ollama · Open WebUI", fillcolor="#c4b5fd"];
     Target [label="🎯  Attack Surface\nHosts · Web · Cloud\nRadio · Hardware", fillcolor="#fda4af"];
   }
   {rank=same; User; CI; LLM; Target}
@@ -37,7 +37,7 @@ digraph "PWN_Overall_Architecture" {
     label="PWN::AI::Agent"; fontcolor="#ddd6fe";
     style=rounded; color="#6d28d9"; bgcolor="#2e1065"; penwidth=2;
     Loop     [label="Loop\nTaskSummarizer briefs\nplan_first → dispatch\n→ observe → escalate\nbudget-pressure caps",      fillcolor="#c4b5fd"];
-    Registry [label="Registry\n12 toolsets · 78 tools\ntool_router (CORE+topK)",    fillcolor="#c4b5fd"];
+    Registry [label="Registry\n12 toolsets · 82 tools\ntool_router (CORE+topK)",    fillcolor="#c4b5fd"];
     Swarm    [label="Swarm\npersonas · debate · bus",        fillcolor="#c4b5fd"];
     Prompt   [label="PromptBuilder\nengine-budgeted blocks\nMemoryIndex → relevance-ranked",fillcolor="#c4b5fd"];
   }
@@ -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\nDecoder::* (20)", fillcolor="#6ee7b7"];
+    SDR     [label="SDR\nGQRX · Flipper · RFID\nDecoder::* (20+Base/DSP)", fillcolor="#6ee7b7"];
     Chain   [label="Blockchain\nBTC · ETH",   fillcolor="#6ee7b7"];
     Bounty  [label="Bounty\nlifecycle replay", fillcolor="#6ee7b7"];
     Reports [label="Reports\nHTML · JSON",    fillcolor="#6ee7b7"];
@@ -73,8 +73,9 @@ digraph "PWN_Overall_Architecture" {
     SwarmB   [label="swarm/*/bus.jsonl",  shape=cylinder, fillcolor="#fcd34d"];
     CronF    [label="cron/jobs.yml",      shape=cylinder, fillcolor="#fcd34d"];
     Finetune [label="finetune/*.jsonl", shape=cylinder, fillcolor="#fcd34d"];
+    Prefs    [label="preferences.jsonl", shape=cylinder, fillcolor="#fcd34d"];
   }
-  {rank=same; Memory; MemIdx; Skills; Learn; Metrics; MistF; Extro; Sessions; SwarmB; CronF; Finetune}
+  {rank=same; Memory; MemIdx; Skills; Learn; Metrics; MistF; Extro; Sessions; SwarmB; CronF; Finetune; Prefs}
 
   /* ── L0 → L1 ── */
   User -> REPL   [color="#38bdf8"];
@@ -110,6 +111,7 @@ digraph "PWN_Overall_Architecture" {
   Chain   -> Sessions [color="#f59e0b"];
   Bounty  -> SwarmB   [color="#f59e0b"];
   Reports -> CronF    [color="#f59e0b"];
+  Reports -> Prefs    [style=invis];
 
   /* ── side flows (few, non-constraining) ── */
   Loop    -> LLM    [label="tool-use API", color="#c4b5fd", constraint=false, penwidth=2];

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

@@ -28,7 +28,7 @@ digraph "PWN_Persistence" {
   crn  [label="cron/jobs.yml + log/\nseeded: curriculum_practice_nightly\ncurriculum_train_weekly"];
   agt  [label="agents.yml\npersona registry"];
   swm  [label="swarm/<id>/bus.jsonl\nmulti-agent chat"];
-  cur  [label="curriculum/\nself-play reproducers · A/B eval"];
+  cur  [label="curriculum/ + curriculum_kpi.jsonl\nself-play · A/B eval · KPI trend"];
   ftn  [label="finetune/*.jsonl\nShareGPT / OpenAI SFT + DPO"];
   bkp  [label="backup/<ts>/ · quarantine/\nMigrate autofix snapshots"];
   hist [label="~/.pwn_history\nREPL history"];

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 · FrequencyAllocation · Decoder::* (20) · Base.run_iq (true-air) · FFI::{Volk,Liquid,FFTW,RTLSdr,HackRF,AdalmPluto,SoapySDR}</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+Base/DSP) · Base.run_iq (true-air) · FFI::{Volk,Liquid,FFTW,RTLSdr,HackRF,AdalmPluto,SoapySDR}</FONT>>,
     labelloc=t, fontsize=20, fontname="Helvetica",
     rankdir=LR, splines=spline, nodesep=0.45, ranksep=1.1,
     bgcolor="#0f172a", fontcolor="#e2e8f0", pad=0.6, newrank=true

data/documentation/diagrams/dot/task-summarizer.dot

@@ -1,6 +1,6 @@
 digraph "PWN_TaskSummarizer" {
   graph [
-    label=<<B>PWN::AI::Agent::TaskSummarizer - Executive task briefs</B><BR/><FONT POINT-SIZE="11" COLOR="#94a3b8">emit_plan! (full goal once) → about_to (per batch, deduped) → tools on their own lines · Loop single emitter</FONT>>,
+    label=<<B>PWN::AI::Agent::TaskSummarizer - Request kind + executive briefs</B><BR/><FONT POINT-SIZE="11" COLOR="#94a3b8">request_kind → (statement|question: no plan) · (autonomous_goal: emit_plan! → about_to → tools)</FONT>>,
     labelloc=t, fontsize=20, fontname="Helvetica",
     rankdir=TB, splines=spline, nodesep=0.55, ranksep=0.9,
     bgcolor="#0f172a", fontcolor="#e2e8f0", pad=0.6, newrank=true, compound=true
@@ -10,25 +10,34 @@ digraph "PWN_TaskSummarizer" {
   edge [fontname="Helvetica", fontsize=9, color="#94a3b8",
         fontcolor="#cbd5e1", penwidth=1.3, arrowsize=0.8];
 
-  User  [label="👤  User goal", fillcolor="#7dd3fc"];
-  Loop  [label="Loop.run\nts_state = TaskSummarizer.fresh", fillcolor="#c4b5fd"];
-  {rank=same; User; Loop}
+  User  [label="User request", fillcolor="#7dd3fc"];
+  Loop  [label="Loop.run\nts_state = TaskSummarizer.fresh\nrequest_kind + request_intent", fillcolor="#c4b5fd"];
+  Kind  [label="request_kind (LLM + heuristic)\nstatement | question | autonomous_goal\nhost-evidence Qs → goal", fillcolor="#fcd34d", penwidth=2];
+  {rank=same; User; Loop; Kind}
+
+  subgraph cluster_nogoal {
+    label="No multi-step breakdown"; fontcolor="#fda4af";
+    style=rounded; color="#be123c"; bgcolor="#4c0519"; penwidth=2;
+    Stmt [label="statement\nanswer_statement / greeting ack", fillcolor="#fda4af"];
+    Ques [label="question (knowledge/howto/recall)\nanswer_question / howto / recall\nno tools / no plan", fillcolor="#fda4af"];
+  }
+  {rank=same; Stmt; Ques}
 
   subgraph cluster_plan {
-    label="Plan layer (once per turn)"; fontcolor="#ddd6fe";
+    label="Autonomous goal plan (once per turn)"; fontcolor="#ddd6fe";
     style=rounded; color="#6d28d9"; bgcolor="#2e1065"; penwidth=2;
-    Plan   [label="plan(request)\nenumerated steps or heuristic_decompose", fillcolor="#c4b5fd"];
-    EmitP  [label="emit_plan!\nGoal: …\nTangible tasks (N):\n  1. …  2. …", fillcolor="#c4b5fd", penwidth=2];
+    Plan   [label="plan(request)\nenumerated · LLM · fallback\nordered work units", fillcolor="#c4b5fd"];
+    EmitP  [label="emit_plan!\nKind: autonomous_goal\nGoal: ...\nTangible tasks (N):\n  each may use 1+ tools", fillcolor="#c4b5fd", penwidth=2];
   }
   {rank=same; Plan; EmitP}
 
   subgraph cluster_batch {
     label="Batch layer (each tool collection)"; fontcolor="#a7f3d0";
     style=rounded; color="#047857"; bgcolor="#022c22"; penwidth=2;
-    About  [label="about_to(tools:)\ncapability_label\ntool_counts_phrase\nintent_phrase", fillcolor="#6ee7b7"];
+    About  [label="about_to(tools:)\ntask k/n English primary\nvia tools (intent)", fillcolor="#6ee7b7"];
     FP     [label="brief_fingerprint\nlast_brief_fp", fillcolor="#6ee7b7"];
     Dup    [label="duplicate_brief?", shape=diamond, fillcolor="#fcd34d"];
-    EmitB  [label="emit task line\nNext: shell×2 (search)\n[task k/N: …]", fillcolor="#6ee7b7", penwidth=2];
+    EmitB  [label="emit task line\ntask k/N: ...\nvia shell×2 (search)", fillcolor="#6ee7b7", penwidth=2];
     Skip   [label="return nil\n(suppress duplicate)", fillcolor="#fda4af"];
   }
   {rank=same; About; FP; Dup; EmitB; Skip}
@@ -36,7 +45,7 @@ digraph "PWN_TaskSummarizer" {
   subgraph cluster_exec {
     label="Execution (not on task row)"; fontcolor="#fde68a";
     style=rounded; color="#a16207"; bgcolor="#422006"; penwidth=2;
-    Tools  [label="Dispatch tools\nshell · pwn_eval · …\nown REPL lines", fillcolor="#fcd34d"];
+    Tools  [label="Dispatch tools\nshell · pwn_eval · ...\nown REPL lines", fillcolor="#fcd34d"];
     Rec    [label="record!\nadvance plan_idx\n(silent unless verbose)", fillcolor="#fcd34d"];
     Flush  [label="flush! / emit!\noptional closing brief", fillcolor="#fcd34d"];
   }
@@ -45,10 +54,13 @@ digraph "PWN_TaskSummarizer" {
   UI [label="REPL on_tool\nname='task', full text, result=''\n(no truncation)", fillcolor="#7dd3fc"];
 
   User -> Loop [color="#38bdf8", penwidth=2];
-  Loop -> Plan [color="#a78bfa"];
+  Loop -> Kind [color="#fbbf24", penwidth=2];
+  Kind -> Stmt [label="statement", color="#fb7185"];
+  Kind -> Ques [label="question", color="#fb7185"];
+  Kind -> Plan [label="autonomous_goal", color="#a78bfa", penwidth=2];
   Plan -> EmitP [color="#a78bfa"];
   EmitP -> UI [label="full goal once", color="#38bdf8", penwidth=2];
-  Loop -> About [label="before each\ntool batch", color="#a78bfa"];
+  Loop -> About [label="before each\ntool batch\n(goals only)", color="#a78bfa"];
   About -> FP [color="#34d399"];
   FP -> Dup [color="#34d399"];
   Dup -> EmitB [label="new", color="#34d399"];