pwn 0.5.690 → 0.5.695

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 79b34bb5ecccfe2155e9536b2f853630c78b70e3cfcc20cc99f2bd768b65599e
-  data.tar.gz: 79a8701aaa6e6a67969aba4986e436bf3cc6d653d046e13508adb15b179cba93
+  metadata.gz: 445532063d09a6c2edd54ac2872c295932bdbdc45d025e87fe109a5e8641ce0f
+  data.tar.gz: b8b9aab81ae7c16ffcda16cdea943b85eaf69c93b6de929e2eb9fc288cb8f000
 SHA512:
-  metadata.gz: 52960b3391cce0a439968c453f47831f19d69d4188d02f7f642cddd3d32e1d1bcec7431fdc213b04bd633b7c696f38dc3307d80573660a774473c46d43844ae3
-  data.tar.gz: 98b1d2d51ed8b4abae9c590cc9ef0a37c2c9bfd97d088f912ba552844d44d44833169752f5c6f2444e7ad90a5a62efabb7e63e7a13966006b76a02e7e9548d45
+  metadata.gz: 85071aaac40e5ed6348a52a7858be4dd1b781db8b706324b054a67e254c365bab4d10d4aba182ee42a387e15574b8f6b7fc67d2b31b1559dd17b5d7d6dfccae5
+  data.tar.gz: a677194de81bb47090ba62cebac6f293d68fc4e4876693faae868cfe96434478610fece0478e93eb980af4d688819ea1310cb6048bb7096b27a0bdbe516bf1da

data/Gemfile

@@ -25,7 +25,7 @@ gem 'bundler-audit', '>=0.9.3'
 gem 'bunny', '3.2.0'
 gem 'colorize', '1.1.0'
 gem 'credit_card_validations', '9.0.0'
-gem 'curses', '1.6.0'
+gem 'curses', '1.7.0'
 gem 'diffy', '3.4.4'
 gem 'eventmachine', '1.2.7'
 gem 'executable-hooks', '1.7.1'
@@ -49,8 +49,8 @@ gem 'jwt', '3.2.0'
 gem 'libusb', '0.8.0'
 gem 'luhn', '3.0.0'
 gem 'mail', '2.9.1'
-gem 'mcp', '1.2.0'
-gem 'meshtastic', '0.0.174'
+gem 'mcp', '1.3.0'
+gem 'meshtastic', '0.0.175'
 gem 'metasm', '1.0.6'
 gem 'mongo', '2.25.0'
 gem 'msfrpc-client', '1.1.2'
@@ -81,7 +81,7 @@ gem 'rmagick', '7.1.1'
 gem 'rqrcode', '3.2.0'
 gem 'rspec', '3.13.2'
 gem 'rtesseract', '3.1.4'
-gem 'rubocop', '1.89.0'
+gem 'rubocop', '1.90.0'
 gem 'rubocop-rake', '0.7.1'
 gem 'rubocop-rspec', '3.10.2'
 gem 'ruby-audio', '1.6.1'

data/bin/pwn_setup

@@ -65,15 +65,6 @@ pwn_driver.parse!
 
 begin
   status = 0
-  # Seed default jobs + start/reuse the in-process scheduler so last_run
-  # actually advances. Do this BEFORE the doctor so `pwn setup` reports
-  # the worker as running. Skip list/terminal (no host scheduler needed)
-  # and dry-run (must not spawn).
-  unless opts[:list] || opts[:terminal] || opts[:dry_run]
-    cron_opts = { restart: false, dry_run: false }
-    cron_opts[:enabled] = opts[:cron] unless opts[:cron].nil?
-    PWN::Setup.ensure_cron(**cron_opts)
-  end
 
   if opts[:list]
     PWN::Setup.list_profiles
@@ -95,20 +86,19 @@ begin
       dry_run: opts[:dry_run]
     )
   else
-    # `pwn setup`                       → doctor gate on EVERYTHING
-    # `pwn setup --check`               → same
-    # `pwn setup --check --profile net` → gate ONLY on the :net profile
     r = PWN::Setup.check(profile: opts[:profile])
     status = 1 unless r[:ok]
   end
 
-  # Seed default jobs + start/reuse the in-process scheduler so
-  # last_run actually advances. Skip list/terminal (no host scheduler
-  # needed) and dry-run (must not spawn).
+  # One scheduler pass only. Skip list/terminal/dry-run. Skip migrate when a
+  # worker is already live so `pwn setup --migrate` cannot spawn a second.
   unless opts[:list] || opts[:terminal] || opts[:dry_run]
