pwn 0.5.708 → 0.5.710

data/etc/default_skills/pwn/plugins/gdb/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: pwn-plugins-gdb
+description: Drive PWN::Plugins::GDB from pwn_eval.
+license: MIT
+allowed-tools: [pwn, pwn_eval]
+metadata:
+  bundled: true
+  generated: true
+  module: PWN::Plugins::GDB
+  source: pwn/plugins/gdb.rb
+---
+
+# PWN::Plugins::GDB
+
+gdb/MI batch driver: run-to-crash, registers, mitigations, core dumps.
+
+## When to use
+
+Call `PWN::Plugins::GDB` from `pwn_eval` when the task needs this module.
+Do not reimplement it in shell.
+
+## Methodologies
+
+Generated from `pwn/plugins/gdb.rb`. Prefer the public class methods below.
+Class methods take `(opts = {})` and read `opts`.
+
+## How to call
+
+```ruby
+PWN::Plugins::GDB.help
+PWN::Plugins::GDB.required_bins(opts)
+```
+
+## Public methods
+
+- `required_bins`
+- `batch`
+- `run_to_crash`
+- `registers`
+- `mitigations`
+- `core`
+- `breakpoints`
+- `authors`
+- `help`
+
+## Source
+
+`pwn/plugins/gdb.rb`
+
+## Verification
+
+`PWN::Plugins::GDB.respond_to?(:required_bins)` after the
+module is loaded. Read the source for parameter names.

data/etc/default_skills/pwn/plugins/jobs/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: pwn-plugins-jobs
+description: Drive PWN::Plugins::Jobs from pwn_eval.
+license: MIT
+allowed-tools: [pwn, pwn_eval]
+metadata:
+  bundled: true
+  generated: true
+  module: PWN::Plugins::Jobs
+  source: pwn/plugins/jobs.rb
+---
+
+# PWN::Plugins::Jobs
+
+Background jobs that survive a pwn-ai turn (scans, fuzz campaigns).
+
+## When to use
+
+Call `PWN::Plugins::Jobs` from `pwn_eval` when the task needs this module.
+Do not reimplement it in shell.
+
+## Methodologies
+
+Generated from `pwn/plugins/jobs.rb`. Prefer the public class methods below.
+Class methods take `(opts = {})` and read `opts`.
+
+## How to call
+
+```ruby
+PWN::Plugins::Jobs.help
+PWN::Plugins::Jobs.required_bins(opts)
+```
+
+## Public methods
+
+- `required_bins`
+- `start`
+- `status`
+- `tail`
+- `stop`
+- `authors`
+- `help`
+
+## Source
+
+`pwn/plugins/jobs.rb`
+
+## Verification
+
+`PWN::Plugins::Jobs.respond_to?(:required_bins)` after the
+module is loaded. Read the source for parameter names.

data/etc/default_skills/pwn/plugins/k8s/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: pwn-plugins-k8s
+description: Drive PWN::Plugins::K8s from pwn_eval.
+license: MIT
+allowed-tools: [pwn, pwn_eval]
+metadata:
+  bundled: true
+  generated: true
+  module: PWN::Plugins::K8s
+  source: pwn/plugins/k8s.rb
+---
+
+# PWN::Plugins::K8s
+
+trivy / kube-hunter wrappers plus docker-socket preflight.
+
+## When to use
+
+Call `PWN::Plugins::K8s` from `pwn_eval` when the task needs this module.
+Do not reimplement it in shell.
+
+## Methodologies
+
+Generated from `pwn/plugins/k8s.rb`. Prefer the public class methods below.
+Class methods take `(opts = {})` and read `opts`.
+
+## How to call
+
+```ruby
+PWN::Plugins::K8s.help
+PWN::Plugins::K8s.required_bins(opts)
+```
+
+## Public methods
+
+- `required_bins`
+- `trivy`
+- `kube_hunter`
+- `docker_socket`
+- `authors`
+- `help`
+- `docker_socket?`
+
+## Source
+
+`pwn/plugins/k8s.rb`
+
+## Verification
+
+`PWN::Plugins::K8s.respond_to?(:required_bins)` after the
+module is loaded. Read the source for parameter names.

