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,70 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+
5
+ RSpec.describe 'pwn_web_cache_deception lifecycle audit' do
6
+ let(:script) { File.expand_path('../../bin/pwn_web_cache_deception', __dir__) }
7
+ let(:browser) { double('offline browser', goto: nil, html: '<html>fixture</html>') }
8
+ let(:browser_obj) { { browser: browser } }
9
+ let(:provider) { double('offline WWW provider', open: browser_obj, login: browser_obj, logout: browser_obj, close: nil) }
10
+ let(:driver_opts) { {} }
11
+ let(:args) do
12
+ ['--target-url=https://example.invalid/path', "--output-results=#{File.join(@directory, 'results.txt')}",
13
+ '--pwn-www-mod=GitHub', '-pfixture-password']
14
+ end
15
+
16
+ around do |example|
17
+ Dir.mktmpdir('pwn-wcd-audit-') do |directory|
18
+ @directory = directory
19
+ example.run
20
+ end
21
+ end
22
+
23
+ before do
24
+ stub_const('ARGV', args.dup)
25
+ allow(PWN::Env).to receive(:[]).and_call_original
26
+ allow(PWN::Env).to receive(:[]).with(:driver_opts).and_return(driver_opts)
27
+ allow(PWN::Config).to receive(:refresh_env)
28
+ stub_const('PWN::WWW::GitHub', provider)
29
+ stub_const('PWN::Plugins::TransparentBrowser', double('offline browser boundary', open: browser_obj, close: nil))
30
+ allow(PWN::Plugins::AuthenticationHelper).to receive(:mask_password).and_raise('unexpected password prompt')
31
+ end
32
+
33
+ it 'does not request a password for unauthenticated scans' do
34
+ ARGV.reject! { |arg| arg.start_with?('--pwn-www-mod=', '-pfixture') }
35
+ expect(PWN::Plugins::AuthenticationHelper).not_to receive(:mask_password)
36
+ load script, true
37
+ expect(File.read(File.join(@directory, 'results.txt'))).to include('Potential Candidate')
38
+ end
39
+
40
+ it 'reports an invalid authentication module rather than resolving NAME_ERROR' do
41
+ ARGV.map! { |arg| arg == '--pwn-www-mod=GitHub' ? '--pwn-www-mod=MissingFixtureModule' : arg }
42
+ expect { load script, true }.to raise_error(ArgumentError, /Invalid module/)
43
+ end
44
+
45
+ it 'reports an invalid authentication module without a secondary NameError or browser close' do
46
+ ARGV.map! { |arg| arg == '--pwn-www-mod=GitHub' ? '--pwn-www-mod=MissingFixtureModule' : arg }
47
+ expect(PWN::Plugins::TransparentBrowser).not_to receive(:close)
48
+ expect { load script, true }.to raise_error(ArgumentError, /Invalid module/)
49
+ end
50
+
51
+ it 'rejects an authentication adapter without a close operation before opening it' do
52
+ incomplete = double('incomplete adapter', open: browser_obj, login: browser_obj, logout: browser_obj)
53
+ stub_const('PWN::WWW::GitHub', incomplete)
54
+ expect(incomplete).not_to receive(:open)
55
+ expect { load script, true }.to raise_error(ArgumentError, /close/)
56
+ end
57
+
58
+ it 'appends the payload to the URL path rather than its fragment' do
59
+ ARGV.map! { |arg| arg.start_with?('--target-url=') ? '--target-url=https://example.invalid/path#section' : arg }
60
+ load script, true
61
+ expect(browser).to have_received(:goto).with('https://example.invalid/path/wcd.aif#section')
62
+ expect(browser).not_to have_received(:goto).with('https://example.invalid/path#section/wcd.aif')
63
+ end
64
+
65
+ it 'parses the advertised short password option without treating it as a proxy' do
66
+ expect(provider).to receive(:login).with(hash_including(password: 'fixture-password')).and_return(browser_obj)
67
+ expect(provider).to receive(:open).with(browser_type: :chrome).and_return(browser_obj)
68
+ load script, true
69
+ end
70
+ end
@@ -0,0 +1,33 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+
5
+ describe 'domain analysis error propagation' do
6
+ {
7
+ PWN::AI::Agent::Assembly => { type: :asm_to_opcodes, arch: :x64, endian: :little },
8
+ PWN::AI::Agent::BTC => {},
9
+ PWN::AI::Agent::BurpSuite => {},
10
+ PWN::AI::Agent::GQRX => { location: 'offline fixture' },
11
+ PWN::AI::Agent::HackerOne => { type: :scope_details },
12
+ PWN::AI::Agent::SAST => {},
13
+ PWN::AI::Agent::TransparentBrowser => { source_to_review: 'const value = 1;' }
14
+ }.each do |agent, options|
15
+ context agent.to_s do
16
+ it 'preserves validation errors before reflection' do
17
+ expect(PWN::AI::Agent::Reflect).not_to receive(:on)
18
+ expect { agent.analyze(options) }.to raise_error(RuntimeError, 'ERROR: request parameter is required')
19
+ end
20
+
21
+ it 'preserves the provider exception and its original backtrace' do
22
+ failure = IOError.new('offline provider failure')
23
+ failure.set_backtrace(['fixture_provider.rb:12:in `chat`'])
24
+ allow(PWN::AI::Agent::Reflect).to receive(:on).and_raise(failure)
25
+
26
+ expect { agent.analyze(options.merge(request: 'fixture input')) }.to raise_error do |error|
27
+ expect(error).to equal(failure)
28
+ expect(error.backtrace).to eq(['fixture_provider.rb:12:in `chat`'])
29
+ end
30
+ end
31
+ end
32
+ end
33
+ end
@@ -0,0 +1,19 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+
5
+ describe PWN::AI::Agent::Curriculum, 'persisted cooldown' do
6
+ include_context 'pwn tmp sandbox'
7
+
8
+ it 'does not self-play a signature already parked in the JSON cooldown ledger' do
9
+ FileUtils.mkdir_p(described_class::CURRICULUM_DIR)
10
+ stub_const('PWN::AI::Agent::Curriculum::COOLDOWN_FILE', File.join(described_class::CURRICULUM_DIR, 'cooldown.json'))
11
+ stub_const('PWN::AI::Agent::Curriculum::KPI_FILE', File.join(@tmp, 'kpi.jsonl'))
12
+ File.write(described_class::COOLDOWN_FILE, JSON.generate('fixture' => { fail_nights: 3, parked: true }))
13
+ allow(PWN::AI::Agent::Mistakes).to receive(:top).and_return([{ signature: 'fixture', tool: 'shell', count: 4 }])
14
+ expect(described_class).not_to receive(:self_play)
15
+ allow(described_class).to receive(:generate_reproducers).and_return(['offline fixture'])
16
+ result = described_class.practice(limit: 1, dry_run: true)
17
+ expect(result).to include(practiced: 0, skipped_cooldown: 1)
18
+ end
19
+ end
@@ -4,6 +4,8 @@ require 'spec_helper'
4
4
  require 'tmpdir'
