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
@@ -10,7 +10,7 @@ module PWN
10
10
  module MSR206
11
11
  # Logger instance for auditing and debugging
12
12
  private_class_method def self.logger
13
- @logger ||= Logger.new('/tmp/pwn-msr206.log')
13
+ @logger ||= Logger.new(File::NULL)
14
14
  end
15
15
 
16
16
  # Supported Method Parameters::
@@ -24,12 +24,7 @@ module PWN
24
24
  # )
25
25
 
26
26
  public_class_method def self.connect(opts = {})
27
- opts[:block_dev] ||= '/dev/ttyUSB0'
28
- opts[:baud] ||= 19_200 # Align with device default
29
- opts[:data_bits] ||= 8
30
- opts[:stop_bits] ||= 1
31
- opts[:parity] ||= :none
32
- opts[:flow_control] ||= :soft
27
+ opts = { block_dev: '/dev/ttyUSB0', baud: 19_200, data_bits: 8, stop_bits: 1, parity: :none, flow_control: :soft }.merge(opts)
33
28
 
34
29
  logger.info("Connecting to #{opts[:block_dev]} at baud #{opts[:baud]}")
35
30
  msr206_obj = PWN::Plugins::Serial.connect(opts)
@@ -429,7 +424,7 @@ module PWN
429
424
  logger.error("Error parsing response for command #{cmd}: #{e.message}")
430
425
  raise e
431
426
  ensure
432
- PWN::Plugins::Serial.flush_session_data
427
+ PWN::Plugins::Serial.flush_session_data(serial_obj: msr206_obj) if msr206_obj
433
428
  end
434
429
 
435
430
  # Supported Method Parameters::
@@ -441,6 +436,8 @@ module PWN
441
436
  public_class_method def self.set_protocol(opts = {})
442
437
  msr206_obj = opts[:msr206_obj]
443
438
  protocol = opts[:protocol] || :usi0
439
+ raise ArgumentError, 'protocol must be :usi0 or :usi1' unless %i[usi0 usi1].include?(protocol)
440
+
444
441
  cmd = protocol == :usi0 ? :proto_usi0 : :proto_usi1
445
442
  logger.info("Setting protocol to #{protocol}")
446
443
  exec(msr206_obj: msr206_obj, cmd: cmd)
@@ -462,7 +459,7 @@ module PWN
462
459
  params = opts[:params]
463
460
  raise 'ERROR: params argument must be a byte array (e.g. [0x41]).' if params && !params.instance_of?(Array)
464
461
 
465
- logger.info("Executing command: #{cmd} with params: #{params.inspect}")
462
+ logger.info('Executing device command')
466
463
 
467
464
  params_bytes = []
468
465
  case cmd.to_sym
@@ -594,13 +591,13 @@ module PWN
594
591
  cmd: cmd.to_sym,
595
592
  cmd_bytes: cmd_bytes
596
593
  )
597
- logger.info("Response for #{cmd}: #{response.inspect}")
594
+ logger.info('Device command response received')
598
595
  response
599
596
  rescue StandardError => e
600
597
  logger.error("Error executing command #{cmd}: #{e.message}")
601
598
  raise e
602
599
  ensure
603
- PWN::Plugins::Serial.flush_session_data
600
+ PWN::Plugins::Serial.flush_session_data(serial_obj: msr206_obj) if msr206_obj
604
601
  end
605
602
 
606
603
  # Supported Method Parameters::
@@ -616,6 +613,8 @@ module PWN
616
613
  type = opts[:type].to_s.scrub.strip.chomp.to_sym
617
614
  encoding = opts[:encoding].to_s.scrub.strip.chomp.to_sym
618
615
  track_data = opts[:track_data]
616
+ plan = opts[:write_plan]
617
+ plan ||= write_plan(encoding: encoding, track_data: track_data) if type.to_s.start_with?('arm_to_write')
619
618
 
620
619
  logger.info("Waiting for swipe: type=#{type}, encoding=#{encoding}")
621
620
 
@@ -635,7 +634,7 @@ module PWN
635
634
  case type
636
635
  when :arm_to_read, :arm_to_read_w_speed_prompts
637
636
  exec_resp = exec(msr206_obj: msr206_obj, cmd: type)
