pwn 0.5.702 → 0.5.704

data/lib/pwn/plugins/repl.rb

@@ -384,7 +384,10 @@ module PWN
             name = "\001\e[1m\002\001\e[33m\002#{pi.config.prompt_name}\001\e[0m\002"
             dchars = "\001\e[32m\002>>>\001\e[33m\002"
             dchars = "\001\e[33m\002***\001\e[33m\002" if mode == :splat
-            if pi.config.pwn_ai_debug
+            if pi.config.pwn_ai_trace
+              dchars = "\001\e[31m\002(TRACE) >>>\001\e[33m\002"
+              dchars = "\001\e[31m\002(TRACE) ***\001\e[33m\002" if mode == :splat
+            elsif pi.config.pwn_ai_debug
               dchars = "\001\e[32m\002(DEBUG) >>>\001\e[33m\002"
               dchars = "\001\e[33m\002(DEBUG) ***\001\e[33m\002" if mode == :splat
             end
@@ -465,6 +468,7 @@ module PWN
             rescue StandardError
               "#{Dir.home}/.pwn/skills"
             end
+            PWN::ModuleSkills.install(pwn_skills_path: skills_path) if defined?(PWN::ModuleSkills) && PWN::ModuleSkills.respond_to?(:install)
             PWN::Config.load_skills(pwn_skills_path: skills_path)
             skills_count = (PWN.const_defined?(:Skills) ? PWN::Skills.keys.length : 0)
 
@@ -1047,13 +1051,14 @@ module PWN
         end
 
         Pry::Commands.create_command 'toggle-debug' do
-          description 'Stream pwn-ai stage log to the TUI and /tmp/pwn-ai-DEBUG-<SESSION_ID>-RN.log (trace: Env ai.agent.debug_trace)'
+          description 'Stream pwn-ai stage log to the TUI and /tmp/pwn-ai-DEBUG-<SESSION_ID>-RN.log'
 
           def process
             pi = pry_instance
             if pi.config.pwn_ai_debug
               path = PWN::Plugins::Log.stop_debug
               pi.config.pwn_ai_debug = false
+              pi.config.pwn_ai_trace = false
               if path
                 output.puts "pwn-ai debug OFF (was #{path})"
               else
@@ -1068,6 +1073,26 @@ module PWN
           end
         end
 
+        Pry::Commands.create_command 'toggle-trace' do
+          description 'toggle-debug plus TracePoint; ENTER after each Loop step. Stored on Pry.config like toggle-debug, not Env.'
+
+          def process
+            pi = pry_instance
+            if pi.config.pwn_ai_trace
+              PWN::Plugins::Log.stop_debug
+              pi.config.pwn_ai_debug = false
+              pi.config.pwn_ai_trace = false
+              output.puts 'pwn-ai trace OFF (debug OFF)'
+            else
+              sid = pi.config.pwn_ai_session_id
+              PWN::Plugins::Log.start_debug(tee: output, session_id: sid, trace: true)
+              pi.config.pwn_ai_debug = true
+              pi.config.pwn_ai_trace = true
+              output.puts 'pwn-ai trace ON (debug ON, TracePoint, ENTER each loop step)'
+            end
+          end
+        end
+
         Pry::Commands.create_command 'toggle-pwn-ai-speaks' do
           description 'Use speech capabilities within pwn.ai to speak answers.'
 
@@ -1558,12 +1583,13 @@ module PWN
       end
 
       PWN_AI_SLASH_COMMANDS = %w[
-        /back /cron /debug /delegate /help /memory /model /sessions /skills
+        /back /cron /debug /delegate /help /memory /model /sessions /skills /trace
       ].freeze
 
       PWN_AI_SLASH_SUBCOMMANDS = {
         '/cron' => %w[list create run remove],
         '/debug' => [],
+        '/trace' => [],
         '/delegate' => [],
         '/help' => [],
         '/memory' => %w[list recall remember forget clear],
@@ -1740,6 +1766,12 @@ module PWN
           else
             puts '[*] toggle-debug'
           end
+        when '/trace'
+          if pi.respond_to?(:eval)
+            pi.eval('toggle-trace')
+          else
+            puts '[*] toggle-trace'
+          end
         when '/cron'
           pwn_ai_run_cron(args: args)
         when '/sessions'

data/lib/pwn/plugins/tty_spinner.rb

@@ -136,7 +136,7 @@ module PWN
         return unless spin.respond_to?(:join)
 
         spin.join(JOIN_SECS)
-      rescue TTY::Spinner::NotSpinningError, StandardError
+      rescue StandardError
         nil
       end
 

data/lib/pwn/plugins/zaproxy.rb

@@ -143,7 +143,7 @@ module PWN
         end
 
         zap_obj
-      rescue Selenium::WebDriver::Error::SessionNotCreatedError, StandardError, SystemExit, Interrupt => e
+      rescue StandardError, SystemExit, Interrupt => e
         stop(zap_obj: zap_obj) unless zap_obj.nil?
         raise e
       end

data/lib/pwn/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PWN
-  VERSION = '0.5.702'
+  VERSION = '0.5.704'
 end

data/spec/integration/config_spec.rb

@@ -88,7 +88,7 @@ RSpec.describe 'PWN::Config / etc/*.EXAMPLE hygiene', :aggregate_failures do
         att&ck
       ]
       seeded = PWN::Config.install_default_skills(pwn_skills_path: dir)
