pwn 0.5.708 → 0.5.709

data/lib/pwn/setup.rb

@@ -236,6 +236,55 @@ module PWN
       'jq' => {
         apt: %w[jq], dnf: %w[jq], pacman: %w[jq], brew: %w[jq], port: %w[jq],
         plugins: %w[extro_osint]
+      },
+      'gdb' => {
+        apt: %w[gdb], dnf: %w[gdb], pacman: %w[gdb], brew: %w[gdb], port: %w[gdb],
+        plugins: %w[PWN::Plugins::GDB]
+      },
+      'r2' => {
+        apt: %w[radare2], dnf: %w[radare2], pacman: %w[radare2], brew: %w[radare2], port: %w[radare2],
+        plugins: %w[PWN::Plugins::Radare2]
+      },
+      'checksec' => {
+        apt: %w[], dnf: %w[], pacman: %w[], brew: %w[], port: %w[],
+        plugins: %w[PWN::Plugins::GDB PWN::Plugins::ExploitDev]
+      },
+      'ROPgadget' => {
+        apt: %w[], dnf: %w[], pacman: %w[], brew: %w[], port: %w[],
+        plugins: %w[PWN::Plugins::ExploitDev]
+      },
+      'one_gadget' => {
+        apt: %w[], dnf: %w[], pacman: %w[], brew: %w[], port: %w[],
+        plugins: %w[PWN::Plugins::ExploitDev]
+      },
+      'qemu-x86_64' => {
+        apt: %w[qemu-user-static], dnf: %w[qemu-user-static], pacman: %w[qemu-user-static],
+        brew: %w[], port: %w[],
+        plugins: %w[PWN::Plugins::GDB]
+      },
+      'yara' => {
+        apt: %w[yara], dnf: %w[yara], pacman: %w[yara], brew: %w[yara], port: %w[yara],
+        plugins: %w[PWN::Plugins::Volatility]
+      },
+      'frida' => {
+        apt: %w[], dnf: %w[], pacman: %w[], brew: %w[], port: %w[],
+        plugins: %w[PWN::Plugins::Frida]
+      },
+      'apktool' => {
+        apt: %w[apktool], dnf: %w[], pacman: %w[apktool], brew: %w[apktool], port: %w[],
+        plugins: %w[PWN::Plugins::Android]
+      },
+      'jadx' => {
+        apt: %w[jadx], dnf: %w[], pacman: %w[jadx], brew: %w[], port: %w[],
+        plugins: %w[PWN::Plugins::Android]
+      },
+      'nuclei' => {
+        apt: %w[nuclei], dnf: %w[], pacman: %w[nuclei], brew: %w[nuclei], port: %w[],
+        plugins: %w[PWN::Plugins::Nuclei]
+      },
+      'hydra' => {
+        apt: %w[hydra], dnf: %w[hydra], pacman: %w[hydra], brew: %w[thc-hydra], port: %w[],
+        plugins: %w[PWN::Plugins::CredentialAttack]
       }
     }.freeze
 
@@ -292,6 +341,11 @@ module PWN
         gems: %w[libusb],
         bins: %w[adb baresip]
       },
+      re: {
+        desc: 'Radare2 · GDB · ExploitDev · Frida · Android RE tier',
+        gems: %w[],
+        bins: %w[gdb r2 checksec ROPgadget one_gadget qemu-x86_64 yara frida apktool jadx]
+      },
       full: {
         desc: 'everything above',
         gems: NATIVE_GEMS.keys,
@@ -869,53 +923,56 @@ module PWN
 
     public_class_method def self.help
       puts "USAGE:
-        # Read-only doctor — which PWN capabilities are usable on this host?
-        #{self}.check
+        # Run pkg manager and return its result
+        #{self}.pkg_manager
 
-        # Install OS headers + rebuild native gems for a capability profile.
-        # profile ∈ #{PROFILES.keys.inspect}
-        #{self}.deps(
-          profile: 'optional - capability profile (default :full)',
-          yes:     'optional - assume yes (non-interactive)',
-          dry_run: 'optional - print commands only'
+        # Run check and return its result
+        #{self}.check(
+          io: 'optional - IO to write the report to (default $stdout)',
+          profile: 'optional - profile value consumed by #check'
         )
 
+        # Run deps and return its result
+        #{self}.deps(
+          profile: 'optional - one of PROFILES.keys (default :full)',
+          yes: 'optional - non-interactive; assume yes to prompts (default false)',
+          dry_run: 'optional - print commands only, do not execute (default false)',
+          io: 'optional - IO to write to (default $stdout)'
+        )
 