638
- logger.info("Arm to read response: #{exec_resp.inspect}")
637
+ logger.info('Reader armed')
639
638
 
640
639
  print 'Reader Activated. Please Swipe Card...'
641
640
  loop do
@@ -644,149 +643,26 @@ module PWN
644
643
  break if exec_resp[:msg] == :ack_command_completed
645
644
  end
646
645
 
647
- case encoding
648
- when :iso
649
- cmds_arr = %i[
650
- tx_iso_std_data_track1
651
- tx_iso_std_data_track2
652
- tx_iso_std_data_track3
653
- ]
654
- cmds_arr.each do |cmd|
655
- puts "\n*** #{cmd.to_s.gsub('_', ' ').upcase} #{'*' * 17}"
656
- exec_resp = exec(msr206_obj: msr206_obj, cmd: cmd)
646
+ read_commands(encoding: encoding).each_with_index do |cmd, index|
647
+ formats = opts[:track_formats] ? [opts[:track_formats][index]] : available_formats(encoding: encoding)
648
+ formats.each do |format|
649
+ exec_resp = exec(msr206_obj: msr206_obj, cmd: cmd, params: format)
657
650
  exec_resp[:encoding] = encoding
658
- puts exec_resp[:decoded]
659
- puts exec_resp.inspect
651
+ exec_resp[:track] = index + 1
652
+ exec_resp[:track_format] = format.dup
660
653
  track_data_arr.push(exec_resp)
661
654
  end
662
- when :iso_alt
663
- cmds_arr = %i[
664
- alt_tx_iso_std_data_track1
665
- alt_tx_iso_std_data_track2
666
- alt_tx_iso_std_data_track3
667
- ]
668
- cmds_arr.each do |cmd|
669
- params_arr = [0x31, 0x32, 0x33]
670
- params_arr.each do |param|
671
- puts "\n*** #{cmd.to_s.gsub('_', ' ').upcase} #{'*' * 17}"
672
- exec_resp = exec(msr206_obj: msr206_obj, cmd: cmd, params: [param])
673
- exec_resp[:encoding] = encoding
674
- exec_resp[:track_format] = [param]
675
- puts exec_resp[:decoded]
676
- puts exec_resp.inspect
677
- track_data_arr.push(exec_resp)
678
- end
679
- end
680
- when :raw
681
- cmds_arr = %i[
682
- tx_custom_data_forward_track1
683
- tx_custom_data_forward_track2
684
- tx_custom_data_forward_track3
685
- ]
686
- cmds_arr.each do |cmd|
687
- params_arr = [0x33, 0x34, 0x35, 0x36, 0x37]
688
- params_arr.each do |param|
689
- puts "\n*** #{cmd.to_s.gsub('_', ' ').upcase} #{'*' * 17}"
690
- exec_resp = exec(msr206_obj: msr206_obj, cmd: cmd, params: [param])
691
- exec_resp[:encoding] = encoding
692
- exec_resp[:track_format] = [param]
693
- puts exec_resp[:decoded]
694
- puts exec_resp.inspect
695
- track_data_arr.push(exec_resp)
696
-
697
- param = [0x5f] + [param]
698
- exec_resp = exec(msr206_obj: msr206_obj, cmd: cmd, params: param)
699
- exec_resp[:encoding] = encoding
700
- exec_resp[:track_format] = param
701
- puts exec_resp[:decoded]
702
- puts exec_resp.inspect
703
- track_data_arr.push(exec_resp)
704
- end
705
- end
706
- else
707
- logger.error("Unsupported encoding: #{encoding}")
708
- raise "Unsupported encoding: #{encoding}"
709
655
  end
710
656
 
711
657
  when :arm_to_write_no_raw, :arm_to_write_with_raw, :arm_to_write_with_raw_speed_prompts