5
5
 
6
6
  describe PWN::AI::Agent::Curriculum do
7
+ include_context 'pwn tmp sandbox'
8
+
7
9
  it 'should display information for authors' do
8
10
  authors_response = PWN::AI::Agent::Curriculum
9
11
  expect(authors_response).to respond_to :authors
@@ -0,0 +1,42 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+
5
+ describe PWN::AI::Agent::Engagement, 'persistence 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(described_class::ROOT, 'active'))
12
+ end
13
+
14
+ it 'rejects escaping names before writing either the document or pointer' do
15
+ expect { described_class.open(name: '../outside') }.to raise_error(ArgumentError, /engagement name/i)
16
+ expect(File).not_to exist(File.join(@tmp, 'outside.json'))
17
+ expect(File).not_to exist(described_class::ACTIVE_FILE)
18
+ end
19
+
20
+ it 'rejects escaping explicit and persisted names before reading a document' do
21
+ FileUtils.mkdir_p(described_class::ROOT)
22
+ File.write(File.join(@tmp, 'outside.json'), '{"scope_domains": ["outside.example"]}')
23
+ expect { described_class.status(name: '../outside') }.to raise_error(ArgumentError, /engagement name/i)
24
+ File.write(described_class::ACTIVE_FILE, '../outside')
25
+ expect { described_class.status }.to raise_error(ArgumentError, /engagement name/i)
26
+ end
27
+
28
+ it 'validates a name without changing its spelling' do
29
+ expect(described_class.validate_name(name: 'Lab_2026.v1')).to eq('Lab_2026.v1')
30
+ ['.', '..', '/absolute', 'nested/name', 'nested\\name', "bad\0name", ''].each do |name|
31
+ expect { described_class.validate_name(name: name) }.to raise_error(ArgumentError, /engagement name/i)
32
+ end
33
+ end
34
+
35
+ it 'reserves the active pointer and metadata suffix before creating an engagement' do
36
+ ['active', 'existing.json'].each do |name|
37
+ expect { described_class.open(name: name) }.to raise_error(ArgumentError, /engagement name/i)
38
+ end
39
+ expect(File).not_to exist(described_class::ACTIVE_FILE)
40
+ expect(File).not_to exist(described_class::ROOT)
41
+ end
42
+ end
@@ -0,0 +1,82 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+
5
+ RSpec.describe PWN::AI::Agent::Engagement, 'reviewed dispatch scope' 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
+ @calls = []
13
+ @registry_entries = PWN::AI::Agent::Registry.instance_variable_get(:@entries).dup
14
+ PWN::AI::Agent::Registry.register(
15
+ name: 'fixture_scope', toolset: 'fixture',
16
+ schema: { name: 'fixture_scope', parameters: { type: 'object', properties: {} } },
17
+ handler: lambda { |args|
18
+ @calls << args
19
+ { observation: 'offline fixture' }
20
+ }
21
+ )
22
+ end
23
+
24
+ after do
25
+ PWN::AI::Agent::Registry.instance_variable_set(:@entries, @registry_entries)
26
+ end
27
+
28
+ def dispatch(args)
29
+ JSON.parse(PWN::AI::Agent::Dispatch.call(tool_call: { id: 'scope-fixture', function: { name: 'fixture_scope', arguments: JSON.generate(args) } }))
30
+ end
31
+
32
+ [
33
+ { host: '2001:db8:2::42' },
34
+ { url: 'https://[2001:db8:2::42]:8443/path' },
35
+ { command: 'probe [2001:db8:2::42]:443' },
36
+ { code: "probe(host: '2001:db8:2::42')" },
37
+ { targets: [{ ip: '2001:db8:2::42' }] }
38
+ ].each do |args|
39
+ it "blocks the out-of-scope IPv6 target before executing #{args.keys.first}" do
40
+ described_class.open(name: 'v6', scope_cidrs: ['2001:db8:1::/48'])
41
+ expect(dispatch(args)).to include('success' => false, 'code' => 'SCOPE_DENY')
42
+ expect(@calls).to be_empty
43
+ end
44
+ end
45
+
46
+ [['192.0.2.0/24', '192.0.2.12', '198.51.100.12'], ['2001:db8:2::/48', '2001:db8:2::42', '2001:db8:1::42']].each do |cidr, denied, allowed|
47
+ it "honors CIDR denies through Dispatch for #{cidr}" do
48
+ FileUtils.mkdir_p(File.join(@tmp, '.pwn'))
49
+ File.write(File.join(@tmp, '.pwn', 'roe.yaml'), YAML.dump('targets_deny' => [cidr]))
50
+ expect(dispatch(host: denied)).to include('success' => false)
51
+ expect(@calls).to be_empty
52
+ expect(dispatch(host: allowed)).to include('success' => true)
53
+ end
54
+ end
55
+
56
+ it 'preserves literal accepted names in the active pointer' do
57
+ described_class.open(name: 'lab', scope_domains: ['first.example'])
58
+ row = described_class.open(name: ' lab ', scope_domains: ['second.example'])
59
+ expect(described_class.current_name).to eq(row[:name])
60
+ expect(dispatch(host: 'first.example')).to include('success' => false)
61
+ expect(dispatch(host: 'second.example')).to include('success' => true)
62
+ end
63
+
64
+ it 'rejects explicit empty selectors instead of opting out of the active scope' do
65
+ described_class.open(name: 'lab', scope_domains: ['allowed.example'])
66
+ expect { described_class.in_scope?(name: '', host: 'outside.example') }.to raise_error(ArgumentError, /engagement name/)
67
+ expect { described_class.status(engagement: '') }.to raise_error(ArgumentError, /engagement name/)
68
+ expect(described_class.in_scope?(host: 'outside.example')).to be(false)
69
+ end
70
+
71
+ it 'resolves the engagement alias to the same document through the root wrapper' do
72
+ described_class.open(name: 'first', scope_domains: ['first.example'])
73
+ described_class.open(name: 'second', scope_domains: ['second.example'])
74
+ expect(PWN::Engagement.status(engagement: 'first')).to include(name: 'first', scope_domains: ['first.example'])
75
+ end
76
+
77
+ it 'allows in-scope IPv6 URLs without interpreting the path as a separate host' do
78
+ described_class.open(name: 'v6', scope_cidrs: ['2001:db8:1::/48'])
79
+ expect(dispatch(url: 'https://[2001:db8:1::42]/notes.txt')).to include('success' => true)
80
+ expect(@calls.length).to eq(1)
81
+ end
82
+ end
@@ -0,0 +1,25 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+
5
+ describe PWN::AI::Agent::Engagement, 'RoE parse failures' do
6
+ include_context 'pwn tmp sandbox'
7
+
8
+ before do
9
+ allow(Dir).to receive(:home).and_return(@tmp)
10
+ FileUtils.mkdir_p(File.join(@tmp, '.pwn'))
11
+ end
12
+
13
+ it 'keeps an absent RoE policy optional' do
14
+ expect(described_class.load_roe).to include(present: false)
15
+ end
16
+
17
+ ['targets_allow: [unfinished', '- not a policy mapping', 'false'].each do |document|
18
+ it "does not silently disable enforcement for #{document.inspect}" do
19
+ File.write(File.join(@tmp, '.pwn', 'roe.yaml'), document)
20
+ expect { described_class.load_roe }.to raise_error(ArgumentError, /Invalid RoE policy/)
21
+ expect { described_class.in_scope?(host: 'outside.example') }.to raise_error(ArgumentError, /Invalid RoE policy/)
22
+ expect { described_class.deny_if_out_of_scope(command: 'scan outside.example') }.to raise_error(ArgumentError, /Invalid RoE policy/)
23
+ end
24
+ end
25
+ end
@@ -0,0 +1,37 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+
5
+ describe PWN::AI::Agent::Engagement, 'explicit and IPv6 scope' 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(described_class::ROOT, 'active'))
12
+ end
13
+
14
+ it 'matches IPv6 addresses and bracketed URL hosts without truncating the address' do
15
+ described_class.open(name: 'v6', scope_cidrs: ['2001:db8:1::/48'])
16
+ ['2001:db8:1::42', 'https://[2001:db8:1::42]:8443/report'].each do |target|
17
+ expect(described_class.in_scope?(target: target)).to be(true)
18
+ end
19
+ expect(described_class.in_scope?(ip: '2001:db8:2::42')).to be(false)
20
+ end
21
+
22
+ it 'selects the named scope without switching the active engagement' do
23
+ described_class.open(name: 'first', scope_domains: ['first.example'])
24
+ described_class.open(name: 'second', scope_domains: ['second.example'])
25
+ expect(described_class.in_scope?(name: 'first', host: 'first.example')).to be(true)
26
+ expect(described_class.in_scope?(engagement: 'first', host: 'second.example')).to be(false)
27
+ expect(described_class.current_name).to eq('second')
28
+ end
29
+
30
+ it 'keeps no active scope optional but rejects an explicitly missing engagement' do
31
+ expect(described_class.in_scope?(host: 'fixture.example')).to be(true)
32
+ expect(described_class.in_scope?(name: 'missing', host: 'fixture.example')).to be(false)
33
+ described_class.open(name: 'deleted', scope_domains: ['fixture.example'])
34
+ File.unlink(File.join(described_class::ROOT, 'deleted.json'))
35
+ expect(described_class.in_scope?(host: 'fixture.example')).to be(false)
36
+ end
37
+ end
@@ -3,6 +3,10 @@
3
3
  require 'spec_helper'