-# Opt-in SHIFT+ENTER multi-line support (Terminator plugin + tmux.conf hints).
-#{self}.terminal(
-  yes:     'optional - assume yes (non-interactive)',
-  dry_run: 'optional - print what would happen'
-)
+        # Opt-in installer for SHIFT+ENTER multi-line support in the pwn-ai /
+        #{self}.terminal(
+          yes: 'optional - assume yes; non-interactive (default false)',
+          dry_run: 'optional - print what WOULD happen (default false)',
+          io: 'optional - IO to write to (default $stdout)'
+        )
 
-        # List capability profiles.
-        #{self}.list_profiles
+        # Run list profiles and return its result
+        #{self}.list_profiles(
+          io: 'optional - IO to write to (default $stdout)'
+        )
 
-        # Detected package manager (:apt / :dnf / :pacman / :brew / :port).
-        #{self}.pkg_manager
+        # Delegate to PWN::Migrate.run — verify every ~/.pwn state file is
+        #{self}.migrate(
+          fix: 'optional - also autofix incompatible ~/.pwn files (default false)',
+          dry_run: 'optional - print what WOULD happen (default false)',
+          yes: 'optional - alias for fix:true (CI-friendly)',
+          io: 'optional - IO to write to (default $stdout)'
+        )
 
-        # Data tables — versioned with the gem:
-        #{self}::NATIVE_GEMS   # native ext → OS headers → PWN:: constants
-        #{self}::TOOLCHAIN     # external bin → OS package → PWN:: constants
-        #{self}::PROFILES      # capability profile → gems + bins
-
-        # From the shell:
-        pwn setup                       # == check
-        pwn setup --check
-        pwn setup --deps                # profile :full
-        pwn setup --profile web
-        pwn setup --profile sdr --yes
-        pwn setup --terminal              # opt-in SHIFT+ENTER multi-line (Terminator/tmux)
-        pwn setup --list-profiles
-        pwn setup --dry-run --profile net
-        pwn setup --migrate                  # verify + upgrade ~/.pwn schema
-        pwn setup --migrate --fix            # also autofix incompatible files
-        # Every non-dry-run `pwn setup` also seeds default jobs and starts
-        # (or reuses) the background PWN::Cron worker, then persists it
-        # via the OS-native scheduler (systemd --user / launchd / schtasks / crontab).
-        # `pwn setup --no-cron` disables that persistence; `--cron` re-enables it.
+        # Seed default pwn-ai jobs (idempotent) and start the background
+        #{self}.ensure_cron(
+          restart: 'optional - replace a live worker (default false = reuse)',
+          dry_run: 'optional - do not spawn (default false)',
+          interval: 'optional - worker poll seconds (default PWN::Cron::DEFAULT_INTERVAL)',
+          io: 'optional - IO to write the status line to (default $stdout)',
+          enabled: 'optional - enabled value consumed by #ensure_cron'
+        )
 
+        # Print the AUTHOR(S) string for this module.
         #{self}.authors
       "
+      constants.sort
     end
   end
 end

data/lib/pwn/version.rb

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

data/lib/pwn/www/app_cobalt_io.rb

@@ -111,28 +111,34 @@ module PWN
 
       public_class_method def self.help
         puts "USAGE:
-          browser_obj = #{self}.open(
+          # Open a session or connection and return a handle.
+          #{self}.open(
             browser_type: 'optional - :firefox|:chrome|:ie|:headless (Defaults to :firefox)',
             proxy: 'optional - scheme://proxy_host:port || tor'
           )
 
-          browser_obj = #{self}.login(
+          # Run login and return its result
+          #{self}.login(
             browser_obj: 'required - browser_obj returned from #open method',
-            username: 'required - username',
-            password: 'optional - passwd (will prompt if blank),
+            username: 'required - username value consumed by #login',
+            password: 'optional - passwd (will prompt if blank)',
             mfa: 'optional - if true prompt for mfa token (defaults to false)'
           )
 
-          browser_obj = #{self}.logout(
+          # Run logout and return its result
+          #{self}.logout(
             browser_obj: 'required - browser_obj returned from #open method'
           )
 
+          # Close a session previously returned by #open.
           #{self}.close(
             browser_obj: 'required - browser_obj returned from #open method'
           )
 
+          # Print the AUTHOR(S) string for this module.
           #{self}.authors
         "
+        constants.sort
       end
     end
   end

data/lib/pwn/www/bing.rb

@@ -66,22 +66,27 @@ module PWN
 
       public_class_method def self.help
         puts "USAGE:
-          browser_obj = #{self}.open(
-            browser_type: 'optional :firefox|:chrome|:ie|:headless (Defaults to :firefox)',
-            proxy: 'optional scheme://proxy_host:port || tor'
+          # Open a session or connection and return a handle.
+          #{self}.open(
+            browser_type: 'optional - :firefox|:chrome|:ie|:headless (Defaults to :firefox)',
+            proxy: 'optional - optional scheme://proxy_host:port || tor'
           )
 
-          browser_obj = #{self}.search(
+          # Run a search using the open session.
+          #{self}.search(
             browser_obj: 'required - browser_obj returned from #open method',
             q: 'required - search string'
           )
 
-          browser_obj = #{self}.close(
+          # Close a session previously returned by #open.
+          #{self}.close(
             browser_obj: 'required - browser_obj returned from #open method'
           )
 
+          # Print the AUTHOR(S) string for this module.
           #{self}.authors
         "
+        constants.sort
       end
     end
   end

data/lib/pwn/www/bug_crowd.rb

@@ -108,28 +108,34 @@ module PWN
 
       public_class_method def self.help
         puts "USAGE:
-          browser_obj = #{self}.open(
+          # Open a session or connection and return a handle.
+          #{self}.open(
             browser_type: 'optional - :firefox|:chrome|:ie|:headless (Defaults to :firefox)',
             proxy: 'optional - scheme://proxy_host:port || tor'
           )
 
-          browser_obj = #{self}.login(
+          # Run login and return its result
+          #{self}.login(
             browser_obj: 'required - browser_obj returned from #open method',
-            username: 'required - username',
-            password: 'optional - passwd (will prompt if blank),
+            username: 'required - username value consumed by #login',
+            password: 'optional - passwd (will prompt if blank)',
             mfa: 'optional - if true prompt for mfa token (defaults to false)'
           )
 
-          browser_obj = #{self}.logout(
+          # Run logout and return its result
+          #{self}.logout(
             browser_obj: 'required - browser_obj returned from #open method'
           )
 
+          # Close a session previously returned by #open.
           #{self}.close(
             browser_obj: 'required - browser_obj returned from #open method'
           )
 
+          # Print the AUTHOR(S) string for this module.
           #{self}.authors
         "
+        constants.sort
       end
     end
   end

data/lib/pwn/www/checkip.rb

@@ -52,17 +52,21 @@ module PWN
 
       public_class_method def self.help
         puts "USAGE:
-          browser_obj = #{self}.open(
-            browser_type: 'optional :firefox|:chrome|:ie|:headless (Defaults to :firefox)',
+          # Open a session or connection and return a handle.
+          #{self}.open(
+            browser_type: 'optional - :firefox|:chrome|:ie|:headless (Defaults to :firefox)',
             proxy: 'optional - scheme://proxy_host:port || tor'
           )
 
-          browser_obj = #{self}.close(
-            browser_obj: 'required - browser_obj returned from #open method',
+          # Close a session previously returned by #open.
+          #{self}.close(
+            browser_obj: 'required - browser_obj returned from #open method'
           )
 
+          # Print the AUTHOR(S) string for this module.
           #{self}.authors
         "
+        constants.sort
       end
     end
   end

data/lib/pwn/www/coinbase_pro.rb

@@ -108,28 +108,34 @@ module PWN
 
       public_class_method def self.help
         puts "USAGE:
-          browser_obj = #{self}.open(
+          # Open a session or connection and return a handle.
+          #{self}.open(
             browser_type: 'optional - :firefox|:chrome|:ie|:headless (Defaults to :firefox)',
             proxy: 'optional - scheme://proxy_host:port || tor'
           )
 
-          browser_obj = #{self}.login(
+          # Run login and return its result
+          #{self}.login(
             browser_obj: 'required - browser_obj returned from #open method',
-            username: 'required - username',
-            password: 'optional - passwd (will prompt if blank),
+            username: 'required - username value consumed by #login',
+            password: 'optional - passwd (will prompt if blank)',
             mfa: 'optional - if true prompt for mfa token (defaults to false)'
           )
 
-          browser_obj = #{self}.logout(
+          # Run logout and return its result
+          #{self}.logout(
             browser_obj: 'required - browser_obj returned from #open method'
           )
 
+          # Close a session previously returned by #open.
           #{self}.close(
             browser_obj: 'required - browser_obj returned from #open method'
           )
 
+          # Print the AUTHOR(S) string for this module.
           #{self}.authors
         "
+        constants.sort
       end
     end
   end

data/lib/pwn/www/duckduckgo.rb

@@ -88,26 +88,32 @@ module PWN
 
       public_class_method def self.help
         puts "USAGE:
-          browser_obj = #{self}.open(
-            browser_type: 'optional :firefox|:chrome|:ie|:headless (Defaults to :firefox)',
+          # Open a session or connection and return a handle.
+          #{self}.open(
+            browser_type: 'optional - :firefox|:chrome|:ie|:headless (Defaults to :firefox)',
             proxy: 'optional - scheme://proxy_host:port || tor'
           )
 
-          browser_obj = #{self}.search(
+          # Run a search using the open session.
+          #{self}.search(
             browser_obj: 'required - browser_obj returned from #open method',
-            q: 'required search string'
+            q: 'required - search string'
           )
 
-          browser_obj = #{self}.onion(
+          # Run onion and return its result
+          #{self}.onion(
             browser_obj: 'required - browser_obj returned from #open method'
           )
 
-          browser_obj = #{self}.close(
+          # Close a session previously returned by #open.
+          #{self}.close(
             browser_obj: 'required - browser_obj returned from #open method'
           )
 
+          # Print the AUTHOR(S) string for this module.
           #{self}.authors
         "
+        constants.sort
       end
     end
   end

data/lib/pwn/www/facebook.rb

@@ -97,27 +97,33 @@ module PWN
 
       public_class_method def self.help
         puts "USAGE:
-          browser_obj = #{self}.open(
+          # Open a session or connection and return a handle.
+          #{self}.open(
             browser_type: 'optional - :firefox|:chrome|:ie|:headless (Defaults to :firefox)',
             proxy: 'optional - scheme://proxy_host:port || tor'
           )
 
-          browser_obj = #{self}.login(
+          # Run login and return its result
+          #{self}.login(
             browser_obj: 'required - browser_obj returned from #open method',
-            username: 'required - username',
-            password: 'optional - passwd (will prompt if blank),
+            username: 'required - username value consumed by #login',
+            password: 'optional - passwd (will prompt if blank)'
           )
 
-          browser_obj = #{self}.logout(
+          # Run logout and return its result
+          #{self}.logout(
             browser_obj: 'required - browser_obj returned from #open method'
           )
 
+          # Close a session previously returned by #open.
           #{self}.close(
             browser_obj: 'required - browser_obj returned from #open method'
           )
 
+          # Print the AUTHOR(S) string for this module.
           #{self}.authors
         "
+        constants.sort
       end
     end
   end

data/lib/pwn/www/github.rb

@@ -145,29 +145,35 @@ module PWN
 
       public_class_method def self.help
         puts "USAGE:
-          browser_obj = #{self}.open(
+          # Open a session or connection and return a handle.
+          #{self}.open(
             browser_type: 'optional - :firefox|:chrome|:ie|:headless (Defaults to :firefox)',
             proxy: 'optional - scheme://proxy_host:port || tor'
           )
 
-          browser_obj = #{self}.login(
+          # Run login and return its result
+          #{self}.login(
             browser_obj: 'required - browser_obj returned from #open method',
-            username: 'required - username',
-            password: 'optional - passwd (will prompt if blank),
+            username: 'required - username value consumed by #login',
+            password: 'optional - passwd (will prompt if blank)',
             mfa: 'optional - MFA / TOTP token string, or true to prompt (defaults to false)',
             mfa_token: 'optional - MFA / TOTP token used to reach a post-authenticated state'
           )
 
-          browser_obj = #{self}.logout(
+          # Run logout and return its result
+          #{self}.logout(
             browser_obj: 'required - browser_obj returned from #open method'
           )
 
+          # Close a session previously returned by #open.
           #{self}.close(
             browser_obj: 'required - browser_obj returned from #open method'
           )
 
+          # Print the AUTHOR(S) string for this module.
           #{self}.authors
         "
+        constants.sort
       end
     end
   end

data/lib/pwn/www/google.rb

@@ -87,27 +87,33 @@ module PWN
 
       public_class_method def self.help
         puts "USAGE:
-          browser_obj = #{self}.open(
-            browser_type: 'optional :firefox|:chrome|:ie|:headless (Defaults to :firefox)',
+          # Open a Watir browser on google.com and return browser_obj.
+          #{self}.open(
+            browser_type: 'optional - :firefox|:chrome|:ie|:headless (Defaults to :firefox)',
             proxy: 'optional - scheme://proxy_host:port || tor'
           )
 
-          browser_obj = #{self}.search(
+          # Type a query into Google Search and return browser_obj.
+          #{self}.search(
             browser_obj: 'required - browser_obj returned from #open method',
             q: 'required - search string'
           )
 