712
- unless track_data.is_a?(Array) && track_data.all? { |t| t.is_a?(Hash) && t.key?(:decoded) }
713
- logger.error('Invalid track_data: must be an array of hashes with :decoded key')
714
- raise 'Invalid track_data: must be an array of hashes with :decoded key'
715
- end
716
-
717
- case encoding
718
- when :iso
719
- cmds_arr = %i[
720
- load_iso_std_data_for_writing_track1
721
- load_iso_std_data_for_writing_track2
722
- load_iso_std_data_for_writing_track3
723
- ]
724
- cmds_arr.each_with_index do |cmd, track|
725
- puts "\n*** #{cmd.to_s.gsub('_', ' ').upcase} #{'*' * 17}"
726
- # next unless track_data[track]&.key?(:decoded) && track_data[track][:decoded]&.strip&.length&.positive?
727
-
728
- this_track = track_data[track][:decoded].chars.map do |c|
729
- c.unpack1('H*').to_i(16)
730
- end
731
- track_eot = [0x04]
732
- track_payload = this_track + track_eot
733
- puts track_payload.inspect
734
- exec_resp = exec(msr206_obj: msr206_obj, cmd: cmd, params: track_payload)
735
- exec_resp[:encoding] = encoding
736
- puts exec_resp.inspect
737
- track_data_arr.push(exec_resp)
738
- end
739
- when :iso_alt
740
- cmds_arr = %i[
741
- alt_load_iso_std_data_for_writing_track1
742
- alt_load_iso_std_data_for_writing_track2
743
- alt_load_iso_std_data_for_writing_track3
744
- ]
745
- cmds_arr.each_with_index do |cmd, track|
746
- puts "\n*** #{cmd.to_s.gsub('_', ' ').upcase} #{'*' * 17}"
747
- # next unless track_data[track]&.key?(:decoded) && track_data[track][:decoded]&.strip&.length&.positive?
748
-
749
- this_track = track_data[track][:decoded].chars.map do |c|
750
- c.unpack1('H*').to_i(16)
751
- end
752
- track_format = track_data[track][:track_format] || [0x31]
753
- track_eot = [0x04]
754
- track_payload = track_format + this_track + track_eot
755
- puts track_payload.inspect
756
- exec_resp = exec(msr206_obj: msr206_obj, cmd: cmd, params: track_payload)
757
- exec_resp[:encoding] = encoding
758
- puts exec_resp.inspect
759
- track_data_arr.push(exec_resp)
760
- end
761
- when :raw
762
- cmds_arr = %i[
763
- load_custom_data_for_writing_track1
764
- load_custom_data_for_writing_track2
765
- load_custom_data_for_writing_track3
766
- ]
767
- cmds_arr.each_with_index do |cmd, track|
768
- puts "\n*** #{cmd.to_s.gsub('_', ' ').upcase} #{'*' * 17}"
769
- # next unless track_data[track]&.key?(:decoded) && track_data[track][:decoded]&.strip&.length&.positive?
770
-
771
- this_track = track_data[track][:decoded].chars.map do |c|
772
- c.unpack1('H*').to_i(16)
773
- end
774
- track_format = track_data[track][:track_format] || [0x33]
775
- track_eot = [0x04]
776
- track_payload = track_format + this_track + track_eot
777
- puts track_payload.inspect
778
- exec_resp = exec(msr206_obj: msr206_obj, cmd: cmd, params: track_payload)
779
- exec_resp[:encoding] = encoding
780
- puts exec_resp.inspect
781
- track_data_arr.push(exec_resp)
782
- end
783
- else
784
- logger.error("Unsupported encoding: #{encoding}")
785
- raise "Unsupported encoding: #{encoding}"
658
+ plan.each do |track|
659
+ exec_resp = exec(msr206_obj: msr206_obj, cmd: track[:load_cmd], params: track[:payload])
660
+ exec_resp[:encoding] = encoding
661
+ track_data_arr.push(exec_resp)
786
662
  end
787
663
 
788
664
  exec_resp = exec(msr206_obj: msr206_obj, cmd: type)
789
- logger.info("Arm to write response: #{exec_resp.inspect}")
665
+ logger.info('Writer armed')
790
666
 
791
667
  print 'Writer Activated. Please Swipe Card...'
792
668
  loop do
@@ -803,7 +679,90 @@ module PWN
803
679
  logger.error("Error in wait_for_swipe: #{e.message}")
804
680
  raise e
805
681
  ensure
