pwn 0.5.682 → 0.5.684

data/documentation/diagrams/dot/cron-scheduling.dot

@@ -1,6 +1,6 @@
 digraph "PWN_Cron" {
   graph [
-    label=<<B>PWN::Cron - Scheduled Autonomous Jobs</B><BR/><FONT POINT-SIZE="11" COLOR="#94a3b8">prompt · ruby · script → jobs.yml → worker → pwn-ai  ·  seeded self-improvement (Curriculum)</FONT>>,
+    label=<<B>PWN::Cron - Scheduled Autonomous Jobs</B><BR/><FONT POINT-SIZE="11" COLOR="#94a3b8">prompt · ruby · script → jobs.yml → worker → pwn-ai  ·  hygiene on · curriculum opt-in</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
@@ -29,14 +29,15 @@ digraph "PWN_Cron" {
   {rank=same; Prompt; Ruby; Script}
 
   subgraph cluster_seed {
-    label="Seeded Self-Improvement (install_defaults)"; fontcolor="#ddd6fe"; style=rounded;
+    label="Seeded Jobs (install_defaults)"; fontcolor="#ddd6fe"; style=rounded;
     color="#6d28d9"; bgcolor="#2e1065"; penwidth=2;
-    Practice [label="curriculum_practice_nightly\n0 3 * * *\nCurriculum.practice(limit:3)", fillcolor="#c4b5fd"];
-    Offline  [label="curriculum_offline_judge\n30 3 * * *\nCurriculum.offline_judge", fillcolor="#c4b5fd"];
-    Train    [label="curriculum_train_weekly\n0 4 * * 0\nCurriculum.train_and_gate\n(dry_run / export_ready)", fillcolor="#c4b5fd"];
-    MemGC    [label="learning_consolidate_nightly\n0 5 * * *\nLearning.consolidate", fillcolor="#c4b5fd"];
+    Practice [label="curriculum_practice_nightly\n0 3 * * *  OFF\nCurriculum.practice(limit:3)", fillcolor="#c4b5fd"];
+    Offline  [label="curriculum_offline_judge\n30 3 * * *  OFF\nCurriculum.offline_judge", fillcolor="#c4b5fd"];
+    Train    [label="curriculum_train_weekly\n0 4 * * 0  OFF\nCurriculum.train_and_gate\n(dry_run / export_ready)", fillcolor="#c4b5fd"];
+    MemGC    [label="learning_consolidate_nightly\n0 5 * * *  ON\nLearning.consolidate", fillcolor="#c4b5fd"];
+    Lean     [label="pwn_stores_lean_nightly\n15 5 * * *  ON\nLearning.gc_stores!", fillcolor="#c4b5fd"];
   }
-  {rank=same; Practice; Offline; Train; MemGC}
+  {rank=same; Practice; Offline; Train; MemGC; Lean}
 
   Log [label="~/.pwn/cron/log/<id>.log\nlast_run · last_status", shape=cylinder, fillcolor="#fcd34d"];
 
@@ -54,6 +55,7 @@ digraph "PWN_Cron" {
   Ruby    -> Offline  [color="#a78bfa"];
   Ruby    -> Train    [color="#a78bfa"];
   Ruby    -> MemGC    [color="#a78bfa"];
+  Ruby    -> Lean     [color="#a78bfa"];
   Prompt  -> Log [color="#f59e0b"];
   Ruby    -> Log [color="#f59e0b"];
   Script  -> Log [color="#f59e0b"];
@@ -62,4 +64,5 @@ digraph "PWN_Cron" {
   Offline  -> Log [style=dashed, color="#fbbf24", constraint=false];
   Train    -> Log [style=dashed, color="#fbbf24", constraint=false];
   MemGC    -> Log [style=dashed, color="#fbbf24", constraint=false];
+  Lean     -> Log [style=dashed, color="#fbbf24", constraint=false];
 }

data/documentation/diagrams/dot/driver-framework.dot

@@ -1,6 +1,6 @@
 digraph "PWN_Driver" {
   graph [
-    label=<<B>Driver Anatomy - bin/pwn_*</B><BR/><FONT POINT-SIZE="11" COLOR="#94a3b8">52 shipped drivers · thin CLI over PWN::Plugins</FONT>>,
+    label=<<B>Driver Anatomy - bin/pwn_*</B><BR/><FONT POINT-SIZE="11" COLOR="#94a3b8">54 executables (pwn + 53 pwn_*) · thin CLI over PWN::Plugins</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

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

@@ -27,7 +27,7 @@ digraph "PWN_Overall_Architecture" {
     style=rounded; color="#0369a1"; bgcolor="#0c4a6e"; penwidth=2;
     REPL  [label="🐚  pwn REPL\nPry + PWN:: preload",       fillcolor="#7dd3fc"];
     PwnAI [label="✨  pwn-ai\nAgent TUI · pwn --ai",         fillcolor="#7dd3fc"];
-    CLI   [label="📜  bin/pwn_*\n53 CLI drivers",            fillcolor="#7dd3fc"];
+    CLI   [label="📜  bin/pwn_*\n54 executables",            fillcolor="#7dd3fc"];
     Cronb [label="⏱  PWN::Cron\nScheduled jobs",            fillcolor="#7dd3fc"];
   }
   {rank=same; REPL; PwnAI; CLI; Cronb}
@@ -36,8 +36,8 @@ digraph "PWN_Overall_Architecture" {
   subgraph cluster_agent {
     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\n13 toolsets · 85 tools\ntool_router (CORE+topK)",    fillcolor="#c4b5fd"];
+    Loop     [label="Loop\nTaskSummarizer briefs\nplan → dispatch → observe\nmax_iters 777 (scars do not shrink)\nlast-iter tools only if done",      fillcolor="#c4b5fd"];
+    Registry [label="Registry\n13 toolsets · 87 tools\ntool_router (CORE+topK)",    fillcolor="#c4b5fd"];
     Swarm    [label="Swarm\npersonas · debate · bus",        fillcolor="#c4b5fd"];
     Prompt   [label="PromptBuilder\nengine-budgeted blocks\nMEMORY · SKILLS · POLICY\nMemoryIndex → relevance-ranked",fillcolor="#c4b5fd"];
   }
@@ -47,7 +47,7 @@ digraph "PWN_Overall_Architecture" {
   subgraph cluster_caps {
     label="Capability Namespaces  (lib/pwn/*)"; fontcolor="#a7f3d0";
     style=rounded; color="#047857"; bgcolor="#022c22"; penwidth=2;
-    Plugins [label="Plugins\n66 modules",     fillcolor="#6ee7b7"];
+    Plugins [label="Plugins\n67 modules",     fillcolor="#6ee7b7"];
     SAST    [label="SAST\n48 rules",          fillcolor="#6ee7b7"];
     WWW     [label="WWW\n22 site drivers",    fillcolor="#6ee7b7"];
     AWS     [label="AWS\n90 services",        fillcolor="#6ee7b7"];

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

@@ -26,7 +26,7 @@ digraph "PWN_Persistence" {
   ext  [label="extrospection.json\nsnapshot (host/net/tc/repo/env/\nrf/web/osint/serial/telecomm/\npacket/vision/voice) + prev + obs[]"];
   eart [label="extrospection/{web,packet,voice}/*\nscreenshots · pcaps · wav/txt"];
   ses  [label="sessions/*.jsonl\ntranscripts (+ step_reward)"];
-  crn  [label="cron/jobs.yml + log/\nseeded: curriculum_practice_nightly\ncurriculum_train_weekly"];
+  crn  [label="cron/jobs.yml + log/\nhygiene ON: consolidate + lean\ncurriculum practice/judge/train OFF"];
   agt  [label="agents.yml\npersona registry"];
   swm  [label="swarm/<id>/bus.jsonl\nmulti-agent chat"];
   cur  [label="curriculum/ + curriculum_kpi.jsonl\nself-play · A/B eval · KPI trend"];

data/documentation/diagrams/dot/plugin-ecosystem.dot

@@ -1,6 +1,6 @@
 digraph "PWN_Plugins" {
   graph [
-    label=<<B>PWN::Plugins - 66 Modules by Category</B>>,
+    label=<<B>PWN::Plugins - 67 Modules by Category</B>>,
     labelloc=t, fontsize=20, fontname="Helvetica",
     rankdir=LR, splines=spline, nodesep=0.25, ranksep=1.5,
     bgcolor="#0f172a", fontcolor="#e2e8f0", pad=0.6, newrank=true
@@ -36,7 +36,7 @@ digraph "PWN_Plugins" {
   h  [label="Serial · BusPirate\nMSR206 · Android · BareSIP"];
   c  [label="Jenkins · Git · vSphere\nDefectDojo · BlackDuck"];
   m  [label="MailAgent · SlackClient\nIRC · RabbitMQ · TwitterAPI · Voice"];
-  u  [label="FileFu · ThreadPool · Log\nChar · XXD · DetectOS\nScannableCodes · CreditCard\nSSN · EIN · VIN · Pony · PS"];
+  u  [label="FileFu · ThreadPool · Log\nChar · XXD · DetectOS\nScannableCodes · CreditCard\nSSN · EIN · VIN · Pony · PS\nTTYSpinner"];
 
   Root->Web; Root->Net; Root->Xpl; Root->Osint; Root->Data;
   Root->Auth; Root->HW; Root->CI; Root->Comm; Root->Util;

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

@@ -1,6 +1,6 @@
 digraph "PWN_TaskSummarizer" {
   graph [
-    label=<<B>PWN::AI::Agent::TaskSummarizer - executive briefs</B><BR/><FONT POINT-SIZE="11" COLOR="#94a3b8">every request → emit_plan! → about_to → tools (no request type)</FONT>>,
+    label=<<B>PWN::AI::Agent::TaskSummarizer - executive briefs</B><BR/><FONT POINT-SIZE="11" COLOR="#94a3b8">every request is a goal: emit_plan! then about_to then tools (no request type)</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
@@ -11,23 +11,24 @@ digraph "PWN_TaskSummarizer" {
         fontcolor="#cbd5e1", penwidth=1.3, arrowsize=0.8];
 
   User  [label="User request", fillcolor="#7dd3fc"];
-  Loop  [label="Loop.run\nts_state = TaskSummarizer.fresh\nrequest_intent only", fillcolor="#c4b5fd"];
-  Kind  [label="no request type\nevery turn is a goal", fillcolor="#fcd34d", penwidth=2];
+  Loop  [label="Loop.run\nts_state = TaskSummarizer.fresh\nrequest_intent short-circuit only", fillcolor="#c4b5fd"];
+  Kind  [label="no request type\nevery other turn is a goal", fillcolor="#fcd34d", penwidth=2];
   {rank=same; User; Loop; Kind}
 
-  subgraph cluster_nogoal {
-    label="No multi-step breakdown"; fontcolor="#fda4af";
+  subgraph cluster_short {
+    label="Cheap short-circuits (no tools, no plan)"; 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"];
+    Greet [label="greeting\nfixed short ack", fillcolor="#fda4af"];
+    HowTo [label="howto\nexample commands only", fillcolor="#fda4af"];
+    Recal [label="recall\nprior-turn answer", fillcolor="#fda4af"];
   }
-  {rank=same; Stmt; Ques}
+  {rank=same; Greet; HowTo; Recal}
 
   subgraph cluster_plan {
-    label="Autonomous goal plan (once per turn)"; fontcolor="#ddd6fe";
+    label="Goal plan (once per turn)"; fontcolor="#ddd6fe";
     style=rounded; color="#6d28d9"; bgcolor="#2e1065"; 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];
+    EmitP  [label="emit_plan!\nGoal: (original request)\nTangible tasks (N):\n  each may use 1+ tools", fillcolor="#c4b5fd", penwidth=2];
   }
   {rank=same; Plan; EmitP}
 
@@ -37,7 +38,7 @@ digraph "PWN_TaskSummarizer" {
     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\ntask k/N: ...\nvia shell×2 (search)", fillcolor="#6ee7b7", penwidth=2];
+    EmitB  [label="emit task line\ntask k/N:\nvia shell (search)", fillcolor="#6ee7b7", penwidth=2];
     Skip   [label="return nil\n(suppress duplicate)", fillcolor="#fda4af"];
   }
   {rank=same; About; FP; Dup; EmitB; Skip}
@@ -45,7 +46,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 · CORE_TOOLS\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"];
   }
@@ -55,12 +56,13 @@ digraph "PWN_TaskSummarizer" {
 
   User -> Loop [color="#38bdf8", penwidth=2];
   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];
+  Kind -> Greet [label="greeting", color="#fb7185"];
+  Kind -> HowTo [label="howto", color="#fb7185"];
+  Kind -> Recal [label="recall", color="#fb7185"];
+  Kind -> Plan [label="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\n(goals only)", color="#a78bfa"];
+  Loop -> About [label="before each\ntool batch", color="#a78bfa"];
   About -> FP [color="#34d399"];
   FP -> Dup [color="#34d399"];
   Dup -> EmitB [label="new", color="#34d399"];

data/documentation/diagrams/driver-framework.svg

@@ -10,7 +10,7 @@
 <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="191.62" y="-332" font-family="sans-Serif" font-weight="bold" font-size="20.00" fill="#e2e8f0">Driver Anatomy &#45; 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>
+<text xml:space="preserve" text-anchor="start" x="169.5" y="-320.55" font-family="sans-Serif" font-size="11.00" fill="#94a3b8">54 executables (pwn + 53 pwn_*) · 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"/>