-          browser_obj = #{self}.search_linkedin_for_employees_by_company(
+          # Search Google for LinkedIn employee profiles at a given company.
+          #{self}.search_linkedin_for_employees_by_company(
             browser_obj: 'required - browser_obj returned from #open method',
             company: 'required - company string'
           )
 
-          browser_obj = #{self}.close(
+          # Close the browser_obj returned by #open.
+          #{self}.close(
             browser_obj: 'required - browser_obj returned from #open method'
           )
 
+          # Print the AUTHOR(S) string for this module.
           #{self}.authors
         "
+        constants.sort
       end
     end
   end

data/lib/pwn/www/hacker_one.rb

@@ -590,50 +590,61 @@ module PWN
 
       public_class_method def self.help
         puts "USAGE:
-          browser_obj = #{self}.open(
+          # Open a session or connection and return a handle.
+          #{self}.open(
             browser_type: 'optional - :firefox|:chrome|:ie|:headless (Defaults to :firefox)',
             proxy: 'optional - scheme://proxy_host:port || tor'
           )
 
-          programs_arr = #{self}.get_bounty_programs(
+          # Run get bounty programs and return its result
+          #{self}.get_bounty_programs(
             min_payouts_enabled: 'optional - only display programs where payouts are > $0.00 (defaults to false)',
             suppress_progress: 'optional - suppress output (defaults to false)',
             proxy: 'optional - scheme://proxy_host:port || tor'
           )
 
-          scope_details = #{self}.get_scope_details(
+          # Run get scope details and return its result
+          #{self}.get_scope_details(
             program_name: 'required - program name from #get_bounty_programs method',
             proxy: 'optional - scheme://proxy_host:port || tor'
           )
 
-          hacktivity = #{self}.get_hacktivity(
+          # Run get hacktivity and return its result
+          #{self}.get_hacktivity(
             program_name: 'required - program name from #get_bounty_programs method',
             proxy: 'optional - scheme://proxy_host:port || tor'
           )
 
+          # Run save burp target config file and return its result
           #{self}.save_burp_target_config_file(
             programs_arr: 'required - array of hashes returned from #get_bounty_programs method',
             browser_opts: 'optional - opts supported by PWN::Plugins::TransparentBrowser.open method',
             name: 'optional - name of burp target config file (defaults to ALL)',
-            root_dir: 'optional - directory to save burp target config files (defaults to \"./\"))'
+            root_dir: 'optional - directory to save burp target config files (defaults to ./))',
+            browser_type: 'optional - :firefox, :chrome, :ie, or :headless (defaults to :firefox)'
           )
 
-          browser_obj = #{self}.login(
+          # Run login and return its result
+          #{self}.login(
             browser_obj: 'required - browser_obj returned from #open method',
-            username: 'required - username',
-            password: 'optional - passwd (will prompt if blank),
+            username: 'required - username value consumed by #login',
+            password: 'optional - passwd (will prompt if blank)'
           )
 
-          browser_obj = #{self}.logout(
+          # Run logout and return its result
+          #{self}.logout(
             browser_obj: 'required - browser_obj returned from #open method'
           )
 
+          # Close a session previously returned by #open.
           #{self}.close(
             browser_obj: 'required - browser_obj returned from #open method'
           )
 
+          # Print the AUTHOR(S) string for this module.
           #{self}.authors
         "
+        constants.sort
       end
     end
   end

data/lib/pwn/www/linkedin.rb

@@ -97,27 +97,33 @@ module PWN
 
       public_class_method def self.help
         puts "USAGE:
-          browser_obj = #{self}.open(
+          # Open a session or connection and return a handle.
+          #{self}.open(
             browser_type: 'optional - :firefox|:chrome|:ie|:headless (Defaults to :firefox)',
             proxy: 'optional - scheme://proxy_host:port || tor'
           )
 
-          browser_obj = #{self}.login(
+          # Run login and return its result
+          #{self}.login(
             browser_obj: 'required - browser_obj returned from #open method',
-            username: 'required - username',
-            password: 'optional - passwd (will prompt if blank),
+            username: 'required - username value consumed by #login',
+            password: 'optional - passwd (will prompt if blank)'
           )
 
-          browser_obj = #{self}.logout(
+          # Run logout and return its result
+          #{self}.logout(
             browser_obj: 'required - browser_obj returned from #open method'
           )
 
+          # Close a session previously returned by #open.
           #{self}.close(
             browser_obj: 'required - browser_obj returned from #open method'
           )
 
+          # Print the AUTHOR(S) string for this module.
           #{self}.authors
         "
+        constants.sort
       end
     end
   end