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
@@ -0,0 +1,96 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+
5
+ RSpec.describe 'PWN::Corpus P1 publication recovery' do
6
+ before do
7
+ @corpus_dir = Dir.mktmpdir('pwn-corpus-recovery-')
8
+ stub_const('PWN::Corpus::ROOT', @corpus_dir)
9
+ allow(Net::HTTP).to receive(:get).and_return("old fixture\n", "new fixture\n")
10
+ end
11
+
12
+ after do
13
+ FileUtils.remove_entry(@corpus_dir)
14
+ end
15
+
16
+ %i[data checksum].product(%i[before after]).each do |file, timing|
17
+ it "restores the readable pair when publication raises #{timing} replacing #{file}" do
18
+ path = PWN::Corpus.get(name: :subdomains_top1m)
19
+ old_data = File.binread(path)
20
+ old_checksum = File.binread("#{path}.sha256")
21
+ before = Dir.children(PWN::Corpus::ROOT).sort
22
+ target = file == :data ? path : "#{path}.sha256"
23
+ allow(FileUtils).to receive(:mv).and_wrap_original do |original, source, destination|
24
+ raise Errno::EACCES, 'synthetic publication failure' if destination == target && timing == :before
25
+
26
+ result = original.call(source, destination)
27
+ raise Errno::EACCES, 'synthetic publication failure' if destination == target && timing == :after
28
+
29
+ result
30
+ end
31
+ expect { PWN::Corpus.update(name: :subdomains_top1m) }.to raise_error(Errno::EACCES, /synthetic publication failure/)
32
+ expect(PWN::Corpus.get(name: :subdomains_top1m, offline: true)).to eq(path)
33
+ expect(File.binread(path)).to eq(old_data)
34
+ expect(File.binread("#{path}.sha256")).to eq(old_checksum)
35
+ expect(Dir.children(PWN::Corpus::ROOT).sort).to eq(before)
36
+ end
37
+ end
38
+
39
+ it 'removes partial new publication on an initial update failure' do
40
+ allow(FileUtils).to receive(:mv).and_wrap_original do |original, source, destination|
41
+ raise Errno::EACCES, 'synthetic checksum failure' if destination.end_with?('.sha256')
42
+
43
+ original.call(source, destination)
44
+ end
45
+ expect { PWN::Corpus.update(name: :subdomains_top1m) }.to raise_error(Errno::EACCES)
46
+ expect(Dir.children(PWN::Corpus::ROOT)).to be_empty
47
+ expect { PWN::Corpus.get(name: :subdomains_top1m, offline: true) }.to raise_error(IOError, /cache miss/)
48
+ end
49
+
50
+ it 'preserves unowned legacy temporary paths on successful publication' do
51
+ path = PWN::Corpus.get(name: :subdomains_top1m)
52
+ File.write("#{path}.tmp", 'unowned data')
53
+ File.write("#{path}.tmp.sha256", 'unowned checksum')
54
+ before = Dir.children(PWN::Corpus::ROOT).sort
55
+ expect(PWN::Corpus.update(name: :subdomains_top1m)).to eq(path)
56
+ expect(PWN::Corpus.get(name: :subdomains_top1m, offline: true)).to eq(path)
57
+ expect(File.binread(path)).to eq("new fixture\n")
58
+ expect(File.binread("#{path}.tmp")).to eq('unowned data')
59
+ expect(File.binread("#{path}.tmp.sha256")).to eq('unowned checksum')
60
+ expect(Dir.children(PWN::Corpus::ROOT).sort).to eq(before)
61
+ end
62
+
63
+ it 'retains recovery copies if rollback itself cannot restore a file' do
64
+ path = PWN::Corpus.get(name: :subdomains_top1m)
65
+ old_checksum = File.binread("#{path}.sha256")
66
+ allow(FileUtils).to receive(:mv).and_wrap_original do |original, source, destination|
67
+ raise Errno::EACCES, 'synthetic checksum failure' if destination.end_with?('.sha256')
68
+
69
+ original.call(source, destination)
70
+ end
71
+ allow(File).to receive(:rename).and_wrap_original do |original, source, destination|
72
+ raise Errno::EIO, 'synthetic rollback failure' if destination == path && File.basename(source) == File.basename(path)
73
+
74
+ original.call(source, destination)
75
+ end
76
+ expect { PWN::Corpus.update(name: :subdomains_top1m) }.to raise_error(Errno::EIO, /synthetic rollback failure/)
77
+ copies = Dir.glob(File.join(PWN::Corpus::ROOT, '.corpus-update-*', File.basename(path)))
78
+ expect(copies.length).to eq(1)
79
+ expect(File.binread(copies.first)).to eq("old fixture\n")
80
+ expect(File.binread("#{copies.first}.sha256")).to eq(old_checksum)
81
+ end
82
+
83
+ it 'cleans its staged files when preparing the checksum raises' do
84
+ path = PWN::Corpus.get(name: :subdomains_top1m)
85
+ before = Dir.children(PWN::Corpus::ROOT).sort
86
+ allow(File).to receive(:write).and_wrap_original do |original, target, body|
87
+ raise Errno::ENOSPC, 'synthetic staging failure' if target.end_with?('.tmp.sha256')
88
+
89
+ original.call(target, body)
90
+ end
91
+ expect { PWN::Corpus.update(name: :subdomains_top1m) }.to raise_error(Errno::ENOSPC)
92
+ expect(PWN::Corpus.get(name: :subdomains_top1m, offline: true)).to eq(path)
93
+ expect(File.binread(path)).to eq("old fixture\n")
94
+ expect(Dir.children(PWN::Corpus::ROOT).sort).to eq(before)
95
+ end
96
+ end
@@ -12,6 +12,19 @@ describe PWN::Corpus do
12
12
  expect(described_class).to respond_to :help