-      expect(seeded.map { |r| r[:name] }).to eq names
+      expect(seeded.map { |r| r[:name] }).to match_array(names)
       names.each do |name|
         path = File.join(dir, name, 'SKILL.md')
         expect(File.file?(path)).to eq(true), path
@@ -129,4 +129,32 @@ RSpec.describe 'PWN::Config / etc/*.EXAMPLE hygiene', :aggregate_failures do
       expect(File.file?(gw_ref)).to eq(true), gw_ref
     end
   end
+
+  it 'installs every SKILL.md under default_skills recursively and load_skills indexes nested dirs' do
+    Dir.mktmpdir('pwn_nested_skills') do |dir|
+      src = File.join(dir, 'src')
+      dest = File.join(dir, 'skills')
+      nested = File.join(src, 'research', 'nested-probe')
+      FileUtils.mkdir_p(File.join(nested, 'references', 'deep'))
+      File.write(
+        File.join(nested, 'SKILL.md'),
+        "---\nname: nested-probe\ndescription: nested probe desc\n---\n# Nested\n"
+      )
+      File.write(File.join(nested, 'references', 'deep', 'note.md'), "# note\n")
+      FileUtils.mkdir_p(File.join(nested, 'scripts'))
+      File.write(File.join(nested, 'scripts', 'skip.rb'), "# helper\n")
+      seeded = PWN::Config.install_default_skills(pwn_skills_path: dest, source: src)
+      expect(seeded.map { |r| r[:name] }).to include('research/nested-probe')
+      expect(File.file?(File.join(dest, 'research', 'nested-probe', 'SKILL.md'))).to eq(true)
+      expect(File.file?(File.join(dest, 'research', 'nested-probe', 'references', 'deep', 'note.md'))).to eq(true)
+      expect(File).not_to exist(File.join(dest, 'research', 'nested-probe', 'scripts', 'skip.rb'))
+      prev = defined?(PWN::Skills) ? PWN::Skills : nil
+      skills = PWN::Config.load_skills(pwn_skills_path: dest)
+      expect(skills.keys.map(&:to_s)).to include('research/nested-probe')
+      expect(skills[:'research/nested-probe'][:description]).to eq('nested probe desc')
+    ensure
+      PWN.send(:remove_const, :Skills) if PWN.const_defined?(:Skills)
+      PWN.const_set(:Skills, prev.freeze) if prev
+    end
+  end
 end

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

@@ -1011,6 +1011,16 @@ describe PWN::AI::Agent::Loop do # rubocop:disable Metrics/BlockLength
           request: 'remember what I said about nmap and implement the scanner fix'
         )
       ).to eq(:act)
+      expect(
+        described_class.request_intent(
+          request: 'are all the skills in ~/.pwn/skills loaded into memory when `pwn-ai` is executed?'
+        )
+      ).not_to eq(:recall)
+      expect(
+        described_class.request_intent(
+          request: 'what does the `pwn/www/youtube` allow me to do?'
+        )
+      ).not_to eq(:recall)
     end
 
     it 'classifies pure greetings and light weather smalltalk as :greeting' do