data/etc/default_skills/pwn/plugins/nuclei/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: pwn-plugins-nuclei
+description: Drive PWN::Plugins::Nuclei from pwn_eval.
+license: MIT
+allowed-tools: [pwn, pwn_eval]
+metadata:
+  bundled: true
+  generated: true
+  module: PWN::Plugins::Nuclei
+  source: pwn/plugins/nuclei.rb
+---
+
+# PWN::Plugins::Nuclei
+
+nuclei wrapper: template/severity, JSONL findings.
+
+## When to use
+
+Call `PWN::Plugins::Nuclei` from `pwn_eval` when the task needs this module.
+Do not reimplement it in shell.
+
+## Methodologies
+
+Generated from `pwn/plugins/nuclei.rb`. Prefer the public class methods below.
+Class methods take `(opts = {})` and read `opts`.
+
+## How to call
+
+```ruby
+PWN::Plugins::Nuclei.help
+PWN::Plugins::Nuclei.required_bins(opts)
+```
+
+## Public methods
+
+- `required_bins`
+- `scan`
+- `to_findings`
+- `to_defectdojo`
+- `authors`
+- `help`
+
+## Source
+
+`pwn/plugins/nuclei.rb`
+
+## Verification
+
+`PWN::Plugins::Nuclei.respond_to?(:required_bins)` after the
+module is loaded. Read the source for parameter names.

data/etc/default_skills/pwn/plugins/preflight_checker/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: pwn-plugins-preflightchecker
+description: Drive PWN::Plugins::PreflightChecker from pwn_eval.
+license: MIT
+allowed-tools: [pwn, pwn_eval]
+metadata:
+  bundled: true
+  generated: true
+  module: PWN::Plugins::PreflightChecker
+  source: pwn/plugins/preflight_checker.rb
+---
+
+# PWN::Plugins::PreflightChecker
+
+Plugin/binary/capability preflight. Plugins declare required_bins / required_caps; HOST summaries list degraded modules without autoloading the whole plugin tree.
+
+## When to use
+
+Call `PWN::Plugins::PreflightChecker` from `pwn_eval` when the task needs this module.
+Do not reimplement it in shell.
+
+## Methodologies
+
+Generated from `pwn/plugins/preflight_checker.rb`. Prefer the public class methods below.
+Class methods take `(opts = {})` and read `opts`.
+
+## How to call
+
+```ruby
+PWN::Plugins::PreflightChecker.help
+PWN::Plugins::PreflightChecker.required_bins(opts)
+```
+
+## Public methods
+
+- `required_bins`
+- `bin`
+- `require_bin`
+- `cap_net_raw`
+- `require_cap_net_raw`
+- `service`
+- `check`
+- `host_summary`
+- `authors`
+- `help`
+- `bin?`
+- `cap_net_raw?`
+- `require_bin!`
+- `require_cap_net_raw!`
+- `service?`
+
+## Source
+
+`pwn/plugins/preflight_checker.rb`
+
+## Verification
+
+`PWN::Plugins::PreflightChecker.respond_to?(:required_bins)` after the
+module is loaded. Read the source for parameter names.

data/etc/default_skills/pwn/plugins/process_tube/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: pwn-plugins-processtube
+description: Drive PWN::Plugins::ProcessTube from pwn_eval.
+license: MIT
+allowed-tools: [pwn, pwn_eval]
+metadata:
+  bundled: true
+  generated: true
+  module: PWN::Plugins::ProcessTube
+  source: pwn/plugins/process_tube.rb
+---
+
+# PWN::Plugins::ProcessTube
+
+PTY.spawn tube: sendline/recvuntil/recvline, persisted across pwn_eval.
+
+## When to use
+
+Call `PWN::Plugins::ProcessTube` from `pwn_eval` when the task needs this module.
+Do not reimplement it in shell.
+
+## Methodologies
+
+Generated from `pwn/plugins/process_tube.rb`. Prefer the public class methods below.
+Class methods take `(opts = {})` and read `opts`.
+
+## How to call
+
+```ruby
+PWN::Plugins::ProcessTube.help
+PWN::Plugins::ProcessTube.required_bins(opts)
+```
+
+## Public methods
+
+- `required_bins`
+- `spawn`
+- `connect`
+- `write_line`
+- `recvuntil`
+- `recvline`
+- `close`
+- `authors`
+- `help`
+
+## Source
+
+`pwn/plugins/process_tube.rb`
+
+## Verification
+
+`PWN::Plugins::ProcessTube.respond_to?(:required_bins)` after the
+module is loaded. Read the source for parameter names.