806
- exec(msr206_obj: msr206_obj, cmd: :green_off)
682
+ exec(msr206_obj: msr206_obj, cmd: :green_off) if exec_resp
683
+ end
684
+
685
+ private_class_method def self.available_formats(opts = {})
686
+ case opts[:encoding]
687
+ when :iso then [[]]
688
+ when :iso_alt then [[0x31], [0x32], [0x33]]
689
+ when :raw then (0x33..0x37).flat_map { |byte| [[byte], [0x5f, byte]] }
690
+ else raise ArgumentError, 'encoding must be iso, iso_alt or raw'
691
+ end
692
+ end
693
+
694
+ private_class_method def self.read_commands(opts = {})
695
+ prefix = { iso: 'tx_iso_std_data', iso_alt: 'alt_tx_iso_std_data', raw: 'tx_custom_data_forward' }.fetch(opts[:encoding])
696
+ (1..3).map { |track| :"#{prefix}_track#{track}" }
697
+ end
698
+
699
+ private_class_method def self.selected_formats(opts = {})
700
+ formats = opts[:track_formats]
701
+ raise ArgumentError, 'track_formats must select exactly three formats' unless formats.is_a?(Array) && formats.length == 3
702
+
703
+ formats.map { |format| track_format(encoding: opts[:encoding], value: format) }.freeze
704
+ end
705
+
706
+ private_class_method def self.track_format(opts = {})
707
+ encoding = opts[:encoding]
708
+ allowed = available_formats(encoding: encoding)
709
+ value = opts.fetch(:value, allowed.first)
710
+ raise ArgumentError, 'Invalid track_format for selected encoding' unless value.is_a?(Array) && value.all?(Integer) && allowed.include?(value)
711
+
712
+ value.dup.freeze
713
+ end
714
+
715
+ private_class_method def self.select_tracks(opts = {})
716
+ tracks = opts[:track_data]
717
+ return tracks unless tracks.is_a?(Array) && tracks.length > 3
718
+
719
+ encoding = opts[:encoding]
720
+ formats = opts[:track_formats]
721
+ raise ArgumentError, 'Candidate backups require explicit track_formats for three tracks' unless formats
722
+
723
+ commands = read_commands(encoding: encoding)
724
+ identities = tracks.map do |track|
725
+ raise ArgumentError, 'Malformed track candidate' unless track.is_a?(Hash) && track[:decoded].is_a?(String) && commands.map(&:to_s).include?(track[:cmd].to_s)
726
+
727
+ format = track_format(encoding: encoding, value: track[:track_format])
728
+ [track[:cmd].to_s, format]
729
+ end
730
+ raise ArgumentError, 'Duplicate track format candidates' unless identities.uniq.length == identities.length
731
+
732
+ commands.each_with_index.map do |cmd, index|
733
+ match = identities.index([cmd.to_s, formats[index]])
734
+ raise ArgumentError, 'Selected track format is absent from backup' unless match
735
+
736
+ tracks[match]
737
+ end
738
+ end
739
+
740
+ private_class_method def self.write_plan(opts = {})
741
+ tracks = opts[:track_data]
742
+ encoding = opts[:encoding]
743
+ formats = selected_formats(opts) if opts.key?(:track_formats)
744
+ tracks = select_tracks(track_data: tracks, encoding: encoding, track_formats: formats)
745
+ raise ArgumentError, 'track_data must contain exactly three tracks with decoded Strings' unless tracks.is_a?(Array) && tracks.length == 3 && tracks.all? { |track| track.is_a?(Hash) && track[:decoded].is_a?(String) }
746
+
747
+ prefix = { iso: 'load_iso_std_data_for_writing', iso_alt: 'alt_load_iso_std_data_for_writing', raw: 'load_custom_data_for_writing' }.fetch(encoding)
748
+ tracks.each_with_index.map do |track, index|
749
+ format_options = { encoding: encoding }
750
+ format_options[:value] = formats[index] if formats
751
+ format_options[:value] = track[:track_format] if track.key?(:track_format)
752
+ format = track_format(format_options)
753
+ raise ArgumentError, 'track_formats conflicts with track_data' if formats && formats[index] != format
754
+ raise ArgumentError, 'Track command identity does not match its position' if track[:cmd] && track[:cmd].to_s != read_commands(encoding: encoding)[index].to_s
755
+ raise ArgumentError, 'Track encoding does not match selected encoding' if track[:encoding] && track[:encoding].to_s != encoding.to_s
756
+
757
+ decoded = track[:decoded].b.freeze
758
+ # This decoded-text API is not a binary-track passthrough. Bound the
759
+ # supported host payload and reject wire terminators before any IO.
760
+ maximum = encoding == :iso ? [79, 40, 107][index] : 255
761
+ raise ArgumentError, 'Invalid or oversized decoded track payload' unless decoded.bytesize <= maximum && decoded.bytes.all? { |byte| byte.between?(0x20, 0x7e) }
762
+
763
+ { decoded: decoded, track_format: format, load_cmd: :"#{prefix}_track#{index + 1}",
764
+ payload: (format + decoded.bytes + [0x04]).freeze }.freeze
765
+ end.freeze
807
766
  end