@@ -1349,6 +1359,8 @@ describe PWN::AI::Agent::Loop do # rubocop:disable Metrics/BlockLength
     expect(src).to match(/debug_msgs_line|msgs=.*\[/)
     expect(src).to match(/PWN::Plugins::Log\.progress/)
     expect(src).to match(/quiet_debug_tui!/)
+    expect(src).to match(/wait_trace_step!/)
+    expect(src).not_to match(/ai.*agent.*debug_trace/)
     expect(described_class).to respond_to(:debug_on?)
   end
 end # rubocop:enable Metrics/BlockLength

data/spec/lib/pwn/ai/agent/tools/ruby_eval_spec.rb

@@ -48,6 +48,19 @@ describe 'PWN::AI::Agent::Tools ruby_eval' do
     expect { HTTP::CookieJar }.not_to raise_error
   end
 
+  it 'restores Digest if the payload assigns Digest so later payload_sig still hashes' do
+    entry = PWN::AI::Agent::Registry.lookup(name: 'pwn_eval')
+    result = entry.handler.call(code: 'Digest = "(self.we"')
+    expect(result[:error]).to be_nil
+    expect(Digest).to be_a(Module)
+    expect(Digest::SHA256.hexdigest('x')).to be_a(String)
+    a = PWN::AI::Agent::Loop.send(:payload_sig, name: 'pwn_eval', args: '{"code":"1"}')
+    b = PWN::AI::Agent::Loop.send(:payload_sig, name: 'pwn_eval', args: '{"code":"2"}')
+    expect(a).not_to eq(b)
+    expect(a).not_to match(/nosig-/)
+    expect(b).not_to match(/nosig-/)
+  end
+
   it 'enforces a timeout on pwn_eval and reports timeout after Ns' do
     tmp = Dir.mktmpdir
     stub_const('PWN::AI::Agent::Mistakes::MISTAKES_FILE', File.join(tmp, 'mistakes.json'))

data/spec/lib/pwn/module_skills_spec.rb

@@ -53,6 +53,18 @@ describe PWN::ModuleSkills do
       expect(File.read(path)).to include(rec[:const])
       expect(File.read(path)).not_to match(/hermes/i)
     end
+    drift = described_class.drift
+    expect(drift[:missing]).to eq([])
+    expect(drift[:stale]).to eq([])
+    expect(drift[:orphans]).to eq([])
+  end
+
+  it 'exposes drift so rake/spec can refuse a stale gem skill tree' do
+    expect(described_class).to respond_to(:drift)
+    rake = File.read(File.expand_path('../../../Rakefile', __dir__))
+    expect(rake).to match(/module_skills/)
+    expect(rake).to match(/ModuleSkills\.refresh!/)
+    expect(rake).to match(/Task\[:spec\]\.enhance|task spec: :module_skills/)
   end
 
   it 'install overwrites existing generated module skills' do

data/spec/lib/pwn/plugins/log_spec.rb

@@ -247,15 +247,17 @@ describe PWN::Plugins::Log do
       expect(body).not_to match(/PWN::AI::Agent::OpenGoal\.current/)
     end
 
-    it 'traces PWN module calls into the same debug log when trace: true' do
+    it 'traces Loop/Dispatch calls and not the rest of PWN::AI when trace: true' do
       path = PWN::Plugins::Log.start_debug(
         tee: StringIO.new,
         path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-#{Time.now.to_i}.log",
         trace: true
       )
+      PWN::AI::Agent::Dispatch.effect(name: 'skills_recall', args: {})
       PWN::AI::Agent::OpenGoal.current if defined?(PWN::AI::Agent::OpenGoal)
       body = File.read(path)
-      expect(body).to match(/PWN::AI::Agent::OpenGoal/)
+      expect(body).to match(/PWN::AI::Agent::Dispatch/)
+      expect(body).not_to match(/PWN::AI::Agent::OpenGoal/)
     end
 
     it 'does not raise when a traced module #name is a Symbol' do
@@ -268,13 +270,13 @@ describe PWN::Plugins::Log do
           :ok
         end
       end
-      stub_const('PWN::AI::Agent::SymNameProbe', probe)
+      stub_const('PWN::AI::Agent::Loop::SymNameProbe', probe)
       PWN::Plugins::Log.start_debug(
         tee: StringIO.new,
         path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-sym.log",
         trace: true
       )
-      expect { PWN::AI::Agent::SymNameProbe.ping }.not_to raise_error
+      expect { PWN::AI::Agent::Loop::SymNameProbe.ping }.not_to raise_error
     end
 
     it 'logs the complete traced call including parameters' do
@@ -283,19 +285,19 @@ describe PWN::Plugins::Log do
           opts[:msg]
         end
       end
-      stub_const('PWN::AI::Agent::ArgProbe', probe)
+      stub_const('PWN::AI::Agent::Dispatch::ArgProbe', probe)
       path = PWN::Plugins::Log.start_debug(
         tee: StringIO.new,
         path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-args.log",
         trace: true
       )
-      PWN::AI::Agent::ArgProbe.echo(
+      PWN::AI::Agent::Dispatch::ArgProbe.echo(
         msg: 'hello-browser',
         url: 'https://example.test/open',
         password: 's3cret-token'
       )
       body = File.read(path)
-      expect(body).to include('PWN::AI::Agent::ArgProbe.echo')
+      expect(body).to include('PWN::AI::Agent::Dispatch::ArgProbe.echo')
       expect(body).to include('hello-browser')
       expect(body).to include('https://example.test/open')
       expect(body).not_to include('s3cret-token')
@@ -308,13 +310,13 @@ describe PWN::Plugins::Log do
           opts[:msg]
         end
       end
-      stub_const('PWN::AI::Agent::ArgProbe', probe)
+      stub_const('PWN::AI::Agent::Dispatch::ArgProbe', probe)
       path = PWN::Plugins::Log.start_debug(
         tee: StringIO.new,
         path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-redact.log",
         trace: true
       )
-      PWN::AI::Agent::ArgProbe.echo(
+      PWN::AI::Agent::Dispatch::ArgProbe.echo(
         header: 'Bearer eyJhbGciOiJIUzI1NiJ9.aaa.bbb',
         blob: "-----BEGIN PRIVATE KEY-----\nMIIB\n-----END PRIVATE KEY-----",
         note: 'xai-abcdefghijklmnopqrstuvwxyz0123456789ABCD'
@@ -332,3 +334,80 @@ describe PWN::Plugins::Log do
     end
   end
 end
+
+describe 'PWN::Plugins::Log toggle-trace step' do
+  after do
+    PWN::Plugins::Log.stop_debug if PWN::Plugins::Log.respond_to?(:stop_debug)
+  end
+
+  it 'pairs TracePoint with ENTER-step when start_debug(trace: true)' do
+    io = StringIO.new("\n")
+    path = PWN::Plugins::Log.start_debug(
+      tee: StringIO.new,
+      path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-step.log",
+      trace: true,
+      step_io: io
+    )
+    expect(PWN::Plugins::Log.debug_enabled?).to eq(true)
+    expect(PWN::Plugins::Log.trace_enabled?).to eq(true)
+    expect(PWN::Plugins::Log).to respond_to(:wait_trace_step!)
+    PWN::Plugins::Log.wait_trace_step!(label: 'engine')
+    expect(io.pos).to be > 0
+    body = File.read(path)
+    expect(body).to match(/trace step/)
+    expect(body).to match(/Press ENTER to Continue\.\.\./i)
+  end
+
+  it 'prints "Press ENTER to Continue..." in red on its own TUI line' do
+    io = StringIO.new("\n")
+    tee = StringIO.new
+    PWN::Plugins::Log.start_debug(
+      tee: tee,
+      path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-enter-color.log",
+      trace: true,
+      step_io: io
+    )
+    PWN::Plugins::Log.wait_trace_step!(label: 'engine')
+    expect(tee.string.lines.map(&:chomp)).to include("\e[31mPress ENTER to Continue...\e[0m")
+  end
+
+  it 'redacts real_config_value? opaque tokens' do
+    probe = Module.new do
+      def self.real_config_value?(opts = {})
+        opts[:value]
+      end
+    end
+    stub_const('PWN::AI::Agent::Dispatch::CfgProbe', probe)
+    path = PWN::Plugins::Log.start_debug(
+      tee: StringIO.new,
+      path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-oauth.log",
+      trace: true
+    )
+    token = 'bnQe3hs8ZSP2KkHj3LSnwzIeDvDv0fmbTQEzsUx4XXW5g22D4Uu6hva_MYossX-GedInWt_dwTgGzpMxoKQECQ'
+    PWN::AI::Agent::Dispatch::CfgProbe.real_config_value?(value: token)
+    body = File.read(path)
+    expect(body).not_to include(token)
+    expect(body).to match(/\[REDACTED\]/)
+  end
+
+  it 'does not wait for ENTER when trace is off or nested' do
+    io = StringIO.new("\n")
+    PWN::Plugins::Log.start_debug(
+      tee: StringIO.new,
+      path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-nostep.log",
+      step_io: io
+    )
+    expect(PWN::Plugins::Log.trace_enabled?).to eq(false)
+    PWN::Plugins::Log.wait_trace_step!(label: 'engine')
+    expect(io.pos).to eq(0)
+    PWN::Plugins::Log.stop_debug
+    PWN::Plugins::Log.start_debug(
+      tee: StringIO.new,
+      path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-nested.log",
+      trace: true,
+      step_io: io
+    )
+    PWN::Plugins::Log.wait_trace_step!(label: 'engine', nested: true)
+    expect(io.pos).to eq(0)
+  end
+end

data/spec/lib/pwn/plugins/repl_pwn_vault_spec.rb

@@ -137,7 +137,8 @@ describe 'toggle-debug' do
   let(:repl_src) { File.read(PWN::Plugins::REPL.method(:add_commands).source_location.first) }
   let(:block) do
     start = repl_src.index("Pry::Commands.create_command 'toggle-debug'")
-    stop = repl_src.index("Pry::Commands.create_command 'toggle-pwn-ai-speaks'")
+    stop = repl_src.index("Pry::Commands.create_command 'toggle-trace'")
+    stop ||= repl_src.index("Pry::Commands.create_command 'toggle-pwn-ai-speaks'")
     repl_src[start...stop]
   end
 
@@ -147,6 +148,41 @@ describe 'toggle-debug' do
     expect(block).to include('pwn-ai-DEBUG')
     expect(block).to include('-R')
   end
+
+  it 'does not persist toggle-debug in PWN::Env' do
+    expect(block).not_to include('PWN::Env')
+    expect(block).to include('pwn_ai_debug')
+  end
+end
+
+describe 'toggle-trace' do
+  let(:repl_src) { File.read(PWN::Plugins::REPL.method(:add_commands).source_location.first) }
+  let(:block) do
+    start = repl_src.index("Pry::Commands.create_command 'toggle-trace'")
+    stop = repl_src.index("Pry::Commands.create_command 'toggle-pwn-ai-speaks'")
+    repl_src[start...stop]
+  end
+
+  it 'exists as a Pry command next to toggle-debug' do
+    expect(repl_src).to include("Pry::Commands.create_command 'toggle-trace'")
+    expect(block).to include('pwn_ai_trace')
+    expect(block).to include('pwn_ai_debug')
+  end
+
+  it 'turns debug and TracePoint on together and off together' do
+    expect(block).to include('start_debug')
+    expect(block).to include('trace: true')
+    expect(block).to include('stop_debug')
+    expect(block).to match(/pwn_ai_debug = true/)
+    expect(block).to match(/pwn_ai_trace = true/)
+    expect(block).to match(/pwn_ai_debug = false/)
+    expect(block).to match(/pwn_ai_trace = false/)
+  end
+
+  it 'does not store toggle-trace in PWN::Env' do
+    expect(block).not_to include('PWN::Env')
+    expect(block).not_to include('debug_trace')
+  end
 end
 
 describe 'pwn-ai debug final answer placement' do

data/spec/lib/pwn/plugins/repl_spec.rb

@@ -20,6 +20,15 @@ describe PWN::Plugins::REPL do
     expect(src).to include('current_context_length')
   end
 
+  it 'paints (TRACE) in red on the PS1 when toggle-trace is on, not green (DEBUG)' do
+    src = File.read(described_class.method(:refresh_ps1_proc).source_location.first)
+    expect(src).to include('pwn_ai_trace')
+    expect(src).to include('(TRACE)')
+    expect(src).to match(/\\e\[31m.*\(TRACE\)/)
+    expect(src).to match(/pwn_ai_trace.*\(TRACE\)/m)
+    expect(src).to match(/pwn_ai_debug.*\(DEBUG\)/m)
+  end
+
   it 'formats compact token counts for the PS1 budget' do
     expect(described_class.compact_context_tokens(tokens: 0)).to eq('0')
     expect(described_class.compact_context_tokens(tokens: 26_000)).to eq('26K')
@@ -35,6 +44,12 @@ describe PWN::Plugins::REPL do
     expect(reader).to match(/ready_tty!/)
   end
 
+  it 'reinstalls generated module skills into ~/.pwn/skills before load_skills on pwn-ai start' do
+    src = File.read(described_class.method(:add_commands).source_location.first)
+    expect(src).to match(/ModuleSkills\.install/)
+    expect(src).to match(/ModuleSkills\.install.*load_skills|install_default_skills.*load_skills/m)
+  end
+
   it 'ready_tty! halts leftover spinner workers so PS1 can redraw without Enter' do
     src = File.read(described_class.method(:ready_tty!).source_location.first)
     expect(src).to match(/halt_all!/)
@@ -67,7 +82,7 @@ describe PWN::Plugins::REPL do
       hits = described_class.pwn_ai_complete(target: '/sk', line: '/sk')
       expect(hits).to include('/skills')
       hits = described_class.pwn_ai_complete(target: '/', line: '/')
-      %w[/cron /skills /sessions /memory /debug /back /help /model].each do |cmd|
+      %w[/cron /skills /sessions /memory /debug /trace /back /help /model].each do |cmd|
         expect(hits).to include(cmd)
       end
       hits = described_class.pwn_ai_complete(target: 'li', line: '/cron li')

data/third_party/pwn_rdoc.jsonl

@@ -391,6 +391,7 @@
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.task_summary_record! Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.task_summary_record!`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.timeout_task Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.timeout_task`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.tool_effects Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.tool_effects`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.wait_trace_step! Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.wait_trace_step!`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.world_knowledge? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.world_knowledge?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.write_verified? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.write_verified?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Metrics.advantage Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Metrics.advantage`: Supported Method Parameters\n\na = PWN::AI::Agent::Metrics.advantage(name: ‘shell’)\n\nC1 — tool.success_rate − global_rate over the rolling window.\n"}]}
@@ -729,6 +730,7 @@
 {"messages":[{"role":"user","content":"PWN::AI::Agent::ToolGuard.payload_spent Usage"},{"role":"assistant","content":"`PWN::AI::Agent::ToolGuard.payload_spent`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::ToolGuard.placeholder? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::ToolGuard.placeholder?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::ToolGuard.present? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::ToolGuard.present?`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::ToolGuard.protect_core_constants! Usage"},{"role":"assistant","content":"`PWN::AI::Agent::ToolGuard.protect_core_constants!`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::ToolGuard.protect_http! Usage"},{"role":"assistant","content":"`PWN::AI::Agent::ToolGuard.protect_http!`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::ToolGuard.reset_timeout_budget Usage"},{"role":"assistant","content":"`PWN::AI::Agent::ToolGuard.reset_timeout_budget`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::ToolGuard.reset_timeout_budget! Usage"},{"role":"assistant","content":"`PWN::AI::Agent::ToolGuard.reset_timeout_budget!`: "}]}
@@ -1394,19 +1396,22 @@
 {"messages":[{"role":"user","content":"PWN::Bounty::LifecycleAuthzReplay.write_runbook Usage"},{"role":"assistant","content":"`PWN::Bounty::LifecycleAuthzReplay.write_runbook`: "}]}
 {"messages":[{"role":"user","content":"PWN::Bounty::LifecycleAuthzReplay.write_yaml Usage"},{"role":"assistant","content":"`PWN::Bounty::LifecycleAuthzReplay.write_yaml`: "}]}
 {"messages":[{"role":"user","content":"PWN::Config.authors Usage"},{"role":"assistant","content":"`PWN::Config.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
+{"messages":[{"role":"user","content":"PWN::Config.copy_missing_references Usage"},{"role":"assistant","content":"`PWN::Config.copy_missing_references`: "}]}
 {"messages":[{"role":"user","content":"PWN::Config.deep_fill! Usage"},{"role":"assistant","content":"`PWN::Config.deep_fill!`: "}]}
 {"messages":[{"role":"user","content":"PWN::Config.default_env Usage"},{"role":"assistant","content":"`PWN::Config.default_env`: Supported Method Parameters\n\nenv = PWN::Config.default_env(\n\npwn_env_path: 'optional - Path to pwn.yaml file.  Defaults to ~/.pwn/pwn.yaml'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Config.default_skill_names Usage"},{"role":"assistant","content":"`PWN::Config.default_skill_names`: "}]}
-{"messages":[{"role":"user","content":"PWN::Config.default_skill_src_dir Usage"},{"role":"assistant","content":"`PWN::Config.default_skill_src_dir`: "}]}
 {"messages":[{"role":"user","content":"PWN::Config.default_skills_dir Usage"},{"role":"assistant","content":"`PWN::Config.default_skills_dir`: "}]}
+{"messages":[{"role":"user","content":"PWN::Config.each_skill_md Usage"},{"role":"assistant","content":"`PWN::Config.each_skill_md`: "}]}
 {"messages":[{"role":"user","content":"PWN::Config.env_template Usage"},{"role":"assistant","content":"`PWN::Config.env_template`: Supported Method Parameters\n\ntmpl = PWN::Config.env_template\n\nThe canonical current-release ~/.pwn/pwn.yaml shape as a pure Hash (no I/O, no vault write, no puts).  Single source of truth used by:\n\n* PWN::Config.default_env      — seed a fresh ~/.pwn/pwn.yaml\n* PWN::Migrate.vault_drift     — diff a user vault against this release\n* PWN::Migrate.backfill_vault  — deep-merge missing keys UNDER the\n  user values on `pwn setup --migrate --fix`\n"}]}
 {"messages":[{"role":"user","content":"PWN::Config.help Usage"},{"role":"assistant","content":"`PWN::Config.help`: "}]}
+{"messages":[{"role":"user","content":"PWN::Config.ingest_skill_md Usage"},{"role":"assistant","content":"`PWN::Config.ingest_skill_md`: "}]}
 {"messages":[{"role":"user","content":"PWN::Config.init_driver_options Usage"},{"role":"assistant","content":"`PWN::Config.init_driver_options`: Supported Method Parameters\n\nenv = PWN::Config.init_driver_options\n"}]}
 {"messages":[{"role":"user","content":"PWN::Config.install_default_skills Usage"},{"role":"assistant","content":"`PWN::Config.install_default_skills`: "}]}
 {"messages":[{"role":"user","content":"PWN::Config.load_memory Usage"},{"role":"assistant","content":"`PWN::Config.load_memory`: Supported Method Parameters\n\nPWN::Config.load_memory\n"}]}
-{"messages":[{"role":"user","content":"PWN::Config.load_skills Usage"},{"role":"assistant","content":"`PWN::Config.load_skills`: Supported Method Parameters\n\nskills = PWN::Config.load_skills(\n\npwn_skills_path: 'optional - Path to skills folder.  Defaults to ~/.pwn/skills'\n\n)\n\nLoads skills into the PWN::Skills constant. Two on-disk shapes are accepted so upgrades are seamless:\n\nagentskills.io  →  <root>/<name>/SKILL.md      (preferred; written by write_skill)\nlegacy flat     →  <root>/<name>.{md,txt,rb,skill,yml,yaml}\n\nEach entry: { type:, format:, path:, dir:, content:, description:,\n\nreferences:, frontmatter:, loaded:?, error:? }\n"}]}
+{"messages":[{"role":"user","content":"PWN::Config.load_skills Usage"},{"role":"assistant","content":"`PWN::Config.load_skills`: Supported Method Parameters\n\nskills = PWN::Config.load_skills(\n\npwn_skills_path: 'optional - Path to skills folder.  Defaults to ~/.pwn/skills'\n\n)\n\nLoads skills into the PWN::Skills constant. Two on-disk shapes are accepted so upgrades are seamless:\n\nagentskills.io  →  <root>/**/SKILL.md          (recursive; written by write_skill)\nmodule skills   →  <root>/pwn/**/SKILL.md\nlegacy flat     →  <root>/<name>.{md,txt,rb,skill,yml,yaml}\n\nEach entry: { type:, format:, path:, dir:, content:, description:,\n\nreferences:, frontmatter:, loaded:?, error:? }\n"}]}
 {"messages":[{"role":"user","content":"PWN::Config.merge_ai_defaults! Usage"},{"role":"assistant","content":"`PWN::Config.merge_ai_defaults!`: "}]}
 {"messages":[{"role":"user","content":"PWN::Config.migrate_legacy_skills Usage"},{"role":"assistant","content":"`PWN::Config.migrate_legacy_skills`: Supported Method Parameters\n\nreport = PWN::Config.migrate_legacy_skills(\n\npwn_skills_path: 'optional - override skills root',\ndelete_legacy:   'optional - remove flat file after migration (default true)'\n\n)\n\nOne-shot converter: every flat ~/.pwn/skills/*.md (etc.) becomes a spec-conformant <name>/SKILL.md with backfilled frontmatter. Idempotent.\n"}]}
+{"messages":[{"role":"user","content":"PWN::Config.module_skill_rel? Usage"},{"role":"assistant","content":"`PWN::Config.module_skill_rel?`: "}]}
 {"messages":[{"role":"user","content":"PWN::Config.parse_skill_frontmatter Usage"},{"role":"assistant","content":"`PWN::Config.parse_skill_frontmatter`: Supported Method Parameters\n\nfm = PWN::Config.parse_skill_frontmatter(content: ‘…’)\n\n→ { frontmatter: Hash(String keys), body: String } Missing / malformed frontmatter returns { frontmatter: {}, body: content }.\n"}]}
 {"messages":[{"role":"user","content":"PWN::Config.parse_skill_references Usage"},{"role":"assistant","content":"`PWN::Config.parse_skill_references`: Supported Method Parameters\n\nrefs = PWN::Config.parse_skill_references(content: ‘…’)\n\nExtracts an Array of reference strings (URLs, CWE/CVE/ATT&CK ids, etc.) from a skill body. Supports three sources, merged & uniq’d:\n\n1) frontmatter `references:` (legacy pwn)\n2) frontmatter `metadata: { references: [...] }` (spec-conformant slot)\n3) markdown `## References` bullet section\n"}]}
 {"messages":[{"role":"user","content":"PWN::Config.pwn_cron_path Usage"},{"role":"assistant","content":"`PWN::Config.pwn_cron_path`: Supported Method Parameters\n\npath = PWN::Config.pwn_cron_path\n"}]}
@@ -1667,12 +1672,15 @@
 {"messages":[{"role":"user","content":"PWN::Migrate.verify_one Usage"},{"role":"assistant","content":"`PWN::Migrate.verify_one`: "}]}
 {"messages":[{"role":"user","content":"PWN::ModuleSkills.authors Usage"},{"role":"assistant","content":"`PWN::ModuleSkills.authors`: "}]}
 {"messages":[{"role":"user","content":"PWN::ModuleSkills.camel Usage"},{"role":"assistant","content":"`PWN::ModuleSkills.camel`: "}]}
+{"messages":[{"role":"user","content":"PWN::ModuleSkills.drift Usage"},{"role":"assistant","content":"`PWN::ModuleSkills.drift`: "}]}
+{"messages":[{"role":"user","content":"PWN::ModuleSkills.enrich_live_methods! Usage"},{"role":"assistant","content":"`PWN::ModuleSkills.enrich_live_methods!`: "}]}
 {"messages":[{"role":"user","content":"PWN::ModuleSkills.enumerate Usage"},{"role":"assistant","content":"`PWN::ModuleSkills.enumerate`: "}]}
 {"messages":[{"role":"user","content":"PWN::ModuleSkills.example_call Usage"},{"role":"assistant","content":"`PWN::ModuleSkills.example_call`: "}]}
 {"messages":[{"role":"user","content":"PWN::ModuleSkills.extract_references Usage"},{"role":"assistant","content":"`PWN::ModuleSkills.extract_references`: "}]}
 {"messages":[{"role":"user","content":"PWN::ModuleSkills.fallback_record Usage"},{"role":"assistant","content":"`PWN::ModuleSkills.fallback_record`: "}]}
 {"messages":[{"role":"user","content":"PWN::ModuleSkills.help Usage"},{"role":"assistant","content":"`PWN::ModuleSkills.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::ModuleSkills.install Usage"},{"role":"assistant","content":"`PWN::ModuleSkills.install`: "}]}
+{"messages":[{"role":"user","content":"PWN::ModuleSkills.live_class_methods Usage"},{"role":"assistant","content":"`PWN::ModuleSkills.live_class_methods`: "}]}
 {"messages":[{"role":"user","content":"PWN::ModuleSkills.parse_file Usage"},{"role":"assistant","content":"`PWN::ModuleSkills.parse_file`: "}]}
 {"messages":[{"role":"user","content":"PWN::ModuleSkills.preserved_skill? Usage"},{"role":"assistant","content":"`PWN::ModuleSkills.preserved_skill?`: "}]}
 {"messages":[{"role":"user","content":"PWN::ModuleSkills.prune_orphans Usage"},{"role":"assistant","content":"`PWN::ModuleSkills.prune_orphans`: "}]}
@@ -2041,6 +2049,7 @@
 {"messages":[{"role":"user","content":"PWN::Plugins::JiraDataCenter.rest_call Usage"},{"role":"assistant","content":"`PWN::Plugins::JiraDataCenter.rest_call`: Supported Method Parameters\n\nrest_call(\n\ntoken: 'required - personal access token',\nhttp_method: 'optional HTTP method (defaults to GET)',\nrest_call: 'required rest call to make per the schema',\nparams: 'optional params passed in the URI or HTTP Headers',\nhttp_body: 'optional HTTP body sent in HTTP methods that support it e.g. POST'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::JiraDataCenter.update_issue Usage"},{"role":"assistant","content":"`PWN::Plugins::JiraDataCenter.update_issue`: Supported Method Parameters\n\nissue_resp = PWN::Plugins::JiraDataCenter.update_issue(\n\nfields: 'required - fields to update in the issue (e.g. summary, description, labels, components, custom fields, etc.)',\nattachments: 'optional - array of attachment paths to upload to the issue (e.g. [\"/tmp/file1.txt\", \"/tmp/file2.txt\"])',\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.append Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.append`: Supported Method Parameters\n\nPWN::Log.create( )\n"}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::Log.apply_trace! Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.apply_trace!`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.authors Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.capture_stderr! Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.capture_stderr!`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.close_debug_file! Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.close_debug_file!`: "}]}
@@ -2060,8 +2069,10 @@
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.next_request_log! Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.next_request_log!`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.note_exception! Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.note_exception!`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.note_interrupt! Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.note_interrupt!`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::Log.opaque_secret? Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.opaque_secret?`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.open_debug_file! Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.open_debug_file!`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.progress Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.progress`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::Log.prompt_trace_enter! Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.prompt_trace_enter!`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.quiet_tui! Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.quiet_tui!`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.raw_stderr Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.raw_stderr`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.remove_stderr_tee! Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.remove_stderr_tee!`: "}]}
@@ -2074,8 +2085,10 @@
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.stop_debug Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.stop_debug`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.stop_trace! Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.stop_trace!`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.trace_arguments Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.trace_arguments`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::Log.trace_enabled? Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.trace_enabled?`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.trace_module_name Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.trace_module_name`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.traceable? Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.traceable?`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::Log.wait_trace_step! Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.wait_trace_step!`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log::DebugStderrTee.new Usage"},{"role":"assistant","content":"`PWN::Plugins::Log::DebugStderrTee.new`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log::DebugStderrTee.<< Usage"},{"role":"assistant","content":"`PWN::Plugins::Log::DebugStderrTee.<<`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log::DebugStderrTee.close Usage"},{"role":"assistant","content":"`PWN::Plugins::Log::DebugStderrTee.close`: "}]}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pwn
 version: !ruby/object:Gem::Version
-  version: 0.5.702
+  version: 0.5.704
 platform: ruby
 authors:
 - 0day Inc.