4
4
 
5
5
  describe 'PWN::AI::Agent::Extrospection (osint/bridges)' do
6
+ before do
7
+ allow(PWN::AI::Agent::Extrospection).to receive(:bridge_bin).and_return(nil)
8
+ end
9
+
6
10
  it 'should expose BRIDGE_FEEDS for local passive OSINT tools' do
7
11
  e = PWN::AI::Agent::Extrospection
8
12
  expect(e.const_get(:BRIDGE_FEEDS)).to eq(%i[theharvester spiderfoot amass reconng])
@@ -0,0 +1,31 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+
5
+ describe PWN::AI::Agent::Extrospection, 'OSINT input boundaries' do
6
+ include_context 'pwn tmp sandbox'
7
+
8
+ before do
9
+ allow(described_class).to receive(:osint_api_keys).and_return({})
10
+ end
11
+
12
+ it 'extracts NANP groups from this phone number rather than the previous regexp match' do
13
+ result = described_class.osint(query: '+12025550123', feeds: [:phone], record: false)
14
+ expect(result.dig(:feeds, :phone, :nanp)).to eq(area_code: '202', nxx: '555', station: '0123')
15
+ end
16
+
17
+ it 'rejects resource-command injection before invoking a recon-ng process' do
18
+ allow(described_class).to receive(:bridge_bin).and_return('/offline/recon-ng')
19
+ allow(described_class).to receive(:sh).and_return('')
20
+ result = described_class.osint(query: "example.test\nshell unexpected-command", feeds: [:reconng], record: false)
21
+ expect(result.dig(:feeds, :reconng, :error)).to include('domain')
22
+ expect(described_class).not_to have_received(:sh)
23
+ end
24
+
25
+ it 'retains valid email-to-domain bridge queries' do
26
+ allow(described_class).to receive(:bridge_bin).and_return('/offline/recon-ng')
27
+ allow(described_class).to receive(:sh).and_return('service.example.test')
28
+ result = described_class.osint(query: 'analyst@example.test', feeds: [:reconng], record: false)
29
+ expect(result.dig(:feeds, :reconng)).to include(domain: 'example.test', hosts: ['service.example.test'])
30
+ end
31
+ end
@@ -0,0 +1,61 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+
5
+ RSpec.describe PWN::AI::Agent::Extrospection, 'canonical verification review' do
6
+ include_context 'pwn tmp sandbox'
7
+
8
+ before do
9
+ allow(Dir).to receive(:home).and_return(@tmp)
10
+ allow(described_class).to receive(:tls_fingerprint).and_return([nil, nil])
11
+ end
12
+
13
+ def serve_html(html, status = 200)
14
+ response = double('offline HTTP response', body: html, code: status, headers: {})
15
+ browser = double('offline HTTP client')
16
+ allow(browser).to receive(:get).and_yield(response, nil, nil)
17
+ allow(described_class).to receive(:with_headless_browser).and_yield(type: :rest, browser: browser)
18
+ end
19
+
20
+ [
21
+ '<title>Maintenance</title><p>Temporarily unavailable; retry later.</p>',
22
+ '<title>CVE-2026-12345</title><p>Please sign in to continue.</p>',
23
+ '<h1>CVE-2026-12345</h1><p>Checking your browser before accessing the record.</p>',
24
+ '<h1>CVE-2026-54321</h1><h2>Description</h2><p>Synthetic product contains a memory safety flaw.</p>',
25
+ '<h1>CVE-2026-12345</h1><p>Details</p>',
26
+ '<title>Maintenance</title><h1>CVE-2026-12345</h1><h2>Description</h2><p>Service is undergoing planned maintenance.</p>'
27
+ ].each do |html|
28
+ it "keeps noncanonical 200 content unknown: #{html}" do
29
+ serve_html(html)
30
+ expect(described_class.verify(claim: 'CVE-2026-12345', commit: false)).to include(verdict: :unknown, confidence: 0.0)
31
+ end
32
+ end
33
+
34
+ it 'persists unavailable-source decisions as unknown with evidence provenance' do
35
+ serve_html('<title>Unavailable</title><p>Offline fixture</p>', 503)
36
+ result = described_class.verify(claim: 'CVE-2026-12345', commit: true)
37
+ expect(result).to include(verdict: :unknown, action_taken: :learning_note)
38
+ learning = PWN::AI::Agent::Learning
39
+ expect(learning.outcomes(success: false)).to be_empty
40
+ expect(learning.outcomes(success: true)).to be_empty
41
+ row = learning.outcomes.first
42
+ expect(row).to include(success: nil, verdict: 'unknown', training_score: nil, decision_version: 1, status: 'unverified')
43
+ expect(row.dig(:grounded, :evidence).map { |page| page[:status] }).to eq([503, 503])
44
+ end
45
+
46
+ it 'persists an unknown decision when the browser source itself is unavailable' do
47
+ allow(described_class).to receive(:with_headless_browser).and_raise(IOError, 'offline browser unavailable')
48
+ result = described_class.verify(claim: 'CVE-2026-12345', commit: true)
49
+ expect(result).to include(verdict: :unknown, action_taken: :learning_note)
50
+ row = PWN::AI::Agent::Learning.outcomes.first
51
+ expect(row).to include(training_score: nil, status: 'unverified', verdict: 'unknown')
52
+ expect(PWN::AI::Agent::Learning.outcomes(success: false)).to be_empty
53
+ end
54
+
55
+ it 'confirms record identity only when canonical description content exists' do
56
+ serve_html('<h1>CVE-2026-12345</h1><h2>Description</h2><p data-testid="vuln-description">Synthetic fixture product contains a memory safety flaw.</p>')
57
+ result = described_class.verify(claim: 'CVE-2026-12345', commit: false)
58
+ expect(result).to include(verdict: :confirmed)
59
+ expect(result[:evidence].map { |row| row[:dom_sha] }).to all(match(/\A[0-9a-f]{16}\z/))
60
+ end
61
+ end
@@ -0,0 +1,42 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+ require 'timeout'
5
+
6
+ RSpec.describe PWN::AI::Agent::Extrospection, 'serial buffer ownership' do
7
+ include_context 'pwn tmp sandbox'
8
+
9
+ it 'senses its own connection while preserving another live session buffer' do
10
+ serial = PWN::Plugins::Serial
11
+ first_reader, first_writer = IO.pipe
12
+ second_reader, second_writer = IO.pipe
13
+ first_path = File.join(@tmp, 'first-serial-fixture')
14
+ second_path = File.join(@tmp, 'second-serial-fixture')
15
+ [first_path, second_path].each { |path| File.write(path, '') }
16
+ allow(UART).to receive(:open).with(first_path, 9600, '8N1').and_return(first_reader)
17
+ allow(UART).to receive(:open).with(second_path, 9600, '8N1').and_return(second_reader)
18
+ allow(second_reader).to receive(:ioctl).and_return(0)
19
+ allow(Termios).to receive(:tcgetattr).with(second_reader).and_return(double('attributes', ospeed: Termios::B9600, cflag: Termios::CS8))
20
+ first = serial.connect(block_dev: first_path)
21
+ first_writer.write('first-buffer')
22
+ Timeout.timeout(2) { Thread.pass until serial.dump_session_data(serial_obj: first).join == 'first-buffer' }
23
+ second = nil
24
+ allow(serial).to receive(:connect).and_wrap_original do |original, opts|
25
+ second = original.call(opts)
26
+ end
27
+ allow(described_class).to receive(:probe_serial).and_return([])
28
+ allow(described_class).to receive(:sleep) do
29
+ second_writer.write('second-buffer')
30
+ Timeout.timeout(2) { Thread.pass until serial.dump_session_data(serial_obj: second).join == 'second-buffer' }
31
+ end
32
+ result = described_class.serial_sense(block_dev: second_path, settle_secs: 0.2, record: false)
33
+ expect(result).to include(ok: true, text: 'second-buffer')
34
+ expect(serial.dump_session_data(serial_obj: first).join).to eq('first-buffer')
35
+ expect(first_reader).not_to be_closed
36
+ expect(second_reader).to be_closed
37
+ ensure
38
+ serial.disconnect(serial_obj: first) if first
39
+ serial.disconnect(serial_obj: second) if second
40
+ [first_reader, first_writer, second_reader, second_writer].compact.each { |io| io.close unless io.closed? }
41
+ end
42
+ end
@@ -1,8 +1,17 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  require 'spec_helper'
4
+ require 'rest-client'
4
5
 