808
767
 
809
768
  # Supported Method Parameters::
@@ -815,8 +774,9 @@ module PWN
815
774
  msr206_obj = opts[:msr206_obj]
816
775
  logger.info('Starting read_card')
817
776
 
818
- encoding = :waiting_for_selection
819
- loop do
777
+ encoding = opts.key?(:encoding) ? opts[:encoding].to_s.to_sym : :waiting_for_selection
778
+ available_formats(encoding: encoding) unless encoding == :waiting_for_selection
779
+ while encoding == :waiting_for_selection
820
780
  puts "\nENCODING OPTIONS:"
821
781
  puts '[(I)SO Standard]'
822
782
  puts '[(A)LT ISO Standard]'
@@ -837,12 +797,14 @@ module PWN
837
797
  end
838
798
  end
839
799
 
800
+ formats = selected_formats(encoding: encoding, track_formats: opts[:track_formats]) if opts.key?(:track_formats)
840
801
  track_data = wait_for_swipe(
841
802
  msr206_obj: msr206_obj,
842
803
  type: :arm_to_read,
843
- encoding: encoding
804
+ encoding: encoding,
805
+ track_formats: formats
844
806
  )
845
- logger.info("Read card successful: #{track_data.inspect}")
807
+ logger.info('Read card completed')
846
808
  track_data
847
809
  rescue StandardError => e
848
810
  logger.error("Error reading card: #{e.message}")
@@ -890,13 +852,19 @@ module PWN
890
852
  # PWN::Plugins::MSR206.write_card(
891
853
  # msr206_obj: 'required - msr206_obj returned from #connect method',
892
854
  # encoding: 'required - :iso || :iso_alt || :raw',
893
- # track_data: 'required - track data to write (see #backup_card for structure)'
855
+ # track_data: 'required - three printable decoded tracks, or backup candidates with explicit track_formats',
856
+ # track_formats: 'optional - three selected format arrays: ISO [], alternate [0x31..0x33], raw [0x33..0x37] optionally prefixed by 0x5f; required for candidate backups'
894
857
  # )
895
858
 
896
859
  public_class_method def self.write_card(opts = {})
897
860
  msr206_obj = opts[:msr206_obj]
898
861
  encoding = opts[:encoding].to_s.scrub.strip.chomp.to_sym
899
862
  track_data = opts[:track_data]
863
+ raise ArgumentError, 'encoding must be iso, iso_alt or raw' unless %i[iso iso_alt raw].include?(encoding)
864
+
865
+ plan_options = { encoding: encoding, track_data: track_data }
866
+ plan_options[:track_formats] = opts[:track_formats] if opts.key?(:track_formats)
867
+ plan = write_plan(plan_options)
900
868
 
901
869
  logger.info("Starting write_card with encoding: #{encoding}")
902
870
  puts 'IN ORDER TO GET BLANK TRACKS, A STRONG MAGNETIC FIELD MUST BE PRESENT TO FIRST WIPE THE CARD TARGETED FOR WRITING.'
@@ -949,32 +917,31 @@ module PWN
949
917
 
950
918
  exec(msr206_obj: msr206_obj, cmd: :set_temp_write_current, params: coercivity)
951
919
 
