pwn 0.5.663 → 0.5.665

data/spec/lib/pwn/ai/agent/learning_spec.rb

@@ -2,6 +2,7 @@
 
 require 'spec_helper'
 require 'tmpdir'
+require 'fileutils'
 
 describe PWN::AI::Agent::Learning do
   it 'should display information for authors' do
@@ -86,4 +87,140 @@ describe PWN::AI::Agent::Learning do
   ensure
     FileUtils.rm_rf(tmp) if defined?(tmp) && tmp
   end
+
+  it 'P29 resyncs verdict after critic floor and strips request envelopes in to_context' do
+    tmp = Dir.mktmpdir
+    stub_const('PWN::AI::Agent::Learning::LEARNING_FILE', File.join(tmp, 'learning.jsonl'))
+    stub_const('PWN::Memory::MEMORY_FILE', File.join(tmp, 'memory.json'))
+
+    PWN::AI::Agent::Learning.reset
+
+    # Critic-capped solved-at-0.3 pattern (pre-P29 poison)
+    PWN::AI::Agent::Learning.note_outcome(
+      task: "REQUEST:\nwhats the bottom line?\n\nANSWER:\nfake bottom line",
+      success: false,
+      score: 0.3,
+      details: 'solved(0.3) heuristic overlap=0.75 ratio=1.0 | fake bottom line',
+      tags: %w[auto loop solved plan_cover_high]
+    )
+    PWN::AI::Agent::Learning.note_outcome(
+      task: 'real bare goal that failed',
+      success: false,
+      score: 0.22,
+      details: 'wrong(0.22) heuristic overlap=0.06 | blew up',
+      tags: %w[auto loop wrong]
+    )
+    PWN::AI::Agent::Learning.note_outcome(
+      task: 'successful scan',
+      success: true,
+      score: 0.9,
+      details: 'solved(0.9) ok',
+      tags: %w[auto loop solved]
+    )
+
+    # reconcile should flip solved→partial on the 0.3 row
+    rep = PWN::AI::Agent::Learning.reconcile_verdict_tags!
+    expect(rep[:repaired]).to be >= 1
+
+    rows = PWN::AI::Agent::Learning.outcomes(limit: 20)
+    fixed = rows.find { |r| (r[:score].to_f - 0.3).abs < 0.001 }
+    expect(Array(fixed[:tags])).to include('partial')
+    expect(Array(fixed[:tags])).not_to include('solved')
+    expect(fixed[:details]).to match(/\Apartial\(0\.30?\)/)
+
+    ctx = PWN::AI::Agent::Learning.to_context(limit: 5)
+    # envelope stripped
+    expect(ctx).to include('whats the bottom line?')
+    expect(ctx).not_to match(/REQUEST:\nwhats/)
+    # score visible
+    expect(ctx).to match(/\[0\.30\]/)
+    # RECENT OUTCOMES and RECENT FAILURES must not be identical dumps
+    # (dedupe by id) — with 1 success + 2 fails, outcomes shows mix
+    expect(ctx).to include('successful scan')
+    expect(ctx).to include('cause:')
+  ensure
+    FileUtils.rm_rf(tmp) if defined?(tmp) && tmp
+  end
+
+  it 'P29 verdict_for_score thresholds match Reward.judge' do
+    expect(PWN::AI::Agent::Learning.send(:verdict_for_score, score: 0.6)).to eq(:solved)
+    expect(PWN::AI::Agent::Learning.send(:verdict_for_score, score: 0.59)).to eq(:partial)
+    expect(PWN::AI::Agent::Learning.send(:verdict_for_score, score: 0.3)).to eq(:partial)
+    expect(PWN::AI::Agent::Learning.send(:verdict_for_score, score: 0.29)).to eq(:wrong)
+  end
+
+  it 'note_outcome enforces OUTCOME_DETAILS_MAX' do
+    tmp = Dir.mktmpdir
+    path = File.join(tmp, 'learning.jsonl')
+    stub_const('PWN::AI::Agent::Learning::LEARNING_FILE', path)
+    long = 'D' * (PWN::AI::Agent::Learning::OUTCOME_DETAILS_MAX + 100)
+    e = PWN::AI::Agent::Learning.note_outcome(task: 'policy details cap', success: true, details: long, tags: %w[spec])
+    expect(e[:details].bytesize).to be <= PWN::AI::Agent::Learning::OUTCOME_DETAILS_MAX
+  ensure
+    FileUtils.rm_rf(tmp) if tmp
+  end
+
+  it 'prune_outcomes! keeps gold/high-value and enforces MAX_OUTCOME_ROWS' do
+    tmp = Dir.mktmpdir
+    path = File.join(tmp, 'learning.jsonl')
+    stub_const('PWN::AI::Agent::Learning::LEARNING_FILE', path)
+    stub_const('PWN::AI::Agent::Learning::MAX_OUTCOME_ROWS', 30)
+    stub_const('PWN::AI::Agent::Learning::EXEMPLARS_POOL_MIN', 5)
+    stub_const('PWN::AI::Agent::Learning::FAILURE_WINDOW_MIN', 5)
+    stub_const('PWN::AI::Agent::Learning::OUTCOME_RECENT_DAYS', 1)
+    stub_const('PWN::AI::Agent::Learning::OUTCOME_RETAIN_DAYS', 2)
+
+    now = Time.now.utc
+    rows = []
+    # gold protected
+    5.times do |i|
+      rows << {
+        id: "g#{i}", task: "gold task #{i}", success: true, score: 0.9,
+        session_id: "sid_g#{i}", details: 'ok', tags: %w[auto],
+        timestamp: (now - (10 * 86_400)).iso8601
+      }
+    end
+    # high-value tag protected
+    rows << {
+      id: 'hv1', task: 'needs human row', success: false, score: 0.2,
+      session_id: 'sid_hv', details: 'x', tags: %w[needs_human],
+      timestamp: (now - (20 * 86_400)).iso8601
+    }
+    # old low-value noise (should be droppable)
+    40.times do |i|
+      rows << {
+        id: "n#{i}", task: "noise #{i}", success: false, score: 0.1,
+        session_id: "sid_n#{i}", details: 'noise', tags: %w[auto loop partial],
+        timestamp: (now - (30 * 86_400)).iso8601
+      }
+    end
+    File.open(path, 'w') { |f| rows.each { |r| f.puts(JSON.generate(r)) } }
+
+    res = PWN::AI::Agent::Learning.prune_outcomes!
+    kept = File.readlines(path).map { |l| JSON.parse(l, symbolize_names: true) }
+    ids = kept.map { |r| r[:id] }
+    expect(ids).to include('g0', 'hv1')
+    expect(kept.size).to be <= 30
+    expect(res[:kept]).to eq(kept.size)
+  ensure
+    FileUtils.rm_rf(tmp) if tmp
+  end
+
+  it 'consolidate respects MAX_MEMORY_ENTRIES and PROTECT prefixes' do
+    tmp = Dir.mktmpdir
+    mem_path = File.join(tmp, 'memory.json')
+    stub_const('PWN::Memory::MEMORY_FILE', mem_path)
+    PWN::Memory.clear(force: true)
+    PWN::Memory.remember(key: :operator_pref_keep, value: 'must survive', category: :preference)
+    25.times do |i|
+      PWN::Memory.remember(key: :"bulk_#{i}", value: "lesson body #{i} unique #{i}", category: :lesson, importance: 0.1, confidence: 0.1)
+    end
+    res = PWN::AI::Agent::Learning.consolidate(max_entries: 10)
+    mem = PWN::Memory.load
+    expect(mem.keys).to include(:operator_pref_keep)
+    expect(mem.size).to be <= 10
+    expect(res[:remaining]).to eq(mem.size)
+  ensure
+    FileUtils.rm_rf(tmp) if tmp
+  end
 end