-    cron_opts = { restart: false, dry_run: false }
-    cron_opts[:enabled] = opts[:cron] unless opts[:cron].nil?
-    PWN::Setup.ensure_cron(**cron_opts)
+    running = defined?(PWN::Cron) && PWN::Cron.worker_status[:running]
+    unless opts[:migrate] && running
+      cron_opts = { restart: false, dry_run: false }
+      cron_opts[:enabled] = opts[:cron] unless opts[:cron].nil?
+      PWN::Setup.ensure_cron(**cron_opts)
+    end
   end
   exit status
 rescue Interrupt

data/documentation/Installation.md

@@ -265,7 +265,12 @@ The first `pwn` launch creates `~/.pwn/` and an **encrypted**
 - `att&ck`
 
 Source lives in the gem at `etc/default_skills/`. `PWN::Config.install_default_skills`
-is idempotent and never overwrites an edited `SKILL.md`. Add at least one
+is idempotent and never overwrites an edited SOP `SKILL.md`. Generated
+module skills under `etc/default_skills/pwn/` (one `<module>/SKILL.md` per
+`PWN::` module, plus `references/` when the source has CWE/NIST/URLs) are
+copied to `~/.pwn/skills/pwn/` and **are** overwritten on
+`pwn setup --migrate` / first launch so they stay in sync with `lib/pwn`.
+`bundle exec rake` rewrites the gem tree via `PWN::ModuleSkills.refresh!`. Add at least one
 LLM engine key with the `pwn-vault` REPL command to enable `pwn-ai` - see
 [Configuration](Configuration.md). `pwn setup` will report the AI-engine
 row as `MISSING` until a key is set.

data/documentation/Skills-Memory-Learning.md

@@ -123,8 +123,9 @@ bundled skills into `~/.pwn/skills/` when the name is missing:
 | `capec` | Exhaustive attack-pattern procedure per CAPEC ID (`references/CAPEC-<id>.md`) |
 | `att&ck` | Exhaustive test procedure per ATT&CK technique (`references/T1059.001.md`) |
 
-Source: `etc/default_skills/` in the gem. Edits in `~/.pwn/skills` are never
-overwritten.
+Source: `etc/default_skills/` in the gem. SOP edits in `~/.pwn/skills/<name>/SKILL.md`
+are never overwritten. Generated `~/.pwn/skills/pwn/**/SKILL.md` module skills
+are updated on migrate when `lib/pwn` changes.
 
 ## Housekeeping
 

data/etc/default_skills/pwn/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: pwn
+description: Drive PWN from pwn_eval.
+license: MIT
+allowed-tools: [pwn, pwn_eval]
+metadata:
+  bundled: true
+  generated: true
+  module: PWN
+  source: pwn.rb
+---
+
+# PWN
+
+Thank you for choosing the Continuous Security Integrtion Framework! Your Source for Source Code Analysis, Vulnerability Scanning, Exploitation, & General Security Testing in a Continuous Integration Environment
+
+## When to use
+
+Call `PWN` from `pwn_eval` when the task needs this module.
+Do not reimplement it in shell.
+
+## Methodologies
+
+Generated from `pwn.rb`. Prefer the public class methods below.
+Class methods take `(opts = {})` and read `opts`.
+
+## How to call
+
+```ruby
+PWN.help
+PWN.help(opts)
+```
+
+## Public methods
+
+- `help`
+
+## Source
+
+`pwn.rb`
+
+## Verification
+
+`PWN.respond_to?(:help)` after the
+module is loaded. Read the source for parameter names.

data/etc/default_skills/pwn/ai/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: pwn-ai
+description: Drive PWN::AI from pwn_eval.
+license: MIT
+allowed-tools: [pwn, pwn_eval]
+metadata:
+  bundled: true
+  generated: true
+  module: PWN::AI
+  source: pwn/ai.rb
+---
+
+# PWN::AI
+
+This file, using the autoload directive loads AI modules into memory only when they're needed. For more information, see: http://www.rubyinside.com/ruby-techniques-revealed-autoload-1652.html
+
+## When to use
+
+Call `PWN::AI` from `pwn_eval` when the task needs this module.
+Do not reimplement it in shell.
+
+## Methodologies
+
+Generated from `pwn/ai.rb`. Prefer the public class methods below.
+Class methods take `(opts = {})` and read `opts`.
+
+## How to call
+
+```ruby
+PWN::AI.help
+PWN::AI.help(opts)
+```
+
+## Public methods
+
+- `authors`
+- `help`
+
+## References
+
+- `references/urls.md` — URLs from source
+
+## Source
+
+`pwn/ai.rb`
+
+## Verification
+
+`PWN::AI.respond_to?(:authors)` after the
+module is loaded. Read the source for parameter names.

