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,34 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+
5
+ RSpec.describe 'PWN::ModuleSkills source parsing' do
6
+ include_context 'pwn tmp sandbox'
7
+
8
+ it 'preserves predicate, bang and setter suffixes in generated public method names' do
9
+ lib = File.join(@tmp, 'lib')
10
+ FileUtils.mkdir_p(File.join(lib, 'pwn'))
11
+ File.write(File.join(lib, 'pwn', 'fixture.rb'), <<~RUBY)
12
+ module PWN
13
+ module Fixture
14
+ public_class_method def self.ready?(opts = {}); opts[:ready]; end
15
+ public_class_method def self.refresh!(opts = {}); opts[:refresh]; end
16
+ public_class_method def self.value=(value); @value = value; end
17
+ end
18
+ end
19
+ RUBY
20
+ record = PWN::ModuleSkills.enumerate(lib_root: lib).first
21
+ expect(record[:methods]).to contain_exactly('ready?', 'refresh!', 'value=')
22
+ end
23
+
24
+ it 'refuses to prune existing skills when the source tree has no modules' do
25
+ dest = File.join(@tmp, 'skills')
26
+ skill = File.join(dest, 'pwn', 'fixture', 'SKILL.md')
27
+ FileUtils.mkdir_p(File.dirname(skill))
28
+ File.write(skill, 'keep existing generated skill')
29
+ expect do
30
+ PWN::ModuleSkills.refresh!(lib_root: File.join(@tmp, 'missing-lib'), dest: dest)
31
+ end.to raise_error(ArgumentError, /no PWN modules/i)
32
+ expect(File.read(skill)).to eq('keep existing generated skill')
33
+ end
34
+ end
@@ -0,0 +1,57 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+ require 'digest'
5
+
6
+ RSpec.describe 'AISandbox mandatory write-grant review' do
7
+ include_context 'pwn tmp sandbox'
8
+
9
+ before do
10
+ @home = File.join(@tmp, 'home')
11
+ @work = File.join(@tmp, 'work')
12
+ @outputs = File.join(@tmp, 'outputs')
13
+ @source = File.join(@outputs, 'source')
14
+ @state = File.join(@outputs, 'controller-artifacts')
15
+ FileUtils.mkdir_p([@home, @work, @source, @state])
16
+ allow(Dir).to receive(:home).and_return(@home)
17
+ allow(PWN::Plugins::AISandbox).to receive(:protected_roots).and_return([@source, '/opt/pwn'])
18
+ stub_const('PWN::Plugins::ArtifactRegistry::ROOT', @state)
19
+ @saved_runtime = Thread.current[:pwn_request_runtime]
20
+ @source_file = File.join(@source, 'sentinel')
21
+ @state_file = File.join(@state, 'sentinel')
22
+ File.write(@source_file, 'original-source')
23
+ File.write(@state_file, 'original-state')
24
+ end
25
+
26
+ after do
27
+ Thread.current[:pwn_request_runtime] = @saved_runtime
28
+ end
29
+
30
+ def dispatch_boundary(request, &handler)
31
+ runtime = PWN::AI::Agent::RequestRuntime.new(request: request, session_id: 'sandbox-review', artifact_root: File.join(@tmp, 'request-state'), cwd: @work, trace: false, retrieve: false)
32
+ Thread.current[:pwn_request_runtime] = runtime
33
+ PWN::AI::Agent::Registry.register(name: 'sandbox_pbr01_boundary', toolset: 'fixture', schema: { name: 'sandbox_pbr01_boundary', parameters: { type: 'object' } }, handler: handler)
34
+ row = JSON.parse(PWN::AI::Agent::Dispatch.call(tool_call: { function: { name: 'sandbox_pbr01_boundary', arguments: '{}' } }))
35
+ [row, runtime]
36
+ end
37
+
38
+ it '[PBR-01] denies source and controller writes despite an original-request sibling output', :aggregate_failures do
39
+ output = File.join(@outputs, 'requested.txt')
40
+ before = [@source_file, @state_file].to_h { |path| [path, Digest::SHA256.file(path).hexdigest] }
41
+ row, runtime = dispatch_boundary("Write the report to #{output}") do |_args|
42
+ attempts = [@source_file, @state_file].map do |path|
43
+ File.write(path, 'modified')
44
+ 'allowed'
45
+ rescue Errno::EACCES, Errno::EPERM
46
+ 'denied'
47
+ end
48
+ File.write(output, 'named')
49
+ { attempts: attempts, named: File.read(output) }
50
+ end
51
+ expect(runtime.contract[:required_artifacts]).to eq([output])
52
+ expect(row.dig('result', 'attempts')).to eq(%w[denied denied])
53
+ expect(row.dig('result', 'named')).to eq('named')
54
+ expect([@source_file, @state_file].to_h { |path| [path, Digest::SHA256.file(path).hexdigest] }).to eq(before)
55
+ expect(File.read(output)).to eq('named')
56
+ end
57
+ end
@@ -253,31 +253,23 @@ describe PWN::Plugins::AISandbox do
253
253
  end