5
6
  describe PWN::AI::Agent::Extrospection do
7
+ include_context 'pwn tmp sandbox'
8
+
9
+ before do
10
+ allow(RestClient::Request).to receive(:execute).and_raise(IOError, 'offline fixture')
11
+ allow(PWN::Plugins::VIN).to receive(:decode_vin).and_raise(IOError, 'offline fixture')
12
+ allow(described_class).to receive(:sh).and_return('')
13
+ end
14
+
6
15
  it 'should display information for authors' do
7
16
  authors_response = PWN::AI::Agent::Extrospection
8
17
  expect(authors_response).to respond_to :authors
@@ -0,0 +1,39 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+
5
+ describe PWN::AI::Agent::Extrospection, 'unavailable verification sources' do
6
+ include_context 'pwn tmp sandbox'
7
+
8
+ before do
9
+ allow(described_class).to receive(:with_headless_browser).and_yield(:offline_browser)
10
+ expect(PWN::AI::Agent::Mistakes).not_to receive(:record)
11
+ end
12
+
13
+ [nil, { reachable: false, status: 0, text: '' }, { reachable: false, status: 503, text: 'Service unavailable' }, { reachable: true, status: 200, text: '' }].each do |page|
14
+ it "does not label a CVE confirmed or refuted from #{page.inspect}" do
15
+ allow(described_class).to receive(:fingerprint_page) { page&.dup }
16
+ result = described_class.verify(claim: 'CVE-2026-12345', kind: :cve, commit: false)
17
+ expect(result).to include(verdict: :unknown, confidence: 0.0)
18
+ end
19
+
20
+ it "does not refute a document claim from #{page.inspect}" do
21
+ allow(described_class).to receive(:fingerprint_page) { page&.dup }
22
+ result = described_class.verify(claim: 'fixture documentation explains syntax', url: 'https://example.test/docs', commit: false)
23
+ expect(result).to include(verdict: :unknown, confidence: 0.0)
24
+ end
25
+ end
26
+
27
+ it 'still confirms a CVE using reachable source text' do
28
+ allow(described_class).to receive(:fingerprint_page) do |opts|
29
+ { reachable: true, status: 200, url: opts[:url], text: 'CVE-2026-12345 Description: Synthetic fixture product contains a memory safety flaw.' }
30
+ end
31
+ expect(described_class.verify(claim: 'CVE-2026-12345', commit: false)).to include(verdict: :confirmed)
32
+ end
33
+
34
+ it 'still refutes a missing document from an explicit not-found response' do
35
+ allow(described_class).to receive(:fingerprint_page) { { reachable: false, status: 404, text: 'Not found' } }
36
+ result = described_class.verify(claim: 'fixture documentation', url: 'https://example.test/missing', commit: false)
37
+ expect(result).to include(verdict: :refuted)
38
+ end
39
+ end
@@ -0,0 +1,32 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+
5
+ describe 'last-assistant learning paths' do
6
+ include_context 'pwn tmp sandbox'
7
+
8
+ let(:transcript) do
9
+ [
10
+ { role: 'user', content: 'first task' },
11
+ { role: 'assistant', content: 'older answer' },
12
+ { role: 'user', content: 'second task' },
13
+ { role: 'assistant', content: 'latest answer' },
14
+ { role: 'user', content: 'no, that is wrong' }
15
+ ]
16
+ end
17
+
18
+ before do
19
+ allow(PWN::Sessions).to receive(:load).with(session_id: 'fixture-session').and_return(transcript)
20
+ end
21
+
22
+ it 'extracts the latest answer for provider-free reflection without mutating the transcript' do
23
+ result = PWN::AI::Agent::Learning.reflect(session_id: 'fixture-session', dry_run: true)
24
+ expect(result[:lessons].map { |row| row[:lesson] }).to eq(['Approach that worked: latest answer'])
25
+ expect(transcript.last[:role]).to eq('user')
26
+ end
27
+
28
+ it 'retains the actual rejected answer for correction preference capture' do
29
+ PWN::AI::Agent::Mistakes.check_user_correction(request: 'no, that is wrong', session_id: 'fixture-session')
30
+ expect(Thread.current[:pwn_pending_pref]).to include(prompt: 'second task', rejected: 'latest answer')
31
+ end
32
+ end
@@ -0,0 +1,84 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'spec_helper'
4
+
5
+ RSpec.describe PWN::AI::Agent::Learning, 'lifecycle publication compatibility' do
6
+ include_context 'pwn tmp sandbox'
7
+
8
+ before do
9
+ allow(Dir).to receive(:home).and_return(@tmp)
10
+ root = File.join(@tmp, '.pwn')
11
+ FileUtils.mkdir_p(root)
12
+ stub_const('PWN::Sessions::SESSIONS_DIR', File.join(root, 'sessions'))
13
+ stub_const('PWN::AI::Agent::Learning::LEARNING_FILE', File.join(root, 'learning.jsonl'))
14
+ end
15
+
16
+ [false, true].each do |dry|
17
+ ['{unparseable evidence', '[1,2]'].each do |invalid|
18
+ it "AI-LR-L07 preserves uncertain evidence and reports a blocked #{dry ? 'preview' : 'apply'} for #{invalid}" do
19
+ good = JSON.generate(id: 'good', task: 'retained task', success: false, details: 'fixture', timestamp: '2020-01-01T00:00:00Z')
20
+ bytes = "#{good}\n#{invalid}\n"
21
+ File.write(described_class::LEARNING_FILE, bytes)
22
+ inode = File.stat(described_class::LEARNING_FILE).ino
23
+ result = described_class.prune_outcomes!(dry_run: dry)
24
+ expect(File.binread(described_class::LEARNING_FILE)).to eq(bytes.b)
25
+ expect(File.stat(described_class::LEARNING_FILE).ino).to eq(inode)
26
+ expect(result).to include(state: 'blocked', aborted: true, malformed_rows: 1, removed: 0, kept: 2)
27
+ end
28
+ end
29
+ end
30
+
31
+ it 'binds archived PRM publication to the original turn through the actual Reward caller' do
32
+ session = PWN::Sessions.create
33
+ PWN::Sessions.append(session_id: session[:id], role: 'user', content: 'first request')
34
+ PWN::Sessions.append(session_id: session[:id], role: 'tool', content: 'first tool')
35
+ snapshot = PWN::AI::Agent::Reward.prm_snapshot(session_id: session[:id], request: 'first request')
36
+ PWN::Sessions.append(session_id: session[:id], role: 'user', content: 'later request')
37
+ PWN::Sessions.append(session_id: session[:id], role: 'tool', content: 'later tool')
38
+ described_class.note_outcome(task: 'retained evidence', success: false, session_id: session[:id])
39
+ described_class.migrate_evidence(dry_run: false)
40
+ original_row = described_class.outcomes.first
41
+ PWN::Sessions.delete(session_id: session[:id], force: true)
42
+ result = PWN::AI::Agent::Reward.send(:annotate_session, session_id: session[:id], rewards: [1], binding: snapshot[:binding])
43
+ expect(result).to include(annotated: true, binding_sha256: Digest::SHA256.hexdigest(JSON.generate(snapshot[:binding])))
44
+ expect(PWN::Sessions.load(session_id: session[:id]).select { |row| row[:role] == 'tool' }.map { |row| row[:step_reward] }).to eq([1, nil])
45
+ expect(described_class.evidence_transcript(row: original_row).select { |row| row[:role] == 'tool' }.map { |row| row[:step_reward] }).to eq([nil, nil])
46
+ end
47
+
48
+ it 'rejects a stale archived PRM binding before any index or snapshot publication' do
49
+ session = PWN::Sessions.create
50
+ PWN::Sessions.append(session_id: session[:id], role: 'user', content: 'request')
51
+ PWN::Sessions.append(session_id: session[:id], role: 'tool', content: 'tool')
52
+ binding = PWN::AI::Agent::Reward.prm_snapshot(session_id: session[:id], request: 'request')[:binding].merge(prefix_sha256: 'f' * 64)
53
+ described_class.note_outcome(task: 'retained evidence', success: false, session_id: session[:id])
54
+ described_class.migrate_evidence(dry_run: false)
55
+ PWN::Sessions.delete(session_id: session[:id], force: true)
56
+ before = File.binread(described_class::LEARNING_FILE)
57
+ result = described_class.annotate_evidence(session_id: session[:id], rewards: [1], binding: binding)
58
+ expect(result).to include(annotated: false, reason: :stale_binding)
59
+ expect(File.binread(described_class::LEARNING_FILE)).to eq(before)
60
+ end
61
+
62
+ it 'preserves opaque manual identifiers without inventing a source transcript' do
63
+ row = described_class.note_outcome(task: 'manual assessment', session_id: 'sess-p20-hi', success: false)
64
+ expect(row[:session_id]).to eq('sess-p20-hi')
65
+ expect(File).not_to exist(File.join(PWN::Sessions::SESSIONS_DIR, 'sess-p20-hi.jsonl'))
66
+ expect(described_class.outcomes.first[:session_id]).to eq('sess-p20-hi')
67
+ end
68
+
69
+ it 'binds a new canonical outcome to verified archived evidence after source deletion' do
70
+ session = PWN::Sessions.create
71
+ described_class.note_outcome(task: 'initial assessment', session_id: session[:id], success: false)
72
+ described_class.migrate_evidence(dry_run: false)
73
+ expected = described_class.session_evidence(session_id: session[:id])
74
+ PWN::Sessions.delete(session_id: session[:id], force: true)
75
+ row = described_class.note_outcome(task: 'offline reassessment', session_id: session[:id], success: false)
76
+ expect(described_class.evidence_transcript(row: row)).to eq(expected)
77
+ expect(described_class.evidence_complete?(row: row)).to be(true)
78
+ end
79
+
80
+ it 'rejects missing canonical evidence without publishing a dangling reference' do
81
+ expect { described_class.note_outcome(task: 'missing source', session_id: '20000101_000000_aabbccdd', success: false) }.to raise_error(IOError)
82
+ expect(described_class.outcomes).to eq([])
83
+ end
84
+ end