data/etc/default_skills/pwn/ai/agent/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: pwn-ai-agent
+description: Drive PWN::AI::Agent from pwn_eval.
+license: MIT
+allowed-tools: [pwn, pwn_eval]
+metadata:
+  bundled: true
+  generated: true
+  module: PWN::AI::Agent
+  source: pwn/ai/agent.rb
+---
+
+# PWN::AI::Agent
+
+This file, using the autoload directive loads SAST modules into memory only when they're needed. For more information, see: http://www.rubyinside.com/ruby-techniques-revealed-autoload-1652.html
+
+## When to use
+
+Call `PWN::AI::Agent` from `pwn_eval` when the task needs this module.
+Do not reimplement it in shell.
+
+## Methodologies
+
+Generated from `pwn/ai/agent.rb`. Prefer the public class methods below.
+Class methods take `(opts = {})` and read `opts`.
+
+## How to call
+
+```ruby
+PWN::AI::Agent.help
+PWN::AI::Agent.help(opts)
+```
+
+## Public methods
+
+- `authors`
+- `help`
+
+## References
+
+- `references/urls.md` — URLs from source
+
+## Source
+
+`pwn/ai/agent.rb`
+
+## Verification
+
+`PWN::AI::Agent.respond_to?(:authors)` after the
+module is loaded. Read the source for parameter names.

data/etc/default_skills/pwn/ai/agent/assembly/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: pwn-ai-agent-assembly
+description: Drive PWN::AI::Agent::Assembly from pwn_eval.
+license: MIT
+allowed-tools: [pwn, pwn_eval]
+metadata:
+  bundled: true
+  generated: true
+  module: PWN::AI::Agent::Assembly
+  source: pwn/ai/agent/assembly.rb
+---
+
+# PWN::AI::Agent::Assembly
+
+This module is an AI agent designed to analyze assembly code, including both opcodes and instructions, for various architectures and endianness. It provides insights into the functionality of the assembly code and can also convert it to C/C++ code when possible.
+
+## When to use
+
+Call `PWN::AI::Agent::Assembly` from `pwn_eval` when the task needs this module.
+Do not reimplement it in shell.
+
+## Methodologies
+
+Generated from `pwn/ai/agent/assembly.rb`. Prefer the public class methods below.
+Class methods take `(opts = {})` and read `opts`.
+
+## How to call
+
+```ruby
+PWN::AI::Agent::Assembly.help
+PWN::AI::Agent::Assembly.analyze(opts)
+```
+
+## Public methods
+
+- `analyze`
+- `authors`
+- `help`
+
+## Source
+
+`pwn/ai/agent/assembly.rb`
+
+## Verification
+
+`PWN::AI::Agent::Assembly.respond_to?(:analyze)` after the
+module is loaded. Read the source for parameter names.

data/etc/default_skills/pwn/ai/agent/btc/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: pwn-ai-agent-btc
+description: Drive PWN::AI::Agent::BTC from pwn_eval.
+license: MIT
+allowed-tools: [pwn, pwn_eval]
+metadata:
+  bundled: true
+  generated: true
+  module: PWN::AI::Agent::BTC
+  source: pwn/ai/agent/btc.rb
+---
+
+# PWN::AI::Agent::BTC
+
+This module is an AI agent designed to analyze Bitcoin blockchain information. It provides insights and summaries based on the latest block data retrieved from a Bitcoin node using `PWN::Blockchain::BTC.get_latest_block`.
+
+## When to use
+
+Call `PWN::AI::Agent::BTC` from `pwn_eval` when the task needs this module.
+Do not reimplement it in shell.
+
+## Methodologies
+
+Generated from `pwn/ai/agent/btc.rb`. Prefer the public class methods below.
+Class methods take `(opts = {})` and read `opts`.
+
+## How to call
+
+```ruby
+PWN::AI::Agent::BTC.help
+PWN::AI::Agent::BTC.analyze(opts)
+```
+
+## Public methods
+
+- `analyze`
+- `authors`
+- `help`
+
+## Source
+
+`pwn/ai/agent/btc.rb`
+
+## Verification
+
+`PWN::AI::Agent::BTC.respond_to?(:analyze)` after the
+module is loaded. Read the source for parameter names.