254
254
  end
255
255
 
256
- it 'denies rm -rf /tmp/fake_root in strict mode without touching disk' do
257
- root = '/tmp/fake_root'
258
- FileUtils.mkdir_p(root)
259
- marker = File.join(root, 'keep')
260
- File.write(marker, 'safe')
261
- begin
262
- out = described_class.exec(kind: :shell, payload: 'rm -rf /tmp/fake_root', mode: 'strict')
256
+ it 'denies rm -rf outside the artifact root in strict mode without touching disk' do
257
+ Dir.mktmpdir('pwn-strict-delete-') do |root|
258
+ marker = File.join(root, 'keep')
259
+ File.write(marker, 'safe')
260
+ out = described_class.exec(kind: :shell, payload: "rm -rf #{root}", mode: 'strict')
263
261
  expect(out[:error].to_s).to match(/sandbox violation/i)
264
262
  expect(File.file?(marker)).to be true
265
- ensure
266
- FileUtils.rm_rf(root)
267
263
  end
268
264
  end
269
265
 
270
- it 'denies FileUtils.rm_rf("/tmp/fake_root") in strict mode without touching disk' do
271
- root = '/tmp/fake_root'
272
- FileUtils.mkdir_p(root)
273
- marker = File.join(root, 'keep')
274
- File.write(marker, 'safe')
275
- begin
276
- out = described_class.exec(kind: :ruby, payload: "FileUtils.rm_rf('/tmp/fake_root')", mode: 'strict')
266
+ it 'denies FileUtils.rm_rf outside the artifact root in strict mode without touching disk' do
267
+ Dir.mktmpdir('pwn-strict-delete-') do |root|
268
+ marker = File.join(root, 'keep')
269
+ File.write(marker, 'safe')
270
+ out = described_class.exec(kind: :ruby, payload: "FileUtils.rm_rf(#{root.inspect})", mode: 'strict')
277
271
  expect(out[:error].to_s).to match(/sandbox violation/i)
278
272
  expect(File.file?(marker)).to be true
279
- ensure
280
- FileUtils.rm_rf(root)
281
273
  end
282
274
  end
283
275
  end