952
- track_data = wait_for_swipe(
920
+ wait_for_swipe(
953
921
  msr206_obj: msr206_obj,
954
- type: :arm_to_write_no_raw,
922
+ type: encoding == :raw ? :arm_to_write_with_raw : :arm_to_write_no_raw,
955
923
  encoding: encoding,
956
- track_data: track_data
924
+ write_plan: plan
957
925
  )
958
926
 
959
927
  # Verify write
960
928
  exec_resp = exec(msr206_obj: msr206_obj, cmd: :write_verify)
961
- if exec_resp[:msg] == :ack_command_completed
962
- puts 'Write verification successful.'
963
- logger.info('Write verification successful')
964
- else
965
- puts "Write verification failed: #{exec_resp[:msg]}"
966
- logger.error("Write verification failed: #{exec_resp[:msg]}")
967
- end
929
+ raise IOError, 'Card write verification failed; inspect the device before retrying' unless exec_resp[:msg] == :ack_command_completed
930
+
931
+ puts 'Write verification successful.'
932
+ logger.info('Write verification successful')
968
933
 
969
934
  # Re-read card to confirm
970
- read_data = read_card(msr206_obj: msr206_obj)
971
- if read_data.map { |t| t[:decoded] } == track_data.map { |t| t[:decoded] }
972
- puts 'Card data matches written data.'
973
- logger.info('Card data matches written data')
974
- else
975
- puts 'ERROR: Written data does not match read data.'
976
- logger.error('Written data does not match read data')
935
+ read_data = read_card(msr206_obj: msr206_obj, encoding: encoding, track_formats: plan.map { |track| track[:track_format] })
936
+ commands = read_commands(encoding: encoding)
937
+ matches = read_data.length == 3 && read_data.each_with_index.all? do |track, index|
938
+ track[:msg] == :response && track[:cmd] == commands[index] && track[:encoding] == encoding &&
939
+ track[:track_format] == plan[index][:track_format] && track[:decoded].b == plan[index][:decoded]
977
940
  end
941
+ raise IOError, 'Card write readback mismatch; inspect the device before retrying' unless matches
942
+
943
+ puts 'Card data matches written data.'
944
+ logger.info('Card data matches written data')
978
945
 
979
946
  exec(msr206_obj: msr206_obj, cmd: :simulate_power_cycle_warm_reset)
980
947
  track_data
@@ -993,9 +960,10 @@ module PWN
993
960
  logger.info('Starting clone_card')
994
961
 
995
962
  track_data = backup_card(msr206_obj: msr206_obj)
996
- encoding = track_data.first[:encoding] if track_data.length == 3
963
+ encoding = track_data.first[:encoding]
997
964
  write_card(
998
965
  msr206_obj: msr206_obj,
966
+ **(opts.key?(:track_formats) ? { track_formats: opts[:track_formats] } : {}),
999
967
  encoding: encoding,
1000
968
  track_data: track_data
1001
969
  )
@@ -1034,6 +1002,7 @@ module PWN
1034
1002
  encoding = track_data.first[:encoding] || :iso
1035
1003
  write_card(
1036
1004
  msr206_obj: msr206_obj,
1005
+ **(opts.key?(:track_formats) ? { track_formats: opts[:track_formats] } : {}),
1037
1006
  encoding: encoding,
1038
1007
  track_data: track_data
1039
1008
  )
@@ -1068,14 +1037,14 @@ module PWN
1068
1037
  # Update each track's decoded value
1069
1038
  track_data.each_with_index do |track, index|
1070
1039
  decoded = track[:decoded]
1071
- puts "\nTrack #{index + 1} Current Value: #{decoded}"
1040
+ puts "\nTrack #{index + 1} (current value withheld)"
1072
1041
  print 'Enter Updated Value (press Enter to keep original): '
1073
1042
  updated_value = gets.scrub.chomp.strip
1074
1043
 
1075
1044
  # Retain original value if empty
1076
1045
  if updated_value.empty?
1077
- puts "Keeping original value: #{decoded}"
1078
- logger.info("Track #{index + 1}: Keeping original value: #{decoded}")
1046
+ puts 'Keeping original value.'
1047
+ logger.info("Track #{index + 1}: Keeping original value")
1079
1048
  updated_value = decoded
1080
1049
  else
1081
1050
  # Validate input for ISO encoding
@@ -1094,15 +1063,14 @@ module PWN
1094
1063
  raise "Track #{index + 1}: Invalid characters for ISO encoding"
1095
1064
  end
1096
1065
  end
1097
- logger.info("Track #{index + 1}: Updated value: #{updated_value}")
1066
+ logger.info("Track #{index + 1}: Updated value supplied")
1098
1067
  end
1099
1068
 
1100
1069
  track[:decoded] = updated_value
1101
1070
  end
1102
1071
 
1103
1072
  # Confirm changes
1104
- puts "\nUpdated Track Data:"
1105
- track_data.each_with_index { |t, i| puts "Track #{i + 1}: #{t[:decoded]}" }
1073
+ puts "\nUpdated track values are withheld from diagnostics."
1106
1074
  print 'Confirm writing these changes to the card? [y/N]: '
1107
1075
  unless gets.chomp.strip.upcase == 'Y'
1108
1076
  logger.info('Update cancelled by user')
@@ -1114,11 +1082,12 @@ module PWN
1114
1082
  encoding = track_data.first[:encoding] || :iso
1115
1083
  track_data = write_card(
1116
1084
  msr206_obj: msr206_obj,
1085
+ **(opts.key?(:track_formats) ? { track_formats: opts[:track_formats] } : {}),
1117
1086
  encoding: encoding,
1118
1087
  track_data: track_data
1119
1088
  )
1120
1089
 
1121
- logger.info("Update card successful: #{track_data.inspect}")
1090
+ logger.info('Update card completed')
1122
1091
  puts 'Card updated successfully.'
1123
1092
  track_data
1124
1093
  rescue StandardError => e
@@ -1221,7 +1190,9 @@ module PWN
1221
1190
 
1222
1191
  # Run read card and return its result
1223
1192
  #{self}.read_card(
1224
- msr206_obj: 'required - msr206_obj returned from #connect method'
1193
+ msr206_obj: 'required - msr206_obj returned from #connect method',
1194
+ encoding: 'optional - iso, iso_alt or raw; otherwise prompt for selection',
1195
+ track_formats: 'optional - three explicit format byte arrays; otherwise return all format candidates'
1225
1196
  )