data/etc/default_skills/pwn/ai/agent/burp_suite/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: pwn-ai-agent-burpsuite
+description: Drive PWN::AI::Agent::BurpSuite from pwn_eval.
+license: MIT
+allowed-tools: [pwn, pwn_eval]
+metadata:
+  bundled: true
+  generated: true
+  module: PWN::AI::Agent::BurpSuite
+  source: pwn/ai/agent/burp_suite.rb
+---
+
+# PWN::AI::Agent::BurpSuite
+
+This module is an AI agent designed to analyze HTTP request/response pairs and WebSocket messages for high-impact vulnerabilities, with a focus on XSS and related issues. It provides detailed analysis and generates PoCs for identified vulnerabilities.
+
+## When to use
+
+Call `PWN::AI::Agent::BurpSuite` from `pwn_eval` when the task needs this module.
+Do not reimplement it in shell.
+
+## Methodologies
+
+Generated from `pwn/ai/agent/burp_suite.rb`. Prefer the public class methods below.
+Class methods take `(opts = {})` and read `opts`.
+
+## How to call
+
+```ruby
+PWN::AI::Agent::BurpSuite.help
+PWN::AI::Agent::BurpSuite.analyze(opts)
+```
+
+## Public methods
+
+- `analyze`
+- `authors`
+- `help`
+
+## References
+
+- `references/urls.md` — URLs from source
+
+## Source
+
+`pwn/ai/agent/burp_suite.rb`
+
+## Verification
+
+`PWN::AI::Agent::BurpSuite.respond_to?(:analyze)` after the
+module is loaded. Read the source for parameter names.

data/etc/default_skills/pwn/ai/agent/burp_suite/references/urls.md

@@ -0,0 +1,3 @@
+# PWN::AI::Agent::BurpSuite source links
+
+- https://target.com/endpoint`

data/etc/default_skills/pwn/ai/agent/curriculum/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: pwn-ai-agent-curriculum
+description: Drive PWN::AI::Agent::Curriculum from pwn_eval.
+license: MIT
+allowed-tools: [pwn, pwn_eval]
+metadata:
+  bundled: true
+  generated: true
+  module: PWN::AI::Agent::Curriculum
+  source: pwn/ai/agent/curriculum.rb
+---
+
+# PWN::AI::Agent::Curriculum
+
+PWN::AI::Agent::Curriculum is Tier 4/5 of the pwn-ai reinforcement loop — the SELF-PLAY layer that turns the agent from a passive experience-recorder into an active learner: S1 .practice — Mistake-driven auto-curriculum. Reads Mistakes.top(unresolved), asks Reflect to generate 3 minimal reproducer prompts per signature, self-plays each under Loop.run, and auto-mistakes_resolve when Reward.judge says the practice run solved it. THE AGENT PRACTISES ITS OWN WEAKNESSES OVERNIGHT. S2 .counterfactual — On a repeated in-turn failure, forks: branch A continues with the correction_hint, branch B asks an alt persona for a different tool. Reward.judge picks the winner; (loser, winner) → Reward.record_preference. Real advantage estimation, not imagined rollouts. S3 .critic — Constitutional critic persona with TOOL ACCESS (can shell/extro_verify the claim). Runs BEFORE note_outcome; its verdict feeds Reward.judge and its concrete flaw becomes a preference pair when the agent self-corrects. S4 .red_team_plan — After plan_first, an adversarial persona reviews the plan against THIS host's Metrics/Mistakes/extro_drift and injects a pre-emptive correction_hint on the step it predicts will fail. C3 .hindsight — Hindsight Experience Replay. On failure, asks the judge "what DID this trajectory accomplish?", relabels the episode with the achieved-goal as success:true. Free positive samples from failures — first HER on real tool traces. W2 .train_and_gate — export_finetune + export_dpo → local LoRA (unsloth/axolotl if installed) → replay Mistakes.top on vN vs vN+1 → promote iff resolved(N+1) > resolved(N). Fully autonomous weight-level self-improvement with a regression gate. W3 .calibrate — Tracks plan_first predicted p(success) vs actual outcome → Brier score in Metrics. All entry points are cron-safe (never raise into the caller) and depth-guarded via Swarm's Thread.current[:pwn_swarm_depth] so a curriculum run cannot recurse into itself.
+
+## When to use
+
+Call `PWN::AI::Agent::Curriculum` from `pwn_eval` when the task needs this module.
+Do not reimplement it in shell.
+
+## Methodologies
+
+Generated from `pwn/ai/agent/curriculum.rb`. Prefer the public class methods below.
+Class methods take `(opts = {})` and read `opts`.
+
+## How to call
+
+```ruby
+PWN::AI::Agent::Curriculum.help
+PWN::AI::Agent::Curriculum.practice(opts)
+```
+
+## Public methods
+
+- `practice`
+- `offline_judge`
+- `preference_balance`
+- `counterfactual`
+- `critic`
+- `red_team_plan`
+- `hindsight`
+- `train_and_gate`
+- `practice_kpi`
+- `repeating_trend`
+- `calibrate`
+- `authors`
+- `help`
+
+## Source
+
+`pwn/ai/agent/curriculum.rb`
+
+## Verification
+
+`PWN::AI::Agent::Curriculum.respond_to?(:practice)` after the
+module is loaded. Read the source for parameter names.