data/etc/default_skills/pwn/plugins/radare2/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: pwn-plugins-radare2
+description: Drive PWN::Plugins::Radare2 from pwn_eval.
+license: MIT
+allowed-tools: [pwn, pwn_eval]
+metadata:
+  bundled: true
+  generated: true
+  module: PWN::Plugins::Radare2
+  source: pwn/plugins/radare2.rb
+---
+
+# PWN::Plugins::Radare2
+
+Persistent r2pipe-style session: open/cmd/cmdj/close plus helpers.
+
+## When to use
+
+Call `PWN::Plugins::Radare2` from `pwn_eval` when the task needs this module.
+Do not reimplement it in shell.
+
+## Methodologies
+
+Generated from `pwn/plugins/radare2.rb`. Prefer the public class methods below.
+Class methods take `(opts = {})` and read `opts`.
+
+## How to call
+
+```ruby
+PWN::Plugins::Radare2.help
+PWN::Plugins::Radare2.required_bins(opts)
+```
+
+## Public methods
+
+- `required_bins`
+- `open`
+- `cmd`
+- `cmdj`
+- `close`
+- `functions`
+- `xrefs_to`
+- `disasm`
+- `strings`
+- `imports`
+- `sections`
+- `binary_info`
+- `decompile`
+- `authors`
+- `help`
+
+## Source
+
+`pwn/plugins/radare2.rb`
+
+## Verification
+
+`PWN::Plugins::Radare2.respond_to?(:required_bins)` after the
+module is loaded. Read the source for parameter names.

data/etc/default_skills/pwn/plugins/recon/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: pwn-plugins-recon
+description: Drive PWN::Plugins::Recon from pwn_eval.
+license: MIT
+allowed-tools: [pwn, pwn_eval]
+metadata:
+  bundled: true
+  generated: true
+  module: PWN::Plugins::Recon
+  source: pwn/plugins/recon.rb
+---
+
+# PWN::Plugins::Recon
+
+subfinder/httpx/masscan wrappers + cert-transparency (crt.sh, certspotter).
+
+## When to use
+
+Call `PWN::Plugins::Recon` from `pwn_eval` when the task needs this module.
+Do not reimplement it in shell.
+
+## Methodologies
+
+Generated from `pwn/plugins/recon.rb`. Prefer the public class methods below.
+Class methods take `(opts = {})` and read `opts`.
+
+## How to call
+
+```ruby
+PWN::Plugins::Recon.help
+PWN::Plugins::Recon.required_bins(opts)
+```
+
+## Public methods
+
+- `required_bins`
+- `subdomains`
+- `httpx`
+- `masscan`
+- `crt_sh`
+- `amass`
+- `passive_dns`
+- `authors`
+- `help`
+
+## References
+
+- `references/urls.md` — URLs from source
+
+## Source
+
+`pwn/plugins/recon.rb`
+
+## Verification
+
+`PWN::Plugins::Recon.respond_to?(:required_bins)` after the
+module is loaded. Read the source for parameter names.

data/etc/default_skills/pwn/plugins/recon/references/urls.md

@@ -0,0 +1,6 @@
+# PWN::Plugins::Recon source links
+
+- https://api.certspotter.com/v1/issuances?domain=#{URI.encode_www_form_component(domain
+- https://crt.sh/?q=#{URI.encode_www_form_component(domain
+- https://crt.sh/?q=#{URI.encode_www_form_component(
+- https://api.hackertarget.com/hostsearch/?q=#{URI.encode_www_form_component(domain

data/etc/default_skills/pwn/plugins/semgrep/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: pwn-plugins-semgrep
+description: Drive PWN::Plugins::Semgrep from pwn_eval.
+license: MIT
+allowed-tools: [pwn, pwn_eval]
+metadata:
+  bundled: true
+  generated: true
+  module: PWN::Plugins::Semgrep
+  source: pwn/plugins/semgrep.rb
+---
+
+# PWN::Plugins::Semgrep
+
+semgrep wrapper feeding SAST-shaped findings.
+
+## When to use
+
+Call `PWN::Plugins::Semgrep` from `pwn_eval` when the task needs this module.
+Do not reimplement it in shell.
+
+## Methodologies
+
+Generated from `pwn/plugins/semgrep.rb`. Prefer the public class methods below.
+Class methods take `(opts = {})` and read `opts`.
+
+## How to call
+
+```ruby
+PWN::Plugins::Semgrep.help
+PWN::Plugins::Semgrep.required_bins(opts)
+```
+
+## Public methods
+
+- `required_bins`
+- `scan`
+- `authors`
+- `help`
+
+## Source
+
+`pwn/plugins/semgrep.rb`
+
+## Verification
+
+`PWN::Plugins::Semgrep.respond_to?(:required_bins)` after the
+module is loaded. Read the source for parameter names.