1226
1197
 
1227
1198
  # Run backup card and return its result
@@ -1233,22 +1204,26 @@ module PWN
1233
1204
  #{self}.write_card(
1234
1205
  msr206_obj: 'required - msr206_obj returned from #connect method',
1235
1206
  encoding: 'required - :iso || :iso_alt || :raw',
1236
- track_data: 'required - track data to write (see #backup_card for structure)'
1207
+ track_data: 'required - three printable decoded tracks, or backup candidates with explicit track_formats',
1208
+ track_formats: 'optional - three selected format arrays: ISO [], alternate [0x31..0x33], raw [0x33..0x37] optionally prefixed by 0x5f; required for candidate backups'
1237
1209
  )
1238
1210
 
1239
1211
  # Run clone card and return its result
1240
1212
  #{self}.clone_card(
1241
- msr206_obj: 'required - msr206_obj returned from #connect method'
1213
+ msr206_obj: 'required - msr206_obj returned from #connect method',
1214
+ track_formats: 'optional - three explicit format byte arrays for selecting candidate backups'
1242
1215
  )
1243
1216
 
1244
1217
  # Run load card from file and return its result
1245
1218
  #{self}.load_card_from_file(
1246
- msr206_obj: 'required - msr206_obj returned from #connect method'
1219
+ msr206_obj: 'required - msr206_obj returned from #connect method',
1220
+ track_formats: 'optional - three explicit format byte arrays for selecting candidate backups'
1247
1221
  )
1248
1222
 
1249
1223
  # Run update card and return its result
1250
1224
  #{self}.update_card(
1251
- msr206_obj: 'required - msr206_obj returned from #connect method'
1225
+ msr206_obj: 'required - msr206_obj returned from #connect method',
1226
+ track_formats: 'optional - three explicit format byte arrays for selecting candidate backups'
1252
1227
  )
1253
1228
 
1254
1229
  # Run get config and return its result
@@ -439,8 +439,8 @@ module PWN
439
439
 
440
440
  public_class_method def self.get_credential_types(opts = {})
441
441
  nessus_obj = opts[:nessus_obj]
442
- category = opts[:category].to_s.downcase
443
- name = opts[:name].to_s.downcase
442
+ category = (opts[:category] || 'Host').to_s.downcase
443
+ name = (opts[:name] || 'SSH').to_s.downcase
444
444
 
445
445
  raise 'ERROR: name parameter requires category parameter.' if category.empty? && !name.empty?
446
446