13
13
  end
14
14
 
15
+ it 'keeps a refreshed corpus readable by offline callers with its new checksum' do
16
+ Dir.mktmpdir('corpus-refresh-') do |dir|
17
+ stub_const('PWN::Corpus::ROOT', dir)
18
+ allow(Net::HTTP).to receive(:get).and_return("old fixture\n", "new fixture\n")
19
+ path = described_class.get(name: :subdomains_top1m)
20
+ expect(described_class.update(name: :subdomains_top1m)).to eq(path)
21
+ expect(described_class.get(name: :subdomains_top1m, offline: true)).to eq(path)
22
+ expect(File.read(path)).to eq("new fixture\n")
23
+ expect(File.read("#{path}.sha256")).to eq(Digest::SHA256.file(path).hexdigest)
24
+ expect(Dir.glob(File.join(dir, '*.tmp*'))).to be_empty
25
+ end
26
+ end
27
+
15
28
  it 'resolves a named builtin corpus from cache' do
16
29
  Dir.mktmpdir('corpus') do |dir|
17
30
  stub_const('PWN::Corpus::ROOT', dir)
@@ -0,0 +1,95 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+
5
+ RSpec.describe 'PWN::Cron core review regressions' do
6
+ describe 'C2 executes literal script paths' do
7
+ include_context 'pwn tmp sandbox'
8
+
9
+ before do
10
+ allow(PWN::Cron).to receive(:sync_one_job)
11
+ allow(PWN::Cron).to receive(:native_execution?).and_return(false)
12
+ end
13
+
14
+ it 'preserves the no-script result for an empty path rather than executing cwd' do
15
+ job = PWN::Cron.create(script: '', sync_native: false)
16
+ expect(Open3).not_to receive(:capture2e)
17
+ expect(PWN::Cron.run(id: job[:id])).to include(status: 'success', result: 'No prompt/ruby/script defined')
18
+ end
19
+
20
+ it 'executes the checked cwd script instead of a PATH namesake' do
21
+ bin = File.join(@tmp, 'bin')
22
+ cwd = File.join(@tmp, 'working')
23
+ FileUtils.mkdir_p([bin, cwd])
24
+ [[bin, 'path namesake'], [cwd, 'literal cwd script']].each do |dir, text|
25
+ path = File.join(dir, 'relative-fixture')
26
+ File.write(path, "#!/bin/sh\nprintf '#{text}\\n'\n")
27
+ File.chmod(0o700, path)
28
+ end
29
+ previous = ENV.fetch('PATH')
30
+ begin
31
+ ENV['PATH'] = bin
32
+ Dir.chdir(cwd) do
33
+ job = PWN::Cron.create(script: 'relative-fixture', sync_native: false)
34
+ expect(PWN::Cron.run(id: job[:id])).to include(status: 'success', result: "literal cwd script\n")
35
+ expect(PWN::Cron.list[job[:id]][:last_status]).to eq('success')
36
+ File.unlink('relative-fixture')
37
+ expect(PWN::Cron.run(id: job[:id])[:result]).to eq('No prompt/ruby/script defined')
38
+ end
39
+ ensure
40
+ ENV['PATH'] = previous
41
+ end
42
+ end
43
+ end
44
+
45
+ describe 'C1 validates every field before calendar matching' do
46
+ let(:now) { Time.local(2026, 6, 1, 5) }
47
+
48
+ it 'rejects invalid day fields even when the other restricted day matches', :aggregate_failures do
49
+ ['0 5 99 * 1', '0 5 1 * 99', '0 5 nope * 1', '0 5 1 * 1-0', '0 5 */0 * 1'].each do |schedule|
50
+ expect(PWN::Cron.due?(schedule: schedule, last_run: now - 60, now: now)).to be(false), schedule
51
+ end
52
+ end
53
+
54
+ it 'rejects invalid grammar, bounds, ranges and steps anywhere in a list', :aggregate_failures do
55
+ fields = %w[0 5 1 6 1]
56
+ bounds = [[0, 59], [0, 23], [1, 31], [1, 12], [0, 7]]
57
+ bounds.each_with_index do |(min, max), index|
58
+ bad_atoms = ['nope', '+1', '-1', '0x1', '1_0', '1/2', '*/0', '*/-2', '*/x', '*/1/2', '1-2/0', '1-2/-1', '1-2/1/2', '2-1', (max + 1).to_s, "#{min}-#{max + 1}", "#{min}-#{max + 1}/2"]
59
+ bad_atoms += ['0', '0-2', '0-2/1'] if min.positive?
60
+ bad_fields = bad_atoms.flat_map { |atom| [atom, "#{fields[index]},#{atom}", "#{atom},#{fields[index]}"] }
61
+ bad_fields += ["#{fields[index]},", ",#{fields[index]}", "#{fields[index]},,#{fields[index]}", ',']
62
+ bad_fields.each do |field|
63
+ schedule = fields.dup.tap { |parts| parts[index] = field }.join(' ')
64
+ expect(PWN::Cron.due?(schedule: schedule, last_run: now - 60, now: now)).to be(false), schedule
65
+ end
66
+ end
67
+ end
68
+
69
+ it 'retains valid wildcards, lists, steps and restricted day OR matching', :aggregate_failures do
70
+ ['* * * * *', '*/15 1-9/2 * * *', '0,15 5 1 6 2', '0 5 2 6 1', '0 5 */2 6 1', '0 5 * 6 1', '0 5 1 6 *', '0 5 1-31/2 6 2', '*/100 5 * * *'].each do |schedule|
71
+ expect(PWN::Cron.due?(schedule: schedule, last_run: now - 60, now: now)).to be(true), schedule
72
+ end
73
+ ['0 5 * 6 2', '0 5 2 6 *', '0 5 */2 6 2', '0 5 2 6 */2'].each do |schedule|
74
+ expect(PWN::Cron.due?(schedule: schedule, last_run: now - 60, now: now)).to be(false), schedule
75
+ end
76
+ end
77
+
78
+ it 'matches Sunday zero and seven in literals, lists and stepped ranges', :aggregate_failures do
79
+ sunday = Time.local(2026, 6, 7, 5)
80
+ %w[0 7 1,7 0-7 5-7 5-7/2 */7].each do |field|
81
+ expect(PWN::Cron.due?(schedule: "0 5 * * #{field}", last_run: sunday - 60, now: sunday)).to be(true), field
82
+ end
83
+ end
84
+
85
+ it 'reads zero-padded decimal fields without Ruby integer-prefix semantics' do
86
+ instant = Time.local(2026, 8, 9, 8, 9)
87
+ expect(PWN::Cron.due?(schedule: '09 08 09 08 *', last_run: instant - 60, now: instant)).to be(true)
88
+ end
89
+
90
+ it 'retains leap-day catch-up and does not invent impossible dates' do
91
+ expect(PWN::Cron.due?(schedule: '0 5 29 2 *', last_run: Time.local(2024, 2, 1), now: Time.local(2024, 3, 1))).to be(true)
92
+ expect(PWN::Cron.due?(schedule: '0 5 30 2 *', last_run: Time.local(2024, 2, 1), now: Time.local(2024, 3, 1))).to be(false)
93
+ end
94
+ end
95
+ end
@@ -0,0 +1,75 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+
5
+ RSpec.describe 'PWN::Cron execution outcomes' do
6
+ include_context 'pwn tmp sandbox'
7
+
8
+ before do
9
+ allow(PWN::Cron).to receive(:sync_one_job)
10
+ allow(PWN::Cron).to receive(:native_execution?).and_return(false)
11
+ end
12
+
13
+ it 'reports a failed script as an error rather than a successful job' do
14
+ path = File.join(@tmp, 'failed-script')
15
+ File.write(path, "#!/bin/sh\nprintf 'fixture failure\\n'\nexit 23\n")
16
+ File.chmod(0o700, path)
17
+ job = PWN::Cron.create(script: path, sync_native: false)
18
+ result = PWN::Cron.run(id: job[:id])
19
+ expect(result).to include(status: 'error', result: "fixture failure\n")
20
+ expect(PWN::Cron.list[job[:id]][:last_status]).to eq('error')
21
+ end
22
+
23
+ it 'executes a literal script path containing spaces and shell metacharacters' do
24
+ path = File.join(@tmp, 'fixture ; false')
25
+ File.write(path, "#!/bin/sh\nprintf 'literal fixture\\n'\n")
26
+ File.chmod(0o700, path)
27
+ job = PWN::Cron.create(script: path, sync_native: false)
28
+ expect(PWN::Cron.run(id: job[:id])).to include(status: 'success', result: "literal fixture\n")
29
+ end
30
+
31
+ it 'routes prompt jobs to the configured Open WebUI provider' do
32
+ PWN::Env[:ai][:active] = :openwebui
33
+ allow(PWN::AI::OpenWebUI).to receive(:chat).with(request: 'fixture prompt', spinner: false).and_return(choices: [{ content: 'fixture response' }])
34
+ job = PWN::Cron.create(prompt: 'fixture prompt', sync_native: false)
35
+ expect(PWN::Cron.run(id: job[:id])).to include(status: 'success', result: 'fixture response')
36
+ expect(PWN::AI::OpenWebUI).to have_received(:chat).once
37
+ end
38
+
39
+ it 'catches a monthly slot after more than a week of downtime' do
40
+ expect(PWN::Cron.due?(schedule: '0 5 15 * *', last_run: Time.local(2026, 5, 1), now: Time.local(2026, 5, 20))).to be(true)
41
+ expect(PWN::Cron.due?(schedule: '0 5 15 * *', last_run: Time.local(2026, 5, 15, 5), now: Time.local(2026, 5, 20))).to be(false)
42
+ end
43
+
44
+ it 'matches either day field when both cron day-of-month and weekday are restricted' do
45
+ # 2026-05-18 is a Monday, but it is not the first of the month.
46
+ now = Time.local(2026, 5, 18, 5)
47
+ expect(PWN::Cron.due?(schedule: '0 5 1 * 1', last_run: now - 60, now: now)).to be(true)
48
+ end
49
+
50
+ it 'matches Sunday represented by seven inside cron ranges' do
51
+ now = Time.local(2026, 5, 17, 5)
52
+ expect(now.wday).to eq(0)
53
+ expect(PWN::Cron.due?(schedule: '0 5 * * 5-7', last_run: now - 60, now: now)).to be(true)
54
+ expect(PWN::Cron.due?(schedule: '0 5 * * 5-7/2', last_run: now - 60, now: now)).to be(true)
55
+ end
56
+
57
+ it 'uses the same instant regardless of the supplied current-time offset' do
58
+ [Time.local(2026, 5, 18, 4, 59), Time.local(2026, 5, 18, 5)].each do |now|
59
+ shifted = now.getlocal(now.utc_offset.zero? ? '+01:00' : '+00:00')
60
+ expected = now.hour == 5
61
+ expect(PWN::Cron.due?(schedule: '0 5 18 5 *', last_run: now - 60, now: now)).to be(expected)
62
+ expect(PWN::Cron.due?(schedule: '0 5 18 5 *', last_run: now - 60, now: shifted)).to be(expected)
63
+ end
64
+ end
65
+
66
+ it 'does not report startup success when the child PID is no longer alive' do
67
+ allow(PWN::Cron).to receive(:worker_status).and_return(running: false)
68
+ allow(PWN::Cron).to receive(:read_pid).and_return(12_345)
69
+ allow(PWN::Cron).to receive(:process_alive?).with(pid: 12_345).and_return(false)
70
+ allow(PWN::Cron).to receive(:sleep)
71
+ allow(Process).to receive(:spawn).and_return(12_345)
72
+ allow(Process).to receive(:detach)
73
+ expect(PWN::Cron.start_worker(restart: false)).to include(started: false)
74
+ end
75
+ end
@@ -0,0 +1,38 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+ require 'open3'
5
+ require 'rbconfig'
6
+
7
+ RSpec.describe 'PWN::Driver D1 help banner regression' do
8
+ it 'preserves a banner installed by the OptionParser initializer block' do
9
+ parser = PWN::Driver::Parser.new { |options| options.banner = "fixture usage\nfixture purpose\n" }
10
+ expect(parser.banner).to eq("fixture usage\nfixture purpose\n")
11
+ expect(parser.to_s).to include('--pwn_env=PATH', '--pwn_dec=PATH', '--version')
12
+ end
13
+
14
+ it 'prints customized local automatic help without invoking an executable' do
15
+ parser = PWN::Driver::Parser.new { |options| options.banner = "fixture usage\n" }
16
+ parser.opts = { pwn_env_path: nil, pwn_dec_path: nil }
17
+ stub_const('ARGV', [])
18
+ allow(PWN::Config).to receive(:refresh_env)
19
+ expect(parser).not_to receive(:`)
20
+ expect do
21
+ expect { parser.parse! }.to raise_error(SystemExit) { |error| expect(error.status).to eq(1) }
22
+ end.to output(a_string_starting_with("fixture usage\n")).to_stdout
23
+ end
24
+
25
+ it 'preserves the purpose and default-action banner in real pwn_setup --help' do
26
+ Dir.mktmpdir('pwn-setup-help-') do |home|
27
+ root = File.expand_path('../../..', __dir__)
28
+ out, err, status = Open3.capture3(
29
+ { 'HOME' => home, 'PWN_CRON_DIR' => File.join(home, 'cron') },
30
+ RbConfig.ruby, '-I', File.join(root, 'lib'), File.join(root, 'bin', 'pwn_setup'), '--help'
31
+ )
32
+ expect(status.exitstatus).to eq(0), err
33
+ expect(out).to include('USAGE: pwn_setup [opts]', 'Post-install doctor & capability provisioner for the PWN gem.', 'With no options, runs a read-only capability check.', '--profile=NAME', '--pwn_env=PATH')
34
+ expect(err).to be_empty
35
+ expect(Dir.children(home)).to be_empty
36
+ end
37
+ end
38
+ end
@@ -12,4 +12,17 @@ describe PWN::Driver do
12
12
  help_response = PWN::Driver
13
13
  expect(help_response).to respond_to :help
14
14
  end
15
+
16
+ it 'uses its own parser help when no driver-specific options were supplied' do
17
+ parser = PWN::Driver::Parser.new
18
+ parser.opts = { pwn_env_path: nil, pwn_dec_path: nil }
19
+ stub_const('ARGV', [])
20
+ allow(PWN::Config).to receive(:refresh_env)
21
+ allow(parser).to receive(:`).and_return('external help must not be used')
22
+ expect(parser.banner).to eq("USAGE: #{File.basename($PROGRAM_NAME)} [opts]\n")
23
+ expect do
24
+ expect { parser.parse! }.to raise_error(SystemExit) { |error| expect(error.status).to eq(1) }
25
+ end.to output(parser.to_s).to_stdout
26
+ expect(parser).not_to have_received(:`)
27
+ end
15
28
  end
@@ -0,0 +1,88 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+
5
+ RSpec.describe 'PWN::Engagement core review regressions' do
6
+ include_context 'pwn tmp sandbox'
7
+
8
+ before do
9
+ allow(Dir).to receive(:home).and_return(@tmp)
10
+ stub_const('PWN::AI::Agent::Engagement::ROOT', File.join(@tmp, 'engagements'))
11
+ stub_const('PWN::AI::Agent::Engagement::ACTIVE_FILE', File.join(@tmp, 'engagements', 'active'))
12
+ end
13
+
14
+ describe 'E2 enumerates literal engagement scan directories' do
15
+ it 'does not use missing wildcard names to enumerate other engagements' do
16
+ PWN::Engagement.record_scan(name: 'other', hosts: [{ host: '192.0.2.2' }], at: Time.utc(2026, 1, 1))
17
+ expect(PWN::Engagement.scans(name: '*')).to be_empty
18
+ expect(PWN::Engagement.scans(name: '?ther')).to be_empty
19
+ expect(PWN::Engagement.scans(name: '{other,absent}')).to be_empty
20
+ end
21
+
22
+ it 'round trips bracket and wildcard components without changing their spelling', :aggregate_failures do
23
+ PWN::Engagement.record_scan(name: 'other', hosts: [{ host: '192.0.2.2' }], at: Time.utc(2026, 1, 1))
24
+ ['fixture[1]', '*', '?', '{other,fixture}'].each do |name|
25
+ later = PWN::Engagement.record_scan(name: name, hosts: [{ host: '192.0.2.1' }], at: Time.utc(2026, 1, 2))
26
+ earlier = PWN::Engagement.record_scan(name: name, hosts: [], at: Time.utc(2026, 1, 1))
27
+ expect(PWN::Engagement.scans(name: name)).to eq([earlier, later]), name
28
+ end
29
+ end
30
+ end
31
+
32
+ describe 'E1 separates storage fallback from scope selection' do
33
+ it 'persists the real no-active Nmap XML import in default host storage' do
34
+ xml = File.join(@tmp, 'inventory.xml')
35
+ File.write(xml, '<nmaprun><host><status state="up"/><address addr="192.0.2.1" addrtype="ipv4"/><ports><port protocol="tcp" portid="443"><state state="open"/><service name="https"/></port></ports></host></nmaprun>')
36
+ expect(PWN::AI::Agent::Engagement.current_name).to be_nil
37
+ expect(PWN::Engagement.in_scope?(host: '192.0.2.1')).to be(true)
38
+ expect(PWN::Plugins::NmapIt).not_to receive(:port_scan)
39
+ result = PWN::Plugins::NmapIt.scan(targets: ['192.0.2.1'], xml_file: xml)
40
+ expect(result[:hosts].first[:host]).to eq('192.0.2.1')
41
+ expect(PWN::Engagement.hosts[:'192.0.2.1']).to include(host: '192.0.2.1', services: ['https'])
42
+ path = File.join(PWN::AI::Agent::Engagement::ROOT, 'default', 'hosts.json')
43
+ expect(JSON.parse(File.read(path)).keys).to eq(['192.0.2.1'])
44
+ expect(PWN::Engagement.scans.length).to eq(1)
45
+ end
46
+
47
+ it 'does not silently activate a stored default scope after it is closed' do
48
+ PWN::Engagement.open(name: 'default', scope_domains: ['default.invalid'])
49
+ PWN::Engagement.close
50
+ expect(PWN::Engagement.record_host(host: '192.0.2.1')).to include(host: '192.0.2.1')
51
+ expect(PWN::Engagement.record_host(name: 'default', host: '192.0.2.2')).to include(ok: false, recorded: false)
52
+ expect(PWN::Engagement.hosts.keys).to eq([:'192.0.2.1'])
53
+ end
54
+
55
+ it 'still rejects explicitly missing and dangling-active engagements' do
56
+ %i[name engagement].each do |key|
57
+ expect(PWN::Engagement.record_host(key => 'default', :host => '192.0.2.1')).to include(ok: false, recorded: false)
58
+ end
59
+ FileUtils.mkdir_p(PWN::AI::Agent::Engagement::ROOT)
60
+ File.write(PWN::AI::Agent::Engagement::ACTIVE_FILE, 'missing')
61
+ expect(PWN::Engagement.record_host(host: '192.0.2.1')).to include(ok: false, recorded: false)
62
+ expect(File).not_to exist(File.join(PWN::AI::Agent::Engagement::ROOT, 'default'))
63
+ expect(File).not_to exist(File.join(PWN::AI::Agent::Engagement::ROOT, 'missing'))
64
+ end
65
+
66
+ it 'preserves active scope and literal override without alias bypasses' do
67
+ PWN::Engagement.open(name: 'selected', scope_domains: ['selected.invalid'])
68
+ PWN::Engagement.open(name: 'active-scope', scope_domains: ['active.invalid'])
69
+ expect(PWN::Engagement.record_host(host: 'selected.invalid')).to include(ok: false, recorded: false)
70
+ expect(PWN::Engagement.record_host(name: 'selected', engagement: 'selected', host: 'active.invalid')).to include(ok: false, recorded: false)
71
+ expect(PWN::Engagement.record_host(name: 'selected', host: 'active.invalid', override: 'true')).to include(ok: false, recorded: false)
72
+ expect(PWN::Engagement.record_host(engagement: 'selected', host: 'selected.invalid')).to include(host: 'selected.invalid')
73
+ expect(PWN::Engagement.record_host(name: 'selected', host: 'active.invalid', override: true)).to include(host: 'active.invalid')
74
+ expect(PWN::Engagement.hosts(name: 'active-scope')).to be_empty
75
+ end
76
+
77
+ it 'rejects conflicting aliases before host or scan storage operations', :aggregate_failures do
78
+ PWN::Engagement.open(name: 'selected', scope_domains: ['selected.invalid'])
79
+ PWN::Engagement.open(name: 'other', scope_domains: ['other.invalid'])
80
+ opts = { name: 'other', engagement: 'selected', host: 'selected.invalid', hosts: [{ host: 'selected.invalid', port: 443 }] }
81
+ %i[record_host merge_scan record_scan hosts scans].each do |method|
82
+ expect { PWN::Engagement.public_send(method, opts) }.to raise_error(ArgumentError, /conflicting engagement/i), method.to_s
83
+ end
84
+ expect(PWN::Engagement.hosts(name: 'selected')).to be_empty
85
+ expect(PWN::Engagement.scans(name: 'selected')).to be_empty
86
+ end
87
+ end
88
+ end
@@ -0,0 +1,44 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+
5
+ RSpec.describe 'PWN::Engagement storage boundaries' do
6
+ include_context 'pwn tmp sandbox'
7
+
8
+ before do
9
+ allow(Dir).to receive(:home).and_return(@tmp)
10
+ stub_const('PWN::AI::Agent::Engagement::ROOT', File.join(@tmp, 'engagements'))
11
+ stub_const('PWN::AI::Agent::Engagement::ACTIVE_FILE', File.join(@tmp, 'engagements', 'active'))
12
+ end
13
+
14
+ it 'rejects traversal names before reading or writing host and scan state' do
15
+ invalid = '../outside'
16
+ [
17
+ -> { PWN::Engagement.record_host(engagement: invalid, host: 'scope.invalid', override: true) },
18
+ -> { PWN::Engagement.hosts(name: invalid) },
19
+ -> { PWN::Engagement.record_scan(engagement: invalid, hosts: []) },
20
+ -> { PWN::Engagement.scans(name: invalid) }
21
+ ].each do |operation|
22
+ expect(&operation).to raise_error(ArgumentError, /Invalid engagement name/)
23
+ end
24
+ expect(File).not_to exist(File.join(@tmp, 'outside'))
25
+ end
26
+
27
+ it 'checks the explicit destination scope instead of the unrelated active engagement' do
28
+ PWN::Engagement.open(name: 'destination', scope_domains: ['destination.invalid'])
29
+ PWN::Engagement.open(name: 'current-engagement', scope_domains: ['active.invalid'])
30
+ result = PWN::Engagement.record_host(engagement: 'destination', host: 'destination.invalid', ports: [443])
31
+ expect(result).to include(host: 'destination.invalid', ports: [443])
32
+ expect(PWN::Engagement.hosts(engagement: 'destination')).to have_key(:'destination.invalid')
33
+ expect(PWN::Engagement.hosts(name: 'current-engagement')).to be_empty
34
+ end
35
+
36
+ it 'uses the same destination when matching name aliases are supplied' do
37
+ PWN::Engagement.open(name: 'destination', scope_domains: ['destination.invalid'])
38
+ PWN::Engagement.open(name: 'other', scope_domains: ['other.invalid'])
39
+ result = PWN::Engagement.record_host(engagement: 'destination', name: 'destination', host: 'destination.invalid')
40
+ expect(result).to include(host: 'destination.invalid')
41
+ expect(PWN::Engagement.hosts(name: 'destination')).to have_key(:'destination.invalid')
42
+ expect(PWN::Engagement.hosts(name: 'other')).to be_empty
43
+ end
44
+ end
@@ -20,6 +20,25 @@ describe PWN::FFI::Capstone do
20
20
  expect { described_class.disassemble(bytes: "\x90") }.to raise_error(RuntimeError, /libcapstone not available/)
21
21
  end
22
22
 
23
+ it 'releases decoded instructions and the handle when result conversion fails' do
24
+ allow(described_class).to receive(:available?).and_return(true)
25
+ allocation = FFI::MemoryPointer.new(:char)
26
+ handle = nil
27
+ allow(described_class).to receive(:cs_open) do |_arch, _mode, result|
28
+ handle = result
29
+ result.write_ulong(1)
30
+ 0
31
+ end
32
+ allow(described_class).to receive(:cs_disasm) do |*_args, result|
33
+ result.write_pointer(allocation)
34
+ 1
35
+ end
36
+ allow(described_class).to receive(:cs_version).and_raise(IOError, 'conversion failed')
37
+ expect(described_class).to receive(:cs_free).with(allocation, 1).once
38
+ expect(described_class).to(receive(:cs_close).once { |value| expect(value).to eq(handle) })
39
+ expect { described_class.disassemble(bytes: "\x90".b) }.to raise_error(IOError, 'conversion failed')
40
+ end
41
+
23
42
  before(:each, :capstone_integration) do
24
43
  expect(described_class.available?).to be(true),
25
44
  "PWN_TEST_CAPSTONE=1 requires libcapstone. Load error: #{described_class.load_error}"
@@ -8,6 +8,25 @@ describe PWN::FFI::FFTW do
8
8
  expect { described_class.rfft(samples: [1.0]) }.to raise_error(RuntimeError, /libfftw3f not available/)
9
9
  end
10
10
 
11
+ { rfft: :fftwf_plan_dft_r2c_1d, cfft: :fftwf_plan_dft_1d }.each do |method, planner|
12
+ %i[allocation planning execution].each do |failure|
13
+ it "releases #{method} native allocations on #{failure} failure" do
14
+ allow(described_class).to receive(:available?).and_return(true)
15
+ input = FFI::MemoryPointer.new(:float, 4)
16
+ output = FFI::MemoryPointer.new(:float, 4)
17
+ plan = FFI::MemoryPointer.new(:char)
18
+ allow(described_class).to receive(:fftwf_malloc).and_return(input, failure == :allocation ? FFI::Pointer::NULL : output)
19
+ allow(described_class).to receive(planner).and_return(failure == :planning ? FFI::Pointer::NULL : plan)
20
+ allow(described_class).to receive(:fftwf_execute).and_raise(IOError, 'execution failed')
21
+ expect(described_class).to receive(:fftwf_free).with(input).once
22
+ expect(described_class).to receive(:fftwf_free).with(output).once unless failure == :allocation
23
+ expect(described_class).to receive(:fftwf_destroy_plan).with(plan).once if failure == :execution
24
+ expect { described_class.public_send(method, samples: [1.0, 0.0], iq: [1.0, 0.0]) }
25
+ .to raise_error(StandardError, /failed/)
26
+ end
27
+ end
28
+ end
29
+
11
30
  it 'should display information for authors' do
12
31
  expect(PWN::FFI::FFTW).to respond_to :authors
13
32
  end
@@ -20,6 +20,19 @@ describe PWN::FFI::Keystone do
20
20
  expect { described_class.assemble(asm: 'nop') }.to raise_error(RuntimeError, /libkeystone not available/)
21
21
  end
22
22
 
23
+ it 'closes the native engine when assembly fails' do
24
+ allow(described_class).to receive(:available?).and_return(true)
25
+ engine = FFI::MemoryPointer.new(:char)
26
+ allow(described_class).to receive(:ks_open) do |_arch, _mode, result|
27
+ result.write_pointer(engine)
28
+ 0
29
+ end
30
+ allow(described_class).to receive(:ks_asm).and_return(-1)
31
+ expect(described_class).to receive(:ks_close).with(engine).once
32
+ expect(described_class).not_to receive(:ks_free)
33
+ expect { described_class.assemble(asm: 'invalid fixture instruction') }.to raise_error(/ks_asm failed/)
34
+ end
35
+
23
36
  before(:each, :keystone_integration) do
24
37
  expect(described_class.available?).to be(true),
25
38
  "PWN_TEST_KEYSTONE=1 requires libkeystone. Load error: #{described_class.load_error}"
@@ -9,6 +9,19 @@ describe PWN::FFI::SoapySDR do
9
9
  expect { described_class.make(args: 'driver=mock') }.to raise_error(RuntimeError, /libSoapySDR not available/)
10
10
  end
11
11
 
12
+ %i[setSampleRate setFrequency setGainMode setGain setBandwidth].each do |operation|
13
+ it "rejects failed #{operation} without publishing requested configuration as applied" do
14
+ operations = %i[setSampleRate setFrequency setGainMode setGain setBandwidth]
15
+ operations.each { |name| allow(described_class).to receive(:"SoapySDRDevice_#{name}").and_return(0) }
16
+ allow(described_class).to receive(:"SoapySDRDevice_#{operation}").and_return(-2)
17
+ handle = { device: :device, channel: 0, rate_hz: 12_000, freq_hz: 100_000_000 }
18
+ expect do
19
+ described_class.configure(handle: handle, rate_hz: 24_000, freq_hz: 101_000_000, gain_db: 12, bw_hz: 20_000)
20
+ end.to raise_error(RuntimeError, /#{operation}.*-2/)
21
+ expect(handle).to include(rate_hz: 12_000, freq_hz: 100_000_000)
22
+ end
23
+ end
24
+
12
25
  it 'reports close failure and retains the stream for cleanup retry' do
13
26
  handle = { device: :device, stream: :stream }
14
27
  allow(described_class).to receive(:SoapySDRDevice_deactivateStream).and_return(0)
@@ -11,6 +11,31 @@ describe PWN::JSONText do
11
11
  expect(described_class).to respond_to :help
12
12
  end
13
13
 
14
+ %w[ISO-8859-1 UTF-16LE UTF-16BE].each do |encoding|
15
+ it "preserves characters in #{encoding} text through every JSON entry point" do
16
+ text = 'café'.encode(encoding).freeze
17
+ value = { text => [text] }
18
+ [JSON.generate(value), JSON.fast_generate(value), JSON.pretty_generate(value), JSON.dump(value), value.to_json].each do |wire|
19
+ expect(JSON.parse(wire)).to eq('café' => ['café'])
20
+ end
21
+ expect(described_class.prepare(value: text)).to eq('café')
22
+ expect(text.encoding.name).to eq(encoding)
23
+ expect(text).to eq('café'.encode(encoding))
24
+ end
25
+ end
26
+
27
+ it 'rejects cycles and excessive container depth before unbounded JSON encoders run' do
28
+ cycle = []
29
+ cycle << cycle
30
+ expect { described_class.prepare(value: cycle) }.to raise_error(JSON::NestingError)
31
+ expect { JSON.dump(cycle) }.to raise_error(JSON::NestingError)
32
+ expect { JSON.generate(cycle, max_nesting: false) }.to raise_error(JSON::NestingError)
33
+ deep = Array.new(101) { [] }.inject('leaf') { |value, array| array << value }
34
+ expect { described_class.prepare(value: deep) }.to raise_error(JSON::NestingError)
35
+ branch = ['shared']
36
+ expect(JSON.parse(JSON.dump([branch, branch]))).to eq([['shared'], ['shared']])
37
+ end
38
+
14
39
  it 'retags binary UTF-8 and scrubs malformed bytes before JSON encode' do
15
40
  binary = "status \u2022 ok".b
16
41
  malformed = "\xff\xfe".b
@@ -13,6 +13,29 @@ describe PWN::MemoryIndex do
13
13
  expect(help_response).to respond_to :help
14
14
  end
15
15
 
16
+ it 'persists removal of forgotten memories when no remaining embedding changes' do
17
+ Dir.mktmpdir('memory-index-') do |dir|
18
+ stub_const('PWN::MemoryIndex::INDEX_FILE', File.join(dir, 'memory.idx'))
19
+ allow(described_class).to receive(:embed).and_return([[1.0, 0.0]])
20
+ memory = { fixture: { category: 'fact', value: 'fixture text' } }
21
+ described_class.refresh(mem: memory)
22
+ expect(described_class.refresh(mem: {})).to eq({})
23
+ expect(JSON.parse(File.read(described_class::INDEX_FILE))).to eq({})
24
+ end
25
+ end
26
+
27
+ it 'refreshes an embedding when the category changes with unchanged text' do
28
+ Dir.mktmpdir('memory-index-') do |dir|
29
+ stub_const('PWN::MemoryIndex::INDEX_FILE', File.join(dir, 'memory.idx'))
30
+ allow(described_class).to receive(:embed).with(texts: ['fact: fixture text']).and_return([[1.0, 0.0]])
31
+ allow(described_class).to receive(:embed).with(texts: ['lesson: fixture text']).and_return([[0.0, 1.0]])
32
+ described_class.refresh(mem: { fixture: { category: 'fact', value: 'fixture text' } })
33
+ updated = described_class.refresh(mem: { fixture: { category: 'lesson', value: 'fixture text' } })
34
+ expect(updated.dig(:fixture, :vec)).to eq([0.0, 1.0])
35
+ expect(described_class).to have_received(:embed).with(texts: ['lesson: fixture text']).once
36
+ end
37
+ end
38
+
16
39
  it 'ranks a throttle-evasion document above an unrelated document' do
17
40
  docs = [
18
41
  'the cat sat on the mat',