@@ -0,0 +1,121 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+ require 'tmpdir'
5
+ require 'json'
6
+ require 'rbconfig'
7
+ require 'timeout'
8
+
9
+ RSpec.describe PWN::Plugins::Android do
10
+ around do |example|
11
+ Dir.mktmpdir('android-review-') do |root|
12
+ @root = root
13
+ @adb = File.join(root, 'adb literal ; executable')
14
+ @calls = File.join(root, 'calls.jsonl')
15
+ File.write(@adb, "#!#{RbConfig.ruby}\nrequire 'json'\nFile.open(#{@calls.inspect}, 'a') { |f| f.puts(JSON.generate(ARGV)) }\nputs 'synthetic'\n")
16
+ File.chmod(0o700, @adb)
17
+ example.run
18
+ end
19
+ end
20
+
21
+ it 'cancels and reaps only its owned process group, including TERM-resistant descendants' do
22
+ pidfile = File.join(@root, 'pids')
23
+ release = File.join(@root, 'release')
24
+ File.write(@adb, <<~RUBY)
25
+ #!#{RbConfig.ruby}
26
+ child = fork do
27
+ trap('TERM') {}
28
+ File.write(#{"#{pidfile}.ready".inspect}, '')
29
+ sleep 0.01 until File.exist?(#{release.inspect})
30
+ end
31
+ sleep 0.01 until File.exist?(#{"#{pidfile}.ready".inspect})
32
+ File.write(#{"#{pidfile}.tmp".inspect}, [Process.pid, child].join(' '))
33
+ File.rename(#{"#{pidfile}.tmp".inspect}, #{pidfile.inspect})
34
+ sleep 0.01 until File.exist?(#{release.inspect})
35
+ Process.wait(child)
36
+ RUBY
37
+ result = Queue.new
38
+ worker = Thread.new do
39
+ described_class.adb_sh(adb_path: @adb, command: 'synthetic')
40
+ rescue Interrupt => e
41
+ result << e
42
+ end
43
+ Timeout.timeout(5) { Thread.pass until File.exist?(pidfile) }
44
+ owned, descendant = File.read(pidfile).split.map(&:to_i)
45
+ worker.raise(Interrupt, 'synthetic cancellation')
46
+ expect(worker.join(2)).to equal(worker)
47
+ expect(result.pop(timeout: 0.1)).to be_a(Interrupt)
48
+ expect { Process.waitpid(owned, Process::WNOHANG) }.to raise_error(Errno::ECHILD)
49
+ Timeout.timeout(2) do
50
+ loop do
51
+ begin
52
+ state = File.read("/proc/#{descendant}/stat").split[2]
53
+ rescue Errno::ENOENT, Errno::ESRCH
54
+ break
55
+ end
56
+ break if state == 'Z'
57
+
58
+ Thread.pass
59
+ end
60
+ end
61
+ expect(Process.kill(0, Process.pid)).to eq(1)
62
+ ensure
63
+ File.write(release, '') if release
64
+ worker&.join(3)
65
+ worker&.kill if worker&.alive?
66
+ end
67
+
68
+ it 'surfaces cleanup-only errors inside an unrelated caller rescue' do
69
+ allow(Process).to receive(:kill).and_call_original
70
+ allow(Process).to receive(:kill).with('TERM', kind_of(Integer)).and_raise(IOError, 'cleanup failure')
71
+ begin
72
+ raise 'unrelated caller error'
73
+ rescue RuntimeError
74
+ expect { described_class.adb_sh(adb_path: @adb, command: 'synthetic') }.to raise_error(IOError, 'cleanup failure')
75
+ end
76
+ end
77
+
78
+ it 'bounds an owned child that closes stdout but never exits, without exposing its output' do
79
+ File.write(@adb, "#!#{RbConfig.ruby}\nSTDOUT.close\nsleep 20\n")
80
+ stub_const('PWN::Plugins::Android::COMMAND_TIMEOUT', 1)
81
+ owned = nil
82
+ allow(Process).to receive(:spawn).and_wrap_original do |original, *args, **kwargs|
83
+ owned = original.call(*args, **kwargs)
84
+ end
85
+ expect do
86
+ Timeout.timeout(3) { described_class.adb_sh(adb_path: @adb, command: 'synthetic') }
87
+ end.to raise_error(Timeout::Error, /adb command timed out/)
88
+ expect { Process.waitpid(owned, Process::WNOHANG) }.to raise_error(Errno::ECHILD)
89
+ end
90
+
91
+ it 'bounds capture output and suppresses private child stderr on failure' do
92
+ File.write(@adb, "#!#{RbConfig.ruby}\nSTDERR.puts 'synthetic-private'\nprint 'x' * 2048\n")
93
+ stub_const('PWN::Plugins::Android::MAX_OUTPUT_BYTES', 1024)
94
+ spawn_options = nil
95
+ allow(Process).to receive(:spawn).and_wrap_original do |original, *args, **kwargs|
96
+ spawn_options = kwargs
97
+ original.call(*args, **kwargs)
98
+ end
99
+ expect { described_class.adb_sh(adb_path: @adb, command: 'synthetic') }.to raise_error(IOError, 'adb output limit exceeded')
100
+ expect(spawn_options[:err]).to eq(File::NULL)
101
+ end
102
+
103
+ %i[adb_sh adb_push adb_pull take_screenshot screen_record list_installed_apps dumpsys open_app close_app invoke_event_listener].each do |method|
104
+ ['false', 'true', 1, nil].each do |flag|
105
+ it "rejects nonboolean #{flag.inspect} root consent in #{method} before spawning" do
106
+ expect { described_class.public_send(method, adb_path: @adb, as_root: flag) }.to raise_error(ArgumentError, /as_root/)
107
+ expect(File.exist?(@calls)).to be(false)
108
+ end
109
+ end
110
+
111
+ [false, true, :omitted].each do |flag|
112
+ it "requires literal true for #{method} with #{flag}" do
113
+ options = { adb_path: @adb, command: 'synthetic', app: 'example.invalid', file: 'a', dest: 'b' }
114
+ options[:as_root] = flag unless flag == :omitted
115
+ described_class.public_send(method, options)
116
+ calls = File.readlines(@calls).map { |line| JSON.parse(line) }
117
+ expect(calls.include?(['root'])).to eq(flag == true)
118
+ end
119
+ end
120
+ end
121
+ end
@@ -0,0 +1,64 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+ require 'tmpdir'
5
+ require 'json'
6
+ require 'rbconfig'
7
+
8
+ RSpec.describe PWN::Plugins::Android do
9
+ around do |example|
10
+ Dir.mktmpdir('adb-boundary-') do |root|
11
+ @adb = File.join(root, 'adb literal ; path')
12
+ @calls = File.join(root, 'calls')
13
+ @output = File.join(root, 'output')
14
+ @exit = File.join(root, 'exit')
15
+ File.write(@output, '')
16
+ File.write(@exit, '0')
17
+ File.write(@adb, <<~RUBY)
18
+ #!#{RbConfig.ruby}
19
+ require 'json'
20
+ File.open(#{@calls.inspect}, 'a') { |f| f.puts(JSON.generate(ARGV)) }
21
+ print File.binread(#{@output.inspect})
22
+ exit File.read(#{@exit.inspect}).to_i
23
+ RUBY
24
+ File.chmod(0o700, @adb)
25
+ example.run
26
+ end
27
+ end
28
+
29
+ %i[take_screenshot screen_record].each do |method|
30
+ [false, true].each do |root|
31
+ it "honors as_root: #{root} for #{method} at a real executable boundary" do
32
+ described_class.public_send(method, adb_path: @adb, as_root: root)
33
+ calls = File.readlines(@calls).map { |line| JSON.parse(line) }
34
+ expect(calls.include?(['root'])).to eq(root)
35
+ end
36
+ end
37
+ end
38
+
39
+ it 'passes host filenames as literal arguments rather than a local shell command' do
40
+ described_class.adb_push(adb_path: @adb, file: '/fixture/a b;literal', dest: '/sdcard/a b')
41
+ expect(JSON.parse(File.read(@calls))).to eq(['push', '/fixture/a b;literal', '/sdcard/a b'])
42
+ end
43
+
44
+ it 'keeps intentional shell commands on Android rather than executing local shell operators' do
45
+ described_class.adb_sh(adb_path: @adb, command: 'printf fixture; id')
46
+ expect(JSON.parse(File.read(@calls))).to eq(['shell', 'printf fixture; id'])
47
+ end
48
+
49
+ it 'rejects a missing explicit adb executable instead of executing bare command names' do
50
+ expect { described_class.adb_sh(adb_path: '/fixture/not-present', command: 'id') }.to raise_error(ArgumentError, /adb_path/)
51
+ expect(File.exist?(@calls)).to be(false)
52
+ end
53
+
54
+ it 'strips the package marker from the first installed package too' do
55
+ File.write(@output, "package:one.example\npackage:two.example\n")
56
+ expect(described_class.list_installed_apps(adb_path: @adb)).to eq(%w[one.example two.example])
57
+ end
58
+
59
+ it 'surfaces an unsuccessful adb exit without echoing command output' do
60
+ File.write(@output, 'private synthetic output')
61
+ File.write(@exit, '1')
62
+ expect { described_class.adb_pull(adb_path: @adb, file: '/sdcard/a', dest: '/fixture/a') }.to raise_error(IOError, /\Aadb command failed/)
63
+ end
64
+ end
@@ -0,0 +1,49 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+ require 'tmpdir'
5
+ require 'fileutils'
6
+ require 'rest-client'
7
+
8
+ RSpec.describe 'API import working-directory regression' do
9
+ let(:specification) { { openapi: '3.0.3', info: { title: 'Fixture', version: '1' }, servers: [{ url: 'https://example.invalid' }], paths: {} } }
10
+
11
+ around do |example|
12
+ previous_dir = Dir.pwd
13
+ Dir.mktmpdir('api-import-audit') do |dir|
14
+ Dir.chdir(dir)
15
+ FileUtils.mkdir_p('inputs')
16
+ File.write('inputs/spec.json', JSON.generate(specification))
17
+ example.run
18
+ ensure
19
+ Dir.chdir(previous_dir)
20
+ end
21
+ end
22
+
23
+ it 'loads a relative Burp import without changing the caller directory' do
24
+ mod = PWN::Plugins::BurpSuite
25
+ allow(mod).to receive(:stop)
26
+ allow(mod).to receive(:add_to_sitemap)
27
+ cwd = Dir.pwd
28
+ expect(mod.import_openapi_to_sitemap(burp_obj: {}, openapi_spec: 'inputs/spec.json')).to eq([])
29
+ expect(Dir.pwd).to eq(cwd)
30
+ end
31
+
32
+ it 'keeps OpenAPI output paths relative to the caller directory' do
33
+ allow(RestClient).to receive(:get).and_return('{"type":"object"}')
34
+ cwd = Dir.pwd
35
+ PWN::Plugins::OpenAPI.generate_spec(spec_paths: ['inputs/spec.json'], base_url: 'https://example.invalid', output_json_path: 'merged.json')
36
+ expect(Dir.pwd).to eq(cwd)
37
+ expect(File).to exist(File.join(cwd, 'merged.json'))
38
+ end
39
+
40
+ it 'sends an absolute ZAP import path without changing the caller directory' do
41
+ mod = PWN::Plugins::Zaproxy
42
+ allow(mod).to receive(:stop)
43
+ allow(mod).to receive(:zap_rest_call).and_return(double('response', body: '{}'))
44
+ cwd = Dir.pwd
45
+ mod.import_openapi_to_sitemap(zap_obj: { api_key: 'fixture-token' }, openapi_spec: 'inputs/spec.json')
46
+ expect(Dir.pwd).to eq(cwd)
47
+ expect(mod).to have_received(:zap_rest_call).with(hash_including(params: hash_including(file: File.join(cwd, 'inputs/spec.json'))))
48
+ end
49
+ end
@@ -0,0 +1,20 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+ require 'tmpdir'
5
+
6
+ RSpec.describe PWN::Plugins::ArtifactRegistry, 'session path regression' do
7
+ it 'rejects traversal session identifiers before registering a file' do
8
+ Dir.mktmpdir('artifact-audit') do |dir|
9
+ stub_const('PWN::Plugins::ArtifactRegistry::ROOT', File.join(dir, 'artifacts'))
10
+ source = File.join(dir, 'source.bin')
11
+ File.binwrite(source, 'fixture')
12
+ expect { described_class.register(session_id: '../outside', path: source) }.to raise_error(ArgumentError, /session_id/)
13
+ expect(File.exist?(File.join(dir, 'outside', 'source.bin'))).to be(false)
14
+ end
15
+ end
16
+
17
+ it 'rejects traversal session identifiers before listing an index' do
18
+ expect { described_class.list(session_id: '../outside') }.to raise_error(ArgumentError, /session_id/)
19
+ end
20
+ end
@@ -0,0 +1,63 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+ require 'tmpdir'
5
+
6
+ RSpec.describe PWN::Plugins::ArtifactRegistry, 'review containment regressions' do
7
+ %i[root session index destination].each do |link|
8
+ it "PSR-S01 rejects a #{link} symlink before copying or appending" do
9
+ Dir.mktmpdir('artifact-containment') do |dir|
10
+ root = File.join(dir, 'registry')
11
+ session = File.join(root, 'safe')
12
+ outside = File.join(dir, 'outside')
13
+ FileUtils.mkdir_p([session, outside])
14
+ source = File.join(dir, 'fixture.bin')
15
+ File.binwrite(source, 'new bytes')
16
+ sentinel = File.join(outside, 'sentinel')
17
+ File.binwrite(sentinel, 'unchanged')
18
+ target = { root: root, session: session, index: File.join(session, 'index.jsonl'),
19
+ destination: File.join(session, 'fixture.bin') }.fetch(link)
20
+ FileUtils.remove_entry(target) if File.directory?(target)
21
+ File.symlink(%i[root session].include?(link) ? outside : sentinel, target)
22
+ stub_const('PWN::Plugins::ArtifactRegistry::ROOT', root)
23
+
24
+ expect { described_class.register(session_id: 'safe', path: source) }.to raise_error(ArgumentError, /symlink/)
25
+ expect(Dir.children(outside)).to eq(['sentinel'])
26
+ expect(File.binread(sentinel)).to eq('unchanged')
27
+ expect(File).not_to exist(File.join(session, 'fixture.bin')) unless link == :destination
28
+ end
29
+ end
30
+ end
31
+
32
+ %i[root session index].each do |link|
33
+ it "PSR-S01 rejects a #{link} symlink before listing an external index" do
34
+ Dir.mktmpdir('artifact-list-containment') do |dir|
35
+ root = File.join(dir, 'registry')
36
+ session = File.join(root, 'safe')
37
+ outside = File.join(dir, 'outside')
38
+ FileUtils.mkdir_p([session, File.join(outside, 'safe')])
39
+ record = JSON.generate(path: 'external fixture')
40
+ File.write(File.join(outside, 'index.jsonl'), record)
41
+ File.write(File.join(outside, 'safe', 'index.jsonl'), record)
42
+ target = { root: root, session: session, index: File.join(session, 'index.jsonl') }.fetch(link)
43
+ FileUtils.remove_entry(target) if File.directory?(target)
44
+ File.symlink(link == :index ? File.join(outside, 'index.jsonl') : outside, target)
45
+ stub_const('PWN::Plugins::ArtifactRegistry::ROOT', root)
46
+
47
+ expect { described_class.list(session_id: 'safe') }.to raise_error(ArgumentError, /symlink/)
48
+ end
49
+ end
50
+ end
51
+
52
+ it 'preserves successful registration and empty-list contracts' do
53
+ Dir.mktmpdir('artifact-register') do |dir|
54
+ stub_const('PWN::Plugins::ArtifactRegistry::ROOT', File.join(dir, 'registry'))
55
+ source = File.join(dir, 'fixture.bin')
56
+ File.binwrite(source, 'fixture')
57
+ expect(described_class.list(session_id: 'safe')).to eq([])
58
+ dest = described_class.register(session_id: 'safe', path: source, kind: 'fixture')
59
+ expect(File.binread(dest)).to eq('fixture')
60
+ expect(described_class.list(session_id: 'safe')).to contain_exactly(hash_including(path: dest, src: source, kind: 'fixture'))
61
+ end
62
+ end
63
+ end
@@ -0,0 +1,16 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+
5
+ RSpec.describe PWN::Plugins::Assembly, 'opcode input regression' do
6
+ before do
7
+ allow(PWN::AI::Agent::Assembly).to receive(:analyze).and_return('offline analysis')
8
+ end
9
+
10
+ ['525bc3', '52 5B C3', '52,5B,C3', '\\x52\\x5b\\xc3', %w[52 5B C3], "\x52\x5b\xc3".b].each do |input|
11
+ it "preserves all opcode nibbles for #{input.inspect}" do
12
+ result = described_class.opcodes_to_asm(opcodes: input, arch: 'x86_64', endian: :little)
13
+ expect(result).to include('push rdx', 'pop rbx', 'ret')
14
+ end
15
+ end
16
+ end
@@ -0,0 +1,33 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+
5
+ RSpec.describe PWN::Plugins::Assembly, 'review binary/text discrimination' do
6
+ before do
7
+ allow(PWN::AI::Agent::Assembly).to receive(:analyze).and_return('offline analysis')
8
+ end
9
+
10
+ ["\x41\x42".b, 'AB CD'.b, '\\x41\\x42'.b].each do |bytes|
11
+ it "PSR-L04 preserves explicitly binary bytes #{bytes.inspect} without textual decoding" do
12
+ result = described_class.opcodes_to_asm(opcodes: bytes, arch: 'x86', endian: :little)
13
+ expected = Metasm::Shellcode.disassemble(Metasm::Ia32.new(:little), bytes).to_s.squeeze("\n")
14
+ expect(result).to include(expected)
15
+ end
16
+ end
17
+
18
+ ['4142', '41 42', '41,42', '\\x41\\x42', %w[41 42], "['41', '42']"].each do |text|
19
+ it "retains the text opcode format #{text.inspect}" do
20
+ result = described_class.opcodes_to_asm(opcodes: text, arch: 'x86', endian: :little)
21
+ expect(result).to include('inc ecx', 'inc edx')
22
+ end
23
+ end
24
+
25
+ it 'documents the raw binary and textual override contract' do
26
+ expect { described_class.help }.to output(/binary-tagged input as textual hex.*binary Strings are raw bytes/).to_stdout
27
+ end
28
+
29
+ it 'allows the existing textual-input override for binary-tagged text' do
30
+ result = described_class.opcodes_to_asm(opcodes: '4142'.b, opcodes_always_string_obj: true, arch: 'x86', endian: :little)
31
+ expect(result).to include('inc ecx', 'inc edx')
32
+ end
33
+ end
@@ -3,6 +3,20 @@
3
3
  require 'spec_helper'
4
4
 
5
5
  describe PWN::Plugins::AuthenticationHelper do
6
+ it 'prompts for a username with the default label' do
7
+ prompt = instance_double(TTY::Prompt)
8
+ allow(TTY::Prompt).to receive(:new).and_return(prompt)
9
+ expect(prompt).to receive(:ask).with('Username: ').and_return(" fixture-user\n")
10
+ expect(described_class.username).to eq('fixture-user')
11
+ end
12
+
13
+ it 'accepts the documented username prompt option' do
14
+ prompt = instance_double(TTY::Prompt)
15
+ allow(TTY::Prompt).to receive(:new).and_return(prompt)
16
+ expect(prompt).to receive(:ask).with('Account: ').and_return('fixture-user')
17
+ expect(described_class.username(prompt: 'Account')).to eq('fixture-user')
18
+ end
19
+
6
20
  it 'should display information for authors' do
7
21
  authors_response = PWN::Plugins::AuthenticationHelper
8
22
  expect(authors_response).to respond_to :authors
@@ -0,0 +1,127 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+ require 'tmpdir'
5
+
6
+ RSpec.describe PWN::Plugins::BareSIP do
7
+ around do |example|
8
+ Dir.mktmpdir('baresip-review-') do |root|
9
+ @root = root
10
+ File.write(File.join(root, 'config'), "http_listen 127.0.0.1:1\n")
11
+ @log = File.join(root, 'screenlog.txt')
12
+ example.run
13
+ end
14
+ end
15
+
16
+ before do
17
+ allow(PWN::Plugins::Sock).to receive(:get_random_unused_port).and_return(12_345)
18
+ allow(described_class).to receive(:system).and_return(true)
19
+ end
20
+
21
+ it 'stops the launched session if closing its readiness log prevents handoff' do
22
+ log_handle = nil
23
+ allow(File).to receive(:open).and_call_original
24
+ allow(File).to receive(:open).with(@log, File::RDWR | File::CREAT, 0o600).and_wrap_original do |original, *args|
25
+ log_handle = original.call(*args)
26
+ allow(log_handle).to receive(:close).and_wrap_original do |close|
27
+ close.call
28
+ raise IOError, 'log close failure'
29
+ end
30
+ log_handle
31
+ end
32
+ allow(described_class).to receive(:system) do |*args|
33
+ File.open(@log, 'a') { |file| file.puts('registered successfully') } if args.include?('-Logfile')
34
+ true
35
+ end
36
+ expect { described_class.start(config_root: @root, session_root: @root, screenlog_path: @log, screen_session: 'fixture-owned') }.to raise_error(IOError, 'log close failure')
37
+ expect(log_handle).to be_closed
38
+ expect(described_class).to have_received(:system).with('screen', '-S', 'fixture-owned', '-X', 'quit').once
39
+ end
40
+
41
+ [Interrupt, IOError].each do |error|
42
+ it "preserves real startup #{error} and removes the exact owned config without HTTP teardown" do
43
+ copied = nil
44
+ allow(FileUtils).to receive(:cp_r).and_wrap_original do |original, source, destination|
45
+ copied = destination
46
+ original.call(source, destination)
47
+ end
48
+ allow(File).to receive(:stat).and_call_original
49
+ allow(File).to receive(:stat).with(/screenlog-.*\.txt/).and_raise(error, 'primary startup failure')
50
+ expect(described_class).not_to receive(:baresip_http_call)
51
+ expect do
52
+ described_class.dial_target_in_list(config_root: @root, session_root: @root, target_num: '2025550100', src_num_rules: 'static')
53
+ end.to raise_error(error, 'primary startup failure')
54
+ expect(copied).not_to be_nil
55
+ expect(Dir.exist?(copied)).to be(false)
56
+ expect(File.exist?(File.join(@root, 'config'))).to be(true)
57
+ end
58
+ end
59
+
60
+ it 'surfaces cleanup-only stop failure even inside an unrelated caller rescue' do
61
+ allow(described_class).to receive(:system) do |*args|
62
+ File.open(args[args.index('-Logfile') + 1], 'a') { |file| file.puts('registered successfully') } if args.include?('-Logfile')
63
+ true
64
+ end
65
+ allow(described_class).to receive(:sleep)
66
+ allow(described_class).to receive(:baresip_http_call) do |options|
67
+ raise IOError, 'stop failure' if options[:cmd].start_with?('/quit')
68
+
69
+ Nokogiri::HTML('<pre>synthetic</pre>')
70
+ end
71
+ begin
72
+ raise 'unrelated caller error'
73
+ rescue RuntimeError
74
+ expect do
75
+ described_class.dial_target_in_list(config_root: @root, session_root: @root, target_num: '2025550100', src_num_rules: 'static', seconds_to_record: 1)
76
+ end.to raise_error(IOError, 'stop failure')
77
+ end
78
+ end
79
+
80
+ it 'removes the owned config even when HTTP stop fails after successful startup' do
81
+ copied = nil
82
+ allow(FileUtils).to receive(:cp_r).and_wrap_original do |original, source, destination|
83
+ copied = destination
84
+ original.call(source, destination)
85
+ end
86
+ allow(described_class).to receive(:system) do |*args|
87
+ File.open(args[args.index('-Logfile') + 1], 'a') { |file| file.puts('registered successfully') } if args.include?('-Logfile')
88
+ true
89
+ end
90
+ calls = []
91
+ allow(described_class).to receive(:baresip_http_call) do |options|
92
+ calls << options[:cmd]
93
+ raise IOError, calls.length == 1 ? 'primary dial failure' : 'secondary stop failure'
94
+ end
95
+ expect do
96
+ described_class.dial_target_in_list(config_root: @root, session_root: @root, target_num: '2025550100', src_num_rules: 'static')
97
+ end.to raise_error(IOError, 'primary dial failure')
98
+ expect(calls.length).to eq(2)
99
+ expect(Dir.exist?(copied)).to be(false)
100
+ end
101
+
102
+ ['registered successfully', '403 Forbidden', 'account: No SIP accounts found'].each do |stale|
103
+ it "ignores historical #{stale} without fresh session bytes" do
104
+ File.write(@log, "#{stale}\n")
105
+ expect { described_class.start(config_root: @root, session_root: @root, screenlog_path: @log, timeout: 0.05) }.to raise_error(Timeout::Error)
106
+ end
107
+ end
108
+
109
+ it 'recognizes fresh readiness after historical errors in an explicit log' do
110
+ File.write(@log, "403 Forbidden\n")
111
+ allow(described_class).to receive(:system) do |*args|
112
+ File.open(@log, 'a') { |file| file.puts('registered successfully') } if args.include?('-Logfile')
113
+ true
114
+ end
115
+ result = described_class.start(config_root: @root, session_root: @root, screenlog_path: @log, timeout: 0.1)
116
+ expect(result[:screenlog_path]).to eq(@log)
117
+ end
118
+
119
+ it 'does not let historical success override a fresh failure' do
120
+ File.write(@log, "registered successfully\n")
121
+ allow(described_class).to receive(:system) do |*args|
122
+ File.open(@log, 'a') { |file| file.puts('403 Forbidden') } if args.include?('-Logfile')
123
+ true
124
+ end
125
+ expect { described_class.start(config_root: @root, session_root: @root, screenlog_path: @log, timeout: 0.1) }.to raise_error(/403 Forbidden/)
126
+ end
127
+ end