pwn 0.5.795 → 0.5.796

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (369) hide show
  1. checksums.yaml +4 -4
  2. data/Gemfile +1 -1
  3. data/bin/pwn_autoinc_version +4 -5
  4. data/bin/pwn_web_cache_deception +40 -29
  5. data/documentation/AWS.md +15 -5
  6. data/documentation/Diagrams.md +1 -1
  7. data/documentation/Home.md +2 -2
  8. data/documentation/How-PWN-Works.md +1 -1
  9. data/documentation/What-is-PWN.md +1 -1
  10. data/documentation/diagrams/aws-cloud-security.svg +1 -1
  11. data/documentation/diagrams/dot/aws-cloud-security.dot +1 -1
  12. data/documentation/diagrams/dot/network-infra-testing.dot +1 -1
  13. data/documentation/diagrams/network-infra-testing.svg +1 -1
  14. data/etc/default_cron/session_cleanup.rb +84 -51
  15. data/lib/pwn/ai/agent/assembly.rb +0 -2
  16. data/lib/pwn/ai/agent/btc.rb +0 -2
  17. data/lib/pwn/ai/agent/burp_suite.rb +0 -2
  18. data/lib/pwn/ai/agent/curriculum.rb +2 -2
  19. data/lib/pwn/ai/agent/dispatch.rb +3 -0
  20. data/lib/pwn/ai/agent/engagement.rb +96 -41
  21. data/lib/pwn/ai/agent/extrospection/osint/bridges.rb +2 -0
  22. data/lib/pwn/ai/agent/extrospection.rb +50 -13
  23. data/lib/pwn/ai/agent/gqrx.rb +0 -2
  24. data/lib/pwn/ai/agent/hacker_one.rb +0 -2
  25. data/lib/pwn/ai/agent/learning.rb +45 -13
  26. data/lib/pwn/ai/agent/loop.rb +12 -11
  27. data/lib/pwn/ai/agent/metrics.rb +1 -1
  28. data/lib/pwn/ai/agent/mission.rb +6 -3
  29. data/lib/pwn/ai/agent/policy.rb +1 -1
  30. data/lib/pwn/ai/agent/policy_evaluation.rb +2 -2
  31. data/lib/pwn/ai/agent/reflect.rb +1 -0
  32. data/lib/pwn/ai/agent/request_runtime.rb +1 -1
  33. data/lib/pwn/ai/agent/reward.rb +155 -53
  34. data/lib/pwn/ai/agent/sast.rb +0 -2
  35. data/lib/pwn/ai/agent/task_dag.rb +5 -3
  36. data/lib/pwn/ai/agent/task_summarizer.rb +21 -11
  37. data/lib/pwn/ai/agent/tool_guard.rb +19 -0
  38. data/lib/pwn/ai/agent/tools/ruby_eval.rb +1 -1
  39. data/lib/pwn/ai/agent/tools/verify.rb +7 -3
  40. data/lib/pwn/ai/agent/transparent_browser.rb +0 -2
  41. data/lib/pwn/ai/agent/turn_finalizer.rb +3 -0
  42. data/lib/pwn/ai/anthropic.rb +3 -3
  43. data/lib/pwn/ai/context.rb +2 -1
  44. data/lib/pwn/ai/gemini.rb +7 -5
  45. data/lib/pwn/ai/grok.rb +37 -18
  46. data/lib/pwn/ai/mcp.rb +17 -5
  47. data/lib/pwn/ai/ollama.rb +76 -35
  48. data/lib/pwn/ai/open_ai.rb +7 -19
  49. data/lib/pwn/ai/open_web_ui.rb +76 -40
  50. data/lib/pwn/aws/cloud_search_domain.rb +6 -0
  51. data/lib/pwn/aws/iam.rb +2 -2
  52. data/lib/pwn/aws/workspaces.rb +2 -2
  53. data/lib/pwn/aws.rb +0 -5
  54. data/lib/pwn/bounty/lifecycle_authz_replay.rb +1 -1
  55. data/lib/pwn/config.rb +17 -10
  56. data/lib/pwn/corpus.rb +33 -5
  57. data/lib/pwn/cron.rb +60 -17
  58. data/lib/pwn/driver.rb +2 -3
  59. data/lib/pwn/engagement.rb +28 -10
  60. data/lib/pwn/ffi/capstone.rb +3 -2
  61. data/lib/pwn/ffi/fftw.rb +8 -6
  62. data/lib/pwn/ffi/keystone.rb +3 -2
  63. data/lib/pwn/ffi/soapy_sdr.rb +10 -6
  64. data/lib/pwn/json_text.rb +25 -13
  65. data/lib/pwn/memory_index.rb +6 -4
  66. data/lib/pwn/module_skills.rb +3 -1
  67. data/lib/pwn/plugins/aflplusplus.rb +1 -0
  68. data/lib/pwn/plugins/ai_sandbox.rb +42 -10
  69. data/lib/pwn/plugins/android.rb +429 -466
  70. data/lib/pwn/plugins/artifact_registry.rb +12 -2
  71. data/lib/pwn/plugins/assembly.rb +9 -42
  72. data/lib/pwn/plugins/authentication_helper.rb +4 -3
  73. data/lib/pwn/plugins/baresip.rb +70 -28
  74. data/lib/pwn/plugins/binary_analysis.rb +14 -5
  75. data/lib/pwn/plugins/binary_parser.rb +42 -7
  76. data/lib/pwn/plugins/black_duck_binary_analysis.rb +3 -3
  77. data/lib/pwn/plugins/burp_suite.rb +15 -12
  78. data/lib/pwn/plugins/bus_pirate.rb +3 -7
  79. data/lib/pwn/plugins/char.rb +9 -3
  80. data/lib/pwn/plugins/credit_card.rb +7 -0
  81. data/lib/pwn/plugins/dao_ldap.rb +2 -2
  82. data/lib/pwn/plugins/dao_mongo.rb +1 -1
  83. data/lib/pwn/plugins/debugger.rb +1 -1
  84. data/lib/pwn/plugins/defect_dojo.rb +7 -3
  85. data/lib/pwn/plugins/detect_os.rb +1 -1
  86. data/lib/pwn/plugins/detonate.rb +9 -19
  87. data/lib/pwn/plugins/exploit_db.rb +1 -1
  88. data/lib/pwn/plugins/file_fu.rb +4 -1
  89. data/lib/pwn/plugins/findings.rb +76 -2
  90. data/lib/pwn/plugins/fuzz.rb +12 -3
  91. data/lib/pwn/plugins/gdb.rb +7 -2
  92. data/lib/pwn/plugins/gdbmi.rb +10 -6
  93. data/lib/pwn/plugins/git.rb +18 -13
  94. data/lib/pwn/plugins/github.rb +11 -6
  95. data/lib/pwn/plugins/google_workspace.rb +11 -3
  96. data/lib/pwn/plugins/hacker_one.rb +5 -1
  97. data/lib/pwn/plugins/httpx.rb +24 -8
  98. data/lib/pwn/plugins/ip_info.rb +11 -8
  99. data/lib/pwn/plugins/irc.rb +73 -45
  100. data/lib/pwn/plugins/jenkins.rb +2 -2
  101. data/lib/pwn/plugins/jira_data_center.rb +13 -6
  102. data/lib/pwn/plugins/jobs.rb +62 -4
  103. data/lib/pwn/plugins/log.rb +1 -1
  104. data/lib/pwn/plugins/monkey_patch.rb +1 -1
  105. data/lib/pwn/plugins/msr206.rb +157 -182
  106. data/lib/pwn/plugins/nessus_cloud.rb +2 -2
  107. data/lib/pwn/plugins/nexpose_vuln_scan.rb +44 -33
  108. data/lib/pwn/plugins/nuclei.rb +24 -8
  109. data/lib/pwn/plugins/ocr.rb +3 -1
  110. data/lib/pwn/plugins/open_api.rb +0 -4
  111. data/lib/pwn/plugins/openvas.rb +31 -43
  112. data/lib/pwn/plugins/packet.rb +40 -25
  113. data/lib/pwn/plugins/pony.rb +2 -2
  114. data/lib/pwn/plugins/preflight_checker.rb +1 -1
  115. data/lib/pwn/plugins/process_tube.rb +17 -2
  116. data/lib/pwn/plugins/ps.rb +6 -1
  117. data/lib/pwn/plugins/repl/ai.rb +1 -0
  118. data/lib/pwn/plugins/repl/ai_console.rb +12 -5
  119. data/lib/pwn/plugins/repl/mesh.rb +10 -2
  120. data/lib/pwn/plugins/sbom.rb +59 -27
  121. data/lib/pwn/plugins/scannable_codes.rb +3 -1
  122. data/lib/pwn/plugins/serial.rb +102 -44
  123. data/lib/pwn/plugins/shodan.rb +4 -10
  124. data/lib/pwn/plugins/sock.rb +16 -11
  125. data/lib/pwn/plugins/ssn.rb +3 -1
  126. data/lib/pwn/plugins/transparent_browser.rb +43 -3
  127. data/lib/pwn/plugins/vault.rb +92 -30
  128. data/lib/pwn/plugins/vin.rb +2 -1
  129. data/lib/pwn/plugins/vsphere.rb +2 -1
  130. data/lib/pwn/plugins/xxd.rb +3 -5
  131. data/lib/pwn/plugins/yubikey/security_domain/scp.rb +4 -0
  132. data/lib/pwn/plugins/yubikey/transport.rb +42 -11
  133. data/lib/pwn/plugins/yubikey.rb +21 -6
  134. data/lib/pwn/plugins/zaproxy.rb +3 -4
  135. data/lib/pwn/reports/ai_red_team.rb +4 -4
  136. data/lib/pwn/reports/pdf.rb +9 -5
  137. data/lib/pwn/reports/sast.rb +4 -4
  138. data/lib/pwn/sast/keystore.rb +2 -2
  139. data/lib/pwn/sast/logger.rb +1 -1
  140. data/lib/pwn/sast/php_type_juggling.rb +3 -6
  141. data/lib/pwn/sast/pom_version.rb +12 -6
  142. data/lib/pwn/sast/port.rb +1 -1
  143. data/lib/pwn/sast/sql.rb +3 -7
  144. data/lib/pwn/sast/test_case_engine.rb +62 -16
  145. data/lib/pwn/sast/type_script_type_juggling.rb +3 -6
  146. data/lib/pwn/sdr/decoder/base.rb +8 -0
  147. data/lib/pwn/sdr/decoder/lora.rb +1 -1
  148. data/lib/pwn/sdr/flipper_zero.rb +4 -7
  149. data/lib/pwn/sdr/gqrx.rb +35 -16
  150. data/lib/pwn/sdr/son_micro_rfid.rb +44 -26
  151. data/lib/pwn/sdr.rb +1 -1
  152. data/lib/pwn/session_trace.rb +7 -2
  153. data/lib/pwn/sessions.rb +307 -39
  154. data/lib/pwn/setup.rb +4 -3
  155. data/lib/pwn/version.rb +1 -1
  156. data/lib/pwn/www/app_cobalt_io.rb +14 -2
  157. data/lib/pwn/www/bing.rb +13 -1
  158. data/lib/pwn/www/bug_crowd.rb +14 -2
  159. data/lib/pwn/www/checkip.rb +13 -1
  160. data/lib/pwn/www/coinbase_pro.rb +14 -2
  161. data/lib/pwn/www/duckduckgo.rb +13 -1
  162. data/lib/pwn/www/facebook.rb +14 -2
  163. data/lib/pwn/www/github.rb +14 -2
  164. data/lib/pwn/www/google.rb +13 -1
  165. data/lib/pwn/www/hacker_one.rb +117 -33
  166. data/lib/pwn/www/linkedin.rb +14 -2
  167. data/lib/pwn/www/pandora.rb +14 -2
  168. data/lib/pwn/www/pastebin.rb +13 -1
  169. data/lib/pwn/www/paypal.rb +16 -4
  170. data/lib/pwn/www/synack.rb +14 -2
  171. data/lib/pwn/www/torch.rb +17 -3
  172. data/lib/pwn/www/trading_view.rb +14 -2
  173. data/lib/pwn/www/twitter.rb +14 -2
  174. data/lib/pwn/www/uber.rb +14 -2
  175. data/lib/pwn/www/upwork.rb +14 -2
  176. data/lib/pwn/www/wayback_machine.rb +16 -2
  177. data/lib/pwn/www/youtube.rb +13 -1
  178. data/pwn.gemspec +4 -0
  179. data/spec/integration/authentication_helper_oath_spec.rb +1 -1
  180. data/spec/integration/autoinc_lifecycle_supplement_spec.rb +47 -0
  181. data/spec/integration/gemspec_deleted_files_spec.rb +43 -0
  182. data/spec/integration/spec_curriculum_isolation_spec.rb +41 -0
  183. data/spec/integration/verify_acceptance_eui_regression_spec.rb +162 -0
  184. data/spec/integration/web_cache_lifecycle_closure_spec.rb +89 -0
  185. data/spec/integration/web_cache_lifecycle_supplement_spec.rb +70 -0
  186. data/spec/lib/pwn/ai/agent/analysis_errors_regression_spec.rb +33 -0
  187. data/spec/lib/pwn/ai/agent/curriculum_cooldown_regression_spec.rb +19 -0
  188. data/spec/lib/pwn/ai/agent/curriculum_spec.rb +2 -0
  189. data/spec/lib/pwn/ai/agent/engagement_boundary_regression_spec.rb +42 -0
  190. data/spec/lib/pwn/ai/agent/engagement_dispatch_review_spec.rb +82 -0
  191. data/spec/lib/pwn/ai/agent/engagement_roe_regression_spec.rb +25 -0
  192. data/spec/lib/pwn/ai/agent/engagement_scope_regression_spec.rb +37 -0
  193. data/spec/lib/pwn/ai/agent/extrospection/osint/bridges_spec.rb +4 -0
  194. data/spec/lib/pwn/ai/agent/extrospection_input_regression_spec.rb +31 -0
  195. data/spec/lib/pwn/ai/agent/extrospection_review_spec.rb +61 -0
  196. data/spec/lib/pwn/ai/agent/extrospection_serial_review_spec.rb +42 -0
  197. data/spec/lib/pwn/ai/agent/extrospection_spec.rb +9 -0
  198. data/spec/lib/pwn/ai/agent/extrospection_verification_regression_spec.rb +39 -0
  199. data/spec/lib/pwn/ai/agent/learning_last_answer_regression_spec.rb +32 -0
  200. data/spec/lib/pwn/ai/agent/learning_lifecycle_closure_spec.rb +84 -0
  201. data/spec/lib/pwn/ai/agent/learning_prune_regression_spec.rb +17 -0
  202. data/spec/lib/pwn/ai/agent/learning_spec.rb +2 -1
  203. data/spec/lib/pwn/ai/agent/loop_execution_audit_spec.rb +30 -0
  204. data/spec/lib/pwn/ai/agent/metrics_usage_regression_spec.rb +20 -0
  205. data/spec/lib/pwn/ai/agent/mission_execution_audit_spec.rb +27 -0
  206. data/spec/lib/pwn/ai/agent/mission_namespace_spec.rb +210 -18
  207. data/spec/lib/pwn/ai/agent/policy_confidence_regression_spec.rb +16 -0
  208. data/spec/lib/pwn/ai/agent/policy_evaluation_spec.rb +1 -1
  209. data/spec/lib/pwn/ai/agent/policy_evaluation_tmp_regression_spec.rb +36 -0
  210. data/spec/lib/pwn/ai/agent/reflect_model_regression_spec.rb +15 -0
  211. data/spec/lib/pwn/ai/agent/request_runtime_execution_audit_spec.rb +43 -0
  212. data/spec/lib/pwn/ai/agent/reward_binding_review_spec.rb +129 -0
  213. data/spec/lib/pwn/ai/agent/reward_dispatch_review_spec.rb +154 -0
  214. data/spec/lib/pwn/ai/agent/reward_envelope_regression_spec.rb +45 -0
  215. data/spec/lib/pwn/ai/agent/reward_turn_regression_spec.rb +40 -0
  216. data/spec/lib/pwn/ai/agent/swarm_spec.rb +2 -2
  217. data/spec/lib/pwn/ai/agent/task_dag_execution_audit_spec.rb +45 -0
  218. data/spec/lib/pwn/ai/agent/task_summarizer_failure_regression_spec.rb +26 -0
  219. data/spec/lib/pwn/ai/agent/tools/verify_execution_audit_spec.rb +33 -0
  220. data/spec/lib/pwn/ai/context_range_audit_spec.rb +24 -0
  221. data/spec/lib/pwn/ai/gemini_roundtrip_audit_spec.rb +33 -0
  222. data/spec/lib/pwn/ai/grok_reasoning_effort_spec.rb +43 -0
  223. data/spec/lib/pwn/ai/mcp_session_audit_spec.rb +36 -0
  224. data/spec/lib/pwn/ai/ollama_spec.rb +6 -11
  225. data/spec/lib/pwn/ai/open_web_ui_spec.rb +6 -11
  226. data/spec/lib/pwn/ai/provider_history_audit_spec.rb +44 -0
  227. data/spec/lib/pwn/ai/provider_operations_audit_spec.rb +53 -0
  228. data/spec/lib/pwn/ai/provider_review_history_stream_regression_spec.rb +143 -0
  229. data/spec/lib/pwn/ai/provider_review_tls_regression_spec.rb +62 -0
  230. data/spec/lib/pwn/ai/provider_stream_audit_spec.rb +49 -0
  231. data/spec/lib/pwn/aws/iam_decoding_regression_spec.rb +23 -0
  232. data/spec/lib/pwn/aws/services_runtime_regression_spec.rb +51 -0
  233. data/spec/lib/pwn/aws_spec.rb +6 -0
  234. data/spec/lib/pwn/banner_operational_audit_spec.rb +105 -0
  235. data/spec/lib/pwn/bounty/lifecycle_authz_replay_spec.rb +17 -0
  236. data/spec/lib/pwn/config_redaction_regression_spec.rb +24 -0
  237. data/spec/lib/pwn/config_skills_regression_spec.rb +38 -0
  238. data/spec/lib/pwn/corpus_core_review_regression_spec.rb +96 -0
  239. data/spec/lib/pwn/corpus_spec.rb +13 -0
  240. data/spec/lib/pwn/cron_core_review_regression_spec.rb +95 -0
  241. data/spec/lib/pwn/cron_execution_spec.rb +75 -0
  242. data/spec/lib/pwn/driver_core_review_regression_spec.rb +38 -0
  243. data/spec/lib/pwn/driver_spec.rb +13 -0
  244. data/spec/lib/pwn/engagement_core_review_regression_spec.rb +88 -0
  245. data/spec/lib/pwn/engagement_storage_regression_spec.rb +44 -0
  246. data/spec/lib/pwn/ffi/capstone_spec.rb +19 -0
  247. data/spec/lib/pwn/ffi/fftw_spec.rb +19 -0
  248. data/spec/lib/pwn/ffi/keystone_spec.rb +13 -0
  249. data/spec/lib/pwn/ffi/soapy_sdr_spec.rb +13 -0
  250. data/spec/lib/pwn/json_text_spec.rb +25 -0
  251. data/spec/lib/pwn/memory_index_spec.rb +23 -0
  252. data/spec/lib/pwn/module_skills_parsing_regression_spec.rb +34 -0
  253. data/spec/lib/pwn/plugins/ai_sandbox_boundary_review_spec.rb +57 -0
  254. data/spec/lib/pwn/plugins/ai_sandbox_spec.rb +10 -18
  255. data/spec/lib/pwn/plugins/android_review_fixes_spec.rb +121 -0
  256. data/spec/lib/pwn/plugins/android_transport_audit_spec.rb +64 -0
  257. data/spec/lib/pwn/plugins/api_import_namespace_audit_spec.rb +49 -0
  258. data/spec/lib/pwn/plugins/artifact_registry_namespace_audit_spec.rb +20 -0
  259. data/spec/lib/pwn/plugins/artifact_registry_review_fixes_spec.rb +63 -0
  260. data/spec/lib/pwn/plugins/assembly_namespace_audit_spec.rb +16 -0
  261. data/spec/lib/pwn/plugins/assembly_review_fixes_spec.rb +33 -0
  262. data/spec/lib/pwn/plugins/authentication_helper_spec.rb +14 -0
  263. data/spec/lib/pwn/plugins/baresip_review_fixes_spec.rb +127 -0
  264. data/spec/lib/pwn/plugins/baresip_transport_audit_spec.rb +59 -0
  265. data/spec/lib/pwn/plugins/binary_analysis_process_review_spec.rb +57 -0
  266. data/spec/lib/pwn/plugins/black_duck_namespace_audit_spec.rb +25 -0
  267. data/spec/lib/pwn/plugins/burp_suite_har_review_fixes_spec.rb +60 -0
  268. data/spec/lib/pwn/plugins/burp_suite_import_review_fixes_spec.rb +62 -0
  269. data/spec/lib/pwn/plugins/burp_suite_namespace_audit_spec.rb +37 -0
  270. data/spec/lib/pwn/plugins/bus_pirate_transport_audit_spec.rb +19 -0
  271. data/spec/lib/pwn/plugins/file_fu_namespace_audit_spec.rb +17 -0
  272. data/spec/lib/pwn/plugins/findings_structured_spec.rb +1 -1
  273. data/spec/lib/pwn/plugins/gdbmi_namespace_audit_spec.rb +28 -0
  274. data/spec/lib/pwn/plugins/gdbmi_review_fixes_spec.rb +73 -0
  275. data/spec/lib/pwn/plugins/github_argv_review_spec.rb +49 -0
  276. data/spec/lib/pwn/plugins/google_workspace_provider_review_oauth_spec.rb +80 -0
  277. data/spec/lib/pwn/plugins/irc_review_fixes_spec.rb +92 -0
  278. data/spec/lib/pwn/plugins/irc_transport_audit_spec.rb +37 -0
  279. data/spec/lib/pwn/plugins/jenkins_namespace_audit_spec.rb +12 -0
  280. data/spec/lib/pwn/plugins/jira_data_center_namespace_audit_spec.rb +44 -0
  281. data/spec/lib/pwn/plugins/jira_data_center_review_fixes_spec.rb +81 -0
  282. data/spec/lib/pwn/plugins/jsonl_elf_review_fixes_spec.rb +59 -0
  283. data/spec/lib/pwn/plugins/log_spec.rb +36 -20
  284. data/spec/lib/pwn/plugins/monkey_patch_spec.rb +16 -0
  285. data/spec/lib/pwn/plugins/msr206_readback_review_fixes_spec.rb +119 -0
  286. data/spec/lib/pwn/plugins/msr206_review_fixes_spec.rb +50 -0
  287. data/spec/lib/pwn/plugins/msr206_transport_audit_spec.rb +64 -0
  288. data/spec/lib/pwn/plugins/nessus_cloud_namespace_audit_spec.rb +14 -0
  289. data/spec/lib/pwn/plugins/nexpose_review_fixes_spec.rb +55 -0
  290. data/spec/lib/pwn/plugins/open_api_namespace_audit_spec.rb +22 -0
  291. data/spec/lib/pwn/plugins/packet_transport_audit_spec.rb +47 -0
  292. data/spec/lib/pwn/plugins/plugins_b_operational_regression_spec.rb +600 -0
  293. data/spec/lib/pwn/plugins/pony_namespace_audit_spec.rb +17 -0
  294. data/spec/lib/pwn/plugins/pony_review_fixes_spec.rb +33 -0
  295. data/spec/lib/pwn/plugins/process_tube_namespace_audit_spec.rb +19 -0
  296. data/spec/lib/pwn/plugins/ps_namespace_audit_spec.rb +12 -0
  297. data/spec/lib/pwn/plugins/repl/ai_console_spec.rb +111 -0
  298. data/spec/lib/pwn/plugins/repl/ai_spec.rb +38 -0
  299. data/spec/lib/pwn/plugins/repl/mesh_spec.rb +52 -0
  300. data/spec/lib/pwn/plugins/sandbox_spec.rb +9 -7
  301. data/spec/lib/pwn/plugins/sbom_review_fixes_spec.rb +43 -0
  302. data/spec/lib/pwn/plugins/scannable_codes_namespace_audit_spec.rb +15 -0
  303. data/spec/lib/pwn/plugins/serial_review_fixes_spec.rb +76 -0
  304. data/spec/lib/pwn/plugins/serial_transport_audit_spec.rb +102 -0
  305. data/spec/lib/pwn/plugins/shodan_namespace_audit_spec.rb +10 -0
  306. data/spec/lib/pwn/plugins/sock_transport_audit_spec.rb +55 -0
  307. data/spec/lib/pwn/plugins/transparent_browser_navigation_review_spec.rb +21 -0
  308. data/spec/lib/pwn/plugins/vault_master_key_eui_regression_spec.rb +242 -0
  309. data/spec/lib/pwn/plugins/vault_spec.rb +58 -0
  310. data/spec/lib/pwn/plugins/vault_store_safety_spec.rb +1 -1
  311. data/spec/lib/pwn/plugins/xxd_namespace_audit_spec.rb +34 -0
  312. data/spec/lib/pwn/plugins/yubikey_hid_cleanup_review_fixes_spec.rb +52 -0
  313. data/spec/lib/pwn/plugins/yubikey_lifecycle_audit_spec.rb +65 -0
  314. data/spec/lib/pwn/plugins/yubikey_options_audit_spec.rb +30 -0
  315. data/spec/lib/pwn/plugins/yubikey_selector_audit_spec.rb +26 -0
  316. data/spec/lib/pwn/plugins/yubikey_spec.rb +1 -1
  317. data/spec/lib/pwn/plugins/zaproxy_namespace_audit_spec.rb +30 -0
  318. data/spec/lib/pwn/reports/empty_report_audit_spec.rb +18 -0
  319. data/spec/lib/pwn/reports/pdf_spec.rb +25 -0
  320. data/spec/lib/pwn/reports/provider_review_encoding_regression_spec.rb +45 -0
  321. data/spec/lib/pwn/sast/engine_runtime_regression_spec.rb +91 -0
  322. data/spec/lib/pwn/sast/filter_edge_regression_spec.rb +39 -0
  323. data/spec/lib/pwn/sast/formatter_review_fixes_spec.rb +178 -0
  324. data/spec/lib/pwn/sast/path_review_fixes_spec.rb +60 -0
  325. data/spec/lib/pwn/sast/pom_runtime_regression_spec.rb +37 -0
  326. data/spec/lib/pwn/sast/rules_runtime_regression_spec.rb +78 -0
  327. data/spec/lib/pwn/sast/sql_review_fixes_spec.rb +38 -0
  328. data/spec/lib/pwn/sdr/decoder/base_iq_spec.rb +21 -18
  329. data/spec/lib/pwn/sdr/decoder/base_review_fixes_spec.rb +49 -0
  330. data/spec/lib/pwn/sdr/decoder/base_validation_spec.rb +78 -0
  331. data/spec/lib/pwn/sdr/decoder/lora_spec.rb +9 -0
  332. data/spec/lib/pwn/sdr/flipper_zero_review_fixes_spec.rb +34 -0
  333. data/spec/lib/pwn/sdr/gqrx_operational_spec.rb +83 -0
  334. data/spec/lib/pwn/sdr/gqrx_review_fixes_spec.rb +22 -0
  335. data/spec/lib/pwn/sdr/son_micro_rfid_review_fixes_spec.rb +113 -0
  336. data/spec/lib/pwn/sdr/son_micro_rfid_serial_review_fixes_spec.rb +76 -0
  337. data/spec/lib/pwn/sdr/son_micro_rfid_spec.rb +39 -0
  338. data/spec/lib/pwn/sdr_spec.rb +5 -0
  339. data/spec/lib/pwn/session_cleanup_default_spec.rb +1 -1
  340. data/spec/lib/pwn/session_cleanup_lifecycle_supplement_spec.rb +39 -0
  341. data/spec/lib/pwn/session_cleanup_payload_spec.rb +3 -2
  342. data/spec/lib/pwn/session_trace_lifecycle_supplement_spec.rb +39 -0
  343. data/spec/lib/pwn/sessions_archive_closure_spec.rb +126 -0
  344. data/spec/lib/pwn/sessions_lifecycle_closure_spec.rb +373 -0
  345. data/spec/lib/pwn/sessions_lifecycle_supplement_spec.rb +204 -0
  346. data/spec/lib/pwn/setup_operational_regression_spec.rb +36 -0
  347. data/spec/lib/pwn/www/browser_review_fixes_spec.rb +70 -0
  348. data/spec/lib/pwn/www/browser_runtime_regression_spec.rb +100 -0
  349. data/spec/lib/pwn/www/hacker_one_runtime_regression_spec.rb +146 -0
  350. data/spec/lib/pwn/www/pagination_review_fixes_spec.rb +84 -0
  351. data/spec/support/namespace_controller_observability_fixture.rb +141 -0
  352. data/spec/support/sandbox.rb +8 -5
  353. data/third_party/pwn_rdoc.jsonl +73 -31
  354. metadata +137 -18
  355. data/etc/default_skills/pwn/aws/elastic_transcoder/SKILL.md +0 -48
  356. data/etc/default_skills/pwn/aws/lambda_preview/SKILL.md +0 -48
  357. data/etc/default_skills/pwn/aws/ops_works/SKILL.md +0 -48
  358. data/etc/default_skills/pwn/aws/ops_works_cm/SKILL.md +0 -48
  359. data/etc/default_skills/pwn/aws/sms/SKILL.md +0 -48
  360. data/lib/pwn/aws/elastic_transcoder.rb +0 -95
  361. data/lib/pwn/aws/lambda_preview.rb +0 -95
  362. data/lib/pwn/aws/ops_works.rb +0 -95
  363. data/lib/pwn/aws/ops_works_cm.rb +0 -95
  364. data/lib/pwn/aws/sms.rb +0 -95
  365. data/spec/lib/pwn/aws/elastic_transcoder_spec.rb +0 -15
  366. data/spec/lib/pwn/aws/lambda_preview_spec.rb +0 -15
  367. data/spec/lib/pwn/aws/ops_works_cm_spec.rb +0 -15
  368. data/spec/lib/pwn/aws/ops_works_spec.rb +0 -15
  369. data/spec/lib/pwn/aws/sms_spec.rb +0 -15