data/spec/lib/pwn/ai/agent/loop_spec.rb

@@ -60,6 +60,48 @@ describe PWN::AI::Agent::Loop do
       expect(src).to match(/task_summary_plan!.*relevance_query|relevance_query.*inject_task_focus!/m)
     end
 
+    it 'P17 evidence_enough does not early-final on bare success while plan open' do
+      # Multi-step English plan mid-flight + tool {"success":true} must NOT
+      # force text-only — that blocked legitimate completion.
+      loop_mod = described_class
+      msgs = [
+        { role: 'user', content: 'fix p17' },
+        { role: 'tool', content: '{"success":true,"result":{"stdout":"a"}}' },
+        { role: 'tool', content: '{"success":true,"result":{"stdout":"b"}}' },
+        { role: 'tool', content: '{"success":true,"result":{"stdout":"c"}}' }
+      ]
+      open_plan = { plan: %w[identify determine inspect implement verify confirm], plan_idx: 2 }
+      r_open = loop_mod.send(
+        :evidence_enough_to_finalize?,
+        messages: msgs, turn_fails: {}, i: 5, max_iters: 40,
+        request: 'fix p17', plan_steps: 6, ts_state: open_plan
+      )
+      expect(r_open).to be false
+
+      last_plan = { plan: %w[identify implement verify], plan_idx: 2 }
+      msgs_mut = msgs + [
+        { role: 'tool', content: '{"success":true,"result":{"stdout":"0 offenses detected"}}' }
+      ]
+      r_mut = loop_mod.send(
+        :evidence_enough_to_finalize?,
+        messages: msgs_mut, turn_fails: {}, i: 5, max_iters: 40,
+        request: 'fix p17', plan_steps: 3, ts_state: last_plan
+      )
+      expect(r_mut).to be true
+
+      r_bare = loop_mod.send(
+        :evidence_enough_to_finalize?,
+        messages: msgs, turn_fails: {}, i: 5, max_iters: 40,
+        request: 'fix p17', plan_steps: 3, ts_state: last_plan
+      )
+      expect(r_bare).to be false
+
+      # call site must pass ts_state
+      src = File.read(loop_mod.method(:run).source_location.first)
+      expect(src).to match(/evidence_enough_to_finalize\?\([\s\S]*?ts_state: ts_state/)
+      expect(src).to match(/English-task gate/)
+    end
+
     it 'does not put TaskSummarizer into Reward credit paths' do
       # Loop may call TaskSummarizer executive APIs, not Reward.judge from TaskSummarizer
       ts = File.read(PWN::AI::Agent::TaskSummarizer.method(:plan).source_location.first)

data/spec/lib/pwn/ai/agent/mistakes_spec.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 require 'spec_helper'
+require 'tmpdir'
+require 'fileutils'
 
 describe PWN::AI::Agent::Mistakes do
   it 'should display information for authors' do
@@ -62,4 +64,77 @@ describe PWN::AI::Agent::Mistakes do
     expect(got[:structured_fix][:strategy]).to eq 'typo'
     expect(got[:structured_fix][:holdout_tests].length).to eq 2
   end
+
+  it 'enforces SAMPLE_ARGS_MAX SNIPPET_MAX ERROR_MAX SESSIONS_KEEP on record' do
+    tmp = Dir.mktmpdir
+    path = File.join(tmp, 'mistakes.json')
+    stub_const('PWN::AI::Agent::Mistakes::MISTAKES_FILE', path)
+    FileUtils.rm_f(path)
+    long_err = 'E' * (PWN::AI::Agent::Mistakes::ERROR_MAX + 200)
+    long_args = 'A' * (PWN::AI::Agent::Mistakes::SAMPLE_ARGS_MAX + 80)
+    m = nil
+    5.times do |i|
+      m = PWN::AI::Agent::Mistakes.record(
+        tool: 'shell',
+        error: long_err,
+        args: long_args,
+        session_id: "sess_#{i}"
+      )
+    end
+    expect(m[:snippet].to_s.bytesize).to be <= PWN::AI::Agent::Mistakes::SNIPPET_MAX
+    expect(m[:error].to_s.bytesize).to be <= PWN::AI::Agent::Mistakes::ERROR_MAX
+    expect(m[:sample_args].to_s.bytesize).to be <= PWN::AI::Agent::Mistakes::SAMPLE_ARGS_MAX
+    expect(Array(m[:sessions]).length).to be <= PWN::AI::Agent::Mistakes::SESSIONS_KEEP
+    expect(m[:count]).to eq(5)
+  ensure
+    FileUtils.rm_rf(tmp) if tmp
+  end
+
+  it 'lean! keeps unresolved and REPEATING scars; caps resolved via MAX_RESOLVED_KEPT' do
+    tmp = Dir.mktmpdir
+    path = File.join(tmp, 'mistakes.json')
+    stub_const('PWN::AI::Agent::Mistakes::MISTAKES_FILE', path)
+    stub_const('PWN::AI::Agent::Mistakes::MAX_RESOLVED_KEPT', 2)
+    stub_const('PWN::AI::Agent::Mistakes::RESOLVED_MIN_AGE_DAYS', 0)
+    FileUtils.rm_f(path)
+
+    open_m = PWN::AI::Agent::Mistakes.record(tool: 'open_tool', error: 'still broken open')
+    rep = nil
+    3.times { rep = PWN::AI::Agent::Mistakes.record(tool: 'rep_tool', error: 'repeat me') }
+    expect(rep[:count]).to be >= PWN::AI::Agent::Mistakes::REPEAT_THRESHOLD
+
+    resolved_sigs = []
+    4.times do |i|
+      m = PWN::AI::Agent::Mistakes.record(tool: "done_#{i}", error: "once #{i}")
+      PWN::AI::Agent::Mistakes.resolve(signature: m[:signature], fix: "fix #{i}")
+      # age resolved_at into the past for drop eligibility
+      store = PWN::AI::Agent::Mistakes.load
+      store[m[:signature].to_sym][:resolved_at] = (Time.now.utc - (40 * 86_400)).iso8601
+      store[m[:signature].to_sym][:count] = 1
+      PWN::AI::Agent::Mistakes.save(store: store)
+      resolved_sigs << m[:signature]
+    end
+
+    res = PWN::AI::Agent::Mistakes.lean!
+    store = PWN::AI::Agent::Mistakes.load
+    expect(store.keys.map(&:to_s)).to include(open_m[:signature], rep[:signature])
+    resolved_left = store.values.count { |e| e[:resolved] && e[:fix].to_s != '' }
+    expect(resolved_left).to be <= 2
+    expect(res[:remaining]).to be <= store.size
+  ensure
+    FileUtils.rm_rf(tmp) if tmp
+  end
+
+  it 'resolve clamps fix to FIX_MAX' do
+    tmp = Dir.mktmpdir
+    path = File.join(tmp, 'mistakes.json')
+    stub_const('PWN::AI::Agent::Mistakes::MISTAKES_FILE', path)
+    FileUtils.rm_f(path)
+    m = PWN::AI::Agent::Mistakes.record(tool: 't', error: 'e')
+    long_fix = 'F' * (PWN::AI::Agent::Mistakes::FIX_MAX + 50)
+    got = PWN::AI::Agent::Mistakes.resolve(signature: m[:signature], fix: long_fix)
+    expect(got[:fix].bytesize).to eq(PWN::AI::Agent::Mistakes::FIX_MAX)
+  ensure
+    FileUtils.rm_rf(tmp) if tmp
+  end
 end

data/spec/lib/pwn/memory_spec.rb

@@ -18,7 +18,7 @@ describe PWN::Memory do
   it 'should support remember/recall/forget/clear' do
     tmp = Dir.mktmpdir
     stub_const('PWN::Memory::MEMORY_FILE', File.join(tmp, 'memory.json'))
-    PWN::Memory.clear
+    PWN::Memory.clear(force: true)
     PWN::Memory.remember(key: :test_fact, value: 'pwn-ai test memory', category: :fact)
     res = PWN::Memory.recall(query: 'test')
     expect(res.keys).to include(:test_fact)
@@ -42,4 +42,49 @@ describe PWN::Memory do
   ensure
     FileUtils.rm_rf(tmp) if tmp
   end
+
+  it 'enforces VALUE_MAX_CHARS on remember' do
+    tmp = Dir.mktmpdir
+    stub_const('PWN::Memory::MEMORY_FILE', File.join(tmp, 'memory.json'))
+    PWN::Memory.clear(force: true)
+    long = 'x' * (PWN::Memory::VALUE_MAX_CHARS + 50)
+    PWN::Memory.remember(key: :long_val, value: long, category: :fact)
+    v = PWN::Memory.load[:long_val][:value]
+    expect(v.bytesize).to be <= (PWN::Memory::VALUE_MAX_CHARS + 20)
+    expect(v).to include('[compacted]')
+  ensure
+    FileUtils.rm_rf(tmp) if tmp
+  end
+
+  it 'refuses forget/clear on protected keys without force' do
+    tmp = Dir.mktmpdir
+    stub_const('PWN::Memory::MEMORY_FILE', File.join(tmp, 'memory.json'))
+    PWN::Memory.clear(force: true)
+    PWN::Memory.remember(key: :operator_pref_test, value: 'keep', category: :preference)
+    PWN::Memory.remember(key: :process_sop_test, value: 'keep', category: :lesson)
+    expect { PWN::Memory.forget(key: :operator_pref_test) }.to raise_error(/protected/)
+    expect { PWN::Memory.forget(key: :process_sop_test) }.to raise_error(/protected/)
+    expect { PWN::Memory.clear }.to raise_error(/force:true/)
+    expect(PWN::Memory.forget(key: :operator_pref_test, force: true)).to be true
+    expect(PWN::Memory.load.keys).not_to include(:operator_pref_test)
+  ensure
+    FileUtils.rm_rf(tmp) if tmp
+  end
+
+  it 'lean! drops expired session_* but keeps protected prefixes' do
+    tmp = Dir.mktmpdir
+    stub_const('PWN::Memory::MEMORY_FILE', File.join(tmp, 'memory.json'))
+    PWN::Memory.clear(force: true)
+    PWN::Memory.remember(key: :operator_pref_x, value: 'pref', category: :preference)
+    PWN::Memory.remember(key: :session_old, value: 'ephemeral', category: :fact)
+    mem = PWN::Memory.load
+    mem[:session_old][:timestamp] = (Time.now.utc - (PWN::Memory::EPHEMERAL_TTL_SECS + 100)).iso8601
+    PWN::Memory.save(mem: mem)
+    res = PWN::Memory.lean!
+    expect(res[:removed]).to be >= 1
+    expect(PWN::Memory.load.keys).to include(:operator_pref_x)
+    expect(PWN::Memory.load.keys).not_to include(:session_old)
+  ensure
+    FileUtils.rm_rf(tmp) if tmp
+  end
 end

data/spec/lib/pwn/sessions_spec.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 require 'spec_helper'
+require 'tmpdir'
+require 'fileutils'
 
 describe PWN::Sessions do
   it 'should display information for authors' do
@@ -19,7 +21,44 @@ describe PWN::Sessions do
     PWN::Sessions.append(session_id: s[:id], role: 'user', content: 'test input')
     t = PWN::Sessions.load(session_id: s[:id])
     expect(t.size).to be >= 2
-    PWN::Sessions.delete(session_id: s[:id])
+    # Hot sessions are pinned — force required for intentional delete.
+    expect { PWN::Sessions.delete(session_id: s[:id]) }.to raise_error(/protected/)
+    PWN::Sessions.delete(session_id: s[:id], force: true)
     expect(PWN::Sessions.list.any? { |x| x[:id] == s[:id] }).to be false
   end
+
+  it 'caps tool/assistant content on append per TOOL_CONTENT_MAX/ASSISTANT_CONTENT_MAX' do
+    s = PWN::Sessions.create(title: 'cap test')
+    tool_big = 'T' * (PWN::Sessions::TOOL_CONTENT_MAX + 100)
+    asst_big = 'A' * (PWN::Sessions::ASSISTANT_CONTENT_MAX + 100)
+    PWN::Sessions.append(session_id: s[:id], role: 'tool', content: tool_big)
+    PWN::Sessions.append(session_id: s[:id], role: 'assistant', content: asst_big)
+    rows = PWN::Sessions.load(session_id: s[:id])
+    tool = rows.find { |e| e[:role] == 'tool' }
+    asst = rows.find { |e| e[:role] == 'assistant' }
+    expect(tool[:content].bytesize).to be <= (PWN::Sessions::TOOL_CONTENT_MAX + 20)
+    expect(asst[:content].bytesize).to be <= (PWN::Sessions::ASSISTANT_CONTENT_MAX + 20)
+    expect(tool[:content]).to include('[compacted]')
+  ensure
+    PWN::Sessions.delete(session_id: s[:id], force: true) if s
+  end
+
+  it 'lean! respects MIN_STUB_BYTES and HOT_DAYS pins' do
+    tmp = Dir.mktmpdir
+    stub_const('PWN::Sessions::SESSIONS_DIR', tmp)
+    hot = PWN::Sessions.create(title: 'hot')
+    PWN::Sessions.append(session_id: hot[:id], role: 'user', content: 'substantive user line here')
+    # cold stub: tiny file outside hot window
+    stub_id = '19990101_000000_deadbeef'
+    stub_path = File.join(tmp, "#{stub_id}.jsonl")
+    File.write(stub_path, %({"role":"system","content":"Session started","timestamp":"1999-01-01T00:00:00Z"}
+))
+    File.utime(Time.at(0), Time.at(0), stub_path)
+    res = PWN::Sessions.lean!(current_session_id: hot[:id])
+    expect(File.exist?(File.join(tmp, "#{hot[:id]}.jsonl"))).to be true
+    expect(File.exist?(stub_path)).to be false
+    expect(res[:deleted]).to be >= 1
+  ensure
+    FileUtils.rm_rf(tmp) if tmp
+  end
 end

data/third_party/pwn_rdoc.jsonl

@@ -256,39 +256,50 @@
 {"messages":[{"role":"user","content":"PWN::AI::Agent::HackerOne.analyze Usage"},{"role":"assistant","content":"`PWN::AI::Agent::HackerOne.analyze`: Supported Method Parameters\n\nai_analysis = PWN::AI::Agent::HackerOne.analyze(\n\nrequest: 'required - dataset to analyze, such as bounty program details, scope details, or hacktivity details'\ntype: 'required - type of analysis to perform, such as :bounty_programs, :scope_details, or :hacktivity'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::HackerOne.authors Usage"},{"role":"assistant","content":"`PWN::AI::Agent::HackerOne.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::HackerOne.help Usage"},{"role":"assistant","content":"`PWN::AI::Agent::HackerOne.help`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.atomic_jsonl_write Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.atomic_jsonl_write`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.authors Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.auto_introspect Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.auto_introspect`: Supported Method Parameters\n\nPWN::AI::Agent::Learning.auto_introspect(\n\nsession_id: 'required - id of the just-completed session',\nrequest: 'optional - original user request (for outcome logging)',\nfinal: 'optional - final assistant answer (for outcome logging)'\n\n)\n\nCalled by Loop.run when PWN::Env[:agent] is truthy. Never raises — learning must not break the primary loop.\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.auto_introspect_enabled? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.auto_introspect_enabled?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.build_skill_from_session Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.build_skill_from_session`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.cause_crumb Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.cause_crumb`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.checkable_claim? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.checkable_claim?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.compress_exemplar Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.compress_exemplar`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.compress_finetune_trace Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.compress_finetune_trace`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.consolidate Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.consolidate`: Supported Method Parameters\n\nremoved = PWN::AI::Agent::Learning.consolidate(\n\nmax_entries: 'optional - hard cap on PWN::Memory size (default MAX_MEMORY_ENTRIES)'\n\n)\n\nDeduplicates near-identical lesson values and prunes the oldest entries once the cap is exceeded so the injected MEMORY block stays high-signal.\n"}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.display_task Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.display_task`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.distill_skill Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.distill_skill`: Supported Method Parameters\n\nskill = PWN::AI::Agent::Learning.distill_skill(\n\nname: 'required - snake_case name for the new skill',\nsession_id: 'optional - PWN::Sessions id to mine (uses its transcript)',\ncontent: 'optional - explicit markdown body; overrides transcript mining',\nreferences: 'optional - Array of reference URLs / CWE / CVE / ATT&CK ids'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.exemplars_for Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.exemplars_for`: Supported Method Parameters\n\nmsgs = PWN::AI::Agent::Learning.exemplars_for(\n\nrequest: 'required - current user request',\nlimit: 'optional - max exemplar traces to return (default 1)',\nmax_msgs: 'optional - cap on messages per exemplar (default 6)'\n\n)\n\nRetrieval-augmented BEHAVIOUR: keyword-matches request against prior successful outcomes in learning.jsonl, loads the matching session, and compresses its (user, tool, assistant) trace into a short few-shot exemplar Loop.run splices between system and user. Local models are dramatically better with 1 concrete example than with 25 abstract lessons.\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.export_finetune Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.export_finetune`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.fact_check_local_final Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.fact_check_local_final`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.flip_last_outcome Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.flip_last_outcome`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.fold_judge_into_metrics Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.fold_judge_into_metrics`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.gc_stores! Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.gc_stores!`: Supported Method Parameters\n\nresult = PWN::AI::Agent::Learning.gc_stores!(\n\ndry_run: 'optional - Boolean (default false)',\ncurrent_session_id: 'optional - never delete this sessions id',\nmax_entries: 'optional - Memory consolidate cap',\nmax_rows: 'optional - learning.jsonl cap',\nretain_days: 'optional - outcome / session age floor'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.help Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.heuristic_lessons Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.heuristic_lessons`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.infer_success Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.infer_success`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.introspective_lessons Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.introspective_lessons`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.lean! Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.lean!`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.maybe_prune_outcomes! Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.maybe_prune_outcomes!`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.merge_cluster Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.merge_cluster`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.note_outcome Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.note_outcome`: Supported Method Parameters\n\nentry = PWN::AI::Agent::Learning.note_outcome(\n\ntask: 'required - short description of what was attempted',\nsuccess: 'required - Boolean, did the attempt achieve its goal',\ndetails: 'optional - free-form notes / error / evidence',\nsession_id: 'optional - PWN::Sessions id this outcome belongs to',\ntags: 'optional - Array of String labels for later retrieval'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.outcomes Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.outcomes`: Supported Method Parameters\n\nrows = PWN::AI::Agent::Learning.outcomes(\n\nlimit: 'optional - max entries returned newest-first (default 50)',\nsuccess: 'optional - filter by Boolean outcome',\ntag: 'optional - filter by tag substring'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.prefer_primary_tasks Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.prefer_primary_tasks`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.process_sop_text? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.process_sop_text?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.promote_process_lesson Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.promote_process_lesson`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.prune_outcomes! Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.prune_outcomes!`: Supported Method Parameters\n\nresult = PWN::AI::Agent::Learning.prune_outcomes!(\n\ndry_run: 'optional - Boolean (default false)',\nmax_rows: 'optional - hard cap (default MAX_OUTCOME_ROWS)',\nretain_days: 'optional - age floor for low-value drop',\nrecent_days: 'optional - always keep newer than this'\n\n)\n\nKeep gold RL rows (success+score>=0.6+session_id), recent window, high-value tags, and near-miss failures. Dedupe by task+success keeping best score. Truncate details. Never sacrifices exemplar pool.\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.purge_noise Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.purge_noise`: Supported Method Parameters\n\nPWN::AI::Agent::Learning.purge_noise\n\nOne-shot GC of the pre-R1 garbage: drops every PWN::Memory entry matching the old ‘SUCCESS: <req> — <final>` / `Avoid repeating failure pattern from <tool>: {“success”:true` shapes. Run once after upgrading; subsequent writes never produce these.\n"}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.reconcile_verdict_tags! Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.reconcile_verdict_tags!`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.recover_predicted_from_session Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.recover_predicted_from_session`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.reflect Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.reflect`: Supported Method Parameters\n\nreport = PWN::AI::Agent::Learning.reflect(\n\nsession_id: 'required - PWN::Sessions id to analyse',\ndry_run: 'optional - when true, do not write to Memory/Skills (default false)'\n\n)\n\nUses PWN::AI::Agent::Reflect (when available) to LLM-summarise the session into structured lessons. Falls back to a heuristic extractor when module_reflection is disabled so learning never stops.\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.reset Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.reset`: Supported Method Parameters\n\nPWN::AI::Agent::Learning.reset\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.semantic_merge Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.semantic_merge`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.sharegpt_role Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.sharegpt_role`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.should_gc_stores? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.should_gc_stores?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.skills_dir Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.skills_dir`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.stats Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.stats`: Supported Method Parameters\n\nstats = PWN::AI::Agent::Learning.stats\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.to_context Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.to_context`: Supported Method Parameters\n\nctx = PWN::AI::Agent::Learning.to_context(\n\nlimit: 'optional - number of recent outcomes to surface (default 5)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.transcript_text Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.transcript_text`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.verdict_for_score Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.verdict_for_score`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.active_engine Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.active_engine`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.agent_flag Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.agent_flag`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.append_session Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.append_session`: "}]}
@@ -357,6 +368,7 @@
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Mistakes.find Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Mistakes.find`: Supported Method Parameters\n\nentry = PWN::AI::Agent::Mistakes.find(\n\nsignature: 'optional - exact signature to fetch',\ntool: 'optional - with error:, compute signature and fetch',\nerror: 'optional - raw error text (used with tool:)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Mistakes.for_tool Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Mistakes.for_tool`: Supported Method Parameters\n\nrows = PWN::AI::Agent::Mistakes.for_tool(\n\ntool: 'required - tool name',\nunresolved_only: 'optional - default false'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Mistakes.help Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Mistakes.help`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Mistakes.lean! Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Mistakes.lean!`: Supported Method Parameters\n\nresult = PWN::AI::Agent::Mistakes.lean!(\n\ndry_run: 'optional - Boolean (default false)',\nmax_resolved_kept: 'optional - cap on resolved-with-fix records',\nresolved_min_age_days: 'optional - age before resolved count=1 may drop'\n\n)\n\nCompact text fields on every record. Never drops unresolved, regressed, or high-count repeaters. Aged resolved-once fixes may drop after Memory already holds mistake_fix_<sig>.\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Mistakes.load Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Mistakes.load`: Supported Method Parameters\n\nstore = PWN::AI::Agent::Mistakes.load\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Mistakes.normalize_error Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Mistakes.normalize_error`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Mistakes.park Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Mistakes.park`: "}]}
@@ -1220,11 +1232,13 @@
 {"messages":[{"role":"user","content":"PWN::FFI::Volk.sqrt Usage"},{"role":"assistant","content":"`PWN::FFI::Volk.sqrt`: Supported Method Parameters\n\nout = PWN::FFI::Volk.sqrt(samples: Array<Float>)\n"}]}
 {"messages":[{"role":"user","content":"PWN::FFI::Volk.unpack_s16le Usage"},{"role":"assistant","content":"`PWN::FFI::Volk.unpack_s16le`: Supported Method Parameters\n\nsamples = PWN::FFI::Volk.unpack_s16le(\n\ndata: 'required - raw String of little-endian signed 16-bit PCM'\n\n) Returns Array<Float> normalised to -1.0..1.0 (same contract as PWN::SDR::Decoder::DSP.unpack_s16le). VOLK treats ‘scalar` as a divisor, so pass 32768.0 to get unit-range floats.\n"}]}
 {"messages":[{"role":"user","content":"PWN::Memory.authors Usage"},{"role":"assistant","content":"`PWN::Memory.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
-{"messages":[{"role":"user","content":"PWN::Memory.clear Usage"},{"role":"assistant","content":"`PWN::Memory.clear`: Supported Method Parameters\n\nPWN::Memory.clear\n"}]}
-{"messages":[{"role":"user","content":"PWN::Memory.forget Usage"},{"role":"assistant","content":"`PWN::Memory.forget`: Supported Method Parameters\n\nPWN::Memory.forget(key: :some_key)\n"}]}
+{"messages":[{"role":"user","content":"PWN::Memory.clear Usage"},{"role":"assistant","content":"`PWN::Memory.clear`: Supported Method Parameters\n\nPWN::Memory.clear(force: true)\n"}]}
+{"messages":[{"role":"user","content":"PWN::Memory.forget Usage"},{"role":"assistant","content":"`PWN::Memory.forget`: Supported Method Parameters\n\nPWN::Memory.forget(\n\nkey: :some_key,\nforce: 'optional - Boolean bypass protect policy (default false)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Memory.help Usage"},{"role":"assistant","content":"`PWN::Memory.help`: "}]}
+{"messages":[{"role":"user","content":"PWN::Memory.lean! Usage"},{"role":"assistant","content":"`PWN::Memory.lean!`: Supported Method Parameters\n\nresult = PWN::Memory.lean!(\n\ndry_run: 'optional - Boolean plan only (default false)',\nvalue_max_chars: 'optional - truncate values (default VALUE_MAX_CHARS)',\nephemeral_ttl_secs: 'optional - drop expired session_* keys'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Memory.load Usage"},{"role":"assistant","content":"`PWN::Memory.load`: Supported Method Parameters\n\nmemory = PWN::Memory.load\n"}]}
 {"messages":[{"role":"user","content":"PWN::Memory.load_raw_or_empty Usage"},{"role":"assistant","content":"`PWN::Memory.load_raw_or_empty`: "}]}
+{"messages":[{"role":"user","content":"PWN::Memory.protected_entry? Usage"},{"role":"assistant","content":"`PWN::Memory.protected_entry?`: "}]}
 {"messages":[{"role":"user","content":"PWN::Memory.recall Usage"},{"role":"assistant","content":"`PWN::Memory.recall`: Supported Method Parameters\n\nresults = PWN::Memory.recall(\n\nquery: 'optional - string to search keys/values/categories (simple match)',\ncategory: 'optional - filter by category',\nlimit: 'optional - max results (default 50)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Memory.recall_semantic Usage"},{"role":"assistant","content":"`PWN::Memory.recall_semantic`: Supported Method Parameters\n\nhits = PWN::Memory.recall_semantic(query: ‘nmap sweep’, limit: 6)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Memory.remember Usage"},{"role":"assistant","content":"`PWN::Memory.remember`: Supported Method Parameters\n\nPWN::Memory.remember(\n\nkey: 'required - Symbol or String key for the memory fact',\nvalue: 'required - The value (any JSON serializable)',\ncategory: 'optional - e.g. :fact, :preference, :lesson, :env (default: :fact)',\nsource: 'optional - :human | :reflect | :heuristic | :resolve | :consolidate (M3 provenance)',\nconfidence: 'optional - 0.0..1.0 how sure the writer was (M3)',\nimportance: 'optional - 0.0..1.0 retrieval/eviction weight (M2/M3)',\nttl: 'optional - seconds until stale (M3; consolidate evicts stale low-conf first)'\n\n)\n"}]}
@@ -2378,13 +2392,17 @@
 {"messages":[{"role":"user","content":"PWN::SDR::SonMicroRFID.write_tag Usage"},{"role":"assistant","content":"`PWN::SDR::SonMicroRFID.write_tag`: Supported Method Parameters\n\nPWN::SDR::SonMicroRFID.write_tag(\n\nson_micro_rfid_obj: 'required - son_micro_rfid_obj returned from #connect method',\nrfid_data: 'required - RFID data to write (see #read_tag for structure)',\nauthn: 'optional - authentication flag (default: false)',\nkey: 'optional - key for authentication (default: [0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF])'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Sessions.append Usage"},{"role":"assistant","content":"`PWN::Sessions.append`: Supported Method Parameters\n\nPWN::Sessions.append(\n\nsession_id: 'required',\nrole: 'user|assistant|system|observation',\ncontent: 'the message or obs'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Sessions.authors Usage"},{"role":"assistant","content":"`PWN::Sessions.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
+{"messages":[{"role":"user","content":"PWN::Sessions.compact_transcript! Usage"},{"role":"assistant","content":"`PWN::Sessions.compact_transcript!`: "}]}
 {"messages":[{"role":"user","content":"PWN::Sessions.create Usage"},{"role":"assistant","content":"`PWN::Sessions.create`: Supported Method Parameters\n\nsession = PWN::Sessions.create(\n\ntitle: 'optional - human title',\nsource: 'optional - e.g. pwn-ai-repl'\n\n)\n"}]}
-{"messages":[{"role":"user","content":"PWN::Sessions.delete Usage"},{"role":"assistant","content":"`PWN::Sessions.delete`: Supported Method Parameters\n\nPWN::Sessions.delete(session_id:)\n"}]}
+{"messages":[{"role":"user","content":"PWN::Sessions.delete Usage"},{"role":"assistant","content":"`PWN::Sessions.delete`: Supported Method Parameters\n\nPWN::Sessions.delete(\n\nsession_id: 'required',\nforce: 'optional - Boolean bypass pin policy (default false)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Sessions.help Usage"},{"role":"assistant","content":"`PWN::Sessions.help`: "}]}
+{"messages":[{"role":"user","content":"PWN::Sessions.lean! Usage"},{"role":"assistant","content":"`PWN::Sessions.lean!`: Supported Method Parameters\n\nresult = PWN::Sessions.lean!(\n\ndry_run: 'optional - Boolean (default false)',\nretain_days: 'optional - drop unreferenced older than this',\nhot_days: 'optional - always keep newer than this',\nmax_files: 'optional - soft file cap after protections',\ncurrent_session_id: 'optional - never delete this id'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Sessions.list Usage"},{"role":"assistant","content":"`PWN::Sessions.list`: Supported Method Parameters\n\nsessions = PWN::Sessions.list\n"}]}
 {"messages":[{"role":"user","content":"PWN::Sessions.load Usage"},{"role":"assistant","content":"`PWN::Sessions.load`: Supported Method Parameters\n\ntranscript = PWN::Sessions.load(session_id: ‘required’)\n"}]}
+{"messages":[{"role":"user","content":"PWN::Sessions.protected_session_ids Usage"},{"role":"assistant","content":"`PWN::Sessions.protected_session_ids`: "}]}
 {"messages":[{"role":"user","content":"PWN::Sessions.sessions_dir Usage"},{"role":"assistant","content":"`PWN::Sessions.sessions_dir`: Supported Method Parameters\n\ndir = PWN::Sessions.sessions_dir\n"}]}
 {"messages":[{"role":"user","content":"PWN::Sessions.stats Usage"},{"role":"assistant","content":"`PWN::Sessions.stats`: Supported Method Parameters\n\nstats = PWN::Sessions.stats\n"}]}
+{"messages":[{"role":"user","content":"PWN::Sessions.stub_session? Usage"},{"role":"assistant","content":"`PWN::Sessions.stub_session?`: "}]}
 {"messages":[{"role":"user","content":"PWN::Sessions.to_response_history Usage"},{"role":"assistant","content":"`PWN::Sessions.to_response_history`: Supported Method Parameters\n\nhistory_for_ai = PWN::Sessions.to_response_history(session_id:) (converts transcript to the response_history format used by PWN::AI::* .chat)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Setup.ai_active_engine Usage"},{"role":"assistant","content":"`PWN::Setup.ai_active_engine`: "}]}
 {"messages":[{"role":"user","content":"PWN::Setup.ai_key_configured? Usage"},{"role":"assistant","content":"`PWN::Setup.ai_key_configured?`: "}]}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pwn
 version: !ruby/object:Gem::Version
-  version: 0.5.663
+  version: 0.5.665
 platform: ruby
 authors:
 - 0day Inc.
@@ -2309,6 +2309,7 @@ files:
 - spec/lib/pwn/ai/agent/extrospection_spec.rb
 - spec/lib/pwn/ai/agent/gqrx_spec.rb
 - spec/lib/pwn/ai/agent/hacker_one_spec.rb
+- spec/lib/pwn/ai/agent/lean_stores_spec.rb
 - spec/lib/pwn/ai/agent/learning_spec.rb
 - spec/lib/pwn/ai/agent/loop_spec.rb
 - spec/lib/pwn/ai/agent/metrics_spec.rb