data/etc/default_skills/pwn/plugins/sqlmap/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: pwn-plugins-sqlmap
+description: Drive PWN::Plugins::Sqlmap from pwn_eval.
+license: MIT
+allowed-tools: [pwn, pwn_eval]
+metadata:
+  bundled: true
+  generated: true
+  module: PWN::Plugins::Sqlmap
+  source: pwn/plugins/sqlmap.rb
+---
+
+# PWN::Plugins::Sqlmap
+
+sqlmap wrapper to pair with SAST SQL detection.
+
+## When to use
+
+Call `PWN::Plugins::Sqlmap` from `pwn_eval` when the task needs this module.
+Do not reimplement it in shell.
+
+## Methodologies
+
+Generated from `pwn/plugins/sqlmap.rb`. Prefer the public class methods below.
+Class methods take `(opts = {})` and read `opts`.
+
+## How to call
+
+```ruby
+PWN::Plugins::Sqlmap.help
+PWN::Plugins::Sqlmap.required_bins(opts)
+```
+
+## Public methods
+
+- `required_bins`
+- `run`
+- `authors`
+- `help`
+
+## Source
+
+`pwn/plugins/sqlmap.rb`
+
+## Verification
+
+`PWN::Plugins::Sqlmap.respond_to?(:required_bins)` after the
+module is loaded. Read the source for parameter names.

data/etc/default_skills/pwn/plugins/transparent_browser/SKILL.md

@@ -58,10 +58,6 @@ PWN::Plugins::TransparentBrowser.open(opts)
 - `authors`
 - `help`
 
-## References
-
-- `references/urls.md` — URLs from source
-
 ## Source
 
 `pwn/plugins/transparent_browser.rb`

data/etc/default_skills/pwn/plugins/volatility/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: pwn-plugins-volatility
+description: Drive PWN::Plugins::Volatility from pwn_eval.
+license: MIT
+allowed-tools: [pwn, pwn_eval]
+metadata:
+  bundled: true
+  generated: true
+  module: PWN::Plugins::Volatility
+  source: pwn/plugins/volatility.rb
+---
+
+# PWN::Plugins::Volatility
+
+volatility3 wrapper.
+
+## When to use
+
+Call `PWN::Plugins::Volatility` from `pwn_eval` when the task needs this module.
+Do not reimplement it in shell.
+
+## Methodologies
+
+Generated from `pwn/plugins/volatility.rb`. Prefer the public class methods below.
+Class methods take `(opts = {})` and read `opts`.
+
+## How to call
+
+```ruby
+PWN::Plugins::Volatility.help
+PWN::Plugins::Volatility.required_bins(opts)
+```
+
+## Public methods
+
+- `required_bins`
+- `run`
+- `yara`
+- `authors`
+- `help`
+
+## Source
+
+`pwn/plugins/volatility.rb`
+
+## Verification
+
+`PWN::Plugins::Volatility.respond_to?(:required_bins)` after the
+module is loaded. Read the source for parameter names.

data/lib/pwn/ai/agent/assembly.rb

@@ -56,15 +56,18 @@ module PWN
 
         public_class_method def self.help
           puts "USAGE:
-            ai_analysis = PWN::AI::Agent::Assembly.analyze(
+            # Run analyze and return its result
+            #{self}.analyze(
               request: 'required - the assembly opcodes or instructions to be analyzed',
               type: 'required - :opcodes_to_asm|:asm_to_opcodes - specify the type of analysis to perform',
               arch: 'required - name of arch returned from `PWN::Plugins::Assembly.list_supported_archs` (e.g., :i386|:i686|:x86|:x64|:arm|:arm64, etc.)',
               endian: 'required - the endianness of the assembly code (e.g., :little|:big)'
             )
 
+            # Print the AUTHOR(S) string for this module.
             #{self}.authors
           "
+          constants.sort
         end
       end
     end

data/lib/pwn/ai/agent/btc.rb

@@ -37,12 +37,15 @@ module PWN
 
         public_class_method def self.help
           puts "USAGE:
-            ai_analysis = PWN::AI::Agent::BTC.analyze(
+            # Run analyze and return its result
+            #{self}.analyze(
               request: 'required - latest block information retrieved from a bitcoin node via `PWN::Blockchain::BTC.get_latest_block`'
             )
 
+            # Print the AUTHOR(S) string for this module.
             #{self}.authors
           "
+          constants.sort
         end
       end
     end

data/lib/pwn/ai/agent/burp_suite.rb

@@ -71,12 +71,15 @@ module PWN
 
         public_class_method def self.help
           puts "USAGE:
-            ai_analysis = PWN::AI::Agent::BurpSuite.analyze(
-              request: 'required HTTP request/response pair or WebSocket message as a string'
+            # Run analyze and return its result
+            #{self}.analyze(
+              request: 'required - required HTTP request/response pair or WebSocket message as a string'
             )
 
+            # Print the AUTHOR(S) string for this module.
             #{self}.authors
           "
+          constants.sort
         end
       end
     end