data/lib/pwn/aws/iam.rb CHANGED
@@ -52,7 +52,7 @@ module PWN
52
52
  # key_type: 'optional - key type :access_key_id|:secret_access_key|:sts_session_token (Default: access_key_id)',
53
53
  # )
54
54
  public_class_method def self.decode_key(opts = {})
55
- key = opts[:key].to_s.scrub.chomp.strip.upcase
55
+ key = opts[:key].to_s.scrub.chomp.strip
56
56
  raise 'ERROR: Key is required' if key == ''
57
57
 
58
58
  key_type = opts[:key_type] || :access_key_id
@@ -107,7 +107,7 @@ module PWN
107
107
 
108
108
  case key_type
109
109
  when :access_key_id
110
- suffix = key[4..-1]
110
+ suffix = key[4..-1].upcase
111
111
  decoded_suffix = Base32.decode(suffix)
112
112
  trimmed_decoded_suffix = decoded_suffix[0..5]
113
113
  z = trimmed_decoded_suffix.bytes.inject { |total, byte| (total << 8) + byte }
@@ -24,13 +24,13 @@ module PWN
24
24
 
25
25
  @@logger.info('Connecting to AWS Workspaces...')
26
26
  if sts_session_token == ''
27
- workspaces_obj = Aws::Workspaces::Client.new(
27
+ workspaces_obj = Aws::WorkSpaces::Client.new(
28
28
  region: region,
29
29
  access_key_id: access_key_id,
30
30
  secret_access_key: secret_access_key
31
31
  )
32
32
  else
33
- workspaces_obj = Aws::Workspaces::Client.new(
33
+ workspaces_obj = Aws::WorkSpaces::Client.new(
34
34
  region: region,
35
35
  access_key_id: access_key_id,
36
36
  secret_access_key: secret_access_key,
data/lib/pwn/aws.rb CHANGED
@@ -46,7 +46,6 @@ module PWN
46
46
  autoload :ElasticBeanstalk, 'pwn/aws/elastic_beanstalk'
47
47
  autoload :ElasticLoadBalancing, 'pwn/aws/elastic_load_balancing'
48
48
  autoload :ElasticLoadBalancingV2, 'pwn/aws/elastic_load_balancing_v2'
49
- autoload :ElasticTranscoder, 'pwn/aws/elastic_transcoder'
50
49
  autoload :ElasticsearchService, 'pwn/aws/elasticsearch_service'
51
50
  autoload :Firehose, 'pwn/aws/firehose'
52
51
  autoload :GameLift, 'pwn/aws/game_lift'
@@ -61,14 +60,11 @@ module PWN
61
60
  autoload :Kinesis, 'pwn/aws/kinesis'
62
61
  autoload :KinesisAnalytics, 'pwn/aws/kinesis_analytics'
63
62
  autoload :Lambda, 'pwn/aws/lambda'
64
- autoload :LambdaPreview, 'pwn/aws/lambda_preview'
65
63
  autoload :Lex, 'pwn/aws/lex'
66
64
  autoload :Lightsail, 'pwn/aws/lightsail'
67
65
  autoload :MachineLearning, 'pwn/aws/machine_learning'
68
66
  autoload :MarketplaceCommerceAnalytics, 'pwn/aws/marketplace_commerce_analytics'
69
67
  autoload :MarketplaceMetering, 'pwn/aws/marketplace_metering'
70
- autoload :OpsWorks, 'pwn/aws/ops_works'
71
- autoload :OpsWorksCM, 'pwn/aws/ops_works_cm'
72
68
  autoload :Pinpoint, 'pwn/aws/pinpoint'
73
69
  autoload :Polly, 'pwn/aws/polly'
74
70
  autoload :RDS, 'pwn/aws/rds'
@@ -78,7 +74,6 @@ module PWN
78
74
  autoload :Route53Domains, 'pwn/aws/route53_domains'
79
75
  autoload :S3, 'pwn/aws/s3'
80
76
  autoload :SES, 'pwn/aws/ses'
81
- autoload :SMS, 'pwn/aws/sms'
82
77
  autoload :SNS, 'pwn/aws/sns'
83
78
  autoload :SQS, 'pwn/aws/sqs'
84
79
  autoload :SSM, 'pwn/aws/ssm'
@@ -516,7 +516,7 @@ module PWN
516
516
  path = opts[:path]
517
517
  obj = opts[:obj]
518
518
  FileUtils.mkdir_p(File.dirname(path))
519
- yaml_obj = YAML.dump(obj).gsub(/^\s*:(\w+):/, '\\1:')
519
+ yaml_obj = YAML.dump(obj, stringify_names: true)
520
520
  File.write(path, yaml_obj)
521
521
  rescue StandardError => e
522
522
  raise e
data/lib/pwn/config.rb CHANGED
@@ -438,8 +438,14 @@ module PWN
438
438
  # config: 'optional - Hash to redact sensitive artifacts from. Defaults to PWN::Env'
439
439
  # )
440
440
  public_class_method def self.redact_sensitive_artifacts(opts = {})
441
- config = opts[:config] ||= PWN::Env
442
- return config.map { |value| value.is_a?(Hash) || value.is_a?(Array) ? redact_sensitive_artifacts(config: value) : value } if config.is_a?(Array)
441
+ redact_config(config: opts[:config] || PWN::Env, depth: 0)
442
+ end
443
+
444
+ private_class_method def self.redact_config(opts = {})
445
+ config = opts[:config]
446
+ depth = opts[:depth]
447
+ raise JSON::NestingError, 'redaction exceeds configuration nesting limit (100)' if depth >= 100
448
+ return config.map { |value| value.is_a?(Hash) || value.is_a?(Array) ? redact_config(config: value, depth: depth + 1) : value } if config.is_a?(Array)
443
449
 
444
450
  sensitive_keys = %i[
445
451
  admin_key
@@ -486,7 +492,7 @@ module PWN
486
492
  if sensitive_keys.include?(config.keys[k].to_s.downcase.tr('-', '_').to_sym)
487
493
  '>>> REDACTED >>> USE `pwn-vault` FOR ADMINISTRATION <<< REDACTED <<<'
488
494
  else
489
- v.is_a?(Hash) || v.is_a?(Array) ? redact_sensitive_artifacts(config: v) : v
495
+ v.is_a?(Hash) || v.is_a?(Array) ? redact_config(config: v, depth: depth + 1) : v
490
496
  end
491
497
  end
492
498
  rescue StandardError => e
@@ -791,16 +797,17 @@ module PWN
791
797
  # Missing / malformed frontmatter returns { frontmatter: {}, body: content }.
792
798
  public_class_method def self.parse_skill_frontmatter(opts = {})
793
799
  content = opts[:content].to_s
794
- return { frontmatter: {}, body: content } unless content.start_with?("---\n")
800
+ opening = content.match(/\A---[ \t]*\r?\n/)
801
+ return { frontmatter: {}, body: content } unless opening
795
802
 
796
- fm_end = content.index(/^---\s*$/, 4)
797
- return { frontmatter: {}, body: content } unless fm_end
803
+ closing = content.match(/^---[ \t]*(?:\r?\n|\z)/, opening.end(0))
804
+ return { frontmatter: {}, body: content } unless closing
798
805
 
799
806
  require 'yaml'
800
- raw = content[4...fm_end]
807
+ raw = content[opening.end(0)...closing.begin(0)]
801
808
  fm = YAML.safe_load(raw, permitted_classes: [Symbol, Date, Time], aliases: true) || {}
802
809
  fm = {} unless fm.is_a?(Hash)
803
- body = content[fm_end..].to_s.sub(/\A---\s*\n?/, '')
810
+ body = content[closing.end(0)..].to_s
804
811
  { frontmatter: fm, body: body }
805
812
  rescue StandardError
806
813
  { frontmatter: {}, body: content }
@@ -1055,7 +1062,7 @@ module PWN
1055
1062
  }
1056
1063
  scripts.each do |rb|
1057
1064
  require rb
1058
- rescue StandardError => e
1065
+ rescue LoadError, SyntaxError, StandardError => e
1059
1066
  meta[:loaded] = false
1060
1067
  meta[:error] = e.message
1061
1068
  end
@@ -1114,7 +1121,7 @@ module PWN
1114
1121
  begin
1115
1122
  require skill_file
1116
1123
  skills[key] = base.merge(type: :ruby, loaded: true)
1117
- rescue StandardError => e
1124
+ rescue LoadError, SyntaxError, StandardError => e
1118
1125
  skills[key] = base.merge(type: :ruby, loaded: false, error: e.message)
1119
1126
  end
1120
1127
  else
data/lib/pwn/corpus.rb CHANGED
@@ -5,6 +5,7 @@ require 'digest'
5
5
  require 'json'
6
6
  require 'net/http'
7
7
  require 'uri'
8
+ require 'tmpdir'
8
9
 
9
10
  module PWN
10
11
  # Named wordlist and payload corpora under ~/.pwn/corpora.
@@ -43,6 +44,10 @@ module PWN
43
44
  path
44
45
  end
45
46
 
47
+ # Roll back caught publication errors while restore I/O remains possible.
48
+ # This is not a two-file atomic commit: concurrent readers/writers and
49
+ # process termination or power loss can observe an intermediate pair.
50
+ # If rollback itself raises, retain the private recovery directory.
46
51
  public_class_method def self.update(opts = {})
47
52
  opts = { name: opts } unless opts.is_a?(Hash)
48
53
  name = (opts[:name] || opts[:corpus]).to_s.to_sym
@@ -51,9 +56,31 @@ module PWN
51
56
  raise ArgumentError, 'builtin corpora have no remote update' if spec[:builtin]
52
57
 
53
58
  path = File.join(ROOT, "#{name}.txt")
54
- tmp = "#{path}.tmp"
55
- fetch(url: spec[:url], path: tmp, sha256: spec[:sha256])
56
- FileUtils.mv(tmp, path)
59
+ FileUtils.mkdir_p(ROOT)
60
+ directory = Dir.mktmpdir('.corpus-update-', ROOT)
61
+ cleanup = true
62
+ begin
63
+ tmp = File.join(directory, 'download.tmp')
64
+ fetch(url: spec[:url], path: tmp, sha256: spec[:sha256])
65
+ backups = [path, "#{path}.sha256"].to_h do |destination|
66
+ backup = File.join(directory, File.basename(destination))
67
+ FileUtils.cp(destination, backup) if File.file?(destination)
68
+ [destination, File.file?(backup) ? backup : nil]
69
+ end
70
+ begin
71
+ FileUtils.mv(tmp, path)
72
+ FileUtils.mv("#{tmp}.sha256", "#{path}.sha256")
73
+ rescue StandardError
74
+ cleanup = false
75
+ backups.each do |destination, backup|
76
+ backup ? File.rename(backup, destination) : FileUtils.rm_f(destination)
77
+ end
78
+ cleanup = true
79
+ raise
80
+ end
81
+ ensure
82
+ FileUtils.remove_entry(directory) if cleanup
83
+ end
57
84
  path
58
85
  end
59
86
 
@@ -71,7 +98,9 @@ module PWN
71
98
  offline: 'optional - true uses the cache only and raises on miss'
72
99
  )
73
100
 
74
- # Replace a remotely pinned corpus from its source URL.
101
+ # Replace a remote corpus; caught publication errors restore the prior pair if rollback I/O succeeds.
102
+ # Not power-loss/process-crash atomic or synchronized with concurrent readers/writers.
103
+ # Failed rollback retains recovery files under ROOT/.corpus-update-* for manual recovery.
75
104
  #{self}.update(
76
105
  name: 'required - corpus symbol with a remote URL',
77
106
  corpus: 'optional - alias for name'
@@ -99,7 +128,6 @@ module PWN
99
128
 
100
129
  FileUtils.mkdir_p(File.dirname(opts[:path]))
101
130
  File.write(opts[:path], body)
102
- File.write("#{opts[:path].sub(/\\.tmp\\z/, '')}.sha256", digest)
103
131
  File.write("#{opts[:path]}.sha256", digest)
104
132
  opts[:path]
105
133
  end
data/lib/pwn/cron.rb CHANGED
@@ -3,9 +3,11 @@
3
3
  require 'yaml'
4
4
  require 'fileutils'
5
5
  require 'time'
6
+ require 'date'
6
7
  require 'securerandom'
7
8
  require 'rbconfig'
8
9
  require 'shellwords'
10
+ require 'open3'
9
11
  require 'etc'
10
12
 
11
13
  module PWN
@@ -109,6 +111,10 @@ module PWN
109
111
  result = PWN::AI::Anthropic.chat(request: job[:prompt], spinner: false)
110
112
  when :gemini
111
113
  result = PWN::AI::Gemini.chat(request: job[:prompt], spinner: false)
114
+ when :openwebui
115
+ result = PWN::AI::OpenWebUI.chat(request: job[:prompt], spinner: false)
116
+ else
117
+ raise ArgumentError, "Unsupported cron AI engine: #{engine}"
112
118
  end
113
119
  result = begin
114
120
  result[:choices].last[:content]
@@ -117,8 +123,9 @@ module PWN
117
123
  end
118
124
  elsif job[:ruby]
119
125
  result = eval(job[:ruby], TOPLEVEL_BINDING) # rubocop:disable Security/Eval
120
- elsif job[:script] && File.exist?(job[:script])
121
- result = `#{job[:script]} 2>&1`
126
+ elsif job[:script] && !job[:script].to_s.empty? && File.exist?(script = File.absolute_path(job[:script].to_s))
127
+ result, process_status = Open3.capture2e([script, script])
128
+ status = 'error' unless process_status.success?
122
129
  else
123
130
  result = 'No prompt/ruby/script defined'
124
131
  end
@@ -432,19 +439,25 @@ module PWN
432
439
 
433
440
  fields = schedule.split
434
441
  return false unless fields.length == 5
442
+ return false unless [[0, 59], [0, 23], [1, 31], [1, 12], [0, 7]].each_with_index.all? do |(min, max), index|
443
+ cron_field_valid?(expr: fields[index], min: min, max: max)
444
+ end
435
445
 
436
446
  prev = last || (now - (24 * 60 * 60))
437
447
  # Walk minute-aligned slots from the minute AFTER last_run
438
448
  # (or the last 24h if never run) up to `now`.
439
449
  t = Time.at(((prev.to_i / 60) + 1) * 60)
440
- t = Time.local(t.year, t.month, t.day, t.hour, t.min, 0)
441
- limit = Time.local(now.year, now.month, now.day, now.hour, now.min, 0)
442
- safety = 0
443
- while t <= limit && safety < 10_080
444
- return true if cron_match?(fields: fields, time: t)
445
-
446
- t += 60
447
- safety += 1
450
+ limit = Time.at((now.to_i / 60) * 60)
451
+
452
+ while t <= limit
453
+ if cron_date_match?(fields: fields, time: t)
454
+ return true if cron_match?(fields: fields, time: t)
455
+
456
+ t += 60
457
+ else
458
+ day = t.to_date.next_day
459
+ t = Time.local(day.year, day.month, day.day)
460
+ end
448
461
  end
449
462
  false
450
463
  rescue StandardError
@@ -546,7 +559,7 @@ module PWN
546
559
  waited += 1
547
560
  end
548
561
  {
549
- started: !(live && process_alive?(pid: live)).nil?,
562
+ started: !live.nil? && process_alive?(pid: live),
550
563
  pid: live,
551
564
  spawn_pid: pid,
552
565
  interval: interval,
@@ -673,12 +686,39 @@ module PWN
673
686
  private_class_method def self.cron_match?(opts = {})
674
687
  fields = opts[:fields]
675
688
  time = opts[:time]
676
- min, hour, mday, mon, wday = fields
689
+ min, hour = fields
677
690
  cron_field?(expr: min, value: time.min, min: 0, max: 59) &&
678
691
  cron_field?(expr: hour, value: time.hour, min: 0, max: 23) &&
679
- cron_field?(expr: mday, value: time.day, min: 1, max: 31) &&
680
- cron_field?(expr: mon, value: time.month, min: 1, max: 12) &&
681
- cron_field?(expr: wday, value: time.wday, min: 0, max: 7)
692
+ cron_date_match?(fields: fields, time: time)
693
+ end
694
+
695
+ private_class_method def self.cron_date_match?(opts = {})
696
+ _min, _hour, mday, mon, wday = opts[:fields]
697
+ time = opts[:time]
698
+ return false unless cron_field?(expr: mon, value: time.month, min: 1, max: 12)
699
+
700
+ month_day = cron_field?(expr: mday, value: time.day, min: 1, max: 31)
701
+ week_day = cron_field?(expr: wday, value: time.wday, min: 0, max: 7)
702
+ mday.start_with?('*') || wday.start_with?('*') ? month_day && week_day : month_day || week_day
703
+ end
704
+
705
+ # Validate all list members before OR matching can mask an invalid member.
706
+ private_class_method def self.cron_field_valid?(opts = {})
707
+ parts = opts[:expr].to_s.split(',', -1)
708
+ return false if parts.empty?
709
+
710
+ parts.all? do |part|
711
+ match = %r{\A(?:(\*)|(\d+)(?:-(\d+))?)(?:/(\d+))?\z}.match(part)
712
+ next false unless match
713
+
714
+ wildcard, first, last, step = match.captures
715
+ next false if step && (step.to_i.zero? || (!wildcard && !last))
716
+ next true if wildcard
717
+
718
+ first = first.to_i
719
+ last = last ? last.to_i : first
720
+ first.between?(opts[:min], opts[:max]) && last.between?(first, opts[:max])
721
+ end
682
722
  end
683
723
 
684
724
  private_class_method def self.cron_field?(opts = {})
@@ -686,7 +726,10 @@ module PWN
686
726
  value = opts[:value]
687
727
  min = opts[:min]
688
728
  max = opts[:max]
689
- expr.to_s.split(',').any? { |part| cron_atom?(atom: part, value: value, min: min, max: max) }
729
+ expr.to_s.split(',').any? do |part|
730
+ cron_atom?(atom: part, value: value, min: min, max: max) ||
731
+ (min.zero? && max == 7 && value.zero? && cron_atom?(atom: part, value: 7, min: min, max: max))
732
+ end
690
733
  end
691
734
 
692
735
  private_class_method def self.cron_atom?(opts = {})
@@ -714,7 +757,7 @@ module PWN
714
757
  end
715
758
  return value.between?(Regexp.last_match(1).to_i, Regexp.last_match(2).to_i) if atom =~ /\A(\d+)-(\d+)\z/
716
759
 
717
- n = Integer(atom)
760
+ n = Integer(atom, 10)
718
761
  # cron Sunday is 0 or 7
719
762
  return true if n == value
720
763
  return true if min.zero? && max == 7 && ((n == 7 && value.zero?) || (n.zero? && value == 7))
data/lib/pwn/driver.rb CHANGED
@@ -11,11 +11,10 @@ module PWN
11
11
  :opts
12
12
 
13
13
  def initialize
14
- super
14
+ super("USAGE: #{File.basename($PROGRAM_NAME)} [opts]\n")
15
15
  @opts = PWN::Env[:driver_opts]
16
16
  @auto_opts_help = true
17
17
 
18
- banner = "USAGE: #{File.basename($PROGRAM_NAME)} [opts]\n"
19
18
  on(
20
19
  '-YPATH',
21
20
  '--pwn_env=PATH',
@@ -51,7 +50,7 @@ module PWN
51
50
  )
52
51
 
53
52
  if @auto_opts_help && @opts.keys.join(' ') == 'pwn_env_path pwn_dec_path'
54
- puts `#{File.basename($PROGRAM_NAME)} --help`
53
+ puts self
55
54
  exit 1
56
55
  end
57
56
  end
@@ -36,11 +36,11 @@ module PWN
36
36
  end
37
37
 
38
38
  public_class_method def self.record_host(opts = {})
39
- check = warn_unless_in_scope(opts)
39
+ name = scope_name(name: opts[:name], engagement: opts[:engagement])
40
+ check = warn_unless_in_scope(opts.merge(name: name, engagement: name))
40
41
  return check.merge(recorded: false) unless check[:ok]
41
42
 
42
- name = (opts[:engagement] || opts[:name] || PWN::AI::Agent::Engagement.current_name || 'default').to_s
43
- dir = File.join(PWN::AI::Agent::Engagement::ROOT, name)
43
+ dir = File.join(PWN::AI::Agent::Engagement::ROOT, name || 'default')
44
44
  FileUtils.mkdir_p(dir)
45
45
  path = File.join(dir, 'hosts.json')
46
46
  store = File.file?(path) ? JSON.parse(File.read(path), symbolize_names: true) : {}
@@ -65,7 +65,7 @@ module PWN
65
65
  end
66
66
 
67
67
  public_class_method def self.hosts(opts = {})
68
- name = (opts[:name] || PWN::AI::Agent::Engagement.current_name || 'default').to_s
68
+ name = storage_name(name: opts[:name], engagement: opts[:engagement])
69
69
  path = File.join(PWN::AI::Agent::Engagement::ROOT, name, 'hosts.json')
70
70
  return {} unless File.file?(path)
71
71
 
@@ -73,6 +73,7 @@ module PWN
73
73
  end
74
74
 
75
75
  public_class_method def self.merge_scan(opts = {})
76
+ name = scope_name(name: opts[:name], engagement: opts[:engagement])
76
77
  Array(opts[:hosts] || opts[:results]).each do |row|
77
78
  row = row.transform_keys(&:to_sym) if row.respond_to?(:transform_keys)
78
79
  record_host(
@@ -80,14 +81,14 @@ module PWN
80
81
  ports: [{ port: row[:port] || row['port'], proto: row[:proto], service: row[:service], version: row[:version], scripts: row[:scripts] }.compact],
81
82
  services: [row[:service] || row['service']].compact,
82
83
  override: opts[:override],
83
- engagement: opts[:engagement] || opts[:name]
84
+ engagement: name
84
85
  )
85
86
  end
86
- hosts(name: opts[:engagement] || opts[:name])
87
+ hosts(name: name)
87
88
  end
88
89
 
89
90
  public_class_method def self.record_scan(opts = {})
90
- name = (opts[:engagement] || opts[:name] || PWN::AI::Agent::Engagement.current_name || 'default').to_s
91
+ name = storage_name(name: opts[:name], engagement: opts[:engagement])
91
92
  dir = File.join(PWN::AI::Agent::Engagement::ROOT, name, 'scans')
92
93
  FileUtils.mkdir_p(dir)
93
94
  at = opts[:at] || Time.now.utc
@@ -105,12 +106,26 @@ module PWN
105
106
  end
106
107
 
107
108
  public_class_method def self.scans(opts = {})
108
- name = (opts[:name] || opts[:engagement] || PWN::AI::Agent::Engagement.current_name || 'default').to_s
109
- Dir[File.join(PWN::AI::Agent::Engagement::ROOT, name, 'scans', 'nmap-*.json')].map do |path|
109
+ name = storage_name(name: opts[:name], engagement: opts[:engagement])
110
+ dir = File.join(PWN::AI::Agent::Engagement::ROOT, name, 'scans')
111
+ Dir.glob('nmap-*.json', base: dir).map do |basename|
112
+ path = File.join(dir, basename)
110
113
  JSON.parse(File.read(path), symbolize_names: true).merge(path: path)
111
114
  end
112
115
  end
113
116
 
117
+ private_class_method def self.storage_name(opts = {})
118
+ scope_name(name: opts[:name], engagement: opts[:engagement]) || 'default'
119
+ end
120
+
121
+ # No active scope is permissive; the default storage directory is not a scope.
122
+ private_class_method def self.scope_name(opts = {})
123
+ raise ArgumentError, 'Conflicting engagement name and engagement aliases' if opts[:name] && opts[:engagement] && opts[:name].to_s != opts[:engagement].to_s
124
+
125
+ name = opts[:engagement] || opts[:name] || PWN::AI::Agent::Engagement.current_name
126
+ PWN::AI::Agent::Engagement.validate_name(name: name) unless name.nil?
127
+ end
128
+
114
129
  public_class_method def self.authors
115
130
  "AUTHOR(S):\n 0day Inc. <support@0dayinc.com>\n"
116
131
  end
@@ -156,6 +171,8 @@ module PWN
156
171
  # Deep-merge ports, services, notes, and vault refs for a host.
157
172
  #{self}.record_host(
158
173
  host: 'required - hostname or IP',
174
+ engagement: 'optional - destination engagement name; defaults to the active engagement',
175
+ name: 'optional - alias for engagement',
159
176
  ip: 'optional - alias for host',
160
177
  ports: 'optional - Array of open ports',
161
178
  services: 'optional - Array of service labels',
@@ -166,7 +183,8 @@ module PWN
166
183
 
167
184
  # Return the host map for an engagement.
168
185
  #{self}.hosts(
169
- name: 'optional - engagement identifier'
186
+ name: 'optional - engagement identifier',
187
+ engagement: 'optional - alias for name'
170
188
  )
171
189
 
172
190
  # Merge structured scan rows into host state.
@@ -85,9 +85,10 @@ module PWN
85
85
  insn = klass.new(base + (i * klass.size))
86
86
  insns << { address: insn[:address], mnemonic: insn[:mnemonic].to_s, op_str: insn[:op_str].to_s, size: insn[:size] }
87
87
  end
88
- cs_free(base, count) unless base.null?
89
- cs_close(handle)
90
88
  { engine: 'capstone', insns: insns, count: count }
89
+ ensure
90
+ cs_free(base, count) if base && !base.null?
91
+ cs_close(handle) if handle && !handle.read_ulong.zero?
91
92
  end
92
93
 
93
94
  private_class_method def self.insn_class
data/lib/pwn/ffi/fftw.rb CHANGED
@@ -98,10 +98,11 @@ module PWN
98
98
  flat = out_ptr.read_array_of_float(out_bins * 2)
99
99
  result = Array.new(out_bins) { |i| [flat[2 * i], flat[(2 * i) + 1]] }
100
100
 
101
- fftwf_destroy_plan(plan)
102
- fftwf_free(in_ptr)
103
- fftwf_free(out_ptr)
104
101
  result
102
+ ensure
103
+ fftwf_destroy_plan(plan) if plan && !plan.null?
104
+ fftwf_free(in_ptr) if in_ptr && !in_ptr.null?
105
+ fftwf_free(out_ptr) if out_ptr && !out_ptr.null?
105
106
  end
106
107
 
107
108
  # Supported Method Parameters::
@@ -162,10 +163,11 @@ module PWN
162
163
  flat = out_ptr.read_array_of_float(n * 2)
163
164
  result = Array.new(n) { |i| [flat[2 * i], flat[(2 * i) + 1]] }
164
165
 
165
- fftwf_destroy_plan(plan)
166
- fftwf_free(in_ptr)
167
- fftwf_free(out_ptr)
168
166
  result
167
+ ensure
168
+ fftwf_destroy_plan(plan) if plan && !plan.null?
169
+ fftwf_free(in_ptr) if in_ptr && !in_ptr.null?
170
+ fftwf_free(out_ptr) if out_ptr && !out_ptr.null?
169
171
  end
170
172
 
171
173
  # Author(s):: 0day Inc. <support@0dayinc.com>
@@ -59,9 +59,10 @@ module PWN
59
59
 
60
60
  n = size.read_ulong
61
61
  bytes = enc.read_pointer.read_string(n)
62
- ks_free(enc.read_pointer)
63
- ks_close(ks)
64
62
  { engine: 'keystone', bytes: bytes, hex: bytes.unpack1('H*'), count: count.read_ulong }
63
+ ensure
64
+ ks_free(enc.read_pointer) if enc && !enc.read_pointer.null?
65
+ ks_close(ks) if ks && !ks.null?
65
66
  end
66
67
 
67
68
  private_class_method def self.arch_mode(opts = {})
@@ -208,15 +208,19 @@ module PWN
208
208
  ch = h[:channel]
209
209
  rate = (opts[:rate_hz] || 2_048_000).to_f
210
210
  freq = opts[:freq_hz].to_f
211
- SoapySDRDevice_setSampleRate(dev, SOAPY_SDR_RX, ch, rate)
212
- SoapySDRDevice_setFrequency(dev, SOAPY_SDR_RX, ch, freq, nil)
211
+ check = lambda do |operation, *args|
212
+ rc = public_send(operation, dev, SOAPY_SDR_RX, ch, *args)
213
+ raise "ERROR: #{operation} rc=#{rc}" unless rc.zero?
214
+ end
215
+ check.call(:SoapySDRDevice_setSampleRate, rate)
216
+ check.call(:SoapySDRDevice_setFrequency, freq, nil)
213
217
  if opts[:gain_db]
214
- SoapySDRDevice_setGainMode(dev, SOAPY_SDR_RX, ch, false)
215
- SoapySDRDevice_setGain(dev, SOAPY_SDR_RX, ch, opts[:gain_db].to_f)
218
+ check.call(:SoapySDRDevice_setGainMode, false)
219
+ check.call(:SoapySDRDevice_setGain, opts[:gain_db].to_f)
216
220
  else
217
- SoapySDRDevice_setGainMode(dev, SOAPY_SDR_RX, ch, true)
221
+ check.call(:SoapySDRDevice_setGainMode, true)
218
222
  end
219
- SoapySDRDevice_setBandwidth(dev, SOAPY_SDR_RX, ch, opts[:bw_hz].to_f) if opts[:bw_hz]
223
+ check.call(:SoapySDRDevice_setBandwidth, opts[:bw_hz].to_f) if opts[:bw_hz]
220
224
  h[:rate_hz] = rate.to_i
221
225
  h[:freq_hz] = freq.to_i
222
226
  true
data/lib/pwn/json_text.rb CHANGED
@@ -16,16 +16,16 @@ module PWN
16
16
  depth = opts[:depth].to_i
17
17
  case value
18
18
  when String
19
- utf = value.dup.force_encoding(Encoding::UTF_8)
19
+ utf = value.encoding == Encoding::BINARY ? value.dup.force_encoding(Encoding::UTF_8) : value.encode(Encoding::UTF_8, invalid: :replace, undef: :replace)
20
20
  utf.valid_encoding? ? utf : utf.scrub
21
21
  when Hash
22
- return value if depth >= 100
22
+ raise JSON::NestingError, 'JSON text exceeds container nesting limit (100)' if depth >= 100
23
23
 
24
24
  value.each_with_object({}) do |(key, item), out|
25
25
  out[key.is_a?(String) ? prepare(value: key, depth: depth + 1) : key] = prepare(value: item, depth: depth + 1)
26
26
  end
27
27
  when Array
28
- return value if depth >= 100
28
+ raise JSON::NestingError, 'JSON text exceeds container nesting limit (100)' if depth >= 100
29
29
 
30
30
  value.map { |item| prepare(value: item, depth: depth + 1) }
31
31
  else
@@ -68,17 +68,29 @@ class << JSON
68
68
  end
69
69
  end
70
70
 
71
- if defined?(JSON::Ext::Generator::GeneratorMethods)
72
- JSON::Ext::Generator::GeneratorMethods.constants.each do |kind|
73
- mod = JSON::Ext::Generator::GeneratorMethods.const_get(kind)
74
- next unless mod.is_a?(Module) && mod.method_defined?(:to_json)
71
+ # Newer json releases share one Ruby GeneratorMethods implementation; older
72
+ # releases install per-type C methods. Wrap the actual entry points in either.
73
+ generators = []
74
+ generators << JSON::GeneratorMethods if defined?(JSON::GeneratorMethods)
75
+ generators.concat(JSON::Ext::Generator::GeneratorMethods.constants.map { |kind| JSON::Ext::Generator::GeneratorMethods.const_get(kind) }) if defined?(JSON::Ext::Generator::GeneratorMethods)
76
+ generators.uniq.each do |mod|
77
+ next unless mod.is_a?(Module) && mod.method_defined?(:to_json)
75
78
 
76
- mod.class_eval do
77
- alias_method :to_json_without_json_text, :to_json unless method_defined?(:to_json_without_json_text)
78
- define_method(:to_json) do |*rest|
79
- prepared = PWN::JSONText.prepare(value: self)
80
- mod.instance_method(:to_json_without_json_text).bind_call(prepared, *rest)
81
- end
79
+ mod.class_eval do
80
+ alias_method :to_json_without_json_text, :to_json unless method_defined?(:to_json_without_json_text)
81
+ define_method(:to_json) do |*rest|
82
+ prepared = PWN::JSONText.prepare(value: self)
83
+ mod.instance_method(:to_json_without_json_text).bind_call(prepared, *rest)
84
+ end
85
+ end
86
+ end
87
+
88
+ # ActiveSupport encodes through JSON::Coder#dump, which does not enter JSON.generate.
89
+ if defined?(JSON::Coder)
90
+ JSON::Coder.class_eval do
91
+ alias_method :dump_without_json_text, :dump unless method_defined?(:dump_without_json_text)
92
+ define_method(:dump) do |object, io = nil|
93
+ dump_without_json_text(PWN::JSONText.prepare(value: object), io)
82
94
  end
83
95
  end
84
96
  end
@@ -118,18 +118,20 @@ module PWN
118
118
  public_class_method def self.refresh(opts = {})
119
119
  mem = opts[:mem] || PWN::Memory.load
120
120
  idx = load_index
121
+ original_keys = idx.keys
121
122
  idx.delete_if { |k, _| !mem.key?(k) }
122
123
 
123
- todo = mem.reject { |k, v| idx.dig(k, :sha) == sha(text: v[:value].to_s) }
124
+ texts = mem.transform_values { |v| "#{v[:category]}: #{v[:value]}" }
125
+ todo = mem.reject { |k, _| idx.dig(k, :sha) == sha(text: texts[k]) }
124
126
  unless todo.empty?
125
- vecs = embed(texts: todo.values.map { |v| "#{v[:category]}: #{v[:value]}" })
127
+ vecs = embed(texts: todo.keys.map { |key| texts[key] })
126
128
  todo.keys.each_with_index do |k, i|
127
129
  next unless vecs[i]
128
130
 
129
- idx[k] = { sha: sha(text: mem[k][:value].to_s), vec: vecs[i] }
131
+ idx[k] = { sha: sha(text: texts[k]), vec: vecs[i] }
130
132
  end
131
- save_index(idx: idx)
132
133
  end
134
+ save_index(idx: idx) if !todo.empty? || idx.keys != original_keys
133
135
  idx
134
136
  rescue StandardError
135
137
  idx || {}