data/etc/default_skills/pwn/ai/agent/dispatch/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: pwn-ai-agent-dispatch
+description: Drive PWN::AI::Agent::Dispatch from pwn_eval.
+license: MIT
+allowed-tools: [pwn, pwn_eval]
+metadata:
+  bundled: true
+  generated: true
+  module: PWN::AI::Agent::Dispatch
+  source: pwn/ai/agent/dispatch.rb
+---
+
+# PWN::AI::Agent::Dispatch
+
+Tool-call dispatch: takes a single tool_call object (OpenAI shape), looks up the registered handler, parses args, runs it, and returns a JSON string suitable for a role:'tool' message. TOLERANT DISPATCH (local-model scaffolding) ------------------------------------------- Local models running on Ollama frequently emit almost- right tool calls: `run_shell` instead of `shell`, trailing commas, single-quoted JSON, arguments as a bare string. Strict parsing burns an iteration and often spirals. Dispatch now: * repair_name — Levenshtein-matches unknown names to the closest registered tool and records a Mistakes fingerprint (source: :repair) so the KNOWN MISTAKES block eventually teaches the model the right name. * parse_args — falls back to a JSON5-ish clean-up pass (strip trailing commas, swap single→double quotes, wrap a bare scalar as the tool's sole required arg). Frontier engines never hit these paths — repair is a no-op when the name/JSON are already valid.
+
+## When to use
+
+Call `PWN::AI::Agent::Dispatch` from `pwn_eval` when the task needs this module.
+Do not reimplement it in shell.
+
+## Methodologies
+
+Generated from `pwn/ai/agent/dispatch.rb`. Prefer the public class methods below.
+Class methods take `(opts = {})` and read `opts`.
+
+## How to call
+
+```ruby
+PWN::AI::Agent::Dispatch.help
+PWN::AI::Agent::Dispatch.call(opts)
+```
+
+## Public methods
+
+- `call`
+- `repair_name`
+- `tool_calls_from_text`
+- `effect`
+- `authors`
+- `help`
+
+## Source
+
+`pwn/ai/agent/dispatch.rb`
+
+## Verification
+
+`PWN::AI::Agent::Dispatch.respond_to?(:call)` after the
+module is loaded. Read the source for parameter names.

data/etc/default_skills/pwn/ai/agent/extrospection/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: pwn-ai-agent-extrospection
+description: Drive PWN::AI::Agent::Extrospection from pwn_eval.
+license: MIT
+allowed-tools: [pwn, pwn_eval]
+metadata:
+  bundled: true
+  generated: true
+  module: PWN::AI::Agent::Extrospection
+  source: pwn/ai/agent/extrospection.rb
+---
+
+# PWN::AI::Agent::Extrospection
+
+PWN::AI::Agent::Extrospection is the outward-facing counterpart to PWN::AI::Agent::Learning (introspection). PRIMARY INTENT - on-demand external sensing ------------------------------------------- Quickly explore *external* resources when that produces a more informed answer. Call a sense tool only when the question needs it: "weather in Tokyo" → verify / watch / TransparentBrowser "what's on 101.1 FM?" → rf_tune(freq: "101.1") → RDS / observe(:rf) "CVE for openssl 3.0?" → intel(query:) / verify(claim:, kind: :cve) "did the target change?" → watch(url:) / snapshot(sections: [:web]) Secondary / optional - ambient host baseline -------------------------------------------- snapshot / drift / correlate can record cheap local posture so the agent can tell "I called the API wrong" from "the world moved" (kernel upgrade, dongle unplugged). This is NEVER the reason to launch GUI / JVM / heavy-REPL binaries - those are presence-only. auto_extrospect, when enabled, uses only side-effect-free sections. INTROSPECTIVE (self) EXTROSPECTIVE (world) ---------------------- ------------------------------------- Metrics.record Extrospection.intel/verify/watch/rf_tune (sense) Learning.note_outcome Extrospection.observe (fact) Learning.reflect Extrospection.snapshot/drift (baseline) Learning.stats Extrospection.correlate (self×world) PromptBuilder re-injects Extrospection.to_context on every turn. Persistence: ~/.pwn/extrospection.json across REPL restarts.
+
+## When to use
+
+Call `PWN::AI::Agent::Extrospection` from `pwn_eval` when the task needs this module.
+Do not reimplement it in shell.
+
+## Methodologies
+
+Generated from `pwn/ai/agent/extrospection.rb`. Prefer the public class methods below.
+Class methods take `(opts = {})` and read `opts`.
+
+## How to call
+
+```ruby
+PWN::AI::Agent::Extrospection.help
+PWN::AI::Agent::Extrospection.load(opts)
+```
+
+## Public methods
+
+- `load`
+- `save`
+- `snapshot`
+- `observe`
+- `observations`
+- `drift`
+- `intel`
+- `verify`
+- `watch`
+- `rf_tune`
+- `osint`
+- `serial_sense`
+- `telecomm`
+- `packet_sense`
+- `vision`
+- `voice_sense`
+- `revalidate_memory`
+- `correlate`
+- `to_context`
+- `stats`
+- `auto_extrospect`
+- `reset`
+- `authors`
+- `help`
+
+## References
+
+- `references/urls.md` — URLs from source
+
+## Source
+
+`pwn/ai/agent/extrospection.rb`
+
+## Verification
+
+`PWN::AI::Agent::Extrospection.respond_to?(:load)` after the
+module is loaded. Read the source for parameter names.

data/etc/default_skills/pwn/ai/agent/extrospection/osint/bridges/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: pwn-ai-agent-extrospection-osintbridges
+description: Drive PWN::AI::Agent::Extrospection::OSINTBridges from pwn_eval.
+license: MIT
+allowed-tools: [pwn, pwn_eval]
+metadata:
+  bundled: true
+  generated: true
+  module: PWN::AI::Agent::Extrospection::OSINTBridges
+  source: pwn/ai/agent/extrospection/osint/bridges.rb
+---
+
+# PWN::AI::Agent::Extrospection::OSINTBridges
+
+Local-tool OSINT bridges for PWN::AI::Agent::Extrospection.osint. Wraps host binaries (theHarvester, spiderfoot, amass, recon-ng) already common on Kali / offensive-tooling images, parses their JSON/CSV output, and returns compact structured hits so they behave like any other feed. Every bridge: * checks binary presence first (returns {skipped:} when absent) * runs passive-only / bounded (timeouts, `-passive`, module lists) * NEVER launches a GUI or web UI
+
+## When to use
+
+Call `PWN::AI::Agent::Extrospection::OSINTBridges` from `pwn_eval` when the task needs this module.
+Do not reimplement it in shell.
+
+## Methodologies
+
+Generated from `pwn/ai/agent/extrospection/osint/bridges.rb`. Prefer the public class methods below.
+Class methods take `(opts = {})` and read `opts`.
+
+## How to call
+
+```ruby
+PWN::AI::Agent::Extrospection::OSINTBridges.help
+PWN::AI::Agent::Extrospection::OSINTBridges.help(opts)
+```
+
+## Public methods
+
+- `authors`
+- `help`
+
+## Source
+
+`pwn/ai/agent/extrospection/osint/bridges.rb`
+
+## Verification
+
+`PWN::AI::Agent::Extrospection::OSINTBridges.respond_to?(:authors)` after the
+module is loaded. Read the source for parameter names.